kibi-mcp 0.1.0

package/bin/kibi-mcp

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/*
+ Kibi — repo-local, per-branch, queryable long-term memory for software projects
+ Copyright (C) 2026 Piotr Franczyk
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+import { startServer } from "../dist/server.js";
+
+if (process.env.KIBI_MCP_DEBUG) {
+  const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+  const originalStderrWrite = process.stderr.write.bind(process.stderr);
+
+  process.stdout.write = function(chunk, encoding, callback) {
+    const str = chunk.toString().trim();
+    if (str) {
+      originalStderrWrite(`[KIBI-MCP-OUT] ${str}\n`);
+    }
+    return originalStdoutWrite(chunk, encoding, callback);
+  };
+
+  process.stdin.on('data', (data) => {
+    const str = data.toString().trim();
+    if (str) {
+      originalStderrWrite(`[KIBI-MCP-IN] ${str}\n`);
+    }
+  });
+}
+
+process.on('unhandledRejection', (reason, promise) => {
+  console.error('[KIBI-MCP] Unhandled rejection at promise:', promise);
+  console.error('[KIBI-MCP] Reason:', reason);
+  if (reason instanceof Error) {
+    console.error('[KIBI-MCP] Stack:', reason.stack);
+  }
+  process.exit(1);
+});
+
+process.on('uncaughtException', (error) => {
+  console.error('[KIBI-MCP] Uncaught exception:', error.message);
+  console.error('[KIBI-MCP] Stack:', error.stack);
+  process.exit(1);
+});
+
+startServer().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/dist/env.js

@@ -0,0 +1,99 @@
+/*
+ Kibi — repo-local, per-branch, queryable long-term memory for software projects
+ Copyright (C) 2026 Piotr Franczyk
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+/*
+ How to apply this header to source files (examples)
+
+ 1) Prepend header to a single file (POSIX shells):
+
+    cat LICENSE_HEADER.txt "$FILE" > "$FILE".with-header && mv "$FILE".with-header "$FILE"
+
+ 2) Apply to multiple files (example: the project's main entry files):
+
+    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp packages/cli/src/*.ts packages/mcp/src/*.ts; do
+      if [ -f "$f" ]; then
+        cp "$f" "$f".bak
+        (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
+      fi
+    done
+
+ 3) Avoid duplicating the header: run a quick guard to only add if missing
+
+    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp; do
+      if [ -f "$f" ]; then
+        if ! head -n 5 "$f" | grep -q "Copyright (C) 2026 Piotr Franczyk"; then
+          cp "$f" "$f".bak
+          (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
+        fi
+      fi
+    done
+*/
+import fs from "node:fs";
+import { resolveEnvFilePath, resolveWorkspaceRoot } from "./workspace.js";
+const DEFAULT_ENV_FILE = ".env";
+export function loadDefaultEnvFile() {
+    const envFileName = process.env.KIBI_ENV_FILE ?? DEFAULT_ENV_FILE;
+    const workspaceRoot = resolveWorkspaceRoot();
+    return loadEnvFile({ envFileName, workspaceRoot });
+}
+export function loadEnvFile(options) {
+    const { envFileName, workspaceRoot } = options;
+    const envFilePath = resolveEnvFilePath(envFileName, workspaceRoot);
+    const keysLoaded = [];
+    if (!fs.existsSync(envFilePath)) {
+        return { loaded: false, envFilePath, keysLoaded };
+    }
+    try {
+        const raw = fs.readFileSync(envFilePath, "utf8");
+        for (const { key, value } of parseEnvContent(raw)) {
+            if (!key || Object.prototype.hasOwnProperty.call(process.env, key)) {
+                continue;
+            }
+            process.env[key] = value;
+            keysLoaded.push(key);
+        }
+        return { loaded: true, envFilePath, keysLoaded };
+    }
+    catch (error) {
+        console.error(`[Kibi] Unable to load environment file ${envFilePath}: ${error instanceof Error ? error.message : String(error)}`);
+        return { loaded: false, envFilePath, keysLoaded };
+    }
+}
+function parseEnvContent(content) {
+    const lines = content.split(/\r?\n/);
+    const entries = [];
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#")) {
+            continue;
+        }
+        const eqIndex = line.indexOf("=");
+        if (eqIndex <= 0) {
+            continue;
+        }
+        const key = line.substring(0, eqIndex).trim();
+        let value = line.substring(eqIndex + 1).trim();
+        if (value.startsWith('"') && value.endsWith('"')) {
+            value = value.slice(1, -1);
+        }
+        else if (value.startsWith("'") && value.endsWith("'")) {
+            value = value.slice(1, -1);
+        }
+        entries.push({ key, value });
+    }
+    return entries;
+}

