@unbrained/pm-cli 2026.6.6 → 2026.6.8

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

@@ -0,0 +1,262 @@
+
+!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]="a55058bd-5e0f-51f5-991c-573cdb9112bb")}catch(e){}}();
+import fs from "node:fs/promises";
+import { createHistoryEntry } from "../../core/history/history.js";
+import { checkHistoryRewriteOwnership, verifyHistoryRewriteNoDrift, } from "../../core/history/history-rewrite.js";
+import { cloneEmptyReplayDocument, historyEntriesToRaw, replayHash, replayToItemDocument, toReplayDocument, tryApplyReplayPatch, verifyHistoryChain, } from "../../core/history/replay.js";
+import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
+import { acquireLock } from "../../core/lock/lock.js";
+import { pathExists, readFileIfExists, writeFileAtomic } from "../../core/fs/fs-utils.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 } from "../../core/store/settings.js";
+import { resolveAuthor } from "../../core/shared/author.js";
+import { readHistoryEntries } from "./history.js";
+import { resolveHistorySubject } from "./history-redact.js";
+function parseBeforeBoundary(before, entries) {
+    if (before === undefined) {
+        return {
+            kind: "default",
+            raw: null,
+            compactCount: entries.length,
+            retainedCount: 0,
+        };
+    }
+    const raw = before.trim();
+    if (raw.length === 0) {
+        throw new PmCliError("history-compact --before requires a non-empty value.", EXIT_CODE.USAGE);
+    }
+    if (/^\d+$/.test(raw)) {
+        const version = Number.parseInt(raw, 10);
+        if (!Number.isSafeInteger(version) || version < 1 || version > entries.length + 1) {
+            throw new PmCliError(`history-compact --before version must be between 1 and ${entries.length + 1}.`, EXIT_CODE.USAGE);
+        }
+        const compactCount = Math.max(0, Math.min(entries.length, version - 1));
+        return {
+            kind: "version",
+            raw,
+            compactCount,
+            retainedCount: entries.length - compactCount,
+        };
+    }
+    const beforeTs = Date.parse(raw);
+    if (!Number.isFinite(beforeTs)) {
+        throw new PmCliError(`Invalid history-compact --before value "${before}". Use a version number or ISO timestamp.`, EXIT_CODE.USAGE);
+    }
+    let compactCount = 0;
+    for (const [index, entry] of entries.entries()) {
+        const entryTs = Date.parse(entry.ts);
+        if (!Number.isFinite(entryTs)) {
+            throw new PmCliError(`History for this item contains invalid timestamp at entry ${index + 1}.`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        if (entryTs >= beforeTs) {
+            break;
+        }
+        compactCount += 1;
+    }
+    return {
+        kind: "timestamp",
+        raw,
+        compactCount,
+        retainedCount: entries.length - compactCount,
+    };
+}
+function applyHistoryPatch(current, entry, entryNumber) {
+    const result = tryApplyReplayPatch(current, entry.patch);
+    if (!result.ok) {
+        throw new PmCliError(`history-compact failed to apply patch at entry ${entryNumber} (op=${entry.op}): ${result.error instanceof Error ? result.error.message : String(result.error)}`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    return result.document;
+}
+function replayHistoryAndResolveCheckpoint(entries, compactCount) {
+    let replay = cloneEmptyReplayDocument();
+    let checkpoint = cloneEmptyReplayDocument();
+    for (let index = 0; index < entries.length; index += 1) {
+        const entry = entries[index];
+        if (replayHash(replay) !== entry.before_hash) {
+            throw new PmCliError(`history-compact detected before-hash drift at entry ${index + 1}; run pm history-repair first.`, EXIT_CODE.CONFLICT);
+        }
+        replay = applyHistoryPatch(replay, entry, index + 1);
+        if (replayHash(replay) !== entry.after_hash) {
+            throw new PmCliError(`history-compact detected after-hash drift at entry ${index + 1}; run pm history-repair first.`, EXIT_CODE.CONFLICT);
+        }
+        if (index + 1 === compactCount) {
+            checkpoint = structuredClone(replay);
+        }
+    }
+    return {
+        checkpoint,
+        finalReplay: replay,
+    };
+}
+function reanchorRetainedEntries(retainedEntries, seed, retainedEntryOffset) {
+    let replay = structuredClone(seed);
+    const rewritten = [];
+    for (const [index, entry] of retainedEntries.entries()) {
+        const beforeHash = replayHash(replay);
+        replay = applyHistoryPatch(replay, entry, retainedEntryOffset + index + 1);
+        rewritten.push({
+            ...entry,
+            before_hash: beforeHash,
+            after_hash: replayHash(replay),
+        });
+    }
+    return {
+        entries: rewritten,
+        finalReplay: replay,
+    };
+}
+export async function runHistoryCompact(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);
+    const historyPath = subject.historyPath;
+    const historyRawBeforeLock = await readFileIfExists(historyPath);
+    if (historyRawBeforeLock === null) {
+        throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);
+    }
+    const historyEntries = await readHistoryEntries(historyPath, subject.id);
+    if (historyEntries.length === 0) {
+        throw new PmCliError(`No history entries exist for ${subject.id}; nothing to compact.`, EXIT_CODE.USAGE);
+    }
+    const chainVerification = verifyHistoryChain(historyEntries);
+    if (!chainVerification.ok) {
+        throw new PmCliError(`history-compact requires a valid history chain (${chainVerification.errors.join(", ")}). Run pm history-repair ${subject.id} first.`, EXIT_CODE.CONFLICT);
+    }
+    const boundary = parseBeforeBoundary(options.before, historyEntries);
+    const changed = boundary.compactCount > 0;
+    const dryRun = Boolean(options.dryRun);
+    const author = resolveAuthor(options.author, settings.author_default);
+    const warnings = [];
+    if (!changed) {
+        warnings.push("history_compact_noop_before_boundary");
+    }
+    const loadedItem = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;
+    const currentItemRawBeforeLock = loadedItem?.raw ?? null;
+    const matchedChainBefore = loadedItem === null
+        ? null
+        : replayHash(toReplayDocument(loadedItem.document)) === historyEntries[historyEntries.length - 1]?.after_hash;
+    if (matchedChainBefore === false) {
+        warnings.push("history_compact_item_chain_mismatch");
+    }
+    let rewrittenEntries = historyEntries;
+    let baselineEntryAdded = false;
+    let auditEntryAdded = false;
+    if (changed) {
+        const { checkpoint, finalReplay } = replayHistoryAndResolveCheckpoint(historyEntries, boundary.compactCount);
+        const retained = historyEntries.slice(boundary.compactCount);
+        const reanchored = reanchorRetainedEntries(retained, checkpoint, boundary.compactCount);
+        const baselineEntry = createHistoryEntry({
+            nowIso: nowIso(),
+            author,
+            op: "history_compact_baseline",
+            before: replayToItemDocument(cloneEmptyReplayDocument()),
+            after: replayToItemDocument(checkpoint),
+            message: boundary.raw === null
+                ? `history-compact baseline snapshot after compacting ${boundary.compactCount} entr${boundary.compactCount === 1 ? "y" : "ies"}.`
+                : `history-compact baseline snapshot before ${boundary.raw}.`,
+        });
+        rewrittenEntries = [baselineEntry, ...reanchored.entries];
+        baselineEntryAdded = true;
+        const compactMessage = typeof options.message === "string" && options.message.trim().length > 0
+            ? options.message
+            : boundary.raw === null
+                ? `history-compact compacted full stream (${boundary.compactCount} entr${boundary.compactCount === 1 ? "y" : "ies"}).`
+                : `history-compact compacted ${boundary.compactCount} entr${boundary.compactCount === 1 ? "y" : "ies"} before ${boundary.raw}.`;
+        if (!dryRun) {
+            rewrittenEntries.push(createHistoryEntry({
+                nowIso: nowIso(),
+                author,
+                op: "history_compact",
+                before: replayToItemDocument(finalReplay),
+                after: replayToItemDocument(finalReplay),
+                message: compactMessage,
+            }));
+            auditEntryAdded = true;
+        }
+    }
+    const rewrittenVerify = verifyHistoryChain(rewrittenEntries);
+    if (!rewrittenVerify.ok) {
+        throw new PmCliError(`history-compact produced an invalid rewritten chain (${rewrittenVerify.errors.join(", ")}).`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    if (changed && !dryRun) {
+        warnings.push(...checkHistoryRewriteOwnership({
+            itemDocument: loadedItem?.document ?? null,
+            subjectId: subject.id,
+            author,
+            force: options.force,
+            settings,
+        }));
+        const releaseLock = await acquireLock(pmRoot, subject.id, settings.locks.ttl_seconds, author, Boolean(options.force), settings.governance.force_required_for_stale_lock);
+        try {
+            const { historyRawUnderLock } = await verifyHistoryRewriteNoDrift({
+                pmRoot,
+                subject,
+                settings,
+                typeRegistry,
+                historyRawBeforeLock,
+                currentItemRawBeforeLock,
+                operation: "history-compact",
+            });
+            try {
+                await writeFileAtomic(historyPath, historyEntriesToRaw(rewrittenEntries));
+            }
+            catch (error) {
+                if (historyRawUnderLock === null) {
+                    await fs.rm(historyPath, { force: true });
+                }
+                else {
+                    await writeFileAtomic(historyPath, historyRawUnderLock);
+                }
+                throw error;
+            }
+            warnings.push(...(await runActiveOnWriteHooks({
+                path: historyPath,
+                scope: "project",
+                op: "history_compact:history",
+            })));
+        }
+        finally {
+            await releaseLock();
+        }
+    }
+    const firstRetainedEntry = boundary.retainedCount > 0 ? boundary.compactCount + 1 : null;
+    return {
+        id: subject.id,
+        dry_run: dryRun,
+        changed,
+        compact_boundary: {
+            kind: boundary.kind,
+            before: boundary.raw,
+            entries_compacted: boundary.compactCount,
+            entries_retained: boundary.retainedCount,
+            first_retained_entry: firstRetainedEntry,
+        },
+        history: {
+            path: historyPath,
+            entries_scanned: historyEntries.length,
+            entries_after: rewrittenEntries.length,
+            baseline_entry_added: baselineEntryAdded,
+            audit_entry_added: auditEntryAdded,
+            verify_ok: rewrittenVerify.ok,
+            verify_errors: rewrittenVerify.errors,
+        },
+        item: {
+            exists: subject.located !== null,
+            path: subject.located?.itemPath ?? null,
+            matched_chain_before: matchedChainBefore,
+        },
+        warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
+        generated_at: nowIso(),
+    };
+}
+//# sourceMappingURL=history-compact.js.map
+//# debugId=a55058bd-5e0f-51f5-991c-573cdb9112bb

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

@@ -0,0 +1 @@
+{"version":3,"file":"history-compact.js","sources":["cli/commands/history-compact.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport { createHistoryEntry } from \"../../core/history/history.js\";\nimport {\n  checkHistoryRewriteOwnership,\n  verifyHistoryRewriteNoDrift,\n} from \"../../core/history/history-rewrite.js\";\nimport {\n  cloneEmptyReplayDocument,\n  historyEntriesToRaw,\n  replayHash,\n  replayToItemDocument,\n  toReplayDocument,\n  tryApplyReplayPatch,\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 { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.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 } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\nexport interface HistoryCompactCommandOptions {\n  before?: string;\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\ntype HistoryCompactBoundaryKind = \"default\" | \"version\" | \"timestamp\";\n\ninterface HistoryCompactBoundary {\n  kind: HistoryCompactBoundaryKind;\n  raw: string | null;\n  compactCount: number;\n  retainedCount: number;\n}\n\nexport interface HistoryCompactResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\n  compact_boundary: {\n    kind: HistoryCompactBoundaryKind;\n    before: string | null;\n    entries_compacted: number;\n    entries_retained: number;\n    first_retained_entry: number | null;\n  };\n  history: {\n    path: string;\n    entries_scanned: number;\n    entries_after: number;\n    baseline_entry_added: 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 parseBeforeBoundary(before: string | undefined, entries: HistoryEntry[]): HistoryCompactBoundary {\n  if (before === undefined) {\n    return {\n      kind: \"default\",\n      raw: null,\n      compactCount: entries.length,\n      retainedCount: 0,\n    };\n  }\n\n  const raw = before.trim();\n  if (raw.length === 0) {\n    throw new PmCliError(\"history-compact --before requires a non-empty value.\", EXIT_CODE.USAGE);\n  }\n\n  if (/^\\d+$/.test(raw)) {\n    const version = Number.parseInt(raw, 10);\n    if (!Number.isSafeInteger(version) || version < 1 || version > entries.length + 1) {\n      throw new PmCliError(\n        `history-compact --before version must be between 1 and ${entries.length + 1}.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const compactCount = Math.max(0, Math.min(entries.length, version - 1));\n    return {\n      kind: \"version\",\n      raw,\n      compactCount,\n      retainedCount: entries.length - compactCount,\n    };\n  }\n\n  const beforeTs = Date.parse(raw);\n  if (!Number.isFinite(beforeTs)) {\n    throw new PmCliError(\n      `Invalid history-compact --before value \"${before}\". Use a version number or ISO timestamp.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let compactCount = 0;\n  for (const [index, entry] of entries.entries()) {\n    const entryTs = Date.parse(entry.ts);\n    if (!Number.isFinite(entryTs)) {\n      throw new PmCliError(\n        `History for this item contains invalid timestamp at entry ${index + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (entryTs >= beforeTs) {\n      break;\n    }\n    compactCount += 1;\n  }\n\n  return {\n    kind: \"timestamp\",\n    raw,\n    compactCount,\n    retainedCount: entries.length - compactCount,\n  };\n}\n\nfunction applyHistoryPatch(current: ReplayDocument, entry: HistoryEntry, entryNumber: number): ReplayDocument {\n  const result = tryApplyReplayPatch(current, entry.patch);\n  if (!result.ok) {\n    throw new PmCliError(\n      `history-compact failed to apply patch at entry ${entryNumber} (op=${entry.op}): ${\n        result.error instanceof Error ? result.error.message : String(result.error)\n      }`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  return result.document;\n}\n\nfunction replayHistoryAndResolveCheckpoint(\n  entries: HistoryEntry[],\n  compactCount: number,\n): {\n  checkpoint: ReplayDocument;\n  finalReplay: ReplayDocument;\n} {\n  let replay = cloneEmptyReplayDocument();\n  let checkpoint = cloneEmptyReplayDocument();\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    if (replayHash(replay) !== entry.before_hash) {\n      throw new PmCliError(\n        `history-compact detected before-hash drift at entry ${index + 1}; run pm history-repair first.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n    replay = applyHistoryPatch(replay, entry, index + 1);\n    if (replayHash(replay) !== entry.after_hash) {\n      throw new PmCliError(\n        `history-compact detected after-hash drift at entry ${index + 1}; run pm history-repair first.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n    if (index + 1 === compactCount) {\n      checkpoint = structuredClone(replay);\n    }\n  }\n  return {\n    checkpoint,\n    finalReplay: replay,\n  };\n}\n\nfunction reanchorRetainedEntries(\n  retainedEntries: HistoryEntry[],\n  seed: ReplayDocument,\n  retainedEntryOffset: number,\n): {\n  entries: HistoryEntry[];\n  finalReplay: ReplayDocument;\n} {\n  let replay = structuredClone(seed);\n  const rewritten: HistoryEntry[] = [];\n  for (const [index, entry] of retainedEntries.entries()) {\n    const beforeHash = replayHash(replay);\n    replay = applyHistoryPatch(replay, entry, retainedEntryOffset + index + 1);\n    rewritten.push({\n      ...entry,\n      before_hash: beforeHash,\n      after_hash: replayHash(replay),\n    });\n  }\n  return {\n    entries: rewritten,\n    finalReplay: replay,\n  };\n}\n\nexport async function runHistoryCompact(\n  id: string,\n  options: HistoryCompactCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryCompactResult> {\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  const historyPath = subject.historyPath;\n  const historyRawBeforeLock = await readFileIfExists(historyPath);\n  if (historyRawBeforeLock === null) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyEntries = await readHistoryEntries(historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to compact.`, EXIT_CODE.USAGE);\n  }\n\n  const chainVerification = verifyHistoryChain(historyEntries);\n  if (!chainVerification.ok) {\n    throw new PmCliError(\n      `history-compact requires a valid history chain (${chainVerification.errors.join(\", \")}). Run pm history-repair ${subject.id} first.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n\n  const boundary = parseBeforeBoundary(options.before, historyEntries);\n  const changed = boundary.compactCount > 0;\n  const dryRun = Boolean(options.dryRun);\n  const author = resolveAuthor(options.author, settings.author_default);\n  const warnings: string[] = [];\n  if (!changed) {\n    warnings.push(\"history_compact_noop_before_boundary\");\n  }\n\n  const loadedItem = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  const currentItemRawBeforeLock = loadedItem?.raw ?? null;\n  const matchedChainBefore =\n    loadedItem === null\n      ? null\n      : replayHash(toReplayDocument(loadedItem.document)) === historyEntries[historyEntries.length - 1]?.after_hash;\n  if (matchedChainBefore === false) {\n    warnings.push(\"history_compact_item_chain_mismatch\");\n  }\n\n  let rewrittenEntries: HistoryEntry[] = historyEntries;\n  let baselineEntryAdded = false;\n  let auditEntryAdded = false;\n\n  if (changed) {\n    const { checkpoint, finalReplay } = replayHistoryAndResolveCheckpoint(historyEntries, boundary.compactCount);\n    const retained = historyEntries.slice(boundary.compactCount);\n    const reanchored = reanchorRetainedEntries(retained, checkpoint, boundary.compactCount);\n    const baselineEntry = createHistoryEntry({\n      nowIso: nowIso(),\n      author,\n      op: \"history_compact_baseline\",\n      before: replayToItemDocument(cloneEmptyReplayDocument()),\n      after: replayToItemDocument(checkpoint),\n      message:\n        boundary.raw === null\n          ? `history-compact baseline snapshot after compacting ${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            }.`\n          : `history-compact baseline snapshot before ${boundary.raw}.`,\n    });\n    rewrittenEntries = [baselineEntry, ...reanchored.entries];\n    baselineEntryAdded = true;\n    const compactMessage =\n      typeof options.message === \"string\" && options.message.trim().length > 0\n        ? options.message\n        : boundary.raw === null\n          ? `history-compact compacted full stream (${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            }).`\n          : `history-compact compacted ${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            } before ${boundary.raw}.`;\n    if (!dryRun) {\n      rewrittenEntries.push(\n        createHistoryEntry({\n          nowIso: nowIso(),\n          author,\n          op: \"history_compact\",\n          before: replayToItemDocument(finalReplay),\n          after: replayToItemDocument(finalReplay),\n          message: compactMessage,\n        }),\n      );\n      auditEntryAdded = true;\n    }\n  }\n\n  const rewrittenVerify = verifyHistoryChain(rewrittenEntries);\n  if (!rewrittenVerify.ok) {\n    throw new PmCliError(\n      `history-compact produced an invalid rewritten chain (${rewrittenVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n\n  if (changed && !dryRun) {\n    warnings.push(\n      ...checkHistoryRewriteOwnership({\n        itemDocument: loadedItem?.document ?? null,\n        subjectId: subject.id,\n        author,\n        force: options.force,\n        settings,\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 { historyRawUnderLock } = await verifyHistoryRewriteNoDrift({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock,\n        operation: \"history-compact\",\n      });\n      try {\n        await writeFileAtomic(historyPath, historyEntriesToRaw(rewrittenEntries));\n      } catch (error) {\n        if (historyRawUnderLock === null) {\n          await fs.rm(historyPath, { force: true });\n        } else {\n          await writeFileAtomic(historyPath, historyRawUnderLock);\n        }\n        throw error;\n      }\n      warnings.push(\n        ...(await runActiveOnWriteHooks({\n          path: historyPath,\n          scope: \"project\",\n          op: \"history_compact:history\",\n        })),\n      );\n    } finally {\n      await releaseLock();\n    }\n  }\n\n  const firstRetainedEntry = boundary.retainedCount > 0 ? boundary.compactCount + 1 : null;\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    compact_boundary: {\n      kind: boundary.kind,\n      before: boundary.raw,\n      entries_compacted: boundary.compactCount,\n      entries_retained: boundary.retainedCount,\n      first_retained_entry: firstRetainedEntry,\n    },\n    history: {\n      path: historyPath,\n      entries_scanned: historyEntries.length,\n      entries_after: rewrittenEntries.length,\n      baseline_entry_added: baselineEntryAdded,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: rewrittenVerify.ok,\n      verify_errors: rewrittenVerify.errors,\n    },\n    item: {\n      exists: subject.located !== null,\n      path: subject.located?.itemPath ?? null,\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":"a55058bd-5e0f-51f5-991c-573cdb9112bb"}

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

@@ -9,6 +9,7 @@ export { runConfig, type ConfigCommandOptions, type ConfigResult } from "./confi
 export { runContracts, type ContractsCommandOptions, type ContractsResult } from "./contracts.js";
 export { CONTEXT_OUTPUT_VALUES, renderContextMarkdown, resolveContextOutputFormat, runContext, type ContextOptions, type ContextOutputFormat, type ContextResult, } from "./context.js";
 export { runCreate, type CreateCommandOptions } from "./create.js";
+export { runCopy, type CopyOptions, type CopyResult } from "./copy.js";
 export { runDelete, type DeleteCommandOptions, type DeleteResult } from "./delete.js";
 export { runDeps, DEPS_FORMAT_VALUES, type DepsCommandOptions, type DepsFormat, type DepsResult } from "./deps.js";
 export { runDocs } from "./docs.js";
@@ -18,6 +19,7 @@ export { runGc } from "./gc.js";
 export { runGet } from "./get.js";
 export { runHealth } from "./health.js";
 export { runHistory } from "./history.js";
+export { runHistoryCompact, type HistoryCompactCommandOptions, type HistoryCompactResult } from "./history-compact.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";
@@ -25,7 +27,7 @@ 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, runSchemaRemoveType, runSchemaAddStatus, runSchemaRemoveStatus, runSchemaList, runSchemaShow, formatSchemaAddTypeHuman, formatSchemaRemoveTypeHuman, formatSchemaAddStatusHuman, formatSchemaRemoveStatusHuman, formatSchemaListHuman, formatSchemaShowHuman, SCHEMA_SUBCOMMANDS, type SchemaSubcommand, type SchemaAddTypeCommandOptions, type SchemaAddTypeResult, type SchemaRemoveTypeCommandOptions, type SchemaRemoveTypeResult, type SchemaAddStatusCommandOptions, type SchemaAddStatusResult, type SchemaRemoveStatusCommandOptions, type SchemaRemoveStatusResult, type SchemaListResult, type SchemaShowResult, } from "./schema.js";
+export { runSchemaAddType, runSchemaRemoveType, runSchemaAddStatus, runSchemaRemoveStatus, runSchemaList, runSchemaShow, runSchemaShowStatus, formatSchemaAddTypeHuman, formatSchemaRemoveTypeHuman, formatSchemaAddStatusHuman, formatSchemaRemoveStatusHuman, formatSchemaListHuman, formatSchemaShowHuman, formatSchemaShowStatusHuman, SCHEMA_SUBCOMMANDS, type SchemaSubcommand, type SchemaAddTypeCommandOptions, type SchemaAddTypeResult, type SchemaRemoveTypeCommandOptions, type SchemaRemoveTypeResult, type SchemaAddStatusCommandOptions, type SchemaAddStatusResult, type SchemaRemoveStatusCommandOptions, type SchemaRemoveStatusResult, type SchemaListResult, type SchemaShowResult, type SchemaShowStatusResult, } 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,5 +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]="15b13b88-d275-530e-b31b-fcdeb9e38579")}catch(e){}}();
+!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]="918cbeda-1dcb-58c5-92d9-100a6242e832")}catch(e){}}();
 export { runAppend } from "./append.js";
 export { runAggregate } from "./aggregate.js";
 export { runActivity } from "./activity.js";
