ltcai 3.3.0 → 3.4.0

package/static/v3/js/core/api.js

@@ -440,6 +440,73 @@ export const api = {
   mcpClaudeServers() { return withFallback("/mcp/claude-code-servers", {}, { servers: [] }); },
   mcpCustom() { return withFallback("/mcp/custom", {}, { custom: [] }); },
   mcpRecommend(query, limit = 6) { return raw("/mcp/recommend", { method: "POST", body: { query, limit } }); },
+
+  /* ── v3.4 Platform Completion ───────────────────────────────────────────
+   * Uploaded documents in Files, Connect Folder + Folder Watch over the real
+   * on-device runtime, the Local Agent status, and Hooks dispatch/run-log.
+   * All endpoints are real (latticeai/api + knowledge_graph_api); fallback-safe. */
+
+  /** GET /knowledge-graph/documents — uploaded + indexed docs with index state. */
+  async documents(limit = 200) {
+    const res = await raw(`/knowledge-graph/documents?limit=${encodeURIComponent(limit)}`);
+    if (res.ok && res.data && Array.isArray(res.data.documents)) {
+      return { ok: true, status: res.status, data: res.data.documents, source: "live", total: res.data.total };
+    }
+    return { ok: false, status: res.status, data: [], source: "unavailable", error: res.error };
+  },
+
+  // Local Agent (the on-device Lattice runtime: real GET /api/local-agent/status)
+  async localAgent() {
+    const res = await raw("/api/local-agent/status");
+    if (res.ok && res.data && res.data.agent) {
+      return { ok: true, status: res.status, data: res.data, source: "live" };
+    }
+    return {
+      ok: false, status: res.status, source: "unavailable",
+      data: { agent: { online: false }, health: {}, folders: { connected: 0, watching: 0 }, watch: { available: false, active: {} }, sources: [] },
+    };
+  },
+
+  // Connect Folder + Folder Watch (real backend: /knowledge-graph/local/*)
+  localRoots() { return withFallback("/knowledge-graph/local/roots", {}, { roots: [] }); },
+  async localSources() {
+    const res = await raw("/knowledge-graph/local/sources");
+    if (res.ok && res.data && Array.isArray(res.data.sources)) {
+      return { ok: true, status: res.status, data: res.data, source: "live" };
+    }
+    return { ok: false, status: res.status, data: { sources: [], watch: { available: false, active: {} } }, source: "unavailable" };
+  },
+  localWatchStatus() { return raw("/knowledge-graph/local/watch/status"); },
+  localWatchStop(source_id) { return raw("/knowledge-graph/local/watch/stop", { method: "POST", body: { source_id } }); },
+  approvePermission(token) { return raw(`/permissions/approve/${encodeURIComponent(token)}`, { method: "POST" }); },
+  indexFolder(path, opts = {}) {
+    return raw("/knowledge-graph/local/index", { method: "POST", body: { path, ...opts } });
+  },
+  /** One-call Connect Folder: request → self-approve (the click is the consent)
+   *  → index (+ optional watch). Returns { ok, data, error }. */
+  async connectFolder(path, { watch = true, includeOcr = false } = {}) {
+    const probe = await raw("/knowledge-graph/local/index", { method: "POST", body: { path, approved: false } });
+    const token = probe.data && probe.data.approval_token;
+    if (!token) {
+      const detail = (probe.data && (probe.data.detail || probe.data.error)) || "the runtime did not return an approval token";
+      return { ok: false, error: detail, status: probe.status };
+    }
+    const approved = await raw(`/permissions/approve/${encodeURIComponent(token)}`, { method: "POST" });
+    if (!approved.ok) {
+      const detail = (approved.data && (approved.data.detail || approved.data.error)) || "approval failed";
+      return { ok: false, error: detail, status: approved.status };
+    }
+    const res = await raw("/knowledge-graph/local/index", {
+      method: "POST",
+      body: { path, approved: true, approval_token: token, watch_enabled: watch, include_ocr: includeOcr, consent: { approved: true, source: "files-ui" } },
+    });
+    if (res.ok && res.data && !res.data.detail) return { ok: true, data: res.data, status: res.status };
+    return { ok: false, error: (res.data && (res.data.detail || res.data.error)) || "indexing failed", status: res.status, data: res.data };
+  },
+
+  // Hooks dispatch (real backend: POST /api/hooks/run + GET /api/hooks/runs)
+  hookRun(body) { return raw("/api/hooks/run", { method: "POST", body }); },
+  hookRuns(limit = 50, kind) { return withFallback(`/api/hooks/runs?limit=${encodeURIComponent(limit)}${kind ? "&kind=" + encodeURIComponent(kind) : ""}`, {}, { runs: [], total: 0 }); },
 };
 
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/static/v3/js/core/{components.4c83e0a9.js → components.35f02e4c.js}

