fraim-framework 2.0.35 → 2.0.36

package/dist/tests/test-fraim-install-chalk-issue.js

@@ -1,254 +0,0 @@
-"use strict";
-/**
- * Integration test to verify fraim-framework installs correctly
- * and doesn't have the chalk ESM issue
- *
- * This test:
- * 1. Packs the current fraim-framework into a tarball
- * 2. Installs it fresh in a temp directory
- * 3. Runs fraim init to verify it works
- * 4. Tests with both pinned (4.1.2) and unpinned (^4.1.2) chalk versions
- */
-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 testFraimInstallWithPinnedChalk() {
-    console.log('   🧪 Testing FRAIM install with PINNED chalk (4.1.2)...');
-    const tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'fraim-install-pinned-'));
-    console.log(`   📂 Created temp dir: ${tempDir}`);
-    try {
-        // 1. Pack the current fraim-framework
-        console.log('   📦 Packing fraim-framework...');
-        const projectRoot = process.cwd();
-        // Run npm pack in the project root
-        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 get tarball name');
-            return false;
-        }
-        const tarballPath = path_1.default.join(projectRoot, tarballName);
-        console.log(`   ✅ Created tarball: ${tarballName}`);
-        // 2. Create a test project
-        const testPackageJson = {
-            name: 'fraim-install-test',
-            version: '1.0.0',
-            private: true
-        };
-        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'package.json'), JSON.stringify(testPackageJson, null, 2));
-        // 3. Install fraim-framework from the tarball
-        console.log('   📥 Installing fraim-framework from tarball...');
-        const installResult = await runCommand('npm', ['install', tarballPath, '--silent'], tempDir);
-        if (installResult.code !== 0) {
-            console.log('   ❌ npm install failed');
-            console.log(`   stderr: ${installResult.stderr.substring(0, 500)}`);
-            return false;
-        }
-        console.log('   ✅ fraim-framework installed successfully');
-        // 4. Check which version of chalk was installed
-        const chalkPackageJsonPath = path_1.default.join(tempDir, 'node_modules', 'chalk', 'package.json');
-        if (!fs_1.default.existsSync(chalkPackageJsonPath)) {
-            console.log('   ❌ chalk not found in node_modules');
-            return false;
-        }
-        const chalkPackageJson = JSON.parse(fs_1.default.readFileSync(chalkPackageJsonPath, 'utf-8'));
-        console.log(`   📋 Installed chalk version: ${chalkPackageJson.version}`);
-        // Verify it's v4.x
-        if (!chalkPackageJson.version.startsWith('4.')) {
-            console.log(`   ❌ Expected chalk v4.x, got ${chalkPackageJson.version}`);
-            return false;
-        }
-        console.log('   ✅ Chalk v4 installed correctly');
-        // 5. Try to run fraim init (should work)
-        console.log('   🚀 Running fraim init...');
-        const fraimBin = path_1.default.join(tempDir, 'node_modules', '.bin', 'fraim');
-        // Create a simple test by requiring the CLI directly
-        const testScript = `
-const fraimCli = require('./node_modules/fraim-framework/dist/src/cli/fraim.js');
-console.log('✅ fraim CLI loaded successfully');
-`;
-        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('   ❌ Failed to load fraim CLI');
-            console.log(`   stderr: ${testResult.stderr.substring(0, 500)}`);
-            return false;
-        }
-        if (!testResult.stdout.includes('fraim CLI loaded successfully')) {
-            console.log('   ❌ fraim CLI did not load correctly');
-            return false;
-        }
-        console.log('   ✅ fraim CLI works with pinned chalk!');
-        // Cleanup tarball
-        fs_1.default.unlinkSync(tarballPath);
-        return true;
-    }
-    catch (error) {
-        console.error('   ❌ Test failed with error:', error);
-        return false;
-    }
-    finally {
-        // Cleanup
-        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 testFraimInstallWithUnpinnedChalk() {
-    console.log('   🧪 Testing FRAIM install with UNPINNED chalk (^4.1.2)...');
-    console.log('   ⚠️  This simulates the original issue...');
-    const tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'fraim-install-unpinned-'));
-    console.log(`   📂 Created temp dir: ${tempDir}`);
-    try {
-        // 1. Temporarily modify package.json to use ^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);
-        // Save original chalk version
-        const originalChalkVersion = packageJson.dependencies.chalk;
-        console.log(`   📋 Original chalk version: ${originalChalkVersion}`);
-        // Temporarily change to ^4.1.2
-        packageJson.dependencies.chalk = '^4.1.2';
-        fs_1.default.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
-        console.log('   🔄 Temporarily changed chalk to ^4.1.2');
-        // 2. Pack with unpinned version
-        console.log('   📦 Packing fraim-framework with unpinned chalk...');
-        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 get tarball name');
-            // Restore original package.json
-            fs_1.default.writeFileSync(packageJsonPath, originalPackageJson);
-            return false;
-        }
-        const tarballPath = path_1.default.join(projectRoot, tarballName);
-        console.log(`   ✅ Created tarball: ${tarballName}`);
-        // 3. Restore original package.json
-        fs_1.default.writeFileSync(packageJsonPath, originalPackageJson);
-        console.log('   ✅ Restored original package.json');
-        // 4. Create a test project
-        const testPackageJson = {
-            name: 'fraim-install-test-unpinned',
-            version: '1.0.0',
-            private: true
-        };
-        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'package.json'), JSON.stringify(testPackageJson, null, 2));
-        // 5. Install fraim-framework from the tarball
-        console.log('   📥 Installing fraim-framework with unpinned chalk...');
-        const installResult = await runCommand('npm', ['install', tarballPath, '--silent'], tempDir);
-        if (installResult.code !== 0) {
-            console.log('   ❌ npm install failed');
-            console.log(`   stderr: ${installResult.stderr.substring(0, 500)}`);
-            fs_1.default.unlinkSync(tarballPath);
-            return false;
-        }
-        console.log('   ✅ fraim-framework installed');
-        // 6. Check which version of chalk was installed
-        const chalkPackageJsonPath = path_1.default.join(tempDir, 'node_modules', 'chalk', 'package.json');
-        if (!fs_1.default.existsSync(chalkPackageJsonPath)) {
-            console.log('   ❌ chalk not found in node_modules');
-            fs_1.default.unlinkSync(tarballPath);
-            return false;
-        }
-        const chalkPackageJson = JSON.parse(fs_1.default.readFileSync(chalkPackageJsonPath, 'utf-8'));
-        console.log(`   📋 Installed chalk version: ${chalkPackageJson.version}`);
-        // 7. Try to load fraim CLI
-        const testScript = `
-const fraimCli = require('./node_modules/fraim-framework/dist/src/cli/fraim.js');
-console.log('✅ fraim CLI loaded successfully');
-`;
-        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'test.js'), testScript);
-        const testResult = await runCommand('node', ['test.js'], tempDir);
-        // With ^4.1.2, it MIGHT install v5 in some scenarios, causing ERR_REQUIRE_ESM
-        if (testResult.code !== 0) {
-            if (testResult.stderr.includes('ERR_REQUIRE_ESM')) {
-                console.log('   ⚠️  Got ERR_REQUIRE_ESM error (this is the bug we fixed!)');
-                console.log(`   📋 Chalk version that caused issue: ${chalkPackageJson.version}`);
-                console.log('   ✅ Test successfully reproduced the original issue');
-                fs_1.default.unlinkSync(tarballPath);
-                return true; // This is expected - we reproduced the bug
-            }
-            else {
-                console.log('   ❌ Failed with unexpected error');
-                console.log(`   stderr: ${testResult.stderr.substring(0, 500)}`);
-                fs_1.default.unlinkSync(tarballPath);
-                return false;
-            }
-        }
-        // If it worked, that's also fine - means npm resolved to v4
-        console.log('   ✅ fraim CLI works (npm resolved to v4)');
-        console.log('   ℹ️  Note: ^4.1.2 worked this time, but could fail in other environments');
-        // Cleanup tarball
-        fs_1.default.unlinkSync(tarballPath);
-        return true;
-    }
-    catch (error) {
-        console.error('   ❌ Test failed with error:', error);
-        return false;
-    }
-    finally {
-        // Cleanup
-        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 runFraimInstallTest(testCase) {
-    return await testCase.testFunction();
-}
-const testCases = [
-    {
-        name: 'FRAIM Install with Pinned Chalk',
-        description: 'Verifies fraim-framework installs correctly with chalk pinned to 4.1.2',
-        testFunction: testFraimInstallWithPinnedChalk,
-        tags: ['integration', 'install', 'chalk']
-    },
-    {
-        name: 'FRAIM Install with Unpinned Chalk',
-        description: 'Tests fraim-framework with ^4.1.2 to see if it can reproduce the issue',
-        testFunction: testFraimInstallWithUnpinnedChalk,
-        tags: ['integration', 'install', 'chalk', 'reproduction']
-    }
-];
-(0, test_utils_1.runTests)(testCases, runFraimInstallTest, 'FRAIM Install Chalk Issue Test');

package/dist/tests/test-npm-resolution-diagnostic.js

@@ -1,140 +0,0 @@
-"use strict";
-/**
- * Diagnostic test to understand npm's chalk resolution behavior
- *
- * This test will show us exactly what npm does when there's a version conflict
- */
-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 fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-async function main() {
-    console.log('🔍 NPM Chalk Resolution Diagnostic\n');
-    const tempDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'npm-diagnostic-'));
-    console.log(`📂 Temp dir: ${tempDir}\n`);
-    try {
-        // 1. Pack fraim-framework
-        console.log('📦 Packing fraim-framework...');
-        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) {
-            console.log('❌ Failed to pack');
-            return;
-        }
-        const tarballPath = path_1.default.join(projectRoot, tarballName);
-        console.log(`✅ Created: ${tarballName}\n`);
-        // 2. Create test project with chalk v5
-        console.log('📝 Creating test project with chalk v5 dependency...');
-        const packageJson = {
-            name: 'diagnostic-test',
-            version: '1.0.0',
-            dependencies: {
-                'chalk': '^5.0.0',
-                'fraim-framework': `file:${tarballPath}`
-            }
-        };
-        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'package.json'), JSON.stringify(packageJson, null, 2));
-        // 3. Install
-        console.log('📥 Running npm install...\n');
-        try {
-            const installOutput = (0, node_child_process_1.execSync)('npm install', {
-                cwd: tempDir,
-                encoding: 'utf-8',
-                stdio: 'pipe'
-            });
-            console.log('✅ Install completed\n');
-        }
-        catch (error) {
-            console.log('⚠️  Install had issues:\n', error.stdout || error.message);
-        }
-        // 4. Check what was installed
-        console.log('📋 Checking installed chalk versions...\n');
-        // Root chalk
-        const rootChalkPath = path_1.default.join(tempDir, 'node_modules', 'chalk', 'package.json');
-        if (fs_1.default.existsSync(rootChalkPath)) {
-            const pkg = JSON.parse(fs_1.default.readFileSync(rootChalkPath, 'utf-8'));
-            console.log(`  Root chalk: ${pkg.version}`);
-            console.log(`  Type: ${pkg.type || 'commonjs'}`);
-            console.log(`  Main: ${pkg.main || 'N/A'}`);
-            console.log(`  Exports: ${pkg.exports ? 'Yes' : 'No'}\n`);
-        }
-        else {
-            console.log('  ❌ No root chalk found\n');
-        }
-        // Fraim's chalk
-        const fraimChalkPath = path_1.default.join(tempDir, 'node_modules', 'fraim-framework', 'node_modules', 'chalk', 'package.json');
-        if (fs_1.default.existsSync(fraimChalkPath)) {
-            const pkg = JSON.parse(fs_1.default.readFileSync(fraimChalkPath, 'utf-8'));
-            console.log(`  fraim-framework's chalk: ${pkg.version}`);
-            console.log(`  Type: ${pkg.type || 'commonjs'}`);
-            console.log(`  Main: ${pkg.main || 'N/A'}\n`);
-        }
-        else {
-            console.log('  ℹ️  fraim-framework has no separate chalk (using root)\n');
-        }
-        // 5. Run npm ls to see the dependency tree
-        console.log('🌳 Dependency tree (npm ls chalk):\n');
-        try {
-            const lsOutput = (0, node_child_process_1.execSync)('npm ls chalk', {
-                cwd: tempDir,
-                encoding: 'utf-8'
-            });
-            console.log(lsOutput);
-        }
-        catch (error) {
-            console.log(error.stdout || error.message);
-        }
-        // 6. Check fraim-framework's package.json in node_modules
-        console.log('\n📋 fraim-framework\'s chalk dependency in node_modules:\n');
-        const fraimPkgPath = path_1.default.join(tempDir, 'node_modules', 'fraim-framework', 'package.json');
-        if (fs_1.default.existsSync(fraimPkgPath)) {
-            const fraimPkg = JSON.parse(fs_1.default.readFileSync(fraimPkgPath, 'utf-8'));
-            console.log(`  Chalk version in package.json: ${fraimPkg.dependencies?.chalk || 'N/A'}\n`);
-        }
-        // 7. Try to load fraim CLI
-        console.log('🚀 Testing fraim CLI load...\n');
-        const testScript = `
-try {
-    const fraimCli = require('./node_modules/fraim-framework/dist/src/cli/fraim.js');
-    console.log('✅ SUCCESS: fraim CLI loaded');
-} catch (error) {
-    console.log('❌ ERROR:', error.code || 'Unknown');
-    console.log('Message:', error.message.substring(0, 200));
-}
-`;
-        fs_1.default.writeFileSync(path_1.default.join(tempDir, 'test.js'), testScript);
-        try {
-            const testOutput = (0, node_child_process_1.execSync)('node test.js', {
-                cwd: tempDir,
-                encoding: 'utf-8'
-            });
-            console.log(testOutput);
-        }
-        catch (error) {
-            console.log(error.stdout || error.message);
-        }
-        // Cleanup
-        fs_1.default.unlinkSync(tarballPath);
-        console.log('\n✅ Diagnostic complete');
-    }
-    catch (error) {
-        console.error('\n❌ Diagnostic failed:', error);
-    }
-    finally {
-        try {
-            fs_1.default.rmSync(tempDir, { recursive: true, force: true });
-        }
-        catch (e) {
-            console.log('\n⚠️  Could not clean up temp directory');
-        }
-    }
-}
-main();

