|
| 1 | +#!/usr/bin/env bash |
| 2 | +# /usr/bin/mios-env -- print the resolved MIOS_* environment surface. |
| 3 | +# |
| 4 | +# Documented in INDEX.md sec 4 as the canonical CLI for inspecting the |
| 5 | +# layered environment overlay (/usr/share/mios/env.defaults -> |
| 6 | +# /etc/mios/env.d/*.env -> /etc/mios/install.env -> ~/.env.mios -> |
| 7 | +# ~/.config/mios/env). Wraps /etc/profile.d/mios-env.sh + the |
| 8 | +# tools/lib/userenv.sh TOML resolver and reports the consolidated values |
| 9 | +# the running session would actually see. |
| 10 | +# |
| 11 | +# Usage: |
| 12 | +# mios-env # all MIOS_* vars, sorted (KEY=VALUE) |
| 13 | +# mios-env <NAME> # one var, value only (suitable for $(...) capture) |
| 14 | +# mios-env --json # machine-readable JSON |
| 15 | +# mios-env --unset # POSIX 'unset' lines (for re-evaluating in a parent shell) |
| 16 | +# mios-env --explain # show which layer supplied each value |
| 17 | +# mios-env --help |
| 18 | +# |
| 19 | +# Architectural Law 5: MIOS_AI_ENDPOINT / MIOS_AI_MODEL / MIOS_AI_KEY |
| 20 | +# resolved here are the canonical values for every OpenAI-API-shaped |
| 21 | +# client on the system. |
| 22 | +set -euo pipefail |
| 23 | + |
| 24 | +# Canonical layer paths (mirrors mios-env.sh). |
| 25 | +LAYERS=( |
| 26 | + "/usr/share/mios/env.defaults" |
| 27 | +) |
| 28 | +# /etc/mios/env.d/*.env (alphabetical) |
| 29 | +if [[ -d /etc/mios/env.d ]]; then |
| 30 | + while IFS= read -r -d '' f; do |
| 31 | + LAYERS+=("$f") |
| 32 | + done < <(find /etc/mios/env.d -maxdepth 1 -name '*.env' -print0 2>/dev/null | sort -z) |
| 33 | +fi |
| 34 | +LAYERS+=( |
| 35 | + "/etc/mios/install.env" |
| 36 | + "${HOME}/.env.mios" |
| 37 | + "${HOME}/.config/mios/env" |
| 38 | +) |
| 39 | + |
| 40 | +_load_layers() { |
| 41 | + local layer |
| 42 | + for layer in "${LAYERS[@]}"; do |
| 43 | + [[ -r "$layer" ]] || continue |
| 44 | + # shellcheck disable=SC1090 |
| 45 | + . "$layer" |
| 46 | + done |
| 47 | +} |
| 48 | + |
| 49 | +# Also fold in the TOML resolver (tools/lib/userenv.sh) which deep-merges |
| 50 | +# /usr/share/mios/mios.toml -> /etc/mios/mios.toml -> ~/.config/mios/mios.toml. |
| 51 | +# That library exports a richer set of typed MIOS_* slots derived from the |
| 52 | +# unified mios.toml schema. |
| 53 | +_load_toml_layers() { |
| 54 | + local userenv_lib |
| 55 | + for userenv_lib in /usr/lib/mios/userenv.sh /usr/share/mios/tools/lib/userenv.sh; do |
| 56 | + if [[ -r "$userenv_lib" ]]; then |
| 57 | + # shellcheck disable=SC1090 |
| 58 | + . "$userenv_lib" |
| 59 | + return 0 |
| 60 | + fi |
| 61 | + done |
| 62 | +} |
| 63 | + |
| 64 | +_print_kv() { |
| 65 | + # Print all currently-set MIOS_* variables sorted by name. |
| 66 | + while IFS= read -r line; do |
| 67 | + printf '%s\n' "$line" |
| 68 | + done < <(compgen -A variable | grep -E '^MIOS_' | sort | while read -r v; do |
| 69 | + printf '%s=%q\n' "$v" "${!v-}" |
| 70 | + done) |
| 71 | +} |
| 72 | +
|
| 73 | +_print_json() { |
| 74 | + printf '{\n' |
| 75 | + local first=1 |
| 76 | + while IFS= read -r v; do |
| 77 | + local val="${!v-}" |
| 78 | + # JSON-escape the value: backslash, double-quote, control chars. |
| 79 | + val=${val//\\/\\\\} |
| 80 | + val=${val//\"/\\\"} |
| 81 | + val=${val//$'\n'/\\n} |
| 82 | + val=${val//$'\t'/\\t} |
| 83 | + if [[ $first -eq 1 ]]; then first=0; else printf ',\n'; fi |
| 84 | + printf ' "%s": "%s"' "$v" "$val" |
| 85 | + done < <(compgen -A variable | grep -E '^MIOS_' | sort) |
| 86 | + printf '\n}\n' |
| 87 | +} |
| 88 | +
|
| 89 | +_print_explain() { |
| 90 | + # For each MIOS_* variable, identify the highest layer that set it. |
| 91 | + declare -A SOURCE_OF |
| 92 | + local layer |
| 93 | + for layer in "${LAYERS[@]}"; do |
| 94 | + [[ -r "$layer" ]] || continue |
| 95 | + # Parse KEY=... lines from this layer (env-file format). |
| 96 | + while IFS= read -r key; do |
| 97 | + [[ -n "$key" ]] && SOURCE_OF["$key"]="$layer" |
| 98 | + done < <(grep -oE '^[[:space:]]*MIOS_[A-Z0-9_]+(?==)' "$layer" 2>/dev/null \ |
| 99 | + | sed -E 's/^[[:space:]]*//; s/=$//' || true) |
| 100 | + done |
| 101 | +
|
| 102 | + while IFS= read -r v; do |
| 103 | + printf '%-32s = %-30s [%s]\n' \ |
| 104 | + "$v" "${!v-}" "${SOURCE_OF[$v]:-runtime/default}" |
| 105 | + done < <(compgen -A variable | grep -E '^MIOS_' | sort) |
| 106 | +} |
| 107 | +
|
| 108 | +_print_unset() { |
| 109 | + # Emit 'unset' lines for every MIOS_* var. Useful for callers that |
| 110 | + # want to clear and re-source the resolver in their own shell. |
| 111 | + while IFS= read -r v; do |
| 112 | + printf 'unset %s\n' "$v" |
| 113 | + done < <(compgen -A variable | grep -E '^MIOS_' | sort) |
| 114 | +} |
| 115 | +
|
| 116 | +_help() { |
| 117 | + sed -n '2,/^set -euo/p' "$0" | sed -n '/^# /p' | sed 's/^# //' |
| 118 | +} |
| 119 | +
|
| 120 | +case "${1:-}" in |
| 121 | + -h|--help) |
| 122 | + _help |
| 123 | + exit 0 |
| 124 | + ;; |
| 125 | + --json) |
| 126 | + _load_layers |
| 127 | + _load_toml_layers 2>/dev/null || true |
| 128 | + _print_json |
| 129 | + ;; |
| 130 | + --explain) |
| 131 | + _load_layers |
| 132 | + _load_toml_layers 2>/dev/null || true |
| 133 | + _print_explain |
| 134 | + ;; |
| 135 | + --unset) |
| 136 | + _load_layers |
| 137 | + _load_toml_layers 2>/dev/null || true |
| 138 | + _print_unset |
| 139 | + ;; |
| 140 | + "") |
| 141 | + _load_layers |
| 142 | + _load_toml_layers 2>/dev/null || true |
| 143 | + _print_kv |
| 144 | + ;; |
| 145 | + MIOS_*) |
| 146 | + _load_layers |
| 147 | + _load_toml_layers 2>/dev/null || true |
| 148 | + var="$1" |
| 149 | + # Only echo the value (no name=); suitable for $(mios-env MIOS_AI_ENDPOINT). |
| 150 | + printf '%s\n' "${!var-}" |
| 151 | + ;; |
| 152 | + *) |
| 153 | + printf 'mios-env: unknown argument %q (try --help)\n' "$1" >&2 |
| 154 | + exit 2 |
| 155 | + ;; |
| 156 | +esac |
0 commit comments