fraim-framework 2.0.124 → 2.0.127

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

@@ -14,6 +14,9 @@ class UsageCollector {
         this.events = [];
         this.userId = null;
         this.repoIdentifier = null;
+        // Issue #330: per-session agent attribution captured at fraim_connect.
+        this.agentName = null;
+        this.agentModel = null;
     }
     static resolveMentoringJobName(args) {
         if (!args || typeof args !== 'object') {
@@ -40,6 +43,16 @@ class UsageCollector {
     setRepoIdentifier(repoIdentifier) {
         this.repoIdentifier = repoIdentifier;
     }
+    /**
+     * Capture the agent identity at fraim_connect time so subsequent events
+     * can be attributed to the right agent without re-reading args.
+     */
+    setAgent(name, model) {
+        this.agentName = name ? name.toLowerCase() : null;
+        this.agentModel = model || null;
+    }
+    getAgentName() { return this.agentName; }
+    getAgentModel() { return this.agentModel; }
     /**
      * Collect MCP tool call event
      */
@@ -67,6 +80,8 @@ class UsageCollector {
             success,
             category: parsed.category,
             repoIdentifier: this.repoIdentifier || undefined,
+            agentName: this.agentName || undefined,
+            agentModel: this.agentModel || undefined,
             args: Object.keys(analyticsArgs).length > 0 ? analyticsArgs : undefined
         };
         this.events.push(event);
@@ -178,6 +193,16 @@ class UsageCollector {
             this.events[this.events.length - 1].tokenSnapshot = snapshot;
         }
     }
+    /**
+     * Issue #330: when a token capture adapter returns null, record the
+     * typed reason on the most recently queued event so the dashboard
+     * can explain coverage gaps to the user.
+     */
+    attachCaptureUnavailable(reason) {
+        if (this.events.length > 0) {
+            this.events[this.events.length - 1].tokenCaptureUnavailableReason = reason;
+        }
+    }
     /**
      * Get current event count
      */

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.124",
+  "version": "2.0.127",
   "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",
@@ -113,10 +114,12 @@
     "dist/src/local-mcp-server/",
     "dist/src/cli/",
     "dist/src/ai-hub/",
+    "dist/src/first-run/",
     "dist/src/core/",
     "bin/fraim.js",
     "bin/fraim-mcp.js",
     "public/ai-hub/",
+    "public/first-run/",
     "index.js",
     "README.md",
     "CHANGELOG.md",
@@ -126,6 +129,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "overrides": {
+    "uuid": "^14.0.0"
+  },
   "dependencies": {
     "@octokit/rest": "^22.0.1",
     "adm-zip": "^0.5.16",

package/public/ai-hub/index.html

@@ -3,127 +3,174 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Visa AI Hub</title>
-  <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 48 48'%3E%3Crect width='48' height='48' rx='10' fill='%230d3f8a'/%3E%3Cpath d='M13 31h6l3-14h-6zm10 0h6l3-14h-6zm11-14h-6l-3 14h6z' fill='%23f7b600'/%3E%3C/svg%3E">
+  <title>AI Hub</title>
+  <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 48 48'%3E%3Crect width='48' height='48' rx='10' fill='%233d8a6e'/%3E%3Ctext x='24' y='32' text-anchor='middle' font-family='Helvetica,Arial,sans-serif' font-size='22' font-weight='700' fill='white'%3EH%3C/text%3E%3C/svg%3E">
   <link rel="stylesheet" href="./styles.css">
 </head>
 <body>
-  <div class="app-shell">
-    <header class="app-header">
-      <div class="brand-lockup">
-        <p class="brand-title">Visa AI Hub</p>
-        <p class="brand-subtitle">Powered by <a href="https://fraimworks.ai" target="_blank" rel="noreferrer">FRAIM</a></p>
-      </div>
-      <div class="topbar-card workspace-card">
-        <div class="workspace-section workspace-section-inline">
-          <span class="section-label">Employee</span>
-          <div class="employee-picker" id="employee-picker"></div>
-        </div>
-        <details class="project-path workspace-project">
-          <summary>
-            <span>Project Path</span>
-            <span class="project-path-preview" id="project-path-preview"></span>
-          </summary>
-          <div class="project-path-body">
-            <input id="project-path-input" class="text-input" type="text" />
-            <div class="project-actions">
-              <button id="browse-project" class="secondary-button" type="button">Choose Folder</button>
-              <button id="reload-project" class="secondary-button" type="button">Reload</button>
-            </div>
-            <p class="helper-text" id="project-status"></p>
-          </div>
-        </details>
-      </div>
+
+  <div class="page">
+
+    <header class="header">
+      <h1>AI Hub</h1>
+      <button class="project-button" type="button" id="project-button">
+        <span class="folder">Project</span>
+        <strong id="project-name">Choose a folder</strong>
+      </button>
     </header>
 
-    <main class="workspace">
-      <section class="workspace-intro card">
-        <div class="workspace-intro-copy">
-          <p class="section-label">Pick A Job</p>
-          <p class="panel-intro">Manage your AI employees just like you manage your teams. Tell them what jobs they need to complete, review their results, coach them, expect them to learn from you, and expect to learn from your employees.</p>
-        </div>
-        <div class="workspace-intro-actions">
-          <p class="section-label">Job Category</p>
-          <div class="category-picker" id="category-picker"></div>
-        </div>
-      </section>
-
-      <section class="job-panel">
-        <div class="panel-head card">
-          <div class="panel-copy">
-            <p class="section-label">Job Category</p>
-            <h2 class="panel-title">Pick a job</h2>
-            <p class="muted">Choose the next assignment for your employee.</p>
-          </div>
-        </div>
+    <section class="welcome">
+      Hi <strong class="you">there</strong>, remember, you are the
+      <span class="concept">AI Manager<button class="info" data-concept="manager" aria-label="What is AI Manager?">i</button>
+        <span class="popover" id="pop-manager">
+          <span class="pop-title">AI Manager</span>
+          That's you. You decide what outcome matters, pick the right job, and hold the bar on quality. You're not writing the work — you're directing it.
+          <a class="pop-link" href="#" data-target="jobs-manager">See manager jobs →</a>
+          <span class="pop-jobs" id="jobs-manager"></span>
+        </span></span>.
+      Delegate jobs to your
+      <span class="concept">AI Employees<button class="info" data-concept="employee" aria-label="What is AI Employee?">i</button>
+        <span class="popover" id="pop-employee">
+          <span class="pop-title">AI Employee</span>
+          The coding agent — Codex, Claude, or another — that actually does the work you assign. AI Hub is where you direct them; the agent itself is the employee.
+          <a class="pop-link" href="#" data-target="jobs-employee">See employee jobs →</a>
+          <span class="pop-jobs" id="jobs-employee"></span>
+        </span></span>,
+      <span class="concept">Coach<button class="info" data-concept="coach" aria-label="What is Coach?">i</button>
+        <span class="popover" id="pop-coach">
+          <span class="pop-title">Coach</span>
+          Add context, raise the bar, or correct course mid-flight without abandoning the conversation. Same job, sharper guidance.
+          <a class="pop-link" href="#" data-target="jobs-coach">See coaching jobs →</a>
+          <span class="pop-jobs" id="jobs-coach"></span>
+        </span></span>
+      them,
+      <span class="concept">Verify<button class="info" data-concept="verify" aria-label="What is Verify?">i</button>
+        <span class="popover" id="pop-verify">
+          <span class="pop-title">Verify</span>
+          Check that the artifact actually solved the problem before you trust completion. Read the result, not just the logs.
+          <a class="pop-link" href="#" data-target="jobs-verify">See verification jobs →</a>
+          <span class="pop-jobs" id="jobs-verify"></span>
+        </span></span>
+      their work, and expect them to
+      <span class="concept">Learn<button class="info" data-concept="learn" aria-label="What is Learn?">i</button>
+        <span class="popover" id="pop-learn">
+          <span class="pop-title">Learn</span>
+          Each run should make the next one better. Your coaching becomes their lasting habit.
+          <a class="pop-link" href="#" data-target="jobs-learn">See learning jobs →</a>
+          <span class="pop-jobs" id="jobs-learn"></span>
+        </span></span>
+      and get better. Let your employees make you shine.
+    </section>
 
-        <div class="job-list-card card">
-          <div class="job-list" id="job-list"></div>
+    <div class="layout">
+      <aside class="rail">
+        <button class="new-conv" type="button" id="new-conv-btn">+ New job</button>
+        <div class="conv-list" id="conv-list"></div>
+      </aside>
+
+      <main class="conversation" id="conversation">
+        <div class="empty-state" id="empty">
+          <h3>No job selected</h3>
+          <p>Pick an existing job from the left, or click <strong>+ New job</strong> to give your employee something to work on.</p>
         </div>
-      </section>
-
-      <section class="interaction-panel">
-        <div class="card interaction-card">
-          <div class="run-toolbar">
-            <div class="selected-job-summary">
-              <div>
-                <p class="section-label">Selected Job</p>
-                <h2 id="selected-job-title">Select a job</h2>
-                <p id="selected-job-intent" class="muted"></p>
-              </div>
-              <ul class="job-outcomes" id="selected-job-outcomes"></ul>
-            </div>
-            <div class="run-toolbar-actions">
-              <button id="start-job" class="primary-button" type="button" disabled>Start Job</button>
-            </div>
+
+        <div id="active-conv" hidden>
+          <div class="conv-header">
+            <h2 id="active-title"></h2>
+            <div class="conv-job" id="active-job"></div>
+            <div id="artifact-slot"></div>
           </div>
 
-          <div class="interaction-body">
-            <div class="conversation-column">
-              <div class="interaction-head">
-                <div>
-                  <p class="section-label">Manager / Employee Interactions</p>
-                  <h2 id="conversation-title">No active job</h2>
-                </div>
-                <p class="muted" id="conversation-state">Select a job and coach your employee toward your desired outcome.</p>
-              </div>
-
-              <div class="timeline" id="timeline"></div>
-            </div>
+          <!-- Issue #347 R1: pizza tracker. Hidden when the active job
+               declares no phases. Populated by renderTracker() in script.js. -->
+          <div class="tracker" id="tracker" aria-label="Job progress" hidden>
+            <div class="tracker-rows" id="tracker-rows"></div>
+            <div class="tracker-note" id="tracker-note" hidden></div>
+          </div>
 
-            <div class="manager-tools">
-              <div class="template-row">
-                <span class="section-label">Manager Templates</span>
-                <div class="template-chips" id="manager-templates"></div>
-              </div>
+          <div class="progress" id="progress">
+            <span class="stage" id="stage">Getting started…</span>
+            <span class="latest" id="latest"></span>
+          </div>
 
-              <label class="composer-label" for="manager-message">Coach your employee toward your desired outcome.</label>
-              <textarea id="manager-message" class="composer" placeholder='Use FRAIM job "marketing-content-creation" and include the audience, desired outcome, and any constraints.'></textarea>
+          <div class="messages" id="messages"></div>
 
-              <div class="composer-actions">
-                <button id="send-coaching" class="secondary-button" type="button" disabled>Send Coaching</button>
-              </div>
+          <div class="coach">
+            <div class="section-title">Coach the employee</div>
+            <textarea id="coach-text" placeholder="Tell the employee what to do next…"></textarea>
+            <div class="coach-actions">
+              <!-- Issue #347 R2: template picker. Hidden when the project
+                   has no manager-job templates. -->
+              <button class="ghost" type="button" id="template-picker-btn" aria-haspopup="menu" aria-expanded="false" hidden>Use a template ▾</button>
+              <button class="send-button" type="button" id="send" disabled>Send</button>
+              <div class="template-popover" id="template-popover" role="menu" hidden></div>
             </div>
+            <!-- Issue #347 R4: run-level totals. Discoverable, not dominating.
+                 Populated by renderTotals() each poll tick. -->
+            <div class="totals" id="totals" aria-label="Run totals" hidden></div>
           </div>
+
+          <details class="micro" id="micro-manage">
+            <summary>Micro-manage — raw host details</summary>
+            <pre class="micro-log" id="micro-log"></pre>
+          </details>
         </div>
+      </main>
+    </div>
 
-        <details class="card micro-manage" id="micro-manage">
-          <summary>Micro-manage</summary>
-          <div class="micro-manage-body" id="raw-history"></div>
-        </details>
-      </section>
-    </main>
+    <p class="status-line" id="status-line" role="status" aria-live="polite"></p>
   </div>
 
-  <template id="timeline-message-template">
-    <article class="message">
-      <div class="message-meta">
-        <span class="message-role"></span>
-        <time class="message-time"></time>
+  <!-- Modal: New Job -->
+  <div class="modal-backdrop" id="modal" role="dialog" aria-modal="true" hidden>
+    <div class="modal">
+
+      <div id="step1">
+        <div class="modal-header">
+          <h2>What should the employee work on?</h2>
+          <p>Pick one job. You can always start a new job for different work.</p>
+        </div>
+        <div class="modal-body">
+          <input class="search" type="text" placeholder="Search jobs…" id="job-search">
+          <div id="job-catalog"></div>
+        </div>
+        <div class="modal-footer">
+          <span class="left" id="job-pick-status">Choose a job to continue</span>
+          <div class="right">
+            <button class="ghost" type="button" id="cancel1">Cancel</button>
+            <button class="send-button" type="button" id="next1" disabled>Next →</button>
+          </div>
+        </div>
       </div>
-      <p class="message-text"></p>
-    </article>
-  </template>
+
+      <div id="step2" class="step2" hidden>
+        <div class="modal-header">
+          <h2>Tell the employee what you need</h2>
+          <p>A few sentences is enough. The employee will ask if anything is unclear.</p>
+        </div>
+        <div class="modal-body">
+          <div class="assigned-job">
+            <div class="label">Assigned job</div>
+            <div class="name" id="picked-name"></div>
+            <div class="desc" id="picked-desc"></div>
+          </div>
+          <textarea id="instructions" placeholder="What outcome do you want? Any context the employee should know?"></textarea>
+          <div class="employee-line">
+            <span class="employee-label">Employee:</span>
+            <select id="employee-select" class="employee-select"></select>
+          </div>
+        </div>
+        <div class="modal-footer">
+          <span class="left">You can coach the employee with more detail after they start.</span>
+          <div class="right">
+            <button class="ghost" type="button" id="back2">← Back</button>
+            <button class="send-button" type="button" id="start" disabled>Start</button>
+          </div>
+        </div>
+      </div>
+
+    </div>
+  </div>
 
   <script src="./script.js"></script>
 </body>