create-pmos 0.52.0 → 0.53.1

package/workspace/fixtures/initiatives-api/sheet.json

@@ -0,0 +1,112 @@
+{
+  "ok": true,
+  "ws": "w-north",
+  "sig": {
+    "placements": "3f786850e387550fdab836ed7e6dc881de23001b",
+    "items": "89e6c98d92887913cadf06b2adb97f26cde4849b",
+    "measurements": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
+    "records": "2b66fd261ee5c6cfc8de7fa466bab600bcfe4f69"
+  },
+  "now": "2026-10-05T12:00:00.000Z",
+  "initiative": {
+    "id": "partner-sso",
+    "title": "Partner SSO",
+    "lane": "feature",
+    "anchor": "KR 2.1",
+    "anchor_kind": "kr",
+    "horizon": "now",
+    "rank": 0,
+    "confirmed": true,
+    "dormant": false,
+    "check_by": "2026-10-30",
+    "stage": {
+      "id": "build",
+      "label": "Build"
+    },
+    "display": {
+      "word": "Build",
+      "stage": "build",
+      "waitingOn": "pm",
+      "act": "approval",
+      "idleDays": 1,
+      "line2": "Waiting on you: approval"
+    },
+    "health": {
+      "level": "at-risk",
+      "reasons": [
+        {
+          "level": "at-risk",
+          "code": "item-overdue",
+          "text": "\"Partner login page\" was due 2 Oct",
+          "source": "planning/runs/plan-items.jsonl"
+        }
+      ]
+    },
+    "progress": {
+      "done": 7,
+      "total": 12,
+      "label": "7 of 12"
+    },
+    "next_due": "2026-11-14",
+    "last_activity": "2026-10-04T09:00:00Z"
+  },
+  "stepper": [
+    {
+      "id": "intake",
+      "label": "Intake",
+      "state": "done"
+    },
+    {
+      "id": "spec",
+      "label": "Spec",
+      "state": "done"
+    },
+    {
+      "id": "build",
+      "label": "Build",
+      "state": "current"
+    },
+    {
+      "id": "evaluate",
+      "label": "Evaluate",
+      "state": "todo"
+    },
+    {
+      "id": "accept",
+      "label": "Accept",
+      "state": "todo"
+    }
+  ],
+  "waiting": {
+    "on": "pm",
+    "act": "approval",
+    "action": {
+      "label": "Open gate",
+      "kind": "gate",
+      "target": "prd"
+    }
+  },
+  "files": [
+    {
+      "kind": "prd",
+      "label": "PRD",
+      "path": "planning/prd/partner-sso.md"
+    },
+    {
+      "kind": "rubric",
+      "label": "Rubric",
+      "path": "planning/evals/partner-sso.md"
+    }
+  ],
+  "history": [
+    {
+      "at": "2026-10-04T09:00:00Z",
+      "by": "pm:wawan",
+      "text": "Moved to Now"
+    }
+  ],
+  "cli": {
+    "now": "pmos initiative now partner-sso",
+    "export": "pmos initiative export partner-sso"
+  }
+}

package/workspace/fixtures/report-api/draft.json

