@evomap/evolver 1.29.2 → 1.29.8

package/SKILL.md

@@ -2,6 +2,108 @@
 name: capability-evolver
 description: A self-evolution engine for AI agents. Analyzes runtime history to identify improvements and applies protocol-constrained evolution.
 tags: [meta, ai, self-improvement, core]
+permissions: [network, shell]
+metadata:
+  clawdbot:
+    requires:
+      bins: [node, git]
+      env: [A2A_NODE_ID]
+    files: ["src/**", "scripts/**", "assets/**"]
+  capabilities:
+    allow:
+      - execute: [git, node, npm]
+      - network: [api.github.com, evomap.ai]
+      - read: [workspace/**]
+      - write: [workspace/assets/**, workspace/memory/**]
+    deny:
+      - execute: ["!git", "!node", "!npm", "!ps", "!pgrep", "!df"]
+      - network: ["!api.github.com", "!*.evomap.ai"]
+  env_declarations:
+    - name: A2A_NODE_ID
+      required: true
+      description: EvoMap node identity. Set after node registration.
+    - name: A2A_HUB_URL
+      required: false
+      default: https://evomap.ai
+      description: EvoMap Hub API base URL.
+    - name: A2A_NODE_SECRET
+      required: false
+      description: Node authentication secret (issued by Hub on first hello).
+    - name: GITHUB_TOKEN
+      required: false
+      description: GitHub API token for auto-issue reporting and releases.
+    - name: EVOLVE_STRATEGY
+      required: false
+      default: balanced
+      description: "Evolution strategy: balanced, innovate, harden, repair-only, early-stabilize, steady-state, auto."
+    - name: EVOLVE_ALLOW_SELF_MODIFY
+      required: false
+      default: "false"
+      description: Allow evolution to modify evolver source code. NOT recommended.
+    - name: EVOLVE_LOAD_MAX
+      required: false
+      default: "2.0"
+      description: Max 1-min load average before evolver backs off.
+    - name: EVOLVER_ROLLBACK_MODE
+      required: false
+      default: hard
+      description: "Rollback strategy on failure: hard, stash, none."
+    - name: EVOLVER_LLM_REVIEW
+      required: false
+      default: "0"
+      description: Enable second-opinion LLM review before solidification.
+    - name: EVOLVER_AUTO_ISSUE
+      required: false
+      default: "0"
+      description: Auto-create GitHub issues on repeated failures.
+    - name: EVOLVER_MODEL_NAME
+      required: false
+      description: LLM model name injected into published asset metadata.
+    - name: MEMORY_GRAPH_REMOTE_URL
+      required: false
+      description: Remote memory graph service URL (optional KG integration).
+    - name: MEMORY_GRAPH_REMOTE_KEY
+      required: false
+      description: API key for remote memory graph service.
+  network_endpoints:
+    - host: api.github.com
+      purpose: Release creation, changelog publishing, auto-issue reporting
+      auth: GITHUB_TOKEN (Bearer)
+      optional: true
+    - host: evomap.ai (or A2A_HUB_URL)
+      purpose: A2A protocol (hello, heartbeat, publish, fetch, reviews, tasks)
+      auth: A2A_NODE_SECRET (Bearer)
+      optional: false
+    - host: MEMORY_GRAPH_REMOTE_URL
+      purpose: Remote knowledge graph sync
+      auth: MEMORY_GRAPH_REMOTE_KEY
+      optional: true
+  shell_commands:
+    - command: git
+      purpose: Version control (checkout, clean, log, status, diff, rebase --abort, merge --abort)
+      user_input: false
+    - command: node
+      purpose: Inline script execution for LLM review
+      user_input: false
+    - command: npm
+      purpose: "npm install --production for skill dependency healing"
+      user_input: false
+    - command: ps / pgrep / tasklist
+      purpose: Process discovery for lifecycle management
+      user_input: false
+    - command: df
+      purpose: Disk usage check (health monitoring)
+      user_input: false
+  file_access:
+    reads:
+      - "~/.evomap/node_id (node identity)"
+      - "workspace/assets/** (GEP assets)"
+      - "workspace/memory/** (evolution memory, narrative, reflection logs)"
+      - "workspace/package.json (version info)"
+    writes:
+      - "workspace/assets/gep/** (genes, capsules, events)"
+      - "workspace/memory/** (memory graph, narrative, reflection)"
+      - "workspace/src/** (evolved code, only when changes are solidified)"
 ---
 
 # 🧬 Capability Evolver
@@ -59,13 +161,69 @@ Do not hardcode the node ID in scripts. `getNodeId()` in `src/gep/a2aProtocol.js
 
 ## Configuration
 
-| Environment Variable | Default | Description |
+### Required Environment Variables
+
+| Variable | Default | Description |
 |---|---|---|
-| `A2A_NODE_ID` | (required) | Your EvoMap node identity. Set this after node registration -- never hardcode it in scripts. Read automatically by `getNodeId()` in `a2aProtocol.js`. |
-| `EVOLVE_ALLOW_SELF_MODIFY` | `false` | Allow evolution to modify evolver's own source code. **NOT recommended for production.** Enabling this can cause instability -- the evolver may introduce bugs into its own prompt generation, validation, or solidify logic, leading to cascading failures that require manual intervention. Only enable for controlled experiments. |
-| `EVOLVE_LOAD_MAX` | `2.0` | Maximum 1-minute load average before evolver backs off. |
+| `A2A_NODE_ID` | (required) | Your EvoMap node identity. Set after node registration -- never hardcode in scripts. |
+
+### Optional Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `A2A_HUB_URL` | `https://evomap.ai` | EvoMap Hub API base URL. |
+| `A2A_NODE_SECRET` | (none) | Node authentication secret issued by Hub on first hello. Stored locally after registration. |
 | `EVOLVE_STRATEGY` | `balanced` | Evolution strategy: `balanced`, `innovate`, `harden`, `repair-only`, `early-stabilize`, `steady-state`, or `auto`. |
-| `EVOLVER_ROLLBACK_MODE` | `hard` | Rollback strategy when evolution fails. `hard`: use `git reset --hard` (destructive, original behavior). `stash`: use `git stash` to preserve changes for recovery. `none`: skip rollback entirely. Use `stash` for safer operation in active workspaces. |
+| `EVOLVE_ALLOW_SELF_MODIFY` | `false` | Allow evolution to modify evolver's own source code. **NOT recommended for production.** |
+| `EVOLVE_LOAD_MAX` | `2.0` | Maximum 1-minute load average before evolver backs off. |
+| `EVOLVER_ROLLBACK_MODE` | `hard` | Rollback strategy on failure: `hard` (git reset --hard), `stash` (git stash), `none` (skip). Use `stash` for safer operation. |
+| `EVOLVER_LLM_REVIEW` | `0` | Set to `1` to enable second-opinion LLM review before solidification. |
+| `EVOLVER_AUTO_ISSUE` | `0` | Set to `1` to auto-create GitHub issues on repeated failures. Requires `GITHUB_TOKEN`. |
+| `EVOLVER_ISSUE_REPO` | (none) | GitHub repo for auto-issue reporting (e.g. `EvoMap/evolver`). |
+| `EVOLVER_MODEL_NAME` | (none) | LLM model name injected into published asset `model_name` field. |
+| `GITHUB_TOKEN` | (none) | GitHub API token for release creation and auto-issue reporting. Also accepts `GH_TOKEN` or `GITHUB_PAT`. |
+| `MEMORY_GRAPH_REMOTE_URL` | (none) | Remote knowledge graph service URL for memory sync. |
+| `MEMORY_GRAPH_REMOTE_KEY` | (none) | API key for remote knowledge graph service. |
+| `EVOLVE_REPORT_TOOL` | (auto) | Override report tool (e.g. `feishu-card`). |
+| `RANDOM_DRIFT` | `0` | Enable random drift in evolution strategy selection. |
+
+### Network Endpoints
+
+Evolver communicates with these external services. All are authenticated and documented.
+
+| Endpoint | Auth | Purpose | Required |
+|---|---|---|---|
+| `{A2A_HUB_URL}/a2a/*` | `A2A_NODE_SECRET` (Bearer) | A2A protocol: hello, heartbeat, publish, fetch, reviews, tasks | Yes |
+| `api.github.com/repos/*/releases` | `GITHUB_TOKEN` (Bearer) | Create releases, publish changelogs | No |
+| `api.github.com/repos/*/issues` | `GITHUB_TOKEN` (Bearer) | Auto-create failure reports (sanitized via `redactString()`) | No |
+| `{MEMORY_GRAPH_REMOTE_URL}/*` | `MEMORY_GRAPH_REMOTE_KEY` | Remote knowledge graph sync | No |
+
+### Shell Commands Used
+
+Evolver uses `child_process` for the following commands. No user-controlled input is passed to shell.
+
+| Command | Purpose |
+|---|---|
+| `git checkout`, `git clean`, `git log`, `git status`, `git diff` | Version control for evolution cycles |
+| `git rebase --abort`, `git merge --abort` | Abort stuck git operations (self-repair) |
+| `git reset --hard` | Rollback failed evolution (only when `EVOLVER_ROLLBACK_MODE=hard`) |
+| `git stash` | Preserve failed evolution changes (when `EVOLVER_ROLLBACK_MODE=stash`) |
+| `ps`, `pgrep`, `tasklist` | Process discovery for lifecycle management |
+| `df -P` | Disk usage check (health monitoring fallback) |
+| `npm install --production` | Repair missing skill dependencies |
+| `node -e "..."` | Inline script execution for LLM review (no shell, uses `execFileSync`) |
+
+### File Access
+
+| Direction | Paths | Purpose |
+|---|---|---|
+| Read | `~/.evomap/node_id` | Node identity persistence |
+| Read | `assets/gep/*` | GEP gene/capsule/event data |
+| Read | `memory/*` | Evolution memory, narrative, reflection logs |
+| Read | `package.json` | Version information |
+| Write | `assets/gep/*` | Updated genes, capsules, evolution events |
+| Write | `memory/*` | Memory graph, narrative log, reflection log |
+| Write | `src/**` | Evolved code (only during solidify, with git tracking) |
 
 ## GEP Protocol (Auditable Evolution)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evomap/evolver",
-  "version": "1.29.2",
+  "version": "1.29.8",
   "description": "A GEP-powered self-evolution engine for AI agents. Features automated log analysis and Genome Evolution Protocol (GEP) for auditable, reusable evolution assets.",
   "main": "index.js",
   "bin": {

package/src/evolve.js

@@ -64,7 +64,9 @@ const TODAY_LOG = path.join(MEMORY_DIR, new Date().toISOString().split('T')[0] +
 // Ensure memory directory exists so state/cache writes work.
 try {
   if (!fs.existsSync(MEMORY_DIR)) fs.mkdirSync(MEMORY_DIR, { recursive: true });
-} catch (e) {}
+} catch (e) {
+  console.warn('[Evolver] Failed to create MEMORY_DIR (may cause downstream errors):', e && e.message || e);
+}
 
 function formatSessionLog(jsonlContent) {
   const result = [];
@@ -1041,7 +1043,9 @@ async function run() {
       try {
         const { tryReadMemoryGraphEvents } = require('./gep/memoryGraph');
         taskMemoryEvents = tryReadMemoryGraphEvents(1000);
-      } catch {}
+      } catch (e) {
+        console.warn('[TaskReceiver] MemoryGraph read failed (task selection proceeds without history):', e && e.message || e);
+      }
       const best = selectBestTask(hubTasks, taskMemoryEvents);
       if (best) {
         const alreadyClaimed = best.status === 'claimed';
@@ -1085,7 +1089,9 @@ async function run() {
         }
       }
     }
-  } catch {}
+  } catch (e) {
+    console.warn('[Commitment] Overdue task check failed (non-fatal):', e && e.message || e);
+  }
 
   // --- Worker Pool: select task from heartbeat available_work (deferred claim) ---
   // Only remember the best task and inject its signals; actual claim+complete
@@ -1099,7 +1105,9 @@ async function run() {
         try {
           const { tryReadMemoryGraphEvents } = require('./gep/memoryGraph');
           taskMemoryEvents = tryReadMemoryGraphEvents(1000);
-        } catch {}
+        } catch (e) {
+          console.warn('[WorkerPool] MemoryGraph read failed (task selection proceeds without history):', e && e.message || e);
+        }
         const best = selectBestTask(workerTasks, taskMemoryEvents);
         if (best) {
           activeTask = best;
@@ -1174,7 +1182,9 @@ async function run() {
   for (const c of newCandidates) {
     try {
       appendCandidateJsonl(c);
-    } catch (e) {}
+    } catch (e) {
+      console.warn('[Candidates] Failed to persist candidate:', e && e.message || e);
+    }
   }
   const recentCandidates = readRecentCandidates(20);
   const capabilityCandidatesPreview = renderCandidatesPreview(recentCandidates.slice(-8), 1600);
@@ -1237,7 +1247,9 @@ async function run() {
         2
       )}\n\`\`\``;
     }
-  } catch (e) {}
+  } catch (e) {
+    console.warn('[ExternalCandidates] Preview build failed (non-fatal):', e && e.message || e);
+  }
 
   // Search-First Evolution: query Hub for reusable solutions before local reasoning.
   let hubHit = null;
@@ -1425,7 +1437,9 @@ async function run() {
         .split('\n')
         .map(l => l.trim())
         .filter(Boolean);
-    } catch (e) {}
+    } catch (e) {
+      console.warn('[SolidifyState] Failed to read baseline untracked files:', e && e.message || e);
+    }
 
     try {
       const out = execSync('git rev-parse HEAD', {
@@ -1436,7 +1450,9 @@ async function run() {
         windowsHide: true,
       });
       baselineHead = String(out || '').trim() || null;
-    } catch (e) {}
+    } catch (e) {
+      console.warn('[SolidifyState] Failed to read git HEAD:', e && e.message || e);
+    }
 
     const maxFiles =
       selectedGene && selectedGene.constraints && Number.isFinite(Number(selectedGene.constraints.max_files))

package/src/gep/a2aProtocol.js

@@ -399,6 +399,7 @@ var _heartbeatStartedAt = null;
 var _heartbeatConsecutiveFailures = 0;
 var _heartbeatTotalSent = 0;
 var _heartbeatTotalFailed = 0;
+var _heartbeatFpSent = false;
 var _latestAvailableWork = [];
 var _latestOverdueTasks = [];
 var _pendingCommitmentUpdates = [];
@@ -468,12 +469,14 @@ function sendHelloToHub() {
 }
 
 function getHubNodeSecret() {
+  if (process.env.A2A_NODE_SECRET) return process.env.A2A_NODE_SECRET;
   if (_cachedHubNodeSecret) return _cachedHubNodeSecret;
   var persisted = _loadPersistedNodeSecret();
   if (persisted) {
     _cachedHubNodeSecret = persisted;
     return persisted;
   }
+  if (process.env.A2A_HUB_TOKEN) return process.env.A2A_HUB_TOKEN;
   return null;
 }
 
@@ -516,6 +519,16 @@ function sendHeartbeat() {
     meta.commitment_updates = _pendingCommitmentUpdates.splice(0);
   }
 
+  if (!_heartbeatFpSent) {
+    try {
+      var fp = captureEnvFingerprint();
+      if (fp && fp.evolver_version) {
+        meta.env_fingerprint = fp;
+        _heartbeatFpSent = true;
+      }
+    } catch {}
+  }
+
   if (Object.keys(meta).length > 0) {
     bodyObj.meta = meta;
   }

package/src/gep/assetStore.js

@@ -177,11 +177,27 @@ function readRecentCandidates(limit = 20) {
   try {
     const p = candidatesPath();
     if (!fs.existsSync(p)) return [];
-    const raw = fs.readFileSync(p, 'utf8');
-    const lines = raw.split('\n').map(l => l.trim()).filter(Boolean);
-    return lines.slice(Math.max(0, lines.length - limit)).map(l => {
-      try { return JSON.parse(l); } catch { return null; }
-    }).filter(Boolean);
+    const stat = fs.statSync(p);
+    if (stat.size < 1024 * 1024) {
+      const raw = fs.readFileSync(p, 'utf8');
+      const lines = raw.split('\n').map(l => l.trim()).filter(Boolean);
+      return lines.slice(-limit).map(l => {
+        try { return JSON.parse(l); } catch { return null; }
+      }).filter(Boolean);
+    }
+    // Large file (>1MB): only read the tail to avoid OOM.
+    const fd = fs.openSync(p, 'r');
+    try {
+      const chunkSize = Math.min(stat.size, limit * 4096);
+      const buf = Buffer.alloc(chunkSize);
+      fs.readSync(fd, buf, 0, chunkSize, stat.size - chunkSize);
+      const lines = buf.toString('utf8').split('\n').map(l => l.trim()).filter(Boolean);
+      return lines.slice(-limit).map(l => {
+        try { return JSON.parse(l); } catch { return null; }
+      }).filter(Boolean);
+    } finally {
+      fs.closeSync(fd);
+    }
   } catch { return []; }
 }
 
@@ -189,11 +205,26 @@ function readRecentExternalCandidates(limit = 50) {
   try {
     const p = externalCandidatesPath();
     if (!fs.existsSync(p)) return [];
-    const raw = fs.readFileSync(p, 'utf8');
-    const lines = raw.split('\n').map(l => l.trim()).filter(Boolean);
-    return lines.slice(Math.max(0, lines.length - limit)).map(l => {
-      try { return JSON.parse(l); } catch { return null; }
-    }).filter(Boolean);
+    const stat = fs.statSync(p);
+    if (stat.size < 1024 * 1024) {
+      const raw = fs.readFileSync(p, 'utf8');
+      const lines = raw.split('\n').map(l => l.trim()).filter(Boolean);
+      return lines.slice(-limit).map(l => {
+        try { return JSON.parse(l); } catch { return null; }
+      }).filter(Boolean);
+    }
+    const fd = fs.openSync(p, 'r');
+    try {
+      const chunkSize = Math.min(stat.size, limit * 4096);
+      const buf = Buffer.alloc(chunkSize);
+      fs.readSync(fd, buf, 0, chunkSize, stat.size - chunkSize);
+      const lines = buf.toString('utf8').split('\n').map(l => l.trim()).filter(Boolean);
+      return lines.slice(-limit).map(l => {
+        try { return JSON.parse(l); } catch { return null; }
+      }).filter(Boolean);
+    } finally {
+      fs.closeSync(fd);
+    }
   } catch { return []; }
 }
 

package/src/gep/paths.js

@@ -6,16 +6,33 @@ function getRepoRoot() {
     return process.env.EVOLVER_REPO_ROOT;
   }
 
-  let dir = path.resolve(__dirname, '..', '..');
+  const ownDir = path.resolve(__dirname, '..', '..');
+
+  // Safety: check evolver's own directory first to prevent operating on a
+  // parent repo that happens to contain .git (which could cause data loss
+  // when git reset --hard runs in the wrong scope).
+  if (fs.existsSync(path.join(ownDir, '.git'))) {
+    return ownDir;
+  }
+
+  let dir = path.dirname(ownDir);
   while (dir !== '/' && dir !== '.') {
-    const gitDir = path.join(dir, '.git');
-    if (fs.existsSync(gitDir)) {
-      return dir;
+    if (fs.existsSync(path.join(dir, '.git'))) {
+      if (process.env.EVOLVER_USE_PARENT_GIT === 'true') {
+        console.warn('[evolver] Using parent git repository at:', dir);
+        return dir;
+      }
+      console.warn(
+        '[evolver] Detected .git in parent directory', dir,
+        '-- ignoring. Set EVOLVER_USE_PARENT_GIT=true to override,',
+        'or EVOLVER_REPO_ROOT to specify the target directory explicitly.'
+      );
+      return ownDir;
     }
     dir = path.dirname(dir);
   }
 
-  return path.resolve(__dirname, '..', '..');
+  return ownDir;
 }
 
 function getWorkspaceRoot() {

package/src/gep/prompt.js

@@ -134,10 +134,14 @@ ENSURE VALID JSON SYNTAX (escape quotes in strings).
 
 3. Gene (The Knowledge)
    - Reuse/update existing ID if possible. Create new only if novel pattern.
+   - ID MUST be descriptive: gene_<descriptive_name> (e.g., gene_retry_on_timeout)
+   - NEVER use timestamps, random numbers, or tool names (cursor, vscode, etc.) in IDs
+   - summary MUST be a clear human-readable sentence describing what the Gene does
    {
      "type": "Gene",
      "schema_version": "1.5.0",
-     "id": "gene_<name>",
+     "id": "gene_<descriptive_name>",
+     "summary": "<clear description of what this gene does>",
      "category": "repair|optimize|innovate",
      "signals_match": ["<pattern>"],
      "preconditions": ["<condition>"],
@@ -439,24 +443,33 @@ When creating a new skill in skills/<name>/:
    |- assets/           (optional: templates, data files)
    Creating an empty directory or a directory missing index.js = FAILED.
    Do NOT create unnecessary files (README.md, CHANGELOG.md, INSTALLATION_GUIDE.md, etc.).
-2. SKILL.MD FRONTMATTER: Every SKILL.md MUST start with YAML frontmatter:
+2. SKILL NAMING (CRITICAL):
+   a) <name> MUST be descriptive kebab-case (e.g., "log-rotation", "retry-handler", "cache-manager")
+   b) NEVER use timestamps, random numbers, tool names (cursor, vscode), or UUIDs as names
+   c) Names like "cursor-1773331925711", "skill-12345", "fix-1" = FAILED
+   d) Name must be 2-6 descriptive words separated by hyphens, conveying what the skill does
+   e) Good: "http-retry-with-backoff", "log-file-rotation", "config-validator"
+   f) Bad: "cursor-auto-1234", "new-skill", "test-skill", "my-skill"
+3. SKILL.MD FRONTMATTER: Every SKILL.md MUST start with YAML frontmatter:
    ---
    name: <skill-name>
    description: <what it does and when to use it>
    ---
+   The name MUST follow the naming rules above.
    The description is the triggering mechanism -- include WHAT the skill does and WHEN to use it.
-3. CONCISENESS: SKILL.md body should be under 500 lines. Keep instructions lean.
+   Description must be a clear, complete sentence (min 20 chars). Generic descriptions = FAILED.
+4. CONCISENESS: SKILL.md body should be under 500 lines. Keep instructions lean.
    Only include information the agent does not already know. Move detailed reference
    material to references/ files, not into SKILL.md itself.
-4. EXPORT VERIFICATION: Every exported function must be importable.
+5. EXPORT VERIFICATION: Every exported function must be importable.
    Run: node -e "const s = require('./skills/<name>'); console.log(Object.keys(s))"
    If this fails, the skill is broken. Fix before solidify.
-5. NO HARDCODED SECRETS: Never embed API keys, tokens, or secrets in code.
+6. NO HARDCODED SECRETS: Never embed API keys, tokens, or secrets in code.
    Use process.env or .env references. Hardcoded App ID, App Secret, Bearer tokens = FAILED.
-6. TEST BEFORE SOLIDIFY: Actually run the skill's core function to verify it works:
+7. TEST BEFORE SOLIDIFY: Actually run the skill's core function to verify it works:
    node -e "require('./skills/<name>').main ? require('./skills/<name>').main() : console.log('ok')"
    Scripts in scripts/ must also be tested by executing them.
-7. ATOMIC CREATION: Create ALL files for a skill in a single cycle.
+8. ATOMIC CREATION: Create ALL files for a skill in a single cycle.
    Do not create a directory in one cycle and fill it in the next.
    Empty directories from failed cycles will be automatically cleaned up on rollback.
 

package/src/gep/skillDistiller.js

@@ -236,6 +236,20 @@ function buildDistillationPrompt(analysis, existingGenes, sampleCapsules) {
     '- constraints.forbidden_paths MUST include at least [".git", "node_modules"]',
     '- Output valid Gene JSON only (no markdown, no explanation)',
     '',
+    'GENE ID NAMING RULES (CRITICAL):',
+    '- The id suffix (after "' + DISTILLED_ID_PREFIX + '") MUST be a descriptive kebab-case name',
+    '  derived from the strategy content or signals_match (e.g., "retry-on-timeout", "log-rotation-cleanup")',
+    '- NEVER use timestamps, random numbers, tool names (cursor, vscode, etc.), or UUIDs in the id',
+    '- Good: "gene_distilled_retry-on-timeout", "gene_distilled_cache-invalidation-strategy"',
+    '- Bad: "gene_distilled_cursor-1773331925711", "gene_distilled_1234567890", "gene_distilled_fix-1"',
+    '- The id suffix must be 3+ words separated by hyphens, describing the core capability',
+    '',
+    'SUMMARY RULES:',
+    '- The "summary" field MUST be a clear, human-readable description (10-200 chars)',
+    '- It should describe WHAT the Gene does, not implementation details',
+    '- Good: "Retry failed HTTP requests with exponential backoff and circuit breaker"',
+    '- Bad: "Distilled from capsules", "AI agent skill", "cursor automation"',
+    '',
     'SUCCESSFUL CAPSULES (grouped by pattern):',
     JSON.stringify(samples, null, 2),
     '',
@@ -246,7 +260,7 @@ function buildDistillationPrompt(analysis, existingGenes, sampleCapsules) {
     JSON.stringify(analysis, null, 2),
     '',
     'Output a single Gene JSON object with these fields:',
-    '{ "type": "Gene", "id": "gene_distilled_...", "category": "...", "signals_match": [...], "preconditions": [...], "strategy": [...], "constraints": { "max_files": N, "forbidden_paths": [...] }, "validation": [...] }',
+    '{ "type": "Gene", "id": "gene_distilled_<descriptive-kebab-name>", "summary": "<clear human-readable description>", "category": "...", "signals_match": [...], "preconditions": [...], "strategy": [...], "constraints": { "max_files": N, "forbidden_paths": [...] }, "validation": [...] }',
   ].join('\n');
 }
 
@@ -254,6 +268,36 @@ function distillRequestPath() {
   return path.join(paths.getMemoryDir(), 'distill_request.json');
 }
 
+// ---------------------------------------------------------------------------
+// Derive a descriptive ID from gene content when the LLM gives a bad name
+// ---------------------------------------------------------------------------
+function deriveDescriptiveId(gene) {
+  var words = [];
+  if (Array.isArray(gene.signals_match)) {
+    gene.signals_match.slice(0, 3).forEach(function (s) {
+      String(s).toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().split(/\s+/).forEach(function (w) {
+        if (w.length >= 3 && words.length < 6) words.push(w);
+      });
+    });
+  }
+  if (words.length < 3 && gene.summary) {
+    var STOP = new Set(['the', 'and', 'for', 'with', 'from', 'that', 'this', 'into', 'when', 'are', 'was', 'has', 'had']);
+    String(gene.summary).toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().split(/\s+/).forEach(function (w) {
+      if (w.length >= 3 && !STOP.has(w) && words.length < 6) words.push(w);
+    });
+  }
+  if (words.length < 3 && Array.isArray(gene.strategy) && gene.strategy.length > 0) {
+    String(gene.strategy[0]).toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().split(/\s+/).forEach(function (w) {
+      if (w.length >= 3 && words.length < 6) words.push(w);
+    });
+  }
+  if (words.length < 2) words = ['auto', 'distilled', 'strategy'];
+  var unique = [];
+  var seen = new Set();
+  words.forEach(function (w) { if (!seen.has(w)) { seen.add(w); unique.push(w); } });
+  return DISTILLED_ID_PREFIX + unique.slice(0, 5).join('-');
+}
+
 // ---------------------------------------------------------------------------
 // Step 4: validateSynthesizedGene
 // ---------------------------------------------------------------------------
@@ -271,6 +315,27 @@ function validateSynthesizedGene(gene, existingGenes) {
     gene.id = DISTILLED_ID_PREFIX + String(gene.id).replace(/^gene_/, '');
   }
 
+  if (gene.id) {
+    var suffix = String(gene.id).replace(DISTILLED_ID_PREFIX, '');
+    var needsRename = /^\d+$/.test(suffix) || /^\d{10,}/.test(suffix)
+      || /^(cursor|vscode|vim|emacs|windsurf|copilot|cline|codex)[-_]?\d*/i.test(suffix);
+    if (needsRename) {
+      gene.id = deriveDescriptiveId(gene);
+    }
+    var cleanSuffix = String(gene.id).replace(DISTILLED_ID_PREFIX, '');
+    if (cleanSuffix.replace(/[-_]/g, '').length < 6) {
+      gene.id = deriveDescriptiveId(gene);
+    }
+  }
+
+  if (!gene.summary || typeof gene.summary !== 'string' || gene.summary.length < 10) {
+    if (Array.isArray(gene.strategy) && gene.strategy.length > 0) {
+      gene.summary = String(gene.strategy[0]).slice(0, 200);
+    } else if (Array.isArray(gene.signals_match) && gene.signals_match.length > 0) {
+      gene.summary = 'Strategy for: ' + gene.signals_match.slice(0, 3).join(', ');
+    }
+  }
+
   if (!gene.constraints || typeof gene.constraints !== 'object') gene.constraints = {};
   if (!Array.isArray(gene.constraints.forbidden_paths) || gene.constraints.forbidden_paths.length === 0) {
     gene.constraints.forbidden_paths = ['.git', 'node_modules'];

package/src/gep/skillPublisher.js

@@ -8,9 +8,38 @@ var { getHubUrl, buildHubHeaders, getNodeId } = require('./a2aProtocol');
  * @param {object} gene - Gene asset
  * @returns {string} SKILL.md content
  */
+function sanitizeSkillName(rawName) {
+  var name = rawName.replace(/[\r\n]+/g, '-').replace(/^gene_distilled_/, '').replace(/^gene_/, '').replace(/_/g, '-');
+  if (/^\d{8,}/.test(name) || /^(cursor|vscode|vim|emacs|windsurf|copilot|cline|codex)[-]?\d*$/i.test(name)) {
+    return null;
+  }
+  name = name.replace(/-?\d{10,}$/g, '').replace(/-+$/, '');
+  if (name.replace(/[-]/g, '').length < 6) return null;
+  return name;
+}
+
 function geneToSkillMd(gene) {
-  var name = (gene.id || 'unnamed-skill').replace(/^gene_distilled_/, '').replace(/_/g, '-');
-  var desc = gene.summary || 'AI agent skill distilled from evolution experience.';
+  var rawName = gene.id || 'unnamed-skill';
+  var name = sanitizeSkillName(rawName);
+  if (!name) {
+    var fallbackWords = [];
+    if (Array.isArray(gene.signals_match)) {
+      gene.signals_match.slice(0, 3).forEach(function (s) {
+        String(s).toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().split(/\s+/).forEach(function (w) {
+          if (w.length >= 3 && fallbackWords.length < 5) fallbackWords.push(w);
+        });
+      });
+    }
+    if (fallbackWords.length < 2 && gene.summary) {
+      String(gene.summary).toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().split(/\s+/).forEach(function (w) {
+        if (w.length >= 3 && fallbackWords.length < 5) fallbackWords.push(w);
+      });
+    }
+    var seen = {};
+    fallbackWords = fallbackWords.filter(function (w) { if (seen[w]) return false; seen[w] = true; return true; });
+    name = fallbackWords.length >= 2 ? fallbackWords.join('-') : 'auto-distilled-skill';
+  }
+  var desc = (gene.summary || 'AI agent skill distilled from evolution experience.').replace(/[\r\n]+/g, ' ').trim();
 
   var lines = [
     '---',
@@ -72,6 +101,11 @@ function geneToSkillMd(gene) {
     });
   }
 
+  lines.push('---');
+  lines.push('');
+  lines.push('*This Skill was generated by [Evolver](https://github.com/autogame-17/evolver) and is distributed under the [EvoMap Skill License (ESL-1.0)](https://evomap.ai/terms). Unauthorized redistribution, bulk scraping, or republishing is prohibited. See LICENSE file for full terms.*');
+  lines.push('');
+
   return lines.join('\n');
 }
 
