fraim-framework 2.0.185 → 2.0.187

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

@@ -227,6 +227,9 @@ function safeHttpUrl(value) {
 }
 // ─── Issue #578: Deployment + Host stores ─────────────────────────────────────
 const VALID_EMPLOYEE_IDS = ['codex', 'claude', 'gemini', 'copilot'];
+function startSessionSeedForHost(hostId, runId) {
+    return hostId === 'gemini' ? undefined : runId;
+}
 class DeploymentStore {
     constructor(filePath) {
         this.filePath = filePath ?? path_1.default.join(getUserHubDir(), 'hub-deployments.json');
@@ -587,6 +590,42 @@ function emptyTotals() {
         },
     };
 }
+const PHASE_STATUSES = new Set(['starting', 'complete', 'incomplete', 'failure']);
+function normalizePersistedPhaseHistory(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map((entry) => {
+        if (!entry || typeof entry !== 'object')
+            return null;
+        const raw = entry;
+        if (typeof raw.phaseId !== 'string' || !raw.phaseId)
+            return null;
+        const latestStatus = typeof raw.latestStatus === 'string' && PHASE_STATUSES.has(raw.latestStatus)
+            ? raw.latestStatus
+            : null;
+        return {
+            phaseId: raw.phaseId,
+            enteredAt: typeof raw.enteredAt === 'string' ? raw.enteredAt : new Date().toISOString(),
+            latestStatus,
+            latestText: typeof raw.latestText === 'string' ? raw.latestText : null,
+        };
+    })
+        .filter((entry) => Boolean(entry));
+}
+function readPersistedRunProjection(conversation) {
+    const rawRun = conversation?.run;
+    if (!rawRun || typeof rawRun !== 'object')
+        return null;
+    const value = rawRun;
+    return {
+        currentPhase: typeof value.currentPhase === 'string' ? value.currentPhase : null,
+        phaseHistory: normalizePersistedPhaseHistory(value.phaseHistory),
+        stages: Array.isArray(value.stages) ? value.stages : [],
+        totals: value.totals && typeof value.totals === 'object' ? value.totals : null,
+        runDiscriminant: typeof value.runDiscriminant === 'string' ? value.runDiscriminant : null,
+    };
+}
 // Issue #347 — apply per-turn usage from the host stream into the
 // run's tokenTotals. Idempotent on the same turn (we replace, not add)
 // because Codex's `turn.completed.usage` is cumulative, not delta.
