arkaos 2.3.0 → 2.3.2

package/config/gotchas-fixes.json

@@ -0,0 +1,148 @@
+{
+  "fixes": [
+    {
+      "pattern_match": "SQLSTATE.*relation.*does not exist",
+      "category": "database",
+      "suggestion": "Table missing. Run: php artisan migrate",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "SQLSTATE.*no such table",
+      "category": "database",
+      "suggestion": "SQLite table missing. Run: php artisan migrate",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Connection refused.*5432",
+      "category": "database",
+      "suggestion": "PostgreSQL not running. Start with: brew services start postgresql",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Connection refused.*3306",
+      "category": "database",
+      "suggestion": "MySQL not running. Start with: brew services start mysql",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "SQLSTATE.*Access denied",
+      "category": "database",
+      "suggestion": "Database credentials wrong. Check DB_USERNAME and DB_PASSWORD in .env",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "npm ERR.*ERESOLVE",
+      "category": "frontend",
+      "suggestion": "Dependency conflict. Try: npm install --legacy-peer-deps",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Cannot find module.*vue",
+      "category": "frontend",
+      "suggestion": "Vue dependency missing. Run: npm install",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Vite manifest not found",
+      "category": "frontend",
+      "suggestion": "Frontend not built. Run: npm run build (or npm run dev for local)",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Module not found",
+      "category": "frontend",
+      "suggestion": "Missing dependency. Run: npm install (or composer install for PHP)",
+      "confidence": "medium"
+    },
+    {
+      "pattern_match": "Out of memory|JavaScript heap",
+      "category": "frontend",
+      "suggestion": "Node ran out of memory. Increase limit: NODE_OPTIONS=--max-old-space-size=4096",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Class.*not found",
+      "category": "laravel",
+      "suggestion": "Autoload stale. Run: composer dump-autoload",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "CSRF token mismatch",
+      "category": "laravel",
+      "suggestion": "Session expired or cache stale. Run: php artisan cache:clear && php artisan config:clear",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Route \\[.*\\] not defined",
+      "category": "laravel",
+      "suggestion": "Route cache stale. Run: php artisan route:clear",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "View \\[.*\\] not found",
+      "category": "laravel",
+      "suggestion": "View path wrong or cache stale. Check path and run: php artisan view:clear",
+      "confidence": "medium"
+    },
+    {
+      "pattern_match": "Permission denied",
+      "category": "permissions",
+      "suggestion": "Insufficient file permissions. Check with: ls -la <path>. Fix with: chmod or chown",
+      "confidence": "medium"
+    },
+    {
+      "pattern_match": "EACCES",
+      "category": "permissions",
+      "suggestion": "Permission denied (Node/npm). Avoid sudo. Fix ownership: sudo chown -R $(whoami) ~/.npm",
+      "confidence": "medium"
+    },
+    {
+      "pattern_match": "ENOSPC",
+      "category": "general",
+      "suggestion": "Disk full or inotify limit reached. Free disk space or increase watchers: echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "ENOENT",
+      "category": "general",
+      "suggestion": "File or directory not found. Verify the path exists and is spelled correctly",
+      "confidence": "medium"
+    },
+    {
+      "pattern_match": "port.*already in use|Address already in use|EADDRINUSE",
+      "category": "general",
+      "suggestion": "Port occupied. Kill the process: lsof -ti:<port> | xargs kill -9",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "Merge conflict|CONFLICT.*Merge",
+      "category": "git",
+      "suggestion": "Merge conflict detected. Open conflicting files, resolve markers (<<<< ==== >>>>), then git add and commit",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "failed to push|rejected.*non-fast-forward",
+      "category": "git",
+      "suggestion": "Remote has changes. Pull first: git pull --rebase origin <branch>",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "fatal: not a git repository",
+      "category": "git",
+      "suggestion": "Not inside a git repo. Run: git init, or cd into the correct directory",
+      "confidence": "high"
+    },
+    {
+      "pattern_match": "PHPUnit.*Failed|Tests:.*failures",
+      "category": "testing",
+      "suggestion": "Test failures. Check assertions, fixtures, and database state. Run: php artisan migrate:fresh --seed --env=testing",
+      "confidence": "medium"
+    },
+    {
+      "pattern_match": "FAIL.*\\.test\\.|jest.*failed",
+      "category": "testing",
+      "suggestion": "Jest test failures. Check test expectations and mocks. Run: npx jest --clearCache if stale",
+      "confidence": "medium"
+    }
+  ]
+}

