@mneme-ai/core 0.8.3 → 0.9.0

package/dist/insights/suggest.js.map

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

package/dist/insights/suggest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=suggest.test.d.ts.map

package/dist/insights/suggest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.test.d.ts","sourceRoot":"","sources":["../../src/insights/suggest.test.ts"],"names":[],"mappings":""}

package/dist/insights/suggest.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from "vitest";
+import { suggestFollowUps, extractTopicWord } from "./suggest.js";
+const cmt = (hash, subject, author = "alice", files = []) => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: author,
+    authorEmail: `${author}@example.com`,
+    authorDate: "2024-08-12T00:00:00Z",
+    committerDate: "2024-08-12T00:00:00Z",
+    subject,
+    body: "",
+    parents: [],
+    files,
+});
+const result = (hash, score, files = []) => ({
+    commit: cmt(hash, "subj", "alice", files),
+    score,
+    matchedChunks: [],
+});
+describe("extractTopicWord", () => {
+    it("returns camelCase identifier when present", () => {
+        expect(extractTopicWord("why does parseAmount throw?")).toBe("parseAmount");
+    });
+    it("returns path-like token when present", () => {
+        expect(extractTopicWord("what about src/payment changes?")).toBe("src/payment");
+    });
+    it("returns the longest meaningful word otherwise", () => {
+        expect(extractTopicWord("why is authentication broken")).toBe("authentication");
+    });
+    it("filters stop-words and code-noise words", () => {
+        // 'the', 'how', 'does', 'use' filtered → longest remaining is "function"
+        expect(extractTopicWord("how does the function use this")).toBe("function");
+    });
+    it("returns undefined when nothing concrete remains", () => {
+        expect(extractTopicWord("why")).toBeUndefined();
+        expect(extractTopicWord("the and or")).toBeUndefined();
+    });
+});
+describe("suggestFollowUps", () => {
+    it("returns no suggestions when results are empty", () => {
+        expect(suggestFollowUps("anything", [])).toEqual([]);
+    });
+    it("suggests `mneme why <file>` when top result has files", () => {
+        const out = suggestFollowUps("why does X exist?", [result("a", 0.05, ["src/payment.ts"])]);
+        expect(out.find((s) => s.command.startsWith("mneme why"))).toBeDefined();
+    });
+    it("suggests `mneme story <topic>` when topic word is extractable", () => {
+        const out = suggestFollowUps("how does authentication work?", [result("a", 0.05)]);
+        expect(out.find((s) => s.command.startsWith("mneme story"))).toBeDefined();
+    });
+    it("suggests `mneme who-knows <topic>` with the topic", () => {
+        const out = suggestFollowUps("authentication question", [result("a", 0.05)]);
+        expect(out.find((s) => s.command.startsWith("mneme who-knows"))).toBeDefined();
+    });
+    it("suggests `mneme blast <commit>` when there are 2+ results", () => {
+        const out = suggestFollowUps("auth", [result("abc1234", 0.05), result("def5678", 0.04)]);
+        expect(out.find((s) => s.command.includes("blast"))).toBeDefined();
+    });
+    it("caps suggestions at 3", () => {
+        const out = suggestFollowUps("authentication question", [result("abc1234", 0.05, ["src/auth.ts"]), result("def5678", 0.04)]);
+        expect(out.length).toBeLessThanOrEqual(3);
+    });
+    it("every suggestion has a non-empty command and reason", () => {
+        const out = suggestFollowUps("stripe webhook bigint", [result("a", 0.05, ["src/webhook.ts"]), result("b", 0.04)]);
+        for (const s of out) {
+            expect(s.command.length).toBeGreaterThan(5);
+            expect(s.reason.length).toBeGreaterThan(10);
+        }
+    });
+});
+//# sourceMappingURL=suggest.test.js.map

package/dist/insights/suggest.test.js.map

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

