ltcai 10.9.0 → 11.0.1

package/README.md

@@ -11,7 +11,7 @@
 [![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)
 
-![v10.9.0 Living Brain walkthrough](output/release/v10.9.0/gifs/v10.9.0-living-brain-walkthrough.gif)
+![v11.0.1 Living Brain walkthrough](output/release/v11.0.1/gifs/v11.0.1-living-brain-walkthrough.gif)
 
 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
@@ -24,10 +24,10 @@ memory. Nothing leaves your machine without explicit consent.
 
 | | |
 | --- | --- |
-| **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v10.9.0/screenshots/04-brain-chat-home.png) | **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v10.9.0/screenshots/05-memory-graph.png) |
-| **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v10.9.0/screenshots/06-capture.png) | **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v10.9.0/screenshots/12-review-center.png) |
-| **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v10.9.0/screenshots/02-recommended-models.png) | **Stay in control** — audit, roles, retention in a separate admin surface ![Admin Console](output/release/v10.9.0/screenshots/10-admin-console.png) |
-| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v10.9.0/screenshots/11-knowledge-journey.png) | **Say how much it may do alone** — one dial in plain words; dangerous actions stay blocked either way ![Settings](output/release/v10.9.0/screenshots/08-system.png) |
+| **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v11.0.1/screenshots/04-brain-chat-home.png) | **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v11.0.1/screenshots/05-memory-graph.png) |
+| **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v11.0.1/screenshots/06-capture.png) | **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v11.0.1/screenshots/12-review-center.png) |
+| **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v11.0.1/screenshots/02-recommended-models.png) | **Stay in control** — audit, roles, retention in a separate admin surface ![Admin Console](output/release/v11.0.1/screenshots/10-admin-console.png) |
+| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v11.0.1/screenshots/11-knowledge-journey.png) | **Say how much it may do alone** — one dial in plain words; dangerous actions stay blocked either way ![Settings](output/release/v11.0.1/screenshots/08-system.png) |
 
 ## Why Lattice AI
 
@@ -58,64 +58,53 @@ First-run flow — wake the Brain, pick the owner, load a recommended model:
 
 | | | |
 | --- | --- | --- |
-| ![Login](output/release/v10.9.0/screenshots/01-login.png) | ![Model install](output/release/v10.9.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v10.9.0/screenshots/07-model-library.png) |
+| ![Login](output/release/v11.0.1/screenshots/01-login.png) | ![Model install](output/release/v11.0.1/screenshots/03-install-load-progress.png) | ![Model library](output/release/v11.0.1/screenshots/07-model-library.png) |
 
 Screenshot index and capture notes:
-[output/release/v10.9.0/SCREENSHOT_INDEX.md](output/release/v10.9.0/SCREENSHOT_INDEX.md)
+[output/release/v11.0.1/SCREENSHOT_INDEX.md](output/release/v11.0.1/SCREENSHOT_INDEX.md)
 
 ## Current Release
 
