feat(dashboards): Sim-built workspace dashboard behind a rollout flag by TheodoreSpeaks · Pull Request #8305 · simstudioai/sim

TheodoreSpeaks · 2026-09-25T18:58:26Z

Summary

Adds table-backed dashboards behind the default-off dashboards flag, which can target specific organizations. A dashboard is YAML that selects authorized table queries and lays out metrics, ECharts charts, tables, text, and tabs. Aggregation runs on the server with bounded results and timeouts.
One dashboard per workspace, built by Sim.
- The sidebar's Dashboard item sits under New chat and opens it directly: there's no list, header, folders, create, rename, or move.
- Until Sim saves the first one, the page shows an empty state.
- Dashboards live in their own dashboard table with their own id; a unique index on workspace_id keeps one per workspace. Dropping it later allows several.
Agent: Mothership reads and saves the dashboard with dashboards get / dashboards set.
- The first save creates it.
- Replacing existing content requires expectedRevision, so a concurrent edit is never overwritten.
Entitlements: Sim sends an entitlements list with every Mothership turn (lib/mothership/entitlements.ts), restoring the registry v1.0.0 removed.
- dashboards is the first entitlement. Mothership hides gated commands, skills, and prompt text when one is absent.
- Sim still enforces the flag on every operation.
Rendering: shared time-range and timezone controls, drag-to-zoom, synchronized hover, responsive layout, and animated metrics. Conditional percent aggregates reuse the table filter grammar.
Storage: reads and saves go through a small repository; saves are audited as dashboard.created / dashboard.updated. Dashboards are not files, so Files, search, and pickers are untouched.
New icon: a Dashboard EMCN icon drawn on the shared sidebar icon grid.

Companion: https://github.com/simstudioai/mothership/pull/531

Type of Change

New feature

Testing

Repository conflict and revision behavior verified against real PostgreSQL (lib/dashboards/repository.integration.ts)
Dashboard, Mothership, uploads, file search, forks, Chat, and sidebar suites pass (5,758 tests), plus packages/db (104)
Type-check, lint, all audits, block registry, docs manifest, and check:migrations pass
End-to-end Mothership build against a local stack not yet re-run on the table-backed version

Rollout

One migration: 0392_dashboard creates the dashboard table (new table, no backfill, no script migrations).
Forks do not copy the dashboard yet: its YAML references table ids that change in a fork, so copying needs id remapping.
Deploy the companion worker before enabling the flag. It needs its 0013_run_entitlements migration.

Checklist

Code follows project style guidelines
Self-reviewed my changes
Tests added/updated and passing
No new warnings introduced
I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

… flag

vercel · 2026-09-25T18:58:33Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Sep 30, 2026 12:19am UTC

github-actions · 2026-09-25T18:59:55Z

⚠️ Cross-repo companion check

One or more companion PRs aren't merged into staging yet. Merging this without them will leave copilot and sim out of sync — merge them in lockstep.

❌ simstudioai/mothership#531 — OPEN, not merged (targets staging) — feat(dashboards): entitlements and the workspace dashboard commands

Dashboards are now ordinary workspace files, handled like Sim pages, instead of a separate resource. Creating or uploading `<Name>.dashboard` drops the suffix and stamps `text/x-sim-dashboard`; the type is sticky across content writes. The file viewer renders it live behind the `dashboards` flag, and the public share viewer shows a workspace-only notice. - Remove the dashboard resource: sidebar page, API routes, hooks, contracts, application layer, Mothership dashboards/dashboard_folders tools, resource tags, and the per-turn dashboardsEnabled payload. - Revert the file discovery column (0385) and drop the dashboard folder resource enum (0384); dashboards never shipped, so no backfill. - Chat panel decides previewability and tab/picker icons from the file type, not the name, so extensionless dashboards render and get the chart icon. - Renderer: authored left label columns are kept intact, horizontal bar frames grow with row count, and hovered rows get a label-and-bar highlight. - Simplify the create-dashboard skill around one validated example. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6aTRnkiu7PxYZPNPXYEMV

