Repository Map

This page maps every audited GitHub repository to its role in the AlphaSwarm system. Repository links are canonical traceability anchors.

Summary counts

• Repositories audited: 39 (as of the 2026-07-14 audit). Two repositories — alphaswarm_internal and alphaswarm_qap — have since been created and are checked out alongside the others; they are listed in the catalog below but were not part of the original 39-repo audit pass. Current total: 41.
• Primary language distribution: Python-heavy backend/control plane; TypeScript-heavy frontend/IDE surfaces; YAML/Terraform/Helm concentrated in platform and deployment repos.
• Central docs target: alphaswarm_docs
• Existing internal docs path in target repo: docs/internal/

Catalog

Repository	Domain	Purpose / system position	Default branch	Status signal
alphaswarm	Monolith / platform library	Main AlphaSwarm platform library and legacy integration surface; still carries major RLS, DataOps, strategies, and release-note workflows.	main	16 open issue titles audited; highest technical-debt concentration.
alphaswarm_admin	Staff admin	Internal admin service and UI for AlphaSwarm staff; linked to tenant onboarding/admin operations.	development	Python + TypeScript; Docker and frontend manifests present.
alphaswarm_agents	Agent runtime	Standalone AgentSpec/AgentRuntime package, hash-locked specs, research/selection/trader/analysis crews, agentic testing/debugging.	main	3 open debt issues; package-boundary/runtime robustness items.
alphaswarm_api	API edge	Gateway/composition surface for AlphaSwarm APIs; explicitly should not own privileged deployment logic.	main	Generated/IDE artifact cleanup open.
alphaswarm_assistant	Agent assistants	Custom agentic assistants for platform workflows.	main	No open issues in title audit.
alphaswarm_auth	Identity	Provider-agnostic authentication/authorization service; Entra/GitHub/WebAuthn adapters, RBAC, device hub, software CA.	main	Critical identity boundary; no open issues in title audit.
alphaswarm_bots	Bots	Bot infrastructure for the platform; Python service with Docker/Makefile and CI.	main	Repo metadata shows 3 open issues.
alphaswarm_catalog	Data catalog	Dedicated catalog repository; currently documentation-light in static audit.	main	No open issues.
alphaswarm_cli	Developer/operator CLI	CLI for setup, platform control, agents, and operator workflows.	main	One issue requesting PR approval for loading/YubiKey/error fixes.
alphaswarm_client	Local UI	Vite/local operator client for power users; separate from hosted UI and public website.	main	P0 hosted demo-mode deployment issue.
alphaswarm_config	Configuration	Configuration provider subsystem for hybrid/distributed deployment paradigms.	main	Boundary and validation debt open.
alphaswarm_controller	Control plane	Resource controller for workload lifecycle and control APIs.	main	Seeded demo workspace lifecycle issue.
alphaswarm_core	Core contracts	Dependency-light core definitions, abstractions, specifications, observability-compatible contracts.	main	No open issues.
alphaswarm_data	Data plane	Market-data providers, catalog/index, KG sync, interactive analysis, FastAPI app and CLI.	main	No open issues; Kubernetes deployment lives in platform repo.
alphaswarm_docs	Documentation	Docusaurus/Fern/OpenAPI documentation site, changelog automation, internal docs.	development	One stale-readiness-docs issue; recommended publication target.
alphaswarm_eval	Evaluation	Dependency-light continuous-evaluation engine with deterministic/extensible scorers and EVAL telemetry.	main	No open issues.
alphaswarm_finops	Billing / cost	Billing, credit/token, SaaS monitoring, provider pattern used by data credentials.	main	No open issues.
alphaswarm_graph	Knowledge graph	Knowledge graph codebase, graph sync and graph-oriented services.	main	Metadata shows 1 open issue.
alphaswarm_ide	IDE	Custom AlphaSwarm IDE based on Theia/Electron/browser packages and MCP/quant extensions.	main	P0 go-live checklist issue.
alphaswarm_index	Agent index	Agent development assistant index; currently documentation-oriented.	main	No open issues.
alphaswarm_ingest	Ingestion	Ingestion plane for AlphaSwarm data flows.	main	No open issues.
alphaswarm_internal	Internal reference / planning	Consolidated internal engineering reference (architecture, deployment, testing-framework blueprint, cross-repo plan archive) and implementation backlog; not part of the original 2026-07-14 audit.	development	Not covered by the 2026-07-14 issue-title audit.
alphaswarm_kb	Knowledge base	Trading/finance knowledge base and RAG ingest.	main	Parser provenance/hash drift issue.
alphaswarm_kb_federation	KB federation	Multi-tenancy siloing and federated knowledgeable access; Helm and Docker deployment artifacts.	main	Retrieval/federation span gap issue.
alphaswarm_learning	Continuous learning	Human and agent learning resources, Scholar workflows, graph/LLM production data paths.	main	P0 TODO stubs and test failures.
alphaswarm_local	Hybrid/local deployment	Local resources for hybrid deployments; Compose and Helm artifacts.	main	No open issues.
alphaswarm_mcp	MCP	MCP server for AlphaSwarm tools and integrations.	main	P0 production hardening issue.
alphaswarm_mlops	MLOps/LLMOps/AgentOps	Governance/control plane for registry, eval gates, serving/lineage, model/prompt/dataset cards.	main	No open issues; scaffolded/documentation-hydrated.
alphaswarm_models	Models	Custom LLM/model training, tuning, and evaluation library.	main	No open issues.
alphaswarm_observe	Observability	Monitoring and observability subsystem; Python SDK/service with Helm and Compose.	main	Eval/lineage/read API and registry/alert/replay milestones open.
alphaswarm_observe_js	Frontend observability	Privacy-first TypeScript observability SDK for UI/client/IDE, wire-compatible with core observe.	main	No open issues.
alphaswarm_ops_console	Ops console	Standalone deployment console for local Compose and production Kubernetes actions; privileged ops isolated from API edge.	main	No open issues; safety model is configuration-driven argv actions.
alphaswarm_orchestration	Orchestration	Portable Dagster/Prefect orchestration authority and immutable task-graph contracts.	main	No open issues.
alphaswarm_platform	Hosted platform / IaC	Hosted AlphaSwarm platform, tenant router, Helm/Kubernetes, Terraform, templates, pipelines, edge auth.	development	P0 go-live deployment prerequisites and CD runbook open.
alphaswarm_qap	Quantitative Agent Platform (clean room)	Clean-room workspace for a new Quantitative Agent Platform: uv/pnpm workspace, package attestations, license/identifier/state policy gates; legal clean-room attestation deliberately pending. Not part of the original 2026-07-14 audit.	development	Not covered by the 2026-07-14 issue-title audit.
alphaswarm_research	Research plane	Services for research plane.	main	Observability instrumentation issue.
alphaswarm_rl	Reinforcement learning	AlphaStream reinforcement-learning project.	main	Metadata shows 1 open issue.
alphaswarm_ui	Hosted app UI	Authenticated multi-tenant PaaS operator dashboard; Entra-only login; BFF proxies to API/control plane.	development	P0 replace mocks with backend-backed data and E2E coverage.
alphaswarm_viz	Visualization	Python visualization package.	main	No open issues.
alphaswarm_website	Marketing site	Public-facing marketing/docs/legal/product site; separated from authenticated app.	main	No open issues.
alphaswarm_worker	Worker nodes	Standalone worker node image/source; OAuth device flow, device registration, Celery, optional Ray/Dask/Spark/Kafka/Flink nodes.	main	No open issues.

Naming conventions

• Repository names use alphaswarm_<domain> for standalone packages and alphaswarm for the main platform library.
• Documentation should refer to repositories by exact GitHub repo name on first use, then by domain alias.
• Service names in diagrams should use repo-aligned labels where possible to preserve traceability.