agentic-qe 1.6.1 → 1.8.0

package/dist/agents/examples/batchGenerate.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Batch Test Generation Example
+ *
+ * Demonstrates using the BatchOperationManager to generate tests
+ * for multiple files in parallel with automatic retry and timeout handling.
+ *
+ * Performance Improvement:
+ * - Sequential: 3 files × 2s = 6s
+ * - Batched: max(2s) with 5 concurrent = ~2s
+ * - Speedup: 3x faster
+ *
+ * @module agents/examples/batchGenerate
+ */
+import { type BatchResult } from '../../utils/batch-operations';
+import type { TestGenerationRequest, TestGenerationResult } from '../TestGeneratorAgent';
+/**
+ * Configuration for batch test generation
+ */
+export interface BatchGenerateConfig {
+    /**
+     * Test framework to use
+     */
+    framework: 'jest' | 'vitest' | 'mocha';
+    /**
+     * Target coverage percentage
+     */
+    targetCoverage?: number;
+    /**
+     * Maximum concurrent file processing
+     * @default 5
+     */
+    maxConcurrent?: number;
+    /**
+     * Timeout per file in milliseconds
+     * @default 60000 (60 seconds)
+     */
+    timeout?: number;
+    /**
+     * Enable retry on failure
+     * @default true
+     */
+    retryOnError?: boolean;
+    /**
+     * Progress callback
+     */
+    onProgress?: (completed: number, total: number, file: string) => void;
+}
+/**
+ * Single file test generation input
+ */
+export interface FileGenerationInput {
+    /**
+     * Path to source file
+     */
+    filePath: string;
+    /**
+     * File content (optional, will read if not provided)
+     */
+    content?: string;
+    /**
+     * Custom configuration for this file
+     */
+    config?: Partial<TestGenerationRequest>;
+}
+/**
+ * Result for a single file
+ */
+export interface FileGenerationResult {
+    /**
+     * Source file path
+     */
+    filePath: string;
+    /**
+     * Generated test file path
+     */
+    testFilePath: string;
+    /**
+     * Test generation result
+     */
+    result: TestGenerationResult;
+    /**
+     * Generation time in milliseconds
+     */
+    generationTime: number;
+}
+/**
+ * Batch test generation for multiple files
+ *
+ * @example
+ * ```typescript
+ * const files = [
+ *   { filePath: 'src/utils/parser.ts' },
+ *   { filePath: 'src/utils/validator.ts' },
+ *   { filePath: 'src/utils/formatter.ts' }
+ * ];
+ *
+ * const result = await generateTestsForFiles(files, {
+ *   framework: 'jest',
+ *   targetCoverage: 80,
+ *   maxConcurrent: 5,
+ *   onProgress: (completed, total, file) => {
+ *     console.log(`Progress: ${completed}/${total} - ${file}`);
+ *   }
+ * });
+ *
+ * console.log(`Generated ${result.results.length} test files`);
+ * console.log(`Success rate: ${result.successRate * 100}%`);
+ * console.log(`Total time: ${result.totalTime}ms`);
+ * ```
+ */
+export declare function generateTestsForFiles(files: FileGenerationInput[], config: BatchGenerateConfig): Promise<BatchResult<FileGenerationResult>>;
+/**
+ * Batch generate tests for an entire directory
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsForDirectory('src/utils', {
+ *   framework: 'jest',
+ *   pattern: '**\/*.ts',
+ *   exclude: ['**\/*.test.ts', '**\/*.spec.ts'],
+ *   maxConcurrent: 5
+ * });
+ * ```
+ */
+export declare function generateTestsForDirectory(directory: string, config: BatchGenerateConfig & {
+    pattern?: string;
+    exclude?: string[];
+}): Promise<BatchResult<FileGenerationResult>>;
+/**
+ * Batch generate tests with intelligent prioritization
+ *
+ * Prioritizes files by:
+ * 1. Code complexity (higher first)
+ * 2. Current test coverage (lower first)
+ * 3. Change frequency (higher first)
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsWithPriority(
+ *   [
+ *     { filePath: 'src/complex.ts', complexity: 15, coverage: 20 },
+ *     { filePath: 'src/simple.ts', complexity: 3, coverage: 80 },
+ *   ],
+ *   { framework: 'jest' }
+ * );
+ * ```
+ */
+export declare function generateTestsWithPriority(files: Array<FileGenerationInput & {
+    complexity?: number;
+    coverage?: number;
+    changeFrequency?: number;
+}>, config: BatchGenerateConfig): Promise<BatchResult<FileGenerationResult>>;
+//# sourceMappingURL=batchGenerate.d.ts.map

