@cruxhive/cli 0.3.0 → 0.3.1

package/lib/init.js

@@ -1,9 +1,8 @@
 "use strict";
 
 const { spawnSync } = require("child_process");
-const { mkdirSync, writeFileSync, existsSync, readFileSync } = require("fs");
-const { join } = require("path");
-const { createInterface } = require("readline");
+const { mkdirSync, writeFileSync, existsSync, readFileSync, symlinkSync } = require("fs");
+const { join, dirname } = require("path");
 
 const CONTEXT_TEMPLATE = (projectName, date) => `---
 type: fact
@@ -44,12 +43,6 @@ source: human
 | **Personal** | \`~/.cruxhive/personal/\` | Developer preferences — never shared |
 `;
 
-const MCP_ENTRY = {
-  command: "uvx",
-  args: ["cruxhive-mcp"],
-  type: "stdio",
-};
-
 function ok(msg)   { console.log(`  \x1b[32m✓\x1b[0m  ${msg}`); }
 function info(msg) { console.log(`  \x1b[36m·\x1b[0m  ${msg}`); }
 function warn(msg) { console.log(`  \x1b[33m!\x1b[0m  ${msg}`); }
@@ -59,23 +52,44 @@ function hasBin(name) {
   return spawnSync(name, ["--version"], { stdio: "pipe" }).status === 0;
 }
 
+// ─── install cruxhive-mcp ──────────────────────────────────────────────────
+
 function installMcp() {
+  // Skip if already on PATH
+  if (hasBin("cruxhive-mcp")) {
+    info("cruxhive-mcp already installed — skipped");
+    return null;
+  }
+
   if (hasBin("uv")) {
-    const r = spawnSync("uv", ["pip", "install", "cruxhive-mcp"], { stdio: "inherit" });
-    if (r.status !== 0) throw new Error("uv pip install cruxhive-mcp failed");
-    return "uv";
+    const r = spawnSync("uv", ["tool", "install", "cruxhive-mcp"], { stdio: "inherit" });
+    if (r.status !== 0) throw new Error("uv tool install cruxhive-mcp failed");
+    return "uv tool";
   }
+
   if (hasBin("pip3") || hasBin("pip")) {
     const pip = hasBin("pip3") ? "pip3" : "pip";
     const r = spawnSync(pip, ["install", "cruxhive-mcp"], { stdio: "inherit" });
     if (r.status !== 0) throw new Error(`${pip} install cruxhive-mcp failed`);
+    warn(`Installed via ${pip} — cruxhive-mcp binary may not be on PATH.`);
+    warn(`For a cleaner install: uv tool install cruxhive-mcp (https://docs.astral.sh/uv/)`);
     return pip;
   }
+
   throw new Error(
-    "Neither uv nor pip found. Install uv (https://docs.astral.sh/uv/) or pip first."
+    "Neither uv nor pip found.\nInstall uv: curl -LsSf https://astral.sh/uv/install.sh | sh"
   );
 }
 
+function mcpEntry() {
+  // If cruxhive-mcp binary is on PATH, use it directly (uv tool install path)
+  if (hasBin("cruxhive-mcp")) return { command: "cruxhive-mcp", type: "stdio" };
+  // Fallback: let uvx fetch it from PyPI at runtime
+  return { command: "uvx", args: ["cruxhive-mcp"], type: "stdio" };
+}
+
+// ─── wire .mcp.json ────────────────────────────────────────────────────────
+
 function wireMcp(cwd) {
   const mcpPath = join(cwd, ".mcp.json");
   let cfg = existsSync(mcpPath)
@@ -89,50 +103,75 @@ function wireMcp(cwd) {
     return;
   }
 
-  cfg.mcpServers.cruxhive = MCP_ENTRY;
+  cfg.mcpServers.cruxhive = mcpEntry();
   writeFileSync(mcpPath, JSON.stringify(cfg, null, 2) + "\n");
   ok("cruxhive-mcp registered in .mcp.json");
 }
 
