@unbrained/pm-cli 2026.8.13 → 2026.8.15

package/dist/cli/commander-usage.js

@@ -1,5 +1,5 @@
 
-!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]="05cf369c-7529-57ab-984a-f5505cc9c0c9")}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]="48877bbb-17bf-5a78-91fa-19a2f2f4c2be")}catch(e){}}();
 import { pathExists, resolveItemTypeRegistry, EXIT_CODE, getSettingsPath, resolvePmRoot, readSettings, getActiveExtensionRegistrations, locateItem, runActiveServiceOverride, levenshteinDistanceWithinLimit, } from "../sdk/runtime-primitives.js";
 import { BUILTIN_ITEM_TYPE_VALUES } from "../types/index.js";
 import { PM_CORE_COMMAND_NAMES, resolveSubcommandFlagContractsForCommand, } from "../sdk/cli-contracts.js";
@@ -587,10 +587,20 @@ function resolveUnknownOptionSuggestions(message, commandName) {
             ...suggestNearestLongFlags(match[1], collectKnownLongFlags(commandName)),
         ])
         : undefined;
+    const otherCommands = match
+        ? findOtherCommandsForFlag(match[1], commandName)
+        : [];
+    const declaredOnPath = match !== null &&
+        collectKnownLongFlags(commandName).includes(normalizeLongFlag(match[1]));
     return {
         match,
         suggestions,
-        otherCommands: match ? findOtherCommandsForFlag(match[1], commandName) : [],
+        otherCommands,
+        scope: declaredOnPath
+            ? "declared_on_path"
+            : otherCommands.length > 0
+                ? "declared_elsewhere"
+                : "declared_nowhere",
     };
 }
 function resolveSuggestedRetryForUnknownOption(invocationArgv, unknownOptionMatch, unknownOptionSuggestions) {
@@ -681,6 +691,7 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
             ? unknownOption.otherCommands.length
             : undefined,
         unknownOptionOtherCommandsTruncated: unknownOption.otherCommands.length > 12 || undefined,
+        unknownOptionScope: unknownOption.scope,
         suggestedRetryCommand,
         verifiedCollectionItemId: workspaceUsage.verifiedCollectionItemId,
         ...splitSchemaSubcommand,
@@ -691,7 +702,7 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
 /** Implements format commander usage message for the public runtime surface of this module. */
 export async function formatCommanderUsageMessage(error, rootProgram, extensionDescriptors, guidanceOverrides = {}) {
     const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors, guidanceOverrides);
-    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps, attemptedCommand, normalizedInvocationArgs, providedOptionFlags, unknownOptionSuggestions, unknownOptionOtherCommands, unknownOptionOtherCommandsTotal, unknownOptionOtherCommandsTruncated, unknownSubcommandPath, unknownSubcommandToken, unknownSubcommandAllowedValues, suggestedRetryCommand, verifiedCollectionItemId, failedExtensions, } = usageContext;
+    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps, attemptedCommand, normalizedInvocationArgs, providedOptionFlags, unknownOptionSuggestions, unknownOptionOtherCommands, unknownOptionOtherCommandsTotal, unknownOptionOtherCommandsTruncated, unknownOptionScope, unknownSubcommandPath, unknownSubcommandToken, unknownSubcommandAllowedValues, suggestedRetryCommand, verifiedCollectionItemId, failedExtensions, } = usageContext;
     const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {
         unknownCommandExamples,
         unknownCommandNextSteps,
@@ -702,6 +713,7 @@ export async function formatCommanderUsageMessage(error, rootProgram, extensionD
         unknownOptionOtherCommands,
         unknownOptionOtherCommandsTotal,
         unknownOptionOtherCommandsTruncated,
+        unknownOptionScope,
         unknownSubcommandPath,
         unknownSubcommandToken,
         unknownSubcommandAllowedValues,
@@ -732,6 +744,7 @@ export async function formatCommanderUsageJson(error, rootProgram, extensionDesc
         unknownOptionOtherCommands: usageContext.unknownOptionOtherCommands,
         unknownOptionOtherCommandsTotal: usageContext.unknownOptionOtherCommandsTotal,
         unknownOptionOtherCommandsTruncated: usageContext.unknownOptionOtherCommandsTruncated,
+        unknownOptionScope: usageContext.unknownOptionScope,
         unknownSubcommandPath: usageContext.unknownSubcommandPath,
         unknownSubcommandToken: usageContext.unknownSubcommandToken,
         unknownSubcommandAllowedValues: usageContext.unknownSubcommandAllowedValues,
@@ -750,4 +763,4 @@ export const _testOnly = {
     suggestNearestLongFlags,
 };
 //# sourceMappingURL=commander-usage.js.map
-//# debugId=05cf369c-7529-57ab-984a-f5505cc9c0c9
+//# debugId=48877bbb-17bf-5a78-91fa-19a2f2f4c2be

package/dist/cli/error-guidance.d.ts

@@ -81,6 +81,8 @@ export interface CommanderGuidanceContext {
     unknownOptionOtherCommandsTotal?: number;
     /** Whether the structured command candidates reached their own ceiling. */
     unknownOptionOtherCommandsTruncated?: boolean;
+    /** Declared lexicon membership of the rejected option spelling. */
+    unknownOptionScope?: PmCliErrorRecoveryPayload["option_scope"];
     /** Command family whose positional subcommand was split into invalid tokens. */
     unknownSubcommandPath?: string;
     /** Rejected positional subcommand token or token sequence. */

package/dist/cli/error-guidance.js

@@ -1,5 +1,5 @@
 
-!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){}}();
+!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]="6f4c3f5d-9acc-5e2c-9351-12fdcfcdb56a")}catch(e){}}();
 import { resolveRecoveryCommandName } from "../sdk/agent/command-recovery.js";
 import { renderPmCommand } from "./argv-utils.js";
 import { discoverNearbyPmRoot } from "../sdk/tracker-root-discovery.js";
