@ekkos/cli 1.0.35 → 1.0.36

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@ekkos/cli",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "Setup ekkOS memory for AI coding assistants (Claude Code, Cursor, Windsurf)",
   "main": "dist/index.js",
   "bin": {
     "ekkos": "dist/index.js",
     "cli": "dist/index.js",
-    "ekkos-capture": "dist/cache/capture.js",
-    "ekkos-promote": "dist/cron/promoter.js"
+    "ekkos-capture": "dist/cache/capture.js"
   },
   "scripts": {
     "build": "tsc",
@@ -29,7 +28,6 @@
   "author": "ekkOS",
   "license": "MIT",
   "dependencies": {
-    "@ekkos/prometheus": "*",
     "@supabase/supabase-js": "^2.39.8",
     "blessed": "^0.1.81",
     "blessed-contrib": "^4.11.0",

package/templates/CLAUDE.md

@@ -53,6 +53,28 @@ After `/clear`, when you see restored turns in `<system-reminder>` (pattern: `**
 ```
 This is the ONLY way users see that restoration worked. Hook output is invisible to them.
 
+### RULE 6: AUTO-RESTORE AFTER COMPACTION (CONTEXT GUARDIAN)
+When you see `<ekkos-context-preserved>` in the conversation (appears after auto-compaction):
+1. **IMMEDIATELY** call `ekkOS_RestoreContext` with the `restoration_token` from the tag
+2. This restores your working memory that was preserved before compaction
+3. Start your response with:
+```
+✓ **Context restored** - ekkOS preserved X turns before compaction
+```
+
+**This is how seamless context continuity works:**
+- PreCompact hook fires → ekkOS_PreserveContext saves your state
+- Claude Code compacts → Summary includes the preservation tag
+- You see the tag → Call ekkOS_RestoreContext → Full context restored
+- User experiences zero knowledge loss despite compaction
+
+**Example restoration call:**
+```
+ekkOS_RestoreContext({
+  restoration_token: "<token from tag>"
+})
+```
+
 ---
 
 ## SKILL TRIGGERS (MANDATORY)
@@ -79,8 +101,7 @@ Call skills using `Skill(skill: "name")` when you detect these triggers:
 | Trigger Keywords | Agent | When to Use |
 |------------------|-------|-------------|
 | extension, vsix, publish, marketplace, ekkos-connect | `extension-manager` | Version bumps, VSIX builds, publishing |
-| vercel, deploy to vercel, platform.ekkos.dev, apps/web | `devops` | Vercel deployments (link + archive mode) |
-| deploy, railway, workers, pm2, restart, logs, queue | `railway-manager` | Railway deployments, service management |
+| vercel, deploy, apps/*, ekkos.dev, api.ekkos.dev | `devops` | Vercel deployments — ALL apps/ deploy to Vercel |
 | commit, push, branch, merge, git, pull request, rebase | `git-companion` | All git operations |
 | error, bug, broken, not working, failing, crash | `debug-detective` | Systematic debugging |
 | review, PR, check this code, code quality | `code-reviewer` | Code reviews |
@@ -89,6 +110,25 @@ Call skills using `Skill(skill: "name")` when you detect these triggers:
 | backend, API, database, Supabase, RLS | `backend` | API and database work |
 | test, QA, quality, coverage | `qa` | Testing and quality assurance |
 | plan, architect, design, implement feature | `tech-lead` | Complex planning and coordination |
+| research, papers, arXiv, cutting edge, latest AI | `research-scout` | Monitor AI research, update roadmap |
+
+**Vercel Project Mapping** (apps/ folder → Vercel project → URL):
+
+| apps/ folder | Vercel project | Production URL |
+|-------------|----------------|----------------|
+| `apps/web` | **platform** | platform.ekkos.dev |
+| `apps/memory` | memory | api.ekkos.dev |
+| `apps/proxy` | proxy | proxy.ekkos.dev |
+| `apps/docs` | docs | docs.ekkos.dev |
+| `apps/marketing` | marketing | ekkos.dev |
+| `apps/ekkosca` | ekkosca | ekkos.ca |
+| `apps/blog` | blog | blog.ekkos.dev |
+| `apps/support` | support | support.ekkos.dev |
+| `apps/labs` | labs | ekkoslabs.com |
+| `apps/admin` | admin | admin.ekkos.ca |
+| `apps/sdk` | sdk | sdk-ekkos.vercel.app |
+
+**NOTE:** `apps/web` → Vercel project name is `platform`, NOT `web`.
 
 **How it works:**
 1. Detect trigger keywords in user request
@@ -109,39 +149,55 @@ You: Task(subagent_type="extension-manager", prompt="Bump version...")
 
 ---
 
-## MCP Tools (31 Total)
+## MCP Tools (68 Total)
 
-### Core Memory Tools
+### Core Memory Tools (7)
 | Tool | Description |
 |------|-------------|
 | `ekkOS_Search` | 🔴 REQUIRED: Search all 11 layers before answering |
-| `ekkOS_Context` | Get relevant context for a task |
+| `ekkOS_ExpandPattern` | Get full details of a pattern from compact search results |
 | `ekkOS_Capture` | Capture memory events |
 | `ekkOS_Forge` | 🔴 REQUIRED: Create pattern from solution |
-| `ekkOS_Directive` | 🔴 REQUIRED: Create MUST/NEVER/PREFER/AVOID rules |
+| `ekkOS_Track` | Track when pattern is applied |
 | `ekkOS_Outcome` | Track if pattern worked or failed |
-| `ekkOS_Detect` | 🔴 REQUIRED: Auto-detect which patterns were used |
-| `ekkOS_Summary` | 🔴 REQUIRED: Get summary of MCP activity |
-| `ekkOS_Conflict` | 🔴 REQUIRED: Check for conflicts before destructive actions |
-| `ekkOS_Recall` | Recall past conversations by time |
-| `ekkOS_Codebase` | Search project code embeddings |
 | `ekkOS_Stats` | Get statistics for all layers |
-| `ekkOS_Track` | Track when pattern is applied |
-| `ekkOS_Reflect` | Analyze response for improvement opportunities |
 
-### Schema Awareness Tools
+### Context & Retrieval Tools (5)
 | Tool | Description |
 |------|-------------|
-| `ekkOS_IndexSchema` | Index database schemas (Supabase, Prisma, TypeScript) |
-| `ekkOS_GetSchema` | Get schema for a specific table/type |
+| `ekkOS_Context` | Get relevant context for a task |
+| `ekkOS_Codebase` | Search project code embeddings |
+| `ekkOS_Recall` | Recall past conversations by time |
+| `ekkOS_PreserveContext` | 🔴 REQUIRED: Preserve working memory before compaction |
+| `ekkOS_RestoreContext` | 🔴 REQUIRED: Restore context after compaction (RULE 6) |
 
-### Portability Tools
+### Utility Tools (8)
 | Tool | Description |
 |------|-------------|
+| `ekkOS_Summary` | 🔴 REQUIRED: Get summary of MCP activity |
+| `ekkOS_Conflict` | 🔴 REQUIRED: Check for conflicts before destructive actions |
+| `ekkOS_Reflect` | Analyze response for improvement opportunities |
+| `ekkOS_Detect` | 🔴 REQUIRED: Auto-detect which patterns were used |
 | `ekkOS_Export` | Export your patterns, directives, plans as portable JSON backup |
 | `ekkOS_Import` | Import memory from backup (auto-deduplication) |
+| `ekkOS_Why` | Explain why a pattern or decision was made |
+| `ekkOS_Health` | System health check for ekkOS infrastructure |
+
+### Directive Tools (4)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Directive` | 🔴 REQUIRED: Create MUST/NEVER/PREFER/AVOID rules |
+| `ekkOS_UpdateDirective` | Update existing directive |
+| `ekkOS_DeleteDirective` | Remove a directive |
+| `ekkOS_UniversalDirectives` | Get directives that apply to all users (constitutional) |
+
+### Schema Awareness Tools (2)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_IndexSchema` | Index database schemas (Supabase, Prisma, TypeScript) |
+| `ekkOS_GetSchema` | Get schema for a specific table/type |
 
-### Plan Management
+### Plan Management (8)
 | Tool | Description |
 |------|-------------|
 | `ekkOS_Plan` | Create structured task plan |
@@ -153,7 +209,7 @@ You: Task(subagent_type="extension-manager", prompt="Bump version...")
 | `ekkOS_Templates` | List available templates |
 | `ekkOS_FromTemplate` | Create plan from template |
 
-### Secrets Management (Layer 11)
+### Secrets Management (5)
 | Tool | Description |
 |------|-------------|
 | `ekkOS_StoreSecret` | Encrypt and store sensitive data (AES-256-GCM) |
@@ -162,6 +218,39 @@ You: Task(subagent_type="extension-manager", prompt="Bump version...")
 | `ekkOS_DeleteSecret` | Permanently delete a secret |
 | `ekkOS_RotateSecret` | Update secret with new value |
 
+### Project/Sync Tools (4)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_ProjectInit` | Initialize ekkOS for a new project |
+| `ekkOS_Ingest` | Bulk ingest data into memory layers |
+| `ekkOS_Snapshot` | Create point-in-time snapshot of memory state |
+| `ekkOS_Sync` | Sync local and cloud memory state |
+
+### Session Management (1)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Session` | Manage L1 Working Memory sessions (start/resume/end) |
+
+### Learning Tools (2)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Learn` | Auto-learning from corrections, successes, observations |
+| `ekkOS_ReviewLearning` | Review pending learning candidates, approve/reject patterns |
+
+### Relationship Tools (2)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Link` | Create relationships between patterns |
+| `ekkOS_Playbook` | Manage ordered sequences of patterns (workflows) |
+
+### PROMETHEUS Tools (4)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Delta` | Compute improvement score using Δ_prometheus formula |
+| `ekkOS_MetaState` | System introspection ("I know what I know") |
+| `ekkOS_Goal` | Manage persistent objectives and success criteria |
+| `ekkOS_Strategy` | Context-aware strategy selection for tasks |
+
 ---
 
 ## Proactive Tool Triggers (MEMORIZE THESE)
@@ -204,6 +293,28 @@ You: Task(subagent_type="extension-manager", prompt="Bump version...")
 - Need to retrieve stored credentials
 - User asks "do you have my X key?"
 
+### Always Use Context Preservation When:
+- PreCompact hook fires (auto-triggered)
+- See `<ekkos-context-preserved>` tag (auto-restore)
+- RULE 6 activation
+
+### Always Use Learning Tools When:
+- User corrects you (ekkOS_Learn mode: correction)
+- Solution succeeds (ekkOS_Learn mode: success)
+- Discover insight (ekkOS_Learn mode: observe)
+- Review pending patterns (ekkOS_ReviewLearning)
+
+### Always Use Relationship Tools When:
+- Patterns are sequential (ekkOS_Link type: leads_to)
+- Creating workflows (ekkOS_Playbook)
+- Patterns are alternatives (ekkOS_Link type: alternative)
+
+### Always Use PROMETHEUS Tools When:
+- Evaluating system improvement (ekkOS_Delta)
+- Self-assessment needed (ekkOS_MetaState)
+- Setting objectives (ekkOS_Goal)
+- Choosing approach (ekkOS_Strategy)
+
 ---
 
 ## 11-Layer Memory Architecture
@@ -253,20 +364,21 @@ Call `ekkOS_Directive` when user says:
 **EVERY response MUST end with this footer:**
 ```
 ---
-{IDE} ({Model}) · 🧠 **ekkOS_™** · Turn {N} · 📅 {Timestamp}
+{IDE} ({Model}) · 🧠 **ekkOS_™** · Turn {N} · {SessionName} · 📅 {Timestamp}
 ```
 
 **How to detect values:**
 - **IDE**: Claude Code, Cursor, Windsurf, etc. (from environment)
 - **Model**: Sonnet 4.5, Opus 4.5, etc. (from your model name)
 - **Turn Number**: From hook header (e.g., "Turn 47") - starts at 0 for each new session
+- **Session Name**: From hook header (e.g., "sol-gem-dig") - human-readable session identifier
 - **Timestamp**: From hook header (accurate local time in EST)
 
 **Examples:**
-- `Claude Code (Sonnet 4.5) · 🧠 **ekkOS_™** · Turn 12 · 📅 2026-01-09 4:50 PM EST`
-- `Cursor (Claude Sonnet 4) · 🧠 **ekkOS_™** · Turn 5 · 📅 2026-01-09 10:15 AM EST`
+- `Claude Code (Sonnet 4.5) · 🧠 **ekkOS_™** · Turn 12 · cosmic-penguin-runs · 📅 2026-01-09 4:50 PM EST`
+- `Cursor (Claude Sonnet 4) · 🧠 **ekkOS_™** · Turn 5 · bright-falcon-soars · 📅 2026-01-09 10:15 AM EST`
 
-**The hook header shows:** `🧠 ekkOS Memory | Turn {N} | Session: {ID} | {timestamp}`
+**The hook header shows:** `🧠 ekkOS Memory | Turn {N} | {Context%} | {SessionName} | {timestamp}`
 
 ---
 

package/templates/ekkos-manifest.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://ekkos.dev/schemas/manifest-v1.json",
   "manifestVersion": "1.0.0",
-  "generatedAt": "2026-02-17T00:04:16.491Z",
+  "generatedAt": "2026-02-20T07:39:17.071Z",
   "platforms": {
     "darwin": {
       "configDir": "~/.ekkos",
@@ -68,14 +68,14 @@
           "source": "hooks/user-prompt-submit.sh",
           "destination": "user-prompt-submit.sh",
           "description": "User prompt submit hook (Unix)",
-          "checksum": "811155208e3e15d7aae266ee38cf516d90c1cdb9e51bbe2f4604c361ec030290",
+          "checksum": "c53b621f3c64031f61b7ca1b3bf5ba4bec895b6a39aa7627422f0f2a2d26ab7d",
           "executable": true
         },
         {
           "source": "hooks/stop.sh",
           "destination": "stop.sh",
           "description": "Session stop hook (Unix)",
-          "checksum": "caa22bc5bc60b6f393d83511ed96cb9f77e365ee8eed8b52d8904e4525f15ce1",
+          "checksum": "f3b4495c0c2bbdf5bfef762568faec7b70b41b463dad4c88b37cf7ee32b5257d",
           "executable": true
         },
         {
@@ -89,7 +89,7 @@
           "source": "hooks/assistant-response.sh",
           "destination": "assistant-response.sh",
           "description": "Assistant response hook (Unix)",
-          "checksum": "11c3b84aff29552f8a28b59851a4fdc7de4414d28161cca7418dfc93e0c64eac",
+          "checksum": "99400adf6ced406f0295c25db3b8fb892212ad3ba625f427c042d8526ac8f6f7",
           "executable": true
         }
       ],
@@ -98,25 +98,25 @@
           "source": "hooks/user-prompt-submit.ps1",
           "destination": "user-prompt-submit.ps1",
           "description": "User prompt submit hook (Windows)",
-          "checksum": "ba044ec066935a9413811e53fd70f42f0ffd959fc361b746c6b54768ac8c6fb9"
+          "checksum": "ba1090ed7a4e7deef1267b52474225669a9c966b9adf596b31865c2dca1dc749"
         },
         {
           "source": "hooks/stop.ps1",
           "destination": "stop.ps1",
           "description": "Session stop hook (Windows)",
-          "checksum": "455d9dfca8cea2f8289604ca2389b8e43c8af380fbcc5e2eef18382d30e4be6d"
+          "checksum": "c4f0191ac28ced0410ea560197ab3b0a7e2de83363a789731d64620bc605564d"
         },
         {
           "source": "hooks/session-start.ps1",
           "destination": "session-start.ps1",
           "description": "Session start hook (Windows)",
-          "checksum": "0897603df2b3261857be79108c0831b0fbc3744722b4923ce632844e7c6483c6"
+          "checksum": "1930bda7c517054531ff3ad78e8cce7e60d57f5b3884728da0d7cf1cc5c54ac4"
         },
         {
           "source": "hooks/assistant-response.ps1",
           "destination": "assistant-response.ps1",
           "description": "Assistant response hook (Windows)",
-          "checksum": "83fb65cec1cb9b1b9ef7a2036c9440e8b6ced16d82a2623b5353899918ae9653"
+          "checksum": "680e6d7c597f90fb54bc86d173f4c145093eb21352b30c7d6afbe19d1d5fdce4"
         }
       ],
       "lib": [