api-tests-coverage 1.0.17 → 1.0.19

package/dist/src/generation/types.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Feature 28 — Test Generation & Quality Intelligence Engine
+ * Type definitions for the test generation pipeline.
+ */
+export type GapType = 'endpoint' | 'parameter' | 'error' | 'business' | 'integration' | 'security' | 'auth';
+export type GapPriority = 'P0' | 'P1' | 'P2' | 'P3' | 'P4' | 'P5';
+export type TestType = 'unit' | 'integration' | 'cypress' | 'security';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+export type AuthType = 'jwt' | 'basic' | 'oauth2' | 'apikey';
+export type ParameterLocation = 'query' | 'path' | 'header' | 'body';
+export type MissingCase = 'boundary-min' | 'boundary-max' | 'invalid-type' | 'missing-required' | 'sql-injection' | 'xss';
+export type SecurityControlType = 'sql-injection' | 'xss' | 'auth-bypass' | 'rate-limit' | 'mass-assignment';
+export type FileNamingConvention = 'kebab' | 'camelCase' | 'snake_case';
+export interface DetectedGap {
+    id: string;
+    type: GapType;
+    priority: GapPriority;
+    riskScore: number;
+    endpoint: {
+        method: HttpMethod;
+        path: string;
+        operationId?: string;
+        summary?: string;
+        tags?: string[];
+        auth: {
+            required: boolean;
+            optional: boolean;
+            type?: AuthType;
+            headerName?: string;
+            scheme?: string;
+        };
+    };
+    parameters?: ParameterInfo[];
+    responses?: ResponseInfo[];
+    businessRule?: BusinessRuleInfo;
+    securityControl?: SecurityControlInfo;
+    flow?: FlowInfo;
+}
+export interface ParameterInfo {
+    name: string;
+    in: ParameterLocation;
+    required: boolean;
+    schema: {
+        type: string;
+        format?: string;
+        minimum?: number;
+        maximum?: number;
+        minLength?: number;
+        maxLength?: number;
+        enum?: unknown[];
+        pattern?: string;
+    };
+    missingCases: MissingCase[];
+}
+export interface ResponseInfo {
+    statusCode: number;
+    description?: string;
+    schema?: unknown;
+}
+export interface BusinessRuleInfo {
+    id: string;
+    description: string;
+    condition: string;
+    acceptanceCriteria: string[];
+}
+export interface SecurityControlInfo {
+    type: SecurityControlType;
+    description: string;
+    attackVector: string;
+    expectedStatusCode: number;
+}
+export interface FlowInfo {
+    id: string;
+    name: string;
+    steps: Array<{
+        method: string;
+        path: string;
+        description: string;
+    }>;
+    missingStepIndex: number;
+}
+export interface GenerationContext {
+    gap: {
+        id: string;
+        type: GapType;
+        priority: GapPriority;
+        riskScore: number;
+    };
+    endpoint: {
+        method: string;
+        path: string;
+        pathNormalized: string;
+        operationId?: string;
+        summary?: string;
+        tags?: string[];
+        auth: {
+            required: boolean;
+            optional: boolean;
+            type?: AuthType;
+            headerName?: string;
+            scheme?: string;
+        };
+    };
+    parameters: ParameterInfo[];
+    responses: ResponseInfo[];
+    fixtures: {
+        validPayload: Record<string, unknown>;
+        invalidPayload: Record<string, unknown>;
+        authToken: string;
+        pathParams: Record<string, string>;
+    };
+    project: {
+        name: string;
+        language: string;
+        framework: string;
+        testFramework: string;
+        baseUrl: string;
+        importPrefix: string;
+    };
+    businessRule?: BusinessRuleInfo;
+    securityControl?: SecurityControlInfo;
+    flow?: FlowInfo;
+}
+export interface GeneratedFile {
+    gapId: string;
+    filePath: string;
+    relativePath: string;
+    content: string;
+    testType: TestType;
+    language: string;
+    framework: string;
+}
+export interface GenerationResult {
+    files: GeneratedFile[];
+    dryRun: boolean;
+    totalGaps: number;
+    generatedCount: number;
+    skippedCount: number;
+    errors: Array<{
+        gapId: string;
+        message: string;
+    }>;
+}
+export interface GenerationOptions {
+    reportsDir: string;
+    outDir: string;
+    language?: string;
+    framework?: string;
+    priority?: GapPriority;
+    dryRun?: boolean;
+    overwrite?: boolean;
+    gapId?: string;
+    types?: GapType[];
+    noSecurity?: boolean;
+    noCypress?: boolean;
+}
+export interface QualityDimensions {
+    assertionDepth: number;
+    negativePathCoverage: number;
+    authCoverage: number;
+    boundaryCoverage: number;
+    testIndependence: number;
+}
+export interface FileQualityScore {
+    file: string;
+    score: number;
+    dimensions: QualityDimensions;
+    issues: string[];
+    strengths: string[];
+}
+export interface HighRiskLowQualityGap {
+    endpoint: string;
+    qualityScore: number;
+    riskScore: number;
+    primaryIssue: string;
+}
+export interface TestQualityReport {
+    overallScore: number;
+    byFile: FileQualityScore[];
+    lowestQualityFiles: string[];
+    highestRiskLowQualityGaps: HighRiskLowQualityGap[];
+}
+export interface QualityScorerOptions {
+    testsGlob?: string;
+    reportsDir?: string;
+    failBelow?: number;
+}
+export interface MissingTestCase {
+    id: string;
+    description: string;
+    expectedStatus: number;
+}
+export interface AiFlowGap {
+    gapId: string;
+    priority: GapPriority;
+    riskScore: number;
+    type: GapType;
+    endpoint: {
+        method: string;
+        path: string;
+        auth: {
+            required: boolean;
+            type?: AuthType;
+            scheme?: string;
+        };
+    };
+    missingTestCases: MissingTestCase[];
+    requestSchema?: unknown;
+    responseSchema?: unknown;
+    copilotPrompt: string;
+    suggestedOutputPath: string;
+    existingSimilarTests: string[];
+    generatedCode?: string;
+}
+export interface AiReadyFlows {
+    generatedAt: string;
+    project: {
+        name: string;
+        language: string;
+        testFramework: string;
+        appImportPath: string;
+    };
+    gaps: AiFlowGap[];
+}
+export interface AiFlowExporterOptions {
+    reportsDir: string;
+    outDir: string;
+    format?: 'markdown' | 'json' | 'both';
+    maxGaps?: number;
+    priority?: GapPriority;
+}
+export interface GenerationConfig {
+    enabled?: boolean;
+    outputDir?: string;
+    dryRun?: boolean;
+    overwrite?: boolean;
+    minPriority?: GapPriority;
+    unitFramework?: string;
+    integrationFramework?: string;
+    e2eFramework?: string;
+    fileNaming?: FileNamingConvention;
+    includeTypes?: GapType[];
+    securityTests?: {
+        enabled?: boolean;
+        includeInjection?: boolean;
+        includeAuthBypass?: boolean;
+        includeRateLimit?: boolean;
+    };
+    fixtures?: {
+        authTokenPlaceholder?: string;
+        baseUrl?: string;
+    };
+}
+export interface TestQualityConfig {
+    enabled?: boolean;
+    minimumScore?: number;
+    enforceOnGlob?: string;
+    excludeGlob?: string;
+    outputPath?: string;
+}
+export interface AiFlowsConfig {
+    enabled?: boolean;
+    outputDir?: string;
+    maxGapsPerExport?: number;
+    minPriority?: GapPriority;
+    includeGeneratedCode?: boolean;
+    copilotPromptMaxTokens?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/generation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/generation/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,OAAO,GACf,UAAU,GACV,WAAW,GACX,OAAO,GACP,UAAU,GACV,aAAa,GACb,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1F,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,KAAK,CAAC;AAEV,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,KAAK,GACL,aAAa,GACb,YAAY,GACZ,iBAAiB,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE;YACJ,QAAQ,EAAE,OAAO,CAAC;YAClB,QAAQ,EAAE,OAAO,CAAC;YAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;YAChB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IACF,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,iBAAiB,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,EAAE,WAAW,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE;YACJ,QAAQ,EAAE,OAAO,CAAC;YAClB,QAAQ,EAAE,OAAO,CAAC;YAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;YAChB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IACF,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yBAAyB,EAAE,qBAAqB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE;YACJ,QAAQ,EAAE,OAAO,CAAC;YAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IACF,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC"}

package/dist/src/generation/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Feature 28 — Test Generation & Quality Intelligence Engine
+ * Type definitions for the test generation pipeline.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/index.js

@@ -63,6 +63,7 @@ const integrationFlowInference_1 = require("./inference/integrationFlowInference
 const routeInference_1 = require("./inference/routeInference");
 const scanManifest_1 = require("./inference/scanManifest");
 const serveDashboard_1 = require("./serveDashboard");
+const index_4 = require("./generation/index");
 // Register all language AST analyzers at startup.
 // This side-effect import ensures each language module's registerAnalyzer() call runs.
 (0, astAnalysisOrchestrator_1.registerAllAnalyzers)();
@@ -2044,6 +2045,118 @@ program
     });
     // Keep the process alive while the server runs
 });
