{"row":{"id":"ADR-110","title":"nika-cli size-cap member split: the host plane descends to nika-cli-host","file":"adr-110-nika-cli-host-member-split.md","status":"accepted","date":"2026-07-31","cites":3,"supersedes":[],"superseded_by":[],"layers":["L4"],"tags":["architecture","crates","split","size-cap"],"room":true},"pin":{"release_tag":"v0.107.0","commit":"5d61b7e13f1f6a10c17414f61146648f76bcf2bd"}}

[{"k":"h","depth":1,"text":"ADR-110: nika-cli size-cap member split — nika-cli-host","id":"adr-110-nika-cli-size-cap-member-split--nika-cli-host"},{"k":"h","depth":2,"text":"Context","id":"context"},{"k":"p","inline":[{"k":"text","text":"The trust-experience arc (2026-07-31 · 22 P0 closures) grew "},{"k":"code","text":"nika-cli"},{"k":"text","text":"\npast the 15,000 prod-LOC Diamond invariant: vector 24 measured 17,789\nat the pre-push gate. The cap is a locked maintainability budget\n(nika-invariants.md), not advisory. Two descents already set the\npattern: the display surface to "},{"k":"code","text":"nika-display"},{"k":"text","text":" (2026-07-10) and the\nrun composer to "},{"k":"code","text":"nika_runtime::compose"},{"k":"text","text":" (2026-07-22) — \"compute\ndescends, render stays.\""}]},{"k":"h","depth":2,"text":"Decision","id":"decision"},{"k":"p","inline":[{"k":"text","text":"Per D-2026-07-09-N1 (a size-cap split is ONE architectural unit in TWO\nworkspace members), the host-integration plane descends to a new L4\nmember crate "},{"k":"code","text":"nika-cli-host"},{"k":"text","text":":"}]},{"k":"list","ordered":false,"items":[[{"k":"code","text":"probe"},{"k":"text","text":" (client/kit probes · capability levels · receipts)"}],[{"k":"code","text":"wire"},{"k":"text","text":" (writers · preview/detected · the clap "},{"k":"code","text":"WireTarget"},{"k":"text","text":" seam)"}],[{"k":"code","text":"doctor"},{"k":"text","text":" (the receipt surface)"}],[{"k":"code","text":"welcome"},{"k":"text","text":" (the front-door glance + SAMPLE)"}],[{"k":"code","text":"clients_registry"},{"k":"text","text":" + the vendored "},{"k":"code","text":"data/clients.registry.yaml"}],[{"k":"code","text":"context_envelope"},{"k":"text","text":" · "},{"k":"code","text":"retention"},{"k":"text","text":" · "},{"k":"code","text":"metrics"},{"k":"text","text":" · "},{"k":"code","text":"text"}],[{"k":"code","text":"output"},{"k":"text","text":" (spec §4 exit codes · "},{"k":"code","text":"VerbOutput"},{"k":"text","text":" · the OSC-8 link seam)"}]]},{"k":"p","inline":[{"k":"code","text":"nika-cli"},{"k":"text","text":" re-exports every public item at its historical path\n("},{"k":"code","text":"verbs::{doctor,probe,welcome,wire}"},{"k":"text","text":" · "},{"k":"code","text":"verbs::{VerbOutput, exit}"},{"k":"text","text":" ·\n"},{"k":"code","text":"metrics"},{"k":"text","text":" · …), so call sites and the bin dispatch stay untouched. The\n"},{"k":"code","text":"local-infer"},{"k":"text","text":" feature forwards member-to-member. Tests coupled to\ncli-side fixtures (retention×trace-store · welcome-SAMPLE×check)\nrelocate cli-side and exercise the re-exported paths."}]},{"k":"h","depth":2,"text":"Alternatives rejected","id":"alternatives-rejected"},{"k":"list","ordered":false,"items":[[{"k":"code","text":"LOC-EXEMPT"},{"k":"text","text":" markers: the whitelist (codegen · lookup-table ·\nenum-mega) does not cover organic verb growth; exempting would erode\nthe ratchet."}],[{"k":"text","text":"A logic/verb split inside one crate: does not move prod LOC out of\nthe crate; churns every verb body for no budget gain."}],[{"k":"text","text":"Blocking the arc on a redesign: the cap exists to force exactly this\nmechanical descent at the moment of overflow."}]]},{"k":"h","depth":2,"text":"Consequences","id":"consequences"},{"k":"list","ordered":false,"items":[[{"k":"text","text":"Vector 24 returns GREEN ("},{"k":"code","text":"nika-cli"},{"k":"text","text":" ≈ 13.5k prod incl. the #771\nmerge; "},{"k":"code","text":"nika-cli-host"},{"k":"text","text":" ≈ 4.5k) with real headroom."}],[{"k":"code","text":"nika-cli-host"},{"k":"text","text":" is a member of the "},{"k":"code","text":"nika-cli"},{"k":"text","text":" unit, not a new\narchitectural unit: same L4 row, "},{"k":"code","text":"publish = false"},{"k":"text","text":", one public\nsurface re-exported by the operator crate."}],[{"k":"text","text":"New "},{"k":"code","text":"crates/nika-cli-host/public-api.txt"},{"k":"text","text":" baseline joins the diff\ngate; "},{"k":"code","text":"crates/nika-cli/public-api.txt"},{"k":"text","text":" re-baselines (items become\nre-exports)."}],[{"k":"text","text":"The next growth inside "},{"k":"code","text":"nika-cli"},{"k":"text","text":" should descend "},{"k":"code","text":"welcome"},{"k":"text","text":"'s glance\ndata walks before the wall bites again."}]]},{"k":"h","depth":2,"text":"Security boundary","id":"security-boundary"},{"k":"p","inline":[{"k":"text","text":"None moved: "},{"k":"code","text":"nika guard"},{"k":"text","text":" and the run path stay in "},{"k":"code","text":"nika-cli"},{"k":"text","text":"; the\nmember carries probes/writers/render-adjacent surfaces only. The\nengine's authority model (permits · cost · secrets · trace) is\nuntouched."}]},{"k":"h","depth":2,"text":"Rollback","id":"rollback"},{"k":"p","inline":[{"k":"text","text":"Reverse "},{"k":"code","text":"git mv"},{"k":"text","text":" + drop the member from workspace "},{"k":"code","text":"members"},{"k":"text","text":" and\n"},{"k":"code","text":"nika-cli"},{"k":"text","text":" deps; the re-export shim keeps the surface stable in both\ndirections."}]}]