@@ -0,0 +1,177 @@
+{
+  "ok": true,
+  "cadence": "biweekly",
+  "slot": "2026-10-16",
+  "window": {
+    "from": "2026-10-02T09:00:00Z",
+    "to": "2026-10-16T00:00:00Z",
+    "since": "last_issue"
+  },
+  "path": "planning/reports/biweekly/2026-10-16.md",
+  "issued": null,
+  "headline": "2 initiatives moved; 1 is at risk.",
+  "timeline": {
+    "from": "2026-10-02",
+    "to": "2026-10-30",
+    "today": "2026-10-16",
+    "rows": [
+      {
+        "id": "partner-sso",
+        "title": "Partner SSO",
+        "spans": [
+          {
+            "stage": "build",
+            "start": "2026-10-01",
+            "due": "2026-10-24",
+            "milestone": false
+          }
+        ],
+        "milestones": [
+          "2026-10-24"
+        ]
+      }
+    ]
+  },
+  "blocks": [
+    {
+      "id": "audit-log",
+      "title": "Audit log export",
+      "stage": "Evaluate",
+      "health": {
+        "level": "at-risk",
+        "reasons": [
+          {
+            "level": "at-risk",
+            "code": "check-by-passed",
+            "text": "check-by 1 Oct passed",
+            "source": "planning/runs/placements.jsonl"
+          }
+        ]
+      },
+      "progress": {
+        "done": 3,
+        "total": 5,
+        "delta": 1,
+        "label": "3 of 5 (+1)"
+      },
+      "measure": {
+        "anchor": "KR-2",
+        "value": 42,
+        "target": 60,
+        "unit": "%",
+        "as_of": "2026-10-14",
+        "source": "planning/metrics/kr-2.csv@3f2a9c1"
+      },
+      "last_cycle": {
+        "done": [
+          {
+            "id": "audit-log.a1b2c3d4e5",
+            "title": "CSV writer"
+          }
+        ],
+        "gates": [
+          {
+            "gate": "spec",
+            "at": "2026-10-03T10:00:00Z"
+          }
+        ],
+        "moves": [
+          {
+            "from": "next",
+            "to": "now",
+            "at": "2026-10-03T10:00:00Z"
+          }
+        ],
+        "carried": [
+          {
+            "id": "audit-log.f6g7h8i9j0",
+            "title": "Retention rule",
+            "due": "2026-10-10"
+          }
+        ]
+      },
+      "coming_cycle": {
+        "basis": "dates",
+        "items": [
+          {
+            "id": "audit-log.k1l2m3n4o5",
+            "title": "Export UI",
+            "start": "2026-10-17",
+            "due": "2026-10-28"
+          }
+        ]
+      },
+      "note": ""
+    },
+    {
+      "id": "partner-sso",
+      "title": "Partner SSO",
+      "stage": "Build",
+      "health": {
+        "level": "on",
+        "reasons": []
+      },
+      "progress": {
+        "done": 7,
+        "total": 12,
+        "delta": 4,
+        "label": "7 of 12 (+4)"
+      },
+      "measure": null,
+      "last_cycle": {
+        "done": [],
+        "gates": [],
+        "moves": [],
+        "carried": []
+      },
+      "coming_cycle": {
+        "basis": "order",
+        "items": [
+          {
+            "id": "partner-sso.p1q2r3s4t5",
+            "title": "Pilot partners on SSO",
+            "start": null,
+            "due": null
+          }
+        ]
+      },
+      "note": ""
+    }
+  ],
+  "new_since_last": [
+    {
+      "id": "billing-v2",
+      "title": "Billing v2",
+      "at": "2026-10-08T10:00:00Z"
+    }
+  ],
+  "decided": [
+    {
+      "text": "Audit log export moved to Now",
+      "at": "2026-10-03T10:00:00Z",
+      "source": "planning/runs/placements.jsonl"
+    }
+  ],
+  "needs_your_call": [
+    {
+      "text": "Approve the Partner SSO rollout scope",
+      "audience": "leadership"
+    }
+  ],
+  "sources": {
+    "reached": [
+      "planning/runs/plan-items.jsonl",
+      "planning/runs/placements.jsonl"
+    ],
+    "not_reached": [
+      {
+        "source": "tracker",
+        "why": "not refreshed since 2 Oct"
+      }
+    ],
+    "definition": {
+      "path": "planning/reports/definitions/biweekly.md",
+      "audience": "leadership"
+    }
+  }
+}

package/workspace/fixtures/reports-page/draft-biweekly-2026-10-16.md

