api-tests-coverage 1.0.17 → 1.0.18

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-tests-coverage",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "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",