@phuetz/code-buddy 0.4.0 → 1.0.0

package/dist/daemon/status-reports.d.ts

@@ -0,0 +1,55 @@
+import type { DaemonStatus } from './daemon-manager.js';
+import type { HeartbeatConfig, HeartbeatStatus } from './heartbeat.js';
+export interface DaemonStatusReport {
+    kind: 'codebuddy_daemon_status';
+    schemaVersion: 1;
+    generatedAt: string;
+    status: {
+        running: boolean;
+        pid: number | null;
+        uptimeMs: number | null;
+        uptimeSeconds: number | null;
+        startedAt: string | null;
+        restartCount: number;
+        services: Array<{
+            name: string;
+            running: boolean;
+            startedAt: string | null;
+            error: string | null;
+        }>;
+    };
+    summary: {
+        serviceCount: number;
+        runningServiceCount: number;
+        stoppedServiceCount: number;
+    };
+    recommendations: string[];
+}
+export interface HeartbeatStatusReport {
+    kind: 'codebuddy_heartbeat_status';
+    schemaVersion: 1;
+    generatedAt: string;
+    status: {
+        running: boolean;
+        enabled: boolean;
+        lastRunTime: string | null;
+        nextRunTime: string | null;
+        consecutiveSuppressions: number;
+        totalTicks: number;
+        totalSuppressions: number;
+        lastResultPreview: string | null;
+        lastResultBytes: number;
+    };
+    config: {
+        intervalMs: number;
+        activeHoursStart: number;
+        activeHoursEnd: number;
+        timezone: string;
+        heartbeatFilePath: string;
+        suppressionKeyword: string;
+        maxConsecutiveSuppressions: number;
+    };
+    recommendations: string[];
+}
+export declare function buildDaemonStatusReport(status: DaemonStatus, generatedAt?: string): DaemonStatusReport;
+export declare function buildHeartbeatStatusReport(status: HeartbeatStatus, config: HeartbeatConfig, generatedAt?: string): HeartbeatStatusReport;

package/dist/daemon/status-reports.js

@@ -0,0 +1,93 @@
+function formatDate(value) {
+    if (!value)
+        return null;
+    const timestamp = value.getTime();
+    return Number.isFinite(timestamp) ? value.toISOString() : null;
+}
+function previewHeartbeatResult(value) {
+    if (!value)
+        return null;
+    return value.length > 200 ? value.slice(0, 200) : value;
+}
+export function buildDaemonStatusReport(status, generatedAt = new Date().toISOString()) {
+    const services = status.services.map((service) => ({
+        name: service.name,
+        running: service.running,
+        startedAt: formatDate(service.startedAt),
+        error: service.error ?? null,
+    }));
+    const runningServiceCount = services.filter((service) => service.running).length;
+    const stoppedServiceCount = services.length - runningServiceCount;
+    const recommendations = [];
+    if (!status.running) {
+        recommendations.push('Start the daemon with `buddy daemon start --detach` before relying on scheduled jobs or background services.');
+    }
+    else if (services.length === 0) {
+        recommendations.push('Daemon is running, but no service health details are currently reported.');
+    }
+    else if (stoppedServiceCount > 0) {
+        recommendations.push('One or more daemon services are stopped; inspect daemon logs for service-level errors.');
+    }
+    return {
+        kind: 'codebuddy_daemon_status',
+        schemaVersion: 1,
+        generatedAt,
+        status: {
+            running: status.running,
+            pid: status.pid ?? null,
+            uptimeMs: status.uptime ?? null,
+            uptimeSeconds: typeof status.uptime === 'number' ? Math.round(status.uptime / 1000) : null,
+            startedAt: formatDate(status.startedAt),
+            restartCount: status.restartCount,
+            services,
+        },
+        summary: {
+            serviceCount: services.length,
+            runningServiceCount,
+            stoppedServiceCount,
+        },
+        recommendations,
+    };
+}
+export function buildHeartbeatStatusReport(status, config, generatedAt = new Date().toISOString()) {
+    const recommendations = [];
+    if (!status.enabled) {
+        recommendations.push('Heartbeat engine is disabled. Run buddy heartbeat start to enable and schedule it.');
+    }
+    else if (!status.running) {
+        recommendations.push('Heartbeat engine is enabled but not running. Run buddy heartbeat start.');
+    }
+    if (status.running && !status.nextRunTime) {
+        recommendations.push('Heartbeat engine is running but no next run is scheduled.');
+    }
+    if (status.consecutiveSuppressions >= Math.max(1, config.maxConsecutiveSuppressions - 1)) {
+        recommendations.push('Consecutive suppressions are near the configured limit.');
+    }
+    return {
+        kind: 'codebuddy_heartbeat_status',
+        schemaVersion: 1,
+        generatedAt,
+        status: {
+            running: status.running,
+            enabled: status.enabled,
+            lastRunTime: formatDate(status.lastRunTime),
+            nextRunTime: formatDate(status.nextRunTime),
+            consecutiveSuppressions: status.consecutiveSuppressions,
+            totalTicks: status.totalTicks,
+            totalSuppressions: status.totalSuppressions,
+            lastResultPreview: previewHeartbeatResult(status.lastResult),
+            lastResultBytes: status.lastResult ? Buffer.byteLength(status.lastResult, 'utf8') : 0,
+        },
+        config: {
+            intervalMs: config.intervalMs,
+            activeHoursStart: config.activeHoursStart,
+            activeHoursEnd: config.activeHoursEnd,
+            timezone: config.timezone,
+            heartbeatFilePath: config.heartbeatFilePath,
+            suppressionKeyword: config.suppressionKeyword,
+            maxConsecutiveSuppressions: config.maxConsecutiveSuppressions,
+        },
+        recommendations,
+    };
+}
+//# sourceMappingURL=status-reports.js.map

