@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/core/history/history-compact-bulk.d.ts

@@ -25,34 +25,34 @@ export type HistoryCompactBulkSkipReason = "no_stream" | "already_compact" | "sc
  * `closed` scope filter but are eligible under `all-streams`.
  */
 export interface HistoryCompactBulkCandidate {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports entries for this contract. */
-    entries: number;
-    /** Value that configures or reports bucket for this contract. */
-    bucket: LifecycleBucket | null;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports entries for this contract. */
+entries: number;
+/** Value that configures or reports bucket for this contract. */
+bucket: LifecycleBucket | null;
 }
 /** Selection criteria resolved from the command flags + policy defaults. */
 export interface HistoryCompactBulkCriteria {
-    /** Explicit, ordered list of item ids to compact. When non-empty the selection runs in "ids" mode: scope/allOver are ignored and only the `minEntries` floor applies. Duplicates are collapsed, preserving first-seen order. */
-    ids?: string[];
-    /** Lifecycle scope filter for scan mode (ignored in ids mode). */
-    scope?: HistoryCompactScope;
-    /** Streams with at most this many entries are skipped as `already_compact` (compaction collapses a stream to a 2-entry baseline+audit pair, so smaller streams gain nothing). Applies in both modes. */
-    minEntries: number;
-    /** Scan mode only: when set, only streams with strictly more entries than this are selected. Streams above `minEntries` but at/below `allOver` are skipped as `below_threshold`. */
-    allOver?: number;
+/** Explicit, ordered list of item ids to compact. When non-empty the selection runs in "ids" mode: scope/allOver are ignored and only the `minEntries` floor applies. Duplicates are collapsed, preserving first-seen order. */
+ids?: string[];
+/** Lifecycle scope filter for scan mode (ignored in ids mode). */
+scope?: HistoryCompactScope;
+/** Streams with at most this many entries are skipped as `already_compact` (compaction collapses a stream to a 2-entry baseline+audit pair, so smaller streams gain nothing). Applies in both modes. */
+minEntries: number;
+/** Scan mode only: when set, only streams with strictly more entries than this are selected. Streams above `minEntries` but at/below `allOver` are skipped as `below_threshold`. */
+allOver?: number;
 }
 /** Per-candidate selection outcome. */
 export interface HistoryCompactBulkSelectionRow {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports entries for this contract. */
-    entries: number;
-    /** Value that configures or reports selected for this contract. */
-    selected: boolean;
-    /** Value that configures or reports skip reason for this contract. */
-    skip_reason: HistoryCompactBulkSkipReason | null;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports entries for this contract. */
+entries: number;
+/** Value that configures or reports selected for this contract. */
+selected: boolean;
+/** Value that configures or reports skip reason for this contract. */
+skip_reason: HistoryCompactBulkSkipReason | null;
 }
 /**
  * Decide which history streams to compact.

package/dist/core/history/history-diff.d.ts

@@ -1,29 +1,29 @@
 import type { HistoryEntry } from "../../types/index.js";
 /** Documents the history field change payload exchanged by command, SDK, and package integrations. */
 export interface HistoryFieldChange {
-    /** Value that configures or reports field for this contract. */
-    field: string;
-    /** Value that configures or reports before for this contract. */
-    before: unknown;
-    /** Value that configures or reports after for this contract. */
-    after: unknown;
+/** Value that configures or reports field for this contract. */
+field: string;
+/** Value that configures or reports before for this contract. */
+before: unknown;
+/** Value that configures or reports after for this contract. */
+after: unknown;
 }
 /** Documents the history diff value entry payload exchanged by command, SDK, and package integrations. */
 export interface HistoryDiffValueEntry {
-    /** 1-based position in the FULL stream (fullEntries index + 1). */
-    index: number;
-    /** Value that configures or reports ts for this contract. */
-    ts: string;
-    /** Value that configures or reports op for this contract. */
-    op: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Number of JSON-patch operations in this entry (entry.patch.length). */
-    patch_ops: number;
-    /** Unique field names touched by this entry, sorted by localeCompare. */
-    changed_fields: string[];
-    /** Per-field before/after values, sorted by field name (localeCompare). */
-    changes: HistoryFieldChange[];
+/** 1-based position in the FULL stream (fullEntries index + 1). */
+index: number;
+/** Value that configures or reports ts for this contract. */
+ts: string;
+/** Value that configures or reports op for this contract. */
+op: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Number of JSON-patch operations in this entry (entry.patch.length). */
+patch_ops: number;
+/** Unique field names touched by this entry, sorted by localeCompare. */
+changed_fields: string[];
+/** Per-field before/after values, sorted by field name (localeCompare). */
+changes: HistoryFieldChange[];
 }
 /**
  * Map a JSON-Patch path string to a human-readable changed-field name.
@@ -50,6 +50,6 @@ export declare function patchPathToChangedField(path: string): string;
  *   restricted to that single field.
  */
 export declare function computeHistoryDiff(fullEntries: HistoryEntry[], options?: {
-    windowStartIndex?: number;
-    field?: string;
+windowStartIndex?: number;
+field?: string;
 }): HistoryDiffValueEntry[];

