kiri-mcp-server 0.2.0

package/dist/src/daemon/daemon.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * KIRI Daemon Main Process
+ *
+ * Single daemon per database, handles multiple client connections via Unix socket.
+ * Manages DuckDB connection, watch mode, and graceful lifecycle.
+ */
+import * as path from "path";
+import { parseArgs } from "util";
+import { ensureDatabaseIndexed } from "../server/indexBootstrap.js";
+import { createRpcHandler } from "../server/rpc.js";
+import { createServerRuntime } from "../server/runtime.js";
+import { DaemonLifecycle } from "./lifecycle.js";
+import { createSocketServer } from "./socket.js";
+/**
+ * CLI引数をパース
+ */
+function parseDaemonArgs() {
+    const { values } = parseArgs({
+        options: {
+            repo: { type: "string" },
+            db: { type: "string" },
+            "socket-path": { type: "string" },
+            watch: { type: "boolean", default: false },
+            "daemon-timeout": { type: "string", default: "5" },
+            "allow-degrade": { type: "boolean", default: false },
+            "security-config": { type: "string" },
+            "security-lock": { type: "string" },
+        },
+    });
+    const repoRoot = path.resolve(values.repo || process.cwd());
+    const databasePath = path.resolve(values.db || path.join(repoRoot, "var", "index.duckdb"));
+    const socketPath = values["socket-path"]
+        ? path.resolve(values["socket-path"])
+        : `${databasePath}.sock`;
+    return {
+        repoRoot,
+        databasePath,
+        socketPath,
+        watchMode: values.watch || false,
+        idleTimeoutMinutes: parseInt(values["daemon-timeout"] || "5", 10),
+        allowDegrade: values["allow-degrade"] || false,
+        securityConfigPath: values["security-config"],
+        securityLockPath: values["security-lock"],
+    };
+}
+/**
+ * メイン関数：デーモンプロセスを起動
+ */
+async function main() {
+    const options = parseDaemonArgs();
+    const lifecycle = new DaemonLifecycle(options.databasePath, options.idleTimeoutMinutes);
+    try {
+        // スタートアップロックを取得
+        const lockAcquired = await lifecycle.acquireStartupLock();
+        if (!lockAcquired) {
+            console.error("[Daemon] Another daemon is starting up. Exiting to avoid race condition.");
+            process.exit(1);
+        }
+        await lifecycle.log(`Starting daemon for database: ${options.databasePath}`);
+        // PIDファイルを作成
+        await lifecycle.createPidFile();
+        console.error(`[Daemon] PID: ${process.pid}`);
+        // データベースが存在しない場合、自動的にインデックスを作成
+        await ensureDatabaseIndexed(options.repoRoot, options.databasePath, options.allowDegrade, false);
+        // ServerRuntimeを作成（DuckDB接続、メトリクス、デグレード制御など）
+        let runtime = null;
+        try {
+            const runtimeOptions = {
+                repoRoot: options.repoRoot,
+                databasePath: options.databasePath,
+                allowDegrade: options.allowDegrade,
+                allowWriteLock: true, // Daemon mode should auto-create security lock
+            };
+            if (options.securityConfigPath) {
+                runtimeOptions.securityConfigPath = options.securityConfigPath;
+            }
+            if (options.securityLockPath) {
+                runtimeOptions.securityLockPath = options.securityLockPath;
+            }
+            runtime = await createServerRuntime(runtimeOptions);
+            await lifecycle.log(`Runtime initialized for repo: ${options.repoRoot}`);
+        }
+        catch (err) {
+            const error = err;
+            await lifecycle.log(`Failed to create runtime: ${error.message}`);
+            console.error(`[Daemon] Failed to create runtime: ${error.message}`);
+            await lifecycle.removePidFile();
+            await lifecycle.releaseStartupLock();
+            process.exit(1);
+        }
+        // RPCハンドラを作成（既存のロジックを再利用）
+        const rpcHandler = createRpcHandler(runtime);
+        // Unixソケットサーバーを作成
+        const closeServer = await createSocketServer({
+            socketPath: options.socketPath || `${options.databasePath}.sock`,
+            onRequest: async (request) => {
+                lifecycle.incrementConnections();
+                try {
+                    return await rpcHandler(request);
+                }
+                finally {
+                    lifecycle.decrementConnections();
+                }
+            },
+            onError: async (error) => {
+                await lifecycle.log(`Connection error: ${error.message}`);
+                console.error(`[Daemon] Connection error: ${error.message}`);
+            },
+        });
+        await lifecycle.log(`Socket server listening on: ${options.socketPath || `${options.databasePath}.sock`}`);
+        // スタートアップロックを解放（起動完了）
+        await lifecycle.releaseStartupLock();
+        // ウォッチモードの設定
+        if (options.watchMode) {
+            lifecycle.setWatchModeActive(true);
+            await lifecycle.log("Watch mode enabled (daemon will not auto-stop)");
+            console.error("[Daemon] Watch mode enabled (daemon will not auto-stop)");
+            // TODO: IndexWatcherの統合
+        }
+        // グレースフルシャットダウンの設定
+        lifecycle.onShutdown(async () => {
+            await lifecycle.log("Shutting down daemon...");
+            console.error("[Daemon] Closing server...");
+            await closeServer();
+            console.error("[Daemon] Closing runtime...");
+            if (runtime) {
+                await runtime.close();
+            }
+        });
+        lifecycle.setupGracefulShutdown();
+        await lifecycle.log("Daemon started successfully");
+        console.error("[Daemon] Ready to accept connections");
+    }
+    catch (err) {
+        const error = err;
+        await lifecycle.log(`Fatal error: ${error.message}`);
+        console.error(`[Daemon] Fatal error: ${error.message}`);
+        await lifecycle.removePidFile();
+        await lifecycle.releaseStartupLock();
+        process.exit(1);
+    }
+}
+// エントリーポイント
+main().catch(async (err) => {
+    console.error(`[Daemon] Unhandled error: ${err}`);
+    process.exit(1);
+});
+//# sourceMappingURL=daemon.js.map

