ltcai 9.0.0 → 9.2.0

package/docs/mcp-tools.md

@@ -1,4 +1,4 @@
-# MCP 도구 카탈로그
+# MCP 도구 카탈로그 (v9.2.0)
 
 Lattice AI는 MCP(Model Context Protocol) 서버로 동작하여 Claude Desktop, Cursor 등에서 직접 도구를 사용할 수 있습니다.
 
@@ -31,7 +31,7 @@ Lattice AI는 MCP(Model Context Protocol) 서버로 동작하여 Claude Desktop,
 
 | 도구 | 설명 | 위험도 |
 |------|------|--------|
-| `run_command` | 셸 명령 실행 (위험 패턴 차단) | 높음 |
+| `run_command` | shell 없이 고정 read-only 명령 allowlist 실행 | 높음 |
 | `run_terminal_command` | 터미널 명령 (별칭) | 높음 |
 
 ### 작업 관리
@@ -45,10 +45,11 @@ Lattice AI는 MCP(Model Context Protocol) 서버로 동작하여 Claude Desktop,
 
 | 도구 | 설명 | 위험도 |
 |------|------|--------|
-| `computer_screenshot` | 화면 캡처 | 낮음 |
+| `computer_screenshot` | 화면 캡처 (desktop-control capability 및 정책 승인 필요) | 높음 |
+| `computer_status` | 데스크톱 제어 상태 조회 (동일 capability/policy 적용) | 중간 |
 | `computer_open_app` | 앱 실행 | 중간 |
 | `computer_open_url` | URL 열기 | 낮음 |
-| `network_status` | IP, Wi-Fi 정보 | 낮음 |
+| `network_status` | IP, Wi-Fi 정보 (인증 및 ToolRegistry 정책 적용) | 중간 |
 
 ### 문서
 
@@ -91,13 +92,18 @@ curl -b "session=<token>" \
 curl -b "session=<token>" -X POST \
   http://localhost:4825/tools/run_command \
   -H "Content-Type: application/json" \
-  -d '{"command": "python -m pytest tests/ -v"}'
+  -d '{"command": "rg TODO ."}'
 ```
 
+`run_command`는 `pwd`, `ls`, `find`, `cat`, `head`, `tail`, `wc`, `rg`만 허용합니다.
+Python/Node/npm/npx/sed, shell operator, 실행 파일 경로, 절대 경로, `..` traversal,
+workspace 밖 symlink, `rg --pre`, `find -exec/-delete`는 거부됩니다. 빌드와 테스트는
+별도의 허용된 project-script 도구를 사용합니다.
+
 ## 도구 카탈로그 조회
 
 ```bash
-curl http://localhost:4825/mcp/tools
+curl -b "session=<token>" http://localhost:4825/mcp/tools
 ```
 
 응답:
@@ -114,3 +120,8 @@ curl http://localhost:4825/mcp/tools
   ]
 }
 ```
+
+도구 카탈로그는 인증이 필요하며 서버의 절대 `AGENT_ROOT`를 반환하지 않습니다.
+MCP/plugin dispatch도 각 도구의 사용자·workspace·capability·승인 정책을 우회할
+수 없습니다. knowledge/Obsidian 계열 읽기는 명시적 사용자 동의와 scope를
+사용합니다.

package/docs/privacy.md

@@ -2,7 +2,9 @@
 
 ## 요약
 
-**Lattice AI는 데이터를 수집하거나 외부 서버로 전송하지 않습니다.**
+**Lattice AI는 기본 상태에서 텔레메트리를 수집하거나 사용자 데이터를 외부로
+전송하지 않습니다.** 사용자가 명시적으로 선택한 클라우드 모델, 모델 다운로드,
+웹 페이지 읽기, Telegram/Brain Network 같은 외부 기능은 해당 대상과 통신합니다.
 
 모든 데이터는 사용자의 로컬 머신에만 저장됩니다.
 
@@ -11,7 +13,7 @@
 | 데이터 | 저장 위치 | 설명 |
 |--------|-----------|------|
 | 사용자 계정 | `~/.ltcai/users.json` | 이름, scrypt 해시 비밀번호, 역할 |
-| 세션 토큰 | `~/.ltcai/sessions.json` | UUID 토큰, 만료시간 |
+| 세션 토큰 | `~/.ltcai/sessions.json` | SHA-256 토큰 해시, 만료/갱신 시각(평문 bearer 미저장) |
 | 채팅 히스토리 | `~/.ltcai/chat_history.json` | 사용자-AI 대화 내용 |
 | 지식 그래프 | `~/.ltcai/knowledge_graph.sqlite` | 채팅/문서/웹/탭 노드·엣지, 프로비넌스 |
 | 업로드/수집 파일 | `~/.ltcai/knowledge_graph_blobs/` | 원본 PDF/DOCX/웹 텍스트 등 |
