@unbrained/pm-cli 2026.6.22 → 2026.6.23

package/dist/cli-bundle/chunks/{register-operations-AT3BVVX2.js → register-operations-R4VOQ6EF.js}

@@ -6,18 +6,18 @@ import {
   collect,
   getGlobalOptions,
   invalidateSearchCachesForMutation
-} from "./chunk-6UPTNMVW.js";
-import "./chunk-7MPTFYT3.js";
-import "./chunk-TJABI6PR.js";
+} from "./chunk-YUDJD3XO.js";
+import "./chunk-2BFPAUAF.js";
+import "./chunk-7K2XXO4I.js";
 import {
   printError,
   printResult
-} from "./chunk-CLLVBO3I.js";
-import "./chunk-GGAXE22C.js";
-import "./chunk-Y4BZEND6.js";
-import "./chunk-P7ZU73BO.js";
-import "./chunk-KK4TQ3ZP.js";
-import "./chunk-PCH2JTEO.js";
+} from "./chunk-NK3UPBVG.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,
@@ -26,7 +26,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   setActiveCommandResult
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/cli/register-operations.js
 function resolveStartTaskInProgressStatus(statusRegistry) {
@@ -70,7 +70,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-JS6DNCCI.js");
+      const { runStartBackgroundRun } = await import("./test-runs-C6CFIVOS.js");
       const result2 = await runStartBackgroundRun({
         kind: "test",
         commandArgs: buildBackgroundTestCommandArgs(id, { ...options, add: addValues, addJson: addJsonValues, remove: removeValues }),
@@ -84,7 +84,7 @@ function registerOperationCommands(program) {
       }
       return;
     }
-    const { runTest } = await import("./test-FDQZQNZ4.js");
+    const { runTest } = await import("./test-NZF7OT2F.js");
     const result = await runTest(id, {
       add: addValues,
       addJson: addJsonValues,
@@ -127,7 +127,7 @@ function registerOperationCommands(program) {
     const startedAt = Date.now();
     const runInBackground = options.background === true;
     if (runInBackground) {
-      const { runStartBackgroundRun } = await import("./test-runs-JS6DNCCI.js");
+      const { runStartBackgroundRun } = await import("./test-runs-C6CFIVOS.js");
       const result2 = await runStartBackgroundRun({
         kind: "test-all",
         commandArgs: buildBackgroundTestAllCommandArgs(options),
@@ -140,7 +140,7 @@ function registerOperationCommands(program) {
       }
       return;
     }
-    const { runTestAll } = await import("./test-all-PIPPS4S5.js");
+    const { runTestAll } = await import("./test-all-KL7TLMJF.js");
     const result = await runTestAll({
       status: typeof options.status === "string" ? options.status : void 0,
       limit: typeof options.limit === "string" ? options.limit : void 0,
@@ -170,13 +170,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-JS6DNCCI.js");
+    const { runTestRunsWorker } = await import("./test-runs-C6CFIVOS.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-PQTL5YS2.js");
+    const { runTelemetry } = await import("./telemetry-FWEXSJLQ.js");
     const result = await runTelemetry({
       subcommand: resolveTelemetrySubcommand(namespaceOrSubcommand, subcommand),
       // Commander always parses `--limit <n>` to a string (or leaves it
@@ -191,7 +191,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-DQMKJMFT.js");
+    const { runStats } = await import("./stats-FS742AMA.js");
     const result = await runStats(globalOptions, {
       storage: options.storage === true,
       metadataCoverage: options.metadataCoverage === true,
@@ -209,7 +209,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-UDDGJLPP.js");
+    const { runHealth } = await import("./health-BOTB7YSU.js");
     const result = await runHealth(globalOptions, {
       strictDirectories: Boolean(options.strictDirectories),
       checkOnly: Boolean(options.checkOnly),
@@ -244,7 +244,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-BPM6Z3OT.js");
+    const { runValidate } = await import("./validate-W5V5ZGQX.js");
     const result = await runValidate({
       checkMetadata: Boolean(options.checkMetadata),
       metadataProfile: typeof options.metadataProfile === "string" ? options.metadataProfile : void 0,
@@ -287,7 +287,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-LXXDY456.js");
+    const { runGc } = await import("./gc-O5GUO3SU.js");
     const result = await runGc(globalOptions, {
       dryRun: options.dryRun === true,
       scope: Array.isArray(options.scope) ? options.scope : []
@@ -300,7 +300,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-MP2P3HL5.js");
+    const { runContracts } = await import("./contracts-XGVMMPC5.js");
     const result = await runContracts({
       action: typeof options.action === "string" ? options.action : void 0,
       command: typeof options.command === "string" ? options.command : void 0,
@@ -318,7 +318,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-MPXNVBZQ.js");
+    const { runClaim } = await import("./claim-4KHAA2RN.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,
@@ -333,7 +333,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-MPXNVBZQ.js");
+    const { runRelease } = await import("./claim-4KHAA2RN.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,
@@ -358,8 +358,8 @@ function registerOperationCommands(program) {
       message: typeof options.message === "string" ? options.message : void 0
     };
     const [{ runClaim }, { runUpdate }] = await Promise.all([
-      import("./claim-MPXNVBZQ.js"),
-      import("./update-IJKDRBIX.js")
+      import("./claim-4KHAA2RN.js"),
+      import("./update-2XCQNOD6.js")
     ]);
     const claimResult = await runClaim(id, force, globalOptions, mutationOptions);
     await invalidateSearchCachesForMutation(globalOptions, claimResult);
@@ -383,8 +383,8 @@ function registerOperationCommands(program) {
       message: typeof options.message === "string" ? options.message : void 0
     };
     const [{ runUpdate }, { runRelease }] = await Promise.all([
-      import("./update-IJKDRBIX.js"),
-      import("./claim-MPXNVBZQ.js")
+      import("./update-2XCQNOD6.js"),
+      import("./claim-4KHAA2RN.js")
     ]);
     const updateResult = await runUpdate(id, { ...mutationOptions, status: openStatus, force }, globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, updateResult);
@@ -404,8 +404,8 @@ function registerOperationCommands(program) {
       message: typeof options.message === "string" ? options.message : void 0
     };
     const [{ runClose }, { runRelease }] = await Promise.all([
-      import("./close-4RKSL5L6.js"),
-      import("./claim-MPXNVBZQ.js")
+      import("./close-W56IOGYG.js"),
+      import("./claim-4KHAA2RN.js")
     ]);
     const closeResult = await runClose(id, reason, {
       ...mutationOptions,
@@ -445,7 +445,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-JRIUREEU.js");
+      const { runMeet, runEvent } = await import("./scheduling-shortcuts-NJ5UVJFB.js");
       const run = name === "meet" ? runMeet : runEvent;
       const result = await run(title, {
         ...buildShortcutCommonOptions(options),
@@ -466,7 +466,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-JRIUREEU.js");
+    const { runRemind } = await import("./scheduling-shortcuts-NJ5UVJFB.js");
     const result = await runRemind(title, {
       ...buildShortcutCommonOptions(options),
       at: optionalString(options.at),
@@ -483,6 +483,6 @@ export {
   registerOperationCommands,
   resolveStartTaskInProgressStatus
 };
-//# sourceMappingURL=register-operations-AT3BVVX2.js.map
+//# sourceMappingURL=register-operations-R4VOQ6EF.js.map
 
 //# debugId=54cf1892-df44-58b6-861e-43b4f0bb2c5d

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

@@ -4,18 +4,18 @@ import {
   collect,
   getGlobalOptions,
   invalidateSearchCachesForMutation
-} from "./chunk-7PBGTIN3.js";
-import "./chunk-TRUFOER3.js";
-import "./chunk-XKNF3VRJ.js";
+} from "./chunk-HFFUQR73.js";
+import "./chunk-CKGNPJAG.js";
+import "./chunk-DT5LPYOD.js";
 import {
   printError,
   printResult
-} from "./chunk-A25LOPRG.js";
-import "./chunk-GNDHOR64.js";
-import "./chunk-AJXYOYJV.js";
-import "./chunk-CR7KFPAQ.js";
-import "./chunk-3VLPDG3J.js";
-import "./chunk-4JXWVHMN.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-RZZMSY4P.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-NZD2QGL5.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-COWPCGBE.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-NZD2QGL5.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-WQIAZVA6.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-NZD2QGL5.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-7P5EUWCS.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-CVHASAEU.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-5LHSX365.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-AQU7OCL3.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-RNOEQHSX.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-7YDFEJB3.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-SKHJDLW6.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-SKHJDLW6.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-SKHJDLW6.js"),
-      import("./update-7IYQHX4Q.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-7IYQHX4Q.js"),
-      import("./claim-SKHJDLW6.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-Z6AI736U.js"),
-      import("./claim-SKHJDLW6.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-ECL6GBMZ.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-ECL6GBMZ.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-RC4C3423.js.map
+//# sourceMappingURL=register-operations-U5JAW3WE.js.map

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

@@ -1,33 +1,33 @@
 import {
   collect,
   getGlobalOptions
-} from "./chunk-7PBGTIN3.js";
-import "./chunk-TRUFOER3.js";
-import "./chunk-XKNF3VRJ.js";
+} from "./chunk-HFFUQR73.js";
+import "./chunk-CKGNPJAG.js";
+import "./chunk-DT5LPYOD.js";
 import {
   printError,
   printResult
-} from "./chunk-A25LOPRG.js";
+} from "./chunk-O6LLO73I.js";
 import {
   SCAFFOLD_CAPABILITIES
-} from "./chunk-4YJA4LGU.js";
-import "./chunk-25XZN3JD.js";
-import "./chunk-GNDHOR64.js";
-import "./chunk-AJXYOYJV.js";
-import "./chunk-CR7KFPAQ.js";
-import "./chunk-3VLPDG3J.js";
-import "./chunk-4JXWVHMN.js";
+} 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-RZZMSY4P.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] = "f5a28d91-5b71-5afd-bd21-d28dfb13ba0f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c4792f03-c5dc-5b99-ab49-70b2b20c9c7c");
   } catch (e2) {
   }
 })();
@@ -49,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"),
@@ -93,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-NLMS47I4.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);
@@ -123,7 +124,7 @@ 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("--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") {
@@ -145,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);
   });
@@ -171,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-DWAKYRXI.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,
@@ -192,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-3445MCQQ.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";
@@ -231,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-76IKZ6EZ.js");
+    const { runUpgrade } = await import("./upgrade-UBNLBZNR.js");
     const result = await runUpgrade(target, command.opts(), globalOptions);
     printResult(result, globalOptions);
     if (!result.ok) {
@@ -245,4 +249,4 @@ function registerSetupCommands(program) {
 export {
   registerSetupCommands
 };
-//# sourceMappingURL=register-setup-HXEHMDHE.js.map
+//# sourceMappingURL=register-setup-KBXQDCXE.js.map