Gormes

Architecture Plan

Gormes — Executive Roadmap

Single source of truth: progress.json — machine-readable, auto-updated on build

Linked surfaces:

Progress Summary

PhaseStatusShipped
Phase 1 — The Dashboard✅ Complete5 items
Phase 2 — The Gateway🔨 In Progress4 of 8 subphases
Phase 3 — The Black Box🔨 Substantially Complete5 of 12 subphases
Phase 4 — The Brain Transplant⏳ Planned0 of 8 subphases
Phase 5 — The Final Purge⏳ Planned0 of 17 subphases
Phase 6 — The Learning Loop⏳ Planned0 of 6 subphases

Overall: 9/52 subphases shipped (17%) · 2 in progress · 41 planned

Detailed Checklist

Phase 1 — The Dashboard ✅

Tactical bridge: Go TUI over Python's api_server HTTP+SSE boundary

SubphaseStatusDeliverable
1.A✅Core TUI
  • Bubble Tea shell
  • 16ms coalescing mailbox
  • SSE reconnect
1.B✅Wire Doctor
  • Offline tool validation

Phase 2 — The Gateway 🔨

Go-native tools + Telegram + session resume + wider adapters

SubphaseStatusDeliverable
2.A✅Tool Registry
  • In-process Go tool registry
  • Streamed tool_calls accumulation
  • Kernel tool loop
  • Doctor verification
2.B.1✅Telegram Scout
  • Telegram adapter
  • Long-poll ingress
  • Edit coalescing
2.B.2⏳Wider Gateway Surface
  • Discord
  • Slack
  • WhatsApp
  • Signal
  • Email
  • SMS
2.C✅Thin Mapping Persistence
  • bbolt session resume
  • (platform, chat_id) -> session_id
2.D✅Cron / Scheduled Automations
  • robfig/cron/v3 scheduler
  • bbolt cron_jobs bucket
  • SQLite cron_runs audit table (schema v3e)
  • CRON.md mirror (3.D.5 atomic-write pattern)
  • Heartbeat [SYSTEM:] prefix (verbatim upstream port)
  • Exact-match [SILENT] suppression protocol
  • Kernel PlatformEvent.SessionID + CronJobID per-event override
  • Generic DeliverySink interface (kernel-agnostic)
  • Ollama E2E heartbeat crucible proven live
2.E⏳Subagent System (P0)
  • Execution isolation
  • Resource boundaries
  • Context isolation
  • Cancellation scopes
2.F⏳Hooks + Lifecycle
  • Per-event extension points
  • Managed restarts
2.G⏳Skills System (P0)
  • Learning loop foundation
  • Pattern extraction

Phase 3 — The Black Box (Memory) 🔨

SQLite + FTS5 + ontological graph + semantic fusion in Go

SubphaseStatusDeliverable
3.A✅SQLite + FTS5 Lattice
  • SqliteStore
  • FTS5 triggers
  • Schema migrations v3a->v3d
3.B✅Ontological Graph + LLM Extractor
  • Extractor
  • Entity/relationship upsert
  • Dead-letter queue
3.C✅Neural Recall + Context Injection
  • RecallProvider
  • 2-layer seed selection
  • CTE traversal
  • <memory-context> fence
3.D✅Semantic Fusion + Local Embeddings
  • Ollama embeddings
  • Vector cache
  • Cosine similarity recall
  • Hybrid fusion
3.D.5✅Memory Mirror (USER.md sync)
  • Async background export
  • SQLite as source of truth
3.E.1⏳Session Index Mirror
  • bbolt sessions.yaml export
3.E.2⏳Tool Execution Audit Log
  • JSONL audit trail
3.E.3⏳Transcript Export Command
  • Markdown export
3.E.4⏳Extraction State Visibility
  • gormes memory status
3.E.5⏳Insights Audit Log
  • Usage JSONL
3.E.6⏳Memory Decay
  • Weight attenuation
  • last_seen tracking
3.E.7⏳Cross-Chat Synthesis
  • Graph unification across chats

Phase 4 — The Brain Transplant ⏳

Native Go agent orchestrator + prompt builder

Build priority: Skills (2.G) → Subagents (2.E) → Gateway → Native Agent Loop

SubphaseStatusDeliverable
4.A⏳Provider Adapters
  • Anthropic
  • Bedrock
  • Gemini
  • OpenRouter
  • Google Code Assist
  • Codex
4.B⏳Context Engine + Compression
  • Long session management
  • Context compression
4.C⏳Native Prompt Builder
  • System + memory + tools + history assembly
4.D⏳Smart Model Routing
  • Per-turn model selection
4.E⏳Trajectory + Insights
  • Self-monitoring telemetry
4.F⏳Title Generation
  • Auto-naming sessions
4.G⏳Credentials + OAuth
  • Token vault
  • Multi-account auth
4.H⏳Rate / Retry / Caching
  • Provider-side resilience

Phase 5 — The Final Purge ⏳

Python tool scripts ported to Go or WASM

SubphaseStatusDeliverable
5.A⏳Tool Surface Port
  • 61-tool registry port
5.B⏳Sandboxing Backends
  • Docker
  • Modal
  • Daytona
  • Singularity
5.C⏳Browser Automation
  • Chromedp
  • Rod
5.D⏳Vision + Image Generation
  • Multimodal in/out
5.E⏳TTS / Voice / Transcription
  • Voice mode port
5.F⏳Skills System (Remaining)
  • Skills hub
  • Skill registries
5.G⏳MCP Integration
  • MCP client
  • OAuth flows
5.H⏳ACP Integration
  • ACP server side
5.I⏳Plugins Architecture
  • Plugin SDK
  • Third-party extensions
5.J⏳Approval / Security Guards
  • Dangerous action gating
5.K⏳Code Execution
  • Sandboxed exec
5.L⏳File Ops + Patches
  • Atomic checkpoints
5.M⏳Mixture of Agents
  • Multi-model coordination
5.N⏳Misc Operator Tools
  • Todo
  • Clarify
  • Session search
  • Debug helpers
5.O⏳Hermes CLI Parity
  • 49-file CLI tree port
5.P⏳Docker / Packaging
  • OCI image
  • Homebrew
5.Q⏳TUI Gateway Streaming
  • SSE streaming to Bubble Tea TUI

Phase 6 — The Learning Loop (Soul) ⏳

Native skill extraction. Compounding intelligence. The feature Hermes doesn't have.

SubphaseStatusDeliverable
6.A⏳Complexity Detector
  • Heuristic or LLM-scored signal
6.B⏳Skill Extractor
  • LLM-assisted pattern distillation
6.C⏳Skill Storage Format
  • Portable SKILL.md format
6.D⏳Skill Retrieval + Matching
  • Hybrid lexical + semantic lookup
6.E⏳Feedback Loop
  • Skill effectiveness scoring
6.F⏳Skill Surface
  • TUI + Telegram browsing

Overall: 10/52 shipped · 2 in progress

Last updated: 2026-04-20

Data Format

The progress.json file is the machine-readable source of truth. Updated automatically on make build.

In this section