{"row":{"id":"ADR-084","title":"nika-catalog builtin set · reconciliation to spec 26 (42→26 stdlib collapse + json_merge cut)","file":"adr-084-nika-catalog-spec-26-reconciliation.md","status":"accepted","date":"2026-05-27","cites":7,"supersedes":[],"superseded_by":[],"layers":["L0"],"tags":["nika-catalog","nika-schema","builtins","stdlib"],"room":true},"pin":{"release_tag":"v0.107.0","commit":"5d61b7e13f1f6a10c17414f61146648f76bcf2bd"}}

[{"k":"h","depth":1,"text":"ADR-084 · nika-catalog reconciliation to spec 26","id":"adr-084--nika-catalog-reconciliation-to-spec-26"},{"k":"h","depth":2,"text":"Context","id":"context"},{"k":"p","inline":[{"k":"code","text":"nika/spec/stdlib/builtins-v0.1.md"},{"k":"text","text":" (the canonical workflow language stdlib\nper ADR-082 single-version-marker envelope "},{"k":"code","text":"nika: v1"},{"k":"text","text":") ships "},{"k":"strong","text":"26 builtins\nacross 5 categories"},{"k":"text","text":" as of D-2026-05-22-N6 stdlib-collapse + 2026-05-27\n"},{"k":"code","text":"nika:json_merge"},{"k":"text","text":" cut. The engine's "},{"k":"code","text":"nika-catalog::ALL_BUILTINS"},{"k":"text","text":" carried\n"},{"k":"strong","text":"63 entries across 10 categories"},{"k":"text","text":" as a fossil of pre-D-N6 era (engine\ninventory grew during Sprint 2 + media planning before the spec\nminimalism doctrine locked)."}]},{"k":"p","inline":[{"k":"text","text":"A monorepo-side §2.6 Signal 7 verify-the-auditor catch (2026-05-27 ·\n"},{"k":"code","text":"studio/architecture/research/2026-05-27-g1-builtins-enum-codegen-design.md"},{"k":"text","text":"\n§10 BLOCKER) surfaced the drift empirically · engine first-5 names were\n"},{"k":"code","text":"aggregate · assert · chart · chunk · compare"},{"k":"text","text":" vs spec first-5\n"},{"k":"code","text":"sleep · log · emit · assert · prompt"},{"k":"text","text":". The drift gates the future\nschemars-adoption G1 codegen (builtin-enum closed set in\n"},{"k":"code","text":"workflow.schema.json"},{"k":"text","text":" for LSP-perfect completion · proposed-blocked\nuntil catalog reconciliation lands)."}]},{"k":"p","inline":[{"k":"text","text":"This ADR locks the catalog reconciliation as the structural close."}]},{"k":"h","depth":2,"text":"Decision","id":"decision"},{"k":"p","inline":[{"k":"code","text":"nika-catalog::ALL_BUILTINS"},{"k":"text","text":" and "},{"k":"code","text":"nika-catalog::types::builtin::BuiltinCategory"},{"k":"text","text":"\nreconcile to spec source-of-truth "},{"k":"code","text":"nika/spec/stdlib/builtins-v0.1.md"},{"k":"text","text":" ·"}]},{"k":"list","ordered":false,"items":[[{"k":"strong","text":"`ALL_BUILTINS`"},{"k":"text","text":" · 63 → 26 entries (46 legacy removed · 9 spec-only\nadded · 17 keeps recategorised to the simplified 5-category enum)."}],[{"k":"strong","text":"`BuiltinCategory`"},{"k":"text","text":" · 10 → 5 variants ·"},{"k":"text","text":"- KEEP · `Core` · `File` · `Data` · `Introspection`\n- ADD · `Network` (for `fetch` + `notify` · spec category)\n- REMOVE · `DataSprint2` · `CostRecords` · `Agent` · `MediaAlwaysOn` ·\n  `MediaCore` · `MediaOptIn` (6 variants · the 46 legacy entries that\n  used them are all cut · zero workspace consumer matches on these\n  variants per `grep -rn \"BuiltinCategory::<v>\" crates/`)."}],[{"k":"strong","text":"`nika-schema::trust.rs`"},{"k":"text","text":" · 67 hardcoded "},{"k":"code","text":"\"nika:<name>\""},{"k":"text","text":" strings\nreduced to 26 across 3 trust categories (PROPAGATING 7 · PURE 14 ·\nEXTERNAL 5 · the legacy REFERENCE category consolidated into\nPROPAGATING since they were semantically equivalent per the existing\ntrust.rs comment · REFERENCE re-instates when media DEFERRED builtins\nland per LOCK-031)."}],[{"k":"strong","text":"Doc-comments"},{"k":"text","text":" · "},{"k":"code","text":"63 tools across 10 categories"},{"k":"text","text":" → "},{"k":"code","text":"26 tools across 5 categories"},{"k":"text","text":" (line 6 of "},{"k":"code","text":"types/builtin.rs"},{"k":"text","text":")."}]]},{"k":"h","depth":2,"text":"Per-spec-category mapping (the canonical 26)","id":"per-spec-category-mapping-the-canonical-26"},{"k":"list","ordered":false,"items":[[{"k":"text","text":"Category · N · Builtins"}],[{"k":"text","text":"Core · 7 · `sleep` · `log` · `emit` · `assert` · `prompt` · `done` · `wait_until`"}],[{"k":"text","text":"File · 5 · `read` · `write` · `edit` · `glob` · `grep`"}],[{"k":"text","text":"Data · 8 · `jq` · `json_diff` · `validate` · `json_merge_patch` · `csv_to_json` · `uuid` · `date` · `hash`"}],[{"k":"text","text":"Network · 2 · `fetch` · `notify`"}],[{"k":"text","text":"Introspection · 4 · `cost` · `records` · `dag_info` · `threads`"}]]},{"k":"p","inline":[{"k":"text","text":"Total · 26. Alphabetically sorted in "},{"k":"code","text":"ALL_BUILTINS"},{"k":"text","text":" (binary-search\ninvariant preserved · unit-test "},{"k":"code","text":"sorted_order"},{"k":"text","text":" GREEN)."}]},{"k":"h","depth":2,"text":"Trust-category mapping (per `nika-schema::trust.rs`)","id":"trust-category-mapping-per-nika-schematrustrs"},{"k":"list","ordered":false,"items":[[{"k":"text","text":"Trust class · N · Builtins · Output trust"}],[{"k":"text","text":"PROPAGATING · 7 · `csv_to_json` · `glob` · `grep` · `jq` · `json_diff` · `json_merge_patch` · `read` · input"}],[{"k":"text","text":"PURE · 14 · `assert` · `cost` · `dag_info` · `date` · `done` · `emit` · `hash` · `log` · `records` · `sleep` · `threads` · `uuid` · `validate` · `wait_until` · Trusted"}],[{"k":"text","text":"EXTERNAL · 5 · `edit` · `fetch` · `notify` · `prompt` · `write` · Untrusted"}]]},{"k":"p","inline":[{"k":"text","text":"Total · 26. Conservative classification · file "},{"k":"code","text":"edit"},{"k":"text","text":" is EXTERNAL (writes\nto disk · observable side-effect) · file "},{"k":"code","text":"read"},{"k":"text","text":"/"},{"k":"code","text":"glob"},{"k":"text","text":"/"},{"k":"code","text":"grep"},{"k":"text","text":" are\nPROPAGATING (input-trust passes through · no observable side-effect).\n"},{"k":"code","text":"prompt"},{"k":"text","text":" is EXTERNAL because human/API input is by definition Untrusted\nfloor."}]},{"k":"h","depth":2,"text":"Consequences","id":"consequences"},{"k":"h","depth":3,"text":"Positive","id":"positive"},{"k":"list","ordered":false,"items":[[{"k":"strong","text":"Spec ↔ engine parity"},{"k":"text","text":" · "},{"k":"code","text":"nika-catalog"},{"k":"text","text":" now mirrors "},{"k":"code","text":"nika/spec/stdlib"},{"k":"text","text":"\nexactly · the catch-class « engine carries phantoms vs spec » closes\nstructurally · future schemars-adoption G1 codegen (ADR-085 reserved)\nunblocks · "},{"k":"code","text":"workflow.schema.json"},{"k":"text","text":" "},{"k":"code","text":"builtin_name"},{"k":"text","text":" can ratchet from\npermissive pattern to closed enum derived from "},{"k":"code","text":"ALL_BUILTINS"},{"k":"text","text":"."}],[{"k":"strong","text":"Trust surface lean"},{"k":"text","text":" · 67 → 26 hardcoded refs in "},{"k":"code","text":"trust.rs"},{"k":"text","text":" · -61%\nsurface area · easier to audit + verify the trust-floor invariant."}],[{"k":"strong","text":"SemVer-clean enum simplification"},{"k":"text","text":" · "},{"k":"code","text":"BuiltinCategory"},{"k":"text","text":" removes 6\nvariants but "},{"k":"code","text":"#[non_exhaustive]"},{"k":"text","text":" is on the enum AND zero workspace\nconsumers match on the removed variants · the breaking change is\ntheoretical ("},{"k":"code","text":"cargo public-api"},{"k":"text","text":" will flag but no actual call-site\nbreaks)."}],[{"k":"strong","text":"Forward-compat"},{"k":"text","text":" · "},{"k":"code","text":"Network"},{"k":"text","text":" variant added per "},{"k":"code","text":"#[non_exhaustive]"},{"k":"text","text":"\nratchet · safely consumable when downstream wants per-category trust\ndefaults. REFERENCE class consolidation into PROPAGATING is reversible\nif media builtins re-emerge (current LOCK-031 DEFERRED)."}]]},{"k":"h","depth":3,"text":"Negative","id":"negative"},{"k":"list","ordered":false,"items":[[{"k":"strong","text":"Public API surface change"},{"k":"text","text":" · "},{"k":"code","text":"BuiltinCategory"},{"k":"text","text":" enum membership\nreshuffles · "},{"k":"code","text":"cargo public-api"},{"k":"text","text":" diff will show removed variants.\nAcceptable per ADR-002 (amended D-2026-06-20-N1 · real semver toward 1.0) ·\nthe workspace is pre-1.0 · breaking MINOR ratchets are allowed pre-launch."}],[{"k":"strong","text":"Trust.rs REFERENCE category gone"},{"k":"text","text":" · the documentation-only split\nbetween PROPAGATING and REFERENCE (both passed input trust) is now\ncollapsed · reintroduces when media DEFERRED builtins land. Cost ·\n~0 (semantically equivalent today · just a code-organization signal)."}]]},{"k":"h","depth":3,"text":"Neutral","id":"neutral"},{"k":"list","ordered":false,"items":[[{"k":"strong","text":"Tests · +2 net new"},{"k":"text","text":" · "},{"k":"code","text":"legacy_builtins_unknown_post_d_n6"},{"k":"text","text":" (trust)"},{"k":"text","text":"+ `category_totals_match_spec_26` (trust) · plus `builtin_count`\n+ `category_counts` + `is_known_builtin_works` updated for the new\ntotals. 1170 baseline → 1172 tests GREEN."}]]},{"k":"h","depth":2,"text":"Alternatives considered","id":"alternatives-considered"},{"k":"h","depth":3,"text":"A · Keep 63 catalog · LSP codegen filters to spec 26 at build time","id":"a--keep-63-catalog--lsp-codegen-filters-to-spec-26-at-build-time"},{"k":"p","inline":[{"k":"text","text":"REJECTED · the source-of-truth divergence stays · spec ↔ engine parity\nis never structural · drift recurs at each spec update · two truth\nsources is the anti-pattern this ADR closes."}]},{"k":"h","depth":3,"text":"B · Defer to L2 `nika-builtin` admission (the MEMORY-pointer framing)","id":"b--defer-to-l2-nika-builtin-admission-the-memory-pointer-framing"},{"k":"p","inline":[{"k":"text","text":"REJECTED post user-explicit override (« ship reconciliation now »\nAskUserQuestion 2026-05-27). The L2-future framing remained valid as\nlong as no consumer needed the spec-26 set today · the schemars-adoption\nG1 plan + the canon coherence work surfaced an immediate consumer signal\nthat overrode the LOCK-031 spirit · the user redirected accordingly.\nDocumented per "},{"k":"code","text":"dx/.claude/rules/socratic-research-discipline.md"},{"k":"text","text":" §5c\n(Option D · don't pick least bad)."}]},{"k":"h","depth":3,"text":"C · Mass-rename engine to keep 63 set + mark legacy as deprecated","id":"c--mass-rename-engine-to-keep-63-set--mark-legacy-as-deprecated"},{"k":"p","inline":[{"k":"text","text":"REJECTED · violates "},{"k":"code","text":"dx/.claude/rules/no-legacy-no-back-compat.md"},{"k":"text","text":"\nNUKE-LEGACY doctrine + Class 1 single-canonical-set discipline ·\ndeprecated-alias drift accumulates · git history is the archive."}]},{"k":"h","depth":2,"text":"Gate verification","id":"gate-verification"},{"k":"p","inline":[{"k":"text","text":"This is a refactor of admitted-crate data + types (not a new crate\nadmission) · the ADR-003 12-gate ceremony reduces to applicable gates ·"}]},{"k":"list","ordered":false,"items":[[{"k":"strong","text":"Gate 2 TDD"},{"k":"text","text":" · ✓ existing tests updated to spec 26 · 2 new tests\nadded · 1172 lib tests GREEN."}],[{"k":"strong","text":"Gate 3 IMPL"},{"k":"text","text":" · ✓ "},{"k":"code","text":"cargo check --workspace"},{"k":"text","text":" GREEN."}],[{"k":"strong","text":"Gate 4 CLIPPY"},{"k":"text","text":" · ✓ "},{"k":"code","text":"cargo clippy --workspace --all-targets -- -D warnings"},{"k":"text","text":" 0 warnings (post 8 doc_markdown backtick fixes)."}],[{"k":"strong","text":"Gate 8 DOCS"},{"k":"text","text":" · ✓ "},{"k":"code","text":"cargo doc --no-deps -p nika-catalog -p nika-schema"},{"k":"text","text":"\n0 warnings."}],[{"k":"strong","text":"Gate 12 ATOMIC"},{"k":"text","text":" · ✓ single commit · co-authored Nika 🦋."}],[{"k":"code","text":"cargo fmt --check"},{"k":"text","text":" ✓ GREEN."}],[{"k":"code","text":"cargo deny check"},{"k":"text","text":" ✓ advisories/bans/licenses/sources ok."}],[{"k":"text","text":"Gates 1 / 5 / 6 / 7 / 9 / 10 / 11 · N/A for data refactor (no new\ncrate · no new logic surface beyond data shape)."}]]},{"k":"h","depth":2,"text":"Companion artefacts","id":"companion-artefacts"},{"k":"list","ordered":false,"items":[[{"k":"code","text":"nika-catalog/src/data/builtins.rs"},{"k":"text","text":" · 63 → 26 entries · 5-category\nreorganization · tests updated."}],[{"k":"code","text":"nika-catalog/src/types/builtin.rs"},{"k":"text","text":" · "},{"k":"code","text":"BuiltinCategory"},{"k":"text","text":" 10 → 5\nvariants · doc-comment refreshed."}],[{"k":"code","text":"nika-catalog/src/lib.rs"},{"k":"text","text":" · "},{"k":"code","text":"all_builtins_non_empty"},{"k":"text","text":" test 63 → 26."}],[{"k":"code","text":"nika-schema/src/trust.rs"},{"k":"text","text":" · 67 → 26 hardcoded refs · 4 → 3 trust\ncategory lists · 2 new tests."}],[{"k":"code","text":"studio/architecture/research/2026-05-27-g1-builtins-enum-codegen-design.md"},{"k":"text","text":"\n· §10 BLOCKER inventory + reconciliation scope (the design + audit\ntrail · monorepo-side)."}],[{"k":"code","text":"nika/spec/stdlib/builtins-v0.1.md"},{"k":"text","text":" · the canonical source-of-truth\n(unchanged · this ADR mirrors it into the engine)."}]]},{"k":"h","depth":2,"text":"References","id":"references"},{"k":"list","ordered":false,"items":[[{"k":"code","text":"nika/spec/stdlib/builtins-v0.1.md"},{"k":"text","text":" · spec canonical 26 + cuts"}],[{"k":"text","text":"ADR-082 · envelope "},{"k":"code","text":"nika: v1"},{"k":"text","text":" single-version-marker"}],[{"k":"text","text":"D-2026-05-22-N6 · stdlib-collapse 42 → 27 (monorepo decision)"}],[{"k":"text","text":"2026-05-27 "},{"k":"code","text":"nika:json_merge"},{"k":"text","text":" cut · "},{"k":"code","text":"jaq"},{"k":"text","text":" source-verified"}],[{"k":"code","text":"dx/.claude/rules/no-legacy-no-back-compat.md"},{"k":"text","text":" · NUKE-LEGACY discipline"}],[{"k":"code","text":"dx/.claude/rules/cross-source-validation.md"},{"k":"text","text":" §2.6 Signal 7 verify-the-auditor"}],[{"k":"code","text":"dx/.claude/rules/round-1-ship-pattern.md"},{"k":"text","text":" §6 LOCK-031 trigger-gated"}]]},{"k":"p","inline":[{"k":"text","text":"🦋"}]}]

