ltcai 11.7.0 → 12.0.0

package/README.md

@@ -11,23 +11,24 @@
 [![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.7.0 Living Brain walkthrough](output/release/v11.7.0/gifs/v11.7.0-living-brain-walkthrough.gif)
+![v12.0.0 Living Brain walkthrough](output/release/v12.0.0/gifs/v12.0.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
-memory. Nothing leaves your machine without explicit consent.
+graph on your computer. The default is local. Cloud is optional — an
+OAuth-authenticated CLI (`agy` / `grok`) or an API key you configure — and
+nothing leaves your machine without explicit consent.
 
-대화·파일·폴더·웹페이지가 전부 내 컴퓨터 안의 지식 그래프로 쌓이고, 어떤
-모델이든 그 기억을 이어받아 대화합니다.
+대화·파일·폴더·웹페이지가 전부 내 컴퓨터 안의 지식 그래프로 쌓입니다.
+기본은 로컬이고, 클라우드는 선택입니다 (OAuth CLI 지원).
 
 ## What You Can Do
 
 | | |
 | --- | --- |
-| **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.7.0/screenshots/13-chronicle.png) | **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v11.7.0/screenshots/04-brain-chat-home.png) |
-| **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v11.7.0/screenshots/05-memory-graph.png) | **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v11.7.0/screenshots/06-capture.png) |
-| **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v11.7.0/screenshots/12-review-center.png) | **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v11.7.0/screenshots/02-recommended-models.png) |
-| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v11.7.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.7.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/v12.0.0/screenshots/13-chronicle.png) | **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v12.0.0/screenshots/04-brain-chat-home.png) |
+| **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v12.0.0/screenshots/05-memory-graph.png) | **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v12.0.0/screenshots/06-capture.png) |
+| **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v12.0.0/screenshots/12-review-center.png) | **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v12.0.0/screenshots/02-recommended-models.png) |
+| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v12.0.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/v12.0.0/screenshots/08-system.png) |
 
 ## Why Lattice AI
 
@@ -39,6 +40,10 @@ memory. Nothing leaves your machine without explicit consent.
   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.
+- **Runs on the model your machine can hold** — the loop measures what a model
+  can actually produce and adapts: a model too small to emit a tool call is
+  walked through numbered choices instead, with the same permission gates,
+  snapshots and sanitizers as every other profile.
 
 매번 AI에게 프로젝트 맥락을 다시 설명하고 있다면, 지식이 여러 서비스에 흩어져
 있다면, 그 기억을 특정 회사가 아니라 내가 소유하고 싶다면 — Lattice AI가 그
@@ -58,67 +63,57 @@ First-run flow — wake the Brain, pick the owner, load a recommended model:
 
 | | | |
 | --- | --- | --- |
-| ![Login](output/release/v11.7.0/screenshots/01-login.png) | ![Model install](output/release/v11.7.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v11.7.0/screenshots/07-model-library.png) |
+| ![Login](output/release/v12.0.0/screenshots/01-login.png) | ![Model install](output/release/v12.0.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v12.0.0/screenshots/07-model-library.png) |
 
 Screenshot index and capture notes:
-[output/release/v11.7.0/SCREENSHOT_INDEX.md](output/release/v11.7.0/SCREENSHOT_INDEX.md)
+[output/release/v12.0.0/SCREENSHOT_INDEX.md](output/release/v12.0.0/SCREENSHOT_INDEX.md)
 
 ## Current Release
 