package/dist/insights/who-knows.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `who-knows` — surface the people most likely to answer a question about
+ * a topic, ranked by their git activity on commits/files matching that topic.
+ *
+ * Why this exists: every team has tribal knowledge. "Ask alice about Stripe"
+ * is institutional memory. Mneme already indexes commits — making the
+ * institutional memory queryable is a small step from the engine the project
+ * already has.
+ *
+ * Scoring is intentionally simple and explainable. We avoid any "rank by
+ * cosine similarity of author embedding" trickery: this is a counting
+ * problem, and the user should be able to verify by running `git log
+ * --author=alice -- <files>`.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+export interface ExpertCandidate {
+    /** Author name as it appears in git. */
+    name: string;
+    email: string;
+    /** Number of commits authored that match the topic. */
+    commitCount: number;
+    /** Last commit author-date in ISO; lets the caller flag stale experts. */
+    lastTouch: string;
+    /** Distinct files touched (capped at 1000 for memory hygiene). */
+    filesTouched: number;
+    /** Score: log(commits + 1) × recency bonus. Higher = more authoritative. */
+    score: number;
+    /** Tier label derived from score + recency. */
+    tier: "definitive" | "active" | "stale" | "occasional";
+}
+export interface WhoKnowsOptions {
+    topic: string;
+    /** Cap on candidates returned (default 5). */
+    topN?: number;
+    /** ISO date — ignore commits older than this for the recency bonus. */
+    since?: string;
+    /** Today, in ISO format. Lets tests inject a deterministic clock. */
+    now?: Date;
+}
+/**
+ * Find people likely to know about `topic`. Searches commit messages,
+ * subjects, bodies, and PR titles via FTS, then aggregates by author.
+ */
+export declare function whoKnows(store: MnemeStore, opts: WhoKnowsOptions): ExpertCandidate[];
+/** log-based commit weight × recency multiplier. Pure function, easy to test. */
+export declare function scoreCandidate(commitCount: number, lastTouchIso: string, now: Date): number;
+export declare function tierOf(commitCount: number, lastTouchIso: string, now: Date): ExpertCandidate["tier"];
+//# sourceMappingURL=who-knows.d.ts.map

package/dist/insights/who-knows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-knows.d.ts","sourceRoot":"","sources":["../../src/insights/who-knows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;CACxD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAKD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,GAAG,eAAe,EAAE,CA6DpF;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAQ3F;AAED,wBAAgB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAOpG"}

package/dist/insights/who-knows.js