ADR-084

nika-catalog builtin set · reconciliation to spec 26 (42→26 stdlib collapse + json_merge cut)

accepted · 2026-05-27 · L0 · cites 7

ADR-084 · nika-catalog reconciliation to spec 26 #

Context #

nika/spec/stdlib/builtins-v0.1.md (the canonical workflow language stdlib per ADR-082 single-version-marker envelope nika: v1) ships 26 builtins across 5 categories as of D-2026-05-22-N6 stdlib-collapse + 2026-05-27 nika:json_merge cut. The engine's nika-catalog::ALL_BUILTINS carried 63 entries across 10 categories as a fossil of pre-D-N6 era (engine inventory grew during Sprint 2 + media planning before the spec minimalism doctrine locked).

A monorepo-side §2.6 Signal 7 verify-the-auditor catch (2026-05-27 · studio/architecture/research/2026-05-27-g1-builtins-enum-codegen-design.md §10 BLOCKER) surfaced the drift empirically · engine first-5 names were aggregate · assert · chart · chunk · compare vs spec first-5 sleep · log · emit · assert · prompt. The drift gates the future schemars-adoption G1 codegen (builtin-enum closed set in workflow.schema.json for LSP-perfect completion · proposed-blocked until catalog reconciliation lands).

This ADR locks the catalog reconciliation as the structural close.