package/dist/agents/examples/batchGenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchGenerate.d.ts","sourceRoot":"","sources":["../../../src/agents/examples/batchGenerate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEvC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,oBAAoB,CAAC;IAE7B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAkD5C;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACA,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAO5C;AAeD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,KAAK,CACV,mBAAmB,GAAG;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CACF,EACD,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAS5C"}

package/dist/agents/examples/batchGenerate.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Batch Test Generation Example
+ *
+ * Demonstrates using the BatchOperationManager to generate tests
+ * for multiple files in parallel with automatic retry and timeout handling.
+ *
+ * Performance Improvement:
+ * - Sequential: 3 files × 2s = 6s
+ * - Batched: max(2s) with 5 concurrent = ~2s
+ * - Speedup: 3x faster
+ *
+ * @module agents/examples/batchGenerate
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTestsForFiles = generateTestsForFiles;
+exports.generateTestsForDirectory = generateTestsForDirectory;
+exports.generateTestsWithPriority = generateTestsWithPriority;
+const batch_operations_1 = require("../../utils/batch-operations");
+/**
+ * Batch test generation for multiple files
+ *
+ * @example
+ * ```typescript
+ * const files = [
+ *   { filePath: 'src/utils/parser.ts' },
+ *   { filePath: 'src/utils/validator.ts' },
+ *   { filePath: 'src/utils/formatter.ts' }
+ * ];
+ *
+ * const result = await generateTestsForFiles(files, {
+ *   framework: 'jest',
+ *   targetCoverage: 80,
+ *   maxConcurrent: 5,
+ *   onProgress: (completed, total, file) => {
+ *     console.log(`Progress: ${completed}/${total} - ${file}`);
+ *   }
+ * });
+ *
+ * console.log(`Generated ${result.results.length} test files`);
+ * console.log(`Success rate: ${result.successRate * 100}%`);
+ * console.log(`Total time: ${result.totalTime}ms`);
+ * ```
+ */
+async function generateTestsForFiles(files, config) {
+    const batchManager = new batch_operations_1.BatchOperationManager();
+    const { framework, targetCoverage = 80, maxConcurrent = 5, timeout = 60000, retryOnError = true, onProgress, } = config;
+    // Handler function for single file generation
+    const generateForFile = async (input) => {
+        const startTime = Date.now();
+        // This would call your actual test generation service
+        // For now, this is a placeholder that shows the integration pattern
+        const result = await generateUnitTestsForFile({
+            filePath: input.filePath,
+            content: input.content,
+            framework,
+            targetCoverage,
+            ...input.config,
+        });
+        const generationTime = Date.now() - startTime;
+        return {
+            filePath: input.filePath,
+            testFilePath: getTestFilePath(input.filePath, framework),
+            result,
+            generationTime,
+        };
+    };
+    // Execute batch generation
+    return batchManager.batchExecute(files, generateForFile, {
+        maxConcurrent,
+        timeout,
+        retryOnError,
+        maxRetries: 3,
+        failFast: false,
+        onProgress: (completed, total) => {
+            const currentFile = files[completed - 1]?.filePath || 'unknown';
+            onProgress?.(completed, total, currentFile);
+        },
+    });
+}
+/**
+ * Placeholder for actual test generation implementation
+ * Replace this with your actual TestGeneratorAgent call
+ */
+async function generateUnitTestsForFile(params) {
+    // This would integrate with your TestGeneratorAgent
+    // For demonstration purposes only
+    throw new Error('Not implemented - integrate with TestGeneratorAgent');
+}
+/**
+ * Get test file path based on source file path
+ */
+function getTestFilePath(sourcePath, framework) {
+    const extension = framework === 'jest' || framework === 'vitest' ? '.test.ts' : '.spec.ts';
+    return sourcePath.replace(/\.(ts|js)$/, extension);
+}
+/**
+ * Batch generate tests for an entire directory
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsForDirectory('src/utils', {
+ *   framework: 'jest',
+ *   pattern: '**\/*.ts',
+ *   exclude: ['**\/*.test.ts', '**\/*.spec.ts'],
+ *   maxConcurrent: 5
+ * });
+ * ```
+ */
+async function generateTestsForDirectory(directory, config) {
+    const { pattern = '**/*.ts', exclude = ['**/*.test.ts', '**/*.spec.ts'] } = config;
+    // Find all matching files (would use glob or similar)
+    const files = await findSourceFiles(directory, pattern, exclude);
+    return generateTestsForFiles(files, config);
+}
+/**
+ * Placeholder for file discovery
+ * Replace with actual glob implementation
+ */
+async function findSourceFiles(directory, pattern, exclude) {
+    // This would use glob or a similar file discovery mechanism
+    throw new Error('Not implemented - integrate with file system utilities');
+}
+/**
+ * Batch generate tests with intelligent prioritization
+ *
+ * Prioritizes files by:
+ * 1. Code complexity (higher first)
+ * 2. Current test coverage (lower first)
+ * 3. Change frequency (higher first)
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsWithPriority(
+ *   [
+ *     { filePath: 'src/complex.ts', complexity: 15, coverage: 20 },
+ *     { filePath: 'src/simple.ts', complexity: 3, coverage: 80 },
+ *   ],
+ *   { framework: 'jest' }
+ * );
+ * ```
+ */
+async function generateTestsWithPriority(files, config) {
+    // Sort by priority score
+    const prioritized = [...files].sort((a, b) => {
+        const scoreA = calculatePriorityScore(a);
+        const scoreB = calculatePriorityScore(b);
+        return scoreB - scoreA; // Higher score first
+    });
+    return generateTestsForFiles(prioritized, config);
+}
+/**
+ * Calculate priority score for a file
+ * Higher score = higher priority
+ */
+function calculatePriorityScore(file) {
+    const complexity = file.complexity || 5;
+    const coverage = file.coverage || 50;
+    const changeFrequency = file.changeFrequency || 1;
+    // Normalize to 0-100 scale and weight
+    const complexityScore = Math.min(complexity * 5, 100) * 0.4;
+    const coverageScore = (100 - coverage) * 0.4; // Invert: lower coverage = higher priority
+    const changeScore = Math.min(changeFrequency * 10, 100) * 0.2;
+    return complexityScore + coverageScore + changeScore;
+}
+//# sourceMappingURL=batchGenerate.js.map

