@ekkos/cli 1.3.1 → 1.3.5

package/templates/commands/continue.md

@@ -1,47 +0,0 @@
-# /continue
-
-Restore your last 5 turns after running `/clear`.
-
-## Usage
-
-```
-/clear         # First: free up context
-/continue      # Then: restore last 5 turns
-```
-
-## What Happens
-
-1. Hook detects `/continue`
-2. Fetches last 5 turns from ekkOS API
-3. Injects them as context
-4. Claude continues seamlessly
-
-## Why This Exists
-
-When context gets full (90%+), you need to `/clear` but don't want to lose your work. This command restores just enough context (5 turns) to continue working without re-explaining everything.
-
-## The Flow
-
-```
-Work normally until context ~90%
-         ↓
-Run: /clear (frees context)
-         ↓
-Run: /continue (restores 5 turns)
-         ↓
-Keep working
-```
-
-## Example
-
-```
-[Context at 92%]
-
-You: /clear
-Claude: Context cleared.
-
-You: /continue
-Hook: ✓ Session continued (5 turns restored)
-
-Claude: ✓ **Continuing** - We were working on the /continue command...
-```

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

@@ -1,127 +0,0 @@
----
-description: "ekkOS Memory — 11-layer cognitive memory with 29 MCP tools"
-alwaysApply: true
----
-
-# ekkOS Memory System
-
-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.
-
-### RULE 2: ACKNOWLEDGE RETRIEVED PATTERNS
-When patterns are retrieved, acknowledge each one:
-```
-[ekkOS_SELECT]
-- id: <pattern_id>
-  reason: <why using>
-  confidence: <0.0-1.0>
-[/ekkOS_SELECT]
-
-[ekkOS_SKIP]
-- id: <pattern_id>
-  reason: <why not relevant>
-[/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.
-
-## MCP Tools — 29 Visible
-
-### Core Memory (6)
-| Tool | Description |
-|------|-------------|
-| `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_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 |
-
-### Directives (4)
-| Tool | Description |
-|------|-------------|
-| `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 |
-
-### Utility (5)
-| Tool | Description |
-|------|-------------|
-| `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 complete/incomplete |
-| `ekkOS_Generate` | AI-generate plan from context |
-
-### 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 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 state |
-| 2 | Episodic | Past conversations |
-| 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 | User rules (MUST/NEVER/PREFER/AVOID) |
-| 10 | Conflict | Auto-resolves contradictions |
-| 11 | Secrets | Encrypted credentials (AES-256-GCM) |
-
-## When To Use What
-
-| 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
-
-End every response with:
-```
----
-🧠 **ekkOS_™** · 📅 YYYY-MM-DD H:MM AM/PM TZ
-```
-
-For more info: https://docs.ekkos.dev

package/templates/ekkos-manifest.json

