arkaos 4.3.1 → 4.3.3

package/README.md

@@ -491,7 +491,7 @@ npx arkaos uninstall           # Remove ArkaOS
 **Release pipeline (operator-side, headless):**
 
 ```
-python -m core.release.preflight_cli --expected-npm-user <user>
+~/.arkaos/bin/arka-py -m core.release.preflight_cli --expected-npm-user <user>
 # Step 0 NON-NEGOTIABLE before any tag/push/publish (v2.43.0+).
 # Six checks: version-alignment / npm-auth / npm-publish-capability /
 # gh-auth / git-remote / git-clean. Plus no-client-name-leaks

package/VERSION

@@ -1 +1 @@
-4.3.1
+4.3.3

package/arka/SKILL.md

@@ -180,10 +180,10 @@ violation (squad-routing, arka-supremacy, spec-driven, mandatory-qa).
 | Command | Description |
 |---------|-------------|
 | `/arka status` | System status (version, departments, agents, active projects). Includes **LLM costs (24h)** section: top-line cost + cache hit rate + call count from `core.runtime.llm_cost_telemetry.summarise(period="today")`. Also includes **Enforcement (24h)** section: total calls, block rate, top blocked tools/reasons from `core.governance.enforcement_telemetry.summarise(period="today")` (PR19 v2.41.0). Plus **Reorganization (today)** section: today's proposal path + artifact count from `core.cognition.reorganizer_scheduler.status_summary()` (PR24 v2.46.0). |
-| `/arka costs [period]` | LLM cost visibility — aggregates telemetry by day/week/month/all, with top expensive sessions. See `arka/skills/costs/SKILL.md`. Shells out to `python -m core.runtime.llm_cost_telemetry_cli <period>`. |
-| `/arka enforcement [period]` | Enforcement compliance — aggregates flow-marker enforcement telemetry by day/week/month/all. Shows block rate, top blocked tools, top reasons. Shells out to `python -m core.governance.enforcement_telemetry_cli <period>`. |
-| `/arka compliance [period]` | Behavior compliance summary (PR29 v2.48.0) — aggregates stop-hook telemetry by day/week/month/all. Shows rates for the four contracts: closing marker, `[arka:meta]` tag, KB citation pass, sycophancy clean. Shells out to `python -m core.governance.compliance_telemetry_cli <period>`. |
-| `/arka reorganize [--since-days N]` | Dreaming → Agent reorganizer. Aggregates recent KB pattern/anti-pattern/lesson artifacts (default last 7 days) into a markdown proposal at `~/.arkaos/reorganize-proposals/<date>.md`. **Propose-only** — never modifies agent YAMLs. Sanitizes client identifiers from titles and body excerpts; drops `tags:` field entirely to prevent project-name leaks. **Auto-fires on session start when today's proposal is missing** (PR24 v2.46.0 stale-aware trigger, 30s timeout, background). Shells out to `python -m core.cognition.reorganizer_cli [--since-days N] [--dry-run]`. |
+| `/arka costs [period]` | LLM cost visibility — aggregates telemetry by day/week/month/all, with top expensive sessions. See `arka/skills/costs/SKILL.md`. Shells out to `~/.arkaos/bin/arka-py -m core.runtime.llm_cost_telemetry_cli <period>`. |
+| `/arka enforcement [period]` | Enforcement compliance — aggregates flow-marker enforcement telemetry by day/week/month/all. Shows block rate, top blocked tools, top reasons. Shells out to `~/.arkaos/bin/arka-py -m core.governance.enforcement_telemetry_cli <period>`. |
+| `/arka compliance [period]` | Behavior compliance summary (PR29 v2.48.0) — aggregates stop-hook telemetry by day/week/month/all. Shows rates for the four contracts: closing marker, `[arka:meta]` tag, KB citation pass, sycophancy clean. Shells out to `~/.arkaos/bin/arka-py -m core.governance.compliance_telemetry_cli <period>`. |
+| `/arka reorganize [--since-days N]` | Dreaming → Agent reorganizer. Aggregates recent KB pattern/anti-pattern/lesson artifacts (default last 7 days) into a markdown proposal at `~/.arkaos/reorganize-proposals/<date>.md`. **Propose-only** — never modifies agent YAMLs. Sanitizes client identifiers from titles and body excerpts; drops `tags:` field entirely to prevent project-name leaks. **Auto-fires on session start when today's proposal is missing** (PR24 v2.46.0 stale-aware trigger, 30s timeout, background). Shells out to `~/.arkaos/bin/arka-py -m core.cognition.reorganizer_cli [--since-days N] [--dry-run]`. |
 | `/arka standup` | Daily standup (projects, priorities, blockers, updates) |
 | `/arka monitor` | System health monitoring |
 | `/arka onboard <path>` | Onboard an existing project into ArkaOS |

package/arka/skills/costs/SKILL.md

@@ -42,7 +42,7 @@ surfaces usage and emits soft advisories. It never blocks a call.
 This skill shells out to the Python CLI:
 
 ```bash
