@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/cli/commands/history-repair.js

@@ -0,0 +1,166 @@
+
+!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]="e227bfe2-45fa-5ebf-a43d-cb679ecbe106")}catch(e){}}();
+import fs from "node:fs/promises";
+import jsonPatch from "fast-json-patch";
+import { pathExists, readFileIfExists, writeFileAtomic } from "../../core/fs/fs-utils.js";
+import { historyEntriesToRaw, reanchorHistoryEntries, replayHash, toReplayDocument, verifyHistoryChain, } from "../../core/history/replay.js";
+import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
+import { acquireLock } from "../../core/lock/lock.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { nowIso } from "../../core/shared/time.js";
+import { getActiveExtensionRegistrations, runActiveOnWriteHooks } from "../../core/extensions/index.js";
+import { readLocatedItem } from "../../core/store/item-store.js";
+import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings, resolveGovernanceKnobs } from "../../core/store/settings.js";
+import { readHistoryEntries } from "./history.js";
+import { resolveHistorySubject } from "./history-redact.js";
+function toAuthor(candidate, defaultAuthor) {
+    const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;
+    const trimmed = resolved.trim();
+    return trimmed.length > 0 ? trimmed : "unknown";
+}
+export async function runHistoryRepair(id, options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+    const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);
+    if (!(await pathExists(subject.historyPath))) {
+        throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);
+    }
+    const historyEntries = await readHistoryEntries(subject.historyPath, subject.id);
+    if (historyEntries.length === 0) {
+        throw new PmCliError(`No history entries exist for ${subject.id}; nothing to repair.`, EXIT_CODE.USAGE);
+    }
+    const chainBefore = verifyHistoryChain(historyEntries);
+    const reanchor = reanchorHistoryEntries(historyEntries);
+    // Reconcile the replayed chain with the current on-disk item document so the
+    // latest after_hash matches what pm validate/health compute for the item.
+    let currentItemReplay = null;
+    const currentItemPath = subject.located?.itemPath ?? null;
+    let matchedChainBefore = null;
+    const loadedItem = subject.located
+        ? await readLocatedItem(subject.located, { schema: settings.schema })
+        : null;
+    if (loadedItem) {
+        // Use the shared canonical replay form so reconciliation hashing matches the
+        // semantics pm validate/health use for the on-disk item (avoids hash divergence).
+        currentItemReplay = toReplayDocument(loadedItem.document);
+        const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;
+        matchedChainBefore = replayHash(currentItemReplay) === lastOriginalAfterHash;
+    }
+    const finalReplay = reanchor.finalDocument;
+    const reconcileNeeded = currentItemReplay !== null && replayHash(finalReplay) !== replayHash(currentItemReplay);
+    const changed = reanchor.entriesRehashed > 0 || reanchor.entriesPatchRepaired > 0 || reconcileNeeded;
+    const author = toAuthor(options.author, settings.author_default);
+    const dryRun = Boolean(options.dryRun);
+    const repairMessage = typeof options.message === "string" && options.message.trim().length > 0
+        ? options.message
+        : `history-repair re-anchored ${reanchor.entriesRehashed} entr${reanchor.entriesRehashed === 1 ? "y" : "ies"}${reanchor.entriesPatchRepaired > 0 ? `, repaired ${reanchor.entriesPatchRepaired} patch(es)` : ""}${reconcileNeeded ? ", reconciled chain with on-disk item" : ""}.`;
+    const rewrittenEntries = [...reanchor.entries];
+    let auditEntryAdded = false;
+    if (changed) {
+        if (reconcileNeeded && currentItemReplay) {
+            rewrittenEntries.push({
+                ts: nowIso(),
+                author,
+                op: "history_repair",
+                patch: jsonPatch.compare(finalReplay, currentItemReplay),
+                before_hash: replayHash(finalReplay),
+                after_hash: replayHash(currentItemReplay),
+                message: repairMessage,
+            });
+        }
+        else {
+            rewrittenEntries.push({
+                ts: nowIso(),
+                author,
+                op: "history_repair",
+                patch: [],
+                before_hash: replayHash(finalReplay),
+                after_hash: replayHash(finalReplay),
+                message: repairMessage,
+            });
+        }
+        auditEntryAdded = true;
+    }
+    const historyVerify = verifyHistoryChain(rewrittenEntries);
+    if (!historyVerify.ok) {
+        throw new PmCliError(`history-repair produced an invalid rewritten chain (${historyVerify.errors.join(", ")}).`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    const warnings = [];
+    if (!changed) {
+        warnings.push("history_repair_no_changes");
+    }
+    if (reanchor.skippedOps > 0) {
+        warnings.push(`history_repair_skipped_unresolvable_ops:${reanchor.skippedOps}`);
+    }
+    if (changed && !dryRun) {
+        if (loadedItem) {
+            const governance = resolveGovernanceKnobs(settings);
+            const assigned = loadedItem.document.metadata.assignee?.trim();
+            if (assigned && assigned !== author && !options.force) {
+                if (governance.ownership_enforcement === "strict") {
+                    throw new PmCliError(`Item ${subject.id} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
+                }
+                if (governance.ownership_enforcement === "warn") {
+                    warnings.push(`ownership_warning:assignee_conflict:${subject.id}:${assigned}`);
+                }
+            }
+        }
+        const releaseLock = await acquireLock(pmRoot, subject.id, settings.locks.ttl_seconds, author, Boolean(options.force), settings.governance.force_required_for_stale_lock);
+        try {
+            const previousHistoryRaw = await readFileIfExists(subject.historyPath);
+            try {
+                await writeFileAtomic(subject.historyPath, historyEntriesToRaw(rewrittenEntries));
+            }
+            catch (error) {
+                if (previousHistoryRaw === null) {
+                    await fs.rm(subject.historyPath, { force: true });
+                }
+                else {
+                    await writeFileAtomic(subject.historyPath, previousHistoryRaw);
+                }
+                throw error;
+            }
+            warnings.push(...(await runActiveOnWriteHooks({
+                path: subject.historyPath,
+                scope: "project",
+                op: "history_repair:history",
+            })));
+        }
+        finally {
+            await releaseLock();
+        }
+    }
+    return {
+        id: subject.id,
+        dry_run: dryRun,
+        changed,
+        history: {
+            path: subject.historyPath,
+            entries_scanned: historyEntries.length,
+            chain_drift_before: !chainBefore.ok,
+            entries_rehashed: reanchor.entriesRehashed,
+            entries_patch_repaired: reanchor.entriesPatchRepaired,
+            converted_replace_to_add: reanchor.convertedReplaceToAdd,
+            skipped_ops: reanchor.skippedOps,
+            reconciled_with_item: reconcileNeeded,
+            audit_entry_added: auditEntryAdded,
+            verify_ok: historyVerify.ok,
+            verify_errors: historyVerify.errors,
+        },
+        item: {
+            exists: currentItemPath !== null,
+            path: currentItemPath,
+            matched_chain_before: matchedChainBefore,
+        },
+        warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
+        generated_at: nowIso(),
+    };
+}
+//# sourceMappingURL=history-repair.js.map
+//# debugId=e227bfe2-45fa-5ebf-a43d-cb679ecbe106

package/dist/cli/commands/history-repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-repair.js","sources":["cli/commands/history-repair.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport jsonPatch from \"fast-json-patch\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport {\n  historyEntriesToRaw,\n  reanchorHistoryEntries,\n  replayHash,\n  toReplayDocument,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { acquireLock } from \"../../core/lock/lock.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings, resolveGovernanceKnobs } from \"../../core/store/settings.js\";\nimport type { HistoryEntry, HistoryPatchOp } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\nexport interface HistoryRepairCommandOptions {\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface HistoryRepairResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\n  history: {\n    path: string;\n    entries_scanned: number;\n    chain_drift_before: boolean;\n    entries_rehashed: number;\n    entries_patch_repaired: number;\n    converted_replace_to_add: number;\n    skipped_ops: number;\n    reconciled_with_item: boolean;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed.length > 0 ? trimmed : \"unknown\";\n}\n\nexport async function runHistoryRepair(\n  id: string,\n  options: HistoryRepairCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRepairResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyEntries = await readHistoryEntries(subject.historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to repair.`, EXIT_CODE.USAGE);\n  }\n\n  const chainBefore = verifyHistoryChain(historyEntries);\n  const reanchor = reanchorHistoryEntries(historyEntries);\n\n  // Reconcile the replayed chain with the current on-disk item document so the\n  // latest after_hash matches what pm validate/health compute for the item.\n  let currentItemReplay: ReplayDocument | null = null;\n  const currentItemPath: string | null = subject.located?.itemPath ?? null;\n  let matchedChainBefore: boolean | null = null;\n  const loadedItem = subject.located\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : null;\n  if (loadedItem) {\n    // Use the shared canonical replay form so reconciliation hashing matches the\n    // semantics pm validate/health use for the on-disk item (avoids hash divergence).\n    currentItemReplay = toReplayDocument(loadedItem.document);\n    const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;\n    matchedChainBefore = replayHash(currentItemReplay) === lastOriginalAfterHash;\n  }\n\n  const finalReplay = reanchor.finalDocument;\n  const reconcileNeeded =\n    currentItemReplay !== null && replayHash(finalReplay) !== replayHash(currentItemReplay);\n\n  const changed = reanchor.entriesRehashed > 0 || reanchor.entriesPatchRepaired > 0 || reconcileNeeded;\n  const author = toAuthor(options.author, settings.author_default);\n  const dryRun = Boolean(options.dryRun);\n\n  const repairMessage =\n    typeof options.message === \"string\" && options.message.trim().length > 0\n      ? options.message\n      : `history-repair re-anchored ${reanchor.entriesRehashed} entr${\n          reanchor.entriesRehashed === 1 ? \"y\" : \"ies\"\n        }${reanchor.entriesPatchRepaired > 0 ? `, repaired ${reanchor.entriesPatchRepaired} patch(es)` : \"\"}${\n          reconcileNeeded ? \", reconciled chain with on-disk item\" : \"\"\n        }.`;\n\n  const rewrittenEntries: HistoryEntry[] = [...reanchor.entries];\n  let auditEntryAdded = false;\n  if (changed) {\n    if (reconcileNeeded && currentItemReplay) {\n      rewrittenEntries.push({\n        ts: nowIso(),\n        author,\n        op: \"history_repair\",\n        patch: jsonPatch.compare(finalReplay, currentItemReplay) as HistoryPatchOp[],\n        before_hash: replayHash(finalReplay),\n        after_hash: replayHash(currentItemReplay),\n        message: repairMessage,\n      });\n    } else {\n      rewrittenEntries.push({\n        ts: nowIso(),\n        author,\n        op: \"history_repair\",\n        patch: [],\n        before_hash: replayHash(finalReplay),\n        after_hash: replayHash(finalReplay),\n        message: repairMessage,\n      });\n    }\n    auditEntryAdded = true;\n  }\n\n  const historyVerify = verifyHistoryChain(rewrittenEntries);\n  if (!historyVerify.ok) {\n    throw new PmCliError(\n      `history-repair produced an invalid rewritten chain (${historyVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n\n  const warnings: string[] = [];\n  if (!changed) {\n    warnings.push(\"history_repair_no_changes\");\n  }\n  if (reanchor.skippedOps > 0) {\n    warnings.push(`history_repair_skipped_unresolvable_ops:${reanchor.skippedOps}`);\n  }\n\n  if (changed && !dryRun) {\n    if (loadedItem) {\n      const governance = resolveGovernanceKnobs(settings);\n      const assigned = loadedItem.document.metadata.assignee?.trim();\n      if (assigned && assigned !== author && !options.force) {\n        if (governance.ownership_enforcement === \"strict\") {\n          throw new PmCliError(\n            `Item ${subject.id} is assigned to ${assigned}. Use --force to override.`,\n            EXIT_CODE.CONFLICT,\n          );\n        }\n        if (governance.ownership_enforcement === \"warn\") {\n          warnings.push(`ownership_warning:assignee_conflict:${subject.id}:${assigned}`);\n        }\n      }\n    }\n\n    const releaseLock = await acquireLock(\n      pmRoot,\n      subject.id,\n      settings.locks.ttl_seconds,\n      author,\n      Boolean(options.force),\n      settings.governance.force_required_for_stale_lock,\n    );\n    try {\n      const previousHistoryRaw = await readFileIfExists(subject.historyPath);\n      try {\n        await writeFileAtomic(subject.historyPath, historyEntriesToRaw(rewrittenEntries));\n      } catch (error) {\n        if (previousHistoryRaw === null) {\n          await fs.rm(subject.historyPath, { force: true });\n        } else {\n          await writeFileAtomic(subject.historyPath, previousHistoryRaw);\n        }\n        throw error;\n      }\n      warnings.push(\n        ...(await runActiveOnWriteHooks({\n          path: subject.historyPath,\n          scope: \"project\",\n          op: \"history_repair:history\",\n        })),\n      );\n    } finally {\n      await releaseLock();\n    }\n  }\n\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    history: {\n      path: subject.historyPath,\n      entries_scanned: historyEntries.length,\n      chain_drift_before: !chainBefore.ok,\n      entries_rehashed: reanchor.entriesRehashed,\n      entries_patch_repaired: reanchor.entriesPatchRepaired,\n      converted_replace_to_add: reanchor.convertedReplaceToAdd,\n      skipped_ops: reanchor.skippedOps,\n      reconciled_with_item: reconcileNeeded,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: historyVerify.ok,\n      verify_errors: historyVerify.errors,\n    },\n    item: {\n      exists: currentItemPath !== null,\n      path: currentItemPath,\n      matched_chain_before: matchedChainBefore,\n    },\n    warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"e227bfe2-45fa-5ebf-a43d-cb679ecbe106"}

package/dist/cli/commands/history.d.ts

@@ -1,9 +1,11 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import type { HistoryEntry } from "../../types/index.js";
+export { verifyHistoryChain } from "../../core/history/replay.js";
 export interface HistoryCommandOptions {
     limit?: string;
     diff?: boolean;
     verify?: boolean;
+    compact?: boolean;
 }
 export interface HistoryDiffEntry {
     index: number;
@@ -24,6 +26,8 @@ export interface HistoryVerificationResult {
 export interface HistoryResult {
     id: string;
     history: HistoryEntry[];
+    compact_history?: HistoryDiffEntry[];
+    compact: boolean;
     count: number;
     limit: number | null;
     diff?: HistoryDiffEntry[];

package/dist/cli/commands/history.js

@@ -1,6 +1,8 @@
-import jsonPatch from "fast-json-patch";
+
+!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]="7dab57b7-674a-5649-ac20-6307a59ce87d")}catch(e){}}();
 import { pathExists, readFileIfExists } from "../../core/fs/fs-utils.js";
 import { hashDocument, hashEmptyDocument } from "../../core/history/history.js";
+import { verifyHistoryChain } from "../../core/history/replay.js";
 import { enforceHistoryStreamPolicyForItem } from "../../core/history/history-stream-policy.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { findFirstMergeConflictMarker } from "../../core/shared/conflict-markers.js";
@@ -12,10 +14,7 @@ import { locateItem, readLocatedItem } from "../../core/store/item-store.js";
 import { getHistoryPath, getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 import { parseLimit } from "../shared-parsers.js";
-const EMPTY_REPLAY_DOCUMENT = {
-    metadata: {},
-    body: "",
-};
+export { verifyHistoryChain } from "../../core/history/replay.js";
 function limitEntries(values, limit) {
     if (limit === undefined)
         return values;
@@ -60,77 +59,6 @@ function buildDiffEntries(entries, startIndex) {
         };
     });
 }
-function replayHash(document) {
-    const itemDocument = {
-        metadata: document.metadata,
-        body: document.body,
-    };
-    return hashDocument(itemDocument);
-}
-function normalizeReplayPatchPath(path) {
-    if (path === "/front_matter") {
-        return "/metadata";
-    }
-    if (path.startsWith("/front_matter/")) {
-        return `/metadata/${path.slice("/front_matter/".length)}`;
-    }
-    return path;
-}
-function normalizeReplayPatchOps(patch) {
-    return patch.map((operation) => ({
-        ...operation,
-        path: normalizeReplayPatchPath(operation.path),
-        from: operation.from ? normalizeReplayPatchPath(operation.from) : undefined,
-    }));
-}
-function applyHistoryPatch(current, patch, entryNumber) {
-    try {
-        const normalizedPatch = normalizeReplayPatchOps(patch);
-        const applied = jsonPatch.applyPatch(structuredClone(current), normalizedPatch, true, false).newDocument;
-        if (typeof applied !== "object" ||
-            applied === null ||
-            !("metadata" in applied) ||
-            !("body" in applied) ||
-            typeof applied.body !== "string" ||
-            typeof applied.metadata !== "object" ||
-            applied.metadata === null) {
-            throw new PmCliError(`History replay produced an invalid document shape at entry ${entryNumber}.`, EXIT_CODE.GENERIC_FAILURE);
-        }
-        const replay = applied;
-        return {
-            metadata: replay.metadata,
-            body: replay.body,
-        };
-    }
-    catch {
-        throw new PmCliError(`Failed to apply history patch at entry ${entryNumber}.`, EXIT_CODE.GENERIC_FAILURE);
-    }
-}
-function verifyHistoryChain(entries) {
-    let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);
-    for (let index = 0; index < entries.length; index += 1) {
-        const entry = entries[index];
-        const beforeHash = replayHash(replay);
-        if (beforeHash !== entry.before_hash) {
-            return {
-                ok: false,
-                errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`],
-            };
-        }
-        replay = applyHistoryPatch(replay, entry.patch, index + 1);
-        const afterHash = replayHash(replay);
-        if (afterHash !== entry.after_hash) {
-            return {
-                ok: false,
-                errors: [`verify_failed:after_hash_mismatch:entry_${index + 1}`],
-            };
-        }
-    }
-    return {
-        ok: true,
-        errors: [],
-    };
-}
 export async function readHistoryEntries(historyPath, itemId) {
     const raw = await readFileIfExists(historyPath);
     if (raw === null) {
@@ -193,14 +121,18 @@ export async function runHistory(id, options, global) {
     }
     const fullHistory = await readHistoryEntries(historyPath, resolvedId);
     const history = limitEntries(fullHistory, limit);
+    const compact = options.compact === true;
+    const compactHistory = compact ? buildDiffEntries(history, Math.max(0, fullHistory.length - history.length)) : undefined;
     const result = {
         id: resolvedId,
-        history,
+        history: compact ? [] : history,
+        compact_history: compactHistory,
+        compact,
         count: history.length,
         limit: limit ?? null,
     };
     if (options.diff) {
-        result.diff = buildDiffEntries(history, Math.max(0, fullHistory.length - history.length));
+        result.diff = compact ? [] : buildDiffEntries(history, Math.max(0, fullHistory.length - history.length));
     }
     if (options.verify) {
         const verification = verifyHistoryChain(fullHistory);
@@ -227,4 +159,5 @@ export async function runHistory(id, options, global) {
     }
     return result;
 }
-//# sourceMappingURL=history.js.map
+//# sourceMappingURL=history.js.map
+//# debugId=7dab57b7-674a-5649-ac20-6307a59ce87d

package/dist/cli/commands/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"/","sources":["cli/commands/history.ts"],"names":[],"mappings":"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","sourcesContent":["import jsonPatch from \"fast-json-patch\";\nimport { pathExists, readFileIfExists } from \"../../core/fs/fs-utils.js\";\nimport { hashDocument, hashEmptyDocument } from \"../../core/history/history.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { findFirstMergeConflictMarker } from \"../../core/shared/conflict-markers.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport { normalizeItemId } from \"../../core/item/id.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument } from \"../../types/index.js\";\n\nexport interface HistoryCommandOptions {\n  limit?: string;\n  diff?: boolean;\n  verify?: boolean;\n}\n\nexport interface HistoryDiffEntry {\n  index: number;\n  ts: string;\n  op: string;\n  author: string;\n  patch_ops: number;\n  changed_fields: string[];\n}\n\nexport interface HistoryVerificationResult {\n  ok: boolean;\n  entries: number;\n  errors: string[];\n  latest_after_hash?: string;\n  current_item_hash?: string;\n  current_matches_latest?: boolean;\n}\n\nexport interface HistoryResult {\n  id: string;\n  history: HistoryEntry[];\n  count: number;\n  limit: number | null;\n  diff?: HistoryDiffEntry[];\n  verification?: HistoryVerificationResult;\n}\n\ninterface ReplayDocument {\n  metadata: Record<string, unknown>;\n  body: string;\n}\n\nconst EMPTY_REPLAY_DOCUMENT: ReplayDocument = {\n  metadata: {},\n  body: \"\",\n};\n\nfunction limitEntries<T>(values: T[], limit: number | undefined): T[] {\n  if (limit === undefined) return values;\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nfunction decodeJsonPointerSegment(segment: string): string {\n  return segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n}\n\nfunction patchPathToChangedField(path: string): string {\n  if (path === \"/body\" || path.startsWith(\"/body/\")) {\n    return \"body\";\n  }\n  if (\n    path === \"/metadata\" ||\n    path.startsWith(\"/metadata/\") ||\n    path === \"/front_matter\" ||\n    path.startsWith(\"/front_matter/\")\n  ) {\n    const segment = path.replace(/^\\/(?:metadata|front_matter)\\/?/, \"\").split(\"/\")[0];\n    if (!segment) {\n      return \"metadata\";\n    }\n    return decodeJsonPointerSegment(segment);\n  }\n  const segment = path.replace(/^\\//, \"\").split(\"/\")[0];\n  return segment ? decodeJsonPointerSegment(segment) : \"root\";\n}\n\nfunction buildDiffEntries(entries: HistoryEntry[], startIndex: number): HistoryDiffEntry[] {\n  return entries.map((entry, index) => {\n    const changedFields = new Set<string>();\n    for (const op of entry.patch) {\n      changedFields.add(patchPathToChangedField(op.path));\n      if (op.from) {\n        changedFields.add(patchPathToChangedField(op.from));\n      }\n    }\n    return {\n      index: startIndex + index + 1,\n      ts: entry.ts,\n      op: entry.op,\n      author: entry.author,\n      patch_ops: entry.patch.length,\n      changed_fields: [...changedFields].sort((left, right) => left.localeCompare(right)),\n    };\n  });\n}\n\nfunction replayHash(document: ReplayDocument): string {\n  const itemDocument: ItemDocument = {\n    metadata: document.metadata as unknown as ItemDocument[\"metadata\"],\n    body: document.body,\n  };\n  return hashDocument(itemDocument);\n}\n\nfunction normalizeReplayPatchPath(path: string): string {\n  if (path === \"/front_matter\") {\n    return \"/metadata\";\n  }\n  if (path.startsWith(\"/front_matter/\")) {\n    return `/metadata/${path.slice(\"/front_matter/\".length)}`;\n  }\n  return path;\n}\n\nfunction normalizeReplayPatchOps(patch: HistoryPatchOp[]): HistoryPatchOp[] {\n  return patch.map((operation) => ({\n    ...operation,\n    path: normalizeReplayPatchPath(operation.path),\n    from: operation.from ? normalizeReplayPatchPath(operation.from) : undefined,\n  }));\n}\n\nfunction applyHistoryPatch(current: ReplayDocument, patch: HistoryPatchOp[], entryNumber: number): ReplayDocument {\n  try {\n    const normalizedPatch = normalizeReplayPatchOps(patch);\n    const applied = jsonPatch.applyPatch(\n      structuredClone(current),\n      normalizedPatch as jsonPatch.Operation[],\n      true,\n      false,\n    ).newDocument as unknown;\n    if (\n      typeof applied !== \"object\" ||\n      applied === null ||\n      !(\"metadata\" in applied) ||\n      !(\"body\" in applied) ||\n      typeof (applied as { body: unknown }).body !== \"string\" ||\n      typeof (applied as { metadata: unknown }).metadata !== \"object\" ||\n      (applied as { metadata: unknown }).metadata === null\n    ) {\n      throw new PmCliError(\n        `History replay produced an invalid document shape at entry ${entryNumber}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    const replay = applied as { metadata: Record<string, unknown>; body: string };\n    return {\n      metadata: replay.metadata,\n      body: replay.body,\n    };\n  } catch {\n    throw new PmCliError(`Failed to apply history patch at entry ${entryNumber}.`, EXIT_CODE.GENERIC_FAILURE);\n  }\n}\n\nfunction verifyHistoryChain(entries: HistoryEntry[]): { ok: boolean; errors: string[] } {\n  let replay: ReplayDocument = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    const beforeHash = replayHash(replay);\n    if (beforeHash !== entry.before_hash) {\n      return {\n        ok: false,\n        errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`],\n      };\n    }\n    replay = applyHistoryPatch(replay, entry.patch, index + 1);\n    const afterHash = replayHash(replay);\n    if (afterHash !== entry.after_hash) {\n      return {\n        ok: false,\n        errors: [`verify_failed:after_hash_mismatch:entry_${index + 1}`],\n      };\n    }\n  }\n  return {\n    ok: true,\n    errors: [],\n  };\n}\n\nexport async function readHistoryEntries(historyPath: string, itemId: string): Promise<HistoryEntry[]> {\n  const raw = await readFileIfExists(historyPath);\n  if (raw === null) {\n    return [];\n  }\n  await runActiveOnReadHooks({\n    path: historyPath,\n    scope: \"project\",\n  });\n  if (raw.trim() === \"\") {\n    return [];\n  }\n  const conflictMarker = findFirstMergeConflictMarker(raw);\n  if (conflictMarker) {\n    throw new PmCliError(\n      `History for ${itemId} contains merge conflict markers at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`,\n      EXIT_CODE.GENERIC_FAILURE,\n      {\n        code: \"history_merge_conflict_markers_detected\",\n        required: \"Repair the history stream by resolving merge-conflict markers.\",\n        why: \"Conflict markers break JSONL parsing and invalidate deterministic audit history.\",\n        examples: [`pm history ${itemId}`, `pm restore ${itemId} <timestamp-or-version>`],\n        nextSteps: [\"Resolve or restore the history file, then rerun the command.\"],\n      },\n    );\n  }\n\n  const entries: HistoryEntry[] = [];\n  const lines = raw.split(/\\r?\\n/);\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index]?.trim();\n    if (!line) continue;\n    try {\n      entries.push(JSON.parse(line) as HistoryEntry);\n    } catch {\n      throw new PmCliError(\n        `History for ${itemId} contains invalid JSON at line ${index + 1}. Repair or restore the history stream and retry.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n  return entries;\n}\n\nexport async function runHistory(id: string, options: HistoryCommandOptions, global: GlobalOptions): Promise<HistoryResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const limit = parseLimit(options.limit);\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const located = await locateItem(\n    pmRoot,\n    normalizedId,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  const resolvedId = located?.id ?? normalizedId;\n  const historyPath = getHistoryPath(pmRoot, resolvedId);\n  if (!located && !(await pathExists(historyPath))) {\n    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  if (located) {\n    await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"history\",\n    });\n  }\n\n  const fullHistory = await readHistoryEntries(historyPath, resolvedId);\n  const history = limitEntries(fullHistory, limit);\n  const result: HistoryResult = {\n    id: resolvedId,\n    history,\n    count: history.length,\n    limit: limit ?? null,\n  };\n\n  if (options.diff) {\n    result.diff = buildDiffEntries(history, Math.max(0, fullHistory.length - history.length));\n  }\n\n  if (options.verify) {\n    const verification = verifyHistoryChain(fullHistory);\n    const latestAfterHash = fullHistory.length > 0 ? fullHistory[fullHistory.length - 1].after_hash : hashEmptyDocument();\n    let currentItemHash: string | undefined;\n    let currentMatchesLatest: boolean | undefined;\n    const errors = [...verification.errors];\n\n    if (located) {\n      const loaded = await readLocatedItem(located, { schema: settings.schema });\n      currentItemHash = hashDocument(loaded.document);\n      currentMatchesLatest = currentItemHash === latestAfterHash;\n      if (!currentMatchesLatest) {\n        errors.push(\"verify_failed:current_item_hash_mismatch\");\n      }\n    }\n\n    result.verification = {\n      ok: errors.length === 0,\n      entries: fullHistory.length,\n      errors,\n      latest_after_hash: fullHistory.length > 0 ? fullHistory[fullHistory.length - 1].after_hash : undefined,\n      current_item_hash: currentItemHash,\n      current_matches_latest: currentMatchesLatest,\n    };\n  }\n\n  return result;\n}\n"]}
+{"version":3,"file":"history.js","sources":["cli/commands/history.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists, readFileIfExists } from \"../../core/fs/fs-utils.js\";\nimport { hashDocument, hashEmptyDocument } from \"../../core/history/history.js\";\nimport { verifyHistoryChain } from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { findFirstMergeConflictMarker } from \"../../core/shared/conflict-markers.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport { normalizeItemId } from \"../../core/item/id.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\nexport { verifyHistoryChain } from \"../../core/history/replay.js\";\n\nexport interface HistoryCommandOptions {\n  limit?: string;\n  diff?: boolean;\n  verify?: boolean;\n  compact?: boolean;\n}\n\nexport interface HistoryDiffEntry {\n  index: number;\n  ts: string;\n  op: string;\n  author: string;\n  patch_ops: number;\n  changed_fields: string[];\n}\n\nexport interface HistoryVerificationResult {\n  ok: boolean;\n  entries: number;\n  errors: string[];\n  latest_after_hash?: string;\n  current_item_hash?: string;\n  current_matches_latest?: boolean;\n}\n\nexport interface HistoryResult {\n  id: string;\n  history: HistoryEntry[];\n  compact_history?: HistoryDiffEntry[];\n  compact: boolean;\n  count: number;\n  limit: number | null;\n  diff?: HistoryDiffEntry[];\n  verification?: HistoryVerificationResult;\n}\n\nfunction limitEntries<T>(values: T[], limit: number | undefined): T[] {\n  if (limit === undefined) return values;\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nfunction decodeJsonPointerSegment(segment: string): string {\n  return segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n}\n\nfunction patchPathToChangedField(path: string): string {\n  if (path === \"/body\" || path.startsWith(\"/body/\")) {\n    return \"body\";\n  }\n  if (\n    path === \"/metadata\" ||\n    path.startsWith(\"/metadata/\") ||\n    path === \"/front_matter\" ||\n    path.startsWith(\"/front_matter/\")\n  ) {\n    const segment = path.replace(/^\\/(?:metadata|front_matter)\\/?/, \"\").split(\"/\")[0];\n    if (!segment) {\n      return \"metadata\";\n    }\n    return decodeJsonPointerSegment(segment);\n  }\n  const segment = path.replace(/^\\//, \"\").split(\"/\")[0];\n  return segment ? decodeJsonPointerSegment(segment) : \"root\";\n}\n\nfunction buildDiffEntries(entries: HistoryEntry[], startIndex: number): HistoryDiffEntry[] {\n  return entries.map((entry, index) => {\n    const changedFields = new Set<string>();\n    for (const op of entry.patch) {\n      changedFields.add(patchPathToChangedField(op.path));\n      if (op.from) {\n        changedFields.add(patchPathToChangedField(op.from));\n      }\n    }\n    return {\n      index: startIndex + index + 1,\n      ts: entry.ts,\n      op: entry.op,\n      author: entry.author,\n      patch_ops: entry.patch.length,\n      changed_fields: [...changedFields].sort((left, right) => left.localeCompare(right)),\n    };\n  });\n}\n\nexport async function readHistoryEntries(historyPath: string, itemId: string): Promise<HistoryEntry[]> {\n  const raw = await readFileIfExists(historyPath);\n  if (raw === null) {\n    return [];\n  }\n  await runActiveOnReadHooks({\n    path: historyPath,\n    scope: \"project\",\n  });\n  if (raw.trim() === \"\") {\n    return [];\n  }\n  const conflictMarker = findFirstMergeConflictMarker(raw);\n  if (conflictMarker) {\n    throw new PmCliError(\n      `History for ${itemId} contains merge conflict markers at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`,\n      EXIT_CODE.GENERIC_FAILURE,\n      {\n        code: \"history_merge_conflict_markers_detected\",\n        required: \"Repair the history stream by resolving merge-conflict markers.\",\n        why: \"Conflict markers break JSONL parsing and invalidate deterministic audit history.\",\n        examples: [`pm history ${itemId}`, `pm restore ${itemId} <timestamp-or-version>`],\n        nextSteps: [\"Resolve or restore the history file, then rerun the command.\"],\n      },\n    );\n  }\n\n  const entries: HistoryEntry[] = [];\n  const lines = raw.split(/\\r?\\n/);\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index]?.trim();\n    if (!line) continue;\n    try {\n      entries.push(JSON.parse(line) as HistoryEntry);\n    } catch {\n      throw new PmCliError(\n        `History for ${itemId} contains invalid JSON at line ${index + 1}. Repair or restore the history stream and retry.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n  return entries;\n}\n\nexport async function runHistory(id: string, options: HistoryCommandOptions, global: GlobalOptions): Promise<HistoryResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const limit = parseLimit(options.limit);\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const located = await locateItem(\n    pmRoot,\n    normalizedId,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  const resolvedId = located?.id ?? normalizedId;\n  const historyPath = getHistoryPath(pmRoot, resolvedId);\n  if (!located && !(await pathExists(historyPath))) {\n    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  if (located) {\n    await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"history\",\n    });\n  }\n\n  const fullHistory = await readHistoryEntries(historyPath, resolvedId);\n  const history = limitEntries(fullHistory, limit);\n  const compact = options.compact === true;\n  const compactHistory = compact ? buildDiffEntries(history, Math.max(0, fullHistory.length - history.length)) : undefined;\n  const result: HistoryResult = {\n    id: resolvedId,\n    history: compact ? [] : history,\n    compact_history: compactHistory,\n    compact,\n    count: history.length,\n    limit: limit ?? null,\n  };\n\n  if (options.diff) {\n    result.diff = compact ? [] : buildDiffEntries(history, Math.max(0, fullHistory.length - history.length));\n  }\n\n  if (options.verify) {\n    const verification = verifyHistoryChain(fullHistory);\n    const latestAfterHash = fullHistory.length > 0 ? fullHistory[fullHistory.length - 1].after_hash : hashEmptyDocument();\n    let currentItemHash: string | undefined;\n    let currentMatchesLatest: boolean | undefined;\n    const errors = [...verification.errors];\n\n    if (located) {\n      const loaded = await readLocatedItem(located, { schema: settings.schema });\n      currentItemHash = hashDocument(loaded.document);\n      currentMatchesLatest = currentItemHash === latestAfterHash;\n      if (!currentMatchesLatest) {\n        errors.push(\"verify_failed:current_item_hash_mismatch\");\n      }\n    }\n\n    result.verification = {\n      ok: errors.length === 0,\n      entries: fullHistory.length,\n      errors,\n      latest_after_hash: fullHistory.length > 0 ? fullHistory[fullHistory.length - 1].after_hash : undefined,\n      current_item_hash: currentItemHash,\n      current_matches_latest: currentMatchesLatest,\n    };\n  }\n\n  return result;\n}\n"],"names":[],"mappings":"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","debugId":"7dab57b7-674a-5649-ac20-6307a59ce87d"}

package/dist/cli/commands/index.d.ts

@@ -17,10 +17,14 @@ export { runGc } from "./gc.js";
 export { runGet } from "./get.js";
 export { runHealth } from "./health.js";
 export { runHistory } from "./history.js";
-export { runInit } from "./init.js";
+export { runHistoryRedact, type HistoryRedactCommandOptions, type HistoryRedactResult } from "./history-redact.js";
+export { runHistoryRepair, type HistoryRepairCommandOptions, type HistoryRepairResult } from "./history-repair.js";
+export { runInit, summarizeInitResult, type InitConciseResult } from "./init.js";
 export { runLearnings } from "./learnings.js";
 export { runList, type ListOptions } from "./list.js";
 export { runNotes } from "./notes.js";
+export { runPlan, PLAN_SUBCOMMANDS, PLAN_SHOW_DEPTH_VALUES, type PlanCommandOptions, type PlanCommandResult, type PlanDispatchInput, type PlanResultPlan, type PlanStepSummary, type PlanShowDepth, type PlanSubcommand, } from "./plan.js";
+export { runSchemaAddType, formatSchemaAddTypeHuman, SCHEMA_SUBCOMMANDS, type SchemaSubcommand, type SchemaAddTypeCommandOptions, type SchemaAddTypeResult, } from "./schema.js";
 export { runSearch } from "./search.js";
 export { runRestore } from "./restore.js";
 export { runStats } from "./stats.js";

package/dist/cli/commands/index.js

@@ -1,3 +1,5 @@
+
+!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]="976d2cdf-7f8e-5cd9-9146-7fdb15fa1512")}catch(e){}}();
 export { runAppend } from "./append.js";
 export { runAggregate } from "./aggregate.js";
 export { runActivity } from "./activity.js";
@@ -17,10 +19,14 @@ export { runGc } from "./gc.js";
 export { runGet } from "./get.js";
 export { runHealth } from "./health.js";
 export { runHistory } from "./history.js";
-export { runInit } from "./init.js";
+export { runHistoryRedact } from "./history-redact.js";
+export { runHistoryRepair } from "./history-repair.js";
+export { runInit, summarizeInitResult } from "./init.js";
 export { runLearnings } from "./learnings.js";
 export { runList } from "./list.js";
 export { runNotes } from "./notes.js";
+export { runPlan, PLAN_SUBCOMMANDS, PLAN_SHOW_DEPTH_VALUES, } from "./plan.js";
+export { runSchemaAddType, formatSchemaAddTypeHuman, SCHEMA_SUBCOMMANDS, } from "./schema.js";
 export { runSearch } from "./search.js";
 export { runRestore } from "./restore.js";
 export { runStats } from "./stats.js";
@@ -31,4 +37,5 @@ export { runUpdate } from "./update.js";
 export { runUpdateMany } from "./update-many.js";
 export { runUpgrade } from "./upgrade.js";
 export { runValidate } from "./validate.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map
+//# debugId=976d2cdf-7f8e-5cd9-9146-7fdb15fa1512

package/dist/cli/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAA+C,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAA8C,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAgD,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,YAAY,EAAsD,MAAM,gBAAgB,CAAC;AAClG,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,GAIX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAA6B,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAgD,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAA6D,MAAM,WAAW,CAAC;AACnH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAA6D,MAAM,gBAAgB,CAAC;AACzG,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAwD,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,UAAU,EAAkD,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAwE,MAAM,eAAe,CAAC","sourcesContent":["export { runAppend } from \"./append.js\";\nexport { runAggregate, type AggregateOptions, type AggregateResult } from \"./aggregate.js\";\nexport { runActivity } from \"./activity.js\";\nexport { runClaim, runRelease } from \"./claim.js\";\nexport { runClose, type CloseCommandOptions, type CloseResult } from \"./close.js\";\nexport { runComments } from \"./comments.js\";\nexport { runConfig, type ConfigCommandOptions, type ConfigResult } from \"./config.js\";\nexport { runContracts, type ContractsCommandOptions, type ContractsResult } from \"./contracts.js\";\nexport {\n  CONTEXT_OUTPUT_VALUES,\n  renderContextMarkdown,\n  resolveContextOutputFormat,\n  runContext,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n} from \"./context.js\";\nexport { runCreate, type CreateCommandOptions } from \"./create.js\";\nexport { runDelete, type DeleteCommandOptions, type DeleteResult } from \"./delete.js\";\nexport { runDeps, DEPS_FORMAT_VALUES, type DepsCommandOptions, type DepsFormat, type DepsResult } from \"./deps.js\";\nexport { runDocs } from \"./docs.js\";\nexport { runExtension, type ExtensionCommandOptions, type ExtensionCommandResult } from \"./extension.js\";\nexport { runFiles, runFilesDiscover } from \"./files.js\";\nexport { runGc } from \"./gc.js\";\nexport { runGet } from \"./get.js\";\nexport { runHealth } from \"./health.js\";\nexport { runHistory } from \"./history.js\";\nexport { runInit } from \"./init.js\";\nexport { runLearnings } from \"./learnings.js\";\nexport { runList, type ListOptions } from \"./list.js\";\nexport { runNotes } from \"./notes.js\";\nexport { runSearch } from \"./search.js\";\nexport { runRestore } from \"./restore.js\";\nexport { runStats } from \"./stats.js\";\nexport { runTest } from \"./test.js\";\nexport { runTestAll } from \"./test-all.js\";\nexport {\n  runStartBackgroundRun,\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  runTestRunsWorker,\n} from \"./test-runs.js\";\nexport { runUpdate } from \"./update.js\";\nexport { runUpdateMany, type UpdateManyCommandOptions, type UpdateManyResult } from \"./update-many.js\";\nexport { runUpgrade, type UpgradeCommandOptions, type UpgradeResult } from \"./upgrade.js\";\nexport { runValidate, type ValidateCheck, type ValidateCommandOptions, type ValidateResult } from \"./validate.js\";\n"]}
+{"version":3,"file":"index.js","sources":["cli/commands/index.ts"],"sourceRoot":"/","sourcesContent":["export { runAppend } from \"./append.js\";\nexport { runAggregate, type AggregateOptions, type AggregateResult } from \"./aggregate.js\";\nexport { runActivity } from \"./activity.js\";\nexport { runClaim, runRelease } from \"./claim.js\";\nexport { runClose, type CloseCommandOptions, type CloseResult } from \"./close.js\";\nexport { runComments } from \"./comments.js\";\nexport { runConfig, type ConfigCommandOptions, type ConfigResult } from \"./config.js\";\nexport { runContracts, type ContractsCommandOptions, type ContractsResult } from \"./contracts.js\";\nexport {\n  CONTEXT_OUTPUT_VALUES,\n  renderContextMarkdown,\n  resolveContextOutputFormat,\n  runContext,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n} from \"./context.js\";\nexport { runCreate, type CreateCommandOptions } from \"./create.js\";\nexport { runDelete, type DeleteCommandOptions, type DeleteResult } from \"./delete.js\";\nexport { runDeps, DEPS_FORMAT_VALUES, type DepsCommandOptions, type DepsFormat, type DepsResult } from \"./deps.js\";\nexport { runDocs } from \"./docs.js\";\nexport { runExtension, type ExtensionCommandOptions, type ExtensionCommandResult } from \"./extension.js\";\nexport { runFiles, runFilesDiscover } from \"./files.js\";\nexport { runGc } from \"./gc.js\";\nexport { runGet } from \"./get.js\";\nexport { runHealth } from \"./health.js\";\nexport { runHistory } from \"./history.js\";\nexport { runHistoryRedact, type HistoryRedactCommandOptions, type HistoryRedactResult } from \"./history-redact.js\";\nexport { runHistoryRepair, type HistoryRepairCommandOptions, type HistoryRepairResult } from \"./history-repair.js\";\nexport { runInit, summarizeInitResult, type InitConciseResult } from \"./init.js\";\nexport { runLearnings } from \"./learnings.js\";\nexport { runList, type ListOptions } from \"./list.js\";\nexport { runNotes } from \"./notes.js\";\nexport {\n  runPlan,\n  PLAN_SUBCOMMANDS,\n  PLAN_SHOW_DEPTH_VALUES,\n  type PlanCommandOptions,\n  type PlanCommandResult,\n  type PlanDispatchInput,\n  type PlanResultPlan,\n  type PlanStepSummary,\n  type PlanShowDepth,\n  type PlanSubcommand,\n} from \"./plan.js\";\nexport {\n  runSchemaAddType,\n  formatSchemaAddTypeHuman,\n  SCHEMA_SUBCOMMANDS,\n  type SchemaSubcommand,\n  type SchemaAddTypeCommandOptions,\n  type SchemaAddTypeResult,\n} from \"./schema.js\";\nexport { runSearch } from \"./search.js\";\nexport { runRestore } from \"./restore.js\";\nexport { runStats } from \"./stats.js\";\nexport { runTest } from \"./test.js\";\nexport { runTestAll } from \"./test-all.js\";\nexport {\n  runStartBackgroundRun,\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  runTestRunsWorker,\n} from \"./test-runs.js\";\nexport { runUpdate } from \"./update.js\";\nexport { runUpdateMany, type UpdateManyCommandOptions, type UpdateManyResult } from \"./update-many.js\";\nexport { runUpgrade, type UpgradeCommandOptions, type UpgradeResult } from \"./upgrade.js\";\nexport { runValidate, type ValidateCheck, type ValidateCommandOptions, type ValidateResult } from \"./validate.js\";\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAA+C,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAA8C,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAgD,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,YAAY,EAAsD,MAAM,gBAAgB,CAAC;AAClG,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,UAAU,GAIX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAA6B,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAgD,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAA6D,MAAM,WAAW,CAAC;AACnH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAA6D,MAAM,gBAAgB,CAAC;AACzG,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAA8D,MAAM,qBAAqB,CAAC;AACnH,OAAO,EAAE,gBAAgB,EAA8D,MAAM,qBAAqB,CAAC;AACnH,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAA0B,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,sBAAsB,GAQvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,GAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAwD,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,UAAU,EAAkD,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAwE,MAAM,eAAe,CAAC","debugId":"976d2cdf-7f8e-5cd9-9146-7fdb15fa1512"}

package/dist/cli/commands/init-agent-guidance.d.ts

@@ -0,0 +1,31 @@
+import type { PmSettings } from "../../types/index.js";
+export type InitAgentGuidanceMode = "ask" | "add" | "skip" | "status";
+export declare const INIT_AGENT_GUIDANCE_MODE_VALUES: InitAgentGuidanceMode[];
+export interface InitAgentGuidanceSummary {
+    mode: InitAgentGuidanceMode;
+    present: boolean;
+    prompted: boolean;
+    applied: boolean;
+    skipped: boolean;
+    declined: boolean;
+    prompt_completed: boolean;
+    template_version: number;
+    target_file: string;
+    checked_files: string[];
+    files_with_guidance: string[];
+    missing_files: string[];
+}
+export interface RunInitAgentGuidanceOptions {
+    pm_root: string;
+    cwd: string;
+    mode: InitAgentGuidanceMode;
+    interactive: boolean;
+    settings: PmSettings;
+}
+export interface RunInitAgentGuidanceResult {
+    summary: InitAgentGuidanceSummary;
+    warnings: string[];
+    next_steps: string[];
+    settings_changed: boolean;
+}
+export declare function runInitAgentGuidance(options: RunInitAgentGuidanceOptions): Promise<RunInitAgentGuidanceResult>;