package/dist/agents/examples/batchGenerate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchGenerate.js","sourceRoot":"","sources":["../../../src/agents/examples/batchGenerate.ts"],"names":[],"mappings":"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"}

package/dist/agents/generateWithPII.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Test Generator with PII Tokenization
+ *
+ * Integrates PIITokenizer with TestGeneratorAgent to ensure GDPR/CCPA compliance
+ * when generating tests with realistic data.
+ *
+ * @module agents/generateWithPII
+ * @compliance GDPR Article 25, CCPA Section 1798.100, PCI-DSS 3.4
+ */
+/**
+ * Test generation result with PII tracking
+ */
+export interface TestGenerationWithPIIResult {
+    /** Generated test file path */
+    testFile: string;
+    /** Final test code with original PII (for file output only) */
+    testCode: string;
+    /** Tokenized version (safe for logs/database) */
+    tokenizedCode: string;
+    /** PII statistics for audit trail */
+    piiStats: {
+        emails: number;
+        phones: number;
+        ssns: number;
+        creditCards: number;
+        names: number;
+        total: number;
+    };
+    /** Framework used */
+    framework: 'jest' | 'vitest';
+    /** Success indicator */
+    success: boolean;
+}
+/**
+ * Generate test code with PII tokenization for compliance
+ *
+ * **WORKFLOW:**
+ * 1. Generate test code using TestGeneratorAgent
+ * 2. Tokenize PII before logging or storing
+ * 3. Store tokenized version in database (GDPR compliant)
+ * 4. Return detokenized version for file writing (user-controlled)
+ * 5. Clear reverse map to minimize data retention
+ *
+ * @param params - Test generation parameters
+ * @returns Test generation result with PII tracking
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestWithRealisticData({
+ *   sourceFile: '/src/UserService.ts',
+ *   framework: 'jest',
+ *   includeRealisticData: true
+ * });
+ *
+ * // Tokenized version stored in database (GDPR compliant)
+ * await db.storeTest({
+ *   sourceFile: result.testFile,
+ *   testCode: result.tokenizedCode,
+ *   framework: result.framework
+ * });
+ *
+ * // Original PII written to file (user-controlled)
+ * await fs.writeFile(result.testFile, result.testCode);
+ *
+ * console.log(`Generated test with ${result.piiStats.total} PII instances`);
+ * ```
+ */
+export declare function generateTestWithRealisticData(params: {
+    sourceFile: string;
+    framework: 'jest' | 'vitest';
+    includeRealisticData?: boolean;
+}): Promise<TestGenerationWithPIIResult>;
+/**
+ * Batch generate tests with PII tokenization
+ *
+ * Processes multiple source files concurrently while maintaining PII compliance.
+ *
+ * @param files - Source files to generate tests for
+ * @param framework - Testing framework to use
+ * @returns Array of test generation results
+ *
+ * @example
+ * ```typescript
+ * const results = await batchGenerateTestsWithPII(
+ *   ['/src/UserService.ts', '/src/PaymentService.ts'],
+ *   'jest'
+ * );
+ *
+ * // Store all tokenized versions
+ * await Promise.all(results.map(r => db.storeTest({
+ *   sourceFile: r.testFile,
+ *   testCode: r.tokenizedCode
+ * })));
+ *
+ * // Write original versions to files
+ * await Promise.all(results.map(r =>
+ *   fs.writeFile(r.testFile, r.testCode)
+ * ));
+ *
+ * const totalPII = results.reduce((sum, r) => sum + r.piiStats.total, 0);
+ * console.log(`Total PII instances across all tests: ${totalPII}`);
+ * ```
+ */
+export declare function batchGenerateTestsWithPII(files: string[], framework: 'jest' | 'vitest'): Promise<TestGenerationWithPIIResult[]>;
+/**
+ * Validate PII tokenization compliance
+ *
+ * Ensures that tokenized content contains no PII for audit purposes.
+ *
+ * @param tokenizedContent - Content to validate
+ * @returns Validation result with any detected PII
+ *
+ * @example
+ * ```typescript
+ * const { tokenized } = tokenizer.tokenize(testCode);
+ * const validation = validateNoLeakedPII(tokenized);
+ *
+ * if (!validation.compliant) {
+ *   console.error('PII leak detected!', validation.leakedPII);
+ *   throw new Error('GDPR compliance violation');
+ * }
+ * ```
+ */
+export declare function validateNoLeakedPII(tokenizedContent: string): {
+    compliant: boolean;
+    leakedPII: string[];
+};
+//# sourceMappingURL=generateWithPII.d.ts.map

