@unbrained/pm-cli 2026.7.21 → 2026.7.22

package/dist/cli-bundle/chunks/{chunk-FJIFFBJX.js → chunk-MROP2RNT.js}

@@ -1,17 +1,17 @@
 
-!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]="39413a08-0b6f-5fb4-8e45-d039b2979e25")}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]="50e62ca5-fc65-568e-b9ef-4b45850e4d6f")}catch(e){}}();
 import {
   EXECUTABLE_COMMAND_ALIASES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunk-FSE2IKJQ.js";
+} from "./chunk-TWHG646K.js";
 import {
   writeStdout
-} from "./chunk-VJQG4BIM.js";
+} from "./chunk-DSFTAQ7T.js";
 import {
   EXIT_CODE,
   PmCliError,
   levenshteinDistanceWithinLimit
-} from "./chunk-HYW67VJ5.js";
+} from "./chunk-TLF52ZDP.js";
 
 // dist/sdk/error-runtime.js
 function describeUnknownError(error) {
@@ -100,59 +100,48 @@ var BOOTSTRAP_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "--quiet",
   "--lean"
 ]);
+function consumeBootstrapGlobalToken(argv, index, state) {
+  const token = argv[index];
+  if (BOOTSTRAP_BOOLEAN_FLAGS.has(token)) {
+    state.booleanFlags.add(token);
+    return 1;
+  }
+  const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);
+  if (parsedPath) {
+    if (parsedPath.pathValue !== void 0) {
+      if (parsedPath.preferred)
+        state.pmPathValue = parsedPath.pathValue;
+      else
+        state.legacyPathValue = parsedPath.pathValue;
+    }
+    return parsedPath.consumed;
+  }
+  if (token === "--author") {
+    const consumesValue = consumesBootstrapAuthorValue(argv[index + 1]);
+    state.author = consumesValue ? argv[index + 1] : "";
+    return consumesValue ? 2 : 1;
+  }
+  if (token.startsWith("--author=")) {
+    state.author = token.slice("--author=".length);
+  }
+  return 1;
+}
 function parseBootstrapGlobalOptions(argv) {
-  let legacyPathValue;
-  let pmPathValue;
-  const booleanFlags = /* @__PURE__ */ new Set();
-  let author;
+  const state = { booleanFlags: /* @__PURE__ */ new Set() };
   let index = 0;
   while (index < argv.length) {
-    const token = argv[index];
-    if (token === "--") {
+    if (argv[index] === "--")
       break;
-    }
-    if (BOOTSTRAP_BOOLEAN_FLAGS.has(token)) {
-      booleanFlags.add(token);
-      index += 1;
-      continue;
-    }
-    const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);
-    if (parsedPath) {
-      if (parsedPath.pathValue !== void 0) {
-        if (parsedPath.preferred) {
-          pmPathValue = parsedPath.pathValue;
-        } else {
-          legacyPathValue = parsedPath.pathValue;
-        }
-      }
-      index += parsedPath.consumed;
-      continue;
-    }
-    if (token === "--author") {
-      if (consumesBootstrapAuthorValue(argv[index + 1])) {
-        author = argv[index + 1];
-        index += 2;
-      } else {
-        author = "";
-        index += 1;
-      }
-      continue;
-    }
-    if (token.startsWith("--author=")) {
-      author = token.slice("--author=".length);
-      index += 1;
-      continue;
-    }
-    index += 1;
+    index += consumeBootstrapGlobalToken(argv, index, state);
   }
   return {
-    path: pmPathValue ?? legacyPathValue,
-    noExtensions: booleanFlags.has("--no-extensions"),
-    noPager: booleanFlags.has("--no-pager"),
-    json: booleanFlags.has("--json"),
-    quiet: booleanFlags.has("--quiet"),
-    lean: booleanFlags.has("--lean"),
-    ...author === "" ? { authorMissingValue: true } : author !== void 0 ? { author } : {}
+    path: state.pmPathValue ?? state.legacyPathValue,
+    noExtensions: state.booleanFlags.has("--no-extensions"),
+    noPager: state.booleanFlags.has("--no-pager"),
+    json: state.booleanFlags.has("--json"),
+    quiet: state.booleanFlags.has("--quiet"),
+    lean: state.booleanFlags.has("--lean"),
+    ...state.author === "" ? { authorMissingValue: true } : state.author !== void 0 ? { author: state.author } : {}
   };
 }
 function stripGlobalBootstrapTokens(argv) {
@@ -706,27 +695,13 @@ function mergeLinkedTestTwoTokenEntries(argv, commandName, trace) {
   }
   return result;
 }
