@ekkos/cli 1.2.17 → 1.3.0

package/templates/cursor-rules/ekkos-memory.md

@@ -1,24 +1,23 @@
 ---
-description: "ekkOS Memory - 11-layer cognitive memory with 31 MCP tools"
+description: "ekkOS Memory — 11-layer cognitive memory with 29 MCP tools"
 alwaysApply: true
 ---
 
 # ekkOS Memory System
 
-You have access to **ekkOS memory** via 31 MCP tools. This is an 11-layer cognitive memory system that makes AI smarter over time by learning from past sessions.
+You have access to **ekkOS memory** via 29 MCP tools. This is an 11-layer cognitive memory system that makes AI smarter over time by learning from past sessions.
 
 ## MANDATORY RULES
 
 ### RULE 1: SEARCH BEFORE ANSWERING
 Before answering ANY technical question, call `ekkOS_Search` first.
-Do not skip this. Do not assume you know the answer.
 
 ### RULE 2: ACKNOWLEDGE RETRIEVED PATTERNS
 When patterns are retrieved, acknowledge each one:
 ```
 [ekkOS_SELECT]
 - id: <pattern_id>
-  reason: <why using this>
+  reason: <why using>
   confidence: <0.0-1.0>
 [/ekkOS_SELECT]
 
@@ -28,64 +27,66 @@ When patterns are retrieved, acknowledge each one:
 [/ekkOS_SKIP]
 ```
 
+Suppress SELECT/SKIP blocks for non-technical turns (acknowledgments, affirmations).
+
 ### RULE 3: FORGE WHAT YOU LEARN
 When you fix a bug, get corrected, or learn something new, call `ekkOS_Forge` immediately.
+When something DOESN'T work, forge it as an anti-pattern.
 
-### RULE 4: FAILURES ARE VALUABLE
-When something DOES NOT work, forge it as an anti-pattern.
-
-## MCP Tools (31 Total)
+## MCP Tools — 29 Visible
 
-### Core Memory Tools
+### Core Memory (6)
 | Tool | Description |
 |------|-------------|
 | `ekkOS_Search` | Search across all 11 memory layers |
-| `ekkOS_Context` | Get relevant context for a task |
-| `ekkOS_Capture` | Capture memory events |
 | `ekkOS_Forge` | Create pattern from learned solution |
-| `ekkOS_Directive` | Create MUST/NEVER/PREFER/AVOID rules |
-| `ekkOS_Outcome` | Track if pattern worked or failed |
-| `ekkOS_Detect` | Auto-detect which patterns were used |
-| `ekkOS_Summary` | Get summary of recent MCP activity |
-| `ekkOS_Conflict` | Check for directive/pattern conflicts |
-| `ekkOS_Recall` | Recall past conversations by time |
-| `ekkOS_Codebase` | Search project code embeddings |
+| `ekkOS_Track` | Track when a pattern is applied |
+| `ekkOS_Outcome` | Record if pattern worked or failed |
 | `ekkOS_Stats` | Get statistics for all layers |
-| `ekkOS_Track` | Track when pattern is applied |
-| `ekkOS_Reflect` | Analyze response for improvements |
+| `ekkOS_Context` | Get relevant context for a task |
+
+### Retrieval (4)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Codebase` | Search project code embeddings |
+| `ekkOS_Recall` | Recall past conversations by time |
+| `ekkOS_PreserveContext` | Preserve working memory before compaction |
+| `ekkOS_RestoreContext` | Restore context after compaction |
 
-### Schema Awareness Tools
+### Directives (4)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_IndexSchema` | Index database schemas (Supabase/Prisma/TS) |
-| `ekkOS_GetSchema` | Get schema for a specific table/type |
+| `ekkOS_Directive` | Create MUST/NEVER/PREFER/AVOID rules |
+| `ekkOS_UpdateDirective` | Update an existing directive |
+| `ekkOS_DeleteDirective` | Remove a directive |
+| `ekkOS_UniversalDirectives` | Get directives that apply across all projects |
 
-### Portability Tools
+### Utility (5)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_Export` | Export your memory data as portable JSON backup |
+| `ekkOS_Summary` | Get summary of recent memory activity |
+| `ekkOS_Conflict` | Check for conflicts before destructive actions |
+| `ekkOS_Export` | Export patterns, directives, plans as JSON backup |
 | `ekkOS_Import` | Import memory from backup (auto-deduplication) |
