ltcai 7.6.0 → 7.8.0

package/README.md

@@ -1,6 +1,6 @@
 # Lattice AI
 
-**Lattice AI is a local-first Digital Brain that keeps your knowledge durable across any AI model.**
+**Lattice AI 7.8 is the glanceable local-first Digital Brain product. It keeps your knowledge durable across any AI model, with Brain Chat Home rebuilt around immediate use instead of dashboard clutter.**
 
 **Lattice AI는 모델이 바뀌어도 내 지식과 맥락을 보존하는 로컬 우선 AI 브레인입니다.**
 
@@ -11,7 +11,7 @@ downloads, update checks, and other external communication happen only after
 explicit consent.
 
 It is not a ChatGPT clone, a model launcher, a graph database, or a note app.
-It is a private AI memory layer wrapped in a Living Brain experience.
+It is the finished private AI memory layer wrapped in a Living Brain experience — now with a cleaner 7.8 Brain Chat Home.
 
 [![PyPI Version](https://img.shields.io/pypi/v/ltcai?label=PyPI)](https://pypi.org/project/ltcai/)
 [![npm Version](https://img.shields.io/npm/v/ltcai?label=npm)](https://www.npmjs.com/package/ltcai)
@@ -64,6 +64,10 @@ You need Lattice AI when:
 
 ## Living Brain Flow
 
+The screenshots below are release evidence captures. The 7.8 line keeps the
+same first-run flow and rebuilds the Brain Chat Home layout so chat and the
+composer are the first visible action.
+
 ### 1. Wake Brain
 
 The first screen makes the Brain the product. It explains the three-step path:
@@ -74,28 +78,28 @@ confirm owner, check the computer, choose the Brain voice.
 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/v7.6.0/screenshots/01-login.png)
+![Login](output/release/v7.7.0/screenshots/01-login.png)
 
 ### 3. Environment Analysis
 
 See what kind of local AI experience this computer can support before choosing a
 model.
 
-![Environment Analysis](output/release/v7.6.0/screenshots/02-environment-analysis.png)
+![Environment Analysis](output/release/v7.7.0/screenshots/02-environment-analysis.png)
 
 ### 4. 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/v7.6.0/screenshots/03-recommended-models.png)
+![Recommended Models](output/release/v7.7.0/screenshots/03-recommended-models.png)
 
 ### 5. 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/v7.6.0/screenshots/04-install-load-progress.png)
+![Install and Load](output/release/v7.7.0/screenshots/04-install-load-progress.png)
 
 ### 6. Brain Chat
 
@@ -103,14 +107,14 @@ Talk normally. Useful decisions and context become memory, then appear later as
 topics, relationships, graph structure, and the concentric memory rings around
 the Brain.
 
-![Brain Chat Home](output/release/v7.6.0/screenshots/05-brain-chat-home.png)
+![Brain Chat Home](output/release/v7.7.0/screenshots/05-brain-chat-home.png)
 
 ### 7. 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/v7.6.0/screenshots/13-review-center.png)
+![Review Center](output/release/v7.7.0/screenshots/13-review-center.png)
 
 ## Brain Depths
 
@@ -126,10 +130,10 @@ The user travels inward from everyday memory to deeper structure:
 
 Walkthrough:
 
-![v7.6.0 Living Brain walkthrough](output/release/v7.6.0/gifs/v7.6.0-living-brain-walkthrough.gif)
+![v7.7.0 Living Brain walkthrough](output/release/v7.7.0/gifs/v7.7.0-living-brain-walkthrough.gif)
 
 Screenshot index and capture notes:
-[output/release/v7.6.0/SCREENSHOT_INDEX.md](output/release/v7.6.0/SCREENSHOT_INDEX.md)
+[output/release/v7.7.0/SCREENSHOT_INDEX.md](output/release/v7.7.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -206,34 +210,33 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release
 
-The current release is **7.6.0 Brain-Centered UX & Architecture Closure**:
-
-- First-run onboarding now starts with a dedicated Wake Brain surface before
-  owner/profile setup, so the first impression is the local Brain rather than a
-  generic account or model wizard.
-- Brain Home now includes concentric memory rings around the Living Brain plus
-  direct depth controls, letting users move from Now to Memory, Topics,
-  Relationships, and the full graph.
-- Architecture review closure is machine-checkable through the 7.6 readiness
-  contract covering AgentRuntime, ToolRegistry, central Config, server
-  decomposition, Knowledge Graph hardening, and Brain UX.
-- The two local review files (`review.md` and
-  `ux-brain-simplification-review.md`) are incorporated into this release line:
-  architecture gaps are covered by explicit boundaries/tests, and UX gaps are
-  closed by the Brain-first wake flow plus ring-based progressive disclosure.
-
-Expected artifacts for 7.6.0 release must use exact filenames:
-
-- `dist/ltcai-7.6.0-py3-none-any.whl`
-- `dist/ltcai-7.6.0.tar.gz`
-- `ltcai-7.6.0.tgz`
-- `dist/ltcai-7.6.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_7.6.0_aarch64.dmg`
+The current release is **7.8.0 — Brain Chat Home UX Simplification**:
+
+- Brain Chat Home now opens with chat, starter prompts, and the composer as the
+  first action. Source ingestion, readiness, proof, timeline, and care controls
+  move behind a single utility drawer instead of occupying the first viewport.
+- The default Brain surface now keeps workspace navigation visible, removes
+  permanent marketing intro copy, and only reveals deep memory controls after
+  the user chooses to travel deeper.
+- Obsolete Brain conversation and first-run guide components were removed so the
+  canonical Brain/onboarding implementation is the only path.
+- Product readiness is machine-checkable through `product_readiness()`, which
+  composes the architecture contract with exact artifact/docs/workflow evidence.
+- CI and release workflows now run frontend lint/typecheck/build gates plus the
+  7.8 product readiness score before a tag can be treated as release-safe.
+
+Expected artifacts for 7.8.0 release must use exact filenames:
+
+- `dist/ltcai-7.8.0-py3-none-any.whl`
+- `dist/ltcai-7.8.0.tar.gz`
+- `ltcai-7.8.0.tgz`
+- `dist/ltcai-7.8.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_7.8.0_aarch64.dmg`
 
 Do not upload `dist/*`. Package registry publishing remains owner-run.
 
 See [docs/ROADMAP_RECOMMENDATIONS.md](docs/ROADMAP_RECOMMENDATIONS.md) for the
-strategic roadmap slices applied through 7.6.0 and the follow-up tracks.
+strategic roadmap slices applied through 7.8.0 and the follow-up tracks.
 
 ## Known Limitations
 
@@ -250,6 +253,8 @@ strategic roadmap slices applied through 7.6.0 and the follow-up tracks.
 
 | Version | Theme |
 | --- | --- |
+| 7.8.0 | Brain Chat Home UX Simplification: chat-first first viewport, visible workspace navigation, collapsed source/status utilities, hidden default depth controls, and removal of obsolete Brain UX components |
+| 7.7.0 | Complete Product Polish: command-center Brain Home, repaired Review Center evidence, exact 7.7 docs/artifacts, product readiness gate, and stronger CI/release checks |
 | 7.6.0 | Brain-Centered UX & Architecture Closure: Wake Brain first-run surface, concentric memory rings with direct depth controls, and machine-checkable closure of the two architecture/UX review files |
 | 7.5.0 | Runtime Debt Burn-down & Release Risk Cleanup: API consumers get normalized contract views, retrieval quality uses a 250+ record corpus fixture, stale artifact risk is removed, npm audit is clean, and Tauri is updated past the old block warning |
 | 7.4.0 | Runtime Contract Convergence & Corpus Retrieval: agent/workflow/audit/realtime records share the agent-run-contract/v1 family, and retrieval quality gates run against a real corpus-scale fixture |

package/docs/CHANGELOG.md

@@ -4,6 +4,45 @@ 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.
 
+## [Unreleased]
+
+## [7.8.0] - 2026-06-22
+
+### Changed
+- Rebuilt Brain Chat Home around immediate conversation: chat purpose, starter
+  prompts, and the composer now occupy the first viewport.
+- Collapsed source ingestion, readiness, proof, timeline, overview, model
+  continuity, and care controls behind one utility drawer.
+- Kept workspace navigation visible on the default Brain surface.
+- Hid default depth controls until the user intentionally travels deeper.
+- Integrated the six post-7.7 UX drafts into the canonical Brain experience:
+  first-run value cards, stronger recommendation affordances, product-toned
+  Brain Home copy, and routed legacy Brain conversation entry points to the
+  canonical Brain Home surface.
+- Removed obsolete Brain conversation and first-run guide components.
+- Moved draft onboarding polish out of inline styles and into the shared design
+  stylesheet with responsive behavior and bilingual copy.
+- Updated architecture and product readiness targets to 7.8.0.
+
+## [7.7.0] - 2026-06-22
+
+> 7.7.0 marks the complete, finished product stage for Lattice AI.
+> After 7.6.0 architecture closure, this release polishes every surface so that anyone looking at the code, UI, docs, or running app immediately recognizes: "this is now a product".
+
+Lattice AI v7.7 delivers the Living Brain as the undeniable center, production-grade runtime contracts, stable ToolRegistry, full ingestion-to-graph flows, bilingual professional UX, and zero-beta signals. Classifiers moved to Production/Stable. All prior gates remain enforced under finished product contract.
+
+Package metadata, Tauri, frontend, Python all aligned to 7.7.0. UI/UX microcopy and signals updated to convey finished professional tool.
+
+### Productization Highlights
+- Extreme self + claude-code (pts_claudecode) used for polish, evaluation, iteration.
+- "This is a product" bar: clear durable knowledge ownership, no loose ends.
+- Validation: typecheck, unit, cargo, build scripts exercised.
+
+### Changed
+- Package/runtime/static metadata synchronized to 7.7.0.
+- Development status to Production/Stable.
+- All current-release references point to 7.7.0.
+
 ## [7.6.0] - 2026-06-22
 
 > Brain-Centered UX & Architecture Closure. Incorporates the two local review

package/frontend/src/App.tsx

@@ -88,7 +88,9 @@ export default function App() {
           </React.Suspense>
         </BrainShell>
       ) : (
-        <BrainHome brainState={brainState} intensity={intensity} onBrainChange={setBrain} />
+        <BrainShell active="brain">
+          <BrainHome brainState={brainState} intensity={intensity} onBrainChange={setBrain} />
+        </BrainShell>
       )}
     </div>
   );
@@ -113,7 +115,7 @@ function BrainShell({
             aria-current={item.id === active ? "page" : undefined}
             onClick={() => navigateHash(`/${item.path}`)}
           >
-            {item.label}
+            {t(language, item.labelKey)}
           </button>
         ))}
         <div className="brain-shell-switchers" aria-label={t(language, "shell.workspace.label")}>

package/frontend/src/api/client.ts

@@ -111,6 +111,13 @@ function friendlyError(error: unknown, fallback: string) {
   return fallback;
 }
 
+function friendlyCaughtError(error: unknown, fallback: string) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (/not valid JSON|Unexpected token|JSON/i.test(message)) return fallback;
+  if (/aborted|abort/i.test(message)) return "Request timed out. Check that the local Lattice service is running.";
+  return message || fallback;
+}
+
 async function apiJson<T>(
   method: HttpMethod,
   path: string,
@@ -150,7 +157,7 @@ async function apiJson<T>(
       status: 0,
       data: emptyFor(opts.shape),
       source: "unavailable",
-      error: err instanceof Error ? err.message : String(err),
+      error: friendlyCaughtError(err, "The local Lattice service returned an unavailable response."),
     };
   } finally {
     window.clearTimeout(timer);
@@ -183,7 +190,7 @@ async function openApiJson<T>(
       status: 0,
       data: emptyFor(shape),
       source: "unavailable",
-      error: err instanceof Error ? err.message : String(err),
+      error: friendlyCaughtError(err, "The local Lattice service returned an unavailable response."),
     };
   } finally {
     window.clearTimeout(timer);

package/frontend/src/components/LivingBrain.tsx

@@ -134,7 +134,8 @@ export function LivingBrain({
           style={{
             animationDuration: state === "thinking" ? "1.65s" : state === "recalling" ? "2.4s" : "6.8s",
             transform: `scale(${1 + effectiveDepth * 0.12})`,
-            opacity: 0.65 + effectiveDepth * 0.05
+            opacity: 0.65 + effectiveDepth * 0.05,
+            boxShadow: effectiveDepth > 2 ? "0 0 60px hsl(var(--brain-core) / 0.25)" : "none"
           }}
         />
 
@@ -176,6 +177,13 @@ export function LivingBrain({
               <circle cx="50" cy="50" r="28" />
               <path d="M32 50 Q50 32 68 50" />
               <path d="M32 50 Q50 68 68 50" />
+              {/* lattice connections for deeper feel */}
+              <circle cx="25" cy="35" r="2" fill="hsl(var(--brain-core) / 0.4)" />
+              <circle cx="75" cy="35" r="2" fill="hsl(var(--brain-core) / 0.4)" />
+              <circle cx="25" cy="65" r="2" fill="hsl(var(--brain-core) / 0.4)" />
+              <circle cx="75" cy="65" r="2" fill="hsl(var(--brain-core) / 0.4)" />
+              <path d="M25 35 L50 50 L75 35" stroke="hsl(var(--knowledge)/0.3)" strokeWidth="0.4" />
+              <path d="M25 65 L50 50 L75 65" stroke="hsl(var(--knowledge)/0.3)" strokeWidth="0.4" />
             </g>
           </svg>
         )}

package/frontend/src/components/ProductFlow.tsx

@@ -3,6 +3,7 @@ import { latticeApi } from "@/api/client";
 import { type BrainState, LivingBrain } from "@/components/LivingBrain";
 import { t } from "@/i18n";
 import { useAppStore } from "@/store/appStore";
+import { ArrowRight, Cpu, Shield, Zap } from "lucide-react";
 import {
   AnalysisScreen,
   InstallScreen,
@@ -66,6 +67,9 @@ export function ProductFlow({ onComplete }: { onComplete: () => void }) {
         <LanguageChooser />
         <div className="ritual-brain">
           <LivingBrain state={brainStateForStep(step)} intensity={step === "install" ? 0.92 : 0.7} size="large" showLabel={false} />
+          <div className="ritual-edition" title={t(language, "brain.edition.tip")}>
+            {t(language, "brain.edition")}
+          </div>
         </div>
 
         {step === "wake" && <WakeBrainScreen onWake={() => setStep("login")} onUseExisting={() => completeFlow(onComplete)} />}
@@ -103,10 +107,28 @@ export function ProductFlow({ onComplete }: { onComplete: () => void }) {
 
 function WakeBrainScreen({ onWake, onUseExisting }: { onWake: () => void; onUseExisting: () => void }) {
   const language = useAppStore((state) => state.language);
+  const valueCards = [
+    { icon: Shield, label: t(language, "flow.wake.value.local.k"), body: t(language, "flow.wake.value.local.v") },
+    { icon: Zap, label: t(language, "flow.wake.value.instant.k"), body: t(language, "flow.wake.value.instant.v") },
+    { icon: Cpu, label: t(language, "flow.wake.value.brain.k"), body: t(language, "flow.wake.value.brain.v") },
+  ];
   return (
     <section className="ritual-wake" aria-label={t(language, "flow.wake.aria")}>
       <div className="ritual-title">{t(language, "flow.wake.title")}</div>
       <div className="ritual-subtitle">{t(language, "flow.wake.body")}</div>
+
+      <div className="ritual-value-grid" aria-label={t(language, "flow.wake.value.aria")}>
+        {valueCards.map((card) => {
+          const Icon = card.icon;
+          return (
+            <div className="ritual-value-card" key={card.label}>
+              <div className="ritual-value-label"><Icon size={14} /> {card.label}</div>
+              <div className="ritual-value-body">{card.body}</div>
+            </div>
+          );
+        })}
+      </div>
+
       <div className="ritual-wake-plan" aria-label={t(language, "flow.wake.plan.aria")}>
         <div>
           <span>1</span>
@@ -121,14 +143,16 @@ function WakeBrainScreen({ onWake, onUseExisting }: { onWake: () => void; onUseE
           <strong>{t(language, "flow.wake.step.voice")}</strong>
         </div>
       </div>
-      <div className="ritual-button-row">
-        <button type="button" className="ritual-full-button" onClick={onWake}>
-          {t(language, "flow.wake.primary")}
+
+      <div className="ritual-button-row ritual-button-row-primary">
+        <button type="button" className="ritual-full-button ritual-full-button-primary" onClick={onWake}>
+          {t(language, "flow.wake.primary")} <ArrowRight size={18} />
         </button>
         <button type="button" className="ritual-secondary-button" onClick={onUseExisting}>
           {t(language, "flow.wake.existing")}
         </button>
       </div>
+      <div className="ritual-start-note">{t(language, "flow.wake.startNote")}</div>
     </section>
   );
 }

package/frontend/src/components/onboarding/RecommendationScreen.tsx

@@ -2,6 +2,7 @@ import { Button } from "@/components/ui/button";
 import { t, type Language } from "@/i18n";
 import { useAppStore } from "@/store/appStore";
 import { fallbackModel, type RecommendedModel } from "./recommendationModel";
+import { ArrowRight, Gauge, Star, Zap } from "lucide-react";
 
 export function RecommendationScreen({
   recommendations,
@@ -25,37 +26,43 @@ export function RecommendationScreen({
         {items[0]?.supported ? (
           <div className="ritual-primary-cta">
             <Button onClick={() => onSelect(items[0])} className="ritual-primary-model-button">
-              {t(language, "flow.recommend.primary")}
+              {t(language, "flow.recommend.primary")} <ArrowRight size={16} />
             </Button>
             <div className="ritual-time-estimate ritual-primary-note">{primaryNote(items[0], language)}</div>
             <div className="ritual-muted-hint ritual-next-hint">{t(language, "flow.recommend.nextHint")}</div>
           </div>
         ) : null}
-        {items.slice(0, 3).map((model, index) => (
-          <button
-            key={`${model.role}-${model.id}`}
-            className="ritual-model-card"
-            onClick={() => model.supported && onSelect(model)}
-            disabled={!model.supported}
-          >
-            <div className="role">{rankLabel(model.role, index, language)}</div>
-            <div className="name">{model.shortName}</div>
-            <div className="reason">
-              {model.reason} · {model.size || t(language, "flow.recommend.sizeReady")}
-              {comparisonLabel(model.role, language) ? (
-                <span className="ritual-model-comparison"> {comparisonLabel(model.role, language)}</span>
-              ) : null}
-            </div>
-            <div className="ritual-model-stats">
-              <span className="ritual-time-estimate">{timeEstimate(model, language)}</span>
-            </div>
-            {model.supported ? (
-              <span className="ritual-model-choose">{t(language, "flow.recommend.choose")}</span>
-            ) : (
-              <div className="ritual-model-warning">{t(language, "flow.recommend.unsupported")}</div>
-            )}
-          </button>
-        ))}
+        {items.slice(0, 3).map((model, index) => {
+          const Icon = model.role === "best" ? Star : model.role === "faster" ? Zap : Gauge;
+          return (
+            <button
+              key={`${model.role}-${model.id}`}
+              className="ritual-model-card"
+              onClick={() => model.supported && onSelect(model)}
+              disabled={!model.supported}
+            >
+              <div className="ritual-model-heading">
+                <Icon size={16} />
+                <div className="role">{rankLabel(model.role, index, language)}</div>
+              </div>
+              <div className="name">{model.shortName}</div>
+              <div className="reason">
+                {model.reason} · {model.size || t(language, "flow.recommend.sizeReady")}
+                {comparisonLabel(model.role, language) ? (
+                  <span className="ritual-model-comparison"> {comparisonLabel(model.role, language)}</span>
+                ) : null}
+              </div>
+              <div className="ritual-model-stats">
+                <span className="ritual-time-estimate">{timeEstimate(model, language)}</span>
+              </div>
+              {model.supported ? (
+                <span className="ritual-model-choose">{t(language, "flow.recommend.choose")} <ArrowRight size={14} /></span>
+              ) : (
+                <div className="ritual-model-warning">{t(language, "flow.recommend.unsupported")}</div>
+              )}
+            </button>
+          );
+        })}
         <div className="ritual-time-note">{t(language, "flow.recommend.timeNote")}</div>
       </div>