401294de5d
Config surface — per-project config introspection, coherence verification, and
audited mutation without destroying NCL structure (ADR-008):
- crates/ontoref-daemon/src/config.rs — typed DaemonNclConfig (parse-at-boundary
pattern); all section structs derive ConfigFields + config_section(id, ncl_file)
emitting inventory::submit!(ConfigFieldsEntry{...}) at link time
- crates/ontoref-derive/src/lib.rs — #[derive(ConfigFields)] proc-macro; serde
rename support; serde_rename_of() helper extracted to fix excessive_nesting
- crates/ontoref-daemon/src/main.rs — 3-tuple bootstrap block (nickel_import_path,
loaded_ncl_config: Option<DaemonNclConfig>, stdin_raw); apply_ui_config takes
&UiConfig; NATS call site typed; resolve_asset_dir cfg(feature = "ui")
- crates/ontoref-daemon/src/api.rs — config GET/PUT endpoints, quickref, coherence,
cross-project comparison; index_section_fields() extracted (excessive_nesting)
- crates/ontoref-daemon/src/config_coherence.rs — multi-consumer coherence;
merge_meta_into_section() extracted; and() replaces unnecessary and_then
NCL contracts for ontoref's own config:
- .ontoref/contracts.ncl — LogConfig (LogLevel, LogRotation, PositiveInt) and
DaemonConfig (Port, optional overrides); std.contract.from_validator throughout
- .ontoref/config.ncl — log | C.LogConfig applied
- .ontology/manifest.ncl — contracts_path, log/daemon contract refs, daemon section
with DaemonRuntimeConfig consumer and 7 declared fields
Protocol:
- adrs/adr-008-ncl-first-config-validation-and-override-layer.ncl — NCL contracts
as single validation gate; Rust structs are contract-trusted; override-layer
mutation writes {section}.overrides.ncl + _overrides_meta, never touches source
on+re update:
- .ontology/core.ncl — config-surface node (28 practices); adr-lifecycle extended
to adr-007 + adr-008; 6 new edges (ManifestsIn daemon, DependsOn ontology-crate,
Complements api-catalog-surface/dag-formalized/self-describing/adopt-ontoref)
- .ontology/state.ncl — protocol-maturity blocker and self-description-coverage
catalyst updated for session 2026-03-26
- README.md / CHANGELOG.md updated
63 lines
2.4 KiB
Plaintext
63 lines
2.4 KiB
Plaintext
# Contracts for .ontoref/config.ncl sections.
|
|
#
|
|
# Applied in config.ncl with `section | C.SectionContract = { ... }`.
|
|
# Consumed by the daemon coherence / quickref tooling via the
|
|
# config_surface.sections[].contract field in .ontology/manifest.ncl.
|
|
|
|
let contract = std.contract in
|
|
|
|
# ── Primitive contracts ──────────────────────────────────────────────────────
|
|
|
|
let LogLevel = contract.from_validator (fun value =>
|
|
if std.array.elem value ["error", "warn", "info", "debug", "trace"] then
|
|
'Ok
|
|
else
|
|
'Error { message = "log.level must be one of: error, warn, info, debug, trace" }
|
|
) in
|
|
|
|
let LogRotation = contract.from_validator (fun value =>
|
|
if std.array.elem value ["daily", "hourly", "never"] then
|
|
'Ok
|
|
else
|
|
'Error { message = "log.rotation must be one of: daily, hourly, never" }
|
|
) in
|
|
|
|
let PositiveInt = contract.from_validator (fun value =>
|
|
if std.is_number value && value > 0 then
|
|
'Ok
|
|
else
|
|
'Error { message = "value must be a positive integer (> 0)" }
|
|
) in
|
|
|
|
let Port = contract.from_validator (fun value =>
|
|
if std.is_number value && value >= 1 && value <= 65535 then
|
|
'Ok
|
|
else
|
|
'Error { message = "port must be a number between 1 and 65535" }
|
|
) in
|
|
|
|
# ── Section contracts ────────────────────────────────────────────────────────
|
|
|
|
{
|
|
LogConfig = {
|
|
level | LogLevel | default = "info",
|
|
path | String | default = "logs",
|
|
rotation | LogRotation | default = "daily",
|
|
compress | Bool | default = false,
|
|
archive | String | default = "logs-archive",
|
|
max_files | PositiveInt | default = 7,
|
|
},
|
|
|
|
# All daemon fields are optional — they override CLI defaults only when set.
|
|
# Absent fields fall back to the daemon's built-in defaults (see Cli struct).
|
|
DaemonConfig = {
|
|
port | Port | optional,
|
|
idle_timeout | PositiveInt | optional,
|
|
invalidation_interval | PositiveInt | optional,
|
|
actor_sweep_interval | PositiveInt | optional,
|
|
actor_stale_timeout | PositiveInt | optional,
|
|
max_notifications | PositiveInt | optional,
|
|
notification_ack_required | Array String | default = [],
|
|
},
|
|
}
|