prism-pr 1.0.0-alpha.47

package/dist/core/integrity-checker.js

@@ -0,0 +1,83 @@
+/**
+ * Pure function — no I/O, no side effects.
+ *
+ * Given the findings stored in the DB for a PR and the live BB comment list,
+ * returns an IntegrityReport describing which findings are still present,
+ * which were deleted, and which cannot be tracked (legacy null IDs).
+ */
+export function checkCommentIntegrity(priorFindings, existingComments) {
+    // 1. Empty findings → zero report
+    if (priorFindings.length === 0) {
+        return {
+            verifiedCount: 0,
+            deletedCount: 0,
+            untrackableCount: 0,
+            deletedFindings: [],
+            allLegacy: false,
+            totalChecked: 0,
+        };
+    }
+    // 2. Deduplicate by dedupHash
+    //    Preference: non-null bitbucketCommentId wins over null.
+    //    Tie-break: most recent createdAt wins.
+    const dedupMap = new Map();
+    for (const finding of priorFindings) {
+        const existing = dedupMap.get(finding.dedupHash);
+        if (existing === undefined) {
+            dedupMap.set(finding.dedupHash, finding);
+            continue;
+        }
+        const existingHasId = existing.bitbucketCommentId !== null;
+        const candidateHasId = finding.bitbucketCommentId !== null;
+        if (candidateHasId && !existingHasId) {
+            // Candidate has an ID and existing does not — candidate wins
+            dedupMap.set(finding.dedupHash, finding);
+        }
+        else if (candidateHasId === existingHasId) {
+            // Both have IDs or both are null — prefer more recent createdAt
+            if (finding.createdAt > existing.createdAt) {
+                dedupMap.set(finding.dedupHash, finding);
+            }
+        }
+        // existing has an ID and candidate does not — existing keeps its place
+    }
+    // 3. Build a Set of live BB comment IDs for O(1) lookup
+    const existingIds = new Set(existingComments.map((c) => c.id));
+    // 4. Classify each deduped finding
+    let verifiedCount = 0;
+    let deletedCount = 0;
+    let untrackableCount = 0;
+    const deletedFindings = [];
+    for (const finding of dedupMap.values()) {
+        if (finding.bitbucketCommentId === null) {
+            untrackableCount++;
+        }
+        else if (existingIds.has(finding.bitbucketCommentId)) {
+            verifiedCount++;
+        }
+        else {
+            deletedCount++;
+            deletedFindings.push({
+                filePath: finding.filePath,
+                lineNumber: finding.lineNumber,
+                severity: finding.severity,
+                title: finding.title,
+                agentId: finding.agentId,
+                originalSessionId: finding.sessionId,
+                dedupHash: finding.dedupHash,
+            });
+        }
+    }
+    const totalChecked = verifiedCount + deletedCount + untrackableCount;
+    // 5. allLegacy: every finding is untrackable (all null IDs, at least one exists)
+    const allLegacy = untrackableCount === totalChecked && totalChecked > 0;
+    return {
+        verifiedCount,
+        deletedCount,
+        untrackableCount,
+        deletedFindings,
+        allLegacy,
+        totalChecked,
+    };
+}
+//# sourceMappingURL=integrity-checker.js.map

package/dist/core/integrity-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity-checker.js","sourceRoot":"","sources":["../../src/core/integrity-checker.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAA8B,EAC9B,gBAAoC;IAEpC,kCAAkC;IAClC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,CAAC;YACnB,eAAe,EAAE,EAAE;YACnB,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,6DAA6D;IAC7D,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAElD,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEjD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC,kBAAkB,KAAK,IAAI,CAAC;QAC3D,MAAM,cAAc,GAAG,OAAO,CAAC,kBAAkB,KAAK,IAAI,CAAC;QAE3D,IAAI,cAAc,IAAI,CAAC,aAAa,EAAE,CAAC;YACrC,6DAA6D;YAC7D,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;YAC5C,gEAAgE;YAChE,IAAI,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC3C,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,uEAAuE;IACzE,CAAC;IAED,wDAAwD;IACxD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvE,mCAAmC;IACnC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,MAAM,eAAe,GAAyB,EAAE,CAAC;IAEjD,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;YACxC,gBAAgB,EAAE,CAAC;QACrB,CAAC;aAAM,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACvD,aAAa,EAAE,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,YAAY,EAAE,CAAC;YACf,eAAe,CAAC,IAAI,CAAC;gBACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,iBAAiB,EAAE,OAAO,CAAC,SAAS;gBACpC,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,CAAC;IAErE,iFAAiF;IACjF,MAAM,SAAS,GAAG,gBAAgB,KAAK,YAAY,IAAI,YAAY,GAAG,CAAC,CAAC;IAExE,OAAO;QACL,aAAa;QACb,YAAY;QACZ,gBAAgB;QAChB,eAAe;QACf,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/core/review-workflow.d.ts

