arkaos 2.10.0 → 2.11.0

package/config/hooks/post-tool-use.ps1

@@ -0,0 +1,347 @@
+# ============================================================================
+# ArkaOS — PostToolUse Hook (Gotchas Memory) (Windows / PowerShell 5.1+)
+#
+# Port of config/hooks/post-tool-use.sh. Detects errors emitted by tool runs
+# and records recurring patterns in a local gotchas file so ArkaOS can learn
+# which mistakes repeat across projects.
+#
+# Contract:
+# - Reads a hook payload JSON from stdin (tool_name, tool_output, exit_code,
+#   cwd).
+# - Always exits 0 and writes `{}` on stdout — PostToolUse does not inject
+#   context.
+# - Side effect: updates %USERPROFILE%\.arkaos\gotchas.json and
+#   %USERPROFILE%\.arkaos\hook-metrics.json.
+#
+# State files live under the canonical v2 runtime directory `~/.arkaos/`.
+# Older builds of the bash twin used `~/.arka-os/` (with a dash); the
+# bash hook has been fixed in the same commit series, and the installer
+# update path now carries legacy state forward on the first update.
+# ============================================================================
+
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+
+# Hard timeout budget for the whole hook: 5 seconds (same as settings).
+$sw = [System.Diagnostics.Stopwatch]::StartNew()
+
+# ─── Helper functions (used by both gotchas and metrics blocks) ───────
+# Defined at module scope so the metrics-write block at the bottom of
+# the file can still reach them when `shouldProcessGotchas` is false
+# and the gotchas branch is skipped.
+
+function Acquire-FileLock {
+    param([string]$LockPath, [int]$TimeoutMs = 3000)
+    $deadline = [Environment]::TickCount + $TimeoutMs
+    while ([Environment]::TickCount -lt $deadline) {
+        try {
+            $fs = [System.IO.File]::Open(
+                $LockPath,
+                [System.IO.FileMode]::OpenOrCreate,
+                [System.IO.FileAccess]::ReadWrite,
+                [System.IO.FileShare]::None
+            )
+            return $fs
+        } catch {
+            Start-Sleep -Milliseconds 50
+        }
+    }
+    return $null
+}
+
+# PS 5.1's `Set-Content -Encoding UTF8` writes a BOM; tools that parse
+# UTF-8 strictly (jq, python's json module, etc.) treat the BOM as a
+# stray character. Always write JSON state files BOM-less via the .NET
+# API with an explicit UTF8Encoding($false).
+function Write-JsonAtomic {
+    param([string]$Path, [string]$Json)
+    $tmp = "$Path.tmp"
+    $utf8NoBom = [System.Text.UTF8Encoding]::new($false)
+    [System.IO.File]::WriteAllText($tmp, $Json, $utf8NoBom)
+    Move-Item -Force -LiteralPath $tmp -Destination $Path
+}
+
+# PS 5.1 `ConvertTo-Json` on a single-item collection serializes as a
+# bare object, not a single-element array. We always want `[...]` on
+# disk, even with 0 or 1 entries, so state files stay homogeneous and
+# round-trip cleanly. This helper forces array wrapping by serializing
+# each item and joining manually.
+function ConvertTo-JsonArray {
+    param($Items, [int]$Depth = 10)
+    $arr = @($Items)
+    if ($arr.Count -eq 0) { return '[]' }
+    $parts = foreach ($item in $arr) {
+        $item | ConvertTo-Json -Depth $Depth -Compress
+    }
+    return '[' + ($parts -join ',') + ']'
+}
+
+# ArrayList survives ConvertTo-Json as a proper JSON array even with
+# 0 or 1 elements, unlike `@()` which PS 5.1 happily collapses.
+function New-StringArrayList {
+    param([string[]]$Initial)
+    $list = New-Object System.Collections.ArrayList
+    if ($Initial) {
+        foreach ($s in $Initial) {
+            if ($null -ne $s -and $s -ne '') { [void]$list.Add($s) }
+        }
+    }
+    return ,$list
+}
+
+# ─── Read hook payload from stdin (with empty-stdin tolerance) ────────
+# On Claude Code Windows v2.1.97 the hook stdin pipe is opened but the
+# parent writes zero bytes before closing (upstream bug — see
+# Projects/ARKA OS/Windows Handoff.md canary data). We still want to
+# log the metric that proves the hook fired, so instead of early-exiting
+# on empty stdin we just skip the gotchas-processing block and fall
+# through to the metrics write + final '{}' at the bottom of the file.
+$stdinText = [Console]::In.ReadToEnd()
+$shouldProcessGotchas = $true
+$payload = $null
+$toolName = ''
+$toolOutput = ''
+$exitCode = '0'
+$cwd = ''
+
+if ([string]::IsNullOrWhiteSpace($stdinText)) {
+    $shouldProcessGotchas = $false
+} else {
+    try {
+        $payload = $stdinText | ConvertFrom-Json
+    } catch {
+        $shouldProcessGotchas = $false
+    }
+}
+
+if ($shouldProcessGotchas -and $null -ne $payload) {
+    $toolName   = if ($null -ne $payload.tool_name)   { [string]$payload.tool_name   } else { '' }
+    $toolOutput = if ($null -ne $payload.tool_output) { [string]$payload.tool_output } else { '' }
+    $exitCode   = if ($null -ne $payload.exit_code)   { [string]$payload.exit_code   } else { '0' }
+    $cwd        = if ($null -ne $payload.cwd)         { [string]$payload.cwd         } else { '' }
+
+    # ─── Only process when there is actually an error ─────────────────
+    $errorPattern = '(?i)(error:|fatal:|exception:|failed|ENOENT|EACCES|EPERM|panic:)'
+    if ($exitCode -eq '0' -or [string]::IsNullOrEmpty($exitCode)) {
+        if ($toolOutput -notmatch $errorPattern) {
+            $shouldProcessGotchas = $false
+        }
+    }
+}
+
+# Paths that the metrics block needs are declared up here, outside the
+# gotchas-processing branch, so the metrics write at the very bottom of
+# the file works even when `shouldProcessGotchas` is false (empty stdin,
+# invalid JSON, no error pattern, etc.).
+$arkaosRuntimeDir = Join-Path $env:USERPROFILE '.arkaos'
+$null = New-Item -ItemType Directory -Force -Path $arkaosRuntimeDir -ErrorAction SilentlyContinue
+
+# Gotchas processing lives inside a `do { ... } while ($false)` single-
+# iteration loop so any inner step that used to `exit 0` can now `break`
+# out of the gotchas block without bypassing the metrics write.
+if ($shouldProcessGotchas) { do {
+
+# ─── Extract first meaningful error line ─────────────────────────────
+$lines = $toolOutput -split "`r?`n"
+$errorLineRegex = '(?i)(error|fatal|exception|failed|ENOENT|EACCES|EPERM|panic|cannot|not found|permission denied)'
+$errorLine = $null
+foreach ($ln in $lines) {
+    if ($ln -match $errorLineRegex) { $errorLine = $ln; break }
+}
+if ([string]::IsNullOrWhiteSpace($errorLine)) {
+    # Fallback: first-5-lines-tail-1, same as `head -5 | tail -1` in bash.
+    $firstFive = @($lines | Select-Object -First 5)
+    if ($firstFive.Count -gt 0) { $errorLine = $firstFive[-1] }
+}
+if ([string]::IsNullOrWhiteSpace($errorLine)) {
+    break
+}
+
+# ─── Normalize pattern (matches bash sed chain exactly) ───────────────
+$pattern = $errorLine
+$pattern = $pattern -replace '[0-9]{4}-[0-9]{2}-[0-9]{2}[T ][0-9]{2}:[0-9]{2}:[0-9]{2}[^ ]*', 'TIMESTAMP'
+$pattern = $pattern -replace '[0-9a-f]{7,40}', 'HASH'
+$pattern = $pattern -replace 'line [0-9]+', 'line N'
+$pattern = $pattern -replace ':[0-9]+:', ':N:'
+if ($pattern.Length -gt 200) { $pattern = $pattern.Substring(0, 200) }
+if ([string]::IsNullOrWhiteSpace($pattern)) {
+    break
+}
+
+# ─── Categorize ───────────────────────────────────────────────────────
+$category = 'general'
+if     ($errorLine -match '(?i)(artisan|eloquent|laravel|blade|migration|composer|php )')                  { $category = 'laravel' }
+elseif ($errorLine -match '(?i)(npm|node|vue|react|nuxt|next|vite|webpack|typescript|tsx|jsx)')            { $category = 'frontend' }
+elseif ($errorLine -match '(?i)(git |merge|rebase|checkout|branch|commit|push|pull)')                     { $category = 'git' }
+elseif ($errorLine -match '(?i)(sql|postgres|mysql|database|migration|table|column|constraint)')           { $category = 'database' }
+elseif ($errorLine -match '(?i)(permission|denied|EACCES|EPERM|chmod|chown|sudo)')                         { $category = 'permissions' }
+elseif ($errorLine -match '(?i)(test|assert|expect|jest|phpunit|bats|coverage)')                           { $category = 'testing' }
+
+# ─── Match fix suggestion from gotchas-fixes.json ─────────────────────
+$arkaSkillRoot = if ($env:ARKA_OS) { $env:ARKA_OS } else { Join-Path $env:USERPROFILE '.claude\skills\arka' }
+$fixesFile = Join-Path $arkaSkillRoot 'config\gotchas-fixes.json'
+if (-not (Test-Path -LiteralPath $fixesFile)) {
+    $repoPathFile = Join-Path $arkaSkillRoot '.repo-path'
+    if (Test-Path -LiteralPath $repoPathFile) {
+        try {
+            $repoPath = (Get-Content -Raw -LiteralPath $repoPathFile -Encoding UTF8).Trim()
+            if ($repoPath) {
+                $candidate = Join-Path $repoPath 'config\gotchas-fixes.json'
+                if (Test-Path -LiteralPath $candidate) { $fixesFile = $candidate }
+            }
+        } catch { }
+    }
+}
+
+$suggestion = ''
+if (Test-Path -LiteralPath $fixesFile) {
+    try {
+        $fixes = (Get-Content -Raw -LiteralPath $fixesFile -Encoding UTF8 | ConvertFrom-Json).fixes
+        foreach ($fix in @($fixes)) {
+            if ($fix.pattern_match -and ($errorLine -imatch [string]$fix.pattern_match)) {
+                $suggestion = [string]$fix.suggestion
+                break
+            }
+        }
+    } catch { }
+}
+
+# ─── Detect active project ────────────────────────────────────────────
+$project = ''
+if ($cwd) {
+    try {
+        $repoPathFile = Join-Path $arkaSkillRoot '.repo-path'
+        if (Test-Path -LiteralPath $repoPathFile) {
+            $repoPath = (Get-Content -Raw -LiteralPath $repoPathFile -Encoding UTF8).Trim()
+            $projectsDir = Join-Path $repoPath 'projects'
+            if ($repoPath -and (Test-Path -LiteralPath $projectsDir -PathType Container)) {
+                foreach ($projDir in (Get-ChildItem -LiteralPath $projectsDir -Directory -ErrorAction SilentlyContinue)) {
+                    $projectPathFile = Join-Path $projDir.FullName '.project-path'
+                    if (Test-Path -LiteralPath $projectPathFile) {
+                        $projPath = (Get-Content -Raw -LiteralPath $projectPathFile -Encoding UTF8).Trim()
+                        if ($projPath -and $cwd.StartsWith($projPath)) {
+                            $project = $projDir.Name
+                            break
+                        }
+                    }
+                }
+            }
+        }
+    } catch { }
+    if (-not $project) { $project = Split-Path -Leaf $cwd.TrimEnd('\','/') }
+}
+
+# ─── Update ~/.arkaos/gotchas.json (best-effort under a file lock) ────
+# $arkaosRuntimeDir was declared at the top of the script so the metrics
+# block can always reach it.
+$gotchasFile  = Join-Path $arkaosRuntimeDir 'gotchas.json'
+$gotchasLock  = Join-Path $arkaosRuntimeDir 'gotchas.lock'
+
+$lock = Acquire-FileLock -LockPath $gotchasLock
+if ($null -ne $lock) {
+    try {
+        $now = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+
+        $gotchas = @()
+        if (Test-Path -LiteralPath $gotchasFile) {
+            try {
+                $raw = Get-Content -Raw -LiteralPath $gotchasFile -Encoding UTF8
+                if ($raw -and $raw.Trim()) {
+                    $parsed = $raw | ConvertFrom-Json
+                    $gotchas = @($parsed)
+                }
+            } catch {
+                $gotchas = @()
+            }
+        }
+
+        $existingIdx = -1
+        for ($i = 0; $i -lt $gotchas.Count; $i++) {
+            if ([string]$gotchas[$i].pattern -eq $pattern) {
+                $existingIdx = $i
+                break
+            }
+        }
+
+        if ($existingIdx -ge 0) {
+            $entry = $gotchas[$existingIdx]
+            $entry.count      = [int]$entry.count + 1
+            $entry.last_seen  = $now
+            if ($project) {
+                $existingProjects = @()
+                if ($entry.projects) { $existingProjects = @($entry.projects) }
+                if ($existingProjects -notcontains $project) {
+                    $existingProjects += $project
+                }
+                $entry.projects = (New-StringArrayList -Initial $existingProjects)
+            }
+            if ($suggestion -and [string]::IsNullOrEmpty([string]$entry.suggestion)) {
+                $entry | Add-Member -NotePropertyName suggestion -NotePropertyValue $suggestion -Force
+            }
+            $gotchas[$existingIdx] = $entry
+        } else {
+            $fullPattern = if ($errorLine.Length -gt 500) { $errorLine.Substring(0, 500) } else { $errorLine }
+            $projectsList = if ($project) {
+                New-StringArrayList -Initial @($project)
+            } else {
+                New-StringArrayList
+            }
+            $newEntry = [pscustomobject][ordered]@{
+                pattern       = $pattern
+                full_pattern  = $fullPattern
+                category      = $category
+                tool          = $toolName
+                count         = 1
+                first_seen    = $now
+                last_seen     = $now
+                projects      = $projectsList
+                suggestion    = if ($suggestion) { $suggestion } else { $null }
+            }
+            $gotchas = @($gotchas) + $newEntry
+        }
+
+        # Keep top 100 by count desc. Force array with @() after the
+        # pipeline — PS 5.1 unwraps to a scalar when only one remains.
+        $gotchas = @($gotchas | Sort-Object -Property count -Descending | Select-Object -First 100)
+
+        Write-JsonAtomic -Path $gotchasFile -Json (ConvertTo-JsonArray -Items $gotchas -Depth 10)
+    } catch {
+        # Swallow — gotchas tracking is best-effort, must not fail the hook.
+    } finally {
+        $lock.Close()
+        $lock.Dispose()
+    }
+}
+
+} while ($false) }  # end: do/while single-iteration + if ($shouldProcessGotchas)
+
+# ─── Log hook metrics (best-effort) ───────────────────────────────────
+$metricsFile = Join-Path $arkaosRuntimeDir 'hook-metrics.json'
+$metricsLock = Join-Path $arkaosRuntimeDir 'hook-metrics.lock'
+$metricsLockHandle = Acquire-FileLock -LockPath $metricsLock -TimeoutMs 2000
+if ($null -ne $metricsLockHandle) {
+    try {
+        $metrics = @()
+        if (Test-Path -LiteralPath $metricsFile) {
+            try {
+                $raw = Get-Content -Raw -LiteralPath $metricsFile -Encoding UTF8
+                if ($raw -and $raw.Trim()) { $metrics = @(($raw | ConvertFrom-Json)) }
+            } catch { $metrics = @() }
+        }
+        $metrics = @($metrics) + ([pscustomobject]@{
+            hook        = 'post-tool-use'
+            duration_ms = [int]$sw.ElapsedMilliseconds
+            timestamp   = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+        })
+        if ($metrics.Count -gt 500) { $metrics = @($metrics[-500..-1]) }
+        Write-JsonAtomic -Path $metricsFile -Json (ConvertTo-JsonArray -Items $metrics -Depth 5)
+    } catch {
+        # Metrics are non-critical.
+    } finally {
+        $metricsLockHandle.Close()
+        $metricsLockHandle.Dispose()
+    }
+}
+
+# Silent output — PostToolUse does not inject context.
+'{}'

package/config/hooks/post-tool-use.sh

@@ -105,11 +105,11 @@ if [ -n "$CWD" ]; then
 fi
 
 # ─── Store in gotchas.json ────────────────────────────────────────────────
-GOTCHAS_FILE="$HOME/.arka-os/gotchas.json"
-mkdir -p "$HOME/.arka-os"
+GOTCHAS_FILE="$HOME/.arkaos/gotchas.json"
+mkdir -p "$HOME/.arkaos"
 
 # Use flock for concurrent safety (fallback if flock not available on macOS)
-LOCK_FILE="$HOME/.arka-os/gotchas.lock"
+LOCK_FILE="$HOME/.arkaos/gotchas.lock"
 if command -v flock &>/dev/null; then
   LOCK_CMD="flock -w 3 200"
 else
@@ -172,9 +172,9 @@ fi
 
 # ─── Log Metrics ─────────────────────────────────────────────────────────
 _DURATION_MS=$(_hook_ms)
-METRICS_FILE="$HOME/.arka-os/hook-metrics.json"
-METRICS_LOCK="$HOME/.arka-os/hook-metrics.lock"
-mkdir -p "$HOME/.arka-os"
+METRICS_FILE="$HOME/.arkaos/hook-metrics.json"
+METRICS_LOCK="$HOME/.arkaos/hook-metrics.lock"
+mkdir -p "$HOME/.arkaos"
 (
   if command -v flock &>/dev/null; then flock -w 2 200; else true; fi
   [ ! -f "$METRICS_FILE" ] && echo '[]' > "$METRICS_FILE"

package/config/hooks/pre-compact.ps1

@@ -0,0 +1,238 @@
+# ============================================================================
+# ArkaOS - PreCompact Hook (Session Digest) (Windows / PowerShell 5.1+)
+#
+# Port of config/hooks/pre-compact.sh. Fires before Claude Code compacts the
+# context window. Saves a markdown digest of the session so nothing is lost.
+#
+# Contract:
+# - Reads a JSON payload from stdin with `session_id`, `transcript`, and
+#   optionally `messages`.
+# - Writes `%USERPROFILE%\.arkaos\session-digests\<ts>-<id>.md`.
+# - Prunes the digest directory to the 50 most recent entries.
+# - Logs a metrics row to `hook-metrics.json`.
+# - Emits `{}` on stdout - no context injection.
+#
+# State files live under the canonical v2 runtime directory `~/.arkaos/`.
+# Older builds of the bash twin used `~/.arka-os/` (with a dash); the
+# bash hook has been fixed in the same commit series, and the installer
+# update path now carries legacy state forward on the first update.
+#
+# File is pure ASCII on purpose; PS 5.1 reads source files as ANSI by
+# default, which would mojibake any embedded Unicode. Typographic chars
+# used in the output markdown are built from [char] codes at runtime.
+# ============================================================================
+
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+
+$sw = [System.Diagnostics.Stopwatch]::StartNew()
+
+# --- Read stdin --------------------------------------------------------
+$stdinText = [Console]::In.ReadToEnd()
+$payload = $null
+if (-not [string]::IsNullOrWhiteSpace($stdinText)) {
+    try { $payload = $stdinText | ConvertFrom-Json } catch { $payload = $null }
+}
+
+$sessionId  = if ($payload -and $payload.session_id) { [string]$payload.session_id } else { 'unknown' }
+$transcript = if ($payload -and $payload.transcript) { [string]$payload.transcript } else { '' }
+
+# --- Paths -------------------------------------------------------------
+# $arkaosRuntimeDir is declared up-front so the metrics block at the
+# bottom of the file can always reach it, even when we skip the digest
+# write below on empty stdin.
+$arkaosRuntimeDir = Join-Path $env:USERPROFILE '.arkaos'
+$null = New-Item -ItemType Directory -Force -Path $arkaosRuntimeDir -ErrorAction SilentlyContinue
+
+# --- Empty-stdin guard (Windows CC v2.1.97 upstream bug) --------------
+# Claude Code on Windows currently opens the hook stdin pipe but writes
+# zero bytes, so `$payload.messages` and `$payload.transcript` are both
+# empty. Writing a `(no transcript available)` digest in that case just
+# spams the session-digests directory with empty files and risks
+# evicting real digests when the 50-file rotation runs.
+#
+# Fast-path: if there is nothing to digest, skip the file write entirely
+# but still fall through to the metrics block so we can prove the hook
+# fired. Mirrors the `shouldProcess` pattern used in post-tool-use.ps1.
+$hasContent = $false
+if ($transcript) { $hasContent = $true }
+if (-not $hasContent -and $payload -and $payload.messages) {
+    try {
+        foreach ($m in @($payload.messages)) {
+            if ($m.role -eq 'assistant' -and $null -ne $m.content -and [string]$m.content) {
+                $hasContent = $true
+                break
+            }
+        }
+    } catch { }
+}
+
+# When $hasContent is false we still compute the digest path variables
+# below (they have no side effects) but everything that writes to disk
+# under the digest directory is wrapped in `if ($hasContent)` so we
+# can't spam ghost digests or prune real ones on empty input.
+
+$digestDir  = Join-Path $arkaosRuntimeDir 'session-digests'
+$timestamp  = (Get-Date).ToString('yyyyMMdd-HHmmss')
+$shortId    = if ($sessionId.Length -ge 8) { $sessionId.Substring(0, 8) } else { $sessionId }
+$digestFile = Join-Path $digestDir "$timestamp-$shortId.md"
+
+if ($hasContent) {
+    $null = New-Item -ItemType Directory -Force -Path $digestDir -ErrorAction SilentlyContinue
+}
+
+# --- Extract tail of transcript (last 50 lines) -----------------------
+$tailLines = '(no transcript available)'
+if ($transcript) {
+    $split = $transcript -split "`r?`n"
+    if ($split.Count -gt 50) {
+        $tailLines = ($split[-50..-1] -join "`n")
+    } else {
+        $tailLines = ($split -join "`n")
+    }
+}
+
+# --- Extract last 5 assistant messages --------------------------------
+# Walks payload.messages, takes the subset where role == "assistant",
+# grabs the last up-to-five .content values, and joins them with blank
+# lines. The bash twin (config/hooks/pre-compact.sh) is fixed at the
+# same time by replacing `jq '... | last(5) | ...'` (a no-op) with the
+# `[-5:]` array slice.
+$assistantMsgs = ''
+if ($payload -and $payload.messages) {
+    try {
+        $assistantContents = @()
+        foreach ($m in @($payload.messages)) {
+            if ($m.role -eq 'assistant' -and $null -ne $m.content) {
+                $assistantContents += [string]$m.content
+            }
+        }
+        if ($assistantContents.Count -gt 0) {
+            $lastFive = if ($assistantContents.Count -gt 5) {
+                $assistantContents[-5..-1]
+            } else {
+                $assistantContents
+            }
+            # Single newline matches the bash `jq '... | .[]'` iteration.
+            $assistantMsgs = ($lastFive -join "`n")
+        }
+    } catch {
+        # Malformed messages array - fall back to empty, like bash `|| true`.
+    }
+}
+
+# --- Build digest markdown -----------------------------------------
+$emdash = [char]0x2014
+$nowHuman = (Get-Date).ToString('yyyy-MM-dd HH:mm:ss')
+$assistantBlock = if ($assistantMsgs) { $assistantMsgs } else { '_(none captured)_' }
+
+# $utf8NoBom is also used by the metrics block below, so declare it
+# outside the $hasContent branch.
+$utf8NoBom = [System.Text.UTF8Encoding]::new($false)
+
+if ($hasContent) {
+    $digest = @"
+---
+type: session-digest
+session_id: $sessionId
+timestamp: $timestamp
+trigger: pre-compact
+---
+
+# Session Digest $emdash $timestamp
+
+**Session:** ``$sessionId``
+**Saved at:** $nowHuman
+**Trigger:** Context compaction
+
+## Last Assistant Messages
+
+$assistantBlock
+
+## Transcript Tail (last 50 lines)
+
+``````
+$tailLines
+``````
+"@
+
+    # Write BOM-less UTF-8 so other tools that read these files (grep, jq,
+    # python) behave consistently across platforms.
+    [System.IO.File]::WriteAllText($digestFile, $digest, $utf8NoBom)
+
+    # --- Prune to last 50 digests -------------------------------------
+    try {
+        $digests = @(
+            Get-ChildItem -LiteralPath $digestDir -Filter '*.md' -ErrorAction SilentlyContinue |
+                Sort-Object LastWriteTime -Descending
+        )
+        if ($digests.Count -gt 50) {
+            $toRemove = $digests[50..($digests.Count - 1)]
+            foreach ($f in $toRemove) {
+                Remove-Item -LiteralPath $f.FullName -Force -ErrorAction SilentlyContinue
+            }
+        }
+    } catch {
+        # Best-effort cleanup.
+    }
+}
+
+# --- Metrics (shared shape with post-tool-use) ------------------------
+function Acquire-FileLock {
+    param([string]$LockPath, [int]$TimeoutMs = 2000)
+    $deadline = [Environment]::TickCount + $TimeoutMs
+    while ([Environment]::TickCount -lt $deadline) {
+        try {
+            return [System.IO.File]::Open(
+                $LockPath,
+                [System.IO.FileMode]::OpenOrCreate,
+                [System.IO.FileAccess]::ReadWrite,
+                [System.IO.FileShare]::None
+            )
+        } catch {
+            Start-Sleep -Milliseconds 50
+        }
+    }
+    return $null
+}
+
+function ConvertTo-JsonArray {
+    param($Items, [int]$Depth = 5)
+    $arr = @($Items)
+    if ($arr.Count -eq 0) { return '[]' }
+    $parts = foreach ($item in $arr) { $item | ConvertTo-Json -Depth $Depth -Compress }
+    return '[' + ($parts -join ',') + ']'
+}
+
+$metricsFile = Join-Path $arkaosRuntimeDir 'hook-metrics.json'
+$metricsLock = Join-Path $arkaosRuntimeDir 'hook-metrics.lock'
+$lock = Acquire-FileLock -LockPath $metricsLock
+if ($null -ne $lock) {
+    try {
+        $metrics = @()
+        if (Test-Path -LiteralPath $metricsFile) {
+            try {
+                $raw = Get-Content -Raw -LiteralPath $metricsFile -Encoding UTF8
+                if ($raw -and $raw.Trim()) { $metrics = @(($raw | ConvertFrom-Json)) }
+            } catch { $metrics = @() }
+        }
+        $metrics = @($metrics) + ([pscustomobject]@{
+            hook        = 'pre-compact'
+            duration_ms = [int]$sw.ElapsedMilliseconds
+            timestamp   = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
+        })
+        if ($metrics.Count -gt 500) { $metrics = @($metrics[-500..-1]) }
+
+        $tmp = "$metricsFile.tmp"
+        [System.IO.File]::WriteAllText($tmp, (ConvertTo-JsonArray -Items $metrics -Depth 5), $utf8NoBom)
+        Move-Item -Force -LiteralPath $tmp -Destination $metricsFile
+    } catch {
+        # Non-critical.
+    } finally {
+        $lock.Close()
+        $lock.Dispose()
+    }
+}
+
+# Silent output.
+'{}'

package/config/hooks/pre-compact.sh

@@ -24,7 +24,7 @@ SESSION_ID=$(echo "$input" | jq -r '.session_id // "unknown"' 2>/dev/null)
 TRANSCRIPT=$(echo "$input" | jq -r '.transcript // ""' 2>/dev/null)
 
 # ─── Setup ────────────────────────────────────────────────────────────────
-DIGEST_DIR="$HOME/.arka-os/session-digests"
+DIGEST_DIR="$HOME/.arkaos/session-digests"
 mkdir -p "$DIGEST_DIR"
 
 TIMESTAMP=$(date +%Y%m%d-%H%M%S)
@@ -39,11 +39,15 @@ else
   TAIL_LINES="(no transcript available)"
 fi
 
-# Extract last 5 assistant messages from JSON if available
+# Extract last 5 assistant messages from JSON if available.
+# The previous filter used `last(5)` which in jq returns the LAST element
+# of the generator `5` (the constant 5 itself), so the pipeline collapsed
+# to `5 | .[]` and always produced nothing. Use the array slice `[-5:]`
+# to actually take the last up-to-five elements, then iterate.
 ASSISTANT_MSGS=""
 if echo "$input" | jq -e '.messages' &>/dev/null; then
   ASSISTANT_MSGS=$(echo "$input" | jq -r '
-    [.messages[] | select(.role == "assistant") | .content] | last(5) | .[] // empty
+    [.messages[] | select(.role == "assistant") | .content][-5:] | .[]
   ' 2>/dev/null)
 fi
 
@@ -82,9 +86,9 @@ fi
 
 # ─── Log Metrics ─────────────────────────────────────────────────────────
 _DURATION_MS=$(_hook_ms)
-METRICS_FILE="$HOME/.arka-os/hook-metrics.json"
-METRICS_LOCK="$HOME/.arka-os/hook-metrics.lock"
-mkdir -p "$HOME/.arka-os"
+METRICS_FILE="$HOME/.arkaos/hook-metrics.json"
+METRICS_LOCK="$HOME/.arkaos/hook-metrics.lock"
+mkdir -p "$HOME/.arkaos"
 (
   if command -v flock &>/dev/null; then flock -w 2 200; else true; fi
   [ ! -f "$METRICS_FILE" ] && echo '[]' > "$METRICS_FILE"