@unbrained/pm-cli 2026.8.4 → 2026.8.5

package/docs/SDK.md

@@ -290,7 +290,8 @@ Command/action contract exports:
 - Relationship graph primitives: `RelationshipKindRegistry`, `createRelationshipKindRegistry`, `assertRelationshipEdgeAllowed`, `RelationshipGraph`, `RelationshipEventLog`, `RelationshipEventStore`, `planRelationshipEventBackfill`, `buildRelationshipContext`, `buildDepsRelationshipContext`, `hierarchyAncestors`, `hierarchyDescendants`, `orderingPredecessors`, `orderingSuccessors`, `enumerateRelationshipPaths`, `auditWorkspaceRelationshipGraph`, `isOrderingRelationshipKind`, and `dependencyToRelationship` provide application-defined edge semantics, durable replay, deterministic legacy migration, bounded semantic traversal, policy-aware governance, and explainable context queries. Mutation adapters should call `assertRelationshipEdgeAllowed` with the active registry before persistence; it resolves aliases and honors custom `allowSelf` definitions while built-in self edges fail before item or history writes. `RelationshipEventLog.stream/project` and their durable-store equivalents page immutable prefixes and fold them into deterministic application state with exact version, processed-count, and as-of metadata. `RelationshipEventStore.appendBatch` validates a complete import under one cross-process lock and atomically publishes it; `skip_identical` resume mode rejects same-id semantic collisions. `RelationshipGraphAdapter`, `createRelationshipGraphSnapshot`, `syncRelationshipGraphAdapter`, `loadRelationshipGraphAdapter`, and `federateRelationshipGraphSnapshots` form the backend-neutral content-addressed projection boundary for database or remote graph packages. `MemoryRelationshipGraphAdapter`, `assertRelationshipGraphAdapterConformance`, and `createRelationshipGraphScaleFixture` give package authors a reference implementation, reusable compatibility contract, and lazy deterministic fixtures through one million nodes. See [Relationship graph semantics](RELATIONSHIP_GRAPH.md).
 - Atomic application transactions: `commitWorkspaceTransaction` coordinates ordered, idempotent item and relationship mutations under one workspace writer lock and a durable replay journal. Interrupted work resumes from step inspection; ordinary failures append reverse-order compensations without rewriting immutable histories.
 - Multi-branch merge primitives: `mergeItemDocuments`, `mergeHistoryStreams`, `mergeRelationshipEventStreams`, `mergeJsonDocuments`, `runMergeDriver`, `runMergeInstall`, and `runMergeReconcile` provide the same field-aware item, hash-chain-preserving history, sequence-renumbering relationship-event, key-level configuration, and audited post-merge repair-and-verify semantics as `pm merge`; `installMergeFence` and `findGitWorkspaceRoot` let custom init hosts install the same contract with explicit roots, while `buildMergeAttributePatterns`, `refreshMergeAttributeFenceIfInstalled`, and `auditMergeAttributeFence` expose fence coverage, refresh, and validation. See [Multi-Branch Merge Safety](MERGE_SAFETY.md).
