create-pmos 0.64.0 → 0.65.1

package/workspace/public/pm/initiative-sheet.js

@@ -3,7 +3,8 @@
  * About 70% of the width on a desktop and the whole screen on a phone. Top to bottom:
  *   line 1  the title, the horizon, the health reason (only when not on track), and a meta line: lane · anchor · id
  *   line 2  the stage stepper, then "Waiting on you: approval [Open gate ▸]" or "Waiting on agent: build [Hand to agent ▸]"
- *   tabs    Breakdown (the Run 1 pane, embedded: Tree · Board, and Timeline once Run 4 registers it), Files, History,
+ *   tabs    Breakdown (the Run 1 pane, embedded: Tree · Board, and Timeline once Run 4 registers it), Files (List · Graph:
+ *           the graph is doc-graph.js, initiative docs-library-graph), History,
  *           Jira tickets (sheet-jira.js, initiative jira-wbs: the tickets drafted from the PRD and their status in Jira),
  *           People (people-link.js, initiative people-directory: who owns its items or is named in interactions about it)
  *   ⋯       horizon, check-by, lifecycle and the anchor (both PM-only: the server's guard answers), Copy CLI, Export breakdown
@@ -22,6 +23,7 @@ import { mountBreakdown, unmountBreakdown } from './panel-breakdown.js';
 import { mountJira, unmountJira } from './sheet-jira.js';
 import { initiativePeople } from './people-link.js';
 import { openDoc } from './panel-initiatives.js';
+import { getLibrary, initiativeGraph } from './doc-graph.js';
 import { openNewSession } from './panel-newsess.js';
 import { wsOf, readDoc, saveDoc } from './data.js';
 import { state, setState } from './state.js';
@@ -67,6 +69,8 @@ export function openSheet(repo, slug) {
   ensureSprite();
   let data = null;
   let tab = 'breakdown';
+  let fview = 'list';      // the Files tab: 'list' or 'graph' (docs-library-graph R-N1)
+  let lib = null;          // the library, read on the first press on Graph
   let closed = false;
   const tabId = 'initiative:' + slug;
   const crumb = el('div', { class: 'in-sheet__crumb' });
@@ -277,9 +281,27 @@ export function openSheet(repo, slug) {
         onOpen: () => { s.close(); openDoc(slug, f.path, f.label, null, f.source === 'git' ? { readonly: true } : undefined); },
         attrs: { 'data-in-file': f.kind, 'data-in-file-source': f.source || 'record' }, openAttrs: { 'data-in-file-open': f.kind },
       }));
