prism-pr 1.0.0-alpha.47

package/dist/config/repo-config-loader.js

@@ -0,0 +1,103 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { parse as parseYaml, YAMLParseError } from 'yaml';
+import { repoConfigSchema } from '../types/repo-config.js';
+export class ConfigParseError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ConfigParseError';
+    }
+}
+export class ConfigValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.issues = issues;
+        this.name = 'ConfigValidationError';
+    }
+}
+const CONFIG_FILE_NAMES = ['.prism.yml', '.prism.yaml', 'prism.config.yml', 'prism.config.yaml'];
+export class RepoConfigLoader {
+    /**
+     * Load repo config from the first matching config file in rootPath.
+     * Returns {} if no config file is found.
+     */
+    async load(rootPath) {
+        for (const name of CONFIG_FILE_NAMES) {
+            const filePath = path.join(rootPath, name);
+            try {
+                const content = readFileSync(filePath, 'utf-8');
+                return this.loadFromString(content);
+            }
+            catch (err) {
+                // File not found — try next
+                if (err.code === 'ENOENT') {
+                    continue;
+                }
+                // Re-throw ConfigParseError / ConfigValidationError as-is
+                if (err instanceof ConfigParseError || err instanceof ConfigValidationError) {
+                    throw err;
+                }
+                throw err;
+            }
+        }
+        return {};
+    }
+    /**
+     * Parse and validate a YAML string as a RepoConfig.
+     * Throws ConfigParseError on invalid YAML, ConfigValidationError on schema failure.
+     */
+    loadFromString(yaml) {
+        let parsed;
+        try {
+            parsed = parseYaml(yaml);
+        }
+        catch (err) {
+            if (err instanceof YAMLParseError) {
+                throw new ConfigParseError(`Invalid YAML: ${err.message}`, err);
+            }
+            throw new ConfigParseError(`Failed to parse YAML`, err);
+        }
+        // Empty YAML (null / undefined) → treat as empty config
+        if (parsed === null || parsed === undefined) {
+            return {};
+        }
+        const result = repoConfigSchema.safeParse(parsed);
+        if (!result.success) {
+            const issues = result.error.issues.map((issue) => ({
+                path: issue.path,
+                message: issue.message,
+            }));
+            throw new ConfigValidationError(`Invalid repo config: ${issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ')}`, issues);
+        }
+        return result.data;
+    }
+}
+/**
+ * Merge global PrismConfig with repo-level RepoConfig.
+ * Repo config fields take precedence over global config defaults.
+ */
+export function mergeConfigs(global, repo) {
+    const merged = { ...global };
+    if (repo.model !== undefined) {
+        merged.defaultModel = repo.model;
+    }
+    if (repo.maxDiffLines !== undefined) {
+        merged.maxDiffLines = repo.maxDiffLines;
+    }
+    // Pass through all repo-specific fields
+    if (repo.agents !== undefined)
+        merged.agents = repo.agents;
+    if (repo.conventions !== undefined)
+        merged.conventions = repo.conventions;
+    if (repo.conventionsFile !== undefined)
+        merged.conventionsFile = repo.conventionsFile;
+    if (repo.skills !== undefined)
+        merged.skills = repo.skills;
+    if (repo.excludePatterns !== undefined)
+        merged.excludePatterns = repo.excludePatterns;
+    return merged;
+}
+//# sourceMappingURL=repo-config-loader.js.map

package/dist/config/repo-config-loader.js.map

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

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

