hebbian 0.3.3 → 0.3.4

package/dist/evolve.d.ts

@@ -0,0 +1,22 @@
+import type { Episode } from './episode';
+import type { Brain } from './types';
+export interface EvolveAction {
+    type: 'grow' | 'fire' | 'signal' | 'prune' | 'decay';
+    path: string;
+    reason: string;
+    signal?: string;
+}
+export interface EvolveResult {
+    actions: EvolveAction[];
+    executed: number;
+    skipped: number;
+    dryRun: boolean;
+}
+export declare function runEvolve(brainRoot: string, dryRun: boolean): Promise<EvolveResult>;
+export declare function buildBrainSummary(brain: Brain): string;
+export declare function buildPrompt(summary: string, episodes: Episode[]): string;
+export declare function callGemini(prompt: string, apiKey: string): Promise<EvolveAction[]>;
+export declare function parseActions(text: string): EvolveAction[];
+export declare function validateActions(actions: EvolveAction[], _brain: Brain): EvolveAction[];
+export declare function executeActions(brainRoot: string, actions: EvolveAction[]): number;
+//# sourceMappingURL=evolve.d.ts.map

package/dist/evolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolve.d.ts","sourceRoot":"","sources":["../src/evolve.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAWrC,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CAChB;AAUD,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CA+CzF;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuBtD;AAID,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAsCxE;AAID,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAyDxF;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA8BzD;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,GAAG,YAAY,EAAE,CAmBtF;AAID,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CA8BjF"}

package/dist/index.d.ts

@@ -27,4 +27,6 @@ export type { HookStatus } from './hooks';
 export { digestTranscript, extractCorrections, readHookInput } from './digest';
 export type { DigestResult, ExtractedCorrection } from './digest';
 export { resolveBrainRoot } from './constants';
+export { runEvolve } from './evolve';
+export type { EvolveAction, EvolveResult } from './evolve';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG3G,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG3G,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1823,6 +1823,239 @@ function writeAuditLog(brainRoot, sessionId, entries) {
   );
   writeFileSync11(logPath, lines.join("\n") + (lines.length > 0 ? "\n" : ""), "utf8");
 }
