@unbrained/pm-cli 2026.6.24 → 2026.6.30

package/dist/cli-bundle/chunks/{register-setup-TWHKICM2.js → register-setup-MPANILQF.js}

@@ -1,33 +1,34 @@
 import {
   collect,
   getGlobalOptions
-} from "./chunk-J7I4C5ZB.js";
-import "./chunk-SMXSDY7J.js";
-import "./chunk-HZF5RLKX.js";
+} from "./chunk-DORJSBGJ.js";
+import "./chunk-6T5ZIWBS.js";
 import {
   printError,
-  printResult
-} from "./chunk-TIM4OD74.js";
+  printResult,
+  writeStdout
+} from "./chunk-CHRNYKNI.js";
+import "./chunk-KYDYQMNW.js";
 import {
-  SCAFFOLD_CAPABILITIES
-} from "./chunk-INPHFO33.js";
-import "./chunk-PEL2NLQE.js";
-import "./chunk-OHDQNKJB.js";
-import "./chunk-B74BP6IS.js";
-import "./chunk-C4C3EJCJ.js";
-import "./chunk-ZV7IQ23N.js";
-import "./chunk-I6QMJ2XT.js";
+  SCAFFOLD_CAPABILITIES,
+  renderExtensionDescribeMarkdown
+} from "./chunk-IZQOJR2B.js";
+import "./chunk-F6VH3LFC.js";
+import "./chunk-LBH7UYKY.js";
+import "./chunk-ZFIEEDTJ.js";
+import "./chunk-MLHX6DN5.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-EYPINTFR.js";
+} from "./chunk-SNUK7H5J.js";
 
 // dist/cli/register-setup.js
 import fs from "node:fs/promises";
+import path from "node:path";
 !(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] = "c4792f03-c5dc-5b99-ab49-70b2b20c9c7c");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "122a2186-07dc-523a-97dd-4b96ab40e529");
   } catch (e2) {
   }
 })();
@@ -50,6 +51,7 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     explore: isForcedAction("explore") || readBoolean("explore", "list"),
     manage: isForcedAction("manage") || readBoolean("manage"),
     describe: isForcedAction("describe") || readBoolean("describe"),
+    markdown: readBoolean("markdown"),
     reload: isForcedAction("reload") || readBoolean("reload"),
     doctor: isForcedAction("doctor") || readBoolean("doctor"),
     catalog: isForcedAction("catalog") || readBoolean("catalog"),
@@ -64,8 +66,10 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     github: readString("github"),
     ref: readString("ref"),
     capability: readString("capability"),
+    declarative: readBoolean("declarative"),
     fields: readString("fields"),
     detail: readString("detail"),
+    output: readString("output"),
     trace: readBoolean("trace"),
     watch: readBoolean("watch"),
     runtimeProbe: readBoolean("runtimeProbe", "runtime_probe", "runtime-probe"),
