Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
58 lines (47 loc) · 1.9 KB

ARCHITECTURE.md

File metadata and controls

58 lines (47 loc) · 1.9 KB

AutoLoop Architecture

This document is a concise map of the current system using neutral engineering terms.

Runtime Flow

  1. CLI receives intent (src/main.rs).
  2. AutoLoopApp assembles runtime subsystems (src/lib.rs).
  3. Orchestration runs intent clarification -> strategy planning -> swarm execution (src/orchestration/mod.rs).
  4. Runtime guard and verifier enforce bounded execution (src/runtime/mod.rs).
  5. Knowledge and learning artifacts persist through the SpacetimeDB adapter.

Core Modules

  • src/orchestration/
    • Intent clarification, planning, debate rounds, route selection, validation.
  • src/runtime/
    • Runtime guard, circuit breaker state, evaluation, verifier logic.
  • src/providers/
    • OpenAI-compatible HTTP provider abstraction and model routing.
  • src/tools/
    • Tool registry and forged capability catalog.
  • src/research/
    • Anchor-driven research execution backends and data acquisition.
  • src/rag/
    • GraphRAG snapshot/update/retrieval and graph signals.
  • src/memory/
    • Learning assets and memory retrieval/consolidation.
  • src/observability/
    • Route analytics, failure forensics, dashboard artifacts.
  • src/dashboard_server.rs
    • Minimal HTTP + SSE backend for snapshot/replay/governance UX.

Data and Storage

  • Primary runtime record layer: autoloop-spacetimedb-adapter/
  • SpacetimeDB module crate: spacetimedb/
  • Local runtime artifacts: deploy/runtime/

Frontend Control Surface

  • Location: dashboard-ui/
  • Stack: Vue 3 + TypeScript + Vite
  • Features:
    • Capability operations
    • Session replay
    • Graph overlays
    • SSE event updates
    • Operator settings (language/vendor/base URL/model/API key)

Deployment Surfaces

  • Local scripts and templates: deploy/
  • K8s manifests: deploy/k8s/
  • Monitoring templates: deploy/monitoring/
  • One-command startup scripts:
    • deploy/scripts/start-autoloop.ps1
    • deploy/scripts/start-autoloop.sh