-function wireClaudeMd(cwd) {
-  const claudePath = join(cwd, "CLAUDE.md");
-  const contextPath = ".llm/CONTEXT.md";
+// ─── wire AI tool context files ────────────────────────────────────────────
+
+const CONTEXT_REL = ".llm/CONTEXT.md";
 
-  if (existsSync(claudePath)) {
-    const content = readFileSync(claudePath, "utf8");
+function trySymlink(target, linkPath, label) {
+  if (existsSync(linkPath)) {
+    info(`${label} already exists — skipped`);
+    return;
+  }
+  try {
+    mkdirSync(dirname(linkPath), { recursive: true });
+    symlinkSync(target, linkPath);
+    ok(`${label} → ${CONTEXT_REL} (symlink)`);
+  } catch {
+    warn(`Could not create ${label} symlink — create it manually: ln -s ${CONTEXT_REL} ${linkPath}`);
+  }
+}
+
+function patchOrSymlink(filePath, label) {
+  if (existsSync(filePath)) {
+    const content = readFileSync(filePath, "utf8");
     if (content.includes("CONTEXT.md")) {
-      info("CLAUDE.md already references CONTEXT.md");
+      info(`${label} already references CONTEXT.md`);
       return;
     }
-    writeFileSync(claudePath, content.trimEnd() + "\n\n<!-- CruxHive canonical context: .llm/CONTEXT.md -->\n");
-    ok("CLAUDE.md patched with CONTEXT.md reference");
+    writeFileSync(filePath, content.trimEnd() + "\n\n<!-- CruxHive canonical context: .llm/CONTEXT.md -->\n");
+    ok(`${label} patched with CONTEXT.md reference`);
   } else {
-    const target = contextPath;
-    // Create a thin symlink — requires filesystem support
-    try {
-      require("fs").symlinkSync(target, claudePath);
-      ok("CLAUDE.md → .llm/CONTEXT.md (symlink)");
-    } catch {
-      warn("Could not create CLAUDE.md symlink — copy .llm/CONTEXT.md to CLAUDE.md manually");
-    }
+    trySymlink(CONTEXT_REL, filePath, label);
   }
 }
 
-async function init(args) {
+function wireAiTools(cwd) {
+  const tools = [
+    // Claude Code
+    { check: () => true, wire: () => patchOrSymlink(join(cwd, "CLAUDE.md"), "CLAUDE.md") },
+    // OpenCode
+    { check: () => true, wire: () => trySymlink(CONTEXT_REL, join(cwd, "AGENT.md"), "AGENT.md") },
+    // Cursor
+    { check: () => true, wire: () => trySymlink(CONTEXT_REL, join(cwd, ".cursor/rules/cruxhive.mdc"), ".cursor/rules/cruxhive.mdc") },
+    // Windsurf
+    { check: () => true, wire: () => trySymlink(CONTEXT_REL, join(cwd, ".windsurfRules"), ".windsurfRules") },
+    // Gemini CLI
+    { check: () => true, wire: () => trySymlink(CONTEXT_REL, join(cwd, "GEMINI.md"), "GEMINI.md") },
+  ];
+
+  for (const t of tools) t.wire();
+}
+
+// ─── main ──────────────────────────────────────────────────────────────────
+
+async function init(_args) {
   const cwd = process.cwd();
   const date = new Date().toISOString().split("T")[0];
   const projectName = cwd.split("/").pop();
 
   console.log(`\n\x1b[1mCruxHive init\x1b[0m — ${projectName}`);
 
-  // ─── .llm/ structure ─────────────────────────────────────────────────────
+  // 1. .llm/ structure
   step("1/4  Creating .llm/ structure");
-
-  const dirs = [".llm", ".llm/plans", ".llm/context", ".llm/memory"];
-  for (const dir of dirs) {
+  for (const dir of [".llm", ".llm/plans", ".llm/pending", ".llm/context", ".llm/memory"]) {
     mkdirSync(join(cwd, dir), { recursive: true });
   }
-  ok("directories: .llm/ .llm/plans/ .llm/context/ .llm/memory/");
+  ok("directories: .llm/ .llm/plans/ .llm/pending/ .llm/context/ .llm/memory/");
 
   const contextPath = join(cwd, ".llm", "CONTEXT.md");
   if (!existsSync(contextPath)) {
@@ -150,29 +189,28 @@ async function init(args) {
     info(".llm/plans/active.md already exists — skipped");
   }
 
-  // ─── install cruxhive-mcp ─────────────────────────────────────────────────
+  // 2. install cruxhive-mcp
   step("2/4  Installing cruxhive-mcp");
   const installer = installMcp();
-  ok(`cruxhive-mcp installed via ${installer}`);
+  if (installer) ok(`cruxhive-mcp installed via ${installer}`);
 
-  // ─── wire .mcp.json ───────────────────────────────────────────────────────
+  // 3. wire .mcp.json
   step("3/4  Wiring .mcp.json");
   wireMcp(cwd);
 
-  // ─── wire AI tool context files ───────────────────────────────────────────
+  // 4. wire AI tools
   step("4/4  Wiring AI tools");
-  wireClaudeMd(cwd);
+  wireAiTools(cwd);
 
-  // ─── done ─────────────────────────────────────────────────────────────────
   console.log(`
 \x1b[32m✓ CruxHive initialized in ${projectName}\x1b[0m
 
 Next steps:
   1. Edit \x1b[36m.llm/CONTEXT.md\x1b[0m — describe your project, stack, and conventions
-  2. Reload your AI tool — the cruxhive-mcp server is now available
-  3. Run \x1b[36mcruxhive health\x1b[0m to see knowledge base status
+  2. Run \x1b[36mcruxhive index\x1b[0m to build the search index
+  3. Reload your AI tool — MCP tools are now available
 
-MCP tools now available: context_radar, context_next_slice, context_write_plan, context_sync_memory
+Docs: https://cruxhive.com/guide.html
 `);
 }
 

package/lib/ui.js

@@ -15,9 +15,13 @@ function openBrowser(url) {
   spawnSync(cmd, [url], { stdio: "ignore" });
 }
 
-function checkUvicorn() {
-  const r = spawnSync("uvicorn", ["--version"], { stdio: "pipe" });
-  return r.status === 0;
+function uvicornCmd() {
+  // Prefer the uvicorn inside the uv-managed cruxhive-mcp tool environment
+  const uv = spawnSync("uv", ["tool", "run", "--from", "cruxhive-mcp", "uvicorn", "--version"], { stdio: "pipe" });
+  if (uv.status === 0) return ["uv", "tool", "run", "--from", "cruxhive-mcp", "uvicorn"];
+  const direct = spawnSync("uvicorn", ["--version"], { stdio: "pipe" });
+  if (direct.status === 0) return ["uvicorn"];
+  return null;
 }
 
 async function ui(args) {
@@ -31,18 +35,21 @@ async function ui(args) {
     console.log(`       Run: \x1b[36mcruxhive index\x1b[0m (or context_index MCP tool)\n`);
   }
 
-  if (!checkUvicorn()) {
+  const uvcmd = uvicornCmd();
+  if (!uvcmd) {
     err("uvicorn not found — install the [ui] extra:");
-    console.log(`\n       \x1b[36mpip install "cruxhive-mcp[ui]"\x1b[0m\n`);
+    console.log(`\n       \x1b[36muv tool install "cruxhive-mcp[ui]"\x1b[0m\n`);
     process.exit(1);
   }
 
   const url = `http://localhost:${PORT}`;
   info(`Starting approval queue at ${url}`);
 
+  const [bin, ...binArgs] = uvcmd;
   const proc = spawn(
-    "uvicorn",
+    bin,
     [
+      ...binArgs,
       "cruxhive_mcp.ui:app",
       "--host", "0.0.0.0",
       "--port", String(PORT),

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@cruxhive/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "CruxHive — team AI knowledge governance layer",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/cruxhive/cruxhive"
+    "url": "git+https://github.com/cruxhive/cruxhive.git"
   },
   "homepage": "https://cruxhive.com",
   "keywords": ["ai", "mcp", "context", "knowledge", "claude", "cursor", "llm"],