@@ -11,6 +11,7 @@ export { runConfig } from "./config.js";
 export { runContracts } from "./contracts.js";
 export { CONTEXT_OUTPUT_VALUES, renderContextMarkdown, resolveContextOutputFormat, runContext, } from "./context.js";
 export { runCreate } from "./create.js";
+export { runCopy } from "./copy.js";
 export { runDelete } from "./delete.js";
 export { runDeps, DEPS_FORMAT_VALUES } from "./deps.js";
 export { runDocs } from "./docs.js";
@@ -20,6 +21,7 @@ export { runGc } from "./gc.js";
 export { runGet } from "./get.js";
 export { runHealth } from "./health.js";
 export { runHistory } from "./history.js";
+export { runHistoryCompact } from "./history-compact.js";
 export { runHistoryRedact } from "./history-redact.js";
 export { runHistoryRepair } from "./history-repair.js";
 export { runInit, summarizeInitResult } from "./init.js";
@@ -27,7 +29,7 @@ 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, runSchemaRemoveType, runSchemaAddStatus, runSchemaRemoveStatus, runSchemaList, runSchemaShow, formatSchemaAddTypeHuman, formatSchemaRemoveTypeHuman, formatSchemaAddStatusHuman, formatSchemaRemoveStatusHuman, formatSchemaListHuman, formatSchemaShowHuman, SCHEMA_SUBCOMMANDS, } from "./schema.js";
+export { runSchemaAddType, runSchemaRemoveType, runSchemaAddStatus, runSchemaRemoveStatus, runSchemaList, runSchemaShow, runSchemaShowStatus, formatSchemaAddTypeHuman, formatSchemaRemoveTypeHuman, formatSchemaAddStatusHuman, formatSchemaRemoveStatusHuman, formatSchemaListHuman, formatSchemaShowHuman, formatSchemaShowStatusHuman, SCHEMA_SUBCOMMANDS, } from "./schema.js";
 export { runSearch } from "./search.js";
 export { runRestore } from "./restore.js";
 export { runStats } from "./stats.js";
