@unbrained/pm-cli 2026.7.14 → 2026.7.15

package/dist/cli/commands/history.js

@@ -4,16 +4,17 @@
  * Implements the pm history command surface and its agent-facing runtime behavior.
  */
 
-!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]="aa0d10d7-7883-5fbe-9091-55e5fc510727")}catch(e){}}();
-import { pathExists, readFileIfExists } from "../../core/fs/fs-utils.js";
+!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]="f90cbd0d-51a4-5974-ba46-d662e680142e")}catch(e){}}();
+import { pathExists } from "../../core/fs/fs-utils.js";
 import { computeHistoryDiff, patchPathToChangedField, } from "../../core/history/history-diff.js";
 import { hashDocument, hashEmptyDocument } from "../../core/history/history.js";
 import { normalizeReplayPatchOps, verifyHistoryChain, } from "../../core/history/replay.js";
 import { enforceHistoryStreamPolicyForItem } from "../../core/history/history-stream-policy.js";
+import { readHistoryEntries } from "../../sdk/history-read.js";
+export { readHistoryEntries } from "../../sdk/history-read.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
-import { findFirstMergeConflictMarker } from "../../core/shared/conflict-markers.js";
 import { PmCliError } from "../../core/shared/errors.js";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, } from "../../core/extensions/index.js";
+import { getActiveExtensionRegistrations, } from "../../core/extensions/index.js";
 import { normalizeItemId } from "../../core/item/id.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { locateItem, readLocatedItem } from "../../core/store/item-store.js";
@@ -46,49 +47,6 @@ function buildDiffEntries(entries, startIndex) {
         };
     });
 }
