# ramanathanapa/the-contract-game architecture

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

- Interactive diagram: https://gitdiagram.com/ramanathanapa/the-contract-game
- Repository: https://github.com/ramanathanapa/the-contract-game

## Overview

The Contract is a browser-based, single-player game about negotiating upstream data changes. The root page selects between two separate playable versions. In v1, the player chooses a producer personality, handles twelve field-change scenarios, sees outcomes and a campaign verdict, and can resume saved progress. In v2, the player chooses a role and follows a branching, four-episode conversation to a verdict. Both versions persist locally and offer optional AI-written text; AI does not determine game outcomes. Arrows show documented calls, input use, or navigation; unsampled implementation details are omitted.

Main entry points: [`versions/v1/js/app.js`](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/app.js) (Campaign UI), [`versions/v2/js/app.js`](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/app.js) (Conversation UI), [`index.html`](https://github.com/ramanathanapa/the-contract-game/blob/main/index.html) (Version picker), [`versions/v1/js/flavor.js`](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/flavor.js) (Outcome message rewrite)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Game entry"]
  node_picker["Version picker<br/>[index.html]"]
end

subgraph group_classic["Classic v1"]
  node_classic_ui["Campaign UI<br/>[app.js]"]
  node_personalities["Producer personalities<br/>[data.js]"]
  node_scenario_deck["Scenario deck<br/>[scenarios.js]"]
  node_rules["Outcome and verdict rules<br/>[scenarioEngine.js]"]
  node_classic_state[("Campaign persistence<br/>[state.js]")]
  node_classic_flavor["Outcome message rewrite<br/>[flavor.js]"]
end

subgraph group_both["Both Sides v2"]
  node_v2_ui["Conversation UI<br/>[app.js]"]
  node_story["Branching episode story<br/>[story.js]"]
  node_v2_state[("Transcript persistence<br/>[state.js]")]
  node_v2_flavor["Tool-output rewrite<br/>[flavor.js]"]
end

subgraph group_integrations["Optional AI"]
  node_anthropic{{"Anthropic API"}}
  node_v2_providers{{"Configured AI providers"}}
end

node_player(("Player"))

node_player -->|"opens"| node_picker
node_picker -->|"links to"| node_classic_ui
node_picker -->|"links to"| node_v2_ui
node_player -->|"plays"| node_classic_ui
node_classic_ui -->|"selects from"| node_personalities
node_classic_ui -->|"selects scenario"| node_scenario_deck
node_classic_ui -->|"resolves choice"| node_rules
node_classic_ui -->|"saves and loads"| node_classic_state
node_classic_ui -->|"requests rewrite"| node_classic_flavor
node_classic_flavor -.->|"calls"| node_anthropic
node_player -->|"plays"| node_v2_ui
node_v2_ui -->|"advances through"| node_story
node_v2_ui -->|"saves and loads"| node_v2_state
node_v2_ui -->|"requests rewrite"| node_v2_flavor
node_v2_flavor -.->|"calls configured API"| node_v2_providers

click node_picker "https://github.com/ramanathanapa/the-contract-game/blob/main/index.html"
click node_classic_ui "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/app.js"
click node_personalities "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/data.js"
click node_scenario_deck "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/scenarios.js"
click node_rules "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/scenarioEngine.js"
click node_classic_state "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/state.js"
click node_classic_flavor "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/flavor.js"
click node_v2_ui "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/app.js"
click node_story "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/story.js"
click node_v2_state "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/state.js"
click node_v2_flavor "https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/flavor.js"

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_picker toneBlue
class node_classic_ui,node_personalities,node_scenario_deck,node_rules,node_classic_state,node_classic_flavor toneAmber
class node_v2_ui,node_story,node_v2_state,node_v2_flavor toneMint
class node_anthropic,node_v2_providers toneRose
class node_player toneIndigo
```

## Components

### Game entry

- [Version picker](https://github.com/ramanathanapa/the-contract-game/blob/main/index.html): `index.html`

### Classic v1

- [Campaign UI](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/app.js): `versions/v1/js/app.js`
- [Producer personalities](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/data.js): `versions/v1/js/data.js`
- [Scenario deck](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/scenarios.js): `versions/v1/js/scenarios.js`
- [Outcome and verdict rules](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/scenarioEngine.js): `versions/v1/js/scenarioEngine.js`
- [Campaign persistence](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/state.js): `versions/v1/js/state.js`
- [Outcome message rewrite](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v1/js/flavor.js): `versions/v1/js/flavor.js`

### Both Sides v2

- [Conversation UI](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/app.js): `versions/v2/js/app.js`
- [Branching episode story](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/story.js): `versions/v2/js/story.js`
- [Transcript persistence](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/state.js): `versions/v2/js/state.js`
- [Tool-output rewrite](https://github.com/ramanathanapa/the-contract-game/blob/main/versions/v2/js/flavor.js): `versions/v2/js/flavor.js`

### Optional AI

- **Anthropic API**
- **Configured AI providers**

### Other components

- **Player**

## Connections

- Player → Version picker: opens (evidence: `README.md`)
- Version picker → Campaign UI: links to (evidence: `README.md`)
- Version picker → Conversation UI: links to (evidence: `README.md`)
- Player → Campaign UI: plays (evidence: `README.md`)
- Campaign UI → Producer personalities: selects from (evidence: `versions/v1/js/app.js`)
- Campaign UI → Scenario deck: selects scenario (evidence: `versions/v1/js/app.js`)
- Campaign UI → Outcome and verdict rules: resolves choice (evidence: `versions/v1/js/app.js`)
- Campaign UI → Campaign persistence: saves and loads (evidence: `versions/v1/js/app.js`)
- Campaign UI → Outcome message rewrite: requests rewrite (evidence: `versions/v1/js/app.js`)
- Outcome message rewrite → Anthropic API: calls (evidence: `versions/v1/js/flavor.js`)
- Player → Conversation UI: plays (evidence: `README.md`)
- Conversation UI → Branching episode story: advances through (evidence: `versions/v2/js/app.js`)
- Conversation UI → Transcript persistence: saves and loads (evidence: `versions/v2/js/app.js`)
- Conversation UI → Tool-output rewrite: requests rewrite (evidence: `versions/v2/js/app.js`)
- Tool-output rewrite → Configured AI providers: calls configured API (evidence: `versions/v2/js/flavor.js`)