@@ -0,0 +1,35 @@
+import readline from 'node:readline';
+import type { PRMetadata } from '../types/index.js';
+import type { WorkflowCallbacks, CostWarningInfo, ReviewSummary, PublishResult, FinalReport, IntegrityReport, SummaryPostResult } from './workflow-callbacks.js';
+/**
+ * CLI implementation of WorkflowCallbacks.
+ *
+ * Reproduces the exact terminal output that ReviewWorkflow originally produced:
+ * - stderr for progress/status messages
+ * - stdout for user-facing tables and final reports
+ * - readline for interactive prompts
+ */
+export declare class CLIWorkflowCallbacks implements WorkflowCallbacks {
+    private readonly rl;
+    constructor(readlineFn?: () => readline.Interface);
+    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;
+    onNoReviewableFiles(): void;
+    onIntegrityReport(report: IntegrityReport): void;
+    onCleanPR(): void;
+    onSummaryPosted(result: SummaryPostResult): void;
+    onAutoApproved(): void;
+    onComplete(report: FinalReport): void;
+    private prompt;
+    private isYes;
+}
+//# sourceMappingURL=cli-workflow-callbacks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-workflow-callbacks.d.ts","sourceRoot":"","sources":["../../src/core/cli-workflow-callbacks.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,EACf,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AASjC;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IAC5D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA2B;gBAElC,UAAU,CAAC,EAAE,MAAM,QAAQ,CAAC,SAAS;IAUjD,WAAW,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI;IAIjC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIjE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI/E,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7H,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvF,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5D,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IA8BvC,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9D,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKzE,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAM9C,mBAAmB,IAAI,IAAI;IAI3B,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAmBhD,SAAS,IAAI,IAAI;IAIjB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAOhD,cAAc,IAAI,IAAI;IAItB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAWrC,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,KAAK;CAGd"}

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

