@unbrained/pm-cli 2026.10.14 → 2026.10.15

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

@@ -12,67 +12,67 @@ 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;
+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;
+ok:boolean;
 /** Whether this run was a preview only. */
-dry_run: boolean;
+dry_run:boolean;
 /** Canonical filesystem identity of the repository root the merge configuration was installed into. */
-workspace_root: string;
+workspace_root:string;
 /** Canonical filesystem identity of the tracker root covered by the merge configuration. */
-pm_root?: string;
+pm_root?:string;
 /** `.gitattributes` reconciliation outcome. */
-gitattributes: {
-path: string;
-changed: boolean;
-patterns: string[];
+gitattributes:{
+path:string;
+changed:boolean;
+patterns:string[];
 /** Stable schema source used to derive committed item-folder mappings. */
-schema_scope: "project";
+schema_scope:"project";
 };
 /** Local `git config` merge-driver definitions applied (or previewed). */
-git_config: Array<{
-key: string;
-value: string;
+git_config:Array<{
+key:string;
+value:string;
 }>;
 /** Guidance for completing the multi-branch workflow setup. */
-guidance: string[];
+guidance:string[];
 /** ISO 8601 timestamp recording when generated occurred. */
-generated_at: string;
+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;
+pm_root:string;
 /** Starting path used to discover the enclosing Git workspace. */
-workspace_start: string;
+workspace_start:string;
 /** Whether complete inherited source coordinates were present. */
-source_coordinates_available: boolean;
+source_coordinates_available:boolean;
 /** Whether inherited source coordinates were selected. */
-source_context_selected: boolean;
+source_context_selected:boolean;
 /** Source-coordinate write policy active for the invocation. */
-source_policy: ReturnType<typeof resolveSourceContextWritePolicy>;
+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>>;
-}): MergeInstallContextResolution;
+export declare function resolveMergeInstallContext(options:{
+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";
+status:"ok" | "missing" | "drift";
 /** Required Git configuration keys that are absent. */
-missing_keys: string[];
+missing_keys:string[];
 /** Driver keys whose configured commands do not match the installed CLI. */
-drifted_keys: string[];
+drifted_keys:string[];
 }
 /** Resolve the enclosing Git worktree root or return null outside Git. */
-export declare function findGitWorkspaceRoot(cwd: string): Promise<string | null>;
+export declare function findGitWorkspaceRoot(cwd:string):Promise<string | null>;
 /**
  * Build the complete fenced `.gitattributes` pattern list for a tracker rooted
  * at `trackerRelativeRoot` (git-root-relative POSIX path, empty when the
@@ -82,22 +82,22 @@ export declare function findGitWorkspaceRoot(cwd: string): Promise<string | null
  * active schema's type folders), so schema-added custom types can never
  * silently diverge from the installed fence without a warning.
  */
-export declare function buildMergeAttributePatterns(trackerRelativeRoot: string, typeFolders: string[]): string[];
+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";
+status:"not_installed" | "ok" | "drift";
 /** `.gitattributes` file containing the fence, when one was found. */
-path?: string;
+path?:string;
 /** Expected attribute lines absent from the committed fence (for example a schema-added type folder). */
-missing_patterns: string[];
+missing_patterns:string[];
 /** Committed fence lines no longer produced by the coverage contract (for example a removed type folder). */
-stale_patterns: string[];
+stale_patterns:string[];
 /** Stable schema source used to derive the expected committed fence. */
-schema_scope: "project";
+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[];
+export declare function resolveProjectMergeTypeFolders(settings:Awaited<ReturnType<typeof readSettings>>):string[];
 /**
  * Audit the committed `.gitattributes` merge fence against the coverage the
  * active schema requires, without touching git configuration. The fence file
@@ -106,15 +106,15 @@ export declare function resolveProjectMergeTypeFolders(settings: Awaited<ReturnT
  * result means items of some type folder (or a tracker JSONL store) would
  * merge under git's default text driver despite the fence being installed.
  */
-export declare function auditMergeAttributeFence(pmRoot: string, typeFolders: string[]): Promise<MergeFenceAuditResult>;
+export declare function auditMergeAttributeFence(pmRoot:string,typeFolders:string[]):Promise<MergeFenceAuditResult>;
 /** Audit the clone-local Git driver commands without executing a merge. */
-export declare function auditMergeDriverConfiguration(workspaceRoot: string): Promise<MergeDriverConfigurationAuditResult>;
+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";
+status:"refreshed" | "unchanged" | "not_installed" | "no_git";
 /** `.gitattributes` path examined, when a git repository was found. */
-path?: string;
+path?:string;
 }
 /**
  * Refresh the fenced `.gitattributes` merge-driver block after a schema type
@@ -126,7 +126,7 @@ path?: string;
  * surface an actionable hint instead of mutating git configuration nobody
  * asked for.
  */
