ltcai 2.2.7 → 3.1.0

package/static/v3/js/core/routes.f935dd50.js

@@ -0,0 +1,78 @@
+/* ============================================================================
+ * Lattice AI v3 — Information architecture (single source of truth)
+ *
+ * One declarative table drives the nav rail, the command palette, the router,
+ * breadcrumbs, and lazy view loading. Mode gating (Basic < Advanced < Admin)
+ * and the Admin section live here so the whole shell stays consistent.
+ * ========================================================================== */
+
+export const MODE_RANK = { basic: 0, advanced: 1, admin: 2 };
+
+/** Nav groups in display order. */
+export const GROUPS = [
+  { id: "workspace", label: "Workspace" },
+  { id: "retrieval", label: "Retrieval" },
+  { id: "data", label: "Data" },
+  { id: "compute", label: "Compute" },
+  { id: "system", label: "System" },
+  { id: "admin", label: "Administration", adminOnly: true },
+];
+
+/**
+ * Route table. `minMode` = lowest mode in which the item appears in the rail
+ * (deep-links still resolve). `view` = module basename under js/views/.
+ */
+export const ROUTES = [
+  // Workspace
+  { key: "home", label: "Home", icon: "layout-dashboard", group: "workspace", minMode: "basic", view: "home", title: "Home", desc: "Your local-first AI workspace at a glance." },
+  { key: "chat", label: "Chat", icon: "message-2", group: "workspace", minMode: "basic", view: "chat", title: "Chat", desc: "Grounded conversation over your indexed workspace." },
+
+  // Retrieval (the product identity)
+  { key: "knowledge-graph", label: "Knowledge Graph", icon: "chart-dots-3", group: "retrieval", minMode: "basic", view: "knowledge-graph", title: "Knowledge Graph", desc: "Entities and relations extracted from your workspace." },
+  { key: "hybrid-search", label: "Hybrid Search", icon: "arrows-join", group: "retrieval", minMode: "basic", view: "hybrid-search", title: "Hybrid Search", desc: "Graph structure fused with vector similarity." },
+
+  // Data
+  { key: "files", label: "Files", icon: "folders", group: "data", minMode: "basic", view: "files", title: "Files", desc: "Connected sources and indexed documents." },
+  { key: "pipeline", label: "Pipeline", icon: "git-branch", group: "data", minMode: "advanced", view: "pipeline", title: "Pipeline", desc: "Ingest, embed, and graph-build flows." },
+
+  // Compute
+  { key: "agents", label: "Agents", icon: "robot", group: "compute", minMode: "advanced", view: "agents", title: "Agents", desc: "Multi-agent roles, runs, and handoffs." },
+  { key: "models", label: "Models", icon: "cpu", group: "compute", minMode: "basic", view: "models", title: "Models", desc: "Local MLX models and embeddings." },
+  { key: "my-computer", label: "My Computer", icon: "device-desktop-analytics", group: "compute", minMode: "advanced", view: "my-computer", title: "My Computer", desc: "Local hardware, memory, and runtime." },
+
+  // System
+  { key: "settings", label: "Settings", icon: "settings", group: "system", minMode: "basic", view: "settings", title: "Settings", desc: "Appearance, workspace, and integrations." },
+
+  // Admin
+  { key: "admin/users", label: "Users", icon: "users", group: "admin", minMode: "admin", view: "admin-users", title: "Users", desc: "Workspace members and access.", admin: true },
+  { key: "admin/permissions", label: "Permissions", icon: "key", group: "admin", minMode: "admin", view: "admin-permissions", title: "Permissions", desc: "Roles and capability mapping.", admin: true },
+  { key: "admin/audit", label: "Audit Logs", icon: "report-search", group: "admin", minMode: "admin", view: "admin-audit", title: "Audit Logs", desc: "Activity and access trail.", admin: true },
+  { key: "admin/security", label: "Security", icon: "shield-check", group: "admin", minMode: "admin", view: "admin-security", title: "Security", desc: "Sensitive-data signals and DLP.", admin: true },
+  { key: "admin/policies", label: "Policies", icon: "file-certificate", group: "admin", minMode: "admin", view: "admin-policies", title: "Policies", desc: "Governance and enforcement.", admin: true },
+  { key: "admin/private-vpc", label: "Private VPC", icon: "cloud-lock", group: "admin", minMode: "admin", view: "admin-private-vpc", title: "Private VPC", desc: "Network isolation and peering.", admin: true },
+];
+
+export const ROUTE_BY_KEY = Object.fromEntries(ROUTES.map((r) => [r.key, r]));
+
+/** Routes visible in the rail for a given mode. */
+export function visibleRoutes(mode) {
+  const rank = MODE_RANK[mode] ?? 0;
+  return ROUTES.filter((r) => {
+    if (r.admin) return mode === "admin";
+    return (MODE_RANK[r.minMode] ?? 0) <= rank;
+  });
+}
+
+/** Lazy-load a view module by basename. Cached. */
+const cache = new Map();
+function assetUrl(key, fallback) {
+  const manifest = window.__LT_ASSET_MANIFEST__;
+  return (manifest && manifest.assets && manifest.assets[key]) || fallback;
+}
+
+export async function loadView(view) {
+  if (cache.has(view)) return cache.get(view);
+  const mod = await import(assetUrl(`static/v3/js/views/${view}.js`, `../views/${view}.js`));
+  cache.set(view, mod);
+  return mod;
+}

