@unbrained/pm-cli 2026.7.14 → 2026.7.15

package/dist/cli-bundle/chunks/chunk-GOSLKLFE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/history/replay.ts","../../../../../../../../core/history/projection.ts","../../../../../../../../core/history/read.ts","../../../../../../../../sdk/history-redact.ts","../../../../../../../../core/history/history-rewrite.ts"],"sourcesContent":["/**\n * @module core/history/replay\n *\n * Implements append-only history and replay behavior for Replay.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport { ITEM_METADATA_KEY_ORDER } from \"../shared/constants.js\";\nimport { canonicalDocument } from \"../item/item-format.js\";\nimport { toItemRecord } from \"../item/item-record.js\";\nimport {\n  orderObject,\n  sha256Hex,\n  stableStringify,\n} from \"../shared/serialization.js\";\nimport { hashDocument } from \"./history.js\";\nimport type {\n  HistoryEntry,\n  HistoryPatchOp,\n  ItemDocument,\n  ItemMetadata,\n} from \"../../types/index.js\";\n\n/**\n * Shared history replay/patch mechanics single-sourced for the history, restore,\n * history-redact, and history-repair commands plus the health/validate drift checks.\n *\n * Each command keeps its own thin error-formatting wrapper so the exact CLI error\n * contracts (restore's rich patch-failure context, redact's op tag, history's\n * generic message) are preserved; only the underlying replay/patch logic is shared.\n */\n\nexport interface ReplayDocument {\n  /** Value that configures or reports metadata for this contract. */\n  metadata: Record<string, unknown>;\n  /** Value that configures or reports body for this contract. */\n  body: string;\n}\n\n/** Public contract for empty replay document, shared by SDK and presentation-layer consumers. */\nexport const EMPTY_REPLAY_DOCUMENT: ReplayDocument = {\n  metadata: {},\n  body: \"\",\n};\n\n/** Implements clone empty replay document for the public runtime surface of this module. */\nexport function cloneEmptyReplayDocument(): ReplayDocument {\n  return structuredClone(EMPTY_REPLAY_DOCUMENT);\n}\n\n/** Implements replay hash for the public runtime surface of this module. */\nexport function replayHash(document: ReplayDocument): string {\n  try {\n    return hashDocument(replayToItemDocument(document));\n  } catch {\n    // Legacy/malformed replay states (for example a stream whose first entry never\n    // established a full `create` document, so the canonicalizer cannot normalize it)\n    // cannot be canonically hashed. Fall back to a deterministic structural hash so\n    // re-anchor and verification stay internally consistent for these streams. Fully\n    // formed documents always take the canonical path above, so valid streams are\n    // unaffected.\n    return sha256Hex(\n      stableStringify({\n        replay_fallback: true,\n        metadata: document.metadata,\n        body: document.body,\n      }),\n    );\n  }\n}\n\n/** Implements replay to item document for the public runtime surface of this module. */\nexport function replayToItemDocument(document: ReplayDocument): ItemDocument {\n  return {\n    metadata: document.metadata as ItemMetadata,\n    body: document.body,\n  };\n}\n\n/** Converts a materialized replay document into a canonical item document. Use this when callers have already rejected the empty/deleted replay state and need restored metadata validated through the normal item-metadata rules. */\nexport function replayToCanonicalItemDocument(\n  document: ReplayDocument,\n  options: Parameters<typeof canonicalDocument>[1] = {},\n): ItemDocument {\n  return canonicalDocument(replayToItemDocument(document), options);\n}\n\n/** Canonicalize an item document into the ordered replay form used when comparing a replayed chain against the on-disk item (restore + history-repair reconciliation). */\nexport function toReplayDocument(document: ItemDocument): ReplayDocument {\n  if (!document.metadata || Object.keys(document.metadata).length === 0) {\n    return {\n      metadata: {},\n      body: document.body ?? \"\",\n    };\n  }\n  const canonical = canonicalDocument(document);\n  return {\n    metadata: orderObject(\n      toItemRecord(canonical.metadata),\n      ITEM_METADATA_KEY_ORDER,\n    ),\n    body: canonical.body,\n  };\n}\n\n/** Implements normalize replay patch path for the public runtime surface of this module. */\nexport function normalizeReplayPatchPath(path: string): string {\n  if (path === \"/front_matter\") {\n    return \"/metadata\";\n  }\n  if (path.startsWith(\"/front_matter/\")) {\n    return `/metadata/${path.slice(\"/front_matter/\".length)}`;\n  }\n  return path;\n}\n\nfunction isHistoryPatchOp(value: unknown): value is HistoryPatchOp {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { op?: unknown }).op === \"string\" &&\n    typeof (value as { path?: unknown }).path === \"string\"\n  );\n}\n\n/** Implements normalize replay patch ops for the public runtime surface of this module. */\nexport function normalizeReplayPatchOps(\n  patch: HistoryPatchOp[] | unknown,\n): HistoryPatchOp[] {\n  if (!Array.isArray(patch)) {\n    return [];\n  }\n  return patch.filter(isHistoryPatchOp).map((operation) => ({\n    ...operation,\n    path: normalizeReplayPatchPath(operation.path),\n    from:\n      typeof operation.from === \"string\"\n        ? normalizeReplayPatchPath(operation.from)\n        : undefined,\n  }));\n}\n\nfunction isReplayDocumentShape(\n  value: unknown,\n): value is { metadata: Record<string, unknown>; body: string } {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"metadata\" in value &&\n    \"body\" in value &&\n    typeof (value as { body: unknown }).body === \"string\" &&\n    typeof (value as { metadata: unknown }).metadata === \"object\" &&\n    (value as { metadata: unknown }).metadata !== null\n  );\n}\n\n/** Restricts replay apply result values accepted by command, SDK, and storage contracts. */\nexport type ReplayApplyResult =\n  | { ok: true; document: ReplayDocument }\n  | { ok: false; error: unknown };\n\n/** Strictly apply a history patch (front_matter->metadata normalized) to a replay document. Returns a result envelope rather than throwing so each caller can format its own error contract. */\nexport function tryApplyReplayPatch(\n  current: ReplayDocument,\n  patch: HistoryPatchOp[],\n): ReplayApplyResult {\n  try {\n    const normalizedPatch = normalizeReplayPatchOps(patch);\n    const applied = jsonPatch.applyPatch(\n      structuredClone(current),\n      normalizedPatch as jsonPatch.Operation[],\n      true,\n      false,\n    ).newDocument as unknown;\n    if (!isReplayDocumentShape(applied)) {\n      return {\n        ok: false,\n        error: new Error(\"history_replay_invalid_document_shape\"),\n      };\n    }\n    return {\n      ok: true,\n      document: { metadata: applied.metadata, body: applied.body },\n    };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/** Deterministically verify a history chain: each entry's before_hash must equal the prior replayed after_hash, the patch must strictly apply, and the recorded after_hash must equal the replayed result. */\nexport function verifyHistoryChain(entries: HistoryEntry[]): {\n  ok: boolean;\n  errors: string[];\n} {\n  let replay = cloneEmptyReplayDocument();\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    if (replayHash(replay) !== entry.before_hash) {\n      return {\n        ok: false,\n        errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`],\n      };\n    }\n    const applied = tryApplyReplayPatch(replay, entry.patch);\n    if (!applied.ok) {\n      return {\n        ok: false,\n        errors: [`verify_failed:patch_apply_failed:entry_${index + 1}`],\n      };\n    }\n    replay = applied.document;\n    if (replayHash(replay) !== entry.after_hash) {\n      return {\n        ok: false,\n        errors: [`verify_failed:after_hash_mismatch:entry_${index + 1}`],\n      };\n    }\n  }\n  return { ok: true, errors: [] };\n}\n\n/** Documents the lenient apply result payload exchanged by command, SDK, and package integrations. */\nexport interface LenientApplyResult {\n  /** Value that configures or reports document for this contract. */\n  document: ReplayDocument;\n  /** Value that configures or reports converted replace to add for this contract. */\n  convertedReplaceToAdd: number;\n  /** Value that configures or reports skipped ops for this contract. */\n  skippedOps: number;\n}\n\nfunction tryApplySingleOp(\n  document: unknown,\n  op: HistoryPatchOp,\n): { ok: true; document: unknown } | { ok: false } {\n  try {\n    const applied = jsonPatch.applyPatch(\n      structuredClone(document),\n      [op as jsonPatch.Operation],\n      true,\n      false,\n    ).newDocument as unknown;\n    return { ok: true, document: applied };\n  } catch {\n    return { ok: false };\n  }\n}\n\n/** Apply a legacy patch op-by-op, recovering from drift that strict replay rejects: a `replace` whose path no longer exists is retried as `add`, and any op that still cannot apply against the current replay state is skipped. The resulting document is what the repaired entry's recomputed patch should target. */\nexport function lenientApplyReplayPatch(\n  current: ReplayDocument,\n  patch: HistoryPatchOp[],\n): LenientApplyResult {\n  let working: unknown = structuredClone(current);\n  let convertedReplaceToAdd = 0;\n  let skippedOps = 0;\n\n  for (const op of normalizeReplayPatchOps(patch)) {\n    const direct = tryApplySingleOp(working, op);\n    if (direct.ok) {\n      working = direct.document;\n      continue;\n    }\n    if (op.op === \"replace\") {\n      const asAdd = tryApplySingleOp(working, { ...op, op: \"add\" });\n      if (asAdd.ok) {\n        working = asAdd.document;\n        convertedReplaceToAdd += 1;\n        continue;\n      }\n    }\n    skippedOps += 1;\n  }\n\n  const candidate = working as { metadata?: unknown; body?: unknown };\n  const document: ReplayDocument = {\n    metadata:\n      typeof candidate.metadata === \"object\" && candidate.metadata !== null\n        ? (candidate.metadata as Record<string, unknown>)\n        : {},\n    body: typeof candidate.body === \"string\" ? candidate.body : current.body,\n  };\n  return { document, convertedReplaceToAdd, skippedOps };\n}\n\n/** Documents the reanchor entry detail payload exchanged by command, SDK, and package integrations. */\nexport interface ReanchorEntryDetail {\n  /** Value that configures or reports index for this contract. */\n  index: number;\n  /** Value that configures or reports rehashed for this contract. */\n  rehashed: boolean;\n  /** Value that configures or reports patch repaired for this contract. */\n  patch_repaired: boolean;\n  /** Value that configures or reports converted replace to add for this contract. */\n  converted_replace_to_add: number;\n  /** Value that configures or reports skipped ops for this contract. */\n  skipped_ops: number;\n}\n\n/** Documents the reanchor result payload exchanged by command, SDK, and package integrations. */\nexport interface ReanchorResult {\n  /** Value that configures or reports entries for this contract. */\n  entries: HistoryEntry[];\n  /** Value that configures or reports final document for this contract. */\n  finalDocument: ReplayDocument;\n  /** Value that configures or reports entries rehashed for this contract. */\n  entriesRehashed: number;\n  /** Value that configures or reports entries patch repaired for this contract. */\n  entriesPatchRepaired: number;\n  /** Value that configures or reports converted replace to add for this contract. */\n  convertedReplaceToAdd: number;\n  /** Value that configures or reports skipped ops for this contract. */\n  skippedOps: number;\n  /** Value that configures or reports details for this contract. */\n  details: ReanchorEntryDetail[];\n}\n\n/** Re-anchor a drifted history chain: replay every entry from empty, recompute the before/after hashes, and only rewrite a patch when the original op set no longer strictly applies (legacy drift). Clean entries keep their patch verbatim so the on-disk diff stays minimal. The returned chain verifies via verifyHistoryChain. */\nexport function reanchorHistoryEntries(\n  entries: HistoryEntry[],\n): ReanchorResult {\n  let replay = cloneEmptyReplayDocument();\n  const rewritten: HistoryEntry[] = [];\n  const details: ReanchorEntryDetail[] = [];\n  let entriesRehashed = 0;\n  let entriesPatchRepaired = 0;\n  let convertedReplaceToAdd = 0;\n  let skippedOps = 0;\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    const beforeHash = replayHash(replay);\n    const strict = tryApplyReplayPatch(replay, entry.patch);\n\n    let next: ReplayDocument;\n    let outPatch: HistoryPatchOp[];\n    let patchRepaired = false;\n    let entryConverted = 0;\n    let entrySkipped = 0;\n\n    if (strict.ok) {\n      next = strict.document;\n      outPatch = entry.patch;\n    } else {\n      const lenient = lenientApplyReplayPatch(replay, entry.patch);\n      next = lenient.document;\n      outPatch = jsonPatch.compare(replay, next) as HistoryPatchOp[];\n      patchRepaired = true;\n      entryConverted = lenient.convertedReplaceToAdd;\n      entrySkipped = lenient.skippedOps;\n      convertedReplaceToAdd += entryConverted;\n      skippedOps += entrySkipped;\n      entriesPatchRepaired += 1;\n    }\n\n    const afterHash = replayHash(next);\n    const rehashed =\n      beforeHash !== entry.before_hash || afterHash !== entry.after_hash;\n    if (rehashed) {\n      entriesRehashed += 1;\n    }\n\n    rewritten.push({\n      ...entry,\n      patch: outPatch,\n      before_hash: beforeHash,\n      after_hash: afterHash,\n    });\n    details.push({\n      index: index + 1,\n      rehashed,\n      patch_repaired: patchRepaired,\n      converted_replace_to_add: entryConverted,\n      skipped_ops: entrySkipped,\n    });\n    replay = next;\n  }\n\n  return {\n    entries: rewritten,\n    finalDocument: replay,\n    entriesRehashed,\n    entriesPatchRepaired,\n    convertedReplaceToAdd,\n    skippedOps,\n    details,\n  };\n}\n\n/** Implements history entries to raw for the public runtime surface of this module. */\nexport function historyEntriesToRaw(entries: HistoryEntry[]): string {\n  if (entries.length === 0) {\n    return \"\";\n  }\n  return `${entries.map((entry) => JSON.stringify(entry)).join(\"\\n\")}\\n`;\n}\n","/**\n * @module core/history/projection\n *\n * Reconstructs verified point-in-time item states from hash-chained history.\n * Restore, SDK reads, and future VCS-style integrations share this single\n * replay kernel so read and write paths cannot disagree about a version.\n */\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport type { HistoryEntry, HistoryPatchOp } from \"../../types/index.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  replayHash,\n  tryApplyReplayPatch,\n  type ReplayDocument,\n} from \"./replay.js\";\n\n/** Describes the normalized version or timestamp selected from a history stream. */\nexport interface ResolvedHistoryTarget {\n  /** Target syntax selected by the caller. */\n  kind: \"version\" | \"timestamp\";\n  /** Original normalized target text. */\n  raw: string;\n  /** Zero-based history entry selected for reconstruction. */\n  historyIndex: number;\n}\n\n/** Controls caller-specific target diagnostics and future timestamp policy. */\nexport interface ResolveHistoryTargetOptions {\n  /** Command concept named in agent-facing validation errors. */\n  errorSubject?: \"history\" | \"restore\";\n  /** Allow a timestamp after the final entry to select that final entry. */\n  allowFutureTimestamp?: boolean;\n}\n\ninterface PatchFailureContext {\n  patchIndex?: number;\n  op?: string;\n  path?: string;\n  from?: string;\n  reason?: string;\n}\n\n/** Find the final history entry recorded at or before a parsed timestamp. */\nfunction findHistoryIndexAtTimestamp(\n  history: readonly HistoryEntry[],\n  parsedTarget: number,\n): number {\n  let historyIndex = -1;\n  history.forEach((entry, index) => {\n    const entryTimestamp = Date.parse(entry.ts);\n    if (!Number.isFinite(entryTimestamp)) {\n      throw new PmCliError(\n        `History for this item contains invalid timestamp at entry ${index + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (entryTimestamp <= parsedTarget) {\n      historyIndex = index;\n    }\n  });\n  return historyIndex;\n}\n\n/** Build structured target-range guidance once for every resolver error path. */\nfunction buildHistoryTargetGuidance(history: readonly HistoryEntry[]) {\n  const firstTimestamp = history[0]?.ts ?? null;\n  const lastTimestamp = history.at(-1)?.ts ?? null;\n  const guidance = {\n    code: \"history_target_out_of_range\",\n    required: \"Choose a target within the available item history.\",\n    why: \"Point-in-time reads and restores can only reconstruct recorded versions.\",\n    examples: [] as string[],\n    nextSteps: [\n      \"Run pm history <id> to inspect available versions and timestamps.\",\n    ],\n    valid_range: {\n      first_version: null as number | null,\n      last_version: null as number | null,\n      first_timestamp: firstTimestamp,\n      last_timestamp: lastTimestamp,\n    },\n  };\n  if (lastTimestamp !== null) {\n    guidance.examples = [\"1\", String(history.length), lastTimestamp];\n    guidance.valid_range.first_version = 1;\n    guidance.valid_range.last_version = history.length;\n  }\n  return { guidance, lastTimestamp };\n}\n\n/** Extract best-effort JSON Patch position details for replay diagnostics. */\nexport function extractPatchFailureContext(\n  patch: HistoryPatchOp[],\n  error: unknown,\n): PatchFailureContext {\n  const failure: PatchFailureContext = {};\n  if (error instanceof Error && error.message.trim().length > 0) {\n    failure.reason = error.message.trim();\n  }\n  if (typeof error !== \"object\" || error === null) {\n    return failure;\n  }\n  const candidate = error as { index?: unknown; operation?: unknown };\n  if (\n    typeof candidate.index === \"number\" &&\n    Number.isInteger(candidate.index) &&\n    candidate.index >= 0\n  ) {\n    failure.patchIndex = candidate.index;\n  }\n  if (typeof candidate.operation === \"object\" && candidate.operation !== null) {\n    const operation = candidate.operation as Record<string, unknown>;\n    Object.assign(\n      failure,\n      Object.fromEntries(\n        ([\"op\", \"path\", \"from\"] as const).flatMap((field) => {\n          const value = operation[field];\n          return typeof value === \"string\" ? [[field, value]] : [];\n        }),\n      ),\n    );\n  }\n  if (failure.patchIndex !== undefined) {\n    const fallback = patch[failure.patchIndex];\n    if (fallback) {\n      failure.op ??= fallback.op;\n      failure.path ??= fallback.path;\n      failure.from ??= fallback.from;\n    }\n  }\n  return failure;\n}\n\n/**\n * Resolve a one-based version or ISO timestamp into a concrete history entry.\n * Errors include structured valid-range metadata for agent and SDK callers.\n */\nexport function resolveHistoryTarget(\n  target: string,\n  history: readonly HistoryEntry[],\n  options: ResolveHistoryTargetOptions = {},\n): ResolvedHistoryTarget {\n  const trimmed = target.trim();\n  const errorSubject = options.errorSubject ?? \"history\";\n  const errorSubjectTitle = errorSubject === \"restore\" ? \"Restore\" : \"History\";\n  const { guidance, lastTimestamp } = buildHistoryTargetGuidance(history);\n  if (!trimmed) {\n    throw new PmCliError(\n      `Missing ${errorSubject} target. Use a timestamp or version number.`,\n      EXIT_CODE.USAGE,\n      guidance,\n    );\n  }\n  if (/^\\d+$/.test(trimmed)) {\n    const version = Number(trimmed);\n    if (\n      !Number.isSafeInteger(version) ||\n      version < 1 ||\n      version > history.length\n    ) {\n      throw new PmCliError(\n        `${errorSubjectTitle} version must be between 1 and ${history.length} for this item.`,\n        EXIT_CODE.USAGE,\n        guidance,\n      );\n    }\n    return { kind: \"version\", raw: trimmed, historyIndex: version - 1 };\n  }\n  const parsedTarget = Date.parse(trimmed);\n  if (!Number.isFinite(parsedTarget)) {\n    throw new PmCliError(\n      `Invalid ${errorSubject} target \"${target}\". Use a positive version number or ISO timestamp.`,\n      EXIT_CODE.USAGE,\n      guidance,\n    );\n  }\n  const historyIndex = findHistoryIndexAtTimestamp(history, parsedTarget);\n  if (\n    historyIndex < 0 ||\n    (options.allowFutureTimestamp !== true &&\n      parsedTarget > Date.parse(lastTimestamp as string))\n  ) {\n    throw new PmCliError(\n      errorSubject === \"restore\"\n        ? `No history entries exist at or before timestamp ${trimmed}.`\n        : `No history entry exists at timestamp ${trimmed}.`,\n      EXIT_CODE.USAGE,\n      guidance,\n    );\n  }\n  return { kind: \"timestamp\", raw: trimmed, historyIndex };\n}\n\n/** Apply one normalized JSON Patch entry and retain actionable failure context. */\nexport function applyHistoryPatch(\n  current: ReplayDocument,\n  patch: HistoryPatchOp[],\n  entryNumber: number,\n  entryOp: string,\n): ReplayDocument {\n  const applied = tryApplyReplayPatch(current, patch);\n  if (applied.ok) {\n    return applied.document;\n  }\n  const failure = extractPatchFailureContext(patch, applied.error);\n  const tokens = [\n    `history_op=${entryOp}`,\n    failure.patchIndex === undefined\n      ? null\n      : `patch_index=${failure.patchIndex}`,\n    failure.op ? `op=${failure.op}` : null,\n    failure.path ? `path=${failure.path}` : null,\n    failure.from ? `from=${failure.from}` : null,\n  ].filter((token): token is string => token !== null);\n  throw new PmCliError(\n    `Failed to apply history patch at entry ${entryNumber} (${tokens.join(\", \")}). ${failure.reason ?? String(applied.error)}`,\n    EXIT_CODE.GENERIC_FAILURE,\n  );\n}\n\n/** Replay and hash-verify a history stream through a zero-based target entry. */\nexport function replayHistoryToTarget(\n  history: readonly HistoryEntry[],\n  targetIndex: number,\n): ReplayDocument {\n  let document: ReplayDocument = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  for (let index = 0; index <= targetIndex; index += 1) {\n    const entry = history[index];\n    if (!entry) {\n      throw new PmCliError(\n        `History target entry ${index + 1} does not exist.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (replayHash(document) !== entry.before_hash) {\n      throw new PmCliError(\n        `History hash mismatch before replay at entry ${index + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    document = applyHistoryPatch(document, entry.patch, index + 1, entry.op);\n    if (replayHash(document) !== entry.after_hash) {\n      throw new PmCliError(\n        `History hash mismatch after replay at entry ${index + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n  return document;\n}\n\n/** Reject a version whose reconstructed state represents a deleted item. */\nexport function ensureMaterializedHistoryTarget(\n  replayDocument: ReplayDocument,\n  target: ResolvedHistoryTarget,\n): ReplayDocument {\n  if (Object.keys(replayDocument.metadata).length > 0) {\n    return replayDocument;\n  }\n  throw new PmCliError(\n    `History target ${target.raw} resolves to a deleted state; choose a version or timestamp where the item exists.`,\n    EXIT_CODE.USAGE,\n  );\n}\n","/**\n * @module core/history/read\n *\n * Reads append-only item history streams with conflict-marker detection,\n * extension read hooks, and line-specific JSONL diagnostics. Keeping this\n * storage primitive below both the CLI and SDK prevents public history\n * maintenance APIs from depending on presentation-layer modules.\n */\nimport { readFileIfExists } from \"../fs/fs-utils.js\";\nimport { runActiveOnReadHooks } from \"../extensions/index.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { findFirstMergeConflictMarker } from \"../shared/conflict-markers.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\n/** Read and validate one item's JSONL history stream without mutating it. */\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({ path: historyPath, scope: \"project\" });\n  if (raw.trim() === \"\") {\n    return [];\n  }\n  const conflictMarker = findFirstMergeConflictMarker(raw);\n  if (conflictMarker) {\n    throw new PmCliError(\n      `History for ${itemId} contains merge conflict markers at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`,\n      EXIT_CODE.GENERIC_FAILURE,\n      {\n        code: \"history_merge_conflict_markers_detected\",\n        required: \"Repair the history stream by resolving merge-conflict markers.\",\n        why: \"Conflict markers break JSONL parsing and invalidate deterministic audit history.\",\n        examples: [\n          `pm history ${itemId}`,\n          `pm restore ${itemId} <timestamp-or-version>`,\n        ],\n        nextSteps: [\"Resolve or restore the history file, then rerun the command.\"],\n      },\n    );\n  }\n\n  const entries: HistoryEntry[] = [];\n  for (const [index, rawLine] of raw.split(/\\r?\\n/).entries()) {\n    const line = rawLine.trim();\n    if (!line) {\n      continue;\n    }\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 * @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","/**\n * @module core/history/history-rewrite\n *\n * Implements append-only history and replay behavior for History Rewrite.\n */\nimport fs from \"node:fs/promises\";\nimport { readFileIfExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport type { ItemTypeRegistry } from \"../item/type-registry.js\";\nimport { acquireLock } from \"../lock/lock.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { locateItem, readLocatedItem } from \"../store/item-store.js\";\nimport { resolveGovernanceKnobs } from \"../store/settings.js\";\nimport type { ItemDocument, PmSettings } from \"../../types/index.js\";\n\ntype LoadedItem = Awaited<ReturnType<typeof readLocatedItem>>;\ntype HistoryRawWriter = (filePath: string, content: string) => Promise<void>;\n\n/** Documents the history rewrite subject payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRewriteSubject {\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}\n\n/** Documents the history rewrite ownership params payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRewriteOwnershipParams {\n  /** Value that configures or reports item document for this contract. */\n  itemDocument: ItemDocument | null;\n  /** Value that configures or reports subject id for this contract. */\n  subjectId: string;\n  /** Value that configures or reports author for this contract. */\n  author: string;\n  /** Value that configures or reports force for this contract. */\n  force: boolean | undefined;\n  /** Value that configures or reports settings for this contract. */\n  settings: PmSettings;\n}\n\n/** Apply ownership_enforcement governance to a history-rewriting operation. Returns the warning(s) the caller should append (empty when no conflict or strict-throws). Throws PmCliError(CONFLICT) in strict mode when the assignee conflicts and --force is not set. */\nexport function checkHistoryRewriteOwnership(\n  params: HistoryRewriteOwnershipParams,\n): string[] {\n  if (!params.itemDocument) return [];\n  const assigned = params.itemDocument.metadata?.assignee?.trim();\n  if (!assigned || assigned === params.author || params.force) return [];\n\n  const governance = resolveGovernanceKnobs(params.settings);\n  if (governance.ownership_enforcement === \"strict\") {\n    throw new PmCliError(\n      `Item ${params.subjectId} is assigned to ${assigned}. Use --force to override.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  if (governance.ownership_enforcement === \"warn\") {\n    return [\n      `ownership_warning:assignee_conflict:${params.subjectId}:${assigned}`,\n    ];\n  }\n  return [];\n}\n\n/** Documents the verify history rewrite drift params payload exchanged by command, SDK, and package integrations. */\nexport interface VerifyHistoryRewriteDriftParams {\n  /** Value that configures or reports pm root for this contract. */\n  pmRoot: string;\n  /** Value that configures or reports subject for this contract. */\n  subject: HistoryRewriteSubject;\n  /** Value that configures or reports settings for this contract. */\n  settings: PmSettings;\n  /** Value that configures or reports type registry for this contract. */\n  typeRegistry: ItemTypeRegistry;\n  /** Value that configures or reports history raw before lock for this contract. */\n  historyRawBeforeLock: string | null;\n  /** Value that configures or reports current item raw before lock for this contract. */\n  currentItemRawBeforeLock: string | null;\n  /** Short operation name used in the conflict message (e.g. \"history-redact\"). */\n  operation: string;\n}\n\n/** Documents the verified history rewrite state payload exchanged by command, SDK, and package integrations. */\nexport interface VerifiedHistoryRewriteState {\n  /** Value that configures or reports history raw under lock for this contract. */\n  historyRawUnderLock: string | null;\n  /** Value that configures or reports located under lock for this contract. */\n  locatedUnderLock: Awaited<ReturnType<typeof locateItem>>;\n  /** Value that configures or reports loaded item under lock for this contract. */\n  loadedItemUnderLock: LoadedItem | null;\n}\n\n/** Re-read the history stream and the located item document under the acquired lock and compare both with the pre-lock raw snapshots. Throws PmCliError(CONFLICT) if either diverged while waiting for the lock so the caller surfaces an actionable retry. */\nexport async function verifyHistoryRewriteNoDrift(\n  params: VerifyHistoryRewriteDriftParams,\n): Promise<VerifiedHistoryRewriteState> {\n  const historyRawUnderLock = await readFileIfExists(\n    params.subject.historyPath,\n  );\n  if (historyRawUnderLock !== params.historyRawBeforeLock) {\n    throw new PmCliError(\n      `History for ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  const locatedUnderLock = await locateItem(\n    params.pmRoot,\n    params.subject.id,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    params.typeRegistry.type_to_folder,\n  );\n  const loadedItemUnderLock = locatedUnderLock\n    ? await readLocatedItem(locatedUnderLock, {\n        schema: params.settings.schema,\n      })\n    : null;\n  if (\n    (loadedItemUnderLock?.raw ?? null) !==\n    (params.currentItemRawBeforeLock ?? null)\n  ) {\n    throw new PmCliError(\n      `Item ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  return { historyRawUnderLock, locatedUnderLock, loadedItemUnderLock };\n}\n\n/** Documents the execute history rewrite params payload exchanged by command, SDK, and package integrations. */\nexport interface ExecuteHistoryRewriteParams {\n  /** Value that configures or reports pm root for this contract. */\n  pmRoot: string;\n  /** Value that configures or reports subject for this contract. */\n  subject: HistoryRewriteSubject;\n  /** Value that configures or reports settings for this contract. */\n  settings: PmSettings;\n  /** Value that configures or reports type registry for this contract. */\n  typeRegistry: ItemTypeRegistry;\n  /** Value that configures or reports history raw before lock for this contract. */\n  historyRawBeforeLock: string | null;\n  /** Value that configures or reports current item raw before lock for this contract. */\n  currentItemRawBeforeLock: string | null;\n  /** Short operation name used in conflict guidance (e.g. \"history-redact\"). */\n  operation: string;\n  /** Value that configures or reports author for this contract. */\n  author: string;\n  /** Value that configures or reports force for this contract. */\n  force: boolean | undefined;\n  /** Value that configures or reports item document for this contract. */\n  itemDocument: ItemDocument | null;\n  /** Value that configures or reports apply rewrite for this contract. */\n  applyRewrite: (verified: VerifiedHistoryRewriteState) => Promise<void>;\n  /** Value that configures or reports apply post rewrite for this contract. */\n  applyPostRewrite?: (\n    verified: VerifiedHistoryRewriteState,\n  ) => Promise<string[]>;\n}\n\n/** Writes the rewritten history stream and restores the under-lock snapshot on failure. */\nexport async function writeHistoryRawWithRollback(params: {\n  historyPath: string;\n  nextHistoryRaw: string;\n  historyRawUnderLock: string | null;\n  writeHistoryRaw?: HistoryRawWriter;\n}): Promise<void> {\n  const writeHistoryRaw = params.writeHistoryRaw ?? writeFileAtomic;\n  try {\n    await writeHistoryRaw(params.historyPath, params.nextHistoryRaw);\n  } catch (error) {\n    try {\n      if (params.historyRawUnderLock === null) {\n        await fs.rm(params.historyPath, { force: true });\n      } else {\n        await writeHistoryRaw(params.historyPath, params.historyRawUnderLock);\n      }\n    } catch (rollbackError) {\n      throw new AggregateError(\n        [error, rollbackError],\n        `History rewrite failed and rollback also failed: ${String(error)}`,\n      );\n    }\n    throw error;\n  }\n}\n\n/** Shared lock/verify/ownership orchestration for history-rewrite commands. Callers provide the operation-specific write/rollback logic and optional post-write hook execution while this helper enforces the common governance + lock sequencing contract. */\nexport async function executeHistoryRewrite(\n  params: ExecuteHistoryRewriteParams,\n): Promise<string[]> {\n  const warnings = [\n    ...checkHistoryRewriteOwnership({\n      itemDocument: params.itemDocument,\n      subjectId: params.subject.id,\n      author: params.author,\n      force: params.force,\n      settings: params.settings,\n    }),\n  ];\n  const releaseLock = await acquireLock(\n    params.pmRoot,\n    params.subject.id,\n    params.settings.locks.ttl_seconds,\n    params.author,\n    Boolean(params.force),\n    params.settings.governance.force_required_for_stale_lock,\n    params.settings.locks.wait_ms,\n  );\n  try {\n    const verified = await verifyHistoryRewriteNoDrift({\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: params.operation,\n    });\n    await params.applyRewrite(verified);\n    if (params.applyPostRewrite) {\n      warnings.push(...(await params.applyPostRewrite(verified)));\n    }\n    return warnings;\n  } finally {\n    await releaseLock();\n  }\n}\n"],"names":["fs","fs"],"mappings":"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","debugId":"19224557-a97b-5405-9dc9-894cdbf821fc"}