-export declare function refreshMergeAttributeFenceIfInstalled(pmRoot: string): Promise<MergeFenceRefreshOutcome>;
+export declare function refreshMergeAttributeFenceIfInstalled(pmRoot:string):Promise<MergeFenceRefreshOutcome>;
 /**
  * Install (or preview) the repository merge configuration for tracker data:
  * writes the fenced merge-driver block into `.gitattributes` (committed and
@@ -134,14 +134,14 @@ export declare function refreshMergeAttributeFenceIfInstalled(pmRoot: string): P
  * repository-local git config (per-clone, so every collaborator runs this once
  * per checkout). Requires an initialized tracker and a git repository.
  */
-export declare function runMergeInstall(options: MergeInstallOptions, global: GlobalOptions): Promise<MergeInstallResult>;
+export declare function runMergeInstall(options:MergeInstallOptions,global:GlobalOptions):Promise<MergeInstallResult>;
 /**
  * Install merge safety for an initialized tracker without depending on the
  * caller's cwd or global CLI path resolution. This is the SDK primitive used
  * by fresh init and by the `pm merge install` adapter.
  */
-export declare function installMergeFence(options: {
-pmRoot: string;
-workspaceRoot: string;
-dryRun?: boolean;
-}): Promise<MergeInstallResult>;
+export declare function installMergeFence(options:{
+pmRoot:string;
+workspaceRoot:string;
+dryRun?:boolean;
+}):Promise<MergeInstallResult>;

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

@@ -9,13 +9,13 @@ 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>;
+lstat(receiptPath:string):Promise<Stats>;
 /** Open the candidate and return the handle used for verified reads. */
