@unbrained/pm-cli 2026.8.14 → 2026.8.16

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

package/CHANGELOG.md

@@ -1,9 +1,52 @@
 # Changelog
 
+## 2026.8.16 - 2026-08-16
+
+### Fixed
+
+- Workspace history integrity refusals escape typed CLI recovery and become high Sentry faults ([pm-2zkvxm](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2zkvxm.toon))
+- GH-1019/GH-1020/GH-1021: Node 24 nightly platform regressions after PR \#1016 ([pm-zno2iu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-zno2iu.toon))
+- GH-814/GH-821/GH-1034: SDK metadata reads must distinguish missing, invalid, and unreadable tracker roots from empty ([pm-23xkss](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-23xkss.toon))
+- GH-1028: history-author-acknowledge bulk mutation lacks dry-run and misreports empty selection ([pm-mcxk8v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mcxk8v.toon))
+- GH-1030: contracts --json --full is wholly omitted by the default output budget ([pm-2qvq7a](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2qvq7a.toon))
+- Auto Release blocker closure ignores successful recovery dispatch and reruns the stale tag-push workflow ([pm-db8onn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-db8onn.toon))
+- A commit pushed directly to the default branch can never be released: both analyzer-evidence fallbacks presuppose a pull request, and nothing declares that precondition ([pm-u1baah](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-u1baah.toon))
+
+### Other
+
+- PR \#1035 final review convergence: POSIX enumeration wording and plan-level replication ratchet ([pm-k9l7e1](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-k9l7e1.toon))
+- PR \#1035 exact-head review follow-up: sandbox-safe proof, completion uniqueness, replacement equivalence, and test isolation ([pm-jv3y4q](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-jv3y4q.toon))
+- Retire the bespoke gate scripts onto the assurance primitives, with a recorded per-script disposition so 6,500 lines of external enforcement either moves into the product or says why it cannot ([pm-4ok4ex](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-4ok4ex.toon))
+
+## 2026.8.15 - 2026-08-15
+
+### Fixed
+
+- Provide an audited repair and severity-migration contract for legacy invalid provenance ([pm-76fkpp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-76fkpp.toon))
+- Detect extension-host pm-cli version skew before a workspace reports healthy ([pm-643e0k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-643e0k.toon))
+- Restore strict unknown-key parity for docs linked-artifact additions ([pm-22rzjp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-22rzjp.toon))
+- Surface replication gate scopes trigger activation to relevant diff content ([pm-mrhwow](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mrhwow.toon))
+- Make every failing health verdict self-indexing and attach gate severity to findings ([pm-larv4r](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-larv4r.toon))
+- GH-1004: history-repair remains writer-version-specific across 2026.8.7 and 2026.8.13 ([pm-igdvfq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-igdvfq.toon))
+- Assurance gates preserve zero-valued counts and report actionable source failures ([pm-xmmafu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xmmafu.toon))
+- A budget-truncated read is resumable on one surface and terminal on five, and the only recovery the envelope names is to abandon the budget that truncated it ([pm-8nev0o](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-8nev0o.toon))
+- Ranking explanation is sized by the workspace rather than by the answer: explaining two returned rows emits one entry per active item and ignores the token budget entirely ([pm-okgxwa](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-okgxwa.toon))
+- The unknown-option refusal asserts the option belongs on another command path without checking, so a spelling that exists nowhere sends the reader on an unbounded search ([pm-in23qu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-in23qu.toon))
+- The gate verdict withholds its evidence as a declaration-order prefix, so the assertion that produced a blocking verdict can be the row the default read drops ([pm-e5gl05](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-e5gl05.toon))
+- GH-1008: assurance measurements accept unknown source kinds and contracts hide the valid vocabulary ([pm-atnfh4](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-atnfh4.toon))
+- GH-1007: assurance gate declarations omit trigger and escape the typed refusal contract ([pm-88mo8m](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-88mo8m.toon))
+- A CI-wired quality gate is red on a clean checkout of main and green in hosted CI for the same commit, because its measured output carries a telemetry warning whose presence depends on whether the local flush reached the network ([pm-t7wn04](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-t7wn04.toon))
+- GH-1011: Windows Node 24 nightly cache fixture loses the authoritative linked-test collection ([pm-k47yqn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-k47yqn.toon))
+
+### Other
+
+- The agent token-surface harness from pm-a22j is wired into nothing, so output-size regressions like the 33k-token health check land undetected ([pm-dpqa3h](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-dpqa3h.toon))
+
 ## 2026.8.14 - 2026-08-14
 
 ### Fixed
 
+- Unsupported assurance triggers bypass the typed evaluation-refusal boundary and surface as high-severity Sentry faults ([pm-9yhl2v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9yhl2v.toon))
 - A single transient per-test timeout fails the whole pipeline: 1,942 tests share one uniform 30s budget, no retry is configured, and the only diagnosis path is decoding a blob artifact ([pm-rizqb6](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-rizqb6.toon))
 - The degradation ladder only sees top-level arrays, so the governance reads whose bulk is nested skip every intermediate rung and return nothing at all ([pm-kyjdne](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-kyjdne.toon))
 - A budget-truncated read reports that rows are missing without a cursor, a recovery, or any sign that it overrode the caller's explicit request for all of them ([pm-jt8aa2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-jt8aa2.toon))
