ltcai 8.1.0 → 8.3.0

package/README.md

@@ -1,6 +1,6 @@
 # Lattice AI
 
-**Lattice AI 8.0 is the local-first Digital Brain platform with hardened runtime architecture. It keeps your knowledge durable across any AI model, with AgentRuntime, ToolRegistry, central Config, and Knowledge Graph stability tracked by explicit release contracts.**
+**Lattice AI 8.3.0 is the local-first Digital Brain platform with managed legacy compatibility, stronger AgentRuntime/workflow orchestration, and graph ingestion coverage that keeps workspace memory isolated.**
 
 **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 — now with the 8.0 runtime architecture contract behind it.
+It is the finished private AI memory layer wrapped in a Living Brain experience — now with an 8.3.0 product-readiness contract behind onboarding, orchestration, graph ingestion, and the plugin/community path.
 
 [![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,9 +64,10 @@ You need Lattice AI when:
 
 ## Living Brain Flow
 
-The screenshots below are release evidence captures. The 8.1 line keeps the
-first-run flow and refreshes Brain Home so the living Brain, recent memory,
-next action, and composer are understandable in one glance.
+The screenshots below are the latest checked-in visual evidence captures from
+the 8.2 Brain Home release. The 8.3 line keeps that first-run flow focused on
+the Brain while adding clearer onboarding, stronger workflow/runtime
+boundaries, and better ingestion proof behind the scenes.
 
 ### 1. Wake Brain
 
@@ -78,21 +79,21 @@ 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/v8.1.0/screenshots/01-login.png)
+![Login](output/release/v8.2.0/screenshots/01-login.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/v8.1.0/screenshots/02-recommended-models.png)
+![Recommended Models](output/release/v8.2.0/screenshots/02-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/v8.1.0/screenshots/03-install-load-progress.png)
+![Install and Load](output/release/v8.2.0/screenshots/03-install-load-progress.png)
 
 ### 5. Brain Chat
 
@@ -100,14 +101,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/v8.1.0/screenshots/04-brain-chat-home.png)
+![Brain Brief Home](output/release/v8.2.0/screenshots/04-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/v8.1.0/screenshots/12-review-center.png)
+![Review Center](output/release/v8.2.0/screenshots/12-review-center.png)
 
 ## Brain Depths
 
@@ -123,10 +124,10 @@ The user travels inward from everyday memory to deeper structure:
 
 Walkthrough:
 
-![v8.1.0 Living Brain walkthrough](output/release/v8.1.0/gifs/v8.1.0-living-brain-walkthrough.gif)
+![v8.2.0 Living Brain walkthrough](output/release/v8.2.0/gifs/v8.2.0-living-brain-walkthrough.gif)
 
 Screenshot index and capture notes:
