fraim-framework 2.0.36 → 2.0.37

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

@@ -0,0 +1,140 @@
+"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/dist/tests/test-package-size.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env tsx
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Test to verify package size reduction from stub-only registry
+ */
+(0, node_test_1.test)('Stub registry is significantly smaller than full registry', () => {
+    const fullWorkflowsPath = path_1.default.join(__dirname, '..', 'registry', 'workflows');
+    const stubWorkflowsPath = path_1.default.join(__dirname, '..', 'registry', 'stubs', 'workflows');
+    (0, node_assert_1.default)(fs_1.default.existsSync(fullWorkflowsPath), 'Full workflows directory should exist');
+    (0, node_assert_1.default)(fs_1.default.existsSync(stubWorkflowsPath), 'Stub workflows directory should exist');
+    // Calculate sizes
+    const fullSize = getDirectorySize(fullWorkflowsPath);
+    const stubSize = getDirectorySize(stubWorkflowsPath);
+    console.log(`Full workflows size: ${fullSize} bytes`);
+    console.log(`Stub workflows size: ${stubSize} bytes`);
+    console.log(`Size reduction: ${Math.round((1 - stubSize / fullSize) * 100)}%`);
+    // Stubs should be significantly smaller
+    (0, node_assert_1.default)(stubSize < fullSize * 0.3, `Stubs should be <30% of full size (actual: ${Math.round(stubSize / fullSize * 100)}%)`);
+    // Should have same number of files
+    const fullFiles = getAllFiles(fullWorkflowsPath, '.md');
+    const stubFiles = getAllFiles(stubWorkflowsPath, '.md');
+    node_assert_1.default.strictEqual(stubFiles.length, fullFiles.length, 'Should have same number of workflow files');
+    console.log(`✅ Package size reduced by ${Math.round((1 - stubSize / fullSize) * 100)}% while maintaining all ${stubFiles.length} workflows`);
+});
+(0, node_test_1.test)('Package excludes full workflows and templates', () => {
+    const packageJsonPath = path_1.default.join(__dirname, '..', 'package.json');
+    const packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, 'utf8'));
+    const files = packageJson.files || [];
+    // Calculate what would be excluded
+    const fullWorkflowsSize = getDirectorySize(path_1.default.join(__dirname, '..', 'registry', 'workflows'));
+    const templatesSize = getDirectorySize(path_1.default.join(__dirname, '..', 'registry', 'templates'));
+    const rulesSize = getDirectorySize(path_1.default.join(__dirname, '..', 'registry', 'rules'));
+    const excludedSize = fullWorkflowsSize + templatesSize + rulesSize;
+    // What's included
+    const stubsSize = getDirectorySize(path_1.default.join(__dirname, '..', 'registry', 'stubs'));
+    const scriptsSize = getDirectorySize(path_1.default.join(__dirname, '..', 'registry', 'scripts'));
+    const includedSize = stubsSize + scriptsSize;
+    console.log(`Excluded from package: ${excludedSize} bytes (workflows + templates + rules)`);
+    console.log(`Included in package: ${includedSize} bytes (stubs + scripts)`);
+    console.log(`Total registry size reduction: ${Math.round((1 - includedSize / (includedSize + excludedSize)) * 100)}%`);
+    // Verify significant size reduction
+    (0, node_assert_1.default)(includedSize < excludedSize, 'Package should exclude more content than it includes');
+    console.log('✅ Package correctly excludes heavy content while keeping essentials');
+});
+function getDirectorySize(dirPath) {
+    if (!fs_1.default.existsSync(dirPath)) {
+        return 0;
+    }
+    let totalSize = 0;
+    const files = getAllFiles(dirPath);
+    for (const file of files) {
+        try {
+            const stats = fs_1.default.statSync(file);
+            totalSize += stats.size;
+        }
+        catch (e) {
+            // Skip files that can't be read
+        }
+    }
+    return totalSize;
+}
+function getAllFiles(dir, extension) {
+    const files = [];
+    if (!fs_1.default.existsSync(dir)) {
+        return files;
+    }
+    const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...getAllFiles(fullPath, extension));
+        }
+        else if (entry.isFile()) {
+            if (!extension || entry.name.endsWith(extension)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return files;
+}

package/dist/tests/test-prep-issue.js

@@ -57,7 +57,7 @@ async function verifyPrepIssueConfigParsing() {
             }
         };
         const output = runParsingLogic(nodeScript, validConfig);
