@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/history/drift-scan.js

@@ -1,343 +1,2 @@
-
-!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]="80648bfe-2436-5b5a-8a16-b9c2875f95fd")}catch(e){}}();
-import fs from "node:fs/promises";
-import { createHash } from "node:crypto";
-import path from "node:path";
-import { getHistoryPath } from "../store/paths.js";
-import { isFileMissingError, writeFileAtomic } from "../fs/fs-utils.js";
-import { CURRENT_HISTORY_ITEM_HASH_VERSION, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, hashDocumentVerificationCandidates, } from "./history.js";
-import { verifyHistoryChainWithVersion } from "./replay.js";
-import { findHistoryIdentityDiscontinuities, } from "./identity.js";
-import { getWorkspaceHistoryPath, inspectWorkspaceHistoryState, WORKSPACE_HISTORY_ID, } from "./workspace-history.js";
-const DRIFT_CACHE_VERSION = 10;
-const DRIFT_CACHE_FILENAME = "history-drift-cache.json";
-function getDriftCachePath(pmRoot) {
-    return path.join(pmRoot, "runtime", DRIFT_CACHE_FILENAME);
-}
-/** Discard unreadable or stale cache envelopes, including prior verification semantics. */
-async function loadDriftCache(pmRoot) {
-    try {
-        const raw = await fs.readFile(getDriftCachePath(pmRoot), "utf8");
-        const parsed = JSON.parse(raw);
-        if (parsed.version !== DRIFT_CACHE_VERSION ||
-            parsed.history_item_hash_version !== CURRENT_HISTORY_ITEM_HASH_VERSION ||
-            typeof parsed.entries !== "object" ||
-            parsed.entries === null ||
-            Object.values(parsed.entries).some((entry) => typeof entry.chain_ok !== "boolean" ||
-                typeof entry.latest_hash_comparable !== "boolean" ||
-                (!SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(entry.item_hash_version) &&
-                    entry.version_skew !== true) ||
-                (entry.chain_ok &&
-                    entry.version_skew !== true &&
-                    SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(entry.item_hash_version) &&
-                    !entry.latest_hash_comparable))) {
-            return null;
-        }
-        return parsed;
-    }
-    catch {
-        return null;
-    }
-}
-async function scanWorkspaceHistory(pmRoot, previousEntries, nextEntries, verifyCacheHitByContent, accumulator) {
-    const historyPath = getWorkspaceHistoryPath(pmRoot);
-    let stat;
-    try {
-        stat = await fs.stat(historyPath);
-    }
-    catch (error) {
-        if (isFileMissingError(error))
-            return false;
-        accumulator.unreadableStreams.push(WORKSPACE_HISTORY_ID);
-        return false;
-    }
-    const missingCount = accumulator.missingStreams.length;
-    const resolved = await resolveStreamVerification({
-        itemId: WORKSPACE_HISTORY_ID,
-        historyPath,
-        stat,
-        cached: previousEntries[WORKSPACE_HISTORY_ID],
-        verifyCacheHitByContent,
-        accumulator,
-    });
-    if (!resolved.verification) {
-        accumulator.missingStreams.splice(missingCount);
-        return resolved.cacheDirty;
-    }
-    if (resolved.verification.versionSkew) {
-        accumulator.versionSkews.push(WORKSPACE_HISTORY_ID);
-    }
-    if (!resolved.verification.chainOk) {
-        accumulator.chainMismatches.push(WORKSPACE_HISTORY_ID);
-    }
-    nextEntries[WORKSPACE_HISTORY_ID] = {
-        mtime_ms: stat.mtimeMs,
-        ctime_ms: stat.ctimeMs,
-        size: stat.size,
-        content_hash: resolved.verification.contentHash,
-        latest_after_hash: resolved.verification.latestAfterHash,
-        chain_ok: resolved.verification.chainOk,
-        version_skew: resolved.verification.versionSkew,
-        latest_hash_comparable: resolved.verification.latestHashComparable,
-        item_hash_version: resolved.verification.itemHashVersion,
-    };
-    return resolved.cacheDirty;
-}
-function hashContent(raw) {
-    return createHash("sha256").update(raw).digest("hex");
-}
-/** Read and fully verify one history stream's hash chain. Returns null for an empty/missing stream (caller records it as a missing stream). */
-async function verifyHistoryStream(historyPath) {
-    const raw = await fs.readFile(historyPath, "utf8");
-    const contentHash = hashContent(raw);
-    if (raw.trim().length === 0) {
-        return null;
-    }
-    const entries = [];
-    let latestAfterHash = null;
-    for (const line of raw.split(/\r?\n/)) {
-        const trimmed = line.trim();
-        if (trimmed.length === 0) {
-            continue;
-        }
-        const parsed = JSON.parse(trimmed);
-        if (typeof parsed.after_hash !== "string" ||
-            parsed.after_hash.trim().length === 0) {
-            throw new Error("missing after_hash");
-        }
-        entries.push(parsed);
-        latestAfterHash = parsed.after_hash;
-    }
-    /* c8 ignore start -- defensive guard for future history schema changes. */
-    if (!latestAfterHash) {
-        return null;
-    }
-    /* c8 ignore stop */
-    const verification = verifyHistoryChainWithVersion(entries);
-    const versionSkew = entries.some((entry) => entry.item_hash_version !== undefined &&
-        !SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(entry.item_hash_version));
-    const latestEntry = entries[entries.length - 1];
-    const latestExplicitVersion = latestEntry.item_hash_version;
-    const latestExplicitVersionSupported = latestExplicitVersion !== undefined &&
-        SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(latestExplicitVersion);
-    const latestHashVersion = latestExplicitVersionSupported
-        ? latestExplicitVersion
-        : verification.item_hash_version;
-    return {
-        latestAfterHash,
-        identityDiscontinuities: findHistoryIdentityDiscontinuities(entries),
-        chainOk: verification.ok,
-        versionSkew,
-        latestHashComparable: latestHashVersion !== undefined &&
-            (!versionSkew ||
-                latestExplicitVersionSupported ||
-                latestExplicitVersion === undefined),
-        contentHash,
-        itemHashVersion: latestHashVersion ?? CURRENT_HISTORY_ITEM_HASH_VERSION,
-    };
-}
-function cacheMetadataMatches(cached, stat) {
-    return (cached !== undefined &&
-        cached.mtime_ms === stat.mtimeMs &&
-        cached.ctime_ms === stat.ctimeMs &&
-        cached.size === stat.size);
-}
-async function loadFreshStreamVerification(itemId, historyPath, accumulator) {
-    try {
-        const loaded = await verifyHistoryStream(historyPath);
-        if (!loaded) {
-            accumulator.missingStreams.push(itemId);
-            return null;
-        }
-        return loaded;
-    }
-    catch {
-        accumulator.unreadableStreams.push(itemId);
-        return null;
-    }
-}
-/** Reverify invalid streams and content-sensitive cache hits; reuse only compatible healthy evidence. */
-async function resolveStreamVerification(params) {
-    const cachedContentHash = typeof params.cached?.content_hash === "string" &&
-        params.cached.content_hash.length > 0
-        ? params.cached.content_hash
-        : undefined;
-    const canUseCache = cacheMetadataMatches(params.cached, params.stat) &&
-        cachedContentHash !== undefined;
-    if (!canUseCache || !params.cached || !params.cached.chain_ok) {
-        return {
-            verification: await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator),
-            cacheDirty: true,
-        };
-    }
-    if (params.verifyCacheHitByContent) {
-        const verification = await loadFreshStreamVerification(params.itemId, params.historyPath, params.accumulator);
-        return {
-            verification,
-            cacheDirty: verification === null ||
-                verification.contentHash !== cachedContentHash ||
-                verification.latestAfterHash !== params.cached.latest_after_hash ||
-                verification.chainOk !== params.cached.chain_ok ||
-                verification.versionSkew !== (params.cached.version_skew === true) ||
-                verification.latestHashComparable !==
-                    params.cached.latest_hash_comparable ||
-                verification.itemHashVersion !== params.cached.item_hash_version,
-        };
-    }
-    return {
-        verification: {
-            identityDiscontinuities: [],
-            latestAfterHash: params.cached.latest_after_hash,
-            chainOk: params.cached.chain_ok,
-            versionSkew: params.cached.version_skew === true,
-            latestHashComparable: params.cached.latest_hash_comparable &&
-                SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(params.cached.item_hash_version),
-            contentHash: cachedContentHash,
-            itemHashVersion: params.cached.item_hash_version,
-        },
-        cacheDirty: false,
-    };
-}
-/** Scan one item stream and return whether its cache entry needs persistence. */
-async function scanItemHistory(pmRoot, item, cache, accumulator) {
-    const historyPath = getHistoryPath(pmRoot, item.id);
-    let stat;
-    try {
-        stat = await fs.stat(historyPath);
-    }
-    catch (error) {
-        (isFileMissingError(error)
-            ? accumulator.missingStreams
-            : accumulator.unreadableStreams).push(item.id);
-        return false;
-    }
-    const resolved = await resolveStreamVerification({
-        itemId: item.id,
-        historyPath,
-        stat,
-        cached: cache.previousEntries[item.id],
-        verifyCacheHitByContent: cache.verifyCacheHitByContent,
-        accumulator,
-    });
-    if (!resolved.verification)
-        return resolved.cacheDirty;
-    if (resolved.verification.identityDiscontinuities.length > 0) {
-        (accumulator.identityDiscontinuities ??= []).push(...resolved.verification.identityDiscontinuities.map((finding) => ({
-            ...finding,
-            item_id: item.id,
-        })));
-    }
-    if (resolved.verification.versionSkew) {
-        accumulator.versionSkews.push(item.id);
-    }
-    if (!resolved.verification.chainOk) {
-        accumulator.chainMismatches.push(item.id);
-    }
-    cache.nextEntries[item.id] = {
-        mtime_ms: stat.mtimeMs,
-        ctime_ms: stat.ctimeMs,
-        size: stat.size,
-        content_hash: resolved.verification.contentHash,
-        latest_after_hash: resolved.verification.latestAfterHash,
-        chain_ok: resolved.verification.chainOk,
-        version_skew: resolved.verification.versionSkew,
-        latest_hash_comparable: resolved.verification.latestHashComparable,
-        item_hash_version: resolved.verification.itemHashVersion,
-    };
-    const { body, ...itemMetadata } = item;
-    if (!resolved.verification.latestHashComparable)
-        return resolved.cacheDirty;
-    const currentHashes = hashDocumentVerificationCandidates({ metadata: itemMetadata, body }, resolved.verification.itemHashVersion);
-    if (!currentHashes.includes(resolved.verification.latestAfterHash))
-        accumulator.hashMismatches.push(item.id);
-    return resolved.cacheDirty;
-}
-/** Compare the verified workspace stream with every governed singleton file. */
-async function scanWorkspaceStateAgreement(pmRoot, accumulator) {
-    if (accumulator.unreadableStreams.includes(WORKSPACE_HISTORY_ID) ||
-        accumulator.chainMismatches.includes(WORKSPACE_HISTORY_ID) ||
-        accumulator.versionSkews.includes(WORKSPACE_HISTORY_ID))
-        return;
-    try {
-        const agreement = await inspectWorkspaceHistoryState(pmRoot);
-        accumulator.workspaceStateMismatches.push(...agreement.mismatched_documents);
-        accumulator.workspaceStateMissing.push(...agreement.missing_documents);
-        accumulator.workspaceStateUnreadable.push(...agreement.unreadable_documents);
-    }
-    catch {
-        accumulator.unreadableStreams.push(WORKSPACE_HISTORY_ID);
-    }
-}
-/**
- * Scan every item's history stream for drift (missing/unreadable streams, broken
- * hash chains, and item/history hash mismatches).
- *
- * Full chain re-verification of a large history tree is the dominant cost of
- * `pm health`. We cache the per-stream verification keyed by the history file's
- * mtime/ctime/size plus content hash. Strict callers keep recomputing the
- * content hash on metadata hits; latency-sensitive health checks can opt into
- * trusting the stat tuple and skip rereading unchanged streams.
- */
-export async function scanHistoryDrift(pmRoot, items, options = {}) {
-    const accumulator = {
-        missingStreams: [],
-        unreadableStreams: [],
-        hashMismatches: [],
-        chainMismatches: [],
-        versionSkews: [],
-        workspaceStateMismatches: [],
-        workspaceStateMissing: [],
-        workspaceStateUnreadable: [],
-    };
-    const cache = await loadDriftCache(pmRoot);
-    const previousEntries = cache?.entries ?? {};
-    const nextEntries = {};
-    let cacheDirty = false;
-    // Metadata mode does not open a stat-matched stream, so unreadable-after-stat
-    // failures are intentionally deferred to strict validate/history-repair scans.
-    const verifyCacheHitByContent = options.cacheHitVerification !== "metadata";
-    const cacheState = {
-        previousEntries,
-        nextEntries,
-        verifyCacheHitByContent,
-    };
-    for (const item of items) {
-        if (await scanItemHistory(pmRoot, item, cacheState, accumulator))
-            cacheDirty = true;
-    }
-    const workspaceCacheDirty = await scanWorkspaceHistory(pmRoot, previousEntries, nextEntries, verifyCacheHitByContent, accumulator);
-    cacheDirty ||= workspaceCacheDirty;
-    await scanWorkspaceStateAgreement(pmRoot, accumulator);
-    if (cacheDirty ||
-        Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {
-        const cachePath = getDriftCachePath(pmRoot);
-        try {
-            await fs.mkdir(path.dirname(cachePath), { recursive: true });
-            await writeFileAtomic(cachePath, JSON.stringify({
-                version: DRIFT_CACHE_VERSION,
-                history_item_hash_version: CURRENT_HISTORY_ITEM_HASH_VERSION,
-                entries: nextEntries,
-            }));
-        }
-        catch {
-            // Best-effort cache write: a failed persist must never fail a health scan.
-        }
-    }
-    const driftedItems = [
-        ...new Set([
-            ...accumulator.missingStreams,
-            ...accumulator.unreadableStreams,
-            ...accumulator.hashMismatches,
-            ...accumulator.chainMismatches,
-            ...accumulator.versionSkews,
-            ...(accumulator.workspaceStateMismatches.length > 0 ||
-                accumulator.workspaceStateMissing.length > 0 ||
-                accumulator.workspaceStateUnreadable.length > 0
-                ? [WORKSPACE_HISTORY_ID]
-                : []),
-        ]),
-    ].sort((a, b) => a.localeCompare(b));
-    return { ...accumulator, driftedItems };
-}
+!(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]="613616a9-118d-5fe7-8871-5406cc2b43a2")}catch(e2){}})();import fs from"node:fs/promises";import{createHash}from"node:crypto";import path from"node:path";import{getHistoryPath}from"../store/paths.js";import{isFileMissingError,writeFileAtomic}from"../fs/fs-utils.js";import{CURRENT_HISTORY_ITEM_HASH_VERSION,SUPPORTED_HISTORY_ITEM_HASH_VERSIONS,hashDocumentVerificationCandidates}from"./history.js";import{verifyHistoryChainWithVersion}from"./replay.js";import{findHistoryIdentityDiscontinuities}from"./identity.js";import{getWorkspaceHistoryPath,inspectWorkspaceHistoryState,WORKSPACE_HISTORY_ID}from"./workspace-history.js";const DRIFT_CACHE_VERSION=10;const DRIFT_CACHE_FILENAME="history-drift-cache.json";function getDriftCachePath(pmRoot){return path.join(pmRoot,"runtime",DRIFT_CACHE_FILENAME)}async function loadDriftCache(pmRoot){try{const raw=await fs.readFile(getDriftCachePath(pmRoot),"utf8");const parsed=JSON.parse(raw);if(parsed.version!==DRIFT_CACHE_VERSION||parsed.history_item_hash_version!==CURRENT_HISTORY_ITEM_HASH_VERSION||typeof parsed.entries!=="object"||parsed.entries===null||Object.values(parsed.entries).some(entry=>typeof entry.chain_ok!=="boolean"||typeof entry.latest_hash_comparable!=="boolean"||!SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(entry.item_hash_version)&&entry.version_skew!==true||entry.chain_ok&&entry.version_skew!==true&&SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(entry.item_hash_version)&&!entry.latest_hash_comparable)){return null}return parsed}catch{return null}}async function scanWorkspaceHistory(pmRoot,previousEntries,nextEntries,verifyCacheHitByContent,accumulator){const historyPath=getWorkspaceHistoryPath(pmRoot);let stat;try{stat=await fs.stat(historyPath)}catch(error){if(isFileMissingError(error))return false;accumulator.unreadableStreams.push(WORKSPACE_HISTORY_ID);return false}const missingCount=accumulator.missingStreams.length;const resolved=await resolveStreamVerification({itemId:WORKSPACE_HISTORY_ID,historyPath,stat,cached:previousEntries[WORKSPACE_HISTORY_ID],verifyCacheHitByContent,accumulator});if(!resolved.verification){accumulator.missingStreams.splice(missingCount);return resolved.cacheDirty}if(resolved.verification.versionSkew){accumulator.versionSkews.push(WORKSPACE_HISTORY_ID)}if(!resolved.verification.chainOk){accumulator.chainMismatches.push(WORKSPACE_HISTORY_ID)}nextEntries[WORKSPACE_HISTORY_ID]={mtime_ms:stat.mtimeMs,ctime_ms:stat.ctimeMs,size:stat.size,content_hash:resolved.verification.contentHash,latest_after_hash:resolved.verification.latestAfterHash,chain_ok:resolved.verification.chainOk,version_skew:resolved.verification.versionSkew,latest_hash_comparable:resolved.verification.latestHashComparable,item_hash_version:resolved.verification.itemHashVersion};return resolved.cacheDirty}function hashContent(raw){return createHash("sha256").update(raw).digest("hex")}async function verifyHistoryStream(historyPath){const raw=await fs.readFile(historyPath,"utf8");const contentHash=hashContent(raw);if(raw.trim().length===0){return null}const entries=[];let latestAfterHash=null;for(const line of raw.split(/\r?\n/)){const trimmed=line.trim();if(trimmed.length===0){continue}const parsed=JSON.parse(trimmed);if(typeof parsed.after_hash!=="string"||parsed.after_hash.trim().length===0){throw new Error("missing after_hash")}entries.push(parsed);latestAfterHash=parsed.after_hash}if(!latestAfterHash){return null}const verification=verifyHistoryChainWithVersion(entries);const versionSkew=entries.some(entry=>entry.item_hash_version!==void 0&&!SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(entry.item_hash_version));const latestEntry=entries[entries.length-1];const latestExplicitVersion=latestEntry.item_hash_version;const latestExplicitVersionSupported=latestExplicitVersion!==void 0&&SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(latestExplicitVersion);const latestHashVersion=latestExplicitVersionSupported?latestExplicitVersion:verification.item_hash_version;return{latestAfterHash,identityDiscontinuities:findHistoryIdentityDiscontinuities(entries),chainOk:verification.ok,versionSkew,latestHashComparable:latestHashVersion!==void 0&&(!versionSkew||latestExplicitVersionSupported||latestExplicitVersion===void 0),contentHash,itemHashVersion:latestHashVersion??CURRENT_HISTORY_ITEM_HASH_VERSION}}function cacheMetadataMatches(cached,stat){return cached!==void 0&&cached.mtime_ms===stat.mtimeMs&&cached.ctime_ms===stat.ctimeMs&&cached.size===stat.size}async function loadFreshStreamVerification(itemId,historyPath,accumulator){try{const loaded=await verifyHistoryStream(historyPath);if(!loaded){accumulator.missingStreams.push(itemId);return null}return loaded}catch{accumulator.unreadableStreams.push(itemId);return null}}async function resolveStreamVerification(params){const cachedContentHash=typeof params.cached?.content_hash==="string"&&params.cached.content_hash.length>0?params.cached.content_hash:void 0;const canUseCache=cacheMetadataMatches(params.cached,params.stat)&&cachedContentHash!==void 0;if(!canUseCache||!params.cached||!params.cached.chain_ok){return{verification:await loadFreshStreamVerification(params.itemId,params.historyPath,params.accumulator),cacheDirty:true}}if(params.verifyCacheHitByContent){const verification=await loadFreshStreamVerification(params.itemId,params.historyPath,params.accumulator);return{verification,cacheDirty:verification===null||verification.contentHash!==cachedContentHash||verification.latestAfterHash!==params.cached.latest_after_hash||verification.chainOk!==params.cached.chain_ok||verification.versionSkew!==(params.cached.version_skew===true)||verification.latestHashComparable!==params.cached.latest_hash_comparable||verification.itemHashVersion!==params.cached.item_hash_version}}return{verification:{identityDiscontinuities:[],latestAfterHash:params.cached.latest_after_hash,chainOk:params.cached.chain_ok,versionSkew:params.cached.version_skew===true,latestHashComparable:params.cached.latest_hash_comparable&&SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(params.cached.item_hash_version),contentHash:cachedContentHash,itemHashVersion:params.cached.item_hash_version},cacheDirty:false}}async function scanItemHistory(pmRoot,item,cache,accumulator){let historyPath;let stat;try{historyPath=getHistoryPath(pmRoot,item.id);stat=await fs.stat(historyPath)}catch(error){(isFileMissingError(error)?accumulator.missingStreams:accumulator.unreadableStreams).push(item.id);return false}const resolved=await resolveStreamVerification({itemId:item.id,historyPath,stat,cached:cache.previousEntries[item.id],verifyCacheHitByContent:cache.verifyCacheHitByContent,accumulator});if(!resolved.verification)return resolved.cacheDirty;if(resolved.verification.identityDiscontinuities.length>0){(accumulator.identityDiscontinuities??=[]).push(...resolved.verification.identityDiscontinuities.map(finding=>({...finding,item_id:item.id})))}if(resolved.verification.versionSkew){accumulator.versionSkews.push(item.id)}if(!resolved.verification.chainOk){accumulator.chainMismatches.push(item.id)}cache.nextEntries[item.id]={mtime_ms:stat.mtimeMs,ctime_ms:stat.ctimeMs,size:stat.size,content_hash:resolved.verification.contentHash,latest_after_hash:resolved.verification.latestAfterHash,chain_ok:resolved.verification.chainOk,version_skew:resolved.verification.versionSkew,latest_hash_comparable:resolved.verification.latestHashComparable,item_hash_version:resolved.verification.itemHashVersion};const{body,...itemMetadata}=item;if(!resolved.verification.latestHashComparable)return resolved.cacheDirty;const currentHashes=hashDocumentVerificationCandidates({metadata:itemMetadata,body},resolved.verification.itemHashVersion);if(!currentHashes.includes(resolved.verification.latestAfterHash))accumulator.hashMismatches.push(item.id);return resolved.cacheDirty}async function scanWorkspaceStateAgreement(pmRoot,accumulator){if(accumulator.unreadableStreams.includes(WORKSPACE_HISTORY_ID)||accumulator.chainMismatches.includes(WORKSPACE_HISTORY_ID)||accumulator.versionSkews.includes(WORKSPACE_HISTORY_ID))return;try{const agreement=await inspectWorkspaceHistoryState(pmRoot);accumulator.workspaceStateMismatches.push(...agreement.mismatched_documents);accumulator.workspaceStateMissing.push(...agreement.missing_documents);accumulator.workspaceStateUnreadable.push(...agreement.unreadable_documents)}catch{accumulator.unreadableStreams.push(WORKSPACE_HISTORY_ID)}}async function scanHistoryDrift(pmRoot,items,options={}){const accumulator={missingStreams:[],unreadableStreams:[],hashMismatches:[],chainMismatches:[],versionSkews:[],workspaceStateMismatches:[],workspaceStateMissing:[],workspaceStateUnreadable:[]};const cache=await loadDriftCache(pmRoot);const previousEntries=cache?.entries??{};const nextEntries={};let cacheDirty=false;const verifyCacheHitByContent=options.cacheHitVerification!=="metadata";const cacheState={previousEntries,nextEntries,verifyCacheHitByContent};for(const item of items){if(await scanItemHistory(pmRoot,item,cacheState,accumulator))cacheDirty=true}const workspaceCacheDirty=await scanWorkspaceHistory(pmRoot,previousEntries,nextEntries,verifyCacheHitByContent,accumulator);cacheDirty||=workspaceCacheDirty;await scanWorkspaceStateAgreement(pmRoot,accumulator);if(cacheDirty||Object.keys(previousEntries).length!==Object.keys(nextEntries).length){const cachePath=getDriftCachePath(pmRoot);try{await fs.mkdir(path.dirname(cachePath),{recursive:true});await writeFileAtomic(cachePath,JSON.stringify({version:DRIFT_CACHE_VERSION,history_item_hash_version:CURRENT_HISTORY_ITEM_HASH_VERSION,entries:nextEntries}))}catch{}}const driftedItems=[...new Set([...accumulator.missingStreams,...accumulator.unreadableStreams,...accumulator.hashMismatches,...accumulator.chainMismatches,...accumulator.versionSkews,...accumulator.workspaceStateMismatches.length>0||accumulator.workspaceStateMissing.length>0||accumulator.workspaceStateUnreadable.length>0?[WORKSPACE_HISTORY_ID]:[]])].sort((a,b)=>a.localeCompare(b));return{...accumulator,driftedItems}}export{scanHistoryDrift};
 //# sourceMappingURL=drift-scan.js.map
