ltcai 9.7.0 → 9.8.0

package/README.md

@@ -1,62 +1,8 @@
 # Lattice AI
 
-**Lattice AI 9.6.0 is the local-first Digital Brain platform. The Trusted Agent Loop makes autonomous work transparent and git-like: the reasoning loop reports every model call, format repair, and tool outcome; a deterministic evaluation harness gates every release on weak-model robustness; and change governance is proposal-first — creating new files is frictionless while edits and deletions of existing content become reviewable proposals you approve or reject before anything changes.**
-
-**Lattice AI는 모델이 바뀌어도 내 지식과 맥락을 보존하는 로컬 우선 AI 브레인입니다.**
-
-> The 9.6.0 release engineers trust into the agent loop: a structured
-> LoopTrace makes every run observable (llm calls, parse recoveries, format
-> repairs, corrections, tool outcomes — returned as `loop` in the agent API),
-> weak-model tolerance gains python-literal repair and escalating format
-> corrections, a deterministic agent evaluation harness gates CI, and a
-> central change governor stages edits/deletions of existing files as review
-> proposals (`/api/proposals`) applied exactly as reviewed — while new-file
-> creation now runs without approval friction.
-> The 9.5.0 release adds the Command Center: a deterministic, local
-> `/api/command` surface serving a daily briefing (recent knowledge,
-> conversation activity, automation state, pending reviews, health snapshot,
-> top suggestions, state-derived quick actions) and a universal search across
-> knowledge nodes, the user's own conversations, and installed automations —
-> surfaced in the app as a Cmd+K command palette and a Today's Briefing panel.
-> The 9.4.0 release adds question-driven automation: a deterministic local
-> pattern miner clusters your recurring questions (the evidence shown is your
-> own words, no model call), an /api/automation surface turns patterns and
-> connected folders into one-click suggestions, and every accepted suggestion
-> becomes a disabled, review-gated draft workflow you enable deliberately.
-> The 9.3.0 release wired the previously dormant Brain quality layer into
-> the product: /api/brain health diagnosis with recommended care actions, a
-> proactive insights digest, contradiction surfacing across memories and the
-> graph, dry-run-first duplicate consolidation, and hybrid recall that blends
-> vector similarity with lexical evidence behind an honest quality gate.
-> The 9.2.0 release hardened file creation end to end: chat file requests are
-> routed to a deterministic direct-write path (including type-only requests
-> like "html 파일 만들어줘"), model replies are treated as untrusted content
-> and cleaned of fences, reasoning blocks, and chat framing, and the agent
-> JSON loop tolerates small-model formatting slips instead of aborting.
-> The 9.1.0 release added request-scoped model routing,
-> workspace-isolated graph identities and frontend caches, fail-closed admin
-> gates, SSRF-safe web capture, private local state permissions, and reproducible
-> release/test isolation. The same release introduced a human-first UI:
-> a visible knowledge journey from conversation or source capture into the
-> living Brain, its real relationship graph, and memory-grounded automation;
-> the empty Brain home now keeps that complete loop inside one viewport, with
-> continuous vital motion and behavior-driven listening, recall, synthesis,
-> and action states. Task navigation and technical detail stay calm and
-> approachable.
-> Telegram access requires an explicit chat allowlist and server session token;
-> public invitation access uses signed, expiring authorization instead of a
-> static cookie; and unknown or unreadable Knowledge Graph scope fails closed.
-
-Your model is the voice you use today. Your Brain is the asset you keep.
-Lattice AI preserves conversations, documents, decisions, project context,
-relationships, and workflows on your computer by default. Cloud models, model
-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 Living Brain: chatting or adding a file, folder, note, or web page grows
-durable memory; the real graph shows how that knowledge connects; and reviewed,
-user-enabled automations can act from the same evidence.
+**Your model is the voice you use today. Your Brain is the asset you keep.**
+
+**모델은 갈아타도, 내 지식은 내 컴퓨터에 남는 로컬 우선 AI 브레인.**
 
 [![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)
@@ -65,305 +11,141 @@ user-enabled automations can act from the same evidence.
 [![CI Status](https://github.com/TaeSooPark-PTS/LatticeAI/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/TaeSooPark-PTS/LatticeAI/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
-## Why You Need It
-
-You need Lattice AI when:
+![v9.8.0 Living Brain walkthrough](output/release/v9.8.0/gifs/v9.8.0-living-brain-walkthrough.gif)
 
-- you ask different AI models about the same project and lose the context each time;
-- your decisions are scattered across chats, notes, PDFs, folders, and tools;
-- you want to switch models without rebuilding memory from zero;
-- you want your AI Brain to stay on your computer by default;
-- you want backup, restore, inspect, and export paths for your Brain.
+Chat, files, folders, notes, and web pages all flow into one durable knowledge
+graph on your computer. Any model — local MLX or cloud — can speak with that
+memory. Nothing leaves your machine without explicit consent.
 
-이런 사람에게 필요합니다:
-
-- 매번 AI를 바꿀 때마다 프로젝트 맥락을 다시 설명하는 사람
-- 문서, 대화, 결정, 파일이 여기저기 흩어져 있는 사람
-- 내 지식을 특정 AI 서비스 안에 묶어두고 싶지 않은 사람
-- 로컬에 저장되는 개인 AI 브레인을 원하는 사람
+대화·파일·폴더·웹페이지가 전부 내 컴퓨터 안의 지식 그래프로 쌓이고, 어떤
+모델이든 그 기억을 이어받아 대화합니다.
 
 ## What You Can Do
 
-- Chat with a Brain that remembers useful context instead of treating every
-  session as disposable.
-- Add documents, selected local folders, notes, screenshots, and web pages with
-  source-aware memory.
-- Watch new knowledge enter the Brain and appear in a lightweight, real
-  relationship graph before opening the full graph explorer.
-- See the Brain breathe, pulse, listen, recall, synthesize, and act while the
-  source, graph, composer, and next memory-grounded action remain visible in a
-  single desktop or mobile viewport.
-- Create evidence-linked Brain automation drafts for memory digests, project
-  reviews, and follow-up suggestions, then explicitly enable them when ready.
-- Use a recommended local model without learning model internals first.
-- Keep advanced controls, audit logs, roles, and retention in a separate Admin
-  surface.
-- Export or back up your Brain as an encrypted `.latticebrain` archive.
-
-## One-Minute Flow
-
-1. Launch the app and wake the Brain.
-2. Create or open a local profile.
-3. Let Lattice explain what this computer can run.
-4. Start with the recommended model as the Brain's voice, or skip and choose later.
-5. Talk to your Brain or add a file, folder, note, or web page.
-6. Watch the source become memory and connect to the visible knowledge graph.
-7. Ask, delegate, review, or explicitly enable a memory-grounded automation.
-8. Back up, inspect, export, or restore the Brain when you need ownership actions.
-
-## Living Brain Flow
-
-The screenshots below are the latest checked-in visual evidence captures. They
-keep the first-run Brain flow, memory graph, source capture, model library,
-system view, admin console, and review center visible as release gates while
-9.6.0 makes autonomous work trustworthy: agents create new things freely,
-but every change to existing content becomes a reviewable proposal with a
-diff, and the reasoning loop itself is observable and regression-gated. The
-captures below are the checked-in 9.6.0 visual release evidence for that
-product flow.
-
-### 1. Wake Brain
-
-The first screen makes the Brain the product. It explains the three-step path:
-confirm owner, check the computer, choose the Brain voice.
-
-### 2. Login
-
-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/v9.7.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/v9.7.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/v9.7.0/screenshots/03-install-load-progress.png)
-
-### 5. Brain Chat
+| | |
+| --- | --- |
+| **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v9.8.0/screenshots/04-brain-chat-home.png) | **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v9.8.0/screenshots/05-memory-graph.png) |
+| **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v9.8.0/screenshots/06-capture.png) | **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v9.8.0/screenshots/12-review-center.png) |
+| **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v9.8.0/screenshots/02-recommended-models.png) | **Stay in control** — audit, roles, retention in a separate admin surface ![Admin Console](output/release/v9.8.0/screenshots/10-admin-console.png) |
 
