@massa-ai/core 1.2.1

package/dist/services/search/search-cache-pg.js

@@ -0,0 +1,315 @@
+/**
+ * Search Result Cache - PostgreSQL Implementation
+ *
+ * Two-level cache for search results using PostgreSQL.
+ */
+import { logger } from "@massa-ai/shared";
+import crypto from "crypto";
+import { getPgPool } from "../../data/db-connection.js";
+import { installGuardOnTable } from "../project-identity/identity-guard-installer.js";
+export class SearchCachePg {
+    pool = null;
+    l1Cache = new Map();
+    stats = {
+        l1Hits: 0,
+        l1Misses: 0,
+        l2Hits: 0,
+        l2Misses: 0,
+        totalHits: 0,
+        totalMisses: 0,
+        hitRate: 0,
+    };
+    L1_MAX_SIZE = 100;
+    L2_MAX_SIZE = 10000;
+    DEFAULT_TTL = 3600;
+    constructor() { }
+    async getPool() {
+        if (!this.pool) {
+            this.pool = await getPgPool();
+            await this.initTable();
+        }
+        return this.pool;
+    }
+    async initTable() {
+        const pool = await this.getPool();
+        await pool.query(`
+      CREATE TABLE IF NOT EXISTS search_cache (
+        key TEXT PRIMARY KEY,
+        query TEXT NOT NULL,
+        project_id TEXT NOT NULL,
+        results JSONB NOT NULL,
+        options JSONB DEFAULT '{}',
+        created_at TIMESTAMPTZ DEFAULT NOW(),
+        expires_at TIMESTAMPTZ DEFAULT NOW() + INTERVAL '1 hour',
+        access_count INT DEFAULT 1,
+        last_accessed TIMESTAMPTZ DEFAULT NOW()
+      );
+      
+      CREATE INDEX IF NOT EXISTS idx_search_cache_project ON search_cache(project_id);
+      CREATE INDEX IF NOT EXISTS idx_search_cache_expires ON search_cache(expires_at);
+    `);
+        // Project-identity guard on this runtime-created table (design req:
+        // guards install during initialization, not only at startup). Best-effort.
+        const guardCode = await installGuardOnTable(pool, "public", "search_cache", "project_id");
+        if (guardCode) {
+            logger.warn("[project-identity] guard install failed (sanitized)", {
+                table: "search_cache",
+                code: guardCode,
+            });
+        }
+    }
+    generateKey(query, projectId, options) {
+        const payload = JSON.stringify({
+            query: query.toLowerCase().trim(),
+            projectId,
+            options: this.normalizeOptions(options),
+        });
+        return crypto.createHash("sha256").update(payload).digest("hex");
+    }
+    normalizeOptions(options) {
+        const searchAffectingParams = [
+            "maxResults",
+            "minScore",
+            "explainScores",
+            "includeFilters",
+            "excludeFilters",
+            "retrievalWindow",
+            "include",
+            "exclude",
+        ];
+        const normalized = {};
+        for (const key of searchAffectingParams) {
+            if (options[key] !== undefined) {
+                normalized[key] = options[key];
+            }
+        }
+        return normalized;
+    }
+    async get(query, projectId, options = {}) {
+        const key = this.generateKey(query, projectId, options);
+        const l1Entry = this.l1Cache.get(key);
+        if (l1Entry) {
+            const age = Date.now() - l1Entry.createdAt;
+            if (age < this.DEFAULT_TTL * 1000) {
+                this.stats.l1Hits++;
+                this.stats.totalHits++;
+                l1Entry.accessCount++;
+                l1Entry.lastAccessed = Date.now();
+                return l1Entry.results;
+            }
+            else {
+                this.l1Cache.delete(key);
+            }
+        }
+        this.stats.l1Misses++;
+        const pool = await this.getPool();
+        const { rows } = await pool.query(`SELECT * FROM search_cache 
+       WHERE key = $1 AND expires_at > NOW()`, [key]);
+        if (rows.length > 0) {
+            const row = rows[0];
+            const entry = {
+                key: row.key,
+                query: row.query,
+                projectId: row.project_id,
+                results: row.results,
+                options: row.options,
+                createdAt: new Date(row.created_at).getTime(),
+                accessCount: row.access_count,
+                lastAccessed: new Date(row.last_accessed).getTime(),
+            };
+            await pool.query(`UPDATE search_cache 
+         SET access_count = access_count + 1, last_accessed = NOW()
+         WHERE key = $1`, [key]);
+            this.stats.l2Hits++;
+            this.stats.totalHits++;
+            this.l1Cache.set(key, entry);
+            this.evictL1IfNeeded();
+            return entry.results;
+        }
+        this.stats.l2Misses++;
+        this.stats.totalMisses++;
+        return null;
+    }
+    async set(query, projectId, results, options = {}) {
+        const key = this.generateKey(query, projectId, options);
+        const now = Date.now();
+        const entry = {
+            key,
+            query,
+            projectId,
+            results,
+            options: JSON.stringify(options),
+            createdAt: now,
+            accessCount: 1,
+            lastAccessed: now,
+        };
+        const pool = await this.getPool();
+        await pool.query(`INSERT INTO search_cache (key, query, project_id, results, options)
+       VALUES ($1, $2, $3, $4, $5)
+       ON CONFLICT (key) DO UPDATE SET
+         results = EXCLUDED.results,
+         options = EXCLUDED.options,
+         expires_at = NOW() + INTERVAL '1 hour'`, [key, query, projectId, JSON.stringify(results), JSON.stringify(options)]);
+        await this.evictL2IfNeeded();
+        this.l1Cache.set(key, entry);
+        this.evictL1IfNeeded();
+    }
+    async invalidateProject(projectId) {
+        let count = 0;
+        for (const [key, entry] of this.l1Cache.entries()) {
+            if (entry.projectId === projectId) {
+                this.l1Cache.delete(key);
+                count++;
+            }
+        }
+        const pool = await this.getPool();
+        const result = await pool.query(`DELETE FROM search_cache WHERE project_id = $1`, [projectId]);
+        count += result.rowCount || 0;
+        logger.info("Invalidated cache for project", { projectId, entriesRemoved: count });
+        return count;
+    }
+    async invalidateByFiles(projectId, filePaths) {
+        if (!filePaths || filePaths.length === 0) {
+            return {
+                entriesInvalidated: 0,
+                entriesPreserved: 0,
+                affectedQueries: [],
+            };
+        }
+        const affectedQueries = new Set();
+        let entriesInvalidated = 0;
+        let entriesPreserved = 0;
+        for (const [key, entry] of this.l1Cache.entries()) {
+            if (entry.projectId !== projectId)
+                continue;
+            const hasAffectedFile = entry.results.some((result) => {
+                const resultPath = result.metadata?.filePath;
+                return filePaths.some((modifiedPath) => resultPath && resultPath.includes(modifiedPath));
+            });
+            if (hasAffectedFile) {
+                this.l1Cache.delete(key);
+                affectedQueries.add(entry.query);
+                entriesInvalidated++;
+            }
+            else {
+                entriesPreserved++;
+            }
+        }
+        const pool = await this.getPool();
+        const { rows } = await pool.query(`SELECT key, query, results FROM search_cache WHERE project_id = $1`, [projectId]);
+        const keysToDelete = [];
+        for (const row of rows) {
+            try {
+                const results = row.results;
+                const hasAffectedFile = results.some((result) => {
+                    const resultPath = result.metadata?.filePath;
+                    return filePaths.some((modifiedPath) => resultPath && resultPath.includes(modifiedPath));
+                });
+                if (hasAffectedFile) {
+                    keysToDelete.push(row.key);
+                    affectedQueries.add(row.query);
+                }
+                else {
+                    entriesPreserved++;
+                }
+            }
+            catch {
+                keysToDelete.push(row.key);
+            }
+        }
+        if (keysToDelete.length > 0) {
+            await pool.query(`DELETE FROM search_cache WHERE key = ANY($1)`, [keysToDelete]);
+            entriesInvalidated += keysToDelete.length;
+        }
+        logger.info("File-based cache invalidation completed", {
+            projectId,
+            filesModified: filePaths.length,
+            entriesInvalidated,
+            entriesPreserved,
+        });
+        return {
+            entriesInvalidated,
+            entriesPreserved,
+            affectedQueries: Array.from(affectedQueries),
+        };
+    }
+    async clear() {
+        this.l1Cache.clear();
+        const pool = await this.getPool();
+        await pool.query("DELETE FROM search_cache");
+        this.stats = {
+            l1Hits: 0,
+            l1Misses: 0,
+            l2Hits: 0,
+            l2Misses: 0,
+            totalHits: 0,
+            totalMisses: 0,
+            hitRate: 0,
+        };
+        logger.info("Cache cleared");
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    getL1Size() {
+        return this.l1Cache.size;
+    }
+    async getL2Size() {
+        const pool = await this.getPool();
+        const { rows } = await pool.query("SELECT COUNT(*) as count FROM search_cache");
+        return parseInt(rows[0]?.count || '0');
+    }
+    async cleanup() {
+        const now = Date.now();
+        const ttlMs = this.DEFAULT_TTL * 1000;
+        let l1Removed = 0;
+        let l2Removed = 0;
+        for (const [key, entry] of this.l1Cache.entries()) {
+            if (now - entry.createdAt > ttlMs) {
+                this.l1Cache.delete(key);
+                l1Removed++;
+            }
+        }
+        const pool = await this.getPool();
+        const result = await pool.query(`DELETE FROM search_cache WHERE expires_at < NOW()`);
+        l2Removed = result.rowCount || 0;
+        logger.info("Cache cleanup completed", { l1Removed, l2Removed });
+        return { l1Removed, l2Removed };
+    }
+    evictL1IfNeeded() {
+        if (this.l1Cache.size <= this.L1_MAX_SIZE)
+            return;
+        let oldestKey = null;
+        let oldestTime = Date.now();
+        for (const [key, entry] of this.l1Cache.entries()) {
+            if (entry.lastAccessed < oldestTime) {
+                oldestTime = entry.lastAccessed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.l1Cache.delete(oldestKey);
+        }
+    }
+    async evictL2IfNeeded() {
+        const currentSize = await this.getL2Size();
+        if (currentSize <= this.L2_MAX_SIZE)
+            return;
+        const toRemove = currentSize - this.L2_MAX_SIZE;
+        const pool = await this.getPool();
+        await pool.query(`DELETE FROM search_cache
+       WHERE key IN (
+         SELECT key FROM search_cache 
+         ORDER BY last_accessed ASC 
+         LIMIT $1
+       )`, [toRemove]);
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+        logger.info("SearchCachePg closed");
+    }
+}
+//# sourceMappingURL=search-cache-pg.js.map

package/dist/services/search/search-cache-pg.js.map

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

package/dist/services/search/search-diagnostics.d.ts

@@ -0,0 +1,39 @@
+export type SearchFailureCode = "SEARCH_BACKEND_UNAVAILABLE" | "STORE_CORRUPTION";
+export type SearchDegradationCode = "QUERY_UNDERSTANDING_UNAVAILABLE" | "TRIGRAM_UNAVAILABLE" | "FUZZY_SEARCH_UNAVAILABLE" | "PROXIMITY_RERANK_UNAVAILABLE" | "GRAPH_AUGMENTATION_UNAVAILABLE" | "SYNAPSE_UNAVAILABLE" | "SEARCH_AUDIT_UNAVAILABLE" | "SEARCH_ANALYTICS_UNAVAILABLE";
+export interface SearchDegradation {
+    code: SearchDegradationCode;
+    component: string;
+    message: string;
+}
+export type SearchDegradationReporter = (code: SearchDegradationCode, component: string) => void;
+export interface SearchDegradationDiagnostic extends SearchDegradation {
+    kind: "degradation";
+    projectId: string;
+    timestamp: string;
+}
+export interface SearchFailureDiagnostic {
+    kind: "failure";
+    code: SearchFailureCode;
+    component: string;
+    message: string;
+    projectId: string;
+    timestamp: string;
+}
+export type SearchDiagnostic = SearchDegradationDiagnostic | SearchFailureDiagnostic;
+export declare class SearchServiceError extends Error {
+    readonly code: SearchFailureCode;
+    readonly component: string;
+    readonly statusCode: number;
+    constructor(code: SearchFailureCode, component: string, options?: {
+        cause?: unknown;
+        statusCode?: number;
+    });
+}
+export declare function searchBackendUnavailable(component: string, cause: unknown): SearchServiceError;
+export declare function storeCorruption(component: string, cause: unknown): SearchServiceError;
+export declare function recordSearchDegradation(code: SearchDegradationCode, component: string, projectId: string): SearchDegradation;
+export declare function recordSearchFailure(error: SearchServiceError, projectId: string): void;
+export declare function getSearchDiagnostics(): readonly SearchDiagnostic[];
+/** Test-only reset; production callers consume snapshots only. */
+export declare function resetSearchDiagnosticsForTests(): void;
+//# sourceMappingURL=search-diagnostics.d.ts.map

package/dist/services/search/search-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/services/search/search-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,4BAA4B,GAC5B,kBAAkB,CAAC;AAEvB,MAAM,MAAM,qBAAqB,GAC7B,iCAAiC,GACjC,qBAAqB,GACrB,0BAA0B,GAC1B,8BAA8B,GAC9B,gCAAgC,GAChC,qBAAqB,GACrB,0BAA0B,GAC1B,8BAA8B,CAAC;AAEnC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,IAAI,EAAE,qBAAqB,EAC3B,SAAS,EAAE,MAAM,KACd,IAAI,CAAC;AAEV,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GACxB,2BAA2B,GAC3B,uBAAuB,CAAC;AAiB5B,qBAAa,kBAAmB,SAAQ,KAAK;IAIzC,QAAQ,CAAC,IAAI,EAAE,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAJ5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAGjB,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAWrD;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb,kBAAkB,CAIpB;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb,kBAAkB,CAOpB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,EAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAgBnB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,GAChB,IAAI,CAcN;AAED,wBAAgB,oBAAoB,IAAI,SAAS,gBAAgB,EAAE,CAElE;AAED,kEAAkE;AAClE,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/services/search/search-diagnostics.js

@@ -0,0 +1,81 @@
+const MAX_DIAGNOSTICS = 100;
+const diagnostics = [];
+const recordedFailures = new WeakSet();
+const DEGRADATION_MESSAGES = {
+    QUERY_UNDERSTANDING_UNAVAILABLE: "Query understanding was unavailable; original query used",
+    TRIGRAM_UNAVAILABLE: "Trigram enrichment was unavailable",
+    FUZZY_SEARCH_UNAVAILABLE: "Fuzzy enrichment was unavailable",
+    PROXIMITY_RERANK_UNAVAILABLE: "Proximity reranking was unavailable; fused order preserved",
+    GRAPH_AUGMENTATION_UNAVAILABLE: "Graph augmentation was unavailable",
+    SYNAPSE_UNAVAILABLE: "Synapse enrichment was unavailable; stateless results used",
+    SEARCH_AUDIT_UNAVAILABLE: "Search event auditing was unavailable",
+    SEARCH_ANALYTICS_UNAVAILABLE: "Search analytics were unavailable",
+};
+export class SearchServiceError extends Error {
+    code;
+    component;
+    statusCode;
+    constructor(code, component, options) {
+        super(code === "STORE_CORRUPTION"
+            ? "Stored data is invalid"
+            : "A required search backend is unavailable", options?.cause === undefined ? undefined : { cause: options.cause });
+        this.code = code;
+        this.component = component;
+        this.name = "SearchServiceError";
+        this.statusCode = options?.statusCode ?? 503;
+    }
+}
+export function searchBackendUnavailable(component, cause) {
+    return cause instanceof SearchServiceError
+        ? cause
+        : new SearchServiceError("SEARCH_BACKEND_UNAVAILABLE", component, { cause });
+}
+export function storeCorruption(component, cause) {
+    return cause instanceof SearchServiceError
+        ? cause
+        : new SearchServiceError("STORE_CORRUPTION", component, {
+            cause,
+            statusCode: 500,
+        });
+}
+export function recordSearchDegradation(code, component, projectId) {
+    const degradation = {
+        code,
+        component,
+        message: DEGRADATION_MESSAGES[code],
+    };
+    diagnostics.push({
+        kind: "degradation",
+        ...degradation,
+        projectId,
+        timestamp: new Date().toISOString(),
+    });
+    if (diagnostics.length > MAX_DIAGNOSTICS) {
+        diagnostics.splice(0, diagnostics.length - MAX_DIAGNOSTICS);
+    }
+    return degradation;
+}
+export function recordSearchFailure(error, projectId) {
+    if (recordedFailures.has(error))
+        return;
+    recordedFailures.add(error);
+    diagnostics.push({
+        kind: "failure",
+        code: error.code,
+        component: error.component,
+        message: error.message,
+        projectId,
+        timestamp: new Date().toISOString(),
+    });
+    if (diagnostics.length > MAX_DIAGNOSTICS) {
+        diagnostics.splice(0, diagnostics.length - MAX_DIAGNOSTICS);
+    }
+}
+export function getSearchDiagnostics() {
+    return diagnostics.map((diagnostic) => ({ ...diagnostic }));
+}
+/** Test-only reset; production callers consume snapshots only. */
+export function resetSearchDiagnosticsForTests() {
+    diagnostics.length = 0;
+}
+//# sourceMappingURL=search-diagnostics.js.map

package/dist/services/search/search-diagnostics.js.map

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

package/dist/services/search/search-warmup.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Search Cache Warmup
+ *
+ * Pre-loads frequently searched queries into cache on startup
+ * to improve initial search performance.
+ */
+import { SearchAnalytics } from "./search-analytics.js";
+import { ContextualSearchRLM } from "./contextual-search-rlm.js";
+export declare class SearchCacheWarmup {
+    private analytics;
+    private search;
+    constructor(search: ContextualSearchRLM, analytics: SearchAnalytics);
+    /**
+     * Warm up cache for a project by pre-loading top queries
+     */
+    warmupProject(projectId: string, topN?: number): Promise<{
+        queriesWarmed: number;
+        totalDuration: number;
+    }>;
+    /**
+     * Warm up cache for all projects
+     */
+    warmupAll(topN?: number): Promise<{
+        projects: number;
+        totalQueries: number;
+        totalDuration: number;
+    }>;
+}
+//# sourceMappingURL=search-warmup.d.ts.map

package/dist/services/search/search-warmup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-warmup.d.ts","sourceRoot":"","sources":["../../../src/services/search/search-warmup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe;IAKnE;;OAEG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAW,GAChB,OAAO,CAAC;QACT,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAkDF;;OAEG;IACG,SAAS,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC;QAC1C,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CAsCH"}

package/dist/services/search/search-warmup.js

@@ -0,0 +1,96 @@
+/**
+ * Search Cache Warmup
+ *
+ * Pre-loads frequently searched queries into cache on startup
+ * to improve initial search performance.
+ */
+import { logger } from "@massa-ai/shared";
+export class SearchCacheWarmup {
+    analytics;
+    search;
+    constructor(search, analytics) {
+        this.search = search;
+        this.analytics = analytics;
+    }
+    /**
+     * Warm up cache for a project by pre-loading top queries
+     */
+    async warmupProject(projectId, topN = 10) {
+        const startTime = Date.now();
+        logger.info("Starting cache warmup", { projectId, topN });
+        try {
+            // Get top N most frequent queries for this project
+            const topQueries = await this.analytics.getTopQueries(projectId, topN);
+            if (topQueries.length === 0) {
+                logger.info("No queries to warm up", { projectId });
+                return { queriesWarmed: 0, totalDuration: 0 };
+            }
+            let warmed = 0;
+            // Pre-execute each query to populate cache
+            for (const queryStats of topQueries) {
+                try {
+                    await this.search.search(queryStats.query, projectId, {
+                        maxResults: 10, // Standard size
+                    });
+                    warmed++;
+                    logger.debug("Warmed query", {
+                        query: queryStats.query,
+                        previousCount: queryStats.count,
+                    });
+                }
+                catch (error) {
+                    logger.error("Failed to warm query", error, {
+                        query: queryStats.query,
+                    });
+                }
+            }
+            const totalDuration = Date.now() - startTime;
+            logger.info("Cache warmup completed", {
+                projectId,
+                queriesWarmed: warmed,
+                totalDuration: `${totalDuration}ms`,
+            });
+            return { queriesWarmed: warmed, totalDuration };
+        }
+        catch (error) {
+            logger.error("Cache warmup failed", error, { projectId });
+            return { queriesWarmed: 0, totalDuration: Date.now() - startTime };
+        }
+    }
+    /**
+     * Warm up cache for all projects
+     */
+    async warmupAll(topN = 10) {
+        const startTime = Date.now();
+        logger.info("Starting global cache warmup", { topN });
+        try {
+            // Get all projects that have been searched
+            const projects = await this.analytics.getActiveProjects();
+            let totalQueries = 0;
+            for (const projectId of projects) {
+                const result = await this.warmupProject(projectId, topN);
+                totalQueries += result.queriesWarmed;
+            }
+            const totalDuration = Date.now() - startTime;
+            logger.info("Global cache warmup completed", {
+                projects: projects.length,
+                totalQueries,
+                totalDuration: `${totalDuration}ms`,
+            });
+            return {
+                projects: projects.length,
+                totalQueries,
+                totalDuration,
+            };
+        }
+        catch (error) {
+            logger.error("Global cache warmup failed", error);
+            return {
+                projects: 0,
+                totalQueries: 0,
+                totalDuration: Date.now() - startTime,
+            };
+        }
+    }
+}
+//# sourceMappingURL=search-warmup.js.map

package/dist/services/search/search-warmup.js.map

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

package/dist/services/search/smart-chunker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Smart Chunker — dispatcher (Wave 6 N31, T16)
+ *
+ * Language/format-aware semantic chunking. All chunking logic extracted to
+ * chunker/ modules. This file dispatches by extension and re-exports.
+ */
+export type { Chunk, ChunkerConfig } from "./chunker/chunker-types.js";
+export { DEFAULT_CONFIG } from "./chunker/chunker-types.js";
+export { chunkMarkdown, chunkMarkdownByHeadings } from "./chunker/chunker-markdown.js";
+export { chunkJSON, chunkYAML } from "./chunker/chunker-json-yaml.js";
+export { chunkCode, findCodeBoundaries, netBraceDelta, extractFileImports, isCodeFile, CODE_EXTENSIONS } from "./chunker/chunker-code.js";
+export type { CodeBoundary } from "./chunker/chunker-code.js";
+export { postProcess, splitOversizedChunk, splitLineByChars, chunkFixed } from "./chunker/chunker-post.js";
+import type { Chunk, ChunkerConfig } from "./chunker/chunker-types.js";
+export declare function smartChunk(content: string, filePath: string, config?: Partial<ChunkerConfig>): Chunk[];
+//# sourceMappingURL=smart-chunker.d.ts.map

package/dist/services/search/smart-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-chunker.d.ts","sourceRoot":"","sources":["../../../src/services/search/smart-chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1I,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG3G,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAUvE,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,KAAK,EAAE,CA4CT"}