Skip to content

Architecture Plan

Single source of truth: progress.json — machine-readable, validated + regenerated on build.

Public site: https://gormes.ai

Linked surfaces:

Execution control plane: repo-local Gormes skills consume this progress.json and the generated docs/content/building-gormes/ pages to select and execute eligible work. The old loop command binaries are gone; the roadmap is still the machine-readable queue for developing the full gormes-agent.

Completion doctrine: Gormes Completion Plan defines the non-negotiable finish line: Gormes is complete only when it is Hermes in Go, with Goncho as the Honcho-compatible Go port inside Gormes.

Operating model: Completion Lane Roadmap maps phases to finish lanes and gates; Agent Operating Model tells agents how to run bounded parity, planner, builder, TDD, and interface-design passes.

Feature map: Hermes And Honcho Feature Map maps upstream Hermes and Honcho feature families to Go packages, implementation strategy, proof gates, and progress.json anchors.

Contract pairings: Hermes/Gormes Contract Pairings defines the shared vocabulary for pairing upstream Hermes symbols with their Go-native Gormes adapters before rows are renamed or split.

Messaging setup contract: Messaging Platform Setup Fidelity records the Hermes-fidelity rules for gormes setup gateway, channel config, Telegram-first setup, env compatibility, and migration boundaries.

CLI parity matrix: Hermes Command Surface Parity Matrix records the operator-visible Hermes command tree, current Gormes state, and the progress.json rows that own remaining command/auth gaps.

Runtime plan: Hermes/Honcho To Gormes Go Runtime Plan reconciles the feature map, source-class ledger, swarm audit, nested coverage matrix, and progress rows into one implementation-ready subsystem plan.

Completeness audit: Upstream Coverage Ledger lists the upstream source classes that must be represented in the feature map, so a planner pass can tell whether Hermes/Honcho mapping is complete or has drifted.

Feature-level swarm audit: Swarm Feature Parity Audit records the raw sub-agent parity findings that feed the runtime plan’s classification and row-backed implementation queue.


Overall: 108/111 subphases shipped · 3 in progress · 0 planned

PhaseStatusShipped
Phase 1 — The Dashboard6/6 subphases
Phase 2 — The Gateway22/22 subphases
Phase 3 — The Black Box (Memory)16/16 subphases
Phase 4 — The Brain Transplant13/13 subphases
Phase 5 — The Final Purge23/23 subphases
Phase 6 — The Learning Loop (Soul)12/12 subphases
Phase 7 — Paused Channel Backlog5/5 subphases
Phase 8 — Reputation & Publication🔨4/7 subphases
Phase 9 — Design & Security Hardening7/7 subphases

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

  • tui Bubble Tea shell
  • tui 16ms coalescing mailbox
  • gateway SSE reconnect
  • doctor Offline tool validation
  • fleet Orchestrator failure-row stabilization for 4-8 workers
  • fleet Soft-success-nonzero bats coverage
  • planner Planner wrapper/test consistency closeout
  • fleet Autoloop row health and quarantine contract
  • planner Planner self-healing verdict loop
  • planner Planner divergence and provenance awareness
  • fleet Watchdog checkpoint coalescing
  • fleet PR-intake idle backoff
  • fleet Watchdog dead-process vs slow-progress separation
  • progress Builder-loop self-improvement vs user-feature ratio metric
  • skills Skill control-plane docs and Hugo navigation closeout
  • skills Skill-manager selection matrix hardening
  • skills Skill-pack coverage audit for Hermes-in-Go completion
  • skills Canonical development-skills directory and loader symlinks
  • planner External review feedback ingestion for planner rows

1.E — Gormes-owned: Unified Bubble Tea admin TUI ✅

Section titled “1.E — Gormes-owned: Unified Bubble Tea admin TUI ✅”
  • tui Shared Bubble Tea wizard step chassis under internal/tui/wizard
  • tui Unified admin TUI shell with tab navigation
  • tui Admin TUI: Setup health screen with missing-config callouts
  • tui Admin TUI: Chat tab with keybinding to jump in from any screen
  • tui Admin TUI: Agents screen wired to the 2.H dynamic registry
  • tui Admin TUI: Commands catalog over the root CLI tree
  • tui Admin TUI: Safe command execution from the Commands tab
  • tui Admin TUI: Searchable Commands palette
  • install Gormes Termux Runtime Compatibility
  • doctor Termux runtime doctor check
  • install Termux install and release smoke guide
  • install Termux storage and path safety audit
  • gateway Termux gateway foreground tmux lifecycle
  • install Termux notification bridge via termux-api
  • install Termux real-device smoke evidence
  • install Termux remote execution guidance

Go-native operator wiring harness: tools, Telegram, shared gateway chassis, shipped cron, and the first OS-AI spine slices before focused channel closeout

  • gateway In-process Go tool registry
  • gateway Streamed tool_calls accumulation
  • gateway Kernel tool loop
  • doctor Doctor verification
  • gateway Coding-agent delegation tooling (codex/claude-code/opencode)
  • gateway Coding-agent delegation: Phase 1 scaffold (internal/codingagents)
  • channels Telegram adapter
  • channels Long-poll ingress
  • channels Edit coalescing
  • channels Telegram important notification default
  • channels Reusable gateway chassis
  • channels Telegram on shared chassis
  • channels gormes gateway multi-channel entrypoint
  • channels Discord
  • channels Slack Socket Mode adapter
  • channels Thread routing + coalesced reply flow
  • channels Slack CommandRegistry parser wiring
  • channels Slack gateway.Channel adapter shim
  • channels Slack config + cmd/gormes gateway registration
  • channels Slack env-token enabled-state preservation
  • channels Slack app manifest App Home and private-channel scopes
  • channels Bridge-vs-native runtime decision
  • channels WhatsApp identity resolution + self-chat guard
  • channels Inbound normalization + command passthrough
  • channels Pairing, reconnect, and send contract
  • channels WhatsApp outbound pairing gate + raw peer mapping
  • channels WhatsApp reconnect backoff + send retry policy

2.B.5 — Session Context + Delivery Routing ✅

Section titled “2.B.5 — Session Context + Delivery Routing ✅”
  • gateway Gateway session store + SessionSource parity
  • gateway Gateway manual reset session-boundary hooks
  • gateway Gateway session reset notification parity
  • gateway Gateway slash-confirm session-boundary cleanup
  • gateway SessionContext prompt injection
  • gateway Hermes live-turn prompt assembly parity (channel-neutral)
  • gateway Live-turn SOUL.md and project context wiring (channel-neutral)
  • gateway Live-turn USER.md and MEMORY.md durable user context block (channel-neutral)
  • gateway Live-turn timestamp + model/provider/session metadata block + self-help guidance (channel-neutral)
  • builder Hermes prompt-builder guidance constants port (data-only, byte-equivalent)
  • gateway Hermes MEMORY_GUIDANCE stale-artifact exclusion refresh
  • gateway Live-turn metadata production wiring (cmd/gormes -> Manager seams)
  • channels BlueBubbles iMessage session-context prompt guidance
  • channels Telegram production live-turn provider payload golden
  • channels Telegram /status Hermes-format closeout
  • gateway Gateway /title manual session title command
  • gateway Session metadata manual-title protection flag
  • gateway Gateway auto-title generation wiring
  • channels Telegram reply_to_mode and reply-context parity
  • channels Telegram sendChatAction typing API
  • gateway Gateway typing-action wiring during stream
  • gateway Placeholder edit-failure fallback hardening
  • gateway Gateway stream/tool trace formatting fixture matrix
  • channels Telegram dynamic BotCommand menu wiring
  • profiles Active Hermes/Sidon profile context root resolver for live turns
  • gateway Durable context ordering and frozen snapshot decision fixture
  • gateway Live-turn model/tool guidance wiring
  • gateway Gateway active-turn policy manifest closeout
  • gateway Gateway conversational session metadata refresh
  • gateway Gateway session token accounting parity
  • gateway Gateway startup allowlist + weak credential guard
  • stt Telegram voice/audio inbound attachment markers
  • gateway DeliveryRouter + —deliver target parsing
  • gateway Gateway stream consumer for agent-event fan-out
  • gateway Non-editable gateway progress/commentary send fallback
  • channels WhatsApp identifier safety predicate
  • channels WhatsApp unsafe sender/chat inbound evidence
  • channels WhatsApp unsafe alias endpoint inbound evidence
  • gateway Gateway fresh-final eligibility helper
  • gateway Gateway fresh-final send/delete fallback
  • channels Telegram fresh-final delete and config exposure
  • channels Telegram group bot-command mention gate helper
  • channels Telegram require-mention config fields
  • channels Telegram group require-mention bot binding
  • channels Slack rich-text quotes/lists + link-unfurl ingress
  • channels Slack thread-parent context + team-scoped cache key
  • gateway Gateway message deduplicator bounded helper
  • gateway Gateway inbound dedup key helper
  • gateway Gateway inbound dedup manager binding
  • channels Email outbound Date header contract
  • channels Telegram MarkdownV2 parse-mode rendering closeout
  • channels Telegram topic mode off/help/auth/debounce closeout
  • channels Telegram document/photo cache + batch attachment parity
  • channels Discord authenticated attachment download safety
  • channels Slack Block Kit approval buttons + action callback
  • channels Discord thread participation persistence
  • gateway Cross-platform image/document MEDIA delivery routing
  • channels Telegram inline approval buttons + callback auth
  • channels Telegram polling conflict + webhook secret startup guard
  • channels Slack mention/free-response gating + strict thread-memory guard
  • channels Discord interaction authorization + mention safety guards
  • channels Gateway processing lifecycle reactions for Telegram and Discord
  • channels Telegram text batching + caption merge parity
  • gateway Cross-platform multi-image native batching
  • channels Discord message admission + reply-mode policy
  • channels Webhook dynamic route reload + signed rate-limit order
  • channels Slack/Discord channel-scoped skills, prompts, and reload resync
  • channels Telegram fallback transport + polling reconnect recovery
  • channels Telegram sticker vision adapter binding
  • channels Discord native slash/thread command registration parity
  • channels Telegram entity-only mention boundary closeout
  • channels Telegram thread-aware outbound text + typing seam
  • channels Telegram forum thread fallback + send retry safety
  • channels Telegram DM topic reply-fallback routing
  • channels Telegram semantic MarkdownV2 formatter + table rewrite
  • channels Telegram Markdown table row-label bullet suppression
  • channels Telegram streaming edit Markdown safety
  • channels Telegram guest mention allowlist bypass
  • gateway Gateway platform reconnect isolation + channel health limits
  • gateway Gateway per-platform circuit breaker + /platform pause/resume/list command
  • gateway Gateway /model interactive provider/model picker
  • gateway Gateway memory monitor pressure policy
  • channels WeCom + WeiXin shared-chassis bot seam
  • channels WeCom + WeiXin transport/bootstrap layer
  • channels Discord forum channel ingress + thread lifecycle
  • channels Discord SessionSource guild/parent/message evidence
  • channels Discord forum media + polish parity

