heedvane 0.2.0 → 0.3.3

package/dist/mcp-server.js

@@ -1,187 +0,0 @@
-/**
- * `npx heedvane mcp` — the MCP stdio server stub the installers register.
- * v1 exposes two tools (status, doctor) over line-delimited JSON-RPC.
- */
-import { createInterface } from "node:readline";
-import { runDoctor } from "./doctor.js";
-import { cmdMemory } from "./commands/memory.js";
-const MCP_SERVER_INFO = { name: "heedvane-hooks", version: "0.1.0" };
-const TOOLS = [
-    {
-        name: "heedvane_status",
-        description: "Report the live heedvane hook installation state for this machine (agents, skill, listener).",
-        inputSchema: { type: "object", properties: {} },
-    },
-    {
-        name: "heedvane_doctor",
-        description: "Run the scoped heedvane doctor and return its checks with remediations.",
-        inputSchema: {
-            type: "object",
-            properties: { clients: { type: "array", items: { type: "string" } } },
-        },
-    },
-    {
-        name: "heedvane_memory_list",
-        description: "List team memory folders and entries for the current repository.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                folder: { type: "string", description: "Optional folder name to filter by." },
-                cwd: { type: "string", description: "Optional repository checkout path." },
-            },
-        },
-    },
-    {
-        name: "heedvane_memory_show",
-        description: "Read the full markdown content of a team memory entry by id.",
-        inputSchema: {
-            type: "object",
-            required: ["id"],
-            properties: {
-                id: { type: "string", description: "The team memory id." },
-                cwd: { type: "string", description: "Optional repository checkout path." },
-            },
-        },
-    },
-    {
-        name: "heedvane_memory_search",
-        description: "Semantically search team memory for the current repository.",
-        inputSchema: {
-            type: "object",
-            required: ["query"],
-            properties: {
-                query: { type: "string", description: "The question or search query." },
-                folder: { type: "string", description: "Optional folder name to restrict search." },
-                cwd: { type: "string", description: "Optional repository checkout path." },
-            },
-        },
-    },
-];
-/** Run a team memory command and return its collected lines. */
-async function runMemoryTool(words, flags, cwd) {
-    const lines = [];
-    await cmdMemory({
-        home: process.env.HEED_HOME ?? homeDir(),
-        out: (line) => lines.push(line),
-        words,
-        flag: (name) => flags[name],
-        cwd: typeof cwd === "string" && cwd.trim() !== "" ? cwd : process.cwd(),
-    });
-    return lines.join("\n");
-}
-function handleMemoryToolCall(name, args, reply) {
-    if (name === "heedvane_memory_list") {
-        const folder = typeof args.folder === "string" && args.folder.trim() !== "" ? [args.folder.trim()] : [];
-        void runMemoryTool(["list", ...folder], {}, args.cwd).then((text) => reply(textContent(text)));
-        return true;
-    }
-    if (name === "heedvane_memory_show") {
-        const id = typeof args.id === "string" ? args.id.trim() : "";
-        void runMemoryTool(["show", ...(id ? [id] : [])], {}, args.cwd).then((text) => reply(textContent(text)));
-        return true;
-    }
-    if (name === "heedvane_memory_search") {
-        const query = typeof args.query === "string" ? args.query.trim() : "";
-        const folder = typeof args.folder === "string" && args.folder.trim() !== "" ? args.folder.trim() : undefined;
-        void runMemoryTool(["search", ...(query ? [query] : [])], { "--folder": folder }, args.cwd).then((text) => reply(textContent(text)));
-        return true;
-    }
-    return false;
-}
-/** The tools/call branch: reply with the tool's text content, or a unknown-tool error. */
-function handleToolCall(msg, reply, fail) {
-    const name = msg.params?.name;
-    const args = msg.params?.arguments ?? {};
-    if (name === "heedvane_status") {
-        void statusText().then((text) => reply(textContent(text)));
-        return;
-    }
-    if (name === "heedvane_doctor") {
-        const clients = args.clients;
-        const input = { home: process.env.HEED_HOME ?? homeDir(), env: process.env };
-        if (Array.isArray(clients))
-            input.clients = clients.map(String);
-        void runDoctor(input).then((report) => reply(textContent(JSON.stringify(report, null, 2))));
-        return;
-    }
-    if (handleMemoryToolCall(name, args, reply))
-        return;
-    fail(-32602, `unknown tool: ${String(name)}`);
-}
-function handleRpc(msg, io) {
-    const { method, id } = msg;
-    if (!method || id === undefined)
-        return; // notification: ignore silently
-    const reply = (result) => io.write(JSON.stringify({ jsonrpc: "2.0", id, result }));
-    const fail = (code, message) => io.write(JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }));
-    switch (method) {
-        case "initialize":
-            reply({ protocolVersion: "2024-11-05", capabilities: { tools: {} }, serverInfo: MCP_SERVER_INFO });
-            return;
-        case "tools/list":
-            reply({ tools: TOOLS });
-            return;
-        case "tools/call":
-            handleToolCall(msg, reply, fail);
-            return;
-        default:
-            fail(-32601, `method not supported: ${method}`);
-    }
-}
-function textContent(text) {
-    return { content: [{ type: "text", text }] };
-}
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { HeedStateCorruptError, readState } from "./state.js";
-import { readEndpoint } from "./listener/endpoint.js";
-function homeDir() {
-    return homedir();
-}
-export async function statusText() {
-    const home = process.env.HEED_HOME ?? homeDir();
-    const root = join(home, ".heed");
-    const lines = [`heedvane hooks status (home: ${home})`];
-    try {
-        const state = await readState(root);
-        if (state !== null) {
-            const skill = state.skill?.digest.slice(0, 12) ?? "not installed";
-            lines.push(`  state.json: ok (protocol v${state.protocolVersion}, skill ${skill})`);
-        }
-        else {
-            lines.push("  state.json: absent (run npx heedvane init)");
-        }
-    }
-    catch (error) {
-        if (!(error instanceof HeedStateCorruptError))
-            throw error;
-        lines.push(`  state.json: ${error.message}`);
-    }
-    const endpoint = await readEndpoint(root);
-    lines.push(`  listener: ${endpoint ? `endpoint.env present (port ${endpoint.port})` : "not configured — events spool to ~/.heed/spool"}`);
-    lines.push("  next: npx heedvane doctor for scoped checks");
-    return lines.join("\n");
-}
-/** One stdin line → one RPC dispatch. A blank or unparseable line never crashes the host's transport. */
-function dispatchLine(line, io) {
-    const trimmed = line.trim();
-    if (trimmed === "")
-        return;
-    try {
-        handleRpc(JSON.parse(trimmed), io);
-    }
-    catch {
-        return; // unparseable line: ignore (never crash the host's transport)
-    }
-}
-/** Entry point for the `mcp` subcommand. */
-export function runMcpStdio(io) {
-    const log = io.log ?? (() => { });
-    const rl = createInterface({ input: process.stdin });
-    rl.on("line", (line) => {
-        dispatchLine(line, { write: io.write, log });
-    });
-    rl.on("close", () => {
-        log("heedvane mcp: stdin closed");
-    });
-}