@ekkos/cli 0.2.9 → 0.2.10

package/templates/hooks/stop.ps1

@@ -1,14 +1,135 @@
 # ═══════════════════════════════════════════════════════════════════════════
-# ekkOS_ Hook: Stop - Session cleanup (Windows)
+# ekkOS_ Hook: Stop - Session cleanup and capture finalization (Windows)
+# MANAGED BY ekkos-connect - DO NOT EDIT DIRECTLY
+# EKKOS_MANAGED=1
+# EKKOS_MANIFEST_SHA256=<computed-at-build>
+# EKKOS_TEMPLATE_VERSION=1.0.0
+#
+# Per ekkOS Onboarding Spec v1.2 FINAL + ADDENDUM:
+# - All persisted records MUST include: instanceId, sessionId, sessionName
+# - Uses EKKOS_INSTANCE_ID env var for multi-session isolation
 # ═══════════════════════════════════════════════════════════════════════════
 
 $ErrorActionPreference = "SilentlyContinue"
 
-# Read input
+# ═══════════════════════════════════════════════════════════════════════════
+# CONFIG PATHS
+# ═══════════════════════════════════════════════════════════════════════════
+$EkkosConfigDir = if ($env:EKKOS_CONFIG_DIR) { $env:EKKOS_CONFIG_DIR } else { "$env:USERPROFILE\.ekkos" }
+$SessionWordsJson = "$EkkosConfigDir\session-words.json"
+$SessionWordsDefault = "$EkkosConfigDir\.defaults\session-words.json"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# INSTANCE ID - Multi-session isolation per v1.2 ADDENDUM
+# ═══════════════════════════════════════════════════════════════════════════
+$EkkosInstanceId = if ($env:EKKOS_INSTANCE_ID) { $env:EKKOS_INSTANCE_ID } else { "default" }
+
+# ═══════════════════════════════════════════════════════════════════════════
+# Load session words from JSON file - NO HARDCODED ARRAYS
+# ═══════════════════════════════════════════════════════════════════════════
+$script:SessionWords = $null
+
+function Load-SessionWords {
+    $wordsFile = $SessionWordsJson
+
+    if (-not (Test-Path $wordsFile)) {
+        $wordsFile = $SessionWordsDefault
+    }
+
+    if (-not (Test-Path $wordsFile)) {
+        return $null
+    }
+
+    try {
+        $script:SessionWords = Get-Content $wordsFile -Raw | ConvertFrom-Json
+    } catch {
+        return $null
+    }
+}
+
+function Convert-UuidToWords {
+    param([string]$uuid)
+
+    if (-not $script:SessionWords) {
+        Load-SessionWords
+    }
+
+    if (-not $script:SessionWords) {
+        return "unknown-session"
+    }
+
+    $adjectives = $script:SessionWords.adjectives
+    $nouns = $script:SessionWords.nouns
+    $verbs = $script:SessionWords.verbs
+
+    if (-not $adjectives -or -not $nouns -or -not $verbs) {
+        return "unknown-session"
+    }
+
+    if (-not $uuid -or $uuid -eq "unknown") { return "unknown-session" }
+
+    $clean = $uuid -replace "-", ""
+    if ($clean.Length -lt 6) { return "unknown-session" }
+
+    try {
+        $a = [Convert]::ToInt32($clean.Substring(0,2), 16) % $adjectives.Length
+        $n = [Convert]::ToInt32($clean.Substring(2,2), 16) % $nouns.Length
+        $an = [Convert]::ToInt32($clean.Substring(4,2), 16) % $verbs.Length
+
+        return "$($adjectives[$a])-$($nouns[$n])-$($verbs[$an])"
+    } catch {
+        return "unknown-session"
+    }
+}
+
+# ═══════════════════════════════════════════════════════════════════════════
+# READ INPUT
+# ═══════════════════════════════════════════════════════════════════════════
 $inputJson = [Console]::In.ReadToEnd()
 
-# Clean up state
+# Get session ID from state
 $stateFile = Join-Path $env:USERPROFILE ".claude\state\hook-state.json"
+$sessionFile = Join-Path $env:USERPROFILE ".claude\state\current-session.json"
+$rawSessionId = "unknown"
+$turn = 0
+
+if (Test-Path $stateFile) {
+    try {
+        $hookState = Get-Content $stateFile -Raw | ConvertFrom-Json
+        $rawSessionId = $hookState.session_id
+        $turn = [int]$hookState.turn
+    } catch {}
+}
+
+if ($rawSessionId -eq "unknown" -and (Test-Path $sessionFile)) {
+    try {
+        $sessionData = Get-Content $sessionFile -Raw | ConvertFrom-Json
+        $rawSessionId = $sessionData.session_id
+    } catch {}
+}
+
+$sessionName = Convert-UuidToWords $rawSessionId
+
+# ═══════════════════════════════════════════════════════════════════════════
+# LOCAL CACHE: ACK turn to mark as synced
+# Per v1.2 ADDENDUM: Pass instanceId for namespacing
+# ═══════════════════════════════════════════════════════════════════════════
+$captureCmd = Get-Command "ekkos-capture" -ErrorAction SilentlyContinue
+if ($captureCmd -and $rawSessionId -ne "unknown") {
+    try {
+        # ACK format: ekkos-capture ack <session_id> <turn_id> --instance=ID
+        Start-Job -ScriptBlock {
+            param($instanceId, $sessionId, $turnNum)
+            try {
+                & ekkos-capture ack $sessionId $turnNum "--instance=$instanceId" 2>&1 | Out-Null
+            } catch {}
+        } -ArgumentList $EkkosInstanceId, $rawSessionId, $turn | Out-Null
+    } catch {}
+}
+
+# ═══════════════════════════════════════════════════════════════════════════
+# CLEAN UP STATE FILES
+# ═══════════════════════════════════════════════════════════════════════════
 if (Test-Path $stateFile) {
     Remove-Item $stateFile -Force
 }