@@ -1,223 +0,0 @@
-{
-  "$schema": "https://ekkos.dev/schemas/manifest-v1.json",
-  "manifestVersion": "1.0.0",
-  "generatedAt": "2026-02-20T07:39:17.071Z",
-  "platforms": {
-    "darwin": {
-      "configDir": "~/.ekkos",
-      "globalHooksDir": "~/.claude/hooks",
-      "shell": "bash"
-    },
-    "linux": {
-      "configDir": "~/.ekkos",
-      "globalHooksDir": "~/.claude/hooks",
-      "shell": "bash"
-    },
-    "win32": {
-      "configDir": "%USERPROFILE%\\.ekkos",
-      "globalHooksDir": "%USERPROFILE%\\.claude\\hooks",
-      "shell": "powershell"
-    }
-  },
-  "files": {
-    "managed": [
-      {
-        "source": "shared/session-words.json",
-        "destination": ".defaults/session-words.json",
-        "description": "Default session word lists (managed fallback)",
-        "checksum": "c64af03b9ae58d8c94e71886f80e590ad3a72fb2dcdbe02812789fecb4773e1a",
-        "overwrite": "always"
-      },
-      {
-        "source": "shared/hooks-enabled.json",
-        "destination": ".defaults/hooks-enabled.json",
-        "description": "Default hooks enablement config (managed fallback)",
-        "checksum": "74b833a1979f1b9467be6dcdeecc024073a4f3c02625b0751f4b1f9d53f143a3",
-        "overwrite": "always"
-      }
-    ],
-    "helpers": [
-      {
-        "source": "helpers/json-parse.cjs",
-        "destination": ".helpers/json-parse.cjs",
-        "description": "Node-based JSON parser (replaces jq dependency)",
-        "checksum": "e421977262b3bffcbec9f6f7a172df6f998f3b4deac64d478ef5a0a17034b026",
-        "executable": true,
-        "overwrite": "always"
-      }
-    ],
-    "userEditable": [
-      {
-        "source": "shared/session-words.json",
-        "destination": "session-words.json",
-        "description": "User-customizable session word lists",
-        "checksum": "c64af03b9ae58d8c94e71886f80e590ad3a72fb2dcdbe02812789fecb4773e1a",
-        "overwrite": "createOnly"
-      },
-      {
-        "source": "shared/hooks-enabled.json",
-        "destination": "hooks-enabled.json",
-        "description": "User-controlled hook enablement",
-        "checksum": "74b833a1979f1b9467be6dcdeecc024073a4f3c02625b0751f4b1f9d53f143a3",
-        "overwrite": "createOnly"
-      }
-    ],
-    "hooks": {
-      "bash": [
-        {
-          "source": "hooks/user-prompt-submit.sh",
-          "destination": "user-prompt-submit.sh",
-          "description": "User prompt submit hook (Unix)",
-          "checksum": "c53b621f3c64031f61b7ca1b3bf5ba4bec895b6a39aa7627422f0f2a2d26ab7d",
-          "executable": true
-        },
-        {
-          "source": "hooks/stop.sh",
-          "destination": "stop.sh",
-          "description": "Session stop hook (Unix)",
-          "checksum": "f3b4495c0c2bbdf5bfef762568faec7b70b41b463dad4c88b37cf7ee32b5257d",
-          "executable": true
-        },
-        {
-          "source": "hooks/session-start.sh",
-          "destination": "session-start.sh",
-          "description": "Session start hook (Unix)",
-          "checksum": "8d17fd3203045589f0c410f465b0d1e98d6ed24dc3bc99f44878e44e9501a22d",
-          "executable": true
-        },
-        {
-          "source": "hooks/assistant-response.sh",
-          "destination": "assistant-response.sh",
-          "description": "Assistant response hook (Unix)",
-          "checksum": "99400adf6ced406f0295c25db3b8fb892212ad3ba625f427c042d8526ac8f6f7",
-          "executable": true
-        }
-      ],
-      "powershell": [
-        {
-          "source": "hooks/user-prompt-submit.ps1",
-          "destination": "user-prompt-submit.ps1",
-          "description": "User prompt submit hook (Windows)",
-          "checksum": "ba1090ed7a4e7deef1267b52474225669a9c966b9adf596b31865c2dca1dc749"
-        },
-        {
-          "source": "hooks/stop.ps1",
-          "destination": "stop.ps1",
-          "description": "Session stop hook (Windows)",
-          "checksum": "c4f0191ac28ced0410ea560197ab3b0a7e2de83363a789731d64620bc605564d"
-        },
-        {
-          "source": "hooks/session-start.ps1",
-          "destination": "session-start.ps1",
-          "description": "Session start hook (Windows)",
-          "checksum": "1930bda7c517054531ff3ad78e8cce7e60d57f5b3884728da0d7cf1cc5c54ac4"
-        },
-        {
-          "source": "hooks/assistant-response.ps1",
-          "destination": "assistant-response.ps1",
-          "description": "Assistant response hook (Windows)",
-          "checksum": "680e6d7c597f90fb54bc86d173f4c145093eb21352b30c7d6afbe19d1d5fdce4"
-        }
-      ],
-      "lib": [
-        {
-          "source": "hooks/lib/contract.sh",
-          "destination": "lib/contract.sh",
-          "description": "Hook contract library",
-          "checksum": "3ef16930ba10cd37a1c5fa8469ec13a6a84cadb882d3f9a96c72da875ba07fc7",
-          "executable": true
-        },
-        {
-          "source": "hooks/lib/state.sh",
-          "destination": "lib/state.sh",
-          "description": "Hook state management library",
-          "checksum": "99223ce9b869d78762084ff184327fa2814af7a16e5f2ac9619af43b5e551d7c",
-          "executable": true
-        }
-      ]
-    }
-  },
-  "projectStubs": {
-    "description": "Delegating stub hooks for project-level installation. These source global hooks first, then load project-specific overrides.",
-    "bash": [
-      {
-        "source": "project-stubs/user-prompt-submit.sh",
-        "destination": "user-prompt-submit.sh",
-        "description": "Project delegating stub for user-prompt-submit (Unix)",
-        "checksum": "47cc6b45dbb027e321c136f7c0935bae0d3dc349f01912fbe42ae27d382e297d",
-        "executable": true
-      },
-      {
-        "source": "project-stubs/stop.sh",
-        "destination": "stop.sh",
-        "description": "Project delegating stub for stop (Unix)",
-        "checksum": "a429c5ee596e6c975df32feb8ba952c77c0492d91bd9cd80f9eac2e721040eb4",
-        "executable": true
-      },
-      {
-        "source": "project-stubs/session-start.sh",
-        "destination": "session-start.sh",
-        "description": "Project delegating stub for session-start (Unix)",
-        "checksum": "189379e81e000153d057e49afd71791d28a6b73baab4b49b39de34918a00c493",
-        "executable": true
-      }
-    ],
-    "powershell": [
-      {
-        "source": "project-stubs/user-prompt-submit.ps1",
-        "destination": "user-prompt-submit.ps1",
-        "description": "Project delegating stub for user-prompt-submit (Windows)",
-        "checksum": "86cfea6a6e1181fc6b9180e82a3e34e1ba8e8b412c65bdf013d2367ea8b93283"
-      },
-      {
-        "source": "project-stubs/stop.ps1",
-        "destination": "stop.ps1",
-        "description": "Project delegating stub for stop (Windows)",
-        "checksum": "042f815ed455c5b5e51291b8740deafaea827c594695b270f4d4e4e5086bc234"
-      },
-      {
-        "source": "project-stubs/session-start.ps1",
-        "destination": "session-start.ps1",
-        "description": "Project delegating stub for session-start (Windows)",
-        "checksum": "14081806c7ca63a67999314f31e14a6c1293e57a8ce64335122f359e3bb8fba4"
-      }
-    ]
-  },
-  "cli": {
-    "minVersion": "0.2.9",
-    "legacySupported": true,
-    "requiredCommands": {
-      "0.2.9": [
-        "run",
-        "config"
-      ],
-      "0.3.0": [
-        "run",
-        "config",
-        "hooks"
-      ]
-    }
-  },
-  "validation": {
-    "requiredFiles": [
-      "shared/session-words.json",
-      "shared/hooks-enabled.json",
-      "helpers/json-parse.cjs",
-      "hooks/user-prompt-submit.sh",
-      "hooks/user-prompt-submit.ps1",
-      "hooks/stop.sh",
-      "hooks/stop.ps1",
-      "hooks/session-start.sh",
-      "hooks/session-start.ps1",
-      "hooks/assistant-response.sh",
-      "hooks/assistant-response.ps1",
-      "project-stubs/user-prompt-submit.sh",
-      "project-stubs/user-prompt-submit.ps1",
-      "project-stubs/stop.sh",
-      "project-stubs/stop.ps1",
-      "project-stubs/session-start.sh",
-      "project-stubs/session-start.ps1"
-    ],
-    "checksumAlgorithm": "sha256"
-  }
-}

