Skip to content

D1-cli-command-tree.md

Latest commit

 

History

History
237 lines (195 loc) · 6.92 KB

D1-cli-command-tree.md

File metadata and controls

237 lines (195 loc) · 6.92 KB
Raw

D1: CLI Command Tree

arc → workspace/services/theme/info subcommands

Mermaid Diagram

flowchart TB
    subgraph Root["arc (Root Command)"]
        arc["arc"]
    end

    subgraph TopLevel["Top-Level Commands"]
        init["init"]
        workspace["workspace"]
        services["services"]
        theme["theme"]
        info["info"]
        state["state"]
        completion["completion"]
        version["version"]
    end

    subgraph WorkspaceSub["workspace subcommands"]
        ws_init["init [path]"]
        ws_run["run"]
        ws_info["info"]
        ws_history["history"]
    end

    subgraph ServicesSub["services subcommands"]
        svc_list["list"]
        svc_info["info <codename>"]
        svc_deps["deps <codename>"]
        svc_ports["ports"]
    end

    subgraph ThemeSub["theme subcommands"]
        th_list["list"]
        th_set["set <name>"]
        th_show["show"]
        th_preview["preview <name>"]
    end

    subgraph StateSub["state subcommands"]
        st_show["show"]
        st_clear["clear"]
    end

    arc --> init
    arc --> workspace
    arc --> services
    arc --> theme
    arc --> info
    arc --> state
    arc --> completion
    arc --> version

    workspace --> ws_init
    workspace --> ws_run
    workspace --> ws_info
    workspace --> ws_history

    services --> svc_list
    services --> svc_info
    services --> svc_deps
    services --> svc_ports

    theme --> th_list
    theme --> th_set
    theme --> th_show
    theme --> th_preview

    state --> st_show
    state --> st_clear

    style Root fill:#e94560,stroke:#fff,color:#fff
    style TopLevel fill:#1565c0,stroke:#64b5f6,color:#fff
    style WorkspaceSub fill:#6a1b9a,stroke:#ce93d8,color:#fff
    style ServicesSub fill:#2e7d32,stroke:#81c784,color:#fff
    style ThemeSub fill:#f9a825,stroke:#fff176,color:#000
    style StateSub fill:#00695c,stroke:#4db6ac,color:#fff
Loading

Tree View

arc
├── init                          # Interactive setup wizard
│
├── workspace                     # Workspace management
│   ├── init [path]              # Initialize new workspace
│   ├── run                      # Generate & launch platform
│   ├── info                     # Show workspace state
│   └── history                  # View operation history
│
├── services                      # Service catalog
│   ├── list                     # List all services (--role filter)
│   ├── info <codename>          # Service details
│   ├── deps <codename>          # Dependency tree
│   └── ports                    # Port allocations
│
├── theme                         # Theme management
│   ├── list                     # Available themes
│   ├── set <name>               # Set active theme
│   ├── show                     # Current theme
│   └── preview <name>           # Preview with animation
│
├── state                         # State management
│   ├── show                     # Display current state
│   └── clear                    # Clear all state
│
├── info                          # System information
├── completion                    # Shell completion scripts
│   ├── bash
│   ├── zsh
│   ├── fish
│   └── powershell
│
└── version                       # Version info

Global Flags:
  --verbose, -v          Enable debug logging
  --log-level <level>    Set log level (debug|info|warn|error)
  --no-color             Disable colored output
  --no-animation         Disable animations
  --json                 Output as JSON
  --help, -h             Show help

Eraser.io Prompt

Tree diagram for A.R.C. CLI command hierarchy

Root node: arc (red, prominent)

First level branches (blue):
├── init - Interactive wizard
├── workspace - Workspace management
├── services - Service catalog
├── theme - Theme management
├── state - State management
├── info - System information
├── completion - Shell completion
└── version - Version info

Second level (color-coded by parent):

workspace (purple):
├── init [path]
├── run
├── info
└── history

services (green):
├── list
├── info <codename>
├── deps <codename>
└── ports

theme (yellow):
├── list
├── set <name>
├── show
└── preview <name>

state (teal):
├── show
└── clear

Global flags section at bottom:
--verbose, --log-level, --no-color, --no-animation, --json, --help

Style: Tree structure with colored branches per command group
Icons for each command type
Dark background
Watermark: arc-framework/cli

Command Details

Root Command

Command Description Flags
arc Root command, shows banner --version, --help

Workspace Commands

Command Description Args/Flags
arc workspace init Initialize workspace [path] - default: .
arc workspace run Launch platform --detach, --no-cache
arc workspace info Show workspace state --json
arc workspace history Operation history --limit, --failed

Services Commands

Command Description Args/Flags
arc services list List all services --role filter
arc services info Service details <codename> required
arc services deps Dependency tree <codename> required
arc services ports Port allocations --check for conflicts

Theme Commands

Command Description Args/Flags
arc theme list Available themes -
arc theme set Set active theme <name> required
arc theme show Current theme --colors
arc theme preview Animated preview <name> required

State Commands

Command Description Args/Flags
arc state show Display state --json
arc state clear Clear all state --force

Key Files

Command Group File
Root pkg/cli/root.go
Init Wizard pkg/cli/init.go
Workspace pkg/cli/workspace/*.go
Services pkg/cli/services/*.go
Theme pkg/cli/theme.go
State pkg/cli/state.go
Info pkg/cli/info.go
Completion pkg/cli/completion.go

Watermark: arc-framework/cli