fix(dashboard): add missing vite alias for compound-engineering plugin

[gsxdsm]

Adds the missing Vite resolve.alias entries for @fusion-plugin-examples/compound-engineering so the dashboard can load the plugin's view and index modules. Without these aliases, the dynamic import in registerBundledPluginViews.ts fails to resolve, causing the Compound Engineering plugin to fail to enable.

---

Summary by CodeRabbit

• Chores

  • Updated development build configuration to add module aliases so bundled plugin dashboard views resolve correctly during local builds.

• Documentation

  • Added a troubleshooting guide explaining symptoms and fixes when bundled plugin dashboard views fail to load, including recommended alias additions and prevention guidance.

[coderabbitai]

Too much diff to scan? Review this PR in Change Stack to start with the highest-impact changes.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: b708f7e8-e491-4f53-a8cf-7d9236147087

📥 Commits

Reviewing files that changed from the base of the PR and between e941cb6 and c02cbde.

📒 Files selected for processing (1)

• docs/solutions/integration-issues/bundled-plugin-vite-alias-missing.md

✅ Files skipped from review due to trivial changes (1)

• docs/solutions/integration-issues/bundled-plugin-vite-alias-missing.md

---

📝 Walkthrough

Walkthrough

Adds two Vite resolve.alias entries for the @fusion-plugin-examples/compound-engineering plugin in the dashboard package and adds a docs page describing the missing-alias integration issue, symptoms, and the exact aliases to apply.

Changes

Module Alias Configuration and Documentation

Layer / File(s)	Summary
Compound Engineering plugin aliases packages/dashboard/vite.config.ts	Two resolve aliases added: @fusion-plugin-examples/compound-engineering/dashboard-view → ../../plugins/fusion-plugin-compound-engineering/src/dashboard-view.tsx and @fusion-plugin-examples/compound-engineering → ../../plugins/fusion-plugin-compound-engineering/src/index.ts.
Documentation: bundled plugin alias issue docs/solutions/integration-issues/bundled-plugin-vite-alias-missing.md	New doc describes symptoms (including the misleading "unknown file extension ".css"" error), root cause (missing Vite alias for runtime dynamic imports), exact aliases to add, prevention checklist, and related links.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰
I hopped through Vite to find a clue,
Mapped view and root so imports chew through,
Dashboard and plugin now handshake sweet,
Paths aligned — a tidy little feat.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately summarizes the main change: adding missing Vite aliases for the compound-engineering plugin in the dashboard configuration.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch gsxdsm/compound-debug

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[greptile-apps]

Greptile Summary

Adds the missing resolve.alias entries for @fusion-plugin-examples/compound-engineering in the dashboard's Vite config, enabling the Compound Engineering plugin's dashboard view to resolve correctly. A companion runbook is added under docs/solutions/ explaining the root cause, the misleading .css error, and how to prevent recurrence.

• packages/dashboard/vite.config.ts: Two aliases added — @fusion-plugin-examples/compound-engineering/dashboard-view → src/dashboard-view.tsx and @fusion-plugin-examples/compound-engineering → src/index.ts. Both target files exist, and the more-specific sub-path alias is correctly placed before the package-root alias so Vite's first-match ordering works as intended.
• docs/solutions/integration-issues/bundled-plugin-vite-alias-missing.md: New runbook documenting the problem, the misleading error surface, and prevention advice including a suggestion for a consistency test that would catch future alias drift.

Confidence Score: 5/5

Safe to merge — the change is a targeted config addition with no logic modifications.

Both target files (src/dashboard-view.tsx and src/index.ts) exist at the referenced paths, the alias ordering is correct (sub-path before package root, matching Vite's first-match semantics), and the pattern is identical to the already-working dependency-graph aliases. The documentation accurately reflects the fix and the real module resolution behavior.

No files require special attention.

Important Files Changed

Filename	Overview
packages/dashboard/vite.config.ts	Adds two resolve.alias entries for @fusion-plugin-examples/compound-engineering, following the exact same pattern as the existing dependency-graph aliases. Both target files exist, and the more-specific /dashboard-view alias is correctly ordered before the package-root alias so Vite's first-match resolution works correctly.
docs/solutions/integration-issues/bundled-plugin-vite-alias-missing.md	New runbook documenting the problem, misleading .css error message, solution, and prevention strategy. Accurately describes the @vite-ignore + variable-import pattern and its reliance on resolve.alias. Prevention section correctly suggests a consistency test.

Sequence Diagram

sequenceDiagram
    participant Dashboard as Dashboard App
    participant Vite as Vite Dev Server
    participant Alias as resolve.alias map
    participant Plugin as fusion-plugin-compound-engineering/src

    Dashboard->>Vite: "import(moduleId) where moduleId = "@fusion-plugin-examples/compound-engineering/dashboard-view""
    Vite->>Alias: "look up "@fusion-plugin-examples/compound-engineering/dashboard-view""
    Note over Alias: Before PR: no match → resolution fails<br/>After PR: matches → plugins/.../src/dashboard-view.tsx
    Alias-->>Vite: resolved path (dashboard-view.tsx)
    Vite-->>Plugin: load and transform
    Plugin-->>Dashboard: CompoundEngineeringDashboardView component

Loading

_{Reviews (2): Last reviewed commit: "docs(solutions): document bundled plugin..." | Re-trigger Greptile}