@unbrained/pm-cli 2026.7.14 → 2026.7.16

package/dist/sdk/history-redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-redact.js","sources":["sdk/history-redact.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/history-redact\n *\n * Implements the pm history redact command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport {\n  pathExists,\n  readFileIfExists,\n  writeFileAtomic,\n} from \"../core/fs/fs-utils.js\";\nimport { createHistoryEntry } from \"../core/history/history.js\";\nimport { executeHistoryRewrite } from \"../core/history/history-rewrite.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  historyEntriesToRaw,\n  replayHash,\n  replayToItemDocument,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../core/history/replay.js\";\nimport { applyHistoryPatch } from \"../core/history/projection.js\";\nimport { readHistoryEntries } from \"../core/history/read.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../core/item/id.js\";\nimport {\n  canonicalDocument,\n  serializeItemDocument,\n} from \"../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { nowIso } from \"../core/shared/time.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nimport { locateItem, readLocatedItem } from \"../core/store/item-store.js\";\nimport {\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport { resolveAuthor } from \"../core/shared/author.js\";\nimport type { HistoryEntry, ItemDocument } from \"../types/index.js\";\n\n/** Documents the history redact command options payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRedactCommandOptions {\n  /** Value that configures or reports literal for this contract. */\n  literal?: string[] | string;\n  /** Value that configures or reports regex for this contract. */\n  regex?: string[] | string;\n  /** Value that configures or reports replacement for this contract. */\n  replacement?: string;\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\ninterface RegexRule {\n  kind: \"regex\";\n  source: string;\n  flags: string;\n  label: string;\n}\n\ninterface LiteralRule {\n  kind: \"literal\";\n  value: string;\n  label: string;\n}\n\ntype RedactionRule = RegexRule | LiteralRule;\n\ninterface RedactionRewriteResult {\n  entries: HistoryEntry[];\n  finalDocument: ReplayDocument;\n  entriesChanged: number;\n  replacements: number;\n}\n\ninterface HistoryIntegritySnapshot {\n  hashMismatchesBefore: number;\n  hashMismatchesAfter: number;\n  finalDocument: ReplayDocument;\n}\n\ninterface HistoryRedactCurrentItem {\n  raw: string | null;\n  path: string | null;\n  document: ItemDocument | null;\n}\n\ninterface HistoryRedactNextItem {\n  raw: string | null;\n  path: string | null;\n  document: ItemDocument | null;\n}\n\n/** Documents the history subject payload exchanged by command, SDK, and package integrations. */\nexport interface HistorySubject {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Filesystem path used for history resolution. */\n  historyPath: string;\n  /** Value that configures or reports located for this contract. */\n  located: Awaited<ReturnType<typeof locateItem>>;\n}\n\n/** Documents the history redact result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRedactResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports changed for this contract. */\n  changed: boolean;\n  /** Value that configures or reports patterns for this contract. */\n  patterns: {\n    literals: string[];\n    regex: string[];\n    replacement: string;\n  };\n  /** Value that configures or reports history for this contract. */\n  history: {\n    path: string;\n    entries_scanned: number;\n    entries_changed: number;\n    replacements: number;\n    hash_mismatches_before: number;\n    hash_mismatches_after: number;\n    preexisting_hash_mismatches: number;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  /** Value that configures or reports item for this contract. */\n  item: {\n    existed_before: boolean;\n    exists_after: boolean;\n    path_before: string | null;\n    path_after: string | null;\n    changed: boolean;\n  };\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\nfunction normalizeStringArrayInput(\n  value: string[] | string | undefined,\n): string[] {\n  if (Array.isArray(value)) {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    return [value];\n  }\n  return [];\n}\n\nfunction normalizeRegexFlags(flags: string): string {\n  const unique: string[] = [];\n  for (const token of flags) {\n    if (!unique.includes(token)) {\n      unique.push(token);\n    }\n  }\n  if (!unique.includes(\"g\")) {\n    unique.push(\"g\");\n  }\n  return unique.join(\"\");\n}\n\nfunction parseRegexRule(spec: string): RegexRule {\n  const trimmed = spec.trim();\n  if (trimmed.length === 0) {\n    throw new PmCliError(\n      \"history-redact --regex requires a non-empty pattern.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let source = trimmed;\n  let flags = \"g\";\n  if (trimmed.startsWith(\"/\") && trimmed.length > 1) {\n    /* c8 ignore start -- bare-slash regex literals are rejected earlier in argument validation. */\n    const slashIndex = trimmed.lastIndexOf(\"/\");\n    if (slashIndex > 0) {\n      source = trimmed.slice(1, slashIndex);\n      flags = normalizeRegexFlags(trimmed.slice(slashIndex + 1));\n    }\n    /* c8 ignore stop */\n  }\n  if (source.length === 0) {\n    throw new PmCliError(\n      \"history-redact --regex cannot use an empty pattern.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  try {\n    new RegExp(source, flags);\n  } catch (error) {\n    /* c8 ignore start -- RegExp constructor failures are normalized in higher-level parser tests. */\n    throw new PmCliError(\n      `Invalid --regex value \"${spec}\": ${error instanceof Error ? error.message : String(error)}`,\n      EXIT_CODE.USAGE,\n    );\n    /* c8 ignore stop */\n  }\n\n  return {\n    kind: \"regex\",\n    source,\n    flags,\n    label: `/${source}/${flags}`,\n  };\n}\n\nfunction buildRedactionRules(\n  literalInput: string[] | string | undefined,\n  regexInput: string[] | string | undefined,\n): RedactionRule[] {\n  const literalRules = [\n    ...new Set(\n      normalizeStringArrayInput(literalInput).map((entry) => entry.trim()),\n    ),\n  ]\n    .filter((entry) => entry.length > 0)\n    .map<LiteralRule>((entry) => ({\n      kind: \"literal\",\n      value: entry,\n      label: entry,\n    }));\n  const regexRules = [\n    ...new Set(\n      normalizeStringArrayInput(regexInput).map((entry) => entry.trim()),\n    ),\n  ]\n    .filter((entry) => entry.length > 0)\n    .map(parseRegexRule);\n\n  const rules = [...literalRules, ...regexRules];\n  if (rules.length === 0) {\n    throw new PmCliError(\n      \"history-redact requires at least one matcher via --literal or --regex.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"missing_required_argument\",\n        required: \"Provide --literal <value> and/or --regex <pattern>.\",\n        examples: [\n          'pm history-redact pm-a1b2 --literal \"[redacted_path_prefix]/private\"',\n          'pm history-redact pm-a1b2 --regex \"/192\\\\\\\\.168\\\\\\\\.[0-9.]+/g\" --replacement \"[scrubbed_ip]\"',\n        ],\n      },\n    );\n  }\n  return rules;\n}\n\nfunction applyLiteralRule(\n  value: string,\n  literal: string,\n  replacement: string,\n): { value: string; replacements: number } {\n  if (literal.length === 0) {\n    return { value, replacements: 0 };\n  }\n  let cursor = 0;\n  let replacements = 0;\n  while (cursor <= value.length) {\n    const index = value.indexOf(literal, cursor);\n    if (index === -1) {\n      break;\n    }\n    replacements += 1;\n    cursor = index + Math.max(1, literal.length);\n  }\n  if (replacements === 0) {\n    return { value, replacements: 0 };\n  }\n  return {\n    value: value.split(literal).join(replacement),\n    replacements,\n  };\n}\n\nfunction applyRegexRule(\n  value: string,\n  rule: RegexRule,\n  replacement: string,\n): { value: string; replacements: number } {\n  const regex = new RegExp(rule.source, rule.flags);\n  const matches = [...value.matchAll(regex)];\n  if (matches.length === 0) {\n    return { value, replacements: 0 };\n  }\n  return {\n    value: value.replace(regex, replacement),\n    replacements: matches.length,\n  };\n}\n\nfunction redactStringValue(\n  value: string,\n  rules: RedactionRule[],\n  replacement: string,\n): { value: string; replacements: number } {\n  let next = value;\n  let replacements = 0;\n  for (const rule of rules) {\n    const result =\n      rule.kind === \"literal\"\n        ? applyLiteralRule(next, rule.value, replacement)\n        : applyRegexRule(next, rule, replacement);\n    next = result.value;\n    replacements += result.replacements;\n  }\n  return {\n    value: next,\n    replacements,\n  };\n}\n\nfunction redactUnknownValue(\n  value: unknown,\n  rules: RedactionRule[],\n  replacement: string,\n): { value: unknown; replacements: number } {\n  if (typeof value === \"string\") {\n    return redactStringValue(value, rules, replacement);\n  }\n  if (Array.isArray(value)) {\n    let replacements = 0;\n    const nextValues = value.map((entry) => {\n      const redacted = redactUnknownValue(entry, rules, replacement);\n      replacements += redacted.replacements;\n      return redacted.value;\n    });\n    return {\n      value: nextValues,\n      replacements,\n    };\n  }\n  if (typeof value === \"object\" && value !== null) {\n    let replacements = 0;\n    const nextRecord: Record<string, unknown> = {};\n    for (const [key, entry] of Object.entries(value)) {\n      const redacted = redactUnknownValue(entry, rules, replacement);\n      replacements += redacted.replacements;\n      nextRecord[key] = redacted.value;\n    }\n    return {\n      value: nextRecord,\n      replacements,\n    };\n  }\n  return {\n    value,\n    replacements: 0,\n  };\n}\n\nfunction inspectHistoryIntegrity(\n  entries: HistoryEntry[],\n): HistoryIntegritySnapshot {\n  let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  let hashMismatchesBefore = 0;\n  let hashMismatchesAfter = 0;\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    if (replayHash(replay) !== entry.before_hash) {\n      hashMismatchesBefore += 1;\n    }\n    replay = applyHistoryPatch(replay, entry.patch, index + 1, entry.op);\n    /* c8 ignore start -- after-hash mismatch branch is exercised in dedicated history integrity tests. */\n    if (replayHash(replay) !== entry.after_hash) {\n      hashMismatchesAfter += 1;\n    }\n    /* c8 ignore stop */\n  }\n  return {\n    hashMismatchesBefore,\n    hashMismatchesAfter,\n    finalDocument: replay,\n  };\n}\n\nfunction redactHistoryEntry(\n  entry: HistoryEntry,\n  rules: RedactionRule[],\n  replacement: string,\n): {\n  entry: HistoryEntry;\n  replacements: number;\n  changed: boolean;\n} {\n  let replacements = 0;\n  let changed = false;\n  let nextMessage = entry.message;\n\n  if (typeof entry.message === \"string\") {\n    const redactedMessage = redactStringValue(\n      entry.message,\n      rules,\n      replacement,\n    );\n    nextMessage = redactedMessage.value;\n    replacements += redactedMessage.replacements;\n    if (redactedMessage.replacements > 0) {\n      changed = true;\n    }\n  }\n\n  const nextPatch = entry.patch.map((operation) => {\n    /* c8 ignore start -- patch operations without `value` are covered in lower-level patch adapters. */\n    if (!Object.prototype.hasOwnProperty.call(operation, \"value\")) {\n      return operation;\n    }\n    /* c8 ignore stop */\n    const redactedValue = redactUnknownValue(\n      operation.value,\n      rules,\n      replacement,\n    );\n    replacements += redactedValue.replacements;\n    if (redactedValue.replacements > 0) {\n      changed = true;\n      return {\n        ...operation,\n        value: redactedValue.value,\n      };\n    }\n    return operation;\n  });\n\n  return {\n    entry: {\n      ...entry,\n      message: nextMessage,\n      patch: nextPatch,\n    },\n    replacements,\n    changed,\n  };\n}\n\nfunction rewriteHistoryEntries(\n  entries: HistoryEntry[],\n  rules: RedactionRule[],\n  replacement: string,\n): RedactionRewriteResult {\n  let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  let entriesChanged = 0;\n  let replacements = 0;\n  const rewrittenEntries: HistoryEntry[] = [];\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const redacted = redactHistoryEntry(entries[index], rules, replacement);\n    replacements += redacted.replacements;\n    if (redacted.changed) {\n      entriesChanged += 1;\n    }\n    const beforeHash = replayHash(replay);\n    replay = applyHistoryPatch(\n      replay,\n      redacted.entry.patch,\n      index + 1,\n      redacted.entry.op,\n    );\n    const afterHash = replayHash(replay);\n    rewrittenEntries.push({\n      ...redacted.entry,\n      before_hash: beforeHash,\n      after_hash: afterHash,\n    });\n  }\n\n  return {\n    entries: rewrittenEntries,\n    finalDocument: replay,\n    entriesChanged,\n    replacements,\n  };\n}\n\nfunction hasItemMetadata(replay: ReplayDocument): boolean {\n  return Object.keys(replay.metadata).length > 0;\n}\n\nasync function loadHistoryRedactCurrentItem(\n  subject: HistorySubject,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): Promise<HistoryRedactCurrentItem> {\n  const currentItemPath = subject.located?.itemPath ?? null;\n  if (!subject.located) {\n    return { raw: null, path: currentItemPath, document: null };\n  }\n  const loaded = await readLocatedItem(subject.located, {\n    schema: settings.schema,\n  });\n  return { raw: loaded.raw, path: currentItemPath, document: loaded.document };\n}\n\nfunction resolveHistoryRedactNextItem(params: {\n  pmRoot: string;\n  subject: HistorySubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  finalDocument: ReplayDocument;\n}): HistoryRedactNextItem {\n  if (!hasItemMetadata(params.finalDocument)) {\n    return { raw: null, path: null, document: null };\n  }\n  const canonical = canonicalDocument(\n    replayToItemDocument(params.finalDocument),\n    { schema: params.settings.schema },\n  );\n  if (canonical.metadata.id !== params.subject.id) {\n    throw new PmCliError(\n      `history-redact would change item id from ${params.subject.id} to ${canonical.metadata.id}; narrow your patterns.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return {\n    document: canonical,\n    path: getItemPath(\n      params.pmRoot,\n      canonical.metadata.type,\n      params.subject.id,\n      \"toon\",\n      params.typeToFolder,\n    ),\n    raw: serializeItemDocument(canonical, {\n      format: \"toon\",\n      schema: params.settings.schema,\n    }),\n  };\n}\n\n/* v8 ignore start -- message passthrough/plural formatting is deterministic around covered redaction outcomes */\nfunction buildHistoryRedactMessage(\n  options: HistoryRedactCommandOptions,\n  rewritten: RedactionRewriteResult,\n): string {\n  if (\n    typeof options.message === \"string\" &&\n    options.message.trim().length > 0\n  ) {\n    return options.message;\n  }\n  return `history-redact replaced ${rewritten.replacements} match(es) across ${rewritten.entriesChanged} entr${\n    rewritten.entriesChanged === 1 ? \"y\" : \"ies\"\n  }.`;\n}\n/* v8 ignore stop */\n\nfunction buildHistoryRedactEntries(params: {\n  rewritten: RedactionRewriteResult;\n  dryRun: boolean;\n  changed: boolean;\n  nextItemDocument: ItemDocument | null;\n  author: string;\n  message: string;\n}): { rewrittenEntries: HistoryEntry[]; auditEntryAdded: boolean } {\n  const rewrittenEntries = [...params.rewritten.entries];\n  if (params.dryRun || !params.changed) {\n    return { rewrittenEntries, auditEntryAdded: false };\n  }\n  /* c8 ignore next -- fallback replay-to-item conversion runs only when rewritten final metadata is absent. */\n  const finalDocument =\n    params.nextItemDocument ??\n    replayToItemDocument(params.rewritten.finalDocument);\n  rewrittenEntries.push(\n    createHistoryEntry({\n      nowIso: nowIso(),\n      author: params.author,\n      op: \"history_redact\",\n      before: finalDocument,\n      after: finalDocument,\n      message: params.message,\n    }),\n  );\n  return { rewrittenEntries, auditEntryAdded: true };\n}\n\nasync function applyHistoryRedactRewrite(params: {\n  pmRoot: string;\n  subject: HistorySubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;\n  historyRawBeforeLock: string | null;\n  currentItem: HistoryRedactCurrentItem;\n  nextItem: HistoryRedactNextItem;\n  author: string;\n  force: boolean | undefined;\n  rewrittenEntries: HistoryEntry[];\n}): Promise<string[]> {\n  return executeHistoryRewrite({\n    pmRoot: params.pmRoot,\n    subject: params.subject,\n    settings: params.settings,\n    typeRegistry: params.typeRegistry,\n    historyRawBeforeLock: params.historyRawBeforeLock,\n    currentItemRawBeforeLock: params.currentItem.raw,\n    operation: \"history-redact\",\n    author: params.author,\n    force: params.force,\n    itemDocument: params.currentItem.document,\n    applyRewrite: async ({ historyRawUnderLock }) => {\n      const affectedItemPaths = new Set<string>();\n      if (params.currentItem.path) {\n        affectedItemPaths.add(params.currentItem.path);\n      }\n      if (params.nextItem.path) {\n        affectedItemPaths.add(params.nextItem.path);\n      }\n      const itemSnapshots = new Map<string, string>();\n      if (params.currentItem.path && params.currentItem.raw !== null) {\n        itemSnapshots.set(params.currentItem.path, params.currentItem.raw);\n      }\n      try {\n        /* c8 ignore next -- item-write diff branch requires path and content divergence under lock races. */\n        if (\n          params.nextItem.path &&\n          params.nextItem.raw !== null &&\n          params.nextItem.raw !== params.currentItem.raw\n        ) {\n          await writeFileAtomic(params.nextItem.path, params.nextItem.raw);\n        }\n        if (\n          params.currentItem.path &&\n          (!params.nextItem.path ||\n            params.nextItem.path !== params.currentItem.path)\n        ) {\n          await fs.rm(params.currentItem.path, { force: true });\n        }\n        await writeFileAtomic(\n          params.subject.historyPath,\n          historyEntriesToRaw(params.rewrittenEntries),\n        );\n      } catch (error) {\n        await rollbackHistoryRedactRewrite(\n          params.subject.historyPath,\n          historyRawUnderLock,\n          affectedItemPaths,\n          itemSnapshots,\n        );\n        throw error;\n      }\n    },\n    applyPostRewrite: async () =>\n      runHistoryRedactWriteHooks(params.subject.historyPath, [\n        params.nextItem.path,\n        params.currentItem.path,\n      ]),\n  });\n}\n\nasync function rollbackHistoryRedactRewrite(\n  historyPath: string,\n  historyRawUnderLock: string | null,\n  affectedItemPaths: Set<string>,\n  itemSnapshots: Map<string, string>,\n): Promise<void> {\n  /* c8 ignore start -- no-history-under-lock rollback path is exercised in lock-race integration tests. */\n  if (historyRawUnderLock === null) {\n    await fs.rm(historyPath, { force: true });\n  } else {\n    await writeFileAtomic(historyPath, historyRawUnderLock);\n  }\n  /* c8 ignore stop */\n  for (const itemPath of affectedItemPaths) {\n    const snapshot = itemSnapshots.get(itemPath);\n    /* c8 ignore start -- missing snapshot rollback occurs only for create/delete race permutations. */\n    if (snapshot === undefined) {\n      await fs.rm(itemPath, { force: true });\n    } else {\n      await writeFileAtomic(itemPath, snapshot);\n    }\n    /* c8 ignore stop */\n  }\n}\n\nasync function runHistoryRedactWriteHooks(\n  historyPath: string,\n  itemHookPaths: Array<string | null>,\n): Promise<string[]> {\n  const hookWarnings: string[] = [];\n  const uniqueItemHookPaths = new Set(\n    itemHookPaths.filter((itemPath): itemPath is string => itemPath !== null),\n  );\n  for (const itemHookPath of uniqueItemHookPaths) {\n    hookWarnings.push(\n      ...(await runActiveOnWriteHooks({\n        path: itemHookPath,\n        scope: \"project\",\n        op: \"history_redact\",\n      })),\n    );\n  }\n  hookWarnings.push(\n    ...(await runActiveOnWriteHooks({\n      path: historyPath,\n      scope: \"project\",\n      op: \"history_redact:history\",\n    })),\n  );\n  return hookWarnings;\n}\n\n/** Implements resolve history subject for the public runtime surface of this module. */\nexport async function resolveHistorySubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<HistorySubject> {\n  const located = await locateItem(\n    pmRoot,\n    id,\n    settings.id_prefix,\n    settings.item_format,\n    typeToFolder,\n  );\n  if (located) {\n    return {\n      id: located.id,\n      historyPath: getHistoryPath(pmRoot, located.id),\n      located,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  const candidateIds =\n    normalizedId === rawNormalizedId\n      ? [normalizedId]\n      : [normalizedId, rawNormalizedId];\n  for (const candidateId of candidateIds) {\n    const historyPath = getHistoryPath(pmRoot, candidateId);\n    if (await pathExists(historyPath)) {\n      return {\n        id: candidateId,\n        historyPath,\n        located: null,\n      };\n    }\n  }\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\n/** Implements run history redact for the public runtime surface of this module. */\nexport async function runHistoryRedact(\n  id: string,\n  options: HistoryRedactCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRedactResult> {\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 settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const replacement =\n    typeof options.replacement === \"string\" && options.replacement.length > 0\n      ? options.replacement\n      : \"[redacted]\";\n  const rules = buildRedactionRules(options.literal, options.regex);\n  const subject = await resolveHistorySubject(\n    pmRoot,\n    id,\n    settings,\n    typeRegistry.type_to_folder,\n  );\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(\n      `No history stream exists for ${subject.id}.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const historyEntries = await readHistoryEntries(\n    subject.historyPath,\n    subject.id,\n  );\n  if (historyEntries.length === 0) {\n    throw new PmCliError(\n      `No history entries exist for ${subject.id}; nothing to redact.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const integritySnapshot = inspectHistoryIntegrity(historyEntries);\n  const rewritten = rewriteHistoryEntries(historyEntries, rules, replacement);\n  const preexistingHashMismatches =\n    integritySnapshot.hashMismatchesBefore +\n    integritySnapshot.hashMismatchesAfter;\n  const dryRun = Boolean(options.dryRun);\n  const changed = rewritten.replacements > 0;\n  const warnings: string[] = [];\n  if (preexistingHashMismatches > 0) {\n    warnings.push(\n      `history_redact_preexisting_hash_mismatches:${preexistingHashMismatches}`,\n    );\n  }\n  if (!changed) {\n    warnings.push(\"history_redact_no_matches\");\n  }\n\n  const currentItem = await loadHistoryRedactCurrentItem(subject, settings);\n  const nextItem = resolveHistoryRedactNextItem({\n    pmRoot,\n    subject,\n    settings,\n    typeToFolder: typeRegistry.type_to_folder,\n    finalDocument: rewritten.finalDocument,\n  });\n\n  const itemChanged =\n    /* c8 ignore next -- null-coalescing item-path comparison branch is exercised in broader command integration coverage. */\n    (currentItem.path ?? null) !== (nextItem.path ?? null) ||\n    /* c8 ignore next -- null-coalescing item-content comparison branch is exercised in broader command integration coverage. */\n    (currentItem.raw ?? null) !== (nextItem.raw ?? null);\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const redactionMessage = buildHistoryRedactMessage(options, rewritten);\n  const { rewrittenEntries, auditEntryAdded } = buildHistoryRedactEntries({\n    rewritten,\n    dryRun,\n    changed,\n    nextItemDocument: nextItem.document,\n    author,\n    message: redactionMessage,\n  });\n  const historyVerify = verifyHistoryChain(rewrittenEntries);\n  /* c8 ignore start -- invalid rewritten chains are covered by history verification unit tests. */\n  if (!historyVerify.ok) {\n    throw new PmCliError(\n      `history-redact produced an invalid rewritten chain (${historyVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  /* c8 ignore stop */\n\n  if (!dryRun && changed) {\n    warnings.push(\n      ...(await applyHistoryRedactRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItem,\n        nextItem,\n        author,\n        force: options.force,\n        rewrittenEntries,\n      })),\n    );\n  }\n\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    patterns: {\n      literals: rules\n        .filter((rule): rule is LiteralRule => rule.kind === \"literal\")\n        .map((rule) => rule.value),\n      regex: rules\n        .filter((rule): rule is RegexRule => rule.kind === \"regex\")\n        .map((rule) => `/${rule.source}/${rule.flags}`),\n      replacement,\n    },\n    history: {\n      path: subject.historyPath,\n      entries_scanned: historyEntries.length,\n      entries_changed: rewritten.entriesChanged,\n      replacements: rewritten.replacements,\n      hash_mismatches_before: integritySnapshot.hashMismatchesBefore,\n      hash_mismatches_after: integritySnapshot.hashMismatchesAfter,\n      preexisting_hash_mismatches: preexistingHashMismatches,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: historyVerify.ok,\n      verify_errors: historyVerify.errors,\n    },\n    item: {\n      existed_before: currentItem.path !== null,\n      exists_after: nextItem.path !== null,\n      path_before: currentItem.path,\n      path_after: nextItem.path,\n      changed: itemChanged,\n    },\n    /* c8 ignore next -- warning dedupe ordering is covered indirectly by command-level smoke tests. */\n    warnings: [...new Set(warnings)].sort((left, right) =>\n      left.localeCompare(right),\n    ),\n    generated_at: nowIso(),\n  };\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  applyLiteralRule,\n  applyRegexRule,\n  buildRedactionRules,\n  hasItemMetadata,\n  normalizeRegexFlags,\n  normalizeStringArrayInput,\n  parseRegexRule,\n  redactStringValue,\n  redactUnknownValue,\n};\n"],"names":[],"mappings":"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","debugId":"89a4cabb-4563-58d6-94c3-0ffaa7cb64ae"}

