pm-brief 2026.10.21 → 2026.10.23

package/docs/examples/alternatives.md

@@ -0,0 +1,22 @@
+# Comparing cache proposals
+
+Create two native records in a plain initialized scratch tracker:
+
+```bash
+pm create --type Decision --title 'Keep the cache' --body 'Lower latency. Unresolved: eviction complexity.'
+pm create --type Decision --title 'Remove the cache' --body 'Less maintenance. Unresolved: cold-start latency.'
+# Substitute the exact IDs returned by those commands.
+pm brief alternatives <keep-id> <remove-id> --json --token-budget 2000
+```
+
+Each `alternatives` entry retains its ID, snapshot revision and independent
+statements. A body statement for the first record has source `<keep-id>#/body`,
+range `[0, 47)`, and text `Lower latency. Unresolved: eviction complexity.`.
+The second record retains the opposing proposal and its cold-start tradeoff.
+Neither record becomes a recommendation.
+
+For each statement, read the native source row, follow the JSON Pointer and
+compare `String(value).slice(start, end)` with `text`. If a small budget omits
+optional paragraphs, `omitted` increases and `restore` supplies the native read.
+If even titles, statuses and recorded outcomes cannot fit, the command refuses
+with `alternatives_budget` and a remedy instead of losing an alternative.

package/docs/examples/handoff.json

@@ -0,0 +1,6 @@
+{
+  "focus": ["demo-task"],
+  "questions": [{ "id": "fixture", "text": "Which public fixture should the receiver validate?" }],
+  "assumptions": [{ "id": "review", "text": "The blocking review remains unresolved." }],
+  "requiredEvidence": [{ "id": "report", "item": "demo-task", "kind": "docs", "ref": "docs/validation.md" }]
+}

package/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-brief",
-  "version": "2026.10.21",
+  "version": "2026.10.23",
   "description": "Token-budgeted agent briefs and next-work plans for pm workspaces",
   "author": "@unbraind",
   "entry": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-brief",
-  "version": "2026.10.21",
+  "version": "2026.10.23",
   "description": "Token-budgeted agent briefs and next-work plans for pm workspaces",
   "type": "module",
   "main": "dist/index.js",
@@ -10,7 +10,9 @@
     "manifest.json",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "docs/examples/handoff.json",
+    "docs/examples/alternatives.md"
   ],
   "scripts": {
     "build": "tsc",
@@ -92,7 +94,9 @@
       "CHANGELOG.md"
     ],
     "examples": [
-      "README.md"
+      "README.md",
+      "docs/examples/handoff.json",
+      "docs/examples/alternatives.md"
     ],
     "capabilities": [
       "commands",