Merge PR #52

Merged PR #52: feat: GENOME.md — full codebase analysis
feat: GENOME.md — full codebase analysis (#675 )
2026-04-17 01:52:16 +00:00 · 2026-04-16 04:13:58 +00:00 · 2026-04-13 10:13:38 +00:00 · 2026-04-13 09:43:55 +00:00 · 2026-04-13 04:34:04 -04:00 · 2026-04-13 04:10:43 -04:00
4 changed files with 68 additions and 3 deletions
--- a/.gitea/workflows/build.yml
+++ b/.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: |
--- a/GENOME.md
+++ b/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
--- a/build/metadata.yaml
+++ b/build/metadata.yaml
@@ -38,4 +38,3 @@ header-includes:
  - \fancyhead[RE]{\textit{The Testament}}
  - \fancyhead[LO]{\textit{\leftmark}}
  - \fancyfoot{}
---
--- a/compile.py
+++ b/compile.py
@@ -285,7 +285,10 @@ def compile_pdf():
        return False


-def main():\n    print("Generating index...")\n    os.system("python3 scripts/index_generator.py")\n
+def main():
+    print("Generating index...")
+    os.system("python3 scripts/index_generator.py")
+
    args = sys.argv[1:]
    
    if "--check" in args:
Author	SHA1	Message	Date
Alexander Whitestone	f16e19b3ea	Merge PR #52 Merged PR #52: feat: GENOME.md — full codebase analysis	2026-04-17 01:52:16 +00:00
Alexander Whitestone	bfa557edc4	feat: GENOME.md — full codebase analysis (#675 ) Some checks failed Smoke Test / smoke (pull_request) Failing after 12s Details Build Validation / validate-manuscript (pull_request) Successful in 12s Details Build Verification / verify-build (pull_request) Failing after 12s Details	2026-04-16 04:13:58 +00:00
Timmy Time	0b5b33a41b	Merge pull request 'fix: restore main() function body in compile.py' (#49 ) from burn/20260413-0411-fix into main Some checks failed Build Verification / verify-build (push) Failing after 6s Details Smoke Test / smoke (push) Failing after 7s Details merge reviewed compile.py main() fix	2026-04-13 10:13:38 +00:00
Timmy Time	7a57b1a4b0	Merge pull request 'fix: repair CI — metadata.yaml parse + build script path' (#50 ) from ci/fix-build-and-metadata into main Some checks failed Build Verification / verify-build (push) Failing after 7s Details Smoke Test / smoke (push) Failing after 7s Details merge reviewed CI repair	2026-04-13 09:43:55 +00:00
Alexander Whitestone	124a1e855d	fix: repair CI — metadata.yaml parse + build script path Some checks failed Build Verification / verify-build (pull_request) Failing after 5s Details Smoke Test / smoke (pull_request) Failing after 6s Details Build Validation / validate-manuscript (pull_request) Successful in 6s Details 1. build/metadata.yaml: removed trailing '---' that caused yaml.safe_load to fail with 'expected a single document in the stream'. Pandoc accepts metadata without the closing delimiter. 2. .gitea/workflows/build.yml: changed build-verify.py reference from scripts/build-verify.py (doesn't exist) to build/build.py --md (the actual build script).	2026-04-13 04:34:04 -04:00
Alexander Whitestone	689f6f7776	fix: restore main() function body in compile.py Some checks failed Build Verification / verify-build (pull_request) Failing after 6s Details Smoke Test / smoke (pull_request) Failing after 5s Details Build Validation / validate-manuscript (pull_request) Successful in 6s Details Lines 288-290 had literal \n characters instead of actual newlines, causing the main() function to have no body. Fixed formatting and removed duplicate args assignment.	2026-04-13 04:10:43 -04:00
Timmy Time	c66c0e05a1	Merge pull request 'fix: Robert's age + Thomas's unique detail (continuity #43 #44 )' (#47 ) from burn/20260413-0034-age-and-duplicate-fix into main Some checks failed Build Verification / verify-build (push) Failing after 6s Details Smoke Test / smoke (push) Failing after 6s Details	2026-04-13 05:32:49 +00:00