git-history-ui 2.0.3 → 3.0.0

package/dist/backend/llm/anthropicProvider.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const DEFAULT_MODEL = 'claude-3-5-haiku-latest';
+const ENDPOINT = 'https://api.anthropic.com/v1/messages';
+const VERSION = '2023-06-01';
+class AnthropicProvider {
+    apiKey;
+    model;
+    name = 'anthropic';
+    isAi = true;
+    constructor(apiKey, model = DEFAULT_MODEL) {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async score(query, candidates) {
+        if (candidates.length === 0)
+            return [];
+        // Slice candidate text to keep prompt small.
+        const items = candidates.map((c, i) => ({
+            idx: i,
+            id: c.id,
+            text: c.text.replace(/\s+/g, ' ').slice(0, 240)
+        }));
+        const prompt = [
+            'You score commit relevance to a developer query.',
+            'Return ONLY a JSON array of {idx:number,score:number} where score is in [0,1].',
+            'No prose, no markdown.',
+            `Query: ${query}`,
+            'Candidates:',
+            ...items.map((it) => `[${it.idx}] ${it.text}`)
+        ].join('\n');
+        const text = await this.call(prompt, 1024);
+        const parsed = parseScores(text, items.length);
+        return items.map((it) => ({ id: it.id, score: parsed[it.idx] ?? 0 }));
+    }
+    async summarize(text, opts) {
+        const prompt = [
+            opts?.hint ?? 'Summarize the following text in one short paragraph (max 3 sentences).',
+            '---',
+            text.length > 8000 ? text.slice(0, 8000) + '\n[truncated]' : text
+        ].join('\n');
+        const out = await this.call(prompt, 320);
+        return out.trim();
+    }
+    async call(prompt, maxTokens) {
+        const resp = await fetch(ENDPOINT, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.apiKey,
+                'anthropic-version': VERSION
+            },
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: maxTokens,
+                messages: [{ role: 'user', content: prompt }]
+            })
+        });
+        if (!resp.ok) {
+            const err = await resp.text().catch(() => '');
+            throw new Error(`anthropic ${resp.status}: ${err.slice(0, 200)}`);
+        }
+        const data = (await resp.json());
+        const block = data.content?.find((b) => b.type === 'text');
+        return block?.text ?? '';
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+function parseScores(raw, length) {
+    const result = {};
+    const match = raw.match(/\[[\s\S]*\]/);
+    if (!match)
+        return result;
+    try {
+        const arr = JSON.parse(match[0]);
+        for (const item of arr) {
+            if (typeof item?.idx === 'number' && item.idx >= 0 && item.idx < length) {
+                const s = Number(item.score);
+                if (Number.isFinite(s))
+                    result[item.idx] = Math.max(0, Math.min(1, s));
+            }
+        }
+    }
+    catch {
+        /* ignore — return what we have */
+    }
+    return result;
+}
+//# sourceMappingURL=anthropicProvider.js.map

package/dist/backend/llm/anthropicProvider.js.map

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

package/dist/backend/llm/heuristicProvider.d.ts

@@ -0,0 +1,15 @@
+import type { LlmService, ScoreCandidate, ScoredCandidate } from './types';
+export declare function expandKeywords(query: string): string[];
+export declare function tokenize(text: string): string[];
+/**
+ * Heuristic relevance scorer based on token overlap with synonym expansion
+ * and a small TF-IDF-ish weighting (rare tokens count more).
+ */
+export declare class HeuristicProvider implements LlmService {
+    readonly name: "heuristic";
+    readonly isAi = false;
+    score(query: string, candidates: ScoreCandidate[]): Promise<ScoredCandidate[]>;
+    summarize(text: string, _opts?: {
+        hint?: string;
+    }): Promise<string>;
+}