@@ -0,0 +1,141 @@
+import readline from 'node:readline';
+import Table from 'cli-table3';
+import { formatCost } from '../utils/cost-estimator.js';
+const SEV_LABELS = {
+    critical: 'CRITICAL',
+    high: 'HIGH',
+    medium: 'MEDIUM',
+    low: 'LOW',
+};
+/**
+ * CLI implementation of WorkflowCallbacks.
+ *
+ * Reproduces the exact terminal output that ReviewWorkflow originally produced:
+ * - stderr for progress/status messages
+ * - stdout for user-facing tables and final reports
+ * - readline for interactive prompts
+ */
+export class CLIWorkflowCallbacks {
+    rl;
+    constructor(readlineFn) {
+        this.rl =
+            readlineFn ??
+                (() => readline.createInterface({
+                    input: process.stdin,
+                    output: process.stderr,
+                }));
+    }
+    onPRFetched(pr) {
+        process.stderr.write(`  PR: ${pr.title}\n`);
+    }
+    onProgress(_step, _totalSteps, message) {
+        process.stderr.write(`${message}\n`);
+    }
+    onAgentsPlanReady(_agentIds, totalAgents) {
+        process.stderr.write(`Running ${totalAgents} agents...\n`);
+    }
+    onAgentStart(_agentId, _agentIndex, _totalAgents) {
+        // no-op — too noisy for CI
+    }
+    onAgentComplete(agentId, agentIndex, totalAgents, findingsCount, _durationMs) {
+        process.stderr.write(`  ✓ ${agentId} (${agentIndex + 1}/${totalAgents})${findingsCount !== undefined ? ' — ' + findingsCount + ' findings' : ''}\n`);
+    }
+    onAgentFailed(agentId, agentIndex, totalAgents, error) {
+        process.stderr.write(`  ✗ ${agentId} (${agentIndex + 1}/${totalAgents})${error !== undefined ? ' — ' + error : ''}\n`);
+    }
+    async onCostWarning(info) {
+        const costStr = `~$${info.estimatedCost.toFixed(2)}`;
+        const answer = await this.prompt(`⚠ Large diff detected (${info.totalLines} lines). Estimated cost: ${costStr}. Continue? [y/N]: `);
+        return this.isYes(answer);
+    }
+    onReviewSummary(summary) {
+        const { findings, dedupedCount, severityCounts } = summary;
+        const table = new Table({
+            head: ['File', 'Line', 'Sev', 'Title'],
+            style: { head: [] },
+            colWidths: [40, 8, 10, 35],
+        });
+        for (const f of findings) {
+            table.push([
+                f.filePath.length > 38 ? '...' + f.filePath.slice(-35) : f.filePath,
+                String(f.lineNumber),
+                SEV_LABELS[f.severity] ?? f.severity.toUpperCase(),
+                f.title.length > 33 ? f.title.slice(0, 30) + '...' : f.title,
+            ]);
+        }
+        process.stdout.write(table.toString() + '\n');
+        process.stdout.write(`\nTotal: ${findings.length} findings (${severityCounts.critical} critical, ${severityCounts.high} high, ${severityCounts.medium} medium, ${severityCounts.low} low)\n`);
+        if (dedupedCount > 0) {
+            process.stdout.write(`Deduped: ${dedupedCount} (already posted)\n`);
+        }
+        process.stdout.write('\n');
+    }
+    async onPublishPrompt(findingsCount) {
+        const answer = await this.prompt(`Publish ${findingsCount} findings? [y/N]: `);
+        return this.isYes(answer);
+    }
+    onPublishProgress(current, total, filePath) {
+        if (current === 0)
+            return;
+        process.stderr.write(`  Publishing comment ${current}/${total}: ${filePath}\n`);
+    }
+    onPublishComplete(result) {
+        process.stderr.write(`Published: ${result.publishedCount} | Skipped: ${result.skippedCount} | Failed: ${result.failedCount}\n`);
+    }
+    onNoReviewableFiles() {
+        process.stdout.write('No reviewable files found after applying exclusion filters\n');
+    }
+    onIntegrityReport(report) {
+        if (report.totalChecked === 0)
+            return;
+        if (report.allLegacy) {
+            process.stderr.write(`Comment integrity: ${report.untrackableCount} prior findings have no tracked IDs (pre-fix data)\n`);
+            return;
+        }
+        if (report.deletedCount > 0) {
+            process.stderr.write(`⚠ Comment integrity: ${report.deletedCount} comment(s) were deleted from Bitbucket\n`);
+            for (const f of report.deletedFindings) {
+                process.stderr.write(`  • ${f.filePath}:${f.lineNumber} [${f.severity}] ${f.title}\n`);
+            }
+            process.stderr.write('  These findings will be re-reviewed.\n');
+            return;
+        }
+        if (report.verifiedCount > 0) {
+            process.stderr.write(`✓ Comment integrity: ${report.verifiedCount} prior comment(s) verified\n`);
+        }
+    }
+    onCleanPR() {
+        process.stdout.write('✓ No issues found — the PR looks good!\n');
+    }
+    onSummaryPosted(result) {
+        process.stderr.write(`✓ Review summary posted (comment #${result.commentId})\n`);
+        if (result.approved) {
+            process.stderr.write('✓ PR auto-approved\n');
+        }
+    }
+    onAutoApproved() {
+        // no-op — approval info already surfaced in onSummaryPosted
+    }
+    onComplete(report) {
+        process.stdout.write('\nReview complete.\n');
+        process.stdout.write(`Cost estimate: ${formatCost(report.cost, report.usage)}\n`);
+        if (report.sessionId) {
+            process.stdout.write(`Session ID: ${report.sessionId} (saved to local DB)\n`);
+        }
+        process.stdout.write('Memory: ✓ Saved to local DB\n');
+    }
+    // ── Private helpers ──────────────────────────────────────────────────────────
+    prompt(question) {
+        return new Promise((resolve) => {
+            const rl = this.rl();
+            rl.question(question, (answer) => {
+                rl.close();
+                resolve(answer.trim());
+            });
+        });
+    }
+    isYes(answer) {
+        return /^y(es)?$/i.test(answer.trim());
+    }
+}
+//# sourceMappingURL=cli-workflow-callbacks.js.map

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

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

package/dist/core/comment-publisher.d.ts