-The current release is **10.9.0 — Never Blocks**:
-
-Lattice AI runs one event loop on your computer. Several things you could ask
-it to do were being done *on* that loop, so while they ran the server could not
-answer anything else. Downloading a model has a fifteen-minute timeout; that is
-how long the whole product could be frozen by one click.
-
-- **Nothing long runs on the event loop.** Model pulls, engine installs, MCP
-  package installs and the CPU/RAM probe behind the System screen all moved to
-  a worker thread. `/local/sysinfo` is the one most people met without knowing:
-  it is read by the System screen *and* by first-run analysis, so its ~2s
-  freeze landed exactly while an answer was streaming. Two things keep it
-  fixed — ruff's `ASYNC` blocking-call rules, and
-  `tests/unit/test_event_loop_not_blocked.py`, which runs a ticker coroutine
-  during the handler and asserts the loop kept getting control.
-- **A focus ring you can see.** 10.8.0 added `border-color` to the transition
-  on the capture pills, so keyboard focus faded in over 150ms and at the
-  instant it landed the pill still looked idle. Focus rings may not ease.
-- **The Brain stops thinking when it has answered.** A retrieval pulse parked a
-  900ms timer that put the organism back into "thinking"; if the answer
-  finished inside that window the timer still fired, and the Brain sat visibly
-  working on a question it had already answered.
-- **One language, further in.** Fourteen more routers moved to the message
-  catalog — chat, memory, graph, files, portability, review, models, tools,
-  MCP, setup. `models.py`, `mcp.py` and `tools.py` had been answering some
-  errors in Korean and others in English on the same screen. Two gates keep
-  them migrated, and a third fails if the two gates disagree.
-- **The welcome screen fits.** It measured 770px against a 747px viewport, so
-  the line explaining what you are agreeing to sat under the fold. Nothing was
-  removed; the whitespace gave back the 25px.
-- **The streaming answer path has tests.** `useBrainChat` was 12% covered
-  because asserting anything about a stream needs frames arriving over time.
-  `frontend/src/test/fakeChatStream.ts` is that harness; eleven cases now cover
-  the answer building up, the stop button, refusals, grounding badges and live
-  step frames.
-- **Evidence bound to this build.** `output/release/v10.9.0/` holds the twelve
-  capture screens, walkthrough gif/webm, and the asset-manifest / mock-server
-  fingerprints that lint re-checks before merge. 10.9.0 claims no screen
-  redesign, and `scripts/release_screen_claims.json` says so explicitly.
-- **Exact artifact names only.** Publish paths list `dist/ltcai-10.9.0-*` and
-  `ltcai-10.9.0.tgz` — never `dist/*`.
+The current release is **11.0.1 — Both Branches**:
+
+11.0.0 put every line under test and documented, unfixed, the defects that
+work surfaced. 11.0.1 is the settling of that account: **all eleven
+documented defects are fixed, the code they proved dead is gone, and the CI
+floor now holds 100% of branch arcs as well as lines.**
+
+- **Every 11.0.0 finding is fixed.** The Telegram helper that sent the local
+  server's auth header to api.telegram.org, the unload-all that fabricated
+  success, the HTML inspector whose stylesheet collection could never fire,
+  the review-item id that collided within one second, the vLLM zombie that
+  read as "already running", the security dashboard's listing/detail
+  redaction gaps and invalid-JSON exports, the embedding `model_id` frozen at
+  the wrong dimension, the fast-path model-name mismatch, and the workspace
+  routes' dead literal and unreachable 404 arms. Each fix flipped the test
+  that had pinned the broken behaviour and gained a regression test.
+- **Branch coverage joined the floor.** `branch = true` is now in the
+  coverage config: both directions of all 9,828 conditionals execute under
+  the suite (5,798 tests, up from 5,426), and `fail_under = 100` fails CI on
+  a single missed arc. Exclusions stay honest: eight reasoned
+  `pragma: no cover` lines and two reasoned `pragma: no branch` lines.
+- **Dead code left the tree.** The unused auto-approved write-policy factory,
+  an unused snapshot-import normalizer, the workspace 404 arms shadowed by
+  the anti-enumeration 403, a provably-dead version guard, a provably-dead
+  MLX condition, and the vLLM silent-success recheck — each removal proved by
+  AST/reference scan before deletion.
+- **Verified where CI runs.** The full suite passes with the branch gate on
+  macOS 3.14, a fresh-resolve python 3.11 environment (fastapi 0.141), and a
+  clean linux python:3.14 container — the three environments that caught
+  11.0.0's release-day failures.
 
 Release notes: [RELEASE.md](RELEASE.md) · Full history: [docs/CHANGELOG.md](docs/CHANGELOG.md)
 
-Expected artifacts for 10.9.0 release must use exact filenames:
+Expected artifacts for 11.0.1 release must use exact filenames:
 
-- `dist/ltcai-10.9.0-py3-none-any.whl`
-- `dist/ltcai-10.9.0.tar.gz`
-- `ltcai-10.9.0.tgz`
-- `dist/ltcai-10.9.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_10.9.0_aarch64.dmg`
+- `dist/ltcai-11.0.1-py3-none-any.whl`
+- `dist/ltcai-11.0.1.tar.gz`
+- `ltcai-11.0.1.tgz`
+- `dist/ltcai-11.0.1.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_11.0.1_aarch64.dmg`
 
 Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