Decision #

nika-catalog::ALL_BUILTINS and nika-catalog::types::builtin::BuiltinCategory reconcile to spec source-of-truth nika/spec/stdlib/builtins-v0.1.md ·

`ALL_BUILTINS` · 63 → 26 entries (46 legacy removed · 9 spec-only added · 17 keeps recategorised to the simplified 5-category enum).
`BuiltinCategory` · 10 → 5 variants ·- KEEP · `Core` · `File` · `Data` · `Introspection` - ADD · `Network` (for `fetch` + `notify` · spec category) - REMOVE · `DataSprint2` · `CostRecords` · `Agent` · `MediaAlwaysOn` · `MediaCore` · `MediaOptIn` (6 variants · the 46 legacy entries that used them are all cut · zero workspace consumer matches on these variants per `grep -rn "BuiltinCategory::<v>" crates/`).
`nika-schema::trust.rs` · 67 hardcoded "nika:<name>" strings reduced to 26 across 3 trust categories (PROPAGATING 7 · PURE 14 · EXTERNAL 5 · the legacy REFERENCE category consolidated into PROPAGATING since they were semantically equivalent per the existing trust.rs comment · REFERENCE re-instates when media DEFERRED builtins land per LOCK-031).
Doc-comments · 63 tools across 10 categories → 26 tools across 5 categories (line 6 of types/builtin.rs).

