haansi 0.1.12 → 0.1.14

package/README.md

@@ -0,0 +1,83 @@
+# Haansi CLI
+
+Session collector and MCP server for Claude Code. Uploads Claude Code session data to the Haansi platform for mining, search, and knowledge retrieval.
+
+Published to npm as `haansi`.
+
+## Installation
+
+```bash
+npm install -g haansi
+```
+
+Requires Node.js >= 18.0.0.
+
+## Authentication
+
+The CLI uses `hsk_` tokens for authentication. Generate a token at https://app.haansi.co/settings/tokens.
+
+```bash
+haansi init
+```
+
+This prompts for your token, validates it against the API, and saves it to `~/.haansi/credentials.json` (mode 0600). Alternatively, set the `HAANSI_TOKEN` environment variable.
+
+## Commands
+
+| Command                           | Description                                              |
+| --------------------------------- | -------------------------------------------------------- |
+| `haansi init`                     | Authenticate and save your API token                     |
+| `haansi collect`                  | Upload new/changed Claude sessions (once)                |
+| `haansi daemon`                   | Run the collector on a schedule (every 30 min)           |
+| `haansi setup-daemon`             | Install macOS launchd service for auto-start on login    |
+| `haansi setup-mcp`                | Add haansi-solutions MCP entry to `~/.claude.json`       |
+| `haansi mcp-server`               | Start the Haansi MCP server (stdio, used by Claude Code) |
+| `haansi config get [key]`         | Show preferences (e.g. `session_mode`)                   |
+| `haansi config set <key> <val>`   | Update a preference                                      |
+| `haansi search-solutions <query>` | Semantic search over mined solutions                     |
+| `haansi list-solutions`           | List recent mined solutions                              |
+| `haansi search-knowledge <query>` | Search knowledge artifacts                               |
+| `haansi save-knowledge`           | Save a problem/solution for future retrieval             |
+
+### Collect options
+
+- `--force-all` -- Re-upload all sessions, not just new ones
+- `--dry-run` -- Scan without uploading
+- `--limit <n>` -- Upload at most n sessions
+
+## Configuration
+
+| Environment Variable      | Description                               | Default                 |
+| ------------------------- | ----------------------------------------- | ----------------------- |
+| `HAANSI_TOKEN`            | API token (alternative to `haansi init`)  | --                      |
+| `HAANSI_API_URL`          | API base URL                              | `https://api.haansi.co` |
+| `CLAUDE_PROJECT_PATH`     | Collect from a specific project path only | --                      |
+| `CLAUDE_COLLECT_SCHEDULE` | Cron expression for daemon                | `*/30 * * * *`          |
+
+### User preferences
+
+Set via `haansi config set <key> <value>`:
+
+- `session_mode` -- `private` or `org` (default: `org`)
+
+## Daemon (macOS)
+
+```bash
+haansi setup-daemon            # install and start
+haansi setup-daemon --uninstall # stop and remove
+```
+
+Installs a launchd plist at `~/Library/LaunchAgents/co.haansi.daemon.plist`. Logs are written to `~/.haansi/daemon.log`.
+
+## MCP Server
+
+```bash
+haansi setup-mcp
+```
+
+Registers `haansi-solutions` in `~/.claude.json` so Claude Code auto-starts the MCP server, providing search and knowledge tools directly in the AI assistant.
+
+---
+
+**Package:** `haansi`
+**Location:** `apps/cli/`

package/dist/haansi.js

