ltcai 6.6.0 → 7.0.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.5.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.5.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.5.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.5.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.5.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.5.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.5.0 Living Brain walkthrough](output/release/v6.5.0/gifs/v6.5.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.5.0/SCREENSHOT_INDEX.md](output/release/v6.5.0/SCREENSHOT_INDEX.md)
+[output/release/v7.0.0/SCREENSHOT_INDEX.md](output/release/v7.0.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -198,34 +198,28 @@ npm run docs:check-links
 
 See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
-## Current Release Preparation
-
-The current development target is **6.6.0 Brain Proof Runtime**:
-
-- Brain Home now shows backend-owned proof that the Brain is a durable context
-  store: saved context count, active-model continuity, graph/vector depth, and
-  the most recent recallable item.
-- Brain Home now gives first-time users a direct document upload CTA in the
-  empty state and composer, backed by workspace-scoped document ingestion.
-- `/api/memory/brain-proof` combines Memory Manager readiness, unified recall,
-  graph/vector state, and the active model id so the first screen can say
-  "model changed, context stayed" without guessing in the frontend.
-- App-factory interaction wiring now passes active-model state into the Memory
-  router through typed runtime context, keeping Brain proof assembly out of the
-  monolithic factory body.
-- The release keeps the 6.4.0/6.5.0 Brain readiness and quality hardening intact
-  while making the first-five-minute value proposition visible.
-- The release remains local-first: no automatic web/email/calendar ingestion,
-  no package publishing, no production deployment, and no external reranker or
-  embedding API use without explicit opt-in.
-
-Expected artifacts for 6.6.0 release must use exact filenames:
-
-- `dist/ltcai-6.6.0-py3-none-any.whl`
-- `dist/ltcai-6.6.0.tar.gz`
-- `ltcai-6.6.0.tgz`
-- `dist/ltcai-6.6.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_6.6.0_aarch64.dmg`
+## Current Release
+
+The current release is **7.0.0 Brain Productization Loop**:
+
+- Brain Home starts with ingestion: files, folders, notes, and web pages can be
+  added directly from the first screen.
+- Every Brain answer can show memory proof and source citations instead of
+  asking users to trust an ungrounded chat bubble.
+- The model-continuity demo lets users recheck the same Brain evidence after
+  changing models.
+- The first-run loop is optimized for five minutes: add source, ask, see proof,
+  then switch or deepen.
+- CI now includes a deterministic recall/KG quality eval so the Brain proof
+  promise is guarded before release.
+
+Expected artifacts for 7.0.0 release must use exact filenames:
+
+- `dist/ltcai-7.0.0-py3-none-any.whl`
+- `dist/ltcai-7.0.0.tar.gz`
+- `ltcai-7.0.0.tgz`
+- `dist/ltcai-7.0.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_7.0.0_aarch64.dmg`
 
 Do not upload `dist/*`. Package registry publishing remains owner-run.
 
@@ -244,6 +238,8 @@ Do not upload `dist/*`. Package registry publishing remains owner-run.
 
 | Version | Theme |
 | --- | --- |
+| 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 |
 | 6.4.0 | Digital Brain Quality Hardening: workspace-scoped graph/search/memory reads and mutations, Brain quality primitives, structured context guardrails, and retrieval benchmark coverage |

package/docs/CHANGELOG.md

@@ -1,7 +1,54 @@
 # Changelog
 
-The top entry is the current release-preparation target. Older entries are
-historical and may describe behavior as it existed at that release.
+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.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,
+> separates visible product IA from legacy compatibility aliases, and
+> code-splits heavy pages out of the first Brain bundle.
+
+### Changed
+- Brain Home now exposes direct action routes for adding documents, searching
+  the knowledge graph, changing models, and opening settings, so the rich
+  Capture, Brain explorer, Library, and System pages are reachable from the
+  first Brain flow.
+- The post-onboarding app shell now mounts Capture, Brain explorer/graph,
+  Library, System, and Act pages inside a shared Brain shell navigation instead
+  of leaving those rich pages as compatibility-only routes.
+- `routes.ts` now keeps product shell routes and compatibility aliases in
+  separate maps while preserving old hash/entry URLs.
+- Rich pages now load through `React.lazy`, splitting Brain explorer, Capture,
+  Library, System, and Act chunks away from the initial Brain Home bundle.
+- Package/runtime/static metadata is synchronized to 6.7.0; package publish and
+  deployment remain owner-run only.
 
 ## [6.6.0] - 2026-06-18
 
@@ -19,6 +66,7 @@ historical and may describe behavior as it existed at that release.
   bring back after a useful exchange.
 - Brain Home document upload CTA in the empty state and composer, giving the
   first session a direct way to grow the Brain with files.
+- Refreshed README-linked release evidence under `output/release/v6.6.0/`.
 - Unit coverage for model-independent Brain proof recall behavior.
 - Honest empty-state Brain proof: model-independent capability remains visible,
   but continuity is only marked proven after durable evidence exists.

package/frontend/src/App.tsx

@@ -2,11 +2,16 @@ import * as React from "react";
 import { type BrainState } from "@/components/LivingBrain";
 import { ProductFlow, readProductFlowComplete } from "@/components/ProductFlow";
 import { useAppStore } from "@/store/appStore";
-import { parseHash } from "@/routes";
-import { ActPage } from "@/pages/Act";
+import { parseHash, productShellRoutes } from "@/routes";
 import { BrainHome } from "@/features/brain/BrainHome";
 import { AdminConsole } from "@/features/admin/AdminConsole";
 
+const ActPage = React.lazy(() => import("@/pages/Act").then((module) => ({ default: module.ActPage })));
+const BrainPage = React.lazy(() => import("@/pages/Brain").then((module) => ({ default: module.BrainPage })));
+const CapturePage = React.lazy(() => import("@/pages/Capture").then((module) => ({ default: module.CapturePage })));
+const LibraryPage = React.lazy(() => import("@/pages/Library").then((module) => ({ default: module.LibraryPage })));
+const SystemPage = React.lazy(() => import("@/pages/System").then((module) => ({ default: module.SystemPage })));
+
 export default function App() {
   const theme = useAppStore((state) => state.theme);
   const language = useAppStore((state) => state.language);
@@ -41,7 +46,41 @@ export default function App() {
       {rawRoute.startsWith("/admin") ? (
         <AdminConsole onBack={() => navigateHash("/brain")} />
       ) : parsed.primary === "act" ? (
-        <ActPage initialTab={parsed.tab} />
+        <BrainShell active={parsed.primary}>
+          <React.Suspense fallback={<PageLoader />}>
+            <ActPage initialTab={parsed.tab} />
+          </React.Suspense>
+        </BrainShell>
+      ) : parsed.primary === "capture" ? (
+        <BrainShell active={parsed.primary}>
+          <React.Suspense fallback={<PageLoader />}>
+            <CapturePage initialTab={parsed.tab} />
+          </React.Suspense>
+        </BrainShell>
+      ) : parsed.primary === "library" ? (
+        <BrainShell active={parsed.primary}>
+          <React.Suspense fallback={<PageLoader />}>
+            <LibraryPage initialTab={parsed.tab} />
+          </React.Suspense>
+        </BrainShell>
+      ) : parsed.primary === "system" ? (
+        <BrainShell active={parsed.primary}>
+          <React.Suspense fallback={<PageLoader />}>
+            <SystemPage initialTab={parsed.tab} />
+          </React.Suspense>
+        </BrainShell>
+      ) : parsed.primary === "memory" ? (
+        <BrainShell active="memory">
+          <React.Suspense fallback={<PageLoader />}>
+            <BrainPage initialTab="memory" />
+          </React.Suspense>
+        </BrainShell>
+      ) : parsed.primary === "brain" && parsed.tab && parsed.tab !== "conversation" ? (
+        <BrainShell active="brain">
+          <React.Suspense fallback={<PageLoader />}>
+            <BrainPage initialTab={parsed.tab} />
+          </React.Suspense>
+        </BrainShell>
       ) : (
         <BrainHome brainState={brainState} intensity={intensity} onBrainChange={setBrain} />
       )}
@@ -49,6 +88,42 @@ export default function App() {
   );
 }
 
+function BrainShell({
+  active,
+  children,
+}: {
+  active: string;
+  children: React.ReactNode;
+}) {
+  return (
+    <main className="brain-shell-page" aria-label="Lattice workspace">
+      <nav className="brain-shell-nav" aria-label="Brain workspace navigation">
+        {productShellRoutes.map((item) => (
+          <button
+            key={item.id}
+            type="button"
+            className={item.id === active ? "is-active" : ""}
+            onClick={() => navigateHash(`/${item.path}`)}
+          >
+            {item.label}
+          </button>
+        ))}
+      </nav>
+      <section className="brain-shell-content">
+        {children}
+      </section>
+    </main>
+  );
+}
+
+function PageLoader() {
+  return (
+    <div className="brain-shell-loader" role="status">
+      Loading Brain workspace...
+    </div>
+  );
+}
+
 function useHashRoute() {
   const read = React.useCallback(() => {
     const hash = window.location.hash.replace(/^#/, "");

package/frontend/src/api/client.ts

@@ -444,6 +444,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/features/brain/BrainConversation.tsx

@@ -1,5 +1,5 @@
 import * as React from "react";
-import { DatabaseZap, ShieldCheck } from "lucide-react";
+import { Cpu, DatabaseZap, FileText, FileUp, FolderPlus, Globe2, Repeat2, Search, Settings, ShieldCheck } from "lucide-react";
 import { LanguageSwitcher } from "@/components/LanguageSwitcher";
 import { t, type Language } from "@/i18n";
 import type { BrainDepth, BrainProof, BrainReadiness, KnowledgeConcept, MemoryFragment, Message } from "./types";
@@ -27,6 +27,10 @@ export function BrainConversation({
   onDraftChange,
   onImageDataChange,
   onUploadDocument,
+  onConnectFolder,
+  onIngestNote,
+  onIngestWeb,
+  onVerifyModelContinuity,
   onSend,
 }: {
   language: Language;
@@ -48,6 +52,10 @@ export function BrainConversation({
   onDraftChange: (value: string) => void;
   onImageDataChange: (value: string | null) => void;
   onUploadDocument: (file: File) => void;
+  onConnectFolder: (path: string) => void;
+  onIngestNote: (note: string) => void;
+  onIngestWeb: (url: string) => void;
+  onVerifyModelContinuity: () => void;
   onSend: () => void;
 }) {
   return (
@@ -63,7 +71,25 @@ export function BrainConversation({
           <span>{t(language, "brain.portable")}</span>
           <span>{t(language, "brain.private")}</span>
         </div>
-        <div>{modelName}</div>
+        <div className="brain-flow-actions" aria-label={t(language, "brain.aria.actions")}>
+          <button type="button" onClick={() => navigateHash("/capture")}>
+            <FileUp className="h-3.5 w-3.5" />
+            {t(language, "brain.action.add")}
+          </button>
+          <button type="button" onClick={() => navigateHash("/knowledge-graph")}>
+            <Search className="h-3.5 w-3.5" />
+            {t(language, "brain.action.find")}
+          </button>
+          <button type="button" onClick={() => navigateHash("/models")}>
+            <Cpu className="h-3.5 w-3.5" />
+            {t(language, "brain.action.model")}
+          </button>
+          <button type="button" onClick={() => navigateHash("/settings")}>
+            <Settings className="h-3.5 w-3.5" />
+            {t(language, "brain.action.settings")}
+          </button>
+        </div>
+        <div className="brain-model-pill">{modelName}</div>
         <button className="brain-admin-link" type="button" onClick={() => navigateHash("/admin")}>
           <ShieldCheck className="h-3.5 w-3.5" />
           {t(language, "brain.admin")}
@@ -71,6 +97,14 @@ export function BrainConversation({
       </div>
 
       <div ref={streamRef} className="brain-stream">
+        <BrainIngestionPanel
+          language={language}
+          uploadingDocument={uploadingDocument}
+          onUploadDocument={onUploadDocument}
+          onConnectFolder={onConnectFolder}
+          onIngestNote={onIngestNote}
+          onIngestWeb={onIngestWeb}
+        />
         <BrainOverviewPanel
           memories={memories}
           concepts={concepts}
@@ -78,6 +112,12 @@ export function BrainConversation({
           proof={proof}
           onOpenDepth={onOpenDepth}
         />
+        <ModelContinuityDemo
+          language={language}
+          proof={proof}
+          modelName={modelName}
+          onVerify={onVerifyModelContinuity}
+        />
         {messages.length === 0 ? (
           <BrainEmptyState
             language={language}
@@ -90,6 +130,9 @@ export function BrainConversation({
           messages.map((message, index) => (
             <div key={`${message.role}-${index}`} className={`brain-message ${message.role}`}>
               <div className="brain-message-bubble">{message.content}</div>
+              {message.role === "assistant" && message.proof ? (
+                <AnswerProofCard language={language} proof={message.proof} />
+              ) : null}
             </div>
           ))
         )}
@@ -120,6 +163,143 @@ export function BrainConversation({
   );
 }
 
+function BrainIngestionPanel({
+  language,
+  uploadingDocument,
+  onUploadDocument,
+  onConnectFolder,
+  onIngestNote,
+  onIngestWeb,
+}: {
+  language: Language;
+  uploadingDocument: boolean;
+  onUploadDocument: (file: File) => void;
+  onConnectFolder: (path: string) => void;
+  onIngestNote: (note: string) => void;
+  onIngestWeb: (url: string) => void;
+}) {
+  const [folderPath, setFolderPath] = React.useState("");
+  const [note, setNote] = React.useState("");
+  const [url, setUrl] = React.useState("");
+
+  return (
+    <section className="brain-ingestion-panel" aria-label={t(language, "brain.ingest.aria")}>
+      <div className="brain-ingestion-head">
+        <span>{t(language, "brain.ingest.kicker")}</span>
+        <strong>{t(language, "brain.ingest.title")}</strong>
+      </div>
+      <div className="brain-ingestion-grid">
+        <label className={`brain-ingest-tile is-primary ${uploadingDocument ? "is-disabled" : ""}`}>
+          <FileUp className="h-4 w-4" />
+          <span>{uploadingDocument ? t(language, "brain.upload.uploading") : t(language, "brain.ingest.file")}</span>
+          <small>{t(language, "brain.ingest.file.detail")}</small>
+          <input
+            type="file"
+            accept=".pdf,.docx,.xlsx,.pptx,.txt,.md,.csv,application/pdf,text/plain,text/markdown,text/csv"
+            className="sr-only"
+            disabled={uploadingDocument}
+            onChange={(event) => {
+              const file = event.target.files?.[0];
+              event.currentTarget.value = "";
+              if (file) onUploadDocument(file);
+            }}
+          />
+        </label>
+        <form
+          className="brain-ingest-tile"
+          onSubmit={(event) => {
+            event.preventDefault();
+            onConnectFolder(folderPath);
+            setFolderPath("");
+          }}
+        >
+          <FolderPlus className="h-4 w-4" />
+          <span>{t(language, "brain.ingest.folder")}</span>
+          <input value={folderPath} onChange={(event) => setFolderPath(event.target.value)} placeholder={t(language, "brain.ingest.folder.placeholder")} />
+        </form>
+        <form
+          className="brain-ingest-tile"
+          onSubmit={(event) => {
+            event.preventDefault();
+            onIngestNote(note);
+            setNote("");
+          }}
+        >
+          <FileText className="h-4 w-4" />
+          <span>{t(language, "brain.ingest.note")}</span>
+          <input value={note} onChange={(event) => setNote(event.target.value)} placeholder={t(language, "brain.ingest.note.placeholder")} />
+        </form>
+        <form
+          className="brain-ingest-tile"
+          onSubmit={(event) => {
+            event.preventDefault();
+            onIngestWeb(url);
+            setUrl("");
+          }}
+        >
+          <Globe2 className="h-4 w-4" />
+          <span>{t(language, "brain.ingest.web")}</span>
+          <input value={url} onChange={(event) => setUrl(event.target.value)} placeholder={t(language, "brain.ingest.web.placeholder")} />
+        </form>
+      </div>
+    </section>
+  );
+}
+
+function ModelContinuityDemo({
+  language,
+  proof,
+  modelName,
+  onVerify,
+}: {
+  language: Language;
+  proof: BrainProof;
+  modelName: string;
+  onVerify: () => void;
+}) {
+  return (
+    <section className="brain-model-demo" aria-label={t(language, "brain.modelDemo.aria")}>
+      <div>
+        <span>{t(language, "brain.modelDemo.kicker")}</span>
+        <strong>{proof.modelContinuity.proven ? t(language, "brain.modelDemo.proven") : t(language, "brain.modelDemo.pending")}</strong>
+        <small>{t(language, "brain.modelDemo.detail", { model: proof.modelContinuity.activeModel || modelName })}</small>
+      </div>
+      <button type="button" onClick={onVerify}>
+        <Repeat2 className="h-3.5 w-3.5" />
+        {t(language, "brain.modelDemo.verify")}
+      </button>
+      <button type="button" onClick={() => navigateHash("/models")}>
+        <Cpu className="h-3.5 w-3.5" />
+        {t(language, "brain.modelDemo.change")}
+      </button>
+    </section>
+  );
+}
+
+function AnswerProofCard({ language, proof }: { language: Language; proof: NonNullable<Message["proof"]> }) {
+  return (
+    <div className="brain-answer-proof" aria-label={t(language, "brain.answerProof.aria")}>
+      <div className="brain-answer-proof-head">
+        <span>{t(language, "brain.answerProof.title")}</span>
+        <strong>{proof.provenAcrossModels ? t(language, "brain.answerProof.modelProven", { model: proof.model }) : t(language, "brain.answerProof.modelPending", { model: proof.model })}</strong>
+      </div>
+      {proof.citations.length ? (
+        <ol>
+          {proof.citations.map((citation) => (
+            <li key={citation.id}>
+              <span>{citation.source}</span>
+              <strong>{citation.title}</strong>
+              <small>{citation.snippet || proof.query}</small>
+            </li>
+          ))}
+        </ol>
+      ) : (
+        <small>{t(language, "brain.answerProof.empty")}</small>
+      )}
+    </div>
+  );
+}
+
 function BrainEmptyState({
   language,
   starterPrompts,