package/dist/src/daemon/daemon.js.map

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

package/dist/src/daemon/lifecycle.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Daemon Lifecycle Management
+ *
+ * Handles PID file creation, idle timeout, health checks, and graceful shutdown.
+ */
+/**
+ * PIDファイルとスタートアップロックを管理する
+ */
+export declare class DaemonLifecycle {
+    private readonly databasePath;
+    private readonly idleTimeoutMinutes;
+    private readonly pidFilePath;
+    private readonly startupLockPath;
+    private readonly logFilePath;
+    private idleTimer;
+    private activeConnections;
+    private watchModeActive;
+    private shutdownCallback?;
+    private readonly maxLogSizeBytes;
+    private readonly maxLogBackups;
+    constructor(databasePath: string, idleTimeoutMinutes?: number);
+    /**
+     * PIDファイルパスを取得
+     */
+    getPidFilePath(): string;
+    /**
+     * スタートアップロックファイルパスを取得
+     */
+    getStartupLockPath(): string;
+    /**
+     * ログファイルパスを取得
+     */
+    getLogFilePath(): string;
+    /**
+     * スタートアップロックを取得（排他的作成）
+     *
+     * @returns ロック取得に成功した場合はtrue、他のプロセスが既にロック中の場合はfalse
+     */
+    acquireStartupLock(): Promise<boolean>;
+    /**
+     * スタートアップロックを解放
+     */
+    releaseStartupLock(): Promise<void>;
+    /**
+     * PIDファイルを作成
+     */
+    createPidFile(): Promise<void>;
+    /**
+     * PIDファイルを削除
+     */
+    removePidFile(): Promise<void>;
+    /**
+     * デーモンが実行中かチェック（PIDファイルとプロセスの存在確認）
+     *
+     * @returns デーモンが実行中の場合はPID、それ以外はnull
+     */
+    checkRunning(): Promise<number | null>;
+    /**
+     * ウォッチモードの状態を設定
+     */
+    setWatchModeActive(active: boolean): void;
+    /**
+     * アクティブ接続数を増やす
+     */
+    incrementConnections(): void;
+    /**
+     * アクティブ接続数を減らす
+     */
+    decrementConnections(): void;
+    /**
+     * シャットダウンコールバックを登録
+     */
+    onShutdown(callback: () => Promise<void>): void;
+    /**
+     * アイドルタイマーをリセット
+     */
+    private resetIdleTimer;
+    /**
+     * アイドルタイマーを開始
+     *
+     * ウォッチモードが有効でなく、タイムアウトが0でない場合のみ開始
+     */
+    private startIdleTimer;
+    /**
+     * グレースフルシャットダウンを設定
+     */
+    setupGracefulShutdown(): void;
+    /**
+     * ログファイルをローテーション
+     *
+     * ファイルサイズが maxLogSizeBytes を超えた場合、古いログをバックアップして新しいログを開始
+     */
+    private rotateLogIfNeeded;
+    /**
+     * ログファイルにメッセージを書き込む
+     *
+     * ファイルサイズが制限を超えた場合、自動的にローテーションを実行
+     */
+    log(message: string): Promise<void>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/src/daemon/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/daemon/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,qBAAa,eAAe;IAYxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAZrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAC,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;gBAGxB,YAAY,EAAE,MAAM,EACpB,kBAAkB,GAAE,MAAU;IAOjD;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAc5C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAWzC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsB5C;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAQzC;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAK5B;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAO5B;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAoB7B;;;;OAIG;YACW,iBAAiB;IAmC/B;;;;OAIG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAc1C"}

package/dist/src/daemon/lifecycle.js

@@ -0,0 +1,266 @@
+/**
+ * Daemon Lifecycle Management
+ *
+ * Handles PID file creation, idle timeout, health checks, and graceful shutdown.
+ */
+import * as fs from "fs/promises";
+/**
+ * PIDファイルとスタートアップロックを管理する
+ */
+export class DaemonLifecycle {
+    databasePath;
+    idleTimeoutMinutes;
+    pidFilePath;
+    startupLockPath;
+    logFilePath;
+    idleTimer = null;
+    activeConnections = 0;
+    watchModeActive = false;
+    shutdownCallback;
+    maxLogSizeBytes = 10 * 1024 * 1024; // 10MB
+    maxLogBackups = 3;
+    constructor(databasePath, idleTimeoutMinutes = 5) {
+        this.databasePath = databasePath;
+        this.idleTimeoutMinutes = idleTimeoutMinutes;
+        this.pidFilePath = `${databasePath}.daemon.pid`;
+        this.startupLockPath = `${databasePath}.daemon.starting`;
+        this.logFilePath = `${databasePath}.daemon.log`;
+    }
+    /**
+     * PIDファイルパスを取得
+     */
+    getPidFilePath() {
+        return this.pidFilePath;
+    }
+    /**
+     * スタートアップロックファイルパスを取得
+     */
+    getStartupLockPath() {
+        return this.startupLockPath;
+    }
+    /**
+     * ログファイルパスを取得
+     */
+    getLogFilePath() {
+        return this.logFilePath;
+    }
+    /**
+     * スタートアップロックを取得（排他的作成）
+     *
+     * @returns ロック取得に成功した場合はtrue、他のプロセスが既にロック中の場合はfalse
+     */
+    async acquireStartupLock() {
+        try {
+            await fs.writeFile(this.startupLockPath, String(process.pid), {
+                flag: "wx", // 排他的作成
+            });
+            return true;
+        }
+        catch (err) {
+            if (err.code === "EEXIST") {
+                return false;
+            }
+            throw err;
+        }
+    }
+    /**
+     * スタートアップロックを解放
+     */
+    async releaseStartupLock() {
+        try {
+            await fs.unlink(this.startupLockPath);
+        }
+        catch (err) {
+            // ファイルが存在しない場合は無視
+            if (err.code !== "ENOENT") {
+                console.error(`Failed to release startup lock: ${err}`);
+            }
+        }
+    }
+    /**
+     * PIDファイルを作成
+     */
+    async createPidFile() {
+        await fs.writeFile(this.pidFilePath, String(process.pid), "utf-8");
+    }
+    /**
+     * PIDファイルを削除
+     */
+    async removePidFile() {
+        try {
+            await fs.unlink(this.pidFilePath);
+        }
+        catch (err) {
+            // ファイルが存在しない場合は無視
+            if (err.code !== "ENOENT") {
+                console.error(`Failed to remove PID file: ${err}`);
+            }
+        }
+    }
+    /**
+     * デーモンが実行中かチェック（PIDファイルとプロセスの存在確認）
+     *
+     * @returns デーモンが実行中の場合はPID、それ以外はnull
+     */
+    async checkRunning() {
+        try {
+            const pidStr = await fs.readFile(this.pidFilePath, "utf-8");
+            const pid = parseInt(pidStr.trim(), 10);
+            // プロセスが実際に存在するかチェック
+            try {
+                process.kill(pid, 0); // シグナル0は存在チェック
+                return pid;
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (_err) {
+                // プロセスが存在しない場合、PIDファイルは古い
+                return null;
+            }
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return null;
+            }
+            throw err;
+        }
+    }
+    /**
+     * ウォッチモードの状態を設定
+     */
+    setWatchModeActive(active) {
+        this.watchModeActive = active;
+        if (active) {
+            // ウォッチモードが有効な場合、アイドルタイマーをキャンセル
+            this.resetIdleTimer();
+        }
+    }
+    /**
+     * アクティブ接続数を増やす
+     */
+    incrementConnections() {
+        this.activeConnections++;
+        this.resetIdleTimer();
+    }
+    /**
+     * アクティブ接続数を減らす
+     */
+    decrementConnections() {
+        this.activeConnections = Math.max(0, this.activeConnections - 1);
+        if (this.activeConnections === 0) {
+            this.startIdleTimer();
+        }
+    }
+    /**
+     * シャットダウンコールバックを登録
+     */
+    onShutdown(callback) {
+        this.shutdownCallback = callback;
+    }
+    /**
+     * アイドルタイマーをリセット
+     */
+    resetIdleTimer() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+    }
+    /**
+     * アイドルタイマーを開始
+     *
+     * ウォッチモードが有効でなく、タイムアウトが0でない場合のみ開始
+     */
+    startIdleTimer() {
+        if (this.watchModeActive || this.idleTimeoutMinutes === 0) {
+            return;
+        }
+        this.resetIdleTimer();
+        this.idleTimer = setTimeout(async () => {
+            // タイマー発火時に再度チェック（レースコンディション対策）
+            if (this.activeConnections === 0 && !this.watchModeActive) {
+                console.error(`[Daemon] Idle timeout (${this.idleTimeoutMinutes} minutes) reached. Shutting down...`);
+                if (this.shutdownCallback) {
+                    await this.shutdownCallback();
+                }
+                process.exit(0);
+            }
+        }, this.idleTimeoutMinutes * 60 * 1000);
+    }
+    /**
+     * グレースフルシャットダウンを設定
+     */
+    setupGracefulShutdown() {
+        const shutdown = async (signal) => {
+            console.error(`[Daemon] Received ${signal}. Shutting down gracefully...`);
+            this.resetIdleTimer();
+            if (this.shutdownCallback) {
+                await this.shutdownCallback();
+            }
+            await this.removePidFile();
+            await this.releaseStartupLock();
+            process.exit(0);
+        };
+        process.on("SIGTERM", () => shutdown("SIGTERM"));
+        process.on("SIGINT", () => shutdown("SIGINT"));
+    }
+    /**
+     * ログファイルをローテーション
+     *
+     * ファイルサイズが maxLogSizeBytes を超えた場合、古いログをバックアップして新しいログを開始
+     */
+    async rotateLogIfNeeded() {
+        try {
+            const stats = await fs.stat(this.logFilePath);
+            if (stats.size < this.maxLogSizeBytes) {
+                return; // ローテーション不要
+            }
+            // 既存のバックアップをシフト (.log.3 -> .log.4 は削除, .log.2 -> .log.3, etc.)
+            for (let i = this.maxLogBackups; i > 0; i--) {
+                const oldBackup = `${this.logFilePath}.${i}`;
+                const newBackup = `${this.logFilePath}.${i + 1}`;
+                try {
+                    await fs.access(oldBackup);
+                    if (i === this.maxLogBackups) {
+                        // 最古のバックアップは削除
+                        await fs.unlink(oldBackup);
+                    }
+                    else {
+                        // バックアップをリネーム
+                        await fs.rename(oldBackup, newBackup);
+                    }
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                }
+                catch (_err) {
+                    // ファイルが存在しない場合は無視
+                }
+            }
+            // 現在のログファイルを .log.1 にリネーム
+            await fs.rename(this.logFilePath, `${this.logFilePath}.1`);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT") {
+                console.error(`Failed to rotate log file: ${err}`);
+            }
+        }
+    }
+    /**
+     * ログファイルにメッセージを書き込む
+     *
+     * ファイルサイズが制限を超えた場合、自動的にローテーションを実行
+     */
+    async log(message) {
+        // ローテーションチェック（非同期だがログ書き込みはブロックしない）
+        this.rotateLogIfNeeded().catch((err) => {
+            console.error(`Log rotation failed: ${err}`);
+        });
+        const timestamp = new Date().toISOString();
+        const logMessage = `${timestamp} ${message}\n`;
+        try {
+            await fs.appendFile(this.logFilePath, logMessage, "utf-8");
+        }
+        catch (err) {
+            console.error(`Failed to write to log file: ${err}`);
+        }
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/daemon/lifecycle.js.map

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

package/dist/src/daemon/socket.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Unix Socket Transport Layer for KIRI Daemon
+ *
+ * Provides IPC communication between daemon and clients via Unix domain sockets.
+ * Handles multiple concurrent client connections with newline-delimited JSON-RPC protocol.
+ */
+import type { JsonRpcRequest, RpcHandleResult } from "../server/rpc.js";
+/**
+ * Unix socket server configuration
+ */
+export interface SocketServerOptions {
+    /** Unix socket file path (e.g., /path/to/database.duckdb.sock) */
+    socketPath: string;
+    /** Handler function for JSON-RPC requests */
+    onRequest: (request: JsonRpcRequest) => Promise<RpcHandleResult | null>;
+    /** Optional error handler for connection errors */
+    onError?: (error: Error) => void;
+}
+/**
+ * ソケットサーバーを作成し、複数クライアント接続を処理する
+ *
+ * @param options - サーバー設定
+ * @returns クリーンアップ用のcloseハンドラ
+ */
+export declare function createSocketServer(options: SocketServerOptions): Promise<() => Promise<void>>;
+//# sourceMappingURL=socket.d.ts.map

package/dist/src/daemon/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/daemon/socket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACxE,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA4C9B"}