create-pmos 0.519.0 → 0.521.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.519.0",
+  "version": "0.521.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.521.0",
+      "at": "2026-11-04T02:17:43.880Z",
+      "f": 4,
+      "prs": [
+        {
+          "n": 1217,
+          "t": "Sharper prompt keeps to the composer column and starts lean",
+          "s": "Sharper prompt keeps to the composer column and starts lean",
+          "k": "fix"
+        }
+      ]
+    },
+    {
+      "v": "0.520.0",
+      "at": "2026-11-04T01:52:53.932Z",
+      "f": 4,
+      "prs": [
+        {
+          "n": 1216,
+          "t": "Every initiative has its own description",
+          "s": "Every initiative has its own description",
+          "k": "new"
+        }
+      ]
+    },
     {
       "v": "0.519.0",
       "at": "2026-11-04T01:26:27.710Z",
@@ -368,36 +394,6 @@
           "d": "The Timeline still cut long task names short. Now they wrap in full there too."
         }
       ]
-    },
-    {
-      "v": "0.501.0",
-      "at": "2026-11-03T04:49:22.234Z",
-      "f": 4,
-      "prs": [
-        {
-          "n": 1184,
-          "t": "Home's list toggle always opens and closes the list",
-          "s": "Home's list toggle always opens and closes the list",
-          "k": "fix",
-          "h": "Home's list opens and closes",
-          "d": "On a wide Viewer, Home's list could fold away and refuse to open again. Now the toggle opens and closes it every time."
-        }
-      ]
-    },
-    {
-      "v": "0.500.0",
-      "at": "2026-11-03T04:25:59.021Z",
-      "f": 4,
-      "prs": [
-        {
-          "n": 1183,
-          "t": "Delete a captured meeting-note point from its edit card",
-          "s": "Delete a captured meeting-note point from its edit card",
-          "k": "new",
-          "h": "Delete a meeting point",
-          "d": "A point captured from a meeting could not be removed. Now you can delete it from its edit card."
-        }
-      ]
     }
   ]
 }

package/payload/AGENTS.md

@@ -33,7 +33,7 @@ It refuses frontmatter, fenced and indented code, table rows, headings, delibera
 
 | Hosted tool (as skills name them) | File-mode equivalent |
 |---|---|