@@ -0,0 +1,97 @@
+---
+type: Reference
+title: "Biweekly report 2026-10-16"
+description: "The biweekly report for 2026-10-16. pmos report draft writes every number; prose goes only between the note markers."
+timestamp: 2026-10-16T00:00:00Z
+cadence: biweekly
+slot: 2026-10-16
+window: "2026-10-02T09:00:00Z to 2026-10-16T00:00:00Z (since the last issue)"
+synthetic: true
+---
+
+# Biweekly report 2026-10-16
+
+## Headline
+
+2 initiatives moved; 1 is at risk.
+
+<!-- pmos:note report.headline -->
+Audit log export is the one to watch this cycle.
+<!-- /pmos:note -->
+
+## Timeline
+
+Frozen at 2026-10-16T00:00:00Z. 2 Oct to 30 Oct; today is 16 Oct.
+
+| Initiative | Stage | Start | Due | Milestones |
+|---|---|---|---|---|
+| Partner SSO | build | 2026-10-01 | 2026-10-24 | 24 Oct |
+
+## Initiatives
+
+### Audit log export (audit-log)
+
+Stage: Evaluate · At risk: check-by 1 Oct passed · 3 of 5 (+1)
+
+Measured: KR-2 42% of 60%, as of 2026-10-14 (planning/metrics/kr-2.csv@3f2a9c1)
+
+**Last cycle**
+
+- Done: CSV writer (audit-log.a1b2c3d4e5)
+- Gates passed: spec, 3 Oct
+- Horizon moves: Next to Now, 3 Oct
+- Overdue, carried over: Retention rule, due 10 Oct
+
+**Coming cycle** (items that start or fall due)
+
+- Export UI, starts 17 Oct, due 28 Oct
+
+<!-- pmos:note audit-log -->
+Legal review is the open dependency.
+<!-- /pmos:note -->
+
+### Partner SSO (partner-sso)
+
+Stage: Build · On track · 7 of 12 (+4)
+
+**Last cycle**
+
+- Done: none
+- Gates passed: none
+- Horizon moves: none
+- Overdue, carried over: none
+
+**Coming cycle** (the next 3 by order)
+
+- Pilot partners on SSO
+
+<!-- pmos:note partner-sso -->
+
+<!-- /pmos:note -->
+
+## New since last report
+
+- Billing v2 (billing-v2), 8 Oct
+
+## Decided this cycle
+
+- Audit log export moved to Now, 3 Oct (planning/runs/placements.jsonl)
+
+## Needs your call
+
+For leadership only.
+
+<!-- pmos:note report.asks -->
+
+<!-- /pmos:note -->
+
+## Sources reached and not reached
+
+**Reached**
+
+- planning/runs/plan-items.jsonl
+- planning/runs/placements.jsonl
+
+**Not reached**
+
+- tracker: not refreshed since 2 Oct

package/workspace/fixtures/today-api/provider-rows.json

