@unbrained/pm-cli 2026.8.30 → 2026.9.1

package/.agents/skills/HARNESS_COMPATIBILITY.md

@@ -26,7 +26,7 @@ Use the same low-token route in every harness:
 Before release, run:
 
 ```bash
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide skills --depth standard
 node scripts/release/docs-skills-gate.mjs
 ```

package/.agents/skills/README.md

@@ -35,7 +35,7 @@ contracts.
 ## Runtime Routing
 
 ```bash
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide                       # topic index
 pm guide skills
 pm guide harnesses --depth standard

package/.agents/skills/pm-developer/SKILL.md

@@ -34,7 +34,7 @@ routed into by section from the references below.
 Optional deep routing that never goes stale:
 
 ```bash
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide workflows --depth brief
 ```
 

package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md

@@ -15,7 +15,7 @@ pnpm build
 ```bash
 pm context --limit 10
 pm search "<keywords>" --limit 10
-pm list-open --limit 20
+pm list --status open --limit 20
 pm claim <ID>
 pm update <ID> --status in_progress --description "..."
 pm append <ID> --body "Implementation notes"
@@ -42,7 +42,7 @@ pm release <ID>
 ## Local Docs Routing
 
 ```bash
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide workflows
 pm guide commands --depth standard
 pm guide release --json

package/.agents/skills/pm-developer/references/MULTI_AGENT_MERGE.md

@@ -22,7 +22,7 @@ Skipping this is the single most common cause of tracker merge conflicts.
 - `pm claim <ID>` before substantial edits. A claim is a recorded lease, not a
   lock file, and it survives branching.
 - `pm release <ID>` when pausing, handing off, closing, or canceling.
-- `pm list-in-progress` shows what the fleet currently holds.
+- `pm list --status in_progress` shows what the fleet currently holds.
 - Never force an ownership or lock override without explicit human approval.
 
 Author identity is detected per invocation — harness, model, effort, role, and

package/.agents/skills/pm-developer/references/TOKEN_BUDGETS.md

@@ -81,5 +81,5 @@ pm next                 # ~2.5k tok — one actionable item with its context
 pm contracts --summary  # ~2.6k tok — the command surface with per-command ceilings
 ```
 
-Prefer `pm next` over `pm list-open` when the goal is to start work: it applies
+Prefer `pm next` over `pm list --status open` when the goal is to start work: it applies
 relevance ranking and returns a working set rather than a page of rows.

package/.agents/skills/pm-extensions/SKILL.md

@@ -29,7 +29,7 @@ profiles over the same substrate.
 Optional deep routing that never goes stale:
 
 ```bash
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide extensions
 ```
 
@@ -59,7 +59,7 @@ pm contracts --runtime-only --availability-only
 pm package explore --project              # inspect state first
 pm package manage --detail summary
 pm package doctor --detail deep
-pm install <package> --project            # then mutate
+pm package install <package> --project            # then mutate
 pm contracts --command <extension-command> --flags-only
 pm package doctor --detail deep           # verify after
 ```

package/.agents/skills/pm-extensions/references/AUTHORING.md

@@ -74,7 +74,7 @@ moment the package publishes.
 ```bash
 pm package init <name>                       # scaffold
 # ...implement extensions/*.ts...
-pm install <path-or-name> --project          # install locally
+pm package install <path-or-name> --project          # install locally
 pm package doctor --detail deep              # activation diagnostics
 pm contracts --command <your-command> --flags-only
 pm <your-command> --help --json              # the contract a consumer will read

package/.agents/skills/pm-extensions/references/LIFECYCLE.md

@@ -11,7 +11,7 @@ pm package doctor --detail deep
 ## Install and Activate
 
 ```bash
-pm install <target> --project
+pm package install <target> --project
 pm package activate <target> --project
 pm package doctor --detail summary
 ```

package/.agents/skills/pm-sdk/SKILL.md

@@ -29,7 +29,7 @@ integration should never import repository internals to get it.
 Optional deep routing that never goes stale:
 
 ```bash
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide sdk
 pm guide tokens --depth brief
 ```

package/.agents/skills/pm-user/SKILL.md

