{"row":{"id":"ADR-116","title":"nika serve v0 was a local-only resident firer","file":"adr-116-nika-serve-resident-firer.md","status":"superseded","date":"2026-08-19","cites":2,"supersedes":[],"superseded_by":["ADR-117"],"layers":["L0","L4"],"tags":["architecture","cadence","arm","serve"],"room":true},"pin":{"release_tag":"v0.114.0","commit":"b1154df75255ee3538c7e1848e85f6d3abb54349"}}

[{"k":"h","depth":1,"text":"ADR-116: `nika serve` v0 was a local-only resident firer","id":"adr-116-nika-serve-v0-was-a-local-only-resident-firer"},{"k":"h","depth":2,"text":"Status and provenance","id":"status-and-provenance"},{"k":"p","inline":[{"k":"text","text":"This is a historical tombstone, not a retroactive claim that this ADR was\npreviously canonical. The original accepted-form document existed only on the\nclosed, unmerged PR #1006 ("},{"k":"code","text":"c224e1bdc"},{"k":"text","text":"). The local resident-firer code later\nlanded through PR #1008 without that ADR. Reintroducing the number preserves a\nmachine-valid decision lineage before ADR-117 supersedes it."}]},{"k":"h","depth":2,"text":"Historical decision","id":"historical-decision"},{"k":"p","inline":[{"k":"code","text":"nika serve"},{"k":"text","text":" v0 was the same ARM firer kept resident by a loop. It read the\nproject's "},{"k":"code","text":"nika.yaml"},{"k":"text","text":", the referenced workflow shelf, and "},{"k":"code","text":".nika/arm/"},{"k":"text","text":" state.\nIt did not open a port, accept a socket, or expose a remote trigger. Cadence\nselection remained in "},{"k":"code","text":"nika-cadence"},{"k":"text","text":"; filesystem custody, firing, and rendering\nremained in "},{"k":"code","text":"nika-cli"},{"k":"text","text":"."}]},{"k":"p","inline":[{"k":"text","text":"The shipped surface is narrower and more precise than the withdrawn document's\nprose:"}]},{"k":"list","ordered":false,"items":[[{"k":"code","text":"--once"},{"k":"text","text":" executes every due local beat once, records the result, then exits;\nit is not a rehearsal."}],[{"k":"code","text":"--dry"},{"k":"text","text":" prints the "},{"k":"code","text":"nika_cadence::due"},{"k":"text","text":" projection and runs nothing; it does\nnot call the full firing decision machine."}],[{"k":"text","text":"a malformed reload is reported while the last valid registry remains active;\nthe current implementation does not poison the served set."}]]},{"k":"p","inline":[{"k":"text","text":"These statements are characterization of the current code, not new behavior."}]},{"k":"h","depth":2,"text":"Why it is superseded","id":"why-it-is-superseded"},{"k":"p","inline":[{"k":"text","text":"An HTTP execution surface changes the input, identity, replay, and data-release\nboundaries. Treating it as a small extension of this local loop would make the\nCLI own transport, authentication, execution composition, job state, and ARM\ncustody at once. ADR-117 therefore preserves the local default but replaces the\narchitectural decision for any networked Serve mode."}]},{"k":"h","depth":2,"text":"Evidence","id":"evidence"},{"k":"list","ordered":false,"items":[[{"k":"code","text":"crates/nika-cli/src/verbs/serve.rs"},{"k":"text","text":" — resident local loop and current option\nsemantics."}],[{"k":"code","text":"crates/nika-cli/tests/serve.rs"},{"k":"text","text":" — real-binary once, reload, cloud-refusal,\nand signal behavior."}],[{"k":"code","text":"crates/nika-cadence/src/firing.rs"},{"k":"text","text":" — pure cadence and firing judgment."}],[{"k":"text","text":"PR #1006 — withdrawn source of this ADR number."}],[{"k":"text","text":"PR #1008 — carrier that shipped the local resident firer without the ADR."}]]},{"k":"h","depth":2,"text":"Consequences retained by ADR-117","id":"consequences-retained-by-adr-117"},{"k":"list","ordered":false,"items":[[{"k":"text","text":"Bare "},{"k":"code","text":"nika serve"},{"k":"text","text":" remains local and opens no listener."}],[{"k":"text","text":"ARM's verified ledger remains the firing truth."}],[{"k":"text","text":"Network input cannot appear as an ambient new default."}]]},{"k":"h","depth":2,"text":"Related","id":"related"},{"k":"list","ordered":false,"items":[[{"k":"text","text":"ADR-114 — cadence and verified ledger authority."}],[{"k":"text","text":"ADR-117 — superseding Serve transport and trust boundary."}]]}]

ADR-116

nika serve v0 was a local-only resident firer

superseded · 2026-08-19 · L0 L4 · cites 2

Superseded by ADR-117. This decision is kept because its successor cites it.

ADR-116: `nika serve` v0 was a local-only resident firer #

Status and provenance #

This is a historical tombstone, not a retroactive claim that this ADR was previously canonical. The original accepted-form document existed only on the closed, unmerged PR #1006 (c224e1bdc). The local resident-firer code later landed through PR #1008 without that ADR. Reintroducing the number preserves a machine-valid decision lineage before ADR-117 supersedes it.

Historical decision #

nika serve v0 was the same ARM firer kept resident by a loop. It read the project's nika.yaml, the referenced workflow shelf, and .nika/arm/ state. It did not open a port, accept a socket, or expose a remote trigger. Cadence selection remained in nika-cadence; filesystem custody, firing, and rendering remained in nika-cli.

The shipped surface is narrower and more precise than the withdrawn document's prose:

--once executes every due local beat once, records the result, then exits; it is not a rehearsal.
--dry prints the nika_cadence::due projection and runs nothing; it does not call the full firing decision machine.
a malformed reload is reported while the last valid registry remains active; the current implementation does not poison the served set.

These statements are characterization of the current code, not new behavior.

Why it is superseded #

An HTTP execution surface changes the input, identity, replay, and data-release boundaries. Treating it as a small extension of this local loop would make the CLI own transport, authentication, execution composition, job state, and ARM custody at once. ADR-117 therefore preserves the local default but replaces the architectural decision for any networked Serve mode.

Evidence #

crates/nika-cli/src/verbs/serve.rs — resident local loop and current option semantics.
crates/nika-cli/tests/serve.rs — real-binary once, reload, cloud-refusal, and signal behavior.
crates/nika-cadence/src/firing.rs — pure cadence and firing judgment.
PR #1006 — withdrawn source of this ADR number.
PR #1008 — carrier that shipped the local resident firer without the ADR.

Consequences retained by ADR-117 #

Bare nika serve remains local and opens no listener.
ARM's verified ledger remains the firing truth.
Network input cannot appear as an ambient new default.

ADR-114 — cadence and verified ledger authority.
ADR-117 — superseding Serve transport and trust boundary.

read at v0.114.0 · the decision record ships with the engine

Every decision, with its status This one in the repo