haansi 0.1.6 → 0.1.8

package/dist/haansi.js

@@ -34,6 +34,36 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// package.json
+var require_package = __commonJS({
+  "package.json"(exports2, module2) {
+    module2.exports = {
+      name: "haansi",
+      version: "0.1.8",
+      description: "Haansi CLI - Session collector and MCP server for Claude Code",
+      bin: {
+        haansi: "./dist/haansi.js"
+      },
+      files: [
+        "dist/",
+        "README.md"
+      ],
+      scripts: {
+        build: "node build.mjs",
+        prepublishOnly: "npm run build"
+      },
+      devDependencies: {
+        esbuild: "^0.27.0",
+        typescript: "^5.7.2",
+        "@types/node": "^22.10.1"
+      },
+      engines: {
+        node: ">=18.0.0"
+      }
+    };
+  }
+});
+
 // src/commands/init.ts
 var init_exports = {};
 __export(init_exports, {
@@ -106,7 +136,7 @@ var init_init = __esm({
 });
 
 // ../../node_modules/dotenv/package.json
-var require_package = __commonJS({
+var require_package2 = __commonJS({
   "../../node_modules/dotenv/package.json"(exports2, module2) {
     module2.exports = {
       name: "dotenv",
@@ -180,7 +210,7 @@ var require_main = __commonJS({
     var path = require("path");
     var os = require("os");
     var crypto6 = require("crypto");
-    var packageJson = require_package();
+    var packageJson = require_package2();
     var version3 = packageJson.version;
     var LINE = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg;
     function parse4(src) {
@@ -486,12 +516,12 @@ var init_logger = __esm({
       }
       debug(message, context) {
         if (this.level <= 0 /* DEBUG */) {
-          console.debug(this.formatMessage("DEBUG", message, context));
+          console.error(this.formatMessage("DEBUG", message, context));
         }
       }
       info(message, context) {
         if (this.level <= 1 /* INFO */) {
-          console.log(this.formatMessage("INFO", message, context));
+          console.error(this.formatMessage("INFO", message, context));
         }
       }
       warn(message, context) {
@@ -56869,6 +56899,14 @@ var setup_mcp_exports = {};
 __export(setup_mcp_exports, {
   setupMcp: () => setupMcp
 });
+function resolveHaansiBin() {
+  try {
+    const binPath = (0, import_node_child_process.execSync)("which haansi", { encoding: "utf-8" }).trim();
+    if (binPath) return binPath;
+  } catch {
+  }
+  return "haansi";
+}
 async function setupMcp() {
   let config6 = {};
   if ((0, import_node_fs2.existsSync)(CLAUDE_JSON)) {
@@ -56883,23 +56921,26 @@ async function setupMcp() {
   if (!config6.mcpServers) {
     config6.mcpServers = {};
   }
+  const haansiBin = resolveHaansiBin();
   config6.mcpServers["haansi-solutions"] = {
-    command: "npx",
-    args: ["haansi", "mcp-server"]
+    command: haansiBin,
+    args: ["mcp-server"]
   };
   (0, import_node_fs2.writeFileSync)(CLAUDE_JSON, JSON.stringify(config6, null, 2) + "\n", "utf-8");
   console.log(`MCP server configured in ${CLAUDE_JSON}`);
+  console.log(`  command: ${haansiBin} mcp-server`);
   console.log(
-    "Restart Claude Code to activate the haansi-solutions MCP server."
+    "\nRestart Claude Code to activate the haansi-solutions MCP server."
   );
 }
-var import_node_fs2, import_node_path2, import_node_os2, CLAUDE_JSON;
+var import_node_fs2, import_node_path2, import_node_os2, import_node_child_process, CLAUDE_JSON;
 var init_setup_mcp = __esm({
   "src/commands/setup-mcp.ts"() {
     "use strict";
     import_node_fs2 = require("node:fs");
     import_node_path2 = require("node:path");
     import_node_os2 = require("node:os");
+    import_node_child_process = require("node:child_process");
     CLAUDE_JSON = (0, import_node_path2.join)((0, import_node_os2.homedir)(), ".claude.json");
   }
 });
@@ -56911,7 +56952,7 @@ __export(setup_daemon_exports, {
 });
 function findHaansiBin() {
   try {
-    return (0, import_node_child_process.execSync)("which haansi", { encoding: "utf-8" }).trim();
+    return (0, import_node_child_process2.execSync)("which haansi", { encoding: "utf-8" }).trim();
   } catch {
     throw new Error(
       "Could not find haansi in PATH. Make sure it is installed globally (npm install -g haansi)."
@@ -56955,7 +56996,7 @@ async function setupDaemon(uninstall) {
       return;
     }
     try {
-      (0, import_node_child_process.execSync)(`launchctl unload "${PLIST_PATH}"`, { stdio: "pipe" });
+      (0, import_node_child_process2.execSync)(`launchctl unload "${PLIST_PATH}"`, { stdio: "pipe" });
     } catch {
     }
     (0, import_node_fs3.unlinkSync)(PLIST_PATH);
@@ -56966,10 +57007,10 @@ 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_process.execSync)(`launchctl unload "${PLIST_PATH}"`, { stdio: "pipe" });
+    (0, import_node_child_process2.execSync)(`launchctl unload "${PLIST_PATH}"`, { stdio: "pipe" });
   } catch {
   }
-  (0, import_node_child_process.execSync)(`launchctl load "${PLIST_PATH}"`, { stdio: "inherit" });
+  (0, import_node_child_process2.execSync)(`launchctl load "${PLIST_PATH}"`, { stdio: "inherit" });
   console.log("Daemon installed and started.");
   console.log(`Plist : ${PLIST_PATH}`);
   console.log(`Logs  : ${LOG_FILE}`);
@@ -56977,11 +57018,11 @@ async function setupDaemon(uninstall) {
 The daemon will start automatically on every login.`);
   console.log(`To uninstall: haansi setup-daemon --uninstall`);
 }
-var import_node_child_process, import_node_fs3, import_node_path3, import_node_os3, PLIST_LABEL, PLIST_PATH, LOG_FILE;
+var import_node_child_process2, import_node_fs3, import_node_path3, import_node_os3, PLIST_LABEL, PLIST_PATH, LOG_FILE;
 var init_setup_daemon = __esm({
   "src/commands/setup-daemon.ts"() {
     "use strict";
-    import_node_child_process = require("node:child_process");
+    import_node_child_process2 = require("node:child_process");
     import_node_fs3 = require("node:fs");
     import_node_path3 = require("node:path");
     import_node_os3 = require("node:os");
@@ -57112,7 +57153,9 @@ var init_config = __esm({
 // src/commands/list.ts
 var list_exports = {};
 __export(list_exports, {
-  list: () => list
+  list: () => list,
+  saveKnowledge: () => saveKnowledge,
+  searchKnowledge: () => searchKnowledge
 });
 function resolveToken4() {
   if (process.env.HAANSI_TOKEN) return process.env.HAANSI_TOKEN;
@@ -57135,6 +57178,21 @@ async function apiGet3(path, token, apiUrl) {
   }
   return response.json();
 }
+async function apiPost2(path, body, token, apiUrl) {
+  const response = await fetch(`${apiUrl}/api/v1${path}`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`API error ${response.status}: ${text.slice(0, 200)}`);
+  }
+  return response.json();
+}
 async function list(options) {
   const apiUrl = process.env.HAANSI_API_URL ?? DEFAULT_API_URL5;
   const token = resolveToken4();
@@ -57161,6 +57219,41 @@ async function list(options) {
   console.log(`
 ${data.results.length} result(s)`);
 }
+async function searchKnowledge(options) {
+  const apiUrl = process.env.HAANSI_API_URL ?? DEFAULT_API_URL5;
+  const token = resolveToken4();
+  let url2 = `/sessions/knowledge/search?q=${encodeURIComponent(options.query)}&limit=${options.limit}`;
+  if (options.artifactType) {
+    url2 += `&artifact_type=${encodeURIComponent(options.artifactType)}`;
+  }
+  const data = await apiGet3(url2, token, apiUrl);
+  if (!data.results || data.results.length === 0) {
+    console.log("No knowledge artifacts found matching your query.");
+    return;
+  }
+  const separator = "\n" + "\u2500".repeat(60) + "\n";
+  console.log(data.results.join(separator));
+  console.log(`
+${data.results.length} result(s)`);
+}
+async function saveKnowledge(options) {
+  const apiUrl = process.env.HAANSI_API_URL ?? DEFAULT_API_URL5;
+  const token = resolveToken4();
+  const body = {
+    problem_description: options.problem,
+    solution_summary: options.solution,
+    source_tool: "haansi-cli"
+  };
+  if (options.sessionType) body.session_type = options.sessionType;
+  if (options.complexity) body.complexity = options.complexity;
+  if (options.tags) body.tags = options.tags;
+  const data = await apiPost2("/sessions/knowledge", body, token, apiUrl);
+  console.log("Knowledge saved successfully.");
+  console.log(`  ID:       ${data.id}`);
+  console.log(`  Problem:  ${data.problem_description}`);
+  console.log(`  Solution: ${data.solution_summary}`);
+  console.log("\nThis is now searchable via `haansi search-solutions`.");
+}
 var import_node_fs5, import_node_path5, import_node_os5, DEFAULT_API_URL5, CREDENTIALS_FILE5;
 var init_list = __esm({
   "src/commands/list.ts"() {
@@ -57174,8 +57267,13 @@ var init_list = __esm({
 });
 
 // src/index.ts
+var { version: VERSION } = require_package();
 var command = process.argv[2];
 async function run2() {
+  if (command === "--version" || command === "-v") {
+    console.log(VERSION);
+    return;
+  }
   switch (command) {
     case "init": {
       const { init: init2 } = await Promise.resolve().then(() => (init_init(), init_exports));
@@ -57226,11 +57324,13 @@ Collector done: ${uploaded} uploaded, ${skipped} unchanged, ${errors} errors`
       await config6(process.argv.slice(3));
       break;
     }
+    // ── Solution & Knowledge commands (consistent with MCP tool names) ──
+    case "search-solutions":
     case "search": {
       const { list: list2 } = await Promise.resolve().then(() => (init_list(), list_exports));
       const query = process.argv[3];
       if (!query || query.startsWith("--")) {
-        console.error("Usage: haansi search <query> [--limit <n>]");
+        console.error("Usage: haansi search-solutions <query> [--limit <n>]");
         process.exit(1);
       }
       const limitIdx = process.argv.indexOf("--limit");
@@ -57238,6 +57338,7 @@ Collector done: ${uploaded} uploaded, ${skipped} unchanged, ${errors} errors`
       await list2({ search: query, limit });
       break;
     }
+    case "list-solutions":
     case "list": {
       const { list: list2 } = await Promise.resolve().then(() => (init_list(), list_exports));
       const searchIdx = process.argv.indexOf("--search");
@@ -57247,6 +57348,43 @@ Collector done: ${uploaded} uploaded, ${skipped} unchanged, ${errors} errors`
       await list2({ search, limit });
       break;
     }
+    case "search-knowledge": {
+      const { searchKnowledge: searchKnowledge2 } = await Promise.resolve().then(() => (init_list(), list_exports));
+      const query = process.argv[3];
+      if (!query || query.startsWith("--")) {
+        console.error(
+          "Usage: haansi search-knowledge <query> [--type <artifact_type>] [--limit <n>]"
+        );
+        process.exit(1);
+      }
+      const typeIdx = process.argv.indexOf("--type");
+      const artifactType = typeIdx !== -1 ? process.argv[typeIdx + 1] : void 0;
+      const limitIdx = process.argv.indexOf("--limit");
+      const limit = limitIdx !== -1 ? parseInt(process.argv[limitIdx + 1], 10) : 10;
+      await searchKnowledge2({ query, artifactType, limit });
+      break;
+    }
+    case "save-knowledge": {
+      const { saveKnowledge: saveKnowledge2 } = await Promise.resolve().then(() => (init_list(), list_exports));
+      const problemIdx = process.argv.indexOf("--problem");
+      const solutionIdx = process.argv.indexOf("--solution");
+      if (problemIdx === -1 || solutionIdx === -1) {
+        console.error(
+          'Usage: haansi save-knowledge --problem "description" --solution "summary" [--type <session_type>] [--complexity <simple|moderate|complex>] [--tags tag1,tag2]'
+        );
+        process.exit(1);
+      }
+      const problem = process.argv[problemIdx + 1];
+      const solution = process.argv[solutionIdx + 1];
+      const typeIdx = process.argv.indexOf("--type");
+      const sessionType = typeIdx !== -1 ? process.argv[typeIdx + 1] : void 0;
+      const complexityIdx = process.argv.indexOf("--complexity");
+      const complexity = complexityIdx !== -1 ? process.argv[complexityIdx + 1] : void 0;
+      const tagsIdx = process.argv.indexOf("--tags");
+      const tags = tagsIdx !== -1 ? process.argv[tagsIdx + 1].split(",") : void 0;
+      await saveKnowledge2({ problem, solution, sessionType, complexity, tags });
+      break;
+    }
     case "help":
     default: {
       printUsage();
@@ -57257,37 +57395,52 @@ Collector done: ${uploaded} uploaded, ${skipped} unchanged, ${errors} errors`
 }
 function printUsage() {
   console.log(`
-Haansi CLI \u2014 Session collector and MCP server for Claude Code
+Haansi CLI v${VERSION} \u2014 Session collector and MCP server for Claude Code
 
 Usage:
   haansi <command> [options]
 
 Commands:
-  init                   Authenticate and save your API token
-  collect                Upload new/changed Claude sessions once
-  config get [key]       Show your preferences (e.g. session_mode)
-  config set <key> <val> Update a preference
-  search <query>         Semantic search over mined solutions
-  list                   List recent mined solutions
-  daemon                 Run the collector on a schedule (every 30 min)
-  mcp-server             Start the Haansi MCP server (used by Claude Code)
-  setup-mcp              Add haansi-solutions MCP entry to ~/.claude.json
-  setup-daemon           Install launchd service to auto-start daemon on login (macOS)
-  help                   Show this help message
-
-Options for search/list:
-  --limit <n>            Number of results (default: 5 for search, 10 for list)
+  init                       Authenticate and save your API token
+  collect                    Upload new/changed Claude sessions once
+  config get [key]           Show your preferences (e.g. session_mode)
+  config set <key> <val>     Update a preference
+
+  search-solutions <query>   Semantic search over mined solutions
+  list-solutions             List recent mined solutions
+  search-knowledge <query>   Search knowledge artifacts (cards, decisions, etc.)
+  save-knowledge             Save a problem/solution for future retrieval
+
+  daemon                     Run the collector on a schedule (every 30 min)
+  mcp-server                 Start the Haansi MCP server (used by Claude Code)
+  setup-mcp                  Add haansi-solutions MCP entry to ~/.claude.json
+  setup-daemon               Install launchd service to auto-start daemon on login (macOS)
+  help                       Show this help message
+
+Options:
+  --version, -v              Show installed version
+  --limit <n>                Number of results (default: 5 for search, 10 for list)
+
+Options for search-knowledge:
+  --type <artifact_type>     Filter by type (knowledge_card, decision_record, etc.)
+
+Options for save-knowledge:
+  --problem "description"    Problem description (required)
+  --solution "summary"       Solution summary (required)
+  --type <session_type>      Session type (bug_fix, feature, refactor, general)
+  --complexity <level>       simple, moderate, or complex
+  --tags tag1,tag2           Comma-separated tags
 
 Options for collect:
-  --force-all            Re-upload all sessions, not just new ones
-  --dry-run              Scan without uploading
-  --limit <n>            Upload at most n sessions
+  --force-all                Re-upload all sessions, not just new ones
+  --dry-run                  Scan without uploading
+  --limit <n>                Upload at most n sessions
 
 Environment variables:
-  HAANSI_TOKEN           API token (or use \`haansi init\` to save it)
-  HAANSI_API_URL         API base URL (default: https://api.haansi.co)
-  CLAUDE_PROJECT_PATH    Collect from a specific project path only
-  CLAUDE_COLLECT_SCHEDULE  Cron expression for daemon (default: */30 * * * *)
+  HAANSI_TOKEN               API token (or use \`haansi init\` to save it)
+  HAANSI_API_URL             API base URL (default: https://api.haansi.co)
+  CLAUDE_PROJECT_PATH        Collect from a specific project path only
+  CLAUDE_COLLECT_SCHEDULE    Cron expression for daemon (default: */30 * * * *)
 `);
 }
 run2().catch((err) => {

package/package.json

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