-- Dependency provenance primitives: `EXTERNAL_DEPENDENCY_SOURCE_KIND`, `isExternalDependencySourceKind`, and `normalizeDependencySeedId` let custom importers preserve cross-workspace dependency ids explicitly while retaining local prefix normalization for ordinary seeds. Newly created dependency rows also carry the effective `author`, `author_source` (`asserted` or `detected`), and a mutation `source_kind`; legacy rows remain readable without invented provenance.
+- Dependency provenance primitives: `EXTERNAL_DEPENDENCY_SOURCE_KIND`, `EXTERNAL_DEPENDENCY_SOURCE_KIND_ALIAS`, `isExternalDependencySourceKind`, and `normalizeDependencySeedId` let custom importers preserve cross-workspace dependency ids explicitly while retaining local prefix normalization for ordinary seeds. `source_kind: "external"` is the human-facing alias and persists canonically as `global`; a `blocked_by` row with that provenance is a real external predecessor, so graph governance does not require a fabricated local item or misreport `stale_lifecycle_block`. Newly created dependency rows also carry the effective `author`, `author_source` (`asserted` or `detected`), and a mutation `source_kind`; legacy rows remain readable without invented provenance. Tracked by [pm-6sc8jq](../.agents/pm/issues/pm-6sc8jq.toon).
+- Terminal-create primitive: `CreateCommandOptions.closeReason` and `completedAt` allow importers to create an already-terminal item in the same atomic item/history transaction while preserving the source completion time separately from the local `closed_at` mutation time. The equivalent CLI flags are `--close-reason` and `--completed-at`; direct JSON documents map `close_reason` and `completed_at` to the same SDK operation. A missing governed reason returns `close_reason_required` with same-command `pm create` recovery examples. Tracked by [pm-ykdt4m](../.agents/pm/issues/pm-ykdt4m.toon) and [pm-5uclvd](../.agents/pm/issues/pm-5uclvd.toon).
 - Compile-cache lifecycle primitive: `pruneCompileCacheGenerations` bounds pm-owned Node bytecode caches to the current package generation; embedded hosts can apply the same upgrade cleanup without importing the executable entrypoint.
 - Typed mutation inputs (pm-x29o / GH-601): `PmCreateActionOptions`, `PmUpdateActionOptions`, and `PmCloseActionOptions` (`PmClientCloseActionOptions` on the client method) strip the permissive custom-field index signature from the executable command-option contracts, retaining their exact public keys and value types without a second hand-written shape; the free `create`/`update`/`close` functions and `PmClient` methods share those types. `PmUpdateManyActionOptions`, `PmCloseManyActionOptions`, and `OptionsFromContracts` cover flat action-contract composition. Field typos, object values, invalid scalar kinds, and MCP-only aliases on a `PmClient` command-option bag fail `tsc` under strict. Runtime-schema custom fields use the repeatable `field` option and `PmClient.run` remains the wide escape hatch. Projected list rows expose the typed `ListProjectedItemCore` fields (`row.id` is `string | undefined`, never `unknown`).
 - Typed customization primitives on `PmClient`: `init`, `config`, `schema`, `schemaList`, `schemaShow`, `schemaAddType`, `schemaRemoveType`, `schemaAddStatus`, `schemaRemoveStatus`, `schemaAddField`, `schemaRemoveField`, `schemaListFields`, `schemaShowField`, `schemaApplyPreset`, `schemaInferTypes`, `schemaShowStatus`, `profile`, `profileList`, `profileShow`, `profileApply`, and `profileLint`
@@ -567,18 +568,20 @@ Tracked by [pm-5t33or](../.agents/pm/features/pm-5t33or.toon),
 [pm-gmdzaa](../.agents/pm/issues/pm-gmdzaa.toon), and
 [pm-dpqa3h](../.agents/pm/chores/pm-dpqa3h.toon).
 
-`PM_COMMAND_OUTPUT_BUDGET_CONTRACTS` declares one default estimated-token
-ceiling for every built-in command. Each row also carries its workload class,
+`PM_COMMAND_OUTPUT_BUDGET_CONTRACTS` declares generated TOON and JSON
+estimated-token ceilings for every built-in command. Each row also carries its workload class,
 the stable `ceil(UTF-8 bytes / 4)` estimate, whether an explicit unbounded
 request is allowed, and the shared deterministic degradation ladder:
 `full → compact → brief → summary → counts`. These contracts are policy data,
 not renderer-specific code, so package authors can reuse
-`definePmCommandOutputBudget`, `resolvePmCommandOutputBudget`, and
+`createPmCommandOutputBudget`, `definePmCommandOutputBudget`,
+`resolvePmCommandOutputBudget`, and
 `estimatePmOutputTokens` in custom transports.
 
 ```ts
 import {
   definePmCommandOutputBudget,
+  parseMutationReceipt,
   estimatePmOutputTokens,
   resolvePmCommandOutputBudget,
 } from "@unbraind/pm-cli/sdk/contracts";
@@ -587,6 +590,7 @@ const compactRead = definePmCommandOutputBudget({
   command: "get",
   budget_class: "read",
   default_max_estimated_tokens: 800,
+  default_max_estimated_tokens_by_format: { toon: 800, json: 1200 },
   degradation_ladder: ["compact", "summary"],
   allows_unbounded_opt_out: false,
   token_estimate: "ceil(utf8_bytes / 4)",
@@ -596,8 +600,21 @@ const builtIn = resolvePmCommandOutputBudget("contracts --summary");
 const measured = estimatePmOutputTokens(
   new TextEncoder().encode(JSON.stringify(result)).byteLength,
 );
+
+const receipt = parseMutationReceipt(mutationStdout);
+// receipt.id and receipt.changedFieldCount are typed; wrapped read envelopes
+// throw instead of silently producing an undefined id.
 ```
 