package/dist/core/history/history-rewrite.d.ts

@@ -2,95 +2,95 @@ import type { ItemTypeRegistry } from "../item/type-registry.js";
 import { locateItem, readLocatedItem } from "../store/item-store.js";
 import type { ItemDocument, PmSettings } from "../../types/index.js";
 type LoadedItem = Awaited<ReturnType<typeof readLocatedItem>> & {
-    /** Whether the document was reconstructed while preserving unreadable source bytes. */
-    recovered?: boolean;
+/** Whether the document was reconstructed while preserving unreadable source bytes. */
+recovered?: boolean;
 };
 type HistoryRawWriter = (filePath: string, content: string) => Promise<void>;
 /** Documents the history rewrite subject payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRewriteSubject {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Filesystem path used for history resolution. */
-    historyPath: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Filesystem path used for history resolution. */
+historyPath: string;
 }
 /** Documents the history rewrite ownership params payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRewriteOwnershipParams {
-    /** Value that configures or reports item document for this contract. */
-    itemDocument: ItemDocument | null;
-    /** Value that configures or reports subject id for this contract. */
-    subjectId: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports force for this contract. */
-    force: boolean | undefined;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
+/** Value that configures or reports item document for this contract. */
+itemDocument: ItemDocument | null;
+/** Value that configures or reports subject id for this contract. */
+subjectId: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports force for this contract. */
+force: boolean | undefined;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
 }
 /** Apply ownership_enforcement governance to a history-rewriting operation. Returns the warning(s) the caller should append (empty when no conflict or strict-throws). Throws PmCliError(CONFLICT) in strict mode when the assignee conflicts and --force is not set. */
 export declare function checkHistoryRewriteOwnership(params: HistoryRewriteOwnershipParams): string[];
 /** Documents the verify history rewrite drift params payload exchanged by command, SDK, and package integrations. */
 export interface VerifyHistoryRewriteDriftParams {
-    /** Value that configures or reports pm root for this contract. */
-    pmRoot: string;
-    /** Value that configures or reports subject for this contract. */
-    subject: HistoryRewriteSubject;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports type registry for this contract. */
-    typeRegistry: ItemTypeRegistry;
-    /** Value that configures or reports history raw before lock for this contract. */
-    historyRawBeforeLock: string | null;
-    /** Value that configures or reports current item raw before lock for this contract. */
-    currentItemRawBeforeLock: string | null;
-    /** Short operation name used in the conflict message (e.g. "history-redact"). */
-    operation: string;
-    /** Optional recovery reader retaining exact unreadable item bytes and a verified reconstructed document. */
-    readItem?: (located: NonNullable<Awaited<ReturnType<typeof locateItem>>>) => Promise<LoadedItem>;
+/** Value that configures or reports pm root for this contract. */
+pmRoot: string;
+/** Value that configures or reports subject for this contract. */
+subject: HistoryRewriteSubject;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports type registry for this contract. */
+typeRegistry: ItemTypeRegistry;
+/** Value that configures or reports history raw before lock for this contract. */
+historyRawBeforeLock: string | null;
+/** Value that configures or reports current item raw before lock for this contract. */
+currentItemRawBeforeLock: string | null;
+/** Short operation name used in the conflict message (e.g. "history-redact"). */
+operation: string;
+/** Optional recovery reader retaining exact unreadable item bytes and a verified reconstructed document. */
+readItem?: (located: NonNullable<Awaited<ReturnType<typeof locateItem>>>) => Promise<LoadedItem>;
 }
 /** Documents the verified history rewrite state payload exchanged by command, SDK, and package integrations. */
 export interface VerifiedHistoryRewriteState {
-    /** Value that configures or reports history raw under lock for this contract. */
-    historyRawUnderLock: string | null;
-    /** Value that configures or reports located under lock for this contract. */
-    locatedUnderLock: Awaited<ReturnType<typeof locateItem>>;
-    /** Value that configures or reports loaded item under lock for this contract. */
-    loadedItemUnderLock: LoadedItem | null;
+/** Value that configures or reports history raw under lock for this contract. */
+historyRawUnderLock: string | null;
+/** Value that configures or reports located under lock for this contract. */
+locatedUnderLock: Awaited<ReturnType<typeof locateItem>>;
+/** Value that configures or reports loaded item under lock for this contract. */
+loadedItemUnderLock: LoadedItem | null;
 }
 /** Re-read the history stream and the located item document under the acquired lock and compare both with the pre-lock raw snapshots. Throws PmCliError(CONFLICT) if either diverged while waiting for the lock so the caller surfaces an actionable retry. */
 export declare function verifyHistoryRewriteNoDrift(params: VerifyHistoryRewriteDriftParams): Promise<VerifiedHistoryRewriteState>;
 /** Documents the execute history rewrite params payload exchanged by command, SDK, and package integrations. */
 export interface ExecuteHistoryRewriteParams {
-    /** Value that configures or reports pm root for this contract. */
-    pmRoot: string;
-    /** Value that configures or reports subject for this contract. */
-    subject: HistoryRewriteSubject;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports type registry for this contract. */
-    typeRegistry: ItemTypeRegistry;
-    /** Value that configures or reports history raw before lock for this contract. */
-    historyRawBeforeLock: string | null;
-    /** Value that configures or reports current item raw before lock for this contract. */
-    currentItemRawBeforeLock: string | null;
-    /** Short operation name used in conflict guidance (e.g. "history-redact"). */
-    operation: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports force for this contract. */
-    force: boolean | undefined;
-    /** Value that configures or reports item document for this contract. */
-    itemDocument: ItemDocument | null;
-    /** Value that configures or reports apply rewrite for this contract. */
-    applyRewrite: (verified: VerifiedHistoryRewriteState) => Promise<void>;
-    /** Value that configures or reports apply post rewrite for this contract. */
-    applyPostRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<string[]>;
+/** Value that configures or reports pm root for this contract. */
+pmRoot: string;
+/** Value that configures or reports subject for this contract. */
+subject: HistoryRewriteSubject;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports type registry for this contract. */
+typeRegistry: ItemTypeRegistry;
+/** Value that configures or reports history raw before lock for this contract. */
+historyRawBeforeLock: string | null;
+/** Value that configures or reports current item raw before lock for this contract. */
+currentItemRawBeforeLock: string | null;
+/** Short operation name used in conflict guidance (e.g. "history-redact"). */
+operation: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports force for this contract. */
+force: boolean | undefined;
+/** Value that configures or reports item document for this contract. */
+itemDocument: ItemDocument | null;
+/** Value that configures or reports apply rewrite for this contract. */
+applyRewrite: (verified: VerifiedHistoryRewriteState) => Promise<void>;
+/** Value that configures or reports apply post rewrite for this contract. */
+applyPostRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<string[]>;
 }
 /** Writes the rewritten history stream and restores the under-lock snapshot on failure. */
 export declare function writeHistoryRawWithRollback(params: {
-    historyPath: string;
-    nextHistoryRaw: string;
-    historyRawUnderLock: string | null;
-    writeHistoryRaw?: HistoryRawWriter;
+historyPath: string;
+nextHistoryRaw: string;
+historyRawUnderLock: string | null;
+writeHistoryRaw?: HistoryRawWriter;
 }): Promise<void>;
 /** Shared lock/verify/ownership orchestration for history-rewrite commands. Callers provide the operation-specific write/rollback logic and optional post-write hook execution while this helper enforces the common governance + lock sequencing contract. */
 export declare function executeHistoryRewrite(params: ExecuteHistoryRewriteParams): Promise<string[]>;

