@unbrained/pm-cli 2026.7.4 → 2026.7.5

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

@@ -0,0 +1,150 @@
+
+!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]="b7da1375-1527-5871-9f84-948595aee48f")}catch(e){}}();
+import {
+  collectUsedExtensionCapabilities,
+  normalizeExtensionName
+} from "./chunk-YD5FML7K.js";
+
+// dist/core/extensions/activation-summary.js
+var HOOK_REGISTRY_FIELD_TO_KIND = [
+  ["beforeCommand", "before_command"],
+  ["afterCommand", "after_command"],
+  ["onWrite", "on_write"],
+  ["onRead", "on_read"],
+  ["onIndex", "on_index"]
+];
+function describeExtensionActivation(activation, options = {}) {
+  const filters = /* @__PURE__ */ new Set();
+  if (options.extensionName !== void 0) {
+    filters.add(normalizeExtensionName(options.extensionName));
+  }
+  for (const name of options.extensionNames ?? []) {
+    filters.add(normalizeExtensionName(name));
+  }
+  const matches = (name) => filters.size === 0 || filters.has(normalizeExtensionName(name));
+  const collect = (entries, identify) => sortUnique(entries.filter((entry) => matches(entry.name)).map(identify));
+  const collectFlat = (entries, expand) => sortUnique(entries.filter((entry) => matches(entry.name)).flatMap(expand));
+  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;
+  return {
+    capabilities: collectUsedExtensionCapabilities(activation, options),
+    commands: collect(registrations.commands, (entry) => entry.command),
+    command_overrides: collect(commands.overrides, (entry) => entry.command),
+    command_handlers: collect(commands.handlers, (entry) => entry.command),
+    hooks: HOOK_REGISTRY_FIELD_TO_KIND.filter(([field]) => hooks[field].some((entry) => matches(entry.name))).map(([, kind]) => kind),
+    flag_commands: collect(registrations.flags, (entry) => entry.target_command),
+    item_types: collectFlat(registrations.item_types, (entry) => entry.types.map((type) => type.name)),
+    item_fields: collectFlat(registrations.item_fields, (entry) => entry.fields.map((field) => field.name)),
+    migrations: collectFlat(registrations.migrations, (entry) => typeof entry.definition.id === "string" ? [entry.definition.id] : []),
+    profiles: collect(registrations.profiles, (entry) => entry.profile.name),
+    importers: collect(registrations.importers, (entry) => entry.importer),
+    exporters: collect(registrations.exporters, (entry) => entry.exporter),
+    search_providers: collect(registrations.search_providers, (entry) => entry.definition.name),
+    vector_store_adapters: collect(registrations.vector_store_adapters, (entry) => entry.definition.name),
+    parser_overrides: collect(parsers.overrides, (entry) => entry.command),
+    service_overrides: collect(services.overrides, (entry) => entry.service),
+    renderer_overrides: collect(renderers.overrides, (entry) => entry.format),
+    preflight_overrides: preflight.overrides.filter((entry) => matches(entry.name)).length
+  };
+}
+function sortUnique(values) {
+  return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+
+// dist/core/extensions/activation-summary-markdown.js
+var MIN_HEADING_LEVEL = 1;
+var MAX_HEADING_LEVEL = 6;
+var SURFACE_SECTIONS = [
+  ["commands", "Commands"],
+  ["command_overrides", "Command overrides"],
+  ["flag_commands", "Flag commands"],
+  ["item_types", "Item types"],
+  ["item_fields", "Item fields"],
+  ["migrations", "Migrations"],
+  ["profiles", "Profiles"],
+  ["importers", "Importers"],
+  ["exporters", "Exporters"],
+  ["search_providers", "Search providers"],
+  ["vector_store_adapters", "Vector store adapters"],
+  ["hooks", "Lifecycle hooks"],
+  ["parser_overrides", "Parser overrides"],
+  ["service_overrides", "Service overrides"],
+  ["renderer_overrides", "Renderer overrides"]
+];
+function headingPrefix(level) {
+  return "#".repeat(level);
+}
+function code(value) {
+  if (!value.includes("`")) {
+    return `\`${value}\``;
+  }
+  let longestRun = 0;
+  let currentRun = 0;
+  for (const char of value) {
+    currentRun = char === "`" ? currentRun + 1 : 0;
+    longestRun = Math.max(longestRun, currentRun);
+  }
+  const fence = "`".repeat(longestRun + 1);
+  const pad = value.startsWith("`") || value.endsWith("`") ? " " : "";
+  return `${fence}${pad}${value}${pad}${fence}`;
+}
+function renderCapabilitiesLine(capabilities) {
+  if (capabilities.length === 0) {
+    return "Capabilities: _none registered_";
+  }
+  return `Capabilities: ${capabilities.map(code).join(", ")}`;
+}
+function renderSection(heading, level, entries) {
+  const lines = [`${headingPrefix(level)} ${heading}`, ""];
+  if (entries.length === 0) {
+    lines.push("_None._", "");
+    return lines;
+  }
+  lines.push(...entries.map((entry) => `- ${code(entry)}`), "");
+  return lines;
+}
+function renderPreflightSection(count, level, includeEmpty) {
+  if (count === 0 && !includeEmpty) {
+    return [];
+  }
+  return [
+    `${headingPrefix(level)} Preflight overrides`,
+    "",
+    count > 0 ? `- ${count} registered (this surface carries no per-entry identifier)` : "_None._",
+    ""
+  ];
+}
+function renderExtensionSurfaceMarkdown(summary, options = {}) {
+  const titleLevel = options.headingLevel ?? 2;
+  if (!Number.isInteger(titleLevel) || titleLevel < MIN_HEADING_LEVEL || titleLevel > MAX_HEADING_LEVEL) {
+    throw new RangeError(`headingLevel must be an integer in [${MIN_HEADING_LEVEL}, ${MAX_HEADING_LEVEL}], received ${String(options.headingLevel)}`);
+  }
+  const sectionLevel = Math.min(titleLevel + 1, MAX_HEADING_LEVEL);
+  const includeEmpty = options.includeEmpty === true;
+  const title = options.title ?? "Extension surfaces";
+  const lines = [`${headingPrefix(titleLevel)} ${title}`, ""];
+  if (includeEmpty || summary.capabilities.length > 0) {
+    lines.push(renderCapabilitiesLine(summary.capabilities), "");
+  }
+  for (const [field, heading] of SURFACE_SECTIONS) {
+    const entries = summary[field];
+    if (entries.length === 0 && !includeEmpty) {
+      continue;
+    }
+    lines.push(...renderSection(heading, sectionLevel, entries));
+  }
+  lines.push(...renderPreflightSection(summary.preflight_overrides, sectionLevel, includeEmpty));
+  const hasAnySurface = summary.preflight_overrides > 0 || SURFACE_SECTIONS.some(([field]) => summary[field].length > 0);
+  if (!hasAnySurface && !includeEmpty) {
+    lines.push("_This extension registers no surfaces._", "");
+  }
+  return `${lines.join("\n").trimEnd()}
+`;
+}
+
+export {
+  describeExtensionActivation,
+  renderExtensionSurfaceMarkdown
+};
+//# sourceMappingURL=chunk-AAEQMOC6.js.map
+
+//# debugId=b7da1375-1527-5871-9f84-948595aee48f

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/extensions/activation-summary.ts","../../../../../../../../core/extensions/activation-summary-markdown.ts"],"sourcesContent":["/**\n * @module core/extensions/activation-summary\n *\n * Enumerates *what* an extension activation registered, by name, in one pass.\n *\n * {@link ./extension-types.js#ExtensionActivationResult | `ExtensionActivationResult`}\n * already carries per-surface *counts* (`hook_counts`, `registration_counts`,\n * the various `*_count` fields), but answering \"what does this extension\n * register?\" otherwise means walking fifteen-plus sub-registries by hand\n * (`registrations.commands`/`flags`/`item_types`/`item_fields`/`migrations`/\n * `importers`/`exporters`/`search_providers`/`vector_store_adapters`,\n * `commands.overrides`/`handlers`, the `parsers`/`preflight`/`services`/\n * `renderers` override registries, and the five `hooks.*` arrays).\n *\n * {@link describeExtensionActivation} flattens all of them into one sorted,\n * deterministic {@link ExtensionActivationSummary} of identifiers — the\n * `describe` (enumerate-all) verb that complements the SDK's `assert*`\n * (verify-one) and `run*` (invoke-one) testing helpers. It serves two callers:\n *\n * - **Agents** get a single token-efficient view of an activation instead of\n *   traversing every registry (\"project management = context management\").\n * - **Package authors** can assert their *entire* registration surface in one\n *   `deepEqual` — a least-privilege \"I register exactly these surfaces and\n *   nothing more\" check, the positive counterpart to\n *   {@link ./capability-usage.js#reconcileExtensionCapabilityUsage}.\n */\nimport type {\n  ExtensionActivationResult,\n  ExtensionCapability,\n  ExtensionHookRegistry,\n  ExtensionServiceName,\n  OutputRendererFormat,\n} from \"./extension-types.js\";\nimport { collectUsedExtensionCapabilities, normalizeExtensionName } from \"./capability-usage.js\";\n\n/**\n * Canonical lifecycle hook kinds paired with their {@link ExtensionHookRegistry}\n * field, ordered to match `ExtensionActivationResult.hook_counts` so a summary's\n * `hooks` list reads in the same stable order the runtime reports counts in.\n */\nconst HOOK_REGISTRY_FIELD_TO_KIND = [\n  [\"beforeCommand\", \"before_command\"],\n  [\"afterCommand\", \"after_command\"],\n  [\"onWrite\", \"on_write\"],\n  [\"onRead\", \"on_read\"],\n  [\"onIndex\", \"on_index\"],\n] as const satisfies ReadonlyArray<readonly [keyof ExtensionHookRegistry, string]>;\n\n/**\n * Flat, name-level enumeration of every surface an activation registered.\n *\n * Arrays are de-duplicated for deterministic equality. Most are locale-sorted;\n * {@link ExtensionActivationSummary.hooks} is the exception — it is emitted in\n * canonical lifecycle order to mirror `ExtensionActivationResult.hook_counts`,\n * not alphabetically. The three command fields capture distinct dimensions and\n * can overlap: a command\n * registered via `api.registerCommand(definition)` appears in both\n * {@link ExtensionActivationSummary.commands} (its declared definition) and\n * {@link ExtensionActivationSummary.command_handlers} (its executable handler),\n * whereas a built-in command replaced via `api.registerCommand(name, override)`\n * appears only in {@link ExtensionActivationSummary.command_overrides}.\n */\nexport interface ExtensionActivationSummary {\n  /** Known capabilities the registered surfaces exercise (sorted, de-duplicated). */\n  capabilities: ExtensionCapability[];\n  /** Full command paths declared via `registerCommand`'s definition form. */\n  commands: string[];\n  /** Built-in command paths replaced by an `registerCommand(name, override)` handler. */\n  command_overrides: string[];\n  /**\n   * Full command paths backed by an extension-provided handler. A superset of\n   * {@link ExtensionActivationSummary.commands} that also includes the\n   * `<name> import`/`<name> export` paths synthesized for importers/exporters.\n   */\n  command_handlers: string[];\n  /** Lifecycle hook kinds with at least one registered hook (canonical order). */\n  hooks: string[];\n  /** Command paths that received extension-registered flags. */\n  flag_commands: string[];\n  /** Custom item-type names registered via `registerItemTypes`. */\n  item_types: string[];\n  /** Custom front-matter field names registered via `registerItemFields`. */\n  item_fields: string[];\n  /** Schema migration ids registered via `registerMigration` (id-less migrations are omitted — they carry no identifier). */\n  migrations: string[];\n  /** Project profile names registered via `registerProfile`. */\n  profiles: string[];\n  /** Importer names registered via `registerImporter`. */\n  importers: string[];\n  /** Exporter names registered via `registerExporter`. */\n  exporters: string[];\n  /** Search-provider names registered via `registerSearchProvider`. */\n  search_providers: string[];\n  /** Vector-store adapter names registered via `registerVectorStoreAdapter`. */\n  vector_store_adapters: string[];\n  /** Command paths with a parser override registered via `registerParser`. */\n  parser_overrides: string[];\n  /** Built-in service names overridden via `registerService`. */\n  service_overrides: ExtensionServiceName[];\n  /** Output formats with a renderer override registered via `registerRenderer`. */\n  renderer_overrides: OutputRendererFormat[];\n  /**\n   * Count of registered preflight overrides. The surface carries no per-entry\n   * identifier, so this is a `number` rather than `string[]` — the only numeric\n   * field in the summary.\n   */\n  preflight_overrides: number;\n}\n\n/**\n * Options for {@link describeExtensionActivation}.\n */\nexport interface DescribeExtensionActivationOptions {\n  /**\n   * Restrict the summary to a single extension by name. Names are matched\n   * case-insensitively after trimming, mirroring\n   * {@link ./capability-usage.js#collectUsedExtensionCapabilities}. Omit to\n   * union across every extension in the activation result.\n   */\n  extensionName?: string;\n  /**\n   * Restrict the summary to a set of extension names. This supports package\n   * aliases that resolve to multiple extensions while keeping the historical\n   * single-name option intact.\n   */\n  extensionNames?: readonly string[];\n}\n\n/**\n * Summarize, by name, every registration surface an activation exercised.\n *\n * Walks the same sub-registries the loader populates and the capability\n * reconciler attributes, returning a flat {@link ExtensionActivationSummary}\n * whose arrays are sorted and de-duplicated. With\n * {@link DescribeExtensionActivationOptions.extensionName} only the matching\n * extension's registrations contribute (across both layers); without it the\n * summary unions every extension in the activation. Failed activations register\n * nothing, so they contribute only an empty summary.\n */\nexport function describeExtensionActivation(\n  activation: ExtensionActivationResult,\n  options: DescribeExtensionActivationOptions = {},\n): ExtensionActivationSummary {\n  // Match both sides with the same normalizer collectUsedExtensionCapabilities\n  // uses for the `capabilities` field below, so a filtered summary's named\n  // surfaces and capabilities never disagree for a stored name with whitespace.\n  const filters = new Set<string>();\n  if (options.extensionName !== undefined) {\n    filters.add(normalizeExtensionName(options.extensionName));\n  }\n  for (const name of options.extensionNames ?? []) {\n    filters.add(normalizeExtensionName(name));\n  }\n  const matches = (name: string): boolean => filters.size === 0 || filters.has(normalizeExtensionName(name));\n  const collect = <TEntry extends { name: string }, TValue extends string>(\n    entries: readonly TEntry[],\n    identify: (entry: TEntry) => TValue,\n  ): TValue[] => sortUnique(entries.filter((entry) => matches(entry.name)).map(identify));\n  const collectFlat = <TEntry extends { name: string }>(\n    entries: readonly TEntry[],\n    expand: (entry: TEntry) => readonly string[],\n  ): string[] => sortUnique(entries.filter((entry) => matches(entry.name)).flatMap(expand));\n  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;\n  return {\n    capabilities: collectUsedExtensionCapabilities(activation, options),\n    commands: collect(registrations.commands, (entry) => entry.command),\n    command_overrides: collect(commands.overrides, (entry) => entry.command),\n    command_handlers: collect(commands.handlers, (entry) => entry.command),\n    hooks: HOOK_REGISTRY_FIELD_TO_KIND.filter(([field]) => hooks[field].some((entry) => matches(entry.name))).map(\n      ([, kind]) => kind,\n    ),\n    flag_commands: collect(registrations.flags, (entry) => entry.target_command),\n    item_types: collectFlat(registrations.item_types, (entry) => entry.types.map((type) => type.name)),\n    item_fields: collectFlat(registrations.item_fields, (entry) => entry.fields.map((field) => field.name)),\n    migrations: collectFlat(registrations.migrations, (entry) =>\n      typeof entry.definition.id === \"string\" ? [entry.definition.id] : [],\n    ),\n    profiles: collect(registrations.profiles, (entry) => entry.profile.name),\n    importers: collect(registrations.importers, (entry) => entry.importer),\n    exporters: collect(registrations.exporters, (entry) => entry.exporter),\n    search_providers: collect(registrations.search_providers, (entry) => entry.definition.name),\n    vector_store_adapters: collect(registrations.vector_store_adapters, (entry) => entry.definition.name),\n    parser_overrides: collect(parsers.overrides, (entry) => entry.command),\n    service_overrides: collect(services.overrides, (entry) => entry.service),\n    renderer_overrides: collect(renderers.overrides, (entry) => entry.format),\n    preflight_overrides: preflight.overrides.filter((entry) => matches(entry.name)).length,\n  };\n}\n\nfunction sortUnique<TValue extends string>(values: readonly TValue[]): TValue[] {\n  return [...new Set(values)].sort((left, right) => left.localeCompare(right));\n}\n","/**\n * @module core/extensions/activation-summary-markdown\n *\n * Renders an {@link ExtensionActivationSummary} to a deterministic Markdown\n * reference document — the *render* leg that completes the `describe`\n * (enumerate-all) verb.\n *\n * {@link ./activation-summary.js#describeExtensionActivation | `describeExtensionActivation`}\n * (and its author-time twin\n * {@link ../../sdk/compose.js#describeExtensionBlueprint | `describeExtensionBlueprint`})\n * already answer \"what does this package register?\" as a structured summary, and\n * the `assert*`/`run*` testing helpers verify and invoke each surface. What was\n * missing is a way to turn that summary into human-readable docs: package\n * authors hand-wrote the README \"commands & capabilities\" reference, which\n * silently drifted from the surface the loader actually registers.\n *\n * {@link renderExtensionSurfaceMarkdown} closes that gap. It is a pure,\n * dependency-free projection of the summary, so an author can pipe\n * `describeExtensionBlueprint(blueprint)` straight into it during their build or\n * test step and embed the result in their README — a reference that can never\n * drift from the registered surface (\"project management = context management\").\n * The CLI's `pm extension|package describe --markdown` composes the same\n * primitive across every loaded extension.\n */\nimport type { ExtensionActivationSummary } from \"./activation-summary.js\";\n\n/**\n * The lowest and highest ATX heading levels Markdown supports, used to validate\n * {@link ExtensionSurfaceMarkdownOptions.headingLevel} and to clamp nested\n * section headings so a deep title never emits an invalid `#######` run.\n */\nconst MIN_HEADING_LEVEL = 1;\nconst MAX_HEADING_LEVEL = 6;\n\n/**\n * Options for {@link renderExtensionSurfaceMarkdown}.\n */\nexport interface ExtensionSurfaceMarkdownOptions {\n  /**\n   * Heading text for the document title. Defaults to `\"Extension surfaces\"`.\n   * The title always renders as an ATX heading at\n   * {@link ExtensionSurfaceMarkdownOptions.headingLevel}; per-surface sections\n   * render one level deeper.\n   */\n  title?: string;\n  /**\n   * ATX heading level for the title, an integer in `[1, 6]` (default `2`, i.e.\n   * `##`, so the document embeds cleanly under a `# Package` README heading).\n   * Section headings render at `headingLevel + 1`, clamped to `6`. Values\n   * outside `[1, 6]` throw a {@link RangeError}.\n   */\n  headingLevel?: number;\n  /**\n   * When `true`, render every surface section even when it has no entries\n   * (emitting `_None._` under the heading) and always emit the capabilities\n   * line. Defaults to `false`, which omits empty sections so the reference lists\n   * only what the package actually contributes.\n   */\n  includeEmpty?: boolean;\n}\n\n/**\n * A surface section paired with the {@link ExtensionActivationSummary} field\n * whose identifiers populate it. Ordered for an author-facing reference:\n * commands first, then schema, then importers/exporters, retrieval, lifecycle\n * hooks, and finally the override surfaces. {@link ExtensionActivationSummary.command_handlers}\n * is intentionally omitted — it is a documented superset of `commands` plus the\n * synthesized `<name> import`/`<name> export` paths already covered by the\n * Importers and Exporters sections, so rendering it would duplicate information.\n */\nconst SURFACE_SECTIONS = [\n  [\"commands\", \"Commands\"],\n  [\"command_overrides\", \"Command overrides\"],\n  [\"flag_commands\", \"Flag commands\"],\n  [\"item_types\", \"Item types\"],\n  [\"item_fields\", \"Item fields\"],\n  [\"migrations\", \"Migrations\"],\n  [\"profiles\", \"Profiles\"],\n  [\"importers\", \"Importers\"],\n  [\"exporters\", \"Exporters\"],\n  [\"search_providers\", \"Search providers\"],\n  [\"vector_store_adapters\", \"Vector store adapters\"],\n  [\"hooks\", \"Lifecycle hooks\"],\n  [\"parser_overrides\", \"Parser overrides\"],\n  [\"service_overrides\", \"Service overrides\"],\n  [\"renderer_overrides\", \"Renderer overrides\"],\n] as const satisfies ReadonlyArray<\n  readonly [\n    {\n      [K in keyof ExtensionActivationSummary]: ExtensionActivationSummary[K] extends readonly string[] ? K : never;\n    }[keyof ExtensionActivationSummary],\n    string,\n  ]\n>;\n\n/**\n * Repeat `#` `level` times to form an ATX heading prefix.\n */\nfunction headingPrefix(level: number): string {\n  return \"#\".repeat(level);\n}\n\n/**\n * Render `value` as an inline Markdown code span. Backslash escapes do not work\n * inside CommonMark code spans, so when `value` contains backticks the span is\n * delimited by a run of backticks one longer than the longest internal run, and\n * padded with a space when the value borders a backtick — the CommonMark rule\n * for embedding literal backticks in a code span.\n */\nfunction code(value: string): string {\n  if (!value.includes(\"`\")) {\n    return `\\`${value}\\``;\n  }\n  let longestRun = 0;\n  let currentRun = 0;\n  for (const char of value) {\n    currentRun = char === \"`\" ? currentRun + 1 : 0;\n    longestRun = Math.max(longestRun, currentRun);\n  }\n  const fence = \"`\".repeat(longestRun + 1);\n  const pad = value.startsWith(\"`\") || value.endsWith(\"`\") ? \" \" : \"\";\n  return `${fence}${pad}${value}${pad}${fence}`;\n}\n\n/**\n * Render the comma-separated capabilities summary line (or `_none registered_`\n * when the activation exercised no known capability).\n */\nfunction renderCapabilitiesLine(capabilities: readonly string[]): string {\n  if (capabilities.length === 0) {\n    return \"Capabilities: _none registered_\";\n  }\n  return `Capabilities: ${capabilities.map(code).join(\", \")}`;\n}\n\n/**\n * Render one surface section as `heading` + a bullet per identifier, or, when\n * `entries` is empty, `heading` + `_None._`. Callers decide whether an empty\n * section is rendered at all via {@link ExtensionSurfaceMarkdownOptions.includeEmpty}.\n */\nfunction renderSection(heading: string, level: number, entries: readonly string[]): string[] {\n  const lines = [`${headingPrefix(level)} ${heading}`, \"\"];\n  if (entries.length === 0) {\n    lines.push(\"_None._\", \"\");\n    return lines;\n  }\n  lines.push(...entries.map((entry) => `- ${code(entry)}`), \"\");\n  return lines;\n}\n\n/**\n * Render the preflight-overrides section: a count line when any are registered,\n * `_None._` when {@link ExtensionSurfaceMarkdownOptions.includeEmpty} forces the\n * empty section, or no lines at all otherwise. Preflight overrides carry no\n * per-entry identifier, so they have a bespoke renderer rather than reusing\n * {@link renderSection}.\n */\nfunction renderPreflightSection(count: number, level: number, includeEmpty: boolean): string[] {\n  if (count === 0 && !includeEmpty) {\n    return [];\n  }\n  return [\n    `${headingPrefix(level)} Preflight overrides`,\n    \"\",\n    count > 0 ? `- ${count} registered (this surface carries no per-entry identifier)` : \"_None._\",\n    \"\",\n  ];\n}\n\n/**\n * Render an {@link ExtensionActivationSummary} as a deterministic Markdown\n * reference document.\n *\n * The output is a title heading, a one-line capabilities summary, and a section\n * per registered surface (commands, overrides, flags, item types/fields,\n * migrations, importers/exporters, search providers, vector adapters, lifecycle\n * hooks, and the parser/service/renderer override surfaces), followed by a\n * preflight-override count line when any are registered. Section order and\n * within-section identifier order both come straight from the summary, so the\n * same summary always renders byte-for-byte the same document.\n *\n * By default empty sections are omitted so the reference lists only what the\n * package contributes; set {@link ExtensionSurfaceMarkdownOptions.includeEmpty}\n * to render every section. A summary with no surfaces at all renders the title,\n * the capabilities line, and a `_This extension registers no surfaces._` note.\n *\n * @throws {RangeError} when `options.headingLevel` is not an integer in `[1, 6]`.\n */\nexport function renderExtensionSurfaceMarkdown(\n  summary: ExtensionActivationSummary,\n  options: ExtensionSurfaceMarkdownOptions = {},\n): string {\n  const titleLevel = options.headingLevel ?? 2;\n  if (!Number.isInteger(titleLevel) || titleLevel < MIN_HEADING_LEVEL || titleLevel > MAX_HEADING_LEVEL) {\n    throw new RangeError(\n      `headingLevel must be an integer in [${MIN_HEADING_LEVEL}, ${MAX_HEADING_LEVEL}], received ${String(options.headingLevel)}`,\n    );\n  }\n  const sectionLevel = Math.min(titleLevel + 1, MAX_HEADING_LEVEL);\n  const includeEmpty = options.includeEmpty === true;\n  const title = options.title ?? \"Extension surfaces\";\n\n  const lines = [`${headingPrefix(titleLevel)} ${title}`, \"\"];\n  if (includeEmpty || summary.capabilities.length > 0) {\n    lines.push(renderCapabilitiesLine(summary.capabilities), \"\");\n  }\n\n  for (const [field, heading] of SURFACE_SECTIONS) {\n    const entries = summary[field];\n    if (entries.length === 0 && !includeEmpty) {\n      continue;\n    }\n    lines.push(...renderSection(heading, sectionLevel, entries));\n  }\n\n  lines.push(...renderPreflightSection(summary.preflight_overrides, sectionLevel, includeEmpty));\n\n  const hasAnySurface =\n    summary.preflight_overrides > 0 || SURFACE_SECTIONS.some(([field]) => summary[field].length > 0);\n  if (!hasAnySurface && !includeEmpty) {\n    lines.push(\"_This extension registers no surfaces._\", \"\");\n  }\n\n  return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n"],"names":[],"mappings":"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","debugId":"b7da1375-1527-5871-9f84-948595aee48f"}

