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

2.4 KiB Raw Blame History