@unbrained/pm-cli 2026.10.14 → 2026.10.17

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

@@ -1,97 +1,97 @@
 import type { ItemTypeRegistry } from "../item/type-registry.js";
-import { locateItem, readLocatedItem } from "../store/item-store.js";
-import type { ItemDocument, PmSettings } from "../../types/index.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;
+recovered?:boolean;
 };
-type HistoryRawWriter = (filePath: string, content: string) => Promise<void>;
+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;
+id:string;
 /** Filesystem path used for history resolution. */
-historyPath: string;
+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;
+itemDocument:ItemDocument | null;
 /** Value that configures or reports subject id for this contract. */
-subjectId: string;
+subjectId:string;
 /** Value that configures or reports author for this contract. */
-author: string;
+author:string;
 /** Value that configures or reports force for this contract. */
-force: boolean | undefined;
+force:boolean | undefined;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+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[];
+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;
+pmRoot:string;
 /** Value that configures or reports subject for this contract. */
-subject: HistoryRewriteSubject;
+subject:HistoryRewriteSubject;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports type registry for this contract. */
-typeRegistry: ItemTypeRegistry;
+typeRegistry:ItemTypeRegistry;
 /** Value that configures or reports history raw before lock for this contract. */
-historyRawBeforeLock: string | null;
+historyRawBeforeLock:string | null;
 /** Value that configures or reports current item raw before lock for this contract. */
-currentItemRawBeforeLock: string | null;
+currentItemRawBeforeLock:string | null;
 /** Short operation name used in the conflict message (e.g. "history-redact"). */
-operation: string;
+operation:string;
 /** Optional recovery reader retaining exact unreadable item bytes and a verified reconstructed document. */
-readItem?: (located: NonNullable<Awaited<ReturnType<typeof locateItem>>>) => Promise<LoadedItem>;
+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;
+historyRawUnderLock:string | null;
 /** Value that configures or reports located under lock for this contract. */
-locatedUnderLock: Awaited<ReturnType<typeof locateItem>>;
+locatedUnderLock:Awaited<ReturnType<typeof locateItem>>;
 /** Value that configures or reports loaded item under lock for this contract. */
-loadedItemUnderLock: LoadedItem | null;
+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>;
+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;
+pmRoot:string;
 /** Value that configures or reports subject for this contract. */
-subject: HistoryRewriteSubject;
+subject:HistoryRewriteSubject;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports type registry for this contract. */
-typeRegistry: ItemTypeRegistry;
+typeRegistry:ItemTypeRegistry;
 /** Value that configures or reports history raw before lock for this contract. */
-historyRawBeforeLock: string | null;
+historyRawBeforeLock:string | null;
 /** Value that configures or reports current item raw before lock for this contract. */
-currentItemRawBeforeLock: string | null;
+currentItemRawBeforeLock:string | null;
 /** Short operation name used in conflict guidance (e.g. "history-redact"). */
-operation: string;
+operation:string;
 /** Value that configures or reports author for this contract. */
-author: string;
+author:string;
 /** Value that configures or reports force for this contract. */
-force: boolean | undefined;
+force:boolean | undefined;
 /** Value that configures or reports item document for this contract. */
-itemDocument: ItemDocument | null;
+itemDocument:ItemDocument | null;
 /** Value that configures or reports apply rewrite for this contract. */
-applyRewrite: (verified: VerifiedHistoryRewriteState) => Promise<void>;
+applyRewrite:(verified:VerifiedHistoryRewriteState) => Promise<void>;
 /** Value that configures or reports apply post rewrite for this contract. */
-applyPostRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<string[]>;
+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;
-}): Promise<void>;
+export declare function writeHistoryRawWithRollback(params:{
+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[]>;
+export declare function executeHistoryRewrite(params:ExecuteHistoryRewriteParams):Promise<string[]>;
 export {};

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

@@ -2,44 +2,44 @@
 /** 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;
+id:string;
 /** Value that configures or reports bytes for this contract. */
-bytes: number;
+bytes:number;
 /** Value that configures or reports lines for this contract. */
-lines: number;
+lines:number;
 /** Value that configures or reports oldest ts for this contract. */
-oldest_ts: string | null;
+oldest_ts:string | null;
 /** Value that configures or reports newest ts for this contract. */
-newest_ts: string | null;
+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;
+id:string;
 /** Value that configures or reports ts for this contract. */
-ts: string;
+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;
+total_streams:number;
 /** Value that configures or reports total lines for this contract. */
-total_lines: number;
+total_lines:number;
 /** Value that configures or reports total bytes for this contract. */
-total_bytes: number;
+total_bytes:number;
 /** Value that configures or reports largest by bytes for this contract. */
-largest_by_bytes: HistoryStreamStat[];
+largest_by_bytes:HistoryStreamStat[];
 /** Value that configures or reports deepest by lines for this contract. */
-deepest_by_lines: HistoryStreamStat[];
+deepest_by_lines:HistoryStreamStat[];
 /** Value that configures or reports oldest entry for this contract. */
-oldest_entry: HistoryStorageEntryRef | null;
+oldest_entry:HistoryStorageEntryRef | null;
 /** Value that configures or reports newest entry for this contract. */
-newest_entry: HistoryStorageEntryRef | null;
+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;
-}>, options?: {
-topN?: number;
-}): HistoryStorageStats;
+export declare function computeHistoryStorageStats(streams:Array<{
+id:string;
+raw:string;
+}>,options?:{
+topN?:number;
+}):HistoryStorageStats;

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

@@ -1,25 +1,25 @@
 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[];
