c64-kb 0.17.0

package/dist/services/analytics/statements.js

@@ -0,0 +1,99 @@
+/**
+ * Every SQL statement AnalyticsService runs, prepared once when the service
+ * opens its database. They used to be prepared again on every call. The
+ * type arguments give each statement's bind parameters and row shape; they
+ * are the column lists of the SELECTs below and the tables in schema.ts.
+ */
+function gapStatements(db) {
+    return {
+        openGap: db.prepare("SELECT id, hit_count FROM gaps WHERE query = ? AND tool = ? AND resolved = 0"),
+        bumpGap: db.prepare("UPDATE gaps SET hit_count = hit_count + 1, last_seen = datetime('now') WHERE id = ?"),
+        insertGap: db.prepare("INSERT INTO gaps (query, tool) VALUES (?, ?)"),
+        bumpReportedGap: db.prepare(`UPDATE gaps
+       SET hit_count = hit_count + 1,
+           last_seen = datetime('now'),
+           user_reported = 1,
+           notes = COALESCE(?, notes)
+       WHERE id = ?`),
+        insertReportedGap: db.prepare(`INSERT INTO gaps (query, tool, user_reported, notes)
+       VALUES (?, ?, 1, ?)`),
+        resolveGap: db.prepare("UPDATE gaps SET resolved = 1, resolved_at = datetime('now') WHERE query = ? AND resolved = 0"),
+        gaps: db.prepare("SELECT query, tool, hit_count, first_seen, last_seen FROM gaps WHERE resolved = 0 ORDER BY hit_count DESC LIMIT ?"),
+        recentGaps: db.prepare(`SELECT query, tool, hit_count, last_seen, user_reported, notes
+       FROM gaps
+       WHERE resolved = 0
+       ORDER BY hit_count DESC, last_seen DESC
+       LIMIT ?`),
+        markPendingVerify: db.prepare("UPDATE gaps SET pending_verify = 1 WHERE id = ?"),
+        pendingVerify: db.prepare("SELECT id, query, tool, hit_count, first_seen, last_seen FROM gaps WHERE resolved = 0 AND pending_verify = 1 ORDER BY last_seen DESC"),
+    };
+}
+function logStatements(db) {
+    return {
+        insertQuery: db.prepare(`INSERT INTO query_log (tool, query, result_count, result_scores, search_mode, result_sources)
+       VALUES (?, ?, ?, ?, ?, ?)`),
+        insertHydration: db.prepare("INSERT INTO hydration_log (tool, doc_path, title) VALUES (?, ?, ?)"),
+        queryById: db.prepare("SELECT id, tool, query, result_count, timestamp FROM query_log WHERE id = ?"),
+        unassignedQueries: db.prepare(`SELECT ql.* FROM query_log ql
+       WHERE ql.id NOT IN (
+         SELECT value FROM episodes, json_each(episodes.query_log_ids)
+       )
+       ORDER BY ql.timestamp ASC`),
+        hydrationBetween: db.prepare("SELECT * FROM hydration_log WHERE timestamp BETWEEN ? AND ? ORDER BY timestamp ASC"),
+    };
+}
+function learningStatements(db) {
+    return {
+        insertEpisode: db.prepare(`INSERT INTO episodes (started_at, ended_at, query_log_ids, resolution, resolution_summary)
+       VALUES (?, ?, ?, ?, ?)`),
+        resolveEpisode: db.prepare("UPDATE episodes SET resolution = ?, resolution_summary = ? WHERE id = ?"),
+        insertCandidate: db.prepare(`INSERT INTO learning_candidates (type, title, body, evidence, confidence, source_episodes, related_apis)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`),
+        candidateById: db.prepare("SELECT * FROM learning_candidates WHERE id = ?"),
+        promoteCandidate: db.prepare("UPDATE learning_candidates SET status = ?, promoted_at = datetime('now'), promote_manifest = ? WHERE id = ?"),
+        setCandidateStatus: db.prepare("UPDATE learning_candidates SET status = ?, promote_manifest = ? WHERE id = ?"),
+        proposedCandidates: db.prepare("SELECT * FROM learning_candidates WHERE status = 'proposed' ORDER BY created_at DESC"),
+        promotedCandidates: db.prepare("SELECT * FROM learning_candidates WHERE status = 'promoted' ORDER BY promoted_at DESC"),
+    };
+}
+function statsStatements(db) {
+    return {
+        episodeCount: db.prepare("SELECT COUNT(*) as n FROM episodes"),
+        candidateCount: db.prepare("SELECT COUNT(*) as n FROM learning_candidates"),
+        queryCount: db.prepare("SELECT COUNT(*) as n FROM query_log"),
+        successfulCount: db.prepare("SELECT COUNT(*) as n FROM query_log WHERE result_count > 0"),
+        uniqueQueryCount: db.prepare("SELECT COUNT(DISTINCT query) as n FROM query_log"),
+        topTools: db.prepare("SELECT tool, COUNT(*) as count FROM query_log GROUP BY tool ORDER BY count DESC LIMIT 5"),
+        topSuccessful: db.prepare("SELECT query, COUNT(*) as count FROM query_log WHERE result_count > 0 GROUP BY query ORDER BY count DESC LIMIT 10"),
+        latestGaps: db.prepare("SELECT query, hit_count FROM gaps WHERE resolved = 0 ORDER BY last_seen DESC LIMIT 10"),
+        weeks: db.prepare(`SELECT
+         strftime('%Y-W%W', timestamp) AS week,
+         COUNT(*) AS queries,
+         SUM(CASE WHEN result_count = 0 THEN 1 ELSE 0 END) AS gaps
+       FROM query_log
+       GROUP BY week
+       ORDER BY week DESC
+       LIMIT 12`),
+        weekEpisodes: db.prepare(`SELECT COUNT(*) as n FROM episodes
+       WHERE strftime('%Y-W%W', started_at) = ?`),
+        weekProposed: db.prepare(`SELECT COUNT(*) as n FROM learning_candidates
+       WHERE strftime('%Y-W%W', created_at) = ?`),
+        weekPromoted: db.prepare(`SELECT COUNT(*) as n FROM learning_candidates
+       WHERE status = 'promoted' AND strftime('%Y-W%W', promoted_at) = ?`),
+        weekResolved: db.prepare(`SELECT COUNT(*) as n FROM gaps
+       WHERE resolved = 1 AND strftime('%Y-W%W', resolved_at) = ?`),
+    };
+}
+export function prepareStatements(db) {
+    return {
+        ...gapStatements(db),
+        ...logStatements(db),
+        ...learningStatements(db),
+        ...statsStatements(db),
+    };
+}
+/** A COUNT(*) row's value. COUNT always returns one row; 0 covers a statement that returned none. */
+export function count(row) {
+    return row?.n ?? 0;
+}
+//# sourceMappingURL=statements.js.map