@@ -28,7 +28,7 @@ agent can rebuild the full situation from it alone.
 Optional deep routing that never goes stale:
 
 ```bash
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide quickstart
 pm guide commands --depth brief
 ```
@@ -47,7 +47,7 @@ pm guide commands --depth brief
 ```bash
 pm context --limit 10
 pm search "<request keywords>" --limit 10
-pm list-open --limit 20 --output-include id,title,type,priority
+pm list --status open --limit 20 --brief
 # reuse if it exists; otherwise create with lineage
 pm create --create-mode progressive \
   --title "..." --description "..." --type Task --status open \

package/.agents/skills/pm-user/references/WORKFLOWS.md

@@ -7,8 +7,8 @@
 ```bash
 pm context --limit 10
 pm search "<keywords>" --limit 10
-pm list-open --limit 20
-pm list-in-progress --limit 20
+pm list --status open --limit 20
+pm list --status in_progress --limit 20
 ```
 
 2. If existing item matches, reuse and update it.

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

package/AGENTS.md

@@ -4,22 +4,22 @@ This file is the low-context entrypoint for agents working in this repository. R
 
 ## Progressive Disclosure
 
-| Need | Read |
-|------|------|
-| Agent workflow and ownership | [Agent Guide](docs/AGENT_GUIDE.md) |
-| Exact command families and examples | [Command Reference](docs/COMMANDS.md) |
-| Sandbox-safe verification | [Testing](docs/TESTING.md) |
-| Settings, output, and environment | [Configuration](docs/CONFIGURATION.md) |
-| Package or extension work | [Packages and Extensions](docs/EXTENSIONS.md), [SDK](docs/SDK.md) |
-| Release work | [Releasing](docs/RELEASING.md) |
-| Full docs map | [Documentation Index](docs/README.md) |
+| Need                                | Read                                                              |
+| ----------------------------------- | ----------------------------------------------------------------- |
+| Agent workflow and ownership        | [Agent Guide](docs/AGENT_GUIDE.md)                                |
+| Exact command families and examples | [Command Reference](docs/COMMANDS.md)                             |
+| Sandbox-safe verification           | [Testing](docs/TESTING.md)                                        |
+| Settings, output, and environment   | [Configuration](docs/CONFIGURATION.md)                            |
+| Package or extension work           | [Packages and Extensions](docs/EXTENSIONS.md), [SDK](docs/SDK.md) |
+| Release work                        | [Releasing](docs/RELEASING.md)                                    |
+| Full docs map                       | [Documentation Index](docs/README.md)                             |
 
 Use runtime contracts for exact flags because packages and settings can change the active surface:
 
 ```bash
 pm <command> --help --json
 pm contracts --command <command> --flags-only --json
-pm install guide-shell --project
+pm package install guide-shell --project
 pm guide <topic>
 ```
 
@@ -58,10 +58,11 @@ On a fresh clone or worktree, also run `pm merge install` once: the committed `.
 For real repository tracking, do not override `PM_PATH`. If a script must target a tracker explicitly, prefer `--pm-path <repo>/.agents/pm`; `--path` is only a backward-compatible tracker-root alias, not a workspace/cwd flag. For tests and dogfood runs, use sandboxed `PM_PATH` and `PM_GLOBAL_PATH`; prefer `node scripts/run-tests.mjs ...` because it sets them automatically.
 
 <!-- pm-cli:agent-guidance:start:v1 -->
+
 ## pm Workflow Quickstart
 
 ```bash
-pm context --limit 10
+pm context --limit 10 --for orient
 pm search "<request keywords>" --limit 10
 pm list --status open --limit 20
 pm list --status in_progress --limit 20
@@ -73,21 +74,22 @@ pm docs <id> --add path=<path>,scope=project,note="<why>"
 pm test <id> --add command="node scripts/run-tests.mjs test -- <target>",scope=project,timeout_seconds=240
 pm comments <id> "Evidence: <what changed and what passed>"
 pm test <id> --run --progress
-pm close <id> "<reason with evidence>" --validate-close warn
+pm close <id> "<reason with evidence>" --resolution "<what changed>" --expected "<expected outcome>" --actual "<observed outcome>" --validate-close warn
 pm release <id>
 ```
 
 Author identity is automatic; use `--author` only for an explicit override.
