@indigoai-us/hq-cli 5.289.0 → 5.291.0

package/dist/lib/checkpoint-ontology/merge-copies.d.ts

@@ -26,7 +26,11 @@
  * merge cannot rewrite (a copy, a knowledge file, a signal) is held.
  *
  * A signal whose `entity_refs` names a copy holds that copy: signals are
- * server-owned, so the ref cannot be re-pointed from here.
+ * server-owned, so the ref cannot be re-pointed from here. With `rewriteRefs`
+ * (flag `checkpoint.ontology.merge-rewrite-refs`) signal refs, invoice and
+ * bill links, source and knowledge links are re-pointed at the survivor, the
+ * survivor receives the copy's `external_ids` and `web_domains`, and only a
+ * link from another copy or an external id conflict holds a pair.
  *
  * With `pairKind: "variants"` (flag `checkpoint.ontology.merge-variants`) the
  * pairs are two-file duplicate groups whose canonical names differ only in
@@ -42,6 +46,12 @@ export declare const MERGE_COPIES_FLAG = "checkpoint.ontology.merge-copies";
  * names differ only in spacing, case or punctuation (CO-65).
  */
 export declare const MERGE_VARIANTS_FLAG = "checkpoint.ontology.merge-variants";
+/**
+ * `merge-copies --rewrite-refs`: re-point signal `entity_refs`, invoice and
+ * bill links, source and knowledge links from a copy to its survivor, and
+ * carry the copy's `external_ids` and `web_domains` to the survivor.
+ */
+export declare const MERGE_REWRITE_REFS_FLAG = "checkpoint.ontology.merge-rewrite-refs";
 export type CopySkipReason = "no_original" | "original_invalid" | "identity_differs" | "not_in_duplicate_group" | "group_size" | "type_differs" | "names_differ" | "numbered_copy" | "not_listed";
 export type PairKind = "numbered" | "variants";
 export interface CopySkip {
@@ -55,10 +65,22 @@ export interface CopyPair {
     /** Company-relative path of the original it merges into. */
     original: string;
 }
+/**
+ * How to settle one provider's `external_ids` conflict: `primary` stays in
+ * `external_ids`, and the pair's other id moves to `external_refs` under
+ * `namespace` (the provider account or workspace) and `object_type`.
+ */
+export interface ExternalIdResolution {
+    primary: string;
+    namespace: string;
+    object_type?: string;
+}
 /** One entry of a `--only` list: an exact copy -> original pair. */
 export interface ListedPair {
     copy: string;
     original: string;
+    /** Provider -> resolution, applied only when `rewriteRefs` is on and the ids conflict. */
+    resolve_external_ids?: Record<string, ExternalIdResolution>;
 }
 export interface CopyPlan extends CopyPair {
     add_aliases: string[];
@@ -75,8 +97,14 @@ export interface CopyPlan extends CopyPair {
     /** Signal files whose `entity_refs` name the copy. */
     signal_refs: string[];
     /** Why the copy cannot be merged or deleted from here. */
-    held?: "signal_refs" | "linked_from_unwritable" | "merge_invalid";
+    held?: "signal_refs" | "linked_from_unwritable" | "merge_invalid" | "external_id_conflict";
     detail?: string;
+    /** Keys added to the survivor. Set only when `rewriteRefs` is on. */
+    add_external_ids?: string[];
+    /** Domains added to the survivor. Set only when `rewriteRefs` is on. */
+    add_web_domains?: string[];
+    /** `system:namespace:recordId` refs added to the survivor's `external_refs`. Set only when `rewriteRefs` is on. */
+    add_external_refs?: string[];
     /** Body lines of the copy the merged original lacks; a copy with any is never deleted. */
     unmerged_body_lines: number;
 }
@@ -105,6 +133,8 @@ export interface MergeCopiesReport {
     }[];
     /** Listed entries the finder did not produce. Absent unless `--only` was set. */
     only_unmatched?: ListedPair[];
+    /** Signal, source and knowledge files re-pointed at a survivor. Absent unless `rewriteRefs` was set. */
+    rewritten?: string[];
     /** Entity-file links whose target file does not exist. */
     broken_links_before: number;
     broken_links_after: number;
@@ -123,6 +153,8 @@ export interface MergeCopiesOptions {
     limit?: number;
     /** Handle only these exact pairs; every other found pair is skipped as `not_listed`. */
     only?: ListedPair[];
+    /** Re-point refs and links held today, and carry ids and domains (flag merge-rewrite-refs). */
+    rewriteRefs?: boolean;
     now: Date;
     deleteVaultKey?: DeleteVaultKey;
 }