Troubleshooting
The service exits immediately
Neither AWARE_CREDENTIAL_PEPPER nor SECRET_KEY is set. The service fails fast on purpose: it will not start a credential store it cannot hash safely.
The gateway returns 503
Check AWARE_GATEWAY_KILL_SWITCH. If it is 1, the gateway is in its emergency state and returns 503 before any upstream work.
A tool is denied and I expected ALLOW
This is the default-deny posture working. A tool that is unknown, or whose risk is HIGH or CRITICAL, is denied when no policy matches. Add a policy, or check the risk level in the tool catalogue.
A credential will not verify
Verify the pepper the credential was hashed with matches the pepper the service is running with. Credentials hashed under a different pepper cannot verify, and that is correct behaviour.
Unit tests fail on a fresh checkout
At the time of writing, the unit suite has known failures traced to two modules absent from the source tree (src/compliance/aidefend-mapper.js and src/compliance/memory-component-failure-annotator.js) and one unimplemented outcome-filter rule. This is recorded in the capability register.