Skip to main content

Status and maturity

Feature maturity matrix for Swarm 357.

TechTide Swarm 357: Feature Status

Maturity levels:

  • Stable - tested, documented, safe for production use under stated constraints
  • Beta - working but evolving; API may change
  • Experimental - functional but incomplete or opt-in
  • Not implemented - explicitly out of scope for the current release

Product framing

Swarm 357 is a 357-role catalog plus orchestration runtime, not a production-complete autonomous agent platform. Operators own API keys, budgets, and side-effect approvals.

Core package (packages/techtide-swarm/)

FeatureStatusNotes
Agent - single-agent runnerStableLive API when keyed; explicit SWARM_SIMULATE / SWARM_ALLOW_STUB otherwise (no silent success)
AgentConfigStablePydantic v2
Swarm orchestrationBetaStructured JSON routing; durable RunState + SQLite checkpoints
execute_layer()BetaOne-per-role default, hard agent cap; full_fanout / SWARM_UNSAFE_FULL_FANOUT opt-in
Atomic BudgetLedgerBetaReserve/commit under asyncio lock
CostControllerBetaLayer spend + 80% model downgrade
MemoryManager flat filesStableTopics share/recall
Memvid .mv2 via bridgeBetaRequires memvid-swarm-bridge (crates.io memvid-core)
run_dream_cycle()ExperimentalHeuristics; not guaranteed consolidate/prune
BashSecurityGate + argv policyStableServer/prod denies Bash unless SWARM_ALLOW_BASH=1
Read/Write workspace confinementStableServer mode confines to workspace root
HTTP APIBetaFail-closed auth in production; non-200 errors; SSE events
HITL approvalsBetaReal Bash gate (SWARM_HITL_BASH); swarm approve/reject + HTTP; timeout rejects
SSE event streamBetaAuth when SWARM_API_KEY set; bus closes on terminal run; stream.end
Structured tracesBeta.swarm/traces.jsonl; optional OTel via SWARM_OTEL_EXPORT=1
UltraPlanBetaOpus-class planning when keyed

CLI

CommandStatusNotes
swarm initStableInstalls bundled compact config + Support souls
swarm demoStableExplicit simulation without key
swarm boot / runBetaResolves bundled config from wheel installs
swarm inspect/resume/cancel/approve/reject/replay/forkBetaDurable cancel flag + HITL control plane
swarm evalBetaSeparate single vs swarm reporting
swarm serveBetaFastAPI

Infrastructure

FeatureStatusNotes
CIStable.github/workflows/ci.yml - Python 3.10-3.13, roster, wheel smoke, Docker auth, Rust, docs ban check
PyPI publishBetapublish.yml with attestations; CI gate before publish
Landing siteBetaDocs at https://swarm357fe.up.railway.app/docs; source in TechTideOhio/swarm-357-site
Branch protection / scanningBetaOperator-applied on GitHub (see RELEASE.md)

Not implemented

  • Multi-tenant SaaS control plane / SSO
  • Distributed rate limiting across many replicas (single-process limiter ships)
  • Guaranteed dream-cycle consolidation quality
  • Full Opik cloud observability (local JSONL is source of truth)