@unbrained/pm-cli 2026.8.12 → 2026.8.14

package/dist/cli/error-guidance.js

@@ -1,5 +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]="0203943b-16ea-5c3a-a2d3-56a0c4d2848f")}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]="9ec35c35-f2dc-5f86-a166-cf0c80eab1bd")}catch(e){}}();
+import { resolveRecoveryCommandName } from "../sdk/agent/command-recovery.js";
 import { renderPmCommand } from "./argv-utils.js";
 import { discoverNearbyPmRoot } from "../sdk/tracker-root-discovery.js";
 /** Compact an error envelope to fields that change the caller's next action. */
@@ -341,12 +342,7 @@ function dedupeStrings(values) {
     return result;
 }
 function inferCommandNameFromRecovery(recovery) {
-    const args = recovery?.normalized_args;
-    if (!Array.isArray(args) || args.length === 0) {
-        return undefined;
-    }
-    const firstCommandArg = args.find((arg) => arg.trim().length > 0 && !arg.startsWith("-"));
-    return firstCommandArg?.trim();
+    return resolveRecoveryCommandName(recovery?.normalized_args);
 }
 function inferAllowedValuesFromMessage(message) {
     const match = message.match(/\bmust be one of:?\s+([A-Za-z0-9_.|,\- ]+)/i);
@@ -1201,4 +1197,4 @@ export const _testOnly = {
     resolveKnownPackageCommandHint,
 };
 //# sourceMappingURL=error-guidance.js.map
-//# debugId=0203943b-16ea-5c3a-a2d3-56a0c4d2848f
+//# debugId=9ec35c35-f2dc-5f86-a166-cf0c80eab1bd

package/dist/cli/main.js

@@ -3,7 +3,7 @@
  * @module cli/main
  */
 
-!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]="6eb8f2a6-6096-54af-a3dc-eb15fdbe5999")}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]="c8924d43-556d-5041-9fe3-7c5c944531ae")}catch(e){}}();
 import { Command } from "commander";
 import { activateExtensions, clearActiveExtensionHooks, createCoreCommandHookContext, resetActiveExtensionRuntimeState, createEmptyExtensionRegistrationRegistry, discoverExtensions, getActiveCommandResult, getActiveExtensionRegistrations, loadExtensions, consumeAfterCommandAffectedItems, runActiveCommandHandler, runActiveParserOverride, runActivePreflightOverride, runAfterCommandHooks, runBeforeCommandHooks, setActiveCommandResult, setActiveCommandContext, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, pathExists, resolvePmCliVersion, resolvePmPackageRootFromModule, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, EXIT_CODE, resolveTelemetryErrorCategory, PmCliError, asRecordOrNull, printError, printResult, maybeRunFirstUseTelemetryPrompt, emitTelemetryErrorEvent, startTelemetryCommand, deriveTelemetryCommandResolution, sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentryLogCliUsageError, sentrySetCommandContext, sentryStartCommandSpan, ensureSentryInit, getSettingsPath, resolvePmRoot, readSettings, readSettingsWithMetadata, runWithWorkspaceHarnessSignalDescriptors, createLazyModule, } from "../sdk/runtime-primitives.js";
 import { resolveSubcommandFlagContractsForCommand } from "../sdk/cli-contracts.js";
@@ -27,7 +27,7 @@ import { loadExtensionRecoveryFailures, loadUnknownCommandRecoveryFailures } fro
 import { maybeRenderBootstrapJsonHelp, attachCreateUpdatePolicyHelpText } from "./help-json-payload.js";
 import { attachOutputTokenAccounting } from "../sdk/output-token-accounting.js";
 import { runWithDiscoveredContextIntentContracts } from "../sdk/context-intent-runtime.js";
-import { validateReadOutputOptions } from "../sdk/read-output-contracts.js";
+import { applyReadOutputIncludeModes, validateReadOutputOptions } from "../sdk/read-output-contracts.js";
 import { loadContextIntentSnapshotForInvocation } from "./context-intent-invocation.js";
 import { isPmSuccessfulExitCode } from "../sdk/cli-contracts/command-exit-contracts.js";
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
@@ -499,6 +499,40 @@ async function handleGenericRunPmCliError(params) {
         }
     }
 }
