Test and trace - Nika

Golden testing is an engine CLI operation:

nika test workflows/release.nika
nika test workflows/release.nika --update

The source SDK does not duplicate that command as a client method. Receipt verification is part of the SDK because it belongs to the run lifecycle.

const run = await nika.run('workflows/release.nika')
const result = await run.result()

if (!result.receipt) throw new Error('run did not issue a receipt')

const verdict = await nika.traceVerify(result.receipt)
if (!verdict.verified) {
  throw new Error(verdict.output ?? verdict.reason ?? 'trace verification failed')
}

traceVerify(receipt) accepts an engine-issued NikaReceipt object only. It does not accept a path and does not reconstruct or verify the chain in TypeScript. The engine reads the existing journal and its evidence. Verification does not seal a trace, and an admitted job does not guarantee a journal exists.

Receipts

Store proof beside application state.

Testing guide

Learn goldens and mock-provider workflows.