@jamesaphoenix/tx-core 0.4.1

package/dist/services/query-expansion-service.js

@@ -0,0 +1,174 @@
+import { Context, Effect, Layer, Config, Option } from "effect";
+import { Data } from "effect";
+/**
+ * Error indicating query expansion is unavailable.
+ */
+export class QueryExpansionUnavailableError extends Data.TaggedError("QueryExpansionUnavailableError") {
+    get message() {
+        return `Query expansion unavailable: ${this.reason}`;
+    }
+}
+/**
+ * QueryExpansionService uses an LLM to generate alternative phrasings of search queries.
+ * This improves recall by searching for semantically equivalent but differently worded queries.
+ *
+ * Design: Following DD-006 patterns for LLM integration.
+ * The service gracefully degrades when ANTHROPIC_API_KEY is not set.
+ */
+export class QueryExpansionService extends Context.Tag("QueryExpansionService")() {
+}
+/**
+ * The prompt template for query expansion.
+ * Designed to generate concise, search-optimized alternative queries.
+ */
+const EXPANSION_PROMPT = `You are a search query expansion assistant. Given a search query, generate 2-3 alternative phrasings that capture the same intent but use different words or perspectives.
+
+Rules:
+1. Keep alternatives concise (similar length to original)
+2. Use synonyms and related terminology
+3. Consider different ways to express the same concept
+4. Do NOT add information not implied by the original query
+5. Output ONLY a JSON array of strings, nothing else
+
+Example:
+Input: "fix authentication bug"
+Output: ["resolve auth issue", "debug login problem", "authentication error fix"]
+
+Input: "add user profile page"
+Output: ["create profile view", "implement user account page", "build profile screen"]
+
+Now expand this query:
+`;
+/**
+ * Parse LLM JSON response, handling common formatting issues.
+ * Robust parser from DD-006.
+ */
+const parseLlmJson = (raw) => {
+    // Step 1: Try direct parse
+    try {
+        return JSON.parse(raw);
+    }
+    catch { /* continue */ }
+    // Step 2: Strip markdown code fences
+    const fenceMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
+    if (fenceMatch && fenceMatch[1]) {
+        try {
+            return JSON.parse(fenceMatch[1].trim());
+        }
+        catch { /* continue */ }
+    }
+    // Step 3: Find first [ or { and parse from there
+    const jsonStart = raw.search(/[[{]/);
+    if (jsonStart >= 0) {
+        const candidate = raw.slice(jsonStart);
+        try {
+            return JSON.parse(candidate);
+        }
+        catch { /* continue */ }
+        // Step 4: Find matching bracket and extract
+        const openChar = candidate[0];
+        const closeChar = openChar === "[" ? "]" : "}";
+        const lastClose = candidate.lastIndexOf(closeChar);
+        if (lastClose > 0) {
+            try {
+                return JSON.parse(candidate.slice(0, lastClose + 1));
+            }
+            catch { /* continue */ }
+        }
+    }
+    return null;
+};
+/**
+ * Noop implementation - returns original query only.
+ * Used when ANTHROPIC_API_KEY is not set or LLM features are disabled.
+ */
+export const QueryExpansionServiceNoop = Layer.succeed(QueryExpansionService, {
+    expand: (query) => Effect.succeed({
+        original: query,
+        expanded: [query],
+        wasExpanded: false
+    }),
+    isAvailable: () => Effect.succeed(false)
+});
+/**
+ * Live implementation using Anthropic Claude API.
+ * Lazy-loads the SDK and caches the client.
+ */
+export const QueryExpansionServiceLive = Layer.effect(QueryExpansionService, Effect.gen(function* () {
+    // Read API key from environment
+    const apiKey = yield* Config.string("ANTHROPIC_API_KEY").pipe(Effect.mapError(() => new QueryExpansionUnavailableError({
+        reason: "ANTHROPIC_API_KEY environment variable is not set"
+    })));
+    // Lazy-load client
+    let client = null;
+    const ensureClient = Effect.gen(function* () {
+        if (client)
+            return client;
+        // Dynamic import of Anthropic SDK (optional peer dependency)
+        const Anthropic = yield* Effect.tryPromise({
+            try: async () => {
+                // @ts-expect-error - @anthropic-ai/sdk is an optional peer dependency
+                const mod = await import("@anthropic-ai/sdk");
+                return mod.default;
+            },
+            catch: () => new QueryExpansionUnavailableError({
+                reason: "@anthropic-ai/sdk is not installed"
+            })
+        });
+        client = new Anthropic({ apiKey });
+        return client;
+    });
+    return {
+        expand: (query) => Effect.gen(function* () {
+            const anthropic = yield* ensureClient;
+            const response = yield* Effect.tryPromise({
+                try: () => anthropic.messages.create({
+                    model: "claude-haiku-4-20250514",
+                    max_tokens: 256,
+                    messages: [{
+                            role: "user",
+                            content: EXPANSION_PROMPT + JSON.stringify(query)
+                        }]
+                }),
+                catch: (e) => new QueryExpansionUnavailableError({
+                    reason: `API call failed: ${String(e)}`
+                })
+            });
+            // Extract text from response
+            const textContent = response.content.find(c => c.type === "text");
+            if (!textContent || !textContent.text) {
+                return { original: query, expanded: [query], wasExpanded: false };
+            }
+            // Parse the JSON array of expanded queries
+            const alternatives = parseLlmJson(textContent.text);
+            if (!alternatives || !Array.isArray(alternatives)) {
+                return { original: query, expanded: [query], wasExpanded: false };
+            }
+            // Filter out empty strings and duplicates
+            const uniqueAlternatives = [...new Set(alternatives
+                    .filter((alt) => typeof alt === "string" && alt.trim().length > 0)
+                    .map(alt => alt.trim()))];
+            // Always include original query first
+            const expanded = [query, ...uniqueAlternatives.filter(alt => alt.toLowerCase() !== query.toLowerCase())];
+            return {
+                original: query,
+                expanded,
+                wasExpanded: true
+            };
+        }),
+        isAvailable: () => Effect.succeed(true)
+    };
+}));
+/**
+ * Auto-detecting layer that uses Live if ANTHROPIC_API_KEY is set, Noop otherwise.
+ * This allows graceful degradation when the API key is not configured.
+ */
+export const QueryExpansionServiceAuto = Layer.unwrapEffect(Effect.gen(function* () {
+    // Check if API key is available
+    const apiKey = yield* Config.string("ANTHROPIC_API_KEY").pipe(Effect.option);
+    if (Option.isSome(apiKey) && apiKey.value.trim().length > 0) {
+        return QueryExpansionServiceLive;
+    }
+    return QueryExpansionServiceNoop;
+}));
+//# sourceMappingURL=query-expansion-service.js.map

package/dist/services/query-expansion-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-expansion-service.js","sourceRoot":"","sources":["../../src/services/query-expansion-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE7B;;GAEG;AACH,MAAM,OAAO,8BAA+B,SAAQ,IAAI,CAAC,WAAW,CAAC,gCAAgC,CAEnG;IACA,IAAI,OAAO;QACT,OAAO,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAA;IACtD,CAAC;CACF;AA6BD;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAQ5E;CAAG;AAEN;;;GAGG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAA;AAED;;;GAGG;AACH,MAAM,YAAY,GAAG,CAAI,GAAW,EAAY,EAAE;IAChD,2BAA2B;IAC3B,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;IAEvD,qCAAqC;IACrC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAC/D,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;IAC1E,CAAC;IAED,iDAAiD;IACjD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACtC,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAE7D,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,SAAS,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QAC9C,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;QAClD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC;gBAAC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC,OAAO,CACpD,qBAAqB,EACrB;IACE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,WAAW,EAAE,KAAK;KACnB,CAAC;IACF,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;CACzC,CACF,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC,MAAM,CACnD,qBAAqB,EACrB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,gCAAgC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,8BAA8B,CAAC;QACvD,MAAM,EAAE,mDAAmD;KAC5D,CAAC,CAAC,CACJ,CAAA;IAED,mBAAmB;IACnB,IAAI,MAAM,GAA2B,IAAI,CAAA;IAEzC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,6DAA6D;QAC7D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACzC,GAAG,EAAE,KAAK,IAAI,EAAE;gBACd,sEAAsE;gBACtE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;gBAC7C,OAAO,GAAG,CAAC,OAAO,CAAA;YACpB,CAAC;YACD,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,8BAA8B,CAAC;gBAC9C,MAAM,EAAE,oCAAoC;aAC7C,CAAC;SACH,CAAC,CAAA;QAEF,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAA+B,CAAA;QAChE,OAAO,MAAM,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAChB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,YAAY,CAAA;YAErC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBACxC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACnC,KAAK,EAAE,yBAAyB;oBAChC,UAAU,EAAE,GAAG;oBACf,QAAQ,EAAE,CAAC;4BACT,IAAI,EAAE,MAAM;4BACZ,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;yBAClD,CAAC;iBACH,CAAC;gBACF,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,8BAA8B,CAAC;oBAC/C,MAAM,EAAE,oBAAoB,MAAM,CAAC,CAAC,CAAC,EAAE;iBACxC,CAAC;aACH,CAAC,CAAA;YAEF,6BAA6B;YAC7B,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;YACjE,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;gBACtC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAA;YACnE,CAAC;YAED,2CAA2C;YAC3C,MAAM,YAAY,GAAG,YAAY,CAAW,WAAW,CAAC,IAAI,CAAC,CAAA;YAC7D,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAA;YACnE,CAAC;YAED,0CAA0C;YAC1C,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,CACpC,YAAY;qBACT,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;qBAChF,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAC1B,CAAC,CAAA;YAEF,sCAAsC;YACtC,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;YAExG,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ;gBACR,WAAW,EAAE,IAAI;aAClB,CAAA;QACH,CAAC,CAAC;QAEJ,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACxC,CAAA;AACH,CAAC,CAAC,CACH,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC,YAAY,CACzD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,gCAAgC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAE5E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,yBAAyB,CAAA;IAClC,CAAC;IACD,OAAO,yBAAyB,CAAA;AAClC,CAAC,CAAC,CACH,CAAA"}

package/dist/services/ready-service.d.ts

@@ -0,0 +1,16 @@
+import { Context, Effect, Layer } from "effect";
+import { TaskRepository } from "../repo/task-repo.js";
+import { DependencyRepository } from "../repo/dep-repo.js";
+import { DatabaseError } from "../errors.js";
+import type { Task, TaskId, TaskWithDeps } from "@jamesaphoenix/tx-types";
+declare const ReadyService_base: Context.TagClass<ReadyService, "ReadyService", {
+    readonly getReady: (limit?: number) => Effect.Effect<readonly TaskWithDeps[], DatabaseError>;
+    readonly isReady: (id: TaskId) => Effect.Effect<boolean, DatabaseError>;
+    readonly getBlockers: (id: TaskId) => Effect.Effect<readonly Task[], DatabaseError>;
+    readonly getBlocking: (id: TaskId) => Effect.Effect<readonly Task[], DatabaseError>;
+}>;
+export declare class ReadyService extends ReadyService_base {
+}
+export declare const ReadyServiceLive: Layer.Layer<ReadyService, never, TaskRepository | DependencyRepository>;
+export {};
+//# sourceMappingURL=ready-service.d.ts.map

package/dist/services/ready-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-service.d.ts","sourceRoot":"","sources":["../../src/services/ready-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;;uBAKlD,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,aAAa,CAAC;sBAC1E,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;0BACjD,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,aAAa,CAAC;0BAC7D,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,aAAa,CAAC;;AANvF,qBAAa,YAAa,SAAQ,iBAQ/B;CAAG;AAEN,eAAO,MAAM,gBAAgB,yEA2E5B,CAAA"}

package/dist/services/ready-service.js

@@ -0,0 +1,70 @@
+import { Context, Effect, Layer } from "effect";
+import { TaskRepository } from "../repo/task-repo.js";
+import { DependencyRepository } from "../repo/dep-repo.js";
+export class ReadyService extends Context.Tag("ReadyService")() {
+}
+export const ReadyServiceLive = Layer.effect(ReadyService, Effect.gen(function* () {
+    const taskRepo = yield* TaskRepository;
+    const depRepo = yield* DependencyRepository;
+    return {
+        getReady: (limit = 100) => Effect.gen(function* () {
+            const candidates = yield* taskRepo.findAll({
+                status: ["backlog", "ready", "planning"]
+            });
+            const ready = [];
+            for (const task of candidates) {
+                const blockerIds = yield* depRepo.getBlockerIds(task.id);
+                const blockingIds = yield* depRepo.getBlockingIds(task.id);
+                const childIds = yield* taskRepo.getChildIds(task.id);
+                if (blockerIds.length === 0) {
+                    ready.push({
+                        ...task,
+                        blockedBy: [],
+                        blocks: blockingIds,
+                        children: childIds,
+                        isReady: true
+                    });
+                    continue;
+                }
+                const blockers = yield* taskRepo.findByIds(blockerIds);
+                const allDone = blockers.every(b => b.status === "done");
+                if (allDone) {
+                    ready.push({
+                        ...task,
+                        blockedBy: blockerIds,
+                        blocks: blockingIds,
+                        children: childIds,
+                        isReady: true
+                    });
+                }
+            }
+            ready.sort((a, b) => b.score - a.score);
+            return ready.slice(0, limit);
+        }),
+        isReady: (id) => Effect.gen(function* () {
+            const task = yield* taskRepo.findById(id);
+            if (!task)
+                return false;
+            if (!["backlog", "ready", "planning"].includes(task.status))
+                return false;
+            const blockerIds = yield* depRepo.getBlockerIds(id);
+            if (blockerIds.length === 0)
+                return true;
+            const blockers = yield* taskRepo.findByIds(blockerIds);
+            return blockers.every(b => b.status === "done");
+        }),
+        getBlockers: (id) => Effect.gen(function* () {
+            const blockerIds = yield* depRepo.getBlockerIds(id);
+            if (blockerIds.length === 0)
+                return [];
+            return yield* taskRepo.findByIds(blockerIds);
+        }),
+        getBlocking: (id) => Effect.gen(function* () {
+            const blockingIds = yield* depRepo.getBlockingIds(id);
+            if (blockingIds.length === 0)
+                return [];
+            return yield* taskRepo.findByIds(blockingIds);
+        })
+    };
+}));
+//# sourceMappingURL=ready-service.js.map

package/dist/services/ready-service.js.map

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

package/dist/services/reranker-service.d.ts

@@ -0,0 +1,51 @@
+import { Context, Effect, Layer } from "effect";
+import { RerankerUnavailableError } from "../errors.js";
+/**
+ * Result of re-ranking documents against a query.
+ */
+export interface RerankerResult {
+    /** Original document content */
+    readonly document: string;
+    /** Relevance score (0-1, higher is more relevant) */
+    readonly score: number;
+    /** Original index before re-ranking */
+    readonly originalIndex: number;
+}
+declare const RerankerService_base: Context.TagClass<RerankerService, "RerankerService", {
+    /**
+     * Re-rank documents against a query.
+     * Returns documents sorted by relevance score (highest first).
+     */
+    readonly rerank: (query: string, documents: readonly string[]) => Effect.Effect<readonly RerankerResult[], RerankerUnavailableError>;
+    /** Check if re-ranking functionality is available */
+    readonly isAvailable: () => Effect.Effect<boolean>;
+}>;
+/**
+ * RerankerService uses LLM-based re-ranking to improve search result quality.
+ *
+ * Re-ranking takes initial search results and uses a specialized model to
+ * re-score them based on query relevance. This typically improves precision
+ * at the cost of some latency.
+ *
+ * Design: Following DD-010 patterns for local model integration.
+ * The service gracefully degrades when node-llama-cpp is not available.
+ */
+export declare class RerankerService extends RerankerService_base {
+}
+/**
+ * Noop fallback - returns documents unchanged with default scores.
+ * Used when node-llama-cpp is not available or re-ranking is disabled.
+ */
+export declare const RerankerServiceNoop: Layer.Layer<RerankerService, never, never>;
+/**
+ * Live implementation with node-llama-cpp and Qwen3-Reranker model.
+ * Lazy-loads the model on first use and caches the context.
+ */
+export declare const RerankerServiceLive: Layer.Layer<RerankerService, never, never>;
+/**
+ * Auto-detecting layer that uses Live if node-llama-cpp is available, Noop otherwise.
+ * This allows graceful degradation when the re-ranking library is not installed.
+ */
+export declare const RerankerServiceAuto: Layer.Layer<RerankerService, boolean, never>;
+export {};
+//# sourceMappingURL=reranker-service.d.ts.map

package/dist/services/reranker-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker-service.d.ts","sourceRoot":"","sources":["../../src/services/reranker-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAO,MAAM,QAAQ,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAqBvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;;IAeG;;;OAGG;qBACc,CACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,MAAM,EAAE,KACzB,MAAM,CAAC,MAAM,CAAC,SAAS,cAAc,EAAE,EAAE,wBAAwB,CAAC;IACvE,qDAAqD;0BAC/B,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;;AAtBtD;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,oBAclC;CAAG;AAEN;;;GAGG;AACH,eAAO,MAAM,mBAAmB,4CAa/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,4CAmG/B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8CAgB/B,CAAA"}

package/dist/services/reranker-service.js

@@ -0,0 +1,128 @@
+import { Context, Effect, Layer, Ref } from "effect";
+import { RerankerUnavailableError } from "../errors.js";
+/**
+ * RerankerService uses LLM-based re-ranking to improve search result quality.
+ *
+ * Re-ranking takes initial search results and uses a specialized model to
+ * re-score them based on query relevance. This typically improves precision
+ * at the cost of some latency.
+ *
+ * Design: Following DD-010 patterns for local model integration.
+ * The service gracefully degrades when node-llama-cpp is not available.
+ */
+export class RerankerService extends Context.Tag("RerankerService")() {
+}
+/**
+ * Noop fallback - returns documents unchanged with default scores.
+ * Used when node-llama-cpp is not available or re-ranking is disabled.
+ */
+export const RerankerServiceNoop = Layer.succeed(RerankerService, {
+    rerank: (_query, documents) => Effect.succeed(documents.map((document, index) => ({
+        document,
+        score: 1 - index * 0.01, // Preserve original order with decreasing scores
+        originalIndex: index
+    }))),
+    isAvailable: () => Effect.succeed(false)
+});
+/**
+ * Live implementation with node-llama-cpp and Qwen3-Reranker model.
+ * Lazy-loads the model on first use and caches the context.
+ */
+export const RerankerServiceLive = Layer.scoped(RerankerService, Effect.gen(function* () {
+    // State for lazy-loaded context
+    const stateRef = yield* Ref.make({
+        context: null,
+        lastActivity: Date.now()
+    });
+    /**
+     * Ensure the ranking context is loaded.
+     * Lazy-loads node-llama-cpp and the model on first call.
+     */
+    const ensureContext = Effect.gen(function* () {
+        const state = yield* Ref.get(stateRef);
+        if (state.context) {
+            yield* Ref.update(stateRef, s => ({ ...s, lastActivity: Date.now() }));
+            return state.context;
+        }
+        // Lazy load node-llama-cpp
+        const nodeLlamaCpp = yield* Effect.tryPromise({
+            try: async () => {
+                const mod = await import("node-llama-cpp");
+                return mod;
+            },
+            catch: () => new RerankerUnavailableError({ reason: "node-llama-cpp not installed" })
+        });
+        // Get llama instance
+        const llama = yield* Effect.tryPromise({
+            try: () => nodeLlamaCpp.getLlama(),
+            catch: (e) => new RerankerUnavailableError({ reason: `Failed to initialize llama: ${String(e)}` })
+        });
+        // Load Qwen3-Reranker model - uses HuggingFace model spec format
+        // Using the 0.6B model for a good balance of quality and speed
+        const model = yield* Effect.tryPromise({
+            try: () => llama.loadModel({
+                modelPath: "hf:Mungert/Qwen3-Reranker-0.6B-GGUF/Qwen3-Reranker-0.6B-Q8_0.gguf"
+            }),
+            catch: (e) => new RerankerUnavailableError({ reason: `Failed to load model: ${String(e)}` })
+        });
+        // Create ranking context
+        const context = yield* Effect.tryPromise({
+            try: () => model.createRankingContext(),
+            catch: (e) => new RerankerUnavailableError({ reason: `Failed to create ranking context: ${String(e)}` })
+        });
+        yield* Ref.set(stateRef, { context, lastActivity: Date.now() });
+        return context;
+    });
+    return {
+        rerank: (query, documents) => Effect.gen(function* () {
+            if (documents.length === 0) {
+                return [];
+            }
+            // For very small result sets, re-ranking may not be worth the cost
+            if (documents.length <= 2) {
+                return documents.map((document, index) => ({
+                    document,
+                    score: 1 - index * 0.1,
+                    originalIndex: index
+                }));
+            }
+            const ctx = yield* ensureContext;
+            // Create index map to track original positions
+            const docArray = [...documents];
+            const indexMap = new Map();
+            docArray.forEach((doc, idx) => {
+                indexMap.set(doc, idx);
+            });
+            const ranked = yield* Effect.tryPromise({
+                try: () => ctx.rankAndSort(query, docArray),
+                catch: (e) => new RerankerUnavailableError({ reason: `Re-ranking failed: ${String(e)}` })
+            });
+            yield* Ref.update(stateRef, s => ({ ...s, lastActivity: Date.now() }));
+            return ranked.map(result => ({
+                document: result.document,
+                score: result.score,
+                originalIndex: indexMap.get(result.document) ?? -1
+            }));
+        }),
+        isAvailable: () => Effect.succeed(true)
+    };
+}));
+/**
+ * Auto-detecting layer that uses Live if node-llama-cpp is available, Noop otherwise.
+ * This allows graceful degradation when the re-ranking library is not installed.
+ */
+export const RerankerServiceAuto = Layer.unwrapEffect(Effect.gen(function* () {
+    // Try to import node-llama-cpp to check availability
+    const available = yield* Effect.tryPromise({
+        try: async () => {
+            await import("node-llama-cpp");
+            return true;
+        },
+        catch: () => false
+    });
+    if (available) {
+        return RerankerServiceLive;
+    }
+    return RerankerServiceNoop;
+}));
+//# sourceMappingURL=reranker-service.js.map

package/dist/services/reranker-service.js.map

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

package/dist/services/retriever-service.d.ts

@@ -0,0 +1,49 @@
+import { Context, Effect, Layer } from "effect";
+import { LearningRepository } from "../repo/learning-repo.js";
+import { EmbeddingService } from "./embedding-service.js";
+import { QueryExpansionService } from "./query-expansion-service.js";
+import { RerankerService } from "./reranker-service.js";
+import { RetrievalError, DatabaseError } from "../errors.js";
+import type { LearningWithScore, RetrievalOptions } from "@jamesaphoenix/tx-types";
+declare const RetrieverService_base: Context.TagClass<RetrieverService, "RetrieverService", {
+    /**
+     * Search for learnings matching a query.
+     * Returns scored results sorted by relevance (highest first).
+     */
+    readonly search: (query: string, options?: RetrievalOptions) => Effect.Effect<readonly LearningWithScore[], RetrievalError | DatabaseError>;
+    /** Check if retrieval functionality is available */
+    readonly isAvailable: () => Effect.Effect<boolean>;
+}>;
+/**
+ * RetrieverService provides pluggable retrieval for learnings.
+ *
+ * Design: PRD-015 specifies retrieval should be pluggable with good defaults.
+ * Users can swap out the default BM25+vector+RRF pipeline for their own
+ * implementation (Pinecone, Weaviate, Chroma, etc.).
+ */
+export declare class RetrieverService extends RetrieverService_base {
+}
+/**
+ * Noop fallback - returns empty results.
+ * Used when retrieval is disabled or for testing without full pipeline.
+ */
+export declare const RetrieverServiceNoop: Layer.Layer<RetrieverService, never, never>;
+/**
+ * Live implementation with BM25 + vector + RRF pipeline.
+ * Uses the default hybrid search with:
+ * - Query expansion via LLM
+ * - BM25 full-text search
+ * - Vector similarity (when embeddings available)
+ * - RRF fusion
+ * - Optional LLM re-ranking
+ * - Recency/outcome/frequency boosts
+ */
+export declare const RetrieverServiceLive: Layer.Layer<RetrieverService, DatabaseError, LearningRepository | EmbeddingService | QueryExpansionService | RerankerService>;
+/**
+ * Auto-detecting layer that always uses Live since BM25 is always available.
+ * The Live implementation gracefully degrades vector search when embeddings
+ * are unavailable, so Auto just delegates to Live.
+ */
+export declare const RetrieverServiceAuto: Layer.Layer<RetrieverService, DatabaseError, LearningRepository | EmbeddingService | QueryExpansionService | RerankerService>;
+export {};
+//# sourceMappingURL=retriever-service.d.ts.map

package/dist/services/retriever-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriever-service.d.ts","sourceRoot":"","sources":["../../src/services/retriever-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAY,iBAAiB,EAAc,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;;IA+BpG;;;OAGG;qBACc,CACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,KACvB,MAAM,CAAC,MAAM,CAAC,SAAS,iBAAiB,EAAE,EAAE,cAAc,GAAG,aAAa,CAAC;IAChF,oDAAoD;0BAC9B,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;;AAnBtD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,qBAcnC;CAAG;AAwNN;;;GAGG;AACH,eAAO,MAAM,oBAAoB,6CAMhC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,+HAmQhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,+HAAuB,CAAA"}