Resolves conflicts in the feature-flag and skill use-case tests (moved onto staging's central mocks) and the tab strip widths. Adapts the branch's dashboard and analytics tests to staging's test-pattern audit, scopes the table operation delegation invariant to operations that admit delegated principals, and hides the rollout-gated create-dashboard built-in from the organization composer when the dashboards flag is off. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6aTRnkiu7PxYZPNPXYEMV

TheodoreSpeaks · 2026-09-26T19:45:12Z

@greptile

TheodoreSpeaks · 2026-09-26T19:45:14Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-09-26T19:45:19Z

@cubic-dev-ai review this PR

@TheodoreSpeaks I have started the AI code review. It will take a few minutes to complete.

greptile-apps · 2026-09-26T19:50:04Z

Confidence Score: 5/5

[Medium risk] Adds dashboard feature behind a rollout flag.

The PR appears safe to merge, though the search-migration integration test should keep its replay isolated from shared test-database rows.

Summary

This PR adds a default-off, one-per-workspace dashboard backed by YAML, authorized table analytics, and a revision-checked save path. It also adds dashboard rendering, Mothership entitlement and resource support, and the dashboard database migration.

The latest change removes a table from a search-migration test fixture; the resulting public-schema fallback is the new finding.
The previously reported findings are resolved or were explicitly left as-is.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  UI[Workspace dashboard] --> Read[Dashboard read]
  Read --> DB[(Dashboard table)]
  UI --> Analytics[Authorized table analytics]
  Agent[Mothership dashboard commands] --> Save[Revision-checked save]
  Save --> DB

_{Reviews (29) · Last reviewed commit: "chore(db): drop leftover script-migratio..."}

cubic-dev-ai

All reported issues were addressed across 86 files

_{Tip: instead of fixing issues one by one fix them all with cubic

Re-trigger cubic}

- Size horizontal bar `.chart` previews by category count like dashboard panels. - Keep the ECharts label column for percentage bar widths, resolve percentage grid insets for the row highlight, and keep the time axis on the queried range. - Show small readout values with significant digits instead of rounding to 0. - Pass the dashboard's timezone-adjusted today to the range calendar. - Decide the Chat panel's Markdown mode from the file record. - Replace mock-call assertions in the EChartsView tests with DOM behavior. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6aTRnkiu7PxYZPNPXYEMV

TheodoreSpeaks · 2026-09-26T20:00:55Z

@greptile

TheodoreSpeaks · 2026-09-26T20:00:57Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-09-26T20:01:04Z

@cubic-dev-ai review this PR

@TheodoreSpeaks I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

All reported issues were addressed across 86 files

_{Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic}

… resizes Unstacked bar series sit side by side in a category row, so grouped charts keep the ECharts label column and their rows fit every bar slot. The row highlight redraws the active row after each render, so a resize moves it with the plot. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6aTRnkiu7PxYZPNPXYEMV

TheodoreSpeaks · 2026-09-29T23:39:54Z

@greptile

TheodoreSpeaks · 2026-09-29T23:39:55Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-09-29T23:40:02Z

@cubic-dev-ai review this PR

@TheodoreSpeaks I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

All reported issues were addressed across 137 files

_{You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.

Fix all with cubic | Re-trigger cubic}

…lookups The dashboard name is fixed, so resource tabs and chat chips no longer fetch the dashboard to title it; dashboard headings use named text sizes.

TheodoreSpeaks · 2026-09-29T23:49:56Z

@greptile

TheodoreSpeaks · 2026-09-29T23:49:57Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-09-29T23:50:06Z

@cubic-dev-ai review this PR

@TheodoreSpeaks I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

No issues found across 137 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.

Re-trigger cubic}

Mothership's create-dashboard skill now carries the dashboard syntax like every other worker skill, so the builtin-create-dashboard workspace skill, its source, and its flag gating are removed.

TheodoreSpeaks · 2026-09-30T00:03:43Z

@greptile

TheodoreSpeaks · 2026-09-30T00:03:44Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-09-30T00:03:52Z

@cubic-dev-ai review this PR

@TheodoreSpeaks I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

No issues found across 132 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.

Re-trigger cubic}

TheodoreSpeaks · 2026-09-30T00:12:28Z

@greptile

TheodoreSpeaks · 2026-09-30T00:12:29Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-09-30T00:12:35Z

@cubic-dev-ai review this PR

@TheodoreSpeaks I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

No issues found across 132 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.

Re-trigger cubic}

TheodoreSpeaks · 2026-09-30T00:16:53Z

@greptile

TheodoreSpeaks · 2026-09-30T00:16:54Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-09-30T00:17:02Z

@cubic-dev-ai review this PR

@TheodoreSpeaks I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

No issues found across 131 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.

Re-trigger cubic}

feat(dashboards): add table-backed dashboard resources behind rollout…

56246d8

… flag

github-actions Bot added the requires-mothership-merge Has a companion PR on the mothership/copilot side — merge in lockstep label Sep 25, 2026

vercel Bot deployed to Preview September 25, 2026 19:00 View deployment

refactor(files): separate discovery from storage context

90bbd59

vercel Bot deployed to Preview September 25, 2026 20:03 View deployment

fix(charts): keep pie labels readable and separate neutral colors

a6e0941

vercel Bot temporarily deployed to Preview September 25, 2026 20:22 Inactive

feat(dashboards): compute percentages from row conditions

f894b9e

vercel Bot temporarily deployed to Preview September 25, 2026 21:36 Inactive

