arkaos 2.10.0 → 2.11.0

package/config/hooks/session-start.ps1

@@ -0,0 +1,109 @@
+# ============================================================================
+# ArkaOS — SessionStart Hook (Windows / PowerShell 5.1+)
+#
+# Port of config/hooks/session-start.sh. Must remain behaviourally identical:
+# - Same profile lookup, time-based greeting, version-drift detection.
+# - Same JSON output contract: {"systemMessage": "<...>"} on stdout.
+#
+# Minimum PowerShell: 5.1 (shipped with every Windows 10+). No pwsh 7 prereq.
+# Box-drawing characters are built from [char] codes so this file stays pure
+# ASCII and avoids source-encoding pitfalls with PS 5.1 default ANSI reads.
+# ============================================================================
+
+$ErrorActionPreference = 'Stop'
+# Force UTF-8 on stdout so ConvertTo-Json does not emit mojibake box chars.
+[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 {
+        # $profile is an automatic variable in PowerShell — use $arkaosProfile.
+        $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 {
+        # Corrupt profile — keep defaults and continue.
+    }
+}
+
+$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 ─────────────────────────────────────────────────────
+$drift = ''
+$syncStatePath = Join-Path $arkaosHome 'sync-state.json'
+if (Test-Path -LiteralPath $syncStatePath) {
+    try {
+        $syncState = Get-Content -Raw -LiteralPath $syncStatePath -Encoding UTF8 | ConvertFrom-Json
+        $synced = if ($null -ne $syncState.version) { [string]$syncState.version } else { 'none' }
+        if ($synced -ne $version) {
+            $drift = "`n[arka:update-available] Core v$version != synced v$synced. Run /arka update."
+        }
+    } catch {
+        $drift = "`n[arka:update-available] Sync state unreadable. Run /arka update."
+    }
+} else {
+    $drift = "`n[arka:update-available] Never synced. Run /arka update."
+}
+
+# ─── Build ASCII header from char codes ───────────────────────────────
+$tl  = [char]0x2554  # ╔
+$tr  = [char]0x2557  # ╗
+$bl  = [char]0x255A  # ╚
+$br  = [char]0x255D  # ╝
+$h   = [char]0x2550  # ═
+$v   = [char]0x2551  # ║
+$bar = [string]($h.ToString() * 46)
+
+$topLine    = "$tl$bar$tr"
+$bottomLine = "$bl$bar$br"
+$empty      = "$v" + (' ' * 46) + "$v"
+function Pad-Line([string]$text) {
+    $innerWidth = 46
+    $padLeft  = [int](($innerWidth - $text.Length) / 2)
+    $padRight = $innerWidth - $text.Length - $padLeft
+    return "$v" + (' ' * $padLeft) + $text + (' ' * $padRight) + "$v"
+}
+
+$lines = @(
+    $topLine
+    $empty
+    (Pad-Line 'A R K A   O S')
+    $empty
+    (Pad-Line 'The Operating System for AI Teams')
+    (Pad-Line 'by WizardingCode')
+    $empty
+    $bottomLine
+    ''
+    "$greeting, $name ($company)"
+    "ArkaOS v$version | 65 agents | 17 departments | 244+ skills$drift"
+)
+
+$msg = "`n" + ($lines -join "`n")
+
+# ─── Output as systemMessage JSON (single line, same contract as .sh) ──
+[pscustomobject]@{ systemMessage = $msg } | ConvertTo-Json -Compress

package/config/hooks/session-start.sh

@@ -39,7 +39,7 @@ else
 fi
 
 # ─── Build message ─────────────────────────────────────────────────────
-MSG="╔══════════════════════════════════════════════╗\\n"
+MSG="\\n╔══════════════════════════════════════════════╗\\n"
 MSG+="║                                              ║\\n"
 MSG+="║              A R K A   O S                   ║\\n"
 MSG+="║                                              ║\\n"

package/config/hooks/user-prompt-submit.ps1

@@ -0,0 +1,287 @@
+# ============================================================================
+# ArkaOS v2 - UserPromptSubmit Hook (Synapse Bridge) (Windows / PowerShell 5.1+)
+#
+# Port of config/hooks/user-prompt-submit.sh. Calls the Python Synapse bridge
+# for 8-layer context injection, with a pure-PowerShell fallback for
+# installations where Python is unavailable or the bridge is missing.
+#
+# Contract:
+# - Reads a JSON payload from stdin (userInput / message / raw).
+# - Emits a single-line JSON object on stdout:
+#       {"additionalContext": "<sync-notice><synapse-or-fallback>"}
+# - Side effect: writes one line to the cache metrics JSONL.
+#
+# Target latency: <100ms (hook timeout is 10s in settings).
+#
+# File is pure ASCII. Any typographic characters that need to appear in the
+# output are built from [char] codes at runtime so PS 5.1's default ANSI
+# source read cannot mojibake them.
+# ============================================================================
+
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+
+# --- Read stdin ------------------------------------------------------------
+$stdinText = [Console]::In.ReadToEnd()
+$payload = $null
+if (-not [string]::IsNullOrWhiteSpace($stdinText)) {
+    try { $payload = $stdinText | ConvertFrom-Json } catch { $payload = $null }
+}
+
+# --- V1 migration detection ------------------------------------------------
+# The old logic fired whenever any v1 skill directory existed on disk and
+# the migrated-from-v1 marker was absent. That is too noisy on a Windows
+# install that has v2 running correctly alongside leftover v1 skill dirs
+# (common when a user installed via `npx arkaos install` after having
+# previously used v1): the hook early-returned with the MIGRATION message
+# on every single user prompt, drowning out the Synapse context.
+#
+# The presence of a valid v2 install manifest at `~/.arkaos/install-
+# manifest.json` is the canonical signal that v2 is functional. If we
+# see that file, skip the migration nag — the user has clearly already
+# moved to v2, even if the explicit `migrated-from-v1` flag file was
+# never created.
+$v2Manifest = Join-Path $env:USERPROFILE '.arkaos\install-manifest.json'
+$v2Installed = Test-Path -LiteralPath $v2Manifest
+
+if (-not $v2Installed) {
+    $v1Paths = @(
+        (Join-Path $env:USERPROFILE '.claude\skills\arka-os'),
+        (Join-Path $env:USERPROFILE '.claude\skills\arkaos')
+    )
+    $migrationMarker = Join-Path $env:USERPROFILE '.arkaos\migrated-from-v1'
+
+    foreach ($v1 in $v1Paths) {
+        if ((Test-Path -LiteralPath $v1 -PathType Container) -and -not (Test-Path -LiteralPath $migrationMarker)) {
+            $msg = "[MIGRATION] ArkaOS v1 detected at $v1. Run: npx arkaos migrate - This will backup v1, preserve your data, and install v2. See: https://github.com/andreagroferreira/arka-os#install"
+            [pscustomobject]@{ additionalContext = $msg } | ConvertTo-Json -Compress
+            exit 0
+        }
+    }
+}
+
+# --- Performance timing ----------------------------------------------------
+$sw = [System.Diagnostics.Stopwatch]::StartNew()
+
+# --- Sync version detection ------------------------------------------------
+$syncNotice = ''
+$arkaosHome    = Join-Path $env:USERPROFILE '.arkaos'
+$syncStatePath = Join-Path $arkaosHome 'sync-state.json'
+$repoPathFile  = Join-Path $arkaosHome '.repo-path'
+
+$currentVersion = ''
+if (Test-Path -LiteralPath $repoPathFile) {
+    try {
+        $repoPath = (Get-Content -Raw -LiteralPath $repoPathFile -Encoding UTF8).Trim()
+        if ($repoPath) {
+            $vFile = Join-Path $repoPath 'VERSION'
+            $pkgFile = Join-Path $repoPath 'package.json'
+            if (Test-Path -LiteralPath $vFile) {
+                $currentVersion = (Get-Content -Raw -LiteralPath $vFile -Encoding UTF8).Trim()
+            } elseif (Test-Path -LiteralPath $pkgFile) {
+                try {
+                    $currentVersion = [string]((Get-Content -Raw -LiteralPath $pkgFile -Encoding UTF8 | ConvertFrom-Json).version)
+                } catch { }
+            }
+        }
+    } catch { }
+}
+
+if ($currentVersion) {
+    $syncedVersion = 'none'
+    if (Test-Path -LiteralPath $syncStatePath) {
+        try {
+            $ss = Get-Content -Raw -LiteralPath $syncStatePath -Encoding UTF8 | ConvertFrom-Json
+            if ($ss.version) { $syncedVersion = [string]$ss.version }
+        } catch { }
+    }
+    if ($currentVersion -ne $syncedVersion) {
+        $syncNotice = "[arka:update-available] ArkaOS v$currentVersion installed (synced: $syncedVersion). Run /arka update to sync all projects. "
+    }
+}
+
+# --- Resolve ARKAOS_ROOT (env var -> .repo-path -> ~/.arkaos -> fallback) --
+if ($env:ARKAOS_ROOT) {
+    $arkaosRoot = $env:ARKAOS_ROOT
+} elseif (Test-Path -LiteralPath $repoPathFile) {
+    try {
+        $arkaosRoot = (Get-Content -Raw -LiteralPath $repoPathFile -Encoding UTF8).Trim()
+    } catch {
+        $arkaosRoot = $null
+    }
+}
+if (-not $arkaosRoot) {
+    if (Test-Path -LiteralPath $arkaosHome -PathType Container) {
+        $arkaosRoot = $arkaosHome
+    } else {
+        # Portable fallback - matches the shell hook's final branch.
+        $arkaosRoot = if ($env:ARKA_OS) { $env:ARKA_OS } else { Join-Path $env:USERPROFILE '.claude\skills\arkaos' }
+    }
+}
+
+# --- Cache dir -------------------------------------------------------------
+# Windows equivalent of /tmp: use the per-user temp dir so constitution
+# caches are isolated per user.
+$cacheRoot = [System.IO.Path]::GetTempPath()
+$cacheDir  = Join-Path $cacheRoot 'arkaos-context-cache'
+$null = New-Item -ItemType Directory -Force -Path $cacheDir -ErrorAction SilentlyContinue
+$cacheTtlSeconds = 300
+
+# --- Extract user input ----------------------------------------------------
+$userInput = ''
+if ($payload) {
+    if ($payload.userInput) {
+        $userInput = [string]$payload.userInput
+    } elseif ($payload.message) {
+        $userInput = [string]$payload.message
+    }
+}
+if (-not $userInput) {
+    # Fallback: truncate raw stdin (mirrors `head -c 2000` from bash).
+    if ($stdinText.Length -gt 2000) {
+        $userInput = $stdinText.Substring(0, 2000)
+    } else {
+        $userInput = $stdinText
+    }
+}
+
+# --- Helper: locate a usable Python interpreter ----------------------------
+function Find-Python {
+    # Prefer the ArkaOS venv python if the install manifest tells us where it is.
+    $manifestPath = Join-Path $env:USERPROFILE '.arkaos\install-manifest.json'
+    if (Test-Path -LiteralPath $manifestPath) {
+        try {
+            $m = Get-Content -Raw -LiteralPath $manifestPath -Encoding UTF8 | ConvertFrom-Json
+            if ($m.pythonCmd -and (Test-Path -LiteralPath $m.pythonCmd)) {
+                return $m.pythonCmd
+            }
+        } catch { }
+    }
+    # Fallback to the typical Windows venv layout.
+    $venvPy = Join-Path $env:USERPROFILE '.arkaos\venv\Scripts\python.exe'
+    if (Test-Path -LiteralPath $venvPy) { return $venvPy }
+    # System python. python3 is rare on Windows; `python` and `py -3` are typical.
+    foreach ($cmd in 'python3','python','py') {
+        $resolved = Get-Command $cmd -ErrorAction SilentlyContinue
+        if ($resolved) { return $resolved.Source }
+    }
+    return $null
+}
+
+# --- Try Python Synapse bridge ---------------------------------------------
+$pythonResult = ''
+$bridgeScript = Join-Path $arkaosRoot 'scripts\synapse-bridge.py'
+$python = Find-Python
+
+if ($python -and (Test-Path -LiteralPath $bridgeScript)) {
+    try {
+        $bridgeInput = [pscustomobject]@{ user_input = $userInput } | ConvertTo-Json -Compress
+
+        $psi = New-Object System.Diagnostics.ProcessStartInfo
+        $psi.FileName = $python
+        # PS 5.1 / .NET Framework: ProcessStartInfo only exposes `Arguments`
+        # as a single command-line string. Quote both paths so spaces work.
+        $psi.Arguments = "`"$bridgeScript`" --root `"$arkaosRoot`""
+        $psi.RedirectStandardInput  = $true
+        $psi.RedirectStandardOutput = $true
+        $psi.RedirectStandardError  = $true
+        $psi.UseShellExecute        = $false
+        $psi.CreateNoWindow         = $true
+        $psi.StandardInputEncoding  = [System.Text.UTF8Encoding]::new($false)
+        $psi.StandardOutputEncoding = [System.Text.UTF8Encoding]::new($false)
+        # Set ARKAOS_ROOT in the child environment.
+        if ($psi.EnvironmentVariables.ContainsKey('ARKAOS_ROOT')) {
+            $psi.EnvironmentVariables['ARKAOS_ROOT'] = $arkaosRoot
+        } else {
+            [void]$psi.EnvironmentVariables.Add('ARKAOS_ROOT', $arkaosRoot)
+        }
+
+        $proc = [System.Diagnostics.Process]::Start($psi)
+        $proc.StandardInput.Write($bridgeInput)
+        $proc.StandardInput.Close()
+        # Cap the bridge call at 3 seconds so a stuck bridge cannot burn the
+        # full 10-second hook budget.
+        if (-not $proc.WaitForExit(3000)) {
+            try { $proc.Kill() } catch { }
+        } else {
+            $bridgeOutput = $proc.StandardOutput.ReadToEnd()
+            if ($bridgeOutput) {
+                try {
+                    $parsed = $bridgeOutput | ConvertFrom-Json
+                    if ($parsed.context_string) {
+                        $pythonResult = [string]$parsed.context_string
+                    }
+                } catch { }
+            }
+        }
+    } catch {
+        $pythonResult = ''
+    }
+}
+
+# --- Fallback: pure-PowerShell context -------------------------------------
+if (-not $pythonResult) {
+    # L0 Constitution (5-min cache)
+    $l0CacheFile = Join-Path $cacheDir 'l0-constitution'
+    $l0 = ''
+    $cacheFresh = $false
+    if (Test-Path -LiteralPath $l0CacheFile) {
+        try {
+            $ageSeconds = ((Get-Date) - (Get-Item -LiteralPath $l0CacheFile).LastWriteTime).TotalSeconds
+            if ($ageSeconds -lt $cacheTtlSeconds) {
+                $l0 = (Get-Content -Raw -LiteralPath $l0CacheFile -Encoding UTF8).Trim()
+                if ($l0) { $cacheFresh = $true }
+            }
+        } catch { }
+    }
+    if (-not $cacheFresh) {
+        $l0 = '[Constitution] NON-NEGOTIABLE: branch-isolation, obsidian-output, authority-boundaries, security-gate, context-first, solid-clean-code, spec-driven, human-writing, squad-routing, full-visibility, sequential-validation, mandatory-qa, arka-supremacy | QUALITY-GATE: marta-cqo, eduardo-copy, francisca-tech-ux | MUST: conventional-commits, test-coverage, pattern-matching, actionable-output, memory-persistence'
+        try {
+            $utf8NoBom = [System.Text.UTF8Encoding]::new($false)
+            [System.IO.File]::WriteAllText($l0CacheFile, $l0, $utf8NoBom)
+        } catch { }
+    }
+
+    # L4 Git branch
+    $l4 = ''
+    try {
+        $branchOutput = & git rev-parse --abbrev-ref HEAD 2>$null
+        if ($LASTEXITCODE -eq 0 -and $branchOutput) {
+            $branch = $branchOutput.Trim()
+            if ($branch -and $branch -ne 'main' -and $branch -ne 'master' -and $branch -ne 'dev') {
+                $l4 = "[branch:$branch]"
+            }
+        }
+    } catch { }
+
+    # L7 Time
+    $hour = [int](Get-Date -Format 'HH')
+    if     ($hour -ge 5  -and $hour -lt 12) { $l7 = '[time:morning]' }
+    elseif ($hour -ge 12 -and $hour -lt 18) { $l7 = '[time:afternoon]' }
+    else                                     { $l7 = '[time:evening]' }
+
+    $pythonResult = (@($l0, $l4, $l7) | Where-Object { $_ }) -join ' '
+}
+
+# --- Output ----------------------------------------------------------------
+$additionalContext = "$syncNotice$pythonResult"
+[pscustomobject]@{ additionalContext = $additionalContext } | ConvertTo-Json -Compress
+
+# --- Metrics (JSONL append) ------------------------------------------------
+$elapsed = [int]$sw.ElapsedMilliseconds
+if ($elapsed -gt 0) {
+    try {
+        $metricsLine = [pscustomobject]@{ hook = 'user-prompt-submit-v2'; ms = $elapsed } | ConvertTo-Json -Compress
+        $metricsFile = Join-Path $cacheDir 'hook-metrics.jsonl'
+        $utf8NoBom = [System.Text.UTF8Encoding]::new($false)
+        # Append mode: read existing bytes, append new line, write back.
+        # Small enough that this is cheaper than opening a FileStream.
+        $existing = ''
+        if (Test-Path -LiteralPath $metricsFile) {
+            $existing = [System.IO.File]::ReadAllText($metricsFile, $utf8NoBom)
+        }
+        [System.IO.File]::WriteAllText($metricsFile, "$existing$metricsLine`n", $utf8NoBom)
+    } catch {
+        # Metrics are best-effort.
+    }
+}

package/config/hooks/user-prompt-submit.sh

@@ -58,7 +58,7 @@ _hook_ms() {
 }
 
 # ─── Paths ───────────────────────────────────────────────────────────────
-# Resolve ARKAOS_ROOT: env var → .repo-path → npm package → fallback
+# Resolve ARKAOS_ROOT: env var → .repo-path → $HOME/.arkaos → portable fallback
 if [ -n "${ARKAOS_ROOT:-}" ]; then
   : # already set
 elif [ -f "$HOME/.arkaos/.repo-path" ]; then
@@ -66,7 +66,10 @@ elif [ -f "$HOME/.arkaos/.repo-path" ]; then
 elif [ -d "$HOME/.arkaos" ]; then
   ARKAOS_ROOT="$HOME/.arkaos"
 else
-  ARKAOS_ROOT="/Users/andreagroferreira/.npm/_npx/67d92defd11b9985/node_modules/arkaos"
+  # Portable fallback — matches user-prompt-submit-v2.sh. Power users can
+  # override with the ARKA_OS env var. Reached only on corrupt/uninitialised
+  # installs; synapse-bridge.py will fail gracefully if the path is wrong.
+  ARKAOS_ROOT="${ARKA_OS:-$HOME/.claude/skills/arkaos}"
 fi
 export ARKAOS_ROOT
 

package/config/statusline.ps1

@@ -0,0 +1,160 @@
+# ============================================================================
+# ARKA OS — Two-Line Color-Coded Status Line for Claude Code (Windows port)
+# Receives JSON via stdin, outputs formatted two-line status bar.
+#
+# Paridade 1:1 com config/statusline.sh. Usa ConvertFrom-Json nativo — no jq
+# or bc dependency, works on stock Windows PowerShell 5.1 and PowerShell 7.
+#
+# Why a separate file instead of invoking the bash script: Windows has no
+# POSIX shell on the default PATH, and wrapping via `wsl bash -c ...` adds
+# ~150 ms per statusline render. This port matches the canonical schema
+# documented by Claude Code's statusline payload (model.display_name,
+# context_window.used_percentage, cost.total_cost_usd, etc.) — NOT the
+# experimental statusline-v2.sh schema, which is broken.
+# ============================================================================
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+# Force UTF-8 on stdout so the Unicode box-drawing characters (█ ░ ▲)
+# render correctly on Windows PowerShell 5.1, which otherwise emits
+# cp1252 to the host and shows "?" in place of the blocks.
+try { [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 } catch {}
+
+# ─── Read stdin ────────────────────────────────────────────────────────────
+$raw = [Console]::In.ReadToEnd()
+if ([string]::IsNullOrWhiteSpace($raw)) {
+    # Claude Code may invoke the statusline with no payload at startup.
+    # Emit a minimal banner so the bar is never blank.
+    Write-Output ([char]0x25B2 + 'ARKA')
+    return
+}
+
+# ─── Parse JSON ────────────────────────────────────────────────────────────
+try {
+    $j = $raw | ConvertFrom-Json
+} catch {
+    Write-Output ([char]0x25B2 + 'ARKA | json parse failed')
+    return
+}
+
+# Safe nested property access. PSCustomObject returns $null silently for
+# missing members, which is the behavior we want — mimics jq's `// default`.
+function Get-Field($obj, $path, $default) {
+    $cur = $obj
+    foreach ($seg in $path -split '\.') {
+        if ($null -eq $cur) { return $default }
+        $cur = $cur.$seg
+    }
+    if ($null -eq $cur) { return $default }
+    return $cur
+}
+
+$model    = [string](Get-Field $j 'model.display_name' 'unknown')
+$cwd      = [string](Get-Field $j 'cwd' '')
+$projDir  = [string](Get-Field $j 'workspace.project_dir' '')
+$pctRaw   = Get-Field $j 'context_window.used_percentage' 0
+$inTok    = [int64](Get-Field $j 'context_window.total_input_tokens' 0)
+$outTok   = [int64](Get-Field $j 'context_window.total_output_tokens' 0)
+$cost     = [double](Get-Field $j 'cost.total_cost_usd' 0)
+$durMs    = [int64](Get-Field $j 'cost.total_duration_ms' 0)
+$added    = [int64](Get-Field $j 'cost.total_lines_added' 0)
+$removed  = [int64](Get-Field $j 'cost.total_lines_removed' 0)
+
+$pct = [int][math]::Floor([double]$pctRaw)
+if ($pct -lt 0)   { $pct = 0 }
+if ($pct -gt 100) { $pct = 100 }
+
+# ─── Project name ─────────────────────────────────────────────────────────
+$workDir = if ($cwd) { $cwd } else { $projDir }
+if ([string]::IsNullOrEmpty($workDir)) {
+    $dirName = 'arka'
+} else {
+    $dirName = Split-Path -Leaf $workDir
+}
+
+# ─── Git branch ───────────────────────────────────────────────────────────
+# No file cache: PowerShell startup already dominates the render cost, the
+# git call is ~20 ms on NTFS, and caching across renders is unsafe because
+# Claude Code can render the statusline from multiple cwd's concurrently.
+$branch = ''
+if ($workDir -and (Test-Path -LiteralPath $workDir)) {
+    $branch = & git -C $workDir rev-parse --abbrev-ref HEAD 2>$null
+    if ($null -eq $branch) { $branch = '' }
+    $branch = ([string]$branch).Trim()
+}
+
+# ─── ANSI colors ──────────────────────────────────────────────────────────
+$ESC         = [char]27
+$C_RESET     = "$ESC[0m"
+$C_CYAN      = "$ESC[0;36m"
+$C_DIM       = "$ESC[2m"
+$C_WHITE     = "$ESC[1;37m"
+$C_GREEN     = "$ESC[0;32m"
+$C_YELLOW    = "$ESC[1;33m"
+$C_RED       = "$ESC[0;31m"
+$C_BLINK_RED = "$ESC[5;31m"
+
+if     ($pct -ge 90) { $C_BAR = $C_BLINK_RED }
+elseif ($pct -ge 80) { $C_BAR = $C_RED }
+elseif ($pct -ge 60) { $C_BAR = $C_YELLOW }
+else                 { $C_BAR = $C_GREEN }
+
+# ─── Format tokens (K/M, invariant culture so pt-PT doesn't emit "12,3K") ──
+function Format-Tokens($n) {
+    $inv = [cultureinfo]::InvariantCulture
+    if ($n -ge 1000000) {
+        return ([double]($n / 1000000.0)).ToString('0.0', $inv) + 'M'
+    } elseif ($n -ge 1000) {
+        return ([double]($n / 1000.0)).ToString('0.0', $inv) + 'K'
+    } else {
+        return "$n"
+    }
+}
+
+$inFmt  = Format-Tokens $inTok
+$outFmt = Format-Tokens $outTok
+
+# ─── Progress bar (10 chars) ──────────────────────────────────────────────
+# Floor the division: 95 % → 9 blocks, matching the bash integer division.
+# PowerShell's `/` returns double, so [int] alone would round-to-even and
+# drift on odd multiples of 5.
+$filled = [int][math]::Floor($pct / 10.0)
+$empty  = 10 - $filled
+$block  = [char]0x2588  # █
+$shade  = [char]0x2591  # ░
+$bar    = ([string]$block * $filled) + ([string]$shade * $empty)
+
+# ─── Format duration ──────────────────────────────────────────────────────
+$secs = [int64][math]::Floor($durMs / 1000.0)
+if ($secs -ge 3600) {
+    $h = [int][math]::Floor($secs / 3600.0)
+    $m = [int][math]::Floor(($secs % 3600) / 60.0)
+    $timeFmt = "${h}h${m}m"
+} elseif ($secs -ge 60) {
+    $m = [int][math]::Floor($secs / 60.0)
+    $r = [int]($secs % 60)
+    $timeFmt = "${m}m${r}s"
+} else {
+    $timeFmt = "${secs}s"
+}
+
+# ─── Format cost (invariant culture: always "$0.00", never "$0,00") ───────
+$costFmt = '$' + ([double]$cost).ToString('0.00', [cultureinfo]::InvariantCulture)
+
+# ─── Build Line 1: Context bar ────────────────────────────────────────────
+$triangle = [char]0x25B2  # ▲
+$line1 = "${C_CYAN}${triangle}ARKA${C_RESET}  ${C_WHITE}${dirName}${C_RESET}"
+if ($branch -and $branch -ne 'main' -and $branch -ne 'master') {
+    $line1 += "  ${C_DIM}on${C_RESET} ${C_GREEN}${branch}${C_RESET}"
+}
+$line1 += "  ${C_DIM}|${C_RESET}  ${model}"
+
+# ─── Build Line 2: Metrics bar ────────────────────────────────────────────
+$line2  = "${C_BAR}${bar} ${pct}%${C_RESET}"
+$line2 += "  ${C_DIM}|${C_RESET}  ${inFmt} in ${outFmt} out"
+$line2 += "  ${C_DIM}|${C_RESET}  ${C_GREEN}+${added}${C_RESET} ${C_RED}-${removed}${C_RESET}"
+$line2 += "  ${C_DIM}|${C_RESET}  ${timeFmt}"
+$line2 += "  ${C_DIM}|${C_RESET}  ${costFmt}"
+
+Write-Output $line1
+Write-Output $line2