@cspeach/cli 1.1.29 → 1.1.31

package/dist/register/status-file/register-status-file.js

@@ -0,0 +1,189 @@
+// @ts-nocheck
+// GENERATED COPY — do not edit here. Edit viewer/src/lib/register-status-file.js,
+// then run `npx tsx scripts/sync-status-file.ts` (prebuild runs it too).
+// src/register/__tests__/status-file-pin.test.ts fails when this copy drifts.
+/**
+ * The status file: the team project picture as one document a lead can mail.
+ *
+ * For the people who will never open a folder in a browser. It holds no code to
+ * run and points at nothing — the stylesheet is inside it, the map is inline
+ * SVG, the object list unfolds with `details`, which the browser opens on its
+ * own. It carries its own policy, so the copy a manager forwards can no more
+ * call out than the page it came from.
+ *
+ * It is a snapshot and says so, with the time, in the first line under the
+ * title. One moment runs through the whole file — `asOf`, when the folder was
+ * READ — and nothing else. Not when somebody pressed Save: a page left open
+ * over lunch and saved at three o'clock holds the eleven o'clock folder, and
+ * the quiet-lane day counts inside it were worked out against eleven o'clock
+ * too. The name, the document title and the stamp all carry that one day, so
+ * they cannot disagree — and they would, across midnight UTC, which is early
+ * evening in the United States.
+ *
+ * Nothing here reaches for the clock: the time is handed in, so the page, this
+ * file and the tests all print the same moment.
+ *
+ * One moment, and one folder. The stamp says which folder this was made from,
+ * so the provenance line above it does not — it is handed no folder name and
+ * stops after the lead. The page, which has no stamp, keeps the whole sentence.
+ *
+ * Pure: data in, one string out. It is built from the model's own answers —
+ * the same `collectView` the page renders — never from the page, which wires
+ * listeners and reads the keyboard. Two pictures of one folder that disagree
+ * would be worse than no picture at all.
+ */
+import { esc } from './register-map.js';
+import { formatWhen } from './register-model.js';
+// Every mark this file shares with the page. One copy, in a module that knows
+// nothing about the browser: two pictures of one folder that disagree would be
+// worse than no picture at all, and these two had already begun to.
+import { decisionWord, developersTableHtml, dispositionsHtml, ignoredRunsHtml, mapBodyHtml, measuredWord, n, needItemHtml, focusLineHtml, notMeasuredLine, ownerLabel, provenanceLine, readNote, runsTableHtml, stateWord, whereItStandsHtml, } from './register-parts.js';
+import { estateSectionHtml } from './estate-parts.js';
+import { progressSectionHtml } from './progress-chart.js';
+import { planSectionHtml } from './plan-parts.js';
+const FILE_CSP = "default-src 'none'; style-src 'unsafe-inline'; img-src data:";
+const objects = (count) => `${n(count)} object${count === 1 ? '' : 's'}`;
+const files = (count) => `${n(count)} file${count === 1 ? '' : 's'}`;
+/**
+ * What the file is called once it lands in somebody's downloads. A manager with
+ * four of these in a folder should be able to tell them apart without opening
+ * one, so the name carries the team project and the day — the day the folder
+ * was read, the same day the file states inside itself.
+ * @param {{ name?: string }} project
+ * @param {string} asOf ISO time the folder was read
+ * @returns {string}
+ */
+export function statusFileName(project, asOf) {
+    const slug = String(project?.name ?? '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'team-project';
+    return `${slug}-status-${String(asOf).slice(0, 10)}.html`;
+}
+/**
+ * One package, folded shut. The count is in the fold's own line so the size of
+ * a package is readable without opening it — a real project puts thousands of
+ * rows behind one of these.
+ */
+function packageFold(block, lanes, runs, projectType) {
+    // An empty cell reads as a value somebody lost rather than as one nobody has
+    // set yet, so both absences say themselves in words — in the same lower case
+    // as the values they stand in for ("fix", "retire", a person's name).
+    //
+    // The last column is the whole of step 2 in one cell: what the system found,
+    // or that nobody has looked. A reader working down this list must not have to
+    // take a colour on trust, and "not measured" is an answer, not a blank.
+    const row = (o) => `<tr><td class="ident">${esc(o.name)}</td><td>${esc(o.type)}</td><td>${esc(stateWord(o))}</td>`
+        + `<td>${esc(decisionWord(o.decision, projectType, o.state))}</td>`
+        + `<td>${esc(ownerLabel(lanes.find((l) => l.id === o.lane)))}</td>`
+        + `<td>${esc(measuredWord(o, runs))}</td></tr>`;
+    // Every fold holds a table with the same six headings, so each one says
+    // which package it belongs to — otherwise a screen reader announces the
+    // twelfth "Object, Type, State, Decision, Owner, Measured" with nothing to
+    // tell it from the eleventh.
+    return `<details data-role="package"><summary>${esc(block.package)} — ${objects(block.objects.length)}</summary>`
+        + `<div class="scroller"><table aria-label="${esc(block.package)}"><thead><tr><th scope="col">Object</th><th scope="col">Type</th>`
+        + '<th scope="col">State</th><th scope="col">Decision</th><th scope="col">Owner</th><th scope="col">Measured</th></tr></thead>'
+        + `<tbody>${block.objects.map(row).join('')}</tbody></table></div></details>`;
+}
+/** Nothing in a saved file can reload, so the page's advice is not repeated here. */
+const UNREADABLE_DETAIL = 'Some results may be missing. The next status file will include them once the files have finished syncing.';
+/**
+ * The whole document.
+ *
+ * Read in the order a manager reads it: whose team project, when this was true, the
+ * one line and the focus, the estate (or the sentence saying there is none, or
+ * that it could not be read — `estate` is the discovery file as the folder read
+ * gave it, exactly as the page gets it), where it stands,
+ * progress over time, what is waiting for a person, who owns what, the plan —
+ * and only then, folded away, every object one by one. The same sections, in
+ * the same order, as the page.
+ *
+ * `css` is the only value written in unescaped, and the only one that never came
+ * out of the folder: it is our own stylesheet, imported at build time. Every
+ * name, package, decision and person below goes through `esc()`.
+ *
+ * `files`, `checksum` and `register.skipped` are what the read note is worked
+ * out from. The file prints it for the same reason the page does, and with more
+ * reason: whoever this was mailed to cannot look in the folder to find out that
+ * a ruling was ignored, and an ignored ruling is a decision somebody made that
+ * this picture does not show.
+ *
+ * @param {{ project: object, register: object, summary: object, needs: object[],
+ *           blocks: object[], css: string, asOf: string, folderName: string,
+ *           files?: number, checksum?: string, unreadable?: number, estate?: unknown }} view
+ * @returns {string}
+ */
+export function buildStatusHtml({ project, register, summary, needs, blocks, css, asOf, folderName, files: filesRead = 0, checksum, unreadable = 0, estate = undefined, // the default keeps it optional for the TypeScript copy
+ }) {
+    // A file with no time on it, or with the wrong one, is worse than no file:
+    // somebody will act on it. Refuse rather than print "never" or quietly stamp
+    // the moment Save was pressed.
+    if (!asOf)
+        throw new Error('buildStatusHtml needs asOf — the time the folder was read. The file states it as the truth of the picture.');
+    // The file says how many files were missing. A caller that reports the need
+    // but not the count would have it say "0 files could not be read", which is
+    // the opposite of what the need means.
+    if (needs?.some((i) => i.kind === 'unreadable') && !(Number.isFinite(unreadable) && unreadable > 0)) {
+        throw new Error('buildStatusHtml needs unreadable — a need says files could not be read, and the file states how many.');
+    }
+    // `css` is ours, but this function is exported and pure, so a caller could one
+    // day hand it something with a closing style tag in it, which would end the
+    // stylesheet early and put the rest of it into the document as text — or as
+    // markup. Refuse; do not rewrite it behind the caller's back.
+    if (/<\/style/i.test(css))
+        throw new Error('buildStatusHtml refuses css that closes the style element.');
+    // "Reload in a minute" is true on the page and false in a file that cannot
+    // reload. The page keeps the model's wording; the file says what a reader
+    // holding a snapshot can actually expect. This is the ONE mark where the two
+    // surfaces are allowed to differ.
+    const forFile = (i) => (i.kind !== 'unreadable' ? i
+        : { ...i, title: `${files(unreadable)} could not be read when this was made`, detail: UNREADABLE_DETAIL });
+    return `<!doctype html>
+<html lang="en"><head><meta charset="utf-8">
+<meta http-equiv="Content-Security-Policy" content="${FILE_CSP}">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${esc(project.name)} — status as of ${esc(String(asOf).slice(0, 10))}</title>
+<style>${css}</style></head>
+<body><main id="app">
+<header class="masthead">
+<p class="provenance">${provenanceLine(project)}</p>
+<h1>${esc(project.name)}</h1>
+<p class="stamp" data-role="stamp">Status as of ${esc(formatWhen(asOf))}. This file does not update. Made by CSPeach from the folder ${esc(folderName)}.</p>
+${unreadable > 0 ? `<p class="notice" data-role="incomplete">${files(unreadable)} could not be read, so this picture may be incomplete.</p>` : ''}
+<p class="summary" data-role="summary">${esc(summary.line)}</p>
+<p class="focus-line" data-role="focus">${focusLineHtml(register)}</p>
+${notMeasuredLine(register) ? `<p class="unmeasured" data-role="not-measured">${esc(notMeasuredLine(register))}</p>` : ''}
+</header>
+<section class="estate" data-role="estate"><h2>Estate</h2>
+${estateSectionHtml(register, { fileGiven: estate !== undefined, now: asOf })}
+</section>
+<section class="stands" data-role="stands"><h2>Where it stands</h2>
+${whereItStandsHtml(register)}
+</section>
+<section class="dispositions"><h2>Decisions</h2>
+${dispositionsHtml(register)}
+</section>
+<section class="progress" data-role="progress"><h2>Progress over time</h2>
+${progressSectionHtml(register)}
+</section>
+<section class="needs" data-role="needs"><h2>Needs you</h2>
+${needs.length ? `<ul>${needs.map(forFile).map(needItemHtml).join('')}</ul>` : '<p>Nothing is waiting for anyone.</p>'}
+</section>
+<section class="lanes" data-role="lanes"><h2>Who owns what</h2>
+${developersTableHtml(register)}
+</section>
+<section class="plan" data-role="plan"><h2>Plan and changes</h2>
+${planSectionHtml(register)}
+</section>
+<section class="map"><h2>Every object</h2>
+${mapBodyHtml(register, blocks, { role: 'img' })}
+</section>
+<section class="runs" data-role="runs"><h2>Measurements</h2>
+${runsTableHtml(register.runs)}
+${ignoredRunsHtml(register.ignoredRuns)}
+</section>
+<section class="objects"><h2>The object list</h2>
+${blocks.map((b) => packageFold(b, register.lanes, register.runs, project.type)).join('')}
+</section>
+<footer><p data-role="read-note">${esc(readNote({ files: filesRead, unreadable, checksum, register }, { tense: 'past' }))}</p>
+<p data-role="trust">This file holds object names, packages, team member names, decisions, fix status and check results. No source code. No passwords. It contains no script and no links, and it cannot load anything from the internet.</p></footer>
+</main></body></html>`;
+}

package/dist/register/status-file/team-css.js

@@ -0,0 +1,5 @@
+// @ts-nocheck
+// GENERATED COPY — do not edit here. Edit viewer/src/team/team.css,
+// then run `npx tsx scripts/sync-status-file.ts` (prebuild runs it too).
+// src/register/__tests__/status-file-pin.test.ts fails when this copy drifts.
+export const TEAM_CSS = "/**\n * /team/ — one stylesheet, shared by the page and by the status file that\n * the page saves. That is why it pulls in no other stylesheet, no font file and\n * no image by address, and carries no selector that depends on anything outside\n * itself: the status file is one document on somebody's desktop, with no\n * network behind it.\n *\n * The nine state colours are the only colours on this page that mean anything.\n * Everything else is paper, ink and one edge, so nothing competes with the map.\n * The peach accent is kept for two things and no others: the button you are\n * meant to press, and where the keyboard currently is.\n */\n\n:root {\n  --peach: oklch(0.74 0.13 35); --peach-deep: oklch(0.58 0.16 35);\n  --paper: oklch(0.97 0.006 80); --paper-2: oklch(0.94 0.008 80);\n  --ink: oklch(0.20 0.012 40); --ink-2: oklch(0.34 0.012 40); --ink-3: oklch(0.48 0.010 40);\n  --edge: oklch(0.88 0.010 80);\n  /* State colours: red = the system disagrees, grey = nobody has started, amber = words only, green = proven. */\n  --s-regressed: oklch(0.52 0.20 27); --s-did-not-hold: oklch(0.64 0.19 40);\n  --s-untouched: oklch(0.84 0.006 80); --s-decided: oklch(0.80 0.06 250); --s-working: oklch(0.70 0.10 250);\n  --s-claimed: oklch(0.82 0.13 90); --s-verified: oklch(0.60 0.15 145); --s-clean: oklch(0.80 0.09 145);\n  --s-retired: oklch(0.93 0.004 80);\n  /* The tenth colour is not a state. It marks data holding a state this build\n     does not know, and it is meant to look wrong: a cell nobody can explain\n     must never pass for a quiet one. */\n  --s-unknown: oklch(0.62 0.30 330);\n  --font: system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif;\n  --mono: ui-monospace, \"Cascadia Mono\", \"SF Mono\", Menlo, monospace;\n  /* The drawings on the empty screen are themed with the site's own names, so\n     the page has to answer to all of them or a drawing falls back to a fixed\n     light hex and goes wrong in the dark. Fonts included: font-src is 'none'\n     here, so the display face names system serifs and never a downloaded one. */\n  --paper-3: oklch(0.91 0.010 80); --ink-4: oklch(0.62 0.008 40); --edge-2: oklch(0.82 0.012 80);\n  --peach-soft: oklch(0.92 0.05 35); --peach-wash: oklch(0.97 0.02 35);\n  --ok: oklch(0.60 0.15 145); --warn: oklch(0.70 0.15 75); --bad: oklch(0.56 0.19 27); --slate: oklch(0.55 0.02 250);\n  --dgm-node: #ffffff;\n  --font-sans: var(--font); --font-mono: var(--mono); --font-display: Georgia, \"Times New Roman\", serif;\n  color-scheme: light dark;\n  font-family: var(--font);\n  color: var(--ink); background: var(--paper);\n}\n@media (prefers-color-scheme: dark) {\n  :root {\n    --paper: oklch(0.19 0.008 60); --paper-2: oklch(0.24 0.010 60); --ink: oklch(0.94 0.006 80);\n    --ink-2: oklch(0.82 0.008 80); --ink-3: oklch(0.68 0.008 80); --edge: oklch(0.32 0.010 60);\n    --s-untouched: oklch(0.36 0.006 80); --s-retired: oklch(0.27 0.004 80);\n    --paper-3: oklch(0.29 0.012 60); --ink-4: oklch(0.56 0.008 80); --edge-2: oklch(0.40 0.012 60);\n    --peach-soft: oklch(0.36 0.06 35); --peach-wash: oklch(0.27 0.03 35); --dgm-node: var(--paper-2);\n  }\n}\n\n* { box-sizing: border-box; }\nbody { margin: 0; background: var(--paper); color: var(--ink); line-height: 1.55; -webkit-text-size-adjust: 100%; }\n#app { max-width: 1180px; margin: 0 auto; padding: 32px 16px 64px; }\n[hidden] { display: none !important; }\n:focus-visible { outline: 2px solid var(--peach-deep); outline-offset: 2px; border-radius: 4px; }\n\n/* ── The answer, before anything else ─────────────────────────────────── */\n.masthead { margin: 0 0 40px; }\n/* SAP names run long and never break on their own (WAVE4_CLEANCORE_FINAL_V2),\n   so anything that can hold one is allowed to break inside a word. */\n.provenance { margin: 0 0 10px; font-size: 14px; color: var(--ink-3); max-width: 70ch; overflow-wrap: anywhere; }\nh1 { margin: 0 0 12px; font-size: clamp(28px, 4.6vw, 44px); font-weight: 640; letter-spacing: -0.022em; line-height: 1.05; max-width: 22ch; overflow-wrap: anywhere; }\n.summary { margin: 0 0 22px; font-size: clamp(17px, 2.2vw, 21px); font-weight: 480; line-height: 1.4; color: var(--ink-2); max-width: 58ch; }\n.notice { margin: 0 0 20px; padding: 12px 14px; border-left: 3px solid var(--s-regressed); background: var(--paper-2); color: var(--ink); max-width: 70ch; }\n\n.actions { display: flex; flex-wrap: wrap; gap: 8px; }\nbutton { font: inherit; padding: 9px 15px; border-radius: 8px; cursor: pointer; max-width: 100%; overflow-wrap: anywhere; }\nbutton.primary { border: 1px solid var(--peach-deep); background: var(--peach); color: oklch(0.20 0.012 40); }\nbutton.quiet { border: 1px solid var(--edge); background: transparent; color: var(--ink-2); }\nbutton.quiet:hover { border-color: var(--ink-3); color: var(--ink); }\n/* The colour switch: the chosen mode reads as chosen, from the same tokens. */\nbutton.quiet[aria-pressed=\"true\"] { border-color: var(--ink); color: var(--ink); font-weight: 600; }\n.map > .actions { margin: 0 0 12px; }\n\n/* ── The map: the hero. No borders, no card, nothing to look at but colour ── */\n.map { margin: 0 0 48px; }\n.legend { list-style: none; display: flex; flex-wrap: wrap; gap: 6px 18px; padding: 0; margin: 0 0 20px; font-size: 13px; color: var(--ink-2); }\n.swatch { display: inline-block; width: 10px; height: 10px; border-radius: 2px; margin-right: 6px; vertical-align: baseline; }\n.blocks { display: flex; flex-wrap: wrap; gap: 28px 32px; align-items: flex-start; }\n.blocks figure { margin: 0; max-width: 100%; }\n.blocks h3 { margin: 0 0 8px; font-family: var(--mono); font-size: 11.5px; font-weight: 600; color: var(--ink-2); letter-spacing: 0; }\n.blocks figcaption { margin-top: 6px; font-size: 11.5px; color: var(--ink-3); }\n.block-map { display: block; max-width: 100%; height: auto; }\n.cell { cursor: pointer; }\n.cell.selected { stroke: var(--ink); stroke-width: 2; }\n/* The map has one tab stop and the arrow keys move it, so where that stop\n   currently sits has to be unmistakable — an outline alone is too thin at 10px. */\n.cell:focus-visible { outline: 2px solid var(--peach-deep); outline-offset: 2px; stroke: var(--ink); stroke-width: 2; }\n\n.s-regressed { fill: var(--s-regressed); background: var(--s-regressed); }\n.s-did-not-hold { fill: var(--s-did-not-hold); background: var(--s-did-not-hold); }\n.s-untouched { fill: var(--s-untouched); background: var(--s-untouched); }\n.s-decided { fill: var(--s-decided); background: var(--s-decided); }\n.s-working { fill: var(--s-working); background: var(--s-working); }\n.s-claimed { fill: var(--s-claimed); background: var(--s-claimed); }\n.s-verified { fill: var(--s-verified); background: var(--s-verified); }\n.s-clean { fill: var(--s-clean); background: var(--s-clean); }\n.s-retired { fill: var(--s-retired); background: var(--s-retired); }\n.s-unknown { fill: var(--s-unknown); background: var(--s-unknown); }\n\n/* The one bordered surface on the page, because it is a thing that opened. */\n.detail { margin-top: 28px; padding: 18px 20px; border: 1px solid var(--edge); border-radius: 12px; background: var(--paper-2); scroll-margin-top: 16px; }\n.detail h3 { margin: 0 0 10px; font-size: 17px; font-weight: 620; }\n.detail h3 small { font-family: var(--font); font-size: 13px; font-weight: 400; color: var(--ink-3); }\n.detail p { margin: 0 0 8px; font-size: 14px; }\n.detail .state { font-size: 14px; color: var(--ink-2); }\n.detail table { margin: 12px 0; }\n.ident { font-family: var(--mono); overflow-wrap: anywhere; }\n.warn { color: var(--s-regressed); }\n\n/* ── What needs a person, and who owns what ───────────────────────────── */\n.pair { display: grid; gap: 40px 48px; }\n@media (min-width: 900px) { .pair { grid-template-columns: 1.3fr 1fr; } }\n.needs, .lanes { min-width: 0; }\nh2 { margin: 0 0 14px; font-size: 15px; font-weight: 620; color: var(--ink-2); }\n.needs ul { list-style: none; margin: 0; padding: 0; }\n/* The bar carries the state's own colour where the item is a state, and a\n   neutral one where it is not — so the colour never means a second thing. */\n.need { display: grid; gap: 3px; margin-bottom: 12px; padding: 2px 0 2px 12px; border-left: 3px solid var(--ink-3); }\n.need b { font-size: 14.5px; font-weight: 620; }\n.need span { font-size: 14px; color: var(--ink-2); overflow-wrap: anywhere; }\n.k-regressed { border-left-color: var(--s-regressed); }\n.k-did-not-hold { border-left-color: var(--s-did-not-hold); }\n\n.scroller { overflow-x: auto; }\ntable { width: 100%; border-collapse: collapse; font-size: 14px; }\nth, td { text-align: left; padding: 8px 12px 8px 0; border-bottom: 1px solid var(--edge); white-space: nowrap; }\nth { font-weight: 600; color: var(--ink-3); font-size: 12.5px; }\n\n/* ── How it works (the empty screen) ──────────────────────────────────── */\n.how { margin-top: 48px; }\n.how p { font-size: 14px; color: var(--ink-2); max-width: 70ch; }\n/* The drawings follow the page's own tokens, so the card is the page's paper in\n   both themes rather than a fixed light slab. Each drawing ships twice: a wide\n   composition and a narrow one that stacks the same nodes and says the same\n   words. This is the only thing that chooses between them — no script, and no\n   style attribute, because the page's policy forbids one. */\n.diagram { margin-bottom: 16px; padding: 20px 16px; border: 1px solid var(--edge); border-radius: 12px; background: var(--paper); }\n.diagram svg { display: block; width: 100%; height: auto; margin: 0 auto; }\n.diagram .narrow { display: none; }\n@media (max-width: 640px) {\n  .diagram { padding: 16px 8px; }\n  .diagram .wide { display: none; }\n  .diagram .narrow { display: block; max-width: 420px; margin: 0 auto; }\n}\n.how + .how { margin-top: 40px; }\n\nfooter { margin-top: 56px; padding-top: 20px; border-top: 1px solid var(--edge); font-size: 13px; color: var(--ink-3); }\nfooter p { margin: 0 0 8px; max-width: 78ch; }\n\n/* ── The way off the page ─────────────────────────────────────────────── */\n/* It sits outside the app, so it lines itself up with the app's own column\n   instead of running the full width of the window. No rule above it: the\n   page's own footer has already drawn one, and two lines in a row read as a\n   mistake. It does not belong on paper — a printed record is not clickable. */\n.site-foot { max-width: 1180px; margin: 24px auto 0; padding: 0 16px 48px; border-top: 0; }\n.site-foot a { color: var(--ink-2); }\n.site-foot a:hover { color: var(--ink); }\n@media print { .site-foot { display: none; } }\n\n/* ── The status file ──────────────────────────────────────────────────── */\n/* The saved copy is this same page as one document, so it wears this same\n   stylesheet and nearly all of the rules above. It has no buttons to press, so\n   the peach accent never appears in it — the accent marks the thing you act on,\n   and in a document there is nothing to act on. These are the only rules it\n   adds.\n\n   The stamp is the one mark that says this is a document and not a page: a\n   moment, boxed and set in the face this page already uses for machine facts.\n   It is bordered rather than filled so it survives a printer that drops\n   colour. */\n.stamp {\n  display: inline-block; margin: 0 0 22px; padding: 7px 11px; max-width: 100%;\n  border: 1px solid var(--edge); border-radius: 6px;\n  font-family: var(--mono); font-size: 12.5px; line-height: 1.5; color: var(--ink-2); overflow-wrap: anywhere;\n}\n\n/* Thousands of rows folded into one line per package: the count is in the line\n   so the size of a package reads without opening it. Ruled, not carded — these\n   are rows of a list, not a set of tiles. */\n.objects { margin-top: 48px; }\n.objects details { border-top: 1px solid var(--edge); }\n.objects details:last-of-type { border-bottom: 1px solid var(--edge); }\n.objects summary { padding: 11px 0; font-family: var(--mono); font-size: 12.5px; font-weight: 600; color: var(--ink-2); cursor: pointer; }\n.objects summary:hover, .objects details[open] > summary { color: var(--ink); }\n.objects .scroller { padding-bottom: 16px; }\n\n@media print {\n  /* A printed record that quietly leaves out the folded half is not the record,\n     so every package opens on paper. Two rules for the two ways a browser hides\n     a closed fold; a browser that knows neither selector ignores its rule. */\n  .objects details:not([open]) > :not(summary) { display: block; }\n  .objects details::details-content { content-visibility: visible; }\n  .objects summary { break-after: avoid; }\n  .stamp { border-color: var(--ink-3); }\n}\n\n/* ── What was measured, and what was not ──────────────────────────────── */\n/* Two marks, and deliberately no new colour. The nine state colours are the\n   only colours on this page that mean anything, and how a number was arrived at\n   is not a tenth state — so the file tag is an outline, and the line about what\n   nobody has measured borrows the amber the key already reads as \"words only\".\n   Both are bars and pills the page has elsewhere; nothing new is introduced. */\n.unmeasured { margin: 0 0 20px; padding: 10px 14px; border-left: 3px solid var(--s-claimed); background: var(--paper-2); font-size: 15px; color: var(--ink-2); max-width: 70ch; }\n.detail .unmeasured { margin: 12px 0 0; }\n.runs { margin-top: 48px; min-width: 0; }\n.tag { display: inline-block; padding: 1px 7px; border: 1px solid var(--edge); border-radius: 999px; font-size: 12px; color: var(--ink-2); background: var(--paper); white-space: nowrap; }\n.quiet-note { font-size: 13px; color: var(--ink-3); }\n/* A note that belongs to the run above it. The run keeps no rule under it, so\n   the two read as one thing rather than as a row and a stray sentence. */\ntr.has-note > td { border-bottom: 0; }\ntd.run-note { white-space: normal; padding-top: 0; }\n/* The runs nobody folded in. Indented off the table above and set quieter, so\n   it reads as a footnote to the measurements rather than as more of them. */\n.aside { margin-top: 18px; padding-left: 12px; border-left: 1px solid var(--edge); font-size: 13px; color: var(--ink-3); max-width: 70ch; }\n.aside p { margin: 0 0 6px; }\n.aside ul { margin: 0; padding-left: 18px; }\n.aside li { overflow-wrap: anywhere; }\n\n/* ── Where it stands, and what was decided ────────────────────────────── */\n/* Five numbers a manager reads before the map. Not cards: each is a number on\n   the page's paper with the same left bar the \"Needs you\" items carry, so the\n   page keeps one way of marking a thing out. The bar is the edge colour until a\n   number means trouble — then it borrows the red the key already reads as \"the\n   system disagrees\", and nothing else on this strip is coloured. */\n.stands, .dispositions { margin: 0 0 40px; }\n.tiles { list-style: none; margin: 0 0 24px; padding: 0; display: grid; gap: 12px 20px; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); }\n.tile { padding: 2px 0 2px 12px; border-left: 3px solid var(--edge); display: grid; gap: 1px; align-content: start; }\n.tile-n { font-size: clamp(26px, 3.4vw, 32px); font-weight: 640; letter-spacing: -0.02em; line-height: 1.1; color: var(--ink); font-variant-numeric: tabular-nums; }\n.tile-label { font-size: 14.5px; font-weight: 620; color: var(--ink); }\n.tile-note { font-size: 13px; color: var(--ink-3); }\n.tile.bad { border-left-color: var(--s-regressed); }\n.tile.bad .tile-n { color: var(--s-regressed); }\n.empty-note { margin: 0 0 20px; color: var(--ink-2); max-width: 70ch; }\n\n/* The two level bars. A and B lean green, C amber, D red, \"not decided\" the\n   grey of an object nobody has started — the key's own reading of each colour,\n   so a level never asks the eye to learn a new palette. The words under each\n   bar carry the same numbers: colour is never the only way to read it. */\n.levels { display: grid; gap: 14px; max-width: 640px; }\n.levelbar { margin: 0; }\n.levelbar figcaption { font-size: 13px; font-weight: 600; color: var(--ink-2); margin-bottom: 4px; }\n.levelbar svg { display: block; width: 100%; height: 12px; border-radius: 2px; }\n.levelwords, .legend-line { margin: 4px 0 0; font-size: 13px; color: var(--ink-3); }\n.l-A { fill: var(--s-verified); background: var(--s-verified); }\n.l-B { fill: var(--s-clean); background: var(--s-clean); }\n.l-C { fill: var(--s-claimed); background: var(--s-claimed); }\n.l-D { fill: var(--s-regressed); background: var(--s-regressed); }\n.l-none { fill: var(--s-untouched); background: var(--s-untouched); }\n\n/* The five dispositions, one line. Outlined pills — the same mark as the\n   \"measured from a file\" tag — because a disposition is a person's choice,\n   not a state, and only states wear colour here. */\n.chips { list-style: none; margin: 0 0 10px; padding: 0; display: flex; flex-wrap: wrap; gap: 8px; }\n.chip { padding: 3px 11px; border: 1px solid var(--edge); border-radius: 999px; font-size: 14px; color: var(--ink-2); background: var(--paper); }\n.chip b { font-weight: 640; color: var(--ink); font-variant-numeric: tabular-nums; }\n.exceptions { max-width: 78ch; font-size: 14px; }\n.exceptions summary { cursor: pointer; color: var(--ink-2); padding: 4px 0; }\n.exceptions summary:hover, .exceptions[open] > summary { color: var(--ink); }\n.exceptions ul { margin: 6px 0 0; padding-left: 18px; }\n.exceptions li { margin-bottom: 4px; overflow-wrap: anywhere; }\n.lanes .quiet-note { margin: 8px 0 0; }\n.k-exception-no-reason { border-left-color: var(--warn); }\n\n/* ── The focus, the estate, and what the plan adds (spec 2026-10-06) ──── */\n/* The focus sits under the one line of truth as a quieter second line: the\n   same left bar as a tile, in the edge colour, because it is context for the\n   numbers, not a number that means trouble. */\n.focus-line { margin: -10px 0 22px; padding: 2px 0 2px 12px; border-left: 3px solid var(--edge); font-size: 15px; color: var(--ink-2); max-width: 70ch; overflow-wrap: anywhere; }\n/* The estate reads before the team project's own numbers. Same tiles, same\n   table, same quiet notes as the rest of the page — nothing new to learn. */\n.estate { margin: 0 0 40px; min-width: 0; }\n.estate h3 { margin: 0 0 8px; font-size: 14px; font-weight: 620; color: var(--ink-2); }\n/* The one tile whose value is words, not a count: set smaller so a sentence\n   does not shout as loudly as a number. */\n.tile-text { font-size: 16px; font-weight: 600; line-height: 1.3; color: var(--ink); overflow-wrap: anywhere; }\n.estate-scope { margin: 0 0 20px; font-size: 15px; color: var(--ink-2); }\n.estate-unknowns { margin: 0 0 24px; max-width: 78ch; font-size: 14px; }\n.estate-unknowns ul { margin: 0; padding: 0; list-style: none; }\n.estate-unknowns li { margin-bottom: 6px; padding-left: 12px; border-left: 3px solid var(--warn); overflow-wrap: anywhere; }\n.estate-unknowns p { margin: 0; }\n/* A retire nobody has confirmed yet is words only — the amber the key already\n   reads that way. The other plan items are housekeeping for the lead. */\n.tile.retire-candidates { border-left-color: var(--s-claimed); }\n.k-retire-candidate { border-left-color: var(--s-claimed); }\n.k-out-of-scope-no-reason, .k-excel-clashes { border-left-color: var(--warn); }\n/* Next names up to three objects; let them wrap rather than widen the table. */\ntd.next { white-space: normal; min-width: 14ch; }\n\n/* ── Progress over time, and the plan (spec 2026-10-06 §9 items 5, 8, 9) ── */\n/* The chart borrows the key's own colours: decided blue, claimed amber,\n   proven green. Level A is not a state, so it is the quiet ink, dotted. Each\n   line also has its own dash, and the legend says the numbers in words, so a\n   printer that drops colour or an eye that cannot tell them apart still reads\n   it. Ruled like the level bars, not carded. */\n.progress, .plan { margin: 0 0 40px; min-width: 0; }\n.progress h3, .plan h3 { margin: 20px 0 8px; font-size: 14px; font-weight: 620; color: var(--ink-2); }\n.progress-chart { margin: 0; max-width: 720px; }\n.progress-chart svg { display: block; width: 100%; height: auto; }\n.progress-chart .grid { stroke: var(--edge); stroke-width: 1; }\n.progress-chart .axis { fill: var(--ink-3); font-size: 11px; font-family: var(--font); }\n.pl { fill: none; stroke-width: 2.25; stroke-linejoin: round; stroke-linecap: round; }\n.pl-decided, .pd-decided { stroke: var(--s-decided); }\n.pl-claimed, .pd-claimed { stroke: var(--s-claimed); }\n.pl-proven, .pd-proven { stroke: var(--s-verified); }\n.pl-a, .pd-a { stroke: var(--ink-3); }\n.pl-decided { stroke-dasharray: 6 4; }\n.pl-claimed { stroke-dasharray: 2 3; }\n.pl-a { stroke-dasharray: 1 4; stroke-width: 2.5; }\n.pd { fill: var(--paper); stroke-width: 2; }\n.chart-legend { list-style: none; margin: 8px 0 0; padding: 0; display: flex; flex-wrap: wrap; gap: 4px 20px; font-size: 13px; color: var(--ink-2); }\n.key { display: inline-block; width: 18px; height: 0; margin: 0 6px 0 0; vertical-align: middle; border-top: 3px solid var(--ink-3); }\n.key-decided { border-top: 3px dashed var(--s-decided); }\n.key-claimed { border-top: 3px dotted var(--s-claimed); }\n.key-proven { border-top-color: var(--s-verified); }\n.key-a { border-top: 3px dotted var(--ink-3); }\n/* Done % per developer and per focus: a track, a fill, the number in words. */\n.pct-bars { list-style: none; margin: 0; padding: 0; display: grid; gap: 8px; max-width: 720px; }\n.pct-bars li { display: grid; grid-template-columns: minmax(10ch, 16rem) minmax(80px, 1fr) auto; gap: 4px 12px; align-items: center; font-size: 14px; }\n.pct-label { overflow-wrap: anywhere; color: var(--ink); }\n.pct-bar { display: block; height: 10px; border-radius: 2px; background: var(--s-untouched); overflow: hidden; }\n.pct-fill { display: block; height: 100%; background: var(--s-verified); }\n.pct-fill.f-focus { background: var(--s-clean); }\n.pct-n { font-size: 13px; color: var(--ink-3); font-variant-numeric: tabular-nums; white-space: nowrap; }\n@media (max-width: 560px) { .pct-bars li { grid-template-columns: 1fr auto; } .pct-bar { grid-column: 1 / -1; grid-row: 2; } }\n.w-0{width:0%} .w-5{width:5%} .w-10{width:10%} .w-15{width:15%} .w-20{width:20%} .w-25{width:25%} .w-30{width:30%} .w-35{width:35%} .w-40{width:40%} .w-45{width:45%} .w-50{width:50%} .w-55{width:55%} .w-60{width:60%} .w-65{width:65%} .w-70{width:70%} .w-75{width:75%} .w-80{width:80%} .w-85{width:85%} .w-90{width:90%} .w-95{width:95%} .w-100{width:100%}\n.plan-weights { margin: 0 0 12px; font-size: 14.5px; color: var(--ink-2); max-width: 78ch; }\n.focus-stack { margin: 0; padding-left: 22px; max-width: 78ch; font-size: 14px; }\n.focus-stack li { margin-bottom: 6px; overflow-wrap: anywhere; }\ntd.what { white-space: normal; min-width: 18ch; overflow-wrap: anywhere; }\n/* The detail panel's longer evidence: two small lists, the replaced decisions quieter. */\n.detail h4 { margin: 14px 0 6px; font-size: 13.5px; font-weight: 620; color: var(--ink-2); }\n.detail .history { margin: 0 0 8px; padding-left: 18px; font-size: 14px; }\n.detail .history li { margin-bottom: 4px; overflow-wrap: anywhere; }\n.detail .history li.superseded { color: var(--ink-3); }\n\n/* ── Paper ────────────────────────────────────────────────────────────── */\n/* Paper is white, whatever the machine is set to. A manager on a dark-mode\n   laptop who prints this — or prints the status file they were mailed, which\n   carries this stylesheet inside it — would otherwise get white ink on white\n   paper, and the map is the whole message. Every token the dark theme\n   overrides is put back here to its light value; a test reads both lists and\n   fails if one of them gains a token the other does not. */\n@media print {\n  :root {\n    --paper: oklch(0.97 0.006 80); --paper-2: oklch(0.94 0.008 80); --ink: oklch(0.20 0.012 40);\n    --ink-2: oklch(0.34 0.012 40); --ink-3: oklch(0.48 0.010 40); --edge: oklch(0.88 0.010 80);\n    --s-untouched: oklch(0.84 0.006 80); --s-retired: oklch(0.93 0.004 80);\n    --paper-3: oklch(0.91 0.010 80); --ink-4: oklch(0.62 0.008 40); --edge-2: oklch(0.82 0.012 80);\n    --peach-soft: oklch(0.92 0.05 35); --peach-wash: oklch(0.97 0.02 35); --dgm-node: #ffffff;\n  }\n}\n\n@media print {\n  .actions, .detail { display: none; }\n  #app { max-width: none; padding: 0; }\n  .pair { grid-template-columns: 1fr; }\n  .cell { cursor: default; }\n  /* The map is the message. A printer that drops the colour prints nothing.\n     `.notice` is on this list for the status file: on paper it is the line that\n     says the picture may be incomplete, and a caveat with its mark stripped off\n     is a caveat somebody skims past. */\n  .cell, .swatch, .need, .notice, .unmeasured, .tag, .diagram, .tile, .lvl, .chip, .focus-line, .estate-unknowns li, .pct-bar, .pct-fill, .pl, .key { print-color-adjust: exact; -webkit-print-color-adjust: exact; }\n  footer, .needs, .lanes, .runs, .stands, .dispositions, .estate-unknowns, .progress-chart, .pct-bars { break-inside: avoid; }\n  /* A printed list of exceptions that stays folded is a list nobody can read. */\n  .exceptions:not([open]) > :not(summary) { display: block; }\n  .exceptions::details-content { content-visibility: visible; }\n}\n";

package/dist/register/status-file-sync.js

@@ -0,0 +1,22 @@
+/**
+ * Which viewer files the CLI carries a copy of, and how each copy is written.
+ * Shared by scripts/sync-status-file.ts and the pin test.
+ */
+export const COPIES = [
+    ['../viewer/src/lib/register-map.js', 'src/register/status-file/register-map.ts'],
+    ['../viewer/src/lib/register-model.js', 'src/register/status-file/register-model.ts'],
+    ['../viewer/src/lib/register-parts.js', 'src/register/status-file/register-parts.ts'],
+    ['../viewer/src/lib/register-status-file.js', 'src/register/status-file/register-status-file.ts'],
+    ['../viewer/src/lib/estate-parts.js', 'src/register/status-file/estate-parts.ts'],
+    ['../viewer/src/lib/progress-chart.js', 'src/register/status-file/progress-chart.ts'],
+    ['../viewer/src/lib/plan-parts.js', 'src/register/status-file/plan-parts.ts'],
+    ['../viewer/src/team/team.css', 'src/register/status-file/team-css.ts'],
+];
+export const HEADER = (from) => [
+    '// @ts-nocheck',
+    `// GENERATED COPY — do not edit here. Edit ${from.replace('../', '')},`,
+    '// then run `npx tsx scripts/sync-status-file.ts` (prebuild runs it too).',
+    '// src/register/__tests__/status-file-pin.test.ts fails when this copy drifts.',
+    '',
+].join('\n');
+export const cssModule = (css) => `${HEADER('../viewer/src/team/team.css')}export const TEAM_CSS = ${JSON.stringify(css)};\n`;

package/dist/register/status-html.js

@@ -0,0 +1,19 @@
+import { buildStatusHtml as buildStatusHtmlUntyped } from './status-file/register-status-file.js';
+import { needsYou as needsYouUntyped, packageBlocks, summarize } from './status-file/register-model.js';
+import { TEAM_CSS } from './status-file/team-css.js';
+// The copy is plain JavaScript under `// @ts-nocheck`, so TypeScript infers
+// `needsYou`'s options from its `= {}` default and loses `now`. Say the shape
+// here rather than edit the generated copy.
+const needsYou = needsYouUntyped;
+// The same for `estate`: its `= undefined` default reads as "always undefined".
+const buildStatusHtml = buildStatusHtmlUntyped;
+export function statusHtmlFor(view) {
+    const { register, unreadable, asOf } = view;
+    return buildStatusHtml({
+        ...view,
+        summary: summarize(register, { unreadable }),
+        needs: needsYou(register, { now: asOf, unreadable, surface: 'file' }),
+        blocks: packageBlocks(register),
+        css: TEAM_CSS,
+    });
+}

package/dist/register/store.js

@@ -178,7 +178,7 @@ function readRecord(file) {
         return { ok: false };
     }
 }