@@ -94,9 +98,43 @@ async function executeExtensionCommand(target, options, command, forcedAction, v
   const globalOptions = getGlobalOptions(command);
   const startedAt = Date.now();
   const normalizedOptions = normalizeExtensionOptions(options, forcedAction, vocabulary);
-  const { runExtension } = await import("./extension-YQF4CPIR.js");
+  const wantsMarkdown = normalizedOptions.markdown === true;
+  const outputOption = typeof normalizedOptions.output === "string" ? normalizedOptions.output : void 0;
+  const outputPath = outputOption?.trim();
+  if (outputOption !== void 0 && outputPath === "") {
+    throw new PmCliError("--output requires a non-empty file path.", EXIT_CODE.USAGE);
+  }
+  if (outputPath !== void 0 && !wantsMarkdown) {
+    throw new PmCliError("--output is only supported with --markdown describe output.", EXIT_CODE.USAGE);
+  }
+  if (wantsMarkdown) {
+    if (globalOptions.json) {
+      throw new PmCliError("Cannot combine --json with --markdown.", EXIT_CODE.USAGE);
+    }
+    if (normalizedOptions.describe !== true) {
+      throw new PmCliError("--markdown is only supported by the describe action.", EXIT_CODE.USAGE);
+    }
+  }
+  const { runExtension } = await import("./extension-GMVOIP4O.js");
   const result = await runExtension(target, normalizedOptions, globalOptions);
-  printResult(result, globalOptions);
+  if (wantsMarkdown) {
+    const markdown = renderExtensionDescribeMarkdown(result.details, vocabulary);
+    if (outputPath !== void 0) {
+      const resolvedOutputPath = path.resolve(outputPath);
+      await fs.mkdir(path.dirname(resolvedOutputPath), { recursive: true });
+      await fs.writeFile(resolvedOutputPath, markdown, "utf8");
+    }
+    if (!globalOptions.quiet) {
+      for (const warning of result.warnings) {
+        printError(`warning: ${warning}`);
+      }
+      if (outputPath === void 0) {
+        writeStdout(markdown);
+      }
+    }
+  } else {
+    printResult(result, globalOptions);
+  }
   const strictExit = Boolean(normalizedOptions.strictExit) || Boolean(normalizedOptions.failOnWarn);
   if (result.action === "doctor" && strictExit) {
     const detailsRecord = result.details;
@@ -124,13 +162,18 @@ function registerLifecycleCommand(program, vocabulary) {
   const noun = vocabulary === "package" ? "package" : "extension";
   const plural = vocabulary === "package" ? "packages" : "extensions";
   const commandName = vocabulary;
-  const lifecycleCommand = program.command(commandName).argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} source/name or scaffold target path (for --init/--scaffold)`).option("--init", `Generate a starter ${noun} scaffold at target path`).option("--scaffold", "Alias for --init").option("--capability <kind>", `Capability the --init starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).option("--install", `Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source`).option("--uninstall", `Uninstall an installed ${noun}`).option("--explore", `List discovered ${plural} in selected scope`).option("--list", "Alias for --explore").option("--manage", `List managed ${plural} with update-check metadata`).option("--describe", `Map every surface a loaded ${noun} registers (optionally one by name)`).option("--reload", `Reload ${plural} with cache-busted module imports`).option("--watch", "Use watch mode with --reload").option("--doctor", `Run consolidated ${noun} diagnostics (summary/deep modes)`).option("--catalog", `List bundled first-party ${noun} catalog metadata`).option("--adopt", `Adopt an existing unmanaged ${noun} into managed metadata`).option("--adopt-all", `Adopt all unmanaged ${plural} into managed metadata`).option("--activate", `Activate a ${noun} in selected scope settings`).option("--deactivate", `Deactivate a ${noun} in selected scope settings`).option("--project", `Use project ${noun} scope (default)`).option("--local", "Alias for --project").option("--global", `Use global ${noun} scope`).option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>", "Alias for --gh").option("--ref <ref>", "Git ref/branch/tag for GitHub install sources").option("--detail <mode>", `${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`).option("--trace", "Include actionable registration traces in doctor deep diagnostics").option("--runtime-probe", "Opt-in runtime activation probe for manage output parity").option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`).option("--strict-exit", "Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn", "Alias for --strict-exit (doctor)").description(vocabulary === "package" ? "Manage package lifecycle operations for project or global scope. Backward-compatible with extension packages." : "Manage extension lifecycle operations for project or global scope.").action(async (target, _options, command) => {
+  const lifecycleCommand = program.command(commandName).argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} source/name or scaffold target path (for --init/--scaffold)`).option("--init", `Generate a starter ${noun} scaffold at target path`).option("--scaffold", "Alias for --init").option("--capability <kind>", `Capability the --init starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).option("--install", `Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source`).option("--uninstall", `Uninstall an installed ${noun}`).option("--explore", `List discovered ${plural} in selected scope`).option("--list", "Alias for --explore").option("--manage", `List managed ${plural} with update-check metadata`).option("--describe", `Map every surface a loaded ${noun} registers (optionally one by name)`).option("--markdown", "Render describe output as a Markdown reference document (describe only)").option("--output <path>", "Write describe Markdown to a file (requires --markdown)").option("--reload", `Reload ${plural} with cache-busted module imports`).option("--watch", "Use watch mode with --reload").option("--doctor", `Run consolidated ${noun} diagnostics (summary/deep modes)`).option("--catalog", `List bundled first-party ${noun} catalog metadata`).option("--adopt", `Adopt an existing unmanaged ${noun} into managed metadata`).option("--adopt-all", `Adopt all unmanaged ${plural} into managed metadata`).option("--activate", `Activate a ${noun} in selected scope settings`).option("--deactivate", `Deactivate a ${noun} in selected scope settings`).option("--project", `Use project ${noun} scope (default)`).option("--local", "Alias for --project").option("--global", `Use global ${noun} scope`).option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>", "Alias for --gh").option("--ref <ref>", "Git ref/branch/tag for GitHub install sources").option("--detail <mode>", `${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`).option("--trace", "Include actionable registration traces in doctor deep diagnostics").option("--runtime-probe", "Opt-in runtime activation probe for manage output parity").option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`).option("--strict-exit", "Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn", "Alias for --strict-exit (doctor)").description(vocabulary === "package" ? "Manage package lifecycle operations for project or global scope. Backward-compatible with extension packages." : "Manage extension lifecycle operations for project or global scope.").action(async (target, _options, command) => {
     await executeExtensionCommand(target, command.optsWithGlobals(), command, void 0, vocabulary);
   });
   if (vocabulary === "package") {
     lifecycleCommand.alias("packages");
+    lifecycleCommand.option("--declarative", "Scaffold the composeExtension blueprint starter (any capability)");
+  }
+  const initCommand = lifecycleCommand.command("init").alias("scaffold").argument("<target>", `Scaffold target directory path`).option("--capability <kind>", `Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).description(vocabulary === "package" ? "Generate a starter package scaffold with package metadata, manifest, and entrypoint." : "Generate a starter extension scaffold with manifest and entrypoint.");
+  if (vocabulary === "package") {
+    initCommand.option("--declarative", "Scaffold the composeExtension blueprint starter (any capability)");
   }
-  addLifecycleScopeOptions(lifecycleCommand.command("init").alias("scaffold").argument("<target>", `Scaffold target directory path`).option("--capability <kind>", `Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).description(vocabulary === "package" ? "Generate a starter package scaffold with package metadata, manifest, and entrypoint." : "Generate a starter extension scaffold with manifest and entrypoint."), vocabulary).action(async (target, _options, command) => {
+  addLifecycleScopeOptions(initCommand, vocabulary).action(async (target, _options, command) => {
     await executeExtensionCommand(target, command.optsWithGlobals(), command, "init", vocabulary);
   });
   addLifecycleScopeOptions(lifecycleCommand.command("install").argument("[targets...]", `${noun[0].toUpperCase()}${noun.slice(1)} source (local path, bundled alias, npm: source, wildcard, or GitHub source)`).option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>", "Alias for --gh").option("--ref <ref>", "Git ref/branch/tag for GitHub install sources").description(`Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source.`), vocabulary).action(async (targets, _options, command) => {
@@ -146,7 +189,7 @@ function registerLifecycleCommand(program, vocabulary) {
   addLifecycleScopeOptions(lifecycleCommand.command("manage").option("--runtime-probe", "Opt-in runtime activation probe for manage output parity").option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`).description(`List managed ${plural} with update-check metadata.`), vocabulary).action(async (_options, command) => {
     await executeExtensionCommand(void 0, command.optsWithGlobals(), command, "manage", vocabulary);
   });
-  addLifecycleScopeOptions(lifecycleCommand.command("describe").argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`).description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`), vocabulary).action(async (target, _options, command) => {
+  addLifecycleScopeOptions(lifecycleCommand.command("describe").argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`).option("--markdown", "Render the surface map as a Markdown reference document instead of toon/json").option("--output <path>", "Write Markdown output to a file (requires --markdown)").description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`), vocabulary).action(async (target, _options, command) => {
     await executeExtensionCommand(target, command.optsWithGlobals(), command, "describe", vocabulary);
   });
   addLifecycleScopeOptions(lifecycleCommand.command("reload").option("--watch", "Use watch mode for repeated reload checks").description(`Reload ${plural} with cache-busted module imports.`), vocabulary).action(async (_options, command) => {
@@ -175,7 +218,7 @@ function registerSetupCommands(program) {
   program.command("init").argument("[prefix-or-path]", "Optional id prefix, or path-like tracker target such as ./pm-sandbox").option("--preset <value>", "Governance preset for new setups: minimal|default|strict").option("--defaults", "Use non-interactive setup defaults without opening the wizard").option("-y, --yes", "Alias for --defaults (non-interactive setup)").option("--author <value>", "Set the default mutation author for this project").option("--agent-guidance <mode>", "Agent guidance mode: ask|add|skip|status").option("--type-preset <name>", "Register domain item types during init: agile|ops|research").option("--with-packages", "Install all bundled first-party packages during initialization").option("--force", "Allow initializing tracker files directly in a directory that looks like a workspace root").option("--verbose", "Include the full resolved settings tree in the output (default output is a concise summary)").description("Initialize pm storage and defaults for the current workspace or a path-like tracker target.").action(async (prefix, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runInit, summarizeInitResult } = await import("./init-C4CRHW22.js");
+    const { runInit, summarizeInitResult } = await import("./init-TRYJELH4.js");
     const result = await runInit(prefix, globalOptions, {
       preset: typeof options.preset === "string" ? options.preset : void 0,
       defaults: options.defaults === true || options.yes === true,
@@ -196,7 +239,7 @@ function registerSetupCommands(program) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
     const criteria = Array.isArray(options.criterion) ? options.criterion : [];
-    const { runConfig } = await import("./config-NCNNWF6R.js");
+    const { runConfig } = await import("./config-FIXJZEQK.js");
     const actionShorthands = /* @__PURE__ */ new Set(["get", "set", "list", "export"]);
     const scopeShorthand = scope !== void 0 && actionShorthands.has(scope);
     const resolvedScope = scopeShorthand ? "project" : scope ?? "project";
@@ -235,7 +278,7 @@ function registerSetupCommands(program) {
   addPackageScopeOptions(program.command("upgrade").argument("[target]", "Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").option("--dry-run", "Plan CLI/package upgrades without running npm or reinstalling packages").option("--cli-only", "Upgrade only the pm CLI/SDK npm package").option("--packages-only", "Upgrade only managed pm packages").option("--repair", "Force npm global reinstall when upgrading the pm CLI/SDK").option("--tag <value>", "npm dist-tag/version for CLI and registry package upgrades").option("--package-name <value>", "Override the CLI package name for self-upgrade testing").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages.")).action(async (target, _options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runUpgrade } = await import("./upgrade-DHL74PQH.js");
+    const { runUpgrade } = await import("./upgrade-ICXY244R.js");
     const result = await runUpgrade(target, command.opts(), globalOptions);
     printResult(result, globalOptions);
     if (!result.ok) {
@@ -249,4 +292,4 @@ function registerSetupCommands(program) {
 export {
   registerSetupCommands
 };
-//# sourceMappingURL=register-setup-TWHKICM2.js.map
+//# sourceMappingURL=register-setup-MPANILQF.js.map

package/dist/cli-bundle/chunks/register-setup-MPANILQF.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/register-setup.ts"],
+  "sourcesContent": ["/**\n * @module cli/register-setup\n *\n * Provides CLI runtime support for Register Setup.\n */\nimport type { Command } from \"commander\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport {\n  collect,\n  getGlobalOptions,\n  printError,\n  printResult,\n  writeStdout,\n} from \"./registration-helpers.js\";\nimport { SCAFFOLD_CAPABILITIES } from \"./commands/extension/scaffold.js\";\nimport { renderExtensionDescribeMarkdown, type ExtensionDescribeResult } from \"./commands/extension/describe.js\";\n\n\n\ntype ExtensionSubcommandAction =\n  | \"init\"\n  | \"install\"\n  | \"uninstall\"\n  | \"explore\"\n  | \"manage\"\n  | \"describe\"\n  | \"reload\"\n  | \"doctor\"\n  | \"catalog\"\n  | \"adopt\"\n  | \"adopt-all\"\n  | \"activate\"\n  | \"deactivate\";\n\ntype LifecycleCommandVocabulary = \"extension\" | \"package\";\n\nfunction normalizeExtensionOptions(\n  options: Record<string, unknown>,\n  forcedAction?: ExtensionSubcommandAction,\n  vocabulary: LifecycleCommandVocabulary = \"extension\",\n): Record<string, unknown> {\n  const isForcedAction = (action: ExtensionSubcommandAction): boolean => forcedAction === action;\n  const readBoolean = (...keys: string[]): boolean => keys.some((key) => options[key] === true);\n  const readString = (...keys: string[]): string | undefined => {\n    for (const key of keys) {\n      if (typeof options[key] === \"string\") {\n        return options[key] as string;\n      }\n    }\n    return undefined;\n  };\n  return {\n    init: isForcedAction(\"init\") || readBoolean(\"init\"),\n    scaffold: readBoolean(\"scaffold\"),\n    install: isForcedAction(\"install\") || readBoolean(\"install\"),\n    uninstall: isForcedAction(\"uninstall\") || readBoolean(\"uninstall\"),\n    explore: isForcedAction(\"explore\") || readBoolean(\"explore\", \"list\"),\n    manage: isForcedAction(\"manage\") || readBoolean(\"manage\"),\n    describe: isForcedAction(\"describe\") || readBoolean(\"describe\"),\n    markdown: readBoolean(\"markdown\"),\n    reload: isForcedAction(\"reload\") || readBoolean(\"reload\"),\n    doctor: isForcedAction(\"doctor\") || readBoolean(\"doctor\"),\n    catalog: isForcedAction(\"catalog\") || readBoolean(\"catalog\"),\n    adopt: isForcedAction(\"adopt\") || readBoolean(\"adopt\"),\n    adoptAll: isForcedAction(\"adopt-all\") || readBoolean(\"adoptAll\", \"adopt_all\", \"adopt-all\"),\n    activate: isForcedAction(\"activate\") || readBoolean(\"activate\"),\n    deactivate: isForcedAction(\"deactivate\") || readBoolean(\"deactivate\"),\n    project: readBoolean(\"project\"),\n    local: readBoolean(\"local\"),\n    global: readBoolean(\"global\"),\n    gh: readString(\"gh\"),\n    github: readString(\"github\"),\n    ref: readString(\"ref\"),\n    capability: readString(\"capability\"),\n    declarative: readBoolean(\"declarative\"),\n    fields: readString(\"fields\"),\n    detail: readString(\"detail\"),\n    output: readString(\"output\"),\n    trace: readBoolean(\"trace\"),\n    watch: readBoolean(\"watch\"),\n    runtimeProbe: readBoolean(\"runtimeProbe\", \"runtime_probe\", \"runtime-probe\"),\n    fixManagedState: readBoolean(\"fixManagedState\", \"fix_managed_state\", \"fix-managed-state\"),\n    strictExit: readBoolean(\"strictExit\", \"strict_exit\", \"strict-exit\"),\n    failOnWarn: readBoolean(\"failOnWarn\", \"fail_on_warn\", \"fail-on-warn\"),\n    vocabulary,\n  };\n}\n\nasync function looksLikeShellExpandedWildcard(targets: string[]): Promise<boolean> {\n  // Only ever called by normalizeInstallTargets after it has already returned\n  // early for length <= 1, so targets always has more than one entry here.\n  const visibleEntries = (await fs.readdir(process.cwd()))\n    .filter((entry) => !entry.startsWith(\".\"))\n    .sort((left, right) => left.localeCompare(right));\n  const normalizedTargets = [...targets].sort((left, right) => left.localeCompare(right));\n  return (\n    visibleEntries.length === normalizedTargets.length &&\n    visibleEntries.every((entry, index) => entry === normalizedTargets[index])\n  );\n}\n\nasync function normalizeInstallTargets(targets: string[] | undefined): Promise<string | undefined> {\n  // Commander variadic `[targets...]` always yields an array (empty when no\n  // targets are given), so a single nullish coalesce covers every input.\n  /* c8 ignore start -- commander variadic `[targets...]` always passes an array; the `?? []` arm is an unreachable nullish guard */\n  const normalizedTargets = (targets ?? [])\n    .map((target) => target.trim())\n    .filter((target) => target.length > 0);\n  /* c8 ignore stop */\n  if (normalizedTargets.length <= 1) {\n    return normalizedTargets[0];\n  }\n  if (await looksLikeShellExpandedWildcard(normalizedTargets)) {\n    return \"*\";\n  }\n  throw new PmCliError(\n    `Install accepts one package source at a time. To install bundled first-party packages, quote the wildcard: pm install '*'`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nasync function executeExtensionCommand(\n  target: string | undefined,\n  options: Record<string, unknown>,\n  command: Command,\n  forcedAction?: ExtensionSubcommandAction,\n  vocabulary: LifecycleCommandVocabulary = \"extension\",\n): Promise<void> {\n  const globalOptions = getGlobalOptions(command);\n  const startedAt = Date.now();\n  const normalizedOptions = normalizeExtensionOptions(options, forcedAction, vocabulary);\n  const wantsMarkdown = normalizedOptions.markdown === true;\n  const outputOption = typeof normalizedOptions.output === \"string\" ? normalizedOptions.output : undefined;\n  const outputPath = outputOption?.trim();\n  if (outputOption !== undefined && outputPath === \"\") {\n    throw new PmCliError(\"--output requires a non-empty file path.\", EXIT_CODE.USAGE);\n  }\n  if (outputPath !== undefined && !wantsMarkdown) {\n    throw new PmCliError(\"--output is only supported with --markdown describe output.\", EXIT_CODE.USAGE);\n  }\n  if (wantsMarkdown) {\n    // Validate before running so a misdirected --markdown (e.g. on install) fails\n    // fast instead of performing the action and only then rejecting the flag.\n    if (globalOptions.json) {\n      throw new PmCliError(\"Cannot combine --json with --markdown.\", EXIT_CODE.USAGE);\n    }\n    if (normalizedOptions.describe !== true) {\n      throw new PmCliError(\"--markdown is only supported by the describe action.\", EXIT_CODE.USAGE);\n    }\n  }\n  const { runExtension } = await import(\"./commands/extension.js\");\n  const result = await runExtension(target, normalizedOptions, globalOptions);\n  if (wantsMarkdown) {\n    // describe resolved above, so `details` is the describe action's ExtensionDescribeResult.\n    const markdown = renderExtensionDescribeMarkdown(result.details as unknown as ExtensionDescribeResult, vocabulary);\n    if (outputPath !== undefined) {\n      const resolvedOutputPath = path.resolve(outputPath);\n      await fs.mkdir(path.dirname(resolvedOutputPath), { recursive: true });\n      await fs.writeFile(resolvedOutputPath, markdown, \"utf8\");\n    }\n    if (!globalOptions.quiet) {\n      // printResult is bypassed in markdown mode, so surface result warnings (e.g.\n      // extension load/activation failures) to stderr rather than swallowing them,\n      // and emit the rendered doc (already newline-terminated) without an extra newline.\n      for (const warning of result.warnings) {\n        printError(`warning: ${warning}`);\n      }\n      if (outputPath === undefined) {\n        writeStdout(markdown);\n      }\n    }\n  } else {\n    printResult(result, globalOptions);\n  }\n  const strictExit = Boolean(normalizedOptions.strictExit) || Boolean(normalizedOptions.failOnWarn);\n  if (result.action === \"doctor\" && strictExit) {\n    const detailsRecord = result.details as Record<string, unknown>;\n    const summary = (detailsRecord.summary ?? null) as Record<string, unknown> | null;\n    const summaryStatus = summary && typeof summary.status === \"string\" ? summary.status : undefined;\n    const shouldFail = summaryStatus ? summaryStatus !== \"ok\" : result.warnings.length > 0;\n    if (shouldFail) {\n      process.exitCode = EXIT_CODE.GENERIC_FAILURE;\n    }\n  }\n  if (globalOptions.profile) {\n    printError(`profile:command=extension took_ms=${Date.now() - startedAt}`);\n  }\n}\n\nfunction addExtensionScopeOptions<T extends Command>(command: T): T {\n  return command\n    .option(\"--project\", \"Use project extension scope (default)\")\n    .option(\"--local\", \"Alias for --project\")\n    .option(\"--global\", \"Use global extension scope\");\n}\n\nfunction addPackageScopeOptions<T extends Command>(command: T): T {\n  return command\n    .option(\"--project\", \"Use project package scope (default)\")\n    .option(\"--local\", \"Alias for --project\")\n    .option(\"--global\", \"Use global package scope\");\n}\n\nfunction addLifecycleScopeOptions<T extends Command>(command: T, vocabulary: LifecycleCommandVocabulary): T {\n  return vocabulary === \"package\" ? addPackageScopeOptions(command) : addExtensionScopeOptions(command);\n}\n\nfunction registerLifecycleCommand(\n  program: Command,\n  vocabulary: LifecycleCommandVocabulary,\n): void {\n  const noun = vocabulary === \"package\" ? \"package\" : \"extension\";\n  const plural = vocabulary === \"package\" ? \"packages\" : \"extensions\";\n  const commandName = vocabulary;\n  const lifecycleCommand = program\n    .command(commandName)\n    .argument(\"[target]\", `${noun[0]!.toUpperCase()}${noun.slice(1)} source/name or scaffold target path (for --init/--scaffold)`)\n    .option(\"--init\", `Generate a starter ${noun} scaffold at target path`)\n    .option(\"--scaffold\", \"Alias for --init\")\n    .option(\"--capability <kind>\", `Capability the --init starter targets (${SCAFFOLD_CAPABILITIES.join(\"|\")}; default commands)`)\n    .option(\"--install\", `Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source`)\n    .option(\"--uninstall\", `Uninstall an installed ${noun}`)\n    .option(\"--explore\", `List discovered ${plural} in selected scope`)\n    .option(\"--list\", \"Alias for --explore\")\n    .option(\"--manage\", `List managed ${plural} with update-check metadata`)\n    .option(\"--describe\", `Map every surface a loaded ${noun} registers (optionally one by name)`)\n    .option(\"--markdown\", \"Render describe output as a Markdown reference document (describe only)\")\n    .option(\"--output <path>\", \"Write describe Markdown to a file (requires --markdown)\")\n    .option(\"--reload\", `Reload ${plural} with cache-busted module imports`)\n    .option(\"--watch\", \"Use watch mode with --reload\")\n    .option(\"--doctor\", `Run consolidated ${noun} diagnostics (summary/deep modes)`)\n    .option(\"--catalog\", `List bundled first-party ${noun} catalog metadata`)\n    .option(\"--adopt\", `Adopt an existing unmanaged ${noun} into managed metadata`)\n    .option(\"--adopt-all\", `Adopt all unmanaged ${plural} into managed metadata`)\n    .option(\"--activate\", `Activate a ${noun} in selected scope settings`)\n    .option(\"--deactivate\", `Deactivate a ${noun} in selected scope settings`)\n    .option(\"--project\", `Use project ${noun} scope (default)`)\n    .option(\"--local\", \"Alias for --project\")\n    .option(\"--global\", `Use global ${noun} scope`)\n    .option(\"--gh <github-source>\", \"Install from GitHub shorthand source (owner/repo[/path])\")\n    .option(\"--github <github-source>\", \"Alias for --gh\")\n    .option(\"--ref <ref>\", \"Git ref/branch/tag for GitHub install sources\")\n    .option(\"--detail <mode>\", `${noun[0]!.toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`)\n    .option(\"--trace\", \"Include actionable registration traces in doctor deep diagnostics\")\n    .option(\"--runtime-probe\", \"Opt-in runtime activation probe for manage output parity\")\n    .option(\"--fix-managed-state\", `Adopt unmanaged ${plural} before diagnostics/update checks`)\n    .option(\"--strict-exit\", \"Return non-zero exit when doctor warnings are present (ok=false)\")\n    .option(\"--fail-on-warn\", \"Alias for --strict-exit (doctor)\")\n    .description(\n      vocabulary === \"package\"\n        ? \"Manage package lifecycle operations for project or global scope. Backward-compatible with extension packages.\"\n        : \"Manage extension lifecycle operations for project or global scope.\",\n    )\n    .action(async (target: string | undefined, _options: Record<string, unknown>, command) => {\n      await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, undefined, vocabulary);\n    });\n\n  if (vocabulary === \"package\") {\n    lifecycleCommand.alias(\"packages\");\n    // `--declarative` scaffolds a `composeExtension` blueprint starter, which is a\n    // runtime SDK *value* import — only package-mode authoring links the SDK, so the\n    // flag is package-only. It is advertised solely on `pm package` (the top-level\n    // lifecycle command and its `init` subcommand below); `scaffoldExtensionProject`\n    // still rejects extension-mode + declarative as defense-in-depth for the\n    // programmatic/MCP path.\n    lifecycleCommand.option(\"--declarative\", \"Scaffold the composeExtension blueprint starter (any capability)\");\n  }\n\n  const initCommand = lifecycleCommand\n    .command(\"init\")\n    .alias(\"scaffold\")\n    .argument(\"<target>\", `Scaffold target directory path`)\n    .option(\"--capability <kind>\", `Capability the starter targets (${SCAFFOLD_CAPABILITIES.join(\"|\")}; default commands)`)\n    .description(\n      vocabulary === \"package\"\n        ? \"Generate a starter package scaffold with package metadata, manifest, and entrypoint.\"\n        : \"Generate a starter extension scaffold with manifest and entrypoint.\",\n    );\n  if (vocabulary === \"package\") {\n    initCommand.option(\"--declarative\", \"Scaffold the composeExtension blueprint starter (any capability)\");\n  }\n  addLifecycleScopeOptions(initCommand, vocabulary).action(async (target: string, _options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"init\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand\n      .command(\"install\")\n      .argument(\"[targets...]\", `${noun[0]!.toUpperCase()}${noun.slice(1)} source (local path, bundled alias, npm: source, wildcard, or GitHub source)`)\n      .option(\"--gh <github-source>\", \"Install from GitHub shorthand source (owner/repo[/path])\")\n      .option(\"--github <github-source>\", \"Alias for --gh\")\n      .option(\"--ref <ref>\", \"Git ref/branch/tag for GitHub install sources\")\n      .description(`Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source.`),\n    vocabulary,\n  ).action(async (targets: string[] | undefined, _options: Record<string, unknown>, command) => {\n    const target = await normalizeInstallTargets(targets);\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"install\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand.command(\"uninstall\").argument(\"<target>\", `${noun[0]!.toUpperCase()}${noun.slice(1)} name`).description(`Uninstall an installed ${noun}.`),\n    vocabulary,\n  ).action(async (target: string, _options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"uninstall\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(lifecycleCommand.command(\"explore\").description(`List discovered ${plural} in selected scope.`), vocabulary).action(\n    async (_options: Record<string, unknown>, command) => {\n      await executeExtensionCommand(undefined, command.optsWithGlobals() as Record<string, unknown>, command, \"explore\", vocabulary);\n    },\n  );\n\n  addLifecycleScopeOptions(\n    lifecycleCommand\n      .command(\"manage\")\n      .option(\"--runtime-probe\", \"Opt-in runtime activation probe for manage output parity\")\n      .option(\"--fix-managed-state\", `Adopt unmanaged ${plural} before diagnostics/update checks`)\n      .description(`List managed ${plural} with update-check metadata.`),\n    vocabulary,\n  ).action(async (_options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(undefined, command.optsWithGlobals() as Record<string, unknown>, command, \"manage\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand\n      .command(\"describe\")\n      .argument(\"[target]\", `${noun[0]!.toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`)\n      .option(\"--markdown\", \"Render the surface map as a Markdown reference document instead of toon/json\")\n      .option(\"--output <path>\", \"Write Markdown output to a file (requires --markdown)\")\n      .description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`),\n    vocabulary,\n  ).action(async (target: string | undefined, _options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"describe\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand\n      .command(\"reload\")\n      .option(\"--watch\", \"Use watch mode for repeated reload checks\")\n      .description(`Reload ${plural} with cache-busted module imports.`),\n    vocabulary,\n  ).action(async (_options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(undefined, command.optsWithGlobals() as Record<string, unknown>, command, \"reload\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand\n      .command(\"doctor\")\n      .option(\"--detail <mode>\", `Detail mode for ${noun} diagnostics (summary|deep)`)\n      .option(\"--trace\", \"Include actionable registration traces in doctor deep diagnostics\")\n      .option(\"--fix-managed-state\", `Adopt unmanaged ${plural} before diagnostics/update checks`)\n      .option(\"--strict-exit\", \"Return non-zero exit when doctor warnings are present (ok=false)\")\n      .option(\"--fail-on-warn\", \"Alias for --strict-exit (doctor)\")\n      .description(`Run consolidated ${noun} diagnostics (summary/deep modes).`),\n    vocabulary,\n  ).action(async (_options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(undefined, command.optsWithGlobals() as Record<string, unknown>, command, \"doctor\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand\n      .command(\"catalog\")\n      .alias(\"list\")\n      .option(\"--fields <value>\", \"Render compact comma-separated catalog fields, for example: alias,installed,install_command\")\n      .description(`List bundled first-party ${noun} catalog metadata.`),\n    vocabulary,\n  ).action(async (_options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(undefined, command.optsWithGlobals() as Record<string, unknown>, command, \"catalog\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand\n      .command(\"adopt\")\n      .argument(\"<target>\", `${noun[0]!.toUpperCase()}${noun.slice(1)} name`)\n      .option(\"--gh <owner/repo[/path]>\", `GitHub provenance shorthand for adopted ${noun}`)\n      .option(\"--github <owner/repo[/path]>\", \"Alias for --gh\")\n      .option(\"--ref <ref>\", \"Git ref/branch/tag for GitHub shorthand source\")\n      .description(`Adopt an existing unmanaged ${noun} into managed metadata.`),\n    vocabulary,\n  ).action(async (target: string, _options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"adopt\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand.command(\"adopt-all\").description(`Adopt all unmanaged ${plural} into managed metadata.`),\n    vocabulary,\n  ).action(async (_options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(undefined, command.optsWithGlobals() as Record<string, unknown>, command, \"adopt-all\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand.command(\"activate\").argument(\"<target>\", `${noun[0]!.toUpperCase()}${noun.slice(1)} name`).description(`Activate a ${noun} in selected scope settings.`),\n    vocabulary,\n  ).action(async (target: string, _options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"activate\", vocabulary);\n  });\n\n  addLifecycleScopeOptions(\n    lifecycleCommand.command(\"deactivate\").argument(\"<target>\", `${noun[0]!.toUpperCase()}${noun.slice(1)} name`).description(`Deactivate a ${noun} in selected scope settings.`),\n    vocabulary,\n  ).action(async (target: string, _options: Record<string, unknown>, command) => {\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"deactivate\", vocabulary);\n  });\n}\n\n/**\n * Implements register setup commands for the public runtime surface of this module.\n */\nexport function registerSetupCommands(program: Command): void {\n  program\n    .command(\"init\")\n    .argument(\"[prefix-or-path]\", \"Optional id prefix, or path-like tracker target such as ./pm-sandbox\")\n    .option(\"--preset <value>\", \"Governance preset for new setups: minimal|default|strict\")\n    .option(\"--defaults\", \"Use non-interactive setup defaults without opening the wizard\")\n    .option(\"-y, --yes\", \"Alias for --defaults (non-interactive setup)\")\n    .option(\"--author <value>\", \"Set the default mutation author for this project\")\n    .option(\"--agent-guidance <mode>\", \"Agent guidance mode: ask|add|skip|status\")\n    .option(\"--type-preset <name>\", \"Register domain item types during init: agile|ops|research\")\n    .option(\"--with-packages\", \"Install all bundled first-party packages during initialization\")\n    .option(\"--force\", \"Allow initializing tracker files directly in a directory that looks like a workspace root\")\n    .option(\"--verbose\", \"Include the full resolved settings tree in the output (default output is a concise summary)\")\n    .description(\"Initialize pm storage and defaults for the current workspace or a path-like tracker target.\")\n    .action(async (prefix: string | undefined, options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const { runInit, summarizeInitResult } = await import(\"./commands/init.js\");\n      const result = await runInit(\n        prefix,\n        globalOptions,\n        {\n          preset: typeof options.preset === \"string\" ? options.preset : undefined,\n          defaults: options.defaults === true || options.yes === true,\n          author: typeof options.author === \"string\" ? options.author : undefined,\n          agentGuidance: typeof options.agentGuidance === \"string\" ? options.agentGuidance : undefined,\n          typePreset: typeof options.typePreset === \"string\" ? options.typePreset : undefined,\n          withPackages: options.withPackages === true,\n          force: options.force === true,\n        },\n      );\n      // Default (toon) output is a concise summary to minimize agent token cost.\n      // --json consumers and --verbose both receive the full settings tree.\n      const verbose = options.verbose === true;\n      const emitFullTree = verbose || globalOptions.json === true;\n      printResult(emitFullTree ? result : summarizeInitResult(result), globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=init took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"config\")\n    .argument(\"[scope]\", \"Config scope: project|global, or action shorthand list|export|get|set for project scope\")\n    .argument(\"[action]\", \"Config action: get|set|list|export\")\n    .argument(\n      \"[key]\",\n      \"Config key for get|set: definition-of-done|item-format|history-missing-stream-policy|sprint-release-format-policy|parent-reference-policy|metadata-validation-profile|metadata-required-fields|lifecycle-stale-blocker-reason-patterns|lifecycle-closure-like-blocked-reason-patterns|lifecycle-closure-like-resolution-patterns|lifecycle-closure-like-actual-result-patterns|governance-preset|governance-ownership-enforcement|governance-create-mode-default|governance-close-validation-default|governance-require-close-reason|governance-parent-reference-policy|governance-metadata-validation-profile|governance-force-required-for-stale-lock|test-result-tracking|telemetry-tracking|context\",\n    )\n    .argument(\n      \"[value]\",\n      \"Optional value for set: routed to the right typed flag by key (e.g. config set telemetry-tracking off, config set item-format toon, config set definition-of-done \\\"Tests pass\\\"). Equivalent to --policy/--format/--criterion. context keys still require --default-depth/--section-* flags.\",\n    )\n    .option(\n      \"--criterion <text>\",\n      \"Criteria value for definition-of-done, metadata-required-fields, or lifecycle pattern keys (repeatable for set)\",\n      collect,\n    )\n    .option(\"--clear-criteria\", \"Clear criteria-list keys for config set operations\")\n    .option(\"--format <value>\", \"Item format for item-format key: toon\")\n    .option(\n      \"--policy <value>\",\n      \"Policy key values: history-missing-stream-policy=auto_create|strict_error; sprint-release-format-policy=warn|strict_error; parent-reference-policy=warn|strict_error; governance-preset=minimal|default|strict|custom; governance-ownership-enforcement=none|warn|strict; governance-create-mode-default=progressive|strict; governance-close-validation-default=off|warn|strict; governance-require-close-reason=enabled|disabled; governance-parent-reference-policy=warn|strict_error; governance-metadata-validation-profile=core|strict|custom; governance-force-required-for-stale-lock=enabled|disabled; test-result-tracking=enabled|disabled; telemetry-tracking=enabled|disabled\",\n    )\n    .option(\n      \"--value <value>\",\n      \"Value for nested leaf settings keys (search_provider, search_mutation_refresh_policy, search_query_expansion_enabled, search_rerank_enabled, openai_base_url, ollama_model, vector_store_adapter, vector_store_collection_name, qdrant_url, lancedb_path, etc.). Equivalent to the positional value.\",\n    )\n    .option(\"--default-depth <value>\", \"Context default depth: brief|standard|deep\")\n    .option(\"--activity-limit <n>\", \"Context default activity limit\")\n    .option(\"--stale-threshold-days <n>\", \"Context staleness cutoff in days\")\n    .option(\"--section-hierarchy <value>\", \"Enable/disable context hierarchy section (true|false)\")\n    .option(\"--section-activity <value>\", \"Enable/disable context activity section (true|false)\")\n    .option(\"--section-progress <value>\", \"Enable/disable context progress section (true|false)\")\n    .option(\"--section-blockers <value>\", \"Enable/disable context blockers section (true|false)\")\n    .option(\"--section-files <value>\", \"Enable/disable context files section (true|false)\")\n    .option(\"--section-workload <value>\", \"Enable/disable context workload section (true|false)\")\n    .option(\"--section-staleness <value>\", \"Enable/disable context staleness section (true|false)\")\n    .option(\"--section-tests <value>\", \"Enable/disable context tests section (true|false)\")\n    .description(\"Read or update pm settings for the current workspace or global profile.\")\n    .action(async (scope: string | undefined, action: string | undefined, key: string | undefined, value: string | undefined, options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const criteria = Array.isArray(options.criterion) ? (options.criterion as string[]) : [];\n      const { runConfig } = await import(\"./commands/config.js\");\n      const actionShorthands = new Set([\"get\", \"set\", \"list\", \"export\"]);\n      const scopeShorthand = scope !== undefined && actionShorthands.has(scope);\n      const resolvedScope = scopeShorthand ? \"project\" : (scope ?? \"project\");\n      const resolvedAction = scopeShorthand ? scope : (action ?? \"list\");\n      // When scope is an action shorthand, positionals shift left by one:\n      // [set] [key] [value] -> action=set, key=key, value=value.\n      const resolvedKey = scopeShorthand ? action : key;\n      const resolvedValue = scopeShorthand ? key : value;\n      const result = await runConfig(\n        resolvedScope,\n        resolvedAction,\n        resolvedKey,\n        {\n          criterion: criteria,\n          format: typeof options.format === \"string\" ? options.format : undefined,\n          policy: typeof options.policy === \"string\" ? options.policy : undefined,\n          value: typeof options.value === \"string\" ? options.value : undefined,\n          clearCriteria: options.clearCriteria === true,\n          defaultDepth: typeof options.defaultDepth === \"string\" ? options.defaultDepth : undefined,\n          activityLimit: typeof options.activityLimit === \"string\" ? options.activityLimit : undefined,\n          staleThresholdDays: typeof options.staleThresholdDays === \"string\" ? options.staleThresholdDays : undefined,\n          sectionHierarchy: typeof options.sectionHierarchy === \"string\" ? options.sectionHierarchy : undefined,\n          sectionActivity: typeof options.sectionActivity === \"string\" ? options.sectionActivity : undefined,\n          sectionProgress: typeof options.sectionProgress === \"string\" ? options.sectionProgress : undefined,\n          sectionBlockers: typeof options.sectionBlockers === \"string\" ? options.sectionBlockers : undefined,\n          sectionFiles: typeof options.sectionFiles === \"string\" ? options.sectionFiles : undefined,\n          sectionWorkload: typeof options.sectionWorkload === \"string\" ? options.sectionWorkload : undefined,\n          sectionStaleness: typeof options.sectionStaleness === \"string\" ? options.sectionStaleness : undefined,\n          sectionTests: typeof options.sectionTests === \"string\" ? options.sectionTests : undefined,\n        },\n        globalOptions,\n        typeof resolvedValue === \"string\" ? resolvedValue : undefined,\n      );\n      printResult(result, globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=config took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  registerLifecycleCommand(program, \"extension\");\n  registerLifecycleCommand(program, \"package\");\n\n  addPackageScopeOptions(\n    program\n      .command(\"install\")\n      .argument(\"[targets...]\", \"Package source (local path, bundled alias, npm: source, wildcard, or GitHub source)\")\n      .option(\"--gh <github-source>\", \"Install from GitHub shorthand source (owner/repo[/path])\")\n      .option(\"--github <github-source>\", \"Alias for --gh\")\n      .option(\"--ref <ref>\", \"Git ref/branch/tag for GitHub install sources\")\n      .description(\"Install a pm package into the project package scope by default.\"),\n  ).action(async (targets: string[] | undefined, _options: Record<string, unknown>, command) => {\n    const target = await normalizeInstallTargets(targets);\n    await executeExtensionCommand(target, command.optsWithGlobals() as Record<string, unknown>, command, \"install\", \"package\");\n  });\n\n  addPackageScopeOptions(\n    program\n      .command(\"upgrade\")\n      .argument(\"[target]\", \"Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages\")\n      .option(\"--dry-run\", \"Plan CLI/package upgrades without running npm or reinstalling packages\")\n      .option(\"--cli-only\", \"Upgrade only the pm CLI/SDK npm package\")\n      .option(\"--packages-only\", \"Upgrade only managed pm packages\")\n      .option(\"--repair\", \"Force npm global reinstall when upgrading the pm CLI/SDK\")\n      .option(\"--tag <value>\", \"npm dist-tag/version for CLI and registry package upgrades\")\n      .option(\"--package-name <value>\", \"Override the CLI package name for self-upgrade testing\")\n      .description(\"Upgrade the pm CLI/SDK and refresh managed installable pm packages.\"),\n  ).action(async (target: string | undefined, _options: Record<string, unknown>, command) => {\n    const globalOptions = getGlobalOptions(command);\n    const startedAt = Date.now();\n    const { runUpgrade } = await import(\"./commands/upgrade.js\");\n    const result = await runUpgrade(target, command.opts() as Record<string, unknown>, globalOptions);\n    printResult(result, globalOptions);\n    if (!result.ok) {\n      process.exitCode = EXIT_CODE.GENERIC_FAILURE;\n    }\n    if (globalOptions.profile) {\n      printError(`profile:command=upgrade took_ms=${Date.now() - startedAt}`);\n    }\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli-bundle/chunks/{register-setup-G5LTSFYK.js → register-setup-N7UGXYJC.js}

@@ -1,31 +1,32 @@
 
-!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]="269b58b5-580f-5937-a240-9bd4b8bd6414")}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]="d20b3ae4-cc2b-5925-b3d4-f5af0db7d955")}catch(e){}}();
 import {
   collect,
   getGlobalOptions
-} from "./chunk-HC2S36NB.js";
-import "./chunk-OF7V47P3.js";
-import "./chunk-UACWNBL2.js";
+} from "./chunk-NIBP3I7A.js";
+import "./chunk-5IRVSKPS.js";
 import {
   printError,
-  printResult
-} from "./chunk-JPJDP4VU.js";
+  printResult,
+  writeStdout
+} from "./chunk-QE5UFCCO.js";
+import "./chunk-D5LYZVGB.js";
 import {
-  SCAFFOLD_CAPABILITIES
-} from "./chunk-NJ73ALW2.js";
-import "./chunk-J3NMWFIN.js";
-import "./chunk-KJZOSF7J.js";
-import "./chunk-FBLT6WGK.js";
-import "./chunk-ZLWRPBOW.js";
-import "./chunk-TKPP4GOO.js";
-import "./chunk-FMWW2JDU.js";
+  SCAFFOLD_CAPABILITIES,
+  renderExtensionDescribeMarkdown
+} from "./chunk-T7ZMQI4J.js";
+import "./chunk-C2KCIZKZ.js";
+import "./chunk-KGQ3W65B.js";
+import "./chunk-V3KLX7U7.js";
+import "./chunk-KRASIL6M.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-VSAABFGQ.js";
+} from "./chunk-CY5IJMUM.js";
 
 // dist/cli/register-setup.js
 import fs from "node:fs/promises";
+import path from "node:path";
 function normalizeExtensionOptions(options, forcedAction, vocabulary = "extension") {
   const isForcedAction = (action) => forcedAction === action;
   const readBoolean = (...keys) => keys.some((key) => options[key] === true);
@@ -45,6 +46,7 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     explore: isForcedAction("explore") || readBoolean("explore", "list"),
     manage: isForcedAction("manage") || readBoolean("manage"),
     describe: isForcedAction("describe") || readBoolean("describe"),
+    markdown: readBoolean("markdown"),
     reload: isForcedAction("reload") || readBoolean("reload"),
     doctor: isForcedAction("doctor") || readBoolean("doctor"),
     catalog: isForcedAction("catalog") || readBoolean("catalog"),
@@ -59,8 +61,10 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     github: readString("github"),
     ref: readString("ref"),
     capability: readString("capability"),
+    declarative: readBoolean("declarative"),
     fields: readString("fields"),
     detail: readString("detail"),
+    output: readString("output"),
     trace: readBoolean("trace"),
     watch: readBoolean("watch"),
     runtimeProbe: readBoolean("runtimeProbe", "runtime_probe", "runtime-probe"),
@@ -89,9 +93,43 @@ async function executeExtensionCommand(target, options, command, forcedAction, v
   const globalOptions = getGlobalOptions(command);
   const startedAt = Date.now();
   const normalizedOptions = normalizeExtensionOptions(options, forcedAction, vocabulary);
-  const { runExtension } = await import("./extension-3JYWJ5K2.js");
+  const wantsMarkdown = normalizedOptions.markdown === true;
+  const outputOption = typeof normalizedOptions.output === "string" ? normalizedOptions.output : void 0;
+  const outputPath = outputOption?.trim();
+  if (outputOption !== void 0 && outputPath === "") {
+    throw new PmCliError("--output requires a non-empty file path.", EXIT_CODE.USAGE);
+  }
+  if (outputPath !== void 0 && !wantsMarkdown) {
+    throw new PmCliError("--output is only supported with --markdown describe output.", EXIT_CODE.USAGE);
+  }
+  if (wantsMarkdown) {
+    if (globalOptions.json) {
+      throw new PmCliError("Cannot combine --json with --markdown.", EXIT_CODE.USAGE);
+    }
+    if (normalizedOptions.describe !== true) {
+      throw new PmCliError("--markdown is only supported by the describe action.", EXIT_CODE.USAGE);
+    }
+  }
+  const { runExtension } = await import("./extension-3LRYX7SW.js");
   const result = await runExtension(target, normalizedOptions, globalOptions);
-  printResult(result, globalOptions);
+  if (wantsMarkdown) {
+    const markdown = renderExtensionDescribeMarkdown(result.details, vocabulary);
+    if (outputPath !== void 0) {
+      const resolvedOutputPath = path.resolve(outputPath);
+      await fs.mkdir(path.dirname(resolvedOutputPath), { recursive: true });
+      await fs.writeFile(resolvedOutputPath, markdown, "utf8");
+    }
+    if (!globalOptions.quiet) {
+      for (const warning of result.warnings) {
+        printError(`warning: ${warning}`);
+      }
+      if (outputPath === void 0) {
+        writeStdout(markdown);
+      }
+    }
+  } else {
+    printResult(result, globalOptions);
+  }
   const strictExit = Boolean(normalizedOptions.strictExit) || Boolean(normalizedOptions.failOnWarn);
   if (result.action === "doctor" && strictExit) {
     const detailsRecord = result.details;
@@ -119,13 +157,18 @@ function registerLifecycleCommand(program, vocabulary) {
   const noun = vocabulary === "package" ? "package" : "extension";
   const plural = vocabulary === "package" ? "packages" : "extensions";
   const commandName = vocabulary;
-  const lifecycleCommand = program.command(commandName).argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} source/name or scaffold target path (for --init/--scaffold)`).option("--init", `Generate a starter ${noun} scaffold at target path`).option("--scaffold", "Alias for --init").option("--capability <kind>", `Capability the --init starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).option("--install", `Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source`).option("--uninstall", `Uninstall an installed ${noun}`).option("--explore", `List discovered ${plural} in selected scope`).option("--list", "Alias for --explore").option("--manage", `List managed ${plural} with update-check metadata`).option("--describe", `Map every surface a loaded ${noun} registers (optionally one by name)`).option("--reload", `Reload ${plural} with cache-busted module imports`).option("--watch", "Use watch mode with --reload").option("--doctor", `Run consolidated ${noun} diagnostics (summary/deep modes)`).option("--catalog", `List bundled first-party ${noun} catalog metadata`).option("--adopt", `Adopt an existing unmanaged ${noun} into managed metadata`).option("--adopt-all", `Adopt all unmanaged ${plural} into managed metadata`).option("--activate", `Activate a ${noun} in selected scope settings`).option("--deactivate", `Deactivate a ${noun} in selected scope settings`).option("--project", `Use project ${noun} scope (default)`).option("--local", "Alias for --project").option("--global", `Use global ${noun} scope`).option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>", "Alias for --gh").option("--ref <ref>", "Git ref/branch/tag for GitHub install sources").option("--detail <mode>", `${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`).option("--trace", "Include actionable registration traces in doctor deep diagnostics").option("--runtime-probe", "Opt-in runtime activation probe for manage output parity").option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`).option("--strict-exit", "Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn", "Alias for --strict-exit (doctor)").description(vocabulary === "package" ? "Manage package lifecycle operations for project or global scope. Backward-compatible with extension packages." : "Manage extension lifecycle operations for project or global scope.").action(async (target, _options, command) => {
+  const lifecycleCommand = program.command(commandName).argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} source/name or scaffold target path (for --init/--scaffold)`).option("--init", `Generate a starter ${noun} scaffold at target path`).option("--scaffold", "Alias for --init").option("--capability <kind>", `Capability the --init starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).option("--install", `Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source`).option("--uninstall", `Uninstall an installed ${noun}`).option("--explore", `List discovered ${plural} in selected scope`).option("--list", "Alias for --explore").option("--manage", `List managed ${plural} with update-check metadata`).option("--describe", `Map every surface a loaded ${noun} registers (optionally one by name)`).option("--markdown", "Render describe output as a Markdown reference document (describe only)").option("--output <path>", "Write describe Markdown to a file (requires --markdown)").option("--reload", `Reload ${plural} with cache-busted module imports`).option("--watch", "Use watch mode with --reload").option("--doctor", `Run consolidated ${noun} diagnostics (summary/deep modes)`).option("--catalog", `List bundled first-party ${noun} catalog metadata`).option("--adopt", `Adopt an existing unmanaged ${noun} into managed metadata`).option("--adopt-all", `Adopt all unmanaged ${plural} into managed metadata`).option("--activate", `Activate a ${noun} in selected scope settings`).option("--deactivate", `Deactivate a ${noun} in selected scope settings`).option("--project", `Use project ${noun} scope (default)`).option("--local", "Alias for --project").option("--global", `Use global ${noun} scope`).option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>", "Alias for --gh").option("--ref <ref>", "Git ref/branch/tag for GitHub install sources").option("--detail <mode>", `${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`).option("--trace", "Include actionable registration traces in doctor deep diagnostics").option("--runtime-probe", "Opt-in runtime activation probe for manage output parity").option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`).option("--strict-exit", "Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn", "Alias for --strict-exit (doctor)").description(vocabulary === "package" ? "Manage package lifecycle operations for project or global scope. Backward-compatible with extension packages." : "Manage extension lifecycle operations for project or global scope.").action(async (target, _options, command) => {
     await executeExtensionCommand(target, command.optsWithGlobals(), command, void 0, vocabulary);
   });
   if (vocabulary === "package") {
     lifecycleCommand.alias("packages");
+    lifecycleCommand.option("--declarative", "Scaffold the composeExtension blueprint starter (any capability)");
+  }
+  const initCommand = lifecycleCommand.command("init").alias("scaffold").argument("<target>", `Scaffold target directory path`).option("--capability <kind>", `Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).description(vocabulary === "package" ? "Generate a starter package scaffold with package metadata, manifest, and entrypoint." : "Generate a starter extension scaffold with manifest and entrypoint.");
+  if (vocabulary === "package") {
+    initCommand.option("--declarative", "Scaffold the composeExtension blueprint starter (any capability)");
   }
-  addLifecycleScopeOptions(lifecycleCommand.command("init").alias("scaffold").argument("<target>", `Scaffold target directory path`).option("--capability <kind>", `Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`).description(vocabulary === "package" ? "Generate a starter package scaffold with package metadata, manifest, and entrypoint." : "Generate a starter extension scaffold with manifest and entrypoint."), vocabulary).action(async (target, _options, command) => {
+  addLifecycleScopeOptions(initCommand, vocabulary).action(async (target, _options, command) => {
     await executeExtensionCommand(target, command.optsWithGlobals(), command, "init", vocabulary);
   });
   addLifecycleScopeOptions(lifecycleCommand.command("install").argument("[targets...]", `${noun[0].toUpperCase()}${noun.slice(1)} source (local path, bundled alias, npm: source, wildcard, or GitHub source)`).option("--gh <github-source>", "Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>", "Alias for --gh").option("--ref <ref>", "Git ref/branch/tag for GitHub install sources").description(`Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source.`), vocabulary).action(async (targets, _options, command) => {
@@ -141,7 +184,7 @@ function registerLifecycleCommand(program, vocabulary) {
   addLifecycleScopeOptions(lifecycleCommand.command("manage").option("--runtime-probe", "Opt-in runtime activation probe for manage output parity").option("--fix-managed-state", `Adopt unmanaged ${plural} before diagnostics/update checks`).description(`List managed ${plural} with update-check metadata.`), vocabulary).action(async (_options, command) => {
     await executeExtensionCommand(void 0, command.optsWithGlobals(), command, "manage", vocabulary);
   });
-  addLifecycleScopeOptions(lifecycleCommand.command("describe").argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`).description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`), vocabulary).action(async (target, _options, command) => {
+  addLifecycleScopeOptions(lifecycleCommand.command("describe").argument("[target]", `${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`).option("--markdown", "Render the surface map as a Markdown reference document instead of toon/json").option("--output <path>", "Write Markdown output to a file (requires --markdown)").description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`), vocabulary).action(async (target, _options, command) => {
     await executeExtensionCommand(target, command.optsWithGlobals(), command, "describe", vocabulary);
   });
   addLifecycleScopeOptions(lifecycleCommand.command("reload").option("--watch", "Use watch mode for repeated reload checks").description(`Reload ${plural} with cache-busted module imports.`), vocabulary).action(async (_options, command) => {
@@ -170,7 +213,7 @@ function registerSetupCommands(program) {
   program.command("init").argument("[prefix-or-path]", "Optional id prefix, or path-like tracker target such as ./pm-sandbox").option("--preset <value>", "Governance preset for new setups: minimal|default|strict").option("--defaults", "Use non-interactive setup defaults without opening the wizard").option("-y, --yes", "Alias for --defaults (non-interactive setup)").option("--author <value>", "Set the default mutation author for this project").option("--agent-guidance <mode>", "Agent guidance mode: ask|add|skip|status").option("--type-preset <name>", "Register domain item types during init: agile|ops|research").option("--with-packages", "Install all bundled first-party packages during initialization").option("--force", "Allow initializing tracker files directly in a directory that looks like a workspace root").option("--verbose", "Include the full resolved settings tree in the output (default output is a concise summary)").description("Initialize pm storage and defaults for the current workspace or a path-like tracker target.").action(async (prefix, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runInit, summarizeInitResult } = await import("./init-HBFGYS66.js");
+    const { runInit, summarizeInitResult } = await import("./init-KO7CGIRQ.js");
     const result = await runInit(prefix, globalOptions, {
       preset: typeof options.preset === "string" ? options.preset : void 0,
       defaults: options.defaults === true || options.yes === true,
@@ -191,7 +234,7 @@ function registerSetupCommands(program) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
     const criteria = Array.isArray(options.criterion) ? options.criterion : [];
-    const { runConfig } = await import("./config-SW3U7XP2.js");
+    const { runConfig } = await import("./config-X3ZVCUUG.js");
     const actionShorthands = /* @__PURE__ */ new Set(["get", "set", "list", "export"]);
     const scopeShorthand = scope !== void 0 && actionShorthands.has(scope);
     const resolvedScope = scopeShorthand ? "project" : scope ?? "project";
@@ -230,7 +273,7 @@ function registerSetupCommands(program) {
   addPackageScopeOptions(program.command("upgrade").argument("[target]", "Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").option("--dry-run", "Plan CLI/package upgrades without running npm or reinstalling packages").option("--cli-only", "Upgrade only the pm CLI/SDK npm package").option("--packages-only", "Upgrade only managed pm packages").option("--repair", "Force npm global reinstall when upgrading the pm CLI/SDK").option("--tag <value>", "npm dist-tag/version for CLI and registry package upgrades").option("--package-name <value>", "Override the CLI package name for self-upgrade testing").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages.")).action(async (target, _options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runUpgrade } = await import("./upgrade-FOZKQTQF.js");
+    const { runUpgrade } = await import("./upgrade-77FRUAXN.js");
     const result = await runUpgrade(target, command.opts(), globalOptions);
     printResult(result, globalOptions);
     if (!result.ok) {
@@ -244,6 +287,6 @@ function registerSetupCommands(program) {
 export {
   registerSetupCommands
 };
-//# sourceMappingURL=register-setup-G5LTSFYK.js.map
+//# sourceMappingURL=register-setup-N7UGXYJC.js.map
 
-//# debugId=269b58b5-580f-5937-a240-9bd4b8bd6414
+//# debugId=d20b3ae4-cc2b-5925-b3d4-f5af0db7d955