create-pmos 0.65.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/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 }
+}