fraim-framework 2.0.68 → 2.0.69

package/dist/src/local-mcp-server/stdio-server.js

@@ -18,13 +18,157 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FraimLocalMCPServer = void 0;
+exports.FraimLocalMCPServer = exports.FraimTemplateEngine = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const os_1 = require("os");
 const child_process_1 = require("child_process");
 const crypto_1 = require("crypto");
 const axios_1 = __importDefault(require("axios"));
+const provider_utils_1 = require("../utils/provider-utils");
+const object_utils_1 = require("../utils/object-utils");
+/**
+ * Handle template substitution logic separately for better testability
+ */
+class FraimTemplateEngine {
+    constructor(opts) {
+        this.deliveryTemplatesCache = null;
+        this.providerTemplatesCache = {};
+        this.config = opts.config;
+        this.repoInfo = opts.repoInfo;
+        this.workingStyle = opts.workingStyle;
+        this.projectRoot = opts.projectRoot;
+        this.logFn = opts.logFn || (() => { });
+    }
+    substituteTemplates(content) {
+        let result = content;
+        // First, substitute config variables with fallback support
+        if (this.config) {
+            result = result.replace(/\{\{config\.([^}|]+)(?:\s*\|\s*"([^"]+)")?\}\}/g, (match, path, fallback) => {
+                try {
+                    const value = (0, object_utils_1.getNestedValue)(this.config, path.trim());
+                    if (value !== undefined) {
+                        return typeof value === 'object'
+                            ? JSON.stringify(value)
+                            : String(value);
+                    }
+                    if (fallback !== undefined) {
+                        return fallback;
+                    }
+                    return match;
+                }
+                catch (error) {
+                    return fallback !== undefined ? fallback : match;
+                }
+            });
+        }
+        // Second, substitute {{delivery.*}} templates
+        const deliveryValues = this.loadDeliveryTemplates();
+        if (deliveryValues) {
+            result = result.replace(/\{\{delivery\.([^}]+)\}\}/g, (match, key) => {
+                const value = deliveryValues[`delivery.${key.trim()}`];
+                return value !== undefined ? value : match;
+            });
+        }
+        // Third, substitute platform-specific action templates
+        result = this.substitutePlatformActions(result);
+        return result;
+    }
+    loadDeliveryTemplates() {
+        if (this.deliveryTemplatesCache)
+            return this.deliveryTemplatesCache;
+        const filename = this.workingStyle === 'Conversation' ? 'delivery-conversation.json' : 'delivery-pr.json';
+        try {
+            let content = null;
+            if (this.projectRoot) {
+                const deliveryPath = (0, path_1.join)(this.projectRoot, 'registry', 'providers', filename);
+                if ((0, fs_1.existsSync)(deliveryPath)) {
+                    content = (0, fs_1.readFileSync)(deliveryPath, 'utf-8');
+                }
+            }
+            if (!content) {
+                const nodeModulesPath = (0, path_1.join)(process.cwd(), 'node_modules', '@fraim', 'framework', 'registry', 'providers', filename);
+                if ((0, fs_1.existsSync)(nodeModulesPath)) {
+                    content = (0, fs_1.readFileSync)(nodeModulesPath, 'utf-8');
+                }
+            }
+            if (content) {
+                this.deliveryTemplatesCache = JSON.parse(content);
+                return this.deliveryTemplatesCache;
+            }
+            return null;
+        }
+        catch (error) {
+            this.logFn(`⚠️ Failed to load delivery templates: ${error.message}`);
+            return null;
+        }
+    }
+    substitutePlatformActions(content) {
+        const provider = (0, provider_utils_1.detectProvider)(this.repoInfo?.url);
+        const templates = this.loadProviderTemplates(provider);
+        if (!templates)
+            return content;
+        let result = content;
+        for (const [action, template] of Object.entries(templates)) {
+            const regex = new RegExp(`\\{\\{${action}\\}\\}`, 'g');
+            const renderedTemplate = this.renderActionTemplate(template);
+            result = result.replace(regex, renderedTemplate);
+        }
+        return result;
+    }
+    loadProviderTemplates(provider) {
+        if (this.providerTemplatesCache[provider])
+            return this.providerTemplatesCache[provider];
+        try {
+            let content = null;
+            if (this.projectRoot) {
+                const providerPath = (0, path_1.join)(this.projectRoot, 'registry', 'providers', `${provider}.json`);
+                if ((0, fs_1.existsSync)(providerPath)) {
+                    content = (0, fs_1.readFileSync)(providerPath, 'utf-8');
+                }
+            }
+            if (!content) {
+                const nodeModulesPath = (0, path_1.join)(process.cwd(), 'node_modules', '@fraim', 'framework', 'registry', 'providers', `${provider}.json`);
+                if ((0, fs_1.existsSync)(nodeModulesPath)) {
+                    content = (0, fs_1.readFileSync)(nodeModulesPath, 'utf-8');
+                }
+            }
+            if (content) {
+                const templates = JSON.parse(content);
+                this.providerTemplatesCache[provider] = templates;
+                return templates;
+            }
+            return null;
+        }
+        catch (error) {
+            this.logFn(`⚠️ Failed to load provider templates: ${error.message}`);
+            return null;
+        }
+    }
+    renderActionTemplate(template) {
+        if (!this.repoInfo && !this.config?.repository) {
+            return template;
+        }
+        return template.replace(/\{\{([^}]+)\}\}/g, (match, path) => {
+            const trimmedPath = path.trim();
+            if (trimmedPath.startsWith('repository.')) {
+                const repoPath = trimmedPath.substring('repository.'.length);
+                if (this.repoInfo) {
+                    const value = (0, object_utils_1.getNestedValue)(this.repoInfo, repoPath);
+                    if (value !== undefined)
+                        return String(value);
+                }
+                if (this.config?.repository) {
+                    const value = (0, object_utils_1.getNestedValue)(this.config.repository, repoPath);
+                    if (value !== undefined)
+                        return String(value);
+                }
+            }
+            return match;
+        });
+    }
+}
+exports.FraimTemplateEngine = FraimTemplateEngine;
 class FraimLocalMCPServer {
     constructor() {
         this.config = null;
@@ -33,6 +177,7 @@ class FraimLocalMCPServer {
         this.pendingRootsRequest = false;
         this.machineInfo = null;
         this.repoInfo = null;
+        this.engine = null;
         this.remoteUrl = process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
         this.apiKey = process.env.FRAIM_API_KEY || '';
         this.localVersion = this.detectLocalVersion();
@@ -40,7 +185,7 @@ class FraimLocalMCPServer {
             this.logError('❌ FRAIM_API_KEY environment variable is required');
             process.exit(1);
         }
-        this.log('🚀 FRAIM Local MCP Server starting...');
+        this.log('🚀 FRAIM Local MCP Server starting... [DEBUG-PROXY-V3]');
         this.log(`📡 Remote server: ${this.remoteUrl}`);
         this.log(`🔑 API key: ${this.apiKey.substring(0, 10)}...`);
         this.log(`Local MCP version: ${this.localVersion}`);
@@ -307,183 +452,17 @@ class FraimLocalMCPServer {
         }
         return 'PR';
     }
-    /**
-     * Substitute template variables in content
-     * Supports:
-     * 1. {{config.path.to.value}} - Config substitution
-     * 2. {{config.path.to.value | "fallback instruction"}} - With fallback
-     * 3. {{delivery.*}} - Working-style-specific delivery templates (from registry/providers/delivery-*.json)
-     * 4. Platform-specific action templates (GitHub vs ADO, from registry/providers/*.json)
-     */
     substituteTemplates(content) {
-        let result = content;
-        // First, substitute config variables with fallback support (only if config exists)
-        if (this.config) {
-            result = result.replace(/\{\{config\.([^}|]+)(?:\s*\|\s*"([^"]+)")?\}\}/g, (match, path, fallback) => {
-                try {
-                    const value = this.getNestedValue(this.config, path.trim());
-                    if (value !== undefined) {
-                        // Config value exists - substitute it
-                        return typeof value === 'object'
-                            ? JSON.stringify(value)
-                            : String(value);
-                    }
-                    if (fallback !== undefined) {
-                        // Config value missing - use fallback instruction
-                        return fallback;
-                    }
-                    // No fallback provided - keep placeholder
-                    return match;
-                }
-                catch (error) {
-                    // On error, use fallback if provided, otherwise keep placeholder
-                    return fallback !== undefined ? fallback : match;
-                }
-            });
-        }
-        // Second, substitute {{delivery.*}} templates based on workingStyle
-        // Loaded from registry/providers/delivery-{mode}.json (same pattern as platform templates)
-        const deliveryValues = this.loadDeliveryTemplates();
-        if (deliveryValues) {
-            result = result.replace(/\{\{delivery\.([^}]+)\}\}/g, (match, key) => {
-                const value = deliveryValues[`delivery.${key.trim()}`];
-                return value !== undefined ? value : match;
+        if (!this.engine) {
+            this.engine = new FraimTemplateEngine({
+                config: this.config,
+                repoInfo: this.detectRepoInfo(),
+                workingStyle: this.getWorkingStyle(),
+                projectRoot: this.findProjectRoot(),
+                logFn: (msg) => this.log(msg)
             });
         }
-        // Third, substitute platform-specific action templates
-        // This works independently of config - only needs repo info
-        result = this.substitutePlatformActions(result);
-        return result;
-    }
-    /**
-     * Load delivery templates from registry based on workingStyle.
-     * Follows the same pattern as loadProviderTemplates (registry/providers/*.json).
-     */
-    loadDeliveryTemplates() {
-        const workingStyle = this.getWorkingStyle();
-        const filename = workingStyle === 'Conversation' ? 'delivery-conversation.json' : 'delivery-pr.json';
-        try {
-            const projectRoot = this.findProjectRoot();
-            if (projectRoot) {
-                const deliveryPath = (0, path_1.join)(projectRoot, 'registry', 'providers', filename);
-                if ((0, fs_1.existsSync)(deliveryPath)) {
-                    return JSON.parse((0, fs_1.readFileSync)(deliveryPath, 'utf-8'));
-                }
-            }
-            // Fallback: Try node_modules/@fraim/framework
-            const nodeModulesPath = (0, path_1.join)(process.cwd(), 'node_modules', '@fraim', 'framework', 'registry', 'providers', filename);
-            if ((0, fs_1.existsSync)(nodeModulesPath)) {
-                return JSON.parse((0, fs_1.readFileSync)(nodeModulesPath, 'utf-8'));
-            }
-            this.log(`⚠️ Could not find delivery templates: ${filename}`);
-            return null;
-        }
-        catch (error) {
-            this.log(`⚠️ Failed to load delivery templates: ${error.message}`);
-            return null;
-        }
-    }
-    /**
-     * Substitute platform-specific action templates
-     * Replaces {{action}} with provider-specific MCP tool calls
-     */
-    substitutePlatformActions(content) {
-        // Detect provider from repo info
-        const provider = this.detectProvider();
-        // Load provider templates
-        const templates = this.loadProviderTemplates(provider);
-        if (!templates) {
-            return content; // No templates available, return unchanged
-        }
-        let result = content;
-        // Replace {{action}} with provider-specific implementations
-        for (const [action, template] of Object.entries(templates)) {
-            const regex = new RegExp(`\\{\\{${action}\\}\\}`, 'g');
-            // Substitute repository variables in the template
-            const renderedTemplate = this.renderActionTemplate(template, provider);
-            result = result.replace(regex, renderedTemplate);
-        }
-        return result;
-    }
-    /**
-     * Detect provider from repository info
-     */
-    detectProvider() {
-        if (!this.repoInfo) {
-            return 'github'; // Default
-        }
-        const url = this.repoInfo.url || '';
-        if (url.includes('dev.azure.com') || url.includes('visualstudio.com')) {
-            return 'ado';
-        }
-        // Check config for explicit provider
-        if (this.config?.repository?.provider) {
-            return this.config.repository.provider;
-        }
-        return 'github'; // Default
-    }
-    /**
-     * Load provider templates from registry
-     */
-    loadProviderTemplates(provider) {
-        try {
-            // Try to load from project root first
-            const projectRoot = this.findProjectRoot();
-            if (projectRoot) {
-                const providerPath = (0, path_1.join)(projectRoot, 'registry', 'providers', `${provider}.json`);
-                if ((0, fs_1.existsSync)(providerPath)) {
-                    return JSON.parse((0, fs_1.readFileSync)(providerPath, 'utf-8'));
-                }
-            }
-            // Fallback: Try to load from node_modules/@fraim/framework
-            const nodeModulesPath = (0, path_1.join)(process.cwd(), 'node_modules', '@fraim', 'framework', 'registry', 'providers', `${provider}.json`);
-            if ((0, fs_1.existsSync)(nodeModulesPath)) {
-                return JSON.parse((0, fs_1.readFileSync)(nodeModulesPath, 'utf-8'));
-            }
-            this.log(`⚠️ Could not find provider templates for: ${provider}`);
-            return null;
-        }
-        catch (error) {
-            this.log(`⚠️ Failed to load provider templates: ${error.message}`);
-            return null;
-        }
-    }
-    /**
-     * Render action template with repository variables
-     */
-    renderActionTemplate(template, provider) {
-        if (!this.repoInfo && !this.config?.repository) {
-            return template; // No repo info available
-        }
-        return template.replace(/\{\{([^}]+)\}\}/g, (match, path) => {
-            const trimmedPath = path.trim();
-            // Handle repository.* variables
-            if (trimmedPath.startsWith('repository.')) {
-                const repoPath = trimmedPath.substring('repository.'.length);
-                // Try repoInfo first (from git detection)
-                if (this.repoInfo) {
-                    const value = this.getNestedValue(this.repoInfo, repoPath);
-                    if (value !== undefined)
-                        return String(value);
-                }
-                // Fallback to config
-                if (this.config?.repository) {
-                    const value = this.getNestedValue(this.config.repository, repoPath);
-                    if (value !== undefined)
-                        return String(value);
-                }
-            }
-            // Keep original placeholder if not found
-            return match;
-        });
-    }
-    /**
-     * Get nested value from object using dot notation
-     */
-    getNestedValue(obj, path) {
-        return path.split('.').reduce((current, key) => {
-            return current && current[key] !== undefined ? current[key] : undefined;
-        }, obj);
+        return this.engine.substituteTemplates(content);
     }
     /**
      * Process template substitution in MCP response
@@ -595,14 +574,15 @@ class FraimLocalMCPServer {
             }
             return {
                 jsonrpc: '2.0',
-                id: request.id,
+                id: request.id || null,
                 error: {
-                    code: -32603,
-                    message: `Remote server error: ${error.message}`,
+                    code: status === 401 ? -32001 : -32603,
+                    message: `Remote server error (${status || 'unknown status'}): ${error.message}`,
                     data: {
                         fraimRequestId: requestId,
                         remoteStatus: status ?? null,
-                        localMcpVersion: this.localVersion
+                        localMcpVersion: this.localVersion,
+                        remoteError: remoteData
                     }
                 }
             };
@@ -741,6 +721,14 @@ class FraimLocalMCPServer {
                         }
                         else {
                             this.logError(`Unknown message type: ${JSON.stringify(message)}`);
+                            process.stdout.write(JSON.stringify({
+                                jsonrpc: '2.0',
+                                error: {
+                                    code: -32600,
+                                    message: 'Invalid Request: Unknown message type'
+                                },
+                                id: message.id || null
+                            }) + '\n');
                         }
                     }
                     catch (error) {
@@ -751,7 +739,8 @@ class FraimLocalMCPServer {
                             error: {
                                 code: -32700,
                                 message: `Parse error: ${error.message}`
-                            }
+                            },
+                            id: null
                         };
                         process.stdout.write(JSON.stringify(errorResponse) + '\n');
                     }

package/dist/src/utils/git-utils.js

@@ -8,7 +8,7 @@ exports.getDefaultBranch = getDefaultBranch;
 const child_process_1 = require("child_process");
 /**
  * Gets a unique port based on the current git branch name (if it's an issue branch)
- * Default to 15300 if not on an issue branch
+ * Default to 15302 if not on an issue branch
  */
 function getPort() {
     try {
@@ -24,7 +24,7 @@ function getPort() {
     catch (e) {
         // Silently fail and use default
     }
-    return Number(process.env.PORT) || Number(process.env.WEBSITES_PORT) || Number(process.env.FRAIM_MCP_PORT) || 15300;
+    return Number(process.env.PORT) || Number(process.env.WEBSITES_PORT) || Number(process.env.FRAIM_MCP_PORT) || 15302;
 }
 /**
  * Determines the database name based on the git branch

package/dist/src/utils/object-utils.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNestedValue = getNestedValue;
+/**
+ * Safely get a nested value from an object using a dot-path
+ */
+function getNestedValue(obj, path) {
+    if (!obj)
+        return undefined;
+    return path.split('.').reduce((current, key) => current && current[key] !== undefined ? current[key] : undefined, obj);
+}

package/dist/src/utils/provider-utils.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectProvider = detectProvider;
+/**
+ * Detect git provider from URL
+ */
+function detectProvider(url) {
+    if (!url)
+        return 'github';
+    if (url.includes('dev.azure.com') || url.includes('visualstudio.com')) {
+        return 'ado';
+    }
+    return 'github';
+}

package/dist/src/utils/request-utils.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_REGEX = void 0;
+exports.validateEmail = validateEmail;
+exports.getRequestMeta = getRequestMeta;
+/**
+ * Standard email validation regex
+ */
+exports.EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Validate an email address
+ */
+function validateEmail(email) {
+    return exports.EMAIL_REGEX.test(email);
+}
+/**
+ * Extract IP and UserAgent from an Express Request
+ */
+function getRequestMeta(req) {
+    const ip = req.headers['x-forwarded-for'] || req.ip || 'unknown';
+    const userAgent = req.headers['user-agent'] || 'unknown';
+    return { ip, userAgent };
+}

package/dist/src/utils/workflow-parser.js

@@ -87,6 +87,13 @@ class WorkflowParser {
             isSimple: true
         };
     }
+    /**
+     * Get just the overview for an agent starting a workflow
+     */
+    static getOverview(filePath) {
+        const wf = this.parse(filePath);
+        return wf ? wf.overview : null;
+    }
     /**
      * Extract description for listing workflows (intent or first para of overview)
      */
@@ -102,12 +109,5 @@ class WorkflowParser {
         const firstPara = wf.overview.split(/\r?\n/).find(l => l.trim() !== '' && !l.startsWith('#'));
         return firstPara ? firstPara.trim() : '';
     }
-    /**
-     * Get just the overview for an agent starting a workflow
-     */
-    static getOverview(filePath) {
-        const wf = this.parse(filePath);
-        return wf ? wf.overview : null;
-    }
 }
 exports.WorkflowParser = WorkflowParser;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.68",
+  "version": "2.0.69",
   "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,7 @@
   "scripts": {
     "dev": "tsx --watch src/fraim-mcp-server.ts > server.log 2>&1",
     "dev:prod": "npm run build && node dist/src/fraim-mcp-server.js > server.log 2>&1",
-    "build": "tsc && node scripts/copy-ai-manager-rules.js && npm run build:stubs && npm run validate:registry",
+    "build": "tsc && npm run build:stubs && node scripts/copy-ai-manager-rules.js && npm run validate:registry",
     "build:stubs": "tsx scripts/build-stub-registry.ts",
     "test": "node scripts/test-with-server.js",
     "start:fraim": "tsx src/fraim-mcp-server.ts",
@@ -20,11 +20,11 @@
     "manage-keys": "tsx scripts/fraim/manage-keys.ts",
     "view-signups": "tsx scripts/view-signups.ts",
     "fraim:init": "npm run build && node index.js init",
-    "fraim:sync": "node index.js sync",
+    "fraim:sync": "node index.js sync --local",
     "postinstall": "fraim sync --skip-updates || 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 tests/test-stub-registry.ts tests/test-sync-stubs.ts",
+    "test-smoke-ci": "tsx --test tests/test-genericization.ts tests/test-cli.ts tests/test-stub-registry.ts",
     "test-all-ci": "tsx --test tests/test-*.ts",
     "validate:registry": "tsx scripts/verify-registry-paths.ts && npm run validate:workflows && npm run validate:platform-agnostic",
     "validate:workflows": "tsx scripts/validate-workflows.ts",
@@ -67,6 +67,8 @@
     "@types/node": "^20.0.0",
     "@types/prompts": "^2.4.9",
     "fast-glob": "^3.3.3",
+    "pptxgenjs": "^4.0.1",
+    "qrcode": "^1.5.4",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
   },
@@ -93,6 +95,7 @@
     "cors": "^2.8.5",
     "dotenv": "^16.4.7",
     "express": "^5.2.1",
+    "html-to-docx": "^1.8.0",
     "markdown-it": "^14.1.0",
     "markdown-it-highlightjs": "^4.2.0",
     "mongodb": "^7.0.0",