-      panel.replaceChildren(files.length ? el('div', { class: 'in-files' }, groups.map(([src, list]) => el('section', { class: 'in-files__group', 'data-in-files': src },
+      const listView = () => (files.length ? el('div', { class: 'in-files' }, groups.map(([src, list]) => el('section', { class: 'in-files__group', 'data-in-files': src },
         el('h3', { class: 'in-files__title' }, COPY.sheet.fileSource[src] || src),
         el('div', { class: 'in-sheet__rows', role: 'list' }, list.map(fileRow))))) : empty({ text: COPY.sheet.noFiles }));
+      // List · Graph (docs-library-graph R-N1): the graph is this initiative's markdown files (the ones its record names
+      // and the ones the library's index attributes to it; a file git changed for it is evidence, not one of its files)
+      // and the outside files they link to. On a phone initiativeGraph draws nothing and the list shows (R-N5).
+      const paths = files.filter((f) => f.kind !== 'note' && (f.source || 'record') !== 'git' && /\.md$/i.test(f.path || '')).map((f) => f.path);
+      const seg = tabs({ variant: 'segmented', ariaLabel: COPY.sheet.filesAs, value: fview,
+        items: [{ id: 'list', label: COPY.sheet.filesList }, { id: 'graph', label: COPY.sheet.filesGraph }], attrs: { 'data-in-files-view': '' },
+        onChange: (id) => { if (id === fview) return; fview = id; drawPanel(); const t = panel.querySelector('[data-in-files-view] [data-tab="' + id + '"]'); if (t) t.focus({ preventScroll: true }); } });
+      const bar = el('div', { class: 'in-files__bar' }, seg, el('span', { class: 'in-files__hint' }, fview === 'graph' ? COPY.sheet.graphHint : COPY.sheet.listHint));
+      if (fview === 'list' || !paths.length) { panel.replaceChildren(bar, listView()); return; }
+      const open = (p, title) => { s.close(); openDoc(slug, p, title); };
+      const graphNow = () => { const g = lib ? initiativeGraph(lib, paths, { onOpen: open }) : null; return g || el('div', null, el('p', { class: 'in-note' }, COPY.sheet.graphPhone), listView()); };
+      if (lib) { panel.replaceChildren(bar, graphNow()); return; }
+      panel.replaceChildren(bar, el('p', { class: 'in-note' }, COPY.sheet.graphReading));
+      getLibrary(ws).then((l) => {
+        if (tab !== 'files' || fview !== 'graph') return;
+        if (!l) { panel.replaceChildren(bar, el('p', { class: 'in-note' }, COPY.sheet.graphError), listView()); return; }
+        lib = l; drawPanel();
+      });
       return;
     }
     const hist = data.history || [];

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

@@ -134,6 +134,14 @@ export const COPY = {
     openGate: 'Open gate',
     handToAgent: 'Hand to agent',
     noFiles: 'No files yet.',
+    filesAs: 'Show files as',
+    filesList: 'List',
+    filesGraph: 'Graph',
+    listHint: 'Every file this initiative owns.',
+    graphHint: 'This initiative’s files, and the files outside it that they link to.',
+    graphReading: 'Reading the links…',
+    graphError: 'The links could not be read. The list is below.',
+    graphPhone: 'On a small screen the files show as a list.',
     fileSource: { record: 'Named by the record', 'knowledge-graph': 'Linked documents', git: 'Changed for it in git' },
     commits: (n) => (n === 1 ? '1 commit' : `${n} commits`),
     shared: 'shared',

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

@@ -1,4 +1,4 @@
-/* pm/view-notes.js — the Notes view tab: one meeting on one screen (meeting-notes, Runs 1 and 2).
+/* pm/view-notes.js — the Notes view tab: one meeting on one screen (meeting-notes, Runs 1 to 3).
  *
  * The screen follows the simplified mockup the PM reviewed (prototype/meeting-notes):
  *   header      the title and the date, and one action: Listen; while listening a red dot, the time, the sources and Stop;
@@ -17,10 +17,17 @@
  * LABELS AND CHECKS. The server labels each line locally; behind the D91 gates Jev labels it and compares a captured line
  * with the closest repository passage. The page shows the result in words and reads it by polling the note.
  *
+ * CORRECT, TRACK AND REPLAY (Run 3, D92). The ellipsis on a transcript line opens its editor: the words (the words that
+ * were heard stay kept and the line shows "edited"), the label, whether it is in the summary, tags and people. Tags and
+ * people show on the line, on its item and under Tagged. Each save of the notes keeps the text before it, and History
+ * shows every version as a line diff, the original first. When the note kept its audio, Replay plays it; while it plays,
+ * the transcript line, its item and the note line written at that moment are highlighted, and a time in the transcript
+ * jumps there. Your notes are shown read-only while the meeting plays, so their lines can be highlighted.
+ *
  * Reads and writes (lib/routes-notes.js). Notes live in the per-user runtime directory, never in a repository:
- *   GET  /api/notes · /api/notes/one?id=… · /api/notes/engine?ws=…
+ *   GET  /api/notes · /api/notes/one?id=… · /api/notes/engine?ws=… · /api/notes/recording?id=… · /api/people?ws=…
  *   POST /api/notes/new · save · dictate · record · transcript · audio · label · speaker · switch · whisper-setup · private
- *        · summarize · summarize-agent · delete
+ *        · summarize · summarize-agent · delete · line · recording-delete
  */
 import { el } from './dom.js';
 import { askConfirm, askText } from './dialogs.js';
@@ -49,6 +56,9 @@ let engine = null;            // { ws, whisper, jev, at }
 let showList = false;
 let pollTimer = null; let agentTimer = null;
 let busy = '';
+let player = null;            // the replay: { id, bytes, el, playing }, kept across redraws so playback goes on
+let people = null;            // { ws, names } — the repository's people, offered in the line editor
+const LABELS = [['decision', 'Decision'], ['action', 'Action'], ['question', 'Question'], ['fact', 'Fact'], ['topic', 'Topic'], ['statement', 'Statement'], ['small talk', 'Small talk']];
 
 const nowClock = (iso) => { try { return new Date(iso).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }); } catch { return ''; } };
 const dayOf = (iso) => { try { return new Date(iso).toLocaleDateString([], { weekday: 'short', day: 'numeric', month: 'short' }); } catch { return ''; } };
@@ -107,6 +117,42 @@ export function caught(n) {
   return out;
 }
 const checkWords = (c) => (!c ? '' : c.verdict === 'differs' ? 'differs from ' + c.doc : c.verdict === 'agrees' ? 'consistent with ' + c.doc : 'see ' + c.doc);
+/** " #tag @Person" for a line, or ''. Pure. */
+export const tagWords = (x) => [...((x && x.tags) || []).map((t) => ' #' + t), ...((x && x.people) || []).map((p) => ' @' + p)].join('');
+/** The lines with tags or people that are not already a caught item, in the order they were said. Pure. */
+export function tagged(n) {
+  const c = caught(n);
+  const inItems = new Set(Object.values(c).flat().map((x) => x.index));
+  return (n.transcript || []).map((x, index) => ({ ...x, index }))
+    .filter((x) => x && x.text && !x.dropped && !inItems.has(x.index) && ((x.tags && x.tags.length) || (x.people && x.people.length)));
+}
+/** The index of the last item whose time is at or before `ms`, or -1. `times` is in meeting order. Pure. */
+export function nowIndex(times, ms) {
+  let best = -1;
+  for (let i = 0; i < times.length; i++) if (typeof times[i] === 'number' && times[i] <= ms && (best < 0 || times[i] >= times[best])) best = i;
+  return best;
+}
+/** The note line written at meeting time `ms`: of the lines that have a time at or before it, the latest. Pure. */
+export function noteLineAt(body, lineTimes, ms) {
+  const lines = String(body || '').split(/\r?\n/);
+  return nowIndex(lines.map((l) => (l.trim() && lineTimes ? lineTimes[l.trim()] : undefined)), ms);
+}
+/** A line diff from `a` to `b`: [{ op: 'same'|'del'|'add', text }]. Longest common subsequence of lines. Pure. */
+export function lineDiff(a, b) {
+  const x = String(a || '').split(/\r?\n/); const y = String(b || '').split(/\r?\n/);
+  if (x.length * y.length > 250000) return [...x.map((t) => ({ op: 'del', text: t })), ...y.map((t) => ({ op: 'add', text: t }))];
+  const L = Array.from({ length: x.length + 1 }, () => new Array(y.length + 1).fill(0));
+  for (let i = x.length - 1; i >= 0; i--) for (let j = y.length - 1; j >= 0; j--) L[i][j] = x[i] === y[j] ? L[i + 1][j + 1] + 1 : Math.max(L[i + 1][j], L[i][j + 1]);
+  const out = []; let i = 0; let j = 0;
+  while (i < x.length && j < y.length) {
+    if (x[i] === y[j]) { out.push({ op: 'same', text: x[i] }); i++; j++; }
+    else if (L[i + 1][j] >= L[i][j + 1]) out.push({ op: 'del', text: x[i++] });
+    else out.push({ op: 'add', text: y[j++] });
+  }
+  while (i < x.length) out.push({ op: 'del', text: x[i++] });
+  while (j < y.length) out.push({ op: 'add', text: y[j++] });
+  return out;
+}
 /** The whole note as Markdown, for "Copy as Markdown". Pure, for the suite. */
 export function noteMarkdown(n) {
   const out = ['# ' + (n.title || 'Untitled note'), ''];
@@ -118,9 +164,11 @@ export function noteMarkdown(n) {
   for (const [k, title] of [...SECTIONS, ['fact', 'Facts mentioned']]) {
     if (!c[k].length) continue;
     out.push('## ' + title, '', ...c[k].map((x) => '- ' + (k === 'action' && x.source && x.source !== 'speech' ? speakerOf(n, x.source) + ': ' : '') + x.text
-      + (x.check && x.check.verdict !== 'related' ? ' (' + checkWords(x.check) + ')' : '') + ' [' + fmtTime(x.t) + ']'), '');
+      + tagWords(x) + (x.check && x.check.verdict !== 'related' ? ' (' + checkWords(x.check) + ')' : '') + ' [' + fmtTime(x.t) + ']'), '');
   }
-  if ((n.transcript || []).length) out.push('## Transcript', '', ...n.transcript.map((x) => '[' + fmtTime(x.t) + '] ' + speakerOf(n, x.source) + ': ' + x.text), '');
+  const tg = tagged(n);
+  if (tg.length) out.push('## Tagged', '', ...tg.map((x) => '- ' + x.text + tagWords(x) + ' [' + fmtTime(x.t) + ']'), '');
+  if ((n.transcript || []).length) out.push('## Transcript', '', ...n.transcript.map((x) => '[' + fmtTime(x.t) + '] ' + speakerOf(n, x.source) + ': ' + x.text + tagWords(x)), '');
   return out.join('\n');
 }
 /** Float samples at `inRate` as 16 kHz 16-bit samples. Each output sample averages the input samples it covers. Pure. */
@@ -151,7 +199,7 @@ async function loadList(ctx) {
   if (!currentId && list.notes.length) currentId = list.notes[0].id;
   ctx.setState({});
 }
-const sig = (n) => JSON.stringify([n.transcript, n.summary && n.summary.at, n.agent && n.agent.markdown, n.private, n.speakers, n.title]);
+const sig = (n) => JSON.stringify([n.transcript, n.summary && n.summary.at, n.agent && n.agent.markdown, n.private, n.speakers, n.title, (n.versions || []).length, n.__recording && n.__recording.bytes]);
 async function loadNote(ctx, id) {
   const r = await pmGet('/api/notes/one?id=' + encodeURIComponent(id));
   if (r && r.ok) {
@@ -159,6 +207,7 @@ async function loadNote(ctx, id) {
     // what the PM is typing wins over what the server last saved
     if (editor && editor.id === id && dirty) { r.note.title = editor.title.value; r.note.body = editor.body.value; }
     r.note.__audio = r.audio || null;
+    r.note.__recording = r.recording || null;
     cache.set(id, r.note);
     if (!had || sig(had) !== sig(r.note)) ctx.setState({});
   } else if (r && r.status === 404) { cache.delete(id); if (currentId === id) currentId = null; loadList(ctx); }
@@ -210,6 +259,8 @@ async function flushSave(ctx) {
   if (r && r.ok) {
     savedAt = r.updated_at; saveError = null;
     const n = cache.get(id); if (n) { n.title = title; n.body = body; n.updated_at = r.updated_at; touchRow(n); }
+    // a new version was kept: read it, so History shows it
+    if (n && typeof r.versions === 'number' && r.versions !== (n.versions || []).length) loadNote(ctx, id);
   } else { dirty = true; saveError = (r && r.error) || 'not saved'; }
   if (dirty && !saveError) scheduleSave(ctx);     // typed while the save was in flight
   paintSaveState();
@@ -237,14 +288,14 @@ async function selectNote(ctx, id) {
   showList = false;
   if (id === currentId) { ctx.setState({}); return; }
   await stopAll(ctx); await flushSave(ctx);
-  currentId = id; editor = null; savedAt = null; saveError = null; banner = null;
+  currentId = id; editor = null; savedAt = null; saveError = null; banner = null; dropPlayer();
   ctx.setState({});
   loadNote(ctx, id);
 }
 async function deleteNote(ctx, n) {
   const sure = await askConfirm({ title: 'Delete this note?', body: '"' + (n.title || 'Untitled note') + '" and its transcript and summaries are deleted from this machine. This cannot be undone.', confirmLabel: 'Delete note', danger: true });
   if (!sure) return;
-  await stopAll(ctx, { discard: true }); clearTimeout(saveTimer); dirty = false;
+  await stopAll(ctx, { discard: true }); clearTimeout(saveTimer); dirty = false; dropPlayer();
   const r = await pmPost('/api/notes/delete', { id: n.id });
   if (r && r.ok) { cache.delete(n.id); currentId = null; editor = null; if (list) list.notes = (list.notes || []).filter((x) => x.id !== n.id); if (list && list.notes.length) currentId = list.notes[0].id; banner = { tone: 'ok', text: 'The note was deleted.' }; }
   else banner = { tone: 'bad', text: (r && r.error) || 'the note was not deleted' };
@@ -254,7 +305,7 @@ async function setPrivate(ctx, n, priv) {
   // a private press drops what is still buffered: nothing more is sent, transcribed or summarized
   if (priv) await stopAll(ctx, { discard: true });
   const r = await pmPost('/api/notes/private', { id: n.id, private: priv });
-  if (r && r.ok) { n.private = r.private; touchRow(n); banner = priv ? { tone: 'ok', text: 'Marked private. Listening stopped, and nothing from this note goes to Jev or to any agent.' } : null; }
+  if (r && r.ok) { n.private = r.private; if (priv) { n.__recording = null; dropPlayer(); } touchRow(n); banner = priv ? { tone: 'ok', text: 'Marked private. Listening stopped, its audio was deleted, and nothing from this note goes to Jev or to any agent.' } : null; }
   else banner = { tone: 'bad', text: (r && r.error) || 'not changed' };
   ctx.setState({});
 }
@@ -310,6 +361,133 @@ async function renameSpeaker(ctx, n, source) {
   ctx.setState({});
 }
 
+/* ── corrections, history and replay (Run 3, D92) ─────────────────────────────────────────────────── */
+async function peopleNames(ctx) {
+  const ws = wsOf(ctx);
+  if (people && people.ws === ws) return people.names;
+  const r = await pmGet('/api/people' + (ws ? '?ws=' + encodeURIComponent(ws) : ''));
+  const names = r && r.ok && Array.isArray(r.people) ? [...new Set(r.people.map((x) => x && x.name).filter(Boolean))].slice(0, 24) : [];
+  people = { ws, names };
+  return names;
+}
+const splitTags = (v) => String(v || '').split(/[\s,]+/).map((t) => t.replace(/^#+/, '')).filter(Boolean);
+const splitPeople = (v) => String(v || '').split(',').map((t) => t.replace(/^\s*@/, '').trim()).filter(Boolean);
+/** The editor for one transcript line: its words, label, place in the summary, tags and people. */
+async function editLine(ctx, n, index) {
+  const x = (n.transcript || [])[index];
+  if (!x) return;
+  const text = field({ label: 'Words', kind: 'textarea', value: x.text, attrs: { 'data-nt-ed-text': '' } });
+  const cat = field({ label: 'Label', kind: 'select', value: LABELS.some(([v]) => v === x.cat) ? x.cat : 'statement', options: LABELS.map(([value, label]) => ({ value, label })), attrs: { 'data-nt-ed-cat': '' } });
+  const sumv = x.in_summary === true ? 'in' : x.in_summary === false ? 'out' : 'auto';
+  const sum = field({ label: 'Summary', kind: 'select', value: sumv, options: [{ value: 'auto', label: 'As picked' }, { value: 'in', label: 'Always in the summary' }, { value: 'out', label: 'Never in the summary' }], attrs: { 'data-nt-ed-summary': '' } });
+  const tags = field({ label: 'Tags', value: (x.tags || []).map((t) => '#' + t).join(' '), placeholder: '#pricing #trial', attrs: { 'data-nt-ed-tags': '' } });
+  const ppl = field({ label: 'People', value: (x.people || []).join(', '), placeholder: 'Names, separated by commas', attrs: { 'data-nt-ed-people': '' } });
+  const sugg = el('div', { class: 'nt-row', 'data-nt-ed-suggest': '' });
+  const addPerson = (name) => {
+    const have = splitPeople(ppl.control.value);
+    if (!have.some((h) => h.toLowerCase() === name.toLowerCase())) ppl.control.value = [...have, name].join(', ');
+  };
+  const heard = x.orig_text !== undefined
+    ? el('div', { class: 'nt-heard', 'data-nt-ed-orig': '' }, el('p', { class: 'nt-hint' }, 'Heard as: ' + x.orig_text),
+      button({ label: 'Use what was heard', variant: 'ghost', size: 'sm', icon: 'undo-2', onClick: () => { text.control.value = x.orig_text; }, attrs: { 'data-nt-ed-restore': '' } }))
+    : null;
+  let h = null;
+  const save = async () => {
+    const patch = { id: n.id, index, tags: splitTags(tags.control.value), people: splitPeople(ppl.control.value) };
+    const t = text.control.value.replace(/\s+/g, ' ').trim();
+    if (t !== x.text) patch.text = t;
+    if (cat.control.value !== x.cat) patch.cat = cat.control.value;
+    if (sum.control.value !== sumv) patch.summary = sum.control.value === 'in' ? true : sum.control.value === 'out' ? false : null;
+    const r = await pmPost('/api/notes/line', patch);
+    if (r && r.ok) { n.transcript[index] = r.segment; if (r.summary) n.summary = r.summary; banner = null; h.close(); }
+    else banner = { tone: 'bad', text: (r && r.error) || 'the line was not changed' };
+    ctx.setState({});
+  };
+  h = sheet({ title: 'Correct this line', sub: speakerOf(n, x.source) + ', ' + fmtTime(x.t), body: [text, heard, cat, sum, tags, ppl, sugg], attrs: { 'data-nt-line-sheet': '' },
+    actions: [button({ label: 'Cancel', variant: 'ghost', onClick: () => h.close() }), button({ label: 'Save', variant: 'primary', onClick: save, attrs: { 'data-nt-ed-save': '' } })] });
+  const names = await peopleNames(ctx);
+  if (h.open && names.length) sugg.replaceChildren(...names.map((name) => button({ label: name, icon: 'plus', variant: 'ghost', size: 'sm', onClick: () => addPerson(name), attrs: { 'data-nt-ed-person': name } })));
+}
+async function unsummarize(ctx, n, index) {
+  const r = await pmPost('/api/notes/line', { id: n.id, index, summary: false });
+  if (r && r.ok) { n.transcript[index] = r.segment; if (r.summary) n.summary = r.summary; } else banner = { tone: 'bad', text: (r && r.error) || 'not changed' };
+  ctx.setState({});
+}
+/** Every kept version of the notes, newest first, each as the lines it changed from the one before. */
+function openHistory(ctx, n) {
+  const vs = n.versions || [];
+  const now = { at: n.updated_at, title: editor && editor.id === n.id ? editor.title.value : n.title, body: editor && editor.id === n.id ? editor.body.value : n.body, current: true };
+  const all = [...vs, now];
+  const when = (iso) => dayOf(iso) + ', ' + nowClock(iso);
+  let h = null;
+  const restore = (v) => {
+    h.close();
+    if (!editor || editor.id !== n.id) return;
+    editor.title.value = v.title || ''; editor.body.value = v.body || '';
+    banner = { tone: 'ok', text: 'The version from ' + when(v.at) + ' is back in your notes. The text before it is kept in History.' };
+    scheduleSave(ctx); ctx.setState({});
+  };
+  const items = all.map((v, i) => {
+    const diff = i === 0 ? String(v.body || '').split(/\r?\n/).map((t) => ({ op: 'same', text: t })) : lineDiff(all[i - 1].body, v.body);
+    const head = v.current ? 'Now' : i === 0 ? 'Original, ' + when(v.at) : 'Version ' + (i + 1) + ', ' + when(v.at);
+    return el('div', { class: 'nt-ver', 'data-nt-version': v.current ? 'now' : String(i) },
+      el('div', { class: 'nt-set__head' }, head, i > 0 && all[i - 1].title !== v.title ? el('span', { class: 'nt-hint' }, ' · title: ' + (v.title || 'Untitled')) : null),
+      el('div', { class: 'nt-diff' }, diff.map((d) => el('div', { class: 'nt-diff__ln nt-diff__ln--' + d.op, 'data-nt-diff': d.op },
+        el('span', { class: 'nt-sr' }, d.op === 'add' ? 'added: ' : d.op === 'del' ? 'removed: ' : ''), d.text || ' '))),
+      v.current ? null : button({ label: 'Use this version', variant: 'ghost', size: 'sm', icon: 'undo-2', onClick: () => restore(v), attrs: { 'data-nt-restore': String(i) } }));
+  }).reverse();
+  h = sheet({ title: 'History of your notes', sub: vs.length + ' earlier version' + (vs.length === 1 ? '' : 's') + '. The original is kept.', body: items, attrs: { 'data-nt-history-sheet': '' } });
+}
+function dropPlayer() { if (player) { try { player.el.pause(); } catch { /* gone */ } player = null; } }
+/** The replay of the note's kept audio. One <audio> per note, kept across redraws so playback goes on. */
+function playerFor(ctx, n) {
+  const rec = n.__recording;
+  if (!rec || n.private) { if (player && player.id === n.id) dropPlayer(); return null; }
+  if (player && (player.id !== n.id || (player.bytes !== rec.bytes && !player.playing))) dropPlayer();
+  if (player) return player;
+  const a = el('audio', { controls: true, preload: 'metadata', class: 'nt-audio', 'data-nt-audio': '', src: '/api/notes/recording?id=' + encodeURIComponent(n.id) + '&b=' + rec.bytes });
+  const p = { id: n.id, bytes: rec.bytes, el: a, playing: false };
+  a.addEventListener('play', () => { p.playing = true; ctx.setState({}); });
+  a.addEventListener('pause', () => { p.playing = false; ctx.setState({}); });
+  a.addEventListener('ended', () => { p.playing = false; ctx.setState({}); });
+  a.addEventListener('timeupdate', paintNow);
+  a.addEventListener('seeked', paintNow);
+  player = p;
+  return p;
+}
+function seek(ctx, n, ms) {
+  const p = playerFor(ctx, n);
+  if (!p) return;
+  try { p.el.currentTime = Math.max(0, ms / 1000); p.el.play().catch(() => {}); } catch { /* not loaded yet */ }
+  paintNow();
+}
+/** Highlight the transcript line, its item and the note line at the replay's time. Classes only: no redraw. */
+function paintNow() {
+  if (typeof document === 'undefined') return;
+  for (const x of document.querySelectorAll('.nt-now')) x.classList.remove('nt-now');
+  const n = currentId ? cache.get(currentId) : null;
+  if (!player || !n || player.id !== n.id) return;
+  const ms = player.el.currentTime * 1000;
+  if (!player.playing && !(ms > 0)) return;
+  const i = nowIndex((n.transcript || []).map((x) => x.t), ms);
+  if (i >= 0) {
+    for (const x of document.querySelectorAll('[data-nt-seg="' + i + '"], [data-nt-item="' + i + '"], [data-nt-ov="' + i + '"]')) x.classList.add('nt-now');
+    const ln = document.querySelector('[data-nt-seg="' + i + '"]');
+    if (ln && player.playing && ln.scrollIntoView) ln.scrollIntoView({ block: 'nearest' });
+  }
+  const k = noteLineAt(editor && editor.id === n.id ? editor.body.value : n.body, n.line_times, ms);
+  if (k >= 0) { const nl = document.querySelector('[data-nt-noteline="' + k + '"]'); if (nl) nl.classList.add('nt-now'); }
+}
+async function deleteAudio(ctx, n) {
+  const sure = await askConfirm({ title: 'Delete this note\'s audio?', body: 'The recording of "' + (n.title || 'Untitled note') + '" is deleted from this machine. The notes and the transcript stay. This cannot be undone.', confirmLabel: 'Delete audio', danger: true });
+  if (!sure) return;
+  if (player && player.id === n.id) dropPlayer();
+  const r = await pmPost('/api/notes/recording-delete', { id: n.id });
+  if (r && r.ok) { n.__recording = null; banner = { tone: 'ok', text: 'The audio was deleted. The notes and the transcript are kept.' }; }
+  else banner = { tone: 'bad', text: (r && r.error) || 'the audio was not deleted' };
+  ctx.setState({});
+}
+
 /* ── listening with local Whisper ─────────────────────────────────────────────────────────────── */
 async function openSource(kind) {
   const md = navigator.mediaDevices;
@@ -491,7 +669,9 @@ async function chooseSources(ctx, n) {
   const meet = field({ label: 'The meeting', kind: 'check', value: local, attrs: { 'data-nt-src-meeting': '', disabled: !local } });
   const body = [mic, meet,
     el('p', { class: 'nt-hint' }, local ? 'Pick the meeting\'s tab or window next, and tick "Share tab audio".' : 'The meeting can be heard once local transcription is set up in Settings. Until then the microphone is recognised by the browser on this device.'),
-    el('p', { class: 'nt-consent', 'data-nt-consent': '' }, 'Speech is transcribed on this ' + (local ? 'machine' : 'device') + '. Let people know you\'re taking notes.')];
+    el('p', { class: 'nt-consent', 'data-nt-consent': '' }, local
+      ? 'Speech is transcribed on this machine' + (eng.whisper.keep_audio === false ? ', and no audio is kept' : ', and the audio is kept on this machine so you can replay the meeting') + '. Let people know you\'re taking notes.'
+      : 'Speech is recognised by the browser on this device, and no audio is kept. Let people know you\'re taking notes.')];
   let h = null;
   const go = () => {
     const want = [mic.control.checked && 'mic', local && meet.control.checked && 'meeting'].filter(Boolean);
@@ -504,7 +684,7 @@ async function chooseSources(ctx, n) {
 }
 async function setSwitch(ctx, patch) {
   const ws = wsOf(ctx);
-  if (!ws && patch.language === undefined && patch.model === undefined) return;
+  if (!ws && patch.language === undefined && patch.model === undefined && patch.keep_audio === undefined) return;
   const r = await pmPost('/api/notes/switch', ws ? { ws, ...patch } : patch);
   if (r && r.ok) engine = { ws, whisper: r.whisper, jev: r.jev, at: Date.now() };
   ctx.setState({});
@@ -531,7 +711,12 @@ function openSettings(ctx, n) {
         onCommit: (v) => setSwitch(ctx, { model: v }).then(() => { h.close(); openSettings(ctx, n); }), attrs: { 'data-nt-model': '' } }) : null,
       w && !w.ready ? button({ label: 'Set up in a terminal', onClick: () => { h.close(); whisperSetup(ctx); }, attrs: { 'data-nt-whisper-setup': '' } }) : null,
       w && w.ready && w.languages ? field({ label: 'Language spoken in the meeting', kind: 'select', value: w.language, options: w.languages,
-        onCommit: (v) => setSwitch(ctx, { language: v }).then(() => { h.close(); openSettings(ctx, n); }), attrs: { 'data-nt-language': '' } }) : null));
+        onCommit: (v) => setSwitch(ctx, { language: v }).then(() => { h.close(); openSettings(ctx, n); }), attrs: { 'data-nt-language': '' } }) : null,
+      w ? field({ label: 'Keep the audio for replay', kind: 'check', value: w.keep_audio !== false,
+        onCommit: (v) => setSwitch(ctx, { keep_audio: v }).then(() => { h.close(); openSettings(ctx, n); }), attrs: { 'data-nt-keep-audio': '' } }) : null,
+      w ? el('p', { class: 'nt-hint', 'data-nt-keep-hint': '' }, w.keep_audio !== false
+        ? 'The meeting audio is kept on this machine, outside every repository, until you delete it. It is never sent anywhere. Browser recognition keeps no audio.'
+        : 'No audio is kept: each clip is deleted once it is transcribed, and a meeting cannot be replayed.') : null));
     if (!wsOf(ctx)) parts.push(el('p', { class: 'nt-hint' }, 'Choose a repository to check notes against it.'));
     else {
       const jsw = field({ label: 'Label lines with Jev', kind: 'check', value: !!(j && j.jev), onCommit: (v) => setSwitch(ctx, { jev: v }).then(() => { h.close(); openSettings(ctx, n); }), attrs: { 'data-nt-sw-jev': '' } });
@@ -546,6 +731,7 @@ function openSettings(ctx, n) {
       el('div', { class: 'nt-row' },
         button({ label: n.private ? 'Mark not private' : 'Mark private', onClick: () => { h.close(); setPrivate(ctx, n, !n.private); }, attrs: { [n.private ? 'data-nt-unprivate' : 'data-nt-mark-private']: '' } }),
         button({ label: busy === 'agent' ? 'Starting …' : 'Summary by agent', disabled: n.private || busy === 'agent', onClick: () => { h.close(); summarizeAgent(ctx, n); }, attrs: { 'data-nt-summarize-agent': '' } }),
+        n.__recording ? button({ label: 'Delete this note\'s audio', variant: 'ghost', onClick: () => { h.close(); deleteAudio(ctx, n); }, attrs: { 'data-nt-delete-audio': '' } }) : null,
         button({ label: 'Delete', variant: 'ghost', onClick: () => { h.close(); deleteNote(ctx, n); }, attrs: { 'data-nt-delete': '' } }))));
     return parts;
   };
@@ -584,7 +770,9 @@ function listening(n) {
 function header(ctx, n, ed) {
   const live = listening(n);
   const when = el('span', { class: 'nt-when' }, dayOf(n.created_at) + ', ' + nowClock(n.created_at));
-  const left = el('div', { class: 'nt-headl' }, ed.titleWrap, when, el('span', { class: 'nt-saved', 'data-nt-saved': '' }, saveWords()));
+  const nv = (n.versions || []).length;
+  const left = el('div', { class: 'nt-headl' }, ed.titleWrap, when, el('span', { class: 'nt-saved', 'data-nt-saved': '' }, saveWords()),
+    nv ? button({ label: 'Edited', icon: 'history', variant: 'ghost', size: 'sm', onClick: () => openHistory(ctx, n), attrs: { 'data-nt-history': String(nv), title: nv + ' earlier version' + (nv === 1 ? '' : 's') + ' kept' } }) : null);
   const acts = [];
   if (live) {
     acts.push(el('span', { class: 'nt-live', 'data-nt-listening': live.kind, role: 'status' },
@@ -622,6 +810,11 @@ function checkMark(x) {
   if (c.verdict === 'agrees') return el('span', { class: 'nt-ok', 'data-nt-check': 'agrees', title: 'Jev rates it ' + (c.words || 'likely') + ' that ' + where + ' already says this', role: 'img', 'aria-label': 'consistent with ' + baseName(c.doc) }, icon('check'));
   return el('span', { class: 'nt-rel', 'data-nt-check': 'related', title: 'The closest passage in this repository: ' + where }, 'see ' + baseName(c.doc));
 }
+function chips(x) {
+  return [...(x.tags || []).map((t) => el('span', { class: 'nt-tag', 'data-nt-tag': t }, '#' + t)),
+    ...(x.people || []).map((p) => el('span', { class: 'nt-tag nt-tag--person', 'data-nt-person': p }, '@' + p))];
+}
+const editedMark = (x) => (x.orig_text !== undefined ? el('span', { class: 'nt-edited', 'data-nt-edited': '', title: 'Heard as: ' + x.orig_text }, 'edited') : null);
 function sectionOf(ctx, n, key, title, items) {
   if (!items.length) return null;
   return el('section', { class: 'nt-sec', 'data-nt-sec': key },
@@ -629,9 +822,9 @@ function sectionOf(ctx, n, key, title, items) {
     el('ul', { class: 'nt-items' }, items.map((x) => el('li', { class: 'nt-item', 'data-nt-item': String(x.index) },
       el('span', { class: 'nt-item__text' },
         key === 'action' && x.source && x.source !== 'speech' ? el('span', { class: 'nt-who' }, speakerOf(n, x.source) + ': ') : null,
-        x.text, ' ', checkMark(x)),
+        x.text, ' ', checkMark(x), ' ', editedMark(x), chips(x)),
       el('span', { class: 'nt-at' }, fmtTime(x.t)),
-      key === 'fact' ? null : iconButton({ icon: 'x', ariaLabel: 'Remove from ' + title, onClick: () => unpick(ctx, n, x), size: 'sm', attrs: { 'data-nt-unpick': String(x.index) } })))));
+      key === 'fact' || key === 'tagged' ? null : iconButton({ icon: 'x', ariaLabel: 'Remove from ' + title, onClick: () => unpick(ctx, n, x), size: 'sm', attrs: { 'data-nt-unpick': String(x.index) } })))));
 }
 function summarySection(ctx, n) {
   const a = n.agent;
@@ -646,13 +839,19 @@ function summarySection(ctx, n) {
   else if (a && a.started === false && a.reason) out.push(el('p', { class: 'nt-hint', 'data-nt-agent-failed': '' }, 'No agent session started: ' + a.reason + '.'));
   if (!ov || !ov.length) return out.length ? el('section', { class: 'nt-sec' }, out) : null;
   return el('section', { class: 'nt-sec', 'data-nt-summary': 'local' }, el('h3', { class: 'nt-sec__h' }, 'Summary'),
-    el('ul', { class: 'nt-items' }, ov.map((x) => el('li', { class: 'nt-item nt-item--plain' }, el('span', { class: 'nt-item__text' }, x.text)))),
+    el('ul', { class: 'nt-items' }, ov.map((x) => el('li', { class: 'nt-item nt-item--plain', 'data-nt-ov': x.index === undefined ? null : String(x.index) }, el('span', { class: 'nt-item__text' }, x.text),
+      x.index === undefined ? null : iconButton({ icon: 'x', ariaLabel: 'Take out of the summary', onClick: () => unsummarize(ctx, n, x.index), size: 'sm', attrs: { 'data-nt-unsum': String(x.index) } })))),
     el('p', { class: 'nt-hint' }, 'Picked from what was said, on this machine.'), ...out);
 }
 function noteColumn(ctx, n, ed) {
   const live = listening(n);
   const c = caught(n);
-  const parts = [summarySection(ctx, n), ed.bodyWrap];
+  const replaying = player && player.id === n.id && player.playing;
+  const notes = replaying
+    ? el('div', { class: 'nt-notelines', 'data-nt-notelines': '' }, String(ed.body.value || '').split(/\r?\n/).map((l, k) => el('div', { class: 'nt-noteline', 'data-nt-noteline': String(k) }, l || ' ')),
+      el('p', { class: 'nt-hint' }, 'Your notes, as the meeting plays. Pause to edit them.'))
+    : ed.bodyWrap;
+  const parts = [summarySection(ctx, n), notes];
   const sp = speech && speech.id === n.id ? speech : null;
   const bar = [];
   if (sp && sp.mode === 'dictate' && sp.state === 'on') bar.push(el('span', { class: 'nt-hint', 'data-nt-listening': 'dictate', role: 'status' }, 'Dictating into your notes.'), button({ label: 'Stop dictating', variant: 'ghost', onClick: () => { stopSpeech(); ctx.setState({}); }, attrs: { 'data-nt-stop-dictate': '' } }));
@@ -663,6 +862,7 @@ function noteColumn(ctx, n, ed) {
   if (n.__audio && n.__audio.error && live) parts.push(el('p', { class: 'nt-hint nt-hint--bad', 'data-nt-audio-error': '' }, n.__audio.error));
   const secs = SECTIONS.map(([k, t]) => sectionOf(ctx, n, k, t, c[k])).filter(Boolean);
   if (!live && (n.transcript || []).length) { const f = sectionOf(ctx, n, 'fact', 'Facts mentioned', c.fact); if (f) secs.push(f); }
+  const tg = sectionOf(ctx, n, 'tagged', 'Tagged', tagged(n)); if (tg) secs.push(tg);
   if (secs.length) parts.push(...secs);
   else parts.push(el('p', { class: 'nt-hint', 'data-nt-caught-hint': '' }, live ? 'Listening …' : (n.transcript || []).length ? 'Nothing was caught as a decision, action or question.'
     : 'Decisions, actions and questions appear here as they are said, each checked against this repository.'));
@@ -677,8 +877,13 @@ function transcriptColumn(ctx, n) {
     const spk = x.source === 'meeting'
       ? button({ label: who, variant: 'ghost', size: 'sm', onClick: () => renameSpeaker(ctx, n, 'meeting'), attrs: { 'data-nt-spk': 'meeting', title: 'Name this speaker' } })
       : el('span', { class: 'nt-spk', 'data-nt-spk': x.source || 'speech' }, who);
-    return el('div', { class: 'nt-ln' + (['decision', 'action', 'question'].includes(x.cat) ? ' nt-ln--picked' : ''), 'data-nt-seg': String(i) },
-      el('div', { class: 'nt-ln__meta' }, spk, el('span', { class: 'nt-at' }, fmtTime(x.t)), lab), el('div', null, x.text));
+    const at = n.__recording && !live && typeof x.t === 'number'
+      ? button({ label: fmtTime(x.t), variant: 'ghost', size: 'sm', onClick: () => seek(ctx, n, x.t), attrs: { 'data-nt-seek': String(i), title: 'Play from here' } })
+      : el('span', { class: 'nt-at' }, fmtTime(x.t));
+    return el('div', { class: 'nt-ln' + (['decision', 'action', 'question', 'fact'].includes(x.cat) ? ' nt-ln--picked' : ''), 'data-nt-seg': String(i) },
+      el('div', { class: 'nt-ln__meta' }, spk, at, lab, editedMark(x),
+        iconButton({ icon: 'ellipsis', ariaLabel: 'Correct this line', onClick: () => editLine(ctx, n, i), size: 'sm', attrs: { 'data-nt-edit': String(i) } })),
+      el('div', null, x.text), x.tags || x.people ? el('div', { class: 'nt-tags' }, chips(x)) : null);
   });
   const sp = speech && speech.id === n.id && speech.mode === 'record' && speech.state === 'on' ? speech : null;
   if (sp) lines.push(el('div', { class: 'nt-ln nt-ln--interim', 'data-nt-interim': '', 'aria-live': 'polite' }, sp.interim || ''));
@@ -716,7 +921,11 @@ export function renderBoard(inner, ctx) {
     wrap.appendChild(header(ctx, n, ed));
     if (showList) wrap.appendChild(listPane(ctx));
     if (n.private) wrap.appendChild(el('p', { class: 'nt-hint', 'data-nt-private': '' }, 'This note is private: it is not recorded, and nothing from it goes to Jev or to any agent.'));
+    const pl = !listening(n) ? playerFor(ctx, n) : null;
+    if (pl) wrap.appendChild(el('div', { class: 'nt-replay', 'data-nt-part': 'replay' }, el('span', { class: 'nt-sec__h' }, 'Replay'), pl.el,
+      el('span', { class: 'nt-hint' }, 'Kept on this machine. Press a time in the transcript to play from there.')));
     wrap.appendChild(el('div', { class: 'nt-body2' }, noteColumn(ctx, n, ed), transcriptColumn(ctx, n)));
+    if (pl) queueMicrotask(paintNow);
     if (n.agent && n.agent.started && !n.agent.markdown && !agentTimer) pollAgent(ctx, n.id);
     requestAnimationFrame(fitBody);
   }

package/workspace/server.js

@@ -131,6 +131,7 @@ const focus = require('./lib/focus');                  // buildFocus(input) →
 const handoff = require('./lib/handoff');              // readLinks(parsedFrontmatterObject) — never a path
 const fourPanel = require('./lib/four-panel');         // GET /api/initiative — the one-initiative join + the declaration stores
 const docSyncStore = require('./lib/doc-sync-store');
+const docLibrary = require('./lib/doc-library');               // every repository file by category, and the links the files write (docs-library-graph)
 const peopleStore = require('./lib/people-store');           // people-directory (D90) — people.jsonl, folded on read
 // The session each repository's Check now started (workspace id → session id), so a second press while it runs refuses.
 const docCheckSessions = new Map();
@@ -6549,6 +6550,7 @@ async function handleRequest(req, res) {
     const docs = v.docs.map((d) => ({
       ...d,
       initiative: owner.get(d.path) || (d.initiative_id ? { id: d.initiative_id, title: d.initiative_id } : null),
+      category: docLibrary.categoryOf(d.path, d.type),
       links: d.links.map((l) => {
         if (l.syncing) return l;
         const ps = docSyncSessions.get(`${wid}|${d.path}|${l.kind}`);
@@ -6557,6 +6559,25 @@ async function handleRequest(req, res) {
     }));
     return json(res, { ...v, docs, ws: w ? w.id : null, session: live, connectors: fourPanel.connectors(os.homedir()) });
   }
+  // All files (docs-library-graph): every tracked markdown file by category, its initiative, and the links the files
+  // write (lib/doc-library.js over pmos kg). Kept in memory per repository state; nothing is written into the repository.
+  if (p === '/api/docs/library' && req.method === 'GET') {
+    const w = getWs(url.searchParams.get('ws'));
+    const root = w ? w.root : SELF_ROOT;
+    const owners = () => {
+      const own = new Map();
+      if (wsShape(root) !== 'pmos') return own;
+      const real = (id) => fs.existsSync(path.join(root, 'planning', 'initiatives', id + '.md'));
+      for (const g of initiativeIndex(root).initiatives) {
+        if (!real(g.id)) continue;
+        for (const a of g.artifacts) { const rel = String(a.path).split(path.sep).join('/'); if (!a.shared && !own.has(rel)) own.set(rel, { id: g.id, title: g.title || g.id }); }
+      }
+      return own;
+    };
+    const lib = docLibrary.library(root, { stateDir: STATE, owners });
+    if (!lib.ok) return json(res, lib, 400);
+    return json(res, { ...lib, ws: w ? w.id : null });
+  }
   if (p === '/api/docs/files' && req.method === 'GET') {
     const w = getWs(url.searchParams.get('ws'));
     const root = w ? w.root : SELF_ROOT;

package/workspace/test-lists/docs-library-graph.json

@@ -0,0 +1,5 @@
+{
+  "_comment": "docs-library-graph: every repository file by category in Docs, the links the files write, and an initiative's files as a network. The browser half runs in pm-docs-test.js (docs-three-way-sync's fragment).",
+  "modules": ["doc-library.test.js"],
+  "seconds": { "doc-library.test.js": 2 }
+}