@unbrained/pm-cli 2026.8.17 → 2026.8.19

package/docs/agent-task-token-baseline.json

@@ -6,20 +6,20 @@
   "scenarios": [
     {
       "id": "small-workspace",
-      "max_estimated_tokens": 626
+      "max_estimated_tokens": 552
     },
     {
       "id": "large-workspace",
-      "max_estimated_tokens": 1231
+      "max_estimated_tokens": 1055
     },
     {
       "id": "returning-agent",
-      "max_estimated_tokens": 597
+      "max_estimated_tokens": 371
     },
     {
       "id": "failing-command",
-      "max_estimated_tokens": 197
+      "max_estimated_tokens": 200
     }
   ],
-  "composite_max_estimated_tokens": 2651
+  "composite_max_estimated_tokens": 2178
 }

package/docs/generated/AGENT_COMMAND_SURFACE.md

@@ -1,81 +1,81 @@
 # Generated agent command surface
 
-This file is generated from `PM_COMMAND_VISIBILITY_CONTRACTS`. Do not edit it manually.
+This file is generated from `PM_COMMAND_CAPABILITY_CONTRACTS`. Do not edit it manually.
 
-| Command | Minimum visibility tier |
-| --- | --- |
-| `init` | full |
-| `config` | standard |
-| `extension` | full |
-| `package` | full |
-| `packages` | full |
-| `install` | full |
-| `upgrade` | full |
-| `create` | core |
-| `item` | full |
-| `copy` | full |
-| `focus` | standard |
-| `list` | core |
-| `list-all` | standard |
-| `list-draft` | full |
-| `list-open` | standard |
-| `list-in-progress` | standard |
-| `list-blocked` | standard |
-| `list-closed` | standard |
-| `list-canceled` | full |
-| `aggregate` | full |
-| `context` | core |
-| `ctx` | full |
-| `get` | core |
-| `graph` | standard |
-| `search` | core |
-| `duplicates` | full |
-| `eval` | full |
-| `next` | core |
-| `history` | standard |
-| `events` | standard |
-| `history-redact` | full |
-| `history-repair` | full |
-| `history-compact` | full |
-| `history-author-acknowledge` | full |
-| `merge` | full |
-| `schema` | standard |
-| `profile` | standard |
-| `activity` | full |
-| `restore` | full |
-| `update` | core |
-| `update-many` | full |
-| `close` | core |
-| `close-many` | full |
-| `delete` | full |
-| `append` | standard |
-| `comments` | standard |
-| `notes` | standard |
-| `learnings` | standard |
-| `files` | standard |
-| `docs` | standard |
-| `deps` | standard |
-| `plan` | core |
-| `test` | standard |
-| `test-all` | full |
-| `telemetry` | full |
-| `stats` | full |
-| `health` | standard |
-| `validate` | core |
-| `assurance` | full |
-| `gc` | full |
-| `workspace` | full |
-| `contracts` | standard |
-| `claim` | core |
-| `release` | core |
-| `start-task` | full |
-| `pause-task` | full |
-| `close-task` | full |
-| `meet` | full |
-| `event` | full |
-| `remind` | full |
-| `help` | core |
-| `completion-statuses` | internal |
-| `completion-tags` | internal |
-| `completion-types` | internal |
-| `test-runs-worker` | internal |
+| Command | Minimum visibility tier | Capability family |
+| --- | --- | --- |
+| `init` | full | workspace |
+| `config` | standard | workspace |
+| `extension` | full | extensions |
+| `package` | full | extensions |
+| `packages` | full | extensions |
+| `install` | full | extensions |
+| `upgrade` | full | extensions |
+| `create` | core | intake |
+| `item` | full | intake |
+| `copy` | full | intake |
+| `focus` | standard | intake |
+| `list` | core | context |
+| `list-all` | standard | context |
+| `list-draft` | full | context |
+| `list-open` | standard | context |
+| `list-in-progress` | standard | context |
+| `list-blocked` | standard | context |
+| `list-closed` | standard | context |
+| `list-canceled` | full | context |
+| `aggregate` | full | context |
+| `context` | core | context |
+| `ctx` | full | context |
+| `get` | core | context |
+| `graph` | standard | graph |
+| `search` | core | context |
+| `duplicates` | full | context |
+| `eval` | full | context |
+| `next` | core | context |
+| `history` | standard | evidence |
+| `events` | standard | evidence |
+| `history-redact` | full | evidence |
+| `history-repair` | full | evidence |
+| `history-compact` | full | evidence |
+| `history-author-acknowledge` | full | evidence |
+| `merge` | full | workspace |
+| `schema` | standard | workspace |
+| `profile` | standard | workspace |
+| `activity` | full | context |
+| `restore` | full | intake |
+| `update` | core | lifecycle |
+| `update-many` | full | lifecycle |
+| `close` | core | lifecycle |
+| `close-many` | full | lifecycle |
+| `delete` | full | lifecycle |
+| `append` | standard | evidence |
+| `comments` | standard | evidence |
+| `notes` | standard | evidence |
+| `learnings` | standard | evidence |
+| `files` | standard | evidence |
+| `docs` | standard | evidence |
+| `deps` | standard | graph |
+| `plan` | core | graph |
+| `test` | standard | quality |
+| `test-all` | full | quality |
+| `telemetry` | full | workspace |
+| `stats` | full | context |
+| `health` | standard | workspace |
+| `validate` | core | quality |
+| `assurance` | full | quality |
+| `gc` | full | workspace |
+| `workspace` | full | workspace |
+| `contracts` | standard | quality |
+| `claim` | core | lifecycle |
+| `release` | core | lifecycle |
+| `start-task` | full | lifecycle |
+| `pause-task` | full | lifecycle |
+| `close-task` | full | lifecycle |
+| `meet` | full | automation |
+| `event` | full | automation |
+| `remind` | full | automation |
+| `help` | core | context |
+| `completion-statuses` | internal | internal |
+| `completion-tags` | internal | internal |
+| `completion-types` | internal | internal |
+| `test-runs-worker` | internal | internal |

