@unbrained/pm-cli 2026.10.11 → 2026.10.13

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>;

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

@@ -11,10 +11,10 @@ import type { HistoryEntry, HistoryPatchOp, ItemDocument } from "../../types/ind
  * generic message) are preserved; only the underlying replay/patch logic is shared.
  */
 export interface ReplayDocument {
-    /** Value that configures or reports metadata for this contract. */
-    metadata: Record<string, unknown>;
-    /** Value that configures or reports body for this contract. */
-    body: string;
+/** Value that configures or reports metadata for this contract. */
+metadata: Record<string, unknown>;
+/** Value that configures or reports body for this contract. */
+body: string;
 }
 /** Public contract for empty replay document, shared by SDK and presentation-layer consumers. */
 export declare const EMPTY_REPLAY_DOCUMENT: ReplayDocument;
@@ -40,74 +40,76 @@ export declare function normalizeReplayPatchPath(path: string): string;
 export declare function normalizeReplayPatchOps(patch: HistoryPatchOp[] | unknown): HistoryPatchOp[];
 /** Restricts replay apply result values accepted by command, SDK, and storage contracts. */
 export type ReplayApplyResult = {
-    ok: true;
-    document: ReplayDocument;
+ok: true;
+document: ReplayDocument;
 } | {
-    ok: false;
-    error: unknown;
+ok: false;
+error: unknown;
 };
 /** Strictly apply a history patch (front_matter->metadata normalized) to a replay document. Returns a result envelope rather than throwing so each caller can format its own error contract. */
 export declare function tryApplyReplayPatch(current: ReplayDocument, patch: HistoryPatchOp[]): ReplayApplyResult;
 /** Verify a chain and report the explicit or auto-detected item hash epoch. */
 export declare function verifyHistoryChainWithVersion(entries: HistoryEntry[]): {
-    ok: boolean;
-    errors: string[];
-    item_hash_version?: HistoryItemHashVersion;
+ok: boolean;
+errors: string[];
+item_hash_version?: HistoryItemHashVersion;
 };
 /** Deterministically verify a history chain while preserving the legacy result shape. */
 export declare function verifyHistoryChain(entries: HistoryEntry[]): {
-    ok: boolean;
-    errors: string[];
+ok: boolean;
+errors: string[];
 };
 /** Documents the lenient apply result payload exchanged by command, SDK, and package integrations. */
 export interface LenientApplyResult {
-    /** Value that configures or reports document for this contract. */
-    document: ReplayDocument;
-    /** Value that configures or reports converted replace to add for this contract. */
-    convertedReplaceToAdd: number;
-    /** Value that configures or reports skipped ops for this contract. */
-    skippedOps: number;
+/** Value that configures or reports document for this contract. */
+document: ReplayDocument;
+/** Value that configures or reports converted replace to add for this contract. */
+convertedReplaceToAdd: number;
+/** Value that configures or reports skipped ops for this contract. */
+skippedOps: number;
 }
 /** Apply a legacy patch op-by-op, recovering from drift that strict replay rejects: a `replace` whose path no longer exists is retried as `add`, and any op that still cannot apply against the current replay state is skipped. The resulting document is what the repaired entry's recomputed patch should target. */
 export declare function lenientApplyReplayPatch(current: ReplayDocument, patch: HistoryPatchOp[]): LenientApplyResult;
 /** Documents the reanchor entry detail payload exchanged by command, SDK, and package integrations. */
 export interface ReanchorEntryDetail {
-    /** Value that configures or reports index for this contract. */
-    index: number;
-    /** Value that configures or reports rehashed for this contract. */
-    rehashed: boolean;
-    /** Value that configures or reports patch repaired for this contract. */
-    patch_repaired: boolean;
-    /** Value that configures or reports converted replace to add for this contract. */
-    converted_replace_to_add: number;
-    /** Value that configures or reports skipped ops for this contract. */
-    skipped_ops: number;
+/** Value that configures or reports index for this contract. */
+index: number;
+/** Value that configures or reports rehashed for this contract. */
+rehashed: boolean;
+/** Value that configures or reports patch repaired for this contract. */
+patch_repaired: boolean;
+/** Value that configures or reports converted replace to add for this contract. */
+converted_replace_to_add: number;
+/** Value that configures or reports skipped ops for this contract. */
+skipped_ops: number;
 }
 /** Documents the reanchor result payload exchanged by command, SDK, and package integrations. */
 export interface ReanchorResult {
-    /** Value that configures or reports entries for this contract. */
-    entries: HistoryEntry[];
-    /** Value that configures or reports final document for this contract. */
-    finalDocument: ReplayDocument;
-    /** Value that configures or reports entries rehashed for this contract. */
-    entriesRehashed: number;
-    /** Value that configures or reports entries patch repaired for this contract. */
-    entriesPatchRepaired: number;
-    /** Value that configures or reports converted replace to add for this contract. */
-    convertedReplaceToAdd: number;
-    /** Value that configures or reports skipped ops for this contract. */
-    skippedOps: number;
-    /** Value that configures or reports details for this contract. */
-    details: ReanchorEntryDetail[];
-    /** Hash epoch retained while rebuilding the stream. */
-    itemHashVersion: HistoryItemHashVersion;
-    /** Whether rewritten entries explicitly carry the hash epoch field. */
-    explicitItemHashVersion: boolean;
+/** Value that configures or reports entries for this contract. */
+entries: HistoryEntry[];
+/** Value that configures or reports final document for this contract. */
+finalDocument: ReplayDocument;
+/** Value that configures or reports entries rehashed for this contract. */
+entriesRehashed: number;
+/** Value that configures or reports entries patch repaired for this contract. */
+entriesPatchRepaired: number;
+/** Value that configures or reports converted replace to add for this contract. */
+convertedReplaceToAdd: number;
+/** Value that configures or reports skipped ops for this contract. */
+skippedOps: number;
+/** Value that configures or reports details for this contract. */
+details: ReanchorEntryDetail[];
+/** Hash epoch retained while rebuilding the stream. */
+itemHashVersion: HistoryItemHashVersion;
+/** Whether rewritten entries explicitly carry the hash epoch field. */
+explicitItemHashVersion: boolean;
 }
 /** Controls whether re-anchoring preserves historical writer transitions or emits one exact hash surface. */
 export interface ReanchorHistoryOptions {
-    /** Keep one semantic hash candidate for the complete rewritten stream so adjacent stored endpoints are identical. */
-    continuousHashSurface?: boolean;
+/** Keep one semantic hash candidate for the complete rewritten stream so adjacent stored endpoints are identical. */
+continuousHashSurface?: boolean;
+/** Rebase an entry's patch onto its new replay position, retaining the original patch as immutable rewrite evidence. */
+projectPatch?: (entry: HistoryEntry, current: ReplayDocument) => HistoryPatchOp[];
 }
 /**
  * Resolve the hash epoch a repair must retain.

package/dist/core/history/replay.js

@@ -1,4 +1,4 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3bf5f300-1829-5009-ae96-be7df309b589")}catch{}})();import jsonPatch from"fast-json-patch";import{historyDigest,resolveHistoryHashAlgorithm}from"./digest.js";import{findHistoryIdentityDiscontinuities}from"./identity.js";import{ITEM_METADATA_KEY_ORDER}from"../shared/constants.js";import{canonicalDocument}from"../item/item-format.js";import{toItemRecord}from"../item/item-record.js";import{orderObject,stableStringify}from"../shared/serialization.js";import{CURRENT_HISTORY_ITEM_HASH_VERSION,SUPPORTED_HISTORY_ITEM_HASH_VERSIONS,hashDocumentVerificationCandidates,resealHistoryRewrite,verifyHistoryRecordHash,verifyHistoryRewriteEvidence}from"./history.js";const EMPTY_REPLAY_DOCUMENT={metadata:{},body:""};function cloneEmptyReplayDocument(){return structuredClone(EMPTY_REPLAY_DOCUMENT)}function replayHash(document,version=CURRENT_HISTORY_ITEM_HASH_VERSION,algorithm){return replayHashVerificationCandidates(document,version,algorithm)[0]}function replayHashVerificationCandidates(document,version,algorithm){if(Object.keys(document.metadata).length===0||Array.isArray(document.metadata.tags))try{return hashDocumentVerificationCandidates(replayToItemDocument(document),version,algorithm)}catch{}const fallback=historyDigest(stableStringify({replay_fallback:!0,metadata:document.metadata,body:document.body}),algorithm);return version===2?[fallback,fallback]:[fallback]}function matchReplayHashCandidates(before,after,version,entry,memo){const algorithm=resolveHistoryHashAlgorithm(entry.hash_algorithm),memoKey=`${version}:${algorithm}`,beforeHashes=memo?.before.get(memoKey)??replayHashVerificationCandidates(before,version,algorithm),afterHashes=replayHashVerificationCandidates(after,version,algorithm);return memo?.after.set(memoKey,afterHashes),{beforeHashes,afterHashes,pairIndex:beforeHashes.findIndex((beforeHash,hashIndex)=>beforeHash===entry.before_hash&&afterHashes[hashIndex]===entry.after_hash),beforeIndex:beforeHashes.indexOf(entry.before_hash),afterIndex:afterHashes.indexOf(entry.after_hash)}}function replayToItemDocument(document){return{metadata:document.metadata,body:document.body}}function replayToCanonicalItemDocument(document,options={}){return canonicalDocument(replayToItemDocument(document),options)}function toReplayDocument(document){if(!document.metadata||Object.keys(document.metadata).length===0)return{metadata:{},body:document.body??""};const canonical=canonicalDocument(document);return{metadata:orderObject(toItemRecord(canonical.metadata),ITEM_METADATA_KEY_ORDER),body:canonical.body}}function normalizeReplayPatchPath(path){return path==="/front_matter"?"/metadata":path.startsWith("/front_matter/")?`/metadata/${path.slice(14)}`:path}function isHistoryPatchOp(value){return typeof value=="object"&&value!==null&&typeof value.op=="string"&&typeof value.path=="string"}function normalizeReplayPatchOps(patch){return Array.isArray(patch)?patch.filter(isHistoryPatchOp).map(operation=>({...operation,path:normalizeReplayPatchPath(operation.path),from:typeof operation.from=="string"?normalizeReplayPatchPath(operation.from):void 0})):[]}function isReplayDocumentShape(value){return typeof value=="object"&&value!==null&&"metadata"in value&&"body"in value&&typeof value.body=="string"&&typeof value.metadata=="object"&&value.metadata!==null}function tryApplyReplayPatch(current,patch){try{const normalizedPatch=normalizeReplayPatchOps(patch),applied=jsonPatch.applyPatch(structuredClone(current),normalizedPatch,!0,!0).newDocument;return isReplayDocumentShape(applied)?{ok:!0,document:{metadata:applied.metadata,body:applied.body}}:{ok:!1,error:new Error("history_replay_invalid_document_shape")}}catch(error){return{ok:!1,error}}}function supportedExplicitHistoryItemHashVersions(entries){return[...new Set(entries.map(entry=>entry.item_hash_version).filter(version=>version!==void 0&&SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version)))]}function isUnsupportedExplicitHistoryItemHashVersion(version){return version!==void 0&&!SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version)}function historyEntryHashCandidates(explicitVersion,authoritativeVersion){return explicitVersion!==void 0?[explicitVersion]:authoritativeVersion===void 0?[...SUPPORTED_HISTORY_ITEM_HASH_VERSIONS]:[authoritativeVersion]}function historyEntryIntegrityError(entry){const recordVerification=verifyHistoryRecordHash(entry);if(!recordVerification.ok)return recordVerification.error;const rewriteVerification=verifyHistoryRewriteEvidence(entry);return rewriteVerification.ok?void 0:rewriteVerification.error}function verifyHistoryEntryInput(entry,replay){const integrityError=historyEntryIntegrityError(entry);if(integrityError)return{ok:!1,error:integrityError};const applied=tryApplyReplayPatch(replay,entry.patch);return applied.ok?{ok:!0,document:applied.document}:{ok:!1,error:"patch_apply_failed"}}function assertHistoryEntryIntegrity(entry,index){const integrityError=historyEntryIntegrityError(entry);if(integrityError)throw new TypeError(`${integrityError}:entry_${index+1}`)}function matchReplayEpochCandidates(before,after,candidates,entry,memo){const matches=[];for(const version of candidates){const match=matchReplayHashCandidates(before,after,version,entry,memo);if(matches.push({version,match}),match.pairIndex>=0)break}return matches}function verifyHistoryChainWithVersion(entries){let replay=cloneEmptyReplayDocument(),beforeHashMemo=new Map,detectedVersion,authoritativeExplicitVersion;const errors=findHistoryIdentityDiscontinuities(entries).map(finding=>`verify_failed:duplicate_create:entry_${finding.repeated_create_index}:prior_${finding.prior_genesis_index}`);for(let index=0;index<entries.length;index+=1){const entry=entries[index],explicitVersion=entry.item_hash_version,unsupportedVersion=isUnsupportedExplicitHistoryItemHashVersion(explicitVersion);unsupportedVersion&&errors.push(`verify_failed:unsupported_item_hash_version:${String(explicitVersion)}:entry_${index+1}`);const input=verifyHistoryEntryInput(entry,replay);if(!input.ok)return{ok:!1,errors:[...errors,`verify_failed:${input.error}:entry_${index+1}`]};if(unsupportedVersion){replay=input.document,beforeHashMemo=new Map,detectedVersion=void 0,authoritativeExplicitVersion=void 0;continue}const candidates=historyEntryHashCandidates(explicitVersion,authoritativeExplicitVersion),memo={before:beforeHashMemo,after:new Map},candidateMatches=matchReplayEpochCandidates(replay,input.document,candidates,entry,memo),matchingVersion=candidateMatches.find(({match})=>match.pairIndex>=0);if(matchingVersion===void 0){const beforeMatches=candidateMatches.some(({match})=>match.beforeIndex>=0);return{ok:!1,errors:[...errors,`verify_failed:${beforeMatches?"after":"before"}_hash_mismatch:entry_${index+1}`]}}const version=matchingVersion.version;replay=input.document,beforeHashMemo=memo.after,detectedVersion=version,authoritativeExplicitVersion=explicitVersion??authoritativeExplicitVersion}return errors.length>0?{ok:!1,errors,...detectedVersion===void 0?{}:{item_hash_version:detectedVersion}}:{ok:!0,errors:[],...detectedVersion===void 0?{}:{item_hash_version:detectedVersion}}}function verifyHistoryChain(entries){const result=verifyHistoryChainWithVersion(entries);return{ok:result.ok,errors:result.errors}}function tryApplySingleOp(document,op){try{return{ok:!0,document:jsonPatch.applyPatch(structuredClone(document),[op],!0,!1).newDocument}}catch{return{ok:!1}}}function lenientApplyReplayPatch(current,patch){let working=structuredClone(current),convertedReplaceToAdd=0,skippedOps=0;for(const op of normalizeReplayPatchOps(patch)){const direct=tryApplySingleOp(working,op);if(direct.ok){working=direct.document;continue}if(op.op==="replace"){const asAdd=tryApplySingleOp(working,{...op,op:"add"});if(asAdd.ok){working=asAdd.document,convertedReplaceToAdd+=1;continue}}skippedOps+=1}const candidate=working;return{document:{metadata:typeof candidate.metadata=="object"&&candidate.metadata!==null?candidate.metadata:{},body:typeof candidate.body=="string"?candidate.body:current.body},convertedReplaceToAdd,skippedOps}}function resolveHistoryRepairItemHashVersion(entries){const explicitVersions=supportedExplicitHistoryItemHashVersions(entries);if(explicitVersions.length===1)return explicitVersions[0];const verified=verifyHistoryChainWithVersion(entries);return verified.ok&&verified.item_hash_version!==void 0?verified.item_hash_version:explicitVersions.length===0?1:CURRENT_HISTORY_ITEM_HASH_VERSION}function applyReanchorPatch(replay,entry){const strict=tryApplyReplayPatch(replay,entry.patch);if(strict.ok)return{next:strict.document,patch:entry.patch,repaired:!1,converted:0,skipped:0};const lenient=lenientApplyReplayPatch(replay,entry.patch);return{next:lenient.document,patch:jsonPatch.compare(replay,lenient.document),repaired:!0,converted:lenient.convertedReplaceToAdd,skipped:lenient.skippedOps}}function reanchorHistoryEntries(entries,itemHashVersion=resolveHistoryRepairItemHashVersion(entries),options={}){const unsupportedIndex=entries.findIndex(entry=>isUnsupportedExplicitHistoryItemHashVersion(entry.item_hash_version));if(unsupportedIndex>=0)throw new TypeError(`unsupported_item_hash_version:${String(entries[unsupportedIndex]?.item_hash_version)}:entry_${unsupportedIndex+1}`);let replay=cloneEmptyReplayDocument();const rewritten=[],details=[];let entriesRehashed=0,entriesPatchRepaired=0,convertedReplaceToAdd=0,skippedOps=0,semanticIndex;const explicitItemHashVersion=itemHashVersion!==1||entries.some(entry=>entry.item_hash_version!==void 0);for(let index=0;index<entries.length;index+=1){const entry=entries[index];assertHistoryEntryIntegrity(entry,index);const patchApplication=applyReanchorPatch(replay,entry),{next,patch:outPatch,repaired:patchRepaired,converted:entryConverted,skipped:entrySkipped}=patchApplication;convertedReplaceToAdd+=entryConverted,skippedOps+=entrySkipped,entriesPatchRepaired+=Number(patchRepaired);const hashMatch=matchReplayHashCandidates(replay,next,itemHashVersion,entry);semanticIndex===void 0||options.continuousHashSurface!==!0?semanticIndex=[hashMatch.pairIndex,hashMatch.beforeIndex,hashMatch.afterIndex,Math.min(semanticIndex??0,hashMatch.beforeHashes.length-1)].find(candidate=>candidate>=0):semanticIndex=Math.min(semanticIndex,hashMatch.beforeHashes.length-1);const beforeHash=hashMatch.beforeHashes[semanticIndex],afterHash=hashMatch.afterHashes[semanticIndex],rehashed=beforeHash!==entry.before_hash||afterHash!==entry.after_hash;rehashed&&(entriesRehashed+=1);let rewrittenEntry={...entry,patch:outPatch,before_hash:beforeHash,after_hash:afterHash};explicitItemHashVersion?rewrittenEntry.item_hash_version=itemHashVersion:delete rewrittenEntry.item_hash_version;const versionChanged=rewrittenEntry.item_hash_version!==entry.item_hash_version;(rehashed||patchRepaired||versionChanged)&&(rewrittenEntry=resealHistoryRewrite(entry,rewrittenEntry,{retainOriginalPatch:patchRepaired})),rewritten.push(rewrittenEntry),details.push({index:index+1,rehashed,patch_repaired:patchRepaired,converted_replace_to_add:entryConverted,skipped_ops:entrySkipped}),replay=next}return{entries:rewritten,finalDocument:replay,entriesRehashed,entriesPatchRepaired,convertedReplaceToAdd,skippedOps,details,itemHashVersion,explicitItemHashVersion}}function historyEntriesToRaw(entries){return entries.length===0?"":`${entries.map(entry=>JSON.stringify(entry)).join(`
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0c0cb8c7-4d7d-53f8-8ec2-d6dc98fc6dc5")}catch{}})();import jsonPatch from"fast-json-patch";import{historyDigest,resolveHistoryHashAlgorithm}from"./digest.js";import{findHistoryIdentityDiscontinuities}from"./identity.js";import{ITEM_METADATA_KEY_ORDER}from"../shared/constants.js";import{canonicalDocument}from"../item/item-format.js";import{toItemRecord}from"../item/item-record.js";import{orderObject,stableStringify}from"../shared/serialization.js";import{CURRENT_HISTORY_ITEM_HASH_VERSION,SUPPORTED_HISTORY_ITEM_HASH_VERSIONS,hashDocumentVerificationCandidates,resealHistoryRewrite,verifyHistoryRecordHash,verifyHistoryRewriteEvidence}from"./history.js";const EMPTY_REPLAY_DOCUMENT={metadata:{},body:""};function cloneEmptyReplayDocument(){return structuredClone(EMPTY_REPLAY_DOCUMENT)}function replayHash(document,version=CURRENT_HISTORY_ITEM_HASH_VERSION,algorithm){return replayHashVerificationCandidates(document,version,algorithm)[0]}function replayHashVerificationCandidates(document,version,algorithm){if(Object.keys(document.metadata).length===0||Array.isArray(document.metadata.tags))try{return hashDocumentVerificationCandidates(replayToItemDocument(document),version,algorithm)}catch{}const fallback=historyDigest(stableStringify({replay_fallback:!0,metadata:document.metadata,body:document.body}),algorithm);return version===2?[fallback,fallback]:[fallback]}function matchReplayHashCandidates(before,after,version,entry,memo){const algorithm=resolveHistoryHashAlgorithm(entry.hash_algorithm),memoKey=`${version}:${algorithm}`,beforeHashes=memo?.before.get(memoKey)??replayHashVerificationCandidates(before,version,algorithm),afterHashes=replayHashVerificationCandidates(after,version,algorithm);return memo?.after.set(memoKey,afterHashes),{beforeHashes,afterHashes,pairIndex:beforeHashes.findIndex((beforeHash,hashIndex)=>beforeHash===entry.before_hash&&afterHashes[hashIndex]===entry.after_hash),beforeIndex:beforeHashes.indexOf(entry.before_hash),afterIndex:afterHashes.indexOf(entry.after_hash)}}function replayToItemDocument(document){return{metadata:document.metadata,body:document.body}}function replayToCanonicalItemDocument(document,options={}){return canonicalDocument(replayToItemDocument(document),options)}function toReplayDocument(document){if(!document.metadata||Object.keys(document.metadata).length===0)return{metadata:{},body:document.body??""};const canonical=canonicalDocument(document);return{metadata:orderObject(toItemRecord(canonical.metadata),ITEM_METADATA_KEY_ORDER),body:canonical.body}}function normalizeReplayPatchPath(path){return path==="/front_matter"?"/metadata":path.startsWith("/front_matter/")?`/metadata/${path.slice(14)}`:path}function isHistoryPatchOp(value){return typeof value=="object"&&value!==null&&typeof value.op=="string"&&typeof value.path=="string"}function normalizeReplayPatchOps(patch){return Array.isArray(patch)?patch.filter(isHistoryPatchOp).map(operation=>({...operation,path:normalizeReplayPatchPath(operation.path),from:typeof operation.from=="string"?normalizeReplayPatchPath(operation.from):void 0})):[]}function isReplayDocumentShape(value){return typeof value=="object"&&value!==null&&"metadata"in value&&"body"in value&&typeof value.body=="string"&&typeof value.metadata=="object"&&value.metadata!==null}function tryApplyReplayPatch(current,patch){try{const normalizedPatch=normalizeReplayPatchOps(patch),applied=jsonPatch.applyPatch(structuredClone(current),normalizedPatch,!0,!0).newDocument;return isReplayDocumentShape(applied)?{ok:!0,document:{metadata:applied.metadata,body:applied.body}}:{ok:!1,error:new Error("history_replay_invalid_document_shape")}}catch(error){return{ok:!1,error}}}function supportedExplicitHistoryItemHashVersions(entries){return[...new Set(entries.map(entry=>entry.item_hash_version).filter(version=>version!==void 0&&SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version)))]}function isUnsupportedExplicitHistoryItemHashVersion(version){return version!==void 0&&!SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version)}function historyEntryHashCandidates(explicitVersion,authoritativeVersion){return explicitVersion!==void 0?[explicitVersion]:authoritativeVersion===void 0?[...SUPPORTED_HISTORY_ITEM_HASH_VERSIONS]:[authoritativeVersion]}function historyEntryIntegrityError(entry){const recordVerification=verifyHistoryRecordHash(entry);if(!recordVerification.ok)return recordVerification.error;const rewriteVerification=verifyHistoryRewriteEvidence(entry);return rewriteVerification.ok?void 0:rewriteVerification.error}function verifyHistoryEntryInput(entry,replay){const integrityError=historyEntryIntegrityError(entry);if(integrityError)return{ok:!1,error:integrityError};const applied=tryApplyReplayPatch(replay,entry.patch);return applied.ok?{ok:!0,document:applied.document}:{ok:!1,error:"patch_apply_failed"}}function assertHistoryEntryIntegrity(entry,index){const integrityError=historyEntryIntegrityError(entry);if(integrityError)throw new TypeError(`${integrityError}:entry_${index+1}`)}function matchReplayEpochCandidates(before,after,candidates,entry,memo){const matches=[];for(const version of candidates){const match=matchReplayHashCandidates(before,after,version,entry,memo);if(matches.push({version,match}),match.pairIndex>=0)break}return matches}function verifyHistoryChainWithVersion(entries){let replay=cloneEmptyReplayDocument(),beforeHashMemo=new Map,detectedVersion,authoritativeExplicitVersion;const errors=findHistoryIdentityDiscontinuities(entries).map(finding=>`verify_failed:duplicate_create:entry_${finding.repeated_create_index}:prior_${finding.prior_genesis_index}`);for(let index=0;index<entries.length;index+=1){const entry=entries[index],explicitVersion=entry.item_hash_version,unsupportedVersion=isUnsupportedExplicitHistoryItemHashVersion(explicitVersion);unsupportedVersion&&errors.push(`verify_failed:unsupported_item_hash_version:${String(explicitVersion)}:entry_${index+1}`);const input=verifyHistoryEntryInput(entry,replay);if(!input.ok)return{ok:!1,errors:[...errors,`verify_failed:${input.error}:entry_${index+1}`]};if(unsupportedVersion){replay=input.document,beforeHashMemo=new Map,detectedVersion=void 0,authoritativeExplicitVersion=void 0;continue}const candidates=historyEntryHashCandidates(explicitVersion,authoritativeExplicitVersion),memo={before:beforeHashMemo,after:new Map},candidateMatches=matchReplayEpochCandidates(replay,input.document,candidates,entry,memo),matchingVersion=candidateMatches.find(({match})=>match.pairIndex>=0);if(matchingVersion===void 0){const beforeMatches=candidateMatches.some(({match})=>match.beforeIndex>=0);return{ok:!1,errors:[...errors,`verify_failed:${beforeMatches?"after":"before"}_hash_mismatch:entry_${index+1}`]}}const version=matchingVersion.version;replay=input.document,beforeHashMemo=memo.after,detectedVersion=version,authoritativeExplicitVersion=explicitVersion??authoritativeExplicitVersion}return errors.length>0?{ok:!1,errors,...detectedVersion===void 0?{}:{item_hash_version:detectedVersion}}:{ok:!0,errors:[],...detectedVersion===void 0?{}:{item_hash_version:detectedVersion}}}function verifyHistoryChain(entries){const result=verifyHistoryChainWithVersion(entries);return{ok:result.ok,errors:result.errors}}function tryApplySingleOp(document,op){try{return{ok:!0,document:jsonPatch.applyPatch(structuredClone(document),[op],!0,!1).newDocument}}catch{return{ok:!1}}}function lenientApplyReplayPatch(current,patch){let working=structuredClone(current),convertedReplaceToAdd=0,skippedOps=0;for(const op of normalizeReplayPatchOps(patch)){const direct=tryApplySingleOp(working,op);if(direct.ok){working=direct.document;continue}if(op.op==="replace"){const asAdd=tryApplySingleOp(working,{...op,op:"add"});if(asAdd.ok){working=asAdd.document,convertedReplaceToAdd+=1;continue}}skippedOps+=1}const candidate=working;return{document:{metadata:typeof candidate.metadata=="object"&&candidate.metadata!==null?candidate.metadata:{},body:typeof candidate.body=="string"?candidate.body:current.body},convertedReplaceToAdd,skippedOps}}function resolveHistoryRepairItemHashVersion(entries){const explicitVersions=supportedExplicitHistoryItemHashVersions(entries);if(explicitVersions.length===1)return explicitVersions[0];const verified=verifyHistoryChainWithVersion(entries);return verified.ok&&verified.item_hash_version!==void 0?verified.item_hash_version:explicitVersions.length===0?1:CURRENT_HISTORY_ITEM_HASH_VERSION}function applyReanchorPatch(replay,entry,projectedPatch=entry.patch){const strict=tryApplyReplayPatch(replay,projectedPatch);if(strict.ok)return{next:strict.document,patch:projectedPatch,repaired:stableStringify(projectedPatch)!==stableStringify(entry.patch),converted:0,skipped:0};const lenient=lenientApplyReplayPatch(replay,projectedPatch);return{next:lenient.document,patch:jsonPatch.compare(replay,lenient.document),repaired:!0,converted:lenient.convertedReplaceToAdd,skipped:lenient.skippedOps}}function applyProjectedReanchorPatch(replay,entry,options){return applyReanchorPatch(replay,entry,options.projectPatch?.(entry,replay))}function reanchorHistoryEntries(entries,itemHashVersion=resolveHistoryRepairItemHashVersion(entries),options={}){const unsupportedIndex=entries.findIndex(entry=>isUnsupportedExplicitHistoryItemHashVersion(entry.item_hash_version));if(unsupportedIndex>=0)throw new TypeError(`unsupported_item_hash_version:${String(entries[unsupportedIndex]?.item_hash_version)}:entry_${unsupportedIndex+1}`);let replay=cloneEmptyReplayDocument();const rewritten=[],details=[];let entriesRehashed=0,entriesPatchRepaired=0,convertedReplaceToAdd=0,skippedOps=0,semanticIndex;const explicitItemHashVersion=itemHashVersion!==1||entries.some(entry=>entry.item_hash_version!==void 0);for(let index=0;index<entries.length;index+=1){const entry=entries[index];assertHistoryEntryIntegrity(entry,index);const patchApplication=applyProjectedReanchorPatch(replay,entry,options),{next,patch:outPatch,repaired:patchRepaired,converted:entryConverted,skipped:entrySkipped}=patchApplication;convertedReplaceToAdd+=entryConverted,skippedOps+=entrySkipped,entriesPatchRepaired+=Number(patchRepaired);const hashMatch=matchReplayHashCandidates(replay,next,itemHashVersion,entry);semanticIndex===void 0||options.continuousHashSurface!==!0?semanticIndex=[hashMatch.pairIndex,hashMatch.beforeIndex,hashMatch.afterIndex,Math.min(semanticIndex??0,hashMatch.beforeHashes.length-1)].find(candidate=>candidate>=0):semanticIndex=Math.min(semanticIndex,hashMatch.beforeHashes.length-1);const beforeHash=hashMatch.beforeHashes[semanticIndex],afterHash=hashMatch.afterHashes[semanticIndex],rehashed=beforeHash!==entry.before_hash||afterHash!==entry.after_hash;rehashed&&(entriesRehashed+=1);let rewrittenEntry={...entry,patch:outPatch,before_hash:beforeHash,after_hash:afterHash};explicitItemHashVersion?rewrittenEntry.item_hash_version=itemHashVersion:delete rewrittenEntry.item_hash_version;const versionChanged=rewrittenEntry.item_hash_version!==entry.item_hash_version;(rehashed||patchRepaired||versionChanged)&&(rewrittenEntry=resealHistoryRewrite(entry,rewrittenEntry,{retainOriginalPatch:patchRepaired})),rewritten.push(rewrittenEntry),details.push({index:index+1,rehashed,patch_repaired:patchRepaired,converted_replace_to_add:entryConverted,skipped_ops:entrySkipped}),replay=next}return{entries:rewritten,finalDocument:replay,entriesRehashed,entriesPatchRepaired,convertedReplaceToAdd,skippedOps,details,itemHashVersion,explicitItemHashVersion}}function historyEntriesToRaw(entries){return entries.length===0?"":`${entries.map(entry=>JSON.stringify(entry)).join(`
 `)}
 `}export{EMPTY_REPLAY_DOCUMENT,cloneEmptyReplayDocument,historyEntriesToRaw,lenientApplyReplayPatch,normalizeReplayPatchOps,normalizeReplayPatchPath,reanchorHistoryEntries,replayHash,replayHashVerificationCandidates,replayToCanonicalItemDocument,replayToItemDocument,resolveHistoryRepairItemHashVersion,toReplayDocument,tryApplyReplayPatch,verifyHistoryChain,verifyHistoryChainWithVersion};
 //# sourceMappingURL=replay.js.map

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

@@ -5,114 +5,114 @@ export declare const WORKSPACE_HISTORY_ID = "_workspace";
 export declare function getWorkspaceHistoryPath(pmRoot: string): string;
 /** One singleton-document mutation appended to workspace history. */
 export interface WorkspaceHistoryChange {
-    /** Tracker root containing the workspace history stream. */
-    pmRoot: string;
-    /** Repository-relative or tracker-relative document identity. */
-    documentPath: string;
-    /** Document value observed before the mutation. */
-    before: unknown;
-    /** Document value persisted by the mutation. */
-    after: unknown;
-    /** Stable operation name. */
-    op: string;
-    /** Optional operation key that makes retries return the original entry. */
-    idempotencyKey?: string;
-    /** Attributable mutation actor. */
-    author: string;
-    /** Optional human-readable rationale. */
-    message?: string;
-    /** Lock time-to-live in seconds. */
-    lockTtlSeconds: number;
-    /** Maximum lock wait in milliseconds. */
-    lockWaitMs: number;
+/** Tracker root containing the workspace history stream. */
+pmRoot: string;
+/** Repository-relative or tracker-relative document identity. */
+documentPath: string;
+/** Document value observed before the mutation. */
+before: unknown;
+/** Document value persisted by the mutation. */
+after: unknown;
+/** Stable operation name. */
+op: string;
+/** Optional operation key that makes retries return the original entry. */
+idempotencyKey?: string;
+/** Attributable mutation actor. */
+author: string;
+/** Optional human-readable rationale. */
+message?: string;
+/** Lock time-to-live in seconds. */
+lockTtlSeconds: number;
+/** Maximum lock wait in milliseconds. */
+lockWaitMs: number;
 }
 /** Options for one lock-scoped audited workspace singleton write. */
 export interface WorkspaceJsonWriteOptions {
-    /** Tracker root containing the singleton. */
-    pmRoot: string;
-    /** Absolute singleton path. */
-    filePath: string;
-    /** Fully serialized JSON value to persist. */
-    raw: string;
-    /** Stable operation name. */
-    op: string;
-    /** Optional operation identity that prevents replaying a completed write. */
-    idempotencyKey?: string;
-    /** Attributable mutation actor. */
-    author: string;
-    /** Lock time-to-live in seconds. */
-    lockTtlSeconds: number;
-    /** Maximum lock wait in milliseconds. */
-    lockWaitMs: number;
-    /** Optional human-readable rationale. */
-    message?: string;
-    /** Whether creating a previously absent singleton produces a history entry. */
-    recordCreation?: boolean;
+/** Tracker root containing the singleton. */
+pmRoot: string;
+/** Absolute singleton path. */
+filePath: string;
+/** Fully serialized JSON value to persist. */
+raw: string;
+/** Stable operation name. */
+op: string;
+/** Optional operation identity that prevents replaying a completed write. */
+idempotencyKey?: string;
+/** Attributable mutation actor. */
+author: string;
+/** Lock time-to-live in seconds. */
+lockTtlSeconds: number;
+/** Maximum lock wait in milliseconds. */
+lockWaitMs: number;
+/** Optional human-readable rationale. */
+message?: string;
+/** Whether creating a previously absent singleton produces a history entry. */
+recordCreation?: boolean;
 }
 /** Result of deriving one audited singleton snapshot while its lock is held. */
 export interface WorkspaceJsonMutation<Result> {
-    /** Fully serialized JSON value to persist. */
-    raw: string;
-    /** Caller-defined result derived from the same locked before-state. */
-    result: Result;
+/** Fully serialized JSON value to persist. */
+raw: string;
+/** Caller-defined result derived from the same locked before-state. */
+result: Result;
 }
 /** Options for deriving and writing one audited singleton under one lock. */
 export interface WorkspaceJsonMutationOptions<Result> extends Omit<WorkspaceJsonWriteOptions, "raw"> {
-    /** Derive the next snapshot and receipt from the locked serialized state. */
-    mutate: (beforeRaw: string | null) => WorkspaceJsonMutation<Result> | Promise<WorkspaceJsonMutation<Result>>;
-    /** Preview the locked mutation without writing the singleton or its history. */
-    dryRun?: boolean;
+/** Derive the next snapshot and receipt from the locked serialized state. */
+mutate: (beforeRaw: string | null) => WorkspaceJsonMutation<Result> | Promise<WorkspaceJsonMutation<Result>>;
+/** Preview the locked mutation without writing the singleton or its history. */
+dryRun?: boolean;
 }
 /** Options for one append-only workspace audit event that leaves state unchanged. */
 export interface WorkspaceAuditEventOptions {
-    /** Tracker root containing the workspace history stream. */
-    pmRoot: string;
-    /** Stable operation name. */
-    op: string;
-    /** Attributable reviewer or operator. */
-    author: string;
-    /** Structured, non-secret audit metadata. */
-    context: Record<string, unknown>;
-    /** Human-readable rationale. */
-    message: string;
-    /** Lock time-to-live in seconds. */
-    lockTtlSeconds: number;
-    /** Maximum lock wait in milliseconds. */
-    lockWaitMs: number;
+/** Tracker root containing the workspace history stream. */
+pmRoot: string;
+/** Stable operation name. */
+op: string;
+/** Attributable reviewer or operator. */
+author: string;
+/** Structured, non-secret audit metadata. */
+context: Record<string, unknown>;
+/** Human-readable rationale. */
+message: string;
+/** Lock time-to-live in seconds. */
+lockTtlSeconds: number;
+/** Maximum lock wait in milliseconds. */
+lockWaitMs: number;
 }
 /** Agreement between the replayed workspace stream and governed singleton files. */
 export interface WorkspaceHistoryStateAgreement {
-    /** Whether every governed singleton is readable and equals its replayed value. */
-    ok: boolean;
-    /** Number of singleton documents represented by the latest replayed state. */
-    document_count: number;
-    /** Governed documents whose on-disk JSON equals the replayed value. */
-    matching_documents: string[];
-    /** Governed documents whose on-disk JSON differs from the replayed value. */
-    mismatched_documents: string[];
-    /** Governed documents absent from disk. */
-    missing_documents: string[];
-    /** Governed documents that cannot be read as safe workspace-local JSON. */
-    unreadable_documents: string[];
+/** Whether every governed singleton is readable and equals its replayed value. */
+ok: boolean;
+/** Number of singleton documents represented by the latest replayed state. */
+document_count: number;
+/** Governed documents whose on-disk JSON equals the replayed value. */
+matching_documents: string[];
+/** Governed documents whose on-disk JSON differs from the replayed value. */
+mismatched_documents: string[];
+/** Governed documents absent from disk. */
+missing_documents: string[];
+/** Governed documents that cannot be read as safe workspace-local JSON. */
+unreadable_documents: string[];
 }
 /** Authorized append-only reconciliation of one out-of-band singleton state. */
 export interface WorkspaceJsonReconciliationOptions extends Omit<WorkspaceJsonWriteOptions, "raw" | "recordCreation"> {
-    /** Closed Decision item authorizing acceptance of the on-disk state. */
-    authorizationDecision: string;
+/** Closed Decision item authorizing acceptance of the on-disk state. */
+authorizationDecision: string;
 }
 /** Restore one governed singleton from a recorded workspace history version. */
 export interface WorkspaceJsonRestoreOptions extends Omit<WorkspaceJsonWriteOptions, "raw" | "recordCreation"> {
-    /** One-based workspace history version whose document value is restored. */
-    targetVersion: number;
+/** One-based workspace history version whose document value is restored. */
+targetVersion: number;
 }
 /** Receipt returned after a singleton is restored from workspace history. */
 export interface WorkspaceJsonRestoreResult {
-    /** Tracker-relative singleton identity. */
-    document_path: string;
-    /** One-based workspace history version used as the restore source. */
-    restored_from_version: number;
-    /** Whether the on-disk singleton and latest history state changed. */
-    changed: boolean;
+/** Tracker-relative singleton identity. */
+document_path: string;
+/** One-based workspace history version used as the restore source. */
+restored_from_version: number;
+/** Whether the on-disk singleton and latest history state changed. */
+changed: boolean;
 }
 /**
  * Compare every singleton represented by the verified workspace stream with
@@ -127,34 +127,34 @@ export declare function inspectWorkspaceHistoryState(pmRoot: string): Promise<Wo
  * derived, so concurrent writers cannot fork the chain.
  */
 export declare function appendWorkspaceHistoryChange(change: WorkspaceHistoryChange): Promise<{
-    entry: HistoryEntry;
-    historyPath: string;
+entry: HistoryEntry;
+historyPath: string;
 }>;
 /** Append a verified no-state-change event to the workspace audit stream. */
 export declare function appendWorkspaceAuditEvent(options: WorkspaceAuditEventOptions): Promise<{
-    entry: HistoryEntry;
-    historyPath: string;
+entry: HistoryEntry;
+historyPath: string;
 }>;
 /**
  * Derive and persist an audited singleton mutation from one lock-protected
  * before-state, preventing read-modify-write callers from losing updates.
  */
 export declare function mutateWorkspaceJsonWithHistory<Result>(params: WorkspaceJsonMutationOptions<Result> & {
-    idempotencyKey?: undefined;
+idempotencyKey?: undefined;
 }): Promise<{
-    changed: boolean;
-    result: Result;
-    replayed?: false;
+changed: boolean;
+result: Result;
+replayed?: false;
 }>;
 /** Mutate an audited singleton while reporting a completed operation replay. */
 export declare function mutateWorkspaceJsonWithHistory<Result>(params: WorkspaceJsonMutationOptions<Result>): Promise<{
-    changed: boolean;
-    result: Result;
-    replayed?: false;
+changed: boolean;
+result: Result;
+replayed?: false;
 } | {
-    changed: false;
-    result: undefined;
-    replayed: true;
+changed: false;
+result: undefined;
+replayed: true;
 }>;
 /**
  * Atomically persist one caller-serialized JSON singleton and its audit entry
@@ -169,9 +169,9 @@ export declare function writeWorkspaceJsonWithHistory(params: WorkspaceJsonWrite
  * structured context.
  */
 export declare function reconcileWorkspaceJsonHistory(options: WorkspaceJsonReconciliationOptions): Promise<{
-    changed: boolean;
-    entry?: HistoryEntry;
-    historyPath: string;
+changed: boolean;
+entry?: HistoryEntry;
+historyPath: string;
 }>;
 /**
  * Restore one governed JSON singleton to the value recorded at a one-based

package/dist/core/io/bulk-ids-input.d.ts

@@ -4,10 +4,10 @@ export type BulkIdsFileReader = (path: string) => Promise<string>;
 export type BulkIdsStdinReader = (optionName: string) => Promise<string>;
 /** Dependencies used to resolve CLI-only external ID sources. */
 export interface BulkIdsInputReaders {
-    /** Read a UTF-8 `@path` payload. */
-    readFile?: BulkIdsFileReader;
-    /** Read the complete stdin payload for `-`. */
-    readStdin?: BulkIdsStdinReader;
+/** Read a UTF-8 `@path` payload. */
+readFile?: BulkIdsFileReader;
+/** Read the complete stdin payload for `-`. */
+readStdin?: BulkIdsStdinReader;
 }
 /** Transport-native bulk ID shapes accepted by SDK and MCP adapters. */
 export type BulkIdsValue = string | number | readonly (string | number)[] | undefined;