Per-spec-category mapping (the canonical 26) #

Category · N · Builtins
Core · 7 · `sleep` · `log` · `emit` · `assert` · `prompt` · `done` · `wait_until`
File · 5 · `read` · `write` · `edit` · `glob` · `grep`
Data · 8 · `jq` · `json_diff` · `validate` · `json_merge_patch` · `csv_to_json` · `uuid` · `date` · `hash`
Network · 2 · `fetch` · `notify`
Introspection · 4 · `cost` · `records` · `dag_info` · `threads`

Total · 26. Alphabetically sorted in ALL_BUILTINS (binary-search invariant preserved · unit-test sorted_order GREEN).

Trust-category mapping (per `nika-schema::trust.rs`) #

Trust class · N · Builtins · Output trust
PROPAGATING · 7 · `csv_to_json` · `glob` · `grep` · `jq` · `json_diff` · `json_merge_patch` · `read` · input
PURE · 14 · `assert` · `cost` · `dag_info` · `date` · `done` · `emit` · `hash` · `log` · `records` · `sleep` · `threads` · `uuid` · `validate` · `wait_until` · Trusted
EXTERNAL · 5 · `edit` · `fetch` · `notify` · `prompt` · `write` · Untrusted

Total · 26. Conservative classification · file edit is EXTERNAL (writes to disk · observable side-effect) · file read/glob/grep are PROPAGATING (input-trust passes through · no observable side-effect). prompt is EXTERNAL because human/API input is by definition Untrusted floor.