package/dist/cli-bundle/chunks/{chunk-KB726FMH.js → chunk-H2Z3FYXQ.js}

@@ -2,7 +2,7 @@ import {
   clearFocusedItem,
   getFocusedItem,
   setFocusedItem
-} from "./chunk-IAPHYPRL.js";
+} from "./chunk-RMLWNPH2.js";
 import {
   buildItemNotFoundError,
   getActiveExtensionRegistrations,
@@ -10,7 +10,7 @@ import {
   normalizeItemId,
   readLocatedItem,
   readSettings
-} from "./chunk-T4BRCB6Z.js";
+} from "./chunk-XSJUSQAE.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -18,7 +18,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-AFWZRL7M.js";
+} from "./chunk-BSEQUTQP.js";
 
 // dist/cli/commands/focus.js
 !(function() {
@@ -101,4 +101,4 @@ function nonEmptyTitleOrNull(title) {
 export {
   runFocus
 };
-//# sourceMappingURL=chunk-KB726FMH.js.map
+//# sourceMappingURL=chunk-H2Z3FYXQ.js.map

package/dist/cli-bundle/chunks/chunk-H3EIEWGR.js

@@ -0,0 +1,162 @@
+
+!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]="0e94a766-6f3b-59e0-83b2-987c167effd6")}catch(e){}}();
+import {
+  DEFAULT_EXTENSION_PRIORITY,
+  EXIT_CODE,
+  PmCliError,
+  isCanonicalPathWithinDirectory,
+  isPathWithinDirectory,
+  pathExists
+} from "./chunk-QKECXBBG.js";
+
+// dist/sdk/command-line.js
+var quoteWindowsCommandArg = (arg) => {
+  let escaped = '"';
+  let pendingBackslashes = 0;
+  for (const character of arg) {
+    if (character === "\\") {
+      pendingBackslashes += 1;
+      continue;
+    }
+    escaped += "\\".repeat(character === '"' ? pendingBackslashes * 2 + 1 : pendingBackslashes);
+    escaped += character;
+    pendingBackslashes = 0;
+  }
+  return `${escaped}${"\\".repeat(pendingBackslashes * 2)}"`;
+};
+var quoteCommandArg = (arg, platform = process.platform) => {
+  const safePattern = platform === "win32" ? /^[A-Za-z0-9._:/\\@=-]+$/ : /^[A-Za-z0-9._:/@=-]+$/;
+  if (safePattern.test(arg)) {
+    return arg;
+  }
+  if (platform === "win32") {
+    return quoteWindowsCommandArg(arg);
+  }
+  return `"${arg.replace(/(["\\$`])/g, "\\$1")}"`;
+};
+var renderPmCommand = (argv, platform = process.platform) => {
+  const args = argv.map((token) => quoteCommandArg(token, platform)).join(" ");
+  return args.length > 0 ? `pm ${args}` : "pm";
+};
+
+// dist/sdk/extension/shared.js
+import fs from "node:fs/promises";
+import path from "node:path";
+function normalizeStringList(values) {
+  return [
+    ...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))
+  ].sort((left, right) => left.localeCompare(right));
+}
+function normalizeExtensionNameForMatch(value) {
+  return value.trim().toLowerCase();
+}
+function normalizeManagedDirectoryName(name) {
+  const normalized = name.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
+  let start = 0;
+  while (normalized[start] === "-") {
+    start += 1;
+  }
+  let end = normalized.length;
+  while (end > start && normalized[end - 1] === "-") {
+    end -= 1;
+  }
+  const directoryName = normalized.slice(start, end);
+  if (directoryName.length === 0) {
+    throw new PmCliError("Extension manifest name must resolve to a non-empty directory name.", EXIT_CODE.USAGE);
+  }
+  if (directoryName === "." || directoryName === "..") {
+    throw new PmCliError('Extension manifest name must not resolve to "." or "..".', EXIT_CODE.USAGE);
+  }
+  return directoryName;
+}
+function parseOptionalManifestPriority(value) {
+  if (value === void 0 || value === null) {
+    return DEFAULT_EXTENSION_PRIORITY;
+  }
+  return typeof value === "number" && Number.isInteger(value) ? value : null;
+}
+function parseOptionalManifestCapabilities(value) {
+  if (value === void 0 || value === null) {
+    return [];
+  }
+  if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
+    return null;
+  }
+  return normalizeStringList(value.map((entry) => String(entry).toLowerCase()));
+}
+function parseExtensionManifest(raw) {
+  if (typeof raw !== "object" || raw === null) {
+    return null;
+  }
+  const candidate = raw;
+  if (typeof candidate.name !== "string" || candidate.name.trim().length === 0) {
+    return null;
+  }
+  if (typeof candidate.version !== "string" || candidate.version.trim().length === 0) {
+    return null;
+  }
+  if (typeof candidate.entry !== "string" || candidate.entry.trim().length === 0) {
+    return null;
+  }
+  const priority = parseOptionalManifestPriority(candidate.priority);
+  const capabilities = parseOptionalManifestCapabilities(candidate.capabilities);
+  if (priority === null || capabilities === null) {
+    return null;
+  }
+  return {
+    name: candidate.name.trim(),
+    version: candidate.version.trim(),
+    entry: candidate.entry.trim(),
+    priority,
+    capabilities
+  };
+}
+async function validateExtensionDirectory(directory) {
+  const manifestPath = path.join(directory, "manifest.json");
+  if (!await pathExists(manifestPath)) {
+    throw new PmCliError(`Extension manifest is missing at "${manifestPath}".`, EXIT_CODE.USAGE);
+  }
+  let parsedManifest;
+  try {
+    parsedManifest = JSON.parse(await fs.readFile(manifestPath, "utf8"));
+  } catch (error) {
+    throw new PmCliError(`Failed to parse extension manifest at "${manifestPath}": ${formatManifestReadError(error)}`, EXIT_CODE.USAGE);
+  }
+  const manifest = parseExtensionManifest(parsedManifest);
+  if (!manifest) {
+    throw new PmCliError(`Extension manifest at "${manifestPath}" is invalid.`, EXIT_CODE.USAGE);
+  }
+  const entryPath = path.resolve(directory, manifest.entry);
+  if (!isPathWithinDirectory(directory, entryPath)) {
+    throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory "${directory}".`, EXIT_CODE.USAGE);
+  }
+  if (!await pathExists(entryPath)) {
+    throw new PmCliError(`Extension entry file is missing at "${entryPath}".`, EXIT_CODE.USAGE);
+  }
+  if (!await isCanonicalPathWithinDirectory(directory, entryPath)) {
+    throw new PmCliError(`Extension entry "${manifest.entry}" resolves outside extension directory after symlink resolution.`, EXIT_CODE.USAGE);
+  }
+  return {
+    directory,
+    manifest_path: manifestPath,
+    entry_path: entryPath,
+    manifest
+  };
+}
+function formatManifestReadError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export {
+  quoteWindowsCommandArg,
+  quoteCommandArg,
+  renderPmCommand,
+  normalizeStringList,
+  normalizeExtensionNameForMatch,
+  normalizeManagedDirectoryName,
+  parseExtensionManifest,
+  validateExtensionDirectory
+};
+//# sourceMappingURL=chunk-H3EIEWGR.js.map
+
+//# debugId=0e94a766-6f3b-59e0-83b2-987c167effd6

package/dist/cli-bundle/chunks/chunk-H3EIEWGR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../sdk/command-line.ts","../../../../../../../../sdk/extension/shared.ts"],"sourcesContent":["/**\n * @module sdk/command-line\n *\n * Renders copy-safe pm command suggestions for SDK and CLI diagnostics.\n */\n\n/** Quote one Windows argument with the linear CommandLineToArgvW escaping algorithm. */\nexport const quoteWindowsCommandArg = (arg: string): string => {\n  let escaped = '\"';\n  let pendingBackslashes = 0;\n  for (const character of arg) {\n    if (character === \"\\\\\") {\n      pendingBackslashes += 1;\n      continue;\n    }\n    escaped += \"\\\\\".repeat(\n      character === '\"' ? pendingBackslashes * 2 + 1 : pendingBackslashes,\n    );\n    escaped += character;\n    pendingBackslashes = 0;\n  }\n  return `${escaped}${\"\\\\\".repeat(pendingBackslashes * 2)}\"`;\n};\n\n/** Quote one command argument only when platform shell-significant characters require it. */\nexport const quoteCommandArg = (\n  arg: string,\n  platform: NodeJS.Platform = process.platform,\n): string => {\n  const safePattern =\n    platform === \"win32\" ? /^[A-Za-z0-9._:/\\\\@=-]+$/ : /^[A-Za-z0-9._:/@=-]+$/;\n  if (safePattern.test(arg)) {\n    return arg;\n  }\n  if (platform === \"win32\") {\n    return quoteWindowsCommandArg(arg);\n  }\n  return `\"${arg.replace(/([\"\\\\$`])/g, \"\\\\$1\")}\"`;\n};\n\n/** Render a complete pm command from already-tokenized arguments. */\nexport const renderPmCommand = (\n  argv: string[],\n  platform: NodeJS.Platform = process.platform,\n): string => {\n  const args = argv.map((token) => quoteCommandArg(token, platform)).join(\" \");\n  return args.length > 0 ? `pm ${args}` : \"pm\";\n};\n","/**\n * @module sdk/extension/shared\n *\n * Implements extension package-management support for Shared.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  DEFAULT_EXTENSION_PRIORITY,\n  isCanonicalPathWithinDirectory,\n  type ExtensionManifest,\n} from \"../../core/extensions/loader.js\";\n\nexport { DEFAULT_EXTENSION_PRIORITY, isCanonicalPathWithinDirectory };\n\n/** Documents the validated extension directory payload exchanged by command, SDK, and package integrations. */\nexport interface ValidatedExtensionDirectory {\n  /** Value that configures or reports directory for this contract. */\n  directory: string;\n  /** Filesystem path used for manifest resolution. */\n  manifest_path: string;\n  /** Filesystem path used for entry resolution. */\n  entry_path: string;\n  /** Declarative package manifest consumed by the extension loader. */\n  manifest: ExtensionManifest;\n}\n\n/** Implements normalize string list for the public runtime surface of this module. */\nexport function normalizeStringList(values: readonly string[]): string[] {\n  return [\n    ...new Set(\n      values.map((value) => value.trim()).filter((value) => value.length > 0),\n    ),\n  ].sort((left, right) => left.localeCompare(right));\n}\n\n/** Implements normalize extension name for match for the public runtime surface of this module. */\nexport function normalizeExtensionNameForMatch(value: string): string {\n  return value.trim().toLowerCase();\n}\n\n/** Implements normalize managed directory name for the public runtime surface of this module. */\nexport function normalizeManagedDirectoryName(name: string): string {\n  const normalized = name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/g, \"-\");\n  let start = 0;\n  while (normalized[start] === \"-\") {\n    start += 1;\n  }\n  let end = normalized.length;\n  while (end > start && normalized[end - 1] === \"-\") {\n    end -= 1;\n  }\n  const directoryName = normalized.slice(start, end);\n  if (directoryName.length === 0) {\n    throw new PmCliError(\n      \"Extension manifest name must resolve to a non-empty directory name.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (directoryName === \".\" || directoryName === \"..\") {\n    // Manifest-controlled input must resolve to a dedicated child directory, never\n    // the extensions root itself or its parent (path-traversal guard).\n    throw new PmCliError(\n      'Extension manifest name must not resolve to \".\" or \"..\".',\n      EXIT_CODE.USAGE,\n    );\n  }\n  return directoryName;\n}\n\nfunction parseOptionalManifestPriority(value: unknown): number | null {\n  if (value === undefined || value === null) {\n    return DEFAULT_EXTENSION_PRIORITY;\n  }\n  return typeof value === \"number\" && Number.isInteger(value) ? value : null;\n}\n\nfunction parseOptionalManifestCapabilities(value: unknown): string[] | null {\n  if (value === undefined || value === null) {\n    return [];\n  }\n  if (\n    !Array.isArray(value) ||\n    value.some((entry) => typeof entry !== \"string\")\n  ) {\n    return null;\n  }\n  return normalizeStringList(value.map((entry) => String(entry).toLowerCase()));\n}\n\n/** Implements parse extension manifest for the public runtime surface of this module. */\nexport function parseExtensionManifest(raw: unknown): ExtensionManifest | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (\n    typeof candidate.name !== \"string\" ||\n    candidate.name.trim().length === 0\n  ) {\n    return null;\n  }\n  if (\n    typeof candidate.version !== \"string\" ||\n    candidate.version.trim().length === 0\n  ) {\n    return null;\n  }\n  if (\n    typeof candidate.entry !== \"string\" ||\n    candidate.entry.trim().length === 0\n  ) {\n    return null;\n  }\n\n  const priority = parseOptionalManifestPriority(candidate.priority);\n  const capabilities = parseOptionalManifestCapabilities(\n    candidate.capabilities,\n  );\n  if (priority === null || capabilities === null) {\n    return null;\n  }\n\n  return {\n    name: candidate.name.trim(),\n    version: candidate.version.trim(),\n    entry: candidate.entry.trim(),\n    priority,\n    capabilities,\n  };\n}\n\n/** Implements validate extension directory for the public runtime surface of this module. */\nexport async function validateExtensionDirectory(\n  directory: string,\n): Promise<ValidatedExtensionDirectory> {\n  const manifestPath = path.join(directory, \"manifest.json\");\n  if (!(await pathExists(manifestPath))) {\n    throw new PmCliError(\n      `Extension manifest is missing at \"${manifestPath}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let parsedManifest: unknown;\n  try {\n    parsedManifest = JSON.parse(\n      await fs.readFile(manifestPath, \"utf8\"),\n    ) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Failed to parse extension manifest at \"${manifestPath}\": ${formatManifestReadError(error)}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const manifest = parseExtensionManifest(parsedManifest);\n  if (!manifest) {\n    throw new PmCliError(\n      `Extension manifest at \"${manifestPath}\" is invalid.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const entryPath = path.resolve(directory, manifest.entry);\n  if (!isPathWithinDirectory(directory, entryPath)) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory \"${directory}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!(await pathExists(entryPath))) {\n    throw new PmCliError(\n      `Extension entry file is missing at \"${entryPath}\".`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!(await isCanonicalPathWithinDirectory(directory, entryPath))) {\n    throw new PmCliError(\n      `Extension entry \"${manifest.entry}\" resolves outside extension directory after symlink resolution.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return {\n    directory,\n    manifest_path: manifestPath,\n    entry_path: entryPath,\n    manifest,\n  };\n}\n\nfunction formatManifestReadError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Public contract for test only extension shared, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyExtensionShared = {\n  formatManifestReadError,\n};\n"],"names":[],"mappings":"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","debugId":"0e94a766-6f3b-59e0-83b2-987c167effd6"}

package/dist/cli-bundle/chunks/{chunk-2QIQGYPW.js → chunk-H5APFTHZ.js}

@@ -9,7 +9,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-AFWZRL7M.js";
+} from "./chunk-BSEQUTQP.js";
 
 // dist/sdk/cli-contracts/commander-types.js
 !(function() {
@@ -1349,7 +1349,7 @@ function isPmExtensionPolicySurfaceContract(value) {
 !(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] = "8ab6e4b1-0fd0-548c-902e-a9908a8fe21a");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "737c225c-aa32-5277-b169-faedbb057f39");
   } catch (e2) {
   }
 })();
