@unbrained/pm-cli 2026.6.21 → 2026.6.23

package/dist/cli-bundle/chunks/{register-operations-MIDTRW7S.js → register-operations-U5JAW3WE.js}

@@ -4,18 +4,18 @@ import {
   collect,
   getGlobalOptions,
   invalidateSearchCachesForMutation
-} from "./chunk-RLK7P77C.js";
-import "./chunk-HC4AWIKT.js";
-import "./chunk-NB3PYLQ6.js";
+} from "./chunk-HFFUQR73.js";
+import "./chunk-CKGNPJAG.js";
+import "./chunk-DT5LPYOD.js";
 import {
   printError,
   printResult
-} from "./chunk-6H4LF7AO.js";
-import "./chunk-SX75ADBK.js";
-import "./chunk-7D3SAQXM.js";
-import "./chunk-QGG32QHW.js";
-import "./chunk-FRUFKWNK.js";
-import "./chunk-YCJX76PW.js";
+} from "./chunk-O6LLO73I.js";
+import "./chunk-IPKJ6B36.js";
+import "./chunk-7MRQ4HMK.js";
+import "./chunk-NCVCO3NZ.js";
+import "./chunk-YJ3SUEPD.js";
+import "./chunk-P77P2ILI.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -24,7 +24,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   setActiveCommandResult
-} from "./chunk-HMOADQVT.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/cli/register-operations.js
 !(function() {
@@ -75,7 +75,7 @@ function registerOperationCommands(program) {
       throw new PmCliError("--background does not support --add/--add-json/--remove; update linked tests first, then run in background", EXIT_CODE.USAGE);
     }
     if (runInBackground) {
-      const { runStartBackgroundRun } = await import("./test-runs-AJHR6IQF.js");
+      const { runStartBackgroundRun } = await import("./test-runs-IAJDL6CA.js");
       const result2 = await runStartBackgroundRun({
         kind: "test",
         commandArgs: buildBackgroundTestCommandArgs(id, { ...options, add: addValues, addJson: addJsonValues, remove: removeValues }),
@@ -89,7 +89,7 @@ function registerOperationCommands(program) {
       }
       return;
     }
-    const { runTest } = await import("./test-RQCTSWUK.js");
+    const { runTest } = await import("./test-QJXLKV26.js");
     const result = await runTest(id, {
       add: addValues,
       addJson: addJsonValues,
@@ -132,7 +132,7 @@ function registerOperationCommands(program) {
     const startedAt = Date.now();
     const runInBackground = options.background === true;
     if (runInBackground) {
-      const { runStartBackgroundRun } = await import("./test-runs-AJHR6IQF.js");
+      const { runStartBackgroundRun } = await import("./test-runs-IAJDL6CA.js");
       const result2 = await runStartBackgroundRun({
         kind: "test-all",
         commandArgs: buildBackgroundTestAllCommandArgs(options),
@@ -145,7 +145,7 @@ function registerOperationCommands(program) {
       }
       return;
     }
-    const { runTestAll } = await import("./test-all-NJ5V2QFS.js");
+    const { runTestAll } = await import("./test-all-DPN62TX7.js");
     const result = await runTestAll({
       status: typeof options.status === "string" ? options.status : void 0,
       limit: typeof options.limit === "string" ? options.limit : void 0,
@@ -175,13 +175,13 @@ function registerOperationCommands(program) {
   });
   program.command("test-runs-worker", { hidden: true }).argument("<runId>", "Background run id").description("Internal background worker command.").action(async (runId, _options, command) => {
     const globalOptions = getGlobalOptions(command);
-    const { runTestRunsWorker } = await import("./test-runs-AJHR6IQF.js");
+    const { runTestRunsWorker } = await import("./test-runs-IAJDL6CA.js");
     await runTestRunsWorker(runId, globalOptions);
   });
   program.command("telemetry").argument("[namespaceOrSubcommand]", "Telemetry subcommand: status, flush, stats, clear (default: status)").argument("[subcommand]", "Compatibility alias target for local-analytics: status, flush, stats, clear").option("--limit <n>", "Maximum command groups returned by telemetry stats").description("Inspect and manage local telemetry queue/runtime state.").action(async (namespaceOrSubcommand, subcommand, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runTelemetry } = await import("./telemetry-PP3FUNBU.js");
+    const { runTelemetry } = await import("./telemetry-7DIGDQUO.js");
     const result = await runTelemetry({
       subcommand: resolveTelemetrySubcommand(namespaceOrSubcommand, subcommand),
       // Commander always parses `--limit <n>` to a string (or leaves it
@@ -196,7 +196,7 @@ function registerOperationCommands(program) {
   program.command("stats").description("Show project tracker statistics.").option("--storage", "Include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries)").option("--metadata-coverage", "Include metadata coverage % (acceptance_criteria, estimated_minutes, resolution, tags, parent) overall and by type").option("--by-assignee", "Include a lifecycle-bucketed item breakdown grouped by assignee").option("--by-tag", "Include a lifecycle-bucketed item breakdown grouped by tag").option("--by-priority", "Include a lifecycle-bucketed item breakdown grouped by priority").option("--tag-prefix <value>", "With --by-tag: only count tags starting with this prefix (e.g. domain:)").option("--field-utilization", "Report content-field utilization rates (notes/learnings/files/docs/tests/comments/deps/body) for governance audits").action(async (options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runStats } = await import("./stats-VPBGSRQH.js");
+    const { runStats } = await import("./stats-R5OAJVZK.js");
     const result = await runStats(globalOptions, {
       storage: options.storage === true,
       metadataCoverage: options.metadataCoverage === true,
@@ -214,7 +214,7 @@ function registerOperationCommands(program) {
   program.command("health").description("Show project tracker health checks.").option("--strict-directories", "Treat optional item-type directories as required failures").option("--check-only", "Run read-only health diagnostics without refreshing vectors").option("--check-telemetry", "Probe telemetry endpoint health and include network diagnostics").option("--no-refresh", "Disable automatic vector refresh attempts during health checks").option("--refresh-vectors", "Explicitly enable vector refresh attempts during health checks").option("--verbose-stale-items", "Include full stale vectorization ID lists in health output").option("--brief", "Emit compact health details for low-token agent checks").option("--summary", "Emit one-line-style health status with check names and warning count").option("--skip-vectors", "Skip vectorization check for a faster run").option("--skip-integrity", "Skip item/history file integrity check for a faster run").option("--skip-drift", "Skip history drift hash check for a faster run").option("--full", "Run all checks including slow integrity, drift, and vectorization checks").option("--strict-exit", "Return non-zero exit when health is not ok (advisory telemetry warnings are excluded; see warnings[])").option("--fail-on-warn", "Alias for --strict-exit").action(async (options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runHealth } = await import("./health-WOYBR3KU.js");
+    const { runHealth } = await import("./health-5EXTY44Q.js");
     const result = await runHealth(globalOptions, {
       strictDirectories: Boolean(options.strictDirectories),
       checkOnly: Boolean(options.checkOnly),
@@ -249,7 +249,7 @@ function registerOperationCommands(program) {
   program.command("validate").description("Run standalone metadata, resolution, lifecycle, files, linked-command reference, and history drift validation checks.").option("--check-metadata", "Run metadata completeness checks").option("--metadata-profile <value>", "Select metadata validation profile for --check-metadata (core|strict|custom)").option("--check-resolution", "Run closed-item resolution metadata checks").option("--check-lifecycle", "Run active-item lifecycle governance drift checks").option("--check-stale-blockers", "Include stale blocker-pattern diagnostics in lifecycle checks").option("--dependency-cycle-severity <value>", "Set dependency-cycle warning policy for lifecycle checks (off|warn|error)").option("--parent-cycle-severity <value>", "Set parent-hierarchy cycle warning policy for lifecycle checks (off|warn|error)").option("--check-files", "Run linked-file and orphaned-file checks").option("--check-command-references", "Run linked-command PM-ID reference checks").option("--scan-mode <value>", "Select file candidate scan mode for --check-files (default|tracked-all|tracked-all-strict)").option("--include-pm-internals", "Include PM storage internals in tracked-all candidate scans").option("--verbose-file-lists", "Include full file-path lists for validate --check-files details").option("--verbose-diagnostics", "Include full validate diagnostic ID lists instead of compact summaries").option("--all-affected-ids", "Emit complete missing_* affected-ID lists with no truncation (implied by --json)").option("--strict-exit", "Return non-zero exit when validation warnings are present").option("--fail-on-warn", "Alias for --strict-exit").option("--fix-hints", "Add a machine-executable fix_hints[] of pm commands to each failing check's details").option("--auto-fix", "Apply the safe, deterministic subset of fix-hint remediations (field backfills) automatically").option("--dry-run", "Preview planned --auto-fix/--prune-missing fixes without applying them").option("--fix-scope <scope>", "Grant --auto-fix scopes (metadata, resolution, lifecycle; comma-separated or repeatable). Default: metadata, resolution; lifecycle must be named explicitly", collect).option("--prune-missing", "Remove stale linked-file/doc LINKS whose paths classified as deleted (never touches real files)").option("--check-history-drift", "Run item/history hash drift checks").action(async (options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runValidate } = await import("./validate-PHKIYGSY.js");
+    const { runValidate } = await import("./validate-6QWQVCX2.js");
     const result = await runValidate({
       checkMetadata: Boolean(options.checkMetadata),
       metadataProfile: typeof options.metadataProfile === "string" ? options.metadataProfile : void 0,
@@ -292,7 +292,7 @@ function registerOperationCommands(program) {
   program.command("gc").option("--dry-run", "Preview cleanup targets without deleting files; without this flag, pm gc deletes matched artifacts").option("--scope <value>", "Limit cleanup to one or more scopes (comma-separated or repeatable): index, embeddings, runtime, locks, checkpoints", collect).description("Delete optional cache artifacts by default (including expired lock debris) and show a summary.").action(async (options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runGc } = await import("./gc-ZC7JHBG7.js");
+    const { runGc } = await import("./gc-PYVVEELM.js");
     const result = await runGc(globalOptions, {
       dryRun: options.dryRun === true,
       scope: Array.isArray(options.scope) ? options.scope : []
@@ -305,7 +305,7 @@ function registerOperationCommands(program) {
   program.command("contracts").description("Show machine-readable command and schema contracts for agents.").option("--action <value>", "Filter tool schema branches to a specific action").option("--command <value>", "Scope contracts output to one CLI command (narrow-by-default)").option("--schema-only", "Return schema-focused output only").option("--flags-only", "Return command flag contracts only").option("--availability-only", "Return action availability surface only").option("--runtime-only", "Include only actions invocable in the current runtime").option("--active-only", "Alias for --runtime-only").option("--full", "Include full schema and command-flag surfaces (large; default brief output omits heavy sections for unfiltered queries)").action(async (options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runContracts } = await import("./contracts-3THOLA7L.js");
+    const { runContracts } = await import("./contracts-C3SZCXXG.js");
     const result = await runContracts({
       action: typeof options.action === "string" ? options.action : void 0,
       command: typeof options.command === "string" ? options.command : void 0,
@@ -323,7 +323,7 @@ function registerOperationCommands(program) {
   program.command("claim").argument("<id>", "Item id").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--force", "Force claim override").option("--if-available", "Skip silently when the item is already claimed by another author (returns skipped=true)").description("Claim an item for active work.").action(async (id, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runClaim } = await import("./claim-THOJ6CMV.js");
+    const { runClaim } = await import("./claim-CSPJFLNH.js");
     const result = await runClaim(id, Boolean(options.force), globalOptions, {
       author: typeof options.author === "string" ? options.author : void 0,
       message: typeof options.message === "string" ? options.message : void 0,
@@ -338,7 +338,7 @@ function registerOperationCommands(program) {
   program.command("release").argument("<id>", "Item id").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--allow-audit-release", "Allow non-owner release handoffs without requiring --force").option("--force", "Force release override").description("Release an item's active claim.").action(async (id, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runRelease } = await import("./claim-THOJ6CMV.js");
+    const { runRelease } = await import("./claim-CSPJFLNH.js");
     const result = await runRelease(id, Boolean(options.force), globalOptions, {
       author: typeof options.author === "string" ? options.author : void 0,
       message: typeof options.message === "string" ? options.message : void 0,
@@ -363,8 +363,8 @@ function registerOperationCommands(program) {
       message: typeof options.message === "string" ? options.message : void 0
     };
     const [{ runClaim }, { runUpdate }] = await Promise.all([
-      import("./claim-THOJ6CMV.js"),
-      import("./update-6YXOGHRT.js")
+      import("./claim-CSPJFLNH.js"),
+      import("./update-IWUCXVH2.js")
     ]);
     const claimResult = await runClaim(id, force, globalOptions, mutationOptions);
     await invalidateSearchCachesForMutation(globalOptions, claimResult);
@@ -388,8 +388,8 @@ function registerOperationCommands(program) {
       message: typeof options.message === "string" ? options.message : void 0
     };
     const [{ runUpdate }, { runRelease }] = await Promise.all([
-      import("./update-6YXOGHRT.js"),
-      import("./claim-THOJ6CMV.js")
+      import("./update-IWUCXVH2.js"),
+      import("./claim-CSPJFLNH.js")
     ]);
     const updateResult = await runUpdate(id, { ...mutationOptions, status: openStatus, force }, globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, updateResult);
@@ -409,8 +409,8 @@ function registerOperationCommands(program) {
       message: typeof options.message === "string" ? options.message : void 0
     };
     const [{ runClose }, { runRelease }] = await Promise.all([
-      import("./close-DNMHGOCX.js"),
-      import("./claim-THOJ6CMV.js")
+      import("./close-A3EMKBBY.js"),
+      import("./claim-CSPJFLNH.js")
     ]);
     const closeResult = await runClose(id, reason, {
       ...mutationOptions,
@@ -450,7 +450,7 @@ function registerSchedulingShortcutCommands(program) {
     program.command(name).argument("<title>", "Item title").option("--start <when>", "Start time (ISO, 'now', or relative like +1h/+2d); defaults to now").option("--duration <span>", "Duration from start (relative like 1h/2d); defaults to 1h when --end is omitted").option("--end <when>", "End time (ISO or relative); overrides --duration").option("--location <value>", "Location").option("--timezone <value>", "IANA timezone (for example America/New_York)").option("--all-day", "Mark as an all-day event").option("--parent <id>", "Parent item id").option("--allow-missing-parent", "Permit a parent id that does not exist yet").option("--tags <list>", "Comma-separated tags").option("--priority <value>", "Priority").option("--body <text>", "Body/markdown content").option("--description <text>", "Short description").option("--author <value>", "Mutation author").option("--message <value>", "History message").description(describe).action(async (title, options, command) => {
       const globalOptions = getGlobalOptions(command);
       const startedAt = Date.now();
-      const { runMeet, runEvent } = await import("./scheduling-shortcuts-HJMTEXKE.js");
+      const { runMeet, runEvent } = await import("./scheduling-shortcuts-OQVJXG3M.js");
       const run = name === "meet" ? runMeet : runEvent;
       const result = await run(title, {
         ...buildShortcutCommonOptions(options),
@@ -471,7 +471,7 @@ function registerSchedulingShortcutCommands(program) {
   program.command("remind").argument("<title>", "Item title").option("--at <when>", "Reminder time (ISO, 'now', or relative like +2d); defaults to +1d").option("--text <value>", "Reminder text; defaults to the title").option("--parent <id>", "Parent item id").option("--allow-missing-parent", "Permit a parent id that does not exist yet").option("--tags <list>", "Comma-separated tags").option("--priority <value>", "Priority").option("--body <text>", "Body/markdown content").option("--description <text>", "Short description").option("--author <value>", "Mutation author").option("--message <value>", "History message").description("Shortcut: create a Reminder from a single point in time.").action(async (title, options, command) => {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const { runRemind } = await import("./scheduling-shortcuts-HJMTEXKE.js");
+    const { runRemind } = await import("./scheduling-shortcuts-OQVJXG3M.js");
     const result = await runRemind(title, {
       ...buildShortcutCommonOptions(options),
       at: optionalString(options.at),
@@ -488,4 +488,4 @@ export {
   registerOperationCommands,
   resolveStartTaskInProgressStatus
 };
-//# sourceMappingURL=register-operations-MIDTRW7S.js.map
+//# sourceMappingURL=register-operations-U5JAW3WE.js.map

package/dist/cli-bundle/chunks/{register-setup-EG2U6CEU.js → register-setup-KBXQDCXE.js}

@@ -1,29 +1,33 @@
 import {
   collect,
   getGlobalOptions
-} from "./chunk-RLK7P77C.js";
-import "./chunk-HC4AWIKT.js";
-import "./chunk-NB3PYLQ6.js";
+} from "./chunk-HFFUQR73.js";
+import "./chunk-CKGNPJAG.js";
+import "./chunk-DT5LPYOD.js";
 import {
   printError,
   printResult
-} from "./chunk-6H4LF7AO.js";
-import "./chunk-SX75ADBK.js";
-import "./chunk-7D3SAQXM.js";
-import "./chunk-QGG32QHW.js";
-import "./chunk-FRUFKWNK.js";
-import "./chunk-YCJX76PW.js";
+} from "./chunk-O6LLO73I.js";
+import {
+  SCAFFOLD_CAPABILITIES
+} from "./chunk-MVKFOLLM.js";
+import "./chunk-5VOINNKT.js";
+import "./chunk-IPKJ6B36.js";
+import "./chunk-7MRQ4HMK.js";
+import "./chunk-NCVCO3NZ.js";
+import "./chunk-YJ3SUEPD.js";
+import "./chunk-P77P2ILI.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-HMOADQVT.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/cli/register-setup.js
 import fs from "node:fs/promises";
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "8e286943-08f4-5187-ac60-762c7fb01175");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c4792f03-c5dc-5b99-ab49-70b2b20c9c7c");
   } catch (e2) {
   }
 })();
@@ -45,6 +49,7 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     uninstall: isForcedAction("uninstall") || readBoolean("uninstall"),
     explore: isForcedAction("explore") || readBoolean("explore", "list"),
     manage: isForcedAction("manage") || readBoolean("manage"),
+    describe: isForcedAction("describe") || readBoolean("describe"),
     reload: isForcedAction("reload") || readBoolean("reload"),
     doctor: isForcedAction("doctor") || readBoolean("doctor"),
     catalog: isForcedAction("catalog") || readBoolean("catalog"),
@@ -58,6 +63,7 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     gh: readString("gh"),
     github: readString("github"),
     ref: readString("ref"),
+    capability: readString("capability"),
     fields: readString("fields"),
     detail: readString("detail"),
     trace: readBoolean("trace"),
@@ -88,7 +94,7 @@ 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-46NWACO3.js");
+  const { runExtension } = await import("./extension-UTTQDUYI.js");
   const result = await runExtension(target, normalizedOptions, globalOptions);
   printResult(result, globalOptions);
   const strictExit = Boolean(normalizedOptions.strictExit) || Boolean(normalizedOptions.failOnWarn);
@@ -118,13 +124,13 @@ 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("--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("--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("--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");
   }
-  addLifecycleScopeOptions(lifecycleCommand.command("init").alias("scaffold").argument("<target>", `Scaffold target directory path`).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(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) => {
     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) => {
@@ -140,6 +146,9 @@ 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) => {
+    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) => {
     await executeExtensionCommand(void 0, command.optsWithGlobals(), command, "reload", vocabulary);
   });
@@ -166,7 +175,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-SC2P6CHP.js");
+    const { runInit, summarizeInitResult } = await import("./init-RCRKW5PL.js");
     const result = await runInit(prefix, globalOptions, {
       preset: typeof options.preset === "string" ? options.preset : void 0,
       defaults: options.defaults === true || options.yes === true,
@@ -187,7 +196,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-OZCUABPB.js");
+    const { runConfig } = await import("./config-D3OKQO52.js");
     const actionShorthands = /* @__PURE__ */ new Set(["get", "set", "list", "export"]);
     const scopeShorthand = scope !== void 0 && actionShorthands.has(scope);
     const resolvedScope = scopeShorthand ? "project" : scope ?? "project";
@@ -226,7 +235,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-TJXFLZIX.js");
+    const { runUpgrade } = await import("./upgrade-UBNLBZNR.js");
     const result = await runUpgrade(target, command.opts(), globalOptions);
     printResult(result, globalOptions);
     if (!result.ok) {
@@ -240,4 +249,4 @@ function registerSetupCommands(program) {
 export {
   registerSetupCommands
 };
-//# sourceMappingURL=register-setup-EG2U6CEU.js.map
+//# sourceMappingURL=register-setup-KBXQDCXE.js.map

package/dist/cli-bundle/chunks/register-setup-KBXQDCXE.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 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} from \"./registration-helpers.js\";\nimport { SCAFFOLD_CAPABILITIES } from \"./commands/extension/scaffold.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    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    fields: readString(\"fields\"),\n    detail: readString(\"detail\"),\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 { runExtension } = await import(\"./commands/extension.js\");\n  const result = await runExtension(target, normalizedOptions, globalOptions);\n  printResult(result, globalOptions);\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(\"--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  }\n\n  addLifecycleScopeOptions(\n    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    vocabulary,\n  ).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      .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-DYBFLEZX.js → register-setup-RCRUHMSZ.js}

@@ -1,24 +1,28 @@
 
-!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]="16f5945a-62b5-5ddb-bd80-2687d959f6a7")}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]="269b58b5-580f-5937-a240-9bd4b8bd6414")}catch(e){}}();
 import {
   collect,
   getGlobalOptions
-} from "./chunk-5FIEHKEX.js";
-import "./chunk-A4Z7ZOL5.js";
-import "./chunk-OTHIWLMB.js";
+} from "./chunk-YUDJD3XO.js";
+import "./chunk-2BFPAUAF.js";
+import "./chunk-7K2XXO4I.js";
 import {
   printError,
   printResult
-} from "./chunk-AIS5PGI3.js";
-import "./chunk-NIUEXCFS.js";
-import "./chunk-D7FYS6PG.js";
-import "./chunk-LEU5GHRC.js";
-import "./chunk-QZTWBFXJ.js";
-import "./chunk-NSBZ2CKF.js";
+} from "./chunk-NK3UPBVG.js";
+import {
+  SCAFFOLD_CAPABILITIES
+} from "./chunk-C5AOG6D2.js";
+import "./chunk-4BHT5VDC.js";
+import "./chunk-5UVVASSA.js";
+import "./chunk-S2RUQSX2.js";
+import "./chunk-VAYA4XFX.js";
+import "./chunk-YDEXO24S.js";
+import "./chunk-2T3JG6V4.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-434HM6Z5.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/cli/register-setup.js
 import fs from "node:fs/promises";
@@ -40,6 +44,7 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     uninstall: isForcedAction("uninstall") || readBoolean("uninstall"),
     explore: isForcedAction("explore") || readBoolean("explore", "list"),
     manage: isForcedAction("manage") || readBoolean("manage"),
+    describe: isForcedAction("describe") || readBoolean("describe"),
     reload: isForcedAction("reload") || readBoolean("reload"),
     doctor: isForcedAction("doctor") || readBoolean("doctor"),
     catalog: isForcedAction("catalog") || readBoolean("catalog"),
@@ -53,6 +58,7 @@ function normalizeExtensionOptions(options, forcedAction, vocabulary = "extensio
     gh: readString("gh"),
     github: readString("github"),
     ref: readString("ref"),
+    capability: readString("capability"),
     fields: readString("fields"),
     detail: readString("detail"),
     trace: readBoolean("trace"),
@@ -83,7 +89,7 @@ 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-D5FDZ2CO.js");
+  const { runExtension } = await import("./extension-KCPUWSY2.js");
   const result = await runExtension(target, normalizedOptions, globalOptions);
   printResult(result, globalOptions);
   const strictExit = Boolean(normalizedOptions.strictExit) || Boolean(normalizedOptions.failOnWarn);
@@ -113,13 +119,13 @@ 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("--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("--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("--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");
   }
-  addLifecycleScopeOptions(lifecycleCommand.command("init").alias("scaffold").argument("<target>", `Scaffold target directory path`).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(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) => {
     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) => {
@@ -135,6 +141,9 @@ 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) => {
+    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) => {
     await executeExtensionCommand(void 0, command.optsWithGlobals(), command, "reload", vocabulary);
   });
@@ -161,7 +170,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-2BNZOO6F.js");
+    const { runInit, summarizeInitResult } = await import("./init-BNLVFPRG.js");
     const result = await runInit(prefix, globalOptions, {
       preset: typeof options.preset === "string" ? options.preset : void 0,
       defaults: options.defaults === true || options.yes === true,
@@ -182,7 +191,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-7CK62S7T.js");
+    const { runConfig } = await import("./config-MMJA4LLK.js");
     const actionShorthands = /* @__PURE__ */ new Set(["get", "set", "list", "export"]);
     const scopeShorthand = scope !== void 0 && actionShorthands.has(scope);
     const resolvedScope = scopeShorthand ? "project" : scope ?? "project";
@@ -221,7 +230,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-VPCIYAVW.js");
+    const { runUpgrade } = await import("./upgrade-HYJ3SWWU.js");
     const result = await runUpgrade(target, command.opts(), globalOptions);
     printResult(result, globalOptions);
     if (!result.ok) {
@@ -235,6 +244,6 @@ function registerSetupCommands(program) {
 export {
   registerSetupCommands
 };
-//# sourceMappingURL=register-setup-DYBFLEZX.js.map
+//# sourceMappingURL=register-setup-RCRUHMSZ.js.map
 
-//# debugId=16f5945a-62b5-5ddb-bd80-2687d959f6a7
+//# debugId=269b58b5-580f-5937-a240-9bd4b8bd6414