+auto_created_ids:string[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+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>;
+export declare function enforceHistoryStreamPolicyForItem(params:HistoryStreamPolicyParams):Promise<HistoryStreamPolicyResult>;
 /** Implements enforce history stream policy for items for the public runtime surface of this module. */
-export declare function enforceHistoryStreamPolicyForItems(params: HistoryStreamPolicyManyParams): Promise<HistoryStreamPolicyResult>;
+export declare function enforceHistoryStreamPolicyForItems(params:HistoryStreamPolicyManyParams):Promise<HistoryStreamPolicyResult>;
 export {};

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

@@ -1,79 +1,79 @@
 import { type HistoryHashAlgorithm } from "./digest.js";
 import { type AuthorSource } from "../shared/author.js";
-import type { HistoryEntry, HistoryPatchOp, ItemDocument } from "../../types/index.js";
+import type { HistoryEntry,HistoryPatchOp,ItemDocument } from "../../types/index.js";
 /** Hash epoch for the current canonical item surface written into immutable history. */
-export declare const CURRENT_HISTORY_ITEM_HASH_VERSION: 3;
+export declare const CURRENT_HISTORY_ITEM_HASH_VERSION:3;
 /** Hash epochs understood by this runtime. */
-export declare const SUPPORTED_HISTORY_ITEM_HASH_VERSIONS: readonly [1, 2, 3];
+export declare const SUPPORTED_HISTORY_ITEM_HASH_VERSIONS:readonly [1,2,3];
 /** Record-integrity epoch written beside new immutable history events. */
-export declare const CURRENT_HISTORY_RECORD_HASH_VERSION: 1;
+export declare const CURRENT_HISTORY_RECORD_HASH_VERSION:1;
 /** Record-integrity epochs understood by this runtime. */
-export declare const SUPPORTED_HISTORY_RECORD_HASH_VERSIONS: readonly [1];
+export declare const SUPPORTED_HISTORY_RECORD_HASH_VERSIONS:readonly [1];
 /** Restricts item hash versions accepted by history replay. */
 export type HistoryItemHashVersion = (typeof SUPPORTED_HISTORY_ITEM_HASH_VERSIONS)[number];
 /** Restricts immutable-record hash versions accepted by history replay. */
 export type HistoryRecordHashVersion = (typeof SUPPORTED_HISTORY_RECORD_HASH_VERSIONS)[number];
 /** Canonicalize and hash every immutable record field except the hash value itself. */
-export declare function hashHistoryRecord(entry: Omit<HistoryEntry, "record_hash">): string;
+export declare function hashHistoryRecord(entry:Omit<HistoryEntry,"record_hash">):string;
 /** Hash one patch representation without retaining its potentially sensitive values. */
-export declare function hashHistoryPatch(patch: readonly HistoryPatchOp[]): string;
+export declare function hashHistoryPatch(patch:readonly HistoryPatchOp[]):string;
 /** Hash an ordered history prefix for compact checkpoint provenance. */
-export declare function hashHistoryStream(entries: readonly HistoryEntry[]): string;
+export declare function hashHistoryStream(entries:readonly HistoryEntry[]):string;
 /** Attach the current immutable-record integrity envelope to one history event. */
-export declare function sealHistoryRecord(entry: HistoryEntry): HistoryEntry;
+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";
+export declare function verifyHistoryRecordHash(entry:HistoryEntry):{
+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;
-}>): HistoryEntry;
+export declare function resealHistoryRewrite(original:HistoryEntry,rewritten:HistoryEntry,options?:Readonly<{
+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";
+export declare function verifyHistoryRewriteEvidence(entry:HistoryEntry):{
+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;
+declare function decodeJsonPointer(path:string):string[];
+declare function isDefinedPointerPath(document:unknown,path:string):boolean;
 /** Implements hash document for the public runtime surface of this module. */
-export declare function hashDocument(document: ItemDocument): string;
+export declare function hashDocument(document:ItemDocument):string;
 /** Hash an item with an explicit canonicalization epoch for replay compatibility. */
-export declare function hashDocumentForVersion(document: ItemDocument, version: HistoryItemHashVersion, algorithm?: HistoryHashAlgorithm): string;
+export declare function hashDocumentForVersion(document:ItemDocument,version:HistoryItemHashVersion,algorithm?:HistoryHashAlgorithm):string;
 /**
  * Return the ordered hash candidates accepted when verifying one immutable
  * history epoch. Epoch 2 has both its established expanded hash first and the
  * earlier field-frozen writer hash second; the other epochs have one form.
  */
-export declare function hashDocumentVerificationCandidates(document: ItemDocument, version: HistoryItemHashVersion, algorithm?: HistoryHashAlgorithm): [string, ...string[]];
+export declare function hashDocumentVerificationCandidates(document:ItemDocument,version:HistoryItemHashVersion,algorithm?:HistoryHashAlgorithm):[string,...string[]];
 /** Implements hash empty document for the public runtime surface of this module. */
-export declare function hashEmptyDocument(): string;
+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;
-}): HistoryEntry;
+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;
+}):HistoryEntry;
 /** Implements append history entry for the public runtime surface of this module. */
-export declare function appendHistoryEntry(historyPath: string, entry: HistoryEntry): Promise<void>;
+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;
+export declare const _testOnly:{
+decodeJsonPointer:typeof decodeJsonPointer;
+isDefinedPointerPath:typeof isDefinedPointerPath;
 };
 export {};

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

@@ -5,11 +5,11 @@ 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;
+prior_genesis_index:number;
 /** One-based physical ordinal of the later create record. */
-repeated_create_index: number;
+repeated_create_index:number;
 /** Observed record sequence, not an assertion about branch or writer origin. */
-sequence: "delete_then_create" | "multiple_creates" | "checkpoint_then_create";
+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[];
+export declare function findHistoryIdentityDiscontinuities(entries:readonly HistoryEntry[]):HistoryIdentityDiscontinuity[];

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

@@ -3,28 +3,28 @@
  * Declares immutable operation identities separately from hooks and JSON Patch verbs.
  */
 /** Native item-event vocabulary. New names require an explicit contract change. */
-export declare const PM_ITEM_HISTORY_OPERATIONS: 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"];
+export declare const PM_ITEM_HISTORY_OPERATIONS: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"];
 /** Exact singleton identities retained for compatibility with existing workspace streams. */
