Common Failures & Fixes

Troubleshooting

Diagnostics and step-by-step fixes for the most common SKIA Forge issues.

Build / Test Failures

npm run typecheck

npm run test

npm run build

Fix schema and type mismatches before re-running orchestration endpoints.

SKIA Integration Unavailable

Check /integration/skia-full and /integration/skia-full/probe.

Verify upstream URL and environment configuration in your hosting provider.

Review adapter disabled flags and auth headers.

Governance Blocks

Expected in strict or adaptive mode for risky actions

Read remediation recommendations from the block response

Apply the suggested safe path and re-run the request

Runtime Health Issues

Validate /health and /live endpoints.

Check logs for failing module names and request IDs.

Isolate whether the issue is a local Forge module or an upstream contract failure.

If unresolved, escalate via Contact & Support with request ID and logs.