create-pmos 0.168.0 → 0.170.0

package/workspace/public/pm/c3-driver.js

@@ -0,0 +1,298 @@
+/* pm/c3-driver.js — the Initiative Driver on console3 (initiative initiative-driver, PRD section 5; mockup mockup-c3-driver, 39-driver.js).
+ * The agent works on every initiative and Work task on its own and files each result as a PROPOSAL. Nothing it writes changes a record
+ * or leaves PMOS: the PM keeps, sends back with a note, or drops. This file draws the three places the PM sees it:
+ *
+ *   driverStrip(ctx, row)            the Agent strip on an initiative's Overview: status, last action, blocker, one row per open proposal
+ *   agentSetting(state, { onPick })  the Agent setting (Off, Shadow, Approve) in the Board settings sheet; loadAgentMode(api, board) reads it
+ *   workNote(o) · openDraftSheet(o)  the one agent line under a Work task and the sheet behind its Review (c3-driver-work.js draws them)
+ *
+ * Reads: GET /api/driver/strip, /api/driver/mode, /api/driver/open. Presses: POST /api/driver/keep, return, drop, pause, resume, mode,
+ * through http.js (the nonce and the page Origin). The page sends no `by`: the server takes the PM from the call path. After each press
+ * the strip is read again. Keep, send back and drop have no Undo: each adds a line to the ledger, and nothing is removed.
+ * A proposal that was just decided stays in its strip, marked, until the page is left. Plain words for every empty and error state.
+ */
+import { el } from './dom.js';
+import { icon, pbtn, lk, chip, tag, st, note, lbl, chgl, list, nrow, sect, put, btn, plural } from './c3-ini-ui.js';
+import { toast } from './c3-toast.js';
+import { pmGet } from './http.js';
+
+/** Link c3-driver.css once, from this module's own folder (the way c3-initiatives.js links its stylesheet). */
+export function ensureDriverCss() {
+  if (typeof document === 'undefined' || document.querySelector('link[data-c3-drv]')) return;
+  const l = document.createElement('link');
+  l.rel = 'stylesheet'; l.href = new URL('./c3-driver.css', import.meta.url).href; l.setAttribute('data-c3-drv', '');
+  document.head.appendChild(l);
+}
+
+/* ── words ── */
+export const WHAT = {
+  problem: ['Problem statement', 'doc'], evidence: ['Evidence', 'doc'], sizing: ['Opportunity sizing', 'target'], assumption: ['Riskiest assumption and spike brief', 'bolt'],
+  stakeholders: ['Stakeholders', 'user'], move: ['Move', 'next'], note: ['Note', 'notes'], 'next-step': ['Next step', 'check'], 'follow-up': ['Follow-up', 'mail'],
+};
+export const MODES = [
+  ['off', 'Off', 'The agent does nothing on this board.'],
+  ['shadow', 'Shadow', 'The agent drafts but raises nothing. You see its drafts only on the initiative page.'],
+  ['approve', 'Approve', 'The agent drafts and asks you. Each draft waits for Keep, Send back or Drop.'],
+];
+const errText = (r, what) => what + ': ' + ((r && r.error) || 'the workspace did not answer') + '.';
+const isUrl = (s) => /^https?:\/\/\S+$/i.test(String(s || ''));
+const MON = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+const WD = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const p2 = (n) => String(n).padStart(2, '0');
+const clock = (d) => p2(d.getHours()) + ':' + p2(d.getMinutes());
+/** '11:05' for today, 'Fri 9 Oct, 16:05' for any other day. */
+export function whenLabel(iso, now = new Date()) {
+  const d = new Date(iso);
+  if (!Number.isFinite(d.getTime())) return '';
+  return d.toDateString() === now.toDateString() ? clock(d) : WD[d.getDay()] + ' ' + d.getDate() + ' ' + MON[d.getMonth()] + ', ' + clock(d);
+}
+/** Whole days a time is old. */
+export const daysOld = (iso, now = Date.now()) => { const t = Date.parse(iso); return Number.isFinite(t) ? Math.floor((now - t) / 864e5) : 0; };
+/** 'Thu 15 Oct' for a YYYY-MM-DD. */
+export function dueLabel(ymd) {
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(String(ymd || ''));
+  if (!m) return '';
+  const d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+  return WD[d.getDay()] + ' ' + d.getDate() + ' ' + MON[d.getMonth()];
+}
+const textOf = (p) => (p && p.data && typeof p.data.text === 'string' ? p.data.text : '');
+export const titleOf = (p) => (p.what === 'move' && p.data && p.data.to ? 'Move to ' + p.data.to : (WHAT[p.what] || [p.what])[0]);
+
+/** The text a proposal shows when it opens: the draft, then the agent's one-line reason. */
+export function bodyOf(p) {
+  const out = [];
+  const t = textOf(p);
+  if (p.what === 'move') out.push('Move this initiative to ' + ((p.data && p.data.to) || 'the next stage') + '.');
+  else if (t) out.push(t);
+  else if (p.data && Array.isArray(p.data.items)) out.push(plural(p.data.items.length, 'item') + ' with a pointer each.');
+  else if (p.data && typeof p.data === 'object' && Object.keys(p.data).length) out.push(Object.entries(p.data).map(([k, v]) => k + ': ' + (typeof v === 'string' ? v : JSON.stringify(v))).join('\n'));
+  if (p.what === 'next-step' && p.data && p.data.due) out.push('Due: ' + dueLabel(p.data.due) + '.');
+  if (p.why) out.push('Why: ' + p.why);
+  if (p.what === 'move') out.push('Keep moves the stage. The agent only proposes.');
+  return out.join('\n');
+}
+/** The sources of a proposal: its own list, then the items of an evidence draft that carry a pointer. */
+export function sourcesOf(p) {
+  const out = (p.sources || []).map((s) => ({ label: s.label, ref: s.ref, text: '' }));
+  if (p.data && Array.isArray(p.data.items)) for (const i of p.data.items) if (i && i.ref) out.push({ label: 'Evidence', ref: String(i.ref), text: String(i.text || '') });
+  return out;
+}
+const srcIcon = (label) => (/jira/i.test(label) ? 'jira' : /slack|mail|email|thread/i.test(label) ? 'mail' : 'doc');
+function srcRow(s) {
+  const ref = isUrl(s.ref) ? el('a', { class: 'mono drv-ref', href: s.ref, target: '_blank', rel: 'noopener noreferrer' }, s.ref) : el('span', { class: 'mono drv-ref' }, s.ref);
+  return el('li', { 'data-drv-src': '' }, icon(srcIcon(s.label), 'sm'), el('span', { class: 'drv-src' }, el('b', null, s.label), ref, s.text ? el('span', null, s.text) : null));
+}
+
+/* ── what the PM decided this visit: kept and sent-back rows stay in the strip, marked ── */
+const DECIDED = new Map();   // target key -> Map(proposal id -> { st: 'kept' | 'back', note, p })
+const decidedOf = (key) => { if (!DECIDED.has(key)) DECIDED.set(key, new Map()); return DECIDED.get(key); };
+
+/** One press on the driver. Returns the server's answer; an error is a toast and null. */
+async function press(ctx, route, body, what) {
+  const r = await ctx.api.post('/api/driver/' + route, body);
+  if (!r || !r.ok) { toast({ text: errText(r, what + ' did not work'), tone: 'error', timeout: 6000 }); return null; }
+  return r;
+}
+
+/** The sheet that asks for a one-line note and sends a proposal back with it. */
+export function openSendBack(ctx, p, onSent) {
+  const input = el('input', { type: 'text', 'data-drv': 'note', placeholder: 'Tell the agent what is wrong or missing', 'aria-label': 'Note to the agent', maxlength: '500', autocomplete: 'off' });
+  const err = el('div', { class: 'fold w', role: 'alert', hidden: true, 'data-drv': 'note-error' });
+  let busy = false;
+  const send = async () => {
+    const n = input.value.trim();
+    if (!n) { err.hidden = false; put(err, icon('alert', 'sm'), 'Write one line for the agent. A note starts its next run.'); input.focus(); return; }
+    if (busy) return; busy = true;
+    const r = await press(ctx, 'return', { proposal: p.id, note: n }, 'Send back');
+    busy = false;
+    if (!r) return;
+    sh.close();
+    toast('Sent back with your note. The agent redrafts it.');
+    onSent(n);
+  };
+  input.addEventListener('keydown', (e) => { if (e.key === 'Enter' && !e.isComposing) { e.preventDefault(); send(); } });
+  const sh = ctx.openSheet({ title: 'Send back: ' + titleOf(p), icon: 'reply', body: el('div', { class: 'drv-sheet' },
+    el('p', { class: 'drv-pre' }, bodyOf(p)), el('div', { class: 'form' }, input), err,
+    el('div', { class: 'iacts chips2' }, pbtn('primary', 'Send back with note', 'reply', { 'data-drv': 'send-back', onclick: send }), pbtn('ghost', 'Cancel', null, { onclick: () => sh.close() }))) });
+  setTimeout(() => input.focus(), 30);
+  return sh;
+}
+
+/* ── the Agent strip ── */
+/** Plain words for the state of the agent on this initiative, from GET /api/driver/strip. */
+export function statusOf(d, now = Date.now()) {
+  const open = d.proposals || [];
+  const used = (d.budget && d.budget.used) || 0; const limit = (d.budget && d.budget.limit) || 3;
+  const oldest = open.map((p) => daysOld(p.at, now)).reduce((a, b) => Math.max(a, b), 0);
+  let last = 'No run yet.';
+  if (d.last) last = d.last.ok ? 'Last: ' + (d.last.proposals ? 'filed ' + plural(d.last.proposals, 'proposal') : 'looked and found nothing new') + ' · ' + whenLabel(d.last.at, new Date(now))
+    : 'Last run did not finish' + (d.last.reason ? ': ' + d.last.reason : '') + ' · ' + whenLabel(d.last.at, new Date(now));
+  if (d.paused) return { ic: 'pause', b: 'Agent is paused', sub: 'It files nothing until you resume.', last };
+  if (d.running) return { ic: 'spark', b: 'Agent is working · started ' + whenLabel(d.running.since, new Date(now)), sub: 'It works inside the limits you set and files each result as a proposal.', last };
+  if (open.length) return { ic: 'wait', b: 'Agent is idle · waiting on you', sub: oldest >= 1 ? 'The oldest proposal is ' + plural(oldest, 'day') + ' old.' : plural(open.length, 'proposal') + ' wait for your decision.', last };
+  if (used >= limit) return { ic: 'clock', b: 'Agent is idle · used its runs for today', sub: 'It runs up to ' + limit + ' times a day on each initiative. It starts again tomorrow.', last };
+  return { ic: 'spark', b: 'Agent is idle', sub: 'It starts again when something changes: a stage move, a new initiative, or a note from you.', last };
+}
+/** The line that says what stops the agent, or ''. A blocker the PM owns names the PM. */
+export function blockerLine(d) {
+  if (!d.blocker || !d.blocker.text) return '';
+  if (d.blocker.owner === 'pm') return 'Stopped by: you. ' + d.blocker.text + '. The agent starts no run until you decide.';
+  return 'Stopped by: ' + String(d.blocker.text).replace(/\.$/, '') + '.';
+}
+
+/**
+ * The Agent section of an initiative's Overview. Draws at once with "Reading the agent" and fills itself from the server.
+ * ctx: api, row (the initiative), board, refresh, openSheet, openBoardSettings.
+ */
+export function driverStrip(ctx, row) {
+  ensureDriverCss();
+  const wrap = el('div', { class: 'drv', 'data-drv': 'strip' });
+  const key = (ctx.ws || '') + ':initiative:' + row.id;
+  const S = { data: null, err: '', open: new Set(), busy: false };
+
+  async function load() {
+    const r = await ctx.api.get('/api/driver/strip', { target_kind: 'initiative', id: row.id, board: ctx.board && ctx.board.id });
+    if (!r || !r.ok) { S.data = null; S.err = errText(r, 'The agent strip could not be read'); } else { S.data = r; S.err = ''; }
+    draw();
+  }
+  const reread = load;
+
+  async function decide(route, p, extra) {
+    const r = await press(ctx, route, { proposal: p.id, ...(extra || {}) }, route === 'keep' ? 'Keep' : 'Drop');
+    return r;
+  }
+  async function keep(p) {
+    const r = await decide('keep', p);
+    if (!r) return;
+    decidedOf(key).set(p.id, { st: 'kept', p });
+    const w = (r.warnings || []).filter(Boolean);
+    toast(p.what === 'move' ? 'Kept. The stage moved to ' + ((p.data && p.data.to) || 'the next stage') + '.' + (w.length ? ' ' + w.join(' ') : '') : 'Kept: ' + titleOf(p));
+    if (['move', 'problem', 'next-step'].includes(r.wrote)) ctx.refresh();   // the stage chips and the record cards read the new record
+    else await reread();
+  }
+  async function drop(p) {
+    const r = await decide('drop', p);
+    if (!r) return;
+    S.open.delete(p.id);
+    toast('Dropped: ' + titleOf(p));
+    await reread();
+  }
+  const sendBack = (p) => openSendBack(ctx, p, (n) => { decidedOf(key).set(p.id, { st: 'back', note: n, p }); reread(); });
+  async function pause(on) {
+    const r = await press(ctx, on ? 'pause' : 'resume', { target_kind: 'initiative', id: row.id }, on ? 'Pause' : 'Resume');
+    if (!r) return;
+    toast(on ? 'Agent paused. It files nothing until you resume.' : 'Agent resumed.');
+    await reread();
+  }
+  function openRuns() {
+    const d = S.data; const runs = (d && d.today) || [];
+    const used = d && d.budget ? d.budget.used : runs.length; const limit = d && d.budget ? d.budget.limit : 3;
+    ctx.openSheet({ title: 'Agent runs today', icon: 'clock', body: el('div', { class: 'drv-sheet', 'data-drv': 'runs-sheet' },
+      note(row.title + ' · ' + used + ' of ' + limit + ' runs used today'),
+      runs.length ? chgl(runs.map((r) => el('li', { 'data-drv-run': r.run }, icon('clock', 'sm'),
+        el('span', null, el('b', null, whenLabel(r.start)), ' ', r.end ? (r.ok ? 'Run ended' : 'Run did not finish') : 'Running now'),
+        tag(r.end ? (r.ok ? (r.proposals ? 'Filed ' + plural(r.proposals, 'proposal') : 'Nothing new') : (r.reason || 'Failed')) : 'Running now'))))
+        : el('div', { class: 'fold' }, icon('info', 'sm'), 'The agent has not run on this initiative today.'),
+      el('div', { class: 'fold' }, icon('info', 'sm'), 'The agent runs up to ' + limit + ' times a day on each initiative. It stops at the limit and starts again tomorrow. A run that fails still counts.'),
+      el('div', { class: 'iacts chips2' }, pbtn('outline', 'Board settings', 'settings', { onclick: () => { closeAnd(() => ctx.openBoardSettings()); } }))) });
+  }
+  const closeAnd = (fn) => { import('./c3-sheet.js').then((m) => { m.closeSheet(); fn(); }); };
+
+  function propRow(p, state) {
+    const kept = state && state.st === 'kept'; const back = state && state.st === 'back';
+    const old = !state && daysOld(p.at) >= 1;
+    const srcs = sourcesOf(p);
+    const chips = [
+      tag(p.what === 'move' ? 'stage move' : 'draft'),
+      p.at ? chip(icon('clock', 'sm'), whenLabel(p.at)) : null,
+      srcs.length ? chip(icon('out', 'sm'), plural(srcs.length, 'source')) : null,
+      old ? el('span', { class: 'tag warn' }, 'waiting ' + plural(daysOld(p.at), 'day')) : null,
+      kept ? st('ok', 'check', 'Kept by you') : null,
+      back ? tag('Sent back · agent is redrafting') : null,
+    ];
+    const xp = el('div', { class: 'ip' },
+      el('p', { class: 'drv-pre' }, bodyOf(p)),
+      back && state.note ? el('div', { class: 'fold' }, icon('reply', 'sm'), ' Your note: ' + state.note) : null,
+      srcs.length ? [el('span', { class: 'dim ini-note' }, 'Sources'), chgl(srcs.map(srcRow))] : el('span', { class: 'dim ini-note' }, 'No sources. ' + (p.what === 'move' ? 'This is a stage proposal.' : 'The agent named none.')));
+    const acts = state ? [] : S.data.mode === 'shadow' ? [el('span', { class: 'tag', title: 'Shadow mode: the agent drafts and raises nothing.' }, 'Shadow draft')] : [
+      pbtn('outline', 'Keep', 'check', { 'data-drv-act': 'keep', onclick: () => keep(p) }),
+      pbtn('ghost', 'Send back', null, { 'data-drv-act': 'back', onclick: () => sendBack(p) }),
+      pbtn('ghost', 'Drop', null, { 'data-drv-act': 'drop', onclick: () => drop(p) })];
+    const r = nrow({ ic: (WHAT[p.what] || ['', 'doc'])[1], hot: !state, title: titleOf(p), titleAttrs: { 'data-drv-title': p.id }, chips, xp, right: acts, attrs: { 'data-drv-row': p.id, 'data-drv-state': state ? state.st : 'open' }, key: 'drv:' + p.id, open: S.open.has(p.id), onToggle: (on) => { if (on) S.open.add(p.id); else S.open.delete(p.id); } });
+    return r;
+  }
+
+  function draw() {
+    const d = S.data;
+    if (S.err || !d) { put(wrap, sect({ ic: 'spark', title: 'Agent', attrs: { 'aria-label': 'Agent' } },
+      S.err ? el('div', { class: 'fold w', role: 'alert', 'data-drv': 'error' }, icon('alert', 'sm'), S.err, ' ', pbtn('outline', 'Try again', null, { onclick: load })) : note('Reading the agent'))); return; }
+    if (!d.ledger) { put(wrap, sect({ ic: 'spark', title: 'Agent', attrs: { 'aria-label': 'Agent' } }, el('div', { class: 'fold', 'data-drv': 'no-ledger' }, icon('info', 'sm'), 'This repository has no state folder (pmos/state, state or .pmos), so the agent has nowhere to keep its drafts.'))); return; }
+    const used = d.budget.used + ' of ' + d.budget.limit + ' runs used today';
+    const right = el('div', { class: 'chips2' },
+      d.mode === 'approve' ? (d.paused ? pbtn('outline', 'Resume', 'next', { 'data-drv-act': 'resume', onclick: () => pause(false) }) : pbtn('outline', 'Pause', 'pause', { 'data-drv-act': 'pause', onclick: () => pause(true) })) : null,
+      lk({ 'data-drv': 'runs', onclick: openRuns }, icon('clock', 'sm'), used));
+    let body;
+    if (d.mode === 'off') {
+      body = [el('div', { class: 'lh', 'data-drv': 'off' }, el('span', { class: 'ki' }, icon('pause')),
+        el('div', { class: 'ini-lhm' }, el('b', null, 'Agent is off for ' + ((ctx.board && ctx.board.name) || 'this board')), el('div', { class: 'dim' }, 'Nothing is drafted on this board. Turn it on in the board settings.')),
+        el('div', { class: 'chips2' }, pbtn('outline', 'Board settings', 'settings', { onclick: () => ctx.openBoardSettings() })))];
+    } else {
+      const s = statusOf(d); const blk = blockerLine(d);
+      const decided = decidedOf(key);
+      const ids = new Set((d.proposals || []).map((p) => p.id));
+      const rows = (d.proposals || []).map((p) => propRow(p, decided.get(p.id) || null));
+      for (const [id, x] of decided) if (!ids.has(id) && x.st !== 'dropped') rows.push(propRow(x.p, x));
+      const oldest = [...(d.proposals || [])].sort((a, b) => Date.parse(a.at) - Date.parse(b.at))[0];
+      body = [
+        el('div', { class: 'lh', 'data-drv': 'status' }, el('span', { class: 'ki' }, icon(s.ic)), el('div', { class: 'ini-lhm' }, el('b', null, s.b), el('div', { class: 'dim' }, s.sub), el('div', { class: 'dim', 'data-drv': 'last' }, s.last))),
+        d.mode === 'shadow' ? el('div', { class: 'fold', 'data-drv': 'shadow' }, icon('info', 'sm'), ' Shadow mode. The agent drafts but raises nothing: no Needs you rows, no notes in Work. Switch to Approve in the board settings to act on these.') : null,
+        blk ? el('div', { class: 'fold w', role: 'alert', 'data-drv': 'blocker' }, icon('alert', 'sm'), el('span', null, blk, d.blocker.owner === 'pm' && oldest && d.mode === 'approve' ? [' ', pbtn('outline', 'Review ' + titleOf(oldest), null, { 'data-drv-act': 'focus', onclick: () => { S.open.add(oldest.id); draw(); const t = wrap.querySelector('[data-drv-row="' + oldest.id + '"]'); if (t && t.scrollIntoView) t.scrollIntoView({ block: 'center' }); } })] : null)) : null,
+        rows.length ? list(rows) : el('div', { class: 'fold', 'data-drv': 'empty' }, icon('check', 'sm'), 'No open proposals. The agent files the next one when it has something.')];
+    }
+    put(wrap, sect({ ic: 'spark', title: 'Agent', count: d.mode === 'off' ? 0 : (d.proposals || []).length, right, attrs: { 'aria-label': 'Agent' } }, ...body));
+  }
+
+  draw();
+  load();
+  return wrap;
+}
+
+/* ── the Agent setting in Board settings ── */
+/** Read a board's mode. { ok, mode } or { ok: false, error }. */
+export async function loadAgentMode(api, board) {
+  const r = await api.get('/api/driver/mode', { board });
+  return r && r.ok ? { ok: true, mode: r.mode } : { ok: false, error: errText(r, 'The agent setting could not be read') };
+}
+/** state: { mode, err, busy }. onPick(mode) saves at once (POST /api/driver/mode); the caller redraws. */
+export function agentSetting(state, { onPick } = {}) {
+  ensureDriverCss();
+  const cur = MODES.find((m) => m[0] === state.mode);
+  return el('div', { class: 'drv-set ini-field', 'data-drv': 'setting' }, lbl('AGENT'),
+    state.mode == null && !state.err ? note('Reading the agent setting') : null,
+    state.err ? el('div', { class: 'fold w', role: 'alert', 'data-drv': 'setting-error' }, icon('alert', 'sm'), state.err) : null,
+    state.mode != null ? [
+      el('div', { class: 'seg ini-seg', role: 'group', 'aria-label': 'Agent mode' }, ...MODES.map((m) => btn({ 'aria-pressed': String(state.mode === m[0]), 'data-drv-mode': m[0], disabled: !!state.busy, onclick: () => onPick(m[0]) }, m[1]))),
+      el('div', { class: 'dim ini-note', 'data-drv': 'mode-line' }, el('b', null, cur[1] + '.'), ' ' + cur[2]),
+      chgl(MODES.filter((m) => m !== cur).map((m) => el('li', null, icon('next', 'sm'), el('span', null, el('b', null, m[1] + ':'), ' ' + m[2]), el('span')))),
+      el('div', { class: 'dim ini-note' }, 'The agent files every result as a proposal. It cannot send, merge or change a record by itself. A mode is saved when you press it.')] : null);
+}
+
+/* ── Needs you: the agent's rows (Briefing) ── */
+/** The driver rows of GET /api/needs: "Agent has 3 drafts on <title>" and "<title> is waiting on you". [] when the read fails. */
+export async function loadDriverNeeds() {
+  const r = await pmGet('/api/needs');
+  return r && Array.isArray(r.needs) ? r.needs.filter((n) => n && (n.kind === 'driver-drafts' || n.kind === 'driver-blocked')) : [];
+}
+/** One li.nrow for a driver row (the mockup's two rows). `go(row)` opens the initiative or the Work page. */
+export function needsRow(n, go) {
+  ensureDriverCss();
+  const blocked = n.kind === 'driver-blocked';
+  const work = !n.initiative_id;
+  const chips = blocked ? [el('span', { class: 'tag warn' }, 'waiting on you'), chip(icon(work ? 'check' : 'init', 'sm'), work ? 'Work' : n.initiative_id)]
+    : [tag('agent'), chip(icon(work ? 'check' : 'init', 'sm'), work ? 'Work' : n.initiative_id)];
+  chips[0].className = blocked ? 'tag warn' : 'tag acc';
+  chips.push(el('span', { class: 'dim' }, blocked ? 'The agent will not go on until you decide' : 'Keep, send back or drop each one'));
+  const li = nrow({ ic: blocked ? 'next' : 'spark', hot: true, title: n.question, onOpen: () => go(n), openLabel: n.question, chips,
+    attrs: { 'data-needs-row': n.run_id, 'data-kind': n.kind, 'data-drv-need': n.kind, 'data-ref-row': n.initiative_id || n.run_id } });
+  return li;
+}