@@ -12,7 +55,6 @@
 - Exact command-path summaries expose intent, flags, and format-aware output ceilings ([pm-pmrae8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-pmrae8.toon))
 - Default output ceilings bind representative read surfaces with depth-heavy negative controls ([pm-s2h0mq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-s2h0mq.toon))
 - Two of the three ci-triggered assurance gates never ran on a pull request, so the append-only history assertion that carries the immutability guarantee was evaluated only after merge ([pm-fhifkc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-fhifkc.toon))
-- Unsupported assurance triggers bypass the typed evaluation-refusal boundary and surface as high-severity Sentry faults ([pm-9yhl2v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9yhl2v.toon))
 - The ordering-cycle finding names the items in the cycle and not the contradiction that creates it, so its remediation hint cannot be executed without re-deriving the cause by hand ([pm-xvt7ps](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xvt7ps.toon))
 - The edge-count floor is denominated over a population that includes the edges the graph itself calls redundant, so repairing 73 witnessed implied ordering rows and silently relaxing the guard are the same privileged act ([pm-9gzr4r](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9gzr4r.toon))
 - The graph node floor counts materialized placeholders, so its negative control declares the fully repaired corpus a failure and the gate passes only while a dangling reference exists ([pm-mfvsng](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mfvsng.toon))
@@ -395,7 +437,6 @@
 - GH-824: core-field recovery must name dedicated flags instead of extension activation ([pm-2jtbl8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2jtbl8.toon))
 - CodeFactor fixed-only success payload blocks exact-head release gate ([pm-xcrlkl](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xcrlkl.toon))
 - Both declared context intents are unreachable because the intent applier assigns field-group names into the section value domain, and the two validators give contradictory advice ([pm-ai45y9](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ai45y9.toon))
-- GH-814: SDK metadata reads must distinguish missing and invalid tracker roots from an empty tracker ([pm-23xkss](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-23xkss.toon))
 - The runtime contract enumeration is not closed over the surface it can resolve: 14 rendered commands, including the list-open that AGENTS.md mandates, are contract-backed by name yet absent from every enumeration ([pm-6j7r1a](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-6j7r1a.toon))
 - GH-817: machine-readable flag contracts need semantic invocation metadata and stdin capability ([pm-11phn1](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-11phn1.toon))
 
@@ -513,7 +554,6 @@
 - Evaluate Sentry 10.68.0 compatibility and retain 10.67.0 ([pm-r31390](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-r31390.toon))
 - Derive ALL MCP tool inputSchemas from \*\_FLAG_CONTRACTS — eliminate hand-declared parallel schema tables (extend the pm_copy pattern) ([pm-xwah](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-xwah.toon))
 - Generate shell completions, MCP tool registrations, and command reference docs from the contracts table (single source of truth) ([pm-mu8m](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-mu8m.toon))
-- The agent token-surface harness from pm-a22j is wired into nothing, so output-size regressions like the 33k-token health check land undetected ([pm-dpqa3h](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-dpqa3h.toon))
 - Ecosystem review and deep-graph enrichment pass 2026-07-27: all-status census, CLI simplification + token-efficiency + long-term brainstorm, dedupe-checked gap filing ([pm-89qv6b](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-89qv6b.toon))
 - Evaluate @toon-format/toon 4 compatibility and item-format migration ([pm-5cgm2z](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-5cgm2z.toon))
 - ADR amendment: extensible durable agent provenance dimensions and privacy boundaries ([pm-oskdmu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-oskdmu.toon))
@@ -1257,6 +1297,7 @@
 
 ### Other
 
+- PR \#406 review follow-up: clear partial MCP extension registries before fallback execution ([pm-dyzy](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-dyzy.toon))
 - 2026-06-25 PM ecosystem taxonomy and context backlog normalization ([pm-57vh](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/plans/pm-57vh.toon))
 - Normalize stale audit containers and intentional-open resolved items ([pm-psc0](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-psc0.toon))
 - Extend pm package init --declarative to the full capability matrix (hooks/search/importers/schema/renderers/parser/preflight/services) ([pm-lfdv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-lfdv.toon))
@@ -1282,7 +1323,6 @@
 - Action-scoped MCP parameter descriptions: split shared name/target description per action (schema vs profile) ([pm-fq80](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-fq80.toon))
 - ADR: offline BM25 lexical provider + relevance eval harness for search quality ([pm-f2al](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-f2al.toon))
 - ADR: explicit pm_format_version front-matter field for storage schema evolution ([pm-eeai](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-eeai.toon))
-- PR \#406 review follow-up: clear partial MCP extension registries before fallback execution ([pm-dyzy](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-dyzy.toon))
 - Expose project profile application through MCP contracts and drift gates ([pm-bhmk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-bhmk.toon))
 - ADR: dependency-aware actionability for pm next — ready = active leaf with no open blocked_by; reuse compareCriticalItems + shared blocked_by resolver ([pm-9x6k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-9x6k.toon))
 - registerProfile core registration surface: ExtensionApi + registry + loader gate + capability-usage + policy surface ([pm-6oox](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-6oox.toon))