package/docs/generated/FLAG_LEXICON_BUDGETS.md

@@ -0,0 +1,76 @@
+# Generated flag lexicon budgets
+
+This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not consume canonical budget.
+
+| Command | Capability family | Canonical flags | Maximum |
+| --- | --- | ---: | ---: |
+| `init` | workspace | 30 | 30 |
+| `config` | workspace | 35 | 35 |
+| `extension` | extensions | 53 | 53 |
+| `package` | extensions | 54 | 54 |
+| `packages` | extensions | 54 | 54 |
+| `install` | extensions | 26 | 26 |
+| `upgrade` | extensions | 29 | 29 |
+| `create` | intake | 100 | 100 |
+| `copy` | intake | 24 | 24 |
+| `focus` | intake | 22 | 22 |
+| `list` | context | 86 | 86 |
+| `list-all` | context | 85 | 85 |
+| `list-draft` | context | 84 | 84 |
+| `list-open` | context | 84 | 84 |
+| `list-in-progress` | context | 84 | 84 |
+| `list-blocked` | context | 84 | 84 |
+| `list-closed` | context | 84 | 84 |
+| `list-canceled` | context | 84 | 84 |
+| `aggregate` | context | 37 | 37 |
+| `context` | context | 45 | 45 |
+| `ctx` | context | 45 | 45 |
+| `get` | context | 30 | 30 |
+| `graph` | graph | 34 | 34 |
+| `search` | context | 78 | 78 |
+| `duplicates` | context | 24 | 24 |
+| `eval` | context | 25 | 25 |
+| `next` | context | 35 | 35 |
+| `history` | evidence | 35 | 35 |
+| `events` | evidence | 33 | 33 |
+| `history-redact` | evidence | 27 | 27 |
+| `history-repair` | evidence | 26 | 26 |
+| `history-compact` | evidence | 30 | 30 |
+| `history-author-acknowledge` | evidence | 28 | 28 |
+| `merge` | workspace | 24 | 24 |
+| `schema` | workspace | 40 | 40 |
+| `profile` | workspace | 22 | 22 |
+| `activity` | context | 35 | 35 |
+| `restore` | intake | 23 | 23 |
+| `update` | lifecycle | 105 | 105 |
+| `update-many` | lifecycle | 140 | 140 |
+| `close` | lifecycle | 31 | 31 |
+| `close-many` | lifecycle | 72 | 72 |
+| `delete` | lifecycle | 24 | 24 |
+| `append` | evidence | 24 | 24 |
+| `comments` | evidence | 30 | 30 |
+| `notes` | evidence | 34 | 34 |
+| `learnings` | evidence | 26 | 26 |
+| `files` | evidence | 39 | 39 |
+| `docs` | evidence | 30 | 30 |
+| `deps` | graph | 32 | 32 |
+| `plan` | graph | 109 | 109 |
+| `test` | quality | 48 | 48 |
+| `test-all` | quality | 37 | 37 |
+| `telemetry` | workspace | 21 | 21 |
+| `stats` | context | 29 | 29 |
+| `health` | workspace | 36 | 36 |
+| `validate` | quality | 45 | 45 |
+| `assurance` | quality | 30 | 30 |
+| `gc` | workspace | 22 | 22 |
+| `workspace` | workspace | 23 | 23 |
+| `contracts` | quality | 29 | 29 |
+| `claim` | lifecycle | 36 | 36 |
+| `release` | lifecycle | 23 | 23 |
+| `start-task` | lifecycle | 23 | 23 |
+| `pause-task` | lifecycle | 23 | 23 |
+| `close-task` | lifecycle | 24 | 24 |
+| `meet` | automation | 33 | 33 |
+| `event` | automation | 33 | 33 |
+| `remind` | automation | 29 | 29 |
+| `test-runs-worker` | internal | 25 | 25 |

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -120,11 +120,14 @@
     "lint:complexity:baseline": "eslint . --suppress-rule complexity --suppress-rule sonarjs/cognitive-complexity",
     "lint:duplicates": "jscpd --config .jscpd.json",
     "lint:codefactor": "pnpm quality:static",
