npm - @unbrained/pm-cli - Versions diffs - 2026.11.4 → 2026.11.5 - Mend

@unbrained/pm-cli 2026.11.4 → 2026.11.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (219) hide show

package/.agents/skills/HARNESS_COMPATIBILITY.md CHANGED Viewed

@@ -15,7 +15,7 @@ Use the same low-token route in every harness:
 ## Harness Mapping
 | Harness need | Preferred prompt/doc entrypoint | Skill route |
-|--------------|----------------------------------|-------------|
+|---|---|---|
 | Development loop | `AGENTS.md` + optional `pm guide workflows` | `.agents/skills/pm-developer/SKILL.md` |
 | User/operator workflow | repository docs + optional `pm guide quickstart` | `.agents/skills/pm-user/SKILL.md` |
 | Package authoring | repository docs + optional `pm guide extensions` | `.agents/skills/pm-extensions/SKILL.md` |

package/.agents/skills/README.md CHANGED Viewed

@@ -7,27 +7,27 @@ at runtime from contracts rather than copied into prose that can drift.
 ## Load Order
-| Tier | Source                                 | Typical cost | Staleness risk |
-| ---- | -------------------------------------- | ------------ | -------------- |
-| 0    | `SKILL.md`                             | ~650 tok     | Gated          |
-| 1    | `pm next`, `pm context`, `pm search`   | ~0.5-2.5k    | None (live)    |
-| 2    | `pm contracts ...`, `pm <cmd> --help --json` | ~1-3.4k | None (generated) |
-| 2    | `pm guide <topic> --depth brief`       | ~0.6-1k      | Gated          |
-| 3    | `references/*.md`                      | ~0.3-1k each | Gated          |
-| 4    | `docs/*.md`                            | 0.7k-45k     | Gated          |
+| Tier | Source | Typical cost | Staleness risk |
+|---|---|---|---|
+| 0 | `SKILL.md` | ~650 tok | Gated |
+| 1 | `pm next`, `pm context`, `pm search` | ~0.5-2.5k | None (live) |
+| 2 | `pm contracts ...`, `pm <cmd> --help --json` | ~1-3.4k | None (generated) |
+| 2 | `pm guide <topic> --depth brief` | ~0.6-1k | Gated |
+| 3 | `references/*.md` | ~0.3-1k each | Gated |
+| 4 | `docs/*.md` | 0.7k-45k | Gated |
 Never load a tier-4 document whole when a reference routes into a section of
 it. `docs/COMMANDS.md` is ~29k tokens and `docs/SDK.md` is ~45k.
 ## Bundles
-| Skill                             | Use when                                              |
-| --------------------------------- | ------------------------------------------------------ |
-| [`pm-developer`](pm-developer/SKILL.md) | Changing code, docs, tests, or release gates      |
+| Skill | Use when |
+|---|---|
+| [`pm-developer`](pm-developer/SKILL.md) | Changing code, docs, tests, or release gates |
 | [`pm-test-audit`](pm-test-audit/SKILL.md) | Writing, reviewing, or auditing tests and their regression value |
-| [`pm-user`](pm-user/SKILL.md)     | Intake, triage, prioritization, planning, reporting    |
-| [`pm-extensions`](pm-extensions/SKILL.md) | Package and extension lifecycle and authoring  |
-| [`pm-sdk`](pm-sdk/SKILL.md)       | Integrations, embedding, and domain packs on the SDK   |
+| [`pm-user`](pm-user/SKILL.md) | Intake, triage, prioritization, planning, reporting |
+| [`pm-extensions`](pm-extensions/SKILL.md) | Package and extension lifecycle and authoring |
+| [`pm-sdk`](pm-sdk/SKILL.md) | Integrations, embedding, and domain packs on the SDK |
 Harness-specific bundles ship with the plugins under `plugins/pm-claude/skills`
 and `plugins/pm-codex/skills`; they route to the same guide topics and

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

@@ -19,14 +19,14 @@ recorded in an append-only history stream.
 Load only the tier the task needs. Costs are measured, not estimated.
-| Tier | Load                                          | Cost      | When                                     |
-| ---- | --------------------------------------------- | --------- | ---------------------------------------- |
-| 0    | This file                                     | ~650 tok  | Always.                                  |
-| 1    | `pm next` or `pm context --limit 10`          | ~2.1-2.5k | Pick or resume work.                     |
-| 2    | `pm contracts --command <cmd> --flags-only`   | ~1-3.4k   | Exact flags for one command.             |
-| 2    | `pm guide <topic> --depth brief`              | ~0.6-1k   | A capability family you have not used.   |
-| 3    | `references/*.md` below                       | ~0.3-1k   | Repeatable procedure detail.             |
-| 4    | `docs/*.md`                                   | 0.7k-45k  | Only when a reference routes you there.  |
+| Tier | Load | Cost | When |
+|---|---|---|---|
+| 0 | This file | ~650 tok | Always. |
+| 1 | `pm next` or `pm context --limit 10` | ~2.1-2.5k | Pick or resume work. |
+| 2 | `pm contracts --command <cmd> --flags-only` | ~1-3.4k | Exact flags for one command. |
+| 2 | `pm guide <topic> --depth brief` | ~0.6-1k | A capability family you have not used. |
+| 3 | `references/*.md` below | ~0.3-1k | Repeatable procedure detail. |
+| 4 | `docs/*.md` | 0.7k-45k | Only when a reference routes you there. |
 Never load `docs/COMMANDS.md` (~29k) or `docs/SDK.md` (~45k) whole. Both are
 routed into by section from the references below.