@@ -1411,6 +1451,7 @@
 
 ### Fixed
 
+- pm-changelog over-escapes markdown in entry titles (parens + intra-word underscores) ([pm-3299](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-3299.toon))
 - GH-293..296 CLI parser and search regression bundle ([pm-yy45](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-yy45.toon))
 - appendLineAtomic is not truly atomic: concurrent appends to history JSONL can interleave ([pm-xy9n](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-xy9n.toon))
 - Project-scope extension install writes ~69MB node_modules per workspace (peer pm-cli + transitive Sentry/OTel) ([pm-oxq2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-oxq2.toon))
@@ -1420,7 +1461,6 @@
 - Accept --status all for duplicate-safe search and list filters ([pm-i02t](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-i02t.toon))
 - Fix nightly cross-platform reliability: macOS realpath in extension-command test and Windows .cmd spawn EINVAL ([pm-gf6f](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-gf6f.toon))
 - pm health 2.3-3.1s in dev repo (~2x the 1.3s baseline): drift-scan cache hit still reads + content-hashes every history stream ([pm-c90s](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-c90s.toon))
-- pm-changelog over-escapes markdown in entry titles (parens + intra-word underscores) ([pm-3299](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-3299.toon))
 
 ### Removed
 
@@ -1693,11 +1733,11 @@
 
 ### Other
 
+- Upgrade pm-changelog to 2026.6.9 and validate changelog fidelity ([pm-kx7v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-kx7v.toon))
 - Document pm-linked-test-adapters package in EXTENSIONS.md and TESTING.md ([pm-yj8n](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-yj8n.toon))
 - Close stale GH issues, clarify dedupe-audit docs, and bump @sentry/node ([pm-utd6](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-utd6.toon))
 - Run verification matrix and temp-dir smoke for active cycle ([pm-rav7](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-rav7.toon))
 - SDK author-ergonomics batch: extension-manifest JSON Schema, getWorkspaceContracts memoization, FlagDefinition type/value_type unification ([pm-l0jd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-l0jd.toon))
-- Upgrade pm-changelog to 2026.6.9 and validate changelog fidelity ([pm-kx7v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-kx7v.toon))
 
 ## 2026.6.9 - 2026-06-09
 
@@ -1720,9 +1760,9 @@
 
 ### Added
 
+- Add schema show-status status inspection ([pm-qpus](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-qpus.toon))
 - MCP pm_health defaults to the compact summary projection for token-efficient agent health checks ([pm-yjub](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-yjub.toon))
 - list/search: trim default filters/projection/sorting/now trailer in compact/agent mode ([pm-vhx6](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-vhx6.toon))
-- Add schema show-status status inspection ([pm-qpus](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-qpus.toon))
 
 ### Changed
 
@@ -1982,10 +2022,10 @@
 
 ### Other
 
+- 2026-05-30 package SDK dogfood audit and startup telemetry performance pass ([pm-qmx3](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-qmx3.toon))
 - Make MCP status enum + shell completion runtime-resolved from schema (not hardcoded) ([pm-jtdc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-jtdc.toon))
 - Calendar view/format did-you-mean + dependency and type-safety cleanup ([pm-5oxq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-5oxq.toon))
 - Defer eager per-command startup work: completion flag-strings, MCP tool schema build, telemetry flush spawn ([pm-3mal](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-3mal.toon))
-- 2026-05-30 package SDK dogfood audit and startup telemetry performance pass ([pm-qmx3](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-qmx3.toon))
 
 ## 2026.5.30 - 2026-05-30
 
@@ -2065,6 +2105,8 @@
 
 ### Other
 
+- Generate full historical CHANGELOG.md through pm-changelog ([pm-afl9](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-afl9.toon))
+- Verify and repair pm-changelog-generated main CHANGELOG release alignment ([pm-5baq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-5baq.toon))
 - Deduplicate beads/todos index.ts package-runtime loader (install-safe mechanism needed) ([pm-wwa7](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-wwa7.toon))
 - Deduplicate Beads and Todos package adapter runtimes ([pm-ybfj](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-ybfj.toon))
 - Deduplicate bundled package runtime option parsing helpers ([pm-y5u0](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-y5u0.toon))
@@ -2083,11 +2125,9 @@
 - Single-source Codex plugin docs tool surface ([pm-d97r](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-d97r.toon))
 - Single-source extension governance policy defaults ([pm-axd1](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-axd1.toon))
 - Unify plugin/MCP naming: pm-cli-claude→pm-claude, pm-cli-codex→pm-codex, pm-cli-native MCP→pm-mcp, packages @unbrained/pm-package-X→@unbrained/pm-X ([pm-ash0](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-ash0.toon))
