// Copyright (c) 2026 Probo Inc . // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. package commontrackerpattern import ( "context" "fmt" "github.com/spf13/cobra" "go.gearno.de/kit/pg" "go.probo.inc/probo/pkg/coredata" "go.probo.inc/probo/pkg/proboctl/cmdutil" ) func newCmdUnlink(f *cmdutil.Factory) *cobra.Command { var ( flagIDs []string flagLinkedBanner string flagLinkedOrg string flagCommonThirdParty string flagTrackerType string flagKeyword string flagState string flagWithoutDescription bool flagDryRun bool flagYes bool ) cmd := &cobra.Command{ Use: "unlink", Short: "Unlink common tracker patterns from any common third party", Long: "Detach selected common tracker patterns from their common third party, " + "returning the verdict to UNDETERMINED so the pipeline can re-probe them. " + "The now-stale description - which still names the removed vendor - is " + "blanked on both the catalog row and the uncategorised org tracker patterns " + "linked to it, and those org patterns are remapped (org third party cleared, " + "mapping re-armed) so the pipeline drops the stale vendor and re-resolves; a " + "re-resolved vendor re-arms catalog enrichment, re-deriving the description. " + "User-categorised and excluded org patterns are left untouched. Selection " + "mirrors 'reenrich'.", Args: cobra.NoArgs, } cmd.Flags().StringSliceVar(&flagIDs, "id", nil, "Common tracker pattern GID(s) to unlink (repeatable)") cmd.Flags().StringVar(&flagLinkedBanner, "linked-banner", "", "Select catalog rows linked to a cookie banner's patterns (GID)") cmd.Flags().StringVar(&flagLinkedOrg, "linked-org", "", "Select catalog rows linked to an organization's patterns (GID)") cmd.Flags().StringVar(&flagCommonThirdParty, "common-third-party", "", "Select patterns currently linked to a common third party (slug or GID)") cmd.Flags().StringVar(&flagTrackerType, "tracker-type", "", "Filter selected patterns by tracker type") cmd.Flags().StringVar(&flagKeyword, "keyword", "", "Filter selected patterns by a pattern/description substring") cmd.Flags().StringVar(&flagState, "state", "", "Filter selected patterns by enrichment state (queued, enriched, unenriched)") cmd.Flags().BoolVar(&flagWithoutDescription, "without-description", false, "Only patterns with a blank description") cmd.Flags().BoolVar(&flagDryRun, "dry-run", false, "Print the selected patterns without unlinking") cmd.Flags().BoolVar(&flagYes, "yes", false, "Skip confirmation") cmd.RunE = func(cmd *cobra.Command, args []string) error { ctx := cmd.Context() pgClient, err := f.PgClient() if err != nil { return err } ids, err := resolveReenrichIDs( ctx, pgClient, flagIDs, flagLinkedBanner, flagLinkedOrg, flagCommonThirdParty, flagTrackerType, flagKeyword, flagState, flagWithoutDescription, ) if err != nil { return err } out := f.IOStreams.Out if len(ids) == 0 { _, _ = fmt.Fprintln(out, "No common tracker patterns matched the selection.") return nil } if flagDryRun { _, _ = fmt.Fprintf(out, "Would unlink %d common tracker pattern(s).\n", len(ids)) printSample(out, ids) return nil } if !flagYes { return fmt.Errorf("about to unlink %d pattern(s); pass --yes to proceed or --dry-run to preview", len(ids)) } var ( unlinked int64 remapped int64 cleared int64 ) if err := pgClient.WithTx( ctx, func(ctx context.Context, tx pg.Tx) error { var ps coredata.CommonTrackerPatterns unlinked, err = ps.RelinkCommonThirdPartyByIDs(ctx, tx, ids, nil) if err != nil { return err } if _, err = ps.ClearDescriptionByIDs(ctx, tx, ids); err != nil { return err } var tps coredata.TrackerPatterns remapped, err = tps.RequestMappingForUncategorisedByCommonTrackerPatternIDs(ctx, tx, ids) if err != nil { return err } cleared, err = tps.ClearDescriptionForUncategorisedByCommonTrackerPatternIDs(ctx, tx, ids) if err != nil { return err } return nil }, ); err != nil { return fmt.Errorf("cannot unlink common tracker patterns: %w", err) } _, _ = fmt.Fprintf( out, "Unlinked %d pattern(s) from any common third party, remapped %d uncategorised org tracker pattern(s), cleared %d stale org description(s).\n", unlinked, remapped, cleared, ) return nil } return cmd }