clearotron 0.3.2-beta.7 → 0.3.2-beta.8

package/driver/suite-census.json

@@ -22,8 +22,8 @@
       "ext": "mjs",
       "perFile": {
         "a-backgrounded-install-can-actually-run-a-clearance.test.mjs": {
-          "tests": 9,
-          "asserts": 35,
+          "tests": 10,
+          "asserts": 46,
           "skips": 0,
           "todos": 0
         },
@@ -70,8 +70,8 @@
           "todos": 0
         },
         "a-budget-is-recorded-beside-the-band-it-ran-against.test.mjs": {
-          "tests": 9,
-          "asserts": 30,
+          "tests": 12,
+          "asserts": 42,
           "skips": 0,
           "todos": 0
         },
@@ -101,7 +101,7 @@
         },
         "a-capture-that-stopped-describing-the-box-says-so.test.mjs": {
           "tests": 16,
-          "asserts": 32,
+          "asserts": 34,
           "skips": 0,
           "todos": 0
         },
@@ -142,8 +142,20 @@
           "todos": 0
         },
         "a-client-condition-never-carries-an-engine-token.test.mjs": {
-          "tests": 6,
-          "asserts": 10,
+          "tests": 9,
+          "asserts": 24,
+          "skips": 0,
+          "todos": 0
+        },
+        "a-cloud-account-bills-as-itself.test.mjs": {
+          "tests": 18,
+          "asserts": 121,
+          "skips": 0,
+          "todos": 0
+        },
+        "a-cloud-billed-install-carries-its-cloud-to-the-services.test.mjs": {
+          "tests": 17,
+          "asserts": 111,
           "skips": 0,
           "todos": 0
         },
@@ -461,7 +473,7 @@
         },
         "a-mid-run-mint-cannot-lose-a-mark.test.mjs": {
           "tests": 10,
-          "asserts": 18,
+          "asserts": 20,
           "skips": 0,
           "todos": 0
         },
@@ -599,7 +611,7 @@
         },
         "a-real-dispatch-records-the-tool-that-served-it.test.mjs": {
           "tests": 1,
-          "asserts": 5,
+          "asserts": 6,
           "skips": 0,
           "todos": 0
         },
@@ -743,7 +755,7 @@
         },
         "a-run-records-the-tool-that-served-it.test.mjs": {
           "tests": 13,
-          "asserts": 32,
+          "asserts": 33,
           "skips": 0,
           "todos": 0
         },
@@ -891,6 +903,12 @@
           "skips": 0,
           "todos": 0
         },
+        "a-turn-the-program-answers-itself-names-no-model.test.mjs": {
+          "tests": 5,
+          "asserts": 16,
+          "skips": 0,
+          "todos": 0
+        },
         "a-two-form-matter-owes-a-read-per-form.test.mjs": {
           "tests": 8,
           "asserts": 25,
@@ -964,8 +982,8 @@
           "todos": 0
         },
         "ab-tooling-honesty.test.mjs": {
-          "tests": 15,
-          "asserts": 71,
+          "tests": 16,
+          "asserts": 78,
           "skips": 0,
           "todos": 0
         },
@@ -1041,6 +1059,12 @@
           "skips": 0,
           "todos": 0
         },
+        "an-engine-program-installed-with-clearotron-is-the-last-resort.test.mjs": {
+          "tests": 13,
+          "asserts": 47,
+          "skips": 0,
+          "todos": 0
+        },
         "an-environment-read-through-optional-chaining-is-a-read.test.mjs": {
           "tests": 6,
           "asserts": 19,
@@ -1150,8 +1174,8 @@
           "todos": 0
         },
         "audit-workbook-commonlaw-unlogged.test.mjs": {
-          "tests": 8,
-          "asserts": 29,
+          "tests": 9,
+          "asserts": 37,
           "skips": 0,
           "todos": 0
         },
@@ -1929,6 +1953,12 @@
           "skips": 0,
           "todos": 0
         },
