@unbrained/pm-cli 2026.5.12 → 2026.5.18

package/dist/cli/commands/history.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]="fabece59-ecce-590b-8a6f-f37c0490f98e")}catch(e){}}();
 import jsonPatch from "fast-json-patch";
 import { pathExists, readFileIfExists } from "../../core/fs/fs-utils.js";
 import { hashDocument, hashEmptyDocument } from "../../core/history/history.js";
@@ -106,7 +108,7 @@ function applyHistoryPatch(current, patch, entryNumber) {
         throw new PmCliError(`Failed to apply history patch at entry ${entryNumber}.`, EXIT_CODE.GENERIC_FAILURE);
     }
 }
-function verifyHistoryChain(entries) {
+export function verifyHistoryChain(entries) {
     let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);
     for (let index = 0; index < entries.length; index += 1) {
         const entry = entries[index];
@@ -117,7 +119,15 @@ function verifyHistoryChain(entries) {
                 errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`],
             };
         }
-        replay = applyHistoryPatch(replay, entry.patch, index + 1);
+        try {
+            replay = applyHistoryPatch(replay, entry.patch, index + 1);
+        }
+        catch {
+            return {
+                ok: false,
+                errors: [`verify_failed:patch_apply_failed:entry_${index + 1}`],
+            };
+        }
         const afterHash = replayHash(replay);
         if (afterHash !== entry.after_hash) {
             return {
@@ -227,4 +237,5 @@ export async function runHistory(id, options, global) {
     }
     return result;
 }
-//# sourceMappingURL=history.js.map
+//# sourceMappingURL=history.js.map
+//# debugId=fabece59-ecce-590b-8a6f-f37c0490f98e

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 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\nexport function 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    try {\n      replay = applyHistoryPatch(replay, entry.patch, index + 1);\n    } catch {\n      return {\n        ok: false,\n        errors: [`verify_failed:patch_apply_failed:entry_${index + 1}`],\n      };\n    }\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"],"names":[],"mappings":"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","debugId":"fabece59-ecce-590b-8a6f-f37c0490f98e"}

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

@@ -1,40 +1,34 @@
 export { runAppend } from "./append.js";
 export { runAggregate, type AggregateOptions, type AggregateResult } from "./aggregate.js";
-export { runCompletion, type CompletionResult, type CompletionShell } from "./completion.js";
 export { runActivity } from "./activity.js";
 export { runClaim, runRelease } from "./claim.js";
 export { runClose, type CloseCommandOptions, type CloseResult } from "./close.js";
 export { runComments } from "./comments.js";
-export { runCommentsAudit, type CommentsAuditOptions, type CommentsAuditResult } from "./comments-audit.js";
 export { runConfig, type ConfigCommandOptions, type ConfigResult } from "./config.js";
 export { runContracts, type ContractsCommandOptions, type ContractsResult } from "./contracts.js";
-export { CALENDAR_OUTPUT_VALUES, CALENDAR_VIEW_VALUES, renderCalendarMarkdown, resolveCalendarOutputFormat, runCalendar, type CalendarOptions, type CalendarOutputFormat, type CalendarResult, type CalendarView, } from "./calendar.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 { runDelete, type DeleteCommandOptions, type DeleteResult } from "./delete.js";
 export { runDeps, DEPS_FORMAT_VALUES, type DepsCommandOptions, type DepsFormat, type DepsResult } from "./deps.js";
-export { runDedupeAudit, DEDUPE_AUDIT_MODES, type DedupeAuditMode, type DedupeAuditOptions, type DedupeAuditResult } from "./dedupe-audit.js";
 export { runDocs } from "./docs.js";
-export { GUIDE_DEPTH_VALUES, GUIDE_OUTPUT_VALUES, renderGuideMarkdown, resolveGuideOutputFormat, runGuide, type GuideDepth, type GuideOptions, type GuideOutputFormat, type GuideResult, } from "./guide.js";
 export { runExtension, type ExtensionCommandOptions, type ExtensionCommandResult } from "./extension.js";
 export { runFiles, runFilesDiscover } from "./files.js";
 export { runGc } from "./gc.js";
 export { runGet } from "./get.js";
 export { runHealth } from "./health.js";
 export { runHistory } from "./history.js";
+export { runHistoryRedact, type HistoryRedactCommandOptions, type HistoryRedactResult } from "./history-redact.js";
 export { runInit } from "./init.js";
 export { runLearnings } from "./learnings.js";
 export { runList, type ListOptions } from "./list.js";
-export { runNormalize, type NormalizeCommandOptions, type NormalizeResult } from "./normalize.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 { runSearch } from "./search.js";
-export { runReindex, type ReindexOptions, type ReindexResult } from "./reindex.js";
 export { runRestore } from "./restore.js";
 export { runStats } from "./stats.js";
 export { runTest } from "./test.js";
 export { runTestAll } from "./test-all.js";
 export { runStartBackgroundRun, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, runTestRunsWorker, } from "./test-runs.js";
-export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, } from "./templates.js";
 export { runUpdate } from "./update.js";
 export { runUpdateMany, type UpdateManyCommandOptions, type UpdateManyResult } from "./update-many.js";
 export { runUpgrade, type UpgradeCommandOptions, type UpgradeResult } from "./upgrade.js";

package/dist/cli/commands/index.js

@@ -1,42 +1,39 @@
+
+!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]="a832a3d9-5b89-5660-96ae-68037ae50948")}catch(e){}}();
 export { runAppend } from "./append.js";
 export { runAggregate } from "./aggregate.js";
-export { runCompletion } from "./completion.js";
 export { runActivity } from "./activity.js";
 export { runClaim, runRelease } from "./claim.js";
 export { runClose } from "./close.js";
 export { runComments } from "./comments.js";
-export { runCommentsAudit } from "./comments-audit.js";
 export { runConfig } from "./config.js";
 export { runContracts } from "./contracts.js";
-export { CALENDAR_OUTPUT_VALUES, CALENDAR_VIEW_VALUES, renderCalendarMarkdown, resolveCalendarOutputFormat, runCalendar, } from "./calendar.js";
 export { CONTEXT_OUTPUT_VALUES, renderContextMarkdown, resolveContextOutputFormat, runContext, } from "./context.js";
 export { runCreate } from "./create.js";
 export { runDelete } from "./delete.js";
 export { runDeps, DEPS_FORMAT_VALUES } from "./deps.js";
-export { runDedupeAudit, DEDUPE_AUDIT_MODES } from "./dedupe-audit.js";
 export { runDocs } from "./docs.js";
-export { GUIDE_DEPTH_VALUES, GUIDE_OUTPUT_VALUES, renderGuideMarkdown, resolveGuideOutputFormat, runGuide, } from "./guide.js";
 export { runExtension } from "./extension.js";
 export { runFiles, runFilesDiscover } from "./files.js";
 export { runGc } from "./gc.js";
 export { runGet } from "./get.js";
 export { runHealth } from "./health.js";
 export { runHistory } from "./history.js";
+export { runHistoryRedact } from "./history-redact.js";
 export { runInit } from "./init.js";
 export { runLearnings } from "./learnings.js";
 export { runList } from "./list.js";
-export { runNormalize } from "./normalize.js";
 export { runNotes } from "./notes.js";
+export { runPlan, PLAN_SUBCOMMANDS, PLAN_SHOW_DEPTH_VALUES, } from "./plan.js";
 export { runSearch } from "./search.js";
-export { runReindex } from "./reindex.js";
 export { runRestore } from "./restore.js";
 export { runStats } from "./stats.js";
 export { runTest } from "./test.js";
 export { runTestAll } from "./test-all.js";
 export { runStartBackgroundRun, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, runTestRunsWorker, } from "./test-runs.js";
-export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, } from "./templates.js";
 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=a832a3d9-5b89-5660-96ae-68037ae50948

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"/","sources":["cli/commands/index.ts"],"names":[],"mappings":"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","sourcesContent":["export { runAppend } from \"./append.js\";\nexport { runAggregate, type AggregateOptions, type AggregateResult } from \"./aggregate.js\";\nexport { runCompletion, type CompletionResult, type CompletionShell } from \"./completion.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 { runCommentsAudit, type CommentsAuditOptions, type CommentsAuditResult } from \"./comments-audit.js\";\nexport { runConfig, type ConfigCommandOptions, type ConfigResult } from \"./config.js\";\nexport { runContracts, type ContractsCommandOptions, type ContractsResult } from \"./contracts.js\";\nexport {\n  CALENDAR_OUTPUT_VALUES,\n  CALENDAR_VIEW_VALUES,\n  renderCalendarMarkdown,\n  resolveCalendarOutputFormat,\n  runCalendar,\n  type CalendarOptions,\n  type CalendarOutputFormat,\n  type CalendarResult,\n  type CalendarView,\n} from \"./calendar.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 { runDedupeAudit, DEDUPE_AUDIT_MODES, type DedupeAuditMode, type DedupeAuditOptions, type DedupeAuditResult } from \"./dedupe-audit.js\";\nexport { runDocs } from \"./docs.js\";\nexport {\n  GUIDE_DEPTH_VALUES,\n  GUIDE_OUTPUT_VALUES,\n  renderGuideMarkdown,\n  resolveGuideOutputFormat,\n  runGuide,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n} from \"./guide.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 { runNormalize, type NormalizeCommandOptions, type NormalizeResult } from \"./normalize.js\";\nexport { runNotes } from \"./notes.js\";\nexport { runSearch } from \"./search.js\";\nexport { runReindex, type ReindexOptions, type ReindexResult } from \"./reindex.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 {\n  loadCreateTemplateOptions,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n} from \"./templates.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 { runInit } 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 { 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,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,EACL,OAAO,EACP,gBAAgB,EAChB,sBAAsB,GAQvB,MAAM,WAAW,CAAC;AACnB,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":"a832a3d9-5b89-5660-96ae-68037ae50948"}

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>;

package/dist/cli/commands/init-agent-guidance.js

@@ -0,0 +1,336 @@
+
+!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]="5a5676f5-f102-5fdd-9b33-04645e8971c2")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { runActiveOnWriteHooks } from "../../core/extensions/index.js";
+import { pathExists } from "../../core/fs/fs-utils.js";
+export const INIT_AGENT_GUIDANCE_MODE_VALUES = ["ask", "add", "skip", "status"];
+const AGENT_GUIDANCE_TARGET_FILENAMES = ["AGENTS.md", "CLAUDE.md"];
+const AGENT_GUIDANCE_REQUIRED_TOKENS = [
+    "pm init",
+    "pm context",
+    "pm search",
+    "pm create",
+    "pm claim",
+    "pm files",
+    "pm docs",
+    "pm test --run",
+    "pm close",
+    "pm release",
+    "pm_author",
+];
+const AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD = 8;
+const AGENT_GUIDANCE_TEMPLATE_VERSION = 1;
+const AGENT_GUIDANCE_START_MARKER_PREFIX = "<!-- pm-cli:agent-guidance:start:";
+const AGENT_GUIDANCE_START_MARKER = `<!-- pm-cli:agent-guidance:start:v${AGENT_GUIDANCE_TEMPLATE_VERSION} -->`;
+const AGENT_GUIDANCE_END_MARKER = "<!-- pm-cli:agent-guidance:end -->";
+function toPortableRelativePath(projectRoot, targetPath) {
+    const relative = path.relative(projectRoot, targetPath);
+    if (relative.length === 0) {
+        return path.basename(targetPath);
+    }
+    return relative.split(path.sep).join("/");
+}
+function ensureTrailingNewline(value) {
+    return value.endsWith("\n") ? value : `${value}\n`;
+}
+function detectLineEnding(value) {
+    return value.includes("\r\n") ? "\r\n" : "\n";
+}
+function findGuidanceBlockRange(content) {
+    const startIndex = content.indexOf(AGENT_GUIDANCE_START_MARKER_PREFIX);
+    if (startIndex === -1) {
+        return null;
+    }
+    const endMarkerIndex = content.indexOf(AGENT_GUIDANCE_END_MARKER, startIndex);
+    if (endMarkerIndex === -1) {
+        return null;
+    }
+    return {
+        start_index: startIndex,
+        end_index: endMarkerIndex + AGENT_GUIDANCE_END_MARKER.length,
+    };
+}
+function hasGuidanceMarker(content) {
+    return findGuidanceBlockRange(content) !== null;
+}
+function buildAgentGuidanceBlock(lineEnding) {
+    const lines = [
+        AGENT_GUIDANCE_START_MARKER,
+        "## pm Workflow (Agent Quickstart)",
+        "",
+        "- Orient before mutate: `pm context --limit 10`, `pm search \"<keywords>\" --limit 10`, `pm list-open --limit 20`.",
+        "- Claim and execute: `pm claim <id>` then `pm update <id> --status in_progress`.",
+        "- Link evidence while coding: `pm files <id> --add ...`, `pm docs <id> --add ...`, `pm test <id> --add command=\"node scripts/run-tests.mjs test -- ...\"`.",
+        "- Verify and close: `pm test <id> --run --progress`, `pm close <id> \"<evidence>\" --validate-close warn`, `pm release <id>`.",
+        "- Set `PM_AUTHOR=<stable-agent-id>` before mutation commands.",
+        "",
+        AGENT_GUIDANCE_END_MARKER,
+        "",
+    ];
+    return lines.join(lineEnding);
+}
+function upsertAgentGuidanceBlock(existingContent) {
+    const lineEnding = detectLineEnding(existingContent);
+    const nextBlock = buildAgentGuidanceBlock(lineEnding);
+    const existingRange = findGuidanceBlockRange(existingContent);
+    if (existingRange) {
+        const nextContent = ensureTrailingNewline(`${existingContent.slice(0, existingRange.start_index)}${nextBlock}${existingContent.slice(existingRange.end_index)}`);
+        return {
+            next_content: nextContent,
+            changed: nextContent !== existingContent,
+        };
+    }
+    const separator = existingContent.length === 0 ? "" : existingContent.endsWith("\n") ? "\n" : "\n\n";
+    const nextContent = ensureTrailingNewline(`${existingContent}${separator}${nextBlock}`);
+    return {
+        next_content: nextContent,
+        changed: nextContent !== existingContent,
+    };
+}
+function resolveProjectRoot(pmRoot, cwd) {
+    const parent = path.dirname(pmRoot);
+    if (path.basename(pmRoot) === "pm" && path.basename(parent) === ".agents") {
+        return path.dirname(parent);
+    }
+    return path.resolve(cwd, pmRoot);
+}
+function resolveTargetGuidancePath(scans, projectRoot) {
+    const existingAgents = scans.find((entry) => path.basename(entry.file_path) === "AGENTS.md" && entry.exists);
+    if (existingAgents) {
+        return existingAgents.file_path;
+    }
+    const existingAny = scans.find((entry) => entry.exists);
+    if (existingAny) {
+        return existingAny.file_path;
+    }
+    return path.join(projectRoot, "AGENTS.md");
+}
+function parsePromptChoice(answer, currentDefault) {
+    const normalized = answer.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return currentDefault;
+    }
+    if (normalized === "y" || normalized === "yes") {
+        return true;
+    }
+    if (normalized === "n" || normalized === "no") {
+        return false;
+    }
+    return currentDefault;
+}
+async function promptForGuidanceWrite(targetRelativePath) {
+    const rl = readline.createInterface({ input, output });
+    try {
+        output.write("\nAgent guidance check\n");
+        output.write("No AGENTS.md/CLAUDE.md file currently contains compact pm workflow guidance.\n");
+        const answer = await rl.question(`Add a compact pm workflow section to ${targetRelativePath}? [Y/n] `);
+        output.write("\n");
+        return parsePromptChoice(answer, true);
+    }
+    finally {
+        rl.close();
+    }
+}
+function normalizeAgentGuidanceState(settings) {
+    const current = settings.agent_guidance;
+    return {
+        prompt_completed: current?.prompt_completed === true,
+        declined: current?.declined === true,
+        declined_at: typeof current?.declined_at === "string" ? current.declined_at : "",
+        template_version: typeof current?.template_version === "number" && Number.isInteger(current.template_version) && current.template_version > 0
+            ? current.template_version
+            : AGENT_GUIDANCE_TEMPLATE_VERSION,
+        last_checked_files: Array.isArray(current?.last_checked_files)
+            ? [...new Set(current.last_checked_files.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) => left.localeCompare(right))
+            : [],
+    };
+}
+async function scanGuidanceFiles(projectRoot) {
+    const scans = [];
+    for (const filename of AGENT_GUIDANCE_TARGET_FILENAMES) {
+        const filePath = path.join(projectRoot, filename);
+        const exists = await pathExists(filePath);
+        if (!exists) {
+            scans.push({
+                file_path: filePath,
+                exists,
+                has_guidance: false,
+                has_marker: false,
+            });
+            continue;
+        }
+        const content = await fs.readFile(filePath, "utf8");
+        const contentLower = content.toLowerCase();
+        const tokenHits = AGENT_GUIDANCE_REQUIRED_TOKENS.filter((token) => contentLower.includes(token));
+        const hasMarker = hasGuidanceMarker(content);
+        scans.push({
+            file_path: filePath,
+            exists,
+            has_guidance: hasMarker || tokenHits.length >= AGENT_GUIDANCE_REQUIRED_TOKEN_THRESHOLD,
+            has_marker: hasMarker,
+        });
+    }
+    return scans;
+}
+function pushUnique(target, value) {
+    if (!target.includes(value)) {
+        target.push(value);
+    }
+}
+function applyAgentGuidanceState(settings, currentState) {
+    const existing = normalizeAgentGuidanceState(settings);
+    const changed = JSON.stringify(existing) !== JSON.stringify(currentState);
+    if (changed) {
+        settings.agent_guidance = currentState;
+    }
+    return { changed, state: currentState };
+}
+async function writeGuidanceFile(filePath) {
+    const exists = await pathExists(filePath);
+    const currentContent = exists ? await fs.readFile(filePath, "utf8") : "";
+    const nextContent = upsertAgentGuidanceBlock(currentContent);
+    if (!nextContent.changed) {
+        return { changed: false, warnings: [] };
+    }
+    await fs.writeFile(filePath, nextContent.next_content, "utf8");
+    return {
+        changed: true,
+        warnings: await runActiveOnWriteHooks({
+            path: filePath,
+            scope: "project",
+            op: "init:agent_guidance_file",
+        }),
+    };
+}
+export async function runInitAgentGuidance(options) {
+    const warnings = [];
+    const nextSteps = [];
+    const projectRoot = resolveProjectRoot(options.pm_root, options.cwd);
+    let scans = await scanGuidanceFiles(projectRoot);
+    const targetPath = resolveTargetGuidancePath(scans, projectRoot);
+    const targetRelativePath = toPortableRelativePath(projectRoot, targetPath);
+    const addLaterHint = "Add workflow guidance later: pm init --agent-guidance add";
+    let prompted = false;
+    let applied = false;
+    let skipped = false;
+    let state = normalizeAgentGuidanceState(options.settings);
+    const checkedFiles = scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path));
+    const presentBefore = scans.some((entry) => entry.has_guidance);
+    const markState = (partial) => {
+        state = {
+            ...state,
+            ...partial,
+            template_version: AGENT_GUIDANCE_TEMPLATE_VERSION,
+            last_checked_files: checkedFiles,
+        };
+    };
+    if (options.mode === "status") {
+        if (!presentBefore) {
+            warnings.push("agent_guidance:missing");
+            pushUnique(nextSteps, addLaterHint);
+        }
+    }
+    else if (options.mode === "skip") {
+        skipped = true;
+        markState({
+            prompt_completed: true,
+            declined: true,
+            declined_at: state.declined_at.length > 0 ? state.declined_at : new Date().toISOString(),
+        });
+        warnings.push("agent_guidance:explicit_skip");
+        pushUnique(nextSteps, addLaterHint);
+    }
+    else if (options.mode === "add") {
+        if (!presentBefore) {
+            const writeResult = await writeGuidanceFile(targetPath);
+            warnings.push(...writeResult.warnings);
+            if (writeResult.changed) {
+                applied = true;
+                warnings.push(`agent_guidance:added:${targetRelativePath}`);
+            }
+        }
+        markState({
+            prompt_completed: true,
+            declined: false,
+            declined_at: "",
+        });
+    }
+    else if (presentBefore) {
+        if (state.declined) {
+            markState({
+                prompt_completed: true,
+                declined: false,
+                declined_at: "",
+            });
+        }
+    }
+    else if (state.prompt_completed && state.declined) {
+        skipped = true;
+        warnings.push("agent_guidance:skipped_declined");
+        pushUnique(nextSteps, addLaterHint);
+    }
+    else if (options.interactive) {
+        prompted = true;
+        const approved = await promptForGuidanceWrite(targetRelativePath);
+        if (approved) {
+            const writeResult = await writeGuidanceFile(targetPath);
+            warnings.push(...writeResult.warnings);
+            if (writeResult.changed) {
+                applied = true;
+                warnings.push(`agent_guidance:added:${targetRelativePath}`);
+            }
+            markState({
+                prompt_completed: true,
+                declined: false,
+                declined_at: "",
+            });
+        }
+        else {
+            skipped = true;
+            markState({
+                prompt_completed: true,
+                declined: true,
+                declined_at: new Date().toISOString(),
+            });
+            warnings.push("agent_guidance:declined");
+            pushUnique(nextSteps, addLaterHint);
+        }
+    }
+    else {
+        warnings.push("agent_guidance:missing_non_interactive");
+        pushUnique(nextSteps, addLaterHint);
+    }
+    const stateUpdate = applyAgentGuidanceState(options.settings, state);
+    if (applied) {
+        scans = await scanGuidanceFiles(projectRoot);
+    }
+    const summary = {
+        mode: options.mode,
+        present: scans.some((entry) => entry.has_guidance),
+        prompted,
+        applied,
+        skipped,
+        declined: state.declined,
+        prompt_completed: state.prompt_completed,
+        template_version: state.template_version,
+        target_file: targetRelativePath,
+        checked_files: scans.map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),
+        files_with_guidance: scans
+            .filter((entry) => entry.has_guidance)
+            .map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),
+        missing_files: scans
+            .filter((entry) => !entry.exists)
+            .map((entry) => toPortableRelativePath(projectRoot, entry.file_path)),
+    };
+    return {
+        summary,
+        warnings,
+        next_steps: nextSteps,
+        settings_changed: stateUpdate.changed,
+    };
+}
+//# sourceMappingURL=init-agent-guidance.js.map
+//# debugId=5a5676f5-f102-5fdd-9b33-04645e8971c2