# BlastRadius Sentinel for Atlassian Forge

**BlastRadius Sentinel** is an autonomous SRE and resilience app for Atlassian Forge, built for **Codegeist 2026** ($120,000 USD).

It combines **Atlassian Rovo Agent**, **Teamwork Graph Cypher Traversal**, and the **Model Context Protocol (MCP)** to compute deterministic incident blast radius scores (0–100) from pull request diffs, mapping impacted downstream microservices, paging on-call teams, and surfacing Confluence recovery runbooks.

---

## Features

1. **Atlassian Rovo Agent (`rovo:agent`)**:
   - Native AI teammate configured with system prompts and conversation starters.
   - Triggers Forge actions to calculate risk, query graphs, and locate mitigation guides.

2. **Atlassian Model Context Protocol Server (`rovo:mcp` + `webtrigger`)**:
   - Full JSON-RPC 2.0 server adhering to the MCP specification (`2024-11-05`).
   - Supports `tools/list`, `tools/call`, `resources/list`, `resources/read`, and `prompts/get`.
   - Accessible by Claude Desktop, Cursor IDE, and Rovo Dev CLI.

3. **Teamwork Graph Cypher Traversal**:
   - Queries dependency edges (`depends_on`, `owned_by`, `on_call`) across microservices using GraphQL and Cypher.
   - Distinguishes direct versus transitive downstream impact across Tier 1, 2, and 3 services.

4. **Jira Issue Panel (`jira:issuePanel`)**:
   - Displays blast radius index, affected service lists, estimated MTTR, and runbook links on Jira issues.

5. **Interactive Browser Simulator (`docs/index.html`)**:
   - Offline interactive simulator featuring an SVG microservice topology visualizer, real-time risk scorecard, and live MCP terminal.

---

## Directory Structure

```
├── manifest.yml                      # Atlassian Forge manifest (rovo:agent, rovo:mcp, jira:issuePanel, webtrigger)
├── package.json                      # Node.js project metadata & test script
├── LICENSE                           # MIT License
├── README.md                         # Project documentation
├── DEVPOST_CODEGEIST_SUBMISSION.md   # Hackathon submission summary
├── src/
│   ├── index.js                      # Forge action resolvers & webtrigger handler
│   ├── blast_radius.js               # Deterministic scoring algorithm
│   ├── twg_graph.js                  # Teamwork Graph Cypher traversal client
│   └── mcp_handler.js                # MCP JSON-RPC 2.0 protocol engine
├── tests/
│   └── test_forge_app.mjs            # Automated test suite (node --test)
├── docs/
│   └── index.html                    # Interactive browser simulator
└── assets/
    ├── thumbnail_1280x800.png        # Devpost submission graphic
    └── demo_codegeist_1080p.mp4      # 40s 1080p 30fps demonstration video
```

---

## Testing

Run the automated test suite with Node's native test runner:

```bash
npm test
```

Or directly:

```bash
node --test tests/test_forge_app.mjs
```

All 24 unit and integration tests execute with zero external runtime dependencies.

---

## Deployment to Atlassian Forge

1. Install the Forge CLI:
   ```bash
   npm install -g @forge/cli
   ```

2. Log in to your Atlassian Cloud site:
   ```bash
   forge login
   ```

3. Deploy and install:
   ```bash
   forge deploy
   forge install
   ```

---

## License

MIT License. Copyright (c) 2026 Khanhtnq.