package/dist/core/history/history-storage-stats.d.ts

@@ -1,45 +1,45 @@
 /** Pure aggregate metrics for history streams (JSONL files). No filesystem access — callers read raw stream contents and pass them in. This module has no Node imports; Buffer is available as a global. */
 /** Per-history-stream size and timestamp summary used by storage diagnostics. */
 export interface HistoryStreamStat {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports bytes for this contract. */
-    bytes: number;
-    /** Value that configures or reports lines for this contract. */
-    lines: number;
-    /** Value that configures or reports oldest ts for this contract. */
-    oldest_ts: string | null;
-    /** Value that configures or reports newest ts for this contract. */
-    newest_ts: string | null;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports bytes for this contract. */
+bytes: number;
+/** Value that configures or reports lines for this contract. */
+lines: number;
+/** Value that configures or reports oldest ts for this contract. */
+oldest_ts: string | null;
+/** Value that configures or reports newest ts for this contract. */
+newest_ts: string | null;
 }
 /** Documents the history storage entry ref payload exchanged by command, SDK, and package integrations. */
 export interface HistoryStorageEntryRef {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports ts for this contract. */
-    ts: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports ts for this contract. */
+ts: string;
 }
 /** Documents the history storage stats payload exchanged by command, SDK, and package integrations. */
 export interface HistoryStorageStats {
-    /** Value that configures or reports total streams for this contract. */
-    total_streams: number;
-    /** Value that configures or reports total lines for this contract. */
-    total_lines: number;
-    /** Value that configures or reports total bytes for this contract. */
-    total_bytes: number;
-    /** Value that configures or reports largest by bytes for this contract. */
-    largest_by_bytes: HistoryStreamStat[];
-    /** Value that configures or reports deepest by lines for this contract. */
-    deepest_by_lines: HistoryStreamStat[];
-    /** Value that configures or reports oldest entry for this contract. */
-    oldest_entry: HistoryStorageEntryRef | null;
-    /** Value that configures or reports newest entry for this contract. */
-    newest_entry: HistoryStorageEntryRef | null;
+/** Value that configures or reports total streams for this contract. */
+total_streams: number;
+/** Value that configures or reports total lines for this contract. */
+total_lines: number;
+/** Value that configures or reports total bytes for this contract. */
+total_bytes: number;
+/** Value that configures or reports largest by bytes for this contract. */
+largest_by_bytes: HistoryStreamStat[];
+/** Value that configures or reports deepest by lines for this contract. */
+deepest_by_lines: HistoryStreamStat[];
+/** Value that configures or reports oldest entry for this contract. */
+oldest_entry: HistoryStorageEntryRef | null;
+/** Value that configures or reports newest entry for this contract. */
+newest_entry: HistoryStorageEntryRef | null;
 }
 /** Implements compute history storage stats for the public runtime surface of this module. */
 export declare function computeHistoryStorageStats(streams: Array<{
-    id: string;
-    raw: string;
+id: string;
+raw: string;
 }>, options?: {
-    topN?: number;
+topN?: number;
 }): HistoryStorageStats;