-- Generate full historical CHANGELOG.md through pm-changelog ([pm-afl9](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-afl9.toon))
 - Calendar + SDK + vector-search + docs review (2026-05-27) ([pm-a0w4](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-a0w4.toon))
 - Agent-UX combined PR: compact mutation output (pm-ch59) + smarter unknown-flag recovery (pm-8nyc) ([pm-70mi](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/plans/pm-70mi.toon))
 - Dogfood 2026-05-20 low-severity CLI polish backlog (config UX, init verbosity, help alias bloat, default-safety, doc/validator drift) ([pm-5k2w](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-5k2w.toon))
-- Verify and repair pm-changelog-generated main CHANGELOG release alignment ([pm-5baq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-5baq.toon))
 - Single-source guide-shell routing snippets across docs ([pm-48vd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-48vd.toon))
 - Single-source Plan workflow examples across plugin docs ([pm-3y56](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-3y56.toon))
 - Keep large modules maintainable via barrel re-export splits + explicit uncovered allowlist ([pm-3cbk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-3cbk.toon))
@@ -2125,6 +2165,7 @@
 
 ### Other
 
+- Install and validate pm-changelog package ([pm-7811](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-7811.toon))
 - history-repair command + legacy drift cleanup + replay dedup ([pm-c3dx](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/plans/pm-c3dx.toon))
 - Deduplicate templates package runtime and legacy command implementation ([pm-ypqp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-ypqp.toon))
 - Deduplicate mutation author fallback resolution across commands ([pm-xh0y](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-xh0y.toon))
@@ -2142,7 +2183,6 @@
 - Deduplicate comments, notes, and learnings command stacks ([pm-9y8q](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-9y8q.toon))
 - Deduplicate front-matter key-order contract literals in tests ([pm-8fx3](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-8fx3.toon))
 - Extract shared temporary-directory lifecycle helpers for tests ([pm-7tug](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-7tug.toon))
-- Install and validate pm-changelog package ([pm-7811](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-7811.toon))
 - Extract shared direct CLI spawn helper for integration tests ([pm-401l](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-401l.toon))
 
 ## 2026.5.23 - 2026-05-23

package/dist/cli/commander-usage.js

@@ -1,5 +1,5 @@
 
-!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]="05cf369c-7529-57ab-984a-f5505cc9c0c9")}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]="48877bbb-17bf-5a78-91fa-19a2f2f4c2be")}catch(e){}}();
 import { pathExists, resolveItemTypeRegistry, EXIT_CODE, getSettingsPath, resolvePmRoot, readSettings, getActiveExtensionRegistrations, locateItem, runActiveServiceOverride, levenshteinDistanceWithinLimit, } from "../sdk/runtime-primitives.js";
 import { BUILTIN_ITEM_TYPE_VALUES } from "../types/index.js";
 import { PM_CORE_COMMAND_NAMES, resolveSubcommandFlagContractsForCommand, } from "../sdk/cli-contracts.js";
@@ -587,10 +587,20 @@ function resolveUnknownOptionSuggestions(message, commandName) {
             ...suggestNearestLongFlags(match[1], collectKnownLongFlags(commandName)),
         ])
         : undefined;