-    "quality:static": "pnpm build && node scripts/release/repository-assurance.mjs repository-static-quality --trigger ci --json && node scripts/release/audit-package-boundary.mjs && node scripts/release/package-sdk-contract-parity.mjs && node scripts/release/surface-replication-gate.mjs && node dist/cli.js assurance run tracker-context-quality --trigger ci --dry-run --json --output-budget unbounded && node scripts/release/gate-registry.mjs && node scripts/sdk-surface-snapshot.mjs --check && node scripts/bench/sdk-entrypoint-costs.mjs --check && node scripts/bench/cli-transport-floor.mjs --check && node dist/cli.js assurance run graph-composition --trigger ci --dry-run --json --output-budget unbounded && node dist/cli.js assurance run record-integrity --trigger ci --dry-run --json --output-budget unbounded",
+    "quality:static": "pnpm build && node scripts/contracts-snapshot.mjs --check && node scripts/generate-agent-capability-surfaces.mjs --check && node scripts/generate-error-code-catalog.mjs --check && node scripts/release/repository-assurance.mjs repository-static-quality --trigger ci --json && node scripts/release/audit-package-boundary.mjs && node scripts/release/package-sdk-contract-parity.mjs && node scripts/release/surface-replication-gate.mjs && node scripts/release/command-grammar-gate.mjs && node scripts/release/flag-invocation-parity.mjs && node scripts/release/flag-lexicon-gate.mjs && node scripts/release/refusal-closure-gate.mjs && node dist/cli.js assurance run tracker-context-quality --trigger ci --dry-run --json --output-budget unbounded && node scripts/release/gate-registry.mjs && node scripts/sdk-surface-snapshot.mjs --check && node scripts/bench/sdk-entrypoint-costs.mjs --check && node scripts/bench/cli-transport-floor.mjs --check && node dist/cli.js assurance run graph-composition --trigger ci --dry-run --json --output-budget unbounded && node dist/cli.js assurance run record-integrity --trigger ci --dry-run --json --output-budget unbounded",
+    "quality:command-grammar": "pnpm build && node scripts/release/command-grammar-gate.mjs && node scripts/release/flag-invocation-parity.mjs && node scripts/release/flag-lexicon-gate.mjs",
+    "quality:recovery-closure": "pnpm build && node scripts/release/refusal-closure-gate.mjs",
     "quality:token-budget": "node scripts/release/token-budget-gate.mjs",
     "quality:token-surface": "node scripts/measure-agent-token-surface.mjs --check",
     "quality:token-surface:update": "pnpm build && node scripts/measure-agent-token-surface.mjs --update",
     "quality:context-eval": "pnpm build && node scripts/release/repository-assurance.mjs repository-context-quality --trigger ci --json && pnpm quality:token-surface",
