@unbrained/pm-cli 2026.7.5 → 2026.7.7

package/dist/cli-bundle/chunks/{chunk-WISPVC2E.js.map → chunk-D2DCTFTL.js.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/linked-artifacts.ts"],
   "sourcesContent": ["/**\n * @module cli/commands/linked-artifacts\n *\n * Implements the pm linked artifacts command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport {\n  assertNoUnknownCsvKeys,\n  createStdinTokenResolver,\n  looksLikeGenericKeyValueEntry,\n  parseCsvKv,\n} from \"../../core/item/parse.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { isRemoteLinkedArtifactReference } from \"../../core/validate/linked-artifact-reference.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 { splitCommaList } from \"../../core/shared/split-comma-list.js\";\nimport { listAllFrontMatter, locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { SCOPE_VALUES } from \"../../types/index.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { LinkScope } from \"../../types/index.js\";\n\n/**\n * Restricts linked artifact values accepted by command, SDK, and storage contracts.\n */\nexport type LinkedArtifact = {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n};\n\n/** Allowed CSV/markdown keys for each structured linked-artifact option (GH-258). */\nexport const LINKED_ARTIFACT_ADD_KEYS = [\"path\", \"scope\", \"note\"] as const;\nexport const LINKED_ARTIFACT_ADD_GLOB_KEYS = [\"pattern\", \"glob\", \"path\", \"scope\", \"note\"] as const;\nexport const LINKED_ARTIFACT_REMOVE_KEYS = [\"path\"] as const;\nexport const LINKED_ARTIFACT_MIGRATE_KEYS = [\"from\", \"to\"] as const;\n/**\n * Keys that are valid on --add but meaningless on --remove (GH-277). Rejected\n * with audit-trail guidance (--message) rather than the generic unknown-key\n * error so agents are not left believing a removal note was recorded.\n */\nconst LINKED_ARTIFACT_REMOVE_UNSUPPORTED_KEYS: ReadonlySet<string> = new Set([\"note\", \"scope\"]);\n\n/**\n * Documents the linked artifact command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedArtifactCommandOptions {\n  add?: string[];\n  addGlob?: string[];\n  remove?: string[];\n  migrate?: string[];\n  /**\n   * GH-170 (pm-pfnx): standalone note applied to every link added by --add /\n   * --add-glob in the same invocation. A per-entry embedded note (the\n   * `path=...,note=...` pair syntax) takes precedence over this flag.\n   * Requires at least one --add/--add-glob; rejected otherwise.\n   */\n  note?: string;\n  list?: boolean;\n  appendStable?: boolean;\n  validatePaths?: boolean;\n  audit?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the path migration payload exchanged by command, SDK, and package integrations.\n */\nexport interface PathMigration {\n  from: string;\n  to: string;\n}\n\n/**\n * Documents the add glob entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface AddGlobEntry {\n  pattern: string;\n  scope: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the linked path validation payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedPathValidation {\n  checked: number;\n  existing_files: string[];\n  missing_paths: string[];\n  non_file_paths: string[];\n  /**\n   * Remote references (https:// URLs and other `scheme://` paths) recorded as\n   * links — most often a PR/issue/design-doc URL added via `pm docs --add`.\n   * These are not local files, so they bypass the existence probe and are\n   * reported here rather than counted as missing.\n   */\n  remote_references: string[];\n}\n\n/**\n * Documents the linked path audit entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedPathAuditEntry {\n  path: string;\n  linked_by_count: number;\n  linked_item_ids: string[];\n}\n\n/**\n * Documents the linked artifact result payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedArtifactResult {\n  id: string;\n  changed: boolean;\n  count: number;\n  migrations_applied?: number;\n  validation?: LinkedPathValidation;\n  audit?: LinkedPathAuditEntry[];\n  artifacts: LinkedArtifact[];\n}\n\n/**\n * Configuration that adapts the shared linked-artifact command core to a\n * specific resource kind (files or docs) while preserving every behavioral\n * detail of the original twin implementations.\n */\nexport interface LinkedArtifactKindConfig {\n  /** Metadata key under which the artifacts are stored (e.g. \"files\" | \"docs\"). */\n  metadataKey: \"files\" | \"docs\";\n  /** Mutation op recorded in history (e.g. \"files_add\" | \"docs_add\"). */\n  op: \"files_add\" | \"docs_add\";\n  /** Noun used in the \"bare <noun> path\" --add usage error (e.g. \"file\" | \"doc\"). */\n  bareNoun: \"file\" | \"doc\";\n  /**\n   * Whether this kind honors the append-stable option. files supports it;\n   * docs always sorts and must never expose append-stable behavior.\n   */\n  supportsAppendStable: boolean;\n}\n\n/**\n * Implements ensure scope for the public runtime surface of this module.\n */\nexport function ensureScope(raw: string | undefined): LinkScope {\n  const value = (raw ?? \"project\") as LinkScope;\n  if (!SCOPE_VALUES.includes(value)) {\n    throw new PmCliError(\n      `Invalid scope \"${raw}\". Valid scopes: ${SCOPE_VALUES.join(\", \")} (default: project).`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\n/**\n * Implements looks like structured path entry for the public runtime surface of this module.\n */\nexport function looksLikeStructuredPathEntry(raw: string): boolean {\n  if (raw.startsWith(\"```\") || raw.includes(\"\\n\")) {\n    return true;\n  }\n  if (/^(?:[-*+]\\s+)?(?:path|scope|note)\\s*[:=]/i.test(raw)) {\n    return true;\n  }\n  // A first-key typo (e.g. `lable=main,path=…`) must still be parsed so the\n  // unknown key is rejected rather than swallowed as a bare path (GH-258).\n  return looksLikeGenericKeyValueEntry(raw);\n}\n\nfunction expandBareCommaSeparatedAddEntries(raw: string[]): string[] {\n  return raw.flatMap((entry) => {\n    const trimmed = entry.trim();\n    if (trimmed.length === 0 || looksLikeStructuredPathEntry(trimmed) || !trimmed.includes(\",\")) {\n      return [entry];\n    }\n    return splitCommaList(trimmed);\n  });\n}\n\n/**\n * Implements parse add entries for the public runtime surface of this module.\n */\nexport function parseAddEntries(raw: string[] | undefined, bareNoun: \"file\" | \"doc\"): LinkedArtifact[] {\n  if (!raw) return [];\n  return expandBareCommaSeparatedAddEntries(raw).map((entry) => {\n    const trimmed = entry.trim();\n    const kv = looksLikeStructuredPathEntry(trimmed) ? parseCsvKv(entry, \"--add\") : { path: trimmed };\n    assertNoUnknownCsvKeys(kv, \"--add\", LINKED_ARTIFACT_ADD_KEYS);\n    if (!kv.path) {\n      throw new PmCliError(`--add requires path=<value> or a bare ${bareNoun} path`, EXIT_CODE.USAGE);\n    }\n    return {\n      path: kv.path,\n      scope: ensureScope(kv.scope),\n      note: kv.note?.trim() || undefined,\n    };\n  });\n}\n\n/**\n * Implements parse add glob entries for the public runtime surface of this module.\n */\nexport function parseAddGlobEntries(raw: string[] | undefined): AddGlobEntry[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const trimmed = entry.trim();\n    if (!trimmed) {\n      throw new PmCliError(\"--add-glob requires a glob pattern value\", EXIT_CODE.USAGE);\n    }\n    if (trimmed.includes(\"=\") || /^(?:[-*+]\\s+)?(?:pattern|glob|path)\\s*[:=]/i.test(trimmed) || trimmed.startsWith(\"```\")) {\n      const kv = parseCsvKv(trimmed, \"--add-glob\");\n      assertNoUnknownCsvKeys(kv, \"--add-glob\", LINKED_ARTIFACT_ADD_GLOB_KEYS);\n      const pattern = kv.pattern?.trim() || kv.glob?.trim() || kv.path?.trim();\n      if (!pattern) {\n        throw new PmCliError(\"--add-glob key/value form requires pattern=<glob>\", EXIT_CODE.USAGE);\n      }\n      return {\n        pattern,\n        scope: ensureScope(kv.scope),\n        note: kv.note?.trim() || undefined,\n      };\n    }\n    return {\n      pattern: trimmed,\n      scope: \"project\",\n    };\n  });\n}\n\n/**\n * Implements parse remove entries for the public runtime surface of this module.\n */\nexport function parseRemoveEntries(raw: string[] | undefined): string[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const trimmed = entry.trim();\n    if (!trimmed) {\n      throw new PmCliError(\"--remove requires a path value\", EXIT_CODE.USAGE);\n    }\n    if (trimmed.includes(\"=\") || /^(?:[-*+]\\s+)?path\\s*[:=]/i.test(trimmed) || trimmed.startsWith(\"```\")) {\n      const kv = parseCsvKv(trimmed, \"--remove\");\n      // GH-277: --remove identifies an existing link by path only; it does not\n      // attach per-link metadata. Reject the --add-only keys with guidance toward\n      // the audit-trail path (--message) rather than the generic \"unrecognized\n      // key\" error, which left agents believing they had recorded a removal note.\n      const unsupportedRemoveKeys = Object.keys(kv).filter((key) =>\n        LINKED_ARTIFACT_REMOVE_UNSUPPORTED_KEYS.has(key.toLowerCase()),\n      );\n      if (unsupportedRemoveKeys.length > 0) {\n        throw new PmCliError(\n          `--remove identifies a linked artifact by path only and does not accept ${unsupportedRemoveKeys\n            .map((key) => `\"${key}\"`)\n            .join(\", \")}. Pass just the path (path=<value>, path:<value>, or a bare path); record removal context with --message \"<why removed>\".`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      assertNoUnknownCsvKeys(kv, \"--remove\", LINKED_ARTIFACT_REMOVE_KEYS);\n      if (!kv.path) {\n        throw new PmCliError(\"--remove key/value form requires path=<value>\", EXIT_CODE.USAGE);\n      }\n      return kv.path;\n    }\n    return trimmed;\n  });\n}\n\n/**\n * Implements parse migrate entries for the public runtime surface of this module.\n */\nexport function parseMigrateEntries(raw: string[] | undefined): PathMigration[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const kv = parseCsvKv(entry, \"--migrate\");\n    assertNoUnknownCsvKeys(kv, \"--migrate\", LINKED_ARTIFACT_MIGRATE_KEYS);\n    const from = kv.from?.trim();\n    const to = kv.to?.trim();\n    if (!from || !to) {\n      throw new PmCliError(\"--migrate requires from=<value> and to=<value>\", EXIT_CODE.USAGE);\n    }\n    return { from, to };\n  });\n}\n\n/**\n * Implements apply path migrations for the public runtime surface of this module.\n */\nexport function applyPathMigrations(artifactPath: string, migrations: PathMigration[]): string {\n  let next = artifactPath;\n  for (const migration of migrations) {\n    if (next.startsWith(migration.from)) {\n      next = `${migration.to}${next.slice(migration.from.length)}`;\n    }\n  }\n  return next;\n}\n\n/**\n * Implements normalize linked path for the public runtime surface of this module.\n */\nexport function normalizeLinkedPath(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\n/**\n * Implements expand add glob entries for the public runtime surface of this module.\n */\nexport async function expandAddGlobEntries(entries: AddGlobEntry[]): Promise<LinkedArtifact[]> {\n  const expanded: LinkedArtifact[] = [];\n  for (const entry of entries) {\n    const absolutePattern = path.isAbsolute(entry.pattern);\n    const matches = await fg(entry.pattern, {\n      cwd: process.cwd(),\n      absolute: absolutePattern,\n      onlyFiles: true,\n      dot: true,\n      unique: true,\n      followSymbolicLinks: true,\n    });\n    const sortedMatches = [...new Set(matches.map((match) => normalizeLinkedPath(path.normalize(match))))].sort((left, right) =>\n      left.localeCompare(right),\n    );\n    for (const matchedPath of sortedMatches) {\n      expanded.push({\n        path: matchedPath,\n        scope: entry.scope,\n        note: entry.note,\n      });\n    }\n  }\n  return expanded;\n}\n\n/**\n * GH-170 (pm-pfnx): apply a standalone --note to the links added in this\n * invocation. Semantics (documented on pm-pfnx): the note is attached to EVERY\n * entry added via --add/--add-glob so a single flag annotates the whole batch\n * predictably; a per-entry embedded `note=` wins over the standalone flag; and\n * --note without any --add/--add-glob flag is a usage error because there is\n * nothing to annotate (it never retro-edits existing links). `hasAddFlags`\n * reflects flag presence, not match count, so a glob that legitimately matches\n * zero files is not an error.\n */\nexport function applyStandaloneNote(\n  adds: LinkedArtifact[],\n  note: string | undefined,\n  hasAddFlags: boolean,\n): LinkedArtifact[] {\n  if (note === undefined) {\n    return adds;\n  }\n  if (!hasAddFlags) {\n    throw new PmCliError(\n      \"--note requires --add or --add-glob in the same invocation (the note annotates the links being added)\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  const trimmed = note.trim();\n  if (trimmed.length === 0) {\n    return adds;\n  }\n  return adds.map((entry) => (entry.note === undefined ? { ...entry, note: trimmed } : entry));\n}\n\n/**\n * Implements artifact key for the public runtime surface of this module.\n */\nexport function artifactKey(value: Pick<LinkedArtifact, \"path\" | \"scope\">): string {\n  return `${value.path}::${value.scope}`;\n}\n\n/**\n * Implements sort linked artifacts for the public runtime surface of this module.\n */\nexport function sortLinkedArtifacts(artifacts: LinkedArtifact[]): LinkedArtifact[] {\n  return [...artifacts].sort((left, right) => {\n    const byPath = left.path.localeCompare(right.path);\n    if (byPath !== 0) return byPath;\n    return left.scope.localeCompare(right.scope);\n  });\n}\n\n/**\n * Implements dedupe linked artifacts for the public runtime surface of this module.\n */\nexport function dedupeLinkedArtifacts(artifacts: LinkedArtifact[]): LinkedArtifact[] {\n  return [...new Map(artifacts.map((entry) => [artifactKey(entry), entry])).values()].map((entry) => ({\n    ...entry,\n    note: entry.note?.trim() || undefined,\n  }));\n}\n\n/**\n * Implements validate linked paths for the public runtime surface of this module.\n */\nexport async function validateLinkedPaths(paths: string[]): Promise<LinkedPathValidation> {\n  const uniquePaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));\n  const existingFiles: string[] = [];\n  const missingPaths: string[] = [];\n  const nonFilePaths: string[] = [];\n  const remoteReferences: string[] = [];\n  for (const relativePath of uniquePaths) {\n    // Remote references (https:// PR/issue/design-doc URLs) are not local\n    // files; report them separately (trimmed, to match buildFilesCheck's\n    // output shape) instead of probing a meaningless path.\n    if (isRemoteLinkedArtifactReference(relativePath)) {\n      remoteReferences.push(relativePath.trim());\n      continue;\n    }\n    const resolvedPath = path.isAbsolute(relativePath) ? relativePath : path.resolve(process.cwd(), relativePath);\n    try {\n      const stats = await fs.stat(resolvedPath);\n      if (stats.isFile()) {\n        existingFiles.push(relativePath);\n      } else {\n        nonFilePaths.push(relativePath);\n      }\n    } catch (error: unknown) {\n      if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === \"ENOENT\") {\n        missingPaths.push(relativePath);\n        continue;\n      }\n      nonFilePaths.push(relativePath);\n    }\n  }\n  return {\n    checked: uniquePaths.length,\n    existing_files: existingFiles,\n    missing_paths: missingPaths,\n    non_file_paths: nonFilePaths,\n    remote_references: remoteReferences,\n  };\n}\n\n/**\n * Implements build linked path audit for the public runtime surface of this module.\n */\nexport function buildLinkedPathAudit(\n  paths: string[],\n  allItems: Array<{ id: string; artifacts?: LinkedArtifact[] }>,\n): LinkedPathAuditEntry[] {\n  const index = new Map<string, Set<string>>();\n  for (const item of allItems) {\n    for (const linkedArtifact of item.artifacts ?? []) {\n      const seen = index.get(linkedArtifact.path) ?? new Set<string>();\n      seen.add(item.id);\n      index.set(linkedArtifact.path, seen);\n    }\n  }\n  return [...new Set(paths)]\n    .sort((left, right) => left.localeCompare(right))\n    .map((linkedPath) => {\n      const linkedIds = [...(index.get(linkedPath) ?? new Set<string>())].sort((left, right) => left.localeCompare(right));\n      return {\n        path: linkedPath,\n        linked_by_count: linkedIds.length,\n        linked_item_ids: linkedIds,\n      };\n    });\n}\n\n/**\n * Shared linked-artifact list/mutate command core used by runFiles and runDocs.\n * The kind config selects metadata key, op, bare-path noun, and whether\n * append-stable ordering is honored, preserving each twin's exact semantics.\n */\nexport async function runLinkedArtifacts(\n  id: string,\n  options: LinkedArtifactCommandOptions,\n  global: GlobalOptions,\n  config: LinkedArtifactKindConfig,\n): Promise<LinkedArtifactResult> {\n  const { metadataKey } = config;\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const resolvedAdds = await stdinResolver.resolveList(options.add, \"--add\");\n  const resolvedAddGlobs = await stdinResolver.resolveList(options.addGlob, \"--add-glob\");\n  const resolvedRemoves = await stdinResolver.resolveList(options.remove, \"--remove\");\n  const resolvedMigrations = await stdinResolver.resolveList(options.migrate, \"--migrate\");\n  const parsedAdds = parseAddEntries(resolvedAdds, config.bareNoun);\n  const addGlobs = parseAddGlobEntries(resolvedAddGlobs);\n  const expandedGlobAdds = await expandAddGlobEntries(addGlobs);\n  const adds = applyStandaloneNote(\n    [...parsedAdds, ...expandedGlobAdds],\n    options.note,\n    parsedAdds.length > 0 || addGlobs.length > 0,\n  );\n  const removes = parseRemoveEntries(resolvedRemoves);\n  const migrations = parseMigrateEntries(resolvedMigrations);\n  const shouldMutate = adds.length > 0 || removes.length > 0 || migrations.length > 0;\n\n  const collectAuditItems = async (): Promise<Array<{ id: string; artifacts?: LinkedArtifact[] }>> =>\n    (await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema)).map((entry) => ({\n      id: entry.id,\n      artifacts: (entry as Record<string, unknown>)[metadataKey] as LinkedArtifact[] | undefined,\n    }));\n\n  if (!shouldMutate) {\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n    }\n    const loaded = await readLocatedItem(located, { schema: settings.schema });\n    const artifacts = ((loaded.document.metadata as Record<string, unknown>)[metadataKey] as LinkedArtifact[] | undefined) ?? [];\n    return {\n      id: located.id,\n      artifacts,\n      changed: false,\n      count: artifacts.length,\n      validation: options.validatePaths ? await validateLinkedPaths(artifacts.map((entry) => entry.path)) : undefined,\n      audit: options.audit ? buildLinkedPathAudit(artifacts.map((entry) => entry.path), await collectAuditItems()) : undefined,\n    };\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: config.op,\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      const metadata = document.metadata as Record<string, unknown>;\n      const next = [...((metadata[metadataKey] as LinkedArtifact[] | undefined) ?? [])];\n      let migrationCount = 0;\n      if (migrations.length > 0) {\n        for (let index = 0; index < next.length; index += 1) {\n          const migratedPath = applyPathMigrations(next[index].path, migrations);\n          if (migratedPath !== next[index].path) {\n            next[index] = { ...next[index], path: migratedPath };\n            migrationCount += 1;\n          }\n        }\n      }\n      const migratedAdds = adds.map((entry) => {\n        const migratedPath = applyPathMigrations(entry.path, migrations);\n        if (migratedPath !== entry.path) {\n          migrationCount += 1;\n        }\n        return {\n          ...entry,\n          path: migratedPath,\n        };\n      });\n      const migratedRemoves = removes.map((entry) => applyPathMigrations(entry, migrations));\n      for (const add of migratedAdds) {\n        const exists = next.some((entry) => entry.path === add.path && entry.scope === add.scope);\n        if (!exists) {\n          next.push(add);\n        }\n      }\n      if (migratedRemoves.length > 0) {\n        for (let i = next.length - 1; i >= 0; i -= 1) {\n          if (migratedRemoves.includes(next[i].path)) {\n            next.splice(i, 1);\n          }\n        }\n      }\n      const deduped = dedupeLinkedArtifacts(next);\n      const normalized = config.supportsAppendStable && options.appendStable ? deduped : sortLinkedArtifacts(deduped);\n      if (normalized.length > 0) {\n        metadata[metadataKey] = normalized;\n      } else {\n        delete metadata[metadataKey];\n      }\n      return { changedFields: [metadataKey], warnings: migrationCount > 0 ? [`path_migrations_applied:${migrationCount}`] : [] };\n    },\n  });\n\n  const artifacts = ((result.item as Record<string, unknown>)[metadataKey] as LinkedArtifact[] | undefined) ?? [];\n  const migrationWarning = result.warnings.find((warning) => warning.startsWith(\"path_migrations_applied:\"));\n  const migrationCount = migrationWarning ? Number(migrationWarning.slice(\"path_migrations_applied:\".length)) : 0;\n  const allItems = options.audit ? await collectAuditItems() : [];\n  return {\n    id: result.item.id,\n    artifacts,\n    changed: true,\n    count: artifacts.length,\n    migrations_applied: migrationCount > 0 ? migrationCount : undefined,\n    validation: options.validatePaths ? await validateLinkedPaths(artifacts.map((entry) => entry.path)) : undefined,\n    audit: options.audit ? buildLinkedPathAudit(artifacts.map((entry) => entry.path), allItems) : undefined,\n  };\n}\n\n/**\n * Re-key the generic `artifacts` field to the resource-specific name (files/docs)\n * while preserving the original key order and presence so kind-specific result\n * shapes (and their deterministic JSON key ordering) stay byte-identical.\n */\nexport function renameArtifactsResultKey(result: LinkedArtifactResult, key: \"files\" | \"docs\"): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [field, value] of Object.entries(result)) {\n    out[field === \"artifacts\" ? key : field] = value;\n  }\n  return out;\n}\n"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["global", "artifacts", "migrationCount"]
 }

package/dist/cli-bundle/chunks/{append-CZGUZ45Q.js → chunk-DDDWVPID.js}

@@ -3,24 +3,19 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   createStdinTokenResolver
-} from "./chunk-T3ABIMGW.js";
+} from "./chunk-2TILG6F2.js";
 import {
+  PmCliError,
   mutateItem,
+  readSettings,
   toItemRecord
-} from "./chunk-3U3VEWK6.js";
-import "./chunk-EZFKWSC7.js";
-import "./chunk-DRBV5UC2.js";
-import {
-  PmCliError,
-  readSettings
-} from "./chunk-P5YORJRH.js";
-import "./chunk-7C2O74AE.js";
+} from "./chunk-YNCFP5AR.js";
 import {
   EXIT_CODE,
   getSettingsPath,
   pathExists,
   resolvePmRoot
-} from "./chunk-5VVUKE3U.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/cli/commands/append.js
 !(function() {
@@ -67,7 +62,8 @@ async function runAppend(id, options, global2) {
     changed_fields: result.changedFields
   };
 }
+
 export {
   runAppend
 };
-//# sourceMappingURL=append-CZGUZ45Q.js.map
+//# sourceMappingURL=chunk-DDDWVPID.js.map

package/dist/cli-bundle/chunks/{append-CZGUZ45Q.js.map → chunk-DDDWVPID.js.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/append.ts"],
   "sourcesContent": ["/**\n * @module cli/commands/append\n *\n * Implements the pm append command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\n/**\n * Documents the append command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface AppendCommandOptions {\n  body: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the append result payload exchanged by command, SDK, and package integrations.\n */\nexport interface AppendResult {\n  item: Record<string, unknown>;\n  appended: string;\n  changed_fields: string[];\n}\n\n\n/**\n * Implements run append for the public runtime surface of this module.\n */\nexport async function runAppend(id: string, options: AppendCommandOptions, global: GlobalOptions): Promise<AppendResult> {\n  if (options.body === undefined) {\n    throw new PmCliError(\"Missing required --body text\", EXIT_CODE.USAGE);\n  }\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.\n  const bodyInput = await stdinResolver.resolveValue(options.body, \"--body\");\n  const appended = (bodyInput as string).trim();\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"append\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (appended.length === 0) {\n        return { changedFields: [] };\n      }\n      const spacer = document.body.trim().length > 0 ? \"\\n\\n\" : \"\";\n      document.body = `${document.body.replace(/\\s+$/, \"\")}${spacer}${appended}\\n`;\n      return { changedFields: [\"body\"] };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    appended: appended.length > 0 ? appended : \"\",\n    changed_fields: result.changedFields,\n  };\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,eAAsB,UAAU,IAAY,SAA+BA,SAAqB;AAC9F,MAAI,QAAQ,SAAS,QAAW;AAC9B,UAAM,IAAI,WAAW,gCAAgC,UAAU,KAAK;EACtE;AACA,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AAEpE,QAAM,YAAY,MAAM,cAAc,aAAa,QAAQ,MAAM,QAAQ;AACzE,QAAM,WAAY,UAAqB,KAAI;AAE3C,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI;IACJ;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,UAAI,SAAS,WAAW,GAAG;AACzB,eAAO,EAAE,eAAe,CAAA,EAAE;MAC5B;AACA,YAAM,SAAS,SAAS,KAAK,KAAI,EAAG,SAAS,IAAI,SAAS;AAC1D,eAAS,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ;;AACxE,aAAO,EAAE,eAAe,CAAC,MAAM,EAAC;IAClC;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B,UAAU,SAAS,SAAS,IAAI,WAAW;IAC3C,gBAAgB,OAAO;;AAE3B;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,eAAsB,UAAU,IAAY,SAA+BA,SAAqB;AAC9F,MAAI,QAAQ,SAAS,QAAW;AAC9B,UAAM,IAAI,WAAW,gCAAgC,UAAU,KAAK;EACtE;AACA,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AAEpE,QAAM,YAAY,MAAM,cAAc,aAAa,QAAQ,MAAM,QAAQ;AACzE,QAAM,WAAY,UAAqB,KAAI;AAE3C,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI;IACJ;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,UAAI,SAAS,WAAW,GAAG;AACzB,eAAO,EAAE,eAAe,CAAA,EAAE;MAC5B;AACA,YAAM,SAAS,SAAS,KAAK,KAAI,EAAG,SAAS,IAAI,SAAS;AAC1D,eAAS,OAAO,GAAG,SAAS,KAAK,QAAQ,QAAQ,EAAE,CAAC,GAAG,MAAM,GAAG,QAAQ;;AACxE,aAAO,EAAE,eAAe,CAAC,MAAM,EAAC;IAClC;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B,UAAU,SAAS,SAAS,IAAI,WAAW;IAC3C,gBAAgB,OAAO;;AAE3B;",
   "names": ["global"]
 }

package/dist/cli-bundle/chunks/{learnings-2HTPZNGZ.js → chunk-DG6BSXZ7.js}

@@ -1,24 +1,16 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-5J2XPTAD.js";
-import "./chunk-WW4E2DC3.js";
+} from "./chunk-43SIHQND.js";
 import {
   createStdinTokenResolver
-} from "./chunk-T3ABIMGW.js";
-import "./chunk-EEY54JMF.js";
-import "./chunk-3U3VEWK6.js";
-import "./chunk-EZFKWSC7.js";
-import "./chunk-DRBV5UC2.js";
-import "./chunk-P5YORJRH.js";
-import "./chunk-7C2O74AE.js";
-import "./chunk-5VVUKE3U.js";
+} from "./chunk-2TILG6F2.js";
 
 // dist/cli/commands/learnings.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] = "a9ffadfd-9838-58fb-9e0b-83f80b07fd49");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b3090079-935c-5670-ad34-028d37b0bd8b");
   } catch (e2) {
   }
 })();