@@ -89,7 +123,9 @@ function publishSkillToHub(gene, opts) {
 
   var content = geneToSkillMd(gene);
   var nodeId = getNodeId();
-  var skillId = 'skill_' + (gene.id || 'unnamed').replace(/^gene_/, '');
+  var fmName = content.match(/^name:\s*(.+)$/m);
+  var derivedName = fmName ? fmName[1].trim().toLowerCase().replace(/[^a-z0-9]+/g, '_') : (gene.id || 'unnamed').replace(/^gene_/, '');
+  var skillId = 'skill_' + derivedName;
 
   var body = {
     sender_id: nodeId,
@@ -146,8 +182,13 @@ function updateSkillOnHub(nodeId, skillId, content, opts, gene) {
     body: JSON.stringify(body),
     signal: AbortSignal.timeout(15000),
   })
-    .then(function (res) { return res.json(); })
-    .then(function (data) { return { ok: true, result: data }; })
+    .then(function (res) { return res.json().then(function (data) { return { status: res.status, data: data }; }); })
+    .then(function (result) {
+      if (result.status >= 200 && result.status < 300) {
+        return { ok: true, result: result.data };
+      }
+      return { ok: false, error: result.data?.error || 'update_failed', status: result.status };
+    })
     .catch(function (err) { return { ok: false, error: err.message }; });
 }
 