-        assert_1.default.strictEqual(output, 'test-owner:test-repo:https://github.com/test-owner/test-repo.git');
+        assert_1.default.strictEqual(output, 'test-owner|test-repo|https://github.com/test-owner/test-repo.git|master');
         console.log('   ✅ Valid config parsed correctly');
         // 4. Test Missing Config
         assert_1.default.throws(() => {
@@ -69,6 +69,39 @@ async function verifyPrepIssueConfigParsing() {
             runParsingLogic(nodeScript, { repository: { owner: 'test-owner' } });
         }, /Script failed/);
         console.log('   ✅ Incomplete config correctly failed');
+        // 6. Test Default Branch Extraction (git schema)
+        const gitConfig = {
+            git: {
+                repoOwner: 'test-owner',
+                repoName: 'test-repo',
+                defaultBranch: 'master'
+            }
+        };
+        const gitOutput = runParsingLogic(nodeScript, gitConfig);
+        assert_1.default.strictEqual(gitOutput, 'test-owner|test-repo|https://github.com/test-owner/test-repo.git|master');
+        console.log('   ✅ Git config with defaultBranch parsed correctly');
+        // 7. Test Default Branch Extraction (repository schema)
+        const repoConfig = {
+            repository: {
+                owner: 'test-owner',
+                name: 'test-repo',
+                url: 'https://github.com/test-owner/test-repo.git',
+                defaultBranch: 'main'
+            }
+        };
+        const repoOutput = runParsingLogic(nodeScript, repoConfig);
+        assert_1.default.strictEqual(repoOutput, 'test-owner|test-repo|https://github.com/test-owner/test-repo.git|main');
+        console.log('   ✅ Repository config with defaultBranch parsed correctly');
+        // 8. Test Default Branch Fallback
+        const noDefaultConfig = {
+            git: {
+                repoOwner: 'test-owner',
+                repoName: 'test-repo'
+            }
+        };
+        const fallbackOutput = runParsingLogic(nodeScript, noDefaultConfig);
+        assert_1.default.strictEqual(fallbackOutput, 'test-owner|test-repo|https://github.com/test-owner/test-repo.git|master');
+        console.log('   ✅ Default branch fallback to master works correctly');
         return true;
     }
     catch (error) {

package/dist/tests/test-stub-registry.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env tsx
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const build_stub_registry_1 = require("../scripts/build-stub-registry");
+/**
+ * Tests for stub registry build process
+ * Ensures that the npm package contains only stubs and scripts, not full workflows
+ */
+(0, node_test_1.test)('Stub registry build generates correct structure', async () => {
+    // Clean up any existing stubs
+    const stubsPath = path_1.default.join(__dirname, '..', 'registry', 'stubs');
+    if (fs_1.default.existsSync(stubsPath)) {
+        fs_1.default.rmSync(stubsPath, { recursive: true, force: true });
+    }
+    // Build stub registry
+    await (0, build_stub_registry_1.buildStubRegistry)();
+    // Verify stubs directory exists
+    (0, node_assert_1.default)(fs_1.default.existsSync(stubsPath), 'Stubs directory should exist');
+    // Verify workflows stubs directory exists
+    const workflowsStubsPath = path_1.default.join(stubsPath, 'workflows');
+    (0, node_assert_1.default)(fs_1.default.existsSync(workflowsStubsPath), 'Workflows stubs directory should exist');
+    // Verify at least some stubs were generated
+    const stubFiles = getAllFiles(workflowsStubsPath, '.md');
+    (0, node_assert_1.default)(stubFiles.length > 0, 'Should generate at least one workflow stub');
+    console.log(`✅ Generated ${stubFiles.length} workflow stubs`);
+});
+(0, node_test_1.test)('Generated stubs are lightweight and contain correct format', async () => {
+    const stubsPath = path_1.default.join(__dirname, '..', 'registry', 'stubs', 'workflows');
+    // Find a stub file to test
+    const stubFiles = getAllFiles(stubsPath, '.md');
+    (0, node_assert_1.default)(stubFiles.length > 0, 'Should have stub files to test');
+    const testStubPath = stubFiles[0];
+    const stubContent = fs_1.default.readFileSync(testStubPath, 'utf8');
+    // Verify stub format
+    (0, node_assert_1.default)(stubContent.includes('# FRAIM Workflow:'), 'Stub should have workflow title');
+    (0, node_assert_1.default)(stubContent.includes('FRAIM-managed workflow stub'), 'Stub should identify itself as a stub');
+    (0, node_assert_1.default)(stubContent.includes('get_fraim_workflow('), 'Stub should contain MCP call instruction');
+    (0, node_assert_1.default)(stubContent.includes('## Intent'), 'Stub should contain intent section');
+    (0, node_assert_1.default)(stubContent.includes('DO NOT EXECUTE'), 'Stub should contain execution warning');
+    // Verify stub is lightweight (should be much smaller than full workflow)
+    const stubLines = stubContent.split('\n').length;
+    (0, node_assert_1.default)(stubLines < 20, `Stub should be lightweight (${stubLines} lines), not a full workflow`);
+    console.log(`✅ Stub format verified (${stubLines} lines)`);
+});
+(0, node_test_1.test)('Stubs do not contain full workflow content', async () => {
+    const stubsPath = path_1.default.join(__dirname, '..', 'registry', 'stubs', 'workflows');
+    const fullWorkflowsPath = path_1.default.join(__dirname, '..', 'registry', 'workflows');
+    const stubFiles = getAllFiles(stubsPath, '.md');
+    (0, node_assert_1.default)(stubFiles.length > 0, 'Should have stub files to test');
+    for (const stubFile of stubFiles.slice(0, 3)) { // Test first 3 stubs
+        const stubContent = fs_1.default.readFileSync(stubFile, 'utf8');
+        // Find corresponding full workflow
+        const relativePath = path_1.default.relative(stubsPath, stubFile);
+        const fullWorkflowPath = path_1.default.join(fullWorkflowsPath, relativePath);
+        if (fs_1.default.existsSync(fullWorkflowPath)) {
+            const fullContent = fs_1.default.readFileSync(fullWorkflowPath, 'utf8');
+            // Stub should be much smaller than full workflow
+            (0, node_assert_1.default)(stubContent.length < fullContent.length * 0.5, `Stub should be <50% size of full workflow (stub: ${stubContent.length}, full: ${fullContent.length})`);
+            // More importantly, stub should not contain full workflow sections
+            (0, node_assert_1.default)(!stubContent.includes('## WORKFLOW TRIGGER'), 'Stub should not contain WORKFLOW TRIGGER section');
+            (0, node_assert_1.default)(!stubContent.includes('## AI AGENT PROCESS'), 'Stub should not contain AI AGENT PROCESS section');
+            (0, node_assert_1.default)(!stubContent.includes('## EXAMPLES'), 'Stub should not contain EXAMPLES section');
+        }
+    }
+    console.log('✅ Stubs are properly lightweight');
+});
+(0, node_test_1.test)('Package.json files array excludes full workflows', () => {
+    const packageJsonPath = path_1.default.join(__dirname, '..', 'package.json');
+    const packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, 'utf8'));
+    const files = packageJson.files || [];
+    // Should include stubs
+    (0, node_assert_1.default)(files.includes('registry/stubs/'), 'Should include registry/stubs/');
+    // Should include scripts
+    (0, node_assert_1.default)(files.includes('registry/scripts/'), 'Should include registry/scripts/');
+    // Should NOT include full registry
+    (0, node_assert_1.default)(!files.includes('registry/'), 'Should NOT include full registry/');
+    (0, node_assert_1.default)(!files.includes('registry/workflows/'), 'Should NOT include registry/workflows/');
+    (0, node_assert_1.default)(!files.includes('registry/templates/'), 'Should NOT include registry/templates/');
+    (0, node_assert_1.default)(!files.includes('registry/rules/'), 'Should NOT include registry/rules/');
+    console.log('✅ Package.json correctly excludes full workflows');
+});
+(0, node_test_1.test)('Scripts are still included in package', () => {
+    const scriptsPath = path_1.default.join(__dirname, '..', 'registry', 'scripts');
+    (0, node_assert_1.default)(fs_1.default.existsSync(scriptsPath), 'Scripts directory should exist');
+    const scriptFiles = getAllFiles(scriptsPath);
+    (0, node_assert_1.default)(scriptFiles.length > 0, 'Should have script files');
+    // Verify package.json includes scripts
+    const packageJsonPath = path_1.default.join(__dirname, '..', 'package.json');
+    const packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, 'utf8'));
+    const files = packageJson.files || [];
+    (0, node_assert_1.default)(files.includes('registry/scripts/'), 'Package should include scripts');
+    console.log(`✅ ${scriptFiles.length} scripts are included in package`);
+});
+// Helper function to get all files recursively
+function getAllFiles(dir, extension) {
+    const files = [];
+    if (!fs_1.default.existsSync(dir)) {
+        return files;
+    }
+    const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...getAllFiles(fullPath, extension));
+        }
+        else if (entry.isFile()) {
+            if (!extension || entry.name.endsWith(extension)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return files;
+}

package/dist/tests/test-sync-stubs.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env tsx
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const sync_1 = require("../src/cli/commands/sync");
+/**
+ * Tests for sync command with stub registry
+ * Ensures sync works correctly with pre-generated stubs
+ */
+// Use a temporary directory for testing
+const TEST_PROJECT_DIR = path_1.default.join(os_1.default.tmpdir(), 'fraim-test-sync-' + Date.now());
+const TEST_FRAIM_DIR = path_1.default.join(TEST_PROJECT_DIR, '.fraim');
+const TEST_WORKFLOWS_DIR = path_1.default.join(TEST_FRAIM_DIR, 'workflows');
+(0, node_test_1.test)('Sync command works with stub registry', async () => {
+    // Setup test environment
+    setupTestProject();
+    // Change to test directory
+    const originalCwd = process.cwd();
+    process.chdir(TEST_PROJECT_DIR);
+    try {
+        // Run sync
+        await (0, sync_1.runSync)({ force: true });
+        // Verify workflows directory was created
+        (0, node_assert_1.default)(fs_1.default.existsSync(TEST_WORKFLOWS_DIR), 'Workflows directory should be created');
+        // Verify stubs were copied
+        const stubFiles = getAllFiles(TEST_WORKFLOWS_DIR, '.md');
+        (0, node_assert_1.default)(stubFiles.length > 0, 'Should copy workflow stubs');
+        // Verify stubs have correct format
+        const testStub = fs_1.default.readFileSync(stubFiles[0], 'utf8');
+        (0, node_assert_1.default)(testStub.includes('FRAIM-managed workflow stub'), 'Copied files should be stubs');
+        (0, node_assert_1.default)(testStub.includes('get_fraim_workflow('), 'Stubs should contain MCP call instruction');
+        console.log(`✅ Sync copied ${stubFiles.length} workflow stubs`);
+    }
+    finally {
+        // Restore original directory
+        process.chdir(originalCwd);
+        // Cleanup test directory
+        if (fs_1.default.existsSync(TEST_PROJECT_DIR)) {
+            fs_1.default.rmSync(TEST_PROJECT_DIR, { recursive: true, force: true });
+        }
+    }
+});
+(0, node_test_1.test)('Sync uses stub registry, not full workflows', async () => {
+    // Setup test environment
+    setupTestProject();
+    const originalCwd = process.cwd();
+    process.chdir(TEST_PROJECT_DIR);
+    try {
+        // Run sync
+        await (0, sync_1.runSync)({ force: true });
+        // Verify synced files are stubs, not full workflows
+        const stubFiles = getAllFiles(TEST_WORKFLOWS_DIR, '.md');
+        (0, node_assert_1.default)(stubFiles.length > 0, 'Should have synced files');
+        for (const stubFile of stubFiles.slice(0, 3)) { // Test first 3 files
+            const content = fs_1.default.readFileSync(stubFile, 'utf8');
+            const lines = content.split('\n').length;
+            // Should be lightweight stubs
+            (0, node_assert_1.default)(lines < 20, `File should be a stub (${lines} lines), not a full workflow`);
+            (0, node_assert_1.default)(content.includes('DO NOT EXECUTE'), 'Should contain stub warning');
+            (0, node_assert_1.default)(!content.includes('## WORKFLOW TRIGGER'), 'Should not contain full workflow sections');
+            (0, node_assert_1.default)(!content.includes('## AI AGENT PROCESS'), 'Should not contain full workflow sections');
+        }
+        console.log('✅ Sync correctly uses stubs, not full workflows');
+    }
+    finally {
+        process.chdir(originalCwd);
+        if (fs_1.default.existsSync(TEST_PROJECT_DIR)) {
+            fs_1.default.rmSync(TEST_PROJECT_DIR, { recursive: true, force: true });
+        }
+    }
+});
+(0, node_test_1.test)('Sync preserves directory structure from stub registry', async () => {
+    setupTestProject();
+    const originalCwd = process.cwd();
+    process.chdir(TEST_PROJECT_DIR);
+    try {
+        await (0, sync_1.runSync)({ force: true });
+        // Verify directory structure is preserved
+        const expectedDirs = [
+            'bootstrap',
+            'product-building',
+            'customer-development',
+            'marketing'
+        ];
+        for (const expectedDir of expectedDirs) {
+            const dirPath = path_1.default.join(TEST_WORKFLOWS_DIR, expectedDir);
+            if (fs_1.default.existsSync(dirPath)) {
+                (0, node_assert_1.default)(fs_1.default.statSync(dirPath).isDirectory(), `${expectedDir} should be a directory`);
+                // Should contain stub files
+                const files = fs_1.default.readdirSync(dirPath).filter(f => f.endsWith('.md'));
+                (0, node_assert_1.default)(files.length > 0, `${expectedDir} should contain workflow stubs`);
+            }
+        }
+        console.log('✅ Directory structure preserved correctly');
+    }
+    finally {
+        process.chdir(originalCwd);
+        if (fs_1.default.existsSync(TEST_PROJECT_DIR)) {
+            fs_1.default.rmSync(TEST_PROJECT_DIR, { recursive: true, force: true });
+        }
+    }
+});
+function setupTestProject() {
+    // Create test project directory
+    if (fs_1.default.existsSync(TEST_PROJECT_DIR)) {
+        fs_1.default.rmSync(TEST_PROJECT_DIR, { recursive: true, force: true });
+    }
+    fs_1.default.mkdirSync(TEST_PROJECT_DIR, { recursive: true });
+    // Create .fraim directory
+    fs_1.default.mkdirSync(TEST_FRAIM_DIR, { recursive: true });
+    // Create basic config.json
+    const config = {
+        version: "2.0.36",
+        customizations: {}
+    };
+    fs_1.default.writeFileSync(path_1.default.join(TEST_FRAIM_DIR, 'config.json'), JSON.stringify(config, null, 2));
+}
+function getAllFiles(dir, extension) {
+    const files = [];
+    if (!fs_1.default.existsSync(dir)) {
+        return files;
+    }
+    const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...getAllFiles(fullPath, extension));
+        }
+        else if (entry.isFile()) {
+            if (!extension || entry.name.endsWith(extension)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    return files;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.36",
+  "version": "2.0.37",
   "description": "FRAIM v2: Framework for Rigor-based AI Management - Transform from solo developer to AI manager orchestrating production-ready code with enterprise-grade discipline",
   "main": "index.js",
   "bin": {
@@ -10,7 +10,8 @@
   "scripts": {
     "setup": "node setup.js",
     "dev": "tsx --watch src/fraim-mcp-server.ts",
-    "build": "tsc && npm run validate:registry",
+    "build": "tsc && npm run build:stubs && npm run validate:registry",
+    "build:stubs": "tsx scripts/build-stub-registry.ts",
     "test": "tsx --test > test.log 2>&1",
     "start:fraim": "tsx src/fraim-mcp-server.ts",
     "dev:fraim": "tsx --watch src/fraim-mcp-server.ts",
@@ -21,7 +22,7 @@
     "postinstall": "fraim sync || echo 'FRAIM setup skipped.'",
     "prepublishOnly": "npm run build",
     "release": "npm version patch && npm publish",
-    "test-smoke-ci": "tsx --test tests/test-genericization.ts tests/test-cli.ts",
+    "test-smoke-ci": "tsx --test tests/test-genericization.ts tests/test-cli.ts tests/test-stub-registry.ts tests/test-sync-stubs.ts",
     "test-all-ci": "tsx --test tests/test-*.ts",
     "validate:registry": "tsx scripts/verify-registry-paths.ts"
   },
@@ -67,11 +68,8 @@
   },
   "files": [
     "dist/",
-    "registry/",
-    ".cursor/",
-    ".windsurf/",
-    ".github/",
-    "examples/",
+    "registry/stubs/",
+    "registry/scripts/",
     "bin/",
     "*.js",
     "*.ts",