package/dist/sdk/history-repair.d.ts

@@ -0,0 +1,89 @@
+import type { GlobalOptions } from "../core/shared/command-types.js";
+/** Documents the history repair command options payload exchanged by command, SDK, and package integrations. */
+export interface HistoryRepairCommandOptions {
+    /** Value that configures or reports dry run for this contract. */
+    dryRun?: boolean;
+    /** Value that configures or reports author for this contract. */
+    author?: string;
+    /** Human-readable explanation suitable for logs and agent-facing output. */
+    message?: string;
+    /** Value that configures or reports force for this contract. */
+    force?: boolean;
+}
+/** Documents the history repair result payload exchanged by command, SDK, and package integrations. */
+export interface HistoryRepairResult {
+    /** Stable identifier used to reference this record across commands and storage. */
+    id: string;
+    /** Value that configures or reports dry run for this contract. */
+    dry_run: boolean;
+    /** Value that configures or reports changed for this contract. */
+    changed: boolean;
+    /** Value that configures or reports history for this contract. */
+    history: {
+        path: string;
+        entries_scanned: number;
+        chain_drift_before: boolean;
+        entries_rehashed: number;
+        entries_patch_repaired: number;
+        converted_replace_to_add: number;
+        skipped_ops: number;
+        reconciled_with_item: boolean;
+        audit_entry_added: boolean;
+        verify_ok: boolean;
+        verify_errors: string[];
+    };
+    /** Value that configures or reports item for this contract. */
+    item: {
+        exists: boolean;
+        path: string | null;
+        matched_chain_before: boolean | null;
+    };
+    /** Value that configures or reports warnings for this contract. */
+    warnings: string[];
+    /** ISO 8601 timestamp recording when generated occurred. */
+    generated_at: string;
+}
+/** Implements run history repair for the public runtime surface of this module. */
+export declare function runHistoryRepair(id: string, options: HistoryRepairCommandOptions, global: GlobalOptions): Promise<HistoryRepairResult>;
+/** Documents the history repair all stream result payload exchanged by command, SDK, and package integrations. */
+export interface HistoryRepairAllStreamResult {
+    /** Stable identifier used to reference this record across commands and storage. */
+    id: string;
+    /** Value that configures or reports outcome for this contract. */
+    outcome: "repaired" | "skipped_clean" | "failed";
+    /** Value that configures or reports entries rehashed for this contract. */
+    entries_rehashed?: number;
+    /** Value that configures or reports entries patch repaired for this contract. */
+    entries_patch_repaired?: number;
+    /** Value that configures or reports reconciled with item for this contract. */
+    reconciled_with_item?: boolean;
+    /** Value that configures or reports error for this contract. */
+    error?: string;
+}
+/** Documents the history repair all result payload exchanged by command, SDK, and package integrations. */
+export interface HistoryRepairAllResult {
+    /** Value that configures or reports all for this contract. */
+    all: true;
+    /** Value that configures or reports dry run for this contract. */
+    dry_run: boolean;
+    /** Value that configures or reports scanned streams for this contract. */
+    scanned_streams: number;
+    /** Value that configures or reports drifted streams for this contract. */
+    drifted_streams: number;
+    /** One compact row per drifted stream (clean streams are summarized by the counts only). */
+    streams: HistoryRepairAllStreamResult[];
+    /** Value that configures or reports totals for this contract. */
+    totals: {
+        repaired: number;
+        skipped_clean: number;
+        failed: number;
+    };
+    /** Value that configures or reports warnings for this contract. */
+    warnings: string[];
+    /** ISO 8601 timestamp recording when generated occurred. */
+    generated_at: string;
+}
+/** Enforce the `pm history-repair` target contract shared by the CLI and MCP surfaces: exactly one of an item `<id>` or `--all` must be provided. */
+export declare function assertHistoryRepairTarget(id: string | undefined, all: boolean): void;
+/** Bulk drift repair: scan every item's history stream with the same drift scan `pm health` uses, then run the audited single-stream repair (ownership check, lock, no-drift verification, audit marker) for each drifted stream. One failing stream never aborts the rest; failures are collected per row and the caller decides the exit code from `totals.failed`. */
+export declare function runHistoryRepairAll(options: HistoryRepairCommandOptions, global: GlobalOptions): Promise<HistoryRepairAllResult>;

