clearotron 0.3.0-beta.2 → 0.3.0-beta.4

package/driver/suite-census.json

@@ -148,8 +148,8 @@
           "todos": 0
         },
         "a-company-created-in-the-browser-is-a-whole-company.test.mjs": {
-          "tests": 7,
-          "asserts": 36,
+          "tests": 11,
+          "asserts": 61,
           "skips": 0,
           "todos": 0
         },
@@ -370,8 +370,8 @@
           "todos": 0
         },
         "a-knockout-filing-links-to-its-office.test.mjs": {
-          "tests": 12,
-          "asserts": 56,
+          "tests": 15,
+          "asserts": 76,
           "skips": 0,
           "todos": 0
         },
@@ -1366,8 +1366,8 @@
           "todos": 0
         },
         "connect-clients-are-data.test.mjs": {
-          "tests": 12,
-          "asserts": 46,
+          "tests": 15,
+          "asserts": 75,
           "skips": 0,
           "todos": 0
         },
@@ -1397,7 +1397,7 @@
         },
         "connector-annotations-and-pack.test.mjs": {
           "tests": 7,
-          "asserts": 11,
+          "asserts": 12,
           "skips": 0,
           "todos": 0
         },
@@ -1804,8 +1804,8 @@
           "todos": 0
         },
         "doctor-reads-the-units-not-the-shell.test.mjs": {
-          "tests": 24,
-          "asserts": 67,
+          "tests": 30,
+          "asserts": 85,
           "skips": 0,
           "todos": 0
         },
@@ -2026,8 +2026,8 @@
           "todos": 0
         },
         "engine.anthropic.test.mjs": {
-          "tests": 60,
-          "asserts": 215,
+          "tests": 61,
+          "asserts": 222,
           "skips": 0,
           "todos": 0
         },
@@ -2188,8 +2188,8 @@
           "todos": 0
         },
         "exit1-artifact-rescue.test.mjs": {
-          "tests": 20,
-          "asserts": 79,
+          "tests": 25,
+          "asserts": 101,
           "skips": 0,
           "todos": 0
         },
@@ -3058,8 +3058,8 @@
           "todos": 0
         },
         "portal-service.test.mjs": {
-          "tests": 122,
-          "asserts": 656,
+          "tests": 123,
+          "asserts": 662,
           "skips": 0,
           "todos": 0
         },
@@ -3322,8 +3322,8 @@
           "todos": 0
         },
         "recipe-service.test.mjs": {
-          "tests": 12,
-          "asserts": 67,
+          "tests": 16,
+          "asserts": 77,
           "skips": 0,
           "todos": 0
         },
@@ -3478,8 +3478,8 @@
           "todos": 0
         },
         "register-findings-link-to-the-office-record.test.mjs": {
-          "tests": 16,
-          "asserts": 44,
+          "tests": 19,
+          "asserts": 61,
           "skips": 0,
           "todos": 0
         },
@@ -3665,7 +3665,7 @@
         },
         "report-record-link-host.test.mjs": {
           "tests": 3,
-          "asserts": 26,
+          "asserts": 27,
           "skips": 0,
           "todos": 0
         },
@@ -4479,6 +4479,12 @@
           "skips": 0,
           "todos": 0
         },
+        "the-doors-comparison-knows-an-admit-case.test.mjs": {
+          "tests": 7,
+          "asserts": 20,
+          "skips": 0,
+          "todos": 0
+        },
         "the-doubt-carries-its-placement-tier.test.mjs": {
           "tests": 17,
           "asserts": 56,
@@ -4858,8 +4864,8 @@
           "todos": 0
         },
         "the-settings-surface-reads-the-customer-store.test.mjs": {
-          "tests": 9,
-          "asserts": 37,
+          "tests": 10,
+          "asserts": 43,
           "skips": 0,
           "todos": 0
         },
@@ -5397,8 +5403,8 @@
           "todos": 0
         },
         "describe-options.test.mjs": {
-          "tests": 22,
-          "asserts": 94,
+          "tests": 23,
+          "asserts": 98,
           "skips": 0,
           "todos": 0
         },
@@ -5757,7 +5763,7 @@
         },
         "nav.test.ts": {
           "tests": 12,
-          "asserts": 55,
+          "asserts": 57,
           "skips": 0,
           "todos": 0
         },
@@ -5768,8 +5774,8 @@
           "todos": 0
         },
         "newCompanyReachableFromProfile.test.ts": {
-          "tests": 3,
-          "asserts": 7,
+          "tests": 5,
+          "asserts": 13,
           "skips": 0,
           "todos": 0
         },
@@ -5907,7 +5913,7 @@
         },
         "useYourAI.test.ts": {
           "tests": 13,
-          "asserts": 46,
+          "asserts": 41,
           "skips": 0,
           "todos": 0
         },

package/mcp-server/CHANGELOG.md

@@ -1,5 +1,13 @@
 # trademark-artifacts-mcp
 
+## 0.3.0-beta.4
+
+No changes in this release.
+
+## 0.3.0-beta.3
+
+No changes in this release.
+
 ## 0.3.0-beta.2
 
 ### Patch Changes

package/mcp-server/lib/driver.mjs

@@ -26,6 +26,8 @@ export { koPaths } from "../../driver/stages-knockout.mjs";
 // this same function rather than from a second reading of the numbers. office-record-links.mjs imports
 // nothing, so the read-only server stays light.
 export { addressListedFilings } from "../../driver/publish/office-record-links.mjs";
+// Which registers publish no page per record, as publish decides it: the sidecar's register, looked up.
+export { declaredRecordOrigins } from "../../driver/record-origins.mjs";
 
 // stripInternal/stripEngineInternals/stripTelemetry are the driver's OWN client-safety transforms — the
 // same ones publish/render.mjs applies to the client HTML export. lib/scrub.mjs composes them so the MCP

package/mcp-server/lib/knockout.mjs

@@ -27,7 +27,7 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, join } from "node:path";
 
-import { koPaths, addressListedFilings } from "./driver.mjs";
+import { koPaths, addressListedFilings, declaredRecordOrigins } from "./driver.mjs";
 import { driverDir } from "../../shared/driver-dir.mjs";
 
 const readJson = (p) => { try { return JSON.parse(readFileSync(p, "utf8")); } catch { return null; } };
@@ -213,7 +213,7 @@ export function knockoutEvidence(run) {
   // office's own page, or the office and the number and why that is not a link. This view states the same,
   // from the same function over the same sidecar, so the connector and the report cannot give one filing
   // two links. On any other register the call sets nothing, and every row is exactly as it was.
-  if (Array.isArray(recordsDoc?.marks)) addressListedFilings(recordsDoc);
+  if (Array.isArray(recordsDoc?.marks)) addressListedFilings(recordsDoc, declaredRecordOrigins(recordsDoc?.provider));
   const out = [];
 
   for (const entry of (Array.isArray(recordsDoc?.marks) ? recordsDoc.marks : [])) {

package/mcp-server/lib/options.mjs

@@ -238,11 +238,18 @@ function accountFor(key, { scope, now }) {
  * wherever it resolves — so there is no shut state left to probe, and the invitation cannot disagree with
  * the enforcement because neither consults an environment.
  *
- * An account that simply has no saved searches gets an empty list and no note.
+ * An account that simply has no saved searches gets an empty list and no note. A store that cannot be
+ * READ gets the empty list AND a note, because those are different facts, and an assistant told "none"
+ * repeats it to the client as the answer. The note names no variable and no path: its reader may be a
+ * client, and the reason belongs to whoever runs the installation, whose `clearotron doctor` names it.
  */
 function savedSearchesFor(key) {
   let recipes;
-  try { recipes = loadRecipes({ force: true, proseGuard: recipeProseGuard }); } catch { return { savedSearches: [], savedSearchesNote: null }; }
+  try { recipes = loadRecipes({ force: true, proseGuard: recipeProseGuard }); }
+  catch {
+    return { savedSearches: [], savedSearchesNote: "Saved searches could not be read on this installation, so none are "
+      + "listed. That is not the same as having none, and the people who run the installation can see why." };
+  }
   return {
     savedSearches: [...recipes.entries()]
       .filter(([k, r]) => k.startsWith(`${key}/`) && !r.archived)

package/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trademark-artifacts-mcp",
-  "version": "0.3.0-beta.2",
+  "version": "0.3.0-beta.4",
   "license": "AGPL-3.0-only",
   "private": true,
   "description": "MCP server to interrogate clearotron trademark-clearance runs — list/read artifacts, trace the full decision flow, telemetry/cost, coverage, single-run search, and a gated single-step what-if. Imports the clearotron-driver read-only; touches no driver/template/deploy files.",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clearotron",
   "type": "module",
-  "version": "0.3.0-beta.2",
+  "version": "0.3.0-beta.4",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",

package/portal-ui/dist/assets/{index-CsCuPshD.css → index-Cv-E_agg.css}

@@ -2205,127 +2205,249 @@ input.filter {
 }
 
 
-.ai-connect-head { margin-top: 28px; }
+/* ── WHAT YOU CAN DO ─────────────────────────────────────────────────────────────────────────────── */
+.ai-can { margin-top: 20px; max-width: 860px; }
 
-/* ── ONE QUESTION, WHEN THE DEPLOYMENT LEAVES IT OPEN ─────────────────────────── */
-.ai-where { margin: 0 0 14px; max-width: var(--screen-measure); }
+.ai-screen .ai-can h2 { font-size: 14.5px; margin: 0 0 3px; }
 
-.ai-where-q { margin: 0 0 8px; font-size: 15px; color: var(--text-strong); }
+.ai-can-list {
+  list-style: none;
+  margin: 8px 0 0;
+  padding: 0;
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 8px 28px;
+}
 
-.ai-seg { display: inline-flex; border: 1px solid var(--border-hairline); border-radius: 7px; overflow: hidden; }
+@media (max-width: 700px) { .ai-can-list { grid-template-columns: 1fr; } }
 
-.ai-seg-btn {
-  appearance: none;
-  border: 0;
-  background: transparent;
-  padding: 7px 14px;
-  font: inherit;
+.ai-can-list li { display: flex; gap: 9px; font-size: 14px; line-height: 1.5; color: var(--text-body); }
+
+.ai-can-list li svg { margin-top: 3px; color: var(--accent-quiet); }
+
+.ai-can-foot {
+  margin: 13px 0 0;
+  padding-top: 11px;
+  border-top: 1px solid var(--border-hairline);
+  font-size: 13.5px;
   color: var(--text-muted);
-  cursor: pointer;
 }
 
-.ai-seg-btn + .ai-seg-btn { border-left: 1px solid var(--border-hairline); }
-
-.ai-seg-btn[data-on] { background: var(--surface-sunken); color: var(--text-strong); }
+.ai-can-foot strong { color: var(--text-strong); }
 
-.ai-where-sub { margin: 10px 0 14px; color: var(--text-muted); max-width: var(--screen-measure); }
+.ai-connect { margin-top: 34px; }
 
-.ai-none { margin: 0; max-width: var(--screen-measure); color: var(--text-muted); line-height: 1.65; }
+.ai-screen .ai-connect-head { margin: 0 0 12px; }
 
-.ai-none strong { color: var(--text-strong); }
+/* ── THE WHERE-CHOICE ─────────────────────────────────────────────────────────────────────────────
+   ONE control, the same size before and after a pick. Selection is shown the way every other choice in
+   the portal shows it — accent wash, accent border, filled radio — and never a second colour. */
+.where-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
 
-/* ── THE DESTINATION LIST ─────────────────────────────────────────────────────────────────────────── */
-.ai-dests {
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-  max-width: var(--screen-measure);
-}
+@media (max-width: 640px) { .where-grid { grid-template-columns: 1fr; } }
 
-/* ONE HEIGHT AND ONE WIDTH, ALWAYS. The owner reported the old row set as "stacked, inconsistent
-   heights"; more importantly a row that resizes when it is pressed moves its neighbours, which is the
-   reflow this rebuild exists to end. */
-.ai-dest {
+.where-card {
   display: flex;
   align-items: center;
-  justify-content: space-between;
-  gap: 16px;
-  width: 100%;
-  min-height: 46px;
-  padding: 8px 14px;
-  border: 1px solid var(--border-hairline);
-  border-radius: 8px;
+  gap: 12px;
+  padding: 18px;
+  border: 1px solid var(--border-strong);
+  border-radius: 12px;
   background: var(--surface-raised);
   font: inherit;
+  font-size: 16px;
+  font-weight: 700;
+  line-height: 1.35;
+  color: var(--text-strong);
   text-align: left;
   cursor: pointer;
 }
 
-.ai-dest[data-selected] { border-color: var(--accent); }
+.where-card:hover { border-color: var(--accent-ink); }
 
-/* THE PRESSED CONTROL IS THE CONFIRMATION. Solid accent, not a muted caption underneath — the previous
-   feedback was grey text below the button and the owner could not see it happen. */
-.ai-dest[data-copied] {
-  background: var(--accent);
-  border-color: var(--accent);
-  color: var(--text-on-accent);
+.where-card[aria-pressed='true'],
+.where-card[aria-pressed='true']:hover { border-color: var(--accent); background: var(--accent-wash); }
+
+.ai-none { margin: 22px 0 0; max-width: 860px; border-left-color: var(--tone-medium); }
+
+.ai-none p { margin: 6px 0 0; color: var(--text-muted); font-size: 13.5px; line-height: 1.55; }
+
+/* ── THE APP LIST AND THE PANEL BESIDE IT ─────────────────────────────────────────────────────── */
+.ai-connect-grid {
+  display: grid;
+  grid-template-columns: minmax(260px, 360px) minmax(0, 1fr);
+  gap: 20px;
+  margin-top: 22px;
+  align-items: start;
 }
 
-.ai-dest[data-copied] .ai-dest-sub { color: inherit; opacity: 0.85; }
+@media (max-width: 860px) { .ai-connect-grid { grid-template-columns: 1fr; } }
+
+.ai-apps { display: flex; flex-direction: column; gap: 8px; margin-top: 6px; }
+
+/* The New Clearance picker's radio-row, centred because these rows carry a name and at most one line. */
+.ai-app { width: 100%; align-items: center; font: inherit; }
 
-.ai-dest-name { display: flex; flex-direction: column; gap: 2px; color: var(--text-strong); }
+.ai-app-label { min-width: 0; }
 
-.ai-dest[data-copied] .ai-dest-name { color: inherit; }
+.ai-app-name { display: block; font-size: 14px; font-weight: 700; color: var(--text-strong); }
 
-.ai-dest-sub { font-size: 12.5px; color: var(--text-faint); }
+.ai-app-sub { display: block; margin-top: 1px; font-size: 12px; line-height: 1.5; color: var(--text-muted); }
+
+.ai-app-go { margin-left: auto; display: inline-flex; color: var(--text-accent); opacity: 0; }
+
+.pick-row-on .ai-app-go { opacity: 1; }
+
+/* ── THE RESERVED SLOT ──────────────────────────────────────────────────────────────────────────────
+   A MINIMUM HEIGHT WHETHER OR NOT ANYTHING IS IN IT, and the page raises it to the tallest panel this
+   card can show — so neither picking an app nor pressing Copy moves anything around it. */
+.ai-slot { position: relative; min-height: 180px; }
+
+/* The hidden copy of every panel the slot's height is taken from. Laid out at the slot's own width, never
+   seen, never reached by a pointer or a keyboard. */
+.ai-probe {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  display: grid;
+  align-items: start;
+  visibility: hidden;
+  pointer-events: none;
+}
 
-/* THE SLOT BOTH LABELS SHARE. Laid out with a grid so the cell is as wide as the WIDER of the two, in
-   every row, whether or not it has been pressed — swapping the text then costs zero layout. */
-.ai-dest-say { display: grid; font-size: 13px; }
+/* Stacked in one cell, so the copy is as tall as its tallest panel and never taller than the slot. */
+.ai-probe > * { grid-area: 1 / 1; }
 
-.ai-dest-idle, .ai-dest-done { grid-area: 1 / 1; white-space: nowrap; }
+.steps-panel {
+  border: 1px solid var(--border-strong);
+  border-left: 3px solid var(--accent);
+  border-radius: 12px;
+  background: var(--surface-raised);
+  padding: 18px 20px 20px;
+}
 
-.ai-dest-idle { color: var(--text-faint); }
+.ai-slot > .steps-panel { min-height: inherit; }
 
-.ai-dest-done { color: inherit; font-weight: 600; visibility: hidden; }
+.steps-panel-empty {
+  border-left-color: var(--border-strong);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
 
-.ai-dest[data-copied] .ai-dest-idle { visibility: hidden; }
+.steps-empty { display: flex; align-items: center; gap: 9px; color: var(--text-faint); font-size: 14px; }
 
-.ai-dest[data-copied] .ai-dest-done { visibility: visible; }
+.ai-screen .steps-name { margin: 3px 0 0; font-size: 18px; font-weight: 700; color: var(--text-strong); }
 
-/* ── THE RESERVED SLOT ────────────────────────────────────────────────────────────────────────────── */
-/* A MINIMUM HEIGHT WHETHER OR NOT ANYTHING IS IN IT. This is what makes "nothing above the panel moves"
-   a property of the layout rather than a hope about content sizes. */
-.ai-slot {
+/* ── THE NUMBERED STEPS ─────────────────────────────────────────────────────────────────────────── */
+ol.steps {
+  list-style: none;
+  counter-reset: step;
   margin: 16px 0 0;
-  min-height: 240px;
-  max-width: var(--screen-measure);
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
 }
 
-.ai-slot-empty { margin: 0; color: var(--text-faint); }
+ol.steps > li {
+  counter-increment: step;
+  display: grid;
+  grid-template-columns: 24px minmax(0, 1fr);
+  gap: 11px;
+}
 
-.ai-panel {
-  padding: 14px 16px;
-  border: 1px solid var(--border-hairline);
-  border-radius: 8px;
+ol.steps > li::before {
+  content: counter(step);
+  width: 23px;
+  height: 23px;
+  margin-top: -1px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
   background: var(--surface-sunken);
+  border: 1px solid var(--border-hairline);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--text-muted);
 }
 
-.ai-panel-head { margin: 0 0 8px; font-size: 15px; color: var(--text-strong); }
+.step-text { font-size: 14px; line-height: 1.55; color: var(--text-body); }
+
+.step-text b { color: var(--text-strong); }
+
+.step-hint { margin-top: 4px; font-size: 12.5px; line-height: 1.5; color: var(--text-muted); }
 
-.ai-panel-landed { margin: 0 0 10px; font-size: 13px; color: var(--text-muted); }
+.ai-code {
+  padding: 1px 5px;
+  border: 1px solid var(--border-hairline);
+  border-radius: 4px;
+  background: var(--surface-sunken);
+  font-family: var(--font-mono);
+  font-size: 12px;
+  color: var(--text-strong);
+  overflow-wrap: anywhere;
+}
 
-.ai-panel-steps {
+.codeblock {
+  margin-top: 8px;
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+  padding: 10px 10px 10px 13px;
+  border: 1px solid var(--border-hairline);
+  border-radius: 10px;
+  background: var(--surface-sunken);
+}
+
+.codeblock pre {
+  flex: 1;
+  min-width: 0;
   margin: 0;
-  padding-left: 20px;
-  line-height: 1.7;
-  color: var(--text-body);
+  padding-top: 3px;
+  overflow-x: auto;
+  font-family: var(--font-mono);
+  font-size: 12px;
+  line-height: 1.6;
+  color: var(--text-strong);
 }
 
-.ai-panel-stamp { margin: 10px 0 0; font-size: 12.5px; color: var(--text-faint); }
+.codeblock .btn-ghost { padding: 6px 12px; white-space: nowrap; }
+
+.secret-btn { margin-top: 8px; }
+
+/* THE PRESSED CONTROL IS THE CONFIRMATION: solid accent on the button pressed, never a muted caption. */
+.is-copied,
+.is-copied:hover,
+.btn-primary.is-copied:hover:not(:disabled) { background: var(--accent); border-color: var(--accent); color: var(--text-on-accent); }
+
+.landed {
+  margin-top: 10px;
+  padding: 10px 13px;
+  border: 1px solid var(--border-hairline);
+  border-radius: 10px;
+  background: var(--surface-sunken);
+}
+
+.landed-label {
+  font-size: 10px;
+  font-weight: 700;
+  letter-spacing: 0.13em;
+  text-transform: uppercase;
+  color: var(--text-faint);
+}
+
+.landed .mono { font-size: 12px; color: var(--text-strong); overflow-wrap: anywhere; }
+
+.landed .mono + .mono { margin-top: 2px; }
 
 .ai-said { margin: 0 0 6px; color: var(--text-muted); }
 
+.ai-failed { margin: 10px 0 0; }
+
 .ai-pre {
   margin: 0;
   padding: 10px;
@@ -2335,21 +2457,12 @@ input.filter {
   font-size: 13px;
 }
 
-/* The help a person needs, on the page. The link to the document keeps an honest label beside it. */
-.ai-help { margin: 30px 0 0; max-width: var(--screen-measure); }
-
-.ai-help > summary {
-  cursor: pointer;
-  color: var(--text-muted);
-  font-size: 13px;
-  font-style: italic;
-}
-
-.ai-help-body { margin: 10px 0 0; color: var(--text-muted); line-height: 1.65; }
+/* The help a person needs, as a quiet notice. The link opens the document where a reader's own AI can
+   read it too. */
+.ai-help { margin-top: 30px; max-width: 860px; }
 
-.ai-help-body p { margin: 0 0 10px; }
+.ai-help p { margin: 6px 0 0; color: var(--text-muted); font-size: 13.5px; line-height: 1.55; }
 
-.ai-help-doc { font-size: 13px; }
 
 /* ── Give someone access: the points on the tree a new person can be given ─────────────────────────────
    One row per point. A BUTTON, because choosing a point is an action and a keyboard has to reach it; the