How noobru/codex-infra works
CodexInfra turns project context and an engineering objective into bounded, validated work, then records evidence and results. Its dashboard is a read-only query layer; separate branches cover executable learning, efficiency/history, and security. The README documents these capabilities, while the source excerpts and index establish only some internal calls, so unsampled subsystem links are omitted rather than inferred.
Main entry points: engine.ts Execution engine · autonomous-learning.ts Learning coordinator · supervisor.ts Job supervisor · queue.ts Shared queue
Components 26
Work coordination
- Execution engine
src/engine.ts - Task contracts
src/task-contract.ts - Job supervisor
src/supervisor.ts - Shared queue
src/queue.ts - Codex worker
src/codex-worker.ts - Workflow runner
src/workflow.ts - Execution state
src/state.ts - Model routing
src/routing.ts - Evidence sanitizer
src/evidence.ts - Shared file utilities
src/legacy/command-os-utils.js
Project context
- Project registry
src/registry.ts - Context selection
src/context-pack.ts - Knowledge learning
src/knowledge-learning.ts
Executable learning
- Learning coordinator
src/autonomous-learning.ts - Learning store
src/knowledge-store.ts - Capability runtime
src/learning-runtime.ts - Evaluation
src/evaluation.ts - Capability builder
src/learning-builder.ts - Isolated testing
src/learning-sandbox.ts
Observation and history
- Observation service
src/observability.ts - Efficiency history
src/efficiency-history.ts - Security reports
src/security-report-service.ts
User interfaces
- Dashboard UI
ui/src/Home.tsx - Dashboard API client
ui/src/api.ts - Dashboard panels
ui/src/components.tsx
Other components
- Project owner
Connections 25
- Project owner → Execution engine: submits objective
README.md - Execution engine → Project registry: loads project context
src/engine.ts - Execution engine → Task contracts: builds contract
src/engine.ts - Execution engine → Knowledge learning: augments context
src/engine.ts - Execution engine → Context selection: builds context pack
src/engine.ts - Execution engine → Job supervisor: dispatches job
src/engine.ts - Execution engine → Execution state: persists execution
src/engine.ts - Job supervisor → Shared queue: uses queue
src/supervisor.ts - Job supervisor → Codex worker: starts work
- Shared queue → Workflow runner: runs workflows
src/queue-worker.ts - Shared queue → Learning coordinator: runs learning
src/queue-worker.ts - Codex worker → Model routing: selects model
src/codex-worker.ts - Codex worker → Evidence sanitizer: sanitizes results
src/codex-worker.ts - Learning coordinator → Learning store: reads and writes
src/autonomous-learning.ts - Learning coordinator → Capability builder: builds capabilities
src/autonomous-learning.ts - Learning coordinator → Isolated testing: tests capabilities
src/autonomous-learning.ts - Learning coordinator → Capability runtime: coordinates activation
src/autonomous-learning.ts - Knowledge learning → Learning store: uses store
src/knowledge-learning.ts - Knowledge learning → Evaluation: uses evaluations
src/knowledge-learning.ts - Dashboard UI → Dashboard API client: requests observations
ui/src/Home.tsx - Dashboard UI → Dashboard panels: renders panels
ui/src/Home.tsx - Dashboard API client → Observation service: queries views
ui/src/api.ts - Observation service → Execution state: reads state
src/observability.ts - Efficiency history → Execution state: reads history data
src/efficiency-history.ts - Security reports → Project registry: uses project registry
src/security-report-service.ts