+
+// src/evolve.ts
+var MAX_ACTIONS = 10;
+var PROTECTED_REGIONS = ["brainstem", "limbic", "sensors"];
+var DEFAULT_MODEL = "gemini-2.0-flash-lite";
+var API_TIMEOUT = 3e4;
+var RETRY_DELAY = 5e3;
+async function runEvolve(brainRoot, dryRun) {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    console.error("\u274C GEMINI_API_KEY not set. Get one at https://aistudio.google.com/apikey");
+    return { actions: [], executed: 0, skipped: 0, dryRun };
+  }
+  const episodes = readEpisodes(brainRoot);
+  const brain = scanBrain(brainRoot);
+  const summary = buildBrainSummary(brain);
+  const prompt = buildPrompt(summary, episodes);
+  let rawActions;
+  try {
+    rawActions = await callGemini(prompt, apiKey);
+  } catch (err) {
+    const msg = err.message;
+    console.log(`\u23ED\uFE0F evolve skipped: ${msg}`);
+    logEpisode(brainRoot, "evolve-error", "", msg);
+    return { actions: [], executed: 0, skipped: 0, dryRun };
+  }
+  const actions = validateActions(rawActions, brain);
+  const skipped = rawActions.length - actions.length;
+  if (actions.length === 0) {
+    console.log("\u{1F9E0} evolve: no valid actions proposed");
+    return { actions: [], executed: 0, skipped, dryRun };
+  }
+  if (dryRun) {
+    console.log(`\u{1F9E0} evolve (dry-run): ${actions.length} action(s) proposed`);
+    for (const action of actions) {
+      console.log(`  ${actionIcon(action.type)} ${action.type} ${action.path} \u2014 ${action.reason}`);
+    }
+    return { actions, executed: 0, skipped, dryRun: true };
+  }
+  const executed = executeActions(brainRoot, actions);
+  logEpisode(brainRoot, "evolve", "", `${executed} action(s) executed, ${skipped} skipped`);
+  console.log(`\u{1F9E0} evolve: ${executed} action(s) executed, ${skipped} skipped`);
+  return { actions, executed, skipped, dryRun: false };
+}
+function buildBrainSummary(brain) {
+  const lines = ["# Brain State\n"];
+  for (const region of brain.regions) {
+    const neurons = region.neurons;
+    if (neurons.length === 0 && !region.hasBomb) continue;
+    lines.push(`## ${region.name} (P${REGION_PRIORITY[region.name]})`);
+    if (region.hasBomb) lines.push("\u26A0\uFE0F BOMB active \u2014 region blocked");
+    for (const neuron of neurons) {
+      const flags = [];
+      if (neuron.isDormant) flags.push("dormant");
+      if (neuron.hasBomb) flags.push("bomb");
+      if (neuron.hasMemory) flags.push("memory");
+      if (neuron.dopamine > 0) flags.push(`dopamine:${neuron.dopamine}`);
+      const flagStr = flags.length > 0 ? ` [${flags.join(", ")}]` : "";
+      lines.push(`- ${neuron.path} (counter:${neuron.counter}, intensity:${neuron.intensity})${flagStr}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function buildPrompt(summary, episodes) {
+  const episodeLines = episodes.length > 0 ? episodes.map((e) => `- [${e.ts}] ${e.type}: ${e.path} \u2014 ${e.detail}`).join("\n") : "(no recent episodes)";
+  return `You are the evolve engine for a hebbian brain \u2014 a filesystem-based memory system for AI agents.
+
+## Axioms
+- Folder = Neuron, File = Firing Trace, Counter = Activation strength
+- 7 regions in subsumption cascade: brainstem(P0) > limbic(P1) > hippocampus(P2) > sensors(P3) > cortex(P4) > ego(P5) > prefrontal(P6)
+- Lower priority ALWAYS overrides higher priority
+- PROTECTED regions (brainstem, limbic, sensors): NEVER propose mutations for these
+
+## Current Brain
+${summary}
+
+## Recent Episodes (last ${episodes.length})
+${episodeLines}
+
+## Available Actions
+- grow: Create a new neuron at the given path (region/name). Use for recurring patterns that deserve permanent memory.
+- fire: Increment an existing neuron's counter. Use for strengthening well-confirmed rules.
+- signal: Add dopamine (reward), bomb (block), or memory signal. Use sparingly.
+- prune: Decrement a neuron's counter. Use for rules that aren't working or cause issues.
+- decay: Mark inactive neurons as dormant. Use for stale rules with no recent activity.
+
+## Constraints
+- Max ${MAX_ACTIONS} actions per cycle
+- PREFER fire over grow \u2014 strengthen existing neurons before creating new ones
+- NEVER target brainstem, limbic, or sensors regions
+- Each action needs a "reason" explaining why
+
+## Task
+Analyze the brain state and recent episodes. Propose actions to improve the brain.
+Focus on: strengthening repeatedly-used rules, pruning ineffective ones, growing new neurons from repeated patterns.
+
+Respond with a JSON array of actions:
+[{"type":"fire","path":"cortex/NO_console_log","reason":"fired 3 times in recent sessions"}]`;
+}
+async function callGemini(prompt, apiKey) {
+  const model = process.env.EVOLVE_MODEL || DEFAULT_MODEL;
+  const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
+  const body = {
+    contents: [{ parts: [{ text: prompt }] }],
+    generationConfig: {
+      responseMimeType: "application/json",
+      temperature: 0.2
+    }
+  };
+  let lastError = null;
+  for (let attempt = 0; attempt < 2; attempt++) {
+    if (attempt > 0) {
+      await new Promise((r) => setTimeout(r, RETRY_DELAY));
+    }
+    try {
+      const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(API_TIMEOUT)
+      });
+      if (!res.ok) {
+        lastError = new Error(`Gemini API ${res.status}: ${res.statusText}`);
+        continue;
+      }
+      const data = await res.json();
+      if (data.error) {
+        lastError = new Error(`Gemini error: ${data.error.message || "unknown"}`);
+        continue;
+      }
+      const text = data.candidates?.[0]?.content?.parts?.[0]?.text;
+      if (!text) {
+        lastError = new Error("Gemini returned empty response");
+        continue;
+      }
+      return parseActions(text);
+    } catch (err) {
+      lastError = err;
+      continue;
+    }
+  }
+  throw lastError || new Error("Gemini call failed");
+}
+function parseActions(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new Error(`Failed to parse LLM response as JSON: ${text.slice(0, 100)}`);
+  }
+  if (!Array.isArray(parsed)) {
+    throw new Error("LLM response is not an array");
+  }
+  const validTypes = /* @__PURE__ */ new Set(["grow", "fire", "signal", "prune", "decay"]);
+  const actions = [];
+  for (const item of parsed) {
+    if (!item || typeof item !== "object") continue;
+    const { type, path, reason, signal } = item;
+    if (typeof type !== "string" || !validTypes.has(type)) continue;
+    if (typeof path !== "string" || path.length === 0) continue;
+    if (typeof reason !== "string") continue;
+    const action = { type, path, reason };
+    if (type === "signal" && typeof signal === "string") {
+      action.signal = signal;
+    }
+    actions.push(action);
+  }
+  return actions;
+}
+function validateActions(actions, _brain) {
+  return actions.filter((action) => {
+    const region = action.path.split("/")[0];
+    if (!region || PROTECTED_REGIONS.includes(region)) {
+      console.log(`   \u{1F6E1}\uFE0F blocked: ${action.type} ${action.path} (protected region)`);
+      return false;
+    }
+    if (!REGIONS.includes(region)) {
+      console.log(`   \u26A0\uFE0F skipped: ${action.type} ${action.path} (invalid region)`);
+      return false;
+    }
+    if (action.type === "signal" && action.signal && !["dopamine", "bomb", "memory"].includes(action.signal)) {
+      console.log(`   \u26A0\uFE0F skipped: signal ${action.path} (invalid signal type: ${action.signal})`);
+      return false;
+    }
+    return true;
+  }).slice(0, MAX_ACTIONS);
+}
+function executeActions(brainRoot, actions) {
+  let executed = 0;
+  for (const action of actions) {
+    try {
+      switch (action.type) {
+        case "fire":
+          fireNeuron(brainRoot, action.path);
+          break;
+        case "grow":
+          growNeuron(brainRoot, action.path);
+          break;
+        case "signal":
+          signalNeuron(brainRoot, action.path, action.signal || "dopamine");
+          break;
+        case "prune":
+          rollbackNeuron(brainRoot, action.path);
+          break;
+        case "decay":
+          runDecay(brainRoot, 0);
+          break;
+      }
+      console.log(`   ${actionIcon(action.type)} ${action.type} ${action.path}`);
+      executed++;
+    } catch (err) {
+      console.log(`   \u26A0\uFE0F failed: ${action.type} ${action.path} \u2014 ${err.message}`);
+    }
+  }
+  return executed;
+}
+function actionIcon(type) {
+  switch (type) {
+    case "fire":
+      return "\u{1F525}";
+    case "grow":
+      return "\u{1F331}";
+    case "signal":
+      return "\u26A1";
+    case "prune":
+      return "\u2702\uFE0F";
+    case "decay":
+      return "\u{1F4A4}";
+    default:
+      return "\u2753";
+  }
+}
 export {
   DECAY_DAYS,
   DIGEST_LOG_DIR,
@@ -1869,6 +2102,7 @@ export {
   rollbackNeuron,
   runDecay,
   runDedup,
+  runEvolve,
   runSubsumption,
   scanBrain,
   signalNeuron,