Live project control plane. The released engine discovers
nika.yaml from the working directory toward its ancestors. The file is optional when built-in defaults are enough. Its project-shape grammar is closed: nika · ceiling · arm · traces · registry. Direct runs and the cadence path (nika arm · nika serve) read the same file.Run spend
SPEND LADDER · CLOSEST EXPLICIT DECISION WINS
maxCostUsd is invocation-specific. Keep the project default in nika.yaml
instead of copying it into every application call.
Trace retention
NIKA_TRACE_* environment knob wins over the project retention
rung, then the engine default applies. This lets an immutable project run
under different operational retention obligations.
Registry provenance
~/.nika. A
repository can demand stronger provenance. It cannot weaken the machine
owner’s floor.
In 0.124.3 a first fetch of a
registry: coordinate is refused
(NIKA-REG-005) whatever the floor says: take the workflow file from the
registry repository and use it by path
(Known limits).Keep one owner per decision
Continue
SDK configuration
Constructor and call-level options.
Security boundary
Permits, secrets, argv and cancellation.
Project file
The closed grammar behind these ladders.
Arm registry
Per-tick money and missed-run policy.