@unbrained/pm-cli 2026.8.9 → 2026.8.10

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.9"
+    "version": "2026.8.10"
   },
   "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.9",
+      "version": "2026.8.10",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 2026.8.10 - 2026-08-10
+
+### Added
+
+- GH-472: create error for missing required custom fields lists the field names ([pm-4bzq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-4bzq.toon))
+- Provenance records distinguish unavailable configuration from resolver failures ([pm-lu6sca](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-lu6sca.toon))
+
+### Fixed
+
+- GH-959 recurrence: snapshot restore planning races lease-expiry fixture cleanup ([pm-usq49n](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-usq49n.toon))
+- GH-960: structured diagnostic notices preserve machine-readable JSON envelopes ([pm-embm6t](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-embm6t.toon))
+- GH-956: lossless acceptance-criteria replacement and unmatched-removal failure contract ([pm-lppm6y](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-lppm6y.toon))
+- GH-954: fail-fast dependency target validation with explicit forward-reference intent ([pm-x3dq0l](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-x3dq0l.toon))
+- Preserve executable recovery semantics across terminators, nested aliases, and tracker scope ([pm-szn67i](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-szn67i.toon))
+- Measure source replication against an independently discovered denominator ([pm-b84irw](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-b84irw.toon))
+- GH-515: pm test --add reorders linked tests — --only-last can execute a non-newest command ([pm-x2vx](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-x2vx.toon))
+- GH-490: unknown-command suggester ranks substring hits over synonyms/edit distance — pm log suggests 'extension catalog' ([pm-g543](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-g543.toon))
+- GH-441: type-aware create help mislabels applicable flags as required (ignores create-mode) ([pm-qmjx](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-qmjx.toon))
+- GH-519: close recovery bundle suggests --validate-close "<value\>" for an enum flag and hides the real resolution-fields blocker ([pm-ulqu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ulqu.toon))
+- GH-950: item-addressing commands reject a consistent --id alias and misroute recovery ([pm-mkinft](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mkinft.toon))
+- GH-951: required-field policy can force fabricated relationship edges ([pm-st7wgu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-st7wgu.toon))
+- GH-953: close recovery suggested_retry is not executable and drops supplied flags ([pm-p316vn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-p316vn.toon))
+- A sandboxed fixture records provenance from the host harness environment, so the suite is green on CI and deterministically red for any agent running it locally ([pm-xgah3a](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xgah3a.toon))
+- The session-role dimension is wired to a boolean child-session flag, so every nested claude-code invocation records the role literally as "1" and fleet analytics will group real work under a meaningless label ([pm-eq9dlw](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-eq9dlw.toon))
+- GH-921/GH-922: merge-decision receipts are not durable in fresh-clone CI ([pm-1j5j21](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-1j5j21.toon))
+- GH-948: version-skewed pm invocations silently rewrite the tracked merge fence during unrelated commands ([pm-l56d0o](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-l56d0o.toon))
+- A measurement ratchet bound stops enforcing the moment its owner reaches a terminal status, so every guarded population goes unbounded exactly when its fix ships ([pm-5z9plz](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-5z9plz.toon))
+- The docs tree grows one file per shipped contract, so 39 of 51 documents are stubs and the SDK's story is split across twelve files ([pm-9hv1o7](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9hv1o7.toon))
+- The status-token normalization rule is replicated at five sites and the replication gate covers none of them ([pm-ulxdqp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ulxdqp.toon))
+- The two slowest governance commands load every item body while twenty other SDK modules use the light read path ([pm-sr3xzg](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-sr3xzg.toon))
+- GH-946: context signal-store staleness warning has no executable remediation contract ([pm-wn1jy1](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-wn1jy1.toon))
+- GH-943: health remediation points at validate while actionable unknown-author recovery remains undiscoverable ([pm-jwmszf](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-jwmszf.toon))
+- GH-942: expose the lightweight all-item metadata reader through the public SDK ([pm-yrj7qr](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-yrj7qr.toon))
+- GH-941: pm read omits notes without declaring their omission and invites duplicate writes ([pm-swfelk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-swfelk.toon))
+
+### Other
+
+- Refresh pinned GitHub Actions for PR \#958 with exact-head compatibility proof ([pm-obh6lo](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-obh6lo.toon))
+- The measurement ratchet floors only aggregate graph totals, so converting typed semantic edges to untyped ones passes every declaration ([pm-70jyvw](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-70jyvw.toon))
+
 ## 2026.8.9 - 2026-08-09
 
 ### Fixed

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]="042ecf17-9265-5496-bbee-4e7a07371618")}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]="a327ea76-ca7d-5f8f-aa2d-2f6f43052913")}catch(e){}}();
 import { pathExists, resolveItemTypeRegistry, EXIT_CODE, getSettingsPath, resolvePmRoot, readSettings, getActiveExtensionRegistrations, 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";
@@ -9,6 +9,8 @@ import { getCommandPath } from "./registration-helpers.js";
 import { EXECUTABLE_COMMAND_ALIASES, normalizeBootstrapInvocation, parseBootstrapHelpRequest, parseBootstrapGlobalOptions, parseBootstrapCommandName, } from "./bootstrap-args.js";
 import { extractProvidedOptionFlags, normalizeLongFlag, renderPmCommand, } from "./argv-utils.js";
 import { normalizeExtensionNameForMatch } from "./commands/extension/shared.js";
+import { rankCommandPaths } from "../sdk/agent/command-suggestions.js";
+import { renderMissingOptionRetry } from "../sdk/agent/command-recovery.js";
 /** Supported values accepted by the builtin type help contract. */
 export const BUILTIN_TYPE_HELP_VALUES = BUILTIN_ITEM_TYPE_VALUES.join("|");
 const OPTIONAL_PACKAGE_INSTALL_HINTS = {
@@ -388,9 +390,14 @@ function scoreRuntimeCommandCandidates(params) {
         .map(([commandPath]) => commandPath);
 }
 function resolveUnknownCommandCandidates(params) {
+    const semanticCandidates = rankCommandPaths(params.commandPaths, params.primaryToken);
     const rankedCandidates = scoreRuntimeCommandCandidates(params);
     const installedPackageCandidates = collectInstalledPackageCommandPathHints(params.primaryToken, params.extensionDescriptors).filter((commandPath) => params.commandPaths.includes(commandPath));
-    return dedupeStrings([...rankedCandidates, ...installedPackageCandidates]);
+    return dedupeStrings([
+        ...semanticCandidates,
+        ...rankedCandidates,
+        ...installedPackageCandidates,
+    ]);
 }
 function resolveUnknownCommandFallbacks(commandPaths) {
     const topLevel = [
@@ -556,15 +563,13 @@ function resolveSuggestedRetryForMissingOption(message, invocationArgv) {
     if (!requiredOptionToken?.startsWith("--")) {
         return undefined;
     }
-    const hasFlag = invocationArgv.some((token) => token === requiredOptionToken ||
-        token.startsWith(`${requiredOptionToken}=`));
-    return hasFlag
-        ? undefined
-        : renderAttemptedCommand([
-            ...invocationArgv,
-            requiredOptionToken,
-            "<value>",
-        ]);
+    const commandName = parseBootstrapCommandName(invocationArgv);
+    if (!commandName) {
+        return undefined;
+    }
+    return renderMissingOptionRetry(invocationArgv, commandName, [
+        requiredOptionToken,
+    ]);
 }
 /** Implements resolve commander usage context for the public runtime surface of this module. */
 export async function resolveCommanderUsageContext(error, rootProgram, extensionDescriptors, guidanceOverrides = {}) {
@@ -647,4 +652,4 @@ export const _testOnly = {
     suggestNearestLongFlags,
 };
 //# sourceMappingURL=commander-usage.js.map
-//# debugId=042ecf17-9265-5496-bbee-4e7a07371618
+//# debugId=a327ea76-ca7d-5f8f-aa2d-2f6f43052913

package/dist/cli/help-json-payload.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]="a33bada3-c1a1-5343-8a77-51dc76dd5a11")}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]="42b9782e-2151-54b0-98ce-8c5ae810c424")}catch(e){}}();
 import { hasSubcommandFlagContractsForCommand, PM_CORE_COMMAND_NAMES, } from "../sdk/cli-contracts.js";
 import { commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveTypeDefinition, EXIT_CODE, printError, writeStdout, } from "../sdk/runtime-primitives.js";
 import { buildDynamicExtensionHelpOptionSummaries, mergeHelpOptionSummaries, findCommandByPath, findDirectChildCommand, commandAliases, } from "./extension-command-help.js";