@@ -38,11 +40,25 @@
 
 Apple Silicon MLX 로컬 모델 사용 시에는 프롬프트가 외부로 전송되지 않습니다.
 
+## Telegram 및 권한 알림
+
+Telegram bridge는 사용자가 명시적으로 활성화하고 chat ID를
+`LATTICEAI_TELEGRAM_ALLOWED_CHAT_IDS`에 등록한 경우에만 해당 chat의 메시지와
+callback query를 처리합니다. 로컬 Lattice API 호출에는 전용
+`LATTICEAI_SERVER_SESSION_TOKEN`을 사용하며 세션 저장 파일에서 bearer를 찾지
+않습니다.
+
+Discord 등의 권한 요청 알림에는 전체 승인 토큰이 아닌 짧은 hint만 포함됩니다.
+운영자가 `LATTICEAI_PERMISSION_UI_URL`을 설정하면 검토 페이지 링크를 제공할 수
+있지만, 승인 토큰 자체는 메시지나 URL에 넣지 않습니다.
+
 ## 웹/브라우저 수집 (v3.6.0)
 
 - **URL 읽기**(`/api/browser/read-url`): 사용자가 명시적으로 요청한 URL을 **로컬
   런타임이 직접** 가져와 텍스트만 추출해 그래프에 색인합니다. Lattice AI가 임의로
-  크롤링하지 않으며, 가져온 페이지는 외부로 다시 전송되지 않습니다.
+  크롤링하지 않으며, 가져온 페이지는 외부로 다시 전송되지 않습니다. private/local
+  주소와 DNS rebinding을 차단하고 redirect마다 다시 검증하며 최대 4MB의 textual
+  응답만 스트리밍합니다.
 - **브라우저 탭 수집**(`/api/browser/ingest-current-tab`) 및 Manifest V3 확장:
   확장 프로그램은 **오직 `127.0.0.1`(로컬)** 로만 전송합니다. 클라우드 엔드포인트가
   존재하지 않습니다(`browser-extension/` 소스에서 단일 `fetch` 대상 확인 가능).

package/docs/public-deploy.md

@@ -7,7 +7,8 @@ Render, Fly.io, Railway, VPS 등 외부 서버에 Lattice AI를 배포할 때
 ```bash
 # 필수
 LATTICEAI_MODE=public
-LATTICEAI_INVITE_CODE=my-secret-invite-code   # 회원가입 시 필요한 초대 코드
+LATTICEAI_INVITE_GATE_ENABLED=true            # 초대 온보딩을 사용할 때만 활성화
+LATTICEAI_INVITE_CODE=my-random-invite-code   # 권장: 운영자가 생성한 랜덤 초대 코드
 
 # 클라우드 모델 (최소 하나 이상)
 OPENAI_API_KEY=sk-...
@@ -24,8 +25,33 @@ LATTICEAI_ENABLE_TELEGRAM=false               # Telegram 봇 비활성화
 LATTICEAI_ENABLE_GRAPH=false                  # Data Graph 비활성화
 LATTICEAI_DATA_DIR=/data                      # 데이터 디렉토리
 LATTICEAI_ADMIN_EMAILS=you@example.com        # 어드민 이메일 고정
+LATTICEAI_PERMISSION_UI_URL=https://example.com/admin/permissions  # 선택
 ```
 
