@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/governance/stale-work.js

@@ -1,83 +1,2 @@
-/**
- * @module sdk/governance/stale-work
- *
- * Detects abandoned in-progress work from tracker metadata and append-only
- * history without changing item ownership or lifecycle state.
- */
-
-!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]="376bb9d2-e202-57e7-86c8-d70a7d3fa7ab")}catch(e){}}();
-import path from "node:path";
-import { readHistoryEntries } from "../../core/history/read.js";
-function normalizedStatus(value) {
-    return (value ?? "in_progress").trim().toLowerCase().replaceAll("-", "_");
-}
-function latestValidTimestamp(item, historyTimestamp) {
-    const candidates = [item.updated_at, historyTimestamp]
-        .map((value) => ({ value, time: Date.parse(value ?? "") }))
-        .filter((candidate) => typeof candidate.value === "string" && Number.isFinite(candidate.time))
-        .sort((left, right) => right.time - left.time);
-    return candidates[0]?.value ?? item.updated_at;
-}
-/** Classify stale unclaimed in-progress items without filesystem access. */
-export function inspectStaleInProgressItems(items, options) {
-    const thresholdHours = Math.max(1, Math.trunc(options.threshold_hours));
-    const nowMs = (options.now ?? new Date()).getTime();
-    const inProgressStatus = normalizedStatus(options.in_progress_status);
-    const staleItems = [];
-    for (const item of items) {
-        if (normalizedStatus(String(item.status)) !== inProgressStatus ||
-            (item.assignee?.trim().length ?? 0) > 0) {
-            continue;
-        }
-        const lastActivityAt = latestValidTimestamp(item, options.last_history_activity?.(item));
-        const lastActivityMs = Date.parse(lastActivityAt);
-        if (!Number.isFinite(lastActivityMs)) {
-            continue;
-        }
-        const ageHours = Math.max(0, Math.floor((nowMs - lastActivityMs) / 3_600_000));
-        if (ageHours >= thresholdHours) {
-            staleItems.push({
-                id: item.id,
-                last_activity_at: lastActivityAt,
-                age_hours: ageHours,
-            });
-        }
-    }
-    staleItems.sort((left, right) => right.age_hours - left.age_hours || left.id.localeCompare(right.id));
-    return {
-        threshold_hours: thresholdHours,
-        count: staleItems.length,
-        items: staleItems,
-        remediation: "Claim active work with `pm claim <id>` or return abandoned work to open with `pm update <id> --status open`.",
-    };
-}
-/** Scan tracker history and metadata for stale unclaimed in-progress work. */
-export async function scanStaleInProgressItems(pmRoot, items, options) {
-    const historyTimestamps = new Map();
-    await Promise.all(items
-        .filter((item) => normalizedStatus(String(item.status)) ===
-        normalizedStatus(options.in_progress_status) &&
-        (item.assignee?.trim().length ?? 0) === 0)
-        .map(async (item) => {
-        let history;
-        try {
-            history = await readHistoryEntries(path.join(pmRoot, "history", `${item.id}.jsonl`), item.id);
-        }
-        catch {
-            return;
-        }
-        const latest = history
-            .map((entry) => entry.ts)
-            .filter((timestamp) => Number.isFinite(Date.parse(timestamp)))
-            .sort((left, right) => Date.parse(right) - Date.parse(left))[0];
-        if (latest) {
-            historyTimestamps.set(item.id, latest);
-        }
-    }));
-    return inspectStaleInProgressItems(items, {
-        ...options,
-        last_history_activity: (item) => historyTimestamps.get(item.id),
-    });
-}
+!(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]="cdae67c6-8316-5e97-84ca-0be4460ffd57")}catch(e2){}})();import path from"node:path";import{readHistoryEntries}from"../../core/history/read.js";function normalizedStatus(value){return(value??"in_progress").trim().toLowerCase().replaceAll("-","_")}function latestValidTimestamp(item,historyTimestamp){const candidates=[item.updated_at,historyTimestamp].map(value=>({value,time:Date.parse(value??"")})).filter(candidate=>typeof candidate.value==="string"&&Number.isFinite(candidate.time)).sort((left,right)=>right.time-left.time);return candidates[0]?.value??item.updated_at}function inspectStaleInProgressItems(items,options){const thresholdHours=Math.max(1,Math.trunc(options.threshold_hours));const nowMs=(options.now??new Date).getTime();const inProgressStatus=normalizedStatus(options.in_progress_status);const staleItems=[];for(const item of items){if(normalizedStatus(String(item.status))!==inProgressStatus||(item.assignee?.trim().length??0)>0){continue}const lastActivityAt=latestValidTimestamp(item,options.last_history_activity?.(item));const lastActivityMs=Date.parse(lastActivityAt);if(!Number.isFinite(lastActivityMs)){continue}const ageHours=Math.max(0,Math.floor((nowMs-lastActivityMs)/36e5));if(ageHours>=thresholdHours){staleItems.push({id:item.id,last_activity_at:lastActivityAt,age_hours:ageHours})}}staleItems.sort((left,right)=>right.age_hours-left.age_hours||left.id.localeCompare(right.id));return{threshold_hours:thresholdHours,count:staleItems.length,items:staleItems,remediation:"Claim active work with `pm claim <id>` or return abandoned work to open with `pm update <id> --status open`."}}async function scanStaleInProgressItems(pmRoot,items,options){const historyTimestamps=new Map;await Promise.all(items.filter(item=>normalizedStatus(String(item.status))===normalizedStatus(options.in_progress_status)&&(item.assignee?.trim().length??0)===0).map(async item=>{let history;try{history=await readHistoryEntries(path.join(pmRoot,"history",`${item.id}.jsonl`),item.id)}catch{return}const latest=history.map(entry=>entry.ts).filter(timestamp=>Number.isFinite(Date.parse(timestamp))).sort((left,right)=>Date.parse(right)-Date.parse(left))[0];if(latest){historyTimestamps.set(item.id,latest)}}));return inspectStaleInProgressItems(items,{...options,last_history_activity:item=>historyTimestamps.get(item.id)})}export{inspectStaleInProgressItems,scanStaleInProgressItems};
 //# sourceMappingURL=stale-work.js.map
