@prsense/workflows 0.1.0

package/dist/review/buildDiffEmbeddingQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDiffEmbeddingQuery.d.ts","sourceRoot":"","sources":["../../src/review/buildDiffEmbeddingQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAyDT"}

package/dist/review/buildDiffEmbeddingQuery.js

@@ -0,0 +1,43 @@
+export function buildDiffEmbeddingQuery(params) {
+    const { diff, title, description, maxChars = 4000 } = params;
+    const parts = [];
+    // -------------------------------------------------
+    // PR Intent
+    // -------------------------------------------------
+    if (title) {
+        parts.push(`PR Title: ${title}`);
+    }
+    if (description) {
+        parts.push(`PR Description: ${description}`);
+    }
+    // -------------------------------------------------
+    // Changed Files (strong retrieval anchor)
+    // -------------------------------------------------
+    parts.push("Changed Files:");
+    for (const file of diff.files.slice(0, 50)) {
+        parts.push(file.path);
+    }
+    // -------------------------------------------------
+    // Meaningful Code Changes
+    // -------------------------------------------------
+    parts.push("\nChanged Code:");
+    for (const file of diff.files) {
+        parts.push(`File: ${file.path}`);
+        const lines = file.patch.split("\n");
+        for (const line of lines) {
+            // Only meaningful changes
+            if (line.startsWith("+") && !line.startsWith("+++")) {
+                parts.push(line.slice(1));
+            }
+            if (line.startsWith("-") && !line.startsWith("---")) {
+                parts.push(line.slice(1));
+            }
+        }
+    }
+    let query = parts.join("\n");
+    if (query.length > maxChars) {
+        query = query.slice(0, maxChars);
+    }
+    return query;
+}
+//# sourceMappingURL=buildDiffEmbeddingQuery.js.map

package/dist/review/buildDiffEmbeddingQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDiffEmbeddingQuery.js","sourceRoot":"","sources":["../../src/review/buildDiffEmbeddingQuery.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,uBAAuB,CAAC,MAKvC;IACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAE7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,oDAAoD;IACpD,YAAY;IACZ,oDAAoD;IAEpD,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,oDAAoD;IACpD,0CAA0C;IAC1C,oDAAoD;IAEpD,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,oDAAoD;IACpD,0BAA0B;IAC1B,oDAAoD;IAEpD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,0BAA0B;YAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;YAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC5B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/review/dedupeSignals.d.ts

@@ -0,0 +1,3 @@
+import { ReviewSignal } from "@prsense/core";
+export declare function dedupeSignals(signals: ReviewSignal[]): ReviewSignal[];
+//# sourceMappingURL=dedupeSignals.d.ts.map

package/dist/review/dedupeSignals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupeSignals.d.ts","sourceRoot":"","sources":["../../src/review/dedupeSignals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAQrE"}

package/dist/review/dedupeSignals.js

