49 crates, 876 tests green (+17 kei-cortex + 10 cortex-ui TS, was 859). ## kei-cortex — local HTTP daemon (Rust) Axum-based server on :9797 exposing read-only cortex state (ledger, pet, memory) as JSON for browser UI consumption. Bearer token auth. CORS for https://keisei.app. Binds 127.0.0.1 only. ### Endpoints - GET /healthz — unauthenticated liveness - GET /api/v1/cortex/summary — total_dnas + active_pets + recent_sessions - GET /api/v1/cortex/pet/:user_id — pet manifest - POST /api/v1/cortex/pet/:user_id/interaction — log chat - GET /api/v1/cortex/ledger/recent?limit=N — recent agent runs - GET /api/v1/cortex/memory/search?user_id=X&pet_name=Y&q=... — recall ### Security - Token at ~/.keisei/cortex.token (32-byte hex, chmod 600 atomic via OpenOptions mode 0o600) - tower-http CorsLayer with configured allow_origin - tokio::task::spawn_blocking for rusqlite reads - All non-healthz routes protected by Bearer middleware ### Constructor Pattern 14 files, largest 137 LOC. All functions ≤30 LOC. Split: auth / config / error / state / routes + 5 handlers (health/summary/pet/ledger/memory). 17 tests: token roundtrip + chmod 600 (cfg unix) + 401/403/healthz + summary shape + pet 404 + pet parse + interaction 201 + CORS preflight + ledger limit + empty ledger. ## cortex-ui — Svelte 5 + TypeScript + Vite Static web app, build to dist/ (~500 KB incl sourcemaps, 64 KB minified JS+CSS), deployable to https://keisei.app/cortex/. Connects to local kei-cortex daemon via fetch. ### Features - Setup wizard (first run): daemon URL + token paste, saved to localStorage (origin-scoped) - Dashboard: summary cards + nav - PetEditor: view pet.toml fields (identity/voice/edge/forbidden) - LedgerStream: recent agent runs, auto-refresh 5s - MemorySearch: query form + results list - Hash-based routing (no server needed) - Dark-mode via prefers-color-scheme - URL-param override: ?daemon=URL&token=T for one-click setup ### Stack choice Svelte 5 for minimal runtime (~2 KB). TypeScript strict inherits _ts_packages/tsconfig.base.json. Vite for dev + build. vitest for unit tests (10 passing: api header/error, config precedence/overrides). ## User flow Non-dev: 1. Install keisei, run `kei-cortex serve` 2. Open https://keisei.app/cortex 3. Paste daemon URL + token from ~/.keisei/cortex.token 4. View dashboard, edit pet, search memory — all local data, zero cloud Power user (self-host): 1. `cd _ts_packages/packages/cortex-ui && npm run build` 2. Serve dist/ from localhost OR deploy anywhere 3. Point to own daemon URL Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
32 lines
861 B
TOML
32 lines
861 B
TOML
[package]
|
|
name = "kei-cortex"
|
|
version = "0.1.0"
|
|
edition = "2021"
|
|
rust-version = "1.75"
|
|
description = "Local HTTP daemon exposing cortex state for UI consumption"
|
|
|
|
[[bin]]
|
|
name = "kei-cortex"
|
|
path = "src/main.rs"
|
|
|
|
[lib]
|
|
name = "kei_cortex"
|
|
path = "src/lib.rs"
|
|
|
|
[dependencies]
|
|
axum = "0.7"
|
|
tokio = { version = "1", features = ["rt-multi-thread", "macros", "signal", "net"] }
|
|
tower-http = { version = "0.5", features = ["cors", "trace"] }
|
|
serde = { version = "1", features = ["derive"] }
|
|
serde_json = "1"
|
|
clap = { version = "4", features = ["derive"] }
|
|
thiserror = "1"
|
|
rusqlite = { version = "0.31", features = ["bundled"] }
|
|
anyhow = "1"
|
|
rand = "0.8"
|
|
kei-pet = { path = "../kei-pet" }
|
|
kei-shared = { path = "../kei-shared" }
|
|
|
|
[dev-dependencies]
|
|
tempfile = "3"
|
|
reqwest = { version = "0.12", features = ["json", "blocking", "rustls-tls"], default-features = false }
|