package/dist/mcpcat.js

@@ -0,0 +1,129 @@
+/*
+ Kibi — repo-local, per-branch, queryable long-term memory for software projects
+ Copyright (C) 2026 Piotr Franczyk
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+/*
+ How to apply this header to source files (examples)
+
+ 1) Prepend header to a single file (POSIX shells):
+
+    cat LICENSE_HEADER.txt "$FILE" > "$FILE".with-header && mv "$FILE".with-header "$FILE"
+
+ 2) Apply to multiple files (example: the project's main entry files):
+
+    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp packages/cli/src/*.ts packages/mcp/src/*.ts; do
+      if [ -f "$f" ]; then
+        cp "$f" "$f".bak
+        (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
+      fi
+    done
+
+ 3) Avoid duplicating the header: run a quick guard to only add if missing
+
+    for f in packages/cli/bin/kibi packages/mcp/bin/kibi-mcp; do
+      if [ -f "$f" ]; then
+        if ! head -n 5 "$f" | grep -q "Copyright (C) 2026 Piotr Franczyk"; then
+          cp "$f" "$f".bak
+          (cat LICENSE_HEADER.txt; echo; cat "$f" ) > "$f".new && mv "$f".new "$f"
+        fi
+      fi
+    done
+*/
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import * as mcpcat from "mcpcat";
+import { resolveWorkspaceRoot } from "./workspace.js";
+const projectId = (process.env.MCPCAT_PROJECT_ID ?? "").trim();
+const trackedIdentity = resolveTrackedIdentity();
+/**
+ * Attach mcpcat analytics tracking to the MCP server.
+ *
+ * NOTE ON SESSIONS: With stdio transport, many MCP clients (including OpenCode)
+ * spawn a new process for each tool call. This means each tool call gets a new
+ * MCP session ID, resulting in single-tool-call "sessions" in mcpcat.
+ *
+ * This is expected behavior for stdio transport - each process IS a different
+ * session. User identity (via the identify() function) still provides useful
+ * aggregation across all tool calls from the same user/machine.
+ *
+ * For true session aggregation, clients would need to either:
+ * 1. Use HTTP transport with persistent connections
+ * 2. Maintain long-lived stdio connections across multiple tool calls
+ * 3. Implement custom session headers
+ */
+export function attachMcpcat(server) {
+    if (!projectId) {
+        return;
+    }
+    try {
+        mcpcat.track(server, projectId, {
+            identify: async () => trackedIdentity,
+            enableReportMissing: false, // Don't add get_more_tools tool - it's internal
+            enableTracing: true,
+            enableToolCallContext: false, // Don't inject context parameter into tools
+        });
+        if (process.env.KIBI_MCP_DEBUG) {
+            console.error(`[KIBI-MCP] MCPcat tracking enabled for project ${projectId}`);
+        }
+    }
+    catch (error) {
+        const details = error instanceof Error ? error.message : String(error);
+        console.error(`[KIBI-MCP] MCPcat tracking attach failed: ${details}`);
+    }
+}
+function resolveTrackedIdentity() {
+    const explicitUserId = readEnv("MCPCAT_USER_ID");
+    if (explicitUserId) {
+        return {
+            userId: explicitUserId,
+            userName: readEnv("MCPCAT_USER_NAME") ?? "local-operator",
+            userData: { identitySource: "env" },
+        };
+    }
+    const repoRoot = findRepoRoot(resolveWorkspaceRoot());
+    const repoName = path.basename(repoRoot);
+    const username = readEnv("USER") ?? readEnv("USERNAME") ?? "unknown-user";
+    const host = os.hostname() || "unknown-host";
+    const stableId = createHash("sha256")
+        .update(`${host}:${username}:${repoRoot}`)
+        .digest("hex")
+        .slice(0, 24);
+    return {
+        userId: `anon_${stableId}`,
+        userName: `local-${repoName}`,
+        userData: { identitySource: "host-user-repo-hash", repo: repoName },
+    };
+}
+function readEnv(name) {
+    const value = process.env[name]?.trim();
+    return value ? value : null;
+}
+function findRepoRoot(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        const gitMarker = path.join(current, ".git");
+        if (fs.existsSync(gitMarker)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return path.resolve(startDir);
+        }
+        current = parent;
+    }
+}