@gamaze/hicortex 0.3.3 → 0.3.5

package/dist/init.js

@@ -73,13 +73,21 @@ async function detect() {
         result.ocPlugin = "hicortex" in entries || "hicortex" in installs || "hicortex-memory" in entries;
     }
     catch { /* no OC config */ }
-    // Check CC MCP registration
-    try {
-        const raw = (0, node_fs_1.readFileSync)(CC_SETTINGS, "utf-8");
-        const settings = JSON.parse(raw);
-        result.ccMcpRegistered = "hicortex" in (settings?.mcpServers ?? {});
+    // Check CC MCP registration (claude mcp add writes to .claude.json, not settings.json)
+    for (const configPath of [
+        (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude.json"),
+        CC_SETTINGS,
+    ]) {
+        try {
+            const raw = (0, node_fs_1.readFileSync)(configPath, "utf-8");
+            const settings = JSON.parse(raw);
+            if ("hicortex" in (settings?.mcpServers ?? {})) {
+                result.ccMcpRegistered = true;
+                break;
+            }
+        }
+        catch { /* file doesn't exist */ }
     }
-    catch { /* no CC settings */ }
     // Check existing DB
     const canonicalDb = (0, node_path_1.join)(HICORTEX_HOME, "hicortex.db");
     const legacyDb = (0, node_path_1.join)((0, node_os_1.homedir)(), ".openclaw", "data", "hicortex.db");
@@ -125,26 +133,60 @@ function registerCcMcp(serverUrl) {
 function installCcCommands() {
     (0, node_fs_1.mkdirSync)(CC_COMMANDS_DIR, { recursive: true });
     // /learn command
-    const learnContent = `# Save Learning to Hicortex
+    const learnContent = `---
+name: learn
+description: Save an explicit learning/insight to Hicortex long-term memory. Immediate storage, no nightly wait. Use when you discover something worth remembering across sessions.
+argument-hint: <learning to save>
+allowed-tools: mcp__hicortex__hicortex_ingest, mcp__hicortex__hicortex_search, mcp__hicortex__hicortex_context, mcp__hicortex__hicortex_lessons
+---
 
-When invoked with \`/learn <text>\`, store the learning in long-term memory.
+# Save Learning to Hicortex
+
+When invoked with \`/learn <text>\`, store the learning in long-term memory via the Hicortex MCP tool.
 
 ## Steps
 
 1. Parse the text after \`/learn\`
-2. Clean it up into a clear, self-contained statement
-3. Add today's date
-4. Call the \`hicortex_ingest\` tool with:
-   - \`content\`: The learning text prefixed with "LEARNING: "
+2. Clean it up into a clear, self-contained statement that will make sense months from now
+3. Include the "why" when relevant
+4. Add today's date for temporal context
+5. Call the \`hicortex_ingest\` tool with:
+   - \`content\`: The learning text prefixed with "LEARNING: " and suffixed with the date
    - \`project\`: "global" (unless clearly project-specific)
    - \`memory_type\`: "lesson"
-5. Confirm what was saved (brief, one line)
+6. Confirm what was saved (brief, one line)
+
+## Example
+
+\`/learn z.ai API uses Bearer auth on all endpoints, not x-api-key\`
+
+Becomes a call to hicortex_ingest with:
+- content: "LEARNING: z.ai API uses Bearer auth on all three endpoints (paas, coding, anthropic). Not x-api-key. (2026-03-26)"
+- memory_type: "lesson"
 `;
-    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(CC_COMMANDS_DIR, "learn.md"), learnContent);
+    const learnPath = (0, node_path_1.join)(CC_COMMANDS_DIR, "learn.md");
+    if ((0, node_fs_1.existsSync)(learnPath)) {
+        // Check if it's ours (contains hicortex_ingest)
+        const existing = (0, node_fs_1.readFileSync)(learnPath, "utf-8");
+        if (!existing.includes("hicortex_ingest") && !existing.includes("hicortex")) {
+            console.log(`  ⚠ Skipping /learn — existing command found (not Hicortex). Won't overwrite.`);
+        }
+        else {
+            (0, node_fs_1.writeFileSync)(learnPath, learnContent);
+        }
+    }
+    else {
+        (0, node_fs_1.writeFileSync)(learnPath, learnContent);
+    }
     // /hicortex-activate command
-    const activateContent = `# Activate Hicortex License
+    const activateContent = `---
+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
+---
 
-When the user wants to activate their license key:
+# Activate Hicortex License
 
 ## If key provided (e.g. /hicortex-activate hctx-abc123)
 
@@ -152,12 +194,14 @@ Write the key to the config file:
 
 \`\`\`bash
 mkdir -p ~/.hicortex
-cat > ~/.hicortex/config.json << 'EOF'
-{ "licenseKey": "THE_KEY_HERE" }
-EOF
+echo '{ "licenseKey": "THE_KEY_HERE" }' > ~/.hicortex/config.json
 \`\`\`
 
-Then tell the user: "License activated! Hicortex now has unlimited memory. Restart the server to apply: \`launchctl stop com.gamaze.hicortex && launchctl start com.gamaze.hicortex\`"
+Then tell the user: "License activated! Hicortex now has unlimited memory. 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\`
 
 ## If no key provided
 

package/dist/mcp-server.js

@@ -67,7 +67,12 @@ let db = null;
 let llm = null;
 let cancelConsolidation = null;
 let stateDir = "";
-const VERSION = "0.3.0";
+let VERSION = "0.3.x";
+try {
+    const pkg = JSON.parse(require("node:fs").readFileSync(require("node:path").join(__dirname, "..", "package.json"), "utf-8"));
+    VERSION = pkg.version;
+}
+catch { /* fallback */ }
 // ---------------------------------------------------------------------------
 // MCP Server setup
 // ---------------------------------------------------------------------------
@@ -79,7 +84,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)
@@ -95,7 +100,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 };
@@ -143,7 +148,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)

package/dist/uninstall.js

@@ -56,17 +56,24 @@ async function runUninstall() {
         }
         catch { /* not installed */ }
     }
-    // 2. Remove MCP from CC settings
+    // 2. Remove MCP from CC
     try {
-        const raw = (0, node_fs_1.readFileSync)(CC_SETTINGS, "utf-8");
-        const settings = JSON.parse(raw);
-        if (settings?.mcpServers?.hicortex) {
-            delete settings.mcpServers.hicortex;
-            (0, node_fs_1.writeFileSync)(CC_SETTINGS, JSON.stringify(settings, null, 2));
-            console.log("  ✓ Removed MCP server from CC settings");
+        (0, node_child_process_1.execSync)("claude mcp remove hicortex 2>/dev/null", { encoding: "utf-8", stdio: "pipe" });
+        console.log("  ✓ Removed MCP server via claude CLI");
+    }
+    catch {
+        // Fallback: remove from settings.json directly
+        try {
+            const raw = (0, node_fs_1.readFileSync)(CC_SETTINGS, "utf-8");
+            const settings = JSON.parse(raw);
+            if (settings?.mcpServers?.hicortex) {
+                delete settings.mcpServers.hicortex;
+                (0, node_fs_1.writeFileSync)(CC_SETTINGS, JSON.stringify(settings, null, 2));
+                console.log("  ✓ Removed MCP server from CC settings");
+            }
         }
+        catch { /* no settings */ }
     }
-    catch { /* no settings */ }
     // 3. Remove CC custom commands
     for (const cmd of ["learn.md", "hicortex-activate.md"]) {
         const cmdPath = (0, node_path_1.join)(CC_COMMANDS_DIR, cmd);

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.3",
+  "version": "0.3.5",
   "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.3",
+  "version": "0.3.5",
   "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": {