@ekkos/cli 0.2.0

package/templates/claude-plugins/learning-tracker/commands/my-patterns.md

@@ -0,0 +1,282 @@
+# My Patterns
+
+Personal dashboard showing what ekkOS has learned from you - your patterns, success rates, and growth over time.
+
+## Overview
+
+See your learning journey! This command shows all the patterns you've forged, which ones are helping most, and how your ekkOS memory is growing.
+
+**This is your personal knowledge base dashboard.**
+
+## What it does
+
+1. **Lists YOUR patterns** - Everything you've forged
+2. **Shows success rates** - Which patterns actually help
+3. **Tracks usage** - How often patterns are applied
+4. **Highlights top performers** - Your most valuable patterns
+5. **Identifies stale patterns** - Unused for 30+ days
+6. **Growth metrics** - How your memory is expanding
+
+## Usage
+
+```bash
+# Show all your patterns
+/my-patterns
+
+# Show only successful patterns
+/my-patterns --successful
+
+# Show patterns by category
+/my-patterns --category typescript
+
+# Show recent patterns only
+/my-patterns --recent
+```
+
+## Example Output
+
+```
+📊 Your ekkOS Learning Dashboard
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+👤 User: @yourname
+📅 Member Since: 3 months ago
+🧠 Memory Health: 85/100 (Excellent)
+
+───────────────────────────────────────────────────────────────────
+📈 Growth Overview
+
+Total Patterns Forged: 42
+├─ Solutions: 35 (83%)
+├─ Anti-patterns: 7 (17%)
+└─ Average Success Rate: 84%
+
+This Month:
+  • 8 new patterns forged
+  • 156 pattern retrievals
+  • 131 successful applications (84% success)
+
+All-Time Golden Loop:
+  ✅ RETRIEVE: 1,234 times
+  ✅ APPLY: 1,041 times (84% application rate)
+  ✅ MEASURE: 876 outcomes tracked
+  ✅ LEARN: 42 patterns forged
+
+───────────────────────────────────────────────────────────────────
+🏆 Top Performing Patterns
+
+1. ⭐⭐⭐⭐⭐ Fix undefined map errors with optional chaining
+   Success: 98% (41/42 uses) | Last Used: Today
+   Category: TypeScript, Arrays
+   Impact: Prevented 41 runtime errors!
+
+2. ⭐⭐⭐⭐⭐ API timeout retry with exponential backoff
+   Success: 95% (38/40 uses) | Last Used: 2 days ago
+   Category: API, Error Handling
+   Impact: Saved 38 failed requests!
+
+3. ⭐⭐⭐⭐☆ Handle promise rejection in async/await
+   Success: 92% (23/25 uses) | Last Used: 1 week ago
+   Category: JavaScript, Async
+   Impact: Prevented 23 unhandled rejections!
+
+4. ⭐⭐⭐⭐☆ Validate user input before database insert
+   Success: 88% (15/17 uses) | Last Used: 3 days ago
+   Category: Security, Database
+   Impact: Blocked 15 potential SQL injections!
+
+5. ⭐⭐⭐⭐☆ Cache API responses for 5 minutes
+   Success: 90% (18/20 uses) | Last Used: Today
+   Category: Performance, API
+   Impact: Reduced 18 redundant API calls!
+
+───────────────────────────────────────────────────────────────────
+📚 All Your Patterns (Sorted by Category)
+
+🔷 TypeScript (12 patterns)
+   • Fix undefined map errors - 98% success
+   • Type narrowing with discriminated unions - 95% success
+   • Generic type constraints - 92% success
+   • ❌ Don't use 'any' type - Anti-pattern
+   [+8 more...]
+
+🔷 API & Backend (8 patterns)
+   • Timeout retry with exponential backoff - 95% success
+   • Cache responses for 5 minutes - 90% success
+   • Rate limit with sliding window - 85% success
+   [+5 more...]
+
+🔷 React & Frontend (7 patterns)
+   • Memoize expensive computations - 93% success
+   • useEffect dependency array pitfalls - 88% success
+   [+5 more...]
+
+🔷 Database (5 patterns)
+   • Validate input before insert - 88% success
+   • Use transactions for multi-step operations - 94% success
+   [+3 more...]
+
+🔷 Error Handling (6 patterns)
+   • Handle promise rejections - 92% success
+   • Try/catch in async functions - 90% success
+   [+4 more...]
+
+🔷 Security (4 patterns)
+   • Sanitize user input - 96% success
+   • ❌ Don't store passwords in plaintext - Anti-pattern
+   [+2 more...]
+
+───────────────────────────────────────────────────────────────────
+⚠️  Patterns Needing Attention
+
+Low Success Rate (< 70%):
+  • "Fix webpack build errors" - 45% success (5/11 uses)
+    → This pattern might need updating or more specific conditions
+
+Stale (Not Used in 30+ Days):
+  • "Legacy browser polyfill" - Last used: 42 days ago
+    → Consider archiving if no longer relevant
+
+Never Applied:
+  • "Redis connection pooling" - Forged 2 months ago, never used
+    → Did you solve this problem differently?
+
+───────────────────────────────────────────────────────────────────
+🎯 Your Learning Stats
+
+Forging Habits:
+  • Average time to forge after solving: 2 hours ⏱️
+  • Most active forging day: Friday
+  • Forging streak: 5 days 🔥
+
+Pattern Quality:
+  • Patterns with examples: 38/42 (90%) ✅
+  • Patterns with anti-patterns: 7/42 (17%) 📚
+  • Patterns with "works when": 35/42 (83%) 🎯
+
+Contribution to Collective:
+  • Your patterns promoted to collective: 8
+  • Other users helped by your patterns: 23 developers
+  • Collective impact: 156 successful applications 🌍
+
+───────────────────────────────────────────────────────────────────
+💡 Recommendations
+
+Based on your patterns and usage:
+
+  1. 🎉 Great job! Your forging discipline is excellent
+     → Keep capturing solutions as you solve problems
+
+  2. ⚡ Consider updating "Fix webpack build errors"
+     → 45% success rate suggests it needs refinement
+     → Use /forge to update with better solution
+
+  3. 🗂️  Archive 3 stale patterns that haven't been used
+     → Keeps your memory focused and relevant
+
+  4. 🌟 5 of your patterns are helping other developers!
+     → Consider promoting more to collective memory
+
+───────────────────────────────────────────────────────────────────
+🔗 Quick Actions
+
+  • View specific pattern: /memory-search <pattern-title>
+  • Update low-success pattern: /forge --update pat_abc123
+  • Archive stale patterns: /my-patterns --archive-stale
+  • Export all patterns: ekkOS_Export (via MCP)
+  • Promote to collective: (requires Pro tier)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Your ekkOS memory is thriving! 🌱→🌳
+
+You've forged 42 patterns, helped solve 1,041 problems, and
+prevented countless repeated mistakes. Keep learning and forging!
+
+Want to see how ekkOS is working for you? Try /loop-status
+```
+
+## Compact View Example
+
+```
+/my-patterns --compact
+
+📊 Your Patterns (42 total)
+
+Top 5 by Success:
+  1. ⭐ 98% - Fix undefined map errors (41 uses)
+  2. ⭐ 95% - API timeout retry (38 uses)
+  3. ⭐ 92% - Handle promise rejection (23 uses)
+  4. ⭐ 90% - Cache API responses (18 uses)
+  5. ⭐ 88% - Validate user input (15 uses)
+
+Recent (Last 7 Days):
+  • TypeScript type narrowing (forged 2 days ago)
+  • React useCallback optimization (forged 5 days ago)
+
+Needs Attention:
+  ⚠️  1 low-success pattern
+  ⏰ 3 stale patterns (30+ days)
+
+Overall Health: 85/100 (Excellent)
+```
+
+## Category Filter Example
+
+```
+/my-patterns --category typescript
+
+📊 TypeScript Patterns (12 total)
+
+🔷 All TypeScript Patterns:
+
+1. ⭐⭐⭐⭐⭐ Fix undefined map errors
+   Success: 98% | Used: 41 times | Last: Today
+
+2. ⭐⭐⭐⭐⭐ Type narrowing with discriminated unions
+   Success: 95% | Used: 28 times | Last: 3 days ago
+
+3. ⭐⭐⭐⭐☆ Generic type constraints
+   Success: 92% | Used: 19 times | Last: 1 week ago
+
+[... 9 more patterns ...]
+
+Average Success Rate: 91% (Excellent!)
+Total Applications: 234
+```
+
+## Requirements
+
+- ekkOS MCP server configured
+- At least 1 pattern forged (otherwise shows empty state)
+- Optional: Pro tier for collective metrics
+
+## Implementation Details
+
+When this command runs, Claude will:
+
+1. Call `ekkOS_Stats({scope: "personal"})` to get user's pattern count
+2. Call `ekkOS_Search({query: "*", sources: ["patterns"], user_only: true})` to list all user patterns
+3. Sort patterns by:
+   - Success rate (default)
+   - Last used date (--recent)
+   - Category (--category)
+   - Usage count (--popular)
+4. Calculate metrics:
+   - Total patterns forged
+   - Average success rate
+   - Golden Loop completion stats
+   - Growth over time
+5. Identify issues:
+   - Patterns with < 70% success
+   - Patterns unused for 30+ days
+   - Patterns never applied
+6. Format into user-friendly dashboard:
+   - Visual indicators (stars, emojis)
+   - Color-coded success rates
+   - Clear categorization
+   - Actionable recommendations
+
+This command helps users understand their learning journey and maintain a healthy pattern library.
+
+**Your patterns = Your superpower** 🦸