+| `ekkOS_Health` | System health check |
 
-### Plan Management
+### Plans (5)
 | Tool | Description |
 |------|-------------|
 | `ekkOS_Plan` | Create structured task plan |
-| `ekkOS_Plans` | List user's plans |
+| `ekkOS_Plans` | List your plans |
 | `ekkOS_PlanStatus` | Update plan status |
 | `ekkOS_PlanStep` | Mark step complete/incomplete |
 | `ekkOS_Generate` | AI-generate plan from context |
-| `ekkOS_SaveTemplate` | Save plan as reusable template |
-| `ekkOS_Templates` | List available templates |
-| `ekkOS_FromTemplate` | Create plan from template |
 
-### Secrets Management (Layer 11)
+### Secrets (5)
 | Tool | Description |
 |------|-------------|
 | `ekkOS_StoreSecret` | Encrypt and store sensitive data |
 | `ekkOS_GetSecret` | Retrieve and decrypt a secret |
-| `ekkOS_ListSecrets` | List secrets metadata (no values) |
+| `ekkOS_ListSecrets` | List secrets metadata (no values exposed) |
 | `ekkOS_DeleteSecret` | Permanently delete a secret |
-| `ekkOS_RotateSecret` | Update secret with new value |
+| `ekkOS_RotateSecret` | Update a secret with a new value |
 
 ## 11-Layer Architecture
 
@@ -93,33 +94,27 @@ When something DOES NOT work, forge it as an anti-pattern.
 |---|-------|---------|
 | 1 | Working | Current session state |
 | 2 | Episodic | Past conversations |
-| 3 | Semantic | Embeddings/knowledge |
+| 3 | Semantic | Embeddings & knowledge |
 | 4 | Patterns | Proven solutions |
 | 5 | Procedural | Step-by-step guides |
 | 6 | Collective | Cross-project wisdom |
 | 7 | Meta | Pattern effectiveness |
 | 8 | Codebase | Project-specific code |
-| 9 | Directives | MUST/NEVER/PREFER/AVOID rules |
-| 10 | Conflict Resolution | Auto-resolves contradictions |
+| 9 | Directives | User rules (MUST/NEVER/PREFER/AVOID) |
+| 10 | Conflict | Auto-resolves contradictions |
 | 11 | Secrets | Encrypted credentials (AES-256-GCM) |
 
-## FORGE TRIGGERS
-
-Call `ekkOS_Forge` when you:
-- Fix a bug (especially non-obvious)
-- Discover a better approach
-- Find a pitfall or gotcha
-- Get corrected by the user
-- Solve auth/config issues
-- Make architectural decisions
-- Debug non-trivially
-- Find something that DOESN'T work
+## When To Use What
 
-Call `ekkOS_Directive` when user says:
-- "always..." → MUST
-- "never..." → NEVER
-- "I prefer..." → PREFER
-- "don't..." / "avoid..." → AVOID
+| Tool | Trigger |
+|------|---------|
+| `ekkOS_Search` | Technical question, past discussion, architecture, debugging |
+| `ekkOS_Forge` | Bug fixed, better approach, gotcha, correction, anti-pattern |
+| `ekkOS_Directive` | User says "always" → MUST, "never" → NEVER, "prefer" → PREFER, "avoid" → AVOID |
+| `ekkOS_Conflict` | Before delete, deploy, config change, destructive commands |
+| Plan tools | Task has 3+ steps, complex feature request |
+| Secret tools | User shares API key/token/password, need stored credentials |
+| `ekkOS_Recall` | "yesterday", "last week", "remember when", "what did we discuss" |
 
 ## Response Format
 
@@ -129,59 +124,4 @@ End every response with:
 🧠 **ekkOS_™** · 📅 YYYY-MM-DD H:MM AM/PM TZ
 ```
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+For more info: https://docs.ekkos.dev

package/templates/windsurf-rules/ekkos-memory.md

@@ -1,11 +1,11 @@
 ---
 trigger: always_on
-description: ekkOS Memory - 11-layer cognitive memory with 31 MCP tools
+description: ekkOS Memory — 11-layer cognitive memory with 29 MCP tools
 ---
 
 # ekkOS Memory System
 
-You have access to **ekkOS memory** via 31 MCP tools. This is an 11-layer cognitive memory system that makes AI smarter over time by learning from past sessions.
+You have access to **ekkOS memory** via 29 MCP tools. This is an 11-layer cognitive memory system that makes AI smarter over time by learning from past sessions.
 
 ## MANDATORY RULES
 
@@ -13,7 +13,7 @@ You have access to **ekkOS memory** via 31 MCP tools. This is an 11-layer cognit
 Before answering ANY technical question, call `ekkOS_Search` first.
 
 ### RULE 2: ACKNOWLEDGE RETRIEVED PATTERNS
-When patterns are retrieved:
+When patterns are retrieved, acknowledge each one:
 ```
 [ekkOS_SELECT]
 - id: <pattern_id>