package/dist/sdk/history-repair.js

@@ -0,0 +1,263 @@
+/**
+ * @module sdk/history-repair
+ *
+ * Implements the pm history repair 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]="681e79d9-140b-5a78-9e24-6714efd974dc")}catch(e){}}();
+import jsonPatch from "fast-json-patch";
+import { pathExists, readFileIfExists } from "../core/fs/fs-utils.js";
+import { executeHistoryRewrite, writeHistoryRawWithRollback, } from "../core/history/history-rewrite.js";
+import { historyEntriesToRaw, reanchorHistoryEntries, replayHash, toReplayDocument, verifyHistoryChain, } from "../core/history/replay.js";
+import { scanHistoryDrift } from "../core/history/drift-scan.js";
+import { readHistoryEntries } from "../core/history/read.js";
+import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
+import { nowIso } from "../core/shared/time.js";
+import { getActiveExtensionRegistrations, runActiveOnWriteHooks, } from "../core/extensions/index.js";
+import { listAllItemMetadataWithBody, readLocatedItem, } from "../core/store/item-store.js";
+import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
+import { readSettings } from "../core/store/settings.js";
+import { resolveHistorySubject } from "./history-redact.js";
+function toAuthor(candidate, defaultAuthor) {
+    /* c8 ignore next -- PM_AUTHOR fallback branch is environment-dependent in CI. */
+    const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;
+    const trimmed = resolved.trim();
+    return trimmed.length > 0 ? trimmed : "unknown";
+}
+async function loadHistoryRepairItemReplay(subject, settings, historyEntries) {
+    const currentItemPath = subject.located?.itemPath ?? null;
+    const loadedItem = subject.located
+        ? await readLocatedItem(subject.located, { schema: settings.schema })
+        : null;
+    if (!loadedItem) {
+        return {
+            currentItemReplay: null,
+            currentItemPath,
+            matchedChainBefore: null,
+            currentItemRawBeforeLock: null,
+            loadedItem: null,
+        };
+    }
+    const currentItemReplay = toReplayDocument(loadedItem.document);
+    const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;
+    return {
+        currentItemReplay,
+        currentItemPath,
+        matchedChainBefore: replayHash(currentItemReplay) === lastOriginalAfterHash,
+        currentItemRawBeforeLock: loadedItem.raw,
+        loadedItem,
+    };
+}
+function buildHistoryRepairMessage(params) {
+    if (typeof params.message === "string" && params.message.trim().length > 0) {
+        return params.message;
+    }
+    /* v8 ignore start -- message suffix/plural variants are deterministic formatting fallbacks around the covered repair outcomes */
+    return `history-repair re-anchored ${params.entriesRehashed} entr${params.entriesRehashed === 1 ? "y" : "ies"}${params.entriesPatchRepaired > 0 ? `, repaired ${params.entriesPatchRepaired} patch(es)` : ""}${params.reconcileNeeded ? ", reconciled chain with on-disk item" : ""}.`;
+    /* v8 ignore stop */
+}
+function buildHistoryRepairEntries(params) {
+    const rewrittenEntries = [...params.reanchorEntries];
+    if (!params.changed) {
+        return { rewrittenEntries, auditEntryAdded: false };
+    }
+    const afterReplay = params.reconcileNeeded && params.currentItemReplay
+        ? params.currentItemReplay
+        : params.finalReplay;
+    rewrittenEntries.push({
+        ts: nowIso(),
+        author: params.author,
+        op: "history_repair",
+        patch: params.reconcileNeeded && params.currentItemReplay
+            ? jsonPatch.compare(params.finalReplay, params.currentItemReplay)
+            : [],
+        before_hash: replayHash(params.finalReplay),
+        after_hash: replayHash(afterReplay),
+        message: params.message,
+    });
+    return { rewrittenEntries, auditEntryAdded: true };
+}
+function collectHistoryRepairWarnings(changed, skippedOps) {
+    const warnings = [];
+    if (!changed) {
+        warnings.push("history_repair_no_changes");
+    }
+    if (skippedOps > 0) {
+        warnings.push(`history_repair_skipped_unresolvable_ops:${skippedOps}`);
+    }
+    return warnings;
+}
+async function applyHistoryRepairRewrite(params) {
+    return executeHistoryRewrite({
+        pmRoot: params.pmRoot,
+        subject: params.subject,
+        settings: params.settings,
+        typeRegistry: params.typeRegistry,
+        historyRawBeforeLock: params.historyRawBeforeLock,
+        currentItemRawBeforeLock: params.currentItemRawBeforeLock,
+        operation: "history-repair",
+        author: params.author,
+        force: params.force,
+        itemDocument: params.loadedItem?.document ?? null,
+        applyRewrite: async ({ historyRawUnderLock }) => writeHistoryRawWithRollback({
+            historyPath: params.historyPath,
+            nextHistoryRaw: historyEntriesToRaw(params.rewrittenEntries),
+            historyRawUnderLock,
+        }),
+        applyPostRewrite: async () => runActiveOnWriteHooks({
+            path: params.historyPath,
+            scope: "project",
+            op: "history_repair:history",
+        }),
+    });
+}
+/** Implements run history repair for the public runtime surface of this module. */
+export async function runHistoryRepair(id, options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+    const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);
+    if (!(await pathExists(subject.historyPath))) {
+        throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);
+    }
+    const historyRawBeforeLock = await readFileIfExists(subject.historyPath);
+    const historyEntries = await readHistoryEntries(subject.historyPath, subject.id);
+    if (historyEntries.length === 0) {
+        throw new PmCliError(`No history entries exist for ${subject.id}; nothing to repair.`, EXIT_CODE.USAGE);
+    }
+    const chainBefore = verifyHistoryChain(historyEntries);
+    const reanchor = reanchorHistoryEntries(historyEntries);
+    const itemReplayContext = await loadHistoryRepairItemReplay(subject, settings, historyEntries);
+    const finalReplay = reanchor.finalDocument;
+    const reconcileNeeded = itemReplayContext.currentItemReplay !== null &&
+        replayHash(finalReplay) !== replayHash(itemReplayContext.currentItemReplay);
+    const changed = reanchor.entriesRehashed > 0 ||
+        reanchor.entriesPatchRepaired > 0 ||
+        reconcileNeeded;
+    const author = toAuthor(options.author, settings.author_default);
+    const dryRun = Boolean(options.dryRun);
+    const repairMessage = buildHistoryRepairMessage({
+        message: options.message,
+        entriesRehashed: reanchor.entriesRehashed,
+        entriesPatchRepaired: reanchor.entriesPatchRepaired,
+        reconcileNeeded,
+    });
+    const { rewrittenEntries, auditEntryAdded } = buildHistoryRepairEntries({
+        reanchorEntries: reanchor.entries,
+        changed,
+        reconcileNeeded,
+        currentItemReplay: itemReplayContext.currentItemReplay,
+        finalReplay,
+        author,
+        message: repairMessage,
+    });
+    const historyVerify = verifyHistoryChain(rewrittenEntries);
+    if (!historyVerify.ok) {
+        throw new PmCliError(`history-repair produced an invalid rewritten chain (${historyVerify.errors.join(", ")}).`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    const warnings = collectHistoryRepairWarnings(changed, reanchor.skippedOps);
+    if (changed && !dryRun) {
+        warnings.push(...(await applyHistoryRepairRewrite({
+            pmRoot,
+            subject,
+            settings,
+            typeRegistry,
+            historyRawBeforeLock,
+            currentItemRawBeforeLock: itemReplayContext.currentItemRawBeforeLock,
+            author,
+            force: options.force,
+            loadedItem: itemReplayContext.loadedItem,
+            historyPath: subject.historyPath,
+            rewrittenEntries,
+        })));
+    }
+    return {
+        id: subject.id,
+        dry_run: dryRun,
+        changed,
+        history: {
+            path: subject.historyPath,
+            entries_scanned: historyEntries.length,
+            chain_drift_before: !chainBefore.ok,
+            entries_rehashed: reanchor.entriesRehashed,
+            entries_patch_repaired: reanchor.entriesPatchRepaired,
+            converted_replace_to_add: reanchor.convertedReplaceToAdd,
+            skipped_ops: reanchor.skippedOps,
+            reconciled_with_item: reconcileNeeded,
+            audit_entry_added: auditEntryAdded,
+            verify_ok: historyVerify.ok,
+            verify_errors: historyVerify.errors,
+        },
+        item: {
+            exists: itemReplayContext.currentItemPath !== null,
+            path: itemReplayContext.currentItemPath,
+            matched_chain_before: itemReplayContext.matchedChainBefore,
+        },
+        warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
+        generated_at: nowIso(),
+    };
+}
+/** Enforce the `pm history-repair` target contract shared by the CLI and MCP surfaces: exactly one of an item `<id>` or `--all` must be provided. */
+export function assertHistoryRepairTarget(id, all) {
+    if (all && id !== undefined) {
+        throw new PmCliError("history-repair: <id> and --all are mutually exclusive; pass an item id to repair one stream or --all to repair every drifted stream.", EXIT_CODE.USAGE);
+    }
+    if (!all && id === undefined) {
+        throw new PmCliError("history-repair: provide an item <id> or pass --all to repair every drifted stream.", EXIT_CODE.USAGE);
+    }
+}
+/** Bulk drift repair: scan every item's history stream with the same drift scan `pm health` uses, then run the audited single-stream repair (ownership check, lock, no-drift verification, audit marker) for each drifted stream. One failing stream never aborts the rest; failures are collected per row and the caller decides the exit code from `totals.failed`. */
+export async function runHistoryRepairAll(options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+    const itemReadWarnings = [];
+    const items = await listAllItemMetadataWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, itemReadWarnings, settings.schema);
+    const drift = await scanHistoryDrift(pmRoot, items);
+    const streams = [];
+    const totals = { repaired: 0, skipped_clean: 0, failed: 0 };
+    for (const driftedId of drift.driftedItems) {
+        try {
+            const result = await runHistoryRepair(driftedId, options, global);
+            /* c8 ignore next -- mixed repaired/clean outcomes depend on live drift composition. */
+            const outcome = result.changed ? "repaired" : "skipped_clean";
+            totals[outcome] += 1;
+            streams.push({
+                id: driftedId,
+                outcome,
+                entries_rehashed: result.history.entries_rehashed,
+                entries_patch_repaired: result.history.entries_patch_repaired,
+                reconciled_with_item: result.history.reconciled_with_item,
+            });
+        }
+        catch (error) {
+            totals.failed += 1;
+            streams.push({
+                id: driftedId,
+                outcome: "failed",
+                /* c8 ignore next -- non-Error throws are normalized in defensive fallback. */
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return {
+        all: true,
+        dry_run: Boolean(options.dryRun),
+        scanned_streams: items.length,
+        drifted_streams: drift.driftedItems.length,
+        streams,
+        totals,
+        warnings: [...new Set(itemReadWarnings)].sort((left, right) => left.localeCompare(right)),
+        generated_at: nowIso(),
+    };
+}
+//# sourceMappingURL=history-repair.js.map
+//# debugId=681e79d9-140b-5a78-9e24-6714efd974dc

package/dist/sdk/history-repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-repair.js","sources":["sdk/history-repair.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/history-repair\n *\n * Implements the pm history repair command surface and its agent-facing runtime behavior.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport { pathExists, readFileIfExists } from \"../core/fs/fs-utils.js\";\nimport {\n  executeHistoryRewrite,\n  writeHistoryRawWithRollback,\n} from \"../core/history/history-rewrite.js\";\nimport {\n  historyEntriesToRaw,\n  reanchorHistoryEntries,\n  replayHash,\n  toReplayDocument,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../core/history/replay.js\";\nimport { scanHistoryDrift } from \"../core/history/drift-scan.js\";\nimport { readHistoryEntries } from \"../core/history/read.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { nowIso } from \"../core/shared/time.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nimport {\n  listAllItemMetadataWithBody,\n  readLocatedItem,\n} from \"../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport type {\n  HistoryEntry,\n  HistoryPatchOp,\n  ItemMetadata,\n} from \"../types/index.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/** Documents the history repair command options payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairCommandOptions {\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the history repair result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports changed for this contract. */\n  changed: boolean;\n  /** Value that configures or reports history for this contract. */\n  history: {\n    path: string;\n    entries_scanned: number;\n    chain_drift_before: boolean;\n    entries_rehashed: number;\n    entries_patch_repaired: number;\n    converted_replace_to_add: number;\n    skipped_ops: number;\n    reconciled_with_item: boolean;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  /** Value that configures or reports item for this contract. */\n  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\ninterface HistoryRepairItemReplayContext {\n  currentItemReplay: ReplayDocument | null;\n  currentItemPath: string | null;\n  matchedChainBefore: boolean | null;\n  currentItemRawBeforeLock: string | null;\n  loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;\n}\n\nfunction toAuthor(\n  candidate: string | undefined,\n  defaultAuthor: string,\n): string {\n  /* c8 ignore next -- PM_AUTHOR fallback branch is environment-dependent in CI. */\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed.length > 0 ? trimmed : \"unknown\";\n}\n\nasync function loadHistoryRepairItemReplay(\n  subject: Awaited<ReturnType<typeof resolveHistorySubject>>,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  historyEntries: HistoryEntry[],\n): Promise<HistoryRepairItemReplayContext> {\n  const currentItemPath = subject.located?.itemPath ?? null;\n  const loadedItem = subject.located\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : null;\n  if (!loadedItem) {\n    return {\n      currentItemReplay: null,\n      currentItemPath,\n      matchedChainBefore: null,\n      currentItemRawBeforeLock: null,\n      loadedItem: null,\n    };\n  }\n  const currentItemReplay = toReplayDocument(loadedItem.document);\n  const lastOriginalAfterHash =\n    historyEntries[historyEntries.length - 1]?.after_hash;\n  return {\n    currentItemReplay,\n    currentItemPath,\n    matchedChainBefore: replayHash(currentItemReplay) === lastOriginalAfterHash,\n    currentItemRawBeforeLock: loadedItem.raw,\n    loadedItem,\n  };\n}\n\nfunction buildHistoryRepairMessage(params: {\n  message: string | undefined;\n  entriesRehashed: number;\n  entriesPatchRepaired: number;\n  reconcileNeeded: boolean;\n}): string {\n  if (typeof params.message === \"string\" && params.message.trim().length > 0) {\n    return params.message;\n  }\n  /* v8 ignore start -- message suffix/plural variants are deterministic formatting fallbacks around the covered repair outcomes */\n  return `history-repair re-anchored ${params.entriesRehashed} entr${\n    params.entriesRehashed === 1 ? \"y\" : \"ies\"\n  }${params.entriesPatchRepaired > 0 ? `, repaired ${params.entriesPatchRepaired} patch(es)` : \"\"}${\n    params.reconcileNeeded ? \", reconciled chain with on-disk item\" : \"\"\n  }.`;\n  /* v8 ignore stop */\n}\n\nfunction buildHistoryRepairEntries(params: {\n  reanchorEntries: HistoryEntry[];\n  changed: boolean;\n  reconcileNeeded: boolean;\n  currentItemReplay: ReplayDocument | null;\n  finalReplay: ReplayDocument;\n  author: string;\n  message: string;\n}): { rewrittenEntries: HistoryEntry[]; auditEntryAdded: boolean } {\n  const rewrittenEntries: HistoryEntry[] = [...params.reanchorEntries];\n  if (!params.changed) {\n    return { rewrittenEntries, auditEntryAdded: false };\n  }\n  const afterReplay =\n    params.reconcileNeeded && params.currentItemReplay\n      ? params.currentItemReplay\n      : params.finalReplay;\n  rewrittenEntries.push({\n    ts: nowIso(),\n    author: params.author,\n    op: \"history_repair\",\n    patch:\n      params.reconcileNeeded && params.currentItemReplay\n        ? (jsonPatch.compare(\n            params.finalReplay,\n            params.currentItemReplay,\n          ) as HistoryPatchOp[])\n        : [],\n    before_hash: replayHash(params.finalReplay),\n    after_hash: replayHash(afterReplay),\n    message: params.message,\n  });\n  return { rewrittenEntries, auditEntryAdded: true };\n}\n\nfunction collectHistoryRepairWarnings(\n  changed: boolean,\n  skippedOps: number,\n): string[] {\n  const warnings: string[] = [];\n  if (!changed) {\n    warnings.push(\"history_repair_no_changes\");\n  }\n  if (skippedOps > 0) {\n    warnings.push(`history_repair_skipped_unresolvable_ops:${skippedOps}`);\n  }\n  return warnings;\n}\n\nasync function applyHistoryRepairRewrite(params: {\n  pmRoot: string;\n  subject: Awaited<ReturnType<typeof resolveHistorySubject>>;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n  author: string;\n  force: boolean | undefined;\n  loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;\n  historyPath: string;\n  rewrittenEntries: HistoryEntry[];\n}): Promise<string[]> {\n  return executeHistoryRewrite({\n    pmRoot: params.pmRoot,\n    subject: params.subject,\n    settings: params.settings,\n    typeRegistry: params.typeRegistry,\n    historyRawBeforeLock: params.historyRawBeforeLock,\n    currentItemRawBeforeLock: params.currentItemRawBeforeLock,\n    operation: \"history-repair\",\n    author: params.author,\n    force: params.force,\n    itemDocument: params.loadedItem?.document ?? null,\n    applyRewrite: async ({ historyRawUnderLock }) =>\n      writeHistoryRawWithRollback({\n        historyPath: params.historyPath,\n        nextHistoryRaw: historyEntriesToRaw(params.rewrittenEntries),\n        historyRawUnderLock,\n      }),\n    applyPostRewrite: async () =>\n      runActiveOnWriteHooks({\n        path: params.historyPath,\n        scope: \"project\",\n        op: \"history_repair:history\",\n      }),\n  });\n}\n\n/** Implements run history repair for the public runtime surface of this module. */\nexport async function runHistoryRepair(\n  id: string,\n  options: HistoryRepairCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRepairResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const subject = await resolveHistorySubject(\n    pmRoot,\n    id,\n    settings,\n    typeRegistry.type_to_folder,\n  );\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(\n      `No history stream exists for ${subject.id}.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const historyEntries = await readHistoryEntries(\n    subject.historyPath,\n    subject.id,\n  );\n  if (historyEntries.length === 0) {\n    throw new PmCliError(\n      `No history entries exist for ${subject.id}; nothing to repair.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const chainBefore = verifyHistoryChain(historyEntries);\n  const reanchor = reanchorHistoryEntries(historyEntries);\n\n  const itemReplayContext = await loadHistoryRepairItemReplay(\n    subject,\n    settings,\n    historyEntries,\n  );\n\n  const finalReplay = reanchor.finalDocument;\n  const reconcileNeeded =\n    itemReplayContext.currentItemReplay !== null &&\n    replayHash(finalReplay) !== replayHash(itemReplayContext.currentItemReplay);\n\n  const changed =\n    reanchor.entriesRehashed > 0 ||\n    reanchor.entriesPatchRepaired > 0 ||\n    reconcileNeeded;\n  const author = toAuthor(options.author, settings.author_default);\n  const dryRun = Boolean(options.dryRun);\n\n  const repairMessage = buildHistoryRepairMessage({\n    message: options.message,\n    entriesRehashed: reanchor.entriesRehashed,\n    entriesPatchRepaired: reanchor.entriesPatchRepaired,\n    reconcileNeeded,\n  });\n  const { rewrittenEntries, auditEntryAdded } = buildHistoryRepairEntries({\n    reanchorEntries: reanchor.entries,\n    changed,\n    reconcileNeeded,\n    currentItemReplay: itemReplayContext.currentItemReplay,\n    finalReplay,\n    author,\n    message: repairMessage,\n  });\n\n  const historyVerify = verifyHistoryChain(rewrittenEntries);\n  if (!historyVerify.ok) {\n    throw new PmCliError(\n      `history-repair produced an invalid rewritten chain (${historyVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n\n  const warnings = collectHistoryRepairWarnings(changed, reanchor.skippedOps);\n\n  if (changed && !dryRun) {\n    warnings.push(\n      ...(await applyHistoryRepairRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock: itemReplayContext.currentItemRawBeforeLock,\n        author,\n        force: options.force,\n        loadedItem: itemReplayContext.loadedItem,\n        historyPath: subject.historyPath,\n        rewrittenEntries,\n      })),\n    );\n  }\n\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    history: {\n      path: subject.historyPath,\n      entries_scanned: historyEntries.length,\n      chain_drift_before: !chainBefore.ok,\n      entries_rehashed: reanchor.entriesRehashed,\n      entries_patch_repaired: reanchor.entriesPatchRepaired,\n      converted_replace_to_add: reanchor.convertedReplaceToAdd,\n      skipped_ops: reanchor.skippedOps,\n      reconciled_with_item: reconcileNeeded,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: historyVerify.ok,\n      verify_errors: historyVerify.errors,\n    },\n    item: {\n      exists: itemReplayContext.currentItemPath !== null,\n      path: itemReplayContext.currentItemPath,\n      matched_chain_before: itemReplayContext.matchedChainBefore,\n    },\n    warnings: [...new Set(warnings)].sort((left, right) =>\n      left.localeCompare(right),\n    ),\n    generated_at: nowIso(),\n  };\n}\n\n/** Documents the history repair all stream result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairAllStreamResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports outcome for this contract. */\n  outcome: \"repaired\" | \"skipped_clean\" | \"failed\";\n  /** Value that configures or reports entries rehashed for this contract. */\n  entries_rehashed?: number;\n  /** Value that configures or reports entries patch repaired for this contract. */\n  entries_patch_repaired?: number;\n  /** Value that configures or reports reconciled with item for this contract. */\n  reconciled_with_item?: boolean;\n  /** Value that configures or reports error for this contract. */\n  error?: string;\n}\n\n/** Documents the history repair all result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairAllResult {\n  /** Value that configures or reports all for this contract. */\n  all: true;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports scanned streams for this contract. */\n  scanned_streams: number;\n  /** Value that configures or reports drifted streams for this contract. */\n  drifted_streams: number;\n  /** One compact row per drifted stream (clean streams are summarized by the counts only). */\n  streams: HistoryRepairAllStreamResult[];\n  /** Value that configures or reports totals for this contract. */\n  totals: { repaired: number; skipped_clean: number; failed: number };\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\n/** Enforce the `pm history-repair` target contract shared by the CLI and MCP surfaces: exactly one of an item `<id>` or `--all` must be provided. */\nexport function assertHistoryRepairTarget(\n  id: string | undefined,\n  all: boolean,\n): void {\n  if (all && id !== undefined) {\n    throw new PmCliError(\n      \"history-repair: <id> and --all are mutually exclusive; pass an item id to repair one stream or --all to repair every drifted stream.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!all && id === undefined) {\n    throw new PmCliError(\n      \"history-repair: provide an item <id> or pass --all to repair every drifted stream.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\n/** Bulk drift repair: scan every item's history stream with the same drift scan `pm health` uses, then run the audited single-stream repair (ownership check, lock, no-drift verification, audit marker) for each drifted stream. One failing stream never aborts the rest; failures are collected per row and the caller decides the exit code from `totals.failed`. */\nexport async function runHistoryRepairAll(\n  options: HistoryRepairCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRepairAllResult> {\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 settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const itemReadWarnings: string[] = [];\n  const items = await listAllItemMetadataWithBody(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    itemReadWarnings,\n    settings.schema,\n  );\n  const drift = await scanHistoryDrift(\n    pmRoot,\n    items as Array<ItemMetadata & { body: string }>,\n  );\n\n  const streams: HistoryRepairAllStreamResult[] = [];\n  const totals = { repaired: 0, skipped_clean: 0, failed: 0 };\n  for (const driftedId of drift.driftedItems) {\n    try {\n      const result = await runHistoryRepair(driftedId, options, global);\n      /* c8 ignore next -- mixed repaired/clean outcomes depend on live drift composition. */\n      const outcome = result.changed ? \"repaired\" : \"skipped_clean\";\n      totals[outcome] += 1;\n      streams.push({\n        id: driftedId,\n        outcome,\n        entries_rehashed: result.history.entries_rehashed,\n        entries_patch_repaired: result.history.entries_patch_repaired,\n        reconciled_with_item: result.history.reconciled_with_item,\n      });\n    } catch (error) {\n      totals.failed += 1;\n      streams.push({\n        id: driftedId,\n        outcome: \"failed\",\n        /* c8 ignore next -- non-Error throws are normalized in defensive fallback. */\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  return {\n    all: true,\n    dry_run: Boolean(options.dryRun),\n    scanned_streams: items.length,\n    drifted_streams: drift.driftedItems.length,\n    streams,\n    totals,\n    warnings: [...new Set(itemReadWarnings)].sort((left, right) =>\n      left.localeCompare(right),\n    ),\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"681e79d9-140b-5a78-9e24-6714efd974dc"}

package/dist/sdk/index.d.ts

@@ -4,6 +4,19 @@
  * Defines public SDK APIs and package-author helpers for Index.
  */
 export { isErrnoError, limitAnnotationEntries, parseAnnotationTextInput, readAnnotationEntries, resolveAnnotationInput, resolveAnnotationIndex, runAnnotationCommand, wrapOwnershipConflict, type AnnotationCommandConfig, type AnnotationCommandOptions, type AnnotationCommandResult, type AnnotationEntry, type AnnotationInput, type AnnotationSourceOptions, type OwnershipConflictGuidance, } from "./annotations.js";
+export { inspectHistoryAuthorStream, scanHistoryAuthorAttribution, type HistoryAuthorAttributionScan, type UnknownAuthorHistoryEvent, } from "./author-attribution.js";
+export { createPmCliProgram } from "./cli-program.js";
+export { quoteCommandArg, quoteWindowsCommandArg, renderPmCommand, } from "./command-line.js";
+export * from "./governance/gc.js";
+export * from "./governance/health.js";
+export * from "./governance/validate.js";
+export { runExtension } from "./extension.js";
+export { applyInvocationAuthorOverride } from "./invocation-author.js";
+export { _testOnly as _testOnlyTemplates, type TemplateSource, } from "./templates.js";
+export { runConfig, _testOnlyConfigCommand, type NestedSettingResultValue, } from "./config.js";
+export { INIT_AGENT_GUIDANCE_MODE_VALUES, runInitAgentGuidance, _testOnly as _testOnlyInitAgentGuidance, type InitAgentGuidanceMode, type InitAgentGuidanceSummary, type RunInitAgentGuidanceOptions, type RunInitAgentGuidanceResult, } from "./init-agent-guidance.js";
+export { runInit, summarizeInitResult, _testOnly as _testOnlyInit, type InitAgentGuidanceResult, type InitConciseResult, type InitInstalledPackagesSummary, type InitRegisteredTypePresetSummary, type InitTargetResolution, type InitTypePresetName, } from "./init.js";
+export { PROFILE_SUBCOMMANDS, formatProfileApplyHuman, formatProfileLintHuman, formatProfileListHuman, formatProfileShowHuman, runProfileApply, runProfileLint, runProfileList, runProfileShow, type ProfileApplyDimension, type ProfileComposition, type ProfileListEntry, } from "./profile.js";
 import { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES } from "../core/extensions/loader.js";
 export { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
 export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, type PmPackageCatalogLinkMap, type PmPackageCatalogMediaMap, type PmPackageCatalogMetadata, type PmPackageManifest, type PmPackageResourceKind, type PmPackageResourceMap, } from "../core/packages/manifest.js";
@@ -14,15 +27,26 @@ export * from "./compose.js";
 export * from "./context-relevance.js";
 export * from "./context-packing.js";
 export * from "./context-usage.js";
+export * from "./history-compact.js";
+export * from "./history-read.js";
+export * from "./history-redact.js";
+export * from "./history-repair.js";
+export * from "./item-children.js";
+export * from "./item-schedule.js";
 export { collectDanglingDependencyReferences, runDeps, type DanglingDependencyReference, type DanglingDependencyReferenceSummary, type DependencyReferenceHolder, type DepsCollapseMode, type DepsFormat, type DepsGraphEdge, type DepsGraphNode, type DepsGraphResult, type DepsTreeNode, } from "./dependencies.js";
 export { runDocs } from "./docs.js";
 export { runFiles, runFilesDiscover, type FilesDiscoveryCandidate, } from "./files.js";
 export { applyPathMigrations, applyStandaloneNote, artifactKey, dedupeLinkedArtifacts, ensureScope, expandAddGlobEntries, normalizeLinkedPath, parseAddEntries, parseAddGlobEntries, parseMigrateEntries, parseRemoveEntries, renameArtifactsResultKey, runLinkedArtifacts, sortLinkedArtifacts, validateLinkedPaths, type AddGlobEntry, type LinkedArtifact, type LinkedArtifactCommandOptions, type LinkedArtifactKindConfig, type LinkedArtifactResult, type LinkedPathValidation, type PathMigration, } from "./linked-artifacts.js";
 export * from "./pagination.js";
+export * from "./output.js";
+export * from "./relationship-analytics.js";
+export * from "./relationship-context.js";
+export * from "./relationship-history.js";
+export * from "./relationships.js";
 export type { PlanCommandOptions, PlanCommandResult, PlanDispatchInput, PlanResultPlan, PlanShowDepth, PlanStepSummary, PlanSubcommand, PlanTemplateName, } from "../cli/commands/plan.js";
 export { PLAN_SHOW_DEPTH_VALUES, PLAN_SUBCOMMANDS, PLAN_TEMPLATE_NAMES, } from "../cli/commands/plan.js";
 export * from "./define.js";
-export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, focus, gc, get, health, init, learnings, list, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, search, startTask, stats, update, upgrade, validate, type AggregateOptions, type AggregateResult, type AggregateRow, type AppendCommandOptions, type AppendResult, type BlockerEntry, type CalendarOptions, type CalendarResult, type ClaimResult, type CloseResult, type CloseTaskResult, type CommitImportedItemParams, type CommitImportedItemResult, type CommentsCommandOptions, type CommentsResult, type ConfigCommandOptions, type ConfigResult, type CompletionResult, type CompletionShell, type ContractsCommandOptions, type ContractsResult, type ContextFocusItem, type ContextOptions, type ContextOutputFormat, type ContextResult, type CopyResult, type CreatePmCliExpectedErrorOptions, type CreateResult, type CreateTemplateOptions, type Dependency, type DeleteResult, type DepsCommandOptions, type DepsResult, type DocsCommandOptions, type DocsResult, type ExtensionCommandOptions, type ExtensionCommandResult, type FilesCommandOptions, type FilesDiscoverOptions, type FilesDiscoverResult, type FilesResult, type FocusResult, type GcCommandOptions, type GcResult, type GetContractsOptions, type GetOptions, type GetResult, type GuideDepth, type GuideOptions, type GuideOutputFormat, type GuideResult, type HealthResult, type ImportLinkedScope, type InitCommandOptions, type InitResult, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, type LearningsCommandOptions, type LearningsResult, type LinkedDoc, type LinkedFile, type LinkedTest, type ListedItem, type ListCompactResult, type ListOptions, type ListResult, type ListSortField, type ListSortOrder, type ListVerboseResult, type LogNote, type NextActionableItem, type NextBlockerRef, type NextOptions, type NextOutputFormat, type NextRecommendation, type NextResult, type NotesCommandOptions, type NotesResult, type PackageCommandOptions, type PackageCommandResult, type PauseTaskResult, type PmActionInput, type PmActionName, type PmActionOptions, type PmClientFullMutationOptions, type PmClientMutationOptions, type PmClientOptions, type PmClientRunArgs, type PmCliExpectedError, type ProfileApplyCommandOptions, type ProfileApplyResult, type ProfileLintResult, type ProfileListResult, type ProfileResult, type ProfileShowResult, type ProfileSubcommand, type ReindexOptions, type ReindexResult, type ReleaseResult, type RestoreResult, type RunHealthOptions, type SchemaAddFieldCommandOptions, type SchemaAddFieldResult, type SchemaAddStatusCommandOptions, type SchemaAddStatusResult, type SchemaAddTypeCommandOptions, type SchemaAddTypeInferCommandOptions, type SchemaAddTypeInferResult, type SchemaAddTypeResult, type SchemaApplyPresetCommandOptions, type SchemaApplyPresetResult, type SchemaInspectResult, type SchemaListFieldsResult, type SchemaListResult, type SchemaRemoveFieldCommandOptions, type SchemaRemoveFieldResult, type SchemaRemoveStatusCommandOptions, type SchemaRemoveStatusResult, type SchemaRemoveTypeCommandOptions, type SchemaRemoveTypeResult, type SchemaShowFieldResult, type SchemaShowResult, type SchemaShowStatusResult, type SchemaResult, type SchemaSubcommand, type SearchCompactResult, type SearchHit, type SearchHitHighlight, type SearchMatchMode, type SearchOptions, type ClaimNextOptions, type SearchResult, type SearchResultItem, type SearchVerboseResult, type StartTaskResult, type StatsCommandOptions, type StatsResult, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, type ToImportLinkedArtifactsOptions, type ToImportLinkedTestsOptions, type ToImportLogEntriesOptions, type UpdateResult, type UpgradeCommandOptions, type UpgradeResult, type ValidateCommandOptions, type ValidateResult, type WorkspaceContracts, type WorkspaceContractsOptions, } from "./runtime.js";
+export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, focus, gc, get, health, historyCompact, historyCompactBulk, historyRedact, historyRepair, historyRepairAll, init, learnings, list, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, search, startTask, stats, update, upgrade, validate, type AggregateOptions, type AggregateResult, type AggregateRow, type AppendCommandOptions, type AppendResult, type BlockerEntry, type CalendarOptions, type CalendarResult, type ClaimResult, type CloseResult, type CloseTaskResult, type CommitImportedItemParams, type CommitImportedItemResult, type CommentsCommandOptions, type CommentsResult, type ConfigCommandOptions, type ConfigResult, type CompletionResult, type CompletionShell, type ContractsCommandOptions, type ContractsResult, type ContextFocusItem, type ContextOptions, type ContextOutputFormat, type ContextResult, type CopyResult, type CreatePmCliExpectedErrorOptions, type CreateResult, type CreateTemplateOptions, type Dependency, type DeleteResult, type DepsCommandOptions, type DepsResult, type DocsCommandOptions, type DocsResult, type ExtensionCommandOptions, type ExtensionCommandResult, type FilesCommandOptions, type FilesDiscoverOptions, type FilesDiscoverResult, type FilesResult, type FocusResult, type GcCommandOptions, type GcResult, type GetContractsOptions, type GetOptions, type GetResult, type GuideDepth, type GuideOptions, type GuideOutputFormat, type GuideResult, type HealthResult, type ImportLinkedScope, type InitCommandOptions, type InitResult, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, type LearningsCommandOptions, type LearningsResult, type LinkedDoc, type LinkedFile, type LinkedTest, type ListedItem, type ListCompactResult, type ListOptions, type ListResult, type ListSortField, type ListSortOrder, type ListVerboseResult, type LogNote, type NextActionableItem, type NextBlockerRef, type NextOptions, type NextOutputFormat, type NextRecommendation, type NextResult, type NotesCommandOptions, type NotesResult, type PackageCommandOptions, type PackageCommandResult, type PauseTaskResult, type PmActionInput, type PmActionName, type PmActionOptions, type PmClientFullMutationOptions, type PmClientMutationOptions, type PmClientOptions, type PmClientRunArgs, type PmCliExpectedError, type ProfileApplyCommandOptions, type ProfileApplyResult, type ProfileLintResult, type ProfileListResult, type ProfileResult, type ProfileShowResult, type ProfileSubcommand, type ReindexOptions, type ReindexResult, type ReleaseResult, type RestoreResult, type RunHealthOptions, type SchemaAddFieldCommandOptions, type SchemaAddFieldResult, type SchemaAddStatusCommandOptions, type SchemaAddStatusResult, type SchemaAddTypeCommandOptions, type SchemaAddTypeInferCommandOptions, type SchemaAddTypeInferResult, type SchemaAddTypeResult, type SchemaApplyPresetCommandOptions, type SchemaApplyPresetResult, type SchemaInspectResult, type SchemaListFieldsResult, type SchemaListResult, type SchemaRemoveFieldCommandOptions, type SchemaRemoveFieldResult, type SchemaRemoveStatusCommandOptions, type SchemaRemoveStatusResult, type SchemaRemoveTypeCommandOptions, type SchemaRemoveTypeResult, type SchemaShowFieldResult, type SchemaShowResult, type SchemaShowStatusResult, type SchemaResult, type SchemaSubcommand, type SearchCompactResult, type SearchHit, type SearchHitHighlight, type SearchMatchMode, type SearchOptions, type ClaimNextOptions, type SearchResult, type SearchResultItem, type SearchVerboseResult, type StartTaskResult, type StatsCommandOptions, type StatsResult, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, type ToImportLinkedArtifactsOptions, type ToImportLinkedTestsOptions, type ToImportLogEntriesOptions, type UpdateResult, type UpgradeCommandOptions, type UpgradeResult, type ValidateCommandOptions, type ValidateResult, type WorkspaceContracts, type WorkspaceContractsOptions, } from "./runtime.js";
 export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, type ProfileConfigEntry, type ProfileName, type ProfilePackageRecommendation, type ProfileTemplateEntry, type ProfileTemplateOptions, type ProjectProfileDefinition, type ProjectProfileRegistrationInput, } from "../core/profile/profile-presets.js";
 export { planProfileApplication, type ProfileApplicationPlan, type ProfileChangeStatus, type ProfileComponentChange, type ProfileConfigChange, type ProfileConfigPlan, type ProfileCurrentState, type ProfilePackagePlan, type ProfileSchemaPlan, type ProfileTemplateChange, type ProfileTemplatePlan, type ProfileWorkflowChange, type ProfileWorkflowPlan, } from "../core/profile/profile-plan.js";
 export { describeProfileComposition, describeProjectProfile, type ProjectProfileComposition, type ProjectProfileDescription, type ProjectProfilePackageSummary, } from "../core/profile/profile-describe.js";