@turri-dev/cli 0.1.4-next.5a94e68 → 0.1.4-next.8254fbc

package/dist/brand.js

@@ -2,8 +2,8 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 /**
- * turri's colours for what its command line prints - the ones its themes use (.pi/themes): on a dark terminal its lime
- * accent and green, on a light one its blue. Nothing is coloured when the output is not a terminal, or NO_COLOR is set;
+ * turri's colours for what its command line prints - the design system's, as its themes use them (.pi/themes): on a
+ * dark terminal neon and pink, on a light one blue whale and eggplant. Nothing is coloured when the output is not a terminal, or NO_COLOR is set;
  * a terminal without 24-bit colour gets the nearest of its sixteen.
  */
 /** Whether the terminal is light: COLORFGBG says so (a light background, 7 or 15), or pi's theme is a light one. */
@@ -35,15 +35,15 @@ function paint(stream = process.stdout) {
     };
     return {
         /** turri's accent: what to look at - a heading, a choice's number, the command to run. */
-        accent: light ? ink("#0a1fd4", 34) : ink("#e0ff6e", 93),
+        accent: light ? ink("#1e3442", 34) : ink("#5ce1e6", 96),
         /** Done, and what was written. */
-        success: light ? ink("#223936", 32) : ink("#79fc96", 92),
+        success: light ? ink("#732553", 35) : ink("#ff5c8d", 95),
         /** What is wrong: what stops turri. */
-        error: light ? ink("#d00505", 31) : ink("#dd5353", 91),
+        error: ink("#ff7a3d", 33),
         /** What works, with limits. */
-        warning: ink("#dc6803", 33),
+        warning: ink("#ff7a3d", 33),
         /** What goes with it, and can be skimmed. */
-        muted: ink("#808080", 90),
+        muted: light ? ink("#3e5a6b", 90) : ink("#85a3b2", 37),
         bold: (text) => (on ? `\x1b[1m${text}\x1b[22m` : text),
     };
 }

package/dist/cultivate-cli.js

@@ -7,40 +7,33 @@ import { skillRunDir } from "./regenerate/paths.js";
 import { loadSkill } from "./skill.js";
 import { discoverSkills } from "./skills.js";
 import { PACKAGE_ROOT } from "./environment.js";
-const c = {
-    dim: (s) => `\x1b[2m${s}\x1b[0m`,
-    bold: (s) => `\x1b[1m${s}\x1b[0m`,
-    green: (s) => `\x1b[32m${s}\x1b[0m`,
-    red: (s) => `\x1b[31m${s}\x1b[0m`,
-    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
-    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
-};
+import { c } from "./module-report.js";
 const reporter = {
-    step: (name, attempt) => console.log(`\n${c.bold(c.cyan(`> step ${name}`))} ${c.dim(`attempt ${attempt}`)}`),
+    step: (name, attempt) => console.log(`\n${c.bold(c.accent(`> step ${name}`))} ${c.dim(`attempt ${attempt}`)}`),
     artifact: (path, body) => {
         console.log(c.dim(`  ${path}:`));
         for (const line of body.split("\n"))
             console.log(c.dim(`  | ${line}`));
     },
     gate: (name, judges) => console.log(judges === 0
-        ? `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim("no artifact - failing without spending judges")}`
-        : `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim(`${judges} independent judges`)}`),
+        ? `${c.bold(c.warning(`> gate ${name}`))} ${c.dim("no artifact - failing without spending judges")}`
+        : `${c.bold(c.warning(`> gate ${name}`))} ${c.dim(`${judges} independent judges`)}`),
     livePass: (step, scope, findings) => console.log(findings === 0
         ? c.dim(`  review ${step}: ${scope} - clean`)
-        : `  ${c.yellow(`review ${step}`)}: ${scope} ${c.dim(`- ${findings} to fix`)}`),
+        : `  ${c.warning(`review ${step}`)}: ${scope} ${c.dim(`- ${findings} to fix`)}`),
     liveReview: (name, passes, findings) => console.log(findings === 0
-        ? `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim(`reviewer read along in ${passes} passes, nothing outstanding`)}`
-        : `${c.bold(c.yellow(`> gate ${name}`))} ${c.dim(`${findings} unresolved from the reviewer - failing without spending judges`)}`),
+        ? `${c.bold(c.warning(`> gate ${name}`))} ${c.dim(`reviewer read along in ${passes} passes, nothing outstanding`)}`
+        : `${c.bold(c.warning(`> gate ${name}`))} ${c.dim(`${findings} unresolved from the reviewer - failing without spending judges`)}`),
     judge: (index, model, verdict, violations) => {
-        const mark = verdict === "pass" ? c.green("pass") : c.red(verdict);
+        const mark = verdict === "pass" ? c.success("pass") : c.error(verdict);
         console.log(`  judge ${index + 1} ${c.dim(`(${model})`)}: ${mark}${violations ? c.dim(` (${violations})`) : ""}`);
     },
     outcome: (name, decision, critique) => {
         const colour = {
-            advance: c.green,
-            retry: c.yellow,
-            escalate: c.yellow,
-            abort: c.red,
+            advance: c.success,
+            retry: c.warning,
+            escalate: c.warning,
+            abort: c.error,
         };
         console.log(`  ${c.bold(colour[decision](decision))} ${c.dim(`<- gate ${name}`)}`);
         if (critique)
@@ -78,7 +71,7 @@ async function main() {
             select: async (title, options, context) => {
                 const rl = createInterface({ input: process.stdin, output: process.stdout });
                 const list = options.map((option, i) => `  ${c.bold(String(i + 1))}. ${option}`).join("\n");
-                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.cyan("? "))}${title}\n${list}\n> `)).trim();
+                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.accent("? "))}${title}\n${list}\n> `)).trim();
                 rl.close();
                 const index = Number.parseInt(reply, 10);
                 if (Number.isInteger(index) && index >= 1 && index <= options.length)