@@ -0,0 +1,34 @@
+import readline from 'node:readline';
+import type { BitbucketClient } from '../bitbucket/client.js';
+import type { ModelProvider, PrismConfig } from '../types/index.js';
+import type { ReviewMemoryService } from '../memory/review-memory-service.js';
+import type { ReviewOrchestrator } from '../ai/orchestrator/orchestrator.js';
+import type { CommentPublisher } from './comment-publisher.js';
+import type { SessionManager } from './session-manager.js';
+import type { Logger } from '../utils/logger.js';
+export interface WorkflowDeps {
+    bbClient: BitbucketClient;
+    provider: ModelProvider;
+    reviewMemory: ReviewMemoryService;
+    sessionManager: SessionManager;
+    publisher: CommentPublisher;
+    orchestrator: ReviewOrchestrator;
+    logger: Logger;
+    config: PrismConfig;
+    /** Injectable readline factory — allows test isolation. Defaults to real readline. */
+    readlineFn?: () => readline.Interface;
+}
+export type { WorkflowInput } from './workflow-engine.js';
+/**
+ * CLI adapter for the core WorkflowEngine.
+ *
+ * Thin wrapper that wires CLIWorkflowCallbacks (terminal I/O) to WorkflowEngine
+ * (pure orchestration logic). The public interface is unchanged — same constructor
+ * params and execute signature as before the refactor.
+ */
+export declare class ReviewWorkflow {
+    private readonly engine;
+    constructor(deps: WorkflowDeps);
+    execute(input: import('./workflow-engine.js').WorkflowInput): Promise<void>;
+}
+//# sourceMappingURL=review-workflow.d.ts.map

package/dist/core/review-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-workflow.d.ts","sourceRoot":"","sources":["../../src/core/review-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAMjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,mBAAmB,CAAC;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,EAAE,kBAAkB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,QAAQ,CAAC,SAAS,CAAC;CACvC;AAED,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,IAAI,EAAE,YAAY;IAMxB,OAAO,CAAC,KAAK,EAAE,OAAO,sBAAsB,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlF"}

package/dist/core/review-workflow.js

@@ -0,0 +1,21 @@
+import { CLIWorkflowCallbacks } from './cli-workflow-callbacks.js';
+import { WorkflowEngine } from './workflow-engine.js';
+/**
+ * CLI adapter for the core WorkflowEngine.
+ *
+ * Thin wrapper that wires CLIWorkflowCallbacks (terminal I/O) to WorkflowEngine
+ * (pure orchestration logic). The public interface is unchanged — same constructor
+ * params and execute signature as before the refactor.
+ */
+export class ReviewWorkflow {
+    engine;
+    constructor(deps) {
+        const callbacks = new CLIWorkflowCallbacks(deps.readlineFn);
+        const { readlineFn: _, ...engineDeps } = deps;
+        this.engine = new WorkflowEngine(engineDeps, callbacks);
+    }
+    async execute(input) {
+        return this.engine.execute(input);
+    }
+}
+//# sourceMappingURL=review-workflow.js.map

package/dist/core/review-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-workflow.js","sourceRoot":"","sources":["../../src/core/review-workflow.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmBtD;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACR,MAAM,CAAiB;IAExC,YAAY,IAAkB;QAC5B,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAmD;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/core/session-manager.d.ts