@@ -0,0 +1,96 @@
+/**
+ * `who-knows` — surface the people most likely to answer a question about
+ * a topic, ranked by their git activity on commits/files matching that topic.
+ *
+ * Why this exists: every team has tribal knowledge. "Ask alice about Stripe"
+ * is institutional memory. Mneme already indexes commits — making the
+ * institutional memory queryable is a small step from the engine the project
+ * already has.
+ *
+ * Scoring is intentionally simple and explainable. We avoid any "rank by
+ * cosine similarity of author embedding" trickery: this is a counting
+ * problem, and the user should be able to verify by running `git log
+ * --author=alice -- <files>`.
+ */
+const STALE_DAYS = 180;
+const ACTIVE_DAYS = 90;
+/**
+ * Find people likely to know about `topic`. Searches commit messages,
+ * subjects, bodies, and PR titles via FTS, then aggregates by author.
+ */
+export function whoKnows(store, opts) {
+    const topN = opts.topN ?? 5;
+    const now = opts.now ?? new Date();
+    // Pull commits whose chunks match the topic via FTS.
+    const ftsHits = store.ftsSearch(opts.topic, 200);
+    if (ftsHits.length === 0)
+        return [];
+    // Aggregate by commit hash (one chunk per commit can appear multiple times).
+    const commitHashes = new Set(ftsHits.map((h) => h.commitHash));
+    const buckets = new Map();
+    for (const hash of commitHashes) {
+        const c = store.getCommit(hash);
+        if (!c)
+            continue;
+        if (opts.since && c.authorDate < opts.since)
+            continue;
+        const key = `${c.authorName}|${c.authorEmail}`;
+        if (!buckets.has(key)) {
+            buckets.set(key, {
+                name: c.authorName,
+                email: c.authorEmail,
+                commitCount: 0,
+                lastTouch: c.authorDate,
+                files: new Set(),
+            });
+        }
+        const b = buckets.get(key);
+        b.commitCount += 1;
+        if (c.authorDate > b.lastTouch)
+            b.lastTouch = c.authorDate;
+        for (const f of (c.files ?? []).slice(0, 50))
+            b.files.add(f);
+        if (b.files.size > 1000) {
+            // Hygiene cap — extremely active authors on huge repos.
+            const arr = [...b.files];
+            b.files = new Set(arr.slice(0, 1000));
+        }
+    }
+    const candidates = [];
+    for (const b of buckets.values()) {
+        const score = scoreCandidate(b.commitCount, b.lastTouch, now);
+        candidates.push({
+            name: b.name,
+            email: b.email,
+            commitCount: b.commitCount,
+            lastTouch: b.lastTouch,
+            filesTouched: b.files.size,
+            score,
+            tier: tierOf(b.commitCount, b.lastTouch, now),
+        });
+    }
+    candidates.sort((a, b) => b.score - a.score);
+    return candidates.slice(0, topN);
+}
+/** log-based commit weight × recency multiplier. Pure function, easy to test. */
+export function scoreCandidate(commitCount, lastTouchIso, now) {
+    const lastTouch = new Date(lastTouchIso);
+    const daysAgo = Math.max(0, (now.getTime() - lastTouch.getTime()) / (1000 * 60 * 60 * 24));
+    // Recency bonus: 1.0 within 30 days, decays linearly to 0.3 at 365 days, then floor 0.3.
+    const recency = daysAgo < 30 ? 1.0 : Math.max(0.3, 1.0 - (daysAgo - 30) / 480);
+    // Volume: log scale to avoid one mega-contributor dominating.
+    const volume = Math.log2(commitCount + 1);
+    return volume * recency;
+}
+export function tierOf(commitCount, lastTouchIso, now) {
+    const lastTouch = new Date(lastTouchIso);
+    const daysAgo = (now.getTime() - lastTouch.getTime()) / (1000 * 60 * 60 * 24);
+    if (commitCount >= 10 && daysAgo <= ACTIVE_DAYS)
+        return "definitive";
+    if (commitCount >= 3 && daysAgo <= ACTIVE_DAYS)
+        return "active";
+    if (daysAgo > STALE_DAYS)
+        return "stale";
+    return "occasional";
+}
+//# sourceMappingURL=who-knows.js.map

package/dist/insights/who-knows.js.map

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

package/dist/insights/who-knows.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=who-knows.test.d.ts.map

package/dist/insights/who-knows.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who-knows.test.d.ts","sourceRoot":"","sources":["../../src/insights/who-knows.test.ts"],"names":[],"mappings":""}

