@unbrained/pm-cli 2026.10.18 → 2026.10.20

package/docs/MERGE_SAFETY.md

@@ -286,6 +286,28 @@ receipt file that the older writer never created. Incomplete, contradictory, or
 modern summaries still fail closed. `runMergeReceiptReport` remains the
 compatible valid-only report.
 
+## Portable receipt proof
+
+Reconciliation refuses `merge_receipt_not_portable` before any audit write when
+an active clone-local receipt lacks a validated tracked counterpart. `--force`
+does not bypass this boundary, including for direct SDK history-repair calls.
+An earlier aborted operation can leave an unreferenced local receipt whose field
+hashes happen to match a later merge; those hashes do not make its evidence
+portable. Review and preserve unrelated stale receipts outside the active store,
+or restore the original valid durable sidecar. Never copy private local receipt
+values into tracked evidence as a substitute.
+
+`inspectMergeReceiptEvidence().durable_receipt_ids` identifies validated durable
+counterparts whose immutable provenance matches the stored blob referenced by the Git index;
+clone-local replacement refs cannot substitute different evidence.
+Untracked files and mismatched staged versions cannot authorize an audit write.
+`unstaged_durable_receipt_ids` reports valid disk candidates for a read-only
+preview; clone-local-only evidence remains refused even in preview. Current readers
+return both arrays; their optional interface properties preserve structural compatibility,
+and a missing property provides no evidence. Health resolves committed history
+references against these durable identities, so a local copy cannot hide evidence
+that a fresh clone will lack. Receipt summaries remain privacy-safe.
+
 ## Historical receipt reader compatibility
 
 Tracked by [pm-2xtv84](../.agents/pm/issues/pm-2xtv84.toon) and
@@ -388,8 +410,13 @@ pm config project set ids_token_length 8
 
 The SDK item merge refuses an empty common ancestor with
 `item_identity_conflict`, even for equal item content: document equality alone
-cannot prove a common creation. It leaves the driver output untouched instead
-of combining two identities through scalar preference. The history merge also
+cannot prove a common creation. The pure merge primitive leaves inputs unchanged.
+The Git driver preserves both original snapshots in visible conflict markers
+and names the item in its refusal, tracked by
+[pm-gh1491](../.agents/pm/issues/pm-gh1491.toon). Staging these files does not
+clear the conflict-marker health and storage failures. A copied creation or
+history prefix alone never authorizes fusion of two independently introduced
+identities. The history merge also
 refuses different create events across its inputs, multiple creates in either
 input, or creations on both sides when the ancestor lacks a create event even
 when their bytes match, before fast-forwarding or reanchoring. A common ancestor
@@ -432,6 +459,54 @@ N-branch conflict fixture compares competing writes to the same scalar set.
 Arbitrary histories, ordered executable test definitions with receiving-clone
 trust, and relationship-event ordering retain their separate conformance contracts.
 
+## Settle a lossless merge in one commit
+
+Tracked by [pm-gh1475](../.agents/pm/issues/pm-gh1475.toon).
+Pause Git before it creates the merge commit, then stage the audited settlement:
+
+```bash
+git merge --no-commit --no-ff <branch>
+pm merge reconcile --stage
+git diff --cached
+git commit
+```
+
+`--stage` first previews reconciliation. It refuses discarded-value decisions,
+untrusted or unrelated repairs, invalid storage, missing durable evidence,
+unresolved Git paths, alternate Git indices, and unstaged edits to the reconciliation paths. It never
+accepts `--force`. Only the verified history streams and receipt sidecars are
+added to the index; unrelated staged changes retain their existing state.
+Validated new sidecars enter the index before any audit history is written.
+If apply fails, their new index entries are reverted while their files and
+unrelated staged work remain available for review. Staged receipt deletions
+remain operator decisions and are refused.
+`--stage --dry-run` checks this boundary without applying or staging anything.
+The result's `staged_paths` lists the repository-relative artifacts added.
+Tracker aliases resolve before preview, so proof verification, repair and staging
+use the same physical tracker root.
+
+Repositories can explicitly opt into a merge-aware `pre-commit` hook:
+
+```bash
+pm merge install --pre-commit-hook --dry-run
+pm merge install --pre-commit-hook
+git merge --no-commit --no-ff <branch>
+git commit
+```
+
+The hook runs guarded settlement only when `MERGE_HEAD` exists; ordinary commits
+are unchanged. Installation honors Git's hooks directory, including
+`core.hooksPath`, and preserves any hook without the pm ownership header. For
+an existing hook, integrate `pm merge reconcile --stage` into the reviewed merge
+path yourself. The installation result reports `settlement_hook.path`; removing
+that owned hook restores the manual workflow. Hooks are clone-local and must be
+installed explicitly in each clone. No hook is installed by default.
+
+The explicit `--no-commit --no-ff` step is required. Git's automatic merge commit
+can capture its tree before a `pre-merge-commit` hook stages new audit artifacts;
+that hook cannot provide this single-commit guarantee. Rebase and already
+committed merges continue to use the explicit reconciliation gate below.
+
 ## Required post-merge gate
 
 Reconciliation resolves receipt discovery and settlement from the requested
