create-pmos 0.46.0 → 0.47.0

package/workspace/lib/proactive-cli.js

@@ -16,13 +16,14 @@
  *   pmos proactive prepare plan --initiative ID [--repo PATH]
  *   pmos proactive prepare queue --initiative ID --item ITEM --sha HASH [--repo PATH]
  *   pmos proactive prepare status | cancel ID | run
+ *   pmos proactive learn [status] | run | lessons | approve ID | reject ID | retire ID | restore TRIGGER | reset
  */
 const fs = require('fs');
 const path = require('path');
 const { execFileSync } = require('child_process');
 const { parseArgs } = require('./schedule-cli');
 
-const COMMANDS = { proactive: ['today', 'scan', 'settings', 'feedback', 'brief', 'prepare'] };
+const COMMANDS = { proactive: ['today', 'scan', 'settings', 'feedback', 'brief', 'prepare', 'learn'] };
 const BRIEF_SOURCES = ['calendar', 'wispr', 'mail', 'jira', 'confluence'];
 const onOff = (v, what) => (v === 'on' || v === 'true' ? true : v === 'off' || v === 'false' ? false : { err: `${what} takes on or off` });
 
@@ -141,6 +142,53 @@ async function run(argv, { call, say, cwd = process.cwd() }) {
     for (const e of r.entries) say(`${e.id}  ${e.status}  ${e.label}${e.reason ? ' — ' + e.reason : ''}`);
     return 0;
   }
