11# AutoLoop Architecture
22
3- This document is a concise map of the current system.
3+ This document is a concise map of the current system using neutral engineering terms .
44
55## Runtime Flow
66
7- 1 . CLI receives intent (` main.rs ` ).
7+ 1 . CLI receives intent (` src/ main.rs` ).
882 . ` AutoLoopApp ` assembles runtime subsystems (` src/lib.rs ` ).
9- 3 . Orchestration drives requirement -> CEO -> swarm -> execution (` src/orchestration/mod.rs ` ).
10- 4 . Runtime guard/ verifier enforce bounded execution (` src/runtime/mod.rs ` ).
11- 5 . Knowledge and learning artifacts are persisted through SpacetimeDB adapter.
9+ 3 . Orchestration runs intent clarification -> strategy planning -> swarm execution (` src/orchestration/mod.rs ` ).
10+ 4 . Runtime guard and verifier enforce bounded execution (` src/runtime/mod.rs ` ).
11+ 5 . Knowledge and learning artifacts persist through the SpacetimeDB adapter.
1212
1313## Core Modules
1414
1515- ` src/orchestration/ `
16- - Swarm planning, debate rounds, route selection, validation.
16+ - Intent clarification, planning, debate rounds, route selection, validation.
1717- ` src/runtime/ `
18- - Runtime guard, circuit breaker state, evaluation and verifier logic.
18+ - Runtime guard, circuit breaker state, evaluation, verifier logic.
1919- ` src/providers/ `
2020 - OpenAI-compatible HTTP provider abstraction and model routing.
2121- ` src/tools/ `
22- - Tool registry, forged MCP capability governance .
22+ - Tool registry and forged capability catalog .
2323- ` src/research/ `
24- - Research execution backends and anchor-driven data acquisition.
24+ - Anchor-driven research execution backends and data acquisition.
2525- ` src/rag/ `
2626 - GraphRAG snapshot/update/retrieval and graph signals.
2727- ` src/memory/ `
2828 - Learning assets and memory retrieval/consolidation.
2929- ` src/observability/ `
3030 - Route analytics, failure forensics, dashboard artifacts.
3131- ` src/dashboard_server.rs `
32- - Minimal HTTP + SSE backend for dashboard snapshots /replay/governance.
32+ - Minimal HTTP + SSE backend for snapshot /replay/governance UX .
3333
3434## Data and Storage
3535
36- - Primary runtime record layer: SpacetimeDB adapter ( ` autoloop-spacetimedb-adapter ` ).
37- - SpacetimeDB module crate: ` spacetimedb/ ` .
38- - Runtime dashboard/replay artifacts: ` deploy/runtime/ ` (local operational outputs).
36+ - Primary runtime record layer: ` autoloop-spacetimedb-adapter/ `
37+ - SpacetimeDB module crate: ` spacetimedb/ `
38+ - Local runtime artifacts: ` deploy/runtime/ `
3939
40- ## Frontend Control Plane
40+ ## Frontend Control Surface
4141
4242- Location: ` dashboard-ui/ `
4343- Stack: Vue 3 + TypeScript + Vite
4444- Features:
45- - Capability governance actions
45+ - Capability operations
4646 - Session replay
47- - Graph canvas overlays
47+ - Graph overlays
4848 - SSE event updates
4949 - Operator settings (language/vendor/base URL/model/API key)
5050
@@ -56,4 +56,3 @@ This document is a concise map of the current system.
5656- One-command startup scripts:
5757 - ` deploy/scripts/start-autoloop.ps1 `
5858 - ` deploy/scripts/start-autoloop.sh `
59-
0 commit comments