create-pmos 0.187.0 → 0.189.0

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

@@ -1,184 +1,20 @@
-/* pm/c3-scan.js — the Horizon scan on console3 (initiative horizon-scan, PRD sections 1, 2, 4 and 6; mockup mockup-c3-driver, 40-scan.js).
- * The agent looks outside the initiatives on a schedule: the public web for a watch list the PM keeps, and the repository for what no initiative
- * covers. Each finding is an ask in Triage. A scan never creates an initiative and sends nothing. This file draws the three places the PM sees it:
+/* pm/c3-scan.js — the Horizon scan on console3: the Briefing card and the Triage rows (initiative horizon-scan-portfolio; mockup 42-hscan.js).
+ * One scan covers the whole portfolio. Its screens are in c3-scan-setup.js (the Portfolio section, the setup, the picker, the running sheet and the
+ * Board settings pointer) and c3-scan-next.js (a report's "Proposed next steps"); every call to the server is in c3-scan-api.js. This file draws
+ * the two places that stay here:
  *
- *   scanSetting(o)            the Horizon scan block of Board settings: how often (Daily, Weekly, Off), the last and next scan, the watch list with
- *                             Keep, Edit and Remove on each item, and Add. It reads and presses by itself: o = { api, board, boardName }.
- *   scanAskParts(a, o)        the parts of a Triage row for an ask the scan found: the reason, the "Found by agent" tag, the source chips, the match
- *                             chip and the three buttons. c3-ib-triage.js draws the row with them.
- *   scanSection(S)            the Briefing's Horizon scan card for the day's scan; hidden when no scan ran today.
- *
- * Reads: GET /api/scan/board, GET /api/scan/today. Presses: POST /api/scan/watch (keep, edit, remove, add) and POST /api/scan/cadence, through the
- * board's api (http.js: the nonce and the page Origin). The page sends no `by`: the server takes the PM from the call path. Plain words for every
- * empty and error state. A removed item has an Undo that brings it back as it was.
+ *   scanSection(S)            the Briefing's Horizon scan card: when the last scan ran, the boards, one row per report with the proposals waiting
+ *                             on it, Open and Scan now. Shown on a day a scan ran, and while proposals still wait.
+ *   scanAskParts(a, o)        the parts of a Triage row for an ask an earlier per-board scan found (c3-ib-triage.js draws the row with them).
  */
 import { el } from './dom.js';
-import { icon, pbtn, lk, chip, tag, st, note, lbl, put, btn, plural, sect, chgl, ago } from './c3-ini-ui.js';
-import { toast } from './c3-toast.js';
-import { pmGet } from './http.js';
+import { icon, pbtn, lk, chip, plural, sect, put, chgl, ago } from './c3-ini-ui.js';
 import { onBriefing } from './shell-ticker.js';
-
-/** Link c3-scan.css once, from this module's own folder (the way c3-driver.js links its stylesheet). */
-export function ensureScanCss() {
-  if (typeof document === 'undefined' || document.querySelector('link[data-c3-scan]')) return;
-  const l = document.createElement('link');
-  l.rel = 'stylesheet'; l.href = new URL('./c3-scan.css', import.meta.url).href; l.setAttribute('data-c3-scan', '');
-  document.head.appendChild(l);
-}
-
-/* ── words ── */
-export const FREQ = [['daily', 'Daily'], ['weekly', 'Weekly'], ['off', 'Off']];
-export const KINDS = ['product', 'domain', 'approach'];
-const KIND_ICON = { product: 'org', domain: 'report', approach: 'bolt' };
-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());
-const sameDay = (a, b) => a.toDateString() === b.toDateString();
-const errText = (r, what) => what + ': ' + ((r && r.error) || 'the workspace did not answer') + '.';
-const WHEN_SHORT = (d) => WD[d.getDay()] + ' ' + d.getDate() + ' ' + MON[d.getMonth()] + ', ' + clock(d);
-
-/** 'today, 09:00', 'yesterday, 09:00' or 'Mon 12 Oct, 09:00', for a time in the past. */
-export function pastLabel(iso, now = new Date()) {
-  const d = new Date(iso);
-  if (!Number.isFinite(d.getTime())) return '';
-  const y = new Date(now); y.setDate(y.getDate() - 1);
-  return sameDay(d, now) ? 'today, ' + clock(d) : sameDay(d, y) ? 'yesterday, ' + clock(d) : WHEN_SHORT(d);
-}
-/** 'at the next check', 'today, 09:00', 'tomorrow, 09:00' or 'Mon 19 Oct, 09:00', for the next scan. */
-export function nextLabel(iso, now = new Date()) {
-  const d = new Date(iso);
-  if (!Number.isFinite(d.getTime())) return '';
-  if (d.getTime() - now.getTime() < 90000) return 'within a minute';
-  const t = new Date(now); t.setDate(t.getDate() + 1);
-  return sameDay(d, now) ? 'today, ' + clock(d) : sameDay(d, t) ? 'tomorrow, ' + clock(d) : WHEN_SHORT(d);
-}
-export const scheduleLine = (c) => (c === 'daily' ? 'Every working day, 09:00' : c === 'weekly' ? 'Every Monday, 09:00' : 'Off. No scan runs on this board');
-
-/* ── the Board settings block ── */
-export async function loadScanBoard(api, board) {
-  const r = await api.get('/api/scan/board', { board });
-  return r && r.ok ? { ok: true, data: r } : { ok: false, error: errText(r, 'The horizon scan could not be read') };
-}
-
-/**
- * The Horizon scan block. Draws at once with "Reading the horizon scan" and fills itself from the server; every press posts, then reads again.
- * o: { api, board (id), boardName }.
- */
-export function scanSetting(o) {
-  ensureScanCss();
-  const wrap = el('div', { class: 'sc-set', 'data-scan-set': '' });
-  const S = { data: null, err: '', busy: false, edit: null, editValue: '', addName: '', addKind: 'product', addErr: '' };
-
-  async function load() {
-    const r = await loadScanBoard(o.api, o.board);
-    if (r.ok) { S.data = r.data; S.err = ''; } else { S.err = r.error; }
-    draw();
-  }
-  /** One press: post, say so on failure, read again. Returns the answer or null. */
-  async function press(route, body, what) {
-    if (S.busy) return null;
-    S.busy = true; draw();
-    const r = await o.api.post('/api/scan/' + route, { board: o.board, ...body });
-    S.busy = false;
-    if (!r || !r.ok) { toast({ text: errText(r, what + ' did not work'), tone: 'error', timeout: 6000 }); await load(); return null; }
-    await load();
-    return r;
-  }
-  const setCadence = async (c) => {
-    if (S.data && S.data.cadence === c) return;
-    const r = await press('cadence', { cadence: c }, 'The change');
-    if (r) toast(c === 'off' ? 'Horizon scan is off for ' + o.boardName : 'Horizon scan: ' + scheduleLine(c).toLowerCase());
-  };
-  const keep = (it) => press('watch', { op: 'keep', id: it.id }, 'Keep');
-  const remove = async (it) => {
-    const r = await press('watch', { op: 'remove', id: it.id }, 'Remove');
-    if (r) toast({ text: 'Removed ' + it.name, onAction: () => press('watch', { op: 'keep', id: it.id, restore: true }, 'Undo'), timeout: 7000 });
-  };
-  const save = async (it) => {
-    const v = S.editValue.trim();
-    if (!v) return;
-    S.edit = null;
-    if (v !== it.name) await press('watch', { op: 'edit', id: it.id, name: v }, 'Save');
-    else if (it.state === 'suggested') await keep(it);
-    else draw();
-  };
-  const add = async () => {
-    const v = S.addName.trim();
-    if (!v) { S.addErr = 'Write what to watch first.'; draw(); const i = wrap.querySelector('[data-scan-add-in]'); if (i) i.focus(); return; }
-    S.addErr = '';
-    const r = await press('watch', { op: 'add', name: v, kind: S.addKind }, 'Add');
-    if (r) { S.addName = ''; draw(); toast('Added ' + v + ' to the watch list'); }
-  };
-
-  const kindTag = (k) => el('span', { class: 'tag' + (k === 'product' ? ' acc' : '') }, k);
-  function item(it, first) {
-    if (S.edit === it.id) {
-      const input = el('input', { type: 'text', 'data-scan-edit-in': '', value: S.editValue, 'aria-label': 'Watch list item name', maxlength: '80', autocomplete: 'off',
-        oninput: (e) => { S.editValue = e.target.value; }, onkeydown: (e) => { if (e.key === 'Enter' && !e.isComposing) { e.preventDefault(); save(it); } else if (e.key === 'Escape') { S.edit = null; draw(); } } });
-      setTimeout(() => input.focus(), 20);
-      return el('li', { class: 'sc-it', 'data-scan-item': it.id, 'data-scan-state': 'edit' }, icon('eye', 'sm'), el('div', { class: 'sc-main' }, el('div', { class: 'form' }, input),
-        el('div', { class: 'sc-acts' }, pbtn('primary', 'Save', 'check', { 'data-scan-act': 'save', 'data-id': it.id, onclick: () => save(it) }), pbtn('ghost', 'Cancel', null, { 'data-scan-act': 'cancel', 'data-id': it.id, onclick: () => { S.edit = null; draw(); } }))));
-    }
-    const kept = it.state === 'kept';
-    const acts = [!kept ? pbtn('outline', 'Keep', 'check', { 'data-scan-act': 'keep', 'data-id': it.id, disabled: S.busy, onclick: () => keep(it) }) : null,
-      pbtn('ghost', 'Edit', 'edit', { 'data-scan-act': 'edit', 'data-id': it.id, disabled: S.busy, onclick: () => { S.edit = it.id; S.editValue = it.name; draw(); } }),
-      pbtn('ghost', 'Remove', 'x', { 'data-scan-act': 'remove', 'data-id': it.id, disabled: S.busy, onclick: () => remove(it) })];
-    return el('li', { class: 'sc-it', 'data-scan-item': it.id, 'data-scan-state': it.state }, icon(KIND_ICON[it.kind] || 'eye', 'sm'),
-      el('div', { class: 'sc-main' },
-        el('div', { class: 'sc-name' }, el('b', null, it.name), kindTag(it.kind), first && kept ? st('ok', 'check', 'Kept') : null),
-        first || !kept ? (it.why ? el('span', { class: 'dim sc-why' }, it.why) : null) : null,
-        el('div', { class: 'chips' }, chip(icon('init', 'sm'), it.ini ? 'from ' + it.ini : 'added by you')),
-        el('div', { class: 'sc-acts' }, ...acts)));
-  }
-
-  function draw() {
-    const d = S.data;
-    if (S.err && !d) { put(wrap, lbl('HORIZON SCAN'), el('div', { class: 'fold w', role: 'alert', 'data-scan': 'error' }, icon('alert', 'sm'), S.err, ' ', pbtn('outline', 'Try again', null, { onclick: load }))); return; }
-    if (!d) { put(wrap, lbl('HORIZON SCAN'), note('Reading the horizon scan')); return; }
-    if (!d.ledger) { put(wrap, lbl('HORIZON SCAN'), el('div', { class: 'fold', 'data-scan': 'no-ledger' }, icon('info', 'sm'), 'This repository has no state folder (pmos/state, state or .pmos), so the scan has nowhere to keep its watch list.')); return; }
-    const byOrder = d.items || [];
-    const first = !d.last;
-    const fromAgent = byOrder.some((i) => i.ini);
-    const pending = d.suggested.length;
-    const n = byOrder.length;
-    const off = d.cadence === 'off';
-    const now = new Date();
-    const lastLine = d.running ? 'A scan is running now.'
-      : d.last ? (d.last.ok === false ? 'Last scan did not finish' + (d.last.reason ? ': ' + d.last.reason : '') + ' · ' + pastLabel(d.last.at, now) + '.' : 'Last scan: ' + pastLabel(d.last.at, now) + '.')
-      : 'Last scan: none yet. The first scan runs after you decide on the watch list.';
-    const nextLine = off || !d.next ? '' : ' Next scan ' + nextLabel(d.next, now) + '.';
-    const noKept = !off && !d.kept.length ? 'No scan runs until you keep an item.' : '';
-    const freq = el('div', { class: 'seg ini-seg', role: 'group', 'aria-label': 'How often the agent scans' },
-      ...FREQ.map(([k, l]) => btn({ 'aria-pressed': String(d.cadence === k), 'data-scan-freq': k, disabled: S.busy, onclick: () => setCadence(k) }, l)));
-    const banner = first && fromAgent
-      ? el('div', { class: 'fold', role: 'status', 'data-scan': 'banner' }, icon('spark', 'sm'), 'The agent suggests ' + plural(n, 'thing') + ' to watch. Keep, edit or remove each before the first scan.' + (pending ? '' : ' You kept them all.'))
-      : null;
-    const empty = d.suggesting ? el('li', { class: 'dim', 'data-scan': 'suggesting' }, 'The agent is reading the initiatives of this board to suggest what to watch.')
-      : el('li', { class: 'dim', 'data-scan': 'empty' }, 'The watch list is empty. The web part of the scan has nothing to search for.' + (d.suggest_failed ? ' The suggest run did not finish. Add what to watch below.' : ''));
-    const kindSel = el('select', { 'data-scan-add-kind': '', 'aria-label': 'Kind', onchange: (e) => { S.addKind = e.target.value; } }, ...KINDS.map((k) => el('option', { value: k, selected: k === S.addKind }, k)));
-    const addIn = el('input', { type: 'text', 'data-scan-add-in': '', placeholder: 'Add something to watch', 'aria-label': 'Add to the watch list', maxlength: '80', autocomplete: 'off', value: S.addName,
-      oninput: (e) => { S.addName = e.target.value; }, onkeydown: (e) => { if (e.key === 'Enter' && !e.isComposing) { e.preventDefault(); add(); } } });
-    put(wrap,
-      lbl('HORIZON SCAN'),
-      el('div', { class: 'chips2' }, el('span', { class: 'dim mono ini-lbl' }, 'HOW OFTEN'), freq),
-      el('div', { class: 'sc-meta', 'data-scan': 'meta' },
-        el('span', { 'data-scan': 'schedule' }, el('b', null, d.schedule + '.'), off ? '' : ' The scan costs two short runs per board.'),
-        el('span', { class: 'dim', 'data-scan': 'last' }, lastLine, nextLine ? el('b', { 'data-scan': 'next' }, nextLine) : null, noKept ? ' ' + noKept : ''),
-        off ? null : el('span', { class: 'dim' }, 'The agent skips what it already found, so a ' + d.cadence + ' scan raises only new things.'),
-        d.switched_off ? el('span', { class: 'fold w', role: 'alert', 'data-scan': 'switched-off' }, icon('alert', 'sm'), 'Scans are switched off on this machine (PMOS_DRIVER or PMOS_SCAN is off). Nothing runs until that changes.') : null),
-      banner,
-      lbl('WATCH LIST (' + n + ')'),
-      el('ul', { class: 'sc-list', 'data-scan': 'list' }, ...(n ? byOrder.map((i) => item(i, first)) : [empty])),
-      el('div', { class: 'sc-add' }, addIn, kindSel, pbtn('outline', 'Add', 'plus', { 'data-scan-act': 'add', disabled: S.busy, onclick: add })),
-      S.addErr ? el('div', { class: 'fold w', role: 'alert', 'data-scan': 'add-error' }, icon('alert', 'sm'), S.addErr) : null,
-      el('div', { class: 'dim sc-foot' }, 'The web part sees only these topics, never private repository content. It reads public pages and searches. It sends nothing. A scan never creates an initiative: each finding is an ask in Triage.'));
-  }
-
-  draw();
-  load();
-  return wrap;
-}
+import { getPortfolio, getBoards, onScanChange } from './c3-scan-api.js';
+import { openScanDoc } from './c3-scan-next.js';
+import { openScanPicker, latestReports } from './c3-scan-setup.js';
+import { ensureScanCss, pastLabel, sameDayAs } from './c3-scan-words.js';
+export { ensureScanCss, pastLabel };
 
 /* ── Triage: an ask the scan found ── */
 export const isScanAsk = (a) => !!(a && a.source === 'scan' && a.found);