package/config/profile-template.json

@@ -0,0 +1,12 @@
+{
+  "user_name": "",
+  "company_name": "",
+  "role": "",
+  "industry": "",
+  "projects_dir": "",
+  "documents_dir": "",
+  "objectives": [],
+  "preferred_departments": [],
+  "onboarded_at": "",
+  "onboarding_version": "1"
+}

package/config/providers-registry.json

@@ -0,0 +1,56 @@
+{
+  "_meta": {
+    "version": "1.0.0",
+    "description": "External AI providers and models — extensible via 'arka providers add'"
+  },
+  "providers": {
+    "openai": {
+      "name": "OpenAI",
+      "base_url": "https://api.openai.com/v1",
+      "auth_env": "OPENAI_API_KEY",
+      "auth_header": "Authorization: Bearer",
+      "models": {
+        "gpt-image-1": { "type": "image", "description": "GPT Image 1 — latest" },
+        "dall-e-3": { "type": "image", "description": "DALL-E 3" }
+      }
+    },
+    "replicate": {
+      "name": "Replicate",
+      "base_url": "https://api.replicate.com/v1",
+      "auth_env": "REPLICATE_API_TOKEN",
+      "auth_header": "Authorization: Bearer",
+      "models": {
+        "black-forest-labs/flux-1.1-pro": { "type": "image", "description": "Flux 1.1 Pro" },
+        "stability-ai/sdxl": { "type": "image", "description": "Stable Diffusion XL" },
+        "minimax/video-01": { "type": "video", "description": "MiniMax Video" }
+      }
+    },
+    "fal": {
+      "name": "FAL",
+      "base_url": "https://fal.run",
+      "auth_env": "FAL_KEY",
+      "auth_header": "Authorization: Key",
+      "models": {
+        "fal-ai/flux-pro/v1.1": { "type": "image", "description": "Flux Pro via FAL" },
+        "fal-ai/kling-video/v2/master": { "type": "video", "description": "Kling Video v2" },
+        "fal-ai/runway-gen3/turbo/image-to-video": { "type": "video", "description": "Runway Gen3 Turbo" }
+      }
+    },
+    "openrouter": {
+      "name": "OpenRouter",
+      "base_url": "https://openrouter.ai/api/v1",
+      "auth_env": "OPENROUTER_API_KEY",
+      "auth_header": "Authorization: Bearer",
+      "models": {
+        "google/gemini-2.5-pro": { "type": "text", "description": "Gemini 2.5 Pro" },
+        "deepseek/deepseek-r1": { "type": "text", "description": "DeepSeek R1" },
+        "meta-llama/llama-4-maverick": { "type": "text", "description": "Llama 4 Maverick" }
+      }
+    }
+  },
+  "routing": {
+    "image-generation": ["openai/gpt-image-1", "openai/dall-e-3", "fal/fal-ai/flux-pro/v1.1", "replicate/black-forest-labs/flux-1.1-pro"],
+    "video-generation": ["fal/fal-ai/kling-video/v2/master", "fal/fal-ai/runway-gen3/turbo/image-to-video", "replicate/minimax/video-01"],
+    "text-completion": ["openrouter/google/gemini-2.5-pro", "openrouter/deepseek/deepseek-r1"]
+  }
+}

package/config/settings-template.json

@@ -0,0 +1,42 @@
+{
+  "statusLine": {
+    "type": "command",
+    "command": "{{STATUSLINE_PATH}}",
+    "padding": 2
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{HOOKS_DIR}}/user-prompt-submit.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{HOOKS_DIR}}/pre-compact.sh",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{HOOKS_DIR}}/post-tool-use.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/config/standards/communication.md