@@ -121,11 +121,11 @@ Repository-wide gates before proposing a merge: `pnpm quality:static`.
 ## References
-| Need                                             | Load                                                     | Cost     |
-| ------------------------------------------------ | -------------------------------------------------------- | -------- |
-| Command recipes for the developer loop            | [Command playbook](references/COMMAND_PLAYBOOK.md)        | ~275 tok |
-| Prompt templates                                  | [Prompts](references/PROMPTS.md)                          | ~250 tok |
-| Bounded reads, cursors, projections, receipts     | [Token budgets](references/TOKEN_BUDGETS.md)              | ~900 tok |
-| Typed edges, traversal, planning analytics        | [Relationship graph](references/GRAPH_AND_RELATIONSHIPS.md) | ~900 tok |
-| Branching, merging, concurrent agents             | [Multi-agent and merge](references/MULTI_AGENT_MERGE.md)  | ~800 tok |
-| Composing pm with grep, jq, xargs, and scripts    | [Scripting](references/SCRIPTING_COMPOSITION.md)          | ~800 tok |
+| Need | Load | Cost |
+|---|---|---|
+| Command recipes for the developer loop | [Command playbook](references/COMMAND_PLAYBOOK.md) | ~275 tok |
+| Prompt templates | [Prompts](references/PROMPTS.md) | ~250 tok |
+| Bounded reads, cursors, projections, receipts | [Token budgets](references/TOKEN_BUDGETS.md) | ~900 tok |
+| Typed edges, traversal, planning analytics | [Relationship graph](references/GRAPH_AND_RELATIONSHIPS.md) | ~900 tok |
+| Branching, merging, concurrent agents | [Multi-agent and merge](references/MULTI_AGENT_MERGE.md) | ~800 tok |
+| Composing pm with grep, jq, xargs, and scripts | [Scripting](references/SCRIPTING_COMPOSITION.md) | ~800 tok |

package/.agents/skills/pm-developer/references/GRAPH_AND_RELATIONSHIPS.md CHANGED Viewed

