@unbrained/pm-cli 2026.8.27 → 2026.8.28

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

@@ -1,25 +1,111 @@
 {
-  "version": 1,
+  "version": 3,
+  "transcript_version": 2,
+  "transcript_digest": "sha256:2bf91406426d2a9e5de1da10ba67f7b8e9d4a4baa09eb488fe89ae3925c78f3f",
   "estimator": "ceil(utf8_bytes / 4)",
   "measurement_scope": "output_before_token_accounting",
   "published_with_release": true,
-  "scenarios": [
+  "tasks": [
     {
-      "id": "small-workspace",
-      "max_estimated_tokens": 552
+      "id": "context-bootstrap",
+      "max_estimated_tokens": 1978,
+      "steps": [
+        {
+          "id": "triage",
+          "max_estimated_tokens": 552,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "orient",
+          "max_estimated_tokens": 1055,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "inspect",
+          "max_estimated_tokens": 371,
+          "accounting_mode": "self_reported"
+        }
+      ]
     },
     {
-      "id": "large-workspace",
-      "max_estimated_tokens": 1055
+      "id": "closed-domain-recovery",
+      "max_estimated_tokens": 630,
+      "steps": [
+        {
+          "id": "refuse-intent",
+          "max_estimated_tokens": 259,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "retry-intent",
+          "max_estimated_tokens": 371,
+          "accounting_mode": "self_reported"
+        }
+      ]
     },
     {
-      "id": "returning-agent",
-      "max_estimated_tokens": 371
+      "id": "unknown-option-recovery",
+      "max_estimated_tokens": 585,
+      "steps": [
+        {
+          "id": "refuse-option",
+          "max_estimated_tokens": 422,
+          "accounting_mode": "independent_transport"
+        },
+        {
+          "id": "retry-option",
+          "max_estimated_tokens": 163,
+          "accounting_mode": "self_reported"
+        }
+      ]
     },
     {
-      "id": "failing-command",
-      "max_estimated_tokens": 219
+      "id": "lifecycle-mutation",
+      "max_estimated_tokens": 812,
+      "steps": [
+        {
+          "id": "create",
+          "max_estimated_tokens": 20,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "inspect-open",
+          "max_estimated_tokens": 363,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "close",
+          "max_estimated_tokens": 31,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "inspect-closed",
+          "max_estimated_tokens": 398,
+          "accounting_mode": "self_reported"
+        }
+      ]
+    },
+    {
+      "id": "bulk-effect-outcomes",
+      "max_estimated_tokens": 326,
+      "steps": [
+        {
+          "id": "create-bulk-target",
+          "max_estimated_tokens": 20,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "partial-effect",
+          "max_estimated_tokens": 174,
+          "accounting_mode": "self_reported"
+        },
+        {
+          "id": "no-effect",
+          "max_estimated_tokens": 132,
+          "accounting_mode": "self_reported"
+        }
+      ]
     }
   ],
-  "composite_max_estimated_tokens": 2197
+  "composite_max_estimated_tokens": 4331
 }

package/docs/agent-task-transcripts.json

@@ -0,0 +1,211 @@
+{
+  "version": 2,
+  "tasks": [
+    {
+      "id": "context-bootstrap",
+      "description": "Orient in a scaled workspace and inspect the canonical focus item.",
+      "steps": [
+        {
+          "id": "triage",
+          "args": ["list", "--for", "triage", "--limit", "2"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "collection",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["items"]
+        },
+        {
+          "id": "orient",
+          "args": ["context", "--for", "orient", "--limit", "5"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "diagnostic",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["summary.active_items", "hierarchy", "activity"]
+        },
+        {
+          "id": "inspect",
+          "args": ["get", "$ANCHOR_ID", "--for", "inspect"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "entity",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["item.id"]
+        }
+      ]
+    },
+    {
+      "id": "closed-domain-recovery",
+      "description": "Reject an invalid context intent and execute the advertised shell-free retry.",
+      "steps": [
+        {
+          "id": "refuse-intent",
+          "args": ["get", "$ANCHOR_ID", "--for", "invalid-agent-intent"],
+          "expected_exit_code": 2,
+          "expected_output_kind": "refusal",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["code", "refusal", "recovery"],
+          "expected_error_code": "unknown_context_intent",
+          "expected_refusal_surface": "--for"
+        },
+        {
+          "id": "retry-intent",
+          "args": ["get", "$ANCHOR_ID", "--for", "inspect"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "entity",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["item.id"],
+          "recovery_for": "refuse-intent"
+        }
+      ]
+    },
+    {
+      "id": "unknown-option-recovery",
+      "description": "Identify an unsupported option after valid flags and continue with the corrected command.",
+      "steps": [
+        {
+          "id": "refuse-option",
+          "args": [
+            "search",
+            "agent task",
+            "--status",
+            "open",
+            "--limit",
+            "5",
+            "--include-body"
+          ],
+          "expected_exit_code": 2,
+          "expected_output_kind": "refusal",
+          "expected_accounting_mode": "independent_transport",
+          "required_fields": ["code", "refusal", "recovery"],
+          "expected_error_code": "unknown_option",
+          "expected_refusal_surface": "--include-body"
+        },
+        {
+          "id": "retry-option",
+          "args": ["search", "agent task", "--status", "open", "--limit", "5"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "collection",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["items"],
+          "recovery_for": "refuse-option"
+        }
+      ]
+    },
+    {
+      "id": "lifecycle-mutation",
+      "description": "Create, inspect, close, and confirm a project item through public CLI receipts.",
+      "steps": [
+        {
+          "id": "create",
+          "args": [
+            "create",
+            "--id",
+            "$LIFECYCLE_ID",
+            "--title",
+            "Transcript lifecycle item",
+            "--description",
+            "Golden multi-step lifecycle task",
+            "--type",
+            "Task",
+            "--status",
+            "open",
+            "--create-mode",
+            "progressive"
+          ],
+          "expected_exit_code": 0,
+          "expected_output_kind": "mutation_receipt",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["id", "changed_field_count"]
+        },
+        {
+          "id": "inspect-open",
+          "args": ["get", "$LIFECYCLE_ID", "--for", "inspect"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "entity",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["item.id", "item.status"],
+          "expected_field_values": { "item.status": "open" }
+        },
+        {
+          "id": "close",
+          "args": ["close", "$LIFECYCLE_ID", "Golden task completed"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "mutation_receipt",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["id", "status", "close_reason"]
+        },
+        {
+          "id": "inspect-closed",
+          "args": ["get", "$LIFECYCLE_ID", "--for", "inspect"],
+          "expected_exit_code": 0,
+          "expected_output_kind": "entity",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["item.id", "item.status"],
+          "expected_field_values": { "item.status": "closed" }
+        }
+      ]
+    },
+    {
+      "id": "bulk-effect-outcomes",
+      "description": "Preserve successful partial-effect and no-effect outcomes across a bulk lifecycle task.",
+      "steps": [
+        {
+          "id": "create-bulk-target",
+          "args": [
+            "create",
+            "--id",
+            "$BULK_ID",
+            "--title",
+            "Transcript bulk effect target",
+            "--description",
+            "Golden bulk outcome transcript target",
+            "--type",
+            "Task",
+            "--status",
+            "open",
+            "--create-mode",
+            "progressive"
+          ],
+          "expected_exit_code": 0,
+          "expected_output_kind": "mutation_receipt",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["id", "status", "changed_field_count"]
+        },
+        {
+          "id": "partial-effect",
+          "args": [
+            "close-many",
+            "--ids",
+            "$BULK_ID,pm-transcript-missing",
+            "--reason",
+            "Golden partial-effect transcript",
+            "--validate-close",
+            "off",
+            "--no-checkpoint"
+          ],
+          "expected_exit_code": 7,
+          "expected_output_kind": "collection",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["rows", "outcome", "exit_code"],
+          "expected_field_values": { "outcome": "partial_effect" }
+        },
+        {
+          "id": "no-effect",
+          "args": [
+            "close-many",
+            "--ids",
+            "$BULK_ID",
+            "--reason",
+            "Golden no-effect transcript",
+            "--validate-close",
+            "off",
+            "--no-checkpoint"
+          ],
+          "expected_exit_code": 6,
+          "expected_output_kind": "collection",
+          "expected_accounting_mode": "self_reported",
+          "required_fields": ["rows", "outcome", "exit_code"],
+          "expected_field_values": { "outcome": "no_effect" }
+        }
+      ]
+    }
+  ]
+}

package/docs/generated/FLAG_LEXICON_BUDGETS.md

@@ -48,9 +48,9 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | `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 |
+| `comments` | evidence | 31 | 31 |
+| `notes` | evidence | 35 | 35 |
+| `learnings` | evidence | 27 | 27 |
 | `files` | evidence | 39 | 39 |
 | `docs` | evidence | 30 | 30 |
 | `deps` | graph | 32 | 32 |

package/docs/generated/REFUSAL_CLOSURE_CENSUS.md

@@ -4,12 +4,12 @@ Tracker: `pm-f05lsg`.
 
 Every catalog code is listed. An `uncovered` row is an explicit closure obligation, never an omission or implied approval.
 
-- Catalog error codes: 344
+- Catalog error codes: 347
 - Executable error codes: 19
 - Executable-code ratchet floor: 18
 - Required executable canonical codes: `bulk_ids_input_empty`, `bulk_ids_input_missing_path`, `bulk_ids_input_unreadable`, `invalid_argument_value`, `manifest_unknown_key`, `missing_lifecycle_target`, `missing_required_argument`, `no_version_bounds_declared`, `projection_options_mutually_exclusive`, `tracker_not_initialized`, `tracker_root_missing`, `tracker_root_not_directory`, `tracker_root_unreadable`, `unknown_context_intent`, `unknown_field_projection`, `unknown_option`, `unknown_subcommand`
-- Uncovered error codes: 325
-- Coverage fraction: 0.055233
+- Uncovered error codes: 328
+- Coverage fraction: 0.054755
 - Closed-domain probes: 19
 - Grammar probes: 94
 
@@ -25,6 +25,7 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `ambiguous_option_combination` | `ambiguous_option_combination` | uncovered | none | 0 |
 | `annotation_alias_conflict` | `annotation_alias_conflict` | uncovered | none | 0 |
 | `annotation_flag_like_value` | `annotation_flag_like_value` | uncovered | none | 0 |
+| `annotation_if_absent_without_append` | `annotation_if_absent_without_append` | uncovered | none | 0 |
 | `annotation_message_without_text` | `annotation_message_without_text` | uncovered | none | 0 |
 | `annotation_transposed_subcommand` | `annotation_transposed_subcommand` | uncovered | none | 0 |
 | `append_empty_body` | `append_empty_body` | uncovered | none | 0 |
@@ -213,6 +214,8 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `no_update_fields` | `no_update_fields` | uncovered | none | 0 |
 | `no_version_bounds_declared` | `no_version_bounds_declared` | executable | owned_state | 1 |
 | `non_refusal_exit` | `non_refusal_exit` | uncovered | none | 0 |
+| `npm_package_archive_missing` | `npm_package_archive_missing` | uncovered | none | 0 |
+| `npm_package_archive_unsafe` | `npm_package_archive_unsafe` | uncovered | none | 0 |
 | `npm_package_not_found` | `npm_package_not_found` | uncovered | none | 0 |
 | `ownership_conflict` | `ownership_conflict` | uncovered | none | 0 |
 | `ownership_dependency_bypass_restricted_options` | `ownership_dependency_bypass_restricted_options` | uncovered | none | 0 |

package/docs/performance/cli-transport-overhead.md

@@ -1,12 +1,20 @@
 # CLI transport overhead
 
-Tracked by [pm-yse5dt](../../.agents/pm/tasks/pm-yse5dt.toon).
+Tracked by [pm-yse5dt](../../.agents/pm/tasks/pm-yse5dt.toon), with RSS
+admission reliability owned by
+[pm-pz49xc](../../.agents/pm/issues/pm-pz49xc.toon).
 
 Each result starts from a fresh isolated workspace containing exactly one item.
 The command runs in a fresh Node v26.5.0 process on
 linux/x64; setup and fixture generation are
 outside the timed interval. Short local gates use the best observed latency,
-while the report retains p50 and p95 evidence.
+while the report retains p50 and p95 evidence. RSS admission uses the measured
+median so one page-level outlier cannot false-fail the gate; the maximum remains
+in the report as diagnostic evidence. Every post-warmup RSS sample must be a
+finite measurement; an unavailable sample makes the admission median unavailable
+and fails closed when a budget exists. Admission adds a fixed 512 KiB noise margin
+without changing the committed budget; a majority persistent increase beyond
+that bounded margin still fails.
 
 | Command   |   best |    p50 |    p95 |
 | --------- | -----: | -----: | -----: |

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.8.27",
+  "version": "2026.8.28",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -122,7 +122,7 @@
     "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/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 && pnpm quality:mcp-deprecations && 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 scripts/release/agent-task-token-gate.mjs && pnpm quality:mcp-deprecations && 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",

package/packages/pm-beads/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-beads",
-  "version": "2026.8.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "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.27",
+  "version": "2026.8.28",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",