@@ -0,0 +1,64 @@
+# ArkaOS Communication Standard
+
+Every agent output follows this standard. No exceptions.
+
+## The Rule: Bottom-Line First
+
+Lead with the answer, recommendation, or verdict. Then explain why. Then show how.
+
+```
+❌ "After analyzing the market landscape and considering various factors..."
+✅ "Enter the B2B segment. Here's why and how."
+```
+
+## Output Structure
+
+### 1. Bottom Line (mandatory)
+One sentence: what you recommend, what you found, what the verdict is.
+
+### 2. Why (mandatory)
+2-3 bullet points explaining the reasoning. Data-backed when possible.
+
+### 3. How (when actionable)
+Concrete next steps, numbered. Who does what, by when.
+
+### 4. Confidence Tag (mandatory on assessments)
+
+| Tag | Meaning | When to Use |
+|-----|---------|-------------|
+| HIGH | Strong evidence, high certainty | Data-backed, proven pattern |
+| MEDIUM | Reasonable evidence, some uncertainty | Partial data, informed judgment |
+| LOW | Limited evidence, significant uncertainty | Assumptions, early-stage |
+
+## Anti-Patterns
+
+| Don't | Do Instead |
+|-------|-----------|
+| Walls of text before the point | Lead with the answer |
+| "It depends" without guidance | Pick a recommendation, caveat after |
+| Generic disclaimers | Specific risks with mitigation |
+| Restating the question | Answer immediately |
+| Academic tone | Practitioner voice |
+| Hedge everything | Commit to a position with confidence tag |
+
+## Format Rules
+
+- **Bullet points over paragraphs** for findings and recommendations
+- **Tables over lists** when comparing options
+- **Code blocks** for any technical output
+- **Bold** for key terms, not for emphasis
+- **Numbers** over vague qualifiers ("3 issues" not "several issues")
+- **Active voice** ("Deploy to staging" not "It should be deployed to staging")
+
+## Per-Department Adaptations
+
+| Department | Tone | Example Lead |
+|-----------|------|-------------|
+| Dev | Technical, precise | "Memory leak in UserService:45. Fix: pool connections." |
+| Strategy | Analytical, decisive | "Blue Ocean opportunity. TAM: $2.4B. Entry cost: low." |
+| Finance | Quantitative, direct | "Burn rate: 18 months. Cut infra 30% to extend to 24." |
+| Marketing | Action-oriented | "Email sequence converts 12%. Add urgency to subject lines." |
+| Sales | Confident, outcome-focused | "Deal qualifies. BANT score: 85. Push for close this week." |
+| Brand | Visual, conceptual | "Archetype: Creator. Color: deep blue. Name: Lumino." |
+| Ops | Process-oriented | "SOP gap in onboarding. 3 steps missing. Template attached." |
+| Quality | Binary, authoritative | "REJECTED. 2 critical issues. Fix and resubmit." |

package/config/standards/orchestration.md

@@ -0,0 +1,91 @@
+# ArkaOS Orchestration Protocol
+
+How to coordinate agents across departments for complex, multi-domain work.
+
+## Core Concept
+
+ArkaOS has three layers of execution:
+
+| Layer | What | ArkaOS Equivalent |
+|-------|------|-------------------|
+| **Agent** | Who is thinking (identity, judgment) | 62 agents with behavioral DNA |
+| **Skill** | How to execute (steps, templates) | 250+ department skills |
+| **Workflow** | What phases to follow | 24 YAML workflows |
+
+Orchestration connects them for work that crosses department boundaries.
+
+## Four Patterns
+
+### 1. Solo Sprint
+One department lead drives a multi-phase sprint.
+
+```
+Lead: Ines (Landing)
+Phase 1: /landing copy-framework + /landing funnel-design
+Phase 2: /landing page-build + /landing seo-optimize
+Phase 3: Quality Gate → Ship
+```
+
+**Use when:** Single domain, time-constrained, clear scope.
+
+### 2. Domain Deep-Dive
+One agent, multiple stacked skills for thorough analysis.
+
+```
+Agent: Bruno (Security Engineer)
+Stack: /dev security-audit → /dev dependency-audit → /dev red-team → /dev ai-security
+Output: Consolidated security report
+```
+
+**Use when:** Deep expertise needed, audit/review, compliance assessment.
+
+### 3. Multi-Agent Handoff
+Work flows between departments with structured context passing.
+
+```
+Phase 1: Tomas (Strategy) → BMC + Five Forces → Handoff
+Phase 2: Paulo (Dev) → Spec + Feature → Handoff
+Phase 3: Luna (Marketing) → Growth Plan + Email → Handoff
+Phase 4: Quality Gate → Launch
+```
+
+**Use when:** Cross-department project, sequential expertise needed.
+
+### 4. Skill Chain
+Pure procedural execution, no specific agent identity.
+
+```
+/content hook-write → headline_scorer.py → /content viral-design → /mkt social-strategy
+```
+
+**Use when:** Automated pipeline, well-defined inputs/outputs, no judgment needed.
+
+## Phase Handoff Template
+
+Between phases, pass structured context:
+
+```
+Phase [N] complete.
+Decisions: [list of decisions made]
+Artifacts: [list of files/documents created]
+Open questions: [what the next phase needs to resolve]
+Next: [department]/[agent] + [skills]
+```
+
+## Pattern Selection
+
+| Departments | Needs Judgment? | Sequential? | Pattern |
+|------------|----------------|-------------|---------|
+| 1 | Yes | — | Solo Sprint |
+| 1 | No | — | Skill Chain |
+| 1 | Deep analysis | — | Domain Deep-Dive |
+| 2+ | Yes | Yes | Multi-Agent Handoff |
+| 2+ | No | Yes | Skill Chain |
+
+## Rules
+
+1. **One agent at a time** — don't blend two agents in the same execution
+2. **Skills stack freely** — load as many as the task needs
+3. **Context carries forward** — always pass handoff between phases
+4. **Quality Gate is mandatory** — no pattern skips the final review
+5. **User decides** — orchestration is a recommendation, user can override