-//# debugId=80648bfe-2436-5b5a-8a16-b9c2875f95fd

package/dist/core/history/event-classification.js

@@ -1,110 +1,2 @@
-/** Current version of the public history-event classification 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]="9ad6614e-44bc-549c-915c-6177c3a43c1f")}catch(e){}}();
-export const HISTORY_EVENT_CLASSIFICATION_VERSION = 1;
-/** Operations whose meaning is always governance or storage maintenance. */
-export const MAINTENANCE_HISTORY_OPERATIONS = [
-    "docs_add",
-    "files_add",
-    "history:author-acknowledge",
-    "history_author_acknowledge",
-    "history_compact",
-    "history_compact_baseline",
-    "history_redact",
-    "history_repair",
-    "history_salvage",
-    "normalize",
-    "release",
-    "test_run_track",
-    "tests_add",
-    "tests_remove",
-    "update_audit",
-    "update_ownership_bypass",
-];
-/** Operations whose meaning always advances lifecycle or working context. */
-export const SUBSTANTIVE_HISTORY_OPERATIONS = [
-    "append",
-    "cancel",
-    "claim",
-    "close",
-    "comment_add",
-    "create",
-    "learning_add",
-    "note_add",
-    "reopen",
-];
-const MAINTENANCE_OPERATIONS = new Set(MAINTENANCE_HISTORY_OPERATIONS);
-const SUBSTANTIVE_OPERATIONS = new Set(SUBSTANTIVE_HISTORY_OPERATIONS);
-const MAINTENANCE_UPDATE_FIELDS = new Set([
-    "actual_result",
-    "affected_version",
-    "assignee",
-    "blocked_by",
-    "blocked_reason",
-    "close_reason",
-    "confidence",
-    "customer_impact",
-    "definition_of_ready",
-    "dependencies",
-    "docs",
-    "environment",
-    "expected_result",
-    "files",
-    "fixed_version",
-    "goal",
-    "impact",
-    "learnings",
-    "notes",
-    "objective",
-    "order",
-    "outcome",
-    "parent",
-    "release",
-    "reminders",
-    "reporter",
-    "repro_steps",
-    "resolution",
-    "reviewer",
-    "severity",
-    "sprint",
-    "tests",
-    "test_runs",
-    "unblock_note",
-    "updated_at",
-    "value",
-    "why_now",
-]);
-function topLevelPatchField(operation) {
-    const segments = operation.path.split("/").filter(Boolean);
-    if (segments[0] === "metadata" || segments[0] === "front_matter") {
-        return segments[1];
-    }
-    return segments[0] === "body" ? "body" : undefined;
-}
-/**
- * Classify an immutable event using its declared class when present, then the
- * versioned operation/path contract. Unknown events fail closed as substantive
- * so new work cannot silently disappear from temporal relevance.
- */
-export function classifyHistoryEvent(entry) {
-    if (entry.event_class === "substantive" ||
-        entry.event_class === "maintenance") {
-        return entry.event_class;
-    }
-    if (MAINTENANCE_OPERATIONS.has(entry.op))
-        return "maintenance";
-    if (SUBSTANTIVE_OPERATIONS.has(entry.op))
-        return "substantive";
-    if (entry.op !== "update")
-        return "substantive";
-    return Array.isArray(entry.patch) &&
-        entry.patch.length > 0 &&
-        entry.patch.every((operation) => {
-            const field = topLevelPatchField(operation);
-            return field !== undefined && MAINTENANCE_UPDATE_FIELDS.has(field);
-        })
-        ? "maintenance"
-        : "substantive";
-}
+!(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]="9d5caf29-c1f2-5120-bc0b-c64a0bdd19ff")}catch(e2){}})();const HISTORY_EVENT_CLASSIFICATION_VERSION=1;const MAINTENANCE_HISTORY_OPERATIONS=["docs_add","files_add","history:author-acknowledge","history_author_acknowledge","history_compact","history_compact_baseline","history_redact","history_repair","history_salvage","normalize","release","test_run_track","tests_add","tests_remove","update_audit","update_ownership_bypass"];const SUBSTANTIVE_HISTORY_OPERATIONS=["append","cancel","claim","close","comment_add","create","learning_add","note_add","reopen"];const MAINTENANCE_OPERATIONS=new Set(MAINTENANCE_HISTORY_OPERATIONS);const SUBSTANTIVE_OPERATIONS=new Set(SUBSTANTIVE_HISTORY_OPERATIONS);const MAINTENANCE_UPDATE_FIELDS=new Set(["actual_result","affected_version","assignee","blocked_by","blocked_reason","close_reason","confidence","customer_impact","definition_of_ready","dependencies","docs","environment","expected_result","files","fixed_version","goal","impact","learnings","notes","objective","order","outcome","parent","release","reminders","reporter","repro_steps","resolution","reviewer","severity","sprint","tests","test_runs","unblock_note","updated_at","value","why_now"]);function topLevelPatchField(operation){const segments=operation.path.split("/").filter(Boolean);if(segments[0]==="metadata"||segments[0]==="front_matter"){return segments[1]}return segments[0]==="body"?"body":void 0}function classifyHistoryEvent(entry){if(entry.event_class==="substantive"||entry.event_class==="maintenance"){return entry.event_class}if(MAINTENANCE_OPERATIONS.has(entry.op))return"maintenance";if(SUBSTANTIVE_OPERATIONS.has(entry.op))return"substantive";if(entry.op!=="update")return"substantive";return Array.isArray(entry.patch)&&entry.patch.length>0&&entry.patch.every(operation=>{const field=topLevelPatchField(operation);return field!==void 0&&MAINTENANCE_UPDATE_FIELDS.has(field)})?"maintenance":"substantive"}export{HISTORY_EVENT_CLASSIFICATION_VERSION,MAINTENANCE_HISTORY_OPERATIONS,SUBSTANTIVE_HISTORY_OPERATIONS,classifyHistoryEvent};
 //# sourceMappingURL=event-classification.js.map
-//# debugId=9ad6614e-44bc-549c-915c-6177c3a43c1f