@h1veframework/cli 0.12.0 → 0.12.1

package/dist/index.js

@@ -3,6 +3,8 @@
 // src/index.ts
 import { parseArgs } from "util";
 import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { exec } from "child_process";
 
 // ../core/src/branch.ts
 import { execFile } from "child_process";
@@ -1385,8 +1387,58 @@ async function whoami(io) {
   };
 }
 
+// src/commands/mcp.ts
+import { join as join3 } from "path";
+var MCP_PKG = "@h1veframework/mcp";
+function mcpEntryPath(npmRootG) {
+  return join3(npmRootG.trim(), "@h1veframework", "mcp", "dist", "index.js");
+}
+async function mcp(io, args) {
+  if (args.positional !== "install") {
+    return {
+      human: "Uso: h1ve mcp install\n  Registra o MCP do H1VE no Claude Code (a forma que conecta no Windows).",
+      data: { ok: false, usage: true }
+    };
+  }
+  const run = io.runProcess;
+  const inst = await run("npm", ["i", "-g", MCP_PKG]);
+  const rootRes = await run("npm", ["root", "-g"]);
+  if (rootRes.code !== 0 || !rootRes.stdout.trim()) {
+    throw new CliError("N\xE3o localizei o node_modules global (`npm root -g` falhou). O Node/npm est\xE1 instalado e no PATH?", 1);
+  }
+  const entry = mcpEntryPath(rootRes.stdout);
+  if (!io.fileExists(entry)) {
+    throw new CliError(
+      `O pacote ${MCP_PKG} n\xE3o foi encontrado ap\xF3s a instala\xE7\xE3o:
+  ${entry}
+` + (inst.code !== 0 ? "O `npm i -g` falhou \u2014 verifique rede/permiss\xF5es e rode de novo." : `Rode \`npm i -g ${MCP_PKG}\` e tente de novo.`),
+      1
+    );
+  }
+  await run("claude", ["mcp", "remove", "h1ve", "-s", "user"]);
+  const add = await run("claude", ["mcp", "add", "h1ve", "-s", "user", "--", "node", entry]);
+  const manual = `claude mcp add h1ve -s user -- node "${entry}"`;
+  if (add.code !== 0) {
+    return {
+      human: `\u26A0 N\xE3o registrei automaticamente (o \`claude\` n\xE3o est\xE1 no PATH ou o comando falhou).
+  Rode isto no seu terminal:
+
+  ${manual}
+`,
+      data: { ok: false, manual, entry }
+    };
+  }
+  return {
+    human: `\u2713 MCP do H1VE registrado no Claude Code.
+  Launcher: node ${entry}
+  Confirme:  claude mcp list   \u2192   deve mostrar   h1ve: \u2714 Connected
+  (Reabra o Claude Code para o /mcp atualizar.)`,
+    data: { ok: true, entry }
+  };
+}
+
 // src/index.ts
-var VERSION = "0.9.0";
+var VERSION = "0.12.1";
 var HELP = `h1ve \u2014 CLI do H1VE
 (o comando legado \`nf\` continua funcionando como alias)
 
@@ -1411,6 +1463,8 @@ Uso:
   h1ve serve [--port 7391] [--origin http://localhost:3000]
                             sobe o agente local (127.0.0.1) p/ o menu visual aplicar
                             credenciais pelo navegador \u2014 imprime o c\xF3digo de pareamento
+  h1ve mcp install          registra o MCP do H1VE no Claude Code (a forma que conecta
+                            no Windows: node <abs>, n\xE3o npx)
 
 Flags:
   --json            sa\xEDda em JSON cru (comp\xF5e em scripts)
@@ -1430,8 +1484,20 @@ Ambiente (opcional \u2014 'h1ve login' dispensa):
   H1VE_API_KEY   PAT (nf_pat_\u2026) p/ escrever, ou a chave de servi\xE7o (s\xF3 leitura)
   (nomes legados aceitos: NEXUS_FLOW_API_URL / NEXUS_FLOW_API_KEY)
 `;
-var COMMANDS = { start, status, spec, move, blocker, done, health, connect, serve, login, logout, whoami };
-var NO_CONFIG = /* @__PURE__ */ new Set(["serve", "login", "logout"]);
+var COMMANDS = { start, status, spec, move, blocker, done, health, connect, serve, login, logout, whoami, mcp };
+var NO_CONFIG = /* @__PURE__ */ new Set(["serve", "login", "logout", "mcp"]);
+function quoteArg(a) {
+  return /[\s"&|<>^()]/.test(a) ? `"${a.replace(/"/g, '""')}"` : a;
+}
+function runProcess(cmd, args) {
+  const line = [cmd, ...args].map(quoteArg).join(" ");
+  return new Promise((resolve) => {
+    exec(line, { windowsHide: true }, (err, stdout, stderr) => {
+      const code = err ? err.code ?? 1 : 0;
+      resolve({ stdout: stdout ?? "", stderr: stderr ?? "", code });
+    });
+  });
+}
 async function readStdin() {
   if (process.stdin.isTTY) return "";
   const chunks = [];
@@ -1503,7 +1569,9 @@ ${HELP}`);
     credentials: defaultCredentialStore,
     // SPEC-173: `h1ve whoami` mostra o host + resolve o projeto do repo (override ou git remote).
     host: cfg?.baseUrl,
-    resolveProjectId: cfg ? () => cfg.projectId ? Promise.resolve(cfg.projectId) : autoResolveProjectId({ baseUrl: cfg.baseUrl, apiKey: cfg.apiKey }) : void 0
+    resolveProjectId: cfg ? () => cfg.projectId ? Promise.resolve(cfg.projectId) : autoResolveProjectId({ baseUrl: cfg.baseUrl, apiKey: cfg.apiKey }) : void 0,
+    runProcess,
+    fileExists: (p) => existsSync(p)
   };
   const args = {
     positional: positionals[1],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h1veframework/cli",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "The CLI for H1VE — the governance & memory layer for teams building with AI. Drive your feature flow (start, status, move, spec, done) from the terminal. Works with Claude Code, Cursor and Copilot.",
   "license": "MIT",
   "type": "module",
@@ -48,7 +48,8 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "@nexus-flow/core": "*",