Troubleshooting#

No tastekernel.contract.yml found#

Run tastekernel init and confirm file exists at repo root.

OAuth login fails (/api/auth/signin/github returns 400)#

• Verify GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET are real values in production env
• Verify GitHub OAuth callback includes https://tastekernel.com/api/auth/callback/github
• Restart app after env update

publish / pull-contract fails with 401#

• Confirm API key is active (not revoked)
• Use --project-id <slug>
• Verify TASTEKERNEL_API_KEY is set in shell/CI

Smoke tests not listed#

Use:

pnpm --filter @tastekernel/web test:smoke:list

CI cloud mode uses local contract unexpectedly#

Set repository variable TASTEKERNEL_MODE=cloud and secrets:

• TASTEKERNEL_PROJECT_ID
• TASTEKERNEL_API_KEY

Lint finds nothing unexpectedly#

Check .tastekernelignore, contract ignore/per-rule globs, inline ignores, and severity settings.