package/static/v3/js/core/routes.js

@@ -0,0 +1,78 @@
+/* ============================================================================
+ * Lattice AI v3 — Information architecture (single source of truth)
+ *
+ * One declarative table drives the nav rail, the command palette, the router,
+ * breadcrumbs, and lazy view loading. Mode gating (Basic < Advanced < Admin)
+ * and the Admin section live here so the whole shell stays consistent.
+ * ========================================================================== */
+
+export const MODE_RANK = { basic: 0, advanced: 1, admin: 2 };
+
+/** Nav groups in display order. */
+export const GROUPS = [
+  { id: "workspace", label: "Workspace" },
+  { id: "retrieval", label: "Retrieval" },
+  { id: "data", label: "Data" },
+  { id: "compute", label: "Compute" },
+  { id: "system", label: "System" },
+  { id: "admin", label: "Administration", adminOnly: true },
+];
+
+/**
+ * Route table. `minMode` = lowest mode in which the item appears in the rail
+ * (deep-links still resolve). `view` = module basename under js/views/.
+ */
+export const ROUTES = [
+  // Workspace
+  { key: "home", label: "Home", icon: "layout-dashboard", group: "workspace", minMode: "basic", view: "home", title: "Home", desc: "Your local-first AI workspace at a glance." },
+  { key: "chat", label: "Chat", icon: "message-2", group: "workspace", minMode: "basic", view: "chat", title: "Chat", desc: "Grounded conversation over your indexed workspace." },
+
+  // Retrieval (the product identity)
+  { key: "knowledge-graph", label: "Knowledge Graph", icon: "chart-dots-3", group: "retrieval", minMode: "basic", view: "knowledge-graph", title: "Knowledge Graph", desc: "Entities and relations extracted from your workspace." },
+  { key: "hybrid-search", label: "Hybrid Search", icon: "arrows-join", group: "retrieval", minMode: "basic", view: "hybrid-search", title: "Hybrid Search", desc: "Graph structure fused with vector similarity." },
+
+  // Data
+  { key: "files", label: "Files", icon: "folders", group: "data", minMode: "basic", view: "files", title: "Files", desc: "Connected sources and indexed documents." },
+  { key: "pipeline", label: "Pipeline", icon: "git-branch", group: "data", minMode: "advanced", view: "pipeline", title: "Pipeline", desc: "Ingest, embed, and graph-build flows." },
+
+  // Compute
+  { key: "agents", label: "Agents", icon: "robot", group: "compute", minMode: "advanced", view: "agents", title: "Agents", desc: "Multi-agent roles, runs, and handoffs." },
+  { key: "models", label: "Models", icon: "cpu", group: "compute", minMode: "basic", view: "models", title: "Models", desc: "Local MLX models and embeddings." },
+  { key: "my-computer", label: "My Computer", icon: "device-desktop-analytics", group: "compute", minMode: "advanced", view: "my-computer", title: "My Computer", desc: "Local hardware, memory, and runtime." },
+
+  // System
+  { key: "settings", label: "Settings", icon: "settings", group: "system", minMode: "basic", view: "settings", title: "Settings", desc: "Appearance, workspace, and integrations." },
+
+  // Admin
+  { key: "admin/users", label: "Users", icon: "users", group: "admin", minMode: "admin", view: "admin-users", title: "Users", desc: "Workspace members and access.", admin: true },
+  { key: "admin/permissions", label: "Permissions", icon: "key", group: "admin", minMode: "admin", view: "admin-permissions", title: "Permissions", desc: "Roles and capability mapping.", admin: true },
+  { key: "admin/audit", label: "Audit Logs", icon: "report-search", group: "admin", minMode: "admin", view: "admin-audit", title: "Audit Logs", desc: "Activity and access trail.", admin: true },
+  { key: "admin/security", label: "Security", icon: "shield-check", group: "admin", minMode: "admin", view: "admin-security", title: "Security", desc: "Sensitive-data signals and DLP.", admin: true },
+  { key: "admin/policies", label: "Policies", icon: "file-certificate", group: "admin", minMode: "admin", view: "admin-policies", title: "Policies", desc: "Governance and enforcement.", admin: true },
+  { key: "admin/private-vpc", label: "Private VPC", icon: "cloud-lock", group: "admin", minMode: "admin", view: "admin-private-vpc", title: "Private VPC", desc: "Network isolation and peering.", admin: true },
+];
+
+export const ROUTE_BY_KEY = Object.fromEntries(ROUTES.map((r) => [r.key, r]));
+
+/** Routes visible in the rail for a given mode. */
+export function visibleRoutes(mode) {
+  const rank = MODE_RANK[mode] ?? 0;
+  return ROUTES.filter((r) => {
+    if (r.admin) return mode === "admin";
+    return (MODE_RANK[r.minMode] ?? 0) <= rank;
+  });
+}
+
+/** Lazy-load a view module by basename. Cached. */
+const cache = new Map();
+function assetUrl(key, fallback) {
+  const manifest = window.__LT_ASSET_MANIFEST__;
+  return (manifest && manifest.assets && manifest.assets[key]) || fallback;
+}
+
+export async function loadView(view) {
+  if (cache.has(view)) return cache.get(view);
+  const mod = await import(assetUrl(`static/v3/js/views/${view}.js`, `../views/${view}.js`));
+  cache.set(view, mod);
+  return mod;
+}

