create-pmos 0.511.0 → 0.513.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.511.0",
+  "version": "0.513.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": {
@@ -32,6 +32,32 @@
     "audit"
   ],
   "pmosChanges": [
+    {
+      "v": "0.513.0",
+      "at": "2026-11-03T15:46:14.696Z",
+      "f": 4,
+      "prs": [
+        {
+          "n": 1203,
+          "t": "Typography roles with Plus Jakarta Sans, two weights, four sizes",
+          "s": "Typography roles with Plus Jakarta Sans, two weights, four sizes",
+          "k": "new"
+        }
+      ]
+    },
+    {
+      "v": "0.512.0",
+      "at": "2026-11-03T15:33:10.629Z",
+      "f": 4,
+      "prs": [
+        {
+          "n": 1204,
+          "t": "Suggest the next prompt and sharpen a rough one in the chat",
+          "s": "Suggest the next prompt and sharpen a rough one in the chat",
+          "k": "new"
+        }
+      ]
+    },
     {
       "v": "0.511.0",
       "at": "2026-11-03T15:10:29.930Z",
@@ -536,36 +562,6 @@
           "d": "On a phone the initiative page had uneven edges. Now everything lines up on one even margin."
         }
       ]
-    },
-    {
-      "v": "0.493.0",
-      "at": "2026-11-02T14:41:05.438Z",
-      "f": 4,
-      "prs": [
-        {
-          "n": 1152,
-          "t": "Retire Now / Next / Later; the Roadmap is one ranked list",
-          "s": "Retire Now / Next / Later; the Roadmap is one ranked list",
-          "k": "new",
-          "h": "One ranked roadmap",
-          "d": "The roadmap split work into Now, Next and Later. Now it is one ranked list, and each initiative's stage says where it is."
-        }
-      ]
-    },
-    {
-      "v": "0.492.0",
-      "at": "2026-11-02T10:50:33.055Z",
-      "f": 4,
-      "prs": [
-        {
-          "n": 1155,
-          "t": "A new user's empty PMOS folder no longer skips the setup conversation",
-          "s": "A new user's empty PMOS folder no longer skips the setup conversation",
-          "k": "fix",
-          "h": "New users get the setup conversation",
-          "d": "A new user with an empty PMOS folder landed on a bare Home. Now the setup conversation starts as it should."
-        }
-      ]
     }
   ]
 }

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@f8d9c6e4
+kernel-source: pmos@d90291c5
 assembled: 2026-11-03
 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-11-03T15:10:26Z"}
+generated: {by: process:create-pmos, at: "2026-11-03T15:46:12Z"}
 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-11-03T15:10:26Z"}
+generated: {by: process:create-pmos, at: "2026-11-03T15:46:12Z"}
 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-11-03T15:10:26Z"}
+generated: {by: process:create-pmos, at: "2026-11-03T15:46:12Z"}
 status: stable
 ---
 

package/workspace/briefing-premium-adddoc-test.js

@@ -145,7 +145,7 @@ const PAGES = {
     ok('A3 the add route takes POST only', wrong === 405);
   }
 
-  /* A8 fidelity: the form follows the Agreed design (premium-agreed-design): the Viewer is one cozy card in Nunito, its presses pills, the main one
+  /* A8 fidelity: the form follows the Agreed design (premium-agreed-design): the Viewer is one cozy card in Plus Jakarta Sans, its presses pills, the main one
    * the solid colour. The colours are read from the page's own tokens, so a theme is checked against itself. */
   for (const [w, h] of [[1280, 900], [390, 844]]) for (const th of ['light', 'dark']) {
     const R = await open('initiative', { w, h, theme: th });
@@ -159,8 +159,8 @@ const PAGES = {
       return { vw: cs('#czViewer').backgroundColor, card: tok('--cz-card', 'background-color'), vwR: cs('#czViewer').borderTopLeftRadius, ff: cs('#czViewer').fontFamily, go: [cs(go).backgroundColor, '700', cs(go).borderTopLeftRadius], solid: tok('--cz-solid', 'background-color'), no: bk ? getComputedStyle(bk).backgroundColor : 'rgba(0, 0, 0, 0)', dlg: !!(document.querySelector('#dlg') && !!document.querySelector('#dlg.on')) };
     });
     const d = [];
