Skip to content

MCP 0.8.1 evaluation - model measures and clearer install

Pre-release
Pre-release

Choose a tag to compare

@bcsnpc bcsnpc released this 12 Nov 01:03
· 42 commits to main since this release

vilsem-mcp 0.8.1: model measures for shareable reports, clearer install

Docs and skill release. No runtime, renderer or spec-format changes: core 0.8.0 and renderer 4.43 are unchanged, and existing reports need no upgrade.

Changes

  • Model measures for shareable reports (skill section 9a).
    • Visual-scoped measures (spec.measures) are stored as NativeMeasure projections. They hide fields in the Build pane and fail under Publish to web with PowerBIAnonymousExtensionSchemaException.
    • The skill now treats them as a preview scratchpad. At commit time it guides agents to persist measures to a model measures table and bind visuals to them.
    • New ground rule: ask once up front whether the report will be published or shared.
    • Updated reload rules: model (TMDL) changes need Desktop closed without saving and reopened.
  • Bundled helper: scripts/promote-measures.py (Python 3.9+, stdlib only).
    • Moves existing visual-scoped measures into the model and rewires the visuals to model Measure references.
    • Dry run by default; --apply backs up every file it changes.
    • Tags created measures VilsemOwned, refuses name collisions with non-Vilsem measures, and is idempotent.
    • Installed by install-skill and covered by 6 regression tests.
  • Server instructions gain one line pointing agents to section 9a.
  • README rewrite.
    • Numbered quick start and download checksum verification.
    • Claude Code setup without the claude CLI: the bundled claude.exe path, or a JSON config with safe parse-and-merge.
    • A "Measures: prototype vs publish" section, a single reload-rules table, a troubleshooting table and fixed number spacing.
    • Historical notes moved into a collapsed release history.

Verification

  • Full MCP suite: 344/344 tests passed across 18 files.
  • Fresh install from the packed vilsem-mcp-0.8.1.tgz:
    • npm audit 0;
    • stdio server reports 0.8.1, with instructions, 19 tools and 3 skill resources;
    • the packaged skill contains section 9a and scripts/promote-measures.py.
  • README Option B (no CLI) checked on a test config shaped like ~/.claude.json:
    • the JSON merge kept existing settings and servers;
    • the README validate command read it;
    • the server launched from that entry and listed all tools.
  • promote-measures.py on a throwaway copy of a 19-page Contoso PBIP project:
    • dry run planned 156 measures on the original report;
    • --apply rewired 7 visuals with 0 NativeMeasure left;
    • a second run was a no-op;
    • validate_visuals 64/64 valid.
  • Field report: a Contoso report with Vilsem visuals bound to model measures rendered under Publish to web. The same visuals with visual-scoped measures failed.

Still to verify manually

  • Committing a visual bound to a model measure written to TMDL but not yet loaded in Desktop, and previewing after reopen.
  • Opening a promoted copy in Desktop and checking the Build pane.
  • A side-by-side reproduction of Publish to web versus the signed-in Service on one report.

Install: see the README. Verify the download against SHA256SUMS-0.8.1.txt. This remains an evaluation prerelease.