+`PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS` and
+`resolvePmCommandOutputEnvelope` declare whether the default structured result
+is a flat mutation receipt, wrapped entity, collection, diagnostic, or stream.
+The contracts command keeps summary bootstrap output compact and publishes
+complete budget/envelope pairs under `command_output_contracts` only in the
+explicit full projection. Active package commands receive deterministic
+fallback contracts, so extension authors can discover a bounded surface before
+they invoke it.
+
 `pm activity` applies a compact 20-row default bound; direct SDK calls default
 to five full rows. Results disclose `total_count`, `omitted_count`, `has_more`,
 and `applied_bound`. An explicit `limit` remains authoritative, while
@@ -1053,7 +1070,10 @@ tools that need to own item state without spawning `pm`.
 Tracked by [pm-4e12](../.agents/pm/features/pm-4e12.toon), with the VCS
 acceptance story [pm-8ngt](../.agents/pm/stories/pm-8ngt.toon) and the structured
 SDK adapters tracked by [pm-xm7c](../.agents/pm/features/pm-xm7c.toon) and
-[pm-kipd](../.agents/pm/features/pm-kipd.toon).
+[pm-kipd](../.agents/pm/features/pm-kipd.toon), versioned batch-local
+references tracked by [pm-o8z748](../.agents/pm/issues/pm-o8z748.toon), and
+atomic evidence-backed completion tracked by
+[pm-cyn0y6](../.agents/pm/issues/pm-cyn0y6.toon).
 
 `commitWorkspaceTransaction` is the public unit-of-work primitive for domain
 commands that must coordinate several SDK mutations. A plan supplies a stable
@@ -1193,12 +1213,15 @@ previously compensated retry without package-private file access.
 For the ubiquitous "commit N item mutations atomically" case (bulk import,
 bulk sync), `commitItemMutations` wraps the coordinator so callers describe
 the mutations instead of hand-writing a step array. The helper wires the
-crash-consistency contract for you: creates use their explicit stable `id` as
+crash-consistency contract for you: creates use their resolved stable `id` as
 the idempotency key (exists-by-id inspection) and are compensated by closing
 the item (or deleting it with `createCompensation: "delete"`); updates stamp a
 durable history marker for applied-detection and are compensated by restoring
 the captured pre-mutation version; closes treat an already-terminal target as
-applied and are likewise compensated by version restore. A stable
+applied and are likewise compensated by version restore; releases restore the
+prior claim when a later step fails. The journal step identity includes a
+canonical mutation fingerprint, so reusing a transaction id with changed
+payload fails before new work. A stable
 `transactionId` makes interrupted batches resumable across processes and
 agents.
 
@@ -1249,7 +1272,7 @@ each `addAc`/`removeAc` entry must be semicolon-free; unmatched removals are
 reported as `remove_ac_unmatched:<text>` warnings rather than disappearing as
 silent no-ops.
 
-`parseItemMutationBatch` is the strict JSON boundary for that primitive. It
+`parseItemMutationBatch` is the strict legacy JSON boundary for that primitive. It
 accepts either a non-empty mutation array or `{ "mutations": [...] }`, derives
 allowed option names from the exported create/update/close command contracts,
 and rejects unknown row or option keys with a did-you-mean diagnostic before a