@@ -40,4 +42,4 @@ export { runUpdateMany } from "./update-many.js";
 export { runUpgrade } from "./upgrade.js";
 export { runValidate } from "./validate.js";
 //# sourceMappingURL=index.js.map
-//# debugId=15b13b88-d275-530e-b31b-fcdeb9e38579
+//# debugId=918cbeda-1dcb-58c5-92d9-100a6242e832

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

@@ -1 +1 @@
-{"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 { runCloseMany, type CloseManyCommandOptions, type CloseManyResult } from \"./close-many.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  runSchemaRemoveType,\n  runSchemaAddStatus,\n  runSchemaRemoveStatus,\n  runSchemaList,\n  runSchemaShow,\n  formatSchemaAddTypeHuman,\n  formatSchemaRemoveTypeHuman,\n  formatSchemaAddStatusHuman,\n  formatSchemaRemoveStatusHuman,\n  formatSchemaListHuman,\n  formatSchemaShowHuman,\n  SCHEMA_SUBCOMMANDS,\n  type SchemaSubcommand,\n  type SchemaAddTypeCommandOptions,\n  type SchemaAddTypeResult,\n  type SchemaRemoveTypeCommandOptions,\n  type SchemaRemoveTypeResult,\n  type SchemaAddStatusCommandOptions,\n  type SchemaAddStatusResult,\n  type SchemaRemoveStatusCommandOptions,\n  type SchemaRemoveStatusResult,\n  type SchemaListResult,\n  type SchemaShowResult,\n} from \"./schema.js\";\nexport { runSearch } from \"./search.js\";\nexport { runRestore } from \"./restore.js\";\nexport { runStats } from \"./stats.js\";\nexport { runTelemetry, TELEMETRY_SUBCOMMANDS, type TelemetryCommandOptions, type TelemetrySubcommand } from \"./telemetry.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,YAAY,EAAsD,MAAM,iBAAiB,CAAC;AACnG,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,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,GAYnB,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,YAAY,EAAE,qBAAqB,EAA0D,MAAM,gBAAgB,CAAC;AAC7H,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":"15b13b88-d275-530e-b31b-fcdeb9e38579"}
+{"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 { runCloseMany, type CloseManyCommandOptions, type CloseManyResult } from \"./close-many.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 { runCopy, type CopyOptions, type CopyResult } from \"./copy.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 { runHistoryCompact, type HistoryCompactCommandOptions, type HistoryCompactResult } from \"./history-compact.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  runSchemaRemoveType,\n  runSchemaAddStatus,\n  runSchemaRemoveStatus,\n  runSchemaList,\n  runSchemaShow,\n  runSchemaShowStatus,\n  formatSchemaAddTypeHuman,\n  formatSchemaRemoveTypeHuman,\n  formatSchemaAddStatusHuman,\n  formatSchemaRemoveStatusHuman,\n  formatSchemaListHuman,\n  formatSchemaShowHuman,\n  formatSchemaShowStatusHuman,\n  SCHEMA_SUBCOMMANDS,\n  type SchemaSubcommand,\n  type SchemaAddTypeCommandOptions,\n  type SchemaAddTypeResult,\n  type SchemaRemoveTypeCommandOptions,\n  type SchemaRemoveTypeResult,\n  type SchemaAddStatusCommandOptions,\n  type SchemaAddStatusResult,\n  type SchemaRemoveStatusCommandOptions,\n  type SchemaRemoveStatusResult,\n  type SchemaListResult,\n  type SchemaShowResult,\n  type SchemaShowStatusResult,\n} from \"./schema.js\";\nexport { runSearch } from \"./search.js\";\nexport { runRestore } from \"./restore.js\";\nexport { runStats } from \"./stats.js\";\nexport { runTelemetry, TELEMETRY_SUBCOMMANDS, type TelemetryCommandOptions, type TelemetrySubcommand } from \"./telemetry.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":"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","debugId":"918cbeda-1dcb-58c5-92d9-100a6242e832"}

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

