fraim-framework 2.0.27 → 2.0.33

package/dist/tests/test-chalk-regression.js

@@ -0,0 +1,377 @@
+"use strict";
+/**
+ * Regression test for chalk ESM issue
+ *
+ * This test ensures that fraim-framework can be installed alongside
+ * chalk v5 without getting ERR_REQUIRE_ESM errors.
+ *
+ * Run with: npx tsx tests/test-chalk-regression.ts
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const test_utils_1 = require("./test-utils");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+async function runCommand(command, args, cwd) {
+    return new Promise((resolve) => {
+        const proc = (0, node_child_process_1.spawn)(command, args, {
+            cwd,
+            stdio: 'pipe',
+            shell: true
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (code) => {
+            resolve({ code, stdout, stderr });
+        });
+    });
+}
+async function testChalkConflictScenario() {
+    console.log('   🧪 Testing chalk conflict scenario (regression test)...');
+    console.log('   This ensures pinned chalk v4 works even with chalk v5 present\n');
+    const tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'chalk-regression-'));
+    console.log(`   📂 Temp dir: ${tempDir}`);
+    let tarballPath = null;
+    try {
+        // 1. Pack fraim-framework
+        console.log('   📦 Packing fraim-framework...');
+        const projectRoot = process.cwd();
+        // Clean up any existing tarballs first
+        const existingTarballs = fs_1.default.readdirSync(projectRoot).filter(f => f.startsWith('fraim-framework-') && f.endsWith('.tgz'));
+        for (const tarball of existingTarballs) {
+            try {
+                fs_1.default.unlinkSync(path_1.default.join(projectRoot, tarball));
+            }
+            catch (e) {
+                // Ignore cleanup errors
+            }
+        }
+        const packResult = (0, node_child_process_1.execSync)('npm pack', {
+            cwd: projectRoot,
+            encoding: 'utf-8'
+        });
+        const tarballName = packResult.trim().split('\n').pop()?.trim();
+        if (!tarballName) {
+            console.log('   ❌ Failed to create tarball');
+            return false;
+        }
+        tarballPath = path_1.default.join(projectRoot, tarballName);
+        console.log(`   ✅ Created: ${tarballName}`);
+        // 2. Create test project with chalk v5
+        console.log('   📝 Creating test project with chalk v5...');
+        const testPackageJson = {
+            name: 'chalk-regression-test',
+            version: '1.0.0',
+            dependencies: {
+                'chalk': '^5.0.0'
+            }
+        };
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'package.json'), JSON.stringify(testPackageJson, null, 2));
+        // 3. Install chalk v5
+        console.log('   📥 Installing chalk v5 first...');
+        const installChalkResult = await runCommand('npm', ['install', '--silent'], tempDir);
+        if (installChalkResult.code !== 0) {
+            console.log('   ⚠️  Failed to install chalk v5');
+        }
+        // 4. Install fraim-framework
+        console.log('   📥 Installing fraim-framework...');
+        const installFraimResult = await runCommand('npm', ['install', tarballPath, '--silent'], tempDir);
+        if (installFraimResult.code !== 0) {
+            console.log('   ⚠️  npm install had issues');
+        }
+        // 5. Check chalk versions
+        console.log('   📋 Checking chalk versions...');
+        const lsResult = await runCommand('npm', ['ls', 'chalk'], tempDir);
+        console.log(lsResult.stdout);
+        // Verify fraim has its own chalk v4
+        const fraimChalkPath = path_1.default.join(tempDir, 'node_modules', 'fraim-framework', 'node_modules', 'chalk', 'package.json');
+        const rootChalkPath = path_1.default.join(tempDir, 'node_modules', 'chalk', 'package.json');
+        let fraimChalkVersion = null;
+        let rootChalkVersion = null;
+        if (fs_1.default.existsSync(rootChalkPath)) {
+            const pkg = JSON.parse(fs_1.default.readFileSync(rootChalkPath, 'utf-8'));
+            rootChalkVersion = pkg.version;
+            console.log(`   📌 Root chalk: ${rootChalkVersion}`);
+        }
+        if (fs_1.default.existsSync(fraimChalkPath)) {
+            const pkg = JSON.parse(fs_1.default.readFileSync(fraimChalkPath, 'utf-8'));
+            fraimChalkVersion = pkg.version;
+            console.log(`   📌 fraim-framework's chalk: ${fraimChalkVersion}`);
+        }
+        else {
+            console.log('   ⚠️  fraim-framework has no separate chalk');
+        }
+        // 6. Test if fraim CLI can be required
+        console.log('   🚀 Testing if fraim CLI can be required...');
+        // Create a test that explicitly checks for ERR_REQUIRE_ESM
+        const testScript = `
+try {
+    const chalk = require('chalk');
+    console.log('✓ Chalk loaded successfully');
+} catch (error) {
+    console.error('✗ Failed to load chalk: ' + error.message);
+    process.exit(2);
+}
+
+try {
+    const fraimCli = require('./node_modules/fraim-framework/dist/src/cli/fraim.js');
+    console.log('✓ FRAIM CLI loaded successfully');
+    console.log('✓ No ERR_REQUIRE_ESM error');
+    process.exit(0);
+} catch (error) {
+    if (error.code === 'ERR_REQUIRE_ESM') {
+        console.error('✗ ERR_REQUIRE_ESM: ' + error.message);
+        process.exit(1);
+    } else {
+        console.error('✗ Other error: ' + error.message);
+        process.exit(2);
+    }
+}
+`;
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'test.js'), testScript);
+        const testResult = await runCommand('node', ['test.js'], tempDir);
+        console.log('   Output:');
+        testResult.stdout.split('\n').forEach(line => {
+            if (line.trim())
+                console.log(`     ${line}`);
+        });
+        // Only show stderr if there was an actual error (non-zero exit code)
+        if (testResult.code !== 0 && testResult.stderr) {
+            console.log('   Errors:');
+            testResult.stderr.split('\n').forEach(line => {
+                if (line.trim())
+                    console.log(`     ${line}`);
+            });
+        }
+        // 7. Evaluate result
+        // The CLI will show help and exit with non-zero code when loaded without args
+        // We need to check if it actually loaded (no ERR_REQUIRE_ESM) vs failed to load
+        const hasERR_REQUIRE_ESM = testResult.stderr.includes('ERR_REQUIRE_ESM') || testResult.stdout.includes('ERR_REQUIRE_ESM');
+        const cliLoaded = testResult.stdout.includes('✓ FRAIM CLI loaded successfully') || testResult.stderr.includes('Usage: fraim');
+        // Also check if fraim-framework has its own chalk v4
+        const hasNestedChalk = fraimChalkVersion && fraimChalkVersion.startsWith('4.');
+        if (cliLoaded && !hasERR_REQUIRE_ESM) {
+            console.log('   ✅ SUCCESS: fraim CLI loaded without ERR_REQUIRE_ESM');
+            console.log('   ✅ Pinned chalk v4 works even with chalk v5 present');
+            // Verify fraim has its own chalk v4
+            if (hasNestedChalk) {
+                console.log('   ✅ fraim-framework correctly has chalk v4');
+            }
+            else {
+                console.log('   ⚠️  WARNING: fraim-framework has no nested chalk v4');
+                console.log('   ⚠️  This might cause issues in some environments');
+                console.log('   ⚠️  But CLI loaded successfully, so test passes');
+            }
+            if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            return true;
+        }
+        else if (hasERR_REQUIRE_ESM) {
+            console.log('   ❌ REGRESSION: Got ERR_REQUIRE_ESM error!');
+            console.log('   ❌ The chalk fix is broken');
+            if (!hasNestedChalk) {
+                console.log('   ❌ fraim-framework has no nested chalk v4 - using root v5');
+            }
+            else {
+                console.log('   ❌ fraim-framework has chalk v4 but still got error (unexpected)');
+            }
+            if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            return false;
+        }
+        else {
+            console.log('   ❌ Got unexpected error (exit code: ' + testResult.code + ')');
+            console.log('   ❌ Check the error output above');
+            if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            return false;
+        }
+    }
+    catch (error) {
+        console.error('   ❌ Conflict scenario test failed with exception:', error);
+        console.error('   ❌ This is likely a test infrastructure issue, not a chalk issue');
+        if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+            try {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            catch (e) {
+                // Ignore cleanup errors
+            }
+        }
+        return false;
+    }
+    finally {
+        try {
+            fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+            console.log('   🧹 Cleaned up temp directory');
+        }
+        catch (e) {
+            console.log('   ⚠️  Could not clean up temp directory');
+        }
+    }
+}
+async function testFreshInstall() {
+    console.log('   🧪 Testing fresh install (no conflicts)...');
+    console.log('   This simulates: npx fraim-framework init\n');
+    const tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'chalk-fresh-'));
+    console.log(`   📂 Temp dir: ${tempDir}`);
+    let tarballPath = null;
+    try {
+        // 1. Pack fraim-framework
+        console.log('   📦 Packing fraim-framework...');
+        const projectRoot = process.cwd();
+        // Clean up any existing tarballs first
+        const existingTarballs = fs_1.default.readdirSync(projectRoot).filter(f => f.startsWith('fraim-framework-') && f.endsWith('.tgz'));
+        for (const tarball of existingTarballs) {
+            try {
+                fs_1.default.unlinkSync(path_1.default.join(projectRoot, tarball));
+            }
+            catch (e) {
+                // Ignore cleanup errors
+            }
+        }
+        const packResult = (0, node_child_process_1.execSync)('npm pack', {
+            cwd: projectRoot,
+            encoding: 'utf-8'
+        });
+        const tarballName = packResult.trim().split('\n').pop()?.trim();
+        if (!tarballName) {
+            console.log('   ❌ Failed to create tarball');
+            return false;
+        }
+        tarballPath = path_1.default.join(projectRoot, tarballName);
+        console.log(`   ✅ Created: ${tarballName}`);
+        // 2. Create empty project
+        console.log('   📝 Creating empty project...');
+        const testPackageJson = {
+            name: 'fresh-install-test',
+            version: '1.0.0'
+        };
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'package.json'), JSON.stringify(testPackageJson, null, 2));
+        // 3. Install fraim-framework
+        console.log('   📥 Installing fraim-framework...');
+        await runCommand('npm', ['install', tarballPath, '--silent'], tempDir);
+        // 4. Check chalk version
+        const chalkPath = path_1.default.join(tempDir, 'node_modules', 'chalk', 'package.json');
+        if (fs_1.default.existsSync(chalkPath)) {
+            const pkg = JSON.parse(fs_1.default.readFileSync(chalkPath, 'utf-8'));
+            console.log(`   📌 Installed chalk: ${pkg.version}`);
+            if (!pkg.version.startsWith('4.')) {
+                console.log(`   ❌ Wrong chalk version! Expected 4.x, got ${pkg.version}`);
+                fs_1.default.unlinkSync(tarballPath);
+                return false;
+            }
+        }
+        // 5. Test if fraim CLI can be required
+        console.log('   🚀 Testing if fraim CLI can be required...');
+        const testScript = `
+try {
+    const fraimCli = require('./node_modules/fraim-framework/dist/src/cli/fraim.js');
+    console.log('✓ FRAIM CLI loaded successfully');
+    process.exit(0);
+} catch (error) {
+    if (error.code === 'ERR_REQUIRE_ESM') {
+        console.error('✗ ERR_REQUIRE_ESM: ' + error.message);
+        process.exit(1);
+    } else {
+        console.error('✗ Other error: ' + error.message);
+        process.exit(2);
+    }
+}
+`;
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'test.js'), testScript);
+        const testResult = await runCommand('node', ['test.js'], tempDir);
+        console.log('   Output:');
+        testResult.stdout.split('\n').forEach(line => {
+            if (line.trim())
+                console.log(`     ${line}`);
+        });
+        // Only show stderr if there was an actual error
+        if (testResult.code !== 0 && testResult.stderr) {
+            console.log('   Errors:');
+            testResult.stderr.split('\n').forEach(line => {
+                if (line.trim())
+                    console.log(`     ${line}`);
+            });
+        }
+        // Check if CLI loaded successfully
+        // The CLI will show help when loaded without args, which goes to stderr
+        const hasERR_REQUIRE_ESM = testResult.stderr.includes('ERR_REQUIRE_ESM') || testResult.stdout.includes('ERR_REQUIRE_ESM');
+        const cliLoaded = testResult.stdout.includes('✓ FRAIM CLI loaded successfully') || testResult.stderr.includes('Usage: fraim');
+        if (cliLoaded && !hasERR_REQUIRE_ESM) {
+            console.log('   ✅ SUCCESS: Fresh install works correctly');
+            if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            return true;
+        }
+        else if (hasERR_REQUIRE_ESM) {
+            console.log('   ❌ REGRESSION: Got ERR_REQUIRE_ESM error!');
+            if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            return false;
+        }
+        else {
+            console.log('   ❌ Got unexpected error (exit code: ' + testResult.code + ')');
+            console.log('   ❌ Check the error output above');
+            if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            return false;
+        }
+    }
+    catch (error) {
+        console.error('   ❌ Fresh install test failed with exception:', error);
+        console.error('   ❌ This is likely a test infrastructure issue, not a chalk issue');
+        if (tarballPath && fs_1.default.existsSync(tarballPath)) {
+            try {
+                fs_1.default.unlinkSync(tarballPath);
+            }
+            catch (e) {
+                // Ignore cleanup errors
+            }
+        }
+        return false;
+    }
+    finally {
+        try {
+            fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+            console.log('   🧹 Cleaned up temp directory');
+        }
+        catch (e) {
+            console.log('   ⚠️  Could not clean up temp directory');
+        }
+    }
+}
+async function runChalkRegressionTest(testCase) {
+    return await testCase.testFunction();
+}
+const testCases = [
+    {
+        name: 'Fresh Install Test',
+        description: 'Verifies fraim-framework installs with correct chalk version in fresh project',
+        testFunction: testFreshInstall,
+        tags: ['regression', 'chalk', 'fresh-install']
+    },
+    {
+        name: 'Chalk Conflict Scenario',
+        description: 'Verifies fraim-framework works when chalk v5 is present (regression test)',
+        testFunction: testChalkConflictScenario,
+        tags: ['regression', 'chalk', 'conflict']
+    }
+];
+(0, test_utils_1.runTests)(testCases, runChalkRegressionTest, 'Chalk ESM Regression Test');

package/dist/tests/test-chalk-resolution-issue.js

@@ -0,0 +1,304 @@
+"use strict";
+/**
+ * Test to reproduce and verify the fix for the chalk v5 resolution issue
+ *
+ * This test creates a scenario where npm might resolve chalk to v5 by:
+ * 1. Creating a dependency that requires chalk v5
+ * 2. Testing if fraim-framework with ^4.1.2 gets upgraded
+ * 3. Testing if fraim-framework with 4.1.2 (pinned) stays at v4
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const test_utils_1 = require("./test-utils");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+async function runCommand(command, args, cwd) {
+    return new Promise((resolve) => {
+        const proc = (0, node_child_process_1.spawn)(command, args, {
+            cwd,
+            stdio: 'pipe',
+            shell: true
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (code) => {
+            resolve({ code, stdout, stderr });
+        });
+    });
+}
+async function testChalkResolutionWithConflict() {
+    console.log('   🧪 Testing chalk resolution with conflicting dependency...');
+    const tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'chalk-conflict-'));
+    console.log(`   📂 Created temp dir: ${tempDir}`);
+    try {
+        // 1. Create a package that depends on chalk v5
+        console.log('   📦 Creating fake package that requires chalk v5...');
+        const fakePackageDir = path_1.default.join(tempDir, 'fake-chalk5-package');
+        fs_1.default.mkdirSync(fakePackageDir, { recursive: true });
+        const fakePackageJson = {
+            name: 'fake-chalk5-package',
+            version: '1.0.0',
+            dependencies: {
+                'chalk': '^5.0.0'
+            }
+        };
+        fs_1.default.writeFileSync(path_1.default.join(fakePackageDir, 'package.json'), JSON.stringify(fakePackageJson, null, 2));
+        // Create a simple index.js that uses chalk
+        fs_1.default.writeFileSync(path_1.default.join(fakePackageDir, 'index.js'), 'export { default as chalk } from "chalk";\n');
+        // 2. Pack fraim-framework with ^4.1.2 (unpinned)
+        console.log('   📦 Packing fraim-framework with ^4.1.2...');
+        const projectRoot = process.cwd();
+        const packageJsonPath = path_1.default.join(projectRoot, 'package.json');
+        const originalPackageJson = fs_1.default.readFileSync(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(originalPackageJson);
+        // Temporarily change to ^4.1.2
+        packageJson.dependencies.chalk = '^4.1.2';
+        fs_1.default.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+        const packResult = (0, node_child_process_1.execSync)('npm pack', {
+            cwd: projectRoot,
+            encoding: 'utf-8'
+        });
+        const tarballName = packResult.trim().split('\n').pop()?.trim();
+        if (!tarballName) {
+            fs_1.default.writeFileSync(packageJsonPath, originalPackageJson);
+            return false;
+        }
+        const tarballPath = path_1.default.join(projectRoot, tarballName);
+        // Restore original package.json
+        fs_1.default.writeFileSync(packageJsonPath, originalPackageJson);
+        // 3. Create test project that depends on BOTH packages
+        console.log('   🔧 Creating test project with conflicting dependencies...');
+        const testPackageJson = {
+            name: 'chalk-conflict-test',
+            version: '1.0.0',
+            dependencies: {
+                'fake-chalk5-package': 'file:./fake-chalk5-package',
+                'fraim-framework': `file:${tarballPath}`
+            }
+        };
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'package.json'), JSON.stringify(testPackageJson, null, 2));
+        // 4. Install dependencies - npm will try to resolve chalk
+        console.log('   📥 Installing with conflicting chalk requirements...');
+        console.log('   ⚠️  fake-chalk5-package wants chalk ^5.0.0');
+        console.log('   ⚠️  fraim-framework wants chalk ^4.1.2');
+        const installResult = await runCommand('npm', ['install'], tempDir);
+        if (installResult.code !== 0) {
+            console.log('   ⚠️  npm install failed (might be expected)');
+            console.log(`   stderr: ${installResult.stderr.substring(0, 300)}`);
+        }
+        // 5. Check what version of chalk was installed for fraim-framework
+        const fraimChalkPath = path_1.default.join(tempDir, 'node_modules', 'fraim-framework', 'node_modules', 'chalk', 'package.json');
+        const rootChalkPath = path_1.default.join(tempDir, 'node_modules', 'chalk', 'package.json');
+        let fraimChalkVersion = null;
+        let rootChalkVersion = null;
+        if (fs_1.default.existsSync(fraimChalkPath)) {
+            const chalkPkg = JSON.parse(fs_1.default.readFileSync(fraimChalkPath, 'utf-8'));
+            fraimChalkVersion = chalkPkg.version;
+            console.log(`   📋 fraim-framework's chalk: ${fraimChalkVersion}`);
+        }
+        if (fs_1.default.existsSync(rootChalkPath)) {
+            const chalkPkg = JSON.parse(fs_1.default.readFileSync(rootChalkPath, 'utf-8'));
+            rootChalkVersion = chalkPkg.version;
+            console.log(`   📋 Root chalk: ${rootChalkVersion}`);
+        }
+        // 6. Try to load fraim CLI
+        console.log('   🚀 Testing if fraim CLI loads...');
+        const testScript = `
+try {
+    const fraimCli = require('./node_modules/fraim-framework/dist/src/cli/fraim.js');
+    console.log('SUCCESS: fraim CLI loaded');
+    process.exit(0);
+} catch (error) {
+    if (error.code === 'ERR_REQUIRE_ESM') {
+        console.log('ERROR: ERR_REQUIRE_ESM - chalk v5 was used!');
+        console.log('Chalk version caused issue:', error.message);
+        process.exit(1);
+    } else {
+        console.log('ERROR: Other error:', error.message);
+        process.exit(2);
+    }
+}
+`;
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'test.js'), testScript);
+        const testResult = await runCommand('node', ['test.js'], tempDir);
+        if (testResult.code === 1) {
+            console.log('   ❌ REPRODUCED THE BUG! npm resolved chalk to v5');
+            console.log('   ❌ fraim-framework with ^4.1.2 got chalk v5 due to conflict');
+            console.log('   ✅ This proves the issue exists with ^4.1.2');
+            // Cleanup
+            fs_1.default.unlinkSync(tarballPath);
+            return true; // We successfully reproduced the bug!
+        }
+        else if (testResult.code === 0) {
+            console.log('   ℹ️  fraim CLI loaded successfully');
+            console.log('   ℹ️  npm resolved the conflict without upgrading to v5');
+            console.log('   ℹ️  This scenario didn\'t trigger the bug, but it could in other environments');
+        }
+        else {
+            console.log('   ⚠️  Got unexpected error');
+            console.log(`   stdout: ${testResult.stdout}`);
+        }
+        // Cleanup
+        fs_1.default.unlinkSync(tarballPath);
+        return true;
+    }
+    catch (error) {
+        console.error('   ❌ Test failed with error:', error);
+        return false;
+    }
+    finally {
+        try {
+            fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+            console.log('   🧹 Cleaned up temp directory');
+        }
+        catch (e) {
+            console.log('   ⚠️  Could not clean up temp directory');
+        }
+    }
+}
+async function testChalkResolutionWithPinnedVersion() {
+    console.log('   🧪 Testing chalk resolution with PINNED version (4.1.2)...');
+    const tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'chalk-pinned-'));
+    console.log(`   📂 Created temp dir: ${tempDir}`);
+    try {
+        // 1. Create a package that depends on chalk v5
+        console.log('   📦 Creating fake package that requires chalk v5...');
+        const fakePackageDir = path_1.default.join(tempDir, 'fake-chalk5-package');
+        fs_1.default.mkdirSync(fakePackageDir, { recursive: true });
+        const fakePackageJson = {
+            name: 'fake-chalk5-package',
+            version: '1.0.0',
+            dependencies: {
+                'chalk': '^5.0.0'
+            }
+        };
+        fs_1.default.writeFileSync(path_1.default.join(fakePackageDir, 'package.json'), JSON.stringify(fakePackageJson, null, 2));
+        fs_1.default.writeFileSync(path_1.default.join(fakePackageDir, 'index.js'), 'export { default as chalk } from "chalk";\n');
+        // 2. Pack fraim-framework with 4.1.2 (PINNED - current state)
+        console.log('   📦 Packing fraim-framework with pinned 4.1.2...');
+        const projectRoot = process.cwd();
+        const packResult = (0, node_child_process_1.execSync)('npm pack', {
+            cwd: projectRoot,
+            encoding: 'utf-8'
+        });
+        const tarballName = packResult.trim().split('\n').pop()?.trim();
+        if (!tarballName) {
+            return false;
+        }
+        const tarballPath = path_1.default.join(projectRoot, tarballName);
+        // 3. Create test project with conflicting dependencies
+        console.log('   🔧 Creating test project with conflicting dependencies...');
+        const testPackageJson = {
+            name: 'chalk-pinned-test',
+            version: '1.0.0',
+            dependencies: {
+                'fake-chalk5-package': 'file:./fake-chalk5-package',
+                'fraim-framework': `file:${tarballPath}`
+            }
+        };
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'package.json'), JSON.stringify(testPackageJson, null, 2));
+        // 4. Install dependencies
+        console.log('   📥 Installing with conflicting chalk requirements...');
+        console.log('   ⚠️  fake-chalk5-package wants chalk ^5.0.0');
+        console.log('   ✅ fraim-framework wants chalk 4.1.2 (PINNED)');
+        const installResult = await runCommand('npm', ['install'], tempDir);
+        if (installResult.code !== 0) {
+            console.log('   ⚠️  npm install failed');
+        }
+        // 5. Check chalk versions
+        const fraimChalkPath = path_1.default.join(tempDir, 'node_modules', 'fraim-framework', 'node_modules', 'chalk', 'package.json');
+        const rootChalkPath = path_1.default.join(tempDir, 'node_modules', 'chalk', 'package.json');
+        let fraimChalkVersion = null;
+        let rootChalkVersion = null;
+        if (fs_1.default.existsSync(fraimChalkPath)) {
+            const chalkPkg = JSON.parse(fs_1.default.readFileSync(fraimChalkPath, 'utf-8'));
+            fraimChalkVersion = chalkPkg.version;
+            console.log(`   📋 fraim-framework's chalk: ${fraimChalkVersion}`);
+        }
+        if (fs_1.default.existsSync(rootChalkPath)) {
+            const chalkPkg = JSON.parse(fs_1.default.readFileSync(rootChalkPath, 'utf-8'));
+            rootChalkVersion = chalkPkg.version;
+            console.log(`   📋 Root chalk: ${rootChalkVersion}`);
+        }
+        // Verify fraim has v4
+        if (fraimChalkVersion && !fraimChalkVersion.startsWith('4.')) {
+            console.log(`   ❌ PINNED version failed! Got chalk ${fraimChalkVersion}`);
+            fs_1.default.unlinkSync(tarballPath);
+            return false;
+        }
+        // 6. Try to load fraim CLI
+        console.log('   🚀 Testing if fraim CLI loads...');
+        const testScript = `
+try {
+    const fraimCli = require('./node_modules/fraim-framework/dist/src/cli/fraim.js');
+    console.log('SUCCESS: fraim CLI loaded with pinned chalk');
+    process.exit(0);
+} catch (error) {
+    if (error.code === 'ERR_REQUIRE_ESM') {
+        console.log('ERROR: ERR_REQUIRE_ESM even with pinned version!');
+        process.exit(1);
+    } else {
+        console.log('ERROR: Other error:', error.message);
+        process.exit(2);
+    }
+}
+`;
+        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'test.js'), testScript);
+        const testResult = await runCommand('node', ['test.js'], tempDir);
+        if (testResult.code === 0) {
+            console.log('   ✅ SUCCESS! Pinned version prevents chalk v5 upgrade');
+            console.log('   ✅ fraim CLI works even with chalk v5 dependency nearby');
+            console.log('   ✅ This proves the fix works!');
+        }
+        else if (testResult.code === 1) {
+            console.log('   ❌ FAILED! Even pinned version got chalk v5');
+            console.log('   ❌ The fix doesn\'t work!');
+            fs_1.default.unlinkSync(tarballPath);
+            return false;
+        }
+        // Cleanup
+        fs_1.default.unlinkSync(tarballPath);
+        return true;
+    }
+    catch (error) {
+        console.error('   ❌ Test failed with error:', error);
+        return false;
+    }
+    finally {
+        try {
+            fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+            console.log('   🧹 Cleaned up temp directory');
+        }
+        catch (e) {
+            console.log('   ⚠️  Could not clean up temp directory');
+        }
+    }
+}
+async function runChalkResolutionTest(testCase) {
+    return await testCase.testFunction();
+}
+const testCases = [
+    {
+        name: 'Chalk Resolution with Conflict (^4.1.2)',
+        description: 'Tests if ^4.1.2 allows npm to upgrade to chalk v5 when there\'s a conflicting dependency',
+        testFunction: testChalkResolutionWithConflict,
+        tags: ['chalk', 'resolution', 'conflict']
+    },
+    {
+        name: 'Chalk Resolution with Pinned Version (4.1.2)',
+        description: 'Tests if pinned 4.1.2 prevents npm from upgrading to chalk v5',
+        testFunction: testChalkResolutionWithPinnedVersion,
+        tags: ['chalk', 'resolution', 'pinned', 'fix']
+    }
+];
+(0, test_utils_1.runTests)(testCases, runChalkResolutionTest, 'Chalk Resolution Issue Test');