clearotron 0.4.0-beta.2 → 0.4.0

package/driver/skills/clearance-search/phase2-execution.md

@@ -80,7 +80,7 @@ skipped step must be logged with its reason in the unit's digest audit.
 3. **Single-word coverage hunts** — for each element marked "demote to filter" in the manifest, one search with product/industry filters applied (limit=50). Minimum 1 per such element.
 4. **Wildcard reorders** — if the manifest lists word-order variants, at least one wildcard sweep per distinct ordering (e.g. `Elevate * game`, `game * Elevate`).
 5. **Numeric-substitution and transliteration sweeps** — execute every sweep marked ✅ (requires verification) in the variant manifest, UNLESS the manifest classifies the mark as English-only (single-language Recipe 1 pattern). Skipping any ✅ requires a stated reason in the unit's digest audit.
-6. **Material-jurisdiction sub-queries** — a **protected, non-yielding** line item, NOT folded into the sweep budget. Run one scoped sub-query per jurisdiction `matter-context` declares materially-matters (no top-N cap; the per-mark ceiling scales with the declared count — see `clearance-register/SKILL.md` → *Tool call budget* and Step 3). These outrank within-axis breadth: if budget is tight, an extra script group (step 5) yields and is logged `coverage-limited` — a material jurisdiction is never dropped to fund breadth, and a jurisdiction that genuinely can't run is logged `deferred`, never silent.
+6. **Material-jurisdiction sub-queries** — a **protected, non-yielding** line item, NOT folded into the sweep budget. Run one scoped sub-query per jurisdiction `matter-context` declares materially-matters (no top-N cap). These outrank within-axis breadth: if budget is tight, an extra script group (step 5) yields and is logged `coverage-limited` — a material jurisdiction is never dropped to fund breadth, and a jurisdiction that genuinely can't run is logged `deferred`, never silent.
 
 **Expected breadth for saturated common-word patterns: ~20–25 register searches per mark, plus the ring-fenced per-jurisdiction allowance** — a guideline, not a quota; coverage of the manifest's axes *and* the declared material jurisdictions is what matters, not the raw count. A run that is thin **and** left ✅ sweeps or material-jurisdiction sub-queries unexecuted with no documented skip reason is incomplete; the skeptic (Step 2.6) flags it. A run that executed every axis and validly found little is complete.
 

package/driver/skills/knockout-assess/SKILL.md

@@ -21,6 +21,8 @@ there is no other value: a band that needs sharpening is the band above it, stat
 2. **Parody / evocation check**: does the name echo a famous mark or property even without identical
    ownership ("Free Range 1s" echoes "Air Force 1s")? Flag it even when nobody owns the echoed form.
 3. **Band per the framework ladder**, applying the calibration rules below.
