ltcai 11.2.0 → 11.5.0

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)
 
-![v11.2.0 Living Brain walkthrough](output/release/v11.2.0/gifs/v11.2.0-living-brain-walkthrough.gif)
+![v11.5.0 Living Brain walkthrough](output/release/v11.5.0/gifs/v11.5.0-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/v11.2.0/screenshots/04-brain-chat-home.png) | **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v11.2.0/screenshots/05-memory-graph.png) |
-| **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v11.2.0/screenshots/06-capture.png) | **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v11.2.0/screenshots/12-review-center.png) |
-| **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v11.2.0/screenshots/02-recommended-models.png) | **Stay in control** — audit, roles, retention in a separate admin surface ![Admin Console](output/release/v11.2.0/screenshots/10-admin-console.png) |
-| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v11.2.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/v11.2.0/screenshots/08-system.png) |
+| **See your Brain's story in time** — a growth curve, an activity heatmap, and each day's story, rewindable to any past moment ![Brain Chronicle](output/release/v11.5.0/screenshots/13-chronicle.png) | **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v11.5.0/screenshots/04-brain-chat-home.png) |
+| **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v11.5.0/screenshots/05-memory-graph.png) | **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v11.5.0/screenshots/06-capture.png) |
+| **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v11.5.0/screenshots/12-review-center.png) | **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v11.5.0/screenshots/02-recommended-models.png) |
+| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v11.5.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/v11.5.0/screenshots/08-system.png) |
 
 ## Why Lattice AI
 
@@ -58,63 +58,57 @@ First-run flow — wake the Brain, pick the owner, load a recommended model:
 
 | | | |
 | --- | --- | --- |
-| ![Login](output/release/v11.2.0/screenshots/01-login.png) | ![Model install](output/release/v11.2.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v11.2.0/screenshots/07-model-library.png) |
+| ![Login](output/release/v11.5.0/screenshots/01-login.png) | ![Model install](output/release/v11.5.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v11.5.0/screenshots/07-model-library.png) |
 
 Screenshot index and capture notes:
-[output/release/v11.2.0/SCREENSHOT_INDEX.md](output/release/v11.2.0/SCREENSHOT_INDEX.md)
+[output/release/v11.5.0/SCREENSHOT_INDEX.md](output/release/v11.5.0/SCREENSHOT_INDEX.md)
 
 ## Current Release
 
