fraim 2.0.160 → 2.0.161

package/dist/src/ai-hub/desktop-main.js

@@ -82,22 +82,23 @@ function ensureLoginItem() {
 // ---------------------------------------------------------------------------
 // Word manifest sideload (runs once on first launch)
 // ---------------------------------------------------------------------------
-function ensureWordSideload(projectPath) {
+function ensureWordSideload(projectPath, httpPort) {
     // Flag version bump: bump this string when new manifests are added so all
     // users get re-sideloaded on their next launch.
-    const FLAG_VERSION = 'v3-filepath';
+    const FLAG_VERSION = 'v4-dynamic-port';
+    const expectedFlag = `${FLAG_VERSION}:${httpPort}`;
     const flagPath = path_1.default.join(electron_1.app.getPath('userData'), 'word-sideloaded.flag');
-    if (fs_1.default.existsSync(flagPath) && fs_1.default.readFileSync(flagPath, 'utf8').trim() === FLAG_VERSION)
+    if (fs_1.default.existsSync(flagPath) && fs_1.default.readFileSync(flagPath, 'utf8').trim() === expectedFlag)
         return;
-    if (!(0, office_sideload_1.isSideloaded)()) {
-        const result = (0, office_sideload_1.sideloadManifest)(projectPath);
+    if (httpPort > 0) {
+        const result = (0, office_sideload_1.sideloadManifest)(projectPath, { httpPort, userDataDir: electron_1.app.getPath('userData') });
         if (!result.ok) {
             console.warn('[fraim] Office sideload skipped:', result.reason);
             return; // don't write flag — retry next launch
         }
     }
     fs_1.default.mkdirSync(path_1.default.dirname(flagPath), { recursive: true });
-    fs_1.default.writeFileSync(flagPath, FLAG_VERSION);
+    fs_1.default.writeFileSync(flagPath, expectedFlag);
 }
 // ---------------------------------------------------------------------------
 // Tray setup
@@ -217,10 +218,8 @@ function stopServerOnce() {
 // Launch
 // ---------------------------------------------------------------------------
 async function launchDesktopShell(options) {
-    const [httpPort, httpsPort] = await Promise.all([
-        (0, server_1.findAvailablePort)(options.preferredPort),
-        (0, server_1.findAvailablePort)(43092),
-    ]);
+    const httpPort = await (0, server_1.findAvailablePort)(options.preferredPort);
+    const httpsPort = await (0, server_1.findAvailablePortExcluding)(43092, new Set([httpPort]));
     // Generate (or load cached) self-signed cert for HTTPS.
     // Fast on subsequent launches (file read); ~200ms on first launch (key gen).
     const certBundle = await (0, cert_store_1.loadOrCreateCert)();
@@ -239,7 +238,7 @@ async function launchDesktopShell(options) {
         },
     });
     await server.start(httpPort);
-    ensureWordSideload(options.projectPath);
+    ensureWordSideload(options.projectPath, httpPort);
     const hubUrl = `http://127.0.0.1:${httpPort}/ai-hub/`;
     createTray(hubUrl);
     await createWindow(hubUrl);

package/dist/src/ai-hub/office-sideload.js

@@ -22,6 +22,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.manifestXmlForPort = manifestXmlForPort;
 exports.isSideloaded = isSideloaded;
 exports.sideloadManifest = sideloadManifest;
 exports.removeSideload = removeSideload;
@@ -56,6 +57,22 @@ function resolveManifestPath(entry, projectPath) {
 function macWefPath(container, guid) {
     return path_1.default.join(os_1.default.homedir(), 'Library', 'Containers', container, 'Data', 'Documents', 'wef', `${guid}.xml`);
 }
+function generatedManifestPath(entry, userDataDir) {
+    return path_1.default.join(userDataDir, 'office-manifests', entry.guid, 'manifest.xml');
+}
+function manifestXmlForPort(xml, httpPort) {
+    return xml.replace(/(https?:\/\/(?:localhost|127\.0\.0\.1)):43091/g, `$1:${httpPort}`);
+}
+function prepareManifestForSideload(entry, sourcePath, options) {
+    if (!options.httpPort)
+        return sourcePath;
+    const userDataDir = options.userDataDir || path_1.default.join(os_1.default.homedir(), '.fraim');
+    const dest = generatedManifestPath(entry, userDataDir);
+    const rendered = manifestXmlForPort(fs_1.default.readFileSync(sourcePath, 'utf8'), options.httpPort);
+    fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
+    fs_1.default.writeFileSync(dest, rendered, { encoding: 'utf8' });
+    return dest;
+}
 // ---------------------------------------------------------------------------
 // Windows registry helpers
 // ---------------------------------------------------------------------------
@@ -92,17 +109,18 @@ function isManifestSideloaded(m) {
  * Sideloads all manifests. Returns ok:true if every manifest was registered.
  * Returns ok:false with the first failure reason.
  */
-function sideloadManifest(projectPath) {
+function sideloadManifest(projectPath, options = {}) {
     for (const entry of MANIFESTS) {
         const manifestPath = resolveManifestPath(entry, projectPath);
         if (!manifestPath) {
             return { ok: false, reason: `Manifest not found for GUID ${entry.guid} — check extensions/office-word/ and public/ai-hub/powerpoint-taskpane/` };
         }
+        const sideloadPath = prepareManifestForSideload(entry, manifestPath, options);
         if (process.platform === 'win32') {
             // Developer-key value = absolute file path to manifest.xml (NOT a URL).
             const r = (0, child_process_1.spawnSync)('reg', [
                 'add', WEF_DEVELOPER_KEY,
-                '/v', entry.guid, '/t', 'REG_SZ', '/d', manifestPath, '/f',
+                '/v', entry.guid, '/t', 'REG_SZ', '/d', sideloadPath, '/f',
             ], { encoding: 'utf8' });
             if (r.status !== 0)
                 return { ok: false, reason: r.stderr || `reg add failed for ${entry.guid}` };
@@ -112,7 +130,7 @@ function sideloadManifest(projectPath) {
             const dest = macWefPath(entry.macContainer, entry.guid);
             try {
                 fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
-                fs_1.default.copyFileSync(manifestPath, dest);
+                fs_1.default.copyFileSync(sideloadPath, dest);
             }
             catch (err) {
                 return { ok: false, reason: String(err) };

package/dist/src/ai-hub/server.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiHubServer = void 0;
 exports.findAvailablePort = findAvailablePort;
+exports.findAvailablePortExcluding = findAvailablePortExcluding;
 const express_1 = __importDefault(require("express"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
@@ -488,6 +489,13 @@ class AiHubServer {
                 });
             });
         }
+        this.app.get(['/word-taskpane/config.js', '/powerpoint-taskpane/config.js'], (_req, res) => {
+            const port = this.httpPort || 43091;
+            const origin = `http://127.0.0.1:${port}`;
+            res.setHeader('Content-Type', 'application/javascript; charset=utf-8');
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.end(`window.FRAIM_HUB_ORIGIN=${JSON.stringify(origin)};\n`);
+        });
         this.app.get('/health', (_req, res) => {
             res.json({ status: 'ok', service: 'fraim-ai-hub' });
         });
@@ -501,6 +509,7 @@ class AiHubServer {
         return this.app;
     }
     async start(port) {
+        this.httpPort = port;
         if (this.dbService) {
             try {
                 await this.dbService.connect();
@@ -1233,8 +1242,15 @@ class AiHubServer {
 }
 exports.AiHubServer = AiHubServer;
 async function findAvailablePort(preferredPort) {
+    return findAvailablePortExcluding(preferredPort, new Set());
+}
+async function findAvailablePortExcluding(preferredPort, excludedPorts) {
     let port = preferredPort;
     while (port < preferredPort + 20) {
+        if (excludedPorts.has(port)) {
+            port += 1;
+            continue;
+        }
         const available = await new Promise((resolve) => {
             const server = net_1.default.createServer();
             server.once('error', () => resolve(false));

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/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.160",
+  "version": "2.0.161",
   "description": "FRAIM CLI - Framework for Rigor-based AI Management (alias for fraim-framework)",
   "main": "index.js",
   "bin": {

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

@@ -5,6 +5,7 @@
   <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; }
@@ -25,7 +26,7 @@
     // desktop (HTTP) use the direct Hub address.
     var HUB_ORIGIN = window.location.protocol === 'https:'
       ? window.location.origin
-      : 'http://127.0.0.1:43091';
+      : (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;