+/**
+ * Hand canonical `--output-include` projection modes to the command that owns
+ * them, leaving only field selectors for post-execution projection.
+ *
+ * `--output-include brief` must be the exact behaviour of `--brief`, which the
+ * emitted migration hint promises; a mode can only be honoured before the
+ * command computes its rows, so it cannot be resolved by the output layer.
+ */
+function forwardReadOutputIncludeModes(actionCommand, commandPath, globalOptions, commandOptions) {
+    const requested = globalOptions.outputInclude;
+    if (requested === undefined)
+        return;
+    const modeOptions = {};
+    const { selectors, modes } = applyReadOutputIncludeModes(commandPath, requested, modeOptions);
+    if (modes.length === 0)
+        return;
+    for (const [key, value] of Object.entries(modeOptions)) {
+        commandOptions[key] = value;
+        actionCommand.setOptionValueWithSource(key, value, "cli");
+    }
+    const residual = selectors.length > 0 ? selectors.join(",") : undefined;
+    if (residual === undefined) {
+        delete globalOptions.outputInclude;
+    }
+    else {
+        globalOptions.outputInclude = residual;
+    }
+    // The resolved-global cache is cleared and re-read from Commander before the
+    // handler runs, so the consumed modes have to leave the parsed option too.
+    for (let scope = actionCommand; scope; scope = scope.parent) {
+        scope.setOptionValueWithSource("outputInclude", residual, "cli");
+    }
+    setResolvedGlobalOptions(actionCommand, globalOptions);
+}
 function extractCommandScopedOptions(command, commandArgs, extensionFlagDefinitions = []) {
     const allOptions = command.optsWithGlobals();
     const scoped = { ...allOptions };
@@ -938,6 +972,7 @@ function hasGlobalExtensionContributions(contributions) {
         entriesOrEmpty(contributions.item_fields).length,
         entriesOrEmpty(contributions.relationship_kinds).length,
         entriesOrEmpty(contributions.service_overrides).length,
+        entriesOrEmpty(contributions.assurance_providers).length,
         entriesOrEmpty(contributions.renderer_overrides).length -
             entriesOrEmpty(contributions.renderer_ownership).length,
     ];
@@ -1564,6 +1599,7 @@ function attachProgramLifecycleHooks(rootProgram) {
             outputFormat: rawGlobalOptions.outputFormat,
             outputSession: rawGlobalOptions.outputSession,
         });
+        forwardReadOutputIncludeModes(actionCommand, commandPath, globalOptions, commandOptions);
         await maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions);
         const fallbackPmRoot = resolvePmRoot(process.cwd(), bootstrapGlobalOptions.path);
         const runtimeExtensions = await maybeLoadRuntimeExtensions(actionCommand);
