fraim-framework 2.0.72 → 2.0.73

package/dist/src/cli/commands/list-overridable.js

@@ -10,7 +10,9 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 exports.listOverridableCommand = new commander_1.Command('list-overridable')
     .description('List all FRAIM registry paths that can be overridden')
-    .action(async () => {
+    .option('--job-category <category>', 'Filter by workflow category (e.g., product-building, customer-development, marketing)')
+    .option('--rules', 'Show all overridable rules')
+    .action(async (options) => {
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
     const configPath = path_1.default.join(fraimDir, 'config.json');
@@ -20,35 +22,24 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
         console.log(chalk_1.default.red('❌ .fraim/ directory not found. Run "fraim setup" or "fraim init-project" first.'));
         process.exit(1);
     }
-    console.log(chalk_1.default.blue('📋 Overridable FRAIM Registry Paths:\n'));
-    // Define overridable categories
-    const categories = [
-        {
-            name: 'Workflows',
-            paths: [
-                'workflows/product-building/spec.md',
-                'workflows/product-building/design.md',
-                'workflows/product-building/implement.md',
-                'workflows/product-building/test.md',
-                'workflows/product-building/resolve.md',
-                'workflows/product-building/prep-issue.md'
-            ]
-        },
-        {
-            name: 'Templates',
-            paths: [
-                'templates/specs/FEATURESPEC-TEMPLATE.md',
-                'templates/design/DESIGN-TEMPLATE.md'
-            ]
-        },
-        {
-            name: 'Rules',
-            paths: [
-                'rules/coding-standards.md',
-                'rules/communication.md'
-            ]
+    // Determine registry location (try framework root first, then node_modules)
+    let registryRoot = null;
+    const frameworkRoot = path_1.default.join(__dirname, '..', '..', '..');
+    const frameworkRegistry = path_1.default.join(frameworkRoot, 'registry');
+    if (fs_1.default.existsSync(frameworkRegistry)) {
+        registryRoot = frameworkRegistry;
+    }
+    else {
+        const nodeModulesRegistry = path_1.default.join(process.cwd(), 'node_modules', '@fraim', 'framework', 'registry');
+        if (fs_1.default.existsSync(nodeModulesRegistry)) {
+            registryRoot = nodeModulesRegistry;
         }
-    ];
+    }
+    if (!registryRoot) {
+        console.log(chalk_1.default.red('❌ Could not find FRAIM registry. Please ensure @fraim/framework is installed.'));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.blue('📋 Overridable FRAIM Registry Paths:\n'));
     // Get list of existing overrides
     const existingOverrides = new Set();
     if (fs_1.default.existsSync(overridesDir)) {
@@ -66,10 +57,50 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
         };
         scanDir(overridesDir);
     }
-    // Display categories
-    for (const category of categories) {
-        console.log(chalk_1.default.bold.cyan(`${category.name}:`));
-        for (const filePath of category.paths) {
+    // Handle --rules flag
+    if (options.rules) {
+        const rulesDir = path_1.default.join(registryRoot, 'rules');
+        if (fs_1.default.existsSync(rulesDir)) {
+            console.log(chalk_1.default.bold.cyan('Rules:\n'));
+            const ruleFiles = fs_1.default.readdirSync(rulesDir)
+                .filter(f => f.endsWith('.md'))
+                .sort();
+            for (const file of ruleFiles) {
+                const filePath = `rules/${file}`;
+                const hasOverride = existingOverrides.has(filePath);
+                const status = hasOverride
+                    ? chalk_1.default.green('[OVERRIDDEN]')
+                    : chalk_1.default.gray('[OVERRIDABLE]');
+                console.log(`  ${status} ${filePath}`);
+            }
+            console.log('');
+        }
+        showTips();
+        return;
+    }
+    // Handle --job-category flag
+    if (options.jobCategory) {
+        const category = options.jobCategory;
+        const workflowsDir = path_1.default.join(registryRoot, 'workflows', category);
+        const templatesDir = path_1.default.join(registryRoot, 'templates', category);
+        if (!fs_1.default.existsSync(workflowsDir)) {
+            console.log(chalk_1.default.red(`❌ Category "${category}" not found.`));
+            console.log(chalk_1.default.gray('\nAvailable categories:'));
+            const categoriesDir = path_1.default.join(registryRoot, 'workflows');
+            const categories = fs_1.default.readdirSync(categoriesDir, { withFileTypes: true })
+                .filter(d => d.isDirectory())
+                .map(d => d.name)
+                .sort();
+            categories.forEach(c => console.log(chalk_1.default.gray(`  - ${c}`)));
+            process.exit(1);
+        }
+        // Show workflows for this category
+        console.log(chalk_1.default.bold.cyan(`Workflows (${category}):\n`));
+        const workflowFiles = fs_1.default.readdirSync(workflowsDir)
+            .filter(f => f.endsWith('.md'))
+            .sort();
+        for (const file of workflowFiles) {
+            const filePath = `workflows/${category}/${file}`;
             const hasOverride = existingOverrides.has(filePath);
             const status = hasOverride
                 ? chalk_1.default.green('[OVERRIDDEN]')
@@ -77,21 +108,95 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
             console.log(`  ${status} ${filePath}`);
         }
         console.log('');
+        // Show templates for this category (if they exist)
+        if (fs_1.default.existsSync(templatesDir)) {
+            console.log(chalk_1.default.bold.cyan(`Templates (${category}):\n`));
+            const templateFiles = fs_1.default.readdirSync(templatesDir)
+                .filter(f => f.endsWith('.md') || f.endsWith('.html') || f.endsWith('.csv') || f.endsWith('.yml'))
+                .sort();
+            for (const file of templateFiles) {
+                const filePath = `templates/${category}/${file}`;
+                const hasOverride = existingOverrides.has(filePath);
+                const status = hasOverride
+                    ? chalk_1.default.green('[OVERRIDDEN]')
+                    : chalk_1.default.gray('[OVERRIDABLE]');
+                console.log(`  ${status} ${filePath}`);
+            }
+            console.log('');
+        }
+        showTips();
+        return;
+    }
+    // Default: Show available categories and existing overrides
+    console.log(chalk_1.default.bold.cyan('Available Workflow Categories:\n'));
+    const workflowsDir = path_1.default.join(registryRoot, 'workflows');
+    const categories = fs_1.default.readdirSync(workflowsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => d.name)
+        .sort();
+    // Group categories for better display
+    const columns = 3;
+    for (let i = 0; i < categories.length; i += columns) {
+        const row = categories.slice(i, i + columns);
+        const formatted = row.map(cat => chalk_1.default.gray(`  • ${cat.padEnd(30)}`)).join('');
+        console.log(formatted);
     }
-    // Show existing overrides not in the standard list
-    const standardPaths = new Set(categories.flatMap(c => c.paths));
-    const customOverrides = Array.from(existingOverrides)
-        .filter(p => !standardPaths.has(p));
-    if (customOverrides.length > 0) {
-        console.log(chalk_1.default.bold.cyan('Custom Overrides:'));
-        for (const filePath of customOverrides) {
-            console.log(`  ${chalk_1.default.green('[OVERRIDDEN]')} ${filePath}`);
+    console.log('');
+    // Show existing overrides
+    if (existingOverrides.size > 0) {
+        console.log(chalk_1.default.bold.cyan('Your Active Overrides:\n'));
+        // Group by type
+        const overridesByType = {
+            workflows: [],
+            templates: [],
+            rules: [],
+            other: []
+        };
+        for (const override of Array.from(existingOverrides).sort()) {
+            if (override.startsWith('workflows/')) {
+                overridesByType.workflows.push(override);
+            }
+            else if (override.startsWith('templates/')) {
+                overridesByType.templates.push(override);
+            }
+            else if (override.startsWith('rules/')) {
+                overridesByType.rules.push(override);
+            }
+            else {
+                overridesByType.other.push(override);
+            }
         }
-        console.log('');
+        if (overridesByType.workflows.length > 0) {
+            console.log(chalk_1.default.gray('  Workflows:'));
+            overridesByType.workflows.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+        if (overridesByType.templates.length > 0) {
+            console.log(chalk_1.default.gray('  Templates:'));
+            overridesByType.templates.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+        if (overridesByType.rules.length > 0) {
+            console.log(chalk_1.default.gray('  Rules:'));
+            overridesByType.rules.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+        if (overridesByType.other.length > 0) {
+            console.log(chalk_1.default.gray('  Other:'));
+            overridesByType.other.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+            console.log('');
+        }
+    }
+    else {
+        console.log(chalk_1.default.gray('No active overrides yet.\n'));
+    }
+    showTips();
+    function showTips() {
+        console.log(chalk_1.default.gray('Tips:'));
+        console.log(chalk_1.default.gray('  • Use "fraim override <path> --inherit" to inherit from global'));
+        console.log(chalk_1.default.gray('  • Use "fraim override <path> --copy" to copy current content'));
+        console.log(chalk_1.default.gray('  • Use --job-category <category> to see category-specific items'));
+        console.log(chalk_1.default.gray('  • Use --rules to see all overridable rules'));
+        console.log(chalk_1.default.gray('  • Overrides are stored in .fraim/overrides/'));
     }
-    // Show tips
-    console.log(chalk_1.default.gray('Tips:'));
-    console.log(chalk_1.default.gray('  • Use "fraim override <path> --inherit" to inherit from global'));
-    console.log(chalk_1.default.gray('  • Use "fraim override <path> --copy" to copy current content'));
-    console.log(chalk_1.default.gray('  • Overrides are stored in .fraim/overrides/'));
 });

package/dist/src/cli/commands/override.js

@@ -9,11 +9,13 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const axios_1 = __importDefault(require("axios"));
+const git_utils_1 = require("../../core/utils/git-utils");
 exports.overrideCommand = new commander_1.Command('override')
     .description('Create a local override for a FRAIM registry file')
     .argument('<path>', 'Registry path to override (e.g., workflows/product-building/spec.md)')
     .option('--inherit', 'Create override with {{ import }} directive (inherits from global)')
-    .option('--copy', 'Copy current content from remote to local')
+    .option('--copy', 'Copy current content from server to local')
+    .option('--local', 'Fetch from local development server (port derived from git branch)')
     .action(async (registryPath, options) => {
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
@@ -56,48 +58,112 @@ exports.overrideCommand = new commander_1.Command('override')
         console.log(chalk_1.default.blue(`📝 Creating inherited override for: ${registryPath}`));
     }
     else {
-        // Fetch current content from remote
-        console.log(chalk_1.default.blue(`📥 Fetching current content from remote: ${registryPath}`));
+        // Fetch current content from server using MCP protocol
+        const isLocal = options.local || false;
+        const serverType = isLocal ? 'local server' : 'remote server';
+        console.log(chalk_1.default.blue(`📥 Fetching current content from ${serverType}: ${registryPath}`));
         try {
             // Read config to get remote URL
             let config = {};
             if (fs_1.default.existsSync(configPath)) {
                 config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
             }
-            const remoteUrl = config.remoteUrl || 'https://fraim-registry.azurewebsites.net';
-            const apiKey = config.apiKey;
-            // Determine endpoint based on path
-            let endpoint;
-            if (registryPath.startsWith('workflows/')) {
-                const workflowName = registryPath.replace('workflows/', '').replace('.md', '');
-                endpoint = `${remoteUrl}/api/workflows/${workflowName}`;
+            // Determine server URL
+            let serverUrl;
+            if (isLocal) {
+                const localPort = process.env.FRAIM_MCP_PORT ? parseInt(process.env.FRAIM_MCP_PORT) : (0, git_utils_1.getPort)();
+                serverUrl = `http://localhost:${localPort}`;
             }
             else {
-                endpoint = `${remoteUrl}/api/files/${registryPath}`;
+                serverUrl = config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
             }
-            const headers = {};
+            const apiKey = isLocal ? 'local-dev' : (config.apiKey || process.env.FRAIM_API_KEY);
+            const headers = {
+                'Content-Type': 'application/json'
+            };
             if (apiKey) {
                 headers['x-api-key'] = apiKey;
             }
-            const response = await axios_1.default.get(endpoint, {
+            // First, establish session with fraim_connect
+            const connectRequest = {
+                jsonrpc: '2.0',
+                id: 0,
+                method: 'tools/call',
+                params: {
+                    name: 'fraim_connect',
+                    arguments: {
+                        agent: { name: 'fraim-cli', model: 'override-command' },
+                        machine: {
+                            hostname: require('os').hostname(),
+                            platform: process.platform,
+                            memory: require('os').totalmem(),
+                            cpus: require('os').cpus().length
+                        },
+                        repo: {
+                            url: config.repository?.url || 'https://github.com/unknown/unknown',
+                            owner: config.repository?.owner || 'unknown',
+                            name: config.repository?.name || 'unknown',
+                            branch: 'main'
+                        }
+                    }
+                }
+            };
+            await axios_1.default.post(`${serverUrl}/mcp`, connectRequest, { headers, timeout: 30000 });
+            // Now determine MCP tool and arguments based on path
+            let toolName;
+            let toolArgs;
+            if (registryPath.startsWith('workflows/')) {
+                // Extract workflow name from path
+                // e.g., "workflows/product-building/spec.md" -> "spec"
+                const parts = registryPath.split('/');
+                const workflowName = parts[parts.length - 1].replace('.md', '');
+                toolName = 'get_fraim_workflow';
+                toolArgs = { workflow: workflowName };
+            }
+            else {
+                toolName = 'get_fraim_file';
+                toolArgs = { path: registryPath };
+            }
+            console.log(chalk_1.default.gray(`   Using MCP tool: ${toolName}`));
+            // Make MCP JSON-RPC request
+            const mcpRequest = {
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'tools/call',
+                params: {
+                    name: toolName,
+                    arguments: toolArgs
+                }
+            };
+            const response = await axios_1.default.post(`${serverUrl}/mcp`, mcpRequest, {
                 headers,
                 timeout: 30000
             });
-            // Extract content from response
-            if (response.data.content) {
-                content = response.data.content;
+            // Extract content from MCP response
+            if (response.data.error) {
+                throw new Error(response.data.error.message || 'MCP request failed');
             }
-            else if (typeof response.data === 'string') {
-                content = response.data;
+            const result = response.data.result;
+            if (!result || !result.content || !Array.isArray(result.content)) {
+                throw new Error('Unexpected MCP response format');
             }
-            else {
-                throw new Error('Unexpected response format');
+            // Extract text content from MCP response
+            const textContent = result.content.find((c) => c.type === 'text');
+            if (!textContent || !textContent.text) {
+                throw new Error('No text content in MCP response');
             }
-            console.log(chalk_1.default.green(`✅ Fetched ${content.length} bytes from remote`));
+            content = textContent.text;
+            console.log(chalk_1.default.green(`✅ Fetched ${content.length} bytes from ${serverType}`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`❌ Failed to fetch content from remote: ${error.message}`));
-            console.log(chalk_1.default.gray('   Tip: Check your network connection and .fraim/config.json settings'));
+            console.log(chalk_1.default.red(`❌ Failed to fetch content from ${serverType}: ${error.message}`));
+            if (isLocal) {
+                console.log(chalk_1.default.gray(`   Tip: Make sure the FRAIM server is running locally (npm run start:fraim)`));
+            }
+            else {
+                console.log(chalk_1.default.gray(`   Tip: Check your API key and network connection`));
+                console.log(chalk_1.default.gray(`   Or use --local to fetch from a locally running server`));
+            }
             process.exit(1);
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.72",
+  "version": "2.0.73",
   "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": {