fraim-hub 2.0.207 → 2.0.208

package/bin/fraim-hub.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 try {
   const { createFraimHubProgram } = require('../dist/src/cli/fraim-hub.js');

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

@@ -80,7 +80,10 @@ function openDesktopWindow(projectPath, preferredPort) {
     if (!electronBinary || !desktopEntry) {
         return false;
     }
-    const child = (0, child_process_1.spawn)(electronBinary, [desktopEntry, '--project-path', projectPath, '--port', String(preferredPort)], {
+    const args = projectPath
+        ? [desktopEntry, '--project-path', projectPath, '--port', String(preferredPort)]
+        : [desktopEntry, '--port', String(preferredPort)];
+    const child = (0, child_process_1.spawn)(electronBinary, args, {
         detached: true,
         stdio: 'ignore',
     });
@@ -182,7 +185,7 @@ async function reconcileRunningHub(flags) {
 async function runHub(options) {
     const { AiHubServer, findAvailablePort } = await Promise.resolve().then(() => __importStar(require('./server')));
     const preferredPort = options.port || (0, git_utils_1.getPort)() + 100;
-    const projectPath = path_1.default.resolve(options.projectPath || process.cwd());
+    const projectPath = options.projectPath ? path_1.default.resolve(options.projectPath) : undefined;
     if (options.open) {
         const wantDesktop = !options.browser;
         if (wantDesktop) {
@@ -191,22 +194,25 @@ async function runHub(options) {
         const openedDesktop = wantDesktop && openDesktopWindow(projectPath, preferredPort);
         if (!openedDesktop) {
             const port = await findAvailablePort(preferredPort);
-            const server = new AiHubServer({ projectPath });
+            const server = new AiHubServer(projectPath ? { projectPath } : {});
             await server.start(port);
             const url = `http://127.0.0.1:${port}/ai-hub/`;
             console.log(`AI Hub running at ${url}`);
-            console.log(`Project path: ${projectPath}`);
+            console.log(`Project path: ${server.getProjectPath()}`);
             openBrowser(url);
             return;
         }
         console.log('AI Hub desktop shell launched.');
-        console.log(`Project path: ${projectPath}`);
+        if (projectPath)
+            console.log(`Project path: ${projectPath}`);
+        else
+            console.log('Project path: loaded from saved Hub state');
         return;
     }
     const port = await findAvailablePort(preferredPort);
-    const server = new AiHubServer({ projectPath });
+    const server = new AiHubServer(projectPath ? { projectPath } : {});
     await server.start(port);
     const url = `http://127.0.0.1:${port}/ai-hub/`;
     console.log(`AI Hub running at ${url}`);
-    console.log(`Project path: ${projectPath}`);
+    console.log(`Project path: ${server.getProjectPath()}`);
 }

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

@@ -33,7 +33,7 @@ function preferredWindowSize() {
     };
 }
 function parseArgs(argv) {
-    let projectPath = process.cwd();
+    let projectPath;
     let preferredPort = 43091;
     for (let i = 0; i < argv.length; i += 1) {
         if (argv[i] === '--project-path' && argv[i + 1]) {
@@ -355,7 +355,7 @@ async function launchDesktopShell(options) {
     // Fast on subsequent launches (file read); ~200ms on first launch (key gen).
     const certBundle = await (0, cert_store_1.loadOrCreateCert)();
     server = new server_1.AiHubServer({
-        projectPath: options.projectPath,
+        ...(options.projectPath ? { projectPath: options.projectPath } : {}),
         // Issue #701: no local DB. Persona/manager-team state resolves through the hosted
         // server via the Hub's default remote gateway (authenticated by the user's API key).
         httpsPort,
@@ -370,6 +370,7 @@ async function launchDesktopShell(options) {
         },
     });
     await server.start(httpPort);
+    const resolvedProjectPath = server.getProjectPath();
     // #755: record the live instance so `fraim hub` can detect a stale build and
     // replace it instead of re-focusing an outdated process.
     try {
@@ -383,7 +384,7 @@ async function launchDesktopShell(options) {
     catch (err) {
         console.warn('[fraim] could not write hub-runtime.json:', err);
     }
-    ensureWordSideload(options.projectPath, httpPort);
+    ensureWordSideload(resolvedProjectPath, httpPort);
     const hubUrl = `http://127.0.0.1:${httpPort}/ai-hub/`;
     createTray(hubUrl);
     await createWindow(hubUrl);

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

@@ -130,6 +130,12 @@ function loadPersonaCapabilityModule() {
 function getProtectedPersonaForHubJob(jobName) {
     return loadPersonaCapabilityModule()?.getProtectedPersonaForJob(jobName) ?? null;
 }
+const GENERIC_WORKER_PERSONA_KEY = 'fraimworker';
+function getHubPersonaForJob(jobName) {
+    if (!jobName || jobName === '__freeform__')
+        return null;
+    return getProtectedPersonaForHubJob(jobName) ?? GENERIC_WORKER_PERSONA_KEY;
+}
 const FRAIM_INTERNAL_JOB_IDS = new Set([
     'contribute-to-fraim',
     'create-registry-asset',
@@ -177,6 +183,24 @@ function buildHubManagerHiringCatalog() {
         roles: {},
     };
 }
+function directoryExists(projectPath) {
+    try {
+        return fs_1.default.statSync(projectPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function resolveInitialHubProjectPath(preferencesStore, fallbackPath) {
+    const fallback = path_1.default.resolve(fallbackPath || process.cwd());
+    const recorded = preferencesStore.load(fallback).projectPath;
+    if (typeof recorded === 'string' && recorded.trim().length > 0) {
+        const resolved = path_1.default.resolve(recorded);
+        if (directoryExists(resolved))
+            return resolved;
+    }
+    return fallback;
+}
 class AiHubRunRegistry {
     constructor() {
         this.runs = new Map();
@@ -1185,8 +1209,10 @@ class AiHubServer {
         this.app = (0, express_1.default)();
         this.runRegistry = new AiHubRunRegistry();
         this.cronHandles = new Map();
-        this.projectPath = options.projectPath || process.cwd();
         this.preferencesStore = options.preferencesStore || new preferences_1.AiHubPreferencesStore();
+        this.projectPath = options.projectPath
+            ? path_1.default.resolve(options.projectPath)
+            : resolveInitialHubProjectPath(this.preferencesStore, process.cwd());
         this.conversationStore = options.conversationStore || new conversation_store_1.AiHubConversationStore();
         this.configuredAgentStore = options.configuredAgentStore || new configured_agents_1.AiHubConfiguredAgentStore();
         this.wordTaskpaneDir = options.wordTaskpaneDir ?? resolveWordTaskpaneDir(this.projectPath);
@@ -1325,6 +1351,12 @@ class AiHubServer {
     getApp() {
         return this.app;
     }
+    getProjectPath() {
+        return this.projectPath;
+    }
+    defaultProjectPath() {
+        return resolveInitialHubProjectPath(this.preferencesStore, this.projectPath);
+    }
     async start(port) {
         this.httpPort = port;
         await new Promise((resolve, reject) => {
@@ -1946,7 +1978,7 @@ class AiHubServer {
                 id: employeeJob.id,
                 title: employeeJob.title,
                 stubPath: employeeJob.stubPath,
-                personaKey: employeeJob.requiredPersonaKey ?? getProtectedPersonaForHubJob(employeeJob.id),
+                personaKey: employeeJob.requiredPersonaKey ?? getHubPersonaForJob(employeeJob.id),
             };
         }
         const managerTemplate = (0, catalog_1.discoverManagerTemplates)(projectPath).find((job) => job.id === jobId);
@@ -1955,7 +1987,7 @@ class AiHubServer {
                 id: managerTemplate.id,
                 title: managerTemplate.title,
                 stubPath: managerTemplate.stubPath,
-                personaKey: getProtectedPersonaForHubJob(managerTemplate.id),
+                personaKey: getHubPersonaForJob(managerTemplate.id),
             };
         }
         return null;
@@ -2228,20 +2260,9 @@ class AiHubServer {
                 }
                 catch { }
             }
-            // #719: a bare reload (no projectPath query) must land on the last-recorded
-            // workspace project, not the launch folder. The bootstrap saves its resolved
-            // current path back into the projects list, so defaulting to the launch
-            // folder would resurrect a removed launch-folder project on every reload
-            // (tfSwitchProjectFolder already documents the recorded folder as "the
-            // default on next load"). The launch folder stays the fallback when nothing
-            // is recorded or the recorded folder no longer exists.
-            if (!projectPath) {
-                const recorded = this.preferencesStore.load(this.projectPath).projectPath;
-                if (recorded && path_1.default.resolve(recorded) !== path_1.default.resolve(this.projectPath) && fs_1.default.existsSync(recorded)) {
-                    projectPath = recorded;
-                }
-            }
-            res.json(await this.bootstrapResponse(projectPath || this.projectPath));
+            // #719 / local Hub package: a bare reload must land on the user-level saved
+            // Hub project, not whatever directory happened to launch the process.
+            res.json(await this.bootstrapResponse(projectPath || this.defaultProjectPath()));
         });
         // Issue #512 (S3, R14) — Brain summary as a standalone route, returning the
         // same projection folded into bootstrap. Useful for the avatar→Brain view
@@ -2249,7 +2270,7 @@ class AiHubServer {
         this.app.get('/api/ai-hub/brain', async (req, res) => {
             const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
                 ? path_1.default.resolve(req.query.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             const jobCount = (0, catalog_1.discoverEmployeeJobs)(projectPath).length + (0, catalog_1.discoverManagerTemplates)(projectPath).length;
             const userEmail = await this.resolveHubIdentity();
             return res.json(this.computeBrain(projectPath, jobCount, userEmail));
@@ -2264,7 +2285,7 @@ class AiHubServer {
             ? path_1.default.resolve(req.query.projectPath)
             : (typeof (req.body && req.body.projectPath) === 'string' && req.body.projectPath.length > 0
                 ? path_1.default.resolve(req.body.projectPath)
-                : this.projectPath);
+                : this.defaultProjectPath());
         this.app.get('/api/ai-hub/learnings', async (req, res) => {
             const scope = req.query.scope;
             if (typeof scope !== 'string' || !VALID_SCOPES.includes(scope)) {
@@ -2344,7 +2365,7 @@ class AiHubServer {
                 ? (0, conversation_store_1.conversationScopeKey)(scope, '')
                 : (typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
                     ? path_1.default.resolve(req.query.projectPath)
-                    : this.projectPath);
+                    : this.defaultProjectPath());
             const loaded = this.conversationStore.loadProject(key);
             return res.json({ projectPath: key, scope: scope ?? 'project', ...loaded, source: 'disk' });
         });
@@ -2352,7 +2373,10 @@ class AiHubServer {
             try {
                 const body = (req.body ?? {});
                 const scope = scopeParam(body.scope);
-                const key = scope ? (0, conversation_store_1.conversationScopeKey)(scope, '') : ensureDirectoryPath(body.projectPath || this.projectPath);
+                if (!scope && (typeof body.projectPath !== 'string' || body.projectPath.trim().length === 0)) {
+                    return res.status(400).json({ error: 'projectPath required for project conversations' });
+                }
+                const key = scope ? (0, conversation_store_1.conversationScopeKey)(scope, '') : ensureDirectoryPath(body.projectPath);
                 if (!Array.isArray(body.conversations)) {
                     return res.status(400).json({ error: 'conversations array required' });
                 }
@@ -2401,7 +2425,10 @@ class AiHubServer {
             try {
                 const body = (req.body ?? {});
                 const scope = scopeParam(body.scope);
-                const projectPath = scope ? (0, conversation_store_1.conversationScopeKey)(scope, '') : ensureDirectoryPath(body.projectPath || this.projectPath);
+                if (!scope && (typeof body.projectPath !== 'string' || body.projectPath.trim().length === 0)) {
+                    return res.status(400).json({ error: 'projectPath required for project conversations' });
+                }
+                const projectPath = scope ? (0, conversation_store_1.conversationScopeKey)(scope, '') : ensureDirectoryPath(body.projectPath);
                 const saved = this.conversationStore.patchConversation(projectPath, req.params.conversationId, body);
                 if (body.activeId !== undefined) {
                     const withActive = this.conversationStore.replaceProject(projectPath, { ...saved, activeId: body.activeId });
@@ -2416,13 +2443,13 @@ class AiHubServer {
         this.app.get('/api/ai-hub/projects', (req, res) => {
             const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
                 ? path_1.default.resolve(req.query.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             return res.json({ projectPath, projects: this.knownProjects(projectPath), source: 'disk' });
         });
         this.app.put('/api/ai-hub/projects', (req, res) => {
             try {
                 const body = (req.body ?? {});
-                const projectPath = ensureDirectoryPath(body.projectPath || this.projectPath);
+                const projectPath = ensureDirectoryPath(body.projectPath || this.defaultProjectPath());
                 if (!Array.isArray(body.projects)) {
                     return res.status(400).json({ error: 'projects array required' });
                 }
@@ -2442,7 +2469,7 @@ class AiHubServer {
         this.app.delete('/api/ai-hub/projects/:id', (req, res) => {
             const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
                 ? path_1.default.resolve(req.query.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             const known = this.knownProjects(projectPath);
             // Match by id, falling back to the canonical folderPath. The client and server
             // hash a path to an id with different algorithms, and the client mints its own id
@@ -2486,7 +2513,7 @@ class AiHubServer {
         // (set by `fraim setup`), read fresh via resolveApiKey() on every request.
         this.app.post('/api/ai-hub/preferences', (req, res) => {
             const { personaKey } = req.body;
-            const prefs = this.preferencesStore.load(this.projectPath);
+            const prefs = this.preferencesStore.load(this.defaultProjectPath());
             this.preferencesStore.save({ ...prefs, personaKey: personaKey ?? null });
             return res.json({ ok: true });
         });
@@ -2544,7 +2571,7 @@ class AiHubServer {
         this.app.get('/api/ai-hub/context', (req, res) => {
             const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
                 ? path_1.default.resolve(req.query.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             const rawKey = typeof req.query.key === 'string' ? req.query.key : undefined;
             if (rawKey !== undefined) {
                 if (!(0, learning_context_builder_1.isTeamContextKey)(rawKey)) {
@@ -2568,7 +2595,7 @@ class AiHubServer {
             }
             const projectPath = typeof body.projectPath === 'string' && body.projectPath.length > 0
                 ? path_1.default.resolve(body.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             const loc = (0, learning_context_builder_1.resolveTeamContextFile)(projectPath, body.key);
             if (loc.managedByOrgSync || loc.managedByManagerSync || !loc.writePath) {
                 // Enforcement only: block editing a synced org file (it would be
@@ -2607,14 +2634,14 @@ class AiHubServer {
         this.app.get('/api/ai-hub/brand', (req, res) => {
             const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
                 ? path_1.default.resolve(req.query.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             return res.json({ brand: (0, learning_context_builder_1.readOrgBrand)(projectPath) });
         });
         this.app.post('/api/ai-hub/brand', (req, res) => {
             const body = (req.body ?? {});
             const projectPath = typeof body.projectPath === 'string' && body.projectPath.length > 0
                 ? path_1.default.resolve(body.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             const input = {
                 name: typeof body.name === 'string' ? body.name : undefined,
                 color: typeof body.color === 'string' ? body.color : undefined,
@@ -2640,7 +2667,7 @@ class AiHubServer {
             const rawPath = typeof req.body?.path === 'string' ? req.body.path : '';
             const projectPath = typeof req.body?.projectPath === 'string' && req.body.projectPath.length > 0
                 ? path_1.default.resolve(req.body.projectPath)
-                : this.projectPath;
+                : this.defaultProjectPath();
             if (!rawPath)
                 return res.status(400).json({ error: 'path is required.' });
             const resolved = resolveSafeArtifactPath(rawPath, projectPath);
@@ -2825,7 +2852,7 @@ class AiHubServer {
         });
         this.app.post('/api/ai-hub/runs', (req, res) => {
             try {
-                const projectPath = ensureDirectoryPath(req.body.projectPath || this.projectPath);
+                const projectPath = ensureDirectoryPath(req.body.projectPath || this.defaultProjectPath());
                 const requestedHostId = req.body.hostId;
                 const instructions = (req.body.instructions || '').trim();
                 const legacyMessage = (req.body.message || '').trim();
@@ -2876,7 +2903,7 @@ class AiHubServer {
                     phaseHistory: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
-                    personaKey: jobMetadata?.personaKey ?? getProtectedPersonaForHubJob(jobId),
+                    personaKey: jobMetadata?.personaKey ?? getHubPersonaForJob(jobId),
                     // Issue #442: mark this as the FRAIM side of an A/B pair when applicable.
                     ...(compareMode === 'ab' ? { runRole: 'fraim' } : {}),
                     // #0: trigger source — defaults to 'manager' when not provided by the caller.
@@ -3172,7 +3199,7 @@ class AiHubServer {
         this.app.post('/api/ai-hub/runs/resume', (req, res) => {
             try {
                 const body = (req.body ?? {});
-                const projectPath = ensureDirectoryPath(body.projectPath || this.projectPath);
+                const projectPath = ensureDirectoryPath(body.projectPath || this.defaultProjectPath());
                 const requestedHostId = body.hostId;
                 const sessionId = (body.sessionId || '').trim();
                 const jobId = (body.jobId || '').trim();
@@ -3206,7 +3233,7 @@ class AiHubServer {
                     totals: persistedRun?.totals || emptyTotals(),
                     lastStatusChangeAt: now,
                     runDiscriminant: persistedRun?.runDiscriminant || undefined,
-                    personaKey: getProtectedPersonaForHubJob(jobId),
+                    personaKey: getHubPersonaForJob(jobId),
                 };
                 // Continue-turn message (FRAIM invocation for the job + instructions) plus
                 // the shared-browser note so the resumed agent knows about it.
@@ -3378,7 +3405,7 @@ class AiHubServer {
                 type: 'scheduled',
                 label,
                 jobId,
-                projectPath: ensureDirectoryPath(projectPath || this.projectPath),
+                projectPath: ensureDirectoryPath(projectPath || this.defaultProjectPath()),
                 hostId: resolvedHostId,
                 ...(typeof configuredAgentId === 'string' && configuredAgentId.trim() ? { configuredAgentId: configuredAgentId.trim() } : {}),
                 cronExpr,
@@ -3396,7 +3423,7 @@ class AiHubServer {
         // GET /api/ai-hub/schedules — list scheduled deployments for one project.
         this.app.get('/api/ai-hub/schedules', (req, res) => {
             try {
-                const projectPath = deploymentProjectFilter(req.query.projectPath, this.projectPath);
+                const projectPath = deploymentProjectFilter(req.query.projectPath, this.defaultProjectPath());
                 return res.json(this.deploymentStore.load().filter((d) => d.type === 'scheduled' && deploymentBelongsToProject(d, projectPath, this.projectPath)));
             }
             catch (err) {
@@ -3430,7 +3457,7 @@ class AiHubServer {
             let resolvedProjectPath;
             try {
                 if (projectPath !== undefined)
-                    resolvedProjectPath = ensureDirectoryPath(projectPath || this.projectPath);
+                    resolvedProjectPath = ensureDirectoryPath(projectPath || this.defaultProjectPath());
             }
             catch (err) {
                 return res.status(400).json({ error: err instanceof Error ? err.message : 'Invalid project path.' });
@@ -3480,7 +3507,7 @@ class AiHubServer {
                 type: 'webhook',
                 label,
                 jobId,
-                projectPath: ensureDirectoryPath(projectPath || this.projectPath),
+                projectPath: ensureDirectoryPath(projectPath || this.defaultProjectPath()),
                 hostId: resolvedHostId,
                 ...(typeof configuredAgentId === 'string' && configuredAgentId.trim() ? { configuredAgentId: configuredAgentId.trim() } : {}),
                 instructions: typeof instructions === 'string' ? instructions : undefined,
@@ -3497,7 +3524,7 @@ class AiHubServer {
         this.app.get('/api/ai-hub/webhooks', (req, res) => {
             const hubBase = this.hubBase;
             try {
-                const projectPath = deploymentProjectFilter(req.query.projectPath, this.projectPath);
+                const projectPath = deploymentProjectFilter(req.query.projectPath, this.defaultProjectPath());
                 return res.json(this.deploymentStore.load()
                     .filter((d) => d.type === 'webhook' && deploymentBelongsToProject(d, projectPath, this.projectPath))
                     .map((d) => ({ ...d, inboundUrl: `${hubBase}/api/ai-hub/webhooks/${d.id}/inbound` })));
@@ -3520,7 +3547,7 @@ class AiHubServer {
             let resolvedProjectPath;
             try {
                 if (projectPath !== undefined)
-                    resolvedProjectPath = ensureDirectoryPath(projectPath || this.projectPath);
+                    resolvedProjectPath = ensureDirectoryPath(projectPath || this.defaultProjectPath());
             }
             catch (err) {
                 return res.status(400).json({ error: err instanceof Error ? err.message : 'Invalid project path.' });
@@ -3623,7 +3650,7 @@ class AiHubServer {
                 if (!jobName) {
                     return res.status(400).json({ error: 'jobName is required.' });
                 }
-                const projectPath = ensureDirectoryPath(reqProjectPath || this.projectPath);
+                const projectPath = ensureDirectoryPath(reqProjectPath || this.defaultProjectPath());
                 // Use the requested agent directly — caller specifies which agent to run (claude, codex, gemini).
                 const requestedAgentId = req.body.configuredAgentId || employeeId;
                 const requestedHostId = VALID_EMPLOYEE_IDS.includes(employeeId) ? employeeId : undefined;
@@ -3657,7 +3684,7 @@ class AiHubServer {
                     phaseHistory: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
-                    personaKey: getProtectedPersonaForHubJob(jobName),
+                    personaKey: getHubPersonaForJob(jobName),
                 };
                 // Register the run before spawning so onEvent/onExit callbacks can
                 // safely call update() even if they fire synchronously (FakeHostRuntime).
@@ -3775,7 +3802,7 @@ class AiHubServer {
             phaseHistory: [],
             totals: emptyTotals(),
             lastStatusChangeAt: startTimestamp,
-            personaKey: jobMetadata?.personaKey ?? getProtectedPersonaForHubJob(jobId),
+            personaKey: jobMetadata?.personaKey ?? getHubPersonaForJob(jobId),
         };
         // Pre-register before startRun so synchronous onEvent calls (e.g. FakeHostRuntime)
         // can call runRegistry.update without "Run not found" throws.

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

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Sideloads the Word add-in manifest so it appears in Word's Developer Add-ins
+ * list without admin rights or AppSource publishing.
+ *
+ * Windows: writes a registry value under HKCU\SOFTWARE\Microsoft\Office\16.0\WEF\Developer
+ * macOS:   writes an entry to ~/Library/Containers/com.microsoft.Word/Data/Documents/wef/
+ *
+ * Both paths are non-admin and survive app updates (keyed by manifest GUID).
+ * Safe to call multiple times — checks before writing.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSideloaded = isSideloaded;
+exports.sideloadManifest = sideloadManifest;
+exports.removeSideload = removeSideload;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
+const MANIFEST_GUID = 'd1090951-50cf-4cf2-9d12-b0f8541d265c';
+function resolveManifestPath(projectPath) {
+    const candidates = [
+        path_1.default.resolve(projectPath, 'extensions/office-word/manifest.xml'),
+        path_1.default.resolve(__dirname, '..', '..', 'extensions/office-word/manifest.xml'),
+        path_1.default.resolve(__dirname, '..', '..', '..', 'extensions/office-word/manifest.xml'),
+    ];
+    return candidates.find(c => fs_1.default.existsSync(c)) ?? null;
+}
+function isSideloaded() {
+    if (process.platform === 'win32') {
+        const result = (0, child_process_1.spawnSync)('reg', [
+            'query',
+            `HKCU\\SOFTWARE\\Microsoft\\Office\\16.0\\WEF\\Developer`,
+            '/v', MANIFEST_GUID,
+        ], { encoding: 'utf8' });
+        return result.status === 0 && result.stdout.includes(MANIFEST_GUID);
+    }
+    if (process.platform === 'darwin') {
+        const wefDir = path_1.default.join(os_1.default.homedir(), 'Library', 'Containers', 'com.microsoft.Word', 'Data', 'Documents', 'wef');
+        return fs_1.default.existsSync(path_1.default.join(wefDir, `${MANIFEST_GUID}.xml`));
+    }
+    return false;
+}
+function sideloadManifest(projectPath) {
+    const manifestPath = resolveManifestPath(projectPath);
+    if (!manifestPath) {
+        return { ok: false, reason: 'Manifest file not found — is extensions/office-word/ present?' };
+    }
+    if (process.platform === 'win32') {
+        const result = (0, child_process_1.spawnSync)('reg', [
+            'add',
+            `HKCU\\SOFTWARE\\Microsoft\\Office\\16.0\\WEF\\Developer`,
+            '/v', MANIFEST_GUID,
+            '/t', 'REG_SZ',
+            '/d', manifestPath,
+            '/f',
+        ], { encoding: 'utf8' });
+        if (result.status !== 0) {
+            return { ok: false, reason: result.stderr || 'reg add failed' };
+        }
+        return { ok: true };
+    }
+    if (process.platform === 'darwin') {
+        const wefDir = path_1.default.join(os_1.default.homedir(), 'Library', 'Containers', 'com.microsoft.Word', 'Data', 'Documents', 'wef');
+        try {
+            fs_1.default.mkdirSync(wefDir, { recursive: true });
+            fs_1.default.copyFileSync(manifestPath, path_1.default.join(wefDir, `${MANIFEST_GUID}.xml`));
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, reason: String(err) };
+        }
+    }
+    return { ok: false, reason: `Unsupported platform: ${process.platform}` };
+}
+function removeSideload() {
+    if (process.platform === 'win32') {
+        (0, child_process_1.spawnSync)('reg', [
+            'delete',
+            `HKCU\\SOFTWARE\\Microsoft\\Office\\16.0\\WEF\\Developer`,
+            '/v', MANIFEST_GUID,
+            '/f',
+        ], { encoding: 'utf8' });
+        return;
+    }
+    if (process.platform === 'darwin') {
+        const wefDir = path_1.default.join(os_1.default.homedir(), 'Library', 'Containers', 'com.microsoft.Word', 'Data', 'Documents', 'wef');
+        const target = path_1.default.join(wefDir, `${MANIFEST_GUID}.xml`);
+        if (fs_1.default.existsSync(target))
+            fs_1.default.unlinkSync(target);
+    }
+}

package/dist/src/cli/fraim-hub.js

@@ -33,7 +33,7 @@ function createFraimHubProgram(action = cli_1.runHub) {
         .description('Start the FRAIM Hub local companion')
         .version(readPackageVersion())
         .option('--port <port>', 'Preferred local port for the hub', (value) => Number(value), 43091)
-        .option('--project-path <path>', 'Initial project path for job discovery', process.cwd())
+        .option('--project-path <path>', 'Initial project path for job discovery')
         .option('--no-open', 'Do not open the hub after startup')
         .option('--browser', 'Open in the default browser instead of the desktop shell')
         .option('--restart', 'Replace any running Hub instance with this build (even at the same version)')

package/dist/src/cli/setup/ide-invocation-surfaces.js

@@ -96,18 +96,18 @@ ${buildFraimInvocationBody('generic-tool-discovery')}
 `;
 }
 function buildCodexSkillContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('codex-tool-search')}`;
 }
 function buildGrokSkillContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function buildWindsurfCommandContent() {
-    return `# FRAIM
-
+    return `# FRAIM
+
 ${buildFraimInvocationBody('generic-tool-discovery')}`;
 }
 function buildKiroCommandContent() {

package/extensions/office-word/taskpane.html

@@ -3,9 +3,9 @@
 <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>
+  <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; }
@@ -19,9 +19,9 @@
     // Loading an HTTP iframe from an HTTPS page is mixed-content-blocked, so use the
     // same origin as the taskpane when running over HTTPS (the ssl-proxy forwards all
     // routes to the Hub).  HTTP (isolated tests) keeps 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 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;

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework - Smart Entry Point

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-hub",
-  "version": "2.0.207",
+  "version": "2.0.208",
   "description": "FRAIM Hub local companion package.",
   "main": "index.js",
   "bin": {
@@ -89,7 +89,7 @@
     "dotenv": "^16.4.7",
     "electron": "^41.2.2",
     "express": "^5.2.1",
-    "fraim": "2.0.207",
+    "fraim": "2.0.208",
     "mongodb": "^7.0.0",
     "node-cron": "4.2.1",
     "node-edge-tts": "^1.2.10",