package/dist/backend/llm/heuristicProvider.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeuristicProvider = void 0;
+exports.expandKeywords = expandKeywords;
+exports.tokenize = tokenize;
+/**
+ * Synonyms expand a single query token into a set of related tokens.
+ * Designed for software engineering vocabulary: bug fixes, features,
+ * common subsystems. Keep entries lower-case.
+ */
+const SYNONYMS = {
+    fix: ['fix', 'bug', 'hotfix', 'patch', 'repair', 'correct', 'resolve'],
+    bug: ['bug', 'fix', 'hotfix', 'issue', 'defect', 'regression'],
+    feat: ['feat', 'feature', 'add', 'implement', 'introduce', 'new'],
+    add: ['add', 'feat', 'feature', 'implement', 'introduce'],
+    remove: ['remove', 'delete', 'drop', 'deprecate', 'kill'],
+    refactor: ['refactor', 'cleanup', 'restructure', 'rework', 'simplify'],
+    perf: ['perf', 'performance', 'optimize', 'speed', 'fast', 'cache'],
+    docs: ['docs', 'doc', 'documentation', 'readme', 'comment', 'comments'],
+    test: ['test', 'tests', 'spec', 'unit', 'integration', 'e2e'],
+    ci: ['ci', 'pipeline', 'workflow', 'github-actions', 'jenkins', 'travis'],
+    build: ['build', 'compile', 'webpack', 'vite', 'rollup', 'esbuild'],
+    deps: ['deps', 'dependencies', 'upgrade', 'bump', 'update', 'package'],
+    auth: ['auth', 'authentication', 'login', 'logout', 'signin', 'signout', 'oauth', 'jwt', 'session', 'token'],
+    login: ['login', 'logon', 'signin', 'sign-in', 'auth', 'authentication'],
+    payment: ['payment', 'payments', 'pay', 'billing', 'invoice', 'charge', 'stripe', 'checkout'],
+    ui: ['ui', 'frontend', 'view', 'component', 'css', 'style', 'theme'],
+    api: ['api', 'endpoint', 'route', 'rest', 'graphql', 'rpc', 'service'],
+    db: ['db', 'database', 'sql', 'migration', 'schema', 'query', 'postgres', 'mysql', 'mongo'],
+    security: ['security', 'cve', 'vuln', 'vulnerability', 'audit', 'xss', 'csrf', 'sqli'],
+    release: ['release', 'tag', 'version', 'publish', 'changelog']
+};
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'of', 'to', 'in', 'on', 'for', 'with', 'is', 'was', 'be', 'i', 'we', 'our',
+    'my', 'me', 'it', 'this', 'that', 'these', 'those', 'where', 'when', 'what', 'which', 'who', 'how',
+    'did', 'do', 'does', 'has', 'have', 'had', 'last', 'changes', 'change', 'commit', 'commits', 'related'
+]);
+// Reverse synonym map built once: every member token maps to all its bucket-mates.
+const REVERSE_SYNONYMS = (() => {
+    const map = new Map();
+    for (const [key, members] of Object.entries(SYNONYMS)) {
+        const all = new Set([key, ...members]);
+        for (const m of all) {
+            const cur = map.get(m);
+            if (cur)
+                for (const a of all)
+                    cur.add(a);
+            else
+                map.set(m, new Set(all));
+        }
+    }
+    return map;
+})();
+function expandKeywords(query) {
+    const tokens = tokenize(query);
+    const out = new Set();
+    for (const t of tokens) {
+        out.add(t);
+        const syn = REVERSE_SYNONYMS.get(t);
+        if (syn)
+            for (const s of syn)
+                out.add(s);
+    }
+    return Array.from(out);
+}
+function tokenize(text) {
+    return (text || '')
+        .toLowerCase()
+        .replace(/[^a-z0-9_\-/.]+/g, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length >= 2 && !STOP_WORDS.has(t));
+}
+/**
+ * Heuristic relevance scorer based on token overlap with synonym expansion
+ * and a small TF-IDF-ish weighting (rare tokens count more).
+ */
+class HeuristicProvider {
+    name = 'heuristic';
+    isAi = false;
+    async score(query, candidates) {
+        const queryTokens = expandKeywords(query);
+        if (queryTokens.length === 0) {
+            return candidates.map((c) => ({ id: c.id, score: 0 }));
+        }
+        // Document frequency for IDF weighting.
+        const docFreq = new Map();
+        const docTokens = candidates.map((c) => {
+            const toks = tokenize(c.text);
+            const seen = new Set(toks);
+            for (const t of seen)
+                docFreq.set(t, (docFreq.get(t) ?? 0) + 1);
+            return toks;
+        });
+        const N = Math.max(1, candidates.length);
+        return candidates.map((c, i) => {
+            const tokens = docTokens[i];
+            const tf = new Map();
+            for (const t of tokens)
+                tf.set(t, (tf.get(t) ?? 0) + 1);
+            let raw = 0;
+            let matched = 0;
+            for (const qt of queryTokens) {
+                const f = tf.get(qt);
+                if (!f)
+                    continue;
+                matched++;
+                const idf = Math.log(1 + N / (1 + (docFreq.get(qt) ?? 0)));
+                raw += (1 + Math.log(f)) * idf;
+            }
+            const coverage = matched / queryTokens.length;
+            const length = Math.max(1, tokens.length);
+            const norm = raw / Math.sqrt(length);
+            return { id: c.id, score: Math.min(1, 0.55 * coverage + 0.45 * Math.tanh(norm)) };
+        });
+    }
+    async summarize(text, _opts) {
+        const trimmed = (text || '').trim();
+        if (!trimmed)
+            return '';
+        // Heuristic summary: first non-empty paragraph, truncated.
+        const para = trimmed.split(/\n\n+/).find((p) => p.trim().length > 0) ?? trimmed;
+        const oneLine = para.replace(/\s+/g, ' ').trim();
+        return oneLine.length > 280 ? oneLine.substring(0, 277) + '...' : oneLine;
+    }
+}
+exports.HeuristicProvider = HeuristicProvider;
+//# sourceMappingURL=heuristicProvider.js.map

