#!/usr/bin/env nu # reflection/nulib/bootstrap.nu — NCL pipe bootstrap helper for development use. # # Implements ADR-004: validates config via nickel export and pipes JSON to a # target process via --config-stdin. For interactive/dev use only — system # service launchers must use scripts/ontoref-daemon-start (bash, zero deps). # # Usage: # use reflection/nulib/bootstrap.nu * # ncl-bootstrap "~/.config/ontoref/config.ncl" "ontoref-daemon" --port 7891 # ncl-bootstrap "config.ncl" "myapp" --sops "secrets.enc.json" # ncl-bootstrap "config.ncl" "myapp" --dry-run # print composed JSON # Resolve NICKEL_IMPORT_PATH: config dir + platform data dir schemas. # Prepended to any existing value so external overrides are preserved. def nickel-import-path [ncl_file: string]: nothing -> string { let config_dir = ($ncl_file | path dirname | path expand) let data_dir = if ((sys host | get name) | str starts-with "Mac") { $"($env.HOME)/Library/Application Support/ontoref" } else { $"($env.HOME)/.local/share/ontoref" } let extra = $"($config_dir):($data_dir)/schemas:($data_dir)" let existing = ($env | get -i NICKEL_IMPORT_PATH | default "") if ($existing | is-empty) { $extra } else { $"($extra):($existing)" } } # Default NATS_STREAMS_CONFIG to ~/.config/ontoref/streams.json if not already set. # Allows the daemon to pick up the global topology without a project-local streams.json. def nats-streams-config [ncl_file: string]: nothing -> string { let existing = ($env | get -i NATS_STREAMS_CONFIG | default "") if ($existing | is-not-empty) { return $existing } let config_dir = ($ncl_file | path dirname | path expand) $"($config_dir)/streams.json" } # Validate and export a Bootstrapable NCL config to JSON. # Fails with a structured error if the export fails — the target never starts. def ncl-export-bootstrapable [ncl_file: string]: nothing -> string { if not ($ncl_file | path exists) { error make { msg: $"config not found: ($ncl_file)" } } let import_path = (nickel-import-path $ncl_file) let r = (do { with-env { NICKEL_IMPORT_PATH: $import_path } { ^nickel export --format json $ncl_file } } | complete) if $r.exit_code != 0 { error make { msg: $"config validation failed — daemon not started:\n($r.stderr | str trim)" } } $r.stdout } # Merge two JSON strings (struct config + secrets). Requires jq. def json-merge [base: string, overlay: string]: nothing -> string { let r = (do { echo $"($base)\n($overlay)" | ^jq -s '.[0] * .[1]' } | complete) if $r.exit_code != 0 { error make { msg: $"JSON merge failed:\n($r.stderr | str trim)" } } $r.stdout } # Bootstrap a process from a Bootstrapable NCL config file. # # Stages: # 1. nickel export → validated JSON # 2a. sops --decrypt → secret merge (if --sops) # 2b. vault kv get → secret merge (if --vault) # 3. --config-stdin [args] → process reads JSON from stdin export def ncl-bootstrap [ ncl_file: string, # Bootstrapable NCL config (source of truth) command: string, # target binary to launch --sops: string = "", # path to SOPS-encrypted secrets file --vault: string = "", # Vault kv path for secrets --dry-run = false, # print composed JSON to stdout, don't launch --stdin-flag: string = "--config-stdin", ...args: string, ]: nothing -> nothing { let struct_json = (ncl-export-bootstrapable $ncl_file) let composed = if ($sops | is-not-empty) { let r = (do { ^sops --decrypt $sops } | complete) if $r.exit_code != 0 { error make { msg: $"SOPS decrypt failed:\n($r.stderr | str trim)" } } json-merge $struct_json $r.stdout } else if ($vault | is-not-empty) { let r = (do { ^vault kv get -format=json $vault | ^jq '.data.data' } | complete) if $r.exit_code != 0 { error make { msg: $"Vault lookup failed:\n($r.stderr | str trim)" } } json-merge $struct_json $r.stdout } else { $struct_json } if $dry_run { print $composed return } if not (which $command | is-not-empty) { error make { msg: $"command not found: ($command)" } } let streams_cfg = (nats-streams-config $ncl_file) $composed | with-env { NATS_STREAMS_CONFIG: $streams_cfg } { ^$command $stdin_flag ...$args } }