package/dist/services/analytics/statements.js.map

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

package/dist/services/analytics.js

@@ -0,0 +1,195 @@
+/**
+ * Query analytics and gap detection.
+ *
+ * Logs every query to SQLite. Tracks zero-result queries as "gaps"
+ * in the knowledge base. Provides coverage and trend reporting.
+ * Manages episodes and learning candidates for self-improvement.
+ *
+ * Tables are in analytics/schema.ts; every statement is prepared once, in
+ * analytics/statements.ts, when the service opens the file.
+ */
+import Database from "better-sqlite3";
+import fs from "fs";
+import path from "path";
+import { config } from "../config.js";
+import { initSchema } from "./analytics/schema.js";
+import { count, prepareStatements, } from "./analytics/statements.js";
+/** Split rows (in timestamp order) wherever consecutive timestamps are more than `windowMinutes` apart. */
+function splitByGap(rows, windowMinutes) {
+    const windows = [];
+    let current = [];
+    let prev = null;
+    for (const row of rows) {
+        const t = new Date(row.timestamp).getTime();
+        if (prev !== null && (t - prev) / 60000 > windowMinutes) {
+            windows.push({ queries: current });
+            current = [];
+        }
+        current.push(row);
+        prev = t;
+    }
+    if (current.length > 0)
+        windows.push({ queries: current });
+    return windows;
+}
+export class AnalyticsService {
+    db;
+    s;
+    constructor(dbPath = config.analytics.dbPath) {
+        fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("busy_timeout = 5000");
+        initSchema(this.db);
+        this.s = prepareStatements(this.db);
+    }
+    // ── Query logging ──────────────────────────────────────────────────
+    /**
+     * Log a query and track gaps.
+     */
+    logQuery(opts) {
+        // One IMMEDIATE transaction: the CLI and the MCP server share this file,
+        // and a bare SELECT-then-INSERT let two processes both insert the gap.
+        this.db
+            .transaction(() => {
+            this.logQueryUnlocked(opts);
+        })
+            .immediate();
+    }
+    logQueryUnlocked(opts) {
+        const { tool, query, resultCount, resultScores, searchMode, resultSources } = opts;
+        this.s.insertQuery.run(tool, query, resultCount, resultScores ? JSON.stringify(resultScores) : null, searchMode ?? null, resultSources ? JSON.stringify(resultSources) : null);
+        if (resultCount !== 0)
+            return;
+        const existing = this.s.openGap.get(query, tool);
+        if (existing)
+            this.s.bumpGap.run(existing.id);
+        else
+            this.s.insertGap.run(query, tool);
+    }
+    // ── Hydration logging ──────────────────────────────────────────────
+    logHydration(tool, docPath, title) {
+        this.s.insertHydration.run(tool, docPath, title);
+    }
+    // ── Gaps ───────────────────────────────────────────────────────────
+    /**
+     * Mark a gap as resolved (e.g., after ingesting new docs).
+     */
+    resolveGap(query) {
+        this.s.resolveGap.run(query);
+    }
+    /**
+     * Get unresolved gaps ordered by frequency (most-searched-but-unfound).
+     */
+    getGaps(limit = 20) {
+        return this.s.gaps.all(limit);
+    }
+    /**
+     * Return the top N recent gaps (resolved=0) ordered by hit_count then last_seen.
+     */
+    getRecentGaps(limit = 10) {
+        return this.s.recentGaps.all(limit);
+    }
+    /**
+     * Upsert a gap reported explicitly by an agent or user.
+     * Returns the gap row's id and updated hit_count + whether it was new.
+     */
+    reportGap(query, tool, notes) {
+        // Same race as logQuery: select-then-write in one IMMEDIATE transaction.
+        return this.db.transaction(() => this.reportGapUnlocked(query, tool, notes ?? null)).immediate();
+    }
+    reportGapUnlocked(query, tool, notes) {
+        const existing = this.s.openGap.get(query, tool);
+        if (existing) {
+            this.s.bumpReportedGap.run(notes, existing.id);
+            return { gap_id: existing.id, hit_count: existing.hit_count + 1, status: "incremented" };
+        }
+        const result = this.s.insertReportedGap.run(query, tool, notes);
+        return { gap_id: Number(result.lastInsertRowid), hit_count: 1, status: "new" };
+    }
+    getQueryById(id) {
+        return this.s.queryById.get(id);
+    }
+    markGapPendingVerify(gapId) {
+        this.s.markPendingVerify.run(gapId);
+    }
+    getPendingVerifyGaps() {
+        return this.s.pendingVerify.all();
+    }
+    // ── Episodes ───────────────────────────────────────────────────────
+    createEpisode(e) {
+        const result = this.s.insertEpisode.run(e.startedAt, e.endedAt, JSON.stringify(e.queryLogIds), e.resolution, e.resolutionSummary ?? null);
+        return Number(result.lastInsertRowid);
+    }
+    updateEpisodeResolution(id, resolution, summary) {
+        this.s.resolveEpisode.run(resolution, summary ?? null, id);
+    }
+    getEpisodeCount() {
+        return count(this.s.episodeCount.get());
+    }
+    // ── Learning candidates ────────────────────────────────────────────
+    createCandidate(c) {
+        const result = this.s.insertCandidate.run(c.type, c.title, c.body, c.evidence, c.confidence, JSON.stringify(c.sourceEpisodes), JSON.stringify(c.relatedApis));
+        return Number(result.lastInsertRowid);
+    }
+    getCandidateById(id) {
+        return this.s.candidateById.get(id);
+    }
+    updateCandidateStatus(id, status, promoteManifest) {
+        const stmt = status === "promoted" ? this.s.promoteCandidate : this.s.setCandidateStatus;
+        stmt.run(status, promoteManifest ?? null, id);
+    }
+    getProposedCandidates() {
+        return this.s.proposedCandidates.all();
+    }
+    getPromotedCandidates() {
+        return this.s.promotedCandidates.all();
+    }
+    getCandidateCount() {
+        return count(this.s.candidateCount.get());
+    }
+    // ── Windowed queries for episode detection ─────────────────────────
+    /** query_log rows not yet assigned to any episode, bucketed by time gaps. */
+    getUnprocessedQueryWindows(windowMinutes) {
+        return splitByGap(this.s.unassignedQueries.all(), windowMinutes);
+    }
+    getHydrationInWindow(start, end) {
+        return this.s.hydrationBetween.all(start, end);
+    }
+    // ── Stats ──────────────────────────────────────────────────────────
+    /**
+     * Query volume and success rate stats.
+     */
+    getQueryStats() {
+        const total = count(this.s.queryCount.get());
+        const successful = count(this.s.successfulCount.get());
+        return {
+            total_queries: total,
+            successful_queries: successful,
+            failed_queries: total - successful,
+            success_rate: total > 0 ? Math.round((successful / total) * 100) : 0,
+            unique_queries: count(this.s.uniqueQueryCount.get()),
+            top_tools: this.s.topTools.all(),
+            top_successful: this.s.topSuccessful.all(),
+            recent_gaps: this.s.latestGaps.all(),
+        };
+    }
+    /**
+     * Weekly aggregated stats for history/trend tracking.
+     */
+    getWeeklyStats() {
+        return this.s.weeks.all().map(({ week, queries, gaps }) => ({
+            week,
+            queries,
+            gaps,
+            gaps_resolved: count(this.s.weekResolved.get(week)),
+            episodes: count(this.s.weekEpisodes.get(week)),
+            candidates_proposed: count(this.s.weekProposed.get(week)),
+            candidates_promoted: count(this.s.weekPromoted.get(week)),
+        }));
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/services/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/services/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,KAAK,EACL,iBAAiB,GAOlB,MAAM,2BAA2B,CAAC;AAgEnC,2GAA2G;AAC3G,SAAS,UAAU,CAAC,IAAmB,EAAE,aAAqB;IAC5D,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,IAAI,OAAO,GAAkB,EAAE,CAAC;IAChC,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,aAAa,EAAE,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACnC,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,GAAG,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,gBAAgB;IACV,EAAE,CAAoB;IACtB,CAAC,CAAa;IAE/B,YAAY,SAAiB,MAAM,CAAC,SAAS,CAAC,MAAM;QAClD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACtC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,sEAAsE;IAEtE;;OAEG;IACH,QAAQ,CAAC,IAAkB;QACzB,yEAAyE;QACzE,uEAAuE;QACvE,IAAI,CAAC,EAAE;aACJ,WAAW,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAC;aACD,SAAS,EAAE,CAAC;IACjB,CAAC;IAEO,gBAAgB,CAAC,IAAkB;QACzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;QACnF,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CACpB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAClD,UAAU,IAAI,IAAI,EAClB,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CACrD,CAAC;QACF,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,QAAQ;YAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;;YACzC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,sEAAsE;IAEtE,YAAY,CAAC,IAAY,EAAE,OAAsB,EAAE,KAAoB;QACrE,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,sEAAsE;IAEtE;;OAEG;IACH,UAAU,CAAC,KAAa;QACtB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAK,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,aAAa,CACX,KAAK,GAAG,EAAE;QAEV,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAa,EAAE,IAAY,EAAE,KAAc;QACnD,yEAAyE;QACzE,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACnG,CAAC;IAEO,iBAAiB,CAAC,KAAa,EAAE,IAAY,EAAE,KAAoB;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAC3F,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjF,CAAC;IAED,YAAY,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,oBAAoB,CAAC,KAAa;QAChC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,sEAAsE;IAEtE,aAAa,CAAC,CAAe;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CACrC,CAAC,CAAC,SAAS,EACX,CAAC,CAAC,OAAO,EACT,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAC7B,CAAC,CAAC,UAAU,EACZ,CAAC,CAAC,iBAAiB,IAAI,IAAI,CAC5B,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAED,uBAAuB,CAAC,EAAU,EAAE,UAAkB,EAAE,OAAgB;QACtE,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,sEAAsE;IAEtE,eAAe,CAAC,CAAiB;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CACvC,CAAC,CAAC,IAAI,EACN,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,IAAI,EACN,CAAC,CAAC,QAAQ,EACV,CAAC,CAAC,UAAU,EACZ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,EAChC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAC9B,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAED,gBAAgB,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,qBAAqB,CAAC,EAAU,EAAE,MAAc,EAAE,eAAwB;QACxE,MAAM,IAAI,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACzF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,qBAAqB;QACnB,OAAO,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IAED,qBAAqB;QACnB,OAAO,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IAED,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,sEAAsE;IAEtE,6EAA6E;IAC7E,0BAA0B,CAAC,aAAqB;QAC9C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC;IAED,oBAAoB,CAAC,KAAa,EAAE,GAAW;QAC7C,OAAO,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,sEAAsE;IAEtE;;OAEG;IACH,aAAa;QACX,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,OAAO;YACL,aAAa,EAAE,KAAK;YACpB,kBAAkB,EAAE,UAAU;YAC9B,cAAc,EAAE,KAAK,GAAG,UAAU;YAClC,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;YACpD,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE;YAChC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE;YAC1C,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;SACrC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnD,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9C,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzD,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC1D,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/services/bm25.js

@@ -0,0 +1,158 @@
+/**
+ * Pure-TS BM25 encoder for sparse vectors compatible with Qdrant's
+ * `modifier: "idf"` sparse vector configuration.
+ *
+ * Tokenizer: lowercase + split on \W+, with a special case for hex
+ * bytes ($XX, $XXXX) and mnemonic-style identifiers (uppercase letters
+ * with optional digits) which are preserved as single tokens.
+ *
+ * Math: standard BM25 (Robertson et al.), k1=1.2, b=0.75. IDF is
+ * computed from corpus document frequency.
+ *
+ * Persistence: toJSON / fromJSON for vocab + DF + avgDocLen, and
+ * loadBM25Vocab for the vocab file every reader shares.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { config } from "../config.js";
+const HEX_TOKEN = /\$[0-9A-Fa-f]{2,4}/g;
+const IDENT_TOKEN = /[A-Z][A-Z0-9_]+/g; // SCROLY, CHROUT, LDA, etc.
+const WORD_TOKEN = /[a-zA-Z0-9_]+/g;
+function tokenize(s) {
+    const tokens = [];
+    const seen = new Set(); // byte offset of consumed regions
+    const consume = (regex, transform) => {
+        let m;
+        regex.lastIndex = 0;
+        while ((m = regex.exec(s)) !== null) {
+            const start = m.index;
+            const end = start + m[0].length;
+            let overlap = false;
+            for (let i = start; i < end; i++)
+                if (seen.has(i)) {
+                    overlap = true;
+                    break;
+                }
+            if (overlap)
+                continue;
+            for (let i = start; i < end; i++)
+                seen.add(i);
+            tokens.push(transform(m[0]));
+        }
+    };
+    // Order matters: hex first (keeps $A9 intact), then mnemonics (CHROUT),
+    // then generic words.
+    consume(HEX_TOKEN, (m) => m.toLowerCase());
+    consume(IDENT_TOKEN, (m) => m.toLowerCase());
+    consume(WORD_TOKEN, (m) => m.toLowerCase());
+    return tokens;
+}
+export class BM25Encoder {
+    vocab = new Map();
+    df = new Map(); // token-id → document frequency
+    avgDocLen = 0;
+    numDocs = 0;
+    k1 = 1.2;
+    b = 0.75;
+    fit(corpus) {
+        let totalLen = 0;
+        for (const doc of corpus) {
+            const tokens = tokenize(doc);
+            const docTokenIds = new Set();
+            for (const tok of tokens) {
+                let id = this.vocab.get(tok);
+                if (id === undefined) {
+                    id = this.vocab.size;
+                    this.vocab.set(tok, id);
+                }
+                docTokenIds.add(id);
+            }
+            for (const id of docTokenIds) {
+                this.df.set(id, (this.df.get(id) ?? 0) + 1);
+            }
+            totalLen += tokens.length;
+            this.numDocs += 1;
+        }
+        this.avgDocLen = this.numDocs > 0 ? totalLen / this.numDocs : 0;
+    }
+    encode(text) {
+        const tokens = tokenize(text);
+        if (tokens.length === 0)
+            return { indices: [], values: [] };
+        const tf = new Map();
+        for (const tok of tokens) {
+            const id = this.vocab.get(tok);
+            if (id === undefined)
+                continue;
+            tf.set(id, (tf.get(id) ?? 0) + 1);
+        }
+        const docLen = tokens.length;
+        const out = { indices: [], values: [] };
+        const sorted = Array.from(tf.entries()).sort(([a], [b]) => a - b);
+        for (const [id, freq] of sorted) {
+            const dfCount = this.df.get(id) ?? 0;
+            if (dfCount === 0)
+                continue;
+            // BM25 score component for this term
+            const idf = Math.log(1 + (this.numDocs - dfCount + 0.5) / (dfCount + 0.5));
+            const norm = (freq * (this.k1 + 1)) / (freq + this.k1 * (1 - this.b + (this.b * docLen) / this.avgDocLen));
+            const score = idf * norm;
+            if (score > 0) {
+                out.indices.push(id);
+                out.values.push(score);
+            }
+        }
+        return out;
+    }
+    toJSON() {
+        return {
+            vocab: Array.from(this.vocab.entries()),
+            df: Array.from(this.df.entries()),
+            avgDocLen: this.avgDocLen,
+            numDocs: this.numDocs,
+            k1: this.k1,
+            b: this.b,
+        };
+    }
+    static fromJSON(data) {
+        const enc = new BM25Encoder();
+        enc.vocab = new Map(data.vocab);
+        enc.df = new Map(data.df);
+        enc.avgDocLen = data.avgDocLen;
+        enc.numDocs = data.numDocs;
+        enc.k1 = data.k1;
+        enc.b = data.b;
+        return enc;
+    }
+}
+/** The vocab file batch ingest fits and every query encodes against. */
+export const BM25_VOCAB_FILE = path.resolve(config.analytics.dbPath, "../bm25-vocab.json");
+const VocabJson = z.object({
+    vocab: z.array(z.tuple([z.string(), z.number()])),
+    df: z.array(z.tuple([z.number(), z.number()])),
+    avgDocLen: z.number(),
+    numDocs: z.number(),
+    k1: z.number(),
+    b: z.number(),
+});
+/**
+ * Load the persisted BM25 encoder. Returns null when the file does not
+ * exist, and null with a reason on stderr when it cannot be read or does
+ * not hold a vocab; callers fall back to empty sparse vectors or a refit.
+ */
+export function loadBM25Vocab(file = BM25_VOCAB_FILE) {
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        const parsed = VocabJson.safeParse(JSON.parse(fs.readFileSync(file, "utf-8")));
+        if (parsed.success)
+            return BM25Encoder.fromJSON(parsed.data);
+        console.error(`[bm25] ${file} is not a BM25 vocab: ${parsed.error.issues[0]?.message ?? "invalid"}`);
+    }
+    catch (err) {
+        console.error(`[bm25] cannot read ${file}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return null;
+}
+//# sourceMappingURL=bm25.js.map

package/dist/services/bm25.js.map

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

package/dist/services/chunker.js

@@ -0,0 +1,81 @@
+/**
+ * Markdown chunker: splits documents into sections by headings.
+ * Each chunk gets a heading path for context (e.g. "Exec > Semaphores > ObtainSemaphore").
+ */
+const MAX_CHUNK_SIZE = 1500;
+const FENCE = "```";
+/** The heading state after `line`, or null when `line` is not an H1-H3. */
+function nextHeadings(line, h) {
+    if (line.startsWith("# ")) {
+        const h1 = line.replace(/^#\s+/, "").trim();
+        return { h1, h2: "", path: h1 };
+    }
+    if (line.startsWith("## ")) {
+        const h2 = line.replace(/^##\s+/, "").trim();
+        return { h1: h.h1, h2, path: h.h1 ? `${h.h1} > ${h2}` : h2 };
+    }
+    if (line.startsWith("### ")) {
+        const h3 = line.replace(/^###\s+/, "").trim();
+        let path = h3;
+        if (h.h2)
+            path = `${h.h1} > ${h.h2} > ${h3}`;
+        else if (h.h1)
+            path = `${h.h1} > ${h3}`;
+        return { ...h, path };
+    }
+    return null;
+}
+/** One section's text as chunks: split on paragraphs when too long, unless it holds a code fence. */
+function sectionChunks(section, lines) {
+    const text = lines.join("\n").trim();
+    if (text.length === 0)
+        return [];
+    // Code blocks stay intact even when they exceed MAX_CHUNK_SIZE.
+    if (text.length <= MAX_CHUNK_SIZE || text.includes(FENCE))
+        return [{ section, text }];
+    return splitOnParagraphs(text, MAX_CHUNK_SIZE).map((sub) => ({ section, text: sub }));
+}
+export function chunkMarkdown(content, source) {
+    // Keep all chunks as-is. An earlier <80-char merge silently dropped
+    // section headings for tiny chunks (e.g. per-opcode H3s in 6510-cpu-
+    // reference.md), which broke retrieval. Tiny chunks are fine: their
+    // heading is the searchable identifier.
+    const chunks = [];
+    let headings = { h1: "", h2: "", path: source };
+    let currentText = [];
+    let inCodeFence = false;
+    for (const line of content.split("\n")) {
+        // Track code fence state; a heading inside a fenced block is code, not a split point.
+        const isFence = line.startsWith(FENCE);
+        if (isFence)
+            inCodeFence = !inCodeFence;
+        const next = isFence || inCodeFence ? null : nextHeadings(line, headings);
+        if (next === null) {
+            currentText.push(line);
+            continue;
+        }
+        chunks.push(...sectionChunks(headings.path, currentText));
+        currentText = [];
+        headings = next;
+    }
+    chunks.push(...sectionChunks(headings.path, currentText));
+    return chunks;
+}
+function splitOnParagraphs(text, maxSize) {
+    const paras = text.split(/\n\n+/);
+    const result = [];
+    let buf = "";
+    for (const p of paras) {
+        if (buf.length + p.length + 2 > maxSize && buf.length > 0) {
+            result.push(buf.trim());
+            buf = p;
+        }
+        else {
+            buf += (buf ? "\n\n" : "") + p;
+        }
+    }
+    if (buf.trim())
+        result.push(buf.trim());
+    return result.length > 0 ? result : [text];
+}
+//# sourceMappingURL=chunker.js.map

package/dist/services/chunker.js.map

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

package/dist/services/embeddings.js

@@ -0,0 +1,58 @@
+/**
+ * Embedding service using Ollama's mxbai-embed-large model.
+ *
+ * Requires: ollama running locally with `ollama pull mxbai-embed-large`
+ * Dimension: 1024 (matches Qdrant collection config)
+ * Fallback: if Ollama is unavailable, returns null and callers
+ *           should fall back to keyword search.
+ */
+import { z } from "zod";
+import { config } from "../config.js";
+const EmbeddingReply = z.object({ embedding: z.array(z.number()).optional() });
+const TagsReply = z.object({ models: z.array(z.object({ name: z.string() })).optional() });
+const OLLAMA_URL = config.ollama.url;
+const MODEL = config.ollama.model;
+export async function embed(text) {
+    try {
+        const resp = await fetch(`${OLLAMA_URL}/api/embeddings`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ model: MODEL, prompt: text }),
+        });
+        if (!resp.ok)
+            return null;
+        const data = EmbeddingReply.parse(await resp.json());
+        return data.embedding ?? null;
+    }
+    catch (err) {
+        // Ollama unreachable or a malformed reply: the caller falls back to keyword search.
+        console.error(`[embeddings] embed failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+export async function embedBatch(texts) {
+    // Ollama doesn't have a native batch endpoint, so we parallelize
+    // with a concurrency limit to avoid overwhelming it
+    const CONCURRENCY = config.ollama.concurrency;
+    const results = [];
+    for (let i = 0; i < texts.length; i += CONCURRENCY) {
+        const batch = texts.slice(i, i + CONCURRENCY);
+        const promises = batch.map((t) => embed(t));
+        results.push(...(await Promise.all(promises)));
+    }
+    return results;
+}
+export async function isAvailable() {
+    try {
+        const resp = await fetch(`${OLLAMA_URL}/api/tags`);
+        if (!resp.ok)
+            return false;
+        const data = TagsReply.parse(await resp.json());
+        return data.models?.some((m) => m.name.startsWith(MODEL)) ?? false;
+    }
+    catch {
+        // This is the probe: an unreachable Ollama is the answer "not available", not an error.
+        return false;
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/services/embeddings.js.map

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