create-pmos 0.61.1 → 0.63.0

package/workspace/public/pm/people-link.js

@@ -0,0 +1,106 @@
+/* pm/people-link.js — the ways into People from other places (initiative people-directory, PRD R12 and R13).
+ *
+ *   peopleOf(ws)            → Promise<view | null>   the /api/people view, read at most every few seconds per repository
+ *   namedIn(view, text)     → people                 the people a free-text line names (an Agenda `with`, an item owner)
+ *   personLink(person)      → a button that opens the person's page in People
+ *   openPerson(id)          → opens People on that person
+ *   forgetPeople(ws)        → drop the cached view (People calls it after a press)
+ *
+ * The matching rule is lib/people.js matchPeople's, in the browser: a person's full name, a first name of three letters
+ * or more, or a name, speaker, chat or Jira handle, as a whole word, ignoring case. Two people with one first name both
+ * match; each link names the person in full.
+ */
+
+import { el } from './dom.js';
+import { button, row } from './primitives.js';
+import { pmGet } from './http.js';
+import { openDestination } from './registry.js';
+
+const FRESH_MS = 10000;
+const cache = new Map();   // ws -> { at, promise }
+
+export function peopleOf(ws) {
+  if (!ws) return Promise.resolve(null);
+  const c = cache.get(ws);
+  if (c && Date.now() - c.at < FRESH_MS) return c.promise;
+  const promise = pmGet('/api/people?ws=' + encodeURIComponent(ws)).then((v) => (v && v.ok !== false ? v : null), () => null);
+  cache.set(ws, { at: Date.now(), promise });
+  return promise;
+}
+export function forgetPeople(ws) { if (ws) cache.delete(ws); else cache.clear(); }
+
+const fold = (s) => String(s || '').replace(/\s+/g, ' ').trim();
+const escRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+function names(hay, needle) {
+  const n = fold(needle);
+  if (n.length < 2) return false;
+  return new RegExp(`(^|[^\\p{L}\\p{N}])${escRe(n)}($|[^\\p{L}\\p{N}])`, 'iu').test(String(hay || ''));
+}
+function words(p) {
+  const w = new Set();
+  const full = fold(p.name);
+  if (full) w.add(full);
+  const first = full.split(' ')[0];
+  if (first && first.length >= 3 && first !== full) w.add(first);
+  for (const h of p.handles || []) if (['name', 'speaker', 'slack', 'jira'].includes(h.kind)) w.add(fold(h.value).replace(/^@/, ''));
+  return [...w].filter((x) => x.length >= 2);
+}
+export function namedIn(view, text) {
+  if (!view || !text) return [];
+  return (view.people || []).filter((p) => words(p).some((w) => names(text, w)));
+}
+
+export function openPerson(id) { return openDestination('people', { slug: id }); }
+
+export function personLink(p, { size = 'sm' } = {}) {
+  return button({ label: p.name, variant: 'ghost', size, iconEnd: 'chevron-right',
+    attrs: { 'data-person-link': p.id, 'aria-label': `Open ${p.name} in People` }, onClick: () => openPerson(p.id) });
+}
+
+/**
+ * A holder that fills with one link per person `text` names, once the repository's people are read. Empty (and hidden
+ * by having no children) when nobody matches, so a place with no People records looks as it did before.
+ */
+export function peopleLinks(ws, text, attrs) {
+  const holder = el('span', { class: 'rp-people-links', 'data-people-links': '', ...(attrs || {}) });
+  if (!ws || !text) return holder;
+  peopleOf(ws).then((v) => {
+    const found = namedIn(v, text);
+    if (found.length) holder.replaceChildren(...found.map((p) => personLink(p)));
+  });
+  return holder;
+}
+
+const REL = {
+  reading: 'Reading…',
+  none: 'Nobody in People owns an item of this initiative or is named in an interaction about it.',
+  owns: (n) => `Owns ${n} item${n === 1 ? '' : 's'}`,
+  blocked: (n) => `${n} blocked`,
+  named: (n) => `Named in ${n} interaction${n === 1 ? '' : 's'}`,
+};
+
+/**
+ * The initiative sheet's People tab (R13): the people whose interactions name the initiative or who own one of its
+ * items, with how they relate. `onOpen` runs before the person opens (the sheet closes itself).
+ */
+export function initiativePeople(ws, slug, { onOpen } = {}) {
+  const box = el('div', { class: 'rp-people-rel', 'data-people-initiative': slug || '' }, el('p', { class: 'rp-people-hint' }, REL.reading));
+  peopleOf(ws).then((v) => {
+    const out = [];
+    for (const p of (v && v.people) || []) {
+      const items = p.shared.items.filter((it) => it.initiative === slug);
+      const named = p.shared.initiatives.find((g) => g.id === slug);
+      if (!items.length && !named) continue;
+      const blocked = items.filter((it) => it.blocked).length;
+      const meta = [items.length ? REL.owns(items.length) : null, blocked ? REL.blocked(blocked) : null, named ? REL.named(named.count) : null].filter(Boolean);
+      out.push({ p, meta, weight: items.length * 10 + blocked * 5 + (named ? named.count : 0) });
+    }
+    out.sort((a, b) => b.weight - a.weight || a.p.name.localeCompare(b.p.name));
+    box.replaceChildren(out.length
+      ? el('div', { role: 'list' }, out.map(({ p, meta }) => el('div', { class: 'rp-people-row', role: 'listitem', 'data-people-rel': p.id },
+        row({ title: p.name, meta: [[p.role, p.org].filter(Boolean).join(' · ') || p.group, meta.join(' · ')], openLabel: `Open ${p.name} in People`,
+          onOpen: () => { if (onOpen) onOpen(); openPerson(p.id); }, openAttrs: { 'data-person-link': p.id } }))))
+      : el('p', { class: 'rp-people-hint' }, REL.none));
+  });
+  return box;
+}

