gsxdsm 3cd023fa43 FN-8491: add declarative plugin MCP server registrations ...

Enable plugins to declare per-project MCP server registrations.

- Add plugin MCP server contribution types, loading, and resolution across core and engine runtimes.
- Expose resolved plugin registrations through project configuration APIs and MCP settings UI.
- Document the declarative contribution API and add release metadata and regression coverage.

Files changed:
 .changeset/plugin-mcp-servers.md                   |  7 ++
 docs/PLUGIN_AUTHORING.md                           | 17 +++++
 docs/mcp.md                                        |  4 ++
 docs/settings-reference.md                         |  4 ++
 packages/core/src/__tests__/mcp-config.test.ts     | 33 +++++++++
 .../__tests__/plugin-contribution-types.test.ts    | 16 +++++
 .../__tests__/plugin-loader-single-load.test.ts    | 23 +++++++
 packages/core/src/index.gate.ts                    |  3 +
 packages/core/src/index.ts                         |  3 +
 packages/core/src/mcp-config.ts                    | 37 ++++++++--
 packages/core/src/plugin-loader.ts                 | 24 +++++++
 packages/core/src/plugin-mcp-servers.ts            | 78 ++++++++++++++++++++++
 packages/core/src/plugin-types.ts                  | 15 ++++-
 packages/core/src/types.ts                         |  2 +-
 .../__tests__/SettingsModal.mcp.test.tsx           | 34 +++++++++-
 .../settings/sections/McpServersCard.tsx           | 52 ++++++++++-----
 .../settings/sections/ProjectMcpSection.tsx        | 31 ++++++++-
 .../register-config-mcp-pi-settings-routes.test.ts | 18 ++++-
 packages/dashboard/src/routes/context.ts           | 71 +++++++++++++++++++-
 .../register-config-mcp-pi-settings-routes.ts      | 30 ++++++++-
 .../engine/src/__tests__/mcp-resolution.test.ts    | 20 ++++++
 packages/engine/src/mcp-resolution.ts              | 15 ++++-
 packages/engine/src/plugin-runner.ts               | 38 +++++++++++
 packages/engine/src/runtimes/in-process-runtime.ts | 23 +++++++
 packages/plugin-sdk/src/index.ts                   |  1 +
 25 files changed, 563 insertions(+), 36 deletions(-)

Fusion-Task-Id: FN-8491

Fusion-Task-Lineage: be7e22fa-5776-4b3d-9fd1-a873799e6427

Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>

2026-07-22 15:25:20 -07:00

..

__tests__

FN-8488: add branded icons for first-class providers

2026-07-22 14:42:04 -07:00

lib

FN-8133: add local codebase context metrics

2026-07-16 14:08:43 -07:00

plugins

…

routes

FN-8491: add declarative plugin MCP server registrations

2026-07-22 15:25:20 -07:00

signal-sources

FN-7427: add GitLab signal connector

2026-07-02 11:38:35 -07:00

test

