bonecode 1.1.0 → 1.2.1

package/dist/bone/output/rag/src/db.d.ts

@@ -0,0 +1,6 @@
+import { PoolClient } from "pg";
+export declare const pool: any;
+export declare function query<T = any>(text: string, params?: any[]): Promise<T[]>;
+export declare function queryOne<T = any>(text: string, params?: any[]): Promise<T | null>;
+export declare function execute(text: string, params?: any[]): Promise<number>;
+export declare function transaction<T>(fn: (client: PoolClient) => Promise<T>): Promise<T>;

package/dist/bone/output/rag/src/db.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transaction = exports.execute = exports.queryOne = exports.query = exports.pool = void 0;
+// Generated by BoneScript compiler. DO NOT EDIT.
+const pg_1 = require("pg");
+// Lazy pool — created on first use so DATABASE_URL is read after dotenv loads
+let _pool = null;
+function getPool() {
+    if (!_pool) {
+        _pool = new pg_1.Pool({ connectionString: process.env.DATABASE_URL || "postgresql://localhost:5432/ragdomain", max: 20 });
+        _pool.on("error", (err) => console.error("[DB] Pool error (non-fatal):", err.message));
+    }
+    return _pool;
+}
+exports.pool = new Proxy({}, { get(_t, p) { return getPool()[p]; } });
+async function query(text, params) {
+    try {
+        const result = await exports.pool.query(text, params);
+        return result.rows;
+    }
+    catch (e) {
+        throw new Error(`DB query failed: ${e.message}`);
+    }
+}
+exports.query = query;
+async function queryOne(text, params) {
+    try {
+        const rows = await query(text, params);
+        return rows[0] || null;
+    }
+    catch (e) {
+        throw new Error(`DB query failed: ${e.message}`);
+    }
+}
+exports.queryOne = queryOne;
+async function execute(text, params) {
+    try {
+        const result = await exports.pool.query(text, params);
+        return result.rowCount || 0;
+    }
+    catch (e) {
+        throw new Error(`DB execute failed: ${e.message}`);
+    }
+}
+exports.execute = execute;
+async function transaction(fn) {
+    const client = await exports.pool.connect();
+    try {
+        await client.query("BEGIN");
+        const result = await fn(client);
+        await client.query("COMMIT");
+        return result;
+    }
+    catch (e) {
+        await client.query("ROLLBACK");
+        throw e;
+    }
+    finally {
+        client.release();
+    }
+}
+exports.transaction = transaction;
+//# sourceMappingURL=db.js.map

package/dist/bone/output/rag/src/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../../../bone/output/rag/src/db.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,2BAAsC;AAEtC,8EAA8E;AAC9E,IAAI,KAAK,GAAgB,IAAI,CAAC;AAC9B,SAAS,OAAO;IACd,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,KAAK,GAAG,IAAI,SAAI,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,uCAAuC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QACrH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AACY,QAAA,IAAI,GAAG,IAAI,KAAK,CAAC,EAAU,EAAE,EAAE,GAAG,CAAC,EAAO,EAAE,CAAM,IAAI,OAAQ,OAAO,EAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE/F,KAAK,UAAU,KAAK,CAAU,IAAY,EAAE,MAAc;IAC/D,IAAI,CAAC;QAAC,MAAM,MAAM,GAAG,MAAM,YAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,MAAM,CAAC,IAAW,CAAC;IAAC,CAAC;IACjF,OAAO,CAAM,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;AACtE,CAAC;AAHD,sBAGC;AACM,KAAK,UAAU,QAAQ,CAAU,IAAY,EAAE,MAAc;IAClE,IAAI,CAAC;QAAC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAI,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAAC,CAAC;IAC1E,OAAO,CAAM,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;AACtE,CAAC;AAHD,4BAGC;AACM,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,MAAc;IACxD,IAAI,CAAC;QAAC,MAAM,MAAM,GAAG,MAAM,YAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IAAC,CAAC;IACnF,OAAO,CAAM,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;AACxE,CAAC;AAHD,0BAGC;AACM,KAAK,UAAU,WAAW,CAAI,EAAsC;IACzE,MAAM,MAAM,GAAG,MAAM,YAAI,CAAC,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAAC,OAAO,MAAM,CAAC;IAAC,CAAC;IAClH,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAAC,MAAM,CAAC,CAAC;IAAC,CAAC;YAC9C,CAAC;QAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AAC/B,CAAC;AALD,kCAKC"}

package/dist/bone/output/rag/src/events.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import { PoolClient } from "pg";
+export type EventDeliveryMode = "in_process" | "durable";
+export interface EventMetadata {
+    source: string;
+    timestamp: Date;
+    correlation_id: string;
+    causation_id: string;
+}
+export interface SystemEvent {
+    type: string;
+    payload: Record<string, unknown>;
+    metadata: EventMetadata;
+}
+type Handler = (event: SystemEvent) => Promise<void>;
+export declare const eventBus: {
+    subscribe(type: string, handler: Handler): void;
+    publish(type: string, payload: Record<string, unknown>, source: string, correlationId?: string, client?: PoolClient): Promise<void>;
+    startWorker(intervalMs?: number): NodeJS.Timeout | null;
+};
+export {};

