nx_doc_decision.nx
buildroot/runtime/nx_doc_decision.nx
about
nx_doc_decision.nx -- D20 first stone of V5 docs doctrine.
ADR-shape decision-record primitive. Every substrate decision
carries a reasoning chain: problem -> alternatives -> chosen ->
formula -> physics_justification -> research_opportunities.
Composes with Provenance tier (queued D21) + multi-incumbent
benchmark (queued D22) + dashboard (queued D23).
Per [[feedback-substrate-knowledge-system-s-class-reasoning-
provenance-dashboard]] cardinal. Research absorbed: Architecture
Decision Records (Cognitect/Nygard 2011+, adr.github.io,
Microsoft Azure Well-Architected); MADR template.
**Quadrant:** REFERENCE (Diátaxis)
**Topic Type:** REFERENCE (DITA)
**Status:** DRAFT (D20 first stone)
**Trust State:** WRITTEN_UNTESTED
**Competitive State:** UNCLASSIFIED (no benchmark vs adr-tools yet)
dependencies 2 imports · 4 importers
imports: nx_syscalls.nxnx_string_ops.nx
imported by: nx_doc_dashboard.nxnx_doc_dashboard_substrate_state_test.nxnx_doc_dashboard_test.nxnx_doc_decision_test.nx
structs
| 57 | struct NxDecisionRecord |
consts
| 28 | const NX_DECISION_PROPOSED: i64 = 0 // under consideration |
| 29 | const NX_DECISION_ACCEPTED: i64 = 1 // active, current substrate decision |
| 30 | const NX_DECISION_SUPERSEDED: i64 = 2 // replaced by a later ADR (id in supersedes_by field) |
| 31 | const NX_DECISION_DEPRECATED: i64 = 3 // no longer relevant; preserved for genealogy |
| 32 | const NX_DECISION_REJECTED: i64 = 4 // proposed but not accepted |
| 33 | const NX_DECISION_N: i64 = 5 |
functions
| 35 | func nx_decision_status_is_valid(s: i64) -> i64 |
| 41 | func nx_decision_status_name(s: i64) -> *u8 |
| 78 | func nx_decision_record_init( |
| 112 | func nx_decision_record_completeness(r: *NxDecisionRecord) -> i64 |
| 147 | func _docdec_write_section( |
| 159 | func nx_decision_record_emit(r: *NxDecisionRecord) -> i64 |