@gamaze/hicortex 0.2.1 → 0.3.1

package/dist/transcript-reader.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * CC transcript reader — reads Claude Code .jsonl session files.
+ *
+ * CC stores transcripts at ~/.claude/projects/<project-hash>/<session-uuid>.jsonl.
+ * Each line is a JSON object with type, message, timestamp, etc.
+ *
+ * The reader scans for new sessions since the last nightly run
+ * and feeds them to the existing distiller pipeline.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCcTranscripts = readCcTranscripts;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const CC_PROJECTS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "projects");
+/**
+ * Read all CC transcripts modified since `since`.
+ * Returns one batch per session file.
+ */
+function readCcTranscripts(since, projectsDir = CC_PROJECTS_DIR) {
+    const batches = [];
+    let projectDirs;
+    try {
+        projectDirs = (0, node_fs_1.readdirSync)(projectsDir);
+    }
+    catch {
+        return []; // No CC projects directory
+    }
+    for (const projectDir of projectDirs) {
+        const projectPath = (0, node_path_1.join)(projectsDir, projectDir);
+        let stat;
+        try {
+            stat = (0, node_fs_1.statSync)(projectPath);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        const projectName = decodeProjectDirName(projectDir);
+        let files;
+        try {
+            files = (0, node_fs_1.readdirSync)(projectPath);
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            if (!file.endsWith(".jsonl"))
+                continue;
+            const filePath = (0, node_path_1.join)(projectPath, file);
+            let fileStat;
+            try {
+                fileStat = (0, node_fs_1.statSync)(filePath);
+            }
+            catch {
+                continue;
+            }
+            // Skip files not modified since last run
+            if (fileStat.mtime <= since)
+                continue;
+            const batch = parseTranscriptFile(filePath, projectName);
+            if (batch) {
+                batches.push(batch);
+            }
+        }
+    }
+    return batches;
+}
+/**
+ * Parse a single .jsonl transcript file into a batch.
+ * Returns null if the file has too few meaningful entries.
+ */
+function parseTranscriptFile(filePath, projectName) {
+    let raw;
+    try {
+        raw = (0, node_fs_1.readFileSync)(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    const lines = raw.split("\n").filter((l) => l.trim());
+    if (lines.length < 4)
+        return null; // Too short to be meaningful
+    const entries = [];
+    let lastTimestamp = "";
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            entries.push(entry);
+            if (entry.timestamp) {
+                lastTimestamp = entry.timestamp;
+            }
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    if (entries.length < 4)
+        return null;
+    // Extract session ID from filename (UUID.jsonl)
+    const sessionId = (0, node_path_1.basename)(filePath, ".jsonl");
+    return {
+        sessionId,
+        projectName,
+        date: lastTimestamp
+            ? lastTimestamp.slice(0, 10)
+            : new Date().toISOString().slice(0, 10),
+        entries,
+    };
+}
+/**
+ * Decode CC project directory name to a human-readable project name.
+ * CC uses path-based hashing: "-Users-mattias-Development-Tools-hicortex"
+ * becomes "hicortex" (last path component).
+ */
+function decodeProjectDirName(dirName) {
+    // CC encodes paths by replacing / with -
+    // e.g. "-Users-mattias-Development-Tools-hicortex"
+    const parts = dirName.split("-").filter(Boolean);
+    if (parts.length === 0)
+        return dirName;
+    // Use the last meaningful path component as project name
+    return parts[parts.length - 1];
+}

package/dist/uninstall.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Hicortex uninstall — clean removal of CC integration.
+ * Preserves the database (user data).
+ */
+export declare function runUninstall(): Promise<void>;

package/dist/uninstall.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Hicortex uninstall — clean removal of CC integration.
+ * Preserves the database (user data).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUninstall = runUninstall;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const node_child_process_1 = require("node:child_process");
+const node_readline_1 = require("node:readline");
+const claude_md_js_1 = require("./claude-md.js");
+const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const CC_SETTINGS = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "settings.json");
+const CC_COMMANDS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "commands");
+const CLAUDE_MD = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "CLAUDE.md");
+async function ask(question) {
+    const rl = (0, node_readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function runUninstall() {
+    console.log("Hicortex — Uninstall CC Integration\n");
+    const answer = await ask("This will remove Hicortex from Claude Code. Your memory database is preserved. Continue? [y/N] ");
+    if (answer.toLowerCase() !== "y") {
+        console.log("Cancelled.");
+        return;
+    }
+    console.log();
+    // 1. Stop and remove daemon
+    const os = (0, node_os_1.platform)();
+    if (os === "darwin") {
+        const plistPath = (0, node_path_1.join)((0, node_os_1.homedir)(), "Library", "LaunchAgents", "com.gamaze.hicortex.plist");
+        if ((0, node_fs_1.existsSync)(plistPath)) {
+            try {
+                (0, node_child_process_1.execSync)(`launchctl unload ${plistPath} 2>/dev/null`);
+            }
+            catch { /* not loaded */ }
+            (0, node_fs_1.unlinkSync)(plistPath);
+            console.log("  ✓ Removed launchd daemon");
+        }
+    }
+    else if (os === "linux") {
+        try {
+            (0, node_child_process_1.execSync)("systemctl --user disable --now hicortex.service 2>/dev/null");
+            const servicePath = (0, node_path_1.join)((0, node_os_1.homedir)(), ".config", "systemd", "user", "hicortex.service");
+            if ((0, node_fs_1.existsSync)(servicePath))
+                (0, node_fs_1.unlinkSync)(servicePath);
+            (0, node_child_process_1.execSync)("systemctl --user daemon-reload 2>/dev/null");
+            console.log("  ✓ Removed systemd service");
+        }
+        catch { /* not installed */ }
+    }
+    // 2. Remove MCP from CC settings
+    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 */ }
+    // 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);
+        if ((0, node_fs_1.existsSync)(cmdPath)) {
+            (0, node_fs_1.unlinkSync)(cmdPath);
+        }
+    }
+    console.log("  ✓ Removed /learn and /hicortex-activate commands");
+    // 4. Remove CLAUDE.md block
+    if ((0, claude_md_js_1.removeLessonsBlock)(CLAUDE_MD)) {
+        console.log("  ✓ Removed Hicortex Learnings block from CLAUDE.md");
+    }
+    console.log(`\n✓ Uninstalled. Database preserved at ${HICORTEX_HOME}/hicortex.db`);
+    console.log("  To remove all data: rm -rf ~/.hicortex");
+}

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.2.1",
+  "version": "0.3.1",
   "kind": "lifecycle",
   "skills": ["./skills/hicortex-memory", "./skills/hicortex-learn", "./skills/hicortex-activate"],
   "configSchema": {

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.2.1",
-  "description": "Human-like memory for self-improving AI agents. Automatic capturing, nightly reflection, and cross-agent learning. OpenClaw plugin.",
+  "version": "0.3.1",
+  "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": {
+    "hicortex": "dist/cli.js"
+  },
   "openclaw": {
-    "extensions": ["./dist/index.js"]
+    "extensions": [
+      "./dist/index.js"
+    ]
   },
   "types": "dist/index.d.ts",
   "files": [
@@ -20,10 +25,11 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "typescript": "^5.4.0",
-    "vitest": "^3.0.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/express": "^5.0.6",
     "@types/node": "^22.0.0",
-    "@types/better-sqlite3": "^7.6.0"
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
   },
   "engines": {
     "node": ">=18"
@@ -35,8 +41,10 @@
     "directory": "packages/openclaw-plugin"
   },
   "dependencies": {
+    "@huggingface/transformers": "^3.0.0",
+    "@modelcontextprotocol/sdk": "^1.28.0",
     "better-sqlite3": "^11.0.0",
-    "sqlite-vec": "^0.1.7",
-    "@huggingface/transformers": "^3.0.0"
+    "express": "^4.21.0",
+    "sqlite-vec": "^0.1.7"
   }
-}
+}