@@ -171,6 +171,11 @@ function normalizeRecoveryPayload(payload) {
     if (payload.candidate_commands_truncated === true) {
         normalized.candidate_commands_truncated = true;
     }
+    if (payload.option_scope === "declared_on_path" ||
+        payload.option_scope === "declared_elsewhere" ||
+        payload.option_scope === "declared_nowhere") {
+        normalized.option_scope = payload.option_scope;
+    }
     assignRecoveryString(normalized, "suggested_retry", payload.suggested_retry);
     if (typeof payload.retry_after_ms === "number" &&
         Number.isSafeInteger(payload.retry_after_ms) &&
@@ -221,6 +226,9 @@ function renderRecoveryBundle(recovery) {
     if (normalized.candidate_commands_truncated === true) {
         lines.push("  candidate_commands_truncated: true");
     }
+    if (normalized.option_scope !== undefined) {
+        lines.push(`  option_scope: ${normalized.option_scope}`);
+    }
     appendRecoveryTextLine(lines, "suggested_retry", normalized.suggested_retry);
     if (typeof normalized.retry_after_ms === "number") {
         lines.push(`  retry_after_ms: ${normalized.retry_after_ms}`);
@@ -826,6 +834,42 @@ function buildUnsupportedUpdateOptionGuidance(optionName, context, suggestions)
         }),
     });
 }