+  if (verb === 'learn') {
+    const sub = pos[0] || 'status';
+    const rate = (x, what) => (x.rate === null ? `${what}: not enough evidence (${x.n} of ${x.min} needed)` : `${what}: ${Math.round(x.rate * 100)}% (${x.n} counted)`);
+    const decide = async (decision, past) => {
+      if (!pos[1]) return fail(`usage: pmos proactive learn ${decision} ID`);
+      const r = await call('POST', '/api/proactive/learn/lesson', { id: pos[1], decision, confirm: true });
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}. Nothing changed.`);
+      say(`${past} ${r.id}`); return 0;
+    };
+    if (sub === 'approve') return decide('approve', 'approved');
+    if (sub === 'reject') return decide('reject', 'rejected');
+    if (sub === 'retire') return decide('retire', 'retired');
+    if (sub === 'restore') {
+      if (!pos[1]) return fail('usage: pmos proactive learn restore TRIGGER');
+      const r = await call('POST', '/api/proactive/learn/restore', { kind: pos[1], confirm: true });
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}. Nothing changed.`);
+      say(`restored ${r.kind} — it comes back on Today and stays until 10 new ratings of it have arrived`); return 0;
+    }
+    if (sub === 'reset') {
+      const r = await call('POST', '/api/proactive/learn/reset', { confirm: true });
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}. Nothing changed.`);
+      say('reset — earlier feedback is ignored from now on. It is not deleted.'); return 0;
+    }
+    if (sub === 'run') {
+      const r = await call('POST', '/api/proactive/learn/run', {});
+      if (!r || r.ok === false) return fail(`refused — ${(r && r.error) || 'the server did not answer'}`);
+      say(`weekly review taken — ${r.proposed.length} lesson(s) proposed${r.snapshot.narrowed.length ? ', narrowed: ' + r.snapshot.narrowed.join(', ') : ''}`);
+      return 0;
+    }
+    const r = await call('GET', '/api/proactive/learn');
+    if (!r || r.ok === false) return fail((r && r.error) || 'the server did not answer');
+    if (sub === 'lessons') {
+      if (r.paused) { say('Learning is paused: no lesson applies.'); return 0; }
+      if (!r.approved.length) say('No approved lessons.');
+      for (const l of r.approved) say(`- ${l.text}`);
+      return 0;
+    }
+    if (sub !== 'status') return fail('usage: pmos proactive learn [status|run|lessons|approve ID|reject ID|retire ID|restore TRIGGER|reset]');
+    say(`learning ${r.paused ? 'paused' : 'on'} · ${r.evidenceCount} piece(s) of evidence${r.resetAt ? ' since ' + r.resetAt : ''}`);
+    const ro = r.rollup;
+    say(`last ${ro.days} days — ${rate(ro.hit, 'hit rate')} · ${rate(ro.asIs, 'used as is')} · ${rate(ro.corrections, 'corrections per prepared run')} · ${ro.missed} reported missed`);
+    say('watermelon check: ' + ro.watermelon.note + (ro.watermelon.reasons.length ? ' ' + ro.watermelon.reasons.join('; ') + '.' : ''));
+    for (const c of r.cells.filter((x) => x.delta)) say(`weight ${c.dim} ${c.key}: ${c.delta > 0 ? '+' : ''}${c.delta} (${c.n} events, net ${c.sum})`);
+    for (const n of r.narrowed) say(`narrowed: ${n.kind} — useful ${Math.round(n.rate * 100)}% over ${n.n} ratings in ${n.days} days (floor ${Math.round(n.floor * 100)}%). Restore with: pmos proactive learn restore ${n.kind}`);
+    for (const l of r.lessons.filter((x) => x.status === 'proposed' || x.status === 'approved')) say(`${l.id}  ${l.status}  ${l.text}`);
+    return 0;
+  }
   if (verb === 'brief') {
     const sub = pos[0] || 'show';
     if (sub === 'submit') {

package/workspace/lib/proactive.js

@@ -39,14 +39,14 @@ const clip = (s, n) => String(s == null ? '' : s).replace(/\s+/g, ' ').trim().sl
 const days = (ms) => Math.floor(ms / DAY);
 
 function cand(kind, key, p) {
-  return { id: idOf(key), key, kind, owner: OWNER[kind], initiative_id: p.initiative_id || null, ws: p.ws || null, repo: p.repo || null,
+  return { id: idOf(key), key, kind, owner: OWNER[kind], initiative_id: p.initiative_id || null, ws: p.ws || null, repo: p.repo || null, lane: p.lane || null,
     title: clip(p.title, 120), why: clip(p.why, 200), evidence: clip(p.evidence, 240), confidence: p.confidence, since: p.since == null ? null : p.since,
     open: p.open || null };
 }
 
 /**
  * @param {{now:number, settings:object, repos:Array, nextStepRuns:Array}} ctx
- *   repos[]: {name, ws, error?, initiatives:[{id,title,active,lastRun,hasRuns}], needs:[{initiative_id,question,run_id}],
+ *   repos[]: {name, ws, error?, initiatives:[{id,title,active,lane,lastRun,hasRuns}], needs:[{initiative_id,question,run_id}],
  *            returned:[{initiative_id,note,at}], schedules:[{id,name,lastStatus,lastRun}]}
  *   nextStepRuns[]: {session_id, initiative_id, ws, key, ended, reviewed, at}
  * @returns {{candidates:Array, unreadable:Array<{repo:string,error:string}>}}
@@ -61,7 +61,7 @@ function detect(ctx) {
       for (const n of r.needs || []) {
         const ini = byId.get(n.initiative_id);
         out.push(cand('needs', `needs:${r.ws}:${n.run_id || n.initiative_id + ':' + clip(n.question, 60)}`, {
-          initiative_id: n.initiative_id, ws: r.ws, repo: r.name, title: ini ? ini.title || ini.id : (n.initiative_id || 'an open item'),
+          initiative_id: n.initiative_id, ws: r.ws, repo: r.name, lane: ini ? ini.lane : null, title: ini ? ini.title || ini.id : (n.initiative_id || 'an open item'),
           why: 'An open item is waiting on you.', evidence: n.question, confidence: 0.95, since: null,
           open: n.initiative_id ? { type: 'initiative', initiative_id: n.initiative_id, ws: r.ws } : null }));
       }
@@ -71,7 +71,7 @@ function detect(ctx) {
         const ini = byId.get(x.initiative_id);
         if (ini && !ini.active) continue;
         out.push(cand('returned', `returned:${r.ws}:${x.initiative_id}:${x.at || ''}`, {
-          initiative_id: x.initiative_id, ws: r.ws, repo: r.name, title: ini ? ini.title || ini.id : x.initiative_id,
+          initiative_id: x.initiative_id, ws: r.ws, repo: r.name, lane: ini ? ini.lane : null, title: ini ? ini.title || ini.id : x.initiative_id,
           why: 'You returned this at the Acceptance Gate and it has not been accepted since.', evidence: x.note || 'returned', confidence: 0.95, since: x.at ? Date.parse(x.at) || null : null,
           open: { type: 'initiative', initiative_id: x.initiative_id, ws: r.ws } }));
       }
@@ -93,7 +93,7 @@ function detect(ctx) {
         if (idle < limit) continue;
         const d = days(idle);
         out.push(cand('stalled', `stalled:${r.ws}:${i.id}`, {
-          initiative_id: i.id, ws: r.ws, repo: r.name, title: i.title || i.id,
+          initiative_id: i.id, ws: r.ws, repo: r.name, lane: i.lane, title: i.title || i.id,
           why: `In progress, with no agent run for ${d} days.`, evidence: `last run ${new Date(i.lastRun).toISOString().slice(0, 10)}; the threshold is ${st.stalledDays || DEFAULTS.stalledDays} days`,
           confidence: Math.min(0.85, +(0.5 + 0.05 * (d - (st.stalledDays || DEFAULTS.stalledDays))).toFixed(2)), since: i.lastRun,
           open: { type: 'initiative', initiative_id: i.id, ws: r.ws } }));
@@ -112,9 +112,10 @@ function detect(ctx) {
   return { candidates: out, unreadable };
 }
 
-function rank(cands, now) {
+/** `adj` is optional (slice D4): c → {delta, why[]}. Without it the order is the fixed one, unchanged. */
+function rank(cands, now, adj) {
   const score = (c) => BASE[c.kind] + (c.since != null && now != null ? Math.min(30, Math.max(0, days(now - c.since))) : 0);
-  return cands.map((c) => ({ ...c, rank: score(c) })).sort((a, b) => b.rank - a.rank || (a.id < b.id ? -1 : 1))
+  return cands.map((c) => { const a = typeof adj === 'function' ? adj(c) : null; const d = a && a.delta ? a.delta : 0; return { ...c, rank: score(c) + d, adjust: d, adjust_why: a && a.why ? a.why.join('; ') : '' }; }).sort((a, b) => b.rank - a.rank || (a.id < b.id ? -1 : 1))
     .map((c, i) => ({ ...c, n: i + 1 }));
 }
 

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.46.0",
+  "version": "0.47.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 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 jev-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 && node kg.test.js && node proactive-prepare.test.js && node session-flag.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 jev-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 && node kg.test.js && node proactive-prepare.test.js && node learn.test.js && node session-flag.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 && node pm-r22-test.js && node pm-r23-test.js && node pm-r24-test.js && node pm-r25-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 && node pm-r24-test.js && node pm-r25-test.js && node pm-r26-test.js",
     "test:offline": "node offline-tarball.test.js"
   },
   "engines": {

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

@@ -816,6 +816,7 @@ 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');
+  reload('learn');
   tSay('ok', say);
 }
 async function tOpen(c) {
@@ -831,7 +832,7 @@ async function tScan() {
 }
 async function tSettings(patch) {
   const out = await post('/api/proactive/settings', patch);
-  reload('today'); reload('brief'); reload('prepare');
+  reload('today'); reload('brief'); reload('prepare'); reload('learn');
   tSay(!out || out.ok === false ? 'bad' : 'ok', !out || out.ok === false ? ((out && out.error) || 'not saved') : 'saved');
 }
 function tCard(c) {
@@ -841,6 +842,7 @@ function tCard(c) {
       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 : ''))),
+    c.adjust ? el('span', { style: 'display:block;font-size:10.5px;color:var(--muted-foreground);margin:0 0 4px', 'data-r26': 'adjust' }, iv('Learned from your feedback: ' + c.adjust_why + '.')) : null,
     el('span', { style: 'display:flex;gap:4px;flex-wrap:wrap' },
       c.open ? b('open', 'open', () => tOpen(c)) : null,
       c.initiative_id && c.ws ? el('button', { style: BTN, hover: 'color:var(--foreground)', 'data-r23': 'prepare', onClick: () => bgShowPlan(c) }, 'prepare in the background') : null,
@@ -967,6 +969,51 @@ function backgroundSection() {
   if (d.entries.some((e) => e.status === 'queued')) kids.push(el('div', { style: 'padding:4px 14px' }, el('button', { style: BTN, hover: 'color:var(--foreground)', title: 'look at the queue now; ignores quiet hours only', 'data-r23': 'run', onClick: bgRun }, 'run the queue now')));
   return kids;
 }
+/* learning (proactive-engine D4): bounded weights, a weekly rollup, lessons that wait for the PM's press, triggers left off */
+let lNote = null;
+async function lPost(url, body, say) {
+  const out = await post(url, body);
+  lNote = !out || out.ok === false ? { tone: 'bad', text: (out && out.error) || 'not done — nothing changed' } : { tone: 'ok', text: typeof say === 'function' ? say(out) : say };
+  reload('learn'); reload('today'); setState({});
+}
+const lRate = (x, what) => x.rate === null ? what + ': not enough evidence (' + x.n + ' of ' + x.min + ' needed)' : what + ': ' + Math.round(x.rate * 100) + '% (' + x.n + ' counted)';
+function learningSection() {
+  const r = read('learn', '/api/proactive/learn');
+  const st = status(r, 'what it learned');
+  const kids = [el('div', { style: LABEL }, iv('learning'))];
+  if (st) return [...kids, st];
+  const d = r.data; const ro = d.rollup;
+  const b = (label, attr, fn, title) => el('button', { style: BTN, hover: 'color:var(--foreground)', title: title || null, 'data-r26': attr, onClick: fn }, label);
+  kids.push(el('div', { style: NOTE, 'data-r26': 'state' }, iv((d.paused ? 'Paused: nothing is weighted, narrowed or proposed, and feedback is still recorded. ' : 'On. ') + d.evidenceCount + ' piece(s) of evidence' + (d.resetAt ? ' since you reset it' : '') + '. Computed from your own feedback and review decisions on this computer; no model is called. It cannot lower or hide what blocks on you.')));
+  kids.push(el('div', { style: NOTE, 'data-r26': 'rollup' }, iv('Last ' + ro.days + ' days — ' + lRate(ro.hit, 'hit rate') + ' · ' + lRate(ro.asIs, 'used as is') + ' · ' + lRate(ro.corrections, 'corrections per prepared run') + ' · ' + ro.missed + ' reported missed')));
+  kids.push(el('div', { style: NOTE + (ro.watermelon.flag ? ';color:var(--destructive)' : ''), 'data-r26': 'watermelon' }, iv('Watermelon check: ' + ro.watermelon.note + (ro.watermelon.reasons.length ? ' ' + ro.watermelon.reasons.join('; ') + '.' : ''))));
+  const cells = d.cells.filter((c) => c.delta);
+  if (!cells.length) kids.push(el('div', { style: NOTE, 'data-r26': 'no-weights' }, iv('No weight has moved yet. A cell moves after ' + r.data.min_cell + ' events, by at most ' + d.caps.kind + ' points per trigger, ' + d.caps.lane + ' per lane and ' + d.caps.time + ' per trigger and time of day, ' + d.caps.total + ' in all.')));
+  for (const c of cells) kids.push(el('div', { style: 'padding:2px 14px;font-size:11.5px', 'data-r26': 'weight' }, iv(c.dim + ' ' + c.key.replace('|', ' in the ') + ': ' + (c.delta > 0 ? '+' : '') + c.delta + ' (' + c.n + ' events, net ' + c.sum + ')')));
+  for (const n of d.narrowed) kids.push(el('div', { 'data-r26': 'narrowed', 'data-kind': n.kind, style: 'padding:6px 14px;border-bottom:1px solid var(--border)' },
+    el('span', { style: 'display:block;font-size:12px' }, iv('Left off Today: ' + n.label.toLowerCase() + '. Useful ' + Math.round(n.rate * 100) + '% over ' + n.n + ' ratings in ' + n.days + ' days; the floor is ' + Math.round(n.floor * 100) + '%. They are still scanned.')),
+    b('restore', 'restore', () => lPost('/api/proactive/learn/restore', { kind: n.kind, confirm: true }, 'restored — it stays until 10 new ratings of it have arrived'))));
+  const proposed = d.lessons.filter((x) => x.status === 'proposed');
+  kids.push(el('div', { style: LABEL }, iv('lessons to approve')));
+  if (!proposed.length) kids.push(el('div', { style: NOTE, 'data-r26': 'no-lessons' }, iv('None waiting. A weekly review proposes lessons; none enters anything until you approve it.')));
+  for (const l of proposed) kids.push(el('div', { 'data-r26': 'lesson', 'data-id': l.id, style: 'padding:6px 14px;border-bottom:1px solid var(--border)' },
+    el('span', { style: 'display:block;font-size:12px' }, iv(l.text)),
+    el('span', { style: 'display:block;font-size:10.5px;color:var(--muted-foreground);margin:2px 0 4px' }, iv(l.evidence)),
+    el('span', { style: 'display:flex;gap:4px' },
+      b('approve', 'approve', () => lPost('/api/proactive/learn/lesson', { id: l.id, decision: 'approve', confirm: true }, 'approved — the morning-brief session will read it'), 'the morning-brief session reads it; nothing else does'),
+      b('reject', 'reject', () => lPost('/api/proactive/learn/lesson', { id: l.id, decision: 'reject', confirm: true }, 'rejected — it is not proposed again for 28 days')))));
+  if (d.approved.length) kids.push(el('div', { style: LABEL }, iv('approved lessons (' + d.approved.length + ' of ' + d.max_approved + ')')));
+  for (const l of d.approved) kids.push(el('div', { 'data-r26': 'approved', 'data-id': l.id, style: 'padding:6px 14px;border-bottom:1px solid var(--border)' },
+    el('span', { style: 'display:block;font-size:12px' }, iv(l.text)),
+    b('retire', 'retire', () => lPost('/api/proactive/learn/lesson', { id: l.id, decision: 'retire', confirm: true }, 'retired'))));
+  if (lNote) kids.push(el('div', { 'data-r26': 'note', style: NOTE + ';color:' + (lNote.tone === 'bad' ? 'var(--destructive)' : 'var(--foreground)') }, iv(lNote.text)));
+  const last = d.snapshots[0];
+  kids.push(el('div', { style: NOTE, 'data-r26': 'last-run' }, iv(last ? 'Last weekly review: ' + String(last.at).replace('T', ' ').slice(0, 16) + ' UTC. It runs about every 7 days, only while the workspace server runs, and does not catch up.' : 'No weekly review has run yet. It runs about every 7 days once there is feedback, only while the workspace server runs, and does not catch up.')));
+  kids.push(el('div', { style: 'display:flex;gap:4px;flex-wrap:wrap;padding:2px 14px 6px' },
+    b('run the weekly review now', 'run', () => lPost('/api/proactive/learn/run', {}, (o) => 'review taken — ' + o.proposed.length + ' lesson(s) proposed'), 'refused while learning is paused'),
+    b('forget what it learned', 'reset', () => lPost('/api/proactive/learn/reset', { confirm: true }, 'reset — earlier feedback is ignored from now on, not deleted'), 'earlier feedback stops counting; nothing is deleted')));
+  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.'))];
@@ -974,7 +1021,7 @@ export function todayList() {
   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)', title: 'read the brief and the list again', 'data-r22': 'refresh', onClick: () => { reload('today'); reload('brief'); reload('learn'); 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' });
@@ -993,6 +1040,7 @@ export function todayList() {
   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 (bgPlan && bgPlan.cid === c.id) kids.push(bgPlanView()); }
+  for (const n of d.narrowed || []) kids.push(el('div', { style: NOTE, 'data-r26': 'narrowed-note' }, iv(n.hidden + ' ' + n.label.toLowerCase() + ' hidden: you rated them useful only ' + Math.round(n.rate * 100) + '% of the time. Restore them under learning below.')));
   kids.push(...backgroundSection());
   if (d.dismissed) kids.push(el('div', { style: NOTE, 'data-r22': 'dismissed' }, iv(d.dismissed + ' dismissed item(s) hidden for 7 days.')));
   // settings
@@ -1007,8 +1055,8 @@ export function todayList() {
   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 })));
+  kids.push(...learningSection());
+  kids.push(chk('pause learning (no weights, no lessons, nothing narrowed)', 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)' });

package/workspace/server.js

@@ -79,6 +79,7 @@ const nextStepActions = require('./lib/next-step-actions');
 const sessionBudget = require('./lib/session-budget');
 const judgmentLib = require('./lib/judgment');
 const proactiveLib = require('./lib/proactive');
+const learnLib = require('./lib/learn');
 const briefLib = require('./lib/brief');
 const prepareQueue = require('./lib/prepare-queue');
 const harness = require('./lib/harness-parse');
@@ -3450,7 +3451,7 @@ function proactiveCtx(now, settings) {
       for (const b of pf.rows.filter((x) => x.ws === r.ws)) {
         if (!b || !b.id) continue;
         const lc = life.get(b.id); const stopped = !!(lc && lc.state !== 'active');
-        entry.initiatives.push({ id: b.id, title: b.title || b.id, active: !b.accepted && !stopped, lastRun: lastRun.has(b.id) ? lastRun.get(b.id) : null, hasRuns: hasRuns.has(b.id) });
+        entry.initiatives.push({ id: b.id, title: b.title || b.id, active: !b.accepted && !stopped, lane: b.lane || null, lastRun: lastRun.has(b.id) ? lastRun.get(b.id) : null, hasRuns: hasRuns.has(b.id) });
       }
       entry.needs = (readNeeds(w) || []).filter((n) => n).map((n) => ({ initiative_id: n.initiative_id || null, question: n.question || '', run_id: n.run_id || null }));
       for (const [id, a] of acc) if (a && a.action === 'return') entry.returned.push({ initiative_id: id, note: 'returned at the Acceptance Gate', at: a.at });
@@ -3470,7 +3471,12 @@ function proactiveToday(now) {
   const d = proactiveLib.detect(ctx);
   const dismissed = proactiveLib.dismissedIds(nsRead(PRO_FEEDBACK()), now);
   const live = d.candidates.filter((c) => !dismissed.has(c.id));
-  return { settings, unreadable: d.unreadable, dismissed: d.candidates.length - live.length, candidates: settings.enabled ? proactiveLib.rank(live, now) : [], off: !settings.enabled };
+  // D4: the PM's own verdicts move a few bounded weights, and a trigger rated badly enough is left off and named. Paused, both are off.
+  const L = learnState(now, settings);
+  const shown = live.filter((c) => !L.narrowed.some((n) => n.kind === c.kind));
+  const bucket = learnLib.bucketOf(now);
+  const ranked = settings.enabled ? proactiveLib.rank(shown, now, (c) => learnLib.adjust(c, L.weights, bucket, settings.pauseLearning)) : [];
+  return { settings, unreadable: d.unreadable, dismissed: d.candidates.length - live.length, narrowed: L.narrowed.map((n) => ({ ...n, hidden: live.filter((c) => c.kind === n.kind).length })), candidates: ranked, off: !settings.enabled };
 }
 function proactiveScan({ manual }) {
   const now = Date.now();
@@ -3483,7 +3489,7 @@ function proactiveScan({ manual }) {
   const fresh = proactiveLib.newSignals(d.candidates, recent, now);
   let wrote = 0;
   for (const c of fresh) {
-    const w = nsAppend(PRO_SIGNALS(), { at: new Date(now).toISOString(), key: c.key, id: c.id, kind: c.kind, initiative_id: c.initiative_id, ws: c.ws, why: c.why, evidence: c.evidence, confidence: c.confidence, manual: !!manual }, 'proactive signal');
+    const w = nsAppend(PRO_SIGNALS(), { at: new Date(now).toISOString(), key: c.key, id: c.id, kind: c.kind, lane: c.lane || null, initiative_id: c.initiative_id, ws: c.ws, why: c.why, evidence: c.evidence, confidence: c.confidence, manual: !!manual }, 'proactive signal');
     if (w.ok) wrote++;
   }
   return { ok: true, skipped: null, appended: wrote, found: d.candidates.length, unreadable: d.unreadable };
@@ -3493,6 +3499,58 @@ function proactiveTick() {
   if (now - proLastScan < PRO_SCAN_EVERY_MS) return;
   proLastScan = now;
   try { proactiveScan({ manual: false }); } catch (e) { warnWriteFail('proactive scan', e); }
+  try { learnWeekly({ manual: false }); } catch (e) { warnWriteFail('proactive weekly review', e); }
+}
+
+// ── Learning, slice D4 (initiative proactive-engine) ─────────────────────────────────────────────────────────────
+// The PM's verdicts and review decisions are evidence. lib/learn.js turns them into bounded weights, a weekly rollup,
+// lessons the PM must approve, and a list of triggers left off Today. Everything is computed from ledgers in the state
+// folder: no model call, no network call, no write into a repository, no session started. Pause learning gives zeros.
+const PRO_LEARN_EVENTS = () => path.join(STATE, 'learn-events.jsonl');
+const PRO_LESSONS = () => path.join(STATE, 'lessons.jsonl');
+const PRO_ROLLUPS = () => path.join(STATE, 'proactive-rollups.jsonl');
+function learnEvidence() {
+  const ev = nsRead(PRO_LEARN_EVENTS());
+  const resetAt = Math.max(0, ...ev.filter((e) => e && e.event === 'reset').map((e) => Date.parse(e.at)).filter(Number.isFinite));
+  const restores = ev.filter((e) => e && e.event === 'restore' && e.kind).map((e) => ({ kind: e.kind, at: Date.parse(e.at) }));
+  const runs = nsRead(NS_RUNS());
+  const got = learnLib.evidence({ feedback: nsRead(PRO_FEEDBACK()), signals: nsRead(PRO_SIGNALS()).slice(-5000), reviews: nsRead(NS_REVIEWS()), runs, queue: queueEntries(), resetAt });
+  const preparedAt = runs.map((r) => Date.parse(r && r.at)).filter((t) => Number.isFinite(t) && t > resetAt);
+  return { ...got, restores, preparedAt, resetAt };
+}
+function learnState(now, settings) {
+  const st = settings || proSettings();
+  const e = learnEvidence();
+  const paused = st.pauseLearning === true;
+  const lessons = learnLib.foldLessons(nsRead(PRO_LESSONS()));
+  const snaps = nsRead(PRO_ROLLUPS());
+  return {
+    paused, resetAt: e.resetAt ? new Date(e.resetAt).toISOString() : null, evidenceCount: e.rows.length, rows: e.rows, missed: e.missed, preparedAt: e.preparedAt,
+    weights: paused ? { kind: {}, lane: {}, time: {} } : learnLib.weights(e.rows),
+    narrowed: paused ? [] : learnLib.narrowing(e.rows, e.restores, now),
+    rollup: learnLib.rollup(e.rows, e.missed, e.preparedAt, { now }),
+    lessons, snapshots: snaps.slice(-8).reverse(),
+  };
+}
+// The weekly run: one snapshot of the trailing 7 days and the lessons it proposes. It never catches up after a gap.
+function learnWeekly({ manual }) {
+  const now = Date.now();
+  const st = proSettings();
+  if (st.pauseLearning) return { ok: false, error: 'learning is paused — switch pause learning off to run the weekly review' };
+  if (!manual && !st.enabled) return { ok: true, ran: false, skipped: 'the engine is off' };
+  const L = learnState(now, st);
+  if (!manual && !learnLib.snapshotDue(L.snapshots, { now, hasEvidence: L.evidenceCount > 0 })) return { ok: true, ran: false, skipped: 'not due' };
+  const at = new Date(now).toISOString();
+  const props = learnLib.propose(L.rows, L.missed, now, L.lessons);
+  const written = [];
+  for (const p of props) {
+    const rec = { event: 'proposed', id: learnLib.lessonId(p.key, at), key: p.key, text: p.text, evidence: p.evidence, at };
+    if (nsAppend(PRO_LESSONS(), rec, 'lesson').ok) written.push(rec);
+  }
+  const snap = { at, manual: !!manual, window_days: L.rollup.days, rollup: L.rollup, proposed: written.map((x) => x.id), narrowed: L.narrowed.map((n) => n.kind) };
+  const w = nsAppend(PRO_ROLLUPS(), snap, 'weekly rollup');
+  if (!w.ok) return { ok: false, error: w.error };
+  return { ok: true, ran: true, snapshot: snap, proposed: written };
 }
 
 // ── Worktree housekeeping: the app that creates the folders shows and clears them ──────────────
@@ -6376,6 +6434,49 @@ async function handleRequest(req, res) {
       return json(res, { ok: true, settings: n.settings });
     }
   }
+  /* ── learning (D4): the PM's verdicts become bounded weights, a rollup and lessons that wait for the PM's press ── */
+  if (p === '/api/proactive/learn' && req.method === 'GET') {
+    const now = Date.now(); const st = proSettings(); const L = learnState(now, st);
+    const { rows, missed, preparedAt, weights: _w, ...pub } = L;
+    const cells = [];
+    for (const dim of ['kind', 'lane', 'time']) for (const [k, c] of Object.entries(L.weights[dim])) cells.push({ dim, key: k, ...c });
+    cells.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta) || b.n - a.n);
+    return json(res, { ok: true, as_of: new Date(now).toISOString(), ...pub, cells, caps: learnLib.CAP, min_cell: learnLib.MIN_CELL,
+      approved: L.lessons.filter((x) => x.status === 'approved'), max_approved: learnLib.MAX_APPROVED,
+      note: 'Computed from your own feedback and review decisions in the workspace state folder. No model is called. A lesson changes nothing until you approve it, and then only the morning-brief session reads it.' });
+  }
+  if (p === '/api/proactive/learn/run' && req.method === 'POST') {
+    const r = learnWeekly({ manual: true });
+    return json(res, r, r.ok ? 200 : (/paused/.test(r.error || '') ? 409 : 500));
+  }
+  if (p === '/api/proactive/learn/lesson' && req.method === 'POST') {
+    let body = {}; try { body = JSON.parse((await readBody(req)) || '{}'); } catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
+    const c = learnLib.checkLessonRequest(body);
+    if (!c.ok) return json(res, { ok: false, error: c.error }, 400);
+    const lessons = learnLib.foldLessons(nsRead(PRO_LESSONS()));
+    const why = learnLib.decideLesson(lessons, c.req);
+    if (why) return json(res, { ok: false, error: why }, why === 'no such lesson' ? 404 : 409);
+    const ev = { approve: 'approved', reject: 'rejected', retire: 'retired' }[c.req.decision];
+    const w = nsAppend(PRO_LESSONS(), { event: ev, id: c.req.id, at: nowISO(), pm: 'wawan' }, 'lesson');
+    if (!w.ok) return json(res, { ok: false, error: w.error }, 500);
+    return json(res, { ok: true, id: c.req.id, status: ev });
+  }
+  if (p === '/api/proactive/learn/restore' && req.method === 'POST') {
+    let body = {}; try { body = JSON.parse((await readBody(req)) || '{}'); } catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
+    if (body.confirm !== true) return json(res, { ok: false, error: 'confirm is required' }, 400);
+    const L = learnState(Date.now());
+    if (!L.narrowed.some((n) => n.kind === body.kind)) return json(res, { ok: false, error: `${String(body.kind || '').slice(0, 20) || 'that trigger'} is not narrowed — nothing to restore` }, 409);
+    const w = nsAppend(PRO_LEARN_EVENTS(), { event: 'restore', kind: body.kind, at: nowISO(), pm: 'wawan' }, 'learn event');
+    if (!w.ok) return json(res, { ok: false, error: w.error }, 500);
+    return json(res, { ok: true, kind: body.kind });
+  }
+  if (p === '/api/proactive/learn/reset' && req.method === 'POST') {
+    let body = {}; try { body = JSON.parse((await readBody(req)) || '{}'); } catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
+    if (body.confirm !== true) return json(res, { ok: false, error: 'confirm is required: this makes the engine ignore all earlier feedback' }, 400);
+    const w = nsAppend(PRO_LEARN_EVENTS(), { event: 'reset', at: nowISO(), pm: 'wawan' }, 'learn event');
+    if (!w.ok) return json(res, { ok: false, error: w.error }, 500);
+    return json(res, { ok: true });
+  }
   if (p === '/api/lifecycle' && req.method === 'POST') {
     // D70 — close, hold, cancel or reopen an initiative. Only reached by an explicit PM press. It
     // appends ONE line to lifecycle.jsonl and never writes an acceptance.

package/workspace/skills/morning-brief.skill

@@ -23,6 +23,7 @@ Rules that always hold:
 
 Procedure:
 1. Run `pmos proactive settings` and `pmos proactive today`. The second lists what the workspace derived from the ledgers. Each of its items may become a priority with source "derived".
+   Then run `pmos proactive learn lessons`. Each line is a preference the PM approved, written from their own feedback. Use it only to decide how confident to be and where an item goes. A lesson never asks you to read another source, to switch a setting on, or to write anything.
 2. Read today's events from the calendar and today's and tomorrow's meeting notes from Wispr Flow, if those sources are on and reachable. Read Jira issues assigned to the PM or due soon, and Confluence pages changed since yesterday, if on and reachable. Read mail only if on: subjects and senders of threads waiting on the PM, no bodies.
 3. For each thing the PM should act on today, write one item: a short title, why it is for today, its source, the initiative id if one applies, who acts (pm or agent), effort (minutes, an-hour, half-day, day), your confidence from 0 to 1 that it belongs on today's list, and one short evidence line. Give a low confidence when you are guessing. The workspace shows an item under 0.5 as "worth asking", not as a priority.
 4. Write the brief as a JSON file in the scratch folder of this session, in this shape, and nothing else: