create-pmos 0.38.8 → 0.40.0

package/workspace/public/pm/mobile.js

@@ -62,7 +62,7 @@ const DEST_MODE = { board: 'product', scheduled: 'scheduled', agents: 'agent', m
 /* Two modes postdate the reducer's map (`connect` and `focus` arrived with the four-panel design).
  * They are named here rather than added to `DEST_FOR_MODE`, because MOBNAV-P7 pins that map to the
  * retired app.js's MODES exactly and a mode invented for a different surface would read as drift. */
-const EXTRA_DEST = { connect: 'more', focus: 'board' };
+const EXTRA_DEST = { connect: 'more', focus: 'board', portfolio: 'more', guide: 'more' };
 
 const destForMode = (m) => (NAV && NAV.destForMode(m)) || EXTRA_DEST[m] || null;
 

package/workspace/public/pm/modes-live.js

@@ -156,6 +156,23 @@ export function portfolioList() {
   return [el('div', { style: 'padding:2px 0 8px' }, kids)];
 }
 
+/* ── the user guide (status-clarity R6): pages that ship with the app, opened read-only in a doc tab ───────────── */
+async function openGuide(pg) {
+  const ini = await import('./panel-initiatives.js');
+  ini.openTab({ id: 'guide:' + pg.page, kind: 'doc', title: pg.title || pg.page, guide: true, readonly: true, path: pg.page, slug: null, repo: state.product || null, role: 'GUIDE' });
+}
+export function guideList() {
+  const r = read('guide', '/api/guide');
+  const st = status(r, 'the guide');
+  if (st) return [st];
+  const pages = (r.data && r.data.pages) || [];
+  if (!pages.length) return [el('div', { style: NOTE, 'data-r18': 'guide-empty' }, iv('The guide has no pages in this install.'))];
+  return [el('div', { style: 'padding:2px 0 8px', 'data-r18': 'guide-list' },
+    el('div', { style: NOTE }, iv('How this workspace works. These pages ship with the app and are updated with it.')),
+    pages.map((pg) => el('button', { onClick: () => openGuide(pg), style: ROW, hover: 'background:var(--accent)', 'data-r18': 'guide-page', 'data-page': pg.page },
+      el('span', { style: 'font-size:12.5px' }, iv(pg.title)))))];
+}
+
 /* ── D71 — set up the recommended schedules for the selected repository, on a press ───────────── */
 let seedNote = null;
 function seedRow(set, label, hint) {
@@ -508,3 +525,359 @@ export function knowledgeLive() {
   if (!trees.length && !notes.length) kids.push(el('div', { style: NOTE }, iv('No knowledge bundle in this repository — a successful read of nothing.')));
   return [el('div', { style: 'padding:2px 0 8px' }, kids)];
 }
+
+/* ── D79 — validate the selected repository with TypeSafe's Jev, on a press ───────────────────────────────────
+ * Four things on one page, in the order the PM meets them: the key (never shown again once saved), this
+ * repository's consent switch (off until the PM turns it on), the plan (what would be sent, before anything
+ * is) and the findings. A finding is advice with a confidence; nothing here edits a file, and a verdict is not
+ * an acceptance. The key is typed into a password field and sent once; no route returns it. */
+let vNote = null;          // { tone: 'ok'|'bad'|'mut', text }
+let vPlan = null;          // the last plan, for the repository it was made for
+let vBusy = false;
+const vSay = (tone, text) => { vNote = { tone, text }; setState({}); };
+const vWs = () => (dataMod && state.product ? dataMod.wsOf(state.product) : null);
+const TONE = { bad: 'var(--destructive)', ok: 'var(--foreground)', mut: 'var(--muted-foreground)' };
+
+async function vSaveKey(input) {
+  const key = input && input.value ? input.value : '';
+  if (!key.trim()) { vSay('bad', 'type or paste the key first'); return; }
+  const out = await fetch('/api/typesafe/key', { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ key }) }).then(readJson).catch((e) => ({ ok: false, error: e.message }));
+  if (input) input.value = '';
+  reload('typesafe'); reload('vrepo');
+  vSay(out && out.ok ? 'ok' : 'bad', out && out.ok ? 'the key is saved on this machine and is not shown again' : ((out && out.error) || 'the key was not saved'));
+}
+async function vClearKey() {
+  const out = await fetch('/api/typesafe/key', { method: 'DELETE' }).then(readJson).catch((e) => ({ ok: false, error: e.message }));
+  reload('typesafe'); reload('vrepo'); vPlan = null;
+  vSay(out && out.ok ? 'ok' : 'bad', out && out.ok ? 'the key is removed; nothing will be sent' : ((out && out.error) || 'the key was not removed'));
+}
+async function vConsent(on) {
+  const ws = vWs(); if (!ws) return vSay('bad', 'select a repository first');
+  const out = await post('/api/validate/repo', { ws, consent: on });
+  reload('vrepo'); vPlan = null;
+  vSay(out && out.ok ? 'ok' : 'bad', out && out.ok ? (on ? 'validation is on for this repository' : 'validation is off; nothing from this repository will be sent') : ((out && out.error) || 'not saved'));
+}
+async function vExclude(text) {
+  const ws = vWs(); if (!ws) return;
+  const exclude = String(text || '').split(/[\n,]/).map((x) => x.trim()).filter(Boolean);
+  const out = await post('/api/validate/repo', { ws, exclude });
+  reload('vrepo'); vPlan = null;
+  vSay(out && out.ok ? 'ok' : 'bad', out && out.ok ? 'excluded paths saved (' + exclude.length + ')' : ((out && out.error) || 'not saved'));
+}
+async function vMakePlan() {
+  const ws = vWs(); if (!ws) return vSay('bad', 'select a repository first');
+  vBusy = true; vSay('mut', 'working out what would be sent …');
+  const out = await post('/api/validate/plan', { ws });
+  vBusy = false;
+  if (!out || out.ok === false) { vPlan = null; return vSay('bad', (out && out.error) || 'no plan'); }
+  vPlan = { ws, plan: out.plan }; vSay('mut', 'review the plan, then confirm to send');
+}
+async function vRun() {
+  if (!vPlan) return;
+  vBusy = true; vSay('mut', 'validating … this sends text to ' + vPlan.plan.host);
+  const out = await post('/api/validate/run', { ws: vPlan.ws, expect_requests: vPlan.plan.requests });
+  vBusy = false; vPlan = null; reload('vfind');
+  if (!out || out.ok === false) return vSay('bad', (out && out.error) || 'the run failed');
+  vSay(out.aborted ? 'bad' : 'ok', 'asked ' + out.asked + ' of ' + out.requests + ' · ' + out.raised + ' raised · ' + out.local_findings + ' local · ' + out.withheld + ' withheld · ' + out.failed + ' failed' + (out.aborted ? ' — ' + out.aborted : ''));
+}
+
+
+/* ── claims-ledger — is this repository consistent? Local checks first; nothing here sends anything ───────────────
+ * The verdict says what was checked and against what, in plain words. A finding names the documents and puts the
+ * truth value beside the claim. "Consistent" means no recorded statement contradicts its source: prose is not read,
+ * and the page says so every time. */
+let cOpen = new Set();       // 'undecided' | 'fine' | 'unclassified' — which collapsed groups are open
+let cNote = null;
+const cSay = (text) => { cNote = text; setState({}); };
+async function cCheck() {
+  const ws = vWs(); if (!ws) return cSay('select a repository first');
+  cSay('checking …');
+  const out = await post('/api/claims/check', { ws });
+  reload('claims');
+  cSay(out && out.ok ? 'checked just now — ' + out.run.reads + ' file(s) read, ' + out.run.affected + ' re-verified, ' + out.run.appended + ' recorded' : ((out && out.error) || 'the check failed'));
+}
+async function cWatch(on) {
+  const ws = vWs(); if (!ws) return;
+  const out = await post('/api/claims/watch', { ws, watch: on });
+  reload('claims');
+  cSay(out && out.ok ? (on ? 'now checked automatically whenever its files change' : 'automatic checking is off') : ((out && out.error) || 'not saved'));
+}
+const cToggle = (k) => { if (cOpen.has(k)) cOpen.delete(k); else cOpen.add(k); setState({}); };
+const TYPE_CHIP = 'font-family:var(--mono);font-size:9.5px;padding:1px 6px;border:1px solid var(--border);color:var(--muted-foreground)';
+
+function claimsBlock(ws) {
+  const kids = [];
+  kids.push(el('div', { style: LABEL }, iv('consistency of this repository')));
+  if (!ws) return [...kids, el('div', { style: NOTE }, iv('Select a repository first.'))];
+  const r = read('claims', '/api/claims?ws=' + encodeURIComponent(ws));
+  const st = status(r, 'the consistency checks');
+  if (st) return [...kids, st];
+  const d = r.data; const c = d.counts;
+  const word = d.checking ? 'Checking…' : d.verdict === 'not-checked' ? 'Not checked yet' : d.verdict === 'consistent' ? 'Consistent' : c.problems + (c.problems === 1 ? ' problem' : ' problems');
+  const tone = d.verdict === 'problems' ? 'var(--destructive)' : 'var(--foreground)';
+  const why = d.verdict === 'not-checked'
+    ? 'Press “check now” to read this repository’s documents and config files and compare each with what it must agree with.'
+    : 'Checked ' + c.documents + ' documents and config files · ' + c.verified + ' statements verified · ' + c.stale + ' stale · ' + c.undecided + ' worth a look. '
+      + c.internal_only + ' are checked by their own structure only; ' + c.unclassified + ' are not classified and are never compared with other files.';
+  kids.push(el('div', { 'data-r22': 'verdict', 'data-verdict': d.checking ? 'checking' : d.verdict, style: 'padding:6px 14px;border-left:2px solid ' + tone + ';margin:2px 14px 6px' },
+    el('span', { 'data-r22': 'verdict-word', style: 'font-size:15px;font-weight:600;color:' + tone }, iv(word)),
+    el('span', { 'data-r22': 'verdict-why', style: 'display:block;font-size:11.5px;color:var(--muted-foreground);line-height:1.5;margin-top:2px' }, iv(why))));
+  kids.push(el('div', { 'data-r22': 'limits', style: NOTE }, iv('Checked by structure and the claims record. Prose is not read, so “Consistent” means no recorded statement contradicts its source — not that every sentence was checked. Nothing here is sent anywhere.')));
+  kids.push(el('div', { style: 'display:flex;gap:6px;align-items:center;flex-wrap:wrap;padding:2px 14px 6px' },
+    el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r22': 'check', disabled: d.checking ? 'true' : null, onClick: cCheck }, 'check now'),
+    el('button', { style: BTN + (d.watching ? ';color:var(--foreground);border-color:var(--foreground)' : ''), hover: 'color:var(--foreground)', 'data-r22': 'watch', onClick: () => cWatch(!d.watching),
+      title: 'When on, the workspace notices changes to files in this repository and re-checks the documents they affect. It records problems in the repository\'s claims.jsonl.' },
+      iv(d.watching ? 'automatic checking: ON — turn off' : 'automatic checking: OFF — turn on'))));
+  if (d.watching && d.last_run) kids.push(el('div', { 'data-r22': 'last', style: NOTE }, iv('Last automatic check ' + String(d.last_run.at).replace('T', ' ').slice(0, 16) + (d.last_run.ok === false ? ' — failed: ' + (d.last_run.error || 'error') : d.last_run.run ? ' — ' + d.last_run.run.affected + ' document(s) re-verified' : ''))));
+  if (cNote) kids.push(el('div', { 'data-r22': 'note', style: NOTE }, iv(cNote)));
+  if (d.ledger && d.verdict !== 'not-checked') kids.push(el('div', { style: NOTE }, iv('Record of problems: '), el('button', { style: 'text-decoration:underline;color:var(--foreground)', 'data-r22': 'ledger', onClick: () => openDocIn(ws, d.ledger, state.product) }, iv(d.ledger))));
+
+  const docs = d.docs || [];
+  const finding = (f, rel) => el('div', { 'data-r22': 'finding', 'data-status': f.status, style: 'padding:2px 14px 2px 26px;font-size:11.5px;line-height:1.5;color:' + (f.status === 'contradicted' ? 'var(--foreground)' : 'var(--muted-foreground)') }, iv(f.sentence));
+  const docRow = (x, showFindings) => el('div', { 'data-r22': 'doc', 'data-rel': x.rel, style: 'padding:4px 0;border-bottom:1px solid oklch(1 0 0 / 5%)' },
+    el('button', { style: 'display:flex;gap:8px;align-items:baseline;width:100%;padding:2px 14px;text-align:left', hover: 'background:var(--accent)', onClick: () => openDocIn(ws, x.rel, state.product) },
+      el('span', { style: 'font-family:var(--mono);font-size:11.5px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0' }, iv(x.rel)),
+      el('span', { style: TYPE_CHIP + ';margin-left:auto;flex:none' }, iv(x.classified ? x.type : 'not classified'))),
+    x.compared_with.length ? el('div', { 'data-r22': 'compared', style: 'padding:0 14px 0 26px;font-size:10.5px;color:var(--muted-foreground)' }, iv('compared with: ' + x.compared_with.join(', '))) : (x.classified ? el('div', { style: 'padding:0 14px 0 26px;font-size:10.5px;color:var(--muted-foreground)' }, iv(x.references.length ? 'no counterpart found to compare with' : 'checked on its own structure only')) : el('div', { style: 'padding:0 14px 0 26px;font-size:10.5px;color:var(--muted-foreground)' }, iv('nothing declares what this is, so it is checked on its own links and dates only'))),
+    showFindings ? x.findings.map((f) => finding(f, x.rel)) : null);
+  const group = (key, title, list, open, showFindings) => {
+    if (!list.length) return null;
+    return el('div', { 'data-r22': 'group', 'data-group': key },
+      el('button', { style: LABEL + ';display:block;width:100%;text-align:left', 'data-r22': 'group-toggle', onClick: open === 'always' ? null : () => cToggle(key) }, iv((open === 'always' || cOpen.has(key) ? '▾ ' : '▸ ') + title + ' · ' + list.length)),
+      open === 'always' || cOpen.has(key) ? list.slice(0, 150).map((x) => docRow(x, showFindings)) : null,
+      list.length > 150 && (open === 'always' || cOpen.has(key)) ? el('div', { style: NOTE }, iv('… and ' + (list.length - 150) + ' more')) : null);
+  };
+  const withStatus = (st) => docs.filter((x) => x.findings.some((f) => f.status === st));
+  const only = (st) => (x) => ({ ...x, findings: x.findings.filter((f) => f.status === st) });
+  kids.push(group('problems', 'problems — a statement is contradicted by its source', withStatus('contradicted').map(only('contradicted')), 'always', true));
+  kids.push(group('stale', 'stale — a source changed after the document did, or its date passed', withStatus('stale').map(only('stale')), 'always', true));
+  kids.push(group('undecided', 'worth a look — structure cannot decide', withStatus('undecided').map(only('undecided')), 'toggle', true));
+  kids.push(group('fine', 'checked and fine', docs.filter((x) => x.classified && !x.findings.length), 'toggle', false));
+  kids.push(group('unclassified', 'not classified — nothing declares what these are', docs.filter((x) => !x.classified), 'toggle', true));
+  return kids.filter(Boolean);
+}
+
+export function validateList() {
+  const kids = [];
+  const k = read('typesafe', '/api/typesafe');
+  const ws = vWs();
+  const rp = ws ? read('vrepo', '/api/validate/repo?ws=' + encodeURIComponent(ws)) : null;
+  const fd = ws ? read('vfind', '/api/validate/findings?ws=' + encodeURIComponent(ws)) : null;
+  kids.push(...claimsBlock(ws));
+  kids.push(el('div', { style: LABEL + ';margin-top:10px' }, iv('typesafe (jev) — optional, sends text only after you turn it on')));
+  kids.push(el('div', { style: NOTE, 'data-r19': 'intro' }, iv('Checks this repository\'s documents for reliability, coherence and freshness. Local checks run first and send nothing. Text that needs judgement goes to TypeSafe (Jev), only after you switch it on for this repository and confirm what will be sent. Findings are advice; nothing is edited.')));
+
+  // 1 · the key
+  kids.push(el('div', { style: LABEL }, iv('1 · TypeSafe key')));
+  const st = status(k, 'the key status');
+  if (st) kids.push(st);
+  else {
+    const present = k.data && k.data.key && k.data.key.present;
+    const src = k.data && k.data.key && k.data.key.source;
+    kids.push(el('div', { style: NOTE, 'data-r19': 'key-status' }, iv(present
+      ? 'A key is set (' + (src === 'environment' ? 'from the environment' : 'saved on this machine') + '). It is never shown again and is never given to a terminal.'
+      : 'No key is set. Without a key nothing is sent.')));
+    const input = el('input', { type: 'password', autocomplete: 'off', spellcheck: 'false', placeholder: present ? 'replace the key' : 'paste your TypeSafe key', 'data-r19': 'key-input',
+      style: 'flex:1;min-width:0;font-family:var(--mono);font-size:11px;padding:4px 8px;border:1px solid var(--border);background:var(--background);color:var(--foreground);min-height:28px' });
+    kids.push(el('div', { style: 'display:flex;gap:4px;padding:0 14px 6px' }, input,
+      el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r19': 'key-save', onClick: () => vSaveKey(input) }, 'save'),
+      present && src === 'settings' ? el('button', { style: BTN, hover: 'color:var(--destructive)', 'data-r19': 'key-remove', onClick: vClearKey }, 'remove') : null));
+  }
+
+  // 2 · this repository
+  kids.push(el('div', { style: LABEL }, iv('2 · this repository' + (state.product ? ' · ' + state.product : ''))));
+  if (!ws) kids.push(el('div', { style: NOTE }, iv('Select a repository first.')));
+  else {
+    const rs = status(rp, 'this repository\'s validation setting');
+    if (rs) kids.push(rs);
+    else {
+      const on = !!(rp.data && rp.data.consent);
+      kids.push(el('div', { style: 'display:flex;gap:8px;align-items:center;padding:4px 14px' },
+        el('span', { style: 'font-size:12px', 'data-r19': 'consent-state' }, iv(on ? 'validation is ON for this repository' : 'validation is OFF — nothing from this repository is sent')),
+        el('button', { style: BTN + ';margin-left:auto', hover: 'color:var(--foreground)', 'data-r19': 'consent-toggle', onClick: () => vConsent(!on) }, on ? 'turn off' : 'turn on')));
+      const ta = el('textarea', { rows: 2, placeholder: 'paths never sent, one per line (e.g. private/ or notes/*.md)', 'data-r19': 'exclude-input',
+        style: 'width:calc(100% - 28px);margin:4px 14px 0;font-family:var(--mono);font-size:10.5px;padding:4px 8px;border:1px solid var(--border);background:var(--background);color:var(--foreground)' }, (rp.data.exclude || []).join('\n'));
+      kids.push(ta, el('div', { style: 'padding:4px 14px 6px' }, el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r19': 'exclude-save', onClick: () => vExclude(ta.value) }, 'save excluded paths')));
+    }
+  }
+
+  // 3 · plan and run
+  kids.push(el('div', { style: LABEL }, iv('3 · validate')));
+  kids.push(el('div', { style: 'padding:4px 14px 6px;display:flex;gap:6px;align-items:center;flex-wrap:wrap' },
+    el('button', { style: BTN, hover: 'color:var(--foreground)', disabled: vBusy ? 'true' : null, 'data-r19': 'plan', onClick: vMakePlan }, 'show what would be sent'),
+    vPlan && vPlan.ws === ws ? el('button', { style: BTN + ';color:var(--foreground);border-color:var(--foreground)', hover: 'background:var(--accent)', disabled: vBusy ? 'true' : null, 'data-r19': 'run', onClick: vRun }, 'confirm and send ' + vPlan.plan.requests + ' request(s)') : null));
+  if (vPlan && vPlan.ws === ws) {
+    const p = vPlan.plan;
+    kids.push(el('div', { style: NOTE, 'data-r19': 'plan-text' },
+      iv(p.requests + ' request(s), about ' + p.characters.toLocaleString() + ' characters, to ' + p.host + '. ' + p.eligible + ' of ' + p.documents + ' documents eligible · ' + p.excluded + ' excluded · ' + p.local_findings + ' local finding(s) that send nothing.')));
+    if (p.withheld.length) kids.push(el('div', { style: NOTE + ';color:var(--destructive)', 'data-r19': 'withheld' }, iv('Withheld, matched a credential pattern, will NOT be sent: ' + p.withheld.map((w) => w.file + ' (' + w.rules.join(', ') + ')').join('; '))));
+    if (p.too_large.length) kids.push(el('div', { style: NOTE }, iv('Too large to send: ' + p.too_large.join(', '))));
+  }
+  if (vNote) kids.push(el('div', { 'data-r19': 'note', style: NOTE + ';color:' + (TONE[vNote.tone] || TONE.mut) }, iv(vNote.text)));
+
+  // 4 · findings
+  const fs0 = fd ? status(fd, 'the findings') : null;
+  const run = fd && fd.data ? fd.data.run : null;
+  kids.push(el('div', { style: LABEL }, iv('4 · findings' + (run ? ' · last run ' + String(run.at).replace('T', ' ').slice(0, 16) + ' · model ' + (run.model || 'none') : ''))));
+  if (fs0) kids.push(fs0);
+  else if (!run) kids.push(el('div', { style: NOTE, 'data-r19': 'no-run' }, iv('No validation has run for this repository.')));
+  else {
+    kids.push(el('div', { style: NOTE, 'data-r19': 'coverage' }, iv('Coverage: ' + run.asked + ' of ' + run.requests + ' request(s) answered · ' + run.withheld + ' withheld · ' + run.too_large + ' too large · ' + run.excluded + ' excluded · ' + run.failed + ' failed. A short list is not a clean bill: read this line first.')));
+    const list = fd.data.findings || [];
+    if (!list.length) kids.push(el('div', { style: NOTE }, iv('The run raised nothing.')));
+    for (const f of list) {
+      const unsure = f.label === 'for-your-judgement';
+      kids.push(el('button', { style: ROW, hover: 'background:var(--accent)', 'data-r19': 'finding', 'data-rule': f.rule, title: f.question || f.detail || '',
+        onClick: () => openDocIn(ws, f.file, state.product) },
+        el('span', { style: 'display:flex;gap:8px;align-items:baseline' },
+          el('span', { style: 'font-family:var(--mono);font-size:10px;color:' + (f.severity === 'high' ? 'var(--destructive)' : 'var(--muted-foreground)') }, iv(f.severity)),
+          el('span', { style: 'font-size:12px' }, iv(f.rule.replace(/-/g, ' '))),
+          el('span', { style: 'margin-left:auto;font-family:var(--mono);font-size:10px;color:var(--muted-foreground)' }, iv(f.kind === 'judged' ? (unsure ? 'for your judgement · ' : '') + 'confidence ' + (f.confidence == null ? '—' : f.confidence.toFixed(2)) : f.sent ? 'sent' : 'local'))),
+        el('span', { style: 'display:block;font-size:11px;color:var(--muted-foreground);overflow:hidden;text-overflow:ellipsis;white-space:nowrap' }, iv(f.files.join(' ↔ ') + (f.detail ? ' — ' + f.detail : '')))));
+    }
+  }
+  return [el('div', { style: 'padding:2px 0 8px', 'data-r19': 'validate' }, kids)];
+}
+
+/* ── Today (proactive-engine D1): what is waiting, computed from the ledgers, with feedback ─────────────────────── */
+let tNote = null;
+let tMissed = false;
+let tRetry = null;
+const tSay = (tone, text) => { tNote = { tone, text }; setState({}); };
+const OWNER_WORD = { pm: 'yours', agent: 'the agent\'s' };
+async function tFeedback(body, say) {
+  const out = await post('/api/proactive/feedback', body);
+  if (!out || out.ok === false) return tSay('bad', (out && out.error) || 'feedback was not saved');
+  tSay('ok', say);
+}
+async function tOpen(c) {
+  tFeedback({ candidate_id: c.id, event: 'opened' }, 'opened — recorded');
+  const o = c.open || {};
+  if (o.type === 'schedule') { setState({ mode: 'scheduled', col0: true }); return; }
+  if (c.repo && c.initiative_id) await land({ repo: c.repo, id: c.initiative_id });
+}
+async function tScan() {
+  const out = await post('/api/proactive/scan', {});
+  reload('today'); reload('brief');
+  tSay(!out || out.ok === false ? 'bad' : 'ok', !out || out.ok === false ? ((out && out.error) || 'the scan failed') : 'scanned — ' + out.found + ' waiting, ' + out.appended + ' new');
+}
+async function tSettings(patch) {
+  const out = await post('/api/proactive/settings', patch);
+  reload('today'); reload('brief');
+  tSay(!out || out.ok === false ? 'bad' : 'ok', !out || out.ok === false ? ((out && out.error) || 'not saved') : 'saved');
+}
+function tCard(c) {
+  const b = (label, attr, fn) => el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r22': attr, onClick: fn }, label);
+  return el('div', { 'data-r22': 'card', 'data-id': c.id, 'data-kind': c.kind, 'data-repo': c.repo || '', style: 'padding:8px 14px;border-bottom:1px solid var(--border)' },
+    el('span', { style: 'display:flex;gap:8px;align-items:baseline' },
+      el('span', { style: 'font-size:12.5px' }, iv(c.title)),
+      el('span', { style: 'margin-left:auto;font-family:var(--mono);font-size:10px;color:var(--muted-foreground)' }, iv(c.kind + ' · ' + (OWNER_WORD[c.owner] || c.owner)))),
+    el('span', { style: 'display:block;font-size:11px;color:var(--muted-foreground);margin:2px 0 4px' }, iv(c.why + (c.evidence ? ' — ' + c.evidence : ''))),
+    el('span', { style: 'display:flex;gap:4px;flex-wrap:wrap' },
+      c.open ? b('open', 'open', () => tOpen(c)) : null,
+      b('useful', 'useful', () => tFeedback({ candidate_id: c.id, verdict: 'useful' }, 'thanks — recorded as useful')),
+      b('not useful', 'not-useful', () => tFeedback({ candidate_id: c.id, verdict: 'not-useful' }, 'recorded as not useful')),
+      b('wrong priority', 'wrong-priority', () => tFeedback({ candidate_id: c.id, verdict: 'wrong-priority' }, 'recorded as wrong priority')),
+      b('dismiss 7 days', 'dismiss', async () => { await tFeedback({ candidate_id: c.id, event: 'dismissed' }, 'dismissed for 7 days'); reload('today'); setState({}); })));
+}
+
+/* the morning brief (proactive-engine D2): submitted by a scheduled skill in a session, only checked and stored by the server */
+let bNote = null;
+async function bSchedule() {
+  const data = await import('./data.js');
+  const ws = state.product ? data.wsOf(state.product) : null;
+  if (!ws) { bNote = 'select a repository first'; setState({}); return; }
+  const out = await post('/api/schedules/seed', { ws, set: 'brief' });
+  bNote = !out || out.ok === false ? ((out && out.error) || 'not scheduled')
+    : out.created.length ? 'scheduled: ' + out.created[0].name + ' (' + out.created[0].cadence + ' ' + out.created[0].time + ') — it runs only while the workspace server runs. Made after that time today, it also runs once within a minute.'
+      : 'nothing to add — ' + out.kept.map((k) => k.skill + ': ' + k.why).join('; ');
+  reload('brief'); setState({});
+}
+function bCard(x, ask) {
+  const b = (label, attr, fn) => el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r22': attr, onClick: fn }, label);
+  return el('div', { 'data-r22': ask ? 'ask-card' : 'brief-card', 'data-id': x.id, 'data-source': x.source, style: 'padding:8px 14px;border-bottom:1px solid var(--border)' },
+    el('span', { style: 'display:flex;gap:8px;align-items:baseline' },
+      el('span', { style: 'font-size:12.5px' }, iv(x.title)),
+      el('span', { style: 'margin-left:auto;font-family:var(--mono);font-size:10px;color:var(--muted-foreground)' }, iv(x.source + ' · ' + (OWNER_WORD[x.owner] || x.owner) + ' · ' + x.effort + ' · ' + x.confidence))),
+    el('span', { style: 'display:block;font-size:11px;color:var(--muted-foreground);margin:2px 0 4px' }, iv(x.why_now + (x.evidence ? ' — ' + x.evidence : ''))),
+    el('span', { style: 'display:flex;gap:4px;flex-wrap:wrap' },
+      b('useful', 'useful', () => tFeedback({ candidate_id: x.id, verdict: 'useful' }, 'thanks — recorded as useful')),
+      b('not useful', 'not-useful', () => tFeedback({ candidate_id: x.id, verdict: 'not-useful' }, 'recorded as not useful')),
+      b('wrong priority', 'wrong-priority', () => tFeedback({ candidate_id: x.id, verdict: 'wrong-priority' }, 'recorded as wrong priority'))));
+}
+function briefSection() {
+  const r = read('brief', '/api/proactive/brief');
+  const st = status(r, 'the brief');
+  if (st) return [st];
+  const d = r.data; const br = d.brief;
+  const kids = [el('div', { 'data-r22': 'greeting', style: 'padding:10px 14px 2px;font-size:15px;color:var(--foreground)' }, iv(d.greeting))];
+  if (!br) {
+    kids.push(el('div', { style: NOTE, 'data-r22': 'no-brief' }, iv('There is no brief yet. A scheduled skill in an agent session reads your calendar and other sources and submits it. This server only checks and stores it.' + (d.scheduled.length ? ' It is scheduled for ' + d.scheduled.map((x) => x.time).join(', ') + ' and runs only while the workspace server runs.' : ''))));
+    if (!d.scheduled.length) kids.push(el('div', { style: 'padding:0 14px 6px' }, el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r22': 'schedule-brief', onClick: bSchedule }, 'schedule the morning brief (06:45 daily)')));
+    if (bNote) kids.push(el('div', { style: NOTE, 'data-r22': 'brief-note' }, iv(bNote)));
+    return kids;
+  }
+  kids.push(el('div', { style: NOTE, 'data-r22': 'brief-date' }, iv('Brief for ' + br.date + ' · made ' + String(br.generated_at).replace('T', ' ').slice(0, 16) + ' UTC · typed scoring ' + (br.judgment.used ? 'used (the brief says so; the server cannot check it)' : 'not used'))));
+  if (d.stale) kids.push(el('div', { style: NOTE + ';color:var(--destructive)', 'data-r22': 'stale' }, iv('This brief is for ' + br.date + ', not today (' + d.today + '). It is out of date.')));
+  kids.push(el('div', { style: NOTE, 'data-r22': 'sources' }, iv('Sources: ' + Object.entries(br.sources).map(([k, v]) => k + ' ' + v).join(' · '))));
+  kids.push(el('div', { style: LABEL }, iv('calendar')));
+  if (!br.calendar.length) kids.push(el('div', { style: NOTE, 'data-r22': 'no-events' }, iv(br.sources.calendar === 'read' ? 'No events today.' : 'The calendar was not read, so this says nothing about your day.')));
+  for (const e of br.calendar) kids.push(el('div', { 'data-r22': 'event', style: 'padding:3px 14px;font-size:12px' }, iv(new Date(e.start).toTimeString().slice(0, 5) + '  ' + e.title + (e.with ? ' — ' + e.with : ''))));
+  kids.push(el('div', { style: LABEL }, iv('priorities')));
+  if (!br.priorities.length) kids.push(el('div', { style: NOTE, 'data-r22': 'no-priorities' }, iv('No priorities in this brief.')));
+  for (const x of br.priorities) kids.push(bCard(x, false));
+  if (br.worth_asking.length) {
+    kids.push(el('div', { style: LABEL }, iv('worth asking · the brief is unsure')));
+    for (const x of br.worth_asking) kids.push(bCard(x, true));
+  }
+  return kids;
+}
+export function todayList() {
+  const r = read('today', '/api/proactive/today');
+  const kids = [el('div', { style: NOTE, 'data-r22': 'intro' }, iv('What is waiting for you, worked out from the ledgers and git on this computer. It runs only while the workspace server runs, reads no mail or calendar, and changes nothing: your feedback only changes how this list is ordered later.'))];
+  kids.push(...briefSection());
+  kids.push(el('div', { style: LABEL }, iv('waiting on records')));
+  kids.push(el('div', { style: 'display:flex;gap:4px;flex-wrap:wrap;padding:4px 14px' },
+    el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r22': 'scan', onClick: tScan }, 'scan now'),
+    el('button', { style: BTN, hover: 'color:var(--foreground)', title: 'read the brief and the list again', 'data-r22': 'refresh', onClick: () => { reload('today'); reload('brief'); setState({}); } }, '↻ refresh'),
+    el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r22': 'missed', onClick: () => { tMissed = !tMissed; setState({}); } }, 'something was missed')));
+  if (tMissed) {
+    const ta = el('input', { type: 'text', placeholder: 'what should it have shown you?', 'data-r22': 'missed-input', style: 'flex:1;min-width:0;font-size:11.5px;padding:4px 8px;border:1px solid var(--border);background:var(--background);color:var(--foreground);min-height:28px' });
+    kids.push(el('div', { style: 'display:flex;gap:4px;padding:2px 14px 6px' }, ta,
+      el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r22': 'missed-save', onClick: async () => { await tFeedback({ verdict: 'missed', note: ta.value }, 'recorded as missed'); if (tNote && tNote.tone === 'ok') tMissed = false; setState({}); } }, 'save')));
+  }
+  if (tNote) kids.push(el('div', { 'data-r22': 'note', style: NOTE + ';color:' + (tNote.tone === 'bad' ? 'var(--destructive)' : tNote.tone === 'ok' ? 'var(--foreground)' : 'var(--muted-foreground)') }, iv(tNote.text)));
+  const st = status(r, 'Today');
+  if (st) return [...kids, st];
+  const d = r.data;
+  const s = d.settings;
+  if (d.off) kids.push(el('div', { style: NOTE, 'data-r22': 'off' }, iv('The engine is switched off. Nothing is scanned automatically; "scan now" still works.')));
+  if (d.quiet) kids.push(el('div', { style: NOTE, 'data-r22': 'quiet' }, iv('Quiet hours (' + s.quiet.start + '–' + s.quiet.end + '): no automatic scans now.')));
+  // a repository still being read is asked again in a few seconds, so the list fills in without a press
+  if ((d.unreadable || []).length && !tRetry && typeof setTimeout === 'function') tRetry = setTimeout(() => { tRetry = null; reload('today'); setState({}); }, 4000);
+  for (const u of d.unreadable || []) kids.push(el('div', { style: NOTE + ';color:var(--destructive)', 'data-r22': 'unreadable' }, iv('Not read — ' + (u.name || u.repo || 'a repository') + ': ' + (u.error || 'unknown reason') + '. Nothing is shown for it, which is not the same as nothing waiting.')));
+  if (d.empty) kids.push(el('div', { style: NOTE, 'data-r22': 'empty' }, iv('Nothing is waiting on any repository that was read.')));
+  for (const c of d.candidates || []) kids.push(tCard(c));
+  if (d.dismissed) kids.push(el('div', { style: NOTE, 'data-r22': 'dismissed' }, iv(d.dismissed + ' dismissed item(s) hidden for 7 days.')));
+  // settings
+  kids.push(el('div', { style: LABEL }, iv('settings')));
+  const chk = (label, on, attr, patch) => el('label', { style: 'display:flex;gap:8px;align-items:center;padding:2px 14px;font-size:12px' },
+    el('input', { type: 'checkbox', checked: on ? 'checked' : null, 'data-r22': attr, onChange: () => tSettings(patch(!on)) }), iv(label));
+  kids.push(chk('engine on', s.enabled, 'set-enabled', (v) => ({ enabled: v })));
+  for (const t of Object.keys(s.triggers)) kids.push(chk('watch: ' + t, s.triggers[t], 'set-' + t, (v) => ({ triggers: { [t]: v } })));
+  kids.push(el('div', { style: LABEL }, iv('morning brief')));
+  for (const k of Object.keys(s.briefSources || {})) kids.push(chk('read ' + k + (k === 'mail' ? ' (titles and senders only)' : ''), s.briefSources[k], 'set-src-' + k, (v) => ({ briefSources: { [k]: v } })));
+  kids.push(chk('typed scoring (sends titles and metadata to the Typesafe service)', s.briefScoring, 'set-scoring', (v) => ({ briefScoring: v })));
+  const nm = el('input', { type: 'text', maxlength: '40', placeholder: 'your name for the greeting', value: s.name || '', 'data-r22': 'set-name', style: 'width:180px;font-size:11.5px;padding:2px 6px;border:1px solid var(--border);background:var(--background);color:var(--foreground)' });
+  kids.push(el('div', { style: 'display:flex;gap:6px;align-items:center;padding:4px 14px;font-size:12px' }, nm, el('button', { style: BTN, 'data-r22': 'set-name-save', onClick: () => tSettings({ name: nm.value }) }, 'save')));
+  kids.push(el('div', { style: LABEL }, iv('learning')));
+  kids.push(chk('pause learning (nothing learns yet)', s.pauseLearning, 'set-pause', (v) => ({ pauseLearning: v })));
+  const days = el('input', { type: 'number', min: '1', max: '90', value: String(s.stalledDays), 'data-r22': 'set-stalled-days', style: 'width:60px;font-size:11.5px;padding:2px 6px;border:1px solid var(--border);background:var(--background);color:var(--foreground)' });
+  const qs = el('input', { type: 'text', placeholder: '22:00', value: s.quiet ? s.quiet.start : '', 'data-r22': 'set-quiet-start', style: 'width:56px;font-size:11.5px;padding:2px 6px;border:1px solid var(--border);background:var(--background);color:var(--foreground)' });
+  const qe = el('input', { type: 'text', placeholder: '07:00', value: s.quiet ? s.quiet.end : '', 'data-r22': 'set-quiet-end', style: 'width:56px;font-size:11.5px;padding:2px 6px;border:1px solid var(--border);background:var(--background);color:var(--foreground)' });
+  kids.push(el('div', { style: 'display:flex;gap:6px;align-items:center;flex-wrap:wrap;padding:4px 14px;font-size:12px' }, iv('stalled after'), days, iv('days'),
+    el('button', { style: BTN, 'data-r22': 'set-stalled-save', onClick: () => tSettings({ stalledDays: Number(days.value) }) }, 'save')));
+  kids.push(el('div', { style: 'display:flex;gap:6px;align-items:center;flex-wrap:wrap;padding:4px 14px 8px;font-size:12px' }, iv('quiet hours'), qs, iv('to'), qe,
+    el('button', { style: BTN, 'data-r22': 'set-quiet-save', onClick: () => tSettings({ quiet: qs.value.trim() || qe.value.trim() ? { start: qs.value.trim(), end: qe.value.trim() } : null }) }, 'save')));
+  return [el('div', { style: 'padding:2px 0 8px', 'data-r22': 'today' }, kids)];
+}

package/workspace/public/pm/modes.js

@@ -1044,6 +1044,9 @@ const LISTS = {
   skills: () => (FIXTURE ? skillsList() : LIVE.skillsLive()),
   knowledge: () => (FIXTURE ? knowledgeList() : LIVE.knowledgeLive()),
   portfolio: () => (FIXTURE ? [] : LIVE.portfolioList()),
+  guide: () => (FIXTURE ? [] : LIVE.guideList()),
+  validate: () => (FIXTURE ? [] : LIVE.validateList()),
+  today: () => (FIXTURE ? [] : LIVE.todayList()),
   agent: agentsList,
   connect: connectList,
   memory: () => (FIXTURE ? memoryList() : LIVE.memoryLive()),
@@ -1060,6 +1063,29 @@ const BODIES = {
   intg: intgBody,
 };
 
+/* WHERE EACH THING OPENS (column-layout). A list or a directory (memory, skills, knowledge, scheduled tasks, focus,
+ * portfolio, the guide, the initiatives themselves) is drawn in the navigation column, under the repository list. A
+ * detail (an initiative, a skill, a schedule, a memory item) is drawn in the detail column. This table is the rule;
+ * a mode or a detail kind that is not in it is a failing test, so a new one has to say which column it opens in. */
+export const MODE_PLACE = {
+  lists: { product: 'navigation', focus: 'navigation', scheduled: 'navigation', workflow: 'navigation', skills: 'navigation',
+    knowledge: 'navigation', portfolio: 'navigation', guide: 'navigation', validate: 'navigation', today: 'navigation', agent: 'navigation', connect: 'navigation', memory: 'navigation' },
+  details: { init: 'detail', flow: 'detail', sched: 'detail', skill: 'detail', know: 'detail', agent: 'detail', mem: 'detail',
+    prof: 'detail', intg: 'detail', addprod: 'detail', bind: 'detail', new: 'detail', none: 'detail' },
+};
+/* WHAT A ROW IN EACH LIST OPENS, as the live app does it today. An initiative (from the board, the portfolio or the focus
+ * queue) opens in the detail column. A file-like row (a skill, a knowledge note, a guide page) opens in a TAB, like any
+ * other document, so it can sit beside a terminal. A schedule and a memory entry are acted on inside the list itself. */
+export const ROW_OPENS = {
+  product: 'detail', portfolio: 'detail', focus: 'detail',
+  skills: 'tab', knowledge: 'tab', guide: 'tab', validate: 'tab',
+  scheduled: 'list', memory: 'list', today: 'list',
+};
+/** The column a list mode opens in: always `navigation`. `null` for a mode this table does not know. */
+export const placeOfMode = (mode) => MODE_PLACE.lists[mode] || null;
+/** The column a detail kind opens in: always `detail`. `null` for a kind this table does not know. */
+export const placeOfDetail = (kind) => MODE_PLACE.details[kind] || null;
+
 /** Is `mode` one this module renders? `product` belongs to panel-initiatives.js. */
 export function hasMode(mode) {
   return Object.prototype.hasOwnProperty.call(LISTS, mode);