@@ -0,0 +1,61 @@
+import type { BitbucketClient } from '../bitbucket/client.js';
+import type { Logger } from '../utils/logger.js';
+import type { ReviewFinding, DiffFile } from '../types/index.js';
+/** Result returned by `CommentPublisher.publish()`. */
+export interface PublishResult {
+    publishedCount: number;
+    skippedCount: number;
+    failedCount: number;
+    /** Maps skip reason → count (e.g. 'excluded-file' → 2). */
+    skippedReasons: Map<string, number>;
+    /** True when an unrecoverable error forced early termination. */
+    aborted: boolean;
+    /** Maps dedupHash → Bitbucket comment ID for every successfully published finding. */
+    commentIds: Map<string, number>;
+}
+/** Options for controlling behavior in tests (sleep duration, custom sleep fn). */
+export interface CommentPublisherOptions {
+    /** Milliseconds to wait between successful posts (default: 500). */
+    sleepMs?: number;
+    /** Injectable sleep function — defaults to a real setTimeout-based delay. */
+    sleepFn?: (ms: number) => Promise<void>;
+}
+/**
+ * Publishes `ReviewFinding[]` as inline comments on a Bitbucket pull request.
+ *
+ * Each finding is validated before posting. Errors are handled per spec 10.3.2:
+ *  - 400 → skip finding, continue
+ *  - 429 → wait retryAfter + retry once; second 429 → abort
+ *  - 401 / 403 / 404 / 5xx → abort all remaining
+ */
+export declare class CommentPublisher {
+    private readonly client;
+    private readonly logger;
+    private readonly sleepMs;
+    private readonly sleepFn;
+    constructor(client: BitbucketClient, logger: Logger, options?: CommentPublisherOptions);
+    publish(workspace: string, repo: string, prId: number, findings: ReviewFinding[], parsedFiles: DiffFile[], onProgress?: (current: number, total: number, filePath: string) => void, dedupHashes?: Map<string, string>): Promise<PublishResult>;
+    /**
+     * Validates a finding before posting.
+     * Returns a skip reason string, or null if valid.
+     *
+     * Validation order (spec 10.2.2):
+     *  1. excluded file
+     *  2. invalid line (lineNumber <= 0 or not an addition line in parsed diff)
+     *  3. empty comment (formatFinding produces empty string)
+     */
+    private validate;
+    /**
+     * Returns true if `lineNumber` corresponds to an addition line for `filePath`
+     * in the provided parsed diff files.
+     */
+    private isValidAdditionLine;
+    /**
+     * Attempts to post a single finding comment, including 429 retry logic.
+     *
+     * Returns `{ continue: true, commentId }` when the loop should continue.
+     * Returns `{ continue: false, commentId: null }` when processing must stop (abort set on result).
+     */
+    private attemptPost;
+}
+//# sourceMappingURL=comment-publisher.d.ts.map

package/dist/core/comment-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-publisher.d.ts","sourceRoot":"","sources":["../../src/core/comment-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAW9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAmB,MAAM,mBAAmB,CAAC;AAElF,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,mFAAmF;AACnF,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAGrC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EAC/B,OAAO,GAAE,uBAA4B;IAUjC,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,QAAQ,EAAE,EACvB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,EACvE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,aAAa,CAAC;IA+DzB;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;;;OAKG;YACW,WAAW;CAkF1B"}

package/dist/core/comment-publisher.js

