@unbrained/pm-cli 2026.10.28 → 2026.10.31

package/docs/SDK.md

@@ -278,7 +278,17 @@ async function writePackageState(pmRoot: string, write: () => Promise<void>) {
 ```
 
 The built-in provider automatically recovers a provably dead original Linux
-owner before TTL. Unknown owners retain the existing lease policy. Conflicts
+owner before TTL, including an owner killed inside its commit fence. Recovery
+retains the gate generation as evidence so concurrent recoverers cannot
+remove its replacement, including recovery after the age grace when a dead PID
+or verified PID reuse establishes abandonment. A readable gate with a live PID
+and unavailable start identity is retained regardless of age. An unreadable
+gate owner is also retained; age and failed reads do not prove abandonment.
+Recorded host coordinates must be verified; a local PID comparison cannot
+authorize recovery of foreign or unverifiable host evidence.
+Acquisition, commit-gate and release wait budgets use
+a monotonic clock; wall-clock adjustments do not extend those budgets.
+Unknown owners retain the existing lease policy. Conflicts
 expose the lock identity, observed process state, `waited_ms`, observed
 `owner_handoffs` and wait advice through `PmCliError.context`. The wait budget
 is a fixed total by default. Pass `{ waitPolicy: "progress" }` in the options
@@ -453,15 +463,22 @@ Promoted Plan links retain their graph semantics: `depends_on` canonicalizes to
 
 ### Immutable history and rich item reads
 
-`runHistory(id, { compact: true }, global)` and `{ provenance: true }` return
-newest-first rows when no `limit` is supplied. The CLI and `runAction` history
-defaults use compact rows. The result declares `order` and a complete matching
-`total`; original row indices and durable versions stay unchanged. Apply the
-public read-output dimensions and carry `outputCursor` from their truncation
-receipt to traverse older entries. An explicit latest-entry `limit` retains
-chronological order, as do full SDK reads (`runHistory(id, {}, global)`) and
-`runAction` with `full: true`. Verification still consumes the full chain
-([pm-gh1605](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1605.toon); tracker record excluded from npm).
+`runHistory(id, { compact: true }, global)` and `{ provenance: true }` default
+to newest-first rows, with or without `limit`. Full SDK reads (`runHistory(id,
+{}, global)`) and `runAction` with `full: true` default to chronological rows.
+Set `order: "oldest_first"` or `order: "newest_first"` explicitly to use the same
+direction across every projection, including value diffs. `limit` selects the
+latest N matching entries before ordering; it never changes the direction.
+CLI and `runAction` defaults use compact rows. The result declares `order` and
+a complete matching `total`; physical indices and durable versions stay unchanged.
+Read-output continuations traverse the chosen order without changing it.
+Verification and value-diff reconstruction still consume the authoritative chain.
+
+Compatibility: compact/provenance reads with a limit previously returned
+chronological rows. Replay consumers must now request `order: "oldest_first"`
+(or CLI `--order oldest_first`) explicitly. Full reads retain their prior default.
+Tracked by [pm-gh1617](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1617.toon)
+(tracker record excluded from npm).
 
 Tracked: [pm-4a7m](../.agents/pm/features/pm-4a7m.toon),
 [pm-hib1](../.agents/pm/features/pm-hib1.toon),
@@ -668,7 +685,7 @@ import {
   parseMutationReceipt,
   estimatePmOutputTokens,
   resolvePmCommandOutputBudget,
-} from "@unbraind/pm-cli/sdk/contracts";
+} from "@unbrained/pm-cli/sdk/contracts";
 
 const compactRead = definePmCommandOutputBudget({
   command: "get",
@@ -1166,6 +1183,46 @@ recurrence reason, accepts only the workspace open or in-progress target, and
 returns the terminal evidence captured atomically before the update path clears
 it from active metadata.
 
+Literal mutation data and runtime value admission are tracked by
+[pm-gh1614](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1614.toon)
+and [pm-gh1606](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1606.toon)
+(repository-only tracker records excluded from npm).
+SDK `create`, `update`, and `append` inputs are data: `"-"` remains text,
+`"none"` and `"null"` remain text where the field's domain permits them, and
+`"@file"` remains text. These calls do not implicitly consume stdin or read a
+file. This also applies to the corresponding `runCreate`, `runUpdate`,
+`runAppend` operations and update-many mutation values. Normal field validation,
+whitespace handling, structured collection syntax, and project schemas still
+apply. Clear fields explicitly with `unset: ["assignee"]` or the declared
+`clear*` collection options; JavaScript `null` is not an unset directive.
+CLI adapters retain `--description -`, append stdin, file flags, and legacy
+clear-token compatibility. Values inside CLI `--stdin-json` documents are
+literal data, including `"none"` and `"null"`. Explicit CLI flags override
+document values and retain CLI interpretation, including legacy clear tokens.
+Use explicit clear/unset flags when the intent is to remove a field.
+
+Native create/update/reopen values are checked against the SDK-owned option contracts
+before normalization and writes. A malformed append body or option value throws
+`PmCliError` with `code: "invalid_argument_value"`, usage exit code 2, the
+affected `context.field`, corrective guidance, and `context.changed: false`.
+For example, `estimatedMinutes` requires `"45"`, while `priority` accepts a
+string or finite number. JavaScript and JSON bridge callers must correct invalid
+types instead of relying on coercion. Integrations that previously used `"-"`
+to request stdin should read that input themselves and pass the resulting text;
+integrations that used `"none"` to clear must migrate to `unset`.
+Direct `runCreate`/`runUpdate` calls require the declared string arrays for
+repeatable fields. Generic action dispatch retains its documented scalar-to-array
+normalization before invoking those operations.
+
+Adapter authors can import `withCliMutationInput` and
+`withLiteralMutationInput` from the SDK root or runtime entrypoint. Both return
+cloned option bags and collection values with an in-process input policy. Use
+the first only for explicit CLI parsing, and the second for decoded JSON or
+other literal data inside that adapter. Existing literal data and already-resolved stdin fields
+retain their policy through the clone; no marker is serialized into an item.
+Reusing a collection in a fresh CLI option bag does not inherit literal policy
+from another call or modify the caller's collection.
+
 Create focus policy is tracked by [pm-gh1577](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1577.toon)
 (this tracker record is repository-only and excluded from npm).
 Programmatic `create`, `PmClient.create`, `runCreate`, and MCP `pm_create`
@@ -1602,6 +1659,84 @@ the same durable coordinator, restoring annotations, linked artifacts,
 lifecycle fields, and claim ownership on failure. It is the SDK primitive
 behind `pm item complete`.
 
+Host-bound batch and recovery APIs are tracked by
+[pm-gh1598](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-gh1598.toon) and
+[pm-gh1597](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-gh1597.toon)
+(tracker records excluded from npm). A `PmClient` acquired from an
+extension host supports the same batch coordinator without reconstructing its
+tracker root or overriding the host author policy:
+
+```ts
+const plan = { transactionId: "sync-42", mutations };
+const preview = await client.previewItemMutations(plan);
+await client.commitItemMutations(plan);
+const receipt = await client.itemTransactions.status("sync-42");
+```
+
+Preview and status setup use configuration-only source reads, so activation
+does not open optional schema files before preview validates their storage.
+
+Each mutation in a newly staged batch contributes a `records` row with its
+original `index`, canonical `id`, operation, and full public `item` projection
+including body after the complete batch. Repeated targets therefore show the
+same final staged state. `execution` distinguishes a newly `applied` mutation
+from `adopted` existing state; adopted values do not certify the unused create
+options. `commit_time_fields` lists JSON pointers to potentially
+regenerated clocks, conservatively including existing or explicitly supplied
+clocks. These preview values are observations, not reserved commit values.
+Compare normalized intent separately from those clocks; commit still evaluates
+current state, attribution, extension policy and concurrency. A committed replay returns an empty
+`records` array, not a reconstruction of its original write values. While the
+committed journal is retained, replaying the identical plan performs no item
+write; changing its ordered payload under the same id refuses with
+`transaction_plan_mismatch`. If transaction GC removes that committed journal,
+the coordinator can treat its id as new; replay guarantees do not survive that
+removal.
+
+The workspace transaction lock serializes transaction coordinators. Ordinary
+SDK and CLI item writers can still interleave between a step's read and write;
+the lock does not provide a general read-decide-write critical section.
+
+New item journals retain their original mutation plan and compensation policy.
+History redaction does not rewrite transaction journals: values removed from
+item history can remain in interrupted or abandoned journals. GC retains those
+recovery receipts. Do not include secrets in batch mutations.
+The status receipt contains the validated journal and a SHA-256 `planDigest`
+over its ordered payload-bound step identifiers. Started/completed lists report
+persisted coordinator progress: a crash after apply but before recording can
+leave an applied step listed only as started. Recovery re-inspects durable item
+history before compensation. No retained journal returns `undefined`; corrupt
+journals refuse instead of appearing absent.
+
+```ts
+await client.itemTransactions.supersede("interrupted-sync", "sync-43", {
+  reason: "Re-plan against the current item revision",
+});
+// Read current items and build the replacement only after retirement succeeds.
+await client.commitItemMutations({ transactionId: "sync-43", mutations: replanned });
+```
+
+`abandon(id, { reason })` durably fences forward replay before compensating
+interrupted owned effects in reverse order,
+records a workspace audit event, and marks the identity `abandoned`. Retirement
+upgrades the journal to schema version 2 so older coordinators refuse the pending
+intent instead of silently resuming it.
+`supersede(id, newId, { reason })` performs that retirement and records the
+replacement identity; it does not atomically commit the replacement plan or
+reserve its id. Repeating the same retirement is idempotent. Committed journals
+cannot be abandoned. A pending-retirement refusal keeps the
+`transaction_abandoned` code, reports `retirement.state: "pending"` and the
+recorded `superseded_by` value (`null` for abandonment without a replacement),
+and explains how to retry the original intent. Finish that retirement before
+re-planning. During compensation, a later peer edit refuses with
+`transaction_partial_mutation` and retains recovery data; it is never silently
+overwritten. Legacy journals without a retained item plan require the original
+plan and adapter for replay. Abandoned receipts remain retained by transaction
+GC, including pending retirement intents, so their identities cannot silently
+become reusable. Mutation inputs are copied before coordinator admission; later
+caller edits cannot change the payload whose identity and recovery plan were
+recorded.
+
 `previewItemMutations` validates an ordered plan with the same transaction
 coordinator and lifecycle primitives as apply, using a disposable copy of the
 tracker. Earlier staged creates, evidence updates and closures participate in
@@ -1915,6 +2050,19 @@ contract compact and fail-safe for newly added flags. Use
 package-authored query surface. `encodeQueryCursor`, `decodeQueryCursorState`, and
 `paginateQueryRows` remain the transport-neutral continuation primitives.
 
+A flag with a closed value domain declares it in `CliFlagContract.values`. For
+example, `get` and `context` declare `--depth brief|standard|deep|full`, and
+`plan` declares `--depth brief|standard|deep`, so `pm contracts --command <c>
+--flags-only --json` shows the accepted spellings without parsing help prose.
+`resolveReadCompletenessControls(command)` combines that domain with the
+command's read-output projection modes. `resolveReadOptionRetryArgs` uses the
+result to correct a completeness spelling only into a flag the attempted
+command declares
+([pm-gh1626](../.agents/pm/issues/pm-gh1626.toon)). A flag that accepts a
+comma-separated value list declares `list: true`. `--unset` on create, update
+and update-many does, so repeated flags and comma lists reach the parser as the
+same field set ([pm-gh1633](../.agents/pm/issues/pm-gh1633.toon)).
+
 `decodeQueryCursorEnvelope`, `decodeQueryCursorState`, and
 `resolveQueryCursorStart` accept an optional final `cursorFlag` argument
 (`"--after"`, the default, or `"--cursor"`) so package-authored queries can
@@ -2216,6 +2364,13 @@ const signalRead = await store.readOrRebuild(itemsFromDerivedIndex, {
 const report = await scoreContextCandidates(signalRead.candidates);
 ```
 
+`pm next` applies a ranking policy after scoring: `priority_floor` (the
+default, from `context.next_ranking_policy` or the `rankingPolicy` option)
+resumes in-progress work, then orders by priority tier with relevance inside a
+tier; `weighted` keeps the blended score order. The response discloses it as
+`filters.ranking_policy`, and the recommendation reasons name the disagreement
+when the score leader differs from the recommendation (GH-1618).
+
 Use `--explain-ranking --json` on `pm context` or `pm next` to include the model,
 available signals, baseline rank, final rank, score, and per-signal
 contributions. Explanation data is opt-in so default agent output stays bounded.
@@ -2724,6 +2879,19 @@ delivered to the registered positional arguments unchanged.
 
 ## Output Ownership
 
+Unicode output policy ([pm-gh1624](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1624.toon), tracker record excluded from npm):
+the built-in JSON and TOON formatters refuse unpaired UTF-16 surrogates in
+structured output values or object keys with `text_unpaired_surrogate` and a
+field path. Custom `toJSON()` values and boxed primitives are materialized once
+per render using their native JSON semantics; the resulting snapshot is validated
+and shared by both formatters. Valid astral characters and caller data are preserved. Extension
+producers can call `assertWellFormedOutputText(value)` before returning
+JSON-compatible data. When replacing malformed external text is intentional,
+use `toWellFormedText(text)` from `@unbrained/pm-cli/sdk/core` (also available from
+`@unbrained/pm-cli/sdk`); it replaces lone
+surrogates with U+FFFD without splitting valid pairs. Apply normalization before
+constructing object keys so the producer can handle possible key collisions.
+
 Command handlers should normally return structured data and let the host select
 TOON, JSON, service, or registered renderer output. A renderer override returns a
 string when it owns the matching payload and `null` to fall back to native
@@ -2790,6 +2958,34 @@ A typo fails activation with a did-you-mean hint (e.g. `type: "strnig"` →
 `Did you mean "string"?`) instead of silently passing and failing opaquely at use
 time.
 
+## Package Error Provenance
+
+Expected package errors retain their structured `context` across separately
+bundled SDK copies. Use `createPmCliExpectedError` to declare an expected refusal.
+A custom exception carrying only `code`, `exitCode: 1` and `remediation` remains
+an unexpected fault. Sentry error attribution uses the same bounded source
+context as telemetry without requiring telemetry delivery or command tracing, with host version
+and the registered command owner's manifest version. Noninteractive traffic
+uses `automation`; explicit `test`/`dogfood` contexts retain their own environments.
+Error events and usage logs tagged `user` use `production`, including when CI was inferred at initialization.
+Early errors retain `--json` and `--quiet` automation attribution. Original
+extension causes remain available locally through the SDK; Sentry's extra error
+data integration does not copy cause payload fields into diagnostic contexts.
+Explicit `SENTRY_ENVIRONMENT`, consent and test isolation remain authoritative.
+Sequential commands clear previous extension attribution. Tracked by
+[pm-gh1625](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1625.toon)
+(tracker record excluded from npm).
+
+`resolveTelemetrySourceAttribution(options?, env?, interactive?)` exposes that
+same pure attribution policy to custom SDK hosts without reading configuration,
+creating an installation identity, or sending data. Expected refusals use
+`createPmCliExpectedError`; unexpected handler failures retain their original
+non-enumerable `cause` in `CommandHandlerResult` and become
+`ExtensionCommandError` in the CLI host. The host preserves structured diagnostics
+and reports these faults as exceptions. An exception name alone cannot declare
+an expected refusal when the original error violates the public contract.
+SDK extension actions and delegated template reads retain the same failure kind.
+
 ## Expected CLI Errors
 
 `resolveLifecycleVerbRecovery(verb, availablePaths)` returns explicit argument

package/docs/TESTING.md

@@ -58,6 +58,14 @@ node scripts/run-tests.mjs test
 node scripts/run-tests.mjs coverage
 ```
 
+The Linux killed-owner integration suite always exercises Node. Its additional
+Bun case runs locally when `bun --version` succeeds; CI requires Bun and retains
+the case even when the executable is missing, so a broken CI setup fails visibly.
+Install Bun before claiming local Node-and-Bun recovery coverage. This fixture
+policy is tracked by
+[pm-gh1609](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1609.toon)
+(repository tracker record excluded from npm).
+
 For the exact ordered local preflight used to make release-readiness claims,
 run the registry-owned entrypoint:
 
@@ -80,6 +88,14 @@ 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).
 
+The same cohort runs the complete cold transport-floor and executable refusal
+gate fixture files after parallel contracts
+([pm-serial-cold-gates](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-serial-cold-gates.toon),
+a repository-only tracker record excluded from npm). Their original 30-second
+and 360-second test deadlines, assertions, negative controls, retries, and product
+benchmark thresholds are unchanged. Isolated passes qualify this allocation;
+they do not establish passing product latency or replace complete-suite proof.
+
 The same serial cohort runs the ten-thousand-item aggregation, cold governance
 read, and surface-replication fixture files after parallel contracts
 ([pm-ckb8w5](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-ckb8w5.toon),
@@ -256,6 +272,26 @@ node scripts/run-tests.mjs test -- tests/integration/cli.integration.spec.ts
 
 Use focused runs while iterating, then run coverage before closure when risk or scope warrants it.
 
+## CI Job Layout and Runner Budget
+
+Every pull-request push draws from the account-wide hosted-runner pool (20
+concurrent jobs, 5 on macOS, shared by every repository on the account), so the
+required CI asks for as few runners as the proofs allow
+([pm-m6ig79](../.agents/pm/issues/pm-m6ig79.toon)):
+
+| Job | Runs |
+| --- | --- |
+| `Build foundation (Ubuntu, Node 24)` | Build, `dist` artifact, packed tarball. |
+| `Packed runtime (<os>)` × 3 | Packed first run on Node 22.18.0 and 24 in isolated prefixes, dist version smoke; Ubuntu adds the Node 22 telemetry and snapshot regressions, macOS the native shell and portability checks, Windows the full npm npx and Bun bunx acceptance. |
+| `Gates (static)` | Typecheck, version, changelog, secret scan, `pnpm lint` (`quality:static`), package artifact, token budgets, tracker merge-safety and assurance gates. |
+| `Gates (smokes)` | Shell completion, npx/plugin smokes, host isolation, context evaluation, compatibility migration and published workspace compatibility. |
+| `Coverage shard N/4` × 4, `Gates (coverage)` | Sharded coverage, then the merged 100% threshold. |
+| `Windows regression cohort` × 3, `Windows regression (Node 24)` | Script and native Windows cohorts, all running at once, then their aggregate. |
+
+Add a proof as a step inside the job that owns its platform and runtime rather
+than as a new job: a sub-minute job still waits in the shared queue before it
+starts.
+
 ## CI Retry and Timeout Diagnostics
 
 The required `Gates (coverage)` job runs after the coverage matrix settles and
@@ -751,8 +787,9 @@ pm test <item-id> --run --workspace-context snapshot --override-linked-workspace
   Node 24 releases retain the same dangling-link behavior; the async `stat`
   `throwIfNoEntry` option was added in
   [Node 24.15](https://nodejs.org/download/release/v24.20.0/docs/api/fs.html#fspromisesstatpath-options).
-  The real filesystem and CLI snapshot suite runs in the required Node 22
-  telemetry regression job and native Windows regression job before merge.
+  The real filesystem and CLI snapshot suite runs on Node 22 in the required
+  `Packed runtime (ubuntu-latest)` job and in the native Windows regression job
+  before merge.
 
   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
@@ -870,6 +907,13 @@ pm test <item-id> --run --only-index 2
 pm test <item-id> --run --only-last
 ```
 
+A selective run's receipt lists only the tests it selected. When the
+receipt includes `tests_omitted`, copy and run the complete
+`tests_omitted.restore_with` command to read the whole stored collection. It
+keeps the invocation's `--pm-path` (including a tracker chosen through
+`PM_PATH`) and `--no-extensions`, which a bare `pm test <item-id> --list` would
+drop.
+
 Linked-command stdout and stderr are captured through temporary regular files,
 then read back with the 20 MiB per-stream retention bound. This keeps inherited
 descriptors blocking for Bun, Rust, and other runtimes that treat `EAGAIN` on a

