fraim-framework 2.0.123 → 2.0.126

package/index.js

@@ -1,85 +1,85 @@
 #!/usr/bin/env node
-
-/**
- * FRAIM Framework - Smart Entry Point
- * This file handles both production (dist/) and development (src/) environments.
- */
-
-const path = require('path');
-const fs = require('fs');
-const { spawnSync } = require('child_process');
-
-/**
- * Runs the CLI using either the compiled JS or the source TS via tsx
- */
-function runCLI() {
-    const distPath = path.join(__dirname, 'dist', 'src', 'cli', 'fraim.js');
-    const srcPath = path.join(__dirname, 'src', 'cli', 'fraim.ts');
-
-    // 1. Check if we have a compiled version (Production / CI)
-    if (fs.existsSync(distPath)) {
-        require(distPath);
-        return;
-    }
-
-    // 2. Explicitly fail in production if dist/ is missing
-    if (process.env.NODE_ENV === 'production') {
-        console.error('❌ FRAIM Error: Production build (dist/) not found.');
-        console.error('In production environments, you must run the compiled version.');
-        console.error(`Expected: ${distPath}`);
-        process.exit(1);
-    }
-
-    // 3. Fallback to source version using tsx (Development)
-    if (fs.existsSync(srcPath)) {
-        // We use spawnSync to run tsx so we don't have to require it in memory
-        // if it's not needed, and it handles the process arguments correctly.
-        // 
-        // IMPORTANT FIX: Directory names with spaces and dashes (e.g., "FRAIM - Issue 166")
-        // cause argument parsing issues on Windows when shell: true is used.
-        // Without quoting, a path like "C:\...\FRAIM - Issue 166\src\cli\fraim.ts" gets
-        // split into multiple arguments, with the dash interpreted as a command flag,
-        // resulting in "error: unknown command '-'".
-        // 
-        // 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}"`
-            : srcPath;
-
-        const result = spawnSync(
-            'npx',
-            ['tsx', processedSrcPath, ...process.argv.slice(2)],
-            {
-                stdio: 'inherit',
-                shell: isWindows, // Windows needs shell for npx, Unix doesn't
-                windowsHide: true
-            }
-        );
-        process.exit(result.status || 0);
-    }
-
-    console.error('❌ FRAIM Error: Could not find CLI entry point.');
-    console.error('Expected one of:');
-    console.error(` - ${distPath}`);
-    console.error(` - ${srcPath}`);
-    process.exit(1);
-}
-
-// Global programmatic exports
-module.exports = {
-    FRAIM_INFO: {
-        name: 'FRAIM',
-        version: '2.0.98',
-        repository: 'https://github.com/mathursrus/FRAIM'
-    }
-};
-
-// If this file is run directly (via npx or global link), run the CLI
-if (require.main === module) {
-    runCLI();
+
+/**
+ * FRAIM Framework - Smart Entry Point
+ * This file handles both production (dist/) and development (src/) environments.
+ */
+
+const path = require('path');
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+/**
+ * Runs the CLI using either the compiled JS or the source TS via tsx
+ */
+function runCLI() {
+    const distPath = path.join(__dirname, 'dist', 'src', 'cli', 'fraim.js');
+    const srcPath = path.join(__dirname, 'src', 'cli', 'fraim.ts');
+
+    // 1. Check if we have a compiled version (Production / CI)
+    if (fs.existsSync(distPath)) {
+        require(distPath);
+        return;
+    }
+
+    // 2. Explicitly fail in production if dist/ is missing
+    if (process.env.NODE_ENV === 'production') {
+        console.error('❌ FRAIM Error: Production build (dist/) not found.');
+        console.error('In production environments, you must run the compiled version.');
+        console.error(`Expected: ${distPath}`);
+        process.exit(1);
+    }
+
+    // 3. Fallback to source version using tsx (Development)
+    if (fs.existsSync(srcPath)) {
+        // We use spawnSync to run tsx so we don't have to require it in memory
+        // if it's not needed, and it handles the process arguments correctly.
+        // 
+        // IMPORTANT FIX: Directory names with spaces and dashes (e.g., "FRAIM - Issue 166")
+        // cause argument parsing issues on Windows when shell: true is used.
+        // Without quoting, a path like "C:\...\FRAIM - Issue 166\src\cli\fraim.ts" gets
+        // split into multiple arguments, with the dash interpreted as a command flag,
+        // resulting in "error: unknown command '-'".
+        // 
+        // 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}"`
+            : srcPath;
+
+        const result = spawnSync(
+            'npx',
+            ['tsx', processedSrcPath, ...process.argv.slice(2)],
+            {
+                stdio: 'inherit',
+                shell: isWindows, // Windows needs shell for npx, Unix doesn't
+                windowsHide: true
+            }
+        );
+        process.exit(result.status || 0);
+    }
+
+    console.error('❌ FRAIM Error: Could not find CLI entry point.');
+    console.error('Expected one of:');
+    console.error(` - ${distPath}`);
+    console.error(` - ${srcPath}`);
+    process.exit(1);
+}
+
+// Global programmatic exports
+module.exports = {
+    FRAIM_INFO: {
+        name: 'FRAIM',
+        version: '2.0.98',
+        repository: 'https://github.com/mathursrus/FRAIM'
+    }
+};
+
+// If this file is run directly (via npx or global link), run the CLI
+if (require.main === module) {
+    runCLI();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.123",
+  "version": "2.0.126",
   "description": "FRAIM: AI Workforce Infrastructure — the organizational capability that turns AI agents into an accountable workforce, their operators into capable AI managers, and executives into leaders with clear optics on AI proficiency.",
   "main": "index.js",
   "bin": {
@@ -32,6 +32,7 @@
     "manage-teams": "tsx scripts/fraim/manage-teams.ts",
     "partner-discounts": "tsx scripts/fraim/manage-partner-discounts.ts",
     "fix-key": "tsx scripts/fraim/fix-expired-key.ts",
+    "backfill:persona-entitlements": "tsx scripts/backfill-persona-entitlements.ts",
     "setup-stripe-webhook": "tsx scripts/fraim/setup-stripe-webhook.ts",
     "view-signups": "tsx scripts/view-signups.ts",
     "fraim:init": "npm run build && node index.js init",
@@ -126,6 +127,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "overrides": {
+    "uuid": "^14.0.0"
+  },
   "dependencies": {
     "@octokit/rest": "^22.0.1",
     "adm-zip": "^0.5.16",

package/dist/src/cli/services/device-flow-service.js

@@ -1,83 +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.DeviceFlowService = void 0;
-const axios_1 = __importDefault(require("axios"));
-const chalk_1 = __importDefault(require("chalk"));
-class DeviceFlowService {
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Start the Device Flow Login
-     */
-    async login() {
-        console.log(chalk_1.default.blue('\n🔗 Starting Authentication...'));
-        try {
-            // 1. Request device and user codes
-            const deviceCode = await this.requestDeviceCode();
-            console.log(chalk_1.default.yellow('\nACTION REQUIRED:'));
-            console.log(`1. Go to: ${chalk_1.default.cyan.underline(deviceCode.verification_uri)}`);
-            console.log(`2. Enter the code: ${chalk_1.default.bold.green(deviceCode.user_code)}`);
-            console.log(chalk_1.default.gray(`\nWaiting for authorization (expires in ${Math.floor(deviceCode.expires_in / 60)} minutes)...`));
-            // 2. Poll for the access token
-            const token = await this.pollForToken(deviceCode.device_code, deviceCode.interval);
-            console.log(chalk_1.default.green('\n✅ Authentication Successful!'));
-            return token;
-        }
-        catch (error) {
-            console.error(chalk_1.default.red(`\n❌ Authentication failed: ${error.message}`));
-            throw error;
-        }
-    }
-    async requestDeviceCode() {
-        const response = await axios_1.default.post(this.config.authUrl, {
-            client_id: this.config.clientId,
-            scope: this.config.scope
-        }, {
-            headers: { Accept: 'application/json' }
-        });
-        return response.data;
-    }
-    async pollForToken(deviceCode, interval) {
-        let currentInterval = interval * 1000;
-        return new Promise((resolve, reject) => {
-            const poll = async () => {
-                try {
-                    const response = await axios_1.default.post(this.config.tokenUrl, {
-                        client_id: this.config.clientId,
-                        device_code: deviceCode,
-                        grant_type: 'urn:ietf:params:oauth:grant-type:device_code'
-                    }, {
-                        headers: { Accept: 'application/json' }
-                    });
-                    if (response.data.access_token) {
-                        resolve(response.data.access_token);
-                        return;
-                    }
-                    if (response.data.error) {
-                        const error = response.data.error;
-                        if (error === 'authorization_pending') {
-                            // Keep polling
-                            setTimeout(poll, currentInterval);
-                        }
-                        else if (error === 'slow_down') {
-                            currentInterval += 5000;
-                            setTimeout(poll, currentInterval);
-                        }
-                        else {
-                            reject(new Error(response.data.error_description || error));
-                        }
-                    }
-                }
-                catch (error) {
-                    reject(error);
-                }
-            };
-            setTimeout(poll, currentInterval);
-        });
-    }
-}
-exports.DeviceFlowService = DeviceFlowService;

package/dist/src/local-mcp-server/prometheus-scraper.js

@@ -1,152 +0,0 @@
-"use strict";
-/**
- * Prometheus Scraper for Claude Code OTel Token Usage Metrics
- *
- * Scrapes Claude Code's local Prometheus endpoint to capture cumulative
- * token usage counters. Returns raw snapshot values — delta computation
- * happens server-side per architecture constraint 15.2.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parsePrometheusText = parsePrometheusText;
-exports.extractTokenSnapshot = extractTokenSnapshot;
-exports.scrapeTokenSnapshot = scrapeTokenSnapshot;
-/** Candidate Prometheus endpoint ports (OTel SDK defaults) */
-const CANDIDATE_PORTS = [9464, 8888];
-/** Candidate metric names for token usage (OTel dots→underscores, optional suffixes) */
-const TOKEN_METRIC_CANDIDATES = [
-    'claude_code_token_usage_total',
-    'claude_code_token_usage',
-    'claude_code_token_usage_tokens_total',
-    'claude_code_token_usage_tokens',
-];
-/** Candidate metric names for cost usage */
-const COST_METRIC_CANDIDATES = [
-    'claude_code_cost_usage_total',
-    'claude_code_cost_usage',
-    'claude_code_cost_usage_usd_total',
-    'claude_code_cost_usage_usd',
-];
-/**
- * Parse Prometheus text exposition format into structured metrics.
- *
- * Format per line:  metric_name{label1="val1",label2="val2"} value [timestamp]
- * Lines starting with # are comments (HELP, TYPE). Empty lines are skipped.
- */
-function parsePrometheusText(text) {
-    const results = [];
-    for (const line of text.split('\n')) {
-        if (line.startsWith('#') || line.trim() === '')
-            continue;
-        // Match: metric_name{labels} value
-        const labeledMatch = line.match(/^([a-zA-Z_:][a-zA-Z0-9_:]*)\{([^}]*)\}\s+([\d.eE+-]+)/);
-        if (labeledMatch) {
-            const [, name, labelsStr, valueStr] = labeledMatch;
-            const labels = {};
-            for (const pair of labelsStr.matchAll(/(\w+)="([^"]*)"/g)) {
-                labels[pair[1]] = pair[2];
-            }
-            results.push({ name, labels, value: parseFloat(valueStr) });
-            continue;
-        }
-        // Match: metric_name value (no labels)
-        const noLabelMatch = line.match(/^([a-zA-Z_:][a-zA-Z0-9_:]*)\s+([\d.eE+-]+)/);
-        if (noLabelMatch) {
-            const [, name, valueStr] = noLabelMatch;
-            results.push({ name, labels: {}, value: parseFloat(valueStr) });
-        }
-    }
-    return results;
-}
-/**
- * Extract a TokenSnapshot from parsed Prometheus metrics.
- * Tries multiple candidate metric names for resilience to SDK version changes.
- */
-function extractTokenSnapshot(metrics) {
-    const snapshot = {
-        inputTokens: 0,
-        outputTokens: 0,
-        cacheReadTokens: 0,
-        cacheCreationTokens: 0,
-        costUsd: 0,
-        claudeSessionId: null,
-        model: null,
-        capturedAt: new Date(),
-    };
-    for (const m of metrics) {
-        if (TOKEN_METRIC_CANDIDATES.includes(m.name)) {
-            const type = m.labels['type'];
-            switch (type) {
-                case 'input':
-                    snapshot.inputTokens = m.value;
-                    break;
-                case 'output':
-                    snapshot.outputTokens = m.value;
-                    break;
-                case 'cacheRead':
-                    snapshot.cacheReadTokens = m.value;
-                    break;
-                case 'cacheCreation':
-                    snapshot.cacheCreationTokens = m.value;
-                    break;
-            }
-            snapshot.claudeSessionId = m.labels['session_id'] || snapshot.claudeSessionId;
-            snapshot.model = m.labels['model'] || snapshot.model;
-        }
-        if (COST_METRIC_CANDIDATES.includes(m.name)) {
-            snapshot.costUsd += m.value;
-            snapshot.claudeSessionId = m.labels['session_id'] || snapshot.claudeSessionId;
-        }
-    }
-    return snapshot;
-}
-/**
- * Attempt to fetch Prometheus metrics from a candidate endpoint.
- * Returns response text or null on failure.
- */
-async function tryFetch(port, timeoutMs) {
-    try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), timeoutMs);
-        const resp = await fetch(`http://localhost:${port}/metrics`, {
-            signal: controller.signal,
-        });
-        clearTimeout(timeout);
-        if (resp.ok) {
-            return await resp.text();
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Scrape Claude Code's Prometheus endpoint and return a TokenSnapshot.
- *
- * Returns null if:
- * - Prometheus endpoint is not available (OTel not enabled)
- * - Scrape times out (>2s by default)
- * - No matching token metrics found
- *
- * @param log Optional logging function for debug output
- */
-async function scrapeTokenSnapshot(log) {
-    const configuredPort = process.env.FRAIM_PROMETHEUS_PORT;
-    const ports = configuredPort ? [parseInt(configuredPort, 10)] : CANDIDATE_PORTS;
-    const timeoutMs = 2000;
-    for (const port of ports) {
-        const text = await tryFetch(port, timeoutMs);
-        if (text && text.includes('#')) {
-            const metrics = parsePrometheusText(text);
-            const snapshot = extractTokenSnapshot(metrics);
-            // Only return if we actually found token metrics
-            if (snapshot.inputTokens > 0 || snapshot.outputTokens > 0) {
-                log?.(`Captured token snapshot from localhost:${port} (input=${snapshot.inputTokens}, output=${snapshot.outputTokens})`);
-                return snapshot;
-            }
-            log?.(`Prometheus endpoint found at localhost:${port} but no token metrics matched`);
-        }
-    }
-    log?.('No Prometheus endpoint available — token snapshot skipped');
-    return null;
-}