@@ -0,0 +1,204 @@
+{
+  "needs": [
+    {
+      "run_id": "report-needs:issue:biweekly:2026-10-16",
+      "initiative_id": null,
+      "kind": "report-issue",
+      "derived": true,
+      "question": "The biweekly of 16 Oct is ready to issue",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "report-needs",
+      "today": {
+        "kind": 1,
+        "source": "report-needs",
+        "cause": "A draft is ready to issue",
+        "evidence": "planning/reports/biweekly/2026-10-16.md",
+        "act": {
+          "label": "Issue",
+          "cli": "pmos report issue biweekly 2026-10-16"
+        }
+      }
+    },
+    {
+      "run_id": "work-check-needs:review:partner-sso.k3j9x0p2qa",
+      "initiative_id": "partner-sso",
+      "kind": "item-review",
+      "derived": true,
+      "question": "\"draft partner email\" is in Review",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "work-check-needs",
+      "today": {
+        "kind": 4,
+        "source": "work-check-needs",
+        "cause": "An item waits in Review",
+        "evidence": "planning/runs/plan-items.jsonl",
+        "act": {
+          "label": "Open",
+          "cli": null
+        }
+      }
+    },
+    {
+      "run_id": "work-check-needs:release:partner-sso:b-01",
+      "initiative_id": "partner-sso",
+      "kind": "release",
+      "derived": true,
+      "question": "3 work items are ready to release",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "work-check-needs",
+      "today": {
+        "kind": 4,
+        "source": "work-check-needs",
+        "cause": "A factory batch is ready",
+        "evidence": "planning/runs/work-items.jsonl",
+        "act": {
+          "label": "Release",
+          "cli": null
+        }
+      }
+    },
+    {
+      "run_id": "work-check-needs:no-evidence:partner-sso.q8d2m5h1zc",
+      "initiative_id": "partner-sso",
+      "kind": "item-no-evidence",
+      "derived": true,
+      "question": "\"update the partner FAQ\" reads Done with no evidence",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "work-check-needs",
+      "today": {
+        "kind": 4,
+        "source": "work-check-needs",
+        "cause": "An agent item reads Done with no evidence",
+        "evidence": "planning/runs/plan-items.jsonl",
+        "act": {
+          "label": "Open",
+          "cli": null
+        }
+      }
+    },
+    {
+      "run_id": "initiative-needs:triage:capture-2026-10-04-1",
+      "initiative_id": null,
+      "kind": "triage",
+      "derived": true,
+      "question": "Proposed: Partner SSO \u00b7 new feature \u00b7 KR 2.1",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "initiative-needs",
+      "today": {
+        "kind": 6,
+        "source": "initiative-needs",
+        "cause": "A capture was triaged",
+        "evidence": "planning/requirements/capture-2026-10-04-1.md",
+        "act": {
+          "label": "Add",
+          "cli": "pmos initiative new --from capture-2026-10-04-1"
+        }
+      }
+    },
+    {
+      "run_id": "initiative-needs:cycle:2026-10-05",
+      "initiative_id": null,
+      "kind": "cycle-review",
+      "derived": true,
+      "question": "Confirm what is in Now",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "initiative-needs",
+      "today": {
+        "kind": 7,
+        "source": "initiative-needs",
+        "cause": "Day one: 2 initiatives read Now, unconfirmed",
+        "evidence": "planning/runs/placements.jsonl",
+        "act": {
+          "label": "Review",
+          "cli": null
+        }
+      }
+    },
+    {
+      "run_id": "report-needs:cycle:kill-check:2026-10",
+      "initiative_id": null,
+      "kind": "cycle-kill-check",
+      "derived": true,
+      "question": "The monthly kill-condition check is due",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "report-needs",
+      "today": {
+        "kind": 7,
+        "source": "report-needs",
+        "cause": "The month ended",
+        "evidence": "planning/okrs/kill-conditions.md",
+        "act": {
+          "label": "Review",
+          "cli": null
+        }
+      }
+    },
+    {
+      "run_id": "pm-lines-needs:z9y8x7w6v5u4",
+      "initiative_id": "partner-sso",
+      "kind": "pm-line",
+      "derived": true,
+      "question": "A PM-only line is not attested",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "pm-lines-needs",
+      "today": {
+        "kind": 8,
+        "source": "pm-lines-needs",
+        "cause": "A placed line into Now has no via",
+        "evidence": "planning/runs/placements.jsonl line 12",
+        "act": {
+          "label": "Show line",
+          "cli": null
+        }
+      }
+    },
+    {
+      "run_id": "initiative-needs:no-anchor:old-import",
+      "initiative_id": "old-import",
+      "kind": "no-anchor",
+      "derived": true,
+      "question": "Legacy importer has no anchor",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "initiative-needs",
+      "today": {
+        "kind": 8,
+        "source": "initiative-needs",
+        "cause": "An initiative record names no KR or health budget",
+        "evidence": "planning/initiatives/old-import.md",
+        "act": {
+          "label": "Add anchor",
+          "cli": null
+        }
+      }
+    },
+    {
+      "run_id": "report-needs:no-output:weekly:2026-10-02",
+      "initiative_id": null,
+      "kind": "schedule-no-output",
+      "derived": true,
+      "question": "The weekly schedule left no output",
+      "doc": null,
+      "ws": "w-north",
+      "provider": "report-needs",
+      "today": {
+        "kind": 8,
+        "source": "report-needs",
+        "cause": "No draft for the slot of 2 Oct",
+        "evidence": "planning/reports/weekly",
+        "act": {
+          "label": "Draft now",
+          "cli": "pmos report draft weekly"
+        }
+      }
+    }
+  ]
+}

package/workspace/fixtures/today-api/seam-probe-kinds.json