@@ -9,6 +9,7 @@ import { parseBootstrapGlobalOptions, parseBootstrapHelpRequest, parseBootstrapC
 import { extractProvidedOptionFlags, renderPmCommand } from "./argv-utils.js";
 import { formatCommanderErrorForJson } from "./error-guidance.js";
 import { BUILTIN_TYPE_HELP_VALUES, buildUnknownCommandGuidanceFromRuntime, } from "./commander-usage.js";
+import { resolveCreateExplicitEmptyFlag } from "../sdk/agent/create-option-policy.js";
 function resolveCommandFromPathTokens(root, pathTokens) {
     if (pathTokens.length === 0) {
         return root;
@@ -303,6 +304,39 @@ function appendTypeOptionHelpLines(lines, typeDefinition) {
         }
     }
 }
+function buildCreatePolicyRequiredSets(commandName, typeDefinition) {
+    const progressive = commandName === "create"
+        ? new Set(["title", "type"])
+        : new Set();
+    const strict = new Set(progressive);
+    if (commandName === "create") {
+        for (const option of [
+            ...typeDefinition.required_create_fields,
+            ...typeDefinition.required_create_repeatables,
+        ]) {
+            strict.add(option);
+        }
+    }
+    return { progressive, strict };
+}
+function appendStrictCreatePolicyHelpLines(lines, typeDefinition, progressiveRequired, strictRequired) {
+    const progressive = new Set(progressiveRequired);
+    const strictOnly = strictRequired.filter((option) => !progressive.has(option));
+    const toFlags = (options) => options.length > 0
+        ? options
+            .map((option) => commandOptionFlagLabel("create", option))
+            .join(", ")
+        : "none";
+    lines.push(`  required in strict mode: ${toFlags(strictOnly)}`);
+    const explicitEmptyFlags = strictOnly
+        .map(resolveCreateExplicitEmptyFlag)
+        .filter((flag) => flag !== undefined);
+    lines.push(`  explicit empty assertion: ${explicitEmptyFlags.length > 0 ? explicitEmptyFlags.join(", ") : "none"}`);
+    if (["Reminder", "Meeting", "Event"].includes(typeDefinition.name)) {
+        lines.push("  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.");
+        lines.push("  strict parity remains available via --create-mode strict.");
+    }
+}
 function buildCreateUpdatePolicyHelpText(commandName, typeRegistry, argv) {
     const selectedTypeRaw = parseBootstrapTypeValue(argv);
     if (!selectedTypeRaw) {
@@ -317,16 +351,18 @@ function buildCreateUpdatePolicyHelpText(commandName, typeRegistry, argv) {
             `  active type values: ${allowed}`,
         ].join("\n");
     }
-    const baseRequired = commandName === "create"
-        ? new Set([
-            "title",
-            "description",
-            "type",
-            ...typeDefinition.required_create_fields,
-            ...typeDefinition.required_create_repeatables,
-        ])
-        : new Set();
-    const policyState = resolveCommandOptionPolicyState(typeDefinition, commandName, baseRequired);
+    const argumentTerminatorIndex = argv.indexOf("--");
+    const optionArgv = argumentTerminatorIndex < 0 ? argv : argv.slice(0, argumentTerminatorIndex);
+    const createModeTokenIndex = optionArgv.findIndex((token) => token === "--create-mode" || token.startsWith("--create-mode="));
+    const createModeToken = createModeTokenIndex < 0
+        ? undefined
+        : optionArgv[createModeTokenIndex]?.startsWith("--create-mode=")
+            ? optionArgv[createModeTokenIndex]?.slice("--create-mode=".length)
+            : optionArgv[createModeTokenIndex + 1];
+    const strictCreateMode = commandName === "create" && createModeToken?.toLowerCase() === "strict";
+    const requiredSets = buildCreatePolicyRequiredSets(commandName, typeDefinition);
+    const progressivePolicyState = resolveCommandOptionPolicyState(typeDefinition, commandName, requiredSets.progressive);
+    const policyState = resolveCommandOptionPolicyState(typeDefinition, commandName, strictCreateMode ? requiredSets.strict : requiredSets.progressive);
     const toFlags = (options) => options.length > 0
         ? options
             .map((option) => commandOptionFlagLabel(commandName, option))
@@ -339,10 +375,9 @@ function buildCreateUpdatePolicyHelpText(commandName, typeRegistry, argv) {
         `  disabled: ${toFlags(policyState.disabled)}`,
         `  hidden: ${toFlags(policyState.hidden)}`,
     ];
-    if (commandName === "create" &&
-        ["Reminder", "Meeting", "Event"].includes(typeDefinition.name)) {
-        lines.push("  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.");
-        lines.push("  strict parity remains available via --create-mode strict.");
+    if (commandName === "create") {
+        const strictPolicyState = resolveCommandOptionPolicyState(typeDefinition, commandName, requiredSets.strict);
+        appendStrictCreatePolicyHelpLines(lines, typeDefinition, progressivePolicyState.required, strictPolicyState.required);
     }
     appendTypeOptionHelpLines(lines, typeDefinition);
     if (policyState.errors.length > 0) {
@@ -376,4 +411,4 @@ export const _testOnly = {
     resolveCommandFromPathTokens,
 };
 //# sourceMappingURL=help-json-payload.js.map
-//# debugId=a33bada3-c1a1-5343-8a77-51dc76dd5a11
+//# debugId=42b9782e-2151-54b0-98ce-8c5ae810c424

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]="52c705ab-a5c4-5b94-b806-4eaac31b6e9c")}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]="555e37d0-385a-5748-b0a5-760f48c94e90")}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";
@@ -2307,13 +2307,14 @@ export async function runPmCli(rawArgv = process.argv.slice(2)) {
     runtimeExtensionDiscoverySnapshotCache = null;
     activeRuntimeExtensionCommandDescriptors = new Map();
     resetActiveExtensionRuntimeState();
-    const bootstrapInvocation = normalizeBootstrapInvocation(rawArgv);
-    const invocationArgv = bootstrapInvocation.argv;
-    const invocationProcessArgv = [process.argv[0], process.argv[1], ...invocationArgv];
-    const isBareInvocation = invocationArgv.length === 0;
+    let invocationArgv = [...rawArgv];
     let restorePmAuthor;
     let restorePagerPolicy;
     try {
+        const bootstrapInvocation = normalizeBootstrapInvocation(rawArgv);
+        invocationArgv = bootstrapInvocation.argv;
+        const invocationProcessArgv = [process.argv[0], process.argv[1], ...invocationArgv];
+        const isBareInvocation = invocationArgv.length === 0;
         const bootstrapGlobal = parseBootstrapGlobalOptions(invocationArgv);
         if (bootstrapGlobal.authorMissingValue) {
             throw new PmCliError("--author requires a non-empty value.", EXIT_CODE.USAGE, {
@@ -2454,4 +2455,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=52c705ab-a5c4-5b94-b806-4eaac31b6e9c
+//# debugId=555e37d0-385a-5748-b0a5-760f48c94e90