@@ -766,20 +805,17 @@ function deriveStages(run, projectPath) {
     }
     return declaredPath.map((phase, index) => {
         let state;
-        if (currentIndex < 0) {
-            state = 'upcoming';
-        }
-        else if (index < currentIndex) {
-            state = 'done';
-        }
-        else if (index === currentIndex) {
+        const entry = historyMap.get(phase.id);
+        if (index === currentIndex) {
             // If the agent has already reported this phase as 'complete', advance
             // its visual state to 'done' so the tracker doesn't look frozen while
             // waiting for the agent to start the next phase (e.g. after
             // implement-submission completes but before address-feedback starts).
-            const entry = historyMap.get(phase.id);
             state = entry?.latestStatus === 'complete' ? 'done' : 'current';
         }
+        else if (entry?.latestStatus === 'complete' || (currentIndex >= 0 && index < currentIndex && entry)) {
+            state = 'done';
+        }
         else {
             state = 'upcoming';
         }
@@ -1399,6 +1435,7 @@ class AiHubServer {
     }
     conversationRecordFromRun(run) {
         const lastUpdatedAt = run.updatedAt || new Date().toISOString();
+        const stages = deriveStages(run, run.projectPath);
         return {
             id: run.conversationId || run.id,
             projectPath: path_1.default.resolve(run.projectPath),
@@ -1433,11 +1470,27 @@ class AiHubServer {
             compareRunId: run.compareRunId || null,
             // Issue #578: preserve trigger source so the UI can render the chip.
             sourceTrigger: run.sourceTrigger,
+            // Issue #708: carry the invocation scope so the record lands in (and is keyed to)
+            // the right bucket. Falls back to the legacy client `invokedArea` when present.
+            scope: run.scope
+                ?? run.invokedArea
+                ?? 'project',
+            run: {
+                stages,
+                currentPhase: run.currentPhase || null,
+                phaseHistory: run.phaseHistory || [],
+                totals: run.totals || null,
+                runDiscriminant: run.runDiscriminant || null,
+            },
         };
     }
     persistRunConversation(run, activeId) {
         try {
-            this.conversationStore.upsertConversation(run.projectPath, this.conversationRecordFromRun(run), activeId);
+            // Issue #708: route the record to its scope bucket (manager/company runs get a
+            // project-independent home); project runs continue to key by project path.
+            const record = this.conversationRecordFromRun(run);
+            const key = (0, conversation_store_1.conversationScopeKey)(record.scope, run.projectPath);
+            this.conversationStore.upsertConversation(key, record, activeId);
         }
         catch (error) {
             console.warn('[ai-hub] conversation store write failed:', error instanceof Error ? error.message : error);
@@ -1544,8 +1597,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -1567,7 +1622,7 @@ class AiHubServer {
                 }
                 this.runRegistry.dispose(childRun.id);
             },
-        }, childRun.sessionId);
+        }, startSessionSeedForHost(managerRun.hostId, childRun.id));
         this.runRegistry.attachChildIfRunning(childRun.id, child);
     }
     notifyManagerOfDelegatedChild(managerRunId, childRun) {
@@ -1691,8 +1746,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -1764,14 +1821,48 @@ class AiHubServer {
         };
     }
     resolveHubJob(projectPath, jobId) {
+        if (!jobId || jobId === '__freeform__')
+            return null;
         const employeeJob = (0, catalog_1.discoverEmployeeJobs)(projectPath).find((job) => job.id === jobId);
-        if (employeeJob)
-            return { id: employeeJob.id, stubPath: employeeJob.stubPath };
+        if (employeeJob) {
+            return {
+                id: employeeJob.id,
+                title: employeeJob.title,
+                stubPath: employeeJob.stubPath,
+                personaKey: employeeJob.requiredPersonaKey ?? getProtectedPersonaForHubJob(employeeJob.id),
+            };
+        }
         const managerTemplate = (0, catalog_1.discoverManagerTemplates)(projectPath).find((job) => job.id === jobId);
-        if (managerTemplate)
-            return { id: managerTemplate.id, stubPath: managerTemplate.stubPath };
+        if (managerTemplate) {
+            return {
+                id: managerTemplate.id,
+                title: managerTemplate.title,
+                stubPath: managerTemplate.stubPath,
+                personaKey: getProtectedPersonaForHubJob(managerTemplate.id),
+            };
+        }
         return null;
     }
+    applySeekMentoringSignalToRun(run, signal) {
+        this.maybePromoteFreeformRunToJob(run, signal.jobId || signal.jobName);
+        applySeekMentoringSignal(run, signal);
+    }
+    applyFraimJobSignalToRun(run, signal) {
+        this.maybePromoteFreeformRunToJob(run, signal.jobId);
+    }
+    maybePromoteFreeformRunToJob(run, signalJobId) {
+        const normalizedJobId = (signalJobId || '').trim().toLowerCase();
+        if (run.jobId !== '__freeform__' || !normalizedJobId)
+            return;
+        const metadata = this.resolveHubJob(run.projectPath, normalizedJobId);
+        if (!metadata)
+            return;
+        run.jobId = metadata.id;
+        run.jobTitle = metadata.title;
+        run.personaKey = metadata.personaKey;
+        run.updatedAt = new Date().toISOString();
+        run.events.push((0, hosts_1.createHubEvent)('system', `Recognized FRAIM job ${metadata.id} from structured telemetry.`));
+    }
     // Lightweight markdown → .docx. Shared by the GET (file path) and POST (inline
     // content) export routes so a conversational deliverable with no on-disk file
     // can still be downloaded for Word annotation.
@@ -1979,6 +2070,19 @@ class AiHubServer {
             }
             // Read API key from header — query-param API keys are prohibited (§3.14)
             const apiKey = typeof req.headers['x-fraim-api-key'] === 'string' ? req.headers['x-fraim-api-key'] : undefined;
+            // #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, apiKey));
         });
         // Issue #512 (S3, R14) — Brain summary as a standalone route, returning the
@@ -2064,25 +2168,32 @@ class AiHubServer {
             await this.remoteGateway.removeManagerTeam(apiKey, personaKey);
             return res.status(204).end();
         });
