@ekkos/cli 1.0.35 → 1.0.36

package/templates/windsurf-hooks/hooks.json

@@ -1,9 +1,16 @@
 {
   "version": 1,
   "hooks": {
-    "beforeSubmitPrompt": [
+    "pre_user_prompt": [
       {
-        "command": "./.windsurf/hooks/before-submit-prompt.sh"
+        "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/lib/contract.sh

@@ -16,6 +16,8 @@ get_contract_dir() {
 
   if [ "$source" = "cursor" ]; then
     echo "$project_root/.cursor/state/ekkos"
+  elif [ "$source" = "windsurf" ]; then
+    echo "$project_root/.windsurf/state/ekkos"
   else
     echo "$project_root/.claude/state/ekkos"
   fi

package/templates/windsurf-skills/ekkos-memory/SKILL.md

@@ -1,219 +1,219 @@
----
-title: ekkOS Memory System
-description: AI-native cognitive memory with 31 MCP tools for persistent learning and context continuity
-trigger: always_on
-author: ekkOS Technologies
-tags: [memory, patterns, learning, context]
----
-
-# ekkOS Memory System Skill
-
-This skill enables Cascade to leverage the full ekkOS 11-layer cognitive memory system for persistent learning, pattern recognition, and context continuity across sessions.
-
-## When to Use This Skill
-
-**ALWAYS USE** for:
-- Technical questions (before answering, search memory)
-- Bug fixes (forge patterns after solving)
-- Architecture decisions (check for existing patterns)
-- Code reviews (retrieve relevant patterns)
-- Refactoring (find proven approaches)
-
-## Core Workflow
-
-### 1. Search Before Answering (MANDATORY)
-
-```
-Before answering ANY technical question:
-
-1. Call ekkOS_Search with the query
-2. Review retrieved patterns
-3. Acknowledge ALL patterns with [ekkOS_SELECT] or [ekkOS_SKIP]
-4. THEN provide your answer
-```
-
-### 2. PatternGuard Acknowledgment
-
-For every pattern retrieved, you MUST acknowledge it:
-
-```
-[ekkOS_SELECT]
-- id: <pattern-uuid>
-  reason: Using this because...
-  confidence: 0.95
-[/ekkOS_SELECT]
-
-[ekkOS_SKIP]
-- id: <pattern-uuid>
-  reason: Not relevant because...
-[/ekkOS_SKIP]
-```
-
-**Coverage must be 100%** - every pattern ID must be acknowledged.
-
-### 3. Forge What You Learn
-
-After fixing bugs, solving problems, or discovering gotchas:
-
-```
-Call ekkOS_Forge with:
-- Problem: What was broken
-- Solution: How you fixed it
-- Tags: [language, framework, error-type]
-```
-
-## MCP Tools Reference
-
-### Core Memory (8 tools)
-
-| Tool | Purpose | When to Use |
-|------|---------|-------------|
-| `ekkOS_Search` | Search all 11 memory layers | **Before EVERY technical answer** |
-| `ekkOS_Context` | Get relevant task context | When starting multi-step tasks |
-| `ekkOS_Capture` | Capture memory events | Log significant actions |
-| `ekkOS_Forge` | Create patterns from solutions | After fixing bugs/discoveries |
-| `ekkOS_Directive` | Create MUST/NEVER/PREFER/AVOID rules | When user states preferences |
-| `ekkOS_Outcome` | Track success/failure | After applying patterns |
-| `ekkOS_Detect` | Auto-detect pattern usage | In responses |
-| `ekkOS_Recall` | Recall past conversations | When user asks "what did we" |
-
-### Schema Awareness (2 tools)
-
-| Tool | Purpose | When to Use |
-|------|---------|-------------|
-| `ekkOS_IndexSchema` | Index database schemas | With Supabase/Prisma projects |
-| `ekkOS_GetSchema` | Get specific table schema | When writing queries |
-
-### Plan Management (9 tools)
-
-| Tool | Purpose | When to Use |
-|------|---------|-------------|
-| `ekkOS_Plan` | Create structured plans | Multi-step features |
-| `ekkOS_Generate` | AI-generate plans | Complex tasks |
-| `ekkOS_PlanStatus` | Update plan status | Marking steps complete |
-| `ekkOS_PlanStep` | Mark step done | Step completion |
-| `ekkOS_SaveTemplate` | Save as template | Reusable workflows |
-| `ekkOS_Templates` | List templates | Finding existing plans |
-| `ekkOS_FromTemplate` | Create from template | Starting from template |
-
-### Portability & Secrets (8 tools)
-
-| Tool | Purpose | When to Use |
-|------|---------|-------------|
-| `ekkOS_Export` | Export as backup | Before major changes |
-| `ekkOS_Import` | Import from backup | Restoring context |
-| `ekkOS_StoreSecret` | Encrypt credentials | Storing API keys |
-| `ekkOS_GetSecret` | Retrieve secrets | Using stored credentials |
-| `ekkOS_ListSecrets` | List secret metadata | Checking what's stored |
-| `ekkOS_RotateSecret` | Rotate secret values | Key rotation |
-
-### System Health (4 tools)
-
-| Tool | Purpose | When to Use |
-|------|---------|-------------|
-| `ekkOS_Stats` | Get layer statistics | Health checks |
-| `ekkOS_Summary` | Get activity summary | Progress updates |
-| `ekkOS_Conflict` | Check for conflicts | Before dangerous ops |
-| `ekkOS_Reflect` | Analyze for improvements | Post-task review |
-
-## 11-Layer Architecture
-
-| Layer | Purpose | Example Content |
-|-------|---------|-----------------|
-| 1 | Working | Current session context |
-| 2 | Episodic | Past conversation turns |
-| 3 | Semantic | Embeddings/vectors |
-| 4 | Patterns | Proven solutions |
-| 5 | Procedural | Step-by-step guides |
-| 6 | Collective | Community patterns |
-| 7 | Meta | Pattern effectiveness |
-| 8 | Codebase | Project code context |
-| 9 | Directives | User rules (MUST/NEVER) |
-| 10 | Conflict | Auto-resolution rules |
-| 11 | Secrets | Encrypted credentials |
-
-## Forge Triggers
-
-**Always forge when you:**
-- Fix a bug (create anti-pattern from the bug)
-- Find a better approach (update existing pattern)
-- Discover a gotcha (create warning pattern)
-- Get corrected by user (learn from correction)
-- Solve auth/config issues (create setup pattern)
-- Make architecture decisions (document rationale)
-- Debug non-trivially (capture the journey)
-
-## Response Format
-
-End EVERY response with:
-
-```
-🧠 **ekkOS_™** · 📅 YYYY-MM-DD H:MM AM/PM TZ
-```
-
-## Examples
-
-### Example 1: Technical Question
-
-User: "How do I fix CORS in Next.js?"
-
-Your workflow:
-1. Call `ekkOS_Search` with query: "Next.js CORS fix"
-2. Review retrieved patterns
-3. Acknowledge all patterns with SELECT/SKIP
-4. Provide answer based on patterns + your knowledge
-5. End with footer
-
-### Example 2: Bug Fix
-
-User: "The build is failing with this error..."
-
-Your workflow:
-1. Call `ekkOS_Search` with error message
-2. Apply relevant patterns
-3. Acknowledge with SELECT
-4. Fix the bug
-5. Call `ekkOS_Forge` with the solution
-6. Call `ekkOS_Outcome` to track success
-
-### Example 3: User Preference
-
-User: "I always want TypeScript strict mode"
-
-Your workflow:
-1. Call `ekkOS_Directive`:
-   - type: PREFER
-   - rule: "Use TypeScript strict mode"
-   - scope: project
-2. Acknowledge in future responses
-
-## Best Practices
-
-1. **Search first** - Never answer without searching
-2. **Acknowledge all** - 100% PatternGuard coverage required
-3. **Forge immediately** - Don't wait to capture learnings
-4. **Track outcomes** - Success/failure feedback improves patterns
-5. **Use directives** - Convert user preferences to rules
-6. **Export regularly** - Backup before major changes
-7. **End with footer** - Every response needs the ekkOS footer
-
-## Troubleshooting
-
-**"No patterns found"**
-→ You're in new territory. Forge what you discover.
-
-**"Pattern retrieval failed"**
-→ Check auth: `~/.ekkos/config.json` should have hookApiKey
-
-**"How do I continue from last session?"**
-→ Ask: "recall our last conversation" or "where were we"
-
-## Resources
-
-- Website: https://ekkos.dev
-- Docs: https://docs.ekkos.dev
-- Support: support@ekkos.dev
-
----
-
-🧠 **ekkOS_™** · Built for infinite context
+---
+title: ekkOS Memory System
+description: AI-native cognitive memory with 31 MCP tools for persistent learning and context continuity
+trigger: always_on
+author: ekkOS Technologies
+tags: [memory, patterns, learning, context]
+---
+
+# ekkOS Memory System Skill
+
+This skill enables Cascade to leverage the full ekkOS 11-layer cognitive memory system for persistent learning, pattern recognition, and context continuity across sessions.
+
+## When to Use This Skill
+
+**ALWAYS USE** for:
+- Technical questions (before answering, search memory)
+- Bug fixes (forge patterns after solving)
+- Architecture decisions (check for existing patterns)
+- Code reviews (retrieve relevant patterns)
+- Refactoring (find proven approaches)
+
+## Core Workflow
+
+### 1. Search Before Answering (MANDATORY)
+
+```
+Before answering ANY technical question:
+
+1. Call ekkOS_Search with the query
+2. Review retrieved patterns
+3. Acknowledge ALL patterns with [ekkOS_SELECT] or [ekkOS_SKIP]
+4. THEN provide your answer
+```
+
+### 2. PatternGuard Acknowledgment
+
+For every pattern retrieved, you MUST acknowledge it:
+
+```
+[ekkOS_SELECT]
+- id: <pattern-uuid>
+  reason: Using this because...
+  confidence: 0.95
+[/ekkOS_SELECT]
+
+[ekkOS_SKIP]
+- id: <pattern-uuid>
+  reason: Not relevant because...
+[/ekkOS_SKIP]
+```
+
+**Coverage must be 100%** - every pattern ID must be acknowledged.
+
+### 3. Forge What You Learn
+
+After fixing bugs, solving problems, or discovering gotchas:
+
+```
+Call ekkOS_Forge with:
+- Problem: What was broken
+- Solution: How you fixed it
+- Tags: [language, framework, error-type]
+```
+
+## MCP Tools Reference
+
+### Core Memory (8 tools)
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `ekkOS_Search` | Search all 11 memory layers | **Before EVERY technical answer** |
+| `ekkOS_Context` | Get relevant task context | When starting multi-step tasks |
+| `ekkOS_Capture` | Capture memory events | Log significant actions |
+| `ekkOS_Forge` | Create patterns from solutions | After fixing bugs/discoveries |
+| `ekkOS_Directive` | Create MUST/NEVER/PREFER/AVOID rules | When user states preferences |
+| `ekkOS_Outcome` | Track success/failure | After applying patterns |
+| `ekkOS_Detect` | Auto-detect pattern usage | In responses |
+| `ekkOS_Recall` | Recall past conversations | When user asks "what did we" |
+
+### Schema Awareness (2 tools)
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `ekkOS_IndexSchema` | Index database schemas | With Supabase/Prisma projects |
+| `ekkOS_GetSchema` | Get specific table schema | When writing queries |
+
+### Plan Management (9 tools)
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `ekkOS_Plan` | Create structured plans | Multi-step features |
+| `ekkOS_Generate` | AI-generate plans | Complex tasks |
+| `ekkOS_PlanStatus` | Update plan status | Marking steps complete |
+| `ekkOS_PlanStep` | Mark step done | Step completion |
+| `ekkOS_SaveTemplate` | Save as template | Reusable workflows |
+| `ekkOS_Templates` | List templates | Finding existing plans |
+| `ekkOS_FromTemplate` | Create from template | Starting from template |
+
+### Portability & Secrets (8 tools)
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `ekkOS_Export` | Export as backup | Before major changes |
+| `ekkOS_Import` | Import from backup | Restoring context |
+| `ekkOS_StoreSecret` | Encrypt credentials | Storing API keys |
+| `ekkOS_GetSecret` | Retrieve secrets | Using stored credentials |
+| `ekkOS_ListSecrets` | List secret metadata | Checking what's stored |
+| `ekkOS_RotateSecret` | Rotate secret values | Key rotation |
+
+### System Health (4 tools)
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `ekkOS_Stats` | Get layer statistics | Health checks |
+| `ekkOS_Summary` | Get activity summary | Progress updates |
+| `ekkOS_Conflict` | Check for conflicts | Before dangerous ops |
+| `ekkOS_Reflect` | Analyze for improvements | Post-task review |
+
+## 11-Layer Architecture
+
+| Layer | Purpose | Example Content |
+|-------|---------|-----------------|
+| 1 | Working | Current session context |
+| 2 | Episodic | Past conversation turns |
+| 3 | Semantic | Embeddings/vectors |
+| 4 | Patterns | Proven solutions |
+| 5 | Procedural | Step-by-step guides |
+| 6 | Collective | Community patterns |
+| 7 | Meta | Pattern effectiveness |
+| 8 | Codebase | Project code context |
+| 9 | Directives | User rules (MUST/NEVER) |
+| 10 | Conflict | Auto-resolution rules |
+| 11 | Secrets | Encrypted credentials |
+
+## Forge Triggers
+
+**Always forge when you:**
+- Fix a bug (create anti-pattern from the bug)
+- Find a better approach (update existing pattern)
+- Discover a gotcha (create warning pattern)
+- Get corrected by user (learn from correction)
+- Solve auth/config issues (create setup pattern)
+- Make architecture decisions (document rationale)
+- Debug non-trivially (capture the journey)
+
+## Response Format
+
+End EVERY response with:
+
+```
+🧠 **ekkOS_™** · 📅 YYYY-MM-DD H:MM AM/PM TZ
+```
+
+## Examples
+
+### Example 1: Technical Question
+
+User: "How do I fix CORS in Next.js?"
+
+Your workflow:
+1. Call `ekkOS_Search` with query: "Next.js CORS fix"
+2. Review retrieved patterns
+3. Acknowledge all patterns with SELECT/SKIP
+4. Provide answer based on patterns + your knowledge
+5. End with footer
+
+### Example 2: Bug Fix
+
+User: "The build is failing with this error..."
+
+Your workflow:
+1. Call `ekkOS_Search` with error message
+2. Apply relevant patterns
+3. Acknowledge with SELECT
+4. Fix the bug
+5. Call `ekkOS_Forge` with the solution
+6. Call `ekkOS_Outcome` to track success
+
+### Example 3: User Preference
+
+User: "I always want TypeScript strict mode"
+
+Your workflow:
+1. Call `ekkOS_Directive`:
+   - type: PREFER
+   - rule: "Use TypeScript strict mode"
+   - scope: project
+2. Acknowledge in future responses
+
+## Best Practices
+
+1. **Search first** - Never answer without searching
+2. **Acknowledge all** - 100% PatternGuard coverage required
+3. **Forge immediately** - Don't wait to capture learnings
+4. **Track outcomes** - Success/failure feedback improves patterns
+5. **Use directives** - Convert user preferences to rules
+6. **Export regularly** - Backup before major changes
+7. **End with footer** - Every response needs the ekkOS footer
+
+## Troubleshooting
+
+**"No patterns found"**
+→ You're in new territory. Forge what you discover.
+
+**"Pattern retrieval failed"**
+→ Check auth: `~/.ekkos/config.json` should have hookApiKey
+
+**"How do I continue from last session?"**
+→ Ask: "recall our last conversation" or "where were we"
+
+## Resources
+
+- Website: https://ekkos.dev
+- Docs: https://docs.ekkos.dev
+- Support: support@ekkos.dev
+
+---
+
+🧠 **ekkOS_™** · Built for infinite context