kiri-mcp-server 0.9.6 → 0.9.9

package/dist/src/shared/utils/socket.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Socket Path Utility for Cross-Platform IPC
+ *
+ * Generates platform-appropriate IPC paths:
+ * - Unix/Linux/macOS: Unix domain socket files (e.g., /path/to/database.duckdb.sock)
+ * - Windows: Named pipes (e.g., \\.\pipe\kiri-<hash>)
+ */
+/**
+ * プラットフォームに応じた適切なソケットパスを生成
+ *
+ * Windows環境では名前付きパイプ形式（\\.\pipe\kiri-<hash>）を使用し、
+ * Unix系環境ではファイルシステムパス（<databasePath>.sock）を使用し、
+ * パス長が上限を超える場合は /tmp などの短いディレクトリに自動フォールバックする。
+ *
+ * **セキュリティ注意事項**:
+ * - Unix: ソケットファイルは0600パーミッション（所有者のみアクセス可能）で保護
+ *   しつつ、KIRI_SOCKET_DIR でフォールバック先ディレクトリを明示できます。
+ * - Windows: 名前付きパイプはデフォルトACLを使用（同一システムの他ユーザーが
+ *   アクセス可能な場合がある）。ハッシュベースのパイプ名で曖昧性を提供するが、
+ *   マルチユーザー環境では信頼できる環境でのみ使用することを推奨。
+ * - Windows環境では KIRI_PIPE_PREFIX 環境変数でパイプ名プレフィックスを
+ *   カスタマイズ可能（追加のセキュリティ層として利用可能）
+ *
+ * @param databasePath - データベースファイルの絶対パス
+ * @returns プラットフォーム固有のソケットパス
+ *
+ * @example
+ * // Unix/macOS/Linux
+ * getSocketPath("/path/to/database.duckdb")
+ * // => "/path/to/database.duckdb.sock"
+ *
+ * // Windows (デフォルト)
+ * getSocketPath("C:\\Users\\user\\database.duckdb")
+ * // => "\\\\.\\pipe\\kiri-a1b2c3d4..."
+ *
+ * // Windows (カスタムプレフィックス)
+ * process.env.KIRI_PIPE_PREFIX = "myapp"
+ * getSocketPath("C:\\Users\\user\\database.duckdb")
+ * // => "\\\\.\\pipe\\myapp-a1b2c3d4..."
+ */
+export declare function getSocketPath(databasePath: string, options?: {
+    ensureDir?: boolean;
+}): string;
+/**
+ * ソケットパスからデータベースパスを推測（Unix系のみ）
+ *
+ * Windows環境ではハッシュベースのパイプ名を使用するため、
+ * この関数は情報損失があり、デバッグ用途にのみ使用すべき。
+ *
+ * @param socketPath - ソケットパス
+ * @returns データベースパス（Unix系の場合）またはnull（Windows/不明な形式）
+ */
+export declare function getDatabasePathFromSocket(socketPath: string): string | null;
+/**
+ * デバッグ用のソケットパス情報を生成
+ *
+ * @param databasePath - データベースファイルの絶対パス
+ * @returns デバッグ情報文字列
+ */
+export declare function getSocketPathDebugInfo(databasePath: string): string;
+//# sourceMappingURL=socket.d.ts.map

package/dist/src/shared/utils/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/socket.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsDH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAsB7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY3E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA+BnE"}

package/dist/src/shared/utils/socket.js