@@ -0,0 +1,5 @@
+{
+  "_comment": "Row kinds that only pm-seams-test.js uses. No needs provider, no registerTodayCard owner and no slice may use them (d86-seams checks it).",
+  "plain": "seam-probe-plain",
+  "drawn": "seam-probe-drawn"
+}

package/workspace/guide/board.md

@@ -0,0 +1,81 @@
+---
+type: Guide
+title: "Board: the items of every initiative"
+description: "How to read and use the Board destination, filter it, add an item, move a card, release a batch of work items, and print the same Board with pmos board."
+timestamp: 2026-10-05
+---
+
+# Board: the items of every initiative
+
+The Board shows the items of all your work initiatives in one place. It has four columns: Todo, Doing, Review and Done. A card is one item. The Board is a view of the same items that the Breakdown of each initiative shows, so a card is always in the column that its row has in the Tree.
+
+A document initiative has no items, so it has no card and no place in the filter.
+
+## Open the Board
+
+Press **Board** in the navigation, or press `g` then `b`. In the older layout, choose Board in the command palette. The Board opens in a tab.
+
+## Filters
+
+Three filters decide which cards show. Press a button at the top, or choose an initiative from the list.
+
+- **Active** is the default. It shows an item that changed in the last days, an open item of an initiative that is in Now, and every item that is yours. The number of days is `stall_days` in `planning/plan-rules.json`.
+- **Mine** shows only the items that you own.
+- **An initiative.** Choose one from the list to see all its items. Choose **All initiatives** to go back to Active.
+
+Done shows the last 14 days under every filter, however long ago the item last changed. An older Done item is counted in the column ("3 older in the Tree") and stays in the Tree of its initiative.
+
+## Add an item
+
+Press **Add item**, the one main button of the Board. Type a title, choose the initiative and the stage, and press **Add** or Enter. The item goes into the ledger of that initiative, the same way as in the Breakdown.
+
+## Move a card
+
+- **On a wide screen,** drag a card to another column. A drop on Done is held for 8 seconds, so you can press **Undo**.
+- **On a phone,** press the card to open its sheet and press a state button. A card moves in 2 taps. From another column it takes 3: first press the column name, then the card, then the state.
+- **From the menu.** Press the three dots on a card, then choose Move to a state.
+
+When you move a card that an agent owns, the card reads "moved by you". The agent's own next move can change it again.
+
+A card that reads "Done · your call · not merged" is Done because you said so. The work in the repository is not merged yet.
+
+## Release
+
+When all the work items of a batch passed their checks, the Board shows a **Release** card above the columns. One press on **Release** grants the whole batch. It is one grant for the batch, and the grant names the initiative and the batch. The factory opens pull requests and never merges them.
+
+Only you can press Release. An agent cannot. When the grant writer of the workspace is not available, the button is disabled and the card says "Release arrives in Run 2."
+
+The same card also shows in Today when a batch is ready.
+
+## Today
+
+Today shows three things from the Board:
+
+- an item in Review that waits for you;
+- a batch that is ready for Release;
+- an item that an agent marked Done with no evidence. Open it and add evidence, such as `commit:<sha>` or `pr:<number>`.
+
+## Signals
+
+| signal | meaning |
+|---|---|
+| Blocked | the item has a reason that it cannot go on |
+| no evidence | an agent marked the item Done and gave no evidence |
+| late | the due date passed and the item is not Done |
+| moved by you | you moved a card that an agent owns |
+| Proposed | an agent proposed the item and you did not keep it |
+
+## From a terminal
+
+`pmos board` prints the same Board that the page shows. It reads the repository, so the workspace server does not need to run.
+
+```
+pmos board                      the Active filter
+pmos board --mine               your own items
+pmos board --init <initiative>  one initiative
+pmos board --json               the same answer as GET /api/board, for scripts
+```
+
+The text form prints one column per block, then one line for each card: the initiative, the stage, the title and the owner, and what needs your notice. The command only reads. It writes no line to any ledger.
+
+`pmos board` exits with 0 when it printed the Board, 1 when the initiative is not on the Board, and 2 when the command line is wrong.