@@ -1690,7 +1690,11 @@ var TOOL_DEPS_OPTION_CONTRACTS = [
   { param: "format", flag: "--format" },
   { param: "maxDepth", flag: "--max-depth" },
   { param: "collapse", flag: "--collapse" },
-  { param: "summary", flag: "--summary" }
+  { param: "summary", flag: "--summary" },
+  { param: "nodeLimit", flag: "--node-limit" },
+  { param: "edgeLimit", flag: "--edge-limit" },
+  { param: "tokenBudget", flag: "--token-budget" },
+  { param: "cursor", flag: "--cursor" }
 ];
 
 // dist/sdk/cli-contracts/string-lists.js
@@ -1711,7 +1715,7 @@ function normalizeUniqueStringList(values) {
 !(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] = "e9f582fa-4daa-55e7-8019-d302301d54cd");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "cb1e2010-bf9f-5eb9-a77d-70e31f5463ac");
   } catch (e2) {
   }
 })();
@@ -1771,7 +1775,8 @@ var SUBCOMMAND_GLOBAL_FLAG_CONTRACTS = [
   { flag: "--no-extensions" },
   { flag: "--no-pager" },
   { flag: "--profile" },
-  { flag: "--help" }
+  { flag: "--help" },
+  { flag: "--author", value_name: "id" }
 ];
 var GLOBAL_FLAG_CONTRACTS = [
   ...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,
@@ -2077,6 +2082,7 @@ var PLAN_FLAG_CONTRACTS = [
   { flag: "--force" }
 ];
 var INIT_FLAG_CONTRACTS = [
+  { flag: "--id-prefix", aliases: ["--prefix"] },
   { flag: "--preset" },
   { flag: "--type-preset" },
   { flag: "--defaults", short: "-y", aliases: ["--yes"] },
@@ -2841,6 +2847,7 @@ var GET_FLAG_CONTRACTS = [
   { flag: "--depth" },
   { flag: "--full" },
   { flag: "--fields", list: true },
+  { flag: "--at" },
   { flag: "--tree" },
   { flag: "--tree-depth" },
   { flag: "--tree_depth" },
@@ -3080,7 +3087,7 @@ function toCompletionFlagString(flagContracts, includeGlobal = true) {
 !(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] = "34ee8cba-071e-5277-bc8b-c3dd2c1600e8");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "ced0a4db-9b0d-50c6-9de1-1d08dcf39c93");
   } catch (e2) {
   }
 })();