package/dist/backend/llm/heuristicProvider.js.map

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

package/dist/backend/llm/index.d.ts

@@ -0,0 +1,17 @@
+import type { LlmConfig, LlmService } from './types';
+export type { LlmConfig, LlmProviderName, LlmService, ScoreCandidate, ScoredCandidate } from './types';
+export { HeuristicProvider, expandKeywords, tokenize } from './heuristicProvider';
+export { AnthropicProvider } from './anthropicProvider';
+export { OpenAiProvider } from './openaiProvider';
+/**
+ * Resolve provider configuration from explicit config + environment.
+ * Precedence:
+ *   1. Explicit config.provider (must have matching key for ai providers).
+ *   2. GHUI_LLM_PROVIDER env var.
+ *   3. Auto-detect: anthropic key wins over openai key.
+ *   4. Heuristic fallback.
+ */
+export declare function createLlmService(config?: LlmConfig): LlmService;
+export declare function getDefaultLlmService(config?: LlmConfig): LlmService;
+/** Force-reset for tests. */
+export declare function _resetLlmCache(): void;

package/dist/backend/llm/index.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiProvider = exports.AnthropicProvider = exports.tokenize = exports.expandKeywords = exports.HeuristicProvider = void 0;
+exports.createLlmService = createLlmService;
+exports.getDefaultLlmService = getDefaultLlmService;
+exports._resetLlmCache = _resetLlmCache;
+const anthropicProvider_1 = require("./anthropicProvider");
+const heuristicProvider_1 = require("./heuristicProvider");
+const openaiProvider_1 = require("./openaiProvider");
+var heuristicProvider_2 = require("./heuristicProvider");
+Object.defineProperty(exports, "HeuristicProvider", { enumerable: true, get: function () { return heuristicProvider_2.HeuristicProvider; } });
+Object.defineProperty(exports, "expandKeywords", { enumerable: true, get: function () { return heuristicProvider_2.expandKeywords; } });
+Object.defineProperty(exports, "tokenize", { enumerable: true, get: function () { return heuristicProvider_2.tokenize; } });
+var anthropicProvider_2 = require("./anthropicProvider");
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return anthropicProvider_2.AnthropicProvider; } });
+var openaiProvider_2 = require("./openaiProvider");
+Object.defineProperty(exports, "OpenAiProvider", { enumerable: true, get: function () { return openaiProvider_2.OpenAiProvider; } });
+/**
+ * Resolve provider configuration from explicit config + environment.
+ * Precedence:
+ *   1. Explicit config.provider (must have matching key for ai providers).
+ *   2. GHUI_LLM_PROVIDER env var.
+ *   3. Auto-detect: anthropic key wins over openai key.
+ *   4. Heuristic fallback.
+ */
+function createLlmService(config = {}) {
+    const env = process.env;
+    const anthropicKey = config.anthropicApiKey || env.ANTHROPIC_API_KEY;
+    const openaiKey = config.openaiApiKey || env.OPENAI_API_KEY;
+    const requested = config.provider || env.GHUI_LLM_PROVIDER;
+    if (requested === 'anthropic' && anthropicKey)
+        return new anthropicProvider_1.AnthropicProvider(anthropicKey, config.model);
+    if (requested === 'openai' && openaiKey)
+        return new openaiProvider_1.OpenAiProvider(openaiKey, config.model);
+    if (requested === 'heuristic')
+        return new heuristicProvider_1.HeuristicProvider();
+    // Auto-detect when no explicit pick.
+    if (!requested) {
+        if (anthropicKey)
+            return new anthropicProvider_1.AnthropicProvider(anthropicKey, config.model);
+        if (openaiKey)
+            return new openaiProvider_1.OpenAiProvider(openaiKey, config.model);
+    }
+    return new heuristicProvider_1.HeuristicProvider();
+}
+let cached = null;
+let cachedKey = '';
+function getDefaultLlmService(config = {}) {
+    const key = JSON.stringify({
+        provider: config.provider ?? process.env.GHUI_LLM_PROVIDER ?? '',
+        a: !!(config.anthropicApiKey || process.env.ANTHROPIC_API_KEY),
+        o: !!(config.openaiApiKey || process.env.OPENAI_API_KEY),
+        m: config.model ?? ''
+    });
+    if (cached && cachedKey === key)
+        return cached;
+    cached = createLlmService(config);
+    cachedKey = key;
+    return cached;
+}
+/** Force-reset for tests. */
+function _resetLlmCache() {
+    cached = null;
+    cachedKey = '';
+}
+//# sourceMappingURL=index.js.map

