arkaos 4.3.2 → 4.3.3

package/bin/arka-doctor

@@ -0,0 +1,391 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — Doctor (Health Check System)
+# Usage: arka doctor [--fix] [--json]
+# 16 modular checks: fail = critical, warn = advisory
+# ============================================================================
+set -euo pipefail
+
+# ─── Args ──────────────────────────────────────────────────────────────────
+FIX_MODE=false
+JSON_MODE=false
+for arg in "$@"; do
+  case "$arg" in
+    --fix)  FIX_MODE=true ;;
+    --json) JSON_MODE=true ;;
+  esac
+done
+
+# ─── Colors ────────────────────────────────────────────────────────────────
+if [ "$JSON_MODE" = true ]; then
+  # No colors in JSON mode
+  G="" Y="" R="" C="" N="" B=""
+else
+  G='\033[0;32m'   # green
+  Y='\033[1;33m'   # yellow
+  R='\033[0;31m'   # red
+  C='\033[0;36m'   # cyan
+  N='\033[0m'      # reset
+  B='\033[1m'      # bold
+fi
+
+ARKA_OS="${ARKA_OS:-$HOME/.claude/skills/arka}"
+RESULTS=()
+PASS_COUNT=0
+WARN_COUNT=0
+FAIL_COUNT=0
+
+# ─── Check Runner ──────────────────────────────────────────────────────────
+# run_check <name> <severity:fail|warn> <description> <pass:true|false> [fix_message]
+run_check() {
+  local name="$1" severity="$2" desc="$3" passed="$4" fix_msg="${5:-}"
+  local status icon
+
+  if [ "$passed" = true ]; then
+    status="pass"
+    icon="${G}✓${N}"
+    PASS_COUNT=$((PASS_COUNT + 1))
+  elif [ "$severity" = "fail" ]; then
+    status="fail"
+    icon="${R}✗${N}"
+    FAIL_COUNT=$((FAIL_COUNT + 1))
+  else
+    status="warn"
+    icon="${Y}⚠${N}"
+    WARN_COUNT=$((WARN_COUNT + 1))
+  fi
+
+  if [ "$JSON_MODE" = true ]; then
+    RESULTS+=("{\"name\":\"$name\",\"status\":\"$status\",\"severity\":\"$severity\",\"description\":\"$desc\",\"fix\":\"$fix_msg\"}")
+  else
+    printf "  %b  %-20s %s" "$icon" "$name" "$desc"
+    if [ "$status" != "pass" ] && [ -n "$fix_msg" ]; then
+      printf " ${Y}(%s)${N}" "$fix_msg"
+    fi
+    echo ""
+  fi
+}
+
+# ─── Header ────────────────────────────────────────────────────────────────
+if [ "$JSON_MODE" != true ]; then
+  echo ""
+  echo -e "${C}╔══════════════════════════════════════════════════╗${N}"
+  echo -e "${C}║${N}  ${B}ARKA OS Doctor${N} — Health Check System           ${C}║${N}"
+  echo -e "${C}╚══════════════════════════════════════════════════╝${N}"
+  echo ""
+fi
+
+# ─── Check 1: Claude CLI ──────────────────────────────────────────────────
+CLAUDE_OK=false
+if command -v claude &>/dev/null; then
+  CLAUDE_OK=true
+fi
+run_check "claude-cli" "fail" "Claude Code CLI installed" "$CLAUDE_OK" "Install: npm install -g @anthropic-ai/claude-code"
+
+# ─── Check 2: ARKA OS Install ─────────────────────────────────────────────
+ARKA_OK=false
+ARKA_DESC="ARKA OS installed"
+if [ -d "$ARKA_OS" ] && [ -f "$ARKA_OS/SKILL.md" ]; then
+  ARKA_OK=true
+  ARKA_VER=$(cat "$ARKA_OS/VERSION" 2>/dev/null || echo "?")
+  ARKA_DESC="ARKA OS v${ARKA_VER} installed"
+fi
+run_check "arka-install" "fail" "$ARKA_DESC" "$ARKA_OK" "Run: bash install.sh"
+
+# ─── Check 3: jq ──────────────────────────────────────────────────────────
+JQ_OK=false
+if command -v jq &>/dev/null; then
+  JQ_OK=true
+fi
+run_check "jq" "fail" "jq available" "$JQ_OK" "Install: brew install jq"
+
+# ─── Check 4: User Profile ────────────────────────────────────────────────
+PROFILE_OK=false
+PROFILE_DESC="User profile exists"
+PROFILE_FILE="$HOME/.arka-os/profile.json"
+if [ -f "$PROFILE_FILE" ]; then
+  PNAME=$(jq -r '.user_name // ""' "$PROFILE_FILE" 2>/dev/null)
+  if [ -n "$PNAME" ] && [ "$PNAME" != "null" ]; then
+    PROFILE_OK=true
+    PROFILE_DESC="User profile exists ($PNAME)"
+  else
+    PROFILE_DESC="User profile exists but missing name"
+  fi
+fi
+if [ "$FIX_MODE" = true ] && [ "$PROFILE_OK" = false ] && [ ! -f "$PROFILE_FILE" ]; then
+  mkdir -p "$HOME/.arka-os"
+  echo '{"user_name":"","company_name":"","role":"","onboarding_version":"1"}' > "$PROFILE_FILE"
+  PROFILE_DESC="User profile created (run /arka setup to complete)"
+fi
+run_check "profile" "warn" "$PROFILE_DESC" "$PROFILE_OK" "Run: /arka setup"
+
+# ─── Check 5: Status Line ─────────────────────────────────────────────────
+SL_OK=false
+SL_DESC="Status line configured"
+SETTINGS_FILE="$HOME/.claude/settings.json"
+if [ -f "$SETTINGS_FILE" ] && jq -e '.statusLine.command' "$SETTINGS_FILE" &>/dev/null; then
+  SL_CMD=$(jq -r '.statusLine.command' "$SETTINGS_FILE")
+  if [ -f "$SL_CMD" ]; then
+    SL_OK=true
+  else
+    SL_DESC="Status line command not found: $SL_CMD"
+  fi
+fi
+if [ "$FIX_MODE" = true ] && [ "$SL_OK" = false ] && [ -f "$ARKA_OS/statusline.sh" ]; then
+  if [ -f "$SETTINGS_FILE" ] && command -v jq &>/dev/null; then
+    jq --arg cmd "$ARKA_OS/statusline.sh" '.statusLine = {"type":"command","command":$cmd,"padding":2}' \
+      "$SETTINGS_FILE" > "$SETTINGS_FILE.tmp" && mv "$SETTINGS_FILE.tmp" "$SETTINGS_FILE"
+    SL_OK=true
+    SL_DESC="Status line configured (fixed)"
+  fi
+fi
+run_check "statusline" "warn" "$SL_DESC" "$SL_OK" "Run: bash install.sh"
+
+# ─── Check 6: Hooks ───────────────────────────────────────────────────────
+HOOKS_OK=false
+HOOKS_DESC="Hooks configured"
+if [ -f "$SETTINGS_FILE" ] && jq -e '.hooks.UserPromptSubmit' "$SETTINGS_FILE" &>/dev/null; then
+  HOOKS_OK=true
+  HOOK_COUNT=$(jq '[.hooks | to_entries[].value[].hooks[]] | length' "$SETTINGS_FILE" 2>/dev/null || echo "0")
+  HOOKS_DESC="Hooks configured ($HOOK_COUNT hook(s))"
+fi
+if [ "$FIX_MODE" = true ] && [ "$HOOKS_OK" = false ]; then
+  HOOKS_DIR="$HOME/.claude/skills/arka/hooks"
+  if [ -d "$HOOKS_DIR" ] && [ -f "$SETTINGS_FILE" ] && command -v jq &>/dev/null; then
+    HOOKS_JSON=$(jq -n \
+      --arg ups "$HOOKS_DIR/user-prompt-submit.sh" \
+      --arg pc "$HOOKS_DIR/pre-compact.sh" \
+      --arg ptu "$HOOKS_DIR/post-tool-use.sh" \
+      '{
+        "UserPromptSubmit": [{"hooks":[{"type":"command","command":$ups,"timeout":10}]}],
+        "PreCompact": [{"hooks":[{"type":"command","command":$pc,"timeout":30}]}],
+        "PostToolUse": [{"hooks":[{"type":"command","command":$ptu,"timeout":5}]}]
+      }')
+    jq --argjson hooks "$HOOKS_JSON" '.hooks = $hooks' "$SETTINGS_FILE" > "$SETTINGS_FILE.tmp" && \
+      mv "$SETTINGS_FILE.tmp" "$SETTINGS_FILE"
+    HOOKS_OK=true
+    HOOKS_DESC="Hooks configured (fixed)"
+  fi
+fi
+run_check "hooks" "warn" "$HOOKS_DESC" "$HOOKS_OK" "Run: bash install.sh"
+
+# ─── Check 7: Obsidian Vault ──────────────────────────────────────────────
+OBS_OK=false
+OBS_DESC="Obsidian vault configured"
+OBS_CONFIG="$ARKA_OS/knowledge/obsidian-config.json"
+if [ -f "$OBS_CONFIG" ]; then
+  VAULT_PATH=$(jq -r '.vault_path // ""' "$OBS_CONFIG" 2>/dev/null)
+  if [ -n "$VAULT_PATH" ] && [ -d "$VAULT_PATH" ] && [ -d "$VAULT_PATH/.obsidian" ]; then
+    OBS_OK=true
+    OBS_DESC="Obsidian vault: $(basename "$VAULT_PATH")"
+  elif [ -n "$VAULT_PATH" ]; then
+    OBS_DESC="Obsidian vault path invalid: $VAULT_PATH"
+  fi
+fi
+run_check "obsidian" "warn" "$OBS_DESC" "$OBS_OK" "Run: bash install.sh (will auto-detect)"
+
+# ─── Check 8: Departments ─────────────────────────────────────────────────
+DEPT_OK=false
+DEPT_COUNT=0
+for dept_dir in "$HOME/.claude/skills"/arka-*/; do
+  [ -d "$dept_dir" ] && [ -f "$dept_dir/SKILL.md" ] && DEPT_COUNT=$((DEPT_COUNT + 1))
+done
+# Subtract non-department skills (arka-scaffold, arka-mcp, etc. are sub-skills but still count as skills)
+DEPT_DESC="$DEPT_COUNT department skills installed"
+if [ "$DEPT_COUNT" -ge 7 ]; then
+  DEPT_OK=true
+fi
+run_check "departments" "warn" "$DEPT_DESC" "$DEPT_OK" "Run: bash install.sh"
+
+# ─── Check 9: Personas ────────────────────────────────────────────────────
+PERSONA_OK=false
+PERSONA_COUNT=0
+for agent in "$HOME/.claude/agents"/arka-*.md; do
+  [ -f "$agent" ] && PERSONA_COUNT=$((PERSONA_COUNT + 1))
+done
+PERSONA_DESC="$PERSONA_COUNT agent files installed"
+if [ "$PERSONA_COUNT" -ge 10 ]; then
+  PERSONA_OK=true
+fi
+run_check "personas" "warn" "$PERSONA_DESC" "$PERSONA_OK" "Run: bash install.sh"
+
+# ─── Check 10: MCP Registry ───────────────────────────────────────────────
+MCP_OK=false
+MCP_DESC="MCP registry present"
+MCP_REG="$ARKA_OS/mcps/registry.json"
+if [ -f "$MCP_REG" ]; then
+  MCP_COUNT=$(jq '.mcpServers | length' "$MCP_REG" 2>/dev/null || echo "0")
+  MCP_OK=true
+  MCP_DESC="MCP registry ($MCP_COUNT MCPs)"
+fi
+run_check "mcp-registry" "fail" "$MCP_DESC" "$MCP_OK" "Run: bash install.sh"
+
+# ─── Check 11: Prerequisites ──────────────────────────────────────────────
+PREREQ_OK=true
+MISSING_PREREQS=""
+for bin in yt-dlp ffmpeg python3; do
+  if ! command -v "$bin" &>/dev/null; then
+    MISSING_PREREQS="$MISSING_PREREQS $bin"
+    PREREQ_OK=false
+  fi
+done
+MISSING_PREREQS="${MISSING_PREREQS# }"  # trim leading space
+if [ "$PREREQ_OK" = true ]; then
+  PREREQ_DESC="yt-dlp, ffmpeg, python3 available"
+else
+  PREREQ_DESC="Missing: $MISSING_PREREQS"
+fi
+run_check "prerequisites" "warn" "$PREREQ_DESC" "$PREREQ_OK" "brew install $MISSING_PREREQS"
+
+# ─── Check 12: Capabilities ───────────────────────────────────────────────
+CAPS_OK=false
+CAPS_DESC="capabilities.json present"
+CAPS_FILE="$HOME/.arka-os/capabilities.json"
+if [ -f "$CAPS_FILE" ]; then
+  # Check age (< 7 days)
+  CAPS_AGE=$(( ($(date +%s) - $(stat -f%m "$CAPS_FILE" 2>/dev/null || stat -c%Y "$CAPS_FILE" 2>/dev/null || echo 0)) ))
+  CAPS_DAYS=$((CAPS_AGE / 86400))
+  if [ "$CAPS_DAYS" -lt 7 ]; then
+    CAPS_OK=true
+    CAPS_DESC="capabilities.json (${CAPS_DAYS}d old)"
+  else
+    CAPS_DESC="capabilities.json stale (${CAPS_DAYS}d old, max 7d)"
+  fi
+fi
+if [ "$FIX_MODE" = true ] && [ "$CAPS_OK" = false ]; then
+  CAPS_SCRIPT="$ARKA_OS/../arka-knowledge/scripts/kb-check-capabilities.sh"
+  # Also check repo path
+  REPO_PATH=$(cat "$ARKA_OS/.repo-path" 2>/dev/null || echo "")
+  if [ -n "$REPO_PATH" ] && [ -f "$REPO_PATH/departments/kb/scripts/kb-check-capabilities.sh" ]; then
+    CAPS_SCRIPT="$REPO_PATH/departments/kb/scripts/kb-check-capabilities.sh"
+  fi
+  if [ -f "$CAPS_SCRIPT" ]; then
+    bash "$CAPS_SCRIPT" >/dev/null 2>&1 && CAPS_OK=true && CAPS_DESC="capabilities.json (refreshed)"
+  fi
+fi
+run_check "capabilities" "warn" "$CAPS_DESC" "$CAPS_OK" "Run: arka kb capabilities"
+
+# ─── Check 13: Agent Memory ─────────────────────────────────────────────
+AMEM_OK=false
+AMEM_COUNT=0
+AMEM_DIR="$HOME/.claude/agent-memory"
+if [ -d "$AMEM_DIR" ]; then
+  for mem_dir in "$AMEM_DIR"/arka-*/MEMORY.md; do
+    [ -f "$mem_dir" ] && AMEM_COUNT=$((AMEM_COUNT + 1))
+  done
+fi
+AMEM_DESC="$AMEM_COUNT/15 agent memory files"
+if [ "$AMEM_COUNT" -ge 15 ]; then
+  AMEM_OK=true
+fi
+run_check "agent-memory" "warn" "$AMEM_DESC" "$AMEM_OK" "Run: bash install.sh"
+
+# ─── Check 14: Install Manifest ─────────────────────────────────────────
+MANIFEST_OK=false
+MANIFEST_DESC="Install manifest present"
+MANIFEST_FILE="$HOME/.arka-os/install-manifest.json"
+if [ -f "$MANIFEST_FILE" ]; then
+  if jq empty "$MANIFEST_FILE" 2>/dev/null; then
+    MANIFEST_VER=$(jq -r '.version // "?"' "$MANIFEST_FILE")
+    FILE_COUNT=$(jq '.files | length' "$MANIFEST_FILE" 2>/dev/null || echo "0")
+    MANIFEST_OK=true
+    MANIFEST_DESC="Install manifest v${MANIFEST_VER} ($FILE_COUNT files)"
+  else
+    MANIFEST_DESC="Install manifest corrupted"
+  fi
+fi
+run_check "install-manifest" "warn" "$MANIFEST_DESC" "$MANIFEST_OK" "Run: bash install.sh"
+
+# ─── Check 15: Gotchas ──────────────────────────────────────────────────
+GOTCHAS_OK=false
+GOTCHAS_DESC="Gotchas file present"
+GOTCHAS_FILE="$HOME/.arka-os/gotchas.json"
+if [ -f "$GOTCHAS_FILE" ]; then
+  if jq empty "$GOTCHAS_FILE" 2>/dev/null; then
+    GOTCHA_COUNT=$(jq 'length' "$GOTCHAS_FILE" 2>/dev/null || echo "0")
+    GOTCHAS_OK=true
+    GOTCHAS_DESC="Gotchas tracking ($GOTCHA_COUNT patterns)"
+  else
+    GOTCHAS_DESC="Gotchas file corrupted"
+  fi
+else
+  # Create empty gotchas file if missing (auto-fix always)
+  mkdir -p "$HOME/.arka-os"
+  echo '[]' > "$GOTCHAS_FILE"
+  GOTCHAS_OK=true
+  GOTCHAS_DESC="Gotchas file created (empty)"
+fi
+run_check "gotchas" "warn" "$GOTCHAS_DESC" "$GOTCHAS_OK" "Run: bash install.sh"
+
+# ─── Check 16: Plugins (Superpowers + Claude-Mem) ─────────────────────────
+PLUGINS_OK=false
+PLUGINS_DESC="Plugins not checked"
+if command -v claude &>/dev/null; then
+  PLUGIN_LIST=$(claude plugin list 2>/dev/null || echo "")
+  HAS_SP=false
+  HAS_CM=false
+  echo "$PLUGIN_LIST" | grep -q "superpowers" && HAS_SP=true
+  echo "$PLUGIN_LIST" | grep -q "claude-mem" && HAS_CM=true
+
+  if [ "$HAS_SP" = true ] && [ "$HAS_CM" = true ]; then
+    PLUGINS_OK=true
+    PLUGINS_DESC="Plugins installed (Superpowers + Claude-Mem)"
+  elif [ "$HAS_SP" = true ]; then
+    PLUGINS_DESC="Missing Claude-Mem plugin"
+  elif [ "$HAS_CM" = true ]; then
+    PLUGINS_DESC="Missing Superpowers plugin"
+  else
+    PLUGINS_DESC="Missing both plugins (Superpowers + Claude-Mem)"
+  fi
+
+  # Auto-fix: install missing plugins
+  if [ "$FIX_MODE" = true ] && [ "$PLUGINS_OK" = false ]; then
+    if [ "$HAS_SP" = false ]; then
+      MARKETPLACES=$(claude plugin marketplace list 2>/dev/null || echo "")
+      echo "$MARKETPLACES" | grep -q "superpowers-marketplace" || \
+        claude plugin marketplace add obra/superpowers-marketplace >/dev/null 2>&1
+      claude plugin install superpowers@superpowers-marketplace >/dev/null 2>&1 && HAS_SP=true
+    fi
+    if [ "$HAS_CM" = false ]; then
+      MARKETPLACES=$(claude plugin marketplace list 2>/dev/null || echo "")
+      echo "$MARKETPLACES" | grep -q "thedotmack" || \
+        claude plugin marketplace add thedotmack/claude-mem >/dev/null 2>&1
+      claude plugin install claude-mem@thedotmack >/dev/null 2>&1 && HAS_CM=true
+    fi
+    if [ "$HAS_SP" = true ] && [ "$HAS_CM" = true ]; then
+      PLUGINS_OK=true
+      PLUGINS_DESC="Plugins installed (auto-fixed)"
+    fi
+  fi
+else
+  PLUGINS_DESC="Claude CLI not found — cannot check plugins"
+fi
+run_check "plugins" "warn" "$PLUGINS_DESC" "$PLUGINS_OK" "Run: bash install.sh"
+
+# ─── Output ────────────────────────────────────────────────────────────────
+TOTAL=$((PASS_COUNT + WARN_COUNT + FAIL_COUNT))
+
+if [ "$JSON_MODE" = true ]; then
+  # Build JSON array
+  echo -n "["
+  for i in "${!RESULTS[@]}"; do
+    [ "$i" -gt 0 ] && echo -n ","
+    echo -n "${RESULTS[$i]}"
+  done
+  echo "]"
+else
+  echo ""
+  echo -e "  ${B}Results:${N} ${G}${PASS_COUNT} passed${N}, ${Y}${WARN_COUNT} warnings${N}, ${R}${FAIL_COUNT} failed${N} (${TOTAL} checks)"
+
+  if [ "$FAIL_COUNT" -gt 0 ]; then
+    echo ""
+    echo -e "  ${R}Some critical checks failed.${N} Run ${C}arka doctor --fix${N} to attempt auto-repair."
+  elif [ "$WARN_COUNT" -gt 0 ]; then
+    echo ""
+    echo -e "  ${Y}Some warnings detected.${N} Run ${C}arka doctor --fix${N} to attempt auto-repair."
+  else
+    echo ""
+    echo -e "  ${G}All checks passed!${N} ARKA OS is healthy."
+  fi
+  echo ""
+fi

