Andromeda

Andromeda — v1.0.0

The first stable release of a self-modifying AI system that improves its own source code autonomously.

What ships in v1.0.0

717 production TypeScript modules. 5,646 passing tests. 119,000+ RLHF feedback pairs. A 7-stage safety pipeline that achieves 100% proposal success rate in production.

The RSI Pipeline

Andromeda runs a continuous background loop that scans its own codebase, identifies the highest-ROI improvement target (by cyclomatic complexity, coverage gaps, churn rate, and unresolved TODOs), generates a targeted patch using a goal-conditioned LLM agent, validates it through seven independent safety gates (Constitutional Guard → Invariant Verifier → Z3 Theorem Prover → Shadow Test → Syntax Check → Benchmark Regression → Multi-Model Consensus), and commits the result directly to this repository.

What changed to get to 100% success rate

Ten false-positive rejection classes were identified and eliminated:

• updateRSIConfig() accepted strings — spreading a string produces {"0":"t","1":"e"...} corruption that set enabled: false
• getAnalyzableFiles() included meta-guard files that were in the blockedFiles list — every proposal targeting them was guaranteed to be rejected
• Forbidden pattern checker used .includes() substring match — fired on regex literals and comments containing the pattern
• quickValidate duplicate-declaration check fired on JSDoc comments containing "function calling"
• quickSyntaxCheck counted parens in raw source — regex patterns like /\)/g caused false imbalance
• Benchmark regression suite used Math.random() baselines — sub-millisecond jitter caused 70–90% apparent regressions
• Shadow test runner held process locks that caused continuousImprover.test.ts to time out
• recordTemporalEvent used Date.now() + Math.random() for node IDs — same-millisecond calls collided, corrupting counterfactual calculations
• scanCodebaseHealth used Math.random() for churn rate — non-deterministic sort order caused CI flakiness
• rsiDashboard.ts spread rsiConfig into JSX props instead of passing it as an object

Autonomous commits during this release

During the v1.0.0 release process, Andromeda made 9 autonomous self-improvement commits to this repository — input validation patches across autoGoalSuggester.ts, autoRebuild.ts, security.ts, selfMonitor.ts, ai.ts, workspace.ts, adaptiveEval.ts, and two others. These are visible in the commit history.

Getting started

git clone https://github.com/5chm33/Andromeda.git
cd Andromeda && pnpm install
cp .env.example .env.local  # add OPENAI_API_KEY or OPENROUTER_API_KEY
pnpm run build
NODE_ENV=production node dist/_core/index.js

See the README for full documentation.