Consequences #

Positive #

Spec ↔ engine parity · nika-catalog now mirrors nika/spec/stdlib exactly · the catch-class « engine carries phantoms vs spec » closes structurally · future schemars-adoption G1 codegen (ADR-085 reserved) unblocks · workflow.schema.json builtin_name can ratchet from permissive pattern to closed enum derived from ALL_BUILTINS.
Trust surface lean · 67 → 26 hardcoded refs in trust.rs · -61% surface area · easier to audit + verify the trust-floor invariant.
SemVer-clean enum simplification · BuiltinCategory removes 6 variants but #[non_exhaustive] is on the enum AND zero workspace consumers match on the removed variants · the breaking change is theoretical (cargo public-api will flag but no actual call-site breaks).
Forward-compat · Network variant added per #[non_exhaustive] ratchet · safely consumable when downstream wants per-category trust defaults. REFERENCE class consolidation into PROPAGATING is reversible if media builtins re-emerge (current LOCK-031 DEFERRED).

Negative #

Public API surface change · BuiltinCategory enum membership reshuffles · cargo public-api diff will show removed variants. Acceptable per ADR-002 (amended D-2026-06-20-N1 · real semver toward 1.0) · the workspace is pre-1.0 · breaking MINOR ratchets are allowed pre-launch.
Trust.rs REFERENCE category gone · the documentation-only split between PROPAGATING and REFERENCE (both passed input trust) is now collapsed · reintroduces when media DEFERRED builtins land. Cost · ~0 (semantically equivalent today · just a code-organization signal).