-The current release is **11.7.0 — Clean Sweep**:
-
-11.6.0 left a disclosed backlog and a visual language that still used
-glass. This release closes that backlog, fixes regressions One Door did
-not know it had shipped, and restyles every captured surface on an
-elevation ladder — ink night, paper day, no glass. The door is unchanged:
-`lattice-host` still serves **420 operations across 41 route families**,
-and the Python package is still a **28-route AI worker** (LLM, embed,
-extract, parse, four renderers, ASR, multimodal, catalog, `sysinfo`,
-`/health`). The allowlist still includes `/worker/parse` and
-`/worker/render/*`; nothing product-shaped moved back into Python.
-
-- **The three oracle bugs 11.6.0 ported as-is are fixed.** Command-search
-  knowledge now reads `matches` and returns nodes. Review snooze accepts
-  offset-aware datetimes (unparseable `until` → 422). Double-reject is
-  409, byte-identical to its dismiss sibling. Fixture bodies that pinned
-  the old faults were updated and marked as divergences from the oracle.
-- **The §5.3 holes are closed.** Binary uploads go through `/worker/parse`.
-  Per-chunk supplied vectors land at the four ingest doors. User hooks
-  fire on native tools (`HooksStore` → `HookSink`) and write the same run
-  log the HTTP route writes. `sanitize_write_content` runs on the loop
-  path and on `POST /tools/write_file`. Every mutating review route records
-  `review_item_created` / `review_item_updated`. `workspace_os.json` has
-  one writer (`WorkspaceOsStore` + registry + ports).
-- **Regressions One Door did not know it had.** Self-Model writes were
-  100% dead (five routes posted into the retired `/worker/graph/mutate`;
-  `resolve_contradiction` claimed "applied" while writing nothing) —
-  restored natively, nine recorded bodies byte-identical. The security
-  xlsx export 502'd because it posted to a product route; it now uses
-  `/worker/render/xlsx`. Chat `ingest_generated` was a schema 400 even
-  against a live 11.5.2 worker. Vault-watch had fixtures and no poller —
-  it is a real native ingest loop now. A decoy-proven static gate keeps
-  this class from shipping again.
-- **Time bombs defused.** Chronicle `@today`, briefing freshness, and the
-  insights/garden/proactive/health/quality cutoffs now take a frozen
-  clock. Falsifier tests fail on the next run if a fuse is re-armed.
-- **The UI is one language.** Token-native elevation and gradients replace
-  backdrop-filter. Cytoscape reads theme tokens (comma-form `hsl()`).
-  Layout and a11y contracts stay; the first-paint bundle is still ~103 KiB
-  gzip.
-
-What this release still carries openly — `open_keys` pending-only, no
-extraction refiner, `delete_node` leaving `PART_OF`, review events silent
-without an owner, text-only KG-api ingest, two store cycles per review
-mutation, raw-English snooze 422 — is listed in
-[RELEASE_NOTES_v11.7.0.md](RELEASE_NOTES_v11.7.0.md).
-
-Expected artifacts for 11.7.0 release must use exact filenames:
-
-- `dist/ltcai-11.7.0-py3-none-any.whl`
-- `dist/ltcai-11.7.0.tar.gz`
-- `ltcai-11.7.0.tgz`
-- `dist/ltcai-11.7.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_11.7.0_aarch64.dmg`
+The current release is **12.0.0 — Open House**:
+
+11.9.0 made the doors answer. This release opens the house: the two
+largest crates are grouped by what a file is *for*, the contributor
+documentation is a real path in, and four gaps the last release wrote
+down are closed. `lattice-host` serves **422 operations across 41 route
+families** (`POST /mcp` and the folder-prune route are the two new ones),
+and the AI worker is **20 routes** (`POST /worker/vector/query` is the
+one addition). Cloud is still optional and the default is still local.
+
+- **Complexity management first.** `lattice-agent` is six groups —
+  `kernel` (the loop and every decision that can refuse), `parse`,
+  `content`, `tools`, `surface`, `prompts` — and `lattice-platform` is
+  seven domains. Every move is a rename, so the goldens answer
+  identically; each crate carries its own `ARCHITECTURE.md`, and
+  `docs/DEVELOPMENT.md` and the new `docs/ROADMAP.md` are the way in.
+- **Small models become agents.** A measured probe (not a size regex)
+  picks the profile, and the `guided` profile stops asking for JSON at
+  all: pick an action by number, then one argument per turn, and the
+  harness assembles the call. A 0.5B model finished a real file in 3.9s.
+  The same gates, snapshots and sanitizers run on every profile.
+- **Remembering got faster and more careful.** Re-indexing an unchanged
+  folder went **33s → 0.26s**, a 991-item embedding backlog went 40
+  minutes → 15.3s, and a document's own section outline is now in the
+  graph, so an answer can name the heading it came from. Korean queries
+  strip their particles properly, and deleted files get a **「삭제된 파일
+  정리」** button instead of quietly lingering as memory.
+- **Four honest gaps closed.** Restore takes effect without a restart,
+  `/setup/install` really installs on per-item consent, `POST /mcp` is
+  inside the OpenAPI contract, and pointer tools are declared as
+  `pip install "ltcai[pointer]"`.
+
+What this release does not close — small-model *content* quality, the
+mock-only `api_key` path, `brute` still being the search default, watch
+never deleting on its own, the ad-hoc-signed dmg — is listed in
+[RELEASE_NOTES_v12.0.0.md](RELEASE_NOTES_v12.0.0.md).
+
+Expected artifacts for 12.0.0 release must use exact filenames:
+
+- `dist/ltcai-12.0.0-py3-none-any.whl`
+- `dist/ltcai-12.0.0.tar.gz`
+- `ltcai-12.0.0.tgz`
+- `dist/ltcai-12.0.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_12.0.0_aarch64.dmg`
 
 Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