package/dist/insights/who-knows.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect } from "vitest";
+import { scoreCandidate, tierOf } from "./who-knows.js";
+const today = new Date("2026-05-04T00:00:00Z");
+const daysAgo = (n) => new Date(today.getTime() - n * 86_400_000).toISOString();
+describe("scoreCandidate — pure scoring function", () => {
+    it("returns 0 for zero commits", () => {
+        expect(scoreCandidate(0, daysAgo(0), today)).toBe(0);
+    });
+    it("recent commits score higher than old commits with the same count", () => {
+        const recent = scoreCandidate(10, daysAgo(5), today);
+        const old = scoreCandidate(10, daysAgo(300), today);
+        expect(recent).toBeGreaterThan(old);
+    });
+    it("more commits score higher than fewer with the same recency", () => {
+        const more = scoreCandidate(50, daysAgo(10), today);
+        const fewer = scoreCandidate(5, daysAgo(10), today);
+        expect(more).toBeGreaterThan(fewer);
+    });
+    it("uses log-scale volume — 100 commits is not 100× more than 1 commit", () => {
+        const one = scoreCandidate(1, daysAgo(0), today);
+        const hundred = scoreCandidate(100, daysAgo(0), today);
+        // log2(101) ≈ 6.66, log2(2) = 1 → hundred / one ≈ 6.66, NOT 100.
+        expect(hundred / one).toBeLessThan(10);
+    });
+    it("recency floors at 0.3 even for very old commits", () => {
+        const ancient = scoreCandidate(10, daysAgo(2000), today);
+        const oneYear = scoreCandidate(10, daysAgo(365), today);
+        // Both should be at or near the floor.
+        expect(ancient).toBeGreaterThan(0);
+        expect(oneYear).toBeGreaterThan(0);
+    });
+});
+describe("tierOf — readable expert tier", () => {
+    it('"definitive" for many recent commits', () => {
+        expect(tierOf(20, daysAgo(10), today)).toBe("definitive");
+    });
+    it('"active" for moderate recent commits', () => {
+        expect(tierOf(5, daysAgo(20), today)).toBe("active");
+    });
+    it('"stale" for any volume but very old', () => {
+        expect(tierOf(100, daysAgo(300), today)).toBe("stale");
+    });
+    it('"occasional" — middle ground (≥1 commit, < ACTIVE_DAYS old, but few)', () => {
+        expect(tierOf(1, daysAgo(40), today)).toBe("occasional");
+    });
+});
+//# sourceMappingURL=who-knows.test.js.map

package/dist/insights/who-knows.test.js.map

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

package/dist/retrieve/index.d.ts

@@ -1,3 +1,5 @@
 export * from "./search.js";
 export * from "./rerank.js";
+export * from "./intent.js";
+export * from "./synthesize.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/retrieve/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/retrieve/index.js

@@ -1,3 +1,5 @@
 export * from "./search.js";
 export * from "./rerank.js";
+export * from "./intent.js";
+export * from "./synthesize.js";
 //# sourceMappingURL=index.js.map

