jolt-physics
jolt-physics
When to use this skill
Use for the named Jolt native library, JPH symbols, its sample integration, or an existing Jolt build/runtime issue. Select exactly one mode: source-fit, build-plan, native-integration, determinism-audit, or failure-triage. Generic Godot physics belongs to the engine workflow, not this native-library operator. JoltPhysics.js is a separate repository and requires its own source/version review.
Instructions
1. Freeze one mode and evidence boundary
Read references/upstream.md for version, architecture, asset-license, and platform limits. Read references/source.json for selected-file provenance. Record existing project/compiler/architecture/build type, linked Jolt version, requested output, and permission scope. Preserve existing pins; HEAD evidence is not release equivalence.
Helper host prerequisite: Before running the helper, use a POSIX Python environment with os.O_NOFOLLOW and os.open support for dir_fd. Native Windows may fail closed with secure_posix_traversal_unavailable; preserve these safety guards. Windows users can retry in a WSL environment that supports these features or manually compare the original manifest-listed source files against the pinned evidence. Neither this guidance nor a manual comparison verifies helper execution or runtime behavior; report those as unverified.
From the installed skill directory, run only the offline helper when authorized:
python3 scripts/preflight.py --json
python3 scripts/preflight.py --json --repo <approved-absolute-source-root>
The helper is local at scripts/preflight.py and loads references/source.json relative to itself. It checks selected bytes, rejects symlink traversal and sensitive paths, and does not run upstream code. Without --repo, source_checked remains false. Tool presence is not version/readiness proof; whole_revision_verified and runtime_verified remain false. Stop source-fit on mismatched selected hashes; do not rewrite the manifest to force a match.