@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/merge/driver.d.ts

@@ -7,69 +7,69 @@ export declare const MERGE_DRIVER_ARTIFACT_VALUES: readonly ["item", "history",
 export type MergeDriverArtifact = (typeof MERGE_DRIVER_ARTIFACT_VALUES)[number];
 /** Documents the merge driver options payload exchanged by command, SDK, and package integrations. */
 export interface MergeDriverOptions {
-    /** Artifact class being merged: item document, history JSONL stream, relationship event JSONL store, or key-level JSON config. */
-    artifact: string;
-    /** Path to the common-ancestor version (git %O). */
-    basePath: string;
-    /** Path to the current-branch version (git %A); also the default output path per the git merge-driver protocol. */
-    oursPath: string;
-    /** Path to the other-branch version (git %B). */
-    theirsPath: string;
-    /** Optional explicit output path overriding the git default of writing to the ours path. */
-    outputPath?: string;
-    /** Original repository-relative item path supplied by Git as `%P`, used to detect item format when temporary side paths lack extensions. */
-    itemPath?: string;
-    /** Side that wins unresolvable conflicts (default "ours"). */
-    prefer?: string;
+/** Artifact class being merged: item document, history JSONL stream, relationship event JSONL store, or key-level JSON config. */
+artifact: string;
+/** Path to the common-ancestor version (git %O). */
+basePath: string;
+/** Path to the current-branch version (git %A); also the default output path per the git merge-driver protocol. */
+oursPath: string;
+/** Path to the other-branch version (git %B). */
+theirsPath: string;
+/** Optional explicit output path overriding the git default of writing to the ours path. */
+outputPath?: string;
+/** Original repository-relative item path supplied by Git as `%P`, used to detect item format when temporary side paths lack extensions. */
+itemPath?: string;
+/** Side that wins unresolvable conflicts (default "ours"). */
+prefer?: string;
 }
 /** Documents the merge driver result payload exchanged by command, SDK, and package integrations. */
 export interface MergeDriverResult {
-    /** Whether the merge completed without unresolvable conflicts. */
-    ok: boolean;
-    /** Artifact class that was merged. */
-    artifact: MergeDriverArtifact;
-    /** Path the merged content was written to. */
-    output_path: string;
-    /** Invocation-side preference; per-decision retained values remain authoritative. */
-    requested_preference: MergePreferredSide;
-    /** Unresolvable conflict labels: metadata field names (item), dotted key paths (json). Empty for history merges. */
-    conflicts: string[];
-    /** History-merge strategy and entry accounting; present only for the history artifact. */
-    history?: {
-        strategy: string;
-        common_entries: number;
-        entries_from_ours: number;
-        entries_from_theirs: number;
-        entries_total: number;
-        reanchored: boolean;
-    };
-    /** Relationship-event-merge strategy and accounting; present only for the relationship artifact. */
-    relationship?: {
-        strategy: string;
-        common_entries: number;
-        entries_from_ours: number;
-        entries_from_theirs: number;
-        entries_total: number;
-        reanchored: boolean;
-    };
-    /** Item-merge field accounting; present only for the item artifact. */
-    item?: {
-        fields_from_theirs: string[];
-        union_fields: string[];
-        conflict_resolution: "latest_document_update";
-        /** Item scalars ignore branch-direction preference under the convergent recency policy. */
-        requested_preference_applied: false;
-    };
-    /** JSON-merge key accounting; present only for the json artifact. */
-    json?: {
-        paths_from_theirs: string[];
-    };
-    /** Clone-local receipt summary for item merge provenance. */
-    receipt?: MergeDecisionReceiptSummary;
-    /** Guidance for resolving remaining conflicts or verifying the merged workspace. */
-    guidance: string[];
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
+/** Whether the merge completed without unresolvable conflicts. */
+ok: boolean;
+/** Artifact class that was merged. */
+artifact: MergeDriverArtifact;
+/** Path the merged content was written to. */
+output_path: string;
+/** Invocation-side preference; per-decision retained values remain authoritative. */
+requested_preference: MergePreferredSide;
+/** Unresolvable conflict labels: metadata field names (item), dotted key paths (json). Empty for history merges. */
+conflicts: string[];
+/** History-merge strategy and entry accounting; present only for the history artifact. */
+history?: {
+strategy: string;
+common_entries: number;
+entries_from_ours: number;
+entries_from_theirs: number;
+entries_total: number;
+reanchored: boolean;
+};
+/** Relationship-event-merge strategy and accounting; present only for the relationship artifact. */
+relationship?: {
+strategy: string;
+common_entries: number;
+entries_from_ours: number;
+entries_from_theirs: number;
+entries_total: number;
+reanchored: boolean;
+};
+/** Item-merge field accounting; present only for the item artifact. */
+item?: {
+fields_from_theirs: string[];
+union_fields: string[];
+conflict_resolution: "latest_document_update";
+/** Item scalars ignore branch-direction preference under the convergent recency policy. */
+requested_preference_applied: false;
+};
+/** JSON-merge key accounting; present only for the json artifact. */
+json?: {
+paths_from_theirs: string[];
+};
+/** Clone-local receipt summary for item merge provenance. */
+receipt?: MergeDecisionReceiptSummary;
+/** Guidance for resolving remaining conflicts or verifying the merged workspace. */
+guidance: string[];
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
 }
 /**
  * Execute one git merge-driver invocation for a tracker artifact. Reads the

package/dist/sdk/merge/install.d.ts

@@ -11,65 +11,65 @@ export declare const PM_GITATTRIBUTES_V2_START = "# pm-cli:merge-drivers:v2:star
 export declare const PM_GITATTRIBUTES_V2_END = "# pm-cli:merge-drivers:v2:end";
 /** Control whether merge installation writes the fence and clone-local drivers or only previews the same configuration. */
 export interface MergeInstallOptions {
-    /** Preview the `.gitattributes` and `git config` changes without writing anything. */
-    dryRun?: boolean;
+/** Preview the `.gitattributes` and `git config` changes without writing anything. */
+dryRun?: boolean;
 }
 /** Installation or preview evidence identifying the selected workspace, fence coverage, and exact Git driver commands. */
 export interface MergeInstallResult {
-    /** Whether the installation completed (or, for dry runs, would complete) without errors. */
-    ok: boolean;
-    /** Whether this run was a preview only. */
-    dry_run: boolean;
-    /** Canonical filesystem identity of the repository root the merge configuration was installed into. */
-    workspace_root: string;
-    /** Canonical filesystem identity of the tracker root covered by the merge configuration. */
-    pm_root?: string;
-    /** `.gitattributes` reconciliation outcome. */
-    gitattributes: {
-        path: string;
-        changed: boolean;
-        patterns: string[];
-        /** Stable schema source used to derive committed item-folder mappings. */
-        schema_scope: "project";
-    };
-    /** Local `git config` merge-driver definitions applied (or previewed). */
-    git_config: Array<{
-        key: string;
-        value: string;
-    }>;
-    /** Guidance for completing the multi-branch workflow setup. */
-    guidance: string[];
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
+/** Whether the installation completed (or, for dry runs, would complete) without errors. */
+ok: boolean;
+/** Whether this run was a preview only. */
+dry_run: boolean;
+/** Canonical filesystem identity of the repository root the merge configuration was installed into. */
+workspace_root: string;
+/** Canonical filesystem identity of the tracker root covered by the merge configuration. */
+pm_root?: string;
+/** `.gitattributes` reconciliation outcome. */
+gitattributes: {
+path: string;
+changed: boolean;
+patterns: string[];
+/** Stable schema source used to derive committed item-folder mappings. */
+schema_scope: "project";
+};
+/** Local `git config` merge-driver definitions applied (or previewed). */
+git_config: Array<{
+key: string;
+value: string;
+}>;
+/** Guidance for completing the multi-branch workflow setup. */
+guidance: string[];
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
 }
 /** Resolved tracker and workspace selection for one merge-install invocation. */
 export interface MergeInstallContextResolution {
-    /** Tracker root selected without performing filesystem writes. */
-    pm_root: string;
-    /** Starting path used to discover the enclosing Git workspace. */
-    workspace_start: string;
-    /** Whether complete inherited source coordinates were present. */
-    source_coordinates_available: boolean;
-    /** Whether inherited source coordinates were selected. */
-    source_context_selected: boolean;
-    /** Source-coordinate write policy active for the invocation. */
-    source_policy: ReturnType<typeof resolveSourceContextWritePolicy>;
+/** Tracker root selected without performing filesystem writes. */
+pm_root: string;
+/** Starting path used to discover the enclosing Git workspace. */
+workspace_start: string;
+/** Whether complete inherited source coordinates were present. */
+source_coordinates_available: boolean;
+/** Whether inherited source coordinates were selected. */
+source_context_selected: boolean;
+/** Source-coordinate write policy active for the invocation. */
+source_policy: ReturnType<typeof resolveSourceContextWritePolicy>;
 }
 /** Resolve explicit, inherited-source, and current-workspace precedence without I/O. */
 export declare function resolveMergeInstallContext(options: {
-    cwd: string;
-    explicitPath?: string;
-    dryRun: boolean;
-    environment: Readonly<Record<string, string | undefined>>;
+cwd: string;
+explicitPath?: string;
+dryRun: boolean;
+environment: Readonly<Record<string, string | undefined>>;
 }): MergeInstallContextResolution;
 /** Result of auditing clone-local driver definitions behind a committed fence. */
 export interface MergeDriverConfigurationAuditResult {
-    /** Whether every required driver definition exactly matches this installation. */
-    status: "ok" | "missing" | "drift";
-    /** Required Git configuration keys that are absent. */
-    missing_keys: string[];
-    /** Driver keys whose configured commands do not match the installed CLI. */
-    drifted_keys: string[];
+/** Whether every required driver definition exactly matches this installation. */
+status: "ok" | "missing" | "drift";
+/** Required Git configuration keys that are absent. */
+missing_keys: string[];
+/** Driver keys whose configured commands do not match the installed CLI. */
+drifted_keys: string[];
 }
 /** Resolve the enclosing Git worktree root or return null outside Git. */
 export declare function findGitWorkspaceRoot(cwd: string): Promise<string | null>;
@@ -85,16 +85,16 @@ export declare function findGitWorkspaceRoot(cwd: string): Promise<string | null
 export declare function buildMergeAttributePatterns(trackerRelativeRoot: string, typeFolders: string[]): string[];
 /** Result of comparing the committed merge-fence block against the coverage the active schema requires. */
 export interface MergeFenceAuditResult {
-    /** Audit outcome: no fence installed (nothing to audit), fence matches, or fence drifted from the active schema/type folders. */
-    status: "not_installed" | "ok" | "drift";
-    /** `.gitattributes` file containing the fence, when one was found. */
-    path?: string;
-    /** Expected attribute lines absent from the committed fence (for example a schema-added type folder). */
-    missing_patterns: string[];
-    /** Committed fence lines no longer produced by the coverage contract (for example a removed type folder). */
-    stale_patterns: string[];
-    /** Stable schema source used to derive the expected committed fence. */
-    schema_scope: "project";
+/** Audit outcome: no fence installed (nothing to audit), fence matches, or fence drifted from the active schema/type folders. */
+status: "not_installed" | "ok" | "drift";
+/** `.gitattributes` file containing the fence, when one was found. */
+path?: string;
+/** Expected attribute lines absent from the committed fence (for example a schema-added type folder). */
+missing_patterns: string[];
+/** Committed fence lines no longer produced by the coverage contract (for example a removed type folder). */
+stale_patterns: string[];
+/** Stable schema source used to derive the expected committed fence. */
+schema_scope: "project";
 }
 /** Resolve merge-fence folders from built-ins plus persisted project schema only. */
 export declare function resolveProjectMergeTypeFolders(settings: Awaited<ReturnType<typeof readSettings>>): string[];
@@ -111,10 +111,10 @@ export declare function auditMergeAttributeFence(pmRoot: string, typeFolders: st
 export declare function auditMergeDriverConfiguration(workspaceRoot: string): Promise<MergeDriverConfigurationAuditResult>;
 /** Outcome of an automatic merge-fence refresh attempted after a schema type mutation. */
 export interface MergeFenceRefreshOutcome {
-    /** What happened: the fence was rewritten, already matched, was never installed (actionable hint), or there is no git repository to configure. */
-    status: "refreshed" | "unchanged" | "not_installed" | "no_git";
-    /** `.gitattributes` path examined, when a git repository was found. */
-    path?: string;
+/** What happened: the fence was rewritten, already matched, was never installed (actionable hint), or there is no git repository to configure. */
+status: "refreshed" | "unchanged" | "not_installed" | "no_git";
+/** `.gitattributes` path examined, when a git repository was found. */
+path?: string;
 }
 /**
  * Refresh the fenced `.gitattributes` merge-driver block after a schema type
@@ -141,7 +141,7 @@ export declare function runMergeInstall(options: MergeInstallOptions, global: Gl
  * by fresh init and by the `pm merge install` adapter.
  */
 export declare function installMergeFence(options: {
-    pmRoot: string;
-    workspaceRoot: string;
-    dryRun?: boolean;
+pmRoot: string;
+workspaceRoot: string;
+dryRun?: boolean;
 }): Promise<MergeInstallResult>;

package/dist/sdk/merge/receipt-file-boundary.d.ts

@@ -8,14 +8,14 @@ import { type Stats } from "node:fs";
 import { type FileHandle } from "node:fs/promises";
 /** Minimal filesystem operations required by the receipt reader. */
 export interface ReceiptFileBoundary {
-    /** Inspect the path without following its final symbolic link. */
-    lstat(receiptPath: string): Promise<Stats>;
-    /** Open the candidate and return the handle used for verified reads. */
-    open(receiptPath: string, flags: number): Promise<FileHandle>;
+/** Inspect the path without following its final symbolic link. */
+lstat(receiptPath: string): Promise<Stats>;
+/** Open the candidate and return the handle used for verified reads. */
+open(receiptPath: string, flags: number): Promise<FileHandle>;
 }
 /** Resolve the platform no-follow flag, falling back only where Node omits it. */
 export declare function resolveReceiptNoFollowFlag(constants: {
-    O_NOFOLLOW?: number;
+O_NOFOLLOW?: number;
 }): number;
 /** Read one regular file only when its opened identity remains bounded and stable. */
 export declare function readBoundedRegularFile(receiptPath: string, maximumBytes: number, boundary?: ReceiptFileBoundary): Promise<string | null>;

package/dist/sdk/merge/receipt-operation.d.ts

@@ -1,11 +1,11 @@
 /** Immutable pre-operation coordinates, without branch names or item contents. */
 export interface MergeReceiptOperation {
-    /** Git operation whose original state can be checked after it ends. */
-    kind: "rebase" | "merge";
-    /** Commit from which the operation began. */
-    original_head: string;
-    /** Original item blob at that commit. */
-    original_blob: string;
+/** Git operation whose original state can be checked after it ends. */
+kind: "rebase" | "merge";
+/** Commit from which the operation began. */
+original_head: string;
+/** Original item blob at that commit. */
+original_blob: string;
 }
 /** Capture original Git coordinates; plain merges require Git's incoming-head signal and the exact ours blob. */
 export declare function captureMergeReceiptOperation(cwd: string, itemPath: string, originalItemRaw?: string): Promise<MergeReceiptOperation | undefined>;

package/dist/sdk/merge/receipt-schema.d.ts

@@ -15,6 +15,6 @@ export declare function isMergeDecisionReceipt(value: unknown, evidenceSource: "
 export declare function isPrehashedValue(value: unknown): string | undefined;
 /** Convert a raw scalar into hashed evidence with an allowlisted preview. */
 export declare function durableValueEvidence(field: string, value: unknown): {
-    pm_value_hash: string;
-    pm_value?: unknown;
+pm_value_hash: string;
+pm_value?: unknown;
 };