package/bin/arka-providers

@@ -0,0 +1,261 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — Provider Registry Manager
+# Manage external AI providers and models (image, video, text)
+# Usage: arka providers [command] [args...]
+# ============================================================================
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+REGISTRY="$REPO_DIR/config/providers-registry.json"
+ENV_FILE="$HOME/.arka-os/.env"
+
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+# Require jq
+command -v jq &>/dev/null || { echo "Error: jq is required. Install: brew install jq"; exit 1; }
+
+# Load env if present
+[ -f "$ENV_FILE" ] && source "$ENV_FILE"
+
+# ─── Helper: Check if API key is configured ─────────────────────────────────
+is_key_configured() {
+  local var_name="$1"
+  local value="${!var_name:-}"
+  [ -n "$value" ] && [ ${#value} -ge 8 ]
+}
+
+# ─── List providers ──────────────────────────────────────────────────────────
+cmd_list() {
+  echo ""
+  echo -e "${CYAN}╔══════════════════════════════════════════════════════════════╗${NC}"
+  echo -e "${CYAN}║${NC}  ${BOLD}ARKA OS — AI Providers${NC}                                     ${CYAN}║${NC}"
+  echo -e "${CYAN}╚══════════════════════════════════════════════════════════════╝${NC}"
+  echo ""
+
+  local providers
+  providers=$(jq -r '.providers | keys[]' "$REGISTRY")
+
+  for provider_id in $providers; do
+    local name auth_env
+    name=$(jq -r --arg id "$provider_id" '.providers[$id].name' "$REGISTRY")
+    auth_env=$(jq -r --arg id "$provider_id" '.providers[$id].auth_env' "$REGISTRY")
+
+    if is_key_configured "$auth_env"; then
+      echo -e "  ${GREEN}●${NC} ${BOLD}$name${NC} ($provider_id) — ${GREEN}configured${NC} [$auth_env]"
+    else
+      echo -e "  ${RED}○${NC} ${BOLD}$name${NC} ($provider_id) — ${YELLOW}not configured${NC} [$auth_env]"
+    fi
+
+    # List models
+    local models
+    models=$(jq -r --arg id "$provider_id" '.providers[$id].models | to_entries[] | "      \(.value.type | ascii_upcase)  \(.key) — \(.value.description)"' "$REGISTRY")
+    echo "$models"
+    echo ""
+  done
+
+  local total_providers total_models
+  total_providers=$(jq '.providers | length' "$REGISTRY")
+  total_models=$(jq '[.providers[].models | length] | add' "$REGISTRY")
+  echo -e "  ${CYAN}$total_providers${NC} providers, ${CYAN}$total_models${NC} models"
+  echo ""
+}
+
+# ─── Add provider (interactive) ─────────────────────────────────────────────
+cmd_add() {
+  local provider_id="${1:-}"
+  if [ -z "$provider_id" ]; then
+    echo -e "${BLUE}Add a new AI provider${NC}"
+    read -rp "  Provider ID (lowercase, no spaces): " provider_id
+  fi
+  [ -z "$provider_id" ] && { echo "Error: Provider ID is required."; exit 1; }
+
+  # Check if already exists
+  if jq -e --arg id "$provider_id" '.providers[$id]' "$REGISTRY" &>/dev/null; then
+    echo -e "${YELLOW}Provider '$provider_id' already exists. Use 'add-model' to add models.${NC}"
+    exit 1
+  fi
+
+  read -rp "  Display name: " name
+  read -rp "  Base URL (e.g., https://api.example.com/v1): " base_url
+  read -rp "  Auth env variable name (e.g., EXAMPLE_API_KEY): " auth_env
+  read -rp "  Auth header format (e.g., Authorization: Bearer): " auth_header
+
+  [ -z "$name" ] || [ -z "$base_url" ] || [ -z "$auth_env" ] && { echo "Error: All fields are required."; exit 1; }
+  [ -z "$auth_header" ] && auth_header="Authorization: Bearer"
+
+  # Add to registry
+  local tmp
+  tmp=$(mktemp)
+  jq --arg id "$provider_id" \
+     --arg name "$name" \
+     --arg base_url "$base_url" \
+     --arg auth_env "$auth_env" \
+     --arg auth_header "$auth_header" \
+     '.providers[$id] = {name: $name, base_url: $base_url, auth_env: $auth_env, auth_header: $auth_header, models: {}}' \
+     "$REGISTRY" > "$tmp" && mv "$tmp" "$REGISTRY"
+
+  echo -e "${GREEN}✓${NC} Provider '$provider_id' added. Use 'arka providers add-model $provider_id <model-id>' to add models."
+}
+
+# ─── Remove provider ─────────────────────────────────────────────────────────
+cmd_remove() {
+  local provider_id="${1:-}"
+  [ -z "$provider_id" ] && { echo "Usage: arka providers remove <provider-id>"; exit 1; }
+
+  if ! jq -e --arg id "$provider_id" '.providers[$id]' "$REGISTRY" &>/dev/null; then
+    echo -e "${RED}Provider '$provider_id' not found.${NC}"
+    exit 1
+  fi
+
+  local tmp
+  tmp=$(mktemp)
+  jq --arg id "$provider_id" '
+    .providers |= del(.[$id]) |
+    .routing |= with_entries(.value |= [.[] | select(startswith($id + "/") | not)])
+  ' "$REGISTRY" > "$tmp" && mv "$tmp" "$REGISTRY"
+
+  echo -e "${GREEN}✓${NC} Provider '$provider_id' removed."
+}
+
+# ─── Add model to existing provider ──────────────────────────────────────────
+cmd_add_model() {
+  local provider_id="${1:-}"
+  local model_id="${2:-}"
+  [ -z "$provider_id" ] || [ -z "$model_id" ] && { echo "Usage: arka providers add-model <provider-id> <model-id> [--type image|video|text] [--description \"...\"]"; exit 1; }
+
+  if ! jq -e --arg id "$provider_id" '.providers[$id]' "$REGISTRY" &>/dev/null; then
+    echo -e "${RED}Provider '$provider_id' not found.${NC}"
+    exit 1
+  fi
+
+  shift 2
+  local model_type="text"
+  local description=""
+
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --type) model_type="$2"; shift 2 ;;
+      --description) description="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+
+  [ -z "$description" ] && description="$model_id"
+
+  local tmp
+  tmp=$(mktemp)
+  jq --arg pid "$provider_id" \
+     --arg mid "$model_id" \
+     --arg type "$model_type" \
+     --arg desc "$description" \
+     '.providers[$pid].models[$mid] = {type: $type, description: $desc}' \
+     "$REGISTRY" > "$tmp" && mv "$tmp" "$REGISTRY"
+
+  echo -e "${GREEN}✓${NC} Model '$model_id' ($model_type) added to '$provider_id'."
+}
+
+# ─── Add API key ─────────────────────────────────────────────────────────────
+cmd_add_key() {
+  local var_name="${1:-}"
+  [ -z "$var_name" ] && { echo "Usage: arka providers add-key <ENV_VAR_NAME>"; exit 1; }
+
+  mkdir -p "$(dirname "$ENV_FILE")"
+
+  if is_key_configured "$var_name"; then
+    echo -e "${GREEN}✓${NC} $var_name is already configured."
+    read -rp "  Overwrite? (y/N): " confirm
+    [ "$confirm" != "y" ] && [ "$confirm" != "Y" ] && exit 0
+  fi
+
+  read -rp "  Value for $var_name: " value
+  [ -z "$value" ] && { echo "Skipped."; exit 0; }
+
+  if grep -q "^export $var_name=" "$ENV_FILE" 2>/dev/null; then
+    local tmp
+    tmp=$(mktemp)
+    sed "s|^export $var_name=.*|export $var_name=\"$value\"|" "$ENV_FILE" > "$tmp" && mv "$tmp" "$ENV_FILE"
+  else
+    echo "export $var_name=\"$value\"" >> "$ENV_FILE"
+  fi
+
+  echo -e "${GREEN}✓${NC} $var_name saved to $ENV_FILE"
+  echo -e "  Run ${CYAN}source ~/.zshrc${NC} to load."
+}
+
+# ─── Show routing chains ─────────────────────────────────────────────────────
+cmd_routing() {
+  echo ""
+  echo -e "${CYAN}═══ AI Provider Routing Chains ═══${NC}"
+  echo ""
+
+  local chains
+  chains=$(jq -r '.routing | to_entries[] | .key' "$REGISTRY")
+
+  for chain in $chains; do
+    echo -e "  ${BOLD}$chain:${NC}"
+    jq -r --arg chain "$chain" '.routing[$chain][]' "$REGISTRY" | while IFS= read -r model_ref; do
+      local provider_id="${model_ref%%/*}"
+      local model_id="${model_ref#*/}"
+      local auth_env
+      auth_env=$(jq -r --arg id "$provider_id" '.providers[$id].auth_env // "?"' "$REGISTRY")
+      if is_key_configured "$auth_env"; then
+        echo -e "    ${GREEN}●${NC} $model_ref"
+      else
+        echo -e "    ${RED}○${NC} $model_ref (${YELLOW}no key${NC})"
+      fi
+    done
+    echo ""
+  done
+}
+
+# ─── JSON output ──────────────────────────────────────────────────────────────
+cmd_json() {
+  # Enrich with configured status
+  jq --arg env_file "$ENV_FILE" '
+    . as $reg |
+    .providers | to_entries | map(
+      .value.configured = (
+        .value.auth_env as $env |
+        (env[$env] // "") | length >= 8
+      )
+    ) | from_entries |
+    $reg | .providers = .
+  ' "$REGISTRY" 2>/dev/null || cat "$REGISTRY"
+}
+
+# ─── Main ─────────────────────────────────────────────────────────────────────
+case "${1:-}" in
+  add)
+    shift
+    cmd_add "$@"
+    ;;
+  remove)
+    shift
+    cmd_remove "$@"
+    ;;
+  add-model)
+    shift
+    cmd_add_model "$@"
+    ;;
+  add-key)
+    shift
+    cmd_add_key "$@"
+    ;;
+  routing)
+    cmd_routing
+    ;;
+  --json)
+    cmd_json
+    ;;
+  *)
+    cmd_list
+    ;;
+esac