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.