Repository navigation
Conversation
Sources take views (a name to a view file or a view) and viewsDir (a folder of view files). list_sources and describe_source name them; render_view, create_link and draft_schedule take a view by its name. create_link and draft_schedule take a layout as render_view does. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…nce, clearer names Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e run, count chart colours A link or draft of a named view is checked with the policy bound to the data's statistics, so a field at values counts as listed. Series colours of a chart count as values. Views over the limit are left out instead of stopping the start. Docs name named views in security and privacy. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Nov 19, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
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.
Fixes #616
Fixes #469
An operator can publish named views per source.
render_view,create_linkanddraft_scheduletake a view's name asview.create_linkanddraft_schedulealso take alayout, asrender_viewdoes.Named views (#616)
sources.<id>.viewsmaps a name to a view file's path or to a view written in place.sources.<id>.viewsDiris a folder of view files. A file the browser downloads (by-region.pivotkit.json) works as it is and becomes the viewby-region.list_sourcesanddescribe_source(MCP and REST) list each view's name, title and description.validate_viewanddescribe_viewtake the view itself, not a name.check-configread every view. A file that is no view stops the start, as a broken template does. A missing file or folder starts the server with aPROBLEM.check-confighas a "Named views" section with the fields each view needs. For a file source it warns about a field the data does not have.What a caller learns follows the policy:
summarygets no link or draft (NOT_ALLOWED). Values are filter items, a custom sort order, collapsed groups, and hidden series or series colours of the chart. That check runs after the data is read, so a field atvaluescounts as listed.render_viewmakes the report as a file, as for any view.The issue asked whether
describe_source's example views could carry this. They cannot.list_sourcesreads no data, while the examples are built per call from the loaded fields. They also have no stable name to pass back. So the views get their ownviewskey.The rows route part of the #616 comment needs the records route of #635.
findNamedViewinviews.jsis the lookup that route can call. I wrote that part up for a follow-up issue.A layout in create_link and draft_schedule (#469)
vieworlayout, through the existingviewOrLayout.NO_LINKandNOT_SCHEDULABLEstill come first.layoutthat refused every layout is gone, and with itVIEW_ONLY.groupsworks and that neither or both are refused.MCP tool schemas and descriptions changed, so the upgrading page says to reconnect MCP clients.
Tests
packages/pivotkit-server/test/named-views.test.js(10 tests), one operations test in pivotkit-report, and two MCP protocol tests. They failed before the code.npm run lint,npm run types, pivotkit-server (779), pivotkit-mcp (100), pivotkit-report (110), the repository tests (110),npm run pack:check,zensical build --strict.Docs checked: I searched
docs/, the package READMEs, the skill and the AGENTS files forcreate_link,draft_schedule,layout,list_sources,describe_sourceand print templates. Changed:reference/sources.md(new "Named views" section),reference/mcp.md,reference/rest.md,reference/report.md,concepts/limits.md,features.md,model-data.md,privacy.md,security.md, the upgrading page,docs/openapi.json, the skill and MCP instructions, the server README, the server and MCP AGENTS files, and the changelogs of pivotkit-server, pivotkit-mcp and pivotkit-report.Merge order
This uses the upgrading heading "From 0.8.2 to the next release", like #635 and #640, so it expects the 0.8.2 release (#634) first. It overlaps with #635 and #640 in
present.js,registry.js,config.js, the upgrading page, the reference pages, the server changelog anddocs/openapi.json. The later one to merge needs a merge of main andnode scripts/openapi.js.🤖 Generated with Claude Code