package/registry/templates/marketing/STORYTELLING-TEMPLATE.md

@@ -1,130 +0,0 @@
-# Template: Marketing Storytelling
-
-Use this template to transform product development experiences into compelling founder narratives for events and speaking opportunities.
-
-## Project Setup
-- **Product/Project Name**: 
-- **Issue Number**: 
-- **Target Event**: 
-- **Event Type**: [Conference Talk / Panel / Workshop / Podcast / Accelerator / Meetup]
-- **Audience**: [Technical / Business / Mixed]
-- **Event Date**: 
-- **Submission Deadline**: 
-
-## Story Arc Development
-
-### Original Intent
-**What was the vision?**
-
-
-**Why did it matter?**
-
-
-**What problem were you solving?**
-
-
-### Friction Points
-**What unexpected challenges emerged?**
-
-
-**What failures or setbacks occurred?**
-
-
-**What assumptions proved wrong?**
-
-
-### Key Insights
-**What "aha moments" happened?**
-
-
-**What counterintuitive discoveries were made?**
-
-
-**What would you do differently?**
-
-
-### Final Outcome
-**What was actually built?**
-
-
-**Why does it work?**
-
-
-**What makes it different/better?**
-
-
-## Founder Lessons (3-5 key takeaways)
-
-### Lesson 1
-**Lesson**: 
-**Context**: 
-**Application**: 
-
-### Lesson 2
-**Lesson**: 
-**Context**: 
-**Application**: 
-
-### Lesson 3
-**Lesson**: 
-**Context**: 
-**Application**: 
-
-## Event Content
-
-### Session Title Options
-1. 
-2. 
-3. 
-
-### Session Description (1-2 sentences)
-
-
-### Email Pitch (2-3 paragraphs)
-
-
-### Speaker Bio (50-100 words)
-
-
-### Presentation Outline
-
-#### 5-Minute Version
-- **Hook** (1 min): 
-- **Problem** (1 min): 
-- **Journey** (2 min): 
-- **Takeaway** (1 min): 
-
-#### 15-Minute Version
-- **Opening** (2 min): 
-- **Problem Setup** (3 min): 
-- **Journey/Challenges** (5 min): 
-- **Insights/Solutions** (3 min): 
-- **Takeaways** (2 min): 
-
-#### 30-Minute Version
-- **Introduction** (3 min): 
-- **Context/Background** (5 min): 
-- **Challenge Deep-Dive** (8 min): 
-- **Solution Journey** (8 min): 
-- **Lessons & Applications** (4 min): 
-- **Q&A Prep** (2 min): 
-
-### Q&A Preparation
-**Likely Questions**:
-1. Q: 
-   A: 
-
-2. Q: 
-   A: 
-
-3. Q: 
-   A: 
-
-## Quality Checklist
-- [ ] Story is grounded in actual experience
-- [ ] Avoids internal jargon
-- [ ] Follows clear story arc (intent → friction → insight → outcome)
-- [ ] Provides actionable lessons
-- [ ] Sounds authentic, not sales-y
-- [ ] Matches event format and audience
-- [ ] Professional presentation materials ready