package/templates/claude-plugins/memory-lens/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "ekkos-memory-lens",
+  "description": "Search and explore what ekkOS remembers. View patterns, check if solutions exist, understand your memory substrate.",
+  "author": {
+    "name": "ekkOS",
+    "email": "support@ekkos.dev"
+  }
+}

package/templates/claude-plugins/memory-lens/commands/memory-search.md

@@ -0,0 +1,181 @@
+# Memory Search
+
+Search your ekkOS memory to see what patterns and solutions exist for your problem.
+
+## Overview
+
+Before solving any problem, use this command to check if ekkOS already knows the solution. This is the **RETRIEVE** phase of the Golden Loop - searching your memory substrate for relevant patterns.
+
+## What it does
+
+1. **Searches all 11 layers** of your ekkOS memory
+2. **Finds relevant patterns** matching your query
+3. **Shows past solutions** that worked
+4. **Highlights success rates** for each pattern
+5. **Explains WHY** each pattern was retrieved
+6. **User-friendly display** - no overwhelming technical details
+
+## Usage
+
+```bash
+# Search for solutions
+/memory-search "authentication error"
+/memory-search "TypeScript type narrowing"
+/memory-search "API timeout handling"
+
+# Quick search (uses recent conversation context)
+/memory-search
+```
+
+## Example Output
+
+```
+🔍 Memory Search Results
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Query: "authentication error JWT expired"
+
+Found 3 relevant patterns in your memory:
+
+───────────────────────────────────────────────────────────────────
+Pattern #1: Fix JWT expired errors in auth middleware
+Success Rate: 95% (used 12 times)
+Last Used: 2 days ago
+
+Problem:
+  Auth middleware throwing "JWT expired" even with valid tokens
+  due to clock skew between server and client.
+
+Solution:
+  Add 30-second grace period to JWT validation:
+
+  ```typescript
+  jwt.verify(token, secret, {
+    clockTolerance: 30  // Allow 30s clock skew
+  });
+  ```
+
+Why This Matches:
+  • You mentioned "JWT" and "expired"
+  • This pattern solved similar auth issues
+  • High success rate suggests it's reliable
+
+───────────────────────────────────────────────────────────────────
+Pattern #2: Refresh token before expiry
+Success Rate: 88% (used 8 times)
+Last Used: 1 week ago
+
+Problem:
+  Users getting logged out unexpectedly when JWT expires.
+
+Solution:
+  Implement automatic token refresh 5 minutes before expiry...
+
+Why This Matches:
+  • Related to JWT expiration handling
+  • Complementary to Pattern #1
+
+───────────────────────────────────────────────────────────────────
+Pattern #3: Handle auth errors gracefully
+Success Rate: 92% (used 15 times)
+Last Used: 3 days ago
+
+Problem:
+  Auth errors showing ugly stack traces to users.
+
+Solution:
+  Catch auth errors and redirect to login...
+
+Why This Matches:
+  • General authentication error handling
+  • Applies to your "authentication error" query
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 Recommendations:
+
+  1. Try Pattern #1 first (highest success rate)
+  2. If that doesn't work, combine with Pattern #2
+  3. Always implement Pattern #3 for better UX
+
+  Once you apply a solution, I'll automatically track if it worked!
+
+🔄 Golden Loop Status:
+  ✅ RETRIEVE - Found 3 patterns
+  ⏸️  APPLY - Waiting for you to try a solution
+  ⏸️  MEASURE - Will track if solution works
+  ⏸️  LEARN - Will update pattern success rates
+
+Use /forge if you discover a NEW solution not in these patterns!
+```
+
+## No Results Example
+
+```
+🔍 Memory Search Results
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Query: "rare database edge case issue"
+
+Found 0 patterns in your memory.
+
+This is a NEW problem! 🎉
+
+Here's what happens next:
+
+  1. Solve the problem (experiment, search docs, etc.)
+  2. Once you find a solution, use `/forge` to capture it
+  3. Next time you encounter this, ekkOS will remember!
+
+This is how your memory grows - every solved problem becomes
+a pattern for future reference.
+
+🔄 Golden Loop Status:
+  ⚠️  RETRIEVE - No patterns found (new problem)
+  💡 SOLVE - Work on solution (you're on your own this time!)
+  ⚒️  FORGE - Use /forge once you solve it
+  ✅ NEXT TIME - Pattern will be retrieved automatically
+
+The Golden Loop is waiting for you to forge this solution!
+```
+
+## Requirements
+
+- ekkOS MCP server configured (via ekkos-connect)
+- Active ekkOS account
+- Some patterns already forged (or this will show "no results")
+
+## Advanced Options
+
+```bash
+# Search specific layers
+/memory-search --patterns-only "bug fix"
+/memory-search --directives-only
+
+# Search by tags
+/memory-search --tags "typescript,api"
+
+# Show low-success patterns too
+/memory-search --include-low-success "error handling"
+```
+
+## Implementation Details
+
+When this command runs, Claude will:
+
+1. Extract query from command or recent conversation
+2. Call `ekkOS_Search({query, sources: ["all"], limit: 10})`
+3. Format results in user-friendly way:
+   - Pattern title (clear, non-technical)
+   - Success rate + usage count
+   - Last used date
+   - Problem/Solution in plain language
+   - "Why This Matches" explanation
+4. Group patterns by relevance (best matches first)
+5. Show Golden Loop status
+6. Suggest next steps:
+   - Try pattern X first
+   - Use `/forge` if new solution
+   - Use `/loop-check` if issues
+
+This command helps users understand what ekkOS knows and how to use it effectively.

package/templates/claude-plugins/pattern-coach/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "ekkos-pattern-coach",
+  "description": "Interactive assistant for forging patterns from solutions and failures. Ensures every lesson learned is captured in your memory.",
+  "author": {
+    "name": "ekkOS",
+    "email": "support@ekkos.dev"
+  }
+}