create-pmos 0.65.0 → 0.65.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.65.0",
+  "version": "0.65.1",
   "description": "Scaffold the PMOS portable kit — run the PMOS product-management workflow (initiative → lane-fit spec → contract → build → three gates, with work-type lanes for features, research, maintenance, incidents, and content) entirely inside your own repo, with all state as git-versioned files. Includes `workflow-sweep`, which audits the state every board derives from and separates real defects from work you simply have not done. `create-pmos workspace` also installs + launches the local Terminal Workspace GUI. No database, no network, no telemetry.",
   "license": "MIT",
   "bin": {

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@bcf4a86
+kernel-source: pmos@5f54d4e
 assembled: 2026-10-07
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-07T00:08:29Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T00:49:12Z"}
 status: stable
 ---
 

package/payload/planning/okrs/health-budgets.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Health budgets"
 description: "Closed registry of health-budget anchors (D59), edited only by the PM."
-generated: {by: process:create-pmos, at: "2026-10-07T00:08:29Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T00:49:12Z"}
 status: stable
 ---
 

package/payload/state/discoveries.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Discoveries and friction log"
 description: "Append-only record of what runs discovered and where the process rubbed."
-generated: {by: process:create-pmos, at: "2026-10-07T00:08:29Z"}
+generated: {by: process:create-pmos, at: "2026-10-07T00:49:12Z"}
 status: stable
 ---
 

package/workspace/guide/docs.md

@@ -1,6 +1,6 @@
 ---
 type: Guide
-title: "Docs: is each document the same as its Google Docs and Confluence copy, and which version to use"
+title: "Docs: every repository file by category, the files each one links to, and whether each copy in Google Docs or Confluence is the same"
 timestamp: 2026-10-06
 ---
 
@@ -8,15 +8,65 @@ timestamp: 2026-10-06
 
 Open Docs from the top bar, from ⌘K (**Docs**), or press `g d`.
 
-Docs lists every document in the repository that has a copy in Google Docs or Confluence. For each copy, it shows whether the repository version (PMOS) or the copy is newer. You can then use one version over the other, one copy at a time.
+Docs lists every markdown file in the repository by category. For each file, it shows the files that it links to and the files that link to it. For each document that has a copy in Google Docs or Confluence, it shows whether the repository version (PMOS) or the copy is newer. You can then use one version over the other, one copy at a time.
 
 Nothing syncs by itself. A copy changes only when you press a button for that copy.
 
 ## The list
 
-The copies are grouped by initiative. Copies of files that no initiative owns are under **Other**.
+Docs has three views:
 
-**Needs you** shows the copies that are not the same. **All** shows every copy.
+- **Needs you** shows the copies that are not the same.
+- **With a copy** shows every copy.
+- **All files** shows every markdown file in the repository.
+
+The copies are grouped by category.
+
+## Categories
+
+The category of a file comes from its folder, then from its frontmatter `type`. You do not tag a file.
+
+| Category | Files |
+|---|---|
+| Specs | `planning/prd/`, or `type: PRD` |
+| Initiatives | `planning/initiatives/` |
+| Decisions | the ADR folder, `DECISIONS.md`, `pm-decisions.md` |
+| Research & plans | the other `planning/` folders |
+| Explainers | `planning/explainers/` |
+| Evals | `planning/evals/`, or `type: Rubric` |
+| Knowledge | the other `okf/` folders |
+| Guides & rules | all other files |
+| Prototypes | `prototype/` |
+
+## All files
+
+**All files** opens with one line for each category: its name, its number of files, and "N need you" when a copy in it is not the same. Press a category to open it. It shows its first 20 files: the files with a copy first, then the newest. Press **Show all** to see the rest.
+
+A file with no copy is one line: its title, the short name of its initiative (or its path when no initiative owns it), and the date of its last edit. **Add copy** shows when you point at the line, and always on a touch screen.
+
+## The links of a file
+
+Press a file in **All files** to see its links:
+
+- on the left, the files that link to it;
+- in the middle, the file;
+- on the right, the files that it links to.
+
+Each side shows at most 7 files. A dashed line is a decision that the file cites. Press a file in the graph to put it in the middle. Press **Back** to go back. **Open file** opens the file in the reader.
+
+**List all N links** lists every link in both directions, grouped by kind.
+
+A link counts only when a file writes it:
+
+- a markdown link to another file;
+- a path in the frontmatter, such as `prd_path`;
+- the `initiative_id` of the file;
+- the anchor (`parent_kr`);
+- a decision number, such as D65.
+
+PMOS does not guess a link from similar words. `pmos kg neighbors <path>` shows the same links in the terminal.
+
+On a phone the graph is not shown. The list is shown.
 
 Each copy is one line:
 
@@ -49,7 +99,8 @@ Click a line to see its details:
 - the copy: its address and its last edit;
 - a **Use … version** button for each side;
 - the first difference that the compare found, when it found one;
-- **Compare again** and **Stop tracking this copy**.
+- **Compare again** and **Stop tracking this copy**;
+- the links of the file, as in **All files**.
 
 **Stop tracking this copy** removes the link. The copy is not deleted. Press **Undo** in the message to link it again.
 
@@ -72,7 +123,9 @@ A compare runs only when you press it. There is no schedule. An edit to a reposi
 
 ## Add a copy
 
-Type in **Find a document**. The search finds every markdown file in the repository by its title or path, also files that have no copy. A file with no copy shows **No copy** and **Add copy**.
+Type in the search box. The search finds every markdown file in the repository by its title, its path or the name of its initiative, also files that have no copy. The results are grouped by category, and the match is marked. Press Esc to clear the search.
+
+Press **Add copy** on a file with no copy.
 
 Press **Add copy**, paste the address of the Google Doc or Confluence page, and press Enter. A document can have one Google Doc and one Confluence page.
 

package/workspace/guide/initiatives-screen.md

@@ -76,6 +76,14 @@ The Files tab lists every file that belongs to the initiative, in three groups:
 - **Linked documents.** The documents the library joins to the initiative: a document that declares its `initiative_id`, a document the record names, a file name that starts with the id.
 - **Changed for it in git.** The files that the commits for this initiative changed and that still exist. These are its own branch, trunk commits that name the id, and merged changes that carried its documents. The file opens read-only.
 
+**List · Graph** at the top of the tab changes the view. **List** shows the groups above. **Graph** shows the files of the initiative as a network:
+
+- a filled dot is a markdown file of the initiative: a file that the record names, or a linked document. Its label is its role, such as PRD, Rubric or Explainer;
+- a hollow dot is a file outside the initiative that one of its files links to, or that links to one of its files. A decision shows its number, such as D65;
+- a line is a link that a file writes. A dashed line is a decision that a file cites.
+
+The graph shows at most 14 outside files, the most-linked first. The legend says how many are left out. Press a dot to mark its lines and to see its title, its path and **Open file**. The same files and links always give the same picture. On a phone the list is shown.
+
 ### A breakdown read from the spec
 
 When nobody has planned items for an initiative, the Breakdown tab shows the items of its spec above the empty Breakdown: the user stories, or the entries of the Requirements section of the PRD that the record names. Each item shows the state of the whole initiative: **Done** after you accept it, **Built** when its build is on the trunk, and **Todo** before that. These items are read-only and nothing is written. To track an item, add it to the Breakdown. The card and the row show the same count, for example "0 of 8 · from board-delivery-truth-prd.md".

package/workspace/lib/doc-library.js

@@ -0,0 +1,131 @@
+'use strict';
+/* doc-library.js — every tracked markdown file of a workspace, by category, with its initiative and the links between the
+ * files (initiative docs-library-graph, PRD R-L1 to R-L5).
+ *
+ * The links are the knowledge graph's (lib/kg.js through kg-cli `graphFor`): a markdown link, a path in the header, the
+ * initiative, the anchor, a decision number. Nothing is inferred from wording. A category is derived from where a file
+ * lives, then from its frontmatter type; it is never written into a file. The result is kept in memory per repository
+ * state (git HEAD plus the uncommitted markdown files), and the kg cache stays in the runtime state directory. Nothing
+ * here writes into the repository or reads the network.
+ */
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+const kgCli = require('./kg-cli');
+
+/* [key, name] in display order */
+const CATEGORIES = [
+  ['spec', 'Specs'], ['ini', 'Initiatives'], ['dec', 'Decisions'], ['res', 'Research & plans'], ['exp', 'Explainers'],
+  ['eval', 'Evals'], ['know', 'Knowledge'], ['guide', 'Guides & rules'], ['proto', 'Prototypes'],
+];
+/* the link kinds, in the order the client numbers them */
+const KINDS = ['link', 'header', 'initiative', 'anchor', 'cites'];
+
+const BY_TYPE = { prd: 'spec', initiative: 'ini', adr: 'dec', decision: 'dec', rubric: 'eval', eval: 'eval', verdict: 'eval', explainer: 'exp' };
+
+/** The category of one file: where it lives first, then its frontmatter type, then Guides & rules. */
+function categoryOf(rel, type) {
+  const p = String(rel || '');
+  if (/^prototype\//.test(p)) return 'proto';
+  if (/(^|\/)planning\/initiatives\//.test(p)) return 'ini';
+  if (/(^|\/)planning\/prd\//.test(p)) return 'spec';
+  if (/(^|\/)planning\/evals\//.test(p)) return 'eval';
+  if (/(^|\/)planning\/explainers\//.test(p)) return 'exp';
+  if (/^okf\/products\/[^/]+\/adr\//.test(p) || /^(DECISIONS|pm-decisions)\.md$/.test(p) || /(^|\/)planning\/decisions-/.test(p)) return 'dec';
+  if (/(^|\/)planning\//.test(p)) return 'res';
+  if (/^okf\//.test(p)) return 'know';
+  const t = String(type || '').trim().toLowerCase();
+  return BY_TYPE[t] || 'guide';
+}
+
+/** A short name for an initiative title: no "PRD:" prefix, the part before the first dash or colon, at most 44 characters. */
+function shortTitle(title) {
+  let t = String(title || '').trim();
+  t = t.replace(/^(PRD|Initiative|Chore|Spike|Prototype Brief|Discovery|Incident|Content brief|Feature)\s*(?:[:—–]|\s-\s)\s*/i, '');
+  t = t.split(/\s[—–]\s|:\s|\.\s/)[0].trim();
+  if (t.length > 44) { const cut = t.slice(0, 43); t = (cut.includes(' ') ? cut.replace(/\s+\S*$/, '') : cut) + '…'; }
+  return t ? t[0].toUpperCase() + t.slice(1) : '';
+}
+
+/** The kind of one kg edge, or null for a kind the library does not show. */
+function kindOf(e) {
+  if (e.type === 'link') return 'link';
+  if (e.type === 'initiative') return 'initiative';
+  if (e.type === 'anchor') return 'anchor';
+  if (e.type === 'cites') return e.typed ? 'header' : 'cites';
+  if (e.type === 'frontmatter' || e.type === 'supersedes' || e.type === 'amended_by') return 'header';
+  return null;
+}
+
+const git = (cwd, args) => execFileSync('git', args, { cwd, encoding: 'utf8', maxBuffer: 256 * 1024 * 1024, stdio: ['ignore', 'pipe', 'pipe'] });
+
+/** path → YYYY-MM-DD of its last commit (one git log; merge commits are skipped, their changes are in their parents). */
+function commitDates(root) {
+  const out = new Map();
+  let text = '';
+  try { text = git(root, ['log', '--format=%x01%cs', '--name-only', '--', '*.md']); } catch { return out; }
+  let day = null;
+  for (const line of text.split('\n')) {
+    if (line.startsWith('\x01')) { day = line.slice(1); continue; }
+    if (line && day && !out.has(line)) out.set(line, day);
+  }
+  return out;
+}
+
+/** The uncommitted markdown files: their date is the file's own. */
+function dirtyPaths(root) {
+  try {
+    return new Set(git(root, ['status', '--porcelain', '-z', '--untracked-files=no']).split('\0').filter(Boolean)
+      .map((l) => l.slice(3)).filter((p) => /\.md$/.test(p)));
+  } catch { return new Set(); }
+}
+
+const cache = new Map();   // root -> { key, value }
+
+/**
+ * The library of one repository.
+ *   owners: () => Map path → { id, title } — the library's own attribution (server.js initiativeIndex), real initiatives
+ *   only. It is called only when the repository state changed, because the index reads every planning file.
+ * Returns { ok, files: [{path,title,category,date,initiative}], initiatives: {id: {title, short}}, kinds, edges: [[from, to, kind]], categories }.
+ * `from` and `to` index `files`; `kind` indexes `kinds`.
+ */
+function library(root, { stateDir, owners = () => new Map() } = {}) {
+  let key;
+  try { key = kgCli.cacheKey(root); } catch (e) { return { ok: false, error: 'this workspace is not a git repository, so there are no tracked files to list' }; }
+  const hit = cache.get(root);
+  if (hit && hit.key === key) return hit.value;
+  const { graph, unreadable } = kgCli.graphFor(root, stateDir ? { stateDir } : {});
+  let own = new Map();
+  try { own = owners() || new Map(); } catch { /* no attribution: every file has no initiative */ }
+  const dates = commitDates(root);
+  const dirty = dirtyPaths(root);
+  const dayOf = (rel) => {
+    if (!dirty.has(rel) && dates.has(rel)) return dates.get(rel);
+    try { return fs.statSync(path.join(root, rel)).mtime.toISOString().slice(0, 10); } catch { return dates.get(rel) || null; }
+  };
+  // An initiative is named by its record's title (planning/initiatives/<id>.md), else by the index's title for it.
+  const titleOf = new Map(graph.nodes.map((n) => [n.id, n.title]));
+  const named = (o) => String(titleOf.get(`planning/initiatives/${o.id}.md`) || o.title || o.id);
+  const initiatives = {};
+  const files = graph.nodes.map((n) => {
+    const o = own.get(n.id) || null;
+    if (o && !initiatives[o.id]) initiatives[o.id] = { title: named(o), short: shortTitle(named(o)) };
+    return { path: n.id, title: String(n.title || n.id), category: categoryOf(n.id, n.type), date: dayOf(n.id), initiative: o ? o.id : null };
+  });
+  const index = new Map(files.map((f, i) => [f.path, i]));
+  const seen = new Set();
+  const edges = [];
+  for (const e of graph.edges) {
+    const k = kindOf(e);
+    if (!k || e.from === e.to || !index.has(e.from) || !index.has(e.to)) continue;
+    const a = index.get(e.from); const b = index.get(e.to); const ki = KINDS.indexOf(k);
+    const id = a + '|' + b + '|' + ki;
+    if (seen.has(id)) continue;
+    seen.add(id); edges.push([a, b, ki]);
+  }
+  const value = { ok: true, key, files, initiatives, kinds: KINDS, edges, categories: CATEGORIES.map(([k, name]) => ({ key: k, name })), unreadable: unreadable || [] };
+  cache.set(root, { key, value });
+  return value;
+}
+
+module.exports = { CATEGORIES, KINDS, categoryOf, shortTitle, kindOf, library, commitDates };

package/workspace/package-lock.json

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

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.65.0",
+  "version": "0.65.1",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",

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;