ltcai 3.2.0 → 3.3.0

package/README.md

@@ -290,7 +290,8 @@ Core areas:
 
 | Version | Theme |
 | --- | --- |
-| **3.2.0** | Feature-complete platform — multi-agent collaboration, agent registry, marketplace + templates, workflow agents, autonomous planning, long-term memory + manager, skills/hooks/tool registries, MCP manager, all operable from `/app` |
+| **3.3.0** | Product quality & honesty release — evidence-based feature audit (`FEATURE_STATUS.md`), single-source version truth, working manual document upload in Files, fixed document-generation streaming, truthful Home retrieval status, documented design system (`STYLE_SYSTEM.md`) |
+| 3.2.0 | Feature-complete platform — multi-agent collaboration, agent registry, marketplace + templates, workflow agents, autonomous planning, long-term memory + manager, skills/hooks/tool registries, MCP manager, all operable from `/app` |
 | 3.1.0 | Mainline platform completion — native `/app` workflows, Classic retired from normal paths, production embedding profiles, AgentRuntime/registries, hashed v3 assets |
 | 3.0.1 | Release-blocker remediation — provider-backed embeddings (Hash/MLX/Ollama/OpenAI/Custom), unified AgentRuntime boundary, every v3 surface connected or clearly unavailable |
 | 3.0.0 | v3 local-first AI workspace platform — `/app`, Native Chat, Knowledge Graph, Vector Index, Hybrid Search, workspace modes |

package/docs/architecture.md

@@ -1,6 +1,6 @@
 # Lattice AI Architecture
 
-> v3.2.0 — feature-complete for non-enterprise use cases. The agent ecosystem
+> v3.3.0 — feature-complete for non-enterprise use cases. The agent ecosystem
 > (registry, marketplace + templates, workflow agents, autonomous planning),
 > the long-term memory platform + manager, and the skills/hooks/tool/MCP
 > registries are all operable from `/app`. Enterprise controls remain future

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "3.2.0"
+__version__ = "3.3.0"

package/latticeai/core/marketplace.py

@@ -11,7 +11,7 @@ from copy import deepcopy
 from typing import Any, Dict, List, Optional
 
 
-MARKETPLACE_VERSION = "3.2.0"
+MARKETPLACE_VERSION = "3.3.0"
 TEMPLATE_KINDS = ("plugin", "workflow", "agent")
 
 

package/latticeai/core/multi_agent.py

@@ -14,7 +14,7 @@ from datetime import datetime
 from typing import Any, Callable, Dict, List, Optional
 
 
-MULTI_AGENT_VERSION = "3.2.0"
+MULTI_AGENT_VERSION = "3.3.0"
 
 AGENT_ROLES = ("researcher", "planner", "executor", "reviewer", "release")
 CORE_PIPELINE = ("planner", "executor", "reviewer")

package/latticeai/core/workspace_os.py

@@ -18,7 +18,7 @@ from pathlib import Path
 from typing import Any, Callable, Dict, Iterable, List, Optional
 
 