@@ -443,12 +518,20 @@ After every branch merge that touches `.agents/pm`, run:
 
 ```bash
 pm merge reconcile --dry-run --json
+# When the preview lists unstaged sidecars, review and stage those files first.
 pm merge reconcile --message "Reconcile merged tracker histories" --json
 # Required only to accept a receipt that lacks qualifying exact hash proof:
 pm merge reconcile --force --message "Accept reviewed merge decisions" --json
 ```
 
 The preview reports every drifted stream and pending receipt without mutation.
+`unstaged_durable_receipt_ids` identifies valid filesystem sidecars awaiting
+matching immutable evidence in the Git index. The preview can inspect those
+sidecars, but ordinary apply refuses to cite them until they are staged. For the
+default tracker their paths are `.agents/pm/merge-receipts/<receipt-id>.json`;
+use `git add -- <reviewed sidecar paths>` followed by `git diff --cached`. Use
+`--stage` for the guarded lossless workflow above. After ordinary apply, stage
+the updated history and receipt lifecycle files together before committing.
 It applies the same exact-snapshot proof requirement as apply: stale or
 unprovable receipts appear as failed streams in both modes, tracked by
 [pm-ao0bu9](../.agents/pm/issues/pm-ao0bu9.toon).
@@ -514,9 +597,9 @@ The apply pass uses the audited history rewrite boundary to append a
 event includes privacy-safe receipt provenance; a clean receipt-bearing stream
 gets a no-op merge event so the merge remains addressable even when replay
 already matches. The command immediately validates history drift plus storage
-integrity and exits nonzero when an invariant remains red. Default Git hooks
-remain unchanged: repositories that want automatic enforcement must opt in by
-invoking this command from their own post-merge hook.
+integrity and exits nonzero when an invariant remains red. Default Git hooks remain unchanged. The explicit merge-aware pre-commit option
+above includes settlement before committing; a repository-owned post-merge hook
+can still enforce reconciliation after an already-created merge commit.
 
 The default validation surface includes `storage_integrity`. It fails on unreadable item documents, history conflict markers, malformed history tails, live items whose latest history operation is `delete` (a delete/modify resurrection candidate), and unparseable settings/schema files. This prevents the ordinary tolerant read path from turning corruption into a green gate.
 

package/docs/PR_REVIEW_LOOP.md