+        "doctor-and-start-look-where-the-services-look.test.mjs": {
+          "tests": 12,
+          "asserts": 28,
+          "skips": 0,
+          "todos": 0
+        },
         "doctor-names-who-is-in-the-store.test.mjs": {
           "tests": 5,
           "asserts": 15,
@@ -1937,7 +1967,7 @@
         },
         "doctor-reads-the-units-not-the-shell.test.mjs": {
           "tests": 40,
-          "asserts": 115,
+          "asserts": 116,
           "skips": 1,
           "todos": 0
         },
@@ -2146,8 +2176,8 @@
           "todos": 0
         },
         "engine-probe.test.mjs": {
-          "tests": 22,
-          "asserts": 101,
+          "tests": 30,
+          "asserts": 143,
           "skips": 0,
           "todos": 0
         },
@@ -2159,7 +2189,7 @@
         },
         "engine.anthropic.test.mjs": {
           "tests": 65,
-          "asserts": 238,
+          "asserts": 239,
           "skips": 0,
           "todos": 0
         },
@@ -2488,8 +2518,8 @@
           "todos": 0
         },
         "freeze-example-run.test.mjs": {
-          "tests": 8,
-          "asserts": 36,
+          "tests": 10,
+          "asserts": 47,
           "skips": 0,
           "todos": 0
         },
@@ -2782,8 +2812,8 @@
           "todos": 0
         },
         "matter-frame-record.test.mjs": {
-          "tests": 20,
-          "asserts": 71,
+          "tests": 24,
+          "asserts": 81,
           "skips": 0,
           "todos": 0
         },
@@ -2836,8 +2866,8 @@
           "todos": 0
         },
         "named-band.test.mjs": {
-          "tests": 19,
-          "asserts": 67,
+          "tests": 22,
+          "asserts": 78,
           "skips": 0,
           "todos": 0
         },
@@ -2914,8 +2944,8 @@
           "todos": 0
         },
         "onboard-wizard.test.mjs": {
-          "tests": 62,
-          "asserts": 222,
+          "tests": 77,
+          "asserts": 293,
           "skips": 2,
           "todos": 0
         },
@@ -3070,8 +3100,8 @@
           "todos": 0
         },
         "pipeline.mock.registergap.test.mjs": {
-          "tests": 5,
-          "asserts": 29,
+          "tests": 6,
+          "asserts": 34,
           "skips": 0,
           "todos": 0
         },
@@ -3124,8 +3154,8 @@
           "todos": 0
         },
         "plan-qid-is-an-identity.test.mjs": {
-          "tests": 10,
-          "asserts": 30,
+          "tests": 17,
+          "asserts": 56,
           "skips": 0,
           "todos": 0
         },
@@ -3166,8 +3196,8 @@
           "todos": 0
         },
         "portal-config-view.test.mjs": {
-          "tests": 35,
-          "asserts": 95,
+          "tests": 37,
+          "asserts": 106,
           "skips": 0,
           "todos": 0
         },
@@ -3220,8 +3250,8 @@
           "todos": 0
         },
         "portal-service.test.mjs": {
-          "tests": 127,
-          "asserts": 683,
+          "tests": 130,
+          "asserts": 695,
           "skips": 1,
           "todos": 0
         },
@@ -3634,8 +3664,8 @@
           "todos": 0
         },
         "register-digest-record.test.mjs": {
-          "tests": 32,
-          "asserts": 114,
+          "tests": 40,
+          "asserts": 152,
           "skips": 0,
           "todos": 0
         },
@@ -3669,6 +3699,12 @@
           "skips": 0,
           "todos": 0
         },
+        "register-reach-refusal.test.mjs": {
+          "tests": 13,
+          "asserts": 26,
+          "skips": 0,
+          "todos": 0
+        },
         "register-record-log-run-scoped.test.mjs": {
           "tests": 9,
           "asserts": 21,
@@ -3742,8 +3778,8 @@
           "todos": 0
         },
         "render.test.mjs": {
-          "tests": 144,
-          "asserts": 572,
+          "tests": 152,
+          "asserts": 611,
           "skips": 0,
           "todos": 0
         },