package/dist/core/history/history-stream-policy.d.ts

@@ -1,22 +1,22 @@
 import type { PmSettings } from "../../types/index.js";
 interface HistoryStreamPolicyParams {
-    pmRoot: string;
-    settings: PmSettings;
-    itemId: string;
-    commandLabel: string;
+pmRoot: string;
+settings: PmSettings;
+itemId: string;
+commandLabel: string;
 }
 interface HistoryStreamPolicyManyParams {
-    pmRoot: string;
-    settings: PmSettings;
-    itemIds: string[];
-    commandLabel: string;
+pmRoot: string;
+settings: PmSettings;
+itemIds: string[];
+commandLabel: string;
 }
 /** Documents the history stream policy result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryStreamPolicyResult {
-    /** Value that configures or reports auto created ids for this contract. */
-    auto_created_ids: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports auto created ids for this contract. */
+auto_created_ids: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Implements enforce history stream policy for item for the public runtime surface of this module. */
 export declare function enforceHistoryStreamPolicyForItem(params: HistoryStreamPolicyParams): Promise<HistoryStreamPolicyResult>;

package/dist/core/history/history.d.ts

@@ -23,25 +23,25 @@ export declare function hashHistoryStream(entries: readonly HistoryEntry[]): str
 export declare function sealHistoryRecord(entry: HistoryEntry): HistoryEntry;
 /** Verify record-level attribution coverage while accepting explicit legacy item-state-only entries. */
 export declare function verifyHistoryRecordHash(entry: HistoryEntry): {
-    ok: true;
-    coverage: "record_and_item_state" | "item_state_only";
+ok: true;
+coverage: "record_and_item_state" | "item_state_only";
 } | {
-    ok: false;
-    error: "incomplete_record_hash_envelope" | "record_hash_mismatch" | "unsupported_record_hash_version" | "unsupported_history_hash_algorithm";
+ok: false;
+error: "incomplete_record_hash_envelope" | "record_hash_mismatch" | "unsupported_record_hash_version" | "unsupported_history_hash_algorithm";
 };
 /** Reseal a maintenance rewrite and retain the anchors and patch digest it replaced. */
 export declare function resealHistoryRewrite(original: HistoryEntry, rewritten: HistoryEntry, options?: Readonly<{
-    retainOriginalPatch?: boolean;
-    retainPriorRecord?: boolean;
-    retainPriorRecordHash?: boolean;
+retainOriginalPatch?: boolean;
+retainPriorRecord?: boolean;
+retainPriorRecordHash?: boolean;
 }>): HistoryEntry;
 /** Verify that retained rewrite evidence reconstructs every available prior record envelope. */
 export declare function verifyHistoryRewriteEvidence(entry: HistoryEntry): {
-    ok: true;
-    coverage: "complete" | "digest_only" | "legacy_anchor_only" | "none";
+ok: true;
+coverage: "complete" | "digest_only" | "legacy_anchor_only" | "none";
 } | {
-    ok: false;
-    error: "rewrite_evidence_invalid" | "rewrite_evidence_patch_hash_mismatch" | "rewrite_evidence_record_hash_mismatch";
+ok: false;
+error: "rewrite_evidence_invalid" | "rewrite_evidence_patch_hash_mismatch" | "rewrite_evidence_record_hash_mismatch";
 };
 declare function decodeJsonPointer(path: string): string[];
 declare function isDefinedPointerPath(document: unknown, path: string): boolean;