package/workspace/public/pm/registry.js

@@ -50,6 +50,8 @@ export const DESTINATIONS = Object.freeze([
   Object.freeze({ id: 'reports', label: 'Reports', key: 'g r', module: 'dest-reports.js', run: 5 }),
   // Not a pm-os-absorb run (run: null): docs-three-way-sync added it — is each linked document the same as its copies.
   Object.freeze({ id: 'docs', label: 'Docs', key: 'g d', module: 'dest-docs.js', run: null }),
+  // Not a pm-os-absorb run (run: null): people-directory added it — the people the PM works with in a repository.
+  Object.freeze({ id: 'people', label: 'People', key: 'g p', module: 'dest-people.js', run: null }),
   Object.freeze({ id: 'settings', label: 'Settings', key: null, module: 'dest-settings.js', run: 3 }),
 ]);
 export const EXTENSIONS = Object.freeze([

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

@@ -13,6 +13,7 @@
  * Nothing here writes: the calendar memory changes only through the morning-brief session's brief.
  */
 
+import { peopleLinks } from './people-link.js';
 import { el } from './dom.js';
 import { button, iconButton, badge, tabs } from './primitives.js';
 import { pmGet } from './http.js';
@@ -292,7 +293,8 @@ export function meetingDetail(ctx, id, h) {
   const end = (() => { const d = new Date(e.end); return `${pad(d.getHours())}:${pad(d.getMinutes())}`; })();
   return [
     h.dhead(A.kindWord[e.kind], e.title),
-    el('p', { class: 'td-day__dim td-day__mono' }, `${dayLabel(f.day.date)} · ${e.time}–${end}${e.attendees ? ' · ' + A.people(e.attendees) : ''}`),
+    el('p', { class: 'td-day__dim td-day__mono' }, `${dayLabel(f.day.date)} · ${e.time}–${end}${e.attendees ? ' · ' + A.people(e.attendees) : ''}${e.with ? ' · ' + e.with : ''}`),
+    e.with ? peopleLinks(ctx && ctx.ws, e.with, { 'data-ag': 'people' }) : null,
     memoryBlock(id),
     e.prep ? el('div', { class: 'td-day__phase', 'data-ag': 'before' }, el('h4', null, A.before),
       el('p', null, A.prepLine(e.prep_done || 0, e.prep.length)),

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

@@ -28,6 +28,7 @@ import { pmGet, pmPost } from './http.js';
 import { FIXTURE } from './state.js';
 import { COPY } from './today-copy.js';
 import { goalRows, goalAdd, goalDetail, addGoal, goalsSig } from './today-goals.js';
+import { peopleLinks } from './people-link.js';
 import { agendaPanel, meetingDetail, memoryBlock, refreshAgenda, agendaSig, onAgenda } from './today-agenda.js';
 
 const D = COPY.day;
@@ -538,6 +539,7 @@ function eventDetail(ctx, e) {
   return [
     dhead(D.kind.meeting, e.title),
     el('p', { class: 'td-day__dim td-day__mono' }, `${e.time}${e.end ? '–' + hhmm(e.end) : ''}${e.with ? ' · ' + e.with : ''}${e.ended ? ' · ' + D.ended : ''}`),
+    e.with ? peopleLinks(ctx.ws, e.with, { 'data-day': 'people' }) : null,
     e.purpose ? el('p', null, el('b', null, D.purpose + ': '), e.purpose) : null,
     e.prep ? el('p', null, el('b', null, D.prep + ': '), e.prep) : null,
     ini ? el('div', { class: 'td-day__ini', 'data-day': 'initiative' }, el('span', null, D.initiative + ': ', el('b', { class: 'td-day__mono' }, ini.id), ini.why ? el('span', { class: 'td-day__dim' }, ' (' + D.suggested(ini.why) + ')') : null),

package/workspace/public/pm/topbar.js

@@ -8,7 +8,7 @@
  * runs `git status` against the remote-tracking ref the last fetch left).
  *
  *   createTopbar({ go, openPalette, repoMenu, sync }) → { node, update(model) }
- *     go(id)              open destination id (today, initiatives, board, reports, docs, settings)
+ *     go(id)              open destination id (today, initiatives, board, reports, docs, people, settings)
  *     openPalette()       open ⌘K
  *     repoMenu(anchor)    open the Repository menu under `anchor`
  *     sync(repo)          run Sync for `repo`; resolves to the server's answer
@@ -23,8 +23,9 @@ import { button, needsDot, needsCount } from './primitives.js';
 import { COPY } from './frame-copy.js';
 
 /** The destinations the bar names, in order. Settings sits at the end of the bar, after Sync. Docs joined the bar at the
- * PM's word (2026-10-06, docs-three-way-sync: "I thought Docs is one of the main menu"), so the bar holds 8 controls. */
-export const BAR_DESTS = Object.freeze(['today', 'initiatives', 'board', 'reports', 'docs']);
+ * PM's word (2026-10-06, docs-three-way-sync: "I thought Docs is one of the main menu"). People joined after Docs when the
+ * PM approved the People mockup and said build it (2026-10-06, people-directory), so the bar holds 9 controls. */
+export const BAR_DESTS = Object.freeze(['today', 'initiatives', 'board', 'reports', 'docs', 'people']);
 
 /** Is this sync reading "not in sync"? Behind, ahead, records not yet recorded, or `remote_stale`: no fetch in the last
  * few minutes, so another machine's push would be invisible here and "in sync" cannot be claimed. An unreadable status