-/** Implements read history entries for the public runtime surface of this module. */
-export async function readHistoryEntries(historyPath, itemId) {
-    const raw = await readFileIfExists(historyPath);
-    if (raw === null) {
-        return [];
-    }
-    await runActiveOnReadHooks({
-        path: historyPath,
-        scope: "project",
-    });
-    if (raw.trim() === "") {
-        return [];
-    }
-    const conflictMarker = findFirstMergeConflictMarker(raw);
-    if (conflictMarker) {
-        throw new PmCliError(`History for ${itemId} contains merge conflict markers at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`, EXIT_CODE.GENERIC_FAILURE, {
-            code: "history_merge_conflict_markers_detected",
-            required: "Repair the history stream by resolving merge-conflict markers.",
-            why: "Conflict markers break JSONL parsing and invalidate deterministic audit history.",
-            examples: [
-                `pm history ${itemId}`,
-                `pm restore ${itemId} <timestamp-or-version>`,
-            ],
-            nextSteps: [
-                "Resolve or restore the history file, then rerun the command.",
-            ],
-        });
-    }
-    const entries = [];
-    const lines = raw.split(/\r?\n/);
-    for (let index = 0; index < lines.length; index += 1) {
-        const line = lines[index]?.trim();
-        if (!line)
-            continue;
-        try {
-            entries.push(JSON.parse(line));
-        }
-        catch {
-            throw new PmCliError(`History for ${itemId} contains invalid JSON at line ${index + 1}. Repair or restore the history stream and retry.`, EXIT_CODE.GENERIC_FAILURE);
-        }
-    }
-    return entries;
-}
 /** Implements run history for the public runtime surface of this module. */
 export async function runHistory(id, options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
@@ -173,4 +131,4 @@ export async function runHistory(id, options, global) {
     return result;
 }
 //# sourceMappingURL=history.js.map
-//# debugId=aa0d10d7-7883-5fbe-9091-55e5fc510727
+//# debugId=f90cbd0d-51a4-5974-ba46-d662e680142e

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

@@ -1 +1 @@
-{"version":3,"file":"history.js","sources":["cli/commands/history.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/history\n *\n * Implements the pm history command surface and its agent-facing runtime behavior.\n */\nimport { pathExists, readFileIfExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  computeHistoryDiff,\n  patchPathToChangedField,\n  type HistoryDiffValueEntry,\n} from \"../../core/history/history-diff.js\";\nimport { hashDocument, hashEmptyDocument } from \"../../core/history/history.js\";\nimport {\n  normalizeReplayPatchOps,\n  verifyHistoryChain,\n} from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { findFirstMergeConflictMarker } from \"../../core/shared/conflict-markers.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveOnReadHooks,\n} 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 {\n  getHistoryPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\nexport { verifyHistoryChain } from \"../../core/history/replay.js\";\n\n/** Documents the history command options payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryCommandOptions {\n  /** Value that configures or reports limit for this contract. */\n  limit?: string;\n  /** Value that configures or reports diff for this contract. */\n  diff?: boolean;\n  /** Restrict --diff to a single field's before/after transitions (implies --diff). */\n  field?: string;\n  /** Value that configures or reports verify for this contract. */\n  verify?: boolean;\n  /** Value that configures or reports compact for this contract. */\n  compact?: boolean;\n}\n\n/** Documents the history diff entry payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryDiffEntry {\n  /** Value that configures or reports index for this contract. */\n  index: number;\n  /** Value that configures or reports ts for this contract. */\n  ts: string;\n  /** Value that configures or reports op for this contract. */\n  op: string;\n  /** Value that configures or reports author for this contract. */\n  author: string;\n  /** Value that configures or reports patch ops for this contract. */\n  patch_ops: number;\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n}\n\n/** Documents the history verification result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryVerificationResult {\n  /** Whether the operation completed without a blocking failure. */\n  ok: boolean;\n  /** Value that configures or reports entries for this contract. */\n  entries: number;\n  /** Value that configures or reports errors for this contract. */\n  errors: string[];\n  /** Value that configures or reports latest after hash for this contract. */\n  latest_after_hash?: string;\n  /** Value that configures or reports current item hash for this contract. */\n  current_item_hash?: string;\n  /** Value that configures or reports current matches latest for this contract. */\n  current_matches_latest?: boolean;\n}\n\n/** Documents the history result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports history for this contract. */\n  history: HistoryEntry[];\n  /** Value that configures or reports compact history for this contract. */\n  compact_history?: HistoryDiffEntry[];\n  /** Value that configures or reports compact for this contract. */\n  compact: boolean;\n  /** Value that configures or reports count for this contract. */\n  count: number;\n  /** Value that configures or reports limit for this contract. */\n  limit: number | null;\n  /** Value that configures or reports diff for this contract. */\n  diff?: HistoryDiffValueEntry[];\n  /** Value that configures or reports verification for this contract. */\n  verification?: HistoryVerificationResult;\n}\n\nfunction limitEntries<T>(values: T[], limit: number | undefined): T[] {\n  if (limit === undefined) return values;\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nfunction buildDiffEntries(\n  entries: HistoryEntry[],\n  startIndex: number,\n): HistoryDiffEntry[] {\n  return entries.map((entry, index) => {\n    const changedFields = new Set<string>();\n    const patch = normalizeReplayPatchOps(entry.patch);\n    for (const op of 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: patch.length,\n      changed_fields: [...changedFields].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n    };\n  });\n}\n\n/** Implements read history entries for the public runtime surface of this module. */\nexport async function readHistoryEntries(\n  historyPath: string,\n  itemId: string,\n): 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:\n          \"Repair the history stream by resolving merge-conflict markers.\",\n        why: \"Conflict markers break JSONL parsing and invalidate deterministic audit history.\",\n        examples: [\n          `pm history ${itemId}`,\n          `pm restore ${itemId} <timestamp-or-version>`,\n        ],\n        nextSteps: [\n          \"Resolve or restore the history file, then rerun the command.\",\n        ],\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\n/** Implements run history for the public runtime surface of this module. */\nexport async function runHistory(\n  id: string,\n  options: HistoryCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const limit = parseLimit(options.limit);\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\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  /* c8 ignore next -- resolved ids in command tests always map to located items. */\n  if (located) {\n    await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"history\",\n    });\n  }\n\n  const fullHistory = await readHistoryEntries(historyPath, resolvedId);\n  const history = limitEntries(fullHistory, limit);\n  const compact = options.compact === true;\n  const compactHistory = compact\n    ? buildDiffEntries(\n        history,\n        Math.max(0, fullHistory.length - history.length),\n      )\n    : undefined;\n  const result: HistoryResult = {\n    id: resolvedId,\n    history: compact ? [] : history,\n    compact_history: compactHistory,\n    compact,\n    count: history.length,\n    limit: limit ?? null,\n  };\n\n  if (options.diff || options.field !== undefined) {\n    // --diff replays the full chain to surface per-field before/after values for\n    // the displayed window (the latest --limit entries). --field narrows to a\n    // single field's transitions (\"when did status change?\"). Unlike the compact\n    // projection above, the value diff is independent of the compact/full toggle.\n    result.diff = computeHistoryDiff(fullHistory, {\n      windowStartIndex: Math.max(0, fullHistory.length - history.length),\n      field: options.field,\n    });\n  }\n\n  if (options.verify) {\n    const verification = verifyHistoryChain(fullHistory);\n    /* c8 ignore next -- verify path operates on non-empty streams in command-level coverage. */\n    const latestAfterHash =\n      fullHistory.length > 0\n        ? fullHistory[fullHistory.length - 1].after_hash\n        : hashEmptyDocument();\n    let currentItemHash: string | undefined;\n    let currentMatchesLatest: boolean | undefined;\n    const errors = [...verification.errors];\n\n    /* c8 ignore next -- verify command paths currently execute with located on-disk items. */\n    if (located) {\n      const loaded = await readLocatedItem(located, {\n        schema: settings.schema,\n      });\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      /* c8 ignore next -- empty-history verification payloads are covered by lower-level stream tests. */\n      latest_after_hash:\n        fullHistory.length > 0\n          ? fullHistory[fullHistory.length - 1].after_hash\n          : 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":"aa0d10d7-7883-5fbe-9091-55e5fc510727"}
+{"version":3,"file":"history.js","sources":["cli/commands/history.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/history\n *\n * Implements the pm history command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  computeHistoryDiff,\n  patchPathToChangedField,\n  type HistoryDiffValueEntry,\n} from \"../../core/history/history-diff.js\";\nimport { hashDocument, hashEmptyDocument } from \"../../core/history/history.js\";\nimport {\n  normalizeReplayPatchOps,\n  verifyHistoryChain,\n} from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { readHistoryEntries } from \"../../sdk/history-read.js\";\nexport { readHistoryEntries } from \"../../sdk/history-read.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 {\n  getActiveExtensionRegistrations,\n} 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 {\n  getHistoryPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\nexport { verifyHistoryChain } from \"../../core/history/replay.js\";\n\n/** Documents the history command options payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryCommandOptions {\n  /** Value that configures or reports limit for this contract. */\n  limit?: string;\n  /** Value that configures or reports diff for this contract. */\n  diff?: boolean;\n  /** Restrict --diff to a single field's before/after transitions (implies --diff). */\n  field?: string;\n  /** Value that configures or reports verify for this contract. */\n  verify?: boolean;\n  /** Value that configures or reports compact for this contract. */\n  compact?: boolean;\n}\n\n/** Documents the history diff entry payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryDiffEntry {\n  /** Value that configures or reports index for this contract. */\n  index: number;\n  /** Value that configures or reports ts for this contract. */\n  ts: string;\n  /** Value that configures or reports op for this contract. */\n  op: string;\n  /** Value that configures or reports author for this contract. */\n  author: string;\n  /** Value that configures or reports patch ops for this contract. */\n  patch_ops: number;\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n}\n\n/** Documents the history verification result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryVerificationResult {\n  /** Whether the operation completed without a blocking failure. */\n  ok: boolean;\n  /** Value that configures or reports entries for this contract. */\n  entries: number;\n  /** Value that configures or reports errors for this contract. */\n  errors: string[];\n  /** Value that configures or reports latest after hash for this contract. */\n  latest_after_hash?: string;\n  /** Value that configures or reports current item hash for this contract. */\n  current_item_hash?: string;\n  /** Value that configures or reports current matches latest for this contract. */\n  current_matches_latest?: boolean;\n}\n\n/** Documents the history result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports history for this contract. */\n  history: HistoryEntry[];\n  /** Value that configures or reports compact history for this contract. */\n  compact_history?: HistoryDiffEntry[];\n  /** Value that configures or reports compact for this contract. */\n  compact: boolean;\n  /** Value that configures or reports count for this contract. */\n  count: number;\n  /** Value that configures or reports limit for this contract. */\n  limit: number | null;\n  /** Value that configures or reports diff for this contract. */\n  diff?: HistoryDiffValueEntry[];\n  /** Value that configures or reports verification for this contract. */\n  verification?: HistoryVerificationResult;\n}\n\nfunction limitEntries<T>(values: T[], limit: number | undefined): T[] {\n  if (limit === undefined) return values;\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nfunction buildDiffEntries(\n  entries: HistoryEntry[],\n  startIndex: number,\n): HistoryDiffEntry[] {\n  return entries.map((entry, index) => {\n    const changedFields = new Set<string>();\n    const patch = normalizeReplayPatchOps(entry.patch);\n    for (const op of 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: patch.length,\n      changed_fields: [...changedFields].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n    };\n  });\n}\n\n/** Implements run history for the public runtime surface of this module. */\nexport async function runHistory(\n  id: string,\n  options: HistoryCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const limit = parseLimit(options.limit);\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\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  /* c8 ignore next -- resolved ids in command tests always map to located items. */\n  if (located) {\n    await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"history\",\n    });\n  }\n\n  const fullHistory = await readHistoryEntries(historyPath, resolvedId);\n  const history = limitEntries(fullHistory, limit);\n  const compact = options.compact === true;\n  const compactHistory = compact\n    ? buildDiffEntries(\n        history,\n        Math.max(0, fullHistory.length - history.length),\n      )\n    : undefined;\n  const result: HistoryResult = {\n    id: resolvedId,\n    history: compact ? [] : history,\n    compact_history: compactHistory,\n    compact,\n    count: history.length,\n    limit: limit ?? null,\n  };\n\n  if (options.diff || options.field !== undefined) {\n    // --diff replays the full chain to surface per-field before/after values for\n    // the displayed window (the latest --limit entries). --field narrows to a\n    // single field's transitions (\"when did status change?\"). Unlike the compact\n    // projection above, the value diff is independent of the compact/full toggle.\n    result.diff = computeHistoryDiff(fullHistory, {\n      windowStartIndex: Math.max(0, fullHistory.length - history.length),\n      field: options.field,\n    });\n  }\n\n  if (options.verify) {\n    const verification = verifyHistoryChain(fullHistory);\n    /* c8 ignore next -- verify path operates on non-empty streams in command-level coverage. */\n    const latestAfterHash =\n      fullHistory.length > 0\n        ? fullHistory[fullHistory.length - 1].after_hash\n        : hashEmptyDocument();\n    let currentItemHash: string | undefined;\n    let currentMatchesLatest: boolean | undefined;\n    const errors = [...verification.errors];\n\n    /* c8 ignore next -- verify command paths currently execute with located on-disk items. */\n    if (located) {\n      const loaded = await readLocatedItem(located, {\n        schema: settings.schema,\n      });\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      /* c8 ignore next -- empty-history verification payloads are covered by lower-level stream tests. */\n      latest_after_hash:\n        fullHistory.length > 0\n          ? fullHistory[fullHistory.length - 1].after_hash\n          : 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":"f90cbd0d-51a4-5974-ba46-d662e680142e"}

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

@@ -32,6 +32,7 @@ export { runHistoryCompact, type HistoryCompactCommandOptions, type HistoryCompa
 export { runHistoryRedact, type HistoryRedactCommandOptions, type HistoryRedactResult, } from "./history-redact.js";
 export { assertHistoryRepairTarget, runHistoryRepair, runHistoryRepairAll, type HistoryRepairAllResult, type HistoryRepairAllStreamResult, type HistoryRepairCommandOptions, type HistoryRepairResult, } from "./history-repair.js";
 export { runInit, summarizeInitResult, type InitConciseResult, } from "./init.js";
+export { INIT_AGENT_GUIDANCE_MODE_VALUES, runInitAgentGuidance, type InitAgentGuidanceMode, type InitAgentGuidanceSummary, type RunInitAgentGuidanceOptions, type RunInitAgentGuidanceResult, } from "./init-agent-guidance.js";
 export { runLearnings } from "./learnings.js";
 export { runList, type ListOptions } from "./list.js";
 export { runNotes } from "./notes.js";

package/dist/cli/commands/index.js

@@ -4,7 +4,7 @@
  * Implements the pm command index command surface and its agent-facing runtime behavior.
  */
 
-!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]="6d1b0e84-6deb-50ac-88dc-86cdeccf724f")}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]="a2c3675b-3c03-501f-8d2f-2405db17fabb")}catch(e){}}();
 export { runAppend } from "./append.js";
 export { runAggregate, } from "./aggregate.js";
 export { runActivity } from "./activity.js";