-WORKSPACE_OS_VERSION = "3.2.0"
+WORKSPACE_OS_VERSION = "3.3.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Lattice AI v3 local-first AI workspace platform with knowledge graph, vector index, hybrid search, agents, and workspace modes.",
   "homepage": "https://github.com/TaeSooPark-PTS/LatticeAI#readme",
   "repository": {

package/scripts/build_v3_assets.mjs

@@ -23,6 +23,12 @@ const repoRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
 const staticRoot = join(repoRoot, "static");
 const manifestPath = join(staticRoot, "v3", "asset-manifest.json");
 
+// Version is sourced from package.json — the single source of truth for the
+// release. Never hard-code a version string in the generated manifest.
+const pkgVersion = JSON.parse(
+  readFileSync(join(repoRoot, "package.json"), "utf8"),
+).version;
+
 const cssSources = [
   "static/css/tokens.css",
   "static/v3/css/lattice.tokens.css",
@@ -151,7 +157,7 @@ for (const mod of modules.values()) {
 }
 
 const manifest = {
-  version: "3.2.0",
+  version: pkgVersion,
   generated_at: "deterministic",
   entrypoints: {
     app: assets[entry],

package/static/css/{tokens.5a595671.css → tokens.8b8e31bd.css}

@@ -1,5 +1,5 @@
 /* ============================================================================
- * Lattice AI — Design Tokens (Single Source of Truth)  v3.1.0
+ * Lattice AI — Design Tokens (Single Source of Truth)  v3.3.0
  *
  * 이 파일이 색·면·테두리·그림자·포커스의 단일 출처다.
  *   :root                      → 라이트 테마 값

package/static/css/tokens.css

@@ -1,5 +1,5 @@
 /* ============================================================================
- * Lattice AI — Design Tokens (Single Source of Truth)  v3.1.0
+ * Lattice AI — Design Tokens (Single Source of Truth)  v3.3.0
  *
  * 이 파일이 색·면·테두리·그림자·포커스의 단일 출처다.
  *   :root                      → 라이트 테마 값

package/static/v3/asset-manifest.json

@@ -1,31 +1,31 @@
 {
-  "version": "3.2.0",
+  "version": "3.3.0",
   "generated_at": "deterministic",
   "entrypoints": {
-    "app": "/static/v3/js/app.a5adc0f3.js",
+    "app": "/static/v3/js/app.cf5bb712.js",
     "styles": [
-      "/static/css/tokens.5a595671.css",
+      "/static/css/tokens.8b8e31bd.css",
       "/static/v3/css/lattice.tokens.c597ff81.css",
       "/static/v3/css/lattice.base.e4cdd05d.css",
       "/static/v3/css/lattice.components.011e988b.css",
       "/static/v3/css/lattice.shell.4920f42d.css",
-      "/static/v3/css/lattice.views.3ee19d4e.css"
+      "/static/v3/css/lattice.views.1d326beb.css"
     ]
   },
   "assets": {
-    "static/css/tokens.css": "/static/css/tokens.5a595671.css",
+    "static/css/tokens.css": "/static/css/tokens.8b8e31bd.css",
     "static/v3/css/lattice.tokens.css": "/static/v3/css/lattice.tokens.c597ff81.css",
     "static/v3/css/lattice.base.css": "/static/v3/css/lattice.base.e4cdd05d.css",
     "static/v3/css/lattice.components.css": "/static/v3/css/lattice.components.011e988b.css",
     "static/v3/css/lattice.shell.css": "/static/v3/css/lattice.shell.4920f42d.css",
-    "static/v3/css/lattice.views.css": "/static/v3/css/lattice.views.3ee19d4e.css",
-    "static/v3/js/app.js": "/static/v3/js/app.a5adc0f3.js",
-    "static/v3/js/core/api.js": "/static/v3/js/core/api.603b978f.js",
+    "static/v3/css/lattice.views.css": "/static/v3/css/lattice.views.1d326beb.css",
+    "static/v3/js/app.js": "/static/v3/js/app.cf5bb712.js",
+    "static/v3/js/core/api.js": "/static/v3/js/core/api.113660c5.js",
     "static/v3/js/core/components.js": "/static/v3/js/core/components.4c83e0a9.js",
     "static/v3/js/core/dom.js": "/static/v3/js/core/dom.a2773eb0.js",
     "static/v3/js/core/router.js": "/static/v3/js/core/router.584570f2.js",
     "static/v3/js/core/routes.js": "/static/v3/js/core/routes.07ad6696.js",
-    "static/v3/js/core/shell.js": "/static/v3/js/core/shell.ea0b9ae5.js",
+    "static/v3/js/core/shell.js": "/static/v3/js/core/shell.9e707234.js",
     "static/v3/js/core/store.js": "/static/v3/js/core/store.34ebd5e6.js",
     "static/v3/js/views/admin-audit.js": "/static/v3/js/views/admin-audit.660a1fb1.js",
     "static/v3/js/views/admin-permissions.js": "/static/v3/js/views/admin-permissions.a7ae5f09.js",
@@ -34,20 +34,20 @@
     "static/v3/js/views/admin-security.js": "/static/v3/js/views/admin-security.07c66b72.js",
     "static/v3/js/views/admin-users.js": "/static/v3/js/views/admin-users.03bac88c.js",
     "static/v3/js/views/agents.js": "/static/v3/js/views/agents.c373d48c.js",
-    "static/v3/js/views/chat.js": "/static/v3/js/views/chat.718144ce.js",
-    "static/v3/js/views/files.js": "/static/v3/js/views/files.4935197e.js",
+    "static/v3/js/views/chat.js": "/static/v3/js/views/chat.c48fd9e2.js",
+    "static/v3/js/views/files.js": "/static/v3/js/views/files.8464634a.js",
     "static/v3/js/views/home.js": "/static/v3/js/views/home.cdde3b32.js",
     "static/v3/js/views/hooks.js": "/static/v3/js/views/hooks.f3edebca.js",
     "static/v3/js/views/hybrid-search.js": "/static/v3/js/views/hybrid-search.b22b97e0.js",
     "static/v3/js/views/knowledge-graph.js": "/static/v3/js/views/knowledge-graph.a14ea7e7.js",
     "static/v3/js/views/marketplace.js": "/static/v3/js/views/marketplace.ab0583d4.js",
     "static/v3/js/views/mcp.js": "/static/v3/js/views/mcp.99b5c6a7.js",
-    "static/v3/js/views/memory.js": "/static/v3/js/views/memory.d2ed7a7c.js",
+    "static/v3/js/views/memory.js": "/static/v3/js/views/memory.4ebdf474.js",
     "static/v3/js/views/models.js": "/static/v3/js/views/models.a1ffa147.js",
     "static/v3/js/views/my-computer.js": "/static/v3/js/views/my-computer.1b2ff621.js",
     "static/v3/js/views/pipeline.js": "/static/v3/js/views/pipeline.c522f1ce.js",
     "static/v3/js/views/planning.js": "/static/v3/js/views/planning.9ac3e313.js",
-    "static/v3/js/views/settings.js": "/static/v3/js/views/settings.4f777210.js",
+    "static/v3/js/views/settings.js": "/static/v3/js/views/settings.c7b0cc05.js",
     "static/v3/js/views/skills.js": "/static/v3/js/views/skills.c6c2f965.js",
     "static/v3/js/views/tools.js": "/static/v3/js/views/tools.e4f11276.js",
     "static/v3/js/views/workflows.js": "/static/v3/js/views/workflows.26c57290.js"

package/static/v3/css/{lattice.views.3ee19d4e.css → lattice.views.1d326beb.css}

@@ -245,6 +245,11 @@
   border-radius: var(--lt3-radius-lg);
   background: var(--surface-2);
   text-align: center;
+  transition: border-color var(--lt3-dur-2) var(--lt3-ease), background var(--lt3-dur-2) var(--lt3-ease);
+}
+.lt3-drop.is-dragover {
+  border-color: var(--accent);
+  background: var(--accent-soft);
 }
 
 /* ── Pipeline ────────────────────────────────────────────────────────────── */

package/static/v3/css/lattice.views.css

@@ -245,6 +245,11 @@
   border-radius: var(--lt3-radius-lg);
   background: var(--surface-2);
   text-align: center;
+  transition: border-color var(--lt3-dur-2) var(--lt3-ease), background var(--lt3-dur-2) var(--lt3-ease);
+}
+.lt3-drop.is-dragover {
+  border-color: var(--accent);
+  background: var(--accent-soft);
 }
 
 /* ── Pipeline ────────────────────────────────────────────────────────────── */

package/static/v3/js/{app.a5adc0f3.js → app.cf5bb712.js}

@@ -3,7 +3,7 @@
  * Boots the shell. Views are lazy-loaded by the router (see core/routes.js).
  * ========================================================================== */
 
-import { boot } from "./core/shell.ea0b9ae5.js";
+import { boot } from "./core/shell.9e707234.js";
 
 const root = document.getElementById("app");
 if (root) boot(root);

package/static/v3/js/core/{api.603b978f.js → api.113660c5.js}

@@ -82,9 +82,35 @@ export const api = {
 
   /* ── Documented future surfaces ─────────────────────────────────────── */
 
-  /** GET /api/index/status — KG + Vector + Hybrid pipeline state. */
-  indexStatus() {
-    return withFallback("/api/index/status", {}, EMPTY_INDEX_STATUS);
+  /** GET /api/index/status — KG + Vector + Hybrid pipeline state.
+   *  The backend endpoint is vector-centric (status/storage/source_items/…); the
+   *  home pillars + topbar chip want a `pipelines` view keyed by
+   *  knowledge_graph / vector_index / hybrid. Synthesize that shape from the real
+   *  index status (vectors) plus the KG stats endpoint (entities). Nothing is
+   *  fabricated: if the index endpoint is unavailable we report unavailable (so
+   *  the UI shows the honest empty state), and a missing graph-stats count yields
+   *  an "unavailable" graph pillar rather than a fake number. */
+  async indexStatus() {
+    const res = await raw("/api/index/status");
+    if (!(res.ok && res.data && !res.data.raw)) {
+      return { ok: false, status: res.status, data: EMPTY_INDEX_STATUS, source: "unavailable", error: res.error };
+    }
+    const idx = res.data;
+    let entities = null;
+    const gs = await raw("/knowledge-graph/stats");
+    if (gs.ok && gs.data && !gs.data.raw) {
+      const g = gs.data;
+      const n = g.total_nodes ?? g.nodes_total ?? (g.nodes && (g.nodes.total ?? g.nodes.count));
+      if (n !== undefined && n !== null) entities = Number(n) || 0;
+    }
+    const vectors = Number(idx.indexed_items ?? idx.ready_items) || 0;
+    const vstate = idx.status === "ready" ? "ready" : "pending";
+    const pipelines = {
+      knowledge_graph: { state: entities === null ? "unavailable" : "ready", entities: entities ?? 0 },
+      vector_index: { state: vstate, vectors },
+      hybrid: { state: vstate, strategy: vstate === "ready" ? "fused" : "pending" },
+    };
+    return { ok: true, status: res.status, data: { ...idx, pipelines }, source: "live" };
   },
 
   /** POST /api/index/rebuild — rebuild the derived vector index (real run). */
@@ -176,6 +202,31 @@ export const api = {
   },
   sysinfo() { return withFallback("/local/sysinfo", {}, EMPTY_SYSINFO); },
 
+  /** POST /upload/document — manual document ingest (multipart/form-data).
+   *  Real backend path: parse → chunk → embed → knowledge-graph ingest
+   *  (latticeai/api/tools.py:/upload/document). Returns { ok, status, data,
+   *  source }; never throws. FormData must NOT carry a JSON Content-Type — the
+   *  browser sets the multipart boundary itself. */
+  async uploadDocument(file) {
+    const ws = store.get().workspaceId;
+    const form = new FormData();
+    form.append("file", file);
+    try {
+      const res = await fetch("/upload/document", {
+        method: "POST",
+        credentials: "same-origin",
+        headers: { "Accept": "application/json", ...(ws ? { "X-Workspace-Id": ws } : {}) },
+        body: form,
+      });
+      let data = null;
+      const text = await res.text();
+      if (text) { try { data = JSON.parse(text); } catch { data = { raw: text }; } }
+      return { ok: res.ok, status: res.status, data, source: res.ok ? "live" : "unavailable" };
+    } catch (err) {
+      return { ok: false, status: 0, data: null, source: "unavailable", error: String(err) };
+    }
+  },
+
   adminSummary() { return withFallback("/admin/summary", {}, EMPTY_ADMIN.summary); },
   adminUsers() { return withFallback("/admin/users", {}, EMPTY_ADMIN.users); },
   adminAudit() { return withFallback("/admin/audit", {}, EMPTY_ADMIN.audit); },
@@ -310,7 +361,11 @@ export const api = {
           const rawData = line.slice(5).trim();
           if (rawData === "[DONE]") return { source: "live", text, trace, model };
           let data; try { data = JSON.parse(rawData); } catch { continue; }
-          if (data.chunk) { text += data.chunk; onChunk && onChunk(data.chunk, text); }
+          // Standard chat streams `chunk`; the document-generation path streams
+          // `text` (report body + footnotes). Accept both so doc requests render
+          // instead of falsely reporting the backend as unreachable.
+          const delta = data.chunk || data.text;
+          if (delta) { text += delta; onChunk && onChunk(delta, text); }
           if (data.model) model = data.model;
           if (data.trace) { trace = data.trace; onTrace && onTrace(trace); }
         }

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

@@ -82,9 +82,35 @@ export const api = {
 
   /* ── Documented future surfaces ─────────────────────────────────────── */
 
-  /** GET /api/index/status — KG + Vector + Hybrid pipeline state. */
-  indexStatus() {
-    return withFallback("/api/index/status", {}, EMPTY_INDEX_STATUS);
+  /** GET /api/index/status — KG + Vector + Hybrid pipeline state.
+   *  The backend endpoint is vector-centric (status/storage/source_items/…); the
+   *  home pillars + topbar chip want a `pipelines` view keyed by
+   *  knowledge_graph / vector_index / hybrid. Synthesize that shape from the real
+   *  index status (vectors) plus the KG stats endpoint (entities). Nothing is
+   *  fabricated: if the index endpoint is unavailable we report unavailable (so
+   *  the UI shows the honest empty state), and a missing graph-stats count yields
+   *  an "unavailable" graph pillar rather than a fake number. */
+  async indexStatus() {
+    const res = await raw("/api/index/status");
+    if (!(res.ok && res.data && !res.data.raw)) {
+      return { ok: false, status: res.status, data: EMPTY_INDEX_STATUS, source: "unavailable", error: res.error };
+    }
+    const idx = res.data;
+    let entities = null;
+    const gs = await raw("/knowledge-graph/stats");
+    if (gs.ok && gs.data && !gs.data.raw) {
+      const g = gs.data;
+      const n = g.total_nodes ?? g.nodes_total ?? (g.nodes && (g.nodes.total ?? g.nodes.count));
+      if (n !== undefined && n !== null) entities = Number(n) || 0;
+    }
+    const vectors = Number(idx.indexed_items ?? idx.ready_items) || 0;
+    const vstate = idx.status === "ready" ? "ready" : "pending";
+    const pipelines = {
+      knowledge_graph: { state: entities === null ? "unavailable" : "ready", entities: entities ?? 0 },
+      vector_index: { state: vstate, vectors },
+      hybrid: { state: vstate, strategy: vstate === "ready" ? "fused" : "pending" },
+    };
+    return { ok: true, status: res.status, data: { ...idx, pipelines }, source: "live" };
   },
 
   /** POST /api/index/rebuild — rebuild the derived vector index (real run). */
@@ -176,6 +202,31 @@ export const api = {
   },
   sysinfo() { return withFallback("/local/sysinfo", {}, EMPTY_SYSINFO); },
 
+  /** POST /upload/document — manual document ingest (multipart/form-data).
+   *  Real backend path: parse → chunk → embed → knowledge-graph ingest
+   *  (latticeai/api/tools.py:/upload/document). Returns { ok, status, data,
+   *  source }; never throws. FormData must NOT carry a JSON Content-Type — the
+   *  browser sets the multipart boundary itself. */
+  async uploadDocument(file) {
+    const ws = store.get().workspaceId;
+    const form = new FormData();
+    form.append("file", file);
+    try {
+      const res = await fetch("/upload/document", {
+        method: "POST",
+        credentials: "same-origin",
+        headers: { "Accept": "application/json", ...(ws ? { "X-Workspace-Id": ws } : {}) },
+        body: form,
+      });
+      let data = null;
+      const text = await res.text();
+      if (text) { try { data = JSON.parse(text); } catch { data = { raw: text }; } }
+      return { ok: res.ok, status: res.status, data, source: res.ok ? "live" : "unavailable" };
+    } catch (err) {
+      return { ok: false, status: 0, data: null, source: "unavailable", error: String(err) };
+    }
+  },
+
   adminSummary() { return withFallback("/admin/summary", {}, EMPTY_ADMIN.summary); },
   adminUsers() { return withFallback("/admin/users", {}, EMPTY_ADMIN.users); },
   adminAudit() { return withFallback("/admin/audit", {}, EMPTY_ADMIN.audit); },
@@ -310,7 +361,11 @@ export const api = {
           const rawData = line.slice(5).trim();
           if (rawData === "[DONE]") return { source: "live", text, trace, model };
           let data; try { data = JSON.parse(rawData); } catch { continue; }
-          if (data.chunk) { text += data.chunk; onChunk && onChunk(data.chunk, text); }
+          // Standard chat streams `chunk`; the document-generation path streams
+          // `text` (report body + footnotes). Accept both so doc requests render
+          // instead of falsely reporting the backend as unreachable.
+          const delta = data.chunk || data.text;
+          if (delta) { text += delta; onChunk && onChunk(delta, text); }
           if (data.model) model = data.model;
           if (data.trace) { trace = data.trace; onTrace && onTrace(trace); }
         }

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

@@ -7,7 +7,7 @@
 
 import { h, icon, $, $$ } from "./dom.a2773eb0.js";
 import { store } from "./store.34ebd5e6.js";
-import { api } from "./api.603b978f.js";
+import { api } from "./api.113660c5.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.07ad6696.js";

package/static/v3/js/views/{chat.718144ce.js → chat.c48fd9e2.js}

@@ -52,7 +52,7 @@ export async function render(ctx) {
 
   const groundChip = (key, label, icn) => h("button.lt3-chip", {
     type: "button", dataset: { active: String(state.grounding[key]) }, "aria-pressed": String(state.grounding[key]),
-    title: `Toggle ${label} grounding`,
+    title: `Show the ${label} signal in the retrieval-context panel`,
     on: { click: (e) => { state.grounding[key] = !state.grounding[key]; const b = e.currentTarget; b.dataset.active = String(state.grounding[key]); b.setAttribute("aria-pressed", String(state.grounding[key])); } },
   }, icon(icn), label);
 

package/static/v3/js/views/chat.js

@@ -52,7 +52,7 @@ export async function render(ctx) {
 
   const groundChip = (key, label, icn) => h("button.lt3-chip", {
     type: "button", dataset: { active: String(state.grounding[key]) }, "aria-pressed": String(state.grounding[key]),
-    title: `Toggle ${label} grounding`,
+    title: `Show the ${label} signal in the retrieval-context panel`,
     on: { click: (e) => { state.grounding[key] = !state.grounding[key]; const b = e.currentTarget; b.dataset.active = String(state.grounding[key]); b.setAttribute("aria-pressed", String(state.grounding[key])); } },
   }, icon(icn), label);
 

package/static/v3/js/views/{files.4935197e.js → files.8464634a.js}

@@ -61,11 +61,15 @@ function normalize(data) {
   }));
 }
 
+/** Document types the backend accepts (latticeai/services/upload_service.py). */
+const UPLOAD_ACCEPT = ".pdf,.docx,.xlsx,.pptx,.txt,.md,.csv";
+
 export async function render(ctx) {
   const { h, icon, api, c, navigate, toast } = ctx;
 
-  // Folder connection/watch needs the desktop local-agent connector, which is
-  // not enabled in this build. Say so plainly rather than implying it's coming.
+  // Connecting/watching a *folder* needs the desktop local-agent connector,
+  // which is not enabled in this build. Say so plainly. Manual document upload
+  // below works without it.
   const unavailableToast = () =>
     toast("Connecting a folder requires the Lattice desktop local agent — not available in this build.", "warn");
 
@@ -73,6 +77,56 @@ export async function render(ctx) {
   const srcSlot = h("span", c.sourceBadge("pending"));
   const tableHost = h("div", c.loading({ lines: 4 }));
 
+  // ── Manual upload (works in this build; no desktop agent required) ─────────
+  let busy = false;
+  const fileInput = h("input", {
+    type: "file", multiple: true, accept: UPLOAD_ACCEPT,
+    style: { display: "none" }, "aria-hidden": "true",
+    on: { change: (e) => uploadFiles(e.target.files) },
+  });
+  const pickFiles = () => { if (!busy) fileInput.click(); };
+  const slots = { statHost, srcSlot, tableHost, pickFiles };
+
+  async function uploadFiles(fileList) {
+    const files = Array.from(fileList || []);
+    if (!files.length || busy) return;
+    busy = true;
+    let ok = 0;
+    for (const file of files) {
+      toast(`Uploading “${file.name}”…`, "info");
+      const res = await api.uploadDocument(file);
+      if (res.ok && res.data && !res.data.detail && !res.data.error) {
+        ok++;
+      } else {
+        const detail = (res.data && (res.data.detail || res.data.error)) || "the backend is unavailable";
+        toast(`Could not ingest “${file.name}” — ${detail}.`, "warn");
+      }
+    }
+    fileInput.value = "";
+    busy = false;
+    if (ok) {
+      toast(`Indexed ${ok} document${ok === 1 ? "" : "s"} into the knowledge graph — now searchable in Chat and Hybrid Search.`, "ok");
+    }
+    hydrate(ctx, slots);
+  }
+
+  const dropZone = h("div.lt3-drop", {
+    on: {
+      dragover: (e) => { e.preventDefault(); dropZone.classList.add("is-dragover"); },
+      dragleave: () => dropZone.classList.remove("is-dragover"),
+      drop: (e) => { e.preventDefault(); dropZone.classList.remove("is-dragover"); uploadFiles(e.dataTransfer && e.dataTransfer.files); },
+    },
+  },
+    fileInput,
+    h("div.lt3-pillar__icon", icon("cloud-upload")),
+    h("div",
+      h("div", { style: { "font-weight": "var(--lt3-weight-semi)" } }, "Drag documents here, or upload manually"),
+      h("p.lt3-faint", { style: { "font-size": "var(--lt3-text-sm)", "margin-top": "var(--lt3-space-1)" } },
+        "Lattice parses each file, chunks it, embeds it, and links it into the knowledge graph. PDF · DOCX · XLSX · PPTX · TXT · MD · CSV, up to 10 MB each."),
+    ),
+    h("button.lt3-btn.lt3-btn--primary", { type: "button", on: { click: pickFiles } }, icon("upload"), "Upload files"),
+  );
+
   const root = h("div.lt3-stack-6",
     c.viewHeader({
       eyebrow: "Data",
@@ -80,19 +134,12 @@ export async function render(ctx) {
       sub: "Connected sources and the documents Lattice has indexed for retrieval. Everything stays on this machine.",
       actions: [
         h("button.lt3-btn.lt3-btn--ghost", { on: { click: () => navigate("knowledge-graph") } }, icon("chart-dots-3"), "View graph"),
+        h("button.lt3-btn.lt3-btn--primary", { on: { click: pickFiles } }, icon("upload"), "Upload files"),
         h("button.lt3-btn.lt3-btn--ghost", { title: "Requires the desktop local agent (not in this build)", on: { click: unavailableToast } }, icon("folder-plus"), "Connect folder"),
       ],
     }),
     statHost,
-    h("div.lt3-drop",
-      h("div.lt3-pillar__icon", icon("cloud-upload")),
-      h("div",
-        h("div", { style: { "font-weight": "var(--lt3-weight-semi)" } }, "Drag files or connect a folder"),
-        h("p.lt3-faint", { style: { "font-size": "var(--lt3-text-sm)", "margin-top": "var(--lt3-space-1)" } },
-          "Lattice watches the source, chunks it, embeds it, and links it into the knowledge graph."),
-      ),
-      h("button.lt3-btn.lt3-btn--ghost", { title: "Requires the desktop local agent (not in this build)", on: { click: unavailableToast } }, icon("folder-plus"), "Choose folder"),
-    ),
+    dropZone,
     c.panel({
       head: h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "flex-start", width: "100%" } },
         h("div",
@@ -105,13 +152,13 @@ export async function render(ctx) {
     }),
   );
 
-  hydrate(ctx, { statHost, srcSlot, tableHost });
+  hydrate(ctx, slots);
   return root;
 }
 
 async function hydrate(ctx, slots) {
   const { h, icon, api, c, toast } = ctx;
-  const { statHost, srcSlot, tableHost } = slots;
+  const { statHost, srcSlot, tableHost, pickFiles } = slots;
 
   const probe = await api.get("/workspace/indexing", { sources: [], totals: {} });
   const liveFiles = probe.ok && probe.data ? normalize(probe.data) : null;
@@ -137,11 +184,10 @@ async function hydrate(ctx, slots) {
     tableHost.replaceChildren(c.emptyState({
       icon: "folder-off",
       title: "No documents indexed yet",
-      body: "Connect a folder and Lattice will index it for hybrid retrieval.",
-      action: h("button.lt3-btn.lt3-btn--ghost.lt3-btn--sm",
-        { title: "Requires the desktop local agent (not in this build)",
-          on: { click: () => toast("Connecting a folder requires the Lattice desktop local agent — not available in this build.", "warn") } },
-        icon("folder-plus"), "Connect folder"),
+      body: "Upload a document and Lattice will parse, embed, and link it into the knowledge graph for hybrid retrieval.",
+      action: h("button.lt3-btn.lt3-btn--primary.lt3-btn--sm",
+        { on: { click: () => (pickFiles ? pickFiles() : null) } },
+        icon("upload"), "Upload files"),
     }));
     return;
   }

package/static/v3/js/views/files.js

@@ -61,11 +61,15 @@ function normalize(data) {
   }));
 }
 
+/** Document types the backend accepts (latticeai/services/upload_service.py). */
+const UPLOAD_ACCEPT = ".pdf,.docx,.xlsx,.pptx,.txt,.md,.csv";
+
 export async function render(ctx) {
   const { h, icon, api, c, navigate, toast } = ctx;
 
-  // Folder connection/watch needs the desktop local-agent connector, which is
-  // not enabled in this build. Say so plainly rather than implying it's coming.
+  // Connecting/watching a *folder* needs the desktop local-agent connector,
+  // which is not enabled in this build. Say so plainly. Manual document upload
+  // below works without it.
   const unavailableToast = () =>
     toast("Connecting a folder requires the Lattice desktop local agent — not available in this build.", "warn");
 
@@ -73,6 +77,56 @@ export async function render(ctx) {
   const srcSlot = h("span", c.sourceBadge("pending"));
   const tableHost = h("div", c.loading({ lines: 4 }));
 
+  // ── Manual upload (works in this build; no desktop agent required) ─────────
+  let busy = false;
+  const fileInput = h("input", {
+    type: "file", multiple: true, accept: UPLOAD_ACCEPT,
+    style: { display: "none" }, "aria-hidden": "true",
+    on: { change: (e) => uploadFiles(e.target.files) },
+  });
+  const pickFiles = () => { if (!busy) fileInput.click(); };
+  const slots = { statHost, srcSlot, tableHost, pickFiles };
+
+  async function uploadFiles(fileList) {
+    const files = Array.from(fileList || []);
+    if (!files.length || busy) return;
+    busy = true;
+    let ok = 0;
+    for (const file of files) {
+      toast(`Uploading “${file.name}”…`, "info");
+      const res = await api.uploadDocument(file);
+      if (res.ok && res.data && !res.data.detail && !res.data.error) {
+        ok++;
+      } else {
+        const detail = (res.data && (res.data.detail || res.data.error)) || "the backend is unavailable";
+        toast(`Could not ingest “${file.name}” — ${detail}.`, "warn");
+      }
+    }
+    fileInput.value = "";
+    busy = false;
+    if (ok) {
+      toast(`Indexed ${ok} document${ok === 1 ? "" : "s"} into the knowledge graph — now searchable in Chat and Hybrid Search.`, "ok");
+    }
+    hydrate(ctx, slots);
+  }
+
+  const dropZone = h("div.lt3-drop", {
+    on: {
+      dragover: (e) => { e.preventDefault(); dropZone.classList.add("is-dragover"); },
+      dragleave: () => dropZone.classList.remove("is-dragover"),
+      drop: (e) => { e.preventDefault(); dropZone.classList.remove("is-dragover"); uploadFiles(e.dataTransfer && e.dataTransfer.files); },
+    },
+  },
+    fileInput,
+    h("div.lt3-pillar__icon", icon("cloud-upload")),
+    h("div",
+      h("div", { style: { "font-weight": "var(--lt3-weight-semi)" } }, "Drag documents here, or upload manually"),
+      h("p.lt3-faint", { style: { "font-size": "var(--lt3-text-sm)", "margin-top": "var(--lt3-space-1)" } },
+        "Lattice parses each file, chunks it, embeds it, and links it into the knowledge graph. PDF · DOCX · XLSX · PPTX · TXT · MD · CSV, up to 10 MB each."),
+    ),
+    h("button.lt3-btn.lt3-btn--primary", { type: "button", on: { click: pickFiles } }, icon("upload"), "Upload files"),
+  );
+
   const root = h("div.lt3-stack-6",
     c.viewHeader({
       eyebrow: "Data",
@@ -80,19 +134,12 @@ export async function render(ctx) {
       sub: "Connected sources and the documents Lattice has indexed for retrieval. Everything stays on this machine.",
       actions: [
         h("button.lt3-btn.lt3-btn--ghost", { on: { click: () => navigate("knowledge-graph") } }, icon("chart-dots-3"), "View graph"),
+        h("button.lt3-btn.lt3-btn--primary", { on: { click: pickFiles } }, icon("upload"), "Upload files"),
         h("button.lt3-btn.lt3-btn--ghost", { title: "Requires the desktop local agent (not in this build)", on: { click: unavailableToast } }, icon("folder-plus"), "Connect folder"),
       ],
     }),
     statHost,
-    h("div.lt3-drop",
-      h("div.lt3-pillar__icon", icon("cloud-upload")),
-      h("div",
-        h("div", { style: { "font-weight": "var(--lt3-weight-semi)" } }, "Drag files or connect a folder"),
-        h("p.lt3-faint", { style: { "font-size": "var(--lt3-text-sm)", "margin-top": "var(--lt3-space-1)" } },
-          "Lattice watches the source, chunks it, embeds it, and links it into the knowledge graph."),
-      ),
-      h("button.lt3-btn.lt3-btn--ghost", { title: "Requires the desktop local agent (not in this build)", on: { click: unavailableToast } }, icon("folder-plus"), "Choose folder"),
-    ),
+    dropZone,
     c.panel({
       head: h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "flex-start", width: "100%" } },
         h("div",
@@ -105,13 +152,13 @@ export async function render(ctx) {
     }),
   );
 
-  hydrate(ctx, { statHost, srcSlot, tableHost });
+  hydrate(ctx, slots);
   return root;
 }
 
 async function hydrate(ctx, slots) {
   const { h, icon, api, c, toast } = ctx;
-  const { statHost, srcSlot, tableHost } = slots;
+  const { statHost, srcSlot, tableHost, pickFiles } = slots;
 
   const probe = await api.get("/workspace/indexing", { sources: [], totals: {} });
   const liveFiles = probe.ok && probe.data ? normalize(probe.data) : null;
@@ -137,11 +184,10 @@ async function hydrate(ctx, slots) {
     tableHost.replaceChildren(c.emptyState({
       icon: "folder-off",
       title: "No documents indexed yet",
-      body: "Connect a folder and Lattice will index it for hybrid retrieval.",
-      action: h("button.lt3-btn.lt3-btn--ghost.lt3-btn--sm",
-        { title: "Requires the desktop local agent (not in this build)",
-          on: { click: () => toast("Connecting a folder requires the Lattice desktop local agent — not available in this build.", "warn") } },
-        icon("folder-plus"), "Connect folder"),
+      body: "Upload a document and Lattice will parse, embed, and link it into the knowledge graph for hybrid retrieval.",
+      action: h("button.lt3-btn.lt3-btn--primary.lt3-btn--sm",
+        { on: { click: () => (pickFiles ? pickFiles() : null) } },
+        icon("upload"), "Upload files"),
     }));
     return;
   }

package/static/v3/js/views/{memory.d2ed7a7c.js → memory.4ebdf474.js}

@@ -1,8 +1,9 @@
 /* ============================================================================
  * View: Memory — the long-term memory platform + Memory Manager.
  * Reads /api/memory/manager (usage / sources / health / size / type) and offers
- * recall, inspect, prune, compact, rebuild, and clear. Every number comes from a
- * real store; tiers with no backing report unavailable.
+ * recall, inspect, compact, and rebuild. Every number comes from a real store;
+ * tiers with no backing report unavailable. (Destructive prune/clear are
+ * available over the API but intentionally not surfaced as one-click UI here.)
  * ========================================================================== */
 
 const TIER_ICON = {
@@ -19,7 +20,7 @@ export async function render(ctx) {
   const recallHost = h("div");
   const inspectHost = h("div", h("p.lt3-faint", { style: { margin: 0 } }, "Pick a tier to inspect its contents."));
 
-  const recallInput = h("input.lt3-input", { type: "text", placeholder: "Recall across every memory tier…", "aria-label": "Recall memory" });
+  const recallInput = h("input.lt3-input", { type: "text", placeholder: "Recall from workspace + graph memory…", "aria-label": "Recall memory" });
 
   const root = h("div.lt3-stack-6",
     c.viewHeader({
@@ -30,7 +31,7 @@ export async function render(ctx) {
     }),
     statHost,
     c.panel({
-      title: "Recall", sub: "Unified retrieval across the memory tiers.",
+      title: "Recall", sub: "Searches your workspace and knowledge-graph memory.",
       children: h("div.lt3-stack-3",
         h("div.lt3-row-2",
           recallInput,

package/static/v3/js/views/memory.js

@@ -1,8 +1,9 @@
 /* ============================================================================
  * View: Memory — the long-term memory platform + Memory Manager.
  * Reads /api/memory/manager (usage / sources / health / size / type) and offers
- * recall, inspect, prune, compact, rebuild, and clear. Every number comes from a
- * real store; tiers with no backing report unavailable.
+ * recall, inspect, compact, and rebuild. Every number comes from a real store;
+ * tiers with no backing report unavailable. (Destructive prune/clear are
+ * available over the API but intentionally not surfaced as one-click UI here.)
  * ========================================================================== */
 
 const TIER_ICON = {
@@ -19,7 +20,7 @@ export async function render(ctx) {
   const recallHost = h("div");
   const inspectHost = h("div", h("p.lt3-faint", { style: { margin: 0 } }, "Pick a tier to inspect its contents."));
 
-  const recallInput = h("input.lt3-input", { type: "text", placeholder: "Recall across every memory tier…", "aria-label": "Recall memory" });
+  const recallInput = h("input.lt3-input", { type: "text", placeholder: "Recall from workspace + graph memory…", "aria-label": "Recall memory" });
 
   const root = h("div.lt3-stack-6",
     c.viewHeader({
@@ -30,7 +31,7 @@ export async function render(ctx) {
     }),
     statHost,
     c.panel({
-      title: "Recall", sub: "Unified retrieval across the memory tiers.",
+      title: "Recall", sub: "Searches your workspace and knowledge-graph memory.",
       children: h("div.lt3-stack-3",
         h("div.lt3-row-2",
           recallInput,

package/static/v3/js/views/{settings.4f777210.js → settings.c7b0cc05.js}

@@ -228,7 +228,21 @@ async function probeEndpoints({ h, icon, api, c }, host) {
 }
 
 /* ── About ──────────────────────────────────────────────────────────────── */
-function aboutPanel({ h, icon, c }) {
+/* Version is read live from /health (which derives it from the backend's single
+ * source of truth, WORKSPACE_OS_VERSION) — never hard-coded in the frontend.
+ * If the backend is unreachable we say "unavailable" rather than inventing a
+ * number. */
+function aboutPanel({ h, icon, c, api }) {
+  const versionSlot = h("dd", h("span.lt3-mono.lt3-faint", "checking…"));
+  (async () => {
+    const res = await api.raw("/health");
+    const v = res && res.ok && res.data && res.data.version;
+    versionSlot.replaceChildren(
+      v
+        ? h("span.lt3-mono", `v${String(v).replace(/^v/i, "")}`)
+        : h("span.lt3-mono.lt3-faint", "unavailable"),
+    );
+  })();
   return c.panel({
     eyebrow: "About",
     title: "Lattice AI",
@@ -236,7 +250,7 @@ function aboutPanel({ h, icon, c }) {
     children: h("div.lt3-stack-4",
       h("dl.lt3-keyval",
         h("dt", "Application"), h("dd", "Lattice AI"),
-        h("dt", "Version"), h("dd", h("span.lt3-mono", "v3.1.0")),
+        h("dt", "Version"), versionSlot,
         h("dt", "Edition"), h("dd", "Local-first AI workspace"),
       ),
     ),

package/static/v3/js/views/settings.js

@@ -228,7 +228,21 @@ async function probeEndpoints({ h, icon, api, c }, host) {
 }
 
 /* ── About ──────────────────────────────────────────────────────────────── */
-function aboutPanel({ h, icon, c }) {
+/* Version is read live from /health (which derives it from the backend's single
+ * source of truth, WORKSPACE_OS_VERSION) — never hard-coded in the frontend.
+ * If the backend is unreachable we say "unavailable" rather than inventing a
+ * number. */
+function aboutPanel({ h, icon, c, api }) {
+  const versionSlot = h("dd", h("span.lt3-mono.lt3-faint", "checking…"));
+  (async () => {
+    const res = await api.raw("/health");
+    const v = res && res.ok && res.data && res.data.version;
+    versionSlot.replaceChildren(
+      v
+        ? h("span.lt3-mono", `v${String(v).replace(/^v/i, "")}`)
+        : h("span.lt3-mono.lt3-faint", "unavailable"),
+    );
+  })();
   return c.panel({
     eyebrow: "About",
     title: "Lattice AI",
@@ -236,7 +250,7 @@ function aboutPanel({ h, icon, c }) {
     children: h("div.lt3-stack-4",
       h("dl.lt3-keyval",
         h("dt", "Application"), h("dd", "Lattice AI"),
-        h("dt", "Version"), h("dd", h("span.lt3-mono", "v3.1.0")),
+        h("dt", "Version"), versionSlot,
         h("dt", "Edition"), h("dd", "Local-first AI workspace"),
       ),
     ),