@ekkos/cli 1.2.18 → 1.3.0

package/templates/project-stubs/stop.ps1

@@ -1,63 +0,0 @@
-# ═══════════════════════════════════════════════════════════════════════════
-# 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

@@ -1,55 +0,0 @@
-#!/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

@@ -1,63 +0,0 @@
-# ═══════════════════════════════════════════════════════════════════════════
-# 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

@@ -1,55 +0,0 @@
-#!/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/windsurf-hooks/README.md

@@ -1,212 +0,0 @@
-# ekkOS Windsurf Cascade Hooks
-
-Complete Golden Loop integration for Windsurf Cascade with proactive memory retrieval, PatternGuard enforcement, and automatic turn capture.
-
-## Features
-
-- **Proactive Memory Retrieval**: Automatically retrieves patterns from all 8 memory layers before each prompt
-- **Endless Context**: Auto-restores conversation context after context compaction (10+ min gaps)
-- **Time Machine**: Supports "Continue from here" to restore past sessions
-- **PatternGuard**: Enforces 100% pattern acknowledgment with SELECT/SKIP markers
-- **Footer Enforcement**: Requires ekkOS™ branded timestamp footer on all responses
-- **Golden Loop Compliance**: Turn contracts, validation, and outcome tracking
-
-## Installation
-
-### 1. Copy hooks to your project
-
-```bash
-# From your project root
-cp -r /path/to/ekkos/templates/windsurf-hooks .windsurf/
-```
-
-### 2. Configure Windsurf hooks
-
-Create `.windsurf/hooks.json` in your project root:
-
-```json
-{
-  "version": 1,
-  "hooks": {
-    "pre_user_prompt": [
-      {
-        "command": "./.windsurf/hooks/pre-user-prompt.sh",
-        "show_output": false
-      }
-    ],
-    "post_cascade_response": [
-      {
-        "command": "./.windsurf/hooks/post-cascade-response.sh",
-        "show_output": false
-      }
-    ]
-  }
-}
-```
-
-### 3. Authenticate ekkOS
-
-Ensure you have a valid ekkOS config:
-
-```bash
-# Check your auth
-cat ~/.ekkos/config.json
-```
-
-If not configured, run `ekkOS: Connect` in VS Code to set up authentication.
-
-### 4. Test the integration
-
-Open Cascade and ask a technical question. You should see:
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🧠 ekkOS™ Memory Substrate
-✓ 3 patterns loaded from memory
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-## How It Works
-
-### Hook Flow
-
-```
-User Prompt
-    ↓
-pre_user_prompt hook
-    ├─ Retrieves patterns from ekkOS API
-    ├─ Checks for Time Machine requests
-    ├─ Auto-restores Endless Context (if gap detected)
-    ├─ Writes turn contract
-    └─ Injects patterns + footer requirement
-    ↓
-Cascade processes augmented prompt
-    ↓
-Cascade generates response
-    ↓
-post_cascade_response hook
-    ├─ Validates PatternGuard (acknowledgments)
-    ├─ Checks footer presence
-    ├─ Captures turn to L2 episodic memory
-    ├─ Tracks pattern outcomes
-    └─ Reports compliance status
-```
-
-### Golden Loop Enforcement
-
-**RETRIEVE** (pre_user_prompt):
-- Searches all 8 memory layers
-- Returns patterns with IDs
-- Writes turn contract as evidence
-
-**ACKNOWLEDGE** (Cascade response must include):
-```
-[ekkOS_SELECT]
-- id: <pattern-uuid>
-  reason: <why using>
-  confidence: <0.0-1.0>
-[/ekkOS_SELECT]
-
-[ekkOS_SKIP]
-- id: <pattern-uuid>
-  reason: <why not relevant>
-[/ekkOS_SKIP]
-```
-
-**FOOTER** (required on all responses):
-```
-🧠 **ekkOS_™** · 📅 YYYY-MM-DD H:MM AM/PM TZ
-```
-
-**CAPTURE** (post_cascade_response):
-- Stores turn in episodic memory (L2)
-- Validates compliance
-- Tracks pattern usage outcomes
-
-## Configuration Options
-
-### Strict Mode
-
-Set `EKKOS_STRICT=1` to block turns when retrieval fails:
-
-```bash
-export EKKOS_STRICT=1
-```
-
-### Auth Sources (priority order)
-
-1. `~/.ekkos/config.json` (preferred - set by VS Code extension)
-2. Project `.env.local` (SUPABASE_SECRET_KEY)
-3. Environment variable `SUPABASE_SECRET_KEY`
-
-### Hook Locations
-
-Cascade merges hooks from all locations (system → user → workspace):
-
-- **System**: `/Library/Application Support/Windsurf/hooks.json` (macOS)
-- **User**: `~/.codeium/windsurf/hooks.json`
-- **Workspace**: `.windsurf/hooks.json` (project-specific)
-
-## File Structure
-
-```
-.windsurf/
-├── hooks.json                    # Hook configuration
-└── hooks/
-    ├── pre-user-prompt.sh        # Retrieval + injection
-    ├── post-cascade-response.sh  # Capture + validation
-    └── lib/
-        └── contract.sh           # Turn contract library
-```
-
-## Troubleshooting
-
-### "No auth token" message
-
-1. Run `ekkOS: Connect` in VS Code
-2. Check `~/.ekkos/config.json` exists with `hookApiKey` or `apiKey`
-3. Verify the key is valid at https://platform.ekkos.dev
-
-### Hooks not firing
-
-1. Check file permissions: `chmod +x .windsurf/hooks/*.sh`
-2. Verify JSON syntax in `hooks.json`
-3. Check Windsurf logs: Cascade toolbar → Settings → Download diagnostics
-4. Ensure `jq` is installed: `which jq`
-
-### Patterns not loading
-
-1. Test API health: `curl https://mcp.ekkos.dev/api/v1/gateway/health`
-2. Check network connectivity
-3. Verify auth token has access to your user data
-
-### Footer enforcement not working
-
-The footer check is in `post_cascade_response`. Non-compliance is logged but doesn't block the response (unless STRICT mode is on). Check your responses include:
-- The 🧠 emoji
-- `ekkOS` text
-- 📅 date stamp
-
-## Comparison: Windsurf vs Cursor/Claude Code
-
-| Feature | Windsurf Hooks | Cursor Hooks | Claude Code |
-|---------|----------------|--------------|-------------|
-| Hook names | `pre_user_prompt`, `post_cascade_response` | `beforeSubmitPrompt`, `afterAgentResponse` | `.claude/` scripts |
-| Auto-inject | ✅ Yes | ✅ Yes | ✅ Yes |
-| Endless Context | ✅ Yes | ✅ Yes | ✅ Yes |
-| Time Machine | ✅ Yes | ✅ Yes | ✅ Yes |
-| PatternGuard | ✅ Yes | ✅ Yes | ✅ Yes |
-| Footer required | ✅ Yes | ✅ Yes | ✅ Yes |
-
-## API Endpoints Used
-
-- `POST /api/v1/context/retrieve` - Pattern retrieval
-- `POST /api/v1/capture` - Turn storage
-- `POST /api/v1/turns/recall` - Endless Context restoration
-- `GET /api/v1/context/restore-request/pending` - Time Machine check
-- `POST /api/v1/context/restore-request/consume` - Time Machine consume
-- `POST /api/v1/patterns/outcome` - Pattern outcome tracking
-
-## License
-
-Part of the ekkOS memory system. See main repository for license details.

