@@ -0,0 +1,68 @@
+// Two files, one top-level name — fine in the bundle, broken in the prototype.
+//
+// The build imports each source as an ES module, so a top-level `function X`
+// is module-scoped and two files may each have their own. The raw prototype
+// loads the same files as Babel <script> tags, where every top-level
+// declaration is a GLOBAL: the last file loaded wins, and the earlier file's
+// own call sites silently get the other one.
+//
+// That is how `AuditView` behaved. `qh-panels.jsx` had one for a single run's
+// trail and `qh-admin-audit.jsx` one for the admin screen; in the prototype the
+// developer view's Audit tab rendered the ADMIN component with no `st` prop and
+// threw `Cannot read properties of undefined (reading 'pushToast')`. The build
+// showed nothing, which is exactly why this is a test and not a habit.
+//
+// The mirror image of portal-globals.test.mjs: there the prototype was right
+// and the build broken; here the build is right and the prototype broken. Both
+// come from the same asymmetry, so both need a check nobody has to remember.
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync, readdirSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const SRC = resolve(HERE, '..', 'src');
+
+// `qh-api.jsx` and `qh-api-mock.jsx` are ALTERNATIVES — the prototype loads one
+// or the other, never both — so they are meant to define the same names.
+const ALTERNATIVES = new Set(['qh-api.jsx', 'qh-api-mock.jsx']);
+
+// Known and reported to design, not blessed: `qhAgo` exists twice with
+// DIFFERENT signatures (qh-panels takes an epoch number, qh-admin-data an ISO
+// string). It is their file and their call, so it is named here rather than
+// renamed unilaterally — and naming it keeps this test able to fail for
+// anything new. See CODE_TO_DESIGN_BRIEF.md, 2026-09-15.
+const KNOWN = new Set(['qhAgo']);
+
+function topLevelNames(src) {
+  const out = new Set();
+  for (const m of src.matchAll(/^(?:function|class|const)\s+([A-Za-z_$][\w$]*)/gm)) {
+    out.add(m[1]);
+  }
+  return out;
+}
+
+test('no top-level name is declared by two files that load together', () => {
+  const owners = new Map();
+  const clashes = [];
+  for (const f of readdirSync(SRC).filter(f => f.endsWith('.jsx')).sort()) {
+    for (const name of topLevelNames(readFileSync(resolve(SRC, f), 'utf8'))) {
+      const prev = owners.get(name);
+      if (prev === undefined) { owners.set(name, f); continue; }
+      if (ALTERNATIVES.has(prev) && ALTERNATIVES.has(f)) continue;
+      if (KNOWN.has(name)) continue;
+      clashes.push(`${name}: ${prev} and ${f}`);
+    }
+  }
+  assert.deepEqual(clashes, [],
+    'in the prototype the later file wins and the earlier one gets a stranger');
+});
+
+test('the run trail and the admin screen are not both AuditView', () => {
+  const panels = readFileSync(resolve(SRC, 'qh-panels.jsx'), 'utf8');
+  assert.match(panels, /function RunAuditView\b/,
+    'a run\'s trail is RunAuditView; AuditView is the admin screen');
+  assert.doesNotMatch(panels, /function AuditView\b/);
+  assert.match(panels, /<RunAuditView\b/, 'and it is what the tab renders');
+});
@@ -1295,7 +1295,7 @@ function ResultsPanel({ tab, setTab, result, messages, audit, status, runMs, onE
         {tab === 'results' && <ResultsView key={'st' + stN} result={result} status={status} onToast={onToast} colMeta={colMeta} unmasked={unmasked} />}
         {tab === 'plan' && <PlanView plan={plan} />}
         {tab === 'messages' && <MessagesView messages={messages} />}
-        {tab === 'audit' && <AuditView audit={audit} />}
+        {tab === 'audit' && <RunAuditView audit={audit} />}
       </div>
     </div>
   );
@@ -1854,7 +1854,16 @@ function MessagesView({ messages }) {
   </div>;
 }
 
-function AuditView({ audit }) {
+// A RUN's audit trail — the events of the one request in this results panel.
+// NOT the admin Audit screen, which `qh-admin-audit.jsx` also called
+// `AuditView`. In the raw prototype every top-level function is a global and
+// the later script wins, so this component rendered the ADMIN screen with no
+// `st` prop: the developer view's Audit tab threw `Cannot read properties of
+// undefined (reading 'pushToast')` and took the page to the error boundary.
+// The bundle never showed it — main.jsx imports each file as a module, so the
+// two stayed in separate scopes — which is the whole reason to rename rather
+// than rely on that.
+function RunAuditView({ audit }) {
   if (!audit.length) return <div className="qh-empty"><div>Audit entries appear after you submit a query.</div></div>;
   return <div className="qh-audit">
     {audit.map((a, i) => (
 
@@ -136,7 +136,14 @@ def _catalog_functions(target_id: int, database: str) -> list[dict]:
 # Relations the browser lists. Views belong here: a view is as queryable as a
 # table, so autocomplete and the tree both want it. What it is NOT is a table,
 # and the ref carries `k` so the reader can be told which one it is looking at.
-_LISTED_RELKINDS = ("table", "partitioned", "view", "matview")
+#
+# `foreign` is listed for the same reason -- a foreign table is selected from
+# like any other, and a kind left out of this tuple does not fall back to
+# "table": it is dropped from the list entirely and the relation becomes
+# invisible in the tree, in autocomplete and in fleet search. There are none in
+# this fleet today, which is exactly why it had to be decided now rather than
+# the day one appears.
+_LISTED_RELKINDS = ("table", "partitioned", "view", "matview", "foreign")
 
 
 def _catalog_table_refs(target_id: int, database: str) -> list[dict]:
 
@@ -124,6 +124,24 @@ def test_a_view_is_listed_but_marked_as_one(monkeypatch):
         ("daily_totals", "matview")]
 
 
+def test_a_kind_left_off_the_list_disappears_rather_than_defaulting(monkeypatch):
+    """The client reads a ref with no `k` as a table. A kind missing from
+    `_LISTED_RELKINDS` never gets that far: the SQL drops it, so the relation is
+    absent from the tree, from autocomplete and from search -- silently, and in
+    the same shape as the bug this list was added to fix."""
+    rows = [_tbl(1, "a", "public", "orders"),
+            _tbl(1, "a", "public", "remote_ledger", "foreign"),
+            _tbl(1, "a", "public", "an_index", "index")]
+    monkeypatch.setattr(routes_data.db, "fetch_all",
+                        lambda *a, **k: [r for r in rows
+                                         if r["relkind"] in routes_data._LISTED_RELKINDS])
+    got = routes_data._catalog_table_refs_map([(1, "a")])[(1, "a")]
+    assert [r["n"] for r in got] == ["orders", "remote_ledger"], (
+        "a foreign table is selected from like any other and must be listed")
+    assert "foreign" in routes_data._LISTED_RELKINDS
+    assert "index" not in routes_data._LISTED_RELKINDS
+
+
 def test_the_single_read_and_the_batched_one_agree_on_shape(monkeypatch):
     """The tree renders from whichever of the two answered. A ref missing `k`
     from one of them is a view drawn as a table on that path only."""