+    "context:intent:calibrate": "node scripts/release/context-intent-calibration-gate.mjs",
     "quality:agent-task-token": "pnpm build && node scripts/release/agent-task-token-gate.mjs",
     "quality:agent-task-token:update": "pnpm build && node scripts/release/agent-task-token-gate.mjs --update",
     "quality:retrieval-eval": "pnpm build && node scripts/release/retrieval-eval-gate.mjs",

package/packages/pm-beads/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-beads",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for importing Beads JSONL records.",

package/packages/pm-calendar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-calendar",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for calendar and agenda views.",

package/packages/pm-command-kit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-command-kit",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.",

package/packages/pm-digital-twin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-digital-twin",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.",

package/packages/pm-governance-audit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-governance-audit",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for governance audit and normalization workflows.",

package/packages/pm-guide-shell/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for guide and shell completion workflows.",

package/packages/pm-kanban/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-kanban",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.",

package/packages/pm-lifecycle-hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-lifecycle-hooks",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package demonstrating safe lifecycle hook registration.",

package/packages/pm-linked-test-adapters/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-linked-test-adapters",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for optional linked-test run management adapters and reporters.",

package/packages/pm-search-advanced/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-search-advanced",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for semantic, hybrid, and reindex search workflows.",

package/packages/pm-templates/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-templates",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for reusable create templates.",

package/packages/pm-todos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-todos",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "First-party pm package for Todo markdown import and export.",

package/packages/pm-vcs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-vcs-sdk-exemplar",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.",

package/plugins/pm-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pm-claude",
   "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

package/plugins/pm-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-codex",
-  "version": "2026.8.17",
+  "version": "2026.8.19",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/scripts/generate-agent-capability-surfaces.mjs

@@ -7,6 +7,7 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { renderPmCommandVisibilityMarkdown } from "../dist/sdk/agent-capability-contracts.js";
+import { renderPmFlagLexiconMarkdown } from "../dist/sdk/cli-contracts/flag-lexicon-contracts.js";
 
 const repositoryRoot = path.resolve(
   path.dirname(fileURLToPath(import.meta.url)),
@@ -16,24 +17,29 @@ export async function main(
   root = repositoryRoot,
   args = process.argv.slice(2),
 ) {
-  const outputPath = path.join(
-    root,
-    "docs",
-    "generated",
-    "AGENT_COMMAND_SURFACE.md",
-  );
-  const expected = renderPmCommandVisibilityMarkdown();
+  const outputs = [
+    ["AGENT_COMMAND_SURFACE.md", renderPmCommandVisibilityMarkdown()],
+    ["FLAG_LEXICON_BUDGETS.md", renderPmFlagLexiconMarkdown()],
+  ];
   if (args.includes("--check")) {
-    const actual = await readFile(outputPath, "utf8").catch(() => "");
-    if (actual !== expected) {
-      throw new Error(
-        "Generated agent command surface is stale. Run pnpm contracts:agent-surfaces:update.",
-      );
+    for (const [filename, expected] of outputs) {
+      const actual = await readFile(
+        path.join(root, "docs", "generated", filename),
+        "utf8",
+      ).catch(() => "");
+      if (actual !== expected) {
+        throw new Error(
+          `Generated agent capability surface ${filename} is stale. Run pnpm contracts:agent-surfaces:update.`,
+        );
+      }
     }
     return;
   }
-  await mkdir(path.dirname(outputPath), { recursive: true });
-  await writeFile(outputPath, expected, "utf8");
+  const outputDirectory = path.join(root, "docs", "generated");
+  await mkdir(outputDirectory, { recursive: true });
+  for (const [filename, expected] of outputs) {
+    await writeFile(path.join(outputDirectory, filename), expected, "utf8");
+  }
 }
 
 /* c8 ignore start -- CLI auto-run guard; logic is covered through main(). */