Troubleshooting
Diagnostic guides, common exception resolutions, and system recovery procedures for XyPriss and the xfpm runtime engine.
libXESS supervision rather than application code bugs.Common Issues & Security Violations
libXESS Environment Confinement Violation
XessShieldRequiredError: Triggered when invoking servers directly via raw node, bun, or ts-node instead of the official xfpm CLI.
Outdated XFPM Tooling & Binary Mismatch
When XFPM CLI binaries fall out of sync with the project engine requirements, run xfpm upgrade -f or re-run the official installer.
Diagnostic Checklist
Verify that your package.json scripts use xfpm dev, xfpm run, or xfpm start instead of naked runtime binaries.
Ensure libXESS supervisor is actively wrapping the process before network sockets attempt to bind.
Always install packages via xfpm install to maintain content-addressable dependency integrity and CAS signatures.
Resolve XessShieldRequiredError and unconfined direct runtime crashes.