@@ -39,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "haansi",
-      version: "0.1.12",
+      version: "0.1.14",
       description: "Haansi CLI - Session collector and MCP server for Claude Code",
       bin: {
         haansi: "./dist/haansi.js"
@@ -567,7 +567,6 @@ function extractGitInfo(projectDir, sessionTimestamp, sessionBranch) {
   try {
     (0, import_child_process.execSync)("git rev-parse --is-inside-work-tree", { ...opts, stdio: "pipe" });
   } catch {
-    console.warn(`[collector] Not a git repo: ${projectDir}`);
     return empty;
   }
   const result = { ...empty };
@@ -577,7 +576,6 @@ function extractGitInfo(projectDir, sessionTimestamp, sessionBranch) {
       stdio: "pipe"
     }).trim() || null;
   } catch {
-    console.warn(`[collector] No git remote for: ${projectDir}`);
   }
   if (sessionTimestamp) {
     const branch = sessionBranch ?? "HEAD";
@@ -593,7 +591,6 @@ function extractGitInfo(projectDir, sessionTimestamp, sessionBranch) {
     try {
       result.gitCommit = (0, import_child_process.execSync)("git rev-parse HEAD", { ...opts, stdio: "pipe" }).trim() || null;
     } catch {
-      console.warn(`[collector] No git commits in: ${projectDir}`);
     }
   }
   try {
@@ -699,7 +696,10 @@ async function getUploadedSessions(apiUrl, token) {
     const data = await apiGet("/sessions/uploaded", apiUrl, token);
     const map2 = /* @__PURE__ */ new Map();
     for (const s of data.sessions) {
-      map2.set(s.sessionId, s.lineCount);
+      map2.set(s.sessionId, {
+        lineCount: s.lineCount,
+        hasGitMeta: s.hasGitMeta ?? false
+      });
     }
     return map2;
   } catch {
@@ -749,8 +749,8 @@ async function collect(options) {
   const remoteMap = options.forceAll ? /* @__PURE__ */ new Map() : await getUploadedSessions(apiUrl, token);
   const toUpload = [];
   for (const session of localSessions) {
-    const remoteLine = remoteMap.get(session.sessionId);
-    if (remoteLine !== void 0 && remoteLine >= session.lineCount) {
+    const remote = remoteMap.get(session.sessionId);
+    if (remote && remote.lineCount >= session.lineCount && remote.hasGitMeta) {
       skipped++;
     } else {
       toUpload.push(session);
@@ -811,10 +811,6 @@ async function main() {
     dryRun,
     limit
   });
-  console.log(
-    `
-Collector done: ${uploaded} uploaded, ${skipped} unchanged, ${errors} errors`
-  );
   if (errors > 0) process.exit(1);
 }
 var import_dotenv, import_path, import_fs, import_os, import_zlib, import_child_process, logger, DEFAULT_API_URL2, CREDENTIALS_FILE2, CLAUDE_PROJECTS_DIR, MIN_LINES, EDGE_SCRUB_PATTERNS;
@@ -56675,13 +56671,9 @@ function resolveToken2() {
 function triggerCollectInBackground() {
   if (isCollecting) return;
   isCollecting = true;
-  collect({}).then(({ uploaded, skipped, errors }) => {
-    console.error(
-      `[mcp-server] Collection done: ${uploaded} uploaded, ${skipped} unchanged, ${errors} errors`
-    );
+  collect({}).then(() => {
     lastCollectTime = Date.now();
-  }).catch((err) => {
-    console.error("[mcp-server] Collection error:", err.message);
+  }).catch(() => {
   }).finally(() => {
     isCollecting = false;
   });
@@ -56723,23 +56715,10 @@ async function apiPost(path, body, options) {
 async function main3() {
   try {
     await apiGet2("/sessions/recent?limit=1");
-    console.error("[mcp-server] API connection ok");
-  } catch (err) {
-    console.error(
-      "[mcp-server] WARNING: API connection check failed:",
-      err.message
-    );
+  } catch {
   }
   try {
-    const data = await apiGet2("/users/me/preferences");
-    const mode = data?.preferences?.session_mode;
-    if (!mode) {
-      console.error(
-        '[mcp-server] Session mode not configured. Defaulting to "org" (team-wide). To change: haansi config set session_mode private'
-      );
-    } else {
-      console.error(`[mcp-server] Session mode: ${mode}`);
-    }
+    await apiGet2("/users/me/preferences");
   } catch {
   }
   triggerCollectInBackground();
@@ -56760,15 +56739,10 @@ async function main3() {
     app.get("/health", (_req, res) => {
       res.json({ status: "ok", service: "haansi-solutions-mcp" });
     });
-    app.listen(PORT, () => {
-      console.error(
-        `[mcp-server] Haansi Solutions MCP server running on HTTP port ${PORT}`
-      );
-    });
+    app.listen(PORT);
   } else {
     const transport = new StdioServerTransport();
     await mcpServer.connect(transport);
-    console.error("[mcp-server] haansi-solutions MCP server running on stdio");
   }
 }
 var import_dotenv3, import_path3, import_fs2, import_os2, DEFAULT_API_URL3, CREDENTIALS_FILE3, API_URL, TOKEN, contextSchema, isCollecting, lastCollectTime, COLLECT_COOLDOWN_MS, mcpServer, server;
@@ -56790,9 +56764,6 @@ var init_mcp_server2 = __esm({
     API_URL = process.env.HAANSI_API_URL ?? DEFAULT_API_URL3;
     TOKEN = resolveToken2();
     if (!TOKEN) {
-      console.error(
-        "[mcp-server] ERROR: HAANSI_TOKEN is required (or set in ~/.haansi/credentials.json)"
-      );
       process.exit(1);
     }
     contextSchema = {
@@ -56915,6 +56886,10 @@ var init_mcp_server2 = __esm({
                 type: "string",
                 description: "Git remote origin URL (e.g. github.com/org/repo)"
               },
+              git_commit: {
+                type: "string",
+                description: "Git commit hash for the code changes"
+              },
               tags: {
                 type: "array",
                 items: { type: "string" },
@@ -56938,7 +56913,6 @@ var init_mcp_server2 = __esm({
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
       maybeCollect();
       const { name, arguments: args } = request.params;
-      console.error(`[mcp-server] Tool: ${name}`);
       try {
         switch (name) {
           case "search_solutions": {
@@ -57012,6 +56986,7 @@ var init_mcp_server2 = __esm({
               project_path,
               git_branch,
               git_remote_url,
+              git_commit,
               tags,
               model,
               source_tool,
@@ -57037,6 +57012,7 @@ var init_mcp_server2 = __esm({
                 project_path,
                 git_branch,
                 git_remote_url,
+                git_commit,
                 tags,
                 model,
                 source_tool
@@ -57061,15 +57037,13 @@ var init_mcp_server2 = __esm({
             throw new Error(`Unknown tool: ${name}`);
         }
       } catch (err) {
-        console.error(`[mcp-server] Tool ${name} error:`, err.message);
         return {
           content: [{ type: "text", text: `Error: ${err.message}` }],
           isError: true
         };
       }
     });
-    main3().catch((err) => {
-      console.error("[mcp-server] Failed to start:", err);
+    main3().catch(() => {
       process.exit(1);
     });
   }
@@ -57177,8 +57151,9 @@ async function setupDaemon(uninstall) {
       return;
     }
     try {
-      (0, import_node_child_process2.execSync)(`launchctl unload "${PLIST_PATH}"`, { stdio: "pipe" });
-    } catch {
+      (0, import_node_child_process2.spawnSync)("launchctl", ["unload", PLIST_PATH], { stdio: "pipe" });
+    } catch (err) {
+      console.error("Failed to unload daemon:", err);
     }
     (0, import_node_fs3.unlinkSync)(PLIST_PATH);
     console.log("Daemon stopped and removed.");
@@ -57188,10 +57163,11 @@ async function setupDaemon(uninstall) {
   (0, import_node_fs3.mkdirSync)((0, import_node_path3.join)((0, import_node_os3.homedir)(), ".haansi"), { recursive: true });
   (0, import_node_fs3.writeFileSync)(PLIST_PATH, buildPlist(haansiPath), "utf-8");
   try {
-    (0, import_node_child_process2.execSync)(`launchctl unload "${PLIST_PATH}"`, { stdio: "pipe" });
-  } catch {
+    (0, import_node_child_process2.spawnSync)("launchctl", ["unload", PLIST_PATH], { stdio: "pipe" });
+  } catch (err) {
+    console.error("Failed to unload previous daemon:", err);
   }
-  (0, import_node_child_process2.execSync)(`launchctl load "${PLIST_PATH}"`, { stdio: "inherit" });
+  (0, import_node_child_process2.spawnSync)("launchctl", ["load", PLIST_PATH], { stdio: "inherit" });
   console.log("Daemon installed and started.");
   console.log(`Plist : ${PLIST_PATH}`);
   console.log(`Logs  : ${LOG_FILE}`);
@@ -57229,7 +57205,8 @@ function resolveToken3() {
     try {
       const creds = JSON.parse((0, import_node_fs4.readFileSync)(CREDENTIALS_FILE4, "utf-8"));
       if (creds.token) return creds.token;
-    } catch {
+    } catch (err) {
+      console.error("Failed to read credentials file:", err);
     }
   }
   return null;
@@ -57344,7 +57321,8 @@ function resolveToken4() {
     try {
       const creds = JSON.parse((0, import_node_fs5.readFileSync)(CREDENTIALS_FILE5, "utf-8"));
       if (creds.token) return creds.token;
-    } catch {
+    } catch (err) {
+      console.error("Failed to read credentials file:", err);
     }
   }
   throw new Error("No token found. Run `haansi init` first.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "haansi",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Haansi CLI - Session collector and MCP server for Claude Code",
   "bin": {
     "haansi": "./dist/haansi.js"