+   [worked-examples.md](../clearance-search/worked-examples.md) — the spine + per-finding reasoning
+   depth (per-customer variants calibrate under that customer's framework)
 4. **1–5 evidence bullets** shaped by the band — the mark's READING, not its conflicts. One honest
    bullet beats two, and a degraded mark usually has exactly one: a floor of two is an instruction to
    pad, and the null-results doctrine forbids inflating a mark whose research came back thin.

package/driver/stages-knockout.mjs

@@ -150,6 +150,28 @@ export const KNOCKOUT_WEB = Object.freeze({ preset: "pro-search", reasoning: Obj
  */
 export const KNOCKOUT_MINUTES_BAR = 10;
 
+/**
+ * The bar's verdict for one run, from the run's own two timestamps. PURE, and it lives beside the constant
+ * so the comparison and the number it compares against cannot drift apart.
+ *
+ * AN UNREADABLE OR ABSENT START IS NOT "UNDER THE BAR". `runMinutes` and `overBar` are both null then, and
+ * `barNotMeasured` says why — a run whose span could not be read must not record a verdict that reads as a
+ * pass. That is the whole reason this returns three fields rather than a boolean.
+ *
+ * @param {{startedAt?: string|null, deliveredAt?: string|null}} span the run's own ISO timestamps
+ */
+export function knockoutBarVerdict({ startedAt = null, deliveredAt = null } = {}) {
+  const a = startedAt ? Date.parse(startedAt) : NaN;
+  const b = deliveredAt ? Date.parse(deliveredAt) : NaN;
+  if (!Number.isFinite(a) || !Number.isFinite(b) || b < a)
+    return { runMinutes: null, overBar: null,
+      barNotMeasured: !Number.isFinite(a) ? "the run's own startedAt could not be read"
+        : !Number.isFinite(b) ? "the run has no delivery time to measure to"
+        : "the run's delivery time is before its start" };
+  const runMinutes = Number(((b - a) / 60000).toFixed(1));
+  return { runMinutes, overBar: runMinutes > KNOCKOUT_MINUTES_BAR };
+}
+
 /** The territories the request ordered, as the job carries them; empty for a worldwide screen. PURE. */
 export const orderedTerritories = (job) =>
   (Array.isArray(job?.jurisdictions) ? job.jurisdictions.map((s) => String(s).trim()).filter(Boolean) : []);

package/driver/suite-census.json

@@ -93,6 +93,12 @@
           "skips": 0,
           "todos": 0
         },
+        "a-cap-of-zero-is-not-a-register-outcome.test.mjs": {
+          "tests": 3,
+          "asserts": 6,
+          "skips": 0,
+          "todos": 0
+        },
         "a-capability-gap-is-decided-once-per-run.test.mjs": {
           "tests": 4,
           "asserts": 17,
@@ -279,6 +285,12 @@
           "skips": 0,
           "todos": 0
         },
+        "a-coverage-row-carries-the-count-it-was-given.test.mjs": {
+          "tests": 4,
+          "asserts": 11,
+          "skips": 0,
+          "todos": 0
+        },
         "a-credential-file-is-written-one-way.test.mjs": {
           "tests": 4,
           "asserts": 13,
@@ -615,6 +627,12 @@
           "skips": 0,
           "todos": 0
         },
+        "a-job-matched-by-name-elsewhere-keeps-its-name.test.mjs": {
+          "tests": 2,
+          "asserts": 2,
+          "skips": 0,
+          "todos": 0
+        },
         "a-job-on-the-older-goods-spelling-scopes-the-same.test.mjs": {
           "tests": 10,
           "asserts": 23,
@@ -729,6 +747,12 @@
           "skips": 0,
           "todos": 0
         },
+        "a-mark-named-only-in-prose-is-withheld.test.mjs": {
+          "tests": 6,
+          "asserts": 9,
+          "skips": 0,
+          "todos": 0
+        },
         "a-mark-too-short-for-contains-is-asked-exactly.test.mjs": {
           "tests": 12,
           "asserts": 57,
@@ -778,8 +802,8 @@
           "todos": 0
         },
         "a-model-of-the-current-generation-is-named-in-every-spelling.test.mjs": {
-          "tests": 4,
-          "asserts": 13,
+          "tests": 8,
+          "asserts": 29,
           "skips": 0,
           "todos": 0
         },
@@ -922,8 +946,8 @@
           "todos": 0
         },
         "a-program-already-here-is-checked-against-the-floor.test.mjs": {
-          "tests": 9,
-          "asserts": 38,
+          "tests": 12,
+          "asserts": 44,
           "skips": 3,
           "todos": 0
         },
@@ -1065,6 +1089,12 @@
           "skips": 0,
           "todos": 0
         },
+        "a-refused-call-records-which-field-was-missing.test.mjs": {
+          "tests": 3,
+          "asserts": 12,
+          "skips": 0,
+          "todos": 0
+        },
         "a-refused-mcp-call-is-not-a-call-nobody-made.test.mjs": {
           "tests": 7,
           "asserts": 19,
@@ -1186,8 +1216,14 @@
           "todos": 0
         },
         "a-run-records-the-tool-that-served-it.test.mjs": {
-          "tests": 13,
-          "asserts": 33,
+          "tests": 16,
+          "asserts": 42,
+          "skips": 0,
+          "todos": 0
+        },
+        "a-run-records-which-register-served-it.test.mjs": {
+          "tests": 14,
+          "asserts": 30,
           "skips": 0,
           "todos": 0
         },
@@ -1311,6 +1347,12 @@
           "skips": 0,
           "todos": 0
         },