package/dist/database/database-manager.js

@@ -7,15 +7,14 @@
 import Database from 'better-sqlite3';
 import * as fs from 'fs';
 import * as path from 'path';
-import * as os from 'os';
 import { SCHEMA_VERSION, MIGRATIONS } from './schema.js';
 import { logger } from '../utils/logger.js';
 import { TypedEventEmitter } from '../events/index.js';
+import { getDatabasePath } from '../utils/codebuddy-home.js';
 // ============================================================================
 // Default Configuration
 // ============================================================================
 const DEFAULT_CONFIG = {
-    dbPath: path.join(os.homedir(), '.codebuddy', 'codebuddy.db'),
     inMemory: false,
     verbose: false,
     walMode: true,
@@ -36,7 +35,7 @@ export class DatabaseManager extends TypedEventEmitter {
     initialized = false;
     constructor(config = {}) {
         super();
-        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.config = { ...DEFAULT_CONFIG, dbPath: getDatabasePath(), ...config };
     }
     /**
      * Emit both typed db:* events and legacy event names for backwards compatibility.
@@ -72,6 +71,18 @@ export class DatabaseManager extends TypedEventEmitter {
             this.db.pragma('synchronous = NORMAL');
             this.db.pragma('cache_size = 10000');
             this.db.pragma('temp_store = MEMORY');
+            // Integrity & concurrency (F29):
+            //   foreign_keys = ON — SQLite ships with FK enforcement OFF by
+            //     default, which silently breaks every `REFERENCES … ON DELETE
+            //     CASCADE` declared in the schema (orphans accumulate when a
+            //     session is removed, etc.). Must be set per connection.
+            //   busy_timeout = 5000 — under WAL, a concurrent writer from the
+            //     same user (two CLI processes, a background sync, a test
+            //     runner fork) can otherwise hit SQLITE_BUSY immediately
+            //     instead of waiting up to 5 s for the current writer to
+            //     commit.
+            this.db.pragma('foreign_keys = ON');
+            this.db.pragma('busy_timeout = 5000');
             // Run migrations
             await this.runMigrations();
             this.initialized = true;

package/dist/database/migration.js

@@ -328,7 +328,7 @@ export class DatabaseMigration extends EventEmitter {
                 for (const session of data.sessions) {
                     try {
                         analyticsRepo.recordAnalytics({
-                            date: session.date || new Date().toISOString().split('T')[0],
+                            date: session.date || new Date().toISOString().slice(0, 10),
                             model: session.model,
                             cost: session.cost,
                             tokens_in: Math.floor(session.tokens * 0.7), // Estimate

package/dist/database/repositories/cache-repository.js

@@ -221,9 +221,13 @@ export class CacheRepository {
         let normA = 0;
         let normB = 0;
         for (let i = 0; i < a.length; i++) {
-            dotProduct += a[i] * b[i];
-            normA += a[i] * a[i];
-            normB += b[i] * b[i];
+            // a.length === b.length is guaranteed above, and i < a.length, so both
+            // indices are in-bounds; ?? 0 only guards the type, never alters values.
+            const ai = a[i] ?? 0;
+            const bi = b[i] ?? 0;
+            dotProduct += ai * bi;
+            normA += ai * ai;
+            normB += bi * bi;
         }
         const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
         return magnitude === 0 ? 0 : dotProduct / magnitude;

package/dist/database/repositories/embedding-repository.js

@@ -4,6 +4,15 @@
  * Repository for code embeddings and semantic search.
  */
 import { getDatabaseManager } from '../database-manager.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Safety cap applied when `find()` is called without an explicit
+ * `limit` by a caller that is about to score every candidate for
+ * cosine similarity (F34). Without this, `searchSimilar()` pulled
+ * the entire embeddings table into JS memory and ran O(N) cosine
+ * on projects with tens of thousands of chunks.
+ */
+const DEFAULT_EMBEDDINGS_LIMIT = 5_000;
 // ============================================================================
 // Embedding Repository
 // ============================================================================
@@ -100,16 +109,24 @@ export class EmbeddingRepository {
             sql += ' AND language = ?';
             params.push(filter.language);
         }
-        sql += ' ORDER BY file_path, chunk_index';
+        // F34: always apply a SQL-level LIMIT so `searchSimilar()` cannot
+        // accidentally load the entire embeddings table into JS memory.
+        // Callers that want to see the full set should page explicitly.
+        sql += ' ORDER BY file_path, chunk_index LIMIT ?';
+        params.push(DEFAULT_EMBEDDINGS_LIMIT);
         const stmt = this.db.prepare(sql);
         const results = stmt.all(...params);
+        if (results.length === DEFAULT_EMBEDDINGS_LIMIT) {
+            logger.warn(`[embedding-repository] find() hit the default cap of ${DEFAULT_EMBEDDINGS_LIMIT} candidates. ` +
+                `Narrow the filter (projectId, filePath) or paginate to avoid missing matches.`);
+        }
         return results.map(r => this.deserializeEmbedding(r));
     }
     /**
      * Search embeddings by semantic similarity
      */
     searchSimilar(queryEmbedding, filter = {}, topK = 10) {
-        // Get all candidates matching filter
+        // Get candidates matching filter (now always capped by find() — F34)
         const candidates = this.find(filter);
         // Calculate cosine similarity for each
         const results = [];
@@ -246,9 +263,11 @@ export class EmbeddingRepository {
         let normA = 0;
         let normB = 0;
         for (let i = 0; i < a.length; i++) {
-            dotProduct += a[i] * b[i];
-            normA += a[i] * a[i];
-            normB += b[i] * b[i];
+            const ai = a[i] ?? 0;
+            const bi = b[i] ?? 0;
+            dotProduct += ai * bi;
+            normA += ai * ai;
+            normB += bi * bi;
         }
         const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
         return magnitude === 0 ? 0 : dotProduct / magnitude;

package/dist/database/repositories/memory-repository.js

@@ -231,9 +231,11 @@ export class MemoryRepository {
         let normA = 0;
         let normB = 0;
         for (let i = 0; i < a.length; i++) {
-            dotProduct += a[i] * b[i];
-            normA += a[i] * a[i];
-            normB += b[i] * b[i];
+            const ai = a[i] ?? 0;
+            const bi = b[i] ?? 0;
+            dotProduct += ai * bi;
+            normA += ai * ai;
+            normB += bi * bi;
         }
         const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
         return magnitude === 0 ? 0 : dotProduct / magnitude;

package/dist/database/repositories/session-repository.d.ts

@@ -17,6 +17,18 @@ export interface SessionFilter {
 export interface SessionWithMessages extends Session {
     messages: Message[];
 }
+export interface SessionSearchOptions {
+    projectId?: string;
+    includeArchived?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface SessionSearchResult {
+    session: Session;
+    message: Message;
+    snippet: string;
+    score: number;
+}
 export declare class SessionRepository {
     private db;
     constructor(db?: Database.Database);
@@ -58,13 +70,26 @@ export declare class SessionRepository {
      */
     addMessage(message: Omit<Message, 'id' | 'created_at'>): Message;
     /**
-     * Get messages for session
+     * Get messages for session.
+     *
+     * Applies a `DEFAULT_MESSAGES_LIMIT` cap when the caller omits `limit`
+     * so an accidentally huge session cannot OOM the process (F34).
+     * Logs a warning the first time the cap is hit so the caller knows
+     * it needs to paginate.
      */
     getMessages(sessionId: string, limit?: number): Message[];
     /**
      * Get recent messages (for context window)
      */
     getRecentMessages(sessionId: string, limit?: number): Message[];
+    /**
+     * Search session messages through the SQLite FTS5 index.
+     *
+     * This is the Hermes-inspired durable search path: query the database
+     * instead of scanning every JSON session file in Node memory.
+     */
+    searchMessages(query: string, options?: SessionSearchOptions): SessionSearchResult[];
+    private buildLocalSnippet;
     /**
      * Delete messages from session
      */
@@ -91,6 +116,7 @@ export declare class SessionRepository {
     }[];
     private deserializeSession;
     private deserializeMessage;
+    private buildFtsQuery;
 }
 export declare function getSessionRepository(): SessionRepository;
 export declare function resetSessionRepository(): void;

package/dist/database/repositories/session-repository.js

@@ -4,6 +4,16 @@
  * Repository for session and message storage.
  */
 import { getDatabaseManager } from '../database-manager.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Safety cap applied when callers of `getMessages()` do not provide an
+ * explicit limit (F34). Sessions with hundreds of thousands of messages
+ * would otherwise load the whole history into Node memory and OOM. The
+ * cap is large enough to cover any realistic session but small enough
+ * to survive a corrupted row count. Callers that genuinely need more
+ * should paginate explicitly.
+ */
+const DEFAULT_MESSAGES_LIMIT = 10_000;
 // ============================================================================
 // Session Repository
 // ============================================================================
@@ -20,11 +30,11 @@ export class SessionRepository {
      */
     createSession(session) {
         const stmt = this.db.prepare(`
-      INSERT INTO sessions (id, project_id, project_path, name, model, metadata)
-      VALUES (?, ?, ?, ?, ?, ?)
+      INSERT INTO sessions (id, parent_session_id, project_id, project_path, name, model, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
       RETURNING *
     `);
-        const result = stmt.get(session.id, session.project_id || null, session.project_path || null, session.name || null, session.model || null, session.metadata ? JSON.stringify(session.metadata) : null);
+        const result = stmt.get(session.id, session.parent_session_id || null, session.project_id || null, session.project_path || null, session.name || null, session.model || null, session.metadata ? JSON.stringify(session.metadata) : null);
         return this.deserializeSession(result);
     }
     /**
@@ -144,17 +154,25 @@ export class SessionRepository {
         return this.deserializeMessage(result);
     }
     /**
-     * Get messages for session
+     * Get messages for session.
+     *
+     * Applies a `DEFAULT_MESSAGES_LIMIT` cap when the caller omits `limit`
+     * so an accidentally huge session cannot OOM the process (F34).
+     * Logs a warning the first time the cap is hit so the caller knows
+     * it needs to paginate.
      */
     getMessages(sessionId, limit) {
-        let sql = 'SELECT * FROM messages WHERE session_id = ? ORDER BY id ASC';
-        const params = [sessionId];
-        if (limit) {
-            sql += ' LIMIT ?';
-            params.push(limit);
-        }
+        const effectiveLimit = typeof limit === 'number' && limit > 0
+            ? limit
+            : DEFAULT_MESSAGES_LIMIT;
+        const sql = 'SELECT * FROM messages WHERE session_id = ? ORDER BY id ASC LIMIT ?';
+        const params = [sessionId, effectiveLimit];
         const stmt = this.db.prepare(sql);
         const results = stmt.all(...params);
+        if (results.length === effectiveLimit && limit === undefined) {
+            logger.warn(`[session-repository] getMessages() hit the default cap of ${DEFAULT_MESSAGES_LIMIT} for session ${sessionId}. ` +
+                `Pass an explicit limit or paginate with getRecentMessages().`);
+        }
         return results.map(r => this.deserializeMessage(r));
     }
     /**
@@ -169,6 +187,183 @@ export class SessionRepository {
         const results = stmt.all(sessionId, limit);
         return results.map(r => this.deserializeMessage(r));
     }
+    /**
+     * Search session messages through the SQLite FTS5 index.
+     *
+     * This is the Hermes-inspired durable search path: query the database
+     * instead of scanning every JSON session file in Node memory.
+     */
+    searchMessages(query, options = {}) {
+        const allTokens = query
+            .trim()
+            .match(/[\p{L}\p{N}_@./:-]+/gu)
+            ?.filter(Boolean) || [];
+        if (allTokens.length === 0) {
+            return [];
+        }
+        const longTokens = allTokens.filter(token => {
+            const isCjk = /[\u4e00-\u9fa5\u3040-\u309f\u30a0-\u30ff\u3400-\u4dbf\u1100-\u11ff\u3130-\u318f\uac00-\ud7af]/u.test(token);
+            return token.length >= 3 || (isCjk && token.length >= 3);
+        });
+        const shortTokens = allTokens.filter(token => {
+            const isCjk = /[\u4e00-\u9fa5\u3040-\u309f\u30a0-\u30ff\u3400-\u4dbf\u1100-\u11ff\u3130-\u318f\uac00-\ud7af]/u.test(token);
+            return token.length < 3 || (isCjk && token.length < 3);
+        });
+        const limit = Math.min(Math.max(options.limit ?? 20, 1), 100);
+        const offset = Math.max(options.offset ?? 0, 0);
+        const params = [];
+        let sql = '';
+        if (longTokens.length > 0) {
+            const ftsQuery = longTokens
+                .map(token => `"${token.replace(/"/g, '""')}"`)
+                .join(' AND ');
+            sql = `
+        SELECT
+          s.id AS session_id,
+          s.parent_session_id AS session_parent_session_id,
+          s.project_id AS session_project_id,
+          s.project_path AS session_project_path,
+          s.name AS session_name,
+          s.model AS session_model,
+          s.created_at AS session_created_at,
+          s.updated_at AS session_updated_at,
+          s.total_tokens_in AS session_total_tokens_in,
+          s.total_tokens_out AS session_total_tokens_out,
+          s.total_cost AS session_total_cost,
+          s.message_count AS session_message_count,
+          s.tool_calls_count AS session_tool_calls_count,
+          s.is_archived AS session_is_archived,
+          s.metadata AS session_metadata,
+          m.id AS message_id,
+          m.session_id AS message_session_id,
+          m.role AS message_role,
+          m.content AS message_content,
+          m.tool_calls AS message_tool_calls,
+          m.tool_call_id AS message_tool_call_id,
+          m.tokens AS message_tokens,
+          m.created_at AS message_created_at,
+          m.metadata AS message_metadata,
+          snippet(messages_fts, 0, '<mark>', '</mark>', '...', 18) AS snippet,
+          bm25(messages_fts) AS score
+        FROM messages_fts
+        JOIN messages m ON m.id = messages_fts.rowid
+        JOIN sessions s ON s.id = m.session_id
+        WHERE messages_fts MATCH ?
+      `;
+            params.push(ftsQuery);
+        }
+        else {
+            sql = `
+        SELECT
+          s.id AS session_id,
+          s.parent_session_id AS session_parent_session_id,
+          s.project_id AS session_project_id,
+          s.project_path AS session_project_path,
+          s.name AS session_name,
+          s.model AS session_model,
+          s.created_at AS session_created_at,
+          s.updated_at AS session_updated_at,
+          s.total_tokens_in AS session_total_tokens_in,
+          s.total_tokens_out AS session_total_tokens_out,
+          s.total_cost AS session_total_cost,
+          s.message_count AS session_message_count,
+          s.tool_calls_count AS session_tool_calls_count,
+          s.is_archived AS session_is_archived,
+          s.metadata AS session_metadata,
+          m.id AS message_id,
+          m.session_id AS message_session_id,
+          m.role AS message_role,
+          m.content AS message_content,
+          m.tool_calls AS message_tool_calls,
+          m.tool_call_id AS message_tool_call_id,
+          m.tokens AS message_tokens,
+          m.created_at AS message_created_at,
+          m.metadata AS message_metadata,
+          NULL AS snippet,
+          0.0 AS score
+        FROM messages m
+        JOIN sessions s ON s.id = m.session_id
+        WHERE 1=1
+      `;
+        }
+        for (const token of shortTokens) {
+            sql += ' AND m.content LIKE ?';
+            params.push(`%${token}%`);
+        }
+        if (options.projectId) {
+            sql += ' AND s.project_id = ?';
+            params.push(options.projectId);
+        }
+        if (!options.includeArchived) {
+            sql += ' AND s.is_archived = 0';
+        }
+        if (longTokens.length > 0) {
+            sql += ' ORDER BY score ASC, m.id DESC LIMIT ? OFFSET ?';
+        }
+        else {
+            sql += ' ORDER BY m.id DESC LIMIT ? OFFSET ?';
+        }
+        params.push(limit, offset);
+        const stmt = this.db.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map(row => {
+            const sessionRow = {
+                id: row.session_id,
+                parent_session_id: row.session_parent_session_id ?? undefined,
+                project_id: row.session_project_id ?? undefined,
+                project_path: row.session_project_path ?? undefined,
+                name: row.session_name ?? undefined,
+                model: row.session_model ?? undefined,
+                created_at: row.session_created_at,
+                updated_at: row.session_updated_at,
+                total_tokens_in: row.session_total_tokens_in,
+                total_tokens_out: row.session_total_tokens_out,
+                total_cost: row.session_total_cost,
+                message_count: row.session_message_count,
+                tool_calls_count: row.session_tool_calls_count,
+                is_archived: Boolean(row.session_is_archived),
+                metadata: row.session_metadata,
+            };
+            const messageRow = {
+                id: row.message_id,
+                session_id: row.message_session_id,
+                role: row.message_role,
+                content: row.message_content ?? undefined,
+                tool_calls: row.message_tool_calls,
+                tool_call_id: row.message_tool_call_id ?? undefined,
+                tokens: row.message_tokens,
+                created_at: row.message_created_at,
+                metadata: row.message_metadata,
+            };
+            let snippet = row.snippet;
+            if (!snippet && row.message_content) {
+                snippet = this.buildLocalSnippet(row.message_content, allTokens);
+            }
+            return {
+                session: this.deserializeSession(sessionRow),
+                message: this.deserializeMessage(messageRow),
+                snippet: snippet ?? row.message_content ?? '',
+                score: row.score,
+            };
+        });
+    }
+    buildLocalSnippet(text, terms, maxLength = 180) {
+        const compact = text.replace(/\s+/g, ' ').trim();
+        if (compact.length <= maxLength) {
+            return compact;
+        }
+        const lower = compact.toLowerCase();
+        const indexes = terms
+            .map((term) => lower.indexOf(term.toLowerCase()))
+            .filter((index) => index >= 0);
+        const first = indexes.length > 0 ? Math.min(...indexes) : 0;
+        const start = Math.max(0, first - 50);
+        const end = Math.min(compact.length, start + maxLength);
+        const snippet = compact.slice(start, end);
+        const prefix = start > 0 ? '...' : '';
+        const suffix = end < compact.length ? '...' : '';
+        return prefix + snippet + suffix;
+    }
     /**
      * Delete messages from session
      */
@@ -278,6 +473,18 @@ export class SessionRepository {
             metadata,
         };
     }
+    buildFtsQuery(query) {
+        const tokens = query
+            .trim()
+            .match(/[\p{L}\p{N}_@./:-]+/gu)
+            ?.slice(0, 32);
+        if (!tokens?.length) {
+            return null;
+        }
+        return tokens
+            .map(token => `"${token.replace(/"/g, '""')}"`)
+            .join(' AND ');
+    }
 }
 // ============================================================================
 // Singleton Instance

package/dist/database/schema.d.ts

@@ -8,7 +8,7 @@
  * - Tool statistics and learning
  * - Analytics and cost tracking
  */
-export declare const SCHEMA_VERSION = 1;
+export declare const SCHEMA_VERSION = 3;
 export declare const SCHEMA_SQL = "\n-- Schema version tracking\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER PRIMARY KEY,\n  applied_at TEXT DEFAULT CURRENT_TIMESTAMP\n);\n\n-- ============================================================================\n-- MEMORIES TABLE\n-- Stores persistent memories with embeddings for semantic search\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS memories (\n  id TEXT PRIMARY KEY,\n  type TEXT NOT NULL CHECK(type IN ('fact', 'preference', 'pattern', 'decision', 'context', 'summary', 'instruction', 'error', 'definition', 'convention')),\n  scope TEXT NOT NULL CHECK(scope IN ('user', 'project')),\n  project_id TEXT,\n  content TEXT NOT NULL,\n  embedding BLOB,  -- Float32Array as binary\n  importance REAL DEFAULT 0.5 CHECK(importance >= 0 AND importance <= 1),\n  access_count INTEGER DEFAULT 0,\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  last_accessed TEXT DEFAULT CURRENT_TIMESTAMP,\n  expires_at TEXT,\n  metadata TEXT,  -- JSON for additional data\n  UNIQUE(scope, project_id, content)\n);\n\nCREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);\nCREATE INDEX IF NOT EXISTS idx_memories_scope ON memories(scope, project_id);\nCREATE INDEX IF NOT EXISTS idx_memories_importance ON memories(importance DESC);\nCREATE INDEX IF NOT EXISTS idx_memories_last_accessed ON memories(last_accessed DESC);\n\n-- ============================================================================\n-- SESSIONS TABLE\n-- Stores conversation sessions with full history\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS sessions (\n  id TEXT PRIMARY KEY,\n  project_id TEXT,\n  project_path TEXT,\n  name TEXT,\n  model TEXT,\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  updated_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  total_tokens_in INTEGER DEFAULT 0,\n  total_tokens_out INTEGER DEFAULT 0,\n  total_cost REAL DEFAULT 0,\n  message_count INTEGER DEFAULT 0,\n  tool_calls_count INTEGER DEFAULT 0,\n  is_archived INTEGER DEFAULT 0,\n  metadata TEXT  -- JSON\n);\n\nCREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_id);\nCREATE INDEX IF NOT EXISTS idx_sessions_updated ON sessions(updated_at DESC);\n\n-- ============================================================================\n-- MESSAGES TABLE\n-- Individual messages within sessions\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS messages (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,\n  role TEXT NOT NULL CHECK(role IN ('user', 'assistant', 'system', 'tool')),\n  content TEXT,\n  tool_calls TEXT,  -- JSON array of tool calls\n  tool_call_id TEXT,\n  tokens INTEGER DEFAULT 0,\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  metadata TEXT  -- JSON\n);\n\nCREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id);\n\n-- ============================================================================\n-- CODE EMBEDDINGS TABLE\n-- Vector embeddings for code chunks\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS code_embeddings (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id TEXT NOT NULL,\n  file_path TEXT NOT NULL,\n  chunk_index INTEGER NOT NULL,\n  chunk_text TEXT NOT NULL,\n  chunk_hash TEXT NOT NULL,\n  embedding BLOB NOT NULL,  -- Float32Array as binary\n  symbol_type TEXT,  -- function, class, interface, etc.\n  symbol_name TEXT,\n  start_line INTEGER,\n  end_line INTEGER,\n  language TEXT,\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  updated_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  UNIQUE(project_id, file_path, chunk_index)\n);\n\nCREATE INDEX IF NOT EXISTS idx_code_embeddings_project ON code_embeddings(project_id);\nCREATE INDEX IF NOT EXISTS idx_code_embeddings_file ON code_embeddings(project_id, file_path);\nCREATE INDEX IF NOT EXISTS idx_code_embeddings_symbol ON code_embeddings(symbol_type, symbol_name);\n\n-- ============================================================================\n-- TOOL STATISTICS TABLE\n-- Tracks tool usage, success rates, and performance\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS tool_stats (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  tool_name TEXT NOT NULL,\n  project_id TEXT,\n  success_count INTEGER DEFAULT 0,\n  failure_count INTEGER DEFAULT 0,\n  total_time_ms INTEGER DEFAULT 0,\n  avg_time_ms REAL GENERATED ALWAYS AS (\n    CASE WHEN (success_count + failure_count) > 0\n    THEN total_time_ms * 1.0 / (success_count + failure_count)\n    ELSE 0 END\n  ) STORED,\n  cache_hits INTEGER DEFAULT 0,\n  cache_misses INTEGER DEFAULT 0,\n  last_used TEXT DEFAULT CURRENT_TIMESTAMP,\n  updated_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  UNIQUE(tool_name, project_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_tool_stats_name ON tool_stats(tool_name);\n\n-- ============================================================================\n-- REPAIR LEARNING TABLE\n-- Stores what repair strategies work for which error patterns\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS repair_learning (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  error_pattern TEXT NOT NULL,  -- Normalized error message pattern\n  error_type TEXT NOT NULL CHECK(error_type IN ('compile', 'runtime', 'test', 'lint', 'type')),\n  strategy TEXT NOT NULL,\n  context_hash TEXT,  -- Hash of surrounding code context\n  language TEXT,\n  framework TEXT,\n  success_count INTEGER DEFAULT 0,\n  failure_count INTEGER DEFAULT 0,\n  success_rate REAL GENERATED ALWAYS AS (\n    CASE WHEN (success_count + failure_count) > 0\n    THEN success_count * 1.0 / (success_count + failure_count)\n    ELSE 0 END\n  ) STORED,\n  avg_attempts REAL DEFAULT 1,\n  last_used TEXT DEFAULT CURRENT_TIMESTAMP,\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  examples TEXT,  -- JSON array of successful fix examples\n  UNIQUE(error_pattern, strategy, context_hash)\n);\n\nCREATE INDEX IF NOT EXISTS idx_repair_learning_pattern ON repair_learning(error_pattern);\nCREATE INDEX IF NOT EXISTS idx_repair_learning_success ON repair_learning(success_rate DESC);\n\n-- ============================================================================\n-- ANALYTICS TABLE\n-- Daily aggregated usage statistics\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS analytics (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  date TEXT NOT NULL,\n  project_id TEXT,\n  model TEXT,\n  tokens_in INTEGER DEFAULT 0,\n  tokens_out INTEGER DEFAULT 0,\n  cost REAL DEFAULT 0,\n  requests INTEGER DEFAULT 0,\n  tool_calls INTEGER DEFAULT 0,\n  errors INTEGER DEFAULT 0,\n  avg_response_time_ms REAL DEFAULT 0,\n  cache_hit_rate REAL DEFAULT 0,\n  session_count INTEGER DEFAULT 0,\n  UNIQUE(date, project_id, model)\n);\n\nCREATE INDEX IF NOT EXISTS idx_analytics_date ON analytics(date DESC);\nCREATE INDEX IF NOT EXISTS idx_analytics_project ON analytics(project_id, date DESC);\n\n-- ============================================================================\n-- CONVENTIONS TABLE\n-- Learned coding conventions per project\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS conventions (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id TEXT NOT NULL,\n  category TEXT NOT NULL,  -- naming, structure, style, testing, docs\n  pattern TEXT NOT NULL,\n  description TEXT,\n  confidence REAL DEFAULT 0.5 CHECK(confidence >= 0 AND confidence <= 1),\n  occurrences INTEGER DEFAULT 1,\n  examples TEXT,  -- JSON array of examples\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  updated_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  UNIQUE(project_id, category, pattern)\n);\n\nCREATE INDEX IF NOT EXISTS idx_conventions_project ON conventions(project_id);\nCREATE INDEX IF NOT EXISTS idx_conventions_confidence ON conventions(confidence DESC);\n\n-- ============================================================================\n-- CHECKPOINTS TABLE\n-- File checkpoints for undo/restore\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS checkpoints (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL,\n  description TEXT,\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  file_count INTEGER DEFAULT 0,\n  total_size INTEGER DEFAULT 0,\n  metadata TEXT  -- JSON\n);\n\nCREATE INDEX IF NOT EXISTS idx_checkpoints_project ON checkpoints(project_id, created_at DESC);\n\n-- ============================================================================\n-- CHECKPOINT FILES TABLE\n-- Individual file snapshots\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS checkpoint_files (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  checkpoint_id TEXT NOT NULL REFERENCES checkpoints(id) ON DELETE CASCADE,\n  file_path TEXT NOT NULL,\n  content TEXT,\n  content_hash TEXT,\n  existed INTEGER DEFAULT 1,\n  UNIQUE(checkpoint_id, file_path)\n);\n\nCREATE INDEX IF NOT EXISTS idx_checkpoint_files_checkpoint ON checkpoint_files(checkpoint_id);\n\n-- ============================================================================\n-- CACHE TABLE\n-- General-purpose cache with TTL\n-- ============================================================================\nCREATE TABLE IF NOT EXISTS cache (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  embedding BLOB,  -- Optional embedding for semantic cache\n  created_at TEXT DEFAULT CURRENT_TIMESTAMP,\n  expires_at TEXT,\n  hits INTEGER DEFAULT 0,\n  category TEXT  -- api, tool, search, etc.\n);\n\nCREATE INDEX IF NOT EXISTS idx_cache_expires ON cache(expires_at);\nCREATE INDEX IF NOT EXISTS idx_cache_category ON cache(category);\n";
 export declare const MIGRATIONS: Record<number, string>;
 export interface Memory {
@@ -28,6 +28,7 @@ export interface Memory {
 export type MemoryType = 'fact' | 'preference' | 'pattern' | 'decision' | 'context' | 'summary' | 'instruction' | 'error' | 'definition' | 'convention';
 export interface Session {
     id: string;
+    parent_session_id?: string;
     project_id?: string;
     project_path?: string;
     name?: string;