-//# debugId=376bb9d2-e202-57e7-86c8-d70a7d3fa7ab

package/dist/sdk/governance/status-role-diagnostics.js

@@ -1,36 +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]="cd7acf28-cb93-516e-9058-54c32625ec26")}catch(e){}}();
-import { normalizeStatusInputWithRegistry, } from "../../core/schema/runtime-schema.js";
-/** Inspect role registration and affected items without mutating the tracker. */
-export function inspectStatusRoleAssignments(statusRegistry, items, itemLimit = 25) {
-    const rolelessStatuses = statusRegistry.definitions
-        .filter((definition) => definition.roles.length === 0)
-        .map((definition) => definition.id)
-        .sort((left, right) => left.localeCompare(right));
-    const rolelessSet = new Set(rolelessStatuses);
-    const affectedItemIds = items
-        .filter((item) => {
-        const resolved = normalizeStatusInputWithRegistry(item.status, statusRegistry);
-        return resolved !== undefined && rolelessSet.has(resolved);
-    })
-        .map((item) => item.id)
-        .sort((left, right) => left.localeCompare(right));
-    return {
-        roleless_status_count: rolelessStatuses.length,
-        roleless_statuses: rolelessStatuses.slice(0, itemLimit),
-        roleless_statuses_truncated: rolelessStatuses.length > itemLimit,
-        affected_item_count: affectedItemIds.length,
-        affected_item_ids: affectedItemIds.slice(0, itemLimit),
-        affected_item_ids_truncated: affectedItemIds.length > itemLimit,
-    };
-}
-/** Convert role diagnostics into the stable health/validate warning token. */
-export function buildStatusRoleWarnings(diagnostics) {
-    return diagnostics.roleless_status_count === 0
-        ? []
-        : [
-            `schema_status_missing_lifecycle_role:${diagnostics.roleless_status_count}`,
-        ];
-}
+!(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]="77ccea6e-a118-53df-94b7-a740bb3d7681")}catch(e2){}})();import{normalizeStatusInputWithRegistry}from"../../core/schema/runtime-schema.js";function inspectStatusRoleAssignments(statusRegistry,items,itemLimit=25){const rolelessStatuses=statusRegistry.definitions.filter(definition=>definition.roles.length===0).map(definition=>definition.id).sort((left,right)=>left.localeCompare(right));const rolelessSet=new Set(rolelessStatuses);const affectedItemIds=items.filter(item=>{const resolved=normalizeStatusInputWithRegistry(item.status,statusRegistry);return resolved!==void 0&&rolelessSet.has(resolved)}).map(item=>item.id).sort((left,right)=>left.localeCompare(right));return{roleless_status_count:rolelessStatuses.length,roleless_statuses:rolelessStatuses.slice(0,itemLimit),roleless_statuses_truncated:rolelessStatuses.length>itemLimit,affected_item_count:affectedItemIds.length,affected_item_ids:affectedItemIds.slice(0,itemLimit),affected_item_ids_truncated:affectedItemIds.length>itemLimit}}function buildStatusRoleWarnings(diagnostics){return diagnostics.roleless_status_count===0?[]:[`schema_status_missing_lifecycle_role:${diagnostics.roleless_status_count}`]}export{buildStatusRoleWarnings,inspectStatusRoleAssignments};
 //# sourceMappingURL=status-role-diagnostics.js.map
