fraim-framework 2.0.22 → 2.0.26

package/.github/workflows/deploy-fraim.yml

@@ -7,6 +7,7 @@ on:
       - master
     paths:
       - 'src/fraim-mcp-server.ts'
+      - 'src/fraim/**'
       - '.ai-agents/**'
       - '.fraim/**'
       - '.github/workflows/deploy-fraim.yml'
@@ -55,7 +56,8 @@ jobs:
           # Copy necessary files
           cp -r dist deploy-package/
           cp -r node_modules deploy-package/
-          # Include .fraim directory for runtime configuration
+          # Include registry and .fraim directory for runtime
+          cp -r registry deploy-package/
           cp -r .fraim deploy-package/
           
           cp package.json deploy-package/

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

@@ -10,6 +10,8 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const first_run_js_1 = require("../setup/first-run.js");
 const sync_js_1 = require("./sync.js");
+const types_js_1 = require("../../fraim/types.js");
+const git_utils_js_1 = require("../../utils/git-utils.js");
 const runInit = async () => {
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
@@ -23,14 +25,20 @@ const runInit = async () => {
         console.log(chalk_1.default.yellow('ℹ️  .fraim directory already exists'));
     }
     if (!fs_1.default.existsSync(configPath)) {
-        const defaultConfig = {
-            name: path_1.default.basename(projectRoot),
-            version: '1.0.0',
-            customizations: {
-                workflowsPath: '.fraim/workflows'
+        const remoteInfo = (0, git_utils_js_1.getGitRemoteInfo)();
+        const config = {
+            ...types_js_1.DEFAULT_FRAIM_CONFIG,
+            project: {
+                ...types_js_1.DEFAULT_FRAIM_CONFIG.project,
+                name: path_1.default.basename(projectRoot)
+            },
+            git: {
+                ...types_js_1.DEFAULT_FRAIM_CONFIG.git,
+                repoOwner: remoteInfo.owner || types_js_1.DEFAULT_FRAIM_CONFIG.git.repoOwner,
+                repoName: remoteInfo.repo || types_js_1.DEFAULT_FRAIM_CONFIG.git.repoName
             }
         };
-        fs_1.default.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
+        fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
         console.log(chalk_1.default.green('✅ Created .fraim/config.json'));
     }
     // Create subdirectories

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

@@ -10,10 +10,13 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const digest_utils_1 = require("../../utils/digest-utils");
 const stub_generator_1 = require("../../utils/stub-generator");
+const config_loader_js_1 = require("../../fraim/config-loader.js");
 const runSync = async (options) => {
     const projectRoot = process.cwd();
+    const config = (0, config_loader_js_1.loadFraimConfig)();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
-    const workflowsDir = path_1.default.join(fraimDir, 'workflows');
+    const workflowsRelativePath = config.customizations?.workflowsPath || '.fraim/workflows';
+    const workflowsDir = path_1.default.resolve(projectRoot, workflowsRelativePath);
     const digestPath = path_1.default.join(fraimDir, '.digest');
     // In a real npm package, registry would be in node_modules/@fraim/framework/registry
     // We need to handle both "running from source" (src/cli/commands) and "running from dist" (dist/src/cli/commands)

package/dist/src/fraim/config-loader.js

@@ -8,7 +8,7 @@ exports.loadFraimConfig = loadFraimConfig;
 exports.getConfigValue = getConfigValue;
 const fs_1 = require("fs");
 const path_1 = require("path");
-const types_js_1 = require("./types.js");
+const types_1 = require("./types");
 /**
  * Load FRAIM configuration from .fraim/config.json
  * Falls back to defaults if file doesn't exist
@@ -17,39 +17,51 @@ function loadFraimConfig() {
     const configPath = (0, path_1.join)(process.cwd(), '.fraim', 'config.json');
     if (!(0, fs_1.existsSync)(configPath)) {
         console.log('📋 No .fraim/config.json found, using defaults');
-        return { ...types_js_1.DEFAULT_FRAIM_CONFIG };
+        return { ...types_1.DEFAULT_FRAIM_CONFIG };
     }
     try {
         const configContent = (0, fs_1.readFileSync)(configPath, 'utf-8');
         const config = JSON.parse(configContent);
         // Merge with defaults to ensure all required fields exist
         const mergedConfig = {
-            ...types_js_1.DEFAULT_FRAIM_CONFIG,
+            ...types_1.DEFAULT_FRAIM_CONFIG,
             ...config,
             project: {
-                ...types_js_1.DEFAULT_FRAIM_CONFIG.project,
-                ...config.project
-            },
-            testing: {
-                ...types_js_1.DEFAULT_FRAIM_CONFIG.testing,
-                ...config.testing
+                ...types_1.DEFAULT_FRAIM_CONFIG.project,
+                ...(config.project || {})
             },
             git: {
-                ...types_js_1.DEFAULT_FRAIM_CONFIG.git,
-                ...config.git
+                ...types_1.DEFAULT_FRAIM_CONFIG.git,
+                ...(config.git || {})
             },
             customizations: {
-                ...types_js_1.DEFAULT_FRAIM_CONFIG.customizations,
-                ...config.customizations
+                ...types_1.DEFAULT_FRAIM_CONFIG.customizations,
+                ...(config.customizations || {})
+            },
+            architecture: {
+                ...types_1.DEFAULT_FRAIM_CONFIG.architecture,
+                ...(config.architecture || {})
+            },
+            testing: {
+                ...types_1.DEFAULT_FRAIM_CONFIG.testing,
+                ...(config.testing || {})
+            },
+            persona: {
+                ...types_1.DEFAULT_FRAIM_CONFIG.persona,
+                ...(config.persona || {})
+            },
+            marketing: {
+                ...types_1.DEFAULT_FRAIM_CONFIG.marketing,
+                ...(config.marketing || {})
             },
-            mcp: {
-                ...types_js_1.DEFAULT_FRAIM_CONFIG.mcp,
-                ...config.mcp
+            database: {
+                ...types_1.DEFAULT_FRAIM_CONFIG.database,
+                ...(config.database || {})
             }
         };
         // Validate version
         if (!mergedConfig.version) {
-            mergedConfig.version = types_js_1.DEFAULT_FRAIM_CONFIG.version;
+            mergedConfig.version = types_1.DEFAULT_FRAIM_CONFIG.version;
         }
         console.log(`📋 Loaded FRAIM config from .fraim/config.json (version ${mergedConfig.version})`);
         return mergedConfig;
@@ -57,7 +69,7 @@ function loadFraimConfig() {
     catch (error) {
         console.warn(`⚠️  Failed to load .fraim/config.json: ${error instanceof Error ? error.message : 'Unknown error'}`);
         console.warn('   Using default configuration');
-        return { ...types_js_1.DEFAULT_FRAIM_CONFIG };
+        return { ...types_1.DEFAULT_FRAIM_CONFIG };
     }
 }
 /**

package/dist/src/fraim/setup-wizard.js

@@ -20,44 +20,14 @@ function generateConfigFromAnswers(answers) {
     const config = {
         ...types_js_1.DEFAULT_FRAIM_CONFIG,
         project: {
-            name: answers.projectName || types_js_1.DEFAULT_FRAIM_CONFIG.project.name,
-            type: answers.projectType || types_js_1.DEFAULT_FRAIM_CONFIG.project.type,
-            primaryLanguage: answers.primaryLanguage || types_js_1.DEFAULT_FRAIM_CONFIG.project.primaryLanguage,
-            framework: answers.framework,
-            database: answers.database || types_js_1.DEFAULT_FRAIM_CONFIG.project.database,
-            orm: answers.orm || types_js_1.DEFAULT_FRAIM_CONFIG.project.orm
-        },
-        testing: {
-            framework: answers.testFramework || types_js_1.DEFAULT_FRAIM_CONFIG.testing.framework,
-            testLocation: answers.testLocation || types_js_1.DEFAULT_FRAIM_CONFIG.testing.testLocation,
-            testNaming: answers.testNaming || types_js_1.DEFAULT_FRAIM_CONFIG.testing.testNaming,
-            e2eFramework: answers.e2eFramework || types_js_1.DEFAULT_FRAIM_CONFIG.testing.e2eFramework,
-            coverageTool: types_js_1.DEFAULT_FRAIM_CONFIG.testing.coverageTool
+            ...types_js_1.DEFAULT_FRAIM_CONFIG.project,
+            name: answers.projectName || types_js_1.DEFAULT_FRAIM_CONFIG.project.name
         },
         git: {
-            defaultBranch: answers.defaultBranch || types_js_1.DEFAULT_FRAIM_CONFIG.git.defaultBranch,
-            branchNaming: answers.branchNaming || types_js_1.DEFAULT_FRAIM_CONFIG.git.branchNaming,
-            commitStyle: answers.commitStyle || types_js_1.DEFAULT_FRAIM_CONFIG.git.commitStyle,
-            prWorkflow: answers.prWorkflow || types_js_1.DEFAULT_FRAIM_CONFIG.git.prWorkflow
+            ...types_js_1.DEFAULT_FRAIM_CONFIG.git,
+            defaultBranch: answers.defaultBranch || types_js_1.DEFAULT_FRAIM_CONFIG.git.defaultBranch
         }
     };
-    // Add architecture config if LLM is used
-    if (answers.usesLLM) {
-        config.architecture = {
-            pattern: answers.architecturePattern || 'llm-deterministic-separation',
-            llmFramework: answers.llmFramework || null,
-            llmUsage: answers.llmUsage || [],
-            deterministicUsage: ['data-processing', 'api-calls', 'database-operations'],
-            pipeline: {
-                steps: ['parse', 'normalize', 'validate', 'decide', 'act'],
-                parse: 'llm',
-                normalize: 'deterministic',
-                validate: 'deterministic',
-                decide: 'llm',
-                act: 'deterministic'
-            }
-        };
-    }
     return config;
 }
 /**
@@ -106,17 +76,17 @@ This document describes the architecture patterns and conventions for ${config.p
 
 ## Overview
 
-- **Project Type:** ${config.project.type}
-- **Primary Language:** ${config.project.primaryLanguage}
-- **Framework:** ${config.project.framework || 'Not specified'}
-- **Database:** ${config.project.database}
-- **ORM:** ${config.project.orm}
+- **Project Name:** ${config.project.name}
+- **Project Type:** ${config.project.type || 'Not specified'}
+- **Primary Language:** ${config.project.primaryLanguage || 'Not specified'}
+- **Database:** ${config.project.database || 'Not specified'}
+- **ORM:** ${config.project.orm || 'Not specified'}
 
 `;
     if (arch) {
         template += `## Architecture Pattern
 
-**Pattern:** ${arch.pattern}
+**Pattern:** ${arch.pattern || 'Not specified'}
 
 `;
         if (arch.llmFramework) {
@@ -126,25 +96,18 @@ This document describes the architecture patterns and conventions for ${config.p
 - **Usage:** ${arch.llmUsage?.join(', ') || 'Not specified'}
 - **Deterministic Usage:** ${arch.deterministicUsage?.join(', ') || 'Not specified'}
 
-**Pipeline:**
-${arch.pipeline?.steps.map(step => `- ${step}: ${arch.pipeline?.[step] || 'N/A'}`).join('\n') || 'Not specified'}
-
 `;
         }
     }
     template += `## Development Guidelines
 
 ### Testing
-- **Framework:** ${config.testing.framework}
-- **Test Location:** ${config.testing.testLocation}
-- **Test Naming:** ${config.testing.testNaming}
-- **E2E Framework:** ${config.testing.e2eFramework || 'None'}
+- **Framework:** ${config.testing?.framework || 'Not specified'}
+- **Test Location:** ${config.testing?.testLocation || 'Not specified'}
+- **Test Naming:** ${config.testing?.testNaming || 'Not specified'}
 
 ### Git Workflow
 - **Default Branch:** ${config.git.defaultBranch}
-- **Branch Naming:** ${config.git.branchNaming}
-- **Commit Style:** ${config.git.commitStyle}
-- **PR Workflow:** ${config.git.prWorkflow}
 
 ## Customization
 

package/dist/src/fraim/template-processor.js

@@ -12,7 +12,7 @@ const config_loader_js_1 = require("./config-loader.js");
  * Replaces {{config.path}} with actual config values
  *
  * Examples:
- * - {{config.project.name}} -> "Ashley Calendar AI"
+ * - {{config.project.name}} -> "My Project"
  * - {{config.git.defaultBranch}} -> "master"
  * - {{config.testing.framework}} -> "tsx-test"
  */

package/dist/src/fraim/types.js

@@ -11,47 +11,43 @@ exports.DEFAULT_FRAIM_CONFIG = void 0;
 exports.DEFAULT_FRAIM_CONFIG = {
     version: '1.0.0',
     project: {
-        name: 'Untitled Project',
-        type: 'other',
-        primaryLanguage: 'typescript',
-        database: 'none',
-        orm: 'none'
+        name: 'Untitled Project'
+    },
+    git: {
+        defaultBranch: 'master',
+        repoOwner: '',
+        repoName: ''
+    },
+    architecture: {
+        pattern: 'llm-deterministic-separation',
+        llmFramework: 'baml',
+        llmUsage: [],
+        deterministicUsage: ['data-processing', 'api-calls']
     },
     testing: {
         framework: 'tsx-test',
         testLocation: 'root',
-        testNaming: 'test-*.ts',
-        e2eFramework: 'playwright',
-        coverageTool: 'none'
-    },
-    git: {
-        defaultBranch: 'master',
-        branchNaming: 'feature/{issue}-{slug}',
-        commitStyle: 'imperative',
-        prWorkflow: 'draft-first'
+        testNaming: 'test-*.ts'
     },
     customizations: {
-        rulesPath: '.fraim/rules',
-        workflowsPath: '.fraim/workflows',
-        templatesPath: '.fraim/templates',
-        scriptsPath: '.fraim/scripts'
-    },
-    mcp: {
-        serverPort: 'auto',
-        protocolVersion: '2024-11-05'
+        workflowsPath: '.fraim/workflows'
     },
     persona: {
         name: 'AI Agent',
         voice: 'Helpful and precise.',
         emailSignature: 'Powered by FRAIM',
-        displayNamePattern: 'AI Agent'
+        displayNamePattern: '{executiveName}\'s Assistant'
     },
     marketing: {
         newsletterTitle: 'Product Update',
-        newsletterCtaText: 'Learn More'
+        newsletterCtaText: 'Learn More',
+        newsletterUrl: '',
+        websiteUrl: '',
+        chatUrl: ''
     },
     database: {
         identityCollection: 'Identity',
-        tokensCollection: 'Tokens'
+        tokensCollection: 'Tokens',
+        executiveCollection: 'Executive'
     }
 };

package/dist/src/fraim-mcp-server.js

@@ -82,9 +82,19 @@ class FraimMCPServer {
         this.app.use(express_1.default.json());
         // Load server version
         try {
-            const pkgPath = (0, path_1.join)(__dirname, '..', 'package.json');
-            const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf8'));
-            this.serverVersion = pkg.version;
+            // Try process.cwd() first as it's the root in most deployments
+            let pkgPath = (0, path_1.join)(process.cwd(), 'package.json');
+            if (!(0, fs_1.existsSync)(pkgPath)) {
+                // Fallback to relative to __dirname (dist/src/ -> ../../package.json)
+                pkgPath = (0, path_1.join)(__dirname, '..', '..', 'package.json');
+            }
+            if ((0, fs_1.existsSync)(pkgPath)) {
+                const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf8'));
+                this.serverVersion = pkg.version;
+            }
+            else {
+                this.serverVersion = 'unknown';
+            }
         }
         catch (e) {
             this.serverVersion = 'unknown';
@@ -217,8 +227,11 @@ class FraimMCPServer {
             });
         }
         catch (error) {
-            console.error('❌ FRAIM AUTH: Error during verification:', error);
-            res.status(500).json({ error: 'Internal Server Error' });
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error('❌ FRAIM AUTH: Error during verification:', msg);
+            if (error instanceof Error && error.stack)
+                console.error(error.stack);
+            res.status(500).json({ error: 'Internal Server Error', details: msg });
         }
     }
     adminAuthMiddleware(req, res, next) {
@@ -284,32 +297,25 @@ class FraimMCPServer {
             console.log(`🎨 Indexing project-specific .fraim customizations`);
             const customizations = this.config.customizations || {};
             // Index custom rules
-            if (customizations.rulesPath) {
-                const rulesPath = (0, path_1.join)(process.cwd(), customizations.rulesPath);
-                if ((0, fs_1.existsSync)(rulesPath)) {
-                    this.indexDirectory(rulesPath, 'fraim/rules');
-                }
+            const rulesPath = (0, path_1.join)(process.cwd(), '.fraim/rules');
+            if ((0, fs_1.existsSync)(rulesPath)) {
+                this.indexDirectory(rulesPath, 'fraim/rules');
             }
             // Index custom workflows
-            if (customizations.workflowsPath) {
-                const workflowsPath = (0, path_1.join)(process.cwd(), customizations.workflowsPath);
-                if ((0, fs_1.existsSync)(workflowsPath)) {
-                    this.indexDirectory(workflowsPath, 'fraim/workflows');
-                }
+            const workflowsPathStr = customizations.workflowsPath || '.fraim/workflows';
+            const workflowsPath = (0, path_1.join)(process.cwd(), workflowsPathStr);
+            if ((0, fs_1.existsSync)(workflowsPath)) {
+                this.indexDirectory(workflowsPath, 'fraim/workflows');
             }
             // Index custom templates
-            if (customizations.templatesPath) {
-                const templatesPath = (0, path_1.join)(process.cwd(), customizations.templatesPath);
-                if ((0, fs_1.existsSync)(templatesPath)) {
-                    this.indexDirectory(templatesPath, 'fraim/templates');
-                }
+            const templatesPath = (0, path_1.join)(process.cwd(), '.fraim/templates');
+            if ((0, fs_1.existsSync)(templatesPath)) {
+                this.indexDirectory(templatesPath, 'fraim/templates');
             }
             // Index custom scripts
-            if (customizations.scriptsPath) {
-                const scriptsPath = (0, path_1.join)(process.cwd(), customizations.scriptsPath);
-                if ((0, fs_1.existsSync)(scriptsPath)) {
-                    this.indexDirectory(scriptsPath, 'fraim/scripts');
-                }
+            const scriptsPath = (0, path_1.join)(process.cwd(), '.fraim/scripts');
+            if ((0, fs_1.existsSync)(scriptsPath)) {
+                this.indexDirectory(scriptsPath, 'fraim/scripts');
             }
         }
         console.log(`📚 Indexed ${this.fileIndex.size} files total (Global + Local)`);
@@ -963,12 +969,10 @@ Use this to discover which workflow to call with get_fraim_workflow.`,
         const workflowPath = `workflows/${normalizedName}.md`;
         const metadata = this.fileIndex.get(workflowPath);
         if (!metadata) {
-            // Try alternative paths (e.g., customer-development subdirectory)
-            const alternativePaths = [
-                `workflows/customer-development/${normalizedName}.md`,
-                `workflows/business-development/${normalizedName}.md`
-            ];
-            for (const altPath of alternativePaths) {
+            // Try alternative category paths
+            const categories = ['product-building', 'customer-development', 'business-development', 'marketing', 'performance', 'quality-assurance', 'reviewer', 'startup-credits', 'bootstrap', 'deploy'];
+            for (const cat of categories) {
+                const altPath = `workflows/${cat}/${normalizedName}.md`;
                 const altMetadata = this.fileIndex.get(altPath);
                 if (altMetadata) {
                     return this.returnWorkflowFile(altMetadata);
@@ -1213,8 +1217,8 @@ If \`.fraim/config.json\` doesn't exist:
 exports.FraimMCPServer = FraimMCPServer;
 // Start the server if this file is run directly
 // In Azure App Service, the port is provided via process.env.PORT
-const ashleyPort = (0, git_utils_1.getPort)();
-const defaultFraimPort = process.env.FRAIM_MCP_PORT ? parseInt(process.env.FRAIM_MCP_PORT) : ashleyPort + 2;
+const serverPort = (0, git_utils_1.getPort)();
+const defaultFraimPort = process.env.FRAIM_MCP_PORT ? parseInt(process.env.FRAIM_MCP_PORT) : serverPort + 2;
 const port = process.env.PORT ? parseInt(process.env.PORT) : defaultFraimPort;
 const server = new FraimMCPServer();
 server.start(port).catch((error) => {

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

@@ -4,6 +4,7 @@ exports.getPort = getPort;
 exports.determineDatabaseName = determineDatabaseName;
 exports.getCurrentGitBranch = getCurrentGitBranch;
 exports.determineSchema = determineSchema;
+exports.getGitRemoteInfo = getGitRemoteInfo;
 const child_process_1 = require("child_process");
 /**
  * Gets a unique port based on the current git branch name (if it's an issue branch)
@@ -23,7 +24,7 @@ function getPort() {
     catch (e) {
         // Silently fail and use default
     }
-    return Number(process.env.FRAIM_MCP_PORT) || 15300;
+    return Number(process.env.PORT) || Number(process.env.WEBSITES_PORT) || Number(process.env.FRAIM_MCP_PORT) || 15300;
 }
 /**
  * Determines the database name based on the git branch
@@ -62,3 +63,25 @@ function determineSchema(branchName) {
     }
     return 'prod';
 }
+/**
+ * Gets the GitHub remote info (owner and repo name)
+ */
+function getGitRemoteInfo() {
+    try {
+        const remoteUrl = (0, child_process_1.execSync)('git remote get-url origin').toString().trim();
+        // Match both HTTPS and SSH formats
+        // HTTPS: https://github.com/owner/repo.git OR https://github.com/owner/repo
+        // SSH: git@github.com:owner/repo.git OR git@github.com:owner/repo
+        const match = remoteUrl.match(/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?$/);
+        if (match) {
+            return {
+                owner: match[1],
+                repo: match[2]
+            };
+        }
+    }
+    catch (e) {
+        // Silently fail if not a git repo or no origin
+    }
+    return { owner: null, repo: null };
+}