ltcai 11.4.0 → 11.5.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)
 
-![v11.4.0 Living Brain walkthrough](output/release/v11.4.0/gifs/v11.4.0-living-brain-walkthrough.gif)
+![v11.5.1 Living Brain walkthrough](output/release/v11.5.1/gifs/v11.5.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.
 
 | | |
 | --- | --- |
-| **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.4.0/screenshots/13-chronicle.png) | **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v11.4.0/screenshots/04-brain-chat-home.png) |
-| **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v11.4.0/screenshots/05-memory-graph.png) | **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v11.4.0/screenshots/06-capture.png) |
-| **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v11.4.0/screenshots/12-review-center.png) | **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v11.4.0/screenshots/02-recommended-models.png) |
-| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v11.4.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.4.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.1/screenshots/13-chronicle.png) | **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v11.5.1/screenshots/04-brain-chat-home.png) |
+| **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v11.5.1/screenshots/05-memory-graph.png) | **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v11.5.1/screenshots/06-capture.png) |
+| **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v11.5.1/screenshots/12-review-center.png) | **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v11.5.1/screenshots/02-recommended-models.png) |
+| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v11.5.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.5.1/screenshots/08-system.png) |
 
 ## Why Lattice AI
 
@@ -58,54 +58,63 @@ First-run flow — wake the Brain, pick the owner, load a recommended model:
 
 | | | |
 | --- | --- | --- |
-| ![Login](output/release/v11.4.0/screenshots/01-login.png) | ![Model install](output/release/v11.4.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v11.4.0/screenshots/07-model-library.png) |
+| ![Login](output/release/v11.5.1/screenshots/01-login.png) | ![Model install](output/release/v11.5.1/screenshots/03-install-load-progress.png) | ![Model library](output/release/v11.5.1/screenshots/07-model-library.png) |
 
 Screenshot index and capture notes:
-[output/release/v11.4.0/SCREENSHOT_INDEX.md](output/release/v11.4.0/SCREENSHOT_INDEX.md)
+[output/release/v11.5.1/SCREENSHOT_INDEX.md](output/release/v11.5.1/SCREENSHOT_INDEX.md)
 
 ## Current Release
 
-The current release is **11.4.0 — Rust Foundation**:
-
-The Rust migration begins — not as a rewrite, but as **working, proven
-pieces**, while the Python server keeps serving every product surface.
-
-- **A `rust/` workspace with three crates.** `lattice-core` reads the
-  same `knowledge_graph.sqlite` (read-only, WAL) and carries a
-  bit-for-bit port of the local hash embedder. `lattice-retrieval` is the
-  native hybrid/keyword/vector engine — proven against committed Python
-  goldens at **75/75 exact parity, zero epsilon**, with a bidirectional
-  contract: a Python test suite re-runs the same goldens so neither side
-  can drift silently. `lattice-host` is the worker supervisor (HTTP
-  `/health` gating, crash auto-restart with backoff, graceful shutdown,
-  unified port selection) plus a loopback-only gateway: `/host/*` status,
-  native `/rust/search/*`, and a streaming reverse proxy for everything
-  else — an opt-in front door, with 194 Rust tests behind it.
-- **The desktop shell rides the new foundation.** The Tauri `main.rs`
-  shrank from 451 to 149 lines by consuming `lattice-host`; its five IPC
-  commands keep their exact contracts, a candidate-resolution
-  priority-order bug is fixed, and the TCP probe became a real health
-  check.
-- **The same discipline, extended.** CI gained a dedicated `rust` job
-  (fmt, clippy `-D warnings`, tests); the 1,000-line file ceiling now
-  covers `*.rs`; the version bump keeps the Rust workspace in lockstep
-  (25 synchronized targets). The full migration roadmap lives in
-  [docs/v11.4.0_RUST_FOUNDATION_PLAN.md](docs/v11.4.0_RUST_FOUNDATION_PLAN.md).
-
-All of it lands with the floor intact: **6,643 Python + 1,761 frontend
-tests at 100.00% statement and branch coverage, 194 Rust tests**, mypy
-and clippy clean, verified on macOS 3.14 and a fresh-resolve python 3.11
-environment.
+The current release is **11.5.1 — Rust Full Loop**:
+
+The two explicitly-remaining items are done: the agent loop orchestrator
+now runs in Rust — proven by replaying the real Python runtime on scripted
+LLM transcripts (**10 trajectories, byte-identical**) and by a live smoke
+against the real worker — and the document-generation context builder is
+native (53 new goldens, 247 total). Every Rust box in the target diagram
+is implemented; Python remains exactly the AI Worker that diagram draws:
+LLM inference, tool-handler execution, and all graph writes behind three
+new fully-covered worker seams with server-side circuit breakers intact.
+
+- **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 — now 7,006 Python +
+1,761 frontend — and 739 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.4.0 release must use exact filenames:
+Expected artifacts for 11.5.1 release must use exact filenames:
 
