@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/similarity-scoring.d.ts

@@ -1,19 +1,19 @@
 export { jaccardSimilarity } from "../core/shared/text-normalization.js";
 /** Precomputed title signals reused by bounded batch similarity operations. */
 export interface PreparedSimilarityText {
-    /** Canonical title used for exact comparison. */
-    normalized: string;
-    /** Unique normalized word tokens. */
-    tokens: string[];
-    /** Unique issue identifiers embedded in the title. */
-    issueCodes: string[];
+/** Canonical title used for exact comparison. */
+normalized: string;
+/** Unique normalized word tokens. */
+tokens: string[];
+/** Unique issue identifiers embedded in the title. */
+issueCodes: string[];
 }
 /** Stable score and strongest signal returned by title comparison. */
 export interface ItemSimilarityScore {
-    /** Similarity on the zero-to-one scale. */
-    score: number;
-    /** Strongest deterministic match signal. */
-    reason: "exact_title" | "issue_code" | "title_token_jaccard";
+/** Similarity on the zero-to-one scale. */
+score: number;
+/** Strongest deterministic match signal. */
+reason: "exact_title" | "issue_code" | "title_token_jaccard";
 }
 /** Normalize title text for exact comparisons and tokenization. */
 export declare function normalizeSimilarityText(value: string): string;

package/dist/sdk/similarity.d.ts

@@ -4,153 +4,153 @@ import { type PreparedSimilarityText } from "./similarity-scoring.js";
 export { jaccardSimilarity, normalizeSimilarityText, prepareSimilarityText, scoreItemSimilarity, scorePreparedItemSimilarity, tokenizeSimilarityText, type ItemSimilarityScore, type PreparedSimilarityText, } from "./similarity-scoring.js";
 /** Candidate content accepted by the similarity primitive. */
 export interface SimilarItemCandidate {
-    /** Proposed title. */
-    title: string;
-    /** Optional description used by future semantic providers. */
-    description?: string;
-    /** Optional body used by future semantic providers. */
-    body?: string;
-    /** Existing ids to omit, such as a copy source or current item. */
-    excludeIds?: readonly string[];
+/** Proposed title. */
+title: string;
+/** Optional description used by future semantic providers. */
+description?: string;
+/** Optional body used by future semantic providers. */
+body?: string;
+/** Existing ids to omit, such as a copy source or current item. */
+excludeIds?: readonly string[];
 }
 /** Query controls for {@link findSimilarItems}. */
 export interface FindSimilarItemsOptions {
-    /** Explicit tracker root. */
-    pmRoot?: string;
-    /** Workspace used for nearest-tracker discovery. */
-    cwd?: string;
-    /** Maximum returned matches, from zero through twenty. */
-    limit?: number;
-    /** Inclusive score threshold on the zero-to-one scale. */
-    threshold?: number;
+/** Explicit tracker root. */
+pmRoot?: string;
+/** Workspace used for nearest-tracker discovery. */
+cwd?: string;
+/** Maximum returned matches, from zero through twenty. */
+limit?: number;
+/** Inclusive score threshold on the zero-to-one scale. */
+threshold?: number;
 }
 /** One likely existing duplicate. */
 export interface SimilarItemMatch {
-    /** Existing item id. */
-    id: string;
-    /** Existing item title. */
-    title: string;
-    /** Existing lifecycle status. */
-    status: string;
-    /** Existing item type. */
-    type: string;
-    /** Stable similarity score on the zero-to-one scale. */
-    score: number;
-    /** Strongest deterministic match signal. */
-    reason: "exact_title" | "issue_code" | "title_token_jaccard";
+/** Existing item id. */
+id: string;
+/** Existing item title. */
+title: string;
+/** Existing lifecycle status. */
+status: string;
+/** Existing item type. */
+type: string;
+/** Stable similarity score on the zero-to-one scale. */
+score: number;
+/** Strongest deterministic match signal. */
+reason: "exact_title" | "issue_code" | "title_token_jaccard";
 }
 /** Bounded similarity query result. */
 export interface SimilarItemsResult {
-    /** Ranked likely duplicates. */
-    items: SimilarItemMatch[];
-    /** Number of returned matches. */
-    count: number;
-    /** Effective threshold. */
-    threshold: number;
-    /** Retrieval path used before shared scoring. */
-    source: "persistent_index" | "metadata_fallback";
+/** Ranked likely duplicates. */
+items: SimilarItemMatch[];
+/** Number of returned matches. */
+count: number;
+/** Effective threshold. */
+threshold: number;
+/** Retrieval path used before shared scoring. */
+source: "persistent_index" | "metadata_fallback";
 }
 /** Query controls for one all-status duplicate-cluster sweep. */
 export interface FindDuplicateClustersOptions extends FindSimilarItemsOptions {
-    /** Compare every pair as an exact oracle; retains the declared safety bound. */
-    exhaustive?: boolean;
-    /** Lifecycle statuses to include; omit to inspect every status. */
-    statuses?: readonly string[];
-    /** Inclusive ISO timestamp lower bound on item creation. */
-    since?: string;
+/** Compare every pair as an exact oracle; retains the declared safety bound. */
+exhaustive?: boolean;
+/** Lifecycle statuses to include; omit to inspect every status. */
+statuses?: readonly string[];
+/** Inclusive ISO timestamp lower bound on item creation. */
+since?: string;
 }
 /** One deterministic pair that caused items to join a duplicate cluster. */
 export interface DuplicateClusterMatch {
-    /** First item id in lexical order. */
-    left_id: string;
-    /** Second item id in lexical order. */
-    right_id: string;
-    /** Canonical deterministic score. */
-    score: number;
-    /** Strongest deterministic signal. */
-    reason: SimilarItemMatch["reason"];
+/** First item id in lexical order. */
+left_id: string;
+/** Second item id in lexical order. */
+right_id: string;
+/** Canonical deterministic score. */
+score: number;
+/** Strongest deterministic signal. */
+reason: SimilarItemMatch["reason"];
 }
 /** One connected component of likely duplicate items. */
 export interface DuplicateCluster {
-    /** Stable cluster key derived from the lexically first item id. */
-    id: string;
-    /** Item summaries ordered by id. */
-    items: Omit<SimilarItemMatch, "score" | "reason">[];
-    /** Qualifying pair evidence ordered by score then ids. */
-    matches: DuplicateClusterMatch[];
-    /** Strongest pair score in this component. */
-    max_score: number;
+/** Stable cluster key derived from the lexically first item id. */
+id: string;
+/** Item summaries ordered by id. */
+items: Omit<SimilarItemMatch, "score" | "reason">[];
+/** Qualifying pair evidence ordered by score then ids. */
+matches: DuplicateClusterMatch[];
+/** Strongest pair score in this component. */
+max_score: number;
 }
 /** Bounded batch duplicate analysis result with explicit cost disclosure. */
 export interface DuplicateClustersResult {
-    /** Connected duplicate components. */
-    clusters: DuplicateCluster[];
-    /** Number of returned components. */
-    count: number;
-    /** Effective threshold. */
-    threshold: number;
-    /** Retrieval path used for this whole-workspace sweep. */
-    source: "metadata_scan";
-    /** Effective lifecycle filter; null means the complete all-status corpus. */
-    filters: {
-        statuses: string[] | null;
-        since: string | null;
-    };
-    /** Work performed after the single metadata read. */
-    cost: {
-        /** Items retained after filters. */
-        item_count: number;
-        /** Algorithm used to generate candidates before canonical scoring. */
-        algorithm: "prefix_exact" | "exhaustive";
-        /** Pairs in the exhaustive population, including pairs pruned without scoring. */
-        possible_pairs: number;
-        /** Safety ceiling, exceeded only by an explicit refusal. */
-        pair_limit: number;
-        /** Every qualifying pair is retained by candidate generation. */
-        recall_guarantee: "exact";
-        /** Candidate pairs sharing at least one deterministic signal. */
-        candidate_pairs: number;
-        /** Candidate pairs scored. */
-        scored_pairs: number;
-    };
+/** Connected duplicate components. */
+clusters: DuplicateCluster[];
+/** Number of returned components. */
+count: number;
+/** Effective threshold. */
+threshold: number;
+/** Retrieval path used for this whole-workspace sweep. */
+source: "metadata_scan";
+/** Effective lifecycle filter; null means the complete all-status corpus. */
+filters: {
+statuses: string[] | null;
+since: string | null;
+};
+/** Work performed after the single metadata read. */
+cost: {
+/** Items retained after filters. */
+item_count: number;
+/** Algorithm used to generate candidates before canonical scoring. */
+algorithm: "prefix_exact" | "exhaustive";
+/** Pairs in the exhaustive population, including pairs pruned without scoring. */
+possible_pairs: number;
+/** Safety ceiling, exceeded only by an explicit refusal. */
+pair_limit: number;
+/** Every qualifying pair is retained by candidate generation. */
+recall_guarantee: "exact";
+/** Candidate pairs sharing at least one deterministic signal. */
+candidate_pairs: number;
+/** Candidate pairs scored. */
+scored_pairs: number;
+};
 }
 interface PreparedDuplicateItem {
-    item: Pick<ItemMetadata, "id" | "title" | "status" | "type">;
-    prepared: PreparedSimilarityText;
+item: Pick<ItemMetadata, "id" | "title" | "status" | "type">;
+prepared: PreparedSimilarityText;
 }
 /** Create/copy governance envelope attached when likely duplicates exist. */
 export interface SimilarityAdvisory {
-    /** Effective governance mode. */
-    mode: "advisory" | "strict";
-    /** Whether strict enforcement was explicitly bypassed. */
-    bypassed: boolean;
-    /** Shared similarity query result. */
-    result: SimilarItemsResult;
-    /** Executable next action selected from the strongest matching item's lifecycle state. */
-    recovery: SimilarityRecovery;
+/** Effective governance mode. */
+mode: "advisory" | "strict";
+/** Whether strict enforcement was explicitly bypassed. */
+bypassed: boolean;
+/** Shared similarity query result. */
+result: SimilarItemsResult;
+/** Executable next action selected from the strongest matching item's lifecycle state. */
+recovery: SimilarityRecovery;
 }
 /** Executable duplicate-intake recovery selected from the strongest match. */
 export interface SimilarityRecovery {
-    /** Whether to continue existing active work or reopen terminal work as a recurrence. */
-    action: "reuse" | "reopen";
-    /** Strongest matching canonical item. */
-    item_id: string;
-    /** Shell-form recovery command. */
-    command: string;
-    /** Tokenized recovery command for direct execution. */
-    args: string[];
+/** Whether to continue existing active work or reopen terminal work as a recurrence. */
+action: "reuse" | "reopen";
+/** Strongest matching canonical item. */
+item_id: string;
+/** Shell-form recovery command. */
+command: string;
+/** Tokenized recovery command for direct execution. */
+args: string[];
 }
 /** Render compact warning tokens shared by create and copy results. */
 export declare function similarityAdvisoryWarnings(advisory: SimilarityAdvisory | undefined): string[];
 /** Internal deterministic seams used to prove bounded batch behavior without building a million-pair fixture. */
 export declare const _testOnlySimilarity: {
-    buildDuplicateClusters: typeof buildDuplicateClusters;
-    collectDuplicateCandidatePairs: typeof collectDuplicateCandidatePairs;
-    createDuplicateUnionFind: typeof createDuplicateUnionFind;
+buildDuplicateClusters: typeof buildDuplicateClusters;
+collectDuplicateCandidatePairs: typeof collectDuplicateCandidatePairs;
+createDuplicateUnionFind: typeof createDuplicateUnionFind;
 };
 declare function createDuplicateUnionFind(size: number): {
-    parent: number[];
-    findRoot: (index: number) => number;
+parent: number[];
+findRoot: (index: number) => number;
 };
 /** Group unioned endpoints and their scored evidence once, then deterministically rank and limit complete components. */
 declare function buildDuplicateClusters(items: PreparedDuplicateItem[], matches: DuplicateClusterMatch[], union: ReturnType<typeof createDuplicateUnionFind>, limit: number): DuplicateCluster[];