+public/non-loopback 모드는 인증을 강제하고 공개 회원가입을 닫습니다. 초대
+온보딩이 필요할 때만 `LATTICEAI_INVITE_GATE_ENABLED=true`로 게이트를 켭니다.
+초대 게이트에는 공용 기본 코드가 없습니다. `LATTICEAI_INVITE_CODE`를 생략하면
+게이트 활성화 시 CSPRNG로 설치별 코드와 쿠키 서명 키를 만들고 데이터 디렉터리의
+권한 제한 파일에 보관합니다. 운영 환경에서는 직접 랜덤 값을 설정하거나 이 파일이
+영구 볼륨에 남도록 해야 합니다. `authorized=true` 같은 정적 쿠키는 인증되지 않습니다.
+서명된 초대 claim은 해당 회원가입 요청만 허용하며, claim 없는 `/register` 직접
+호출은 공개 회원가입이 닫힌 상태를 우회할 수 없습니다.
+
+Telegram을 의도적으로 활성화할 때만 아래 세 값을 모두 설정합니다.
+
+```bash
+LATTICEAI_ENABLE_TELEGRAM=true
+LATTICEAI_TELEGRAM_BOT_TOKEN=...
+LATTICEAI_TELEGRAM_ALLOWED_CHAT_IDS=123456789,987654321
+LATTICEAI_SERVER_SESSION_TOKEN=...
+```
+
+허용목록은 메시지와 callback query 모두에 등록보다 먼저 적용됩니다. 비어 있으면
+모든 chat을 거부합니다. `LATTICEAI_SERVER_SESSION_TOKEN`은 봇 전용 인증 세션의
+bearer이며 `sessions.json`에 저장된 해시를 복사해서는 안 됩니다.
+`LATTICEAI_PERMISSION_UI_URL`은 선택적인 승인 검토 페이지 링크일 뿐이며, 알림에는
+전체 승인 토큰이 포함되지 않습니다.
+
 ## Docker
 
 ```dockerfile
@@ -38,6 +64,7 @@ docker run --rm \
   -p 4825:4825 \
   -e LATTICEAI_MODE=public \
   -e OPENAI_API_KEY="$OPENAI_API_KEY" \
+  -e LATTICEAI_INVITE_GATE_ENABLED=true \
   -e LATTICEAI_INVITE_CODE="my-secret-code" \
   -v "$PWD/.data:/data" \
   lattice-ai
@@ -56,7 +83,7 @@ docker run --rm \
 
 ```bash
 fly launch
-fly secrets set LATTICEAI_MODE=public OPENAI_API_KEY=sk-... LATTICEAI_INVITE_CODE=secret
+fly secrets set LATTICEAI_MODE=public OPENAI_API_KEY=sk-... LATTICEAI_INVITE_GATE_ENABLED=true LATTICEAI_INVITE_CODE=secret
 fly volumes create ltcai_data --size 1
 fly deploy
 ```
@@ -117,13 +144,15 @@ yourdomain.com {
 ## 퍼블릭 배포 체크리스트
 
 - [ ] `LATTICEAI_MODE=public` 설정
-- [ ] `LATTICEAI_INVITE_CODE` 비공개 랜덤 값으로 설정
+- [ ] 초대 온보딩이 필요하면 `LATTICEAI_INVITE_GATE_ENABLED=true`와 비공개
+      랜덤 `LATTICEAI_INVITE_CODE` 설정(또는 생성된 설치별 secret 영구 보관)
 - [ ] HTTPS 리버스 프록시 구성 (nginx / Caddy)
 - [ ] 영구 볼륨 마운트 (`/data` 또는 `LATTICEAI_DATA_DIR`)
 - [ ] 방화벽에서 4825 포트 직접 노출 차단
 - [ ] `LATTICEAI_ALLOW_LOCAL_MODELS=false`
 - [ ] 최소 하나의 클라우드 API 키 설정
 - [ ] 첫 가입 후 어드민 계정 확인 (`http://yourdomain.com/admin`)
+- [ ] Telegram 활성화 시 chat ID 허용목록과 전용 서버 세션 토큰을 모두 설정
 
 ## 지원 클라우드 모델 프리픽스
 

package/docs/security-model.md

@@ -22,15 +22,23 @@ Lattice AI는 **개인 AI 워크스페이스**로 설계되었습니다. 기본
 
 ### 세션
 
-- UUID 토큰, `~/.ltcai/sessions.json` 파일 저장
+- `secrets.token_urlsafe`로 생성한 토큰은 SHA-256 해시만
+  `~/.ltcai/sessions.json`에 저장(레거시 평문 토큰은 로드 시 자동 마이그레이션)
 - TTL: 24시간 + sliding refresh (활동 시 자동 연장, 15분 단위 디스크 쓰기)
 - 쿠키: `HttpOnly; SameSite=Lax; Path=/`
+- public/non-loopback에서는 `Secure`도 강제(HTTPS 필요)
 - 서버 재시작 후에도 유지 (파일 기반)