-- `dist/ltcai-11.4.0-py3-none-any.whl`
-- `dist/ltcai-11.4.0.tar.gz`
-- `ltcai-11.4.0.tgz`
-- `dist/ltcai-11.4.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_11.4.0_aarch64.dmg`
+- `dist/ltcai-11.5.1-py3-none-any.whl`
+- `dist/ltcai-11.5.1.tar.gz`
+- `ltcai-11.5.1.tgz`
+- `dist/ltcai-11.5.1.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_11.5.1_aarch64.dmg`
 
 Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
@@ -140,6 +149,8 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for details and
 
 | Version | Theme |
 | --- | --- |
+| 11.5.1 | Rust Full Loop |
+| 11.5.0 | Rust Complete |
 | 11.4.0 | Rust Foundation |
 | 11.3.0 | Time Remembers |
 | 11.2.0 | All Systems On |

package/docs/CHANGELOG.md

@@ -4,6 +4,54 @@ 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.1] - 2026-08-12 — Rust Full Loop
+
+### Added
+- **에이전트 루프 오케스트레이터 Rust 이식**(§4c 완결,
+  docs/v11.5.1_RUST_FULL_LOOP_PLAN.md): lattice-agent에 상태기계(200
+  전이 캡)·실행 루프 전 규칙·검증 fail-closed 매핑·롤백 3-tier·승인
+  스토어(sha256/TTL 600s/만료 410)·`POST /rust/agent/run`(SSE)/`resume`/
+  `approvals`. 증명: 실제 Python SingleAgentRuntime 대본 재생 궤적
+  10종 byte-identical + 헬퍼 그리드(액션 파서 38·정규화 24·판정 90) +
+  실워커 라이브 스모크(시임 4종 실통신, 무모델 턴 NEEDS_REVIEW 동일).
+- **AI Worker 시임**(additive, 100% 커버, 22번째 로컬라이즈 라우터):
+  `POST /agent/llm`(부작용 0), `POST /agent/tool`(서버측 서킷 브레이커
+  403·fail-closed 409 유지, `LATTICEAI_AGENT_TOOL_SEAM` 게이트 — 기본
+  꺼짐, 수퍼바이즈된 워커에만 주입), `POST /agent/change-proposal`.
+- **문서 생성 컨텍스트 네이티브**(§3b 이월 완결): docgen 검색·
+  multi_hop·retrieve_context_for_generation 전체 계약 — 골든 53 신규
+  (총 247) 완전 일치, `POST /rust/context/document`.
+
+### Changed
+- ARCHITECTURE.md System Map 다이어그램을 Rust 기반 현재 구조로 재작성
+  (Lattice Host front-door + 6크레이트 + AI Worker 경계).
+
+## [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

package/docs/COMMUNITY_AND_PLUGINS.md

@@ -1,6 +1,6 @@
 # Community And Plugins
 
