Checks & Results
Checks & Results
After a task that changes files, NOVA runs your project's own checks and tells you plainly what they said. A pass means a real check ran and passed.
The results
| Result | What it means |
|---|---|
| PASS | NOVA's checks ran and passed. |
| FAIL | A required check failed. The work isn't done yet. |
| BLOCKED | A check couldn't run, for example because a tool is missing. |
| SKIPPED | Checks were skipped on purpose, and the reasons are recorded. |
| UNVERIFIED | NOVA didn't run a check of its own, so it makes no claim either way. |
Which checks run
NOVA looks at your project and finds its test, build, lint and type-check commands. It runs the ones your changes need. You can also run them yourself:
\lint # linter
\typecheck # type checker
\check # build, type check, lint and test, stopping at the first failure
If NOVA can't find your commands, set them in Settings, for example verify.test.
NOVA's record
A task that changed something ends with NOVA's record:
- which files changed
- NOVA's check result
- commands the AI ran on its own (listed separately, because they aren't NOVA's checks)
- anything that failed
The record comes from what actually happened, not from the AI's own summary.
UNVERIFIED is not FAIL
UNVERIFIED usually means NOVA didn't recognise how to check your project, often because there's no package.json, pyproject.toml or similar file. The work may be completely right. To find out more:
nova verifyIt explains why nothing ran. Then run your own tests.
Handoff notes
Each task that changes files also saves a readable handoff note in .nova/receipts/ in your project. It lists what changed, which checks ran, and which didn't and why (under Not checked). Print one any time:
nova handoff --save # also save it
Stale results
A result only counts while the code it checked is unchanged. If files change afterwards, for example when you resume a session a day later, NOVA shows an old pass as stale rather than current.
Join our Discord
Chat with our engineers and become part of the active NOVA developer community.
Need help?
Open an issue on GitHub or email support@bridgeye.com.