How artyomsv/code-spire works
Code Spire is a self-hosted, event-driven AI pull-request reviewer. The main workflow is SCM webhook ingress, event-driven review orchestration, worker-side review, and operator visibility in the dashboard. The repository also includes work-item/run execution, configurable SCM and context-provider integrations, and operator configuration capabilities. Service responsibilities and message flow are based on the README; sampled source confirms lifecycle event persistence and rerun dispatch, but several subsystem internals were not sampled.
Main entry points: ReviewWorker.java Review worker · WorkRunWorker.java Run worker · App.tsx Operator dashboard · orchestrator Review orchestrator
Components 21
Webhook ingress
- Webhook gateway
spire-gateway/src/main/java/dev/codespire/gateway - Integration events
spire-contract/src/main/java/dev/codespire/contract/event/IntegrationEvent.java
Review orchestration
- Kafka event bus
- Review orchestrator
spire-orchestrator/src/main/java/dev/codespire/orchestrator - Review lifecycle
spire-orchestrator/src/main/java/dev/codespire/orchestrator/lifecycle/ReviewLifecycleService.java - Event store
spire-orchestrator/src/main/java/dev/codespire/orchestrator/eventstore/JdbcEventStore.java - Review read model
spire-orchestrator/src/main/java/dev/codespire/orchestrator/readmodel/ReviewProjection.java
Review and run execution
- Review worker
spire-review-worker/src/main/java/dev/codespire/worker/pipeline/ReviewWorker.java - Run worker
spire-run-worker/src/main/java/dev/codespire/runworker/WorkRunWorker.java - Agent harness
spire-harness/src/main/java/dev/codespire/harness - Docker runtime
spire-runtime-docker/src/main/java/dev/codespire/runtime/docker/DockerRunRuntime.java
Provider extensions
- SCM adapters
spire-scm-github/src/main/java/dev/codespire/scm/github/GitHubClient.java - LLM provider
spire-llm/src/main/java/dev/codespire/llm/LangChain4jLlmProvider.java - Code context
spire-context-code/src/main/java/dev/codespire/context/code/CodeContextProvider.java - Issue context
spire-context-jira/src/main/java/dev/codespire/context/jira/JiraContextProvider.java - Confluence context
spire-context-confluence/src/main/java/dev/codespire/context/confluence/ConfluenceContextProvider.java
Operator experience
- Operator dashboard
spire-ui/src/App.tsx - Live review feed
spire-ui/src/useLiveReviews.ts - Work-item features
spire-contract/src/main/java/dev/codespire/contract/work/WorkItemLifecycle.java
Other components
- Operator
- Git platforms
Connections 23
- Git platforms → Webhook gateway: sends webhooks
README.md - Webhook gateway → Integration events: translates events
README.md - Webhook gateway → Kafka event bus: publishes integration
README.md - Kafka event bus → Review orchestrator: delivers events
README.md - Review orchestrator → Review lifecycle: handles lifecycle
spire-orchestrator/src/main/java/dev/codespire/orchestrator/lifecycle/ReviewLifecycleService.java - Review lifecycle → Event store: loads and appends
spire-orchestrator/src/main/java/dev/codespire/orchestrator/lifecycle/ReviewLifecycleService.java - Review orchestrator → Kafka event bus: emits commands
README.md - Kafka event bus → Review worker: delivers commands
README.md - Review worker → Kafka event bus: publishes results
README.md - Kafka event bus → Run worker: delivers run commands
README.md - Run worker → Kafka event bus: publishes run result
README.md - Run worker → Agent harness: drives agent
README.md - Run worker → Docker runtime: builds run unit
README.md - Review worker → SCM adapters: fetches and comments
- Review worker → LLM provider: requests review
- Review worker → Code context: gathers context
- Review worker → Issue context: gathers context
- Review worker → Confluence context: gathers context
- Operator → Operator dashboard: views and configures
README.md - Operator dashboard → Live review feed: renders feed
spire-ui/src/App.tsx - Live review feed → Review read model: fetches reviews
README.md - Operator dashboard → Review orchestrator: uses API and sockets
README.md - Operator dashboard → Work-item features: manages work
spire-ui/src/App.tsx