+        "a-slice-the-fold-refused-as-already-asked-is-not-a-dispatch-failure.test.mjs": {
+          "tests": 10,
+          "asserts": 32,
+          "skips": 0,
+          "todos": 0
+        },
         "a-source-the-classifier-could-not-read-is-not-empty.test.mjs": {
           "tests": 9,
           "asserts": 14,
@@ -1708,8 +1750,8 @@
           "todos": 0
         },
         "an-escape-is-read-the-way-a-lexer-reads-it.test.mjs": {
-          "tests": 3,
-          "asserts": 11,
+          "tests": 5,
+          "asserts": 25,
           "skips": 0,
           "todos": 0
         },
@@ -1797,6 +1839,12 @@
           "skips": 0,
           "todos": 0
         },
+        "an-unreadable-sidecar-is-not-an-absent-one.test.mjs": {
+          "tests": 7,
+          "asserts": 13,
+          "skips": 0,
+          "todos": 0
+        },
         "anchor-and-script-aware-quote.test.mjs": {
           "tests": 12,
           "asserts": 40,
@@ -2781,6 +2829,12 @@
           "skips": 1,
           "todos": 0
         },
+        "e2e-a-row-states-what-it-measured.test.mjs": {
+          "tests": 3,
+          "asserts": 7,
+          "skips": 0,
+          "todos": 0
+        },
         "e2e-assertions.test.mjs": {
           "tests": 87,
           "asserts": 251,
@@ -2789,13 +2843,13 @@
         },
         "e2e-mark-provenance.test.mjs": {
           "tests": 29,
-          "asserts": 85,
+          "asserts": 97,
           "skips": 0,
           "todos": 0
         },
         "e2e-pair-workflow.test.mjs": {
           "tests": 14,
-          "asserts": 72,
+          "asserts": 73,
           "skips": 0,
           "todos": 0
         },
@@ -2811,9 +2865,15 @@
           "skips": 0,
           "todos": 0
         },
+        "e2e-scenario-names-its-register.test.mjs": {
+          "tests": 13,
+          "asserts": 28,
+          "skips": 0,
+          "todos": 0
+        },
         "e2e-scenario-ops.test.mjs": {
-          "tests": 25,
-          "asserts": 85,
+          "tests": 28,
+          "asserts": 94,
           "skips": 0,
           "todos": 0
         },
@@ -2914,8 +2974,8 @@
           "todos": 0
         },
         "engine.anthropic.test.mjs": {
-          "tests": 65,
-          "asserts": 248,
+          "tests": 66,
+          "asserts": 250,
           "skips": 1,
           "todos": 0
         },
@@ -3407,7 +3467,7 @@
         },
         "jx-p4-cores.test.mjs": {
           "tests": 14,
-          "asserts": 56,
+          "asserts": 58,
           "skips": 0,
           "todos": 0
         },
@@ -3719,7 +3779,7 @@
         },
         "onboard-wizard.test.mjs": {
           "tests": 77,
-          "asserts": 294,
+          "asserts": 295,
           "skips": 4,
           "todos": 0
         },
@@ -3887,7 +3947,7 @@
         },
         "pipeline.mock.test.mjs": {
           "tests": 103,
-          "asserts": 863,
+          "asserts": 865,
           "skips": 0,
           "todos": 0
         },
@@ -4588,8 +4648,8 @@
           "todos": 0
         },
         "report-assemble.test.mjs": {
-          "tests": 21,
-          "asserts": 109,
+          "tests": 22,
+          "asserts": 115,
           "skips": 0,
           "todos": 0
         },
@@ -5391,6 +5451,12 @@
           "skips": 0,
           "todos": 0
         },
+        "the-bar-is-measured-against-the-run.test.mjs": {
+          "tests": 3,
+          "asserts": 9,
+          "skips": 0,
+          "todos": 0
+        },
         "the-bar-names-no-organisation-nobody-named.test.mjs": {
           "tests": 6,
           "asserts": 13,
@@ -5613,6 +5679,12 @@
           "skips": 0,
           "todos": 0
         },