+        // Issue #708: manager/company scopes resolve to a project-independent sentinel bucket
+        // key (which must bypass path/dir resolution); everything else keys by project path.
+        const scopeParam = (raw) => (raw === 'manager' || raw === 'company') ? raw : undefined;
         this.app.get('/api/ai-hub/conversations', (req, res) => {
-            const projectPath = typeof req.query.projectPath === 'string' && req.query.projectPath.length > 0
-                ? path_1.default.resolve(req.query.projectPath)
-                : this.projectPath;
-            const loaded = this.conversationStore.loadProject(projectPath);
-            return res.json({ projectPath, ...loaded, source: 'disk' });
+            const scope = scopeParam(req.query.scope);
+            const key = scope
+                ? (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);
+            const loaded = this.conversationStore.loadProject(key);
+            return res.json({ projectPath: key, scope: scope ?? 'project', ...loaded, source: 'disk' });
         });
         this.app.put('/api/ai-hub/conversations', (req, res) => {
             try {
                 const body = (req.body ?? {});
-                const projectPath = ensureDirectoryPath(body.projectPath || this.projectPath);
+                const scope = scopeParam(body.scope);
+                const key = scope ? (0, conversation_store_1.conversationScopeKey)(scope, '') : ensureDirectoryPath(body.projectPath || this.projectPath);
                 if (!Array.isArray(body.conversations)) {
                     return res.status(400).json({ error: 'conversations array required' });
                 }
-                const saved = this.conversationStore.replaceProject(projectPath, {
+                const saved = this.conversationStore.replaceProject(key, {
                     activeId: body.activeId ?? null,
                     conversations: body.conversations,
                 });
-                return res.json({ projectPath, ...saved, source: 'disk' });
+                return res.json({ projectPath: key, scope: scope ?? 'project', ...saved, source: 'disk' });
             }
             catch (error) {
                 return res.status(400).json({ error: error instanceof Error ? error.message : 'Could not persist conversations.' });
@@ -2091,7 +2202,8 @@ class AiHubServer {
         this.app.patch('/api/ai-hub/conversations/:conversationId', (req, res) => {
             try {
                 const body = (req.body ?? {});
-                const projectPath = ensureDirectoryPath(body.projectPath || this.projectPath);
+                const scope = scopeParam(body.scope);
+                const projectPath = scope ? (0, conversation_store_1.conversationScopeKey)(scope, '') : ensureDirectoryPath(body.projectPath || this.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 });
@@ -2123,6 +2235,46 @@ class AiHubServer {
                 return res.status(400).json({ error: error instanceof Error ? error.message : 'Could not persist projects.' });
             }
         });
+        // Issue #719: DELETE /api/ai-hub/projects/:id — remove a project from the Hub.
+        // PUT is a merge by design and cannot express removal, so removal gets its own
+        // route (same convention as /schedules/:id, /webhooks/:id, /hosts/:id). Deletes
+        // every server-side derivation layer — preferences entry, conversation-store
+        // KEY, project-scoped deployments — so the project cannot resurrect (R3/R6/R9).
+        // Never touches anything under the project's folderPath (R8).
+        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;
+            const known = this.knownProjects(projectPath);
+            const entry = known.find((project) => project.id === req.params.id);
+            if (!entry)
+                return res.status(404).json({ error: 'Project not found.' });
+            // The current projectPath is unconditionally re-injected on every load, so
+            // deleting it would resurrect on the next request — reject as a sequencing
+            // error; the client switches workspaces before deleting (R5/D4).
+            if (sameDirectoryPath(entry.folderPath, projectPath)) {
+                return res.status(409).json({ error: 'Cannot remove the current project. Switch to another project first.' });
+            }
+            // A live schedule/webhook would fire later, write a conversation under the
+            // removed folderPath, and resurrect the project in the background (R6).
+            for (const deployment of this.deploymentStore.load()) {
+                if (!deploymentBelongsToProject(deployment, entry.folderPath, this.projectPath))
+                    continue;
+                const task = this.cronHandles.get(deployment.id);
+                if (task) {
+                    task.stop();
+                    this.cronHandles.delete(deployment.id);
+                }
+                this.deploymentStore.delete(deployment.id);
+            }
+            // Delete the conversation-store KEY — an empty list would still re-derive
+            // the project via listProjectPaths (R9).
+            this.conversationStore.removeProject(entry.folderPath);
+            // Persist the filtered list directly: saveKnownProjects unions with the
+            // derived list by design and cannot express removal.
+            const projects = this.preferencesStore.saveProjects(projectPath, known.filter((project) => project.id !== entry.id));
+            return res.json({ ok: true, projects });
+        });
         this.app.post('/api/ai-hub/api-key', (req, res) => {
             const { apiKey } = req.body;
             if (!apiKey || typeof apiKey !== 'string')
@@ -2355,11 +2507,15 @@ class AiHubServer {
                     throw new Error('Choose a FRAIM job before starting a run.');
                 }
                 const startTimestamp = new Date().toISOString();
+                const jobMetadata = this.resolveHubJob(projectPath, jobId);
+                const fallbackJobTitle = typeof req.body.jobTitle === 'string' && req.body.jobTitle.trim()
+                    ? req.body.jobTitle.trim()
+                    : jobId;
                 const run = {
                     id: (0, crypto_1.randomUUID)(),
                     conversationId: typeof req.body.conversationId === 'string' && req.body.conversationId.trim() ? req.body.conversationId.trim() : undefined,
                     conversationTitle: typeof req.body.conversationTitle === 'string' && req.body.conversationTitle.trim() ? req.body.conversationTitle.trim() : undefined,
-                    jobTitle: typeof req.body.jobTitle === 'string' && req.body.jobTitle.trim() ? req.body.jobTitle.trim() : jobId,
+                    jobTitle: jobMetadata?.title || fallbackJobTitle,
                     jobId,
                     hostId,
                     projectPath,
@@ -2373,7 +2529,7 @@ class AiHubServer {
                     phaseHistory: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
-                    personaKey: getProtectedPersonaForHubJob(jobId),
+                    personaKey: jobMetadata?.personaKey ?? getProtectedPersonaForHubJob(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.
@@ -2426,8 +2582,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -2460,7 +2618,7 @@ class AiHubServer {
                         if (latest)
                             this.drainPendingDelegatedReviews(latest);
                     },
-                }, run.sessionId);
+                }, startSessionSeedForHost(hostId, run.id));
                 this.runRegistry.attachChildIfRunning(run.id, child);
                 // Issue #442: spawn the Direct run via startDirectRun so CliHostRuntime
                 // uses buildDirectStartPlan (--strict-mcp-config, raw stdin) rather than
@@ -2489,7 +2647,7 @@ class AiHubServer {
                             });
                             this.runRegistry.dispose(directId);
                         },
-                    }, directRun.sessionId);
+                    }, startSessionSeedForHost(hostId, directRun.id));
                     this.runRegistry.attachChildIfRunning(directRun.id, directChild);
                 }
                 const existingPreferences = this.preferencesStore.load(projectPath);
