fraim-framework 2.0.69 → 2.0.70

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

@@ -10,8 +10,8 @@ const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const chalk_1 = __importDefault(require("chalk"));
 const sync_1 = require("./sync");
-const platform_detection_1 = require("../../utils/platform-detection");
-const version_utils_1 = require("../../utils/version-utils");
+const platform_detection_1 = require("../utils/platform-detection");
+const version_utils_1 = require("../utils/version-utils");
 const checkGlobalSetup = () => {
     const fraimUserDir = process.env.FRAIM_USER_DIR || path_1.default.join(os_1.default.homedir(), '.fraim');
     const globalConfigPath = path_1.default.join(fraimUserDir, 'config.json');

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

@@ -12,8 +12,8 @@ const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const token_validator_1 = require("../setup/token-validator");
 const auto_mcp_setup_1 = require("../setup/auto-mcp-setup");
-const version_utils_1 = require("../../utils/version-utils");
-const platform_detection_1 = require("../../utils/platform-detection");
+const version_utils_1 = require("../utils/version-utils");
+const platform_detection_1 = require("../utils/platform-detection");
 const init_project_1 = require("./init-project");
 const promptForFraimKey = async () => {
     console.log(chalk_1.default.blue('🔑 FRAIM Key Setup'));

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

@@ -42,10 +42,10 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const child_process_1 = require("child_process");
-const config_loader_1 = require("../../fraim/config-loader");
-const version_utils_1 = require("../../utils/version-utils");
-const script_sync_utils_1 = require("../../utils/script-sync-utils");
-const git_utils_1 = require("../../utils/git-utils");
+const config_loader_1 = require("../../core/config-loader");
+const version_utils_1 = require("../utils/version-utils");
+const script_sync_utils_1 = require("../utils/script-sync-utils");
+const git_utils_1 = require("../../core/utils/git-utils");
 /**
  * Load API key from user-level config (~/.fraim/config.json)
  */
@@ -76,7 +76,7 @@ const runSync = async (options) => {
     else if (isPostInstall) {
         console.log(chalk_1.default.gray('⏭️ Skipping auto-update check during installation to prevent loops.'));
     }
-    const { syncFromRemote } = await Promise.resolve().then(() => __importStar(require('../../utils/remote-sync.js')));
+    const { syncFromRemote } = await Promise.resolve().then(() => __importStar(require('../utils/remote-sync')));
     // Path 1: --local flag → hit localhost MCP server
     if (options.local) {
         console.log(chalk_1.default.blue('🔄 Syncing FRAIM workflows from local server...'));

package/dist/src/{utils → cli/utils}/version-utils.js

@@ -8,12 +8,12 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 function getFraimVersion() {
     // Try reliable paths to find package.json relative to this file
-    // locally: src/utils/version-utils.ts -> package.json is ../../package.json
-    // dist: dist/src/utils/version-utils.js -> package.json is ../../../package.json
+    // locally: src/cli/utils/version-utils.ts -> package.json is ../../../package.json
+    // dist: dist/src/cli/utils/version-utils.js -> package.json is ../../../../package.json
     const possiblePaths = [
-        path_1.default.join(__dirname, '../../package.json'), // Local dev (src)
-        path_1.default.join(__dirname, '../../../package.json'), // Dist (dist/src)
-        path_1.default.join(process.cwd(), 'package.json') // Fallback to CWD (unlikely to be correct for global install but safe fallback)
+        path_1.default.join(__dirname, '../../../package.json'), // Local dev (src)
+        path_1.default.join(__dirname, '../../../../package.json'), // Dist (dist/src)
+        path_1.default.join(process.cwd(), 'package.json') // Fallback to CWD
     ];
     for (const pkgPath of possiblePaths) {
         if (fs_1.default.existsSync(pkgPath)) {

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

@@ -25,8 +25,8 @@ 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");
+const provider_utils_1 = require("../core/utils/provider-utils");
+const object_utils_1 = require("../core/utils/object-utils");
 /**
  * Handle template substitution logic separately for better testability
  */

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework - Smart Entry Point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.69",
+  "version": "2.0.70",
   "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 && npm run build:stubs && node scripts/copy-ai-manager-rules.js && npm run validate:registry",
+    "build": "tsc && npm run build:stubs && node scripts/copy-ai-manager-rules.js && npm run validate:registry && tsx scripts/validate-purity.ts",
     "build:stubs": "tsx scripts/build-stub-registry.ts",
     "test": "node scripts/test-with-server.js",
     "start:fraim": "tsx src/fraim-mcp-server.ts",
@@ -66,17 +66,24 @@
     "@types/express": "^5.0.6",
     "@types/node": "^20.0.0",
     "@types/prompts": "^2.4.9",
+    "cors": "^2.8.5",
+    "express": "^5.2.1",
     "fast-glob": "^3.3.3",
+    "html-to-docx": "^1.8.0",
+    "markdown-it": "^14.1.0",
+    "markdown-it-highlightjs": "^4.2.0",
+    "mongodb": "^7.0.0",
     "pptxgenjs": "^4.0.1",
+    "puppeteer": "^24.36.1",
     "qrcode": "^1.5.4",
+    "sharp": "^0.34.5",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
   },
   "files": [
     "dist/src/local-mcp-server/",
     "dist/src/cli/",
-    "dist/src/fraim/",
-    "dist/src/utils/",
+    "dist/src/core/",
     "bin/fraim.js",
     "bin/fraim-mcp.js",
     "index.js",
@@ -92,16 +99,8 @@
     "axios": "^1.7.0",
     "chalk": "4.1.2",
     "commander": "^14.0.2",
-    "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",
     "prompts": "^2.4.2",
-    "puppeteer": "^24.36.1",
-    "sharp": "^0.34.5",
     "tree-kill": "^1.2.2"
   }
 }

package/dist/src/fraim/db-service.js

@@ -1,135 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FraimDbService = void 0;
-const mongodb_1 = require("mongodb");
-const git_utils_1 = require("../utils/git-utils");
-class FraimDbService {
-    constructor() {
-        const url = process.env.MONGODB_URI || process.env.MONGO_DATABASE_URL;
-        if (!url) {
-            throw new Error('MONGODB_URI or MONGO_DATABASE_URL not found in environment');
-        }
-        this.client = new mongodb_1.MongoClient(url);
-    }
-    async connect() {
-        await this.client.connect();
-        const dbName = (0, git_utils_1.determineDatabaseName)();
-        this.db = this.client.db(dbName);
-        // Use fraim_ prefix for standalone server collections
-        this.keysCollection = this.db.collection('fraim_api_keys');
-        this.sessionsCollection = this.db.collection('fraim_telemetry_sessions');
-        this.signupsCollection = this.db.collection('fraim_website_signups');
-        this.salesCollection = this.db.collection('fraim_sales_inquiries');
-        // Create indexes
-        await this.keysCollection.createIndex({ key: 1 }, { unique: true });
-        await this.sessionsCollection.createIndex({ sessionId: 1 }, { unique: true });
-        await this.sessionsCollection.createIndex({ userId: 1 });
-        await this.sessionsCollection.createIndex({ lastActive: -1 });
-        await this.signupsCollection.createIndex({ email: 1 }, { unique: true });
-        await this.signupsCollection.createIndex({ timestamp: -1 });
-        await this.salesCollection.createIndex({ email: 1 });
-        await this.salesCollection.createIndex({ timestamp: -1 });
-        console.log(`✅ Connected to Fraim DB: ${dbName}`);
-    }
-    async createSession(session) {
-        if (!this.sessionsCollection)
-            throw new Error('DB not connected');
-        await this.sessionsCollection.insertOne(session);
-    }
-    async updateSessionActivity(sessionId, lastActive) {
-        if (!this.sessionsCollection)
-            return; // Fail silently
-        await this.sessionsCollection.updateOne({ sessionId }, { $set: { lastActive } });
-    }
-    async verifyApiKey(key) {
-        if (!this.keysCollection)
-            throw new Error('DB not connected');
-        const apiKey = await this.keysCollection.findOne({ key, isActive: true });
-        return apiKey;
-    }
-    async getActiveSessionByApiKey(key) {
-        if (!this.keysCollection || !this.sessionsCollection)
-            throw new Error('DB not connected');
-        // 1. Get user for this key
-        const apiKeyData = await this.verifyApiKey(key);
-        if (!apiKeyData)
-            return null;
-        // 2. Get latest session for this user (within last 24h)
-        const dayAgo = new Date(Date.now() - 24 * 60 * 60 * 1000);
-        const session = await this.sessionsCollection.findOne({ userId: apiKeyData.userId, lastActive: { $gt: dayAgo } }, { sort: { lastActive: -1 } });
-        return session;
-    }
-    // ... (rest of methods)
-    async listApiKeys() {
-        if (!this.keysCollection)
-            throw new Error('DB not connected');
-        return await this.keysCollection.find({}).toArray();
-    }
-    async createApiKey(data) {
-        if (!this.keysCollection)
-            throw new Error('DB not connected');
-        await this.keysCollection.insertOne({
-            ...data,
-            isActive: true,
-            createdAt: new Date()
-        });
-    }
-    async revokeApiKey(key) {
-        if (!this.keysCollection)
-            throw new Error('DB not connected');
-        const result = await this.keysCollection.updateOne({ key }, { $set: { isActive: false } });
-        return result.matchedCount > 0;
-    }
-    /**
-     * Generates a secure API key
-     */
-    generateApiKey(userId, orgId) {
-        const prefix = 'fraim_';
-        const random = Math.random().toString(36).substring(2, 15) + Math.random().toString(36).substring(2, 15);
-        return `${prefix}${random}`;
-    }
-    async createWebsiteSignup(signup) {
-        if (!this.signupsCollection)
-            throw new Error('DB not connected');
-        try {
-            await this.signupsCollection.insertOne(signup);
-        }
-        catch (error) {
-            // Handle duplicate email gracefully
-            if (error.code === 11000) {
-                throw new Error('Email already registered');
-            }
-            throw error;
-        }
-    }
-    async getWebsiteSignups(limit = 100) {
-        if (!this.signupsCollection)
-            throw new Error('DB not connected');
-        return await this.signupsCollection.find({})
-            .sort({ timestamp: -1 })
-            .limit(limit)
-            .toArray();
-    }
-    async getSignupByEmail(email) {
-        if (!this.signupsCollection)
-            throw new Error('DB not connected');
-        return await this.signupsCollection.findOne({ email });
-    }
-    async createSalesInquiry(inquiry) {
-        if (!this.salesCollection)
-            throw new Error('DB not connected');
-        await this.salesCollection.insertOne(inquiry);
-    }
-    async getSalesInquiries(limit = 100) {
-        if (!this.salesCollection)
-            throw new Error('DB not connected');
-        return await this.salesCollection.find({})
-            .sort({ timestamp: -1 })
-            .limit(limit)
-            .toArray();
-    }
-    async close() {
-        await this.client.close();
-    }
-}
-exports.FraimDbService = FraimDbService;

package/dist/src/fraim/issues.js

@@ -1,69 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fileFraimIssue = fileFraimIssue;
-const axios_1 = __importDefault(require("axios"));
-/**
- * File an issue in the FRAIM repository
- *
- * This function creates issues in the FRAIM repository for bug reports,
- * feature requests, and workflow contributions.
- */
-async function fileFraimIssue(params) {
-    const { title, body, labels, dryRun } = params;
-    // Always target the FRAIM repository
-    const owner = 'mathursrus';
-    const repo = 'FRAIM';
-    if (dryRun) {
-        return {
-            success: true,
-            dryRun: true,
-            message: `[DRY RUN] Would create GitHub issue: "${title}" in ${owner}/${repo}.`
-        };
-    }
-    try {
-        // Check for GitHub token
-        const token = process.env.GITHUB_TOKEN;
-        if (!token) {
-            return {
-                success: false,
-                message: `GitHub integration requires GITHUB_TOKEN environment variable.
-                
-Please set GITHUB_TOKEN environment variable to file issues in ${owner}/${repo}.`
-            };
-        }
-        // Create the issue in FRAIM repository
-        const url = `https://api.github.com/repos/${owner}/${repo}/issues`;
-        const payload = { title, body };
-        if (labels && labels.length > 0) {
-            payload.labels = labels;
-        }
-        const response = await axios_1.default.post(url, payload, {
-            headers: {
-                'Authorization': `Bearer ${token}`,
-                'Accept': 'application/vnd.github.v3+json',
-                'Content-Type': 'application/json',
-            },
-        });
-        return {
-            success: true,
-            issueNumber: response.data.number,
-            htmlUrl: response.data.html_url
-        };
-    }
-    catch (error) {
-        let errorMessage = 'Unknown error';
-        if (axios_1.default.isAxiosError(error)) {
-            errorMessage = `Status: ${error.response?.status} - ${JSON.stringify(error.response?.data)}`;
-        }
-        else if (error instanceof Error) {
-            errorMessage = error.message;
-        }
-        return {
-            success: false,
-            message: `Failed to create issue in FRAIM repository: ${errorMessage}`
-        };
-    }
-}

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

@@ -1,138 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TemplateEngine = void 0;
-exports.getTemplateEngine = getTemplateEngine;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const provider_utils_1 = require("../utils/provider-utils");
-const object_utils_1 = require("../utils/object-utils");
-/**
- * Multi-Provider Template Engine
- * Processes workflow templates with provider-specific action mappings
- */
-class TemplateEngine {
-    constructor(registryPath) {
-        this.providers = new Map();
-        this.registryPath = registryPath || (0, path_1.join)(__dirname, '../../registry');
-        this.loadProviders();
-    }
-    loadProviders() {
-        try {
-            // Load GitHub provider templates
-            const githubPath = (0, path_1.join)(this.registryPath, 'providers/github.json');
-            if ((0, fs_1.existsSync)(githubPath)) {
-                const githubTemplates = JSON.parse((0, fs_1.readFileSync)(githubPath, 'utf-8'));
-                this.providers.set('github', githubTemplates);
-            }
-            // Load ADO provider templates
-            const adoPath = (0, path_1.join)(this.registryPath, 'providers/ado.json');
-            if ((0, fs_1.existsSync)(adoPath)) {
-                const adoTemplates = JSON.parse((0, fs_1.readFileSync)(adoPath, 'utf-8'));
-                this.providers.set('ado', adoTemplates);
-            }
-            console.log(`✅ Loaded ${this.providers.size} provider templates`);
-        }
-        catch (error) {
-            console.warn('⚠️ Failed to load provider templates:', error);
-        }
-    }
-    /**
-     * Process workflow content with provider actions only
-     */
-    processWorkflow(workflowContent, repositoryInfo) {
-        // Only process provider actions, no client-side config variables
-        return this.processProviderActions(workflowContent, repositoryInfo);
-    }
-    processProviderActions(workflowContent, repositoryInfo) {
-        // Determine provider from repository info using shared utility
-        const repoData = repositoryInfo?.repository || repositoryInfo;
-        const provider = repoData?.provider || (0, provider_utils_1.detectProvider)(repoData?.url);
-        const providerTemplates = this.providers.get(provider);
-        if (!providerTemplates) {
-            console.warn(`⚠️ No templates found for provider: ${provider}, falling back to GitHub`);
-            return this.processWithProvider(workflowContent, 'github', repositoryInfo);
-        }
-        return this.processWithProvider(workflowContent, provider, repositoryInfo);
-    }
-    processWithProvider(workflowContent, provider, repositoryInfo) {
-        const providerTemplates = this.providers.get(provider);
-        if (!providerTemplates) {
-            return workflowContent; // Return unchanged if no templates
-        }
-        let processed = workflowContent;
-        // Replace {{action}} with provider-specific implementations
-        for (const [action, template] of Object.entries(providerTemplates)) {
-            const regex = new RegExp(`{{${action}}}`, 'g');
-            const renderedTemplate = this.renderTemplate(template, repositoryInfo);
-            processed = processed.replace(regex, renderedTemplate);
-        }
-        return processed;
-    }
-    /**
-     * Render template with repository variable substitution
-     */
-    renderTemplate(template, repositoryInfo) {
-        if (!repositoryInfo)
-            return template;
-        return template.replace(/{{([^}]+)}}/g, (match, path) => {
-            const trimmedPath = path.trim();
-            // Handle repository.* variables
-            if (trimmedPath.startsWith('repository.')) {
-                const repoPath = trimmedPath.substring('repository.'.length);
-                // Check if repositoryInfo has a 'repository' property (full config)
-                // or if it IS the repository data directly
-                let repoData = repositoryInfo.repository || repositoryInfo;
-                const value = (0, object_utils_1.getNestedValue)(repoData, repoPath);
-                return value !== undefined ? String(value) : match;
-            }
-            // Handle direct variables (for backward compatibility)
-            const value = (0, object_utils_1.getNestedValue)(repositoryInfo, trimmedPath);
-            return value !== undefined ? String(value) : match;
-        });
-    }
-    /**
-     * Get available providers
-     */
-    getAvailableProviders() {
-        return Array.from(this.providers.keys());
-    }
-    /**
-     * Get available actions for a provider
-     */
-    getProviderActions(provider) {
-        const templates = this.providers.get(provider);
-        return templates ? Object.keys(templates) : [];
-    }
-    /**
-     * Validate that all template actions in content are supported
-     */
-    validateWorkflow(workflowContent, provider) {
-        const actionRegex = /{{(\w+)}}/g;
-        const actions = new Set();
-        let match;
-        while ((match = actionRegex.exec(workflowContent)) !== null) {
-            // Skip config variables
-            if (!match[1].startsWith('config.')) {
-                actions.add(match[1]);
-            }
-        }
-        const providerActions = this.getProviderActions(provider);
-        const missingActions = Array.from(actions).filter(action => !providerActions.includes(action));
-        return {
-            valid: missingActions.length === 0,
-            missingActions
-        };
-    }
-}
-exports.TemplateEngine = TemplateEngine;
-// Global template engine instance
-let globalTemplateEngine = null;
-/**
- * Get or create global template engine instance
- */
-function getTemplateEngine(registryPath) {
-    if (!globalTemplateEngine || (registryPath && registryPath !== globalTemplateEngine['registryPath'])) {
-        globalTemplateEngine = new TemplateEngine(registryPath);
-    }
-    return globalTemplateEngine;
-}

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

@@ -1,23 +0,0 @@
-"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 };
-}