package/dist/cli-bundle/chunks/{chunk-CQISNF3Z.js → chunk-ABRA3BHY.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-EB4BBEZD.js";
+} from "./chunk-3Y4OESPP.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
@@ -11,41 +11,43 @@ import {
   replayToCanonicalItemDocument,
   replayToItemDocument,
   toReplayDocument
-} from "./chunk-HL742IBM.js";
+} from "./chunk-D3UCE7RW.js";
 import {
   acquireLock,
   appendHistoryEntry,
   createHistoryEntry,
   enforceHistoryStreamPolicyForItem,
   locateItem,
-  normalizeItemId,
-  normalizeRawItemId,
   readLocatedItem
-} from "./chunk-CN4OAA2G.js";
+} from "./chunk-3U3VEWK6.js";
 import {
   canonicalDocument,
+  normalizeItemId,
+  normalizeRawItemId,
   serializeItemDocument
-} from "./chunk-CQFZRLXQ.js";
+} from "./chunk-EZFKWSC7.js";
 import {
   nowIso
-} from "./chunk-MZG6I2Q2.js";
+} from "./chunk-DRBV5UC2.js";
 import {
-  EXIT_CODE,
   PmCliError,
   getActiveExtensionRegistrations,
+  projectAfterCommandItemSnapshot,
+  readSettings,
+  recordAfterCommandAffectedItem,
+  runActiveOnWriteHooks
+} from "./chunk-P5YORJRH.js";
+import {
+  EXIT_CODE,
   getHistoryPath,
   getItemPath,
   getSettingsPath,
   pathExists,
-  projectAfterCommandItemSnapshot,
   readFileIfExists,
-  readSettings,
-  recordAfterCommandAffectedItem,
   resolveItemTypeRegistry,
   resolvePmRoot,
-  runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-BDDYM4LH.js";
+} from "./chunk-5VVUKE3U.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -53,7 +55,7 @@ import fs from "node:fs/promises";
 !(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] = "fdb88d94-5eca-54ba-9e29-56a4bf0583af");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2be864e5-8a8d-5052-8aab-673ef91c2b0b");
   } catch (e2) {
   }
 })();