@@ -2615,8 +2773,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -2677,16 +2837,27 @@ class AiHubServer {
                 if (!employee?.available) {
                     throw new Error(`${employee?.label || 'Selected employee'} is not available on this machine.`);
                 }
+                const conversationId = typeof body.conversationId === 'string' && body.conversationId.trim()
+                    ? body.conversationId.trim()
+                    : undefined;
+                const persistedConversation = conversationId
+                    ? this.conversationStore.loadProject(projectPath).conversations.find((entry) => entry.id === conversationId)
+                    : undefined;
+                const persistedRun = readPersistedRunProjection(persistedConversation);
                 const now = new Date().toISOString();
                 const run = {
                     id: (0, crypto_1.randomUUID)(),
-                    conversationId: typeof body.conversationId === 'string' && body.conversationId.trim() ? body.conversationId.trim() : undefined,
+                    conversationId,
                     conversationTitle: typeof body.conversationTitle === 'string' && body.conversationTitle.trim() ? body.conversationTitle.trim() : undefined,
                     jobTitle: typeof body.jobTitle === 'string' && body.jobTitle.trim() ? body.jobTitle.trim() : jobId,
                     jobId, hostId, projectPath, status: 'running', sessionId,
                     createdAt: now, updatedAt: now, messages: [],
                     events: [(0, hosts_1.createHubEvent)('system', `Resuming ${hostId} session ${sessionId} in ${projectPath}`)],
-                    currentPhase: null, phaseHistory: [], totals: emptyTotals(), lastStatusChangeAt: now,
+                    currentPhase: persistedRun?.currentPhase || null,
+                    phaseHistory: persistedRun?.phaseHistory || [],
+                    totals: persistedRun?.totals || emptyTotals(),
+                    lastStatusChangeAt: now,
+                    runDiscriminant: persistedRun?.runDiscriminant || undefined,
                     personaKey: getProtectedPersonaForHubJob(jobId),
                 };
                 // Continue-turn message (FRAIM invocation for the job + instructions) plus
@@ -2710,8 +2881,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -3139,8 +3312,10 @@ class AiHubServer {
                                 current.events.push((0, hosts_1.createHubEvent)(channel, event.raw));
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -3153,7 +3328,7 @@ class AiHubServer {
                         });
                         this.runRegistry.dispose(run.id);
                     },