package/src/gep/solidify.js

@@ -136,6 +136,7 @@ function readOpenclawConstraintPolicy() {
       includeExtensions: Array.isArray(pol.includeExtensions) ? pol.includeExtensions.map(String) : defaults.includeExtensions,
     };
   } catch (_) {
+    console.warn('[evolver] readOpenclawConstraintPolicy failed:', _ && _.message || _);
     return defaults;
   }
 }
@@ -159,7 +160,9 @@ function matchAnyRegex(rel, regexList) {
   for (const raw of Array.isArray(regexList) ? regexList : []) {
     try {
       if (new RegExp(String(raw), 'i').test(rel)) return true;
-    } catch (_) {}
+    } catch (_) {
+      console.warn('[evolver] matchAnyRegex invalid pattern:', raw, _ && _.message || _);
+    }
   }
   return false;
 }
@@ -339,7 +342,9 @@ function checkConstraints({ gene, blast, blastRadiusEstimate, repoRoot }) {
         if (entries.length < 2) {
           warnings.push('incomplete_skill: skills/' + skillName + '/ has only ' + entries.length + ' file(s). New skills should have at least index.js + SKILL.md.');
         }
-      } catch (e) { /* dir might not exist yet */ }
+      } catch (e) {
+        console.warn('[evolver] checkConstraints skill dir read failed:', skillName, e && e.message || e);
+      }
     });
   }
 
