ltcai 7.7.0 → 7.9.0

package/README.md

@@ -1,6 +1,6 @@
 # Lattice AI
 
-**Lattice AI 7.7 is the complete, finished local-first Digital Brain product. It keeps your knowledge durable across any AI model — now undeniably a production-grade professional tool.**
+**Lattice AI 7.9 is the local-first Digital Brain product with cleaner runtime boundaries. It keeps your knowledge durable across any AI model, with Brain Chat Home ready for immediate use and agent execution hardened behind explicit runtime ports.**
 
 **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 the finished private AI memory layer wrapped in a Living Brain experience — 7.7 complete product.
+It is the finished private AI memory layer wrapped in a Living Brain experience — now with a clearer 7.9 agent-runtime boundary.
 
 [![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.9 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.7.0/screenshots/01-login.png)
+![Login](output/release/v7.8.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.7.0/screenshots/02-environment-analysis.png)
+![Environment Analysis](output/release/v7.8.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.7.0/screenshots/03-recommended-models.png)
+![Recommended Models](output/release/v7.8.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.7.0/screenshots/04-install-load-progress.png)
+![Install and Load](output/release/v7.8.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.7.0/screenshots/05-brain-chat-home.png)
+![Brain Chat Home](output/release/v7.8.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.7.0/screenshots/13-review-center.png)
+![Review Center](output/release/v7.8.0/screenshots/13-review-center.png)
 
 ## Brain Depths
 
@@ -126,10 +130,10 @@ The user travels inward from everyday memory to deeper structure:
 
 Walkthrough:
 
-![v7.7.0 Living Brain walkthrough](output/release/v7.7.0/gifs/v7.7.0-living-brain-walkthrough.gif)
+![v7.8.0 Living Brain walkthrough](output/release/v7.8.0/gifs/v7.8.0-living-brain-walkthrough.gif)
 
 Screenshot index and capture notes:
-[output/release/v7.7.0/SCREENSHOT_INDEX.md](output/release/v7.7.0/SCREENSHOT_INDEX.md)
+[output/release/v7.8.0/SCREENSHOT_INDEX.md](output/release/v7.8.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -206,30 +210,36 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release
 
-The current release is **7.7.0 — Complete Finished Product**:
-
-- Brain Home now opens with a product command center: readiness score, next best
-  action, memory/topic/source/proof metrics, and direct actions for adding
-  sources, inspecting topics, verifying proof, and managing ownership.
-- Review Center release evidence is backed by fixtures and tests, with polished
-  unavailable states instead of raw JSON parse errors.
+The current release is **7.9.0 — Agent Runtime Boundary Hardening**:
+
+- The single-agent state machine is now named `SingleAgentRuntime`, while the
+  historical `AgentRuntime` import remains as a compatibility alias.
+- The product AgentRuntime facade in `lattice_brain.runtime.agent_runtime`
+  remains the unambiguous `/agents` execution and observability boundary.
+- Agent rollback is now an injected runtime port wired through
+  `ToolDispatchService`, so the core state machine no longer shells out directly.
+- Both runtime surfaces expose a `runtime-boundary/v1` descriptor so tests and
+  API clients can identify the owning execution boundary without relying on
+  ambiguous class names.
+- A shared `RuntimeBoundaryProtocol` now fixes the common inspection surface
+  while letting each runtime keep its own execution methods.
 - 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.7 product readiness score before a tag can be treated as release-safe.
+  7.9 product readiness score before a tag can be treated as release-safe.
 
-Expected artifacts for 7.7.0 release must use exact filenames:
+Expected artifacts for 7.9.0 release must use exact filenames:
 
-- `dist/ltcai-7.7.0-py3-none-any.whl`
-- `dist/ltcai-7.7.0.tar.gz`
-- `ltcai-7.7.0.tgz`
-- `dist/ltcai-7.7.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_7.7.0_aarch64.dmg`
+- `dist/ltcai-7.9.0-py3-none-any.whl`
+- `dist/ltcai-7.9.0.tar.gz`
+- `ltcai-7.9.0.tgz`
+- `dist/ltcai-7.9.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_7.9.0_aarch64.dmg`
 
-Do not upload `dist/*`. Package registry publishing remains owner-run.
+Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
 See [docs/ROADMAP_RECOMMENDATIONS.md](docs/ROADMAP_RECOMMENDATIONS.md) for the
-strategic roadmap slices applied through 7.7.0 and the follow-up tracks.
+strategic roadmap slices applied through 7.9.0 and the follow-up tracks.
 
 ## Known Limitations
 
@@ -246,6 +256,8 @@ strategic roadmap slices applied through 7.7.0 and the follow-up tracks.
 
 | Version | Theme |
 | --- | --- |
+| 7.9.0 | Agent Runtime Boundary Hardening: explicit `SingleAgentRuntime`, compatibility alias preservation, injected rollback port, and release/readiness docs aligned to the product AgentRuntime facade |
+| 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 |

package/docs/CHANGELOG.md

@@ -4,6 +4,43 @@ 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.9.0] - 2026-06-23
+
+### Changed
+- Added `SingleAgentRuntime` as the explicit name for the legacy single-agent
+  state machine while preserving `AgentRuntime` as a compatibility alias.
+- Updated tool dispatch to build `SingleAgentRuntime` directly.
+- Moved single-agent git rollback behind an injected `rollback_file` port owned
+  by `ToolDispatchService`, keeping shell execution out of the core state
+  machine.
+- Added a shared `runtime-boundary/v1` descriptor so product and single-agent
+  runtime boundaries are machine-readable in config/tests.
+- Added `RuntimeBoundaryProtocol` as the minimal shared inspection surface for
+  runtime-boundary-aware dependency injection.
+- Updated architecture and product readiness targets to 7.9.0.
+
+## [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.
+- Refreshed 7.8.0 release screenshots, walkthrough video/GIF, and capture
+  notes under `output/release/v7.8.0/`.
+
 ## [7.7.0] - 2026-06-22
 
 > 7.7.0 marks the complete, finished product stage for Lattice AI.

package/docs/DEVELOPMENT.md

@@ -95,5 +95,4 @@ For user-facing, API, runtime, release, or packaging changes, check:
 - `docs/LEGACY_COMPATIBILITY.md` when root compatibility files change
 
 Release/publish examples must use exact target-version filenames. Do not
-document wildcard upload commands such as `dist/*`.
-
+document wildcard artifact upload commands.

package/docs/MULTI_AGENT_RUNTIME.md

@@ -2,7 +2,7 @@
 
 The Multi-Agent Runtime is the **orchestration layer** introduced in v2.0.0 and
 operationalized in v2.2.0. It sits
-*above* the v1.x single-agent state machine ([`AgentRuntime`](../latticeai/core/agent.py))
+*above* the v1.x single-agent state machine ([`SingleAgentRuntime`](../latticeai/core/agent.py))
 and coordinates a pipeline of named **roles** that hand off work to one another,
 retry on a failing review, and emit a fully observable, replayable timeline.
 
@@ -34,20 +34,21 @@ objects durable and inspectable:
 
 ## How it relates to the v1 single-agent runtime
 
-v1.x shipped a single-agent state machine — `AgentRuntime` driving
+v1.x shipped a single-agent state machine — `SingleAgentRuntime` driving
 `PLAN → EXECUTE → VERIFY → DONE` (with `ROLLBACK` / `FAILED` recovery paths) over an
-injected `AgentDeps` port. That runtime is unchanged.
+injected `AgentDeps` port. The historical `AgentRuntime` import remains as a
+compatibility alias.
 
 v2.0 adds the *orchestration* layer on top: instead of one agent looping through
 internal phases, the `MultiAgentOrchestrator` drives a **pipeline of distinct roles**
 (researcher, planner, executor, reviewer, release) that hand off to one another and
 can rewind on a failing review. The two layers are complementary — the v2
 orchestrator coordinates roles; an individual role's runner could itself be backed by
-the v1 `AgentRuntime` loop or an LLM, but that is an implementation choice behind the
+the v1 `SingleAgentRuntime` loop or an LLM, but that is an implementation choice behind the
 injected runner port.
 
 > **Compatibility.** The Multi-Agent Runtime is purely additive. The v1
-> `AgentRuntime` state machine and its `/agent` endpoints are untouched, and the v2
+> `SingleAgentRuntime` state machine and its `/agent` endpoints are untouched, and the v2
 > API is namespaced under `/agents` (plural) so it never collides with the existing
 > single-agent `/agent` routes. Existing v1.x data is preserved; new runs are appended
 > to workspace state and the Knowledge Graph alongside it.

package/docs/V2_ARCHITECTURE.md

@@ -141,8 +141,9 @@ portable JSON representation (definition only — no run history or scope).
 
 ### 1.3 Multi-Agent Runtime 2.0 (`latticeai.core.multi_agent`)
 
-v1.x shipped a single-agent state machine (`latticeai.core.agent.AgentRuntime`:
-PLAN → EXECUTE → VERIFY → DONE). v2.0 adds the **orchestration** layer above it:
+v1.x shipped a single-agent state machine (`latticeai.core.agent.SingleAgentRuntime`;
+`latticeai.core.agent.AgentRuntime` remains a compatibility alias) that drives
+PLAN → EXECUTE → VERIFY → DONE. v2.0 adds the **orchestration** layer above it:
 a pipeline of named roles that hand off to one another, retry on a failing
 review, and emit a structured timeline that drops straight into the Workspace
 timeline / Knowledge Graph.

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>
   );