-The current release is **11.2.0 — All Systems On**:
-
-11.1.0 built the intelligence layer; 11.2.0 makes sure **every part of it
-actually works, ships today's models, and puts the switches in your hand.**
-
-- **The model catalog is current and verified.** Every recommended model
-  was checked against the live Hugging Face API — no weights downloaded, no
-  model loaded, nothing run on your machine. Two models that had vanished
-  from the Hub (phi-3.5-vision, moondream2), four gated repos and three
-  obsolete generations left the catalog; the ten recommendations are all
-  2025–2026 builds (Gemma 4 line, Qwen3.5/3.6, gpt-oss-20b, LFM2.5 with
-  Korean support), RAM-tiered, with exact-case ids, real byte sizes (one
-  entry claimed 11.8 GB for a 61 GB repo) and a static-loadability verdict
-  whose limits are stated, not hidden. Already-downloaded older models stay
-  recognised so nobody's local weights become orphans.
-- **Every switch is yours now.** A new 기능 drawer on the Brain home's dock
-  lists every opt-in capability — multimodal memories, video, brain
-  network sharing, vault watch, photo semantic search, RRF fusion, graph
-  expansion, automatic synthesis, background indexing, and the vector
-  backend choice — each with a plain-language line, its current source
-  (default / env / you), and a live switch. Toggles apply at runtime
-  through injected gate seams; an uninstalled backend says "install
-  needed" instead of pretending.
-- **The scope-outs are in.** Notion-export, Git-history and mail/calendar
-  bridges (all through the single ingestion gate with approval and
-  dry-run), recipient public-key encryption for subgraph shares (X25519
-  sealed box; passphrase mode stays), video ingestion via guarded ffmpeg
-  keyframes with subtitle companions, vault watch mode, bulk review
-  approval, the Self-Model summary reaching the agent loop, and text→image
-  semantic photo search.
-- **A 58-row evidence audit** verified every documented feature against
-  the running app: 51 worked as documented; the rest were fixed (a
-  permanently blank briefing health section, cloud memory write-back that
-  never reached the Review Center, an empty Brain scoring 100/excellent)
-  or the docs were lowered to the truth. The audit ships as
-  [docs/FEATURE_AUDIT_v11.2.0.md](docs/FEATURE_AUDIT_v11.2.0.md).
-
-All of it lands with the floor intact: **6,490 tests, 100.00% of 39,054
-statements and 11,014 branches**, verified on macOS 3.14, a fresh-resolve
-python 3.11 environment, and a clean linux python:3.14 container.
+The current release is **11.5.0 — Rust Complete**:
+
+Phases 2–4 of the Rust roadmap land in one release — as **working, proven
+pieces**, with Python converging to its target role: the AI Worker.
+
+- **The desktop's front door is now the Rust gateway.** The Tauri shell
+  boots the supervisor + gateway topology by default and the webview
+  lives at the gateway origin. The one real blocker — a CSRF policy
+  bound to the worker's own port — is dissolved by environment
+  injection, proven live against the real Python worker (trusted
+  origins 200, foreign origins 403). Three escape hatches preserve the
+  previous topologies.
+- **The native surface grew fourfold.** `lattice-retrieval` now serves
+  the three-channel service search, graph reads (search /
+  relationships / traverse), the full history read family, and the
+  chat context assembler — **191/191 exact-parity goldens, zero
+  epsilon**. `lattice-ingest` carries the typed chunker (332 golden
+  chunks, and a 26/26 mutation-test pass proving every constant
+  load-bearing) plus the polling folder watcher; writes stay delegated
+  to the worker, the single writer. `lattice-agent` carries the
+  permission kernel — **2,452 exact decision-table verdicts** — and
+  natively executes only validated read-only commands in a replaced
+  environment. `lattice-jobs` closes a documented gap: the durable
+  embed queue now has a scheduler (60s ticks, honest backoff,
+  `/host/jobs` status) driving a new fully-covered drain endpoint.
+- **The honest boundary, stated.** The Python worker keeps the document
+  parser matrix, embedding production, LLM inference, mutating tool
+  execution, and all graph writes. The agent loop orchestration port
+  remains for a future release, for reasons written down in the plan.
+
+All of it lands with the floor intact: **6,861 Python + 1,761 frontend
+tests at 100.00% statement and branch coverage, 534 Rust workspace
+tests**, four bidirectional golden families, mypy/ruff/clippy clean,
+verified on macOS 3.14 and a fresh-resolve python 3.11 environment.
 
 Release notes: [RELEASE.md](RELEASE.md) · Full history: [docs/CHANGELOG.md](docs/CHANGELOG.md)
 
-Expected artifacts for 11.2.0 release must use exact filenames:
+Expected artifacts for 11.5.0 release must use exact filenames:
 
-- `dist/ltcai-11.2.0-py3-none-any.whl`
-- `dist/ltcai-11.2.0.tar.gz`
-- `ltcai-11.2.0.tgz`
-- `dist/ltcai-11.2.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_11.2.0_aarch64.dmg`
+- `dist/ltcai-11.5.0-py3-none-any.whl`
+- `dist/ltcai-11.5.0.tar.gz`
+- `ltcai-11.5.0.tgz`
+- `dist/ltcai-11.5.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_11.5.0_aarch64.dmg`
 
 Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
@@ -149,6 +143,9 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for details and
 
 | Version | Theme |
 | --- | --- |
+| 11.5.0 | Rust Complete |
+| 11.4.0 | Rust Foundation |
+| 11.3.0 | Time Remembers |
 | 11.2.0 | All Systems On |
 | 11.1.0 | Product Intelligence |
 | 11.0.1 | Both Branches |

package/docs/CHANGELOG.md