-| `create_initiative` | write `pmos/state/initiatives/<id>.md` (frontmatter: id, title, parent_kr, stage, status, **type** — the D56 lane, default `feature` — plus `intent` for the chore lane, prd_path, rubric_path, created; plus `outcome_metric` + `outcome_horizon` — the D57 declaration for post-ship success criteria. No initiative goes without one: after you create it, and once its PRD exists, run `pmos outcomes propose <id>` and show the cited draft; write it with `pmos outcomes declare` only after the PM's yes) |
+| `create_initiative` | write `pmos/state/initiatives/<id>.md` (frontmatter: id, title, parent_kr, stage, status, **type** — the D56 lane, default `feature` — plus `intent` for the chore lane, prd_path, rubric_path, created; plus `outcome_metric` + `outcome_horizon` — the D57 declaration for post-ship success criteria. No initiative goes without one: after you create it, and once its PRD exists, run `pmos outcomes propose <id>` and show the cited draft; write it with `pmos outcomes declare` only after the PM's yes; plus `description` — one paragraph that says what the initiative is, shown in About before any PRD exists: `pmos initiative describe <id>` lists the cited lines to draft it from, and `pmos initiative describe <id> "<text>"` writes it only after the PM's yes) |
 | `save_spec` | the PRD file itself at `pmos/planning/prd/<id>-prd.md` (set `prd_path` on the initiative file) |
 | `get_spec` / `get_planning_artifact` | read `pmos/planning/…` |
 | `get_skill` | read `pmos/skills/<name>.skill` |

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@ae404bea
+kernel-source: pmos@2ac0d2f5
 assembled: 2026-11-04
 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-04T01:26:24Z"}
+generated: {by: process:create-pmos, at: "2026-11-04T02:17:40Z"}
 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-04T01:26:24Z"}
+generated: {by: process:create-pmos, at: "2026-11-04T02:17:40Z"}
 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-04T01:26:24Z"}
+generated: {by: process:create-pmos, at: "2026-11-04T02:17:40Z"}
 status: stable
 ---
 

package/workspace/changelog.json

@@ -1,4 +1,30 @@
 [
+ {
+  "v": "0.521.0",
+  "at": "2026-11-04T02:17:43.880Z",
+  "f": 4,
+  "prs": [
+   {
+    "n": 1217,
+    "t": "Sharper prompt keeps to the composer column and starts lean",
+    "s": "Sharper prompt keeps to the composer column and starts lean",
+    "k": "fix"
+   }
+  ]
+ },
+ {
+  "v": "0.520.0",
+  "at": "2026-11-04T01:52:53.932Z",
+  "f": 4,
+  "prs": [
+   {
+    "n": 1216,
+    "t": "Every initiative has its own description",
+    "s": "Every initiative has its own description",
+    "k": "new"
+   }
+  ]
+ },
  {
   "v": "0.519.0",
   "at": "2026-11-04T01:26:27.710Z",

package/workspace/guide/agent-capabilities.md

@@ -31,6 +31,7 @@ This page lists every job, so you know what runs and why. Each row links to the
 | [New dates, done and tidy names](claude-proposes.md) | Each morning, and when a date passes | The tasks of the initiative, and the evidence that work happened | The initiative's ✦ | `PMOS_PROPOSE=off` |
 | [Grill](claude-proposes.md) | Before an initiative leaves a stage, when a forecast turns at risk, when scope or dates move a lot, and once a month on running work with late work. Also when you write "grill this" in the initiative's chat. | The initiative, your stored research, your meeting notes and the decisions that stand | "Claude grilled it" under the initiative's ✦ | Settings › Claude's checks: Off. `PMOS_GRILL=off` |
 | [You decided this before](ask-the-past.md) | You add an initiative that repeats an earlier decision | `DECISIONS.md`, the decision records, the PM journal, `planning/out-of-scope/` and the initiative records | The initiative's ✦ | `pmos ai off past-repeat` |
+| [Initiative descriptions](descriptions.md) | Once a day. At most 3 drafts a day for each product. | The PRD's first Problem or Why paragraph, or the record's own first paragraph | "Description" under the initiative's ✦ | `pmos ai off descriptions`. `PMOS_DESCRIPTIONS=off` |
 | [Expected outcomes](outcomes.md) | Once a day. At most 3 drafts a day for each product. | The PRD's success criteria, or the anchored key result | "Expected outcome" under the initiative's ✦. Today when a check is due. | `pmos ai off outcomes`. `PMOS_OUTCOMES=off` |
 | [Metric drafts](metric-drafts.md) | A product with no North Star, the first 14 days of a quarter, a program with no goal, and an initiative that gets a PRD | The last 8 weeks of real readings | The page of that product, program or initiative | `PMOS_METRIC_DRAFT=off` |
 | [Horizon scan](horizon-scan.md) | Daily by default, at most once a day. Scan now: at most 3 a day. | The public web for your kept watch list, and your repository | Report documents and proposals you approve | Cadence: Off. `PMOS_SCAN=off` |
@@ -70,4 +71,4 @@ When you ask an agent session to do a piece of work, it can finish it, including
 - `pmos ai log [<job>]`: the last audit lines. Each dropped proposal shows why.
 - `pmos ai off [<job>]` and `pmos ai on [<job>]`: turn every AI job, or one job, off or on. `PMOS_AI=off` in the environment wins over the setting.
 
-The AI jobs are `past-repeat`, `decision-memory`, `outcomes`, `drift`, `rehearse`, `next-prompt` and `sharpen-prompt`. A background run cannot change the switch.
+The AI jobs are `past-repeat`, `decision-memory`, `outcomes`, `descriptions`, `drift`, `rehearse`, `next-prompt` and `sharpen-prompt`. A background run cannot change the switch.

package/workspace/guide/descriptions.md

@@ -0,0 +1,43 @@
+---
+type: Guide
+title: "Initiative descriptions"
+description: "Every initiative says what it is in About, before any PRD exists. Where the description is kept, how Claude drafts it, how you keep one, how a PRD enriches it, and pmos initiative describe."
+timestamp: 2026-11-04
+---
+
+# Initiative descriptions
+
+Every initiative has a description: one paragraph that says what it is. About, in the initiative's mission control, shows it. An initiative needs one long before its PRD is written.
+
+## Where it is kept
+
+The description is the `description:` line in the initiative's record. It is not in the PRD. One paragraph, up to 700 characters.
+
+## What About shows
+
+- The record has a description: About shows it.
+- The PRD says more than the description: About also shows the PRD's paragraph once, below it, marked **From the PRD**.
+- The record has no description: About shows the PRD's first Problem, Why or Background paragraph, marked **From the PRD**.
+- Neither: About says "No description yet" and shows **Ask Claude to draft it**.
+
+## Claude drafts it
+
+Once a day Claude drafts a description for an initiative that has none, and files it under the initiative's ✦ in **Check these**. The draft is the PRD's own paragraph, or the first paragraph of the record that says what the work is. Each draft cites the line it comes from. When there is nothing to read, Claude makes no draft. At most 3 drafts a day for each product.
+
+When a PRD is written later and says more than the description, Claude drafts **A fuller description from the PRD**.
+
+- ✓ saves the draft to the record. Undo puts back what was there.
+- ✕ drops it. Claude does not draft the same one again.
+
+## Ask Claude to draft it
+
+**Ask Claude to draft it** opens Home's chat with a prompt. Claude reads what it can, shows you a draft, and saves it after you say yes.
+
+## Commands
+
+- `pmos initiative describe <id>`: the description, and the lines Claude can draft it from.
+- `pmos initiative describe <id> "<text>"`: save the description. Claude runs this only after your yes.
+
+## Turn it off
+
+`pmos ai off descriptions` stops the daily drafts. `pmos ai on descriptions` starts them again. `PMOS_DESCRIPTIONS=off` also stops them.

package/workspace/guide/index.md

@@ -56,6 +56,7 @@ PMOS has three places: **Home**, **Board** and **Intelligence**. The round menu
 - [Claude proposes: the one ✦ on each initiative](claude-proposes.md): what Claude finds when you add an initiative, new dates, done and tidy names for late tasks, ✓, ✕, Undo, and `pmos propose`.
 - [The next prompt, suggested and sharpened](next-prompt.md): what the chat suggests after a reply, and the sharper version of a rough prompt.
 - [Ask about the past](ask-the-past.md): why something was decided or dropped, answered in the initiative chat from the records; "You decided this before" on a new initiative.
+- [Initiative descriptions](descriptions.md): what About says about an initiative, where it is kept, Claude's drafts, and `pmos initiative describe`.
 - [Expected outcomes](outcomes.md): what each initiative should change once it ships, the date to check it, and `pmos outcomes`.
 - [Rehearse a plan](rehearse.md): what a date change or a cut breaks or helps, before you approve it, and `pmos rehearse`.
 - [Your impact](your-impact.md): what counts as your impact, the weekly check in Home's chat, the switch, and `pmos impact`. Private to you.

package/workspace/guide/initiatives-roadmap.md

@@ -111,6 +111,7 @@ Every measurement needs a source: the file the value comes from and its commit,
 | `pmos initiative drop <proposal>` | Closes a proposal. |
 | `pmos initiative list` | Shows the Roadmap in rank order, with each lifecycle stage, check-by date and the open proposals. |
 | `pmos initiative export <id>` | Writes the breakdown as markdown to the terminal. |
+| `pmos initiative describe <id> ["<text>"]` | Shows the description and the lines Claude can draft it from. With text, saves the description. See [Initiative descriptions](descriptions.md). |
 
 Every command takes `--json` and `--root <dir>`. The command does not accept `--by` or `--via`. `pmos initiative now`, `next` and `later` are retired: they write nothing, say what to use instead and exit 2.
 

package/workspace/guide/next-prompt.md

@@ -2,7 +2,7 @@
 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
+timestamp: 2026-11-04
 ---
 
 # The next prompt, suggested and sharpened
@@ -30,7 +30,7 @@ Each card names only the initiatives, tasks and PRs that the reply or your messa
 
 ## 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. This takes a few seconds. 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.
+When you stop typing for about 2 seconds on a rough prompt of three or more words, one quiet line, **Sharpening…**, shows above the box while Claude sharpens it. This takes a few seconds, and you can keep typing. Then one lit **Sharper** card shows. If you typed on, or no answer comes in 30 seconds, nothing 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:
 
@@ -38,14 +38,14 @@ The sliders icon on the Sharper card sets how Claude sharpens:
 - **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.
+The same menu has the **Sharpen as I type** switch. Off means no Sharpening… line 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 by default. Off: no spinner and no Sharper card. |
+| Sharpen as I type | On by default. Off: no Sharpening… line and no Sharper card. |
 | Sharpen as | Polish, Prompt engineer or Your own. |
 | Your own rules | The rules for Your own, up to 1000 characters. |
 

package/workspace/lib/board-trail.js

@@ -163,7 +163,8 @@ function trail({ root, ids, rows = [], moves = [], now = Date.now(), io } = {})
   const evalNames = X.list ? X.list('planning/evals') : [];
   const rowBy = new Map(rows.map((r) => [r.id, r]));
   const fmCache = new Map();
-  const fmOf = (id) => { if (!fmCache.has(id)) { const t = X.text('planning/initiatives/' + id + '.md'); fmCache.set(id, t == null ? null : { fm: frontmatter(t), text: t }); } return fmCache.get(id); };
+  // a kit product keeps its records in pmos/state/initiatives and its PRDs under pmos/ (initiative-description-field: About read none there)
+  const fmOf = (id) => { if (!fmCache.has(id)) { const t = X.text('planning/initiatives/' + id + '.md') ?? X.text('pmos/state/initiatives/' + id + '.md'); fmCache.set(id, t == null ? null : { fm: frontmatter(t), text: t }); } return fmCache.get(id); };
 
   // "usually N days": every record's ladder, and every run of board moves
   const samples = Object.fromEntries(STAGES.map((s) => [s, []]));
@@ -204,8 +205,10 @@ function trail({ root, ids, rows = [], moves = [], now = Date.now(), io } = {})
     const stage = wk ? null : stageKey(row.stage);
     const lane = String(row.lane || fm.lane || 'feature').toLowerCase();
     const evals = evalFiles(id, evalNames);
-    const prdRel = pathOf(fm.prd_path), rubRel = pathOf(fm.rubric_path);
-    const prdText = prdRel ? X.text(prdRel) : null, prdFm = frontmatter(prdText);
+    let prdRel = pathOf(fm.prd_path); const rubRel = pathOf(fm.rubric_path);
+    let prdText = prdRel ? X.text(prdRel) : null;
+    if (prdRel && prdText == null && !prdRel.startsWith('pmos/')) { const k = X.text('pmos/' + prdRel); if (k != null) { prdText = k; prdRel = 'pmos/' + prdRel; } }
+    const prdFm = frontmatter(prdText);
     const briefName = (X.list ? X.list('planning/briefs') : []).find((n) => n.startsWith(id) && n.endsWith('.md'));
     const jv = X.jira ? X.jira(id) : null;
     const tks = jv && jv.ok && Array.isArray(jv.tickets) ? jv.tickets : [];
@@ -276,6 +279,8 @@ function trail({ root, ids, rows = [], moves = [], now = Date.now(), io } = {})
       skipped, parts, next: parts ? (parts.find((p) => !p.done) || {}).name || null : null, you,
       links: { prd: prdRel, prdVersion: prdRel && (typeof prdFm.version === 'string' || typeof prdFm.version === 'number') && String(prdFm.version).trim() ? String(prdFm.version).trim().slice(0, 12) : null,
         rubric: rubRel, evaluation: evals[0] || null, epic: jv && jv.ok && jv.epic && jv.epic.key ? jv.epic.key : null },
+      // the record's own description (initiative-description-field): About shows it before the PRD's paragraph
+      desc: typeof fm.description === 'string' && fm.description.trim() ? fm.description.replace(/\\("|\\)/g, '$1').replace(/\s+/g, ' ').trim().slice(0, 700) : null,
       drafted, gate: jv && jv.ok ? jv.gate || null : null, drift: drift.map((t) => t.key), deps, theme: tkey, tickets,
     };
   }

package/workspace/lib/description-props.js

@@ -0,0 +1,214 @@
+'use strict';
+/* description-props.js — every initiative has its own description, drafted by Claude and kept by the PM (initiative initiative-description-field).
+ *
+ *   drafts(S, { only? })   PURE-ISH (reads files) → { drafts, ask: [{ id, title }] }   S is lib/outcomes.js scan(root)
+ *       new     an initiative with no `description:` line: the PRD's paragraph (the first under Problem, Why, Background, Context, Summary or
+ *               Overview, else its first prose paragraph), else the record's own first paragraph with the record boilerplate left out
+ *               ("Feature lane.", "Repo-native initiative record", the gate notes). Nothing readable: no draft, the id is listed in `ask`.
+ *       enrich  a description exists and the PRD's paragraph is fuller and not in it yet: the PRD's paragraph replaces it once the PM keeps it.
+ *   Each draft is the ai-guard shape { id, title, say, confidence, claims: [{ text, sources: [{ label, ref, quote }] }], data: { kind,
+ *   initiative, text, from? } }, ref path:line from the repository root and quote that line's text. No model: the sources' own words.
+ *   paragraphOf(lines, { prd }) → { text, n } | null      the paragraph and the 1-based line it starts on
+ *   create(deps) → { tick({ now }), runProduct(w, { now }) }   once a day per product, at most PER_DAY drafts under the initiative's ✦
+ *       (lib/proposals.js group `description`, section Check these), through lib/ai-guard.js file() (job `descriptions`, replay per product).
+ *       A dropped draft is not filed again; an open `new` draft goes once the record has a description. It never writes a record: only ✓.
+ *   deps: as lib/outcome-props.js { workspaces(), isLead(w), stateDirFor(w), boardOf(w, id), runtime(), open(now), env, every, mayRun(), warn() }
+ *   Off: PMOS_DESCRIPTIONS=off, or `pmos ai off descriptions`. */
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const O = require('./outcomes.js');
+const PR = require('./proposals.js');
+
+const JOB = 'descriptions';
+const VERSION = 'descriptions-1';
+const PER_DAY = 3;
+const MAX = 700;
+const MIN = 60;
+const HEAD = /^#{1,3}\s*(problem|why|background|context|summary|overview)\b/i;
+const SKIP = /^\s*([-*+]|\d+[.)])\s|^\s*>|^\s*\||^\s*```|^\s*<!--|^\*\*[^*]+:\*\*/;
+// record boilerplate: a sentence that speaks about the record, the lane or the gates, not about the work
+const META = /\blane\b|\(D\d+[^)]*\)|done-criteria|Initiative Gate|frontmatter|front matter|Repo-native|^Anchored to\b|^Batch \d+ item \d+\.?$|\bno PRD\b|\bno rubric\b/i;
+
+const flagOff = (v) => /^(off|0|false|no)$/i.test(String(v == null ? '' : v).trim());
+const off = (env) => flagOff((env || process.env).PMOS_DESCRIPTIONS);
+const rel = (root, f) => path.relative(root, f).split(path.sep).join('/');
+const linesOf = (f) => { try { return fs.readFileSync(f, 'utf8').replace(/\r\n?/g, '\n').split('\n'); } catch { return null; } };
+const plain = (s) => String(s).replace(/!\[[^\]]*\]\([^)]*\)/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/[*`]+/g, '').replace(/(^|\W)_+(?=\w)|(?<=\w)_+(?=\W|$)/g, '$1').replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim();
+const cut = (t) => (t.length > MAX ? t.slice(0, MAX - 1).replace(/\s+\S*$/, '') + '…' : t);
+const norm = (s) => String(s || '').toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+const clip = (s, n) => { const t = String(s || ''); return t.length > n ? t.slice(0, n - 1).replace(/\s+\S*$/, '') + '…' : t; };
+const localDay = (ms) => { const d = new Date(ms); return d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0') + '-' + String(d.getDate()).padStart(2, '0'); };
+
+/** The body's paragraphs after the front matter: [{ n (1-based), lines: [text] }] */
+function paragraphs(L) {
+  let i = 0;
+  if (/^---\s*$/.test(L[0] || '')) { i = 1; while (i < L.length && !/^---\s*$/.test(L[i])) i++; i++; }
+  const out = [];
+  let cur = null;
+  for (; i < L.length; i++) {
+    const l = L[i];
+    if (!l.trim() || /^#{1,6}\s/.test(l)) { if (cur) out.push(cur); cur = null; if (/^#{1,6}\s/.test(l)) out.push({ n: i + 1, head: l }); continue; }
+    if (!cur) { if (SKIP.test(l)) continue; cur = { n: i + 1, lines: [] }; }
+    else if (SKIP.test(l)) { out.push(cur); cur = null; continue; }
+    cur.lines.push(l.trim());
+  }
+  if (cur) out.push(cur);
+  return out;
+}
+/** The paragraph a PRD (prd: true) or a record gives, boilerplate left out of a record's. → { text, n } | null */
+function paragraphOf(L, { prd = false } = {}) {
+  if (!L) return null;
+  const P = paragraphs(L);
+  if (prd) {
+    const h = P.findIndex((p) => p.head && HEAD.test(p.head));
+    const after = h >= 0 ? P.slice(h + 1).find((p) => p.head || p.lines) : null;
+    if (after && after.lines) { const t = plain(after.lines.join(' ')); if (t.length >= MIN) return { text: cut(t), n: after.n }; }
+    const first = P.find((p) => p.lines && plain(p.lines.join(' ')).length >= MIN);
+    return first ? { text: cut(plain(first.lines.join(' '))), n: first.n } : null;
+  }
+  // a record: the first paragraph before any section heading that is about the work. A paragraph with any sentence about the record, its
+  // lane or the gates is boilerplate and is skipped whole (precision first: a weak draft costs the PM a ✕).
+  for (const p of P) {
+    if (p.head) { if (/^#{2,6}\s/.test(p.head)) break; continue; }
+    const t = plain(p.lines.join(' '));
+    if (t.split(/(?<=[.!?:])\s+/).some((x) => META.test(x))) continue;
+    if (!/^[A-Z“"]/.test(t) || /^[\w ]{1,24}:\s/.test(t)) continue;   // a cut-off continuation or a labelled note ("Rollback: …") is not a description
+    if (t.length >= MIN && !/:$/.test(t)) return { text: cut(t), n: p.n };
+  }
+  return null;
+}
+
+function prdFile(root, it) {
+  const cands = [];
+  if (it.prd) cands.push(path.join(root, it.prd), path.join(root, 'pmos', it.prd));
+  cands.push(path.join(root, 'planning', 'prd', it.id + '-prd.md'), path.join(root, 'pmos', 'planning', 'prd', it.id + '-prd.md'));
+  for (const f of cands) {
+    const abs = path.resolve(f);
+    if (abs !== root && !abs.startsWith(root + path.sep)) continue;
+    try { if (fs.statSync(abs).isFile()) return abs; } catch { /* next */ }
+  }
+  return null;
+}
+const srcOf = (root, file, L, n, label) => ({ label, ref: rel(root, file) + ':' + n, quote: String(L[n - 1] || '').trim().slice(0, 400) });
+
+/** What a PRD says (the source and text), or null. */
+function fromPrd(S, it) {
+  const f = prdFile(S.root, it); if (!f) return null;
+  const L = linesOf(f), p = paragraphOf(L, { prd: true });
+  return p ? { text: p.text, source: srcOf(S.root, f, L, p.n, 'PRD') } : null;
+}
+function fromRecord(S, it) {
+  const f = path.join(S.root, it.record), L = linesOf(f), p = paragraphOf(L);
+  return p ? { text: p.text, source: srcOf(S.root, f, L, p.n, 'Its record') } : null;
+}
+/** The PRD says more: not already in the description, and fuller. */
+const saysMore = (desc, prd) => { const d = norm(desc), q = norm(prd); return !!q && !d.includes(q.slice(0, 60)) && !q.includes(d) ? q.length > d.length + 40 : false; };
+
+/** The ✦ drafts of one repository. */
+function drafts(S, { only = null } = {}) {
+  const out = [], ask = [];
+  for (const it of S.subjects) {
+    if (only && it.id !== only) continue;
+    const desc = it.fm.description ? String(it.fm.description.value || '').trim() : '';
+    const prd = fromPrd(S, it);
+    if (!desc) {
+      const d = prd || fromRecord(S, it);
+      if (!d) { ask.push({ id: it.id, title: it.title }); continue; }
+      out.push({ id: `description-new:${it.id}`, title: `Description for ${clip(it.title, 80)}`, confidence: 'medium',
+        claims: [{ text: clip(`${d.source.label === 'PRD' ? 'Its PRD' : 'Its record'} says: ${d.text}`, 240), sources: [d.source] }],
+        say: `It has no description yet. I suggest: "${d.text}"`, data: { kind: 'new', initiative: it.id, text: d.text } });
+    } else if (prd && saysMore(desc, prd.text)) {
+      out.push({ id: `description-enrich:${it.id}`, title: `A fuller description for ${clip(it.title, 80)}`, confidence: 'medium',
+        claims: [{ text: clip('Its PRD says: ' + prd.text, 240), sources: [prd.source] }],
+        say: `Its PRD says more than its description now. I suggest: "${prd.text}"`, data: { kind: 'enrich', initiative: it.id, text: prd.text, from: desc } });
+    }
+  }
+  return { drafts: out, ask };
+}
+
+/** The proposals line a draft becomes. */
+function lineOf(d, board, run) {
+  const type = d.data.kind === 'enrich' ? 'enrich' : 'new', ini = d.data.initiative;
+  const c = PR.clean('description', type, { title: type === 'enrich' ? 'A fuller description from the PRD' : 'What this initiative is', why: d.say,
+    sources: d.claims.flatMap((x) => x.sources).map((s) => ({ label: s.label, ref: s.ref })), items: [{ id: 'description', title: d.data.text }],
+    data: { text: d.data.text, ...(d.data.from ? { from: d.data.from } : {}) } });
+  if (c.error) return null;
+  return { kind: 'propose', ini, board, run, id: PR.idOf(ini, 'description', type, ''), ...c.prop };
+}
+
+/** One product's replay cases: its own drafts must all pass, and an initiative with nothing readable gets no draft. */
+function cases(S, list) {
+  return [{ name: 'the drafts of ' + String(S.root).split(/[\\/]/).pop(), run: async () => list.slice(0, PER_DAY), expect: { filed: Math.min(PER_DAY, list.length) } },
+    { name: 'nothing readable, no draft', run: async () => drafts({ ...S, subjects: [{ id: 'zz-no-source', title: 'No source', fm: {}, prd: '', record: 'zz-none/zz-no-source.md' }] }).drafts, expect: { none: true } }];
+}
+
+function create(deps) {
+  const warn = deps.warn || (() => {});
+  const lastDay = new Map();
+  let busy = false;
+  const guardLib = () => { try { return require('./ai-guard.js'); } catch { return null; } };
+
+  async function runProduct(w, { now = Date.now() } = {}) {
+    const dir = deps.stateDirFor(w); if (!dir) return { ws: w.id, filed: 0, why: 'no state folder' };
+    const rt = deps.runtime && deps.runtime();
+    const S = O.scan(w.root, { today: localDay(now) });
+    const F = PR.read(dir), kept = PR.keptIds(F);
+    // a record that has its description now: its open draft goes (zero is silence)
+    const has = new Map(S.subjects.map((it) => [it.id, it]));
+    for (const p of F.props.values()) {
+      if (p.group !== 'description' || kept.has(p.id)) continue;
+      const it = has.get(p.ini), sig = PR.sigOf(p);
+      if (F.drops.has(sig)) continue;
+      const desc = it && it.fm.description ? String(it.fm.description.value || '') : '';
+      if (!it || (p.type === 'new' && desc) || (p.type === 'enrich' && p.data && norm(desc) === norm(p.data.text))) PR.append(dir, { by: 'pmos:descriptions' }, { kind: 'drop', ini: p.ini, sig });
+    }
+    const fresh = [];
+    for (const d of drafts(S).drafts) {
+      const board = deps.boardOf(w, d.data.initiative); if (!board) continue;
+      const l = lineOf(d, board, ''); if (!l) continue;
+      const prev = F.props.get(l.id);
+      if (kept.has(l.id)) continue;
+      if (prev && (F.drops.has(PR.sigOf(prev)) || (prev.data && prev.data.text === l.data.text))) continue;   // dropped for good, or filed already
+      fresh.push({ d, board });
+      if (fresh.length >= PER_DAY) break;
+    }
+    if (!fresh.length) return { ws: w.id, filed: 0 };
+    const AG = guardLib(); if (!AG) return { ws: w.id, filed: 0, why: 'the shared guard is not installed' };
+    const version = VERSION + ':' + w.id, run = 'ds' + now.toString(36) + crypto.randomBytes(3).toString('hex');
+    if (!AG.off(JOB, { env: deps.env || process.env, settingsDir: rt }) && !AG.ready(rt, JOB, version)) {
+      const rep = await AG.replay(JOB, version, cases(S, fresh.map((x) => x.d)), { root: w.root, stateDir: rt, max: PER_DAY });
+      if (!rep.ok) { warn('descriptions replay ' + w.id, new Error(rep.failed.map((f) => f.name + ': ' + f.why).join('; '))); return { ws: w.id, filed: 0, replay: rep }; }
+    }
+    const byId = new Map(fresh.map((x) => [x.d.id, x]));
+    const r = await AG.file({ job: JOB, version, run, root: w.root, stateDir: rt, settingsDir: rt, env: deps.env || process.env, max: PER_DAY }, fresh.map((x) => x.d),
+      async (acc) => { for (const p of acc) { const x = byId.get(p.id); const l = x && lineOf(x.d, x.board, run); if (l) PR.append(dir, { by: 'agent:descriptions' }, l); } });
+    return { ws: w.id, filed: (r.filed || []).length, held: !!r.held, off: r.off || null };
+  }
+
+  async function tick({ now = Date.now() } = {}) {
+    if (off(deps.env) || busy) return { off: off(deps.env), running: busy };
+    let open = true;
+    try { open = deps.open ? !!deps.open(now) : true; } catch { open = true; }
+    if (!open) return { closed: true };
+    busy = true;
+    const out = [];
+    try {
+      const day = localDay(now);
+      for (const w of deps.workspaces()) {
+        if (lastDay.get(w.id) === day) continue;
+        try { if (deps.isLead && !deps.isLead(w)) continue; } catch { continue; }
+        lastDay.set(w.id, day);
+        try { out.push(await runProduct(w, { now })); } catch (e) { warn('descriptions ' + w.id, e); }
+      }
+    } finally { busy = false; }
+    return { ran: out };
+  }
+  if (deps.every > 0) {
+    const t = setInterval(() => { try { if (deps.mayRun && !deps.mayRun()) return; } catch { /* no lock: run */ } tick({}).catch((e) => warn('descriptions tick', e)); }, deps.every);
+    if (t.unref) t.unref();
+  }
+  return { tick, runProduct };
+}
+
+module.exports = { JOB, VERSION, PER_DAY, drafts, paragraphOf, lineOf, cases, create, off, fromPrd, fromRecord };

package/workspace/lib/initiative-cli.js

@@ -11,6 +11,8 @@
  *   pmos initiative drop <proposal-eid>
  *   pmos initiative list
  *   pmos initiative export <id>                  the breakdown as markdown on stdout; nothing is written
+ *   pmos initiative describe <id> ["<text>"]     no text: its description and the cited lines Claude can draft it from; with text: write
+ *                                                its `description:` line (initiative-description-field). An agent writes only after the PM's yes
  *   every command: [--json] [--root <dir>]
  *
  * The SAME writers the workspace page uses (lib/initiative-writer.js, lib/placements.js) — no server is needed. Who
@@ -59,11 +61,11 @@ function docNote(docs) {
   return `Not on the Roadmap · ${docs.length} on a document lane: ${names}. A document lane does not show on Home or the Board. If it is work, set lane: in its record to ${WORK_LANES}.`;
 }
 
-const COMMANDS = { initiative: ['new', 'top', 'up', 'down', 'bottom', 'after', 'check-by', 'adopt', 'drop', 'list', 'export'] };
+const COMMANDS = { initiative: ['new', 'top', 'up', 'down', 'bottom', 'after', 'check-by', 'adopt', 'drop', 'list', 'export', 'describe'] };
 /** The horizon verbs D105 retired: they answer with what to use instead. */
 const RETIRED = Object.freeze(['now', 'next', 'later']);
 const USAGE = [
-  'usage: pmos initiative new|top|up|down|bottom|after|check-by|adopt|drop|list|export — initiatives on the Roadmap',
+  'usage: pmos initiative new|top|up|down|bottom|after|check-by|adopt|drop|list|export|describe — initiatives on the Roadmap',
   '  pmos initiative new "<title>" --lane <lane> --anchor <KR|health:id> [--intent "<text>"] [--id <id>]',
   '  pmos initiative new --from capture-YYYY-MM-DD-<n> [--anchor <anchor>] [--lane <lane>] [--title "<title>"]',
   '  pmos initiative top|up|down|bottom <id>  reorder it on the Roadmap',
@@ -73,6 +75,7 @@ const USAGE = [
   '  pmos initiative drop <proposal>          close an open proposal',
   '  pmos initiative list                     the Roadmap, ranked, with each lifecycle stage',
   '  pmos initiative export <id>              the breakdown as markdown on stdout',
+  '  pmos initiative describe <id> ["<text>"]  read its description and what to draft it from; with text, save it (after the PM\'s yes)',
   '  every command: [--json] [--root <dir>]',
   'An agent session\'s move applies at once and names the agent. A new initiative lands at the end of the Roadmap.',
   'Now, Next and Later are retired (D105): the rank says what comes first, the lifecycle stage says where it is.',
@@ -205,6 +208,29 @@ async function run(argv, { say = (s) => console.log(s), cwd = process.cwd(), isT
     return done({ written: r.written }, `✓ proposal ${eid} ${verb === 'adopt' ? 'kept' : 'dropped'}`);
   }
 
+  if (verb === 'describe') {
+    // initiative-description-field: the record's own description. Read with no text; write with text, only after the PM said yes.
+    const did = pos[0];
+    if (!did || pos.length > 2) { say('usage: pmos initiative describe <id> ["<text>"]'); return 2; }
+    if (pos.length === 2) {
+      const r = writer.setDescription(root, did, pos[1], { actor: actorLib.fromCli(who) });
+      if (!r.ok) return fail(r.error, r.status === 400 ? 2 : 1);
+      return done({ id: did, description: r.text, from: r.from, same: !!r.same }, r.same ? `${did} says that already.` : `✓ ${did}: description saved. About shows it now. Commit the record to keep it.`);
+    }
+    const O = require('./outcomes.js'), DP = require('./description-props.js');
+    const S = O.scan(root);
+    const it = S.subjects.find((x) => x.id === did);
+    if (!it) return fail(`no initiative ${did} here (or it is stopped, or on a document lane)`);
+    const cur = it.fm.description ? String(it.fm.description.value || '') : '';
+    const srcs = [DP.fromPrd(S, it), DP.fromRecord(S, it)].filter(Boolean);
+    if (json) { say(JSON.stringify({ ok: true, id: did, description: cur || null, sources: srcs.map((x) => ({ label: x.source.label, ref: x.source.ref, text: x.text })) })); return 0; }
+    say(cur ? `${did}: ${cur}` : `${did} has no description yet.`);
+    if (srcs.length) say('Draft it from:\n' + srcs.map((x) => `  · ${x.source.label} [${x.source.ref}]: ${x.text}`).join('\n'));
+    else say('Nothing readable to draft it from (no PRD paragraph, no paragraph in its record): ask the PM what it is.');
+    say(`Show the draft to the PM; after a yes: pmos initiative describe ${did} "<text>"`);
+    return 0;
+  }
+
   const id = pos[0];
   if (!id) { say(`usage: pmos initiative ${verb} <id>${verb === 'check-by' ? ' <YYYY-MM-DD|none>' : ''}`); return 2; }
 

package/workspace/lib/initiative-writer.js

@@ -298,6 +298,46 @@ function restoreOutcome(root, id, from = {}, to = {}, { actor } = {}) {
   return { ok: true, id };
 }
 
+/** The record's own description (initiative-description-field): one `description:` line in the front matter, one paragraph of at most
+ *  DESC_MAX characters. About shows it before the PRD's paragraph (pm/ini-about.js). The PM's ✓ on a ✦ draft (lib/routes-proposals.js) and
+ *  `pmos initiative describe <id> "<text>"` after the PM's yes reach here. → { ok: true, id, from, text, same? } | refusal */
+const DESC_MAX = 700;
+const frontOfText = (text) => /^---\r?\n([\s\S]*?)\r?\n---(\r?\n|$)/.exec(text);
+const descLine = (lines) => { const at = lines.findIndex((l) => l.startsWith('description:')); return { at, val: at >= 0 ? unquote(lines[at].slice(12)) : '' }; };
+function setDescription(root, id, text0, { actor } = {}) {
+  if (!actorLib.valid(actor)) return refuse(500, 'initiative-writer: the caller must pass the actor from pm-guard.js or actor.js');
+  const t = typeof text0 === 'string' ? text0.replace(/\s+/g, ' ').trim() : '';
+  if (t.length < 12 || t.length > DESC_MAX) return refuse(400, `say what the initiative is in one paragraph of 12 to ${DESC_MAX} characters`, 'description');
+  const f = recordFile(root, id);
+  if (!f.ok) return f;
+  const text = fs.readFileSync(f.file, 'utf8');
+  const fm = frontOfText(text);
+  if (!fm) return refuse(409, `the record of ${id} has no front matter — nothing was saved`, 'id');
+  const lines = fm[1].split(/\r?\n/);
+  const { at, val: from } = descLine(lines);
+  if (from === t) return { ok: true, id, from, text: t, same: true };
+  const line = 'description: ' + q(t);
+  if (at >= 0) lines[at] = line; else lines.push(line);
+  try { fs.writeFileSync(f.file, '---\n' + lines.join('\n') + '\n---' + fm[2] + text.slice(fm[0].length), { flag: 'w' }); } catch { return refuse(500, 'the record could not be written — nothing was saved'); }
+  return { ok: true, id, from, text: t };
+}
+/** The Undo of a ✓ on a description ✦: the line back to `from` (removed when there was none), only while it still says `to`.
+ *  A record the PM edited since keeps its edit (→ { ok: true, kept: true }). */
+function restoreDescription(root, id, from, to, { actor } = {}) {
+  if (!actorLib.valid(actor)) return refuse(500, 'initiative-writer: the caller must pass the actor from pm-guard.js or actor.js');
+  const f = recordFile(root, id);
+  if (!f.ok) return f;
+  const text = fs.readFileSync(f.file, 'utf8');
+  const fm = frontOfText(text);
+  if (!fm) return refuse(409, `the record of ${id} has no front matter — nothing was saved`, 'id');
+  const lines = fm[1].split(/\r?\n/);
+  const { at, val } = descLine(lines);
+  if (val !== String(to || '')) return { ok: true, id, kept: true };
+  if (from) { const line = 'description: ' + q(from); if (at >= 0) lines[at] = line; else lines.push(line); } else if (at >= 0) lines.splice(at, 1);
+  try { fs.writeFileSync(f.file, '---\n' + lines.join('\n') + '\n---' + fm[2] + text.slice(fm[0].length), { flag: 'w' }); } catch { return refuse(500, 'the record could not be written — nothing was saved'); }
+  return { ok: true, id };
+}
+
 function withdrawSplit(root, id, want, { actor } = {}) {
   if (!actorLib.valid(actor)) return refuse(500, 'initiative-writer: the caller must pass the actor from pm-guard.js or actor.js');
   const f = recordFile(root, id);
@@ -309,4 +349,4 @@ function withdrawSplit(root, id, want, { actor } = {}) {
   return { ok: true, removed: true };
 }
 
-module.exports = { setOutcome, restoreOutcome, createInitiative, renameInitiative, setAnchor, restoreAnchor, withdrawSplit, recordSha, slugOf, ID_RE, INPUT_KEYS };
+module.exports = { setDescription, restoreDescription, DESC_MAX, setOutcome, restoreOutcome, createInitiative, renameInitiative, setAnchor, restoreAnchor, withdrawSplit, recordSha, slugOf, ID_RE, INPUT_KEYS };

package/workspace/lib/proposals.js

@@ -18,6 +18,9 @@
  *   outcome the expected outcome and its check date (D57; lib/outcomes.js, filed by lib/outcome-props.js): type new (no outcome yet) or date
  *           (an outcome with no date). data { metric, horizon }; one item { id: 'outcome', title: the metric, due: the date }. Always section
  *           'check': its own ✓, never Keep all. ✓ writes the record's outcome_metric and outcome_horizon lines (lib/initiative-writer.js)
+ *   description the record's own description (initiative-description-field; filed by lib/description-props.js): type new (none yet) or
+ *           enrich (the PRD says more). data { text, from? }; one item { id: 'description', title: the text cut }. Always section 'check'.
+ *           ✓ writes the record's description line (lib/initiative-writer.js setDescription)
  *   grill   what Claude found when it grilled the initiative by itself (lib/grill.js): type = the angle, no items, a next step in data.next;
  *           always section 'check' (its own ✓, never Keep all). 3 show, best rank first; the group's `more` counts the rest
  *
@@ -56,8 +59,8 @@ const crypto = require('crypto');
 
 const LEDGER = 'proposals.jsonl';
 const KINDS = new Set(['epoch', 'look', 'src', 'end', 'propose', 'drop', 'keep', 'undo']);
-const GROUPS = ['found', 'dates', 'status', 'names', 'outcome'];
-const TYPES = { found: ['stage', 'docs', 'tasks', 'link', 'maybe', 'unplaced'], dates: ['stage', 'task'], status: ['done'], names: ['tidy'], outcome: ['new', 'date'] };
+const GROUPS = ['found', 'dates', 'status', 'names', 'outcome', 'description'];
+const TYPES = { found: ['stage', 'docs', 'tasks', 'link', 'maybe', 'unplaced'], dates: ['stage', 'task'], status: ['done'], names: ['tidy'], outcome: ['new', 'date'], description: ['new', 'enrich'] };
 const SOURCES = ['drive', 'docs', 'sheets', 'slides', 'jira', 'calendar', 'notes', 'mail', 'slack', 'confluence', 'chat', 'repo'];
 const SOURCE_NAMES = { drive: 'Drive and Slides', docs: 'Docs', sheets: 'Sheets', slides: 'Slides', jira: 'Jira', calendar: 'Calendar and meeting notes', notes: 'Meeting notes',
   mail: 'Gmail', slack: 'Slack', confluence: 'Confluence', chat: 'Chat', repo: 'This repository' };
@@ -155,7 +158,13 @@ function clean(group, type, input) {
     if (!DAY_RE.test(horizon)) return { error: 'data.horizon is the check date, YYYY-MM-DD' };
     data.metric = metric; data.horizon = horizon;
   }
-  return { prop: { group, type, section: group === 'outcome' ? 'check' : section, title: one(input.title, LIM.title) || null, why, sources: s.v, items, data } };
+  if (group === 'description') {
+    const d = isObj(input.data) ? input.data : {};
+    const text = one(d.text, 700);
+    if (text.length < 12) return { error: 'data.text is the description, one paragraph of 12 to 700 characters' };
+    data.text = text; if (str(d.from)) data.from = one(d.from, 700);
+  }
+  return { prop: { group, type, section: group === 'outcome' || group === 'description' ? 'check' : section, title: one(input.title, LIM.title) || null, why, sources: s.v, items, data } };
 }
 /** The proposal's own id: one per initiative, group, type and key, so a newer run files over the older one. */
 const idOf = (ini, group, type, key) => 'pr-' + hash([ini, group, type, key || ''].join('|'));
@@ -323,7 +332,7 @@ function datesOf(ini, T, o = {}) {
 }
 
 /* ── what r.props carries ── */
-const ORDER = { outcome: -1, found: 0, dates: 1, status: 2, names: 3, links: 4, grill: 5 };
+const ORDER = { description: -2, outcome: -1, found: 0, dates: 1, status: 2, names: 3, links: 4, grill: 5 };
 const GRILL_SHOWN = 3;
 /**
  * One initiative's proposals, as the ✦ and the Viewer draw them, or null when there is nothing to show.

package/workspace/lib/routes-next-prompt.js

@@ -31,6 +31,11 @@ const ROOT = path.join(__dirname, '..');   // the workspace package: the files t
 const FIXTURE = path.join(ROOT, 'fixtures/next-prompt-replay.json');
 const KEEP = 30;
 const TIMEOUT_MS = 90000;
+const SHARPEN_TIMEOUT_MS = 30000;   // a sharper prompt that comes later than this is for words the PM has typed past: drop it
+/* A background run for these two short jobs starts lean (hotfix 2026-11-04, Wawan: "Loading too long"): a fixed fast model at low effort,
+ * no MCP servers, no skills, only the PM's user settings (no project hooks such as a session-start script) and one read tool. Measured on
+ * one sharpen prompt: about 61,000 input tokens and 7 s before, about 10,000 and 5 s after; the rest is the CLI's own start. */
+const LEAN_FLAGS = Object.freeze([{ flag: '--strict-mcp-config' }, { flag: '--disable-slash-commands' }, { flag: '--setting-sources', value: 'user' }, { flag: '--tools', value: 'Read' }]);
 const DEFAULT_MODEL = 'claude-sonnet-5-5';
 
 const text = (v, n) => (typeof v === 'string' ? v.slice(0, n) : '');
@@ -112,16 +117,18 @@ async function viaApi(key, prompt, env, create = null) {
   return null;
 }
 /** A background read-only Claude run → its answer text, or null after `fail(why)` says why it gave none. */
-function viaHeadless(ctx, prompt, origin, fail = () => {}) {
+function viaHeadless(ctx, prompt, origin, fail = () => {}, { timeoutMs = TIMEOUT_MS } = {}) {
   const headless = require('./headless.js');
   if (typeof ctx.spawnSession !== 'function') { fail('no background run here'); return Promise.resolve(null); }
   if (headless.kindFor({ agent: 'claude', origin }) !== 'ask') { fail('the run would not be read-only'); return Promise.resolve(null); }
   return new Promise((resolve) => {
     let settled = false; const done = (v, why) => { if (settled) return; settled = true; clearTimeout(t); if (v == null) fail(why); resolve(v); };
-    const t = setTimeout(() => done(null, 'the run took longer than ' + Math.round(TIMEOUT_MS / 1000) + ' s'), TIMEOUT_MS);
+    const t = setTimeout(() => done(null, 'the run took longer than ' + Math.round(timeoutMs / 1000) + ' s'), timeoutMs);
     let s = null;
     try {
+      const model = String(envOf(ctx).PMOS_NEXT_PROMPT_MODEL || '').trim() || DEFAULT_MODEL;
       s = ctx.spawnSession({ name: 'chat: next prompt', agent: 'claude', origin, initialInput: prompt,
+        modelAsk: { explicit: { model, effort: 'low' } }, launchFlags: LEAN_FLAGS.map((f) => ({ ...f })),
         onDone: (d) => { const r = d && d.result; done(r && r.ok && !r.isError ? String(r.text || '') : null, 'the run ended without an answer' + (d && d.note ? ': ' + String(d.note).slice(0, 80) : '')); } });
     } catch (e) { s = null; }
     if (!s || s.state === 'exited') done(null, 'the run did not start' + (s && s.note ? ': ' + String(s.note).slice(0, 80) : ''));
@@ -145,7 +152,8 @@ async function ask(ctx, prompt, { job, key, run }) {
     catch (e) { failed(apiWhy(e), e && (e.status === 401 || e.status === 403)); }
   }
   return viaHeadless(ctx, prompt, `briefing-ask:next-prompt:${job}:${crypto.createHash('sha1').update(String(key)).digest('hex').slice(0, 10)}`,
-    (why) => AG.audit(ctx.runtimeDir, { job, version: VERSION, run, event: 'run-error', error: String(why).slice(0, 160) }));
+    (why) => AG.audit(ctx.runtimeDir, { job, version: VERSION, run, event: 'run-error', error: String(why).slice(0, 160) }),
+    { timeoutMs: job === NP.JOB_SHARPEN ? SHARPEN_TIMEOUT_MS : TIMEOUT_MS });
 }
 
 /* ── what a card cites ───────────────────────────────────────────────────────────────────── */
@@ -285,4 +293,4 @@ async function handle(req, res, url, ctx) {
   catch (e) { return send(bad(500, 'The suggestion failed: ' + String((e && e.message) || e).slice(0, 200))); }
 }
 
-module.exports = { prefixes: ['/api/next-prompt'], handle, VERSION, FIXTURE, MODELS, prefs, setPref, lineRef, replayCases, next, sharpen };
+module.exports = { prefixes: ['/api/next-prompt'], handle, VERSION, FIXTURE, MODELS, LEAN_FLAGS, prefs, setPref, lineRef, replayCases, next, sharpen };

package/workspace/lib/routes-proposals.js

@@ -138,6 +138,10 @@ function applyOne(ctx, p, g, f, ini, x, choices, outbox) {
     const d = x.data || {};
     const r = require('./initiative-writer.js').setOutcome(p.w.root, ini, { metric: d.metric, horizon: d.horizon }, { actor: g.actor });
     if (r.ok && !r.same) add({ op: 'outcome', from: r.from, to: { metric: r.metric, horizon: r.horizon } });
+  } else if (x.group === 'description') {
+    // the record's own description (initiative-description-field): ✓ writes its description line, Undo puts back what was there
+    const r = require('./initiative-writer.js').setDescription(p.w.root, ini, (x.data || {}).text, { actor: g.actor });
+    if (r.ok && !r.same) add({ op: 'description', from: r.from, to: r.text });
   } else if (x.group === 'grill') {
     // a grill finding (lib/grill.js): ✓ adds its next step as a task, with the finding and its sources in the notes
     // ✎ on the finding: the PM's own words for the next step (choices[id]) replace Claude's
@@ -301,6 +305,7 @@ const WRITES = {
       else if (w.op === 'prd') { try { const file = path.resolve(p.w.root, w.file), text = fs.readFileSync(file, 'utf8'); if (text.includes(w.to)) { fs.writeFileSync(file, text.split(w.to).join(w.from)); back++; } else kept++; } catch { kept++; } continue; }
       else if (w.op === 'doc' || w.op === 'linked' || w.op === 'ran') { back++; continue; }   // the fold leaves an undone batch out
       else if (w.op === 'outbox') { kept++; continue; }   // a drafted comment waits in the outbox, where the PM drops it
+      else if (w.op === 'description') { const r2 = require('./initiative-writer.js').restoreDescription(p.w.root, k.ini, w.from || '', w.to || '', { actor: g.actor }); if (r2.ok && !r2.kept) back++; else kept++; continue; }   // a record edited since keeps its edit
       else if (w.op === 'outcome') { const r2 = require('./initiative-writer.js').restoreOutcome(p.w.root, k.ini, w.from || {}, w.to || {}, { actor: g.actor }); if (r2.ok && !r2.kept) back++; else kept++; continue; }   // a record edited since keeps its edit
       if (r && r.body && r.body.ok) back++; else kept++;
     }

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.519.0",
+  "version": "0.521.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.519.0",
+      "version": "0.521.0",
       "license": "MIT",
       "dependencies": {
         "@anthropic-ai/sdk": "^1.3.0",

package/workspace/package.json

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

package/workspace/public/pm/cozy-home.css

@@ -176,7 +176,7 @@ body.cz-home { min-height: 100vh; overflow: hidden; }
 @media (min-width: 761px) {
   /* the log scrolls at the panel's edge, not at the column's (PM, 2026-10-27 "Bad layout": the scrollbar stood in the middle of the page);
    * its content and the header line keep to the same centred column as the box */
-  body.cz-home:not(.hm-vw-open) .hm-foot { box-sizing: border-box; width: 100%; max-width: 880px; align-self: center; }
+  body.cz-home:not(.hm-vw-open) .hm-foot, body.cz-home:not(.hm-vw-open) .np { box-sizing: border-box; width: 100%; max-width: 880px; align-self: center; }
   body.cz-home:not(.hm-vw-open) .hm-log { box-sizing: border-box; width: 100%; padding-inline: max(0px, calc((100% - 880px) / 2)); }
   body.cz-home:not(.hm-vw-open) .hm-chd { padding-left: max(0px, calc((100% - 880px) / 2)); }
   @container (max-width: 968px) { .hm-reopen:not([hidden]) ~ .hm-log { padding-top: 46px; } }
@@ -810,13 +810,10 @@ form.hm-box textarea { min-height: 48px; border: 0; background: none; resize: no
 .np-use { display: flex; align-items: flex-start; gap: 10px; flex: 1; min-width: 0; padding: 11px 0 11px 14px; border: 0; background: none; color: inherit; font: inherit; text-align: left; cursor: pointer; }
 .np-ib { flex: none; width: 36px; height: 36px; display: inline-grid; place-items: center; border: 0; border-radius: 999px; background: none; color: var(--cz-ink2); cursor: pointer; }
 .np-ib:hover, .np-ib[aria-expanded="true"] { background: var(--cz-well); }
-.np-spin { display: flex; align-items: center; gap: 12px; padding: 14px 16px; border-radius: 16px; background: var(--cz-bluebg); color: var(--cz-blue); }
+.np-spin { display: flex; align-items: center; gap: 8px; padding: 2px 14px; font-size: var(--fs-meta); color: var(--cz-ink2); }   /* quiet: one small line, not a card */
 .np-sp { display: inline-flex; animation: np-rot 1.1s linear infinite; }
 @keyframes np-rot { to { transform: rotate(360deg); } }
 @media (prefers-reduced-motion: reduce) { .np-sp { animation: none; } }
-.np-sk { flex: 1; display: flex; flex-direction: column; gap: 8px; }
-.np-sk i { display: block; height: 12px; border-radius: 6px; background: var(--cz-bluebg); }
-.np-sk i:first-child { width: 88%; } .np-sk i:last-child { width: 60%; }
 .np-menu { position: absolute; right: 0; bottom: calc(100% + 8px); z-index: 20; width: 310px; max-width: calc(100vw - 32px); box-sizing: border-box; padding: 8px; border-radius: 20px;
   background: var(--cz-card); box-shadow: 0 24px 60px -24px rgba(42,46,53,.45), 0 0 0 1px var(--cz-hair); display: flex; flex-direction: column; gap: 2px; }
 .np-mh { margin: 0; padding: 8px 12px 4px; font-size: var(--fs-1); font-weight: 800; color: var(--cz-ink2); }

package/workspace/public/pm/ini-about.js

@@ -7,6 +7,12 @@
  *   aboutHtml(v, o, open)      → the markup: the header press (data-iv-mc="ab") with its one-line summary, then the two columns when open
  *   resetAbout()               forget the descriptions read (for the tests)
  *
+ * The description (initiative-description-field): the record's own `description:` line (v.desc, from the board trail) wins. When the PRD's
+ * paragraph says more than it, the PRD's shows once below it, marked "From the PRD". With no line, the PRD's paragraph shows as before. With
+ * neither, "Ask Claude to draft it" opens Home chat with a prompt that names the id, so the kept text is saved to the record
+ * (`pmos initiative describe`). Claude also drafts it by itself under the ✦ (lib/description-props.js).
+ *   saysMore(desc, prd)        → true when the PRD's paragraph is fuller than the description and not in it yet. Pure.
+ *
  * The success measure is the one Claude drafts (pm/metric-drafts.js, GET /api/metric-drafts): its proposal keeps its own card and presses; a
  * kept measure is listed here as rows, each with its Now → Target. A row that also carries `base` (where it started) and `pace` (how far it
  * should be by today, 0 to 1) draws as a track with a tick at the pace and a verdict: On pace, Ahead of pace, Behind pace, Short of target,
@@ -21,7 +27,7 @@ const STALE_DAYS = 30;
 const MAX_CHARS = 700;
 
 /* ── the description ── */
-const plain = (s) => String(s).replace(/!\[[^\]]*\]\([^)]*\)/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/[*_`]+/g, '').replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim();
+const plain = (s) => String(s).replace(/!\[[^\]]*\]\([^)]*\)/g, '').replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/[*`]+/g, '').replace(/(^|\W)_+(?=\w)|(?<=\w)_+(?=\W|$)/g, '$1').replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim();
 /** The description a PRD gives. */
 export function descOf(md) {
   let t = String(md || '').replace(/\r\n?/g, '\n');
@@ -64,6 +70,9 @@ export function want(ws, path, onChange) {
   return one;
 }
 const descFor = (ws, path) => READ.get((ws || '') + '|' + path) || null;
+const norm = (s) => String(s || '').toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+/** The PRD says more: not already in the description, and fuller (the same rule as lib/description-props.js). */
+export function saysMore(desc, prd) { const d = norm(desc), q = norm(prd); return !!q && !d.includes(q.slice(0, 60)) && !q.includes(d) ? q.length > d.length + 40 : false; }
 export const resetAbout = () => { READ.clear(); OPEN.clear(); LASTWS = ''; };
 const OPEN = new Set();   // initiative ids whose description is open past three lines, for the session
 
@@ -96,7 +105,7 @@ const rowHtml = (r, o) => {
 const homeHref = (ws, id, q) => { const u = new URLSearchParams(); if (ws) u.set('ws', ws); u.set('ask', id); u.set('q', q); return '/premium.html?' + u.toString(); };
 /** The folded line: the first measure's dot and value, or the one next action. */
 function summaryOf(v, M, d, o) {
-  const none = !d || d.state !== 'ok';
+  const none = !v.desc && (!d || d.state !== 'ok');
   if (M && M.mode === 'kept') {
     const r = M.rows[0], t = trackOf(r, o), st = t ? t.state : r.now == null ? 'unread' : '';
     const val = r.now == null && !r.nowTxt ? 'not read yet' : nowText(r) + (r.targetTxt ? ' → ' + r.targetTxt : '');
@@ -108,18 +117,24 @@ function summaryOf(v, M, d, o) {
 }
 export function aboutHtml(v, o, open) {
   const id = v.id || v.key || '', ws = o.ws || LASTWS;
-  const prd = v.links && v.links.prd ? v.links.prd : '';
+  const prd = v.links && v.links.prd ? v.links.prd : v.prd || '';   // the trail's PRD path (v.prd); v.links is the task links on the Board
   const d = prd ? descFor(ws, prd) : null;
   const M = MD.measuresOf(id);
   v = { ...v, docState: !prd ? 'none' : d ? d.state : 'loading' };
   const sum = summaryOf(v, M, d, o);
-  let desc;
-  if (d && d.state === 'ok') {
-    const long = d.text.length > 260, shut = long && !OPEN.has(id);
-    desc = `<p class="ab-p${shut ? ' cl' : ''}">${esc(d.text)}</p>${long ? `<button type="button" class="ab-lk" data-ab-more="${esc(id)}" aria-expanded="${!shut}">${shut ? 'Show more' : 'Show less'}</button>` : ''}`
-      + (o.doc ? `<button type="button" class="ab-lk" data-iv-doc="${esc(prd)}">Open the PRD ${SVG(P.go, 14, 2.2)}</button>` : '');
-  } else if (prd && (!d || d.state === 'loading')) desc = '<p class="ab-p q">Reading the PRD…</p>';
-  else desc = `<p class="ab-p q">No description yet.</p><a class="ab-lk" href="${esc(homeHref(ws, id, 'Draft the description of ' + (v.title || id) + ': '))}">${SVG(P.chat, 14)} Ask Claude to draft it</a>`;
+  let desc, fromPrd = false;
+  const para = (key, text, cls = '') => {
+    const long = text.length > 260, shut = long && !OPEN.has(key);
+    return `<p class="ab-p${cls}${shut ? ' cl' : ''}">${esc(text)}</p>${long ? `<button type="button" class="ab-lk" data-ab-more="${esc(key)}" aria-expanded="${!shut}">${shut ? 'Show more' : 'Show less'}</button>` : ''}`;
+  };
+  const openPrd = o.doc ? `<button type="button" class="ab-lk" data-iv-doc="${esc(prd)}">Open the PRD ${SVG(P.go, 14, 2.2)}</button>` : '';
+  const own = v.desc ? String(v.desc) : '';
+  if (own) {
+    // the record's own description wins; the PRD's paragraph shows once, below, only when it says more
+    desc = para(id, own) + (d && d.state === 'ok' && saysMore(own, d.text) ? `<h5 class="ab-from">From the PRD</h5>${para(id + '|prd', d.text)}${openPrd}` : '');
+  } else if (d && d.state === 'ok') { fromPrd = true; desc = para(id, d.text) + openPrd; }
+  else if (prd && (!d || d.state === 'loading')) desc = '<p class="ab-p q">Reading the PRD…</p>';
+  else desc = `<p class="ab-p q">No description yet.</p><a class="ab-lk" href="${esc(homeHref(ws, id, 'Draft the description of ' + (v.title || id) + ' (' + id + ') from what you can read, and save it to the initiative once I keep it: '))}">${SVG(P.chat, 14)} Ask Claude to draft it</a>`;
   let met;
   if (M && M.mode === 'open') met = MD.iniHtml(id, ws, v.title);
   else if (M && M.mode === 'kept') met = `<div class="ab-ml">${M.rows.map((r) => rowHtml(r, o)).join('')}</div>`
@@ -127,7 +142,7 @@ export function aboutHtml(v, o, open) {
   else met = `<p class="ab-p q">No success measure yet.</p><a class="ab-lk" href="${esc(homeHref(ws, id, 'Propose a success measure for ' + (v.title || id) + ': '))}">${SVG(P.chat, 14)} Ask Claude to propose one</a>`;
   const anchor = v.anchor ? `<span>Anchored to ${esc(v.anchor)}</span>` : '';
   return `<section class="iv-ab" aria-label="About"><button type="button" class="iv-ab-h" data-iv-mc="ab" aria-expanded="${!!open}"><b>About</b>${sum}<span class="chev" aria-hidden="true">${SVG(P.down, 16, 2)}</span></button>`
-    + (open ? `<div class="iv-ab-b"><div class="ab-d"><h4>Description${d && d.state === 'ok' ? ' <span>From the PRD</span>' : ''}</h4>${desc}</div><div class="ab-m"><h4>Success measure ${anchor}</h4>${met}</div></div>` : '') + '</section>';
+    + (open ? `<div class="iv-ab-b"><div class="ab-d"><h4>Description${fromPrd ? ' <span>From the PRD</span>' : ''}</h4>${desc}</div><div class="ab-m"><h4>Success measure ${anchor}</h4>${met}</div></div>` : '') + '</section>';
 }
 /** The banner's one measure chip (R2): the first kept measure's dot and value, or a proposal's mark; '' when there is none. */
 export function chipHtml(v, o = {}) {

package/workspace/public/pm/ini-props.js

@@ -36,7 +36,7 @@ const md = (iso) => { const m = DAY.exec(String(iso || '')); return m ? MON[+m[2
 const span = (a, b) => (a && b && a !== b ? md(a) + ' – ' + md(b) : md(a || b));
 const plural = (n, a, b) => n + ' ' + (n === 1 ? a : b);
 const clip = (s, n) => { s = String(s || ''); return s.length > n ? s.slice(0, n - 1) + '…' : s; };
-const GROUP = { outcome: 'Expected outcome', found: 'Found elsewhere', dates: 'Dates', status: 'Looks done', names: 'Names', links: 'Links', grill: 'Claude grilled it' };
+const GROUP = { description: 'Description', outcome: 'Expected outcome', found: 'Found elsewhere', dates: 'Dates', status: 'Looks done', names: 'Names', links: 'Links', grill: 'Claude grilled it' };
 
 /* ── the chip and the live look ── */
 export function chipOf(p) {
@@ -94,10 +94,11 @@ const titleOf = (p) => {
   if (p.group === 'found') return p.type === 'stage' ? 'Stage: ' + ((p.data && p.data.stage) || '') : p.type === 'docs' ? plural(n, 'document', 'documents') : p.type === 'tasks' ? plural(n, 'task', 'tasks') : p.type === 'link' ? 'Already in another initiative' : p.type === 'maybe' ? 'Maybe this initiative' : plural(n, 'thing', 'things') + ' not placed';
   if (p.group === 'status') return plural(n, 'task looks', 'tasks look') + ' done';
   if (p.group === 'names') return 'Tidy ' + plural(n, 'name', 'names');
+  if (p.group === 'description') return p.type === 'enrich' ? 'A fuller description from the PRD' : 'What this initiative is';
   if (p.group === 'outcome') return p.type === 'date' ? 'A date to check the outcome' : 'What should change once it ships';
   return '';
 };
-const iconOf = (p) => (p.group === 'outcome' ? I.goal : p.group === 'found' ? (p.type === 'stage' ? I.stage : p.type === 'docs' ? I.doc : p.type === 'tasks' ? I.tasks : p.type === 'link' ? I.link : I.maybe)
+const iconOf = (p) => (p.group === 'description' ? I.doc : p.group === 'outcome' ? I.goal : p.group === 'found' ? (p.type === 'stage' ? I.stage : p.type === 'docs' ? I.doc : p.type === 'tasks' ? I.tasks : p.type === 'link' ? I.link : I.maybe)
   : p.group === 'dates' ? I.cal : p.group === 'status' ? I.done : p.group === 'names' ? I.name : I.link);
 const ib = (attr, label, icon, cls = '') => `<button type="button" class="pp-ib${cls ? ' ' + cls : ''}" ${attr} aria-label="${esc(label)}" title="${esc(label)}">${SVG(icon, 16, 2.2)}</button>`;
 function itemHtml(p, x) {
@@ -110,8 +111,9 @@ function itemHtml(p, x) {
   } else if (p.group === 'dates') { t = x.title || x.task; m = (x.from && x.from.due ? md(x.from.due) + ' → ' : '') + span(x.to && x.to.start, x.to && x.to.due) + (x.jira ? ' · Jira: a drafted comment' : '') + (x.ms ? ' · ◇ a promise' : ''); }
   else if (p.group === 'status') { t = x.title || taskTitle(p.ini, x.task); m = x.jira ? 'Jira: a drafted comment' : ''; }
   else if (p.group === 'outcome') { t = x.title; m = x.due ? 'Check on ' + md(x.due) : ''; }
+  else if (p.group === 'description') { t = (p.data && p.data.text) || x.title; m = p.type === 'enrich' && p.data && p.data.from ? 'Now: ' + clip(p.data.from, 120) : ''; }
   else if (p.group === 'names') { t = x.to; m = 'Was: ' + (x.from || '') + (x.jira ? ' · Jira: a drafted comment' : ''); }
-  return `<div class="pp-it"><span class="w"><b>${esc(clip(t, 90))}</b>${m ? `<small>${esc(m)}</small>` : ''}</span>${x.sig ? ib(`data-pp-dropit="${esc(x.sig)}"`, 'Leave this one out', I.x) : ''}</div>`;
+  return `<div class="pp-it"><span class="w"><b>${esc(clip(t, p.group === 'description' ? 700 : 90))}</b>${m ? `<small>${esc(m)}</small>` : ''}</span>${x.sig ? ib(`data-pp-dropit="${esc(x.sig)}"`, 'Leave this one out', I.x) : ''}</div>`;
 }
 function linkHtml(p, l) {
   const pick = S.choices[l.key] || l.rec;

package/workspace/public/pm/ini-view-model.js

@@ -322,7 +322,7 @@ export function iniView(r, ctx = {}) {
   summary.wf = r.wf || { id: PF_ID, name: 'Product feature', icon: 'feature' };
   summary.program = ctx.program || null;
   const today2 = (n) => String(n).padStart(2, '0');
-  return { anchor: r.kr || '', vs: r.__vs || null, links: r.__vs && r.__vs.draft ? null : r.links || null, id: r.id || null, key: r.key, title: r.title, today: today.getFullYear() + '-' + today2(today.getMonth() + 1) + '-' + today2(today.getDate()), summary, stage, tasks, docs: ctx.docs != null ? ctx.docs : null, linked: linkedOf(r), jiraAt: jiraIn ? ctx.jiraAt || '' : '', jiraRead: ctx.jiraReadAt || '',
+  return { anchor: r.kr || '', vs: r.__vs || null, links: r.__vs && r.__vs.draft ? null : r.links || null, prd: (r.trail && r.trail.links && r.trail.links.prd) || null, desc: (r.trail && r.trail.desc) || r.desc || null, id: r.id || null, key: r.key, title: r.title, today: today.getFullYear() + '-' + today2(today.getMonth() + 1) + '-' + today2(today.getDate()), summary, stage, tasks, docs: ctx.docs != null ? ctx.docs : null, linked: linkedOf(r), jiraAt: jiraIn ? ctx.jiraAt || '' : '', jiraRead: ctx.jiraReadAt || '',
     // split or merge (batch 11 item 14): Claude's suggestion for it, and where its work went when it was merged
     suggest: r.suggest || null, merged: mergedOf(r),
     // what Claude proposes under the one blue ✦, and what a ✓ kept from elsewhere (batch 12 items 2, 3 and 4; pm/ini-props.js)

package/workspace/public/pm/ini-view.css

@@ -1041,6 +1041,7 @@ button.iv-mt.iv-wf { padding: 0 !important; margin: 0 !important; }
 @container iv (min-width: 760px) { .iv-ab-b { grid-template-columns: minmax(0, 1fr) minmax(0, 460px); gap: 32px; } }
 .ab-d h4, .ab-m h4 { margin: 0 0 6px; font-size: var(--fs-label); font-weight: var(--fw-strong); color: var(--cz-ink3); letter-spacing: .02em; display: flex; gap: 8px; align-items: baseline; flex-wrap: wrap; line-height: var(--lh-label); }
 .ab-d h4 span, .ab-m h4 span { font-weight: var(--fw-strong); }
+.ab-d h5.ab-from { margin: 12px 0 4px; font-size: var(--fs-label); font-weight: var(--fw-strong); color: var(--cz-ink3); line-height: var(--lh-label); }
 .ab-p { margin: 0; font-size: var(--fs-body); line-height: 1.55; max-width: 62ch; color: var(--cz-ink); }
 .ab-p.q { color: var(--cz-ink3); }
 .ab-p.cl { display: -webkit-box; -webkit-line-clamp: 3; -webkit-box-orient: vertical; overflow: hidden; }

package/workspace/public/pm/ini-view.js

@@ -415,7 +415,7 @@ export function wireView(body, h) {
   const drafts = (id) => { const H = body.__iv || {}; if (id && VIEWED.has(id)) MD.want(((H.where && H.where()) || {}).ws || '', 'initiative', id, () => { if (idOf() === id && H.redraw) H.redraw(); }); };
   // the description: the PRD, read once per path through /api/doc; the view draws again when it arrives
   // About draws alone when its description arrives: a full redraw would close a task row the PM has open
-  const about = (id) => { const H = body.__iv || {}, v = id && VIEWED.get(id), prd = v && v.links && v.links.prd;
+  const about = (id) => { const H = body.__iv || {}, v = id && VIEWED.get(id), prd = v && ((v.links && v.links.prd) || v.prd);
     if (prd) AB.want(((H.where && H.where()) || {}).ws || '', prd, () => { const at = idOf() === id && body.querySelector('.iv-ab'); if (!at) return; const M = MD.measuresOf(id); at.outerHTML = AB.aboutHtml(v, OPTS.get(id) || {}, mcState(id, { proposal: !!(M && M.mode === 'open') }).ab); }); };
   chip();
   G.attach(body, body.__iv);   // the layout and the drafted tickets of the initiative shown (batch 11 item 20)

package/workspace/public/pm/next-prompt-ui.js

@@ -3,7 +3,8 @@
  * After a reply ends: up to two cards above the box, the one Claude recommends lit (white, blue ring, blue ✦), the other grey. A tap puts its
  * text in the box; nothing sends, and the PM sends with the box's own ↑. No ↵, edit or dismiss icon. No card when there is no clear next step.
  * The cards hide when the PM types or a new reply starts; they have no timeout.
- * While the PM types a rough prompt (3 or more words), after a 1.5 s pause: a spinner card while Claude sharpens it, then one lit Sharper card.
+ * While the PM types a rough prompt (3 or more words), after a 2 s pause: one quiet line (a small turning mark, "Sharpening…") while Claude
+ * sharpens it, then one lit Sharper card. Typing is never held up; an answer for words no longer in the box, or one later than 30 s, is dropped.
  * Its sliders icon opens the style menu: Sharpen as Polish, Prompt engineer (the default) or Your own, and the Sharpen as I type switch.
  * After a tap on the Sharper card, ↶ in the box puts back what the PM wrote (NpB 5).
  * Server: GET /api/next-prompt/prefs, POST /api/next-prompt/next and /sharpen (lib/routes-next-prompt.js, through lib/ai-guard.js); the style
@@ -15,7 +16,7 @@ const STAR = '<svg aria-hidden="true" width="15" height="15" viewBox="0 0 24 24"
 const SLIDERS = 'M4 7h9M17 7h3M4 17h3M11 17h9M13 4v6M7 14v6', CHECK = 'M5 12l5 5L20 7', UNDO = 'M9 14L4 9l5-5M4 9h11a5 5 0 0 1 0 10h-3', SPIN = 'M12 3a9 9 0 1 1-9 9';
 const ic = (d, w = 16) => `<svg aria-hidden="true" width="${w}" height="${w}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="${d}"/></svg>`;
 const STYLES = [['polish', 'Polish', 'Clearer and shorter, your meaning kept'], ['engineer', 'Prompt engineer', 'Builds the best prompt for the job'], ['own', 'Your own', 'Your wording rules, written once in Settings']];
-const PAUSE = 1500;
+const PAUSE = 2000, WAIT = 30000;
 export const roughText = (t) => { const s = String(t || '').trim(); return !s.startsWith('/') && s.length >= 12 && s.split(/\s+/).filter(Boolean).length >= 3; };
 
 export function nextPromptUi({ el, host, box, redrawFoot }) {
@@ -36,7 +37,7 @@ export function nextPromptUi({ el, host, box, redrawFoot }) {
     if (N.mode === 'cards' && N.cards.length) {
       html = `<div class="np-list" role="group" aria-label="Suggested next prompts">${N.cards.map((c, i) => `<button type="button" class="np-card${c.rec ? ' rec' : ''}" data-np-use="${i}" aria-label="Use this prompt: ${esc(c.text)}"${c.rec ? ' title="Claude recommends this one"' : ''}>${STAR}<span class="np-t">${esc(c.text)}</span></button>`).join('')}</div>`;
     } else if (N.mode === 'spin') {
-      html = `<div class="np-spin" role="status" aria-label="Claude is sharpening your prompt"><span class="np-sp">${ic(SPIN, 20)}</span><span class="np-sk"><i></i><i></i></span></div>`;
+      html = `<div class="np-spin" role="status"><span class="np-sp">${ic(SPIN, 14)}</span><span>Sharpening…</span></div>`;
     } else if (N.mode === 'sharp' && N.sharp) {
       const P = N.prefs || {}, st = P.style || 'engineer';
       const menu = N.menu ? `<div class="np-menu" role="menu" aria-label="Style of sharper prompts" data-esc-layer><p class="np-mh">Sharpen as</p>${STYLES.map(([k, l, d]) => `<button type="button" role="menuitemradio" aria-checked="${st === k}" class="np-mi" data-np-voice="${k}"><span class="np-ck">${st === k ? ic(CHECK) : ''}</span><span><b>${esc(l)}</b><em>${esc(k === 'own' && !P.rules ? 'Write your rules in Settings first' : d)}</em></span></button>`).join('')}`
@@ -58,7 +59,9 @@ export function nextPromptUi({ el, host, box, redrawFoot }) {
     const my = ++N.seq;
     N.mode = 'spin'; N.sharp = null; draw();
     const c = N.ctx || {};
+    const late = setTimeout(() => { if (my === N.seq && N.mode === 'spin') { N.seq++; N.mode = null; draw(); } }, WAIT);   // no answer in time: the line goes quietly
     const r = await host.pmPost('/api/next-prompt/sharpen', { key: c.key || '', text: value, reply: c.reply || '', initiative: c.initiative || '', title: c.title || '' }).catch(() => null);
+    clearTimeout(late);
     const ta = box();
     if (my !== N.seq || !ta || ta.value !== value) return;   // the PM typed on, or sent: this answer is for words no longer in the box
     if (r && r.ok && r.text) { N.mode = 'sharp'; N.sharp = r.text; } else { N.mode = null; }

package/workspace/server.js

@@ -3106,6 +3106,20 @@ const outcomeProps = require('./lib/outcome-props.js').create({
   every: TICK_MS,
   mayRun: () => { try { return scheduleOwner.mayRun(); } catch { return true; } },
   warn: (what, e) => warnWriteFail(what, e) });
+// initiative-description-field: once a day Claude drafts the description of each initiative that has none (or a fuller one once its PRD says
+// more) under the initiative's ✦, from the PRD's or the record's own words, cited (lib/description-props.js). No session and no model; through
+// the shared guard. A ✓ of the PM writes the record. Off with PMOS_DESCRIPTIONS=off or pmos ai off descriptions.
+const descriptionProps = require('./lib/description-props.js').create({
+  workspaces: () => [...workspaces.values()],
+  isLead: (w) => isPlanNeedsTree(w),
+  stateDirFor: (w) => stateDirFor(w),
+  boardOf: (w, id) => require('./lib/routes-boards.js').boardIndex(proposalCtx(), w).of(id),
+  runtime: () => STATE,
+  open: (now) => !proactiveLib.inQuietHours(now, proSettings().quiet),
+  env: process.env,
+  every: TICK_MS,
+  mayRun: () => { try { return scheduleOwner.mayRun(); } catch { return true; } },
+  warn: (what, e) => warnWriteFail(what, e) });
 // batch 16 item 6 ("Claude runs the OKRs"): Claude reads each goal with its recipe (lib/metric-read-runs.js) when its cadence comes round, files the
 // value with its source and time, says honestly what it could not read and drafts the fix. A broken limit opens one alert: a bell line only when
 // the goal's notify is push. At most 2 runs at once, one per product. PMOS_METRIC_READ=off.

package/workspace/test-lists/initiative-description-field.json

@@ -0,0 +1,5 @@
+{
+  "_comment": "initiative-description-field: every initiative has its own description. The record writer, the cited drafts, the guard, the daily filer under the ✦ and pmos initiative describe (lib/initiative-writer.js setDescription, lib/description-props.js, lib/proposals.js group description, lib/initiative-cli.js describe).",
+  "modules": ["descriptions.test.js"],
+  "seconds": { "descriptions.test.js": 3 }
+}