package/dist/agents/generateWithPII.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateWithPII.d.ts","sourceRoot":"","sources":["../../src/agents/generateWithPII.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IAEjB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IAEtB,qCAAqC;IACrC,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,qBAAqB;IACrB,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE7B,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAqDvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,GAAG,QAAQ,GAC3B,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAUxC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAgBA"}

package/dist/agents/generateWithPII.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Test Generator with PII Tokenization
+ *
+ * Integrates PIITokenizer with TestGeneratorAgent to ensure GDPR/CCPA compliance
+ * when generating tests with realistic data.
+ *
+ * @module agents/generateWithPII
+ * @compliance GDPR Article 25, CCPA Section 1798.100, PCI-DSS 3.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTestWithRealisticData = generateTestWithRealisticData;
+exports.batchGenerateTestsWithPII = batchGenerateTestsWithPII;
+exports.validateNoLeakedPII = validateNoLeakedPII;
+const pii_tokenization_1 = require("../security/pii-tokenization");
+/**
+ * Generate test code with PII tokenization for compliance
+ *
+ * **WORKFLOW:**
+ * 1. Generate test code using TestGeneratorAgent
+ * 2. Tokenize PII before logging or storing
+ * 3. Store tokenized version in database (GDPR compliant)
+ * 4. Return detokenized version for file writing (user-controlled)
+ * 5. Clear reverse map to minimize data retention
+ *
+ * @param params - Test generation parameters
+ * @returns Test generation result with PII tracking
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestWithRealisticData({
+ *   sourceFile: '/src/UserService.ts',
+ *   framework: 'jest',
+ *   includeRealisticData: true
+ * });
+ *
+ * // Tokenized version stored in database (GDPR compliant)
+ * await db.storeTest({
+ *   sourceFile: result.testFile,
+ *   testCode: result.tokenizedCode,
+ *   framework: result.framework
+ * });
+ *
+ * // Original PII written to file (user-controlled)
+ * await fs.writeFile(result.testFile, result.testCode);
+ *
+ * console.log(`Generated test with ${result.piiStats.total} PII instances`);
+ * ```
+ */
+async function generateTestWithRealisticData(params) {
+    const tokenizer = new pii_tokenization_1.PIITokenizer();
+    try {
+        // Step 1: Generate test code using TestGeneratorAgent
+        // Note: This is a simplified example - actual TestGeneratorAgent construction
+        // would require proper context, memoryStore, and eventBus setup
+        const testCode = `
+// Generated test with realistic data
+import { describe, it, expect } from '${params.framework}';
+
+describe('User Service Tests', () => {
+  it('should handle user creation', () => {
+    const user = {
+      email: 'test@example.com',
+      phone: '555-1234',
+      // PII data would be here in actual generation
+    };
+    expect(user).toBeDefined();
+  });
+});
+`.trim();
+        // Step 2: Tokenize PII before logging or storing
+        const { tokenized, reverseMap, piiCount, piiBreakdown } = tokenizer.tokenize(testCode);
+        // Step 3: Log tokenized version (safe, GDPR compliant)
+        console.log(`[PII Tokenization] Generated test with ${piiCount} PII instances (tokenized)`);
+        console.log('[PII Breakdown]', piiBreakdown);
+        // Tokenized content is safe for logging
+        if (process.env.DEBUG_TESTS === 'true') {
+            console.log('[Tokenized Content]', tokenized.substring(0, 500));
+        }
+        // Step 4: Restore original PII for file writing
+        const finalCode = tokenizer.detokenize(tokenized, reverseMap);
+        return {
+            testFile: params.sourceFile.replace(/\.ts$/, '.test.ts'),
+            testCode: finalCode, // Original PII for file output
+            tokenizedCode: tokenized, // PII-free version for database/logs
+            piiStats: {
+                ...piiBreakdown,
+                total: piiCount,
+            },
+            framework: params.framework,
+            success: true,
+        };
+    }
+    finally {
+        // Step 5: CRITICAL - Clear reverse map to minimize data retention (GDPR Article 5(1)(e))
+        tokenizer.clear();
+    }
+}
+/**
+ * Batch generate tests with PII tokenization
+ *
+ * Processes multiple source files concurrently while maintaining PII compliance.
+ *
+ * @param files - Source files to generate tests for
+ * @param framework - Testing framework to use
+ * @returns Array of test generation results
+ *
+ * @example
+ * ```typescript
+ * const results = await batchGenerateTestsWithPII(
+ *   ['/src/UserService.ts', '/src/PaymentService.ts'],
+ *   'jest'
+ * );
+ *
+ * // Store all tokenized versions
+ * await Promise.all(results.map(r => db.storeTest({
+ *   sourceFile: r.testFile,
+ *   testCode: r.tokenizedCode
+ * })));
+ *
+ * // Write original versions to files
+ * await Promise.all(results.map(r =>
+ *   fs.writeFile(r.testFile, r.testCode)
+ * ));
+ *
+ * const totalPII = results.reduce((sum, r) => sum + r.piiStats.total, 0);
+ * console.log(`Total PII instances across all tests: ${totalPII}`);
+ * ```
+ */
+async function batchGenerateTestsWithPII(files, framework) {
+    return Promise.all(files.map(sourceFile => generateTestWithRealisticData({
+        sourceFile,
+        framework,
+        includeRealisticData: true,
+    })));
+}
+/**
+ * Validate PII tokenization compliance
+ *
+ * Ensures that tokenized content contains no PII for audit purposes.
+ *
+ * @param tokenizedContent - Content to validate
+ * @returns Validation result with any detected PII
+ *
+ * @example
+ * ```typescript
+ * const { tokenized } = tokenizer.tokenize(testCode);
+ * const validation = validateNoLeakedPII(tokenized);
+ *
+ * if (!validation.compliant) {
+ *   console.error('PII leak detected!', validation.leakedPII);
+ *   throw new Error('GDPR compliance violation');
+ * }
+ * ```
+ */
+function validateNoLeakedPII(tokenizedContent) {
+    const detector = new pii_tokenization_1.PIITokenizer();
+    const { piiCount, piiBreakdown } = detector.tokenize(tokenizedContent);
+    const leakedPII = [];
+    if (piiBreakdown.emails > 0)
+        leakedPII.push(`${piiBreakdown.emails} emails`);
+    if (piiBreakdown.phones > 0)
+        leakedPII.push(`${piiBreakdown.phones} phones`);
+    if (piiBreakdown.ssns > 0)
+        leakedPII.push(`${piiBreakdown.ssns} SSNs`);
+    if (piiBreakdown.creditCards > 0)
+        leakedPII.push(`${piiBreakdown.creditCards} credit cards`);
+    if (piiBreakdown.names > 0)
+        leakedPII.push(`${piiBreakdown.names} names`);
+    return {
+        compliant: piiCount === 0,
+        leakedPII,
+    };
+}
+//# sourceMappingURL=generateWithPII.js.map

package/dist/agents/generateWithPII.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateWithPII.js","sourceRoot":"","sources":["../../src/agents/generateWithPII.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA8BhE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,aAAa,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,EAAE,oBAAoB;IAIxC;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;IAyRzE;;OAEG;IACH,iBAAiB,IAAI,WAAW,EAAE;IAwBlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA6W/B;AAGD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ/G"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA8BhE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,aAAa,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,EAAE,oBAAoB;IAIxC;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;IAuRzE;;OAEG;IACH,iBAAiB,IAAI,WAAW,EAAE;IAwBlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA6W/B;AAGD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ/G"}

package/dist/agents/index.js

@@ -183,8 +183,6 @@ class QEAgentFactory {
                         requiredMetrics: ['coverage', 'quality-score', 'security-scan']
                     }
                 };
-                // TODO: Uncomment when DeploymentReadinessAgent is implemented
-                // return new DeploymentReadinessAgent(deploymentConfig);
                 throw new Error(`Agent type ${type} implementation in progress. Week 2 P0.`);
             }
             case types_1.QEAgentType.PERFORMANCE_TESTER: {