2.B.12 — Channel-Neutral Native Runtime Adapter ✅

Section titled “2.B.12 — Channel-Neutral Native Runtime Adapter ✅”
  • gateway Channel-neutral native runtime turn adapter
  • gateway Hermes gateway platform registry manifest
  • channels MSGraph webhook platform manifest drift closeout
  • gateway Bundled platform plugin manifest drift guard
  • navivox Navivox stdio protocol control-plane tracer
  • navivox Navivox QR pairing descriptor CLI
  • navivox Navivox Flutter voice morph surface
  • gateway Multimodal photo attachment passthrough
  • gateway Hermes-style default prompt and image-path hints for inbound photos
  • channels Hermes gateway platform strict-fidelity source-pair expansion
  • gateway bbolt session resume
  • gateway (platform, chat_id) -> session_id
  • fleet robfig/cron scheduler + bbolt job store
  • fleet SQLite cron_runs audit + CRON.md mirror
  • fleet Heartbeat [SYSTEM:] + [SILENT] delivery contract
  • planner Architecture planner tasks manager script
  • gateway Cron no-agent script-only short-circuit
  • fleet Durable operator run report for unattended jobs
  • fleet Scheduled briefing job emits operator run report

2.E.0 — OS-AI Spine: Deterministic Subagent Runtime ✅

Section titled “2.E.0 — OS-AI Spine: Deterministic Subagent Runtime ✅”
  • gateway Deterministic subagent runtime
  • gateway Max-depth guard + bounded batch execution
  • gateway Timeout + cancellation scopes
  • gateway Typed result envelope
  • gateway Append-only run log

2.E.1 — OS-AI Spine: Delegation Policy + Child Execution ✅

Section titled “2.E.1 — OS-AI Spine: Delegation Policy + Child Execution ✅”
  • gateway Runner-enforced tool allowlists + blocked-tool policy
  • gateway Tool-call audit in typed child results
  • gateway Real child Hermes stream loop
  • fleet Durable job routing policy
  • gateway Durable subagent/job ledger

2.E.2 — OS-AI Spine: Concurrent-Tool Cancellation ✅

Section titled “2.E.2 — OS-AI Spine: Concurrent-Tool Cancellation ✅”
  • gateway Interrupt propagation to concurrent-tool workers

2.E.3 — OS-AI Spine: Durable Job Resilience ✅

Section titled “2.E.3 — OS-AI Spine: Durable Job Resilience ✅”
  • fleet Durable job backpressure + timeout audit
  • fleet Durable worker supervisor status seam
  • fleet Durable pause/resume intent contract
  • fleet Durable replay and inbox message contract
  • fleet Durable worker execution loop
  • fleet Durable worker abort-slot recovery safety net
  • fleet Durable worker RSS watchdog policy helper
  • fleet Durable worker RSS drain integration
  • doctor Durable worker RSS doctor/status evidence

2.F.1 — Slash Command Registry + Gateway Dispatch ✅

Section titled “2.F.1 — Slash Command Registry + Gateway Dispatch ✅”
  • gateway Canonical CommandDef registry
  • gateway Gateway slash dispatch + per-platform exposure
  • gateway Gateway slash registry parity sweep (recognized-name expansion)
  • gateway Gateway /commands paginated command and skill catalog
  • gateway Gateway per-event hook registry
  • gateway Hook manifest discovery + handler loading
  • gateway Built-in BOOT.md startup hook
  • gateway Graceful restart drain + managed shutdown
  • gateway Adapter startup failure cleanup contract
  • gateway Gateway channel disconnect timeout on failed startup
  • gateway Gateway shutdown capped adapter disconnect
  • gateway Active-turn follow-up queue + late-arrival drain policy
  • gateway Drain-timeout resume_pending recovery
  • gateway Pairing read-model schema + atomic persistence
  • gateway Pairing approval + rate-limit semantics
  • gateway Unauthorized DM pairing response contract
  • gateway gormes gateway status read-only command
  • gateway Runtime status JSON + PID/process validation
  • gateway Token-scoped gateway locks
  • gateway Gateway /restart command + takeover markers
  • gateway Gateway restart notification opt-out
  • gateway Session expiry finalized-flag migration
  • gateway Session expiry hook cleanup retry evidence
  • gateway Channel lifecycle writers into status model

2.F.4 — Home Channel + Operator Surfaces ✅

Section titled “2.F.4 — Home Channel + Operator Surfaces ✅”
  • gateway Home channel ownership resolver fixtures
  • gateway Notify-to delivery routing
  • gateway Channel directory atomic persistence + lookup
  • gateway Channel directory refresh + stale-target invalidation
  • gateway Manager remember-source hook
  • gateway Mirror + sticker cache surfaces
  • gateway Gateway delivery evidence in operator run report

2.F.5 — Gateway Mid-Run Steering + Active-Turn Policy ✅

Section titled “2.F.5 — Gateway Mid-Run Steering + Active-Turn Policy ✅”
  • gateway Steer slash command parser + preview helper
  • gateway Steer slash command registry + queue fallback
  • gateway Mid-run steer injection between tool calls
  • gateway Gateway-handled slash commands bypass active-session guard
  • gateway Gateway persistent goal loop + continuation judge
  • gateway Gateway/TUI /queue explicit FIFO slash parity
  • gateway SKILL.md parsing + active store
  • gateway Deterministic selection + prompt block
  • gateway Kernel injection + usage log
  • gateway Inactive candidate drafting
  • gateway Explicit promotion flow

2.H — Gormes-owned: Dynamic agents and per-thread spawn UX ✅

Section titled “2.H — Gormes-owned: Dynamic agents and per-thread spawn UX ✅”
  • goncho Goncho-backed dynamic agent registry
  • gateway gormes agent spawn/list/inspect/bind/unbind CLI
  • channels Telegram /spawn opens forum topic bound to spawned agent
  • channels Discord /spawn opens thread bound to spawned agent

SQLite + FTS5 + ontological graph + semantic fusion in Go; 3.E closes session visibility, audit trails, decay, and cross-chat/session boundaries

  • memory SqliteStore
  • memory FTS5 triggers
  • config Schema migrations v3a->v3d

3.B — Ontological Graph + LLM Extractor ✅

Section titled “3.B — Ontological Graph + LLM Extractor ✅”
  • memory Extractor
  • memory Entity/relationship upsert
  • memory Dead-letter queue

3.C — Neural Recall + Context Injection ✅

Section titled “3.C — Neural Recall + Context Injection ✅”
  • memory RecallProvider
  • memory 2-layer seed selection
  • memory CTE traversal
  • memory fence

3.D — Semantic Fusion + Local Embeddings ✅