+- 삭제되거나 비활성화된 계정의 기존 세션은 다음 요청에서 즉시 거부
+- POSIX에서 데이터 디렉터리 `0700`, atomic JSON/세션 파일 `0600`
+- 초대 게이트 쿠키는 설치별 secret으로 HMAC 서명되고 만료 시각을 포함함.
+  `authorized=true` 리터럴은 신뢰하지 않으며, 공용 기본 invite code도 없음
 
 ### SSO (선택적)
 
 - Entra ID / Okta OIDC (`OIDC_DISCOVERY_URL`, `OIDC_CLIENT_ID`, `OIDC_CLIENT_SECRET`)
 - 콜백 후 내부 세션 토큰으로 변환
+- 초대 게이트 활성화 시 신규 SSO JIT 계정은 서명 초대 권한이 필요하며,
+  해당 권한은 서버 측 일회용 state/nonce/PKCE 트랜잭션에 바인딩됨
 - 어드민 핸드오프: `sessionStorage` 1회 읽기 (URL 파라미터 노출 방지)
 
 ## API 키 보안
@@ -83,15 +91,27 @@ MAGIC_NUMBERS = {
 - **수집 라이프사이클**: 모든 수집은 `IngestionPipeline.ingest` → `dispatch_tool`
   를 거쳐 `pre_tool`/`post_tool` 훅이 발화됩니다. `pre_tool`이 차단하면 수집은
   정직하게 `status="blocked"`로 거부됩니다(권한 게이트·민감정보 가드 적용).
-- **웹 URL 읽기**(`/api/browser/read-url`): `http(s)` 스킴만 허용(파일/기타 스킴
-  거부), 12초 타임아웃, 4MB 응답 상한, HTML/text 컨텐츠 타입만 처리. 차단/로그인
-  필요 페이지는 5xx가 아닌 **422로 우아하게 실패**합니다. 로컬 런타임이 사용자가
-  명시한 URL만 가져옵니다(자동 크롤링 없음).
+- **웹 URL 읽기**(`/api/browser/read-url`): `http(s)`만 허용하고 DNS의 모든 결과에서
+  loopback/private/link-local/multicast/reserved 주소를 거부합니다. 검증한 IP에 연결을
+  고정해 DNS rebinding을 막고, redirect마다 재검증하며 환경 proxy를 사용하지
+  않습니다. 12초 타임아웃, 스트리밍된 4MB 응답 상한, textual content type만
+  처리합니다. 차단/로그인 필요 페이지는 5xx가 아닌 **422로 실패**합니다.
 - **브라우저 탭 수집**(`/api/browser/ingest-current-tab`): payload 정화(스크립트/
   스타일 제거) + 페이로드 크기 상한(413). Manifest V3 확장은 **`127.0.0.1`로만**
   전송하며 클라우드 엔드포인트가 없습니다.
-- **포터빌리티 권한**: 그래프 export/status 읽기는 로그인 사용자, **import /
-  backup / restore 는 admin 전용**(`require_admin`). 그래프는 머신-전역 자원입니다.
+- **포터빌리티 권한**: 상태 읽기는 로그인 사용자, 전체 그래프 export/provenance와
+  **import / backup / restore는 admin 전용**(`require_admin`)입니다. 그래프는
+  머신-전역 자원입니다.
+- **워크스페이스 컨텍스트**: MCP 그래프 호출, 메모리 recall, hybrid search,
+  garden-note 컨텍스트, realtime presence는 인증된 사용자와 활성/허용 workspace에
+  바인딩됩니다. 에이전트·플러그인 registry 및 graph curation 변경은 admin
+  전용이며, MCP 환경 변수 값은 API 응답에 포함되지 않습니다. MCP/플러그인
+  실행은 local file/document 도구를 호출할 수 없고 전용 승인 토큰 경로를
+  사용해야 합니다. Document RAG와 answer trace도 동일한 workspace 범위로
+  검색·저장됩니다.
+- **fail-closed KG 범위**: workspace projection 조회 실패 또는 scope를 알 수 없는
+  v2 node는 반환하지 않습니다. legacy-global 데이터는
+  `include_legacy_global=True`를 명시한 호환 경로에서만 읽습니다.
 - **복원 무결성**: 백업 아카이브는 `manifest.json`의 sha256과 대조 검증 후에만
   복원되며, 불일치 시 거부됩니다.
 
@@ -99,9 +119,10 @@ MAGIC_NUMBERS = {
 
 ### `run_command()` 위험 플래그 차단
 
-다음 패턴이 포함된 명령 실행 거부:
-- `rm -rf`, `sudo`, `chmod 777`, `curl | bash`, `wget | sh`
-- `> /dev/sda`, `dd if=`, `mkfs`
+고정 allowlist(`pwd`, `ls`, `find`, `cat`, `head`, `tail`, `wc`, `rg`)와 정화된
+환경만 사용합니다. Python/Node/npm/npx/sed 같은 일반 인터프리터, 실행 파일 경로,
+절대 경로·`..` traversal·workspace 밖 symlink, `rg --pre`, `find -exec/-delete`
+등은 실행 전에 거부합니다.
 
 ### `edit_file()` 유일성 검증
 
@@ -119,6 +140,17 @@ MAGIC_NUMBERS = {
 - 평문 비밀번호 마이그레이션 이벤트: `password_migrated_from_plaintext`
 - `server.log` 파일에 모든 요청 기록
 
+## Telegram 및 권한 알림
+
+- Telegram은 `LATTICEAI_TELEGRAM_ALLOWED_CHAT_IDS`에 지정된 chat의 메시지와
+  callback query만 처리하며, 허용 전에 chat을 등록하지 않습니다.
+- 봇의 로컬 API 호출에는 `LATTICEAI_SERVER_SESSION_TOKEN` 전용 bearer가
+  필요합니다. 봇은 `sessions.json`을 스캔하지 않습니다.
+- 권한 요청 알림은 전체 승인 토큰 대신 8자 hint만 포함합니다. 선택적인
+  `LATTICEAI_PERMISSION_UI_URL`은 사람의 검토 페이지로 연결하지만 토큰을 URL에
+  넣지 않습니다.
+- permission queue는 atomic write와 POSIX `0600`을 사용합니다.
+
 ## 텔레메트리
 
 **없음.** 모든 데이터는 로컬에만 저장됩니다. 외부 서버로 어떠한 사용 데이터도 전송되지 않습니다.
@@ -128,11 +160,14 @@ MAGIC_NUMBERS = {
 ## 퍼블릭 배포 체크리스트
 
 - [ ] `LATTICEAI_MODE=public`
-- [ ] `LATTICEAI_INVITE_CODE` 비공개 값 설정
+- [ ] 초대 온보딩을 사용할 때만 `LATTICEAI_INVITE_GATE_ENABLED=true`와 비공개
+  `LATTICEAI_INVITE_CODE` 설정(미설정 시 생성되는 설치별 secret 영구 보관)
 - [ ] HTTPS 리버스 프록시 (nginx/Caddy)
 - [ ] `LATTICEAI_ENABLE_GRAPH=false` (필요 시)
 - [ ] `/data` 영구 볼륨 마운트
 - [ ] `LATTICEAI_ALLOW_LOCAL_MODELS=false`
 - [ ] 방화벽에서 4825 포트 직접 노출 차단 (리버스 프록시 통해서만)
+- [ ] Telegram 활성화 시 `LATTICEAI_TELEGRAM_ALLOWED_CHAT_IDS`와
+  `LATTICEAI_SERVER_SESSION_TOKEN` 설정
 
 자세한 내용: [public-deploy.md](public-deploy.md)

package/lattice_brain/__init__.py

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

package/lattice_brain/archive.py

@@ -17,7 +17,6 @@ import sqlite3
 import tempfile
 import zipfile
 from dataclasses import dataclass
-from datetime import datetime, timezone
 from pathlib import Path, PurePosixPath
 from typing import Any, Dict, Iterable, List, Optional
 
@@ -26,7 +25,7 @@ from cryptography.hazmat.primitives.ciphers.aead import AESGCM
 from cryptography.exceptions import InvalidTag
 from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
 
-from .utils import sha256_file as _sha256_file
+from .utils import sha256_file as _sha256_file, utc_now_iso as _now
 
 
 ARCHIVE_FORMAT = "latticebrain.encrypted"
@@ -48,10 +47,6 @@ PORTABLE_DATA_FILES = (
 PORTABLE_EXPORT_SUFFIXES = (".json", ".zip")
 
 
-def _now() -> str:
-    return datetime.now(timezone.utc).isoformat()
-
-
 def _stamp() -> str:
     return _now().replace(":", "").replace("-", "").replace(".", "")[:15]
 

package/lattice_brain/context.py

@@ -13,6 +13,7 @@ design-review amendment T5).
 
 from __future__ import annotations
 
+import inspect
 import logging
 from dataclasses import dataclass, field
 from typing import Any, Callable, Dict, List, Optional
@@ -23,6 +24,46 @@ def approx_tokens(text: str) -> int:
     return max(0, (len(text or "") + 3) // 4)
 
 
+def _call_context_seam(callback: Callable[..., Any], query: str, **context: Any) -> Any:
+    """Pass identity/scope only when a legacy seam declares support for it.
+
+    Signature inspection preserves old one-argument adapters without catching
+    a callback's own ``TypeError`` and retrying it with less restrictive scope.
+    If a callable cannot be inspected, the secure behavior is to pass every
+    context field and let the caller's failure isolation omit that section.
+    """
+    try:
+        parameters = inspect.signature(callback).parameters
+    except (TypeError, ValueError):
+        return callback(query, **context)
+    accepts_kwargs = any(
+        item.kind is inspect.Parameter.VAR_KEYWORD
+        for item in parameters.values()
+    )
+    supported = context if accepts_kwargs else {
+        key: value for key, value in context.items()
+        if key in parameters
+    }
+    return callback(query, **supported)
+
+
+def _call_keyword_seam(callback: Callable[..., Any], **context: Any) -> Any:
+    """Invoke a keyword-only seam while preserving legacy narrow signatures."""
+    try:
+        parameters = inspect.signature(callback).parameters
+    except (TypeError, ValueError):
+        return callback(**context)
+    accepts_kwargs = any(
+        item.kind is inspect.Parameter.VAR_KEYWORD
+        for item in parameters.values()
+    )
+    supported = context if accepts_kwargs else {
+        key: value for key, value in context.items()
+        if key in parameters
+    }
+    return callback(**supported)
+
+
 @dataclass
 class ContextSection:
     name: str
@@ -112,11 +153,11 @@ class ContextAssembler:
         if self._memory_recall is not None:
             sections.append(self._memories_section(query, user_email, workspace_id, memory_limit))
         if self._hybrid_search is not None:
-            sections.append(self._knowledge_section(query, knowledge_limit, user_email))
+            sections.append(self._knowledge_section(query, knowledge_limit, user_email, workspace_id))
         if self._notes_context is not None:
-            sections.append(self._notes_section(query))
+            sections.append(self._notes_section(query, user_email, workspace_id))
         if self._recent_chat is not None:
-            sections.append(self._recent_section(user_email, conversation_id))
+            sections.append(self._recent_section(user_email, conversation_id, workspace_id))
 
         sections = [s for s in sections if s.content.strip()]
         self._apply_budget(sections, budget)
@@ -141,9 +182,15 @@ class ContextAssembler:
             ],
         )
 
-    def _knowledge_section(self, query, limit, user_email=None) -> ContextSection:
+    def _knowledge_section(self, query, limit, user_email=None, workspace_id=None) -> ContextSection:
         try:
-            hybrid = self._hybrid_search(query, limit=limit, user_email=user_email)
+            hybrid = _call_context_seam(
+                self._hybrid_search,
+                query,
+                limit=limit,
+                user_email=user_email,
+                workspace_id=workspace_id,
+            )
             matches = hybrid.get("matches", [])[:limit]
         except Exception as exc:
             logging.debug("context: hybrid search failed: %s", exc)
@@ -166,9 +213,14 @@ class ContextAssembler:
             provenance=provenance,
         )
 
-    def _notes_section(self, query) -> ContextSection:
+    def _notes_section(self, query, user_email=None, workspace_id=None) -> ContextSection:
         try:
-            content = self._notes_context(query) or ""
+            content = _call_context_seam(
+                self._notes_context,
+                query,
+                user_email=user_email,
+                workspace_id=workspace_id,
+            ) or ""
         except Exception as exc:
             logging.debug("context: notes context failed: %s", exc)
             content = ""
@@ -179,9 +231,14 @@ class ContextAssembler:
             provenance=[{"source": "garden", "included": bool(content)}],
         )
 
-    def _recent_section(self, user_email, conversation_id) -> ContextSection:
+    def _recent_section(self, user_email, conversation_id, workspace_id=None) -> ContextSection:
         try:
-            content = self._recent_chat(user_email=user_email, conversation_id=conversation_id) or ""
+            content = _call_keyword_seam(
+                self._recent_chat,
+                user_email=user_email,
+                conversation_id=conversation_id,
+                workspace_id=workspace_id,
+            ) or ""
         except Exception as exc:
             logging.debug("context: recent chat failed: %s", exc)
             content = ""

package/lattice_brain/graph/_kg_fsutil.py

@@ -22,11 +22,7 @@ from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple
 
 from ._kg_constants import *  # noqa: F401,F403
-from ..utils import parse_iso as _parse_iso
-
-
-def _now() -> str:
-    return datetime.now().isoformat()
+from ..utils import now_iso as _now, parse_iso as _parse_iso
 
 
 def _recency_score(