# harshavr8/release-readiness-copilot architecture

> Architecture diagram of the GitHub repository harshavr8/release-readiness-copilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshavr8/release-readiness-copilot
- Repository: https://github.com/harshavr8/release-readiness-copilot

## Overview

Release-Readiness Copilot evaluates seeded commit and test-run data, classifies failures, optionally reconsiders uncertain results using later-commit context, and produces a scored go/no-go report. The graph definition owns workflow routing; its node implementations call the MCP client, classifier, and report logic. The MCP server reads the seeded JSON inputs, while the entry point saves report files. The README documents these capabilities; connections not shown in the excerpts are omitted.

Main entry points: [`graph/nodes.py`](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py) (Classify Failures), [`run.py`](https://github.com/harshavr8/release-readiness-copilot/blob/main/run.py) (Run Entry Point), [`graph/pipeline.py`](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/pipeline.py) (LangGraph Workflow), [`mcp_server/server.py`](https://github.com/harshavr8/release-readiness-copilot/blob/main/mcp_server/server.py) (MCP Tools Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Workflow"]
  node_runner["Run Entry Point<br/>[run.py]"]
  node_workflow["LangGraph Workflow<br/>[pipeline.py]"]
  node_state["Shared Graph State<br/>[state.py]"]
  node_commit_fetch["Fetch Commits<br/>[nodes.py]"]
  node_test_fetch["Fetch Test Runs<br/>[nodes.py]"]
  node_first_classification["Classify Failures<br/>[nodes.py]"]
  node_context_review["Gather More Context<br/>[nodes.py]"]
  node_reclassification["Reclassify Failures<br/>[nodes.py]"]
  node_report_node["Build Report Node<br/>[nodes.py]"]
end

subgraph group_inputs["Evidence Inputs"]
  node_commits_data["Seeded Commits<br/>[commits.json]"]
  node_tests_data["Seeded Test Runs<br/>[test_runs.json]"]
end

subgraph group_analysis["Analysis and Reporting"]
  node_classifier["Failure Classifier<br/>[classifier.py]"]
  node_report_logic["Scoring and Rendering<br/>[report.py]"]
  node_saved_reports["Saved Reports<br/>[.gitkeep]"]
end

subgraph group_mcp["MCP Data Access"]
  node_mcp_client["MCP Client<br/>[mcp_client.py]"]
  node_mcp_server["MCP Tools Server<br/>[server.py]"]
end

node_engineer(("Release Engineer"))
node_claude(("Claude API"))

node_engineer -->|"runs"| node_runner
node_runner -->|"invokes"| node_workflow
node_workflow -->|"uses state"| node_state
node_workflow -->|"starts with"| node_commit_fetch
node_commit_fetch -->|"then runs"| node_test_fetch
node_test_fetch -->|"then runs"| node_first_classification
node_first_classification -->|"routes if uncertain"| node_context_review
node_first_classification -->|"routes if resolved"| node_report_node
node_context_review -->|"then runs"| node_reclassification
node_reclassification -->|"loops if uncertain"| node_context_review
node_reclassification -->|"routes if resolved"| node_report_node
node_commit_fetch -->|"requests commits"| node_mcp_client
node_test_fetch -->|"requests test runs"| node_mcp_client
node_mcp_client -->|"calls tools"| node_mcp_server
node_mcp_server -->|"reads"| node_commits_data
node_mcp_server -->|"reads"| node_tests_data
node_first_classification -->|"classifies with"| node_classifier
node_reclassification -->|"reclassifies with"| node_classifier
node_classifier -.->|"classifies via"| node_claude
node_report_node -->|"scores and renders"| node_report_logic
node_runner -->|"writes"| node_saved_reports

click node_runner "https://github.com/harshavr8/release-readiness-copilot/blob/main/run.py"
click node_workflow "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/pipeline.py"
click node_state "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/state.py"
click node_commit_fetch "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py"
click node_test_fetch "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py"
click node_first_classification "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py"
click node_context_review "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py"
click node_reclassification "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py"
click node_report_node "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py"
click node_commits_data "https://github.com/harshavr8/release-readiness-copilot/blob/main/data/commits.json"
click node_tests_data "https://github.com/harshavr8/release-readiness-copilot/blob/main/data/test_runs.json"
click node_classifier "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/classifier.py"
click node_report_logic "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/report.py"
click node_saved_reports "https://github.com/harshavr8/release-readiness-copilot/blob/main/reports/.gitkeep"
click node_mcp_client "https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/mcp_client.py"
click node_mcp_server "https://github.com/harshavr8/release-readiness-copilot/blob/main/mcp_server/server.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_workflow,node_state,node_commit_fetch,node_test_fetch,node_first_classification,node_context_review,node_reclassification,node_report_node toneBlue
class node_commits_data,node_tests_data toneAmber
class node_classifier,node_report_logic,node_saved_reports,node_claude toneMint
class node_mcp_client,node_mcp_server toneRose
class node_engineer toneIndigo
```

## Components

### Workflow

- [Run Entry Point](https://github.com/harshavr8/release-readiness-copilot/blob/main/run.py): `run.py`
- [LangGraph Workflow](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/pipeline.py): `graph/pipeline.py`
- [Shared Graph State](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/state.py): `graph/state.py`
- [Fetch Commits](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py): `graph/nodes.py`
- [Fetch Test Runs](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py): `graph/nodes.py`
- [Classify Failures](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py): `graph/nodes.py`
- [Gather More Context](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py): `graph/nodes.py`
- [Reclassify Failures](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py): `graph/nodes.py`
- [Build Report Node](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/nodes.py): `graph/nodes.py`

### Evidence Inputs

- [Seeded Commits](https://github.com/harshavr8/release-readiness-copilot/blob/main/data/commits.json): `data/commits.json`
- [Seeded Test Runs](https://github.com/harshavr8/release-readiness-copilot/blob/main/data/test_runs.json): `data/test_runs.json`

### Analysis and Reporting

- [Failure Classifier](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/classifier.py): `graph/classifier.py`
- [Scoring and Rendering](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/report.py): `graph/report.py`
- [Saved Reports](https://github.com/harshavr8/release-readiness-copilot/blob/main/reports/.gitkeep): `reports/.gitkeep`

### MCP Data Access

- [MCP Client](https://github.com/harshavr8/release-readiness-copilot/blob/main/graph/mcp_client.py): `graph/mcp_client.py`
- [MCP Tools Server](https://github.com/harshavr8/release-readiness-copilot/blob/main/mcp_server/server.py): `mcp_server/server.py`

### Other components

- **Release Engineer**
- **Claude API**

## Connections

- Release Engineer → Run Entry Point: runs (evidence: `README.md`)
- Run Entry Point → LangGraph Workflow: invokes (evidence: `run.py`)
- LangGraph Workflow → Shared Graph State: uses state (evidence: `graph/pipeline.py`)
- LangGraph Workflow → Fetch Commits: starts with (evidence: `graph/pipeline.py`)
- Fetch Commits → Fetch Test Runs: then runs (evidence: `graph/pipeline.py`)
- Fetch Test Runs → Classify Failures: then runs (evidence: `graph/pipeline.py`)
- Classify Failures → Gather More Context: routes if uncertain (evidence: `graph/pipeline.py`)
- Classify Failures → Build Report Node: routes if resolved (evidence: `graph/pipeline.py`)
- Gather More Context → Reclassify Failures: then runs (evidence: `graph/pipeline.py`)
- Reclassify Failures → Gather More Context: loops if uncertain (evidence: `graph/pipeline.py`)
- Reclassify Failures → Build Report Node: routes if resolved (evidence: `graph/pipeline.py`)
- Fetch Commits → MCP Client: requests commits (evidence: `graph/nodes.py`)
- Fetch Test Runs → MCP Client: requests test runs (evidence: `graph/nodes.py`)
- MCP Client → MCP Tools Server: calls tools (evidence: `graph/mcp_client.py`)
- MCP Tools Server → Seeded Commits: reads (evidence: `mcp_server/server.py`)
- MCP Tools Server → Seeded Test Runs: reads (evidence: `mcp_server/server.py`)
- Classify Failures → Failure Classifier: classifies with (evidence: `graph/nodes.py`)
- Reclassify Failures → Failure Classifier: reclassifies with (evidence: `graph/nodes.py`)
- Failure Classifier → Claude API: classifies via (evidence: `README.md`)
- Build Report Node → Scoring and Rendering: scores and renders (evidence: `graph/nodes.py`)
- Run Entry Point → Saved Reports: writes (evidence: `run.py`)
