@unbrained/pm-cli 2026.5.12 → 2026.5.18

package/dist/cli/register-operations.js

@@ -1,15 +1,18 @@
-import { pathExists } from "../core/fs/fs-utils.js";
-import { resolveItemTypeRegistry } from "../core/item/type-registry.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]="ff7fe568-0a90-519b-8099-b034273a3752")}catch(e){}}();
 import { normalizeStatusInput } from "../core/item/status.js";
-import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
+import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
+import { setActiveCommandResult } from "../core/extensions/index.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
-import { listAllFrontMatter } from "../core/store/item-store.js";
-import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
+import { resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
-import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
-import { runClaim, runClose, runCompletion, runContracts, runGc, runHealth, runRelease, runStartBackgroundRun, runStats, runTest, runTestAll, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, runTestRunsWorker, runUpdate, runValidate, } from "./commands/index.js";
-import { buildBackgroundTestAllCommandArgs, buildBackgroundTestCommandArgs, collect, getGlobalOptions, invalidateSearchCachesForMutation, printError, printResult, writeStdout, } from "./registration-helpers.js";
+import { buildBackgroundTestAllCommandArgs, buildBackgroundTestCommandArgs, collect, getGlobalOptions, invalidateSearchCachesForMutation, printError, printResult, } from "./registration-helpers.js";
+let operationCommandsModulePromise = null;
+async function loadOperationCommandsModule() {
+    operationCommandsModulePromise ??= import("./commands/index.js");
+    return operationCommandsModulePromise;
+}
 export function registerOperationCommands(program) {
     program
         .command("test")
@@ -48,6 +51,7 @@ export function registerOperationCommands(program) {
             throw new PmCliError("--background does not support --add/--remove; update linked tests first, then run in background", EXIT_CODE.USAGE);
         }
         if (runInBackground) {
+            const { runStartBackgroundRun } = await loadOperationCommandsModule();
             const result = await runStartBackgroundRun({
                 kind: "test",
                 commandArgs: buildBackgroundTestCommandArgs(id, { ...options, add: addValues, remove: removeValues }),
@@ -61,6 +65,7 @@ export function registerOperationCommands(program) {
             }
             return;
         }
+        const { runTest } = await loadOperationCommandsModule();
         const result = await runTest(id, {
             add: addValues,
             remove: removeValues,
@@ -118,6 +123,7 @@ export function registerOperationCommands(program) {
         const startedAt = Date.now();
         const runInBackground = options.background === true;
         if (runInBackground) {
+            const { runStartBackgroundRun } = await loadOperationCommandsModule();
             const result = await runStartBackgroundRun({
                 kind: "test-all",
                 commandArgs: buildBackgroundTestAllCommandArgs(options),
@@ -130,6 +136,7 @@ export function registerOperationCommands(program) {
             }
             return;
         }
+        const { runTestAll } = await loadOperationCommandsModule();
         const result = await runTestAll({
             status: typeof options.status === "string" ? options.status : undefined,
             limit: typeof options.limit === "string" ? options.limit : undefined,
@@ -157,103 +164,13 @@ export function registerOperationCommands(program) {
             printError(`profile:command=test-all took_ms=${Date.now() - startedAt}`);
         }
     });
-    const testRunsCommand = program
-        .command("test-runs")
-        .description("Manage background linked-test runs.")
-        .action(async (_options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const result = await runTestRunsList({}, globalOptions);
-        printResult(result, globalOptions);
-        if (globalOptions.profile) {
-            printError(`profile:command=test-runs took_ms=${Date.now() - startedAt}`);
-        }
-    });
-    testRunsCommand
-        .command("list")
-        .option("--status <value>", "Filter by background run status")
-        .option("--limit <value>", "Limit number of runs returned")
-        .description("List background test runs.")
-        .action(async (options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const result = await runTestRunsList({
-            status: typeof options.status === "string" ? options.status : undefined,
-            limit: typeof options.limit === "string" ? options.limit : undefined,
-        }, globalOptions);
-        printResult(result, globalOptions);
-        if (globalOptions.profile) {
-            printError(`profile:command=test-runs list took_ms=${Date.now() - startedAt}`);
-        }
-    });
-    testRunsCommand
-        .command("status")
-        .argument("<runId>", "Background run id")
-        .description("Show status, health, and resource snapshot for a background run.")
-        .action(async (runId, _options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const result = await runTestRunsStatus(runId, globalOptions);
-        printResult(result, globalOptions);
-        if (globalOptions.profile) {
-            printError(`profile:command=test-runs status took_ms=${Date.now() - startedAt}`);
-        }
-    });
-    testRunsCommand
-        .command("logs")
-        .argument("<runId>", "Background run id")
-        .option("--stream <value>", "Log stream selector: stdout|stderr|both")
-        .option("--tail <value>", "Tail number of lines per selected stream")
-        .description("Show tailed logs for a background run.")
-        .action(async (runId, options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const result = await runTestRunsLogs(runId, {
-            stream: typeof options.stream === "string" ? options.stream : undefined,
-            tail: typeof options.tail === "string" ? options.tail : undefined,
-        }, globalOptions);
-        printResult(result, globalOptions);
-        if (globalOptions.profile) {
-            printError(`profile:command=test-runs logs took_ms=${Date.now() - startedAt}`);
-        }
-    });
-    testRunsCommand
-        .command("stop")
-        .argument("<runId>", "Background run id")
-        .option("--force", "Force-stop via SIGKILL")
-        .description("Stop a running background test run.")
-        .action(async (runId, options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const result = await runTestRunsStop(runId, { force: options.force === true }, globalOptions);
-        printResult(result, globalOptions);
-        if (globalOptions.profile) {
-            printError(`profile:command=test-runs stop took_ms=${Date.now() - startedAt}`);
-        }
-    });
-    testRunsCommand
-        .command("resume")
-        .argument("<runId>", "Background run id")
-        .option("--author <value>", "Resume author (falls back to PM_AUTHOR/settings)")
-        .description("Resume a previously terminal background test run by starting a new attempt.")
-        .action(async (runId, options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const result = await runTestRunsResume(runId, {
-            author: typeof options.author === "string" ? options.author : undefined,
-            noExtensions: globalOptions.noExtensions === true,
-        }, globalOptions);
-        printResult(result, globalOptions);
-        if (globalOptions.profile) {
-            printError(`profile:command=test-runs resume took_ms=${Date.now() - startedAt}`);
-        }
-    });
     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 loadOperationCommandsModule();
         await runTestRunsWorker(runId, globalOptions);
     });
     program
@@ -262,6 +179,7 @@ export function registerOperationCommands(program) {
         .action(async (_options, command) => {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
+        const { runStats } = await loadOperationCommandsModule();
         const result = await runStats(globalOptions);
         printResult(result, globalOptions);
         if (globalOptions.profile) {
@@ -277,11 +195,16 @@ export function registerOperationCommands(program) {
         .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("--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 warnings are present (ok=false)")
         .option("--fail-on-warn", "Alias for --strict-exit")
         .action(async (options, command) => {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
+        const { runHealth } = await loadOperationCommandsModule();
         const result = await runHealth(globalOptions, {
             strictDirectories: Boolean(options.strictDirectories),
             checkOnly: Boolean(options.checkOnly),
@@ -289,10 +212,22 @@ export function registerOperationCommands(program) {
             noRefresh: Boolean(options.noRefresh),
             refreshVectors: Boolean(options.refreshVectors),
             verboseStaleItems: Boolean(options.verboseStaleItems),
+            skipVectors: Boolean(options.skipVectors),
+            skipIntegrity: Boolean(options.skipIntegrity),
+            skipDrift: Boolean(options.skipDrift),
+            full: Boolean(options.full),
         });
         printResult(result, globalOptions);
         const strictExit = Boolean(options.strictExit) || Boolean(options.failOnWarn);
         if (strictExit && !result.ok) {
+            setActiveCommandResult({
+                ...result,
+                exit_code: EXIT_CODE.GENERIC_FAILURE,
+                error_code: "health_findings",
+                error_category: "validation",
+                command_resolution: "health_findings",
+                resolution_stage: "execute",
+            });
             process.exitCode = EXIT_CODE.GENERIC_FAILURE;
         }
         if (globalOptions.profile) {
@@ -319,6 +254,7 @@ export function registerOperationCommands(program) {
         .action(async (options, command) => {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
+        const { runValidate } = await loadOperationCommandsModule();
         const result = await runValidate({
             checkMetadata: Boolean(options.checkMetadata),
             metadataProfile: typeof options.metadataProfile === "string" ? options.metadataProfile : undefined,
@@ -336,6 +272,14 @@ export function registerOperationCommands(program) {
         printResult(result, globalOptions);
         const strictExit = Boolean(options.strictExit) || Boolean(options.failOnWarn);
         if (strictExit && !result.ok) {
+            setActiveCommandResult({
+                ...result,
+                exit_code: EXIT_CODE.GENERIC_FAILURE,
+                error_code: "validation_findings",
+                error_category: "validation",
+                command_resolution: "validation_findings",
+                resolution_stage: "execute",
+            });
             process.exitCode = EXIT_CODE.GENERIC_FAILURE;
         }
         if (globalOptions.profile) {
@@ -350,6 +294,7 @@ export function registerOperationCommands(program) {
         .action(async (options, command) => {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
+        const { runGc } = await loadOperationCommandsModule();
         const result = await runGc(globalOptions, {
             dryRun: options.dryRun === true,
             scope: Array.isArray(options.scope) ? options.scope : [],
@@ -369,9 +314,11 @@ export function registerOperationCommands(program) {
         .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 loadOperationCommandsModule();
         const result = await runContracts({
             action: typeof options.action === "string" ? options.action : undefined,
             command: typeof options.command === "string" ? options.command : undefined,
@@ -379,6 +326,7 @@ export function registerOperationCommands(program) {
             flagsOnly: Boolean(options.flagsOnly),
             availabilityOnly: Boolean(options.availabilityOnly),
             runtimeOnly: Boolean(options.runtimeOnly) || Boolean(options.activeOnly),
+            full: Boolean(options.full),
         }, globalOptions);
         printResult(result, globalOptions);
         if (globalOptions.profile) {
@@ -391,13 +339,16 @@ export function registerOperationCommands(program) {
         .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 loadOperationCommandsModule();
         const result = await runClaim(id, Boolean(options.force), globalOptions, {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
+            ifAvailable: options.ifAvailable === true,
         });
         await invalidateSearchCachesForMutation(globalOptions, result);
         printResult(result, globalOptions);
@@ -416,6 +367,7 @@ export function registerOperationCommands(program) {
         .action(async (id, options, command) => {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
+        const { runRelease } = await loadOperationCommandsModule();
         const result = await runRelease(id, Boolean(options.force), globalOptions, {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
@@ -446,9 +398,10 @@ export function registerOperationCommands(program) {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
         };
-        const claimResult = await runClaim(id, force, globalOptions, mutationOptions);
+        const commands = await loadOperationCommandsModule();
+        const claimResult = await commands.runClaim(id, force, globalOptions, mutationOptions);
         await invalidateSearchCachesForMutation(globalOptions, claimResult);
-        const updateResult = await runUpdate(id, { ...mutationOptions, status: inProgressStatus, force }, globalOptions);
+        const updateResult = await commands.runUpdate(id, { ...mutationOptions, status: inProgressStatus, force }, globalOptions);
         await invalidateSearchCachesForMutation(globalOptions, updateResult);
         printResult({ id, action: "start_task", claim: claimResult, update: updateResult }, globalOptions);
         if (globalOptions.profile) {
@@ -474,9 +427,10 @@ export function registerOperationCommands(program) {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
         };
-        const updateResult = await runUpdate(id, { ...mutationOptions, status: openStatus, force }, globalOptions);
+        const commands = await loadOperationCommandsModule();
+        const updateResult = await commands.runUpdate(id, { ...mutationOptions, status: openStatus, force }, globalOptions);
         await invalidateSearchCachesForMutation(globalOptions, updateResult);
-        const releaseResult = await runRelease(id, force, globalOptions, mutationOptions);
+        const releaseResult = await commands.runRelease(id, force, globalOptions, mutationOptions);
         await invalidateSearchCachesForMutation(globalOptions, releaseResult);
         printResult({ id, action: "pause_task", update: updateResult, release: releaseResult }, globalOptions);
         if (globalOptions.profile) {
@@ -500,111 +454,20 @@ export function registerOperationCommands(program) {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
         };
-        const closeResult = await runClose(id, reason, {
+        const commands = await loadOperationCommandsModule();
+        const closeResult = await commands.runClose(id, reason, {
             ...mutationOptions,
             validateClose: typeof options.validateClose === "string" ? options.validateClose : undefined,
             force,
         }, globalOptions);
         await invalidateSearchCachesForMutation(globalOptions, closeResult);
-        const releaseResult = await runRelease(id, force, globalOptions, mutationOptions);
+        const releaseResult = await commands.runRelease(id, force, globalOptions, mutationOptions);
         await invalidateSearchCachesForMutation(globalOptions, releaseResult);
         printResult({ id, action: "close_task", close: closeResult, release: releaseResult }, globalOptions);
         if (globalOptions.profile) {
             printError(`profile:command=close-task took_ms=${Date.now() - startedAt}`);
         }
     });
-    program
-        .command("completion")
-        .argument("<shell>", "Shell type: bash, zsh, or fish")
-        .option("--eager-tags", "Embed current tracker tags directly in generated scripts (legacy eager mode)")
-        .description("Generate shell completion for pm.")
-        .action(async (shell, options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
-        let completionTypes;
-        let completionTags;
-        let completionStatuses;
-        const completionCommandFlags = {};
-        const eagerTags = Boolean(options.eagerTags);
-        if (await pathExists(getSettingsPath(pmRoot))) {
-            const settings = await readSettings(pmRoot);
-            const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-            const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
-            const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-            completionTypes = typeRegistry.types;
-            completionStatuses = statusRegistry.definitions.map((definition) => definition.id);
-            for (const [commandKey, definitions] of runtimeFieldRegistry.command_to_fields.entries()) {
-                if (commandKey !== "list" &&
-                    commandKey !== "create" &&
-                    commandKey !== "update" &&
-                    commandKey !== "search" &&
-                    commandKey !== "calendar" &&
-                    commandKey !== "context") {
-                    continue;
-                }
-                const runtimeFlags = new Set();
-                for (const definition of definitions) {
-                    runtimeFlags.add(`--${definition.cli_flag}`);
-                    for (const alias of definition.cli_aliases) {
-                        if (alias.startsWith("--") || (alias.startsWith("-") && !alias.startsWith("--"))) {
-                            runtimeFlags.add(alias);
-                        }
-                        else {
-                            runtimeFlags.add(`--${alias}`);
-                        }
-                    }
-                }
-                completionCommandFlags[commandKey] = [...runtimeFlags].sort((left, right) => left.localeCompare(right));
-            }
-            if (completionCommandFlags.update) {
-                completionCommandFlags["update-many"] = [...completionCommandFlags.update];
-            }
-            if (eagerTags) {
-                const items = await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);
-                completionTags = [...new Set(items.flatMap((item) => item.tags ?? []).map((tag) => tag.trim()).filter((tag) => tag.length > 0))]
-                    .sort((left, right) => left.localeCompare(right));
-            }
-        }
-        const result = runCompletion(shell, completionTypes, completionTags ?? [], eagerTags, {
-            statuses: completionStatuses,
-            command_flags: completionCommandFlags,
-        });
-        if (globalOptions.json) {
-            printResult(result, globalOptions);
-        }
-        else if (!globalOptions.quiet) {
-            writeStdout(`${result.script}\n`);
-        }
-        if (globalOptions.profile) {
-            printError(`profile:command=completion took_ms=0`);
-        }
-    });
-    program
-        .command("completion-tags", { hidden: true })
-        .description("Internal dynamic completion tag source.")
-        .action(async (_options, command) => {
-        const globalOptions = getGlobalOptions(command);
-        const startedAt = Date.now();
-        const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
-        let tags = [];
-        if (await pathExists(getSettingsPath(pmRoot))) {
-            const settings = await readSettings(pmRoot);
-            const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-            const items = await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);
-            tags = [...new Set(items.flatMap((item) => item.tags ?? []).map((tag) => tag.trim()).filter((tag) => tag.length > 0))].sort((left, right) => left.localeCompare(right));
-        }
-        if (globalOptions.json) {
-            printResult({ tags, count: tags.length }, globalOptions);
-        }
-        else if (!globalOptions.quiet) {
-            writeStdout(tags.join("\n"));
-            if (tags.length > 0) {
-                writeStdout("\n");
-            }
-        }
-        if (globalOptions.profile) {
-            printError(`profile:command=completion-tags took_ms=${Date.now() - startedAt}`);
-        }
-    });
 }
-//# sourceMappingURL=register-operations.js.map
+//# sourceMappingURL=register-operations.js.map
+//# debugId=ff7fe568-0a90-519b-8099-b034273a3752