package/dist/bone/output/rag/src/events.js

@@ -0,0 +1,184 @@
+"use strict";
+// Generated by BoneScript compiler. DO NOT EDIT.
+// Durable event bus with transactional outbox pattern.
+// Set EVENT_MODE=durable in .env to enable.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventBus = void 0;
+const uuid_1 = require("uuid");
+const db_1 = require("./db");
+const logger_1 = require("./logger");
+const metrics_1 = require("./metrics");
+const MODE = process.env.EVENT_MODE || "in_process";
+// Events requiring exactly_once delivery (deduplicated)
+const EXACTLY_ONCE_EVENTS = new Set(["CodebaseIngestionCompleted"]);
+// Events requiring at_least_once delivery (retried until ack)
+const AT_LEAST_ONCE_EVENTS = new Set(["CodebaseIngestionStarted", "FileIndexed", "MemoryStored"]);
+// ─── In-Process Bus ──────────────────────────────────────────────────────────
+class InProcessBus {
+    constructor() {
+        this.handlers = new Map();
+    }
+    subscribe(type, handler) {
+        const existing = this.handlers.get(type) || [];
+        existing.push(handler);
+        this.handlers.set(type, existing);
+    }
+    async publish(type, payload, source, correlationId) {
+        const event = {
+            type,
+            payload,
+            metadata: {
+                source,
+                timestamp: new Date(),
+                correlation_id: correlationId || (0, uuid_1.v4)(),
+                causation_id: (0, uuid_1.v4)(),
+            },
+        };
+        (0, metrics_1.counter)("event.published", { type, mode: "in_process" });
+        const handlers = this.handlers.get(type) || [];
+        for (const handler of handlers) {
+            try {
+                await handler(event);
+                (0, metrics_1.counter)("event.delivered", { type, mode: "in_process" });
+            }
+            catch (e) {
+                (0, metrics_1.counter)("event.delivery_failed", { type, mode: "in_process" });
+                logger_1.logger.error("event_handler_failed", { event: type, metadata: { error: e.message } });
+            }
+        }
+    }
+}
+// ─── Durable Bus (Transactional Outbox) ──────────────────────────────────────
+class DurableBus {
+    constructor() {
+        this.handlers = new Map();
+    }
+    subscribe(type, handler) {
+        const existing = this.handlers.get(type) || [];
+        existing.push(handler);
+        this.handlers.set(type, existing);
+    }
+    // Write event to outbox within the current transaction (or a new one)
+    async publish(type, payload, source, correlationId, client) {
+        const eventId = (0, uuid_1.v4)();
+        const corrId = correlationId || (0, uuid_1.v4)();
+        const sql = `
+      INSERT INTO event_outbox (id, event_type, payload, source, correlation_id)
+      VALUES ($1, $2, $3, $4, $5)
+    `;
+        const params = [eventId, type, JSON.stringify({ ...payload, _event_id: eventId }), source, corrId];
+        if (client) {
+            // Write within caller's transaction — atomicity guaranteed
+            await client.query(sql, params);
+        }
+        else {
+            await db_1.pool.query(sql, params);
+        }
+        (0, metrics_1.counter)("event.outboxed", { type });
+    }
+    // Called by the background worker
+    async flush() {
+        const client = await db_1.pool.connect();
+        try {
+            await client.query("BEGIN");
+            // Fetch pending events (lock rows to prevent concurrent processing)
+            const { rows } = await client.query(`
+        SELECT id, event_type, payload, source, correlation_id, attempts
+        FROM event_outbox
+        WHERE status = 'pending' AND scheduled_at <= NOW()
+        ORDER BY scheduled_at ASC
+        LIMIT 50
+        FOR UPDATE SKIP LOCKED
+      `);
+            for (const row of rows) {
+                try {
+                    // exactly_once: check deduplication table
+                    if (EXACTLY_ONCE_EVENTS.has(row.event_type)) {
+                        const { rows: dup } = await client.query("SELECT 1 FROM event_processed WHERE event_id = $1", [row.payload._event_id || row.id]);
+                        if (dup.length > 0) {
+                            await client.query("UPDATE event_outbox SET status = 'delivered', delivered_at = NOW() WHERE id = $1", [row.id]);
+                            continue;
+                        }
+                    }
+                    const event = {
+                        type: row.event_type,
+                        payload: row.payload,
+                        metadata: {
+                            source: row.source,
+                            timestamp: new Date(),
+                            correlation_id: row.correlation_id,
+                            causation_id: (0, uuid_1.v4)(),
+                        },
+                    };
+                    const handlers = this.handlers.get(row.event_type) || [];
+                    for (const handler of handlers) {
+                        await handler(event);
+                    }
+                    // Mark delivered
+                    await client.query("UPDATE event_outbox SET status = 'delivered', delivered_at = NOW(), attempts = attempts + 1 WHERE id = $1", [row.id]);
+                    // Record for exactly_once deduplication
+                    if (EXACTLY_ONCE_EVENTS.has(row.event_type)) {
+                        await client.query("INSERT INTO event_processed (event_id, event_type) VALUES ($1, $2) ON CONFLICT DO NOTHING", [row.payload._event_id || row.id, row.event_type]);
+                    }
+                    (0, metrics_1.counter)("event.delivered", { type: row.event_type, mode: "durable" });
+                }
+                catch (e) {
+                    const maxAttempts = AT_LEAST_ONCE_EVENTS.has(row.event_type) ? 10 : 3;
+                    const newAttempts = row.attempts + 1;
+                    const status = newAttempts >= maxAttempts ? "dead_letter" : "pending";
+                    const backoffMs = Math.min(1000 * Math.pow(2, newAttempts), 300000);
+                    await client.query(`UPDATE event_outbox
+             SET attempts = $1, last_error = $2, status = $3,
+                 scheduled_at = NOW() + ($4 || ' milliseconds')::interval
+             WHERE id = $5`, [newAttempts, e.message, status, backoffMs, row.id]);
+                    (0, metrics_1.counter)("event.delivery_failed", { type: row.event_type, mode: "durable" });
+                    logger_1.logger.error("event_delivery_failed", { event: row.event_type, metadata: { error: e.message, attempts: newAttempts } });
+                }
+            }
+            await client.query("COMMIT");
+        }
+        catch (e) {
+            await client.query("ROLLBACK");
+            throw e;
+        }
+        finally {
+            client.release();
+        }
+    }
+    // Start background worker
+    startWorker(intervalMs = 1000) {
+        logger_1.logger.info("event_worker_started", { event: "startup", metadata: { interval_ms: intervalMs } });
+        return setInterval(async () => {
+            try {
+                await this.flush();
+            }
+            catch (e) {
+                logger_1.logger.error("event_worker_error", { event: "flush_failed", metadata: { error: e.message } });
+            }
+        }, intervalMs);
+    }
+}
+// ─── Unified Interface ────────────────────────────────────────────────────────
+const inProcess = new InProcessBus();
+const durable = new DurableBus();
+exports.eventBus = {
+    subscribe(type, handler) {
+        inProcess.subscribe(type, handler);
+        durable.subscribe(type, handler);
+    },
+    async publish(type, payload, source, correlationId, client) {
+        if (MODE === "durable") {
+            await durable.publish(type, payload, source, correlationId, client);
+        }
+        else {
+            await inProcess.publish(type, payload, source, correlationId);
+        }
+    },
+    startWorker(intervalMs) {
+        if (MODE === "durable") {
+            return durable.startWorker(intervalMs);
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=events.js.map

package/dist/bone/output/rag/src/events.js.map

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

package/dist/bone/output/rag/src/extensions.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Extension point: embed_text
+ * STABLE: implementation required.
+ */
+export declare function embed_text(text: string, model: string): Promise<number[]>;
+/**
+ * Extension point: embed_batch
+ * STABLE: implementation required.
+ */
+export declare function embed_batch(texts: string[], model: string): Promise<number[][]>;
+/**
+ * Extension point: chunk_file
+ * STABLE: implementation required.
+ */
+export declare function chunk_file(file_path: string, content: string, strategy: string, chunk_size: number, overlap: number): Array<{
+    content: string;
+    start_line: number;
+    end_line: number;
+    chunk_index: number;
+    language?: string;
+    symbol_name?: string;
+    symbol_type?: string;
+}>;
+/**
+ * Extension point: hybrid_search
+ * STABLE: implementation required.
+ */
+export declare function hybrid_search(knowledge_base_id: string, query_embedding: number[], query_text: string, filters: {
+    language?: string;
+    symbol_type?: string;
+    file_path_pattern?: string;
+}, limit: number): Promise<Array<{
+    chunk_id: string;
+    file_path: string;
+    content: string;
+    start_line: number;
+    end_line: number;
+    language?: string;
+    symbol_name?: string;
+    symbol_type?: string;
+    score: number;
+}>>;
+/**
+ * Extension point: scan_directory
+ * STABLE: implementation required.
+ */
+export declare function scan_directory(root_path: string, ignore_patterns: string[]): string[];
+/**
+ * Extension point: detect_language
+ * Optional.
+ */
+export declare function detect_language(file_path: string): string;
+/**
+ * Extension point: bulk_insert_chunks
+ * STABLE: implementation required.
+ * Inserts all chunks for a file in a single parameterized query.
+ * Returns the number of chunks inserted.
+ */
+export declare function bulk_insert_chunks(chunks: Array<{
+    id: string;
+    code_file_id: string;
+    knowledge_base_id: string;
+    project_id: string;
+    content: string;
+    start_line: number;
+    end_line: number;
+    chunk_index: number;
+    language: string;
+    symbol_name?: string;
+    symbol_type?: string;
+    embedding?: number[];
+}>): Promise<number>;
+/**
+ * Extension point: read_file_async
+ * STABLE: implementation required.
+ * Reads a file and returns its content, hash, size, and mtime.
+ */
+export declare function read_file_async(file_path: string): Promise<{
+    content: string;
+    hash: string;
+    size: number;
+    mtime: string;
+} | null>;