@@ -0,0 +1,156 @@
+/**
+ * Socket Path Utility for Cross-Platform IPC
+ *
+ * Generates platform-appropriate IPC paths:
+ * - Unix/Linux/macOS: Unix domain socket files (e.g., /path/to/database.duckdb.sock)
+ * - Windows: Named pipes (e.g., \\.\pipe\kiri-<hash>)
+ */
+import * as crypto from "crypto";
+import { mkdirSync } from "node:fs";
+import * as os from "os";
+import * as path from "path";
+const UNIX_SOCKET_PATH_MAX = 96; // macOS 104-byte limitに安全マージンを残す
+const SOCKET_PREFIX = "kiri";
+const SOCKET_DIR_ENV = "KIRI_SOCKET_DIR";
+function sanitizeBaseName(fileName) {
+    const sanitized = fileName.replace(/[^a-zA-Z0-9]/g, "-");
+    return sanitized.length > 0 ? sanitized.toLowerCase() : "db";
+}
+function ensureSocketDir(dirPath) {
+    try {
+        mkdirSync(dirPath, { recursive: true, mode: 0o700 });
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to prepare socket directory ${dirPath}: ${err.message}. ` +
+            `Set ${SOCKET_DIR_ENV} to a writable directory.`);
+    }
+}
+function buildFallbackUnixSocketPath(databasePath, ensureDir) {
+    const fallbackDir = process.env[SOCKET_DIR_ENV] || os.tmpdir();
+    const hash = crypto.createHash("sha256").update(databasePath).digest("hex");
+    const baseName = sanitizeBaseName(path.basename(databasePath));
+    const candidates = [
+        path.join(fallbackDir, `${SOCKET_PREFIX}-${baseName}-${hash.slice(0, 12)}.sock`),
+        path.join(fallbackDir, `${SOCKET_PREFIX}-${hash.slice(0, 12)}.sock`),
+        path.join(fallbackDir, `${SOCKET_PREFIX}-${hash.slice(0, 8)}.sock`),
+    ];
+    for (const candidate of candidates) {
+        if (Buffer.byteLength(candidate, "utf8") <= UNIX_SOCKET_PATH_MAX) {
+            if (ensureDir) {
+                ensureSocketDir(path.dirname(candidate));
+            }
+            return candidate;
+        }
+    }
+    throw new Error(`Unable to construct Unix socket path under ${UNIX_SOCKET_PATH_MAX} characters. ` +
+        `Set ${SOCKET_DIR_ENV} to a shorter directory.`);
+}
+/**
+ * プラットフォームに応じた適切なソケットパスを生成
+ *
+ * Windows環境では名前付きパイプ形式（\\.\pipe\kiri-<hash>）を使用し、
+ * Unix系環境ではファイルシステムパス（<databasePath>.sock）を使用し、
+ * パス長が上限を超える場合は /tmp などの短いディレクトリに自動フォールバックする。
+ *
+ * **セキュリティ注意事項**:
+ * - Unix: ソケットファイルは0600パーミッション（所有者のみアクセス可能）で保護
+ *   しつつ、KIRI_SOCKET_DIR でフォールバック先ディレクトリを明示できます。
+ * - Windows: 名前付きパイプはデフォルトACLを使用（同一システムの他ユーザーが
+ *   アクセス可能な場合がある）。ハッシュベースのパイプ名で曖昧性を提供するが、
+ *   マルチユーザー環境では信頼できる環境でのみ使用することを推奨。
+ * - Windows環境では KIRI_PIPE_PREFIX 環境変数でパイプ名プレフィックスを
+ *   カスタマイズ可能（追加のセキュリティ層として利用可能）
+ *
+ * @param databasePath - データベースファイルの絶対パス
+ * @returns プラットフォーム固有のソケットパス
+ *
+ * @example
+ * // Unix/macOS/Linux
+ * getSocketPath("/path/to/database.duckdb")
+ * // => "/path/to/database.duckdb.sock"
+ *
+ * // Windows (デフォルト)
+ * getSocketPath("C:\\Users\\user\\database.duckdb")
+ * // => "\\\\.\\pipe\\kiri-a1b2c3d4..."
+ *
+ * // Windows (カスタムプレフィックス)
+ * process.env.KIRI_PIPE_PREFIX = "myapp"
+ * getSocketPath("C:\\Users\\user\\database.duckdb")
+ * // => "\\\\.\\pipe\\myapp-a1b2c3d4..."
+ */
+export function getSocketPath(databasePath, options) {
+    const ensureDir = options?.ensureDir ?? false;
+    if (os.platform() === "win32") {
+        // Windows: 名前付きパイプを使用
+        // データベースパスのハッシュを使ってユニークなパイプ名を生成
+        const hash = crypto.createHash("sha256").update(databasePath).digest("hex");
+        // 環境変数でプレフィックスをカスタマイズ可能（追加のセキュリティ層）
+        const prefix = process.env.KIRI_PIPE_PREFIX || SOCKET_PREFIX;
+        // 最初の16文字を使用（衝突リスクは極めて低い）
+        const pipeName = `${prefix}-${hash.substring(0, 16)}`;
+        return `\\\\.\\pipe\\${pipeName}`;
+    }
+    const defaultSocketPath = `${databasePath}.sock`;
+    if (Buffer.byteLength(defaultSocketPath, "utf8") <= UNIX_SOCKET_PATH_MAX) {
+        if (ensureDir) {
+            ensureSocketDir(path.dirname(defaultSocketPath));
+        }
+        return defaultSocketPath;
+    }
+    return buildFallbackUnixSocketPath(databasePath, ensureDir);
+}
+/**
+ * ソケットパスからデータベースパスを推測（Unix系のみ）
+ *
+ * Windows環境ではハッシュベースのパイプ名を使用するため、
+ * この関数は情報損失があり、デバッグ用途にのみ使用すべき。
+ *
+ * @param socketPath - ソケットパス
+ * @returns データベースパス（Unix系の場合）またはnull（Windows/不明な形式）
+ */
+export function getDatabasePathFromSocket(socketPath) {
+    if (os.platform() === "win32") {
+        // Windowsではパイプ名からデータベースパスを復元できない
+        return null;
+    }
+    // Unix系: .sock拡張子を削除
+    if (socketPath.endsWith(".sock")) {
+        return socketPath.slice(0, -5); // ".sock" の長さは5
+    }
+    return null;
+}
+/**
+ * デバッグ用のソケットパス情報を生成
+ *
+ * @param databasePath - データベースファイルの絶対パス
+ * @returns デバッグ情報文字列
+ */
+export function getSocketPathDebugInfo(databasePath) {
+    const socketPath = getSocketPath(databasePath);
+    const platform = os.platform();
+    const defaultUnixSocket = `${databasePath}.sock`;
+    // プラットフォーム固有のpathモジュールを使用して正しくパースする
+    const pathModule = platform === "win32" ? path.win32 : path.posix;
+    const dbDir = pathModule.dirname(databasePath);
+    const dbBase = pathModule.basename(databasePath);
+    if (platform === "win32") {
+        return [
+            `Database: ${dbBase} (${dbDir})`,
+            `Socket: ${socketPath} (Windows named pipe)`,
+            `Note: Pipe name is derived from database path hash for uniqueness`,
+        ].join("\n");
+    }
+    else {
+        const lines = [
+            `Database: ${dbBase} (${dbDir})`,
+            `Socket: ${socketPath} (Unix domain socket)`,
+            `Permissions: Owner-only (0600)`,
+        ];
+        if (socketPath !== defaultUnixSocket) {
+            lines.push(`Fallback: Socket path shortened (set ${SOCKET_DIR_ENV} to override base directory)`);
+        }
+        return lines.join("\n");
+    }
+}
+//# sourceMappingURL=socket.js.map

package/dist/src/shared/utils/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../../src/shared/utils/socket.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiri-mcp-server",
-  "version": "0.9.6",
+  "version": "0.9.9",
   "description": "KIRI context extraction platform",
   "type": "module",
   "packageManager": "pnpm@9.0.0",
@@ -56,6 +56,13 @@
     "dev": "tsx src/server/main.ts --port 8765",
     "lint": "eslint \"{src,tests,scripts}/**/*.{ts,tsx}\" && prettier --check \"**/*.{ts,tsx,json,md,yml}\"",
     "test": "vitest run --coverage --pool=forks --poolOptions.forks.singleFork --poolOptions.forks.maxForks=1 --poolOptions.forks.minForks=1",
+    "verify": "tsx scripts/test/verify-all.ts",
+    "verify:unit": "tsx scripts/test/verify-all.ts --category unit",
+    "verify:dart": "tsx scripts/test/verify-all.ts --category dart",
+    "verify:integration": "tsx scripts/test/verify-all.ts --category integration",
+    "verify:tools": "tsx scripts/test/verify-all.ts --category tools",
+    "verify:watch": "tsx scripts/test/verify-all.ts --category watch",
+    "verify:eval": "tsx scripts/test/verify-all.ts --category eval",
     "check": "pnpm run lint && pnpm run test",
     "prepublishOnly": "pnpm run build"
   },
@@ -63,7 +70,9 @@
     "chokidar": "^4.0.3",
     "duckdb": "^1.1.0",
     "gpt-tokenizer": "^3.2.0",
+    "p-queue": "^9.0.0",
     "tree-sitter": "^0.22.0",
+    "tree-sitter-java": "^0.23.2",
     "tree-sitter-php": "^0.22.8",
     "tree-sitter-swift": "0.7.1",
     "typescript": "^5.6.3",
@@ -78,6 +87,7 @@
     "eslint": "^9.9.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-import": "^2.29.1",
+    "execa": "^9.6.0",
     "lint-staged": "^15.2.10",
     "prettier": "^3.3.3",
     "simple-git-hooks": "^2.10.0",