@hstm-labs/forge-reviewer

Multi-pass AI code review stage for Forge — performs file-level, cross-file, spec-alignment, and synthesis review passes across all generated artifacts, producing structured findings with severity and remediation guidance.

Installation

npm install @hstm-labs/forge-reviewer

Public API

Types

• CodeReviewReport — complete review output with findings and summary
• CodeReviewFinding — individual finding with file, line, severity, remediation
• ReviewDimension — review category (correctness, security, performance, etc.)
• ReviewPassResult — output from a single review pass
• ReviewFile — file metadata for review input

Classes

• ReviewStage — pipeline stage implementing PipelineStage interface (4 LLM calls)
• ReviewPassValidator — validates individual review pass output
• ReviewSynthesisValidator — validates final synthesis output

Functions

• collectReviewFiles(artifactsDir) — gather generated files for review input

Usage

import { ReviewStage } from '@hstm-labs/forge-reviewer';

const stage = new ReviewStage();
const result = await stage.execute(input);
// result.data contains CodeReviewReport with findings from all 4 passes

License

MIT