@unbrained/pm-cli 2026.8.9 → 2026.8.11

package/dist/cli/register-mutation.js

@@ -1,6 +1,6 @@
 
-!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]="e5b9b4c9-c2eb-5282-99da-702a8887c4e4")}catch(e){}}();
-import { resolveBodyFileContent, EXIT_CODE, splitCommaList, PmCliError, } from "../sdk/runtime-primitives.js";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6c7d647c-e489-51e3-b84b-5b62b4114033")}catch(e){}}();
+import { resolveBodyFileContent, EXIT_CODE, splitCommaList, PmCliError, createUnknownSubcommandError, } from "../sdk/runtime-primitives.js";
 import { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, PLAN_CREATE_METADATA_PARAMETER_KEYS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, } from "../sdk/cli-contracts.js";
 import { BUILTIN_ITEM_TYPE_VALUES } from "../types/index.js";
 import { MERGE_DRIVER_ARTIFACT_VALUES, runMergeDriver, runMergeInstall, runMergeReconcile, runMergeReceiptReport, } from "./commands/merge.js";
@@ -675,7 +675,7 @@ function normalizePlanAliases(options) {
     normalized.blockedBy = planOptions.blockedBy;
     return normalized;
 }
-function assertKnownPlanSubcommand(subcommand, normalized, allowed) {
+function assertKnownPlanSubcommand(normalized, allowed) {
     if (!normalized) {
         throw new PmCliError(`pm plan requires a subcommand. Allowed: ${allowed.join(", ")}`, EXIT_CODE.USAGE, {
             code: "missing_required_argument",
@@ -692,7 +692,15 @@ function assertKnownPlanSubcommand(subcommand, normalized, allowed) {
     const examples = normalized === "list" || normalized === "ls"
         ? ["pm list --type Plan", "pm list-all --type Plan"]
         : undefined;
-    throw new PmCliError(`Unknown pm plan subcommand "${subcommand}". Allowed: ${allowed.join(", ")}`, EXIT_CODE.USAGE, examples ? { code: "unknown_subcommand", examples } : undefined);
+    throw createUnknownSubcommandError({
+        command_path: "plan",
+        token: normalized,
+        allowed,
+        examples,
+        retry_command: normalized === "list" || normalized === "ls"
+            ? "pm list --type Plan"
+            : undefined,
+    });
 }
 function parsePlanReorderTo(normalizedSubcommand, reorderToken) {
     if (normalizedSubcommand !== "reorder-step" ||
@@ -709,7 +717,7 @@ async function runPlanAction(subcommand, id, stepRef, reorderToken, options, com
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
     const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
-    assertKnownPlanSubcommand(subcommand, normalizedSubcommand, PLAN_SUBCOMMANDS);
+    assertKnownPlanSubcommand(normalizedSubcommand, PLAN_SUBCOMMANDS);
     const planOptions = normalizePlanAliases(options);
     const reorderTo = parsePlanReorderTo(normalizedSubcommand, reorderToken);
     const planId = normalizedSubcommand === "create" &&
@@ -812,7 +820,12 @@ async function runMergeAction(subcommand, artifact, base, ours, theirs, options,
             await runMergeDriverSubcommand(artifact, base, ours, theirs, options, globalOptions);
             break;
         default:
-            throw new PmCliError(`Unknown merge subcommand "${subcommand}". Supported subcommands: install, reconcile, report, driver.`, EXIT_CODE.USAGE);
+            throw createUnknownSubcommandError({
+                command_path: "merge",
+                token: subcommand,
+                allowed: ["install", "reconcile", "report", "driver"],
+                display_name: "merge",
+            });
     }
     if (globalOptions.profile) {
         printError(`profile:command=merge took_ms=${Date.now() - startedAt}`);
@@ -890,7 +903,11 @@ async function runSchemaAction(subcommand, name, options, command) {
         normalizedSubcommand = "add-type";
     }
     if (!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)) {
-        throw new PmCliError(`Unknown pm schema subcommand "${subcommand}". Allowed: ${SCHEMA_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, { code: "unknown_subcommand" });
+        throw createUnknownSubcommandError({
+            command_path: "schema",
+            token: normalizedSubcommand,
+            allowed: SCHEMA_SUBCOMMANDS,
+        });
     }
     const result = await dispatchSchemaSubcommand(schemaModule, {
         normalizedSubcommand,
@@ -1070,7 +1087,11 @@ async function runProfileAction(subcommand, name, options, command) {
         });
     }
     if (!PROFILE_SUBCOMMANDS.includes(normalizedSubcommand)) {
-        throw new PmCliError(`Unknown pm profile subcommand "${subcommand}". Allowed: ${PROFILE_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, { code: "unknown_subcommand" });
+        throw createUnknownSubcommandError({
+            command_path: "profile",
+            token: normalizedSubcommand,
+            allowed: PROFILE_SUBCOMMANDS,
+        });
     }
     const result = await dispatchProfileSubcommand(profileModule, normalizedSubcommand, name, options, globalOptions);
     // Profile inspection and schema staging do not mutate item content, so search caches stay valid (mirrors pm schema).
@@ -1817,4 +1838,4 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .action(runDepsAction);
 }
 //# sourceMappingURL=register-mutation.js.map
-//# debugId=e5b9b4c9-c2eb-5282-99da-702a8887c4e4
+//# debugId=6c7d647c-e489-51e3-b84b-5b62b4114033

package/dist/cli/register-operations.js

@@ -1,6 +1,6 @@
 
-!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]="4856ec1e-7841-5ad0-95e3-6e3057ed999c")}catch(e){}}();
-import { resolveRuntimeStatusRegistry, setActiveCommandResult, EXIT_CODE, PmCliError, resolveAuthor, resolvePmRoot, readSettings, } from "../sdk/runtime-primitives.js";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8bd1cf90-5ac8-5470-903d-b9b61d62bb85")}catch(e){}}();
+import { resolveRuntimeStatusRegistry, setActiveCommandResult, EXIT_CODE, PmCliError, createUnknownSubcommandError, resolveAuthor, resolvePmRoot, readSettings, } from "../sdk/runtime-primitives.js";
 import { resolveStartTaskInProgressStatus } from "../sdk/start-task-status.js";
 import { parseStatsAnalyticsJson } from "./stats-analytics-json.js";
 import { createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshotWithRecovery, } from "../sdk/workspace-snapshot.js";
@@ -19,6 +19,7 @@ import { runStartBackgroundRun, runTestRunsWorker, } from "./commands/test-runs.
 import { runUpdate } from "./commands/update.js";
 import { runValidate } from "./commands/validate.js";
 import { buildBackgroundTestAllCommandArgs, applyActiveCommandResultService, buildBackgroundTestCommandArgs, addHiddenOption, collect, getGlobalOptions, invalidateSearchCachesForMutation, printError, printResult, readOptionString, } from "./registration-helpers.js";
+import { registerAssuranceCommand } from "./register-assurance.js";
 function resolveTelemetrySubcommand(namespaceOrSubcommand, subcommand) {
     const normalizedNamespace = namespaceOrSubcommand?.trim().toLowerCase();
     const normalizedSubcommand = subcommand?.trim().toLowerCase();
@@ -31,13 +32,13 @@ function resolveTelemetrySubcommand(namespaceOrSubcommand, subcommand) {
             : "status";
     }
     if (normalizedSubcommand !== undefined && normalizedSubcommand.length > 0) {
-        throw new PmCliError(`Unknown pm telemetry path "${namespaceOrSubcommand} ${subcommand}". Use "pm telemetry ${namespaceOrSubcommand}" or legacy alias "pm telemetry local-analytics ${normalizedSubcommand}".`, EXIT_CODE.USAGE, {
-            code: "unknown_subcommand",
+        throw createUnknownSubcommandError({
+            command_path: "telemetry",
+            token: `${namespaceOrSubcommand} ${subcommand}`,
+            allowed: ["status", "flush", "stats", "clear", "local-analytics"],
+            token_kind: "path",
             examples: [
-                "pm telemetry status",
-                "pm telemetry flush",
                 "pm telemetry stats --limit 10",
-                "pm telemetry clear",
                 "pm telemetry local-analytics status --json",
             ],
         });
@@ -372,11 +373,14 @@ async function runWorkspaceSnapshotAction(action, target, options, command) {
     const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
     const normalizedAction = action.trim().toLowerCase();
     if (!["create", "list", "inspect", "restore", "delete"].includes(normalizedAction)) {
-        throw new PmCliError(`Unknown workspace snapshot action "${action}". Use create, list, inspect, restore, or delete.`, EXIT_CODE.USAGE, {
-            code: "unknown_subcommand",
+        throw createUnknownSubcommandError({
+            command_path: "workspace snapshot",
+            token: action,
+            allowed: ["create", "list", "inspect", "restore", "delete"],
+            display_name: "workspace snapshot",
+            token_kind: "action",
             examples: [
                 "pm workspace snapshot create before-migration",
-                "pm workspace snapshot list",
                 "pm workspace snapshot restore before-migration",
             ],
         });
@@ -555,6 +559,7 @@ function addLinkedTestExecutionOptions(command) {
 }
 /** Implements register operation commands for the public runtime surface of this module. */
 export function registerOperationCommands(program) {
+    registerAssuranceCommand(program);
     const testCommand = program
         .command("test")
         .argument("<id>", "Item id")
@@ -858,4 +863,4 @@ function registerSchedulingShortcutCommands(program) {
     });
 }
 //# sourceMappingURL=register-operations.js.map
-//# debugId=4856ec1e-7841-5ad0-95e3-6e3057ed999c
+//# debugId=8bd1cf90-5ac8-5470-903d-b9b61d62bb85