fix(ci): mock createAgentTask for route tests; quarantine merge-reuse slow flake (#2327)

2026-07-18 16:08:14 -07:00

types/node-pty

…

agent-generation.ts

FN-7078: forward MCP config to planning helpers

2026-06-26 17:38:41 -07:00

agent-onboarding.ts

Recover malformed agent interview responses (#2146)

2026-07-15 18:07:37 -07:00

ai-refine.ts

FN-7078: forward MCP config to planning helpers

2026-06-26 17:38:41 -07:00

ai-session-diagnostics.ts

…

ai-session-store.ts

FN-8442: redesign planning mode as sequential Q&A

2026-07-20 14:59:22 -07:00

ai-session-timeout.ts

FN-7951: harden runGenerationWithTimeout abort cancellation across planning surfaces

2026-07-13 13:58:35 -07:00

ai-translate.ts

FN-8230: translate GitHub import issues across pages

2026-07-17 13:31:42 -07:00

api-error.ts

fix: surface API 500 causes, guide update EACCES, non-zero daemon signal exit

2026-07-10 21:36:43 -07:00

artifact-media.ts

FN-8333: embed report screenshots in GitHub filings

2026-07-19 18:45:27 -07:00

auth-middleware.ts

feat(dashboard): add cli-agent hook ingestion route and session hook scripts (U17)

2026-06-04 23:39:07 -07:00

auth-paths.ts

…

badge-pubsub.ts

…

chat-attachment-content.ts

fix: give Grok ACP absolute paths for chat image attachments

2026-07-12 09:56:26 -07:00

chat-project-services.ts

fix(FN-7952): establish PostgreSQL core authority (#2108)

2026-07-14 22:13:30 -07:00

chat.ts

FN-8443: fix chat plugin skill loading

2026-07-20 12:32:01 -07:00

claude-cli-probe.ts

…

claude-model-cache.ts

FN-8224: add Claude ACP runtime support

2026-07-17 12:00:26 -07:00

cli-chat.ts

feat: migrate storage from SQLite to PostgreSQL (#1793)

2026-07-13 19:07:58 -07:00

cli-package-version.ts

FN-7471: fix desktop update version fallback

2026-07-03 21:45:20 -07:00

cli-session-output-filter.ts

fix(ci): resolve lint errors (useless-escape, prefer-const, unused param)

2026-06-05 03:56:29 -07:00

cli-session-transport.ts

FN-6464: add CLI session relaunch route

2026-06-15 02:30:41 -07:00

cli-session-ws.ts

fix(review): schema-version gate, output-filter escape-bypass, generic double-wrap, follow-up resolution

2026-06-05 03:41:54 -07:00

command-center-csv.ts

FN-7449: include chat token usage in dashboard totals

2026-07-02 15:00:40 -07:00

cursor-model-cache.ts

FN-7710: refresh model caches so Grok/Cursor CLI models appear without reopening Settings

2026-07-09 19:58:03 -07:00

dashboard-postgres-health.ts

fix: prevent false PostgreSQL corruption alerts (#2352)

2026-07-19 18:59:28 -07:00

dev-server-detect.ts

…

dev-server-manager.ts

…

dev-server-port-detect.ts

…

dev-server-process.ts

FN-8394: rescue deterministic quarantined tests

2026-07-19 18:59:36 -07:00

dev-server-routes.ts

…

dev-server-store.ts

…

devserver-detect.ts

…

devserver-manager.ts

…

devserver-persistence.ts

…

devserver-types.ts

…

droid-cli-probe.ts

…

evals-routes.ts

fix: resolve an explicit central-registry project id for all dashboard API requests

2026-07-13 23:16:36 -07:00

exec-file.ts

…

experiment-routes.ts

…

file-service.ts

FN-7264: add opt-in absolute file-browser paths

2026-06-29 23:17:49 -07:00

fn-binary-local-install.ts

feat(dashboard): build/link local fn and npm restore from System panel

2026-07-15 10:07:20 -07:00

fusion-release-version.ts

docs(FN-7575): correct the FNXC rationale on the issue-comment services

2026-07-15 19:29:02 -07:00

git-worktree-safety.ts

FN-7253: add worktree picker to terminal sessions

2026-06-30 00:03:37 -07:00

github-auth.ts

…

github-issue-comment.ts

fix(FN-7575): stop double-commenting when a task is both imported and tracked

2026-07-15 20:24:49 -07:00

github-poll.ts

…

github-source-issue-close.ts

FN-6194: fix archived GitHub issue reconciliation

2026-06-10 10:34:36 -07:00

github-tracking-comments.ts

fix(github): dedupe task progress updates

2026-07-21 17:14:30 -07:00

github-tracking-dedup.ts

…

github-tracking-hook.ts

…

github-tracking-reconciler.ts

feat(dashboard): page GitHub issue import + fix close-on-Done backstop

2026-07-16 09:33:20 -07:00

github-tracking-state.ts

refactor(cutover 3/3): dashboard + changesets — IR-driven lifecycle cutover (#2335)

2026-07-19 12:09:12 -07:00

github-tracking.ts

fix(FN-7579): stop tracking-issue dedup from linking new tasks to stale issues

2026-07-05 11:31:48 -07:00

github-webhooks.ts

…

github.ts

fix(dashboard): honor forced GraphQL transport (#2353)

2026-07-20 08:49:28 -07:00

gitlab-auth.ts

FN-7453: add GitLab enablement controls

2026-07-02 19:01:09 -07:00

gitlab-issue-comment.ts

fix(FN-7575): stop double-commenting when a task is both imported and tracked

2026-07-15 20:24:49 -07:00

gitlab-lifecycle.ts

FN-7426: add GitLab lifecycle automation

2026-07-02 11:38:34 -07:00

gitlab-source-issue-close.ts

FN-7426: add GitLab lifecycle automation

2026-07-02 11:38:34 -07:00

gitlab-source-issue-reconciler.ts

FN-7428: add GitLab tracking coverage and reconciliation support

2026-07-02 12:34:35 -07:00

gitlab-tracking-comments.ts

fix(FN-7575): post release version lines on the surface that actually comments

2026-07-15 19:07:51 -07:00

gitlab-tracking-state.ts

FN-7426: add GitLab lifecycle automation

2026-07-02 11:38:34 -07:00

gitlab.ts

feat(dashboard): attach issue images on GitHub and GitLab import (#2151)

2026-07-15 21:58:46 -07:00

goals-routes.ts

fix: resolve an explicit central-registry project id for all dashboard API requests

2026-07-13 23:16:36 -07:00

grok-model-cache.ts

FN-7710: refresh model caches so Grok/Cursor CLI models appear without reopening Settings

2026-07-09 19:58:03 -07:00

hermes-model-cache.ts

FN-7636: surface Hermes runtime models in /api/models picker

2026-07-07 22:04:55 -07:00

ideation-routes.ts

FN-8295: add persisted ideation mission handoffs

2026-07-18 13:18:08 -07:00

import-translate-service.ts

FN-8230: translate GitHub import issues across pages

2026-07-17 13:31:42 -07:00

index.ts

FN-8308: add selectable GitHub Discussions report targets

2026-07-19 18:37:45 -07:00

insight-run-sweeper.ts

feat: migrate storage from SQLite to PostgreSQL (#1793)

2026-07-13 19:07:58 -07:00

insights-routes.ts

Fix multi-project branch-group route store scoping (#2085)

2026-07-14 00:12:22 -07:00

issue-image-attachments.ts

FN-8333: embed report screenshots in GitHub filings

2026-07-19 18:45:27 -07:00

knowledge-index-refresh.ts

feat(knowledge): U14 — persistent knowledge index

2026-06-15 20:34:52 -07:00

knowledge-index.ts

fix(FN-7952): cut runtime services over to PostgreSQL (#2109)

2026-07-14 22:16:16 -07:00

llama-cpp-probe.ts

…

milestone-slice-interview.ts

fix(dashboard): stop Planning Mode retry loop, make AI sessions multi-tab (#2101)

2026-07-14 18:47:53 -07:00

mission-interview.ts

FN-8414: fix mission interview thinking-level binding

2026-07-19 21:04:43 -07:00

mission-routes.ts

feat(core): reconcile archived mission evidence atomically (#2379)

2026-07-22 13:46:08 -07:00

monitor-store.ts

Harden PostgreSQL migration foundation (#2088)

2026-07-14 08:16:42 -07:00

monitor-trait.ts

fix(FN-7952): cut runtime services over to PostgreSQL (#2109)

2026-07-14 22:16:16 -07:00

native-structure-preview.ts

FN-8358: add roadmap-item structure previews

2026-07-19 15:45:45 -07:00

omp-model-cache.ts

feat: add Oh My Pi (omp) ACP runtime plugin (#2083)

2026-07-14 08:18:52 -07:00

otel-exporter.ts

fix(FN-7952): cut runtime services over to PostgreSQL (#2109)

2026-07-14 22:16:16 -07:00

planning-board-tools.ts

FN-7127: standardize task show tool naming

2026-06-27 12:25:53 -07:00

planning.ts

fix(planning): keep questions out of mailbox

2026-07-21 10:04:19 -07:00

plugin-routes.ts

fix(dashboard): mount plugin routes without engine

2026-07-22 13:47:58 -07:00

pr-conflict-resolver.ts

fix(cli): pass engine PluginRunner into hosts, not PluginLoader

2026-07-15 10:24:30 -07:00

pr-metadata-generator.ts

FN-7181: improve PR metadata generation feedback

2026-06-28 01:17:22 -07:00

process-lifecycle.ts

FN-6488: centralize dashboard beforeExit cleanup

2026-06-16 15:08:24 -07:00

project-store-resolver.ts

FN-8453: unify concurrency accounting and indicators

2026-07-21 15:30:31 -07:00

provider-health-monitor.ts

fix(engine): isolate provider rate-limit pauses (#2339)

2026-07-21 17:08:44 -07:00

rate-limit.ts

…

registry-manifest.json

FN-7443: add bundled Linear import plugin

2026-07-02 14:31:16 -07:00

reliability-metrics.ts

…

remote-auth.ts

…

report-help-selfcheck.ts

FN-8277: add in-app agentic reporting

2026-07-18 10:55:50 -07:00

report-pipeline.ts

FN-8327: fall back to issues when Discussions are disabled

2026-07-19 20:42:05 -07:00

report-roadmap-source.ts

FN-8326: add roadmap report deduplication

2026-07-18 14:23:14 -07:00

report-scrub.ts

FN-8317: add reviewed report screenshots and activity traces

2026-07-18 17:06:34 -07:00

require-async-layer.ts

fix(FN-7952): establish PostgreSQL core authority (#2108)

2026-07-14 22:13:30 -07:00

research-routes.ts

FN-8297: add research finding promotion to mission features

2026-07-18 16:18:15 -07:00

roadmap-routes.ts

…

roadmap-suggestions.ts

…

routes.ts

FN-8402: extract config, MCP, and Pi settings routes

2026-07-20 09:35:55 -07:00

runtime-logger.ts

…

runtime-provider-probes.ts

FN-8224: add Claude ACP runtime support

2026-07-17 12:00:26 -07:00

script-store.ts

…

server.ts

fix(dashboard): honor beta channel on Settings check for updates

2026-07-21 20:40:55 -07:00

signal-source.ts

FN-7427: add GitLab signal connector

2026-07-02 11:38:35 -07:00

skills-adapter.ts

FN-7954: fix plugin skill toggle keys for custom skillFiles paths

2026-07-15 10:38:04 -07:00

sse-buffer.ts

…

sse.ts

fix: hide stale task-card oversight icons (#2318)

2026-07-18 13:50:58 -07:00

subtask-breakdown.ts

fix(dashboard): stop Planning Mode retry loop, make AI sessions multi-tab (#2101)

2026-07-14 18:47:53 -07:00

task-planner-chat-context.ts

FN-7407: enable done-task planner refinements

2026-07-01 23:44:05 -07:00

task-planner-chat-metrics.ts

FN-8444: include planning time in task metrics

2026-07-20 13:40:50 -07:00

terminal-service.ts

FN-7688: add slow login-shell profile latency hint and docs

2026-07-08 10:06:42 -07:00

terminal-websocket-diagnostics.ts

…

terminal.ts

…

test-request.ts

Address PR review feedback (#1996)

2026-07-10 23:42:10 -07:00

todo-routes.ts

FN-8198: add Todo item task creation API

2026-07-17 01:23:32 -07:00

triage-trait.ts

feat: migrate storage from SQLite to PostgreSQL (#1793)

2026-07-13 19:07:58 -07:00

update-check.ts

feat: add beta/stable release tracks with switchable update channel (#2345)

2026-07-19 13:34:25 -07:00

usage.ts

fix(engine): isolate provider rate-limit pauses (#2339)

2026-07-21 17:08:44 -07:00

view-chunk-manifest.ts

FN-6881: move stash recovery into Git Manager

2026-06-21 20:28:33 -07:00

websocket.ts

…