prvng_core/nulib/lib_provisioning/utils/init.nu

140 lines
4.8 KiB
Text
Raw Normal View History

# Module: System Initialization
# Purpose: Handles system initialization, environment setup, and workspace initialization.
# Dependencies: error, interface, config/accessor
2025-10-07 10:32:04 +01:00
refactor(23 files): selective imports + dangling/broken cleanup (ADR-025 L2/L3) Large combined batch of 23 files refactored from star-imports to selective. Grouped because two sub-batches accumulated in staging without intermediate commit. === Orchestrator facades (Layer 3) === ai/mod.nu [12 symbols from ai/lib.nu] config/loader.nu [14 symbols from loader/mod.nu] config/accessor/mod.nu [15 symbols from accessor/functions.nu] sops/mod.nu [11 symbols from sops/lib.nu] user/mod.nu [16 symbols from user/config.nu] === Selective imports === defs/lists.nu utils/on_select (kept, selective) services/manager.nu (all dead dropped) webhook/ai_webhook.nu ai/lib [4] + settings/lib kms/lib.nu utils/error + utils/interface + plugins/kms gitea/locking.nu api_client [8] gitea/workspace_git.nu api_client [3] gitea/extension_publish.nu api_client [8] + config/loader infra_validator/rules_engine.nu config_loader [3] plugins/kms.nu config/accessor/core [config-get] coredns/api_client.nu config/loader [get-config] === Dangling imports removed (target file does not exist) === coredns/docker.nu ../utils/log.nu → deleted (uses corefile.nu [2]) coredns/zones.nu ../utils/log.nu → deleted (uses corefile.nu [1]) coredns/service.nu ../utils/log.nu → deleted (uses corefile.nu [2]) coredns/corefile.nu ../utils/log.nu → deleted === Broken paths cleaned up === project/detect.nu Former `use ../../../lib_provisioning *` resolved to non-existent path (core/lib_provisioning). Silent no-op at runtime. Removed. Error count went 19 -> 17. === Dead imports dropped === utils/ssh.nu config/accessor DROPPED (dead) utils/init.nu config/accessor DROPPED (dead) infra_validator/agent_interface.nu report_generator DROPPED (dead) === Dynamic imports preserved === providers/loader.nu line 179 `use ($provider_entry.entry_point) *` is intentional runtime dispatch — not convertible to selective. Validation: all files match pre-existing baseline. Gitea subsystem has known pre-existing 50-error noise (transitive); independent of this work. Refs: ADR-025
2026-04-17 12:13:13 +01:00
# config/accessor star-import was dead — dropped (ADR-025 Phase 3 Layer 2).
2025-10-07 10:32:04 +01:00
feat(core): three-layer DAG, unified component arch, commands-registry cache, Nushell 0.112.2 migration - DAG architecture: `dag show/validate/export` (nulib/main_provisioning/dag.nu), config loader (lib_provisioning/config/loader/dag.nu), taskserv dag-executor. Backed by schemas/lib/dag/*.ncl; orchestrator emits NATS events via WorkspaceComposition::into_workflow. See ADR-020, ADR-021. - Unified Component Architecture: components/mod.nu, main_provisioning/ {components,workflow,extensions,ontoref-queries}.nu. Full workflow engine with topological sort and NATS subject emission. Blocks A-H complete (libre-daoshi). - Commands-registry: nulib/commands-registry.ncl (Nickel source, 314 lines) + JSON cache at ~/.cache/provisioning/commands-registry.json rebuilt on source change. cli/provisioning fast-path alias expansion avoids cold Nu startup. ADDING_COMMANDS.md documents new-command workflow. - Platform service manager: service-manager.nu (+573), startup.nu (+611), service-check.nu (+255); autostart/bootstrap/health/target refactored. - Nushell 0.112.2 migration: removed all try/catch and bash redirections; external commands prefixed with ^; type signatures enforced. Driven by scripts/refactor-try-catch{,-simplified}.nu. - TTY stack: removed shlib/*-tty.sh; replaced by cli/tty-dispatch.sh, tty-filter.sh, tty-commands.conf. - New domain modules: images/ (golden image lifecycle), workspace/{state,sync}.nu, main_provisioning/{bootstrap,cluster-deploy,fip,state}.nu, commands/{state, build,integrations/auth,utilities/alias}.nu, platform.nu expanded (+874). - Config loader overhaul: loader/core.nu slimmed (-759), cache/core.nu refactored (-454), removed legacy loaders/file_loader.nu (-330). - Thirteen new provisioning-<domain>.nu top-level modules for bash dispatcher. - Tests: test_workspace_state.nu (+351); updates to test_oci_registry, test_services. - README + CHANGELOG updated.
2026-04-17 04:27:33 +01:00
# Get the complete provisioning command arguments as a string
export def get-provisioning-args [] : nothing -> string {
$env.PROVISIONING_ARGS? | default ""
}
# Get the provisioning command name
export def get-provisioning-name [] : nothing -> string {
$env.PROVISIONING_NAME? | default "provisioning"
}
# Get the provisioning infrastructure path
export def get-provisioning-infra-path [] : nothing -> string {
$env.PROVISIONING_INFRA_PATH? | default ""
}
# Get the provisioning resources path
export def get-provisioning-resources [] : nothing -> string {
$env.PROVISIONING_RESOURCES? | default ""
}
# Get the provisioning URL
export def get-provisioning-url [] : nothing -> string {
$env.PROVISIONING_URL? | default "https://provisioning.systems"
}
# Get whether SOPS encryption is enabled
export def get-provisioning-use-sops [] : nothing -> string {
$env.PROVISIONING_USE_SOPS? | default ""
}
# Get the effective workspace
export def get-effective-workspace [] : nothing -> string {
$env.CURRENT_WORKSPACE? | default "default"
}
# Get workspace path (defaults to effective workspace if not provided)
export def get-workspace-path [workspace?: string] : nothing -> string {
let ws = if ($workspace | is-empty) {
(get-effective-workspace)
} else {
$workspace
}
let ws_base = ($env.PROVISIONING_WORKSPACES? | default "")
if ($ws_base | is-not-empty) {
$ws_base | path join $ws
} else {
""
}
}
# Detect infrastructure from PWD
export def detect-infra-from-pwd [] : nothing -> string {
""
}
# Get work format (Nickel is the default post-migration)
export def get-work-format [] : nothing -> string {
$env.PROVISIONING_WORK_FORMAT? | default "ncl"
}
export def show_titles [] {
feat(core): three-layer DAG, unified component arch, commands-registry cache, Nushell 0.112.2 migration - DAG architecture: `dag show/validate/export` (nulib/main_provisioning/dag.nu), config loader (lib_provisioning/config/loader/dag.nu), taskserv dag-executor. Backed by schemas/lib/dag/*.ncl; orchestrator emits NATS events via WorkspaceComposition::into_workflow. See ADR-020, ADR-021. - Unified Component Architecture: components/mod.nu, main_provisioning/ {components,workflow,extensions,ontoref-queries}.nu. Full workflow engine with topological sort and NATS subject emission. Blocks A-H complete (libre-daoshi). - Commands-registry: nulib/commands-registry.ncl (Nickel source, 314 lines) + JSON cache at ~/.cache/provisioning/commands-registry.json rebuilt on source change. cli/provisioning fast-path alias expansion avoids cold Nu startup. ADDING_COMMANDS.md documents new-command workflow. - Platform service manager: service-manager.nu (+573), startup.nu (+611), service-check.nu (+255); autostart/bootstrap/health/target refactored. - Nushell 0.112.2 migration: removed all try/catch and bash redirections; external commands prefixed with ^; type signatures enforced. Driven by scripts/refactor-try-catch{,-simplified}.nu. - TTY stack: removed shlib/*-tty.sh; replaced by cli/tty-dispatch.sh, tty-filter.sh, tty-commands.conf. - New domain modules: images/ (golden image lifecycle), workspace/{state,sync}.nu, main_provisioning/{bootstrap,cluster-deploy,fip,state}.nu, commands/{state, build,integrations/auth,utilities/alias}.nu, platform.nu expanded (+874). - Config loader overhaul: loader/core.nu slimmed (-759), cache/core.nu refactored (-454), removed legacy loaders/file_loader.nu (-330). - Thirteen new provisioning-<domain>.nu top-level modules for bash dispatcher. - Tests: test_workspace_state.nu (+351); updates to test_oci_registry, test_services. - README + CHANGELOG updated.
2026-04-17 04:27:33 +01:00
# Check if titles are disabled
2025-10-07 10:32:04 +01:00
if ($env.PROVISIONING_NO_TITLES? | default false) { return }
feat(core): three-layer DAG, unified component arch, commands-registry cache, Nushell 0.112.2 migration - DAG architecture: `dag show/validate/export` (nulib/main_provisioning/dag.nu), config loader (lib_provisioning/config/loader/dag.nu), taskserv dag-executor. Backed by schemas/lib/dag/*.ncl; orchestrator emits NATS events via WorkspaceComposition::into_workflow. See ADR-020, ADR-021. - Unified Component Architecture: components/mod.nu, main_provisioning/ {components,workflow,extensions,ontoref-queries}.nu. Full workflow engine with topological sort and NATS subject emission. Blocks A-H complete (libre-daoshi). - Commands-registry: nulib/commands-registry.ncl (Nickel source, 314 lines) + JSON cache at ~/.cache/provisioning/commands-registry.json rebuilt on source change. cli/provisioning fast-path alias expansion avoids cold Nu startup. ADDING_COMMANDS.md documents new-command workflow. - Platform service manager: service-manager.nu (+573), startup.nu (+611), service-check.nu (+255); autostart/bootstrap/health/target refactored. - Nushell 0.112.2 migration: removed all try/catch and bash redirections; external commands prefixed with ^; type signatures enforced. Driven by scripts/refactor-try-catch{,-simplified}.nu. - TTY stack: removed shlib/*-tty.sh; replaced by cli/tty-dispatch.sh, tty-filter.sh, tty-commands.conf. - New domain modules: images/ (golden image lifecycle), workspace/{state,sync}.nu, main_provisioning/{bootstrap,cluster-deploy,fip,state}.nu, commands/{state, build,integrations/auth,utilities/alias}.nu, platform.nu expanded (+874). - Config loader overhaul: loader/core.nu slimmed (-759), cache/core.nu refactored (-454), removed legacy loaders/file_loader.nu (-330). - Thirteen new provisioning-<domain>.nu top-level modules for bash dispatcher. - Tests: test_workspace_state.nu (+351); updates to test_oci_registry, test_services. - README + CHANGELOG updated.
2026-04-17 04:27:33 +01:00
if ($env.PROVISIONING_OUT? | is-not-empty) { return }
2025-10-07 10:32:04 +01:00
if ($env.PROVISIONING_TITLES_SHOWN? | default false) { return }
feat(core): three-layer DAG, unified component arch, commands-registry cache, Nushell 0.112.2 migration - DAG architecture: `dag show/validate/export` (nulib/main_provisioning/dag.nu), config loader (lib_provisioning/config/loader/dag.nu), taskserv dag-executor. Backed by schemas/lib/dag/*.ncl; orchestrator emits NATS events via WorkspaceComposition::into_workflow. See ADR-020, ADR-021. - Unified Component Architecture: components/mod.nu, main_provisioning/ {components,workflow,extensions,ontoref-queries}.nu. Full workflow engine with topological sort and NATS subject emission. Blocks A-H complete (libre-daoshi). - Commands-registry: nulib/commands-registry.ncl (Nickel source, 314 lines) + JSON cache at ~/.cache/provisioning/commands-registry.json rebuilt on source change. cli/provisioning fast-path alias expansion avoids cold Nu startup. ADDING_COMMANDS.md documents new-command workflow. - Platform service manager: service-manager.nu (+573), startup.nu (+611), service-check.nu (+255); autostart/bootstrap/health/target refactored. - Nushell 0.112.2 migration: removed all try/catch and bash redirections; external commands prefixed with ^; type signatures enforced. Driven by scripts/refactor-try-catch{,-simplified}.nu. - TTY stack: removed shlib/*-tty.sh; replaced by cli/tty-dispatch.sh, tty-filter.sh, tty-commands.conf. - New domain modules: images/ (golden image lifecycle), workspace/{state,sync}.nu, main_provisioning/{bootstrap,cluster-deploy,fip,state}.nu, commands/{state, build,integrations/auth,utilities/alias}.nu, platform.nu expanded (+874). - Config loader overhaul: loader/core.nu slimmed (-759), cache/core.nu refactored (-454), removed legacy loaders/file_loader.nu (-330). - Thirteen new provisioning-<domain>.nu top-level modules for bash dispatcher. - Tests: test_workspace_state.nu (+351); updates to test_oci_registry, test_services. - README + CHANGELOG updated.
2026-04-17 04:27:33 +01:00
# Mark as shown to prevent duplicates
2025-10-07 10:32:04 +01:00
$env.PROVISIONING_TITLES_SHOWN = true
feat(core): three-layer DAG, unified component arch, commands-registry cache, Nushell 0.112.2 migration - DAG architecture: `dag show/validate/export` (nulib/main_provisioning/dag.nu), config loader (lib_provisioning/config/loader/dag.nu), taskserv dag-executor. Backed by schemas/lib/dag/*.ncl; orchestrator emits NATS events via WorkspaceComposition::into_workflow. See ADR-020, ADR-021. - Unified Component Architecture: components/mod.nu, main_provisioning/ {components,workflow,extensions,ontoref-queries}.nu. Full workflow engine with topological sort and NATS subject emission. Blocks A-H complete (libre-daoshi). - Commands-registry: nulib/commands-registry.ncl (Nickel source, 314 lines) + JSON cache at ~/.cache/provisioning/commands-registry.json rebuilt on source change. cli/provisioning fast-path alias expansion avoids cold Nu startup. ADDING_COMMANDS.md documents new-command workflow. - Platform service manager: service-manager.nu (+573), startup.nu (+611), service-check.nu (+255); autostart/bootstrap/health/target refactored. - Nushell 0.112.2 migration: removed all try/catch and bash redirections; external commands prefixed with ^; type signatures enforced. Driven by scripts/refactor-try-catch{,-simplified}.nu. - TTY stack: removed shlib/*-tty.sh; replaced by cli/tty-dispatch.sh, tty-filter.sh, tty-commands.conf. - New domain modules: images/ (golden image lifecycle), workspace/{state,sync}.nu, main_provisioning/{bootstrap,cluster-deploy,fip,state}.nu, commands/{state, build,integrations/auth,utilities/alias}.nu, platform.nu expanded (+874). - Config loader overhaul: loader/core.nu slimmed (-759), cache/core.nu refactored (-454), removed legacy loaders/file_loader.nu (-330). - Thirteen new provisioning-<domain>.nu top-level modules for bash dispatcher. - Tests: test_workspace_state.nu (+351); updates to test_oci_registry, test_services. - README + CHANGELOG updated.
2026-04-17 04:27:33 +01:00
# Find ascii.txt from PROVISIONING_RESOURCES or PROVISIONING directory
let ascii_file = (
if ($env.PROVISIONING_RESOURCES? | is-not-empty) {
($env.PROVISIONING_RESOURCES | path join "ascii.txt")
} else if ($env.PROVISIONING? | is-not-empty) {
($env.PROVISIONING | path join "resources" | path join "ascii.txt")
} else {
""
}
)
# Display if file exists
if ($ascii_file | is-not-empty) and ($ascii_file | path exists) {
print $"(ansi blue_bold)(open -r $ascii_file)(ansi reset)"
}
2025-10-07 10:32:04 +01:00
}
export def use_titles [ ] {
2025-10-07 10:32:04 +01:00
if ($env.PROVISIONING_NO_TITLES? | default false) { return false }
if ($env.PROVISIONING_NO_TERMINAL? | default false) { return false }
let args = ($env.PROVISIONING_ARGS? | default "")
if ($args | is-not-empty) and ($args | str contains "-h" ) { return false }
if ($args | is-not-empty) and ($args | str contains "--notitles" ) { return false }
if ($args | is-not-empty) and ($args | str contains "query") and ($args | str contains "-o" ) { return false }
2025-10-07 10:32:04 +01:00
true
}
export def provisioning_init [
helpinfo: bool
module: string
args: list<string> # Other options, use help to get info
] {
2025-10-07 10:32:04 +01:00
if (use_titles) { show_titles }
if $helpinfo != null and $helpinfo {
let cmd_line: list<string> = if ($args| length) == 0 {
$args | str join " "
} else {
($env.PROVISIONING_ARGS? | default "")
}
let cmd_args: list<string> = ($cmd_line | str replace "--helpinfo" "" |
str replace "-h" "" | str replace $module "" | str trim | split row " "
)
if ($cmd_args | length) > 0 {
# Refactored from try-catch to do/complete for explicit error handling
let str_mod_0_result = (do { $cmd_args | get 0 } | complete)
let str_mod_0 = if $str_mod_0_result.exit_code == 0 { ($str_mod_0_result.stdout | str trim) } else { "" }
let str_mod_1_result = (do { $cmd_args | get 1 } | complete)
let str_mod_1 = if $str_mod_1_result.exit_code == 0 { ($str_mod_1_result.stdout | str trim) } else { "" }
if $str_mod_1 != "" {
let final_args = ($cmd_args | drop nth 0 1)
^$"((get-provisioning-name))" "-mod" $"'($str_mod_0) ($str_mod_1)'" ...$final_args help
} else if $str_mod_0 != "" {
let final_args = ($cmd_args | drop nth 0)
^$"((get-provisioning-name))" "-mod" ($str_mod_0) ...$final_args help
} else {
^$"((get-provisioning-name))" "-mod" $"($module | str replace ' ' '|')" ...$cmd_args help
}
2025-10-07 10:32:04 +01:00
} else {
^$"((get-provisioning-name))" help
}
exit 0
}
}