@unbrained/pm-cli 2026.8.18 → 2026.8.19

package/docs/TESTING.md

@@ -2,7 +2,7 @@
 
 This page describes safe local tests, linked tests, coverage, and release-readiness checks.
 
-Tracked implementation updates: [pm-52eh](../.agents/pm/features/pm-52eh.toon), [pm-mcxr](../.agents/pm/issues/pm-mcxr.toon), [pm-u42x](../.agents/pm/issues/pm-u42x.toon), [pm-atfm](../.agents/pm/features/pm-atfm.toon), [pm-xmp5](../.agents/pm/tasks/pm-xmp5.toon), [pm-39cqqx](../.agents/pm/tasks/pm-39cqqx.toon), [pm-5cgm2z](../.agents/pm/chores/pm-5cgm2z.toon), [pm-avv3wx](../.agents/pm/issues/pm-avv3wx.toon), [pm-rizqb6](../.agents/pm/issues/pm-rizqb6.toon), [pm-95h7pg](../.agents/pm/issues/pm-95h7pg.toon), [pm-giks4s](../.agents/pm/issues/pm-giks4s.toon).
+Tracked implementation updates: [pm-52eh](../.agents/pm/features/pm-52eh.toon), [pm-mcxr](../.agents/pm/issues/pm-mcxr.toon), [pm-u42x](../.agents/pm/issues/pm-u42x.toon), [pm-atfm](../.agents/pm/features/pm-atfm.toon), [pm-xmp5](../.agents/pm/tasks/pm-xmp5.toon), [pm-39cqqx](../.agents/pm/tasks/pm-39cqqx.toon), [pm-5cgm2z](../.agents/pm/chores/pm-5cgm2z.toon), [pm-avv3wx](../.agents/pm/issues/pm-avv3wx.toon), [pm-rizqb6](../.agents/pm/issues/pm-rizqb6.toon), [pm-95h7pg](../.agents/pm/issues/pm-95h7pg.toon), [pm-giks4s](../.agents/pm/issues/pm-giks4s.toon), [pm-xa3t0o](../.agents/pm/issues/pm-xa3t0o.toon).
 
 ## Agent Quick Context
 
@@ -259,6 +259,19 @@ Do not update the baseline merely to make CI green. Change judgments and
 rationales in the corpus when product intent changes, and commit the corpus,
 baseline, scorer tests, and SDK documentation together.
 
+Context-intent classification has a separate calibration receipt and one
+manifest-backed recovery spelling:
+
+```bash
+pnpm context:intent:calibrate
+pnpm context:intent:calibrate --update
+```
+
+The gate verifies that `package.json` exposes that exact script before it reads
+or refreshes `scripts/release/context-intent-calibration.json`. A missing or
+renamed script therefore fails with the same command contributors are told to
+run, and pnpm forwards `--update` to the calibration gate.
+
 ## Hosted Gate Registry
 
 Tracked by [pm-k6t4yb](../.agents/pm/tasks/pm-k6t4yb.toon) and

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.18"
+    "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.18",
+      "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.18",
+  "version": "2026.8.19",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -120,12 +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 scripts/release/command-grammar-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",
+    "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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.18",
+  "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(). */