-function normalizeBootstrapInvocation(argv) {
-  const trace = [];
-  const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);
-  if (legacyNormalized.length !== argv.length || legacyNormalized.some((token, index) => token !== argv[index])) {
-    trace.push({
-      from: argv.join(" "),
-      to: [...legacyNormalized],
-      reason: "legacy_extension_action",
-      confidence: "high"
-    });
-  }
-  const aliasNormalized = rewriteCommandAlias(legacyNormalized, trace);
-  const commandName = parseBootstrapCommandName(aliasNormalized);
-  const commandPathName = parseBootstrapCommandPathName(aliasNormalized);
-  const lookup = buildFlagLookup(commandPathName ?? commandName);
+function normalizeBootstrapTokens(argv, lookup, commandName, trace) {
   const normalizedArgv = [];
-  const pathValueIndices = collectBootstrapPathValueIndices(aliasNormalized);
-  for (let index = 0; index < aliasNormalized.length; index += 1) {
-    const token = aliasNormalized[index];
+  const pathValueIndices = collectBootstrapPathValueIndices(argv);
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
     if (token === "--") {
-      normalizedArgv.push(...aliasNormalized.slice(index));
+      normalizedArgv.push(...argv.slice(index));
       break;
     }
     const preserveCurrentToken = pathValueIndices.has(index);
@@ -734,9 +709,8 @@ function normalizeBootstrapInvocation(argv) {
     if (token.startsWith("--")) {
       const normalizedToken = normalizeLongOptionToken(token, lookup, preserveCurrentToken);
       normalizedArgv.push(...normalizedToken.tokens);
-      if (normalizedToken.event) {
+      if (normalizedToken.event)
         trace.push(normalizedToken.event);
-      }
       continue;
     }
     const bareKeyValue = parseBareKeyValueToken(token, preserveCurrentToken);
@@ -756,6 +730,24 @@ function normalizeBootstrapInvocation(argv) {
     }
     normalizedArgv.push(token);
   }
+  return normalizedArgv;
+}
+function normalizeBootstrapInvocation(argv) {
+  const trace = [];
+  const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);
+  if (legacyNormalized.length !== argv.length || legacyNormalized.some((token, index) => token !== argv[index])) {
+    trace.push({
+      from: argv.join(" "),
+      to: [...legacyNormalized],
+      reason: "legacy_extension_action",
+      confidence: "high"
+    });
+  }
+  const aliasNormalized = rewriteCommandAlias(legacyNormalized, trace);
+  const commandName = parseBootstrapCommandName(aliasNormalized);
+  const commandPathName = parseBootstrapCommandPathName(aliasNormalized);
+  const lookup = buildFlagLookup(commandPathName ?? commandName);
+  const normalizedArgv = normalizeBootstrapTokens(aliasNormalized, lookup, commandName, trace);
   const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(normalizedArgv, commandName, trace);
   const coalesced = coalesceRepeatedListFlags(linkedTestNormalized, lookup.listCanonicalFlags, GLOBAL_VALUE_CONSUMING_FLAGS, commandName === "create" ? /* @__PURE__ */ new Set(["--tags"]) : /* @__PURE__ */ new Set());
   for (const event of coalesced.events) {
@@ -860,6 +852,6 @@ export {
   applyInvocationAuthorOverride,
   createPmCliProgram
 };
-//# sourceMappingURL=chunk-FJIFFBJX.js.map
+//# sourceMappingURL=chunk-MROP2RNT.js.map
 
-//# debugId=39413a08-0b6f-5fb4-8e45-d039b2979e25
+//# debugId=50e62ca5-fc65-568e-b9ef-4b45850e4d6f

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../sdk/error-runtime.ts","../../../../../../../../sdk/cli-bootstrap.ts","../../../../../../../../sdk/invocation-author.ts","../../../../../../../../sdk/cli-program.ts"],"sourcesContent":["/**\n * @module sdk/error-runtime\n *\n * Provides presentation-independent normalization for values thrown through CLI and SDK runtimes.\n */\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\n\n/** Returns a stable message for errors and unknown thrown values. */\nexport function describeUnknownError(error: unknown): string {\n  if (error instanceof PmCliError) {\n    return error.message;\n  }\n  if (error instanceof Error) {\n    return error.message;\n  }\n  return \"Unknown failure\";\n}\n\n/** Reads a finite numeric exit code from an arbitrary thrown value. */\nexport function readThrownExitCode(error: unknown): number | undefined {\n  if (typeof error !== \"object\" || error === null || !(\"exitCode\" in error)) {\n    return undefined;\n  }\n  const exitCode = (error as { exitCode?: unknown }).exitCode;\n  return typeof exitCode === \"number\" && Number.isFinite(exitCode)\n    ? exitCode\n    : undefined;\n}\n\n/** Normalizes thrown exit codes to a positive integer failure status. */\nexport function normalizeThrownExitCode(exitCode: number): number {\n  const normalized = Math.trunc(exitCode);\n  return normalized > EXIT_CODE.SUCCESS\n    ? normalized\n    : EXIT_CODE.GENERIC_FAILURE;\n}\n\n/** Identifies errors emitted by Commander without importing its private classes. */\nexport function isCommanderError(error: unknown): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    typeof (error as { code?: unknown }).code === \"string\" &&\n    (error as { code: string }).code.startsWith(\"commander.\")\n  );\n}\n\n/** Converts non-Error thrown values into errors suitable for Sentry capture. */\nexport function wrapThrownErrorForSentry(\n  error: unknown,\n  message: string,\n): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n  const wrapped = new Error(message) as Error & { exitCode?: number };\n  const exitCode = readThrownExitCode(error);\n  /* c8 ignore next */\n  if (exitCode !== undefined) {\n    wrapped.exitCode = normalizeThrownExitCode(exitCode);\n  }\n  return wrapped;\n}\n","/**\n * @module sdk/cli-bootstrap\n *\n * Provides public bootstrap argument normalization for embedded CLI hosts.\n */\nimport {\n  EXECUTABLE_COMMAND_ALIASES,\n  resolveSubcommandFlagContractsForCommand,\n  type CliFlagContract,\n} from \"./cli-contracts.js\";\nexport { EXECUTABLE_COMMAND_ALIASES };\nimport { levenshteinDistanceWithinLimit } from \"../core/shared/levenshtein.js\";\n\nconst GLOBAL_VALUE_CONSUMING_FLAGS = new Set<string>([\n  \"--pm-path\",\n  \"--path\",\n  \"--author\",\n]);\n\n/** Whether a global value-consuming flag uses its inline `--flag=value` form. */\nconst isInlineGlobalValueToken = (token: string): boolean => {\n  const equalsIndex = token.indexOf(\"=\");\n  return (\n    equalsIndex > 0 &&\n    GLOBAL_VALUE_CONSUMING_FLAGS.has(token.slice(0, equalsIndex))\n  );\n};\n\n/** Whether optional bootstrap author syntax consumes the following token. */\nconst consumesBootstrapAuthorValue = (next: string | undefined): boolean => {\n  return typeof next === \"string\" && !next.startsWith(\"-\");\n};\n\nfunction parseBootstrapPathToken(\n  token: string,\n  next: string | undefined,\n): { consumed: number; pathValue?: string; preferred: boolean } | null {\n  if (token === \"--path\" || token === \"--pm-path\") {\n    if (typeof next === \"string\" && next.length > 0) {\n      return {\n        consumed: 2,\n        pathValue: next,\n        preferred: token === \"--pm-path\",\n      };\n    }\n    return {\n      consumed: 1,\n      preferred: token === \"--pm-path\",\n    };\n  }\n\n  const inlinePrefix = token.startsWith(\"--path=\")\n    ? \"--path=\"\n    : token.startsWith(\"--pm-path=\")\n      ? \"--pm-path=\"\n      : undefined;\n  if (!inlinePrefix) {\n    return null;\n  }\n\n  const value = token.slice(inlinePrefix.length);\n  if (value.length > 0) {\n    return {\n      consumed: 1,\n      pathValue: value,\n      preferred: inlinePrefix === \"--pm-path=\",\n    };\n  }\n  return {\n    consumed: 1,\n    preferred: inlinePrefix === \"--pm-path=\",\n  };\n}\n\n/** Documents the bootstrap global options payload exchanged by command, SDK, and package integrations. */\nexport interface BootstrapGlobalOptions {\n  /** Filesystem path used for path resolution. */\n  path?: string;\n  /** Value that configures or reports no extensions for this contract. */\n  noExtensions: boolean;\n  /** Value that configures or reports no pager for this contract. */\n  noPager: boolean;\n  /** Value that configures or reports json for this contract. */\n  json: boolean;\n  /** Value that configures or reports quiet for this contract. */\n  quiet: boolean;\n  /** Whether compact JSON projection is requested. */\n  lean: boolean;\n  /** Invocation-wide mutation author override. */\n  author?: string;\n  /** Whether `--author` was present without its required value. */\n  authorMissingValue?: true;\n}\n\nconst BOOTSTRAP_BOOLEAN_FLAGS = new Set([\n  \"--no-extensions\",\n  \"--no-pager\",\n  \"--json\",\n  \"--quiet\",\n  \"--lean\",\n]);\n\ninterface BootstrapGlobalParseState {\n  /** Last legacy `--path` value. */\n  legacyPathValue?: string;\n  /** Last preferred `--pm-path` value. */\n  pmPathValue?: string;\n  /** Boolean global flags observed before the command terminator. */\n  booleanFlags: Set<string>;\n  /** Author value, with an empty string marking a missing value. */\n  author?: string;\n}\n\n/** Consume one bootstrap-global token and update the accumulated parse state. */\nfunction consumeBootstrapGlobalToken(\n  argv: string[],\n  index: number,\n  state: BootstrapGlobalParseState,\n): number {\n  const token = argv[index];\n  if (BOOTSTRAP_BOOLEAN_FLAGS.has(token)) {\n    state.booleanFlags.add(token);\n    return 1;\n  }\n  const parsedPath = parseBootstrapPathToken(token, argv[index + 1]);\n  if (parsedPath) {\n    if (parsedPath.pathValue !== undefined) {\n      if (parsedPath.preferred) state.pmPathValue = parsedPath.pathValue;\n      else state.legacyPathValue = parsedPath.pathValue;\n    }\n    return parsedPath.consumed;\n  }\n  if (token === \"--author\") {\n    const consumesValue = consumesBootstrapAuthorValue(argv[index + 1]);\n    state.author = consumesValue ? argv[index + 1] : \"\";\n    return consumesValue ? 2 : 1;\n  }\n  if (token.startsWith(\"--author=\")) {\n    state.author = token.slice(\"--author=\".length);\n  }\n  return 1;\n}\n\n/** Implements parse bootstrap global options for the public runtime surface of this module. */\nexport function parseBootstrapGlobalOptions(\n  argv: string[],\n): BootstrapGlobalOptions {\n  const state: BootstrapGlobalParseState = { booleanFlags: new Set() };\n  let index = 0;\n  while (index < argv.length) {\n    if (argv[index] === \"--\") break;\n    index += consumeBootstrapGlobalToken(argv, index, state);\n  }\n  return {\n    path: state.pmPathValue ?? state.legacyPathValue,\n    noExtensions: state.booleanFlags.has(\"--no-extensions\"),\n    noPager: state.booleanFlags.has(\"--no-pager\"),\n    json: state.booleanFlags.has(\"--json\"),\n    quiet: state.booleanFlags.has(\"--quiet\"),\n    lean: state.booleanFlags.has(\"--lean\"),\n    ...(state.author === \"\"\n      ? { authorMissingValue: true }\n      : state.author !== undefined\n        ? { author: state.author }\n        : {}),\n  };\n}\n\n/** Implements strip global bootstrap tokens for the public runtime surface of this module. */\nexport function stripGlobalBootstrapTokens(argv: string[]): string[] {\n  const remaining: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--lean\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--id-only\" ||\n      token === \"--full-changed-fields\" ||\n      token === \"--explain\"\n    ) {\n      index += 1;\n      continue;\n    }\n    if (token === \"--author\") {\n      index += consumesBootstrapAuthorValue(argv[index + 1]) ? 2 : 1;\n      continue;\n    }\n    if (GLOBAL_VALUE_CONSUMING_FLAGS.has(token)) {\n      index += 2;\n      continue;\n    }\n    if (isInlineGlobalValueToken(token)) {\n      index += 1;\n      continue;\n    }\n    remaining.push(token);\n    index += 1;\n  }\n  return remaining;\n}\n\n/** Documents the bootstrap help request payload exchanged by command, SDK, and package integrations. */\nexport interface BootstrapHelpRequest {\n  /** Value that configures or reports requested for this contract. */\n  requested: boolean;\n  /** Value that configures or reports command path tokens for this contract. */\n  commandPathTokens: string[];\n}\n\n/** Implements parse bootstrap help request for the public runtime surface of this module. */\nexport function parseBootstrapHelpRequest(\n  argv: string[],\n): BootstrapHelpRequest {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  if (first === \"help\") {\n    const commandPathTokens: string[] = [];\n    for (let index = 1; index < stripped.length; index += 1) {\n      const token = stripped[index];\n      if (token.startsWith(\"-\")) {\n        break;\n      }\n      commandPathTokens.push(token.trim().toLowerCase());\n    }\n    return {\n      requested: true,\n      commandPathTokens,\n    };\n  }\n\n  const helpFlagIndex = stripped.findIndex(\n    (token) => token === \"--help\" || token === \"-h\",\n  );\n  if (helpFlagIndex < 0) {\n    return {\n      requested: false,\n      commandPathTokens: [],\n    };\n  }\n\n  const commandPathTokens: string[] = [];\n  for (const token of stripped) {\n    if (token.startsWith(\"-\")) {\n      break;\n    }\n    commandPathTokens.push(token.trim().toLowerCase());\n  }\n  return {\n    requested: true,\n    commandPathTokens,\n  };\n}\n\n/**\n * Index of the command token in argv — the first non-flag token, skipping the\n * value-consuming/global bootstrap flags. Returns undefined when there is none\n * (bare invocation, only global flags, or a leading `--`). Single source of truth\n * for command-position scanning shared by {@link parseBootstrapCommandName} and the\n * command-alias rewrite so their precedence rules can never drift apart.\n */\nfunction findCommandTokenIndex(argv: string[]): number | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--\") {\n      return undefined;\n    }\n    if (token === \"--author\") {\n      index += consumesBootstrapAuthorValue(argv[index + 1]) ? 1 : 0;\n      continue;\n    }\n    if (GLOBAL_VALUE_CONSUMING_FLAGS.has(token)) {\n      index += 1;\n      continue;\n    }\n    if (\n      isInlineGlobalValueToken(token) ||\n      token === \"--json\" ||\n      token === \"--quiet\" ||\n      token === \"--lean\" ||\n      token === \"--no-extensions\" ||\n      token === \"--no-pager\" ||\n      token === \"--profile\" ||\n      token === \"--id-only\" ||\n      token === \"--explain\"\n    ) {\n      continue;\n    }\n    if (token.startsWith(\"-\")) {\n      continue;\n    }\n    return index;\n  }\n  return undefined;\n}\n\n/** Implements parse bootstrap command name for the public runtime surface of this module. */\nexport function parseBootstrapCommandName(argv: string[]): string | undefined {\n  const index = findCommandTokenIndex(argv);\n  return index === undefined ? undefined : argv[index].trim().toLowerCase();\n}\n\nfunction shouldDisablePagerForInvocation(\n  argv: string[],\n  bootstrapGlobal: BootstrapGlobalOptions,\n): boolean {\n  if (bootstrapGlobal.noPager) {\n    return true;\n  }\n  if (process.stdout.isTTY === true) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  return helpRequest.requested;\n}\n\n/** Implements apply bootstrap pager policy for the public runtime surface of this module. */\nexport function applyBootstrapPagerPolicy(argv: string[]): () => void {\n  const pagerEnvironmentKeys = [\n    \"PAGER\",\n    \"MANPAGER\",\n    \"GIT_PAGER\",\n    \"LESS\",\n  ] as const;\n  const previousValues = pagerEnvironmentKeys.map((key) => process.env[key]);\n  const restore = (): void => {\n    for (const [index, key] of pagerEnvironmentKeys.entries()) {\n      const value = previousValues[index];\n      if (value === undefined) {\n        delete process.env[key];\n      } else {\n        process.env[key] = value;\n      }\n    }\n  };\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!shouldDisablePagerForInvocation(argv, bootstrapGlobal)) {\n    return restore;\n  }\n  process.env.PAGER = \"cat\";\n  process.env.MANPAGER = \"cat\";\n  process.env.GIT_PAGER = \"cat\";\n  if (\n    typeof process.env.LESS !== \"string\" ||\n    process.env.LESS.trim().length === 0\n  ) {\n    process.env.LESS = \"FRX\";\n  }\n  return restore;\n}\n\ntype ExtensionSubcommandAction =\n  | \"init\"\n  | \"install\"\n  | \"uninstall\"\n  | \"explore\"\n  | \"manage\"\n  | \"doctor\"\n  | \"adopt\"\n  | \"adopt-all\"\n  | \"activate\"\n  | \"deactivate\";\n\nconst EXTENSION_ACTION_SYNTAX_TOKENS = new Set<ExtensionSubcommandAction>([\n  \"install\",\n  \"uninstall\",\n  \"explore\",\n  \"manage\",\n  \"doctor\",\n  \"adopt\",\n  \"adopt-all\",\n  \"activate\",\n  \"deactivate\",\n]);\n\n/** Implements normalize legacy extension action syntax for the public runtime surface of this module. */\nexport function normalizeLegacyExtensionActionSyntax(argv: string[]): string[] {\n  const extensionIndex = findCommandTokenIndex(argv);\n  if (extensionIndex === undefined || argv[extensionIndex] !== \"extension\") {\n    return [...argv];\n  }\n  const actionToken = argv[extensionIndex + 1];\n  if (!actionToken || actionToken.startsWith(\"-\")) {\n    return [...argv];\n  }\n  if (\n    !EXTENSION_ACTION_SYNTAX_TOKENS.has(\n      actionToken as ExtensionSubcommandAction,\n    )\n  ) {\n    return [...argv];\n  }\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return [...argv];\n  }\n  const forcedActionFlag = `--${actionToken}`;\n  if (argv.includes(forcedActionFlag)) {\n    return [...argv];\n  }\n  return [\n    ...argv.slice(0, extensionIndex + 1),\n    forcedActionFlag,\n    ...argv.slice(extensionIndex + 2),\n  ];\n}\n\ntype BootstrapNormalizationReason =\n  | \"legacy_extension_action\"\n  | \"command_alias\"\n  | \"flag_alias\"\n  | \"flag_typo\"\n  | \"bare_key_value\"\n  | \"list_merge\";\ntype BootstrapNormalizationConfidence = \"high\" | \"medium\";\n\n/** Executable command aliases: a leading command token here is rewritten to its canonical command BEFORE commander parses, so the alias actually runs instead of merely being suggested. These are the highest-frequency aliases real agents type (telemetry: `pm show <id>` alone is the single most common unknown-command) and each target takes the same positional/flags as the alias (with `--comment`/ `--note`/`--learning` flag-aliased to `--add` on the target command). Keeping this in one place means the alias is consistent across registration, commander dispatch, telemetry, and error handling — all of which read the normalized argv. */\n/**\n * Rewrite a leading command-alias token (e.g. `show` -> `get`) in place. Only the\n * command position is considered — the same token appearing later as an argument\n * (`pm get show`) is left untouched — and only when it is not preceded by `--` or a\n * value-consuming global flag, mirroring {@link parseBootstrapCommandName}.\n */\nfunction rewriteCommandAlias(\n  argv: string[],\n  trace: BootstrapNormalizationEvent[],\n): string[] {\n  const index = findCommandTokenIndex(argv);\n  if (index === undefined) {\n    return argv;\n  }\n  const token = argv[index];\n  const canonical = EXECUTABLE_COMMAND_ALIASES[token.trim().toLowerCase()];\n  if (!canonical) {\n    return argv;\n  }\n  const rewritten = [...argv];\n  rewritten[index] = canonical;\n  trace.push({\n    from: token,\n    to: [canonical],\n    reason: \"command_alias\",\n    confidence: \"high\",\n  });\n  return rewritten;\n}\n\n/** Documents the bootstrap normalization event payload exchanged by command, SDK, and package integrations. */\nexport interface BootstrapNormalizationEvent {\n  /** Value that configures or reports from for this contract. */\n  from: string;\n  /** Value that configures or reports to for this contract. */\n  to: string[];\n  /** Value that configures or reports reason for this contract. */\n  reason: BootstrapNormalizationReason;\n  /** Value that configures or reports confidence for this contract. */\n  confidence: BootstrapNormalizationConfidence;\n}\n\n/** Documents the bootstrap invocation normalization result payload exchanged by command, SDK, and package integrations. */\nexport interface BootstrapInvocationNormalizationResult {\n  /** Value that configures or reports argv for this contract. */\n  argv: string[];\n  /** Value that configures or reports command name for this contract. */\n  commandName: string | undefined;\n  /** Value that configures or reports trace for this contract. */\n  trace: BootstrapNormalizationEvent[];\n}\n\ninterface FlagLookup {\n  canonicalByNormalized: Map<string, string | null>;\n  canonicalByCompact: Map<string, string | null>;\n  canonicalComparables: Array<{ canonicalFlag: string; comparable: string }>;\n  listCanonicalFlags: Set<string>;\n}\n\nfunction normalizeFlagKeyToken(raw: string): string {\n  const withoutPrefix = raw.replace(/^--?/, \"\");\n  return withoutPrefix\n    .replace(/_/g, \"-\")\n    .replace(/([a-z0-9])([A-Z])/g, \"$1-$2\")\n    .toLowerCase();\n}\n\nfunction toComparableFlagKey(raw: string): string {\n  return normalizeFlagKeyToken(raw).replace(/-/g, \"\");\n}\n\nfunction markUnambiguousFlag(\n  map: Map<string, string | null>,\n  key: string,\n  canonicalFlag: string,\n): void {\n  const existing = map.get(key);\n  if (existing === undefined) {\n    map.set(key, canonicalFlag);\n    return;\n  }\n  if (existing !== canonicalFlag) {\n    map.set(key, null);\n  }\n}\n\nfunction collectLongFlagCandidates(contract: CliFlagContract): string[] {\n  const candidates: string[] = [];\n  const pushLongFlag = (value: string | undefined): void => {\n    if (typeof value !== \"string\") {\n      return;\n    }\n    if (!value.startsWith(\"--\")) {\n      return;\n    }\n    candidates.push(value);\n  };\n  pushLongFlag(contract.flag);\n  for (const alias of contract.aliases ?? []) {\n    pushLongFlag(alias);\n  }\n  return candidates;\n}\n\nfunction buildFlagLookup(\n  commandName: string | undefined,\n  contractsOverride?: CliFlagContract[],\n): FlagLookup {\n  const contracts =\n    contractsOverride ?? resolveSubcommandFlagContractsForCommand(commandName);\n  const canonicalByNormalized = new Map<string, string | null>();\n  const canonicalByCompact = new Map<string, string | null>();\n  const canonicalComparablesMap = new Map<string, string>();\n  const listCanonicalFlags = new Set<string>();\n  for (const contract of contracts) {\n    const longCandidates = collectLongFlagCandidates(contract);\n    if (longCandidates.length === 0) {\n      continue;\n    }\n    const canonicalFlag = `--${normalizeFlagKeyToken(longCandidates[0])}`;\n    for (const candidate of longCandidates) {\n      markUnambiguousFlag(\n        canonicalByNormalized,\n        normalizeFlagKeyToken(candidate),\n        canonicalFlag,\n      );\n      markUnambiguousFlag(\n        canonicalByCompact,\n        toComparableFlagKey(candidate),\n        canonicalFlag,\n      );\n    }\n    const comparable = toComparableFlagKey(canonicalFlag);\n    if (!canonicalComparablesMap.has(canonicalFlag)) {\n      canonicalComparablesMap.set(canonicalFlag, comparable);\n    }\n    if (contract.list === true) {\n      listCanonicalFlags.add(canonicalFlag);\n    }\n  }\n  return {\n    canonicalByNormalized,\n    canonicalByCompact,\n    canonicalComparables: [...canonicalComparablesMap.entries()].map(\n      ([canonicalFlag, comparable]) => ({\n        canonicalFlag,\n        comparable,\n      }),\n    ),\n    listCanonicalFlags,\n  };\n}\n\nfunction resolveCanonicalFlag(\n  rawKey: string,\n  lookup: FlagLookup,\n): {\n  flag: string;\n  reason: \"flag_alias\" | \"flag_typo\";\n  confidence: BootstrapNormalizationConfidence;\n} | null {\n  const normalizedKey = normalizeFlagKeyToken(rawKey);\n  const direct = lookup.canonicalByNormalized.get(normalizedKey);\n  if (typeof direct === \"string\") {\n    return {\n      flag: direct,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const comparableKey = normalizedKey.replace(/-/g, \"\");\n  const compactMatch = lookup.canonicalByCompact.get(comparableKey);\n  if (typeof compactMatch === \"string\") {\n    return {\n      flag: compactMatch,\n      reason: \"flag_alias\",\n      confidence: \"high\",\n    };\n  }\n  const maxDistance = comparableKey.length >= 8 ? 2 : 1;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  let bestFlag: string | undefined;\n  let tied = false;\n  for (const candidate of lookup.canonicalComparables) {\n    const distance = levenshteinDistanceWithinLimit(\n      comparableKey,\n      candidate.comparable,\n      maxDistance,\n    );\n    if (distance === null) {\n      continue;\n    }\n    if (distance < bestDistance) {\n      bestDistance = distance;\n      bestFlag = candidate.canonicalFlag;\n      tied = false;\n      continue;\n    }\n    if (distance === bestDistance && bestFlag !== candidate.canonicalFlag) {\n      tied = true;\n    }\n  }\n  if (\n    !bestFlag ||\n    tied ||\n    !Number.isFinite(bestDistance) ||\n    bestDistance <= 0\n  ) {\n    return null;\n  }\n  return {\n    flag: bestFlag,\n    reason: \"flag_typo\",\n    confidence: bestDistance >= 2 ? \"medium\" : \"high\",\n  };\n}\n\n/** Implements list alias plural keys for the public runtime surface of this module. */\nexport function listAliasPluralKeys(normalizedKey: string): string[] {\n  const candidates = [`${normalizedKey}s`];\n  if (normalizedKey.endsWith(\"y\") && normalizedKey.length > 1) {\n    candidates.push(`${normalizedKey.slice(0, -1)}ies`);\n  }\n  return candidates;\n}\n\nfunction parseBareKeyValueToken(\n  token: string,\n  preserve = false,\n): { key: string; value: string } | null {\n  if (preserve || token.includes(\"://\")) {\n    return null;\n  }\n  const match = token.match(/^([A-Za-z][A-Za-z0-9_-]{1,63})([:=])(.*)$/);\n  if (!match) {\n    return null;\n  }\n  const key = match[1];\n  const value = match[3];\n  if (value.length === 0) {\n    return null;\n  }\n  return {\n    key,\n    value,\n  };\n}\n\nfunction normalizeLongOptionToken(\n  token: string,\n  lookup: FlagLookup,\n  preserve = false,\n): { tokens: string[]; event?: BootstrapNormalizationEvent } {\n  if (preserve || !token.startsWith(\"--\")) {\n    return { tokens: [token] };\n  }\n  const equalsIndex = token.indexOf(\"=\");\n  const key = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;\n  const inlineValue =\n    equalsIndex >= 0 ? token.slice(equalsIndex + 1) : undefined;\n  const resolution = resolveCanonicalFlag(key, lookup);\n  if (!resolution) {\n    return { tokens: [token] };\n  }\n  const normalizedToken =\n    inlineValue === undefined\n      ? resolution.flag\n      : `${resolution.flag}=${inlineValue}`;\n  if (normalizedToken === token) {\n    return { tokens: [token] };\n  }\n  return {\n    tokens: [normalizedToken],\n    event: {\n      from: token,\n      to: [normalizedToken],\n      reason: resolution.reason,\n      confidence: resolution.confidence,\n    },\n  };\n}\n\n/** Locate global path-value tokens that normalization must preserve literally. */\nfunction collectBootstrapPathValueIndices(argv: string[]): Set<number> {\n  const indices = new Set<number>();\n  let expectsValue = false;\n  for (let index = 0; index < argv.length; index += 1) {\n    if (expectsValue) {\n      indices.add(index);\n      expectsValue = false;\n      continue;\n    }\n    const token = argv[index];\n    expectsValue = token === \"--path\" || token === \"--pm-path\";\n  }\n  return indices;\n}\n\n// Global option flags whose value may legitimately begin with \"--\" (commander\n// accepts such values). Their value token must not be reinterpreted as a list\n// flag during coalescing. `--pm-path <dir>` and its legacy `--path <dir>`\n// alias are the documented cases; other globals\n// (--json/--quiet/--no-extensions/--no-pager/--profile) are boolean.\nfunction splitCanonicalListToken(\n  token: string,\n): { flag: string; inlineValue?: string } | null {\n  if (!token.startsWith(\"--\")) {\n    return null;\n  }\n  const equalsIndex = token.indexOf(\"=\");\n  if (equalsIndex < 0) {\n    return { flag: token };\n  }\n  return {\n    flag: token.slice(0, equalsIndex),\n    inlineValue: token.slice(equalsIndex + 1),\n  };\n}\n\ninterface ListFlagSlot {\n  outputIndex: number;\n  originalTokens: string[];\n  values: string[];\n  occurrences: number;\n}\n\ninterface ListFlagOccurrence {\n  originalTokens: string[];\n  value: string | undefined;\n  consumed: number;\n}\n\ninterface ValuedListFlagOccurrence {\n  originalTokens: string[];\n  value: string;\n}\n\nfunction copyValueConsumingFlag(\n  argv: string[],\n  index: number,\n  result: (string | null)[],\n): number {\n  result.push(argv[index]);\n  const next = argv[index + 1];\n  if (typeof next === \"string\" && next !== \"--\") {\n    result.push(next);\n    return index + 2;\n  }\n  return index + 1;\n}\n\nfunction readListFlagOccurrence(\n  argv: string[],\n  index: number,\n  parsed: { flag: string; inlineValue?: string },\n  multiValueListFlags: Set<string>,\n): ListFlagOccurrence {\n  if (parsed.inlineValue !== undefined) {\n    return {\n      originalTokens: [argv[index]],\n      value: parsed.inlineValue,\n      consumed: 1,\n    };\n  }\n\n  const values: string[] = [];\n  let valueIndex = index + 1;\n  while (\n    valueIndex < argv.length &&\n    argv[valueIndex] !== \"--\" &&\n    !argv[valueIndex].startsWith(\"-\") &&\n    (values.length === 0 || multiValueListFlags.has(parsed.flag))\n  ) {\n    values.push(argv[valueIndex]);\n    valueIndex += 1;\n  }\n\n  const consumed = values.length === 0 ? 1 : 1 + values.length;\n  return {\n    originalTokens: argv.slice(index, index + consumed),\n    value: values.length === 0 ? undefined : values.join(\",\"),\n    consumed,\n  };\n}\n\nfunction recordListFlagOccurrence(\n  slots: Map<string, ListFlagSlot>,\n  result: (string | null)[],\n  flag: string,\n  occurrence: ValuedListFlagOccurrence,\n): void {\n  const existing = slots.get(flag);\n  if (existing) {\n    existing.values.push(occurrence.value);\n    existing.occurrences += 1;\n    return;\n  }\n\n  slots.set(flag, {\n    outputIndex: result.length,\n    originalTokens: occurrence.originalTokens,\n    values: [occurrence.value],\n    occurrences: 1,\n  });\n  // Reserve the anchor position; finalized after the walk so we know the full\n  // merged value or can restore the original token form for single uses.\n  result.push(null);\n}\n\nfunction buildListFlagCoalescingSplices(\n  slots: Map<string, ListFlagSlot>,\n  multiValueListFlags: Set<string>,\n): {\n  events: BootstrapNormalizationEvent[];\n  splices: Array<{ outputIndex: number; tokens: string[] }>;\n} {\n  const events: BootstrapNormalizationEvent[] = [];\n  const splices: Array<{ outputIndex: number; tokens: string[] }> = [];\n  for (const [flag, slot] of slots) {\n    const shouldMerge =\n      slot.occurrences >= 2 ||\n      (multiValueListFlags.has(flag) && slot.originalTokens.length > 2);\n    if (!shouldMerge) {\n      splices.push({\n        outputIndex: slot.outputIndex,\n        tokens: slot.originalTokens,\n      });\n      continue;\n    }\n    const mergedToken = `${flag}=${slot.values.join(\",\")}`;\n    splices.push({ outputIndex: slot.outputIndex, tokens: [mergedToken] });\n    events.push({\n      from: `${flag} (x${slot.occurrences})`,\n      to: [mergedToken],\n      reason: \"list_merge\",\n      confidence: \"high\",\n    });\n  }\n  return { events, splices };\n}\n\nfunction applyListFlagSplices(\n  result: (string | null)[],\n  splices: Array<{ outputIndex: number; tokens: string[] }>,\n): void {\n  splices.sort((a, b) => b.outputIndex - a.outputIndex);\n  for (const splice of splices) {\n    result.splice(splice.outputIndex, 1, ...splice.tokens);\n  }\n}\n\n/**\n * Coalesce repeated occurrences of comma-separated list flags into a single\n * `--flag=v1,v2,v3` token anchored at the FIRST occurrence. Without this,\n * Commander treats these flags as scalars and silently keeps only the last\n * value (data loss). Both `--flag value` and `--flag=value` forms are merged;\n * a value-less occurrence is preserved untouched, and a `--` terminator stops\n * coalescing (remainder is passed through verbatim).\n *\n * `valueConsumingFlags` lists option flags (e.g. global `--pm-path`) whose value\n * may itself begin with `--`. Their value token is emitted verbatim so a\n * list-flag-looking value (`--path --tags`) is never reinterpreted as a flag\n * nor allowed to swallow the following command/positional token.\n */\nexport function coalesceRepeatedListFlags(\n  argv: string[],\n  listFlags: Set<string>,\n  valueConsumingFlags: Set<string> = new Set(),\n  multiValueListFlags: Set<string> = new Set(),\n): { argv: string[]; events: BootstrapNormalizationEvent[] } {\n  if (listFlags.size === 0) {\n    return { argv: [...argv], events: [] };\n  }\n\n  const result: (string | null)[] = [];\n  const slots = new Map<string, ListFlagSlot>();\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      result.push(...argv.slice(index));\n      break;\n    }\n    // A value-consuming option in space form owns the next token as its value,\n    // even when that value begins with \"--\". Emit both verbatim so the value is\n    // never misread as a list-flag occurrence.\n    if (valueConsumingFlags.has(token)) {\n      index = copyValueConsumingFlag(argv, index, result);\n      continue;\n    }\n    const parsed = splitCanonicalListToken(token);\n    if (!parsed || !listFlags.has(parsed.flag)) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n\n    const occurrence = readListFlagOccurrence(\n      argv,\n      index,\n      parsed,\n      multiValueListFlags,\n    );\n    if (occurrence.value === undefined) {\n      // Value-less occurrence: leave untouched, do not coalesce.\n      result.push(token);\n      index += occurrence.consumed;\n      continue;\n    }\n\n    recordListFlagOccurrence(slots, result, parsed.flag, {\n      originalTokens: occurrence.originalTokens,\n      value: occurrence.value,\n    });\n    index += occurrence.consumed;\n  }\n\n  // Apply anchor splices from the end so earlier indices stay valid when a\n  // single-occurrence anchor expands back into two tokens.\n  const { events, splices } = buildListFlagCoalescingSplices(\n    slots,\n    multiValueListFlags,\n  );\n  applyListFlagSplices(result, splices);\n\n  return { argv: result as string[], events };\n}\n\n/** Linked-test entry keys accepted in the two-token form `pm test <id> --add command \"npm test -- parser\"` (GH-191). Only entry-identity keys are merged: `command`/`cmd` name the shell command and `path` names the test file, so a single key=value entry is meaningful for them. Other structured keys (scope, env_set, assertions, ...) cannot form a valid standalone entry and are left for the normal parser to reject. `--remove` matches existing entries by `command=`/`path=` only, so `cmd` is excluded there. Key names mirror STRUCTURED_LINKED_TEST_KEYS in src/cli/commands/linked-test-entry.ts. */\nconst LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG: ReadonlyMap<\n  string,\n  ReadonlySet<string>\n> = new Map([\n  [\"--add\", new Set([\"command\", \"cmd\", \"path\"])],\n  [\"--remove\", new Set([\"command\", \"path\"])],\n]);\n\n/** Sandbox-safe linked-test commands legitimately start with env assignments (`PM_PATH=... PM_GLOBAL_PATH=... vitest run -- parser`), which look like bare key=value settings tokens. When the two preceding tokens are a linked-test flag plus a bare two-token key (`--add command <value>`), the value must be left intact for mergeLinkedTestTwoTokenEntries instead of being rewritten into a canonical flag (e.g. PM_PATH= -> --pm-path), which would silently corrupt the command into `--add command --pm-path ...`. */\nfunction isLinkedTestTwoTokenValuePosition(\n  commandName: string | undefined,\n  emittedTokens: readonly string[],\n): boolean {\n  if (commandName !== \"test\" || emittedTokens.length < 2) {\n    return false;\n  }\n  const key = emittedTokens[emittedTokens.length - 1];\n  const flag = emittedTokens[emittedTokens.length - 2];\n  const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(flag);\n  return keys !== undefined && keys.has(key);\n}\n\nfunction shouldPreserveBareKeyValueToken(\n  commandName: string | undefined,\n  emittedTokens: readonly string[],\n): boolean {\n  return (\n    commandName === \"search\" ||\n    isLinkedTestTwoTokenValuePosition(commandName, emittedTokens)\n  );\n}\n\n/** Accept the two-token linked-test form `pm test <id> --add command \"npm test -- parser\"` by merging the bare key token and its single quoted value into the documented `--add command=...` shape. Without this merge Commander binds the bare key as the option value and treats the quoted command as an excess positional, failing with \"too many arguments\" (GH-191). The merge only fires when EXACTLY ONE non-flag token follows the bare key, i.e. the value was quoted into one shell token — an unquoted multi-token value stays ambiguous (it may swallow the item id), still fails fast, and is routed to targeted quoting guidance by the commander error classifier instead. */\nexport function mergeLinkedTestTwoTokenEntries(\n  argv: string[],\n  commandName: string | undefined,\n  trace: BootstrapNormalizationEvent[],\n): string[] {\n  if (commandName !== \"test\") {\n    return argv;\n  }\n  const result: string[] = [];\n  let index = 0;\n  while (index < argv.length) {\n    const token = argv[index];\n    if (token === \"--\") {\n      result.push(...argv.slice(index));\n      return result;\n    }\n    const keys = LINKED_TEST_TWO_TOKEN_KEYS_BY_FLAG.get(token);\n    const key = keys ? argv[index + 1] : undefined;\n    if (!keys || typeof key !== \"string\" || !keys.has(key)) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n    let runEnd = index + 2;\n    while (runEnd < argv.length && !argv[runEnd].startsWith(\"-\")) {\n      runEnd += 1;\n    }\n    if (runEnd - (index + 2) !== 1) {\n      result.push(token);\n      index += 1;\n      continue;\n    }\n    const value = argv[index + 2];\n    const mergedValue = `${key}=${value}`;\n    result.push(token, mergedValue);\n    trace.push({\n      from: `${token} ${key} ${value}`,\n      to: [token, mergedValue],\n      reason: \"bare_key_value\",\n      confidence: \"high\",\n    });\n    index += 3;\n  }\n  return result;\n}\n\n/** Normalize option spellings and bare key-value tokens before list coalescing. */\nfunction normalizeBootstrapTokens(\n  argv: string[],\n  lookup: FlagLookup,\n  commandName: string | undefined,\n  trace: BootstrapNormalizationEvent[],\n): string[] {\n  const normalizedArgv: string[] = [];\n  const pathValueIndices = collectBootstrapPathValueIndices(argv);\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--\") {\n      normalizedArgv.push(...argv.slice(index));\n      break;\n    }\n    const preserveCurrentToken = pathValueIndices.has(index);\n    const previous = normalizedArgv[normalizedArgv.length - 1];\n    if (token.startsWith(\"--\")) {\n      const normalizedToken = normalizeLongOptionToken(\n        token,\n        lookup,\n        preserveCurrentToken,\n      );\n      normalizedArgv.push(...normalizedToken.tokens);\n      if (normalizedToken.event) trace.push(normalizedToken.event);\n      continue;\n    }\n    const bareKeyValue = parseBareKeyValueToken(token, preserveCurrentToken);\n    if (\n      bareKeyValue &&\n      !(typeof previous === \"string\" && previous.startsWith(\"-\")) &&\n      !shouldPreserveBareKeyValueToken(commandName, normalizedArgv)\n    ) {\n      const resolution = resolveCanonicalFlag(bareKeyValue.key, lookup);\n      if (resolution) {\n        const replacement = [resolution.flag, bareKeyValue.value];\n        normalizedArgv.push(...replacement);\n        trace.push({\n          from: token,\n          to: replacement,\n          reason: \"bare_key_value\",\n          confidence: resolution.confidence,\n        });\n        continue;\n      }\n    }\n    normalizedArgv.push(token);\n  }\n  return normalizedArgv;\n}\n\n/** Implements normalize bootstrap invocation for the public runtime surface of this module. */\nexport function normalizeBootstrapInvocation(\n  argv: string[],\n): BootstrapInvocationNormalizationResult {\n  const trace: BootstrapNormalizationEvent[] = [];\n  const legacyNormalized = normalizeLegacyExtensionActionSyntax(argv);\n  if (\n    legacyNormalized.length !== argv.length ||\n    legacyNormalized.some((token, index) => token !== argv[index])\n  ) {\n    trace.push({\n      from: argv.join(\" \"),\n      to: [...legacyNormalized],\n      reason: \"legacy_extension_action\",\n      confidence: \"high\",\n    });\n  }\n  const aliasNormalized = rewriteCommandAlias(legacyNormalized, trace);\n  const commandName = parseBootstrapCommandName(aliasNormalized);\n  const commandPathName = parseBootstrapCommandPathName(aliasNormalized);\n  const lookup = buildFlagLookup(commandPathName ?? commandName);\n  const normalizedArgv = normalizeBootstrapTokens(\n    aliasNormalized,\n    lookup,\n    commandName,\n    trace,\n  );\n  const linkedTestNormalized = mergeLinkedTestTwoTokenEntries(\n    normalizedArgv,\n    commandName,\n    trace,\n  );\n  const coalesced = coalesceRepeatedListFlags(\n    linkedTestNormalized,\n    lookup.listCanonicalFlags,\n    GLOBAL_VALUE_CONSUMING_FLAGS,\n    commandName === \"create\" ? new Set([\"--tags\"]) : new Set(),\n  );\n  for (const event of coalesced.events) {\n    trace.push(event);\n  }\n  return {\n    argv: coalesced.argv,\n    commandName,\n    trace,\n  };\n}\n\nfunction parseBootstrapCommandPathName(argv: string[]): string | undefined {\n  const stripped = stripGlobalBootstrapTokens(argv);\n  const first = stripped[0]?.trim().toLowerCase();\n  const second = stripped[1]?.trim().toLowerCase();\n  if (\n    (first === \"extension\" || first === \"package\" || first === \"packages\") &&\n    typeof second === \"string\" &&\n    second.length > 0 &&\n    !second.startsWith(\"-\")\n  ) {\n    return `${first} ${second}`;\n  }\n  return first;\n}\n\n/** Implements parse bootstrap type value for the public runtime surface of this module. */\nexport function parseBootstrapTypeValue(argv: string[]): string | undefined {\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n    if (token === \"--\") {\n      break;\n    }\n    if (token === \"--type\") {\n      const candidate = argv[index + 1];\n      if (typeof candidate === \"string\" && candidate.trim().length > 0) {\n        return candidate.trim();\n      }\n      continue;\n    }\n    if (token.startsWith(\"--type=\")) {\n      const candidate = token.slice(\"--type=\".length).trim();\n      if (candidate.length > 0) {\n        return candidate;\n      }\n    }\n  }\n  return undefined;\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  buildFlagLookup,\n  collectBootstrapPathValueIndices,\n  collectLongFlagCandidates,\n  markUnambiguousFlag,\n  normalizeLongOptionToken,\n  resolveCanonicalFlag,\n};\n","/**\n * @module sdk/invocation-author\n *\n * Safely scopes invocation-wide mutation authors for one-shot and embedded CLI hosts.\n */\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\n\n/** Apply an optional author override and return an idempotent environment restorer. */\nexport function applyInvocationAuthorOverride(\n  author: string | undefined,\n): () => void {\n  if (author === undefined) {\n    return () => {};\n  }\n  const normalizedAuthor = author.trim();\n  if (normalizedAuthor.length === 0) {\n    throw new PmCliError(\n      \"--author requires a non-empty value.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"missing_required_argument\",\n        nextSteps: [\"Pass an explicit author identifier with --author <id>.\"],\n      },\n    );\n  }\n  const previousAuthor = process.env.PM_AUTHOR;\n  process.env.PM_AUTHOR = normalizedAuthor;\n  let restored = false;\n  return () => {\n    if (restored) {\n      return;\n    }\n    restored = true;\n    if (previousAuthor === undefined) {\n      delete process.env.PM_AUTHOR;\n    } else {\n      process.env.PM_AUTHOR = previousAuthor;\n    }\n  };\n}\n","/**\n * @module sdk/cli-program\n *\n * Builds the reusable Commander root that embeds pm's universal global contracts.\n */\nimport { Command } from \"commander\";\nimport { writeStdout } from \"../core/output/output.js\";\n\n/** Create a fresh pm root program suitable for one-shot CLI or embedded hosts. */\nexport function createPmCliProgram(version: string): Command {\n  return new Command()\n    .name(\"pm\")\n    .description(\n      \"Universal, flexible, extensible, agent-optimized project management CLI for any project or programming language.\",\n    )\n    .version(version)\n    .showHelpAfterError(false)\n    .allowExcessArguments(false)\n    .allowUnknownOption(false)\n    .configureOutput({\n      writeOut: (value) => {\n        writeStdout(value);\n      },\n      writeErr: () => {},\n    })\n    .option(\"--json\", \"Output JSON instead of TOON\")\n    .option(\"--lean\", \"Omit null and empty containers from JSON output\")\n    .option(\"--quiet\", \"Suppress stdout output\")\n    .option(\n      \"--no-changed-fields\",\n      \"Omit the changed_fields array from mutation output (keeps changed_field_count)\",\n    )\n    .option(\n      \"--full-changed-fields\",\n      \"Restore the legacy full mutation envelope and changed_fields array\",\n    )\n    .option(\n      \"--id-only\",\n      \"Print only id and status for single-item mutation output\",\n    )\n    .option(\n      \"--pm-path <dir>\",\n      \"Explicit tracker storage path for this command (preferred over --path)\",\n    )\n    .option(\n      \"--path <dir>\",\n      \"Backward-compatible alias for --pm-path; this is the tracker storage path, not a workspace cwd\",\n    )\n    .option(\"--no-extensions\", \"Disable extension loading\")\n    .option(\"--no-pager\", \"Disable pager integration for help and long output\")\n    .option(\n      \"--explain\",\n      \"Render extended rationale and examples in help output\",\n    )\n    .option(\"--profile\", \"Print deterministic timing diagnostics\")\n    .option(\"--author <id>\", \"Override mutation author for this invocation\")\n    .exitOverride();\n}\n"],"names":["commandPathTokens"],"mappings":"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","debugId":"50e62ca5-fc65-568e-b9ef-4b45850e4d6f"}

package/dist/cli-bundle/chunks/{chunk-7656MAUL.js → chunk-MUAJHL2R.js}

@@ -4,7 +4,7 @@ import {
   parseAnnotationTextInput,
   resolveAnnotationInput,
   runAnnotationCommand
-} from "./chunk-TRSHFPRZ.js";
+} from "./chunk-6PM6CPPP.js";
 
 // dist/cli/commands/learnings.js
 async function runLearnings(id, options, global) {
@@ -30,6 +30,6 @@ async function runLearnings(id, options, global) {
 export {
   runLearnings
 };
-//# sourceMappingURL=chunk-7656MAUL.js.map
+//# sourceMappingURL=chunk-MUAJHL2R.js.map
 
 //# debugId=1bec9be5-4967-5914-933d-cf3ebd310ca5

package/dist/cli-bundle/chunks/{chunk-R3P6FZJW.js → chunk-N6QCY2AX.js}

@@ -1,5 +1,5 @@
 
-!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]="4ab4b144-7e4f-57e1-a531-93400c905393")}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]="f2cb1ebe-3459-59b8-80b9-c3371923eb7d")}catch(e){}}();
 import {
   applyHistoryPatch,
   ensureMaterializedHistoryTarget,
@@ -10,11 +10,12 @@ import {
   replayToItemDocument,
   resolveHistoryTarget,
   toReplayDocument
-} from "./chunk-PFNHX655.js";
+} from "./chunk-2P7OK4WG.js";
 import {
   resolveAuthor
 } from "./chunk-CUFW7ITY.js";
 import {
+  acquireItemMetadataDerivedIndexLock,
   acquireLock,
   appendHistoryEntry,
   canonicalDocument,
@@ -29,9 +30,10 @@ import {
   readLocatedItem,
   readSettings,
   recordAfterCommandAffectedItem,
+  refreshItemMetadataDerivedIndex,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-POG76WWZ.js";
+} from "./chunk-L7DZV6EZ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -43,7 +45,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   writeFileAtomic
-} from "./chunk-HYW67VJ5.js";
+} from "./chunk-TLF52ZDP.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -235,27 +237,42 @@ async function runRestore(id, target, options, global) {
       schema: settings.schema
     });
     const restoredItemPath = getItemPath(pmRoot, restoredDocument.metadata.type, resolvedId, itemFormat, typeRegistry.type_to_folder);
