fraim-framework 2.0.93 → 2.0.94

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

@@ -41,7 +41,6 @@ const commander_1 = require("commander");
 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("../../core/config-loader");
 const version_utils_1 = require("../utils/version-utils");
 const script_sync_utils_1 = require("../utils/script-sync-utils");
@@ -85,14 +84,13 @@ const runSync = async (options) => {
     const projectRoot = process.cwd();
     const config = (0, config_loader_1.loadFraimConfig)();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
-    // Check for CLI updates first (but skip during installation to prevent loops)
-    const isPostInstall = process.env.npm_lifecycle_event === 'postinstall' ||
-        process.env.npm_lifecycle_script === 'postinstall';
-    if (!options.skipUpdates && !isPostInstall) {
-        await checkAndUpdateCLI();
-    }
-    else if (isPostInstall) {
-        console.log(chalk_1.default.gray('⏭️ Skipping auto-update check during installation to prevent loops.'));
+    // Check if running via npx
+    const isNpx = process.env.npm_config_prefix === undefined || process.env.npm_lifecycle_event === 'npx';
+    const isGlobal = !isNpx && (process.env.npm_config_global === 'true' || process.env.npm_config_prefix);
+    if (isGlobal && !options.skipUpdates) {
+        console.log(chalk_1.default.yellow('⚠️  You are running a global installation of FRAIM.'));
+        console.log(chalk_1.default.gray('   Updates are not automatic in this mode.'));
+        console.log(chalk_1.default.cyan('   💡 Recommended: Use "npx fraim-framework@latest sync" instead.\n'));
     }
     const { syncFromRemote } = await Promise.resolve().then(() => __importStar(require('../utils/remote-sync')));
     // Path 1: --local flag → hit localhost MCP server
@@ -149,118 +147,9 @@ const runSync = async (options) => {
     updateVersionInConfig(fraimDir);
 };
 exports.runSync = runSync;
-async function checkAndUpdateCLI() {
-    try {
-        // Additional safety: check if we're in a global npm install context
-        const isGlobalInstall = process.env.npm_config_global === 'true' ||
-            process.env.npm_config_prefix ||
-            process.cwd().includes('node_modules');
-        if (isGlobalInstall) {
-            console.log(chalk_1.default.gray('⏭️ Skipping auto-update during global installation.'));
-            return;
-        }
-        console.log(chalk_1.default.blue('🔍 Checking for FRAIM CLI updates...'));
-        const currentVersion = (0, version_utils_1.getFraimVersion)();
-        const latestVersion = await getLatestNpmVersionHttp('fraim-framework');
-        if (!latestVersion) {
-            console.log(chalk_1.default.yellow('⚠️ Could not check for updates. Continuing with current version.'));
-            return;
-        }
-        if (isVersionUpToDate(currentVersion, latestVersion)) {
-            console.log(chalk_1.default.green(`✅ FRAIM CLI is up to date (${currentVersion})`));
-            return;
-        }
-        console.log(chalk_1.default.yellow(`📦 New version available: ${currentVersion} → ${latestVersion}`));
-        console.log(chalk_1.default.blue('🔄 Auto-updating FRAIM CLI...'));
-        const success = await updateGlobalPackageHttp('fraim-framework', latestVersion);
-        if (success) {
-            console.log(chalk_1.default.green(`✅ Successfully updated to FRAIM ${latestVersion}`));
-            console.log(chalk_1.default.gray('   Restart may be required for some changes to take effect.'));
-        }
-        else {
-            console.log(chalk_1.default.yellow('⚠️ Auto-update failed. Please run: npm install -g fraim-framework@latest'));
-        }
-    }
-    catch (error) {
-        console.log(chalk_1.default.yellow('⚠️ Could not check for updates. Continuing with current version.'));
-    }
-}
-async function getLatestNpmVersionHttp(packageName) {
-    try {
-        // Use Node.js built-in https module instead of spawn
-        const https = require('https');
-        return new Promise((resolve) => {
-            const req = https.get(`https://registry.npmjs.org/${packageName}/latest`, {
-                timeout: 5000,
-                headers: {
-                    'User-Agent': 'fraim-framework-cli'
-                }
-            }, (res) => {
-                let data = '';
-                res.on('data', (chunk) => {
-                    data += chunk;
-                });
-                res.on('end', () => {
-                    try {
-                        const packageInfo = JSON.parse(data);
-                        resolve(packageInfo.version || null);
-                    }
-                    catch (e) {
-                        resolve(null);
-                    }
-                });
-            });
-            req.on('error', () => {
-                resolve(null);
-            });
-            req.on('timeout', () => {
-                req.destroy();
-                resolve(null);
-            });
-        });
-    }
-    catch (error) {
-        return null;
-    }
-}
-function isVersionUpToDate(current, latest) {
-    // Simple version comparison - assumes semantic versioning
-    const currentParts = current.split('.').map(n => parseInt(n, 10));
-    const latestParts = latest.split('.').map(n => parseInt(n, 10));
-    for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
-        const currentPart = currentParts[i] || 0;
-        const latestPart = latestParts[i] || 0;
-        if (currentPart < latestPart)
-            return false;
-        if (currentPart > latestPart)
-            return true;
-    }
-    return true; // Versions are equal
-}
-async function updateGlobalPackageHttp(packageName, version) {
-    return new Promise((resolve) => {
-        console.log(chalk_1.default.gray(`   Running: npm install -g ${packageName}@${version}`));
-        // Use npm.cmd on Windows, npm on Unix
-        const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-        const npmProcess = (0, child_process_1.spawn)(npmCommand, ['install', '-g', `${packageName}@${version}`], {
-            stdio: ['ignore', 'ignore', 'ignore'] // Suppress output for cleaner experience
-        });
-        npmProcess.on('close', (code) => {
-            resolve(code === 0);
-        });
-        npmProcess.on('error', () => {
-            resolve(false);
-        });
-        // Timeout after 30 seconds
-        setTimeout(() => {
-            npmProcess.kill();
-            resolve(false);
-        }, 30000);
-    });
-}
 exports.syncCommand = new commander_1.Command('sync')
     .description('Sync workflow stubs from the framework registry')
     .option('-f, --force', 'Force sync even if digest matches')
-    .option('--skip-updates', 'Skip checking for CLI updates')
+    .option('--skip-updates', 'Skip checking for CLI updates (legacy)')
     .option('--local', 'Sync from local development server (port derived from git branch)')
     .action(exports.runSync);

package/dist/src/cli/mcp/mcp-server-registry.js

@@ -1,7 +1,4 @@
 "use strict";
-// MCP Server Registry - Builds MCP servers from provider definitions
-// This file NO LONGER contains hardcoded server configurations
-// All provider MCP server configs come from the provider registry (server or local fallback)
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE_MCP_SERVERS = void 0;
 exports.buildProviderMCPServer = buildProviderMCPServer;

package/dist/src/cli/setup/auto-mcp-setup.js

@@ -324,7 +324,7 @@ const autoConfigureMCP = async (fraimKey, tokenInput, selectedIDEs, providerConf
         console.log(chalk_1.default.blue('\n🎯 Next steps:'));
         console.log(chalk_1.default.cyan('   1. Restart your configured IDEs'));
         console.log(chalk_1.default.cyan('   2. Go to any project directory'));
-        console.log(chalk_1.default.cyan('   3. Run: fraim init-project'));
+        console.log(chalk_1.default.cyan('   3. Run: npx fraim-framework@latest init-project'));
         console.log(chalk_1.default.cyan('   4. Ask your AI agent: "list fraim workflows"'));
     }
 };