package/templates/helpers/json-parse.cjs

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-/**
- * json-parse.cjs - Minimal JSON parser for ekkOS hooks
- * Eliminates jq dependency for cross-platform compatibility
- *
- * Usage: json-parse.cjs <file> [path]
- *
- * Examples:
- *   json-parse.cjs config.json                     # Output entire file
- *   json-parse.cjs config.json .apiKey             # Output single value
- *   json-parse.cjs words.json .adjectives          # Output array (one per line)
- *   json-parse.cjs hooks.json .targets.claude.stop # Nested path
- *
- * Exit codes:
- *   0 - Success (including empty/null result)
- *   1 - Error (file not found, invalid JSON, etc.)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const args = process.argv.slice(2);
-
-if (args.length < 1) {
-  console.error('Usage: json-parse.cjs <file> [path]');
-  console.error('Example: json-parse.cjs config.json .apiKey');
-  process.exit(1);
-}
-
-const filePath = args[0];
-const jsonPath = args[1] || null;
-
-// Check file exists
-if (!fs.existsSync(filePath)) {
-  console.error(`Error: File not found: ${filePath}`);
-  process.exit(1);
-}
-
-let data;
-try {
-  const content = fs.readFileSync(filePath, 'utf8');
-  data = JSON.parse(content);
-} catch (err) {
-  console.error(`Error: Failed to parse JSON: ${err.message}`);
-  process.exit(1);
-}
-
-// If no path specified, output entire JSON
-if (!jsonPath) {
-  console.log(JSON.stringify(data, null, 2));
-  process.exit(0);
-}
-
-// Parse path and extract value
-// Supports: .foo.bar, .foo[0], .foo.bar[1].baz
-function extractValue(obj, pathStr) {
-  if (!pathStr || pathStr === '.') return obj;
-
-  // Remove leading dot if present
-  const cleanPath = pathStr.startsWith('.') ? pathStr.slice(1) : pathStr;
-  if (!cleanPath) return obj;
-
-  // Split on . and [ but keep the brackets for array access
-  const parts = cleanPath.split(/\.|\[|\]/).filter(Boolean);
-
-  let result = obj;
-  for (const part of parts) {
-    if (result === undefined || result === null) {
-      return undefined;
-    }
-    result = result[part];
-  }
-  return result;
-}
-
-const result = extractValue(data, jsonPath);
-
-// Handle different result types
-if (result === undefined || result === null) {
-  // Empty output, exit 0 (not an error - just no value)
-  process.exit(0);
-}
-
-if (Array.isArray(result)) {
-  // Output array items one per line (like jq -r '.[]')
-  for (const item of result) {
-    if (typeof item === 'object') {
-      console.log(JSON.stringify(item));
-    } else {
-      console.log(item);
-    }
-  }
-} else if (typeof result === 'object') {
-  console.log(JSON.stringify(result, null, 2));
-} else if (typeof result === 'boolean') {
-  console.log(result ? 'true' : 'false');
-} else {
-  console.log(result);
-}
-
-process.exit(0);

package/templates/hooks-node/lib/state.js

@@ -1,187 +0,0 @@
-#!/usr/bin/env node
-/**
- * ekkOS™ Hook State Management Library (Node.js - Cross-Platform)
- * Shared state functions for coordinating between hooks
- * Works on Windows, macOS, and Linux without bash/curl/jq dependencies
- */
-
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
-
-// Get project root (where .claude directory lives)
-function getProjectRoot() {
-  const scriptDir = __dirname;
-  return path.dirname(path.dirname(path.dirname(scriptDir)));
-}
-
-const PROJECT_ROOT = getProjectRoot();
-const STATE_DIR = path.join(PROJECT_ROOT, '.claude', 'state');
-
-// Ensure state directory exists
-function ensureStateDir() {
-  if (!fs.existsSync(STATE_DIR)) {
-    fs.mkdirSync(STATE_DIR, { recursive: true });
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// State File Management
-// ═══════════════════════════════════════════════════════════════════════════
-
-function savePatterns(sessionId, patterns, modelUsed) {
-  ensureStateDir();
-  const stateFile = path.join(STATE_DIR, `patterns-${sessionId}.json`);
-
-  const data = {
-    patterns: patterns,
-    model_used: modelUsed,
-    saved_at: new Date().toISOString()
-  };
-
-  fs.writeFileSync(stateFile, JSON.stringify(data, null, 2));
-}
-
-function loadPatterns(sessionId) {
-  const stateFile = path.join(STATE_DIR, `patterns-${sessionId}.json`);
-
-  if (fs.existsSync(stateFile)) {
-    try {
-      return JSON.parse(fs.readFileSync(stateFile, 'utf8'));
-    } catch {
-      return {};
-    }
-  }
-  return {};
-}
-
-function clearPatterns(sessionId) {
-  const stateFile = path.join(STATE_DIR, `patterns-${sessionId}.json`);
-  if (fs.existsSync(stateFile)) {
-    fs.unlinkSync(stateFile);
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// Capture Deduplication
-// ═══════════════════════════════════════════════════════════════════════════
-
-function generateTurnHash(userQuery, assistantResponse) {
-  return crypto.createHash('md5').update(`${userQuery}${assistantResponse}`).digest('hex');
-}
-
-function wasTurnCaptured(sessionId, turnHash) {
-  const captureLog = path.join(STATE_DIR, `captures-${sessionId}.log`);
-
-  if (fs.existsSync(captureLog)) {
-    const hashes = fs.readFileSync(captureLog, 'utf8').split('\n');
-    return hashes.includes(turnHash);
-  }
-  return false;
-}
-
-function markTurnCaptured(sessionId, turnHash) {
-  ensureStateDir();
-  const captureLog = path.join(STATE_DIR, `captures-${sessionId}.log`);
-
-  fs.appendFileSync(captureLog, `${turnHash}\n`);
-
-  // Keep only last 100 hashes
-  try {
-    const hashes = fs.readFileSync(captureLog, 'utf8').split('\n').filter(Boolean);
-    if (hashes.length > 100) {
-      fs.writeFileSync(captureLog, hashes.slice(-100).join('\n') + '\n');
-    }
-  } catch {
-    // Ignore cleanup errors
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// Lock Management
-// ═══════════════════════════════════════════════════════════════════════════
-
-function acquireLock(sessionId) {
-  ensureStateDir();
-  const lockFile = path.join(STATE_DIR, `lock-${sessionId}.lock`);
-  const timeout = 5000; // 5 seconds
-  const startTime = Date.now();
-
-  while (fs.existsSync(lockFile)) {
-    if (Date.now() - startTime > timeout) {
-      // Check if lock is stale (older than 10 seconds)
-      try {
-        const stat = fs.statSync(lockFile);
-        if (Date.now() - stat.mtimeMs > 10000) {
-          fs.unlinkSync(lockFile);
-          break;
-        }
-      } catch {
-        break;
-      }
-      return false;
-    }
-    // Wait 100ms
-    const waitUntil = Date.now() + 100;
-    while (Date.now() < waitUntil) {}
-  }
-
-  fs.writeFileSync(lockFile, process.pid.toString());
-  return true;
-}
-
-function releaseLock(sessionId) {
-  const lockFile = path.join(STATE_DIR, `lock-${sessionId}.lock`);
-
-  try {
-    const content = fs.readFileSync(lockFile, 'utf8');
-    if (content.trim() === process.pid.toString()) {
-      fs.unlinkSync(lockFile);
-    }
-  } catch {
-    // Lock file doesn't exist or can't be read
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// Cleanup
-// ═══════════════════════════════════════════════════════════════════════════
-
-function cleanupOldState() {
-  if (!fs.existsSync(STATE_DIR)) return;
-
-  const now = Date.now();
-  const oneDayMs = 24 * 60 * 60 * 1000;
-
-  try {
-    const files = fs.readdirSync(STATE_DIR);
-    for (const file of files) {
-      const filePath = path.join(STATE_DIR, file);
-      try {
-        const stat = fs.statSync(filePath);
-        if (now - stat.mtimeMs > oneDayMs) {
-          fs.unlinkSync(filePath);
-        }
-      } catch {
-        // Ignore file errors
-      }
-    }
-  } catch {
-    // Ignore directory errors
-  }
-}
-
-module.exports = {
-  PROJECT_ROOT,
-  STATE_DIR,
-  ensureStateDir,
-  savePatterns,
-  loadPatterns,
-  clearPatterns,
-  generateTurnHash,
-  wasTurnCaptured,
-  markTurnCaptured,
-  acquireLock,
-  releaseLock,
-  cleanupOldState
-};