ADR-110

nika-cli size-cap member split: the host plane descends to nika-cli-host

accepted · 2026-07-31 · L4 · cites 3

ADR-110: nika-cli size-cap member split — nika-cli-host #

Context #

The trust-experience arc (2026-07-31 · 22 P0 closures) grew nika-cli past the 15,000 prod-LOC Diamond invariant: vector 24 measured 17,789 at the pre-push gate. The cap is a locked maintainability budget (nika-invariants.md), not advisory. Two descents already set the pattern: the display surface to nika-display (2026-07-10) and the run composer to nika_runtime::compose (2026-07-22) — "compute descends, render stays."

Decision #

Per D-2026-07-09-N1 (a size-cap split is ONE architectural unit in TWO workspace members), the host-integration plane descends to a new L4 member crate nika-cli-host:

probe (client/kit probes · capability levels · receipts)
wire (writers · preview/detected · the clap WireTarget seam)
doctor (the receipt surface)
welcome (the front-door glance + SAMPLE)
clients_registry + the vendored data/clients.registry.yaml
context_envelope · retention · metrics · text
output (spec §4 exit codes · VerbOutput · the OSC-8 link seam)

nika-cli re-exports every public item at its historical path (verbs::{doctor,probe,welcome,wire} · verbs::{VerbOutput, exit} · metrics · …), so call sites and the bin dispatch stay untouched. The local-infer feature forwards member-to-member. Tests coupled to cli-side fixtures (retention×trace-store · welcome-SAMPLE×check) relocate cli-side and exercise the re-exported paths.

Alternatives rejected #

LOC-EXEMPT markers: the whitelist (codegen · lookup-table · enum-mega) does not cover organic verb growth; exempting would erode the ratchet.
A logic/verb split inside one crate: does not move prod LOC out of the crate; churns every verb body for no budget gain.
Blocking the arc on a redesign: the cap exists to force exactly this mechanical descent at the moment of overflow.

Consequences #

Vector 24 returns GREEN (nika-cli ≈ 13.5k prod incl. the #771 merge; nika-cli-host ≈ 4.5k) with real headroom.
nika-cli-host is a member of the nika-cli unit, not a new architectural unit: same L4 row, publish = false, one public surface re-exported by the operator crate.
New crates/nika-cli-host/public-api.txt baseline joins the diff gate; crates/nika-cli/public-api.txt re-baselines (items become re-exports).
The next growth inside nika-cli should descend welcome's glance data walks before the wall bites again.

Security boundary #

None moved: nika guard and the run path stay in nika-cli; the member carries probes/writers/render-adjacent surfaces only. The engine's authority model (permits · cost · secrets · trace) is untouched.

Rollback #

Reverse git mv + drop the member from workspace members and nika-cli deps; the re-export shim keeps the surface stable in both directions.

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

Every decision, with its status This one in the repo