ltcai 6.7.0 → 7.1.0

package/README.md

@@ -69,42 +69,42 @@ You need Lattice AI when:
 Choose the owner of the Brain. The profile is not a SaaS account by default; it
 is the local identity for the knowledge you keep.
 
-![Login](output/release/v6.7.0/screenshots/01-login.png)
+![Login](output/release/v7.0.0/screenshots/01-login.png)
 
 ### 2. Environment Analysis
 
 See what kind of local AI experience this computer can support before choosing a
 model.
 
-![Environment Analysis](output/release/v6.7.0/screenshots/02-environment-analysis.png)
+![Environment Analysis](output/release/v7.0.0/screenshots/02-environment-analysis.png)
 
 ### 3. Recommended Models
 
 Start with a short list: safest recommendation, faster model, stronger model.
 Advanced details stay available without overwhelming first-time users.
 
-![Recommended Models](output/release/v6.7.0/screenshots/03-recommended-models.png)
+![Recommended Models](output/release/v7.0.0/screenshots/03-recommended-models.png)
 
 ### 4. Install And Load
 
 Download and load only after consent. Lattice explains model size, local
 execution, and network use before work starts.
 
-![Install and Load](output/release/v6.7.0/screenshots/04-install-load-progress.png)
+![Install and Load](output/release/v7.0.0/screenshots/04-install-load-progress.png)
 
 ### 5. Brain Chat
 
 Talk normally. Useful decisions and context become memory, then appear later as
 topics, relationships, and graph structure.
 
-![Brain Chat Home](output/release/v6.7.0/screenshots/05-brain-chat-home.png)
+![Brain Chat Home](output/release/v7.0.0/screenshots/05-brain-chat-home.png)
 
 ### 6. Review Center
 
 Automation results are staged for review before they become durable decisions.
 Snooze, unsnooze, run now, approve, and dismiss actions stay explicit.
 
-![Review Center](output/release/v6.7.0/screenshots/13-review-center.png)
+![Review Center](output/release/v7.0.0/screenshots/13-review-center.png)
 
 ## Brain Depths
 
@@ -120,10 +120,10 @@ The user travels inward from everyday memory to deeper structure:
 
 Walkthrough:
 
-![v6.7.0 Living Brain walkthrough](output/release/v6.7.0/gifs/v6.7.0-living-brain-walkthrough.gif)
+![v7.0.0 Living Brain walkthrough](output/release/v7.0.0/gifs/v7.0.0-living-brain-walkthrough.gif)
 
 Screenshot index and capture notes:
-[output/release/v6.7.0/SCREENSHOT_INDEX.md](output/release/v6.7.0/SCREENSHOT_INDEX.md)
+[output/release/v7.0.0/SCREENSHOT_INDEX.md](output/release/v7.0.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -200,29 +200,25 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release
 
-The current release is **6.7.0 Brain IA Cleanup**:
-
-- Brain Home now surfaces direct actions for adding documents, searching the
-  graph, changing models, and opening settings.
-- The rich Capture, Brain explorer, Library, System, and Act pages are mounted
-  inside a shared Brain shell instead of existing only as hard-to-discover
-  compatibility routes.
-- `routes.ts` now separates product shell routes from legacy compatibility
-  aliases, so visible IA and old entry URLs can evolve independently.
-- Rich pages are code-split with lazy route loading. The first Brain Home bundle
-  stays below the previous warning threshold while graph/search/model/settings
-  surfaces load when opened.
-- The release keeps the 6.6.0 backend-owned Brain proof loop and
-  workspace-scoped ingestion intact while making the product actions more
-  obvious in the first five minutes.
-
-Expected artifacts for 6.7.0 release must use exact filenames:
-
-- `dist/ltcai-6.7.0-py3-none-any.whl`
-- `dist/ltcai-6.7.0.tar.gz`
-- `ltcai-6.7.0.tgz`
-- `dist/ltcai-6.7.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_6.7.0_aarch64.dmg`
+The current release is **7.1.0 Brain Usability Completion**:
+
+- First-run onboarding now explains detected hardware, recommendation timing,
+  install progress, and the next action in plain language.
+- Brain Home shows ingestion progress for files, folders, notes, and web pages,
+  including memory emergence after content lands.
+- Knowledge Graph exploration adds search suggestions, type filters, time
+  exploration, focus movement, and neighbor highlighting.
+- Chat answers surface inline source citations and accessible proof payloads.
+- Workspace/profile/admin entry points, empty/error feedback, consent revoke
+  feedback, and VS Code extension sync status are visible in the product shell.
+
+Expected artifacts for 7.1.0 release must use exact filenames:
+
+- `dist/ltcai-7.1.0-py3-none-any.whl`
+- `dist/ltcai-7.1.0.tar.gz`
+- `ltcai-7.1.0.tgz`
+- `dist/ltcai-7.1.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_7.1.0_aarch64.dmg`
 
 Do not upload `dist/*`. Package registry publishing remains owner-run.
 
@@ -241,6 +237,8 @@ Do not upload `dist/*`. Package registry publishing remains owner-run.
 
 | Version | Theme |
 | --- | --- |
+| 7.1.0 | Brain Usability Completion: clearer first-run onboarding, ingestion progress/emergence, richer graph controls, inline answer proof, workspace/profile/admin discovery, empty/error/consent feedback, and VS Code sync status |
+| 7.0.0 | Brain Productization Loop: first-screen ingestion for files/folders/notes/web, answer-level memory proof and source citations, model-continuity demo flow, five-minute first-run loop, and recall/KG quality eval in CI |
 | 6.7.0 | Brain IA Cleanup: reachable rich pages, separated product routes vs compatibility aliases, shared Brain shell navigation, and lazy-loaded rich pages |
 | 6.6.0 | Brain Proof Runtime: backend-owned Brain proof API, model-continuity wiring, first-screen proof that saved context can be recalled across model changes, and direct Brain Home document upload |
 | 6.5.0 | Brain Experience Readiness: Brain readiness signal, depth progress rail, source-aware memory-save feedback, and visual coverage for the first-memory loop |

package/docs/CHANGELOG.md

@@ -4,6 +4,54 @@ The top entry is either the current unreleased main-branch work or the current
 release line. Older entries are historical and may describe behavior as it
 existed at that release.
 
+## [7.1.0] - 2026-06-20
+
+> Brain Usability Completion. Completes the 7.1.0 first-run through editor-sync
+> usability pass: clear onboarding, visible ingestion, graph controls, inline
+> proof, workspace/admin discovery, feedback states, and VS Code sync status.
+
+### Added
+- Hardware visualization, expected timing, install timeline, and next-action
+  copy in first-run onboarding.
+- Brain Home ingestion stage disclosure and memory emergence timeline for file,
+  folder, note, and URL sources.
+- Knowledge Graph search suggestions, entity type filters, recent/all-time time
+  exploration, focus clearing, and neighbor highlighting.
+- Inline answer citation markers with keyboard-accessible proof cards.
+- Workspace/profile switcher, Admin Console gate, consent revoke feedback, and
+  shared empty/error feedback surfaces in the Brain shell.
+- VS Code extension heartbeat/status endpoint plus extension and main-app sync
+  indicators for connected/indexing/synced/offline states.
+
+### Changed
+- Package/runtime/static metadata is synchronized to 7.1.0; package publish and
+  deployment remain owner-run only.
+
+## [7.0.0] - 2026-06-18
+
+> Brain Productization Loop. Turns the Brain proof work into a first-five-minute
+> product flow: add sources, ask a question, see proof/citations, and verify the
+> same Brain evidence after switching models.
+
+### Added
+- Brain Home ingestion panel for files, local folder paths, notes, and web URLs,
+  all backed by existing workspace-scoped ingestion routes.
+- Answer-level Memory proof and source citation cards rendered under assistant
+  responses after Brain proof refreshes for the user's query.
+- Model-continuity demo strip that lets the user recheck the same Brain
+  evidence and jump to model switching from the Brain flow.
+- Deterministic `scripts/brain_quality_eval.py` recall/KG quality gate, wired
+  into CI after the unit suite.
+- Visual mock coverage for Brain proof, document upload, note ingest, folder
+  indexing, and web URL ingestion endpoints.
+
+### Changed
+- Brain Home is now ingestion-first instead of chat-first: first screen action
+  labels are files/folders/notes/web, with deeper graph/model/settings still
+  reachable from the shell.
+- Package/runtime/static metadata is synchronized to 7.0.0; package publish and
+  deployment remain owner-run only.
+
 ## [6.7.0] - 2026-06-18
 
 > Brain IA Cleanup. Makes rich product pages reachable from Brain Home,

package/frontend/src/App.tsx

@@ -5,6 +5,12 @@ import { useAppStore } from "@/store/appStore";
 import { parseHash, productShellRoutes } from "@/routes";
 import { BrainHome } from "@/features/brain/BrainHome";
 import { AdminConsole } from "@/features/admin/AdminConsole";
+import { WorkspaceProfileSwitcher } from "@/components/WorkspaceProfileSwitcher";
+import { AdminAccessGate } from "@/components/AdminAccessGate";
+import { t, type Language } from "@/i18n";
+import { latticeApi } from "@/api/client";
+import { useQuery } from "@tanstack/react-query";
+import { FeedbackState } from "@/components/FeedbackState";
 
 const ActPage = React.lazy(() => import("@/pages/Act").then((module) => ({ default: module.ActPage })));
 const BrainPage = React.lazy(() => import("@/pages/Brain").then((module) => ({ default: module.BrainPage })));
@@ -95,6 +101,7 @@ function BrainShell({
   active: string;
   children: React.ReactNode;
 }) {
+  const language = useAppStore((state) => state.language);
   return (
     <main className="brain-shell-page" aria-label="Lattice workspace">
       <nav className="brain-shell-nav" aria-label="Brain workspace navigation">
@@ -103,19 +110,92 @@ function BrainShell({
             key={item.id}
             type="button"
             className={item.id === active ? "is-active" : ""}
+            aria-current={item.id === active ? "page" : undefined}
             onClick={() => navigateHash(`/${item.path}`)}
           >
             {item.label}
           </button>
         ))}
+        <div className="brain-shell-switchers" aria-label={t(language, "shell.workspace.label")}>
+          <VsCodeSyncStatus language={language} />
+          <WorkspaceProfileSwitcher language={language} />
+          <AdminAccessGate language={language} />
+        </div>
       </nav>
       <section className="brain-shell-content">
+        <ExternalConsentStatus language={language} />
         {children}
       </section>
     </main>
   );
 }
 