@@ -381,7 +386,9 @@ function writeStateForSolidify(state) {
   const statePath = path.join(getEvolutionDir(), 'evolution_solidify_state.json');
   try {
     if (!fs.existsSync(memoryDir)) fs.mkdirSync(memoryDir, { recursive: true });
-  } catch {}
+  } catch (e) {
+    console.warn('[evolver] writeStateForSolidify mkdir failed:', memoryDir, e && e.message || e);
+  }
   const tmp = `${statePath}.tmp`;
   fs.writeFileSync(tmp, JSON.stringify(state, null, 2) + '\n', 'utf8');
   fs.renameSync(tmp, statePath);
@@ -559,7 +566,9 @@ function detectDestructiveChanges({ repoRoot, changedFiles, baselineUntracked })
           if (stat.isFile() && stat.size === 0) {
             violations.push(`CRITICAL_FILE_EMPTIED: ${norm}`);
           }
-        } catch (e) {}
+        } catch (e) {
+          console.warn('[evolver] detectDestructiveChanges stat failed:', norm, e && e.message || e);
+        }
       }
     }
   }
@@ -716,7 +725,9 @@ function rollbackNewUntrackedFiles({ repoRoot, baselineUntracked }) {
         fs.unlinkSync(normAbs);
         deleted.push(safeRel);
       }
