@hstm-labs/forge-verifier

Specification compliance verification and automated test generation for Forge — maps requirements to artifacts, calculates coverage scores, detects gaps, incorporates review findings, and generates test files from acceptance criteria.

Installation

npm install @hstm-labs/forge-verifier

Public API

Compliance Verification

• VerifyStage — pipeline stage for compliance verification
• mapRequirementsToArtifacts() — map spec requirements to generated artifacts
• calculateCoverage() — compute coverage score from mappings
• detectGaps() — identify uncovered or partially covered requirements
• incorporateReviewFindings() — merge AI review findings into compliance report
• buildComplianceReport() — assemble final compliance report
• formatComplianceReport(), complianceReportToJson() — output formatters

Test Generation

• TestGenerateStage — pipeline stage for LLM-driven test generation
• TestOutputValidator — validates generated test output
• extractTestCriteria() — extract testable criteria from acceptance criteria

Types

• ComplianceReport, RequirementCoverage, CoverageEvidence — compliance types
• ComplianceGap, ReviewFindingSummary — gap analysis types
• TestArtifact, TestFile, TestTraceability, TestMetadata — test generation types
• TestCriterion — extracted test criterion

Usage

import { VerifyStage, formatComplianceReport } from '@hstm-labs/forge-verifier';

const stage = new VerifyStage();
const result = await stage.execute(input);
console.log(formatComplianceReport(result.data));

License

MIT