@unbrained/pm-cli 2026.8.14 → 2026.8.15

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.8.14"
+    "version": "2026.8.15"
   },
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
       "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.8.14",
+      "version": "2026.8.15",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,9 +1,34 @@
 # Changelog
 
+## 2026.8.15 - 2026-08-15
+
+### Fixed
+
+- Provide an audited repair and severity-migration contract for legacy invalid provenance ([pm-76fkpp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-76fkpp.toon))
+- Detect extension-host pm-cli version skew before a workspace reports healthy ([pm-643e0k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-643e0k.toon))
+- Restore strict unknown-key parity for docs linked-artifact additions ([pm-22rzjp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-22rzjp.toon))
+- Surface replication gate scopes trigger activation to relevant diff content ([pm-mrhwow](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mrhwow.toon))
+- Make every failing health verdict self-indexing and attach gate severity to findings ([pm-larv4r](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-larv4r.toon))
+- GH-1004: history-repair remains writer-version-specific across 2026.8.7 and 2026.8.13 ([pm-igdvfq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-igdvfq.toon))
+- Assurance gates preserve zero-valued counts and report actionable source failures ([pm-xmmafu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xmmafu.toon))
+- A budget-truncated read is resumable on one surface and terminal on five, and the only recovery the envelope names is to abandon the budget that truncated it ([pm-8nev0o](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-8nev0o.toon))
+- Ranking explanation is sized by the workspace rather than by the answer: explaining two returned rows emits one entry per active item and ignores the token budget entirely ([pm-okgxwa](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-okgxwa.toon))
+- The unknown-option refusal asserts the option belongs on another command path without checking, so a spelling that exists nowhere sends the reader on an unbounded search ([pm-in23qu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-in23qu.toon))
+- The gate verdict withholds its evidence as a declaration-order prefix, so the assertion that produced a blocking verdict can be the row the default read drops ([pm-e5gl05](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-e5gl05.toon))
+- GH-1008: assurance measurements accept unknown source kinds and contracts hide the valid vocabulary ([pm-atnfh4](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-atnfh4.toon))
+- GH-1007: assurance gate declarations omit trigger and escape the typed refusal contract ([pm-88mo8m](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-88mo8m.toon))
+- A CI-wired quality gate is red on a clean checkout of main and green in hosted CI for the same commit, because its measured output carries a telemetry warning whose presence depends on whether the local flush reached the network ([pm-t7wn04](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-t7wn04.toon))
+- GH-1011: Windows Node 24 nightly cache fixture loses the authoritative linked-test collection ([pm-k47yqn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-k47yqn.toon))
+
+### Other
+
+- The agent token-surface harness from pm-a22j is wired into nothing, so output-size regressions like the 33k-token health check land undetected ([pm-dpqa3h](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-dpqa3h.toon))
+
 ## 2026.8.14 - 2026-08-14
 
 ### Fixed
 
+- Unsupported assurance triggers bypass the typed evaluation-refusal boundary and surface as high-severity Sentry faults ([pm-9yhl2v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9yhl2v.toon))
 - A single transient per-test timeout fails the whole pipeline: 1,942 tests share one uniform 30s budget, no retry is configured, and the only diagnosis path is decoding a blob artifact ([pm-rizqb6](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-rizqb6.toon))
 - The degradation ladder only sees top-level arrays, so the governance reads whose bulk is nested skip every intermediate rung and return nothing at all ([pm-kyjdne](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-kyjdne.toon))
 - A budget-truncated read reports that rows are missing without a cursor, a recovery, or any sign that it overrode the caller's explicit request for all of them ([pm-jt8aa2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-jt8aa2.toon))
@@ -12,7 +37,6 @@
 - Exact command-path summaries expose intent, flags, and format-aware output ceilings ([pm-pmrae8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-pmrae8.toon))
 - Default output ceilings bind representative read surfaces with depth-heavy negative controls ([pm-s2h0mq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-s2h0mq.toon))
 - Two of the three ci-triggered assurance gates never ran on a pull request, so the append-only history assertion that carries the immutability guarantee was evaluated only after merge ([pm-fhifkc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-fhifkc.toon))
-- Unsupported assurance triggers bypass the typed evaluation-refusal boundary and surface as high-severity Sentry faults ([pm-9yhl2v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9yhl2v.toon))
 - The ordering-cycle finding names the items in the cycle and not the contradiction that creates it, so its remediation hint cannot be executed without re-deriving the cause by hand ([pm-xvt7ps](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xvt7ps.toon))
 - The edge-count floor is denominated over a population that includes the edges the graph itself calls redundant, so repairing 73 witnessed implied ordering rows and silently relaxing the guard are the same privileged act ([pm-9gzr4r](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9gzr4r.toon))
 - The graph node floor counts materialized placeholders, so its negative control declares the fully repaired corpus a failure and the gate passes only while a dangling reference exists ([pm-mfvsng](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mfvsng.toon))
@@ -513,7 +537,6 @@
 - Evaluate Sentry 10.68.0 compatibility and retain 10.67.0 ([pm-r31390](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-r31390.toon))
 - Derive ALL MCP tool inputSchemas from \*\_FLAG_CONTRACTS — eliminate hand-declared parallel schema tables (extend the pm_copy pattern) ([pm-xwah](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-xwah.toon))
 - Generate shell completions, MCP tool registrations, and command reference docs from the contracts table (single source of truth) ([pm-mu8m](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-mu8m.toon))
-- The agent token-surface harness from pm-a22j is wired into nothing, so output-size regressions like the 33k-token health check land undetected ([pm-dpqa3h](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-dpqa3h.toon))
 - Ecosystem review and deep-graph enrichment pass 2026-07-27: all-status census, CLI simplification + token-efficiency + long-term brainstorm, dedupe-checked gap filing ([pm-89qv6b](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-89qv6b.toon))
 - Evaluate @toon-format/toon 4 compatibility and item-format migration ([pm-5cgm2z](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-5cgm2z.toon))
 - ADR amendment: extensible durable agent provenance dimensions and privacy boundaries ([pm-oskdmu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-oskdmu.toon))

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]="c8924d43-556d-5041-9fe3-7c5c944531ae")}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";
@@ -1598,6 +1598,7 @@ function attachProgramLifecycleHooks(rootProgram) {
             outputBudget: rawGlobalOptions.outputBudget,
             outputFormat: rawGlobalOptions.outputFormat,
             outputSession: rawGlobalOptions.outputSession,
+            outputCursor: rawGlobalOptions.outputCursor,
         });
         forwardReadOutputIncludeModes(actionCommand, commandPath, globalOptions, commandOptions);
         await maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions);
@@ -2511,4 +2512,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=c8924d43-556d-5041-9fe3-7c5c944531ae
+//# 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