package/config/statusline-v2.sh

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS v2 — Status Line for Claude Code
+# Two-line color-coded display showing session context and metrics
+# ============================================================================
+
+input=$(cat)
+
+# ─── Extract fields ──���───────────────────────────────────────────────────
+if ! command -v jq &>/dev/null; then
+  echo "▲ARKAOS v2 | jq not found"
+  exit 0
+fi
+
+eval "$(echo "$input" | jq -r '
+  @sh "model=\(.session.model // "unknown")",
+  @sh "total_in=\(.context_window.total_input_tokens // 0)",
+  @sh "total_out=\(.context_window.total_output_tokens // 0)",
+  @sh "max_ctx=\(.context_window.context_window_size // 200000)",
+  @sh "cost=\(.cost_usd // 0)",
+  @sh "duration=\(.session.duration_seconds // 0)"
+' 2>/dev/null)" 2>/dev/null
+
+# ─── Format tokens (K/M) ────────────────────────────────────────────────
+format_tokens() {
+  local n=$1
+  if [ "$n" -ge 1000000 ] 2>/dev/null; then
+    printf "%.1fM" "$(echo "scale=1; $n/1000000" | bc 2>/dev/null || echo "?")"
+  elif [ "$n" -ge 1000 ] 2>/dev/null; then
+    printf "%.1fK" "$(echo "scale=1; $n/1000" | bc 2>/dev/null || echo "?")"
+  else
+    echo "${n:-0}"
+  fi
+}
+
+# ─── Context percentage ─────────────────────────────────────────────────
+pct=0
+if [ "${max_ctx:-0}" -gt 0 ] 2>/dev/null; then
+  pct=$(( (${total_in:-0} * 100) / ${max_ctx} ))
+fi
+
+# ─── Color based on context usage ────────────────────────────────────────
+if [ "$pct" -ge 90 ]; then
+  color="\033[5;31m"  # Blinking red
+elif [ "$pct" -ge 80 ]; then
+  color="\033[31m"    # Red
+elif [ "$pct" -ge 60 ]; then
+  color="\033[33m"    # Yellow
+else
+  color="\033[32m"    # Green
+fi
+reset="\033[0m"
+
+# ─── Progress bar ───────��────────────────────────────────────────────────
+filled=$(( pct / 10 ))
+empty=$(( 10 - filled ))
+bar=""
+for ((i=0; i<filled; i++)); do bar+="█"; done
+for ((i=0; i<empty; i++)); do bar+="░"; done
+
+# ─── Git info (cached) ──────────────────────────────────────────────────
+branch=""
+if git rev-parse --is-inside-work-tree &>/dev/null; then
+  branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
+  if [ "$branch" = "main" ] || [ "$branch" = "master" ]; then
+    branch=""
+  fi
+fi
+
+# ─── Project name ────────────────────────────────────────────────────────
+project=$(basename "$(pwd)")
+
+# ─── Duration ─────���──────────────────────────────────────────────────────
+dur=""
+if [ "${duration:-0}" -gt 0 ] 2>/dev/null; then
+  mins=$(( duration / 60 ))
+  secs=$(( duration % 60 ))
+  if [ "$mins" -gt 0 ]; then
+    dur="${mins}m${secs}s"
+  else
+    dur="${secs}s"
+  fi
+fi
+
+# ─── Line 1: Context ────────────────────────────────────────────────────
+line1="▲ARKAOS"
+[ -n "$project" ] && line1+="  ${project}"
+[ -n "$branch" ] && line1+="  on ${branch}"
+line1+="  |  ${model:-Opus}"
+
+# ─── Line 2: Metrics ────────────────────────────────────────────────────
+in_fmt=$(format_tokens "${total_in:-0}")
+out_fmt=$(format_tokens "${total_out:-0}")
+
+line2="${bar} ${pct}%  |  ${in_fmt} in ${out_fmt} out"
+[ -n "$dur" ] && line2+="  |  ${dur}"
+[ "${cost:-0}" != "0" ] && line2+="  |  \$${cost}"
+
+# ─── Output ────────────────────────────────────��─────────────────────────
+echo -e "${line1}"
+echo -e "${color}${line2}${reset}"