@@ -4,6 +4,93 @@ 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.5.0] - 2026-08-11 — Rust Complete
+
+### Added
+- **Phase 2–4 완결** (docs/v11.5.0_RUST_COMPLETE_PLAN.md): 신규 크레이트
+  `lattice-ingest`(typed chunking 4전략 1:1 포트 — 골든 332청크 완전
+  일치·뮤테이션 26/26, mtime 폴링 워처, 워커 위임 단일 작성자),
+  `lattice-jobs`(60s 드레인 스케줄러·백오프·`/host/jobs`·옵트인
+  autoresume), `lattice-agent`(권한 커널 — 모드 판정 2,358 + 명령 검증
+  59 + shlex 35 완전 일치, 읽기 전용 명령 네이티브 실행, `/rust/agent/*`).
+- `lattice-retrieval` 확장: 3채널 service-hybrid·graph_search·
+  relationship_search·traverse·히스토리 전 읽기·Context Assembler —
+  신규 패리티 116(총 191/191, 엡실론 0), 계약 pytest 199.
+- Python additive: `POST /api/index/drain` + `GET /api/index/queue`
+  (문·분기 100%, ko/en 로컬라이즈 21번째 라우터) — "배경 임베드 큐를
+  아무도 몰지 않는다" 한계 해소.
+- 게이트웨이 마운트 맵: `/rust/{search,graph,history,context,ingest,agent}`
+  + `/host/jobs*`; `/host`·`/rust` 네임스페이스는 프록시로 새지 않음.
+
+### Changed
+- **데스크톱 front-door 기본화**: Tauri가 게이트웨이 토폴로지로 기동
+  (웹뷰=게이트웨이 origin), CSRF는 `LATTICEAI_CSRF_TRUSTED_ORIGINS`
+  주입으로 해소(실워커 라이브 검증), 안전 밸브
+  `LATTICEAI_DESKTOP_DIRECT=1`/`BACKEND_ORIGIN`/`NO_BACKEND` 유지,
+  `backend_status`에 topology/worker_origin/gateway_origin/jobs_running
+  추가(기존 6필드 보존). SSE 프록시 `X-Accel-Buffering: no` 보강.
+
+## [11.4.0] - 2026-08-11 — Rust Foundation
+
+### Added
+- **`rust/` cargo workspace** (Rust 전환 Phase 1,
+  docs/v11.4.0_RUST_FOUNDATION_PLAN.md): `lattice-core`(같은
+  `knowledge_graph.sqlite` 읽기 전용 층 + 해시 임베더 bit-for-bit 포트,
+  FTS5 trigram 프로브), `lattice-retrieval`(hybrid/keyword/vector
+  네이티브 엔진 — 커밋된 Python 골든과 25질의×3엔진 **75/75 완전
+  일치**, `tests/unit/test_rust_parity_contract.py` 80테스트가 Python
+  쪽을 상시 잠금), `lattice-host`(워커 수퍼바이저: HTTP /health 게이팅
+  ·크래시 백오프 자동 재시작·SIGTERM 유예 종료·포트 통일 4825+스캔;
+  axum 게이트웨이: `/host/*`, 네이티브 `/rust/search/*`, 스트리밍
+  리버스 프록시 — 옵트인 front-door). Rust 테스트 194개.
+- CI `rust` 잡(ubuntu: cargo fmt --check / clippy -D warnings /
+  test --workspace, SHA 핀 액션), `npm run rust:test`/`rust:lint`.
+- `check_max_file_lines.mjs`가 `*.rs` 검사(43파일, 최장 491줄).
+
+### Changed
+- Tauri 데스크톱 셸이 `lattice-host` 수퍼바이저에 올라탐: `main.rs`
+  451→149줄, IPC 커맨드 5종 계약 보존(+추가 상태 필드), 백엔드 후보
+  해석의 `sort()+dedup()` 우선순위 파괴 버그 수정, TCP 프로브 →
+  HTTP /health, 포트 기본 8765→4825(+빈 포트 탐색,
+  `LATTICEAI_PORT`/`LATTICEAI_DESKTOP_BACKEND_ORIGIN` 존중).
+- `bump_version.py`·`test_version_consistency.py`가 rust workspace
+  버전(크레이트 3종 × 락파일 2종 포함)을 동기 — 타깃 18→25.
+
+## [11.3.0] - 2026-08-11 — Time Remembers
+
+### Added
+- **기억의 연대기 (Brain Chronicle)**: 7번째 주 화면 `#/chronicle`(별칭
+  `#/timeline`) — SVG 성장 곡선 + 키보드/터치 시간 핸들, 주×요일 활동
+  히트맵, 그날의 이야기 카드(자료·새 개념·대화·달라진 사실, 기존 화면
+  딥링크), `store.as_of()` 기반 되감기 패널. 신규 읽기 전용 API 3종:
+  `GET /api/chronicle/{overview,day/{date},as-of}` (앱 시간대 일 버킷,
+  워크스페이스 스코프, 그룹 200 상한+참값 counts). 서버 메시지 ko/en
+  등록(19번째 로컬라이즈 라우터), 신규 i18n 네임스페이스 `chronicle`,
+  릴리스 캡처 `13-chronicle.png`, visual mock 라우트 + Playwright 스펙.
+- **`scripts/check_max_file_lines.mjs`**: git 추적 1st-party 소스 전체
+  (py/ts/tsx/js/mjs/cjs/css)에 1,000줄 상한을 강제하는 lint 게이트.
+  생성물·벤더만 사유 명시 제외. 1,319개 파일 스캔, 초과 0.
+- 픽셀 게이트가 이번 릴리스에 새로 생긴 화면(베이스라인 태그에 없음)을
+  "new"로 보고하고 게이트하지 않되, 클레임된 화면의 베이스라인 누락은
+  여전히 실패로 처리.
+
+### Changed
+- **No Big Files 분해**: 1,000줄 초과 1st-party 파일 28개 전부 분해,
+  동작 변화 0 증명 동반 — `frontend/src/styles.css` 10,956→48줄
+  엔트리+core/ 20파일(빌드 산출 CSS byte-identical, cmp+sha256),
+  i18n `brain`/`workspace` 사전 → 도메인 파트 14개(key→value 맵 동일
+  증명), Python 18개 모듈 → 동명 패키지(모든 top-level 심볼 AST 동등성
+  증명, monkeypatch 대상 317+ 사이트 실위치 재표적, mypy files 목록·
+  setuptools packages 목록 갱신), `vscode-extension/extension.ts` →
+  7개 모듈, 대형 테스트 5개 + visual mock 서버 분해(576응답 동등성
+  대조). 공개 import 경로 불변.
+- 릴리스 증거 결속이 mock 서버 엔트리+라우트 모듈 전체를 지문화
+  (`scripts/lib/mock_server_fingerprint.mjs`, capture/check가 한 코드
+  경로 공유). i18n 고아 키 스캔·정의 수집이 네임스페이스 파트 파일
+  구조를 인식.
+- everyday 내비 4항목(대화·자료·기억·연대기)에 맞춰 상단바 축약
+  분기점 960px→1120px, 모바일 하단바 5탭(캡션 말줄임).
+
 ## [11.2.0] - 2026-08-11 — All Systems On
 
 ### Changed

