@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/history/history-compact-bulk.js

@@ -1,105 +1,2 @@
-/**
- * @module core/history/history-compact-bulk
- *
- * Pure selection logic for bulk history-stream compaction. Given a set of
- * history-stream candidates (id, entry count, and lifecycle bucket of the
- * owning item) plus the requested selection criteria, this module decides which
- * streams should be compacted and which are skipped (and why).
- *
- * The module performs no filesystem access and imports no heavy runtime
- * dependencies — the command layer reads streams and item statuses, hands the
- * resolved candidates here, then executes per-item compaction on the selection
- * this module returns. Keeping selection pure makes the matrix of scope /
- * threshold / explicit-id rules trivially testable without touching disk.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7e0f84f6-9528-55c5-8976-6f85cd920486")}catch(e){}}();
-function selectIdsMode(ids, byId, minEntries) {
-    const seen = new Set();
-    const rows = [];
-    for (const rawId of ids) {
-        const id = rawId.trim();
-        if (id.length === 0 || seen.has(id)) {
-            continue;
-        }
-        seen.add(id);
-        const candidate = byId.get(id);
-        if (candidate === undefined) {
-            rows.push({ id, entries: 0, selected: false, skip_reason: "no_stream" });
-            continue;
-        }
-        if (candidate.entries <= minEntries) {
-            rows.push({
-                id,
-                entries: candidate.entries,
-                selected: false,
-                skip_reason: "already_compact",
-            });
-            continue;
-        }
-        rows.push({
-            id,
-            entries: candidate.entries,
-            selected: true,
-            skip_reason: null,
-        });
-    }
-    return rows;
-}
-function selectScanMode(candidates, criteria) {
-    const ordered = [...candidates].sort((a, b) => b.entries - a.entries || a.id.localeCompare(b.id));
-    const rows = [];
-    for (const candidate of ordered) {
-        if (criteria.scope === "closed" && candidate.bucket !== "closed") {
-            rows.push({
-                id: candidate.id,
-                entries: candidate.entries,
-                selected: false,
-                skip_reason: "scope_mismatch",
-            });
-            continue;
-        }
-        if (candidate.entries <= criteria.minEntries) {
-            rows.push({
-                id: candidate.id,
-                entries: candidate.entries,
-                selected: false,
-                skip_reason: "already_compact",
-            });
-            continue;
-        }
-        if (criteria.allOver !== undefined &&
-            candidate.entries <= criteria.allOver) {
-            rows.push({
-                id: candidate.id,
-                entries: candidate.entries,
-                selected: false,
-                skip_reason: "below_threshold",
-            });
-            continue;
-        }
-        rows.push({
-            id: candidate.id,
-            entries: candidate.entries,
-            selected: true,
-            skip_reason: null,
-        });
-    }
-    return rows;
-}
-/**
- * Decide which history streams to compact.
- *
- * Runs in "ids" mode when `criteria.ids` is non-empty (exact, ordered set,
- * honouring only the `minEntries` floor) and "scan" mode otherwise (every
- * candidate, filtered by scope and entry thresholds, ordered deepest-first).
- */
-export function selectHistoryCompactBulkTargets(candidates, criteria) {
-    if (criteria.ids !== undefined && criteria.ids.length > 0) {
-        const byId = new Map(candidates.map((candidate) => [candidate.id, candidate]));
-        return selectIdsMode(criteria.ids, byId, criteria.minEntries);
-    }
-    return selectScanMode(candidates, criteria);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d51da34a-9f37-5441-91f0-15a16b601709")}catch(e2){}})();function selectIdsMode(ids,byId,minEntries){const seen=new Set;const rows=[];for(const rawId of ids){const id=rawId.trim();if(id.length===0||seen.has(id)){continue}seen.add(id);const candidate=byId.get(id);if(candidate===void 0){rows.push({id,entries:0,selected:false,skip_reason:"no_stream"});continue}if(candidate.entries<=minEntries){rows.push({id,entries:candidate.entries,selected:false,skip_reason:"already_compact"});continue}rows.push({id,entries:candidate.entries,selected:true,skip_reason:null})}return rows}function selectScanMode(candidates,criteria){const ordered=[...candidates].sort((a,b)=>b.entries-a.entries||a.id.localeCompare(b.id));const rows=[];for(const candidate of ordered){if(criteria.scope==="closed"&&candidate.bucket!=="closed"){rows.push({id:candidate.id,entries:candidate.entries,selected:false,skip_reason:"scope_mismatch"});continue}if(candidate.entries<=criteria.minEntries){rows.push({id:candidate.id,entries:candidate.entries,selected:false,skip_reason:"already_compact"});continue}if(criteria.allOver!==void 0&&candidate.entries<=criteria.allOver){rows.push({id:candidate.id,entries:candidate.entries,selected:false,skip_reason:"below_threshold"});continue}rows.push({id:candidate.id,entries:candidate.entries,selected:true,skip_reason:null})}return rows}function selectHistoryCompactBulkTargets(candidates,criteria){if(criteria.ids!==void 0&&criteria.ids.length>0){const byId=new Map(candidates.map(candidate=>[candidate.id,candidate]));return selectIdsMode(criteria.ids,byId,criteria.minEntries)}return selectScanMode(candidates,criteria)}export{selectHistoryCompactBulkTargets};
 //# sourceMappingURL=history-compact-bulk.js.map
-//# debugId=7e0f84f6-9528-55c5-8976-6f85cd920486

package/dist/core/history/history-diff.js

@@ -1,159 +1,2 @@
-/**
- * @module core/history/history-diff
- *
- * Implements append-only history and replay behavior for History Diff.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="19ff592c-0746-54e8-a304-2006f4845da2")}catch(e){}}();
-import { cloneEmptyReplayDocument, tryApplyReplayPatch, } from "./replay.js";
-// ---------------------------------------------------------------------------
-// JSON-Pointer helpers (ported from src/cli/commands/history.ts so the
-// orchestrator can replace the private copy there with an import from here).
-// ---------------------------------------------------------------------------
-function decodeJsonPointerSegment(segment) {
-    return segment.replaceAll("~1", "/").replaceAll("~0", "~");
-}
-/**
- * Map a JSON-Patch path string to a human-readable changed-field name.
- *
- * Rules (in priority order):
- *  - "/body" or "/body/…"                      → "body"
- *  - "/metadata/…" or "/front_matter/…"
- *      with a first segment                     → that decoded segment (e.g. "status")
- *      without a first segment (bare prefix)    → "metadata"
- *  - "/" (root pointer, empty segment after strip) → "root"
- *  - anything else                               → decoded first path segment
- */
-export function patchPathToChangedField(path) {
-    if (path === "/body" || path.startsWith("/body/"))
-        return "body";
-    if (path === "/metadata" ||
-        path.startsWith("/metadata/") ||
-        path === "/front_matter" ||
-        path.startsWith("/front_matter/")) {
-        const segment = path
-            .replace(/^\/(?:metadata|front_matter)\/?/, "")
-            .split("/")[0];
-        if (!segment)
-            return "metadata";
-        return decodeJsonPointerSegment(segment);
-    }
-    const segment = path.replace(/^\//, "").split("/")[0];
-    return segment ? decodeJsonPointerSegment(segment) : "root";
-}
-// ---------------------------------------------------------------------------
-// Field-value reader
-// ---------------------------------------------------------------------------
-/**
- * Extract the before/after value for a logical field from a replay document.
- *
- * - "body"     → doc.body
- * - "metadata" → doc.metadata (the whole object, for a bare /metadata replace)
- * - "root"     → the whole document (for a bare "/" patch op)
- * - other      → doc.metadata[field] (may be undefined when the field was absent)
- */
-function readFieldValue(doc, field) {
-    if (field === "body")
-        return doc.body;
-    if (field === "metadata")
-        return doc.metadata;
-    if (field === "root")
-        return doc;
-    return doc.metadata[field];
-}
-// ---------------------------------------------------------------------------
-// Main export
-// ---------------------------------------------------------------------------
-/**
- * Replay a full history entry stream and produce enriched diff entries with
- * per-field before/after values.
- *
- * @param fullEntries   The complete ordered history chain to replay.
- * @param options.windowStartIndex  0-based index into fullEntries at which the
- *   DISPLAYED window begins. Entries before this index are still replayed (so
- *   state is accurate) but are not emitted. Defaults to 0.
- * @param options.field  When supplied, only entries that changed this field are
- *   emitted, and each emitted entry's `changes` and `changed_fields` are
- *   restricted to that single field.
- */
-export function computeHistoryDiff(fullEntries, options) {
-    const windowStartIndex = options?.windowStartIndex ?? 0;
-    const fieldFilter = options?.field;
-    if (fullEntries.length === 0 || windowStartIndex >= fullEntries.length) {
-        return [];
-    }
-    let current = cloneEmptyReplayDocument();
-    const result = [];
-    for (let p = 0; p < fullEntries.length; p += 1) {
-        const entry = fullEntries[p];
-        // Capture before state.
-        const beforeDoc = current;
-        // Attempt to apply patch.
-        const applied = tryApplyReplayPatch(current, entry.patch);
-        let afterDoc;
-        if (applied.ok) {
-            afterDoc = applied.document;
-            current = afterDoc;
-        }
-        else {
-            // Patch failed — use before state as after (cannot trust partial result).
-            // Do NOT advance current; keep prior replay state.
-            afterDoc = beforeDoc;
-        }
-        // Collect changed field names from patch paths (and from: paths for move/copy).
-        const changedFieldSet = new Set();
-        for (const patchOp of entry.patch) {
-            changedFieldSet.add(patchPathToChangedField(patchOp.path));
-            if (patchOp.from !== undefined) {
-                changedFieldSet.add(patchPathToChangedField(patchOp.from));
-            }
-        }
-        const sortedFields = [...changedFieldSet].sort((a, b) => a.localeCompare(b));
-        // Only emit entries in the display window.
-        if (p >= windowStartIndex) {
-            // Apply field filter: skip this entry entirely if it doesn't touch the
-            // requested field; otherwise narrow down to only that field.
-            if (fieldFilter !== undefined) {
-                if (!changedFieldSet.has(fieldFilter)) {
-                    // This entry does not touch the requested field — skip it.
-                    continue;
-                }
-                // Emit only the filtered field.
-                const change = {
-                    field: fieldFilter,
-                    before: readFieldValue(beforeDoc, fieldFilter),
-                    after: readFieldValue(afterDoc, fieldFilter),
-                };
-                result.push({
-                    index: p + 1,
-                    ts: entry.ts,
-                    op: entry.op,
-                    author: entry.author,
-                    patch_ops: entry.patch.length,
-                    changed_fields: [fieldFilter],
-                    changes: [change],
-                });
-            }
-            else {
-                // Emit all changed fields.
-                const changes = sortedFields.map((field) => ({
-                    field,
-                    before: readFieldValue(beforeDoc, field),
-                    after: readFieldValue(afterDoc, field),
-                }));
-                result.push({
-                    index: p + 1,
-                    ts: entry.ts,
-                    op: entry.op,
-                    author: entry.author,
-                    patch_ops: entry.patch.length,
-                    changed_fields: sortedFields,
-                    changes,
-                });
-            }
-        }
-    }
-    return result;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b0ab458f-0faf-5653-9862-43cbe9cf8f1f")}catch(e2){}})();import{cloneEmptyReplayDocument,tryApplyReplayPatch}from"./replay.js";function decodeJsonPointerSegment(segment){return segment.replaceAll("~1","/").replaceAll("~0","~")}function patchPathToChangedField(path){if(path==="/body"||path.startsWith("/body/"))return"body";if(path==="/metadata"||path.startsWith("/metadata/")||path==="/front_matter"||path.startsWith("/front_matter/")){const segment2=path.replace(/^\/(?:metadata|front_matter)\/?/,"").split("/")[0];if(!segment2)return"metadata";return decodeJsonPointerSegment(segment2)}const segment=path.replace(/^\//,"").split("/")[0];return segment?decodeJsonPointerSegment(segment):"root"}function readFieldValue(doc,field){if(field==="body")return doc.body;if(field==="metadata")return doc.metadata;if(field==="root")return doc;return doc.metadata[field]}function computeHistoryDiff(fullEntries,options){const windowStartIndex=options?.windowStartIndex??0;const fieldFilter=options?.field;if(fullEntries.length===0||windowStartIndex>=fullEntries.length){return[]}let current=cloneEmptyReplayDocument();const result=[];for(let p=0;p<fullEntries.length;p+=1){const entry=fullEntries[p];const beforeDoc=current;const applied=tryApplyReplayPatch(current,entry.patch);let afterDoc;if(applied.ok){afterDoc=applied.document;current=afterDoc}else{afterDoc=beforeDoc}const changedFieldSet=new Set;for(const patchOp of entry.patch){changedFieldSet.add(patchPathToChangedField(patchOp.path));if(patchOp.from!==void 0){changedFieldSet.add(patchPathToChangedField(patchOp.from))}}const sortedFields=[...changedFieldSet].sort((a,b)=>a.localeCompare(b));if(p>=windowStartIndex){if(fieldFilter!==void 0){if(!changedFieldSet.has(fieldFilter)){continue}const change={field:fieldFilter,before:readFieldValue(beforeDoc,fieldFilter),after:readFieldValue(afterDoc,fieldFilter)};result.push({index:p+1,ts:entry.ts,op:entry.op,author:entry.author,patch_ops:entry.patch.length,changed_fields:[fieldFilter],changes:[change]})}else{const changes=sortedFields.map(field=>({field,before:readFieldValue(beforeDoc,field),after:readFieldValue(afterDoc,field)}));result.push({index:p+1,ts:entry.ts,op:entry.op,author:entry.author,patch_ops:entry.patch.length,changed_fields:sortedFields,changes})}}}return result}export{computeHistoryDiff,patchPathToChangedField};
 //# sourceMappingURL=history-diff.js.map
-//# debugId=19ff592c-0746-54e8-a304-2006f4845da2

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

@@ -1,7 +1,10 @@
 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>>;
+type LoadedItem = Awaited<ReturnType<typeof readLocatedItem>> & {
+    /** 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 {
@@ -41,6 +44,8 @@ export interface VerifyHistoryRewriteDriftParams {
     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 {

package/dist/core/history/history-rewrite.js

@@ -1,108 +1,2 @@
-/**
- * @module core/history/history-rewrite
- *
- * Implements append-only history and replay behavior for History Rewrite.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a2ec9f1a-aae2-59d5-8c9a-7acd8bf5a7a2")}catch(e){}}();
-import fs from "node:fs/promises";
-import { readFileIfExists, writeFileAtomic } from "../fs/fs-utils.js";
-import { acquireLock } from "../lock/lock.js";
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-import { locateItem, readLocatedItem } from "../store/item-store.js";
-import { resolveGovernanceKnobs } from "../store/settings.js";
-import { invalidateHistoryDriftCacheForPath } from "./drift-cache.js";
-/** 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 function checkHistoryRewriteOwnership(params) {
-    if (!params.itemDocument)
-        return [];
-    const assigned = params.itemDocument.metadata?.assignee?.trim();
-    if (!assigned || assigned === params.author || params.force)
-        return [];
-    const governance = resolveGovernanceKnobs(params.settings);
-    if (governance.ownership_enforcement === "strict") {
-        throw new PmCliError(`Item ${params.subjectId} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
-    }
-    if (governance.ownership_enforcement === "warn") {
-        return [
-            `ownership_warning:assignee_conflict:${params.subjectId}:${assigned}`,
-        ];
-    }
-    return [];
-}
-/** 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 async function verifyHistoryRewriteNoDrift(params) {
-    const historyRawUnderLock = await readFileIfExists(params.subject.historyPath);
-    if (historyRawUnderLock !== params.historyRawBeforeLock) {
-        throw new PmCliError(`History for ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`, EXIT_CODE.CONFLICT);
-    }
-    const locatedUnderLock = await locateItem(params.pmRoot, params.subject.id, params.settings.id_prefix, params.settings.item_format, params.typeRegistry.type_to_folder);
-    const loadedItemUnderLock = locatedUnderLock
-        ? await readLocatedItem(locatedUnderLock, {
-            schema: params.settings.schema,
-        })
-        : null;
-    if ((loadedItemUnderLock?.raw ?? null) !==
-        (params.currentItemRawBeforeLock ?? null)) {
-        throw new PmCliError(`Item ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`, EXIT_CODE.CONFLICT);
-    }
-    return { historyRawUnderLock, locatedUnderLock, loadedItemUnderLock };
-}
-/** Writes the rewritten history stream and restores the under-lock snapshot on failure. */
-export async function writeHistoryRawWithRollback(params) {
-    const writeHistoryRaw = params.writeHistoryRaw ?? writeFileAtomic;
-    try {
-        await writeHistoryRaw(params.historyPath, params.nextHistoryRaw);
-        await invalidateHistoryDriftCacheForPath(params.historyPath);
-    }
-    catch (error) {
-        try {
-            if (params.historyRawUnderLock === null) {
-                await fs.rm(params.historyPath, { force: true });
-            }
-            else {
-                await writeHistoryRaw(params.historyPath, params.historyRawUnderLock);
-            }
-            await invalidateHistoryDriftCacheForPath(params.historyPath);
-        }
-        catch (rollbackError) {
-            throw new AggregateError([error, rollbackError], `History rewrite failed and rollback also failed: ${String(error)}`);
-        }
-        throw error;
-    }
-}
-/** 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 async function executeHistoryRewrite(params) {
-    const warnings = [
-        ...checkHistoryRewriteOwnership({
-            itemDocument: params.itemDocument,
-            subjectId: params.subject.id,
-            author: params.author,
-            force: params.force,
-            settings: params.settings,
-        }),
-    ];
-    const releaseLock = await acquireLock(params.pmRoot, params.subject.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force), params.settings.governance.force_required_for_stale_lock, params.settings.locks.wait_ms);
-    try {
-        const verified = await verifyHistoryRewriteNoDrift({
-            pmRoot: params.pmRoot,
-            subject: params.subject,
-            settings: params.settings,
-            typeRegistry: params.typeRegistry,
-            historyRawBeforeLock: params.historyRawBeforeLock,
-            currentItemRawBeforeLock: params.currentItemRawBeforeLock,
-            operation: params.operation,
-        });
-        await params.applyRewrite(verified);
-        if (params.applyPostRewrite) {
-            warnings.push(...(await params.applyPostRewrite(verified)));
-        }
-        return warnings;
-    }
-    finally {
-        await releaseLock();
-    }
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cd8981b8-f6f7-5911-9951-799e68cecb9b")}catch(e2){}})();import fs from"node:fs/promises";import{readFileIfExists,writeFileAtomic}from"../fs/fs-utils.js";import{acquireLock}from"../lock/lock.js";import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{locateItem,readLocatedItem}from"../store/item-store.js";import{resolveGovernanceKnobs}from"../store/settings.js";import{invalidateHistoryDriftCacheForPath}from"./drift-cache.js";function checkHistoryRewriteOwnership(params){if(!params.itemDocument)return[];const assigned=params.itemDocument.metadata?.assignee?.trim();if(!assigned||assigned===params.author||params.force)return[];const governance=resolveGovernanceKnobs(params.settings);if(governance.ownership_enforcement==="strict"){throw new PmCliError(`Item ${params.subjectId} is assigned to ${assigned}. Use --force to override.`,EXIT_CODE.CONFLICT)}if(governance.ownership_enforcement==="warn"){return[`ownership_warning:assignee_conflict:${params.subjectId}:${assigned}`]}return[]}async function verifyHistoryRewriteNoDrift(params){const historyRawUnderLock=await readFileIfExists(params.subject.historyPath);if(historyRawUnderLock!==params.historyRawBeforeLock){throw new PmCliError(`History for ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,EXIT_CODE.CONFLICT)}const locatedUnderLock=await locateItem(params.pmRoot,params.subject.id,params.settings.id_prefix,params.settings.item_format,params.typeRegistry.type_to_folder);const loadedItemUnderLock=locatedUnderLock?params.readItem?await params.readItem(locatedUnderLock):await readLocatedItem(locatedUnderLock,{schema:params.settings.schema}):null;if((loadedItemUnderLock?.raw??null)!==(params.currentItemRawBeforeLock??null)){throw new PmCliError(`Item ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,EXIT_CODE.CONFLICT)}return{historyRawUnderLock,locatedUnderLock,loadedItemUnderLock}}async function writeHistoryRawWithRollback(params){const writeHistoryRaw=params.writeHistoryRaw??writeFileAtomic;try{await writeHistoryRaw(params.historyPath,params.nextHistoryRaw);await invalidateHistoryDriftCacheForPath(params.historyPath)}catch(error){try{if(params.historyRawUnderLock===null){await fs.rm(params.historyPath,{force:true})}else{await writeHistoryRaw(params.historyPath,params.historyRawUnderLock)}await invalidateHistoryDriftCacheForPath(params.historyPath)}catch(rollbackError){throw new AggregateError([error,rollbackError],`History rewrite failed and rollback also failed: ${String(error)}`)}throw error}}async function executeHistoryRewrite(params){const warnings=[...checkHistoryRewriteOwnership({itemDocument:params.itemDocument,subjectId:params.subject.id,author:params.author,force:params.force,settings:params.settings})];const releaseLock=await acquireLock(params.pmRoot,params.subject.id,params.settings.locks.ttl_seconds,params.author,Boolean(params.force),params.settings.governance.force_required_for_stale_lock,params.settings.locks.wait_ms);try{const verified=await verifyHistoryRewriteNoDrift({pmRoot:params.pmRoot,subject:params.subject,settings:params.settings,typeRegistry:params.typeRegistry,historyRawBeforeLock:params.historyRawBeforeLock,currentItemRawBeforeLock:params.currentItemRawBeforeLock,operation:params.operation});await params.applyRewrite(verified);if(params.applyPostRewrite){warnings.push(...await params.applyPostRewrite(verified))}return warnings}finally{await releaseLock()}}export{checkHistoryRewriteOwnership,executeHistoryRewrite,verifyHistoryRewriteNoDrift,writeHistoryRawWithRollback};
 //# sourceMappingURL=history-rewrite.js.map
-//# debugId=a2ec9f1a-aae2-59d5-8c9a-7acd8bf5a7a2

package/dist/core/history/history-storage-stats.js

@@ -1,103 +1,2 @@
-/** 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. */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ed44fc89-8b6e-5c83-a4f4-ced4e9031dac")}catch(e){}}();
-function shouldReplaceExtreme(candidate, current, candidateTieBreaker, currentTieBreaker, direction, tieDirection = "min") {
-    const comparison = direction === "min" ? candidate - current : current - candidate;
-    const tieComparison = tieDirection === "min"
-        ? candidateTieBreaker.localeCompare(currentTieBreaker ?? candidateTieBreaker)
-        : (currentTieBreaker ?? candidateTieBreaker).localeCompare(candidateTieBreaker);
-    return comparison < 0 || (comparison === 0 && currentTieBreaker !== null && tieComparison < 0);
-}
-function parseStreamStat(id, raw) {
-    const bytes = Buffer.byteLength(raw, "utf8");
-    let lines = 0;
-    let oldestTs = null;
-    let newestTs = null;
-    let oldestMs = Number.POSITIVE_INFINITY;
-    let newestMs = Number.NEGATIVE_INFINITY;
-    for (const rawLine of raw.split(/\r?\n/)) {
-        const trimmed = rawLine.trim();
-        if (trimmed === "") {
-            continue;
-        }
-        lines += 1;
-        let parsed;
-        try {
-            parsed = JSON.parse(trimmed);
-        }
-        catch {
-            continue;
-        }
-        if (parsed === null ||
-            typeof parsed !== "object" ||
-            !("ts" in parsed) ||
-            typeof parsed["ts"] !== "string") {
-            continue;
-        }
-        const ts = parsed["ts"];
-        const ms = Date.parse(ts);
-        if (Number.isNaN(ms)) {
-            continue;
-        }
-        if (shouldReplaceExtreme(ms, oldestMs, ts, oldestTs, "min")) {
-            oldestMs = ms;
-            oldestTs = ts;
-        }
-        if (shouldReplaceExtreme(ms, newestMs, ts, newestTs, "max", "max")) {
-            newestMs = ms;
-            newestTs = ts;
-        }
-    }
-    return { id, bytes, lines, oldest_ts: oldestTs, newest_ts: newestTs };
-}
-/** Implements compute history storage stats for the public runtime surface of this module. */
-export function computeHistoryStorageStats(streams, options) {
-    const rawTopN = options?.topN ?? 5;
-    const topN = Math.max(0, Math.floor(rawTopN));
-    const stats = streams.map(({ id, raw }) => parseStreamStat(id, raw));
-    let totalLines = 0;
-    let totalBytes = 0;
-    let oldestEntry = null;
-    let newestEntry = null;
-    let globalOldestMs = Number.POSITIVE_INFINITY;
-    let globalNewestMs = Number.NEGATIVE_INFINITY;
-    for (const stat of stats) {
-        totalLines += stat.lines;
-        totalBytes += stat.bytes;
-        if (stat.oldest_ts !== null) {
-            const ms = Date.parse(stat.oldest_ts);
-            if (shouldReplaceExtreme(ms, globalOldestMs, stat.id, oldestEntry?.id ?? null, "min")) {
-                globalOldestMs = ms;
-                oldestEntry = { id: stat.id, ts: stat.oldest_ts };
-            }
-        }
-        if (stat.newest_ts !== null) {
-            const ms = Date.parse(stat.newest_ts);
-            if (shouldReplaceExtreme(ms, globalNewestMs, stat.id, newestEntry?.id ?? null, "max")) {
-                globalNewestMs = ms;
-                newestEntry = { id: stat.id, ts: stat.newest_ts };
-            }
-        }
-    }
-    const largestByBytes = topN === 0
-        ? []
-        : [...stats]
-            .sort((a, b) => b.bytes - a.bytes || a.id.localeCompare(b.id))
-            .slice(0, topN);
-    const deepestByLines = topN === 0
-        ? []
-        : [...stats]
-            .sort((a, b) => b.lines - a.lines || a.id.localeCompare(b.id))
-            .slice(0, topN);
-    return {
-        total_streams: streams.length,
-        total_lines: totalLines,
-        total_bytes: totalBytes,
-        largest_by_bytes: largestByBytes,
-        deepest_by_lines: deepestByLines,
-        oldest_entry: oldestEntry,
-        newest_entry: newestEntry,
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="60090339-2f94-5f22-be47-518498838b92")}catch(e2){}})();function shouldReplaceExtreme(candidate,current,candidateTieBreaker,currentTieBreaker,direction,tieDirection="min"){const comparison=direction==="min"?candidate-current:current-candidate;const tieComparison=tieDirection==="min"?candidateTieBreaker.localeCompare(currentTieBreaker??candidateTieBreaker):(currentTieBreaker??candidateTieBreaker).localeCompare(candidateTieBreaker);return comparison<0||comparison===0&&currentTieBreaker!==null&&tieComparison<0}function parseStreamStat(id,raw){const bytes=Buffer.byteLength(raw,"utf8");let lines=0;let oldestTs=null;let newestTs=null;let oldestMs=Number.POSITIVE_INFINITY;let newestMs=Number.NEGATIVE_INFINITY;for(const rawLine of raw.split(/\r?\n/)){const trimmed=rawLine.trim();if(trimmed===""){continue}lines+=1;let parsed;try{parsed=JSON.parse(trimmed)}catch{continue}if(parsed===null||typeof parsed!=="object"||!("ts"in parsed)||typeof parsed["ts"]!=="string"){continue}const ts=parsed["ts"];const ms=Date.parse(ts);if(Number.isNaN(ms)){continue}if(shouldReplaceExtreme(ms,oldestMs,ts,oldestTs,"min")){oldestMs=ms;oldestTs=ts}if(shouldReplaceExtreme(ms,newestMs,ts,newestTs,"max","max")){newestMs=ms;newestTs=ts}}return{id,bytes,lines,oldest_ts:oldestTs,newest_ts:newestTs}}function computeHistoryStorageStats(streams,options){const rawTopN=options?.topN??5;const topN=Math.max(0,Math.floor(rawTopN));const stats=streams.map(({id,raw})=>parseStreamStat(id,raw));let totalLines=0;let totalBytes=0;let oldestEntry=null;let newestEntry=null;let globalOldestMs=Number.POSITIVE_INFINITY;let globalNewestMs=Number.NEGATIVE_INFINITY;for(const stat of stats){totalLines+=stat.lines;totalBytes+=stat.bytes;if(stat.oldest_ts!==null){const ms=Date.parse(stat.oldest_ts);if(shouldReplaceExtreme(ms,globalOldestMs,stat.id,oldestEntry?.id??null,"min")){globalOldestMs=ms;oldestEntry={id:stat.id,ts:stat.oldest_ts}}}if(stat.newest_ts!==null){const ms=Date.parse(stat.newest_ts);if(shouldReplaceExtreme(ms,globalNewestMs,stat.id,newestEntry?.id??null,"max")){globalNewestMs=ms;newestEntry={id:stat.id,ts:stat.newest_ts}}}}const largestByBytes=topN===0?[]:[...stats].sort((a,b)=>b.bytes-a.bytes||a.id.localeCompare(b.id)).slice(0,topN);const deepestByLines=topN===0?[]:[...stats].sort((a,b)=>b.lines-a.lines||a.id.localeCompare(b.id)).slice(0,topN);return{total_streams:streams.length,total_lines:totalLines,total_bytes:totalBytes,largest_by_bytes:largestByBytes,deepest_by_lines:deepestByLines,oldest_entry:oldestEntry,newest_entry:newestEntry}}export{computeHistoryStorageStats};
 //# sourceMappingURL=history-storage-stats.js.map
-//# debugId=ed44fc89-8b6e-5c83-a4f4-ced4e9031dac

package/dist/core/history/history-stream-policy.js

@@ -1,63 +1,2 @@
-/**
- * @module core/history/history-stream-policy
- *
- * Implements append-only history and replay behavior for History Stream Policy.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="58fd6fef-9c13-5c6a-9110-b760461896aa")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { runActiveOnWriteHooks } from "../extensions/index.js";
-import { ensureDir, pathExists } from "../fs/fs-utils.js";
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-import { getHistoryPath } from "../store/paths.js";
-function toSortedUniqueItemIds(itemIds) {
-    return [...new Set(itemIds.filter((value) => value.trim().length > 0))].sort((left, right) => left.localeCompare(right));
-}
-function strictMissingStreamError(itemId, commandLabel) {
-    return new PmCliError(`Missing history stream for ${itemId}. ${commandLabel} requires history streams when settings.history.missing_stream is strict_error.`, EXIT_CODE.NOT_FOUND);
-}
-async function createStream(historyPath, commandLabel) {
-    await ensureDir(path.dirname(historyPath));
-    const handle = await fs.open(historyPath, "a");
-    await handle.close();
-    return runActiveOnWriteHooks({
-        path: historyPath,
-        scope: "project",
-        op: `${commandLabel}:history:auto_create`,
-    });
-}
-/** Implements enforce history stream policy for item for the public runtime surface of this module. */
-export async function enforceHistoryStreamPolicyForItem(params) {
-    return enforceHistoryStreamPolicyForItems({
-        pmRoot: params.pmRoot,
-        settings: params.settings,
-        itemIds: [params.itemId],
-        commandLabel: params.commandLabel,
-    });
-}
-/** Implements enforce history stream policy for items for the public runtime surface of this module. */
-export async function enforceHistoryStreamPolicyForItems(params) {
-    const ids = toSortedUniqueItemIds(params.itemIds);
-    const autoCreated = [];
-    const warnings = [];
-    for (const itemId of ids) {
-        const historyPath = getHistoryPath(params.pmRoot, itemId);
-        if (await pathExists(historyPath)) {
-            continue;
-        }
-        if (params.settings.history.missing_stream === "strict_error") {
-            throw strictMissingStreamError(itemId, params.commandLabel);
-        }
-        warnings.push(...(await createStream(historyPath, params.commandLabel)));
-        warnings.push(`history_stream_auto_created:${itemId}`);
-        autoCreated.push(itemId);
-    }
-    return {
-        auto_created_ids: autoCreated,
-        warnings,
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="99eadab1-5338-5d75-b600-fa0463053375")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{runActiveOnWriteHooks}from"../extensions/index.js";import{ensureDir,pathExists}from"../fs/fs-utils.js";import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{getHistoryPath}from"../store/paths.js";function toSortedUniqueItemIds(itemIds){return[...new Set(itemIds.filter(value=>value.trim().length>0))].sort((left,right)=>left.localeCompare(right))}function strictMissingStreamError(itemId,commandLabel){return new PmCliError(`Missing history stream for ${itemId}. ${commandLabel} requires history streams when settings.history.missing_stream is strict_error.`,EXIT_CODE.NOT_FOUND)}async function createStream(historyPath,commandLabel){await ensureDir(path.dirname(historyPath));const handle=await fs.open(historyPath,"a");await handle.close();return runActiveOnWriteHooks({path:historyPath,scope:"project",op:`${commandLabel}:history:auto_create`})}async function enforceHistoryStreamPolicyForItem(params){return enforceHistoryStreamPolicyForItems({pmRoot:params.pmRoot,settings:params.settings,itemIds:[params.itemId],commandLabel:params.commandLabel})}async function enforceHistoryStreamPolicyForItems(params){const ids=toSortedUniqueItemIds(params.itemIds);const autoCreated=[];const warnings=[];for(const itemId of ids){const historyPath=getHistoryPath(params.pmRoot,itemId);if(await pathExists(historyPath)){continue}if(params.settings.history.missing_stream==="strict_error"){throw strictMissingStreamError(itemId,params.commandLabel)}warnings.push(...await createStream(historyPath,params.commandLabel));warnings.push(`history_stream_auto_created:${itemId}`);autoCreated.push(itemId)}return{auto_created_ids:autoCreated,warnings}}export{enforceHistoryStreamPolicyForItem,enforceHistoryStreamPolicyForItems};
 //# sourceMappingURL=history-stream-policy.js.map
-//# debugId=58fd6fef-9c13-5c6a-9110-b760461896aa