@@ -150,6 +139,9 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for details and
 
 | Version | Theme |
 | --- | --- |
+| 11.0.1 | Both Branches |
+| 11.0.0 | Full Measure |
+| 10.10.0 | Quiet Station |
 | 10.9.0 | Never Blocks |
 | 10.8.0 | Within Reach |
 | 10.7.0 | Plain Surface |
@@ -185,16 +177,6 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for details and
 | 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)
 

package/docs/CHANGELOG.md

@@ -4,6 +4,78 @@ 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.
 
+## [11.0.1] - 2026-08-10
+
+### Fixed
+- 11.0.0 릴리스 노트가 기록한 결함 11건 전부: Telegram `send_web_link`의
+  서버 토큰 유출과 전체 언로드 성공 조작, `inspect_html` 스타일시트 데드
+  수집, 리뷰 아이템 id 초 단위 충돌, vLLM 좀비 재확인(침묵 성공 → 409),
+  보안 대시보드 목록/상세 마스킹 갭과 invalid-JSON 내보내기, 임베딩
+  `model_id` 차원 동결, fast-path `X-Model`/SSE 본문 불일치, 워크스페이스
+  응답의 죽은 `"ok"` 리터럴과 미도달 404 arm. 각 수정은 결함을 고정하던
+  테스트를 반전하고 회귀 테스트를 추가했습니다.
+
+### Changed
+- 커버리지 게이트가 분기까지 잡습니다: `[tool.coverage.run] branch = true`,
+  9,828아크 전부 실행, `fail_under = 100`은 이제 라인+분기 합산.
+  테스트 5,426 → 5,798개. `pragma: no branch`는 사유 명시 2줄.
+
+### Removed
+- 참조-0 증명 후 죽은 코드 삭제: `tool_registry._wa()`,
+  `workspace_os_utils._snapshot_graph_import_payload`, 워크스페이스 404
+  arm 2개, vLLM 침묵 성공 분기, 증명된 죽은 조건 3곳
+  (model_catalog 버전 가드 · model_compat MLX 조건 · retrieval_docgen
+  blank-query 가드).
+
+## [11.0.0] - 2026-08-10
+
+### Changed
+- Python 테스트 커버리지 72.80% → **100.00%**, CI 게이트 `fail_under = 100`.
+  테스트 2,269 → 5,426개(+3,157, 신규 파일 145개). 제외는 도달 불가 사유가
+  명시된 `pragma: no cover` 8줄뿐이며, MLX/Windows/watchdog 등 플랫폼 잠금
+  분기는 페이크 모듈·시임 패치로 ubuntu CI에서도 실행됩니다.
+- `build_phases` 후반 4개 페이즈가 `test_security.py`의 server-import
+  부수효과 없이 전용 테스트(RuntimeContext 직접 구동)로 커버됩니다.
+- ARCHITECTURE.md 검증 다이어그램이 실측값으로 갱신되고 "보고만 되고 강제
+  안 되는" 점선 상자가 사라졌습니다(양쪽 커버리지 모두 100% 플로어).
+
+### Internal
+- 커버리지 작업이 드러낸 실제 결함·죽은 분기 11건은 동작 변경 없이
+  RELEASE_NOTES_v11.0.0.md에 기록되고, 현재 동작을 그대로 단언하는
+  테스트로 고정됐습니다(수정은 다음 릴리스 후보).
+
+## [10.10.0] - 2026-08-06
+
+### Changed
+- Brain 대화 홈 "Quiet Station" 재설계 — 기억/주제 통계가 인사말 줄의 문장에서
+  호버·클릭 팝오버(요약 그래프 + 기억 지도 바로가기)를 여는 배지로, 캡처 칩
+  6개(문서/이미지/파일/폴더/노트/웹)가 컴포저의 `+ 추가` 접이식 메뉴로, 모델
+  준비 배너가 히어로 우측 상태 필로, 하단 서랍 2개(지난 대화 · Brain이 정리한
+  내용)가 좌측 독 레일(대화 · 통계 · 기억 지도)의 포커스 트랩 서랍으로
+  이동했습니다. 카드 보더는 소프트 섀도로 대체되고, 액센트 컬러는 보내기
+  버튼과 모델 CTA 두 곳에만 남습니다.
+- 공개 릴리스 히스토리가 9.0.0부터 시작합니다 — 8.x 릴리스 노트 9개 파일을
+  제거하고 README/RELEASE_NOTES.md/RELEASE.md/CHANGELOG이 같은 경계를
+  서술합니다.
+
+### Fixed
+- 히어로의 `overflow: clip`이 새 통계 팝오버를 잘라내던 문제(클립 제거 —
+  헤일로는 `--aura-blur`로 이미 조여져 있어 가둘 것이 없습니다).
+- 포털 서랍 내부에서 `.brain-care-panel` 계열 중첩 그리드 패널의 행이 2px로
+  붕괴해 버튼이 클릭 불가능하던 문제 — 서랍 본문을 flex 컬럼으로 전환.
+- 호버로 열린 배지/+ 메뉴를 곧바로 이은 클릭이 도로 닫아버리던 경합 —
+  350ms 열림 디바운스.
+- 새 + 버튼 aria-label의 "메뉴 열기" 문구가 셸 메뉴 버튼과 role 매칭
+  충돌하던 문제.
+
+### Added
+- 프론트엔드 커버리지 100% — `frontend/src` 전체 statements/branches/
+  functions/lines, vitest thresholds 100, CI 커버리지 게이트.
+- `scripts/release_screen_claims.json`의 10.10.0 항목
+  (04-brain-chat-home, min 3%).
+- 비주얼 스펙이 새 홈 계약(+ 메뉴 접힘, 독 서랍, 배지 팝오버, 글로우 기하)을
+  검증합니다.
+
 ## [10.9.0] - 2026-08-05
 
 ### Fixed