+program
+    .command('generate-tests')
+    .description('Generate test scaffolds for detected coverage gaps')
+    .option('--reports-dir <dir>', 'Directory with coverage reports', 'reports/')
+    .option('--out-dir <dir>', 'Output directory for generated tests', 'generated-tests/')
+    .option('--language <lang>', 'Target language override (auto-detected if omitted)')
+    .option('--framework <fw>', 'Test framework override (auto-detected if omitted)')
+    .option('--priority <p>', 'Only generate for gaps at this priority or higher', 'P1')
+    .option('--dry-run', 'Print generated tests to stdout, do not write files', false)
+    .option('--overwrite', 'Overwrite existing generated files', false)
+    .option('--gap-id <id>', 'Generate tests for a single specific gap')
+    .option('--types <list>', 'Comma-separated gap types to generate (default: all)')
+    .option('--no-security', 'Skip security test generation')
+    .option('--no-cypress', 'Skip Cypress test generation')
+    .action(async (options) => {
+    const types = options.types
+        ? options.types.split(',').map(t => t.trim())
+        : undefined;
+    const result = await (0, index_4.generateTests)({
+        reportsDir: options.reportsDir,
+        outDir: options.outDir,
+        language: options.language,
+        framework: options.framework,
+        priority: options.priority,
+        dryRun: Boolean(options.dryRun),
+        overwrite: Boolean(options.overwrite),
+        gapId: options.gapId,
+        types,
+        noSecurity: Boolean(options.noSecurity),
+        noCypress: Boolean(options.noCypress),
+    });
+    if (result.dryRun) {
+        for (const file of result.files) {
+            console.log(`\n${'='.repeat(60)}`);
+            console.log(`// FILE: ${file.relativePath}`);
+            console.log(`${'='.repeat(60)}`);
+            console.log(file.content);
+        }
+    }
+    else {
+        console.log(`\nTest generation complete:`);
+        console.log(`  Gaps processed:  ${result.totalGaps}`);
+        console.log(`  Files generated: ${result.generatedCount}`);
+        console.log(`  Errors:          ${result.errors.length}`);
+        if (result.errors.length > 0) {
+            for (const err of result.errors) {
+                console.error(`  ERROR [${err.gapId}]: ${err.message}`);
+            }
+        }
+    }
+});
+program
+    .command('export-ai-flows')
+    .description('Export AI-ready flow documentation for Copilot/Cursor/Claude')
+    .option('--reports-dir <dir>', 'Directory with coverage reports', 'reports/')
+    .option('--out-dir <dir>', 'Output directory for AI flow files', 'reports/')
+    .option('--format <fmt>', 'Output format: markdown, json, or both', 'both')
+    .option('--max-gaps <n>', 'Maximum number of gaps to include', '50')
+    .option('--priority <p>', 'Only include gaps at this priority or higher', 'P3')
+    .action(async (options) => {
+    const flows = await (0, index_4.exportAiFlows)({
+        reportsDir: options.reportsDir,
+        outDir: options.outDir,
+        format: options.format,
+        maxGaps: parseInt(options.maxGaps, 10),
+        priority: options.priority,
+    });
+    console.log(`\nAI flows export complete:`);
+    console.log(`  Gaps exported: ${flows.gaps.length}`);
+    console.log(`  Project:       ${flows.project.name}`);
+    console.log(`  Language:      ${flows.project.language}`);
+});
+program
+    .command('score-tests')
+    .description('Score quality of existing test suite on 5 dimensions (0-100)')
+    .option('--tests <glob>', 'Glob pattern for test files to score', 'tests/**/*.test.ts')
+    .option('--reports-dir <dir>', 'Directory to write quality score output', 'reports/')
+    .option('--fail-below <score>', 'Exit non-zero if any file scores below this', '0')
+    .action(async (options) => {
+    var _a;
+    try {
+        const report = await (0, index_4.scoreTests)({
+            testsGlob: options.tests,
+            reportsDir: options.reportsDir,
+            failBelow: parseInt(options.failBelow, 10),
+        });
+        console.log(`\nTest Quality Score Report:`);
+        console.log(`  Overall score: ${report.overallScore}/100`);
+        console.log(`  Files scored:  ${report.byFile.length}`);
+        if (report.lowestQualityFiles.length > 0) {
+            console.log(`\n  Lowest quality files:`);
+            for (const f of report.lowestQualityFiles) {
+                const entry = report.byFile.find(b => b.file === f);
+                console.log(`    ${f}: ${(_a = entry === null || entry === void 0 ? void 0 : entry.score) !== null && _a !== void 0 ? _a : '?'}/100`);
+            }
+        }
+        if (report.highestRiskLowQualityGaps.length > 0) {
+            console.log(`\n  High risk + low quality:`);
+            for (const g of report.highestRiskLowQualityGaps) {
+                console.log(`    ${g.endpoint}: quality=${g.qualityScore}, risk=${g.riskScore}`);
+                console.log(`      → ${g.primaryIssue}`);
+            }
+        }
+        console.log(`\n  Report written to: ${options.reportsDir}/test-quality.json`);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            console.error(err.message);
+        }
+        process.exit(1);
+    }
+});
 // Parse the command-line arguments
 program.parse(process.argv);
 // When invoked with no arguments (no subcommand), display help