package/registry/workflows/marketing/storytelling.md

@@ -1,65 +0,0 @@
-# Workflow: storytelling
-
-**Path:** `workflows/marketing/storytelling.md`
-
----
-
-# Marketing Storytelling Workflow
-
-## INTENT
-To transform product development experiences into compelling founder narratives for events, conferences, and speaking opportunities that connect technical reality with broadly applicable lessons.
-
-## PRINCIPLES
-- **Grounded in Reality**: All narratives based on actual product development experiences
-- **Story Arc Focus**: Follow intent → friction → insight → outcome structure
-- **Audience-Specific**: Tailor messaging to event type and audience expectations
-- **Authentic Voice**: Avoid sales pitch tone, focus on genuine founder lessons
-
-## STORYTELLING WORKFLOW
-
-### Step 1: Artifact Collection
-Gather source materials that tell the product development story:
-- Product documentation (specs, architecture notes, design docs)
-- Development retrospectives or post-mortems
-- Code repositories and key commits
-- Prior pitches, emails, or presentations
-
-### Step 2: Story Arc Extraction
-Extract the core narrative following the story structure:
-- **Intent**: What was the original vision and why it mattered?
-- **Friction**: What unexpected challenges or failures occurred?
-- **Insight**: What key learnings or "aha moments" emerged?
-- **Outcome**: What was built and why it works?
-
-### Step 3: Founder Lessons Development
-Transform technical experience into broadly applicable lessons:
-- Identify 3-5 key takeaways that apply to other founders
-- Remove internal jargon and technical complexity
-- Focus on decision-making processes and trade-offs
-- Highlight counterintuitive or surprising discoveries
-
-### Step 4: Event-Specific Adaptation
-Customize content for target event and audience:
-- Research event format (conference, panel, workshop, podcast)
-- Adapt language for audience (technical, business, mixed)
-- Create appropriate time formats (5min, 15min, 30min, 45min)
-- Develop supporting materials and Q&A preparation
-
-### Step 5: Content Package Creation
-Generate complete materials for event submission:
-- Email pitch with compelling subject line
-- Session title with clear hook
-- 1-2 sentence session description
-- Speaker bio highlighting relevant experience
-- Presentation outline and talking points
-
-## TEMPLATE USAGE
-
-Use `get_fraim_file({ path: "templates/marketing/STORYTELLING-TEMPLATE.md" })` to create:
-- `docs/marketing/storytelling/{issue_number}-{event-name}.md`
-
-## OUTPUT
-- Compelling founder narrative grounded in product reality
-- Event-ready submission materials
-- Multi-format presentation content
-- Reusable story framework for future opportunities