create-pmos 0.65.0 → 0.65.2

package/workspace/public/pm/components.css

@@ -1784,6 +1784,17 @@
 .in-derived {
   margin-bottom: 16px;
 }
+.in-files__bar {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 12px;
+  margin-bottom: 12px;
+}
+.in-files__hint {
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
 .in-files__title,
 .in-derived__title {
   margin: 0;
@@ -4503,6 +4514,302 @@
   }
 }
 
+/* Docs › All files (docs-library-graph): folding categories, one line per file, the match marked, Add copy on hover. */
+.rp-docs-folds {
+  display: flex;
+  flex-direction: column;
+}
+.rp-docs-hint {
+  margin: 0;
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.rp-docs-mark {
+  background: var(--accent);
+  color: var(--foreground);
+}
+.rp-docs-path {
+  font-family: var(--mono);
+}
+.rp-docs-showall {
+  align-self: flex-start;
+  margin-top: 4px;
+}
+.rp-docs-links {
+  grid-column: 1 / -1;
+  padding: 4px 0 16px 24px;
+}
+.rp-docs-detail > .rp-docs-links {
+  padding-left: 0;
+}
+/* Add copy shows on hover or focus where the pointer can hover; without hover (a touch screen) it always shows. */
+@media (hover: hover) and (pointer: fine) {
+  .rp-docs-addcopy {
+    opacity: 0;
+  }
+  .rp-docs-row:hover .rp-docs-addcopy,
+  .rp-docs-row:focus-within .rp-docs-addcopy {
+    opacity: 1;
+  }
+}
+
+/* The links of one file: who links here on the left, what it links to on the right, lines behind real buttons. */
+.rp-graph {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 8px;
+  min-width: 0;
+}
+.rp-graph__head {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+}
+.rp-graph__title {
+  flex: 1 1 240px;
+  min-width: 0;
+  font-size: 14px;
+}
+.rp-graph__pic {
+  position: relative;
+  width: 100%;
+  max-width: 820px;
+  aspect-ratio: var(--rp-ar);
+  margin-top: 16px;
+}
+.rp-graph__lines {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  overflow: visible;
+}
+.rp-graph__edge {
+  fill: none;
+  stroke: var(--muted-foreground);
+  stroke-width: 1;
+}
+.rp-graph__edge--cites {
+  stroke-dasharray: 4 3;
+}
+.rp-graph__node,
+.rp-graph__centre,
+.rp-graph__more {
+  position: absolute;
+  left: calc(var(--rp-x) * 1%);
+  top: calc(var(--rp-y) * 1%);
+  width: calc(var(--rp-w) * 1%);
+  transform: translateY(-50%);
+}
+.rp-graph__node,
+.rp-graph__item,
+.rp-net__node {
+  letter-spacing: normal;
+  text-transform: none;
+}
+.rp-graph__node {
+  justify-content: flex-start;
+  background: var(--background);
+  font-size: 12px;
+}
+.rp-graph__node--in {
+  justify-content: flex-end;
+}
+.rp-graph__node--cites {
+  border-style: dashed;
+}
+.rp-graph__node:focus-visible {
+  outline: 2px solid color-mix(in oklab, var(--ring) 50%, var(--foreground));
+  outline-offset: 2px;
+}
+.rp-graph__centre {
+  padding: 6px 10px;
+  border: 1px solid var(--foreground);
+  background: var(--card);
+  font-size: 12px;
+  font-weight: 600;
+  text-align: center;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.rp-graph__more {
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.rp-graph__more--in {
+  text-align: right;
+}
+.rp-graph__cap {
+  position: absolute;
+  top: -20px;
+  font-size: 11px;
+  color: var(--muted-foreground);
+}
+.rp-graph__cap--out {
+  right: 0;
+}
+.rp-graph__lists {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 16px;
+  width: 100%;
+}
+.rp-graph__col,
+.rp-graph__group {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 2px;
+  min-width: 0;
+}
+.rp-graph__col {
+  gap: 12px;
+}
+.rp-graph__label {
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.rp-graph__item {
+  max-width: 100%;
+  justify-content: flex-start;
+}
+.rp-graph__hint {
+  margin: 0;
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+@media (max-width: 760px) {
+  .rp-graph__lists {
+    grid-template-columns: 1fr;
+  }
+}
+
+/* An initiative's files as a network: filled dots are its files, hollow dots the outside files they link to. */
+.rp-net {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.rp-net__pic {
+  position: relative;
+  width: 100%;
+  aspect-ratio: var(--rp-ar);
+  border: 1px solid var(--border);
+}
+.rp-net__lines {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+}
+.rp-net__edge {
+  stroke: var(--border);
+  stroke-width: 1;
+}
+.rp-net__edge--in {
+  stroke: var(--muted-foreground);
+}
+.rp-net__edge--cites {
+  stroke-dasharray: 4 3;
+}
+.rp-net__edge--hot {
+  stroke: var(--foreground);
+  stroke-width: 2;
+}
+.rp-net__node {
+  position: absolute;
+  left: calc(var(--rp-x) * 1%);
+  top: calc(var(--rp-y) * 1%);
+  height: auto;
+  min-height: 0;
+  padding: 2px 4px 2px 0;
+  transform: translate(-5px, -50%);
+  font-size: 11px;
+}
+.rp-net__node--in {
+  transform: translate(-7px, -50%);
+}
+.rp-net__node:focus-visible {
+  outline: 2px solid color-mix(in oklab, var(--ring) 50%, var(--foreground));
+  outline-offset: 2px;
+}
+.rp-net__node--sel .rp-net__label {
+  font-weight: 600;
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+.rp-net__label {
+  max-width: 140px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--muted-foreground);
+}
+.rp-net__node--sel .rp-net__label,
+.rp-net__dot--in + .rp-net__label {
+  color: var(--foreground);
+}
+.rp-net__dot {
+  display: inline-block;
+  flex: none;
+  margin-right: 4px;
+  vertical-align: middle;
+  width: 10px;
+  height: 10px;
+  border: 1px solid var(--muted-foreground);
+  border-radius: 50%;
+  background: var(--background);
+}
+.rp-net__dot--in {
+  width: 14px;
+  height: 14px;
+  border-color: var(--foreground);
+  background: var(--foreground);
+}
+.rp-net__dash {
+  display: inline-block;
+  width: 18px;
+  border-top: 1px dashed var(--muted-foreground);
+}
+.rp-net__legend {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 16px;
+  font-size: 12px;
+  color: var(--muted-foreground);
+}
+.rp-net__legend > span {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+}
+.rp-net__sel {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 12px;
+  padding: 8px 12px;
+  border: 1px solid var(--border);
+}
+.rp-net__sel-text {
+  display: flex;
+  flex: 1 1 240px;
+  flex-direction: column;
+  min-width: 0;
+  font-size: 14px;
+}
+.rp-net__path {
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--muted-foreground);
+  overflow-wrap: anywhere;
+}
+
 /* People (people-directory): what waits for the PM, the list beside the chosen person's page. */
 .rp-people {
   display: flex;

package/workspace/public/pm/dest-docs.js

@@ -6,13 +6,17 @@
  * only the body is rebuilt when its own data changed.
  *
  * What it shows, for the repository the tab names (or the open one):
- *   - Docs, a search box, Needs you · All, and when the copies were last compared, with a control that compares again;
- *   - the copies grouped by initiative, ONE line per copy: a status dot, the title, a link that opens the copy, one
+ *   - Docs, a search box, Needs you · With a copy · All files, and when the copies were last compared, with a control
+ *     that compares again;
+ *   - the copies grouped by category, ONE line per copy: a status dot, the title, a link that opens the copy, one
  *     sentence (which side is newer, and who edited it last) and at most one button (Use PMOS version, Use Confluence
  *     version, or Choose… when both changed);
  *   - a click on a line: both sides with where they live and their last edit, a Use … version button for each, the first
- *     difference the check saw, Compare again and Stop tracking this copy;
- *   - search: every markdown file that matches; a file without a copy offers Add copy, in place.
+ *     difference the check saw, Compare again, Stop tracking this copy, and the file's links (doc-graph.js);
+ *   - All files (docs-library-graph): every repository file under folding categories, each line naming its initiative;
+ *     a category opens on its first 20 files. A press on a file shows the files it links to and the files that link to
+ *     it. Add copy shows on hover or focus, and always on a touch screen;
+ *   - search: every file whose title, path or initiative matches, grouped by category, with the match marked.
  * The signal is decided on the server (lib/doc-sync.js) from what a check session read. Nothing here reads or writes
  * Google Docs or Confluence. Use … version waits five seconds behind Undo, then asks the server to start ONE doc-sync
  * session for that copy, which writes one side with the PM's own connectors (the PM's ruling, amended 2026-10-06).
@@ -21,13 +25,20 @@
 
 import { el } from './dom.js';
 import { button, row, field, toast, empty, tabs, ensureComponentsCss } from './primitives.js';
-import { ensureSprite } from './icons.js';
+import { ensureSprite, icon } from './icons.js';
 import { pmGet, pmPost } from './http.js';
 import { wsOf } from './data.js';
 import { registerCommand, openDestination } from './registry.js';
+import { getLibrary, fileGraph } from './doc-graph.js';
+import { openDoc } from './panel-initiatives.js';
 
 const LABEL = { google: 'Google Docs', confluence: 'Confluence' };
 const UNDO_MS = 5000;
+const PAGE = 20;
+/* the library's categories, in display order (lib/doc-library.js CATEGORIES) */
+const CATS = [['spec', 'Specs'], ['ini', 'Initiatives'], ['dec', 'Decisions'], ['res', 'Research & plans'], ['exp', 'Explainers'],
+  ['eval', 'Evals'], ['know', 'Knowledge'], ['guide', 'Guides & rules'], ['proto', 'Prototypes']];
+const CAT_NAME = Object.fromEntries(CATS);
 
 export const COPY = Object.freeze({
   title: 'Docs',
@@ -36,20 +47,25 @@ export const COPY = Object.freeze({
   loading: 'Reading…',
   readError: 'The documents could not be read.',
   find: 'Find a document',
+  findIn: (n) => `Find in ${n.toLocaleString('en-US')} files`,
   needs: 'Needs you',
-  all: 'All',
+  copies: 'With a copy',
+  files: 'All files',
+  readingFiles: 'Reading the files…',
+  filesError: 'The file list could not be read.',
+  matches: (n, all) => `${n} of ${all.toLocaleString('en-US')} files match by title, path or initiative. Press Esc to clear.`,
+  showAll: (n, cat) => `Show all ${n} in ${cat}`,
+  needYou: (n) => `${n} need${n === 1 ? 's' : ''} you`,
   compared: (iso) => 'Compared ' + ago(iso),
   never: 'Not compared yet',
   comparing: 'Comparing…',
   compareAll: 'Compare every copy again',
-  none: 'No document has a copy yet. Find a document above and press Add copy.',
+  none: 'No document has a copy yet. Open All files and press Add copy on a file.',
   nothingNeeds: 'Nothing needs you. Every copy matches PMOS.',
   noMatch: (q) => `No document matches “${q}”.`,
-  other: 'Other',
   usePmos: 'Use PMOS version',
   useCopy: (label) => `Use ${label} version`,
   choose: 'Choose…',
-  noCopy: 'No copy',
   addCopy: 'Add copy',
   add: 'Add',
   cancel: 'Cancel',
@@ -91,6 +107,23 @@ function when(iso) {
   if (days > 1 && days < 7) return t.toLocaleDateString('en-US', { weekday: 'short' }) + ' ' + hm;
   return t.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
 }
+/** A file's last edit from its YYYY-MM-DD date: "Oct 6", or "Oct 6, 2025" in another year. */
+function day(d) {
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(String(d || ''));
+  if (!m) return '';
+  const t = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+  return t.toLocaleDateString('en-US', { month: 'short', day: 'numeric', ...(t.getFullYear() !== new Date().getFullYear() ? { year: 'numeric' } : {}) });
+}
+/** The text with every match of q marked. */
+function marked(text, q) {
+  const t = String(text || '');
+  if (!q) return t;
+  const out = []; const low = t.toLowerCase(); let at = 0;
+  for (let k = low.indexOf(q); k >= 0 && q; k = low.indexOf(q, at)) { out.push(t.slice(at, k), el('mark', { class: 'rp-docs-mark' }, t.slice(k, k + q.length))); at = k + q.length; }
+  out.push(t.slice(at));
+  return out;
+}
+const openFile = (p) => openDoc(null, p, 'FILE');
 const edit = (by, at) => [by, at ? when(at) : null].filter(Boolean).join(', ');
 const keyOf = (doc, link) => `${doc.path}|${link.kind}`;
 /** Which kind a pasted address names. The server checks it again; this only picks the kind. */
@@ -134,7 +167,8 @@ export function mountDestination(host, ctx) {
   if (!inst) {
     inst = { host, root: el('div', { class: 'rp-page rp-docs', 'data-docs': '' }), head: null, body: el('div', { class: 'rp-docs-body' }),
       ws: null, loaded: false, error: null, view: null, filter: 'needs', q: '', files: [], open: null, adding: null,
-      pending: new Map(), busy: false, seq: 0, fseq: 0, last: '', timer: null, ftimer: null };
+      pending: new Map(), busy: false, seq: 0, fseq: 0, last: '', timer: null, ftimer: null,
+      lib: null, libError: null, openCats: new Set(), full: new Set(), graph: null };
     insts.set(host, inst);
   }
   ensureComponentsCss();
@@ -144,7 +178,8 @@ export function mountDestination(host, ctx) {
   const ws = repo ? wsOf(repo) : null;
   if (ws !== inst.ws) {
     stopPoll(inst);
-    Object.assign(inst, { ws, loaded: false, error: null, view: null, last: '', open: null, adding: null, files: [] });
+    Object.assign(inst, { ws, loaded: false, error: null, view: null, last: '', open: null, adding: null, files: [], lib: null, libError: null, graph: null });
+    inst.openCats.clear(); inst.full.clear();
     if (ws) { ensureSprite(); refresh(inst); }
     draw(inst);
     return;
@@ -177,8 +212,9 @@ async function refresh(inst) {
   if (!ws) return;
   const seq = ++inst.seq;
   inst.readAt = Date.now();
-  const v = await pmGet('/api/docs?ws=' + encodeURIComponent(ws));
+  const [v, lib] = await Promise.all([pmGet('/api/docs?ws=' + encodeURIComponent(ws)), getLibrary(ws)]);
   if (seq !== inst.seq || ws !== inst.ws) return;
+  if (lib) { inst.lib = lib; inst.libError = null; } else if (!inst.lib) inst.libError = COPY.filesError;
   inst.loaded = true;
   if (!v || v.ok === false) { inst.error = (v && v.error) || COPY.readError; inst.view = null; }
   else { inst.error = null; inst.view = v; }
@@ -190,7 +226,7 @@ async function refresh(inst) {
 function searchFiles(inst) {
   if (inst.ftimer) clearTimeout(inst.ftimer);
   const q = inst.q.trim();
-  if (!q) { inst.files = []; return; }
+  if (!q || inst.lib) { inst.files = []; return; }
   inst.ftimer = setTimeout(async () => {
     const seq = ++inst.fseq;
     const r = await pmGet('/api/docs/files?ws=' + encodeURIComponent(inst.ws) + '&q=' + encodeURIComponent(q));
@@ -252,7 +288,7 @@ async function addCopy(inst, path, target, err) {
 
 /* ── lines ───────────────────────────────────────────────────────────────────────────────────────────────────────── */
 
-function copyLine(inst, doc, link) {
+function copyLine(inst, doc, link, q = '') {
   const key = keyOf(doc, link);
   const L = link.label || LABEL[link.kind];
   const st = stateOf(inst, doc, link);
@@ -270,7 +306,7 @@ function copyLine(inst, doc, link) {
     ? el('a', { class: 'rp-docs-open', href: link.url, target: '_blank', rel: 'noopener noreferrer', 'data-docs-open': link.kind }, L + ' ↗')
     : el('span', { class: 'rp-docs-open' }, L);
   const line = row({
-    title: doc.title,
+    title: marked(doc.title, q),
     meta: [st.strong, st.rest].filter(Boolean),
     lead: [el('span', { class: 'rp-docs-dot rp-docs-dot--' + st.dot, 'aria-hidden': 'true' })],
     trail: [opener, act].filter(Boolean),
@@ -304,6 +340,7 @@ function details(inst, doc, link, st) {
     side('PMOS', doc.path, edit(doc.repo && doc.repo.modified_by, doc.repo && doc.repo.modified_at), pNew, 'pmos'),
     side(L, link.target, edit(link.remote_modified_by, link.remote_modified_at), cNew, 'copy'),
     diff,
+    inst.lib && inst.lib.byPath.has(doc.path) ? el('div', { class: 'rp-docs-links' }, fileGraph(inst.lib, doc.path, { onOpen: openFile })) : null,
     el('div', { class: 'rp-docs-more' },
       button({ label: COPY.compareAgain, variant: 'ghost', size: 'sm', disabled: !!(inst.view && (inst.view.open || inst.view.session)) || inst.busy,
         attrs: { 'data-docs-act': 'compare-one' }, onClick: () => compareAll(inst) }),
@@ -311,18 +348,28 @@ function details(inst, doc, link, st) {
         onClick: () => stopTracking(inst, doc, link) })));
 }
 
-/** A file with no copy: "No copy" and Add copy, which opens a paste field in place. */
-function fileLine(inst, f) {
-  const start = () => { inst.adding = f.path; draw(inst); };
+/**
+ * A file with no copy: its title, its initiative's short name (or its path) and the date of its last edit. A press shows
+ * its links; Add copy opens a paste field in place.
+ */
+function fileLine(inst, f, q = '') {
+  const start = () => { inst.adding = f.path; inst.graph = null; draw(inst); };
   const adding = inst.adding === f.path;
+  const open = inst.graph === f.path;
+  const toggle = () => { inst.graph = open ? null : f.path; draw(inst); };
+  const ini = inst.lib && f.initiative ? inst.lib.ini(f) : null;
   const line = row({
-    title: f.title,
-    meta: [COPY.noCopy],
+    title: marked(f.title, q),
+    meta: [ini ? el('span', { class: 'rp-docs-ini', title: ini.title }, marked(ini.short, q)) : el('span', { class: 'rp-docs-path' }, marked(f.path, q)), day(f.date)],
     lead: [el('span', { class: 'rp-docs-dot rp-docs-dot--none', 'aria-hidden': 'true' })],
-    trail: adding ? [] : [button({ label: COPY.addCopy, variant: 'outline', size: 'sm', attrs: { 'data-docs-act': 'add-copy', 'data-docs-key': f.path }, onClick: start })],
+    trail: adding ? [] : [button({ label: COPY.addCopy, variant: 'outline', size: 'sm', attrs: { class: 'rp-docs-addcopy', 'data-docs-act': 'add-copy', 'data-docs-key': f.path }, onClick: start })],
+    onOpen: inst.lib ? toggle : null,
+    openLabel: `${f.title}: show the files it links to`,
+    openAttrs: { 'aria-expanded': open ? 'true' : 'false', title: f.path, 'data-docs-file-toggle': f.path },
     attrs: { 'data-docs-file-line': f.path, title: f.path },
   });
   const wrap = el('div', { class: 'rp-docs-row', role: 'listitem', 'data-docs-file': f.path }, line);
+  if (open && inst.lib) wrap.appendChild(el('div', { class: 'rp-docs-links' }, fileGraph(inst.lib, f.path, { onOpen: openFile })));
   if (!adding) return wrap;
   const err = el('span', { class: 'rp-docs-add__err', role: 'alert' });
   const inp = field({ label: `Copy of ${f.title}`, hideLabel: true, placeholder: COPY.paste, attrs: { 'data-docs-field': 'target' } });
@@ -344,57 +391,110 @@ function header(inst) {
   if (inst.head) return inst.head;
   const find = field({ label: COPY.find, hideLabel: true, placeholder: COPY.find, attrs: { 'data-docs-find': '' } });
   const q = find.control;
-  q.addEventListener('input', () => { inst.q = q.value; inst.open = null; inst.adding = null; searchFiles(inst); draw(inst); });
+  inst.findControl = q;
+  q.addEventListener('input', () => { inst.q = q.value; inst.open = null; inst.adding = null; inst.graph = null; inst.full.clear(); searchFiles(inst); draw(inst); });
   // The field restores its last committed text on Escape; here Escape clears the search instead.
-  q.addEventListener('keydown', (e) => { if (e.key === 'Escape') { q.resetCommitted(''); inst.q = ''; searchFiles(inst); draw(inst); } });
+  q.addEventListener('keydown', (e) => { if (e.key === 'Escape') { q.resetCommitted(''); inst.q = ''; inst.graph = null; searchFiles(inst); draw(inst); } });
   inst.head = el('div', { class: 'rp-docs-top' }, el('h2', { class: 'rp-head__title' }, COPY.title), el('div', { class: 'rp-docs-find' }, find));
   return inst.head;
 }
 
-function grouped(inst, docs) {
-  const by = new Map();
-  for (const d of docs) {
-    const k = d.initiative ? d.initiative.id : '';
-    if (!by.has(k)) by.set(k, { title: d.initiative ? d.initiative.title : COPY.other, docs: [] });
-    by.get(k).docs.push(d);
+const needsYou = (inst, d, l) => l.signal !== 'same' || !!l.syncing || inst.pending.has(keyOf(d, l));
+
+/**
+ * One category: its title (a fold when `foldable`), then its lines — files with a copy first, then newest first; the
+ * first 20, then Show all. `entries` are { f, doc }: f the file, doc its copies (null for a file with none).
+ */
+function section(inst, key, entries, { q = '', foldable = false, page = true } = {}) {
+  const name = CAT_NAME[key] || key;
+  const open = !foldable || inst.openCats.has(key);
+  const copies = entries.reduce((n, e) => n + (e.doc ? e.doc.links.length : 0), 0);
+  const needs = entries.reduce((n, e) => n + (e.doc ? e.doc.links.filter((l) => needsYou(inst, e.doc, l)).length : 0), 0);
+  const toggle = () => { if (inst.openCats.has(key)) inst.openCats.delete(key); else inst.openCats.add(key); draw(inst); };
+  const head = foldable
+    ? row({ title: name, meta: [String(entries.length), needs ? COPY.needYou(needs) : null], lead: [icon(open ? 'chevron-down' : 'chevron-right')],
+      onOpen: toggle, openLabel: `${name}, ${entries.length} files${needs ? ', ' + COPY.needYou(needs) : ''}`,
+      openAttrs: { 'aria-expanded': open ? 'true' : 'false', 'data-docs-cat-toggle': key }, attrs: { class: 'rp-docs-cat', 'data-docs-cat': key, 'data-docs-count': String(entries.length) } })
+    : el('h3', { class: 'rp-docs-group__title' }, `${name} · ${entries.length}`);
+  const box = el('section', { class: 'rp-docs-group', 'data-docs-group': key }, head);
+  if (!open) return box;
+  const sorted = entries.slice().sort((a, b) => (!!b.doc - !!a.doc) || String(b.f.date || '').localeCompare(String(a.f.date || '')) || a.f.path.localeCompare(b.f.path));
+  const all = !page || inst.full.has(key);
+  const shown = all ? sorted : sorted.slice(0, PAGE);
+  const list = el('div', { role: 'list' }, shown.flatMap((e) => (e.doc ? e.doc.links.map((l) => copyLine(inst, e.doc, l, q)) : [fileLine(inst, e.f, q)])));
+  box.appendChild(list);
+  if (shown.length < sorted.length) {
+    box.appendChild(button({ label: COPY.showAll(sorted.length, name), variant: 'ghost', size: 'sm', attrs: { class: 'rp-docs-showall', 'data-docs-act': 'show-all', 'data-docs-key': key },
+      onClick: () => { inst.full.add(key); draw(inst); } }));
   }
-  return [...by.entries()].sort((a, b) => (a[0] === '') - (b[0] === '')).map(([k, g]) =>
-    el('section', { class: 'rp-docs-group', 'data-docs-group': k || 'other' },
-      el('h3', { class: 'rp-docs-group__title' }, g.title),
-      el('div', { role: 'list' }, g.docs.flatMap((d) => d.links.map((l) => copyLine(inst, d, l))))));
+  return box;
+}
+
+/** Entries grouped by category, in the categories' order. */
+function byCategory(entries) {
+  const by = new Map();
+  for (const e of entries) { const k = CAT_NAME[e.f.category] ? e.f.category : 'guide'; if (!by.has(k)) by.set(k, []); by.get(k).push(e); }
+  return CATS.map(([k]) => [k, by.get(k)]).filter(([, es]) => es && es.length);
+}
+
+/** Every file: the library's, with each one's copies, plus a file with a copy the library does not list yet. */
+function allEntries(inst) {
+  const v = inst.view;
+  const docOf = new Map(v.docs.map((d) => [d.path, d]));
+  const out = inst.lib ? inst.lib.files.map((f) => ({ f, doc: docOf.get(f.path) || null })) : [];
+  const listed = new Set(out.map((e) => e.f.path));
+  for (const d of v.docs) if (!listed.has(d.path)) out.push({ f: { path: d.path, title: d.title, category: d.category, date: null, initiative: null }, doc: d });
+  return out;
 }
 
 function body(inst) {
   const v = inst.view;
   const q = inst.q.trim().toLowerCase();
+  const lib = inst.lib;
+  if (inst.findControl) inst.findControl.placeholder = lib ? COPY.findIn(lib.files.length) : COPY.find;
   if (q) {
-    const hits = v.docs.filter((d) => [d.title, d.path, d.initiative ? d.initiative.title : ''].join(' ').toLowerCase().includes(q));
-    const rows = [...hits.flatMap((d) => d.links.map((l) => copyLine(inst, d, l))), ...inst.files.map((f) => fileLine(inst, f))];
-    return rows.length ? [el('div', { role: 'list', class: 'rp-docs-group', 'data-docs-results': '' }, rows)] : [el('p', { class: 'rp-section__empty' }, COPY.noMatch(inst.q.trim()))];
+    if (!lib) {
+      const hits = v.docs.filter((d) => [d.title, d.path, d.initiative ? d.initiative.title : ''].join(' ').toLowerCase().includes(q));
+      const rows = [...hits.flatMap((d) => d.links.map((l) => copyLine(inst, d, l, q))), ...inst.files.map((f) => fileLine(inst, f, q))];
+      return rows.length ? [el('div', { role: 'list', class: 'rp-docs-group', 'data-docs-results': '' }, rows)] : [el('p', { class: 'rp-section__empty' }, COPY.noMatch(inst.q.trim()))];
+    }
+    const hay = (e) => { const ini = e.f.initiative ? lib.ini(e.f) : null; return [e.f.title, e.f.path, ini ? ini.short + ' ' + ini.title : ''].join(' ').toLowerCase(); };
+    const hits = allEntries(inst).filter((e) => hay(e).includes(q));
+    if (!hits.length) return [el('p', { class: 'rp-section__empty' }, COPY.noMatch(inst.q.trim()))];
+    return [el('p', { class: 'rp-docs-hint', 'data-docs-results': String(hits.length) }, COPY.matches(hits.length, lib.files.length)),
+      ...byCategory(hits).map(([k, es]) => section(inst, k, es, { q }))];
   }
   const all = v.docs.reduce((n, d) => n + d.links.length, 0);
-  const needs = v.docs.reduce((n, d) => n + d.links.filter((l) => l.signal !== 'same' || l.syncing).length, 0);
+  const needs = v.docs.reduce((n, d) => n + d.links.filter((l) => needsYou(inst, d, l)).length, 0);
   const running = !!(v.open || v.session) || inst.busy;
   const out = [el('div', { class: 'rp-docs-views' },
-    tabs({ variant: 'line', items: [{ id: 'needs', label: COPY.needs, count: needs }, { id: 'all', label: COPY.all, count: all }],
-      value: inst.filter, ariaLabel: 'Filter', attrs: { 'data-docs-filter': '' }, onChange: (val) => { inst.filter = val; draw(inst); } }),
+    tabs({ variant: 'line', items: [{ id: 'needs', label: COPY.needs, count: needs }, { id: 'copies', label: COPY.copies, count: all },
+      { id: 'files', label: COPY.files, count: lib ? lib.files.length.toLocaleString('en-US') : null }],
+    value: inst.filter, ariaLabel: 'Filter', attrs: { 'data-docs-filter': '' }, onChange: (val) => { inst.filter = val; inst.graph = null; draw(inst); } }),
     el('span', { class: 'rp-docs-when', 'data-docs-summary': '' },
       running ? COPY.comparing : (v.last ? COPY.compared(v.last.finished_at) : COPY.never),
       button({ label: '↻', variant: 'ghost', size: 'sm', disabled: running || !all,
         attrs: { 'data-docs-act': 'check', 'aria-label': COPY.compareAll, title: COPY.compareAll }, onClick: () => compareAll(inst) })))];
+  if (inst.filter === 'files') {
+    if (!lib) { out.push(el('p', { class: 'rp-section__empty' + (inst.libError ? ' rp-section__empty--bad' : '') }, inst.libError || COPY.readingFiles)); return out; }
+    out.push(el('div', { class: 'rp-docs-folds' }, byCategory(allEntries(inst)).map(([k, es]) => section(inst, k, es, { foldable: true }))));
+    return out;
+  }
   if (!v.docs.length) { out.push(el('p', { class: 'rp-section__empty' }, COPY.none)); return out; }
-  const shown = inst.filter === 'needs'
-    ? v.docs.map((d) => ({ ...d, links: d.links.filter((l) => l.signal !== 'same' || l.syncing || inst.pending.has(keyOf(d, l))) })).filter((d) => d.links.length)
+  const docs = inst.filter === 'needs'
+    ? v.docs.map((d) => ({ ...d, links: d.links.filter((l) => needsYou(inst, d, l)) })).filter((d) => d.links.length)
     : v.docs;
-  if (!shown.length) { out.push(el('p', { class: 'rp-section__empty' }, COPY.nothingNeeds)); return out; }
-  out.push(...grouped(inst, shown));
+  if (!docs.length) { out.push(el('p', { class: 'rp-section__empty' }, COPY.nothingNeeds)); return out; }
+  const libFile = (d) => (lib && lib.byPath.has(d.path) ? lib.files[lib.byPath.get(d.path)] : { path: d.path, title: d.title, category: d.category, date: null });
+  out.push(...byCategory(docs.map((d) => ({ f: libFile(d), doc: d }))).map(([k, es]) => section(inst, k, es, { page: false })));
   return out;
 }
 
 function draw(inst) {
   const root = inst.root;
   if (!inst.ws) { root.replaceChildren(empty({ text: COPY.noRepo })); inst.last = 'none'; return; }
-  const fp = JSON.stringify([inst.loaded, inst.error, inst.view, inst.filter, inst.busy, inst.q, inst.files, inst.open, inst.adding, [...inst.pending.keys()]]);
+  const fp = JSON.stringify([inst.loaded, inst.error, inst.view, inst.filter, inst.busy, inst.q, inst.files, inst.open, inst.adding, [...inst.pending.keys()],
+    inst.lib ? inst.lib.key : null, inst.libError, [...inst.openCats], [...inst.full], inst.graph]);
   if (fp === inst.last && root.childNodes.length && root.contains(inst.body)) return;
   inst.last = fp;
   const head = header(inst);

package/workspace/public/pm/dest-today.js

@@ -143,14 +143,14 @@ function build(ctx0) {
   const dayWs = dayRepo ? wsOf(dayRepo) : null;
   const prep = onPhone && !(window.pmDeck && window.pmDeck.phoneView('today') === 'day') ? prepCard(dayWs) : null;
   if (prep) { prep.setAttribute('role', 'listitem'); const none = list.querySelector('[data-today="empty"]'); if (none) none.setAttribute('data-today-id', 'empty'); list.prepend(prep); }   // the empty note stays, as the deck's last card
-  // the open day takes the list into its left column ("Also waiting for you"), so Today shows one layout; a folded day
-  // leaves it below, as before
-  const owed = { list, more, count: n };
+  // the open day takes the cards into its jobs (rows of Needs you; a pressed row shows its card), so Today shows one layout; a folded day
+  // leaves it below, as before. A phone does not draw the day, so its deck keeps every card
+  const owed = onPhone ? null : { list, more, count: n };
   // one day for every repository: the day is the same everywhere; the Show switch narrows it to the repository Today
   // was opened from (`here`) or shows all of it
   const here = sc.repo ? wsOf(sc.repo) : null;
   const day = daySection({ ws: dayWs, setState: ctx0.setState || setState, openIni: dayRepo ? (id) => openInitiative(dayRepo, id) : null, owed, here, all: sc.all });
-  const inDay = !!(day && day.contains(list));
+  const inDay = !!(day && owed && owed.taken);
   return { children: inDay ? [head, day, health] : [head, day, health, list, more], sig: JSON.stringify([sc.all, sc.repo, n, ready, expanded, banner, onPhone, prep ? prep.outerHTML : null]) + daySig(dayWs) + nodes.map((x) => x.outerHTML).join('') };
 }