@@ -131,21 +126,27 @@ every product route, owns every write to the Brain, and supervises a Python
 **AI worker** it reaches over loopback for the things a model does — inference,
 embedding, extraction, parsing, rendering, speech-to-text. The React/Vite
 frontend and the Tauri desktop shell sit on top of that one door. Local-first
-by default — cloud model calls, downloads, Brain Network, and update checks are
-opt-in.
+by default — cloud is optional (OAuth CLI or an API key you configure),
+and downloads, Brain Network, and update checks are opt-in.
 
 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`).
+(`npm start` / `bin/ltcai.js` is the product; `npm run dev` is the
+20-route worker). Each of the two largest crates carries its own domain
+map — [rust/lattice-agent/ARCHITECTURE.md](rust/lattice-agent/ARCHITECTURE.md)
+and [rust/lattice-platform/ARCHITECTURE.md](rust/lattice-platform/ARCHITECTURE.md)
+— and open gaps are tracked in [docs/ROADMAP.md](docs/ROADMAP.md).
+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.
 - SQLite is the live local Brain store. The optional PostgreSQL/pgvector
-  migration tooling is not part of the 11.6.0 worker.
+  migration tooling is not part of the 12.0.0 worker.
 - Docker, model downloads, cloud model calls, Brain Network, and update checks
-  require explicit user action.
+  require explicit user action. Cloud is optional: `cli_oauth` (`agy` /
+  `grok`) was live-checked at zero billing; the `api_key` path is
+  mock-verified only.
 - **The Telegram bridge was removed in 11.6.0** — it lived in the platform code
   that became the AI worker. **SSO/OIDC login and callback flows were removed
   with it**; the configuration surface remains and password login is native.
@@ -157,11 +158,31 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for details and
   required dependency as of 11.6.0 (it used to be an undeclared lazy import
   that raised a 500; `ltcai[pdf]` remains as an empty alias for older
   install instructions).
-- Pointer-control tools still execute in the worker. Remaining honest gaps
-  (`open_keys` pending-only, no Self-Model refiner, `PART_OF` left on
-  delete, review events silent without an owner, KG-api ingest text-only,
-  two store cycles per review mutation) are listed with their reasons in
-  [RELEASE_NOTES_v11.7.0.md](RELEASE_NOTES_v11.7.0.md).
+- The multimodal image and video analysis functions have no HTTP door as of
+  11.8.0: their only route wrapped a native image ingest that was never
+  built. The observation code stays in Brain Core under unit test, and its
+  module header says so.
+- The Python coverage gate is a **line floor of 90** since 11.8.0 (the
+  100%-lines-and-branches gate was removed). The enforced claim is the
+  floor, not whatever a given run measures.
+- **Small-model *content* quality is gated honestly.** With the `guided`
+  profile even a 0.5B model writes the requested file and reaches DONE;
+  a weak summary still fails the critic and the run ends
+  FAILED/NEEDS_REVIEW rather than claiming success.
+- Vector search still defaults to `brute` — exact and byte-compatible.
+  `hnsw+rescore` is real but opt-in, and falls back to the exact scan
+  with its reason when the sidecar cannot answer.
+- Watch never deletes on its own: a vanished file is reported, and
+  cleanup runs only through the confirmed folder-prune flow.
+- The macOS dmg is ad-hoc signed — effectively unsigned — so first launch
+  needs the usual Gatekeeper step.
+- Pointer-control tools execute in the worker and are installed with
+  `pip install "ltcai[pointer]"`. Remaining honest gaps (`open_keys`
+  pending-only, no Self-Model refiner, `delete_node` leaving `PART_OF`,
+  review events silent without an owner, KG-api ingest text-only, two
+  store cycles per review mutation) are listed with their reasons in
+  [RELEASE_NOTES_v12.0.0.md](RELEASE_NOTES_v12.0.0.md) and prioritized in
+  [docs/ROADMAP.md](docs/ROADMAP.md).
 
 ## Release History
 
@@ -172,6 +193,9 @@ same boundary. Earlier notes stay in the tree as `RELEASE_NOTES_v*.md` files.
 
 | Version | Theme |
 | --- | --- |
+| 12.0.0 | Open House |
+| 11.9.0 | Working Order |
+| 11.8.0 | Travel Light |
 | 11.7.0 | Clean Sweep |
 | 11.6.0 | One Door |
 | 11.5.2 | Tight Ship |

package/docs/BENCHMARKS.md

@@ -1,8 +1,15 @@
 # Model Robustness Benchmarks
 
 > Status: reference 2026-07-21
-
-Methodology and results for `scripts/bench_models.py`, a harness that measures
+>
+> **Dated snapshot.** The harness this page documents no longer exists in the
+> tree: `scripts/bench_models.py` went with the Python agent loop when 11.5.1
+> ported it to Rust, and `latticeai.core.agent_eval` / `scripts/agent_eval.py`
+> followed (the last of them deleted in 11.8.0). The methodology and the
+> honesty notes below are kept as the record of how these numbers were produced
+> and what they did and did not mean — not as instructions you can run today.
+
+Methodology and results for `scripts/bench_models.py`, a harness that measured
 how well the agent loop turns model output into executable actions across model
 quality tiers. Companion to [CI & Release Gates](CI_AND_RELEASE_GATES.md).
 

package/docs/CHANGELOG.md

@@ -4,6 +4,255 @@ 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.
 
+## [12.0.0] - 2026-08-18 — Open House
+
+### Added
+- 크레이트 도메인 구조. `lattice-agent` 43파일이 여섯 그룹으로
+  (`kernel` / `parse` / `content` / `tools` / `surface` / `prompts`),
+  `lattice-platform` 31개 평면 모듈이 일곱 도메인으로
+  (`workspaceos` / `toolsurface` / `governance` / `adminops` /
+  `knowledge` / `modelops` / `shell`, 100건 `git mv`). 전부 이동이며
+  동작 변화는 0 — 골든과 계약 테스트가 재구조 전후로 같은 답을 낸다.
+- 크레이트 로컬 지도 2종: `rust/lattice-agent/ARCHITECTURE.md`,
+  `rust/lattice-platform/ARCHITECTURE.md`. 각 그룹 `mod.rs`가 무엇이
+  속하고 무엇이 절대 들어가면 안 되는지와 불변식을 적는다. 각
+  `src/lib.rs`는 호환 맵으로 끝나 기존 임포트 경로가 전부 해석된다.
+- `docs/ROADMAP.md` — 우선순위(P1/P2/P3)·난이도·제안 경로가 있는 갭
+  로드맵. 이번 릴리스에서 닫힌 항목은 닫힘으로 표시한다.
+- GUIDED 프로파일. 번호 메뉴로 액션을 고르고 인자를 한 개씩 받아
+  **하네스가 액션 구조체를 조립**한다 — JSON 요구 자체가 없다. 꼬리는
+  모든 모드와 같은 `perform_action`이므로 게이트 체인·루프 가드·쓰기 전
+  스냅샷·`sanitize_write_content`가 동일하다. 검증은 닫힌 PASS/FAIL +
+  이유 한 줄이며 같은 근거·커버리지 게이트로 심사한다.
+- 측정 기반 프로파일 프로브(`kernel/probe.rs`). 로드 시 고정 질문 두
+  개를 루프 자신의 파서로 채점해 standard/compact/guided를 고르고,
+  모델 id + 크레이트 버전으로 캐시한다. `LATTICEAI_AGENT_PROFILE`이
+  여전히 최우선, `LATTICEAI_AGENT_PROBE=0`으로 끌 수 있다.
+- 미드런 자기강등(`demote_to_guided`) — 측정된 다이얼, 아직 guided가
+  아님, 실행 근거 없음의 세 조건에서만, 아래로만.
+- 통합 도구 카탈로그(`tools/catalog.rs`) — native + `mcp.<tool>` +
+  `skill.<name>`이 하나의 번호 메뉴. 런이 거버넌스하는 이름은 네이티브
+  경로(더 엄격), 아닌 이름은 `POST /mcp`와 같은 거버넌스 검사를 지난다.
+- `POST /worker/vector/query` — HNSW 사이드카 후보 조회. 워커 allowlist
+  19 → **20**.
+- `POST /api/ingestion/folder/prune` — 삭제된 파일 정리. `confirm` 없으면
+  dry-run, 있으면 `delete_document_tree`(양방향 엣지). SPA에 「삭제된
+  파일 정리 (N)」 카드 버튼.
+- 섹션 트리 — `Document ←PART_OF— Section ←PART_OF— Section`,
+  `Section —HAS_CHUNK→ Chunk`. 제목이 없는 문서는 섹션을 만들지 않는다.
+- 파일별 ingest 핑거프린트(경로 + 크기 + mtime + 내용 sha256)를
+  `ingestion_provenance.metadata_json`에 저장. 두 번째 테이블 없음.
+- 스토어 세대(generation) 에폭 — 복원이 인프로세스로 즉시 반영된다.
+- `ltcai[pointer]` extra — 여섯 pyautogui 포인터 도구의 선언된 설치 경로.
+
+### Changed
+- `POST /mcp`가 OpenAPI 제품 계약 **안으로** 들어왔다(단일 JSON-RPC 봉투
+  오퍼레이션). 네이티브 마운트이므로 워커로 프록시되지 않는다. 문은 네이티브
+  **422 오퍼레이션 / 41 패밀리**(11.9.0의 420 + `/mcp` + folder prune).
+- `/setup/install`이 실제로 설치한다 — 요청이 이름을 댄 항목이 **서버가
+  도출한** allowlist에 있을 때만. 목록 밖 이름은 거절. 기본은 수동 유지.
+- 한국어 조사 스트리핑 2단계 + 근거 게이트 + 포함관계 중복 제거.
+- 추출이 `PART_OF`/`CONTRADICTS`를 실제로 생산하고, 엣지는 방향과 타입을
+  갖고 쓰이며, 근거는 분류되어 저장된다.
+- 임베딩 자동 감지 — 다운로드된 실모델이 있으면 채택, 해시는 폴백으로
+  표기. 벡터 정체성은 `(model, dim)`으로 필터.
+- 임베딩이 쓰기 트랜잭션 **앞으로** 이동(드레인 ~66 → ~1,300 items/s),
+  드레인 스케줄러 적응형(백로그 991건 40분 → 15.3초).
+- 무변경 재인덱스 33s → **0.26s**(낭비율 1.00 → 0.00), 첫 인덱싱 25.8s
+  → 7.2s. vault-watch가 바뀌지 않은 노트를 스킵.
+- `LATTICEAI_VECTOR_INDEX=hnsw`가 실제 검색 경로 — 사이드카가 `k*8`
+  후보(최대 200)를 주고 Rust가 브루트와 같은 코사인으로 정확 재스코어,
+  이름은 `hnsw+rescore`. HNSW 사이드카는 증분 append. **기본은 여전히
+  `brute`**, 실패는 사유를 실은 폴백.
+- `Completion::prefix`가 완성의 첫 글자를 강제(compact는
+  `{"thoughts": "`). 토큰 단위 JSON 문법은 검토 후 채택하지 않음.
+- 프론트: ErrorBoundary가 라우트와 헤비 패널 전면에, Act/Brain 서브라우트
+  lazy 분할, 권한 모드 diff 프리뷰와 위험 토글 ack. 번들 104.2 / 150 KiB.
+
+### Fixed
+- RAG 인용 지시가 에이전트 프롬프트로 새던 문제 — 도구를 불러야 할 턴에
+  모델이 출처 표기를 하고 있었다.
+- 모델 로딩의 이름 로스터 게이트 — Qwen AWQ 빌드가 로드 자체가 불가능
+  했다.
+- 베낄 수 있는 워크드 예제 — `write_file` content가 우리 예제 상수와
+  글자 그대로 같으면 `COPIED_EXAMPLE`로 기록하고 쓰지 않는다
+  (fail-closed). 에코된 지시문 줄은 guided 답변에서 제거.
+- `<|channel>` 한-파이프 제어 프레임이 본문으로 새던 문제.
+- 복원 뒤 오래된 커넥션이 복원 전 바이트를 주던 문제(에폭으로 해소).
+
+### Known issues
+- 작은 모델의 *내용 품질*은 여전히 fail-closed 게이트가 잡는다. 기계적
+  실행(요청한 파일 쓰기, DONE 도달)은 guided로 안정됐고 0.5B도 3.9초에
+  실파일로 완주하지만, 요약의 질은 critic에서 떨어져
+  FAILED/NEEDS_REVIEW로 끝날 수 있다. 매트릭스는 18개 중 11개 통과에서
+  개선 중이며 최종 수치는 릴리스 시점 `MATRIX_TABLE` 기준.
+- `api_key` 클라우드 경로는 모의 서버만 검증(과금 0 정책). 라이브
+  검증은 `cli_oauth`.
+- DMG는 ad-hoc 서명(=미서명).
+- 검색 기본은 brute. `hnsw`는 opt-in.
+- watch는 자동 삭제하지 않는다 — 정리는 명시적 prune으로만.
+- 크레이트 재구조는 이동이지 결합 해소가 아니다. 도메인 선을 넘는 네
+  결합은 `lattice-platform`의 해당 `mod.rs`에 이름과 함께 적혀 있다.
+- `GraphWriter::delete_node`는 여전히 `PART_OF`를 남긴다. prune은 그것을
+  쓰지 않고 `delete_document_tree`를 쓴다.
+
+## [11.9.0] - 2026-08-17 — Working Order
+
+### Added
+- 이중 클라우드 자격증명: `<data_dir>/cloud_provider.json` →
+  `LATTICEAI_CLOUD_API_KEY` → CLI 자동감지(`agy` / `grok`). `api_key`는
+  OpenAI 호환 어댑터(모의 서버만 검증, 실과금 없음). `cli_oauth`는 로컬
+  OAuth CLI(`agy` → gemini-3.7-flash, `grok` → grok-4.6). 중립 temp cwd,
+  120초 타임아웃.
+- `GET /api/cloud/status` — `{configured, mode, provider, model, detail}`.
+- 하이브리드 에스컬레이션 `always` / `auto`(기본) / `manual`
+  (`hybrid_policy.json`). `auto`는 로컬 모델 없음 / 로컬 컨텍스트가 얇음
+  / 명시적 `/cloud `·`클라우드:` 접두사일 때만. 요청
+  `network_mode:"local_only"`가 항상 이김.
+- 호스트가 Review Center + egress 감사 싱크를 바인딩. 클라우드 턴이
+  `kg_cloud_expansion` 제안을 올리고 형태만 있는 egress 레코드를 남김
+  (provider / model / reason, 내용 없음).
+- `POST /mcp` streamable-HTTP JSON-RPC 실서버(`initialize` /
+  `tools/list` / `tools/call`). 큐레이트된 안전 도구 + 스키마가 파싱된
+  스킬 7개. `/mcp/call`이 실제로 디스패치. `/mcp/install`은 정직
+  (스킬/플러그인 활성화, 원격은 수동).
+- SPA 클라우드 투명성: ☁️ 클라우드 답변 칩, 컴포저 경계 힌트, 「이번
+  대화는 로컬만」 토글, System 패널 provider 상태 행.
+- 채팅 파일 생성 복원(v9.2.0 헤드라인, 11.6.0 포트에서 삭제됨). 확장자별
+  앵커 프롬프트, judge + 1회 교정, 정직한 sanitize 배지, 프로젝트는
+  최대 3파일 순차, 워커 렌더 시임의 실제 docx/pdf.
+- `/worker/sysinfo`에 `capabilities`(pointer_tools)와 `python_version`
+  (가산, 라우트 수는 19 유지).
+- 통합 로컬 승인 토큰(`LocalApprovals`) — `/permissions/approve`에서
+  상환.
+
+### Changed
+- 문서에만 있던 13개 Current 스텁이 실동작: `/models/recommendations`,
+  `/setup/scan`+`auto`, `/setup/install`, computer-use 상태,
+  `/agent/eval`, `/agents/api/run`, 자동화 패턴/제안, 워크플로 run·
+  resume, 리뷰 `run_now`, `build`/`deploy_project`, 백업 blob.
+- 클라우드 모델은 provider 설정에서 오고, 로컬 MLX id를 쓰지 않음.
+  로컬 모델이 없어도 클라우드 턴이 가능.
+- 하이브리드 토큰 프레임은 도착하는 대로 스트림. `stream: false`는
+  JSON.
+- 채팅 쓰기의 스코프가 비면 `workspace_id = personal`. null workspace
+  읽기는 personal 가시성.
+- 2B(gemma-4-e2b-it-4bit) compact 프로파일: 태그 스트립·balanced·
+  truncated_close·labeled·fence_rescue 파서, v10.8.0 salvage 삼종
+  복원, COMPACT 컨텍스트 <2k, EXECUTE 온도 고정(compact 0.1 /
+  standard 0.2). MLX가 temperature + stop string을 존중.
+- 백업 = `VACUUM INTO` 스냅샷 + blob + 정직한 매니페스트 + 원자적 복원.
+  export가 edges/chunks를 실음.
+- `POST /agent`가 네이티브 루프에 닿고 제품 정책 표를 실음.
+
+### Fixed
+- 라이브 감사 N1–N9: 에이전트 루프 호스트 바인딩, 빈 Brain 메모리
+  API 500(`conversation_messages` 부트스트랩), chat/memory/chronicle/
+  command가 지식을 봄, brain health의 빈 100점, 백업/복원 정직성,
+  export의 없는 컬럼 조회, 폴더 ingest 승인, 보이스 메모 텍스트 저장.
+- 워크플로 resume 승인 게이트. `write_file`이 비어 있는 content를
+  교정 에러로 거절. critic 판정 복구(verdict-shape + 보수적 토큰,
+  fail-closed 유지).
+- 이전에 고장 나 있던 22항목을 신선한 Brain·실모델로 재검증.
+
+### Known issues
+- 2B 에이전트 루프의 *내용 품질*은 정직하게 게이트된다. gemma-4-e2b는
+  요청한 파일을 기계적으로 쓰지만(마감 테이프 5/5) 요약이 critic에서
+  떨어져 FAILED/NEEDS_REVIEW로 끝날 수 있다. 퍼널은 에이전트 런에 더
+  큰 모델을 권한다.
+- `api_key` 클라우드 경로는 모의 서버만 검증했다. 계약 테스트는 있고
+  실호출은 없다(과금 예산 없음).
+- 오래 떠 있는 프로세스에서 복원하면 커넥션이 재활용되기 전까지
+  복원 전 바이트를 줄 수 있다 — 재시작이 필요하다.
+- brew/pip 셋업 항목은 설계상 수동이다.
+- `/mcp`는 설계상 OpenAPI 제품 계약 밖이다.
+- DMG는 ad-hoc 서명(미서명)이다.
+- 11.8.0이 열어 둔 항목(커버리지 바닥 라인 90, 멀티모달 이미지/비디오
+  HTTP 문 없음, 11.7.0 leftover)은 그대로다. 전문은
+  [RELEASE_NOTES_v11.9.0.md](../RELEASE_NOTES_v11.9.0.md).
+
+## [11.8.0] - 2026-08-16 — Travel Light
+
+### Added
+- 골든 드리프트 가드: 축소된 agent 대표행 세트가 커널의 새 판정 클래스를
+  덮지 않으면 실패. 축소가 조용한 커버리지 손실이 되지 않게 하는 장치.
+- 삭제된 아홉 워커 라우트에 대한 네거티브 테스트 — 게이트웨이가 더 이상
+  전달하지 않음을 Rust KEEP 표와 allowlist 양쪽에서 고정.
+- `rust/fixtures/chunking/FROZEN.md`. 이제 모든 픽스처 계열이 FROZEN.md를
+  가짐.
+- `PhaseBudgets` 토큰 상한(MIN 128 / MAX 8192). 이전에는 하한만 있었음.
+- 모든 GitHub Actions 워크플로에 `concurrency` 그룹과 `timeout-minutes`.
+- Brain Chat Home 재설계: 히어로 컴포저, 3배 커진 LivingBrain(1440에서
+  60px → 179px)과 금빛/옥빛 성장 링, 준비도에 묶인 '기억이 자라고 있어요'
+  캡션, 풀캔버스 그리드, 바닥 연속성 바(지난 대화·현황·기억 지도·기능),
+  `prefers-reduced-motion` 폴백.
+
+### Changed
+- 워커 표면 **28 → 19 라우트**. `rust/fixtures/worker_allowlist.json`도 19.
+- 로컬 lint 체인 **13 → 10 게이트**. 순서와 남은 열 개는 그대로.
+- Python 커버리지 게이트가 `fail_under = 100`(문+분기) → **라인 90**.
+  분기 측정은 꺼짐. 실측은 이번 릴리스에서도 100%.
+- `ci.yml` 중복 스텝 제거 — 4레그 매트릭스는 유지하되 OpenAPI ·
+  product-readiness · 확장 테스트는 3.11+ubuntu 레그에서만, 커버리지 레그는
+  `pytest tests/`를 두 번 돌리지 않음. `release.yml`은 릴리스 스텝만.
+  dependency-audit은 cron 전용, visual은 push+nightly(PR 제외),
+  e2e-sidecar는 nightly 전용.
+- Rust: `lattice-{platform,retrieval,ingest,jobs}`의 약 191개 파일 blanket
+  `#![allow]` 헤더 제거, 약 650건의 clippy/rustc 진단을 원인에서 수정.
+  워크스페이스 수준 허용 0건 추가, 남긴 억제는 이유가 붙은 지역
+  `#[allow(clippy::too_many_arguments)]` 8개.
+- 통합 테스트 파일(= 링크되는 테스트 바이너리) **98 → 56**
+  (lattice-platform 43 → 11). 테스트 함수 삭제 없이 주제별 통합.
+- `ROLE_CAPABILITIES`가 `lattice-auth` 단일 출처. `lattice-agent`가 의존.
+- agent 골든 `decisions__strict` · `calls`가 702 → **171 대표행**
+  (등가류당 한 행).
+- product-readiness 증거를 Rust 픽스처로 재지정. 판정은 COMPLETE 10/10.
+
+### Fixed
+- `SessionStore`가 조회 미스 시 `sessions.json`을 다시 읽음. v11.6.0부터
+  writer는 `lattice-auth`인데 워커는 `__init__`에서 한 번만 읽어, **워커
+  기동 이후의 로그인이 워커에게 보이지 않았음** —
+  `trusted_local_owner`에서는 조용히, `LATTICEAI_REQUIRE_AUTH=true`에서는
+  파일 안에 있는 토큰에 대해 401. `mtime_ns`/`size` 가드 + 1초 throttle을
+  같은 락 아래에서 적용해 추측 버스트가 읽기 버스트가 되지 않게 함.
+  테스트 9개 추가.
+
+### Removed
+- 호출자 0인 워커 라우트 아홉 개: `GET /api/embeddings/providers`,
+  `POST /tools/read_document`, `GET /tools/pdf_pages`,
+  `POST /worker/multimodal/describe`, `GET /api/ingestion/multimodal`,
+  `POST /models/switch/{model_id}`, `DELETE /models/unload-all`,
+  `POST /engines/pull-model`, `GET /api/capture/voice/status`. 파일로는
+  `latticeai/api/{tools,local_files,voice_capture}.py`와
+  `lattice_brain/ingestion/pipeline.py`. `pypdfium2` 의존성도 함께.
+- `latticeai/core/agent_permission.py`; 죽은 보안 헬퍼(`hash_password` /
+  `verify_password`, `check_ip_rate_limit`, `configure_trusted_proxies`,
+  `client_ip`, `bytes_match_extension`); `_kg_common/text.py`의 죽은 청커와
+  호출자 0 함수 9개; 렌더 시임의 `_safe_filename` 이중 살균.
+- 얼어붙은 픽스처의 생성기 2종(`generate_agent_parity_fixtures.py`,
+  `generate_chunking_parity_fixtures.py`),
+  `scripts/{brain_quality_eval,agent_eval,check_python,bench_agent_smoke}.py`,
+  `scripts/check_legacy_debt.mjs`(드리프트한 거울 — 파이썬 테스트가 권위).
+- `.github/workflows/agent-smoke.yml` — 모델 없는 러너에서 이중 fail-open.
+- Rust 죽은 코드: `workspace_scope` 모듈, `WORKSPACE_OS_VERSION` 상수,
+  호출자 0 항목 16개.
+- agent 골든 `decisions__trusted` · `decisions__bypass` 그리드(각 702행) —
+  모든 판정 클래스를 덮는 이름 붙은 단위 테스트로 대체.
+- 죽은 프론트 컴포넌트 `FeedbackState.tsx`, `DepthEmergence.tsx`.
+
+### Known issues
+- 커버리지 **강제 바닥이 100 → 90(라인)** 으로 내려갔고 분기 게이트가
+  없어졌습니다. 실측은 100%지만 게이트가 지키는 것은 바닥입니다.
+- `lattice_brain` 멀티모달의 이미지/비디오 절반에 HTTP 문이 없습니다
+  (관찰 함수는 Brain Core에 남아 단위 테스트를 받고, 모듈 헤더에 명시).
+- DMG는 ad-hoc 서명(미서명)입니다.
+- 삭제된 라우트의 메시지 카탈로그 키는 얼어붙은 패리티 픽스처에 의도적으로
+  남습니다 — 픽스처는 녹화 당시의 표면을 고정하는 기록입니다.
+- `tests/visual/mock_server`가 고아 mock 라우트 하나를 아직 서빙합니다
+  (현재 증거가 해시로 묶여 있어 다음 캡처 사이클에 정리).
+- 11.7.0이 열어 둔 항목은 그대로입니다. 전문은
+  [RELEASE_NOTES_v11.8.0.md](../RELEASE_NOTES_v11.8.0.md).
+
 ## [11.7.0] - 2026-08-15 — Clean Sweep
 
 ### Added