package/workspace/public/pm/c3-ib-triage.js

@@ -15,6 +15,7 @@ import { el } from './dom.js';
 import { registerBoardTab } from './c3-initiatives.js';
 import { icon, pbtn, lk, chip, tag, st, note, noteA, lbl, sect, card, list, empty, nrow, cols, chgl, ago, put } from './c3-ini-ui.js';
 import { TEMPLATES } from './c3-ini-work.js';
+import { isScanAsk, scanAskParts } from './c3-scan.js';
 
 const LANES = ['feature', 'discovery', 'chore', 'incident', 'content', 'prototype'];
 const ANCHOR_WHY = 'An initiative needs an anchor: a key result or a health budget. PMOS refuses to create one without it.';
@@ -52,16 +53,19 @@ registerBoardTab('triage', async (host, ctx) => {
   }
   function row(a, state) {
     const open = state === 'open';
+    // initiative horizon-scan: an ask the scan found shows its reason, "Found by agent", its sources and its match, with the usual three buttons.
+    const scan = isScanAsk(a) ? scanAskParts(a, { today: ctx.today, first: first.name, onAccept: open ? openAccept : null, onMore: openMore, onDecline: openDecline }) : null;
     const ini = a.initiative && (a.initiative.id || a.initiative);
     const sharp = a.draft && typeof a.draft.confidence === 'number' ? (a.draft.confidence >= 0.7 ? 'sharp' : a.draft.confidence < 0.5 ? 'needs detail' : 'readable') : 'no draft';
     return nrow({ ic: state === 'declined' ? 'x' : state === 'accepted' ? 'check' : 'bolt', hot: open, title: a.line, key: 'ask:' + a.id,
-      chips: [a.source ? chip(a.source) : null, a.by ? chip(icon('user', 'sm'), a.by) : null, a.at ? chip(ago(a.at, ctx.today)) : null,
+      sub: scan ? scan.sub : null, after: scan ? scan.after : null,
+      chips: [...(scan && open ? scan.chips : [a.source ? chip(a.source === 'scan' ? 'Horizon scan' : a.source) : null, a.by ? chip(icon('user', 'sm'), a.by) : null, a.at ? chip(ago(a.at, ctx.today)) : null]),
         open && a.needMore ? st('warn', 'alert', 'asked for more', { 'data-ibt': 'need-more', title: a.moreNote || '' }) : null,
         state === 'accepted' ? st('ok', 'check', 'Accepted') : null, state === 'accepted' && ini ? lk({ 'data-ibt-open': ini, onclick: () => ctx.openInitiative(ini) }, ini) : null,
         state === 'declined' ? tag('declined') : null],
       right: open ? [tag(sharp)] : [],
       xp: open ? [...draftNodes(a), a.needMore && a.moreNote ? note('You asked: ' + a.moreNote) : null,
-        el('div', { class: 'chips2' }, pbtn('primary', 'Accept', 'check', { 'data-ibt-accept': a.id, onclick: () => openAccept(a) }),
+        scan ? null : el('div', { class: 'chips2' }, pbtn('primary', 'Accept', 'check', { 'data-ibt-accept': a.id, onclick: () => openAccept(a) }),
           pbtn('outline', 'Ask for more', 'reply', { 'data-ibt-more': a.id, onclick: () => openMore(a) }),
           pbtn('ghost', 'Decline', 'x', { 'data-ibt-decline': a.id, onclick: () => openDecline(a) }))].filter(Boolean)
         : state === 'declined' && a.why ? [note('Declined: ' + a.why)] : null,

package/workspace/public/pm/c3-ii-tabs.js

@@ -1,7 +1,7 @@
 /* pm/c3-ii-tabs.js — the six tabs of an initiative page (mockup v5, 34-initiatives.js iniOverview, iniBreakdown, iniDocs, iniTickets,
  * iniTimeline, iniHistory). registerInitiativeTab(id, mount(host, ctx)); ctx.row, ctx.history (newest first), ctx.tools, ctx.toolsByCat
  * and ctx.tool come from the page (c3-initiatives.js).
- *   Overview   Left: a Summary, then one card per tool of the current stage: the stage records (c3-ini-records.js: problem, RICE, launch
+ *   Overview   On top, the Agent strip (c3-driver.js: GET /api/driver/strip; not in demo mode). Left: a Summary, then one card per tool of the current stage: the stage records (c3-ini-records.js: problem, RICE, launch
  *              checklist, burndown, kill conditions, learnings) and the server's stage tools (ideas, PRD, breakdown, tickets, releases,
  *              measurements, …) drawn from what PMOS holds. ctx.tool (a tool pressed in the strip or picked in More tools) is drawn
  *              first and scrolled to. Right: Details (portfolio, board, workflow with Edit, stage, owner, anchor, horizon, lane), Progress,
@@ -19,6 +19,7 @@ import { wfOf, catOf, kindOf, tplName, toolLabel, toolIcon, loadItems, dropItems
 import { recordCards, recordToolsFor, RECORD_META } from './c3-ini-records.js';
 import { loadDocs, renderDocs } from './c3-ib-docs.js';
 import { timeline, tlInit, tlRange, tlStill } from './c3-ini-timeline.js';
+import { driverStrip } from './c3-driver.js';
 
 const errLine = (text) => el('div', { class: 'fold w', role: 'alert', 'data-ini': 'error' }, icon('alert', 'sm'), text);
 const toneOf = (s) => (s === 'late' ? 'bad' : s === 'at risk' ? 'warn' : 'ok');
@@ -138,7 +139,7 @@ tab('overview', async (ctx, isDead, host) => {
     rels.length ? card({ ic: 'out', title: 'Releases', sub: 'live in the Calendar' }, chgl(rels.map((x) => el('li', null, icon('out', 'sm'), el('span', null, (x.name || x.id) + ' · ' + day(String(x.release_at || x.deploy_at || '').slice(0, 10))), tag('Calendar'))))) : null,
   ];
   if (picked) requestAnimationFrame(() => { const n = host.querySelector('[data-ini-tool-card="' + CSS.escape(picked) + '"]'); if (n && !isDead()) { if (n.scrollIntoView) n.scrollIntoView({ block: 'nearest' }); n.classList.add('ini-flash'); setTimeout(() => n.classList.remove('ini-flash'), 1400); } });
-  return cols(left, right);
+  return [ctx.demo ? null : driverStrip(ctx, r), cols(left, right)];
 });
 
 /* ── Breakdown ── */

package/workspace/public/pm/c3-ini-ui.js

@@ -7,7 +7,7 @@
  * Rules the builders keep (the conformance gate, R28): every control is a <button> from primitives.js button() (btn() below adds the
  * console3 class it is drawn as, and `ini-b`, the reset that takes the primitive's own height and nowrap off); a colour, a width or a
  * position is a class or a `--in-…` custom property set with geo(), never an inline style; icons come from the console3 sprite
- * (c3ic) or, for the three it lacks (gear, grip, the Jira mark), from svgIcon(). Nothing here reads or writes the server.
+ * (c3ic) or, for the four it lacks (gear, grip, pause, the Jira mark), from svgIcon(). Nothing here reads or writes the server.
  *
  *   btn(attrs, ...kids)            a button; attrs.class is the console3 class (pill, chip2 lk, ib sm, tt, ...), attrs.onclick its press
  *   pbtn(variant, label, icon, attrs)  a primitive button drawn as the primitive (primary, outline, ghost), small
@@ -41,12 +41,14 @@ export function svgIcon(paths, cls) {
 }
 export const GEAR = ['M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z', 'M15 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0z'];
 export const GRIP = ['M9 5h.01M9 12h.01M9 19h.01M15 5h.01M15 12h.01M15 19h.01'];
+export const PAUSE = ['M8 5v14M16 5v14'];
 export const JIRA = ['M12 3l9 9-9 9-9-9z', 'M12 8l4 4-4 4-4-4z'];
 /** An icon by name: the sprite's, or one of the three drawn here. */
 export function icon(name, cls) {
   if (name === 'settings') return svgIcon(GEAR, cls);
   if (name === 'grip') return svgIcon(GRIP, cls);
   if (name === 'jira') return svgIcon(JIRA, cls);
+  if (name === 'pause') return svgIcon(PAUSE, cls);
   return c3ic(name, cls);
 }
 
@@ -170,7 +172,7 @@ export function nrow(o) {
     el('span', { class: 'ki' + (o.hot ? ' hot' : '') + (o.tone ? ' ini-k-' + o.tone : '') }, icon(o.ic || 'doc')),
     el('div', { class: 'nb' }, t, o.sub ? note(o.sub) : null, o.chips && o.chips.length ? el('div', { class: 'chips' }, ...o.chips.filter(Boolean)) : null, o.after || null, xp),
     o.right && o.right.filter(Boolean).length ? el('div', { class: 'acts' }, ...o.right.filter(Boolean)) : el('span'));
-  if (xp) attachExpand(li, xp, { key: o.key });
+  if (xp) attachExpand(li, xp, { key: o.key, initial: !!o.open, onToggle: o.onToggle });
   return li;
 }
 export function crumbs(parts, right) {

package/workspace/public/pm/c3-initiatives.js

@@ -48,6 +48,8 @@ import {
 import { TEMPLATES, BOARD_TEMPLATES, isBuildStage, templateBuilds, offered, wfOf, catOf, kindOf, tplName, TOOL_META, toolLabel, toolIcon, loadItems, dropItems, workTlRows, iniTlRow, rescheduleTask, lockedToast } from './c3-ini-work.js';
 import { timeline, tlInit, tlRange } from './c3-ini-timeline.js';
 import { RECORD_META, recordToolsFor } from './c3-ini-records.js';
+import { agentSetting, loadAgentMode, MODES as AGENT_MODES } from './c3-driver.js';
+import { scanSetting, takeSettingsFor } from './c3-scan.js';
 
 export { btn, geo };
 export { TEMPLATES, CATS };
@@ -159,6 +161,8 @@ export function mountInitiatives(pane, opts) {
   }
   const openBoard = (id, tab, filter) => go({ view: 'board', board: id, tab: tab || 'summary', filter: filter || {} });
   const refresh = () => { P.boards = null; P.ini = null; dropItems(); draw(); };
+  // The Briefing's Horizon scan card opens a board's Triage or settings (c3-scan.js goBoard). A page that is not built yet reads the address instead.
+  if (typeof window !== 'undefined') { if (window.__iniGo) window.removeEventListener('pmos:ini-go', window.__iniGo); window.__iniGo = (e) => { const d = (e && e.detail) || {}; if (d.board && root.isConnected) openBoard(d.board, d.tab || 'summary'); }; window.addEventListener('pmos:ini-go', window.__iniGo); }
   const redraw = () => draw();
 
   async function loadBoards() {
@@ -325,6 +329,7 @@ export function mountInitiatives(pane, opts) {
         segTabs(tabs, tab, (k) => openBoard(b.id, k), 'Board views', { 'data-ini': 'board-tabs' }),
         host));
     mountTab(host, tab === 'summary' ? mountSummary : null, (BOARD_TAB_LIST.find((t) => t[0] === tab) || [])[1], makeCtx(b, { tab, filter: P.loc.filter || {} }), token);
+    if (!opts.demo && takeSettingsFor(b.id)) openBoardSettings(b);   // "Scan settings" on the Briefing's Horizon scan card
   }
 
   /* Summary: initiatives at a glance, where they stand, what needs attention */
@@ -386,6 +391,20 @@ export function mountInitiatives(pane, opts) {
     const sh = openSheet({ title: 'Board settings · ' + b.name, icon: 'cols', body: host, wide: true });
     let usage = null;
     loadItems(makeCtx(b, {})).then((r) => { usage = r; render(); });
+    // The Agent setting (c3-driver.js): read once, and saved at once when a mode is pressed (POST /api/driver/mode). Not in demo mode.
+    const A = { mode: null, err: '', busy: false };
+    // The Horizon scan block (c3-scan.js): one node that reads and presses by itself, so a redraw of this form keeps it. Not in demo mode.
+    const scanNode = opts.demo ? null : scanSetting({ api: apiFor(b.ws), board: b.id, boardName: b.name });
+    if (!opts.demo) loadAgentMode(apiFor(b.ws), b.id).then((r) => { if (r.ok) A.mode = r.mode; else A.err = r.error; render(); });
+    async function pickAgent(mode) {
+      if (A.busy || mode === A.mode) return;
+      A.busy = true; A.err = ''; render();
+      const r = await apiFor(b.ws).post('/api/driver/mode', { board: b.id, mode });
+      A.busy = false;
+      if (!r || !r.ok) A.err = 'The agent setting was not saved: ' + ((r && r.error) || 'no answer') + '.';
+      else { A.mode = r.mode; toast(b.name + ': Agent ' + (AGENT_MODES.find((m) => m[0] === r.mode) || [0, r.mode])[1] + '.'); }
+      render('[data-drv-mode="' + A.mode + '"]');
+    }
     function render(focusSel) {
       const allowed = (k) => B.build || !templateBuilds(k);
       for (const k of [...B.offer]) if (!allowed(k)) B.offer.delete(k);
@@ -409,6 +428,8 @@ export function mountInitiatives(pane, opts) {
         lbl('DEFAULT FOR NEW INITIATIVES AND ACCEPTED ASKS'),
         tplSeg([...B.offer], B.def, (k) => { B.def = k; render('[data-ini-tpl="' + k + '"]'); }, 'Default workflow'),
         tplCase(B.def),
+        opts.demo ? null : agentSetting(A, { onPick: pickAgent }),
+        scanNode,
         el('div', { class: 'chips2' }, el('span', { class: 'dim ini-note' }, 'Initiatives that do not run their own workflow run the board\'s: ' + workflowLabel(b) + '.'), lk({ 'data-ini': 'edit-board-workflow', onclick: () => openBoardWorkflow(b) }, 'Edit the board\'s workflow')),
         B.err ? errLine(B.err) : null,
         el('div', { class: 'chips2' }, pbtn('primary', B.busy ? 'Saving' : 'Save board settings', null, { 'data-ini': 'settings-save', disabled: B.busy, onclick: save }), pbtn('ghost', 'Cancel', null, { onclick: () => sh.close() })));

package/workspace/public/pm/c3-scan.css

@@ -0,0 +1,25 @@
+/* pm/c3-scan.css — the few rules the Horizon scan needs beyond console3.css (c3-scan.js). The mockup's 40-scan.css under the `sc-` prefix: the
+ * Board settings block, the scan asks in Triage and the Briefing card. Held to the R28 rules: tokens only, no inline style, corners 0, 6px or 8px,
+ * font sizes from the --fs tokens. */
+.c3 .sc-set { display: grid; grid-template-columns: minmax(0, 1fr); gap: var(--sp-2); padding-top: var(--sp-3); border-top: 1px solid var(--border); }
+.c3 .sc-set > * { min-width: 0; overflow-wrap: anywhere; }
+.c3 .sc-set .seg { max-width: 100%; overflow-x: auto; }
+.c3 .sc-list { list-style: none; margin: 0; padding: 0; display: grid; gap: var(--sp-2); }
+.c3 .sc-it { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 4px 8px; align-items: start; padding: var(--sp-2) 0; border-top: 1px solid var(--border); }
+.c3 .sc-it > .sc-main { min-width: 0; display: grid; gap: 4px; }
+.c3 .sc-it .sc-name { display: flex; gap: 6px; align-items: center; flex-wrap: wrap; overflow-wrap: anywhere; }
+.c3 .sc-it .sc-why { font-size: var(--fs-2); }
+.c3 .sc-it .sc-acts { display: flex; gap: 6px; flex-wrap: wrap; }
+.c3 .sc-it .form { margin: 0; }
+.c3 .sc-add { display: flex; gap: 6px; flex-wrap: wrap; align-items: center; }
+.c3 .sc-add input[type="text"] { flex: 1 1 160px; min-width: 0; }
+.c3 .sc-meta { display: grid; gap: 4px; font-size: var(--fs-2); }
+.c3 .sc-foot { font-size: var(--fs-2); }
+.c3 .nrow .sc-src { display: flex; gap: 6px; flex-wrap: wrap; margin-top: 4px; align-items: center; }
+.c3 .nrow .sc-src .chip2 { max-width: 100%; }
+.c3 .sc-link { text-decoration: none; }
+.c3 .sc-card { display: grid; gap: var(--sp-2); }
+.c3 .sc-card ul.chgl li { flex-wrap: wrap; }
+
+.c3 .sc-card .sc-find { display: flex; flex-direction: column; min-width: 0; }
+.c3 .sc-card .sc-find .sc-sub { display: block; }