@@ -15,6 +15,7 @@ capture, avoiding repeated diff hunks that are irrelevant to marker matching.
 ```bash
 node scripts/reviews/pr-review-loop.mjs inventory --pr 123 > /tmp/pr-123-review-inventory.json
 node scripts/reviews/pr-review-loop.mjs watch --pr 123 --interval 30 > /tmp/pr-123-review-inventory.json
+node scripts/reviews/pr-review-loop.mjs watch --pr 123 --phase reviews --interval 30 > /tmp/pr-123-full-review-inventory.json
 node scripts/reviews/pr-review-loop.mjs react --node-id IC_kw... --reaction THUMBS_UP
 node scripts/reviews/pr-review-loop.mjs acknowledge --pr 123 --node-id PRR_kw... --revision '<revision>' --reaction THUMBS_UP --body "CodeRabbit feedback implemented: https://github.com/owner/repo/pull/123#pullrequestreview-456. The suggested edge case is covered by test X."
 node scripts/reviews/pr-review-loop.mjs reply-inline --pr 123 --comment-id 456 --body "Addressed in abc123."
@@ -43,17 +44,34 @@ markers then distinguish revised feedback and suppress duplicate retry replies
 for that same revision. Inline markers are matched only within the selected
 reply thread. Legacy calls without the flag retain their existing behavior.
 
-After every push or reviewer retrigger, run `watch`. It delegates waiting to
-`gh pr checks --watch`, because reviewer agents report completion through GitHub
-checks, and only fetches the complete conversation inventory after those checks
-finish. Native watch success covers emitted checks only: a required provider may
+After every push or reviewer retrigger, run `watch`. Its default `checks` phase
+delegates waiting to `gh pr checks --watch --fail-fast`, returning the complete
+exact-head conversation inventory as soon as a check fails, even while an optional
+reviewer remains pending. Fix that failure before starting another wait. Use
+`--phase reviews` for the separate blocking review-completion phase: it delegates
+to `gh pr checks --watch` without fail-fast and waits for every emitted check.
+Both phases record `pendingChecks` and `unavailableChecks` from the final rollup,
+including names, states, URLs and whether each context is required. Neutral,
+skipped, canceled and other unavailable signals do not establish review approval;
+inspect the retained conversations for provider quota or service limitations.
+Pending checks prevent a successful receipt even if GitHub reports `CLEAN`.
+This behavior is tracked by [pm-jm7m3o](../.agents/pm/tasks/pm-jm7m3o.toon).
+Native watch success covers emitted checks only: a required provider may
 never emit its context. The helper unions classic branch-protection requirements
-with all effective ruleset requirements, compares those names with the complete
-head rollup, and records `mergeReadiness.requiredContexts`, `missingContexts`, and
-GitHub's `mergeStateStatus`. An attempt is `passed` only when no required name is
-missing and GitHub reports `CLEAN`. GitHub's merge state also retains enforcement
-of expected check publishers and other merge requirements; a matching name alone
-does not establish that its expected app passed. Missing contexts and blocked or
+with all effective ruleset requirements and retains publisher bindings in
+`mergeReadiness.requiredChecks` alongside `requiredContexts`. Bound requirements
+need both a name in the head rollup and paginated exact-head check-run evidence
+from the expected app. A wrong or unavailable check-run publisher remains in
+`missingContexts`; unbound legacy contexts retain name-based presence checks.
+Commit statuses expose no app identity in the rollup. Status-only bound contexts
+are disclosed in `publisherUnverifiable` with source `commit_status` and rely on
+GitHub's `CLEAN` verdict to enforce the publisher binding. If the same context is
+also emitted as a check run, that run still requires exact-head app evidence.
+The receipt records GitHub's `mergeStateStatus` independently: an attempt is
+`passed` only when no requirement is missing and GitHub reports `CLEAN`.
+Publisher presence does not establish a passing verdict; GitHub retains that
+enforcement along with other merge requirements. Publisher evidence is tracked by
+[pm-5p48kf](../.agents/pm/tasks/pm-5p48kf.toon). Missing contexts and blocked or
 unknown merge state remain `incomplete`; native watch failures remain `failed`.
 Superseded attempts carry `superseded: true` and never certify readiness. Unavailable policy or status reads
 fail visibly instead of certifying readiness. Successful
@@ -62,8 +80,10 @@ The direct `watch` command emits its complete JSON receipt before exiting `1`
 for `incomplete` or `failed`, and exits `0` only for `passed`. Shell automation
 can therefore stop on the exit status while retaining all findings for triage.
 
-A failed reviewer check is still a completed review signal: `watch` records
-the failed outcome and returns all findings instead of aborting before inventory.
+A failed check is still an actionable signal: `watch` records the failed outcome
+and returns all findings instead of aborting before inventory. A fail-fast receipt
+does not establish completion of pending reviews; the explicit review phase and
+final inventory retain that separate obligation.
 If the PR head or target branch changes during the wait or final readiness read,
 the helper watches the new target, up to three consecutive attempts, before
 returning exact-head state. It does not poll an absent required provider status.

package/docs/SCRIPTING.md

@@ -101,6 +101,16 @@ receipts without that evidence retain their existing envelope.
 
 JSON object field order is not an API. Consume fields by name. Read envelopes keep the stable pagination vocabulary `items`, `count`, `total`, `has_more`, and, when another page exists, `next_cursor`. The `filters` object echoes the effective query scope. Plain `pm list` and `pm search` are all-status reads and disclose `filters.status: "all"`; lifecycle-specific commands such as `pm list-open` remain explicit shortcuts.
 
+Default brief-list TOON presentation omits default projection, sorting, timestamp,
+and redundant zero-count metadata. A `details: "--full"` pointer replaces only
+the standard full-item omission receipt. Unchecked source status, pagination,
+non-default sorting, warnings, and additional diagnostics remain visible.
+Use JSON for the complete typed envelope. TOON object rows preserve explicit
+nulls and empty values, including nested cells. Only genuinely missing keys
+appear in a table's `absent` metadata.
+Successful health checks retain their compact presentation by omitting an empty
+diagnostic `details` object. Material diagnostics and failing checks remain visible.
+
 Projection flags intentionally change row shape. Use `--fields` when a script requires an exact subset, `--brief` or `--compact` only when the documented sparse shape is sufficient, and `--full` when linked metadata is required. Check `row_contract` on generic read surfaces that expose one; do not infer omitted fields as empty values.
 
 For long-lived clients, generate or inspect the runtime contract instead of hard-coding recalled flags:

package/docs/SDK.md

@@ -210,6 +210,32 @@ follow the migration guidance for changed unions or error codes. The shared
 [primitive inventory](SDK_PRIMITIVE_INVENTORY.md) records CLI/MCP ownership:
 presentation modules import the SDK and have zero private-core edges.
 
+### Portable merge settlement
+
+Tracked by [pm-gh1475](../.agents/pm/issues/pm-gh1475.toon) and
+[pm-gh1491](../.agents/pm/issues/pm-gh1491.toon). Import `runMergeInstall`,
+`runMergeReconcile`, and `inspectMergeReceiptEvidence` from
+`@unbrained/pm-cli/sdk/merge`. `runMergeInstall({ preCommitHook: true }, global)`
+explicitly installs the merge-aware pre-commit hook; the default installs no hook.
+`runMergeReconcile({ stage: true }, global)` previews first and stages only
+verified lossless history and receipt artifacts. It refuses forced acceptance,
+competing values, unrelated drift, dirty reconciliation paths and unresolved Git
+paths. `staged_paths` reports exactly which relative paths were added to the index.
+
+The single-commit journey pauses Git with `git merge --no-commit --no-ff` before
+reconciliation or an opted-in pre-commit hook runs. `durable_receipt_ids` on the
+inspection result reports counterparts with matching immutable provenance in
+the active Git index. `unstaged_durable_receipt_ids` separates valid filesystem
+sidecars that a read-only preview may inspect. Guarded staging prepares new
+sidecars before auditing and restores their new index entries if apply fails.
+Inspection lists indexed candidates once and reads bounded object batches.
+Guarded settlement resolves tracker aliases before preview, proof verification
+and apply, so every phase uses the same physical tracker root.
+Ordinary apply requires indexed proof first. Missing portable proof
+refuses an audit write even with `force`; local receipts alone cannot authorize
+committed history references. See [Merge safety](MERGE_SAFETY.md#settle-a-lossless-merge-in-one-commit)
+for the complete operator workflow and recovery boundaries.
+
 ### Build an entire custom project tool
 
 The [SDK-only custom-tool exemplar](examples/sdk-custom-tool/README.md)
@@ -1356,6 +1382,22 @@ handlers remain disabled. Package-backed `--template` create input cannot be
 semantically previewed through its package handler; expand it into explicit core
 mutation options before preview.
 
+Actionable previews are tracked by [pm-ekf2gu](../.agents/pm/issues/pm-ekf2gu.toon)
+and [pm-fa9olc](../.agents/pm/tasks/pm-fa9olc.toon).
+`previewItemMutations` returns `warnings` grouped by zero-based operation
+`index`, canonical `id`, and `op`. These are the original create lifecycle
+warnings, including advisory `likely_duplicates` and duplicate-recovery tokens.
+Earlier staged creates participate in later duplicate checks. Strict policy
+still refuses duplicates; preview never changes the configured policy.
+
+For a document resolved with `planItemMutationDocument`, call
+`previewItemMutationDocument({ pmRoot, author, plan })` from the aggregate SDK.
+It returns `{ validation, rows }`; affected rows retain their source `index`
+and `ref` and gain `warnings`. Rows without warnings omit that property. The
+input plan stays unchanged. Both `pm item mutate --dry-run` and MCP `pm_mutate`
+use this same projection. A `replayed_committed_plan` has no newly evaluated
+warnings; an empty warning list in that state does not certify current policy.
+
 Staging excludes derived `search` and `locks` content and unrelated runtime state,
 retaining registered item folders, explicitly configured schema files, and
 `runtime/session.json` for core focus and inherited-parent semantics. Root-layout
@@ -1369,6 +1411,17 @@ remapped only in the staged settings. Schema files configured outside the
 tracker fail with `transaction_preview_external_schema`; relocate them inside
 the selected tracker root before retrying.
 
+`transaction_preview_non_regular_file` includes `preview_storage` in SDK error
+context and the CLI JSON error envelope. It reports a fixed `storage_area`,
+`entry_redacted`, and, when safe, `relative_entry` using `/` separators relative
+to the selected tracker root. Coordinates are limited to 160 ASCII characters
+from letters, digits, `.`, `_`, `-`, and separators. Absolute paths, traversal,
+control characters and overlong or otherwise unsafe names are withheld; the
+storage category remains available. Diagnostics never include link targets.
+Inspect that entry without following links, restore the intended regular file
+or directory, and retry the dry run. Native filesystem errors retain their
+existing diagnostics.
+
 Preview requires trusted, stable directory entries and ancestors. Where Node
 exposes `O_NOFOLLOW` and `O_NONBLOCK`, descriptor opens request those POSIX guards.
 Windows retains entry checks, regular-file descriptor checks and snapshot
@@ -1614,6 +1667,13 @@ trees, custom runtime fields, dependency-aware filtering, unsupported filters,
 and stale/missing indexes take the canonical fallback path with identical
 result contracts. Custom hosts may call `queryItemMetadataIndex` directly, but
 must treat `null` as an instruction to rebuild or use authoritative storage.
+The separate history-event index is also optional. Recognized native SQLite
+failures while starting its write transaction invalidate that projection before
+appending authoritative history. Native lock contention retains its existing
+invalidation protocol; unrelated adapter exceptions and authoritative append
+failures propagate. A later index rebuild restores accelerated history reads.
+(Repository tracker: [pm-0orupq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-0orupq.toon);
+tracker records are excluded from npm.)
 
 List results always expose `total`, `has_more`, `truncated`, and a nullable
 `next_cursor`, whether or not the page was truncated; unset filter echoes are
@@ -1662,6 +1722,16 @@ true. The normal JSON envelope remains unchanged, and an actionable cursor is
 always retained. SDK query functions continue returning their full typed
 results; lean projection belongs to the CLI presentation boundary.
 
+Custom agent hosts can import `projectPmBriefListEnvelope` from
+`@unbrained/pm-cli/sdk` to apply the same brief-list presentation without
+mutating the original result. It retains unchecked source status and actionable
+continuation, and leaves partial, custom, or inconsistent envelopes intact.
+The CLI applies this projection only to TOON; ordinary JSON and SDK query
+results retain their complete contracts. The public `encodePmTableRows` and
+`decodePmTableRows` primitives distinguish explicit null and empty cells from
+missing keys. TOON rendering preserves those row facts before selecting the
+smaller expanded or tabular encoding.
+
 Migration note: before this contract, `total` was present only when pagination
 omitted rows, a completed page omitted `next_cursor`, and verbose results
 emitted unset filter keys with `null` values. Consumers must use `has_more` or
@@ -2442,6 +2512,39 @@ throw createPmCliExpectedError("hello requires --name", {
 
 The helper returns an `Error` whose public name is `PmCliError` and whose `exitCode` is structural. That makes it safe for bundled, linked, and separately installed package code even when class identity is not shared with the running CLI.
 
+For example, the SDK command layer settles relationship token counts after alias
+counts, read disclosure, encoding and optional lean/token-accounting policies.
+It converts an impossible rendered context budget into an expected
+`invalid_argument_value` usage error. The public `PmTokenBudgetRecovery` type and
+`isPmTokenBudgetRecovery` guard describe `context.recovery.token_budget`: requested
+tokens, a verified feasible retry value, and an exact minimum only when every
+smaller positive budget has been checked. Larger searches report `feasible_only`;
+query cost limits, exhausted searches or independent output constraints can report
+`unavailable`. Both states leave the unproved minimum `null`. The bounded search
+uses the real packer and output policy, including alias disclosure.
+The public type is a discriminated union: checking `minimum_status` narrows the
+verified budgets and requires a reason for `unavailable`. Package authors cannot
+declare unavailable advice with a numeric budget or omit its cause. The runtime
+guard additionally checks positive safe integers and equal budgets for `exact`;
+those numeric invariants cannot be expressed by the declaration alone.
+`suggested_retry_args` preserves the selected tracker, query and output options
+with the verified feasible budget so it works from another workspace.
+Retry probes consume canonical summary/full include modes before packing and
+retain only residual field selectors, matching the emitted CLI command. Recovery
+work estimates include repeated dangling-reference renders; summary probes count
+only their single rendering pass. Expensive queries return explicit unavailable
+budget advice and retain the compact inspection fallback.
+`next_best_command` retains a separate compact tree-summary inspection, which
+also supplies the fallback when no working context budget is established.
+CLI JSON and MCP preserve that recovery. The lower-level
+`buildRelationshipContext` primitive retains its `TypeError` validation contract;
+unrelated runtime errors still propagate.
+(Repository tracker: [pm-odw3j8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-odw3j8.toon),
+[pm-0bbc53](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-0bbc53.toon),
+[pm-k6uglj](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-k6uglj.toon),
+[pm-8jzcwv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-8jzcwv.toon);
+tracker records are excluded from npm.)
+
 For policy, lint, or verification commands that should render their full result
 and report failure without throwing, return a structured object instead:
 

package/docs/TESTING.md

@@ -49,6 +49,13 @@ claims to the same canonical gate IDs. Hosted-only environment isolation and
 tracker-integrity steps remain explicit entries with reasons rather than
 silently disappearing from local parity.
 
+The full-source command-example scan runs after parallel contract files in the
+existing serial cohort. It keeps the same source corpus, assertions and
+30-second deadline, so concurrent contract workers do not consume its
+policy-check budget. This allocation is tracked by
+[pm-a3c6g4](../.agents/pm/tasks/pm-a3c6g4.toon); broader runner qualification
+remains with [pm-bj7rq0](../.agents/pm/issues/pm-bj7rq0.toon).
+
 `node scripts/run-tests.mjs` wraps Vitest in temporary tracker roots, disables
 external Sentry delivery for the build, test workers, and their nested CLI
 children, then cleans the roots up. Instrumentation tests can still exercise
@@ -97,6 +104,13 @@ so PR-local CodeFactor maintainability annotations fail locally before commit or
 push. Existing legacy high-complexity test fixtures are tracked separately and
 must not be used as precedent for new changed production/script code.
 
+Module-usage checks share the SDK boundary's literal-specifier parser and walk
+nested AST nodes, including lazy `import("./module.js")` references. Unused
+modules, comment-only references, and computed paths do not gain incoming
+references. The regression is tracked by
+[pm-f38ovr](../.agents/pm/issues/pm-f38ovr.toon); no module allowance or threshold
+increase is required to keep optional SDK capabilities lazy.
+
 The same required static gate validates an explicit seven-day Dependabot
 cooldown for every updater and requires both npm and GitHub Actions entries.
 Missing values, semver overrides outside 7–90 days, invalid YAML, removed
@@ -237,6 +251,22 @@ into the pass count; a persistent assertion still fails after the bounded
 retry. Local runs do not retry, so deterministic failures stay immediate while
 iterating.
 
+The complete receipt-operation, aborted-operation recovery, receipt-settlement, merge-portability and
+lossless-collection-union integration files run in the existing serial
+`lifecycle-performance` project after parallel contracts. Both nightly shards and
+full coverage use that same project partition, retaining every case and its
+original assertions, deadlines and retry policy. This allocation is tracked by
+[pm-89297t](../.agents/pm/tasks/pm-89297t.toon); it does not classify or erase
+historical failed attempts.
+
+The complete macOS Node 24 and Windows Node 24 nightly suites each use two
+Vitest shards. Both halves must pass within the existing 20-minute job limit;
+sharding retains the same complete file population, serial phase, assertions,
+per-test deadlines and retry policy. The recurrence collector retains the old
+unsharded platform families alongside both current shard identities, so changing
+the matrix does not erase earlier failures. macOS allocation is tracked by
+[pm-qrirz8](../.agents/pm/tasks/pm-qrirz8.toon).
+
 Vitest's GitHub reporter emits annotations and retry evidence. The repository
 reliability reporter additionally writes
 `.vitest-reports/reliability-<shard>.json` and appends a job-summary table with
@@ -661,7 +691,8 @@ pm test <item-id> --run --workspace-context snapshot --override-linked-workspace
   Windows execution is tracked by [pm-bj7rq0](../.agents/pm/issues/pm-bj7rq0.toon).
   Script and native keeper cohorts run independently on Windows Node 24. Their
   source/script keeper steps retain the two-worker cap, and each cohort retains
-  the 12-minute deadline. The required
+  the 12-minute deadline. The four-file Git/worktree receipt slice uses one
+  worker to avoid competing subprocess-heavy files at the same case deadlines. The required
   `Windows regression (Node 24)` check waits for both cohorts and fails if either
   fails, is cancelled, or is skipped. This preserves every selected regression
   while avoiding a shared serial job deadline. See GitHub's

package/docs/generated/FLAG_LEXICON_BUDGETS.md

@@ -39,7 +39,7 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | `history-repair` | evidence | 27 | 27 |
 | `history-compact` | evidence | 30 | 30 |
 | `history-author-acknowledge` | evidence | 28 | 28 |
-| `merge` | workspace | 27 | 27 |
+| `merge` | workspace | 29 | 29 |
 | `schema` | workspace | 43 | 43 |
 | `profile` | workspace | 22 | 22 |
 | `activity` | context | 35 | 35 |
@@ -110,7 +110,7 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | `item test worker` | internal | 20 | 20 |
 | `history acknowledge` | evidence | 28 | 28 |
 | `item copy` | intake | 24 | 24 |
-| `workspace merge` | workspace | 27 | 27 |
+| `workspace merge` | workspace | 29 | 29 |
 | `item duplicates` | context | 25 | 25 |
 | `calendar meet` | automation | 33 | 33 |
 | `calendar event` | automation | 33 | 33 |

package/docs/generated/REFUSAL_CLOSURE_CENSUS.md

@@ -4,12 +4,12 @@ Tracker: `pm-f05lsg`.
 
 Every catalog code is listed. An `uncovered` row is an explicit closure obligation, never an omission or implied approval.
 
-- Catalog error codes: 419
+- Catalog error codes: 422
 - Executable error codes: 19
 - Executable-code ratchet floor: 18
 - Required executable canonical codes: `bulk_ids_input_empty`, `bulk_ids_input_missing_path`, `bulk_ids_input_unreadable`, `invalid_argument_value`, `manifest_unknown_key`, `missing_lifecycle_target`, `missing_required_argument`, `no_version_bounds_declared`, `projection_options_mutually_exclusive`, `tracker_not_initialized`, `tracker_root_missing`, `tracker_root_not_directory`, `tracker_root_unreadable`, `unknown_context_intent`, `unknown_field_projection`, `unknown_option`, `unknown_subcommand`
-- Uncovered error codes: 400
-- Coverage fraction: 0.045346
+- Uncovered error codes: 403
+- Coverage fraction: 0.045024
 - Closed-domain probes: 19
 - Grammar probes: 117
 
@@ -221,9 +221,12 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `merge_git_config_unwritable` | `merge_git_config_unwritable` | uncovered | none | 0 |
 | `merge_receipt_evidence_invalid` | `merge_receipt_evidence_invalid` | uncovered | none | 0 |
 | `merge_receipt_history_reference_missing` | `merge_receipt_history_reference_missing` | uncovered | none | 0 |
+| `merge_receipt_not_portable` | `merge_receipt_not_portable` | uncovered | none | 0 |
 | `merge_receipts_pending` | `merge_receipts_pending` | uncovered | none | 0 |
 | `merge_reconcile_receipt_evidence_untrusted` | `merge_reconcile_receipt_evidence_untrusted` | uncovered | none | 0 |
 | `merge_root_not_found` | `merge_root_not_found` | uncovered | none | 0 |
+| `merge_settlement_hook_conflict` | `merge_settlement_hook_conflict` | uncovered | none | 0 |
+| `merge_settlement_review_required` | `merge_settlement_review_required` | uncovered | none | 0 |
 | `missing_allowed_values` | `missing_allowed_values` | uncovered | none | 0 |
 | `missing_budget` | `missing_budget` | uncovered | none | 0 |
 | `missing_cli_flag` | `missing_cli_flag` | uncovered | none | 0 |

package/marketplace.json

@@ -1 +1 @@
-{"name":"pm","owner":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"description":"Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.","version":"2026.10.18","plugins":[{"name":"pm-claude","source":"./plugins/pm-claude","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.","version":"2026.10.18","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"],"category":"productivity"}]}
+{"name":"pm","owner":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"description":"Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.","version":"2026.10.20","plugins":[{"name":"pm-claude","source":"./plugins/pm-claude","description":"Native pm CLI integration for Claude Code — 32 MCP tools, 14 workflow skills with slash invocations, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.","version":"2026.10.20","author":{"name":"unbrained","url":"https://github.com/unbraind/pm-cli"},"homepage":"https://github.com/unbraind/pm-cli","repository":"https://github.com/unbraind/pm-cli","license":"MIT","keywords":["pm-cli","project-management","mcp","tasks","agents","workflows","git-native","task-tracker","ai"],"category":"productivity"}]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.10.18",
+  "version": "2026.10.20",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.28.5",

package/packages/pm-beads/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-beads","version":"2026.10.18","private":true,"type":"module","description":"First-party pm package for importing Beads JSONL records.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-beads"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","beads"],"pm":{"aliases":["beads"],"extensions":["extensions/beads"],"catalog":{"display_name":"Beads Import","category":"migration","summary":"Import Beads JSONL records into pm while preserving source IDs.","tags":["migration","beads","import"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-beads","version":"2026.10.20","private":true,"type":"module","description":"First-party pm package for importing Beads JSONL records.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-beads"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","beads"],"pm":{"aliases":["beads"],"extensions":["extensions/beads"],"catalog":{"display_name":"Beads Import","category":"migration","summary":"Import Beads JSONL records into pm while preserving source IDs.","tags":["migration","beads","import"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-calendar/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-calendar","version":"2026.10.18","private":true,"type":"module","description":"First-party pm package for calendar and agenda views.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-calendar"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","calendar","agenda"],"pm":{"aliases":["calendar"],"extensions":["extensions/calendar"],"catalog":{"display_name":"Calendar Views","category":"workflow","summary":"Show agenda, day, week, and month views for deadlines, reminders, and scheduled events.","tags":["calendar","agenda","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-calendar","version":"2026.10.20","private":true,"type":"module","description":"First-party pm package for calendar and agenda views.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-calendar"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","calendar","agenda"],"pm":{"aliases":["calendar"],"extensions":["extensions/calendar"],"catalog":{"display_name":"Calendar Views","category":"workflow","summary":"Show agenda, day, week, and month views for deadlines, reminders, and scheduled events.","tags":["calendar","agenda","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-calendar","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-command-kit/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-command-kit","version":"2026.10.18","private":true,"type":"module","description":"First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-command-kit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","commands","exemplar"],"pm":{"aliases":["command-kit"],"extensions":["extensions/command-kit"],"catalog":{"display_name":"Command Kit Exemplar","category":"sdk","summary":"Copy-paste-able exemplar for registerCommand, registerFlags, and registerParser.","tags":["sdk","commands","parser","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-command-kit","version":"2026.10.20","private":true,"type":"module","description":"First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-command-kit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","commands","exemplar"],"pm":{"aliases":["command-kit"],"extensions":["extensions/command-kit"],"catalog":{"display_name":"Command Kit Exemplar","category":"sdk","summary":"Copy-paste-able exemplar for registerCommand, registerFlags, and registerParser.","tags":["sdk","commands","parser","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-command-kit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-digital-twin/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-digital-twin","version":"2026.10.18","private":true,"type":"module","description":"Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-digital-twin"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","sdk","digital-twin","event-sourcing","temporal-graph","exemplar"],"pm":{"aliases":["digital-twin","twin"],"extensions":["extensions/digital-twin"],"catalog":{"display_name":"Digital Twin SDK Exemplar","category":"sdk","summary":"Temporal facility graph proving event replay, point-in-time state, invariants, federation, checkpoints, and compact exports through public SDK contracts.","tags":["sdk","digital-twin","event-sourcing","graph","offline-first","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin","report":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin/GAP_REPORT.md"}},"docs":["README.md","GAP_REPORT.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-digital-twin","version":"2026.10.20","private":true,"type":"module","description":"Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-digital-twin"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","sdk","digital-twin","event-sourcing","temporal-graph","exemplar"],"pm":{"aliases":["digital-twin","twin"],"extensions":["extensions/digital-twin"],"catalog":{"display_name":"Digital Twin SDK Exemplar","category":"sdk","summary":"Temporal facility graph proving event replay, point-in-time state, invariants, federation, checkpoints, and compact exports through public SDK contracts.","tags":["sdk","digital-twin","event-sourcing","graph","offline-first","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin","report":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-digital-twin/GAP_REPORT.md"}},"docs":["README.md","GAP_REPORT.md"],"examples":["README.md"]}}

package/packages/pm-governance-audit/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-governance-audit","version":"2026.10.18","private":true,"type":"module","description":"First-party pm package for governance audit and normalization workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-governance-audit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","governance","audit","normalize","hooks"],"pm":{"aliases":["governance-audit","audit"],"extensions":["extensions/governance-audit"],"catalog":{"display_name":"Governance Audit","category":"governance","summary":"Run dedupe audits, comments audits, and normalize sweeps as package-owned workflows.","tags":["governance","audit","normalize","hooks"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-governance-audit","version":"2026.10.20","private":true,"type":"module","description":"First-party pm package for governance audit and normalization workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-governance-audit"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","governance","audit","normalize","hooks"],"pm":{"aliases":["governance-audit","audit"],"extensions":["extensions/governance-audit"],"catalog":{"display_name":"Governance Audit","category":"governance","summary":"Run dedupe audits, comments audits, and normalize sweeps as package-owned workflows.","tags":["governance","audit","normalize","hooks"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-governance-audit","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-guide-shell/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-guide-shell","version":"2026.10.18","private":true,"type":"module","description":"First-party pm package for guide and shell completion workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-guide-shell"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","guide","completion","shell"],"pm":{"aliases":["guide-shell"],"extensions":["extensions/guide-shell"],"catalog":{"display_name":"Guide + Shell UX","category":"workflow","summary":"Restore guide documentation and shell completion commands as package-owned UX surfaces.","tags":["guide","completion","shell"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-guide-shell","version":"2026.10.20","private":true,"type":"module","description":"First-party pm package for guide and shell completion workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-guide-shell"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","guide","completion","shell"],"pm":{"aliases":["guide-shell"],"extensions":["extensions/guide-shell"],"catalog":{"display_name":"Guide + Shell UX","category":"workflow","summary":"Restore guide documentation and shell completion commands as package-owned UX surfaces.","tags":["guide","completion","shell"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-guide-shell","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-kanban/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-kanban","version":"2026.10.18","private":true,"type":"module","description":"First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-kanban"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","profile","archetype","kanban","exemplar"],"pm":{"aliases":["kanban"],"extensions":["extensions/kanban"],"catalog":{"display_name":"Kanban Archetype","category":"sdk","summary":"Installable Kanban continuous-flow archetype: Card item type, flow fields, and a ProjectProfileDefinition built on public SDK primitives.","tags":["sdk","profile","archetype","kanban","schema","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-kanban","version":"2026.10.20","private":true,"type":"module","description":"First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-kanban"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","sdk","profile","archetype","kanban","exemplar"],"pm":{"aliases":["kanban"],"extensions":["extensions/kanban"],"catalog":{"display_name":"Kanban Archetype","category":"sdk","summary":"Installable Kanban continuous-flow archetype: Card item type, flow fields, and a ProjectProfileDefinition built on public SDK primitives.","tags":["sdk","profile","archetype","kanban","schema","exemplar"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-kanban","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-lifecycle-hooks/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-lifecycle-hooks","version":"2026.10.18","private":true,"type":"module","description":"First-party pm package demonstrating safe lifecycle hook registration.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-lifecycle-hooks"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","hooks","lifecycle","sdk"],"pm":{"aliases":["lifecycle-hooks"],"extensions":["extensions/lifecycle-hooks"],"catalog":{"display_name":"Lifecycle Hooks","category":"sdk","summary":"Default-inert lifecycle hook exemplar for package authors.","tags":["hooks","lifecycle","sdk"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-lifecycle-hooks","version":"2026.10.20","private":true,"type":"module","description":"First-party pm package demonstrating safe lifecycle hook registration.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-lifecycle-hooks"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","hooks","lifecycle","sdk"],"pm":{"aliases":["lifecycle-hooks"],"extensions":["extensions/lifecycle-hooks"],"catalog":{"display_name":"Lifecycle Hooks","category":"sdk","summary":"Default-inert lifecycle hook exemplar for package authors.","tags":["hooks","lifecycle","sdk"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-lifecycle-hooks","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-linked-test-adapters/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-linked-test-adapters","version":"2026.10.18","private":true,"type":"module","description":"First-party pm package for optional linked-test run management adapters and reporters.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-linked-test-adapters"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","linked-tests","background-runs","test-runs"],"pm":{"aliases":["linked-test-adapters"],"extensions":["extensions/linked-test-adapters"],"catalog":{"display_name":"Linked Test Adapters","category":"testing","summary":"Restore optional linked-test run management/reporting command surfaces.","tags":["tests","linked-tests","background","reporting"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-linked-test-adapters","version":"2026.10.20","private":true,"type":"module","description":"First-party pm package for optional linked-test run management adapters and reporters.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-linked-test-adapters"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","linked-tests","background-runs","test-runs"],"pm":{"aliases":["linked-test-adapters"],"extensions":["extensions/linked-test-adapters"],"catalog":{"display_name":"Linked Test Adapters","category":"testing","summary":"Restore optional linked-test run management/reporting command surfaces.","tags":["tests","linked-tests","background","reporting"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-linked-test-adapters","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-search-advanced/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-search-advanced","version":"2026.10.18","private":true,"type":"module","description":"First-party pm package for semantic, hybrid, and reindex search workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-search-advanced"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","search","reindex","semantic","hybrid"],"pm":{"aliases":["search-advanced"],"extensions":["extensions/search-advanced"],"catalog":{"display_name":"Advanced Search","category":"search","summary":"Enable semantic/hybrid search modes and reindex workflows.","tags":["search","semantic","hybrid","reindex"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-search-advanced","version":"2026.10.20","private":true,"type":"module","description":"First-party pm package for semantic, hybrid, and reindex search workflows.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-search-advanced"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","search","reindex","semantic","hybrid"],"pm":{"aliases":["search-advanced"],"extensions":["extensions/search-advanced"],"catalog":{"display_name":"Advanced Search","category":"search","summary":"Enable semantic/hybrid search modes and reindex workflows.","tags":["search","semantic","hybrid","reindex"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-search-advanced","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}