@@ -27,7 +19,7 @@ async function runLearnings(id, options, global2) {
   const addInput = options.add === void 0 ? void 0 : await stdinResolver.resolveValue(options.add, "--add");
   return runAnnotationCommand(id, options, global2, {
     // addInput is defined whenever options.add is defined (see resolveValue), so the cast is safe.
-    input: options.add === void 0 ? { mode: "list" } : { mode: "add", value: addInput, emptyFlag: "--add" },
+    input: options.add === void 0 ? { mode: "list" } : { mode: "add", value: addInput, rawValue: options.add, emptyFlag: "--add" },
     collectionKey: "learnings",
     op: "learning_add",
     parseText: (raw) => parseAnnotationTextInput(raw),
@@ -42,7 +34,8 @@ async function runLearnings(id, options, global2) {
     }
   });
 }
+
 export {
   runLearnings
 };
-//# sourceMappingURL=learnings-2HTPZNGZ.js.map
+//# sourceMappingURL=chunk-DG6BSXZ7.js.map

package/dist/cli-bundle/chunks/{learnings-2HTPZNGZ.js.map → chunk-DG6BSXZ7.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/learnings.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/learnings\n *\n * Implements the pm learnings command surface and its agent-facing runtime behavior.\n */\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { LogNote } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the learnings command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface LearningsCommandOptions {\n  add?: string;\n  limit?: string;\n  author?: string;\n  message?: string;\n  allowAuditLearning?: boolean;\n  allowAuditComment?: boolean;\n  force?: boolean;\n}\n\n/**\n * Documents the learnings result payload exchanged by command, SDK, and package integrations.\n */\nexport interface LearningsResult {\n  id: string;\n  learnings: LogNote[];\n  count: number;\n}\n\n/**\n * Implements run learnings for the public runtime surface of this module.\n */\nexport async function runLearnings(\n  id: string,\n  options: LearningsCommandOptions,\n  global: GlobalOptions,\n): Promise<LearningsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const addInput = options.add === undefined ? undefined : await stdinResolver.resolveValue(options.add, \"--add\");\n\n  return runAnnotationCommand<\"learnings\", LogNote>(id, options, global, {\n    // addInput is defined whenever options.add is defined (see resolveValue), so the cast is safe.\n    input: options.add === undefined ? { mode: \"list\" } : { mode: \"add\", value: addInput as string, emptyFlag: \"--add\" },\n    collectionKey: \"learnings\",\n    op: \"learning_add\",\n    parseText: (raw) => parseAnnotationTextInput(raw),\n    allowAuditBypass: Boolean(options.allowAuditLearning || options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only learning audits on another owner's item, prefer --allow-audit-learning (legacy alias: --allow-audit-comment) before considering --force.\",\n      examples: ['pm learnings pm-a1b2 --add \"audit learning\" --author \"reviewer\" --allow-audit-learning'],\n      nextSteps: [\n        \"Retry with --allow-audit-learning (or legacy --allow-audit-comment) for append-only learning audits that do not mutate item metadata beyond learnings.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAmCA,eAAsB,aACpB,IACA,SACAA,SAAqB;AAErB,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,WAAW,QAAQ,QAAQ,SAAY,SAAY,MAAM,cAAc,aAAa,QAAQ,KAAK,OAAO;AAE9G,SAAO,qBAA2C,IAAI,SAASA,SAAQ;;IAErE,OAAO,QAAQ,QAAQ,SAAY,EAAE,MAAM,OAAM,IAAK,EAAE,MAAM,OAAO,OAAO,UAAoB,WAAW,QAAO;IAClH,eAAe;IACf,IAAI;IACJ,WAAW,CAAC,QAAQ,yBAAyB,GAAG;IAChD,kBAAkB,QAAQ,QAAQ,sBAAsB,QAAQ,iBAAiB;IACjF,kBAAkB;MAChB,UACE;MACF,UAAU,CAAC,wFAAwF;MACnG,WAAW;QACT;QACA;;;GAGL;AACH;",
+  "sourcesContent": ["/**\n * @module cli/commands/learnings\n *\n * Implements the pm learnings command surface and its agent-facing runtime behavior.\n */\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { LogNote } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the learnings command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface LearningsCommandOptions {\n  add?: string;\n  limit?: string;\n  author?: string;\n  message?: string;\n  allowAuditLearning?: boolean;\n  allowAuditComment?: boolean;\n  force?: boolean;\n}\n\n/**\n * Documents the learnings result payload exchanged by command, SDK, and package integrations.\n */\nexport interface LearningsResult {\n  id: string;\n  learnings: LogNote[];\n  count: number;\n}\n\n/**\n * Implements run learnings for the public runtime surface of this module.\n */\nexport async function runLearnings(\n  id: string,\n  options: LearningsCommandOptions,\n  global: GlobalOptions,\n): Promise<LearningsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const addInput = options.add === undefined ? undefined : await stdinResolver.resolveValue(options.add, \"--add\");\n\n  return runAnnotationCommand<\"learnings\", LogNote>(id, options, global, {\n    // addInput is defined whenever options.add is defined (see resolveValue), so the cast is safe.\n    input: options.add === undefined\n      ? { mode: \"list\" }\n      : { mode: \"add\", value: addInput as string, rawValue: options.add, emptyFlag: \"--add\" },\n    collectionKey: \"learnings\",\n    op: \"learning_add\",\n    parseText: (raw) => parseAnnotationTextInput(raw),\n    allowAuditBypass: Boolean(options.allowAuditLearning || options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only learning audits on another owner's item, prefer --allow-audit-learning (legacy alias: --allow-audit-comment) before considering --force.\",\n      examples: ['pm learnings pm-a1b2 --add \"audit learning\" --author \"reviewer\" --allow-audit-learning'],\n      nextSteps: [\n        \"Retry with --allow-audit-learning (or legacy --allow-audit-comment) for append-only learning audits that do not mutate item metadata beyond learnings.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAmCA,eAAsB,aACpB,IACA,SACAA,SAAqB;AAErB,QAAM,gBAAgB,yBAAwB;AAC9C,QAAM,WAAW,QAAQ,QAAQ,SAAY,SAAY,MAAM,cAAc,aAAa,QAAQ,KAAK,OAAO;AAE9G,SAAO,qBAA2C,IAAI,SAASA,SAAQ;;IAErE,OAAO,QAAQ,QAAQ,SACnB,EAAE,MAAM,OAAM,IACd,EAAE,MAAM,OAAO,OAAO,UAAoB,UAAU,QAAQ,KAAK,WAAW,QAAO;IACvF,eAAe;IACf,IAAI;IACJ,WAAW,CAAC,QAAQ,yBAAyB,GAAG;IAChD,kBAAkB,QAAQ,QAAQ,sBAAsB,QAAQ,iBAAiB;IACjF,kBAAkB;MAChB,UACE;MACF,UAAU,CAAC,wFAAwF;MACnG,WAAW;QACT;QACA;;;GAGL;AACH;",
   "names": ["global"]
 }

package/dist/cli-bundle/chunks/{chunk-7WYXBPYQ.js → chunk-DR2V5OIV.js}

@@ -2,10 +2,10 @@
 !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]="cd15293c-3e04-5469-83ba-98eb60bd6b28")}catch(e){}}();
 import {
   PmCliError
-} from "./chunk-US3T3W5J.js";
+} from "./chunk-GH73UOSJ.js";
 import {
   EXIT_CODE
-} from "./chunk-YD5FML7K.js";
+} from "./chunk-UO7XAZK6.js";
 
 // dist/core/item/parse.js
 var STDIN_TOKEN = "-";