package/dist/retrieve/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/retrieve/intent.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Query intent classifier.
+ *
+ * Mneme is designed for SPECIFIC questions ("why does X exist?", "when did Y
+ * change?"). It's not a code-review oracle and not a general-purpose chatbot.
+ * When users ask vague questions ("how to improve my code", "what's wrong"),
+ * the right move is to redirect them BEFORE retrieval — pretending to answer
+ * with low-confidence results is dishonest.
+ *
+ * Classification is regex-based on purpose:
+ *   - Deterministic, runs in microseconds, no LLM needed
+ *   - User-overridable: flags exist for "trust me, just retrieve"
+ *   - Falsifiable: every signal is a documented heuristic, not a black box
+ */
+export type Intent = "specific" | "lookup" | "temporal" | "vague";
+export interface IntentResult {
+    intent: Intent;
+    /** Why this classification was chosen — for transparency / debugging. */
+    reason: string;
+    /**
+     * If intent === "vague", a redirect message to show the user instead of
+     * running retrieval. Empty for other intents.
+     */
+    redirect?: string;
+}
+/**
+ * Classify a query's intent. Order matters: lookup and temporal patterns are
+ * checked BEFORE vague patterns, so "who wrote how-to-do-x.md" is classified
+ * as a lookup, not a vague query.
+ */
+export declare function classifyIntent(query: string): IntentResult;
+//# sourceMappingURL=intent.d.ts.map

package/dist/retrieve/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/retrieve/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,MAAM,GACd,UAAU,GACV,QAAQ,GACR,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoDD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAwC1D"}

package/dist/retrieve/intent.js

@@ -0,0 +1,104 @@
+/**
+ * Query intent classifier.
+ *
+ * Mneme is designed for SPECIFIC questions ("why does X exist?", "when did Y
+ * change?"). It's not a code-review oracle and not a general-purpose chatbot.
+ * When users ask vague questions ("how to improve my code", "what's wrong"),
+ * the right move is to redirect them BEFORE retrieval — pretending to answer
+ * with low-confidence results is dishonest.
+ *
+ * Classification is regex-based on purpose:
+ *   - Deterministic, runs in microseconds, no LLM needed
+ *   - User-overridable: flags exist for "trust me, just retrieve"
+ *   - Falsifiable: every signal is a documented heuristic, not a black box
+ */
+/** Trigger phrases for vague queries. Listed by frequency in real misuse. */
+const VAGUE_PATTERNS = [
+    { re: /\bhow\s+to\b/i, reason: '"how to" — Mneme indexes history, not best-practices' },
+    { re: /\b(best|good)\s+(practice|practices|way)s?\b/i, reason: 'asks for best practice — not a history question' },
+    { re: /\b(improve|optimize|refactor|review)\s+(my|the|this)\s+code\b/i, reason: 'general code-improvement request' },
+    { re: /\bshould\s+i\b/i, reason: '"should I" — opinion, not memory' },
+    { re: /\bcan\s+you\s+(write|generate|create)\b/i, reason: 'asks Mneme to generate code — out of scope' },
+    { re: /^(help|hello|hi|test)\s*$/i, reason: 'greeting / smoke-test, not a real question' },
+    { re: /\bwhat\s+is\s+(the\s+)?(meaning|point)\s+of\s+(life|this)\b/i, reason: 'philosophical' },
+];
+/** Lookup: question is about a specific person, hash, or PR number. */
+const LOOKUP_PATTERNS = [
+    { re: /\bwho\s+(wrote|made|created|authored|added)\b/i, reason: 'who-question — author lookup' },
+    { re: /\bwhat\s+did\s+\S+\s+(do|change|commit|write)\b/i, reason: 'asks what a person did — author lookup' },
+    { re: /\bPR\s*#?\d+\b/i, reason: 'specific PR reference' },
+    { re: /\b[a-f0-9]{7,40}\b/, reason: 'commit hash reference' },
+];
+/** Temporal: question asks about time, dates, or change-over-time. */
+const TEMPORAL_PATTERNS = [
+    { re: /\bwhen\s+(did|was|will)\b/i, reason: 'when-question — timeline query' },
+    { re: /\b(last|recent|latest|previous|first|earliest)\s+(commit|change|update|time)\b/i, reason: 'temporal modifier' },
+    { re: /\b(yesterday|today|last\s+(week|month|year|quarter))\b/i, reason: 'relative time reference' },
+    { re: /\b(20\d{2})-(0[1-9]|1[0-2])\b/, reason: 'absolute date reference (YYYY-MM)' },
+];
+/** Specific: WHY/WHAT/HOW questions about a concrete thing. */
+const SPECIFIC_PATTERNS = [
+    { re: /\bwhy\s+(does|did|do|is|are|was|were)\b/i, reason: 'why-question with concrete subject' },
+    { re: /\bwhat\s+(does|did|do|is|are)\b/i, reason: 'what-question (concrete)' },
+    { re: /\bhow\s+(does|did|do|is|are)\b/i, reason: 'how-question (about behavior, not advice)' },
+];
+/** Words that, if PRESENT, suggest concreteness even for "how to" patterns. */
+const CONCRETE_HINTS = /(\.[a-z]+\b|::|\bsrc\/|\b[A-Z][a-zA-Z]{2,}[A-Z][a-z]|\bfunction\s+\w+|\bclass\s+\w+|\bmodule\s+\w+|\bPR\s*#?\d+)/;
+const VAGUE_REDIRECT_TEMPLATE = [
+    'I work best with specific questions about your repo\'s history.',
+    'Try one of these instead:',
+    '',
+    '  • "why does <function or pattern> exist?"',
+    '  • "when did we change <module>?"',
+    '  • "who wrote <file>?"',
+    '  • "what does <commit hash> do?"',
+    '',
+    'For general code improvement advice, use a chat assistant — Mneme is the',
+    'memory layer that feeds those tools, not a substitute for them.',
+].join('\n');
+/**
+ * Classify a query's intent. Order matters: lookup and temporal patterns are
+ * checked BEFORE vague patterns, so "who wrote how-to-do-x.md" is classified
+ * as a lookup, not a vague query.
+ */
+export function classifyIntent(query) {
+    const q = query.trim();
+    if (!q) {
+        return { intent: "vague", reason: "empty query", redirect: VAGUE_REDIRECT_TEMPLATE };
+    }
+    // 1. Lookup patterns win — questions about a specific person/hash/PR are
+    //    always specific enough to retrieve.
+    for (const p of LOOKUP_PATTERNS) {
+        if (p.re.test(q))
+            return { intent: "lookup", reason: p.reason };
+    }
+    // 2. Temporal patterns — when-questions and date references.
+    for (const p of TEMPORAL_PATTERNS) {
+        if (p.re.test(q))
+            return { intent: "temporal", reason: p.reason };
+    }
+    // 3. Vague patterns — but only fire if the query has NO concrete hint.
+    for (const p of VAGUE_PATTERNS) {
+        if (p.re.test(q) && !CONCRETE_HINTS.test(q)) {
+            return { intent: "vague", reason: p.reason, redirect: VAGUE_REDIRECT_TEMPLATE };
+        }
+    }
+    // 4. Specific question patterns.
+    for (const p of SPECIFIC_PATTERNS) {
+        if (p.re.test(q))
+            return { intent: "specific", reason: p.reason };
+    }
+    // 5. Default: short queries (< 4 words) treated as keyword search → specific;
+    //    long unstructured queries → vague.
+    const wordCount = q.split(/\s+/).length;
+    if (wordCount <= 6)
+        return { intent: "specific", reason: "short keyword-style query" };
+    if (CONCRETE_HINTS.test(q))
+        return { intent: "specific", reason: "contains concrete identifier (file, class, PR)" };
+    return {
+        intent: "vague",
+        reason: "long query with no concrete identifier or specific question pattern",
+        redirect: VAGUE_REDIRECT_TEMPLATE,
+    };
+}
+//# sourceMappingURL=intent.js.map

package/dist/retrieve/intent.js.map

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

package/dist/retrieve/intent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=intent.test.d.ts.map

package/dist/retrieve/intent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.test.d.ts","sourceRoot":"","sources":["../../src/retrieve/intent.test.ts"],"names":[],"mappings":""}

package/dist/retrieve/intent.test.js

@@ -0,0 +1,106 @@
+import { describe, it, expect } from "vitest";
+import { classifyIntent } from "./intent.js";
+describe("classifyIntent — vague queries (the regression we are fixing)", () => {
+    it('classifies "how to improve my code" as vague', () => {
+        const r = classifyIntent("how to improve my code");
+        expect(r.intent).toBe("vague");
+        expect(r.redirect).toBeDefined();
+        expect(r.redirect).toContain("specific");
+    });
+    it('classifies "best practice for X" as vague when X is generic', () => {
+        expect(classifyIntent("best practice for naming things").intent).toBe("vague");
+        expect(classifyIntent("what is a good way to write tests").intent).toBe("vague");
+    });
+    it('classifies "should I X" as vague (opinion request)', () => {
+        expect(classifyIntent("should I refactor this module").intent).toBe("vague");
+    });
+    it("classifies greetings and smoke tests as vague", () => {
+        expect(classifyIntent("hello").intent).toBe("vague");
+        expect(classifyIntent("test").intent).toBe("vague");
+        expect(classifyIntent("help").intent).toBe("vague");
+    });
+    it("classifies empty string as vague", () => {
+        expect(classifyIntent("").intent).toBe("vague");
+        expect(classifyIntent("    ").intent).toBe("vague");
+    });
+    it("vague results include a redirect message that mentions specific question forms", () => {
+        const r = classifyIntent("how to write good code");
+        expect(r.redirect).toMatch(/why does/);
+        expect(r.redirect).toMatch(/when did/);
+        expect(r.redirect).toMatch(/who wrote/);
+    });
+});
+describe("classifyIntent — specific (the happy path)", () => {
+    it('classifies "why does X exist?" as specific', () => {
+        expect(classifyIntent("why does parseAmount use try/catch?").intent).toBe("specific");
+    });
+    it('classifies "what does X do?" as specific', () => {
+        expect(classifyIntent("what does the OrderQueue worker do?").intent).toBe("specific");
+    });
+    it('classifies "how does X work?" as specific (behavior question)', () => {
+        expect(classifyIntent("how does the auth middleware work?").intent).toBe("specific");
+    });
+    it("classifies short keyword queries as specific", () => {
+        expect(classifyIntent("stripe webhook bigint").intent).toBe("specific");
+        expect(classifyIntent("auth jwt").intent).toBe("specific");
+    });
+});
+describe("classifyIntent — lookup (author / hash / PR queries)", () => {
+    it('classifies "who wrote X" as lookup', () => {
+        expect(classifyIntent("who wrote the OrderQueue worker?").intent).toBe("lookup");
+        expect(classifyIntent("who created src/payment.ts").intent).toBe("lookup");
+    });
+    it("classifies PR-number references as lookup", () => {
+        expect(classifyIntent("PR #482").intent).toBe("lookup");
+        expect(classifyIntent("explain pr #1234").intent).toBe("lookup");
+    });
+    it("classifies commit-hash references as lookup", () => {
+        expect(classifyIntent("a1b2c3d4 what did this do").intent).toBe("lookup");
+        expect(classifyIntent("abcdef1 changes").intent).toBe("lookup");
+    });
+});
+describe("classifyIntent — temporal (timeline / date queries)", () => {
+    it('classifies "when did X" as temporal', () => {
+        expect(classifyIntent("when did we change the auth middleware?").intent).toBe("temporal");
+    });
+    it('classifies relative-time queries as temporal', () => {
+        expect(classifyIntent("what changed last week").intent).toBe("temporal");
+        expect(classifyIntent("commits from last month on payment").intent).toBe("temporal");
+    });
+    it('classifies absolute YYYY-MM dates as temporal', () => {
+        expect(classifyIntent("auth changes in 2024-09").intent).toBe("temporal");
+    });
+    it("classifies superlative-time queries as temporal", () => {
+        expect(classifyIntent("latest commit on stripe").intent).toBe("temporal");
+        expect(classifyIntent("first time we used JWT").intent).toBe("temporal");
+    });
+});
+describe("classifyIntent — concrete-hint override (vague pattern + concrete identifier)", () => {
+    it('"how to refactor src/payment.ts" is specific despite "how to" (has file path)', () => {
+        expect(classifyIntent("how to refactor src/payment.ts").intent).toBe("specific");
+    });
+    it("'best way to call PaymentService' is specific (CamelCase identifier)", () => {
+        expect(classifyIntent("best way to call PaymentService").intent).toBe("specific");
+    });
+    it("'how to use PR #482' is lookup (PR reference takes priority)", () => {
+        expect(classifyIntent("how to use PR #482").intent).toBe("lookup");
+    });
+});
+describe("classifyIntent — every result has a non-empty reason for transparency", () => {
+    it("returns a reason string for every intent class", () => {
+        const samples = [
+            "how to improve",
+            "why does X exist",
+            "who wrote Y",
+            "when did Z change",
+            "stripe bigint webhook",
+            "",
+        ];
+        for (const q of samples) {
+            const r = classifyIntent(q);
+            expect(typeof r.reason).toBe("string");
+            expect(r.reason.length).toBeGreaterThan(5);
+        }
+    });
+});
+//# sourceMappingURL=intent.test.js.map

package/dist/retrieve/intent.test.js.map

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