+    const otherCommands = match
+        ? findOtherCommandsForFlag(match[1], commandName)
+        : [];
+    const declaredOnPath = match !== null &&
+        collectKnownLongFlags(commandName).includes(normalizeLongFlag(match[1]));
     return {
         match,
         suggestions,
-        otherCommands: match ? findOtherCommandsForFlag(match[1], commandName) : [],
+        otherCommands,
+        scope: declaredOnPath
+            ? "declared_on_path"
+            : otherCommands.length > 0
+                ? "declared_elsewhere"
+                : "declared_nowhere",
     };
 }
 function resolveSuggestedRetryForUnknownOption(invocationArgv, unknownOptionMatch, unknownOptionSuggestions) {
@@ -681,6 +691,7 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
             ? unknownOption.otherCommands.length
             : undefined,
         unknownOptionOtherCommandsTruncated: unknownOption.otherCommands.length > 12 || undefined,
+        unknownOptionScope: unknownOption.scope,
         suggestedRetryCommand,
         verifiedCollectionItemId: workspaceUsage.verifiedCollectionItemId,
         ...splitSchemaSubcommand,
@@ -691,7 +702,7 @@ export async function resolveCommanderUsageContext(error, rootProgram, extension
 /** Implements format commander usage message for the public runtime surface of this module. */
 export async function formatCommanderUsageMessage(error, rootProgram, extensionDescriptors, guidanceOverrides = {}) {
     const usageContext = await resolveCommanderUsageContext(error, rootProgram, extensionDescriptors, guidanceOverrides);
-    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps, attemptedCommand, normalizedInvocationArgs, providedOptionFlags, unknownOptionSuggestions, unknownOptionOtherCommands, unknownOptionOtherCommandsTotal, unknownOptionOtherCommandsTruncated, unknownSubcommandPath, unknownSubcommandToken, unknownSubcommandAllowedValues, suggestedRetryCommand, verifiedCollectionItemId, failedExtensions, } = usageContext;
+    const { message, commandName, allowedTypes, unknownCommandExamples, unknownCommandNextSteps, attemptedCommand, normalizedInvocationArgs, providedOptionFlags, unknownOptionSuggestions, unknownOptionOtherCommands, unknownOptionOtherCommandsTotal, unknownOptionOtherCommandsTruncated, unknownOptionScope, unknownSubcommandPath, unknownSubcommandToken, unknownSubcommandAllowedValues, suggestedRetryCommand, verifiedCollectionItemId, failedExtensions, } = usageContext;
     const formatted = formatCommanderErrorForDisplay(message, commandName, allowedTypes, {
         unknownCommandExamples,
         unknownCommandNextSteps,
@@ -702,6 +713,7 @@ export async function formatCommanderUsageMessage(error, rootProgram, extensionD
         unknownOptionOtherCommands,
         unknownOptionOtherCommandsTotal,
         unknownOptionOtherCommandsTruncated,
+        unknownOptionScope,
         unknownSubcommandPath,
         unknownSubcommandToken,
         unknownSubcommandAllowedValues,
@@ -732,6 +744,7 @@ export async function formatCommanderUsageJson(error, rootProgram, extensionDesc
         unknownOptionOtherCommands: usageContext.unknownOptionOtherCommands,
         unknownOptionOtherCommandsTotal: usageContext.unknownOptionOtherCommandsTotal,
         unknownOptionOtherCommandsTruncated: usageContext.unknownOptionOtherCommandsTruncated,
+        unknownOptionScope: usageContext.unknownOptionScope,
         unknownSubcommandPath: usageContext.unknownSubcommandPath,
         unknownSubcommandToken: usageContext.unknownSubcommandToken,
         unknownSubcommandAllowedValues: usageContext.unknownSubcommandAllowedValues,
@@ -750,4 +763,4 @@ export const _testOnly = {
     suggestNearestLongFlags,
 };
 //# sourceMappingURL=commander-usage.js.map
-//# debugId=05cf369c-7529-57ab-984a-f5505cc9c0c9
+//# debugId=48877bbb-17bf-5a78-91fa-19a2f2f4c2be

package/dist/cli/error-guidance.d.ts

@@ -13,6 +13,7 @@ interface GuidanceMessage {
     why?: string;
     examples?: string[];
     nextSteps?: string[];
+    verificationErrors?: string[];
     recovery?: PmCliErrorRecoveryPayload;
 }
 /** Documents the json error envelope payload exchanged by command, SDK, and package integrations. */
@@ -35,6 +36,8 @@ export interface JsonErrorEnvelope {
     examples?: string[];
     /** Value that configures or reports next steps for this contract. */
     next_steps?: string[];
+    /** Exact integrity verifier findings that caused the operation to refuse. */
+    verification_errors?: string[];
     /** Value that configures or reports recovery for this contract. */
     recovery?: PmCliErrorRecoveryPayload;
 }
@@ -58,6 +61,8 @@ export interface ErrorClassification {
     examples?: string[];
     /** Value that configures or reports next steps for this contract. */
     next_steps?: string[];
+    /** Exact integrity verifier findings that caused the operation to refuse. */
+    verification_errors?: string[];
     /** Value that configures or reports recovery for this contract. */
     recovery?: PmCliErrorRecoveryPayload;
 }
@@ -81,6 +86,8 @@ export interface CommanderGuidanceContext {
     unknownOptionOtherCommandsTotal?: number;
     /** Whether the structured command candidates reached their own ceiling. */
     unknownOptionOtherCommandsTruncated?: boolean;
+    /** Declared lexicon membership of the rejected option spelling. */
+    unknownOptionScope?: PmCliErrorRecoveryPayload["option_scope"];
     /** Command family whose positional subcommand was split into invalid tokens. */
     unknownSubcommandPath?: string;
     /** Rejected positional subcommand token or token sequence. */

package/dist/cli/error-guidance.js

@@ -1,5 +1,5 @@
 
-!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]="9ec35c35-f2dc-5f86-a166-cf0c80eab1bd")}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]="5251395b-715a-5559-a7d5-ca3bc4a1bb16")}catch(e){}}();
 import { resolveRecoveryCommandName } from "../sdk/agent/command-recovery.js";
 import { renderPmCommand } from "./argv-utils.js";
 import { discoverNearbyPmRoot } from "../sdk/tracker-root-discovery.js";
