Files

Umbra Tools b259060808 Record two more consequences of the mislabelled Spanish production

Measured on oldbox:

* The UmbraTrans dashboard reports the Spanish lane as "complete".
  project_status.py derives each language's state from the presence and
  chapter count of deal-hunter-<tag>/runs/ch-N/translation.json, and
  deal-hunter-es has 32 of 32. It never looks at what the text says, so a
  directory name and a file count are standing in for a measurement. The
  other nine target languages correctly report not_started.

* A real Spanish run would silently reuse the Chinese translations.
  pipeline.py caches by file existence and the run directory is chosen by
  the caller, so a Spanish run pointed at deal-hunter-es without --force
  would skip drafting and publish the Chinese under a Spanish name.

Neither was fixed here: the UmbraTrans checkout on oldbox is behind and
dirty, and the script check belongs in the same place as the ingest's.

2026-11-06 22:03:15 -08:00

00-project-overview.md

Weekly commit: attribution QA, dramatic variations, GPU TTS, AR export

2026-09-21 06:44:22 -07:00

01-parsing.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

02-analysis.md

Weekly commit: attribution QA, dramatic variations, GPU TTS, AR export

2026-09-21 06:44:22 -07:00

03-voice-design.md

Add voice library, embedding-mode generation, and webUI improvements

2026-09-02 17:33:15 -07:00

04-mapping.md

Weekly commit: attribution QA, dramatic variations, GPU TTS, AR export

2026-09-21 06:44:22 -07:00

05-generation.md

Add voice library, embedding-mode generation, and webUI improvements

2026-09-02 17:33:15 -07:00

06-normalization-watermarking.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

07-assembly-export.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

08-database.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

09-web-review-ui.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

10-cli-orchestrator.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

11-configuration-dependencies.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

12-quality.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

13-character-discovery.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

14-two-phase-segmentation.md

Weekly commit: attribution QA, dramatic variations, GPU TTS, AR export

2026-09-21 06:44:22 -07:00

15-multi-project.md

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

16-audiobook-production.md

Document the scene-break rule and verify the 2 s silence

2026-09-26 07:51:44 -07:00

17-speaker-confidence-review.md

Add utterance clarity signals + review queue (spec 17 Phase 1)

2026-09-23 12:15:39 -07:00

18-UmbraTrans.md

Add enterprise/infra tooling and repoint Qwen3-TTS submodule to internal fork

2026-10-06 06:57:41 -07:00

19-enterprise-control-plane.md

Add enterprise/infra tooling and repoint Qwen3-TTS submodule to internal fork

2026-10-06 06:57:41 -07:00

20-enterprise-database-integration.md

Spec 20: enterprise DB integration contract (discovery/design only)

2026-09-25 19:05:13 -07:00

21-umbra-system-nodes-tasks-and-changes.md

Action the controller alignment proposal: source_unit_key + phase reports

2026-10-02 20:16:06 -07:00

22-releases-and-the-publish-flag.md

Release comment as a release step; releasing grants implicit voice approval

2026-10-03 06:49:42 -07:00

23-speaker-duplicate-detection.md

Remove the dead narrator profiles; add --force for decisions a scan cannot make

2026-10-04 19:05:47 -07:00

24-analysis-quality-plan.md

Mechanical speech-evidence gate: catches the ch6 utt29 miss (spec 24 A)

2026-10-04 20:50:17 -07:00

25-speaker-review-audit-dealhunter.md

Add a speaker-review audit: is the attribution data fit for translation?

2026-10-11 21:57:58 -07:00

26-multilingual-tts-model-survey.md

Research: multilingual TTS models for the 15-language catalogue

2026-10-11 21:59:06 -07:00

27-translation-pipeline-multipass.md

Record two more consequences of the mislabelled Spanish production

2026-11-06 22:03:15 -08:00

28-ui-language-selection.md

Multilingual samples, multi-pass translation design, UI language plan, renderer

2026-10-12 08:07:50 -07:00

29-accent-and-voice-spec.md

Narrator speaks the translation language; characters keep their own accent

2026-10-13 06:19:43 -07:00

30-language-selection.md

Spec 30: language as a first-class dimension, with a UI mockup

2026-10-14 07:52:18 -07:00

31-utterance-language-and-voiced-flag.md

Per-utterance language flag + a working language selector (spec 31)

2026-11-06 16:55:49 -08:00

NOTES_READ.txt

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

NOTES_READ.txt.txt

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

Parsing_Rules.txt

Initial commit: UmbraAudio audiobook generation program

2026-08-30 07:58:24 -07:00

README.md

Analysis-quality plan: why the ch6 speakers were missed (spec 24)

2026-10-04 20:01:05 -07:00

README.md

UmbraAudio Specifications

Index of all specification documents for the UmbraAudio audiobook generation system.

Specifications

File	Topic	Description
00-project-overview.md	Architecture	Pipeline overview, tech stack, data layout
01-parsing.md	Pass 1a	EPUB, PDF, TXT, MD manuscript parsing
02-analysis.md	Pass 1b	BookNLP, character profiling, pronunciation
03-voice-design.md	Pass 2	Per-character voice reference generation
04-mapping.md	Pass 3	Text segmentation, speaker attribution, manifests
05-generation.md	Pass 5	Audio generation, caching, retry, CUDA management
06-normalization-watermarking.md	Post-gen	Audio normalization, ACX compliance, Perth watermark
07-assembly-export.md	Export	M4B, MP3, WAV export via FFmpeg
08-database.md	Database	SQLite schema, entity relationships, CRUD API
09-web-review-ui.md	Web UI	FastAPI + HTMX review interface
10-cli-orchestrator.md	CLI	Click commands, full pipeline orchestration
11-configuration-dependencies.md	Config	Pydantic settings, dependencies, build system
12-quality.md	Quality	MOS, WER, consistency, ACX compliance
18-UmbraTrans.md	Multilingual	Meaning-preserving translation, target voices, and multilingual audiobook production
19-enterprise-control-plane.md	Enterprise	Multi-tenant projects, access control, artifact lineage, and commercial voice library
20-enterprise-database-integration.md	Enterprise DB	Shared-PostgreSQL contract, blockers, cutover phases P1-P4
21-umbra-system-nodes-tasks-and-changes.md	System	Worker nodes, task assignment, cross-product change management, UI topology
22-releases-and-the-publish-flag.md	Release	The publish flag, pinned artifact sets, post-publication change, and the Deal Hunter lesson
23-speaker-duplicate-detection.md	Speakers	Duplicate-speaker scan, approval-safe merging, and the crowd veto
24-analysis-quality-plan.md	Analysis	Why the ch6 speakers were missed, and a ranked plan to improve attribution

Quick Reference

Pipeline Passes

1a: Parse    → chapters table
1b: Analyze  → characters, pronunciation_guide
2:  Voices   → voice_ref WAVs
3:  Map      → manifests/*.json
4:  Test     → sample audio (optional)
5:  Generate → audio/*.wav, audio_normalized/*.wav
    Export   → export/*.m4b, *.mp3

Key Entry Points

Component	File	Class/Function
CLI	`cli.py`	`main` Click group
Pipeline	`orchestrator.py`	`run_pipeline()`
TTS	`voices/chatterbox.py`	`ChatterboxEngine`
Segmenter	`mapping/segmenter.py`	`Segmenter`
Generator	`generation/chapter.py`	`ChapterGenerator`
Normalizer	`assembly/normalize.py`	`AudioNormalizer`
Web UI	`web/__init__.py`	`create_app()`
Database	`database.py`	`Database`