@@ -353,6 +353,6 @@ export {
   createStdinTokenResolver,
   parseOptionalNumber
 };
-//# sourceMappingURL=chunk-7WYXBPYQ.js.map
+//# sourceMappingURL=chunk-DR2V5OIV.js.map
 
 //# debugId=cd15293c-3e04-5469-83ba-98eb60bd6b28

package/dist/cli-bundle/chunks/{chunk-YQMMMONE.js → chunk-E3LWJUGF.js}

@@ -1,15 +1,13 @@
 import {
+  PmCliError,
   nowIso
-} from "./chunk-DRBV5UC2.js";
-import {
-  PmCliError
-} from "./chunk-P5YORJRH.js";
+} from "./chunk-YNCFP5AR.js";
 import {
   EXIT_CODE,
   pathExists,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-5VVUKE3U.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/core/checkpoint/mutation-checkpoint.js
 import { mkdir, readFile } from "node:fs/promises";
@@ -130,4 +128,4 @@ export {
   loadMutationCheckpoint,
   restoreCheckpointItems
 };
-//# sourceMappingURL=chunk-YQMMMONE.js.map
+//# sourceMappingURL=chunk-E3LWJUGF.js.map

package/dist/cli-bundle/chunks/{chunk-YQMMMONE.js.map → chunk-E3LWJUGF.js.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../../../../core/checkpoint/mutation-checkpoint.ts"],
   "sourcesContent": ["/**\n * @module core/checkpoint/mutation-checkpoint\n *\n * Provides mutation checkpoint primitives for reversible multi-item operations.\n */\nimport { mkdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { nowIso } from \"../shared/time.js\";\n\n// Shared checkpoint + rollback machinery for bulk-mutation commands\n// (`update-many`, `close-many`). Each command owns its own checkpoint payload\n// shape (the extra fields it records) but reuses the common id/path/validation\n// helpers and the restore loop so the durable rollback contract — capture each\n// matched item's pre-mutation updated_at, then restore-to-timestamp on\n// rollback — stays identical across commands and is not duplicated.\n\n/**\n * Documents the mutation checkpoint item payload exchanged by command, SDK, and package integrations.\n */\nexport interface MutationCheckpointItem {\n  id: string;\n  target_updated_at: string;\n}\n\n/**\n * Documents the loaded mutation checkpoint payload exchanged by command, SDK, and package integrations.\n */\nexport interface LoadedMutationCheckpoint {\n  /** The full on-disk record so callers can read their command-specific fields. */\n  record: Record<string, unknown>;\n  /** Validated item list (id + target_updated_at). */\n  items: MutationCheckpointItem[];\n  /** Absolute path the checkpoint was read from. */\n  path: string;\n  id: string;\n  created_at: string;\n  author: string;\n}\n\n/**\n * Documents the checkpoint rollback row payload exchanged by command, SDK, and package integrations.\n */\nexport interface CheckpointRollbackRow {\n  id: string;\n  status: \"restored\" | \"failed\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\n/**\n * Documents the checkpoint rollback result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CheckpointRollbackResult {\n  rows: CheckpointRollbackRow[];\n  restored_ids: string[];\n  failed_count: number;\n}\n\n/** Restore a single item to its captured pre-mutation timestamp. */\nexport type CheckpointRestoreFn = (\n  id: string,\n  targetUpdatedAt: string,\n) => Promise<{ changed_fields?: string[]; warnings?: string[] }>;\n\n/**\n * Implements normalize checkpoint id for the public runtime surface of this module.\n */\nexport function normalizeCheckpointId(raw: string): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    throw new PmCliError(\"--rollback requires a non-empty checkpoint ID\", EXIT_CODE.USAGE);\n  }\n  if (!/^[a-zA-Z0-9._-]+$/.test(trimmed)) {\n    throw new PmCliError(\"--rollback checkpoint ID must match [a-zA-Z0-9._-]+\", EXIT_CODE.USAGE);\n  }\n  return trimmed;\n}\n\n/**\n * Implements create checkpoint id for the public runtime surface of this module.\n */\nexport function createCheckpointId(prefix: string, nowValue: string): string {\n  const compactTimestamp = nowValue.replace(/[-:.TZ]/g, \"\").slice(0, 14);\n  const randomSuffix = Math.random().toString(36).slice(2, 8);\n  return `${prefix}-${compactTimestamp}-${randomSuffix}`;\n}\n\n/**\n * Implements checkpoint directory path for the public runtime surface of this module.\n */\nexport function checkpointDirectoryPath(pmRoot: string, subdir: string): string {\n  return path.join(pmRoot, \"checkpoints\", subdir);\n}\n\n/**\n * Implements checkpoint file path for the public runtime surface of this module.\n */\nexport function checkpointFilePath(pmRoot: string, subdir: string, checkpointId: string): string {\n  return path.join(checkpointDirectoryPath(pmRoot, subdir), `${checkpointId}.json`);\n}\n\n/**\n * Implements write mutation checkpoint for the public runtime surface of this module.\n */\nexport async function writeMutationCheckpoint(\n  pmRoot: string,\n  subdir: string,\n  checkpointId: string,\n  payload: unknown,\n): Promise<string> {\n  const checkpointDir = checkpointDirectoryPath(pmRoot, subdir);\n  await mkdir(checkpointDir, { recursive: true });\n  const filePath = checkpointFilePath(pmRoot, subdir, checkpointId);\n  await writeFileAtomic(filePath, `${JSON.stringify(payload, null, 2)}\\n`);\n  return filePath;\n}\n\nfunction parseCheckpointItems(record: Record<string, unknown>, checkpointId: string): MutationCheckpointItem[] {\n  if (!Array.isArray(record.items)) {\n    throw new PmCliError(`Checkpoint ${checkpointId} is missing items`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  return record.items.map((entry) => {\n    if (!entry || typeof entry !== \"object\") {\n      throw new PmCliError(`Checkpoint ${checkpointId} contains an invalid item entry`, EXIT_CODE.GENERIC_FAILURE);\n    }\n    const row = entry as Record<string, unknown>;\n    if (typeof row.id !== \"string\" || row.id.trim().length === 0) {\n      throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without ID`, EXIT_CODE.GENERIC_FAILURE);\n    }\n    if (typeof row.target_updated_at !== \"string\" || row.target_updated_at.trim().length === 0) {\n      throw new PmCliError(\n        `Checkpoint ${checkpointId} contains an item entry without target_updated_at`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    return { id: row.id.trim(), target_updated_at: row.target_updated_at.trim() };\n  });\n}\n\n/**\n * Implements load mutation checkpoint for the public runtime surface of this module.\n */\nexport async function loadMutationCheckpoint(\n  pmRoot: string,\n  subdir: string,\n  rawCheckpointId: string,\n  schemaVersion: number,\n): Promise<LoadedMutationCheckpoint> {\n  const normalizedId = normalizeCheckpointId(rawCheckpointId);\n  const filePath = checkpointFilePath(pmRoot, subdir, normalizedId);\n  if (!(await pathExists(filePath))) {\n    throw new PmCliError(`Checkpoint ${normalizedId} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  const raw = await readFile(filePath, \"utf8\");\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Checkpoint ${normalizedId} contains invalid JSON: ${toErrorMessage(error)}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  if (!parsed || typeof parsed !== \"object\") {\n    throw new PmCliError(`Checkpoint ${normalizedId} is invalid`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const record = parsed as Record<string, unknown>;\n  if (record.schema_version !== schemaVersion) {\n    throw new PmCliError(`Checkpoint ${normalizedId} has unsupported schema version`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const items = parseCheckpointItems(record, normalizedId);\n  return {\n    record,\n    items,\n    path: filePath,\n    id: typeof record.id === \"string\" ? record.id : normalizedId,\n    // Defensive recovery for malformed checkpoint metadata; normal writes\n    // always include these fields, so fallbacks keep rollback inspectable.\n    created_at: typeof record.created_at === \"string\" ? record.created_at : nowIso(),\n    author: typeof record.author === \"string\" ? record.author : \"unknown\",\n  };\n}\n\n/**\n * Restore every checkpointed item to its captured pre-mutation timestamp,\n * collecting per-item rows. A single item's failure is recorded and does not\n * abort the remaining restores.\n */\nexport async function restoreCheckpointItems(\n  items: MutationCheckpointItem[],\n  restore: CheckpointRestoreFn,\n): Promise<CheckpointRollbackResult> {\n  const rows: CheckpointRollbackRow[] = [];\n  const restoredIds: string[] = [];\n  for (const entry of items) {\n    try {\n      const restored = await restore(entry.id, entry.target_updated_at);\n      rows.push({\n        id: entry.id,\n        status: \"restored\",\n        changed_fields: restored.changed_fields,\n        warnings: restored.warnings,\n      });\n      restoredIds.push(entry.id);\n    } catch (error: unknown) {\n      rows.push({ id: entry.id, status: \"failed\", error: toErrorMessage(error) });\n    }\n  }\n  return {\n    rows,\n    restored_ids: restoredIds,\n    failed_count: rows.filter((row) => row.status === \"failed\").length,\n  };\n}\n"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/cli-bundle/chunks/{chunk-D3UCE7RW.js → chunk-E3YQFSFE.js}

@@ -1,18 +1,14 @@
 import {
+  canonicalDocument,
   hashDocument,
-  toItemRecord
-} from "./chunk-3U3VEWK6.js";
-import {
-  canonicalDocument
-} from "./chunk-EZFKWSC7.js";
-import {
   orderObject,
   sha256Hex,
-  stableStringify
-} from "./chunk-P5YORJRH.js";
+  stableStringify,
+  toItemRecord
+} from "./chunk-YNCFP5AR.js";
 import {
   FRONT_MATTER_KEY_ORDER
-} from "./chunk-5VVUKE3U.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/core/history/replay.js
 import jsonPatch from "fast-json-patch";
@@ -240,4 +236,4 @@ export {
   reanchorHistoryEntries,
   historyEntriesToRaw
 };
-//# sourceMappingURL=chunk-D3UCE7RW.js.map
+//# sourceMappingURL=chunk-E3YQFSFE.js.map

package/dist/cli-bundle/chunks/{chunk-D3UCE7RW.js.map → chunk-E3YQFSFE.js.map}

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../../../../core/history/replay.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 { FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\nimport { canonicalDocument } from \"../item/item-format.js\";\nimport { toItemRecord } from \"../item/item-record.js\";\nimport { orderObject, sha256Hex, stableStringify } from \"../shared/serialization.js\";\nimport { hashDocument } from \"./history.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument, ItemMetadata } 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  metadata: Record<string, unknown>;\n  body: string;\n}\n\nexport const EMPTY_REPLAY_DOCUMENT: ReplayDocument = {\n  metadata: {},\n  body: \"\",\n};\n\n/**\n * Implements clone empty replay document for the public runtime surface of this module.\n */\nexport function cloneEmptyReplayDocument(): ReplayDocument {\n  return structuredClone(EMPTY_REPLAY_DOCUMENT);\n}\n\n/**\n * Implements replay hash for the public runtime surface of this module.\n */\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(stableStringify({ replay_fallback: true, metadata: document.metadata, body: document.body }));\n  }\n}\n\n/**\n * Implements replay to item document for the public runtime surface of this module.\n */\nexport function replayToItemDocument(document: ReplayDocument): ItemDocument {\n  return {\n    metadata: document.metadata as ItemMetadata,\n    body: document.body,\n  };\n}\n\n/**\n * Converts a materialized replay document into a canonical item document. Use\n * this when callers have already rejected the empty/deleted replay state and\n * need restored metadata validated through the normal front-matter rules.\n */\nexport function replayToCanonicalItemDocument(\n  document: ReplayDocument,\n  options: Parameters<typeof canonicalDocument>[1] = {},\n): ItemDocument {\n  return canonicalDocument(replayToItemDocument(document), options);\n}\n\n/**\n * Canonicalize an item document into the ordered replay form used when comparing\n * a replayed chain against the on-disk item (restore + history-repair reconciliation).\n */\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(toItemRecord(canonical.metadata), FRONT_MATTER_KEY_ORDER),\n    body: canonical.body,\n  };\n}\n\n/**\n * Implements normalize replay patch path for the public runtime surface of this module.\n */\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/**\n * Implements normalize replay patch ops for the public runtime surface of this module.\n */\nexport function normalizeReplayPatchOps(patch: HistoryPatchOp[] | unknown): 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: typeof operation.from === \"string\" ? normalizeReplayPatchPath(operation.from) : undefined,\n  }));\n}\n\nfunction isReplayDocumentShape(value: unknown): 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/**\n * Restricts replay apply result values accepted by command, SDK, and storage contracts.\n */\nexport type ReplayApplyResult =\n  | { ok: true; document: ReplayDocument }\n  | { ok: false; error: unknown };\n\n/**\n * Strictly apply a history patch (front_matter->metadata normalized) to a replay\n * document. Returns a result envelope rather than throwing so each caller can\n * format its own error contract.\n */\nexport function tryApplyReplayPatch(current: ReplayDocument, patch: HistoryPatchOp[]): 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 { ok: false, error: new Error(\"history_replay_invalid_document_shape\") };\n    }\n    return { ok: true, document: { metadata: applied.metadata, body: applied.body } };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/**\n * Deterministically verify a history chain: each entry's before_hash must equal\n * the prior replayed after_hash, the patch must strictly apply, and the recorded\n * after_hash must equal the replayed result.\n */\nexport function verifyHistoryChain(entries: HistoryEntry[]): { ok: boolean; errors: string[] } {\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/**\n * Documents the lenient apply result payload exchanged by command, SDK, and package integrations.\n */\nexport interface LenientApplyResult {\n  document: ReplayDocument;\n  convertedReplaceToAdd: number;\n  skippedOps: number;\n}\n\nfunction tryApplySingleOp(document: unknown, op: HistoryPatchOp): { 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/**\n * Apply a legacy patch op-by-op, recovering from drift that strict replay rejects:\n * a `replace` whose path no longer exists is retried as `add`, and any op that\n * still cannot apply against the current replay state is skipped. The resulting\n * document is what the repaired entry's recomputed patch should target.\n */\nexport function lenientApplyReplayPatch(current: ReplayDocument, patch: HistoryPatchOp[]): 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/**\n * Documents the reanchor entry detail payload exchanged by command, SDK, and package integrations.\n */\nexport interface ReanchorEntryDetail {\n  index: number;\n  rehashed: boolean;\n  patch_repaired: boolean;\n  converted_replace_to_add: number;\n  skipped_ops: number;\n}\n\n/**\n * Documents the reanchor result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ReanchorResult {\n  entries: HistoryEntry[];\n  finalDocument: ReplayDocument;\n  entriesRehashed: number;\n  entriesPatchRepaired: number;\n  convertedReplaceToAdd: number;\n  skippedOps: number;\n  details: ReanchorEntryDetail[];\n}\n\n/**\n * Re-anchor a drifted history chain: replay every entry from empty, recompute the\n * before/after hashes, and only rewrite a patch when the original op set no longer\n * strictly applies (legacy drift). Clean entries keep their patch verbatim so the\n * on-disk diff stays minimal. The returned chain verifies via verifyHistoryChain.\n */\nexport function reanchorHistoryEntries(entries: HistoryEntry[]): 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 = 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/**\n * Implements history entries to raw for the public runtime surface of this module.\n */\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"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/cli-bundle/chunks/{chunk-PDXT6Q55.js → chunk-EDO7VXSO.js}

@@ -3,7 +3,7 @@
 import {
   getRuntimePath,
   writeFileAtomic
-} from "./chunk-YD5FML7K.js";
+} from "./chunk-UO7XAZK6.js";
 
 // dist/core/session/session-state.js
 import { promises as fs } from "node:fs";
@@ -53,6 +53,6 @@ export {
   setFocusedItem,
   clearFocusedItem
 };
-//# sourceMappingURL=chunk-PDXT6Q55.js.map
+//# sourceMappingURL=chunk-EDO7VXSO.js.map
 
 //# debugId=c63f67f8-15be-5ba4-9853-406782c70ecb

package/dist/cli-bundle/chunks/{chunk-FDBARR33.js → chunk-EIUBK2LT.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-3Y4OESPP.js";
+} from "./chunk-M62RO3XK.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   historyEntriesToRaw,
@@ -11,29 +11,23 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-D3UCE7RW.js";
+} from "./chunk-E3YQFSFE.js";
 import {
+  PmCliError,
   acquireLock,
+  canonicalDocument,
   createHistoryEntry,
+  getActiveExtensionRegistrations,
   locateItem,
-  readLocatedItem
-} from "./chunk-3U3VEWK6.js";
-import {
-  canonicalDocument,
   normalizeItemId,
   normalizeRawItemId,
-  serializeItemDocument
-} from "./chunk-EZFKWSC7.js";
-import {
-  nowIso
-} from "./chunk-DRBV5UC2.js";
-import {
-  PmCliError,
-  getActiveExtensionRegistrations,
+  nowIso,
+  readLocatedItem,
   readSettings,
   resolveGovernanceKnobs,
-  runActiveOnWriteHooks
-} from "./chunk-P5YORJRH.js";
+  runActiveOnWriteHooks,
+  serializeItemDocument
+} from "./chunk-YNCFP5AR.js";
 import {
   EXIT_CODE,
   getHistoryPath,
@@ -44,7 +38,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   writeFileAtomic
-} from "./chunk-5VVUKE3U.js";
+} from "./chunk-LCFJ7XAM.js";
 
 // dist/cli/commands/history-redact.js
 import fs2 from "node:fs/promises";
@@ -652,4 +646,4 @@ export {
   runHistoryRedact,
   _testOnly
 };
-//# sourceMappingURL=chunk-FDBARR33.js.map
+//# sourceMappingURL=chunk-EIUBK2LT.js.map