Repository navigation
feat: add umf.dashboard platform-neutral dashboard profile - #13
Merged
Merged
Conversation
…indows - .gitattributes: check out text as LF so pinned hashes and byte comparisons hold under core.autocrlf=true - generator scripts record '/' paths (ledger, package and schema audits) - core-ideals evidence and domain-pack boundary checks compare '/' paths, so '..\' escapes are rejected and valid paths aren't flagged unsafe on Windows Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Add umf.dashboard 0.1.0, a semantic extension that describes dashboards independently of Databricks AI/BI (Lakeview) or Tableau: page order, layout grid and theme; canvas and global-filter pages; datasets with grain and column/measure fields; visuals with channel encodings; text blocks; and filters with explicit dataset/field targets. SQL and Tableau expressions are retained with their language and flagged as not interpreted. - spec/extensions/dashboard: extension package and payload schema - src/extensions/dashboard: semantic validator and read/write/inspect/edit API - fixtures/dashboard: Marketing Campaign fixture from a deployed Lakeview dashboard - tests/dashboard: US-077-AC1..AC4 with 28 semantic corruption checks - HELIX: FEAT-026, US-077, CONTRACT-055, TD-077; regenerated ledger and audits Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
garyfischer-maker
marked this pull request as ready for review
October 9, 2026 17:16
easel
approved these changes
Oct 9, 2026
easel
left a comment
Contributor
There was a problem hiding this comment.
Off hand this looks incredible!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Proposes
umf.dashboard0.1.0, a semantic extension that describes a dashboard independently of Databricks AI/BI (Lakeview.lvdash.json) or Tableau (.twb/.twbx). It follows the same pattern asumf.ddd. The goal is to port dashboards between platforms through UMF: nativeumf.lakeview/umf.tableauextensions keep the exact platform detail, this profile holds the shared meaning, and every import or export reports what didn't translate.This PR adds only the neutral profile. Importers, exporters and the native extensions would come in follow-up changes.
Vocabulary
dashboardpages,layout.columnsgrid, optionalthemepagecanvasorglobal-filtersdatadatasetsource,grain,fieldsmarkedcolumnormeasure(measures declare an aggregate expression)visualchart,datasetreference, channelencodings,rowsaggregated/detail,position, optionaltraceidtextfilter{dataset, field}targets, default, positionDesign choices worth reviewing
columnormeasure, not dimension/measure, because a raw numeric column isn't a dimension.DASHBOARD_EXPRESSION_OPAQUE). As with DDD invariants, this marks the document incomplete and blocks the edit API.DASHBOARD_UNKNOWN). Not modeled in 0.1.0: Tableau parameters and actions, per-visual filter exemptions, cross-filter wiring, permissions.Changes
spec/extensions/dashboard/: extension package and payload schemasrc/extensions/dashboard/: semantic validator plusreadDashboardDocument,writeDashboardDocument,inspectDashboard,getDashboardDefinition,editDashboardDefinitionfixtures/dashboard/marketing-campaign.json: built from a deployed Lakeview dashboardtests/dashboard/profile.test.ts: US-077-AC1 to AC4, including 28 deliberate-corruption checksVerification (Windows 11, Bun 1.3.14)
bun test tests/dashboard tests/traceability: 6 passbun run test:schemas: 62/62 packages, 350/350 schemasbun run typecheck: cleanDependencies and open items
dddRoundTrip). A Lakeview round trip of the fixture's source dashboard is also planned before this is marked ready.🤖 Generated with Claude Code