-Talk normally or add a source from a single, living canvas. The default home
-fits the complete knowledge lifecycle into one viewport: source controls feed
-the breathing Brain, real nodes and animated relationships stay visible beside
-it, and the composer plus grounded next action remain within reach. Brain motion
-and its visible life signal follow real listening, recall, synthesis, and action
-state. Detailed memory rings, provenance, conversation history, and
-model/runtime proof open as overlays only when requested.
+## Why Lattice AI
 
-![One-viewport Living Brain Home](output/release/v9.7.0/screenshots/04-brain-chat-home.png)
+- **Own your memory** — knowledge lives in a local SQLite Brain you can back up,
+  export, inspect, and restore (`.latticebrain` encrypted archive).
+- **Model-independent** — switch between local MLX models and cloud models
+  without rebuilding context from zero.
+- **Honest by design** — the Brain tells you when retrieval context is limited,
+  when captured pages extracted poorly, and when the vector index is catching up.
+- **Safe automation** — automations are consent-first drafts; edits to existing
+  content always pass through a reviewable proposal with a diff.
 
-### 6. Review Center
+매번 AI에게 프로젝트 맥락을 다시 설명하고 있다면, 지식이 여러 서비스에 흩어져
+있다면, 그 기억을 특정 회사가 아니라 내가 소유하고 싶다면 — Lattice AI가 그
+브레인입니다.
 