@@ -36,6 +36,7 @@ export interface InitCommandOptions {
     withPackages?: boolean;
     agentGuidance?: string;
     typePreset?: string;
+    force?: boolean;
 }
 /**
  * Concise projection of an InitResult for the default (toon) renderer. It keeps

package/dist/cli/commands/init.js

@@ -1,5 +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]="9395c248-0605-5d4c-bc9a-ce5b433a4fb0")}catch(e){}}();
+!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]="58fd8bd3-ecc5-5bc5-9330-9d5af3a2c650")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import readline from "node:readline/promises";
@@ -201,6 +201,51 @@ async function registerInitTypePreset(pmRoot, settings, preset) {
         file: typesPath,
     };
 }
+async function isLikelyWorkspaceRoot(candidate) {
+    const indicators = [
+        ".git",
+        "package.json",
+        "pnpm-workspace.yaml",
+        "AGENTS.md",
+        path.join(".agents", "pm"),
+    ];
+    for (const indicator of indicators) {
+        if (await pathExists(path.join(candidate, indicator))) {
+            return true;
+        }
+    }
+    return false;
+}
+async function assertExplicitTrackerPathIsNotWorkspaceRoot(pmRoot, global, force) {
+    if (global.path === undefined || force) {
+        return;
+    }
+    if (await pathExists(path.join(pmRoot, "settings.json"))) {
+        return;
+    }
+    if (!(await isLikelyWorkspaceRoot(pmRoot))) {
+        return;
+    }
+    const nestedTracker = path.join(pmRoot, ".agents", "pm");
+    throw new PmCliError(`Refusing to initialize tracker files directly in workspace root "${pmRoot}".`, EXIT_CODE.USAGE, {
+        code: "workspace_root_pm_path",
+        type: "urn:pm-cli:error:workspace_root_pm_path",
+        why: "--pm-path/--path points at the tracker storage directory itself, not the repository workspace. Point it at .agents/pm or pass --force if you intentionally want root-level tracker files.",
+        examples: [
+            `pm --pm-path ${nestedTracker} init --yes`,
+            "pm init --yes",
+            `pm --pm-path ${pmRoot} init --yes --force`,
+        ],
+        nextSteps: [
+            "Use --pm-path <repo>/.agents/pm for repository-local tracker storage.",
+            "Use PM_PATH only for sandboxed tests or explicit tracker roots.",
+            "Pass --force only when root-level tracker files are intentional.",
+        ],
+        recovery: {
+            next_best_command: `pm --pm-path ${nestedTracker} init --yes`,
+        },
+    });
+}
 async function runInitWizard(initialPrefix, telemetryDefault) {
     const rl = readline.createInterface({ input, output });
     try {
@@ -235,6 +280,7 @@ async function runInitWizard(initialPrefix, telemetryDefault) {
 export async function runInit(prefixArg, global, options = {}) {
     const cwd = process.cwd();
     const pmRoot = resolvePmRoot(cwd, global.path);
+    await assertExplicitTrackerPathIsNotWorkspaceRoot(pmRoot, global, options.force === true);
     const createdDirs = [];
     const warnings = [];
     let wizardUsed = false;
@@ -406,4 +452,4 @@ export async function runInit(prefixArg, global, options = {}) {
     };
 }
 //# sourceMappingURL=init.js.map
-//# debugId=9395c248-0605-5d4c-bc9a-ce5b433a4fb0
+//# debugId=58fd8bd3-ecc5-5bc5-9330-9d5af3a2c650