Checks & Results

Docs › Core Features › 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

ResultWhat it means
PASSNOVA's checks ran and passed.
FAILA required check failed. The work isn't done yet.
BLOCKEDA check couldn't run, for example because a tool is missing.
SKIPPEDChecks were skipped on purpose, and the reasons are recorded.
UNVERIFIEDNOVA 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:

nova
\test # tests
\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 verify

It 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:

bash
nova handoff
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.

Join Discord

Need help?

Open an issue on GitHub or email support@bridgeye.com.

Get help
Bridgeye • Autonomous Software Engineering.