-Automation results are staged for review before they become durable decisions.
-Snooze, unsnooze, run now, approve, and dismiss actions stay explicit.
+## Quick Start
 
-![Review Center](output/release/v9.7.0/screenshots/12-review-center.png)
+```bash
+pip install ltcai        # or: npm install -g ltcai
+LTCAI                    # then open http://127.0.0.1:4825/app
+```
 
-## Brain Depths
+Apple Silicon local models: `pip install "ltcai[local]"`. Desktop app (Tauri)
+ships as a dmg on each [GitHub Release](https://github.com/TaeSooPark-PTS/LatticeAI/releases).
 
-The user travels inward from everyday memory to deeper structure:
+First-run flow — wake the Brain, pick the owner, load a recommended model:
 
-| Level | User name | What the user gets |
+| | | |
 | --- | --- | --- |
-| Level 1 | Now memory | The living Brain presence and current conversation context |
-| Level 2 | Older memory | Durable memories with source-aware recall |
-| Level 3 | Topics | Recurring themes across chats and documents |
-| Level 4 | Relationships | How decisions, people, files, and ideas connect |
-| Level 5 | Full knowledge graph | Nodes, edges, search, and focused detail for advanced exploration |
-
-Walkthrough:
-
-![v9.7.0 Living Brain walkthrough](output/release/v9.7.0/gifs/v9.7.0-living-brain-walkthrough.gif)
+| ![Login](output/release/v9.8.0/screenshots/01-login.png) | ![Model install](output/release/v9.8.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v9.8.0/screenshots/07-model-library.png) |
 
 Screenshot index and capture notes:
-[output/release/v9.7.0/SCREENSHOT_INDEX.md](output/release/v9.7.0/SCREENSHOT_INDEX.md)
-
-## Install
+[output/release/v9.8.0/SCREENSHOT_INDEX.md](output/release/v9.8.0/SCREENSHOT_INDEX.md)
 
-Run from Python:
-
-```bash
-pip install ltcai
-LTCAI
-```
+## Current Release
 
-Run from npm:
+The current release is **9.8.0 — Honest Knowledge Pipeline**:
 
-```bash
-npm install -g ltcai
-ltcai
-```
+- Every ingest (file, folder, web) now reports an extraction-quality score and
+  warns on low-quality captures before they pollute the Brain.
+- Background folder ingestion is robust: per-item errors don't kill the job,
+  progress (processed/total) is visible, and interrupted jobs resume — with a
+  jobs API (`/api/ingestion/jobs`) and UI progress.
+- The Brain signals honestly: chat answers carry a `context_quality` marker
+  when graph context is limited, and `/api/brain/vector-freshness` plus a UI
+  banner show when knowledge is still waiting for vector indexing.
+- The agent evaluation gate grew to 16 deterministic scenarios, adding
+  ingestion, concept-extraction, RAG-grounded answering, and automation
+  proposal paths; automation suggestions gain confidence scoring and dedup.
 
-Open the local app:
+Release notes: [RELEASE.md](RELEASE.md) · Full history: [docs/CHANGELOG.md](docs/CHANGELOG.md)
 
-```text
-http://127.0.0.1:4825/app
-```
+Expected artifacts for 9.8.0 release must use exact filenames:
 
-Apple Silicon local model extras:
+- `dist/ltcai-9.8.0-py3-none-any.whl`
+- `dist/ltcai-9.8.0.tar.gz`
+- `ltcai-9.8.0.tgz`
+- `dist/ltcai-9.8.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_9.8.0_aarch64.dmg`
 
-```bash
-pip install "ltcai[local]"
-```
+Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
 ## Architecture At A Glance
 
-- **Product category**: local-first Digital Brain.
-- **Core capability**: private AI memory layer for conversations, documents,
-  decisions, relationships, workflows, and project context.
-- **UX metaphor**: a visible source-to-memory-to-graph-to-automation journey
-  centered on the Living Brain, not a generic chat or operations dashboard.
-- **Product navigation**: desktop task navigation and a mobile bottom bar expose
-  Chat, Sources, Memory, and Work; model, workspace, and admin controls live in
-  the secondary menu.
-- **Desktop shell**: Tauri 2 starts a localhost sidecar.
-- **Frontend**: React, TypeScript, Vite, TanStack Query, Zustand, Cytoscape.js,
-  React Flow, and generated OpenAPI types.
-- **Backend**: FastAPI on localhost is the UI source of truth.
-- **Brain Core**: independent `lattice_brain` package for graph, memory,
-  context, conversations, ingestion, runtime, workflow, storage, and portability.
-- **Storage**: SQLite is the live local Brain store; PostgreSQL/pgvector tooling
-  is optional scale-mode planning/migration support, not the default live graph
-  backend.
-- **Portability**: encrypted `.latticebrain` archives plus backup, restore,
-  inspect, verify, import dry-run, and confirmed restore/import flows.
-- **Trust boundary**: local-first by default; cloud calls, downloads, Telegram,
-  Brain Network, Docker/Postgres setup, and update checks are opt-in.
-- **Admin separation**: normal Brain use stays separate from users, audit logs,
-  policies, security events, retention, and index rebuilds.
-
-See [ARCHITECTURE.md](ARCHITECTURE.md) for the current architecture.
-
-## Local Development
-
-```bash
-npm install
-npm run dev
-```
-
-Main validation set:
-
-```bash
-npm run check:python
-npm run lint
-npm run typecheck
-npm run test:unit
-npm run test:integration
-npm run test:visual
-npm run desktop:tauri:check
-npm run docs:check-links
-```
-
-`npm run lint` includes the Python Ruff baseline, frontend TypeScript lint
-gate, visual smoke syntax checks, and i18n literal checks.
-
-See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
-
-## Current Release
-
-The current release is **9.7.0 — Proactive Hybrid Brain**:
-
-- Retrieval is unified: `KnowledgeGraphStore.hybrid_search()` fuses lexical
-  and vector search in the graph layer itself (normalized scores, per-source
-  provenance, rank fusion), degrades honestly to `lexical_only` when the
-  vector index is unavailable, and `context_for_query()` can opt into it.
-- The vector index stays in sync automatically: every successful ingest runs
-  an incremental `index_node_incremental()` pass (opt-out via
-  `LATTICEAI_AUTO_VECTOR_INDEX`), and failures downgrade to an explicit
-  `pending` status that the next `rebuild_vector_index` picks up.
-- Ingestion covers whole folders: `ingest_folder()` walks directories with
-  `.latticeignore` support (gitignore-like globs), size/extension filters,
-  and optional background scheduling; `ingest_web_page()` formalizes the
-  web seam — fetching/parsing stays upstream, the graph receives clean text.
-- The Brain is proactive in the graph layer: `lattice_brain/graph/proactive.py`
-  finds duplicate and contradictory knowledge, produces a combined quality
-  report with stale-node and edge-quality signals, and plans consent-first
-  duplicate consolidation — surfaced at `GET /api/brain/duplicates`,
-  `GET /api/brain/quality-report`, and the existing contradiction/consolidate
-  endpoints.
-- The change-governance loop is closed: Review Center approval now applies
-  staged proposals through the single application path (no more
-  status-only approvals), proposals carry tool/risk/change-class/conversation
-  provenance, reject records a reason, and pending-proposal counts badge the
-  review inbox.
-- The agent evaluation gate grew to 12 scenarios, adding file-generation
-  happy path and recovery, a 3-step multi-step workflow chain, and a
-  governed-write proposal path that pins the approve()-excludes-governed-tools
-  invariant.
-- Engineering health: `SingleAgentRuntime.execute` decomposed into focused
-  helpers, multi-agent/single-agent runtime consistency pinned by tests, all
-  root legacy modules emit deprecation warnings pointing at their package
-  homes, and `scripts/profile_kg.py` + `docs/PERFORMANCE.md` establish a
-  measured KG performance baseline.
-
-Expected artifacts for 9.7.0 release must use exact filenames:
-
-- `dist/ltcai-9.7.0-py3-none-any.whl`
-- `dist/ltcai-9.7.0.tar.gz`
-- `ltcai-9.7.0.tgz`
-- `dist/ltcai-9.7.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_9.7.0_aarch64.dmg`
-
-Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
+FastAPI on localhost is the source of truth; the React/Vite frontend and the
+Tauri desktop shell sit on top; the independent `lattice_brain` package owns
+the graph, memory, ingestion, and portability. Local-first by default — cloud
+calls, downloads, Telegram, and update checks are opt-in.
 
-See [docs/ROADMAP_RECOMMENDATIONS.md](docs/ROADMAP_RECOMMENDATIONS.md) for the
-strategic roadmap slices applied through 9.7.0 and the follow-up tracks.
+See [ARCHITECTURE.md](ARCHITECTURE.md) for details and
+[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for the developer workflow
+(`npm install && npm run dev`, validation via `npm run lint`,
+`npm run test:unit`, `npm run test:visual`).
 
 ## Known Limitations
 
 - External package registries are owner-published and can lag behind GitHub.
 - PostgreSQL/pgvector is optional scale/migration tooling. SQLite remains the
-  live local Brain store in 9.7.0.
-- Docker, model downloads, cloud model calls, Telegram, Brain Network, and update
-  checks require explicit user action.
-- Conversation does not fabricate answers when no model is loaded.
-- Agent/workflow simulation without a loaded LLM is deterministic and does not
-  call a model; it is labeled as LLM-free/model-free rather than presented as
-  autonomous model success.
+  live local Brain store in 9.8.0.
+- Docker, model downloads, cloud model calls, Telegram, Brain Network, and
+  update checks require explicit user action.
+- Conversation does not fabricate answers when no model is loaded; LLM-free
+  simulation is labeled as such.
 
 ## Release History
 
 | Version | Theme |
 | --- | --- |
-| 9.7.0 | Proactive Hybrid Brain: graph-native hybrid lexical+vector retrieval with automatic incremental vector indexing, folder ingestion with `.latticeignore`, proactive duplicate/contradiction detection and quality reporting in the graph layer, and a fully closed proposal→Review Center→apply governance loop |
-| 9.6.0 | Trusted Agent Loop: observable agent reasoning (LoopTrace + loop API payload), python-literal/fence/think weak-model repairs with escalating corrections, a deterministic CI agent-eval harness, and proposal-first change governance where edits/deletions of existing files become reviewable diffs |
-| 9.5.0 | Command Center: a Cmd+K palette searching knowledge, conversations, automations, and pages in one query, plus a daily briefing with Brain state at a glance and state-derived one-click quick actions |
-| 9.4.0 | Question-Driven Everyday Automation: the Brain mines recurring user questions and connected knowledge folders into one-click, consent-first automation suggestions installed as review-gated drafts |
-| 9.3.0 | Proactive Brain Intelligence: the Brain diagnoses its own health, surfaces contradictions and stale knowledge, proposes consent-first duplicate consolidation, and recalls with hybrid lexical+semantic evidence behind an honest quality gate |
-| 9.2.0 | Model-Agnostic File Generation: chat file requests always produce structurally valid files with any LLM via extraction, per-type validation, corrective retry, deterministic repair, inferred file targets, and a fault-tolerant agent JSON loop |
-| 9.1.0 | Code Review Completion & Fail-Closed Runtime: all July 11 review findings closed across fail-closed security, typed runtime/model/chat boundaries, honest frontend failures and tests, and repository hygiene |
-| 9.0.0 | Code Review Closure & Runtime Cleanup: July 8 code-review follow-ups fixed, chat/runtime reliability improved, duplicated utility surfaces consolidated, runtime audit append paths moved to JSONL, and release metadata/artifacts synchronized |
-| 8.9.0 | Scoped Memory & Tool Policy Hardening: authenticated history/KG reads are workspace-scoped, direct Tool API paths enforce registry policy, local approvals hash tokens at rest, AgentRuntime approval semantics are explicit, and frontend/runtime seams are split |
-| 8.8.0 | Brain Core Extraction & Recall Proof Hardening: internal-only Brain shim layers are removed, AgentRuntime run contracts/retry budgets are tighter, Brain Chat gains conversation controls, and citation recall exposes matched evidence |
-| 8.7.0 | Runtime State Hygiene & Release Evidence Refresh: model-runtime internals prefer typed state over legacy globals, compatibility sync is deprecated, 8.7.0 visual evidence is refreshed, and all release metadata/docs are synchronized |
-| 8.6.0 | Desktop Capture & Navigation Reliability: native folder selection works from the Tauri localhost app, picker failures surface in Capture, web saving remains one-action, and the Brain shell sidebar/admin flow is CI-covered |
-| 8.5.0 | Tool Registry Readiness & Config DI: ToolRegistry drift removed, `tz_name` flows through central Config into automation runtimes, and current-release documentation is synchronized |
-| 8.4.0 | Action-Aware Brain Chat: explicit file create/write/save/edit requests from Brain Chat route into the governed workspace file tool so files are actually created instead of returned as code-only answers |
-| 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 |
+| 9.8.0 | Honest Knowledge Pipeline |
+| 9.7.0 | Proactive Hybrid Brain |
+| 9.6.0 | Trusted Agent Loop |
+| 9.5.0 | Command Center |
+| 9.4.0 | Question-Driven Everyday Automation |
+| 9.3.0 | Proactive Brain Intelligence |
+| 9.2.0 | Model-Agnostic File Generation |
+| 9.1.0 | Code Review Completion & Fail-Closed Runtime |
+| 9.0.0 | Code Review Closure & Runtime Cleanup |
+| 8.9.0 | Scoped Memory & Tool Policy Hardening |
+| 8.8.0 | Brain Core Extraction & Recall Proof Hardening |
+| 8.7.0 | Runtime State Hygiene & Release Evidence Refresh |
+| 8.6.0 | Desktop Capture & Navigation Reliability |
+| 8.5.0 | Tool Registry Readiness & Config DI |
+| 8.4.0 | Action-Aware Brain Chat |
+| 8.3.0 | Orchestrated Brain Readiness |
+| 8.2.0 | Brain Brief |
+| 8.1.0 | Intuitive Brain Home |
+| 8.0.0 | Runtime Architecture Contract |
+
+Per-release details: [RELEASE_NOTES.md](RELEASE_NOTES.md)
 
 ## Documentation
 
-- [docs/WHY_LATTICE.md](docs/WHY_LATTICE.md) - product philosophy.
-- [docs/TRUST_MODEL.md](docs/TRUST_MODEL.md) - local-first trust model.
-- [PRIVACY.md](PRIVACY.md) - privacy and external communication policy.
-- [ARCHITECTURE.md](ARCHITECTURE.md) - current technical architecture.
-- [FEATURE_STATUS.md](FEATURE_STATUS.md) - current feature status and known limitations.
-- [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) - developer workflow.
-- [docs/LEGACY_COMPATIBILITY.md](docs/LEGACY_COMPATIBILITY.md) - root legacy shim map.
-- [RELEASE.md](RELEASE.md) - release guide and current release notes.
-- [docs/CHANGELOG.md](docs/CHANGELOG.md) - historical changes.
-- [SECURITY.md](SECURITY.md) - security posture.
+- [docs/WHY_LATTICE.md](docs/WHY_LATTICE.md) — product philosophy
+- [docs/TRUST_MODEL.md](docs/TRUST_MODEL.md) — local-first trust model
+- [PRIVACY.md](PRIVACY.md) — privacy and external communication policy
+- [FEATURE_STATUS.md](FEATURE_STATUS.md) — feature status and limitations
+- [SECURITY.md](SECURITY.md) — security posture
+- [RELEASE.md](RELEASE.md) — release guide and notes
 
 ## License
 

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.
 
+## [9.8.0] - 2026-07-20
+
+### Added
+- Added `extraction_quality` (score/level/reasons) and low-quality `warnings`
+  to every ingest result, with upstream extractor confidence taking
+  precedence; the proactive `gate_ingest_candidate()` now records an
+  observe-only `quality_gate` verdict on non-chat ingests.
+- Added background ingestion job progress (`total`/`processed`/`failed`,
+  capped per-item errors) with resume-from-remaining support, plus
+  `GET /api/ingestion/jobs`, `GET /api/ingestion/jobs/{id}`,
+  `POST /api/ingestion/jobs/{id}/resume`, and approval-gated
+  `POST /api/ingestion/folder`.
+- Added `context_quality` (mode/nodes/limited/reason) to chat responses
+  (non-stream top-level and final SSE trailer) with a localized
+  limited-context note in the assistant bubble.
+- Added `GET /api/brain/vector-freshness` and a pending-indexing chip in the
+  Brain views; `vector_freshness()` never raises and degrades to
+  `unavailable` with a reason.
+- Added four agent-eval scenarios (ingestion chain, concept extraction,
+  RAG-grounded answer with a negative grounding test, automation
+  proposal-first), growing the CI gate to 16 scenarios with
+  `expect_final_contains` grounding assertions.
+- Added deterministic `confidence`, `confidence_factors`, duplicate
+  suppression, installed-recipe detection, and a low-quality floor to
+  automation suggestions, with a `quality` reporting block.
+- Added a frontend ingestion jobs panel (progress bar, failed count, resume)
+  and extraction-quality warnings in the ingestion panels, all with ko/en
+  i18n parity.
+
+### Changed
+- Rebuilt README media-first: hero walkthrough GIF, screenshot grid, compact
+  release-history table, and roughly 60% less prose.
+- `context_for_query()` gains an opt-in metadata path
+  (`context_for_query_with_meta()`); the default output is byte-identical.
+- Background ingestion job initial status is now `queued` (was internal
+  `pending`).
+
 ## [9.7.0] - 2026-07-20
 
 ### Added

package/docs/COMMUNITY_AND_PLUGINS.md

@@ -1,6 +1,6 @@
 # Community And Plugins
 
-Current release: **9.7.0 — Proactive Hybrid Brain**.
+Current release: **9.8.0 — Honest Knowledge Pipeline**.
 
 LatticeAI defines the path from a strong local-first framework (8.4.0
 action-aware baseline, 8.5.0 registry+DI hardening, 8.6.0 capture/navigation

package/docs/DEVELOPMENT.md

@@ -1,6 +1,6 @@
 # Lattice AI Development
 
-Current release: **9.7.0 — Proactive Hybrid Brain**.
+Current release: **9.8.0 — Honest Knowledge Pipeline**.
 
 This document is for contributors working on the local-first Digital Brain
 codebase. Product positioning and quick start stay in `README.md`; release

package/docs/ONBOARDING.md

@@ -1,6 +1,6 @@
 # Lattice AI Onboarding
 
-Current release: **9.7.0 — Proactive Hybrid Brain**.
+Current release: **9.8.0 — Honest Knowledge Pipeline**.
 
 The first-run goal is a five-minute path from "I opened the app" to "my Brain
 has a source, a question, and proof." This page is the product contract behind

package/docs/TRUST_MODEL.md

@@ -1,6 +1,6 @@
 # Lattice AI Trust Model
 
-Current release: **9.7.0 — Proactive Hybrid Brain**.
+Current release: **9.8.0 — Honest Knowledge Pipeline**.
 
 Lattice AI is local-first, explicit about external communication, and honest
 when a capability is unavailable.

package/docs/WHY_LATTICE.md

@@ -1,6 +1,6 @@
 # Why Lattice AI Exists
 
-Current release: **9.7.0 — Proactive Hybrid Brain**.
+Current release: **9.8.0 — Honest Knowledge Pipeline**.
 
 **Lattice AI is a local-first Digital Brain that keeps your knowledge durable
 across any AI model.**

package/docs/kg-schema.md

@@ -1,6 +1,6 @@
 # Knowledge Graph Schema
 
-Current release: **9.7.0 — Proactive Hybrid Brain**.
+Current release: **9.8.0 — Honest Knowledge Pipeline**.
 
 명세 출처: `lattice_ai_full_spec.pptx` 슬라이드 20·21·22
 구현: `kg_schema.py`

package/lattice_brain/__init__.py

@@ -26,7 +26,7 @@ from .storage import (
     storage_from_env,
 )
 
-__version__ = "9.7.0"
+__version__ = "9.8.0"
 
 __all__ = [
     "AgentRuntime",