+        "the-engine-sets-no-sampling-and-forces-no-tool.test.mjs": {
+          "tests": 6,
+          "asserts": 9,
+          "skips": 2,
+          "todos": 0
+        },
         "the-engine-step-cannot-loop-on-a-menu-nothing-changed.test.mjs": {
           "tests": 17,
           "asserts": 45,
@@ -5763,6 +5835,12 @@
           "skips": 0,
           "todos": 0
         },
+        "the-investigate-line-names-its-claim-by-location.test.mjs": {
+          "tests": 20,
+          "asserts": 57,
+          "skips": 0,
+          "todos": 0
+        },
         "the-knockout-page-leads-with-the-read.test.mjs": {
           "tests": 39,
           "asserts": 125,
@@ -5877,6 +5955,12 @@
           "skips": 0,
           "todos": 0
         },
+        "the-payload-is-redacted-as-a-structure.test.mjs": {
+          "tests": 15,
+          "asserts": 30,
+          "skips": 0,
+          "todos": 0
+        },
         "the-people-page-can-change-and-remove-a-person.test.mjs": {
           "tests": 17,
           "asserts": 85,
@@ -5985,9 +6069,27 @@
           "skips": 0,
           "todos": 0
         },
-        "the-reference-strip-left-sentences-unfinished.test.mjs": {
+        "the-redaction-folds-character-width.test.mjs": {
           "tests": 6,
-          "asserts": 15,
+          "asserts": 11,
+          "skips": 0,
+          "todos": 0
+        },
+        "the-redaction-leaves-the-scaffolding-alone.test.mjs": {
+          "tests": 4,
+          "asserts": 7,
+          "skips": 0,
+          "todos": 0
+        },
+        "the-redaction-never-shrinks-its-own-coverage.test.mjs": {
+          "tests": 5,
+          "asserts": 10,
+          "skips": 0,
+          "todos": 0
+        },
+        "the-reference-strip-left-sentences-unfinished.test.mjs": {
+          "tests": 7,
+          "asserts": 25,
           "skips": 4,
           "todos": 0
         },
@@ -6063,9 +6165,9 @@
           "skips": 0,
           "todos": 0
         },
-        "the-reviewers-open-points-reach-the-reviewing-lawyer-never-a-client.test.mjs": {
+        "the-reviewers-open-points-stay-in-the-run-record.test.mjs": {
           "tests": 6,
-          "asserts": 15,
+          "asserts": 17,
           "skips": 0,
           "todos": 0
         },
@@ -6124,8 +6226,8 @@
           "todos": 0
         },
         "the-scorer-withholds-names-unless-asked.test.mjs": {
-          "tests": 21,
-          "asserts": 46,
+          "tests": 32,
+          "asserts": 63,
           "skips": 0,
           "todos": 0
         },
@@ -6207,6 +6309,12 @@
           "skips": 2,
           "todos": 0
         },
+        "the-totals-block-counts-a-step-that-said-nothing.test.mjs": {
+          "tests": 4,
+          "asserts": 8,
+          "skips": 0,
+          "todos": 0
+        },
         "the-trigger-key-has-a-deadline-somebody-is-counting.test.mjs": {
           "tests": 5,
           "asserts": 23,
@@ -7639,7 +7747,7 @@
         },
         "providers/signa/test/an-owner-portfolio-sweep-is-a-search.test.mjs": {
           "tests": 4,
-          "asserts": 17,
+          "asserts": 18,
           "skips": 0,
           "todos": 0
         },
@@ -7649,6 +7757,24 @@
           "skips": 0,
           "todos": 0
         },
+        "providers/signa/test/the-office-date-comes-first-and-signas-own-is-the-fallback.test.mjs": {
+          "tests": 9,
+          "asserts": 20,
+          "skips": 0,
+          "todos": 0
+        },
+        "providers/signa/test/the-ranked-lane-asks-for-similarity-channels.test.mjs": {
+          "tests": 9,
+          "asserts": 15,
+          "skips": 0,
+          "todos": 0
+        },
+        "providers/signa/test/the-registers-own-warnings-reach-the-run.test.mjs": {
+          "tests": 7,
+          "asserts": 11,
+          "skips": 0,
+          "todos": 0
+        },
         "providers/signa/test/the-screen-speaks-the-shared-verdicts.test.mjs": {
           "tests": 2,
           "asserts": 4,