@gamaze/hicortex 0.3.4 → 0.3.6

package/dist/index.js

@@ -48,6 +48,7 @@ const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const embedder_js_1 = require("./embedder.js");
 const storage = __importStar(require("./storage.js"));
+const seed_lesson_js_1 = require("./seed-lesson.js");
 const retrieval = __importStar(require("./retrieval.js"));
 const distiller_js_1 = require("./distiller.js");
 const consolidate_js_1 = require("./consolidate.js");
@@ -92,7 +93,7 @@ exports.default = {
                 const consolidateHour = config.consolidateHour ?? 2;
                 cancelConsolidation = (0, consolidate_js_1.scheduleConsolidation)(db, llm, embedder_js_1.embed, consolidateHour);
                 // Seed the bootstrap lesson on first run
-                await injectSeedLesson(db, log);
+                await (0, seed_lesson_js_1.injectSeedLesson)(db, log);
                 // Auto-add tools to tools.allow if using a restrictive profile
                 ensureToolsAllowed(log);
                 // Log stats
@@ -501,45 +502,6 @@ function ensureToolsAllowed(log) {
         // Non-fatal
     }
 }
-// ---------------------------------------------------------------------------
-// Seed lesson — injected on first run, teaches the agent to self-improve
-// ---------------------------------------------------------------------------
-const SEED_LESSON = `## Lesson: 1% Daily Self-Improvement
-
-Self-improvement protocol: Review your sessions daily. Scan for mistakes, gaps, user corrections, and friction. Identify 1-2 issues maximum. Apply one targeted fix to your instruction files (AGENT.md, IDENTITY.md, TOOLS.md, SOUL.md, or CLAUDE.md). Never overcorrect — feedback is guidance, not emergency. One fix per issue. Never rewrite entire systems. Before changing something, ask: is this a real pattern or am I reacting to noise?
-
-The flywheel: Sessions → Hicortex captures → Nightly consolidation → Lessons generated → Lessons injected into your context → You apply one fix → Better sessions tomorrow.
-
-Use hicortex_lessons to check for new insights. If a lesson has high confidence, apply it. If medium, observe for one more day. If nothing needs fixing today, skip — that's fine.
-
-**Severity:** critical
-**Confidence:** high
-**Generated:** seed-lesson`;
-async function injectSeedLesson(database, log) {
-    try {
-        // Check if seed lesson already exists (match on unique content)
-        const existing = storage.getLessons(database, 365);
-        const hasSeed = existing.some((l) => l.content.includes("1% Daily Self-Improvement") ||
-            l.source_agent === "hicortex/seed");
-        if (hasSeed)
-            return;
-        // Embed and store
-        const embedding = await (0, embedder_js_1.embed)(SEED_LESSON);
-        storage.insertMemory(database, SEED_LESSON, embedding, {
-            sourceAgent: "hicortex/seed",
-            project: "global",
-            memoryType: "lesson",
-            baseStrength: 0.95,
-            privacy: "WORK",
-        });
-        log("[hicortex] Seed lesson injected: Daily Self-Improvement Protocol");
-    }
-    catch (err) {
-        // Non-fatal — log but don't crash the plugin
-        const msg = err instanceof Error ? err.message : String(err);
-        log(`[hicortex] Warning: could not inject seed lesson: ${msg}`);
-    }
-}
 function formatToolResults(results) {
     if (results.length === 0) {
         return {

package/dist/init.js

@@ -183,25 +183,38 @@ Becomes a call to hicortex_ingest with:
 name: hicortex-activate
 description: Activate a Hicortex license key for unlimited memory. Use after purchasing at hicortex.gamaze.com.
 argument-hint: <license-key>
-allowed-tools: Bash(mkdir:*), Bash(echo:*), mcp__hicortex__hicortex_ingest, mcp__hicortex__hicortex_search, mcp__hicortex__hicortex_context, mcp__hicortex__hicortex_lessons
+allowed-tools: Bash(mkdir:*), Bash(echo:*), Bash(launchctl:*), Bash(systemctl:*), Bash(curl:*), mcp__hicortex__hicortex_ingest, mcp__hicortex__hicortex_search, mcp__hicortex__hicortex_context, mcp__hicortex__hicortex_lessons
 ---
 
 # Activate Hicortex License
 
 ## If key provided (e.g. /hicortex-activate hctx-abc123)
 
-Write the key to the config file:
+1. Write the key to the config file:
 
 \`\`\`bash
 mkdir -p ~/.hicortex
 echo '{ "licenseKey": "THE_KEY_HERE" }' > ~/.hicortex/config.json
 \`\`\`
 
-Then tell the user: "License activated! Hicortex now has unlimited memory. Restart the server to apply."
+2. Restart the server to apply:
 
-Provide the restart command for their platform:
-- macOS: \`launchctl kickstart -k gui/$(id -u)/com.gamaze.hicortex\`
-- Linux: \`systemctl --user restart hicortex\`
+On macOS:
+\`\`\`bash
+launchctl kickstart -k gui/$(id -u)/com.gamaze.hicortex
+\`\`\`
+
+On Linux:
+\`\`\`bash
+systemctl --user restart hicortex
+\`\`\`
+
+3. Verify the server is back:
+\`\`\`bash
+curl -s http://127.0.0.1:8787/health
+\`\`\`
+
+4. Tell the user: "License activated! Hicortex now has unlimited memory."
 
 ## If no key provided
 

package/dist/mcp-server.js

@@ -60,6 +60,7 @@ const embedder_js_1 = require("./embedder.js");
 const storage = __importStar(require("./storage.js"));
 const retrieval = __importStar(require("./retrieval.js"));
 const consolidate_js_1 = require("./consolidate.js");
+const seed_lesson_js_1 = require("./seed-lesson.js");
 // ---------------------------------------------------------------------------
 // Server state
 // ---------------------------------------------------------------------------
@@ -84,7 +85,7 @@ function createMcpServer() {
     // -- hicortex_search --
     server.tool("hicortex_search", "Search long-term memory using semantic similarity. Returns the most relevant memories from past sessions.", {
         query: zod_1.z.string().describe("Search query text"),
-        limit: zod_1.z.number().optional().describe("Max results (default 5)"),
+        limit: zod_1.z.coerce.number().optional().describe("Max results (default 5)"),
         project: zod_1.z.string().optional().describe("Filter by project name"),
     }, async ({ query, limit, project }) => {
         if (!db)
@@ -100,7 +101,7 @@ function createMcpServer() {
     // -- hicortex_context --
     server.tool("hicortex_context", "Get recent context memories, optionally filtered by project. Useful to recall what happened recently.", {
         project: zod_1.z.string().optional().describe("Filter by project name"),
-        limit: zod_1.z.number().optional().describe("Max results (default 10)"),
+        limit: zod_1.z.coerce.number().optional().describe("Max results (default 10)"),
     }, async ({ project, limit }) => {
         if (!db)
             return { content: [{ type: "text", text: "Hicortex not initialized" }], isError: true };
@@ -148,7 +149,7 @@ function createMcpServer() {
     });
     // -- hicortex_lessons --
     server.tool("hicortex_lessons", "Get actionable lessons learned from past sessions. Auto-generated insights about mistakes to avoid.", {
-        days: zod_1.z.number().optional().describe("Look back N days (default 7)"),
+        days: zod_1.z.coerce.number().optional().describe("Look back N days (default 7)"),
         project: zod_1.z.string().optional().describe("Filter by project name"),
     }, async ({ days, project }) => {
         if (!db)
@@ -193,6 +194,8 @@ async function startServer(options = {}) {
     // Schedule nightly consolidation
     const consolidateHour = options.consolidateHour ?? 2;
     cancelConsolidation = (0, consolidate_js_1.scheduleConsolidation)(db, llm, embedder_js_1.embed, consolidateHour);
+    // Seed lesson on first run
+    await (0, seed_lesson_js_1.injectSeedLesson)(db);
     // Stats
     const stats = (0, db_js_1.getStats)(db, dbPath);
     console.log(`[hicortex] Ready: ${stats.memories} memories, ${stats.links} links, ` +

package/dist/seed-lesson.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Seed lesson — injected on first run, teaches agents to self-improve.
+ * Shared between OC plugin and CC MCP server.
+ */
+import type Database from "better-sqlite3";
+export declare const SEED_LESSON = "## Lesson: 1% Daily Self-Improvement\n\nSelf-improvement protocol: Review your sessions daily. Scan for mistakes, gaps, user corrections, and friction. Identify 1-2 issues maximum. Apply one targeted fix to your instruction files (AGENT.md, IDENTITY.md, TOOLS.md, SOUL.md, or CLAUDE.md). Never overcorrect \u2014 feedback is guidance, not emergency. One fix per issue. Never rewrite entire systems. Before changing something, ask: is this a real pattern or am I reacting to noise?\n\nThe flywheel: Sessions \u2192 Hicortex captures \u2192 Nightly consolidation \u2192 Lessons generated \u2192 Lessons injected into your context \u2192 You apply one fix \u2192 Better sessions tomorrow.\n\nUse hicortex_lessons to check for new insights. If a lesson has high confidence, apply it. If medium, observe for one more day. If nothing needs fixing today, skip \u2014 that's fine.\n\n**Severity:** critical\n**Confidence:** high\n**Generated:** seed-lesson";
+export declare function injectSeedLesson(database: Database.Database, log?: (msg: string) => void): Promise<void>;

package/dist/seed-lesson.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Seed lesson — injected on first run, teaches agents to self-improve.
+ * Shared between OC plugin and CC MCP server.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEED_LESSON = void 0;
+exports.injectSeedLesson = injectSeedLesson;
+const embedder_js_1 = require("./embedder.js");
+const storage = __importStar(require("./storage.js"));
+exports.SEED_LESSON = `## Lesson: 1% Daily Self-Improvement
+
+Self-improvement protocol: Review your sessions daily. Scan for mistakes, gaps, user corrections, and friction. Identify 1-2 issues maximum. Apply one targeted fix to your instruction files (AGENT.md, IDENTITY.md, TOOLS.md, SOUL.md, or CLAUDE.md). Never overcorrect — feedback is guidance, not emergency. One fix per issue. Never rewrite entire systems. Before changing something, ask: is this a real pattern or am I reacting to noise?
+
+The flywheel: Sessions → Hicortex captures → Nightly consolidation → Lessons generated → Lessons injected into your context → You apply one fix → Better sessions tomorrow.
+
+Use hicortex_lessons to check for new insights. If a lesson has high confidence, apply it. If medium, observe for one more day. If nothing needs fixing today, skip — that's fine.
+
+**Severity:** critical
+**Confidence:** high
+**Generated:** seed-lesson`;
+async function injectSeedLesson(database, log = console.log) {
+    try {
+        const existing = storage.getLessons(database, 365);
+        const hasSeed = existing.some((l) => l.content.includes("1% Daily Self-Improvement") ||
+            l.source_agent === "hicortex/seed");
+        if (hasSeed)
+            return;
+        const embedding = await (0, embedder_js_1.embed)(exports.SEED_LESSON);
+        storage.insertMemory(database, exports.SEED_LESSON, embedding, {
+            sourceAgent: "hicortex/seed",
+            project: "global",
+            memoryType: "lesson",
+            baseStrength: 0.95,
+            privacy: "WORK",
+        });
+        log("[hicortex] Seed lesson injected: Daily Self-Improvement Protocol");
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`[hicortex] Warning: could not inject seed lesson: ${msg}`);
+    }
+}

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "hicortex",
   "name": "Hicortex — Long-term Memory That Learns",
   "description": "Your agents remember past decisions, avoid repeated mistakes, and get smarter every day. Nightly reflection generates actionable lessons that automatically update agent behavior.",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "kind": "lifecycle",
   "skills": ["./skills/hicortex-memory", "./skills/hicortex-learn", "./skills/hicortex-activate"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Human-like memory for self-improving AI agents. Automatic capturing, nightly reflection, and cross-agent learning. Works with Claude Code and OpenClaw.",
   "main": "dist/index.js",
   "bin": {