agentic-qe 1.8.2 → 1.8.4

package/dist/core/hooks/validators/TDDPhaseValidator.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * TDD Phase Validator - Runtime enforcement for TDD subagent coordination
+ *
+ * Validates that each phase of the TDD cycle produces correct output
+ * in the memory store before allowing transition to next phase.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TDDPhaseValidator = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+class TDDPhaseValidator {
+    constructor(memoryClient) {
+        this.memoryClient = memoryClient;
+    }
+    /**
+     * Validate RED phase output before transitioning to GREEN
+     */
+    async validateREDPhase(cycleId) {
+        const errors = [];
+        const warnings = [];
+        const metrics = {
+            memoryKeyExists: false,
+            outputSchemaValid: false,
+            handoffReady: false,
+            fileIntegrityValid: false
+        };
+        // 1. Check memory key exists
+        const memoryKey = `aqe/tdd/cycle-${cycleId}/red/tests`;
+        let output = null;
+        try {
+            output = await this.memoryClient.retrieve(memoryKey, { partition: 'coordination' });
+            metrics.memoryKeyExists = !!output;
+        }
+        catch (e) {
+            errors.push(`Failed to retrieve RED phase output from ${memoryKey}: ${e}`);
+        }
+        if (!output) {
+            errors.push(`RED phase output not found at ${memoryKey}`);
+            return { valid: false, phase: 'RED', cycleId, errors, warnings, metrics };
+        }
+        // 2. Validate schema
+        if (!output.cycleId || output.cycleId !== cycleId) {
+            errors.push(`Cycle ID mismatch: expected ${cycleId}, got ${output.cycleId}`);
+        }
+        else if (!output.testFile?.path || !output.testFile?.hash) {
+            errors.push('Missing testFile.path or testFile.hash in RED output');
+        }
+        else if (!output.validation || typeof output.validation.allTestsFailing !== 'boolean') {
+            errors.push('Missing or invalid validation.allTestsFailing in RED output');
+        }
+        else {
+            metrics.outputSchemaValid = true;
+        }
+        // 3. Validate tests are failing (RED phase requirement)
+        if (output.validation && !output.validation.allTestsFailing) {
+            errors.push('RED phase violation: Tests must fail initially. Found passing tests.');
+        }
+        // 4. Check handoff readiness
+        if (!output.readyForHandoff) {
+            errors.push('RED phase not ready for handoff');
+        }
+        else {
+            metrics.handoffReady = true;
+        }
+        // 5. Validate file integrity
+        if (output.testFile?.path && output.testFile?.hash) {
+            const fileValid = await this.validateFileHash(output.testFile.path, output.testFile.hash);
+            metrics.fileIntegrityValid = fileValid;
+            if (!fileValid) {
+                errors.push(`Test file hash mismatch for ${output.testFile.path}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            phase: 'RED',
+            cycleId,
+            errors,
+            warnings,
+            metrics
+        };
+    }
+    /**
+     * Validate GREEN phase output before transitioning to REFACTOR
+     */
+    async validateGREENPhase(cycleId) {
+        const errors = [];
+        const warnings = [];
+        const metrics = {
+            memoryKeyExists: false,
+            outputSchemaValid: false,
+            handoffReady: false,
+            fileIntegrityValid: false
+        };
+        // 1. Check memory key exists
+        const memoryKey = `aqe/tdd/cycle-${cycleId}/green/impl`;
+        let output = null;
+        try {
+            output = await this.memoryClient.retrieve(memoryKey, { partition: 'coordination' });
+            metrics.memoryKeyExists = !!output;
+        }
+        catch (e) {
+            errors.push(`Failed to retrieve GREEN phase output from ${memoryKey}: ${e}`);
+        }
+        if (!output) {
+            errors.push(`GREEN phase output not found at ${memoryKey}`);
+            return { valid: false, phase: 'GREEN', cycleId, errors, warnings, metrics };
+        }
+        // 2. Validate schema
+        if (!output.cycleId || output.cycleId !== cycleId) {
+            errors.push(`Cycle ID mismatch: expected ${cycleId}, got ${output.cycleId}`);
+        }
+        else if (!output.implFile?.path || !output.implFile?.hash) {
+            errors.push('Missing implFile.path or implFile.hash in GREEN output');
+        }
+        else if (!output.validation || typeof output.validation.allTestsPassing !== 'boolean') {
+            errors.push('Missing or invalid validation.allTestsPassing in GREEN output');
+        }
+        else {
+            metrics.outputSchemaValid = true;
+        }
+        // 3. Validate tests are passing (GREEN phase requirement)
+        if (output.validation && !output.validation.allTestsPassing) {
+            errors.push('GREEN phase violation: All tests must pass.');
+        }
+        // 4. Validate test file hash matches RED phase
+        try {
+            const redOutput = await this.memoryClient.retrieve(`aqe/tdd/cycle-${cycleId}/red/tests`, { partition: 'coordination' });
+            if (redOutput && output.testFile?.hash !== redOutput.testFile?.hash) {
+                errors.push(`Test file was modified between RED and GREEN phases`);
+            }
+        }
+        catch (e) {
+            warnings.push(`Could not verify RED phase for test file integrity: ${e}`);
+        }
+        // 5. Check handoff readiness
+        if (!output.readyForHandoff) {
+            errors.push('GREEN phase not ready for handoff');
+        }
+        else {
+            metrics.handoffReady = true;
+        }
+        // 6. Validate file integrity
+        if (output.implFile?.path && output.implFile?.hash) {
+            const fileValid = await this.validateFileHash(output.implFile.path, output.implFile.hash);
+            metrics.fileIntegrityValid = fileValid;
+            if (!fileValid) {
+                errors.push(`Implementation file hash mismatch for ${output.implFile.path}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            phase: 'GREEN',
+            cycleId,
+            errors,
+            warnings,
+            metrics
+        };
+    }
+    /**
+     * Validate REFACTOR phase output (final validation)
+     */
+    async validateREFACTORPhase(cycleId) {
+        const errors = [];
+        const warnings = [];
+        const metrics = {
+            memoryKeyExists: false,
+            outputSchemaValid: false,
+            handoffReady: false,
+            fileIntegrityValid: false
+        };
+        // 1. Check memory key exists
+        const memoryKey = `aqe/tdd/cycle-${cycleId}/refactor/result`;
+        let output = null;
+        try {
+            output = await this.memoryClient.retrieve(memoryKey, { partition: 'coordination' });
+            metrics.memoryKeyExists = !!output;
+        }
+        catch (e) {
+            errors.push(`Failed to retrieve REFACTOR phase output from ${memoryKey}: ${e}`);
+        }
+        if (!output) {
+            errors.push(`REFACTOR phase output not found at ${memoryKey}`);
+            return { valid: false, phase: 'REFACTOR', cycleId, errors, warnings, metrics };
+        }
+        // 2. Validate schema
+        if (!output.cycleId || output.cycleId !== cycleId) {
+            errors.push(`Cycle ID mismatch: expected ${cycleId}, got ${output.cycleId}`);
+        }
+        else if (!output.implFile?.path || !output.implFile?.hash) {
+            errors.push('Missing implFile.path or implFile.hash in REFACTOR output');
+        }
+        else {
+            metrics.outputSchemaValid = true;
+        }
+        // 3. Validate tests still passing after refactor
+        if (output.validation && !output.validation.allTestsPassing) {
+            errors.push('REFACTOR phase violation: Tests must still pass after refactoring.');
+        }
+        // 4. Validate test file hash unchanged throughout cycle
+        try {
+            const redOutput = await this.memoryClient.retrieve(`aqe/tdd/cycle-${cycleId}/red/tests`, { partition: 'coordination' });
+            if (redOutput && output.testFile?.hash !== redOutput.testFile?.hash) {
+                errors.push(`Test file was modified during TDD cycle - integrity violation`);
+            }
+        }
+        catch (e) {
+            warnings.push(`Could not verify RED phase for test file integrity: ${e}`);
+        }
+        // 5. Check review readiness
+        if (!output.readyForReview) {
+            warnings.push('REFACTOR phase not marked ready for review');
+        }
+        else {
+            metrics.handoffReady = true;
+        }
+        // 6. Validate coverage didn't decrease
+        try {
+            const greenOutput = await this.memoryClient.retrieve(`aqe/tdd/cycle-${cycleId}/green/impl`, { partition: 'coordination' });
+            if (greenOutput && output.validation?.coverage < greenOutput.validation?.coverage) {
+                warnings.push(`Coverage decreased from ${greenOutput.validation.coverage}% to ${output.validation.coverage}%`);
+            }
+        }
+        catch (e) {
+            warnings.push(`Could not verify GREEN phase for coverage comparison: ${e}`);
+        }
+        // 7. Validate file integrity
+        if (output.implFile?.path && output.implFile?.hash) {
+            const fileValid = await this.validateFileHash(output.implFile.path, output.implFile.hash);
+            metrics.fileIntegrityValid = fileValid;
+            if (!fileValid) {
+                errors.push(`Implementation file hash mismatch for ${output.implFile.path}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            phase: 'REFACTOR',
+            cycleId,
+            errors,
+            warnings,
+            metrics
+        };
+    }
+    /**
+     * Validate complete TDD cycle
+     */
+    async validateCompleteCycle(cycleId) {
+        const redResult = await this.validateREDPhase(cycleId);
+        const greenResult = await this.validateGREENPhase(cycleId);
+        const refactorResult = await this.validateREFACTORPhase(cycleId);
+        const allValid = redResult.valid && greenResult.valid && refactorResult.valid;
+        const totalErrors = redResult.errors.length + greenResult.errors.length + refactorResult.errors.length;
+        return {
+            valid: allValid,
+            phases: [redResult, greenResult, refactorResult],
+            summary: allValid
+                ? `TDD cycle ${cycleId} completed successfully with full coordination`
+                : `TDD cycle ${cycleId} has ${totalErrors} validation errors`
+        };
+    }
+    /**
+     * Calculate SHA256 hash of a file
+     */
+    static calculateFileHash(filePath) {
+        if (!(0, fs_1.existsSync)(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
+    }
+    /**
+     * Validate file hash matches expected
+     */
+    async validateFileHash(filePath, expectedHash) {
+        try {
+            const actualHash = TDDPhaseValidator.calculateFileHash(filePath);
+            return actualHash === expectedHash;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.TDDPhaseValidator = TDDPhaseValidator;
+// Export for use in hooks system
+exports.default = TDDPhaseValidator;
+//# sourceMappingURL=TDDPhaseValidator.js.map

package/dist/core/hooks/validators/TDDPhaseValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TDDPhaseValidator.js","sourceRoot":"","sources":["../../../../src/core/hooks/validators/TDDPhaseValidator.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mCAAoC;AACpC,2BAA8C;AA8C9C,MAAa,iBAAiB;IAC5B,YAAoB,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG;YACd,eAAe,EAAE,KAAK;YACtB,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,KAAK;SAC1B,CAAC;QAEF,6BAA6B;QAC7B,MAAM,SAAS,GAAG,iBAAiB,OAAO,YAAY,CAAC;QACvD,IAAI,MAAM,GAA0B,IAAI,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YACpF,OAAO,CAAC,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,4CAA4C,SAAS,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC5E,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACtE,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACnC,CAAC;QAED,wDAAwD;QACxD,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QACtF,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,6BAA6B;QAC7B,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YACnD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1F,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;YACvC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,KAAK,EAAE,KAAK;YACZ,OAAO;YACP,MAAM;YACN,QAAQ;YACR,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,OAAe;QACtC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG;YACd,eAAe,EAAE,KAAK;YACtB,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,KAAK;SAC1B,CAAC;QAEF,6BAA6B;QAC7B,MAAM,SAAS,GAAG,iBAAiB,OAAO,aAAa,CAAC;QACxD,IAAI,MAAM,GAA4B,IAAI,CAAC;QAE3C,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YACpF,OAAO,CAAC,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,8CAA8C,SAAS,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;YAC5D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC9E,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACxE,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACnC,CAAC;QAED,0DAA0D;QAC1D,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAChD,iBAAiB,OAAO,YAAY,EACpC,EAAE,SAAS,EAAE,cAAc,EAAE,CAC9B,CAAC;YACF,IAAI,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;gBACpE,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,uDAAuD,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,6BAA6B;QAC7B,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YACnD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1F,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;YACvC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,yCAAyC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,KAAK,EAAE,OAAO;YACd,OAAO;YACP,MAAM;YACN,QAAQ;YACR,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAe;QACzC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG;YACd,eAAe,EAAE,KAAK;YACtB,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,KAAK;SAC1B,CAAC;QAEF,6BAA6B;QAC7B,MAAM,SAAS,GAAG,iBAAiB,OAAO,kBAAkB,CAAC;QAC7D,IAAI,MAAM,GAA+B,IAAI,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YACpF,OAAO,CAAC,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,iDAAiD,SAAS,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;YAC/D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACjF,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,+BAA+B,OAAO,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;QACnC,CAAC;QAED,iDAAiD;QACjD,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACpF,CAAC;QAED,wDAAwD;QACxD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAChD,iBAAiB,OAAO,YAAY,EACpC,EAAE,SAAS,EAAE,cAAc,EAAE,CAC9B,CAAC;YACF,IAAI,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;gBACpE,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,uDAAuD,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,uCAAuC;QACvC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAClD,iBAAiB,OAAO,aAAa,EACrC,EAAE,SAAS,EAAE,cAAc,EAAE,CAC9B,CAAC;YACF,IAAI,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;gBAClF,QAAQ,CAAC,IAAI,CAAC,2BAA2B,WAAW,CAAC,UAAU,CAAC,QAAQ,QAAQ,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC;YACjH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,yDAAyD,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,6BAA6B;QAC7B,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YACnD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1F,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;YACvC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,yCAAyC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,KAAK,EAAE,UAAU;YACjB,OAAO;YACP,MAAM;YACN,QAAQ;YACR,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAe;QAKzC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC;QAC9E,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;QAEvG,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,CAAC;YAChD,OAAO,EAAE,QAAQ;gBACf,CAAC,CAAC,aAAa,OAAO,gDAAgD;gBACtE,CAAC,CAAC,aAAa,OAAO,QAAQ,WAAW,oBAAoB;SAChE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAgB;QACvC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,YAAoB;QACnE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,UAAU,KAAK,YAAY,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AA3SD,8CA2SC;AAED,iCAAiC;AACjC,kBAAe,iBAAiB,CAAC"}

package/dist/core/hooks/validators/index.d.ts

@@ -1,12 +1,14 @@
 /**
- * Post-Task Validators - Output, Quality, Coverage, and Performance Validation
+ * Post-Task Validators - Output, Quality, Coverage, Performance, and TDD Phase Validation
  */
 export { OutputValidator } from './OutputValidator';
 export { QualityValidator } from './QualityValidator';
 export { CoverageValidator } from './CoverageValidator';
 export { PerformanceValidator } from './PerformanceValidator';
+export { TDDPhaseValidator } from './TDDPhaseValidator';
 export type { OutputValidationOptions, OutputValidationResult } from './OutputValidator';
 export type { QualityValidationOptions, QualityValidationResult } from './QualityValidator';
 export type { CoverageValidationOptions, CoverageValidationResult } from './CoverageValidator';
 export type { PerformanceValidationOptions, PerformanceValidationResult } from './PerformanceValidator';
+export type { TDDValidationResult, REDPhaseOutput, GREENPhaseOutput, REFACTORPhaseOutput, MemoryClient } from './TDDPhaseValidator';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/hooks/validators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/validators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/validators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACb,MAAM,qBAAqB,CAAC"}

package/dist/core/hooks/validators/index.js

@@ -1,9 +1,9 @@
 "use strict";
 /**
- * Post-Task Validators - Output, Quality, Coverage, and Performance Validation
+ * Post-Task Validators - Output, Quality, Coverage, Performance, and TDD Phase Validation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PerformanceValidator = exports.CoverageValidator = exports.QualityValidator = exports.OutputValidator = void 0;
+exports.TDDPhaseValidator = exports.PerformanceValidator = exports.CoverageValidator = exports.QualityValidator = exports.OutputValidator = void 0;
 var OutputValidator_1 = require("./OutputValidator");
 Object.defineProperty(exports, "OutputValidator", { enumerable: true, get: function () { return OutputValidator_1.OutputValidator; } });
 var QualityValidator_1 = require("./QualityValidator");
@@ -12,4 +12,6 @@ var CoverageValidator_1 = require("./CoverageValidator");
 Object.defineProperty(exports, "CoverageValidator", { enumerable: true, get: function () { return CoverageValidator_1.CoverageValidator; } });
 var PerformanceValidator_1 = require("./PerformanceValidator");
 Object.defineProperty(exports, "PerformanceValidator", { enumerable: true, get: function () { return PerformanceValidator_1.PerformanceValidator; } });
+var TDDPhaseValidator_1 = require("./TDDPhaseValidator");
+Object.defineProperty(exports, "TDDPhaseValidator", { enumerable: true, get: function () { return TDDPhaseValidator_1.TDDPhaseValidator; } });
 //# sourceMappingURL=index.js.map

package/dist/core/hooks/validators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/hooks/validators/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/hooks/validators/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA"}

package/dist/core/memory/MemoryManagerFactory.d.ts

@@ -0,0 +1,77 @@
+/**
+ * MemoryManagerFactory - Singleton Pattern for Shared Memory Management
+ *
+ * Resolves the persistence issue where multiple SwarmMemoryManager instances
+ * cause data fragmentation - data written to one instance is not visible to others.
+ *
+ * Key Issues Fixed:
+ * 1. Multiple isolated instances (MCP server, AgentRegistry, Phase2Tools each created their own)
+ * 2. sql.js persistence model requires explicit save()/close() calls
+ * 3. Ensures all components share the same database connection
+ *
+ * @module MemoryManagerFactory
+ * @version 1.0.0
+ */
+import { SwarmMemoryManager } from './SwarmMemoryManager.js';
+/**
+ * Resolve database path - ensures we use an absolute path in user's project
+ *
+ * Database should be in the USER'S project directory (process.cwd()),
+ * NOT in the package installation directory.
+ */
+export declare function resolveDbPath(inputPath?: string): string;
+/**
+ * Ensure the database directory exists
+ */
+export declare function ensureDbDirectoryExists(dbPath: string): void;
+/**
+ * Get the shared SwarmMemoryManager singleton
+ *
+ * Ensures all components use the same database connection for consistent
+ * persistence across MCP server, AgentRegistry, handlers, and agents.
+ *
+ * @param dbPath Optional database path (relative paths resolved from cwd)
+ * @returns Shared SwarmMemoryManager instance
+ */
+export declare function getSharedMemoryManager(dbPath?: string): SwarmMemoryManager;
+/**
+ * Initialize the shared memory manager asynchronously
+ *
+ * This method ensures only ONE initialization happens even if called multiple times.
+ * All callers will receive the same initialized instance.
+ *
+ * @param dbPath Optional database path
+ * @returns Promise that resolves to the initialized SwarmMemoryManager
+ */
+export declare function initializeSharedMemoryManager(dbPath?: string): Promise<SwarmMemoryManager>;
+/**
+ * Check if shared memory manager is initialized
+ */
+export declare function hasSharedMemoryManager(): boolean;
+/**
+ * Get the path of the current shared memory manager
+ */
+export declare function getSharedMemoryManagerPath(): string | null;
+/**
+ * Reset the shared memory manager singleton
+ *
+ * Use with caution - this should only be called during testing or
+ * when explicitly changing database paths.
+ */
+export declare function resetSharedMemoryManager(): Promise<void>;
+/**
+ * Get database path info for debugging
+ */
+export declare function getDbPathInfo(): {
+    defaultPath: string;
+    currentSharedPath: string | null;
+    processCwd: string;
+    envPath: string | undefined;
+};
+/**
+ * Setup process exit handlers to ensure database is properly closed
+ *
+ * This is critical for sql.js which only persists to disk on close()
+ */
+export declare function setupExitHandlers(): void;
+//# sourceMappingURL=MemoryManagerFactory.d.ts.map

package/dist/core/memory/MemoryManagerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryManagerFactory.d.ts","sourceRoot":"","sources":["../../../src/core/memory/MemoryManagerFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAO7D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BxD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAW5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA0B1E;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8BhG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAOA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CA2CxC"}