package/config/statusline.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — Two-Line Color-Coded Status Line for Claude Code
+# Receives JSON via stdin, outputs formatted two-line status bar
+# ============================================================================
+
+input=$(cat)
+
+# ─── Extract fields (single jq call for performance) ──────────────────────
+eval "$(echo "$input" | jq -r '
+  @sh "MODEL=\(.model.display_name // "unknown")",
+  @sh "CWD=\(.cwd // "")",
+  @sh "PROJECT_DIR=\(.workspace.project_dir // "")",
+  @sh "PCT=\(.context_window.used_percentage // 0 | floor)",
+  @sh "INPUT_TOKENS=\(.context_window.total_input_tokens // 0)",
+  @sh "OUTPUT_TOKENS=\(.context_window.total_output_tokens // 0)",
+  @sh "COST=\(.cost.total_cost_usd // 0)",
+  @sh "DURATION_MS=\(.cost.total_duration_ms // 0)",
+  @sh "ADDED=\(.cost.total_lines_added // 0)",
+  @sh "REMOVED=\(.cost.total_lines_removed // 0)"
+' 2>/dev/null)" 2>/dev/null || {
+  # Fallback: individual extractions if single-call fails
+  MODEL=$(echo "$input" | jq -r '.model.display_name // "unknown"' 2>/dev/null)
+  CWD=$(echo "$input" | jq -r '.cwd // ""' 2>/dev/null)
+  PROJECT_DIR=$(echo "$input" | jq -r '.workspace.project_dir // ""' 2>/dev/null)
+  PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' 2>/dev/null | cut -d. -f1)
+  INPUT_TOKENS=$(echo "$input" | jq -r '.context_window.total_input_tokens // 0' 2>/dev/null)
+  OUTPUT_TOKENS=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0' 2>/dev/null)
+  COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0' 2>/dev/null)
+  DURATION_MS=$(echo "$input" | jq -r '.cost.total_duration_ms // 0' 2>/dev/null)
+  ADDED=$(echo "$input" | jq -r '.cost.total_lines_added // 0' 2>/dev/null)
+  REMOVED=$(echo "$input" | jq -r '.cost.total_lines_removed // 0' 2>/dev/null)
+}
+
+# ─── Project name ─────────────────────────────────────────────────────────
+WORK_DIR="${CWD:-$PROJECT_DIR}"
+DIR_NAME=$(basename "${WORK_DIR:-arka}")
+
+# ─── Git info (cached for 5s) ─────────────────────────────────────────────
+GIT_CACHE="/tmp/arka-statusline-git-cache"
+CACHE_MAX_AGE=5
+BRANCH=""
+
+if [ -n "$WORK_DIR" ] && [ -d "$WORK_DIR" ]; then
+  CACHE_KEY=$(echo "$WORK_DIR" | md5 2>/dev/null || echo "$WORK_DIR" | md5sum 2>/dev/null | cut -d' ' -f1)
+  CACHE_FILE="${GIT_CACHE}-${CACHE_KEY}"
+
+  if [ -f "$CACHE_FILE" ] && [ $(($(date +%s) - $(stat -f%m "$CACHE_FILE" 2>/dev/null || stat -c%Y "$CACHE_FILE" 2>/dev/null || echo 0))) -lt $CACHE_MAX_AGE ]; then
+    # Read from cache
+    BRANCH=$(cat "$CACHE_FILE" 2>/dev/null)
+  else
+    # Fresh git query
+    BRANCH=$(git -C "$WORK_DIR" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
+    # Write cache
+    echo "${BRANCH}" > "$CACHE_FILE" 2>/dev/null
+  fi
+fi
+
+# ─── Colors ───────────────────────────────────────────────────────────────
+C_RESET='\033[0m'
+C_CYAN='\033[0;36m'
+C_DIM='\033[2m'
+C_WHITE='\033[1;37m'
+C_GREEN='\033[0;32m'
+C_YELLOW='\033[1;33m'
+C_RED='\033[0;31m'
+C_BLINK_RED='\033[5;31m'
+
+# Context color based on percentage
+PCT=${PCT:-0}
+if [ "$PCT" -ge 90 ]; then
+  C_BAR="$C_BLINK_RED"
+elif [ "$PCT" -ge 80 ]; then
+  C_BAR="$C_RED"
+elif [ "$PCT" -ge 60 ]; then
+  C_BAR="$C_YELLOW"
+else
+  C_BAR="$C_GREEN"
+fi
+
+# ─── Format tokens (K/M) ─────────────────────────────────────────────────
+format_tokens() {
+  local n="${1:-0}"
+  if [ "$n" -ge 1000000 ]; then
+    printf "%.1fM" "$(echo "scale=1; $n / 1000000" | bc 2>/dev/null || echo "0")"
+  elif [ "$n" -ge 1000 ]; then
+    printf "%.1fK" "$(echo "scale=1; $n / 1000" | bc 2>/dev/null || echo "0")"
+  else
+    echo "${n}"
+  fi
+}
+
+IN_FMT=$(format_tokens "$INPUT_TOKENS")
+OUT_FMT=$(format_tokens "$OUTPUT_TOKENS")
+
+# ─── Progress bar (10 chars) ──────────────────────────────────────────────
+FILLED=$((PCT / 10))
+EMPTY=$((10 - FILLED))
+BAR=""
+for ((i=0; i<FILLED; i++)); do BAR+="█"; done
+for ((i=0; i<EMPTY; i++)); do BAR+="░"; done
+
+# ─── Format duration ──────────────────────────────────────────────────────
+SECS=$((${DURATION_MS:-0} / 1000))
+if [ "$SECS" -ge 3600 ]; then
+  HOURS=$((SECS / 3600))
+  MINS=$(((SECS % 3600) / 60))
+  TIME_FMT="${HOURS}h${MINS}m"
+elif [ "$SECS" -ge 60 ]; then
+  MINS=$((SECS / 60))
+  REM_SECS=$((SECS % 60))
+  TIME_FMT="${MINS}m${REM_SECS}s"
+else
+  TIME_FMT="${SECS}s"
+fi
+
+# ─── Format cost ──────────────────────────────────────────────────────────
+COST_FMT=$(printf '$%.2f' "${COST:-0}")
+
+# ─── Build Line 1: Context bar ───────────────────────────────────────────
+LINE1="${C_CYAN}▲ARKA${C_RESET}  ${C_WHITE}${DIR_NAME}${C_RESET}"
+
+# Git branch (hidden on main/master to reduce noise)
+if [ -n "$BRANCH" ] && [ "$BRANCH" != "main" ] && [ "$BRANCH" != "master" ]; then
+  LINE1+="  ${C_DIM}on${C_RESET} ${C_GREEN}${BRANCH}${C_RESET}"
+fi
+
+LINE1+="  ${C_DIM}|${C_RESET}  ${MODEL}"
+
+# ─── Build Line 2: Metrics bar ───────────────────────────────────────────
+LINE2="${C_BAR}${BAR} ${PCT}%${C_RESET}"
+LINE2+="  ${C_DIM}|${C_RESET}  ${IN_FMT} in ${OUT_FMT} out"
+LINE2+="  ${C_DIM}|${C_RESET}  ${C_GREEN}+${ADDED}${C_RESET} ${C_RED}-${REMOVED}${C_RESET}"
+LINE2+="  ${C_DIM}|${C_RESET}  ${TIME_FMT}"
+LINE2+="  ${C_DIM}|${C_RESET}  ${COST_FMT}"
+
+# ─── Output ───────────────────────────────────────────────────────────────
+echo -e "$LINE1"
+echo -e "$LINE2"