-python -m core.runtime.llm_cost_telemetry_cli <period>
+~/.arkaos/bin/arka-py -m core.runtime.llm_cost_telemetry_cli <period>
 ```
 
 Source:

package/arka/skills/fusion/SKILL.md

@@ -24,9 +24,9 @@ mechanical work economises.
 Run and read all three:
 
 ```bash
-python -m core.runtime.model_router_cli discover        # Ollama + local models
-python -m core.runtime.model_router_cli --json          # current routing
-python -m core.runtime.model_router_cli usage --period week --json
+~/.arkaos/bin/arka-py -m core.runtime.model_router_cli discover        # Ollama + local models
+~/.arkaos/bin/arka-py -m core.runtime.model_router_cli --json          # current routing
+~/.arkaos/bin/arka-py -m core.runtime.model_router_cli usage --period week --json
 ```
 
 Also check key presence (never print values): `OPENROUTER_API_KEY` /

package/bin/arka

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ARKA OS — CLI Wrapper
+# Usage: arka [command] [args...]
+# ============================================================================
+set -e
+
+command -v claude &>/dev/null || { echo "Error: Claude Code CLI not found."; exit 1; }
+
+ARKA_OS="${ARKA_OS:-$HOME/.claude/skills/arka}"
+[ -d "$ARKA_OS" ] || { echo "Error: ARKA OS not installed. Run: bash install.sh"; exit 1; }
+
+# Run version check (silent on errors)
+bash "$ARKA_OS/version-check.sh" 2>/dev/null || true
+
+# Generate dynamic system prompt from user profile
+SYSTEM_PROMPT=$(bash "$ARKA_OS/system-prompt.sh" 2>/dev/null || echo "")
+
+# ─── ARKA OS Banner ─────────────────────────────────────────────────────────
+show_banner() {
+    local C='\033[0;36m'   # cyan
+    local G='\033[0;32m'   # green
+    local Y='\033[1;33m'   # yellow
+    local N='\033[0m'      # reset
+    local VERSION
+    VERSION=$(cat "$ARKA_OS/VERSION" 2>/dev/null || echo "?")
+
+    # Read user name from profile
+    local USER_NAME=""
+    if [ -f "$HOME/.arka-os/profile.json" ] && command -v jq &>/dev/null; then
+        USER_NAME=$(jq -r '.user_name // ""' "$HOME/.arka-os/profile.json" 2>/dev/null)
+    fi
+
+    echo ""
+    echo -e "${C}    ╔══════════════════════════════════════════════════════════╗${N}"
+    echo -e "${C}    ║${N}                                                          ${C}║${N}"
+    echo -e "${C}    ║${N}   ${G} █████╗ ██████╗ ██╗  ██╗ █████╗  ██████╗ ███████╗${N}   ${C}║${N}"
+    echo -e "${C}    ║${N}   ${G}██╔══██╗██╔══██╗██║ ██╔╝██╔══██╗██╔═══██╗██╔════╝${N}   ${C}║${N}"
+    echo -e "${C}    ║${N}   ${G}███████║██████╔╝█████╔╝ ███████║██║   ██║███████╗${N}   ${C}║${N}"
+    echo -e "${C}    ║${N}   ${G}██╔══██║██╔══██╗██╔═██╗ ██╔══██║██║   ██║╚════██║${N}   ${C}║${N}"
+    echo -e "${C}    ║${N}   ${G}██║  ██║██║  ██║██║  ██╗██║  ██║╚██████╔╝███████║${N}   ${C}║${N}"
+    echo -e "${C}    ║${N}   ${G}╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝${N}   ${C}║${N}"
+    echo -e "${C}    ║${N}                                                          ${C}║${N}"
+    echo -e "${C}    ║${N}   ${Y}WizardingCode Company OS${N}  v${VERSION}                     ${C}║${N}"
+    if [ -n "$USER_NAME" ]; then
+    echo -e "${C}    ║${N}   Welcome back, ${G}${USER_NAME}${N}!                                ${C}║${N}"
+    fi
+    echo -e "${C}    ║${N}                                                          ${C}║${N}"
+    echo -e "${C}    ╚══════════════════════════════════════════════════════════╝${N}"
+    echo ""
+}
+
+case "${1:-}" in
+  skill)
+    shift
+    bash "$HOME/.local/bin/arka-skill" "$@"
+    exit $?
+    ;;
+  update)
+    cd "$(cat "$ARKA_OS/.repo-path")" && git pull && bash install.sh
+    exit $?
+    ;;
+  --version|-v)
+    cat "$ARKA_OS/VERSION"
+    exit 0
+    ;;
+  doctor)
+    shift
+    bash "$HOME/.local/bin/arka-doctor" "$@"
+    exit $?
+    ;;
+  gotchas)
+    shift
+    GOTCHAS_FILE="$HOME/.arka-os/gotchas.json"
+    case "${1:-}" in
+      clear)
+        echo '[]' > "$GOTCHAS_FILE"
+        echo "Gotchas cleared."
+        ;;
+      --json)
+        if [ -f "$GOTCHAS_FILE" ]; then
+          cat "$GOTCHAS_FILE"
+        else
+          echo '[]'
+        fi
+        ;;
+      *)
+        if [ ! -f "$GOTCHAS_FILE" ] || [ "$(jq 'length' "$GOTCHAS_FILE" 2>/dev/null)" = "0" ]; then
+          echo "No gotchas recorded yet."
+          exit 0
+        fi
+        echo ""
+        echo -e "\033[0;36m╔══════════════════════════════════════════════════╗\033[0m"
+        echo -e "\033[0;36m║\033[0m  \033[1mARKA OS Gotchas\033[0m — Recurring Error Patterns      \033[0;36m║\033[0m"
+        echo -e "\033[0;36m╚══════════════════════════════════════════════════╝\033[0m"
+        echo ""
+        jq -r '.[:10] | to_entries[] | "  \(.key + 1). [\(.value.category)] (×\(.value.count)) \(.value.pattern)\n     First: \(.value.first_seen) | Last: \(.value.last_seen)\n     Projects: \(.value.projects | join(", "))\n"' "$GOTCHAS_FILE" 2>/dev/null
+        TOTAL=$(jq 'length' "$GOTCHAS_FILE" 2>/dev/null || echo "0")
+        echo "  Total: $TOTAL gotcha(s) tracked"
+        echo ""
+        ;;
+    esac
+    exit 0
+    ;;
+  metrics)
+    METRICS_FILE="$HOME/.arka-os/hook-metrics.json"
+    if [ ! -f "$METRICS_FILE" ] || [ "$(jq 'length' "$METRICS_FILE" 2>/dev/null)" = "0" ]; then
+      echo "No hook metrics recorded yet."
+      exit 0
+    fi
+    echo ""
+    echo -e "\033[0;36m╔══════════════════════════════════════════════════╗\033[0m"
+    echo -e "\033[0;36m║\033[0m  \033[1mARKA OS Hook Metrics\033[0m — Last 24h               \033[0;36m║\033[0m"
+    echo -e "\033[0;36m╚══════════════════════════════════════════════════╝\033[0m"
+    echo ""
+    CUTOFF=$(date -u -v-24H +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '24 hours ago' +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || echo "1970-01-01T00:00:00Z")
+    jq -r --arg cutoff "$CUTOFF" '
+      [.[] | select(.timestamp >= $cutoff)] | group_by(.hook) | .[] |
+      {
+        hook: .[0].hook,
+        count: length,
+        avg: ([.[].duration_ms] | add / length | floor),
+        p95: ([.[].duration_ms] | sort | .[length * 95 / 100 | floor] // 0),
+        max: ([.[].duration_ms] | max)
+      } |
+      "  \(.hook)\n    Count: \(.count)  Avg: \(.avg)ms  P95: \(.p95)ms  Max: \(.max)ms"
+    ' "$METRICS_FILE" 2>/dev/null
+    echo ""
+    TOTAL=$(jq 'length' "$METRICS_FILE" 2>/dev/null || echo "0")
+    echo "  Total entries: $TOTAL (keeps last 500)"
+    echo ""
+    exit 0
+    ;;
+  commands|registry)
+    shift
+    REPO_DIR="$(cat "$ARKA_OS/.repo-path" 2>/dev/null)"
+    REGISTRY="$REPO_DIR/knowledge/commands-registry.json"
+    case "${1:-}" in
+      rebuild)
+        bash "$REPO_DIR/bin/arka-registry-gen"
+        echo "Registry rebuilt: $(jq '._meta.total_commands' "$REGISTRY") commands."
+        ;;
+      --json)
+        [ -f "$REGISTRY" ] && cat "$REGISTRY" || echo '{"commands":[]}'
+        ;;
+      *)
+        if [ ! -f "$REGISTRY" ]; then
+          echo "Registry not found. Run: arka commands rebuild"
+          exit 1
+        fi
+        echo ""
+        echo -e "\033[0;36m═══ ARKA OS — Available Commands ═══\033[0m"
+        echo ""
+        jq -r '.commands | group_by(.department) | .[] |
+          "  \u001b[1;33m\(.[0].department | ascii_upcase)\u001b[0m\n" +
+          ([.[] | "    \(.command)\t\(.description)"] | join("\n")) + "\n"
+        ' "$REGISTRY" 2>/dev/null
+        TOTAL=$(jq '._meta.total_commands' "$REGISTRY" 2>/dev/null || echo "?")
+        echo -e "  Total: $TOTAL commands"
+        echo -e "  Tip: Just describe what you need — no need to memorize commands!"
+        echo ""
+        ;;
+    esac
+    exit 0
+    ;;
+  providers)
+    shift
+    REPO_DIR="$(cat "$ARKA_OS/.repo-path" 2>/dev/null)"
+    bash "$REPO_DIR/bin/arka-providers" "$@"
+    exit $?
+    ;;
+  team-balance)
+    REPO_DIR="$(cat "$ARKA_OS/.repo-path" 2>/dev/null)"
+    bash "$REPO_DIR/config/disc-team-validator.sh"
+    exit $?
+    ;;
+  test)
+    shift
+    if command -v bats &>/dev/null; then
+      REPO_DIR="$(cat "$ARKA_OS/.repo-path" 2>/dev/null)"
+      bats "$REPO_DIR/tests/" "$@"
+    else
+      echo "Error: bats-core not installed. Install: brew install bats-core"
+      exit 1
+    fi
+    exit $?
+    ;;
+  kb)
+    shift
+    SCRIPTS_DIR="$HOME/.claude/skills/arka-knowledge/scripts"
+    # Fallback to repo scripts location
+    if [ ! -d "$SCRIPTS_DIR" ]; then
+        REPO_DIR="$(cat "$ARKA_OS/.repo-path" 2>/dev/null)"
+        SCRIPTS_DIR="$REPO_DIR/departments/kb/scripts"
+    fi
+    case "${1:-}" in
+      queue)        bash "$SCRIPTS_DIR/kb-status.sh" "${@:2}" ;;
+      status)       bash "$SCRIPTS_DIR/kb-status.sh" "${@:2}" ;;
+      capabilities) bash "$SCRIPTS_DIR/kb-check-capabilities.sh" ;;
+      cleanup)      bash "$SCRIPTS_DIR/kb-cleanup.sh" "${@:2}" ;;
+      *)            claude "/kb $*" ;;
+    esac
+    exit $?
+    ;;
+  *)
+    # Show branded banner for interactive sessions (no arguments)
+    if [ $# -eq 0 ]; then
+        show_banner
+    fi
+
+    if [ -n "$SYSTEM_PROMPT" ]; then
+      if [ $# -gt 0 ]; then
+        claude --append-system-prompt "$SYSTEM_PROMPT" "$*"
+      else
+        claude --append-system-prompt "$SYSTEM_PROMPT"
+      fi
+    else
+      if [ $# -gt 0 ]; then
+        claude "$*"
+      else
+        claude
+      fi
+    fi
+    ;;
+esac

package/bin/arka-claude

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# ============================================================================
+# ArkaOS — Claude Code Wrapper
+# Displays branded greeting BEFORE Claude starts (deterministic, no LLM)
+# Usage: arka-claude [any claude args...]
+# ============================================================================
+
+# ─── Colors ────────────────────────────────────────────────────────────
+GREEN='\033[0;32m'
+WHITE='\033[1;37m'
+DIM='\033[2m'
+CYAN='\033[0;36m'
+YELLOW='\033[1;33m'
+RESET='\033[0m'
+
+# ─── Profile ───────────────────────────────────────────────────────────
+NAME="founder"
+COMPANY="WizardingCode"
+VERSION="2.x"
+
+if [ -f "$HOME/.arkaos/profile.json" ] && command -v python3 &>/dev/null; then
+  NAME=$(python3 -c "import json; p=json.load(open('$HOME/.arkaos/profile.json')); print(p.get('name', p.get('role', 'founder')))" 2>/dev/null || echo "founder")
+  COMPANY=$(python3 -c "import json; print(json.load(open('$HOME/.arkaos/profile.json')).get('company', 'WizardingCode'))" 2>/dev/null || echo "WizardingCode")
+fi
+
+if [ -f "$HOME/.arkaos/.repo-path" ]; then
+  REPO=$(cat "$HOME/.arkaos/.repo-path")
+  [ -f "$REPO/VERSION" ] && VERSION=$(cat "$REPO/VERSION" | tr -d '[:space:]')
+fi
+
+# ─── Time greeting ─────────────────────────────────────────────────────
+HOUR=$(date +%H)
+if [ "$HOUR" -ge 5 ] && [ "$HOUR" -lt 12 ]; then GREETING="Bom dia"
+elif [ "$HOUR" -ge 12 ] && [ "$HOUR" -lt 19 ]; then GREETING="Boa tarde"
+else GREETING="Boa noite"; fi
+
+# ─── Version drift ─────────────────────────────────────────────────────
+DRIFT_MSG=""
+SYNC_STATE="$HOME/.arkaos/sync-state.json"
+if [ -f "$SYNC_STATE" ]; then
+  SYNCED=$(python3 -c "import json; print(json.load(open('$SYNC_STATE'))['version'])" 2>/dev/null || echo "none")
+  if [ "$SYNCED" != "$VERSION" ]; then
+    DRIFT_MSG="\n  ${YELLOW}⚠  Update available: run /arka update to sync${RESET}"
+  fi
+fi
+
+# ─── Display ───────────────────────────────────────────────────────────
+echo ""
+echo -e "  ${GREEN}╔══════════════════════════════════════════════╗${RESET}"
+echo -e "  ${GREEN}║${RESET}                                              ${GREEN}║${RESET}"
+echo -e "  ${GREEN}║${RESET}              ${WHITE}A R K A   O S${RESET}                   ${GREEN}║${RESET}"
+echo -e "  ${GREEN}║${RESET}                                              ${GREEN}║${RESET}"
+echo -e "  ${GREEN}║${RESET}   ${DIM}The Operating System for AI Teams${RESET}          ${GREEN}║${RESET}"
+echo -e "  ${GREEN}║${RESET}                  ${DIM}by WizardingCode${RESET}            ${GREEN}║${RESET}"
+echo -e "  ${GREEN}║${RESET}                                              ${GREEN}║${RESET}"
+echo -e "  ${GREEN}╚══════════════════════════════════════════════╝${RESET}"
+echo ""
+echo -e "  ${CYAN}${GREETING}, ${NAME}${RESET} ${DIM}(${COMPANY})${RESET}"
+echo -e "  ${DIM}ArkaOS v${VERSION} │ 65 agents │ 17 departments │ 244+ skills${RESET}"
+echo -e "${DRIFT_MSG}"
+echo ""
+
+# ─── Launch Claude ─────────────────────────────────────────────────────
+exec claude "$@"

package/bin/arka-claude.cmd

@@ -0,0 +1,11 @@
+@echo off
+REM ==========================================================================
+REM ArkaOS - Claude Code Wrapper (cmd shim)
+REM
+REM Dispatches to bin\arka-claude.ps1, forwarding all arguments. Using a
+REM .cmd shim means `arka-claude ...` works from cmd.exe, PowerShell, and
+REM Windows Terminal alike, without the caller having to remember the
+REM `powershell -File ...` invocation.
+REM ==========================================================================
+powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "%~dp0arka-claude.ps1" %*
+exit /b %ERRORLEVEL%

package/bin/arka-claude.ps1

@@ -0,0 +1,126 @@
+# ============================================================================
+# ArkaOS - Claude Code Wrapper (Windows / PowerShell 5.1+)
+#
+# Port of bin/arka-claude. Displays the branded greeting deterministically
+# (no LLM involved) and then hands control to `claude` with any forwarded
+# arguments.
+#
+# Usage: arka-claude [any claude args...]
+#
+# This script is normally invoked through its .cmd shim (bin/arka-claude.cmd)
+# so it works from cmd.exe, PowerShell, and Windows Terminal without the
+# caller having to remember the `powershell -File ...` invocation.
+#
+# Pure ASCII on purpose: PS 5.1 reads source files as ANSI by default.
+# Box-drawing characters are built at runtime from [char] codes.
+# ============================================================================
+
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+
+$arkaosHome = Join-Path $env:USERPROFILE '.arkaos'
+
+# --- Profile ---------------------------------------------------------------
+$name    = 'founder'
+$company = 'WizardingCode'
+$version = '2.x'
+
+$profilePath = Join-Path $arkaosHome 'profile.json'
+if (Test-Path -LiteralPath $profilePath) {
+    try {
+        $arkaosProfile = Get-Content -Raw -LiteralPath $profilePath -Encoding UTF8 | ConvertFrom-Json
+        if ($arkaosProfile.name)     { $name    = [string]$arkaosProfile.name }
+        elseif ($arkaosProfile.role) { $name    = [string]$arkaosProfile.role }
+        if ($arkaosProfile.company)  { $company = [string]$arkaosProfile.company }
+    } catch { }
+}
+
+$repoPathFile = Join-Path $arkaosHome '.repo-path'
+if (Test-Path -LiteralPath $repoPathFile) {
+    try {
+        $repo = (Get-Content -Raw -LiteralPath $repoPathFile -Encoding UTF8).Trim()
+        if ($repo) {
+            $versionFile = Join-Path $repo 'VERSION'
+            if (Test-Path -LiteralPath $versionFile) {
+                $version = (Get-Content -Raw -LiteralPath $versionFile -Encoding UTF8).Trim()
+            }
+        }
+    } catch { }
+}
+
+# --- Time greeting ---------------------------------------------------------
+$hour = [int](Get-Date -Format 'HH')
+if     ($hour -ge 5  -and $hour -lt 12) { $greeting = 'Bom dia' }
+elseif ($hour -ge 12 -and $hour -lt 19) { $greeting = 'Boa tarde' }
+else                                     { $greeting = 'Boa noite' }
+
+# --- Version drift ---------------------------------------------------------
+$driftMsg = ''
+$syncStatePath = Join-Path $arkaosHome 'sync-state.json'
+if (Test-Path -LiteralPath $syncStatePath) {
+    try {
+        $ss = Get-Content -Raw -LiteralPath $syncStatePath -Encoding UTF8 | ConvertFrom-Json
+        $synced = if ($null -ne $ss.version) { [string]$ss.version } else { 'none' }
+        if ($synced -ne $version) {
+            $driftMsg = 'Update available: run /arka update to sync'
+        }
+    } catch { }
+}
+
+# --- Build ASCII header ----------------------------------------------------
+# Box drawing chars as runtime literals (not embedded in source).
+$tl = [char]0x2554; $tr = [char]0x2557
+$bl = [char]0x255A; $br = [char]0x255D
+$h  = [char]0x2550; $v  = [char]0x2551
+$sep = [char]0x2502  # light vertical bar used in the stat line
+$innerWidth = 46
+$barLine = ([string]$h * $innerWidth)
+$emptyBox = "$v" + (' ' * $innerWidth) + "$v"
+
+function Pad-Centered([string]$text, [int]$width) {
+    $padLeft  = [int](($width - $text.Length) / 2)
+    $padRight = $width - $text.Length - $padLeft
+    return (' ' * $padLeft) + $text + (' ' * $padRight)
+}
+
+# --- Display ---------------------------------------------------------------
+Write-Host ''
+Write-Host ("  $tl$barLine$tr")                                 -ForegroundColor Green
+Write-Host ("  $v" + (' ' * $innerWidth) + "$v")                -ForegroundColor Green
+Write-Host ("  $v")                                             -NoNewline -ForegroundColor Green
+Write-Host (Pad-Centered 'A R K A   O S' $innerWidth)          -NoNewline -ForegroundColor White
+Write-Host ("$v")                                               -ForegroundColor Green
+Write-Host ("  $v" + (' ' * $innerWidth) + "$v")                -ForegroundColor Green
+Write-Host ("  $v")                                             -NoNewline -ForegroundColor Green
+Write-Host (Pad-Centered 'The Operating System for AI Teams' $innerWidth) -NoNewline -ForegroundColor DarkGray
+Write-Host ("$v")                                               -ForegroundColor Green
+Write-Host ("  $v")                                             -NoNewline -ForegroundColor Green
+Write-Host (Pad-Centered 'by WizardingCode' $innerWidth)        -NoNewline -ForegroundColor DarkGray
+Write-Host ("$v")                                               -ForegroundColor Green
+Write-Host ("  $v" + (' ' * $innerWidth) + "$v")                -ForegroundColor Green
+Write-Host ("  $bl$barLine$br")                                 -ForegroundColor Green
+Write-Host ''
+
+Write-Host "  $greeting, $name " -NoNewline -ForegroundColor Cyan
+Write-Host "($company)"           -ForegroundColor DarkGray
+Write-Host ("  ArkaOS v$version $sep 65 agents $sep 17 departments $sep 244+ skills") -ForegroundColor DarkGray
+if ($driftMsg) {
+    Write-Host ''
+    Write-Host "  ! $driftMsg" -ForegroundColor Yellow
+}
+Write-Host ''
+
+# --- Launch Claude ---------------------------------------------------------
+# The bash wrapper uses `exec claude "$@"` which replaces the shell.
+# PowerShell has no exec equivalent; `& claude @args` spawns a child and
+# blocks until it exits. The net effect for the user is the same.
+$claude = Get-Command claude -ErrorAction SilentlyContinue
+if (-not $claude) {
+    Write-Host ''
+    Write-Host '  Error: `claude` not found on PATH.' -ForegroundColor Red
+    Write-Host '  Install Claude Code for Windows and re-run arka-claude.' -ForegroundColor DarkGray
+    exit 127
+}
+
+& claude @args
+exit $LASTEXITCODE