-//# debugId=cd7acf28-cb93-516e-9058-54c32625ec26

package/dist/sdk/governance/storage-integrity.js

@@ -1,281 +1,2 @@
-/**
- * @module sdk/governance/storage-integrity
- *
- * Post-merge storage-integrity check for `pm validate`: fails the workspace
- * when tracker storage is provably corrupted in ways the ordinary read path
- * silently tolerates — unparseable item documents (skipped by the list scan),
- * history streams containing unresolved merge-conflict markers, deleted items
- * silently resurrected by a delete/modify merge, and configuration or schema
- * files whose parse failure would otherwise fall back to defaults behind a
- * green gate. This is the detection half of the tracker merge-semantics
- * contract; the merge drivers in `sdk/merge` are the prevention half.
- */
-
-!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]="59b566d5-1d4f-500b-98e3-004e6f57d2b4")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { readFileIfExists } from "../../core/fs/fs-utils.js";
-import { parseItemDocument, } from "../../core/item/item-format.js";
-import { findFirstMergeConflictMarker } from "../../core/shared/conflict-markers.js";
-import { getSettingsPath, ITEM_FILE_EXTENSIONS, } from "../../core/store/paths.js";
-async function listItemFilesOnDisk(pmRoot, typeToFolder) {
-    const folders = [...new Set(Object.values(typeToFolder))];
-    const found = [];
-    await Promise.all(folders.map(async (folder) => {
-        let entries;
-        try {
-            entries = await fs.readdir(path.join(pmRoot, folder));
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            for (const extension of ITEM_FILE_EXTENSIONS) {
-                if (entry.toLowerCase().endsWith(extension)) {
-                    found.push({
-                        relativePath: `${folder}/${entry}`,
-                        id: entry.slice(0, -extension.length),
-                    });
-                    break;
-                }
-            }
-        }
-    }));
-    return found.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
-}
-function scanHistoryStreamContent(accumulator, raw) {
-    const { id, relativePath, liveItemIds, out } = accumulator;
-    const conflictMarker = findFirstMergeConflictMarker(raw);
-    if (conflictMarker) {
-        out.conflictMarkers.push({
-            id,
-            path: relativePath,
-            line: conflictMarker.line,
-            detail: `unresolved merge conflict marker ${conflictMarker.marker}`,
-        });
-        return;
-    }
-    let latestEntry = null;
-    const lines = raw
-        .split(/\r?\n/)
-        .map((line, index) => ({ content: line.trim(), number: index + 1 }))
-        .filter((line) => line.content.length > 0);
-    for (const line of lines) {
-        try {
-            const parsed = JSON.parse(line.content);
-            if (typeof parsed !== "object" ||
-                parsed === null ||
-                Array.isArray(parsed)) {
-                throw new TypeError("history entry must be an object");
-            }
-            latestEntry = parsed;
-        }
-        catch {
-            out.unparseable.push({
-                id,
-                path: relativePath,
-                line: line.number,
-                detail: "history line is not a valid JSON object",
-            });
-            return;
-        }
-    }
-    if (latestEntry === null) {
-        return;
-    }
-    if (latestEntry.op === "delete" && liveItemIds.has(id)) {
-        out.resurrected.push({
-            id,
-            deleted_at: typeof latestEntry.ts === "string" ? latestEntry.ts : "",
-            deleted_by: typeof latestEntry.author === "string" ? latestEntry.author : "",
-        });
-    }
-    if (latestEntry.op === "history_repair" &&
-        Array.isArray(latestEntry.patch) &&
-        latestEntry.patch.length > 0) {
-        out.repairReconciliations += 1;
-    }
-}
-/** Describe a filesystem read failure without exposing the absolute workspace path. */
-function describeFileReadFailure(subject, error) {
-    const code = typeof error === "object" &&
-        error !== null &&
-        "code" in error &&
-        typeof error.code === "string"
-        ? error.code
-        : "UNKNOWN";
-    return `${subject} could not be read (error code: ${code})`;
-}
-async function scanHistoryStreams(pmRoot, liveItemIds) {
-    const out = {
-        conflictMarkers: [],
-        unparseable: [],
-        resurrected: [],
-        repairReconciliations: 0,
-        scanned: 0,
-    };
-    let entries;
-    try {
-        entries = await fs.readdir(path.join(pmRoot, "history"));
-    }
-    catch {
-        return out;
-    }
-    for (const entry of entries.sort((left, right) => left.localeCompare(right))) {
-        if (!entry.endsWith(".jsonl")) {
-            continue;
-        }
-        out.scanned += 1;
-        let raw;
-        try {
-            raw = await fs.readFile(path.join(pmRoot, "history", entry), "utf8");
-        }
-        catch (error) {
-            out.unparseable.push({
-                id: entry.slice(0, -".jsonl".length),
-                path: `history/${entry}`,
-                detail: describeFileReadFailure("history stream", error),
-            });
-            continue;
-        }
-        scanHistoryStreamContent({
-            id: entry.slice(0, -".jsonl".length),
-            relativePath: `history/${entry}`,
-            liveItemIds,
-            out,
-        }, raw);
-    }
-    return out;
-}
-function describeUnparseableJson(raw) {
-    const conflictMarker = findFirstMergeConflictMarker(raw);
-    if (conflictMarker) {
-        return `unresolved merge conflict marker ${conflictMarker.marker} at line ${conflictMarker.line}`;
-    }
-    try {
-        JSON.parse(raw);
-        return null;
-    }
-    catch (error) {
-        return `invalid JSON (${String(error)})`;
-    }
-}
-async function scanConfigFiles(pmRoot) {
-    const unparseable = [];
-    let scanned = 0;
-    let settingsRaw = null;
-    try {
-        settingsRaw = await readFileIfExists(getSettingsPath(pmRoot));
-    }
-    catch (error) {
-        scanned += 1;
-        unparseable.push({
-            path: "settings.json",
-            detail: describeFileReadFailure("configuration file", error),
-        });
-    }
-    if (settingsRaw !== null) {
-        scanned += 1;
-        const detail = describeUnparseableJson(settingsRaw);
-        if (detail !== null) {
-            unparseable.push({ path: "settings.json", detail });
-        }
-    }
-    let schemaEntries;
-    try {
-        schemaEntries = await fs.readdir(path.join(pmRoot, "schema"));
-    }
-    catch {
-        return { scanned, unparseable };
-    }
-    for (const entry of schemaEntries.sort((left, right) => left.localeCompare(right))) {
-        if (!entry.endsWith(".json")) {
-            continue;
-        }
-        scanned += 1;
-        let raw;
-        try {
-            raw = await fs.readFile(path.join(pmRoot, "schema", entry), "utf8");
-        }
-        catch (error) {
-            unparseable.push({
-                path: `schema/${entry}`,
-                detail: describeFileReadFailure("configuration file", error),
-            });
-            continue;
-        }
-        const detail = describeUnparseableJson(raw);
-        if (detail !== null) {
-            unparseable.push({ path: `schema/${entry}`, detail });
-        }
-    }
-    return { scanned, unparseable };
-}
-/**
- * Scan tracker storage for integrity failures the ordinary read path masks.
- * `parsedItemIds` are the ids the standard cached list scan successfully
- * parsed; any on-disk item file whose id is missing from that set is an
- * unreadable document that `pm get` would hard-error on while list-based
- * commands silently skip it.
- */
-export async function scanStorageIntegrity(pmRoot, parsedItemIds, typeToFolder, itemParseOptions = {}) {
-    const itemFiles = await listItemFilesOnDisk(pmRoot, typeToFolder);
-    const idsOnDisk = new Set(itemFiles.map((file) => file.id));
-    const pathsById = new Map();
-    for (const file of itemFiles) {
-        const paths = pathsById.get(file.id);
-        if (paths === undefined) {
-            pathsById.set(file.id, [file.relativePath]);
-        }
-        else {
-            paths.push(file.relativePath);
-        }
-    }
-    const duplicateItemIds = [...pathsById.entries()]
-        .filter(([, paths]) => paths.length > 1)
-        .map(([id, paths]) => ({
-        id,
-        paths: [...paths].sort((left, right) => left.localeCompare(right)),
-    }))
-        .sort((left, right) => left.id.localeCompare(right.id));
-    const unreadableItemFiles = (await Promise.all(itemFiles.map(async (file) => {
-        if (!parsedItemIds.has(file.id)) {
-            return { path: file.relativePath, id: file.id };
-        }
-        try {
-            const absolutePath = path.join(pmRoot, file.relativePath);
-            parseItemDocument(await fs.readFile(absolutePath, "utf8"), {
-                format: absolutePath.toLowerCase().endsWith(".md")
-                    ? "json_markdown"
-                    : "toon",
-                schema: itemParseOptions.schema,
-                extensionFieldNames: itemParseOptions.extensionFieldNames,
-            });
-            return null;
-        }
-        catch {
-            return { path: file.relativePath, id: file.id };
-        }
-    }))).filter((row) => row !== null);
-    // "Live" for resurrection detection means an item file exists on disk —
-    // deleted items keep their history stream but lose the document, so a
-    // delete-terminated stream is only suspicious when the document is back.
-    const historyScan = await scanHistoryStreams(pmRoot, idsOnDisk);
-    const configScan = await scanConfigFiles(pmRoot);
-    return {
-        item_files_on_disk: itemFiles.length,
-        item_ids_on_disk: idsOnDisk.size,
-        parsed_items: parsedItemIds.size,
-        unreadable_item_files: unreadableItemFiles,
-        duplicate_item_ids: duplicateItemIds,
-        history_streams_scanned: historyScan.scanned,
-        history_conflict_marker_streams: historyScan.conflictMarkers,
-        history_unparseable_streams: historyScan.unparseable,
-        resurrected_items: historyScan.resurrected,
-        history_repair_reconciliations: historyScan.repairReconciliations,
-        config_files_scanned: configScan.scanned,
-        unparseable_config_files: configScan.unparseable,
-    };
-}
+!(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]="7a24fc6d-8be3-5128-977f-f28842040050")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{readFileIfExists}from"../../core/fs/fs-utils.js";import{parseItemDocument}from"../../core/item/item-format.js";import{findFirstMergeConflictMarker}from"../../core/shared/conflict-markers.js";import{getSettingsPath,ITEM_FILE_EXTENSIONS}from"../../core/store/paths.js";async function listItemFilesOnDisk(pmRoot,typeToFolder){const folders=[...new Set(Object.values(typeToFolder))];const found=[];await Promise.all(folders.map(async folder=>{let entries;try{entries=await fs.readdir(path.join(pmRoot,folder))}catch{return}for(const entry of entries){for(const extension of ITEM_FILE_EXTENSIONS){if(entry.toLowerCase().endsWith(extension)){found.push({relativePath:`${folder}/${entry}`,id:entry.slice(0,-extension.length)});break}}}}));return found.sort((left,right)=>left.relativePath.localeCompare(right.relativePath))}function scanHistoryStreamContent(accumulator,raw){const{id,relativePath,liveItemIds,out}=accumulator;const conflictMarker=findFirstMergeConflictMarker(raw);if(conflictMarker){out.conflictMarkers.push({id,path:relativePath,line:conflictMarker.line,detail:`unresolved merge conflict marker ${conflictMarker.marker}`});return}let latestEntry=null;const lines=raw.split(/\r?\n/).map((line,index)=>({content:line.trim(),number:index+1})).filter(line=>line.content.length>0);for(const line of lines){try{const parsed=JSON.parse(line.content);if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){throw new TypeError("history entry must be an object")}latestEntry=parsed}catch{out.unparseable.push({id,path:relativePath,line:line.number,detail:"history line is not a valid JSON object"});return}}if(latestEntry===null){return}if(latestEntry.op==="delete"&&liveItemIds.has(id)){out.resurrected.push({id,deleted_at:typeof latestEntry.ts==="string"?latestEntry.ts:"",deleted_by:typeof latestEntry.author==="string"?latestEntry.author:""})}if(latestEntry.op==="history_repair"&&Array.isArray(latestEntry.patch)&&latestEntry.patch.length>0){out.repairReconciliations+=1}}function describeFileReadFailure(subject,error){const code=typeof error==="object"&&error!==null&&"code"in error&&typeof error.code==="string"?error.code:"UNKNOWN";return`${subject} could not be read (error code: ${code})`}async function scanHistoryStreams(pmRoot,liveItemIds){const out={conflictMarkers:[],unparseable:[],resurrected:[],repairReconciliations:0,scanned:0};let entries;try{entries=await fs.readdir(path.join(pmRoot,"history"))}catch{return out}for(const entry of entries.sort((left,right)=>left.localeCompare(right))){if(!entry.endsWith(".jsonl")){continue}out.scanned+=1;let raw;try{raw=await fs.readFile(path.join(pmRoot,"history",entry),"utf8")}catch(error){out.unparseable.push({id:entry.slice(0,-".jsonl".length),path:`history/${entry}`,detail:describeFileReadFailure("history stream",error)});continue}scanHistoryStreamContent({id:entry.slice(0,-".jsonl".length),relativePath:`history/${entry}`,liveItemIds,out},raw)}return out}function describeUnparseableJson(raw){const conflictMarker=findFirstMergeConflictMarker(raw);if(conflictMarker){return`unresolved merge conflict marker ${conflictMarker.marker} at line ${conflictMarker.line}`}try{JSON.parse(raw);return null}catch(error){return`invalid JSON (${String(error)})`}}async function scanConfigFiles(pmRoot){const unparseable=[];let scanned=0;let settingsRaw=null;try{settingsRaw=await readFileIfExists(getSettingsPath(pmRoot))}catch(error){scanned+=1;unparseable.push({path:"settings.json",detail:describeFileReadFailure("configuration file",error)})}if(settingsRaw!==null){scanned+=1;const detail=describeUnparseableJson(settingsRaw);if(detail!==null){unparseable.push({path:"settings.json",detail})}}let schemaEntries;try{schemaEntries=await fs.readdir(path.join(pmRoot,"schema"))}catch{return{scanned,unparseable}}for(const entry of schemaEntries.sort((left,right)=>left.localeCompare(right))){if(!entry.endsWith(".json")){continue}scanned+=1;let raw;try{raw=await fs.readFile(path.join(pmRoot,"schema",entry),"utf8")}catch(error){unparseable.push({path:`schema/${entry}`,detail:describeFileReadFailure("configuration file",error)});continue}const detail=describeUnparseableJson(raw);if(detail!==null){unparseable.push({path:`schema/${entry}`,detail})}}return{scanned,unparseable}}async function scanStorageIntegrity(pmRoot,parsedItemIds,typeToFolder,itemParseOptions={}){const itemFiles=await listItemFilesOnDisk(pmRoot,typeToFolder);const idsOnDisk=new Set(itemFiles.map(file=>file.id));const pathsById=new Map;for(const file of itemFiles){const paths=pathsById.get(file.id);if(paths===void 0){pathsById.set(file.id,[file.relativePath])}else{paths.push(file.relativePath)}}const duplicateItemIds=[...pathsById.entries()].filter(([,paths])=>paths.length>1).map(([id,paths])=>({id,paths:[...paths].sort((left,right)=>left.localeCompare(right))})).sort((left,right)=>left.id.localeCompare(right.id));const unreadableItemFiles=(await Promise.all(itemFiles.map(async file=>{if(!parsedItemIds.has(file.id)){return{path:file.relativePath,id:file.id}}try{const absolutePath=path.join(pmRoot,file.relativePath);parseItemDocument(await fs.readFile(absolutePath,"utf8"),{format:absolutePath.toLowerCase().endsWith(".md")?"json_markdown":"toon",schema:itemParseOptions.schema,extensionFieldNames:itemParseOptions.extensionFieldNames});return null}catch{return{path:file.relativePath,id:file.id}}}))).filter(row=>row!==null);const historyScan=await scanHistoryStreams(pmRoot,idsOnDisk);const configScan=await scanConfigFiles(pmRoot);return{item_files_on_disk:itemFiles.length,item_ids_on_disk:idsOnDisk.size,parsed_items:parsedItemIds.size,unreadable_item_files:unreadableItemFiles,duplicate_item_ids:duplicateItemIds,history_streams_scanned:historyScan.scanned,history_conflict_marker_streams:historyScan.conflictMarkers,history_unparseable_streams:historyScan.unparseable,resurrected_items:historyScan.resurrected,history_repair_reconciliations:historyScan.repairReconciliations,config_files_scanned:configScan.scanned,unparseable_config_files:configScan.unparseable}}export{scanStorageIntegrity};
 //# sourceMappingURL=storage-integrity.js.map
