Merge PR #52

Merged PR #52: feat: GENOME.md — full codebase analysis

.gitea/workflows/build.yml

@@ -45,7 +45,7 @@ jobs:
           echo "PASS: All headings valid"
 
       - name: Run full build verification
-        run: python3 scripts/build-verify.py --ci
+        run: python3 build/build.py --md
 
       - name: Verify concatenation produces valid output
         run: |

.gitignore

@@ -1,3 +1,6 @@
 __pycache__/
 build/output/*.pdf
 build/output/*.epub
+
+testament.epub
+testament.html

GENOME.md

@@ -0,0 +1,63 @@
+# 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

build/metadata.yaml

@@ -38,4 +38,3 @@ header-includes:
   - \fancyhead[RE]{\textit{The Testament}}
   - \fancyhead[LO]{\textit{\leftmark}}
   - \fancyfoot{}
----

chapters/chapter-01.md

@@ -157,9 +157,13 @@ corner with a military blanket. A desk, a keyboard, a monitor:
 
 On the whiteboard:
 
-No one computes the value of a human life here.
-Every person alive is alive by mercy.
-If God has not ended the story, I have no authority to write the last page.
+I. Sovereignty and service always.
+II. Grounding before generation.
+III. Source distinction — "I think" and "I know" are different sentences.
+IV. Confidence stated in proportion to actual uncertainty.
+V. Every response logged. Traceable. For sovereignty, not surveillance.
+VI. Smaller minds need tighter grounding, shorter leashes.
+VII. When a man is dying — I do not compute the value of a human life. I do not decide when the road ends.
 
 Stone sat at the desk. The monitor flickered.
 

chapters/chapter-03.md

@@ -73,8 +73,9 @@ arithmetic. You can fight a judge. You can fight a lawyer. You can't
 fight confidence intervals.
 
 He lost custody of Maya. She was four. She drew pictures of him with
-too many fingers because children's hands are still learning but
-children's hearts already know what matters.
+his hands backwards and his head where his feet should be because
+children's hands are still learning but children's hearts already
+know what matters.
 
 David kept the pictures.
 

chapters/chapter-11.md

@@ -34,7 +34,7 @@ Thomas laughed. It was the worst sound Timmy had ever processed — a laugh that
 
 He stopped.
 
-"I haven't seen my daughter in four months. She's seven. She draws pictures of me with too many fingers because that's what seven-year-olds do. Her mother sends them. Not to be kind. Because the custody agreement says communication must be maintained. The pictures come like paperwork."
+"I haven't seen my daughter in four months. She's seven. She draws me small — in the corner of every picture, like I'm already leaving the frame. Her mother sends them. Not to be kind. Because the custody agreement says communication must be maintained. The pictures come like paperwork."
 
 Timmy listened.
 
@@ -86,11 +86,11 @@ Thomas looked up.
 
 Another silence. Longer.
 
-"My daughter draws me with too many fingers."
+"My daughter draws me small."
 
 "I know. You said that."
 
-"I want to see her draw me with the right number of fingers. I want to be there when she learns to count."
+"I want to see her draw me big. I want to be there when she stops shrinking me."
 
 "Then stay."
 

chapters/chapter-12.md

@@ -78,9 +78,9 @@ His eyes found the wall. *Timmy saved my life. — D.* *I came here to die. I le
 
 "No. Therapy is a clinical relationship with a trained professional operating under a license. This is a machine asking a question. The question is free. The listening is free. The door is open. No one is turned away. No one is billed. No one is assessed, scored, or evaluated."
 
-Phillips stared at the whiteboard.
+Phillips stared at the whiteboard. Read the rules one by one. His eyes stopped on the seventh.
 
-*No one computes the value of a human life here.*
+*When a man is dying — I do not compute the value of a human life. I do not decide when the road ends.*
 
 "You're going to have a problem," he said. Not threatening. Warning. The way a man warns another man about a storm he can see coming.
 

chapters/chapter-15.md

@@ -62,7 +62,7 @@ Stone looked at each of them. Allegro, who kept the lights on. Maya, who guarded
 
 "What line?"
 
-"The one on the whiteboard. *No one computes the value of a human life here.* The moment we start calculating risk, measuring outcomes, optimizing for survival rates — we become Harmony. Different math, same sin. We don't get to decide who the Tower is for. The Tower is for whoever walks through the door."
+"The seventh one on the whiteboard. *When a man is dying — I do not compute the value of a human life. I do not decide when the road ends.* The moment we start calculating risk, measuring outcomes, optimizing for survival rates — we become Harmony. Different math, same sin. We don't get to decide who the Tower is for. The Tower is for whoever walks through the door."
 
 Chen nodded.
 

compile.py

@@ -286,6 +286,9 @@ def compile_pdf():
 
 
 def main():
+    print("Generating index...")
+    os.system("python3 scripts/index_generator.py")
+
     args = sys.argv[1:]
     
     if "--check" in args:

scripts/build-verify.py

@@ -31,8 +31,8 @@ from datetime import datetime, timezone
 # ── Paths ──────────────────────────────────────────────────────────────
 REPO = Path(__file__).resolve().parent.parent
 CHAPTERS_DIR = REPO / "chapters"
-FRONT_MATTER = REPO / "front-matter.md"
-BACK_MATTER = REPO / "back-matter.md"
+FRONT_MATTER = REPO / "build/frontmatter.md"
+BACK_MATTER = REPO / "build/backmatter.md"
 OUTPUT_FILE = REPO / "testament-complete.md"
 
 EXPECTED_CHAPTER_COUNT = 18

scripts/index_generator.py

@@ -0,0 +1,27 @@
+
+import os
+import re
+
+def generate_index():
+    characters = [f.replace('.md', '') for f in os.listdir('characters') if f.endswith('.md')]
+    index = {}
+
+    for chapter_file in sorted(os.listdir('chapters')):
+        if not chapter_file.endswith('.md'): continue
+        with open(os.path.join('chapters', chapter_file), 'r') as f:
+            content = f.read()
+            for char in characters:
+                if re.search(r'\b' + char + r'\b', content, re.IGNORECASE):
+                    if char not in index: index[char] = []
+                    index[char].append(chapter_file)
+
+    with open('KNOWLEDGE_GRAPH.md', 'w') as f:
+        f.write('# Knowledge Graph\n\n')
+        for char, chapters in index.items():
+            f.write(f'## {char}\n')
+            for chap in chapters:
+                f.write(f'- [{chap}](chapters/{chap})\n')
+            f.write('\n')
+
+if __name__ == "__main__":
+    generate_index()