+const UNKNOWN_OPTION_REQUIRED_BY_SCOPE = {
+    declared_elsewhere: "Use an option declared on this path, or move the declared option to one of its accepting command paths.",
+    declared_on_path: "Use the option with the value and syntax declared by this command path.",
+    declared_nowhere: "Use a declared option on this command path; this spelling exists nowhere in the command lexicon.",
+};
+function resolveUnknownOptionCandidateContext(context) {
+    const otherCommands = normalizeContextList(context.unknownOptionOtherCommands) ?? [];
+    return {
+        otherCommands,
+        optionScope: context.unknownOptionScope ??
+            (otherCommands.length > 0 ? "declared_elsewhere" : "declared_nowhere"),
+        candidateTotal: context.unknownOptionOtherCommandsTotal ?? otherCommands.length,
+    };
+}
+function buildUnknownOptionNextSteps(optionName, commandName, suggestions, candidateContext, retryCommand) {
+    const proseCommands = candidateContext.otherCommands.slice(0, 3);
+    const proseRemainder = candidateContext.candidateTotal - proseCommands.length;
+    const proseRemainderText = proseRemainder > 0
+        ? ` and ${String(proseRemainder)} more command path(s)`
+        : "";
+    return [
+        "Run command help to confirm the exact option contracts for this command path.",
+        suggestions.length
+            ? `Nearest supported options: ${suggestions.join(", ")}`
+            : undefined,
+        proseCommands.length
+            ? `${optionName} is accepted by ${proseCommands.join(", ")}${proseRemainderText}. Inspect those command contracts only if you intended a different operation.`
+            : undefined,
+        candidateContext.optionScope === "declared_nowhere"
+            ? `${optionName} is not declared on any command path. Use a nearest supported option on ${commandName ?? "the attempted command"}, or inspect that command's help.`
+            : undefined,
+        retryCommand
+            ? `Replay with suggested correction: ${retryCommand}`
+            : undefined,
+    ].filter((entry) => typeof entry === "string");
+}
 function buildUnknownOptionGuidance(message, commandName, context) {
     const unknownOption = message.match(/unknown option '([^']+)'/);
     if (!unknownOption) {
@@ -839,26 +883,8 @@ function buildUnknownOptionGuidance(message, commandName, context) {
         (optionName === "--file" || optionName === "--doc")) {
         return buildUnsupportedUpdateOptionGuidance(optionName, context, suggestions);
     }
-    const otherCommands = normalizeContextList(guidanceContext.unknownOptionOtherCommands) ?? [];
-    const candidateTotal = guidanceContext.unknownOptionOtherCommandsTotal ?? otherCommands.length;
-    const proseCommands = otherCommands.slice(0, 3);
-    const proseRemainder = candidateTotal - proseCommands.length;
-    let proseRemainderText = "";
-    if (proseRemainder > 0) {
-        proseRemainderText = ` and ${String(proseRemainder)} more command path(s)`;
-    }
-    const nextSteps = [
-        "Run command help to confirm the exact option contracts for this command path.",
-        suggestions.length
-            ? `Nearest supported options: ${suggestions.join(", ")}`
-            : undefined,
-        proseCommands.length
-            ? `${optionName} is accepted by ${proseCommands.join(", ")}${proseRemainderText}. Inspect those command contracts only if you intended a different operation.`
-            : undefined,
-        retryCommand
-            ? `Replay with suggested correction: ${retryCommand}`
-            : undefined,
-    ].filter((entry) => typeof entry === "string");
+    const candidateContext = resolveUnknownOptionCandidateContext(guidanceContext);
+    const nextSteps = buildUnknownOptionNextSteps(optionName, commandName, suggestions, candidateContext, retryCommand);
     const examples = [
         retryCommand,
         `pm ${commandName ?? "<command>"} --help`,
@@ -867,15 +893,16 @@ function buildUnknownOptionGuidance(message, commandName, context) {
         code: "unknown_option",
         title: `Unknown option ${optionName}`,
         happened: `Commander does not recognize option ${optionName} for this command path.`,
-        required: "Use supported options only, or move option to the correct subcommand.",
+        required: UNKNOWN_OPTION_REQUIRED_BY_SCOPE[candidateContext.optionScope],
         why: "Option contracts are command-specific and intentionally validated.",
         examples,
         nextSteps,
         recovery: buildCommanderRecoveryPayload(context, {
             suggested_flags: suggestions.length > 0 ? suggestions : undefined,
-            candidate_commands: otherCommands,
-            candidate_commands_total: candidateTotal || undefined,
+            candidate_commands: candidateContext.otherCommands,
+            candidate_commands_total: candidateContext.candidateTotal || undefined,
             candidate_commands_truncated: guidanceContext.unknownOptionOtherCommandsTruncated,
+            option_scope: candidateContext.optionScope,
         }),
     });
 }
@@ -1197,4 +1224,4 @@ export const _testOnly = {
     resolveKnownPackageCommandHint,
 };
 //# sourceMappingURL=error-guidance.js.map