-open(receiptPath: string, flags: number): Promise<FileHandle>;
+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;
-}): number;
+export declare function resolveReceiptNoFollowFlag(constants:{
+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>;
+export declare function readBoundedRegularFile(receiptPath:string,maximumBytes:number,boundary?:ReceiptFileBoundary):Promise<string | null>;

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

@@ -1,15 +1,15 @@
 /** 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";
+kind:"rebase" | "merge";
 /** Commit from which the operation began. */
-original_head: string;
+original_head:string;
 /** Original item blob at that commit. */
-original_blob: string;
+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>;
+export declare function captureMergeReceiptOperation(cwd:string,itemPath:string,originalItemRaw?:string):Promise<MergeReceiptOperation | undefined>;
 /** Validate only the bounded, privacy-safe operation schema accepted by receipt readers. */
-export declare function isMergeReceiptOperation(value: unknown): value is MergeReceiptOperation;
+export declare function isMergeReceiptOperation(value:unknown):value is MergeReceiptOperation;
 /** Prove HEAD, index, and working item all match the captured origin after Git leaves the operation. */
-export declare function isOriginalGitStateRestored(cwd: string, itemPath: string, operation: MergeReceiptOperation, expectedItemRaw?: string): Promise<boolean>;
+export declare function isOriginalGitStateRestored(cwd:string,itemPath:string,operation:MergeReceiptOperation,expectedItemRaw?:string):Promise<boolean>;

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

@@ -1,20 +1,20 @@
-import type { MergeDecisionReceipt, MergeReceiptInvalidEvidence } from "./receipts.js";
+import type { MergeDecisionReceipt,MergeReceiptInvalidEvidence } from "./receipts.js";
 /** Return whether a receipt id is safe to expose in cleartext diagnostics. */
-export declare function isSafeReceiptId(value: string): boolean;
+export declare function isSafeReceiptId(value:string):boolean;
 /** Versioned allowlist controlling which scalar evidence may enter tracked receipt sidecars. */
-export declare const DURABLE_VALUE_POLICY: "bounded_non_sensitive_scalars_v1";
+export declare const DURABLE_VALUE_POLICY:"bounded_non_sensitive_scalars_v1";
 /** Return the narrowest validation class for untrusted receipt evidence. */
-export declare function receiptValidationError(value: unknown, evidenceSource: "clone_local" | "durable"): MergeReceiptInvalidEvidence["validation_error"] | null;
+export declare function receiptValidationError(value:unknown,evidenceSource:"clone_local" | "durable"):MergeReceiptInvalidEvidence["validation_error"] | null;
 /** Restore omitted non-selected slots from identified v1 clone-local writer contracts; never infer a missing retained or discarded value. */
-export declare function normalizeLegacyReceipt(value: unknown): unknown;
+export declare function normalizeLegacyReceipt(value:unknown):unknown;
 /** Identify the rejected collection without exposing its values. */
-export declare function receiptCollectionValidationPath(value: unknown): string | undefined;
+export declare function receiptCollectionValidationPath(value:unknown):string | undefined;
 /** Validate a complete receipt against its clone-local or durable evidence policy. */
-export declare function isMergeDecisionReceipt(value: unknown, evidenceSource: "clone_local" | "durable"): value is MergeDecisionReceipt;
+export declare function isMergeDecisionReceipt(value:unknown,evidenceSource:"clone_local" | "durable"):value is MergeDecisionReceipt;
 /** Extract a structurally valid precomputed SHA-256 decision hash. */
-export declare function isPrehashedValue(value: unknown): string | undefined;
+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;
+export declare function durableValueEvidence(field:string,value:unknown):{
+pm_value_hash:string;
+pm_value?:unknown;
 };

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

@@ -1,211 +1,211 @@
 import type { Stats } from "node:fs";
-import { type ItemMergeConflictDecision, type ItemScalarConflictResolution, type MergePreferredSide } from "./three-way.js";
+import { type ItemMergeConflictDecision,type ItemScalarConflictResolution,type MergePreferredSide } from "./three-way.js";
 import type { MergeReceiptOperation } from "./receipt-operation.js";
 import { DURABLE_VALUE_POLICY } from "./receipt-schema.js";
 export { isSafeReceiptId } from "./receipt-schema.js";
 /** One clone-local merge receipt with recoverable branch values. */
 export interface MergeDecisionReceipt {
 /** Receipt schema version. */
-version: 1;
+version:1;
 /** Opaque receipt identity referenced from public history. */
-id: string;
+id:string;
 /** Repository-relative item path supplied by Git as `%P`. */
-item_path: string;
+item_path:string;
 /** Item id derived from the merged document path. */
-item_id: string;
+item_id:string;
 /** Side requested by the caller; stable-value decisions can retain either side. */
-requested_preference?: MergePreferredSide;
+requested_preference?:MergePreferredSide;
 /** Whether requested preference participates in item scalar selection. */
-requested_preference_applied?: boolean;
+requested_preference_applied?:boolean;
 /** Legacy schema-v1 key accepted while reading older clone-local receipts. */
-preferred?: MergePreferredSide;
+preferred?:MergePreferredSide;
 /** Scalar-conflict selection contract used by the item driver. */
-conflict_resolution: ItemScalarConflictResolution;
+conflict_resolution:ItemScalarConflictResolution;
 /** Fields selected cleanly from the other branch. */
-fields_from_theirs: string[];
+fields_from_theirs:string[];
 /** Collections combined from both branches. */
-union_fields: string[];
+union_fields:string[];
 /** SHA-256 hashes of the merged values for every field represented by this receipt. Absent on legacy receipts, which cannot prove drift attribution. */
-merged_field_hashes?: Record<string, string>;
+merged_field_hashes?:Record<string,string>;
 /** Full recoverable scalar decisions, retained only in the clone. */
-decisions: ItemMergeConflictDecision[];
+decisions:ItemMergeConflictDecision[];
 /** Immutable original Git coordinates captured while the driver runs during a merge or rebase. */
-operation?: MergeReceiptOperation;
+operation?:MergeReceiptOperation;
 /** Explicit audited disposition when the original Git state was restored instead of merging. */
-settlement?: "original_git_state_restored";
+settlement?:"original_git_state_restored";
 /** Whether a reconciliation history event settled this receipt. */
-state: "pending" | "reconciled";
+state:"pending" | "reconciled";
 /** Receipt creation timestamp. */
-created_at: string;
+created_at:string;
 /** Reconciliation timestamp, when consumed. */
-reconciled_at?: string;
+reconciled_at?:string;
 /** Whether decision values are recoverable locally or represented by hashes only. */
-value_availability?: "clone_local" | "hash_only" | "bounded_inline" | "mixed";
+value_availability?:"clone_local" | "hash_only" | "bounded_inline" | "mixed";
 /** Versioned rule governing which durable scalar previews may be committed. */
-value_policy?: typeof DURABLE_VALUE_POLICY;
+value_policy?:typeof DURABLE_VALUE_POLICY;
 /** Runtime-only provenance assigned by the reader; serialized values are ignored. */
-evidence_source?: "clone_local" | "durable";
+evidence_source?:"clone_local" | "durable";
 }
 /** Privacy-safe receipt summary suitable for committed history context. */
 export interface MergeDecisionReceiptSummary {
 /** Opaque clone-local receipt identity. */
-receipt_id: string;
+receipt_id:string;
 /** Item whose merge produced the receipt. */
-item_id: string;
+item_id:string;
 /** Repository-relative item path. */
-item_path: string;
+item_path:string;
 /** Scalar fields that required a preferred-side decision. */
-conflict_fields: string[];
+conflict_fields:string[];
 /** Fields selected cleanly from the other branch. */
-fields_from_theirs: string[];
+fields_from_theirs:string[];
 /** Collections combined from both branches. */
-union_fields: string[];
+union_fields:string[];
 /** Side requested by the caller; decision hashes prove the actual retained values. */
-requested_preference: MergePreferredSide;
+requested_preference:MergePreferredSide;
 /** Whether requested preference participated in item scalar selection. */
-requested_preference_applied: boolean;
+requested_preference_applied:boolean;
 /** Scalar-conflict selection contract used by the item driver. */
-conflict_resolution: ItemScalarConflictResolution;
+conflict_resolution:ItemScalarConflictResolution;
 /** Hashes proving the retained and discarded values without publishing them. */
-decisions: Array<{
-field: string;
-retained_hash: string;
-discarded_hash: string;
+decisions:Array<{
+field:string;
+retained_hash:string;
+discarded_hash:string;
 }>;
 }
 /** Structured result for the explicit clone-local merge report command. */
 export interface MergeReceiptReport {
 /** Whether the report was read successfully. */
-ok: true;
+ok:true;
 /** Number of receipts returned. */
-count: number;
+count:number;
 /** Receipts including recoverable values from the local clone only. */
-receipts: MergeDecisionReceipt[];
+receipts:MergeDecisionReceipt[];
 /** ISO timestamp for the report. */
-generated_at: string;
+generated_at:string;
 }
 /** Loss-aware merge receipt report for integrity gates and diagnostic adapters. */
 export interface MergeReceiptEvidenceReport {
 /** Whether clone-local evidence resolved and every candidate was read and validated successfully. */
-ok: boolean;
+ok:boolean;
 /** Whether clone-local evidence resolved and every discovered JSON candidate was read and validated successfully. */
-complete: boolean;
+complete:boolean;
 /** Number of valid receipts returned. */
-count: number;
+count:number;
 /** Number of candidates rejected by bounded-file, schema, identity, or copy-consistency validation. */
-invalid_evidence_count: number;
+invalid_evidence_count:number;
 /** Bounded privacy-safe identities and reason codes for rejected evidence. */
-invalid_evidence: MergeReceiptInvalidEvidence[];
+invalid_evidence:MergeReceiptInvalidEvidence[];
 /** Whether additional rejected evidence was omitted from the bounded detail list. */
-invalid_evidence_truncated: boolean;
+invalid_evidence_truncated:boolean;
 /** Whether the clone-local Git receipt directory was resolved successfully; always emitted by current implementations and optional for structural compatibility. */
-clone_local_evidence_resolved?: boolean;
+clone_local_evidence_resolved?:boolean;
 /** Receipts including recoverable values from the local clone only. */
-receipts: MergeDecisionReceipt[];
+receipts:MergeDecisionReceipt[];
 /** ISO timestamp for the report. */
-generated_at: string;
+generated_at:string;
 }
 /** Loss-aware receipt inspection result that never exposes malformed file contents. */
 export interface MergeReceiptEvidenceScan {
 /** Valid receipts that passed bounded-file, schema, and identity validation. */
-receipts: MergeDecisionReceipt[];
+receipts:MergeDecisionReceipt[];
 /** Number of JSON receipt candidates that could not be validated safely. */
-invalid_evidence_count: number;
+invalid_evidence_count:number;
 /** Bounded privacy-safe identities and reason codes for rejected evidence. */
-invalid_evidence: MergeReceiptInvalidEvidence[];
+invalid_evidence:MergeReceiptInvalidEvidence[];
 /** Whether additional rejected evidence was omitted from the bounded detail list. */
-invalid_evidence_truncated: boolean;
+invalid_evidence_truncated:boolean;
 /** Whether the clone-local Git receipt directory was resolved successfully; always emitted by current implementations and optional for structural compatibility. */
-clone_local_evidence_resolved?: boolean;
+clone_local_evidence_resolved?:boolean;
 }
 /** Stable privacy-safe classification for one rejected receipt candidate or source. */
 export interface MergeReceiptInvalidEvidence {
 /** Evidence store that produced the rejected candidate. */
-evidence_source: "clone_local" | "durable" | "clone_local_and_durable";
+evidence_source:"clone_local" | "durable" | "clone_local_and_durable";
 /** Stable failure class suitable for remediation routing and graph analytics. */
-reason: "directory_unreadable" | "candidate_not_bounded_regular_file" | "candidate_unreadable" | "candidate_invalid_json" | "schema_or_identity_invalid" | "schema_invalid" | "identity_invalid" | "copy_provenance_mismatch";
+reason:"directory_unreadable" | "candidate_not_bounded_regular_file" | "candidate_unreadable" | "candidate_invalid_json" | "schema_or_identity_invalid" | "schema_invalid" | "identity_invalid" | "copy_provenance_mismatch";
 /** Exact validation boundary when schema or identity evidence is rejected. */
-validation_error?: "required_fields" | "receipt_id" | "item_id" | "item_path" | "filename" | "collections" | "enums" | "timestamps" | "durable_decisions" | "operation";
+validation_error?:"required_fields" | "receipt_id" | "item_id" | "item_path" | "filename" | "collections" | "enums" | "timestamps" | "durable_decisions" | "operation";
 /** Exact schema coordinate, excluding rejected values and user-controlled field names. */
-validation_path?: string;
+validation_path?:string;
 /** Receipt identity when the bounded filename itself is a valid receipt id. */
-receipt_id?: string;
+receipt_id?:string;
 /** SHA-256 locator for an unsafe or malformed candidate filename. */
-candidate_name_hash?: string;
+candidate_name_hash?:string;
 }
 /** Revalidate one receipt and stage its atomic reconciled-state replacement. */
-declare function prepareReceiptSettlement(params: {
-receiptPath: string;
-receiptId: string;
-evidenceSource: "clone_local" | "durable";
-reconciledAt: string;
-settlement?: "original_git_state_restored";
-readReceipt?: (receiptPath: string) => Promise<string | null>;
-}): Promise<{
-path: string;
-content: string;
-fingerprints: string[];
-modern: boolean;
+declare function prepareReceiptSettlement(params:{
+receiptPath:string;
+receiptId:string;
+evidenceSource:"clone_local" | "durable";
+reconciledAt:string;
+settlement?:"original_git_state_restored";
+readReceipt?:(receiptPath:string) => Promise<string | null>;
+}):Promise<{
+path:string;
+content:string;
+fingerprints:string[];
+modern:boolean;
 } | null>;
 /** Convert a raw receipt into privacy-safe history context. */
-export declare function summarizeMergeReceipt(receipt: MergeDecisionReceipt): MergeDecisionReceiptSummary;
+export declare function summarizeMergeReceipt(receipt:MergeDecisionReceipt):MergeDecisionReceiptSummary;
 /** Persist one item-driver outcome in the clone-local Git directory. */
-export declare function writeMergeReceipt(params: {
-cwd: string;
-itemPath: string;
-preferred: MergePreferredSide;
-conflictResolution?: ItemScalarConflictResolution;
-fieldsFromTheirs: string[];
-unionFields: string[];
-mergedFieldHashes?: Record<string, string>;
-decisions: ItemMergeConflictDecision[];
-operation?: MergeReceiptOperation;
-}): Promise<MergeDecisionReceipt | null>;
+export declare function writeMergeReceipt(params:{
+cwd:string;
+itemPath:string;
+preferred:MergePreferredSide;
+conflictResolution?:ItemScalarConflictResolution;
+fieldsFromTheirs:string[];
+unionFields:string[];
+mergedFieldHashes?:Record<string,string>;
+decisions:ItemMergeConflictDecision[];
+operation?:MergeReceiptOperation;
+}):Promise<MergeDecisionReceipt | null>;
 /** Distinguish a missing optional receipt store from an unreadable one. */
-declare function receiptDirectoryFailureMeansAbsent(directory: string, error: unknown, inspectAncestor?: (ancestor: string) => Promise<Pick<Stats, "isDirectory">>): Promise<boolean>;
+declare function receiptDirectoryFailureMeansAbsent(directory:string,error:unknown,inspectAncestor?:(ancestor:string) => Promise<Pick<Stats,"isDirectory">>):Promise<boolean>;
 /** Inspect valid receipts and count invalid evidence without returning untrusted file contents. */
-export declare function inspectMergeReceiptEvidence(cwd: string, options?: {
+export declare function inspectMergeReceiptEvidence(cwd:string,options?:{
 /** Include receipts whose reconciliation state is already settled. */
-includeReconciled?: boolean;
+includeReconciled?:boolean;
 /** Include receipts that contain no discarded scalar values. */
-includeLossless?: boolean;
+includeLossless?:boolean;
 /** Explicit tracker root used to locate durable receipt evidence. */
-pmRoot?: string;
-}): Promise<MergeReceiptEvidenceScan>;
+pmRoot?:string;
+}):Promise<MergeReceiptEvidenceScan>;
 /** Read clone-local receipts with explicit reconciled/lossless classification controls. */
-export declare function listMergeReceipts(cwd: string, options?: {
-includeReconciled?: boolean;
-includeLossless?: boolean;
-pmRoot?: string;
-}): Promise<MergeDecisionReceipt[]>;
+export declare function listMergeReceipts(cwd:string,options?:{
+includeReconciled?:boolean;
+includeLossless?:boolean;
+pmRoot?:string;
+}):Promise<MergeDecisionReceipt[]>;
 /** Split merge provenance into receipts with discarded values and receipts whose composition was lossless. */
-export declare function partitionMergeReceipts(receipts: MergeDecisionReceipt[]): {
+export declare function partitionMergeReceipts(receipts:MergeDecisionReceipt[]):{
 /** Receipts that require an explicit decision because at least one competing scalar value was discarded. */
-pendingDecisions: MergeDecisionReceipt[];
+pendingDecisions:MergeDecisionReceipt[];
 /** Receipts that record provenance without a discarded competing scalar value. */
-lossless: MergeDecisionReceipt[];
+lossless:MergeDecisionReceipt[];
 };
 /** Mark a receipt as represented by a committed merge history event. */
-export declare function markMergeReceiptReconciled(cwd: string, receipt: MergeDecisionReceipt, options?: {
-requireExisting?: boolean;
-settlement?: "original_git_state_restored";
-}): Promise<void>;
+export declare function markMergeReceiptReconciled(cwd:string,receipt:MergeDecisionReceipt,options?:{
+requireExisting?:boolean;
+settlement?:"original_git_state_restored";
+}):Promise<void>;
 /** Report pending or historical clone-local merge decisions. */
-export declare function runMergeReceiptReport(options: {
+export declare function runMergeReceiptReport(options:{
 /** Include receipts already represented by merge history events. */
-includeReconciled?: boolean;
+includeReconciled?:boolean;
 /** Repository directory to inspect; defaults to the process working directory. */
-cwd?: string;
-}): Promise<MergeReceiptReport>;
+cwd?:string;
+}):Promise<MergeReceiptReport>;
 /** Inspect every receipt candidate and retain completeness diagnostics without exposing rejected file contents. */
-export declare function runMergeReceiptEvidenceReport(options: {
+export declare function runMergeReceiptEvidenceReport(options:{
 /** Include receipts already represented by merge history events. */
-includeReconciled?: boolean;
+includeReconciled?:boolean;
 /** Repository directory to inspect; defaults to the process working directory. */
-cwd?: string;
-}): Promise<MergeReceiptEvidenceReport>;
+cwd?:string;
+}):Promise<MergeReceiptEvidenceReport>;
 /** Test-only seams for deterministic receipt-boundary fault coverage. */
-export declare const _testOnlyMergeReceipts: {
-prepareReceiptSettlement: typeof prepareReceiptSettlement;
-receiptDirectoryFailureMeansAbsent: typeof receiptDirectoryFailureMeansAbsent;
+export declare const _testOnlyMergeReceipts:{
+prepareReceiptSettlement:typeof prepareReceiptSettlement;
+receiptDirectoryFailureMeansAbsent:typeof receiptDirectoryFailureMeansAbsent;
 };