@@ -1601,6 +1637,7 @@ function attachProgramLifecycleHooks(rootProgram) {
         setActiveExtensionRegistrations(runtimeExtensions.registrations);
         const extensionFlagDefinitions = collectExtensionFlagDefinitionsForInvocation(runtimeExtensions.registrations, commandPath, commandArgs);
         commandOptions = extractCommandScopedOptions(actionCommand, commandArgs, extensionFlagDefinitions);
+        forwardReadOutputIncludeModes(actionCommand, commandPath, globalOptions, commandOptions);
         const parserOverride = await runActiveParserOverride({
             command: commandPath,
             args: commandArgs,
@@ -2474,4 +2511,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=6eb8f2a6-6096-54af-a3dc-eb15fdbe5999
+//# debugId=c8924d43-556d-5041-9fe3-7c5c944531ae

package/dist/cli/register-assurance.js

@@ -1,16 +1,21 @@
 
-!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]="1adbac08-0950-55be-82bf-cc4dc7b6ad18")}catch(e){}}();
-import { ASSURANCE_ACTIONS, ASSURANCE_DECLARATION_KINDS, runAssuranceAction, } from "../sdk/governance/assurance-action.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]="41d01430-1e95-5f09-9a2f-7e7f8fad8184")}catch(e){}}();
+import { runAssuranceAction } from "../sdk/governance/assurance-action.js";
 import { printResult } from "../sdk/runtime-primitives.js";
 import { getGlobalOptions, readOptionString } from "./registration-helpers.js";
 async function runAssuranceCliAction(action, kindOrGate, id, options, command) {
     const global = getGlobalOptions(command);
     const isRun = action === "run";
     const isVerdicts = action === "verdicts";
+    const isPresetAction = action === "presets" || action === "apply";
+    const isPromote = action === "promote";
     const result = await runAssuranceAction({
         action,
-        ...(isRun || isVerdicts ? {} : { kind: kindOrGate }),
-        id: isRun || isVerdicts ? (id ?? kindOrGate) : id,
+        ...(isRun || isVerdicts || isPresetAction || isPromote
+            ? {}
+            : { kind: kindOrGate }),
+        id: isRun || isVerdicts || isPromote ? (id ?? kindOrGate) : id,
+        preset: isPresetAction ? (id ?? kindOrGate) : undefined,
         definition: readOptionString(options, "definition"),
         trigger: readOptionString(options, "trigger"),
         tree: readOptionString(options, "tree"),
@@ -21,6 +26,9 @@ async function runAssuranceCliAction(action, kindOrGate, id, options, command) {
         idOnly: global.idOnly,
         author: readOptionString(options, "author"),
         message: readOptionString(options, "message"),
+        owner: readOptionString(options, "owner"),
+        apply: options.apply === true,
+        enforcement: readOptionString(options, "enforcement"),
     }, global);
     printResult(result, global);
     if (typeof result === "object" &&
@@ -34,19 +42,22 @@ async function runAssuranceCliAction(action, kindOrGate, id, options, command) {
 export function registerAssuranceCommand(program) {
     program
         .command("assurance")
-        .argument("<action>", `Action: ${ASSURANCE_ACTIONS.join(", ")}`)
-        .argument("[kind]", `Declaration kind: ${ASSURANCE_DECLARATION_KINDS.join(", ")}; for run this may be the gate id`)
-        .argument("[id]", "Declaration or gate id")
-        .description("Declare and evaluate SDK-owned project assurance contracts.")
-        .option("--definition <json>", "JSON declaration for put")
-        .option("--trigger <value>", "Gate lifecycle trigger")
-        .option("--tree <value>", "Commit, tree, or snapshot identity being judged")
-        .option("--gate <id>", "Filter verdict history by gate id")
-        .option("--limit <number>", "Maximum newest verdicts returned")
-        .option("--dry-run", "Evaluate a gate without appending a verdict")
-        .option("--author <value>", "Mutation author override")
-        .option("--message <value>", "Audited mutation rationale")
+        .argument("<action>", "Action; inspect `pm contracts --command assurance`")
+        .argument("[kind]", "Declaration kind or run gate id")
+        .argument("[id]", "Declaration/gate id")
+        .description("Manage SDK-owned assurance contracts.")
+        .option("--definition <json>", "Put declaration JSON")
+        .option("--trigger <value>", "Gate trigger")
+        .option("--tree <value>", "Revision identity")
+        .option("--gate <id>", "Verdict gate filter")
+        .option("--limit <number>", "Verdict limit")
+        .option("--dry-run", "Evaluate without recording")
+        .option("--author <value>", "Mutation author")
+        .option("--message <value>", "Mutation rationale")
+        .option("--owner <item-id>", "Preset/derivation owner")
+        .option("--apply", "Persist derived proposals")
+        .option("--enforcement <level>", "Promote to warn or block")
         .action(runAssuranceCliAction);
 }
 //# sourceMappingURL=register-assurance.js.map
-//# debugId=1adbac08-0950-55be-82bf-cc4dc7b6ad18
+//# debugId=41d01430-1e95-5f09-9a2f-7e7f8fad8184