@@ -1633,240 +1705,3 @@ Response to a full code review of 10.1.1 (71/100). All twelve findings.
   bridge notification, no-model, single-answer, direct-file, and agent-file
   response paths out of the main `/chat` handler, with regression coverage for
   the shared fast-path epilogue.
-
-## [8.9.0] - 2026-07-06
-
-### Added
-- Added authenticated user/workspace scoping to durable conversation history
-  reads and deletes.
-- Added workspace-aware Knowledge Graph search, traversal, relationship, node,
-  and chat-context reads.
-- Added direct HTTP/MCP Tool API policy enforcement for registry-governed tools.
-- Added permission approval queue hashing and atomic writes so raw tokens are
-  not persisted at rest.
-- Added confirmation-token guarded installer/process command plans with redacted
-  local process audit events.
-- Added regression coverage for scoped history, graph scoping, tool policy
-  gates, AgentRuntime approval semantics, permission tokens, session TTL
-  injection, and model-download runtime config.
-
-### Changed
-- AgentRuntime now requires explicit human approval for non-auto-approved plans
-  and rolls back git-governed tool results even when `success` is omitted.
-- Model download consent now uses configured runtime state instead of direct
-  environment-variable reads.
-- Frontend API base logic, CSS token/base rules, and i18n literal checks were
-  split into smaller maintainability seams.
-- Version bumped to 8.9.0 across Python, npm, VS Code extension, Tauri, static
-  metadata, readiness gates, release notes, and current-release documentation.
-- Documentation now states that SQLite is the live local Brain store; Postgres
-  remains optional scale/migration tooling.
-
-### Fixed
-- Conversation store migration now creates the workspace index only after the
-  scope columns exist.
-- Direct `write_file`/`edit_file` policy lookup now blocks system write
-  prefixes consistently with local-file approvals.
-- Workspace selection clearing now removes the persisted workspace id.
-- Tauri/local API fetches now include credentials for localhost backend
-  sessions.
-
-## [8.8.0] - 2026-07-06
-
-### Added
-- Added Brain Core isolation coverage that keeps `lattice_brain` independent of
-  product-package imports.
-- Added recall proof quality gates for matched terms, confidence labels, and
-  lexical evidence filtering.
-- Added Brain Chat conversation controls for new/resume/delete, stop,
-  regenerate, copy, and richer ingestion progress.
-
-### Changed
-- Removed internal-only Brain shim layers: flat pre-graph modules,
-  `latticeai.brain`, and `latticeai.services.agent_runtime`.
-- Updated legacy compatibility reporting so removed shim layers are tracked
-  separately from remaining external root shims.
-- Hardened AgentRuntime boundary handling for unknown roles, legacy run
-  contracts, and persisted retry budgets.
-- Version bumped to 8.8.0 across Python, npm, VS Code extension, Tauri, static
-  metadata, readiness gates, release notes, and current-release documentation.
-
-### Fixed
-- File ingestion now rejects directory paths before dispatching to document
-  ingestion.
-- Memory recall filters low-evidence noise when stronger lexical matches are
-  present and surfaces explainable citation confidence.
-
-## [8.7.0] - 2026-07-05
-
-### Added
-- Added unit test coverage for model-runtime `STATE` source-of-truth behavior
-  and deprecation warnings on legacy global synchronization.
-- Added refreshed 8.7.0 screenshots, walkthrough GIF/WebM, and capture notes
-  under `output/release/v8.7.0/`.
-
-### Changed
-- Reduced internal reliance on bare module globals in
-  `latticeai/services/model_runtime.py`; implementation logic now consistently
-  reads from the `ModelRuntimeState` instance while globals remain as a legacy
-  compatibility surface.
-- Added `DeprecationWarning` to `sync_to_module_globals()` while preserving the
-  external shim behavior.
-- Removed a loose `as any` cast from `frontend/src/pages/Act.tsx`.
-- Version bumped to 8.7.0 across Python, npm, VS Code extension, Tauri, static
-  metadata, README evidence links, release notes, and current-release
-  documentation.
-
-### Fixed
-- Internal model-runtime functions now prefer the typed state object per the
-  project preference for composition over global mutable state.
-
-## [8.6.0] - 2026-07-05
-
-### Added
-- Added Tauri localhost remote capability coverage so the desktop app can keep
-  using local IPC commands after navigating to the FastAPI-served `/app`.
-- Added a regression trust gate for the Tauri localhost capability.
-
-### Changed
-- Improved the Capture source flow: desktop users can choose a folder with the
-  native folder picker and immediately scan/connect it, while web page capture
-  now supports paste, Enter-to-save, and `https://` normalization for bare
-  domains.
-- Updated Visual Smoke coverage for the new Brain shell sidebar and admin
-  console entry flow.
-- Version bumped to 8.6.0 across Python, npm, VS Code extension, Tauri, static
-  metadata, readiness gates, and current-release documentation.
-
-### Fixed
-- Fixed native folder selection from the Tauri production app's localhost
-  webview and added visible fallback feedback when the picker is unavailable.
-- Removed negative letter spacing from updated frontend shell styling.
-
-## [8.5.0] - 2026-07-01
-
-### Added
-- ToolRegistry now reports `ready: true` with full handler/governance/description alignment (added `vision_analyze` policy and description).
-- `tz_name` now flows from central `Config` into `TriggerService` (via updated automation and platform wiring runtimes) for better DI and Config centralization.
-
-### Changed
-- Full codebase scan completed; improvements prioritized per AGENTS.md (registry, config injection, wiring seams).
-- Version bumped to 8.5.0 across pyproject.toml, package.json, vscode-extension; all current-release doc references synchronized.
-- Documentation sync performed for README, RELEASE.md, docs/CHANGELOG.md and Current release markers.
-
-### Fixed
-- Eliminated ToolRegistry drift for `vision_analyze` (handler existed in tools/ but missing from core registry governance surface used by diagnostics, MCP, and permission views).
-
-## [8.4.0] - 2026-07-01
-
-### Added
-- Added a chat-to-agent file action gate so explicit file create/write/save/edit
-  requests from Brain Chat execute through the governed workspace file tool.
-- Added regression coverage that verifies `/chat` routes file creation intent to
-  the workspace file tool and returns created artifact metadata.
-
-### Changed
-- Kept ordinary Q&A on `/chat` while routing only explicit side-effect file
-  requests into the planner/executor/reviewer tool loop.
-- Synchronized package/runtime/static/Tauri metadata and current-release docs to
-  8.4.0.
-
-### Fixed
-- Allowed literal `/chat` file writes with user-provided content to execute
-  before model loading, while still using a loaded model when content must be
-  synthesized.
-- Narrowed file target and content parsing to avoid treating surrounding prose
-  as the workspace path or literal file body.
-- Restored model loading dependency exports after the runtime/loading split so
-  `/models/load` can prepare local MLX models again.
-- Added the common Gemma 4 26B shorthand alias to the canonical
-  `mlx-community/gemma-4-26b-a4b-it-4bit` model id.
-- Updated the local server launcher to run `python -m uvicorn` from the active
-  virtual environment, avoiding stale console-script interpreter bindings.
-
-## [8.3.0] - 2026-07-01
-
-### Added
-- Added a managed legacy compatibility report for remaining root shims,
-  including owners, replacements, reasons, removal phases, and readiness
-  metrics.
-- Added AgentRuntime/workflow maturity evidence through lifecycle helper reuse,
-  legacy event compatibility, WorkflowEngine boundary/config inspection, and
-  centralized legacy workflow step projection.
-- Added graph ingestion coverage for upload-to-pipeline behavior and
-  workspace-safe duplicate content.
-- Added 8.3.0 onboarding and community/plugin growth documentation.
-
-### Changed
-- Routed `/knowledge-graph/ingest` through the unified `IngestionPipeline` when
-  available, preserving provenance and hook lifecycle behavior for MCP notes and
-  messages.
-- Isolated text/web/note graph node identity by workspace while preserving the
-  content hash used for duplicate detection.
-- Converted `mcp_registry.py` and `llm_router.py` into physical module aliases
-  for their current implementations.
-- Improved upload client error handling so failed uploads cannot look
-  successful.
-- Synchronized package/runtime/static/Tauri metadata and current-release docs to
-  8.3.0.
-
-### Upgrade Notes
-- Existing legacy-global text/web/note graph nodes are not rewritten in place.
-  Re-ingesting the same content with a workspace id can create a separate
-  workspace-scoped node; re-index existing sources after upgrading when you want
-  provenance to converge on workspace scopes.
-
-## [8.2.0] - 2026-06-27
-
-### Added
-- Added an evidence-backed Brain Brief to Brain Home so users can see what to
-  notice, what evidence supports it, and what action to take next.
-- Added `GET /api/memory/brain-brief`, backed by `MemoryService.brain_brief()`,
-  with honest empty-state guidance and recall/graph/model-proof actions.
-- Added unit coverage for Brain Brief service behavior and the memory API route.
-
-### Changed
-- Completed the remaining model loading/runtime extraction into
-  `model_loading.py` and `model_engines.py` while preserving compatibility
-  delegations from `model_runtime.py`.
-- Extracted WorkspaceOS graph trace, agent/workflow run, skill, and snapshot
-  comparison ownership into focused manager modules.
-- Wired Knowledge Graph embedding dimensions from the central resolved `Config`
-  embedder at app startup.
-- Synchronized Python, npm, VS Code extension, Tauri, workspace, readiness,
-  static asset, and current-release documentation versions to 8.2.0.
-
-## [8.1.0] - 2026-06-27
-
-### Changed
-- Rebuilt Brain Home around an intuitive first screen with LivingBrain, recent
-  memory, connected topic, next-best action, and the composer visible together.
-- Replaced dashboard-style Brain growth metrics with narrative, product-facing
-  copy and focused primary actions.
-- Tightened mobile and narrow viewport behavior so the Brain and composer remain
-  visible without horizontal overflow.
-- Refreshed release screenshots, walkthrough GIF/WebM, static app assets, and
-  exact 8.1.0 artifact metadata.
-- Synchronized Python, npm, VS Code extension, Tauri, workspace, readiness, and
-  current-release documentation versions to 8.1.0.
-
-## [8.0.0] - 2026-06-24
-
-### Changed
-- Added `lattice-architecture-contract/v1` to make the AgentRuntime,
-  ToolRegistry, Config, server decomposition, and Knowledge Graph stabilization
-  boundaries explicit and testable for the major architecture line.
-- Added `tool-registry-contract/v1` to the ToolRegistry manifest, including
-  dispatch, policy, and permission ownership.
-- Updated architecture and product readiness targets to 8.0.0.
-- Synchronized package/runtime/static/Tauri metadata to 8.0.0.
-- Updated current-release docs and exact artifact names to 8.0.0 while
-  setting 8.0.0 as the oldest retained release-history entry.
-
-### Fixed
-- Made logical Knowledge Graph `replace` imports transactional so malformed
-  imports roll back without clearing the existing graph.
-- Locked v2 read-equivalence coverage for `list_documents`, `get_node`,
-  `relationship_search`, and `traverse`.
-- Preserved colliding legacy edge labels during logical import/backfill while
-  keeping native write-door synonym dedupe canonical.

package/docs/COMMUNITY_AND_PLUGINS.md

@@ -1,6 +1,6 @@
 # Community And Plugins
 
-Current release: **10.9.0 — Never Blocks**.
+Current release: **11.0.1 — Both Branches**.
 
 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

@@ -3,7 +3,7 @@
 > **Status: canonical** — current contributor guidance, kept in sync with the
 > current release.
 
-Current release: **10.9.0 — Never Blocks**.
+Current release: **11.0.1 — Both Branches**.
 
 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: **10.9.0 — Never Blocks**.
+Current release: **11.0.1 — Both Branches**.
 
 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/OPERATIONS.md

@@ -1,4 +1,4 @@
-# Lattice AI — Operations Guide (v10.9.0)
+# Lattice AI — Operations Guide (v11.0.1)
 
 > **Status: canonical** — kept in sync with the current release. Storage layout
 > below reflects the SQLite live Brain store and workspace scoping, not the

package/docs/PERFORMANCE.md

@@ -1,12 +1,11 @@
 # Knowledge Graph Performance Baseline
 
-> **Status: reference** — a synthetic regression baseline, not a
-> current-release measurement. The numbers below were last captured on the
-> v9.6.0 working tree (see provenance line) and are carried forward as the
-> comparison reference. The 9.7.0-9.8.0 line added graph-layer paths
-> (`hybrid_search`, vector freshness, extraction-quality scoring), so
-> regenerate with `scripts/profile_kg.py` on the current tree before treating
-> these as 9.8.0 numbers.
+> **Status: mixed provenance — read the date on each table.** The
+> `scripts/profile_kg.py` tables were last captured on the v9.6.0 working tree
+> and are carried forward as the regression reference; regenerate them before
+> treating them as current. The **vector index backend** table is a fresh
+> 11.1.0 measurement (2026-08-10) from `scripts/bench_vector_index.py`, and
+> says so inline.
 
 Synthetic performance and memory baseline for `KnowledgeGraphStore`
 (`lattice_brain/graph/`). Measured with `scripts/profile_kg.py`.