@@ -87,13 +80,13 @@ async function main() {
             },
             input: async (title, context) => {
                 const rl = createInterface({ input: process.stdin, output: process.stdout });
-                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.cyan("? "))}${title}\n> `)).trim();
+                const reply = (await rl.question(`\n${context !== undefined ? `${context}\n\n` : ""}${c.bold(c.accent("? "))}${title}\n> `)).trim();
                 rl.close();
                 return reply === "" ? undefined : reply;
             },
         }),
         escalate: async ({ question, critique }) => {
-            console.log(`\n${c.bold(c.yellow("! human review required"))}`);
+            console.log(`\n${c.bold(c.warning("! human review required"))}`);
             console.log(c.dim(critique));
             const rl = createInterface({ input: process.stdin, output: process.stdout });
             const answer = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
@@ -101,7 +94,7 @@ async function main() {
             return answer === "y";
         },
     });
-    console.log(`\n${result.ok ? c.green(c.bold("run complete")) : c.red(c.bold("run aborted at a gate"))} ${c.dim(`artifacts in ${relative(cwd, skillRunDir(cwd, skill.name))}`)}`);
+    console.log(`\n${result.ok ? c.success(c.bold("run complete")) : c.error(c.bold("run aborted at a gate"))} ${c.dim(`artifacts in ${relative(cwd, skillRunDir(cwd, skill.name))}`)}`);
     process.exit(result.ok ? 0 : 1);
 }
 main().catch((err) => {

package/dist/extension.js

@@ -29,7 +29,7 @@ import { describeChoices, describeResolution, modelFor, resolveModel } from "./r
 import { checkPlainFile, checkPlainTargets, formatCheckResults } from "./plain/check.js";
 import { whyFailed } from "./regenerate/diagnose-job.js";
 import { createWorkLoop, describeModules, isUpToDate, previewJobs } from "./regenerate/loop.js";
-import { brandBlue, plainPaint } from "./regenerate/plain-palette.js";
+import { brandNeon, brandPink, plainPaint } from "./regenerate/plain-palette.js";
 import { createJobPanel, didNotPass, keyPressed, PANEL_KEY, spinner } from "./regenerate/job-panel.js";
 import { clickToFocus, dockedWidth, narrowChat, shade, shadeChat } from "./regenerate/panel-dock.js";
 import { overPictureRow, PICTURE_AT } from "./picture-row.js";
@@ -1517,7 +1517,8 @@ function registerJobTools(pi, jobs, cwd) {
     });
     // The side panel: the regeneration - and the pulses behind p - over the whole screen, or beside the chat (s, from one to
     // the other). Its key (PANEL_KEY) opens it; the key again closes it and goes back to the chat, as esc does over the
-    // screen - beside the chat, esc gives the chat its keys back and the panel stays, and the key gives them to the panel.
+    // screen - beside the chat, the key switches sides, giving the keys to the chat or the panel, as esc gives them to the
+    // chat, the panel staying; ctrl+c closes it.
     // While the panel has the keys, every key is its own.
     let panel;
     // Beside the chat or over it: as the person last left it, for the conversation.
@@ -1645,8 +1646,8 @@ function registerJobTools(pi, jobs, cwd) {
                     removed: (text) => theme.fg("toolDiffRemoved", text),
                     // A spec diff's ***plain highlighted as plyn highlights it, and its added and removed lines filled.
                     diff: plainPaint(theme),
-                    // What conformance tests show does what its spec says: brand blue.
-                    conforms: brandBlue(theme),
+                    // What conformance tests show does what its spec says: neon.
+                    conforms: brandNeon(theme),
                 },
                 back,
                 close,
@@ -1688,17 +1689,6 @@ function registerJobTools(pi, jobs, cwd) {
                 }
                 if (!state)
                     return undefined;
-                // Beside the chat, ⌥⌘← and ⌥⌘→ go to the side they point at, whichever has the keys - on a terminal that tells
-                // turri of ⌘ (the Kitty keyboard protocol). Its release goes nowhere.
-                if (panelBeside() > 0 && (matchesKey(data, SIDE_KEYS.chat) || matchesKey(data, SIDE_KEYS.panel))) {
-                    if (!isKeyRelease(data)) {
-                        if (matchesKey(data, SIDE_KEYS.chat))
-                            toChat();
-                        else
-                            toPanel();
-                    }
-                    return { consume: true };
-                }
                 // Beside the chat, with the chat's keys: they are the chat's - PANEL_KEY among them, for the shortcut that gives
                 // them to the panel. A click on the panel gives it the focus, and the keys with it.
                 if (!entry.keys && entry.handle?.isFocused() !== true)
@@ -1709,9 +1699,13 @@ function registerJobTools(pi, jobs, cwd) {
                 // presses count - and ctrl+h held down, repeating, does not open and close it over and over.
                 if (isKeyRelease(data) || (isKeyRepeat(data) && matchesKey(data, PANEL_KEY)))
                     return { consume: true };
-                // ctrl+c closes it too: whatever else goes wrong, a key always leads back to the chat.
-                if (matchesKey(data, PANEL_KEY) || matchesKey(data, "ctrl+c"))
+                // PANEL_KEY goes back: beside the chat, to the chat, the panel staying - the switch between the sides, as it is
+                // from the chat to the panel - and over the screen, closing it. ctrl+c closes it either way: whatever else goes
+                // wrong, a key always leads back to the chat.
+                if (matchesKey(data, "ctrl+c"))
                     close();
+                else if (matchesKey(data, PANEL_KEY))
+                    back();
                 else {
                     try {
                         view.handleInput(data);
@@ -1741,8 +1735,10 @@ function registerJobTools(pi, jobs, cwd) {
                 handleInput: (data) => {
                     if (isKeyRepeat(data) && matchesKey(data, PANEL_KEY))
                         return;
-                    if (matchesKey(data, PANEL_KEY))
+                    if (matchesKey(data, "ctrl+c"))
                         close();
+                    else if (matchesKey(data, PANEL_KEY))
+                        back();
                     else
                         view.handleInput(data);
                     tui.requestRender();
@@ -1877,8 +1873,6 @@ export const JOB_FINISHED_REACTION = [
     "  to do, and that \"resume\" picks it up once it is in.",
     "- a credential `agent-env:` names that is not there: never make one up - tell the person where it is read from.",
 ].join("\n");
-/** The keys that go to the chat and to the panel, side by side: ⌥⌘← and ⌥⌘→. */
-const SIDE_KEYS = { chat: "alt+super+left", panel: "alt+super+right" };
 /** Opens the side panel, and goes back to it from the conversation. */
 /** The modules in this project that have a history, by name. */
 function modulesWithHistory(cwd) {
@@ -2314,7 +2308,7 @@ function registerBranding(pi, ruleCount, skills) {
         if (data === undefined)
             return undefined;
         const lines = [
-            `${theme.fg("accent", "turri")}  ${theme.fg("muted", `v${data.version}`)}` +
+            `${brandPink(theme)("turri")}  ${theme.fg("muted", `v${data.version}`)}` +
                 (data.commit !== undefined ? theme.fg("dim", `  from a clone, ${data.commit}${data.changed ? " with changes" : ""}`) : ""),
             theme.fg("text", "regenerative software - the code is regenerated from the spec"),
             theme.fg("muted", `${data.rules} rules · ${data.skills} skill${data.skills === 1 ? "" : "s"}` +

package/dist/loop-cli.js

@@ -80,17 +80,17 @@ async function runLoopReporting(options) {
                 return;
             seen.set(job.id, line);
             if (job.status === "running")
-                console.log(`${c.cyan(`▶ ${job.id}`)} ${pulseName(job)}${job.stage !== undefined ? c.dim(` - ${job.stage}`) : ""}`);
+                console.log(`${c.accent(`▶ ${job.id}`)} ${pulseName(job)}${job.stage !== undefined ? c.dim(` - ${job.stage}`) : ""}`);
         },
         onFinish: (job) => {
-            const mark = job.status === "succeeded" ? c.green("✓") : job.status === "stopped" ? c.dim("■") : c.red("✗");
+            const mark = job.status === "succeeded" ? c.success("✓") : job.status === "stopped" ? c.dim("■") : c.error("✗");
             console.log(`${mark} ${job.id} ${pulseName(job)} - ${job.status}`);
             if (job.status !== "succeeded")
                 console.log(c.dim((job.announce ?? job.report ?? job.error ?? "").trim()));
             // Its report is not printed when it succeeds, and nobody is asked here: the spec gaps its agents met are said.
             else
                 for (const gap of job.details?.specGaps ?? [])
-                    console.log(c.yellow(`  spec gap: ${gap.question}`), c.dim(`Meanwhile: ${gap.assumption}`));
+                    console.log(c.warning(`  spec gap: ${gap.question}`), c.dim(`Meanwhile: ${gap.assumption}`));
             report?.write();
         },
     });
@@ -98,7 +98,7 @@ async function runLoopReporting(options) {
     onModelEvent((event) => {
         const line = describeTurnIncident(event);
         if (line !== undefined)
-            console.log(c.yellow(`  ${event.job !== undefined ? `${event.job}: ` : ""}${line}`));
+            console.log(c.warning(`  ${event.job !== undefined ? `${event.job}: ` : ""}${line}`));
     });
     const planner = modelSpec(projectModels(project).harness);
     const loop = createWorkLoop({
@@ -131,7 +131,7 @@ async function runLoopReporting(options) {
         // No terminal and no --start-over: no one to ask, so the run stops here rather than build nothing and say it is done.
         if (options.startOver !== true && process.stdin.isTTY !== true) {
             const message = `${why}\nThere is no terminal to ask whether to start over: run it again with --start-over to start over without asking.`;
-            console.error(c.red(message));
+            console.error(c.error(message));
             report?.end("incomplete", message);
             process.exit(1);
         }
@@ -162,10 +162,10 @@ async function runLoopReporting(options) {
     // waiting for a start over, nothing the planner left out.
     const unfinished = moduleStates(loop.drift(plainFile)).filter((module) => module.state !== "complete");
     const verdict = failed.length > 0
-        ? c.red(c.bold(`${failed.length} job${failed.length === 1 ? "" : "s"} failed`))
+        ? c.error(c.bold(`${failed.length} job${failed.length === 1 ? "" : "s"} failed`))
         : unfinished.length > 0
-            ? c.red(c.bold(`not complete: ${unfinished.map((module) => `${module.module}${module.why !== undefined ? ` - ${module.why}` : ""}`).join("; ")}`))
-            : c.green(c.bold("all jobs done"));
+            ? c.error(c.bold(`not complete: ${unfinished.map((module) => `${module.module}${module.why !== undefined ? ` - ${module.why}` : ""}`).join("; ")}`))
+            : c.success(c.bold("all jobs done"));
     console.log(`\n${verdict}`);
     for (const job of [...ended].reverse())
         console.log(`  ${job.id} ${pulseName(job)}: ${job.status}`);

package/dist/module-report.js

@@ -1,9 +1,10 @@
+import { brand } from "./brand.js";
 /** Colours for what the command line prints. */
 export const c = {
     dim: (s) => `\x1b[2m${s}\x1b[0m`,
     bold: (s) => `\x1b[1m${s}\x1b[0m`,
-    green: (s) => `\x1b[32m${s}\x1b[0m`,
-    red: (s) => `\x1b[31m${s}\x1b[0m`,
-    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
-    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+    success: brand.success,
+    error: brand.error,
+    warning: brand.warning,
+    accent: brand.accent,
 };

package/dist/regenerate/plain-palette.js

@@ -1,38 +1,46 @@
-/** On a dark surface - turri-dark's #0f0f0f, pi's dark ones. Every colour at least 7:1 on it, and 4.5:1 on the fills. */
+/**
+ * On a dark surface - turri-dark's abyss, #0a0f1a, pi's dark ones - in the design system's colours alone: a section's
+ * header in pink, a concept in neon, text in quotes or backticks in siesta tan. Every colour at least 7:1 on abyss and 4.8:1 on the blue whale fill
+ * of an added line; on the eggplant of a removed one, the design system's only fill of that warmth, its pinks and
+ * grauzone drop to 3.7:1.
+ */
 const DARK = {
     roles: {
-        section: { colour: "#fcd34d", bold: true },
-        concept: { colour: "#7dd3fc" },
-        link: { colour: "#c4b5fd", underline: true },
-        literal: { colour: "#fdba74" },
-        keyword: { colour: "#f9a8d4", bold: true },
-        module: { colour: "#5eead4" },
-        comment: { colour: "#b4bfcf", italic: true },
-        bullet: { colour: "#b4bfcf" },
+        section: { colour: "#ff7fa6", bold: true },
+        concept: { colour: "#5ce1e6" },
+        link: { colour: "#f4f7f9", underline: true },
+        literal: { colour: "#e9d8c8" },
+        keyword: { colour: "#f4f7f9", bold: true },
+        module: { colour: "#f4f7f9" },
+        comment: { colour: "#85a3b2", italic: true },
+        bullet: { colour: "#85a3b2" },
     },
-    added: "#86efac",
-    removed: "#fca5a5",
-    addedFill: "#1f4d2e",
-    removedFill: "#5c2323",
-    muted: "#808080",
+    added: "#5ce1e6",
+    removed: "#ff7fa6",
+    addedFill: "#1e3442",
+    removedFill: "#732553",
+    muted: "#85a3b2",
 };
-/** On a light surface - turri-light's white, pi's light ones. Every colour at least 7:1 on it, and 5:1 on the fills. */
+/**
+ * On a light surface - turri-light's white, pi's light ones - in the design system's deep colours, the only ones it has
+ * that read on white. Every colour at least 7:1 on white, and 5:1 on the neon hover and siesta tan fills.
+ */
 const LIGHT = {
     roles: {
-        section: { colour: "#0a1fd4", bold: true },
-        concept: { colour: "#155e75" },
-        link: { colour: "#6d28d9", underline: true },
-        literal: { colour: "#92400e" },
-        keyword: { colour: "#9d174d", bold: true },
-        module: { colour: "#065f46" },
-        comment: { colour: "#475569", italic: true },
-        bullet: { colour: "#475569" },
+        section: { colour: "#3e5a6b", bold: true },
+        concept: { colour: "#732553" },
+        link: { colour: "#1e3442", underline: true },
+        literal: { colour: "#1e3442" },
+        keyword: { colour: "#0a0f1a", bold: true },
+        module: { colour: "#1e3442" },
+        comment: { colour: "#3e5a6b", italic: true },
+        bullet: { colour: "#3e5a6b" },
     },
-    added: "#166534",
-    removed: "#991b1b",
-    addedFill: "#d3f5dc",
-    removedFill: "#fcd9d9",
-    muted: "#6b7280",
+    added: "#1e3442",
+    removed: "#732553",
+    addedFill: "#8eebee",
+    removedFill: "#e9d8c8",
+    muted: "#3e5a6b",
 };
 const rgb = (hex) => {
     const value = Number.parseInt(hex.slice(1), 16);
@@ -57,17 +65,24 @@ const fillWith = (hex, text, truecolor) => {
     return `${on}${text.replace(/\x1b\[(?:0|49)?m/g, (reset) => `${reset}${on}`)}\x1b[49m`;
 };
 /**
- * Brand blue, for what is shown to do what its spec says - regen's ◆. Brand blue itself on a light surface, 9.72:1
- * on white; on a dark one, where it is illegible (1.97:1 on brand black - see docs/theming.md), its tint 55% of the way
- * to white, 7.34:1 on brand black.
+ * Neon, for what is shown to do what its spec says - regen's ◆: the design system's colour for what can be followed,
+ * 12.2:1 on abyss. On a light surface, where neon is illegible (1.6:1 on white), blue whale, 12.9:1 on white.
  */
-export const BRAND_BLUE = { light: "#0a1fd4", dark: "#919aec" };
-/** Text in brand blue on a theme - its tint on a dark one - in as many colours as the terminal has. */
-export function brandBlue(theme) {
-    const colour = theme.appearance === "light" ? BRAND_BLUE.light : BRAND_BLUE.dark;
+export const BRAND_NEON = { light: "#1e3442", dark: "#5ce1e6" };
+/**
+ * Pink, the one pink thing in a view - the banner's wordmark: 6.54:1 on abyss. On a light surface, where pink is
+ * too pale (2.9:1 on white), eggplant, 9.9:1 on white.
+ */
+export const BRAND_PINK = { light: "#732553", dark: "#ff5c8d" };
+const brandInk = (colours) => (theme) => {
+    const colour = theme.appearance === "light" ? colours.light : colours.dark;
     const truecolor = (theme.getColorMode?.() ?? "truecolor") === "truecolor";
     return (text) => paintWith({ colour, bold: true }, text, truecolor);
-}
+};
+/** Text in neon on a theme - blue whale on a light one - in as many colours as the terminal has. */
+export const brandNeon = brandInk(BRAND_NEON);
+/** Text in pink on a theme - eggplant on a light one - in as many colours as the terminal has. */
+export const brandPink = brandInk(BRAND_PINK);
 /** How a spec diff is painted on a theme: its palette by whether the theme is dark or light, in as many colours as the terminal has. */
 export function plainPaint(theme) {
     const palette = theme.appearance === "light" ? LIGHT : DARK;

package/dist/regenerate/side-panel.js

@@ -16,7 +16,7 @@ export function createSidePanel(options) {
     const backKeys = () => {
         if (options.dock === undefined)
             return [`esc or ${options.key} back to the chat`];
-        return options.dock.docked() ? ["s full screen", "esc or ⌥⌘← to the chat", `${options.key} close`] : ["s beside the chat", `esc or ${options.key} back to the chat`];
+        return options.dock.docked() ? [`${options.key} or esc to the chat`, "ctrl+c close", "s full screen"] : ["s beside the chat", `esc or ${options.key} back to the chat`];
     };
     const waitingNote = () => 
     // A question asked while it showed waits in the chat, unanswered: the person is told it is there.

package/dist/regenerate/spec-map-view.js

@@ -52,7 +52,7 @@ export function tabBar(pages, shown, width, style, now) {
         const text = `${mark}${tabName(page)}`;
         if (page === shown)
             return style.heading(`[${text}]`);
-        return regenerating ? style.accent(text) : page.stuck ? style.error(text) : style.muted(text);
+        return regenerating ? style.accent(text) : page.stuck ? needs(style)(text) : style.muted(text);
     };
     const tabs = pages.map(label);
     const at = Math.max(0, shown === undefined ? 0 : pages.indexOf(shown));
@@ -69,6 +69,8 @@ export function tabBar(pages, shown, width, style, now) {
     }
     return truncateToWidth(lineOf(from, to), width, "…");
 }
+/** What needs the person - a stuck page, its `!` - in the warning colour: it waits on them, nothing is broken. */
+const needs = (style) => style.warning ?? style.error;
 /** Strike text through. */
 const strike = (text) => `\x1b[9m${text}\x1b[29m`;
 /** How far a group, and what is in it, is indented under its module. */
@@ -121,7 +123,7 @@ function rungGlyph(rung, style, now) {
     if (rung === "conform")
         return green(LADDER.conform);
     if (rung === "needsYou")
-        return style.error(LADDER.needsYou);
+        return needs(style)(LADDER.needsYou);
     if (rung === "takenOut")
         return style.error(LADDER.takenOut);
     if (rung === "toRegenerate")
@@ -486,7 +488,7 @@ export function specMapLines(pages, state, width, style, _jobs = [], now = Date.
         // The first item that needs the person says what for, and how to go about it - opened or closed.
         if (page.stuck && !toldWhy && rungOf(item) === "needsYou") {
             toldWhy = true;
-            for (const line of wrapped(needsLine(page), width, style.error))
+            for (const line of wrapped(needsLine(page), width, needs(style)))
                 add(line, mark);
         }
         if (state.open.has(row.key)) {
@@ -515,7 +517,9 @@ function paintOf(mark, style) {
         return style.success ?? style.added;
     if (mark === "regenerating" || mark === "planning")
         return style.accent;
-    if (mark === "stuck" || mark === "removed")
+    if (mark === "stuck")
+        return needs(style);
+    if (mark === "removed")
         return style.error;
     return style.muted;
 }
@@ -548,7 +552,7 @@ export function specMapHeader(page, width, style, waiting = "") {
     const strip = progressStrip(page, style);
     const count = total > 0 ? `${built} of ${total} ${total === 1 ? "functionality" : "functionalities"} built · ` : "";
     // Short, never cut off: what for, and how, is under the first `!`.
-    const status = page.stuck ? style.error(`${LADDER.needsYou} needs you`) : page.status;
+    const status = page.stuck ? needs(style)(`${LADDER.needsYou} needs you`) : page.status;
     // The module's file heads its column, under this line.
     return truncateToWidth(`${style.heading("regen")}${strip !== "" ? `  ${strip}` : ""}  ${count}${status}${waiting}`, width);
 }

package/dist/release-cli.js

@@ -4,6 +4,7 @@ import { configForSpec, modelSpec, projectModels, readProjectConfig } from "./co
 import { createDeployState } from "./release-tools.js";
 import { runReleaseAgent } from "./release-agent.js";
 import { listDeployed, runningDeployed, stopDeployed } from "./regenerate/release.js";
+import { c } from "./module-report.js";
 const USAGE = `usage: turri release [file.plain] [options]
 
 Releases the module on top of the spec's requires chain, which holds the code of the ones below, and
@@ -20,12 +21,6 @@ harness-model (the agent's model).
   --in-module <module>     the codebase to take, when modules built on this one branch
   --guidance <text>        how this project releases it: the scripts to run, in order
   --model <provider/id>    the agent's model (default: harness-model)`;
-const c = {
-    dim: (s) => `\x1b[2m${s}\x1b[0m`,
-    bold: (s) => `\x1b[1m${s}\x1b[0m`,
-    green: (s) => `\x1b[32m${s}\x1b[0m`,
-    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
-};
 const PROBLEMS = "If you are having problems, use chat mode to deploy: run turri and ask to try it.";
 function parseArgs(argv) {
     const positional = [];
@@ -76,7 +71,7 @@ function followLogs() {
                 closeSync(fd);
                 offsets.set(item.log, size);
                 for (const line of buffer.toString("utf8").split("\n").filter((l) => l !== ""))
-                    console.log(`${c.cyan(`[${item.name}]`)} ${line}`);
+                    console.log(`${c.accent(`[${item.name}]`)} ${line}`);
             }
             if (running.length === 0) {
                 clearInterval(timer);
@@ -119,7 +114,7 @@ async function main() {
     console.log(`\n\n${c.dim(PROBLEMS)}`);
     if (runningDeployed().length === 0)
         process.exit(0);
-    console.log(c.green(c.bold("\nRunning - Ctrl-C stops it.")) + c.dim(" Its output follows.\n"));
+    console.log(c.success(c.bold("\nRunning - Ctrl-C stops it.")) + c.dim(" Its output follows.\n"));
     await followLogs();
     process.exit(0);
 }

package/dist/validate-cli.js

@@ -1,4 +1,5 @@
 import { checkPlainTargets, formatCheckResults } from "./plain/check.js";
+import { c } from "./module-report.js";
 const USAGE = `usage: turri validate <file.plain | directory> [options]
 
 Validates a ***plain specification statically: parses it, resolves its imports and
@@ -8,12 +9,6 @@ required modules, and reports every error without rendering anything.
   --json                 machine-readable output
 
   PLAIN_TEMPLATE_DIRS    colon-separated template directories`;
-const c = {
-    dim: (s) => `\x1b[2m${s}\x1b[0m`,
-    bold: (s) => `\x1b[1m${s}\x1b[0m`,
-    green: (s) => `\x1b[32m${s}\x1b[0m`,
-    red: (s) => `\x1b[31m${s}\x1b[0m`,
-};
 const argv = process.argv.slice(2);
 const templateDirs = [];
 const positional = [];
@@ -43,10 +38,10 @@ if (json) {
 else {
     const output = formatCheckResults(results)
         .split("\n")
-        .map((line) => line.startsWith("PASS") ? c.green(line) : line.startsWith("FAIL") ? c.red(line) : c.dim(line))
+        .map((line) => line.startsWith("PASS") ? c.success(line) : line.startsWith("FAIL") ? c.error(line) : c.dim(line))
         .join("\n");
     console.log(output);
     const failed = results.filter((r) => !r.ok).length;
-    console.log(`\n${failed === 0 ? c.green(c.bold("all specs valid")) : c.red(c.bold(`${failed} of ${results.length} failed`))}`);
+    console.log(`\n${failed === 0 ? c.success(c.bold("all specs valid")) : c.error(c.bold(`${failed} of ${results.length} failed`))}`);
 }
 process.exit(results.every((r) => r.ok) ? 0 : 1);

package/docs/README.md

@@ -1,20 +1,13 @@
 # turri documentation
 
-turri implements regenerative software: the \*\*\*plain specs are the durable definition of
-what a system does, and the code is generated from them, validated against them, and regenerated
-as they change. The [project README](../README.md) says why, and how to install and start; these
-pages go into each part.
+turri implements regenerative software: the \*\*\*plain specs are the durable definition of what a system does, and the code is generated from them, validated against them, and regenerated as they change. The [project README](../README.md) says why, and how to install and start; these pages go into each part.
 
 ## Start here
 
-1. [Installation](installation.md) - get a machine ready: `turri doctor`, and what turri needs of
-   this machine.
-2. [Using turri](using.md) - the conversation, the skills and tools, background jobs and
-   their logs, choosing the model that renders, the command line.
-3. [Authoring \*\*\*plain](authoring-plain.md) - writing the specs: what a spec is made of, the
-   authoring rules, the skills that write and fix specs.
-4. [Rendering](regenerating.md) - turning the specs into code: what each build does, in which order,
-   and what has to pass before it moves on.
+1. [Installation](installation.md) - get a machine ready: `turri doctor`, and what turri needs of this machine.
+2. [Using turri](using.md) - the conversation, the skills and tools, background jobs and their logs, choosing the model that renders, the command line.
+3. [Authoring \*\*\*plain](authoring-plain.md) - writing the specs: what a spec is made of, the authoring rules, the skills that write and fix specs.
+4. [Rendering](regenerating.md) - turning the specs into code: what each build does, in which order, and what has to pass before it moves on.
 
 ## By question