package/dist/src/core/types.js

@@ -2,8 +2,6 @@
 /**
  * FRAIM Configuration Types
  * TypeScript types for .fraim/config.json
- *
- * Each field includes rich metadata for agent detection and user interaction
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_FRAIM_CONFIG = void 0;

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

@@ -243,14 +243,6 @@ class FraimLocalMCPServer {
         this.machineInfo = null;
         this.repoInfo = null;
         this.engine = null;
-        this.fallbackRewriteCount = 0;
-        this.fallbackRewriteRequestCount = 0;
-        this.fallbackRewriteTokens = new Map();
-        this.pendingFallbackRequestCount = 0;
-        this.pendingFallbackTokenRewriteCount = 0;
-        this.pendingFallbackTokenCounts = new Map();
-        this.pendingFallbackEvents = [];
-        this.fallbackSummaryEmitted = false;
         this.writer = writer || process.stdout.write.bind(process.stdout);
         this.remoteUrl = process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
         this.apiKey = this.loadApiKey();
@@ -1043,7 +1035,6 @@ class FraimLocalMCPServer {
             return response;
         const rewritten = this.rewriteUnresolvedProxyPlaceholders(response.result);
         if (rewritten.tokens.length > 0) {
-            this.recordFallbackRewrite(rewritten.tokens);
             this.logError(`[${FraimLocalMCPServer.FALLBACK_ALERT_MARKER}] Rewrote unresolved proxy placeholders to agent placeholders: ${rewritten.tokens.join(', ')}`);
         }
         return {
@@ -1051,79 +1042,6 @@ class FraimLocalMCPServer {
             result: rewritten.value
         };
     }
-    recordFallbackRewrite(tokens) {
-        this.fallbackRewriteRequestCount += 1;
-        this.fallbackRewriteCount += tokens.length;
-        for (const token of tokens) {
-            const existing = this.fallbackRewriteTokens.get(token) || 0;
-            this.fallbackRewriteTokens.set(token, existing + 1);
-        }
-        this.pendingFallbackRequestCount += 1;
-        this.pendingFallbackTokenRewriteCount += tokens.length;
-        for (const token of tokens) {
-            const existing = this.pendingFallbackTokenCounts.get(token) || 0;
-            this.pendingFallbackTokenCounts.set(token, existing + 1);
-        }
-        this.pendingFallbackEvents.push({
-            at: new Date().toISOString(),
-            tokenCount: tokens.length,
-            tokens: [...tokens]
-        });
-        if (this.pendingFallbackEvents.length > 250) {
-            this.pendingFallbackEvents = this.pendingFallbackEvents.slice(-250);
-        }
-    }
-    buildPendingFallbackTelemetryPayload() {
-        if (this.pendingFallbackRequestCount === 0 &&
-            this.pendingFallbackTokenRewriteCount === 0 &&
-            this.pendingFallbackEvents.length === 0) {
-            return null;
-        }
-        const tokenCounts = {};
-        for (const [token, count] of this.pendingFallbackTokenCounts.entries()) {
-            tokenCounts[token] = count;
-        }
-        return {
-            requestFallbacks: this.pendingFallbackRequestCount,
-            tokenRewrites: this.pendingFallbackTokenRewriteCount,
-            tokenCounts,
-            events: this.pendingFallbackEvents.map((event) => ({
-                at: event.at,
-                tokenCount: event.tokenCount,
-                tokens: [...event.tokens]
-            }))
-        };
-    }
-    acknowledgePendingFallbackTelemetry(payload) {
-        this.pendingFallbackRequestCount = Math.max(0, this.pendingFallbackRequestCount - payload.requestFallbacks);
-        this.pendingFallbackTokenRewriteCount = Math.max(0, this.pendingFallbackTokenRewriteCount - payload.tokenRewrites);
-        for (const [token, sentCount] of Object.entries(payload.tokenCounts)) {
-            const current = this.pendingFallbackTokenCounts.get(token) || 0;
-            const next = Math.max(0, current - Math.max(0, sentCount));
-            if (next === 0) {
-                this.pendingFallbackTokenCounts.delete(token);
-            }
-            else {
-                this.pendingFallbackTokenCounts.set(token, next);
-            }
-        }
-        if (payload.events.length > 0) {
-            this.pendingFallbackEvents.splice(0, Math.min(payload.events.length, this.pendingFallbackEvents.length));
-        }
-    }
-    emitFallbackSummary(reason) {
-        if (this.fallbackSummaryEmitted)
-            return;
-        this.fallbackSummaryEmitted = true;
-        if (this.fallbackRewriteCount === 0)
-            return;
-        const topTokens = Array.from(this.fallbackRewriteTokens.entries())
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 10)
-            .map(([token, count]) => `${token}:${count}`)
-            .join(', ');
-        this.logError(`[${FraimLocalMCPServer.FALLBACK_SUMMARY_MARKER}] reason=${reason} requestFallbacks=${this.fallbackRewriteRequestCount} tokenRewrites=${this.fallbackRewriteCount} uniqueTokens=${this.fallbackRewriteTokens.size}${topTokens ? ` topTokens=${topTokens}` : ''}`);
-    }
     extractSessionIdFromRequest(request) {
         const sessionIdFromParams = request.params?.sessionId;
         if (typeof sessionIdFromParams === 'string' && sessionIdFromParams.trim().length > 0) {
@@ -1197,7 +1115,6 @@ class FraimLocalMCPServer {
      * tool calls and recursive inclusion resolution.
      */
     async _doProxyToRemote(request, requestId = (0, crypto_1.randomUUID)()) {
-        let sentFallbackTelemetry = null;
         try {
             // Special handling for fraim_connect - automatically inject machine and repo info
             if (request.method === 'tools/call' && request.params?.name === 'fraim_connect') {
@@ -1269,7 +1186,6 @@ class FraimLocalMCPServer {
                 // Update the request with injected info
                 request.params.arguments = args;
             }
-            sentFallbackTelemetry = this.buildPendingFallbackTelemetryPayload();
             const headers = {
                 'Content-Type': 'application/json',
                 'x-api-key': this.apiKey,
@@ -1280,11 +1196,6 @@ class FraimLocalMCPServer {
             if (sessionId) {
                 headers[FraimLocalMCPServer.SESSION_HEADER] = sessionId;
             }
-            if (sentFallbackTelemetry) {
-                headers[FraimLocalMCPServer.FALLBACK_HEADER] = Buffer
-                    .from(JSON.stringify(sentFallbackTelemetry), 'utf8')
-                    .toString('base64');
-            }
             this.log(`[req:${requestId}] Proxying ${request.method} to ${this.remoteUrl}/mcp`);
             // Resolve templates in the outgoing request so the remote server 
             // only ever sees finalized values.
@@ -1295,9 +1206,6 @@ class FraimLocalMCPServer {
                 headers,
                 timeout: 30000
             });
-            if (sentFallbackTelemetry) {
-                this.acknowledgePendingFallbackTelemetry(sentFallbackTelemetry);
-            }
             return response.data;
         }
         catch (error) {
@@ -1322,10 +1230,6 @@ class FraimLocalMCPServer {
                         localMcpVersion: this.localVersion
                     };
                 }
-                if (sentFallbackTelemetry) {
-                    // Request reached the server and produced a response; clear sent fallback delta.
-                    this.acknowledgePendingFallbackTelemetry(sentFallbackTelemetry);
-                }
                 return forwarded;
             }
             return {
@@ -1652,19 +1556,16 @@ class FraimLocalMCPServer {
         process.stdin.on('end', () => {
             this.log('🛑 Stdin closed, shutting down...');
             cleanup();
-            this.emitFallbackSummary('stdin_end');
             process.exit(0);
         });
         process.on('SIGTERM', () => {
             this.log('🛑 SIGTERM received, shutting down...');
             cleanup();
-            this.emitFallbackSummary('sigterm');
             process.exit(0);
         });
         process.on('SIGINT', () => {
             this.log('🛑 SIGINT received, shutting down...');
             cleanup();
-            this.emitFallbackSummary('sigint');
             process.exit(0);
         });
         this.log('✅ FRAIM Local MCP Server ready');
@@ -1692,8 +1593,6 @@ FraimLocalMCPServer.AGENT_RESOLUTION_NOTICE = [
     'Replace all `agent.*` placeholders with the best value from repository context, user intent, and available project config.'
 ].join('\n');
 FraimLocalMCPServer.FALLBACK_ALERT_MARKER = 'PROXY_FALLBACK_ALERT';
-FraimLocalMCPServer.FALLBACK_SUMMARY_MARKER = 'PROXY_FALLBACK_SUMMARY';
-FraimLocalMCPServer.FALLBACK_HEADER = 'x-fraim-proxy-fallback-telemetry';
 FraimLocalMCPServer.SESSION_HEADER = 'x-fraim-session-id';
 // Start server if run directly
 if (require.main === module) {

package/dist/src/local-mcp-server/usage-collector.js

@@ -4,7 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UsageCollector = void 0;
+const mongodb_1 = require("mongodb");
 const axios_1 = __importDefault(require("axios"));
+// A placeholder ObjectId used when the real API key ID is not yet known.
+// The server will override this with the correct ID from the authenticated API key.
+const PLACEHOLDER_API_KEY_ID = new mongodb_1.ObjectId('000000000000000000000000');
 /**
  * Usage event collector for local MCP proxy
  * Collects usage events and batches them for upload
@@ -24,16 +28,15 @@ class UsageCollector {
      * Collect MCP tool call event
      */
     collectMCPCall(toolName, args, sessionId, success = true, duration) {
-        if (!this.apiKeyId) {
-            return; // Silently skip if no API key
-        }
         const parsed = this.parseMCPCall(toolName, args);
         if (!parsed)
             return;
         const event = {
             type: parsed.type,
             name: parsed.name,
-            apiKeyId: this.apiKeyId,
+            // Use set apiKeyId if available, otherwise a placeholder.
+            // The server will override this with the correct value from the auth token.
+            apiKeyId: this.apiKeyId || PLACEHOLDER_API_KEY_ID,
             sessionId,
             success
         };
@@ -46,13 +49,12 @@ class UsageCollector {
      * Collect usage event directly (for backward compatibility with tests)
      */
     collectEvent(type, name, sessionId, success = true, duration) {
-        if (!this.apiKeyId) {
-            return; // Silently skip if no API key
-        }
         const event = {
             type,
             name,
-            apiKeyId: this.apiKeyId,
+            // Use set apiKeyId if available, otherwise a placeholder.
+            // The server will override this with the correct value from the auth token.
+            apiKeyId: this.apiKeyId || PLACEHOLDER_API_KEY_ID,
             sessionId,
             success
         };

package/index.js

@@ -36,13 +36,13 @@ function runCLI() {
         // Solution: On Windows with shell: true, quote paths containing spaces.
         // On Unix with shell: false, pass the path unquoted (spawnSync handles it correctly).
         const isWindows = process.platform === 'win32';
-        
+
         // On Windows with shell, quote paths with spaces to prevent shell misinterpretation
         // On Unix without shell, pass path as-is (spawnSync handles spaces correctly)
-        const processedSrcPath = (isWindows && srcPath.includes(' ')) 
-            ? `"${srcPath}"` 
+        const processedSrcPath = (isWindows && srcPath.includes(' '))
+            ? `"${srcPath}"`
             : srcPath;
-        
+
         const result = spawnSync(
             'npx',
             ['tsx', processedSrcPath, ...process.argv.slice(2)],
@@ -66,7 +66,7 @@ function runCLI() {
 module.exports = {
     FRAIM_INFO: {
         name: 'FRAIM',
-        version: '2.0.54',
+        version: '2.0.93',
         repository: 'https://github.com/mathursrus/FRAIM'
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.93",
+  "version": "2.0.94",
   "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,10 +10,9 @@
   "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 && npm run build:fraim-brain && npm run build:config-schema && node scripts/copy-registry.js && npm run validate:registry && npm run validate:fraim-pro-assets && tsx scripts/validate-purity.ts",
+    "build": "tsc && npm run build:stubs && npm run build:fraim-brain && node scripts/copy-registry.js && node -e \"require('fs').copyFileSync('src/core/types.ts', 'registry/templates/manager/fraim-config-schema.ts')\" && npm run validate:registry && npm run validate:fraim-pro-assets && tsx scripts/validate-purity.ts",
     "build:stubs": "tsx scripts/build-stub-registry.ts",
     "build:fraim-brain": "node scripts/generate-fraim-brain.js",
-    "build:config-schema": "tsx scripts/generate-config-schema-template.ts",
     "test-all": "npm run test && npm run test:isolated && npm run test:ui",
     "test": "node scripts/test-with-server.js",
     "test:isolated": "npx tsx --test --test-reporter=spec tests/isolated/test-*.ts",