-[output/release/v8.1.0/SCREENSHOT_INDEX.md](output/release/v8.1.0/SCREENSHOT_INDEX.md)
+[output/release/v8.2.0/SCREENSHOT_INDEX.md](output/release/v8.2.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -203,27 +204,27 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release
 
-The current release is **8.1.0 — Intuitive Brain Home**:
+The current release is **8.3.0 — Orchestrated Brain Readiness**:
 
-- Brain Home now opens with the living Brain directly above the conversation composer, so the primary action is visible before users read any utility panels.
-- The previous dashboard-style growth strip is replaced by a product narrative: Brain state, what was just remembered, the strongest connected topic, and the next best action.
-- Primary actions are explicit and click-tested: talk to Brain, add sources, or open the memory graph.
-- Mobile and narrow layouts keep the Brain and composer in the first viewport, avoiding the previous clipped/overcrowded first screen.
-- The 8.0 runtime architecture contract remains active: AgentRuntime, ToolRegistry, Config, server decomposition, and KG hardening stay machine-checkable through readiness gates.
-- CI and release workflows continue to run frontend lint/typecheck/build gates plus product readiness before a tag can be treated as release-safe.
+- Legacy compatibility is now tracked as a managed inventory in `latticeai.core.legacy_compatibility`, so root shims have owners, replacements, and removal phases instead of living as hidden debt.
+- AgentRuntime and workflow orchestration expose clearer lifecycle/config boundaries while preserving compatibility for legacy run records.
+- `/knowledge-graph/ingest` now routes through the unified ingestion pipeline when available, giving MCP/note/message writes the same provenance and hook lifecycle as files and browser sources.
+- Graph ingestion now keeps duplicate content isolated per workspace, avoiding cross-workspace metadata overwrites while preserving content-hash duplicate detection.
+- Upload failures surface honest client errors, and upload-to-KG behavior is covered by integration-style unit tests.
+- Onboarding, community, plugin, and release docs now define the five-minute first-run path and ecosystem growth path for 8.3.0.
 
-Expected artifacts for 8.1.0 release must use exact filenames:
+Expected artifacts for 8.3.0 release must use exact filenames:
 
-- `dist/ltcai-8.1.0-py3-none-any.whl`
-- `dist/ltcai-8.1.0.tar.gz`
-- `ltcai-8.1.0.tgz`
-- `dist/ltcai-8.1.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_8.1.0_aarch64.dmg`
+- `dist/ltcai-8.3.0-py3-none-any.whl`
+- `dist/ltcai-8.3.0.tar.gz`
+- `ltcai-8.3.0.tgz`
+- `dist/ltcai-8.3.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_8.3.0_aarch64.dmg`
 
 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 8.1.0 and the follow-up tracks.
+strategic roadmap slices applied through 8.3.0 and the follow-up tracks.
 
 ## Known Limitations
 
@@ -240,6 +241,8 @@ strategic roadmap slices applied through 8.1.0 and the follow-up tracks.
 
 | Version | Theme |
 | --- | --- |
+| 8.3.0 | Orchestrated Brain Readiness: managed legacy shim inventory, stronger AgentRuntime/workflow boundaries, unified graph ingestion, workspace-safe duplicate content, first-run onboarding, and explicit community/plugin growth path |
+| 8.2.0 | Brain Brief: evidence-backed home briefing, honest empty-state guidance, recall/graph/model-proof next actions, and continued model/workspace runtime extraction |
 | 8.1.0 | Intuitive Brain Home: living Brain, recent memory, connected topic, next action, and composer are visible in one product-first screen with refreshed 8.1.0 evidence and artifacts |
 | 8.0.0 | Runtime Architecture Contract: AgentRuntime, ToolRegistry, central Config, server decomposition, and KG hardening are captured as machine-checkable release boundaries with exact 8.0.0 artifacts |
 | 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 |
@@ -252,28 +255,6 @@ strategic roadmap slices applied through 8.1.0 and the follow-up tracks.
 | 7.2.0 | Runtime Trust Baseline: agent run preview/readiness, simulation-mode guardrails, live ToolRegistry manifest/diagnostics, and tests for dispatch/governance/catalog drift |
 | 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 |
-| 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 |
-| 6.3.1 | Access Runtime / i18n Follow-up: app-factory access-control extraction, focused access runtime tests, and Capture/Review Center i18n coverage |
-| 6.3.0 | Product Hardening Completion: Brain archive/provenance/ingestion UX polish, Review Center Run Now contract hardening, local model runtime status, app-factory review wiring, shim smoke, i18n guard, and exact release artifacts |
-| 6.2.0 | Product Decomposition / Release Smoke Automation: App and ProductFlow feature extraction, legacy root shim shrink, model download consent UX, typed router contexts, localized smoke tests, and wheel/npm/static/Tauri release smoke |
-| 6.1.0 | Product Hardening / Digital Brain Completion: local Brain entry without a loaded model, Brain memory/backup loop, Review Center semantics, ToolRegistry authorization boundary, and root CLI/runtime compatibility |
-| 6.0.0 | Product Reset / Review Center Completion: Snoozed filter, Unsnooze, OpenAPI-derived Review typing, Review feature extraction, v6 docs and scorecard |
-| 5.6.0 | Brain Automation Review Center: workspace-scoped automation review inbox, source-aware provenance, guarded approve/dismiss/snooze/run_now actions, and Act Review tab |
-| 5.5.0 | Release Coordination: synchronized package/runtime/static versions and release docs for the 5.5.0 line while preserving v5.4.0 Brain Automation Scheduler behavior |
-| 5.4.0 | Brain Automation Scheduler: consent-first recipe drafts (Daily/Weekly/Follow-up), TriggerService with dedup/LATTICE_TZ/degraded, runtime graph cleanup, E2E scenarios |
-| 5.3.0 | Product Clarity and Runtime Cleanup: user-first README/onboarding, unified Digital Brain identity, legacy compatibility map, and app factory runtime seams |
-| 5.2.0 | User-Focused Model Transformation: structured model capability registry, HF verification transparency, model recommendation UX, and workspace-scoped marketplace state |
-| 5.1.0 | Product Trust & Clarity Release: clarifies the private AI memory-layer promise, hardens CSP/secret/auto-read/download gates, adds trust/privacy docs, and refreshes evidence |
-| 5.0.0 | Multilingual Brain Foundation Release: adds persisted Korean/English language choice across first-run onboarding, Brain home, graph exploration, and Admin Console |
-| 4.7.2 | Intuitive Brain UX Release: safer login, one-click recommended setup, direct Brain views, memory-save feedback, and exact artifacts |
-| 4.7.0 | Admin Separation Release: adds the separate Admin Console for users/logs/security/Brain operations |
-| 4.6.1 | Living Brain Release Refresh: publishable version bump after v4.6.0 PyPI immutability |
-| 4.6.0 | Living Brain Experience: made Brain plus conversation the home product |
-| 4.5.1 | Product Reimagining RC: reset shell, navigation, onboarding, and visual system |
-| 4.5.0 | Product Experience Recovery RC: restored first-run setup, workspace/model onboarding, and graph discoverability |
 
 ## Documentation