Files
Cortex-Inara/documentation/ROADMAP.md
Scott Idem 3672fa1506 docs: comprehensive doc audit — sync all docs to current state
- MASTER.md: tool count 40→47, add proactive notifications + spawn_agent rows, date bump
- ROADMAP.md: mark local orchestrator/web push/proactive notifs/spawn_agent/web_read/session_read as done, date bump
- ARCH__CHANNELS.md: rewrite notification channel config section — all 4 channels, all triggers, on-demand endpoints
- ARCH__SYSTEM.md: update tools/ module list to include files, agents
- README.md: update LLM backends in architecture diagram, add browser push to channels table
- CLAUDE.md: add doc update checklist to Documentation Philosophy section

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-09 13:13:45 -04:00

3.7 KiB

Cortex — Roadmap

Phases and priorities. For active tasks see TODO__Agents.md. Last updated: 2026-05-09


Phase 0 — Foundation

  • Syncthing fleet sync (agents_sync/) operational
  • MCP tools (ae_*) available in all Claude Code sessions
  • Fleet agents running independently on each machine

Phase 1 — Dispatcher Core

  • FastAPI service with streaming SSE responses
  • Claude CLI and Gemini CLI subprocess backends
  • Session context management (rolling window, file persistence)
  • Nextcloud Talk bot (HMAC-signed webhook)
  • Memory distiller (APScheduler — short/mid/long cycles)
  • Local web UI (single-page, mobile-responsive)
  • Auth status monitoring (/auth/status, UI banner)
  • Session logging and file browser

Phase 2 — Identity & Multi-User

  • Inara persona formalized (IDENTITY.md, SOUL.md, PROTOCOLS.md, context tiers)
  • Two-level user/persona layout (home/{user}/persona/{name}/)
  • Session auth: bcrypt passwords, JWT cookies, invite tokens, Google OAuth
  • Multi-user live: Scott, Holly, Brian
  • Per-user channel config (channels.json)
  • Per-user Gemini API key (settings UI)
  • Help & Reference system (shared base + per-persona additions)
  • Lucide icons, persona picker page, session persistence across navigation

Phase 3 — Intelligence Layer (In Progress)

  • Gemini API orchestrator (tool loop → Claude responder)
  • Tool suite: web search, AE Journal read/write, tasks, scratch, reminders, cron, system, email_send (+ per-user allowlist), nc_talk_send
  • Agent mode in UI (async job, poll for result); role-based tool access + confirmation gate
  • Local LLM backend (Open WebUI/Ollama, per-user multi-model config); inline model edit in registry UI
  • Proactive cron (message / brief job types → NC Talk)
  • Session search (full-text across past session logs)
  • Distill notifications (NC Talk after mid/long runs)
  • Local backend for distillation (DISTILL_BACKEND_MID/LONG in .env)
  • Local orchestrator — OpenAI-compatible ReAct loop; fires when orchestrator role → local model
  • Web push notifications — VAPID; web_push tool; PWA-installable; subscribe via ☰ menu
  • Proactive notifications — daily reminder check (09:00); notify() routes to any configured channel; dedicated settings page
  • Sub-agent spawning — spawn_agent tool; per-host concurrency limit; Gemini API + local OpenAI backends
  • Web content extraction — web_read via trafilatura; strips ads/nav/boilerplate; 128K cap
  • Session log reader — session_read(date) tool; complements session_search
  • Knowledge import — markdown → AE Journals (import script)
  • Dev agent pipeline — specialist agents + supervisor + approval gate
  • Gitea webhook integration + Actions CI

Phase 4 — Channel Expansion

  • Web UI
  • Nextcloud Talk
  • Google Chat
  • WhatsApp (Business API or bridge — investigating)
  • Webhook triggers from Aether platform events

Phase 5 — Routing Intelligence & Scale

  • Intelligent model routing (by task type, privacy, context length)
  • Agent-to-agent task delegation across fleet

Phase 6 — Infrastructure

  • Server DMZ finalized
  • WireGuard for all Cortex-accessing devices
  • Camera/IoT VLAN segmentation

Deferred / Watching

  • Speculative decoding — llama.cpp supports it (E4B + E2B draft ≈ 2x speed); Ollama does not yet
  • RAG via Open WebUI — feed Nextcloud docs into local knowledge collections; possible complement to AE Journals search
  • Multi-host local models — per-user config already supports multiple hosts; routing logic TBD
  • WhatsApp — requires Business API account or a bridge; not started