package/frontend/src/components/ProductFlow.tsx

@@ -3,7 +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, Shield, Zap, Cpu } from "lucide-react";
+import { ArrowRight, Cpu, Shield, Zap } from "lucide-react";
 import {
   AnalysisScreen,
   InstallScreen,
@@ -107,25 +107,26 @@ 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" style={{display: "grid", gridTemplateColumns: "repeat(3, 1fr)", gap: "0.6rem", margin: "1.25rem auto", maxWidth: "620px"}}>
-        <div style={{border: "1px solid hsl(var(--border)/0.5)", borderRadius: "12px", padding: "0.7rem 0.8rem", background: "hsl(var(--surface))", textAlign: "left"}}>
-          <div style={{display: "flex", alignItems: "center", gap: "0.4rem", color: "hsl(var(--brain-core))", fontSize: "0.75rem", fontWeight: 700}}><Shield size={14}/> 완전 로컬</div>
-          <div style={{fontSize: "0.85rem", marginTop: "0.2rem", fontWeight: 600}}>모든 지식과 대화가 이 컴퓨터에만</div>
-        </div>
-        <div style={{border: "1px solid hsl(var(--border)/0.5)", borderRadius: "12px", padding: "0.7rem 0.8rem", background: "hsl(var(--surface))", textAlign: "left"}}>
-          <div style={{display: "flex", alignItems: "center", gap: "0.4rem", color: "hsl(var(--brain-core))", fontSize: "0.75rem", fontWeight: 700}}><Zap size={14}/> 직관적 즉시</div>
-          <div style={{fontSize: "0.85rem", marginTop: "0.2rem", fontWeight: 600}}>복잡한 설정 없이 3단계로 바로 시작</div>
-        </div>
-        <div style={{border: "1px solid hsl(var(--border)/0.5)", borderRadius: "12px", padding: "0.7rem 0.8rem", background: "hsl(var(--surface))", textAlign: "left"}}>
-          <div style={{display: "flex", alignItems: "center", gap: "0.4rem", color: "hsl(var(--brain-core))", fontSize: "0.75rem", fontWeight: 700}}><Cpu size={14}/> 영원한 Brain</div>
-          <div style={{fontSize: "0.85rem", marginTop: "0.2rem", fontWeight: 600}}>모델 바꿔도 지식은 그대로 영원히</div>
-        </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")}>
@@ -143,20 +144,15 @@ function WakeBrainScreen({ onWake, onUseExisting }: { onWake: () => void; onUseE
         </div>
       </div>
 
-      <div className="ritual-button-row" style={{marginTop: "1.25rem"}}>
-        <button 
-          type="button" 
-          className="ritual-full-button" 
-          onClick={onWake}
-          style={{fontSize: "1.05rem", padding: "0.85rem 2.2rem", display: "inline-flex", alignItems: "center", gap: "0.5rem"}}
-        >
+      <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 style={{marginTop: "0.8rem", fontSize: "0.72rem", color: "hsl(var(--fg-muted))"}}>평균 2분 안에 첫 대화 시작 · 완전 무료 · 로컬 전용</div>
+      <div className="ritual-start-note">{t(language, "flow.wake.startNote")}</div>
     </section>
   );
 }

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

@@ -2,7 +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 { Star, Zap, Gauge, ArrowRight } from "lucide-react";
+import { ArrowRight, Gauge, Star, Zap } from "lucide-react";
 
 export function RecommendationScreen({
   recommendations,
@@ -24,9 +24,9 @@ export function RecommendationScreen({
 
       <div className="ritual-model-list">
         {items[0]?.supported ? (
-          <div className="ritual-primary-cta" style={{marginBottom: "1rem"}}>
-            <Button onClick={() => onSelect(items[0])} className="ritual-primary-model-button" style={{display: "flex", alignItems: "center", gap: "0.5rem", fontSize: "1rem"}}>
-              {t(language, "flow.recommend.primary")} <ArrowRight size={16}/>
+          <div className="ritual-primary-cta">
+            <Button onClick={() => onSelect(items[0])} className="ritual-primary-model-button">
+              {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>
@@ -40,24 +40,23 @@ export function RecommendationScreen({
               className="ritual-model-card"
               onClick={() => model.supported && onSelect(model)}
               disabled={!model.supported}
-              style={{display: "flex", flexDirection: "column", alignItems: "flex-start", gap: "0.3rem"}}
             >
-              <div style={{display: "flex", alignItems: "center", gap: "0.4rem", width: "100%"}}>
-                <Icon size={16} style={{color: "hsl(var(--brain-core))"}} />
-                <div className="role" style={{marginBottom: 0}}>{rankLabel(model.role, index, language)}</div>
+              <div className="ritual-model-heading">
+                <Icon size={16} />
+                <div className="role">{rankLabel(model.role, index, language)}</div>
               </div>
-              <div className="name" style={{fontSize: "1.15rem"}}>{model.shortName}</div>
-              <div className="reason" style={{fontSize: "0.9rem"}}>
+              <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" style={{marginTop: "0.1rem"}}>
+              <div className="ritual-model-stats">
                 <span className="ritual-time-estimate">{timeEstimate(model, language)}</span>
               </div>
               {model.supported ? (
-                <span className="ritual-model-choose" style={{marginTop: "0.2rem", fontWeight: 700}}>{t(language, "flow.recommend.choose")} →</span>
+                <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>
               )}