Section titled “3.D — Semantic Fusion + Local Embeddings ✅”
  • providers Ollama embeddings
  • memory Vector cache
  • memory Cosine similarity recall
  • memory Hybrid fusion

3.D.5 — Memory Mirror (USER.md sync) ✅

Section titled “3.D.5 — Memory Mirror (USER.md sync) ✅”
  • memory Async background export
  • memory SQLite as source of truth
  • config Read-only bbolt sessions.db -> index.yaml mirror
  • sessions Deterministic mirror refresh without mutating session state
  • tools Append-only JSONL writer + schema
  • tools Kernel + delegate_task audit hooks
  • tools Outcome, duration, and error capture
  • sessions gormes session export —format=markdown
  • tools Render turns, tool calls, and timestamps from SQLite
  • memory gormes memory status command
  • memory Extractor queue depth + dead-letter summary
  • memory Append-only daily usage.jsonl writer
  • sessions Session, token, and cost rollups from local runtime
  • memory relationships.last_seen schema + backfill
  • memory Relationship writer freshness updates
  • memory Deterministic weight attenuation at recall time
  • sessions user_id concept above chat_id
  • memory Same-chat default recall fence
  • memory Opt-in user-scope recall + source filters
  • memory Interrupted-turn memory sync suppression
  • goncho Honcho-compatible scope/source tool schema
  • goncho Honcho host integration compatibility fixtures
  • memory SillyTavern persona and group-chat mapping fixtures
  • memory Cross-chat deny-path fixtures
  • memory Cross-chat operator evidence

3.E.8 — Session Lineage + Cross-Source Search ✅

Section titled “3.E.8 — Session Lineage + Cross-Source Search ✅”
  • sessions parent_session_id lineage for compression splits
  • gateway Gateway resume follows compression continuation
  • sessions Source-filtered session/message search core
  • goncho GONCHO user-scope search/context parameters
  • sessions Lineage-aware source-filtered search hits
  • sessions Operator-auditable search evidence
  • goncho Goncho context representation options
  • goncho Goncho search filter grammar
  • goncho Vector store + reconciler divergence proof
  • goncho Directional peer cards and representation scopes
  • goncho Goncho queue status read model
  • goncho Goncho summary context budget
  • goncho Goncho dialectic chat contract
  • goncho Goncho file upload import ingestion
  • goncho Goncho topology design fixtures
  • goncho Goncho operator diagnostics contract
  • goncho Goncho streaming chat persistence contract
  • goncho Goncho configuration namespace
  • goncho Goncho dreaming scheduler contract
  • goncho Goncho CRUD lifecycle invariants
  • goncho Goncho empty peer-card hint contract
  • goncho Hermes memory tool over Goncho/local durable store
  • goncho Goncho memory provider lifecycle adapter
  • goncho Goncho Memory V1 compatibility contract and migration harness
  • goncho GONCHO local-first markdown MCP memory requirement

3.G — Goncho Drop-In Compatibility Closure ✅

Section titled “3.G — Goncho Drop-In Compatibility Closure ✅”
  • goncho Goncho keys + webhooks compatibility surface
  • goncho Goncho webhook delivery retry worker contract
  • goncho Goncho HTTP route parity over OpenAPI v3
  • goncho Goncho CLI command-tree parity
  • goncho Goncho Honcho SDK compatibility e2e harness
  • goncho Goncho memory integration into normal agent turn

3.H — Goncho Memory Quality & UX Improvements ✅

Section titled “3.H — Goncho Memory Quality & UX Improvements ✅”
  • goncho Goncho session-end structured summary capture
  • goncho Goncho BM25 + RRF parallel retrieval fusion
  • goncho Goncho /memory and /continue CLI commands
  • goncho Goncho dream fact extraction and memory compression
  • goncho Goncho skill-outcome tracking as conclusions
  • goncho Goncho workspace isolation with explicit global scope