package/dist/backend/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/llm/index.ts"],"names":[],"mappings":";;;AAkBA,4CAkBC;AAID,oDAWC;AAGD,wCAGC;AAzDD,2DAAwD;AACxD,2DAAwD;AACxD,qDAAkD;AAIlD,yDAAkF;AAAzE,sHAAA,iBAAiB,OAAA;AAAE,mHAAA,cAAc,OAAA;AAAE,6GAAA,QAAQ,OAAA;AACpD,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,SAAoB,EAAE;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,IAAI,GAAG,CAAC,iBAAiB,CAAC;IACrE,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC,cAAc,CAAC;IAC5D,MAAM,SAAS,GACb,MAAM,CAAC,QAAQ,IAAK,GAAG,CAAC,iBAAiD,CAAC;IAE5E,IAAI,SAAS,KAAK,WAAW,IAAI,YAAY;QAAE,OAAO,IAAI,qCAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACxG,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS;QAAE,OAAO,IAAI,+BAAc,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5F,IAAI,SAAS,KAAK,WAAW;QAAE,OAAO,IAAI,qCAAiB,EAAE,CAAC;IAE9D,qCAAqC;IACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,YAAY;YAAE,OAAO,IAAI,qCAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,SAAS;YAAE,OAAO,IAAI,+BAAc,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,IAAI,qCAAiB,EAAE,CAAC;AACjC,CAAC;AAED,IAAI,MAAM,GAAsB,IAAI,CAAC;AACrC,IAAI,SAAS,GAAG,EAAE,CAAC;AACnB,SAAgB,oBAAoB,CAAC,SAAoB,EAAE;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;QAChE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9D,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACxD,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;KACtB,CAAC,CAAC;IACH,IAAI,MAAM,IAAI,SAAS,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAC/C,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,GAAG,GAAG,CAAC;IAChB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6BAA6B;AAC7B,SAAgB,cAAc;IAC5B,MAAM,GAAG,IAAI,CAAC;IACd,SAAS,GAAG,EAAE,CAAC;AACjB,CAAC"}

