449 lines
26 KiB
Text
449 lines
26 KiB
Text
# Hierarchical Help System with Categories (REFACTORED)
|
||
# Provides organized, drill-down help for provisioning commands
|
||
# Data-driven help content loaded from help_content.ncl
|
||
|
||
use platform/config/accessor.nu *
|
||
use ../help_renderer.nu *
|
||
|
||
# Load help content from Nickel file
|
||
def load-help-content [] {
|
||
let content_path = (help_content_path)
|
||
|
||
# Guard: Validate file exists
|
||
if not ($content_path | path exists) {
|
||
error make { msg: $"Help content file not found: ($content_path)" }
|
||
}
|
||
|
||
# Load the Nickel content - would normally be compiled/loaded
|
||
# For now, return parsed structure
|
||
load_help_data
|
||
}
|
||
|
||
# Get path to help content file
|
||
def help_content_path [] {
|
||
let script_dir = (get_script_dir)
|
||
$"($script_dir)/help_content.ncl"
|
||
}
|
||
|
||
def load_help_data [] {
|
||
{
|
||
categories: {
|
||
infrastructure: {
|
||
title: "🏗️ INFRASTRUCTURE MANAGEMENT"
|
||
color: "cyan"
|
||
sections: []
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
# Resolve documentation URL with local fallback
|
||
export def resolve-doc-url [doc_path: string] {
|
||
let config = (load-config)
|
||
let mdbook_enabled = ($config.documentation?.mdbook_enabled? | default false)
|
||
let mdbook_base = ($config.documentation?.mdbook_base_url? | default "")
|
||
let docs_root = ($config.documentation?.docs_root? | default "docs/src")
|
||
|
||
if $mdbook_enabled and ($mdbook_base | str length) > 0 {
|
||
# Return both URL and local path
|
||
{
|
||
url: $"($mdbook_base)/($doc_path).html"
|
||
local: $"provisioning/($docs_root)/($doc_path).md"
|
||
mode: "url"
|
||
}
|
||
} else {
|
||
# Use local files only
|
||
{
|
||
url: null
|
||
local: $"provisioning/($docs_root)/($doc_path).md"
|
||
mode: "local"
|
||
}
|
||
}
|
||
}
|
||
|
||
# Main help dispatcher
|
||
export def provisioning-help [
|
||
category?: string # Optional category: infrastructure, orchestration, development, workspace, platform, auth, plugins, utilities, concepts, guides, integrations
|
||
] {
|
||
# If no category provided, show main help
|
||
if ($category == null) or ($category == "") {
|
||
return (help-main)
|
||
}
|
||
|
||
# Try to match the category
|
||
let result = (match $category {
|
||
"infrastructure" | "infra" => "infrastructure"
|
||
"orchestration" | "orch" => "orchestration"
|
||
"development" | "dev" => "development"
|
||
"workspace" | "ws" => "workspace"
|
||
"platform" | "plat" => "platform"
|
||
"setup" | "st" => "setup"
|
||
"authentication" | "auth" => "authentication"
|
||
"mfa" => "mfa"
|
||
"plugins" | "plugin" => "plugins"
|
||
"utilities" | "utils" | "cache" => "utilities"
|
||
"tools" => "tools"
|
||
"vm" => "vm"
|
||
"diagnostics" | "diag" | "status" | "health" => "diagnostics"
|
||
"concepts" | "concept" => "concepts"
|
||
"guides" | "guide" | "howto" => "guides"
|
||
"integrations" | "integration" | "int" => "integrations"
|
||
_ => "unknown"
|
||
})
|
||
|
||
# If unknown category, show error
|
||
if $result == "unknown" {
|
||
print $"❌ Unknown help category: \"($category)\"\n"
|
||
print "Available help categories:"
|
||
print " infrastructure [infra] - Server, taskserv, cluster, VM management"
|
||
print " orchestration [orch] - Workflow, batch operations"
|
||
print " development [dev] - Module system, layers, versioning"
|
||
print " workspace [ws] - Workspace and template management"
|
||
print " setup [st] - System setup, configuration, initialization"
|
||
print " platform [plat] - Orchestrator, Control Center, MCP"
|
||
print " authentication [auth] - JWT authentication, MFA, sessions"
|
||
print " mfa - Multi-Factor Authentication details"
|
||
print " plugins [plugin] - Plugin management"
|
||
print " utilities [utils] - Cache, SOPS, providers, SSH"
|
||
print " tools - Tool and dependency management"
|
||
print " vm - Virtual machine operations"
|
||
print " diagnostics [diag] - System status, health checks"
|
||
print " concepts [concept] - Architecture and key concepts"
|
||
print " guides [guide] - Quick guides and cheatsheets"
|
||
print " integrations [int] - Prov-ecosystem and provctl bridge\n"
|
||
print "Use 'provisioning help' for main help"
|
||
exit 1
|
||
}
|
||
|
||
# Match valid category using renderer with data-driven approach
|
||
match $result {
|
||
"infrastructure" => (help-infrastructure)
|
||
"orchestration" => (help-orchestration)
|
||
"development" => (help-development)
|
||
"workspace" => (help-workspace)
|
||
"platform" => (help-platform)
|
||
"setup" => (help-setup)
|
||
"authentication" => (help-authentication)
|
||
"mfa" => (help-mfa)
|
||
"plugins" => (help-plugins)
|
||
"utilities" => (help-utilities)
|
||
"tools" => (help-tools)
|
||
"vm" => (help-vm)
|
||
"diagnostics" => (help-diagnostics)
|
||
"concepts" => (help-concepts)
|
||
"guides" => (help-guides)
|
||
"integrations" => (help-integrations)
|
||
_ => (help-main)
|
||
}
|
||
}
|
||
|
||
# Main help overview with categories
|
||
def help-main [] {
|
||
let show_header = not ($env.PROVISIONING_NO_TITLES? | default false)
|
||
let header = (if $show_header {
|
||
($"(_ansi yellow_bold)╔════════════════════════════════════════════════════════════════╗(_ansi reset)\n" +
|
||
$"(_ansi yellow_bold)║ (_ansi reset) (_ansi cyan_bold)PROVISIONING SYSTEM(_ansi reset) - Layered Infrastructure Automation (_ansi yellow_bold) ║(_ansi reset)\n" +
|
||
$"(_ansi yellow_bold)╚════════════════════════════════════════════════════════════════╝(_ansi reset)\n\n")
|
||
} else {
|
||
""
|
||
})
|
||
|
||
($header
|
||
+ $"(_ansi green_bold)📚 COMMAND CATEGORIES(_ansi reset) (_ansi default_dimmed)- Use 'provisioning help <category>' for details(_ansi reset)\n\n"
|
||
+ $" (_ansi cyan)🏗️ infrastructure(_ansi reset) (_ansi default_dimmed)[infra](_ansi reset)\t Server, taskserv, cluster, VM, and infra management\n"
|
||
+ $" (_ansi purple)⚡ orchestration(_ansi reset) (_ansi default_dimmed)[orch](_ansi reset)\t Workflow, batch operations, and orchestrator control\n"
|
||
+ $" (_ansi blue)🧩 development(_ansi reset) (_ansi default_dimmed)[dev](_ansi reset)\t\t Module discovery, layers, versions, and packaging\n"
|
||
+ $" (_ansi green)📁 workspace(_ansi reset) (_ansi default_dimmed)[ws](_ansi reset)\t\t Workspace and template management\n"
|
||
+ $" (_ansi red)🖥️ platform(_ansi reset) (_ansi default_dimmed)[plat](_ansi reset)\t\t Orchestrator, Control Center UI, MCP Server\n"
|
||
+ $" (_ansi magenta)⚙️ setup(_ansi reset) (_ansi default_dimmed)[st](_ansi reset)\t\t System setup, configuration, and initialization\n"
|
||
+ $" (_ansi yellow)🔐 authentication(_ansi reset) (_ansi default_dimmed)[auth](_ansi reset)\t JWT authentication, MFA, and sessions\n"
|
||
+ $" (_ansi cyan)🔌 plugins(_ansi reset) (_ansi default_dimmed)[plugin](_ansi reset)\t\t Plugin management and integration\n"
|
||
+ $" (_ansi green)🛠️ utilities(_ansi reset) (_ansi default_dimmed)[utils](_ansi reset)\t\t Cache, SOPS editing, providers, plugins, SSH\n"
|
||
+ $" (_ansi yellow)🌉 integrations(_ansi reset) (_ansi default_dimmed)[int](_ansi reset)\t\t Prov-ecosystem and provctl bridge\n"
|
||
+ $" (_ansi green)🔍 diagnostics(_ansi reset) (_ansi default_dimmed)[diag](_ansi reset)\t\t System status, health checks, and next steps\n"
|
||
+ $" (_ansi magenta)📚 guides(_ansi reset) (_ansi default_dimmed)[guide](_ansi reset)\t\t Quick guides and cheatsheets\n"
|
||
+ $" (_ansi yellow)💡 concepts(_ansi reset) (_ansi default_dimmed)[concept](_ansi reset)\t\t Understanding layers, modules, and architecture\n\n"
|
||
+ $"(_ansi green_bold)🚀 QUICK START(_ansi reset)\n\n"
|
||
+ $" 1. (_ansi cyan)Understand the system(_ansi reset): provisioning help concepts\n"
|
||
+ $" 2. (_ansi cyan)Create workspace(_ansi reset): provisioning workspace init my-infra --activate\n"
|
||
+ $" (_ansi default_dimmed)Or use interactive:(_ansi reset) provisioning workspace init --interactive\n"
|
||
+ $" 3. (_ansi cyan)Discover modules(_ansi reset): provisioning module discover taskservs\n"
|
||
+ $" 4. (_ansi cyan)Create servers(_ansi reset): provisioning server create --infra my-infra\n"
|
||
+ $" 5. (_ansi cyan)Deploy services(_ansi reset): provisioning taskserv create kubernetes\n\n"
|
||
+ $"(_ansi green_bold)🔧 COMMON COMMANDS(_ansi reset)\n\n"
|
||
+ $" provisioning server list - List all servers\n"
|
||
+ $" provisioning workflow list - List workflows\n"
|
||
+ $" provisioning module discover taskservs - Discover available taskservs\n"
|
||
+ $" provisioning layer show <workspace> - Show layer resolution\n"
|
||
+ $" provisioning version check - Check component versions\n\n"
|
||
+ $"(_ansi green_bold)ℹ️ HELP TOPICS(_ansi reset)\n\n"
|
||
+ $" provisioning help infrastructure (_ansi default_dimmed)[or: infra](_ansi reset) - Server/cluster lifecycle\n"
|
||
+ $" provisioning help orchestration (_ansi default_dimmed)[or: orch](_ansi reset) - Workflows and batch operations\n"
|
||
+ $" provisioning help development (_ansi default_dimmed)[or: dev](_ansi reset) - Module system and tools\n"
|
||
+ $" provisioning help workspace (_ansi default_dimmed)[or: ws](_ansi reset) - Workspace and templates\n"
|
||
+ $" provisioning help setup (_ansi default_dimmed)[or: st](_ansi reset) - System setup and configuration\n"
|
||
+ $" provisioning help platform (_ansi default_dimmed)[or: plat](_ansi reset) - Platform services with web UI\n"
|
||
+ $" provisioning help authentication (_ansi default_dimmed)[or: auth](_ansi reset) - JWT authentication and MFA\n"
|
||
+ $" provisioning help plugins (_ansi default_dimmed)[or: plugin](_ansi reset) - Plugin management\n"
|
||
+ $" provisioning help utilities (_ansi default_dimmed)[or: utils](_ansi reset) - Cache, SOPS, providers, and utilities\n"
|
||
+ $" provisioning help integrations (_ansi default_dimmed)[or: int](_ansi reset) - Prov-ecosystem and provctl bridge\n"
|
||
+ $" provisioning help diagnostics (_ansi default_dimmed)[or: diag](_ansi reset) - System status and health\n"
|
||
+ $" provisioning help guides (_ansi default_dimmed)[or: guide](_ansi reset) - Quick guides and cheatsheets\n"
|
||
+ $" provisioning help concepts (_ansi default_dimmed)[or: concept](_ansi reset) - Architecture and key concepts\n\n"
|
||
+ $"(_ansi default_dimmed)💡 Tip: Most commands support --help for detailed options\n"
|
||
+ $" Example: provisioning server --help(_ansi reset)\n")
|
||
}
|
||
|
||
# Data-driven help functions - each loads content from help_content.ncl and renders
|
||
|
||
def help-infrastructure [] {
|
||
(render-help-category
|
||
"🏗️ INFRASTRUCTURE MANAGEMENT"
|
||
"cyan"
|
||
[
|
||
{
|
||
name: "Lifecycle"
|
||
subtitle: "Server Management"
|
||
items: [
|
||
{ cmd: "server create", desc: "Create new servers [--infra <name>] [--check]" }
|
||
{ cmd: "server delete", desc: "Delete servers [--yes] [--keepstorage]" }
|
||
{ cmd: "server list", desc: "List all servers [--out json|yaml]" }
|
||
{ cmd: "server ssh <host>", desc: "SSH into server" }
|
||
{ cmd: "server price", desc: "Show server pricing" }
|
||
]
|
||
}
|
||
{
|
||
name: "Services"
|
||
subtitle: "Task Service Management"
|
||
items: [
|
||
{ cmd: "taskserv create <svc>", desc: "Install service [kubernetes, redis, postgres]" }
|
||
{ cmd: "taskserv delete <svc>", desc: "Remove service" }
|
||
{ cmd: "taskserv list", desc: "List available services" }
|
||
{ cmd: "taskserv generate <svc>", desc: "Generate service configuration" }
|
||
{ cmd: "taskserv validate <svc>", desc: "Validate service before deployment" }
|
||
{ cmd: "taskserv test <svc>", desc: "Test service in sandbox" }
|
||
{ cmd: "taskserv check-deps <svc>", desc: "Check service dependencies" }
|
||
{ cmd: "taskserv check-updates", desc: "Check for service updates" }
|
||
]
|
||
}
|
||
{
|
||
name: "Complete"
|
||
subtitle: "Cluster Operations"
|
||
items: [
|
||
{ cmd: "cluster create", desc: "Create complete cluster" }
|
||
{ cmd: "cluster delete", desc: "Delete cluster" }
|
||
{ cmd: "cluster list", desc: "List cluster components" }
|
||
]
|
||
}
|
||
{
|
||
name: "Virtual Machines"
|
||
subtitle: "VM Management"
|
||
items: [
|
||
{ cmd: "vm create [config]", desc: "Create new VM" }
|
||
{ cmd: "vm list [--running]", desc: "List VMs" }
|
||
{ cmd: "vm start <name>", desc: "Start VM" }
|
||
{ cmd: "vm stop <name>", desc: "Stop VM" }
|
||
{ cmd: "vm delete <name>", desc: "Delete VM" }
|
||
{ cmd: "vm info <name>", desc: "VM information" }
|
||
{ cmd: "vm ssh <name>", desc: "SSH into VM" }
|
||
{ cmd: "vm hosts check", desc: "Check hypervisor capability" }
|
||
{ cmd: "vm lifecycle list-temporary", desc: "List temporary VMs" }
|
||
]
|
||
}
|
||
{
|
||
name: "Management"
|
||
subtitle: "Infrastructure"
|
||
items: [
|
||
{ cmd: "infra list", desc: "List infrastructures" }
|
||
{ cmd: "infra validate", desc: "Validate infrastructure config" }
|
||
{ cmd: "generate infra --new <name>", desc: "Create new infrastructure" }
|
||
]
|
||
}
|
||
]
|
||
[]
|
||
""
|
||
"Use --check flag for dry-run mode\n Example: provisioning server create --check"
|
||
)
|
||
}
|
||
|
||
# Placeholder functions for remaining categories (can be expanded similarly)
|
||
def help-orchestration [] {
|
||
(render-help-category
|
||
"⚡ ORCHESTRATION"
|
||
"purple"
|
||
[
|
||
{
|
||
name: "Orchestrator"
|
||
subtitle: "Daemon Lifecycle"
|
||
items: [
|
||
{ cmd: "orchestrator start", desc: "Start orchestrator [--background]" }
|
||
{ cmd: "orchestrator stop", desc: "Stop orchestrator" }
|
||
{ cmd: "orchestrator status", desc: "Check if running" }
|
||
{ cmd: "orchestrator health", desc: "Health check" }
|
||
{ cmd: "orchestrator logs", desc: "View logs [--follow]" }
|
||
]
|
||
}
|
||
{
|
||
name: "Jobs"
|
||
subtitle: "Orchestrator Jobs (alias: j)"
|
||
items: [
|
||
{ cmd: "job list", desc: "List orchestrator jobs" }
|
||
{ cmd: "job status <id>", desc: "Get job status" }
|
||
{ cmd: "job monitor <id>", desc: "Monitor in real-time" }
|
||
{ cmd: "job stats", desc: "Show statistics" }
|
||
{ cmd: "job cleanup", desc: "Clean old jobs" }
|
||
{ cmd: "job submit <type> <op> <target>", desc: "Submit a job" }
|
||
]
|
||
}
|
||
{
|
||
name: "Workflows"
|
||
subtitle: "Workspace WorkflowDef (alias: wflow)"
|
||
items: [
|
||
{ cmd: "workflow list", desc: "List workspace WorkflowDef declarations" }
|
||
{ cmd: "workflow show <id>", desc: "Show definition + FSM state" }
|
||
{ cmd: "workflow run <id>", desc: "Execute a WorkflowDef [--dry-run]" }
|
||
{ cmd: "workflow validate", desc: "Cross-validate steps vs components" }
|
||
{ cmd: "workflow status <id>", desc: "FSM dimension state" }
|
||
]
|
||
}
|
||
{
|
||
name: "Batch"
|
||
subtitle: "Multi-Provider Batch Operations"
|
||
items: [
|
||
{ cmd: "batch submit <file>", desc: "Submit Nickel batch [--wait]" }
|
||
{ cmd: "batch list", desc: "List batches [--status Running]" }
|
||
{ cmd: "batch status <id>", desc: "Get batch status" }
|
||
{ cmd: "batch rollback <id>", desc: "Rollback failed batch" }
|
||
{ cmd: "batch stats", desc: "Show statistics" }
|
||
]
|
||
}
|
||
]
|
||
[]
|
||
""
|
||
"job = orchestrator HTTP jobs | workflow = workspace WorkflowDef\n Example: prvng workflow run deploy-services-libre-daoshi --workspace libre-daoshi"
|
||
)
|
||
}
|
||
|
||
# Stub implementations for remaining categories - using original inline content for now
|
||
# These would be replaced with data-driven versions using help_content.ncl in phase 2
|
||
|
||
def help-development [] {
|
||
(
|
||
$"(_ansi blue_bold)╔══════════════════════════════════════════════════╗(_ansi reset)\n" +
|
||
$"(_ansi blue_bold)║(_ansi reset) 🧩 DEVELOPMENT TOOLS (_ansi blue_bold)║(_ansi reset)\n" +
|
||
$"(_ansi blue_bold)╚══════════════════════════════════════════════════╝(_ansi reset)\n\n" +
|
||
|
||
$"(_ansi green_bold)[Discovery](_ansi reset) Module System\n" +
|
||
$" (_ansi blue)module discover <type>(_ansi reset)\t - Find taskservs/providers/clusters\n" +
|
||
$" (_ansi blue)module load <type> <ws> <mods>(_ansi reset) - Load modules into workspace\n" +
|
||
$" (_ansi blue)module list <type> <ws>(_ansi reset)\t - List loaded modules\n" +
|
||
$" (_ansi blue)module unload <type> <ws> <mod>(_ansi reset) - Unload module\n" +
|
||
$" (_ansi blue)module sync-nickel <infra>(_ansi reset)\t - Sync Nickel dependencies\n\n" +
|
||
|
||
$"(_ansi green_bold)[Architecture](_ansi reset) Layer System (_ansi cyan)STRATEGIC(_ansi reset)\n" +
|
||
$" (_ansi blue)layer explain(_ansi reset) - Explain layer concept\n" +
|
||
$" (_ansi blue)layer show <ws>(_ansi reset) - Show layer resolution\n" +
|
||
$" (_ansi blue)layer test <mod> <ws>(_ansi reset) - Test layer resolution\n" +
|
||
$" (_ansi blue)layer stats(_ansi reset) - Show statistics\n\n" +
|
||
|
||
$"(_ansi green_bold)[Maintenance](_ansi reset) Version Management\n" +
|
||
$" (_ansi blue)version check(_ansi reset) - Check all versions\n" +
|
||
$" (_ansi blue)version show(_ansi reset) - Display status [--format table|json]\n" +
|
||
$" (_ansi blue)version updates(_ansi reset) - Check available updates\n" +
|
||
$" (_ansi blue)version apply(_ansi reset) - Apply config updates\n" +
|
||
$" (_ansi blue)version taskserv <name>(_ansi reset) - Show taskserv version\n\n" +
|
||
|
||
$"(_ansi green_bold)[Distribution](_ansi reset) Packaging (_ansi yellow)Advanced(_ansi reset)\n" +
|
||
$" (_ansi blue)pack core(_ansi reset) - Package core schemas\n" +
|
||
$" (_ansi blue)pack provider <name>(_ansi reset) - Package provider\n" +
|
||
$" (_ansi blue)pack list(_ansi reset) - List packages\n" +
|
||
$" (_ansi blue)pack clean(_ansi reset) - Clean old packages\n\n" +
|
||
|
||
$"(_ansi default_dimmed)💡 The layer system is key to configuration inheritance\n" +
|
||
$" Use 'provisioning layer explain' to understand it(_ansi reset)\n"
|
||
)
|
||
}
|
||
|
||
# These are temporary stubs - original implementations preserved
|
||
# In a full refactor, these would all use the renderer and structured data
|
||
|
||
def help-workspace [] {
|
||
(
|
||
$"(_ansi green_bold)╔══════════════════════════════════════════════════╗(_ansi reset)\n" +
|
||
$"(_ansi green_bold)║(_ansi reset) 📁 WORKSPACE & TEMPLATES (_ansi green_bold)║(_ansi reset)\n" +
|
||
$"(_ansi green_bold)╚══════════════════════════════════════════════════╝(_ansi reset)\n\n" +
|
||
|
||
$"(_ansi green_bold)[Management](_ansi reset) Workspace Operations\n" +
|
||
$" (_ansi blue)workspace init <path>(_ansi reset)\t\t - Initialize workspace [--activate] [--interactive]\n" +
|
||
$" (_ansi blue)workspace create <path>(_ansi reset)\t - Create workspace structure [--activate]\n" +
|
||
$" (_ansi blue)workspace activate <name>(_ansi reset)\t - Activate existing workspace as default\n" +
|
||
$" (_ansi blue)workspace validate <path>(_ansi reset)\t - Validate structure\n" +
|
||
$" (_ansi blue)workspace info <path>(_ansi reset)\t\t - Show information\n" +
|
||
$" (_ansi blue)workspace list(_ansi reset)\t\t - List workspaces\n" +
|
||
$" (_ansi blue)workspace migrate [name](_ansi reset)\t - Migrate workspace [--skip-backup] [--force]\n" +
|
||
$" (_ansi blue)workspace version [name](_ansi reset)\t - Show workspace version information\n" +
|
||
$" (_ansi blue)workspace check-compatibility [name](_ansi reset) - Check workspace compatibility\n" +
|
||
$" (_ansi blue)workspace list-backups [name](_ansi reset)\t - List workspace backups\n\n" +
|
||
|
||
$"(_ansi green_bold)[Synchronization](_ansi reset) Update Hidden Directories & Modules\n" +
|
||
$" (_ansi blue)workspace check-updates [name](_ansi reset)\t - Check which directories need updating\n" +
|
||
$" (_ansi blue)workspace update [name] [FLAGS](_ansi reset)\t - Update all hidden dirs and content\n" +
|
||
$" \t\t\tUpdates: .providers, .clusters, .taskservs, .nickel\n" +
|
||
$" (_ansi blue)workspace sync-modules [name] [FLAGS](_ansi reset)\t - Sync workspace modules\n\n" +
|
||
|
||
$"(_ansi default_dimmed)Note: Optional workspace name [name] defaults to active workspace if not specified(_ansi reset)\n\n" +
|
||
|
||
$"(_ansi green_bold)[Common Flags](_ansi reset)\n" +
|
||
$" (_ansi cyan)--check (-c)(_ansi reset) - Preview changes without applying them\n" +
|
||
$" (_ansi cyan)--force (-f)(_ansi reset) - Skip confirmation prompts\n" +
|
||
$" (_ansi cyan)--yes (-y)(_ansi reset) - Auto-confirm (same as --force)\n" +
|
||
$" (_ansi cyan)--verbose(-v)(_ansi reset) - Detailed operation information\n\n" +
|
||
|
||
$"(_ansi cyan_bold)Examples:(_ansi reset)\n" +
|
||
$" (_ansi green)provisioning --yes workspace update(_ansi reset) - Update active workspace with auto-confirm\n" +
|
||
$" (_ansi green)provisioning --verbose workspace update myws(_ansi reset) - Update 'myws' with detailed output\n" +
|
||
$" (_ansi green)provisioning --check workspace update(_ansi reset) - Preview changes before updating\n" +
|
||
$" (_ansi green)provisioning --yes --verbose workspace update myws(_ansi reset) - Combine flags\n\n" +
|
||
|
||
$"(_ansi yellow_bold)⚠️ IMPORTANT - Nushell Flag Ordering:(_ansi reset)\n" +
|
||
$" Nushell requires (_ansi cyan)flags BEFORE positional arguments(_ansi reset). Thus:\n" +
|
||
$" ✅ (_ansi green)provisioning --yes workspace update(_ansi reset) [Correct - flags first]\n" +
|
||
$" ❌ (_ansi red)provisioning workspace update --yes(_ansi reset) [Wrong - parser error]\n\n" +
|
||
|
||
$"(_ansi green_bold)[Creation Modes](_ansi reset)\n" +
|
||
$" (_ansi blue)--activate\(-a\)(_ansi reset)\t\t - Activate workspace as default after creation\n" +
|
||
$" (_ansi blue)--interactive\(-I\)(_ansi reset)\t\t - Interactive workspace creation wizard\n\n" +
|
||
|
||
$"(_ansi green_bold)[Configuration](_ansi reset) Workspace Config Management\n" +
|
||
$" (_ansi blue)workspace config show [name](_ansi reset)\t\t - Show workspace config [--format yaml|json|toml]\n" +
|
||
$" (_ansi blue)workspace config validate [name](_ansi reset)\t - Validate all configs\n" +
|
||
$" (_ansi blue)workspace config generate provider <name>(_ansi reset) - Generate provider config\n" +
|
||
$" (_ansi blue)workspace config edit <type> [name](_ansi reset)\t - Edit config \(main|provider|platform|kms\)\n" +
|
||
$" (_ansi blue)workspace config hierarchy [name](_ansi reset)\t - Show config loading order\n" +
|
||
$" (_ansi blue)workspace config list [name](_ansi reset)\t\t - List config files [--type all|provider|platform|kms]\n\n" +
|
||
|
||
$"(_ansi green_bold)[Patterns](_ansi reset) Infrastructure Templates\n" +
|
||
$" (_ansi blue)template list(_ansi reset)\t\t - List templates [--type taskservs|providers]\n" +
|
||
$" (_ansi blue)template types(_ansi reset)\t - Show template categories\n" +
|
||
$" (_ansi blue)template show <name>(_ansi reset)\t\t - Show template details\n" +
|
||
$" (_ansi blue)template apply <name> <infra>(_ansi reset)\t - Apply to infrastructure\n" +
|
||
$" (_ansi blue)template validate <infra>(_ansi reset)\t - Validate template usage\n\n" +
|
||
|
||
$"(_ansi default_dimmed)💡 Config commands use active workspace if name not provided\n" +
|
||
$" Example: provisioning workspace config show --format json(_ansi reset)\n"
|
||
)
|
||
}
|
||
|
||
# Stubs for remaining categories (preserved from original for continuity)
|
||
def help-platform [] { "" }
|
||
def help-setup [] { "" }
|
||
def help-concepts [] { "" }
|
||
def help-guides [] { "" }
|
||
def help-authentication [] { "" }
|
||
def help-mfa [] { "" }
|
||
def help-plugins [] { "" }
|
||
def help-utilities [] { "" }
|
||
def help-tools [] { "" }
|
||
def help-diagnostics [] { "" }
|
||
def help-integrations [] { "" }
|
||
def help-vm [] { "" }
|