package/dist/src/inference/routeInference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routeInference.d.ts","sourceRoot":"","sources":["../../../src/inference/routeInference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,eAAO,MAAM,YAAY,uEAAwE,CAAC;AAClG,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAqFD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAkIrE;AAiWD;;GAEG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAgBxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAY5F"}
+{"version":3,"file":"routeInference.d.ts","sourceRoot":"","sources":["../../../src/inference/routeInference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,eAAO,MAAM,YAAY,uEAAwE,CAAC;AAClG,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmGD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAoJrE;AAkXD;;GAEG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAgBxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAY5F"}

package/dist/src/inference/routeInference.js

@@ -80,7 +80,18 @@ const JSDOC_ROUTE_PATTERN = /@route\s+\{(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)
  * Used to gate the URL+method object-form scan so we only activate it in
  * files that actually make HTTP calls (avoids scanning every JS file).
  */
-const HTTP_CLIENT_SIGNAL = /\$http|\bfetch\s*\(|\baxios\b/;
+const HTTP_CLIENT_SIGNAL = /\$http|\bfetch\s*\(|\baxios\b|\bsuperagent\b/;
+/**
+ * Matches client-side HTTP method calls: requests.get('/path'), api.post('/path'), etc.
+ * Group 1 = HTTP method, Group 2 = path literal starting with /
+ * Also handles: superagent.get(`${base}/path`) → captures the static suffix
+ */
+const HTTP_CLIENT_METHOD_CALL = /\b\w+\s*\.\s*(get|post|put|patch|delete|del|head|options)\s*\(\s*(?:[^'"`\n]*?\+\s*)?['"`](\/[^'"`?\n]+)/i;
+/**
+ * Signals that this JS/TS file is a client-side HTTP service layer.
+ * Expands on HTTP_CLIENT_SIGNAL to include superagent and common wrapper patterns.
+ */
+const HTTP_SERVICE_SIGNAL = /\bsuperagent\b|\brequests\s*\.\s*(?:get|post|put|delete|del)\b|\bapi\s*\.\s*(?:get|post|put|delete)\b/;
 /**
  * Matches a `url:` property that ends with a literal path segment starting
  * with `/`.  Handles both bare and concatenated forms:
@@ -162,6 +173,8 @@ function inferRoutesFromFile(filePath) {
     // We only enable the object-form method+url scanner for such files to
     // avoid false positives in ordinary JS/TS source.
     const usesHttpClient = HTTP_CLIENT_SIGNAL.test(content);
+    // Pre-check: does this file use a client-side HTTP service wrapper (requests.*, api.*, etc.)?
+    const usesHttpServiceWrapper = HTTP_SERVICE_SIGNAL.test(content);
     for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
         const line = lines[lineIdx];
         // 1a. router.method('/path', ...) — all on one line
@@ -239,6 +252,21 @@ function inferRoutesFromFile(filePath) {
                 }
             }
         }
+        // 6. Client-side HTTP method calls: requests.get('/path'), api.post('/path')
+        //    Only activate for files that contain HTTP service signals to avoid false positives
+        if (usesHttpServiceWrapper) {
+            const clientCallMatch = line.match(HTTP_CLIENT_METHOD_CALL);
+            if (clientCallMatch) {
+                let httpMethod = clientCallMatch[1].toLowerCase();
+                // Normalize 'del' → 'delete'
+                if (httpMethod === 'del')
+                    httpMethod = 'delete';
+                if (exports.HTTP_METHODS.includes(httpMethod)) {
+                    const routePath = clientCallMatch[2].split('?')[0]; // strip query string
+                    addRoute(httpMethod, routePath, lineIdx + 1, 'code');
+                }
+            }
+        }
     }
     return [...byKey.values()];
 }
@@ -400,7 +428,7 @@ function findNextMethodNameInJava(javaLines, fromLine) {
  *   @blueprint.route('/articles/<slug>', methods=['PUT'])
  *   @app.route('/tags')   ← defaults to GET
  */
-const FLASK_ROUTE = /@(\w+)\.route\s*\(\s*['"]([^'"]+)['"](?:\s*,\s*methods\s*=\s*\[([^\]]+)\])?\s*\)/;
+const FLASK_ROUTE = /@(\w+)\.route\s*\(\s*['"]([^'"]+)['"](?:[^\n]*?\bmethods\s*=\s*[\[(]([^\])\n]+)[\])])?/;
 /**
  * Matches FastAPI decorators.
  *   @app.get('/articles')
@@ -419,6 +447,22 @@ const FLASK_BLUEPRINT_CTOR = /(\w+)\s*=\s*Blueprint\s*\(\s*['"][^'"]+['"](?:\s*,
  *   router = APIRouter(prefix="/articles")
  */
 const FASTAPI_APIROUTER = /(\w+)\s*=\s*APIRouter\s*\([^)]*?prefix\s*=\s*['"]([^'"]+)['"]/;
+/**
+ * Scan ahead for a Python `def function_name(` line following a decorator.
+ * Skips additional decorator lines and stops at the first non-decorator,
+ * non-blank, non-comment line that is not a def.
+ */
+function findPythonHandlerFunction(lines, fromLine) {
+    for (let j = fromLine + 1; j < Math.min(fromLine + 6, lines.length); j++) {
+        const m = lines[j].match(/^def\s+(\w+)\s*\(/);
+        if (m)
+            return m[1];
+        // Skip decorator lines
+        if (!lines[j].trim().startsWith('@') && lines[j].trim().length > 0 && !lines[j].trim().startsWith('#'))
+            break;
+    }
+    return undefined;
+}
 /**
  * Infer routes from a Python (Flask/FastAPI) source file.
  */
@@ -432,10 +476,10 @@ function inferRoutesFromPythonFile(filePath) {
     }
     const lines = content.split('\n');
     const byKey = new Map();
-    const addRoute = (method, routePath, lineNumber) => {
+    const addRoute = (method, routePath, lineNumber, handlerFunction) => {
         const key = `${method}:${routePath}`;
         if (!byKey.has(key)) {
-            byKey.set(key, { method, path: routePath, sourceFile: filePath, lineNumber, discoveredVia: 'code' });
+            byKey.set(key, { method, path: routePath, handlerFunction, sourceFile: filePath, lineNumber, discoveredVia: 'code' });
         }
     };
     // Pass 1: Detect blueprint/router prefix for the file
@@ -463,18 +507,19 @@ function inferRoutesFromPythonFile(filePath) {
             const fullPath = localPrefix + (routePath.startsWith('/') ? routePath : '/' + routePath);
             // Normalize Flask <param> to {param}
             const normalizedPath = fullPath.replace(/<(?:\w+:)?(\w+)>/g, '{$1}');
+            const handlerFn = findPythonHandlerFunction(lines, i);
             if (methodsList) {
-                // Parse methods=['GET', 'POST'] → individual routes
+                // Parse methods=['GET', 'POST'] or methods=('GET', 'POST') → individual routes
                 const methods = methodsList.replace(/['"]/g, '').split(',').map((m) => m.trim().toLowerCase());
                 for (const m of methods) {
                     if (exports.HTTP_METHODS.includes(m)) {
-                        addRoute(m, normalizedPath, i + 1);
+                        addRoute(m, normalizedPath, i + 1, handlerFn);
                     }
                 }
             }
             else {
                 // Default to GET
-                addRoute('get', normalizedPath, i + 1);
+                addRoute('get', normalizedPath, i + 1, handlerFn);
             }
             continue;
         }
@@ -484,8 +529,9 @@ function inferRoutesFromPythonFile(filePath) {
             const httpMethod = fastapiMatch[2].toLowerCase();
             const routePath = fastapiMatch[3];
             const fullPath = localPrefix + (routePath.startsWith('/') ? routePath : '/' + routePath);
+            const handlerFn = findPythonHandlerFunction(lines, i);
             // FastAPI uses {param} natively
-            addRoute(httpMethod, fullPath, i + 1);
+            addRoute(httpMethod, fullPath, i + 1, handlerFn);
             continue;
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-tests-coverage",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "CLI and library to measure how thoroughly your test suite exercises your API surface area",
   "main": "dist/src/lib/index.js",
   "types": "dist/src/lib/index.d.ts",