@unbrained/pm-cli 2026.6.8 → 2026.6.10

package/dist/cli/main.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!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]="aead80b1-f418-5252-a0b9-6ab1ea18d330")}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]="5b1ed048-2b19-58fc-8c2b-10036fb6c237")}catch(e){}}();
 import { Command } from "commander";
 import { activateExtensions, clearActiveExtensionHooks, createEmptyExtensionRegistrationRegistry, discoverExtensions, getActiveCommandResult, getActiveExtensionRegistrations, loadExtensions, consumeAfterCommandAffectedItems, runActiveCommandHandler, runActiveParserOverride, runActivePreflightOverride, runAfterCommandHooks, runBeforeCommandHooks, setActiveCommandResult, setActiveCommandContext, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
 import { pathExists } from "../core/fs/fs-utils.js";
@@ -18,13 +18,13 @@ import { sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentryLogC
 import { ensureSentryInit } from "../core/sentry/instrument.js";
 import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 import { readSettings, readSettingsWithMetadata } from "../core/store/settings.js";
-import { coerceLooseCommandOptionsWithFlagDefinitions, parseLooseCommandOptions, validateLooseCommandOptionsWithFlagDefinitions, } from "./extension-command-options.js";
+import { coerceLooseCommandOptionsWithFlagDefinitions, collectLooseCommandOptionKeysForDefinitions, parseLooseCommandOptions, stripLooseCommandOptionTokens, validateLooseCommandOptionsWithFlagDefinitions, } from "./extension-command-options.js";
 import { attachRichHelpText } from "./help-content.js";
 import { extractProvidedOptionFlags, normalizeLongOptionFlag, renderPmCommand, } from "./argv-utils.js";
 import { classifyCommanderError, classifyPmCliError, classifyUnknownError, formatPmCliErrorForDisplay, formatPmCliErrorForJson, formatUnknownErrorForJson, } from "./error-guidance.js";
 import { applyDefaultOutputFormat, clearResolvedGlobalOptions, collect, formatHookWarnings, getCommandPath, getGlobalOptions, invalidateSearchCachesForMutation, setResolvedGlobalOptions, } from "./registration-helpers.js";
 import { createLazyModule } from "../core/shared/lazy-module.js";
-import { normalizeExtensionCommandPath, collectDynamicExtensionFlagHelpByCommand, collectExtensionCommandHelpDescriptors, applyDynamicExtensionArguments, buildDynamicExtensionCommandMetadataHelp, findCommandByPath, ensureCommandPath, } from "./extension-command-help.js";
+import { normalizeExtensionCommandPath, collectDynamicExtensionFlagHelpByCommand, collectExtensionCommandHelpDescriptors, applyDynamicExtensionFlagOptions, applyDynamicExtensionArguments, buildDynamicExtensionCommandMetadataHelp, findCommandByPath, ensureCommandPath, } from "./extension-command-help.js";
 import { parseBootstrapGlobalOptions, applyBootstrapPagerPolicy, parseBootstrapHelpRequest, parseBootstrapCommandName, normalizeBootstrapInvocation, stripGlobalBootstrapTokens, } from "./bootstrap-args.js";
 import { collectMandatoryMigrationBlockers, enforceMandatoryMigrationWriteGate, enforceItemFormatWriteGateAndPreflightMigration, resolveMigrationId, resolveNormalizedMigrationStatus, } from "./migration-gates.js";
 import { isKnownHelpCommandPath, formatCommanderUsageMessage, formatCommanderUsageJson, resolveCommanderUsageContext, } from "./commander-usage.js";
@@ -381,19 +381,24 @@ function extractCommandScopedOptions(command, commandArgs, extensionFlagDefiniti
     delete scoped.extensions;
     delete scoped.profile;
     delete scoped.pager;
-    // --no-changed-fields is a global output control (commander exposes it as `changedFields`),
-    // not a per-command mutation field; strip it so it never counts as an update input.
+    // Global output controls must not leak into per-command mutation fields.
     delete scoped.changedFields;
+    delete scoped.idOnly;
     const looseOptions = parseLooseCommandOptions(commandArgs);
-    if (extensionFlagDefinitions.length > 0) {
-        validateLooseCommandOptionsWithFlagDefinitions(looseOptions, extensionFlagDefinitions, getCommandPath(command));
-    }
     for (const [key, value] of Object.entries(looseOptions)) {
         if (scoped[key] === undefined) {
             scoped[key] = value;
         }
     }
     if (extensionFlagDefinitions.length > 0) {
+        const extensionOptionKeys = collectLooseCommandOptionKeysForDefinitions(extensionFlagDefinitions);
+        const optionsToValidate = { ...looseOptions };
+        for (const key of extensionOptionKeys) {
+            if (scoped[key] !== undefined) {
+                optionsToValidate[key] = scoped[key];
+            }
+        }
+        validateLooseCommandOptionsWithFlagDefinitions(optionsToValidate, extensionFlagDefinitions, getCommandPath(command));
         return coerceLooseCommandOptionsWithFlagDefinitions(scoped, extensionFlagDefinitions);
     }
     return scoped;
@@ -955,9 +960,9 @@ async function executeRegisteredRuntimeMigrations(migrations, pmRoot) {
     }
     return warnings;
 }
-async function runRequiredExtensionCommand(command, options, globalOptions) {
+async function runRequiredExtensionCommand(command, options, globalOptions, extensionFlagDefinitions = []) {
     const commandPath = getCommandPath(command);
-    let commandArgs = command.args.map(String);
+    let commandArgs = stripLooseCommandOptionTokens(command.args.map(String), extensionFlagDefinitions);
     let commandOptions = { ...options };
     let resolvedGlobalOptions = { ...globalOptions };
     const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
@@ -1141,6 +1146,9 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
         const flagHelp = snapshot.commandFlagHelp.get(commandPath);
         const metadataHelp = descriptor ? buildDynamicExtensionCommandMetadataHelp(descriptor) : null;
         if (existingCommand) {
+            if (descriptor?.flags && descriptor.flags.length > 0) {
+                applyDynamicExtensionFlagOptions(existingCommand, descriptor.flags);
+            }
             if (flagHelp) {
                 existingCommand.addHelpText("after", flagHelp);
             }
@@ -1158,6 +1166,9 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
         }
         if (descriptor) {
             applyDynamicExtensionArguments(dynamicCommand, descriptor);
+            if (descriptor.flags.length > 0) {
+                applyDynamicExtensionFlagOptions(dynamicCommand, descriptor.flags);
+            }
         }
         if (flagHelp) {
             dynamicCommand.addHelpText("after", flagHelp);
@@ -1175,7 +1186,7 @@ async function registerDynamicExtensionCommandPaths(rootProgram, invocationArgv)
             const startedAt = Date.now();
             const extensionFlagDefinitions = collectExtensionFlagDefinitionsForInvocation(snapshot.registrations, commandPath, command.args.map(String));
             const scopedOptions = extractCommandScopedOptions(command, command.args.map(String), extensionFlagDefinitions);
-            const result = await runRequiredExtensionCommand(command, scopedOptions, globalOptions);
+            const result = await runRequiredExtensionCommand(command, scopedOptions, globalOptions, extensionFlagDefinitions);
             await invalidateSearchCachesForMutation(globalOptions, result);
             printResult(result, {
                 ...globalOptions,
@@ -1209,6 +1220,7 @@ program
     .option("--json", "Output JSON instead of TOON")
     .option("--quiet", "Suppress stdout output")
     .option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)")
+    .option("--id-only", "Print only id and status for single-item mutation output")
     .option("--pm-path <dir>", "Explicit tracker storage path for this command (preferred over --path)")
     .option("--path <dir>", "Backward-compatible alias for --pm-path; this is the tracker storage path, not a workspace cwd")
     .option("--no-extensions", "Disable extension loading")
@@ -1525,19 +1537,7 @@ async function registerCoreCommandFamilies(rootProgram, selection) {
         registerOperationCommands(rootProgram);
     }
 }
-function isKnownTopLevelCommandOrAlias(rootProgram, commandName) {
-    const normalized = commandName.trim().toLowerCase();
-    for (const command of rootProgram.commands) {
-        if (command.name().trim().toLowerCase() === normalized) {
-            return true;
-        }
-        if (command.aliases().some((alias) => alias.trim().toLowerCase() === normalized)) {
-            return true;
-        }
-    }
-    return false;
-}
-function shouldRegisterDynamicExtensionPaths(rootProgram, invocationArgv) {
+function shouldRegisterDynamicExtensionPaths(_rootProgram, invocationArgv) {
     if (invocationRequestsVersion(invocationArgv)) {
         return false;
     }
@@ -1549,7 +1549,7 @@ function shouldRegisterDynamicExtensionPaths(rootProgram, invocationArgv) {
     if (!commandName) {
         return false;
     }
-    return !isKnownTopLevelCommandOrAlias(rootProgram, commandName);
+    return true;
 }
 function shouldRegisterRuntimeSchemaFlags(invocationArgv) {
     if (invocationRequestsVersion(invocationArgv)) {
@@ -1940,4 +1940,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=aead80b1-f418-5252-a0b9-6ab1ea18d330
+//# debugId=5b1ed048-2b19-58fc-8c2b-10036fb6c237