+
 <!-- pm-cli:agent-guidance:end -->
 
 ## Working Rules
 
-- **Orient:** run `pm context`, `pm search`, `pm list --status open`, and `pm list --status in_progress` before `pm create`. If net-new work is required, create or reuse the parent lineage first and record duplicate-check evidence in a create-time comment.
+- **Orient:** start with the measured canonical cold-start, `pm context --limit 10 --for orient`. Before `pm create`, also run request-specific `pm search`, `pm list --status open`, and `pm list --status in_progress` so duplicate and ownership checks use live state. If net-new work is required, create or reuse the parent lineage first and record duplicate-check evidence in a create-time comment.
 - **Verify before you claim:** the verification recipe for the Non-Negotiable above. A `closed` item whose `resolution`/`close_reason` describes the fix represents completed, shipped work — never describe it as outstanding. Confirm release/CI/infra status against the live system, e.g. `pm get pm-9gxi`, `npm view @unbrained/pm-cli version`, `gh release list`, `gh run list --workflow=auto-release.yml`.
 - **Implement:** keep edits scoped to the claimed item. Link changed files with `pm files`, docs with `pm docs`, and runnable verification with `pm test`.
 - **Record:** use `pm comments`, `pm notes`, and `pm learnings` for progress, rationale, and durable lessons. Prefer append-style updates over rewriting item content.
 - **Verify:** use sandbox-safe commands. For documentation-only work, run at least `pnpm build` and a focused link/content check. For broader work, run linked tests, coverage, validation, and release gates as appropriate.
