@unbrained/pm-cli 2026.8.20 → 2026.8.21

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

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 2026.8.21 - 2026-08-21
+
+### Added
+
+- Prose-asserted relationships are unmeasured: 1,750 identifier pairs named in item text carry no edge in any direction, and nothing counts the gap ([pm-ob9z4y](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-ob9z4y.toon))
+
+### Changed
+
+- Provide consistent tracker preflight and executable recovery across SDK, CLI, and MCP ([pm-6qiwan](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-6qiwan.toon))
+
+### Fixed
+
+- The blocks ceiling counts fabricated and evidence-cited ordering edges identically, so the historical ordering reconstruction another item mandates cannot land ([pm-c90tfh](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-c90tfh.toon))
+- The dependency remove flag accepts a value its own add flag refuses and reports success on a zero-match, so a mistyped graph repair exits 0 having changed nothing ([pm-gos426](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gos426.toon))
+- All four graph traversal verbs reject the semantic edge kinds the ontology exists to express, so 'what implements this milestone' returns the ordering-kind answer with no sign a semantic one exists ([pm-3dyec2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-3dyec2.toon))
+- Typed-outcome reachability admits three of ten edge kinds, so the four semantic kinds the ontology exists to express contribute nothing to the invariant they were minted to satisfy ([pm-ayg31c](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ayg31c.toon))
+- The graph audit raises duplicate dependency rows at warning severity and the only remediation available deletes every copy, so collapsing a duplicate means briefly destroying a real edge ([pm-flnefm](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-flnefm.toon))
+
+### Other
+
+- ADR: Ordering assurance partitions evidence-cited blocks from uncited blocks ([pm-jhpby4](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-jhpby4.toon))
+
 ## 2026.8.20 - 2026-08-20
 
 ### Added

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

@@ -14,6 +14,10 @@ interface GuidanceMessage {
     examples?: string[];
     nextSteps?: string[];
     verificationErrors?: string[];
+    flag?: string;
+    value?: string;
+    unmatchedSelectors?: NonNullable<PmCliErrorContext["unmatched_selectors"]>;
+    availableDependencies?: NonNullable<PmCliErrorContext["available_dependencies"]>;
     recovery?: PmCliErrorRecoveryPayload;
 }
 /** Documents the json error envelope payload exchanged by command, SDK, and package integrations. */
@@ -38,6 +42,14 @@ export interface JsonErrorEnvelope {
     next_steps?: string[];
     /** Exact integrity verifier findings that caused the operation to refuse. */
     verification_errors?: string[];
+    /** CLI flag whose supplied value violated a shared mutation grammar. */
+    flag?: string;
+    /** Supplied scalar value that violated a shared mutation grammar. */
+    value?: string;
+    /** Dependency selectors that matched no stored edge. */
+    unmatched_selectors?: NonNullable<PmCliErrorContext["unmatched_selectors"]>;
+    /** Compact stored dependency identities available when a removal failed. */
+    available_dependencies?: NonNullable<PmCliErrorContext["available_dependencies"]>;
     /** Value that configures or reports recovery for this contract. */
     recovery?: PmCliErrorRecoveryPayload;
 }
@@ -63,6 +75,14 @@ export interface ErrorClassification {
     next_steps?: string[];
     /** Exact integrity verifier findings that caused the operation to refuse. */
     verification_errors?: string[];
+    /** CLI flag whose supplied value violated a shared mutation grammar. */
+    flag?: string;
+    /** Supplied scalar value that violated a shared mutation grammar. */
+    value?: string;
+    /** Dependency selectors that matched no stored edge. */
+    unmatched_selectors?: NonNullable<PmCliErrorContext["unmatched_selectors"]>;
+    /** Compact stored dependency identities available when a removal failed. */
+    available_dependencies?: NonNullable<PmCliErrorContext["available_dependencies"]>;
     /** Value that configures or reports recovery for this contract. */
     recovery?: PmCliErrorRecoveryPayload;
 }

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]="367d9302-9e1e-5813-a913-e4e87f34d8b9")}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]="d90c153b-bb1d-57b1-81fd-e0ea7347c520")}catch(e){}}();
 import { resolveRecoveryCommandName } from "../sdk/agent/command-recovery.js";
 import { renderPmCommand } from "./argv-utils.js";
 import { discoverNearbyPmRoot } from "../sdk/tracker-root-discovery.js";