@@ -59,21 +59,21 @@ export declare function hashDocumentVerificationCandidates(document: ItemDocumen
 export declare function hashEmptyDocument(): string;
 /** Implements create history entry for the public runtime surface of this module. */
 export declare function createHistoryEntry(params: {
-    nowIso: string;
-    author: string;
-    authorSource?: AuthorSource;
-    op: string;
-    before: ItemDocument;
-    after: ItemDocument;
-    message?: string;
-    context?: Record<string, unknown>;
-    hashAlgorithm?: HistoryHashAlgorithm;
+nowIso: string;
+author: string;
+authorSource?: AuthorSource;
+op: string;
+before: ItemDocument;
+after: ItemDocument;
+message?: string;
+context?: Record<string, unknown>;
+hashAlgorithm?: HistoryHashAlgorithm;
 }): HistoryEntry;
 /** Implements append history entry for the public runtime surface of this module. */
 export declare function appendHistoryEntry(historyPath: string, entry: HistoryEntry): Promise<void>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    decodeJsonPointer: typeof decodeJsonPointer;
-    isDefinedPointerPath: typeof isDefinedPointerPath;
+decodeJsonPointer: typeof decodeJsonPointer;
+isDefinedPointerPath: typeof isDefinedPointerPath;
 };
 export {};

package/dist/core/history/identity.d.ts

@@ -4,12 +4,12 @@
 import type { HistoryEntry } from "../../types/index.js";
 /** Evidence of a second subject occupying one append-only identity stream. */
 export interface HistoryIdentityDiscontinuity {
-    /** One-based physical ordinal of the original create or retained baseline. */
-    prior_genesis_index: number;
-    /** One-based physical ordinal of the later create record. */
-    repeated_create_index: number;
-    /** Observed record sequence, not an assertion about branch or writer origin. */
-    sequence: "delete_then_create" | "multiple_creates" | "checkpoint_then_create";
+/** One-based physical ordinal of the original create or retained baseline. */
+prior_genesis_index: number;
+/** One-based physical ordinal of the later create record. */
+repeated_create_index: number;
+/** Observed record sequence, not an assertion about branch or writer origin. */
+sequence: "delete_then_create" | "multiple_creates" | "checkpoint_then_create";
 }
 /** Find every repeated genesis, including histories that start at a checkpoint. */
 export declare function findHistoryIdentityDiscontinuities(entries: readonly HistoryEntry[]): HistoryIdentityDiscontinuity[];

package/dist/core/history/operation-contract.d.ts