@@ -3422,6 +3429,10 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
     }
   },
   maxDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
+  nodeLimit: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
+  edgeLimit: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
+  tokenBudget: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
+  cursor: { type: "string" },
   collapse: { type: "string", enum: ["none", "repeated"] },
   shell: { type: "string", enum: ["bash", "zsh", "fish"] },
   stdin: { type: "boolean" },
@@ -4302,6 +4313,21 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "Maximum dependency traversal depth for deps action (0 keeps only the root node).",
     examples: [0, 1, "2"]
   },
+  nodeLimit: {
+    description: "Maximum related nodes returned by deps --format context.",
+    examples: [10, "20"]
+  },
+  edgeLimit: {
+    description: "Maximum related edges returned by deps --format context.",
+    examples: [20, "40"]
+  },
+  tokenBudget: {
+    description: "Maximum estimated output tokens for deps --format context.",
+    examples: [600, "1200"]
+  },
+  cursor: {
+    description: "Opaque continuation cursor returned by deps --format context."
+  },
   collapse: {
     description: 'Dependency tree collapse mode for deps action ("none" or "repeated").',
     examples: ["none", "repeated"]
@@ -4378,7 +4404,7 @@ var PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
 !(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] = "0da07ad9-bb86-5626-8c6e-f1d67cd3a988");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "15ef6d3d-a3e4-50ab-a3d8-ac9cfa57c110");
   } catch (e2) {
   }
 })();