-//# debugId=9ec35c35-f2dc-5f86-a166-cf0c80eab1bd
+//# debugId=6f4c3f5d-9acc-5e2c-9351-12fdcfcdb56a

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]="8aed7a8b-4c51-5aba-b27e-80f87f8f3d35")}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]="cf9d1c78-06f0-5330-8562-ac863c95ee86")}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 };
@@ -1564,7 +1598,9 @@ function attachProgramLifecycleHooks(rootProgram) {
             outputBudget: rawGlobalOptions.outputBudget,
             outputFormat: rawGlobalOptions.outputFormat,
             outputSession: rawGlobalOptions.outputSession,
+            outputCursor: rawGlobalOptions.outputCursor,
         });
+        forwardReadOutputIncludeModes(actionCommand, commandPath, globalOptions, commandOptions);
         await maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions);
         const fallbackPmRoot = resolvePmRoot(process.cwd(), bootstrapGlobalOptions.path);
         const runtimeExtensions = await maybeLoadRuntimeExtensions(actionCommand);
@@ -1602,6 +1638,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,
@@ -2475,4 +2512,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=8aed7a8b-4c51-5aba-b27e-80f87f8f3d35
+//# debugId=cf9d1c78-06f0-5330-8562-ac863c95ee86

package/dist/cli/register-mutation.js

@@ -1,5 +1,5 @@
 
-!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){}}();
+!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]="60ee1ab9-00a0-50a7-839e-4938ecc6a48f")}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";
@@ -1670,6 +1670,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .argument("[id]", "Item id (omit with --all)")
         .option("--all", "Scan every stream for drift and repair each drifted stream in one audited pass")
         .option("--dry-run", "Preview the re-anchor impact without writing the history file")
+        .option("--normalize-provenance", "Remove invalid provenance; return aggregate-only evidence")
         .option("--author <value>", "Mutation author")
         .option("--message <value>", "Audit history message for the repair marker entry")
         .option("--force", "Force ownership/lock override")
@@ -1684,6 +1685,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
             force: Boolean(options.force),
+            normalizeProvenance: options.normalizeProvenance === true,
         };
         // history-repair only re-anchors the audit stream; item content is untouched,
         // so search caches do not need invalidation.
@@ -1838,4 +1840,4 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .action(runDepsAction);
 }
 //# sourceMappingURL=register-mutation.js.map
-//# debugId=6c7d647c-e489-51e3-b84b-5b62b4114033
+//# debugId=60ee1ab9-00a0-50a7-839e-4938ecc6a48f

package/dist/cli/register-operations.js

@@ -1,5 +1,5 @@
 
-!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]="7796ea07-0de7-5db8-a3b5-a8021ceebc69")}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]="dec5fb7d-416f-5da6-bd97-c05c25dbf769")}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";
@@ -284,6 +284,7 @@ async function runDuplicatesAction(options, command) {
 async function runHealthAction(options, command) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
+    const strictExit = Boolean(options.strictExit) || Boolean(options.failOnWarn);
     const result = await runHealth(globalOptions, {
         strictDirectories: Boolean(options.strictDirectories),
         requireMergeDrivers: Boolean(options.requireMergeDrivers),
@@ -294,14 +295,13 @@ async function runHealthAction(options, command) {
         verboseStaleItems: Boolean(options.verboseStaleItems),
         verboseAuthorEvents: Boolean(options.verboseAuthorEvents),
         brief: Boolean(options.brief),
-        summary: Boolean(options.summary),
+        summary: Boolean(options.summary) || strictExit,
         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,
@@ -649,7 +649,7 @@ export function registerOperationCommands(program) {
         .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("--strict-exit", "Return non-zero exit when health is not ok and default to actionable summary output; use --full for complete details")
         .option("--fail-on-warn", "Alias for --strict-exit")
         .action(runHealthAction);
     program
@@ -873,4 +873,4 @@ function registerSchedulingShortcutCommands(program) {
     });
 }
 //# sourceMappingURL=register-operations.js.map
-//# debugId=7796ea07-0de7-5db8-a3b5-a8021ceebc69
+//# debugId=dec5fb7d-416f-5da6-bd97-c05c25dbf769