-    if (!/^Nunito/.test(btn.ff) || btn.br !== '999px') d.push('button ' + JSON.stringify(btn));
-    if (g.vw !== g.card || !/^Nunito/.test(g.ff) || (w > 760 && parseFloat(g.vwR) < 20)) d.push('viewer ' + [g.vw, g.card, g.vwR, g.ff].join(' '));
+    if (!/^"?Plus Jakarta Sans/.test(btn.ff) || btn.br !== '999px') d.push('button ' + JSON.stringify(btn));
+    if (g.vw !== g.card || !/^"?Plus Jakarta Sans/.test(g.ff) || (w > 760 && parseFloat(g.vwR) < 20)) d.push('viewer ' + [g.vw, g.card, g.vwR, g.ff].join(' '));
     if (g.go[0] !== g.solid || +g.go[1] < 700 || g.go[2] !== '999px') d.push('Add document ' + g.go.join(' ') + ' want ' + g.solid);
     if (g.no !== g.card && g.no !== 'rgba(0, 0, 0, 0)') d.push('Back ' + g.no);   // ← cancels (batch 18 item 2-C): the header's quiet round press
     if (g.dlg) d.push('the old dialog opened');

package/workspace/briefing-premium-board-test.js

@@ -645,11 +645,11 @@ const IVREAD = () => {
     await R.ctx.close();
   }
 
-  /* B13 the Agreed design's look: Nunito, the soft panel, the chips and the track's rows */
+  /* B13 the Agreed design's look: Plus Jakarta Sans, the soft panel, the chips and the track's rows */
   for (const th of ['light', 'dark']) {
     const R = await open({ w: 1440, h: 900, theme: th }), q = R.page;
     const s = await q.evaluate(() => { const cs = (sel) => getComputedStyle(document.querySelector(sel)); const main = cs('main.bd-main'), row = document.querySelector('.bt-l').getBoundingClientRect(); return { font: cs('body').fontFamily, rad: main.borderTopLeftRadius, bg: main.backgroundColor, chip: Math.round(document.querySelector('#chJira').getBoundingClientRect().height), row: Math.round(row.height), tab: cs('#tabIni').fontWeight, fab: cs('#czFab').borderTopLeftRadius }; });
-    ok(`B13 the look of the Agreed design at 1440 px, ${th}: Nunito, a 28 px panel, 30 px chips, 54 px rows`, /^"?Nunito/.test(s.font) && s.rad === '28px' && s.chip === 30 && s.row >= 54 && s.row <= 62 && s.tab === '700' && (th === 'light' ? s.bg === 'rgb(255, 255, 255)' : s.bg !== 'rgb(255, 255, 255)'), JSON.stringify(s));
+    ok(`B13 the look of the Agreed design at 1440 px, ${th}: Plus Jakarta Sans, a 28 px panel, 30 px chips, 54 px rows`, /^"?Plus Jakarta Sans/.test(s.font) && s.rad === '28px' && s.chip === 30 && s.row >= 54 && s.row <= 62 && s.tab === '600' && (th === 'light' ? s.bg === 'rgb(255, 255, 255)' : s.bg !== 'rgb(255, 255, 255)'), JSON.stringify(s));
     await R.ctx.close();
   }
   return finish();

package/workspace/briefing-premium-initiative-test.js

@@ -252,7 +252,7 @@ const WRITES = /^\/api\/(?:boards\/(?:move|tasks\/(?:add|state))|lifecycle|core-
     const post = await fetch(BASE + '/api/initiative-premium?id=x', { method: 'POST' }); ok('I10 the route answers GET only', post.status === 405);
   }
 
-  /* I12 fidelity: the Agreed design (premium-agreed-design, Inside one initiative): Nunito, the cozy card, the CTA in the solid colour, the floating
+  /* I12 fidelity: the Agreed design (premium-agreed-design, Inside one initiative): Plus Jakarta Sans, the cozy card, the CTA in the solid colour, the floating
    * menu. The colours are read from the page's own tokens, so each theme is checked against itself. */
   for (const [w, h] of [[1440, 900], [390, 844]]) for (const th of ['light', 'dark']) {
     const R = await open({ w, h, theme: th });
@@ -264,7 +264,7 @@ const WRITES = /^\/api\/(?:boards\/(?:move|tasks\/(?:add|state))|lifecycle|core-
       return { font: cs('body').fontFamily, cta: (cs('#czViewer .iv-go') || {}).backgroundColor, ctaAlt: !document.querySelector('#czViewer .iv-go'), solid: tok('--cz-solid'), blue: tok('--cz-blue'), well: tok('--cz-well'), card: tok('--cz-card'), box: cs('#czViewer .iv-mc').backgroundColor, rad: parseFloat(cs(innerWidth <= 760 ? '#czViewer .iv-tel' : '#czViewer .iv-mc').borderTopLeftRadius), fab: fr ? [Math.round(fr.width), Math.round(fr.height)] : null, over: document.documentElement.scrollWidth - innerWidth, cardW: Math.round(c.width) };
     });
     const d = [];
-    if (!/^Nunito/.test(g.font)) d.push('font ' + g.font);
+    if (!/^"?Plus Jakarta Sans/.test(g.font)) d.push('font ' + g.font);
     if (!g.ctaAlt && ![g.solid, g.blue].includes(g.cta)) d.push('cta ' + g.cta + ' want ' + g.solid + ' or ' + g.blue);
     if (![g.well, g.card].includes(g.box) && !/rgba/.test(g.box)) d.push('card box ' + g.box);
     // a phone has no wrapper card (batch 23 item 5, canvas PmA): the mission is the first card there
@@ -272,7 +272,7 @@ const WRITES = /^\/api\/(?:boards\/(?:move|tasks\/(?:add|state))|lifecycle|core-
     // on a phone the initiative's page is the Viewer, full screen over the list: the floating menu waits under it (HbCPhone)
     if (w > 760 && (!g.fab || g.fab[0] !== 56 || g.fab[1] !== 56)) d.push('fab ' + JSON.stringify(g.fab));
     if (g.over > 0) d.push('sideways scroll ' + g.over);
-    ok(`I12 the initiative follows the Agreed design at ${w} px, ${th}: Nunito, the cozy card, the CTA, the floating menu`, d.length === 0, d.join(' ; '));
+    ok(`I12 the initiative follows the Agreed design at ${w} px, ${th}: Plus Jakarta Sans, the cozy card, the CTA, the floating menu`, d.length === 0, d.join(' ; '));
     ok(`I12 no page error at ${w} px, ${th}`, R.errors.length === 0, R.errors.join(' | '));
     await R.ctx.close();
   }

package/workspace/briefing-premium-insights-test.js

@@ -603,13 +603,13 @@ const BMR = { ok: true, state: 'ready', model: { tiles: [
     await R.ctx.close();
   }
 
-  /* I11 fidelity to the Agreed design (AgInsGoals, AgInsPhone): Nunito, the cozy panel, the pill tabs, the table, the strip and the six tiles */
+  /* I11 fidelity to the Agreed design (AgInsGoals, AgInsPhone): Plus Jakarta Sans, the cozy panel, the pill tabs, the table, the strip and the six tiles */
   for (const [w, h] of [[1440, 900], [390, 844]]) {
     const R = await open({ w, h }); await sleep(300);
     const f = await R.page.evaluate(() => { const cs = (s) => getComputedStyle(document.querySelector(s)); const main = cs('main.ins'), tab = cs('#viewChip'), strip = cs('#insHero'), row = document.querySelector('#goalTbl .ins-row').getBoundingClientRect();
       return { font: cs('body').fontFamily, radius: main.borderTopLeftRadius, bg: main.backgroundColor, tabBg: tab.backgroundColor, tabR: tab.borderTopLeftRadius, tabW: tab.fontWeight, stripR: strip.borderTopLeftRadius, stripBg: strip.backgroundColor, rowH: Math.round(row.height), over: document.documentElement.scrollWidth > innerWidth, fab: document.querySelector('#czFab').getBoundingClientRect().width, fabX: Math.round(document.querySelector('#czFab').getBoundingClientRect().left) }; });
     const phone = w < 720;
-    ok(`I11 the page wears the Agreed design at ${w} px: Nunito, the white panel, the pill View chip, the well strip, 56 px floating button`, /^Nunito/.test(f.font) && f.radius === (phone ? '0px' : '28px') && (phone || f.bg === 'rgb(255, 255, 255)') && f.tabBg === 'rgb(244, 243, 240)' && f.tabR === '999px' && +f.tabW >= 700 && (phone || (f.stripR === '16px' && f.stripBg === 'rgb(244, 243, 240)' && f.rowH >= 60)) && !f.over && f.fab === 56 && (phone ? f.fabX > 300 : f.fabX === 36), JSON.stringify(f));
+    ok(`I11 the page wears the Agreed design at ${w} px: Plus Jakarta Sans, the white panel, the pill View chip, the well strip, 56 px floating button`, /^"?Plus Jakarta Sans/.test(f.font) && f.radius === (phone ? '0px' : '28px') && (phone || f.bg === 'rgb(255, 255, 255)') && f.tabBg === 'rgb(244, 243, 240)' && f.tabR === '999px' && +f.tabW >= 600 && (phone || (f.stripR === '16px' && f.stripBg === 'rgb(244, 243, 240)' && f.rowH >= 60)) && !f.over && f.fab === 56 && (phone ? f.fabX > 300 : f.fabX === 36), JSON.stringify(f));
     if (!phone) {
       await toTrends(R.page);
       const t = await R.page.evaluate(() => { const tiles = [...document.querySelectorAll('#bmBody [data-tile]')].map((x) => x.getBoundingClientRect()); return { n: tiles.length, tileH: tiles.length ? Math.round(tiles[0].height) : 0, over: document.documentElement.scrollWidth > innerWidth }; });

package/workspace/briefing-premium-sources-test.js

@@ -193,7 +193,7 @@ const sh = (cwd, args) => spawnSync('git', args, { cwd, encoding: 'utf8' });
   {
     // re-pointed again for the Agreed design's Home: the source row is a Needs-you row of Home's list, and the digest is a row of New for you.
     // Re-pointed for Home A + C (HvAC, HvACDesk): a row is one line, its mark and its title; the subject moved to the row's tooltip and
-    // accessible name, and the title is 14 px on a desktop, 16 px on a phone, weight 600 (the type scale, feedback batch 15 item 2)
+    // accessible name, and the title is the row title role, 15 px at 600 (feedback batch 26 item 6)
     const ROWS = [['row', '.hm-rm'], ['number', '.hv-d'], ['title', '.hm-rt b']];
     const DIGS = [['event', ''], ['eventTime', '.ev-tx .ev-mut'], ['eventTitle', '.ev-tx b']];
     const SANS = 'var(--cz-sans)';
@@ -201,10 +201,10 @@ const sh = (cwd, args) => spawnSync('git', args, { cwd, encoding: 'utf8' });
     const WANT = {
       row: { fontFamily: SANS, color: 'var(--cz-ink)', backgroundColor: 'transparent' },
       number: { backgroundColor: 'var(--cz-blue)', borderRadius: '50%', width: '8px', height: '8px' },   // the row's dot is blue: it waits on you (HvAC .d)
-      title: { fontFamily: SANS, fontSize: '14px', fontWeight: '600', color: 'var(--cz-ink)' },   // HvACDesk .t; 16px on a phone (HvAC .t b)
+      title: { fontFamily: SANS, fontSize: 'var(--fs-row)', fontWeight: 'var(--fw-strong)', color: 'var(--cz-ink)' },   // the row title role (batch 26 item 6), desktop and phone
       event: { fontFamily: SANS, color: 'var(--cz-ink)', backgroundColor: 'transparent' },   // a row of New for you's table (cozy-ev.css)
-      eventTime: { fontSize: '12px', color: 'var(--cz-ink3)' },
-      eventTitle: { fontFamily: SANS, fontSize: '14px', fontWeight: '700', color: 'var(--cz-ink)' },
+      eventTime: { fontSize: 'var(--fs-meta)', color: 'var(--cz-ink3)' },
+      eventTitle: { fontFamily: SANS, fontSize: 'var(--fs-row)', fontWeight: 'var(--fw-strong)', color: 'var(--cz-ink)' },
     };
     const grab = (pg, pairs, base, col) => pg.evaluate(([pairs, want, base, col]) => {
       const o = {};
@@ -235,7 +235,6 @@ const sh = (cwd, args) => spawnSync('git', args, { cwd, encoding: 'utf8' });
       await allNeeds(R.page);
       // on a phone "Not in an initiative" starts folded (HvAC): open it to reach the source row
       if (w === 390) { const lh = await R.page.$('#hmList .hv-lh[aria-expanded="false"]'); if (lh) await lh.click(); }
-      WANT.title.fontSize = w === 390 ? '16px' : '14px';
       await sleep(500);
       const rowSel = '#hmList .hm-r[data-id^="n:src:"]';
       const diffs = diff(await grab(R.page, ROWS, rowSel, '.hm-pg'), ROWS, 4);   // the row fills its group (the group's own inset aside)

package/workspace/briefing-premium-test.js

@@ -127,7 +127,7 @@ const vw = () => { const v = document.querySelector('#czViewer:not([hidden])');
     const selBg = await p.evaluate(() => getComputedStyle(document.querySelector('.hm-r.sel')).backgroundColor);
     ok('R12 the selected row is tinted (HvACDesk .sel)', selBg && !/rgba\(0, 0, 0, 0\)|transparent/.test(selBg), selBg);
     const hd = await p.evaluate(() => { const h = document.querySelector('#hmCh'); return h && !h.hidden ? { t: (h.querySelector('.hm-chb') || {}).textContent || '', mark: !!h.querySelector('.hv-mk .hv-d, .hv-mk .hv-ck'), y: Math.round(h.getBoundingClientRect().top), size: getComputedStyle(h.querySelector('.hm-chb')).fontSize } : null; });
-    ok('R12 the chat\'s header line names the open row: its mark and its title, 16 px (the type scale, batch 15), at the top of the chat card (HvACDesk .ch)', !!hd && hd.t === r0.t && hd.mark && hd.y === 32 && hd.size === '16px', JSON.stringify(hd)); }
+    ok('R12 the chat\'s header line names the open row: its mark and its title, 15 px (the row title role, batch 26 item 6), at the top of the chat card (HvACDesk .ch)', !!hd && hd.t === r0.t && hd.mark && hd.y === 32 && hd.size === '15px', JSON.stringify(hd)); }
 
   /* R10 */
   ok('R10 a page where nothing was pressed to record sends no POST', A.posts.filter((x) => /briefing-premium\/(decide|put-off|return|start)/.test(x.path)).length === 0, JSON.stringify(A.posts.map((x) => x.path)));
@@ -273,7 +273,7 @@ const vw = () => { const v = document.querySelector('#czViewer:not([hidden])');
       const desk = document.querySelector('#hmDesk'), list = document.querySelector('#hmList'), cs = getComputedStyle(document.querySelector('#hmChat')), r = list.getBoundingClientRect();
       return { inset: Math.round(r.left), radius: cs.borderTopLeftRadius, list: Math.round(list.getBoundingClientRect().width), font: getComputedStyle(document.body).fontFamily, theme: document.documentElement.dataset.theme || '', bg: getComputedStyle(document.body).backgroundColor, rail: !!document.querySelector('nav.rail'), menu: !!document.querySelector('#czMenu, .cz-nav') };
     });
-    ok(`R12 Home follows the Home A + C design at 1440 px (HvACDesk), ${theme}: the list at 16 px and 360 px wide, the chat a card with a 24 px radius, Nunito, the floating place menu, no rail`, f.inset === 16 && f.radius === '24px' && f.list === 360 && /Nunito/.test(f.font) && f.menu && !f.rail, JSON.stringify(f));
+    ok(`R12 Home follows the Home A + C design at 1440 px (HvACDesk), ${theme}: the list at 16 px and 360 px wide, the chat a card with a 24 px radius, Plus Jakarta Sans, the floating place menu, no rail`, f.inset === 16 && f.radius === '24px' && f.list === 360 && /Plus Jakarta Sans/.test(f.font) && f.menu && !f.rail, JSON.stringify(f));
     await D.ctx.close();
   }
   return finish();

package/workspace/changelog.json

@@ -1,4 +1,30 @@
 [
+ {
+  "v": "0.513.0",
+  "at": "2026-11-03T15:46:14.696Z",
+  "f": 4,
+  "prs": [
+   {
+    "n": 1203,
+    "t": "Typography roles with Plus Jakarta Sans, two weights, four sizes",
+    "s": "Typography roles with Plus Jakarta Sans, two weights, four sizes",
+    "k": "new"
+   }
+  ]
+ },
+ {
+  "v": "0.512.0",
+  "at": "2026-11-03T15:33:10.629Z",
+  "f": 4,
+  "prs": [
+   {
+    "n": 1204,
+    "t": "Suggest the next prompt and sharpen a rough one in the chat",
+    "s": "Suggest the next prompt and sharpen a rough one in the chat",
+    "k": "new"
+   }
+  ]
+ },
  {
   "v": "0.511.0",
   "at": "2026-11-03T15:10:29.930Z",

package/workspace/fixtures/next-prompt-replay.json

@@ -0,0 +1,40 @@
+{
+  "about": "Recorded answers for the next-prompt and sharpen-prompt replay gates (lib/routes-next-prompt.js). Each answer was given by claude-sonnet-5-5 on a real reply from the PMOS project threads on 2026-11-03, except the cases named as made up, which test a drop. The replay never calls a model.",
+  "next": [
+    { "name": "a reply that asks a question gets the answer as a follow card, citing the line it answers",
+      "reply": "#1198 (no initiative without an expected outcome) is merged, and kit-publish is publishing it.\nAll five approved features are now merged except the hindsight engine, which stays unbuilt because there are only 1 of the 10 needed prediction-and-outcome pairs. Do you want to swap it for another idea, such as a period-end KR debrief, or stay at four?",
+      "answer": { "cards": [{ "move": "follow", "text": "Yes, swap the hindsight engine for the period-end KR debrief.", "from": "Do you want to swap it for another idea, such as a period-end KR debrief, or stay at four?" }] },
+      "expect": { "filed": 1 } },
+    { "name": "a retired thing in an initiative chat gets an ask-the-past card, citing the verb that answers it",
+      "place": { "initiative": "Fix OOH Digital missing from Board" },
+      "reply": "Found the cause: the Board hid initiatives on the Later horizon. Retiring Now/Next/Later everywhere is a bigger change, so I asked for a separate thread for it.",
+      "answer": { "cards": [{ "move": "past", "text": "Did we ever decide to retire the Now/Next/Later stage? Answer from the records with file:line sources, or say No record found." }] },
+      "expect": { "filed": 1, "cites": ["lib/pmos-verbs.js"] } },
+    { "name": "a reply that needs nothing gets no card",
+      "reply": "First I'll find why OOH Digital is ticked in the product filter but has no rows on the Board.",
+      "answer": { "cards": [] },
+      "expect": { "none": true } },
+    { "name": "made up: a move PMOS does not have is dropped",
+      "reply": "PR #1171 is merged.",
+      "answer": { "cards": [{ "move": "deploy", "text": "Deploy PR #1171 to production now." }] },
+      "expect": { "none": true } },
+    { "name": "made up: a follow card that quotes a line the reply never said is dropped",
+      "reply": "PR #1171 is merged. Tell me if any task still sits under \"Not in a stage\".",
+      "answer": { "cards": [{ "move": "follow", "text": "Yes, merge it.", "from": "Should I merge PR #1171 now or wait?" }] },
+      "expect": { "none": true } },
+    { "name": "made up: ask the past outside an initiative chat is dropped",
+      "reply": "Retiring Now/Next/Later everywhere is a bigger change.",
+      "answer": { "cards": [{ "move": "past", "text": "Why did we retire Now/Next/Later?" }] },
+      "expect": { "none": true } }
+  ],
+  "sharpen": [
+    { "name": "a rough date move becomes a rehearsal, citing what the PM typed",
+      "text": "move the legal review 3 days later",
+      "answer": { "text": "Rehearse moving the legal review task in Ooh-digital 3 days later: show what it pushes back and which dates or tasks shift, then wait for my yes before changing anything." },
+      "expect": { "filed": 1 } },
+    { "name": "a sharper prompt that says the same is not shown",
+      "text": "Hotfix, why OOH digital product isn't shown here",
+      "answer": { "text": "Hotfix: why isn't the OOH digital product shown here?" },
+      "expect": { "none": true } }
+  ]
+}

package/workspace/guide/home.md

@@ -9,7 +9,7 @@ timestamp: 2026-11-03
 
 Home is the page at `/premium.html`. It follows the Agreed design and the "Uncovered features" canvas (initiative `premium-uncovered-features`). The left side is one list. The middle is the chat. The right side is the Viewer. A row opens its item in the Viewer. On a phone the list is the page, and a row opens its conversation with a back bar.
 
-Home, the Board, Insights and the Viewer use one type scale: 11, 12, 14, 16, 20 and 28 px. A list row's name is 14 px on a desktop and 16 px on a phone, a group head is 16 px, the quiet meta line and a chip are 12 px, a badge is 11 px, a page title is 20 px and a large number is 28 px. The same kind of text has the same size on every page; weight and colour make the difference, not a half pixel.
+Home, the Board, Insights and the Viewer use one typeface, Plus Jakarta Sans, with two weights (regular and semibold) and four sizes: 13, 15, 18 and 26 px. Each kind of text has one role, and the role sets its size, weight and line height: a large number and a page title are 26 px, a panel title is 18 px, a group head, a row's name and a sentence are 15 px, and the quiet meta line, a label and a badge are 13 px. The same kind of text looks the same on every page. Rows have room to breathe, so a list row is about 52 to 58 px high. There is no compact setting. Slides and report templates keep their own sizes.
 
 ## The list
 

package/workspace/guide/index.md

@@ -81,6 +81,7 @@ On a desktop the workspace is one frame. [Layout](layout.md) explains each part.
 - [Initiatives › Timeline](initiatives-timeline.md): when each initiative runs, one row per initiative, and how to reorder rows by their grip.
 - [Workflows](workflows.md): Settings › Workflows, the stages each kind of initiative goes through, New workflow in the chat, and `pmos workflow`.
 - [Expected outcomes](outcomes.md): every initiative says what should change once it ships and when to check it. Claude drafts each one from the PRD or the KR, you keep it with ✓, and `pmos outcomes`.
+- [The next prompt, suggested and sharpened](next-prompt.md): after a reply, up to two prompts to send next; while you type a rough prompt, a sharper version in your style (Polish, Prompt engineer, Your own).
 - [Rehearse a plan](rehearse.md): before you approve a date change or a cut, Claude shows what it breaks or helps in other initiatives, goals and program milestones, with the record each effect comes from, and `pmos rehearse`.
 - [Forecasts](forecast.md): how a goal, a delivery, a program and a health budget are forecast, the states, the kept baseline, and `pmos forecast`.
 - [Programs on the Board](programs.md): All products, programs first then products, By product, the program panel and its milestones, and the 60 % side panels.

package/workspace/guide/next-prompt.md

@@ -0,0 +1,62 @@
+---
+type: Guide
+title: "The next prompt, suggested and sharpened"
+description: "After a reply, the chat suggests what to say next. While you type a rough prompt, Claude offers a sharper version. What each card means, the styles, the settings, and the guardrails."
+timestamp: 2026-11-03
+---
+
+# The next prompt, suggested and sharpened
+
+You do not have to remember phrases such as "grill this". The chat suggests them when they fit.
+
+## After a reply
+
+When Claude finishes a reply, up to two cards can show above the box. Usually there is one.
+
+- The card Claude recommends is white, with a blue ring and a blue ✦. Another card is grey.
+- Tap a card to put its text in the box. Nothing is sent. Change the text if you want to, then send it with ↑.
+- The cards go away when you type, or when Claude starts a new reply. They do not time out.
+- When there is no clear next step, no card shows.
+
+A card suggests only something that works in PMOS today:
+
+- an answer to the question or the offer at the end of the reply;
+- "Grill this …" in an initiative's chat ([Claude proposes](claude-proposes.md));
+- "Why did we …?" in an initiative's chat ([Ask about the past](ask-the-past.md));
+- "Rehearse moving …" before a date change or a cut ([Rehearse a plan](rehearse.md));
+- "Run the drift replay" when the weekly check waits for it ([What you might have missed](what-you-missed.md)).
+
+Each card names only the initiatives, tasks and PRs that the reply or your message names.
+
+## While you type
+
+When you stop typing for about 1.5 seconds on a rough prompt of three or more words, a small spinner card shows while Claude sharpens it. Then one lit **Sharper** card shows. Tap it to put the sharper text in the box. ↶ in the box puts back what you wrote. When the sharper version says the same as yours, no card shows.
+
+The sliders icon on the Sharper card sets how Claude sharpens:
+
+- **Polish**: clearer and shorter. Your meaning is kept.
+- **Prompt engineer** (the default): the best prompt for the job. It names the real initiative or task and says what a good answer holds. A date move or a cut becomes a rehearsal that waits for your yes.
+- **Your own**: your own wording rules. You write them once in Settings.
+
+The same menu has the **Sharpen as I type** switch. Off means no spinner and no Sharper card.
+
+## Settings › Claude › Sharpen prompts
+
+| Row | What it does |
+|---|---|
+| Suggest the next prompt | On by default. Off: no cards after a reply. |
+| Sharpen as I type | On when Claude's runs use your API key (Settings › Claude › API key), because a sharper version then shows in about 2 seconds. Without a key, each one is a background Claude run that takes 10 seconds or more, so it starts off. You can turn it on anyway. |
+| Sharpen as | Polish, Prompt engineer or Your own. |
+| Your own rules | The rules for Your own, up to 1000 characters. |
+
+## The guardrails
+
+The suggestions and the sharper prompt go through the same guardrail as every AI job in PMOS:
+
+- **Propose only.** A card is text you can put in the box. Nothing is sent, and nothing is written to a record, a session or a repository.
+- **Proven only.** Each suggested move points to the line of PMOS code that makes it work, and PMOS checks that line before the card shows. An answer to the reply points to the line of the reply it answers. A card that PMOS cannot check is not shown.
+- **Replay-tested.** A new version shows nothing until its recorded cases pass, and those include cases that must be dropped.
+- **Audited.** Each run writes a line to the AI audit, with no text of your conversation in it.
+- **Off switch.** `pmos ai off next-prompt` stops the suggestions after a reply. `pmos ai off sharpen-prompt` stops the Sharper card. `pmos ai off` stops every AI job.
+
+The reply and the words a card refers to are kept in your PMOS state folder (`next-prompt/`, the newest 30 files), outside every repository. Your choices for these rows are kept there too, in `next-prompt/prefs.json`.

package/workspace/guide/settings.md

@@ -35,7 +35,7 @@ Settings is not a tab. While it is open, no tab is selected. Press a tab to go b
 | Claude sessions | What a new session starts with: the CLI, the model, the Claude profile and the launch flags for sessions you start, and the flags for automatic sessions. The session limits. Validate consent for this workspace. |
 | Privacy and data | A list of what leaves this computer and when. Whether a TypeSafe key is saved, the local model that answers when there is no key (Off, Winnow or Laya), and the data folder. |
 | Appearance | The theme (Same as system, Light or Dark) and the page that opens first. |
-| Claude | The Claude profile that new Claude sessions start with, and the Anthropic API key for Claude's own runs on the API (see below). |
+| Claude | The Claude profile that new Claude sessions start with, the Anthropic API key for Claude's own runs on the API, and Sharpen prompts (see below). |
 | Claude's checks | When Claude grills an initiative by itself (Full, Only at stage exits, or Off) and the monthly credit for its checks ($5, $10, $20 or $50), with what this month used. See below. |
 | Updates | The version of the app and of each workspace's kit, the check for updates, and what changed in each week's kits (what's new). See below. |
 
@@ -85,6 +85,8 @@ Under the update card, **Updates** shows what changed in the published kits. **T
 
 **API key.** Some runs of Claude, for example Grill, can use the Claude API and not a Claude session. Paste an Anthropic API key and press **Save** to turn this on. The key stays on this computer, in a file only you can read, outside every repository. PMOS never shows the key again: the row only says that a key is set. Press **Remove** to delete it. A key saved here is used before `ANTHROPIC_API_KEY`. A command that a run starts does not get the key. Only the computer that runs the workspace can change it. Set `PMOS_GRILL_API=off` to stop runs on the API.
 
+**Sharpen prompts.** Suggest the next prompt (on by default) shows up to two prompts above the chat box after a reply. Sharpen as I type offers a sharper version of a rough prompt. It is on when an API key is set, and off without one, because a background run is too slow to follow your typing. Sharpen as picks Polish, Prompt engineer (the default) or Your own, and Your own rules holds the rules for Your own. The same style and switch are in the menu on the chat's Sharper card. See [The next prompt, suggested and sharpened](next-prompt.md).
+
 ## Claude's checks: when Claude grills, and what it may spend
 
 Claude grills an initiative by itself and files what it finds under the initiative's ✦ (see the Claude proposes guide). There is no button to start it. This section is the only control.

package/workspace/intel-report-ui-test.js

@@ -88,7 +88,7 @@ const FINDING = { id: 'rf-0123456789', name: 'Partner numbers to Lee', why: 'You
   };
   const vClose = async (pg) => { for (let k = 0; k < 4; k++) { const shown = await pg.evaluate(() => { const v = document.querySelector('#czViewer'); return !!v && !v.hidden; }); if (!shown) break; await pg.evaluate(() => window.czViewer && window.czViewer.close()); await sleep(250); } };
   const sizes = (p, sel) => p.evaluate((s) => [...new Set([...document.querySelectorAll(s + ', ' + s + ' *')].filter((e) => e.childNodes.length && [...e.childNodes].some((n) => n.nodeType === 3 && n.textContent.trim())).map((e) => getComputedStyle(e).fontSize))], sel);
-  const SCALE = new Set(['11px', '12px', '14px', '16px', '20px', '28px']);
+  const SCALE = new Set(['13px', '15px', '18px', '26px']);   // the typography roles (batch 26 item 6)
   const panel = (p) => p.evaluate(() => {
     const b = document.querySelector('#czViewer:not([hidden]) .ins-rpd') || document.querySelector('#side:not([hidden]) .ins-rpd'); if (!b) return null;
     return { title: (document.querySelector('#czViewer .cz-vw-title') || {}).textContent || '', kind: (document.querySelector('#czViewer .cz-vw-kind') || {}).textContent || '', sum: (b.querySelector('.ins-rps b') || {}).textContent || '',

package/workspace/intelligence-gaps-ui-test.js

@@ -157,7 +157,7 @@ const WEEKLY = { view: 'view', weeks: 3, day: 'Mon', opens: 4 };
   await p.evaluate(() => document.querySelector('#mdHost').remove());
 
   /* ── T: the type scale ── */
-  const SCALE = new Set(['11px', '12px', '14px', '16px', '20px', '28px']);
+  const SCALE = new Set(['13px', '15px', '18px', '26px']);   // the typography roles (batch 26 item 6)
   const sizes = await p.evaluate(() => [...new Set([...document.querySelectorAll('#insHero, #insHero *, #nsRow, #nsRow *')].filter((e) => e.childNodes.length && [...e.childNodes].some((n) => n.nodeType === 3 && n.textContent.trim())).map((e) => getComputedStyle(e).fontSize))]);
   ok('T the strip and the drafts use the type scale only', sizes.every((s) => SCALE.has(s)), sizes.join());
   ok('no page errors', !A.errors.length, A.errors.join(' | '));