스냅샷 기준일: 2026-05-06 범례: ✅ 구현됨 /
⚠️ 부분·스텁 / ❌ 미구현
블로킹 의사결정 없이 단독 코드 변경으로 끝낼 수 있는 항목들.
- Skill 실행 sandbox 격리 —
WorkerSandbox(worker_threads) 도입 (commit85b3cc3). per-execute fresh spawn + V8 isolate +resourceLimits(256MB old / 32MB young / 64MB code) +env: {}(parent process.env 비공유,shareEnv: true옵트인) +terminate()on timeout. 추가로 ad-hoccode.exec툴 (turn 내 일회성 실행,skill.create와 동일 staticCheckSource 필터).ReasoningContext.liveTools로 mid-turn 등록된 도구가 같은 턴에서 호출 가능. 옵션 (a) Docker 가 아닌 (변형) —worker_threads+ capability guard 결합. Docker 는DockerSandbox로 high-risk 도구(bash.run)에 그대로 유지 - 외부 바이너리 실행 경로 —
binary.run툴 도입.DockerCommandSpec.mounts?+RunOptions.mounts?추가해skillInstallRoot를 컨테이너에 read-only bind-mount (/skills). interpreter 화이트리스트 (python3/node/bash/sh), 경로 traversal 가드, exec-bit 검사, default 이미지python:3.12-slim. 시나리오 두 가지 모두 커버: (A) 컨테이너 이미지에 이미 있는 바이너리 (/usr/bin/ffmpeg), (B) skill.create 로 작성한 스크립트/바이너리 (/skills/<id>/runner.py).enableBinaryRun: trueopt-in 필요. 실 Docker 통합 테스트 (binary-run-tool.docker.integration.test.ts,AGENT_DOCKER_INTEGRATION=1게이트) 7 케이스: python 스크립트 실행 / baked-in binary / read-only mount 검증 / 직접 exec / 네트워크 차단 / timeout / traversal 거부 - DockerSandbox gVisor 런타임 실 검증 — 코드 옵션은 있으나 실 환경에서
runsc동작·성능 미측정. binary.run 통합 테스트와 같은 패턴 (env 게이트) 으로 재사용 가능 - 보안 감사 —
worker-sandbox.security.test.ts21 케이스 (commit85b3cc3): static check 우회 시도 11,Object.prototype격리 (parent 무손상), env 차단 +shareEnv옵트인 검증, structuredClone IPC immutability, 무한 루프 timeout, 메모리 폭탄 resourceLimits, 동시code.exec충돌 없음. 갭 발견 + 수정: worker default 가 parent env 상속 →env: {}로 강화. 프롬프트 인젝션 / 토큰 탈취 시나리오는 차후 별도 감사로 분리
- 사용자 가이드 —
docs/reference/cli.md갱신:agent device,agent trace서브 추가, env 변수 표 보완 - 아키텍처 다이어그램 (실 구현 기준) —
docs/architecture.md§2 패키지 지도에 reasoning/scheduler 추가, contracts 표 16개로, §4.5 Reasoning 레이어 신설, channel adapter 트리오 정확히 반영 - API 레퍼런스 —
docs/reference/contracts.md신규 작성 (16개 인터페이스 + 확장 가이드)
코드는 가능하나 방향 합의가 선행돼야 하는 항목들.
- 배포 매니페스트 — 타깃 결정 필요: Docker compose / Kubernetes / Helm 중 어느 것(들)?
- 환경 변수 관리 — 타깃 결정 필요: Vault / AWS Secrets Manager / GCP Secret Manager / SOPS / dotenv 만 중 어느 것?
- 에이전트 위임 프로토콜 — 한 에이전트 → 다른 에이전트 서브태스크. 별도 ADR 필요 (현재 ADR-005 범위 밖)
- Message bus 경유 worker pool — 현재 직접 호출, ADR-001 분리형 배포 여지만 확보. 실제 분리 시점·트리거 미정
-
PolicyCapabilityGuardper-session 분리 — 현재__default__단일 policy. 멀티테넌트 요구 시점에 결정 - replan 트리거 #2 (LLM judge) — 비용 사유로 보류. 실데이터 수집 후 재평가
런타임·실 서비스 접근 또는 장기 테스트 인프라가 필요한 항목들.
- webapp chat delta 브라우저 실렌더 검증 — 코드 변경(unsafeHTML 패치) 머지됨, 사용자 환경에서 실 브라우저 구동 검증 대기
- Baileys QR 페어링 실 디바이스 검증 — 코드는 있으나 실 디바이스에서 QR 스캔·세션 유지 미검증
- 로드 테스트 — 동시 세션 N개, turn throughput 측정 (k6 / artillery 추정)
- Chaos 테스트 — Redis 장애 / LLM 타임아웃 / DB 잠금 시 회복
- 실 서비스 e2e — Telegram 봇 토큰 왕복 / Anthropic API 비용 측정 / OTel → Jaeger·Tempo 파이프라인 검증
┌──────────────────────────────────────────────────────────────────────────────┐
│ 직접 운영자 서피스 (Direct Operators) │
│ ┌─────────────────────────┐ ┌─────────────────────────────────────┐ │
│ │ TUI (Ink + React) ✅ │ │ Webapp (Vite + Lit 3) ✅ │ │
│ │ T1 InputBar ✅ │ │ app-root / <phase-line> / │ │
│ │ T2 App ✅ │ │ 6 views(chat/overview/channels/ │ │
│ │ T3 RpcClient ✅ │ │ instances/sessions/cron) ✅ │ │
│ │ Bearer master 토큰 │ │ ed25519 IndexedDB + HMAC 세션 ✅ │ │
│ │ │ │ chat delta 렌더 (unsafeHTML) ✅ │ │
│ │ │ │ ⚠️ 브라우저 실검증 사용자 환경 대기 │ │
│ │ │ │ /ui/* SPA 자동 배선 ✅ │ │
│ └──────────────┬──────────┘ └───────────────┬─────────────────────┘ │
│ │ Authorization: Bearer … │ Sec-WebSocket-Protocol:│
│ │ │ bearer.<sessionToken> │
│ └──────────────┬────────────────────┘ │
│ │ JSON-RPC 2.0 over WebSocket /rpc │
│ ▼ (chat.*, sessions.*, overview.status, │
│ channels.*, instances.*, cron.*, │
│ gateway.*, chat.phase notification) │
└────────────────────────────────┼─────────────────────────────────────────────┘
│
┌────────────────────────────────┼─────────────────────────────────────────────┐
│ Gateway / Control-Plane 레이어 │
│ ┌─────────────────────────────▼─────────────────────────────────────────┐ │
│ │ [G1] ApiGateway (HTTP + WS) ✅ │ │
│ │ ├─ /healthz · /messages · /ws (webchat) ✅ │ │
│ │ ├─ /rpc (WS) ── mount hook for gateway-cli ✅ │ │
│ │ ├─ /device/enroll · /challenge · /assert ✅ (ADR-010) │ │
│ │ ├─ /ui/* (SPA 정적 서빙) ✅ │ │
│ │ ├─ TokenAuth + master/device verifier ✅ │ │
│ │ └─ RateLimiter ✅ │ │
│ │ │ │
│ │ [G2] RpcServer (JSON-RPC 2.0) ✅ │ │
│ │ [G3] chat.send/history/abort 핸들러 ✅ │ │
│ │ │ │
│ │ DeviceAuthStore ✅ devices.json 0o600 (ADR-010) │ │
│ │ └─ `agent device {list,revoke}` CLI ✅ │ │
│ │ │ │
│ │ [C1] RuleRouter ✅ [C2] SessionStore (sessions.db) ✅ │ │
│ │ [C2'] ChannelRegistry ✅ PlatformChannelRegistry — 이벤트 집계 + │ │
│ │ channels.list/status RPC 백엔드 │ │
│ │ [C2''] CronRegistry ✅ SchedulerService — 3 runner (chat/bash/wf), │ │
│ │ tasks.json JSON5, cron.list/runNow RPC │ │
│ └───────────────────────────┬────────────────────────────────────────────┘ │
└──────────────────────────────┼────────────────────────────────────────────────┘
│
┌──────────────────────────────┼────────────────────────────────────────────────┐
│ Platform Handler (packages/cli runtime) ✅ │
│ [P1] startPlatform() — 모든 컴포넌트 lazy 배선 │
│ ├─ SessionStore, Router, EgoLayer, AgentRunner, Memory, Sandbox ✅ │
│ ├─ HybridReasoner 기본 주입 (tools 있으면 plan-execute 자동) ✅ │
│ ├─ DeviceAuthStore 자동 초기화 ✅ │
│ └─ webappDir 자동 탐지 ✅ (--webapp-dir → env → packages/webapp/dist) │
└──────────────────────────────┬────────────────────────────────────────────────┘
│
┌──────▼──────┐
│ EGO ON? │───── off ─────────────────┐
└──────┬──────┘ │
passive │ active │
▼ │
┌────────────────────────────────────────────────────────────────┼────────────┐
│ [E1] EgoLayer (packages/ego) ✅ (ADR-005/006) │ │
│ S1 Intake → S2 Normalize (규칙 ~16ms, ~75% passthrough 목표) │ │
│ shouldFastExit? → passthrough │ │
│ gatherContext (memory + goals + recent turns, 병렬) ✅ │ │
│ buildSystemPrompt (persona snapshot 주입) ✅ │ │
│ EgoLlmAdapter.think → Claude Haiku JSON ✅ │ │
│ validateEgoThinking → 스키마 + 의미 일관성 ✅ │ │
│ materialize → passthrough/enrich/redirect/direct_response ✅ │ │
│ CircuitBreaker ✅ · daily cost cap auto-downgrade ✅ │ │
│ SqliteAuditLog ✅ (20+ 태그) │ │
│ FileGoalStore ✅ (ADR-007) · FilePersonaManager + evolution ✅│ │
│ ❌ 멀티에이전트 위임 프로토콜 (ADR-005 범위 밖) │ │
└──────────────────────────────┬─────────────────────────────────┼────────────┘
│ invoke │
▼ ◄────────── bypass ────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ [W1] AgentRunner.processTurn (packages/agent-worker) ✅ │
│ │
│ [W2] PromptBuilder (EGO enrichment 주입) ✅ │
│ [M*] ModelAdapter: Anthropic SDK 0.88 ✅ · OpenAI ✅ │
│ responseFormat='json_object' 지원 (OpenAI native / Anthropic prefill) │
│ │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ [R*] Reasoning 레이어 (ADR-009) ✅ │ │
│ │ │ │
│ │ [R1] HybridReasoner ✅ │ │
│ │ └─ [R1a] ComplexityRouter ✅ (EGO perception 직접 입력) │ │
│ │ low → ReAct medium|high → Plan-Execute │ │
│ │ workflow_execution → 강제 plan-execute │ │
│ │ │ │
│ │ [R2] ReactExecutor ✅ (Thought/Action/Observation, 2 retry) │ │
│ │ │ │
│ │ [R3] PlanExecuteExecutor ✅ │ │
│ │ ├─ planner LLM JSON 모드 (provider 별 강제) ✅ │ │
│ │ ├─ replan 트리거 #1 (stepRetry 소진) ✅ │ │
│ │ ├─ ❌ replan 트리거 #2 (LLM judge — 비용 사유 보류) │ │
│ │ ├─ replan 트리거 #3 (egoRelevance>0.8 + goalUpdates) ✅ │ │
│ │ ├─ 병렬 실행 (parallelExecution opt-in, 레벨 기반) ✅ │ │
│ │ ├─ replan 단계 보존: id 매칭 + StepMatcher 의미 fallback ✅ │ │
│ │ └─ 한도 초과 시 ReAct 다운그레이드 ✅ │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
│ [K*] LiveToolRegistry + LocalSkillRegistry ✅ │
│ built-in: fsRead/fsWrite/webFetch/bashTool ✅ (buildDefaultTools) │
│ signed skill bundle: architecture-lookup / trace-lookup ✅ │
│ ❌ Skill 실행 sandbox 격리 (현재 host process) │
│ │
│ [S*] Sandbox + CapabilityGuard ✅ │
│ InProcessSandbox ✅ DockerSandbox ⚠️ (gVisor 미검증) │
│ PolicyCapabilityGuard ✅ (single-owner — 멀티테넌트 시 분리 필요) │
└──┬──────────────────┬─────────────────────┬────────────────────────────────┘
│ │ │
┌──▼─────────┐ ┌─────▼─────────┐ ┌────────▼────────────┐
│ [X*] Memory│ │ Observability│ │ Message Bus │
│ PalaceMem✅│ │ OTel tracer✅ │ │ InProcessBus ✅ │
│ FTS5 ✅ │ │ Metrics ✅ │ │ RedisStreamsBus ✅ │
│ cosine ✅ │ │ OTLP ✅ │ │ ⚠️ worker pool 경유 │
│ access log✅│ │ Audit DB ✅ │ │ 분리형 배포 미구현│
│ ⚠️in-mem │ │ TraceLog ✅ │ │ (현재는 직접 호출)│
│ (vec-ext │ └───────────────┘ └─────────────────────┘
│ 교체 옵션)│
└────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ 채널 어댑터 계층 (Contracts.ChannelAdapter) ✅ │
│ ┌─────────┐ ┌──────────┐ ┌─────────┐ ┌──────────────┐ ┌─────────────────┐ │
│ │ WebChat │ │ Telegram │ │ Slack │ │ Discord │ │ WhatsApp │ │
│ │ WS ✅ │ │ 롱폴링 ✅ │ │ Events✅│ │ Gateway WS✅ │ │ baileys ⚠️ │ │
│ │ │ │ │ │ Socket✅│ │ Resume ✅ │ │ QR 실 페어링 │ │
│ │ │ │ │ │ Mode │ │ Sharding ✅ │ │ 미검증 │ │
│ │ │ │ │ │ │ │ (Manager 포함)│ │ Cloud API ✅ │ │
│ └─────────┘ └──────────┘ └─────────┘ └──────────────┘ └─────────────────┘ │
│ ChannelRegistry ✅ — PlatformChannelRegistry 가 어댑터 이벤트/에러 집계 │
└─────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────┐
│ 곁가지 패키지 (보조 · 실행기) │
│ [device-node] WS 프로토콜(페어링/하트비트/푸시) ✅ │
│ [workflow] 선언적 DSL 인터프리터 ✅ (call/return/try/catch/scope 포함) │
│ [scheduler] ✅ node-cron + chat/bash/workflow runner, tasks.json │
└─────────────────────────────────────────────────────────────────────────────┘
| 블록 | 패키지 | 구현 |
|---|---|---|
| T1-T3 | packages/tui |
✅ |
| G1 / C1-C2 / DeviceAuth | packages/control-plane |
✅ |
| G2-G3 + RPC 메서드 | packages/gateway-cli |
✅ |
| P1 | packages/cli/src/runtime/platform.ts |
✅ |
| E1 전체 | packages/ego |
✅ |
| W1-W2 / M* | packages/agent-worker/{runner,prompt,model} |
✅ |
| R1-R3 | packages/agent-worker/src/reasoning |
✅ (트리거 #2 보류) |
| K* | packages/skills + packages/agent-worker/src/tools |
✅ (Skill sandbox 격리 ❌) |
| S* | packages/agent-worker/src/security + tools/*sandbox.ts |
✅ / |
| X* Memory | packages/memory |
✅ (vec-ext 교체 옵션 |
| X* Observability | packages/observability |
✅ |
| Message Bus | packages/message-bus |
✅ (worker-pool 배포 ❌) |
| Webapp | packages/webapp |
✅ (브라우저 실검증 |
| 채널 5개 | packages/channels/* |
✅ (WhatsApp baileys QR 실 페어링 |
| ChannelRegistry | packages/control-plane/src/gateway/platform-channel-registry.ts |
✅ |
| Scheduler / CronRegistry | packages/scheduler |
✅ |
| Workflow | packages/workflow |
✅ |
| Device-node | packages/device-node |
✅ |
git log 보조용 — 상세 내역은 커밋 메시지 참조.
| 커밋 | 항목 |
|---|---|
54f6fb5 |
channel-whatsapp: Meta Cloud API 클라이언트 (graph.facebook.com outbound + 자체 webhook 서버, X-Hub-Signature-256 HMAC 검증) |
bce6bd4 |
channel-slack: Socket Mode 트랜스포트 (apps.connections.open + envelope ack + 자동 재접속, transport 디스크리미네이티드 union) |
a02be22 |
channel-discord: Gateway Resume( 33E7 op6) + sharding (READY session_id 캐시, close 코드 분기, DiscordShardManager) |
51bf250 |
workflow: functions / try-catch-finally / scope (call·return·try·scope step kinds, scope frame stack, depth limit) |
f8a7b5c |
agent-worker: planner JSON mode (OpenAI native + Anthropic { prefill, 3 planner sites) |
0c99c2d |
docs: memory access logging + replan semantic matching 완료 표시 |
672fd31 |
agent-worker+cli: replan 단계 보존 의미 매칭 (StepMatcher + EmbedderStepMatcher, threshold 0.85) |
d2d8d89 |
memory: PalaceMemorySystem.search() access logging (AGENT_MEMORY_ACCESS_LOG 토글) |
765ea5c |
skills: architecture-lookup 번들 v0.7.0 갱신 |
d05a7c0 |
scheduler+cli: CronRegistry — chat/bash/workflow runner, tasks.json JSON5 |
a93b65a |
control-plane+cli: PlatformChannelRegistry → channels.list/status RPC 백엔드 |
c88aba0 |
agent-worker+core: replan 트리거 #3 (egoRelevance + goalUpdates) |
6e728ac |
cli: agent device {list,revoke} |
e656b2f |
webapp: chat delta 렌더 (.innerHTML → Lit unsafeHTML) |
009e54a |
gateway: webapp /ui/* 자동 배선 (--webapp-dir → env → dist) |