@@ -1271,6 +1294,61 @@ await commitItemMutations({
 });
 ```
 
+For coherent heterogeneous specifications, use
+`resolveItemMutationDocument`. It accepts the legacy array or a versioned
+`{ schema_version: 1, mutations }` document. Create rows may declare a unique
+`ref`, omit `id`, and use exact `@ref` values in target ids, `parent`,
+`blockedBy`, and dependency `id` fields. Omitted ids are derived from the
+transaction id, alias, and workspace prefix; explicit ids are normalized.
+Malformed, duplicate, unknown, and cyclic references fail before tracker
+mutation. Commit the returned mutations and retain its alias-to-id receipt:
+
+```ts
+import {
+  commitItemMutations,
+  resolveItemMutationDocument,
+} from "@unbrained/pm-cli/sdk";
+import path from "node:path";
+
+const pmRoot = path.join(process.cwd(), ".agents", "pm");
+const specificationJson = JSON.stringify({
+  schema_version: 1,
+  mutations: [
+    {
+      op: "create",
+      ref: "initiative",
+      options: { title: "Initiative", type: "Epic" },
+    },
+    {
+      op: "create",
+      ref: "delivery",
+      options: {
+        title: "Delivery",
+        type: "Feature",
+        parent: "@initiative",
+      },
+    },
+  ],
+});
+
+const resolved = resolveItemMutationDocument(specificationJson, {
+  transactionId: "specification-2026-08-05-001",
+  idPrefix: "pm-",
+});
+await commitItemMutations({
+  pmRoot,
+  author: "specification-agent",
+  transactionId: "specification-2026-08-05-001",
+  mutations: resolved.mutations,
+});
+```
+
+`buildItemCompletionMutations` creates the ordered evidence/update, close, and
+release plan for inspection. `commitItemCompletion` executes that plan through
+the same durable coordinator, restoring annotations, linked artifacts,
+lifecycle fields, and claim ownership on failure. It is the SDK primitive
+behind `pm item complete`.
+
 `itemDocumentToMutationOptions` is the companion full-document adapter. It
 accepts either a direct `ItemDocument` or the envelope returned by
 `pm get <id> --json`, strips read-only metadata, maps canonical snake-case item
@@ -1281,9 +1359,11 @@ through the public `field` escape hatch.
 
 The built-in adapters stay deliberately thin:
 
-- `pm item mutate --transaction-id <stable-id> --stdin-json` validates and
-  commits a batch with `commitItemMutations`; `--dry-run` performs validation
-  only, and reusing the transaction id resumes or replays the durable journal.
+- `pm item mutate --transaction-id <stable-id> --stdin-json` resolves aliases,
+  validates, and commits a versioned batch; `--dry-run` returns the concrete
+  graph and alias receipt without writes.
+- `pm item complete <id> <reason> --transaction-id <stable-id>` records linked
+  evidence, closes, and releases a claim as one compensating transaction.
 - `pm create --stdin-json` and `pm update <id> --stdin-json` accept a whole item
   document. This supports the lossless `get → edit → update` agent workflow
   without translating every field into argv.

package/docs/SELF_DESCRIBING_CONTEXT_CONTRACTS.md

@@ -75,8 +75,21 @@ The default summary stays bounded. Larger intent and error catalogs are emitted
 - the stable snake-case code;
 - meaning and stability;
 - CLI exit code;
+- semantic exit class (`generic_failure`, `usage`, `not_found`, `conflict`, or `dependency_failed`);
 - recovery guidance;
 - source modules that emit the code.
+- inferred CLI command roots (`*` for cross-cutting runtime failures).
+
+Existing catalog entries are recorded in `scripts/error-code-stability.json`.
+The generator refuses to remove one of those stable codes unless the reviewed
+compatibility ledger is changed explicitly. Newly discovered codes are emitted
+as provisional until deliberately promoted, so adding a runtime declaration
+does not accidentally promise permanent compatibility.
+
+`PM_ERROR_CODE_EXIT_CLASS_CONTRACTS` is the portable shell taxonomy: exit 1 is
+generic failure, 2 is usage, 3 is not-found, 4 is conflict, and 5 is dependency
+failure. Catalog validation rejects a code whose declared semantic class and
+transport exit disagree.
 
 Run the drift gate after adding or removing a structured error:
 

package/docs/TESTING.md

@@ -248,6 +248,31 @@ step also fails until stale policy is reconciled. Public source claims are
 mapped to exact evidence strings and an enforced registry entry so
 documentation cannot silently advertise advisory behavior.
 
+## Tracker Context-Quality Ratchets
+
+Tracked by [pm-ips23h](../.agents/pm/issues/pm-ips23h.toon) and
+[pm-kpftft](../.agents/pm/tasks/pm-kpftft.toon).
+
+`scripts/release/tracker-measurements.json` turns measured tracker populations
+into reviewed, shrinking-only ceilings. Each declaration names its canonical
+pm owner and a selector over stored dependency kinds, validator warnings,
+graph-profile fields, or health-check severity. Open owners enforce their
+ceiling; terminal owners retire it. Validator warnings and health checks are
+exhaustive, so a newly observed class fails until it has a canonical owner and
+reviewed declaration.
+
+Run the same gate used by hosted CI:
+
+```bash
+pnpm quality:tracker-measurements
+node scripts/release/tracker-measurement-gate.mjs --negative-control
+```
+
+`--update` can only lower a ceiling. It refuses to write while any population
+has regressed or remains undeclared, so updating the baseline cannot absorb a
+failure. Dependency-kind regressions include the post-measurement item, target,
+author, timestamp, and mutation-source rows in the JSON receipt.
+
 ## Agent Output Token Budgets
 
 Run the required PR gate locally:

package/docs/examples/sdk-contract-consumer/README.md

@@ -6,6 +6,7 @@ This example shows how to consume `pm` contracts programmatically in a script an
 
 - `package.json` -> installs `@unbrained/pm-cli` and script aliases
 - `inspect-contracts.mjs` -> loads contracts + SDK helpers and prints required/optional parameter metadata
+- `parse-receipt.mjs` -> executes a real create and parses its flat mutation receipt with the SDK
 
 ## Run
 
@@ -20,6 +21,7 @@ npm install "$PM_CLI_REPO_ROOT"
 # npm install @unbrained/pm-cli@latest
 
 node inspect-contracts.mjs create
+npm run parse:receipt
 ```
 
 Expected output shape:
@@ -27,7 +29,14 @@ Expected output shape:
 ```json
 {
   "action": "create",
-  "required_parameters": ["title", "description", "type", "status", "priority", "message"],
+  "required_parameters": [
+    "title",
+    "description",
+    "type",
+    "status",
+    "priority",
+    "message"
+  ],
   "optional_parameters": ["template", "createMode", "schedulePreset"],
   "any_of_required_groups": [],
   "runtime_available": true,
@@ -55,3 +64,4 @@ node inspect-contracts.mjs extension-reload
 - Uses `PM_TOOL_ACTION_PARAMETER_CONTRACTS` for deterministic required/optional metadata.
 - Uses runtime `pm contracts --json` so extension-provided actions and command availability are reflected.
 - Includes policy-state and compatibility metadata so CI/app callers can gate behavior during v1 -> v2 migrations.
+- Uses `parseMutationReceipt()` at the process boundary instead of guessing that mutation output has the read-only `{ item: ... }` wrapper.

package/docs/examples/sdk-contract-consumer/package.json

@@ -5,6 +5,7 @@
   "scripts": {
     "inspect:create": "node inspect-contracts.mjs create",
     "inspect:update": "node inspect-contracts.mjs update",
-    "inspect:reload": "node inspect-contracts.mjs extension-reload"
+    "inspect:reload": "node inspect-contracts.mjs extension-reload",
+    "parse:receipt": "node parse-receipt.mjs"
   }
 }

package/docs/examples/sdk-contract-consumer/parse-receipt.mjs

@@ -0,0 +1,22 @@
+import { spawnSync } from "node:child_process";
+import { parseMutationReceipt } from "@unbrained/pm-cli/sdk";
+
+const completed = spawnSync(
+  "pm",
+  ["create", "SDK receipt example", "--type", "Task", "--json"],
+  { encoding: "utf8", env: { ...process.env, NO_COLOR: "1" } },
+);
+
+if (completed.error) {
+  throw new Error(`Failed to run pm create: ${completed.error.message}`, {
+    cause: completed.error,
+  });
+}
+if (completed.status !== 0) {
+  throw new Error(
+    completed.stderr.trim() || `pm create failed with ${completed.status}`,
+  );
+}
+
+const receipt = parseMutationReceipt(completed.stdout);
+process.stdout.write(`${JSON.stringify(receipt, null, 2)}\n`);

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.8.4",
+  "version": "2026.8.5",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -120,7 +120,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 && pnpm exec tsx scripts/release/static-quality-gate.mts --max-eslint-suppressions 127 --max-coverage-ignore-pragmas 477 --min-docstring-coverage 100 --min-exported-docstring-coverage 100 --min-member-docstring-coverage 100 && node scripts/release/audit-package-boundary.mjs && node scripts/release/package-sdk-contract-parity.mjs && node scripts/release/token-budget-gate.mjs && node scripts/release/context-intent-calibration-gate.mjs && 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",
+    "quality:static": "pnpm build && pnpm exec tsx scripts/release/static-quality-gate.mts --max-eslint-suppressions 114 --max-coverage-ignore-pragmas 477 --min-docstring-coverage 100 --min-exported-docstring-coverage 100 --min-member-docstring-coverage 100 && node scripts/release/audit-package-boundary.mjs && node scripts/release/package-sdk-contract-parity.mjs && node scripts/release/token-budget-gate.mjs && node scripts/release/context-intent-calibration-gate.mjs && node scripts/release/tracker-measurement-gate.mjs && 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",
     "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",
@@ -130,6 +130,7 @@
     "quality:retrieval-eval": "pnpm build && node scripts/release/retrieval-eval-gate.mjs",
     "quality:retrieval-eval:update": "pnpm build && node scripts/release/retrieval-eval-gate.mjs --update",
     "quality:gate-registry": "pnpm build && node scripts/release/gate-registry.mjs",
+    "quality:tracker-measurements": "pnpm build && node scripts/release/tracker-measurement-gate.mjs",
     "quality:package-artifact": "pnpm build && node scripts/release/package-artifact-gate.mjs",
     "quality:docs-skills": "node scripts/release/docs-skills-gate.mjs",
     "quality:docs-links": "node scripts/release/docs-skills-gate.mjs --links-only",

package/packages/pm-beads/package.json

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