@@ -216,48 +52,40 @@ export function scanAskParts(a, o) {
 }
 
 /* ── Briefing: the Horizon scan card ── */
-/** Where the card's buttons go: a board's Triage, or a board's settings. */
-export function goBoard(board, tab, { settings = false } = {}) {
-  try { const u = new URL(location.href); u.searchParams.set('init', 'board:' + encodeURIComponent(board) + ':' + tab); history.replaceState(history.state, '', u); } catch { /* no history */ }
-  GO.settings = settings ? board : '';
-  return import('./c3-brief.js').then((m) => { if (m.hooks && m.hooks.go) m.hooks.go({ action: 'goinit' }); try { window.dispatchEvent(new CustomEvent('pmos:ini-go', { detail: { board, tab, settings } })); } catch { /* no events */ } });
-}
-/** c3-initiatives.js asks once whether to open a board's settings after it drew the board the card named. */
-export const GO = { settings: '' };
-export function takeSettingsFor(board) { if (GO.settings && GO.settings === board) { GO.settings = ''; return true; } return false; }
+const waitingOn = (d, id) => (d.reports.find((r) => r.id === id) || {}).open || 0;
 
-export function cardOf(t, now = new Date()) {
-  const boards = t.boards || [];
-  const counts = [chip(icon('clock', 'sm'), pastLabel(t.at, now)), chip(icon('org', 'sm'), plural(boards.length, 'board') + ' scanned: ' + boards.map((b) => b.name).join(', ')),
-    t.found ? el('span', { class: 'tag acc' }, plural(t.found, 'ask') + ' found') : el('span', { class: 'tag' }, 'Nothing new found'),
-    t.found ? el('span', { class: 'tag' }, t.matches === 1 ? '1 matches an initiative' : t.matches + ' match initiatives') : null,
-    t.found && t.fresh ? el('span', { class: 'tag warn' }, t.fresh + ' new') : null];
-  const rows = (t.findings || []).map((f) => el('li', { 'data-scan-find': f.id },
-    icon('spark', 'sm'),
-    el('span', { class: 'sc-find' }, el('b', null, f.title), el('span', { class: 'dim sc-sub' }, f.match ? 'Matches ' + f.match : 'No initiative yet', f.state && f.state !== 'open' ? [' ', el('span', { class: 'tag' }, f.state)] : null)),
-    lk({ 'data-scan-go': f.board, 'aria-label': 'Open ' + f.title + ' in Triage', onclick: () => goBoard(f.board, 'triage') }, 'Open in Triage')));
-  const first = boards[0] ? boards[0].id : '';
-  return sect({ ic: 'spark', title: 'Horizon scan', count: t.found, attrs: { 'data-c3pg': 'scan', 'aria-label': 'Horizon scan' } },
+/** The card for the latest scan, or null when no scan ran today and nothing waits. */
+export function cardOf(d, { ws, boardCount, showReports, now = new Date() } = {}) {
+  const mine = latestReports(d);
+  const ranToday = !!(d.last && d.last.at && sameDayAs(new Date(d.last.at), now));
+  if (!d.last || (!ranToday && !d.waiting) || !mine.length) return null;
+  const rows = mine.map((r) => el('li', { 'data-scan-report': r.id }, icon('search', 'sm'),
+    el('span', { class: 'sc-find' }, lk({ 'data-scan-act': 'opendoc', 'data-id': r.id, onclick: () => openScanDoc(ws, r, { panel: waitingOn(d, r.id) > 0 }) }, r.title), el('span', { class: 'dim sc-sm' }, plural(waitingOn(d, r.id), 'proposal') + ' waiting')),
+    lk({ 'data-scan-act': 'open-report', 'data-id': r.id, 'aria-label': 'Open ' + r.title, onclick: () => openScanDoc(ws, r, { panel: waitingOn(d, r.id) > 0 }) }, 'Open')));
+  const foot = 'Nothing was sent.' + (d.last.pages != null ? ' The agent read ' + plural(Number(d.last.pages) || 0, 'public page') + ', by topic only.' : '') + (Number(d.last.skipped) ? ' It skipped ' + plural(Number(d.last.skipped), 'finding') + ' you dismissed before.' : '');
+  return sect({ ic: 'search', title: 'Horizon scan', count: mine.length, attrs: { 'data-c3pg': 'scan', 'aria-label': 'Horizon scan' } },
     el('div', { class: 'sc-card' },
-      el('div', { class: 'chips' }, ...counts),
-      rows.length ? chgl(rows) : null,
-      (t.failed || []).length ? el('div', { class: 'fold w', role: 'alert', 'data-scan': 'failed' }, icon('alert', 'sm'), 'A scan did not finish: ' + t.failed.map((x) => x.reason).join('; ') + '.') : null,
-      el('div', { class: 'fold', 'data-scan': 'foot' }, icon('info', 'sm'), 'Nothing was sent. The agent read ' + plural(t.pages || 0, 'public page') + '. It skipped ' + plural(t.skipped || 0, 'finding') + ' from earlier scans.'),
-      el('div', { class: 'chips2' }, pbtn('outline', 'Open Triage', 'inbox', { 'data-scan-go': first, onclick: () => goBoard(first, 'triage') }), pbtn('ghost', 'Scan settings', 'settings', { 'data-scan-settings': first, onclick: () => goBoard(first, 'summary', { settings: true }) }))));
+      el('div', { class: 'chips2' }, chip(icon('clock', 'sm'), pastLabel(d.last.at, now)), chip(icon('cols', 'sm'), boardCount ? plural(boardCount, 'board') + ' scanned' : 'Whole portfolio scanned'), el('span', { class: 'tag acc' }, plural(mine.length, 'report') + (ranToday ? ' today' : ''))),
+      chgl(rows, { 'data-scan': 'reports' }),
+      el('div', { class: 'chips2' }, el('span', { class: 'tag' + (d.waiting ? ' warn' : ''), 'data-scan': 'waiting' }, plural(d.waiting, 'proposal') + ' waiting for you'),
+        pbtn('primary', 'Open', 'out', { 'data-scan-act': 'open', onclick: () => (showReports ? showReports() : openScanDoc(ws, mine[0], { panel: d.waiting > 0 })) }),
+        pbtn('ghost', 'Scan now', 'bolt', { 'data-scan-act': 'scan', disabled: !d.manual.ok && d.manual.why !== 'running', title: d.manual.left + ' of ' + d.manual.limit + ' manual scans left today', onclick: () => openScanPicker(ws, {}) })),
+      el('div', { class: 'fold', 'data-scan': 'foot' }, icon('info', 'sm'), foot)));
 }
 