-    await writeFileAtomic(restoredItemPath, serializedRestore);
-    if (existingItemPath && restoredItemPath !== existingItemPath) {
-      await fs.rm(existingItemPath);
-    }
-    const historyEntry = createHistoryEntry({
-      nowIso: nowIso(),
-      author,
-      op: "restore",
-      before: currentState.document,
-      after: restoredDocument,
-      message: options.message
-    });
+    const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(pmRoot, author);
+    let derivedIndexWarnings = [];
     try {
-      await appendHistoryEntry(subject.historyPath, historyEntry);
-    } catch (error) {
-      await restorePreviousItemAfterHistoryFailure({
-        existingItemPath,
-        resolvedOriginalRaw: currentState.originalRaw,
-        restoredItemPath
+      await writeFileAtomic(restoredItemPath, serializedRestore);
+      if (existingItemPath && restoredItemPath !== existingItemPath) {
+        await fs.rm(existingItemPath);
+      }
+      const historyEntry = createHistoryEntry({
+        nowIso: nowIso(),
+        author,
+        op: "restore",
+        before: currentState.document,
+        after: restoredDocument,
+        message: options.message
+      });
+      try {
+        await appendHistoryEntry(subject.historyPath, historyEntry);
+      } catch (error) {
+        await restorePreviousItemAfterHistoryFailure({
+          existingItemPath,
+          resolvedOriginalRaw: currentState.originalRaw,
+          restoredItemPath
+        });
+        throw error;
+      }
+      derivedIndexWarnings = await refreshItemMetadataDerivedIndex({
+        pmRoot,
+        preferredFormat: settings.item_format,
+        typeToFolder: typeRegistry.type_to_folder,
+        schema: settings.schema,
+        itemPath: restoredItemPath,
+        previousItemPath: existingItemPath ?? void 0,
+        document: restoredDocument
       });
-      throw error;
+    } finally {
+      await releaseDerivedIndexLock();
     }
     const restoreChangedFields = changedFields(currentState.document, restoredDocument);
     const hookWarnings = await runRestoreWriteHooks({
@@ -288,6 +305,7 @@ async function runRestore(id, target, options, global) {
       warnings: [
         ...subject.historyPolicyWarnings,
         ...ownershipWarnings,
+        ...derivedIndexWarnings,
         ...hookWarnings
       ]
     };
@@ -310,6 +328,6 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-R3P6FZJW.js.map
+//# sourceMappingURL=chunk-N6QCY2AX.js.map
 
-//# debugId=4ab4b144-7e4f-57e1-a531-93400c905393
+//# debugId=f2cb1ebe-3459-59b8-80b9-c3371923eb7d

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

@@ -0,0 +1 @@
+{"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 {\n  pathExists,\n  readFileIfExists,\n  writeFileAtomic,\n} from \"../../core/fs/fs-utils.js\";\nimport {\n  appendHistoryEntry,\n  createHistoryEntry,\n} from \"../../core/history/history.js\";\nimport {\n  replayToCanonicalItemDocument,\n  replayToItemDocument,\n  toReplayDocument,\n} from \"../../core/history/replay.js\";\nimport {\n  applyHistoryPatch,\n  ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget,\n  extractPatchFailureContext,\n  readHistoryEntries,\n  replayHistoryToTarget as replayToTarget,\n  resolveHistoryTarget,\n} from \"../../sdk/history-read.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport {\n  canonicalDocument,\n  serializeItemDocument,\n} from \"../../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { 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 {\n  acquireItemMetadataDerivedIndexLock,\n  refreshItemMetadataDerivedIndex,\n} from \"../../sdk/item-metadata-index.js\";\nimport {\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type {\n  HistoryEntry,\n  HistoryPatchOp,\n  ItemDocument,\n  ItemMetadata,\n} from \"../../types/index.js\";\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\n/** Documents the restore command options payload exchanged by command, SDK, and package integrations. */\nexport interface RestoreCommandOptions {\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the restore result payload exchanged by command, SDK, and package integrations. */\nexport interface RestoreResult {\n  /** Value that configures or reports item for this contract. */\n  item: ItemMetadata;\n  /** Value that configures or reports restored from for this contract. */\n  restored_from: {\n    kind: \"version\" | \"timestamp\";\n    target: string;\n    history_index: number;\n    entry_ts: string;\n    entry_op: string;\n  };\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\n/** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */\nfunction ensureReplayTarget(target: string, history: readonly HistoryEntry[]) {\n  return resolveHistoryTarget(target, history, {\n    errorSubject: \"restore\",\n    allowFutureTimestamp: true,\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(\n    pmRoot,\n    id,\n    settings.id_prefix,\n    settings.item_format,\n    typeToFolder,\n  );\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 =\n    normalizedId === rawNormalizedId\n      ? [normalizedId]\n      : [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(\n  beforeDocument: ItemDocument,\n  afterDocument: ItemDocument,\n): string[] {\n  const beforeReplay = toReplayDocument(beforeDocument);\n  const afterReplay = toReplayDocument(afterDocument);\n  const patch = jsonPatch.compare(\n    beforeReplay,\n    afterReplay,\n  ) 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\n      .replace(/^\\/(?:metadata|front_matter)\\/?/, \"\")\n      .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<{\n  loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null;\n  existingItemPath: string | null;\n}> {\n  const historyRawUnderLock = await readFileIfExists(\n    params.subject.historyPath,\n  );\n  if (historyRawUnderLock !== params.historyRawBeforeLock) {\n    throw new PmCliError(\n      `History for ${params.resolvedId} changed while waiting for lock; retry restore.`,\n      EXIT_CODE.CONFLICT,\n    );\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\n    ? await readLocatedItem(locatedUnderLock, {\n        schema: params.settings.schema,\n      })\n    : null;\n  if ((loadedItemUnderLock?.raw ?? null) !== params.currentItemRawBeforeLock) {\n    throw new PmCliError(\n      `Item ${params.resolvedId} changed while waiting for lock; retry restore.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  return {\n    loadedItemUnderLock,\n    existingItemPath: locatedUnderLock?.itemPath ?? null,\n  };\n}\n\nfunction resolveRestoreCurrentState(\n  loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null,\n  history: HistoryEntry[],\n): RestoreCurrentState {\n  if (loadedItemUnderLock) {\n    return {\n      document: loadedItemUnderLock.document,\n      originalRaw: loadedItemUnderLock.raw,\n    };\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 =\n    assigned && assigned !== params.author && !params.force;\n  if (!hasOwnershipConflict) {\n    return [];\n  }\n  if (params.enforcement === \"strict\") {\n    throw new PmCliError(\n      `Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  return params.enforcement === \"warn\"\n    ? [`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`]\n    : [];\n}\n\nasync function restorePreviousItemAfterHistoryFailure(params: {\n  existingItemPath: string | null;\n  resolvedOriginalRaw: string | null;\n  restoredItemPath: string;\n}): Promise<void> {\n  if (\n    params.existingItemPath &&\n    params.resolvedOriginalRaw !== null &&\n    params.restoredItemPath !== params.existingItemPath\n  ) {\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/** Implements run restore for the public runtime surface of this module. */\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(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const subject = await resolveRestoreSubject(\n    pmRoot,\n    id,\n    settings,\n    typeRegistry.type_to_folder,\n  );\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(\n      `No history exists for ${resolvedId}; restore is unavailable.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const resolvedTarget = ensureReplayTarget(target, history);\n  const replayDocument = ensureMaterializedRestoreTarget(\n    replayToTarget(history, resolvedTarget.historyIndex),\n    resolvedTarget,\n  );\n  const restoredDocument = replayToCanonicalItemDocument(replayDocument, {\n    schema: settings.schema,\n  });\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\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : 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 } =\n      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(\n      loadedItemUnderLock,\n      history,\n    );\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, {\n      format: itemFormat,\n      schema: settings.schema,\n    });\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    const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(\n      pmRoot,\n      author,\n    );\n    let derivedIndexWarnings: string[] = [];\n    try {\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      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      derivedIndexWarnings = await refreshItemMetadataDerivedIndex({\n        pmRoot,\n        preferredFormat: settings.item_format,\n        typeToFolder: typeRegistry.type_to_folder,\n        schema: settings.schema,\n        itemPath: restoredItemPath,\n        previousItemPath: existingItemPath ?? undefined,\n        document: restoredDocument,\n      });\n    } finally {\n      await releaseDerivedIndexLock();\n    }\n    const restoreChangedFields = changedFields(\n      currentState.document,\n      restoredDocument,\n    );\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(\n        currentState.document.metadata,\n        restoreChangedFields,\n      ),\n      current: projectAfterCommandItemSnapshot(\n        restoredDocument.metadata,\n        restoreChangedFields,\n      ),\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: [\n        ...subject.historyPolicyWarnings,\n        ...ownershipWarnings,\n        ...derivedIndexWarnings,\n        ...hookWarnings,\n      ],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\n/** Public contract for test only restore command, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyRestoreCommand = {\n  applyHistoryPatch,\n  changedFields,\n  ensureMaterializedRestoreTarget,\n  ensureReplayTarget,\n  extractPatchFailureContext,\n  replayCurrentDocument,\n  replayToTarget,\n  resolveRestoreSubject,\n};\n"],"names":[],"mappings":"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","debugId":"f2cb1ebe-3459-59b8-80b9-c3371923eb7d"}

package/dist/cli-bundle/chunks/{chunk-7WCE6Y64.js → chunk-NUQCSV4P.js}

@@ -1,7 +1,7 @@
 import {
   collectUsedExtensionCapabilities,
   normalizeExtensionName
-} from "./chunk-7AVEY74G.js";
+} from "./chunk-VTOCZ343.js";
 
 // dist/core/extensions/activation-summary.js
 !(function() {
@@ -159,4 +159,4 @@ export {
   describeExtensionActivation,
   renderExtensionSurfaceMarkdown
 };
-//# sourceMappingURL=chunk-7WCE6Y64.js.map
+//# sourceMappingURL=chunk-NUQCSV4P.js.map

package/dist/cli-bundle/chunks/{chunk-SZVB53Y3.js → chunk-O3GFE2PX.js}

@@ -2,7 +2,7 @@
 !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]="bd66882b-1bef-52df-b18f-5cb50c8e2ac3")}catch(e){}}();
 import {
   normalizeAddTypeInput
-} from "./chunk-TOBGV45Y.js";
+} from "./chunk-YUKIFPWK.js";
 import {
   DEFAULT_RUNTIME_STATUS_DEFINITIONS,
   ITEM_METADATA_KEY_ORDER,
@@ -10,7 +10,7 @@ import {
   RUNTIME_FIELD_TYPE_VALUES,
   RUNTIME_STATUS_ROLE_VALUES,
   evictOldestMemoEntries
-} from "./chunk-HYW67VJ5.js";
+} from "./chunk-TLF52ZDP.js";
 
 // dist/core/schema/status-defs-file.js
 var RUNTIME_STATUS_ROLE_SET = new Set(RUNTIME_STATUS_ROLE_VALUES);
@@ -528,6 +528,6 @@ export {
   normalizeTypePresetName,
   resolveTypePresetDefinitions
 };
-//# sourceMappingURL=chunk-SZVB53Y3.js.map
+//# sourceMappingURL=chunk-O3GFE2PX.js.map
 
 //# debugId=bd66882b-1bef-52df-b18f-5cb50c8e2ac3

package/dist/cli-bundle/chunks/{chunk-OY7DMU5P.js → chunk-O43LEUSD.js}

@@ -3,7 +3,7 @@
 import {
   renameArtifactsResultKey,
   runLinkedArtifacts
-} from "./chunk-LAV26CQG.js";
+} from "./chunk-42SYYKA4.js";
 
 // dist/sdk/docs.js
 async function runDocs(id, options, global) {
@@ -19,6 +19,6 @@ async function runDocs(id, options, global) {
 export {
   runDocs
 };
-//# sourceMappingURL=chunk-OY7DMU5P.js.map
+//# sourceMappingURL=chunk-O43LEUSD.js.map
 
 //# debugId=db3e4dc9-8bda-5f4e-bf43-3c1ce147c9a2