package/docs/COMMUNITY_AND_PLUGINS.md

@@ -1,6 +1,6 @@
 # Community And Plugins
 
-Current release: **11.2.0 — All Systems On**.
+Current release: **11.5.0 — Rust Complete**.
 
 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: **11.2.0 — All Systems On**.
+Current release: **11.5.0 — Rust Complete**.
 
 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/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 ([`SingleAgentRuntime`](../latticeai/core/agent.py))
+*above* the v1.x single-agent state machine ([`SingleAgentRuntime`](../latticeai/core/agent/runtime.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.
 

package/docs/ONBOARDING.md

@@ -1,6 +1,6 @@
 # Lattice AI Onboarding
 
-Current release: **11.2.0 — All Systems On**.
+Current release: **11.5.0 — Rust Complete**.
 
 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 (v11.2.0)
+# Lattice AI — Operations Guide (v11.5.0)
 
 > **Status: canonical** — kept in sync with the current release. Storage layout
 > below reflects the SQLite live Brain store and workspace scoping, not the
@@ -176,7 +176,11 @@ Ctrl+C  또는  kill <pid>
    캡처 → 오래된 버전 정리 → **픽셀 델타 검사**까지 한 번에 돈다.
 4. 결속 검사 — `SCREENSHOT_INDEX.md` 의 `asset-manifest.sha256` 과
    `mock-server.sha256` 이 각각 `static/app/asset-manifest.json`,
-   `tests/visual/mock_server.cjs` 와 일치해야 `npm run lint` 가 통과한다.
+   그리고 목 API 표면 전체(`tests/visual/mock_server.cjs` +
+   `tests/visual/mock_server/*.cjs`) 와 일치해야 `npm run lint` 가 통과한다.
+   v11.3.0 부터 지문이 진입 파일 하나가 아니라 라우트 모듈까지 덮으므로,
+   v11.3.0 이전에 찍은 증거는 재캡처 전까지 불일치로 보고된다
+   (지문 계산은 `scripts/lib/mock_server_fingerprint.mjs` 한 곳에만 있다).
 
 레이아웃을 바꿨다고 보고했는데 배치는 그대로인 경우를 잡기 위해 v10.7.0 부터
 `scripts/check_screenshot_pixel_delta.py` 가 12개 캡처를 직전 버전과 대조한다

package/docs/PERMISSION_MODE.md

@@ -101,7 +101,7 @@ before routers are mounted would otherwise pin the store to the fallback
 |--------|------|
 | `latticeai/core/permission_mode.py` | Pure decision table |
 | `latticeai/core/agent_permission.py` | Agent plan/tool gate helpers |
-| `latticeai/core/agent.py` | `SingleAgentRuntime` gates (mode-aware in-line) |
+| `latticeai/core/agent/` | `SingleAgentRuntime` gates (mode-aware in-line: `planning.py` for the plan gate, `execution.py` for the per-tool gates) |
 | `frontend/src/components/PermissionModePanel.tsx` | Settings selector |
 | `latticeai/services/permission_mode_service.py` | Persistence |
 | `latticeai/runtime/permission_mode_wiring.py` | Process-wide service + router mount |

package/docs/TRUST_MODEL.md

@@ -1,6 +1,6 @@
 # Lattice AI Trust Model
 
-Current release: **11.2.0 — All Systems On**.
+Current release: **11.5.0 — Rust Complete**.
 
 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: **11.2.0 — All Systems On**.
+Current release: **11.5.0 — Rust Complete**.
 
 **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: **11.2.0 — All Systems On**.
+Current release: **11.5.0 — Rust Complete**.
 
 명세 출처: `lattice_ai_full_spec.pptx` 슬라이드 20·21·22
 구현: `lattice_brain/graph/schema.py`
@@ -142,7 +142,7 @@ provenance(source_type, source_uri, content_hash, captured_at, modified_at,
   범위 없는 로컬 폴더는 개인 Brain으로 재투영하되 기존 노드 ID는 보존하며,
   같은 폴더를 다른 워크스페이스로 조용히 재할당하지 않는다.
 
-구현: `lattice_brain/ingestion.py` (`IngestionPipeline`) 가 단일 진입점이며,
+구현: `lattice_brain/ingestion/` (`IngestionPipeline`) 가 단일 진입점이며,
 파일/로컬폴더/URL/브라우저 탭/텍스트를 모두 이 형태로 정규화한다.
 
 ---

package/docs/v11.3.0_PLAN.md

@@ -0,0 +1,202 @@
+# v11.3.0 — Time Remembers (설계 문서)
+
+> 상태: 계획 → 구현 → **출하됨(v11.3.0)**. 이 문서가 이번 릴리스의 설계
+> 단일 출처다. 설계·기획: 본 문서. 구현: 트랙별 작업 노트 참조.
+
+두 트랙을 하나의 릴리스로 출하한다.
+
+- **트랙 A — No Big Files**: 1,000줄 이상인 1st-party 소스 파일 28개를
+  전부 응집 단위로 분해하고, 재발을 막는 라인 상한 게이트를 lint에 추가한다.
+  동작 변화 0, 화면 변화 0.
+- **트랙 B — 기억의 연대기 (Brain Chronicle)**: v11.1.0이 심어 둔
+  bitemporal 데이터(`valid_from`/`valid_to`/`superseded_by`,
+  `edge_occurrences.observed_at`, `store.as_of()`)를 처음으로 사용자 앞에
+  꺼내는 7번째 주 화면. 두뇌가 자란 과정을 날짜로 보고, 임의 시점으로
+  되감는다.
+
+---
+
+## 트랙 A — No Big Files
+
+### 왜
+
+`frontend/src/styles.css`는 10,956줄이다. 그 아래로도 1,000줄을 넘는
+파일이 27개 있다. 리뷰가 느려지고, 에이전트 컨텍스트가 낭비되고, 충돌이
+잦아진다. "누가 봐도 큰 파일"이 리포에 남지 않게 한다.
+
+### 규칙
+
+- **상한: 파일당 1,000줄** (git-추적 1st-party `*.py *.ts *.tsx *.js
+  *.mjs *.cjs *.css` 전부 — 테스트 포함).
+- **제외(생성물/벤더)**: `frontend/src/api/openapi.ts`, `static/app/**`,
+  `static/vendor/**`, `node_modules`, `src-tauri/gen/**`.
+- **게이트**: `scripts/check_max_file_lines.mjs`가 `npm run lint` 체인에
+  들어간다. 상한 초과 파일을 경로+줄수로 나열하며 실패한다. 제외 목록은
+  스크립트 안에 사유 주석과 함께 명시한다.
+
+### 분해 대상 (28)
+
+CSS/프론트: `styles.css`(10,956) `graph-home.css`(1,387)
+`i18n/brain.ts`(1,647) `i18n/workspace.ts`(1,522)
+`client.test.ts`(1,131) `useBrainChat.test.tsx`(1,037)
+`vscode-extension/extension.ts`(1,104)
+
+Python(lattice_brain): `ingestion.py`(1,525) `portability.py`(1,347)
+`graph/_kg_common.py`(1,331) `graph/retrieval_vector.py`(1,293)
+`multimodal.py`(1,258) `graph/discovery_index.py`(1,141)
+`graph/retrieval.py`(1,120) `graph/projection.py`(1,008)
+
+Python(latticeai): `core/agent.py`(1,465) `runtime/build_phases.py`(1,450)
+`integrations/telegram_bot.py`(1,390) `setup/wizard.py`(1,310)
+`services/model_runtime.py`(1,281) `core/embedding_providers.py`(1,196)
+`services/memory_service.py`(1,177) `services/brain_intelligence.py`(1,083)
+`core/file_generation.py`(1,047) `models/router.py`(1,007)
+
+테스트/인프라: `tests/unit/test_layout_rebuild_apis.py`(1,685)
+`tests/visual/v3.spec.js`(1,246) `tests/visual/mock_server.cjs`(1,226)
+
+### 분해 프로토콜 (v10.0.1 교훈의 성문화)
+
+**Python** — 모듈 → 동명 패키지:
+
+1. `foo.py` → `foo/` 디렉터리. 내부를 응집 단위 서브모듈로 나눈다
+   (각 ≤1,000줄, 목표 ≤700줄).
+2. `foo/__init__.py`가 **모든 공개 이름 + 테스트가 참조하는 모든 이름**을
+   재수출한다. 기존 `__all__` 유지. import 경로는 단 하나도 깨지지 않는다.
+3. **monkeypatch 함정**: 테스트가 `patch("pkg.foo.bar")`로 패치하는
+   심볼은, `bar`를 사용하는 코드와 같은 서브모듈에 두거나 테스트의 패치
+   대상을 실제 위치로 갱신한다. 패키지 `__init__`에 재수출된 이름을
+   패치해도 서브모듈 내부의 전역 참조는 바뀌지 않는다.
+4. **모듈 전역 상태**(싱글턴, 캐시, 레지스트리)는 정확히 한 서브모듈에만
+   존재한다. 순환은 의존 순서 정리로 풀고, 문자열 리터럴 지연 import로
+   우회하지 않는다.
+5. **AST 동등성 증명**: 분해 전(`git show HEAD:<path>`)과 후(서브모듈
+   합집합)의 top-level 함수/클래스 각각에 대해 `ast.dump` 비교. import
+   문과 위치 이동 외 차이 0을 확인하고 결과를 작업 노트에 남긴다.
+6. `pyproject.toml`의 mypy `files` 목록을 새 경로로 갱신한다(원 모듈이
+   채택돼 있던 경우 서브모듈 전부 채택).
+
+**CSS** — `styles.css`는 이미 104개 섹션 주석으로 구조화되어 있다.
+섹션 묶음별로 `frontend/src/styles/core/*.css`로 옮기고 `styles.css`
+상단에서 원래 순서 그대로 `@import`한다. Tailwind v4는 unlayered 규칙이
+layered 유틸을 항상 이기므로 캐스케이드는 순서 보존이 전부다.
+**증명: 분해 전후 `vite build` 산출 CSS 번들이 동일해야 한다**
+(해시 제외 byte-diff).
+
+**i18n** — `brain.ts`/`workspace.ts`를 도메인별 사전 파일로 나누고 기존
+파일이 병합해 `registerCopy` 한 번만 호출한다. ko/en 키 패리티 테스트와
+`check_i18n_namespace_coverage.mjs`가 그대로 통과해야 한다.
+`vitest.config.ts`의 커버리지 제외 패턴을 `frontend/src/i18n/**`로
+넓힌다(사전은 로직이 아니다 — 기존 사유 그대로).
+
+**검증 플로어(불변)**: Python 문·분기 100.00% (`fail_under = 100`),
+프론트 4지표 100%, mypy 0 에러, ruff 클린, `npm run lint` 전 서브게이트,
+전 테스트 그린. 분해는 이 플로어 위에서만 성립한다.
+
+---
+
+## 트랙 B — 기억의 연대기 (Brain Chronicle)
+
+### 왜 이것인가
+
+v11.1.0이 노드·엣지에 `valid_from`/`valid_to`/`superseded_by`를 심고
+`edge_occurrences(observed_at)`와 `store.as_of()`/`neighbors(as_of=)`까지
+구현했지만, **이 데이터를 노출하는 HTTP 엔드포인트도, 화면도 0개다.**
+"두뇌가 시간을 기억한다"는 이 제품의 약속이 아직 보이지 않는다.
+연대기는 그 약속을 첫 화면급 표면으로 만든다. 전부 읽기 전용이라
+기존 시스템에 지장이 없다.
+
+### 사용자에게 보이는 것
+
+새 주 화면 **연대기** (라우트 id `chronicle`, 해시 `#/chronicle`,
+everyday 내비 4번째 항목). 위에서 아래로:
+
+1. **성장 곡선 + 스크러버** — 누적 기억(자료·개념·연결·대화)의 SVG 영역
+   차트. 핸들을 잡고 끌면 아래 전체가 그 시점으로 따라온다.
+2. **활동 히트맵** — 주×요일 격자, 하루의 활동 밀도. 클릭하면 그 날로.
+3. **그날의 이야기** — 선택한 날짜에 두뇌에 들어온 것들을 평이한 한국어
+   그룹 카드로: 자료(제목·출처), 새로 생긴 개념, 나눈 대화(첫 줄 미리보기),
+   달라진 사실(superseded/모순 해소). 각 카드는 기존 화면(기억 검색,
+   그래프, 대화)으로 연결된다.
+4. **그때의 두뇌 (되감기)** — 스크러버가 과거에 있을 때: 그 시점의
+   노드·연결 수와 그때 중요했던 개념 목록. `as_of` 읽기의 첫 노출.
+
+빈 두뇌엔 정직한 빈 상태: "오늘부터 기록이 쌓입니다." 요약 생성이나
+모델 호출은 없다 — 전부 이미 저장된 사실의 재배열이다(정직성 원칙).
+
+### API 계약 (신규 라우터, 전부 read-only)
+
+`latticeai/api/chronicle.py` — router-factory 규약(전체 경로, prefix 없음),
+`require_user` + `gate_read`, 워크스페이스 스코프. 서비스는
+`latticeai/services/chronicle.py`의 `ChronicleService`(순수 SQLite 읽기,
+날짜 버킷은 `latticeai/core/timezones.py` 기준).
+
+```
+GET /api/chronicle/overview
+  → { first_activity_at, last_activity_at,
+      totals: { sources, entities, connections, conversations },
+      series: [ { date, sources, entities, connections, conversations } ] }
+
+GET /api/chronicle/day/{date}          # YYYY-MM-DD, LATTICE_TZ 기준
+  → { date, counts, groups: {
+        sources:       [ { id, title, source_type, captured_at, node_id } ],
+        entities:      [ { id, label, type, created_at } ],
+        conversations: [ { conversation_id, preview, messages, started_at } ],
+        changes:       [ { kind, label, at, node_id } ] } }
+
+GET /api/chronicle/as-of?ts=<ISO8601>
+  → { ts, stats: { entities, connections },
+      top_entities: [ { id, label, type, importance_score } ] }
+```
+
+데이터 원천: `ingestion_provenance(created_at, captured_at)`,
+`nodes_v2`/`edges_v2`(`created_at`, temporal 3열),
+`conversation_messages(timestamp)`, `edge_occurrences(observed_at)`.
+`as-of`는 `store.as_of()` 계열을 통해서만 읽는다(중복 구현 금지).
+등록은 `build_phases.py` platform_features 단계에 직접 include.
+스키마 변경 0, 쓰기 0.
+
+### 프론트 구조
+
+- `frontend/src/pages/Chronicle.tsx` + `frontend/src/features/chronicle/`
+  (GrowthScrubber / ActivityHeatmap / DayStory / RewindPanel — 각 ≤1,000줄).
+- `routes.ts`: `productShellRoutes` 7번째 항목, `directProductRoutes`,
+  `commandRoutes`(팔레트), 별칭 `timeline` → `chronicle`.
+- `App.tsx`: lazy import + everyday 내비(대화·자료·기억·연대기).
+- i18n: 신규 네임스페이스 `frontend/src/i18n/chronicle.ts`
+  (ko/en 패리티, 페이지 청크에서 등록). basic 모드 어휘: 개발 용어 금지.
+- `api/client.ts`에 typed 메서드 3개. OpenAPI 재생성으로 타입 공급.
+- 시각 회귀: `tests/visual/mock_server.cjs`에 chronicle 3 엔드포인트
+  픽스처(채워진 상태) 추가 — 릴리스 스크린샷이 빈 화면을 찍지 않게 한다.
+
+### 테스트
+
+- 백엔드: 서비스 단위(빈 두뇌·단일 일자·다일자·workspace 경계·tz 경계·
+  as-of 과거/미래/경계)와 라우터(인증·게이트·404·검증 실패)를 실제
+  tmp_path SQLite 스토어로. 문·분기 100%.
+- 프론트: 신규 파일 4지표 100%. routes/parseHash, 팔레트 노출,
+  스크러버 드래그 → as-of 반영, 빈 상태.
+
+### 릴리스 증거
+
+- 신규 스크린샷 `13-chronicle.png` 캡처 목록 추가, README 기능 표에
+  연대기 카드 추가.
+- 내비가 화면 전체에 4번째 everyday 항목을 추가하므로
+  `scripts/release_screen_claims.json`의 11.3.0 항목은 topbar가 보이는
+  화면들을 claim한다.
+
+---
+
+## 릴리스 체크리스트 (11.3.0)
+
+1. 트랙 A → 트랙 B 순서로 구현(연대기가 분해된 `build_phases` 위에 얹힘).
+2. 전 게이트 로컬 그린 → fresh venv 재검증(coverage-100 교훈).
+3. `bump_version.py 11.3.0` → OpenAPI 재생성 → 문서 갱신
+   (`check_current_release_docs.mjs`의 releaseTheme = "Time Remembers"
+   갱신 포함 — README/RELEASE.md/RELEASE_NOTES.md 제목과 일치 필수).
+4. `npm run release:evidence` (스크린샷 12+1, walkthrough GIF).
+5. `npm run release:artifacts` → whl · tar.gz · tgz · vsix ·
+   **DMG**(`Lattice AI_11.3.0_aarch64.dmg`) → `release:validate`
+   (`--require-vsix --require-tgz --require-dmg`) → `release:smoke`.
+6. main 커밋·푸시 → 태그 `v11.3.0` → GitHub Release(정확한 파일명,
+   와일드카드 금지) → main CI 4종(CI·Visual·Sidecar·Audit) 그린 확인.