create-pmos 0.198.0 → 0.199.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.198.0",
+  "version": "0.199.0",
   "description": "Scaffold the PMOS portable kit — run the PMOS product-management workflow (initiative → lane-fit spec → contract → build → three gates, with work-type lanes for features, research, maintenance, incidents, and content) entirely inside your own repo, with all state as git-versioned files. Includes `workflow-sweep`, which audits the state every board derives from and separates real defects from work you simply have not done. `create-pmos workspace` also installs + launches the local Terminal Workspace GUI. No database, no network, no telemetry.",
   "license": "MIT",
   "bin": {

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@94c2b4f
+kernel-source: pmos@0ede922
 assembled: 2026-10-13
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-13T10:14:18Z"}
+generated: {by: process:create-pmos, at: "2026-10-13T10:19:39Z"}
 status: stable
 ---
 

package/payload/planning/okrs/health-budgets.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Health budgets"
 description: "Closed registry of health-budget anchors (D59), edited only by the PM."
-generated: {by: process:create-pmos, at: "2026-10-13T10:14:18Z"}
+generated: {by: process:create-pmos, at: "2026-10-13T10:19:39Z"}
 status: stable
 ---
 

package/payload/state/discoveries.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Discoveries and friction log"
 description: "Append-only record of what runs discovered and where the process rubbed."
-generated: {by: process:create-pmos, at: "2026-10-13T10:14:18Z"}
+generated: {by: process:create-pmos, at: "2026-10-13T10:19:39Z"}
 status: stable
 ---
 

package/workspace/guide/core-documents.md

@@ -45,7 +45,7 @@ A row that is not started always has a next step:
 ## How PMOS drafts a document
 
 - **When you ask.** Press **Draft it** on a row, or **Ask PMOS to change it** on a draft. PMOS starts one background run. The run reads the sources of that document and writes one draft. It has no tool that sends, posts or edits.
-- **On a schedule.** Every 30 minutes inside your working hours, PMOS drafts each portfolio and board document whose cadence has passed and that has no draft. It drafts a document at most once a day, and it runs at most 3 drafts at once. It never drafts a document that you write (the product strategy).
+- **On a schedule.** Every 30 minutes inside your working hours, PMOS drafts each portfolio and board document that has no draft and is due, out of date or not started yet. Due documents go first, then out-of-date ones, then the first draft of documents not started. While no OKR files exist, it also proposes the OKRs. It drafts a document at most once a day, and it runs at most 3 drafts at once. It never drafts a document that you write (the product strategy).
 - **The Initiative Driver.** When the current stage of an initiative needs a document that is not there or is stale, the driver drafts it and files a proposal. **Keep** issues the draft. The driver does not propose a stage move while a document of the current stage is due.
 
 ## Issue a draft

package/workspace/lib/routes-core-docs.js

@@ -77,7 +77,7 @@ function startRun(ctx, w, scope, entry, { label, now } = {}) {
 const labelOf = (facts) => (facts.level === 'board' && facts.board ? facts.board.name : facts.level === 'initiative' && facts.row ? `${facts.row.id} ${facts.row.title || ''}`.trim() : null);
 
 // ── the tick ─────────────────────────────────────────────────────────────────────────────────────────
-/** Draft each due doc entry of the portfolio and the boards. → [{ ws, scope, key, ok, error? }] */
+/** Draft the doc entries of the portfolio and the boards that are due, out of date or not started (due first). → [{ ws, scope, key, ok, error? }] */
 function tick(ctx, { now = Date.now(), force = false } = {}) {
   if (!ctx || typeof ctx.getWs !== 'function') return [];
   if (!force && lastTick != null && now - lastTick < TICK_EVERY_MS) return [];
@@ -85,35 +85,42 @@ function tick(ctx, { now = Date.now(), force = false } = {}) {
   const open = require('./driver-run.js').dayCheckOpen(settings || {}, now, ctx.inQuiet || (() => false));
   if (!open) return [];
   lastTick = now;
-  if (headless.switchedOff(process.env)) return [];
+  if (headless.switchedOff(process.env) || /^(off|0|false|no)$/i.test(String(process.env.PMOS_CORE_DOCS || ''))) return [];   // PMOS_CORE_DOCS=off: no scheduled drafts
   const day = CD.localDay(now);
   const out = [];
   const list = typeof ctx.workspaceList === 'function' ? ctx.workspaceList() : [ctx.getWs(null)].filter(Boolean);
+  // Every candidate first, then the most pressing: due (issued, cadence passed), out of date, then not started (the first draft, and the
+  // proposed OKRs while no OKR files exist). At most RUN_CAP runs at once; each entry at most once a day.
+  const RANK = { due: 0, stale: 1, missing: 2 };
+  const todo = [];
   for (const w of list) {
     if (!w || !w.root) continue;
     if (typeof ctx.isLead === 'function' && !ctx.isLead(w)) continue;
     const levels = [{ level: 'portfolio' }];
     try { for (const b of require('./routes-boards.js').frameFor(ctx, w).boards) levels.push({ level: 'board', board: b.id }); } catch { /* the portfolio still drafts */ }
-    for (const lv of levels) {
-      if (runs.size >= RUN_CAP) return out;
+    for (const [li, lv] of levels.entries()) {
       let g;
       try { g = CD.gather(ctx, w, { ...lv, now }); } catch { continue; }
       if (!g.ok) continue;
-      for (const entry of g.facts.entries) {
-        if (runs.size >= RUN_CAP) return out;
-        if (!CD.draftable(entry)) continue;
+      for (const [ei, entry] of g.facts.entries.entries()) {
+        if (!CD.draftable(entry) && !(entry.store && entry.by !== 'you')) continue;
         const st = CD.stateOf(entry, g.facts);
-        if (st.st !== 'due' || st.draft) continue;
+        if (!(st.st in RANK) || st.draft) continue;
         const k = runKey(w.id, g.facts.scope, entry.key);
         if (runs.has(k) || tried.get(k) === day) continue;
         const x = g.facts.store.get(`${g.facts.scope}|${entry.key}`);
         if (x && x.drafts.some((d) => CD.localDay(Date.parse(d.at)) === day)) continue;   // drafted today already (by a press, or before a restart)
-        tried.set(k, day);
-        const r = startRun(ctx, w, g.facts.scope, entry, { label: labelOf(g.facts), now });
-        out.push({ ws: w.id, scope: g.facts.scope, key: entry.key, ok: r.ok, ...(r.ok ? { run: r.run } : { error: r.error }) });
+        todo.push({ w, g, entry, k, order: [RANK[st.st], li, ei] });
       }
     }
   }
+  todo.sort((a, b) => a.order[0] - b.order[0] || a.order[1] - b.order[1] || a.order[2] - b.order[2]);
+  for (const t of todo) {
+    if (runs.size >= RUN_CAP) break;
+    tried.set(t.k, day);
+    const r = startRun(ctx, t.w, t.g.facts.scope, t.entry, { label: labelOf(t.g.facts), now });
+    out.push({ ws: t.w.id, scope: t.g.facts.scope, key: t.entry.key, ok: r.ok, ...(r.ok ? { run: r.run } : { error: r.error }) });
+  }
   return out;
 }
 

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.198.0",
+  "version": "0.199.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.198.0",
+      "version": "0.199.0",
       "license": "MIT",
       "dependencies": {
         "@xterm/addon-fit": "^0.11.0",

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.198.0",
+  "version": "0.199.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",