mlx-bun 0.2.0 → 0.4.0

package/src/web/app.js

@@ -1,7 +1,7 @@
 // GENERATED — do not edit by hand.
 // Source: src/web/src/*.ts (entrypoint main.ts). To regenerate:
 //   bun scripts/build-web.ts
-// tests/web-build.test.ts enforces that this file matches the source.
+// tests/using/web-build.test.ts enforces that this file matches the source.
 // src/web/src/api.ts
 async function api(path, opts) {
   const { body, ...rest } = opts || {};
@@ -994,14 +994,14 @@ function highlightIn(container) {
     return;
   const blocks = container.querySelectorAll("pre code");
   for (const block of blocks) {
-    const el2 = block;
-    if (el2.dataset.highlighted)
+    const el = block;
+    if (el.dataset.highlighted)
       continue;
-    const hasLang = /\blanguage-/.test(el2.className);
-    if (!hasLang && (el2.textContent || "").length > 20000)
+    const hasLang = /\blanguage-/.test(el.className);
+    if (!hasLang && (el.textContent || "").length > 20000)
       continue;
     try {
-      hljs.highlightElement(el2);
+      hljs.highlightElement(el);
     } catch {}
   }
 }
@@ -2611,12 +2611,12 @@ async function renderListBody() {
 async function renderArticleLists(query) {
   const listEl = $("mem-list");
   if (!query) {
-    const d2 = await getJson("/api/memory/list").catch(() => ({ ok: false }));
-    if (!d2.ok) {
+    const d = await getJson("/api/memory/list").catch(() => ({ ok: false }));
+    if (!d.ok) {
       listEl.innerHTML = `<div class="mem-list-empty">Couldn't load the vault contents.</div>`;
       return;
     }
-    const articles = d2.articles || [], reference = d2.reference || [];
+    const articles = d.articles || [], reference = d.reference || [];
     listEl.innerHTML = '<div class="mem-sec"><div class="mem-sec-title">Articles</div>' + (articles.length ? articles.map((a) => articleRowHtml(a)).join("") : '<div class="mem-list-empty">No articles yet — nightly synthesis writes here after a few conversations.</div>') + "</div>" + (reference.length ? '<div class="mem-sec"><div class="mem-sec-title">Reference</div>' + reference.map((r) => articleRowHtml(r, undefined, "\uD83D\uDCD8")).join("") + "</div>" : "");
     wireArticleRows(listEl);
     return;
@@ -2892,11 +2892,13 @@ function initMemoryPanel() {
   maybeShowConsentCard();
 }
 
+// src/contracts/pi.ts
+var APP_ROUTE_IDS = ["chat", "quantize", "finetune", "dataset", "status"];
+
 // src/web/src/ui-catalog.ts
-var ROUTE_IDS = ["chat", "quantize", "finetune", "dataset", "status"];
 var VIEW_IDS = ["memory-panel", "hub-panel", "settings", "adapters-panel"];
 function isRouteId(v) {
-  return ROUTE_IDS.includes(v);
+  return APP_ROUTE_IDS.includes(v);
 }
 function isViewId(v) {
   return VIEW_IDS.includes(v);
@@ -2951,11 +2953,11 @@ var INTERACTIVE_SELECTOR = [
   "[data-spotlight]"
 ].join(", ");
 var MAX_ELEMENTS = 120;
-function isAgentChrome(el2) {
-  return !!el2.closest("[data-ui-chrome]") || !!el2.closest("#toasts");
+function isAgentChrome(el) {
+  return !!el.closest("[data-ui-chrome]") || !!el.closest("#toasts");
 }
-function isHiddenSelf(el2) {
-  const html = el2;
+function isHiddenSelf(el) {
+  const html = el;
   if (html.hidden)
     return true;
   const inline = html.style?.display;
@@ -2966,21 +2968,21 @@ function isHiddenSelf(el2) {
     return true;
   return false;
 }
-function isVisible(el2) {
-  const html = el2;
+function isVisible(el) {
+  const html = el;
   if (html.offsetParent === null) {
     const style = globalThis.getComputedStyle?.(html);
     if (style && style.position === "fixed")
       return true;
   }
-  for (let node = el2;node; node = node.parentElement) {
+  for (let node = el;node; node = node.parentElement) {
     if (isHiddenSelf(node))
       return false;
   }
   return true;
 }
-function elementLabel(el2) {
-  const html = el2;
+function elementLabel(el) {
+  const html = el;
   const uiLabel = html.getAttribute("data-ui-label")?.trim();
   if (uiLabel)
     return uiLabel;
@@ -3015,13 +3017,13 @@ function captureUiSnapshot(route) {
   const elements = [];
   const seenRefs = new Set;
   let index = 0;
-  for (const el2 of nodes) {
-    if (isAgentChrome(el2) || !isVisible(el2))
+  for (const el of nodes) {
+    if (isAgentChrome(el) || !isVisible(el))
       continue;
-    const label = elementLabel(el2);
+    const label = elementLabel(el);
     if (!label)
       continue;
-    const html = el2;
+    const html = el;
     const spotlightId = html.getAttribute("data-spotlight")?.trim() || undefined;
     const existingRef = html.getAttribute("data-ui-ref");
     const ref = existingRef ?? `ui-${route.replace(/[^a-zA-Z0-9]/g, "_") || "root"}-${index}`;
@@ -3065,12 +3067,12 @@ function findByLabel(snapshot, label) {
     return;
   let best;
   let bestScore = 0;
-  for (const el2 of snapshot.elements) {
-    const hay = [el2.label, el2.spotlightId].filter(Boolean).join(" ");
+  for (const el of snapshot.elements) {
+    const hay = [el.label, el.spotlightId].filter(Boolean).join(" ");
     const score = matchScore(hay, label);
     if (score > bestScore) {
       bestScore = score;
-      best = el2;
+      best = el;
     }
   }
   return bestScore >= 50 ? best : undefined;
@@ -3087,9 +3089,9 @@ function safeQuery(selector) {
 }
 function resolveSpotlightTarget(request, snapshot) {
   if (request.ref) {
-    const el2 = snapshot?.elements.find((e) => e.ref === request.ref);
-    if (el2)
-      return { selector: el2.selector, title: el2.label, message: request.message };
+    const el = snapshot?.elements.find((e) => e.ref === request.ref);
+    if (el)
+      return { selector: el.selector, title: el.label, message: request.message };
     const selector = `[data-ui-ref="${attrEscape(request.ref)}"]`;
     if (safeQuery(selector)) {
       return { selector, title: request.label ?? request.ref, message: request.message };
@@ -3099,9 +3101,9 @@ function resolveSpotlightTarget(request, snapshot) {
     return { selector: request.selector, title: request.label ?? "Here", message: request.message };
   }
   if (request.label) {
-    const el2 = findByLabel(snapshot, request.label);
-    if (el2)
-      return { selector: el2.selector, title: el2.label, message: request.message };
+    const el = findByLabel(snapshot, request.label);
+    if (el)
+      return { selector: el.selector, title: el.label, message: request.message };
     let bestEl = null;
     let bestScore = 0;
     for (const node of document.querySelectorAll("[data-ui-label]")) {
@@ -3142,15 +3144,15 @@ var AUTO_DISMISS_MS = 3000;
 var dismissTimer = null;
 var dismissListeners = null;
 function ensureOverlayEl() {
-  let el2 = document.getElementById("assistant-spotlight");
-  if (!el2) {
-    el2 = document.createElement("div");
-    el2.id = "assistant-spotlight";
-    el2.setAttribute("data-ui-chrome", "assistant");
-    el2.innerHTML = '<div class="asr-ring"></div><div class="asr-pop"><div class="asr-pop-text"></div></div>';
-    document.body.appendChild(el2);
+  let el = document.getElementById("assistant-spotlight");
+  if (!el) {
+    el = document.createElement("div");
+    el.id = "assistant-spotlight";
+    el.setAttribute("data-ui-chrome", "assistant");
+    el.innerHTML = '<div class="asr-ring"></div><div class="asr-pop"><div class="asr-pop-text"></div></div>';
+    document.body.appendChild(el);
   }
-  return el2;
+  return el;
 }
 function dismissSpotlight() {
   if (dismissTimer) {
@@ -3161,9 +3163,9 @@ function dismissSpotlight() {
     dismissListeners();
     dismissListeners = null;
   }
-  const el2 = document.getElementById("assistant-spotlight");
-  if (el2)
-    el2.classList.remove("show");
+  const el = document.getElementById("assistant-spotlight");
+  if (el)
+    el.classList.remove("show");
 }
 function showSpotlight(resolved) {
   const target = safeQuery(resolved.selector);
@@ -3330,7 +3332,7 @@ function createChatController() {
     }
     return false;
   }
-  function currentView2() {
+  function currentView() {
     if ($("mem-overlay")?.classList.contains("open"))
       return "memory-panel";
     if ($("hub-overlay")?.classList.contains("open"))
@@ -3343,16 +3345,16 @@ function createChatController() {
     const route = currentRoute();
     if (!isRouteId(route))
       return;
-    const ctx = buildAppContext(route, currentView2());
+    const ctx = buildAppContext(route, currentView());
     lastSnapshot = ctx.snapshot;
     send({ type: "context", context: ctx });
   }
   function watchWizardSteps() {
     const mo = new MutationObserver(() => pushAppContext());
     for (const id of ["q-steps", "f-steps", "d-steps"]) {
-      const el2 = $(id);
-      if (el2)
-        mo.observe(el2, { childList: true, subtree: true });
+      const el = $(id);
+      if (el)
+        mo.observe(el, { childList: true, subtree: true });
     }
   }
   function setChatStatus(s) {
@@ -3546,8 +3548,8 @@ function createChatController() {
     if (t)
       return t;
     if (isMemoryToolName(tool || "")) {
-      const handle2 = memoryToolChip(a.bubble, tool, args);
-      t = { kind: "memchip", wrap: handle2.wrap, handle: handle2, chunks: "" };
+      const handle = memoryToolChip(a.bubble, tool, args);
+      t = { kind: "memchip", wrap: handle.wrap, handle, chunks: "" };
       a.tools.set(callId, t);
       stick();
       return t;
@@ -3761,9 +3763,9 @@ function createChatController() {
     }
     for (const t of item.tools || []) {
       if (isMemoryToolName(t.name || "")) {
-        const handle2 = memoryToolChip(bubble, t.name, t.args);
+        const handle = memoryToolChip(bubble, t.name, t.args);
         if (t.result)
-          handle2.setResult(t.result);
+          handle.setResult(t.result);
         continue;
       }
       const wrap = el("div", "tool ok", bubble);
@@ -4079,9 +4081,9 @@ function createChatController() {
       watchWizardSteps();
       const overlayMo = new MutationObserver(() => pushAppContext());
       for (const id of ["mem-overlay", "hub-overlay", "adapters-overlay"]) {
-        const el2 = $(id);
-        if (el2)
-          overlayMo.observe(el2, { attributes: true, attributeFilter: ["class"] });
+        const el = $(id);
+        if (el)
+          overlayMo.observe(el, { attributes: true, attributeFilter: ["class"] });
       }
     },
     enter() {
@@ -4891,7 +4893,7 @@ function createStatusController() {
   async function loadFit() {
     let f;
     try {
-      f = await fetch("/fit").then((r2) => r2.json());
+      f = await fetch("/fit").then((r) => r.json());
     } catch {
       return;
     }
@@ -5317,9 +5319,9 @@ async function openHubPanel() {
   if (inFlightDownloads.size)
     ensureDownloadPolling();
   setTimeout(() => {
-    const el22 = $("hub-search-input");
-    if (el22)
-      el22.focus();
+    const el2 = $("hub-search-input");
+    if (el2)
+      el2.focus();
   }, 30);
 }
 function setOfflineFooter(offline) {

package/src/web/src/adapters-panel.ts

@@ -9,9 +9,9 @@
 // docs/reference/server-api.md), with compatible-graying and a why-not
 // tooltip. Actions: mount, select, unselect, and stack two compatible
 // adapters as "a+b" — resolveSpec/injectAdapter already support composite
-// ids end to end (proved in tests/pi-web.test.ts's stacking test; the
+// ids end to end (proved in tests/research/pi-web.test.ts's stacking test; the
 // shape-validated mount is proved against real weights in the
-// MLX_BUN_TEST_LORA=1-gated tests/lora.test.ts).
+// MLX_BUN_TEST_LORA=1-gated tests/parity/lora.test.ts).
 //
 // Single source of SELECTION state, not a single fetch: composer.ts's quick
 // <select> and this table each hit /v1/adapters(+/available) independently
@@ -158,7 +158,7 @@ export function renderAdapterRow(
 }
 
 /** Full table body: a stack-mode toggle + composed-spec bar (when picks
- *  exist), then one section of rows. Exported so tests/web-app.test.ts can
+ *  exist), then one section of rows. Exported so tests/using/web-app.test.ts can
  *  exercise esc() discipline without a live DOM/network. */
 export function renderAdaptersBodyHtml(state: AdaptersPanelState): string {
   if (!state.available.length) {

package/src/web/src/assistant.ts

@@ -1,3 +1,5 @@
+import type { UiSnapshotElement, UiSnapshot, WizardStep } from "../../contracts/pi";
+export type { UiSnapshotElement, UiSnapshot, WizardStep } from "../../contracts/pi";
 // GENERATED-ADJACENT source module — part of the src/web/src/* split (plan
 // §6.6 "the app-aware assistant", §9 Phase 3, beat matrix Axis 12). Built
 // into src/web/app.js by scripts/build-web.ts.
@@ -26,42 +28,6 @@
 
 import { getSpotlightTarget, isViewId, ROUTE_LABELS, type RouteId, type ViewId } from "./ui-catalog";
 
-/* ────────────────────────────────────────────────────────────────────
-   1. SEE — the structured DOM snapshot
-   ──────────────────────────────────────────────────────────────────── */
-
-export interface UiSnapshotElement {
-  ref: string;
-  tag: string;
-  label: string;
-  kind: "interactive" | "region";
-  role?: string;
-  selector: string;
-  spotlightId?: string;
-}
-
-export interface UiSnapshot {
-  route: string;
-  capturedAt: string;
-  elements: UiSnapshotElement[];
-}
-
-/** Process-state fields layered onto the snapshot (§6.6 "the snapshot
- *  carries process state, not just elements") — wizard step for the
- *  quantize/finetune/dataset wizards, when the current route has one.
- *  Derived by reading the DOM the step indicator already renders
- *  (markdown.ts's renderSteps into #q-steps/#f-steps/#d-steps + the
- *  [data-qstep]/[data-fstep]/[data-dstep] visibility toggle quantize.ts/
- *  finetune.ts/dataset.ts already do) rather than adding a callback hook to
- *  those three controllers — zero behavior change to files outside this
- *  wave's scope, and the DOM IS the source of truth those controllers
- *  already write to. */
-export interface WizardStep {
-  index: number;
-  count: number;
-  label: string;
-}
-
 const STEP_CONTAINER_BY_ROUTE: Partial<Record<RouteId, string>> = {
   quantize: "q-steps",
   finetune: "f-steps",

package/src/web/src/chat.ts

@@ -10,15 +10,15 @@
 // typed, checkable seams between these concerns).
 //
 // Typed WS contract (plan §9 Phase 2 item 2): ClientMessage/ServerMessage
-// and the history/session shapes are imported TYPE-ONLY from ../../pi-web
+// and the history/session shapes are imported TYPE-ONLY from ../../contracts/pi
 // so this module (and the whole bundle) contains zero server code — the
 // bundler errors on bun:ffi if a value import ever sneaks in here, which is
 // the intended guard (see scripts/build-web.ts).
 
 import type {
   ClientMessage, HistoryItem, ReadyGenDefaults, ServerMessage, SessionListItem,
-} from "../../pi-web";
-import type { Lane } from "../../serve/lane-registry";
+} from "../../contracts/pi";
+import type { Lane } from "../../contracts/pi";
 import {
   $, el, toast, currentRoute, closeDrawer,
   storedCodingToolsPreference, renderCodingToolsState, renderToolApprovals,
@@ -44,7 +44,7 @@ import { isRouteId } from "./ui-catalog";
 
 /* ────────────────────────────────────────────────────────────────────
    Chat-with-files RAG v1 — Sources panel (plan §9 Phase 3, beat matrix
-   Axis 5). Pure HTML builder so tests/web-app.test.ts can exercise the
+   Axis 5). Pure HTML builder so tests/using/web-app.test.ts can exercise the
    esc() discipline directly, same reasoning as renderAdapterOptionsHtml
    etc. in composer.ts.
    ──────────────────────────────────────────────────────────────────── */

package/src/web/src/composer.ts

@@ -10,8 +10,8 @@
 // the original single IIFE), but every WS send goes through a callback
 // passed in from chat.ts, which owns the actual WebSocket.
 
-import type { ReadyGenDefaults, SamplingOverrides } from "../../pi-web";
-import type { Lane } from "../../serve/lane-registry";
+import type { ReadyGenDefaults, SamplingOverrides } from "../../contracts/pi";
+import type { Lane } from "../../contracts/pi";
 import { api } from "./api";
 import type { ApiEnvelope } from "./protocol";
 import {
@@ -200,7 +200,7 @@ function escHtml(s: unknown): string {
 
 /** Pure: builds the <option> markup for the adapter <select> from the
  *  /v1/adapters/available list. Split out from refreshAdapters() (which
- *  does the fetch + DOM write) so tests/web-app.test.ts can exercise the
+ *  does the fetch + DOM write) so tests/using/web-app.test.ts can exercise the
  *  esc() discipline on this template directly without a DOM or network —
  *  every interpolated field (id, rank, path, base_model) must be escaped,
  *  since adapter ids/paths are user-controlled (on-disk directory names). */
@@ -719,7 +719,7 @@ export function renderLane(lane: Lane | undefined): void {
    already resolves, so the agent's memory tools pick it up naturally, same
    as in the vault's own prose). No vault -> files-only picker. Pure
    query-detection/insertion helpers below are unit-tested directly
-   (tests/web-app.test.ts); DOM wiring (initMentionPicker) owns the
+   (tests/using/web-app.test.ts); DOM wiring (initMentionPicker) owns the
    picker's open/close/keyboard-nav state.
    ──────────────────────────────────────────────────────────────────── */
 

package/src/web/src/hub.ts

@@ -119,7 +119,7 @@ function localRowHtml(m: HubLocalRow): string {
 }
 
 /** Pure render, exported for esc()-discipline + empty-state tests
- *  (tests/web-app.test.ts, mirroring renderModelPopBodyHtml's pattern). */
+ *  (tests/using/web-app.test.ts, mirroring renderModelPopBodyHtml's pattern). */
 export function renderHubLocalHtml(models: HubLocalRow[]): string {
   if (!models.length) {
     return '<div class="hub-empty">No models downloaded yet — search Hugging Face below to get one.</div>';

package/src/web/src/memory-panel.ts

@@ -394,7 +394,7 @@ export async function refreshSidebarEntry(): Promise<void> {
 // by a literal list rather than an import: this module must stay
 // server-code-free (bundler-enforced, see chat.ts's header comment), so it
 // can't import a value from src/memory/tools.ts even though the identifiers
-// are the same. tests/web-app.test.ts cross-checks this list against the
+// are the same. tests/using/web-app.test.ts cross-checks this list against the
 // real export so drift is caught at test time instead of silently.
 export const MEMORY_CHIP_TOOL_NAMES = [
   "memory_resolve", "memory_category", "memory_read", "memory_section",

package/src/web/src/model-picker.ts

@@ -85,7 +85,7 @@ function renderRow(m: LibraryRow): string {
 }
 
 /** Pure render of the popover body from a /library response. Exported for
- *  tests/web-app.test.ts's esc() discipline check (repo ids are
+ *  tests/using/web-app.test.ts's esc() discipline check (repo ids are
  *  user-controlled HF strings — the same class of interpolation hazard
  *  finding #15 flagged for the adapter dropdown). */
 export function renderModelPopBodyHtml(models: LibraryRow[]): string {

package/src/web/src/palette.ts

@@ -39,7 +39,7 @@ interface PaletteAction {
 }
 
 /** Pure: the static action list, independent of any live session data —
- *  independently testable (tests/web-app.test.ts asserts labels/ids without
+ *  independently testable (tests/using/web-app.test.ts asserts labels/ids without
  *  needing a DOM). Session rows and message-search hits are appended
  *  dynamically in refreshResults() below, not part of this list. */
 export function staticActions(): PaletteAction[] {

package/src/web/src/protocol.ts

@@ -1,47 +1,11 @@
-// Shared frontend-only protocol shapes that don't already live on the
-// server side as exported types. The WS contract itself (ClientMessage /
-// ServerMessage / HistoryItem / SessionListItem / ReadyGenDefaults) is
-// imported type-only from ../../pi-web — see chat.ts. This file only holds
-// shapes with no server-side export to anchor to (e.g. the SSE job-stream
-// events, which live as a doc-comment in app.html today, not a type).
-//
-// Pointer comment for the server side: src/web/src/protocol.ts mirrors the
-// SSE line protocol documented at the jobStream() call site (api.ts) —
-// keep the two adjacent if the job event shape changes server-side
-// (scripts/ that emit `data:` lines for /api/jobs/:id/stream).
-
-/** One line of the /api/jobs/:id/stream SSE protocol (JSON per `data:` line). */
-export type JobEvent =
-  | { type: "log"; line: string }
-  | {
-      type: "stage";
-      stage: string;
-      progress?: number;
-      message?: string;
-      output_dir?: string;
-      adapter_path?: string;
-      // Dataset-generation-specific row counts (present on the dataset
-      // builder's job stream only; absent/ignored for quantize/finetune).
-      n_train?: number;
-      n_valid?: number;
-    }
-  | {
-      type: "metric";
-      kind: "train" | "val";
-      step: number;
-      loss: number;
-      learning_rate?: number;
-      tokens_per_sec?: number;
-      progress?: number;
-      message?: string;
-    }
-  | { type: "done"; n_train?: number; n_valid?: number }
-  | { type: "failed"; error?: string };
+import type { JobEvent } from "../../contracts/jobs";
+export type { JobEvent } from "../../contracts/jobs";
 
 /** Handlers passed to jobStream(); each key is an optional callback for the
  *  matching JobEvent variant, plus an `error` callback for the EventSource's
  *  own onerror (transport failure, not a `failed` protocol event). */
 export interface JobStreamHandlers {
+  started?: (e: Extract<JobEvent, { type: "started" }>) => void;
   log?: (e: Extract<JobEvent, { type: "log" }>) => void;
   stage?: (e: Extract<JobEvent, { type: "stage" }>) => void;
   metric?: (e: Extract<JobEvent, { type: "metric" }>) => void;

package/src/web/src/sessions.ts

@@ -20,7 +20,7 @@
 // wires each rendered `.sess` row's click to `onOpen` below — this just
 // finds and clicks the right row instead of duplicating that send()).
 
-import type { SessionListItem } from "../../pi-web";
+import type { SessionListItem } from "../../contracts/pi";
 import { $, el, injectStyles } from "./shell";
 import { api } from "./api";
 

package/src/web/src/ui-catalog.ts

@@ -2,28 +2,14 @@
 // §7/§9 Phase 3, §6.6 "app-aware assistant"). Built into src/web/app.js by
 // scripts/build-web.ts.
 //
-// The frontend half of the app-aware assistant's route/spotlight catalog.
-// Mirrors PortfolioManager's ui-catalog.json pattern (client/src/lib/
-// ui-catalog.ts + server/src/agent/ui-catalog.ts, read together with
-// server/src/agent/portfolio-tools.ts as the reference implementation) but
-// inlined as a TS module (not a shared JSON file) since mlx-bun's server and
-// browser bundles are separate build outputs (scripts/build-web.ts vs bun's
-// own TS execution) with no shared-JSON-import convention today — pi-web.ts
-// mirrors ROUTE_IDS/SPOTLIGHT_TARGETS as plain string arrays for its own
-// server-side validation (navigate_app/spotlight_ui reject anything not in
-// that list BEFORE touching the browser) so route validity is checked at
-// both ends without a build-time shared asset.
-//
-// Keep this list's ROUTE_IDS in sync with shell.ts's ROUTES tuple (chat,
-// quantize, finetune, dataset, status) plus the Developer-only overlays that
-// aren't hash-routes (memory panel, hub panel, settings) — those are
-// `view`s, not `route`s (see UiContext.view below), reached by opening an
-// overlay rather than changing the URL hash.
+// Shared route IDs keep browser navigation and server validation in agreement.
+// Spotlight selectors and overlay IDs belong to the browser.
 
 /** A hash-routed page (shell.ts's Route union, minus "routes" — the DAG
  *  diagram tab isn't a useful assistant destination and is itself
  *  feature-detected/hidden when unavailable). */
-export const ROUTE_IDS = ["chat", "quantize", "finetune", "dataset", "status"] as const;
+import { APP_ROUTE_IDS as ROUTE_IDS } from "../../contracts/pi";
+export { ROUTE_IDS };
 export type RouteId = (typeof ROUTE_IDS)[number];
 
 /** A non-route overlay/panel the assistant can navigate to or spotlight

package/src/web-assets.ts

@@ -0,0 +1,47 @@
+// Embedded web app — the unified SPA (chat / quantize / finetune /
+// dataset / status). `with { type: "text" }` inlines the file in both
+// `bun run` and the compiled single binary. bun-types types *.html
+// imports as HTMLBundle (the html loader), but the text attribute makes
+// the runtime value a string — hence the double cast.
+import appHtml from "./web/app.html" with { type: "text" };
+import curveDesignerHtml from "./lab/curve/curve-designer.html" with { type: "text" };
+// Vendored, no-CDN static assets referenced by app.html (convention: any
+// self-contained JS/CSS too big to inline gets `with { type: "text" }`
+// imported here and served under /assets/<name>; see src/web/vendor/README
+// for how hljs.js was built). Add new vendored assets the same way.
+import hljsJs from "./web/vendor/hljs.js" with { type: "text" };
+import hljsCss from "./web/vendor/hljs-theme.css" with { type: "text" };
+// The frontend bundle (plan §7/§9 Phase 2 module split): GENERATED from
+// src/web/src/*.ts by `bun scripts/build-web.ts` — see that file's header
+// and tests/using/web-build.test.ts (the freshness gate). Same
+// with { type: "text" } + /assets/<name> pattern as the vendored assets
+// above; app.html's <script defer src="/assets/app.js"> loads it.
+import appJs from "./web/app.js" with { type: "text" };
+// PWA installability (plan §9 Phase 3, beat-matrix Axis 10): a manifest +
+// a single inline SVG icon (no binary PNGs — the hygiene gate forbids
+// tracked binary files; some browsers won't show an SVG app icon, which is
+// an accepted tradeoff, see docs/reference/server-config.md) + a shell-
+// only service worker. Same with { type: "text" } + /assets/<name>-shaped
+// pattern as the vendored assets above; see src/web/sw.js's header for why
+// it deliberately does NOT cache API/WS traffic.
+import manifestWebmanifest from "./web/manifest.webmanifest" with { type: "text" };
+import iconSvg from "./web/icon.svg" with { type: "text" };
+import swJs from "./web/sw.js" with { type: "text" };
+const APP_PAGE = appHtml as unknown as string;
+const HLJS_JS = hljsJs as unknown as string;
+const HLJS_CSS = hljsCss as unknown as string;
+const APP_JS = appJs as unknown as string;
+const MANIFEST_WEBMANIFEST = manifestWebmanifest as unknown as string;
+const ICON_SVG = iconSvg as unknown as string;
+const SW_JS = swJs as unknown as string;
+const CURVE_PAGE = curveDesignerHtml as unknown as string;
+export const STATIC_ROUTE_ASSETS = {
+  appPage: APP_PAGE,
+  appJs: APP_JS,
+  hljsJs: HLJS_JS,
+  hljsCss: HLJS_CSS,
+  manifest: MANIFEST_WEBMANIFEST,
+  iconSvg: ICON_SVG,
+  serviceWorker: SW_JS,
+  curvePage: CURVE_PAGE,
+};