How joeydd032995-pixel/yeslumby works
Meta-Ecosystem Runtime compiles versioned Architecture Genomes into executable AI organizations. The primary workflow is to select a genome, execute a durable run, stream its progress and result, then assess and evolve genome versions through mutation, comparison, breeding, and promotion. The runtime separates run-scoped context from ecosystem knowledge and evolutionary memory. The README documents benchmarking as a major capability, but the provided tree contains no benchmark package, so it is not expanded into an implementation node. Edges are limited to explicit README statements and shown source references; several UI and evolution relationships are documented rather than excerpted in implementation detail.
Main entry points: machine.ts Round machine · schema.ts Genome schema · evolve.ts Evolution engine · orchestrator.ts Run orchestrator
Components 28
Web application
- Ecosystem UI
apps/web/src/app/e/[id]/page.tsx - Evolution UI
apps/web/src/app/e/[id]/evolution/page.tsx - Run stream route
apps/web/src/app/api/runs/[runId]/stream/route.ts
Genome modeling
- Genome schema
packages/genome/src/schema.ts - Genome validation
packages/genome/src/validate.ts - Genome patches
packages/genome/src/patches.ts - Genome templates
packages/genome/src/templates.ts
Run execution
- Run orchestrator
packages/runtime/src/orchestrator.ts - Round machine
packages/runtime/src/machine.ts - Durable journal
packages/runtime/src/journal.ts - Context stage
packages/runtime/src/stages/context.ts - Proposal stage
packages/runtime/src/stages/proposals.ts - Challenge stage
packages/runtime/src/stages/challenges.ts - Falsification stage
packages/runtime/src/stages/falsification.ts - Synthesis stage
packages/runtime/src/stages/synthesis.ts - Watcher evaluation
packages/runtime/src/stages/watcher.ts
Memory and evolution
- Knowledge memory
packages/memory/src/recall.ts - Memory consolidation
packages/memory/src/consolidate.ts - Evolution engine
packages/evolution/src/evolve.ts - Mutation engine
packages/evolution/src/mutate.ts - Genome breeding
packages/evolution/src/breed.ts - Genome recommendation
packages/evolution/src/recommend.ts
Persistence and providers
- Postgres stores
packages/db/src/repositories/runs.ts - Model gateway
packages/gateway/src/gateway.ts - Deterministic provider
packages/gateway/src/simulator.ts - OpenRouter provider
packages/gateway/src/openrouter.ts - AI Gateway provider
packages/gateway/src/ai-gateway.ts
Other components
- Operator
Connections 31
- Operator → Ecosystem UI: configures ecosystem
apps/web/src/app/e/[id]/page.tsx - Operator → Evolution UI: reviews evolution
apps/web/src/app/e/[id]/evolution/page.tsx - Ecosystem UI → Genome schema: loads genome
apps/web/src/app/e/[id]/page.tsx - Evolution UI → Genome schema: views versions
apps/web/src/app/e/[id]/evolution/page.tsx - Run stream route → Postgres stores: loads run
apps/web/src/app/api/runs/[runId]/stream/route.ts - Run stream route → Genome schema: parses genome
apps/web/src/app/api/runs/[runId]/stream/route.ts - Run stream route → Run orchestrator: starts run
apps/web/src/app/api/runs/[runId]/stream/route.ts - Run orchestrator → Round machine: executes rounds
packages/runtime/src/orchestrator.ts - Round machine → Context stage: dispatches stage
packages/runtime/src/machine.ts - Round machine → Proposal stage: dispatches stage
packages/runtime/src/machine.ts - Round machine → Challenge stage: dispatches stage
packages/runtime/src/machine.ts - Round machine → Falsification stage: dispatches stage
packages/runtime/src/machine.ts - Round machine → Synthesis stage: dispatches stage
packages/runtime/src/machine.ts - Round machine → Watcher evaluation: dispatches stage
packages/runtime/src/machine.ts - Context stage → Knowledge memory: recalls knowledge
packages/runtime/src/stages/context.ts - Run orchestrator → Postgres stores: finishes run
packages/runtime/src/orchestrator.ts - Round machine → Durable journal: replays steps
packages/runtime/src/machine.ts - Context stage → Durable journal: persists stage
packages/runtime/src/stages/context.ts - Evolution engine → Mutation engine: proposes mutation
packages/evolution/src/evolve.ts - Evolution engine → Run orchestrator: runs generation
packages/evolution/src/evolve.ts - Evolution engine → Memory consolidation: records lessons
packages/evolution/src/evolve.ts - Evolution engine → Postgres stores: promotes version
packages/evolution/src/evolve.ts - Mutation engine → Genome patches: applies patches
packages/evolution/src/mutate.ts - Mutation engine → Knowledge memory: uses evolutionary memory
packages/evolution/src/mutate.ts - Genome breeding → Genome schema: combines genomes
packages/evolution/src/breed.ts - Genome recommendation → Knowledge memory: uses learned structures
- Model gateway → Deterministic provider: selects provider
packages/gateway/src/index.ts - Model gateway → OpenRouter provider: selects provider
- Model gateway → AI Gateway provider: selects provider
- Genome templates → Genome schema: builds genome
packages/genome/src/templates.ts - Genome validation → Genome schema: validates genome
packages/genome/src/validate.ts