@@ -92,6 +91,78 @@ Keyword search p50 grew ~3.6x but stays under 5 ms.
 Regenerate with `.venv/bin/python scripts/profile_kg.py` after graph-layer
 changes and compare against these tables.
 
+## Vector index backends (11.1.0)
+
+`scripts/bench_vector_index.py` measures the three selectable backends
+(`LATTICEAI_VECTOR_INDEX`) against each other. It answers two questions
+together, because either one alone is misleading: **how fast** each backend
+answers, and **how much of the exact answer it returns** (recall@10 against
+the brute-force scan, which is ground truth by construction).
+
+Methodology, and what it does not cover:
+
+- The corpus is synthetic — deterministic pseudo-text from a fixed vocabulary
+  (English + Korean) embedded with the built-in hash embedder. Real embeddings
+  cluster differently, so the recall figures are an upper bound for a
+  well-separated corpus, not a promise about your notes.
+- Rows are written straight into `vector_embeddings`. This measures the
+  **search** path only; ingestion throughput stays in the tables above.
+- Latency and memory are measured in separate passes. tracemalloc roughly
+  triples Python allocation cost, so timing under it would measure the
+  profiler — the `peak MB` column comes from one extra traced query.
+- `first ms` is the *first* query after the corpus changed. For `hnsw` that is
+  where the graph gets built and the `.hnsw` sidecar written; for the other two
+  it is an ordinary query.
+- `hybrid p50` is `hybrid_search` (lexical + vector fusion) on that backend —
+  the number a user's question actually pays.
+- The candidate cap is **lifted** (`--max-candidates 0`). This matters more
+  than it sounds: with the product default of 10 000, the exact scan on a
+  larger index silently becomes "the newest 10 000 rows", and recall@10 would
+  then be measured against a baseline that never looked at most of the corpus.
+  The first 50k run made exactly that mistake and scored HNSW at 0.18 — not
+  because it missed anything, but because the two backends had searched
+  different candidate sets. The `trunc` column now reports whether any query
+  hit a cap.
+
+Run it:
+
+```bash
+.venv/bin/python scripts/bench_vector_index.py                  # 10k vectors
+.venv/bin/python scripts/bench_vector_index.py --nodes 1000     # quick
+.venv/bin/python scripts/bench_vector_index.py --json           # machine-readable
+```
+
+### Measured, 2026-08-10 — 10 000 vectors, 30 queries, top_k 10
+
+macOS 27 (arm64, Apple Silicon), Python 3.14.5, SQLite 3.53.1,
+hnswlib 0.8.0, uncapped candidates, corpus build 2.12 s.
+
+| backend | p50 ms | p95 ms | first ms | peak MB | recall@10 | hybrid p50 ms |
+|-----------|-------:|-------:|---------:|--------:|----------:|--------------:|
+| brute     | 288.89 | 291.95 |   290.68 |   39.72 |    1.000  |        296.63 |
+| quantized | 639.47 | 645.93 |   653.31 |   38.38 |    0.987  |        639.83 |
+| hnsw      |  21.53 |  22.11 |   795.84 |    0.74 |    0.953  |         24.37 |
+
+What the table says, plainly:
+
+- **The default is exact and slow.** 289 ms per query at 10k, and hybrid
+  inherits nearly all of it (297 ms) — the vector channel *is* the cost.
+- **HNSW meets the 11.1.0 target and prices it.** Hybrid p50 **24.4 ms** at 10k
+  (target: < 50 ms), a 12x improvement, in exchange for **4.7% of the exact
+  top-10 going missing**. That is the trade, stated as a number rather than as
+  the word "approximate". Its 0.74 MB peak is the two-phase lookup: it reads
+  only the ten rows it returns, where the exact scan reads all 10 000.
+- **The 796 ms first query is the graph build**, paid once per index generation
+  and then persisted to the `.hnsw` sidecar. Any write to `vector_embeddings`
+  invalidates the fingerprint and buys that cost again, which is why `brute`
+  stays the default for a continuously-ingesting brain.
+- **Quantized is currently the wrong choice on every axis.** ~2.2x the latency
+  for 0.987 recall, and its RAM advantage does not materialise (38.4 vs
+  39.7 MB): the exact scan already feeds the index in bounded batches, so
+  resident vectors were never the dominant term — the fetched SQLite rows are.
+  It ships as an honest, exhaustive backend and as the representation a held
+  cross-query index would need. It is not a recommendation.
+
 ## Observations
 
 - Keyword `search()` / `context_for_query()` stay low-millisecond thanks to

package/docs/TRUST_MODEL.md

@@ -1,6 +1,6 @@
 # Lattice AI Trust Model
 
-Current release: **10.9.0 — Never Blocks**.
+Current release: **11.0.1 — Both Branches**.
 
 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: **10.9.0 — Never Blocks**.
+Current release: **11.0.1 — Both Branches**.
 
 **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: **10.9.0 — Never Blocks**.
+Current release: **11.0.1 — Both Branches**.
 
 명세 출처: `lattice_ai_full_spec.pptx` 슬라이드 20·21·22
 구현: `lattice_brain/graph/schema.py`