@@ -331,7 +333,7 @@ async function runRestore(id, target, options, global2) {
   const loadedItemBeforeLock = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;
   const currentItemRawBeforeLock = loadedItemBeforeLock?.raw ?? null;
   const author = resolveAuthor(options.author, settings.author_default);
-  const releaseLock = await acquireLock(pmRoot, resolvedId, settings.locks.ttl_seconds, author, Boolean(options.force), settings.governance.force_required_for_stale_lock);
+  const releaseLock = await acquireLock(pmRoot, resolvedId, settings.locks.ttl_seconds, author, Boolean(options.force), settings.governance.force_required_for_stale_lock, settings.locks.wait_ms);
   try {
     const { loadedItemUnderLock, existingItemPath } = await loadRestoreStateUnderLock({
       pmRoot,
@@ -424,4 +426,4 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-CQISNF3Z.js.map
+//# sourceMappingURL=chunk-ABRA3BHY.js.map

package/dist/cli-bundle/chunks/{chunk-CQISNF3Z.js.map → chunk-ABRA3BHY.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/restore.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/restore\n *\n * Implements the pm restore command surface and its agent-facing runtime behavior.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport fs from \"node:fs/promises\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { appendHistoryEntry, createHistoryEntry } from \"../../core/history/history.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  normalizeReplayPatchOps,\n  replayHash,\n  replayToCanonicalItemDocument,\n  replayToItemDocument,\n  toReplayDocument,\n  type ReplayDocument as CanonicalReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport { canonicalDocument, serializeItemDocument } from \"../../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { acquireLock } from \"../../core/lock/lock.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  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument, ItemMetadata } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\ninterface ResolvedRestoreTarget {\n  kind: \"version\" | \"timestamp\";\n  raw: string;\n  historyIndex: number;\n}\n\ninterface ResolvedRestoreSubject {\n  id: string;\n  historyPath: string;\n  located: Awaited<ReturnType<typeof locateItem>>;\n  historyPolicyWarnings: string[];\n}\n\ninterface RestoreCurrentState {\n  document: ItemDocument;\n  originalRaw: string | null;\n}\n\ninterface PatchFailureContext {\n  patchIndex?: number;\n  op?: string;\n  path?: string;\n  from?: string;\n  reason?: string;\n}\n\n/**\n * Documents the restore command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface RestoreCommandOptions {\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the restore result payload exchanged by command, SDK, and package integrations.\n */\nexport interface RestoreResult {\n  item: ItemMetadata;\n  restored_from: {\n    kind: \"version\" | \"timestamp\";\n    target: string;\n    history_index: number;\n    entry_ts: string;\n    entry_op: string;\n  };\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction ensureReplayTarget(target: string, history: HistoryEntry[]): ResolvedRestoreTarget {\n  const trimmed = target.trim();\n  if (!trimmed) {\n    throw new PmCliError(\"Missing restore target. Use a timestamp or version number.\", EXIT_CODE.USAGE);\n  }\n\n  if (/^\\d+$/.test(trimmed)) {\n    const version = Number(trimmed);\n    if (!Number.isSafeInteger(version) || version < 1 || version > history.length) {\n      throw new PmCliError(\n        `Restore version must be between 1 and ${history.length} for this item.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      kind: \"version\",\n      raw: trimmed,\n      historyIndex: version - 1,\n    };\n  }\n\n  const parsedTarget = Date.parse(trimmed);\n  if (!Number.isFinite(parsedTarget)) {\n    throw new PmCliError(\n      `Invalid restore target \"${target}\". Use a positive version number or ISO timestamp.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let index = -1;\n  for (let i = 0; i < history.length; i += 1) {\n    const entryTimestamp = Date.parse(history[i].ts);\n    if (!Number.isFinite(entryTimestamp)) {\n      throw new PmCliError(\n        `History for this item contains invalid timestamp at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (entryTimestamp <= parsedTarget) {\n      index = i;\n    }\n  }\n\n  if (index < 0) {\n    throw new PmCliError(`No history entries exist at or before timestamp ${trimmed}.`, EXIT_CODE.USAGE);\n  }\n\n  return {\n    kind: \"timestamp\",\n    raw: trimmed,\n    historyIndex: index,\n  };\n}\n\nfunction extractPatchFailureContext(\n  patch: HistoryPatchOp[],\n  error: unknown,\n): PatchFailureContext {\n  const context: PatchFailureContext = {};\n  if (error instanceof Error && error.message.trim().length > 0) {\n    context.reason = error.message.trim();\n  }\n  if (typeof error !== \"object\" || error === null) {\n    return context;\n  }\n  const candidate = error as {\n    index?: unknown;\n    operation?: unknown;\n  };\n  /* c8 ignore start -- parser-generated patch errors may omit index metadata in current fixtures. */\n  if (typeof candidate.index === \"number\" && Number.isInteger(candidate.index) && candidate.index >= 0) {\n    context.patchIndex = candidate.index;\n  }\n  /* c8 ignore stop */\n  /* c8 ignore start -- operation payload metadata is optional in upstream json-patch failures. */\n  const operationRecord =\n    typeof candidate.operation === \"object\" && candidate.operation !== null\n      ? (candidate.operation as { op?: unknown; path?: unknown; from?: unknown })\n      : null;\n  /* c8 ignore stop */\n  enrichPatchFailureContext(context, operationRecord, patch);\n  return context;\n}\n\nfunction enrichPatchFailureContext(\n  context: PatchFailureContext,\n  operationRecord: { op?: unknown; path?: unknown; from?: unknown } | null,\n  patch: HistoryPatchOp[],\n): void {\n  /* v8 ignore start -- operation replay records always carry a string op when present; this preserves context for malformed future rows */\n  if (operationRecord && typeof operationRecord.op === \"string\") {\n    context.op = operationRecord.op;\n  }\n  /* v8 ignore stop */\n  if (operationRecord && typeof operationRecord.path === \"string\") {\n    context.path = operationRecord.path;\n  }\n  if (operationRecord && typeof operationRecord.from === \"string\") {\n    context.from = operationRecord.from;\n  }\n  if ((context.op === undefined || context.path === undefined) && context.patchIndex !== undefined) {\n    const fallback = patch[context.patchIndex];\n    /* c8 ignore start -- fallback enrichment paths are only exercised by malformed patch telemetry payloads. */\n    if (fallback) {\n      context.op = context.op ?? fallback.op;\n      context.path = context.path ?? fallback.path;\n      context.from = context.from ?? fallback.from;\n    }\n    /* c8 ignore stop */\n  }\n}\n\nfunction applyHistoryPatch(\n  current: CanonicalReplayDocument,\n  patch: HistoryPatchOp[],\n  entryNumber: number,\n  entryOp: string,\n): CanonicalReplayDocument {\n  try {\n    const normalizedPatch = normalizeReplayPatchOps(patch);\n    const applied = jsonPatch.applyPatch(\n      structuredClone(current),\n      normalizedPatch as jsonPatch.Operation[],\n      true,\n      false,\n    ).newDocument as unknown;\n    if (\n      typeof applied !== \"object\" ||\n      applied === null ||\n      !(\"metadata\" in applied) ||\n      !(\"body\" in applied) ||\n      typeof (applied as { body: unknown }).body !== \"string\" ||\n      typeof (applied as { metadata: unknown }).metadata !== \"object\" ||\n      (applied as { metadata: unknown }).metadata === null\n    ) {\n      throw new PmCliError(\n        `History replay produced an invalid document shape at entry ${entryNumber}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    const replay = applied as { metadata: Record<string, unknown>; body: string };\n    return {\n      metadata: replay.metadata,\n      body: replay.body,\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    const failureContext = extractPatchFailureContext(patch, error);\n    const contextTokens = [\n      `history_op=${entryOp}`,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.patchIndex !== undefined ? `patch_index=${failureContext.patchIndex}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.op ? `op=${failureContext.op}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.path ? `path=${failureContext.path}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.from ? `from=${failureContext.from}` : null,\n    ].filter((token): token is string => token !== null);\n    /* c8 ignore start -- jsonPatch/structuredClone/normalizeReplayPatchOps always throw Error instances with non-empty messages here, so extractPatchFailureContext always sets reason; the empty-suffix fallback is unreachable through applyHistoryPatch. */\n    const reasonSuffix = failureContext.reason ? ` ${failureContext.reason}` : \"\";\n    /* c8 ignore stop */\n    throw new PmCliError(\n      `Failed to apply history patch at entry ${entryNumber} (${contextTokens.join(\", \")}).${reasonSuffix}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\nfunction replayToTarget(history: HistoryEntry[], targetIndex: number): CanonicalReplayDocument {\n  let document: CanonicalReplayDocument = structuredClone(EMPTY_REPLAY_DOCUMENT);\n\n  for (let i = 0; i <= targetIndex; i += 1) {\n    const entry = history[i];\n    const beforeHash = replayHash(document);\n    if (beforeHash !== entry.before_hash) {\n      throw new PmCliError(\n        `History hash mismatch before replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n\n    document = applyHistoryPatch(document, entry.patch, i + 1, entry.op);\n\n    const afterHash = replayHash(document);\n    if (afterHash !== entry.after_hash) {\n      throw new PmCliError(\n        `History hash mismatch after replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n\n  return document;\n}\n\nfunction ensureMaterializedRestoreTarget(\n  replayDocument: CanonicalReplayDocument,\n  target: ResolvedRestoreTarget,\n): CanonicalReplayDocument {\n  if (Object.keys(replayDocument.metadata).length > 0) {\n    return replayDocument;\n  }\n  throw new PmCliError(\n    `Restore target ${target.raw} resolves to a deleted state; choose a version or timestamp where the item exists.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction replayCurrentDocument(history: HistoryEntry[]): ItemDocument {\n  const currentReplay = replayToTarget(history, history.length - 1);\n  if (Object.keys(currentReplay.metadata).length === 0) {\n    return {\n      metadata: {} as ItemMetadata,\n      body: currentReplay.body,\n    };\n  }\n  return canonicalDocument(replayToItemDocument(currentReplay));\n}\n\nasync function resolveRestoreSubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<ResolvedRestoreSubject> {\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (located) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"restore\",\n    });\n    return {\n      id: located.id,\n      historyPath,\n      located,\n      historyPolicyWarnings: historyPolicy.warnings,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  /* c8 ignore start -- raw-id fallback is covered by normalize-item-id utility tests. */\n  const candidateIds = normalizedId === rawNormalizedId ? [normalizedId] : [normalizedId, rawNormalizedId];\n  /* c8 ignore stop */\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        historyPolicyWarnings: [],\n      };\n    }\n  }\n\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\nfunction changedFields(beforeDocument: ItemDocument, afterDocument: ItemDocument): string[] {\n  const beforeReplay = toReplayDocument(beforeDocument);\n  const afterReplay = toReplayDocument(afterDocument);\n  const patch = jsonPatch.compare(beforeReplay, afterReplay) as HistoryPatchOp[];\n  const fields = new Set<string>();\n\n  for (const op of patch) {\n    if (op.path === \"/body\" || op.path.startsWith(\"/body/\")) {\n      fields.add(\"body\");\n      continue;\n    }\n    const segment = op.path.replace(/^\\/(?:metadata|front_matter)\\/?/, \"\").split(\"/\")[0];\n    fields.add(segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n  }\n\n  return Array.from(fields).sort((a, b) => a.localeCompare(b));\n}\n\nasync function loadRestoreStateUnderLock(params: {\n  pmRoot: string;\n  resolvedId: string;\n  subject: ResolvedRestoreSubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n}): Promise<{ loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null; existingItemPath: string | null }> {\n  const historyRawUnderLock = await readFileIfExists(params.subject.historyPath);\n  if (historyRawUnderLock !== params.historyRawBeforeLock) {\n    throw new PmCliError(`History for ${params.resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);\n  }\n  const locatedUnderLock = await locateItem(\n    params.pmRoot,\n    params.resolvedId,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    params.typeToFolder,\n  );\n  const loadedItemUnderLock = locatedUnderLock ? await readLocatedItem(locatedUnderLock, { schema: params.settings.schema }) : null;\n  if ((loadedItemUnderLock?.raw ?? null) !== params.currentItemRawBeforeLock) {\n    throw new PmCliError(`Item ${params.resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);\n  }\n  return { loadedItemUnderLock, existingItemPath: locatedUnderLock?.itemPath ?? null };\n}\n\nfunction resolveRestoreCurrentState(\n  loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null,\n  history: HistoryEntry[],\n): RestoreCurrentState {\n  if (loadedItemUnderLock) {\n    return { document: loadedItemUnderLock.document, originalRaw: loadedItemUnderLock.raw };\n  }\n  return { document: replayCurrentDocument(history), originalRaw: null };\n}\n\nfunction collectRestoreOwnershipWarnings(params: {\n  document: ItemDocument;\n  author: string;\n  force: boolean | undefined;\n  enforcement: \"strict\" | \"warn\" | \"none\";\n  resolvedId: string;\n}): string[] {\n  const assigned = params.document.metadata.assignee?.trim();\n  const hasOwnershipConflict = assigned && assigned !== params.author && !params.force;\n  if (!hasOwnershipConflict) {\n    return [];\n  }\n  if (params.enforcement === \"strict\") {\n    throw new PmCliError(`Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);\n  }\n  return params.enforcement === \"warn\" ? [`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`] : [];\n}\n\nasync function restorePreviousItemAfterHistoryFailure(params: {\n  existingItemPath: string | null;\n  resolvedOriginalRaw: string | null;\n  restoredItemPath: string;\n}): Promise<void> {\n  if (params.existingItemPath && params.resolvedOriginalRaw !== null && params.restoredItemPath !== params.existingItemPath) {\n    await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);\n    await fs.rm(params.restoredItemPath, { force: true });\n    return;\n  }\n  if (params.existingItemPath && params.resolvedOriginalRaw !== null) {\n    await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);\n    return;\n  }\n  await fs.rm(params.restoredItemPath, { force: true });\n}\n\nasync function runRestoreWriteHooks(params: {\n  restoredItemPath: string;\n  historyPath: string;\n  before: ItemDocument;\n  after: ItemDocument;\n}): Promise<string[]> {\n  return [\n    ...(await runActiveOnWriteHooks({\n      path: params.restoredItemPath,\n      scope: \"project\",\n      op: \"restore\",\n      item_id: params.after.metadata.id,\n      item_type: params.after.metadata.type,\n      before: params.before,\n      after: params.after,\n      changed_fields: [\"restored\"],\n    })),\n    ...(await runActiveOnWriteHooks({\n      path: params.historyPath,\n      scope: \"project\",\n      op: \"restore:history\",\n      item_id: params.after.metadata.id,\n      item_type: params.after.metadata.type,\n      before: params.before,\n      after: params.after,\n      changed_fields: [\"restored\"],\n    })),\n  ];\n}\n\n/**\n * Implements run restore for the public runtime surface of this module.\n */\nexport async function runRestore(\n  id: string,\n  target: string,\n  options: RestoreCommandOptions,\n  global: GlobalOptions,\n): Promise<RestoreResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveRestoreSubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n  const resolvedId = subject.id;\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const history = await readHistoryEntries(subject.historyPath, resolvedId);\n  if (history.length === 0) {\n    throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const resolvedTarget = ensureReplayTarget(target, history);\n  const replayDocument = ensureMaterializedRestoreTarget(replayToTarget(history, resolvedTarget.historyIndex), resolvedTarget);\n  const restoredDocument = replayToCanonicalItemDocument(replayDocument, { schema: settings.schema });\n\n  if (restoredDocument.metadata.id !== resolvedId) {\n    throw new PmCliError(\n      `Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  const loadedItemBeforeLock = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  const currentItemRawBeforeLock = loadedItemBeforeLock?.raw ?? null;\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const releaseLock = await acquireLock(\n    pmRoot,\n    resolvedId,\n    settings.locks.ttl_seconds,\n    author,\n    Boolean(options.force),\n    settings.governance.force_required_for_stale_lock,\n  );\n\n  try {\n    const { loadedItemUnderLock, existingItemPath } = await loadRestoreStateUnderLock({\n      pmRoot,\n      resolvedId,\n      subject,\n      settings,\n      typeToFolder: typeRegistry.type_to_folder,\n      historyRawBeforeLock,\n      currentItemRawBeforeLock,\n    });\n    const itemFormat = \"toon\";\n    const currentState = resolveRestoreCurrentState(loadedItemUnderLock, history);\n    const ownershipWarnings = collectRestoreOwnershipWarnings({\n      document: currentState.document,\n      author,\n      force: options.force,\n      enforcement: settings.governance.ownership_enforcement,\n      resolvedId,\n    });\n\n    const serializedRestore = serializeItemDocument(restoredDocument, { format: itemFormat, schema: settings.schema });\n    /* c8 ignore next -- restored item path typing is exercised in restore integration workflows. */\n    const restoredItemPath = getItemPath(\n      pmRoot,\n      restoredDocument.metadata.type,\n      resolvedId,\n      itemFormat,\n      typeRegistry.type_to_folder,\n    );\n    await writeFileAtomic(restoredItemPath, serializedRestore);\n    if (existingItemPath && restoredItemPath !== existingItemPath) {\n      await fs.rm(existingItemPath);\n    }\n\n    const historyEntry = createHistoryEntry({\n      nowIso: nowIso(),\n      author,\n      op: \"restore\",\n      before: currentState.document,\n      after: restoredDocument,\n      message: options.message,\n    });\n\n    try {\n      await appendHistoryEntry(subject.historyPath, historyEntry);\n    } catch (error: unknown) {\n      await restorePreviousItemAfterHistoryFailure({\n        existingItemPath,\n        resolvedOriginalRaw: currentState.originalRaw,\n        restoredItemPath,\n      });\n      throw error;\n    }\n    const restoreChangedFields = changedFields(currentState.document, restoredDocument);\n    const hookWarnings = await runRestoreWriteHooks({\n      restoredItemPath,\n      historyPath: subject.historyPath,\n      before: currentState.document,\n      after: restoredDocument,\n    });\n    recordAfterCommandAffectedItem({\n      id: restoredDocument.metadata.id,\n      op: \"restore\",\n      item_type: restoredDocument.metadata.type,\n      previous_status: currentState.document.metadata.status,\n      status: restoredDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(currentState.document.metadata, restoreChangedFields),\n      current: projectAfterCommandItemSnapshot(restoredDocument.metadata, restoreChangedFields),\n      changed_fields: restoreChangedFields,\n    });\n\n    const targetEntry = history[resolvedTarget.historyIndex];\n    return {\n      item: restoredDocument.metadata,\n      restored_from: {\n        kind: resolvedTarget.kind,\n        target: resolvedTarget.raw,\n        history_index: resolvedTarget.historyIndex + 1,\n        entry_ts: targetEntry.ts,\n        entry_op: targetEntry.op,\n      },\n      changed_fields: restoreChangedFields,\n      warnings: [...subject.historyPolicyWarnings, ...ownershipWarnings, ...hookWarnings],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\nexport const _testOnlyRestoreCommand = {\n  applyHistoryPatch,\n  changedFields,\n  ensureMaterializedRestoreTarget,\n  ensureReplayTarget,\n  extractPatchFailureContext,\n  replayCurrentDocument,\n  replayToTarget,\n  resolveRestoreSubject,\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @module cli/commands/restore\n *\n * Implements the pm restore command surface and its agent-facing runtime behavior.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport fs from \"node:fs/promises\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { appendHistoryEntry, createHistoryEntry } from \"../../core/history/history.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  normalizeReplayPatchOps,\n  replayHash,\n  replayToCanonicalItemDocument,\n  replayToItemDocument,\n  toReplayDocument,\n  type ReplayDocument as CanonicalReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport { canonicalDocument, serializeItemDocument } from \"../../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { acquireLock } from \"../../core/lock/lock.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  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument, ItemMetadata } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\ninterface ResolvedRestoreTarget {\n  kind: \"version\" | \"timestamp\";\n  raw: string;\n  historyIndex: number;\n}\n\ninterface ResolvedRestoreSubject {\n  id: string;\n  historyPath: string;\n  located: Awaited<ReturnType<typeof locateItem>>;\n  historyPolicyWarnings: string[];\n}\n\ninterface RestoreCurrentState {\n  document: ItemDocument;\n  originalRaw: string | null;\n}\n\ninterface PatchFailureContext {\n  patchIndex?: number;\n  op?: string;\n  path?: string;\n  from?: string;\n  reason?: string;\n}\n\n/**\n * Documents the restore command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface RestoreCommandOptions {\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the restore result payload exchanged by command, SDK, and package integrations.\n */\nexport interface RestoreResult {\n  item: ItemMetadata;\n  restored_from: {\n    kind: \"version\" | \"timestamp\";\n    target: string;\n    history_index: number;\n    entry_ts: string;\n    entry_op: string;\n  };\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction ensureReplayTarget(target: string, history: HistoryEntry[]): ResolvedRestoreTarget {\n  const trimmed = target.trim();\n  if (!trimmed) {\n    throw new PmCliError(\"Missing restore target. Use a timestamp or version number.\", EXIT_CODE.USAGE);\n  }\n\n  if (/^\\d+$/.test(trimmed)) {\n    const version = Number(trimmed);\n    if (!Number.isSafeInteger(version) || version < 1 || version > history.length) {\n      throw new PmCliError(\n        `Restore version must be between 1 and ${history.length} for this item.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      kind: \"version\",\n      raw: trimmed,\n      historyIndex: version - 1,\n    };\n  }\n\n  const parsedTarget = Date.parse(trimmed);\n  if (!Number.isFinite(parsedTarget)) {\n    throw new PmCliError(\n      `Invalid restore target \"${target}\". Use a positive version number or ISO timestamp.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let index = -1;\n  for (let i = 0; i < history.length; i += 1) {\n    const entryTimestamp = Date.parse(history[i].ts);\n    if (!Number.isFinite(entryTimestamp)) {\n      throw new PmCliError(\n        `History for this item contains invalid timestamp at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (entryTimestamp <= parsedTarget) {\n      index = i;\n    }\n  }\n\n  if (index < 0) {\n    throw new PmCliError(`No history entries exist at or before timestamp ${trimmed}.`, EXIT_CODE.USAGE);\n  }\n\n  return {\n    kind: \"timestamp\",\n    raw: trimmed,\n    historyIndex: index,\n  };\n}\n\nfunction extractPatchFailureContext(\n  patch: HistoryPatchOp[],\n  error: unknown,\n): PatchFailureContext {\n  const context: PatchFailureContext = {};\n  if (error instanceof Error && error.message.trim().length > 0) {\n    context.reason = error.message.trim();\n  }\n  if (typeof error !== \"object\" || error === null) {\n    return context;\n  }\n  const candidate = error as {\n    index?: unknown;\n    operation?: unknown;\n  };\n  /* c8 ignore start -- parser-generated patch errors may omit index metadata in current fixtures. */\n  if (typeof candidate.index === \"number\" && Number.isInteger(candidate.index) && candidate.index >= 0) {\n    context.patchIndex = candidate.index;\n  }\n  /* c8 ignore stop */\n  /* c8 ignore start -- operation payload metadata is optional in upstream json-patch failures. */\n  const operationRecord =\n    typeof candidate.operation === \"object\" && candidate.operation !== null\n      ? (candidate.operation as { op?: unknown; path?: unknown; from?: unknown })\n      : null;\n  /* c8 ignore stop */\n  enrichPatchFailureContext(context, operationRecord, patch);\n  return context;\n}\n\nfunction enrichPatchFailureContext(\n  context: PatchFailureContext,\n  operationRecord: { op?: unknown; path?: unknown; from?: unknown } | null,\n  patch: HistoryPatchOp[],\n): void {\n  /* v8 ignore start -- operation replay records always carry a string op when present; this preserves context for malformed future rows */\n  if (operationRecord && typeof operationRecord.op === \"string\") {\n    context.op = operationRecord.op;\n  }\n  /* v8 ignore stop */\n  if (operationRecord && typeof operationRecord.path === \"string\") {\n    context.path = operationRecord.path;\n  }\n  if (operationRecord && typeof operationRecord.from === \"string\") {\n    context.from = operationRecord.from;\n  }\n  if ((context.op === undefined || context.path === undefined) && context.patchIndex !== undefined) {\n    const fallback = patch[context.patchIndex];\n    /* c8 ignore start -- fallback enrichment paths are only exercised by malformed patch telemetry payloads. */\n    if (fallback) {\n      context.op = context.op ?? fallback.op;\n      context.path = context.path ?? fallback.path;\n      context.from = context.from ?? fallback.from;\n    }\n    /* c8 ignore stop */\n  }\n}\n\nfunction applyHistoryPatch(\n  current: CanonicalReplayDocument,\n  patch: HistoryPatchOp[],\n  entryNumber: number,\n  entryOp: string,\n): CanonicalReplayDocument {\n  try {\n    const normalizedPatch = normalizeReplayPatchOps(patch);\n    const applied = jsonPatch.applyPatch(\n      structuredClone(current),\n      normalizedPatch as jsonPatch.Operation[],\n      true,\n      false,\n    ).newDocument as unknown;\n    if (\n      typeof applied !== \"object\" ||\n      applied === null ||\n      !(\"metadata\" in applied) ||\n      !(\"body\" in applied) ||\n      typeof (applied as { body: unknown }).body !== \"string\" ||\n      typeof (applied as { metadata: unknown }).metadata !== \"object\" ||\n      (applied as { metadata: unknown }).metadata === null\n    ) {\n      throw new PmCliError(\n        `History replay produced an invalid document shape at entry ${entryNumber}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    const replay = applied as { metadata: Record<string, unknown>; body: string };\n    return {\n      metadata: replay.metadata,\n      body: replay.body,\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    const failureContext = extractPatchFailureContext(patch, error);\n    const contextTokens = [\n      `history_op=${entryOp}`,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.patchIndex !== undefined ? `patch_index=${failureContext.patchIndex}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.op ? `op=${failureContext.op}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.path ? `path=${failureContext.path}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.from ? `from=${failureContext.from}` : null,\n    ].filter((token): token is string => token !== null);\n    /* c8 ignore start -- jsonPatch/structuredClone/normalizeReplayPatchOps always throw Error instances with non-empty messages here, so extractPatchFailureContext always sets reason; the empty-suffix fallback is unreachable through applyHistoryPatch. */\n    const reasonSuffix = failureContext.reason ? ` ${failureContext.reason}` : \"\";\n    /* c8 ignore stop */\n    throw new PmCliError(\n      `Failed to apply history patch at entry ${entryNumber} (${contextTokens.join(\", \")}).${reasonSuffix}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\nfunction replayToTarget(history: HistoryEntry[], targetIndex: number): CanonicalReplayDocument {\n  let document: CanonicalReplayDocument = structuredClone(EMPTY_REPLAY_DOCUMENT);\n\n  for (let i = 0; i <= targetIndex; i += 1) {\n    const entry = history[i];\n    const beforeHash = replayHash(document);\n    if (beforeHash !== entry.before_hash) {\n      throw new PmCliError(\n        `History hash mismatch before replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n\n    document = applyHistoryPatch(document, entry.patch, i + 1, entry.op);\n\n    const afterHash = replayHash(document);\n    if (afterHash !== entry.after_hash) {\n      throw new PmCliError(\n        `History hash mismatch after replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n\n  return document;\n}\n\nfunction ensureMaterializedRestoreTarget(\n  replayDocument: CanonicalReplayDocument,\n  target: ResolvedRestoreTarget,\n): CanonicalReplayDocument {\n  if (Object.keys(replayDocument.metadata).length > 0) {\n    return replayDocument;\n  }\n  throw new PmCliError(\n    `Restore target ${target.raw} resolves to a deleted state; choose a version or timestamp where the item exists.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction replayCurrentDocument(history: HistoryEntry[]): ItemDocument {\n  const currentReplay = replayToTarget(history, history.length - 1);\n  if (Object.keys(currentReplay.metadata).length === 0) {\n    return {\n      metadata: {} as ItemMetadata,\n      body: currentReplay.body,\n    };\n  }\n  return canonicalDocument(replayToItemDocument(currentReplay));\n}\n\nasync function resolveRestoreSubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<ResolvedRestoreSubject> {\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (located) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"restore\",\n    });\n    return {\n      id: located.id,\n      historyPath,\n      located,\n      historyPolicyWarnings: historyPolicy.warnings,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  /* c8 ignore start -- raw-id fallback is covered by normalize-item-id utility tests. */\n  const candidateIds = normalizedId === rawNormalizedId ? [normalizedId] : [normalizedId, rawNormalizedId];\n  /* c8 ignore stop */\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        historyPolicyWarnings: [],\n      };\n    }\n  }\n\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\nfunction changedFields(beforeDocument: ItemDocument, afterDocument: ItemDocument): string[] {\n  const beforeReplay = toReplayDocument(beforeDocument);\n  const afterReplay = toReplayDocument(afterDocument);\n  const patch = jsonPatch.compare(beforeReplay, afterReplay) as HistoryPatchOp[];\n  const fields = new Set<string>();\n\n  for (const op of patch) {\n    if (op.path === \"/body\" || op.path.startsWith(\"/body/\")) {\n      fields.add(\"body\");\n      continue;\n    }\n    const segment = op.path.replace(/^\\/(?:metadata|front_matter)\\/?/, \"\").split(\"/\")[0];\n    fields.add(segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n  }\n\n  return Array.from(fields).sort((a, b) => a.localeCompare(b));\n}\n\nasync function loadRestoreStateUnderLock(params: {\n  pmRoot: string;\n  resolvedId: string;\n  subject: ResolvedRestoreSubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n}): Promise<{ loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null; existingItemPath: string | null }> {\n  const historyRawUnderLock = await readFileIfExists(params.subject.historyPath);\n  if (historyRawUnderLock !== params.historyRawBeforeLock) {\n    throw new PmCliError(`History for ${params.resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);\n  }\n  const locatedUnderLock = await locateItem(\n    params.pmRoot,\n    params.resolvedId,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    params.typeToFolder,\n  );\n  const loadedItemUnderLock = locatedUnderLock ? await readLocatedItem(locatedUnderLock, { schema: params.settings.schema }) : null;\n  if ((loadedItemUnderLock?.raw ?? null) !== params.currentItemRawBeforeLock) {\n    throw new PmCliError(`Item ${params.resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);\n  }\n  return { loadedItemUnderLock, existingItemPath: locatedUnderLock?.itemPath ?? null };\n}\n\nfunction resolveRestoreCurrentState(\n  loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null,\n  history: HistoryEntry[],\n): RestoreCurrentState {\n  if (loadedItemUnderLock) {\n    return { document: loadedItemUnderLock.document, originalRaw: loadedItemUnderLock.raw };\n  }\n  return { document: replayCurrentDocument(history), originalRaw: null };\n}\n\nfunction collectRestoreOwnershipWarnings(params: {\n  document: ItemDocument;\n  author: string;\n  force: boolean | undefined;\n  enforcement: \"strict\" | \"warn\" | \"none\";\n  resolvedId: string;\n}): string[] {\n  const assigned = params.document.metadata.assignee?.trim();\n  const hasOwnershipConflict = assigned && assigned !== params.author && !params.force;\n  if (!hasOwnershipConflict) {\n    return [];\n  }\n  if (params.enforcement === \"strict\") {\n    throw new PmCliError(`Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);\n  }\n  return params.enforcement === \"warn\" ? [`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`] : [];\n}\n\nasync function restorePreviousItemAfterHistoryFailure(params: {\n  existingItemPath: string | null;\n  resolvedOriginalRaw: string | null;\n  restoredItemPath: string;\n}): Promise<void> {\n  if (params.existingItemPath && params.resolvedOriginalRaw !== null && params.restoredItemPath !== params.existingItemPath) {\n    await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);\n    await fs.rm(params.restoredItemPath, { force: true });\n    return;\n  }\n  if (params.existingItemPath && params.resolvedOriginalRaw !== null) {\n    await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);\n    return;\n  }\n  await fs.rm(params.restoredItemPath, { force: true });\n}\n\nasync function runRestoreWriteHooks(params: {\n  restoredItemPath: string;\n  historyPath: string;\n  before: ItemDocument;\n  after: ItemDocument;\n}): Promise<string[]> {\n  return [\n    ...(await runActiveOnWriteHooks({\n      path: params.restoredItemPath,\n      scope: \"project\",\n      op: \"restore\",\n      item_id: params.after.metadata.id,\n      item_type: params.after.metadata.type,\n      before: params.before,\n      after: params.after,\n      changed_fields: [\"restored\"],\n    })),\n    ...(await runActiveOnWriteHooks({\n      path: params.historyPath,\n      scope: \"project\",\n      op: \"restore:history\",\n      item_id: params.after.metadata.id,\n      item_type: params.after.metadata.type,\n      before: params.before,\n      after: params.after,\n      changed_fields: [\"restored\"],\n    })),\n  ];\n}\n\n/**\n * Implements run restore for the public runtime surface of this module.\n */\nexport async function runRestore(\n  id: string,\n  target: string,\n  options: RestoreCommandOptions,\n  global: GlobalOptions,\n): Promise<RestoreResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveRestoreSubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n  const resolvedId = subject.id;\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const history = await readHistoryEntries(subject.historyPath, resolvedId);\n  if (history.length === 0) {\n    throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const resolvedTarget = ensureReplayTarget(target, history);\n  const replayDocument = ensureMaterializedRestoreTarget(replayToTarget(history, resolvedTarget.historyIndex), resolvedTarget);\n  const restoredDocument = replayToCanonicalItemDocument(replayDocument, { schema: settings.schema });\n\n  if (restoredDocument.metadata.id !== resolvedId) {\n    throw new PmCliError(\n      `Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  const loadedItemBeforeLock = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  const currentItemRawBeforeLock = loadedItemBeforeLock?.raw ?? null;\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const releaseLock = await acquireLock(\n    pmRoot,\n    resolvedId,\n    settings.locks.ttl_seconds,\n    author,\n    Boolean(options.force),\n    settings.governance.force_required_for_stale_lock,\n    settings.locks.wait_ms,\n  );\n\n  try {\n    const { loadedItemUnderLock, existingItemPath } = await loadRestoreStateUnderLock({\n      pmRoot,\n      resolvedId,\n      subject,\n      settings,\n      typeToFolder: typeRegistry.type_to_folder,\n      historyRawBeforeLock,\n      currentItemRawBeforeLock,\n    });\n    const itemFormat = \"toon\";\n    const currentState = resolveRestoreCurrentState(loadedItemUnderLock, history);\n    const ownershipWarnings = collectRestoreOwnershipWarnings({\n      document: currentState.document,\n      author,\n      force: options.force,\n      enforcement: settings.governance.ownership_enforcement,\n      resolvedId,\n    });\n\n    const serializedRestore = serializeItemDocument(restoredDocument, { format: itemFormat, schema: settings.schema });\n    /* c8 ignore next -- restored item path typing is exercised in restore integration workflows. */\n    const restoredItemPath = getItemPath(\n      pmRoot,\n      restoredDocument.metadata.type,\n      resolvedId,\n      itemFormat,\n      typeRegistry.type_to_folder,\n    );\n    await writeFileAtomic(restoredItemPath, serializedRestore);\n    if (existingItemPath && restoredItemPath !== existingItemPath) {\n      await fs.rm(existingItemPath);\n    }\n\n    const historyEntry = createHistoryEntry({\n      nowIso: nowIso(),\n      author,\n      op: \"restore\",\n      before: currentState.document,\n      after: restoredDocument,\n      message: options.message,\n    });\n\n    try {\n      await appendHistoryEntry(subject.historyPath, historyEntry);\n    } catch (error: unknown) {\n      await restorePreviousItemAfterHistoryFailure({\n        existingItemPath,\n        resolvedOriginalRaw: currentState.originalRaw,\n        restoredItemPath,\n      });\n      throw error;\n    }\n    const restoreChangedFields = changedFields(currentState.document, restoredDocument);\n    const hookWarnings = await runRestoreWriteHooks({\n      restoredItemPath,\n      historyPath: subject.historyPath,\n      before: currentState.document,\n      after: restoredDocument,\n    });\n    recordAfterCommandAffectedItem({\n      id: restoredDocument.metadata.id,\n      op: \"restore\",\n      item_type: restoredDocument.metadata.type,\n      previous_status: currentState.document.metadata.status,\n      status: restoredDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(currentState.document.metadata, restoreChangedFields),\n      current: projectAfterCommandItemSnapshot(restoredDocument.metadata, restoreChangedFields),\n      changed_fields: restoreChangedFields,\n    });\n\n    const targetEntry = history[resolvedTarget.historyIndex];\n    return {\n      item: restoredDocument.metadata,\n      restored_from: {\n        kind: resolvedTarget.kind,\n        target: resolvedTarget.raw,\n        history_index: resolvedTarget.historyIndex + 1,\n        entry_ts: targetEntry.ts,\n        entry_op: targetEntry.op,\n      },\n      changed_fields: restoreChangedFields,\n      warnings: [...subject.historyPolicyWarnings, ...ownershipWarnings, ...hookWarnings],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\nexport const _testOnlyRestoreCommand = {\n  applyHistoryPatch,\n  changedFields,\n  ensureMaterializedRestoreTarget,\n  ensureReplayTarget,\n  extractPatchFailureContext,\n  replayCurrentDocument,\n  replayToTarget,\n  resolveRestoreSubject,\n};\n"],
+  "mappings": "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",
   "names": ["global"]
 }

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

@@ -0,0 +1,47 @@
+// dist/core/extensions/runtime-registrations.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] = "e07fa0c4-b607-5bc4-a020-b1589debbe19");
+  } catch (e2) {
+  }
+})();
+function normalizeRegistrationName(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const normalized = value.trim().toLowerCase();
+  return normalized.length > 0 ? normalized : null;
+}
+function resolveRegisteredSearchProvider(registrations, configuredProvider) {
+  const providerName = normalizeRegistrationName(configuredProvider);
+  if (!registrations || !providerName) {
+    return null;
+  }
+  const matched = [...registrations.search_providers].reverse().find((registration) => {
+    const definitionName = normalizeRegistrationName(registration.runtime_definition?.name) ?? normalizeRegistrationName(registration.definition?.name);
+    return definitionName === providerName;
+  });
+  return matched ?? null;
+}
+function resolveRegisteredVectorStoreAdapter(registrations, configuredAdapter) {
+  const adapterName = normalizeRegistrationName(configuredAdapter);
+  if (!registrations || !adapterName) {
+    return null;
+  }
+  const matched = [...registrations.vector_store_adapters].reverse().find((registration) => {
+    const definitionName = normalizeRegistrationName(registration.runtime_definition?.name) ?? normalizeRegistrationName(registration.definition?.name);
+    return definitionName === adapterName;
+  });
+  return matched ?? null;
+}
+function getMigrationRuntimeDefinition(migration) {
+  return migration.runtime_definition ?? migration.definition;
+}
+
+export {
+  resolveRegisteredSearchProvider,
+  resolveRegisteredVectorStoreAdapter,
+  getMigrationRuntimeDefinition
+};
+//# sourceMappingURL=chunk-B5KXLBSJ.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/extensions/runtime-registrations.ts"],
+  "sourcesContent": ["/**\n * @module core/extensions/runtime-registrations\n *\n * Implements extension runtime contracts and governance for Runtime Registrations.\n */\nimport type {\n  ExtensionRegistrationRegistry,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionVectorStoreAdapter,\n} from \"./loader.js\";\n\nfunction normalizeRegistrationName(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : null;\n}\n\n/**\n * Implements collect registered item fields for the public runtime surface of this module.\n */\nexport function collectRegisteredItemFields(registrations: ExtensionRegistrationRegistry | null): Array<Record<string, unknown>> {\n  if (!registrations) {\n    return [];\n  }\n  const fields: Array<Record<string, unknown>> = [];\n  for (const registration of registrations.item_fields) {\n    for (const field of registration.fields) {\n      fields.push(field);\n    }\n  }\n  return fields;\n}\n\n/**\n * Implements resolve registered search provider for the public runtime surface of this module.\n */\nexport function resolveRegisteredSearchProvider(\n  registrations: ExtensionRegistrationRegistry | null,\n  configuredProvider: string | undefined,\n): RegisteredExtensionSearchProvider | null {\n  const providerName = normalizeRegistrationName(configuredProvider);\n  if (!registrations || !providerName) {\n    return null;\n  }\n  const matched = [...registrations.search_providers]\n    .reverse()\n    .find((registration) => {\n      const definitionName =\n        normalizeRegistrationName(registration.runtime_definition?.name) ??\n        normalizeRegistrationName(registration.definition?.name);\n      return definitionName === providerName;\n    });\n  return matched ?? null;\n}\n\n/**\n * Implements resolve registered vector store adapter for the public runtime surface of this module.\n */\nexport function resolveRegisteredVectorStoreAdapter(\n  registrations: ExtensionRegistrationRegistry | null,\n  configuredAdapter: string | undefined,\n): RegisteredExtensionVectorStoreAdapter | null {\n  const adapterName = normalizeRegistrationName(configuredAdapter);\n  if (!registrations || !adapterName) {\n    return null;\n  }\n  const matched = [...registrations.vector_store_adapters]\n    .reverse()\n    .find((registration) => {\n      const definitionName =\n        normalizeRegistrationName(registration.runtime_definition?.name) ??\n        normalizeRegistrationName(registration.definition?.name);\n      return definitionName === adapterName;\n    });\n  return matched ?? null;\n}\n\n/**\n * Implements get migration runtime definition for the public runtime surface of this module.\n */\nexport function getMigrationRuntimeDefinition(\n  migration: RegisteredExtensionSchemaMigrationDefinition,\n): Record<string, unknown> {\n  return migration.runtime_definition ?? migration.definition;\n}\n"],
+  "mappings": ";;;;;;;;AAYA,SAAS,0BAA0B,OAAc;AAC/C,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;EACT;AACA,QAAM,aAAa,MAAM,KAAI,EAAG,YAAW;AAC3C,SAAO,WAAW,SAAS,IAAI,aAAa;AAC9C;AAqBM,SAAU,gCACd,eACA,oBAAsC;AAEtC,QAAM,eAAe,0BAA0B,kBAAkB;AACjE,MAAI,CAAC,iBAAiB,CAAC,cAAc;AACnC,WAAO;EACT;AACA,QAAM,UAAU,CAAC,GAAG,cAAc,gBAAgB,EAC/C,QAAO,EACP,KAAK,CAAC,iBAAgB;AACrB,UAAM,iBACJ,0BAA0B,aAAa,oBAAoB,IAAI,KAC/D,0BAA0B,aAAa,YAAY,IAAI;AACzD,WAAO,mBAAmB;EAC5B,CAAC;AACH,SAAO,WAAW;AACpB;AAKM,SAAU,oCACd,eACA,mBAAqC;AAErC,QAAM,cAAc,0BAA0B,iBAAiB;AAC/D,MAAI,CAAC,iBAAiB,CAAC,aAAa;AAClC,WAAO;EACT;AACA,QAAM,UAAU,CAAC,GAAG,cAAc,qBAAqB,EACpD,QAAO,EACP,KAAK,CAAC,iBAAgB;AACrB,UAAM,iBACJ,0BAA0B,aAAa,oBAAoB,IAAI,KAC/D,0BAA0B,aAAa,YAAY,IAAI;AACzD,WAAO,mBAAmB;EAC5B,CAAC;AACH,SAAO,WAAW;AACpB;AAKM,SAAU,8BACd,WAAuD;AAEvD,SAAO,UAAU,sBAAsB,UAAU;AACnD;",
+  "names": []
+}