@@ -34,6 +34,7 @@ export { runHistoryCompact, } from "./history-compact.js";
 export { runHistoryRedact, } from "./history-redact.js";
 export { assertHistoryRepairTarget, runHistoryRepair, runHistoryRepairAll, } from "./history-repair.js";
 export { runInit, summarizeInitResult, } from "./init.js";
+export { INIT_AGENT_GUIDANCE_MODE_VALUES, runInitAgentGuidance, } from "./init-agent-guidance.js";
 export { runLearnings } from "./learnings.js";
 export { runList } from "./list.js";
 export { runNotes } from "./notes.js";
@@ -53,4 +54,4 @@ export { runUpdateMany, } from "./update-many.js";
 export { runUpgrade, } from "./upgrade.js";
 export { runValidate, } from "./validate.js";
 //# sourceMappingURL=index.js.map
-//# debugId=6d1b0e84-6deb-50ac-88dc-86cdeccf724f
+//# debugId=a2c3675b-3c03-501f-8d2f-2405db17fabb

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["cli/commands/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/index\n *\n * Implements the pm command index command surface and its agent-facing runtime behavior.\n */\nexport { runAppend } from \"./append.js\";\nexport {\n  runAggregate,\n  type AggregateOptions,\n  type AggregateResult,\n} from \"./aggregate.js\";\nexport { runActivity } from \"./activity.js\";\nexport { runClaim, runClaimNext, runRelease } from \"./claim.js\";\nexport {\n  runClose,\n  type CloseCommandOptions,\n  type CloseResult,\n} from \"./close.js\";\nexport {\n  runCloseMany,\n  type CloseManyCommandOptions,\n  type CloseManyResult,\n} from \"./close-many.js\";\nexport { runComments } from \"./comments.js\";\nexport {\n  runConfig,\n  type ConfigCommandOptions,\n  type ConfigResult,\n} from \"./config.js\";\nexport {\n  runContracts,\n  type ContractsCommandOptions,\n  type ContractsResult,\n} from \"./contracts.js\";\nexport {\n  CONTEXT_OUTPUT_VALUES,\n  buildChildrenByParent,\n  collectSubtreeIds,\n  compareCriticalItems,\n  renderContextMarkdown,\n  resolveContextOutputFormat,\n  runContext,\n  toContextFocusItem,\n  type ContextFocusItem,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n} from \"./context.js\";\nexport {\n  NEXT_OUTPUT_VALUES,\n  renderNextMarkdown,\n  resolveNextOutputFormat,\n  runNext,\n  type NextActionableItem,\n  type NextBlockerRef,\n  type NextOptions,\n  type NextOutputFormat,\n  type NextRecommendation,\n  type NextResult,\n} from \"./next.js\";\nexport { runCreate, type CreateCommandOptions } from \"./create.js\";\nexport { runCopy, type CopyOptions, type CopyResult } from \"./copy.js\";\nexport { runFocus, type FocusOptions, type FocusResult } from \"./focus.js\";\nexport {\n  runMeet,\n  runEvent,\n  runRemind,\n  type MeetingEventShortcutOptions,\n  type ReminderShortcutOptions,\n  type SchedulingShortcutCommonOptions,\n} from \"./scheduling-shortcuts.js\";\nexport {\n  suggestNextLifecycleTransition,\n  type LifecycleTransitionSuggestion,\n} from \"./lifecycle-transitions.js\";\nexport {\n  runDelete,\n  type DeleteCommandOptions,\n  type DeleteResult,\n} from \"./delete.js\";\nexport {\n  runDeps,\n  DEPS_FORMAT_VALUES,\n  type DepsCommandOptions,\n  type DepsFormat,\n  type DepsResult,\n} from \"./deps.js\";\nexport { runDocs } from \"./docs.js\";\nexport {\n  runExtension,\n  type ExtensionCommandOptions,\n  type ExtensionCommandResult,\n} 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 {\n  runHistoryCompact,\n  type HistoryCompactCommandOptions,\n  type HistoryCompactResult,\n} from \"./history-compact.js\";\nexport {\n  runHistoryRedact,\n  type HistoryRedactCommandOptions,\n  type HistoryRedactResult,\n} from \"./history-redact.js\";\nexport {\n  assertHistoryRepairTarget,\n  runHistoryRepair,\n  runHistoryRepairAll,\n  type HistoryRepairAllResult,\n  type HistoryRepairAllStreamResult,\n  type HistoryRepairCommandOptions,\n  type HistoryRepairResult,\n} from \"./history-repair.js\";\nexport {\n  runInit,\n  summarizeInitResult,\n  type InitConciseResult,\n} 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  runSchemaAddField,\n  runSchemaRemoveField,\n  runSchemaListFields,\n  runSchemaShowField,\n  runSchemaApplyPreset,\n  runSchemaInferTypes,\n  runSchemaList,\n  runSchemaShow,\n  runSchemaShowStatus,\n  formatSchemaAddTypeHuman,\n  formatSchemaRemoveTypeHuman,\n  formatSchemaAddStatusHuman,\n  formatSchemaRemoveStatusHuman,\n  formatSchemaAddFieldHuman,\n  formatSchemaRemoveFieldHuman,\n  formatSchemaListFieldsHuman,\n  formatSchemaShowFieldHuman,\n  formatSchemaApplyPresetHuman,\n  formatSchemaInferTypesHuman,\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 SchemaAddFieldCommandOptions,\n  type SchemaAddFieldResult,\n  type SchemaRemoveFieldCommandOptions,\n  type SchemaRemoveFieldResult,\n  type SchemaListFieldsResult,\n  type SchemaShowFieldResult,\n  type SchemaApplyPresetCommandOptions,\n  type SchemaApplyPresetResult,\n  type SchemaAddTypeInferCommandOptions,\n  type SchemaAddTypeInferResult,\n  type SchemaListResult,\n  type SchemaShowResult,\n  type SchemaShowStatusResult,\n} from \"./schema.js\";\nexport {\n  runProfileApply,\n  runProfileLint,\n  runProfileList,\n  runProfileShow,\n  formatProfileApplyHuman,\n  formatProfileLintHuman,\n  formatProfileListHuman,\n  formatProfileShowHuman,\n  PROFILE_SUBCOMMANDS,\n  type ProfileSubcommand,\n  type ProfileApplyCommandOptions,\n  type ProfileApplyResult,\n  type ProfileLintResult,\n  type ProfileListResult,\n  type ProfileShowResult,\n  type ProfileResult,\n} from \"./profile.js\";\nexport { runSearch } from \"./search.js\";\nexport { runEval } from \"./eval.js\";\nexport { runRestore } from \"./restore.js\";\nexport { runStats } from \"./stats.js\";\nexport {\n  runTelemetry,\n  TELEMETRY_SUBCOMMANDS,\n  type TelemetryCommandOptions,\n  type TelemetrySubcommand,\n} 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 {\n  runUpdateMany,\n  type UpdateManyCommandOptions,\n  type UpdateManyResult,\n} from \"./update-many.js\";\nexport {\n  runUpgrade,\n  type UpgradeCommandOptions,\n  type UpgradeResult,\n} from \"./upgrade.js\";\nexport {\n  runValidate,\n  type ValidateCheck,\n  type ValidateCommandOptions,\n  type ValidateResult,\n} from \"./validate.js\";\n"],"names":[],"mappings":"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","debugId":"6d1b0e84-6deb-50ac-88dc-86cdeccf724f"}
+{"version":3,"file":"index.js","sources":["cli/commands/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/index\n *\n * Implements the pm command index command surface and its agent-facing runtime behavior.\n */\nexport { runAppend } from \"./append.js\";\nexport {\n  runAggregate,\n  type AggregateOptions,\n  type AggregateResult,\n} from \"./aggregate.js\";\nexport { runActivity } from \"./activity.js\";\nexport { runClaim, runClaimNext, runRelease } from \"./claim.js\";\nexport {\n  runClose,\n  type CloseCommandOptions,\n  type CloseResult,\n} from \"./close.js\";\nexport {\n  runCloseMany,\n  type CloseManyCommandOptions,\n  type CloseManyResult,\n} from \"./close-many.js\";\nexport { runComments } from \"./comments.js\";\nexport {\n  runConfig,\n  type ConfigCommandOptions,\n  type ConfigResult,\n} from \"./config.js\";\nexport {\n  runContracts,\n  type ContractsCommandOptions,\n  type ContractsResult,\n} from \"./contracts.js\";\nexport {\n  CONTEXT_OUTPUT_VALUES,\n  buildChildrenByParent,\n  collectSubtreeIds,\n  compareCriticalItems,\n  renderContextMarkdown,\n  resolveContextOutputFormat,\n  runContext,\n  toContextFocusItem,\n  type ContextFocusItem,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n} from \"./context.js\";\nexport {\n  NEXT_OUTPUT_VALUES,\n  renderNextMarkdown,\n  resolveNextOutputFormat,\n  runNext,\n  type NextActionableItem,\n  type NextBlockerRef,\n  type NextOptions,\n  type NextOutputFormat,\n  type NextRecommendation,\n  type NextResult,\n} from \"./next.js\";\nexport { runCreate, type CreateCommandOptions } from \"./create.js\";\nexport { runCopy, type CopyOptions, type CopyResult } from \"./copy.js\";\nexport { runFocus, type FocusOptions, type FocusResult } from \"./focus.js\";\nexport {\n  runMeet,\n  runEvent,\n  runRemind,\n  type MeetingEventShortcutOptions,\n  type ReminderShortcutOptions,\n  type SchedulingShortcutCommonOptions,\n} from \"./scheduling-shortcuts.js\";\nexport {\n  suggestNextLifecycleTransition,\n  type LifecycleTransitionSuggestion,\n} from \"./lifecycle-transitions.js\";\nexport {\n  runDelete,\n  type DeleteCommandOptions,\n  type DeleteResult,\n} from \"./delete.js\";\nexport {\n  runDeps,\n  DEPS_FORMAT_VALUES,\n  type DepsCommandOptions,\n  type DepsFormat,\n  type DepsResult,\n} from \"./deps.js\";\nexport { runDocs } from \"./docs.js\";\nexport {\n  runExtension,\n  type ExtensionCommandOptions,\n  type ExtensionCommandResult,\n} 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 {\n  runHistoryCompact,\n  type HistoryCompactCommandOptions,\n  type HistoryCompactResult,\n} from \"./history-compact.js\";\nexport {\n  runHistoryRedact,\n  type HistoryRedactCommandOptions,\n  type HistoryRedactResult,\n} from \"./history-redact.js\";\nexport {\n  assertHistoryRepairTarget,\n  runHistoryRepair,\n  runHistoryRepairAll,\n  type HistoryRepairAllResult,\n  type HistoryRepairAllStreamResult,\n  type HistoryRepairCommandOptions,\n  type HistoryRepairResult,\n} from \"./history-repair.js\";\nexport {\n  runInit,\n  summarizeInitResult,\n  type InitConciseResult,\n} from \"./init.js\";\nexport {\n  INIT_AGENT_GUIDANCE_MODE_VALUES,\n  runInitAgentGuidance,\n  type InitAgentGuidanceMode,\n  type InitAgentGuidanceSummary,\n  type RunInitAgentGuidanceOptions,\n  type RunInitAgentGuidanceResult,\n} from \"./init-agent-guidance.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  runSchemaAddField,\n  runSchemaRemoveField,\n  runSchemaListFields,\n  runSchemaShowField,\n  runSchemaApplyPreset,\n  runSchemaInferTypes,\n  runSchemaList,\n  runSchemaShow,\n  runSchemaShowStatus,\n  formatSchemaAddTypeHuman,\n  formatSchemaRemoveTypeHuman,\n  formatSchemaAddStatusHuman,\n  formatSchemaRemoveStatusHuman,\n  formatSchemaAddFieldHuman,\n  formatSchemaRemoveFieldHuman,\n  formatSchemaListFieldsHuman,\n  formatSchemaShowFieldHuman,\n  formatSchemaApplyPresetHuman,\n  formatSchemaInferTypesHuman,\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 SchemaAddFieldCommandOptions,\n  type SchemaAddFieldResult,\n  type SchemaRemoveFieldCommandOptions,\n  type SchemaRemoveFieldResult,\n  type SchemaListFieldsResult,\n  type SchemaShowFieldResult,\n  type SchemaApplyPresetCommandOptions,\n  type SchemaApplyPresetResult,\n  type SchemaAddTypeInferCommandOptions,\n  type SchemaAddTypeInferResult,\n  type SchemaListResult,\n  type SchemaShowResult,\n  type SchemaShowStatusResult,\n} from \"./schema.js\";\nexport {\n  runProfileApply,\n  runProfileLint,\n  runProfileList,\n  runProfileShow,\n  formatProfileApplyHuman,\n  formatProfileLintHuman,\n  formatProfileListHuman,\n  formatProfileShowHuman,\n  PROFILE_SUBCOMMANDS,\n  type ProfileSubcommand,\n  type ProfileApplyCommandOptions,\n  type ProfileApplyResult,\n  type ProfileLintResult,\n  type ProfileListResult,\n  type ProfileShowResult,\n  type ProfileResult,\n} from \"./profile.js\";\nexport { runSearch } from \"./search.js\";\nexport { runEval } from \"./eval.js\";\nexport { runRestore } from \"./restore.js\";\nexport { runStats } from \"./stats.js\";\nexport {\n  runTelemetry,\n  TELEMETRY_SUBCOMMANDS,\n  type TelemetryCommandOptions,\n  type TelemetrySubcommand,\n} 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 {\n  runUpdateMany,\n  type UpdateManyCommandOptions,\n  type UpdateManyResult,\n} from \"./update-many.js\";\nexport {\n  runUpgrade,\n  type UpgradeCommandOptions,\n  type UpgradeResult,\n} from \"./upgrade.js\";\nexport {\n  runValidate,\n  type ValidateCheck,\n  type ValidateCommandOptions,\n  type ValidateResult,\n} from \"./validate.js\";\n"],"names":[],"mappings":"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","debugId":"a2c3675b-3c03-501f-8d2f-2405db17fabb"}

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

