fix: untrack generated MP3/PDF binaries to restore extraction-friendly repo #46

2026-02-13T22:15:25Z

electron-rare commented

2026-02-13 22:15:25 +00:00

(Migrated from github.com)

Motivation

Automated extraction and patch workflows were failing because generated binary artifacts (MP3/PDF) were present in the repository diffs, which are not friendly to text-based review/patch tools.
The goal is to keep the repository reproducible while avoiding committing large binary outputs and to provide a documented local regeneration process.

Description

Stop versioning generated outputs by ignoring audio/generated/* and printables/export/pdf/zacus_v1/*, and preserve a small README in each folder explaining the local generation workflow via .gitignore rules and file README additions.
Add lightweight local-generation utilities: tools/audio/generate_local_assets.py and tools/printables/generate_local_pdf_placeholders.py to recreate placeholder MP3/PDF artifacts locally.
Add validation tooling and manifests: audio/manifests/zacus_v1_audio.yaml, tools/audio/validate_manifest.py, and tools/scenario/validate_scenario.py to verify audio presence and scenario consistency.
Improve repository documentation and assets: new game/scenarios/zacus_v1.yaml, assorted docs/* files, audio/README.md, updated README.md, and license harmonization files under LICENSES/ to clarify code vs creative licensing.

Testing

Ran python3 tools/audio/generate_local_assets.py to recreate local audio/generated placeholders, which completed successfully (no missing sources) ✅.
Ran python3 tools/printables/generate_local_pdf_placeholders.py to create placeholder PDFs in printables/export/pdf/zacus_v1, which completed successfully ✅.
Ran python3 tools/audio/validate_manifest.py to verify manifest asset availability, which reported OK ✅.
Ran python3 tools/scenario/validate_scenario.py and python3 hardware/firmware/esp32/tools/story_gen/story_gen.py validate --spec-dir hardware/firmware/esp32/story_specs/scenarios --strict to validate scenario files, both passed ✅.

Codex Task

### Motivation - Automated extraction and patch workflows were failing because generated binary artifacts (MP3/PDF) were present in the repository diffs, which are not friendly to text-based review/patch tools. - The goal is to keep the repository reproducible while avoiding committing large binary outputs and to provide a documented local regeneration process. ### Description - Stop versioning generated outputs by ignoring `audio/generated/*` and `printables/export/pdf/zacus_v1/*`, and preserve a small README in each folder explaining the local generation workflow via `.gitignore` rules and file README additions. - Add lightweight local-generation utilities: `tools/audio/generate_local_assets.py` and `tools/printables/generate_local_pdf_placeholders.py` to recreate placeholder MP3/PDF artifacts locally. - Add validation tooling and manifests: `audio/manifests/zacus_v1_audio.yaml`, `tools/audio/validate_manifest.py`, and `tools/scenario/validate_scenario.py` to verify audio presence and scenario consistency. - Improve repository documentation and assets: new `game/scenarios/zacus_v1.yaml`, assorted `docs/*` files, `audio/README.md`, updated `README.md`, and license harmonization files under `LICENSES/` to clarify code vs creative licensing. ### Testing - Ran `python3 tools/audio/generate_local_assets.py` to recreate local `audio/generated` placeholders, which completed successfully (no missing sources) ✅. - Ran `python3 tools/printables/generate_local_pdf_placeholders.py` to create placeholder PDFs in `printables/export/pdf/zacus_v1`, which completed successfully ✅. - Ran `python3 tools/audio/validate_manifest.py` to verify manifest asset availability, which reported OK ✅. - Ran `python3 tools/scenario/validate_scenario.py` and `python3 hardware/firmware/esp32/tools/story_gen/story_gen.py validate --spec-dir hardware/firmware/esp32/story_specs/scenarios --strict` to validate scenario files, both passed ✅. ------ [Codex Task](https://chatgpt.com/codex/tasks/task_e_698f9eeac5d48331b0edd7f8116eb986)

chatgpt-codex-connector[bot] commented

2026-02-13 22:15:31 +00:00

(Migrated from github.com)

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

You have reached your Codex usage limits for code reviews. You can see your limits in the [Codex usage dashboard](https://chatgpt.com/codex/settings/usage). To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your [settings](https://chatgpt.com/codex/settings/code-review).

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: electron-rare/le-mystere-professeur-zacus#46