fraim 2.0.159 → 2.0.161

package/dist/src/core/fraim-config-schema.generated.js

@@ -8,10 +8,6 @@ exports.SUPPORTED_FRAIM_CONFIG_PATHS = exports.FRAIM_CONFIG_SCHEMA = void 0;
 exports.FRAIM_CONFIG_SCHEMA = {
     "kind": "object",
     "properties": {
-        "version": {
-            "kind": "string",
-            "required": true
-        },
         "project": {
             "kind": "object",
             "properties": {
@@ -487,7 +483,6 @@ exports.FRAIM_CONFIG_SCHEMA = {
     "required": true
 };
 exports.SUPPORTED_FRAIM_CONFIG_PATHS = [
-    "version",
     "project",
     "project.name",
     "project.industry",

package/dist/src/core/quality-evidence.js

@@ -267,6 +267,7 @@ function buildQualityRejectionMessage(jobName, currentPhase, errors) {
         ? [
             '```javascript',
             'evidence: {',
+            '  artifactPath: "<project-relative quality artifact path>",',
             '  quality: {',
             '    gateDecision: "<pass|flag|fail>",',
             '    interviewsAnalyzed: <number>,',
@@ -281,6 +282,7 @@ function buildQualityRejectionMessage(jobName, currentPhase, errors) {
             ? [
                 '```javascript',
                 'evidence: {',
+                '  artifactPath: "<project-relative quality artifact path>",',
                 '  quality: {',
                 '    composite: <number 0-10>,',
                 '    participant: { fit: <number 1-10>, urgency: <number 1-10>, authority: <number 1-10> },',
@@ -298,6 +300,7 @@ function buildQualityRejectionMessage(jobName, currentPhase, errors) {
             : [
                 '```javascript',
                 'evidence: {',
+                '  artifactPath: "<project-relative quality artifact path>",',
                 '  quality: {',
                 '    composite: <number 0-10>,',
                 '    coaching: "<actionable recommendation>",',
@@ -315,7 +318,7 @@ function buildQualityRejectionMessage(jobName, currentPhase, errors) {
     return [
         `❌ **Job completion rejected** for \`${jobName}\`.`,
         '',
-        `This job is required to emit a quality score on its final \`seekMentoring\` call so the result is captured in \`fraim_quality_scores\` for the quality dashboard. The following problems were found in \`evidence.quality\`:`,
+        `This job is required to emit quality evidence on its final \`seekMentoring\` call so the result is captured in \`fraim_quality_scores\` for the quality dashboard. The following problems were found:`,
         '',
         errorBullets,
         ...importantNote,

package/dist/src/core/types.js

@@ -9,7 +9,6 @@ exports.DEFAULT_FRAIM_CONFIG = void 0;
  * Default configuration values
  */
 exports.DEFAULT_FRAIM_CONFIG = {
-    version: '2.0.47',
     project: {
         name: 'Untitled Project'
     },

package/dist/src/first-run/session-service.js

@@ -507,7 +507,7 @@ class FirstRunSessionService {
                 fs_1.default.mkdirSync(prefix, { recursive: true });
                 row.streamOutput = 'Installing FRAIM on this machine...';
                 this.persist();
-                await runProcess('npm', ['install', '-g', 'fraim-framework@latest'], { npm_config_prefix: prefix });
+                await runProcess('npm', ['install', '-g', 'fraim@latest'], { npm_config_prefix: prefix });
             }
             persistShellPath();
             const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
@@ -752,7 +752,7 @@ class FirstRunSessionService {
             appendInstallLog(`hub-opened ${hubUrl}`);
             return {
                 ok: true,
-                message: `Hub is open at ${hubUrl}. From now on, run \`npx fraim-framework@latest hub --browser\` to launch it again — the standalone launcher binary ships in v2 (#355).`,
+                message: `Hub is open at ${hubUrl}. From now on, run \`npx fraim@latest hub --browser\` to launch it again — the standalone launcher binary ships in v2 (#355).`,
                 hubUrl,
             };
         }
@@ -761,7 +761,7 @@ class FirstRunSessionService {
             appendInstallLog(`hub-open-failed ${detail}`);
             return {
                 ok: false,
-                message: `Could not open the Hub automatically: ${detail}. Run \`npx fraim-framework@latest hub --browser\` from a terminal to open it manually.`,
+                message: `Could not open the Hub automatically: ${detail}. Run \`npx fraim@latest hub --browser\` from a terminal to open it manually.`,
             };
         }
     }

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

@@ -663,14 +663,28 @@ class FraimLocalMCPServer {
     }
     async performLocalCatalogSync(projectRoot) {
         const { runSync } = await Promise.resolve().then(() => __importStar(require('../cli/commands/sync')));
-        await runSync({
-            projectRoot,
-            skipUpdates: true,
-            local: this.shouldUseLocalSyncTarget(),
-            failHard: 'throw'
+        await this.runWithConsoleLogRedirectedToStderr(async () => {
+            await runSync({
+                projectRoot,
+                skipUpdates: true,
+                local: this.shouldUseLocalSyncTarget(),
+                failHard: 'throw'
+            });
         });
         this.writeLocalCatalogMetadata(projectRoot);
     }
+    async runWithConsoleLogRedirectedToStderr(operation) {
+        const originalLog = console.log;
+        console.log = (...args) => {
+            console.error(...args);
+        };
+        try {
+            return await operation();
+        }
+        finally {
+            console.log = originalLog;
+        }
+    }
     async ensureFreshLocalCatalogOnConnect(requestId) {
         if (process.env.FRAIM_DISABLE_SYNC_ON_CONNECT === '1') {
             this.latestConnectSyncWarning = null;
@@ -1863,7 +1877,7 @@ class FraimLocalMCPServer {
                     //
                     // When a QUALITY_PRODUCING_JOBS job reaches its final phase
                     // (nextPhase === null) with status === 'complete', the agent MUST
-                    // include a valid `evidence.quality` object. If invalid, swap the
+                    // include `evidence.artifactPath` and a valid `evidence.quality` object. If invalid, swap the
                     // accomplishment message for a rejection and DO NOT emit. If valid,
                     // fire-and-forget POST to /api/analytics/quality-score so the row
                     // lands in fraim_quality_scores.
@@ -1871,8 +1885,13 @@ class FraimLocalMCPServer {
                     const isFinalCompletion = args.status === 'complete' &&
                         (tutoringResponse.nextPhase === null || tutoringResponse.nextPhase === undefined);
                     if (isQualityJob && isFinalCompletion) {
-                        const qualityErrors = (0, quality_evidence_1.validateQualityEvidence)(args.evidence?.quality, args.jobName);
-                        if (qualityErrors) {
+                        const qualityErrors = [
+                            ...((0, quality_evidence_1.validateQualityEvidence)(args.evidence?.quality, args.jobName) || []),
+                            ...(typeof args.evidence?.artifactPath === 'string' && args.evidence.artifactPath.trim()
+                                ? []
+                                : ['evidence.artifactPath is required'])
+                        ];
+                        if (qualityErrors.length > 0) {
                             this.log(`❌ Quality enforcement rejected ${args.jobName} completion: ${qualityErrors.join('; ')}`);
                             const rejection = (0, quality_evidence_1.buildQualityRejectionMessage)(args.jobName, args.currentPhase, qualityErrors);
                             return await this.finalizeLocalToolTextResponse(request, requestSessionId, requestId, rejection);
@@ -1886,7 +1905,7 @@ class FraimLocalMCPServer {
                             jobId: args.jobId,
                             sessionId: requestSessionId || args.sessionId || 'unknown',
                             quality: args.evidence.quality,
-                            artifactPath: args.evidence.quality.artifactPath,
+                            artifactPath: args.evidence?.artifactPath,
                             repoIdentifier: args.evidence?.reviewContext?.repoIdentifier || this.repoInfo?.url,
                             reviewContext: {
                                 ...(args.evidence?.reviewContext || {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.159",
+  "version": "2.0.161",
   "description": "FRAIM CLI - Framework for Rigor-based AI Management (alias for fraim-framework)",
   "main": "index.js",
   "bin": {
@@ -151,6 +151,7 @@
     "nodemailer": "^8.0.3",
     "prompts": "^2.4.2",
     "resend": "^6.9.3",
+    "selfsigned": "^5.5.0",
     "semver": "^7.7.4",
     "stripe": "^20.3.1",
     "toml": "^3.0.0",

package/public/ai-hub/index.html

@@ -3,15 +3,18 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>AI Hub</title>
+  <meta name="color-scheme" content="light dark">
+  <title>FRAIM 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">
+  <!-- Detect Electron before CSS paints so body.electron rules apply on first render -->
+  <script>if(/Electron/.test(navigator.userAgent)){document.documentElement.classList.add('electron');}</script>
   <link rel="stylesheet" href="./styles.css">
 </head>
 <body>
 
   <div class="page">
 
-    <header class="header">
+    <header class="header" style="-webkit-app-region: drag;">
       <h1 class="header-title">Manage your FRAIM Employees</h1>
       <section class="welcome">
         Hi <strong class="you">there</strong>, remember, you are the
@@ -63,6 +66,7 @@
 
     <div class="layout">
       <aside class="rail">
+        <span id="tp-project-label" class="tp-project-label"></span>
         <button class="new-conv" type="button" id="new-conv-btn">+ New job</button>
         <div class="rail-note">Alpha: browser shell for directing employees across your project.</div>
         <section class="rail-section rail-section--employees">
@@ -76,6 +80,12 @@
         </section>
       </aside>
 
+      <div id="word-context-bar" class="word-context-bar" hidden>
+        <span class="word-ctx-icon">📄</span>
+        <span class="word-ctx-text" id="word-ctx-text"></span>
+        <button class="word-ctx-refresh" type="button" id="word-ctx-refresh" title="Refresh document context">↻</button>
+      </div>
+
       <main class="conversation" id="conversation">
         <div class="empty-state" id="empty">
           <h3>No job selected</h3>
@@ -241,6 +251,14 @@
             <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 id="word-context-card" class="word-context-card" hidden>
+            <div class="word-ctx-card-header">
+              <span class="word-ctx-card-icon">📄</span>
+              <span class="word-ctx-card-label" id="word-ctx-card-label">Document context</span>
+              <button type="button" class="word-ctx-card-toggle" id="word-ctx-card-toggle" aria-label="Expand document context">▸</button>
+            </div>
+            <div class="word-ctx-card-body" id="word-ctx-card-body" hidden></div>
+          </div>
           <div class="employee-line">
             <span class="employee-label">Employee:</span>
             <select id="employee-select" class="employee-select"></select>

package/public/ai-hub/powerpoint-taskpane/index.html

@@ -0,0 +1,236 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>FRAIM Hub</title>
+  <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>
+  <script src="config.js" type="text/javascript"></script>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    html, body { height: 100%; overflow: hidden; }
+    iframe { width: 100%; height: 100vh; border: none; display: block; }
+  </style>
+</head>
+<body>
+  <iframe id="hub" src="" allow="clipboard-read; clipboard-write"></iframe>
+  <script>
+    // PowerPoint task pane — mirrors extensions/office-word/taskpane.html so PPT
+    // gets the identical full Hub experience. It mounts the Hub /ai-hub/ surface in
+    // an iframe and bridges host context over postMessage using the same
+    // word-context / word-request / word-response contract the Hub already speaks
+    // (the names are the generic host-bridge protocol, not Word-specific).
+    //
+    // In Office Online the pane is served over HTTPS; loading an HTTP iframe from an
+    // HTTPS page is mixed-content-blocked, so use the pane's own origin there. On
+    // desktop (HTTP) use the direct Hub address.
+    var HUB_ORIGIN = window.location.protocol === 'https:'
+      ? window.location.origin
+      : (window.FRAIM_HUB_ORIGIN || 'http://127.0.0.1:43091');
+    var hubFrame = document.getElementById('hub');
+    var pendingPush = null;   // context queued before hub-ready fires
+    var hubReady = false;
+    var selectionHandlerAdded = false;
+
+    // ── postMessage bridge (inbound from Hub) ─────────────────────────────────
+    window.addEventListener('message', function(event) {
+      if (event.origin !== HUB_ORIGIN) return;
+      var msg = event.data || {};
+      if (msg.type === 'hub-ready') {
+        hubReady = true;
+        if (pendingPush) { pushToHub(pendingPush); pendingPush = null; }
+      } else if (msg.type === 'word-request') {
+        handleHostRequest(msg.action, msg.requestId, msg.payload || {});
+      }
+    });
+
+    function pushToHub(msg) {
+      if (hubFrame && hubFrame.contentWindow) {
+        hubFrame.contentWindow.postMessage(msg, HUB_ORIGIN);
+      }
+    }
+
+    // ── Reading PowerPoint context ──────────────────────────────────────────────
+    function docMeta() {
+      var meta = { docUrl: '', docTitle: '' };
+      try {
+        var doc = window.Office && Office.context && Office.context.document;
+        meta.docUrl = (doc && doc.url) ? doc.url : '';
+        if (meta.docUrl) {
+          var parts = meta.docUrl.replace(/\\/g, '/').split('/');
+          meta.docTitle = (parts[parts.length - 1] || '').replace(/\.[^.]+$/, '');
+        }
+      } catch(e) {}
+      return meta;
+    }
+
+    function readSelectionAsync(cb) {
+      try {
+        Office.context.document.getSelectedDataAsync(
+          Office.CoercionType.Text,
+          function(r) { cb(r.status === Office.AsyncResultStatus.Succeeded ? String(r.value || '').trim() : ''); }
+        );
+      } catch(e) { cb(''); }
+    }
+
+    // Read the current slide's text + speaker notes via the PowerPoint API.
+    function readSlideAsync(cb) {
+      try {
+        if (typeof PowerPoint !== 'undefined' && PowerPoint.run) {
+          PowerPoint.run(function(ctx) {
+            var slides = ctx.presentation.getSelectedSlides();
+            slides.load('items');
+            return ctx.sync().then(function() {
+              var slide = slides.items && slides.items[0];
+              if (!slide) { cb({ slideText: '', notes: '' }); return; }
+              var shapes = slide.shapes;
+              shapes.load('items/textFrame/textRange/text');
+              var ns = slide.notesSlide;
+              try { ns.load('notesTextFrame/textRange/text'); } catch(e) {}
+              return ctx.sync().then(function() {
+                var notes = '';
+                try { notes = ns.notesTextFrame.textRange.text || ''; } catch(e) {}
+                var slideText = (shapes.items || [])
+                  .map(function(s){ try { return s.textFrame.textRange.text || ''; } catch(e){ return ''; } })
+                  .filter(Boolean).join('\n');
+                cb({ slideText: slideText, notes: notes });
+              });
+            });
+          }).catch(function() { cb({ slideText: '', notes: '' }); });
+        } else { cb({ slideText: '', notes: '' }); }
+      } catch(e) { cb({ slideText: '', notes: '' }); }
+    }
+
+    function slideCountAsync(cb) {
+      try {
+        if (typeof PowerPoint !== 'undefined' && PowerPoint.run) {
+          PowerPoint.run(function(ctx) {
+            var slides = ctx.presentation.slides;
+            slides.load('items');
+            return ctx.sync().then(function() { cb((slides.items || []).length); });
+          }).catch(function() { cb(0); });
+        } else { cb(0); }
+      } catch(e) { cb(0); }
+    }
+
+    function readFullContext(cb) {
+      var meta = docMeta();
+      readSelectionAsync(function(selection) {
+        readSlideAsync(function(slide) {
+          slideCountAsync(function(count) {
+            var body = [slide.slideText, slide.notes ? ('Notes: ' + slide.notes) : ''].filter(Boolean).join('\n');
+            cb({
+              docUrl:       meta.docUrl,
+              docTitle:     meta.docTitle,
+              selection:    selection,
+              hasSelection: selection.length > 0,
+              bodyPreview:  body.slice(0, 2000),
+              wordCount:    body ? body.split(/\s+/).filter(Boolean).length : 0,
+              slideCount:   count,
+              comments:     [],
+            });
+          });
+        });
+      });
+    }
+
+    // ── Selection-change handler ───────────────────────────────────────────────
+    function addSelectionHandler() {
+      if (selectionHandlerAdded) return;
+      try {
+        Office.context.document.addHandlerAsync(
+          Office.EventType.DocumentSelectionChanged,
+          function() {
+            readSelectionAsync(function(sel) {
+              var m = docMeta();
+              pushToHub({ type: 'word-context-update', payload: {
+                docUrl: m.docUrl, docTitle: m.docTitle,
+                selection: sel, hasSelection: sel.length > 0,
+              }});
+            });
+          },
+          function(r) { if (r.status === Office.AsyncResultStatus.Succeeded) selectionHandlerAdded = true; }
+        );
+      } catch(e) {}
+    }
+
+    // ── Handling requests from Hub ─────────────────────────────────────────────
+    function handleHostRequest(action, requestId, payload) {
+      function respond(result) {
+        pushToHub({ type: 'word-response', requestId: requestId, payload: result });
+      }
+      if (action === 'get-context') {
+        readFullContext(function(ctx) { respond(ctx); });
+      } else if (action === 'get-selection') {
+        readSelectionAsync(function(sel) { respond({ selection: sel, hasSelection: sel.length > 0 }); });
+      } else if (action === 'insert-text') {
+        // Insert a new text box on the current slide with the given text.
+        try {
+          if (typeof PowerPoint !== 'undefined' && PowerPoint.run) {
+            PowerPoint.run(function(ctx) {
+              var slides = ctx.presentation.getSelectedSlides();
+              slides.load('items');
+              return ctx.sync().then(function() {
+                var slide = slides.items && slides.items[0];
+                if (!slide) throw new Error('No slide selected');
+                var box = slide.shapes.addTextBox(payload.text || '');
+                box.left = 50; box.top = 50; box.width = 600; box.height = 100;
+                return ctx.sync();
+              });
+            }).then(function() { respond({ ok: true }); }).catch(function(e) { respond({ ok: false, error: e.message }); });
+          } else { respond({ ok: false, error: 'PowerPoint API 1.1+ not available' }); }
+        } catch(e) { respond({ ok: false, error: e.message }); }
+      } else if (action === 'insert-after' || action === 'append-to-doc') {
+        // Append text into the current slide's speaker notes.
+        try {
+          if (typeof PowerPoint !== 'undefined' && PowerPoint.run) {
+            PowerPoint.run(function(ctx) {
+              var slides = ctx.presentation.getSelectedSlides();
+              slides.load('items');
+              return ctx.sync().then(function() {
+                var slide = slides.items && slides.items[0];
+                if (!slide) throw new Error('No slide selected');
+                var ns = slide.notesSlide;
+                ns.load('notesTextFrame/textRange/text');
+                return ctx.sync().then(function() {
+                  var existing = '';
+                  try { existing = ns.notesTextFrame.textRange.text || ''; } catch(e) {}
+                  ns.notesTextFrame.textRange.text = (existing ? existing + '\n' : '') + (payload.text || '');
+                  return ctx.sync();
+                });
+              });
+            }).then(function() { respond({ ok: true }); }).catch(function(e) { respond({ ok: false, error: e.message }); });
+          } else { respond({ ok: false, error: 'PowerPoint API not available' }); }
+        } catch(e) { respond({ ok: false, error: e.message }); }
+      } else {
+        respond({ ok: false, error: 'Unknown action: ' + action });
+      }
+    }
+
+    // ── Mount ─────────────────────────────────────────────────────────────────
+    function mountHub() {
+      var meta = docMeta();
+      var params = new URLSearchParams({ surface: 'task-pane' });
+      if (meta.docUrl)   params.set('docUrl',   meta.docUrl);
+      if (meta.docTitle) params.set('docTitle',  meta.docTitle);
+      hubFrame.src = HUB_ORIGIN + '/ai-hub/?' + params.toString();
+
+      hubFrame.addEventListener('load', function() {
+        setTimeout(function() {
+          readFullContext(function(ctx) {
+            var msg = { type: 'word-context', payload: ctx };
+            if (hubReady) { pushToHub(msg); } else { pendingPush = msg; }
+          });
+        }, 300);
+        addSelectionHandler();
+      });
+    }
+
+    if (typeof Office !== 'undefined') {
+      Office.onReady(function() { mountHub(); });
+    } else {
+      window.addEventListener('DOMContentLoaded', mountHub);
+    }
+  </script>
+</body>
+</html>

package/public/ai-hub/powerpoint-taskpane/manifest.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
+           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+           xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0"
+           xsi:type="TaskPaneApp">
+  <Id>e7a3c812-91fd-4b2e-8c15-d4f6a903b71e</Id>
+  <Version>1.0.0.0</Version>
+  <ProviderName>FRAIM</ProviderName>
+  <DefaultLocale>en-US</DefaultLocale>
+  <DisplayName DefaultValue="FRAIM"/>
+  <Description DefaultValue="FRAIM AI Hub in PowerPoint - analyze, draft, and improve presentations."/>
+  <IconUrl DefaultValue="http://127.0.0.1:43091/powerpoint-taskpane/icon-64.png"/>
+  <HighResolutionIconUrl DefaultValue="http://127.0.0.1:43091/powerpoint-taskpane/icon-64.png"/>
+  <SupportUrl DefaultValue="http://127.0.0.1:43091"/>
+  <AppDomains>
+    <AppDomain>https://appsforoffice.microsoft.com</AppDomain>
+  </AppDomains>
+  <Hosts>
+    <Host Name="Presentation"/>
+  </Hosts>
+  <Requirements>
+    <Sets>
+      <Set Name="PowerPointApi" MinVersion="1.1"/>
+    </Sets>
+  </Requirements>
+  <DefaultSettings>
+    <SourceLocation DefaultValue="http://127.0.0.1:43091/powerpoint-taskpane/"/>
+  </DefaultSettings>
+  <Permissions>ReadWriteDocument</Permissions>
+</OfficeApp>