@@ -171,6 +171,11 @@ function normalizeRecoveryPayload(payload) {
     if (payload.candidate_commands_truncated === true) {
         normalized.candidate_commands_truncated = true;
     }
+    if (payload.option_scope === "declared_on_path" ||
+        payload.option_scope === "declared_elsewhere" ||
+        payload.option_scope === "declared_nowhere") {
+        normalized.option_scope = payload.option_scope;
+    }
     assignRecoveryString(normalized, "suggested_retry", payload.suggested_retry);
     if (typeof payload.retry_after_ms === "number" &&
         Number.isSafeInteger(payload.retry_after_ms) &&
@@ -221,6 +226,9 @@ function renderRecoveryBundle(recovery) {
     if (normalized.candidate_commands_truncated === true) {
         lines.push("  candidate_commands_truncated: true");
     }
+    if (normalized.option_scope !== undefined) {
+        lines.push(`  option_scope: ${normalized.option_scope}`);
+    }
     appendRecoveryTextLine(lines, "suggested_retry", normalized.suggested_retry);
     if (typeof normalized.retry_after_ms === "number") {
         lines.push(`  retry_after_ms: ${normalized.retry_after_ms}`);
@@ -258,6 +266,10 @@ export function renderGuidanceMessage(message) {
         lines.push("");
         lines.push(...renderList("Next steps:", message.nextSteps));
     }
+    if (message.verificationErrors && message.verificationErrors.length > 0) {
+        lines.push("");
+        lines.push(...renderList("Verification errors:", message.verificationErrors));
+    }
     const recoveryLines = renderRecoveryBundle(message.recovery);
     if (recoveryLines.length > 0) {
         lines.push("");
@@ -283,6 +295,9 @@ function guidanceToJsonEnvelope(message, exitCode) {
     if (message.nextSteps && message.nextSteps.length > 0) {
         payload.next_steps = message.nextSteps;
     }
+    if (message.verificationErrors && message.verificationErrors.length > 0) {
+        payload.verification_errors = message.verificationErrors;
+    }
     if (message.recovery) {
         payload.recovery = message.recovery;
     }
@@ -305,6 +320,9 @@ function guidanceToClassification(message) {
     if (message.nextSteps && message.nextSteps.length > 0) {
         payload.next_steps = message.nextSteps;
     }
+    if (message.verificationErrors && message.verificationErrors.length > 0) {
+        payload.verification_errors = message.verificationErrors;
+    }
     if (message.recovery) {
         payload.recovery = message.recovery;
     }
@@ -397,6 +415,8 @@ function applyPmCliErrorContext(guidance, rawMessage, context) {
     const type = normalizeContextValue(context.type, errorType(code));
     const examples = normalizeContextList(context.examples) ?? guidance.examples;
     const nextSteps = normalizeContextList(context.nextSteps) ?? guidance.nextSteps;
+    const verificationErrors = normalizeContextList(context.verification_errors) ??
+        guidance.verificationErrors;
     const fallbackTitle = guidance.code === "command_failed" && context.code
         ? buildFallbackTitleFromMessage(normalizedRawMessage)
         : undefined;
@@ -413,6 +433,7 @@ function applyPmCliErrorContext(guidance, rawMessage, context) {
         why: normalizeContextValue(context.why, guidance.why),
         examples,
         nextSteps,
+        verificationErrors,
         recovery,
     };
 }
@@ -826,6 +847,42 @@ function buildUnsupportedUpdateOptionGuidance(optionName, context, suggestions)
         }),
     });
 }
+const UNKNOWN_OPTION_REQUIRED_BY_SCOPE = {
+    declared_elsewhere: "Use an option declared on this path, or move the declared option to one of its accepting command paths.",
+    declared_on_path: "Use the option with the value and syntax declared by this command path.",
+    declared_nowhere: "Use a declared option on this command path; this spelling exists nowhere in the command lexicon.",
+};
+function resolveUnknownOptionCandidateContext(context) {
+    const otherCommands = normalizeContextList(context.unknownOptionOtherCommands) ?? [];
+    return {
+        otherCommands,
+        optionScope: context.unknownOptionScope ??
+            (otherCommands.length > 0 ? "declared_elsewhere" : "declared_nowhere"),
+        candidateTotal: context.unknownOptionOtherCommandsTotal ?? otherCommands.length,
+    };
+}
+function buildUnknownOptionNextSteps(optionName, commandName, suggestions, candidateContext, retryCommand) {
+    const proseCommands = candidateContext.otherCommands.slice(0, 3);
+    const proseRemainder = candidateContext.candidateTotal - proseCommands.length;
+    const proseRemainderText = proseRemainder > 0
+        ? ` and ${String(proseRemainder)} more command path(s)`
+        : "";
+    return [
+        "Run command help to confirm the exact option contracts for this command path.",
+        suggestions.length
+            ? `Nearest supported options: ${suggestions.join(", ")}`
+            : undefined,
+        proseCommands.length
+            ? `${optionName} is accepted by ${proseCommands.join(", ")}${proseRemainderText}. Inspect those command contracts only if you intended a different operation.`
+            : undefined,
+        candidateContext.optionScope === "declared_nowhere"
+            ? `${optionName} is not declared on any command path. Use a nearest supported option on ${commandName ?? "the attempted command"}, or inspect that command's help.`
+            : undefined,
+        retryCommand
+            ? `Replay with suggested correction: ${retryCommand}`
+            : undefined,
+    ].filter((entry) => typeof entry === "string");
+}
 function buildUnknownOptionGuidance(message, commandName, context) {
     const unknownOption = message.match(/unknown option '([^']+)'/);
     if (!unknownOption) {
@@ -839,26 +896,8 @@ function buildUnknownOptionGuidance(message, commandName, context) {
         (optionName === "--file" || optionName === "--doc")) {
         return buildUnsupportedUpdateOptionGuidance(optionName, context, suggestions);
     }
-    const otherCommands = normalizeContextList(guidanceContext.unknownOptionOtherCommands) ?? [];
-    const candidateTotal = guidanceContext.unknownOptionOtherCommandsTotal ?? otherCommands.length;
-    const proseCommands = otherCommands.slice(0, 3);
-    const proseRemainder = candidateTotal - proseCommands.length;
-    let proseRemainderText = "";
-    if (proseRemainder > 0) {
-        proseRemainderText = ` and ${String(proseRemainder)} more command path(s)`;
-    }
-    const nextSteps = [
-        "Run command help to confirm the exact option contracts for this command path.",
-        suggestions.length
-            ? `Nearest supported options: ${suggestions.join(", ")}`
-            : undefined,
-        proseCommands.length
-            ? `${optionName} is accepted by ${proseCommands.join(", ")}${proseRemainderText}. Inspect those command contracts only if you intended a different operation.`
-            : undefined,
-        retryCommand
-            ? `Replay with suggested correction: ${retryCommand}`
-            : undefined,
-    ].filter((entry) => typeof entry === "string");
+    const candidateContext = resolveUnknownOptionCandidateContext(guidanceContext);
+    const nextSteps = buildUnknownOptionNextSteps(optionName, commandName, suggestions, candidateContext, retryCommand);
     const examples = [
         retryCommand,
         `pm ${commandName ?? "<command>"} --help`,
@@ -867,15 +906,16 @@ function buildUnknownOptionGuidance(message, commandName, context) {
         code: "unknown_option",
         title: `Unknown option ${optionName}`,
         happened: `Commander does not recognize option ${optionName} for this command path.`,
-        required: "Use supported options only, or move option to the correct subcommand.",
+        required: UNKNOWN_OPTION_REQUIRED_BY_SCOPE[candidateContext.optionScope],
         why: "Option contracts are command-specific and intentionally validated.",
         examples,
         nextSteps,
         recovery: buildCommanderRecoveryPayload(context, {
             suggested_flags: suggestions.length > 0 ? suggestions : undefined,
-            candidate_commands: otherCommands,
-            candidate_commands_total: candidateTotal || undefined,
+            candidate_commands: candidateContext.otherCommands,
+            candidate_commands_total: candidateContext.candidateTotal || undefined,
             candidate_commands_truncated: guidanceContext.unknownOptionOtherCommandsTruncated,
+            option_scope: candidateContext.optionScope,
         }),
     });
 }
@@ -1197,4 +1237,4 @@ export const _testOnly = {
     resolveKnownPackageCommandHint,
 };
 //# sourceMappingURL=error-guidance.js.map
-//# debugId=9ec35c35-f2dc-5f86-a166-cf0c80eab1bd
+//# debugId=5251395b-715a-5559-a7d5-ca3bc4a1bb16

package/dist/cli/main.js

@@ -3,7 +3,7 @@
  * @module cli/main
  */
 
-!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]="c8924d43-556d-5041-9fe3-7c5c944531ae")}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]="cf9d1c78-06f0-5330-8562-ac863c95ee86")}catch(e){}}();
 import { Command } from "commander";
 import { activateExtensions, clearActiveExtensionHooks, createCoreCommandHookContext, resetActiveExtensionRuntimeState, createEmptyExtensionRegistrationRegistry, discoverExtensions, getActiveCommandResult, getActiveExtensionRegistrations, loadExtensions, consumeAfterCommandAffectedItems, runActiveCommandHandler, runActiveParserOverride, runActivePreflightOverride, runAfterCommandHooks, runBeforeCommandHooks, setActiveCommandResult, setActiveCommandContext, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, pathExists, resolvePmCliVersion, resolvePmPackageRootFromModule, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, EXIT_CODE, resolveTelemetryErrorCategory, PmCliError, asRecordOrNull, printError, printResult, maybeRunFirstUseTelemetryPrompt, emitTelemetryErrorEvent, startTelemetryCommand, deriveTelemetryCommandResolution, sentryCaptureCliError, sentryFinishCommandSpan, sentryFlush, sentryLogCliUsageError, sentrySetCommandContext, sentryStartCommandSpan, ensureSentryInit, getSettingsPath, resolvePmRoot, readSettings, readSettingsWithMetadata, runWithWorkspaceHarnessSignalDescriptors, createLazyModule, } from "../sdk/runtime-primitives.js";
 import { resolveSubcommandFlagContractsForCommand } from "../sdk/cli-contracts.js";
