@ekkos/cli 1.3.2 → 1.3.6

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);