ltcai 4.5.1 → 4.6.0

package/README.md

@@ -7,14 +7,18 @@
 [![CI Status](https://github.com/TaeSooPark-PTS/LatticeAI/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/TaeSooPark-PTS/LatticeAI/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
-**Lattice AI v4.5.1 is a local-first Digital Brain desktop workspace.** It runs
+**Lattice AI v4.6.0 is a local-first Living Brain desktop workspace.** It runs
 as a Tauri desktop app with a localhost FastAPI sidecar, stores the user's brain
-locally by default, and presents the Knowledge Graph as the durable asset.
-
-This README describes the v4.5.1 release-candidate tree, which preserves the
-v4.4.0 physical `lattice_brain` extraction and v4.5.0 capability recovery while
-reimagining the product surface from first principles: Home, Ask, Add,
-Automate, Library, and Care replace the prior dashboard-style presentation.
+locally by default, and makes the Brain plus conversation the primary product
+experience.
+
+This README describes the v4.6.0 release-preparation tree, which preserves the
+v4.4.0 physical `lattice_brain` extraction, v4.5.0 capability recovery, and
+v4.5.1 product shell while repositioning the graph as a deep exploration layer.
+First launch now follows a Brain-first product flow: Login, friendly environment
+analysis, recommended models, guided install/download/validate/load, then the
+living Brain conversation. Memories, knowledge, relationships, and the advanced
+graph are progressively disclosed beneath the Brain.
 External package registries are owner-published; the badges above link to
 package pages and may show the most recently published owner-controlled registry
 version, which can lag behind the GitHub Release.
@@ -23,19 +27,23 @@ version, which can lag behind the GitHub Release.
 
 - Desktop app starts and serves the React/Vite product shell from the FastAPI
   sidecar.
-- Brain graph renders persisted local graph data with search, groups, focus,
-  filtering, and hybrid-search results.
-- Ask displays durable conversations, graph context, and honest unavailable
-  state when no model is loaded.
+- First launch opens to Login only, then guides environment analysis,
+  recommendations, install/download/validate/load, and finally the Brain.
+- After model loading, the home route opens to a living Brain presence plus
+  durable conversation, with the Brain always visible during the primary chat
+  flow.
+- The Brain presence reacts to conversation, recall, model readiness, and
+  agent/workflow activity with neural movement, memory pulses, and status
+  changes.
+- Memories, Knowledge, Relationships, and Graph are ordered as progressive
+  disclosure layers; the graph is no longer the product's first impression.
 - Capture uploads a document through `/upload/document` and shows indexed
   documents from the backend.
 - Act exposes workflow create/run surfaces and agent runtime status without
   presenting simulation as real success. When no LLM-backed model is loaded,
   deterministic model-free agent simulation is reported honestly and does not call a model.
-- Library shows model/runtime availability honestly.
-- First-run setup guides Make it yours -> Choose a space -> Meet your Mac ->
-  Pick a brain -> Install locally -> Try a question -> Set the pace -> Explore
-  memory.
+- Model setup recommends a short ranked list for the current computer instead
+  of exposing a catalog or runtime internals.
 - Gemma 4 MLX models are checked against their local `config.json` before load:
   Gemma 4 12B `gemma4_unified` now shows **Runtime update needed** when the
   installed MLX-VLM lacks `mlx_vlm.models.gemma4_unified`, while Gemma 4 26B
@@ -49,7 +57,7 @@ version, which can lag behind the GitHub Release.
 
 ### Desktop Startup
 
-The v4.5.1 DMG build launches a visible Tauri app, starts the FastAPI sidecar on
+The v4.6.0 DMG build launches a visible Tauri app, starts the FastAPI sidecar on
 localhost, and shuts that sidecar down on normal macOS quit.
 
 ![Desktop startup and local sidecar](output/audits/v4.3.2-rc/screenshots/13-desktop-sidecar-startup.png)
@@ -59,23 +67,28 @@ Evidence:
 - Health log: `output/audits/v4.3.2-rc/logs/desktop-sidecar-health-after-shutdown-fix.json`
 - Shutdown log: `output/audits/v4.3.2-rc/logs/desktop-shutdown-after-fix.txt`
 
-### Brain Graph
+### Living Brain
+
+Brain opens on a living presence and conversation. The visual Brain is not a
+logo or static decoration: it changes state while the user types, when memories
+are recalled, while a response streams, and when agent/workflow activity is
+reported.
 
-Brain opens on the graph-first workspace. The graph uses real persisted nodes
-and edges, then layers product controls for search, semantic grouping, focus
-neighborhoods, label modes, group collapse/expand, and importance filtering.
+The advanced graph still exists, but it is intentionally opened from the Graph
+layer after the user moves through Brain, Memories, Knowledge, and
+Relationships.
 
 ![Brain graph explorer](output/audits/v4.3.2-rc/screenshots/02-graph-explorer-before.png)
 
 ![Graph product walkthrough](output/audits/v4.3.2-rc/gifs/graph-product-walkthrough.gif)
 
-### Ask
+### Conversation
 
-Ask uses backend conversation, model, and graph context APIs. In the audited
-state no model was loaded, so the UI showed a ready/unavailable state instead of
-fabricating an answer while still surfacing graph context from local data.
+Conversation uses backend conversation, model, and memory APIs. If no model is
+loaded, the UI shows a ready/unavailable state instead of fabricating an answer
+while still keeping nearby memory and source signals visible.
 
-![Ask with graph context and no-model honesty](output/audits/v4.3.2-rc/screenshots/14-ask-context.png)
+![Conversation with context and no-model honesty](output/audits/v4.3.2-rc/screenshots/14-ask-context.png)
 
 ### Capture
 
@@ -159,19 +172,19 @@ Archive evidence:
 - **Privacy**: local-first by default; cloud models, Telegram, Brain Network,
   Docker, model downloads, and update checks require explicit opt-in paths.
 
-See [ARCHITECTURE.md](ARCHITECTURE.md) for the detailed v4 architecture. v4.5.1
+See [ARCHITECTURE.md](ARCHITECTURE.md) for the detailed v4 architecture. v4.6.0
 does not redesign the v4.4.0 Brain Core extraction, StorageEngine, FastAPI,
 Tauri, backup/restore, or portability architecture.
 
 ## Installation And Release Artifacts
 
-Validated v4.5.1 RC artifacts are produced from the product-reimagining tree:
+Validated v4.6.0 artifacts are produced from the Living Brain tree:
 
-- `dist/ltcai-4.5.1-py3-none-any.whl`
-- `dist/ltcai-4.5.1.tar.gz`
-- `ltcai-4.5.1.tgz`
-- `dist/ltcai-4.5.1.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.5.1_aarch64.dmg`
+- `dist/ltcai-4.6.0-py3-none-any.whl`
+- `dist/ltcai-4.6.0.tar.gz`
+- `ltcai-4.6.0.tgz`
+- `dist/ltcai-4.6.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_4.6.0_aarch64.dmg`
 
 For a public release, attach only those exact artifacts to the GitHub Release.
 Package-registry publishing is reserved for the owner.
@@ -219,14 +232,15 @@ npm pack --dry-run
   local use.
 - Docker is never auto-started by default.
 - Model downloads and cloud model calls require explicit user action/consent.
-- Ask does not fabricate answers when no model is loaded.
+- Conversation does not fabricate answers when no model is loaded.
 - Historical artifacts may remain in `dist/`; release uploads must use exact
-  v4.5.1 filenames for this RC.
+  v4.6.0 filenames for this release.
 
 ## Release History
 
 | Version | Theme |
 | --- | --- |
+| 4.6.0 | Living Brain Experience: made Brain plus conversation the home product, added an animated living Brain presence, and moved graph exploration to the deepest intentional layer |
 | 4.5.1 | Product Reimagining RC: replaced the desktop shell, navigation model, onboarding journey, first-viewport hierarchy, and visual system while preserving capabilities and local-first architecture |
 | 4.5.0 | Product Experience Recovery RC: restored first-run setup, workspace/model onboarding, explicit model install/download/validate/load flow, Gemma 4 runtime compatibility gating, Basic-mode polish, and graph discoverability |
 | 4.4.0 | Brain Engine Extraction: Brain Core physically moved into `lattice_brain` (graph/memory/context/conversation/ingestion/runtime/workflow/portability), latticeai paths reduced to compatibility shims, isolation tests guaranteeing no `latticeai` imports |
@@ -246,6 +260,7 @@ npm pack --dry-run
 - [FEATURE_STATUS.md](FEATURE_STATUS.md) - current feature status and historical
   status ledger.
 - [RELEASE_NOTES.md](RELEASE_NOTES.md) - current release notes index.
+- [RELEASE_NOTES_v4.6.0.md](RELEASE_NOTES_v4.6.0.md) - v4.6.0 Living Brain release notes.
 - [RELEASE_NOTES_v4.5.1.md](RELEASE_NOTES_v4.5.1.md) - v4.5.1 RC release notes.
 - [RELEASE_NOTES_v4.5.0.md](RELEASE_NOTES_v4.5.0.md) - v4.5.0 RC release notes.
 - [RELEASE_NOTES_v4.4.0.md](RELEASE_NOTES_v4.4.0.md) - v4.4.0 release notes.
@@ -266,6 +281,7 @@ npm pack --dry-run
 - [docs/V4_5_1_GRAPH_EXPERIENCE_REPORT.md](docs/V4_5_1_GRAPH_EXPERIENCE_REPORT.md) - v4.5.1 graph experience report.
 - [docs/V4_5_1_VALIDATION_REPORT.md](docs/V4_5_1_VALIDATION_REPORT.md) - v4.5.1 validation report.
 - [docs/V4_5_1_RC_ARTIFACTS.md](docs/V4_5_1_RC_ARTIFACTS.md) - v4.5.1 screenshot, GIF, and RC artifact manifest.
+- [docs/V4_6_0_LIVING_BRAIN_EXPERIENCE_REPORT.md](docs/V4_6_0_LIVING_BRAIN_EXPERIENCE_REPORT.md) - v4.6.0 Living Brain design and validation notes.
 - [docs/V4_3_2_GRAPH_UX_REPORT.md](docs/V4_3_2_GRAPH_UX_REPORT.md) - graph UX report.
 - [docs/V4_3_2_PRODUCT_POLISH_REPORT.md](docs/V4_3_2_PRODUCT_POLISH_REPORT.md) - product polish report.
 - [docs/V4_3_2_SELF_AUDIT_REPORT.md](docs/V4_3_2_SELF_AUDIT_REPORT.md) - self-audit evidence.

package/docs/CHANGELOG.md

@@ -3,6 +3,49 @@
 The top entry is the current release-preparation target. Older entries are
 historical and may describe behavior as it existed at that release.
 
+## [4.6.0] - 2026-06-13
+
+> Living Brain Experience release after the v4.5.1 product shell reset.
+
+### Changed
+
+- Added the required first-launch product flow: Login -> Environment Analysis
+  -> Recommended Models -> Install & Load -> Brain.
+- Made Brain plus conversation the post-model-load `/app` and `/app#/brain`
+  experience.
+- Added an animated living Brain presence that reacts to listening, memory
+  recall, streaming/thinking, and agent/workflow activity.
+- Centralized chat streaming, model status, image attachment, conversation
+  history, and memory previews in a reusable Brain conversation component.
+- Reduced visible primary navigation to Brain, Memory, Files, Automations,
+  Models, and Settings;
+  `/ask` and `/chat` remain route-compatible aliases into Brain.
+- Reordered Brain layers as Brain -> Memories -> Knowledge -> Relationships ->
+  Graph, moving graph exploration to the deepest intentional layer.
+- Updated visual palette and copy so the product reads as a living digital
+  Brain rather than a graph tool or dashboard.
+- Removed the first-run dashboard/setup-card panel from the app shell; setup is
+  now a full-screen product sequence before the Brain opens.
+
+### Preserved
+
+- Brain Core, FastAPI APIs, Tauri shell, StorageEngine, backup/restore,
+  portability, model runtimes, graph/search/chat/capture/automation/system
+  workflows, and route aliases remain capability-compatible.
+
+### Validation
+
+- v4.6.0 validation scope is tracked in
+  `docs/V4_6_0_LIVING_BRAIN_EXPERIENCE_REPORT.md`.
+
+### Artifacts
+
+- `dist/ltcai-4.6.0-py3-none-any.whl`
+- `dist/ltcai-4.6.0.tar.gz`
+- `dist/ltcai-4.6.0.vsix`
+- `ltcai-4.6.0.tgz`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_4.6.0_aarch64.dmg`
+
 ## [4.5.1] - 2026-06-13
 
 > Product Reimagining release candidate after the v4.5.0 capability recovery.

package/docs/V4_6_0_LIVING_BRAIN_EXPERIENCE_REPORT.md

@@ -0,0 +1,58 @@
+# v4.6.0 Living Brain Experience Report
+
+## Goal
+
+v4.6.0 stops presenting Lattice AI as a graph product or dashboard. The
+first-run product flow is Login -> Environment Analysis -> Recommended Models
+-> Install & Load -> Brain. After setup, the Brain is the center of the desktop
+experience, and the graph is repositioned as an advanced layer for intentional
+relationship exploration.
+
+## Product Changes
+
+- First launch opens to a premium minimal Login screen only.
+- Setup runs as a full-screen guided sequence: friendly environment analysis,
+  short ranked model recommendations, and install/download/validate/load.
+- After model load, `/app` and `/app#/brain` open into Brain plus conversation.
+- The living Brain remains visible during primary conversation and reacts to
+  listening, recall, thinking, and active agent/workflow signals.
+- `/app#/ask` and `/app#/chat` remain compatible but route to the Brain
+  conversation.
+- Primary navigation is reduced to Brain, Memory, Files, Automations, Models,
+  and Settings.
+- Brain tabs now follow the product ladder: Brain, Memories, Knowledge,
+  Relationships, Graph, Care.
+- First-run setup no longer appears as dashboard cards above any app page; it
+  gates the app before the Brain opens.
+
+## Architecture
+
+- Added `frontend/src/components/LivingBrain.tsx` as the animated Brain
+  presence component.
+- Added `frontend/src/components/BrainConversation.tsx` to centralize chat
+  streaming, history, image attachment, model status, memory previews, and
+  Brain activity state.
+- Added `frontend/src/components/ProductFlow.tsx` to own Login, environment
+  analysis, recommendation, install/download/validate/load, and Brain entry.
+- Kept graph parsing, Cytoscape rendering, search, provenance, portability, and
+  archive APIs intact.
+- Kept FastAPI, Tauri, StorageEngine, Brain Core, backup/restore, and
+  portability unchanged.
+
+## Compatibility
+
+- Existing backend routes are unchanged.
+- Legacy hash routes continue to resolve through the SPA route alias table.
+- The advanced graph remains available at `/app#/knowledge-graph`.
+- The old Ask page imports the shared Brain conversation component to avoid
+  duplicate chat behavior.
+
+## Validation Scope
+
+The v4.6.0 work should be validated with:
+
+- frontend lint/typecheck/build
+- Python syntax validation
+- affected visual tests
+- unit tests covering version consistency and route compatibility
+- Tauri cargo check when the desktop toolchain is available

package/docs/V4_DIGITAL_BRAIN_RECOVERY.md

@@ -5,21 +5,21 @@
 > completed analysis. **Update this file before ending any phase and before any
 > likely session/context/usage limit.**
 >
-> Last updated: 2026-06-13 — v4.5.1 Product Reimagining RC; Remaining Gaps remain empty
+> Last updated: 2026-06-13 — v4.6.0 Living Brain Experience; Remaining Gaps remain empty
 
 ---
 
-## 0. RELEASE STATUS (v4.5.1)
+## 0. RELEASE STATUS (v4.6.0)
 
-**v4.5.1 reimagines the desktop product surface after the v4.5.0 capability
-recovery without changing Brain Core, storage, API, model runtime, backup,
-portability, or agent/workflow behavior.** Current implementation milestone:
-new Home/Ask/Add/Automate/Library/Care navigation, compact desktop chrome,
-first-session journey, command palette, responsive mobile drawer, and refreshed
-Digital Brain visual system.
-The v4.5.1 RC process builds locally validated artifacts only. Tagging, GitHub
+**v4.6.0 makes the Brain the product after the v4.5.1 product-shell reset
+without changing Brain Core, storage, API, model runtime, backup, portability,
+or agent/workflow behavior.** Current implementation milestone: Brain plus
+conversation is the home screen, the living Brain is always visible during the
+primary conversation experience, and graph exploration is preserved as the
+deepest intentional layer behind Memories, Knowledge, and Relationships.
+The v4.6.0 process builds locally validated artifacts only. Tagging, GitHub
 Release creation, PyPI, npm Registry, VS Code Marketplace, Open VSX, and
-production deployments remain out of scope for this RC.
+production deployments remain out of scope unless explicitly requested.
 Remaining implementation gaps: **none**.
 Owner-only blockers: pptx history rewrite (requires force-push/owner decision)
 and consent-gated production embedder provisioning (silent default download is
@@ -27,11 +27,12 @@ not permitted).
 
 ## Remaining Gaps
 
-None. v4.5.1 preserves the already-empty v4.3.2/v4.3.3/v4.5.0 gap list and
-promotes the product-reimagining tree: Brain graph exploration remains real and
-API-backed, readable product state remains in place, archive import/restore
-flows remain exposed through existing APIs, desktop sidecar behavior remains
-validated, and exact v4.5.1 RC artifacts are the validation target.
+None. v4.6.0 preserves the already-empty v4.3.2/v4.3.3/v4.5.0/v4.5.1 gap list
+and promotes the Living Brain tree: Brain conversation is primary, graph
+exploration remains real and API-backed, readable product state remains in
+place, archive import/restore flows remain exposed through existing APIs,
+desktop sidecar behavior remains validated, and exact v4.6.0 artifacts are the
+validation target.
 Owner-only blockers above are intentionally not implementation gaps.
 
 ## 1. Program Charter (from the user's v4.0.0 directive)

package/frontend/index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
     <meta name="color-scheme" content="dark light" />
-    <title>Lattice AI · Digital Brain</title>
+    <title>Lattice AI · Living Brain</title>
     <link rel="manifest" href="/manifest.json" />
     <link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32.png" />
     <script>
@@ -18,7 +18,7 @@
   </head>
   <body>
     <div id="root"></div>
-    <noscript>Lattice AI requires JavaScript for the local Digital Brain desktop shell.</noscript>
+    <noscript>Lattice AI requires JavaScript for the local Living Brain desktop shell.</noscript>
     <script type="module" src="/src/main.tsx"></script>
   </body>
 </html>

package/frontend/src/App.tsx

@@ -1,26 +1,19 @@
 import * as React from "react";
 import { useQuery } from "@tanstack/react-query";
-import { BrainCircuit, CheckCircle2, Command, Menu, Moon, Search, Sparkles, Sun, X } from "lucide-react";
+import { BrainCircuit, Command, Menu, Moon, Search, Sun, X } from "lucide-react";
 import { latticeApi } from "@/api/client";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
-import { FirstRunGuide } from "@/components/FirstRunGuide";
-import { useAppStore, WorkspaceMode } from "@/store/appStore";
+import { ProductFlow, readProductFlowComplete } from "@/components/ProductFlow";
+import { useAppStore } from "@/store/appStore";
 import { commandRoutes, go, parseHash, primaryRoutes, PrimaryRoute } from "@/routes";
 import { BrainPage } from "@/pages/Brain";
-import { AskPage } from "@/pages/Ask";
 import { CapturePage } from "@/pages/Capture";
 import { ActPage } from "@/pages/Act";
 import { LibraryPage } from "@/pages/Library";
 import { SystemPage } from "@/pages/System";
 import { cn } from "@/lib/utils";
 
-const modes: Array<{ id: WorkspaceMode; label: string }> = [
-  { id: "basic", label: "Calm" },
-  { id: "advanced", label: "Deep" },
-  { id: "admin", label: "Admin" },
-];
-
 function useRoute() {
   const [route, setRoute] = React.useState(parseHash);
   React.useEffect(() => {
@@ -32,7 +25,7 @@ function useRoute() {
 }
 
 function Page({ primary, tab }: { primary: PrimaryRoute; tab?: string }) {
-  if (primary === "ask") return <AskPage />;
+  if (primary === "memory") return <BrainPage initialTab="memory" />;
   if (primary === "capture") return <CapturePage initialTab={tab} />;
   if (primary === "act") return <ActPage initialTab={tab} />;
   if (primary === "library") return <LibraryPage initialTab={tab} />;
@@ -129,36 +122,19 @@ function PrimaryDock({ active, onNavigate }: { active: PrimaryRoute; onNavigate?
   );
 }
 
-function ModeSwitch({ mode, setMode }: { mode: WorkspaceMode; setMode: (mode: WorkspaceMode) => void }) {
-  return (
-    <div className="mode-switch" aria-label="Experience mode">
-      {modes.map((item) => (
-        <button
-          key={item.id}
-          className={cn(mode === item.id && "is-active")}
-          onClick={() => setMode(item.id)}
-          aria-pressed={mode === item.id}
-        >
-          {item.label}
-        </button>
-      ))}
-    </div>
-  );
-}
-
 export default function App() {
   const route = useRoute();
-  const { theme, setTheme, mode, setMode } = useAppStore();
+  const { theme, setTheme } = useAppStore();
   const [drawer, setDrawer] = React.useState(false);
   const [palette, setPalette] = React.useState(false);
-  const health = useQuery({ queryKey: ["health"], queryFn: latticeApi.health });
+  const [flowComplete, setFlowComplete] = React.useState(readProductFlowComplete);
+  const health = useQuery({ queryKey: ["health"], queryFn: latticeApi.health, enabled: flowComplete });
   const desktop = useQuery({
     queryKey: ["desktopBackendStatus"],
     queryFn: latticeApi.desktopBackendStatus,
-    enabled: Boolean(window.__TAURI_INTERNALS__),
+    enabled: flowComplete && Boolean(window.__TAURI_INTERNALS__),
     refetchInterval: 5000,
   });
-  const workspace = useQuery({ queryKey: ["workspaceOs"], queryFn: latticeApi.workspaceOs });
 
   React.useEffect(() => {
     document.documentElement.dataset.theme = theme;
@@ -175,12 +151,15 @@ export default function App() {
     return () => window.removeEventListener("keydown", onKey);
   }, []);
 
+  if (!flowComplete) {
+    return <ProductFlow onComplete={() => {
+      setFlowComplete(true);
+      go("brain");
+    }} />;
+  }
+
   const healthData = (health.data?.data || {}) as Record<string, unknown>;
-  const workspaceData = (workspace.data?.data || {}) as Record<string, unknown>;
   const desktopData = (desktop.data?.data || {}) as Record<string, unknown>;
-  const appVersion = typeof healthData.version === "string" ? healthData.version : null;
-  const activeRoute = primaryRoutes.find((item) => item.id === route.primary);
-  const workspaceName = String(workspaceData.active_workspace || "Personal space");
   const backendReady = Boolean(health.data?.ok);
   const desktopReady = !window.__TAURI_INTERNALS__ || Boolean(desktopData.running);
 
@@ -192,12 +171,12 @@ export default function App() {
       <header className="app-chrome">
         <div className="brand-lockup">
           <button className="mobile-menu" onClick={() => setDrawer(true)} aria-label="Open navigation"><Menu className="h-5 w-5" /></button>
-          <button className="brand-mark" onClick={() => go("brain")} aria-label="Open Lattice home">
+          <button className="brand-mark" onClick={() => go("brain")} aria-label="Open Lattice Brain">
             <BrainCircuit className="h-5 w-5" />
           </button>
           <div className="brand-copy">
             <div className="brand-name">Lattice</div>
-            <div className="brand-subtitle">Digital Brain</div>
+            <div className="brand-subtitle">Living Brain</div>
           </div>
         </div>
 
@@ -224,7 +203,7 @@ export default function App() {
             <div className="drawer-header">
               <div>
                 <div className="font-semibold">Lattice</div>
-                <div className="text-xs text-muted-foreground">Choose a room</div>
+                <div className="text-xs text-muted-foreground">Choose a layer</div>
               </div>
               <Button variant="ghost" size="icon" onClick={() => setDrawer(false)} aria-label="Close navigation"><X className="h-4 w-4" /></Button>
             </div>
@@ -234,24 +213,6 @@ export default function App() {
       ) : null}
 
       <main className="page-shell">
-        <section className="workspace-ribbon" aria-label="Current workspace">
-          <div className="min-w-0">
-            <div className="ribbon-kicker"><Sparkles className="h-4 w-4" /> {activeRoute?.label || "Home"}</div>
-            <h1>{activeRoute?.description || "A calm place to think with your knowledge."}</h1>
-          </div>
-          <div className="ribbon-meta">
-            <div className="meta-card">
-              <CheckCircle2 className="h-4 w-4 text-primary" />
-              <span>{workspaceName}</span>
-            </div>
-            <div className="meta-card">
-              <span>{appVersion ? `v${appVersion}` : "Version checking"}</span>
-            </div>
-            <ModeSwitch mode={mode} setMode={setMode} />
-          </div>
-        </section>
-
-        <FirstRunGuide />
         <Page primary={route.primary} tab={route.tab} />
       </main>
     </div>

package/frontend/src/api/client.ts

@@ -341,6 +341,7 @@ export const latticeApi = {
   connectFolder: (path: string) => post("/knowledge-graph/local/index", { path, approved: true, watch_enabled: true, consent: { approved: true, source: "desktop-spa" } }, {}),
   localWatchStop: (source_id: string) => post("/knowledge-graph/local/watch/stop", { source_id }, {}),
   models: () => get("/models", { catalog: [], loaded: [], recommended: [] }),
+  setupScan: () => get("/setup/scan", { environment: {}, recommendations: {}, zero_config: {} }),
   modelRecommendations: (engine = "local_mlx") => get("/models/recommendations", { profile: {}, recommendations: { models: [], families: [], counts: {} } }, { engine }),
   installEngine: (engine: string) => post("/engines/install", { engine }, {}),
   prepareModel: (model: string, engine?: string, allow_download = false) => post("/engines/prepare-model", { model, engine: engine || null, allow_download }, {}),