package/static/v3/js/core/shell.1b6199d6.js

@@ -0,0 +1,363 @@
+/* ============================================================================
+ * Lattice AI v3 — Application shell
+ * Builds the persistent chrome (nav rail, topbar, view outlet), wires the
+ * router, workspace + mode + theme switchers, command palette, and mobile
+ * drawer. Renders views by lazy-loading their module and calling render(ctx).
+ * ========================================================================== */
+
+import { h, icon, $, $$ } from "./dom.a2773eb0.js";
+import { store } from "./store.34ebd5e6.js";
+import { api } from "./api.22a41d42.js";
+import * as c from "./components.4c83e0a9.js";
+import { createRouter } from "./router.584570f2.js";
+import { GROUPS, ROUTES, ROUTE_BY_KEY, MODE_RANK, visibleRoutes, loadView } from "./routes.f935dd50.js";
+
+const MODES = [
+  { key: "basic", label: "Basic", icon: "circle" },
+  { key: "advanced", label: "Advanced", icon: "circles" },
+  { key: "admin", label: "Admin", icon: "shield-half" },
+];
+
+const ctxBase = { h, icon, api, store, c };
+
+let els = {};
+let router;
+let currentRoute = null;
+
+export function boot(rootEl) {
+  rootEl.classList.add("lt3-app");
+  rootEl.append(
+    h("a.lt3-skip", { href: "#lt3-view" }, "Skip to content"),
+    h("div.lt3-rail__scrim", { on: { click: closeDrawer } }),
+    buildRail(),
+    buildMain(),
+  );
+
+  cacheEls(rootEl);
+  store.subscribe(onStateChange);
+
+  router = createRouter({ onRoute: renderRoute, fallback: "home" });
+  wireGlobalKeys();
+  router.start();
+
+  // Background: hydrate workspaces, identity, index status.
+  hydrate();
+}
+
+/* ── Rail ────────────────────────────────────────────────────────────────── */
+function buildRail() {
+  return h("aside.lt3-rail", { id: "lt3-rail", "aria-label": "Primary" },
+    h("div.lt3-rail__brand",
+      h("div.lt3-rail__logo", { html: latticeMark() }),
+      h("div.lt3-rail__word", h("b", "Lattice AI"), h("small", "Local-First Workspace")),
+      h("button.lt3-iconbtn.lt3-iconbtn--sm.lt3-rail__close", { "aria-label": "Close menu", on: { click: closeDrawer } }, icon("x")),
+    ),
+    h("div.lt3-rail__scope", { id: "lt3-scope" }),
+    h("nav.lt3-rail__nav", { id: "lt3-nav", "aria-label": "Sections" }),
+    h("div.lt3-rail__foot",
+      h("button.lt3-rail__user", { id: "lt3-user", "aria-label": "Account", on: { click: () => router.navigate("settings") } }),
+      h("button.lt3-iconbtn", { id: "lt3-theme", "aria-label": "Toggle theme", title: "Toggle theme", on: { click: () => store.toggleTheme() } }, icon("moon")),
+    ),
+  );
+}
+
+function renderNav() {
+  const nav = els.nav;
+  const mode = store.get().mode;
+  const routes = visibleRoutes(mode);
+  nav.replaceChildren();
+  for (const group of GROUPS) {
+    const items = routes.filter((r) => r.group === group.id);
+    if (!items.length) continue;
+    const groupEl = h("div.lt3-navgroup",
+      h("div.lt3-navgroup__label", group.label),
+      items.map((r) => navItem(r)),
+    );
+    nav.append(groupEl);
+  }
+  markActive();
+}
+
+function navItem(route) {
+  return h("a.lt3-navitem", {
+    href: "#/" + route.key,
+    dataset: { key: route.key },
+    on: { click: () => closeDrawer() },
+  },
+    icon(route.icon),
+    h("span.lt3-navitem__label", route.label),
+    route.key === "hybrid-search" ? h("span.lt3-navitem__dot", { style: { background: "var(--lt3-pillar-hybrid)" } }) : null,
+  );
+}
+
+function markActive() {
+  $$(".lt3-navitem", els.nav).forEach((a) => {
+    const on = a.dataset.key === (currentRoute && currentRoute.key);
+    if (on) a.setAttribute("aria-current", "page"); else a.removeAttribute("aria-current");
+  });
+}
+
+function renderScope() {
+  const ws = store.activeWorkspace();
+  els.scope.replaceChildren(
+    h("button.lt3-scope", { "aria-haspopup": "listbox", on: { click: openScopeMenu } },
+      h("div.lt3-scope__icon", icon(ws.type === "organization" ? "building-community" : "user")),
+      h("div.lt3-scope__meta", h("b", ws.name), h("small", `${ws.type} · ${ws.your_role || "member"}`)),
+      icon("selector"),
+    ),
+  );
+}
+
+function renderUser() {
+  const u = store.get().user;
+  const initials = (u.nickname || u.email || "U").slice(0, 2);
+  els.user.replaceChildren(
+    h("span.lt3-avatar", initials),
+    h("div.lt3-rail__user-meta", h("b", u.nickname || u.email || "You"), h("small", u.role || "local")),
+  );
+}
+
+function updateThemeIcon() {
+  const dark = document.documentElement.getAttribute("data-lt-theme") === "dark"
+    || (!store.get().theme && window.matchMedia && window.matchMedia("(prefers-color-scheme: dark)").matches);
+  els.theme.replaceChildren(icon(dark ? "sun" : "moon"));
+}
+
+/* ── Main / topbar ──────────────────────────────────────────────────────── */
+function buildMain() {
+  return h("div.lt3-main",
+    h("header.lt3-topbar",
+      h("button.lt3-iconbtn.lt3-topbar__menu", { "aria-label": "Open menu", on: { click: openDrawer } }, icon("menu-2")),
+      h("div.lt3-topbar__crumbs", { id: "lt3-crumbs" }),
+      h("div.lt3-spacer"),
+      h("button.lt3-cmd-trigger", { "aria-label": "Search and commands", on: { click: openPalette } },
+        icon("search"), h("span", "Search & commands"), h("span.lt3-kbd", "⌘K")),
+      h("div", { id: "lt3-idxchip" }),
+      h("div.lt3-mode", { id: "lt3-mode", role: "tablist", "aria-label": "Workspace mode" },
+        MODES.map((m) => h("button", {
+          type: "button", role: "tab", dataset: { mode: m.key },
+          on: { click: () => store.setMode(m.key) },
+        }, icon(m.icon), h("span", m.label))),
+      ),
+    ),
+    h("main.lt3-view", { id: "lt3-view", tabindex: "-1" },
+      h("div.lt3-view__inner", { id: "lt3-outlet" }),
+    ),
+  );
+}
+
+function renderMode() {
+  $$("#lt3-mode button", els.root).forEach((b) => b.dataset.active = String(b.dataset.mode === store.get().mode));
+}
+
+function renderCrumbs() {
+  const r = currentRoute;
+  if (!r) return;
+  const parts = [h("span.lt3-crumb", store.activeWorkspace().name)];
+  if (r.group === "admin") parts.push(icon("chevron-right"), h("span.lt3-crumb", "Admin"));
+  parts.push(icon("chevron-right"), h("span.lt3-crumb.lt3-crumb--current", r.title || r.label));
+  els.crumbs.replaceChildren(...parts);
+}
+
+function renderIndexChip() {
+  els.idxchip.replaceChildren(c.indexChip(store.get().indexStatus));
+}
+
+/* ── View rendering ─────────────────────────────────────────────────────── */
+async function renderRoute({ key, params }) {
+  let route = ROUTE_BY_KEY[key] || ROUTE_BY_KEY.home;
+  // Deep-linking into an admin area surfaces Admin mode so the rail matches.
+  if (route.admin && store.get().mode !== "admin") store.setMode("admin");
+  currentRoute = route;
+  store.setRoute({ key: route.key, params });
+
+  document.title = `${route.title || route.label} · Lattice AI`;
+  markActive();
+  renderCrumbs();
+
+  const outlet = els.outlet;
+  outlet.replaceChildren(c.loading({ lines: 4, block: true }));
+  els.view.scrollTop = 0;
+
+  try {
+    const mod = await loadView(route.view);
+    if (currentRoute !== route) return; // navigated away during load
+    els.view.classList.toggle("lt3-view--flush", mod.layout === "flush");
+    const ctx = { ...ctxBase, route, params, navigate: router.navigate, toast: c.toast };
+    const node = await mod.render(ctx);
+    if (currentRoute !== route) return;
+    outlet.replaceChildren(node);
+  } catch (err) {
+    console.error("[shell] view render failed:", route.view, err);
+    outlet.replaceChildren(c.errorState(`View "${route.label}" failed to load.`, () => renderRoute({ key: route.key, params })));
+  }
+}
+
+function renderCurrent() {
+  if (currentRoute) renderRoute({ key: currentRoute.key, params: store.get().route.params || {} });
+}
+
+/* ── State reactions ────────────────────────────────────────────────────── */
+function onStateChange(_state, change) {
+  switch (change.type) {
+    case "mode": renderNav(); renderMode(); renderCurrent(); break;
+    case "workspace": renderScope(); renderCrumbs(); renderCurrent(); break;
+    case "workspaces": renderScope(); break;
+    case "user": renderUser(); break;
+    case "theme": updateThemeIcon(); break;
+    case "index": renderIndexChip(); break;
+  }
+}
+
+/* ── Workspace scope menu ───────────────────────────────────────────────── */
+function openScopeMenu(ev) {
+  ev.stopPropagation();
+  closeMenus();
+  const rect = ev.currentTarget.getBoundingClientRect();
+  const list = store.get().workspaces;
+  const menu = h("div.lt3-menu", { id: "lt3-scope-menu", role: "listbox", style: { top: rect.bottom + 6 + "px", left: rect.left + "px" } },
+    list.map((w) => h("button.lt3-menu__item", {
+      role: "option", dataset: { active: String(w.workspace_id === store.get().workspaceId) },
+      on: { click: () => { store.setWorkspace(w.workspace_id); closeMenus(); } },
+    },
+      icon(w.type === "organization" ? "building-community" : "user"),
+      h("div", h("div", { style: { fontWeight: 600 } }, w.name), h("small.lt3-faint", { style: { textTransform: "capitalize" } }, w.type)),
+      w.workspace_id === store.get().workspaceId ? icon("check", "") : null,
+    )),
+    h("div.lt3-menu__sep"),
+    h("button.lt3-menu__item", { on: { click: () => { c.toast("Organization creation opens in Settings", "info"); closeMenus(); router.navigate("settings"); } } },
+      icon("plus"), "New organization"),
+  );
+  document.body.append(menu);
+  setTimeout(() => document.addEventListener("click", closeMenusOnce, { once: true }), 0);
+}
+function closeMenus() { $$(".lt3-menu").forEach((m) => m.remove()); }
+function closeMenusOnce() { closeMenus(); }
+
+/* ── Mobile drawer ──────────────────────────────────────────────────────── */
+function openDrawer() { els.root.dataset.drawer = "open"; }
+function closeDrawer() { delete els.root.dataset.drawer; }
+
+/* ── Command palette ────────────────────────────────────────────────────── */
+function paletteItems() {
+  const nav = ROUTES.map((r) => ({
+    group: "Go to", label: r.label, icon: r.icon, hint: r.group,
+    run: () => router.navigate(r.key),
+  }));
+  const actions = [
+    { group: "Actions", label: "Toggle light / dark theme", icon: "contrast", run: () => store.toggleTheme() },
+    { group: "Actions", label: "Mode: Basic", icon: "circle", run: () => store.setMode("basic") },
+    { group: "Actions", label: "Mode: Advanced", icon: "circles", run: () => store.setMode("advanced") },
+    { group: "Actions", label: "Mode: Admin", icon: "shield-half", run: () => store.setMode("admin") },
+    { group: "Actions", label: "New chat", icon: "message-plus", run: () => router.navigate("chat", { new: "1" }) },
+    { group: "Actions", label: "Run hybrid search", icon: "arrows-join", run: () => router.navigate("hybrid-search") },
+  ];
+  return [...nav, ...actions];
+}
+
+function openPalette() {
+  if ($("#lt3-palette")) return;
+  const all = paletteItems();
+  let active = 0, filtered = all;
+
+  const listEl = h("div.lt3-palette__list");
+  const input = h("input", { type: "text", placeholder: "Search views, run a command…", "aria-label": "Command palette", autocomplete: "off" });
+  const palette = h("div.lt3-palette", { id: "lt3-palette", role: "dialog", "aria-modal": "true", "aria-label": "Command palette" },
+    h("div.lt3-palette__input", icon("search"), input, h("span.lt3-kbd", "Esc")),
+    listEl,
+  );
+  const scrim = h("div.lt3-scrim", { id: "lt3-palette-scrim", on: { click: close } });
+  document.body.append(scrim, palette);
+  input.focus();
+
+  function renderList() {
+    listEl.replaceChildren();
+    if (!filtered.length) { listEl.append(h("div.lt3-palette__empty", "No matches")); return; }
+    let lastGroup = null;
+    filtered.forEach((item, i) => {
+      if (item.group !== lastGroup) { listEl.append(h("div.lt3-palette__group-label", item.group)); lastGroup = item.group; }
+      listEl.append(h("button.lt3-palette__item", {
+        dataset: { active: String(i === active) },
+        on: { click: () => { item.run(); close(); }, mousemove: () => { if (active !== i) { active = i; paint(); } } },
+      }, icon(item.icon), h("span", item.label), item.hint && h("small", item.hint)));
+    });
+  }
+  function paint() { $$(".lt3-palette__item", listEl).forEach((el, i) => el.dataset.active = String(i === active)); ensureVisible(); }
+  function ensureVisible() {
+    const el = $$(".lt3-palette__item", listEl)[active];
+    if (el) el.scrollIntoView({ block: "nearest" });
+  }
+  function filter() {
+    const q = input.value.trim().toLowerCase();
+    filtered = !q ? all : all.filter((it) => (it.label + " " + (it.hint || "")).toLowerCase().includes(q));
+    active = 0; renderList();
+  }
+  function close() { palette.remove(); scrim.remove(); document.removeEventListener("keydown", onKey, true); }
+  function onKey(e) {
+    if (e.key === "Escape") { e.preventDefault(); e.stopPropagation(); close(); }
+    else if (e.key === "ArrowDown") { e.preventDefault(); active = Math.min(filtered.length - 1, active + 1); paint(); }
+    else if (e.key === "ArrowUp") { e.preventDefault(); active = Math.max(0, active - 1); paint(); }
+    else if (e.key === "Enter") { e.preventDefault(); const it = filtered[active]; if (it) { it.run(); close(); } }
+  }
+  input.addEventListener("input", filter);
+  document.addEventListener("keydown", onKey, true);
+  renderList();
+}
+
+function wireGlobalKeys() {
+  document.addEventListener("keydown", (e) => {
+    if ((e.metaKey || e.ctrlKey) && (e.key === "k" || e.key === "K")) { e.preventDefault(); openPalette(); }
+    if (e.key === "Escape") { closeMenus(); closeDrawer(); }
+  });
+}
+
+/* ── Hydration ──────────────────────────────────────────────────────────── */
+async function hydrate() {
+  // Identity (best-effort; never blocks the UI).
+  api.raw("/account/profile").then((r) => {
+    if (r.ok && r.data && (r.data.email || r.data.nickname)) {
+      store.setUser({ email: r.data.email, nickname: r.data.nickname || r.data.email, role: r.data.role || "user" });
+    } else { renderUser(); }
+  });
+
+  // Workspaces from the OS payload (fallback-safe).
+  api.workspaceOs().then((r) => {
+    const reg = r.data && r.data.workspace_registry;
+    if (reg && Array.isArray(reg.workspaces) && reg.workspaces.length) store.setWorkspaces(reg.workspaces);
+  });
+
+  // Index status powers the topbar chip + Home pillars.
+  api.indexStatus().then((r) => store.setIndexStatus(r.data));
+}
+
+/* ── Init helpers ───────────────────────────────────────────────────────── */
+function cacheEls(root) {
+  els = {
+    root,
+    nav: $("#lt3-nav", root),
+    scope: $("#lt3-scope", root),
+    user: $("#lt3-user", root),
+    theme: $("#lt3-theme", root),
+    crumbs: $("#lt3-crumbs", root),
+    idxchip: $("#lt3-idxchip", root),
+    outlet: $("#lt3-outlet", root),
+    view: $("#lt3-view", root),
+  };
+  renderNav();
+  renderScope();
+  renderUser();
+  renderMode();
+  updateThemeIcon();
+  renderIndexChip();
+}
+
+function latticeMark() {
+  // Crystalline lattice glyph — the product mark.
+  return `<svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
+    <path d="M12 2.5 4 7v10l8 4.5L20 17V7L12 2.5Z" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round" opacity=".55"/>
+    <path d="M12 7.5 7.5 10v4L12 16.5 16.5 14v-4L12 7.5Z" fill="currentColor" opacity=".9"/>
+    <circle cx="12" cy="2.5" r="1.3" fill="currentColor"/><circle cx="4" cy="7" r="1.1" fill="currentColor"/>
+    <circle cx="20" cy="7" r="1.1" fill="currentColor"/><circle cx="4" cy="17" r="1.1" fill="currentColor"/>
+    <circle cx="20" cy="17" r="1.1" fill="currentColor"/><circle cx="12" cy="21.5" r="1.3" fill="currentColor"/>
+  </svg>`;
+}