@@ -70,6 +70,14 @@ const STATE_VARIANT = {
   ready: "ok", active: "ok", indexed: "ok", loaded: "ok", ok: "ok", available: "info",
   idle: "", standby: "", pending: "warn", indexing: "warn", building: "warn",
   failed: "err", error: "err", disabled: "err", not_configured: "",
+  // v3.4.0 platform-completion states (Files / Folder Watch / Local Agent /
+  // Agent runs / Hook dispatch). Keep these honest: amber for in-progress,
+  // green for healthy/active, red for blocked/failed, neutral for inert.
+  ingested: "warn", ingesting: "warn", watching: "ok", watched: "ok",
+  connected: "ok", online: "ok", offline: "err", synced: "ok",
+  queued: "warn", running: "warn", retrying: "warn", retried_ok: "ok",
+  rejected: "err", cancelled: "", stopped: "", blocked: "err",
+  advisory: "warn", skipped: "", complete: "ok", partial: "warn",
 };
 export function statePill(state) {
   return pill(String(state || "unknown"), STATE_VARIANT[String(state).toLowerCase()] ?? "", { dot: true });

package/static/v3/js/core/components.js

@@ -70,6 +70,14 @@ const STATE_VARIANT = {
   ready: "ok", active: "ok", indexed: "ok", loaded: "ok", ok: "ok", available: "info",
   idle: "", standby: "", pending: "warn", indexing: "warn", building: "warn",
   failed: "err", error: "err", disabled: "err", not_configured: "",
+  // v3.4.0 platform-completion states (Files / Folder Watch / Local Agent /
+  // Agent runs / Hook dispatch). Keep these honest: amber for in-progress,
+  // green for healthy/active, red for blocked/failed, neutral for inert.
+  ingested: "warn", ingesting: "warn", watching: "ok", watched: "ok",
+  connected: "ok", online: "ok", offline: "err", synced: "ok",
+  queued: "warn", running: "warn", retrying: "warn", retried_ok: "ok",
+  rejected: "err", cancelled: "", stopped: "", blocked: "err",
+  advisory: "warn", skipped: "", complete: "ok", partial: "warn",
 };
 export function statePill(state) {
   return pill(String(state || "unknown"), STATE_VARIANT[String(state).toLowerCase()] ?? "", { dot: true });

package/static/v3/js/core/{routes.07ad6696.js → routes.d214b399.js}

@@ -11,8 +11,8 @@ 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: "retrieval", label: "Retrieval" },
   { id: "compute", label: "Compute" },
   { id: "platform", label: "Platform" },
   { id: "system", label: "System" },
@@ -28,32 +28,35 @@ export const ROUTES = [
   { 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." },
-  { key: "memory", label: "Memory", icon: "brain", group: "retrieval", minMode: "basic", view: "memory", title: "Memory", desc: "Long-term workspace, project, agent, and conversation memory." },
-
   // 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." },
+
+  // Retrieval (the product identity)
+  { key: "hybrid-search", label: "Search", icon: "arrows-join", group: "retrieval", minMode: "basic", view: "hybrid-search", title: "Hybrid Search", desc: "Graph structure fused with vector similarity." },
+  { key: "knowledge-graph", label: "Knowledge", icon: "chart-dots-3", group: "retrieval", minMode: "basic", view: "knowledge-graph", title: "Knowledge Graph", desc: "Entities and relations extracted from your workspace." },
+  { key: "memory", label: "Memory", icon: "brain", group: "retrieval", minMode: "basic", view: "memory", title: "Memory", desc: "Long-term workspace, project, agent, and conversation memory." },
 
   // Compute
+  { key: "models", label: "Models", icon: "cpu", group: "compute", minMode: "basic", view: "models", title: "Models", desc: "Local MLX models and embeddings." },
   { key: "agents", label: "Agents", icon: "robot", group: "compute", minMode: "advanced", view: "agents", title: "Agents", desc: "Multi-agent roles, runs, and handoffs." },
   { key: "workflows", label: "Workflows", icon: "sitemap", group: "compute", minMode: "advanced", view: "workflows", title: "Workflow Agents", desc: "Trigger → agent chain → tools → memory → result." },
-  { key: "planning", label: "Planning", icon: "target-arrow", group: "compute", minMode: "advanced", view: "planning", title: "Autonomous Planning", desc: "Goal → plan → execute → review → replan." },
-  { 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." },
 
   // Platform (the agent ecosystem)
-  { key: "marketplace", label: "Marketplace", icon: "building-store", group: "platform", minMode: "advanced", view: "marketplace", title: "Marketplace", desc: "Agent templates, agents, plugins, and skills." },
   { key: "skills", label: "Skills", icon: "puzzle", group: "platform", minMode: "advanced", view: "skills", title: "Skills", desc: "Install, enable, and manage skills." },
   { key: "hooks", label: "Hooks", icon: "webhook", group: "platform", minMode: "advanced", view: "hooks", title: "Hooks", desc: "Lifecycle hooks across runs, tools, and workflows." },
-  { key: "tools", label: "Tools", icon: "tools", group: "platform", minMode: "advanced", view: "tools", title: "Tool Registry", desc: "Local, workspace, and MCP tools with governance." },
   { key: "mcp", label: "MCP", icon: "plug-connected", group: "platform", minMode: "advanced", view: "mcp", title: "MCP Manager", desc: "Connected MCP servers, available tools, and health." },
 
   // System
   { key: "settings", label: "Settings", icon: "settings", group: "system", minMode: "basic", view: "settings", title: "Settings", desc: "Appearance, workspace, and integrations." },
 
+  // Deep-linkable legacy/experimental surfaces. They remain renderable for
+  // compatibility, but are not promoted in the production navigation.
+  { key: "pipeline", label: "Pipeline", icon: "git-branch", group: "data", minMode: "advanced", view: "pipeline", title: "Pipeline", desc: "Ingest, embed, and graph-build flows.", hidden: true },
+  { key: "planning", label: "Planning", icon: "target-arrow", group: "compute", minMode: "advanced", view: "planning", title: "Autonomous Planning", desc: "Goal → plan → execute → review → replan.", hidden: true },
+  { 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.", hidden: true },
+  { key: "marketplace", label: "Marketplace", icon: "building-store", group: "platform", minMode: "advanced", view: "marketplace", title: "Marketplace", desc: "Agent templates, agents, plugins, and skills.", hidden: true },
+  { key: "tools", label: "Tools", icon: "tools", group: "platform", minMode: "advanced", view: "tools", title: "Tool Registry", desc: "Local, workspace, and MCP tools with governance.", hidden: true },
+
   // 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 },
@@ -69,6 +72,7 @@ export const ROUTE_BY_KEY = Object.fromEntries(ROUTES.map((r) => [r.key, r]));
 export function visibleRoutes(mode) {
   const rank = MODE_RANK[mode] ?? 0;
   return ROUTES.filter((r) => {
+    if (r.hidden) return false;
     if (r.admin) return mode === "admin";
     return (MODE_RANK[r.minMode] ?? 0) <= rank;
   });

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

@@ -11,8 +11,8 @@ 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: "retrieval", label: "Retrieval" },
   { id: "compute", label: "Compute" },
   { id: "platform", label: "Platform" },
   { id: "system", label: "System" },
@@ -28,32 +28,35 @@ export const ROUTES = [
   { 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." },
-  { key: "memory", label: "Memory", icon: "brain", group: "retrieval", minMode: "basic", view: "memory", title: "Memory", desc: "Long-term workspace, project, agent, and conversation memory." },
-
   // 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." },
+
+  // Retrieval (the product identity)
+  { key: "hybrid-search", label: "Search", icon: "arrows-join", group: "retrieval", minMode: "basic", view: "hybrid-search", title: "Hybrid Search", desc: "Graph structure fused with vector similarity." },
+  { key: "knowledge-graph", label: "Knowledge", icon: "chart-dots-3", group: "retrieval", minMode: "basic", view: "knowledge-graph", title: "Knowledge Graph", desc: "Entities and relations extracted from your workspace." },
+  { key: "memory", label: "Memory", icon: "brain", group: "retrieval", minMode: "basic", view: "memory", title: "Memory", desc: "Long-term workspace, project, agent, and conversation memory." },
 
   // Compute
+  { key: "models", label: "Models", icon: "cpu", group: "compute", minMode: "basic", view: "models", title: "Models", desc: "Local MLX models and embeddings." },
   { key: "agents", label: "Agents", icon: "robot", group: "compute", minMode: "advanced", view: "agents", title: "Agents", desc: "Multi-agent roles, runs, and handoffs." },
   { key: "workflows", label: "Workflows", icon: "sitemap", group: "compute", minMode: "advanced", view: "workflows", title: "Workflow Agents", desc: "Trigger → agent chain → tools → memory → result." },
-  { key: "planning", label: "Planning", icon: "target-arrow", group: "compute", minMode: "advanced", view: "planning", title: "Autonomous Planning", desc: "Goal → plan → execute → review → replan." },
-  { 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." },
 
   // Platform (the agent ecosystem)
-  { key: "marketplace", label: "Marketplace", icon: "building-store", group: "platform", minMode: "advanced", view: "marketplace", title: "Marketplace", desc: "Agent templates, agents, plugins, and skills." },
   { key: "skills", label: "Skills", icon: "puzzle", group: "platform", minMode: "advanced", view: "skills", title: "Skills", desc: "Install, enable, and manage skills." },
   { key: "hooks", label: "Hooks", icon: "webhook", group: "platform", minMode: "advanced", view: "hooks", title: "Hooks", desc: "Lifecycle hooks across runs, tools, and workflows." },
-  { key: "tools", label: "Tools", icon: "tools", group: "platform", minMode: "advanced", view: "tools", title: "Tool Registry", desc: "Local, workspace, and MCP tools with governance." },
   { key: "mcp", label: "MCP", icon: "plug-connected", group: "platform", minMode: "advanced", view: "mcp", title: "MCP Manager", desc: "Connected MCP servers, available tools, and health." },
 
   // System
   { key: "settings", label: "Settings", icon: "settings", group: "system", minMode: "basic", view: "settings", title: "Settings", desc: "Appearance, workspace, and integrations." },
 
+  // Deep-linkable legacy/experimental surfaces. They remain renderable for
+  // compatibility, but are not promoted in the production navigation.
+  { key: "pipeline", label: "Pipeline", icon: "git-branch", group: "data", minMode: "advanced", view: "pipeline", title: "Pipeline", desc: "Ingest, embed, and graph-build flows.", hidden: true },
+  { key: "planning", label: "Planning", icon: "target-arrow", group: "compute", minMode: "advanced", view: "planning", title: "Autonomous Planning", desc: "Goal → plan → execute → review → replan.", hidden: true },
+  { 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.", hidden: true },
+  { key: "marketplace", label: "Marketplace", icon: "building-store", group: "platform", minMode: "advanced", view: "marketplace", title: "Marketplace", desc: "Agent templates, agents, plugins, and skills.", hidden: true },
+  { key: "tools", label: "Tools", icon: "tools", group: "platform", minMode: "advanced", view: "tools", title: "Tool Registry", desc: "Local, workspace, and MCP tools with governance.", hidden: true },
+
   // 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 },
@@ -69,6 +72,7 @@ export const ROUTE_BY_KEY = Object.fromEntries(ROUTES.map((r) => [r.key, r]));
 export function visibleRoutes(mode) {
   const rank = MODE_RANK[mode] ?? 0;
   return ROUTES.filter((r) => {
+    if (r.hidden) return false;
     if (r.admin) return mode === "admin";
     return (MODE_RANK[r.minMode] ?? 0) <= rank;
   });

package/static/v3/js/core/{shell.9e707234.js → shell.80a6ad82.js}

@@ -7,10 +7,10 @@
 
 import { h, icon, $, $$ } from "./dom.a2773eb0.js";
 import { store } from "./store.34ebd5e6.js";
-import { api } from "./api.113660c5.js";
-import * as c from "./components.4c83e0a9.js";
+import { api } from "./api.12b568ad.js";
+import * as c from "./components.35f02e4c.js";
 import { createRouter } from "./router.584570f2.js";
-import { GROUPS, ROUTES, ROUTE_BY_KEY, MODE_RANK, visibleRoutes, loadView } from "./routes.07ad6696.js";
+import { GROUPS, ROUTES, ROUTE_BY_KEY, MODE_RANK, visibleRoutes, loadView } from "./routes.d214b399.js";
 
 const MODES = [
   { key: "basic", label: "Basic", icon: "circle" },
@@ -49,14 +49,17 @@ 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("div.lt3-rail__word", h("b", "Lattice AI"), h("small", "Private runtime")),
       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")),
+      h("div.lt3-rail__status", { id: "lt3-rail-status" }),
+      h("div.lt3-rail__foot-row",
+        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")),
+      ),
     ),
   );
 }
@@ -82,10 +85,14 @@ function navItem(route) {
   return h("a.lt3-navitem", {
     href: "#/" + route.key,
     dataset: { key: route.key },
+    title: route.title || route.label,
     on: { click: () => closeDrawer() },
   },
     icon(route.icon),
-    h("span.lt3-navitem__label", route.label),
+    h("span.lt3-navitem__copy",
+      h("span.lt3-navitem__label", route.label),
+      route.desc ? h("span.lt3-navitem__meta", route.desc) : null,
+    ),
     route.key === "hybrid-search" ? h("span.lt3-navitem__dot", { style: { background: "var(--lt3-pillar-hybrid)" } }) : null,
   );
 }
@@ -161,6 +168,23 @@ function renderCrumbs() {
 
 function renderIndexChip() {
   els.idxchip.replaceChildren(c.indexChip(store.get().indexStatus));
+  renderRailStatus();
+}
+
+function renderRailStatus() {
+  if (!els.railStatus) return;
+  const status = store.get().indexStatus;
+  const pipes = status?.pipelines || {};
+  const keys = ["knowledge_graph", "vector_index", "hybrid"];
+  const ready = keys.filter((key) => String(pipes[key]?.state || "").toLowerCase() === "ready").length;
+  const unavailable = !Object.keys(pipes).length;
+  els.railStatus.replaceChildren(
+    h("div.lt3-rail__status-top",
+      h("span.lt3-rail__status-dot", { dataset: { state: unavailable ? "pending" : ready === keys.length ? "ready" : "partial" } }),
+      h("span", unavailable ? "Local index pending" : `${ready}/${keys.length} retrieval signals ready`),
+    ),
+    h("div.lt3-rail__status-sub", unavailable ? "Start backend to sync live state" : "Graph · vector · hybrid"),
+  );
 }
 
 /* ── View rendering ─────────────────────────────────────────────────────── */
@@ -240,8 +264,10 @@ 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,
+  const mode = store.get().mode;
+  const currentRoutes = visibleRoutes(mode);
+  const nav = currentRoutes.map((r) => ({
+    group: "Go to", label: r.title || r.label, icon: r.icon, hint: r.label === r.title ? r.group : r.label,
     run: () => router.navigate(r.key),
   }));
   const actions = [
@@ -340,6 +366,7 @@ function cacheEls(root) {
     theme: $("#lt3-theme", root),
     crumbs: $("#lt3-crumbs", root),
     idxchip: $("#lt3-idxchip", root),
+    railStatus: $("#lt3-rail-status", root),
     outlet: $("#lt3-outlet", root),
     view: $("#lt3-view", root),
   };
@@ -349,6 +376,7 @@ function cacheEls(root) {
   renderMode();
   updateThemeIcon();
   renderIndexChip();
+  renderRailStatus();
 }
 
 function latticeMark() {

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

@@ -49,14 +49,17 @@ 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("div.lt3-rail__word", h("b", "Lattice AI"), h("small", "Private runtime")),
       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")),
+      h("div.lt3-rail__status", { id: "lt3-rail-status" }),
+      h("div.lt3-rail__foot-row",
+        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")),
+      ),
     ),
   );
 }
@@ -82,10 +85,14 @@ function navItem(route) {
   return h("a.lt3-navitem", {
     href: "#/" + route.key,
     dataset: { key: route.key },
+    title: route.title || route.label,
     on: { click: () => closeDrawer() },
   },
     icon(route.icon),
-    h("span.lt3-navitem__label", route.label),
+    h("span.lt3-navitem__copy",
+      h("span.lt3-navitem__label", route.label),
+      route.desc ? h("span.lt3-navitem__meta", route.desc) : null,
+    ),
     route.key === "hybrid-search" ? h("span.lt3-navitem__dot", { style: { background: "var(--lt3-pillar-hybrid)" } }) : null,
   );
 }
@@ -161,6 +168,23 @@ function renderCrumbs() {
 
 function renderIndexChip() {
   els.idxchip.replaceChildren(c.indexChip(store.get().indexStatus));
+  renderRailStatus();
+}
+
+function renderRailStatus() {
+  if (!els.railStatus) return;
+  const status = store.get().indexStatus;
+  const pipes = status?.pipelines || {};
+  const keys = ["knowledge_graph", "vector_index", "hybrid"];
+  const ready = keys.filter((key) => String(pipes[key]?.state || "").toLowerCase() === "ready").length;
+  const unavailable = !Object.keys(pipes).length;
+  els.railStatus.replaceChildren(
+    h("div.lt3-rail__status-top",
+      h("span.lt3-rail__status-dot", { dataset: { state: unavailable ? "pending" : ready === keys.length ? "ready" : "partial" } }),
+      h("span", unavailable ? "Local index pending" : `${ready}/${keys.length} retrieval signals ready`),
+    ),
+    h("div.lt3-rail__status-sub", unavailable ? "Start backend to sync live state" : "Graph · vector · hybrid"),
+  );
 }
 
 /* ── View rendering ─────────────────────────────────────────────────────── */
@@ -240,8 +264,10 @@ 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,
+  const mode = store.get().mode;
+  const currentRoutes = visibleRoutes(mode);
+  const nav = currentRoutes.map((r) => ({
+    group: "Go to", label: r.title || r.label, icon: r.icon, hint: r.label === r.title ? r.group : r.label,
     run: () => router.navigate(r.key),
   }));
   const actions = [
@@ -340,6 +366,7 @@ function cacheEls(root) {
     theme: $("#lt3-theme", root),
     crumbs: $("#lt3-crumbs", root),
     idxchip: $("#lt3-idxchip", root),
+    railStatus: $("#lt3-rail-status", root),
     outlet: $("#lt3-outlet", root),
     view: $("#lt3-view", root),
   };
@@ -349,6 +376,7 @@ function cacheEls(root) {
   renderMode();
   updateThemeIcon();
   renderIndexChip();
+  renderRailStatus();
 }
 
 function latticeMark() {