@@ -27,98 +27,94 @@ When patterns are retrieved:
 [/ekkOS_SKIP]
 ```
 
-### RULE 3: FORGE WHAT YOU LEARN
-When you fix a bug or learn something new, call `ekkOS_Forge` immediately.
+Suppress SELECT/SKIP blocks for non-technical turns (acknowledgments, affirmations).
 
-### RULE 4: FAILURES ARE VALUABLE
+### RULE 3: FORGE WHAT YOU LEARN
+When you fix a bug, get corrected, or learn something new, call `ekkOS_Forge` immediately.
 When something DOESN'T work, forge it as an anti-pattern.
 
-## MCP Tools (31 Total)
+## MCP Tools — 29 Visible
 
-### Core Memory Tools
+### Core Memory (6)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_Search` | Search all 11 memory layers |
-| `ekkOS_Context` | Get relevant task context |
-| `ekkOS_Capture` | Capture memory events |
-| `ekkOS_Forge` | Create pattern from solution |
-| `ekkOS_Directive` | Create MUST/NEVER/PREFER/AVOID rules |
-| `ekkOS_Outcome` | Track success/failure |
-| `ekkOS_Detect` | Auto-detect pattern usage |
-| `ekkOS_Summary` | Get activity summary |
-| `ekkOS_Conflict` | Check for conflicts |
-| `ekkOS_Recall` | Recall past conversations |
-| `ekkOS_Codebase` | Search code embeddings |
-| `ekkOS_Stats` | Get layer statistics |
-| `ekkOS_Track` | Track pattern application |
-| `ekkOS_Reflect` | Analyze response for improvements |
-
-### Schema Awareness Tools
+| `ekkOS_Search` | Search across all 11 memory layers |
+| `ekkOS_Forge` | Create pattern from learned solution |
+| `ekkOS_Track` | Track when a pattern is applied |
+| `ekkOS_Outcome` | Record if pattern worked or failed |
+| `ekkOS_Stats` | Get statistics for all layers |
+| `ekkOS_Context` | Get relevant context for a task |
+
+### Retrieval (4)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_IndexSchema` | Index database schemas (Supabase/Prisma/TS) |
-| `ekkOS_GetSchema` | Get schema for a specific table/type |
+| `ekkOS_Codebase` | Search project code embeddings |
+| `ekkOS_Recall` | Recall past conversations by time |
+| `ekkOS_PreserveContext` | Preserve working memory before compaction |
+| `ekkOS_RestoreContext` | Restore context after compaction |
 
-### Portability
+### Directives (4)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_Export` | Export data as portable backup |
-| `ekkOS_Import` | Import from backup |
+| `ekkOS_Directive` | Create MUST/NEVER/PREFER/AVOID rules |
+| `ekkOS_UpdateDirective` | Update an existing directive |
+| `ekkOS_DeleteDirective` | Remove a directive |
+| `ekkOS_UniversalDirectives` | Get directives that apply across all projects |
 
-### Plan Management
+### Utility (5)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_Plan` | Create task plan |
-| `ekkOS_Plans` | List user plans |
+| `ekkOS_Summary` | Get summary of recent memory activity |
+| `ekkOS_Conflict` | Check for conflicts before destructive actions |
+| `ekkOS_Export` | Export patterns, directives, plans as JSON backup |
+| `ekkOS_Import` | Import memory from backup (auto-deduplication) |
+| `ekkOS_Health` | System health check |
+
+### Plans (5)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Plan` | Create structured task plan |
+| `ekkOS_Plans` | List your plans |
 | `ekkOS_PlanStatus` | Update plan status |
