OpenSkills Runtime Debug

Use this skill when debugging runtime failures in runtime/ and execution paths used by runskilltarget, native scripts, or sandbox enforcement.

Primary Targets

• runtime/src/executor.rs
• runtime/src/native_runner.rs
• runtime/src/wasm_runner.rs
• runtime/src/permissions.rs
• runtime/tests/sandbox
• runtime/tests/seatbelt_tests.rs

Workflow

1. Reproduce with the smallest command that fails.
2. Classify failure bucket:

- sandbox policy issue - feature/config mismatch - script/tool resolution issue - wasm runtime issue

1. Confirm behavior against tests and existing fallback logic.
2. Propose the smallest safe fix that preserves security boundaries.
3. Re-run focused tests, then broader runtime tests.

Recommended Commands

cargo check -p openskills-runtime
cargo test -p openskills-runtime
cargo test -p openskills-runtime seatbelt_tests -- --nocapture

Debug Heuristics

• Treat silent degradation in sandbox setup as high risk.
• Prefer explicit error propagation over ignored Result.
• If fallback behavior is intentional, confirm it is visible in logs and tests.
• Keep macOS and Linux behavior differences explicit in findings.

Output Format

Return:

1. Root cause
2. Impact surface
3. Fix proposal
4. Verification evidence
5. Residual risks