package/docs/agent-task-token-baseline.json

@@ -1 +1 @@
-{"version":5,"transcript_version":2,"transcript_digest":"sha256:83d4523ca528ad5e8801cf5c7c02dcebbf2b87dc72422d4b8e648755dcdc36c2","estimator":"ceil(utf8_bytes / 4)","comparison_scope":"plan_recovery_tracker_root_canonicalized","measurement_scope":"output_before_token_accounting","published_with_release":true,"orientation":{"canonical_task_id":"orientation-context-intent","required_capabilities":["actionable_work","active_ownership","workspace_state"],"measured_winner_tokens":1087,"protocols":[{"task_id":"orientation-context-intent","command_count":1,"estimated_tokens":1087,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"context","field_path":"hierarchy"}],"active_ownership":[{"step_id":"context","field_path":"activity"}],"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}]}},{"task_id":"orientation-operating-rules","command_count":4,"estimated_tokens":2139,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"open","field_path":"items"}],"active_ownership":[{"step_id":"in-progress","field_path":"items"}],"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}]}},{"task_id":"orientation-contracts-next","command_count":2,"estimated_tokens":5203,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"next","field_path":"recommended.id"}],"active_ownership":[{"step_id":"next","field_path":"held_by_others"}],"workspace_state":[{"step_id":"next","field_path":"summary.in_progress"}]}}]},"tasks":[{"id":"orientation-context-intent","max_estimated_tokens":1087,"steps":[{"id":"context","max_estimated_tokens":1087,"accounting_mode":"self_reported"}]},{"id":"orientation-contracts-next","max_estimated_tokens":5203,"steps":[{"id":"contracts","max_estimated_tokens":4481,"accounting_mode":"self_reported"},{"id":"next","max_estimated_tokens":722,"accounting_mode":"self_reported"}]},{"id":"orientation-operating-rules","max_estimated_tokens":2139,"steps":[{"id":"context","max_estimated_tokens":1087,"accounting_mode":"self_reported"},{"id":"search","max_estimated_tokens":164,"accounting_mode":"self_reported"},{"id":"open","max_estimated_tokens":712,"accounting_mode":"self_reported"},{"id":"in-progress","max_estimated_tokens":176,"accounting_mode":"self_reported"}]},{"id":"context-bootstrap","max_estimated_tokens":2077,"steps":[{"id":"triage","max_estimated_tokens":619,"accounting_mode":"self_reported"},{"id":"orient","max_estimated_tokens":1087,"accounting_mode":"self_reported"},{"id":"inspect","max_estimated_tokens":371,"accounting_mode":"self_reported"}]},{"id":"closed-domain-recovery","max_estimated_tokens":630,"steps":[{"id":"refuse-intent","max_estimated_tokens":259,"accounting_mode":"self_reported"},{"id":"retry-intent","max_estimated_tokens":371,"accounting_mode":"self_reported"}]},{"id":"unknown-option-recovery","max_estimated_tokens":596,"steps":[{"id":"refuse-option","max_estimated_tokens":433,"accounting_mode":"self_reported"},{"id":"retry-option","max_estimated_tokens":163,"accounting_mode":"self_reported"}]},{"id":"lifecycle-mutation","max_estimated_tokens":888,"steps":[{"id":"create","max_estimated_tokens":20,"accounting_mode":"self_reported"},{"id":"inspect-open","max_estimated_tokens":363,"accounting_mode":"self_reported"},{"id":"close","max_estimated_tokens":107,"accounting_mode":"self_reported"},{"id":"inspect-closed","max_estimated_tokens":398,"accounting_mode":"self_reported"}]},{"id":"bulk-effect-outcomes","max_estimated_tokens":406,"steps":[{"id":"create-bulk-target","max_estimated_tokens":20,"accounting_mode":"self_reported"},{"id":"partial-effect","max_estimated_tokens":254,"accounting_mode":"self_reported"},{"id":"no-effect","max_estimated_tokens":132,"accounting_mode":"self_reported"}]},{"id":"plan-execution-mutations","max_estimated_tokens":806,"steps":[{"id":"create-plan","max_estimated_tokens":21,"accounting_mode":"self_reported"},{"id":"add-step","max_estimated_tokens":254,"accounting_mode":"self_reported"},{"id":"complete-step","max_estimated_tokens":253,"accounting_mode":"self_reported"},{"id":"inspect-plan","max_estimated_tokens":278,"accounting_mode":"self_reported"}]}],"composite_max_estimated_tokens":13832}
+{"version":5,"transcript_version":2,"transcript_digest":"sha256:83d4523ca528ad5e8801cf5c7c02dcebbf2b87dc72422d4b8e648755dcdc36c2","estimator":"ceil(utf8_bytes / 4)","comparison_scope":"plan_recovery_tracker_root_canonicalized","measurement_scope":"output_before_token_accounting","published_with_release":true,"orientation":{"canonical_task_id":"orientation-context-intent","required_capabilities":["actionable_work","active_ownership","workspace_state"],"measured_winner_tokens":1051,"protocols":[{"task_id":"orientation-context-intent","command_count":1,"estimated_tokens":1051,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"context","field_path":"hierarchy"}],"active_ownership":[{"step_id":"context","field_path":"activity"}],"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}]}},{"task_id":"orientation-operating-rules","command_count":4,"estimated_tokens":2067,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"open","field_path":"items"}],"active_ownership":[{"step_id":"in-progress","field_path":"items"}],"workspace_state":[{"step_id":"context","field_path":"summary.active_items"}]}},{"task_id":"orientation-contracts-next","command_count":2,"estimated_tokens":5213,"capabilities":["actionable_work","active_ownership","workspace_state"],"capability_evidence":{"actionable_work":[{"step_id":"next","field_path":"recommended.id"}],"active_ownership":[{"step_id":"next","field_path":"held_by_others"}],"workspace_state":[{"step_id":"next","field_path":"summary.in_progress"}]}}]},"tasks":[{"id":"orientation-context-intent","max_estimated_tokens":1051,"steps":[{"id":"context","max_estimated_tokens":1051,"accounting_mode":"self_reported"}]},{"id":"orientation-contracts-next","max_estimated_tokens":5213,"steps":[{"id":"contracts","max_estimated_tokens":4481,"accounting_mode":"self_reported"},{"id":"next","max_estimated_tokens":732,"accounting_mode":"self_reported"}]},{"id":"orientation-operating-rules","max_estimated_tokens":2067,"steps":[{"id":"context","max_estimated_tokens":1015,"accounting_mode":"self_reported"},{"id":"search","max_estimated_tokens":164,"accounting_mode":"self_reported"},{"id":"open","max_estimated_tokens":712,"accounting_mode":"self_reported"},{"id":"in-progress","max_estimated_tokens":176,"accounting_mode":"self_reported"}]},{"id":"context-bootstrap","max_estimated_tokens":2005,"steps":[{"id":"triage","max_estimated_tokens":619,"accounting_mode":"self_reported"},{"id":"orient","max_estimated_tokens":1015,"accounting_mode":"self_reported"},{"id":"inspect","max_estimated_tokens":371,"accounting_mode":"self_reported"}]},{"id":"closed-domain-recovery","max_estimated_tokens":630,"steps":[{"id":"refuse-intent","max_estimated_tokens":259,"accounting_mode":"self_reported"},{"id":"retry-intent","max_estimated_tokens":371,"accounting_mode":"self_reported"}]},{"id":"unknown-option-recovery","max_estimated_tokens":596,"steps":[{"id":"refuse-option","max_estimated_tokens":433,"accounting_mode":"self_reported"},{"id":"retry-option","max_estimated_tokens":163,"accounting_mode":"self_reported"}]},{"id":"lifecycle-mutation","max_estimated_tokens":873,"steps":[{"id":"create","max_estimated_tokens":20,"accounting_mode":"self_reported"},{"id":"inspect-open","max_estimated_tokens":363,"accounting_mode":"self_reported"},{"id":"close","max_estimated_tokens":92,"accounting_mode":"self_reported"},{"id":"inspect-closed","max_estimated_tokens":398,"accounting_mode":"self_reported"}]},{"id":"bulk-effect-outcomes","max_estimated_tokens":392,"steps":[{"id":"create-bulk-target","max_estimated_tokens":20,"accounting_mode":"self_reported"},{"id":"partial-effect","max_estimated_tokens":240,"accounting_mode":"self_reported"},{"id":"no-effect","max_estimated_tokens":132,"accounting_mode":"self_reported"}]},{"id":"plan-execution-mutations","max_estimated_tokens":806,"steps":[{"id":"create-plan","max_estimated_tokens":21,"accounting_mode":"self_reported"},{"id":"add-step","max_estimated_tokens":254,"accounting_mode":"self_reported"},{"id":"complete-step","max_estimated_tokens":253,"accounting_mode":"self_reported"},{"id":"inspect-plan","max_estimated_tokens":278,"accounting_mode":"self_reported"}]}],"composite_max_estimated_tokens":13633}

package/docs/generated/FLAG_LEXICON_BUDGETS.md

@@ -32,7 +32,7 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | `duplicates` | context | 25 | 25 |
 | `eval` | context | 25 | 25 |
 | `next` | context | 38 | 38 |
-| `history` | evidence | 35 | 35 |
+| `history` | evidence | 36 | 36 |
 | `events` | evidence | 34 | 34 |
 | `history-attest` | evidence | 23 | 23 |
 | `history-redact` | evidence | 27 | 27 |

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: 431
+- Catalog error codes: 434
 - 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: 412
-- Coverage fraction: 0.044084
+- Uncovered error codes: 415
+- Coverage fraction: 0.043779
 - Closed-domain probes: 19
 - Grammar probes: 117
 
@@ -349,6 +349,8 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `tracker_root_missing` | `tracker_root_missing` | executable | owned_state | 1 |
 | `tracker_root_not_directory` | `tracker_root_not_directory` | executable | owned_state | 1 |
 | `tracker_root_unreadable` | `tracker_root_unreadable` | executable | owned_state | 1 |
+| `transaction_abandoned` | `transaction_abandoned` | uncovered | none | 0 |
+| `transaction_committed` | `transaction_committed` | uncovered | none | 0 |
 | `transaction_create_compensated` | `transaction_create_compensated` | uncovered | none | 0 |
 | `transaction_journal_invalid` | `transaction_journal_invalid` | uncovered | none | 0 |
 | `transaction_partial_mutation` | `transaction_partial_mutation` | uncovered | none | 0 |
@@ -356,6 +358,7 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `transaction_preview_external_schema` | `transaction_preview_external_schema` | uncovered | none | 0 |
 | `transaction_preview_non_regular_file` | `transaction_preview_non_regular_file` | uncovered | none | 0 |
 | `transaction_preview_snapshot_changed` | `transaction_preview_snapshot_changed` | uncovered | none | 0 |
+| `transaction_recovery_plan_missing` | `transaction_recovery_plan_missing` | uncovered | none | 0 |
 | `type_duplicate` | `type_duplicate` | uncovered | none | 0 |
 | `type_invalid` | `type_invalid` | uncovered | none | 0 |
 | `undeclared_observation` | `undeclared_observation` | 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.28","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.28","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.31","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.31","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.28",
+  "version": "2026.10.31",
   "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.28","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.31","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/extensions/calendar/index.ts

@@ -20,6 +20,7 @@ const CALENDAR_VIEW_NAMES = ["agenda", "day", "week", "month"] as const;
 // not leak into Sentry as crashes.
 class PmCliError extends Error {
   exitCode: number;
+  context: Record<string, unknown> = {};
   constructor(message: string, exitCode: number) {
     super(message);
     this.name = "PmCliError";

package/packages/pm-calendar/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-calendar","version":"2026.10.28","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.31","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.28","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.31","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.28","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.31","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.28","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.31","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.28","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.31","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.28","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.31","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.28","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.31","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.28","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.31","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.28","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.31","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"]}}

package/packages/pm-templates/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-templates","version":"2026.10.28","private":true,"type":"module","description":"First-party pm package for reusable create templates.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-templates"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","templates"],"pm":{"aliases":["templates"],"extensions":["extensions/templates"],"catalog":{"display_name":"Create Templates","category":"workflow","summary":"Save, list, show, and apply reusable pm create option templates.","tags":["templates","create","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-templates","version":"2026.10.31","private":true,"type":"module","description":"First-party pm package for reusable create templates.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-templates"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","templates"],"pm":{"aliases":["templates"],"extensions":["extensions/templates"],"catalog":{"display_name":"Create Templates","category":"workflow","summary":"Save, list, show, and apply reusable pm create option templates.","tags":["templates","create","workflow"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-templates","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}

package/packages/pm-todos/package.json

@@ -1 +1 @@
-{"name":"@unbrained/pm-todos","version":"2026.10.28","private":true,"type":"module","description":"First-party pm package for Todo markdown import and export.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-todos"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","todos"],"pm":{"aliases":["todos"],"extensions":["extensions/todos"],"catalog":{"display_name":"Todos Import/Export","category":"migration","summary":"Import and export Todo markdown tasks through pm package commands.","tags":["migration","todos","import","export"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}
+{"name":"@unbrained/pm-todos","version":"2026.10.31","private":true,"type":"module","description":"First-party pm package for Todo markdown import and export.","homepage":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":{"type":"git","url":"git+https://github.com/unbraind/pm-cli.git","directory":"packages/pm-todos"},"bugs":{"url":"https://github.com/unbraind/pm-cli/issues"},"keywords":["pm-package","project-management","todos"],"pm":{"aliases":["todos"],"extensions":["extensions/todos"],"catalog":{"display_name":"Todos Import/Export","category":"migration","summary":"Import and export Todo markdown tasks through pm package commands.","tags":["migration","todos","import","export"],"links":{"docs":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme","repository":"https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos","report":"https://github.com/unbraind/pm-cli/issues"}},"docs":["README.md"],"examples":["README.md"]}}