-Current release: **11.4.0 — Rust Foundation**.
+Current release: **11.5.1 — Rust Full Loop**.
 
 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.4.0 — Rust Foundation**.
+Current release: **11.5.1 — Rust Full Loop**.
 
 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: **11.4.0 — Rust Foundation**.
+Current release: **11.5.1 — Rust Full Loop**.
 
 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.4.0)
+# Lattice AI — Operations Guide (v11.5.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/TRUST_MODEL.md

@@ -1,6 +1,6 @@
 # Lattice AI Trust Model
 
-Current release: **11.4.0 — Rust Foundation**.
+Current release: **11.5.1 — Rust Full Loop**.
 
 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.4.0 — Rust Foundation**.
+Current release: **11.5.1 — Rust Full Loop**.
 
 **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.4.0 — Rust Foundation**.
+Current release: **11.5.1 — Rust Full Loop**.
 
 명세 출처: `lattice_ai_full_spec.pptx` 슬라이드 20·21·22
 구현: `lattice_brain/graph/schema.py`

package/docs/v11.4.0_RUST_FOUNDATION_PLAN.md

@@ -156,12 +156,17 @@ Tauri 명령 5종(`backend_origin`/`backend_status`/`restart_backend`/
 
 ## 로드맵 (다이어그램 → 릴리스 매핑)
 
-| Phase | 릴리스 | 내용 |
-|---|---|---|
-| 1 | **11.4.0** | workspace + core 읽기층 + retrieval 패리티 + host 수퍼바이저/게이트웨이(옵트인) + Tauri 통합 |
-| 2 | 11.5.x | 게이트웨이 front-door 기본화, KG 읽기·3채널 검색·history 네이티브, Ingestion Watch/Chunk/Dedup |
-| 3 | 11.6.x | Jobs/Events/Pipeline/Scheduler, Context Builder 네이티브 |
-| 4 | 12.0 | Agent Runtime(Tools·Process·Sandbox·Permission) Rust화 — Python은 AI Worker로 수렴 |
+| Phase | 릴리스 | 내용 | 상태 |
+|---|---|---|---|
+| 1 | **11.4.0** | workspace + core 읽기층 + retrieval 패리티 + host 수퍼바이저/게이트웨이(옵트인) + Tauri 통합 | **출하됨** |
+| 2 | **11.5.0** | 게이트웨이 front-door 기본화(데스크톱), KG 읽기·3채널 검색·history 네이티브, Ingestion Watch/Chunk/Dedup | **출하됨** |
+| 3 | **11.5.0** | Jobs/Events/Scheduler, Context Builder 네이티브 | **출하됨** |
+| 4 | **11.5.0** | Agent Runtime(Tools·Sandbox·Permission) Rust화 — 단, 루프 오케스트레이션 이식은 명시적 비-목표로 남음(v11.5.0 계획 §4c) | **출하됨(커널)** |
+
+Phase 2~4는 원래 11.5.x~12.0으로 나뉘어 있었으나 한 릴리스로 합쳐 출하했다
+([`v11.5.0_RUST_COMPLETE_PLAN.md`](v11.5.0_RUST_COMPLETE_PLAN.md)). 아래 §
+"명시적 비-목표"의 네 항목 중 마지막(HNSW/quantized·CE rerank·이미지 late
+fusion 패리티)만 여전히 미이식이며, 나머지는 11.5.0에서 닫혔다.
 
 ## 릴리스 체크리스트 (11.4.0)
 

package/docs/v11.5.0_RUST_COMPLETE_PLAN.md

@@ -0,0 +1,145 @@
+# v11.5.0 — Rust Complete (설계 문서)
+
+> 상태: 계획 → 구현 → **출하됨(v11.5.0)**. v11.4.0 Rust Foundation 계획의
+> Phase 2·3·4를 한 릴리스로 완결한다. 원칙 불변: **작동하고 증명된
+> 조각만 출하하고, Python 서버는 목표 다이어그램의 AI Worker로
+> 수렴하되 제거되지 않는다.** 모든 네이티브 경로는 패리티 골든 또는
+> 결정표 골든으로 잠근다.
+>
+> 통합 상태: **완료**. 네 크레이트의 라우터 팩토리는 게이트웨이의
+> 리버스 프록시 폴스루보다 앞에 마운트되어 있고(`rust/lattice-host/src/gateway/mounts.rs`),
+> 데스크톱은 기본으로 게이트웨이 토폴로지로 뜬다(`src-tauri/src/topology.rs`,
+> 안전 밸브 3종 유지). §2a의 CSRF origin 주입과 SSE `X-Accel-Buffering`
+> 보강도 배선 완료. §4c(에이전트 루프 오케스트레이션 이식)만 의도적으로
+> 남아 있으며, 그 이유는 아래 본문 그대로다.
+
+## Phase 2 — Front Door + 읽기/검색/히스토리 네이티브 + Ingestion 프리미티브
+
+### 2a. 게이트웨이 front-door 기본화 (데스크톱)
+- 정찰 확정 사실: 쿠키(host-only)·CSP(`connect-src 'self' http://127.0.0.1:*`)
+  ·리다이렉트(전부 상대)는 origin 전환에 안전. **유일한 차단기는 CSRF
+  origin 정책이 워커 자신의 포트로 빌드되는 것**(web_runtime.py:42-67,
+  csrf.py:154-164 — Host는 프록시가 hop-by-hop으로 제거).
+- 해소(Rust만으로): `worker_env`가
+  `LATTICEAI_CSRF_TRUSTED_ORIGINS=http://127.0.0.1:{gw},http://localhost:{gw}`
+  를 워커에 주입(config.py:170이 이미 파싱). 게이트웨이 SSE 프록시는
+  `X-Accel-Buffering: no`를 이벤트 스트림 응답에 보강.
+- Tauri는 기본적으로 **게이트웨이 origin으로 항해**(`backend_origin` =
+  게이트웨이). `LATTICEAI_DESKTOP_BACKEND_ORIGIN`/`LATTICEAI_DESKTOP_DIRECT=1`
+  이면 종전 직결 유지(안전 밸브). e2e: 게이트웨이 경유 스모크 추가.
+- 알려진 잔여(문서화): invite-link 절대 URL(Host 재작성), SSO redirect
+  기본값, permission UI 기본 URL — 데스크톱 front-door에서 워커 포트를
+  가리킴. 영향 좁음(관리자/SSO 경로), FEATURE_STATUS에 명시.
+
+### 2b. 3채널 검색·KG 읽기·히스토리 네이티브 (lattice-retrieval 확장)
+패리티 대상(정찰 §6·§7의 명세 그대로):
+- `graph_search`: direct 1/rank + relationship 0.75/rank + traverse
+  이웃 0.45/rank, score=max 병합, **안정 정렬(동점 삽입순, id 타이브레이크
+  없음 — Python 그대로)**, graph_context 축적.
+- `relationship_search`: 6-way LIKE, `ORDER BY weight DESC, created_at
+  DESC, id ASC`, 양 끝점 스코프 통과 시만 생존, 점수 없음.
+- `traverse`: 무방향 BFS, 라운드당 `limit*3` 엣지 캡(라운드 종속성
+  포함 재현), visited<limit 게이트, 노드 수화 `updated_at DESC, id ASC`.
+- 서비스층 `hybrid_search`(3채널): `weights` 명시=재작성/감쇠 없음,
+  None=policy 적용; 기여도 `w * max(score, 1/rank)` 합산; 채널 payload
+  에코; POST/GET 비대칭 재현.
+- 히스토리 읽기: `_scope_sql`(빈 allowed+no-legacy ⇒ 1=0), 그룹핑
+  (`legacy-previous-history` 버킷, updated_at DESC), get_conversation
+  (전체 로드 후 필터 — 동일 재현), search(부분일치, "마지막 30그룹"
+  슬라이스 그대로).
+- 골든: 기존 픽스처 스토어 확장(대화 행 추가) + 새 질의 세트,
+  Python 계약 테스트 확장. 게이트웨이 라우트:
+  `/rust/search/service-hybrid`, `/rust/graph/{search,relationships,traverse}`,
+  `/rust/history`, `/rust/history/{conversations,search}` (라우터 팩토리로
+  노출, X5가 마운트).
+
+### 2c. lattice-ingest — Watch · Parse · Chunk · Dedup (단일 작성자 원칙)
+- **typed chunking 1:1 포트**(_kg_common/text.py 명세 전부: plain 1200/160,
+  markdown 섹션 스택+200자 전방 병합, code 세그먼트 팩킹+1.5x 하드리밋,
+  prose 경계 백업 `max(start+1, end-overlap)`, overlap 클램프) +
+  chunk id `chunk:{sha256(f"{node}:{i}:{text}")[:24]}` (utf-8 replace).
+- 해시 규약: `_clean_text`+sha256(text_hash), content_hash 이원 규약
+  (파일=바이트 sha256, 텍스트=`type|uri|text`) 그대로.
+- 파일 워치: mtime 폴링 스냅샷(현행 folder_watch 의미론 — OS 워처
+  아님)을 Rust 타이머로; 변경 감지 시 **워커의 기존 인제스트 API로
+  위임**(`POST /knowledge-graph/ingest` type=note 또는 folder 재스캔
+  트리거) — 그래프 쓰기는 계속 Python 단일 작성자. Rust는 감지·파싱
+  (txt/md)·청킹·중복 판정까지 수행하고 결과를 검증 가능하게 반환.
+- 패리티: 청킹 골든(Python 생성기 — 4전략 × 경계 케이스 · 한/영 ·
+  PDF 페이지 오프셋 산술) 완전 일치.
+
+## Phase 3 — Jobs · Events · Scheduler + Context Builder
+
+### 3a. lattice-jobs — 스케줄러 (문서화된 갭의 해소)
+- FEATURE_STATUS:179-185 "아무것도 배경 임베드 큐를 몰지 않는다"를
+  닫는다: Rust 타이머(기본 60s, env 조절)가 워커의 **신규 additive
+  엔드포인트** `POST /api/index/drain`(이번 릴리스에 Python에 추가,
+  `IngestionPipeline.drain_vector_queue` 호출, require_user+게이트,
+  100% 커버)을 호출. 미완 ingestion job resume도 동일 타이머가
+  `GET /api/ingestion/jobs` → 조건부 `/resume`으로 재개(기본 꺼짐,
+  `LATTICEAI_JOBS_AUTORESUME=1` 옵트인).
+- `/host/jobs` 상태 라우트: 마지막 틱 결과·다음 예정·큐 카운트
+  (`vector_jobs` 읽기 전용 카운트는 lattice-core로 직접).
+- 이벤트: 틱 결과를 호스트 로그 + `/host/jobs`에 노출(간결·정직).
+
+### 3b. Context Builder 네이티브 (lattice-retrieval 내 모듈)
+- `lattice_brain/context.py`의 `ContextAssembler` 포트: approx_tokens
+  `(len+3)//4`, 고정 섹션 순서(memories→artifacts→knowledge→notes→recent),
+  greedy 예산 절단(`content[:remaining*4]`, 절단 후 재계측 동작 포함)
+  — 시임은 네이티브 검색/히스토리 리더로 주입. 골든: 동일 픽스처에서
+  Python 어셈블러 출력과 완전 일치. 게이트웨이 `/rust/context/assemble`.
+- 문서 생성용 context_builder(B)는 Phase 4 이후로 명시 이월(
+  search_for_document_generation 의존).
+
+## Phase 4 — Agent Runtime: Tools · Sandbox · Permission (안전 커널)
+
+**다이어그램의 라벨(Tools/Process/Sandbox/Permission)을 Rust가 소유**하고,
+LLM 추론·변이 도구 실행은 워커에 위임(그것이 AI Worker의 정의다).
+
+### 4a. 권한 커널 — 결정표 패리티
+- `normalize_mode`(별칭 표 포함), `effective_auto_approve`(모드×도구
+  집합×risk×change_class 전 분기), `is_circuit_breaker`(파괴 risk·루트/홈
+  경로·rm -rf 변형), `should_stage_proposal`, `plan_requires_approval`,
+  `block_reason_for_tool`(우선순위 체인), `classify_tool_call`
+  (MUTATING_TOOL_INVENTORY 27종) 전부 포트.
+- **결정표 골든**: Python 생성기가 (mode × tool × policy × args)
+  그리드 수백 케이스의 판정을 JSON으로 떠서 커밋; Rust와 Python 양쪽
+  계약 테스트가 같은 골든을 상시 단언(11.4.0 방식).
+
+### 4b. 도구 샌드박스 — 검증 패리티 + 네이티브 실행(읽기 전용)
+- `run_command` 검증기 포트: shlex 분해, 실행경로/allowlist/셸 연산자/
+  find·rg 플래그/절대경로·`..`·심링크 이스케이프 규칙, env 치환
+  (HOME=AGENT_ROOT, 고정 PATH). **검증 판정 골든**(명령 문자열 그리드)
+  완전 일치. 통과한 읽기 전용 명령(pwd/ls/find/cat/head/tail/wc/rg)은
+  Rust가 직접 실행(타임아웃 30s·출력 12,000자 캡 동일).
+- 파일 도구: `_resolve_path` 의미론(AGENT_ROOT 격리) + read/list 네이티브.
+- 게이트웨이 `/rust/agent/preflight`(계획/도구콜 배열 + mode → 판정
+  목록)와 `/rust/agent/exec`(커널 통과 읽기 전용 명령만 실행; 그 외
+  는 판정과 함께 거부) — 변이는 절대 실행하지 않는다.
+
+### 4c. 루프 위임 — `/rust/agent/run`
+- 워커 `/agent`(SSE)로 턴을 위임하되 호스트가 `permission_mode`를
+  스탬프하고, 반환 계획에 커널 preflight를 병기해 표면에 제공.
+  Python 루프 자체의 재작성은 **명시적 비-목표**(결정 커널이 잠긴
+  지금, 루프 이식은 후속 릴리스의 기계적 작업으로 남긴다 — 이유:
+  AgentDeps 12개 시임의 실배선 검증 없이 이식하면 증명 없는 재작성).
+
+## 게이트/검증/릴리스
+
+- 신규 크레이트 3종(lattice-ingest/jobs/agent) 워크스페이스 편입,
+  전 파일 ≤1,000줄(목표 ≤500), fmt/clippy/test CI rust 잡 그대로.
+- Python 추가분(drain 엔드포인트 등)은 문·분기 100% 유지.
+- 골든 4계열(검색·히스토리/청킹/컨텍스트/권한·명령 판정) 모두
+  양방향(계약 pytest + cargo 테스트).
+- 릴리스 절차는 11.4.0과 동일: bump 11.5.0 → 문서·테마("Rust
+  Complete") → evidence 재촬영(13종+GIF) → artifacts(DMG) →
+  main 커밋·푸시 → CI 그린.
+
+## 정직한 경계 (FEATURE_STATUS에 그대로 기재)
+
+- Python 서버는 계속 모든 제품 표면을 서빙한다 — front-door는
+  데스크톱 기본 + 옵트인 바이너리이며, 네이티브 라우트는 검증된
+  대체 경로다.
+- 문서 파서 매트릭스(pdf/docx/xlsx/pptx)·임베딩 생산·LLM 추론·변이
+  도구 실행·그래프 쓰기는 워커 소유(설계상 단일 작성자/AI Worker).
+- 에이전트 루프 오케스트레이션의 Rust 이식은 남는다(4c의 이유).

package/docs/v11.5.1_RUST_FULL_LOOP_PLAN.md

@@ -0,0 +1,85 @@
+# v11.5.1 — Rust Full Loop (설계 문서)
+
+> 상태: 계획 → 구현 → **출하됨(v11.5.1)**. v11.5.0이 명시한 잔여 2건 —
+> §4c 에이전트 루프 오케스트레이션 이식, §3b 이월분 문서 생성용
+> context_builder(B) — 을 완결한다. 이로써 사용자 목표 다이어그램의
+> 모든 Rust 박스가 구현·증명되고, **Python은 다이어그램에 그려진
+> 그대로의 AI Worker**(모델 추론 + 도구 핸들러 실행 + 그래프 쓰기)로
+> 남는다. 이는 전환의 완성 형태이지 잔여가 아니다.
+
+## Y1 — 워커 AI-Worker 시임 3종 (Python, additive)
+
+정찰 확정: 베어 LLM 완성 엔드포인트 없음, HTTP 제안 생성 불가,
+`/tools/*`는 direct-surface 게이트(enforce_policy)라 루프용으로 부적합.
+
+- `POST /agent/llm` — `LLMRouter.generate_as` 얇은 래퍼
+  `{model_id?, message, context?, max_tokens?, temperature?}` → `{text}`.
+  히스토리/영속 부작용 0. require_user + 레이트리밋.
+- `POST /agent/tool` — 루프 전용 거버넌스 시임:
+  `{tool, args, user_email?, workspace_id?}` →
+  `check_role` + `dispatch_tool(HOOKS, source="agent")` 결과
+  `{result}|{error}`. **서버측 모드 불변 가드는 유지**(우회 불가):
+  `is_circuit_breaker`/destructive policy → 403,
+  `classify_tool_call.fail_closed` → 409. 게이트 뒤:
+  `LATTICEAI_AGENT_TOOL_SEAM=1`(기본 꺼짐 — 호스트가 자기 워커에만
+  주입) 아니면 404. mode 게이팅 자체는 Rust 커널이 소유(사전 preflight).
+- `POST /agent/change-proposal` — `ChangeProposalService.review(...)`
+  verbatim 노출(제안-우선 경로). 같은 시임 게이트.
+
+전부 100% 문·분기, ko/en 로컬라이즈, OpenAPI 재생성.
+
+## Y2 — lattice-agent: 루프 오케스트레이터 (정찰 §1 명세 1:1)
+
+- 결정적 헬퍼 포트+골든: `extract_action_details`(관용 체인 6단),
+  `normalize_plan`(7규칙 순서), `infer_project_manifest`/`infer_file_target`,
+  `artifact_checklist`, `requirement_coverage`, `_truncate_strings`,
+  `filter_learnings`, PhaseBudgets/TranscriptBudget 기본값, 검증 매핑
+  표(UNAVAILABLE/PASS-무증거/PASS-미충족/ROLLBACK/재시도/모순 verdict),
+  실행 루프 규칙(budget, parse_failure_budget/escalate, `final`,
+  `_is_repeated_create`, SCOPED 강제 주입, step_index 산식).
+- 상태기계: run_to_completion 전이표 + 200캡(state_history 길이 기준),
+  rollback 3-tier(git→snapshot→none, 종단 항상 FAILED) — snapshot/
+  restore는 Rust 네이티브(sandbox Workspace 재사용).
+- 승인 스토어: run_id/token 생성(urlsafe 16/32), sha256 토큰 해시,
+  TTL 600s, 만료 후 86400s 보존→410+replan, 원자적 JSON 저장,
+  `serialize/restore_run_context` 필드 계약 그대로(미지 상태→
+  WAITING_APPROVAL).
+- 워커 클라이언트: `/agent/llm`(plan/execute/verify/memory),
+  `/agent/tool`(비-네이티브 도구), `/agent/change-proposal`(strict
+  제안), 네이티브 실행은 X4 커널의 읽기 전용 세트.
+- 라우트: `POST /rust/agent/run`(SSE `agent_step` 이벤트 + 최종 페이로드
+  — Python `/agent` 프로토콜 동형), `POST /rust/agent/resume`,
+  `GET /rust/agent/approvals`. lattice-host: worker_env에
+  `LATTICEAI_AGENT_TOOL_SEAM=1` 주입 + mounts 시그니처 갱신.
+- 골든: Python 생성기가 결정적 헬퍼 그리드 + fake-LLM 대본 기반
+  end-to-end 상태 궤적(plan→…→terminal, 모드 3종 × 시나리오:
+  정상 DONE/파스 예산 소진/반복 생성 가드/승인 대기·재개/만료 410/
+  검증 재시도→FAILED/ROLLBACK)을 JSON으로 커밋, 양방향 계약.
+  LLM 호출은 대본 주입(결정적) — Python 쪽도 같은 대본으로 구동.
+
+## Y3 — 문서 생성 컨텍스트(B) 네이티브 (lattice-retrieval)
+
+정찰 §4 명세 1:1: `search_for_document_generation`(2-lane LIKE 후보,
+0.5/0.3/0.2 가중 + 1.2 타입 부스트, log1p(edge)/4, half-life 14d,
+비안정 정렬의 삽입순 타이브레이크 재현), `multi_hop_context`(hop 라벨
+의미론 — 확장 라운드 기준, hop-2는 엣지 끝점으로만), `retrieve_context_
+for_generation` 전체 계약(self-model 블록 예산 산식 — 결합 개행 과금
+포함, 섹션 4종 고정, `relevance: {:.2f}` 마크다운, `\n### ` 백오프 트림,
+sources dedup 체인, trace). `summary_for_prompt`는 스토어 읽기 포트.
+게이트웨이 `POST /rust/context/document`. 골든: 픽스처에 docgen 타입
+노드 추가(스토어 재생성 — 기존 골든 재검증 필수), 신규 스위트 +
+계약 pytest 확장.
+
+## 릴리스 (11.5.1)
+
+전 게이트 + fresh venv → bump → 문서·테마("Rust Full Loop") →
+**ARCHITECTURE.md System Map 다이어그램을 Rust 기반 현재 상태로 재작성**
+(Lattice Host front-door, 6크레이트, AI Worker 경계) → evidence 재촬영
+→ artifacts(DMG) → main 커밋·푸시 → 태그/Release → CI 그린.
+
+## 완성 후 남는 것 (설계상 최종 형태 — 잔여 아님)
+
+Python AI Worker가 소유: LLM 추론(`/agent/llm`), 도구 핸들러 실행과
+그래프·파일 쓰기(`/agent/tool`, 단일 작성자), 제안 스테이징, 문서
+파서 매트릭스, 임베딩 생산. 이것이 사용자 다이어그램의 "Python AI
+Worker" 박스다.

package/lattice_brain/__init__.py

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

package/lattice_brain/runtime/multi_agent.py

@@ -49,7 +49,7 @@ from typing import Any, Callable, Dict, List, Optional
 from ..utils import now_iso as _now
 from .contracts import multi_agent_contract
 
-MULTI_AGENT_VERSION = "11.4.0"
+MULTI_AGENT_VERSION = "11.5.1"
 
 AGENT_ROLES = ("researcher", "planner", "executor", "reviewer", "release")
 CORE_PIPELINE = ("planner", "executor", "reviewer")

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "11.4.0"
+__version__ = "11.5.1"