package/dist/backend/llm/openaiProvider.d.ts

@@ -0,0 +1,13 @@
+import type { LlmService, ScoreCandidate, ScoredCandidate } from './types';
+export declare class OpenAiProvider implements LlmService {
+    private apiKey;
+    private model;
+    readonly name: "openai";
+    readonly isAi = true;
+    constructor(apiKey: string, model?: string);
+    score(query: string, candidates: ScoreCandidate[]): Promise<ScoredCandidate[]>;
+    summarize(text: string, opts?: {
+        hint?: string;
+    }): Promise<string>;
+    private call;
+}

package/dist/backend/llm/openaiProvider.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiProvider = void 0;
+const DEFAULT_MODEL = 'gpt-4o-mini';
+const ENDPOINT = 'https://api.openai.com/v1/chat/completions';
+class OpenAiProvider {
+    apiKey;
+    model;
+    name = 'openai';
+    isAi = true;
+    constructor(apiKey, model = DEFAULT_MODEL) {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async score(query, candidates) {
+        if (candidates.length === 0)
+            return [];
+        const items = candidates.map((c, i) => ({
+            idx: i,
+            id: c.id,
+            text: c.text.replace(/\s+/g, ' ').slice(0, 240)
+        }));
+        const prompt = [
+            'You score commit relevance to a developer query.',
+            'Return ONLY a JSON object {"scores":[{"idx":number,"score":number}]} with score in [0,1].',
+            `Query: ${query}`,
+            'Candidates:',
+            ...items.map((it) => `[${it.idx}] ${it.text}`)
+        ].join('\n');
+        const text = await this.call(prompt, 1024, true);
+        const parsed = parseScores(text, items.length);
+        return items.map((it) => ({ id: it.id, score: parsed[it.idx] ?? 0 }));
+    }
+    async summarize(text, opts) {
+        const prompt = [
+            opts?.hint ?? 'Summarize the following text in one short paragraph (max 3 sentences).',
+            '---',
+            text.length > 8000 ? text.slice(0, 8000) + '\n[truncated]' : text
+        ].join('\n');
+        const out = await this.call(prompt, 320, false);
+        return out.trim();
+    }
+    async call(prompt, maxTokens, json) {
+        const resp = await fetch(ENDPOINT, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`
+            },
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: maxTokens,
+                messages: [{ role: 'user', content: prompt }],
+                ...(json ? { response_format: { type: 'json_object' } } : {})
+            })
+        });
+        if (!resp.ok) {
+            const err = await resp.text().catch(() => '');
+            throw new Error(`openai ${resp.status}: ${err.slice(0, 200)}`);
+        }
+        const data = (await resp.json());
+        return data.choices?.[0]?.message?.content ?? '';
+    }
+}
+exports.OpenAiProvider = OpenAiProvider;
+function parseScores(raw, length) {
+    const result = {};
+    // Try {scores:[...]} first, then bare array.
+    let parsedArr = null;
+    try {
+        const obj = JSON.parse(raw);
+        if (Array.isArray(obj?.scores))
+            parsedArr = obj.scores;
+    }
+    catch {
+        /* fall through */
+    }
+    if (!parsedArr) {
+        const match = raw.match(/\[[\s\S]*\]/);
+        if (match) {
+            try {
+                parsedArr = JSON.parse(match[0]);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    if (!parsedArr)
+        return result;
+    for (const item of parsedArr) {
+        if (typeof item?.idx === 'number' && item.idx >= 0 && item.idx < length) {
+            const s = Number(item.score);
+            if (Number.isFinite(s))
+                result[item.idx] = Math.max(0, Math.min(1, s));
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=openaiProvider.js.map

package/dist/backend/llm/openaiProvider.js.map

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

package/dist/backend/llm/types.d.ts

@@ -0,0 +1,32 @@
+export type LlmProviderName = 'heuristic' | 'anthropic' | 'openai';
+export interface ScoreCandidate {
+    id: string;
+    text: string;
+}
+export interface ScoredCandidate {
+    id: string;
+    score: number;
+}
+export interface LlmService {
+    readonly name: LlmProviderName;
+    readonly isAi: boolean;
+    /**
+     * Re-rank candidates by semantic relevance to a query.
+     * Returns scores in [0,1]. Implementations MAY return a subset of inputs
+     * (heuristic returns a score for every input; AI providers may also do so).
+     */
+    score(query: string, candidates: ScoreCandidate[]): Promise<ScoredCandidate[]>;
+    /**
+     * Produce a short prose summary of an arbitrary block of text (typically
+     * a unified diff or commit message body). Hard cap output at ~600 chars.
+     */
+    summarize(text: string, opts?: {
+        hint?: string;
+    }): Promise<string>;
+}
+export interface LlmConfig {
+    provider?: LlmProviderName;
+    anthropicApiKey?: string;
+    openaiApiKey?: string;
+    model?: string;
+}

package/dist/backend/llm/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/backend/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/backend/llm/types.ts"],"names":[],"mappings":""}

package/dist/backend/search/datePhrase.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tiny dependency-free natural-language date phrase parser.
+ * Returns ISO date strings (YYYY-MM-DD) for `since`/`until` slots.
+ *
+ * Handles the common phrases users actually type:
+ *   - "last week" / "last month" / "last year"
+ *   - "this week" / "this month"
+ *   - "yesterday" / "today"
+ *   - "in the last 30 days" / "past 2 weeks" / "last 3 months"
+ *   - "since friday" / "since 2026-01-01"
+ *   - bare ISO dates pass through
+ */
+export interface DateRange {
+    since?: string;
+    until?: string;
+    matchedPhrase?: string;
+}
+export declare function parseDatePhrase(query: string, now?: Date): DateRange;
+/** Strip date-related phrases from the query so they don't pollute keyword search. */
+export declare function stripDatePhrase(query: string): string;

package/dist/backend/search/datePhrase.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Tiny dependency-free natural-language date phrase parser.
+ * Returns ISO date strings (YYYY-MM-DD) for `since`/`until` slots.
+ *
+ * Handles the common phrases users actually type:
+ *   - "last week" / "last month" / "last year"
+ *   - "this week" / "this month"
+ *   - "yesterday" / "today"
+ *   - "in the last 30 days" / "past 2 weeks" / "last 3 months"
+ *   - "since friday" / "since 2026-01-01"
+ *   - bare ISO dates pass through
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDatePhrase = parseDatePhrase;
+exports.stripDatePhrase = stripDatePhrase;
+const WEEKDAYS = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
+function parseDatePhrase(query, now = new Date()) {
+    const text = ' ' + query.toLowerCase() + ' ';
+    // "in the last N days/weeks/months/years" or "past N weeks" or "last 3 months"
+    const recent = text.match(/\b(?:in\s+the\s+)?(?:last|past)\s+(\d+)\s+(day|days|week|weeks|month|months|year|years)\b/);
+    if (recent) {
+        const n = parseInt(recent[1], 10);
+        const unit = recent[2];
+        const since = subtract(now, n, unit);
+        return { since: iso(since), matchedPhrase: recent[0].trim() };
+    }
+    // "last week"
+    if (/\blast\s+week\b/.test(text)) {
+        return { since: iso(subtract(now, 7, 'day')), matchedPhrase: 'last week' };
+    }
+    // "last month"
+    if (/\blast\s+month\b/.test(text)) {
+        return { since: iso(subtract(now, 30, 'day')), matchedPhrase: 'last month' };
+    }
+    // "last year"
+    if (/\blast\s+year\b/.test(text)) {
+        return { since: iso(subtract(now, 365, 'day')), matchedPhrase: 'last year' };
+    }
+    // "this week"
+    if (/\bthis\s+week\b/.test(text)) {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() - d.getUTCDay());
+        return { since: iso(d), matchedPhrase: 'this week' };
+    }
+    // "this month"
+    if (/\bthis\s+month\b/.test(text)) {
+        const d = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1));
+        return { since: iso(d), matchedPhrase: 'this month' };
+    }
+    // "yesterday"
+    if (/\byesterday\b/.test(text)) {
+        const d = subtract(now, 1, 'day');
+        return { since: iso(d), until: iso(d), matchedPhrase: 'yesterday' };
+    }
+    // "today"
+    if (/\btoday\b/.test(text)) {
+        return { since: iso(now), matchedPhrase: 'today' };
+    }
+    // "since <weekday>"
+    const sinceWd = text.match(/\bsince\s+(sunday|monday|tuesday|wednesday|thursday|friday|saturday)\b/);
+    if (sinceWd) {
+        const target = WEEKDAYS.indexOf(sinceWd[1]);
+        const cur = now.getUTCDay();
+        const diff = ((cur - target + 7) % 7) || 7;
+        return { since: iso(subtract(now, diff, 'day')), matchedPhrase: sinceWd[0] };
+    }
+    // "since <iso-date>" or "since <yyyy/mm/dd>"
+    const sinceIso = text.match(/\bsince\s+(\d{4}[-/]\d{1,2}[-/]\d{1,2})\b/);
+    if (sinceIso) {
+        return { since: normalizeDate(sinceIso[1]), matchedPhrase: sinceIso[0] };
+    }
+    // bare iso date in query
+    const bareIso = text.match(/\b(\d{4}-\d{2}-\d{2})\b/);
+    if (bareIso) {
+        return { since: bareIso[1], matchedPhrase: bareIso[1] };
+    }
+    return {};
+}
+function subtract(d, n, unit) {
+    const out = new Date(d);
+    if (unit.startsWith('day'))
+        out.setUTCDate(out.getUTCDate() - n);
+    else if (unit.startsWith('week'))
+        out.setUTCDate(out.getUTCDate() - 7 * n);
+    else if (unit.startsWith('month'))
+        out.setUTCMonth(out.getUTCMonth() - n);
+    else if (unit.startsWith('year'))
+        out.setUTCFullYear(out.getUTCFullYear() - n);
+    return out;
+}
+function iso(d) {
+    return d.toISOString().slice(0, 10);
+}
+function normalizeDate(s) {
+    return s.replace(/\//g, '-').split('-').map((p, i) => (i === 0 ? p : p.padStart(2, '0'))).join('-');
+}
+/** Strip date-related phrases from the query so they don't pollute keyword search. */
+function stripDatePhrase(query) {
+    const phrases = [
+        /\b(?:in\s+the\s+)?(?:last|past)\s+\d+\s+(?:day|days|week|weeks|month|months|year|years)\b/gi,
+        /\blast\s+(?:week|month|year)\b/gi,
+        /\bthis\s+(?:week|month)\b/gi,
+        /\b(?:yesterday|today)\b/gi,
+        /\bsince\s+(?:sunday|monday|tuesday|wednesday|thursday|friday|saturday)\b/gi,
+        /\bsince\s+\d{4}[-/]\d{1,2}[-/]\d{1,2}\b/gi
+    ];
+    let out = query;
+    for (const re of phrases)
+        out = out.replace(re, ' ');
+    return out.replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=datePhrase.js.map