-//# debugId=59b566d5-1d4f-500b-98e3-004e6f57d2b4

package/dist/sdk/governance/tracked-runtime-cache.js

@@ -1,107 +1,2 @@
-/**
- * @module sdk/governance/tracked-runtime-cache
- *
- * Detects clone-local tracker runtime artifacts that were committed before the
- * managed `.gitignore` fence existed. The scan is read-only and returns only
- * repository-relative paths so health and validation output stays portable.
- */
-
-!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]="d18b51d7-294a-52da-b1cf-a10f24aefbc9")}catch(e){}}();
-import { execFile } from "node:child_process";
-import { realpath } from "node:fs/promises";
-import path from "node:path";
-import { promisify } from "node:util";
-import { PM_GITIGNORE_RUNTIME_DIRECTORIES } from "../workspace.js";
-import { findGitWorkspaceRoot } from "../merge/install.js";
-const execFileAsync = promisify(execFile);
-const GIT_LS_FILES_MAX_BUFFER = 32 * 1024 * 1024;
-const GIT_LS_FILES_TIMEOUT_MS = 10_000;
-const TRACKED_RUNTIME_AUTHORITATIVE_PATHS = [
-    "search/eval-queries.json",
-];
-function toPosixPath(value) {
-    return value.replaceAll("\\", "/").replace(/\/+$/, "");
-}
-function quoteShellArgument(value) {
-    return `'${value.replaceAll("'", "'\\''")}'`;
-}
-/** Resolves a tracker root while retaining a deterministic fallback for missing paths. */
-export async function resolveCanonicalTrackerRoot(pmRoot, resolver = realpath) {
-    return resolver(pmRoot).catch(() => path.resolve(pmRoot));
-}
-/**
- * Find tracked files below every clone-local tracker directory.
- *
- * A non-Git tracker, a tracker outside the enclosing repository, or an
- * unavailable Git executable yields an empty scan rather than turning project
- * health into an infrastructure failure.
- */
-export async function scanTrackedRuntimeCache(pmRoot) {
-    const gitWorkspaceRoot = await findGitWorkspaceRoot(pmRoot);
-    if (gitWorkspaceRoot === null) {
-        return {
-            git_workspace_root: null,
-            tracker_relative_root: null,
-            tracked_paths: [],
-            tracked_path_count: 0,
-            remediation_command: null,
-        };
-    }
-    const canonicalPmRoot = await resolveCanonicalTrackerRoot(pmRoot);
-    const trackerRelativeRoot = toPosixPath(path.relative(gitWorkspaceRoot, canonicalPmRoot));
-    if (trackerRelativeRoot.length === 0) {
-        return {
-            git_workspace_root: gitWorkspaceRoot,
-            tracker_relative_root: null,
-            tracked_paths: [],
-            tracked_path_count: 0,
-            remediation_command: null,
-        };
-    }
-    const runtimeDirectories = PM_GITIGNORE_RUNTIME_DIRECTORIES.map((directory) => `${trackerRelativeRoot}/${toPosixPath(directory)}`);
-    try {
-        const { stdout } = await execFileAsync("git", [
-            "ls-files",
-            "-z",
-            "--",
-            ...runtimeDirectories.map((directory) => `:(literal)${directory}`),
-        ], {
-            cwd: gitWorkspaceRoot,
-            encoding: "utf8",
-            maxBuffer: GIT_LS_FILES_MAX_BUFFER,
-            windowsHide: true,
-            timeout: GIT_LS_FILES_TIMEOUT_MS,
-        });
-        const authoritativePaths = new Set(TRACKED_RUNTIME_AUTHORITATIVE_PATHS.map((relativePath) => `${trackerRelativeRoot}/${relativePath}`));
-        const trackedPaths = [
-            ...new Set(stdout
-                .split("\0")
-                .filter((entry) => entry.length > 0 && !authoritativePaths.has(toPosixPath(entry)))),
-        ].sort((left, right) => left.localeCompare(right));
-        const trackedRuntimeDirectories = runtimeDirectories.filter((directory) => trackedPaths.some((trackedPath) => trackedPath === directory || trackedPath.startsWith(`${directory}/`)));
-        return {
-            git_workspace_root: gitWorkspaceRoot,
-            tracker_relative_root: trackerRelativeRoot,
-            tracked_paths: trackedPaths,
-            tracked_path_count: trackedPaths.length,
-            remediation_command: trackedPaths.length === 0
-                ? null
-                : `git rm --cached -r -- ${trackedRuntimeDirectories
-                    .map((directory) => quoteShellArgument(`:(literal)${directory}`))
-                    .join(" ")}`,
-        };
-    }
-    catch {
-        /* c8 ignore start -- Git executable failures are environment-specific; the contract is an empty non-blocking scan. */
-        return {
-            git_workspace_root: gitWorkspaceRoot,
-            tracker_relative_root: trackerRelativeRoot,
-            tracked_paths: [],
-            tracked_path_count: 0,
-            remediation_command: null,
-        };
-        /* c8 ignore stop */
-    }
-}
+!(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]="be96ba6f-f848-58bf-8a3b-b6e3d6ab4b7a")}catch(e2){}})();import{execFile}from"node:child_process";import{realpath}from"node:fs/promises";import path from"node:path";import{promisify}from"node:util";import{PM_GITIGNORE_RUNTIME_DIRECTORIES}from"../workspace.js";import{findGitWorkspaceRoot}from"../merge/install.js";const execFileAsync=promisify(execFile);const GIT_LS_FILES_MAX_BUFFER=32*1024*1024;const GIT_LS_FILES_TIMEOUT_MS=1e4;const TRACKED_RUNTIME_AUTHORITATIVE_PATHS=["search/eval-queries.json"];function toPosixPath(value){return value.replaceAll("\\","/").replace(/\/+$/,"")}function quoteShellArgument(value){return`'${value.replaceAll("'","'\\''")}'`}async function resolveCanonicalTrackerRoot(pmRoot,resolver=realpath){return resolver(pmRoot).catch(()=>path.resolve(pmRoot))}async function scanTrackedRuntimeCache(pmRoot){const gitWorkspaceRoot=await findGitWorkspaceRoot(pmRoot);if(gitWorkspaceRoot===null){return{git_workspace_root:null,tracker_relative_root:null,tracked_paths:[],tracked_path_count:0,remediation_command:null}}const canonicalPmRoot=await resolveCanonicalTrackerRoot(pmRoot);const trackerRelativeRoot=toPosixPath(path.relative(gitWorkspaceRoot,canonicalPmRoot));if(trackerRelativeRoot.length===0){return{git_workspace_root:gitWorkspaceRoot,tracker_relative_root:null,tracked_paths:[],tracked_path_count:0,remediation_command:null}}const runtimeDirectories=PM_GITIGNORE_RUNTIME_DIRECTORIES.map(directory=>`${trackerRelativeRoot}/${toPosixPath(directory)}`);try{const{stdout}=await execFileAsync("git",["ls-files","-z","--",...runtimeDirectories.map(directory=>`:(literal)${directory}`)],{cwd:gitWorkspaceRoot,encoding:"utf8",maxBuffer:GIT_LS_FILES_MAX_BUFFER,windowsHide:true,timeout:GIT_LS_FILES_TIMEOUT_MS});const authoritativePaths=new Set(TRACKED_RUNTIME_AUTHORITATIVE_PATHS.map(relativePath=>`${trackerRelativeRoot}/${relativePath}`));const trackedPaths=[...new Set(stdout.split("\0").filter(entry=>entry.length>0&&!authoritativePaths.has(toPosixPath(entry))))].sort((left,right)=>left.localeCompare(right));const trackedRuntimeDirectories=runtimeDirectories.filter(directory=>trackedPaths.some(trackedPath=>trackedPath===directory||trackedPath.startsWith(`${directory}/`)));return{git_workspace_root:gitWorkspaceRoot,tracker_relative_root:trackerRelativeRoot,tracked_paths:trackedPaths,tracked_path_count:trackedPaths.length,remediation_command:trackedPaths.length===0?null:`git rm --cached -r -- ${trackedRuntimeDirectories.map(directory=>quoteShellArgument(`:(literal)${directory}`)).join(" ")}`}}catch{return{git_workspace_root:gitWorkspaceRoot,tracker_relative_root:trackerRelativeRoot,tracked_paths:[],tracked_path_count:0,remediation_command:null}}}export{resolveCanonicalTrackerRoot,scanTrackedRuntimeCache};
 //# sourceMappingURL=tracked-runtime-cache.js.map
-//# debugId=d18b51d7-294a-52da-b1cf-a10f24aefbc9