@ekkos/cli 0.2.8 → 0.2.10

package/templates/project-stubs/session-start.ps1

@@ -0,0 +1,63 @@
+# ═══════════════════════════════════════════════════════════════════════════
+# ekkOS Project Hook Stub: session-start.ps1
+# EKKOS_MANAGED=1
+# EKKOS_MANIFEST_SHA256=project-stub-v1
+# EKKOS_TEMPLATE_VERSION=1.0.0
+#
+# This is a DELEGATING STUB that:
+# 1. Executes the global hook first
+# 2. Then loads project-specific overrides if present
+#
+# Do not modify this file directly. Customizations go in:
+#   <project>\.ekkos\hooks.local.ps1
+# ═══════════════════════════════════════════════════════════════════════════
+
+$ErrorActionPreference = 'Stop'
+
+# ═══════════════════════════════════════════════════════════════════════════
+# RESOLVE PATHS
+# ═══════════════════════════════════════════════════════════════════════════
+
+# Get absolute path to this stub
+$StubPath = $PSScriptRoot
+$StubFile = $MyInvocation.MyCommand.Path
+
+# Project root is two levels up from .claude\hooks\
+$ProjectRoot = (Get-Item "$StubPath\..\..").FullName
+
+# Global hooks directory
+$GlobalHooksDir = Join-Path $env:USERPROFILE ".claude\hooks"
+
+# Global hook path
+$GlobalHook = Join-Path $GlobalHooksDir "session-start.ps1"
+
+# Project override file
+$ProjectOverride = Join-Path $ProjectRoot ".ekkos\hooks.local.ps1"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# EXECUTE GLOBAL HOOK
+# ═══════════════════════════════════════════════════════════════════════════
+
+if (Test-Path $GlobalHook) {
+    try {
+        # Dot-source the global hook (inherits all env vars and args)
+        . $GlobalHook
+    } catch {
+        Write-Error "[ekkOS] Error executing global hook: $_"
+    }
+} else {
+    Write-Warning "[ekkOS] Global hook not found: $GlobalHook"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════
+# LOAD PROJECT OVERRIDES (optional)
+# ═══════════════════════════════════════════════════════════════════════════
+
+if (Test-Path $ProjectOverride) {
+    try {
+        # Dot-source project-specific customizations
+        . $ProjectOverride
+    } catch {
+        Write-Warning "[ekkOS] Error loading project override: $_"
+    }
+}

package/templates/project-stubs/session-start.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════════════════════
+# ekkOS Project Hook Stub: session-start.sh
+# EKKOS_MANAGED=1
+# EKKOS_MANIFEST_SHA256=project-stub-v1
+# EKKOS_TEMPLATE_VERSION=1.0.0
+#
+# This is a DELEGATING STUB that:
+# 1. Executes the global hook first
+# 2. Then loads project-specific overrides if present
+#
+# Do not modify this file directly. Customizations go in:
+#   <project>/.ekkos/hooks.local.sh
+# ═══════════════════════════════════════════════════════════════════════════
+set -euo pipefail
+
+# ═══════════════════════════════════════════════════════════════════════════
+# RESOLVE PATHS
+# ═══════════════════════════════════════════════════════════════════════════
+
+# Get absolute path to this stub
+STUB_PATH="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/$(basename "${BASH_SOURCE[0]}")"
+
+# Project root is two levels up from .claude/hooks/
+PROJECT_ROOT="$(cd "$(dirname "$STUB_PATH")/../.." && pwd)"
+
+# Global hooks directory
+GLOBAL_HOOKS_DIR="$HOME/.claude/hooks"
+
+# Global hook path
+GLOBAL_HOOK="$GLOBAL_HOOKS_DIR/session-start.sh"
+
+# Project override file
+PROJECT_OVERRIDE="$PROJECT_ROOT/.ekkos/hooks.local.sh"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# EXECUTE GLOBAL HOOK
+# ═══════════════════════════════════════════════════════════════════════════
+
+if [ -f "$GLOBAL_HOOK" ] && [ -x "$GLOBAL_HOOK" ]; then
+    # Source the global hook (inherits all env vars and args)
+    source "$GLOBAL_HOOK"
+else
+    echo "[ekkOS] Warning: Global hook not found: $GLOBAL_HOOK" >&2
+fi
+
+# ═══════════════════════════════════════════════════════════════════════════
+# LOAD PROJECT OVERRIDES (optional)
+# ═══════════════════════════════════════════════════════════════════════════
+
+if [ -f "$PROJECT_OVERRIDE" ]; then
+    # Source project-specific customizations
+    # These can override functions or add project-specific behavior
+    source "$PROJECT_OVERRIDE"
+fi

package/templates/project-stubs/stop.ps1

@@ -0,0 +1,63 @@
+# ═══════════════════════════════════════════════════════════════════════════
+# ekkOS Project Hook Stub: stop.ps1
+# EKKOS_MANAGED=1
+# EKKOS_MANIFEST_SHA256=project-stub-v1
+# EKKOS_TEMPLATE_VERSION=1.0.0
+#
+# This is a DELEGATING STUB that:
+# 1. Executes the global hook first
+# 2. Then loads project-specific overrides if present
+#
+# Do not modify this file directly. Customizations go in:
+#   <project>\.ekkos\hooks.local.ps1
+# ═══════════════════════════════════════════════════════════════════════════
+
+$ErrorActionPreference = 'Stop'
+
+# ═══════════════════════════════════════════════════════════════════════════
+# RESOLVE PATHS
+# ═══════════════════════════════════════════════════════════════════════════
+
+# Get absolute path to this stub
+$StubPath = $PSScriptRoot
+$StubFile = $MyInvocation.MyCommand.Path
+
+# Project root is two levels up from .claude\hooks\
+$ProjectRoot = (Get-Item "$StubPath\..\..").FullName
+
+# Global hooks directory
+$GlobalHooksDir = Join-Path $env:USERPROFILE ".claude\hooks"
+
+# Global hook path
+$GlobalHook = Join-Path $GlobalHooksDir "stop.ps1"
+
+# Project override file
+$ProjectOverride = Join-Path $ProjectRoot ".ekkos\hooks.local.ps1"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# EXECUTE GLOBAL HOOK
+# ═══════════════════════════════════════════════════════════════════════════
+
+if (Test-Path $GlobalHook) {
+    try {
+        # Dot-source the global hook (inherits all env vars and args)
+        . $GlobalHook
+    } catch {
+        Write-Error "[ekkOS] Error executing global hook: $_"
+    }
+} else {
+    Write-Warning "[ekkOS] Global hook not found: $GlobalHook"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════
+# LOAD PROJECT OVERRIDES (optional)
+# ═══════════════════════════════════════════════════════════════════════════
+
+if (Test-Path $ProjectOverride) {
+    try {
+        # Dot-source project-specific customizations
+        . $ProjectOverride
+    } catch {
+        Write-Warning "[ekkOS] Error loading project override: $_"
+    }
+}

package/templates/project-stubs/stop.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════════════════════
+# ekkOS Project Hook Stub: stop.sh
+# EKKOS_MANAGED=1
+# EKKOS_MANIFEST_SHA256=project-stub-v1
+# EKKOS_TEMPLATE_VERSION=1.0.0
+#
+# This is a DELEGATING STUB that:
+# 1. Executes the global hook first
+# 2. Then loads project-specific overrides if present
+#
+# Do not modify this file directly. Customizations go in:
+#   <project>/.ekkos/hooks.local.sh
+# ═══════════════════════════════════════════════════════════════════════════
+set -euo pipefail
+
+# ═══════════════════════════════════════════════════════════════════════════
+# RESOLVE PATHS
+# ═══════════════════════════════════════════════════════════════════════════
+
+# Get absolute path to this stub
+STUB_PATH="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/$(basename "${BASH_SOURCE[0]}")"
+
+# Project root is two levels up from .claude/hooks/
+PROJECT_ROOT="$(cd "$(dirname "$STUB_PATH")/../.." && pwd)"
+
+# Global hooks directory
+GLOBAL_HOOKS_DIR="$HOME/.claude/hooks"
+
+# Global hook path
+GLOBAL_HOOK="$GLOBAL_HOOKS_DIR/stop.sh"
+
+# Project override file
+PROJECT_OVERRIDE="$PROJECT_ROOT/.ekkos/hooks.local.sh"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# EXECUTE GLOBAL HOOK
+# ═══════════════════════════════════════════════════════════════════════════
+
+if [ -f "$GLOBAL_HOOK" ] && [ -x "$GLOBAL_HOOK" ]; then
+    # Source the global hook (inherits all env vars and args)
+    source "$GLOBAL_HOOK"
+else
+    echo "[ekkOS] Warning: Global hook not found: $GLOBAL_HOOK" >&2
+fi
+
+# ═══════════════════════════════════════════════════════════════════════════
+# LOAD PROJECT OVERRIDES (optional)
+# ═══════════════════════════════════════════════════════════════════════════
+
+if [ -f "$PROJECT_OVERRIDE" ]; then
+    # Source project-specific customizations
+    # These can override functions or add project-specific behavior
+    source "$PROJECT_OVERRIDE"
+fi

package/templates/project-stubs/user-prompt-submit.ps1

@@ -0,0 +1,63 @@
+# ═══════════════════════════════════════════════════════════════════════════
+# ekkOS Project Hook Stub: user-prompt-submit.ps1
+# EKKOS_MANAGED=1
+# EKKOS_MANIFEST_SHA256=project-stub-v1
+# EKKOS_TEMPLATE_VERSION=1.0.0
+#
+# This is a DELEGATING STUB that:
+# 1. Executes the global hook first
+# 2. Then loads project-specific overrides if present
+#
+# Do not modify this file directly. Customizations go in:
+#   <project>\.ekkos\hooks.local.ps1
+# ═══════════════════════════════════════════════════════════════════════════
+
+$ErrorActionPreference = 'Stop'
+
+# ═══════════════════════════════════════════════════════════════════════════
+# RESOLVE PATHS
+# ═══════════════════════════════════════════════════════════════════════════
+
+# Get absolute path to this stub
+$StubPath = $PSScriptRoot
+$StubFile = $MyInvocation.MyCommand.Path
+
+# Project root is two levels up from .claude\hooks\
+$ProjectRoot = (Get-Item "$StubPath\..\..").FullName
+
+# Global hooks directory
+$GlobalHooksDir = Join-Path $env:USERPROFILE ".claude\hooks"
+
+# Global hook path
+$GlobalHook = Join-Path $GlobalHooksDir "user-prompt-submit.ps1"
+
+# Project override file
+$ProjectOverride = Join-Path $ProjectRoot ".ekkos\hooks.local.ps1"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# EXECUTE GLOBAL HOOK
+# ═══════════════════════════════════════════════════════════════════════════
+
+if (Test-Path $GlobalHook) {
+    try {
+        # Dot-source the global hook (inherits all env vars and args)
+        . $GlobalHook
+    } catch {
+        Write-Error "[ekkOS] Error executing global hook: $_"
+    }
+} else {
+    Write-Warning "[ekkOS] Global hook not found: $GlobalHook"
+}
+
+# ═══════════════════════════════════════════════════════════════════════════
+# LOAD PROJECT OVERRIDES (optional)
+# ═══════════════════════════════════════════════════════════════════════════
+
+if (Test-Path $ProjectOverride) {
+    try {
+        # Dot-source project-specific customizations
+        . $ProjectOverride
+    } catch {
+        Write-Warning "[ekkOS] Error loading project override: $_"
+    }
+}

package/templates/project-stubs/user-prompt-submit.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════════════════════
+# ekkOS Project Hook Stub: user-prompt-submit.sh
+# EKKOS_MANAGED=1
+# EKKOS_MANIFEST_SHA256=project-stub-v1
+# EKKOS_TEMPLATE_VERSION=1.0.0
+#
+# This is a DELEGATING STUB that:
+# 1. Executes the global hook first
+# 2. Then loads project-specific overrides if present
+#
+# Do not modify this file directly. Customizations go in:
+#   <project>/.ekkos/hooks.local.sh
+# ═══════════════════════════════════════════════════════════════════════════
+set -euo pipefail
+
+# ═══════════════════════════════════════════════════════════════════════════
+# RESOLVE PATHS
+# ═══════════════════════════════════════════════════════════════════════════
+
+# Get absolute path to this stub
+STUB_PATH="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/$(basename "${BASH_SOURCE[0]}")"
+
+# Project root is two levels up from .claude/hooks/
+PROJECT_ROOT="$(cd "$(dirname "$STUB_PATH")/../.." && pwd)"
+
+# Global hooks directory
+GLOBAL_HOOKS_DIR="$HOME/.claude/hooks"
+
+# Global hook path
+GLOBAL_HOOK="$GLOBAL_HOOKS_DIR/user-prompt-submit.sh"
+
+# Project override file
+PROJECT_OVERRIDE="$PROJECT_ROOT/.ekkos/hooks.local.sh"
+
+# ═══════════════════════════════════════════════════════════════════════════
+# EXECUTE GLOBAL HOOK
+# ═══════════════════════════════════════════════════════════════════════════
+
+if [ -f "$GLOBAL_HOOK" ] && [ -x "$GLOBAL_HOOK" ]; then
+    # Source the global hook (inherits all env vars and args)
+    source "$GLOBAL_HOOK"
+else
+    echo "[ekkOS] Warning: Global hook not found: $GLOBAL_HOOK" >&2
+fi
+
+# ═══════════════════════════════════════════════════════════════════════════
+# LOAD PROJECT OVERRIDES (optional)
+# ═══════════════════════════════════════════════════════════════════════════
+
+if [ -f "$PROJECT_OVERRIDE" ]; then
+    # Source project-specific customizations
+    # These can override functions or add project-specific behavior
+    source "$PROJECT_OVERRIDE"
+fi

package/templates/shared/hooks-enabled.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": 1,
+  "updatedAt": "2026-01-18T00:00:00Z",
+  "targets": {
+    "claude": {
+      "user-prompt-submit": true,
+      "assistant-response": true,
+      "stop": true,
+      "session-start": true
+    },
+    "cursor": {
+      "enabled": true
+    },
+    "windsurf": {
+      "enabled": true
+    }
+  },
+  "redaction": {
+    "enabled": true,
+    "mode": "safe"
+  }
+}

package/templates/shared/session-words.json

@@ -0,0 +1,45 @@
+{
+  "schemaVersion": 2,
+  "updatedAt": "2026-01-18T00:00:00Z",
+  "adjectives": [
+    "ace", "big", "blu", "coy", "dex",
+    "eco", "fab", "gem", "hex", "ice",
+    "jet", "key", "lux", "max", "neo",
+    "oak", "pop", "rad", "sky", "top",
+    "uno", "vex", "wax", "xen", "zen",
+    "hot", "red", "nox", "sol", "vim",
+    "ash", "dew", "fog", "glo", "ink",
+    "joy", "koi", "lit", "mox", "nix",
+    "orb", "pix", "qix", "rox", "sly",
+    "tek", "ulu", "vox", "wiz", "zap"
+  ],
+  "nouns": [
+    "ant", "bat", "cat", "dog", "elk",
+    "fox", "gnu", "hen", "imp", "jay",
+    "kit", "lex", "moo", "nub", "owl",
+    "pug", "ram", "sun", "tux", "urn",
+    "van", "web", "yak", "zed", "ape",
+    "bee", "cod", "doe", "eel", "fin",
+    "gup", "hog", "ion", "jab", "keg",
+    "log", "mud", "net", "oat", "pod",
+    "rye", "sap", "tar", "vat", "wok",
+    "box", "cub", "dip", "gem", "hub"
+  ],
+  "verbs": [
+    "ask", "bet", "cut", "dig", "eat",
+    "fix", "get", "hit", "jab", "key",
+    "let", "mix", "nap", "opt", "pop",
+    "run", "set", "tap", "use", "vet",
+    "win", "zip", "zap", "add", "bid",
+    "dub", "end", "fly", "gig", "hum",
+    "jog", "lob", "map", "net", "orb",
+    "pay", "rip", "sip", "tag", "vow",
+    "wag", "yap", "bow", "cue", "dip",
+    "fan", "hop", "jam", "nod", "tug"
+  ],
+  "rules": {
+    "format": "{adj}-{noun}-{verb}",
+    "minPerList": 25,
+    "maxPerList": 500
+  }
+}