diff --git a/CLAUDE.md b/CLAUDE.md index ab64b72..f89facc 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,8 +1,9 @@ # utils Monorepo of shared gates and libraries (dep_freshness, file_length, md_naming, -repo_contract, coverage_gaps, crdt-sync, gatelock, freedays, sickdays, earned_time, music_theory, +repo_contract, coverage_gaps, crdt-sync, gatelock, freedays, sickdays, earned_time, music_theory, game_recording, flutter_web_drive (headless Flutter-web E2E driver + MCP), ...). +`godot_dev_tools/` is a Godot addon (GDScript): `godot_dev_tools/test.sh` runs its GUT tests. Python packages with a root-level `/tests` run with `PYTHONPATH=.`; subprojects with their own `pyproject.toml` run via `scripts/run_subproject_tests.sh `. `scripts/check_repo_contract.sh` is the REAL shared gate (not a shim): never diff --git a/README.md b/README.md index 64196da..1fca8fc 100644 --- a/README.md +++ b/README.md @@ -101,6 +101,17 @@ Consume via: music_theory @ git+https://github.com/kuhyx/utils@music-theory-v0.1.0#subdirectory=music_theory ``` +## game_recording/ + +Session recorder for a game (package: `game_recording`, stdlib only, not +published to PyPI): records a dev run from outside the game and stamps its +telemetry moments onto the video. A game configures it with one `Config`. + +Consume via: +``` +game_recording @ git+https://github.com/kuhyx/utils@game-recording-v0.1.0#subdirectory=game_recording +``` + ## unified-design-system/ Not a package — the frozen design tokens (colors, spacing, type, radius, @@ -128,3 +139,16 @@ planted violation per rule family proves each gate bites. "@kuhyx/ts-config": "github:kuhyx/utils#ts_config-v0.1.0&path:/ts_config" } ``` + +## godot_dev_tools/ + +Godot addon (`addons/dev_tools/`): the F12 dev feedback mode of kuhy's games +(annotate the frozen frame, save a bundle that `feedback_inbox` turns into a +task). A game mounts it at a pinned tag; the game's own code stays a small host +object. Read [`godot_dev_tools/README.md`](godot_dev_tools/README.md). + +Consume via a shallow fetch of the tag, then mount the addon folder: +``` +git clone --depth 1 --branch godot-dev-tools-v0.1.0 https://github.com/kuhyx/utils +# link or copy godot_dev_tools/addons/dev_tools to res://addons/dev_tools +``` diff --git a/scripts/deploy.sh b/scripts/deploy.sh index 2d63b71..fb42e75 100755 --- a/scripts/deploy.sh +++ b/scripts/deploy.sh @@ -49,6 +49,7 @@ check_tag() { local prefix="$1" dir="$2" manifest version tag manifest="$UTILS_DIR/$dir/pyproject.toml" [[ -f "$manifest" ]] || manifest="$UTILS_DIR/$dir/pubspec.yaml" + [[ -f "$manifest" ]] || manifest="$UTILS_DIR/$dir/addons/dev_tools/dev_tools.cfg" version="$(manifest_version "$manifest")" tag="${prefix}-v${version}" if ! git -C "$UTILS_DIR" fetch -q origin "+refs/tags/${tag}:refs/tags/${tag}" 2>/dev/null; then @@ -82,6 +83,8 @@ check_sickdays() { verify() { check_tag sickdays sickdays check_tag sync_settings_ui sync_settings_ui + check_tag game-recording game_recording + check_tag godot-dev-tools godot_dev_tools check_sickdays if [[ "$FAILED" -ne 0 ]]; then log "health check FAILED"