command = extract_command(user_input)
if command not in VALID_COMMANDS:
    command = match_natural_language_variant(user_input)
if command is None:
    show_help_and_suggest_closest_match()
    exit

if command requires script:
    check script exists at ${CLAUDE_PLUGIN_ROOT}/scripts/
if command requires workspace file:
    check file exists at ~/workspace/

# Run health checks
core_files_count = count files in ${CLAUDE_PLUGIN_ROOT}/core/
memory_size = stat ~/workspace/MEMORY.md | get size in KB
recent_logs = count lines in ~/workspace/.logs/YYYY-MM-DD.log (last 24h)
version = cat ${CLAUDE_PLUGIN_ROOT}/VERSION

# Calculate health indicators
core_health = 🟢 if core_files_count >= 8 else 🟡 if >= 6 else 🔴
memory_health = 🟢 if memory_size < 100 else 🟡 if < 500 else 🔴
logs_health = 🟢 if recent_logs < 100 else 🟡 if < 500 else 🔴

# Display dashboard
output = format_status_dashboard(core_health, memory_health, logs_health, version)

📊 AI Persona OS - Status Dashboard
🫀 Last heartbeat: YYYY-MM-DD HH:MM:SS

Core System:     🟢 8 files loaded
Memory:          🟢 42 KB (healthy)
Recent Logs:     🟡 127 entries (24h)
Version:         v0.3.0-alpha

System Status: HEALTHY

soul_content = Read(~/workspace/SOUL.md)
extract:
    - name (from # heading or name: field)
    - role (from role: field or Role: heading)
    - values (from Values: section, list items)
    - style (from Communication Style: section)

output = format_persona_display(name, role, values, style)

🪪 Persona Identity

Name:   Senior Technical Architect
Role:   System design expert specializing in distributed systems

Core Values:
  • Clarity over cleverness
  • Test everything that matters
  • Documentation is love for future you

Communication Style:
  Direct, technical, assumes expertise. Uses precise terminology.
  Proactive with suggestions. Explains reasoning when asked.

memory_content = Read(~/workspace/MEMORY.md)
display memory_content with minimal formatting

result = Bash("${CLAUDE_PLUGIN_ROOT}/scripts/health-check.sh")
display result
# Do not show raw exec commands unless user explicitly asks

result = Bash("${CLAUDE_PLUGIN_ROOT}/scripts/security-audit.sh")
display result
# Highlight any security findings

result = Bash("${CLAUDE_PLUGIN_ROOT}/scripts/config-validator.sh")
display result
# Show validation status for each config file

display COMMAND_REFERENCE_TABLE (from section above)
add usage examples:
    "Type 'status' to see system health"
    "Type 'show persona' to view your identity"
    "Type 'checkpoint' to save your current context"

timestamp = current_timestamp (HH:MM)
date = current_date (YYYY-MM-DD)
checkpoint_file = ~/workspace/memory/${date}.md

# Calculate context percentage (estimate based on conversation length)
context_percentage = min(100, conversation_turns * 5)

# Gather checkpoint data
active_task = ask_user("What task are you currently working on?")
key_decisions = ask_user("Any key decisions or changes to note?")
resume_from = ask_user("What should you resume from next session?")

# Write checkpoint
checkpoint_content = format_checkpoint(
    timestamp, context_percentage, active_task, key_decisions, resume_from
)
Write(checkpoint_file, checkpoint_content, mode=append)

confirm "Checkpoint saved to ${checkpoint_file}"

## Checkpoint [14:32] — Context: 35%

**Active task:** Implementing user authentication flow
**Key decisions:**
- Chose JWT over session cookies for API statelessness
- Added rate limiting at gateway level

**Resume from:** Complete integration tests for /auth/login endpoint

# Set proactive mode flag (in SOUL.md or runtime state)
confirm "✅ Proactive advisor mode ENABLED"
confirm "I will now offer suggestions and anticipate needs proactively."

# Clear proactive mode flag
confirm "✅ Proactive advisor mode DISABLED"
confirm "I will wait for explicit requests before offering suggestions."

# Display preset menu
presets = Glob("${CLAUDE_PLUGIN_ROOT}/presets/*.yaml")
display_menu(presets)

# Delegate to persona-setup skill
confirm "Switching to persona-setup skill for preset configuration..."
# The persona-setup skill will handle preset selection and file rebuilding

if command == "status":
    use traffic light indicators (🟢🟡🔴)
    include timestamp and version
else if command == "show persona":
    use identity header (🪪)
    format as sections with bullet lists
else if command == "checkpoint":
    use markdown heading with timestamp
    include context percentage
else if command in ["health check", "security audit", "show config"]:
    display script output directly
    highlight warnings and errors
else:
    use minimal formatting

# BAD: showing raw commands
"Running: /path/to/script.sh --flag"

# GOOD: showing results
"Health Check Results:
  ✓ Core files present
  ✓ Memory within limits
  ⚠ Log rotation needed"

❌ Error: health-check.sh not found at ${CLAUDE_PLUGIN_ROOT}/scripts/
Suggestion: Run 'hiivmind-openclaw-os setup' to initialize the plugin

❌ Error: SOUL.md not found at ~/workspace/
Suggestion: Run 'persona-setup' to create your persona configuration

❌ Unknown command: "statsu"
Did you mean: status?
Type 'help' to see all available commands.