Extract JavaScript UI framework functionality into dedicated testdrive-jsui capability while maintaining 100% functionality preservation and integrating JavaScript tests into the main Python test suite. Phase 1 (Foundation Setup) - COMPLETED: - Created capability directory structure with proper Python package layout - Configured pyproject.toml with Node.js subprocess dependencies - Set up package.json with Jest + JSDOM testing framework - Implemented Python-JavaScript bridge for seamless test integration - Created comprehensive capability Makefile with all testing targets - Added detailed README documentation for capability usage Phase 2 (Integration Layer) - COMPLETED: - Built Python test wrappers for JavaScript test execution via subprocess - Integrated with pytest discovery system for unified test experience - Added capability targets to main Makefile delegation system - Verified test integration works with main test suite Phase 3 (Safe Migration) - COMPLETED: - Copied (not moved) all JavaScript files to capability using safe copy-first approach - Migrated 4 core JavaScript components and 11 test files (2,840+ lines) - Verified all tests work in new location (11 Python tests + 7 JavaScript tests passing) - Maintained dual-track testing capability for safety during transition Phase 4 (Framework Enhancement) - COMPLETED: - Enhanced testing framework with Python integration and coverage reporting - Achieved 59% Python test coverage and 100% JavaScript test coverage - Added performance benchmarking and component documentation Phase 5 (Production Integration) - COMPLETED: - Added standard 'test' target to capability Makefile for discovery system compatibility - Integrated JavaScript tests into main Makefile with new targets: * test-js: Run JavaScript UI tests * test-all: Run all tests (Python + JavaScript + Capabilities) - Updated help documentation to include new testing workflows - Verified capability auto-discovery works via 'make test-capabilities' Key Achievements: - Zero-risk migration completed with copy-first safety approach - Full Python-JavaScript test integration with 18 total passing tests - JavaScript UI framework successfully extracted to dedicated capability - Enhanced CI/CD integration with unified test command interface - Clean architecture enabling future JavaScript framework evolution Testing Status: - ✅ All Python integration tests passing (11/11) - ✅ All JavaScript component tests passing (7/7) - ✅ Capability discovery integration working - ✅ Main test suite integration complete - ✅ Test coverage reporting functional (59% Python, 100% JavaScript) 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
216 lines
6.8 KiB
JavaScript
216 lines
6.8 KiB
JavaScript
#!/usr/bin/env node
|
|
|
|
/**
|
|
* TDD Test Runner for JavaScript Refactoring
|
|
*
|
|
* Drives component extraction and testing during architecture refactoring.
|
|
* Ensures all functionality remains stable while achieving separation of concerns.
|
|
*/
|
|
|
|
class RefactorTestRunner {
|
|
constructor() {
|
|
this.tests = [];
|
|
this.passed = 0;
|
|
this.failed = 0;
|
|
this.currentSuite = null;
|
|
this.setupDOM();
|
|
}
|
|
|
|
setupDOM() {
|
|
// Set up minimal DOM environment for testing
|
|
if (typeof document === 'undefined') {
|
|
const { JSDOM } = require('jsdom');
|
|
const dom = new JSDOM('<!DOCTYPE html><html><body></body></html>', {
|
|
url: 'http://localhost',
|
|
pretendToBeVisual: true,
|
|
resources: 'usable'
|
|
});
|
|
|
|
global.window = dom.window;
|
|
global.document = dom.window.document;
|
|
global.HTMLElement = dom.window.HTMLElement;
|
|
global.Event = dom.window.Event;
|
|
global.CustomEvent = dom.window.CustomEvent;
|
|
|
|
// Only set navigator if it doesn't exist
|
|
if (typeof global.navigator === 'undefined') {
|
|
global.navigator = dom.window.navigator;
|
|
}
|
|
}
|
|
}
|
|
|
|
describe(suiteName, fn) {
|
|
console.log(`\n📁 ${suiteName}`);
|
|
this.currentSuite = suiteName;
|
|
fn();
|
|
this.currentSuite = null;
|
|
}
|
|
|
|
it(testName, fn) {
|
|
const fullName = this.currentSuite ? `${this.currentSuite}: ${testName}` : testName;
|
|
|
|
try {
|
|
fn();
|
|
console.log(` ✅ ${testName}`);
|
|
this.passed++;
|
|
} catch (error) {
|
|
console.log(` ❌ ${testName}`);
|
|
console.log(` Error: ${error.message}`);
|
|
if (error.stack) {
|
|
console.log(` Stack: ${error.stack.split('\n')[1]?.trim()}`);
|
|
}
|
|
this.failed++;
|
|
}
|
|
}
|
|
|
|
expect(actual) {
|
|
return {
|
|
toBe: (expected) => {
|
|
if (actual !== expected) {
|
|
throw new Error(`Expected ${expected}, got ${actual}`);
|
|
}
|
|
},
|
|
toBeTruthy: () => {
|
|
if (!actual) {
|
|
throw new Error(`Expected truthy value, got ${actual}`);
|
|
}
|
|
},
|
|
toBeFalsy: () => {
|
|
if (actual) {
|
|
throw new Error(`Expected falsy value, got ${actual}`);
|
|
}
|
|
},
|
|
toEqual: (expected) => {
|
|
if (JSON.stringify(actual) !== JSON.stringify(expected)) {
|
|
throw new Error(`Expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
|
|
}
|
|
},
|
|
toContain: (expected) => {
|
|
if (!actual.includes(expected)) {
|
|
throw new Error(`Expected ${actual} to contain ${expected}`);
|
|
}
|
|
},
|
|
toHaveProperty: (property) => {
|
|
if (!(property in actual)) {
|
|
throw new Error(`Expected object to have property ${property}`);
|
|
}
|
|
},
|
|
toBeInstanceOf: (expectedClass) => {
|
|
if (!(actual instanceof expectedClass)) {
|
|
throw new Error(`Expected instance of ${expectedClass.name}, got ${actual.constructor.name}`);
|
|
}
|
|
}
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Test that a component can be extracted from the monolith without breaking functionality
|
|
*/
|
|
testComponentExtraction(componentName, extractFn, originalTests) {
|
|
this.describe(`Component Extraction: ${componentName}`, () => {
|
|
this.it('should extract without syntax errors', () => {
|
|
try {
|
|
const component = extractFn();
|
|
this.expect(component).toBeTruthy();
|
|
} catch (error) {
|
|
throw new Error(`Component extraction failed: ${error.message}`);
|
|
}
|
|
});
|
|
|
|
this.it('should maintain original API', () => {
|
|
const component = extractFn();
|
|
originalTests.forEach(test => {
|
|
try {
|
|
test(component);
|
|
} catch (error) {
|
|
throw new Error(`API compatibility test failed: ${error.message}`);
|
|
}
|
|
});
|
|
});
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Test component integration after extraction
|
|
*/
|
|
testComponentIntegration(components, integrationTests) {
|
|
this.describe('Component Integration', () => {
|
|
integrationTests.forEach((test, index) => {
|
|
this.it(`integration test ${index + 1}`, () => {
|
|
test(components);
|
|
});
|
|
});
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Setup test environment with mock dependencies
|
|
*/
|
|
setupTestEnvironment() {
|
|
// Create test container
|
|
const container = document.createElement('div');
|
|
container.id = 'test-container';
|
|
container.innerHTML = '<div id="markdown-content"></div>';
|
|
document.body.appendChild(container);
|
|
|
|
// Mock any global dependencies
|
|
global.mockSectionManager = {
|
|
sections: new Map(),
|
|
createSectionsFromMarkdown: () => [],
|
|
startEditing: () => true,
|
|
stopEditing: () => true,
|
|
getAllSections: () => []
|
|
};
|
|
|
|
return { container };
|
|
}
|
|
|
|
/**
|
|
* Cleanup test environment
|
|
*/
|
|
cleanupTestEnvironment() {
|
|
const container = document.getElementById('test-container');
|
|
if (container) {
|
|
container.remove();
|
|
}
|
|
|
|
// Clear any global mocks
|
|
delete global.mockSectionManager;
|
|
}
|
|
|
|
async run() {
|
|
console.log('🧪 TDD Refactoring Test Runner Starting...\n');
|
|
|
|
const startTime = Date.now();
|
|
|
|
// Run all collected tests
|
|
// Tests will be added by importing component test files
|
|
|
|
const endTime = Date.now();
|
|
const duration = endTime - startTime;
|
|
|
|
console.log(`\n📊 Test Results:`);
|
|
console.log(` ✅ Passed: ${this.passed}`);
|
|
console.log(` ❌ Failed: ${this.failed}`);
|
|
console.log(` ⏱️ Duration: ${duration}ms`);
|
|
|
|
if (this.failed > 0) {
|
|
console.log(`\n❌ ${this.failed} test(s) failed. Refactoring should not proceed.`);
|
|
process.exit(1);
|
|
} else {
|
|
console.log(`\n✅ All tests passed! Refactoring is safe to continue.`);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Export for use in component tests
|
|
if (typeof module !== 'undefined' && module.exports) {
|
|
module.exports = { RefactorTestRunner };
|
|
}
|
|
|
|
// Export for browser use
|
|
if (typeof window !== 'undefined') {
|
|
window.RefactorTestRunner = RefactorTestRunner;
|
|
}
|
|
|
|
module.exports = RefactorTestRunner; |