qfai 0.3.8 → 0.4.2

package/dist/index.d.cts

@@ -1,5 +1,17 @@
+type ScCoverage = {
+    total: number;
+    covered: number;
+    missing: number;
+    missingIds: string[];
+    refs: Record<string, string[]>;
+};
+type TestFileScan = {
+    globs: string[];
+    excludeGlobs: string[];
+    matchedFileCount: number;
+};
+
 type IssueSeverity = "info" | "warning" | "error";
-declare const VALIDATION_SCHEMA_VERSION: "0.2";
 type IssueLocation = {
     line: number;
     column?: number;
@@ -18,11 +30,15 @@ type ValidationCounts = {
     warning: number;
     error: number;
 };
+type ValidationTraceability = {
+    sc: ScCoverage;
+    testFiles: TestFileScan;
+};
 type ValidationResult = {
-    schemaVersion: typeof VALIDATION_SCHEMA_VERSION;
     toolVersion: string;
     issues: Issue[];
     counts: ValidationCounts;
+    traceability?: ValidationTraceability;
 };
 
 type FailOn = "never" | "warning" | "error";
@@ -45,6 +61,10 @@ type QfaiValidationConfig = {
     traceability: {
         brMustHaveSc: boolean;
         scMustTouchContracts: boolean;
+        scMustHaveTest: boolean;
+        testFileGlobs: string[];
+        testFileExcludeGlobs: string[];
+        scNoTestSeverity: TraceabilitySeverity;
         allowOrphanContracts: boolean;
         unknownContractIdSeverity: TraceabilitySeverity;
     };
@@ -95,6 +115,9 @@ type ReportIds = {
 type ReportTraceability = {
     upstreamIdsFound: number;
     referencedInCodeOrTests: boolean;
+    sc: ScCoverage;
+    scSources: Record<string, string[]>;
+    testFiles: TestFileScan;
 };
 type ReportData = {
     tool: "qfai";
@@ -130,4 +153,4 @@ declare function validateSpecContent(text: string, file: string, requiredSection
 
 declare function validateTraceability(root: string, config: QfaiConfig): Promise<Issue[]>;
 
-export { type ConfigLoadResult, type ConfigPathKey, type FailOn, type IdFormatPrefix, type IdPrefix, type Issue, type IssueLocation, type IssueSeverity, type OutputFormat, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiValidationConfig, type ReportData, type ReportIds, type ReportSummary, type ReportTraceability, type TraceabilitySeverity, VALIDATION_SCHEMA_VERSION, type ValidationCounts, type ValidationResult, createReportData, defaultConfig, extractAllIds, extractIds, extractInvalidIds, formatReportJson, formatReportMarkdown, getConfigPath, lintSql, loadConfig, resolvePath, resolveToolVersion, validateContracts, validateDefinedIds, validateDeltas, validateProject, validateScenarioContent, validateScenarios, validateSpecContent, validateSpecs, validateTraceability };
+export { type ConfigLoadResult, type ConfigPathKey, type FailOn, type IdFormatPrefix, type IdPrefix, type Issue, type IssueLocation, type IssueSeverity, type OutputFormat, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiValidationConfig, type ReportData, type ReportIds, type ReportSummary, type ReportTraceability, type TraceabilitySeverity, type ValidationCounts, type ValidationResult, type ValidationTraceability, createReportData, defaultConfig, extractAllIds, extractIds, extractInvalidIds, formatReportJson, formatReportMarkdown, getConfigPath, lintSql, loadConfig, resolvePath, resolveToolVersion, validateContracts, validateDefinedIds, validateDeltas, validateProject, validateScenarioContent, validateScenarios, validateSpecContent, validateSpecs, validateTraceability };

package/dist/index.d.ts

@@ -1,2 +1,156 @@
-export * from "./core/index.js";
-//# sourceMappingURL=index.d.ts.map
+type ScCoverage = {
+    total: number;
+    covered: number;
+    missing: number;
+    missingIds: string[];
+    refs: Record<string, string[]>;
+};
+type TestFileScan = {
+    globs: string[];
+    excludeGlobs: string[];
+    matchedFileCount: number;
+};
+
+type IssueSeverity = "info" | "warning" | "error";
+type IssueLocation = {
+    line: number;
+    column?: number;
+};
+type Issue = {
+    code: string;
+    severity: IssueSeverity;
+    message: string;
+    file?: string;
+    refs?: string[];
+    rule?: string;
+    loc?: IssueLocation;
+};
+type ValidationCounts = {
+    info: number;
+    warning: number;
+    error: number;
+};
+type ValidationTraceability = {
+    sc: ScCoverage;
+    testFiles: TestFileScan;
+};
+type ValidationResult = {
+    toolVersion: string;
+    issues: Issue[];
+    counts: ValidationCounts;
+    traceability?: ValidationTraceability;
+};
+
+type FailOn = "never" | "warning" | "error";
+type OutputFormat = "text" | "github";
+type TraceabilitySeverity = "warning" | "error";
+type QfaiPaths = {
+    contractsDir: string;
+    specsDir: string;
+    rulesDir: string;
+    outDir: string;
+    promptsDir: string;
+    srcDir: string;
+    testsDir: string;
+};
+type QfaiValidationConfig = {
+    failOn: FailOn;
+    require: {
+        specSections: string[];
+    };
+    traceability: {
+        brMustHaveSc: boolean;
+        scMustTouchContracts: boolean;
+        scMustHaveTest: boolean;
+        testFileGlobs: string[];
+        testFileExcludeGlobs: string[];
+        scNoTestSeverity: TraceabilitySeverity;
+        allowOrphanContracts: boolean;
+        unknownContractIdSeverity: TraceabilitySeverity;
+    };
+};
+type QfaiOutputConfig = {
+    validateJsonPath: string;
+};
+type QfaiConfig = {
+    paths: QfaiPaths;
+    validation: QfaiValidationConfig;
+    output: QfaiOutputConfig;
+};
+type ConfigPathKey = keyof QfaiPaths;
+type ConfigLoadResult = {
+    config: QfaiConfig;
+    issues: Issue[];
+    configPath: string;
+};
+declare const defaultConfig: QfaiConfig;
+declare function getConfigPath(root: string): string;
+declare function loadConfig(root: string): Promise<ConfigLoadResult>;
+declare function resolvePath(root: string, config: QfaiConfig, key: ConfigPathKey): string;
+
+type IdPrefix = "SPEC" | "BR" | "SC" | "UI" | "API" | "DATA";
+type IdFormatPrefix = IdPrefix | "ADR";
+declare function extractIds(text: string, prefix: IdPrefix): string[];
+declare function extractAllIds(text: string): string[];
+declare function extractInvalidIds(text: string, prefixes: IdFormatPrefix[]): string[];
+
+type ReportSummary = {
+    specs: number;
+    scenarios: number;
+    contracts: {
+        api: number;
+        ui: number;
+        db: number;
+    };
+    counts: ValidationCounts;
+};
+type ReportIds = {
+    spec: string[];
+    br: string[];
+    sc: string[];
+    ui: string[];
+    api: string[];
+    data: string[];
+};
+type ReportTraceability = {
+    upstreamIdsFound: number;
+    referencedInCodeOrTests: boolean;
+    sc: ScCoverage;
+    scSources: Record<string, string[]>;
+    testFiles: TestFileScan;
+};
+type ReportData = {
+    tool: "qfai";
+    version: string;
+    generatedAt: string;
+    root: string;
+    configPath: string;
+    summary: ReportSummary;
+    ids: ReportIds;
+    traceability: ReportTraceability;
+    issues: Issue[];
+};
+declare function createReportData(root: string, validation?: ValidationResult, configResult?: ConfigLoadResult): Promise<ReportData>;
+declare function formatReportMarkdown(data: ReportData): string;
+declare function formatReportJson(data: ReportData): string;
+
+declare function validateProject(root: string, configResult?: ConfigLoadResult): Promise<ValidationResult>;
+
+declare function resolveToolVersion(): Promise<string>;
+
+declare function validateContracts(root: string, config: QfaiConfig): Promise<Issue[]>;
+declare function lintSql(text: string, file: string): Issue[];
+
+declare function validateDeltas(root: string, config: QfaiConfig): Promise<Issue[]>;
+
+declare function validateDefinedIds(root: string, config: QfaiConfig): Promise<Issue[]>;
+
+declare function validateScenarios(root: string, config: QfaiConfig): Promise<Issue[]>;
+declare function validateScenarioContent(text: string, file: string): Issue[];
+
+declare function validateSpecs(root: string, config: QfaiConfig): Promise<Issue[]>;
+declare function validateSpecContent(text: string, file: string, requiredSections: string[]): Issue[];
+
+declare function validateTraceability(root: string, config: QfaiConfig): Promise<Issue[]>;
+
+export { type ConfigLoadResult, type ConfigPathKey, type FailOn, type IdFormatPrefix, type IdPrefix, type Issue, type IssueLocation, type IssueSeverity, type OutputFormat, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiValidationConfig, type ReportData, type ReportIds, type ReportSummary, type ReportTraceability, type TraceabilitySeverity, type ValidationCounts, type ValidationResult, type ValidationTraceability, createReportData, defaultConfig, extractAllIds, extractIds, extractInvalidIds, formatReportJson, formatReportMarkdown, getConfigPath, lintSql, loadConfig, resolvePath, resolveToolVersion, validateContracts, validateDefinedIds, validateDeltas, validateProject, validateScenarioContent, validateScenarios, validateSpecContent, validateSpecs, validateTraceability };