-- **Close:** add evidence first, then `pm close <id> "<reason>" --validate-close warn`, then `pm release <id>`.
+- **Close:** add evidence first, then atomically include `--resolution`, `--expected`, and `--actual` on `pm close <id> "<reason>" --validate-close warn`, then `pm release <id>`. Structured evidence belongs in the immutable close event, not in a later backfill.
 - **Land closeout through review:** tracker evidence, item closure, and the generated changelog are part of the reviewed delivery. Never push post-merge closeout commits directly to `main`; if evidence depends on the merge SHA, carry it in a normal `main`-based follow-up PR so the new head retains analyzer provenance. See [Releasing](docs/RELEASING.md#reviewed-delivery-closeout).
 
 ## Test Safety

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 2026.9.1 - 2026-09-01
+
+### Added
+
+- GH-796: duplicate recurrence now reopens the canonical terminal item instead of creating a second item ([pm-83cz0o](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-83cz0o.toon))
+- Progressive MCP discovery and canonical tool results: reveal the minimum relevant catalog and deliver one unambiguous model-facing output contract ([pm-3g3f8z](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-3g3f8z.toon))
+
+### Fixed
+
+- The two-call agent cold start proposed as canonical costs more tokens than the four-call protocol it replaces, and no gate measures either ([pm-jjqyzd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-jjqyzd.toon))
+- GH-1166: root help hides the --all discovery option that reveals the full command surface ([pm-7f9zkh](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-7f9zkh.toon))
+- GH-1104: health must not certify pending lossless merge receipts as reconciled ([pm-baksix](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-baksix.toon))
+- GH-1135: item_hash_version 2 still masks writer hash divergence as corruption ([pm-2qahia](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2qahia.toon))
+
+### Other
+
+- Document the measured canonical agent cold-start across docs and generated guidance ([pm-ka6d](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-ka6d.toon))
+- Close-time completeness signal for structured resolution fields (resolution/expected/actual) — config-gated warn or require ([pm-wenq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-wenq.toon))
+
+## 2026.8.31 - 2026-08-31
+
+### Added
+
+- Workspace position read: one bounded answer to where this workspace stands in the branch-and-merge workflow and what to run next, replacing a protocol the agent must remember ([pm-bq0ii8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-bq0ii8.toon))
+
+### Fixed
+
+- Custom statuses registered without a lifecycle role are silently orphaned from every work-selection surface ([pm-0mhspz](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-0mhspz.toon))
+- GH-1158: Windows Node 24 nightly receipt fixture derives a root-relative expectation from a drive-qualified path ([pm-46hpx8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-46hpx8.toon))
+- GH-1154: linked-test sandbox guard is command-shape inconsistent and undocumented ([pm-s8cth5](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-s8cth5.toon))
+- The local preflight token-budget gate is red on a workstation and green in hosted CI for the same commit again, because the earlier remediation closed the one ambient channel that had bitten instead of closing the fixture's environment ([pm-4o7tlx](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-4o7tlx.toon))
+- The bounded legacy MCP compatibility set stops one revision short of the spec's own legacy boundary, so every current host is refused at initialize and the dual-era guarantee is unmet ([pm-edywqn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-edywqn.toon))
+
+### Security
+
+- Refresh compatible GitHub Actions and tsx tooling dependencies ([pm-k47gdd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-k47gdd.toon))
+
+### Deprecated
+
+- The project's own agent-facing documentation and skills instruct deprecated command spellings, so the alias-usage signal that decides when a spelling can be retired is manufactured by the instructions rather than observed from callers ([pm-q2n4vd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-q2n4vd.toon))
+
 ## 2026.8.30 - 2026-08-30
 
 ### Other
@@ -16,7 +57,6 @@
 - GH-1148: cached drift mismatch can falsely report tracker corruption ([pm-sxg7wl](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-sxg7wl.toon))
 - GH-1138: linked test name filters can pass after executing zero tests ([pm-ntnv4k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ntnv4k.toon))
 - GH-1136: npm 12 object-form npm pack receipts break registry package installs ([pm-xrjy8o](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xrjy8o.toon))
-- GH-1135: item_hash_version 2 still masks writer hash divergence as corruption ([pm-2qahia](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2qahia.toon))
 - The annotation key=value grammar has three divergent comma behaviours, two of which silently corrupt the evidence text before it is made immutable ([pm-hu92i3](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-hu92i3.toon))
 - GH-1150: health remediation for pending merge receipts must perform the repair ([pm-r0p3at](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-r0p3at.toon))
 - GH-1134: required collection recovery omits truthful --clear-\* intent ([pm-t7wl00](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-t7wl00.toon))
@@ -114,7 +154,6 @@
 
 ### Fixed
 
-- GH-1104: health must not certify pending lossless merge receipts as reconciled ([pm-baksix](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-baksix.toon))
 - Dynamic-read continuation cursors are born stale: pm health emits a cursor that its next invocation rejects ([pm-oahhyc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-oahhyc.toon))
 - GH-1105: contracts must declare each command projection vocabulary before invocation ([pm-q4isdq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-q4isdq.toon))
 - The outcome-milestone ladder is a sibling set rather than a layer: 1,024 terminal items reach the roadmap apex through 154 typed roots without traversing any outcome milestone ([pm-h6b73t](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-h6b73t.toon))
@@ -205,10 +244,6 @@
 
 ## 2026.8.20 - 2026-08-20
 
-### Added
-
-- GH-796: no reopen transition for terminal items, so recurrence is recorded as a duplicate instead of a reopening ([pm-83cz0o](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-83cz0o.toon))
-
 ### Fixed
 
 - GH-529: init --agent-guidance emits run-tests.mjs linked-test example that may not exist in the target repo ([pm-surv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-surv.toon))

package/README.md

@@ -99,11 +99,11 @@ pm release <item-id>
 
 ## Agent Loop
 
-Use `pm next` to get the single highest-priority ready item (and why), or `pm context` for the full snapshot, then search before creating anything:
+Use the measured one-call context intent for cold-start orientation. Use `pm next` as an alternative when you only need the single highest-priority ready item, then search all statuses before creating anything. Measurement methodology and ratcheted evidence live in the [Agent Guide](docs/AGENT_GUIDE.md#agent-quick-context).
 
 ```bash
-pm next                                          # the next actionable item + rationale, ready/blocked queues
-pm context --limit 10
+pm context --limit 10 --for orient              # canonical cold start: state, ownership, actionable work
+# Alternative: pm next                          # one actionable item + rationale, ready/blocked queues
 pm search "keywords for the requested work" --limit 10
 pm list --status open --limit 20
 pm list --status in_progress --limit 20

package/dist/cli/commands/merge.d.ts

@@ -5,4 +5,4 @@
  * primitives. The SDK owns the three-way merge semantics, the git merge
  * driver runner, and the repository merge-configuration installer.
  */
-export { MERGE_DRIVER_ARTIFACT_VALUES, mergeHistoryStreams, mergeItemDocuments, mergeJsonDocuments, runMergeDriver, runMergeInstall, runMergeReceiptReport, runMergeReconcile, type MergeDriverArtifact, type MergeDriverOptions, type MergeDriverResult, type MergeInstallOptions, type MergeInstallResult, type MergeReceiptReport, type MergeReconcileOptions, type MergeReconcileResult, } from "../../sdk/merge/index.js";
+export { MERGE_DRIVER_ARTIFACT_VALUES, mergeHistoryStreams, mergeItemDocuments, mergeJsonDocuments, runMergeDriver, runMergeInstall, runMergeReceiptEvidenceReport, runMergeReceiptReport, runMergeReconcile, type MergeDriverArtifact, type MergeDriverOptions, type MergeDriverResult, type MergeInstallOptions, type MergeInstallResult, type MergeReceiptEvidenceReport, type MergeReceiptReport, type MergeReconcileOptions, type MergeReconcileResult, } from "../../sdk/merge/index.js";

package/dist/cli/commands/merge.js

@@ -6,7 +6,7 @@
  * driver runner, and the repository merge-configuration installer.
  */
 
-!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]="8bc9436f-c101-583d-ae42-02d51b5eb027")}catch(e){}}();
-export { MERGE_DRIVER_ARTIFACT_VALUES, mergeHistoryStreams, mergeItemDocuments, mergeJsonDocuments, runMergeDriver, runMergeInstall, runMergeReceiptReport, runMergeReconcile, } from "../../sdk/merge/index.js";
+!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]="0ac2cdcd-45da-5420-ba98-a49ecf54f75c")}catch(e){}}();
+export { MERGE_DRIVER_ARTIFACT_VALUES, mergeHistoryStreams, mergeItemDocuments, mergeJsonDocuments, runMergeDriver, runMergeInstall, runMergeReceiptEvidenceReport, runMergeReceiptReport, runMergeReconcile, } from "../../sdk/merge/index.js";
 //# sourceMappingURL=merge.js.map
-//# debugId=8bc9436f-c101-583d-ae42-02d51b5eb027
+//# debugId=0ac2cdcd-45da-5420-ba98-a49ecf54f75c

package/dist/cli/register-list-query.js

@@ -1,11 +1,11 @@
 
-!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]="102d4534-fb3a-57a3-91d1-db344492b812")}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]="1c6a0524-a8eb-5a20-b395-b488249c4e83")}catch(e){}}();
 import { EXIT_CODE, PmCliError, readSettings, renderRowsAsCsv, renderRowsAsTable, resolvePmRoot, } from "../sdk/runtime-primitives.js";
 import { renderPmCommandAliasMigrationHint, resolvePmCommandAlias, } from "../sdk/cli-contracts.js";
 import { EVAL_QUERY_SET_SCHEMA_ID } from "../sdk/eval.js";
 import { applyContextIntentProjection } from "../sdk/context-intent-contracts.js";
 import { renderPmClosedDomainHelp } from "../sdk/agent/closed-domain-contracts.js";
-import { serializeNdjsonRows, serializeNdjsonStream, } from "../sdk/output.js";
+import { serializeNdjsonRows, serializeNdjsonStream } from "../sdk/output.js";
 import { listMutationEvents, subscribeMutationEventBatches, subscribeMutationEvents, } from "../sdk/mutation-events.js";
 import { runActivity } from "./commands/activity.js";
 import { runAggregate } from "./commands/aggregate.js";
@@ -169,6 +169,22 @@ async function runRegisteredListCommand(params) {
     }
     const intentOptions = applyContextIntentProjection("list", params.options);
     const listOptions = normalizeListOptions(intentOptions);
+    const selection = resolveRegisteredListSelection(params, listOptions);
+    const { effectiveName, effectiveStatus, effectiveDependencyBlocked, effectiveExcludeTerminal, } = selection;
+    applyDefaultListProjection(listOptions, effectiveName);
+    Object.assign(listOptions, { projectionCommand: effectiveName });
+    if (effectiveExcludeTerminal)
+        listOptions.excludeTerminal = true;
+    listOptions.dependencyBlocked = effectiveDependencyBlocked;
+    const output = resolveRegisteredListOutputContext(intentOptions, globalOptions);
+    const result = await runList(effectiveDependencyBlocked ? undefined : effectiveStatus, listOptions, globalOptions);
+    renderRegisteredListResult("list", result, output);
+    if (globalOptions.profile) {
+        printError(`profile:command=list took_ms=${Date.now() - startedAt}`);
+    }
+}
+/** Resolve aliases and lifecycle buckets into one SDK list selection. */
+function resolveRegisteredListSelection(params, listOptions) {
     let effectiveName = params.name;
     let effectiveStatus = params.status;
     let effectiveDependencyBlocked = params.dependencyBlocked === true;
@@ -183,7 +199,8 @@ async function runRegisteredListCommand(params) {
             effectiveExcludeTerminal = false;
             listOptions.status = undefined;
         }
-        else if (requestedStatus !== undefined && requestedVariant !== undefined) {
+        else if (requestedStatus !== undefined &&
+            requestedVariant !== undefined) {
             effectiveName = requestedVariant.name;
             effectiveStatus = requestedStatus;
             effectiveDependencyBlocked = requestedVariant.dependencyBlocked;
@@ -191,17 +208,17 @@ async function runRegisteredListCommand(params) {
             listOptions.status = undefined;
         }
     }
-    applyDefaultListProjection(listOptions, effectiveName);
-    Object.assign(listOptions, { projectionCommand: effectiveName });
-    if (effectiveExcludeTerminal)
-        listOptions.excludeTerminal = true;
-    listOptions.dependencyBlocked = effectiveDependencyBlocked;
-    const output = resolveRegisteredListOutputContext(intentOptions, globalOptions);
-    const result = await runList(effectiveDependencyBlocked ? undefined : effectiveStatus, listOptions, globalOptions);
-    renderRegisteredListResult("list", result, output);
-    if (globalOptions.profile) {
-        printError(`profile:command=list took_ms=${Date.now() - startedAt}`);
+    if (effectiveName === "list-open" || effectiveName === "list-in-progress") {
+        listOptions.lifecycleBucket =
+            effectiveName === "list-open" ? "open" : "in_progress";
+        effectiveStatus = undefined;
     }
+    return {
+        effectiveName,
+        effectiveStatus,
+        effectiveDependencyBlocked,
+        effectiveExcludeTerminal,
+    };
 }
 function registerListCommand(program, descriptor) {
     const { name, description, status, excludeTerminal, allowStatusFilter, dependencyBlocked, aliasContract, } = descriptor;
@@ -465,9 +482,7 @@ function buildMutationEventOptions(options, pmRoot) {
         limit: typeof options.limit === "string" ? Number(options.limit) : undefined,
         full: options.full === true,
         ...(options.provenance === true ? { provenance: true } : {}),
-        ...(options.provenanceSummary === true
-            ? { provenanceSummary: true }
-            : {}),
+        ...(options.provenanceSummary === true ? { provenanceSummary: true } : {}),
         ...(harness === undefined ? {} : { harness }),
         ...(agentInstance === undefined ? {} : { agentInstance }),
         ...(provenanceFilter === undefined ? {} : { provenanceFilter }),
@@ -924,4 +939,4 @@ export const _testOnlyRegisterListQuery = {
     parseListFormat,
 };
 //# sourceMappingURL=register-list-query.js.map
-//# debugId=102d4534-fb3a-57a3-91d1-db344492b812
+//# debugId=1c6a0524-a8eb-5a20-b395-b488249c4e83

package/dist/cli/register-mutation.js

@@ -1,9 +1,9 @@
 
-!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]="28a59fb9-80bc-5e2a-b926-1bb227c103c6")}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]="4e3b2528-5128-5bfd-8234-1e60fe90d9e2")}catch(e){}}();
 import { resolveBodyFileContent, resolveCliBulkIdsInput, EXIT_CODE, splitCommaList, PmCliError, createUnknownSubcommandError, } from "../sdk/runtime-primitives.js";
 import { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, MERGE_SUBCOMMAND_VALUES, PLAN_CREATE_METADATA_PARAMETER_KEYS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, } from "../sdk/cli-contracts.js";
 import { BUILTIN_ITEM_TYPE_VALUES, PLAN_STEP_LINK_KIND_VALUES, } from "../types/index.js";
-import { MERGE_DRIVER_ARTIFACT_VALUES, runMergeDriver, runMergeInstall, runMergeReconcile, runMergeReceiptReport, } from "./commands/merge.js";
+import { MERGE_DRIVER_ARTIFACT_VALUES, runMergeDriver, runMergeInstall, runMergeReconcile, runMergeReceiptEvidenceReport, } from "./commands/merge.js";
 import { runAppend } from "./commands/append.js";
 import { runClose } from "./commands/close.js";
 import { runCloseMany } from "./commands/close-many.js";
@@ -847,9 +847,12 @@ async function runMergeAction(subcommand, artifact, base, ours, theirs, options,
             if (artifact !== undefined) {
                 throw new PmCliError("merge report takes no positional arguments.", EXIT_CODE.USAGE);
             }
-            printResult(await runMergeReceiptReport({
+            const result = await runMergeReceiptEvidenceReport({
                 includeReconciled: options.includeReconciled === true,
-            }), globalOptions);
+            });
+            printResult(result, globalOptions);
+            if (!result.ok)
+                process.exitCode = EXIT_CODE.GENERIC_FAILURE;
             break;
         }
         case "driver":
@@ -1886,4 +1889,4 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .action(runDepsAction);
 }
 //# sourceMappingURL=register-mutation.js.map
-//# debugId=28a59fb9-80bc-5e2a-b926-1bb227c103c6
+//# debugId=4e3b2528-5128-5bfd-8234-1e60fe90d9e2

package/dist/cli/register-operations.d.ts

@@ -53,6 +53,7 @@ declare function buildRunTestOptions(options: Record<string, unknown>, values: {
 export declare const _testOnlyRegisterOperations: {
     buildRunTestOptions: typeof buildRunTestOptions;
     buildRunTestAllOptions: typeof buildRunTestAllOptions;
+    runWorkspacePositionAction: typeof runWorkspacePositionAction;
     validateBackgroundTestOptions: typeof validateBackgroundTestOptions;
 };
 declare function buildRunTestAllOptions(options: Record<string, unknown>): {
@@ -76,6 +77,7 @@ declare function buildRunTestAllOptions(options: Record<string, unknown>): {
     checkContext: boolean;
     autoPmContext: boolean;
 };
+declare function runWorkspacePositionAction(_options: Record<string, unknown>, command: Command): Promise<void>;
 /** Enforces the claim target XOR selection contract before dispatch. */
 export declare function requireClaimTarget(id: string | undefined, next: boolean): void;
 /** Implements register operation commands for the public runtime surface of this module. */

package/dist/cli/register-operations.js

@@ -1,9 +1,10 @@
 
-!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]="7377fa65-aaa9-5d28-b3fb-a8becaf0d484")}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]="ecf75f5d-6345-5487-b7e4-1bd8f97326fd")}catch(e){}}();
 import { resolveRuntimeStatusRegistry, setActiveCommandResult, EXIT_CODE, PmCliError, createUnknownSubcommandError, resolveAuthor, resolvePmRoot, readSettings, } from "../sdk/runtime-primitives.js";
 import { resolveStartTaskInProgressStatus } from "../sdk/start-task-status.js";
 import { parseStatsAnalyticsJson } from "./stats-analytics-json.js";
 import { createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshotWithRecovery, WORKSPACE_SNAPSHOT_ACTIONS, } from "../sdk/workspace-snapshot.js";
+import { readWorkspacePosition } from "../sdk/governance/workspace-position.js";
 import { runClaim, runClaimNext, runRelease } from "./commands/claim.js";
 import { runClose } from "./commands/close.js";
 import { runContracts } from "./commands/contracts.js";
@@ -141,6 +142,7 @@ function buildRunTestOptions(options, values) {
 export const _testOnlyRegisterOperations = {
     buildRunTestOptions,
     buildRunTestAllOptions,
+    runWorkspacePositionAction,
     validateBackgroundTestOptions,
 };
 async function runForegroundLinkedTests(id, options, globalOptions, values) {
@@ -308,7 +310,7 @@ async function runHealthAction(options, command) {
     const strictExit = Boolean(options.strictExit) || Boolean(options.failOnWarn);
     const result = await runHealth(globalOptions, {
         strictDirectories: Boolean(options.strictDirectories),
-        requireMergeDrivers: Boolean(options.requireMergeDrivers),
+        requireMergeDrivers: Boolean(options.requireMergeDrivers) || strictExit,
         checkOnly: Boolean(options.checkOnly),
         checkTelemetry: Boolean(options.checkTelemetry),
         noRefresh: Boolean(options.noRefresh),
@@ -446,6 +448,10 @@ async function runWorkspaceSnapshotAction(action, target, options, command) {
     }
     printResult(await deleteWorkspaceSnapshot(pmRoot, target), globalOptions);
 }
+async function runWorkspacePositionAction(_options, command) {
+    const globalOptions = getGlobalOptions(command);
+    printResult(await readWorkspacePosition(globalOptions), globalOptions);
+}
 async function runContractsAction(options, command) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
@@ -595,8 +601,8 @@ export function registerOperationCommands(program) {
     const testCommand = program
         .command("test")
         .argument("<id>", "Item id")
-        .option("--add <value>", "Add linked test entry (CSV/markdown pairs or - for stdin)", collect)
-        .option("--add-json <value>", "Add linked test entry from JSON object/array (or - for stdin)", collect)
+        .option("--add <value>", "Add verified isolated test (CSV/markdown or stdin)", collect)
+        .option("--add-json <value>", "Add verified isolated test (JSON object/array or stdin)", collect)
         .option("--remove <value>", "Remove linked test entry by exact command/path (command=<value> and path=<value> preserve commas and equals signs; or - for stdin)", collect)
         .option("--remove-index <n>", "Remove the 1-based linked-test index from --list order (repeatable)", collect)
         .option("--list", "List linked tests without mutating")
@@ -712,13 +718,18 @@ export function registerOperationCommands(program) {
         .option("--scope <value>", "Limit cleanup to one or more scopes (comma-separated or repeatable): index, embeddings, runtime, locks, checkpoints, transactions", collect)
         .description("Delete optional cache artifacts by default (including expired lock debris) and show a summary.")
         .action(runGcAction);
-    program
+    const workspaceCommand = program
         .command("workspace")
-        .description("Manage portable workspace-level SDK primitives.")
+        .description("Inspect workspace state and snapshots.");
+    workspaceCommand
+        .command("position")
+        .description("Show merge and history readiness.")
+        .action(runWorkspacePositionAction);
+    workspaceCommand
         .command("snapshot")
-        .argument("<action>", "Snapshot action: create, list, inspect, restore, delete")
+        .argument("<action>", "Action: create, list, inspect, restore, delete")
         .argument("[target]", "Optional name for create; name or fingerprint otherwise")
-        .description("Create, inspect, list, restore, or delete content-addressed tracker snapshots.")
+        .description("Manage content-addressed tracker snapshots.")
         .option("--dry-run", "Preview restore file, item, stream, and history-entry impact without mutating state")
         .option("--force", "Explicitly confirm a whole-workspace snapshot restore")
         .option("--author <value>", "Actor recorded on the restore audit event")
@@ -898,4 +909,4 @@ function registerSchedulingShortcutCommands(program) {
     });
 }
 //# sourceMappingURL=register-operations.js.map
-//# debugId=7377fa65-aaa9-5d28-b3fb-a8becaf0d484
+//# debugId=ecf75f5d-6345-5487-b7e4-1bd8f97326fd