@@ -278,15 +278,8 @@ export function renderGuidanceMessage(message) {
     }
     return lines.join("\n");
 }
-function guidanceToJsonEnvelope(message, exitCode) {
-    const payload = {
-        type: message.type,
-        code: message.code,
-        title: message.title,
-        detail: message.happened,
-        required: message.required,
-        exit_code: exitCode,
-    };
+/** Attach optional actionable fields shared by JSON and classification envelopes. */
+function attachStructuredGuidanceDetails(payload, message) {
     if (includeWhyInStructuredGuidance(message)) {
         payload.why = message.why;
     }
@@ -299,35 +292,37 @@ function guidanceToJsonEnvelope(message, exitCode) {
     if (message.verificationErrors && message.verificationErrors.length > 0) {
         payload.verification_errors = message.verificationErrors;
     }
+    if (message.flag !== undefined)
+        payload.flag = message.flag;
+    if (message.value !== undefined)
+        payload.value = message.value;
+    if (message.unmatchedSelectors !== undefined)
+        payload.unmatched_selectors = message.unmatchedSelectors;
+    if (message.availableDependencies !== undefined)
+        payload.available_dependencies = message.availableDependencies;
     if (message.recovery) {
         payload.recovery = message.recovery;
     }
     return payload;
 }
+function guidanceToJsonEnvelope(message, exitCode) {
+    return attachStructuredGuidanceDetails({
+        type: message.type,
+        code: message.code,
+        title: message.title,
+        detail: message.happened,
+        required: message.required,
+        exit_code: exitCode,
+    }, message);
+}
 function guidanceToClassification(message) {
-    const payload = {
+    return attachStructuredGuidanceDetails({
         type: message.type,
         code: message.code,
         title: message.title,
         detail: message.happened,
         required: message.required,
-    };
-    if (includeWhyInStructuredGuidance(message)) {
-        payload.why = message.why;
-    }
-    if (message.examples && message.examples.length > 0) {
-        payload.examples = message.examples;
-    }
-    if (message.nextSteps && message.nextSteps.length > 0) {
-        payload.next_steps = message.nextSteps;
-    }
-    if (message.verificationErrors && message.verificationErrors.length > 0) {
-        payload.verification_errors = message.verificationErrors;
-    }
-    if (message.recovery) {
-        payload.recovery = message.recovery;
-    }
-    return payload;
+    }, message);
 }
 function normalizeMessage(message) {
     return message.replace(/\(outputHelp\)/g, "").trim();
@@ -435,11 +430,15 @@ function applyPmCliErrorContext(guidance, rawMessage, context) {
         examples,
         nextSteps,
         verificationErrors,
+        flag: context.flag,
+        value: context.value,
+        unmatchedSelectors: context.unmatched_selectors,
+        availableDependencies: context.available_dependencies,
         recovery,
     };
 }
 function buildTrackerNotInitializedGuidance(rawMessage, message, context) {
-    const trackerNotInitialized = message.match(/^Tracker is not initialized at (.+)\. Run pm init first\.$/);
+    const trackerNotInitialized = message.match(/^Tracker is not initialized at (.+)\. (?:Run pm init first|Tracker root does not exist\. Run pm init first)\.$/);
     if (!trackerNotInitialized) {
         return null;
     }
@@ -1241,4 +1240,4 @@ export const _testOnly = {
     resolveKnownPackageCommandHint,
 };
 //# sourceMappingURL=error-guidance.js.map
-//# debugId=367d9302-9e1e-5813-a913-e4e87f34d8b9
+//# debugId=d90c153b-bb1d-57b1-81fd-e0ea7347c520