package/dist/core/item/actionability.d.ts

@@ -13,20 +13,20 @@ export declare function indexBlockedByIds(corpus: readonly ItemMetadata[]): Map<
 export declare function collectBlockedByIdsFromCorpus(item: ItemMetadata, corpus: readonly ItemMetadata[]): string[];
 /** A blocker reference resolved against the corpus and annotated with its state. */
 export interface ResolvedBlocker {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports title for this contract. */
-    title: string | null;
-    /** Lifecycle state reported for status. */
-    status: ItemStatus | null;
-    /** True when the blocker no longer gates work because the referenced item is terminal. */
-    resolved: boolean;
-    /** Whether this blocker is a cross-system locator requiring an external resolver. */
-    external?: boolean;
-    /** Last holder mutation timestamp, used as a conservative external-block staleness marker. */
-    blocked_since?: string;
-    /** Resolver identity when an integration resolved this external blocker; null means unverifiable. */
-    resolver?: string | null;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports title for this contract. */
+title: string | null;
+/** Lifecycle state reported for status. */
+status: ItemStatus | null;
+/** True when the blocker no longer gates work because the referenced item is terminal. */
+resolved: boolean;
+/** Whether this blocker is a cross-system locator requiring an external resolver. */
+external?: boolean;
+/** Last holder mutation timestamp, used as a conservative external-block staleness marker. */
+blocked_since?: string;
+/** Resolver identity when an integration resolved this external blocker; null means unverifiable. */
+resolver?: string | null;
 }
 /** Resolves an item's blockers against a corpus index with reverse `blocks` support. */
 export declare function resolveItemBlockers(item: Pick<ItemMetadata, "blocked_by" | "dependencies"> & Partial<Pick<ItemMetadata, "id" | "updated_at">>, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry): ResolvedBlocker[];