@@ -1598,6 +1598,7 @@ function attachProgramLifecycleHooks(rootProgram) {
             outputBudget: rawGlobalOptions.outputBudget,
             outputFormat: rawGlobalOptions.outputFormat,
             outputSession: rawGlobalOptions.outputSession,
+            outputCursor: rawGlobalOptions.outputCursor,
         });
         forwardReadOutputIncludeModes(actionCommand, commandPath, globalOptions, commandOptions);
         await maybeRunFirstUseTelemetryPrompt(commandPath, globalOptions);
@@ -2511,4 +2512,4 @@ export const _testOnly = {
     wrapThrownErrorForSentry,
 };
 //# sourceMappingURL=main.js.map
-//# debugId=c8924d43-556d-5041-9fe3-7c5c944531ae
+//# debugId=cf9d1c78-06f0-5330-8562-ac863c95ee86

package/dist/cli/register-history-author.js

@@ -1,18 +1,20 @@
 
-!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]="50a7ce23-2abf-5240-b426-b73cb704e329")}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]="2745d577-4f6c-5b9e-b54a-e1451e022d63")}catch(e){}}();
 import { resolvePmRoot } from "../sdk/runtime-primitives.js";
-import { acknowledgeUnknownAuthorHistoryEvents, resolveUnknownAuthorAcknowledgmentSelector, } from "../sdk/author-attribution.js";
+import { acknowledgeUnknownAuthorHistoryEventsFromTransport } from "../sdk/author-attribution.js";
 import { collect, getGlobalOptions, printResult, readOptionString, } from "./registration-helpers.js";
 async function runHistoryAuthorAcknowledgeAction(options, command) {
     const globalOptions = getGlobalOptions(command);
     const rawEvents = Array.isArray(options.event)
         ? options.event
         : [];
-    const selector = resolveUnknownAuthorAcknowledgmentSelector(rawEvents, options.allActionable === true);
-    const result = await acknowledgeUnknownAuthorHistoryEvents(resolvePmRoot(process.cwd(), globalOptions.path), {
-        events: selector.events,
-        all_actionable: selector.all_actionable,
-        attributed_author: readOptionString(options, "attributedAuthor"),
+    const result = await acknowledgeUnknownAuthorHistoryEventsFromTransport(resolvePmRoot(process.cwd(), globalOptions.path), {
+        historyEvent: rawEvents,
+        allActionable: options.allActionable === true,
+        dryRun: options.dryRun === true,
+        planFingerprint: readOptionString(options, "planFingerprint"),
+        limit: options.limit,
+        attributedAuthor: readOptionString(options, "attributedAuthor"),
         reviewer: readOptionString(options, "reviewer"),
         reason: readOptionString(options, "reason"),
     });
@@ -24,11 +26,14 @@ export function registerHistoryAuthorAcknowledgeCommand(program) {
         .command("history-author-acknowledge")
         .option("--event <item-id:line>", "Unknown-author event coordinate (repeatable)", collect)
         .option("--all-actionable", "Select all actionable events")
-        .requiredOption("--attributed-author <value>", "Reviewed principal attribution")
-        .requiredOption("--reviewer <value>", "Disposition reviewer")
-        .requiredOption("--reason <value>", "Review evidence")
+        .option("--dry-run", "Preview a deterministic source-bound plan")
+        .option("--plan-fingerprint <sha256>", "Apply the exact fingerprint returned by --dry-run")
+        .option("--limit <n>", "Maximum coordinate rows returned in the plan")
+        .option("--attributed-author <value>", "Reviewed principal attribution")
+        .option("--reviewer <value>", "Disposition reviewer")
+        .option("--reason <value>", "Review evidence")
         .description("Append audited dispositions for immutable unknown-author events.")
         .action(runHistoryAuthorAcknowledgeAction);
 }
 //# sourceMappingURL=register-history-author.js.map
-//# debugId=50a7ce23-2abf-5240-b426-b73cb704e329
+//# debugId=2745d577-4f6c-5b9e-b54a-e1451e022d63

package/dist/cli/register-mutation.js

@@ -1,5 +1,5 @@
 
-!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]="6c7d647c-e489-51e3-b84b-5b62b4114033")}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]="60ee1ab9-00a0-50a7-839e-4938ecc6a48f")}catch(e){}}();
 import { resolveBodyFileContent, EXIT_CODE, splitCommaList, PmCliError, createUnknownSubcommandError, } from "../sdk/runtime-primitives.js";
 import { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, PLAN_CREATE_METADATA_PARAMETER_KEYS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, } from "../sdk/cli-contracts.js";
 import { BUILTIN_ITEM_TYPE_VALUES } from "../types/index.js";
@@ -1670,6 +1670,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .argument("[id]", "Item id (omit with --all)")
         .option("--all", "Scan every stream for drift and repair each drifted stream in one audited pass")
         .option("--dry-run", "Preview the re-anchor impact without writing the history file")
+        .option("--normalize-provenance", "Remove invalid provenance; return aggregate-only evidence")
         .option("--author <value>", "Mutation author")
         .option("--message <value>", "Audit history message for the repair marker entry")
         .option("--force", "Force ownership/lock override")
@@ -1684,6 +1685,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
             force: Boolean(options.force),
+            normalizeProvenance: options.normalizeProvenance === true,
         };
         // history-repair only re-anchors the audit stream; item content is untouched,
         // so search caches do not need invalidation.
@@ -1838,4 +1840,4 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .action(runDepsAction);
 }
 //# sourceMappingURL=register-mutation.js.map
-//# debugId=6c7d647c-e489-51e3-b84b-5b62b4114033
+//# debugId=60ee1ab9-00a0-50a7-839e-4938ecc6a48f