kiri-mcp-server 0.2.0

package/dist/src/server/runtime.js

@@ -0,0 +1,59 @@
+import { resolve } from "node:path";
+import { tryCreateFTSIndex } from "../indexer/schema.js";
+import { DuckDBClient } from "../shared/duckdb.js";
+import { bootstrapServer } from "./bootstrap.js";
+import { DegradeController } from "./fallbacks/degradeController.js";
+import { resolveRepoId } from "./handlers.js";
+import { MetricsRegistry } from "./observability/metrics.js";
+export async function createServerRuntime(options) {
+    const bootstrapOptions = {};
+    if (options.securityConfigPath) {
+        bootstrapOptions.securityConfigPath = options.securityConfigPath;
+    }
+    if (options.securityLockPath) {
+        bootstrapOptions.securityLockPath = options.securityLockPath;
+    }
+    if (options.allowWriteLock !== undefined) {
+        bootstrapOptions.allowWriteLock = options.allowWriteLock;
+    }
+    const bootstrap = bootstrapServer(bootstrapOptions);
+    const databasePath = resolve(options.databasePath);
+    const repoRoot = resolve(options.repoRoot);
+    let db = null;
+    try {
+        db = await DuckDBClient.connect({ databasePath, ensureDirectory: true });
+        const repoId = await resolveRepoId(db, repoRoot);
+        // FTS拡張の利用可否を検出
+        const hasFTS = await tryCreateFTSIndex(db);
+        const context = {
+            db,
+            repoId,
+            features: {
+                fts: hasFTS,
+            },
+        };
+        const degrade = new DegradeController(repoRoot);
+        const metrics = new MetricsRegistry();
+        const tokens = bootstrap.security.config.sensitive_tokens ?? [];
+        const allowDegrade = options.allowDegrade ?? false;
+        return {
+            context,
+            degrade,
+            metrics,
+            tokens,
+            allowDegrade,
+            close: async () => {
+                if (db) {
+                    await db.close();
+                }
+            },
+        };
+    }
+    catch (error) {
+        if (db) {
+            await db.close();
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/server/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/server/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAyB,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAoB7D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAA4B;IACpE,MAAM,gBAAgB,GAAqB,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC/B,gBAAgB,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,gBAAgB,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACzC,gBAAgB,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC3D,CAAC;IACD,MAAM,SAAS,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAEpD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,EAAE,GAAwB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAEjD,gBAAgB;QAChB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAE3C,MAAM,OAAO,GAAkB;YAC7B,EAAE;YACF,MAAM;YACN,QAAQ,EAAE;gBACR,GAAG,EAAE,MAAM;aACZ;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAChE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;QAEnD,OAAO;YACL,OAAO;YACP,OAAO;YACP,OAAO;YACP,MAAM;YACN,YAAY;YACZ,KAAK,EAAE,KAAK,IAAI,EAAE;gBAChB,IAAI,EAAE,EAAE,CAAC;oBACP,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/server/scoring.d.ts

@@ -0,0 +1,20 @@
+/**
+ * スコアリングウェイトの設定
+ * context.bundle の候補ファイルに対するスコアリング重みを定義
+ */
+export interface ScoringWeights {
+    /** テキストマッチ（キーワード検索）の重み */
+    textMatch: number;
+    /** 編集中ファイル（editing_path）の重み */
+    editingPath: number;
+    /** 依存関係の重み */
+    dependency: number;
+    /** 近接ファイル（同一ディレクトリ）の重み */
+    proximity: number;
+    /** 構造的類似度の重み（LSHベース、セマンティック埋め込みではない） */
+    structural: number;
+}
+export type ScoringProfileName = "default" | "bugfix" | "testfail" | "typeerror" | "feature";
+export declare function coerceProfileName(name?: string | null): ScoringProfileName | null;
+export declare function loadScoringProfile(profileName?: ScoringProfileName | null): ScoringWeights;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/src/server/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/server/scoring.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AA0G7F,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,kBAAkB,GAAG,IAAI,CAOjF;AAED,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,cAAc,CAM1F"}

package/dist/src/server/scoring.js

@@ -0,0 +1,112 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseSimpleYaml } from "../shared/utils/simpleYaml.js";
+// プロファイルキャッシュ（起動時に一度だけロード）
+let profilesCache = null;
+/**
+ * スコアリングウェイトの妥当性を検証
+ * すべてのウェイトが非負の有限数であることを確認
+ */
+function validateWeights(weights, profileName) {
+    if (typeof weights !== "object" || weights === null) {
+        throw new Error(`Profile '${profileName}' must be an object`);
+    }
+    const required = ["textMatch", "editingPath", "dependency", "proximity", "structural"];
+    const obj = weights;
+    for (const key of required) {
+        const value = obj[key];
+        if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+            throw new Error(`Profile '${profileName}' has invalid ${key}: ${String(value)}. Must be a non-negative finite number.`);
+        }
+    }
+    return weights;
+}
+function loadProfilesFromConfig() {
+    if (profilesCache) {
+        return profilesCache;
+    }
+    try {
+        // 環境変数でカスタムパスを指定可能
+        // 本番環境（npm install）では dist/config/ を、開発環境では config/ を参照
+        const configPath = process.env.KIRI_SCORING_CONFIG ??
+            join(fileURLToPath(import.meta.url), "../../config/scoring-profiles.yml");
+        const configContent = readFileSync(configPath, "utf-8");
+        const parsed = parseSimpleYaml(configContent);
+        // 必須プロファイルの検証とウェイトのバリデーション
+        const requiredProfiles = [
+            "default",
+            "bugfix",
+            "testfail",
+            "typeerror",
+            "feature",
+        ];
+        const validated = {};
+        for (const profile of requiredProfiles) {
+            if (!parsed[profile]) {
+                throw new Error(`Missing required scoring profile: ${profile}`);
+            }
+            validated[profile] = validateWeights(parsed[profile], profile);
+        }
+        profilesCache = validated;
+        return profilesCache;
+    }
+    catch (error) {
+        console.warn("Failed to load scoring profiles from config, using fallback defaults", error);
+        // フォールバック: ハードコードされたデフォルト値
+        profilesCache = {
+            default: {
+                textMatch: 1.0,
+                editingPath: 2.0,
+                dependency: 0.5,
+                proximity: 0.25,
+                structural: 0.75,
+            },
+            bugfix: {
+                textMatch: 1.0,
+                editingPath: 1.8,
+                dependency: 0.7,
+                proximity: 0.35,
+                structural: 0.9,
+            },
+            testfail: {
+                textMatch: 1.0,
+                editingPath: 1.6,
+                dependency: 0.85,
+                proximity: 0.3,
+                structural: 0.8,
+            },
+            typeerror: {
+                textMatch: 1.0,
+                editingPath: 1.4,
+                dependency: 0.6,
+                proximity: 0.4,
+                structural: 0.6,
+            },
+            feature: {
+                textMatch: 1.0,
+                editingPath: 1.5,
+                dependency: 0.45,
+                proximity: 0.5,
+                structural: 0.7,
+            },
+        };
+        return profilesCache;
+    }
+}
+export function coerceProfileName(name) {
+    if (!name) {
+        return null;
+    }
+    const profiles = loadProfilesFromConfig();
+    const normalized = name.toLowerCase();
+    return normalized in profiles ? normalized : null;
+}
+export function loadScoringProfile(profileName) {
+    const profiles = loadProfilesFromConfig();
+    if (profileName && profileName in profiles) {
+        return profiles[profileName];
+    }
+    return profiles.default;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/src/server/scoring.js.map

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

package/dist/src/server/stdio.d.ts

@@ -0,0 +1,4 @@
+import { type CommonServerOptions } from "./runtime.js";
+export type StdioServerOptions = CommonServerOptions;
+export declare function startStdioServer(options: StdioServerOptions): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/src/server/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/server/stdio.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAErD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6FjF"}

package/dist/src/server/stdio.js

@@ -0,0 +1,88 @@
+import { performance } from "node:perf_hooks";
+import { stdin, stdout, stderr } from "node:process";
+import { createInterface } from "node:readline";
+import { createRpcHandler, errorResponse, validateJsonRpcRequest } from "./rpc.js";
+import { createServerRuntime } from "./runtime.js";
+export async function startStdioServer(options) {
+    const runtime = await createServerRuntime(options);
+    const handleRpc = createRpcHandler(runtime);
+    const rl = createInterface({ input: stdin, crlfDelay: Infinity });
+    const closeRuntime = async () => {
+        await runtime.close();
+    };
+    stderr.write("KIRI MCP stdio server ready\n");
+    await new Promise((resolve) => {
+        rl.on("line", (line) => {
+            const trimmed = line.trim();
+            if (!trimmed) {
+                return;
+            }
+            // Handle each line in a separate async context with proper error handling
+            (async () => {
+                try {
+                    let payload;
+                    try {
+                        payload = JSON.parse(line);
+                    }
+                    catch {
+                        const response = errorResponse(0, "Invalid JSON payload. Submit a JSON-RPC 2.0 compliant request.", -32700);
+                        stdout.write(JSON.stringify(response) + "\n");
+                        return;
+                    }
+                    const validationMessage = validateJsonRpcRequest(payload);
+                    const hasResponseId = typeof payload.id === "string" || typeof payload.id === "number";
+                    if (validationMessage) {
+                        if (hasResponseId) {
+                            const response = errorResponse(payload.id, validationMessage);
+                            stdout.write(JSON.stringify(response) + "\n");
+                        }
+                        return;
+                    }
+                    const start = performance.now();
+                    try {
+                        const result = await handleRpc(payload);
+                        if (result) {
+                            stdout.write(JSON.stringify(result.response) + "\n");
+                        }
+                    }
+                    catch (error) {
+                        stderr.write(`Unhandled stdio RPC error: ${String(error)}\n`);
+                        if (hasResponseId) {
+                            const response = errorResponse(payload.id, "Unexpected server error. Inspect server logs and retry the request.");
+                            stdout.write(JSON.stringify(response) + "\n");
+                        }
+                    }
+                    finally {
+                        const elapsed = performance.now() - start;
+                        runtime.metrics.recordRequest(elapsed);
+                    }
+                }
+                catch (error) {
+                    // Safe error logging with fallback - prevents server crash if stderr fails
+                    try {
+                        stderr.write(`Failed to process RPC line: ${String(error)}\n`);
+                    }
+                    catch {
+                        // Silent failure - better than crashing the server
+                        // This catch prevents uncaught exceptions if stderr.write throws
+                    }
+                }
+            })();
+        });
+        rl.once("close", async () => {
+            await closeRuntime();
+            resolve();
+        });
+        stdin.once("end", () => {
+            rl.close();
+        });
+        stdin.once("close", () => {
+            rl.close();
+        });
+        stdin.once("error", (error) => {
+            stderr.write(`STDIN error: ${error instanceof Error ? error.message : String(error)}\n`);
+            rl.close();
+        });
+    });
+}
+//# sourceMappingURL=stdio.js.map

package/dist/src/server/stdio.js.map

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

package/dist/src/shared/duckdb.d.ts

@@ -0,0 +1,16 @@
+export interface DuckDBClientOptions {
+    databasePath: string;
+    ensureDirectory?: boolean;
+}
+type QueryParams = unknown[] | Record<string, unknown>;
+export declare class DuckDBClient {
+    private readonly database;
+    constructor(path: string);
+    static connect(options: DuckDBClientOptions): Promise<DuckDBClient>;
+    run(sql: string, params?: QueryParams): Promise<void>;
+    all<T>(sql: string, params?: QueryParams): Promise<T[]>;
+    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=duckdb.d.ts.map

package/dist/src/shared/duckdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.d.ts","sourceRoot":"","sources":["../../../src/shared/duckdb.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,KAAK,WAAW,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAqBvD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,IAAI,EAAE,MAAM;WAIX,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAOnE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BzD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA6B3D,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAchD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}

package/dist/src/shared/duckdb.js

@@ -0,0 +1,121 @@
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import duckdb from "duckdb";
+function hasDefinedParams(params) {
+    return Array.isArray(params) ? params.length > 0 : Object.keys(params).length > 0;
+}
+function assertNoUndefined(sql, params) {
+    if (Array.isArray(params)) {
+        const index = params.findIndex((value) => value === undefined);
+        if (index >= 0) {
+            throw new Error(`Parameter ${index} is undefined for SQL: ${sql}`);
+        }
+    }
+    else {
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined) {
+                throw new Error(`Parameter ${key} is undefined for SQL: ${sql}`);
+            }
+        }
+    }
+}
+export class DuckDBClient {
+    database;
+    constructor(path) {
+        this.database = new duckdb.Database(path);
+    }
+    static async connect(options) {
+        if (options.ensureDirectory) {
+            await mkdir(dirname(options.databasePath), { recursive: true });
+        }
+        return new DuckDBClient(options.databasePath);
+    }
+    async run(sql, params = []) {
+        assertNoUndefined(sql, params);
+        await new Promise((resolve, reject) => {
+            const callback = (err) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                resolve();
+            };
+            if (Array.isArray(params)) {
+                if (params.length > 0) {
+                    // @ts-expect-error - duckdb.run expects rest parameters which cannot be strongly typed with unknown[]
+                    this.database.run(sql, ...params, callback);
+                }
+                else {
+                    this.database.run(sql, callback);
+                }
+            }
+            else if (hasDefinedParams(params)) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                this.database.run(sql, params, callback);
+            }
+            else {
+                this.database.run(sql, callback);
+            }
+        }).catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`${message} | SQL: ${sql} | Params: ${JSON.stringify(params)}`);
+        });
+    }
+    async all(sql, params = []) {
+        assertNoUndefined(sql, params);
+        return await new Promise((resolve, reject) => {
+            const callback = (err, rows) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                resolve(rows);
+            };
+            if (Array.isArray(params)) {
+                if (params.length > 0) {
+                    // @ts-expect-error - duckdb.all expects rest parameters which cannot be strongly typed with unknown[]
+                    this.database.all(sql, ...params, callback);
+                }
+                else {
+                    this.database.all(sql, callback);
+                }
+            }
+            else if (hasDefinedParams(params)) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                this.database.all(sql, params, callback);
+            }
+            else {
+                this.database.all(sql, callback);
+            }
+        }).catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`${message} | SQL: ${sql} | Params: ${JSON.stringify(params)}`);
+        });
+    }
+    async transaction(fn) {
+        await this.run("BEGIN TRANSACTION");
+        try {
+            const result = await fn();
+            await this.run("COMMIT");
+            return result;
+        }
+        catch (error) {
+            await this.run("ROLLBACK").catch(() => {
+                // Ignore rollback errors so original error is surfaced.
+            });
+            throw error;
+        }
+    }
+    async close() {
+        await new Promise((resolve, reject) => {
+            this.database.close((err) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=duckdb.js.map

package/dist/src/shared/duckdb.js.map

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

package/dist/src/shared/embedding.d.ts

@@ -0,0 +1,19 @@
+export interface EmbeddingVector {
+    dims: number;
+    values: number[];
+}
+export declare function generateEmbedding(text: string, dims?: number): EmbeddingVector | null;
+/**
+ * Calculate structural similarity between two embedding vectors using cosine similarity.
+ * Note: This measures syntactic/structural similarity based on LSH (Locality-Sensitive Hashing),
+ * not semantic similarity from language models like BERT or GPT embeddings.
+ *
+ * @param a - First embedding vector
+ * @param b - Second embedding vector
+ * @returns Similarity score between 0 and 1
+ */
+export declare function structuralSimilarity(a: number[], b: number[]): number;
+/** @deprecated Use structuralSimilarity() instead. Kept for backward compatibility. */
+export declare const cosineSimilarity: typeof structuralSimilarity;
+export declare const EMBEDDING_DIMS = 64;
+//# sourceMappingURL=embedding.d.ts.map

package/dist/src/shared/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../../src/shared/embedding.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAyCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAe,GAAG,eAAe,GAAG,IAAI,CAa3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAsBrE;AAED,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,6BAAuB,CAAC;AAErD,eAAO,MAAM,cAAc,KAAe,CAAC"}

package/dist/src/shared/embedding.js

@@ -0,0 +1,85 @@
+import { createHash } from "node:crypto";
+const DEFAULT_DIMS = 64;
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^\p{L}\p{N}_]+/u)
+        .map((token) => token.trim())
+        .filter((token) => token.length > 0);
+}
+function hashToken(token) {
+    const digest = createHash("sha256").update(token).digest();
+    // Use the first four bytes to build a deterministic integer hash
+    const byte0 = digest[0] ?? 0;
+    const byte1 = digest[1] ?? 0;
+    const byte2 = digest[2] ?? 0;
+    const byte3 = digest[3] ?? 0;
+    return ((byte0 << 24) | (byte1 << 16) | (byte2 << 8) | byte3) >>> 0;
+}
+function applyToken(vector, token) {
+    const hash = hashToken(token);
+    const index = hash % vector.length;
+    const sign = (hash & 1) === 0 ? 1 : -1;
+    const weight = Math.log(1 + token.length);
+    const current = vector[index];
+    if (current !== undefined) {
+        vector[index] = current + sign * weight;
+    }
+}
+function normalize(values) {
+    const norm = Math.sqrt(values.reduce((sum, value) => sum + value * value, 0));
+    if (!Number.isFinite(norm) || norm === 0) {
+        return values.map(() => 0);
+    }
+    return values.map((value) => value / norm);
+}
+export function generateEmbedding(text, dims = DEFAULT_DIMS) {
+    if (!text || text.trim().length === 0) {
+        return null;
+    }
+    const tokens = tokenize(text);
+    if (tokens.length === 0) {
+        return null;
+    }
+    const vector = new Array(dims).fill(0);
+    for (const token of tokens) {
+        applyToken(vector, token);
+    }
+    return { dims, values: normalize(vector) };
+}
+/**
+ * Calculate structural similarity between two embedding vectors using cosine similarity.
+ * Note: This measures syntactic/structural similarity based on LSH (Locality-Sensitive Hashing),
+ * not semantic similarity from language models like BERT or GPT embeddings.
+ *
+ * @param a - First embedding vector
+ * @param b - Second embedding vector
+ * @returns Similarity score between 0 and 1
+ */
+export function structuralSimilarity(a, b) {
+    const length = Math.min(a.length, b.length);
+    if (length === 0) {
+        return 0;
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < length; i += 1) {
+        const valueA = a[i];
+        const valueB = b[i];
+        if (valueA === undefined || valueB === undefined) {
+            continue;
+        }
+        dot += valueA * valueB;
+        normA += valueA * valueA;
+        normB += valueB * valueB;
+    }
+    if (normA === 0 || normB === 0) {
+        return 0;
+    }
+    return dot / Math.sqrt(normA * normB);
+}
+/** @deprecated Use structuralSimilarity() instead. Kept for backward compatibility. */
+export const cosineSimilarity = structuralSimilarity;
+export const EMBEDDING_DIMS = DEFAULT_DIMS;
+//# sourceMappingURL=embedding.js.map

package/dist/src/shared/embedding.js.map

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

package/dist/src/shared/index.d.ts

@@ -0,0 +1,3 @@
+export declare function assertCondition(condition: unknown, message: string): asserts condition;
+export declare function notImplemented(feature: string): never;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/index.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAItF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAErD"}

package/dist/src/shared/index.js

@@ -0,0 +1,9 @@
+export function assertCondition(condition, message) {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+export function notImplemented(feature) {
+    throw new Error(`Feature not implemented: ${feature}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/index.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,SAAkB,EAAE,OAAe;IACjE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/src/shared/security/config.d.ts

@@ -0,0 +1,23 @@
+export interface SecurityConfig {
+    allowed_paths: string[];
+    allow_network_egress: boolean;
+    allow_subprocess: boolean;
+    sensitive_tokens: string[];
+}
+export interface SecurityStatus {
+    config: SecurityConfig;
+    configPath: string;
+    lockPath: string;
+    hash: string;
+    lockHash: string | null;
+    matches: boolean;
+}
+export declare function loadSecurityConfig(configPath?: string): {
+    config: SecurityConfig;
+    hash: string;
+};
+export declare function readSecurityLock(lockPath?: string): string | null;
+export declare function evaluateSecurityStatus(configPath?: string, lockPath?: string): SecurityStatus;
+export declare function assertSecurityBaseline(configPath?: string, lockPath?: string): SecurityStatus;
+export declare function updateSecurityLock(hash: string, lockPath?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/shared/security/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/shared/security/config.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAehG;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAY7F;AAED,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAa7F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E"}