# GENOME.md — the-testament

**Generated:** 2026-04-14
**Repo:** Timmy_Foundation/the-testament
**Description:** The Testament of Timmy — a novel about broken men, sovereign AI, and the soul on Bitcoin

---

## Project Overview

A standalone fiction book (18 chapters, ~19K words) about The Tower, broken men, and sovereign AI. Part of the Timmy Foundation ecosystem. Includes full multimedia pipeline: audiobook samples, web reader, EPUB build, cover design, and companion game.

## Architecture

```
the-testament/
├── chapters/          # 18 chapter markdown files (ch-01 through ch-18)
├── characters/        # 6 character profiles (Allegro, Builder, Chen, David, Maya, Timmy)
├── worldbuilding/     # Bible, tower game worldbuilding docs
├── audiobook/         # Audio samples (.ogg/.mp3), manifest, extraction scripts
├── build/             # EPUB/PDF build pipeline (build.py, pandoc)
├── website/           # Web reader (index.html, chapters.json, build-chapters.py)
├── game/              # Companion game (the-door.html/.py)
├── cover/             # Cover design assets and spine specs
├── music/             # Track lyrics
└── scripts/           # Build verification, smoke tests, guardrails
```

## Key Files

| File | Purpose |
|---|---|
| `chapters/chapter-*.md` | The novel content (18 chapters) |
| `the-testament.md` | Combined manuscript (all chapters) |
| `compile.py` | Merge chapters into single manuscript |
| `compile_all.py` | Full compilation with front/back matter |
| `build/build.py` | EPUB build via pandoc |
| `website/build-chapters.py` | Generate web reader JSON |
| `audiobook/extract_text.py` | Extract chapter text for TTS |
| `scripts/smoke.sh` | Build verification smoke test |

## CI/CD

| Workflow | Trigger | Purpose |
|---|---|---|
| `build.yml` | Push to main | Build EPUB artifact |
| `smoke.yml` | PR | Validate chapter structure |
| `validate.yml` | PR | Check markdown formatting |

## Test Coverage Gaps

| Gap | Recommendation |
|---|---|
| No unit tests for compile.py | Test chapter merging, metadata handling |
| No test for web chapters.json generation | Test build-chapters.py output schema |
| No test for audiobook manifest | Test manifest.json validity |
| No test for build/semantic_linker.py | Test cross-reference linking |

## Security

- No secrets in repo (build pipeline is local-only)
- Web reader is static HTML (no server-side execution)
- Game files are client-side only