@@ -3916,8 +3952,8 @@
           "todos": 0
         },
         "run-economics.test.mjs": {
-          "tests": 21,
-          "asserts": 129,
+          "tests": 25,
+          "asserts": 158,
           "skips": 0,
           "todos": 0
         },
@@ -4233,6 +4269,18 @@
           "skips": 0,
           "todos": 0
         },
+        "setup-asks-how-claude-is-paid.test.mjs": {
+          "tests": 14,
+          "asserts": 96,
+          "skips": 0,
+          "todos": 0
+        },
+        "setup-asks-which-ai-runs-your-searches.test.mjs": {
+          "tests": 12,
+          "asserts": 58,
+          "skips": 0,
+          "todos": 0
+        },
         "shipped-brand-is-the-product.test.mjs": {
           "tests": 7,
           "asserts": 24,
@@ -4396,8 +4444,8 @@
           "todos": 0
         },
         "suite-cannot-reach-a-real-engine.test.mjs": {
-          "tests": 10,
-          "asserts": 26,
+          "tests": 11,
+          "asserts": 31,
           "skips": 0,
           "todos": 0
         },
@@ -4504,8 +4552,8 @@
           "todos": 0
         },
         "test-full-runs-every-corpus-or-names-the-one-it-did-not.test.mjs": {
-          "tests": 16,
-          "asserts": 51,
+          "tests": 17,
+          "asserts": 54,
           "skips": 0,
           "todos": 0
         },
@@ -4528,14 +4576,14 @@
           "todos": 0
         },
         "the-advice-fits-the-machine-it-is-printed-on.test.mjs": {
-          "tests": 14,
-          "asserts": 43,
+          "tests": 17,
+          "asserts": 67,
           "skips": 0,
           "todos": 0
         },
         "the-allowance-line-is-the-servers-words.test.mjs": {
           "tests": 2,
-          "asserts": 4,
+          "asserts": 5,
           "skips": 0,
           "todos": 0
         },
@@ -4827,6 +4875,12 @@
           "skips": 0,
           "todos": 0
         },
+        "the-install-pages-describe-the-install-this-build-performs.test.mjs": {
+          "tests": 11,
+          "asserts": 89,
+          "skips": 0,
+          "todos": 0
+        },
         "the-install-places-what-a-server-needs.test.mjs": {
           "tests": 22,
           "asserts": 51,
@@ -4840,14 +4894,14 @@
           "todos": 0
         },
         "the-inventory-names-the-units-this-box-runs.test.mjs": {
-          "tests": 21,
-          "asserts": 56,
+          "tests": 22,
+          "asserts": 63,
           "skips": 0,
           "todos": 0
         },
         "the-knockout-page-leads-with-the-read.test.mjs": {
-          "tests": 30,
-          "asserts": 81,
+          "tests": 38,
+          "asserts": 117,
           "skips": 0,
           "todos": 0
         },
@@ -5061,12 +5115,24 @@
           "skips": 0,
           "todos": 0
         },
+        "the-report-names-the-models-that-served-it.test.mjs": {
+          "tests": 37,
+          "asserts": 111,
+          "skips": 0,
+          "todos": 0
+        },
         "the-report-shell-keeps-what-a-repair-does-not-resend.test.mjs": {
           "tests": 6,
           "asserts": 28,
           "skips": 0,
           "todos": 0
         },
+        "the-retired-azure-settings-are-read-by-nothing.test.mjs": {
+          "tests": 3,
+          "asserts": 14,
+          "skips": 0,
+          "todos": 0
+        },
         "the-reviewing-pass-reads-the-lines-a-client-sees-first.test.mjs": {
           "tests": 10,
           "asserts": 27,
@@ -5398,8 +5464,8 @@
           "todos": 0
         },
         "update-refuses-on-a-packaged-install.test.mjs": {
-          "tests": 8,
-          "asserts": 26,
+          "tests": 10,
+          "asserts": 32,
           "skips": 0,
           "todos": 0
         },