-/** The Briefing's card. Returns a container that holds the card once a scan has run today, and nothing before. */
+/** The Briefing's card. Returns a container that holds the card once a scan has run today (or while proposals wait), and nothing before. */
 export function scanSection(S) {
   ensureScanCss();
   const host = el('div', { 'data-scan-host': '' });
   let sig = '';
-  const fill = () => pmGet('/api/scan/today').then((r) => {
-    const t = r && r.ok ? r.scan : null;
-    const g = JSON.stringify(t);
+  const fill = () => Promise.all([getPortfolio(S.ws), getBoards(S.ws)]).then(([d, boards]) => {
+    if (!d.ok) return;
+    const g = JSON.stringify([d.last, d.reports, d.waiting, boards.length]);
     if (g === sig) return; sig = g;
-    put(host, t ? cardOf(t) : null);
+    put(host, cardOf(d, { ws: S.ws, boardCount: boards.length, showReports: () => import('./c3-brief.js').then((m) => { if (m.hooks && m.hooks.go) m.hooks.go({ action: 'gorep' }); }) }));
   }, () => {});
   onBriefing(() => { fill(); });
+  const off = onScanChange(() => { if (!host.isConnected) { off(); return; } fill(); });
   fill();
   return host;
 }

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

@@ -11,6 +11,7 @@ export function toast(arg, undo) {
   if (!host || !host.isConnected) { host = el('div', { class: 'c3 c3e c3pop', 'data-shell': 'toast' }); document.body.appendChild(host); }
   const t = el('div', { class: 'toast' + (o.tone === 'error' ? ' err' : ''), role: 'status', 'aria-live': 'polite', 'data-c3-toast': '' }, el('span', null, o.text));
   if (o.onAction) t.append(el('button', { type: 'button', 'data-c3-toast-action': '', onclick: () => { clearTimeout(timer); t.remove(); o.onAction(); } }, o.actionLabel || 'Undo'));
+  if (host.nextSibling) document.body.appendChild(host);   // a sheet opened after the first toast sits above it (same z-index, later in the page): keep the toast last, so its Undo can be pressed
   host.replaceChildren(t);
   clearTimeout(timer); timer = setTimeout(() => t.remove(), o.timeout || 4200);
 }

package/workspace/public/pm/console3.css

@@ -1583,6 +1583,7 @@
 .c3 .raw{background:var(--muted);border-radius:8px;padding:var(--sp-2) var(--sp-3);font:var(--fs-1)/1.6 var(--mono);color:var(--muted-foreground);overflow-wrap:anywhere;white-space:pre-wrap}
 .c3 .c3t-card .draft{background:var(--muted);border-radius:10px;padding:var(--sp-3);font-size:var(--fs-3);white-space:pre-wrap;overflow-wrap:anywhere}
 .c3 .c3t-tray{display:flex;gap:var(--sp-2);flex-wrap:wrap;align-items:center}
+.c3 .c3t-grow{flex:1}
 .c3 .c3t-tray input,.c3 .c3t-panel input{flex:1;min-width:120px;border:1px solid var(--border);border-radius:99px;padding:6px 12px;background:var(--card);color:var(--foreground);font:inherit;font-size:var(--fs-2)}
 .c3 .c3t-tray input[readonly],.c3 .c3t-panel input[readonly]{opacity:.6;cursor:not-allowed}
 .c3 .c3t-card .pill.rec{background:var(--acc);color:var(--on-accent);border-color:var(--acc)}
@@ -1884,6 +1885,8 @@
 .c3 .wk-agent-ask input{flex:1;min-width:0;font:inherit;font-size:var(--fs-2);padding:4px 8px;border:1px solid var(--border);background:var(--background);color:var(--foreground);border-radius:6px}
 .c3 .wk-agent-ask[hidden]{display:none}
 .c3 .wk-agent-sheet{display:grid;gap:var(--sp-3)}
+.c3 .wk-agent-st{display:inline-flex;align-items:center;gap:4px;max-width:100%;min-width:0}
+.c3 .wk-agent-tx{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .c3 .wk-agent-will{font-size:var(--fs-2)}
 .c3 .wk-agent-sum{margin:0}
 .c3 .wk-agent-body{--tc:var(--acc)}

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

@@ -707,14 +707,15 @@ const minsAgo = (iso) => { const t = Date.parse(iso); if (!Number.isFinite(t)) r
 const whereOf = (item) => (item.origin === 'jira' ? 'Jira' : 'its source');
 const AG = {
   can: (t) => 'Agent can: ' + t, queued: 'Agent: queued', working: (ago) => 'Agent: working' + (ago ? ' · started ' + ago : ''), ready: 'Agent: draft ready',
-  sending: 'Agent: posting', sent: (w, at) => 'Posted to ' + w + (at ? ' ' + at : ''), failed: (why) => 'Agent stopped' + (why ? ': ' + why : ''),
+  sending: 'Agent: posting', sent: (w, at) => 'Posted to ' + w + (at ? ' ' + at : ''), failed: (asks) => (asks ? 'Agent: needs you' : 'Agent stopped'),
   sitSuggest: (w) => `The agent can draft this for you. You read it here first. Nothing goes to ${w} until you post it.`,
   sitQueued: 'Queued. The agent starts as soon as a session is free. You can close this page.',
   sitWorking: 'The agent is working on it. You can close this page: the item keeps its state.',
   sitReady: (at, w) => `Draft ready${at ? ' at ' + at : ''}. Nothing went to ${w}.`,
   sitSending: (k) => `Posting to ${k}. A session does exactly the step you approved and nothing else.`,
   sitSent: (at, w) => `You posted it to ${w}${at ? ' at ' + at : ''}.`,
-  sitFailed: (why) => `The agent stopped${why ? ': ' + why : '.'} Nothing was sent.`,
+  sitFailed: (why, asks) => (asks && why ? why.charAt(0).toUpperCase() + why.slice(1) + ' Nothing was sent.' : `The agent stopped${why ? ': ' + why : '.'} Nothing was sent.`),
+  openSession: 'Open the session',
   willDo: 'What the agent will do: ', change: 'Change what the agent does', askLabel: 'What the agent will do',
   draftIt: 'Let the agent draft this', tryAgain: 'Try again', post: (k) => 'Post it to ' + k, back: 'Send it back with a note', keepDraft: 'Keep it as a draft',
   noteLabel: 'Tell the agent what to change', openDraft: 'Open the draft', draftSheet: (k) => 'Draft for ' + k, stop: 'stop',
@@ -725,14 +726,14 @@ const AG = {
 
 function agentChip(item) {
   const a = item.agent; if (!a || item.mock_row) return null;
-  const st = (cls, ic, text, spin) => el('span', { class: cls, 'data-pm-agent-state': a.state, 'data-pm-suggest': item.id }, spin ? el('span', { class: 'c3spin' }, c3ic(ic, 'sm')) : c3ic(ic, 'sm'), text);
+  const st = (cls, ic, text, spin) => el('span', { class: cls + ' wk-agent-st', 'data-pm-agent-state': a.state, 'data-pm-suggest': item.id, title: text }, spin ? el('span', { class: 'c3spin' }, c3ic(ic, 'sm')) : c3ic(ic, 'sm'), el('span', { class: 'wk-agent-tx' }, text));
   if (a.state === 'suggest') return st('chip2', 'spark', AG.can(a.instruction || a.suggest || ''));
   if (a.state === 'queued') return st('st', 'clock', AG.queued);
   if (a.state === 'working') return st('st c3strip', 'spark', AG.working(minsAgo(a.started_at)), true);
   if (a.state === 'ready') return st('st ok', 'check', AG.ready);
   if (a.state === 'sending') return st('st c3strip', 'out', AG.sending, true);
   if (a.state === 'sent') return st('st ok', 'out', AG.sent(whereOf(item), a.sent && a.sent.at ? hhmm(a.sent.at) : ''));
-  if (a.state === 'failed') return st('tag warn', 'alert', AG.failed(a.error));
+  if (a.state === 'failed') return st('tag warn', 'alert', AG.failed(a.asks));
   return null;
 }
 
@@ -755,7 +756,8 @@ function agentCase(inst, item, L) {
   const strip = (spin, ic, text) => el('div', { class: 'c3ag', 'data-pm-agent-strip': item.id }, el('div', { class: 'fold a', role: 'status' }, spin ? el('span', { class: 'c3spin' }, c3ic(ic, 'sm')) : c3ic(ic, 'sm'), ' ' + text + ' ',
     c3btn('chip2 lk', { 'data-pm-agent-stop': item.id }, [c3ic('stop', 'sm'), AG.stop], () => agentPress(inst, '/api/my-work/stop', { item: item.id }, AG.stopped))));
   if (a.state === 'suggest' || a.state === 'failed') {
-    sit = a.state === 'failed' ? AG.sitFailed(a.error) : AG.sitSuggest(w);
+    sit = a.state === 'failed' ? AG.sitFailed(a.error, a.asks) : AG.sitSuggest(w);
+    if (a.state === 'failed' && a.session) extras.push(el('div', { class: 'chips2' }, c3btn('chip2 lk', { 'data-pm-agent-session': a.session }, [c3ic('term', 'sm'), AG.openSession], () => openAgentSession(a.session, item))));
     const brief = () => agentPress(inst, '/api/my-work/act', { action: 'brief', item: item.id, instruction: ask(), ws: inst.ctx.ws }, AG.handed(w));
     const retry = () => agentPress(inst, '/api/my-work/decide', { item: item.id, action: 'retry' }, AG.retried);
     opts = [o('agent', a.state === 'failed' ? AG.tryAgain : AG.draftIt, [fx('spark', 'Drafts it here in PMOS', 'ok'), fx('lock', 'Nothing goes to ' + w, 'ok')], a.state === 'failed' ? retry : brief), ...own];
@@ -805,6 +807,10 @@ function agentCase(inst, item, L) {
   return { model, run };
 }
 
+function openAgentSession(id, item) {
+  try { window.dispatchEvent(new CustomEvent('pmos:open-session', { detail: { id, name: 'Job · ' + (item.key || item.title || '') } })); } catch { /* no event */ }
+}
+
 function openDraft(item) {
   const a = item.agent || {}; const d = a.draft || {};
   const body = el('div', { class: 'wk-agent-sheet' },

package/workspace/public/pm/run-card.js

@@ -103,6 +103,11 @@ function pausedBox(ctx, card) {
 }
 // a session that has not started may be at the CLI's trust-the-folder question, where a typed Enter would answer it
 const NOSTART = 'Open the session to see what it waits for: typing into it now could answer a question you have not read.';
+function flipBtn(ui, ctx) {
+  const b = button({ variant: 'ghost', onClick: () => { ui.flip = true; ctx.redraw(); }, attrs: { class: 'ib', 'aria-label': 'Flip to the case file', title: 'Case file' } });
+  b.replaceChildren(ic('flip', 'sm'));
+  return b;
+}
 export function openBtn(ctx) {
   const b = button({ label: 'Open the session', onClick: () => ctx.openSession && ctx.openSession(ctx.id), attrs: { class: 'pill c3t-open', 'data-open-session': '', title: 'Open the session: its real terminal, on this page' } });
   b.prepend(ic('term', 'sm'));
@@ -210,10 +215,12 @@ function draw(host, ctx) {
   else {
     kids.push(el('h3', null, done && card.result.headline ? card.result.headline : (ctx.name || card.title)));
     const strip = stripNode(card, ctx.observed); if (strip) kids.push(strip);
+    // every box but the question and the permission carries Open the session; a card with none of them gets its own below
+    let opened = false;
     if (perms.length) perms.forEach((p) => kids.push(permissionBox(ctx, p)));
     else if (card.state === 'asking' && card.ask) kids.push(questionBox(ctx, card));
-    else if (card.state === 'paused') kids.push(pausedBox(ctx, card));
-    else if (ui.hidden !== card.state + ':' + ((card.failure && card.failure.code) || '')) { const f = failBox(ctx, card, ui); if (f) kids.push(f); }
+    else if (card.state === 'paused') { kids.push(pausedBox(ctx, card)); opened = true; }
+    else if (ui.hidden !== card.state + ':' + ((card.failure && card.failure.code) || '')) { const f = failBox(ctx, card, ui); if (f) { kids.push(f); opened = true; } }
     if (card.state === 'permission' && !perms.length) kids.push(dim('Waiting for your permission. Open the session to see it.'));
     if (done) {
       kids.push(...resultNodes(card.result, { ui, redraw: ctx.redraw, fileBody: ctx.fileBody }).filter(Boolean));
@@ -225,7 +232,9 @@ function draw(host, ctx) {
     if (ui.voice) kids.push(voiceNode(ctx, ui));
     else if (ui.tray) kids.push(trayNode(ctx, card, ui));
     if (!done && !ui.tray && !ui.voice && !perms.length && card.state !== 'asking' && !['working', 'queued'].includes(card.state)) { /* a failure box carries its own moves */ }
-    if (!done && !ctx.readonly) kids.push(el('div', { class: 'c3t-tray' }, el('span', { style: 'flex:1' }), el('button', { type: 'button', class: 'ib', 'aria-label': 'Flip to the case file', title: 'Case file', onclick: () => { ui.flip = true; ctx.redraw(); } }, ic('flip', 'sm'))));
+    // a starting or working run shows Open the session on its face: a read-only card (a job PMOS started) has no case file to flip to
+    if (!done && (!ctx.readonly || (!opened && ctx.openSession && !ctx.ended))) kids.push(el('div', { class: 'c3t-tray' }, !opened && ctx.openSession && !ctx.ended ? openBtn(ctx) : null, el('span', { class: 'c3t-grow' }),
+      ctx.readonly ? null : flipBtn(ui, ctx)));
   }
   const art = el('article', { class: 'c3t-card' + (['working', 'queued'].includes(card.state) ? ' busy' : '') + (ui.flash ? ' flash' : ''), 'data-run-card': card.state || '', 'data-run-id': ctx.id, 'aria-label': ctx.name || ctx.id }, ...kids);
   host.replaceChildren(el('div', { class: 'c3 c3e' }, art));

package/workspace/public/pm/sessions-panel.js

@@ -39,7 +39,7 @@ function outcomeOf(card, meta) {
 function cardHost(st, s, card, extra) {
   const host = el('div', { 'data-run-host': s.id });
   const ctx = { id: s.id, name: s.name, card, observed: st.data.demo && st.data.demo.observed ? st.data.demo.observed[s.id] : null, origin: s.origin === 'manual' ? (s.cardId ? 'on a card' : 'started by you') : s.origin, src: st.src,
-    refresh: st.refresh, openSession: st.openSession, glossary: st.data.demo && st.data.demo.glossary, fileBody: st.data.demo && st.data.demo.fileBody, accepted: false, ...(extra || {}) };
+    refresh: st.refresh, openSession: st.openSession, ended: s.endedAt != null, glossary: st.data.demo && st.data.demo.glossary, fileBody: st.data.demo && st.data.demo.fileBody, accepted: false, ...(extra || {}) };
   mountRunCard(host, ctx);
   return host;
 }
@@ -172,7 +172,7 @@ function draw(host, st) {
   const running = auto.filter((s) => s.endedAt == null).length;
   const sw = el('button', { type: 'button', class: 'c3t-sw', role: 'switch', 'aria-checked': String(st.showAuto), 'aria-label': 'Show automatic sessions', 'data-sessions-auto': '', onclick: () => { st.showAuto = !st.showAuto; st.redraw(); } }, el('i'));
   root.append(section('bolt', 'Automatic', auto.length, el('span', { class: 'chips2' }, dim(auto.length + ' today' + (running ? ', ' + running + ' running' : '')), sw), st.showAuto
-    ? (auto.length ? el('ul', { class: 'list', 'data-c3t': 'auto' }, auto.map((s) => { const c = cards[s.id]; return row(st, s, c, { sub: s.origin + ' · ' + (s.endedAt == null ? 'running' : 'ended') + ' · ' + ago(s.startedAt) + ' · ' + outcomeOf(c), body: c ? [cardHost(st, s, c, { readonly: true })] : [dim('No card yet.')] }); })) : none('None.'))
+    ? (auto.length ? el('ul', { class: 'list', 'data-c3t': 'auto' }, auto.map((s) => { const c = cards[s.id]; return row(st, s, c, { sub: s.origin + ' · ' + (s.endedAt == null ? 'running' : 'ended') + ' · ' + ago(s.startedAt) + ' · ' + outcomeOf(c), body: c ? [cardHost(st, s, c, { readonly: true })] : [dim('No card yet.'), s.endedAt == null ? el('div', { class: 'c3t-tray' }, openBtn({ id: s.id, openSession: st.openSession })) : null].filter(Boolean) }); })) : none('None.'))
     : el('div', { class: 'dim', style: 'font-size:var(--fs-2)' }, 'Hidden. They run, write their result onto a card and clean up. Switch on to see them.')));
   host.append(root);
 }

package/workspace/server.js

@@ -2551,7 +2551,7 @@ const driver = driverRunLib.create({
   warn: (what, e) => warnWriteFail(what, e),
 });
 const driverTick = () => { try { driver.tick({}); } catch (e) { warnWriteFail('driver tick', e); } };
-// horizon-scan: a scan is two headless runs per board (web, then repository), at most one scan at a time, on the board's cadence inside the working hours.
+// horizon-scan: a scan is two headless runs for the whole portfolio (web, then repository), at most one scan at a time, on the workspace cadence inside the working hours.
 // Everything it decides is in lib/scan.js and lib/scan-run.js; this only hands it the server's parts. The web run gets an empty scratch folder to run in.
 const scanRoutesCtx = () => ({ getWs, stateDirFor, workspaceList: () => [...workspaces.values()], runtimeDir: STATE, selfRoot: EMBEDDED_SELF ? SELF_ROOT : null });
 const scanner = scanRunLib.create({
@@ -2568,7 +2568,8 @@ const scanner = scanRunLib.create({
     return g.ok ? g.facts.initiatives.filter((i) => i.active && i.board === boardId).map((i) => ({ id: i.id, title: i.title || i.id })) : [];
   },
   knownInitiative: (w, id) => { try { const r = require('./lib/initiative-rows.js').peek(w.root); return r && r.ok ? r.rows.some((x) => x.id === id) : null; } catch { return null; } },
-  appendAsk: (w, boardId, finding, by) => require('./lib/routes-boards.js').appendScanAsk(scanRoutesCtx(), w, boardId, finding, by),
+  // The report documents go in the report-workspace store (lib/report-needs.js reportsDir), where the Documents list reads them.
+  reportsFor: (w) => { const f = require('./lib/scan.js').reportsFolder(w.root); const d = stateDirFor(w); return f || (d ? { abs: path.join(d, 'reports'), rel: path.relative(w.root, path.join(d, 'reports')).split(path.sep).join('/') } : null); },
   promptFor: (skillId) => { const h = homeWorkspace(); const t = taskById(skillId, h ? h.root : SELF_ROOT); return t && t.prompt ? t.prompt : null; },
   spawn: (spec) => spawnSession({ name: spec.name, agent: 'claude', ws: spec.ws, origin: spec.origin, initialInput: spec.initialInput, scratch: !!spec.scratch, extraEnv: spec.env, autoDelete: undefined, onDone: spec.onDone }),
   stop: (s) => { if (s && s.child) stopHeadless(s); },
@@ -3577,7 +3578,7 @@ function spawnSession({ name, agent, cwd, ws, origin, initialInput, profile, ini
   let workdir = cwd && insideRoot(root, path.resolve(root, cwd)) ? path.resolve(root, cwd) : root;
   // horizon-scan: the web run reads untrusted pages, so it runs in an empty scratch folder and never in the repository. Only a headless run may ask for it.
   if (scratch) {
-    if (!(initialInput && headlessLib.kindFor({ agent, origin: tag }) === 'scan-web')) return exitedSession({ id, ws: w ? w.id : wsId(SELF_ROOT), root, name: (name && String(name).trim()) || agent, agent, origin: tag, profile: null, profileRefusal: null, plan_item: null, token: sessionToken }, root, 'a scratch folder is only for a background web scan run');
+    if (!(initialInput && headlessLib.WEB_KINDS.includes(headlessLib.kindFor({ agent, origin: tag })))) return exitedSession({ id, ws: w ? w.id : wsId(SELF_ROOT), root, name: (name && String(name).trim()) || agent, agent, origin: tag, profile: null, profileRefusal: null, plan_item: null, token: sessionToken }, root, 'a scratch folder is only for a background web scan run');
     try { workdir = fs.mkdtempSync(path.join(os.tmpdir(), 'pmos-scan-web-')); } catch (e) { return exitedSession({ id, ws: w ? w.id : wsId(SELF_ROOT), root, name: (name && String(name).trim()) || agent, agent, origin: tag, profile: null, profileRefusal: null, plan_item: null, token: sessionToken }, root, 'could not make a scratch folder: ' + String((e && e.code) || e)); }
   }
   // A repository folder that was moved or deleted after it was registered: tmux would start the agent in its own folder
@@ -4135,10 +4136,27 @@ function stallQuietTasks(run, now) {
     if ((t.status !== 'working' && t.status !== 'sending') || !t.session_id) continue;
     const s = sessions.get(t.session_id);
     if (!s || s.state === 'exited') continue;
-    if (now - Math.max(s.lastOutputAt || 0, Date.parse(t.started_at || 0) || 0) >= TASK_IDLE_MS) run = dayRunLib.sessionStalled(run, t.session_id, TASK_STALLED_WHY, now).run;
+    if (now - Math.max(s.lastOutputAt || 0, Date.parse(t.started_at || 0) || 0) < TASK_IDLE_MS) continue;
+    const q = taskStallReason(s);
+    run = dayRunLib.sessionStalled(run, t.session_id, q.why, now, { asks: q.asks }).run;
   }
   return run;
 }
+// Why a quiet task session is quiet, from its transcript: a tool call that waits on the PM's OK, a turn that ended with
+// a question for the PM, or (no transcript answer) only that it printed nothing. The session stays open in every case.
+function taskStallReason(s) {
+  let hx = null; try { hx = transcriptHarness(s); } catch { hx = null; }
+  const shown = sessionState.presented('quiet', hx && hx.turn);
+  const said = String(((harnessOf(s) || {}).lastWords) || '').replace(/\s+/g, ' ').trim().slice(0, 140);
+  if (shown === 'blocked') {
+    const verb = hx && hx.openCall && hx.openCall.verb ? String(hx.openCall.verb).slice(0, 60) : '';
+    return { asks: 'ok', why: `the agent waits for your OK${verb ? ' to ' + verb : ''} in its session. Open the session and answer it: the job carries on from there.` };
+  }
+  if (shown === 'needs') return { asks: 'answer', why: `the agent stopped to ask you something in its session${said ? ': "' + said + '"' : ''}. Open the session and answer it: the job carries on from there.` };
+  // no transcript at all: the agent never began its turn, which is what a CLI held at its trust-the-folder or sign-in screen looks like
+  if (hx && hx.missing && hx.missing.all && s.agent === 'claude') return { asks: 'start', why: 'the session has printed nothing for five minutes and shows no sign that it began the job: Claude Code may be waiting for you to trust the folder or to sign in. Open the session to see it.' };
+  return { asks: null, why: TASK_STALLED_WHY };
+}
 // The skill's own body is the prompt, as fireSchedule hands it over; the line after it names this run's task and mode.
 function daySkillPrompt(run, skillId, wsId) {
   const w = getWs(wsId || run.ws);
@@ -9002,7 +9020,9 @@ async function handleRequest(req, res) {
     // workspace-data-freshness: the source table, the facts rebuild and Refresh now's skill sessions
     freshness, factsRefresh: (root) => factsAsync.refresh(root, { force: true }), startSkill: startSkillSession,
     // c3-initiative-boards: the PMOS checkout this server is embedded in, whose default board keeps its derived ladder
-    selfRoot: EMBEDDED_SELF ? SELF_ROOT : null })) return;
+    selfRoot: EMBEDDED_SELF ? SELF_ROOT : null,
+    // horizon-scan-portfolio: Scan now, Stop and an approved research proposal start and end runs in the scanner; scanClock fixes its clock in the suites
+    scanner, scanClock })) return;
   res.writeHead(404); res.end('not found');
 }