@@ -12,15 +12,15 @@ export declare const PM_HISTORY_OPERATION_ALIASES: Readonly<Record<string, strin
 export declare const PM_HISTORY_OPERATION_PATTERNS: readonly ["^config:(?:set|unset):[a-z][a-z0-9_.:-]*$", "^assurance:(?:measurement|invariant|gate):(?:put|remove)$", "^schema_(?:rename_type|rename_status|remap_status|rename_field|remove_type|remove_status|remove_field)(?:_compensate)?$", "^extension:[a-z][a-z0-9_-]*:[a-z][a-z0-9_]*$"];
 /** Public immutable-event naming and compatibility contract. */
 export declare const PM_HISTORY_OPERATION_CONTRACT: {
-    readonly version: 1;
-    readonly item: readonly ["append", "cancel", "claim", "close", "comment_add", "comment_edit", "comment_delete", "create", "delete", "docs_add", "docs_remove", "files_add", "files_remove", "files_discover", "history_author_acknowledge", "history_compact", "history_compact_baseline", "history_redact", "history_repair", "history_salvage", "import", "improvement_observe", "learning_add", "learning_edit", "learning_delete", "normalize", "note_add", "note_edit", "note_delete", "plan_create_metadata", "plan_create_initial_step", "plan_add_step", "plan_reorder_step", "plan_remove_step", "plan_link_step", "plan_unlink_step", "plan_append_decision", "plan_append_discovery", "plan_append_validation", "plan_resume", "plan_approve", "plan_materialize", "plan_update_step", "plan_complete_step", "plan_block_step", "policy_approve", "policy_refused", "release", "reopen", "restore", "schema_migration", "schema_migration_reference", "test_run_track", "tests_add", "tests_remove", "tests_update", "update", "update_audit", "update_ownership_bypass", "workspace_snapshot_restore", "extension_migrations_apply", "merge_reconcile"];
-    readonly workspace: readonly ["history:author-acknowledge", "settings:write", "init:type_preset", "templates:save", "profile:apply-types", "profile:apply-statuses", "profile:apply-fields", "profile:apply-config", "schema:add-type", "schema:remove-type", "schema:add-status", "schema:remove-status", "schema:add-field", "schema:remove-field", "schema:apply-preset", "schema:infer-types", "schema:policy-put", "schema:policy-remove", "schema:policy-mode", "assurance:bundle:apply", "assurance:gate:verdict", "telemetry:install_id", "telemetry:first_run_prompt", "telemetry:clear", "item_format:auto_select_default"];
-    readonly aliases: Readonly<Record<string, string>>;
-    readonly patterns: readonly ["^config:(?:set|unset):[a-z][a-z0-9_.:-]*$", "^assurance:(?:measurement|invariant|gate):(?:put|remove)$", "^schema_(?:rename_type|rename_status|remap_status|rename_field|remove_type|remove_status|remove_field)(?:_compensate)?$", "^extension:[a-z][a-z0-9_-]*:[a-z][a-z0-9_]*$"];
-    readonly read_policy: "preserve_original_operation";
-    readonly custom_operation_grammar: "extension:<package_name>:<snake_case_operation>";
-    readonly legacy_custom_operation_grammar: "lowercase segments separated by underscore, hyphen, colon, or dot; optional opaque colon-suffixed retry key";
-    readonly excluded_surfaces: readonly ["json_patch", "on_write_hook", "telemetry_span"];
+readonly version: 1;
+readonly item: readonly ["append", "cancel", "claim", "close", "comment_add", "comment_edit", "comment_delete", "create", "delete", "docs_add", "docs_remove", "files_add", "files_remove", "files_discover", "history_author_acknowledge", "history_compact", "history_compact_baseline", "history_redact", "history_repair", "history_salvage", "import", "improvement_observe", "learning_add", "learning_edit", "learning_delete", "normalize", "note_add", "note_edit", "note_delete", "plan_create_metadata", "plan_create_initial_step", "plan_add_step", "plan_reorder_step", "plan_remove_step", "plan_link_step", "plan_unlink_step", "plan_append_decision", "plan_append_discovery", "plan_append_validation", "plan_resume", "plan_approve", "plan_materialize", "plan_update_step", "plan_complete_step", "plan_block_step", "policy_approve", "policy_refused", "release", "reopen", "restore", "schema_migration", "schema_migration_reference", "test_run_track", "tests_add", "tests_remove", "tests_update", "update", "update_audit", "update_ownership_bypass", "workspace_snapshot_restore", "extension_migrations_apply", "merge_reconcile"];
+readonly workspace: readonly ["history:author-acknowledge", "settings:write", "init:type_preset", "templates:save", "profile:apply-types", "profile:apply-statuses", "profile:apply-fields", "profile:apply-config", "schema:add-type", "schema:remove-type", "schema:add-status", "schema:remove-status", "schema:add-field", "schema:remove-field", "schema:apply-preset", "schema:infer-types", "schema:policy-put", "schema:policy-remove", "schema:policy-mode", "assurance:bundle:apply", "assurance:gate:verdict", "telemetry:install_id", "telemetry:first_run_prompt", "telemetry:clear", "item_format:auto_select_default"];
+readonly aliases: Readonly<Record<string, string>>;
+readonly patterns: readonly ["^config:(?:set|unset):[a-z][a-z0-9_.:-]*$", "^assurance:(?:measurement|invariant|gate):(?:put|remove)$", "^schema_(?:rename_type|rename_status|remap_status|rename_field|remove_type|remove_status|remove_field)(?:_compensate)?$", "^extension:[a-z][a-z0-9_-]*:[a-z][a-z0-9_]*$"];
+readonly read_policy: "preserve_original_operation";
+readonly custom_operation_grammar: "extension:<package_name>:<snake_case_operation>";
+readonly legacy_custom_operation_grammar: "lowercase segments separated by underscore, hyphen, colon, or dot; optional opaque colon-suffixed retry key";
+readonly excluded_surfaces: readonly ["json_patch", "on_write_hook", "telemetry_span"];
 };
 /** Resolve known historical aliases without changing or rejecting an immutable record. */
 export declare function resolveHistoryOperation(operation: string): string;