package/dist/cli-bundle/chunks/{chunk-Y2VSCQ77.js → chunk-BFVHCAOO.js}

@@ -1,18 +1,20 @@
 
-!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]="be42ed54-a5b3-5603-ac08-e05799a50836")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="60ce5760-cb2c-5450-b92b-48275942b6ad")}catch(e){}}();
 import {
   hashDocument,
   toItemRecord
-} from "./chunk-UYLA5ROU.js";
+} from "./chunk-57C2RLW5.js";
 import {
   canonicalDocument
-} from "./chunk-AOP2EMK3.js";
+} from "./chunk-HK72NWAD.js";
 import {
-  FRONT_MATTER_KEY_ORDER,
   orderObject,
   sha256Hex,
   stableStringify
-} from "./chunk-SL2ANJSV.js";
+} from "./chunk-US3T3W5J.js";
+import {
+  FRONT_MATTER_KEY_ORDER
+} from "./chunk-YD5FML7K.js";
 
 // dist/core/history/replay.js
 import jsonPatch from "fast-json-patch";
@@ -233,6 +235,6 @@ export {
   reanchorHistoryEntries,
   historyEntriesToRaw
 };
-//# sourceMappingURL=chunk-Y2VSCQ77.js.map
+//# sourceMappingURL=chunk-BFVHCAOO.js.map
 
-//# debugId=be42ed54-a5b3-5603-ac08-e05799a50836
+//# debugId=60ce5760-cb2c-5450-b92b-48275942b6ad