feat(ariadne): add extraction preparation script

This commit was merged in pull request #12.
This commit is contained in:
2026-09-05 18:49:10 -04:00
parent 564f946471
commit 675576bff6
5 changed files with 284 additions and 0 deletions

25
src/ariadne/README.md Normal file
View File

@@ -0,0 +1,25 @@
# Ariadne
Ariadne prepares Ren'Py game source for later analysis.
## Bazel shape
Keep project-owned source under `src/ariadne/`. Keep game-derived files local and ignored under
`src/ariadne/output/`.
The first target is a shell entry point:
```sh
bazel run //src/ariadne:extract_and_decompile -- \
--game-root /path/to/game-install
```
The script defaults to `<workspace>/src/ariadne/output`.
This path stays stable when you run the command from inside `src/ariadne`.
Use the game installation directory as the game root.
One run processes all installed season directories.
If `rpycdec` is not available, the script uses `extract-tools.nix` to enter a Nix shell.
Keep the script as a thin orchestration layer.
Bazel owns stable inputs and wrappers.
Keep large game files and recovered output outside the build graph.