@@ -5506,8 +5572,8 @@
           "todos": 0
         },
         "what-doctor-passes-a-search-accepts.test.mjs": {
-          "tests": 12,
-          "asserts": 39,
+          "tests": 15,
+          "asserts": 49,
           "skips": 0,
           "todos": 0
         },
@@ -5607,8 +5673,8 @@
           "todos": 0
         },
         "a-run-list-names-its-client.test.mjs": {
-          "tests": 4,
-          "asserts": 29,
+          "tests": 5,
+          "asserts": 35,
           "skips": 0,
           "todos": 0
         },
@@ -5911,6 +5977,12 @@
           "skips": 0,
           "todos": 0
         },
+        "allowanceParity.test.ts": {
+          "tests": 2,
+          "asserts": 6,
+          "skips": 0,
+          "todos": 0
+        },
         "api.test.ts": {
           "tests": 46,
           "asserts": 187,
@@ -5966,8 +6038,8 @@
           "todos": 0
         },
         "composerProduct.test.ts": {
-          "tests": 32,
-          "asserts": 124,
+          "tests": 37,
+          "asserts": 147,
           "skips": 0,
           "todos": 0
         },
@@ -6008,8 +6080,8 @@
           "todos": 0
         },
         "engineState.test.ts": {
-          "tests": 7,
-          "asserts": 27,
+          "tests": 12,
+          "asserts": 50,
           "skips": 0,
           "todos": 0
         },
@@ -6037,6 +6109,12 @@
           "skips": 0,
           "todos": 0
         },
+        "geographyStampParity.test.ts": {
+          "tests": 1,
+          "asserts": 3,
+          "skips": 0,
+          "todos": 0
+        },
         "grouping.test.ts": {
           "tests": 27,
           "asserts": 70,
@@ -6111,7 +6189,7 @@
         },
         "nav.test.ts": {
           "tests": 15,
-          "asserts": 91,
+          "asserts": 94,
           "skips": 0,
           "todos": 0
         },
@@ -6213,7 +6291,7 @@
         },
         "registerCoverage.test.ts": {
           "tests": 12,
-          "asserts": 36,
+          "asserts": 40,
           "skips": 0,
           "todos": 0
         },
@@ -6237,7 +6315,7 @@
         },
         "screenCopy.test.ts": {
           "tests": 63,
-          "asserts": 240,
+          "asserts": 243,
           "skips": 0,
           "todos": 0
         },

package/driver/systemd/README.md

@@ -153,10 +153,13 @@ checkout by a debugging session cannot quietly reconfigure the queue drain.
 
 **If the service fails to start**, `systemctl --user status prelim-driver.service` names the reason.
 The two that have actually happened: `CLEAROTRON_CHECKOUT_DIR` unset — so `ExecStart` resolves to
-`/driver/runner.mjs`, which does not exist — and `claude` not on the unit's `PATH`, which is not a
-start failure at all but shows later as every stage burning its retry ladder for zero tokens. For the
-second, set `CLEAROTRON_CLAUDE_PATH` in `~/.env` to the binary's absolute path; the unit's `PATH`
-already covers `~/.local/bin` and `~/.npm-global/bin`, the two layouts the documents permit.
+`/driver/runner.mjs`, which does not exist — and no `claude` the unit can find, which is not a start
+failure at all but shows later as every stage burning its retry ladder for zero tokens. `clearotron
+install` offers to install the chosen engine's program into `~/.local/share/clearotron/engines`, and the
+unit uses that copy when its `PATH` has none, so the second happens only when that offer was declined.
+Accept it by running `clearotron install` again, or set `CLEAROTRON_CLAUDE_PATH`
+in `~/.env` to the binary's absolute path; the unit's `PATH` already covers `~/.local/bin` and
+`~/.npm-global/bin`, the two layouts the documents permit.
 
 ### `profile-service.service` needs its checkout path edited by hand
 

package/driver/terminal-clamp.mjs

