Mindaeon Documentation & Architecture Overview

Mindaeon is a sovereign, multi-surface autonomous software engineering platform. Every surface — Mindaeon Desktop, Mindcode CLI, VS Code Extension, Chrome/Edge Browser Extension, Web Console, and Microsoft 365 Office Add-in — connects to a single governed Control Plane backed by PostgreSQL 18 Row-Level Security (RLS), OpenBao KMS transit encryption, Keycloak 26 OIDC, Gitea, SeaweedFS, and Open Policy Agent (OPA).

Core Architectural Differentiators

• 1,091 MiB Single-Host Air-Gapped Appliance: Runs all 7 stateful and stateless services in 48% of its 2,248 MiB memory budget with zero external telemetry.
• Host-Enforced Test Integrity Guard (100% Interception): Runs outside the agent sandbox to block test deletion, .skip/.only injection, assertion removal, and snapshot tampering before any commit is accepted.
• Changed-Surface AST Mutation Gate (p95 = 3.77 ms): Generates deterministic AST mutants on modified lines to verify that newly written tests genuinely fail when production logic is broken.
• Parallel Worktree Collision Radar (76% Conflict Reduction): Continuously executes background Shadow Merge dry-runs across active git worktrees in Desktop and Control Plane.
• Cross-Repo Contract Radar & Atomic Rollback Sagas (100% Recall): Detects breaking OpenAPI, GraphQL, Protobuf, and TypeScript contract changes and orchestrates topological multi-repo PR sagas.
• Hybrid Code Intelligence (71.2% Token Reduction): Combines Tree-sitter ASTs, SCIP/LSP symbol call graphs, and pgvector embeddings via Reciprocal Rank Fusion (94% symbol recall).

Quick Links