@@ -13,20 +13,20 @@ Authoritative at runtime:
 pm contracts --json --full --output-budget unbounded | jq '.relationship_kind_contracts'
 ```
-| Kind              | Meaning                                        | Ordering | Hierarchy |
-| ----------------- | ---------------------------------------------- | -------- | --------- |
-| `parent`          | This item belongs under that one                | no       | yes       |
-| `child`           | Inverse of `parent`                             | no       | yes       |
-| `blocked_by`      | This item waits for that one                    | yes      | no        |
-| `blocks`          | Inverse of `blocked_by`                         | yes      | no        |
-| `implements`      | This item realizes that goal, story, or ADR     | no       | no        |
-| `verifies`        | This item proves that one behaves as claimed    | no       | no        |
-| `discovered_from` | This item was found while doing that one        | no       | no        |
-| `incident_from`   | This item originates in that recorded incident  | no       | no        |
-| `supersedes`      | This item replaces that one                     | no       | no        |
-| `recurs_from`     | This defect recurs from that closed one         | no       | no        |
-| `commits_to`      | This item lands in that changeset or release    | yes      | no        |
-| `related`         | Associative, non-directional                    | no       | no        |
+| Kind | Meaning | Ordering | Hierarchy |
+|---|---|---|---|
+| `parent` | This item belongs under that one | no | yes |
+| `child` | Inverse of `parent` | no | yes |
+| `blocked_by` | This item waits for that one | yes | no |
+| `blocks` | Inverse of `blocked_by` | yes | no |
+| `implements` | This item realizes that goal, story, or ADR | no | no |
+| `verifies` | This item proves that one behaves as claimed | no | no |
+| `discovered_from` | This item was found while doing that one | no | no |
+| `incident_from` | This item originates in that recorded incident | no | no |
+| `supersedes` | This item replaces that one | no | no |
+| `recurs_from` | This defect recurs from that closed one | no | no |
+| `commits_to` | This item lands in that changeset or release | yes | no |
+| `related` | Associative, non-directional | no | no |
 `related` carries the least information. Prefer a typed kind whenever one
 applies — `discovered_from`, `implements`, and `verifies` are the three that

package/.agents/skills/pm-developer/references/SCRIPTING_COMPOSITION.md CHANGED Viewed

@@ -5,16 +5,16 @@
 ## Exit Codes Are Part Of The Answer
-| Exit | Meaning                                   | Response                            |
-| ---- | ----------------------------------------- | ----------------------------------- |
-| 0    | Completed (a read may return zero rows)   | Parse stdout.                       |
-| 1    | Runtime failure                           | Preserve stderr and stop.           |
-| 2    | Invalid flags or composition              | Fix the invocation; do not retry.   |
-| 3    | Tracker or resource not found             | Fix the path or id.                 |
-| 4    | State or concurrency conflict             | Refresh live state, then decide.    |
-| 5    | A dependency operation failed             | Inspect dependency evidence.        |
-| 6    | Succeeded, matched nothing to change      | Success. Inspect the receipt.       |
-| 7    | Succeeded, changed part of the selection  | Success. Inspect unmatched rows.    |
+| Exit | Meaning | Response |
+|---|---|---|
+| 0 | Completed (a read may return zero rows) | Parse stdout. |
+| 1 | Runtime failure | Preserve stderr and stop. |
+| 2 | Invalid flags or composition | Fix the invocation; do not retry. |
+| 3 | Tracker or resource not found | Fix the path or id. |
+| 4 | State or concurrency conflict | Refresh live state, then decide. |
+| 5 | A dependency operation failed | Inspect dependency evidence. |
+| 6 | Succeeded, matched nothing to change | Success. Inspect the receipt. |
+| 7 | Succeeded, changed part of the selection | Success. Inspect unmatched rows. |
 `0`, `6`, and `7` are all success. A bare `if pm ...; then` treats `6` and `7`
 as failure, so classify the status explicitly in scripts.

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

@@ -17,14 +17,14 @@ profiles over the same substrate.
 ## Load Order
-| Tier | Load                                              | Cost      | When                          |
-| ---- | ------------------------------------------------- | --------- | ----------------------------- |
-| 0    | This file                                         | ~650 tok  | Always.                       |
-| 1    | `pm package explore --project`                    | ~0.5-2k   | See what is installed.        |
-| 1    | `pm package doctor --detail deep`                 | ~1-3k     | Diagnose activation failures. |
-| 2    | `pm contracts --runtime-only --availability-only` | ~1-2k     | What this install exposes.    |
-| 3    | `references/*.md` below                           | ~0.3-1k   | Procedure detail.             |
-| 4    | `docs/EXTENSIONS.md`, `docs/EXTENSION_LIFECYCLE.md` | varies  | Only when routed there.       |
+| Tier | Load | Cost | When |
+|---|---|---|---|
+| 0 | This file | ~650 tok | Always. |
+| 1 | `pm package explore --project` | ~0.5-2k | See what is installed. |
+| 1 | `pm package doctor --detail deep` | ~1-3k | Diagnose activation failures. |
+| 2 | `pm contracts --runtime-only --availability-only` | ~1-2k | What this install exposes. |
+| 3 | `references/*.md` below | ~0.3-1k | Procedure detail. |
+| 4 | `docs/EXTENSIONS.md`, `docs/EXTENSION_LIFECYCLE.md` | varies | Only when routed there. |
 Optional deep routing that never goes stale:
@@ -105,8 +105,8 @@ suit this project's real workflow should have a sandbox scenario or an explicit
 waiver on its canonical item; creating artificial production data is not proof
 of useful adoption.
-| Need                              | Load                                                | Cost     |
-| --------------------------------- | ---------------------------------------------------- | -------- |
-| Lifecycle recipes                  | [Extension lifecycle](references/LIFECYCLE.md)       | ~450 tok |
-| Failure diagnosis playbook         | [Troubleshooting](references/TROUBLESHOOTING.md)     | ~300 tok |
-| Authoring an extension end to end  | [Authoring](references/AUTHORING.md)                 | ~900 tok |
+| Need | Load | Cost |
+|---|---|---|
+| Lifecycle recipes | [Extension lifecycle](references/LIFECYCLE.md) | ~450 tok |
+| Failure diagnosis playbook | [Troubleshooting](references/TROUBLESHOOTING.md) | ~300 tok |
+| Authoring an extension end to end | [Authoring](references/AUTHORING.md) | ~900 tok |

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

@@ -9,18 +9,18 @@ grep -n "^## " docs/EXTENSIONS.md
 sed -n '<start>,<end>p' docs/EXTENSIONS.md
 ```
-| Topic                          | Heading in docs/EXTENSIONS.md |
-| ------------------------------ | ----------------------------- |
-| Where packages come from        | `## Package Sources`          |
-| Package manifest fields         | `## Package Manifest`         |
-| Directory layout                | `## Extension Layout`         |
-| Extension manifest fields       | `## Extension Manifest`       |
-| Capability and governance policy| `## Governance Policy`        |
-| Name collisions                 | `## Registration Collisions`  |
-| Runtime APIs available          | `## Runtime APIs`             |
-| Lifecycle commands              | `## Lifecycle Commands`       |
-| Upgrades                        | `## Upgrade Workflow`         |
-| Runnable examples               | `## Runnable Examples`        |
+| Topic | Heading in docs/EXTENSIONS.md |
+|---|---|
+| Where packages come from | `## Package Sources` |
+| Package manifest fields | `## Package Manifest` |
+| Directory layout | `## Extension Layout` |
+| Extension manifest fields | `## Extension Manifest` |
+| Capability and governance policy | `## Governance Policy` |
+| Name collisions | `## Registration Collisions` |
+| Runtime APIs available | `## Runtime APIs` |
+| Lifecycle commands | `## Lifecycle Commands` |
+| Upgrades | `## Upgrade Workflow` |
+| Runnable examples | `## Runnable Examples` |
 Author-time contracts live in
 [docs/EXTENSION_AUTHOR_CONTRACTS.md](../../../../docs/EXTENSION_AUTHOR_CONTRACTS.md)

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

@@ -17,14 +17,14 @@ integration should never import repository internals to get it.
 ## Load Order
-| Tier | Load                                            | Cost      | When                                  |
-| ---- | ----------------------------------------------- | --------- | ------------------------------------- |
-| 0    | This file                                       | ~700 tok  | Always.                               |
-| 1    | `pm contracts --summary`                        | ~2.6k     | The command/action surface.           |
-| 1    | `sdk/public-surface.json`                       | query it  | Exact exported symbols and signatures.|
-| 2    | `pm contracts --command <cmd> --full --json`    | ~1-4k     | One command's complete contract.      |
-| 3    | `references/*.md` below                         | ~0.3-1k   | Procedure detail.                     |
-| 4    | `docs/SDK.md` **by section only**               | 45k whole | Never read whole; grep to a heading.  |
+| Tier | Load | Cost | When |
+|---|---|---|---|
+| 0 | This file | ~700 tok | Always. |
+| 1 | `pm contracts --summary` | ~2.6k | The command/action surface. |
+| 1 | `sdk/public-surface.json` | query it | Exact exported symbols and signatures. |
+| 2 | `pm contracts --command <cmd> --full --json` | ~1-4k | One command's complete contract. |
+| 3 | `references/*.md` below | ~0.3-1k | Procedure detail. |
+| 4 | `docs/SDK.md` **by section only** | 45k whole | Never read whole; grep to a heading. |
 Optional deep routing that never goes stale:
@@ -39,20 +39,20 @@ pm guide tokens --depth brief
 Import the narrowest entrypoint that owns the capability. Startup cost is
 proportional to what you import.
-| Export                                    | Capability family                                        |
-| ----------------------------------------- | -------------------------------------------------------- |
-| `@unbrained/pm-cli/sdk/core`              | Items, schema, profile, transactions, runtime primitives  |
-| `@unbrained/pm-cli/sdk/query`             | List and search engines, filtering, pagination, rendering |
-| `@unbrained/pm-cli/sdk/graph`             | Relationship stores, traversal, analytics, remediation    |
-| `@unbrained/pm-cli/sdk/governance`        | Validation, health, gc, transaction cleanup               |
-| `@unbrained/pm-cli/sdk/merge`             | VCS-neutral tracker merge contracts                       |
-| `@unbrained/pm-cli/sdk/authoring`         | Extension blueprints, builders, manifests                 |
-| `@unbrained/pm-cli/sdk/contracts`         | Static command/action contracts, expected-error protocol  |
-| `@unbrained/pm-cli/sdk/runtime`           | Embedded command execution, package runtime helpers       |
-| `@unbrained/pm-cli/sdk/testing`           | Package and extension assertion/invocation helpers        |
-| `@unbrained/pm-cli/sdk`                   | Compatibility aggregate over every supported export       |
+| Export | Capability family |
+|---|---|
+| `@unbrained/pm-cli/sdk/core` | Items, schema, profile, transactions, runtime primitives |
+| `@unbrained/pm-cli/sdk/query` | List and search engines, filtering, pagination, rendering |
+| `@unbrained/pm-cli/sdk/graph` | Relationship stores, traversal, analytics, remediation |
+| `@unbrained/pm-cli/sdk/governance` | Validation, health, gc, transaction cleanup |
+| `@unbrained/pm-cli/sdk/merge` | VCS-neutral tracker merge contracts |
+| `@unbrained/pm-cli/sdk/authoring` | Extension blueprints, builders, manifests |
+| `@unbrained/pm-cli/sdk/contracts` | Static command/action contracts, expected-error protocol |
+| `@unbrained/pm-cli/sdk/runtime` | Embedded command execution, package runtime helpers |
+| `@unbrained/pm-cli/sdk/testing` | Package and extension assertion/invocation helpers |
+| `@unbrained/pm-cli/sdk` | Compatibility aggregate over every supported export |
 | `@unbrained/pm-cli/sdk/public-surface.json` | Machine-readable surface snapshot shipped with the package |
-| `@unbrained/pm-cli/cli`                   | Executable entry (`runPmCli`), not a typed library API    |
+| `@unbrained/pm-cli/cli` | Executable entry (`runPmCli`), not a typed library API |
 Query the shipped surface instead of guessing a symbol name:
@@ -108,9 +108,9 @@ the [current conformance matrix](../../../docs/MCP_2026_07_28_CONFORMANCE.md)
 and its SDK-owned request, transport, task, subscription, Skills, and Apps
 contracts; distinguish implementation evidence from exact-release acceptance.
-| Need                                        | Load                                                    | Cost     |
-| ------------------------------------------- | -------------------------------------------------------- | -------- |
-| Step-by-step integration checklist           | [Integration checklist](references/INTEGRATION_CHECKLIST.md) | ~400 tok |
-| Prompt templates                             | [Prompts](references/PROMPTS.md)                          | ~200 tok |
-| Which entrypoint owns which capability       | [Surface map](references/SURFACE_MAP.md)                  | ~900 tok |
-| Building a non-PM domain on pm primitives    | [Domain modeling](references/DOMAIN_MODELING.md)          | ~900 tok |
+| Need | Load | Cost |
+|---|---|---|
+| Step-by-step integration checklist | [Integration checklist](references/INTEGRATION_CHECKLIST.md) | ~400 tok |
+| Prompt templates | [Prompts](references/PROMPTS.md) | ~200 tok |
+| Which entrypoint owns which capability | [Surface map](references/SURFACE_MAP.md) | ~900 tok |
+| Building a non-PM domain on pm primitives | [Domain modeling](references/DOMAIN_MODELING.md) | ~900 tok |

package/.agents/skills/pm-sdk/references/SURFACE_MAP.md CHANGED Viewed

@@ -10,29 +10,29 @@ grep -n "^## \|^### " docs/SDK.md          # heading index, ~40 lines
 sed -n '<start>,<end>p' docs/SDK.md        # read one section
 ```
-| Topic                                    | Heading in docs/SDK.md            |
-| ---------------------------------------- | --------------------------------- |
-| Install and package resolution            | `## Install`                      |
-| Entrypoints and import cost               | `## Import Surfaces`              |
-| Surface snapshot and breaking-change gate | `### Public-surface compatibility`|
-| The full export inventory                 | `## Public Exports`               |
-| Building a custom project tool            | `### Build an entire custom project tool` |
-| Building a non-PM domain                  | `### Build a non-PM temporal domain` |
-| Plan workflows                            | `### Plan workflows`              |
-| History, restore, rich item reads         | `### Immutable history and rich item reads` |
-| Linked resources and dependency governance| `### Linked resources and dependency governance` |
-| Output budgets and discovery              | `### Agent output budgets and discovery` |
-| Static and runtime contracts              | `## Static And Runtime Contracts` |
-| Atomic workspace transactions             | `### Atomic workspace transactions` |
-| Schema evolution                          | `### Schema evolution and workspace history` |
-| Query execution                           | `### Query execution`             |
-| Context relevance and evaluation          | `### Context relevance and evaluation` |
-| Extension capability requirements         | `## Capability Requirements`      |
-| Declarative authoring and blueprints      | `## Declarative Authoring`        |
-| Testing helpers                           | `## Testing Helpers`              |
-| Custom item types                         | `## Custom Item Type`             |
-| Importers and exporters                   | `## Importer / Exporter`          |
-| Search providers                          | `## Search Provider`              |
+| Topic | Heading in docs/SDK.md |
+|---|---|
+| Install and package resolution | `## Install` |
+| Entrypoints and import cost | `## Import Surfaces` |
+| Surface snapshot and breaking-change gate | `### Public-surface compatibility` |
+| The full export inventory | `## Public Exports` |
+| Building a custom project tool | `### Build an entire custom project tool` |
+| Building a non-PM domain | `### Build a non-PM temporal domain` |
+| Plan workflows | `### Plan workflows` |
+| History, restore, rich item reads | `### Immutable history and rich item reads` |
+| Linked resources and dependency governance | `### Linked resources and dependency governance` |
+| Output budgets and discovery | `### Agent output budgets and discovery` |
+| Static and runtime contracts | `## Static And Runtime Contracts` |
+| Atomic workspace transactions | `### Atomic workspace transactions` |
+| Schema evolution | `### Schema evolution and workspace history` |
+| Query execution | `### Query execution` |
+| Context relevance and evaluation | `### Context relevance and evaluation` |
+| Extension capability requirements | `## Capability Requirements` |
+| Declarative authoring and blueprints | `## Declarative Authoring` |
+| Testing helpers | `## Testing Helpers` |
+| Custom item types | `## Custom Item Type` |
+| Importers and exporters | `## Importer / Exporter` |
+| Search providers | `## Search Provider` |
 ## Query The Shipped Surface
@@ -67,15 +67,15 @@ Classifications carry intent:
 ## Other Contract Artifacts
-| Artifact                                   | Answers                                        |
-| ------------------------------------------ | ---------------------------------------------- |
-| `pm contracts --summary --json`             | Commands, intents, per-command token ceilings   |
-| `pm contracts --command <c> --full --json`  | Flags, exit vocabulary, output contract         |
-| `pm contracts --schema-only`                | Item schema, types, statuses, fields            |
-| `pm contracts --runtime-only --availability-only` | What this installation actually exposes   |
-| `pm contracts --json --full \| jq '.mcp_tools'` | The MCP tool surface                        |
-| `pm contracts --json --full \| jq '.relationship_kind_contracts'` | Edge kinds and inverses   |
-| `docs/generated/AGENT_COMMAND_SURFACE.md`   | Command visibility tiers                        |
+| Artifact | Answers |
+|---|---|
+| `pm contracts --summary --json` | Commands, intents, per-command token ceilings |
+| `pm contracts --command <c> --full --json` | Flags, exit vocabulary, output contract |
+| `pm contracts --schema-only` | Item schema, types, statuses, fields |
+| `pm contracts --runtime-only --availability-only` | What this installation actually exposes |
+| `pm contracts --json --full \| jq '.mcp_tools'` | The MCP tool surface |
+| `pm contracts --json --full \| jq '.relationship_kind_contracts'` | Edge kinds and inverses |
+| `docs/generated/AGENT_COMMAND_SURFACE.md` | Command visibility tiers |
 `contracts --json --full` is large enough that the default budget omits it.
 Pass `--output-budget unbounded` when scripting it, and never into an agent's

package/.agents/skills/pm-test-audit/references/AUDIT.md CHANGED Viewed

@@ -39,7 +39,7 @@ their own. A previously failing retained test may expose a product defect.
 For each candidate, record:
 | Evidence | Required detail |
-| --- | --- |
+|---|---|
 | Identity | Exact path and test/table row; production owner and callers |
 | Failure | Credible regression the assertion can detect |
 | Contract | Independent external obligation, or why none exists |

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

@@ -17,13 +17,13 @@ agent can rebuild the full situation from it alone.
 ## Load Order
-| Tier | Load                                  | Cost      | When                           |
-| ---- | ------------------------------------- | --------- | ------------------------------ |
-| 0    | This file                             | ~650 tok  | Always.                        |
-| 1    | `pm context --limit 10`               | ~2.1k     | Orient in an existing project. |
-| 1    | `pm search "<terms>" --limit 10`      | ~0.5-1k   | Before creating anything; mode is resolved by `search.default_mode` (hybrid when semantic search is configured). |
-| 2    | `pm guide <topic> --depth brief`      | ~0.6-1k   | An unfamiliar family.          |
-| 3    | `references/*.md` below               | ~0.3-1k   | Procedure detail.              |
+| Tier | Load | Cost | When |
+|---|---|---|---|
+| 0 | This file | ~650 tok | Always. |
+| 1 | `pm context --limit 10` | ~2.1k | Orient in an existing project. |
+| 1 | `pm search "<terms>" --limit 10` | ~0.5-1k | Before creating anything; mode is resolved by `search.default_mode` (hybrid when semantic search is configured). |
+| 2 | `pm guide <topic> --depth brief` | ~0.6-1k | An unfamiliar family. |
+| 3 | `references/*.md` below | ~0.3-1k | Procedure detail. |
 Optional deep routing that never goes stale:
@@ -62,16 +62,16 @@ pm comments <ID> "Duplicate check: searched <terms>; nearest existing is <id> wh
 Use the metadata the tracker actually has. An item carrying only a title is a
 placeholder, not a tracked unit of work.
-| Field                                    | Why it matters                                     |
-| ---------------------------------------- | -------------------------------------------------- |
-| `--type`                                 | Routes into the right lifecycle and changelog bucket|
-| `--parent`                               | Places the item in the ladder                       |
-| `--dep "id=..,kind=.."`                  | Makes lineage machine-readable                      |
-| `--ac`                                   | Defines done without argument                       |
-| `--expected-result` / `--actual-result`  | Turns a defect into a reproducible claim            |
-| `--priority`, `--risk`, `--confidence`   | Lets selection rank without a human                 |
-| `--estimate`, `--deadline`               | Feeds scheduling and forecasting                    |
-| `--resolution`, `--close-reason`         | Makes the closed record answerable later            |
+| Field | Why it matters |
+|---|---|
+| `--type` | Routes into the right lifecycle and changelog bucket |
+| `--parent` | Places the item in the ladder |
+| `--dep "id=..,kind=.."` | Makes lineage machine-readable |
+| `--ac` | Defines done without argument |
+| `--expected-result` / `--actual-result` | Turns a defect into a reproducible claim |
+| `--priority`, `--risk`, `--confidence` | Lets selection rank without a human |
+| `--estimate`, `--deadline` | Feeds scheduling and forecasting |
+| `--resolution`, `--close-reason` | Makes the closed record answerable later |
 `--risk` is an enum: `low`, `medium`, `high`, `critical`. `--ac` **replaces**
 the criteria; `--dep` **appends**.
@@ -82,20 +82,20 @@ The complete, drift-gated [capability routing](../../../docs/generated/AGENT_CAP
 is generated from SDK contracts. This table routes common workflows; use
 `pm guide capabilities` for the whole installed surface.
-| Need                        | Entry                                    | Guide topic  |
-| --------------------------- | ---------------------------------------- | ------------ |
-| What should I do next       | `pm next`                                | `quickstart` |
-| Where does this project stand | `pm context`, `pm stats`               | `quickstart` |
-| Find existing work          | `pm search`, `pm list`, `pm duplicates`  | `commands`   |
-| Group and count             | `pm aggregate --group-by <field>`        | `commands`   |
-| Lineage and ordering        | `pm deps`, `pm graph <verb>`             | `graph`      |
-| Recent movement             | `pm activity`, `pm events`, `pm history` | `assurance`  |
-| Durable lessons and records | `pm learnings`, `pm notes`, `pm history` | `evidence`   |
-| Deadlines and meetings      | `pm remind`, `pm event`, `pm meet`       | `automation` |
-| Data quality                | `pm validate`, `pm health`               | `assurance`  |
-| Plan a multi-step change    | `pm plan`                                | `workflows`  |
-| Custom types and statuses   | `pm schema`, `pm config`                 | `commands`   |
-| Keep reads cheap            | `--output-*`, `--token-accounting`       | `tokens`     |
+| Need | Entry | Guide topic |
+|---|---|---|
+| What should I do next | `pm next` | `quickstart` |
+| Where does this project stand | `pm context`, `pm stats` | `quickstart` |
+| Find existing work | `pm search`, `pm list`, `pm duplicates` | `commands` |
+| Group and count | `pm aggregate --group-by <field>` | `commands` |
+| Lineage and ordering | `pm deps`, `pm graph <verb>` | `graph` |
+| Recent movement | `pm activity`, `pm events`, `pm history` | `assurance` |
+| Durable lessons and records | `pm learnings`, `pm notes`, `pm history` | `evidence` |
+| Deadlines and meetings | `pm remind`, `pm event`, `pm meet` | `automation` |
+| Data quality | `pm validate`, `pm health` | `assurance` |
+| Plan a multi-step change | `pm plan` | `workflows` |
+| Custom types and statuses | `pm schema`, `pm config` | `commands` |
+| Keep reads cheap | `--output-*`, `--token-accounting` | `tokens` |
 ## Reporting Without Loading Rows
@@ -110,9 +110,9 @@ Aggregate on a scalar field when a per-value count is what you want.
 ## References
-| Need                              | Load                                          | Cost     |
-| --------------------------------- | --------------------------------------------- | -------- |
-| Triage and planning procedures     | [Workflows](references/WORKFLOWS.md)          | ~350 tok |
-| Prompt templates                   | [Prompts](references/PROMPTS.md)              | ~250 tok |
+| Need | Load | Cost |
+|---|---|---|
+| Triage and planning procedures | [Workflows](references/WORKFLOWS.md) | ~350 tok |
+| Prompt templates | [Prompts](references/PROMPTS.md) | ~250 tok |
 | Backlog structure and item quality | [Backlog shaping](references/BACKLOG_SHAPING.md) | ~900 tok |
 | Complete ecosystem review and long-term planning | [Ecosystem planning](references/ECOSYSTEM_PLANNING.md) | on demand |

package/.claude-plugin/marketplace.json CHANGED Viewed

	@@ -1 +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.11.4","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.11.4","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"}]}
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.11.5","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.11.5","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/AGENTS.md CHANGED Viewed

@@ -4,15 +4,15 @@ This file is the low-context entrypoint for agents working in this repository. R
 ## Progressive Disclosure
-| Need                                | Read                                                              |
-| ----------------------------------- | ----------------------------------------------------------------- |
-| Agent workflow and ownership        | [Agent Guide](docs/AGENT_GUIDE.md)                                |
-| Exact command families and examples | [Command Reference](docs/COMMANDS.md)                             |
-| Sandbox-safe verification           | [Testing](docs/TESTING.md)                                        |
-| Settings, output, and environment   | [Configuration](docs/CONFIGURATION.md)                            |
-| Package or extension work           | [Packages and Extensions](docs/EXTENSIONS.md), [SDK](docs/SDK.md) |
-| Release work                        | [Releasing](docs/RELEASING.md)                                    |
-| Full docs map                       | [Documentation Index](docs/README.md)                             |
+| Need | Read |
+|---|---|
+| Agent workflow and ownership | [Agent Guide](docs/AGENT_GUIDE.md) |
+| Exact command families and examples | [Command Reference](docs/COMMANDS.md) |
+| Sandbox-safe verification | [Testing](docs/TESTING.md) |
+| Settings, output, and environment | [Configuration](docs/CONFIGURATION.md) |
+| Package or extension work | [Packages and Extensions](docs/EXTENSIONS.md), [SDK](docs/SDK.md) |
+| Release work | [Releasing](docs/RELEASING.md) |
+| Full docs map | [Documentation Index](docs/README.md) |
 Use runtime contracts for exact flags because packages and settings can change the active surface:

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,14 @@
 # Changelog
+## 2026.11.5 - 2026-11-05
+### Fixed
+- Start-blocker and revision-conflict follow-ups from the PR 1654 CodeRabbit full review ([pm-mrvq8u](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mrvq8u.toon))
+- Expected revisions advance from the pre-override document when an item_store_write override transforms contents ([pm-thbdxu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-thbdxu.toon))
+- GH-1655: SDK placeholder and type refusals name CLI flags, and parent: null is refused, so typed callers have no documented way to clear a field ([pm-gh1655](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1655.toon))
+- GH-1660: the project telemetry block pm init writes is inert, so the wizard's telemetry decline and the project endpoint are ignored, and no supported way points opted-in tests at a local collector ([pm-gh1660](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1660.toon))
 ## 2026.11.4 - 2026-11-04
 ### Added

package/README.md CHANGED Viewed

@@ -21,19 +21,19 @@
 ## Start Here
-| Need                                                           | Read                                                                                                                                                                                                                                                                                                                        |
-| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Install and create the first item                              | [Quickstart](docs/QUICKSTART.md)                                                                                                                                                                                                                                                                                            |
-| New maintainer onboarding                                      | [Onboarding](docs/ONBOARDING.md)                                                                                                                                                                                                                                                                                            |
-| Agent workflow and token-minimal loops                         | [Agent Guide](docs/AGENT_GUIDE.md)                                                                                                                                                                                                                                                                                          |
-| Command families and examples                                  | [Command Reference](docs/COMMANDS.md)                                                                                                                                                                                                                                                                                       |
-| Shell, CI, and machine-client composition                      | [CLI Scripting Contract](docs/SCRIPTING.md)                                                                                                                                                                                                                                                                                 |
-| Settings, storage, search, and output                          | [Configuration](docs/CONFIGURATION.md)                                                                                                                                                                                                                                                                                      |
-| Safe test execution and linked tests                           | [Testing](docs/TESTING.md)                                                                                                                                                                                                                                                                                                  |
-| Security reporting and resilience controls                     | [Security Policy](SECURITY.md), [Security Governance](docs/SECURITY_GOVERNANCE.md)                                                                                                                                                                                                                                          |
-| Package and extension authoring                                | [Packages and Extensions](docs/EXTENSIONS.md), [SDK](docs/SDK.md), [Context Integrity](docs/CONTEXT_INTEGRITY_CONTRACTS.md), [Customization Primitives](docs/SDK_CUSTOMIZATION_PRIMITIVES.md), [Evidence Traceability](docs/SDK_EVIDENCE_TRACEABILITY.md), and [Agent Runtime Primitives](docs/AGENT_RUNTIME_PRIMITIVES.md) |
-| Maintainer release process (daily auto-release + local parity) | [Releasing](docs/RELEASING.md)                                                                                                                                                                                                                                                                                              |
-| Contributor internals                                          | [Architecture](docs/ARCHITECTURE.md)                                                                                                                                                                                                                                                                                        |
+| Need | Read |
+|---|---|
+| Install and create the first item | [Quickstart](docs/QUICKSTART.md) |
+| New maintainer onboarding | [Onboarding](docs/ONBOARDING.md) |
+| Agent workflow and token-minimal loops | [Agent Guide](docs/AGENT_GUIDE.md) |
+| Command families and examples | [Command Reference](docs/COMMANDS.md) |
+| Shell, CI, and machine-client composition | [CLI Scripting Contract](docs/SCRIPTING.md) |
+| Settings, storage, search, and output | [Configuration](docs/CONFIGURATION.md) |
+| Safe test execution and linked tests | [Testing](docs/TESTING.md) |
+| Security reporting and resilience controls | [Security Policy](SECURITY.md), [Security Governance](docs/SECURITY_GOVERNANCE.md) |
+| Package and extension authoring | [Packages and Extensions](docs/EXTENSIONS.md), [SDK](docs/SDK.md), [Context Integrity](docs/CONTEXT_INTEGRITY_CONTRACTS.md), [Customization Primitives](docs/SDK_CUSTOMIZATION_PRIMITIVES.md), [Evidence Traceability](docs/SDK_EVIDENCE_TRACEABILITY.md), and [Agent Runtime Primitives](docs/AGENT_RUNTIME_PRIMITIVES.md) |
+| Maintainer release process (daily auto-release + local parity) | [Releasing](docs/RELEASING.md) |
+| Contributor internals | [Architecture](docs/ARCHITECTURE.md) |
 Full documentation starts at [docs/README.md](docs/README.md).