-export declare const PM_WORKSPACE_HISTORY_OPERATIONS: 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"];
+export declare const PM_WORKSPACE_HISTORY_OPERATIONS: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"];
 /** Retired writer spellings; readers preserve original bytes and may resolve aliases explicitly. */
-export declare const PM_HISTORY_OPERATION_ALIASES: Readonly<Record<string, string>>;
+export declare const PM_HISTORY_OPERATION_ALIASES:Readonly<Record<string,string>>;
 /** Parameterized operation families whose operands are governed by their owning SDK contracts. */
-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_]*$"];
+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"];
+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"];
 };
 /** Resolve known historical aliases without changing or rejecting an immutable record. */
-export declare function resolveHistoryOperation(operation: string): string;
+export declare function resolveHistoryOperation(operation:string):string;
 /** Validate a new operation and return its declared canonical writer spelling. */
-export declare function requireHistoryOperation(operation: string): string;
+export declare function requireHistoryOperation(operation:string):string;
 /** Canonicalize native aliases while retaining well-formed custom SDK operation identities. */
-export declare function normalizeHistoryOperationForWrite(operation: string): string;
+export declare function normalizeHistoryOperationForWrite(operation:string):string;

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

@@ -1,39 +1,39 @@
-import type { HistoryEntry, HistoryPatchOp } from "../../types/index.js";
+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";
+kind:"version" | "timestamp";
 /** Original normalized target text. */
-raw: string;
+raw:string;
 /** Zero-based history entry selected for reconstruction. */
-historyIndex: number;
+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";
+errorSubject?:"history" | "restore";
 /** Allow a timestamp after the final entry to select that final entry. */
-allowFutureTimestamp?: boolean;
+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;
+export declare function extractPatchFailureContext(patch:HistoryPatchOp[],error:unknown):PatchFailureContext;
 /**
  * Resolve a one-based version or ISO timestamp into a concrete history entry.
  * Errors include structured valid-range metadata for agent and SDK callers.
  */
-export declare function resolveHistoryTarget(target: string, history: readonly HistoryEntry[], options?: ResolveHistoryTargetOptions): ResolvedHistoryTarget;
+export declare function resolveHistoryTarget(target:string,history:readonly HistoryEntry[],options?:ResolveHistoryTargetOptions):ResolvedHistoryTarget;
 /** Apply one normalized JSON Patch entry and retain actionable failure context. */
-export declare function applyHistoryPatch(current: ReplayDocument, patch: HistoryPatchOp[], entryNumber: number, entryOp: string): ReplayDocument;
+export declare function applyHistoryPatch(current:ReplayDocument,patch:HistoryPatchOp[],entryNumber:number,entryOp:string):ReplayDocument;
 /** Replay and hash-verify a history stream through a zero-based target entry. */
-export declare function replayHistoryToTarget(history: readonly HistoryEntry[], targetIndex: number): ReplayDocument;
+export declare function replayHistoryToTarget(history:readonly HistoryEntry[],targetIndex:number):ReplayDocument;
 /** Reject a version whose reconstructed state represents a deleted item. */
-export declare function ensureMaterializedHistoryTarget(replayDocument: ReplayDocument, target: ResolvedHistoryTarget): ReplayDocument;
+export declare function ensureMaterializedHistoryTarget(replayDocument:ReplayDocument,target:ResolvedHistoryTarget):ReplayDocument;
 export {};

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

@@ -2,11 +2,11 @@ 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;
+raw:string | null;
 /** Entries decoded from precisely the bytes in `raw`, after read hooks run. */
-entries: HistoryEntry[];
+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>;
+export declare function readHistorySnapshot(historyPath:string,itemId:string):Promise<HistoryStreamSnapshot>;
 /** Read and validate one item's JSONL history stream without mutating it. */
-export declare function readHistoryEntries(historyPath: string, itemId: string): Promise<HistoryEntry[]>;
+export declare function readHistoryEntries(historyPath:string,itemId:string):Promise<HistoryEntry[]>;