@@ -0,0 +1,172 @@
+import { BitbucketValidationError, BitbucketAuthError, BitbucketForbiddenError, BitbucketNotFoundError, BitbucketRateLimitError, BitbucketServerError, } from '../bitbucket/errors.js';
+import { formatFinding } from '../utils/comment-formatter.js';
+import { isExcluded } from '../utils/file-filter.js';
+/**
+ * Publishes `ReviewFinding[]` as inline comments on a Bitbucket pull request.
+ *
+ * Each finding is validated before posting. Errors are handled per spec 10.3.2:
+ *  - 400 → skip finding, continue
+ *  - 429 → wait retryAfter + retry once; second 429 → abort
+ *  - 401 / 403 / 404 / 5xx → abort all remaining
+ */
+export class CommentPublisher {
+    client;
+    logger;
+    sleepMs;
+    sleepFn;
+    constructor(client, logger, options = {}) {
+        this.client = client;
+        this.logger = logger;
+        this.sleepMs = options.sleepMs ?? 500;
+        this.sleepFn =
+            options.sleepFn ??
+                ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    async publish(workspace, repo, prId, findings, parsedFiles, onProgress, dedupHashes) {
+        const result = {
+            publishedCount: 0,
+            skippedCount: 0,
+            failedCount: 0,
+            skippedReasons: new Map(),
+            aborted: false,
+            commentIds: new Map(),
+        };
+        const total = findings.length;
+        let current = 0;
+        for (const finding of findings) {
+            if (result.aborted)
+                break;
+            // Validate before attempting to post
+            const skipReason = this.validate(finding, parsedFiles);
+            if (skipReason !== null) {
+                result.skippedCount++;
+                result.skippedReasons.set(skipReason, (result.skippedReasons.get(skipReason) ?? 0) + 1);
+                this.logger.debug(`[publisher] Skipping ${finding.filePath}:${finding.lineNumber} — ${skipReason}`);
+                current++;
+                onProgress?.(current, total, finding.filePath);
+                continue;
+            }
+            // Attempt to post (handles retry + abort logic)
+            const { continue: shouldContinue, commentId } = await this.attemptPost(workspace, repo, prId, finding, result);
+            // Capture comment ID if provided and the post succeeded
+            if (commentId !== null && dedupHashes !== undefined) {
+                const key = `${finding.filePath}:${finding.lineNumber}`;
+                const hash = dedupHashes.get(key);
+                if (hash !== undefined) {
+                    result.commentIds.set(hash, commentId);
+                }
+            }
+            if (!shouldContinue)
+                break;
+            // Delay between posts (spec 10.3.1: 500ms between each successful post)
+            if (this.sleepMs > 0) {
+                await this.sleepFn(this.sleepMs);
+            }
+            current++;
+            onProgress?.(current, total, finding.filePath);
+        }
+        return result;
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    /**
+     * Validates a finding before posting.
+     * Returns a skip reason string, or null if valid.
+     *
+     * Validation order (spec 10.2.2):
+     *  1. excluded file
+     *  2. invalid line (lineNumber <= 0 or not an addition line in parsed diff)
+     *  3. empty comment (formatFinding produces empty string)
+     */
+    validate(finding, files) {
+        // 1. Excluded file
+        if (isExcluded(finding.filePath)) {
+            return 'excluded-file';
+        }
+        // 2. Invalid line number
+        if (finding.lineNumber <= 0 || !this.isValidAdditionLine(finding.filePath, finding.lineNumber, files)) {
+            return 'invalid-line';
+        }
+        // 3. Empty comment
+        const formatted = formatFinding(finding);
+        if (!formatted || formatted.trim().length === 0) {
+            return 'empty-comment';
+        }
+        return null;
+    }
+    /**
+     * Returns true if `lineNumber` corresponds to an addition line for `filePath`
+     * in the provided parsed diff files.
+     */
+    isValidAdditionLine(filePath, lineNumber, files) {
+        const file = files.find((f) => f.newPath === filePath);
+        if (!file)
+            return false;
+        return file.hunks.some((hunk) => hunk.lines.some((line) => line.type === 'addition' && line.lineNumber === lineNumber));
+    }
+    /**
+     * Attempts to post a single finding comment, including 429 retry logic.
+     *
+     * Returns `{ continue: true, commentId }` when the loop should continue.
+     * Returns `{ continue: false, commentId: null }` when processing must stop (abort set on result).
+     */
+    async attemptPost(workspace, repo, prId, finding, result) {
+        const body = {
+            content: { raw: formatFinding(finding) },
+            inline: {
+                to: finding.lineNumber,
+                path: finding.filePath,
+            },
+        };
+        try {
+            const comment = await this.client.postInlineComment(workspace, repo, prId, body);
+            result.publishedCount++;
+            this.logger.debug(`[publisher] Published ${finding.filePath}:${finding.lineNumber}`);
+            return { continue: true, commentId: comment.id };
+        }
+        catch (firstErr) {
+            // 400 — skip this finding, continue
+            if (firstErr instanceof BitbucketValidationError) {
+                result.skippedCount++;
+                result.skippedReasons.set('api-validation', (result.skippedReasons.get('api-validation') ?? 0) + 1);
+                this.logger.warn(`[publisher] Skipped ${finding.filePath}:${finding.lineNumber} — Bitbucket 400: ${firstErr.detail}`);
+                return { continue: true, commentId: null };
+            }
+            // 429 — wait retryAfter and retry once
+            if (firstErr instanceof BitbucketRateLimitError) {
+                const waitMs = firstErr.retryAfter * 1000;
+                this.logger.warn(`[publisher] Rate limited — waiting ${firstErr.retryAfter}s before retry`);
+                await this.sleepFn(waitMs);
+                try {
+                    const comment = await this.client.postInlineComment(workspace, repo, prId, body);
+                    result.publishedCount++;
+                    this.logger.debug(`[publisher] Published (after retry) ${finding.filePath}:${finding.lineNumber}`);
+                    return { continue: true, commentId: comment.id };
+                }
+                catch (_retryErr) {
+                    // Second failure (another 429 or anything else) → abort
+                    result.failedCount++;
+                    result.aborted = true;
+                    this.logger.error(`[publisher] Rate limit retry failed — aborting remaining findings`);
+                    return { continue: false, commentId: null };
+                }
+            }
+            // 401, 403, 404, 5xx — abort all remaining
+            if (firstErr instanceof BitbucketAuthError ||
+                firstErr instanceof BitbucketForbiddenError ||
+                firstErr instanceof BitbucketNotFoundError ||
+                firstErr instanceof BitbucketServerError) {
+                result.failedCount++;
+                result.aborted = true;
+                this.logger.error(`[publisher] Fatal error on ${finding.filePath}:${finding.lineNumber} — aborting: ${firstErr.message}`);
+                return { continue: false, commentId: null };
+            }
+            // Unknown error — abort
+            result.failedCount++;
+            result.aborted = true;
+            this.logger.error(`[publisher] Unexpected error — aborting: ${String(firstErr)}`);
+            return { continue: false, commentId: null };
+        }
+    }
+}
+//# sourceMappingURL=comment-publisher.js.map

package/dist/core/comment-publisher.js.map

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

package/dist/core/integrity-checker.d.ts

@@ -0,0 +1,22 @@
+import type { BitbucketComment } from '../types/bitbucket.js';
+import type { IntegrityReport } from './workflow-callbacks.js';
+export interface FindingRecord {
+    dedupHash: string;
+    bitbucketCommentId: number | null;
+    filePath: string;
+    lineNumber: number;
+    severity: string;
+    title: string;
+    agentId: string;
+    sessionId: string;
+    createdAt: string;
+}
+/**
+ * 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 declare function checkCommentIntegrity(priorFindings: FindingRecord[], existingComments: BitbucketComment[]): IntegrityReport;
+//# sourceMappingURL=integrity-checker.d.ts.map

package/dist/core/integrity-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity-checker.d.ts","sourceRoot":"","sources":["../../src/core/integrity-checker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAsB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,aAAa,EAAE,EAC9B,gBAAgB,EAAE,gBAAgB,EAAE,GACnC,eAAe,CAkFjB"}