-/** Every record-shaped JSON under a folder: writers/<id>/records, rulings, baseline/measurement-*.json. */
+/** Every record-shaped JSON under a folder: writers/<id>/records, rulings, plan, baseline/measurement-*.json, baseline/evidence-*.json. */
 export function collectRecords(root) {
     const records = [];
     let unreadable = 0;
@@ -213,9 +213,12 @@ export function collectRecords(root) {
     for (const w of writers)
         readDir(path.join(root, 'writers', w, 'records'));
     readDir(path.join(root, 'rulings'));
+    // The lead's plan records (spec 2026-10-06 §6.1): written only by the lead, read like any other.
+    readDir(path.join(root, 'plan'));
     try {
         for (const name of fs.readdirSync(path.join(root, 'baseline'))) {
-            if (!/^measurement-.*\.json$/i.test(name))
+            // Measurement zero and the inventory's evidence (evidence-0.json).
+            if (!/^(measurement|evidence)-.*\.json$/i.test(name))
                 continue;
             // Measurement zero lands here, written by the lead and then synced: the
             // same hazards as any other record, read the same way.
@@ -225,3 +228,38 @@ export function collectRecords(root) {
     catch { /* no baseline folder here (an outbox has none) */ }
     return { records, unreadable, files };
 }
+export const DISCOVERY_DIR = 'discovery';
+const ESTATE_FILE = /^estate-(\d{8}T\d{6}Z(?:-\d{1,4})?)\.json$/;
+/** Newest first: by the time, then by the `-n` a second discovery of the same second carries (-10 after -2). */
+const newestStampFirst = (a, b) => {
+    const [ta = '', na = '1'] = a.split('-');
+    const [tb = '', nb = '1'] = b.split('-');
+    return ta !== tb ? (ta < tb ? 1 : -1) : Number(nb) - Number(na);
+};
+/**
+ * The newest discovery in a folder (spec 2026-10-06 §5.2): `estate-<stamp>.json`
+ * and the `objects-<stamp>.json` of the same stamp. Older discoveries stay on
+ * disk as history and are never read here. A newest file that cannot be read
+ * (half synced) gives way to the one before it; `objects` is null when its
+ * file is missing or unreadable. Neither file is a record, and both are handed
+ * on as they are: the readers downstream read them the strict way.
+ */
+export function readEstate(dir) {
+    const folder = path.join(dir, DISCOVERY_DIR);
+    let names = [];
+    try {
+        names = fs.readdirSync(folder);
+    }
+    catch {
+        return null;
+    }
+    const stamps = names.map((n) => ESTATE_FILE.exec(n)?.[1]).filter((s) => !!s).sort(newestStampFirst);
+    for (const stamp of stamps) {
+        const estate = readRecord(path.join(folder, `estate-${stamp}.json`));
+        if (!estate.ok || !estate.value || typeof estate.value !== 'object')
+            continue;
+        const objects = readRecord(path.join(folder, `objects-${stamp}.json`));
+        return { estate: estate.value, objects: objects.ok ? objects.value : null, stamp };
+    }
+    return null;
+}

package/dist/register/workbooks.js

@@ -0,0 +1,124 @@
+/**
+ * The two workbooks (spec §6.2, §6.3), built from the sheet model in
+ * register-core — the same functions the team page prints — so a number in
+ * Excel and the same number on the page cannot differ.
+ *
+ * Regenerated, never read back: an edit typed into a workbook changes nothing.
+ * A workbook is not a `.json` record, so no reader can mistake it for one.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { developerTable, estateSheets, levelTable, measurementTable, overlapNote, packageTable, planRows, priorityRulesRows, progressRows, summaryRows, utcWords, workingListRows, PLAN_COLUMNS, PLAN_EDITABLE, WORKING_LIST_COLUMNS, } from '@cspeach/register-core';
+import { registerFor } from './picture.js';
+import { safeFileStem, writeXlsxFile } from './xlsx.js';
+const LIST_WIDTHS = [28, 6, 16, 6, 8, 22, 48, 26, 10, 10, 20, 18, 20, 22];
+const PLAN_WIDTHS = [28, 6, 16, 22, 9, 9, 12, 40, 3, 10, 18, 20, 7, 22, 20, 10];
+/** The Read me line `plan import` reads the export stamp from. */
+export const EXPORT_STAMP = 'Export stamp: ';
+const LEVEL_LINE = 'Levels: A uses only released APIs. B calls public classic APIs. C uses SAP-internal objects. D modifies SAP standard.';
+export const workingListFileName = (name) => `${safeFileStem(name)} - working list.xlsx`;
+export const reportFileNames = (projectName) => ({
+    xlsx: `${safeFileStem(projectName)} - clean core.xlsx`, html: `${safeFileStem(projectName)} - status.html`,
+});
+const readMe = (lines) => ({ name: 'Read me', header: ['Read me'], rows: lines.map((l) => [l]), widths: [110], filter: false });
+const sameName = (a, b) => a.trim().toLowerCase() === b.trim().toLowerCase();
+export function workingListSheets(register, laneIds, who, asOf, folderName) {
+    return [
+        { name: 'Working list', header: [...WORKING_LIST_COLUMNS], rows: workingListRows(register, laneIds), widths: LIST_WIDTHS },
+        readMe([
+            `Made by CSPeach for ${who} on ${utcWords(asOf)}, from the team project folder "${folderName}".`,
+            'This file is made again after every decision, fix or measurement this laptop records. Changes typed here are not read back.',
+            'Record a decision with: cspeach team decide <TYPE> <NAME> <decision>',
+            'Record a fix with: cspeach team fixed <TYPE> <NAME>',
+            'It shows the team project as this laptop sees it, including records not handed in yet, so it can be ahead of the team page.',
+            LEVEL_LINE,
+        ]),
+    ];
+}
+const table = (t) => [t.header, ...t.rows];
+/** The D sentence: the demo's words only when they are true of every active object (claimed ≠ proven). */
+function dSentence(register) {
+    const b = register.totals.byLevel;
+    // An object with nothing to decide was never judged either: the demo's words still need every object judged.
+    const everyoneJudged = b.decided.none === 0 && b.now.none === 0 && !b.nothingToDecide;
+    return everyoneJudged && b.decided.D === 0 && b.now.D === 0
+        ? 'D means an object that modifies SAP standard; none of the objects in these packages does.'
+        : 'D means an object that modifies SAP standard; no object here has been judged D.';
+}
+export function combinedSheets(register, asOf, folderName) {
+    const note = overlapNote(register);
+    const summary = [
+        ...summaryRows(register),
+        [], ...table(levelTable(register)),
+        [], ...table(packageTable(register)),
+        [], ...table(developerTable(register)),
+        ...(note ? [[note]] : []),
+    ];
+    const lanes = register.lanes.map((l) => ({
+        name: l.owner, header: [...WORKING_LIST_COLUMNS], rows: workingListRows(register, [l.id]), widths: LIST_WIDTHS,
+    }));
+    const runs = measurementTable(register);
+    const progress = progressRows(register);
+    const capped = register.progressCapped;
+    const rules = priorityRulesRows(register);
+    const estate = register.estate ? estateSheets(register.estate).find((s) => s.name === 'Packages')?.table : undefined;
+    return [
+        { name: 'Summary', header: ['Summary', 'Count'], rows: summary, widths: [34, 14, 12, 12, 12, 12, 14, 12, 22], filter: false },
+        // Before the lane sheets, so a lane owner called "Plan" never takes the name plan import looks for.
+        { name: 'Plan', header: [...PLAN_COLUMNS], rows: planRows(register), widths: PLAN_WIDTHS },
+        { name: 'All objects', header: [...WORKING_LIST_COLUMNS], rows: workingListRows(register, null), widths: LIST_WIDTHS },
+        ...lanes,
+        { name: 'Measurements', header: runs.header, rows: runs.rows, widths: [20, 20, 26, 22, 10, 14, 24] },
+        {
+            name: 'Progress', header: progress.header, widths: [20, 9, 9, 9, 9, 9, 9, 10, 13], filter: !capped,
+            rows: [...progress.rows, ...(capped ? [[], [`Showing the last ${capped.shown} of ${capped.total} check runs.`]] : [])],
+        },
+        { name: 'Priority rules', header: rules.header, rows: rules.rows, widths: [24, 18, 30], filter: false },
+        ...(estate ? [{ name: 'Estate inventory', header: estate.header, rows: estate.rows, widths: [22, 34, 18, 18, 16, 9, 12, 15, 10, 20, 16, 9] }] : []),
+        readMe([
+            `Made by CSPeach on ${utcWords(asOf)}, from the team project folder "${folderName}".`,
+            `${EXPORT_STAMP}${asOf}`,
+            `Edit only the five columns before the dash: ${PLAN_EDITABLE.join(', ')}.`,
+            'Bring the sheet back with: cspeach team plan import <file>',
+            'Changes made by someone else after this export are shown and skipped, never overwritten.',
+            'The numbers are the same ones the team page shows for this folder.',
+            'This file is made again by cspeach team report. Only the Plan sheet is read back, and only through plan import.',
+            'Proven means a check run said so. A claimed fix is not counted as proven.',
+            'A level moves only when a check proves the fix.',
+            LEVEL_LINE,
+            dSentence(register),
+        ]),
+    ];
+}
+export const HELD = new Set(['EBUSY', 'EPERM', 'EACCES', 'EISDIR', 'ENOTEMPTY']);
+/**
+ * This writer's working list, made again from the folder as this laptop sees it
+ * (team project folder + own outbox). Never throws: a record is written whether
+ * or not its workbook could be, and the person is told in one line.
+ */
+export function regenerateWorkingList(joined, who, now = new Date()) {
+    try {
+        const { register } = registerFor(joined.projectDir, joined.outboxDir);
+        const mine = register.lanes.filter((l) => sameName(l.owner, who)).map((l) => l.id);
+        if (!mine.length)
+            return { file: null, line: null, ownsLane: false, kind: 'none' };
+        const name = workingListFileName(who);
+        const file = path.join(joined.outboxDir, 'writers', joined.writerId, name);
+        try {
+            writeXlsxFile(file, workingListSheets(register, mine, who, now.toISOString(), path.basename(joined.projectDir)));
+        }
+        catch (e) {
+            const code = e?.code ?? '';
+            if (HELD.has(code))
+                return { file: null, line: '  ! Your working list is open in another program, so it was not updated. Close it and run: cspeach team sheet', ownsLane: true, kind: 'held' };
+            throw e;
+        }
+        return { file, line: `  Your working list is updated: ${name}`, ownsLane: true, kind: 'updated' };
+    }
+    catch {
+        // Fixed words: the error text can carry full folder paths, which never go on screen.
+        return { file: null, line: '  ! Your working list could not be updated: the team project folder could not be read. Run cspeach team status for the reason.', ownsLane: true, kind: 'unreadable' };
+    }
+}
+/** True when `file` sits where a working list goes; used by tests and by `sheet`. */
+export const workingListExists = (file) => !!file && fs.existsSync(file);

package/dist/register/write-whole.js

@@ -0,0 +1,22 @@
+/**
+ * Whole, then renamed — like a record. A sync tool must never pick up half a
+ * file, and a refused rename must not leave a stray `.tmp` in a folder a whole
+ * team syncs. The error the caller gets is the real one.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export function writeWhole(file, data) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const tmp = `${file}.tmp`;
+    fs.writeFileSync(tmp, data);
+    try {
+        fs.renameSync(tmp, file);
+    }
+    catch (e) {
+        try {
+            fs.unlinkSync(tmp);
+        }
+        catch { /* the reason the rename failed may be the reason this fails too */ }
+        throw e;
+    }
+}