create-pmos 0.39.0 → 0.40.0

package/workspace/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.39.0",
+  "version": "0.40.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.39.0",
+  "version": "0.40.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",
@@ -10,12 +10,12 @@
   "scripts": {
     "start": "node server.js",
     "test": "node test.js && npm run test:modules",
-    "test:modules": "node focus.test.js && node handoff.test.js && node repo-scan.test.js && node profiles.test.js && node external-linking.test.js && node story-artifacts.test.js && node no-network.test.js && node typesafe-validation.test.js && node fixture-parity.test.mjs && node markdown.test.mjs && node start-policy.test.js && node state-isolation.test.js && node sync.test.js && node schedule-cli.test.js && node initiative-surface.test.js && node guide.test.js && node next-step-actions.test.js",
+    "test:modules": "node proactive.test.js && node focus.test.js && node handoff.test.js && node repo-scan.test.js && node profiles.test.js && node external-linking.test.js && node story-artifacts.test.js && node no-network.test.js && node typesafe-validation.test.js && node claims.test.js && node repo-watch.test.js && node fixture-parity.test.mjs && node markdown.test.mjs && node start-policy.test.js && node state-isolation.test.js && node sync.test.js && node schedule-cli.test.js && node initiative-surface.test.js && node guide.test.js && node next-step-actions.test.js",
     "test:ui": "node ui-test.js",
     "test:parity": "node design-parity.js --states",
     "test:all": "npm test && npm run test:panels && npm run test:ui && npm run test:parity && npm run test:offline",
     "doctor": "node doctor.js",
-    "test:panels": "node pm-shell-test.js && node pm-repos-test.js && node pm-initiatives-test.js && node pm-detail-test.js && node pm-tabs-test.js && node pm-term-test.js && node pm-modes-test.js && node pm-r1-test.js && node pm-r2-test.js && node pm-r3-test.js && node pm-r4-test.js && node pm-r5-test.js && node pm-r6-test.js && node pm-r7-test.js && node pm-r8-test.js && node pm-r9-test.js && node pm-r10-test.js && node pm-r11-test.js && node pm-r12-test.js && node pm-r13-test.js && node pm-r14-test.js && node pm-r15-test.js && node pm-r16-test.js && node pm-r17-test.js && node pm-r16-test.js && node pm-r18-test.js && node pm-r19-test.js && node pm-r20-test.js && node pm-r21-test.js",
+    "test:panels": "node pm-shell-test.js && node pm-repos-test.js && node pm-initiatives-test.js && node pm-detail-test.js && node pm-tabs-test.js && node pm-term-test.js && node pm-modes-test.js && node pm-r1-test.js && node pm-r2-test.js && node pm-r3-test.js && node pm-r4-test.js && node pm-r5-test.js && node pm-r6-test.js && node pm-r7-test.js && node pm-r8-test.js && node pm-r9-test.js && node pm-r10-test.js && node pm-r11-test.js && node pm-r12-test.js && node pm-r13-test.js && node pm-r14-test.js && node pm-r15-test.js && node pm-r16-test.js && node pm-r17-test.js && node pm-r16-test.js && node pm-r18-test.js && node pm-r19-test.js && node pm-r20-test.js && node pm-r21-test.js && node pm-r22-test.js && node pm-r23-test.js",
     "test:offline": "node offline-tarball.test.js"
   },
   "engines": {

package/workspace/public/pm/app.js

@@ -33,7 +33,7 @@ import { isMobile, mountMobile, applyMobile } from './mobile.js';
 const MODE_TITLE = {
   product: 'initiatives', scheduled: 'scheduled tasks', workflow: 'workflows', skills: 'skills',
   knowledge: 'knowledge', agent: 'agents', memory: 'memory', connect: 'connections', focus: 'focus',
-  portfolio: 'portfolio', guide: 'guide', validate: 'validate',
+  portfolio: 'portfolio', guide: 'guide', validate: 'validate', today: 'today',
 };
 const DETAIL_TITLE = {
   init: 'initiative', flow: 'workflow', sched: 'scheduled task', skill: 'skill', know: 'decision',

package/workspace/public/pm/data.js

@@ -1433,9 +1433,9 @@ export async function readDoc(path, ws, ref) {
   const url = '/api/doc?' + q({ ws: ws || state.wsId || (p ? p.ws : ''), path, ...(ref ? { ref } : {}) });
   const res = await fetch(url);
   if (!res.ok) {
-    // The server states why a branch read was refused; the plain 404 text is the generic one.
+    // The server states why a read was refused (binary, too large, not text, outside the workspace); show that reason.
     const why = res.status === 404 ? (await res.text().catch(() => '')) : '';
-    throw new Error(res.status === 404 ? (why && ref ? why : 'not a readable text document in this workspace') : 'HTTP ' + res.status);
+    throw new Error(res.status === 404 ? (why || 'not a readable text document in this workspace') : 'HTTP ' + res.status);
   }
   return res.text();
 }

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

@@ -581,12 +581,90 @@ async function vRun() {
   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
@@ -660,3 +738,146 @@ export function validateList() {
   }
   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

@@ -1046,6 +1046,7 @@ const LISTS = {
   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()),
@@ -1068,7 +1069,7 @@ const BODIES = {
  * 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', agent: 'navigation', connect: 'navigation', memory: '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' },
 };
@@ -1078,7 +1079,7 @@ export const MODE_PLACE = {
 export const ROW_OPENS = {
   product: 'detail', portfolio: 'detail', focus: 'detail',
   skills: 'tab', knowledge: 'tab', guide: 'tab', validate: 'tab',
-  scheduled: 'list', memory: 'list',
+  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;

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

@@ -177,8 +177,8 @@ export const UNBACKED_MODES = ['agent', 'connect'];   // mode ids (labels: agent
 /* overhaul-r4 — the PORTFOLIO mode joins "all repositories" in live mode only (the fixture drawer is the
  * prototype's, and the design comparison reads it). Its meta lives here, not in fixture.js, for the
  * same reason. */
-const META = Object.assign({}, MODE_META, { portfolio: ['▦', 'portfolio'], guide: ['?', 'guide'], validate: ['◉', 'validate'] });
-const LIVE_EXTRA = { 'all repositories': ['portfolio', 'guide', 'validate'] };
+const META = Object.assign({}, MODE_META, { portfolio: ['▦', 'portfolio'], guide: ['?', 'guide'], validate: ['◉', 'validate'], today: ['☀', 'today'] });
+const LIVE_EXTRA = { 'all repositories': ['today', 'portfolio', 'guide', 'validate'] };
 const DRAWER_GROUPS = SETTINGS_GROUPS.map((g) => ({
   label: g.label,
   items: (FIXTURE ? [] : LIVE_EXTRA[g.label] || []).concat(

package/workspace/public/pm/tab-doc.js

@@ -476,17 +476,70 @@ function sheetBody(tab) {
   ]);
 }
 
+/* ── file-viewer-any-text — a document that is not markdown, a page or a grid is SOURCE ──────────────────
+ * `previewKind` decides what counts as markdown or HTML, in the one place the server also trusts. Anything else
+ * the reader serves is shown as numbered monospace lines, never through the markdown renderer: JSON pretty-printed,
+ * JSONL as one record per line. These tabs are read-only, because /api/doc/save refuses everything but markdown and
+ * an edit or save button that cannot work is worse than none. If the classifier did not load, nothing here applies
+ * and the pane behaves as before. */
+function isSourcePath(p) {
+  if (isReference(p)) return false;      // an external reference has no file to show
+  const PK = typeof window !== 'undefined' ? window.PreviewKind : null;
+  if (!PK || typeof PK.previewKind !== 'function') return false;
+  const kind = PK.previewKind(String(p || ''));
+  if (kind === 'markdown' || kind === 'html') return false;
+  const e = extOfPath(p);
+  return !(e === 'csv' || e === 'tsv' || e === 'pdf' || e === 'xlsx');
+}
+const SRC_CAP = 5000;       // lines drawn; the cap is STATED when it applies
+const JSONL_EXT = new Set(['jsonl', 'ndjson', 'jsonlines', 'ldjson']);
+function sourceBody(tab, text) {
+  const ext = extOfPath(tab.path);
+  return scrollPane(tab, 'view', 'src\u0000' + text, RAW_ST, () => {
+    const head = (t, bad) => el('div', {
+      'data-r21': 'source-note',
+      style: 'padding:2px 0 8px;font-family:var(--mono);font-size:10.5px;color:' + (bad ? 'var(--destructive)' : 'var(--muted-foreground)'),
+    }, iv(t));
+    const row = (n, t, bad) => el('div', { style: 'display:flex;gap:10px;min-height:1.2em' },
+      el('span', { style: 'flex:none;min-width:4ch;text-align:right;color:var(--muted-foreground);user-select:none' }, iv(String(n))),
+      el('div', { style: 'flex:1;min-width:0;white-space:pre-wrap;overflow-wrap:anywhere' + (bad ? ';color:var(--destructive)' : '') }, iv(t)));
+    const lines = (arr) => arr.slice(0, SRC_CAP).map((t, i) => row(i + 1, t, false));
+    const capNote = (n) => (n > SRC_CAP ? [head('Showing the first ' + SRC_CAP + ' of ' + n + ' lines. The rest is not drawn. Use raw to read it all.', false)] : []);
+    const all = text.split('\n');
+    if (ext === 'json') {
+      let v; let err = null;
+      try { v = JSON.parse(text); } catch (e) { err = (e && e.message) || 'parse error'; }
+      if (err) return [head('JSON · read-only · NOT valid JSON: ' + err + ' · shown as written', true), ...lines(all), ...capNote(all.length)];
+      const pretty = JSON.stringify(v, null, 2).split('\n');
+      return [head('JSON · read-only · pretty-printed · ' + pretty.length + ' lines', false), ...lines(pretty), ...capNote(pretty.length)];
+    }
+    if (JSONL_EXT.has(ext)) {
+      const recs = []; let bad = 0; let n = 0;
+      all.forEach((t, i) => {
+        if (!t.trim()) return;
+        n++;
+        if (recs.length >= SRC_CAP) return;
+        try { recs.push(row(i + 1, JSON.stringify(JSON.parse(t), null, 2), false)); }
+        catch (e) { bad++; recs.push(row(i + 1, t + '\n⚠ line ' + (i + 1) + ' is not valid JSON: ' + ((e && e.message) || 'parse error'), true)); }
+      });
+      return [head('JSONL · read-only · ' + n + ' record' + (n === 1 ? '' : 's') + (bad ? ' · ' + bad + ' not valid JSON (marked)' : '') + (n > SRC_CAP ? ' · first ' + SRC_CAP + ' shown' : ''), bad > 0), ...recs];
+    }
+    return [head((ext || 'text') + ' · read-only · source', false), ...lines(all), ...capNote(all.length)];
+  });
+}
+
 export function mountDoc(host, tab) {
   if (!FIXTURE && extOfPath(tab.path) === 'pdf') { setChildren(host, [pdfBody(tab)]); return; }
   if (!FIXTURE && extOfPath(tab.path) === 'xlsx') { setChildren(host, [sheetBody(tab)]); return; }
   const raw = docText(tab);
   const text = state.docEdits[docKey(tab)] ?? raw;
-  const dm = (tab.readonly && (state.docModes[tab.id] === 'edit' || state.docModes[tab.id] === 'diff')) ? 'view' : (state.docModes[tab.id] ?? 'view');
+  const nonMd = !FIXTURE && isSourcePath(tab.path);   // file-viewer-any-text: read-only, shown as source
+  const dm = ((tab.readonly || nonMd) && (state.docModes[tab.id] === 'edit' || state.docModes[tab.id] === 'diff')) ? 'view' : (state.docModes[tab.id] ?? 'view');
   const dirty = text !== raw;
   const err = saveErr.get(docKey(tab));
 
   // A file opened from the initiative's git files is evidence of what changed: it is read, never edited or saved here.
-  const readonly = !!tab.readonly;
+  const readonly = !!tab.readonly || nonMd;
   const modeBtns = ['view', 'raw', 'edit', 'diff'].filter((mm) => !(readonly && (mm === 'edit' || mm === 'diff'))).map((mm) => el('button', {
     onClick: () => setState((s) => ({ docModes: { ...s.docModes, [tab.id]: mm } })),
     style: 'font-family:var(--mono);font-size:10.5px;padding:4px 10px;min-height:26px;background:'
@@ -517,7 +570,7 @@ export function mountDoc(host, tab) {
    * clean file dirty for nothing is how a tool teaches you to ignore its dirty flag. */
   const norm = typeof window !== 'undefined' ? window.MdNormalize : null;
   const canNormalize = !!(norm && typeof norm.normalize === 'function')
-    && !isHtmlDoc(tab.path) && !isReference(tab.path) && !unread.has(docKey(tab));
+    && !isHtmlDoc(tab.path) && !isReference(tab.path) && !unread.has(docKey(tab)) && !nonMd;
   const normBtn = canNormalize ? el('button', {
     onClick: () => {
       const r = norm.normalize(text);
@@ -566,7 +619,7 @@ export function mountDoc(host, tab) {
     if (body.defaultValue !== text) body.defaultValue = text;
     if (body.value !== text) body.value = text;
   } else if (!FIXTURE && (extOfPath(tab.path) === 'csv' || extOfPath(tab.path) === 'tsv')) body = gridBody(tab, text);
-  else body = rendersAsPage(tab) ? htmlFrame(tab, text) : viewBody(tab, text);
+  else body = rendersAsPage(tab) ? htmlFrame(tab, text) : (nonMd && !unread.has(docKey(tab)) ? sourceBody(tab, text) : viewBody(tab, text));
 
   setChildren(host, [modeBar, body]);
   return host;