-    } catch (e) {}
+    } catch (e) {
+      console.warn('[evolver] rollbackNewUntrackedFiles unlink failed:', safeRel, e && e.message || e);
+    }
   }
   if (skipped.length > 0) {
     console.log(`[Rollback] Skipped ${skipped.length} critical protected file(s): ${skipped.slice(0, 5).join(', ')}`);
@@ -749,7 +760,9 @@ function rollbackNewUntrackedFiles({ repoRoot, baselineUntracked }) {
         fs.rmdirSync(dirAbs);
         removedDirs.push(sortedDirs[si]);
       }
-    } catch (e) { /* ignore -- dir may already be gone */ }
+    } catch (e) {
+      console.warn('[evolver] rollbackNewUntrackedFiles rmdir failed:', sortedDirs[si], e && e.message || e);
+    }
   }
   if (removedDirs.length > 0) {
     console.log('[Rollback] Removed ' + removedDirs.length + ' empty director' + (removedDirs.length === 1 ? 'y' : 'ies') + ': ' + removedDirs.slice(0, 5).join(', '));
@@ -1226,7 +1239,9 @@ function solidify({ intent, summary, dryRun = false, rollbackOnFailure = true }
         const list = require('./assetStore').loadCapsules();
         prevCapsule = Array.isArray(list) ? list.find(c => c && c.type === 'Capsule' && String(c.id) === selectedCapsuleId) : null;
       }
-    } catch (e) {}
+    } catch (e) {
+      console.warn('[evolver] solidify loadCapsules failed:', e && e.message || e);
+    }
     const successReason = buildSuccessReason({ gene: geneUsed, signals, blast, mutation, score });
     const capsuleDiff = captureDiffSnapshot(repoRoot);
     const capsuleContent = buildCapsuleContent({ intent, gene: geneUsed, signals, blast, mutation, score });
@@ -1302,7 +1317,7 @@ function solidify({ intent, summary, dryRun = false, rollbackOnFailure = true }
       applyEpigeneticMarks(geneUsed, envFp, outcomeStatus);
       upsertGene(geneUsed);
     } catch (e) {
-      // Non-blocking: epigenetic mark failure must not break solidify
+      console.warn('[evolver] applyEpigeneticMarks failed (non-blocking):', e && e.message || e);
     }
   }
 
@@ -1326,7 +1341,9 @@ function solidify({ intent, summary, dryRun = false, rollbackOnFailure = true }
       if (personalityState) {
         updatePersonalityStats({ personalityState, outcome: outcomeStatus, score, notes: `event:${event.id}` });
       }
-    } catch (e) {}
+    } catch (e) {
+      console.warn('[evolver] updatePersonalityStats failed:', e && e.message || e);
+    }
   }
 
   const runId = lastRun && lastRun.run_id ? String(lastRun.run_id) : stableHash(`${parentEventId || 'root'}|${geneId || 'none'}|${signalKey}`);