@@ -170,6 +170,6 @@ export declare function analyzeDuplicateItems(input: readonly DuplicateItemInput
 export declare function findDuplicateClusters(options?: FindDuplicateClustersOptions): Promise<DuplicateClustersResult>;
 /** Apply off/advisory/strict mutation governance through the shared query. */
 export declare function evaluateSimilarityGovernance(candidate: SimilarItemCandidate, options: FindSimilarItemsOptions & {
-    mode: "off" | "advisory" | "strict";
-    allowDuplicate?: boolean;
+mode: "off" | "advisory" | "strict";
+allowDuplicate?: boolean;
 }): Promise<SimilarityAdvisory | undefined>;

package/dist/sdk/stats.d.ts

@@ -7,132 +7,132 @@ import { type ImprovementDirection, type ImprovementLedgerResult, type RecordImp
 import { type FleetAttributionAnalytics, type ProvenanceCoverageAnalytics } from "./history-analytics.js";
 /** Documents the stats command options payload exchanged by command, SDK, and package integrations. */
 export interface StatsCommandOptions {
-    /** Restore zero-count item-type and status buckets for schema-governance dashboards. */
-    includeEmpty?: boolean;
-    /** Include aggregate per-stream history storage metrics (sizes, depth, oldest/newest). */
-    storage?: boolean;
-    /** Include metadata coverage percentages (AC, estimates, resolution, tags, parent) overall and by type. */
-    metadataCoverage?: boolean;
-    /** Include a lifecycle-bucketed breakdown grouped by assignee. */
-    byAssignee?: boolean;
-    /** Include a lifecycle-bucketed breakdown grouped by tag (optionally filtered by --tag-prefix). */
-    byTag?: boolean;
-    /** Include a lifecycle-bucketed breakdown grouped by priority. */
-    byPriority?: boolean;
-    /** With --by-tag: only consider tags starting with this prefix (e.g. "domain:"). */
-    tagPrefix?: string;
-    /** Include a content-field utilization breakdown (notes/learnings/files/docs/tests/comments/deps/body usage rates). */
-    fieldUtilization?: boolean;
-    /** Include the audited improvement observation ledger and derived trends. */
-    measurements?: boolean;
-    /** Exact improvement metric filter used with --measurements. */
-    metric?: string;
-    /** Maximum newest improvement observations returned. */
-    measurementLimit?: number;
-    /** Repeatable name=value[,unit=...][,threshold=...] observations to append. */
-    observe?: string[];
-    /** Improvement direction applied to newly recorded observations. */
-    direction?: ImprovementDirection;
-    /** Producing gate or instrument associated with new observations. */
-    measurementSource?: string;
-    /** Tracked owner associated with new observations. */
-    measurementItem?: string;
-    /** Explicit source revision for new observations. */
-    measurementRevision?: string;
-    /** Intentional mutation author override. */
-    author?: string;
-    /** Human-readable observation audit rationale. */
-    message?: string;
-    /** Include live declared-versus-observed provenance coverage. */
-    provenanceCoverage?: boolean;
-    /** Include immutable-history fleet outcome attribution. */
-    fleetAttribution?: boolean;
-    /** Inclusive history analytics lower bound or negative duration. */
-    since?: string;
-    /** Maximum immutable events consumed by each analytics projection. */
-    eventLimit?: number;
-    /** Minimum close or explicit-value denominator required for rates. */
-    minimumSample?: number;
+/** Restore zero-count item-type and status buckets for schema-governance dashboards. */
+includeEmpty?: boolean;
+/** Include aggregate per-stream history storage metrics (sizes, depth, oldest/newest). */
+storage?: boolean;
+/** Include metadata coverage percentages (AC, estimates, resolution, tags, parent) overall and by type. */
+metadataCoverage?: boolean;
+/** Include a lifecycle-bucketed breakdown grouped by assignee. */
+byAssignee?: boolean;
+/** Include a lifecycle-bucketed breakdown grouped by tag (optionally filtered by --tag-prefix). */
+byTag?: boolean;
+/** Include a lifecycle-bucketed breakdown grouped by priority. */
+byPriority?: boolean;
+/** With --by-tag: only consider tags starting with this prefix (e.g. "domain:"). */
+tagPrefix?: string;
+/** Include a content-field utilization breakdown (notes/learnings/files/docs/tests/comments/deps/body usage rates). */
+fieldUtilization?: boolean;
+/** Include the audited improvement observation ledger and derived trends. */
+measurements?: boolean;
+/** Exact improvement metric filter used with --measurements. */
+metric?: string;
+/** Maximum newest improvement observations returned. */
+measurementLimit?: number;
+/** Repeatable name=value[,unit=...][,threshold=...] observations to append. */
+observe?: string[];
+/** Improvement direction applied to newly recorded observations. */
+direction?: ImprovementDirection;
+/** Producing gate or instrument associated with new observations. */
+measurementSource?: string;
+/** Tracked owner associated with new observations. */
+measurementItem?: string;
+/** Explicit source revision for new observations. */
+measurementRevision?: string;
+/** Intentional mutation author override. */
+author?: string;
+/** Human-readable observation audit rationale. */
+message?: string;
+/** Include live declared-versus-observed provenance coverage. */
+provenanceCoverage?: boolean;
+/** Include immutable-history fleet outcome attribution. */
+fleetAttribution?: boolean;
+/** Inclusive history analytics lower bound or negative duration. */
+since?: string;
+/** Maximum immutable events consumed by each analytics projection. */
+eventLimit?: number;
+/** Minimum close or explicit-value denominator required for rates. */
+minimumSample?: number;
 }
 /** Compact, tabular lifecycle row used by the default stats type distribution. */
 export interface StatsTypeLifecycleRow {
-    /** Item type represented by this row. */
-    type: string;
-    /** Total items of this type across every lifecycle bucket. */
-    total: number;
-    /** Items in the default open lifecycle bucket. */
-    open: number;
-    /** Items in active non-default lifecycle states. */
-    in_progress: number;
-    /** Items in blocked lifecycle states. */
-    blocked: number;
-    /** Items in draft lifecycle states. */
-    draft: number;
-    /** Items in completed lifecycle states. */
-    closed: number;
-    /** Items in canceled lifecycle states. */
-    canceled: number;
-    /** Items whose custom status is outside the recognized lifecycle buckets. */
-    other: number;
+/** Item type represented by this row. */
+type: string;
+/** Total items of this type across every lifecycle bucket. */
+total: number;
+/** Items in the default open lifecycle bucket. */
+open: number;
+/** Items in active non-default lifecycle states. */
+in_progress: number;
+/** Items in blocked lifecycle states. */
+blocked: number;
+/** Items in draft lifecycle states. */
+draft: number;
+/** Items in completed lifecycle states. */
+closed: number;
+/** Items in canceled lifecycle states. */
+canceled: number;
+/** Items whose custom status is outside the recognized lifecycle buckets. */
+other: number;
 }
 /** Screen-sized type distribution rendered as one canonical TOON table. */
 export type StatsTypeBreakdown = StatsTypeLifecycleRow[];
 /** Documents the stats result payload exchanged by command, SDK, and package integrations. */
 export interface StatsResult {
-    /** Value that configures or reports totals for this contract. */
-    totals: {
-        items: number;
-        history_streams: number;
-        history_entries: number;
-    };
-    /** Schema type that determines the shape and validation rules for this value. */
-    by_type: StatsTypeBreakdown;
-    /** Item counts grouped by lifecycle status. */
-    by_status: Partial<Record<ItemStatus, number>>;
-    /** Total zero-count type and status buckets omitted from the default projection. */
-    omitted_zero_buckets: number;
-    /** Present only with --metadata-coverage: per-field coverage overall and by type. */
-    metadata_coverage?: MetadataCoverageReport;
-    /** Present only with --by-assignee/--by-tag/--by-priority: lifecycle-bucketed group breakdowns. */
-    breakdowns?: {
-        assignee?: GroupedBreakdown;
-        tag?: GroupedBreakdown;
-        priority?: GroupedBreakdown;
-    };
-    /** Present only with --storage: aggregate history-stream metrics for compaction/planning. */
-    storage?: HistoryStorageStats;
-    /** Present only with --field-utilization: content-field utilization rates across all items. */
-    field_utilization?: ContentFieldUtilizationReport;
-    /** Audited improvement observations and baseline-to-latest trends. */
-    improvement_ledger?: ImprovementLedgerResult;
-    /** Receipts for observations appended by this invocation. */
-    recorded_observations?: RecordImprovementObservationResult[];
-    /** Live provenance coverage over a bounded immutable-history window. */
-    provenance_coverage?: ProvenanceCoverageAnalytics;
-    /** Bounded fleet attribution derived from immutable history. */
-    fleet_attribution?: FleetAttributionAnalytics;
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
+/** Value that configures or reports totals for this contract. */
+totals: {
+items: number;
+history_streams: number;
+history_entries: number;
+};
+/** Schema type that determines the shape and validation rules for this value. */
+by_type: StatsTypeBreakdown;
+/** Item counts grouped by lifecycle status. */
+by_status: Partial<Record<ItemStatus, number>>;
+/** Total zero-count type and status buckets omitted from the default projection. */
+omitted_zero_buckets: number;
+/** Present only with --metadata-coverage: per-field coverage overall and by type. */
+metadata_coverage?: MetadataCoverageReport;
+/** Present only with --by-assignee/--by-tag/--by-priority: lifecycle-bucketed group breakdowns. */
+breakdowns?: {
+assignee?: GroupedBreakdown;
+tag?: GroupedBreakdown;
+priority?: GroupedBreakdown;
+};
+/** Present only with --storage: aggregate history-stream metrics for compaction/planning. */
+storage?: HistoryStorageStats;
+/** Present only with --field-utilization: content-field utilization rates across all items. */
+field_utilization?: ContentFieldUtilizationReport;
+/** Audited improvement observations and baseline-to-latest trends. */
+improvement_ledger?: ImprovementLedgerResult;
+/** Receipts for observations appended by this invocation. */
+recorded_observations?: RecordImprovementObservationResult[];
+/** Live provenance coverage over a bounded immutable-history window. */
+provenance_coverage?: ProvenanceCoverageAnalytics;
+/** Bounded fleet attribution derived from immutable history. */
+fleet_attribution?: FleetAttributionAnalytics;
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
 }
 declare function zeroByType(itemTypes: string[]): Record<ItemType, number>;
 declare function zeroByStatus(statuses: string[]): Record<ItemStatus, number>;
 declare function projectStatsDistributions(items: readonly CoverageItem[], itemTypes: readonly string[], statuses: readonly string[], classifier: LifecycleClassifier, includeEmpty: boolean): {
-    byType: StatsTypeBreakdown;
-    byStatus: Partial<Record<ItemStatus, number>>;
-    omitted: number;
+byType: StatsTypeBreakdown;
+byStatus: Partial<Record<ItemStatus, number>>;
+omitted: number;
 };
 declare function countNonEmptyLines(raw: string): number;
 declare function readHistoryStreamContents(pmRoot: string): Promise<Array<{
-    id: string;
-    raw: string;
+id: string;
+raw: string;
 }>>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    zeroByType: typeof zeroByType;
-    zeroByStatus: typeof zeroByStatus;
-    countNonEmptyLines: typeof countNonEmptyLines;
-    readHistoryStreamContents: typeof readHistoryStreamContents;
-    projectStatsDistributions: typeof projectStatsDistributions;
+zeroByType: typeof zeroByType;
+zeroByStatus: typeof zeroByStatus;
+countNonEmptyLines: typeof countNonEmptyLines;
+readHistoryStreamContents: typeof readHistoryStreamContents;
+projectStatsDistributions: typeof projectStatsDistributions;
 };
 /** Implements run stats for the public runtime surface of this module. */
 export declare function runStats(global: GlobalOptions, options?: StatsCommandOptions): Promise<StatsResult>;

package/dist/sdk/structured-mutations.d.ts

@@ -2,28 +2,28 @@ import type { BulkItemMutation } from "./item-transaction.js";
 import { type RuntimeFieldDefinitionResolved } from "../core/schema/runtime-schema.js";
 /** Controls for resolving one versioned mutation document. */
 export interface ResolveItemMutationDocumentOptions {
-    /** Stable transaction identity used to derive replay-safe create ids. */
-    transactionId: string;
-    /** Workspace item-id prefix. */
-    idPrefix: string;
+/** Stable transaction identity used to derive replay-safe create ids. */
+transactionId: string;
+/** Workspace item-id prefix. */
+idPrefix: string;
 }
 /** Fully validated mutation document ready for preview or commit. */
 export interface ResolvedItemMutationDocument {
-    /** Versioned structured-input contract. */
-    schema_version: 1;
-    /** Atomic mutations with every local reference replaced by a concrete id. */
-    mutations: BulkItemMutation[];
-    /** Batch-local alias to concrete-id receipt. */
-    references: Record<string, string>;
+/** Versioned structured-input contract. */
+schema_version: 1;
+/** Atomic mutations with every local reference replaced by a concrete id. */
+mutations: BulkItemMutation[];
+/** Batch-local alias to concrete-id receipt. */
+references: Record<string, string>;
 }
 /** Validated transaction controls shared by atomic CLI and MCP adapters. */
 export interface AtomicMutationControls {
-    /** Compensation policy applied to created items when a later step fails. */
-    createCompensation?: "close" | "delete";
-    /** Workspace transaction lock lifetime in seconds. */
-    lockTtlSeconds?: number;
-    /** Maximum time to wait for the workspace transaction lock. */
-    lockWaitMs?: number;
+/** Compensation policy applied to created items when a later step fails. */
+createCompensation?: "close" | "delete";
+/** Workspace transaction lock lifetime in seconds. */
+lockTtlSeconds?: number;
+/** Maximum time to wait for the workspace transaction lock. */
+lockWaitMs?: number;
 }
 /** Validate and normalize atomic transaction controls at every transport boundary. */
 export declare function parseAtomicMutationControls(value: Record<string, unknown>): AtomicMutationControls;