# Architecture

## Purpose

Commit Intelligence Service owns commit-level analysis: impacted symbols, changed files, and a short summary from graph deltas produced by Code Parser.

## Boundaries

- **Redis consumers:** `graph.artifact.ready` (ACK only), `graph.delta.ready` (full analysis)
- **Redis producer:** `commit.analysis.ready`
- **Artifact reader:** read-only JSON deltas/artifacts from `ARTIFACT_STORE_PATH`
- **REST:** health/readiness + debug (`/analysis-jobs`, `/analysis`)
- No repository sync, source parsing, or graph delta computation

## Runtime flow

```text
graph.delta.ready
  → consumer (commit-intelligence-service group)
  → ProcessGraphDeltaReady
  → FilesystemReader (delta JSON)
  → DeltaImpactAnalyzer
  → AnalysisStore (in-memory jobs/results)
  → publisher (commit.analysis.ready)

graph.artifact.ready
  → consumer → validate → ACK (cache/analysis deferred)
```

## Dependencies

- Redis Streams (input/output)
- Code Parser artifact/delta files on disk (`ARTIFACT_STORE_PATH`)
- Local contracts in `internal/contracts/`