How sntl84/velocity works
Open Velocity’s implemented core is a backend for agentic development: requests enter through the server or CLI, the orchestrator creates and runs agents, and agents use a model gateway and development tools to carry out tasks. Supporting stages include policy checks, shared swarm coordination, memory snapshots, artifact storage, auditing, and persistent database state. The README describes several backend capabilities whose implementation is present in the tree but was not sampled; those links are identified as documented rather than source-verified.
Main entry points: agent.ts Agent runtime · orchestrator/index.ts Agent orchestrator · tables Domain tables · gateway/index.ts Model gateway
Components 19
Entry points
- HTTP server
newcore/src/server.ts - CLI commands
newcore/src/cli.ts
Agent execution
- Agent orchestrator
newcore/src/orchestrator/index.ts - Agent runtime
newcore/src/orchestrator/agent.ts - Model gateway
newcore/src/gateway/index.ts - LLM providers
newcore/src/gateway/providers/anthropic.ts - Tool registry
newcore/src/tools/index.ts - Development tools
newcore/src/tools/z3-solver.ts
Swarm coordination
- Swarm message bus
newcore/src/orchestrator/messagebus.ts - File lock manager
newcore/src/orchestrator/locks.ts
Agent services
- Safety policy
newcore/src/policy/index.ts - Agent memory
newcore/src/memory/liquid.ts - Memory snapshots
newcore/src/memory/snapshot.ts - Artifact store
newcore/src/artifacts/index.ts - Audit logger
newcore/src/audit/index.ts - Configuration
newcore/src/config/index.ts
Persistence
- SQLite database
newcore/src/db/index.ts - Domain tables
newcore/src/db/tables
Other components
- Developer / client
Connections 27
- Developer / client → HTTP server: sends requests
README.md - Developer / client → CLI commands: runs commands
README.md - HTTP server → Agent orchestrator: routes requests
newcore/src/server.ts - CLI commands → Agent orchestrator: uses engine
README.md - Agent orchestrator → Agent runtime: creates agents
newcore/src/orchestrator/index.ts - Agent orchestrator → Model gateway: constructs gateway
newcore/src/orchestrator/index.ts - Agent orchestrator → Tool registry: constructs registry
newcore/src/orchestrator/index.ts - Agent orchestrator → Artifact store: constructs store
newcore/src/orchestrator/index.ts - Agent orchestrator → Audit logger: constructs logger
newcore/src/orchestrator/index.ts - Agent orchestrator → Safety policy: constructs policy
newcore/src/orchestrator/index.ts - Agent runtime → Model gateway: requests completions
newcore/src/orchestrator/agent.ts - Agent runtime → Tool registry: executes tools
newcore/src/orchestrator/agent.ts - Agent runtime → Artifact store: creates artifacts
newcore/src/orchestrator/agent.ts - Agent runtime → Audit logger: logs actions
newcore/src/orchestrator/agent.ts - Agent runtime → Safety policy: checks actions
newcore/src/orchestrator/agent.ts - Tool registry → Development tools: registers tools
newcore/src/tools/index.ts - Model gateway → LLM providers: registers providers
newcore/src/gateway/index.ts - Agent runtime → SQLite database: persists state
newcore/src/orchestrator/agent.ts - Agent runtime → Memory snapshots: saves snapshots
newcore/src/orchestrator/agent.ts - Memory snapshots → Agent memory: snapshots state
newcore/src/memory/snapshot.ts - Artifact store → Domain tables: indexes artifacts
newcore/src/artifacts/index.ts - Audit logger → Domain tables: persists events
newcore/src/audit/index.ts - Domain tables → SQLite database: queries database
newcore/src/db/tables/agents.ts - Swarm message bus → Domain tables: stores messages
README.md - File lock manager → Domain tables: stores locks
README.md - Model gateway → Domain tables: records costs
newcore/src/gateway/index.ts - HTTP server → Configuration: loads settings
newcore/src/server.ts