@@ -87,6 +87,36 @@ export function recordNamesDefect(record) {
   return typeof record?.defect === "string" && record.defect.trim().length > 0 && record?.delivered === true;
 }
 
+
+/**
+ * The conditions `clientConditions` could NOT render, so the surface does not carry them. PURE.
+ *
+ * A REFUSAL NOBODY RECORDS IS THE DEFECT ONE LAYER ALONG. The fallback drops a token-bearing reason it
+ * cannot compose a sentence for, which is the right answer for the client and a silent loss for
+ * everyone else: the condition was in the run record, it applies, and the delivered page no longer says
+ * so. Before this, the operator's signal was the voice lint flagging the token on the page. Take the
+ * token off the page and that flag goes quiet — the gap would be closed and the disclosure would go
+ * with it, with nothing in between to say which. So the drop reports itself here, the lint reads it,
+ * and the run record keeps the reason either way.
+ *
+ * @param {{reasons?: string[], clauses?: string[]}} sidecar  the parsed `_driver/verdict.json`
+ * @returns {string[]} the run-record reasons that reach no client surface
+ */
+// IT DECIDES THE SAME THREE THINGS `clientConditions` DECIDES, and they have to keep agreeing: what
+// counts as a stored clause, what counts as an empty reason, and which reasons the authority can
+// render. The third cannot drift — both call `clauseFromReason` — and the first two are the two lines
+// below. A change to either belongs in both, and arm 9 drives them together against one sidecar.
+export function unrenderableConditions({ reasons, clauses } = {}) {
+  const rs = Array.isArray(reasons) ? reasons : [];
+  const cs = Array.isArray(clauses) ? clauses : [];
+  return rs.filter((r, i) => {
+    if (typeof cs[i] === "string" && cs[i].trim()) return false;
+    const text = String(r ?? "").trim();
+    if (!text) return false;
+    return !clauseFromReason(text) && ENGINE_TOKEN_RE.test(text);
+  }).map((r) => String(r).trim());
+}
+
 /**
  * THE LEDE IS THE OPINION'S, BY DECISION AND NOT BY PUSH ORDER. The terminal guards run
  * earlier in the delivery block than the coverage floor, so their clauses landed at index 0 and the
@@ -107,6 +137,70 @@ export function orderClausesForLede(clauses, reasons, guardSet) {
   return { clauses: ordered.map((x) => x.c), reasons: ordered.map((x) => x.r) };
 }
 
+/**
+ * THE CLAUSE AUTHORITY — one composer for the reader's sentence, called both where the numbers are
+ * known and where only the run-record reason survives. PURE.
+ *
+ * A run recorded before clauses were persisted carries `reasons` and no `clauses`, so every condition
+ * fell back to the run-record sentence and a republished archived report opened its Conditions list
+ * with `floor_duty_undischarged:4 of 430 floor row(s)…` — on the page and in the exported PDF. Dropping
+ * the condition instead loses a point the reader must weigh, and re-generating every archived run is
+ * not on offer. The third way is this: for both defects that can reach that list the reader's sentence
+ * is fully determined by the two numbers the reason already carries in its own prefix. An archived run
+ * therefore holds everything needed to compose the client's sentence; what it lacks is only the store.
+ *
+ * ONE DEFINITION, TWO ENTRY POINTS. The clamp site calls `clauseForDefect` with the counts it already
+ * holds; the republish path calls `clauseFromReason`, which reads the same two numbers off the reason's
+ * prefix and hands them to the same composer. A second spelling of either sentence would drift, and the
+ * drift would be invisible: both surfaces render, and only a reader comparing a fresh run against a
+ * republished one would ever see it.
+ *
+ * AN UNRECOGNISED SHAPE IS REFUSED, AND REFUSED HERE MEANS `null` — NEVER A THROW. This runs on the
+ * republish path. A throw there is the failure at the top of this file: a live run died at delivery
+ * after 5.55 hours and the client received nothing instead of a report naming one gap. The caller
+ * decides what the absence means.
+ */
+const CLAUSE_AUTHORITY = Object.freeze({
+  synthesis_unaccounted_delivered: (n, m) =>
+    `${n} of the ${m} register records this search surfaced are neither addressed as findings nor expressly set aside in this report — they remain open points a reader must weigh`,
+  floor_duty_undischarged: (n, m) =>
+    `${n} of the ${m} live registrations identical or near-identical to the mark are not individually addressed in this report — each remains an open point a reader must weigh`,
+});
+
+/**
+ * The reader's sentence for a defect, from its counts. PURE.
+ *
+ * @param {string} defect  the machine token, with or without its `:N` tail
+ * @param {number} n       the count the defect names
+ * @param {number} m       the population it is out of
+ * @returns {string|null}  the client's sentence, or null for a shape this module cannot render
+ */
+export function clauseForDefect(defect, n, m) {
+  const compose = CLAUSE_AUTHORITY[String(defect ?? "").split(":")[0].trim()];
+  if (!compose) return null;
+  const a = Number(n), b = Number(m);
+  if (!Number.isFinite(a) || !Number.isFinite(b)) return null;
+  return compose(a, b);
+}
+
+// The run-record reason's own opening: `<token>:<n> of <m> <noun>`. The NOUN is deliberately not part
+// of the match — `record(s)` and `floor row(s)` are the two spellings today, and a third would make
+// this stop recognising a shape it can render perfectly well. The token is what selects the sentence.
+const REASON_PREFIX_RE = /^([a-z][a-z0-9_]*):(\d[\d,]*)\s+of\s+(\d[\d,]*)\s/i;
+
+/**
+ * The reader's sentence for a condition that has only its run-record reason. PURE.
+ *
+ * @param {string} reason  the run-record sentence
+ * @returns {string|null}  the client's sentence, or null when the reason is not one this can render
+ */
+export function clauseFromReason(reason) {
+  const m = String(reason ?? "").match(REASON_PREFIX_RE);
+  if (!m) return null;
+  const num = (t) => Number(String(t).replace(/,/g, ""));
+  return clauseForDefect(m[1], num(m[2]), num(m[3]));
+}
+
 /**
  * THE CLIENT'S CONDITION LIST, from a verdict sidecar. PURE.
  *
@@ -135,6 +229,15 @@ export function orderClausesForLede(clauses, reasons, guardSet) {
  *   · a clean reason with no clause survives       → break: return "" for a missing clause, arm 2 red
  *   · a legacy sidecar still yields its conditions  → break: require the clauses key, arm 3 red
  *   · clauses shorter than reasons loses nothing    → break: map over clauses, arm 4 red
+ *   · a pre-split reason renders as the lawyer's    → break: return the reason, arm 5 red
+ *   · an unrenderable token-bearing reason is gone  → break: return it, arm 6 red
+ *
+ * THE FALLBACK NO LONGER PRINTS THE RUN RECORD. Where no clause was stored, the clause authority above
+ * composes one from the reason's own counts; where it cannot, the condition is DROPPED rather than
+ * rendered in engine voice. Dropping is a loss and it is the smaller one: a client who reads
+ * `floor_duty_undischarged:4` has been handed the engine's private vocabulary as their own advice. A
+ * reason carrying no engine identifier is a factual open-state already — the three machinery sites push
+ * the reason AS the clause — and it still survives untouched, which is arm 2.
  *
  * @param {{reasons?: string[], clauses?: string[]}} sidecar  the parsed `_driver/verdict.json`
  * @returns {string[]} one condition per reason, in the sidecar's own order
@@ -144,6 +247,9 @@ export function clientConditions({ reasons, clauses } = {}) {
   const cs = Array.isArray(clauses) ? clauses : [];
   return rs.map((r, i) => {
     const clause = typeof cs[i] === "string" ? cs[i].trim() : "";
-    return clause || String(r ?? "").trim();
+    if (clause) return clause;
+    const text = String(r ?? "").trim();
+    if (!text) return "";
+    return clauseFromReason(text) ?? (ENGINE_TOKEN_RE.test(text) ? "" : text);
   }).filter(Boolean);
 }