@@ -4966,7 +4992,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   },
   deps: {
     required: ["id"],
-    optional: ["format", "maxDepth", "collapse", "summary"]
+    optional: ["format", "maxDepth", "collapse", "summary", "nodeLimit", "edgeLimit", "tokenBudget", "cursor"]
   },
   test: {
     required: ["id"],
@@ -5372,16 +5398,33 @@ function buildProviderCompatibleToolSchema() {
 }
 var PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderCompatibleToolSchema);
 
+// dist/sdk/cli-contracts/command-aliases.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] = "e5081784-d3d0-5fd3-9f6a-294a621995ef");
+  } catch (e2) {
+  }
+})();
+var EXECUTABLE_COMMAND_ALIASES = {
+  show: "get",
+  view: "get",
+  comment: "comments",
+  note: "notes",
+  learning: "learnings"
+};
+
 // dist/sdk/cli-contracts.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] = "d945b6b1-da70-5142-a422-e20888faafaa");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "03628345-205e-5ae0-9a16-1f47628ea7af");
   } catch (e2) {
   }
 })();
 
 export {
+  EXECUTABLE_COMMAND_ALIASES,
   LIST_COMMANDER_STRING_OPTION_CONTRACTS,
   SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,
   CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,
@@ -5507,4 +5550,4 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-2QIQGYPW.js.map
+//# sourceMappingURL=chunk-H5APFTHZ.js.map