Native Go agent orchestrator + prompt builder

  • providers Provider interface + stream fixture harness
  • providers Hermes provider registry and alias manifest
  • providers OpenRouter Pareto router request plugin
  • providers Tool-call normalization + continuation contract
  • providers DeepSeek/Kimi reasoning_content echo for tool-call replay
  • providers DeepSeek/Kimi cross-provider reasoning isolation
  • providers DeepSeek/Kimi all-assistant reasoning_content replay
  • providers Moonshot/Kimi tool-schema sanitizer
  • providers Anthropic
  • providers Azure OpenAI query/default_query transport contract
  • providers Azure Anthropic Messages endpoint contract
  • providers Azure Foundry transport probe read model
  • providers Azure Foundry probe — path sniffing
  • providers Azure Foundry probe — /models classification + Anthropic fallback
  • providers Azure Foundry runtime env/config read model
  • providers Azure Foundry CLI setup/status manual fallback
  • providers Azure Foundry Responses-only model-family API mode
  • providers Bedrock provider runtime binding
  • providers Bedrock Converse payload mapping (no AWS SDK)
  • gateway Bedrock stream event decoding (SSE fixtures)
  • providers Bedrock SigV4 + credential seam
  • providers Bedrock stale-client eviction + retry classification
  • providers Gemini Cloud Code request/stream mapper
  • providers OpenRouter compatible-provider routing
  • providers OpenRouter Grok prompt-cache affinity header
  • providers Google Code Assist project/quota resolver
  • providers Codex
  • providers Codex Responses pure conversion harness
  • providers Codex Responses assistant content role types
  • providers Codex Responses HTTP client binding
  • providers Codex OAuth state + stale-token relogin
  • providers Codex stream repair + tool-call leak sanitizer
  • providers Cross-provider reasoning-tag sanitization
  • providers Tool-call argument repair + schema sanitizer
  • providers OpenAI-compatible developer-role API-boundary swap
  • providers xAI Grok provider adapter
  • providers LM Studio provider adapter
  • providers Vision-unsupported provider retry (strip-images-and-resend)
  • providers Gormes Router config and route registry read model
  • providers Gormes Router setup wizard and provider-picker boundary
  • providers Gormes Router OpenAI-compatible models/chat endpoint
  • providers Gormes Router streaming SSE and fallback safety
  • providers Gormes Router health/status counters and redacted logs
  • providers CLIProxyAPI-compatible upstream route adapter
  • sessions Long session management
  • sessions Context compression
  • tools ContextEngine interface + status tool contract
  • sessions Compression token-budget trigger + summary sizing
  • tools Aux compression headroom for system and tool schemas
  • providers Aux compression provider-aware context cap
  • tools Tool-result pruning + protected head/tail summary
  • sessions Aux compression single-prompt threshold reconciliation
  • sessions Compression protected-tail multimodal length estimator
  • sessions Context compressor image-token budget charge
  • sessions Context references stable-handle store
  • sessions Manual compression feedback + context references
  • sessions Manual compression feedback renderer + focus parser
  • sessions ContextEngine compression-boundary callback vocabulary
  • sessions Kernel compression-boundary callback binding
  • sessions ContextEngine session-end hook on reset
  • sessions Gormes-owned session tree navigator over lineage and labels
  • builder Default agent identity / SOUL.md loader
  • builder Context-file discovery + injection scan
  • builder Progressive subdirectory hint tracker
  • builder Model-specific role and tool-use guidance
  • builder Toolset-aware skills prompt snapshot
  • builder Memory guidance constant + injection
  • builder Session search guidance constant + injection
  • builder Gormes self-help skill/docs prompt guidance
  • builder [SYSTEM:→[IMPORTANT: meta-instruction prefix rename for Azure content filter compatibility
  • builder Native full prompt assembly
  • builder Ephemeral prefill messages file injection
  • providers Model metadata registry + context limits
  • providers Provider-enforced context-length resolver
  • providers Model pricing/capability registry fixtures
  • providers Ollama Cloud models.dev suffix normalization
  • providers Model catalog cache + preferred-provider live merge
  • providers Routing policy and fallback selector
  • providers Per-turn model selection
  • providers Per-turn reasoning effort propagation
  • providers Provider-default model resolution at config load
  • providers OpenAI Codex Spark catalog and context parity
  • providers Image input mode resolver + vision_analyze text fallback
  • providers Trajectory writer + redaction gates
  • gateway Trajectory compressor + compressed-evidence lineage
  • providers Self-monitoring telemetry
  • sessions Title prompt and truncation contract
  • sessions Title auxiliary failure visibility
  • sessions Auto-naming sessions
  • providers Token vault
  • providers Anthropic OAuth/keychain credential discovery
  • providers Multi-account auth
  • providers Credential non-ASCII sanitizer + one-shot warning
  • providers Google OAuth flow + refresh seam
  • providers MiniMax OAuth provider registry and default auth routing
  • providers GitHub Copilot token exchange + Responses mode selector
  • providers Provider-side resilience
  • providers Classified provider-error taxonomy
  • providers Generic provider timeout message classifier
  • providers Provider image-too-large error classification
  • providers Unsupported temperature retry + Codex no-temperature guard
  • providers Codex Responses temperature guard after flush removal
  • providers Generic unsupported-parameter retry + max_tokens guard
  • providers Jittered reconnect backoff schedule
  • providers Retry-After header parsing + HTTPError hint
  • providers Kernel retry honors Retry-After hint
  • providers Streaming interrupt retry suppression
  • providers Provider stream-drop retry diagnostics
  • providers Provider stream-drop timing and upstream diagnostics
  • providers Provider timeout config fail-closed helper
  • providers Prompt-cache capability guard
  • providers Provider account usage read model + renderer
  • gateway Gateway /usage command binding over provider account usage
  • providers Provider rate guard + budget telemetry
  • providers Provider rate guard — x-ratelimit header classification
  • providers Provider rate guard — degraded-state + last-known-good evidence
  • providers Hermes fast-mode request override serializer
  • runtime Python-free normal agent turn e2e harness
  • providers Provider-tool-memory golden transcript suite
  • planner Hermes and Honcho feature parity map to Go implementation plan
  • planner Upstream source coverage ledger for Hermes/Honcho mapping completeness
  • goncho Swarm feature-level parity audit for Hermes/Honcho map
  • stt Hermes/Honcho Go runtime plan second-wave reconciliation
  • runtime Nested feature-level coverage test matrix for swarm gaps
  • runtime Hermes website docs mirror coverage gate
  • providers Gormes setup/channel/provider docs webpage parity gate
  • gateway Native runtime provider gateway binding
  • runtime Hermes compatibility namespace retirement boundary
  • runtime Hermes agent runtime strict-fidelity source-pair expansion

4.J — Permission-Hardened Tool Execution ✅

Section titled “4.J — Permission-Hardened Tool Execution ✅”
  • tools Shell blocklist + filesystem scoping + permission approval
  • providers Resilient provider chain dispatch
  • providers Hermes fallback activation + classifier carve-outs
  • providers Fallback entry api_key_env credential alias

4.L — Safety-Anchored Turn Loop (MOSAIC) ✅

Section titled “4.L — Safety-Anchored Turn Loop (MOSAIC) ✅”
  • runtime Plan gate hook in agent turn loop
  • tools Tool gate pre-execution validation
  • runtime Refusal-as-action in ReAct cycle
  • runtime Safety loop end-to-end integration
  • providers Circuit breaker per provider and API key
  • providers P95 latency-aware failover
  • providers Capability-based model tier routing

Python tool scripts ported to Go or WASM

  • tools 61-tool registry port
  • tools Tool registry inventory + schema parity harness
  • tools Tool-call JSON-string array/object coercion parity
  • tools Tool parity manifest refresh for Hermes b35d692f
  • tools Tool parity manifest refresh for Hermes ea86714 computer_use
  • tools Tool parity manifest refresh for Hermes 524cbabd patch schema
  • tools Microsoft Graph auth/client helper parity
  • channels Discord tool split + platform-scoped toolsets
  • channels Discord tool limit coercion helper
  • tools Home Assistant HASS_TOKEN platform-toolset carveout
  • tools Home Assistant tool handlers + service safety validation
  • tools Pure core tools first
  • config Stateful tool migration queue
  • tools Terminal process watch notification throttle contract
  • tools Tool output budget persisted artifact pointer
  • tools Tool descriptor layer (OperationSpec)
  • tools Hermes tool tail strict-fidelity source-pair expansion
  • tools Environment interface + file sync contract
  • tools Terminal snapshot source stdout suppression guard
  • tools Terminal deleted-cwd recovery guard
  • tools Raw tool-call parser fixture matrix
  • install Docker execution backend (container lifecycle + mount policy)
  • install Docker backend top-level container reuse semantics
  • tools Modal
  • tools Daytona
  • tools Singularity command/preflight contract
  • tools Sandbox Policy Explain
  • browser Browser action contract + event transcript
  • browser go-browser-harness Chromedp action backend
  • browser Rod
  • browser Browser provider bridge + Firecrawl fallback
  • browser Camofox REST browser mode and managed identity bridge
  • browser Browser Use cloud + Go browser harness bridge
  • browser Go browser-harness Hermes browser_* tool wrappers
  • browser Go-native Hermes web_search/web_extract tool wrappers
  • browser Go-native Hermes web backend matrix and config resolver
  • browser Go-native Hermes web extract safety policy and summarizer
  • browser Goscrapling local extraction for web_extract
  • browser Go-native Hermes web_crawl tool adapter
  • browser Go-native Hermes web managed gateway status and live smoke closure
  • browser Brave Search + DDGS web search provider parity
  • browser Browser artifact and console render contract
  • browser Browser console expression CDP result shaping
  • browser Telegram browser artifact rendering
  • browser Browser hybrid private-URL local sidecar routing
  • browser Browser SSRF quoted-false guard
  • browser Go browser harness binary repo + integration lane (placeholder)
  • browser Browser session inactivity cleanup thread
  • browser Goscrapling browser-backed extraction gate for web_extract
  • browser Goscrapling local crawler fixture adapter seam for web_crawl
  • browser web_crawl explicit local-crawler unavailable evidence
  • tools Multimodal in/out
  • tools Image input mode router + native content parts
  • tools vision_analyze native multimodal tool-result path
  • tools Image-too-large shrink retry helper
  • tools Image generation result contract
  • providers Image generation provider registry + plugin dispatch
  • tools FAL image generation queue REST binding
  • tools Native video_analyze tool contract
  • tts Voice mode port
  • tts Voice mode environment detector + audio provider seam
  • tts Transcription tool contract
  • tts Telegram voice/audio STT ingress hook
  • tts TTS tool contract + media delivery seam
  • tts MiniMax TTS v1 text_to_speech raw-audio compatibility
  • tts TTS provider matrix + dotenv/command-provider resolution
  • tts TTS synthesis + voice-mode state
  • tts Voice record-key config binding for native TUI
  • tts Telegram voice STT HTTP-provider fallback
  • tts Pure-Go STT exploration
  • tts wazero WASI smoke harness
  • tts whisper.cpp WASI module discovery
  • tts Pure-Go Whisper transcribe one WAV
  • tts Whisper tiny.en model cache fetcher
  • tts Wire Pure-Go Whisper into Telegram resolver
  • tts WASI Whisper ffmpeg preprocess + fixed-window chunker
  • tts Audio preprocessing and chunking pipeline
  • tts Whisper benchmark harness + perf budget
  • tts Go-native OGG/Opus decoder decision
  • tts Go-native OGG/Opus decoder implementation
  • tts Pure-Go TTS decision research
  • tts Shared speech artifact cache for Go-owned TTS
  • tts Go-owned local TTS runtime seam + fixture fallback
  • providers Skills hub search result types + in-memory registry provider
  • providers Skills hub search read-model function over registry providers
  • skills Skill registries
  • skills Skills hub direct URL candidate parser
  • skills Skills hub direct URL install name/category guard
  • skills Skill preprocessing + dynamic slash commands
  • skills [IMPORTANT:] prompt prefix for cron and skill commands
  • skills Skills list — enabled/disabled status column + —enabled-only filter
  • profiles Update bundled skills across active and named profiles
  • skills Bundled Airtable productivity skill contract
  • skills Bundled TouchDesigner MCP skill catalog contract
  • skills Gateway/TUI dynamic skill slash invocation parity
  • skills TUI/gateway reload-skills command refresh binding
  • tools MCP client
  • goncho Goncho MCP tool catalog
  • config MCP server config/env resolver
  • tools MCP stdio transport + tool/list discovery
  • tools MCP HTTP transport + tool/list discovery
  • tools MCP schema normalization + structured-content adapter
  • providers MCP OAuth state store + noninteractive auth errors
  • providers MCP OAuth refresh + 401 session-expired recovery
  • gateway Managed tool gateway bridge
  • tools MCP circuit breaker cooldown + reconnect reset
  • tools MCP stdio orphan cleanup after cron ticks
  • tools Gormes-native MCP host runtime boundary
  • channels MCP channels_list tool
  • tools ACP server side
  • tools ACP Client Bridge Mode
  • tools ACP JSON-RPC stdio session/prompt closeout
  • tools ACP stdio benign ping/probe suppression
  • tools ACP session CWD propagation into prompt runners
  • tools ACP setup-browser bootstrap parity
  • skills Plugin SDK
  • skills Dashboard theme/plugin extension status contract
  • skills Dashboard page-scoped plugin slot inventory
  • skills Third-party extensions
  • skills Hermes plugin CLI lifecycle parity
  • skills Teams pipeline plugin CLI metadata + disabled runtime inventory
  • goncho Goncho Honcho plugin session config + async write compatibility
  • skills First-party Spotify plugin fixture
  • skills First-party Google Meet plugin metadata fixture
  • skills Hindsight memory setup blank-input preservation
  • skills Agent Hooks Registry
  • doctor Plugin Marketplace + Doctor
  • skills Extension Lifecycle Hook System
  • skills Plugin lifecycle hook: transform_llm_output
  • skills Hermes plugin catalog strict-fidelity classifier
  • tools Dangerous action gating
  • gateway Gateway approval FIFO queue resolver
  • tools Hardline command pattern table + DetectHardline function
  • tools Recoverable dangerous patterns + blocked-result schema
  • config Approval mode config normalization
  • gateway Gateway hook auto-accept strict parser
  • tools delegate_task batch JSON-string task recovery
  • tools Subagent dangerous-command non-interactive approval policy
  • tools Concurrent tool approval callback propagation
  • tools Background review toolset restriction
  • tools Cron dangerous-command approval mode
  • config Cron approval mode config normalizer
  • tools Tirith external security finding ingestion
  • tools Unified security guard decision composer
  • tools Shell blocklist (36+ dangerous patterns)
  • tools Filesystem scoping (folder-level read/write restrictions)
  • tools Permission approval UX (inline y/n/always)
  • tools Trust-class enforcement in shared tool executor
  • runtime Secrets Runtime Controls
  • tools Security Audit Command
  • channels Email allowlist pre-dispatch loop guard
  • tools Auth state TOCTOU close + redaction default-on parity
  • gateway Gateway allowed_chats/channels/rooms whitelist parity
  • tools Sandboxed exec
  • tools Atomic file write helper with temp+rename pattern
  • tools File tool atomic checkpoint integration
  • tools Checkpoints CLI (status/list/prune/clear/clear-legacy)
  • tools Checkpoint shadow-repo GC policy
  • tools File read dedup cache invalidation and wrapper guard
  • tools File read repeated-stub BLOCKED escalation
  • tools Native file task tool surface
  • tools V4A patch mode for native patch tool
  • tools V4A move operation for native patch tool
  • tools Symlink-preserving atomic writer helper
  • tools File write/patch staleness registry + cwd tracking
  • config Terminal cwd config bridge
  • tools Terminal deleted-cwd recovery
  • tools search_files hidden-root and context-line parsing drift
  • tools Structured lint delta for native write/patch tools
  • tools Python syntax lint delta for native write/patch tools
  • tools Shell lint delta for native write/patch tools
  • tools Patch replace no-match did-you-mean hint
  • tools Core fuzzy replace strategies for native patch tool
  • tools Unicode-normalized fuzzy replace for native patch tool
  • tools Block-anchor fuzzy replace for native patch tool
  • tools V4A fuzzy hunk matching for native patch tool
  • tools Context-aware fuzzy replace for native patch tool
  • tools V4A patch apply rollback for native patch tool
  • tools Patch replace post-write verification
  • tools Hermes LSP write-time semantic diagnostics
  • tools Per-file mutation queue for native write edit and patch tools
  • providers Multi-model coordination
  • kanban Hermes Kanban durable board core
  • kanban Hermes Kanban dispatcher and worker spawn loop
  • kanban Hermes Kanban production worker process binding
  • kanban Hermes Kanban worker tools and prompt gating
  • kanban Kanban orchestrator board-routing tools
  • kanban Kanban comment author hardening and cross-task handoff policy
  • kanban Hermes Kanban slash/gateway/dashboard surfaces
  • kanban Native TUI /kanban slash command binding over gormes kanban
  • kanban Gateway /kanban shared command-runner binding
  • kanban Kanban slash help and usage-error UX
  • kanban Kanban dashboard dispatch quick path
  • kanban Kanban dashboard task run history endpoint
  • kanban Kanban dispatcher status in gateway /status
  • kanban Kanban multi-board isolation
  • kanban Kanban workspace context injection
  • kanban Kanban run history persistence
  • kanban Kanban notification delivery parity
  • kanban Kanban chat board DB pin
  • kanban Kanban schema migration duplicate-column race guard
  • kanban Kanban notify subscription store and CLI
  • kanban Kanban notify delivery engine blocked retention
  • kanban Kanban stats command and board summary
  • kanban Kanban corrupt timestamp age hardening
  • kanban Kanban named-board workspace and log roots
  • kanban Kanban current-board task command routing
  • kanban Kanban task run history command
  • kanban Kanban boards list/show task-count read model
  • kanban Kanban global —board task command override
  • kanban Kanban GC terminal event and worker-log retention
  • kanban Kanban worker log read command
  • kanban Kanban task event tail command
  • kanban Kanban worker heartbeat, reclaim, and zombie detection
  • kanban Hermes Kanban specify triage parity
  • tools Todo
  • tools Clarify
  • tools Session search tool schema and argument validation
  • tools Session search tool execution wrapper
  • tools Session shutdown memory transcript handoff
  • tools Debug helpers
  • tools Debug share paste sweep scheduler contract
  • doctor Doctor GitHub CLI auth fallback
  • planner Planner audit blank-subphase control-plane bucket
  • fleet Autoloop recent-failure detail excerpts
  • tools Backend usage-limit stdin health bypass
  • tools Cronjob tool API + schedule parser parity
  • tools Cron schedule parser + repeat state fixtures
  • tools Cron recurring next-run failure preservation
  • tools Cron prompt/script safety + pre-run script contract
  • tools Cron GitHub auth-header scanner parity
  • tools Cronjob tool action envelope over native store
  • tools Cron run resource release contract
  • tools Cron run resource release executor binding
  • tools Cron context_from output chaining
  • tools Cron prompt/script safety + pre-run script contract (deprecated umbrella)
  • tools Cron multi-target delivery + media/live-adapter fallback
  • tools Cron deliver=all routing intent expansion
  • skills Plugin standalone sender cron delivery fallback
  • goncho Goncho serialized write queue + relation candidates
  • tools Blocker Policy Integration
  • tools OpenClaw SecretRef core resolver
  • config Cross-agent config isolation
  • tools SecretRef runtime snapshot activation
  • tools OpenClaw security audit —deep —fix
  • doctor ACP bridge doctor/status evidence
  • gateway Gateway probe auth/capability HTTP closeout
  • tools Safety-critical panic and swallowed-error closeout
  • tools Session Health Monitoring
  • tools Evidence-Before-Claims Quality Gate
  • tools Git Delivery Contract Enforcement
  • tools QMD Hybrid Search
  • tools Session Rollover Automation
  • fleet System Events, Heartbeat, and Presence
  • gateway Gateway Discover and Probe
  • tools Channels Capabilities Introspection
  • channels Teams configured-state in channel capabilities
  • tools Prompt Fragment Include System
  • gateway Multi-agent gateway runtime activation
  • tools Multi-agent auth and tool-policy runtime isolation
  • channels Per-agent channel bot tokens (Telegram/Discord/Slack)
  • tools Cron env-ref expansion + parallel run state serialization
  • tools Cron origin delivery isolation from session identity
  • tools Cron script/workdir/inactivity execution binding
  • fleet Cron no-agent script-only watchdog mode
  • providers Cron partial legacy job read-model normalization
  • tools Cron dashboard partial-record page
  • navivox Navivox host setup apply with transient sudo
  • gateway Gateway auto-resume on restart
  • tools Hermes x_search tool and auth surface
  • goncho Goncho durable recall trace IR + fused ranking pipeline
  • goncho Goncho recall diagnostics CLI over RecallTrace
  • goncho Goncho replayable retrieval traces
  • goncho Goncho proof matrix and fixture harness
  • runtime Morning degraded-status summary over latest run report
  • providers Provider/auth readiness preflight for unattended jobs
  • goncho Goncho golden transcript e2e harness
  • goncho Goncho retrieval benchmark corpus
  • tools Hermes send_message tool list and target contract
  • tools Image generation managed-gateway provider binding
  • tools OSV malware advisory check for MCP package launch
  • tools Hermes toolset distribution manifest and deterministic sampler
  • cli 49-file CLI tree port
  • cli Hermes CLI command-tree parity manifest
  • cli Hermes CLI nested parser inventory refresh
  • cli Hermes auth command-tree manifest refresh
  • providers Hermes auth credential-pool command surface
  • providers Hermes auth OAuth provider adapters
  • providers Hermes auth Spotify service-provider subcommand
  • channels Deterministic helper-file ports (banner/output/tips/webhook/dump)
  • cli CLI banner/output formatting helpers
  • cli CLI deterministic tip selector
  • cli CLI OpenClaw residue detection and hint text
  • config CLI onboarding seen-state map helpers
  • config CLI contextual first-touch onboarding hint renderers
  • cli CLI bracketed-paste wrapper sanitizer
  • cli CLI slow bracketed-paste diagnostic threshold
  • tools CLI terminal control-response sanitizer
  • cli CLI submitted user-message preview formatter
  • channels CLI webhook URL normalizer
  • cli CLI dump support-summary helper
  • cli PTY bridge protocol adapter
  • cli CLI command registry parity + active-turn busy policy
  • gateway Gateway /reasoning command parser
  • gateway Gateway /reasoning apply + dispatch
  • sessions Busy command guard for compression and long CLI actions
  • profiles Config, profile, auth, and setup command surfaces
  • cli Gormes agent template reset command
  • cli Hermes py2many parity mapping report
  • cli Hermes source-pair manifest and Phase 0 refresh mode
  • providers Gormes auth bare interactive credential-pool readout
  • providers Gormes auth status per-provider aggregator
  • providers Gormes auth add openai-codex strict isolation contract
  • planner Gormes auth add bedrock open-question planning note
  • profiles Gormes profile command binding
  • profiles Gormes profile distribution metadata readout
  • profiles Gormes profile create clone-all infrastructure exclusion
  • profiles Model and profile selector seam (Cobra + gateway)
  • providers Gormes top-level logout provider shortcut
  • providers Top-level logout configured-provider fallback
  • cli Gormes removed top-level login guidance
  • providers Gormes model interactive provider/model picker
  • config Gormes setup minimal sectioned wizard slice
  • config Gormes setup top-level chooser menu
  • config Gormes setup full-wizard shell and branded summary
  • providers Gormes setup model step uses the dynamic provider-tracked model picker
  • config Hermes setup entry-mode and reset semantics
  • config Gormes setup tools checklist command binding
  • gateway Gormes setup gateway platform checklist command binding
  • tui Bubble Tea Messaging Platforms setup: Telegram-first Hermes fidelity
  • tts Gormes setup terminal TTS and agent-settings section bindings
  • install Gormes uninstall dry-run command contract
  • tools Gormes mcp login interface seam + noninteractive default
  • browser Gormes mcp login browser callback flow
  • providers Hermes fallback provider chain CLI commands
  • providers Provider endpoint/API-key root flags + runtime resolution
  • profiles Gormes profile skills chat invocation shim
  • channels Hermes config.yaml Telegram compatibility bridge
  • config Gormes config command surface
  • config Gormes config set comment-preserving TOML writes
  • config Gormes config edit/check/native schema-migrate closeout
  • config Hermes config migration dry-run manifest
  • config Hermes config migration writer
  • config OpenClaw migration dry-run manifest
  • config OpenClaw migration writer and cleanup command
  • profiles CLI profile name validator
  • profiles CLI profile root resolver
  • profiles CLI active-profile store
  • profiles CLI profile path and active-profile store (deprecated umbrella)
  • providers Scripted chat query model/provider resolver
  • cli Oneshot final-output writer boundary
  • tools Oneshot noninteractive safety and clarify policy
  • config Platform toolset config persistence + MCP sentinel
  • tools Platform toolset mixed composite runtime expansion
  • skills Effective toolset picker dedupes bundled plugin keys
  • channels Gateway, platform, webhook, and cron management CLI
  • channels WhatsApp top-level pairing wizard shell
  • channels WhatsApp live Baileys QR pairing wizard
  • gateway Gateway management CLI read-model closeout
  • gateway Gateway mutating-subcommand unavailability stub
  • gateway Windows gateway Scheduled Task lifecycle commands
  • gateway Windows detached gateway Ctrl+C boundary
  • cli Service RestartSec parser helper
  • cli Service restart active-status poller
  • cli Diagnostics, backup, logs, and status CLI
  • sessions Hermes sessions CLI MRU browse/delete ergonomics
  • cli Backup/update opt-in and exclusion policy
  • cli Self-update command lifecycle safety
  • planner Gormes update release planner and dry-run contract
  • install Gormes update verified binary swap and rollback
  • gateway Gormes update bundled assets and skills sync
  • cli Gormes update managed service drain and restart
  • doctor doctorCustomEndpointReadiness check function
  • doctor gormes doctor actionable issues summary and —fix auto-remediation
  • doctor gormes doctor ◆ Section grouping + upstream section ordering (UX parity)
  • doctor gormes doctor section-content parity (Security Advisories / Directory Structure / Skills Hub / Auth Providers / Profiles)
  • doctor gormes doctor ◆ Directory Structure section content
  • doctor gormes doctor ◆ Skills Hub section content
  • doctor gormes doctor ◆ Auth Providers section content
  • doctor gormes doctor ◆ Profiles section content
  • doctor gormes doctor ◆ Security Advisories section content
  • config gormes setup
    boxed header + completion footer (UX parity)
  • profiles Profile Control Center v2 umbrella — single root config and active services
  • profiles gormes setup profiles — section scaffold + per-profile workspace list
  • profiles gormes setup profiles — per-profile channels (telegram/whatsapp/discord/slack)
  • navivox Navivox multi-server profile routing config model
  • providers Custom provider model-switch credential preservation
  • providers Custom provider model-switch key_env write guard
  • cli CLI log redactor for known secret shapes
  • cli CLI log snapshot reader using shared redactor
  • providers Hermes config.yaml model/provider runtime bridge
  • config Interactive Onboarding
  • config Internal onboarding interactive action runner
  • config CLI setup/onboard/help text fidelity matrix
  • cli Hermes CLI alias and suggestion fidelity matrix
  • cli Logs Command
  • gateway Gateway planned stop marker + WSL systemd PATH parity
  • gateway Gateway stale-code self-check uses git HEAD SHA
  • runtime Agent lifecycle hooks (agent:start, agent:step, agent:end)
  • providers Nous OAuth device code + refresh token + agent key provisioning
  • cli Hermes send command stdin/file payload parity
  • sessions Hermes session recap command surface
  • profiles Profile workspace allow-list enforcement policy
  • profiles Profile-local subprocess HOME parity
  • profiles Long-term plan: profile fleet supervisor and single control-plane gateway
  • cli CLI module contract registry and manifest gate
  • cli cmd/gormes profile command package extraction
  • cli cmd/gormes setup section registry extraction
  • providers cmd/gormes provider usage command package extraction
  • providers cmd/gormes provider command surface package extraction
  • gateway cmd/gormes gateway row-backed command package extraction
  • channels cmd/gormes channels capabilities command package extraction
  • gateway cmd/gormes live gateway command package extraction
  • channels cmd/gormes channel service command package extraction
  • cli cmd/gormes root command assembly extraction
  • config Root config.toml v2 profile service schema
  • config Legacy profile config v2 migration planner
  • profiles Profile Control Center read model
  • profiles Profile Control Center TUI shell and draft apply flow
  • providers Per-profile provider credential readiness
  • channels Per-profile channel credential readiness and allow-lists
  • providers Gormes setup providers plural alias
  • cli Root tools command config-backed toolset toggles
  • install OCI image
  • install Homebrew
  • install Nix flake package and NixOS module contract
  • install Unix installer (install.sh) source-backed update flow
  • install Unix installer root/FHS layout policy
  • install Windows installer (install.ps1 + install.cmd) parity
  • install Installer script serving and MIME validation
  • install Install isolation: GORMES_BIN_DIR is an authoritative sandbox boundary
  • install Install isolation: skip shell-rc PATH write when bin dir is under /tmp
  • install Install isolation: skip system service install when sandbox bin dir is set
  • install Install: prefer pre-built release binary over source build by default
  • install Install: Termux publishes a real $PREFIX/bin binary, not an $HOME-targeting symlink
  • install Termux exec argv path-alias sanitizer
  • install Termux binary-fetch publish verification source fallback

5.Q — API Server + TUI Gateway Streaming ✅

Section titled “5.Q — API Server + TUI Gateway Streaming ✅”
  • profiles Deterministic helper-file ports (tool-progress/image/completion-path/personality/platform-event)
  • gateway TUI gateway tool-progress mode normalizer
  • gateway TUI gateway completion path normalizer
  • gateway TUI gateway tool summary formatter
  • profiles TUI gateway image/personality/platform-event helpers
  • gateway TUI gateway config health null-section probe
  • tui TUI mouse tracking config + slash toggle
  • tui Native TUI bundle independence check
  • gateway TUI launch model override + static alias resolver
  • gateway TUI prompt-submit auto-title eligibility helper
  • gateway TUI TerminalNativeSelectionHelp constant + help-string fixture
  • tui Native TUI slash-command dispatch table
  • tui Native TUI /save canonical session export
  • tui Native TUI /save XDG export helper
  • tui Native TUI /save local runtime binding
  • tui Native TUI /branch session fork + transcript target switch
  • tui Native TUI /branch local runtime resident-session binding
  • tui Native TUI resident session-switch replay helper
  • gateway TUI running-agent placeholder surfaces interrupt + queued slash actions
  • tui Native TUI conversation viewport tail helper
  • tui Native TUI queued-message edit helper
  • tui Native TUI renderConv viewport budget binding
  • tui Native TUI Hermes skin token renderer
  • tui Native TUI Hermes status bar renderer
  • tui Native TUI Hermes bottom-pinned chrome layout
  • tui Native TUI Hermes input keybinding semantics
  • tui Native TUI Shift+Enter newline CSI-u parity
  • tui Native TUI clipboard, OSC52, and terminal setup parity
  • tui Native TUI image/file drop + paste collapse ingress
  • tui Native TUI Hermes slash completion helpers
  • tui Native TUI absolute path completion routing
  • tui Native TUI Hermes slash dispatch behavioral matrix
  • tui Native TUI /quit local exit binding
  • tui Native TUI Hermes tool progress + modal panel renderers
  • tui Native TUI Ink behavioral transcript golden matrix
  • tui Native TUI markdown soft-wrap boundary trim
  • gateway Channel/TUI iteration-limit finalization transcript fixture
  • tui SSE streaming to Bubble Tea TUI
  • gateway TUI websocket attach transport
  • gateway OpenAI-compatible chat-completions API server
  • gateway API server multimodal content preservation
  • gateway Responses API store + run event stream
  • gateway API server disconnect snapshot persistence
  • gateway Gateway proxy mode forwarding contract
  • gateway Gateway proxy replay assistant metadata preservation
  • gateway Dashboard API client contract
  • gateway Dashboard PTY chat sidecar contract
  • gateway API server detailed health snapshot contract
  • gateway API server detailed health endpoint
  • gateway API server cron admin read-only endpoints
  • gateway API server cron admin mutating endpoints
  • gateway API server legacy jobs routes + default toolset
  • gateway Provider client lazy-init for TUI cold-start budget
  • tui Native TUI /model slash command binding over the existing model picker
  • tui Kernel in-session model-switch seam for the native TUI
  • gateway Kernel cross-provider client swap for in-session model switch
  • tui Native TUI slash handler-port coverage
  • tui Native TUI shipped slash command registry availability metadata
  • tui Native TUI Terminal.app truecolor and ANSI sanitizer parity
  • tui Hermes ui-tui strict-fidelity action matrix
  • gateway Hermes web dashboard strict-fidelity contract map
  • tui Native TUI /help slash command binding
  • tui Native TUI /redraw local repaint binding
  • tui Native TUI /statusbar chrome mode binding
  • tui Native TUI /details detail-section visibility binding
  • tui Native TUI /indicator busy-indicator style binding
  • tui Native TUI /history current transcript page binding
  • tui Native TUI /status current frame page binding
  • tui Native TUI /logs gateway tail page binding
  • tui Native TUI /title session-title binding
  • tui Native TUI /sessions and /resume picker page binding
  • tui Native TUI /resume session switch binding
  • tui Native TUI /usage local frame usage page binding
  • tui Native TUI /usage provider account usage adapter binding
  • tui Native TUI /clear and /new reset-session binding
  • tui Native TUI /compact transcript toggle binding
  • tui Native TUI /skills read-only hub binding
  • tui Native TUI /tools enable-disable binding
  • tui Native TUI /voice status and toggle binding
  • tui Native TUI /skin get-set binding
  • gateway Gormes JSONL RPC mode over agent runtime events
  • tui Native TUI voice record key uses voice toggle adapter
  • config Execution-mode resolver + config precedence
  • tools Strict-mode CWD + interpreter parity
  • tools Project-mode CWD + active venv detection
  • config Default mode selection + config cut-over
  • runtime 5-type loop detector
  • browser go-browser-harness doctor subcommand

5.U — Fault-Tolerant Sandbox Execution ✅

Section titled “5.U — Fault-Tolerant Sandbox Execution ✅”
  • tools Pre-execution command classification
  • tools Transactional tool execution with snapshot/rollback
  • tools Sandbox isolation depth selection
  • runtime Event bus core: pub/sub interface + in-process implementation
  • channels Gateway channel adapters publish to event bus
  • gateway Gateway outbound sends publish message-sent events
  • channels Weixin gateway event-bus adapter
  • channels WeCom gateway event-bus adapter
  • channels Telegram gateway event-bus adapter
  • channels Discord gateway event-bus adapter
  • channels Slack gateway event-bus adapter
  • channels WhatsApp gateway event-bus adapter
  • tools Agent turn and tool execution events on bus
  • gateway Event bus integration test: full message flow
  • runtime Hermes i18n static-message port
  • runtime Hermes i18n expanded locale catalog parity

Hermes-compatible background review and skill curation, plus Gormes-native evidence gates for safe compounding intelligence.

  • learning-loop Hermes background review fork lifecycle
  • learning-loop Deterministic learning-loop trigger signals
  • skills LLM-assisted pattern distillation
  • skills SKILL.md frontmatter validation guard
  • skills Hermes creative skill metadata compatibility
  • skills Portable SKILL.md format
  • skills Hermes v0.14 optional skill catalog refresh
  • skills Hermes skill catalog strict-fidelity classifier
  • skills Hybrid lexical + semantic lookup
  • skills Source-aware retrieval damping fixtures
  • gateway Delta-bounded skill and memory maintenance passes
  • skills Code Cathedral II code-context retrieval fixtures
  • providers Hermes curator auxiliary model routing slot
  • skills Hermes curator state transitions and run reports
  • skills Hermes curator rename summary notice
  • learning-loop Hermes review prompt transient-environment guard
  • skills Skill effectiveness scoring
  • skills Hermes skill_manage support-file and curator intent actions
  • skills Hermes curator command surface
  • skills Hermes curator archive/list/prune CLI catch-up
  • channels TUI + Telegram browsing
  • skills Native skills list/view tool surface
  • skills TUI and gateway direct URL skill install binding
  • skills Hermes/Pi external skill directories config binding
  • skills Pi-style prompt template TUI expansion seam
  • skills Prompt template CLI explicit roots and opt-out binding
  • memory 6 typed memory categories with confidence scoring
  • skills SKILL.md metadata.when/loaded/placement schema
  • memory Regex-based auto-link extraction + brain-first lookup

6.J — Agentic Memory Lifecycle (AgeMem) ✅

Section titled “6.J — Agentic Memory Lifecycle (AgeMem) ✅”
  • tools Memory operations as agent-callable tools
  • memory Agent-controlled memory retention with importance scoring
  • sessions Cross-session memory continuity
  • learning-loop Prompt evaluation harness
  • learning-loop Iterative prompt mutation and scoring loop
  • sessions Behavioral pattern extraction from session logs

6.L — Composable Skill Execution (Voyager) ✅

Section titled “6.L — Composable Skill Execution (Voyager) ✅”
  • skills Skill code execution runtime
  • skills Skill dependency resolution and composition
  • profiles Agent personalities + enhanced display config
  • stt Session auto-reset + STT config parity

Deferred non-priority channel adapters after Telegram, Discord, Slack, WhatsApp, and WeChat stabilize

  • channels Inbound event normalization + session identity
  • channels Reply/send contract on shared chassis
  • channels Signal transport/bootstrap layer
  • channels Signal markdown bodyRanges + attachment rate scheduler
  • channels Email ingress + outbound delivery contract
  • channels SMS ingress + outbound delivery contract
  • channels Threaded text adapter contract suite
  • channels Matrix shared-chassis bot seam
  • channels Matrix self/bridge sender drop helper
  • channels Mattermost shared-chassis bot seam
  • channels Matrix real client/bootstrap layer
  • channels Matrix E2EE device-id crypto-store binding
  • channels Mattermost REST/WS bootstrap layer
  • channels Signed event parsing + auth gates
  • channels Prompt-to-delivery routing bridge

7.E — Regional + Device Adapter Backlog ✅

Section titled “7.E — Regional + Device Adapter Backlog ✅”
  • channels BlueBubbles + HomeAssistant adapters
  • channels BlueBubbles iMessage bubble formatting parity
  • channels Feishu shared-chassis bot seam
  • channels DingTalk shared-chassis bot seam
  • channels QQ Bot shared-chassis bot seam
  • channels Feishu transport/bootstrap layer
  • channels Feishu native update prompt cards
  • channels Feishu drive-comment rule + pairing seam
  • channels Feishu drive-comment reply workflow
  • channels DingTalk transport/bootstrap layer
  • channels DingTalk real SDK binding
  • channels DingTalk AI Cards streaming-update contract
  • channels DingTalk emoji reaction send/receive parity
  • channels DingTalk media (image/file) attachment routing
  • channels Yuanbao protocol envelope + markdown fixtures
  • channels Yuanbao media/sticker attachment normalization
  • gateway Yuanbao gateway runtime + toolset registration
  • channels Microsoft Teams adapter plugin seam
  • channels QQ Bot transport/bootstrap layer
  • channels Google Chat shared-chassis platform adapter seam
  • channels Google Chat relay sender-type self-filter
  • channels Google Chat standalone cron sender
  • channels Google Chat install dependency hint refresh
  • channels SimpleX Chat platform plugin parity

TrebuchetDynamics has a credible public face (blog, writeups, talks) that documents Gormes’s autonomous-porting methodology and one or two sharp differentiators. Reputation is built through publication cadence, not parity scope.

  • docs TD engineering blog scaffolded and live
  • docs TD social presence connected to blog feed
  • docs README rewrite to methodology-first positioning
  • docs README release and benchmark metadata sync
  • landing gormes.ai landing page positioning audit
  • docs Gormes market comparison positioning brief
  • docs Public comparison matrix: Gormes vs Hermes, OpenClaw, hosted agents
  • channels Channel capability matrix with stable/fixture/planned labels
  • learning-loop Learning-loop proof demo for skills, memory, and curator
  • install No-stack first-run proof path from install to offline doctor
  • docs Canonical config.toml v2 profile schema docs
  • docs Engineering writeup #1: autonomous Hermes-porting loop
  • docs Engineering writeup #1 cost telemetry evidence packet
  • docs Engineering writeup #1 local publication review packet
  • docs Hermes v0.14 release feature-to-module pairing ledger
  • docs Hermes contract inventory gate
  • docs Strict-fidelity upstream test-suite classifier
  • docs Hermes integrations claim audit + source-backed plugin/skill parity map
  • release Sharp v1.0 differentiator decision
  • release Single-binary cross-platform release pipeline
  • release Release binary version/provenance smoke guard
  • install CI and installer Go toolchain floor sync
  • release Release prep guide target matrix sync
  • install Windows install.ps1 release binary fetch selector
  • install OCI image PR build and arm64 smoke workflow
  • release Release build-date provenance injection
  • landing Landing release metadata date-alias sync
  • release GitHub release title date-alias binding
  • release Release notes artifact size table
  • release Release SBOM attestation binding
  • release Release build provenance attest action contract
  • release Release notes SBOM attestation wording
  • release Release archive 30 MB size gate
  • install Termux android/arm64 release artifact and installer selector
  • tui Gormes-owned chat TUI divergence ratification
  • tui Gormes-owned session-aware welcome panel
  • tui Gormes-owned semantic chat style system
  • tui Gormes-owned streaming feedback uplift
  • tui Gormes streaming tool-trail status + spinner cadence wiring
  • tui Gormes welcome panel version/tool-count wiring
  • release Termux latest-installer follow-up release publication
  • release Removal of public v0.2.20 Termux latest-install caveats from README, landing, install docs, and troubleshooting docs
  • tui Gormes-owned TUI queued-message widget and busy delivery modes
  • tui Gormes-owned TUI extension status widget and footer seam
  • docs Agentic-porting-kit extraction spec
  • docs Agentic-porting-kit local standalone fixture
  • docs Agentic-porting-kit local porting skill skeletons
  • docs Agentic-porting-kit local README and license fixture
  • docs Agentic-porting-kit local public layout assembly gate
  • docs Agentic-porting-kit public repo scaffold

8.F — Cost Discipline & Loop Economics ✅

Section titled “8.F — Cost Discipline & Loop Economics ✅”
  • progress Loop $/iteration cost metric in status file
  • landing Stop git-tracking duplicate landing progress mirrors (build-time generate)
  • progress Compact completed-row shipped-evidence notes to a one-line pointer
  • progress Module-split the progress backlog (per-subsystem files, parity-aligned)
  • progress Backlog split C1: lossless multi-file loader/writer behind the single-file API
  • landing Backlog split C2: docs/landing generators read the split layout
  • progress Backlog split C3: migrate remaining backlog consumers and the write path to the split layout
  • progress Backlog split C5a: optional per-row module key + deterministic derivation + backfill
  • progress Backlog split C4: AGENTS.md + gormes-* skills source-order updated to the split layout
  • progress Backlog split C5b: module-keyed split layout behind the existing API
  • progress Backlog split C5c: migrate webpages/docs raw progress.json readers to internal/progress.Load
  • progress Backlog split C5d: migrate gormes-* skill discovery commands off raw jq of the canonical progress.json
  • progress Backlog split C5e: make non-Go raw progress.json consumers (fleet scripts + CI path globs) split-directory-safe
  • progress Backlog split C5f: replace coarse module buckets with the approved feature taxonomy
  • progress Backlog split C5g: explicitly classify every row into a valid feature module
  • progress Backlog split C5h: add module-scoped progress commands for planner and builder selection
  • progress Backlog split C5i: render per-module roadmap pages before the physical split
  • progress Backlog split C5: single atomic operator-gated flip to the module-keyed split directory
  • progress OpenCode part-cost telemetry adapter for builder loop
  • progress Progress next-work read-only selector
  • progress Progress next-work repo-scope filter
  • progress Internal topology guard for package consolidation
  • cli Internal CLI surface package rehome
  • tools Internal tool compact helper package rehome
  • tools Internal tool trace helper package rehome
  • tools Internal session search tool package rehome
  • progress Progress Control Plane staged deepening program
  • progress Progress workitem row classification seam
  • progress Progress Workspace layout and path seam
  • progress Progress write generated artifact plan
  • progress Progress projections for active handoff shipped evidence and health

8.G — Community & External Contributions ✅

Section titled “8.G — Community & External Contributions ✅”
  • docs Built-with-Gormes page scaffold
  • docs Upstream Hermes user-stories static mirror

Phase 9 — Design & Security Hardening ✅

Section titled “Phase 9 — Design & Security Hardening ✅”

Owned architecture improvements from DeerFlow patterns: declarative middleware chain for the agent runtime, and sandbox provider abstraction with virtual path security layer.

9.A — Declarative Agent Middleware Chain ✅

Section titled “9.A — Declarative Agent Middleware Chain ✅”
  • runtime Agent middleware chain framework

9.B — Sandbox Provider Abstraction + Virtual Path System ✅

Section titled “9.B — Sandbox Provider Abstraction + Virtual Path System ✅”
  • providers Sandbox provider interface and virtual path security

9.C — Hermes Config Parity — Personalities & Display ✅

Section titled “9.C — Hermes Config Parity — Personalities & Display ✅”
  • profiles Agent personalities + enhanced display config
  • stt Transcribe audio tool registration + local whisper provider
  • navivox Remove SSH Navivox stdio path
  • navivox Remove Flutter Navivox fake-server mode and wire protocol
  • navivox Remove Flutter SSH keys feature
  • navivox Navivox VPN host enumeration helper
  • navivox Navivox HTTP gateway mandatory-VPN bind
  • navivox Navivox HTTP gateway connect command
  • navivox Navivox setup QR image pairing handoff
  • navivox Navivox HTTP/WS documentation refresh
  • navivox Navivox connect-and-talk first screen
  • navivox Navivox profile contact summary API
  • navivox Navivox API capability contract
  • navivox Navivox continuous voice command mode
  • navivox Navivox Telegram-inspired chat polish
  • navivox Navivox natural-language profile seed backend API
  • navivox Navivox natural-language profile seed Flutter UI
  • navivox Navivox structured tool event cards backend API
  • navivox Navivox structured tool event cards Flutter UI
  • navivox Navivox safe config admin backend API
  • navivox Navivox safe config admin Flutter UI
  • navivox Navivox voice run records backend API
  • navivox Navivox voice run records Flutter inspection UI
  • navivox Navivox per-profile BYO voice profiles backend API
  • navivox Navivox per-profile BYO voice profiles Flutter UI

9.G — External Issue Radar Regression Guards ✅

Section titled “9.G — External Issue Radar Regression Guards ✅”
  • runtime PicoClaw-derived channel media and identity regression matrix
  • providers PicoClaw-derived session ledger read-model regression matrix
  • providers PicoClaw-derived provider stream and auth regression matrix
  • install PicoClaw-derived tool path safety regression pack
  • tools MCP Streamable HTTP session lifecycle compatibility
  • runtime Dynamic agent identity inheritance regression matrix

3.E.7 and 3.E.8 now have a frozen architecture target in docs/superpowers/plans/memory-identity/2026-04-22-gormes-phase3-identity-lineage-plan.md. The contract is user_id > chat_id > session_id, recall remains same-chat default, cross-chat recall is opt-in, and parent_session_id is reserved for compression/fork descendants instead of becoming a generic session rewrite mechanism.

Execution is now sequenced in docs/superpowers/plans/memory-identity/2026-04-22-gormes-phase3-identity-lineage-execution-plan.md, with the closeout order fixed as 3.E.6.1 -> 3.E.7.2 -> 3.E.8.1 -> 3.E.8.2 so freshness, fence safety, lineage metadata, and search/observability land in that order.


Before any Phase 4 coding starts, the Pre-Phase-4 E2E Gate must be green. Freeze the Hermes-backed hybrid baseline for delivery envelopes, <memory-context> fences, and transcript/export artifacts first, then follow the entry rule in Phase 4 — The Brain Transplant.


progress.json is the machine-readable source of truth. Top-level structure:

  • meta — schema version, last-updated timestamp, canonical URLs
  • phases — six phases keyed "1".."6", each containing subphases
  • each subphase carries either items (the normal case) or an explicit status

Stats (complete/in-progress/planned counts) are not stored — they are computed on render. Updated automatically on make build.