影
Status
Section 01 / Phase Overview 001
Seven phases. Three done.
Each phase unlocks the next. Doc-first → TDD. No phase skipping.
-
✓0 DocumentationManifesto, vision, architecture, glossary, 52 ADRs, 23 component specs. Doc-first phase declared complete.
-
✓1 Core RuntimeDaemon serves HTTP + WebSocket. SQLite storage, session-manager state machines, built-in tool registry, and primary-agent dispatch are operational. The runtime is alive.
-
✓2 UI ShellA mobile-first React SPA with typed API client, TanStack Query, Zustand, xterm.js PTY, and devctl.sh orchestration. The shell is in production shape.
-
✓3 DSL & ExecutionParser + validator. ADR-0015 federated config. ADR-0022 recursive agents. Task runner, agent harness with Mastra adapter, six LLM API shapes, compaction engine, checkpoint bridge.
-
~4 SandboxCageCompiler, SandboxRunner, SandboxHandle, CgroupsWrapper, NetworkGatekeeper built. Two modes working: fully isolated and fully open. Remaining: full network isolation.
-
~5 Plugin SystemManifest, capabilities, protocol, state machine. PluginSupervisor wired to daemon. Lifecycle hooks, tool registry, knob runtime. memory-markdown reference plugin shipped.
-
~6 Integration & HardeningOAuth sidecar auth path and deployment modes are implemented. Remaining: full network isolation, project portability, storage brokering, install CLI, and E2E coverage.
Section 02 / Package Status 002
27 packages. Built from specs.
Data collected live from the monorepo. Descriptions from package.json. Test/lint/typecheck status from bun test + biome + tsc.
@kaged/agent-tooling
✓ 175 pass
Declarative tool definitions, registry, and permission enforcement for 31 built-in tools across file, search, LSP, DAP, and kaged namespaces
@kaged/daemon
✓ 171 pass
Long-lived HTTP+WebSocket server that routes operator sessions, dispatches primary agents through the harness, and orchestrates plugins, providers, and project lifecycles
@kaged/dsl
✓ 516 pass
YAML + Zod project DSL parser and validator with federated config, URI-prefix enforcement, local overlays, and recursive project-reference resolution
@kaged/fonts
✓ 26 pass
Font family metadata and CSS generation for project typefaces — Orbitron, Rajdhani, JetBrains Mono Nerd Font, and Noto Serif JP
@kaged/harness
✓ 399 pass
DSL compiler, processor pipeline, provider router, Mastra adapter, compaction engine, checkpoint bridge, and runPrimary runtime entry point
@kaged/llm
✓ 110 pass
Pure-fetch LLM provider interface supporting Anthropic, OpenAI, Google, and Antigravity API shapes with SSE streaming, cost calculation, and model discovery
@kaged/local-config
✓ 124 pass
TOML-backed operator-local configuration with Zod validation, file I/O, provider management, tool overrides, and Langfuse tracing settings
@kaged/models
— no tests —
Self-hosted mirror of the models.dev provider catalog for kaged. Publishes models.kaged.dev.
@kaged/natives
— no tests —
Rust N-API bindings providing high-performance grep, glob, AST search, fd, workspace profiling, and fs-cache operations via native platform binaries
@kaged/plugin-host
✓ 322 pass
JSON-RPC stdio transport, plugin process lifecycle with health checks and rate limiting, multi-plugin supervisor with role enforcement and tool registry
@kaged/plugin-memory-hindsight
✓ 34 pass
Reference ceiling project plugin for agent memory — Hindsight-backed vector-graph-temporal memory with reflect synthesis, auto-retain, and compactor-grade compaction
@kaged/plugin-memory-markdown
✓ 186 pass
Reference project plugin for agent memory — markdown-based entry storage with keyword scoring, recency boost, tag filtering, and auto-facts aggregation
@kaged/plugin-ntfy
✓ 33 pass
Reference tier-3 notification channel for kaged: posts to an ntfy.sh instance (self-hostable)
@kaged/plugin-pushover
✓ 32 pass
Hosted tier-3 notification channel for kaged: posts session notifications to the Pushover service
@kaged/plugin-types
✓ 7 pass
Pure interface package — SystemPlugin lifecycle hooks, SystemPluginContext, DaemonHooks payload types, PluginLogger, and the notification channel contract consumed by daemon and system plugins
@kaged/plugin-webhook-notify
✓ 18 pass
System plugin that POSTs the daemon launch URL to a webhook on auth.launchUrlReady with HTTPS enforcement and exponential backoff retry
@kaged/sandbox
✓ 13 pass
CageCompiler, SandboxRunner, and SandboxHandle for subprocess isolation via bubblewrap with cgroups, network gatekeeper, and seccomp plans
@kaged/session-manager
✓ 115 pass
Pure state machines for session and run lifecycles with limits, error types, and side-effect declarations consumed by the daemon's interpret-effects layer
@kaged/site
✓ 68 pass
Static site builder for kaged.dev — Handlebars templates, schema-backed reference docs, and live package status from test/typecheck collection
@kaged/skills
— no tests —
Public registry of kaged skills. Publishes skills.kaged.dev.
@kaged/sso
✓ 19 pass
Stateless kaged SSO relay: performs the OAuth dance with upstream providers and mints short-lived ES256 identity tokens. Self-hostable, no database.
@kaged/sso-fixtures
✓ 6 pass
Golden token fixtures and test keypair for the kaged SSO §3.4 token contract. Versioned in lockstep with @kaged/sso.
@kaged/storage
✓ 312 pass
SQLite adapter via bun:sqlite with schema migrations, CRUD for sessions/messages/providers/compactions/task instances, and transcript persistence
@kaged/task-runner
✓ 65 pass
Task state machine with concurrency limits, backend resolution, and DSL tasks block schema for PTY/tmux-backed project terminal workflows
@kaged/ui
✓ 727 pass
React 19 SPA — mobile-first web dashboard with TanStack Router/Query, Zustand state, guest routes, project config editing, and terminal viewer
@kaged/utils
✓ 340 pass
Shared foundation utilities — fs guards, type guards, formatting, async/stream helpers, Snowflake IDs, fetch-retry, rotating logger, XDG dirs, and more
@kaged/wire
✓ 121 pass
Shared wire contract — Zod schemas for every HTTP request/response body, error envelope, and WebSocket message
Section 03 / Infrastructure 003
The tooling layer.
What's working, what's warned, what's missing.
| Item | Status |
|---|---|
| Bun workspace monorepo | ✓ WORKING |
| devctl.sh (tmux orchestrator) | ✓ WORKING |
| Vite + React 19 SPA build | ✓ CONFIGURED |
| Vite proxy /api → daemon | ✓ CONFIGURED |
| Per-package typecheck | ✓ ALL 19 CLEAN |
| Test suite | ✓ 3,936 PASS · 0 FAIL |
| Linting (Biome) | ⚠ 0 ERRORS · 17 WARNINGS |
| Site deployment | ✓ CLOUDFLARE PAGES |
| Docs deployment | ✓ /DOCS/ ON MAIN SITE |
| E2E tests | ✓ PLAYWRIGHT |
| CI/CD | ✓ GITHUB ACTIONS |
Section 04 / What's Next 004
The road from here.
No roadmap PDF. No timeline. Just the dependency order — each item unblocks the ones below it.
COMPLETED
Fix typecheck infrastructure
Wire storage → daemon
Implement API handlers (50+ routes)
Wire session-manager → daemon
Create task-runner package
Loopback auth (per-user mode)
Agent harness (@kaged/harness)
LLM provider interface (5 API shapes)
End-to-end primary-agent dispatch
Built-in tool handlers (31 tools)
Plugin system (host + system plugins)
Compaction pipeline (ADR-0024)
Plugin lifecycle hooks + tool registry
Reference project plugin (memory-markdown)
Sandbox runtime isolation (bwrap integration)
OAuth sidecar auth path
Plugin cage policy compilation
Plugin-scoped storage brokering
E2E test coverage
CI/CD pipeline
UP NEXT
Cross-daemon mesh (v2)