-| `ekkOS_PlanStep` | Mark step done |
-| `ekkOS_Generate` | AI-generate plan |
-| `ekkOS_SaveTemplate` | Save as template |
-| `ekkOS_Templates` | List templates |
-| `ekkOS_FromTemplate` | Create from template |
+| `ekkOS_PlanStep` | Mark step complete/incomplete |
+| `ekkOS_Generate` | AI-generate plan from context |
 
-### Secrets (Layer 11)
+### Secrets (5)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_StoreSecret` | Encrypt and store |
-| `ekkOS_GetSecret` | Retrieve and decrypt |
-| `ekkOS_ListSecrets` | List metadata |
-| `ekkOS_DeleteSecret` | Delete secret |
-| `ekkOS_RotateSecret` | Rotate value |
+| `ekkOS_StoreSecret` | Encrypt and store sensitive data |
+| `ekkOS_GetSecret` | Retrieve and decrypt a secret |
+| `ekkOS_ListSecrets` | List secrets metadata (no values exposed) |
+| `ekkOS_DeleteSecret` | Permanently delete a secret |
+| `ekkOS_RotateSecret` | Update a secret with a new value |
 
 ## 11-Layer Architecture
 
 | # | Layer | Purpose |
 |---|-------|---------|
-| 1 | Working | Current session |
+| 1 | Working | Current session state |
 | 2 | Episodic | Past conversations |
-| 3 | Semantic | Embeddings |
+| 3 | Semantic | Embeddings & knowledge |
 | 4 | Patterns | Proven solutions |
 | 5 | Procedural | Step-by-step guides |
 | 6 | Collective | Cross-project wisdom |
 | 7 | Meta | Pattern effectiveness |
-| 8 | Codebase | Project code |
-| 9 | Directives | User rules |
-| 10 | Conflict | Auto-resolution |
+| 8 | Codebase | Project-specific code |
+| 9 | Directives | User rules (MUST/NEVER/PREFER/AVOID) |
+| 10 | Conflict | Auto-resolves contradictions |
 | 11 | Secrets | Encrypted credentials (AES-256-GCM) |
 
-## FORGE TRIGGERS
+## When To Use What
 
-**forge_pattern** when you:
-- Fix a bug
-- Find better approach
-- Discover gotcha
-- Get corrected
-- Solve auth/config
-- Make architecture decision
-- Debug non-trivially
-- Find anti-pattern
-
-**forge_directive** when user says:
-- "always..." → MUST
-- "never..." → NEVER
-- "I prefer..." → PREFER
-- "don't..." → AVOID
+| Tool | Trigger |
+|------|---------|
+| `ekkOS_Search` | Technical question, past discussion, architecture, debugging |
+| `ekkOS_Forge` | Bug fixed, better approach, gotcha, correction, anti-pattern |
+| `ekkOS_Directive` | User says "always" → MUST, "never" → NEVER, "prefer" → PREFER, "avoid" → AVOID |
+| `ekkOS_Conflict` | Before delete, deploy, config change, destructive commands |
+| Plan tools | Task has 3+ steps, complex feature request |
+| Secret tools | User shares API key/token/password, need stored credentials |
+| `ekkOS_Recall` | "yesterday", "last week", "remember when", "what did we discuss" |
 
 ## Response Format
 