@@ -0,0 +1,107 @@
+import type { Logger } from '../utils/logger.js';
+import type { SessionStatus } from '../types/index.js';
+import type { ReviewFinding } from '../types/review-finding.js';
+import type { SessionListFilter, SessionRow, FindingRow } from '../persistence/repository.js';
+export interface CreateSessionParams {
+    workspace: string;
+    repo: string;
+    prId: number;
+    prTitle?: string;
+    prUrl?: string;
+    model: string;
+    agentIds: string[];
+}
+export interface SessionUpdateFields {
+    status?: SessionStatus;
+    findingsCount?: number;
+    publishedCount?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    memorySaved?: boolean;
+    completedAt?: string;
+    errorMessage?: string;
+}
+export interface PublishedFindingRow {
+    dedupHash: string;
+    bitbucketCommentId: number | null;
+    filePath: string;
+    lineNumber: number;
+    severity: string;
+    title: string;
+    agentId: string;
+    sessionId: string;
+    createdAt: string;
+}
+export interface SessionRepository {
+    createSession(params: CreateSessionParams): string;
+    updateSession(id: string, update: SessionUpdateFields): void;
+    listSessions(filter?: SessionListFilter): SessionRow[];
+    getSessionById(id: string): SessionRow | undefined;
+    getFindingsBySessionId(sessionId: string): FindingRow[];
+    updateFindingStatus(dedupHash: string, status: string, bitbucketCommentId?: number): void;
+    getPublishedFindingsForPR(workspace: string, repo: string, prId: number): PublishedFindingRow[];
+    saveFindings(sessionId: string, findings: ReviewFinding[]): void;
+}
+export interface CompleteSessionParams {
+    status: SessionStatus;
+    findingsCount: number;
+    publishedCount: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    memorySaved: boolean;
+}
+/**
+ * Thin wrapper over `SessionRepository` that manages the full session lifecycle.
+ *
+ * All methods are no-ops when `repository` is null — graceful degradation when
+ * SQLite is unavailable (spec D19).
+ */
+export declare class SessionManager {
+    private readonly repository;
+    private readonly logger;
+    constructor(repository: SessionRepository | null, logger: Logger);
+    /**
+     * Creates a new review session in the DB.
+     * Returns the generated session UUID, or null when repository is unavailable.
+     */
+    createSession(params: CreateSessionParams): string | null;
+    /**
+     * Marks the session as running (review agents are executing).
+     * No-op when repository is null or sessionId is null/undefined.
+     */
+    markRunning(sessionId: string | null): void;
+    /**
+     * Marks the session as completed with final counts and cost.
+     * No-op when repository is null or sessionId is null/undefined.
+     */
+    complete(sessionId: string | null, params: CompleteSessionParams): void;
+    /**
+     * Marks the session as failed with an error message.
+     * No-op when repository is null or sessionId is null/undefined.
+     */
+    markFailed(sessionId: string | null, errorMessage: string): void;
+    /**
+     * Lists sessions with optional filtering. Returns empty array when repository is unavailable.
+     */
+    listSessions(filter?: SessionListFilter): SessionRow[];
+    /**
+     * Returns a session by ID, or undefined if not found or repository is unavailable.
+     */
+    getSessionById(id: string): SessionRow | undefined;
+    /**
+     * Returns findings for a session. Returns empty array when repository is unavailable.
+     */
+    getFindings(sessionId: string): FindingRow[];
+    /**
+     * Updates the publication status of a finding by its dedup hash.
+     * No-op (with debug log) when repository is null.
+     */
+    updateFindingStatus(dedupHash: string, status: string, bitbucketCommentId?: number): void;
+    /**
+     * Returns all published findings for a given PR. Returns empty array when repository is unavailable.
+     */
+    getPublishedFindingsForPR(workspace: string, repo: string, prId: number): PublishedFindingRow[];
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/core/session-manager.d.ts.map

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

package/dist/core/session-manager.js

@@ -0,0 +1,164 @@
+// ── SessionManager ──────────────────────────────────────────────────────────
+/**
+ * Thin wrapper over `SessionRepository` that manages the full session lifecycle.
+ *
+ * All methods are no-ops when `repository` is null — graceful degradation when
+ * SQLite is unavailable (spec D19).
+ */
+export class SessionManager {
+    repository;
+    logger;
+    constructor(repository, logger) {
+        this.repository = repository;
+        this.logger = logger;
+    }
+    /**
+     * Creates a new review session in the DB.
+     * Returns the generated session UUID, or null when repository is unavailable.
+     */
+    createSession(params) {
+        if (!this.repository) {
+            this.logger.debug('[session] Repository unavailable — skipping createSession');
+            return null;
+        }
+        try {
+            return this.repository.createSession(params);
+        }
+        catch (err) {
+            this.logger.warn(`[session] Failed to create session: ${String(err)}`);
+            return null;
+        }
+    }
+    /**
+     * Marks the session as running (review agents are executing).
+     * No-op when repository is null or sessionId is null/undefined.
+     */
+    markRunning(sessionId) {
+        if (!this.repository || !sessionId)
+            return;
+        try {
+            this.repository.updateSession(sessionId, { status: 'running' });
+        }
+        catch (err) {
+            this.logger.warn(`[session] Failed to mark session running: ${String(err)}`);
+        }
+    }
+    /**
+     * Marks the session as completed with final counts and cost.
+     * No-op when repository is null or sessionId is null/undefined.
+     */
+    complete(sessionId, params) {
+        if (!this.repository || !sessionId)
+            return;
+        try {
+            const update = {
+                status: params.status,
+                findingsCount: params.findingsCount,
+                publishedCount: params.publishedCount,
+                memorySaved: params.memorySaved,
+                completedAt: new Date().toISOString(),
+            };
+            if (params.inputTokens !== undefined)
+                update.inputTokens = params.inputTokens;
+            if (params.outputTokens !== undefined)
+                update.outputTokens = params.outputTokens;
+            if (params.costUsd !== undefined)
+                update.costUsd = params.costUsd;
+            this.repository.updateSession(sessionId, update);
+        }
+        catch (err) {
+            this.logger.warn(`[session] Failed to complete session: ${String(err)}`);
+        }
+    }
+    /**
+     * Marks the session as failed with an error message.
+     * No-op when repository is null or sessionId is null/undefined.
+     */
+    markFailed(sessionId, errorMessage) {
+        if (!this.repository || !sessionId)
+            return;
+        try {
+            this.repository.updateSession(sessionId, {
+                status: 'failed',
+                completedAt: new Date().toISOString(),
+                errorMessage,
+            });
+        }
+        catch (err) {
+            this.logger.warn(`[session] Failed to mark session failed: ${String(err)}`);
+        }
+    }
+    /**
+     * Lists sessions with optional filtering. Returns empty array when repository is unavailable.
+     */
+    listSessions(filter) {
+        if (!this.repository)
+            return [];
+        try {
+            return this.repository.listSessions(filter);
+        }
+        catch (err) {
+            this.logger.warn(`[session] Failed to list sessions: ${String(err)}`);
+            return [];
+        }
+    }
+    /**
+     * Returns a session by ID, or undefined if not found or repository is unavailable.
+     */
+    getSessionById(id) {
+        if (!this.repository)
+            return undefined;
+        try {
+            return this.repository.getSessionById(id);
+        }
+        catch (err) {
+            this.logger.warn(`[session] Failed to get session by id: ${String(err)}`);
+            return undefined;
+        }
+    }
+    /**
+     * Returns findings for a session. Returns empty array when repository is unavailable.
+     */
+    getFindings(sessionId) {
+        if (!this.repository)
+            return [];
+        try {
+            return this.repository.getFindingsBySessionId(sessionId);
+        }
+        catch (err) {
+            this.logger.warn(`[session] Failed to get findings: ${String(err)}`);
+            return [];
+        }
+    }
+    /**
+     * Updates the publication status of a finding by its dedup hash.
+     * No-op (with debug log) when repository is null.
+     */
+    updateFindingStatus(dedupHash, status, bitbucketCommentId) {
+        if (!this.repository) {
+            this.logger.debug('[session] updateFindingStatus skipped — no repository');
+            return;
+        }
+        try {
+            this.repository.updateFindingStatus(dedupHash, status, bitbucketCommentId);
+        }
+        catch (err) {
+            this.logger.warn(`[session] updateFindingStatus failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Returns all published findings for a given PR. Returns empty array when repository is unavailable.
+     */
+    getPublishedFindingsForPR(workspace, repo, prId) {
+        if (!this.repository)
+            return [];
+        try {
+            return this.repository.getPublishedFindingsForPR(workspace, repo, prId);
+        }
+        catch (err) {
+            this.logger.warn(`[session] getPublishedFindingsForPR failed: ${err instanceof Error ? err.message : String(err)}`);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/core/session-manager.js.map

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

package/dist/core/workflow-callbacks.d.ts

@@ -0,0 +1,74 @@
+import type { ReviewFinding, PRMetadata, CostEstimate, TokenUsage } from '../types/index.js';
+export interface CostWarningInfo {
+    totalLines: number;
+    estimatedCost: number;
+    maxLines: number;
+}
+export interface ReviewSummary {
+    findings: ReviewFinding[];
+    dedupedCount: number;
+    severityCounts: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+}
+export interface PublishResult {
+    publishedCount: number;
+    skippedCount: number;
+    failedCount: number;
+}
+export interface FinalReport {
+    cost: CostEstimate;
+    usage: TokenUsage;
+    sessionId: string | null;
+    memorySaved: boolean;
+}
+export interface DeletedFindingInfo {
+    filePath: string;
+    lineNumber: number;
+    severity: string;
+    title: string;
+    agentId: string;
+    originalSessionId: string;
+    dedupHash: string;
+}
+export interface IntegrityReport {
+    verifiedCount: number;
+    deletedCount: number;
+    untrackableCount: number;
+    deletedFindings: DeletedFindingInfo[];
+    allLegacy: boolean;
+    totalChecked: number;
+}
+export interface SummaryPostResult {
+    /** Bitbucket comment ID of the posted summary. */
+    commentId: number;
+    /** Whether the PR was successfully auto-approved. */
+    approved: boolean;
+}
+export interface WorkflowCallbacks {
+    onPRFetched(pr: PRMetadata): void;
+    onProgress(step: number, totalSteps: number, message: string): void;
+    onAgentsPlanReady?(agentIds: string[], totalAgents: number): void;
+    onAgentStart?(agentId: string, agentIndex: number, totalAgents: number): void;
+    onAgentComplete(agentId: string, agentIndex: number, totalAgents: number, findingsCount?: number, durationMs?: number): void;
+    onAgentFailed?(agentId: string, agentIndex: number, totalAgents: number, error?: string): void;
+    onCostWarning(info: CostWarningInfo): Promise<boolean>;
+    onReviewSummary(summary: ReviewSummary): void;
+    onPublishPrompt(findingsCount: number): Promise<boolean>;
+    onPublishProgress(current: number, total: number, filePath: string): void;
+    onPublishComplete(result: PublishResult): void;
+    /** Called when the PR has no reviewable files (e.g., only test files or excluded paths). */
+    onNoReviewableFiles(): void;
+    /** Called when the orchestrator produced no findings — PR looks good. */
+    onCleanPR(): void;
+    /** Called after the review summary comment is posted to Bitbucket (best-effort). */
+    onSummaryPosted(result: SummaryPostResult): void;
+    /** Called when the PR is auto-approved (clean path, 0 findings only, best-effort). */
+    onAutoApproved(): void;
+    onIntegrityReport(report: IntegrityReport): void;
+    onComplete(report: FinalReport): void;
+}
+//# sourceMappingURL=workflow-callbacks.d.ts.map

package/dist/core/workflow-callbacks.d.ts.map

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

package/dist/core/workflow-callbacks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow-callbacks.js.map

package/dist/core/workflow-callbacks.js.map

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

package/dist/core/workflow-engine.d.ts

@@ -0,0 +1,48 @@
+import type { BitbucketClient } from '../bitbucket/client.js';
+import type { ModelProvider, PrismConfig } from '../types/index.js';
+import type { ReviewMemoryService } from '../memory/review-memory-service.js';
+import type { ReviewOrchestrator } from '../ai/orchestrator/orchestrator.js';
+import type { CommentPublisher } from './comment-publisher.js';
+import type { SessionManager } from './session-manager.js';
+import type { Logger } from '../utils/logger.js';
+import type { WorkflowCallbacks } from './workflow-callbacks.js';
+import type { RepoConfig } from '../types/repo-config.js';
+import type { ProfileRepository } from '../persistence/profile-repository.js';
+export interface WorkflowEngineDeps {
+    bbClient: BitbucketClient;
+    provider: ModelProvider;
+    reviewMemory: ReviewMemoryService;
+    sessionManager: SessionManager;
+    publisher: CommentPublisher;
+    orchestrator: ReviewOrchestrator;
+    logger: Logger;
+    config: PrismConfig;
+    repoConfig?: RepoConfig;
+    profileRepository?: ProfileRepository;
+}
+export interface WorkflowInput {
+    workspace: string;
+    repo: string;
+    prId: number;
+    /** When provided (non-empty), restricts the review to these agent IDs. */
+    agentIds?: string[];
+    /** When provided, filters findings below this severity after orchestration. */
+    minSeverity?: import('../types/review-finding.js').FindingSeverity;
+}
+/**
+ * Core 16-step review workflow engine.
+ *
+ * Coordinates: Bitbucket fetches → integrity check → diff parsing →
+ * agent dispatch → deduplication → callbacks for each significant event.
+ *
+ * All terminal I/O is delegated to WorkflowCallbacks — this class is
+ * purely orchestration logic, testable without any readline or stdout.
+ */
+export declare class WorkflowEngine {
+    private readonly deps;
+    private readonly callbacks;
+    constructor(deps: WorkflowEngineDeps, callbacks: WorkflowCallbacks);
+    execute(input: WorkflowInput): Promise<void>;
+    private sortBySeverity;
+}
+//# sourceMappingURL=workflow-engine.d.ts.map

package/dist/core/workflow-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-engine.d.ts","sourceRoot":"","sources":["../../src/core/workflow-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAwB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,OAAO,KAAK,EAAE,kBAAkB,EAA2C,MAAM,oCAAoC,CAAC;AACtH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,yBAAyB,CAAC;AAGpF,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAe9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,mBAAmB,CAAC;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,YAAY,EAAE,kBAAkB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,4BAA4B,EAAE,eAAe,CAAC;CACpE;AAID;;;;;;;;GAQG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,iBAAiB;IAGzC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAmclD,OAAO,CAAC,cAAc;CAMvB"}