@@ -44,38 +44,38 @@ export declare function resolveItemBlockers(item: Pick<ItemMetadata, "blocked_by
 export declare function collectDependencyBlockedIds(corpus: ItemMetadata[], statusRegistry: RuntimeStatusRegistry): Set<string>;
 /** A classified actionable item plus the context an agent needs to act on it. */
 export interface ActionableEntry {
-    /** Value that configures or reports item for this contract. */
-    item: ItemMetadata;
-    /** Blockers that still gate the item (resolved blockers are filtered out). */
-    open_blockers: ResolvedBlocker[];
-    /** Ids of non-terminal items whose `blocked_by` points at this item. */
-    unblocks: string[];
+/** Value that configures or reports item for this contract. */
+item: ItemMetadata;
+/** Blockers that still gate the item (resolved blockers are filtered out). */
+open_blockers: ResolvedBlocker[];
+/** Ids of non-terminal items whose `blocked_by` points at this item. */
+unblocks: string[];
 }
 /** Result of partitioning a candidate set into ready vs blocked leaf work. */
 export interface ActionabilityReport {
-    /** Active leaves with no open blockers — ready to work on now. */
-    ready: ActionableEntry[];
-    /** Active leaves with at least one open blocker — waiting to become ready. */
-    blocked: ActionableEntry[];
-    /** Active containers with unresolved descendants, including their blocker evidence. */
-    containers: ActionableEntry[];
-    /** Unblocked leaf work that requires a human decision. */
-    decisions: ActionableEntry[];
-    /** Unblocked leaf outcome gates held out of automatic dispatch. */
-    gates: ActionableEntry[];
-    /** Active candidates considered before the leaf/blocker split. */
-    active_count: number;
-    /** Active candidates skipped because they still have open descendants. */
-    container_count: number;
+/** Active leaves with no open blockers — ready to work on now. */
+ready: ActionableEntry[];
+/** Active leaves with at least one open blocker — waiting to become ready. */
+blocked: ActionableEntry[];
+/** Active containers with unresolved descendants, including their blocker evidence. */
+containers: ActionableEntry[];
+/** Unblocked leaf work that requires a human decision. */
+decisions: ActionableEntry[];
+/** Unblocked leaf outcome gates held out of automatic dispatch. */
+gates: ActionableEntry[];
+/** Active candidates considered before the leaf/blocker split. */
+active_count: number;
+/** Active candidates skipped because they still have open descendants. */
+container_count: number;
 }
 /** Explicit dispatch opt-ins; dependency and lifecycle blocking always remain enforced. */
 export interface ActionabilitySelectionOptions {
-    /** Include human decision work in the executable selection. */
-    includeDecisions?: boolean;
-    /** Include outcome gates in the executable selection. */
-    includeGates?: boolean;
-    /** Include containers whose descendants are still unfinished. */
-    includeContainers?: boolean;
+/** Include human decision work in the executable selection. */
+includeDecisions?: boolean;
+/** Include outcome gates in the executable selection. */
+includeGates?: boolean;
+/** Include containers whose descendants are still unfinished. */
+includeContainers?: boolean;
 }
 /** Select dispatch candidates from a classified report while retaining held-out worklists. Ownership and ranking remain caller responsibilities. */
 export declare function selectActionableEntries(report: ActionabilityReport, statusRegistry: RuntimeStatusRegistry, options?: ActionabilitySelectionOptions, typeRegistry?: ItemTypeRegistry): Pick<ActionabilityReport, "ready" | "decisions" | "gates">;