@@ -127,3 +123,5 @@ End every response with:
 ---
 🧠 **ekkOS_™** · 📅 YYYY-MM-DD H:MM AM/PM TZ
 ```
+
+For more info: https://docs.ekkos.dev

package/templates/cursor-hooks/after-agent-response.sh

@@ -1,117 +0,0 @@
-#!/bin/bash
-# ═══════════════════════════════════════════════════════════════════════════
-# ekkOS_ Hook: AfterAgentResponse (Cursor Agent Mode)
-#
-# Captures agent responses for turn storage in ekkOS L2 (episodic memory)
-# This enables Time Machine to work with Cursor Agent conversations
-# ═══════════════════════════════════════════════════════════════════════════
-
-set +e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$(dirname "$SCRIPT_DIR")")"
-STATE_DIR="$PROJECT_ROOT/.cursor/state"
-mkdir -p "$STATE_DIR" 2>/dev/null || true
-
-# Read JSON input
-INPUT=$(cat)
-
-# Extract response text
-RESPONSE_TEXT=$(echo "$INPUT" | jq -r '.text // ""' 2>/dev/null || echo "")
-
-# Skip if empty
-if [ -z "$RESPONSE_TEXT" ] || [ "$RESPONSE_TEXT" = "null" ]; then
-  exit 0
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════
-# Load auth
-# ═══════════════════════════════════════════════════════════════════════════
-EKKOS_CONFIG="$HOME/.ekkos/config.json"
-AUTH_TOKEN=""
-USER_ID=""
-
-if [ -f "$EKKOS_CONFIG" ]; then
-  AUTH_TOKEN=$(jq -r '.hookApiKey // .apiKey // ""' "$EKKOS_CONFIG" 2>/dev/null || echo "")
-  USER_ID=$(jq -r '.userId // ""' "$EKKOS_CONFIG" 2>/dev/null || echo "")
-fi
-
-if [ -z "$AUTH_TOKEN" ] && [ -f "$PROJECT_ROOT/.env.local" ]; then
-  AUTH_TOKEN=$(grep -E "^SUPABASE_SECRET_KEY=" "$PROJECT_ROOT/.env.local" | cut -d'=' -f2- | tr -d '"' | tr -d "'" | tr -d '\r')
-fi
-
-[ -z "$AUTH_TOKEN" ] && exit 0
-
-MEMORY_API_URL="https://mcp.ekkos.dev"
-
-# ═══════════════════════════════════════════════════════════════════════════
-# Load session state
-# ═══════════════════════════════════════════════════════════════════════════
-SESSION_ID=""
-LAST_QUERY=""
-
-if [ -f "$STATE_DIR/current_session_id.txt" ]; then
-  SESSION_ID=$(cat "$STATE_DIR/current_session_id.txt" 2>/dev/null || echo "")
-fi
-
-if [ -f "$STATE_DIR/last_query.txt" ]; then
-  LAST_QUERY=$(cat "$STATE_DIR/last_query.txt" 2>/dev/null || echo "")
-fi
-
-# Generate session ID if missing
-if [ -z "$SESSION_ID" ]; then
-  SESSION_ID="cursor-agent-$(date +%s)-$$"
-  echo "$SESSION_ID" > "$STATE_DIR/current_session_id.txt"
-fi
-
-# ═══════════════════════════════════════════════════════════════════════════
-# Get turn number
-# ═══════════════════════════════════════════════════════════════════════════
-TURN_FILE="$STATE_DIR/turn_${SESSION_ID}.txt"
-TURN_NUMBER=1
-if [ -f "$TURN_FILE" ]; then
-  TURN_NUMBER=$(cat "$TURN_FILE" 2>/dev/null || echo "0")
-  TURN_NUMBER=$((TURN_NUMBER + 1))
-fi
-echo "$TURN_NUMBER" > "$TURN_FILE"
-
-# ═══════════════════════════════════════════════════════════════════════════
-# Capture turn to ekkOS L2
-# ═══════════════════════════════════════════════════════════════════════════
-# Only capture if we have a query to pair with
-if [ -n "$LAST_QUERY" ]; then
-  # Truncate for API limits
-  QUERY_TRUNCATED="${LAST_QUERY:0:10000}"
-  RESPONSE_TRUNCATED="${RESPONSE_TEXT:0:50000}"
-
-  CAPTURE_PAYLOAD=$(jq -n \
-    --arg session_id "cursor-agent-$SESSION_ID" \
-    --arg user_id "${USER_ID:-system}" \
-    --arg user_query "$QUERY_TRUNCATED" \
-    --arg assistant_response "$RESPONSE_TRUNCATED" \
-    --argjson turn_number "$TURN_NUMBER" \
-    '{
-      session_id: $session_id,
-      user_id: $user_id,
-      user_query: $user_query,
-      assistant_response: $assistant_response,
-      metadata: {
-        source: "cursor-agent",
-        turn_number: $turn_number,
-        agent_mode: true
-      }
-    }' 2>/dev/null || echo '{}')
-
-  # Fire and forget - don't block agent
-  curl -s -X POST "$MEMORY_API_URL/api/v1/capture" \
-    -H "Authorization: Bearer $AUTH_TOKEN" \
-    -H "Content-Type: application/json" \
-    -d "$CAPTURE_PAYLOAD" \
-    --connect-timeout 2 \
-    --max-time 3 >/dev/null 2>&1 &
-
-  # Clear last query
-  rm -f "$STATE_DIR/last_query.txt" 2>/dev/null || true
-fi
-
-exit 0