@unbrained/pm-cli 2026.8.19 → 2026.8.20

package/dist/sdk/similarity.js

@@ -5,11 +5,11 @@
  * governance and package-owned duplicate analysis.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a2fad90a-3575-5f3e-8cbe-ac380ac45591")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="33a43890-abcf-58fc-bf9d-bf2619d4cf35")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
-import { normalizeStatusInput } from "../core/item/status.js";
+import { isTerminalStatus, normalizeStatusInput } from "../core/item/status.js";
 import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
 import { listAllItemMetadataLight } from "../core/store/item-store.js";
 import { resolvePmRoot } from "../core/store/paths.js";
@@ -32,8 +32,28 @@ export function similarityAdvisoryWarnings(advisory) {
             `likely_duplicates:${advisory.result.items
                 .map((item) => item.id)
                 .join(",")}`,
+            `likely_duplicate_recovery:${advisory.recovery.action}:${advisory.recovery.item_id}`,
         ];
 }
+async function resolveSimilarityRecovery(result, options) {
+    const strongest = result.items[0];
+    const pmRoot = resolvePmRoot(options.cwd ?? process.cwd(), options.pmRoot);
+    const statusRegistry = resolveRuntimeStatusRegistry((await readSettings(pmRoot)).schema);
+    if (isTerminalStatus(strongest.status, statusRegistry)) {
+        return {
+            action: "reopen",
+            item_id: strongest.id,
+            command: `pm item reopen ${strongest.id} "<recurrence reason>"`,
+            args: ["item", "reopen", strongest.id, "<recurrence reason>"],
+        };
+    }
+    return {
+        action: "reuse",
+        item_id: strongest.id,
+        command: `pm get ${strongest.id} --full`,
+        args: ["get", strongest.id, "--full"],
+    };
+}
 function validateSimilarityOptions(options) {
     const limit = options.limit ?? DEFAULT_SIMILARITY_LIMIT;
     const threshold = options.threshold ?? DEFAULT_SIMILARITY_THRESHOLD;
@@ -287,20 +307,26 @@ export async function evaluateSimilarityGovernance(candidate, options) {
     const result = await findSimilarItems(candidate, options);
     if (result.count === 0)
         return undefined;
+    const recovery = await resolveSimilarityRecovery(result, options);
     const bypassed = options.mode === "strict" && options.allowDuplicate === true;
     if (options.mode === "strict" && !bypassed) {
         const candidates = result.items
             .map((item) => `${item.id} (${item.status}): ${item.title}`)
             .join("; ");
-        throw new PmCliError(`Likely duplicate item(s) found: ${candidates}. Reuse the canonical item or pass --allow-duplicate with explicit intent.`, EXIT_CODE.CONFLICT, {
+        const recoveryInstruction = recovery.action === "reopen"
+            ? "Reopen the canonical item"
+            : "Reuse the canonical item";
+        throw new PmCliError(`Likely duplicate item(s) found: ${candidates}. ${recoveryInstruction} or pass --allow-duplicate with explicit intent.`, EXIT_CODE.CONFLICT, {
             code: "likely_duplicate",
-            required: "Reuse an existing item, or explicitly acknowledge the duplicate with --allow-duplicate.",
+            required: `${recoveryInstruction}, or explicitly acknowledge the duplicate with --allow-duplicate.`,
             recovery: {
                 suggested_flags: ["--allow-duplicate"],
+                suggested_retry: recovery.command,
+                suggested_retry_args: recovery.args,
             },
         });
     }
-    return { mode: options.mode, bypassed, result };
+    return { mode: options.mode, bypassed, result, recovery };
 }
 //# sourceMappingURL=similarity.js.map
-//# debugId=a2fad90a-3575-5f3e-8cbe-ac380ac45591
+//# debugId=33a43890-abcf-58fc-bf9d-bf2619d4cf35

package/docs/COMMANDS.md

@@ -52,7 +52,7 @@ JSON ceiling; TOON uses the smaller default agent ceiling.
 | Family       | Commands                                                                                                                       | Purpose                                                                                                                                                                                                                                                |
 | ------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Bootstrap    | `init`, `config`, `health`, `telemetry`                                                                                        | create and inspect tracker setup                                                                                                                                                                                                                       |
-| Lifecycle    | `create`, `copy`, `focus`, `claim`, `update`, `append`, `close`, `release`, `delete`, `start-task`, `pause-task`, `close-task` | mutate item state                                                                                                                                                                                                                                      |
+| Lifecycle    | `create`, `copy`, `focus`, `claim`, `update`, `item reopen`, `append`, `close`, `release`, `delete`, `start-task`, `pause-task`, `close-task` | mutate item state, including terminal-work recurrence without duplicate creation                                                                                                                                                                       |
 | Bulk         | `item mutate`, `item complete`, `update-many`, `close-many`                                                                    | atomically commit heterogeneous SDK mutation batches or evidence-backed completion, or apply one change across a matched, dry-run-previewed set with a rollback checkpoint                                                                             |
 | Scheduling   | `meet`, `event`, `remind`                                                                                                      | low-friction Meeting/Event/Reminder creation                                                                                                                                                                                                           |
 | Planning     | `plan create`, `plan add-step`, `plan update-step`, `plan complete-step`, `plan link`, `plan approve`, `plan materialize`      | agent-optimized living plans with ordered steps, evidence, decisions, validation, and materialization                                                                                                                                                  |
@@ -165,6 +165,18 @@ custom statuses are normalized through the runtime status registry and an
 unknown status fails instead of returning a false-clean result.
 Use `pm get <id>` to read a single item by ID — the single-item read primitive used throughout the agent loop. It accepts `--fields <list>` and `--depth brief|standard|deep|full` for token-minimal projections, and `--tree`/`--tree-depth <n>` to include descendants. Standard/deep reads expose a normalized `schedule` facet (`deadline`, `start_at`, `end_at`, `location`, reminders, and events) when scheduling metadata exists. Container-oriented built-ins (Epic, Feature, Milestone, and Plan) plus custom types automatically expose type-agnostic child counts and continuation metadata. Standard depth keeps that rollup counts-only; `--depth deep|full` or an explicit `--fields id,children` request adds the deterministic bounded child sample. Built-in leaf reads avoid a workspace scan unless children are explicitly requested. `pm get <id> --json` returns the `body` inside the `item` object (`.item.body`); see [Full results, totals, and bodies](#full-results-totals-and-bodies). To duplicate an existing item as a starting point, `pm copy <id> --title "New title"` clones it into a fresh id with lifecycle fields reset.
 
+When the strongest duplicate match is terminal because the same work recurred,
+reuse its lineage instead of creating or copying another item:
+
+```bash
+pm item reopen pm-a1b2 "The production failure recurred" --status in_progress
+```
+
+The command appends a structured `reopen` history event, preserves the earlier
+closure in immutable history, clears stale terminal metadata through the normal
+update path, and refuses an already-active item. See
+[Recurrence and Executable Recovery Contracts](RECURRENCE_RECOVERY_CONTRACTS.md).
+
 Add `--at <version|ISO-timestamp>` for a verified point-in-time read. It replays the same hash-checked history kernel used by restore but never acquires a lock, writes the item, or appends history. The result always includes `reconstructed: true`, `as_of_version`, and `as_of_timestamp`. Future/out-of-range targets fail with structured `valid_range` metadata. `--at` cannot be combined with `--tree`; workspace-wide historical graph projections require a future indexed primitive.
 `context` standard/deep views include high-level child completion counters plus `recently_created` and `unparented` sections, so agents can spot new orphan work before creating duplicates.
 Use `pm aggregate --completion` when you need per-group `open`, `in_progress`, `closed`, `other`, and `completion_pct` progress context.

package/docs/README.md

@@ -57,6 +57,7 @@ pm guide release --json
 - [Improvement Ledger and History Analytics](IMPROVEMENT_ANALYTICS.md) - audited quantitative observations, live provenance coverage, and bounded observational fleet outcomes.
 - [Project Assurance Primitives](ASSURANCE.md) - SDK-owned measurements, assertions, lifecycle gates, cost receipts, and durable verdict history shared by CLI and MCP.
 - [Defect Recurrence and Boundary Evidence](DEFECT_RECURRENCE.md) - captured external samples, structured defect-escape evidence, incremental change-risk indexing, and executable recovery-producer census.
+- [Recurrence and Executable Recovery Contracts](RECURRENCE_RECOVERY_CONTRACTS.md) - terminal-item recurrence, duplicate-intake routing, capability-aware reindex recovery, and target-aware generated test guidance.
 - [Trustworthy Context and Evidence Contracts](TRUSTWORTHY_CONTEXT_EVIDENCE.md) - full-record assurance, graph composition, boolean health rows, lossless linked-test removal, and role-labelled recovery.
 - [Context Integrity Contracts](CONTEXT_INTEGRITY_CONTRACTS.md) - sparse-read identity, closed extension manifests, lossless remote docs, direction-locked graph impact, and cross-version history epochs.
 - [SDK Evidence Traceability and Integrity](SDK_EVIDENCE_TRACEABILITY.md) - reverse source-to-item lookup, atomic evidence replacement, no-op history, linked-test collision classification, and telemetry drain receipts.

package/docs/RECURRENCE_RECOVERY_CONTRACTS.md

@@ -0,0 +1,114 @@
+# Recurrence and Executable Recovery Contracts
+
+Tracked by [pm-83cz0o](../.agents/pm/features/pm-83cz0o.toon),
+[pm-qljv](../.agents/pm/issues/pm-qljv.toon),
+[pm-surv](../.agents/pm/issues/pm-surv.toon),
+[pm-h8tpeh](../.agents/pm/features/pm-h8tpeh.toon), and
+[pm-f05lsg](../.agents/pm/features/pm-f05lsg.toon).
+
+## Agent Quick Context
+
+- Reuse an active matching item; reopen a terminal matching item.
+- `pm item reopen` is the noun-first recurrence command. It never creates a
+  second item and never rewrites the earlier close event.
+- Recovery guidance is capability-aware: it names an executable command on the
+  current surface, or installs the package that owns the command first.
+- Generated `AGENTS.md` guidance detects the target repository's test command.
+  When no executable test contract exists, it prints an explicit placeholder
+  instead of naming a pm-cli repository script that the target does not have.
+
+## Reopen Terminal Work
+
+```bash
+pm item reopen pm-a1b2 "The production failure recurred after deployment"
+pm item reopen pm-a1b2 "The customer reproduced the issue" --status in_progress
+```
+
+The command accepts only the workspace open or in-progress status. While
+holding the item lock it verifies that the current status is terminal, records
+one `reopen` history event with structured recurrence context, and delegates the
+state change to the normal update pipeline. Active metadata drops stale
+`closed_at`, `completed_at`, `close_reason`, `resolution`, `expected_result`,
+`actual_result`, and `fixed_version` values. Earlier history retains the exact
+closure values.
+
+Compact output keeps the recurrence receipt because the prior and next status,
+reason, and terminal evidence are the proof that this was a recurrence rather
+than a generic edit. An already-active item fails with
+`item_already_active` and points to `pm get <id> --full`; continue that item with
+`pm update` instead of manufacturing another recurrence event.
+
+## SDK and MCP
+
+```ts
+import { PmClient, reopen } from "@unbrained/pm-cli/sdk";
+
+const pm = new PmClient({ pmRoot: "/workspace/.agents/pm" });
+const viaClient = await pm.reopen(
+  "pm-a1b2",
+  "The production failure recurred",
+  { status: "in_progress" },
+);
+
+const viaFunction = await reopen(
+  "pm-c3d4",
+  "The customer reproduced the issue",
+  {},
+  { pmRoot: "/workspace/.agents/pm" },
+);
+
+console.log(viaClient.recurrence.previous_terminal);
+console.log(viaFunction.recurrence.from_status);
+```
+
+Generic action hosts use `item-reopen` with required `id` and `reason` fields.
+The action participates in the generated action schema, SDK dispatch coverage,
+CLI/SDK parameter parity, command grammar, and MCP `pm_run` surface.
+
+## Duplicate Intake
+
+Create and copy similarity governance inspect all lifecycle statuses. The
+strongest active match returns a `pm get <id> --full` reuse path. The strongest
+terminal match returns:
+
+```bash
+pm item reopen <id> "<recurrence reason>"
+```
+
+Strict duplicate refusal exposes the same command and tokenized arguments in
+its structured recovery envelope. Advisory mode adds a compact
+`likely_duplicate_recovery:<reuse|reopen>:<id>` warning so agents can select the
+correct lifecycle action without reparsing prose.
+
+## Capability-Aware Reindex Recovery
+
+When semantic search detects stale vectors, it inspects the active extension
+command registry. If `reindex` is active, the direct recovery is:
+
+```bash
+pm reindex --mode hybrid
+```
+
+If the command is absent, recovery is a two-step executable sequence:
+
+```bash
+pm install search-advanced --project
+pm reindex --mode hybrid
+```
+
+The human warning and structured `vector_index_recovery` tokens come from the
+same resolution. This prevents a base installation from suggesting an
+unavailable command.
+
+## Target-Aware Generated Test Guidance
+
+`pm init --agent-guidance add` resolves the linked-test command in this order:
+
+1. `node scripts/run-tests.mjs test` when that repository script exists.
+2. The declared package manager's `test` script (`pnpm test`, `bun run test`,
+   `yarn test`, or `npm test`).
+3. `<your project test command>` when the target does not declare an executable
+   test contract.
+
+The managed guidance block is versioned, so a later init can replace an older
+pm-managed block without changing surrounding repository instructions.

package/docs/SDK.md

@@ -54,6 +54,11 @@ Positional command signatures, action-scoped discovery, and MCP/CLI option
 parity are tracked by [pm-ya7x55](../.agents/pm/tasks/pm-ya7x55.toon),
 [pm-2tan](../.agents/pm/issues/pm-2tan.toon), and
 [pm-y0htkd](../.agents/pm/issues/pm-y0htkd.toon).
+Terminal recurrence and executable recovery are tracked by
+[pm-83cz0o](../.agents/pm/features/pm-83cz0o.toon),
+[pm-qljv](../.agents/pm/issues/pm-qljv.toon), and
+[pm-surv](../.agents/pm/issues/pm-surv.toon); see
+[Recurrence and Executable Recovery Contracts](RECURRENCE_RECOVERY_CONTRACTS.md).
 
 Use it for extension authoring, package authoring, command/action contract discovery, and deterministic app or CI automation. Do not import private `src/core/...` modules from external integrations or packages.
 
@@ -1127,10 +1132,13 @@ filters, and bound the race-loss candidate walk with `maxAttempts` (1 through
 tools do not need to reproduce CLI concurrency policy.
 
 Lifecycle convenience methods and the matching top-level functions (`create`,
-`update`, `close`, `claim`, `release`, `copy`, `deleteItem`, `restore`,
+`update`, `reopen`, `close`, `claim`, `release`, `copy`, `deleteItem`, `restore`,
 `focus`, `startTask`, `pauseTask`, and `closeTask`) use the same mutation paths
 as the CLI and MCP dispatcher. They are the baseline primitives for custom PM
-tools that need to own item state without spawning `pm`.
+tools that need to own item state without spawning `pm`. `reopen` requires a
+recurrence reason, accepts only the workspace open or in-progress target, and
+returns the terminal evidence captured atomically before the update path clears
+it from active metadata.
 
 ### Atomic workspace transactions
 

package/docs/SDK_CONTEXT_INTEGRITY.md

@@ -2,6 +2,8 @@
 
 Tracker: [pm-0k19l7](../.agents/pm/issues/pm-0k19l7.toon), [pm-9stazf](../.agents/pm/issues/pm-9stazf.toon), [pm-tu71](../.agents/pm/issues/pm-tu71.toon), [pm-0xmajx](../.agents/pm/issues/pm-0xmajx.toon), [pm-7rrqsk](../.agents/pm/issues/pm-7rrqsk.toon), [pm-ety1qc](../.agents/pm/issues/pm-ety1qc.toon), [pm-lu6sca](../.agents/pm/features/pm-lu6sca.toon), [pm-5y05kq](../.agents/pm/issues/pm-5y05kq.toon), [pm-gjjurs](../.agents/pm/issues/pm-gjjurs.toon), [pm-h97qxd](../.agents/pm/issues/pm-h97qxd.toon), [pm-h06944](../.agents/pm/issues/pm-h06944.toon), [pm-5t33or](../.agents/pm/features/pm-5t33or.toon), [pm-in23qu](../.agents/pm/issues/pm-in23qu.toon), [pm-h8tpeh](../.agents/pm/features/pm-h8tpeh.toon), [pm-okgxwa](../.agents/pm/issues/pm-okgxwa.toon), [pm-22rzjp](../.agents/pm/issues/pm-22rzjp.toon), [pm-76fkpp](../.agents/pm/issues/pm-76fkpp.toon), [pm-igdvfq](../.agents/pm/issues/pm-igdvfq.toon), [pm-643e0k](../.agents/pm/issues/pm-643e0k.toon), [pm-larv4r](../.agents/pm/issues/pm-larv4r.toon), [pm-mcxk8v](../.agents/pm/issues/pm-mcxk8v.toon), and [pm-2zkvxm](../.agents/pm/issues/pm-2zkvxm.toon).
 
+Current closure tranche: [pm-fs8q9x](../.agents/pm/tasks/pm-fs8q9x.toon), [pm-gy885b](../.agents/pm/issues/pm-gy885b.toon), and [pm-f05lsg](../.agents/pm/features/pm-f05lsg.toon).
+
 ## Agent Quick Context
 
 These contracts keep project management equal to context management: reads say what they omit, writes return only newly useful context, diagnostics do not unexpectedly call remote providers, and every transport delegates domain validation to the same SDK primitive. Package authors can use the same primitives without reproducing CLI parsing rules.
@@ -74,6 +76,39 @@ The structured `option_scope` is `declared_on_path`, `declared_elsewhere`, or
 case, while the third names the nearest current-path spellings and explicitly
 terminates the otherwise-unbounded command search.
 
+## Semantic flag and spelling contracts
+
+`listPmFlagLexicon()` classifies flags by meaning rather than spelling alone.
+For example, `--limit` is the shared `result-row-limit` concept, while
+`--node-limit`, `--edge-limit`, `--output-limit`, `--output-budget`, and
+`--token-budget` retain distinct graph, serialization, and intent-budget
+semantics. Command-local overloads such as `--file` are explicitly separated
+into linked-file, annotation-input, and plan-definition concepts.
+
+`listPmFlagSpellingInventory()` publishes every canonical spelling and every
+accepted compatibility alias. The repository gate compares it with
+`scripts/release/flag-spelling-baseline.json`; removing either a canonical flag
+or an established alias fails closed. A separate generated help baseline
+records UTF-8 size, estimated tokens, and per-command deltas, so a vocabulary
+change cannot silently expand the agent discovery surface. Refreshing either
+baseline is an explicit reviewed operation through
+`node scripts/release/flag-lexicon-gate.mjs --update-inventory`.
+
+## Closed-domain refusal contracts
+
+`listCoreClosedDomainContracts()` is the SDK-owned registry for every built-in
+`--for` intent and `--fields` projection refusal. It derives projection values
+from the list, get, and search query modules and covers all eight list-family
+entrypoints. CLI help uses the same registry, representing `item.<field>` and
+runtime-schema extensions with compact generative notation instead of
+repeating every alias.
+
+The executable gate derives its refusal corpus from this registry, requires
+the exact error code, complete `allowed_values`, shell-free
+`suggested_retry_args`, and a successful retry, then compares probe identities
+with `scripts/release/refusal-closure-baseline.json`. Adding a new core domain
+without a probe or removing historical coverage therefore fails CI.
+
 ## Executable recovery-reference coverage
 
 Structured refusal guidance is a forward-reference contract, not decorative
@@ -89,6 +124,16 @@ family. Each obligation declares `recovery`, `replacement`, or
 `behavior_preserving` semantics and its proof must demonstrate the same
 promise.
 
+`verifyPmRecoveryKindRuntimeCoverage` joins the syntax-aware complete source
+census to distinct emitted values for every typed kind. Its receipt retains
+both denominators and fails when a kind has source producers but no runtime
+evidence, preventing a representative recovery example from masking an
+entirely unexecuted producer family. This is explicitly kind-level assurance:
+it does not claim that every individual source location or every distinct value
+was executed. The former `verifyPmRecoveryProducerRuntimeCoverage` export
+remains as a deprecated compatibility alias with those same kind-level
+semantics.
+
 The repository integration corpus drives real CLI refusals, executes the
 emitted retry in a temporary tracker, compares candidate commands with the
 unbounded runtime contract enumeration, and binds examples and next steps to

package/docs/generated/AGENT_COMMAND_SURFACE.md

@@ -12,7 +12,7 @@ This file is generated from `PM_COMMAND_CAPABILITY_CONTRACTS`. Do not edit it ma
 | `install` | full | extensions |
 | `upgrade` | full | extensions |
 | `create` | core | intake |
-| `item` | full | intake |
+| `item-reopen` | full | lifecycle |
 | `copy` | full | intake |
 | `focus` | standard | intake |
 | `list` | core | context |

package/docs/performance/sdk-entrypoint-import-costs.md

@@ -1,13 +1,11 @@
 # SDK entrypoint import costs
 
 Tracked by [pm-38bskj](../../.agents/pm/tasks/pm-38bskj.toon) and
-[pm-cg1sjb](../../.agents/pm/issues/pm-cg1sjb.toon). Standalone merge-bundle
-topology is tracked by
-[pm-m9gu9r](../../.agents/pm/chores/pm-m9gu9r.toon).
+[pm-cg1sjb](../../.agents/pm/issues/pm-cg1sjb.toon).
 
 This table measures fresh-process ESM import and module evaluation. The bare
 Node v26.5.0 process floor on linux/x64
-was 41 ms p50 (48 ms p95) across
+was 44 ms p50 (56 ms p95) across
 5 measured runs after one warm-up. Focused entrypoints are
 compared with the compatibility aggregate; negative reduction means the focused
 entrypoint was slower in this sample. The gate admits the median measured run
@@ -15,25 +13,20 @@ against the unchanged upper-bound budget and 30 ms scheduler margin. A single
 cold or descheduled process therefore cannot fail the gate, while a majority of
 over-budget samples still does; p95 remains visible as diagnostic evidence.
 
-| Package export     |    p50 |    p95 | p50 above Node | Reduction vs aggregate |
-| ------------------ | -----: | -----: | -------------: | ---------------------: |
-| `./sdk`            | 248 ms | 249 ms |         207 ms |                     0% |
-| `./sdk/authoring`  |  71 ms |  76 ms |          30 ms |                  85.5% |
-| `./sdk/contracts`  |  73 ms |  87 ms |          32 ms |                  84.5% |
-| `./sdk/core`       | 221 ms | 255 ms |         180 ms |                    13% |
-| `./sdk/governance` | 154 ms | 161 ms |         113 ms |                  45.4% |
-| `./sdk/graph`      |  87 ms |  87 ms |          46 ms |                  77.8% |
-| `./sdk/merge`      | 111 ms | 122 ms |          70 ms |                  66.2% |
-| `./sdk/query`      | 100 ms | 105 ms |          59 ms |                  71.5% |
-| `./sdk/runtime`    | 251 ms | 289 ms |         210 ms |                  -1.4% |
-| `./sdk/testing`    | 241 ms | 307 ms |         200 ms |                   3.4% |
+| Package export | p50 | p95 | p50 above Node | Reduction vs aggregate overhead |
+|---|---:|---:|---:|---:|
+| `./sdk` | 320 ms | 348 ms | 276 ms | 0% |
+| `./sdk/authoring` | 91 ms | 99 ms | 47 ms | 83% |
+| `./sdk/contracts` | 152 ms | 156 ms | 108 ms | 60.9% |
+| `./sdk/core` | 285 ms | 291 ms | 241 ms | 12.7% |
+| `./sdk/governance` | 211 ms | 220 ms | 167 ms | 39.5% |
+| `./sdk/graph` | 92 ms | 105 ms | 48 ms | 82.6% |
+| `./sdk/merge` | 130 ms | 145 ms | 86 ms | 68.8% |
+| `./sdk/query` | 132 ms | 156 ms | 88 ms | 68.1% |
+| `./sdk/runtime` | 283 ms | 312 ms | 239 ms | 13.4% |
+| `./sdk/testing` | 274 ms | 319 ms | 230 ms | 16.7% |
 
 The aggregate `@unbrained/pm-cli/sdk` remains supported for compatibility.
 New packages should import the narrowest subpath that owns their capability.
-The build emits `./sdk/merge` as a standalone no-splitting bundle because its
-dependency closure overlaps with several broader focused entrypoints. Keeping
-that surface in the shared focused chunk graph made a merge-only import traverse
-unrelated chunks; the isolated output preserves the same public exports while
-keeping its runtime loading cost proportional to the capability requested.
 The committed budget file is an upper-bound ratchet and must not be weakened to
 hide a regression.

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.8.19",
+  "version": "2026.8.20",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -218,18 +218,18 @@
     "@sentry/cli": "^3.6.2",
     "@types/node": "^26.2.0",
     "@types/npm-package-arg": "^6.1.4",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
     "esbuild": "0.28.2",
     "eslint": "^10.8.1",
     "eslint-plugin-sonarjs": "^4.2.0",
     "eslint-plugin-unicorn": "^73.0.0",
     "fast-check": "^4.9.0",
-    "greptile": "^3.4.0",
-    "jscpd": "^5.0.15",
+    "greptile": "^3.4.1",
+    "jscpd": "^5.0.16",
     "tsx": "^4.23.12",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.67.0",
-    "vitest": "^4.1.10",
+    "vitest": "^4.1.11",
     "yaml": "^2.9.0"
   }
 }

package/packages/pm-beads/package.json

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