package/dist/core/history/projection.d.ts

@@ -2,26 +2,26 @@ import type { HistoryEntry, HistoryPatchOp } from "../../types/index.js";
 import { type ReplayDocument } from "./replay.js";
 /** Describes the normalized version or timestamp selected from a history stream. */
 export interface ResolvedHistoryTarget {
-    /** Target syntax selected by the caller. */
-    kind: "version" | "timestamp";
-    /** Original normalized target text. */
-    raw: string;
-    /** Zero-based history entry selected for reconstruction. */
-    historyIndex: number;
+/** Target syntax selected by the caller. */
+kind: "version" | "timestamp";
+/** Original normalized target text. */
+raw: string;
+/** Zero-based history entry selected for reconstruction. */
+historyIndex: number;
 }
 /** Controls caller-specific target diagnostics and future timestamp policy. */
 export interface ResolveHistoryTargetOptions {
-    /** Command concept named in agent-facing validation errors. */
-    errorSubject?: "history" | "restore";
-    /** Allow a timestamp after the final entry to select that final entry. */
-    allowFutureTimestamp?: boolean;
+/** Command concept named in agent-facing validation errors. */
+errorSubject?: "history" | "restore";
+/** Allow a timestamp after the final entry to select that final entry. */
+allowFutureTimestamp?: boolean;
 }
 interface PatchFailureContext {
-    patchIndex?: number;
-    op?: string;
-    path?: string;
-    from?: string;
-    reason?: string;
+patchIndex?: number;
+op?: string;
+path?: string;
+from?: string;
+reason?: string;
 }
 /** Extract best-effort JSON Patch position details for replay diagnostics. */
 export declare function extractPatchFailureContext(patch: HistoryPatchOp[], error: unknown): PatchFailureContext;

package/dist/core/history/read.d.ts

@@ -1,10 +1,10 @@
 import type { HistoryEntry } from "../../types/index.js";
 /** Exact bytes and decoded entries from one read, suitable for optimistic concurrency checks. */
 export interface HistoryStreamSnapshot {
-    /** Null means the stream did not exist; an empty string means it existed without entries. */
-    raw: string | null;
-    /** Entries decoded from precisely the bytes in `raw`, after read hooks run. */
-    entries: HistoryEntry[];
+/** Null means the stream did not exist; an empty string means it existed without entries. */
+raw: string | null;
+/** Entries decoded from precisely the bytes in `raw`, after read hooks run. */
+entries: HistoryEntry[];
 }
 /** Read one history stream once so replay input and the concurrency snapshot cannot disagree. */
 export declare function readHistorySnapshot(historyPath: string, itemId: string): Promise<HistoryStreamSnapshot>;