Neutral #

Tests · +2 net new · legacy_builtins_unknown_post_d_n6 (trust)+ `category_totals_match_spec_26` (trust) · plus `builtin_count` + `category_counts` + `is_known_builtin_works` updated for the new totals. 1170 baseline → 1172 tests GREEN.

Alternatives considered #

A · Keep 63 catalog · LSP codegen filters to spec 26 at build time #

REJECTED · the source-of-truth divergence stays · spec ↔ engine parity is never structural · drift recurs at each spec update · two truth sources is the anti-pattern this ADR closes.

B · Defer to L2 `nika-builtin` admission (the MEMORY-pointer framing) #

REJECTED post user-explicit override (« ship reconciliation now » AskUserQuestion 2026-05-27). The L2-future framing remained valid as long as no consumer needed the spec-26 set today · the schemars-adoption G1 plan + the canon coherence work surfaced an immediate consumer signal that overrode the LOCK-031 spirit · the user redirected accordingly. Documented per dx/.claude/rules/socratic-research-discipline.md §5c (Option D · don't pick least bad).

C · Mass-rename engine to keep 63 set + mark legacy as deprecated #

REJECTED · violates dx/.claude/rules/no-legacy-no-back-compat.md NUKE-LEGACY doctrine + Class 1 single-canonical-set discipline · deprecated-alias drift accumulates · git history is the archive.

Gate verification #

This is a refactor of admitted-crate data + types (not a new crate admission) · the ADR-003 12-gate ceremony reduces to applicable gates ·

Gate 2 TDD · ✓ existing tests updated to spec 26 · 2 new tests added · 1172 lib tests GREEN.
Gate 3 IMPL · ✓ cargo check --workspace GREEN.
Gate 4 CLIPPY · ✓ cargo clippy --workspace --all-targets -- -D warnings 0 warnings (post 8 doc_markdown backtick fixes).
Gate 8 DOCS · ✓ cargo doc --no-deps -p nika-catalog -p nika-schema 0 warnings.
Gate 12 ATOMIC · ✓ single commit · co-authored Nika 🦋.
cargo fmt --check ✓ GREEN.
cargo deny check ✓ advisories/bans/licenses/sources ok.
Gates 1 / 5 / 6 / 7 / 9 / 10 / 11 · N/A for data refactor (no new crate · no new logic surface beyond data shape).

Companion artefacts #

nika-catalog/src/data/builtins.rs · 63 → 26 entries · 5-category reorganization · tests updated.
nika-catalog/src/types/builtin.rs · BuiltinCategory 10 → 5 variants · doc-comment refreshed.
nika-catalog/src/lib.rs · all_builtins_non_empty test 63 → 26.
nika-schema/src/trust.rs · 67 → 26 hardcoded refs · 4 → 3 trust category lists · 2 new tests.
studio/architecture/research/2026-05-27-g1-builtins-enum-codegen-design.md · §10 BLOCKER inventory + reconciliation scope (the design + audit trail · monorepo-side).
nika/spec/stdlib/builtins-v0.1.md · the canonical source-of-truth (unchanged · this ADR mirrors it into the engine).

References #

nika/spec/stdlib/builtins-v0.1.md · spec canonical 26 + cuts
ADR-082 · envelope nika: v1 single-version-marker
D-2026-05-22-N6 · stdlib-collapse 42 → 27 (monorepo decision)
2026-05-27 nika:json_merge cut · jaq source-verified
dx/.claude/rules/no-legacy-no-back-compat.md · NUKE-LEGACY discipline
dx/.claude/rules/cross-source-validation.md §2.6 Signal 7 verify-the-auditor
dx/.claude/rules/round-1-ship-pattern.md §6 LOCK-031 trigger-gated

🦋

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

Every decision, with its status This one in the repo