@intentius/behold 0.29.11 → 0.29.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/behold",
-  "version": "0.29.11",
+  "version": "0.29.13",
   "license": "Apache-2.0",
   "type": "module",
   "description": "behold — a live control plane on chant. See your whole estate (every substrate in one graph), coloured by drift; act through delegated, gated Ops.",

package/web/kiosk-roots.test.js

@@ -38,8 +38,8 @@ describe("a colour per root (behold#571)", () => {
 
 describe("root names in a line (behold#571)", () => {
   it("finds whole-word names, possessives and names in brackets, and keeps the line's text", () => {
-    const line = "app reads subnet_id from network, known only after network applies: the review does not show the value app gets.";
-    expect(names(line)).toEqual(["app", "network", "network", "app"]);
+    const line = "app reads subnet_id from network, set when network applies.";
+    expect(names(line)).toEqual(["app", "network", "network"]);
     expect(rootSegments(line, ROOTS).map((s) => s.text).join("")).toBe(line);
     expect(names("approves wave 2 (app) with network's key")).toEqual(["app", "network"]);
     expect(names("app: Plan: 0 to add, 1 to change, 0 to destroy.")).toEqual(["app"]);

package/web/kiosk.js

@@ -223,7 +223,7 @@ export function unreviewedLines(answer) {
   if (!pr) return [];
   return pr.reads
     .filter((r) => r.outputs === "planned" && r.unknown && r.unknown.length)
-    .map((r) => `${r.root} reads ${r.unknown.join(", ")} from ${r.upstream}, known only after ${r.upstream} applies: the review does not show the value ${r.root} gets.`);
+    .map((r) => `${r.root} reads ${r.unknown.join(", ")} from ${r.upstream}, set when ${r.upstream} applies.`);
 }
 
 /**
@@ -457,7 +457,7 @@ export function factLines(demo, answer) {
   if (totals) out.push(`pull request #${pr.run.pull_request} changes ${rootsCount(pr.totals_roots) || "across roots"}: ${totals}`);
   const b = blastRows(answer);
   if (b && b.changed.length) out.push(`blast radius: ${b.changed.join(", ")}${b.downstream.length ? `; downstream, nearest first: ${b.downstream.join(", ")}` : ""}`);
-  if (b && b.unplanned.length) out.push(`not touched: ${b.unplanned.join(", ")}`);
+  if (b && b.unplanned.length) out.push(`unchanged: ${b.unplanned.join(", ")}`);
   const cost = costLine(pr.cost);
   if (cost) out.push(cost);
   return out;

package/web/kiosk.test.js

@@ -49,7 +49,7 @@ describe("frameSrc (#569)", () => {
 
 describe("factLines (#569)", () => {
   it("says the pull request's totals and blast radius", () => {
-    expect(factLines(demo("planned"), answer)).toEqual(["pull request #7 changes across 3 roots: 3 update", "blast radius: app, edge, network", "not touched: other"]);
+    expect(factLines(demo("planned"), answer)).toEqual(["pull request #7 changes across 3 roots: 3 update", "blast radius: app, edge, network", "unchanged: other"]);
   });
 });
 

package/web/terragucci-change.js

@@ -23,7 +23,7 @@
 import { ago, clock, hrefOf } from "./terragucci.js";
 
 export const STATE_WORDS = {
-  "not-started": "not started",
+  "not-started": "queued",
   planned: "planned",
   waiting: "waiting for an approval",
   applying: "applying",
@@ -119,13 +119,13 @@ export function readCardIds(answer, e) {
   return [`${r.member}/${r.name}/data.terraform_remote_state.${data}`, `${r.member}/${r.name}/data.terraform_estate_outputs.${data}`];
 }
 
-/** "5 create · 1 update", no-ops and zeros left out; "no changes" when nothing moves. */
+/** "5 create · 1 update", no-ops and zeros left out; "unchanged" when nothing moves. */
 export function totalsLine(totals) {
   if (!totals) return null;
   const order = ["create", "update", "replace", "delete", "forget", "import", "read"];
   const keys = [...order.filter((k) => k in totals), ...Object.keys(totals).filter((k) => !order.includes(k) && k !== "no-op").sort()];
   const parts = keys.filter((k) => totals[k] > 0).map((k) => `${totals[k]} ${k}`);
-  return parts.length ? parts.join(" · ") : "no changes";
+  return parts.length ? parts.join(" · ") : "unchanged";
 }
 
 /** #568 step 2: "across 3 roots", from `totals_roots` (report minor 35); null on an older report, which has no count. */
@@ -216,7 +216,7 @@ export function composeLine(pr) {
   return null;
 }
 
-const APPLY_WORDS = { applied: "applied", partial: "applied in part", failed: "failed", "not-started": "not started", "no-changes": "no changes" };
+const APPLY_WORDS = { applied: "applied", partial: "applied in part", failed: "failed", "not-started": "queued", "no-changes": "unchanged" };
 const STATE_AS = { written: "state written", unchanged: "state as it was, nothing to write", "not-written": "state not written" };
 
 /** One member of a composed run as planned: "app as module.app: 1 create". */
@@ -333,7 +333,7 @@ export function changeHead(answer, progress, now = new Date()) {
   const stage = changeStage(answer, progress);
   if (stage === "pull-request") {
     const r = answer.pull_request.run;
-    return { text: `pull request #${r.pull_request}, planned ${clock(r.finished, now)}, ${ago(r.finished, now)}; not merged yet, so no run view`, href: hrefOf(answer, r.report), pr: r.pull_request_url || null };
+    return { text: `pull request #${r.pull_request}, planned ${clock(r.finished, now)}, ${ago(r.finished, now)}; the run view follows the merge`, href: hrefOf(answer, r.report), pr: r.pull_request_url || null };
   }
   if (stage === "apply") {
     const r = progress.run;
@@ -494,7 +494,7 @@ export function rootStates(answer, progress) {
         const blast = pr.blast && Array.isArray(pr.blast.roots) ? pr.blast.roots : null;
         const readsUnknown = (pr.reads || []).some((r) => r.root === root && r.unknown && r.unknown.length) || !!(c && c.held_by_unknown && c.held_by_unknown.includes(root));
         if (blast && !blast.includes(root) && !readsUnknown) {
-          roots[root] = { wave: w.number, state: "unchanged", tone: STATE_TONE.unchanged, words: `wave ${w.number} · no changes`, facts: [] };
+          roots[root] = { wave: w.number, state: "unchanged", tone: STATE_TONE.unchanged, words: `wave ${w.number} · unchanged`, facts: [] };
           continue;
         }
         const facts = [];
@@ -505,7 +505,7 @@ export function rootStates(answer, progress) {
         roots[root] = { wave: w.number, state: "planned", tone: STATE_TONE.planned, words: `wave ${w.number} · planned${c ? ", composed" : ""}`, facts };
       }
     }
-    for (const root of known) if (!roots[root]) roots[root] = { wave: null, state: "outside", tone: STATE_TONE.outside, words: "not in this change", facts: [] };
+    for (const root of known) if (!roots[root]) roots[root] = { wave: null, state: "outside", tone: STATE_TONE.outside, words: "unchanged", facts: [] };
     return { stage, roots };
   }
   if (stage === "apply") {
@@ -515,7 +515,7 @@ export function rootStates(answer, progress) {
       const inRun = [...composedOf].filter(([, n]) => n === w.number).map(([r]) => r);
       for (const root of [...new Set([...w.roots, ...(c ? c.roots : []), ...inRun])]) {
         if (!rootChanges(w, root)) {
-          roots[root] = { wave: w.number, state: "unchanged", tone: STATE_TONE.unchanged, words: `wave ${w.number} · no changes`, facts: [] };
+          roots[root] = { wave: w.number, state: "unchanged", tone: STATE_TONE.unchanged, words: `wave ${w.number} · unchanged`, facts: [] };
           continue;
         }
         const m = c && c.members ? c.members.find((x) => x.root === root) : null;
@@ -529,7 +529,7 @@ export function rootStates(answer, progress) {
         if (m && m.apply) facts.push(memberApplyLine(m).replace(`${root}: `, "")); // this root's own part, not the wave's
         else if (c && !composedHere) {
           // Beside a composed run in its wave: the wave's figures are the run's, not this root's.
-        } else if (totals && state !== "not-started") facts.push(totals === "no changes" ? `${together ? "the wave: " : ""}no changes` : `${together ? "the wave " : ""}${state === "applied" ? "applied" : state === "failed" || state === "refused" ? "planned" : "plans"} ${totals}`);
+        } else if (totals && state !== "not-started") facts.push(totals === "unchanged" ? `${together ? "the wave: " : ""}unchanged` : `${together ? "the wave " : ""}${state === "applied" ? "applied" : state === "failed" || state === "refused" ? "planned" : "plans"} ${totals}`);
         if (state === "failed" || state === "refused") {
           const before = progress.states.filter((x) => x.number < w.number && x.state === "applied").map((x) => x.number);
           if (before.length) facts.push(`wave ${list(before)} stays applied`);
@@ -544,12 +544,12 @@ export function rootStates(answer, progress) {
   return { stage, roots };
 }
 
-/** The short label on a read's line: "reads network's planned http_proxy_port, unknown until network applies". */
+/** The short label on a read's line: "reads network's planned http_proxy_port, set when network applies". */
 export function readLabel(e) {
   if (e.composed !== undefined) {
     return `reads ${e.to} in wave ${e.composed}'s composed run${e.unknown.length ? `: ${list(e.unknown)} known once ${e.to}'s part applies` : ""}`;
   }
-  if (e.outputs === "planned") return e.unknown.length ? `reads ${list(e.unknown)} from ${e.to}: unknown until ${e.to} applies` : `reads ${e.to}'s planned outputs`;
+  if (e.outputs === "planned") return e.unknown.length ? `reads ${list(e.unknown)} from ${e.to}, set when ${e.to} applies` : `reads ${e.to}'s planned outputs`;
   return `reads ${e.to}'s applied state`;
 }
 
@@ -607,7 +607,7 @@ export function viewCaption(answer, progress, now = new Date()) {
   const stage = changeStage(answer, progress);
   if (stage === "pull-request") {
     const r = answer.pull_request.run;
-    return `the plan of pull request #${r.pull_request} at ${clock(r.finished, now)}: not merged yet, nothing applied`;
+    return `the plan of pull request #${r.pull_request} at ${clock(r.finished, now)}, before the merge`;
   }
   if (stage === "apply") {
     const r = progress.run;

package/web/terragucci-change.test.js

@@ -23,7 +23,7 @@ describe("rootStates (#569)", () => {
     expect(stage).toBe("pull-request");
     expect(r.network).toMatchObject({ wave: 1, state: "planned", tone: "plan", words: "wave 1 · planned", facts: ["plan f8851fb61921"] });
     expect(r.app.facts).toEqual(["plans again once wave 1 applies", "will wait for an approval"]);
-    expect(r.other).toMatchObject({ state: "outside", words: "not in this change" });
+    expect(r.other).toMatchObject({ state: "outside", words: "unchanged" });
   });
   it("shows a failed wave's roots failed and the waves before it applied", () => {
     const p = run(
@@ -60,7 +60,7 @@ describe("rootStates, a root that plans no change (#569 review)", () => {
     const p = run([{ number: 1, state: "waiting", roots: ["network", "other"], reads: [], digest: "jcs1-sha256:365a4f0d54d7aa", totals: { create: 5 }, changed: ["network"] }], []);
     const { roots: r } = rootStates(prAnswer, p);
     expect(r.network.state).toBe("waiting");
-    expect(r.other).toMatchObject({ state: "unchanged", tone: "idle", words: "wave 1 · no changes", facts: [] });
+    expect(r.other).toMatchObject({ state: "unchanged", tone: "idle", words: "wave 1 · unchanged", facts: [] });
   });
   it("takes a composed member's own no-changes over the wave's state", () => {
     const p = run([{ number: 1, state: "failed", roots: ["network"], reads: [], composed: { roots: ["network", "edge"], members: [{ root: "network", module: "m", apply: "failed" }, { root: "edge", module: "e", apply: "no-changes" }] } }], []);
@@ -76,7 +76,7 @@ describe("rootStates, a root that plans no change (#569 review)", () => {
 
 describe("readLabel (#569)", () => {
   it("says what is read and when it is known", () => {
-    expect(readLabel({ from: "app", to: "network", outputs: "planned", unknown: ["http_proxy_port"] })).toBe("reads http_proxy_port from network: unknown until network applies");
+    expect(readLabel({ from: "app", to: "network", outputs: "planned", unknown: ["http_proxy_port"] })).toBe("reads http_proxy_port from network, set when network applies");
     expect(readLabel({ from: "app", to: "network", outputs: "planned", unknown: [] })).toBe("reads network's planned outputs");
     expect(readLabel({ from: "app", to: "network", outputs: "applied", unknown: [] })).toBe("reads network's applied state");
     expect(readLabel({ from: "app", to: "network", outputs: "planned", unknown: ["subnet_id"], composed: 1 })).toBe("reads network in wave 1's composed run: subnet_id known once network's part applies");
@@ -93,7 +93,7 @@ describe("readCardIds (#569)", () => {
 describe("viewCaption (#569)", () => {
   it("says which run the marks come from", () => {
     const now = new Date("2026-10-15T03:30:00Z");
-    expect(viewCaption(prAnswer, null, now)).toBe("the plan of pull request #201 at 03:11 UTC: not merged yet, nothing applied");
+    expect(viewCaption(prAnswer, null, now)).toBe("the plan of pull request #201 at 03:11 UTC, before the merge");
     expect(viewCaption(prAnswer, run([{ number: 1, state: "applied", roots: ["network"], reads: [] }], []), now)).toBe("the run of merge 6b9f7e25, as of 03:20 UTC");
   });
 });

package/web/terragucci-components-live.js

@@ -30,13 +30,13 @@ export const JOB_TONE = { queued: "idle", running: "busy", waiting: "wait", succ
 /** A card's state in one or two words, when the full words don't fit the card. */
 export const SHORT_WORDS = {
   planned: "planned",
-  "not-started": "not started",
+  "not-started": "queued",
   waiting: "waiting",
   applying: "applying",
   applied: "applied",
   refused: "refused",
   failed: "failed",
-  unchanged: "no changes",
+  unchanged: "unchanged",
   outside: "not in this run",
 };
 

package/web/terragucci-components-live.test.js

@@ -98,7 +98,7 @@ describe("the component marks (#571)", () => {
       network: ["applied", "ok", "applied"],
       other: ["outside", "idle", "not in this run"],
       app: ["waiting", "wait", "waiting for an approval"],
-      edge: ["not-started", "idle", "not started"],
+      edge: ["not-started", "idle", "queued"],
     });
     expect(m.cards.app.short).toBe("waiting");
     expect(m.waves[2]).toMatchObject({ job: "apply-wave-2", state: "waiting", tone: "wait", title: "apply-wave-2 · held at the gate" });
@@ -120,7 +120,7 @@ describe("the component marks (#571)", () => {
     const m = componentMarks(answer, null, facets, { runs: runs(run(11, MERGE, [job("apply-wave-2", "waiting")])), pin: `pull-41-a1b2c3d4` });
     expect(m.stage).toBe("pull-request");
     expect(m.cards.network).toMatchObject({ state: "planned", words: "planned" });
-    expect(m.cards.other).toMatchObject({ state: "outside", words: "not in this change" });
+    expect(m.cards.other).toMatchObject({ state: "outside", words: "unchanged" });
     expect(m.waves[2]).toMatchObject({ state: "planned", status: null, title: "apply-wave-2" });
     expect(m.waves[1].facts).toEqual(["plan aaaaaaaaaaaa"]);
   });

package/web/terragucci-estate.js

@@ -211,7 +211,7 @@ export function renderEstateSvg(answer, now = new Date(), doc = document) {
     const run = runLine(p, now);
     g.appendChild(titled(doc, svgEl(doc, "text", { x: b.x + PAD, y: b.y + 55, class: `tg-project-run tg-${run.tone}` }, run.text), run.title));
     for (const w of b.waves) {
-      g.appendChild(svgEl(doc, "text", { x: w.x, y: w.y + 14, class: `tg-wave-label tg-wave-${w.state}`, "data-wave": w.number }, `wave ${w.number} · ${w.state === "not-started" ? "not started" : w.state}`));
+      g.appendChild(svgEl(doc, "text", { x: w.x, y: w.y + 14, class: `tg-wave-label tg-wave-${w.state}`, "data-wave": w.number }, `wave ${w.number} · ${w.state === "not-started" ? "queued" : w.state}`));
       for (const r of w.roots) {
         const node = svgEl(doc, "g", { class: "tg-root-node", "data-root": r.root });
         node.appendChild(svgEl(doc, "rect", { x: r.x, y: r.y, width: r.w, height: r.h, rx: 4 }));

package/web/terragucci.js

@@ -86,7 +86,7 @@ export function stageCell(verdict, stage, now = new Date()) {
     if (verdict.approval === "waiting") return { text: `wave ${verdict.run.wave} waiting, ${age}`, tone: "wave", title };
     return { text: `wave ${verdict.run.wave} ${verdict.applied ? "applied" : verdict.approval || "ran"}, ${age}`, tone: "ok", title };
   }
-  if (verdict.changes === 0) return { text: `${stage === "tf-drift" ? "none" : "no changes"}, ${age}`, tone: "ok", title };
+  if (verdict.changes === 0) return { text: `${stage === "tf-drift" ? "none" : "unchanged"}, ${age}`, tone: "ok", title };
   const noun = stage === "tf-drift" ? "drifted" : `change${verdict.changes === 1 ? "" : "s"}`;
   const pr = verdict.run.pull_request ? ` (PR #${verdict.run.pull_request})` : "";
   return { text: `${verdict.changes} ${noun}${pr}, ${age}`, tone: stage === "tf-drift" ? "drift" : "plan", title };