-                }, run.sessionId);
+                }, startSessionSeedForHost(hostId, run.id));
                 // Update the registry entry with the real child process handle.
                 this.runRegistry.attachChildIfRunning(run.id, child);
                 return res.json({ runId: run.id, status: 'started', employee: employeeId, job: jobName });
@@ -3259,8 +3434,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -3280,7 +3457,7 @@ class AiHubServer {
                 this.deploymentStore.update(deployment.id, (d) => { d.activeRunId = undefined; });
                 this.runRegistry.dispose(run.id);
             },
-        });
+        }, startSessionSeedForHost(deployment.hostId, run.id));
         this.runRegistry.create(run, child);
         this.deploymentStore.update(deployment.id, (d) => { d.activeRunId = run.id; });
         return run;

package/dist/src/cli/commands/add-ide.js

@@ -281,6 +281,7 @@ const listSupportedIDEs = () => {
     console.log(chalk_1.default.yellow('   Example: fraim add-ide --ide claude-code'));
     console.log(chalk_1.default.yellow('   Anthropic aliases: claude, claude-code, claude-desktop, claude-cowork'));
     console.log(chalk_1.default.yellow('   Gemini aliases: gemini, gemini-cli, gemini cli'));
+    console.log(chalk_1.default.yellow('   GitHub Copilot CLI aliases: copilot, copilot-cli, github copilot cli'));
 };
 const promptForIDESelection = async (availableIDEs, tokens) => {
     console.log(chalk_1.default.green(`✅ Found ${availableIDEs.length} IDEs that can be configured:\n`));
@@ -385,7 +386,7 @@ const runAddIDE = async (options) => {
         const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
         if (detectedIDEs.length === 0) {
             console.log(chalk_1.default.yellow('⚠️ No supported IDEs detected on your system.'));
-            console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, Kiro, Cursor, VSCode, Codex, Grok, Windsurf'));
+            console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, GitHub Copilot CLI, Kiro, Cursor, VSCode, Codex, Grok, Windsurf'));
             console.log(chalk_1.default.blue('\n💡 Install an IDE and run this command again.'));
             return;
         }
@@ -455,7 +456,7 @@ const runAddIDE = async (options) => {
 exports.runAddIDE = runAddIDE;
 exports.addIDECommand = new commander_1.Command('add-ide')
     .description('Add FRAIM configuration to additional IDEs')
-    .option('--ide <name>', 'Configure specific IDE (claude, claude-code, claude-desktop, claude-cowork, antigravity, gemini, gemini-cli, kiro, cursor, vscode, codex, grok, windsurf)')
+    .option('--ide <name>', 'Configure specific IDE (claude, claude-code, claude-desktop, claude-cowork, antigravity, gemini, gemini-cli, copilot, copilot-cli, kiro, cursor, vscode, codex, grok, windsurf)')
     .option('--all', 'Configure all detected IDEs')
     .option('--list', 'List all supported IDEs and their detection status')
     .action(exports.runAddIDE);

package/dist/src/cli/commands/add-provider.js

@@ -52,6 +52,10 @@ const forEachInstalledIDE = async (callback) => {
 const writeOAuthProviderToIDEConfigs = async (provider, mcpUrl) => {
     const urlOnlyEntry = { type: 'http', url: mcpUrl };
     await forEachInstalledIDE(async (ide, configPath) => {
+        if (provider === 'github' && ide.configType === 'copilot-cli') {
+            console.log(chalk_1.default.gray(`Skipped ${ide.name} GitHub MCP entry (built into Copilot CLI)`));
+            return;
+        }
         if (ide.configFormat === 'json') {
             let ideConfig = {};
             if (fs_1.default.existsSync(configPath)) {
@@ -61,7 +65,9 @@ const writeOAuthProviderToIDEConfigs = async (provider, mcpUrl) => {
             if (!ideConfig[serversKey]) {
                 ideConfig[serversKey] = {};
             }
-            ideConfig[serversKey][provider] = urlOnlyEntry;
+            ideConfig[serversKey][provider] = ide.configType === 'copilot-cli'
+                ? { ...urlOnlyEntry, tools: ['*'] }
+                : urlOnlyEntry;
             fs_1.default.writeFileSync(configPath, JSON.stringify(ideConfig, null, 2));
             console.log(chalk_1.default.green(`✅ Updated ${ide.name} config`));
         }

package/dist/src/cli/commands/sync.js

@@ -135,7 +135,8 @@ async function cleanupStaleAdapterFiles(projectRoot, allowedConfigTypes) {
     const { promisify } = await Promise.resolve().then(() => __importStar(require('util')));
     const execFileAsync = promisify(execFile);
     for (const [relPath, configType] of Object.entries((0, agent_adapters_1.getAdapterConfigTypes)())) {
-        if (configType === 'standard' || allowedConfigTypes.includes(configType)) {
+        const configTypes = Array.isArray(configType) ? configType : [configType];
+        if (configTypes.includes('standard') || configTypes.some((type) => allowedConfigTypes.includes(type))) {
             continue;
         }
         const fullPath = path_1.default.join(projectRoot, relPath);

package/dist/src/cli/mcp/ide-formats.js

@@ -2,7 +2,7 @@
 // IDE Format Adapters - transform logical server structure to IDE-specific formats
 // Uses the centralized registry to determine server types
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IDE_FORMATS = exports.GrokFormat = exports.CodexFormat = exports.WindsurfFormat = exports.ClaudeCodeFormat = exports.ClaudeFormat = exports.GeminiCliFormat = exports.VSCodeFormat = exports.KiroFormat = exports.StandardFormat = void 0;
+exports.IDE_FORMATS = exports.GrokFormat = exports.CodexFormat = exports.WindsurfFormat = exports.ClaudeCodeFormat = exports.ClaudeFormat = exports.CopilotCliFormat = exports.GeminiCliFormat = exports.VSCodeFormat = exports.KiroFormat = exports.StandardFormat = void 0;
 exports.getIDEFormat = getIDEFormat;
 const mcp_server_registry_1 = require("./mcp-server-registry");
 const provider_registry_1 = require("../providers/provider-registry");
@@ -120,6 +120,40 @@ class GeminiCliFormat {
     }
 }
 exports.GeminiCliFormat = GeminiCliFormat;
+class CopilotCliFormat {
+    constructor() {
+        this.name = 'copilot-cli';
+    }
+    transform(servers) {
+        const mcpServers = {};
+        for (const [key, server] of servers) {
+            // GitHub MCP is built into Copilot CLI. Avoid a duplicate user-configured
+            // github entry and let Copilot handle its native GitHub auth path.
+            if (key === 'github') {
+                continue;
+            }
+            if (server.url) {
+                mcpServers[key] = {
+                    type: server.type === 'sse' ? 'sse' : 'http',
+                    url: server.url,
+                    ...(server.headers && { headers: server.headers }),
+                    tools: ['*']
+                };
+            }
+            else {
+                mcpServers[key] = {
+                    type: 'stdio',
+                    command: server.command,
+                    ...(server.args && { args: server.args }),
+                    ...(server.env && { env: server.env }),
+                    tools: ['*']
+                };
+            }
+        }
+        return { mcpServers };
+    }
+}
+exports.CopilotCliFormat = CopilotCliFormat;
 // Claude Desktop format (excludes provider servers - Issue #132)
 class ClaudeFormat {
     constructor() {
@@ -267,6 +301,7 @@ exports.IDE_FORMATS = {
     kiro: new KiroFormat(),
     vscode: new VSCodeFormat(),
     'gemini-cli': new GeminiCliFormat(),
+    'copilot-cli': new CopilotCliFormat(),
     claude: new ClaudeFormat(),
     'claude-code': new ClaudeCodeFormat(),
     windsurf: new WindsurfFormat(),

package/dist/src/cli/setup/auto-mcp-setup.js

@@ -233,7 +233,7 @@ const autoConfigureMCP = async (fraimKey, selectedIDEs) => {
     const detectedIDEs = (0, ide_detector_1.detectInstalledIDEs)();
     if (detectedIDEs.length === 0 && (!selectedIDEs || selectedIDEs.length === 0)) {
         console.log(chalk_1.default.yellow('⚠️ No supported IDEs detected.'));
-        console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, Kiro, Cursor, VSCode, Codex, Grok, Windsurf'));
+        console.log(chalk_1.default.gray('Supported IDEs: Claude, Claude Code, Antigravity, Gemini CLI, GitHub Copilot CLI, Kiro, Cursor, VSCode, Codex, Grok, Windsurf'));
         console.log(chalk_1.default.blue('\n💡 You can install an IDE and run setup again later.'));
         console.log(chalk_1.default.gray('   Or continue with manual MCP configuration.'));
         if (process.env.FRAIM_NON_INTERACTIVE) {