+function ExternalConsentStatus({ language }: { language: Language }) {
+  const externalConsent = useAppStore((state) => state.externalConsent);
+  const setExternalConsent = useAppStore((state) => state.setExternalConsent);
+
+  return (
+    <section className="external-consent-status" aria-label={t(language, "feedback.consent.aria")}>
+      <FeedbackState
+        tone={externalConsent ? "empty" : "error"}
+        language={language}
+        title={externalConsent ? t(language, "feedback.consent.activeTitle") : t(language, "feedback.consent.revokedTitle")}
+        body={externalConsent ? t(language, "feedback.consent.activeBody") : t(language, "feedback.consent.revokedBody")}
+        actionLabel={externalConsent ? t(language, "feedback.consent.revoke") : t(language, "feedback.consent.reenable")}
+        onAction={() => setExternalConsent(!externalConsent)}
+      />
+    </section>
+  );
+}
+
+function VsCodeSyncStatus({ language }: { language: Language }) {
+  const bridge = useQuery({
+    queryKey: ["workspaceVscodeStatus"],
+    queryFn: latticeApi.workspaceVscodeStatus,
+    refetchInterval: 15000,
+  });
+  const index = useQuery({
+    queryKey: ["index"],
+    queryFn: latticeApi.indexStatus,
+    refetchInterval: 15000,
+  });
+  const data = bridge.data?.data as Record<string, unknown> | undefined;
+  const lastSeen = Number(data?.last_seen_ms || 0);
+  const connected = Boolean(data?.connected) || (lastSeen > 0 && Date.now() - lastSeen < 60000);
+  const indexData = index.data?.data as Record<string, unknown> | undefined;
+  const indexStatus = String(indexData?.status || indexData?.state || "");
+  const indexing = /index|build|running|pending/i.test(indexStatus);
+  const state = bridge.isLoading
+    ? "checking"
+    : !connected
+      ? "offline"
+      : indexing
+        ? "indexing"
+        : "synced";
+  const labelKey = `shell.sync.${state}`;
+  const detail = connected
+    ? t(language, "shell.sync.detail")
+    : t(language, "shell.sync.detailOffline");
+
+  return (
+    <button
+      type="button"
+      className={`vscode-sync-status is-${state}`}
+      aria-label={`${t(language, "shell.sync.label")}: ${t(language, labelKey)}`}
+      title={`${t(language, "shell.sync.label")}: ${t(language, labelKey)}\n${detail}`}
+      onClick={() => {
+        window.location.hash = "/settings";
+      }}
+    >
+      <span className="vscode-sync-dot" aria-hidden="true" />
+      <span className="vscode-sync-copy">
+        <strong>{t(language, "shell.sync.label")}</strong>
+        <small>{t(language, labelKey)}</small>
+      </span>
+    </button>
+  );
+}
+
 function PageLoader() {
   return (
     <div className="brain-shell-loader" role="status">

package/frontend/src/api/client.ts

@@ -416,6 +416,12 @@ export const latticeApi = {
   },
   health: () => get("/health", {}),
   workspaceOs: () => get("/workspace/os", { counts: {}, models: {}, workspace_registry: { workspaces: [] } }),
+  workspaceVscodeStatus: () => get("/workspace/vscode/status", {
+    connected: false,
+    last_seen_ms: 0,
+    status: "offline",
+    index_status: "unknown",
+  }),
   indexStatus: () => get("/api/index/status", {}),
   rebuildIndex: () => post("/api/index/rebuild", { full: false, include_nodes: true, include_chunks: true }, {}),
   graph: () => get("/knowledge-graph/graph", { nodes: [], edges: [] }),
@@ -444,6 +450,11 @@ export const latticeApi = {
     return res;
   },
   browserReadUrl: (url: string) => post("/api/browser/read-url", { url }, {}),
+  ingestNote: (content: string, title = "Brain note") => post(
+    "/knowledge-graph/ingest",
+    { type: "note", content, title, source: "brain_home" },
+    {},
+  ),
   memoryManager: () => get("/api/memory/manager", { sources: [], tiers: [], usage: {} }),
   memoryBrainQuality: () => get("/api/memory/brain-quality", {}),
   memoryBrainProof: (query = "", limit = 3) => get("/api/memory/brain-proof", { proofs: {}, recall: { items: [] }, model_continuity: {}, claims: {} }, { q: query, limit }),

package/frontend/src/components/AdminAccessGate.tsx

@@ -0,0 +1,70 @@
+import * as React from "react";
+import { ShieldCheck, Lock } from "lucide-react";
+import { t, type Language } from "@/i18n";
+import { useAppStore, type WorkspaceMode } from "@/store/appStore";
+
+const MODES: WorkspaceMode[] = ["basic", "advanced", "admin"];
+
+/**
+ * Role-aware admin entry point for the Brain shell.
+ *
+ * Mode is the access proxy used across the app (SystemPage gates the admin
+ * tab and AdminPanel on `mode`). When the user is in advanced/admin mode we
+ * surface a discoverable Admin Console button plus a compact mode switcher.
+ * In basic mode the console is hidden behind an explained affordance that
+ * promotes the user to admin mode rather than failing silently.
+ */
+export function AdminAccessGate({ language }: { language: Language }) {
+  const mode = useAppStore((state) => state.mode);
+  const setMode = useAppStore((state) => state.setMode);
+  const canSeeAdmin = mode === "advanced" || mode === "admin";
+
+  return (
+    <div className="admin-access-gate">
+      {canSeeAdmin ? (
+        <button
+          type="button"
+          className="admin-access-button"
+          title={t(language, "shell.admin.tooltip")}
+          aria-label={t(language, "shell.admin.open")}
+          onClick={() => {
+            window.location.hash = "/admin";
+          }}
+        >
+          <ShieldCheck className="h-3.5 w-3.5" aria-hidden="true" />
+          <span>{t(language, "shell.admin.label")}</span>
+        </button>
+      ) : (
+        <button
+          type="button"
+          className="admin-access-button is-locked"
+          title={t(language, "shell.admin.needsMode")}
+          aria-label={t(language, "shell.admin.needsMode")}
+          onClick={() => setMode("admin")}
+        >
+          <Lock className="h-3.5 w-3.5" aria-hidden="true" />
+          <span>{t(language, "shell.admin.enable")}</span>
+        </button>
+      )}
+
+      <div
+        className="mode-switcher-mini"
+        role="group"
+        aria-label={t(language, "shell.mode.label")}
+        title={t(language, "shell.mode.info")}
+      >
+        {MODES.map((item) => (
+          <button
+            key={item}
+            type="button"
+            className={mode === item ? "is-active" : ""}
+            aria-pressed={mode === item}
+            onClick={() => setMode(item)}
+          >
+            {t(language, `shell.mode.${item}`)}
+          </button>
+        ))}
+      </div>
+    </div>
+  );
+}