package/templates/windsurf-hooks/hooks.json

@@ -1,17 +0,0 @@
-{
-  "version": 1,
-  "hooks": {
-    "pre_user_prompt": [
-      {
-        "command": "./.windsurf/hooks/pre-user-prompt.sh",
-        "show_output": false
-      }
-    ],
-    "post_cascade_response": [
-      {
-        "command": "./.windsurf/hooks/post-cascade-response.sh",
-        "show_output": false
-      }
-    ]
-  }
-}

package/templates/windsurf-hooks/install.sh

@@ -1,148 +0,0 @@
-#!/bin/bash
-# ═══════════════════════════════════════════════════════════════════════════
-# ekkOS Windsurf Hooks Installer
-# ═══════════════════════════════════════════════════════════════════════════
-#
-# Usage: ./install.sh [--global]
-#   --global: Install to ~/.windsurf/ (works in all projects)
-#   (default): Install to ./.windsurf/ (project-level only)
-#
-# ═══════════════════════════════════════════════════════════════════════════
-
-set -e
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Parse arguments
-GLOBAL_INSTALL=false
-if [ "$1" = "--global" ]; then
-  GLOBAL_INSTALL=true
-fi
-
-# Get script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Determine install location
-if [ "$GLOBAL_INSTALL" = true ]; then
-  WINDSURF_DIR="$HOME/.windsurf"
-  echo -e "${BLUE}🧠 ekkOS Windsurf Hooks Installer (GLOBAL)${NC}"
-  echo -e "${BLUE}📍 Installing to: $WINDSURF_DIR/${NC}"
-else
-  WINDSURF_DIR="./.windsurf"
-  echo -e "${BLUE}🧠 ekkOS Windsurf Hooks Installer (Project-level)${NC}"
-fi
-
-echo "═══════════════════════════════════════════════════════════════════"
-
-# Check if running in a project (only for local install)
-if [ "$GLOBAL_INSTALL" = false ]; then
-  if [ ! -d ".git" ] && [ ! -f "package.json" ] && [ ! -f "Cargo.toml" ] && [ ! -f "pyproject.toml" ]; then
-    echo -e "${YELLOW}⚠️  Warning: No project files detected. Make sure you're in a project root.${NC}"
-    read -p "Continue anyway? (y/N) " -n 1 -r
-    echo
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-      exit 1
-    fi
-  fi
-fi
-
-# Check for jq
-if ! command -v jq &> /dev/null; then
-  echo -e "${RED}❌ jq is required but not installed.${NC}"
-  echo "   Install with: brew install jq (macOS) or apt-get install jq (Linux)"
-  exit 1
-fi
-
-# Check for curl
-if ! command -v curl &> /dev/null; then
-  echo -e "${RED}❌ curl is required but not installed.${NC}"
-  exit 1
-fi
-
-# Create .windsurf directory
-echo -e "${BLUE}📁 Creating .windsurf directory...${NC}"
-mkdir -p "$WINDSURF_DIR/hooks/lib"
-
-# Copy hook files
-echo -e "${BLUE}📄 Copying hook files...${NC}"
-cp "$SCRIPT_DIR/hooks.json" "$WINDSURF_DIR/hooks.json"
-cp "$SCRIPT_DIR/pre-user-prompt.sh" "$WINDSURF_DIR/hooks/"
-cp "$SCRIPT_DIR/post-cascade-response.sh" "$WINDSURF_DIR/hooks/"
-cp "$SCRIPT_DIR/lib/contract.sh" "$WINDSURF_DIR/hooks/lib/"
-
-# Make scripts executable
-echo -e "${BLUE}🔧 Setting permissions...${NC}"
-chmod +x "$WINDSURF_DIR/hooks/"*.sh
-chmod +x "$WINDSURF_DIR/hooks/lib/"*.sh
-
-# Check for ekkOS auth
-echo -e "${BLUE}🔐 Checking ekkOS authentication...${NC}"
-EKKOS_CONFIG="$HOME/.ekkos/config.json"
-
-if [ -f "$EKKOS_CONFIG" ]; then
-  if jq -e '.hookApiKey // .apiKey' "$EKKOS_CONFIG" > /dev/null 2>&1; then
-    echo -e "${GREEN}✅ ekkOS auth found in ~/.ekkos/config.json${NC}"
-  else
-    echo -e "${YELLOW}⚠️  ~/.ekkos/config.json exists but no API key found${NC}"
-    echo "   Run 'ekkOS: Connect' in VS Code to authenticate"
-  fi
-else
-  echo -e "${YELLOW}⚠️  No ekkOS config found${NC}"
-  echo "   Run 'ekkOS: Connect' in VS Code to authenticate"
-fi
-
-# Test API connectivity
-echo -e "${BLUE}🌐 Testing ekkOS API connectivity...${NC}"
-if curl -s --connect-timeout 3 https://mcp.ekkos.dev/api/v1/gateway/health > /dev/null 2>&1; then
-  echo -e "${GREEN}✅ ekkOS API is reachable${NC}"
-else
-  echo -e "${YELLOW}⚠️  Could not reach ekkOS API (may be network issues)${NC}"
-fi
-
-# Summary
-echo ""
-echo -e "${GREEN}✅ Installation complete!${NC}"
-echo "═══════════════════════════════════════════════════════════════════"
-echo ""
-
-if [ "$GLOBAL_INSTALL" = true ]; then
-  echo "📂 Installed files (GLOBAL - works in ALL projects):"
-  echo "   ~/.windsurf/hooks.json"
-  echo "   ~/.windsurf/hooks/pre-user-prompt.sh"
-  echo "   ~/.windsurf/hooks/post-cascade-response.sh"
-  echo "   ~/.windsurf/hooks/lib/contract.sh"
-  echo ""
-  echo "🚀 Next steps:"
-  echo "   1. Open any project in Windsurf Cascade"
-  echo "   2. Ask a technical question"
-  echo "   3. You should see: '🧠 ekkOS™ Memory Substrate' header"
-  echo ""
-  echo "� To use in a specific project, create a symlink:"
-  echo "   ln -s ~/.windsurf ./.windsurf"
-else
-  echo "📂 Installed files (Project-level):"
-  echo "   .windsurf/hooks.json"
-  echo "   .windsurf/hooks/pre-user-prompt.sh"
-  echo "   .windsurf/hooks/post-cascade-response.sh"
-  echo "   .windsurf/hooks/lib/contract.sh"
-  echo ""
-  echo "🚀 Next steps:"
-  echo "   1. Open Windsurf Cascade in this project"
-  echo "   2. Ask a technical question"
-  echo "   3. You should see: '🧠 ekkOS™ Memory Substrate' header"
-  echo ""
-  # Git ignore suggestion
-  if [ -d ".git" ]; then
-    if ! grep -q ".windsurf/state" .gitignore 2>/dev/null; then
-      echo -e "${YELLOW}💡 Tip: Add '.windsurf/state' to your .gitignore${NC}"
-    fi
-  fi
-fi
-
-echo ""
-echo "📖 For more info: cat ~/.windsurf/hooks/README.md"