TheodoreSpeaks and others added 2 commits September 26, 2026 12:33

TheodoreSpeaks changed the title ~~feat(dashboards): add table-backed dashboard resources~~ feat(dashboards): table-backed dashboard files behind a rollout flag Sep 26, 2026

TheodoreSpeaks marked this pull request as ready for review September 26, 2026 19:45

TheodoreSpeaks requested a review from a team as a code owner September 26, 2026 19:45

vercel Bot deployed to Preview September 26, 2026 19:46 View deployment

greptile-apps Bot reviewed Sep 26, 2026

View reviewed changes

Comment thread apps/sim/lib/workflows/skills/builtin-skills.ts Outdated

Comment thread apps/sim/app/workspace/[workspaceId]/files/components/file-viewer/chart-preview.tsx Outdated

Comment thread apps/sim/components/charts/echarts-view.test.tsx Outdated

cubic-dev-ai Bot reviewed Sep 26, 2026

View reviewed changes

vercel Bot deployed to Preview September 26, 2026 20:01 View deployment

cubic-dev-ai Bot reviewed Sep 26, 2026

View reviewed changes

Comment thread apps/sim/lib/charts/option.ts Outdated

Comment thread apps/sim/lib/charts/bar-row-highlight.ts Outdated

cubic-dev-ai Bot reviewed Sep 29, 2026

View reviewed changes

Comment thread ...ace/[workspaceId]/home/components/mothership-view/components/resource-tabs/resource-tabs.tsx Outdated

greptile-apps Bot reviewed Sep 29, 2026

View reviewed changes

Comment thread apps/sim/components/dashboards/dashboard-panel.tsx Outdated

fix(dashboards): named heading sizes and no redundant dashboard name …

bcbad6b

…lookups The dashboard name is fixed, so resource tabs and chat chips no longer fetch the dashboard to title it; dashboard headings use named text sizes.

vercel Bot temporarily deployed to Preview September 29, 2026 23:49 Inactive

cubic-dev-ai Bot reviewed Sep 29, 2026

View reviewed changes

greptile-apps Bot reviewed Sep 29, 2026

View reviewed changes

Comment thread apps/sim/app/workspace/[workspaceId]/dashboards/loading.tsx Outdated

Comment thread apps/sim/components/dashboards/dashboard-feature-gate.tsx Outdated

refactor(dashboards): keep the authoring reference in Mothership's skill

54d918d

Mothership's create-dashboard skill now carries the dashboard syntax like every other worker skill, so the builtin-create-dashboard workspace skill, its source, and its flag gating are removed.

vercel Bot temporarily deployed to Preview September 30, 2026 00:03 Inactive

cubic-dev-ai Bot reviewed Sep 30, 2026

View reviewed changes

fix(dashboards): server loading fallback and muted gate text

0c7d596

vercel Bot temporarily deployed to Preview September 30, 2026 00:12 Inactive

cubic-dev-ai Bot reviewed Sep 30, 2026

View reviewed changes

chore(db): drop leftover script-migration test fixture change

51f665e

cubic-dev-ai Bot reviewed Sep 30, 2026

View reviewed changes

vercel Bot deployed to Preview September 30, 2026 00:19 View deployment

Conversation

TheodoreSpeaks commented Sep 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Type of Change

Testing

Rollout

Checklist

Uh oh!

vercel Bot commented Sep 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Sep 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ Cross-repo companion check

Uh oh!

TheodoreSpeaks commented Sep 26, 2026

Uh oh!

TheodoreSpeaks commented Sep 26, 2026

Uh oh!

cubic-dev-ai Bot commented Sep 26, 2026

Uh oh!

greptile-apps Bot commented Sep 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Confidence Score: 5/5

Summary

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

TheodoreSpeaks commented Sep 26, 2026

Uh oh!

TheodoreSpeaks commented Sep 26, 2026

Uh oh!

cubic-dev-ai Bot commented Sep 26, 2026

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

TheodoreSpeaks commented Sep 29, 2026

Uh oh!

TheodoreSpeaks commented Sep 29, 2026

Uh oh!

cubic-dev-ai Bot commented Sep 29, 2026

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

TheodoreSpeaks commented Sep 29, 2026

Uh oh!

TheodoreSpeaks commented Sep 29, 2026

Uh oh!

cubic-dev-ai Bot commented Sep 29, 2026

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

TheodoreSpeaks commented Sep 30, 2026

Uh oh!

TheodoreSpeaks commented Sep 30, 2026

Uh oh!

TheodoreSpeaks commented Sep 25, 2026 •

edited

Loading

vercel Bot commented Sep 25, 2026 •

edited

Loading

github-actions Bot commented Sep 25, 2026 •

edited

Loading

greptile-apps Bot commented Sep 26, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading