kodelyth-ecc 1.8.5 → 1.8.6

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to Kodelyth ECC are documented here.
 
+## v1.8.6 — Memory path rename + auto-migration (July 2026)
+
+Renamed the on-disk memory root from `~/.kodelyth/` to `~/.kodelythecc/` across every runtime path. Existing installs auto-migrate on first CLI invocation or hook fire — idempotent, non-destructive, keeps a dated backup of the old directory.
+
+### Changed
+
+- All 20 runtime JS files: memory, hooks, dashboard, evolve, MCP, router, tests now point at `~/.kodelythecc/` (42 replacements total)
+- `scripts/memory/store.js` — default `MEMORY_DIR` now `~/.kodelythecc/memory/`; runs migration on `require`
+- `bin/kodelyth-ecc.js` — runs migration on every CLI invocation (no-op after first run)
+- `KODELYTH_MEMORY_DIR` and related env vars kept unchanged for backwards compat
+
+### Added
+
+- `scripts/migrate-legacy.js` — one-shot migrator: merges memories, copies sibling files (index, patterns, projects/, evolve/, safety/, mcp-clients.json), renames old dir to `~/.kodelyth.backup-YYYY-MM-DD`, drops `.migrated-from-kodelyth` marker so it never runs twice
+
+### Behavior
+
+- **New users**: get `~/.kodelythecc/` from the start
+- **Existing users** (have `~/.kodelyth/`): data migrated on next CLI run or hook fire; original preserved as backup
+
 ## v1.8.0 — Visual system overhaul + SVG polish (May 2026)
 
 Comprehensive overhaul of all 31 social assets. GitHub social preview and OG image rebuilt with two-panel stat card layout. All text overflow issues fixed across the full SVG set. Test counts updated to 373. PNG exports regenerated at 4K only.

package/bin/kodelyth-ecc.js

@@ -20,6 +20,11 @@ const fs            = require('fs');
 const os            = require('os');
 
 const ROOT    = path.join(__dirname, '..');
+
+// Auto-migrate legacy ~/.kodelyth/ → ~/.kodelythecc/ on first run for existing users.
+// Idempotent; instant no-op if legacy dir is absent or migration marker exists.
+try { require(path.join(ROOT, 'scripts', 'migrate-legacy.js')).main(); } catch { /* best-effort */ }
+
 // zsh (unlike bash) passes inline comments as literal args — strip them
 const args    = process.argv.slice(2).filter((a, i, arr) => {
   if (a.startsWith('#')) return false;          // drop # and everything after
@@ -863,7 +868,7 @@ if (args.includes('--help') || args.includes('-h')) {
     mcp-call <name> <tool> [--json '{"arg":"value"}']
                          Call a tool on a registered server. See docs/mcp-clients.md.
     route                Recommend trivial/standard/hard model tier for a task. Reads
-                         .kodelyth/router.json and KODELYTH_ROUTER_* env vars. Disable with
+                         .kodelythecc/router.json and KODELYTH_ROUTER_* env vars. Disable with
                          KODELYTH_ROUTER=off. Use --json for machine-readable output.
     swarm                Run N specialist agents in parallel inside isolated git worktrees +
                          a tmux session. Auto-picks agents from --task signals or accepts
@@ -1010,6 +1015,7 @@ if (isWin) {
   }
   process.exit(result.status ?? 1);
 } else {
+  try { require(path.join(ROOT, 'scripts', 'migrate-legacy.js')).main(); } catch {}
   const sh = path.join(ROOT, 'install.sh');
   if (!fs.existsSync(sh)) {
     console.error('Error: install.sh not found in package root:', ROOT);

package/hooks/memory/auto-recall.js

@@ -11,7 +11,7 @@
 //   - Skips on prompts that look like agent commands (`use foo`, `@bar`)
 //   - Skips when no memory exists yet
 //   - Suppresses repeats: never re-surfaces the same memory twice in a session
-//     (state file: ~/.kodelyth/memory/session-surfaced-<sessionId>.json)
+//     (state file: ~/.kodelythecc/memory/session-surfaced-<sessionId>.json)
 //   - Always exits 0 — never blocks the prompt because memory is unavailable
 // =============================================================================
 
@@ -120,7 +120,7 @@ function formatBlock(memories, userPrompt) {
 
 function surfacedStatePath(sessionId) {
   const dir = process.env.KODELYTH_MEMORY_DIR
-    || path.join(os.homedir(), '.kodelyth', 'memory');
+    || path.join(os.homedir(), '.kodelythecc', 'memory');
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
   return path.join(dir, `session-surfaced-${sessionId}.json`);
 }

package/hooks/memory/capture-stop.js

@@ -4,7 +4,7 @@
 //
 // Runs at the end of a Claude Code session. Locates the session JSONL,
 // extracts memory candidates, writes them to a review queue at:
-//   ~/.kodelyth/memory/pending-review.jsonl
+//   ~/.kodelythecc/memory/pending-review.jsonl
 //
 // Candidates are NEVER auto-stored. The user reviews via:
 //   /memory review-pending
@@ -51,7 +51,7 @@ function main() {
     }
 
     const dir = process.env.KODELYTH_MEMORY_DIR
-      || path.join(os.homedir(), '.kodelyth', 'memory');
+      || path.join(os.homedir(), '.kodelythecc', 'memory');
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
 
     const sessionId = data.session_id || path.basename(sessionJsonl, '.jsonl');

package/hooks/safety/token-budget.js

@@ -21,7 +21,7 @@
 //                Blocks SessionStart once usage >= budget.
 //
 // Optional knobs:
-//   KODELYTH_TOKEN_BUDGET_DIR=/custom/path   default ~/.kodelyth/safety
+//   KODELYTH_TOKEN_BUDGET_DIR=/custom/path   default ~/.kodelythecc/safety
 //   KODELYTH_TOKEN_BUDGET_WARN=0.7           warn threshold (0-1, default 0.7)
 //   KODELYTH_TOKEN_BUDGET_RESET=1            wipe usage and exit (admin op)
 //
@@ -39,7 +39,7 @@ const WARN_PCT   = Math.max(0, Math.min(1, Number(process.env.KODELYTH_TOKEN_BUD
 const RESET      = !!process.env.KODELYTH_TOKEN_BUDGET_RESET;
 
 const STATE_DIR = process.env.KODELYTH_TOKEN_BUDGET_DIR
-  || path.join(os.homedir(), '.kodelyth', 'safety');
+  || path.join(os.homedir(), '.kodelythecc', 'safety');
 
 function safeExit(code) {
   try { process.stdout.write(''); } catch {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodelyth-ecc",
-  "version": "1.8.5",
+  "version": "1.8.6",
   "description": "Production-grade AI coding toolkit — 70 agents (incl. devil-mode adversarial crew), 194 skills, 97 commands, parallel multi-agent commands, semantic intent routing, self-learning memory, and a built-in MCP server (16 tools / 6 prompts / 377 resources) that bridges to Claude Desktop, LangGraph, AutoGen, CrewAI, and OpenAI Agents SDK. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, RooCode, Aider, Kimi, and Gemini CLI.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",

package/scripts/dashboard/data.js

@@ -4,8 +4,8 @@
 //
 // All data the dashboard renders comes from:
 //   - The MCP catalog (filesystem reads of agents/, skills/, commands/, rules/, bundles/)
-//   - The BM25 memory store (~/.kodelyth/memory/)
-//   - The evolve signal streams (~/.kodelyth/evolve/)
+//   - The BM25 memory store (~/.kodelythecc/memory/)
+//   - The evolve signal streams (~/.kodelythecc/evolve/)
 //   - The token-budget hook state (${KODELYTH_TOKEN_BUDGET_DIR})
 //   - The orchestration session dirs (.orchestration/<session>/)
 //   - Live IDE session activity (Claude Code, Windsurf, Antigravity)
@@ -35,13 +35,13 @@ const evolveProposals = safeRequire('scripts/evolve/proposals.js');
 // ── helpers ──────────────────────────────────────────────────────────────────
 
 function defaultMemoryDir() {
-  return process.env.KODELYTH_MEMORY_DIR || path.join(os.homedir(), '.kodelyth', 'memory');
+  return process.env.KODELYTH_MEMORY_DIR || path.join(os.homedir(), '.kodelythecc', 'memory');
 }
 function defaultEvolveDir() {
-  return process.env.KODELYTH_EVOLVE_DIR || path.join(os.homedir(), '.kodelyth', 'evolve');
+  return process.env.KODELYTH_EVOLVE_DIR || path.join(os.homedir(), '.kodelythecc', 'evolve');
 }
 function defaultBudgetDir() {
-  return process.env.KODELYTH_TOKEN_BUDGET_DIR || path.join(os.homedir(), '.kodelyth', 'token-budget');
+  return process.env.KODELYTH_TOKEN_BUDGET_DIR || path.join(os.homedir(), '.kodelythecc', 'token-budget');
 }
 function defaultCoordRoot() {
   return process.env.KODELYTH_COORDINATION_ROOT || path.join(process.cwd(), '.orchestration');

package/scripts/dashboard/server.js

@@ -37,11 +37,11 @@ const MAX_SSE_CLIENTS = 10;
 // IMPORTANT: include both `routing-misses.jsonl` (always present once evolve sees
 // any miss) AND `proposals.jsonl` (created later, after `evolve analyze` runs).
 const WATCH_PATHS = [
-  path.join(os.homedir(), '.kodelyth', 'memory',  'memories.jsonl'),
-  path.join(os.homedir(), '.kodelyth', 'evolve',  'reuse.json'),
-  path.join(os.homedir(), '.kodelyth', 'evolve',  'routing-misses.jsonl'),
-  path.join(os.homedir(), '.kodelyth', 'evolve',  'proposals.jsonl'),
-  path.join(os.homedir(), '.kodelyth', 'token-budget'), // dir mtime — changes when budget files appear
+  path.join(os.homedir(), '.kodelythecc', 'memory',  'memories.jsonl'),
+  path.join(os.homedir(), '.kodelythecc', 'evolve',  'reuse.json'),
+  path.join(os.homedir(), '.kodelythecc', 'evolve',  'routing-misses.jsonl'),
+  path.join(os.homedir(), '.kodelythecc', 'evolve',  'proposals.jsonl'),
+  path.join(os.homedir(), '.kodelythecc', 'token-budget'), // dir mtime — changes when budget files appear
 ];
 const lastMtimes    = new Map();
 let   lastIdeMtime  = 0; // max mtime across Claude Code / Windsurf / Antigravity sessions

package/scripts/evolve/proposals.js

@@ -12,7 +12,7 @@
 // audit trail is preserved. Reads collapse to "latest state per id".
 //
 // Storage:
-//   ${KODELYTH_EVOLVE_DIR:-~/.kodelyth/evolve}/proposals.jsonl
+//   ${KODELYTH_EVOLVE_DIR:-~/.kodelythecc/evolve}/proposals.jsonl
 //
 // Pure where possible. Public functions accept dir explicitly.
 'use strict';
@@ -22,7 +22,7 @@ const path = require('path');
 const os   = require('os');
 
 const DEFAULT_DIR = process.env.KODELYTH_EVOLVE_DIR
-  || path.join(os.homedir(), '.kodelyth', 'evolve');
+  || path.join(os.homedir(), '.kodelythecc', 'evolve');
 
 const PROPOSALS_FILE = 'proposals.jsonl';
 

package/scripts/evolve/stats.js

@@ -14,7 +14,7 @@
 //                          by tokens to surface "we keep getting asked
 //                          about X but have no agent / skill / memory for it".
 //
-// Storage layout (default ${HOME}/.kodelyth/evolve/):
+// Storage layout (default ${HOME}/.kodelythecc/evolve/):
 //   reuse.json                  { byMemory: { id: { count, sessions[], lastSurfaced } } }
 //   routing-misses.jsonl        append-only — one prompt per line
 //
@@ -31,7 +31,7 @@ const path = require('path');
 const crypto = require('crypto');
 
 const DEFAULT_DIR = process.env.KODELYTH_EVOLVE_DIR
-  || path.join(os.homedir(), '.kodelyth', 'evolve');
+  || path.join(os.homedir(), '.kodelythecc', 'evolve');
 
 const REUSE_FILE = 'reuse.json';
 const MISSES_FILE = 'routing-misses.jsonl';

package/scripts/mcp/client.js

@@ -6,7 +6,7 @@
 // make ECC the MCP HUB: serve to any framework, consume from any provider.
 //
 // Storage:
-//   ~/.kodelyth/mcp-clients.json     registry of named external servers
+//   ~/.kodelythecc/mcp-clients.json     registry of named external servers
 //
 // Public API (all functions pure or local file-only):
 //   loadRegistry(), saveRegistry(reg)
@@ -32,7 +32,7 @@ const os   = require('os');
 const path = require('path');
 
 const REGISTRY_DIR = process.env.KODELYTH_MCP_CLIENT_DIR
-  || path.join(os.homedir(), '.kodelyth');
+  || path.join(os.homedir(), '.kodelythecc');
 const REGISTRY_FILE = path.join(REGISTRY_DIR, 'mcp-clients.json');
 
 // ── Registry I/O ─────────────────────────────────────────────────────────────

package/scripts/memory/instincts.js

@@ -2,7 +2,7 @@
 // Kodelyth ECC — Structured Instinct Schema  (Improvement B)
 //
 // Stores learned instincts as typed JSON records in:
-//   ~/.kodelyth/memory/instincts.jsonl
+//   ~/.kodelythecc/memory/instincts.jsonl
 //
 // Each instinct has: pattern, trigger, confidence, last_used, outcome, decay.
 // This replaces free-form markdown bullets for machine-readable learning.
@@ -33,7 +33,7 @@ const path   = require('path');
 const crypto = require('crypto');
 
 const MEMORY_DIR = process.env.KODELYTH_MEMORY_DIR
-  || path.join(os.homedir(), '.kodelyth', 'memory');
+  || path.join(os.homedir(), '.kodelythecc', 'memory');
 
 const INSTINCTS_FILE = path.join(MEMORY_DIR, 'instincts.jsonl');
 const STALE_DAYS     = 30;

package/scripts/memory/store.js

@@ -2,7 +2,7 @@
 // Kodelyth ECC — Memory Store
 // Local, zero-dependency, model-agnostic memory for AI coding sessions.
 //
-// Storage layout (all in ~/.kodelyth/memory/):
+// Storage layout (all in ~/.kodelythecc/memory/):
 //   memories.jsonl       Append-only log of every captured memory
 //   index.json           Inverted index: token -> [memory ids]
 //   patterns.json        User-level patterns (preferences, conventions)
@@ -19,8 +19,11 @@ const os   = require('os');
 const path = require('path');
 const crypto = require('crypto');
 
+// Auto-migrate legacy ~/.kodelyth/ → ~/.kodelythecc/ before we touch any path.
+try { require('../migrate-legacy').main(); } catch { /* best-effort */ }
+
 const MEMORY_DIR = process.env.KODELYTH_MEMORY_DIR
-  || path.join(os.homedir(), '.kodelyth', 'memory');
+  || path.join(os.homedir(), '.kodelythecc', 'memory');
 
 const PATHS = {
   dir:       MEMORY_DIR,

package/scripts/migrate-legacy.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+// One-shot migrator: ~/.kodelyth/ (old canonical) → ~/.kodelythecc/ (1.8.5+ canonical)
+// Idempotent — leaves a marker so it never runs twice.
+// Safe — never deletes source; renames old dir to .backup-<date>.
+
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+const LEGACY = path.join(os.homedir(), '.kodelyth');
+const NEW    = path.join(os.homedir(), '.kodelythecc');
+const MARKER = path.join(NEW, '.migrated-from-kodelyth');
+
+function main() {
+  if (!fs.existsSync(LEGACY)) return { migrated: false, reason: 'no legacy dir' };
+  if (fs.existsSync(MARKER))  return { migrated: false, reason: 'already migrated' };
+
+  fs.mkdirSync(path.join(NEW, 'memory'), { recursive: true });
+
+  const legacyMem = path.join(LEGACY, 'memory', 'memories.jsonl');
+  const newMem    = path.join(NEW,    'memory', 'memories.jsonl');
+  let addedLines = 0;
+
+  if (fs.existsSync(legacyMem)) {
+    const existing = new Set(
+      fs.existsSync(newMem)
+        ? fs.readFileSync(newMem, 'utf8').split('\n').filter(Boolean)
+        : []
+    );
+    const legacyLines = fs.readFileSync(legacyMem, 'utf8').split('\n').filter(Boolean);
+    const toAppend = legacyLines.filter(l => !existing.has(l));
+    if (toAppend.length) {
+      fs.appendFileSync(newMem, (existing.size ? '\n' : '') + toAppend.join('\n') + '\n');
+      addedLines = toAppend.length;
+    }
+  }
+
+  // Copy any sibling files (index.json, session-surfaced-*.json) if not already present.
+  const legacyMemDir = path.join(LEGACY, 'memory');
+  let copiedFiles = 0;
+  if (fs.existsSync(legacyMemDir)) {
+    for (const f of fs.readdirSync(legacyMemDir)) {
+      if (f === 'memories.jsonl') continue;
+      const dst = path.join(NEW, 'memory', f);
+      if (!fs.existsSync(dst)) {
+        fs.copyFileSync(path.join(legacyMemDir, f), dst);
+        copiedFiles++;
+      }
+    }
+  }
+
+  // Copy other subtrees (evolve, safety, token-budget, mcp-clients.json) if missing.
+  const subtrees = ['evolve', 'safety', 'token-budget'];
+  for (const sub of subtrees) {
+    const src = path.join(LEGACY, sub);
+    const dst = path.join(NEW, sub);
+    if (fs.existsSync(src) && !fs.existsSync(dst)) {
+      copyDirSync(src, dst);
+    }
+  }
+  const legacyMcp = path.join(LEGACY, 'mcp-clients.json');
+  const newMcp    = path.join(NEW,    'mcp-clients.json');
+  if (fs.existsSync(legacyMcp) && !fs.existsSync(newMcp)) {
+    fs.copyFileSync(legacyMcp, newMcp);
+  }
+
+  // Rename legacy dir → backup (never delete).
+  const stamp = new Date().toISOString().slice(0, 10);
+  const backup = path.join(os.homedir(), `.kodelyth.backup-${stamp}`);
+  try {
+    if (!fs.existsSync(backup)) fs.renameSync(LEGACY, backup);
+  } catch { /* best-effort */ }
+
+  fs.writeFileSync(MARKER, JSON.stringify({
+    at: new Date().toISOString(),
+    addedLines,
+    copiedFiles,
+    backupPath: backup,
+  }, null, 2));
+
+  return { migrated: true, addedLines, copiedFiles, backupPath: backup };
+}
+
+function copyDirSync(src, dst) {
+  fs.mkdirSync(dst, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const s = path.join(src, entry.name);
+    const d = path.join(dst, entry.name);
+    if (entry.isDirectory()) copyDirSync(s, d);
+    else fs.copyFileSync(s, d);
+  }
+}
+
+if (require.main === module) {
+  try {
+    const r = main();
+    if (r.migrated) {
+      process.stdout.write(
+        `[kodelyth] migrated legacy ~/.kodelyth → ~/.kodelythecc ` +
+        `(+${r.addedLines} memories, ${r.copiedFiles} files copied, backup: ${r.backupPath})\n`
+      );
+    }
+  } catch (e) {
+    process.stderr.write(`[kodelyth] migration skipped: ${e.message}\n`);
+  }
+}
+
+module.exports = { main };

package/scripts/router/classify.js

@@ -164,13 +164,13 @@ function classify(task, opts = {}) {
   return { tier: 'standard', reasons, score, explicit_tier: explicitTier || null };
 }
 
-// ── Config loader (env vars + .kodelyth/router.json) ─────────────────────────
+// ── Config loader (env vars + .kodelythecc/router.json) ─────────────────────────
 function loadConfig({ projectRoot = process.cwd() } = {}) {
   const cfg = { ...DEFAULT_MODELS, notes: '' };
 
   // 1. Project-level override.
   try {
-    const file = path.join(projectRoot, '.kodelyth', 'router.json');
+    const file = path.join(projectRoot, '.kodelythecc', 'router.json');
     if (fs.existsSync(file)) {
       const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
       for (const k of ['trivial', 'standard', 'hard', 'default', 'notes']) {

package/tasks/lessons.md

@@ -0,0 +1,11 @@
+# Claude Lessons
+
+Project: **kodelyth-ecc**
+
+Auto-generated by Kodelyth ECC. Each entry is a rule Claude learned from a correction.
+Edit freely — add, remove, reword. These are YOUR rules.
+
+---
+## 2026-07-03
+
+- We need to update our kodelyth ecc ( elite code crew) we build from this - https://github.com/affaan-m/ecc but they are now more advance. So now problem is is our ECC less powerfull then them. We have bm25 memories but not works. We need grab maximum feature from them and attach into ours ( don't te