AGPL-3.0-or-later · forever.

the standard library

nika:emit

Emit a custom machine event for subscribers/journal (distinct from log). One of 28 builtins in the closed nika: namespace: control flow and run-stream primitives.

  • corefamily6 tools
  • 2argsdeclared contract
  • 1requiredcheck teaches a miss
  • craftedusage filecheck-green below

the contract

2 args · 1 required

A missing required arg is a nika check finding before anything runs; the vocabulary below comes from the binary itself (nika catalog --tools --json), not from prose.

event_type*
string^[a-z][a-z0-9_.-]*$
payload
any JSON value

in a real file

a complete workflow
emit.nika.yaml
nika: v1workflow:  id: announce-the-ship  description: "a custom machine event for subscribers — distinct from log"tasks:  announce:    on_error:      skip: true    invoke:      tool: "nika:emit"      args:        event_type: "deploy.finished"        payload: { env: "prod", ok: true }

a complete file, nika check green; the drift gate re-validates this copy against the schema on every test run. open it in the playground →

cross-references

ships in skeletons

no skeleton ships it; the crafted file above is the reference.

the check gates

the core family

6 tools

control flow and run-stream primitives.

Machines read the same vocabulary at /tools/catalog.json; the contract lives in spec 06 · stdlib. Install and ask the binary itself: nika catalog --tools. Read the spec →