@@ -1,113 +1,6 @@
-import readline from "node:readline/promises";
-import type { PmSettings } from "../../types/index.js";
-/** Restricts init agent guidance mode values accepted by command, SDK, and storage contracts. */
-export type InitAgentGuidanceMode = "ask" | "add" | "skip" | "status";
-/** Supported values accepted by the init agent guidance mode contract. */
-export declare const INIT_AGENT_GUIDANCE_MODE_VALUES: InitAgentGuidanceMode[];
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-    toPortableRelativePath: typeof toPortableRelativePath;
-    ensureTrailingNewline: typeof ensureTrailingNewline;
-    detectLineEnding: typeof detectLineEnding;
-    findGuidanceBlockRange: typeof findGuidanceBlockRange;
-    buildAgentGuidanceBlock: typeof buildAgentGuidanceBlock;
-    upsertAgentGuidanceBlock: typeof upsertAgentGuidanceBlock;
-    resolveProjectRoot: typeof resolveProjectRoot;
-    resolveTargetGuidancePath: typeof resolveTargetGuidancePath;
-    parsePromptChoice: typeof parsePromptChoice;
-    pushUnique: typeof pushUnique;
-    promptForGuidanceWrite: typeof promptForGuidanceWrite;
-    normalizeAgentGuidanceState: typeof normalizeAgentGuidanceState;
-    applyAgentGuidanceState: typeof applyAgentGuidanceState;
-    writeGuidanceFile: typeof writeGuidanceFile;
-    setAgentGuidanceReadlineFactoryForTests: typeof setAgentGuidanceReadlineFactoryForTests;
-};
-type AgentGuidanceReadlineInterface = ReturnType<typeof readline.createInterface>;
-declare function setAgentGuidanceReadlineFactoryForTests(factory: (() => AgentGuidanceReadlineInterface) | undefined): void;
-interface AgentGuidanceFileScan {
-    file_path: string;
-    exists: boolean;
-    has_guidance: boolean;
-    has_marker: boolean;
-}
-interface AgentGuidanceBlockRange {
-    start_index: number;
-    end_index: number;
-}
-/** Documents the init agent guidance summary payload exchanged by command, SDK, and package integrations. */
-export interface InitAgentGuidanceSummary {
-    /** Value that configures or reports mode for this contract. */
-    mode: InitAgentGuidanceMode;
-    /** Value that configures or reports present for this contract. */
-    present: boolean;
-    /** Value that configures or reports prompted for this contract. */
-    prompted: boolean;
-    /** Value that configures or reports applied for this contract. */
-    applied: boolean;
-    /** Value that configures or reports skipped for this contract. */
-    skipped: boolean;
-    /** Value that configures or reports declined for this contract. */
-    declined: boolean;
-    /** Value that configures or reports prompt completed for this contract. */
-    prompt_completed: boolean;
-    /** Value that configures or reports template version for this contract. */
-    template_version: number;
-    /** Value that configures or reports target file for this contract. */
-    target_file: string;
-    /** Value that configures or reports checked files for this contract. */
-    checked_files: string[];
-    /** Value that configures or reports files with guidance for this contract. */
-    files_with_guidance: string[];
-    /** Value that configures or reports missing files for this contract. */
-    missing_files: string[];
-}
-/** Documents the run init agent guidance options payload exchanged by command, SDK, and package integrations. */
-export interface RunInitAgentGuidanceOptions {
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Value that configures or reports cwd for this contract. */
-    cwd: string;
-    /** Value that configures or reports mode for this contract. */
-    mode: InitAgentGuidanceMode;
-    /** Value that configures or reports interactive for this contract. */
-    interactive: boolean;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-}
-/** Documents the run init agent guidance result payload exchanged by command, SDK, and package integrations. */
-export interface RunInitAgentGuidanceResult {
-    /** Value that configures or reports summary for this contract. */
-    summary: InitAgentGuidanceSummary;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports next steps for this contract. */
-    next_steps: string[];
-    /** Value that configures or reports settings changed for this contract. */
-    settings_changed: boolean;
-}
-declare function toPortableRelativePath(projectRoot: string, targetPath: string): string;
-declare function ensureTrailingNewline(value: string): string;
-declare function detectLineEnding(value: string): "\n" | "\r\n";
-declare function findGuidanceBlockRange(content: string): AgentGuidanceBlockRange | null;
-declare function buildAgentGuidanceBlock(lineEnding: "\n" | "\r\n"): string;
-declare function upsertAgentGuidanceBlock(existingContent: string): {
-    next_content: string;
-    changed: boolean;
-};
-declare function resolveProjectRoot(pmRoot: string, cwd: string): string;
-declare function resolveTargetGuidancePath(scans: AgentGuidanceFileScan[], projectRoot: string): string;
-declare function parsePromptChoice(answer: string, currentDefault: boolean): boolean;
-declare function promptForGuidanceWrite(targetRelativePath: string): Promise<boolean>;
-declare function normalizeAgentGuidanceState(settings: PmSettings): PmSettings["agent_guidance"];
-declare function pushUnique(target: string[], value: string): void;
-declare function applyAgentGuidanceState(settings: PmSettings, currentState: PmSettings["agent_guidance"]): {
-    changed: boolean;
-    state: PmSettings["agent_guidance"];
-};
-declare function writeGuidanceFile(filePath: string): Promise<{
-    changed: boolean;
-    warnings: string[];
-}>;
-/** Implements run init agent guidance for the public runtime surface of this module. */
-export declare function runInitAgentGuidance(options: RunInitAgentGuidanceOptions): Promise<RunInitAgentGuidanceResult>;
-export {};
+/**
+ * @module cli/commands/init-agent-guidance
+ *
+ * Preserves the CLI compatibility import path for SDK-owned agent-guidance primitives.
+ */
+export * from "../../sdk/init-agent-guidance.js";