@@ -0,0 +1,11 @@
+export function dedupeSignals(signals) {
+    const seen = new Set();
+    return signals.filter((s) => {
+        const key = `${s.file}:${s.lineStart}:${s.message}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=dedupeSignals.js.map

package/dist/review/dedupeSignals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupeSignals.js","sourceRoot":"","sources":["../../src/review/dedupeSignals.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/review/extractJson.d.ts

@@ -0,0 +1,2 @@
+export declare function extractJson(text: string): string;
+//# sourceMappingURL=extractJson.d.ts.map

package/dist/review/extractJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractJson.d.ts","sourceRoot":"","sources":["../../src/review/extractJson.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBhD"}

package/dist/review/extractJson.js

@@ -0,0 +1,15 @@
+export function extractJson(text) {
+    // Remove markdown fences if present
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    if (fenced && fenced[1]) {
+        return fenced[1].trim();
+    }
+    // Otherwise attempt brace extraction
+    const first = text.indexOf("{");
+    const last = text.lastIndexOf("}");
+    if (first !== -1 && last !== -1) {
+        return text.slice(first, last + 1);
+    }
+    return text;
+}
+//# sourceMappingURL=extractJson.js.map

package/dist/review/extractJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractJson.js","sourceRoot":"","sources":["../../src/review/extractJson.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,oCAAoC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC3D,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,qCAAqC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/review/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./retrieveContext.js";
+export * from "./reviewWorkflow.js";
+export * from "./validateReviewOutput.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/dist/review/index.js

@@ -0,0 +1,4 @@
+export * from "./retrieveContext.js";
+export * from "./reviewWorkflow.js";
+export * from "./validateReviewOutput.js";
+//# sourceMappingURL=index.js.map

package/dist/review/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/dist/review/input/ReviewInput.d.ts

@@ -0,0 +1,18 @@
+export type ReviewInput = {
+    repo: {
+        owner: string;
+        name: string;
+    };
+    /** Raw unified diff text */
+    diffText: string;
+    /** Optional hints from adapter */
+    repoRoot?: string;
+    baseBranch?: string;
+    /** Human-authored metadata */
+    metadata?: {
+        title?: string;
+        description?: string;
+        author?: string;
+    };
+};
+//# sourceMappingURL=ReviewInput.d.ts.map

package/dist/review/input/ReviewInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewInput.d.ts","sourceRoot":"","sources":["../../../src/review/input/ReviewInput.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC"}

package/dist/review/input/ReviewInput.js

@@ -0,0 +1,3 @@
+// packages/core/input/ReviewInput.ts
+export {};
+//# sourceMappingURL=ReviewInput.js.map

package/dist/review/input/ReviewInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewInput.js","sourceRoot":"","sources":["../../../src/review/input/ReviewInput.ts"],"names":[],"mappings":"AAAA,qCAAqC"}

package/dist/review/normalizeSignal.d.ts

@@ -0,0 +1,3 @@
+import type { ReviewSignal } from "@prsense/core";
+export declare function normalizeSignal(raw: any, index: number): ReviewSignal | null;
+//# sourceMappingURL=normalizeSignal.d.ts.map

package/dist/review/normalizeSignal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeSignal.d.ts","sourceRoot":"","sources":["../../src/review/normalizeSignal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA4B5E"}

package/dist/review/normalizeSignal.js

@@ -0,0 +1,31 @@
+const allowedTypes = ["bug", "risk", "test", "style"];
+const allowedSeverity = ["low", "medium", "high"];
+export function normalizeSignal(raw, index) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    if (!allowedTypes.includes(raw.type))
+        return null;
+    if (!allowedSeverity.includes(raw.severity))
+        return null;
+    const confidence = typeof raw.confidence === "number"
+        ? Math.max(0, Math.min(1, raw.confidence))
+        : 0.5;
+    if (!raw.file || typeof raw.file !== "string")
+        return null;
+    if (!raw.message || typeof raw.message !== "string")
+        return null;
+    return {
+        id: `signal-${index}`,
+        type: raw.type,
+        severity: raw.severity,
+        confidence,
+        file: raw.file,
+        lineStart: typeof raw.lineStart === "number" ? raw.lineStart : undefined,
+        lineEnd: typeof raw.lineEnd === "number" ? raw.lineEnd : undefined,
+        message: raw.message,
+        rationale: typeof raw.rationale === "string" ? raw.rationale : undefined,
+        suggestedFix: typeof raw.suggestedFix === "string" ? raw.suggestedFix : undefined,
+        source: "llm",
+    };
+}
+//# sourceMappingURL=normalizeSignal.js.map

package/dist/review/normalizeSignal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeSignal.js","sourceRoot":"","sources":["../../src/review/normalizeSignal.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAC/D,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAE3D,MAAM,UAAU,eAAe,CAAC,GAAQ,EAAE,KAAa;IACrD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,MAAM,UAAU,GACd,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC,CAAC,GAAG,CAAC;IAEV,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjE,OAAO;QACL,EAAE,EAAE,UAAU,KAAK,EAAE;QACrB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACxE,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAClE,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACxE,YAAY,EACV,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QACrE,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}

package/dist/review/ports.d.ts

@@ -0,0 +1,5 @@
+import type { ContextChunk, UnifiedDiff, ReviewSignal } from "@prsense/core";
+export interface ReviewSignalCompiler {
+    compile(diff: UnifiedDiff, context: ContextChunk[]): Promise<ReviewSignal[]>;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/review/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/review/ports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC9E"}

package/dist/review/ports.js

@@ -0,0 +1,3 @@
+// packages/workflows/src/review/ports.ts
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/review/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/review/ports.ts"],"names":[],"mappings":"AAAA,yCAAyC"}

package/dist/review/retrieveContext.d.ts

@@ -0,0 +1,12 @@
+import type { RetrievedContext, EventBus } from "@prsense/core";
+import type { ResolvedConfig } from "@prsense/config";
+export declare function retrieveContext(params: {
+    config: ResolvedConfig;
+    query: string;
+    repoProvider: string;
+    repoName: string;
+    repoRef?: string;
+    limit: number;
+    eventBus?: EventBus;
+}): Promise<RetrievedContext>;
+//# sourceMappingURL=retrieveContext.d.ts.map

package/dist/review/retrieveContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieveContext.d.ts","sourceRoot":"","sources":["../../src/review/retrieveContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOtD,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqF5B"}

package/dist/review/retrieveContext.js

@@ -0,0 +1,76 @@
+// packages/workflows/src/review/retrieveContext.ts
+import { CoreEvents } from "@prsense/core";
+import { PostgresRagChunkRepository } from "@prsense/context";
+import { createOpenAiEmbeddingClient, createOllamaEmbeddingClient, } from "@prsense/llm";
+export async function retrieveContext(params) {
+    const { config, query, repoProvider, repoName, repoRef, limit } = params;
+    // -------------------------------------------------
+    // Create embedding client
+    // -------------------------------------------------
+    const embeddingClient = config.embeddings.provider === "openai"
+        ? createOpenAiEmbeddingClient({
+            apiKey: process.env.OPENAI_API_KEY,
+            model: config.embeddings.model,
+        })
+        : createOllamaEmbeddingClient({
+            model: config.embeddings.model,
+        });
+    const [queryEmbedding] = await embeddingClient.embed([query]);
+    params.eventBus?.emit(CoreEvents.WorkflowReviewContextEmbeddingGenerated, {
+        dimension: queryEmbedding?.length,
+    });
+    if (!queryEmbedding) {
+        throw new Error("Failed to generate query embedding");
+    }
+    // -------------------------------------------------
+    // Query RAG store
+    // -------------------------------------------------
+    const repository = new PostgresRagChunkRepository(config.database.url);
+    const rows = await repository.searchNearest({
+        repoProvider,
+        repoName,
+        ...(repoRef ? { repoRef } : {}),
+        embedding: queryEmbedding,
+        limit,
+    });
+    params.eventBus?.emit(CoreEvents.WorkflowReviewContextRetrieved, {
+        chunks: rows.length,
+        repoProvider,
+        repoName,
+        minDistance: rows[0]?.distance,
+        maxDistance: rows[rows.length - 1]?.distance,
+    });
+    // -------------------------------------------------
+    // Map to domain objects
+    // -------------------------------------------------
+    const chunks = rows.map((row) => {
+        const chunk = {
+            id: row.id,
+            source: {
+                kind: "file",
+                path: row.path,
+            },
+            content: row.content,
+            metadata: {
+                path: row.path,
+                ...(row.lineStart != null ? { lineStart: row.lineStart } : {}),
+                ...(row.lineEnd != null ? { lineEnd: row.lineEnd } : {}),
+                ...(row.language != null ? { language: row.language } : {}),
+            },
+        };
+        params.eventBus?.emit(CoreEvents.WorkflowReviewContextChunkRetrieved, {
+            source: chunk.source,
+            metadata: chunk.metadata,
+            distance: row.distance,
+        });
+        return chunk;
+    });
+    return {
+        chunks,
+        stats: {
+            totalChunks: rows.length,
+            truncated: rows.length === limit,
+        },
+    };
+}
+//# sourceMappingURL=retrieveContext.js.map

package/dist/review/retrieveContext.js.map

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

package/dist/review/reviewWorkflow.d.ts

@@ -0,0 +1,11 @@
+import { EventBus } from "@prsense/core";
+import type { DiffProvider } from "@prsense/core";
+import type { ResolvedConfig, CredentialContext } from "@prsense/config";
+import type { ReviewWorkflowResult } from "./types.js";
+export declare function runReviewWorkflow({ config, credentials, diffProvider, eventBus, }: {
+    config: ResolvedConfig;
+    credentials: CredentialContext;
+    diffProvider: DiffProvider;
+    eventBus: EventBus;
+}): Promise<ReviewWorkflowResult>;
+//# sourceMappingURL=reviewWorkflow.d.ts.map

package/dist/review/reviewWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewWorkflow.d.ts","sourceRoot":"","sources":["../../src/review/reviewWorkflow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,QAAQ,EAAqB,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAUzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAQvD,wBAAsB,iBAAiB,CAAC,EACtC,MAAM,EACN,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6UhC"}

package/dist/review/reviewWorkflow.js

@@ -0,0 +1,286 @@
+// packages/workflows/src/review/reviewWorkflow.ts
+import { CoreEvents, buildReviewPrompt } from "@prsense/core";
+import { PostgresIndexMetadataRepository } from "@prsense/context";
+import { createOpenAiClient, createOllamaClient, createGoogleClient, createAnthropicClient, } from "@prsense/llm";
+import { validateReviewOutput } from "./validateReviewOutput.js";
+import { buildDiffEmbeddingQuery } from "./buildDiffEmbeddingQuery.js";
+import { dedupeSignals } from "./dedupeSignals.js";
+import { retrieveContext } from "./retrieveContext.js";
+import { normalizeSignal } from "./normalizeSignal.js";
+import { extractJson } from "./extractJson.js";
+export async function runReviewWorkflow({ config, credentials, diffProvider, eventBus, }) {
+    eventBus.emit(CoreEvents.WorkflowReviewStarted);
+    try {
+        // -------------------------------------------------
+        // Load diff from provider
+        // -------------------------------------------------
+        const { diff, revision, repositoryIdentity, metadata } = await diffProvider.load();
+        const metadataRepository = new PostgresIndexMetadataRepository(config.database.url);
+        const storedMetadata = await metadataRepository.load(repositoryIdentity.provider, repositoryIdentity.id);
+        let contextualReviewAvailable = false;
+        if (storedMetadata) {
+            const embeddingMatches = storedMetadata.embedding.provider === config.embeddings.provider &&
+                storedMetadata.embedding.model === config.embeddings.model;
+            if (embeddingMatches) {
+                contextualReviewAvailable = true;
+                if (storedMetadata.revision.commitSha !== revision) {
+                    eventBus.emit(CoreEvents.WorkflowReviewIndexOutdated, {
+                        indexedCommit: storedMetadata.revision.commitSha,
+                        currentCommit: revision,
+                    });
+                }
+            }
+        }
+        if (!storedMetadata) {
+            eventBus.emit(CoreEvents.WorkflowReviewContextUnavailable);
+        }
+        else if (!contextualReviewAvailable) {
+            eventBus.emit(CoreEvents.WorkflowReviewIndexOutdated, {
+                indexedCommit: storedMetadata.revision.commitSha,
+                currentCommit: revision,
+            });
+        }
+        else {
+            eventBus.emit(CoreEvents.WorkflowReviewContextAvailable);
+        }
+        if (diff.files.length === 0) {
+            eventBus.emit(CoreEvents.WorkflowReviewFinished);
+            return {
+                outcome: "success",
+                payload: { signals: [] },
+            };
+        }
+        // -------------------------------------------------
+        // Retrieve contextual chunks (RAG) if available
+        // -------------------------------------------------
+        let contextText = "";
+        if (contextualReviewAvailable) {
+            const retrievalQuery = buildDiffEmbeddingQuery({
+                diff,
+                ...(metadata?.title ? { title: metadata.title } : {}),
+                ...(metadata?.description ? { description: metadata.description } : {}),
+            });
+            eventBus.emit(CoreEvents.WorkflowReviewContextQueryBuilt, {
+                preview: retrievalQuery.slice(0, 500),
+            });
+            const retrieved = await retrieveContext({
+                config,
+                query: retrievalQuery,
+                repoProvider: repositoryIdentity.provider,
+                repoName: repositoryIdentity.id,
+                limit: config.context.maxChunks,
+                eventBus,
+            });
+            // context size guard
+            const MAX_CONTEXT_CHARS = 20000;
+            let accumulated = "";
+            for (const chunk of retrieved.chunks) {
+                if (accumulated.length + chunk.content.length > MAX_CONTEXT_CHARS)
+                    break;
+                accumulated += chunk.content + "\n\n";
+            }
+            contextText = accumulated;
+            eventBus.emit(CoreEvents.WorkflowReviewContextRetrieved, {
+                chunks: retrieved.stats.totalChunks,
+                truncated: retrieved.stats.truncated,
+                contextChars: contextText.length,
+            });
+        }
+        // -------------------------------------------------
+        // Create LLM client
+        // -------------------------------------------------
+        let llmClient;
+        switch (config.llm.provider) {
+            case "openai": {
+                const apiKey = credentials.openai?.apiKey;
+                if (!apiKey) {
+                    throw new Error("OpenAI credentials missing");
+                }
+                llmClient = createOpenAiClient({
+                    apiKey,
+                    model: config.llm.model,
+                    temperature: config.llm.temperature,
+                });
+                break;
+            }
+            case "google": {
+                const apiKey = credentials.google?.apiKey;
+                if (!apiKey) {
+                    throw new Error("Google credentials missing");
+                }
+                llmClient = createGoogleClient({
+                    apiKey,
+                    model: config.llm.model,
+                    temperature: config.llm.temperature,
+                });
+                break;
+            }
+            case "anthropic": {
+                const apiKey = credentials.anthropic?.apiKey;
+                if (!apiKey) {
+                    throw new Error("Anthropic credentials missing");
+                }
+                llmClient = createAnthropicClient({
+                    apiKey,
+                    model: config.llm.model,
+                    temperature: config.llm.temperature,
+                });
+                break;
+            }
+            case "ollama":
+            default:
+                llmClient = createOllamaClient({
+                    model: config.llm.model,
+                    temperature: config.llm.temperature,
+                });
+        }
+        // -------------------------------------------------
+        // Generate review
+        // -------------------------------------------------
+        const allSignals = [];
+        let totalUsage;
+        for (const file of diff.files) {
+            // Skip empty or trivial patches
+            if (!file.patch || file.patch.length < 40) {
+                continue;
+            }
+            // skip binary/non code files
+            if (file.path.endsWith(".png") ||
+                file.path.endsWith(".jpg") ||
+                file.path.endsWith(".svg") ||
+                file.path.endsWith(".lock")) {
+                continue;
+            }
+            eventBus.emit(CoreEvents.WorkflowReviewFileStarted, {
+                file: file.path,
+            });
+            const fileDiff = {
+                files: [file],
+            };
+            const prompt = buildReviewPrompt({
+                diff: fileDiff,
+                context: contextText,
+                ...(metadata ?? {}),
+            });
+            eventBus.emit(CoreEvents.WorkflowReviewPromptBuilt, {
+                model: config.llm.model,
+                provider: config.llm.provider,
+                promptChars: JSON.stringify(prompt).length,
+                preview: JSON.stringify(prompt).slice(0, 2000),
+            });
+            eventBus.emit(CoreEvents.WorkflowReviewLlmRequestStarted);
+            const start = Date.now();
+            const response = await llmClient.generate({ prompt });
+            eventBus.emit(CoreEvents.WorkflowReviewLlmResponseReceived, {
+                outputChars: response.text.length,
+                usage: response.usage,
+                durationMs: Date.now() - start,
+            });
+            eventBus.emit(CoreEvents.WorkflowReviewLlmRawResponse, {
+                preview: response.text.slice(0, 1000),
+                fullLength: response.text.length,
+            });
+            if (response.usage) {
+                if (!totalUsage) {
+                    totalUsage = { ...response.usage };
+                }
+                else {
+                    totalUsage.promptTokens += response.usage.promptTokens;
+                    totalUsage.completionTokens += response.usage.completionTokens;
+                    totalUsage.totalTokens += response.usage.totalTokens;
+                }
+            }
+            const cleaned = extractJson(response.text);
+            const trimmed = cleaned.trim();
+            if (!(trimmed.endsWith("}") || trimmed.endsWith("]}"))) {
+                throw new Error("LLM response truncated");
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(cleaned);
+            }
+            catch {
+                eventBus.emit(CoreEvents.WorkflowReviewInvalidJson, {
+                    rawResponsePreview: response.text.slice(0, 2000),
+                });
+                throw new Error("LLM returned invalid JSON");
+            }
+            let validated;
+            try {
+                validated = validateReviewOutput(parsed);
+            }
+            catch {
+                const correctionPrompt = `
+The previous output did not match the required schema.
+
+Convert the following into valid JSON matching this schema:
+
+{
+  "signals": [
+    {
+      "type": "bug" | "risk" | "test" | "style",
+      "severity": "low" | "medium" | "high",
+      "confidence": number,
+      "file": string,
+      "lineStart": number | null,
+      "lineEnd": number | null,
+      "message": string,
+      "rationale": string | null,
+      "suggestedFix": string | null
+    }
+  ]
+}
+
+Output only valid JSON.
+
+Previous output:
+${cleaned}
+`;
+                const retry = await llmClient.generate({
+                    prompt: {
+                        system: "You are correcting malformed JSON output.",
+                        user: correctionPrompt,
+                    },
+                });
+                const retryCleaned = extractJson(retry.text);
+                parsed = JSON.parse(retryCleaned);
+                validated = validateReviewOutput(parsed);
+            }
+            allSignals.push(...validated.signals);
+        }
+        // -------------------------------------------------
+        // Normalize + filter signals
+        // -------------------------------------------------
+        const rawSignals = allSignals;
+        const normalized = rawSignals
+            .map(normalizeSignal)
+            .filter((s) => s != null);
+        const thresholded = normalized.filter((s) => s.confidence >= config.review.confidenceThreshold);
+        const signals = dedupeSignals(thresholded);
+        eventBus.emit(CoreEvents.SignalCompiled, {
+            count: signals.length,
+        });
+        eventBus.emit(CoreEvents.WorkflowReviewFinished);
+        if (totalUsage) {
+            return {
+                outcome: "success",
+                payload: { signals, usage: totalUsage },
+            };
+        }
+        return {
+            outcome: "success",
+            payload: { signals },
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        eventBus.emit(CoreEvents.WorkflowReviewFailed, {
+            error: message,
+        });
+        return {
+            outcome: "failure",
+            payload: { signals: [] },
+        };
+    }
+}
+//# sourceMappingURL=reviewWorkflow.js.map