Skip to content

feat(plugin-grid): server-side grid grouping — group headers from the query, rows paged per group (objectui#7189) - #10878

Merged
objectstack-fleet[bot] merged 6 commits into
mainfrom
claude/issue-7189-server-side-grouping
Sep 28, 2026
Merged

objectstack-fleet[bot] merged 6 commits into
mainfrom
claude/issue-7189-server-side-grouping

Conversation

@objectstack-fleet

@objectstack-fleet objectstack-fleet Bot commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #7189

Clause-②: yes — measured on this branch, where the claim reads no. No metadata or schema key moves (GroupingConfig is unchanged), but published TypeScript surface does: DataSource in @object-ui/types gains the optional member queryGroupHeaders, ObjectStackAdapter implements it, and @object-ui/plugin-grid's exported GroupEntry (new count, keyValues), AggregationResult.value (now number | null) and useGroupedData (optional fifth argument) change shape. The seat corrects the claim line.

What this does

Maintainer ruling A on this card: grouping on a list view is server-side. The set of groups and every number in a group header are properties of the query, not of the fetched page; rows inside a group are paged. This PR is the objectui half, on top of the spec half (objectstack#14556) and the platform half (objectstack#15330).

  • Transport (@object-ui/types, @object-ui/data-objectstack). DataSource.queryGroupHeaders(resource, query) answers the header query compileListViewGroupQuery compiles. Presence is the capability. The ObjectStack adapter posts it verbatim to the existing POST /data/:object/query door and answers its records; it never degrades (a refusal throws with the server's code and status; a body without records is refused, not read as zero groups). The adapter already had an undeclared spec-shape branch on aggregate(); it was not reused because AggregateParams does not declare that shape and the other adapters would answer it with garbage, so a new optional member is the smallest honest addition.
  • Grid (@object-ui/plugin-grid). A grouped grid that fetches its own rows from such a source no longer fetches a flat window. It asks one compiled header query per grouping level (outer headers are their own level's numbers; avg / count_distinct do not fold) and pages each open group's rows with that group's compiled row query (compileListViewGroupRowsQuery: view filter AND group key, limit / offset per group). Each group larger than the page gets its own pager. A collapsed group costs no row query. aggregations ride the header query (mapped onto the spec's column summaries and read back with deriveColumnSummary). A reference-typed grouping key (a raw id on the wire) is labelled from the referenced record. The view filter is lowered once to a FilterCondition (parseFilterAST) and handed to both compilers, so header numbers and rows answer the same question; a filter that does not lower is refused, never dropped. Grouping keys the principal may not read are not sent as keys.
  • useServerPagination. The grouped exclusion goes for a server-grouped grid: its rows are paged by the server (per group) and its sort is the server's.
  • useGroupedData. With the server's header rows it builds the group tree from them and never buckets data. Without them it still groups rows the grid holds.
  • Partial marker. Retired where counts are server-true: a server-grouped grid never renders it. See the open question below for the one shape that still reaches it.
  • ListView (@object-ui/plugin-list). The console mounts the grid through ListView, which fetched one window and handed it down as data, so the grid could only group a page (and the feat(grid,i18n): a grouped grid states, beside the group counts, that it grouped a page #7226 marker never fired on that path, because no total was handed down for grouped grids). When the data source can answer the header query, ListView now hands a grouped grid NO rows, passes it the effective filter (authored + toolbar + chips, the same value the self-querying views get), and draws no record-count bar over it. While a toolbar search is active it keeps hosting the window as before (see the out-of-scope finding: the aggregate door drops search). This is outside the claim's named file surface; it is where the page-scoped rows actually came from in the console.

Step zero, measured before any grid code (G0)

The installed @objectstack/spec 17.4.0 (read from this worktree's node_modules) compiled the header query for the 186-row, five-unit fixture, posted through objectstack's real RestServer route over ObjectStackProtocolImplementation + ObjectQL + in-memory SQLite, from a throwaway objectstack worktree at origin/main d3958bac (removed afterwards):

  • header query {"groupBy":["business_unit"],"aggregations":[{"function":"count","alias":"count"},...]} answered five rows 86 / 61 / 31 / 7 / 1 in both the contiguous and the interleaved object, total: 5;
  • the compiled row query for the 86-row group paged 50 + 36 (total: 86 on both pages), 86 distinct ids;
  • control on the same door: grouping the first 100 stored rows gives 86 / 14 (contiguous) and 31 / 31 / 30 / 7 / 1 (interleaved).

Then end to end with this branch's BUILT adapter and the installed @objectstack/client, wired by a fetch shim into the same real routes: queryGroupHeaders answered 86 / 61 / 31 / 7 / 1, and paging every group through adapter.find with the compiled row query reached all 186 rows (86 as 50 + 36). The empty group (nine rows with a NULL key) was reached through the is_null predicate, and a status = done view filter moved header numbers and rows together (28 / 20 / 10 / 2, one unit gone).

Pins

  • packages/plugin-grid/src/__tests__/serverGrouping-7189.test.tsx (11): five headers 86 / 61 / 31 / 7 / 1 and no marker in both row orders; the header query equals the spec compiler's output and no flat window is fetched; the 86-row group shows 86 rows under a 100-row window; under a 50-row window it pages 50 then 36 (union 86); all 186 rows reachable through the group pagers; a per-group sum is the query's; a collapsed group costs no row query; two-level headers come from one query per depth; a lookup key is labelled from the referenced record; CONTROL: a source without the header query still renders 86 / 14 with the marker.
  • packages/data-objectstack/src/queryGroupHeaders-7189.test.ts (4): verbatim body to the door, records answered, refusal without records, no fallback on a 400.
  • packages/plugin-list/src/__tests__/ListView.groupedGridOwnsFetch-7189.test.tsx (4): grouped grid gets no rows and the effective filter, no record-count bar; controls for a source without the header query and for an ungrouped grid.
  • groupedPartialDisclosure-7189.test.tsx is NOT retired: its data sources declare no queryGroupHeaders, so it now pins the fallback (header updated to say so). groupedPagination.test.tsx needed no rewrite (inline rows).

Ablation (prediction written before the run): forcing serverGroupedFetch to false in ObjectGrid.tsx turned serverGrouping-7189.test.tsx to exactly Tests 10 failed | 1 passed (11) as predicted, the one pass being the control. Mutation landed on disk through ablation-replace.mjs (anchor 1 to 0, blob 957bad075ca7 to 6324d33743e9), restored and proven by blob equal to HEAD and empty git diff HEAD. No build stands between edit and run: the test imports ../ObjectGrid and the root vitest config aliases @object-ui/plugin-grid to src. A first attempt was refused by the tool before running (the replacement contained the anchor), so it measured nothing.

Tests and gates, at 8427ae3

  • turbo run build type-check for types, data-objectstack, plugin-grid, plugin-list: Tasks: 20 successful, 20 total. The new test files are inside the type-check programs (--listFiles, one hit each).
  • vitest run packages/plugin-grid/: Test Files 164 passed (164), Tests 1536 passed (1536).
  • vitest run packages/plugin-list/ packages/data-objectstack/ packages/types/: Test Files 432 passed (432), Tests 7594 passed (7594).
  • Gates, each exit 0 with its own verdict line: changeset-no-major, changeset-presence (11 source files of 4 released packages, 1 changeset), changeset-overwrite, changeset-claims (report-only), control-bytes, new-line-citations (0 new), doc-component-types, prompt-component-keys, doc-fences, doc-example-ids, doc-links, vi-mock-specifiers, vi-mock-inherit, vi-mock-override-shape, test-path-roots, pending-changeset-literals, lockfile-integrity (base fab627f, clean), lockfile-dedupe.
  • check:spec-floors: zero findings against the four touched packages (all built); it exits 1 only on no-artifact for ten untouched packages not built locally. CI builds them.
  • ESLint, narrowed and declared: the 11 changed .ts / .tsx files (count from --format json), 0 errors; eslint.config.js sets no parserOptions.project, so type-aware linting is off and this diff cannot move a verdict in an untouched file. The repo-wide run is CI's.
  • NOT MEASURED: check:readme-exports, check:doc-snippets, check:published-dist, check:node-esm-load (each needs the whole workspace built; this diff adds no package export and no fenced block to any document). A live browser run of the console against a running backend was not made; the in-process route probe above stands in for it.

Semver

minor on types, data-objectstack, plugin-grid and plugin-list (fixed group, no major per this repo's policy); the breaking semantics are stated in the changeset. The floors of plugin-grid and data-objectstack move to @objectstack/spec ^17.4.0, the first release carrying the compilers. The pending .changeset/7189-grouped-grid-partial-disclosure.md carries two sentences this makes false: "That is a correct implementation of client-side grouping and is unchanged here" and "Server-side grouping — the durable fix — is deliberately NOT part of this ... nothing here builds toward it or changes the fetch." Following this repo's precedent for a pending changeset a later change makes false, both halves are done: the new changeset says it supersedes that paragraph, and a dated note (2026-09-28, naming objectui#7189 and this PR) is appended at the end of .changeset/7189-grouped-grid-partial-disclosure.md correcting those sentences and the one before them (that useGroupedData buckets the rows the browser already holds). The existing paragraphs and the frontmatter are byte-identical; check-changeset-overwrite reports the edit as a touched pre-existing changeset declaring the same packages, a deliberate correction.

Open question for the seat

A data source that declares no queryGroupHeaders (the generic ApiDataSource, ValueDataSource, any host adapter) cannot give server-true counts. This PR keeps its old behaviour, grouping the fetched page, and keeps the Partial marker there because only there are the counts page slices, so the grid.grouping.partial* i18n rows are retained, not retired. The alternative is to refuse grouping loudly on such a source. Recommendation: keep, as done here. It is honest, it adds no code, and a refusal would break every grouped grid on a custom adapter with no server able to do better.

Acceptance notes

  • Out of scope, measured: POST /data/:object/query with groupBy + aggregations + search answers the same five full-count groups as without search, while the same search on a flat query narrows to one row. The aggregate branch of findData composes where / groupBy / aggregations / having only, so the search is dropped silently. That is why ListView keeps hosting a searched grouped grid. Reported for filing in objectstack.
  • ListView still issues its own window fetch for a grouped grid it hands over (it feeds the filter chips' option counts and the client export), so a grouped console view makes one extra request.

Written by the dispatched os-dev agent, session https://claude.ai/code/session_01MCg3z5cGrV51xEddpGcxEY.


Generated by Claude Code

…oup row pages (objectui#7189)

A grouped grid that owns its fetch now asks the server for its group set
and every header number (compileListViewGroupQuery, one query per depth,
through the new optional DataSource.queryGroupHeaders) and pages each open
group's rows (compileListViewGroupRowsQuery). useGroupedData builds the tree
from the header rows instead of bucketing a fetched page; the grouped
exclusion in useServerPagination goes for such a grid; the Partial marker
no longer renders where counts are server-true. ListView hands a grouped
grid its own fetch (and the effective filter) when the data source serves
group headers.

Claude-Session: https://claude.ai/code/session_01MCg3z5cGrV51xEddpGcxEY
Co-authored-by: Claude <noreply@anthropic.com>
…86-row five-unit fixture (objectui#7189)

Claude-Session: https://claude.ai/code/session_01MCg3z5cGrV51xEddpGcxEY
Co-authored-by: Claude <noreply@anthropic.com>
…sections; changeset; ListView relay pins (objectui#7189)

Claude-Session: https://claude.ai/code/session_01MCg3z5cGrV51xEddpGcxEY
Co-authored-by: Claude <noreply@anthropic.com>
…ed under; type the server-grouping hook (objectui#7189)

Claude-Session: https://claude.ai/code/session_01MCg3z5cGrV51xEddpGcxEY
Co-authored-by: Claude <noreply@anthropic.com>
…ers, not every render (objectui#7189)

Claude-Session: https://claude.ai/code/session_01MCg3z5cGrV51xEddpGcxEY
Co-authored-by: Claude <noreply@anthropic.com>
@github-actions

github-actions Bot commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

changeset-claim-re-read

⚠️ 34 pending changeset(s) describe a file this change touches

Their bodies publish verbatim into the CHANGELOG at the next release, so this is a request to re-read them against your diff — addressed here because you are the one seat that can answer it without re-deriving anything.

⛔ Nothing here blocks, and nothing here is a verdict on your change. This gate exits 0, is not a required context, and judges name resolution, never meaning: it asked whether a pending body names a file you touched. "Is this sentence still true?" is the one question it will not answer, and the one you are being asked to answer.

.changeset/3917-retire-action-condition-branch.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    • ActionCondition is removed from @object-ui/types (and from the barrel export). - ActionSchema.condition is retyped to the predicate the runtime actually honours: boolean | string | { dialect?: string; source: string } — the same three arms ActionRunner's own ActionDef.condition carries, and the same vocabulary visible and disabled use. - ActionConditionSchema is removed from @object-ui/types/zod (and from the zod barrel); the condition key now validates against that predicate union. - The two teaching sites (content/docs/core/enhanced-actions.mdx Conditional Execution, content/docs/api/schema-reference.md ActionSchema table) are rewritten to the live vocabulary: condition is a gate; a branch is expressed as separate actions with mutually exclusive conditions.

.changeset/4730-retire-dead-locale-key-batch.md

  • names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

    • Superseded twin vocabularies. cellRender.* and rowAction.* duplicated a grid.* vocabulary that won. RowActionMenu.tsx is fully i18n-wired and reads grid.openMenu / grid.edit / grid.delete; ObjectGrid.tsx reads grid.empty / grid.yes / grid.no / grid.systemFields. The twins had no reader on either side. - Labels that outlived their control. calendar.agenda labelled a view mode b55a34647 retired from CalendarViewMode (now 'month' | 'week' | 'day'). home.quickActions.createApp*, layout.systemNav.createApp, actionDialog.defaultActionTitle / .ok and grid.bulk.selectPlaceholder sit in namespaces whose consumers are live and wired but demonstrably read other siblings. - Surfaces that left the product. map.* is the strongest form: @object-ui/plugin-map declares no @object-ui/i18n dependency and contains no t() call at all, so it cannot consume a locale string. home.stats.* and recordDetail.viewersTooltip name surfaces nothing renders.

.changeset/5793-spec-range-floors.md

  • names pnpm-lock.yaml → pnpm-lock.yaml — edited by this change

    Nothing a consumer installs today changes: normal resolution already picks the newest 17.x, and pnpm-lock.yaml still resolves 17.2.0 on this edge after the bump. The change is to the declared floor only, which is why it is scored patch rather than minor — the same reasoning objectui#5753 used for the other direction on this dependency.

.changeset/6170-retire-timeline-dead-keys.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    Also in this change: the in-repo example packages/types/examples/data-display-examples.json (its timeline node authored all three) is migrated to items / variant; the two content/docs/api/schema-reference.md snippets that authored events: [] now author items: []; and the plugin-timeline docs callout says retired rather than deprecated.

.changeset/6361-spec-floor-17-2-0.md

  • names pnpm-lock.yaml → pnpm-lock.yaml — edited by this change

    Nothing a consumer installs today changes: normal resolution already picks the newest 17.x, and pnpm-lock.yaml still resolves 17.2.0 on both edges after the bump — only the recorded specifier: moves. No source and no behaviour changes, which is why this is scored patch, on the reasoning 111741454 used for the same remediation on @object-ui/plugin-detail.

.changeset/6597-retire-fieldmeta-referenceto.md

  • names plugin-grid/src/ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

    No authoring story survived the search either. ObjectGrid's own relational-meta pass-through (applyRelationalMeta, plugin-grid/src/ObjectGrid.tsx) copies reference_to / reference / display_field / etc. from the SCHEMA field def only, at all three of its call sites — never from an authored column override. No doc, example, or fixture in this repo shows a table column pinning a lookup's target away from what its schema field already says. Under the maintainer's standing startup-stage rule (2026-08-27: deprecated/alias spellings retire immediately, no transition windows), no measured demand selects withdraw.

.changeset/6650-listcolumn-wrap-implemented.md

  • names packages/plugin-grid/README.md → packages/plugin-grid/README.md — edited by this change

    @objectstack/spec declares ListColumn.wrap and describes it to authors as "Allow text wrapping", and packages/plugin-grid/README.md shows it in its authored-column example. No renderer anywhere implemented it. Long cell text stayed clipped to one line, with no error, no warning and no feedback of any kind — a promise made at authoring time and silently broken at render time.

.changeset/6896-retire-chart-inline-data.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    ⚠️ One correction to the record the ruling rests on. The ruling states zero authorship of a populated series[].data outside tests across packages/ / apps/ / examples/. The re-measurement finds one such site inside those roots — packages/types/examples/data-display-examples.json (2 series) — plus four outside them, in documentation: content/docs/api/schema-reference.md (3) and content/docs/core/report-schema.mdx (1).

.changeset/6939-kanban-column-cards.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    Breaking, deliberately. KanbanColumn declared its card list as items in complex.ts and in the zod mirror complex.zod.ts. Every board reads cards. Measured on origin/main 78a3cc238: KanbanImpl.tsx reads .cards on 12 lines, KanbanEnhanced.tsx on 8, and bucketCardsIntoColumns twice more as col.cards || []; .items had zero read sites in either board (a same-shaped .title control on the same two files returns 8 and 3, so those zeros are readings and not a mis-shaped probe). Both catalog entries, the plugin docs and content/docs/api/schema-reference.md all author cards.

.changeset/6951-tree-view-data-retired.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    What was measured, on this branch's base. TreeViewSchema declared two spellings for its one inline-nodes slot — nodes (read second) and data (read third: boundData || schema.nodes || schema.data || [] at renderers/data-display/tree-view.tsx:105), both declared by objectui#6150. data had been REQUIRED until 777e5c6f4 (PR fix(types): tree-view mirror stops requiring the limb it reads third (group 2 of objectui#6939) #7533) made it optional, so this retirement starts from a declared-and-optional member on both faces. The in-repo corpus at the retirement: seven tree-view nodes under examples/schema-catalog and packages/types/examples plus one content/docs fence — six on nodes, two on data (packages/types/examples/data-display-examples.json and content/docs/api/schema-reference.md), both rewritten; no package source authored either spelling.

.changeset/7070-no-invented-gantt-date-fields.md

  • names plugin-list/src/ListView.tsx → packages/plugin-list/src/ListView.tsx — edited by this change

    • app-shell/src/views/ObjectView.tsx — the console object page. The inline branch becomes ganttViewOptions, the sibling of calendarViewOptions and timelineViewOptions: the declared block spread whole, title floored at 'name', no date field invented. - plugin-list/src/ListView.tsx — the render branch AND the capability gate. - plugin-view/src/ObjectView.tsx — generateViewSchema, the authored object-view element route, which bypasses ListView entirely.

.changeset/7122-objectstack-family-17-3-0.md

  • names pnpm-lock.yaml → pnpm-lock.yaml — edited by this change

    @objectstack/client, core, formula and lint each pin @objectstack/spec EXACTLY, so resolving the spec alone to 17.3.0 left the console bundling TWO copies of it. Moving the family with it in pnpm-lock.yaml collapses the duplicate; every declared range already admitted 17.3.0, so no manifest moved.

.changeset/7323-adapter-factory-return.md

  • names content/docs/utilities/data-objectstack.mdx → content/docs/utilities/data-objectstack.mdx — edited by this change

    The README's note saying the page could not yet teach the factory's shape is removed, and the four sections built on the adapter-only members (Metadata Caching, Connection State Monitoring, Batch Operation Progress, Troubleshooting → Cache Issues) now continue from Basic Setup's createObjectStackAdapter(…) call instead of declaring the class by hand. The docs-site page content/docs/utilities/data-objectstack.mdx is corrected the same way: its prose, its factory signature fragment and its "hold the class type to reach these" section described the old narrow return, and its Mutations and Troubleshooting examples told the reader to construct the class by hand to reach members the factory now declares. src/adapterFactoryReturn.types.test.ts pins the card's TS2339 reproduction inverted, with two controls: the adapter-only members stay absent from DataSource (fires on option B), and the widened return stays assignable to DataSource (swappability kept).

.changeset/7499-gantt-non-axis-floors-omitted.md

  • names plugin-list/src/ListView.tsx → packages/plugin-list/src/ListView.tsx — edited by this change

    • plugin-list/src/ListView.tsx — the object-gantt render branch. - plugin-view/src/ObjectView.tsx — generateViewSchema, the authored object-view element route, which bypasses ListView entirely.

.changeset/7664-kanban-arm-plugin-dialect.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    Migration. Author boards in the plugin dialect — objectName + groupBy for an object-bound board, or columns[].cards[] with badges for a static one. Replace DeclarativeKanbanSchema imports with KanbanSchema (from @object-ui/types, or the Zod KanbanSchema from @object-ui/types/zod; @object-ui/plugin-kanban re-exports the same KanbanSchema type). Delete draggable (drag-and-drop is always on) and column color (style a lane through className). content/docs/api/schema-reference.md's kanban section now documents this dialect.

.changeset/7762-object-grid-export-options-bare-array-refusal.md

  • names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

    What was measured, on this branch's base. The mirror declared NO exportOptions member at all, and BaseSchema is .passthrough(), so ObjectGridSchema.safeParse({ type: 'object-grid', objectName: 'accounts', exportOptions: ['csv', 'xlsx'] }) returned success: true with the array back VERBATIM — as did { formats: ['csv', 'pdf'], compression: 'gzip' }. Nothing on the render path parses, and ObjectGrid.tsx reads schema.exportOptions?.formats and only that, so the authored array then lost SILENTLY to the ['csv', 'json'] default: the useEffect that warns about dropped formats reads .formats too and returns early when it is absent, while !!schema.exportOptions kept the export button on screen. An author declared ['csv', 'xlsx'] and got csv/json with no error, no warning and no console line. The two authoring faces disagreed in the direction opposite to objectui#6956's: the TypeScript interface already declared the object form only, so TS refused what zod admitted.

.changeset/7773-kanban-adapter-groupfield-write.md

  • names ListView.tsx → packages/plugin-list/src/ListView.tsx — edited by this change

    Who is NOT affected — the boundary is node-local. Every VIEW-LEVEL groupField read is untouched and still live: it is a legacy alias of the spec's groupByField on the kanban view config, mapped by normalize-list-view.ts, and both adapters still resolve lanes through it (ObjectView.tsx's kanbanCfg.groupField ||, ListView.tsx's groupByField || groupField). Authoring options.kanban.groupField on a list-view or object-view keeps working exactly as documented in packages/plugin-list/README.md. groupField is dead only on the generated object-kanban NODE.

.changeset/7780-object-kanban-record-source.md

.changeset/7997-detail-view-related-retired.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    Documentation. packages/plugin-detail/README.md and content/docs/api/schema-reference.md stop teaching the retired array and gain a migration block each.

.changeset/8268-testid-emitted-as-data-testid.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    The other direction — retiring the promise — was considered and declined. It is what objectui#7088 did for BaseSchema.hidden, but that key had a working behaviour to describe and zero named consumers, and the ruling's decline turned on exactly that. This promise already has carriers outside the type declaration: content/docs/api/schema-reference.md states it as a table row and authors testId in that page's own base-schema example, @object-ui/cli's OBJECTUI_STRUCTURAL_KEYS identifies a file as an ObjectUI schema node by this key, ObjectGridSlotKey / ObjectFormSlotKey pin it, SchemaBuilder.testId() writes it, and ADR-0054 C4 — shipped — reads "the renderer emits data-testid … derived from metadata".

.changeset/8568-retire-dollar-dialect-lowercase-aliases.md

  • names packages/data-objectstack/README.md → packages/data-objectstack/README.md — edited by this change

    packages/data-objectstack/README.md's operator tables follow the implementation, as does the reconciliation test that holds them to it.

.changeset/8653-listview-title-retired-rowactiondefs-pinned.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    title — retired. ListView resolved its export filename through schema.label || (schema as any).title. @objectstack/spec/ui's ListViewSchema refuses title by name (unrecognized_keys: ['title']) while ObjectGridPropsSchema accepts it; packages/types mirrors the platform contract rather than ruling over it, so declaring title on ListViewSchema would have made this repo accept what the platform save gate rejects. That asymmetry is also why objectui#6639 could take the declare branch for ObjectGridSchema.title one package over and this site could not. A parse-based census of apps/ examples/ content/ and packages/ found zero list-view nodes authoring title, so the retirement costs no author a filename. Over that same corpus the instrument reports three object-grid nodes carrying the key: two authored ones, both in content/docs/api/schema-reference.md, plus one that is not authored at all — packages/plugin-view/src/ObjectView.tsx composes title: schema.table?.title onto a grid node it builds, so it is a producer writing the key rather than an author declaring it. ObjectGrid's own title reads are untouched — they remain declared, ruled and read.

.changeset/8801-object-kanban-allow-collapse-retired.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    • the declarations retired here — packages/types/src/objectql.ts and its mirror packages/types/src/zod/objectql.zod.ts; - the pins that assert the retirement — object-kanban-allow-collapse-retired-8801.test.ts and bare-kanban-node-key-retired-8802.test.ts; - a comment in packages/types/src/zod/complex.zod.ts, recording that the deleted retiredZeroReadKanbanKey helper once carried this spelling on the SIBLING arm; - one row of content/docs/api/schema-reference.md; - the .changeset/ release notes that discuss it — this one, the two historical entries covering the sibling arm's own spelling, and objectui#9629's note recording the correction to this paragraph.

.changeset/8990-object-kanban-groupby-optional.md

  • names packages/plugin-list/src/ListView.tsx → packages/plugin-list/src/ListView.tsx — edited by this change

    • packages/plugin-list/src/ListView.tsx generates the node as groupBy: laneField. objectDef loads asynchronously, so laneField is undefined on every load until it lands, and stays undefined whenever the object offers no stageField hint and none of status / stage / state / phase. The renderer serves that node; both published faces refused it. - content/docs/utilities/data-objectstack.mdx documents an object-kanban node that is exactly { type, dataSource }, with no groupBy. ⚠️ This one is weaker and is cited for what it is: that fragment is still refused after this change, at RECORD_SOURCE_REQUIRED, because dataSource is not a rung of the record-source ladder. It shows a lane-less board is a documented authoring; it is not a document this change admits.
  • names content/docs/utilities/data-objectstack.mdx → content/docs/utilities/data-objectstack.mdx — edited by this change

    • packages/plugin-list/src/ListView.tsx generates the node as groupBy: laneField. objectDef loads asynchronously, so laneField is undefined on every load until it lands, and stays undefined whenever the object offers no stageField hint and none of status / stage / state / phase. The renderer serves that node; both published faces refused it. - content/docs/utilities/data-objectstack.mdx documents an object-kanban node that is exactly { type, dataSource }, with no groupBy. ⚠️ This one is weaker and is cited for what it is: that fragment is still refused after this change, at RECORD_SOURCE_REQUIRED, because dataSource is not a rung of the record-source ladder. It shows a lane-less board is a documented authoring; it is not a document this change admits.

.changeset/9187-record-highlights-layout-two-values.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    ⚠️ The census behind this narrowing covers this repository only, and it found no in-repo authoring to migrate: every in-tree layout: 'grid' belongs to a different component (detail-view in content/docs/api/schema-reference.md and phase2-schemas.test.ts, ai-recommendations in packages/plugin-ai/README.md), and the one in-repo consumer of this interface that writes a layout (p1-spec-alignment.test.ts) writes 'horizontal'. So no document in this repository stops type-checking. A TypeScript consumer outside this repo that wrote grid is not observable from here and gets a compile error (TS2322) naming the key — which is why the FROM/TO is spelled out above.

.changeset/9309-object-gallery-filter-destination-typed.md

  • names data.ts → packages/types/src/data.ts — edited by this change

    It was filter?: unknown under the docblock "Query filter, forwarded verbatim as $filter", and $filter is RecordANGLE-BRACKETS(string, any) | FilterArray (QueryParams, data.ts). The declaration therefore named a destination it did not type: an author told to forward the value verbatim got a type error on the key the sentence had just told them to forward, and the way through was as — which un-checks the destination's real type at that call site too. The declaration is now an INDEXED ACCESS on QueryParams, not a copy of its arms, so the two cannot drift.

.changeset/9722-bulk-executor-datasource-face.md

  • names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

    • ObjectGrid.tsx → RecordDetailPanel: removing it type-checks GREEN. It was paying for nothing — both sides already declare the same DataSource | undefined from @object-ui/types. Removed outright. - ObjectGrid.tsx → BulkActionDialog: removing it reddens, and it was paying for TWO things at once — the optional-vs-required arm (the grid declares dataSource?: DataSource, the dialog demands one) AND the bulk-door contravariance. Only the first still needs erasing, so it is now a non-null assertion: today's runtime behaviour is preserved exactly, and any future drift of the face reddens at that site instead of passing silently.

.changeset/9853-grid-non-positive-page-size.md

  • names ObjectGrid.tsx → packages/plugin-grid/src/ObjectGrid.tsx — edited by this change

    Refuse a non-positive pageSize at all three of ObjectGrid.tsx's read points, instead of giving two different answers for one authored value (objectui#9853).

.changeset/calendar-view-schema-converge.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    Runtime renderer behaviour is unchanged. @object-ui/plugin-calendar's README and content/docs/api/schema-reference.md are repaired to the converged surface in the same change, so no copy of the old contradiction survives.

.changeset/issue-5373-retire-crud-schema.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    crud had four declaration faces and no registered renderer, for the whole life of the key: the TS interface (packages/types/src/crud.ts), the zod mirror (packages/types/src/zod/crud.zod.ts), a dedicated branch in validateSchema that affirmatively PASSED it, and CRUDBuilder in @object-ui/core. A node spelling it painted the OBJUI-001 "Unknown component type" panel, and content/docs/api/schema-reference.md published it as reference material — so a reader (or an AI author) who copied the page got a red panel.

  • names api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    Authoring crud is now REFUSED BY NAME rather than passed or silently ignored. validateSchema returns an error with code: 'RETIRED_TYPE' on schema.type — at any depth, since it is what validateChildren recurses with — so assertValidSchema throws and isValidSchema answers false. The message names the migration: object-grid for the record table with its toolbar, filters, pagination and row/batch actions, object-form for the create/edit form, and detail for the record view. api/schema-reference.md is rewritten around those shapes.

.changeset/list-user-actions-collision-5398.md

  • names ListView.tsx → packages/plugin-list/src/ListView.tsx — edited by this change

    The harvest now reads the object block only. Both userActions read sites in ListView.tsx carry a comment naming the collision, and __tests__/ListView.userActionsCollision.test.tsx pins each clause of it: the two shapes, a producer that manufactures the view one, the harvest's blindness to it, and the projection that must keep the object's operand with a toolbar block — or an empty block — present on the view.

.changeset/listview-comment-pair-4559.md

  • names ListView.tsx → packages/plugin-list/src/ListView.tsx — edited by this change

    Two comment corrections in ListView.tsx (objectui#4559, objectui#4966). No runtime behaviour changes and the emitted bundle is byte-identical; the published .d.ts does change, which is why this is a patch rather than an empty frontmatter.

.changeset/object-view-unmirrored-keys-7779.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    listViews stays unmirrored, on the ruling's own fallback clause. The declaration's value is the local NamedListView — 64 declared top-level members (⚠️ re-taken at objectui#8980, which added the seventeen the protocol declares on this surface to the 47 this entry first measured), of which the renderer reads 21 off a named view. data is one of the 21 now: it used to reach the renderer through an as any cast on the named-view config in packages/plugin-view/src/ObjectView.tsx and be declared nowhere, and the objectui#8980 ruling declared it by name — objectui#7928's open half, answered. The spec's ViewSchema.listViews is a record of the STRICT ObjectListViewSchema, which requires columns and refuses options, ObjectQL tuple filters and default — that is, it refused the named views this package's own README and content/docs/api/schema-reference.md taught when this entry was written ({ label: 'All Users' } fails at columns; filter: [["owner", "=", "..."]] fails at filter.0), and objectui#8255 has since rewritten them in the spec shape. Mirroring the spec value would have lost documented behaviour; mirroring the local value would enforce 43 unread members (64 declared, minus the 21 that are both declared and read) into the contract — the very thing ruling B refused for the six local keys. The key therefore stays in the parity ledger with that measurement, pinned, until the maintainer decides its value type. It is not papered over with z.any().

.changeset/table-renderer-declared-column-contract-5350.md

  • names content/docs/api/schema-reference.md → content/docs/api/schema-reference.md — edited by this change

    What makes this site different from its three siblings is that the alias was not merely tolerated, it was published. content/docs/api/schema-reference.md §TableSchema shipped a copyable { "name": "id", "label": "#" } example and a property row reading "Column definitions with name, label, …", while packages/types declared the opposite pair. Docs and type disagreed about one type they both call TableColumn, each internally consistent. Retiring the alias without correcting the page would have turned a documented, working example into a silently broken one, so both halves land together: the page now authors accessorKey/header. The same row also advertised a render property that TableColumn has never declared — the renderer's hook is cell — and that claim is dropped rather than re-spelled.

Read the paragraph, not the line: both false halves of the objectui#8617 claim sat in one paragraph, and correcting either alone would have left it asserting the same wrong thing.

If a claim did go false, correct the body. That is precedented and prose-only, frontmatter untouched; check-changeset-overwrite.mjs will report the correction as its own case 2 ("correcting a declaration on purpose … legitimate"), which is the intended shape — one gate asks for the read, the other records the write.

Not covered, stated so nobody reads this as more: a born-false claim that spells no line address at all (objectui#9495 coordinated one by ORDINAL — "a grep finds that member first" — and deciding that means reading what the sentence means), a claim spelled as a symbol or a package rather than a backticked file name, and a file named ambiguously.

Angle-bracketed names in the quoted prose above are rewritten as ANGLE-BRACKETS(name): GitHub deletes tag-shaped fragments from a stored body, and a quote that silently loses the identifier it is about is worse than a visible repair.

Compared the checked-out tree with c6678b1bd (merge-base with origin/main): 19 file(s) changed outside .changeset/, read against 1648 pending declaration(s) that publish a body (2239 pending in total). · run

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 329 chunks) 3091.9 KB 3104.5 KB
Main entry chunk (gzip) 148.5 KB 350 KB
Entry file index-CfjUPqCG.js —
Status PASS —

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 16.57KB 6.17KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.17KB 10.58KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.52KB 3.45KB
auth (index.js) 3.63KB 1.64KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.13KB 7.95KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 557.59KB 133.61KB
core (index.js) 9.93KB 3.94KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 226.45KB 62.98KB
fields (index.js) 261.26KB 66.37KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.24KB 2.27KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.40KB 12.91KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 39.28KB 11.09KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.99KB 0.87KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 13.52KB 4.88KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 16.01KB 3.93KB
plugin-calendar (index.js) 51.73KB 14.72KB
plugin-charts (index.js) 83.99KB 22.86KB
plugin-chatbot (index.js) 197.67KB 46.90KB
plugin-dashboard (index.js) 136.82KB 36.44KB
plugin-designer (index.js) 216.42KB 44.47KB
plugin-detail (index.js) 233.48KB 61.79KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 161.21KB 41.41KB
plugin-gantt (index.js) 169.83KB 41.99KB
plugin-grid (index.js) 228.11KB 62.72KB
plugin-kanban (index.js) 48.43KB 15.11KB
plugin-list (index.js) 115.01KB 28.49KB
plugin-map (index.js) 22.90KB 7.62KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 44.17KB 12.20KB
plugin-timeline (index.js) 31.00KB 9.09KB
plugin-tree (index.js) 11.21KB 3.89KB
plugin-view (index.js) 87.90KB 22.06KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.81KB 3.58KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 119.16KB 39.05KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.03KB 1.86KB
react (schema-input.js) 4.25KB 2.04KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.78KB 2.09KB
sdui-parser (codegen.js) 7.50KB 3.05KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 6.16KB 2.71KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (kanban-quick-add.js) 3.89KB 1.87KB
sdui-parser (parse.js) 25.28KB 7.80KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 18.27KB 6.22KB
types (ai.js) 4.11KB 2.06KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 3.52KB 1.36KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.93KB 1.49KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.74KB 2.26KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 17.15KB 6.32KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.27KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

Contract review

Served-tier: 233/233 CONTRACT_REVIEW_TIER
Head-sha: 8427ae32085c78b4dd2bb4302ff2c56a58e28f48

Read: card objectui#7189 body and thread via the REST API (ruling 5509036555, gate discharge 5740621545, triage 5861161215, claim 5861304383; the dev report 5861938733 read only for the claims it makes, none taken as evidence); PR #10878 body, file list (20 files) and the full diff fab627ff9..8427ae32 (merge-base fab627ff929264c612d765cc481807d10df10103; origin/main is now de1b879a6); head sources of ObjectGrid.tsx, useServerGrouping.ts, useGroupedData.ts, GroupRow.tsx, ListView.tsx, data.ts, the adapter index.ts, filter-converter.ts, expand-fields.ts, the three new pins and the re-headed groupedPartialDisclosure-7189.test.tsx; the published @objectstack/spec@17.4.0 (dist/ui/index.d.mts and index.mjs for compileListViewGroupQuery, compileListViewGroupRowsQuery, listViewGroupKeyPredicate, deriveColumnSummary, ListViewGroupQueryError; dist/data/index.mjs for QuerySchema keys and parseFilterAST; dist/api/index.mjs for FindDataRequestSchema) and @objectstack/client@17.4.0 data.query() — read from the pnpm store copy under /home/user/objectui-issue-10758/node_modules/.pnpm/ because /home/user/objectui carries no install (published package bytes, not another seat's scratch); objectstack origin/main d498113b5: packages/rest/src/rest-server.ts (the POST /data/:object/query route) and packages/metadata-protocol/src/protocol.ts (findData, the hasGroupBy || hasAggregations branch); the four packages' package.json exports at head and plugin-grid/src/index.tsx; every DataSource implementer, GroupEntry / AggregationResult / useGroupedData consumer and grid.grouping.partial* reader in the head tree; objectui AGENTS.md §5 and §9 (changeset presence, 测试纪律, 版本号策略), .changeset/config.json, scripts/check-changeset-presence.mjs and scripts/check-changeset-overwrite.mjs headers, every pending .changeset/*.md naming a touched symbol (19 files; sentence check on the nine that could be affected) and the repo's dated-note precedents; objectstack landing-operations.md and contract-review.md; the head's check-runs polled twice. Ran once, in a throwaway git worktree add --detach under this review's scratch dir (offline frozen install, removed and pruned afterwards) through os-verify-lock.sh with OS_VERIFY_LOCK_SLOT=review-10878: the three new pin files, Test Files 3 passed (3), Tests 19 passed (19), wrapper VERDICT command-exit 0. No gate or suite re-run, no GitHub write, no MCP GitHub tool.

① Derived judgments

  1. Ruling A, acceptance — RIGHT. On a grid that owns its fetch (hasInlineData false, objectName set) over a source whose queryGroupHeaders is a function, serverGroupedFetch is true; the load effect resolves the query as before, then on that branch drops $top / $skip, stores the rest as groupRowQuery and returns without any find — no flat window is fetched and there is no client fallback (nothing anywhere sets serverGroupedFetch false on an error). useServerGroupHeaders sends compileListViewGroupQuery({ grouping, columns }, { where, depth }) per depth verbatim; the pin asserts deep equality with the compiler's own output. useGroupedData with server present builds the tree from header rows and never reads data. Headers 86/61/31/7/1 in both orders, no marker, are pinned (it.each contiguous / interleaved) and passed in my run. Opening the 86-row group pages its rows with compileListViewGroupRowsQuery ({ where: { $and: [viewWhere?, key predicate] }, limit, offset } mapped to $filter / $top / $skip), pinned under a 50-row window as 50 then 36 with $skip: 50; all 186 reachable through the group pagers, pinned. Marker: groupingIsPartial = isGrouped && !serverGroupedFetch && (...), so it never renders on that path; pinned. Multi-level: one header query per depth (depth: depthIndex + 1), outer level filtered by sameGroupKey on the prefix, so an outer count is its own level's COUNT(*) — pinned at two levels (North 178, River 8, groupBy ['region'] then ['region','business_unit'], leaf $and of length 2). NULL key: row[field] ?? null becomes the keyValues entry, listViewGroupKeyPredicate spells it { field: { $null: true } }, and the adapter's convertFiltersToAST lowers $null to is_null — unpinned in this PR (the dev's G0 probe only; noted in ③). View filter: the AST the flat fetch would send (toFilterNode emits prefix ['and', …] or a single tuple) is lowered once by the spec's parseFilterAST, handed to both compilers; an AST that lowers to undefined is turned into groupWhere.error and reaches the error panel, never dropped — read, not pinned (③). Lookup labels: for an isExpandableFieldType key (lookup / master_detail / user) with a string reference, one find(reference, { $filter: { id: { $in: ids } } }) per field, displayField ?? name ?? label ?? title, a failed read keeps the id and warns — pinned. Per-group aggregations: serverSummaryOf maps count_distinct to count_unique and the rest by name, the summary columns ride the header query, values are read back with deriveColumnSummary; null (avg/min/max over no values) is kept as null and GroupRow draws an em dash; count maps to the group count, which is what the client path's computeAggregations also returned (rows.length) — consistent. sum pinned (sum: 3741, alias sum_amount).

  2. Transport — RIGHT, loud on failure. DataSource.queryGroupHeaders?(resource, query: EngineAggregateOptions): Promise‹ListViewGroupHeaderRow[]› in packages/types/src/data.ts; ObjectStackAdapter.queryGroupHeaders calls client.data.query(resource, query), which posts JSON.stringify(query) to ${dataPath}/${object}/query — the body IS the compiler output (pinned byte-equal). The route validates { object, query: { …body, object } } against FindDataRequestSchema, whose QuerySchema declares where: FilterConditionSchema, groupBy: GroupByNode[], aggregations: AggregationNode[] ({ function, field?, alias }), so { groupBy, aggregations, where? } is accepted; findData routes hasGroupBy || hasAggregations to engine.aggregate({ where, groupBy, aggregations, having, context }) and answers { object, records, total, hasMore }; the adapter returns records and throws when the body has no records array (an empty array is an answer — pinned as a control). Errors: a thrown ListViewGroupQueryError from the compiler, an adapter refusal (4xx surfaces with code and status, pinned on a 400 INVALID_FIELD, one request only), or a network error all land in useServerGroupHeaders's catch, become state.error, and loadError = error ?? groupWhere.error ?? groupHeaders.error renders the red grid.errorLoading panel with the message. A row-page failure renders a per-group group-rows-error-* line. No path degrades to page grouping.

  3. Clause ② and semver — Clause-②: yes is RIGHT; the claim's no was a false declaration and the PR's first paragraph corrects it. Moved published surface, by exports: @object-ui/types (. and ./data, both addressable): DataSource gains optional queryGroupHeaders — a widening for callers and for implementers (ApiDataSource, ValueDataSource, MockDataSource compile untouched); the published data.d.ts now imports ListViewGroupHeaderRow from @objectstack/spec/ui, which needs spec 17.4.0 — the package's dependency was already ^17.4.0 at base. @object-ui/plugin-grid (., index.tsx exports useGroupedData as a value and GroupEntry, UseGroupedDataResult, AggregationResult, GroupRowProps as types): GroupEntry gains REQUIRED count: number and keyValues: Record‹string, unknown› — a widening for readers, a NARROWING for any consumer that constructs a GroupEntry literal (it no longer type-checks); AggregationResult.value number becomes number | null — a NARROWING for readers (a consumer doing agg.value.toFixed(2) or arithmetic on it breaks under strict null checks; the only in-repo reader, GroupRow.tsx, is updated), and it reaches GroupRowProps.aggregations and UseGroupedDataResult.groups; useGroupedData gains an optional fifth parameter — widening; its type ServerGroupSource is reachable in the entry's type graph through that parameter but is not exported by name (③). useServerGrouping.ts is not exported. @object-ui/data-objectstack (.): ObjectStackAdapter.queryGroupHeaders added — widening. @object-ui/plugin-list (.): no type moves; published behaviour of ListView changes (a grouped grid over a capable source is handed no data). GroupingConfig unchanged, as the claim said. Semver: minor on the four packages, no major, breaking semantics stated in the changeset — RIGHT under AGENTS.md 版本号策略 (breaking changes ship as minor with the semantics in the body). Floors: plugin-grid ^17.0.0 and data-objectstack ^17.2.0 move to ^17.4.0 (the first release with the compilers), lockfile specifier lines only, resolution unchanged at 17.4.0 — RIGHT.

  4. Outside the claim's file surface — RIGHT, each required and bounded. packages/types/src/data.ts: the ruling needs a transport the grid can feature-detect; a new optional member is the smallest one (the adapter's existing spec-shape aggregate() branch takes AggregateParams, a different shape, and degrades). packages/data-objectstack/**: the implementation, its pin, its README section and the floor. packages/plugin-list/src/ListView.tsx: the console mounts the grid through ListView, which fetches one window (fetchSkip 0, $top: effectivePageSize) and hands it down as data; a grid handed a window has hasInlineData true and can only group it, so without this file the ruling would not reach the console at all. content/docs/utilities/data-objectstack.mdx: lists the optional members, so it had to name the fourth. Bounded: gridOwnsGroupedFetch requires currentView === 'grid', a non-empty groupingConfig.fields, a non-value data provider, objectName, typeof dataSource?.queryGroupHeaders === 'function' and no searchTerm; it gates four sites (surfaceDrawsFetchedRows, the selfQueryFilter branch, the filter: spread, the data withholding) and is a boolean in one dependency array. For a non-grouped grid or a source without queryGroupHeaders every site takes its prior branch — pinned by the two ListView controls. paginate is already false for a grouped grid, so no host pager props are handed down and externalManualPagination stays false in the grid on that path. The extra request is CONFIRMED: the window fetch effect has no gridOwnsGroupedFetch gate (the symbol's only sites are the six listed), so a grouped console view issues the window fetch and withholds its rows. Judgment: an acceptance note, not a defect — same filter, same door, the rows feed the chip option counts and the client export as before; it is one avoidable request per grouped view and belongs on a follow-up card, not in this PR's blast radius.

  5. The fallback (K vs F) — facts, no decision. Letter of the ruling: "the Partial marker is retired once counts are server-true (enforce-or-remove)". At the head the marker is retired exactly where counts are server-true (!serverGroupedFetch in the condition) and kept where they are page slices, so the marker is never shown where counts are server-true (pinned). It IS missing where counts are page slices on one path: the ListView-hosted grouped grid that ListView still hosts — (a) a capable source while a toolbar search is active, and (b) any non-capable source mounted through ListView. There ListView hands the grid a window as data (hasInlineData true) and no rowCount (paginate is false for grouped views), so groupingPartialWithTotal has no total and groupingPartialWindowFull is gated by !hasInlineData: neither fires. That is the pre-ruling state (the marker never fired on that path before this PR either — the card's own measurement was through the console), disclosed only by ListView's record-count bar. B (whole-set fetch) is not taken: nothing fetches past the window anywhere. C (disclosure only) is not what the fallback does either: on a standalone grid over a non-capable source the marker and its rows are the feat(grid,i18n): a grouped grid states, beside the group counts, that it grouped a page #7226 state kept as is, with the grid.grouping.partial* rows still read by ObjectGrid (not dead keys). What the maintainer needs: K keeps ApiDataSource / ValueDataSource / host adapters grouping with the feat(grid,i18n): a grouped grid states, beside the group counts, that it grouped a page #7226 disclosure and zero new code; F would turn every grouped grid on such a source into an error panel and retire the marker, its pin, and ten locale rows; neither option touches the ListView search path, which stays page-sliced and unmarked until objectstack stops dropping search on the aggregate branch (item 8).

  6. Pins — RIGHT. serverGrouping-7189.test.tsx renders the real ObjectGrid (with registerAllFields) over a double that reduces every stored row under the compiled query's own groupBy / aggregations / where and pages find by the compiled $filter / $top / $skip, throwing if an AST-array filter (a flat window) arrives; 11 cases: the acceptance fixture in both orders, compiler-output equality, 86 under 100, 50 then 36 under 50, all 186 reachable, sum, collapsed costs no row query, two levels one query per depth, lookup labels, and a lit CONTROL (makePageOnlyDataSource, expecting 86/14 and two markers). queryGroupHeaders-7189.test.ts uses the real ObjectStackAdapter behind a fetch shim: verbatim body and URL, refusal without records, empty records is an answer (control), 400 thrown with code and status and exactly one request. ListView.groupedGridOwnsFetch-7189.test.tsx renders the real ListView with a stub object-grid: no data, the lowered effective filter handed down, no record-count bar, plus two controls (no header query; ungrouped). Able to fail on base: on base the grid fetches the window and groups it (the positive grid cases assert five headers and zero markers), the adapter has no queryGroupHeaders member (TypeError), and ListView hands data (asserted undefined). No .skip, .only, timeout or heavyDomTests in any of the three (0 hits each). Ablation consistent with the source: serverGroupedFetch forced false routes the load effect to the flat find, whose double returns the first 100 rows, so every positive case fails and the control passes — 10 / 1 as reported. My run: 19 / 19 passed.

  7. Prose — RIGHT with one precedent gap (③). .changeset/7189-server-side-grid-grouping.md: every sentence holds at the head — the before/after numbers (86, 14 contiguous; 31/31/30/7/1 interleaved is the round-robin arithmetic over 86/61/31/7/1 at 100 rows, re-derived), the four package bullets, the three breaking-semantics bullets, the floors, the supersession sentence. plugin-grid.mdx and README.md "Grouping is server-side": every bullet matches the code (per-depth queries, own pager, collapsed cost, aggregations from the header query, lookup / master_detail / user labelled — EXPANDABLE_FIELD_TYPES holds all three, ListView hand-over, the two browser cases, the search sentence). schema-reference.md grouping row: true. data-objectstack.mdx and the adapter README: true (the spec-shape aggregate() branch does post to client.data.query). Pending 7189-grouped-grid-partial-disclosure.md sentences that read false from this release: "useGroupedData buckets the rows the browser already holds and computes every per-group aggregate from that same array, so both the set of groups and every number in a group header are properties of the fetched page, not of the query."; "That is a correct implementation of client-side grouping and is unchanged here"; "Server-side grouping — the durable fix — is deliberately NOT part of this. It is an API-surface decision still open on objectui#5560, and nothing here builds toward it or changes the fetch." The PR names them in its body and the new changeset says it supersedes that paragraph; the file itself is untouched. The other 18 pending changesets naming touched symbols carry no sentence this PR falsifies (checked 7217, 9853, gantt-owns-data-comment-7222, 4730, 7196, 6921, 7201, 7762, listview-comment-pair-4559). First line of the PR body is Fixes #7189 — RIGHT.

  8. Out-of-scope finding — VERIFIED on objectstack origin/main d498113b5: findData's branch if (hasGroupBy || hasAggregations) calls engine.aggregate(request.object, { where: options.where, groupBy: options.groupBy, aggregations: options.aggregations, having: options.having, context: options.context }) and returns; options.search (declared on QuerySchema and on the wire) is never read on that branch, so a grouped count under a search is the unsearched count. Fileable in objectstack against that branch. This PR's grid never sends search with a group query: the header where is lowered from $filter alone, useServerGroupRows strips $search and $searchFields from the base params before the row page, the grid's own search box is unreachable in grouped mode (manualSearchOn = manualPaginationOn, which is false when grouped; the flat table is not mounted; group tables set searchable: false), and ListView withholds the hand-over while searchTerm is non-empty. So grouped counts under a toolbar search are never WRONG in this PR — they are the page-sliced, unmarked ListView window described in item 5.

② Semver level

minor on @object-ui/types, @object-ui/data-objectstack, @object-ui/plugin-grid, @object-ui/plugin-list — consistent with the changeset frontmatter and with the repo's no-major policy; Changeset Bump Policy, Changeset Fixed Group Check and Changeset Declaration are green on the head. The changeset states the request-shape change, the GroupEntry / AggregationResult / useGroupedData moves and the spec floors. One understatement: it presents GroupEntry.count / keyValues as additions to use, without saying that a consumer constructing a GroupEntry no longer type-checks (the producer-side narrowing); AggregationResult.value number | null is stated.

③ Boundary flags

  • Dev flag "Clause-② yes where the claim said no": answered — yes is right (item 3). The claim line 5861304383 still reads Clause-②: no; the seat corrects it, as that comment itself provides for.
  • Dev open question K vs F: facts in item 5; not decided here. The ListView search path (page-sliced, no marker) is outside both K and F and is worth a line on the objectstack card for the search drop.
  • Pending-changeset precedent: the repo's precedent is BOTH a supersession sentence in the new changeset AND a dated note appended in place to the superseded pending changeset — 10447-one-title-interpolator.md ("each now carries a dated note naming this card"), 10393-retire-bare-map-key.md, and the ⚠️ **Dated note, 2026-09-25 / 2026-09-27 — … — objectui#NNNN.** blocks in 10156, 10167, 10475, 10516, 10537, 6140; check-changeset-overwrite is report-only and its header counts "factual corrections to prose" as legitimate modifications. This PR does the first half only, so 7189-grouped-grid-partial-disclosure.md will publish its three sentences quoted in item 7 verbatim, corrected only by the neighbouring entry. Naming it in the PR body alone would not have been enough (a body does not publish); the supersession sentence does publish. Ask: append the dated note naming objectui#7189 to that changeset in the patch round or at landing, and whoever records that edit judges it sentence by sentence per the DELIBERATE CORRECTION rule.
  • One extra request per grouped console view (item 4): acceptance note; follow-up card to gate the ListView window fetch, or to feed the chip counts from the header answer.
  • Unpinned but read as correct: the NULL-key group predicate through the adapter ($null to is_null), a view filter riding both compiled queries from the grid's own path (the ListView pin covers the hand-off, the G0 probe covers the door), the error panel on a header refusal, and the per-group error line. Each is a candidate pin for the follow-up, not a defect.
  • ServerGroupSource (the fifth argument's type) is not exported from @object-ui/plugin-grid's entry by name; a consumer must derive it from Parameters‹typeof useGroupedData›[4]. README Export Check is green; the README export list is unchanged and still true.
  • Docs dichotomy: the "two cases still group in the browser" list (rows handed in whole; no header query) omits the third real case — a host handing a WINDOW without a total (ListView while searching), where the grid cannot tell it is partial. Not a false sentence; a gap for the follow-up.
  • CI state read from the head's check-runs: poll 1 at 2026-09-28T02:00:16Z — 44 checks, 32 success, 12 in progress (Test shards 1–8, Lint, Type Check, Spec Main Shape Gate; plus 3 skipped); poll 2 at 2026-09-28T02:13:37Z — 45 checks, all completed: 42 success (Action Ref Convention, Build & E2E, Build Docs, Bundle Analysis, Changeset Bump Policy, Changeset Claim Re-read, Changeset Declaration, Changeset Fixed Group Check, Changeset Overwrite Report, Control Byte Scan, Doc Component Type Check, Doc Example Id Check, Doc Fence Language Check, Doc Snippet Type Check, Docs Route Eager Closure Check, Governed Surface Queue Guard, Inert vi.mock Specifier Check, Internal Docs Link Check, Line Citation Gate, Lint, Live E2E (informational), Lockfile Dedupe Check, Lockfile Integrity Check, Pre-Install Import Graph Check, README Export Check, Shell Escape Residue Scan, Skill Eval Token Check, Skill Example Check, Skill Guide Path Check, Spec Main Shape Gate, Test, Test (dist pins), Test (shard 1/8) through Test (shard 8/8), Type Check, label) and 3 skipped by design (dependabot, Test (coverage), and the unexpanded coverage-shard matrix entry Test (coverage shard …/4)). No failure, no annotations to read.
  • Read-only held: no GitHub write, no MCP GitHub tool, no edit under /home/user/objectui or /home/user/objectstack; the throwaway worktree under this review's scratch dir was removed with git worktree remove and pruned.

Implemented-by: claude/issue-7189-server-side-grouping
Reviewed-by: session_01MCg3z5cGrV51xEddpGcxEY

VERDICT: PASS

…state GroupEntry's required members (objectui#7189)

Claude-Session: https://claude.ai/code/session_01MCg3z5cGrV51xEddpGcxEY
Co-authored-by: Claude <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 329 chunks) 3091.9 KB 3104.5 KB
Main entry chunk (gzip) 148.5 KB 350 KB
Entry file index-CfjUPqCG.js —
Status PASS —

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 16.57KB 6.17KB
app-shell (runtime-config.js) 20.68KB 7.36KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.17KB 10.58KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.52KB 3.45KB
auth (index.js) 3.63KB 1.64KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.13KB 7.95KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 557.59KB 133.61KB
core (index.js) 9.93KB 3.94KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 226.45KB 62.98KB
fields (index.js) 261.26KB 66.37KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.24KB 2.27KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.40KB 12.91KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 39.28KB 11.09KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.99KB 0.87KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 13.52KB 4.88KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 16.01KB 3.93KB
plugin-calendar (index.js) 51.73KB 14.72KB
plugin-charts (index.js) 83.99KB 22.86KB
plugin-chatbot (index.js) 197.67KB 46.90KB
plugin-dashboard (index.js) 136.82KB 36.44KB
plugin-designer (index.js) 216.42KB 44.47KB
plugin-detail (index.js) 233.48KB 61.79KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 161.21KB 41.41KB
plugin-gantt (index.js) 169.83KB 41.99KB
plugin-grid (index.js) 228.11KB 62.72KB
plugin-kanban (index.js) 48.43KB 15.11KB
plugin-list (index.js) 115.01KB 28.49KB
plugin-map (index.js) 22.90KB 7.62KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 44.17KB 12.20KB
plugin-timeline (index.js) 31.00KB 9.09KB
plugin-tree (index.js) 11.21KB 3.89KB
plugin-view (index.js) 87.90KB 22.06KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.81KB 3.58KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 119.16KB 39.05KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.03KB 1.86KB
react (schema-input.js) 4.25KB 2.04KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.78KB 2.09KB
sdui-parser (codegen.js) 7.50KB 3.05KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 6.16KB 2.71KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (kanban-quick-add.js) 3.89KB 1.87KB
sdui-parser (parse.js) 25.28KB 7.80KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 18.27KB 6.22KB
types (ai.js) 4.11KB 2.06KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 3.52KB 1.36KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 2.93KB 1.49KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 4.74KB 2.26KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 5.05KB 1.93KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 17.15KB 6.32KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.27KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

Contract review

Served-tier: 138/138 CONTRACT_REVIEW_TIER
Head-sha: 38a05e3c9df18f2329663d847fce46c46645d1fb

Read: the previous record for 8427ae32085c78b4dd2bb4302ff2c56a58e28f48 (PASS); the PR #10878 object and its file list from the REST API at the new head (21 files, 6 commits, head.sha = 38a05e3c…, updated_at 2026-09-28T02:23:35Z); git fetch origin pull/10878/head:refs/review/pr-10878-re2 into /home/user/objectui, the diff and diff-tree 8427ae3..38a05e3, the root tree shas and the blob shas of the five sources the note describes at both heads; the head sources packages/plugin-grid/src/ObjectGrid.tsx, useGroupedData.ts, useServerGrouping.ts, packages/types/src/data.ts, packages/plugin-list/src/ListView.tsx; .changeset/7189-grouped-grid-partial-disclosure.md and .changeset/7189-server-side-grid-grouping.md at both heads (byte and line comparison), plus the disclosure changeset's blob at the merge-base fab627ff9 and on origin/main c6678b1b; GroupEntry at the merge-base; every GroupEntry reference in the head tree; objectstack .claude/skills/pm-dispatch/references/landing-operations.md lines 15–16 (DELIBERATE CORRECTION) and objectui scripts/check-changeset-overwrite.mjs's header; the dated-note precedents 10156, 10167, 10393-retire-bare-map-key.md, 10447-one-title-interpolator.md, 10475, 10516, 10537, 6140; the head's check-runs polled at the times in ③. No local run (reason in ③), no GitHub write, no MCP GitHub tool, no edit under /home/user/objectui or /home/user/objectstack; scratch only under …/pr-10878/re2/.

① Derived judgments

  1. The delta is prose only — RIGHT. git merge-base --is-ancestor 8427ae32 38a05e3c holds: the new head is one commit past the previous one (38a05e3c, parent 8427ae32, 2026-09-28T02:22:34Z, subject "docs(changeset): date-note the superseded 7189 disclosure changeset; state GroupEntry's required members (objectui#7189)"). git diff-tree -r --no-commit-id 8427ae32 38a05e3c lists exactly two blobs: .changeset/7189-grouped-grid-partial-disclosure.md 16e6a94 to 946c03e (+19 / −0, lines 51–69 appended) and .changeset/7189-server-side-grid-grouping.md 7b5f330 to ad7e7ce (+11 / −4, lines 53–56 replaced by 53–59). The root tree moved (d1fdf54a to 1477ab32) through those two paths only. The five sources named in the note are sha-identical at both heads: ObjectGrid.tsx 736556ad, useGroupedData.ts 9778ecbf, useServerGrouping.ts 19e40e61, data.ts 3a3c5c87, ListView.tsx 76833a87; so are the three pins and every other file (nothing else in the diff-tree). The API file list grew from 20 to 21 by the disclosure changeset alone. Every code judgment in the previous record (its items 1–8, the 19 / 19 pin run, the ablation reading) carries forward unchanged.

  2. The dated note (DELIBERATE CORRECTION) — RIGHT; each sentence true at the head. The changed note is .changeset/7189-grouped-grid-partial-disclosure.md; its first line is: ⚠️ Dated note, 2026-09-28 — grid grouping is now server-side where the data source can answer the group header query — objectui#7189, PR objectui#10878. Frontmatter byte-identical ('@object-ui/plugin-grid': minor, '@object-ui/i18n': minor; cmp clean). Append-only: the previous 2796 bytes are an exact prefix of the new file (head -c 2796 | cmp clean), 50 lines untouched, the note occupies lines 52–69 after one blank line. The non-ASCII bytes in the note are only U+26A0 U+FE0F and U+2014, the precedents' own; Control Byte Scan is green. Sentence by sentence:

    • S1, the heading: "grid grouping is now server-side where the data source can answer the group header query — objectui#7189, PR objectui#10878". TRUE: serverGroupedFetch (ObjectGrid.tsx 2108–2114) is !hasInlineData && !!objectName && typeof dataSource?.queryGroupHeaders === 'function' && (some grouping field usable, not refused on a known masked type, readable); the card and this PR are named correctly.
    • S2, "The paragraphs above describe this change as it was written." TRUE: the 50 lines above are the blob 16e6a94 that origin/main and the merge-base carry, unchanged.
    • S3, "Later in this same release three of their sentences stopped describing the grid: that useGroupedData buckets the rows the browser already holds, so the set of groups and every header number are properties of the fetched page; that client-side grouping is unchanged here; and that server-side grouping is not part of this, is still open on objectui#5560, and that nothing here builds toward it or changes the fetch." TRUE: "same release" — the disclosure changeset is still pending on origin/main and the new changeset joins the same .changeset/ queue, so one changeset version consumes both; the three paraphrases are lines 9–11, 12–14 and 43–45 of the entry, quoted faithfully (the third item is two grammatical sentences, "deliberately NOT part of this." and "It is an API-surface decision…"; the note counts them as one — a counting nit, not a false statement about the grid). Each did stop describing the grid: with server present useGroupedData builds the tree from server.headers and never buckets data (409–459: rows: [], count: Number(row.count), aggregations: readServerAggregations(row, …), comment "never recomputed from rows"); the fetch changed (the load effect at 2597–2603 stores groupRowQuery and returns before find); server-side grouping is built.
    • S4, "Maintainer ruling A on objectui#7189 settled that question." TRUE as carried forward: the card thread is outside this delta's inputs; the previous record read ruling 5509036555 on the card as ruling A, and the head's own sources cite it (ObjectGrid.tsx 2078–2086, 4985; the new changeset line 8).
    • S5, "On a data source that declares queryGroupHeaders, a grouped grid that fetches its own rows now takes its groups, every group count and every per-group aggregation from the query, and pages each group's rows on the server; its counts are the query's own, so the Partial marker and the notice described above never render there." TRUE: "fetches its own rows" is !hasInlineData && !!objectName (2109–2110); "declares" is the typeof … === 'function' test (2111); groups, counts and aggregations come from the header rows (useGroupedData 409–459, each entry's count is the row's count, each aggregation is read from the row); each group's rows are paged on the server (useServerGroupRows 302–320: compileListViewGroupRowsQuery({ grouping }, keyValues, { where, limit: pageSize, offset: (page − 1) × pageSize }), then dataSource.find(objectName, { …rest, $filter: compiled.where, $top: compiled.limit, $skip: compiled.offset })); the marker and the notice both derive from groupingIsPartial = isGrouped && !serverGroupedFetch && (…) (4996–4997): groupingPartialLabel and groupingPartialNotice are undefined and the grouping-partial-notice div (6121) is not rendered when serverGroupedFetch is true. Pinned by the unchanged serverGrouping-7189.test.tsx (no marker in either row order). The sentence elides one qualifier — serverGroupedFetch also needs at least one grouping key that is usable, unmasked and readable (2112–2114) — but a "grouped grid" presupposes one.
    • S6, "On a data source without queryGroupHeaders, the grid still groups the page it fetched in the browser, as described above, and the marker and the notice are kept there." TRUE, and it does not claim more than is true. Its antecedent is "the page it fetched": a grid that owns its fetch (hasInlineData false) over a source with no queryGroupHeaders has serverGroupedFetch false, fetches one window through dataSource.find (2604), buckets it in the client branch (useGroupedData 475–523), and reaches the feat(grid,i18n): a grouped grid states, beside the group counts, that it grouped a page #7226 conditions untouched — groupingPartialWithTotal from result.total, or groupingPartialWindowFull when !hasInlineData and the loaded rows reach serverPageSize — so the marker and the notice render there exactly as before this PR; pinned by the CONTROL in serverGrouping-7189.test.tsx (86 / 14, two markers) and by groupedPartialDisclosure-7189.test.tsx; the grid.grouping.partial* rows are still read. The edge the previous record found is real and unchanged: a ListView-hosted grouped grid over a non-capable source, or over a capable source while a toolbar search is active (!searchTerm, ListView.tsx 2115), is handed the window as data, which the grid wraps as provider: 'value' (1612–1619), so hasInlineData is true, groupingPartialWindowFull is gated out by !hasInlineData, and groupingPartialWithTotal has no total because paginate is false for a grouped view (1498) and rowCount is handed down only under paginate && serverTotal != null (5099–5106): the marker does NOT fire there. S6 does not say it does: (a) that grid did not fetch that page — ListView did — so it is outside the sentence's antecedent; (b) "as described above" points at the entry's own trigger paragraph, whose terms include "Rows handed in inline are not a page and are never marked", and the ListView window is handed inline; (c) "kept" asserts continuity, and on that path the marker's behaviour is byte-for-byte the pre-PR behaviour (it never fired there before either — the card's console measurement). What S6 leaves unsaid — that a host-handed window without a total is page-grouped and unmarked, and that the ListView search path over a capable source is page-grouped — is stated for the search half by the companion entry ("While a toolbar search is active it keeps hosting the rows as before") and remains the docs gap the previous record flagged; carried in ③, not a false published sentence.
    • S7, "The rest of this entry is kept as the reading of this change; the 7189-server-side-grid-grouping entry states what a grouped grid does now." TRUE: that entry exists at the head (blob ad7e7ce) and its body is that statement.
      Shape: the note matches the repo's dated-note form — the ⚠️ Dated note, DATE — what changed — objectui#NNNN. opener, "Later in this same release …", and the closing "The rest of this entry is kept as the reading of this change; the … entry states what … now does." are the form of 10156, 10167, 10475, 10516, 10537 and 6140; appended at the end of the entry as those are; paired with a supersession sentence in the new changeset as 10447-one-title-interpolator.md and 10393-retire-bare-map-key.md do. Two harmless departures: it names the PR beside the card (precedents name the card alone), and it names the companion entry by file name rather than "the objectui#NNNN entry" — necessary here, since both entries belong to the same card objectui#7189.
  3. The GroupEntry sentence — RIGHT. Head useGroupedData.ts lines 59 and 65 declare count: number; and keyValues: Record‹string, unknown›; without ? — required members; at the merge-base fab627ff9 the interface (lines 33–56) declares neither, so "gains" is right. Readers unaffected, constructors fail: adding required members to an interface is source-compatible for every property read and rejects any object literal typed as the interface that omits one (missing-property error). Head-tree sweep for GroupEntry: declared and built in useGroupedData.ts (both builders supply both members — 452–453 with keyValues at 454 on the server branch, 519–521 on the client branch), exported as a type from packages/plugin-grid/src/index.tsx:54, listed in the README's export list; no consumer in the tree constructs one, and ObjectGrid.tsx (2922, 6026, 6041, 6051–6058) and GroupRow.tsx only read count, keyValues, rows, subgroups, aggregations. "rows.length, which is empty on a server-grouped grid" is rows: [] at 452. Frontmatter of 7189-server-side-grid-grouping.md byte-identical (cmp clean, the four minor lines). Every other sentence unchanged: diff of old-minus-lines-53–56 against new-minus-lines-53–59 is empty; inside that span the one bullet became three, the useGroupedData fragment and the AggregationResult.value fragment carried verbatim except rows); to rows). and keyValues;tokeyValues., and the only new prose is "two REQUIRED members:" and "Code that only READS a GroupEntry is unaffected; code that CONSTRUCTS a GroupEntry literal no longer type-checks until it supplies both." — the producer-side narrowing the previous record called an understatement, now stated.

  4. PR body — RIGHT. First line Fixes #7189. Second paragraph opens Clause-②: yes — measured on this branch, where the claim reads no. and is intact. The Semver paragraph now reads "both halves are done: the new changeset says it supersedes that paragraph, and a dated note (2026-09-28, naming objectui#7189 and this PR) is appended at the end of .changeset/7189-grouped-grid-partial-disclosure.md correcting those sentences and the one before them (that useGroupedData buckets the rows the browser already holds). The existing paragraphs and the frontmatter are byte-identical; check-changeset-overwrite reports the edit as a touched pre-existing changeset declaring the same packages, a deliberate correction." Each clause holds: the supersession sentence is lines 65–68 of the new changeset; the note is dated 2026-09-28 and names both; the three sentences are the ones corrected; byte-identity shown in ①2; check-changeset-overwrite is report-only, flags lost declarations separately, and this edit keeps every declared name (the "18 of 19" shape in its header) — Changeset Overwrite Report green on the head; "deliberate correction" is landing-operations' term for the shape, not the script's, which is fine. The "Tests and gates, at 8427ae3" section still cites the previous head, which is honest for a delta whose every source and test blob is sha-identical; CI re-ran everything on the new head regardless.

② Semver level

Unchanged from the previous record: minor on @object-ui/types, @object-ui/data-objectstack, @object-ui/plugin-grid, @object-ui/plugin-list; both changesets' frontmatter byte-identical across the delta; Changeset Bump Policy, Changeset Fixed Group Check, Changeset Declaration and Changeset Claim Re-read green on the head. The breaking semantics are now stated in full: the previous record's one understatement (a consumer constructing a GroupEntry no longer type-checks) is the sentence this delta adds.

③ Boundary flags

  • DELIBERATE CORRECTION discharged here: per landing-operations.md lines 15–16, a same-head PASS record that names the changed note and judges each rewritten sentence confirms the correction without waiting for the maintainer; ①2 names the note by its first line and judges its seven sentences one by one. The gate itself is unchanged (report-only, green).
  • Docs gap carried from the previous record, still open: neither entry says in one place that a host-handed window with no total (ListView hosting a grouped grid over a non-capable source, or over a capable source during a toolbar search) is page-grouped and unmarked; the note's "as described above" inherits the entry's "rows handed in inline are never marked", and the companion entry states the search half. No false sentence; a line for the follow-up card.
  • Counting nit: the note's "three of their sentences" spans four grammatical sentences (lines 9–11, 12–14, 43–44, 44–45). Not false about the grid; not worth a patch round.
  • Ruling A is taken from the previous record; the card thread was not re-read in this delta (outside its inputs).
  • No local run: the delta is two Markdown files, every source and test blob is sha-identical to the PASS head, and the full suite re-ran on the new head in CI (all Test shards, Type Check, Lint). A run would have measured nothing this record does not already have.
  • Previous-record flags carried unchanged: the K vs F open question (fallback kept, facts in the previous record's item 5); one extra window request per grouped console view; the unpinned NULL-key predicate, view filter on the grid's own path, header-refusal panel and per-group error line; ServerGroupSource not exported by name; the objectstack search drop on the aggregate branch.
  • CI state read from the head's check-runs (/commits/38a05e3c…/check-runs?per_page=100, all runs bound to head_sha 38a05e3): poll 1 at 2026-09-28T02:27:11Z — 44 checks, 28 success, 13 in progress (Build Docs, Bundle Analysis, Lint, Spec Main Shape Gate, Test (shard 1/8) through Test (shard 8/8), Type Check), 3 skipped by design (dependabot, Test (coverage), the unexpanded matrix entry Test (coverage shard …/4)), 0 failed; poll 2 at 2026-09-28T02:31:34Z — 33 success, 8 in progress, 3 skipped, 0 failed; background polls at 02:32:31Z (8 pending) and 02:33:17Z (7 pending: Test (shard 1/8), 2/8, 4/8, 5/8, 6/8, 7/8, Spec Main Shape Gate), 0 failed; at 02:34:49Z 3 pending (Test (shard 1/8), 4/8, 7/8); final poll at 2026-09-28T02:35:35Z — 45 checks (the Test roll-up joined the list), all completed, last completed_at 02:35:34Z: 42 success (Action Ref Convention, Build & E2E, Build Docs, Bundle Analysis, Changeset Bump Policy, Changeset Claim Re-read, Changeset Declaration, Changeset Fixed Group Check, Changeset Overwrite Report, Control Byte Scan, Doc Component Type Check, Doc Example Id Check, Doc Fence Language Check, Doc Snippet Type Check, Docs Route Eager Closure Check, Governed Surface Queue Guard, Inert vi.mock Specifier Check, Internal Docs Link Check, Line Citation Gate, Lint, Live E2E (informational), Lockfile Dedupe Check, Lockfile Integrity Check, Pre-Install Import Graph Check, README Export Check, Shell Escape Residue Scan, Skill Eval Token Check, Skill Example Check, Skill Guide Path Check, Spec Main Shape Gate, Test, Test (dist pins), Test (shard 1/8) through Test (shard 8/8), Type Check, label) and 3 skipped by design (dependabot, Test (coverage), the unexpanded coverage-shard matrix entry Test (coverage shard …/4)). No failure, no annotations to read.
  • Read-only held: no GitHub write, no MCP GitHub tool, no edit under /home/user/objectui or /home/user/objectstack beyond the instructed refs/review/pr-10878-re2 fetch ref (no checkout, no worktree); scratch files only under …/pr-10878/re2/; the previous review's record.md was the only other scratch file read.

Implemented-by: claude/issue-7189-server-side-grouping
Reviewed-by: session_01MCg3z5cGrV51xEddpGcxEY

VERDICT: PASS

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review September 28, 2026 02:39
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Sep 28, 2026
Merged via the queue into main with commit e2b3826 Sep 28, 2026
47 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-7189-server-side-grouping branch September 28, 2026 02:53
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 28, 2026
…ts name 30 objectui issues that answer 404 (objectui#10803, batch 4) (objectstack-ai#10875)

Part of objectstack-ai#10803
Clause-②: no

Dispatched implementation of the `domain:ui` seat 2 claim (comment
`5861571015`) on objectui#10803, batch 4, session
`https://claude.ai/code/session_014mXUNuFomfj24w7s1pZzhN`. Citations
only: no sentence's claim moves, and every edited pending changeset's
frontmatter is byte-identical. The runtime text that moves loses its
dead pointer and nothing else: the legacy `ActionSchema` `onSuccess` /
`onFailure` tombstone guidance strings open `RETIRED (ADR-0049) —`
(ruling `5861129870` as amended by `5861311219`), and two
`DataTableSchema` zod `.describe()` strings drop their pointer
(amendment `5860244997`, Q1 = A), all in `@object-ui/types`. The one
test that pins the tombstone strings verbatim follows them, and nothing
else in it moves.

**Patch round 1** answers contract review `5861897723` (FAIL on
`d21aeb0f6`) under seat ruling `5861900779` (route a: tests that pin
changed comment text follow it, anchor only). `Test (shard 6/8)` was red
on `layout-default-jsdoc-7361`, whose `TextSchema.variant` pin anchored
on `6942`. The round does four things:
- Three comment-text anchors follow the re-pointed text: the one in
`layout-default-jsdoc-7361` and two in `cellClassNameCensusProse-6921`.
- The `MarkdownSchema` docblock stops crediting `8063bcbdc` with
retirements it never touched (**Special cases** 9).
- The `7004-cli-root-path-line.md` remnant "(the mechanical half)" goes.
- `main` (`de1b879a6`) is merged in by a merge commit (`ae0b81089`),
with no rebase and no force-push.

The round's anchor sweep (**Special cases** 10) shows those three pins
are the only anchors on changed text.

## Why `Part of`, not a closing line

The card stays open for the other 53 numbers of the family remainder
(seat amendment `5860244997`, Q2 = A), listed in **Acceptance notes** 1,
and for the bare-number 404s the C0 census below found.

## Premise, re-measured

- REST `GET /repos/objectstack-ai/objectui/issues/N` for each of the 30:
all 30 answer 404, and a second read of each answers 404 again (30 of
30). `GET .../pulls/N` answers 404 for all 30 too. Lit controls:
objectui#10533 and objectui#7714 answer 200. No number was dropped from
the batch.
- The same 30 in objectstack all answer 200, with subjects unrelated to
the objectui sentences (for example objectstack#6882 is an
`examples/app-todo` trigger finding, while the objectui sentences are
about `DataTableSchema.renderCellEditor`). Two exceptions were read, not
guessed:
- `objectstack#6888` already appears on 5 in-scope lines (`i18n.ts`,
`ActionDefaultInspector.tsx`, `ActionPreview.tsx`, `block-config.ts`,
`action-bar.tsx`), each about the `global_nav` retirement, which is
objectstack#6888's own subject. They are live sister citations,
untouched.
- `UnpublishedAppBar.tsx` wrote "framework PR objectstack-ai#6942" bare.
objectstack#6942 is the pull request "the ADR-0045 publish gate gets its
own machine-managed key — `app.hidden` goes back to meaning navigation",
exactly the `_unpublished` / `hidden` split that heading describes. It
is re-qualified to `objectstack#6942` (Zone 1 item 5).
- Every other site names an objectui card or pull request, confirmed by
its landing commit below.
- Every edited changeset is pending: it is present in `.changeset/` on
`main`.
- Branch point: `e32dae160`. `main` was merged in at `de1b879a6` in
patch round 1 (merge commit `ae0b81089`). Not a shallow checkout.

## C0: the bare-number census (measurement only; PR objectui#10869
Acceptance note 2)

The instrument, over the two in-scope classes at the branch point (a `#`
not preceded by a word character, `#`, `&`, `/`, `.` or `-`, so
`objectui#N`, `objectstack#N`, `cloud#N`, `hotcrm#N` and every other
`word#N` are excluded, as is a `#N` inside a URL):

```
git grep -hoP '(?:^|(?<=[^\w#&/.\-]))#\d+(?![0-9A-Za-z_])' e32dae1 -- '.changeset/*.md' 'packages/*/src/**' ':!**/__tests__/**' ':!**/*.test.*' ':!**/*.spec.*' ':!**/test/**' ':!**/tests/**' | sort -u | wc -l
```

- **1002 distinct bare numbers.** That is over 600, so by the order's
budget only the **980** at or below 10900 were read (replace the final
`wc -l` with `tr -d '#' | awk '$1+0 <= 10900' | wc -l` to reproduce
980). The 22 above 10900 were NOT read.
- Each of the 980 was read once with REST `GET .../issues/N`: **955
answer 200 and 25 answer 404.** Each of the 25 was read a second time
and answered 404 again (25 of 25), and `GET .../pulls/N` answers 404 for
all 25.
- Lit control on the same instrument: objectstack-ai#5026, objectstack-ai#6905 and objectstack-ai#3720 are all in
its output at the branch point. At this head none of the eight batch
numbers it found bare remains.
- The 25, with site counts (lines / files, at the branch point):
- **This batch's own numbers (8), all fixed here:** objectstack-ai#6882 (5 / 2), objectstack-ai#6905
(7 / 2), objectstack-ai#6907 (5 / 1), objectstack-ai#6942 (1 / 1, the objectstack pull request
above, re-qualified), objectstack-ai#6959 (1 / 1), objectstack-ai#6962 (1 / 1), objectstack-ai#7036 (8 / 1), objectstack-ai#7087
(2 / 2). The printed census below already counts a bare `#N` for these.
- **Already on the family list (3), for their own batches:** objectstack-ai#7620 (2 /
2), objectstack-ai#7678 (3 / 3), objectstack-ai#7853 (1 / 1).
- **New to the family (11), for later batches:** objectstack-ai#3720 (5 / 3), objectstack-ai#5420 (1
/ 1), objectstack-ai#5503 (1 / 1), objectstack-ai#5506 (1 / 1), objectstack-ai#5737 (4 / 4), objectstack-ai#6467 (1 / 1), objectstack-ai#6936
(1 / 1), objectstack-ai#6945 (1 / 1), objectstack-ai#7622 (1 / 1), objectstack-ai#7662 (1 / 1), objectstack-ai#7684 (2 / 2).
- **Not citations (3):** `#0` (257 / 187, the `#0` of "AGENTS.md #0.1"),
`#000` (2 / 2) and `#000000` (10 / 6), which are CSS colours.
- **Folded here: none.** No C0 404 outside this batch's 30 sits in a
sentence this batch edits: none of the 11 new numbers, nor any of the
other 53 family numbers, occurs in any hunk of this diff (3 lines of
context).
- The 200 set is not a citation census: many bare numbers are
decision-batch, summons or commandment numbers, or React error codes,
that happen to name a live issue.

## Census (the enumeration pin for this batch)

The instrument PR objectui#10854 printed and PR objectui#10869 reused,
with this batch's 30 numbers substituted (REF = a commit or tree):

```
git grep -nE '(objectui#|#|issues/)(6872|6879|6882|6887|6888|6889|6892|6905|6907|6921|6923|6924|6931|6940|6942|6958|6959|6962|6965|7004|7008|7023|7025|7036|7068|7069|7077|7079|7087|7088)([^0-9]|$)' REF -- '.changeset/*.md' 'packages/*/src/**' ':!**/__tests__/**' ':!**/*.test.*' ':!**/*.spec.*' ':!**/test/**' ':!**/tests/**' | grep -v 'objectstack#' | wc -l
```

- REF = `e32dae160` (branch point): **170** lines, 48 changeset lines in
38 files and 122 src lines in 45 files. REF = `de1b879a6` (the `main`
merged in): 170. REF = `c6678b1bd` (`main` at the round's final read):
170.
- REF = `ae0b81089` (this head, `de1b879a6` merged in): **0**. Round 0's
head `d21aeb0f6` also read 0.
- This head merged with a fresh `main` (`c6678b1bd`, `git merge-tree
--write-tree`, clean, tree `e109a3bd0`): **0**.
- **The instrument's blind spot, as batch 3 measured it.** Its `grep -v
'objectstack#'` drops a whole line that also names an objectstack
number. Three in-scope lines were hidden that way, each naming
objectui#6965 beside objectstack#9343: in
`10039-publish-drafts-advisories.md`, `6965-batch-publish-advisories.md`
and `render-publish-advisory-findings-5026.md`. They are re-pointed here
too, so the batch's true base population is 173 lines (51 changeset
lines in 40 files, 122 src lines in 45 files). Without the filter the
instrument reads 178 at the branch point and **7** at this head, all
live: the five `objectstack#6888` lines, `objectstack#6942` in
`UnpublishedAppBar.tsx`, and the same spelling in the new sweep
changeset.
- Other spellings at this head: a search for the 30 numbers with no `#`
finds only filenames (`action-callback-retired-7068.test.ts`,
`data-table-declared-keys-6882.test.ts` and the like) and two SVG path
coordinates. Hex-colour false positives (a number followed by a hex
letter) at the branch point: 0.
- Lit control, the same printed instrument over live objectui#7714 at
this head: 17 lines.
- **Out of scope, as it stands** (the instrument with the 30 numbers,
unfiltered, whole tree at this head): 226 test lines in 96 files
(`scripts/__tests__` included), 22 scripts lines in 5 files, 0
`.github`, 0 governed, and 18 other lines in 10 files: published
`CHANGELOG.md` history, three `content/docs` lines, and four lines of
the private `@object-ui/test-support` README. See **Acceptance notes**
3.

## Citation form

- The 9-character backticked sha of the commit on `main` that landed the
change the sentence rests on, as in PRs objectui#10707 / objectstack-ai#10766 / objectstack-ai#10797
/ objectstack-ai#10854 / objectstack-ai#10869. All 24 distinct shas below are ancestors of `main`:
`git merge-base --is-ancestor`, exit 0 each. Control leg in the same
checkout: the head of PR objectui#10714 (`d2afdb6bf`) answers exit 1,
and a known ancestor, `5f789538d`, answers exit 0. `git rev-parse
--short=9` returns the same 9 characters for each.
- A changeset's pointer to its OWN card is dropped, not replaced:
`@changesets/changelog-git` prefixes each released entry with the hash
of the commit that added the file, which is that landing. Where dropping
the pointer left a dangling word, the clause was minimally repaired
(**Special cases** 5).
- Where the sentence rests on a RULING, the ruling is cited by its date,
next to the sha that carried it out where one exists (**Special cases**
4).
- Where a dead card sits beside a live pull request that IS its landing,
the dead card is dropped and the live pointer stays (**Special cases**
1), as batch 3 dropped the dead predecessor in "(objectui#5401 →
objectstack-ai#5454)".
- Where the claim lived only on the dead card (a finding, a triage, a
deferral, a quoted ruling), the sha only locates the card: "the card
behind SHA" (**Special cases** 3). This is review `5861306588`'s lesson:
a sha must carry what the sentence cites it for.
- Where nothing answers, the pointer is dropped and the sentence names
the card by role (objectstack-ai#7023 only).
- Runtime text carries no sha: see **Special cases** 7.

## Mapping (number to resolution)

Lines / files are the branch-point census for that number (a line naming
two batch numbers counts for each, and the three hidden objectstack-ai#6965 lines are
included). "Method" is how the landing was found. The last column is why
that commit carries what the sentence cites it for.

| dead number | resolution | method | lines / files | why the commit
carries it |
|:--|:--|:--|:--|:--|
| objectstack-ai#6872 | own-card pointer dropped (landing `d9a0490b7`) | changeset's
adding commit | 1 / 1 | the only site is the objectstack-ai#6872 changeset's own
pointer |
| objectstack-ai#6879 | `3619792bf` | changeset's adding commit, `git log --grep` | 1
/ 1 | it curates `box` into `PUBLIC_BLOCKS`, the list the comment sits
in |
| objectstack-ai#6882 | `bf97b98c8` | changeset's adding commit | 20 / 7 | it declares
`renderCellEditor` and schema-level `cellClassName` on
`DataTableSchema`, adds the `Equal` exact-shape pin, and corrects
`cellClassName`'s reach to the three utility cells |
| objectstack-ai#6887 | `5c09cca27` | changeset's adding commit | 1 / 1 | it derives
metadata-viewer's option shape from the spec's `SelectOption` with the
`Omit` the comment names |
| objectstack-ai#6888 | `320374d2a` | changeset's adding commit | 9 / 7 | it keys
`LocationField`'s residue refusal and the two coordinate nouns into the
locale packs |
| objectstack-ai#6889 | `f75810e7c` | changeset's adding commit, `git log -S` | 8 / 1
| it parses a dropped-fields entry's `fields` and `object` instead of
asserting them, the gate the comments describe |
| objectstack-ai#6892 | own-card pointers dropped (landings `8d40c18a7`, `951fa8e0d`)
| changesets' adding commits | 2 / 2 | both sites are slice changesets'
pointers to their own card |
| objectstack-ai#6905 (a pull request) | `85f6a6097` | `git log --grep`: its squash
subject ends "(objectstack-ai#6905)" | 8 / 2 | it judges gantt dates by TYPE before
`new Date`, the "objectstack-ai#6781 type rule" the sentences name |
| objectstack-ai#6907 | `7fc5c3c12` | changeset's adding commit, `git log -S` | 7 / 2
| it spells a refused gantt date by a rule, and its changeset records
the measured throwing-getter crash |
| objectstack-ai#6921 | `4eb665bcf` | changeset's adding commit, `git log --grep` | 2
/ 2 | it pins, in the rendered DOM, which body cells schema-level
`cellClassName` reaches |
| objectstack-ai#6923 | `d3bf4fa6f`; "the 2026-08-31 ruling" | changeset's adding
commit, `git log --grep` | 5 / 4 | it gives the wrapper-key list its
build-free JSON home "per the 2026-08-31 ruling on objectui#6923" |
| objectstack-ai#6924 | `78e98bf44`; PR objectstack-ai#7024 kept | changeset's adding commit, `git
log --grep` | 5 / 3 | it adds the one enum-options walk for the
top-level reader family |
| objectstack-ai#6931 | `8063bcbdc` | changeset's adding commit, `git log -S` | 8 / 5
| it converts the remaining eleven tombstones, `confirm` and the menu
divider `type` included, to `retirementTombstone()`. At the
`MarkdownSchema` site, which `8063bcbdc` never touched (`446d93d4e`
retired those keys), it is cited only as the commit that made that
spelling uniform: see **Special cases** 9 |
| objectstack-ai#6940 | pointers dropped (landing `0c386dd7f`) | changeset's adding
commit | 2 / 2 | the only sites are its own changeset's pointer and a
`.describe()` string |
| objectstack-ai#6942 | `57f9b077b`; one site re-qualified to objectstack#6942 | `git
log --grep`; REST for the sister PR | 6 / 4 | it makes `ui:text` honour
the published `variant` enum, with a node that omits the key left
without a typography class |
| objectstack-ai#6958 | `6a449fc49` | changeset's adding commit | 6 / 5 | it clears a
field its own `visibleWhen` hides |
| objectstack-ai#6959 | `c0c436db8` | changeset's adding commit | 2 / 1 | it keeps the
find-call gate and adds a second one, and records the trap that a mock
call is one resolution ahead of its value |
| objectstack-ai#6962 | `7b433197d` | changeset's adding commit | 3 / 2 | it removes
`publishDraft`'s envelope unwrap after measuring the route at the
producer |
| objectstack-ai#6965 | `ce986aafc`; PR objectui#10038 kept at three sites |
changeset's adding commit, `git log --grep`; its body names the card it
settles | 21 / 9 | it routes "publish whole app" through the advisory
seam, adds `publishPackageDrafts`, and writes the "Corrected before
release" note |
| objectstack-ai#7004 | `85b495795` (root Path line); `a5d55472b` (arm selection) |
both changesets' adding commits | 7 / 4 | the first gives a root-level
issue a Path line; the second prints the arm the document selected, per
the 2026-09-02 ruling |
| objectstack-ai#7008 | `f08bcd9af` | changeset's adding commit | 15 / 11 | it makes
`FieldEditWidget` deliver the declared NON-DOM block through
`toHostProps`, and corrects `RequiredFieldsDialog` |
| objectstack-ai#7023 | nothing answers: the card named by role | `git log --grep`
finds only `d88e20f55`, the objectstack-ai#4895 retirement it dissolved into | 1 / 1 |
see **Special cases** 3 |
| objectstack-ai#7025 | own-card pointer dropped (landing `14884620e`) | changeset's
adding commit | 1 / 1 | the only site is its own changeset's pointer |
| objectstack-ai#7036 | `869b876c8` | `git log -S` on the timeline renderer | 11 / 1 |
it scopes the speller's totality claim, and refuses a `catch` because it
would substitute `an object` for a failure |
| objectstack-ai#7068 | `6bca0e4e8`; runtime text `RETIRED (ADR-0049) —` | changeset's
adding commit | 8 / 3 | it retires the callback pair as ADR-0049
tombstones and deletes `ActionCallback` / `ActionCallbackSchema` |
| objectstack-ai#7069 | `2760075ff` | changeset's adding commit | 3 / 3 | it adds the
fifth parity ledger that watches the mirror-wider-than-declared
direction |
| objectstack-ai#7077 | own-card pointer dropped (landing `00d3f09c5`) | changeset's
adding commit | 1 / 1 | the only site is its own changeset's pointer |
| objectstack-ai#7079 | own-card pointer dropped (landing `ab7dc31ce`) | changeset's
adding commit | 1 / 1 | the only site is its own changeset's pointer |
| objectstack-ai#7087 | `c93b4d5f3` | changeset's adding commit | 8 / 6 | it drops the
18 `disabled?: boolean` narrowings, adds the twin-symmetry pin, and
keeps the six independent `boolean` declarations |
| objectstack-ai#7088 | `c1fe272ad` | changeset's adding commit | 4 / 3 | it corrects
`BaseSchema.hidden`'s JSDoc to the single hide path and records the
synonymy |

## Special cases (the judgement calls)

1. **A dead card beside its own live landing.**
- "objectui#6965 / PR objectui#10038" (`AiChatPage.tsx`,
`PendingDraftsBar.tsx`, `StudioDesignSurface.tsx`) becomes "PR
objectui#10038". PR objectui#10038 answers 200 and is the landing of
`ce986aafc`, so the dead half goes and the live half stays.
- `7025-nonoptional-enum-cast.md`: "the same walk objectui#6924
converged the optional-cast family onto in PR objectstack-ai#7024" becomes "the same
walk PR objectstack-ai#7024 converged the optional-cast family onto". PR objectstack-ai#7024 answers
200 and is `78e98bf44`'s pull request.
2. **The sister-repo number.** In `UnpublishedAppBar.tsx`,
"(objectstack#4829 A1, framework PR objectstack-ai#6942)" becomes "(objectstack#4829
A1, framework PR objectstack#6942)". See **Premise**.
3. **The card named by role.**
- **objectstack-ai#7023**, in `4895-retire-block-schema-family.md`: "and objectui#7023
— the narrower validator-only fix — dissolves into this retirement"
becomes "and the separate card for the narrower validator-only fix
dissolves into this retirement". That card never landed on its own.
- **"The card behind SHA"**, where the sentence rests on something that
lived only on the card:
- `6755-field-diagnostics-i18n.md`: "objectui#6888 carries it" becomes
"The card behind `320374d2a` carries it". Carrying a pending item is the
card's act.
- `data-objectstack` `index.ts`: "Unlike objectui#6889's exotic case"
becomes "Unlike the exotic case on the card behind `f75810e7c`". The
exotic case is not in the commit.
- `toHostProps.ts`: "the specific mistake objectui#7008's ruling fences
off" becomes "the specific mistake the ruling on the card behind
`f08bcd9af` fences off". The quoted ruling text is the card's, not the
commit's.
- `zod-wrapper-keys.ts`: "the wall objectui#6923 was filed to get a
ruling on" becomes "the wall the card behind `d3bf4fa6f` was filed to
get a ruling on".
- `base.zod.ts`: "objectui#7069 called this repo's systematic producer"
becomes "the card behind `2760075ff` called this repo's systematic
producer". The commit's own diff attributes that phrase to the card.
- The timeline renderer names objectstack-ai#7036's deferral, triage and "1 of 6"
trade. These become "the file surface the card behind `869b876c8`
deferred", "the triage of the card behind `869b876c8`" and "the card
behind `869b876c8` was stopped from making". None of the three is in the
commit.
4. **Rulings by date.**
- `union-arm-diagnostics.ts`: "the 2026-09-02 ruling on objectui#7004
asks for" becomes "the 2026-09-02 ruling `a5d55472b` implements asks
for".
- `validate.ts`: "The ARM-SELECTION half of objectui#7004 landed on the
2026-09-02 maintainer ruling" becomes "The ARM-SELECTION half
(`a5d55472b`) landed on the 2026-09-02 maintainer ruling".
- `7201-schema-slot-census-gate.md`: "across objectui#6882, the ruling
that expired both holds" becomes "across the 2026-08-30 ruling that
expired both holds (`bf97b98c8`)".
- `7687-combobox-option-disabled.md`: "by the objectui#7087
twin-symmetry ruling" becomes "by the 2026-09-01 twin-symmetry ruling,
`c93b4d5f3`".
- `defaults-table-scan.ts`: "the one objectui#6923 already ruled for
exactly that wall" becomes "the one the 2026-08-31 ruling (`d3bf4fa6f`)
already set for exactly that wall".
5. **Own-card pointers that needed a word.**
- `6931-tombstone-guidance-remainder.md` and
`6888-location-residue-refusal-keyed.md`: the pointer sat on its own
line, so the period moved up with it.
- `7087-disabled-twin-symmetry.md`: the parenthesis opened on the dead
card, so the line break moved with it.
- `7004-cli-root-path-line.md`: "(objectui#7004, mechanical half)" is
dropped, so the sentence ends "sits at the document root." (patch round
1 took the review's nit), and "left open on objectui#7004 for a
maintainer ruling" becomes "left open for a maintainer ruling".
- `shared-zod-wrapper-keys-6923.md`: "objectui#6923: the Zod wrapper-key
list" becomes "The Zod wrapper-key list".
- `vi-mock-inherit-slice2.md` and `slice3.md`: "(objectui#6892 slice 2)"
becomes "(slice 2)", and likewise for slice 3.
6. **The totality sequence in the timeline renderer.** "(objectstack-ai#6759 -> objectstack-ai#6905
-> objectstack-ai#6907 -> objectstack-ai#7027)" becomes "(objectstack-ai#6759 -> `85f6a6097` -> `7fc5c3c12` ->
objectstack-ai#7027)", and likewise with "-> objectstack-ai#7036" as `869b876c8`. objectstack-ai#6759 and objectstack-ai#7027
answer 200 and stay. objectstack-ai#6905 was the pull request whose squash is
`85f6a6097`. "⚠️ objectui#7036 — READ THE TWO PARAGRAPHS" becomes "⚠️
`869b876c8` — READ…", and the "see the objectui#7036 note below" that
points at it follows.
7. **The runtime strings.** Only the listed text moves in each.

| file | member | before | after |
|:--|:--|:--|:--|
| `types/src/zod/crud.zod.ts` | `ActionSchema.onSuccess` (tombstone) |
"RETIRED (objectui#7068) — `onSuccess` is no longer part of this legacy
ActionSchema; ..." | "RETIRED (ADR-0049) — `onSuccess` is no longer part
of this legacy ActionSchema; ..." |
| `types/src/zod/crud.zod.ts` | `ActionSchema.onFailure` (tombstone) |
"RETIRED (objectui#7068) — `onFailure` is no longer part of this legacy
ActionSchema; ..." | "RETIRED (ADR-0049) — `onFailure` is no longer part
of this legacy ActionSchema; ..." |
| `types/src/zod/data-display.zod.ts` | `DataTableSchema.rowActions`
`.describe()` | "... mirrors the boolean the renderer truthiness-tests
(objectui#6940)" | "... mirrors the boolean the renderer
truthiness-tests" |
| `types/src/zod/data-display.zod.ts` | `DataTableSchema.cellClassName`
`.describe()` | "... so row density has to be set on both
(objectui#6882)" | "... so row density has to be set on both" |

**The ADR-0049 condition, measured from the retirement itself** (Zone 1
item 4):
- the zod comment above the two keys opens "ADR-0049 RETIREMENT
TOMBSTONES";
- its landing commit `6bca0e4e8` writes them as tombstones, not
deletions, and adds the pending `action-callback-retired-7068.md`, which
says "ADR-0049 enforce-or-remove";
- each string already ends "Retired under ADR-0049 enforce-or-remove".

Both open `RETIRED (ADR-0049) —`. Their TypeScript twins in `crud.ts`
read "RETIRED (`6bca0e4e8`, ADR-0049 enforce-or-remove)", the batch 3
twin form.
8. **What follows the strings, and nothing else in it.**
`action-callback-retired-7068.test.ts` pins both guidance strings as
full literals (`ON_SUCCESS_GUIDANCE`, `ON_FAILURE_GUIDANCE`), and their
openings follow. Its test names and four `@ts-expect-error` comments
still read "RETIRED (objectui#7068)". They describe the `?: never`
TypeScript face, quote no runtime string, and are out of the card's
classes (**Acceptance notes** 3). No test, doc or changeset quotes
either `.describe()` string: a whole-tree search for each old string
returns only the source line.
- Patch round 1: three pins quoted re-pointed COMMENT text, and they
follow it, anchor only (ruling `5861900779`, route a).
- `layout-default-jsdoc-7361.test.ts`: `toContain('6942')` becomes
`toContain('57f9b077b')` (the `TextSchema.variant` docblock).
- `cellClassNameCensusProse-6921.test.ts`:
`toMatch(/objectui#6882|objectstack-ai#6882/)` becomes `toMatch(/bf97b98c8/)` (the
`cellClassName` census entry).
- The same file: `toMatch(/REDUNDANT since objectui#6882/)` becomes a
match on "REDUNDANT since `bf97b98c8`" (the holds-member docblock).
     - Their titles, messages and comments stay as they are.
9. **The `MarkdownSchema` docblock (patch round 1, review
`5861897723`).** Round 0 wrote "Both refuse BY NAME through
`retirementTombstone()` (`8063bcbdc`), with the remedy in the message".
`8063bcbdc` never touched `MarkdownSchema`; `446d93d4e` retired
`sanitize` / `components`. So the sha did not carry what it was cited
for, the objectstack-ai#5738 class. It now reads "through `retirementTombstone()`, the
spelling `8063bcbdc` made uniform, with the remedy in the message". That
commit's own subject says the remaining tombstones carry their
remediation text. The edit is a comment, and the file's C4 print is
unchanged by it.
10. **The anchor sweep that closes the gap (patch round 1).**
- **Instrument:** every string, template, numeric and regex literal in
all 3814 test and script files under `packages/` and `scripts/`,
enumerated with `git ls-tree` at this head and parsed with TypeScript.
- **Test applied to each literal:** does its occurrence count DROP
between `main` and this head in any of the 90 files this PR changes? Raw
text and a comment-flattened form are both checked.
- **Specific anchors found** (a batch number, a changed phrase, or a
pattern keyed to them), after reading every hit against the file it sits
in:
     - the three pins above;
- `tombstone-discriminator-agreement-9684`'s /RETIRED \(objectui#/ note
search, which reads only `mobile.ts` and is untouched by this PR.
- **Everything else:** generic tokens (whitespace, punctuation,
`objectui#` spellings in ledger checks over the tests' own data, digit
and letter classes), none of them an assertion over text this PR
changed.
- **Round 0's quote search** covered runtime strings only. That is the
gap this sweep closes.

## Held

**By the serial rule: nothing.** Round 0's list: objectui#10873, objectstack-ai#10871,
objectstack-ai#10870, objectstack-ai#10852, objectstack-ai#10821, objectstack-ai#10780, objectstack-ai#10777, objectstack-ai#10714, objectstack-ai#10278 and objectstack-ai#5400. Since
then objectstack-ai#10873, objectstack-ai#10871, objectstack-ai#10870 and objectstack-ai#10821 have merged. objectstack-ai#10870 touched
`base.zod.ts` in a region apart from this PR's line, and the merge with
it is clean.
- Re-read before the round-1 push: 11 open. Besides this PR they are
objectui#10880, objectstack-ai#10879, objectstack-ai#10878, objectstack-ai#10876, objectstack-ai#10852, objectstack-ai#10780, objectstack-ai#10777, objectstack-ai#10714,
objectstack-ai#10278 and the release PR objectstack-ai#5400.
- Four of them hold files this PR edits:
  - objectui#10879: `types/src/zod/data-display.zod.ts`;
- objectui#10878: `data-objectstack/src/index.ts` and
`plugin-grid/src/ObjectGrid.tsx`;
- objectui#10714: `types/src/data-display.ts`, `types/src/layout.ts` and
`types/src/zod/data-display.zod.ts`;
  - objectui#10278: `plugin-grid/src/ObjectGrid.tsx`.
- Each one's hunks were read against its merge-base, with 3 lines of
context. **None of the 29 lines this PR changes in those files appears
inside or beside any of their hunks.**
- Trial merges of each open PR head with this head (`git merge-tree
--write-tree`) are clean for objectstack-ai#10880, objectstack-ai#10879, objectstack-ai#10878, objectstack-ai#10876, objectstack-ai#10852,
objectstack-ai#10780, objectstack-ai#10777 and objectstack-ai#10714.
- objectstack-ai#10278 (`eab4c8e52`) conflicts in `ObjectGrid.tsx`, but it conflicts
identically against `main` alone: one conflict hunk in its own page-size
region either way.
- PR objectstack-ai#5400 (Version Packages) regenerates and is not a hold.

## Changesets

- `.changeset/10803-dead-citation-sweep-fourth-batch.md`, EMPTY
frontmatter: the comment-only edits in 12 released packages and the
private `@object-ui/test-support`. No published behaviour changes
through them. It points at the second file for the runtime text.
- `.changeset/10803-fourth-batch-runtime-strings.md`,
`'@object-ui/types': patch`: the two tombstones open `RETIRED (ADR-0049)
—` with everything after the dash unchanged, and the two describe
strings lose their pointer. No key, path, issue code, accept set,
refusal or severity moves.

## Proof of prose-only (C4), against the merged `main` `de1b879a6`

- **Source.** Each of the 48 touched `.ts` / `.tsx` files was parsed at
`de1b879a6` and at this head with TypeScript 6.0.3's `createSourceFile`
and re-printed by `createPrinter({ removeComments: true })`. The 48 are
the 45 non-test sources and three tests: the one pinning the strings,
and the two whose comment-text anchors follow.
- 43 of 48 prints are identical. That includes all 45 non-test sources
except `crud.zod.ts` and `data-display.zod.ts`, whose `MarkdownSchema`
comment edit moves nothing.
- The other 5 are equal once exactly the 9 listed substitutions are
applied to the `main` print, each matched once:
    - `crud.zod.ts`: the two tombstone strings;
    - `data-display.zod.ts`: the two describe-string deletions;
- `action-callback-retired-7068.test.ts`: the same two tombstone
strings;
    - `layout-default-jsdoc-7361.test.ts`: the one anchor;
    - `cellClassNameCensusProse-6921.test.ts`: the two anchors.
  - 0 parse diagnostics.
- Lit controls on the same instrument: dropping "(ADR-0049)" from the
`onSuccess` string moves the print; re-spacing the "ADR-0049 RETIREMENT
TOMBSTONES" comment does not.
- **Changesets.** The frontmatter block of every one of the 40 edited
changesets is byte-identical at `de1b879a6` and this head (40 of 40, by
md5). The overwrite gate below agrees.
- **Scope of the diff against the merged `main`:** 90 files, +227 /
−184: 40 edited and 2 new changesets, 45 non-test source files, and 3
tests.

## Gates, on this head `ae0b81089`

Each line is the gate's own verdict and exit code, captured by
redirect-then-`$?`.

- `node scripts/check-changeset-presence.mjs`, exit 0: "44 source
file(s) of 12 released package(s) changed, and this change declares 2
changeset(s): .changeset/10803-dead-citation-sweep-fourth-batch.md,
.changeset/10803-fourth-batch-runtime-strings.md." (44 = the 41 released
sources and the 3 tests under released packages' `src/`; the four
`test-support` files sit under a package changesets ignores.)
- `pnpm changeset:check`, exit 0: "All workspace packages are in the
changeset fixed group." / "No changeset declares a `major` bump."
- `node scripts/check-changeset-overwrite.mjs` (report-only), exit 0: "2
changeset(s) added, 40 modified, 0 deleted". `declared at base` equals
`declares now` for 40 of 40.
- `pnpm check:changeset-claims` (report-only), exit 0:
- born-false: "Every one of those 1 address(es) either names the tree it
was read from, or points at a line this change does not move";
- self-contradiction: "Every package declared across those 30 body(ies)
is either not negated in its own prose, or negated only in an ASPECT of
it that may legitimately hold still";
- the standing notice "83 pending changeset(s) describe a file this
change touches".
- Read against the diff: a pending changeset quoting a replaced pointer
would itself carry the dead number and so sit in the census. No pending
changeset quotes either tombstone string or either describe string; the
one textual hit, "truthiness-tests" in
`6940-rowactions-boolean-mirror.md`, is prose, not a quote.
- `pnpm check:control-bytes`, exit 0: "check-control-bytes: OK (scanned
9125 tracked text file(s); skipped 85 binary)."
- `pnpm check:new-line-citations`, exit 0: "VERDICT
new-cross-file-line-citations: 0 new citation(s), enforcement
report-only -> exit 0".
- Also run: the governed-surface predicate over the 90 paths, exit 0:
"NOT GOVERNED — 90 path(s) checked against 5 governed surface(s); none
matched." (lit control `AGENTS.md`: exit 3).

**Tests**, through the shared verify lock.
- **Red, reproduced first.**
- `layout-default-jsdoc-7361` on `d21aeb0f6` itself gives `VERDICT
command-exit 1`, `Tests 1 failed | 74 passed (75)`: "expected '/**\n *
Text variant/style. …' to contain '6942'".
- `cellClassNameCensusProse-6921`: its `d21aeb0f6` copy was checked out
over this tree and run. `ObjectGrid.tsx` and the census changesets it
reads are identical at `d21aeb0f6` and here. Result: `Tests 2 failed | 3
passed (5)`, on `/objectui#6882|objectstack-ai#6882/` and `/REDUNDANT since
objectui#6882/`. The file was then restored with `git checkout HEAD --`,
checked by blob hash against `HEAD`, and `git diff HEAD` came back
empty.
- **Green, on this head `ae0b81089`:** `layout-default-jsdoc-7361`,
`cellClassNameCensusProse-6921`, `action-callback-retired-7068`,
`data-table-declared-keys-6882`,
`tombstone-discriminator-agreement-9684` and `zod-mirror-parity` give
`Test Files 6 passed (6)`, `Tests 181 passed (181)`.
- The run was the last part of the locked batch, so its exit is the one
the lock's `VERDICT batch-last-exit 0` reports.

**Declared narrowing (per the dispatch: the named checks, not wider
sweeps).** NOT MEASURED locally: the full suites and type-check of the
12 touched packages, and eslint. Reason: the comment-stripped syntax
tree of 43 of the 48 touched files is identical to `main`, and the other
5 differ only by the listed literal edits. Every test that anchors on a
changed string or comment was found by the anchor sweep (**Special
cases** 10) and run above. CI runs the full farm.

## Acceptance notes

1. **The remainder rides this card, unchanged (seat amendment
`5860244997`, Q2 = A).** Of the 83 numbers PR objectui#10869's
Acceptance notes item 1 lists, this PR carries the first 30 in ascending
order. The other **53** are: objectstack-ai#7091 objectstack-ai#7097 objectstack-ai#7108 objectstack-ai#7177 objectstack-ai#7612 objectstack-ai#7620 objectstack-ai#7623
objectstack-ai#7658 objectstack-ai#7666 objectstack-ai#7667 objectstack-ai#7669 objectstack-ai#7678 objectstack-ai#7681 objectstack-ai#7682 objectstack-ai#7703 objectstack-ai#7704 objectstack-ai#7708 objectstack-ai#7804 objectstack-ai#7844
objectstack-ai#7853 objectstack-ai#7869 objectstack-ai#7874 objectstack-ai#7877 objectstack-ai#7926 objectstack-ai#7959 objectstack-ai#7967 objectstack-ai#7979 objectstack-ai#7980 objectstack-ai#8058 objectstack-ai#8060 objectstack-ai#8072
objectstack-ai#8127 objectstack-ai#8137 objectstack-ai#8204 objectstack-ai#8229 objectstack-ai#8248 objectstack-ai#8307 objectstack-ai#8408 objectstack-ai#9231 objectstack-ai#9241 objectstack-ai#9244 objectstack-ai#9365 objectstack-ai#9373
objectstack-ai#9375 objectstack-ai#9542 objectstack-ai#9553 objectstack-ai#9585 objectstack-ai#10117 objectstack-ai#10119 objectstack-ai#10120 objectstack-ai#10129 objectstack-ai#10132 #14026. None
of them occurs in any hunk of this diff.
2. **The C0 bare-number 404s, for later batches** (sites at `e32dae160`,
lines / files):
- **New to the family:** objectstack-ai#3720 (5 / 3), objectstack-ai#5420 (1 / 1), objectstack-ai#5503 (1 / 1),
objectstack-ai#5506 (1 / 1), objectstack-ai#5737 (4 / 4), objectstack-ai#6467 (1 / 1), objectstack-ai#6936 (1 / 1), objectstack-ai#6945 (1 /
1), objectstack-ai#7622 (1 / 1), objectstack-ai#7662 (1 / 1), objectstack-ai#7684 (2 / 2).
- objectstack-ai#5737, objectstack-ai#6945, objectstack-ai#7622, objectstack-ai#7662 and objectstack-ai#7684 are written "PR #N". A later
batch can look for each one's squash commit, as batch 3 did for objectstack-ai#5505
and objectstack-ai#5758.
- The objectstack-ai#3720 sites are in `ObjectGrid.tsx`, `rowCrudAffordances.ts` and
`ListView.tsx`. `ObjectGrid.tsx` is also held by open PR objectui#10278.
- **Already on the family list:** objectstack-ai#7620, objectstack-ai#7678 and objectstack-ai#7853. They have bare
sites too, which the printed instrument counts.
- **Not read:** the 22 distinct bare numbers above 10900 (budget).
Nothing here re-derives whether any of them is dead.
3. **Published or shipped text outside the two in-scope classes still
names some of these numbers.** It is untouched by scope, as another
class the triage split did not scope here:
- `content/docs`: `enhanced-actions.mdx` and `schema-overview.md` say
the callbacks were "RETIRED (objectui#7068)" in prose, not as verbatim
quotes of the runtime string; `plugin-form.mdx` names objectui#6958.
- The private `@object-ui/test-support` README names objectui#6923 and
objectstack-ai#6924.
- Published `CHANGELOG.md` history, which is never re-addressed. It
includes a bare "framework PR objectstack-ai#6942" in `@object-ui/app-shell`'s.
- In tests: `action-callback-retired-7068.test.ts`'s test names and four
`@ts-expect-error` comments reading "RETIRED (objectui#7068)";
`layout-default-jsdoc-7361.test.ts`'s header-table comment naming
objectui#6942; and the test names and comments in
`cellClassNameCensusProse-6921.test.ts` that name objectstack-ai#6882. Only anchors
moved (ruling `5861900779`).
   - Carrier: none.
4. **Filenames are not citations.** Pending changeset and test FILENAMES
carry several of these numbers. They stay, as in PRs objectui#10707,
objectstack-ai#10797, objectstack-ai#10854 and objectstack-ai#10869.

---
_Generated by [Claude
Code](https://claude.ai/code/session_014mXUNuFomfj24w7s1pZzhN)_

---------

Co-authored-by: Claude <noreply@anthropic.com>
akarma-synetal pushed a commit to akarma-synetal/objectui that referenced this pull request Sep 28, 2026
…imports (^17.4.0) (objectstack-ai#10882)

Fixes objectstack-ai#10864
Clause-②: no

## What changed

- Raised `packages/app-shell/package.json`'s declared
`@objectstack/spec` range from `^17.3.0` to `^17.4.0` — the first
published spec version that exports the four symbols two shipped
app-shell sources import at runtime (`predicateSlotRefusal`,
`structuralConditionRefusal` from `@objectstack/spec/automation`;
`EVALUATED_EXPRESSION_SOURCE_REQUIRED`, `EvaluatedExpressionSchema` from
`@objectstack/spec/shared`), matching the range `@object-ui/types`
already declares.
- Regenerated `pnpm-lock.yaml` with `pnpm install --lockfile-only` —
moves only the app-shell `@objectstack/spec` specifier line.
- Added `.changeset/10864-app-shell-spec-floor.md` (`patch`,
`@object-ui/app-shell`).
- Amended the pending
`.changeset/5920-flow-runner-translation-overlay.md` with a dated note:
its closing sentence claimed the package "now declares `^17.3.0`", which
this change makes false. Frontmatter untouched — only the body gained
the note, following the objectui#10533 precedent.
- No source files changed, and no revert of anything to lower a floor.

## M1 to M4

- **M1** (reproduce red on `main`): full workspace build (`turbo run
build --filter='!@object-ui/site' --concurrency=2`, 43/43 tasks
successful), then `pnpm check:spec-floors` exited 1 with exactly 4
`floor-too-low` findings, all in `@object-ui/app-shell`, matching the
issue: `predicateSlotRefusal` and `structuralConditionRefusal` from
`packages/app-shell/dist/views/metadata-admin/previews/screen-spec.js` /
`flow-sim-validate.js`, plus `EVALUATED_EXPRESSION_SOURCE_REQUIRED` and
`EvaluatedExpressionSchema` from `flow-sim-validate.js`. No other
package surfaced a finding.
- **M2** (confirm the four symbols): `npm pack @objectstack/spec@17.3.0`
and `@17.4.0`, unpacked and grepped `dist/`. All four names: 0 hits
anywhere under 17.3.0's `dist/`; present under 17.4.0's
`dist/automation` and `dist/shared` (`.js` / `.mjs` / `.d.ts` /
`.d.mts`).
- **M3** (regenerate lockfile with pnpm): `pnpm-lock.yaml` diff is `1
file changed, 1 insertion(+), 1 deletion(-)` — only the
`@object-ui/app-shell` importer's `@objectstack/spec` `specifier:` line
moves, from `^17.3.0` to `^17.4.0`. The resolved `version:` on that line
was already `17.4.0` before this change (normal resolution already
picked the newest 17.x; `pnpm install` after the edit reported "Already
up to date").
- **M4** (after the change): `pnpm check:spec-floors` exits 0 — "✅ Every
consumer-facing `@objectstack/spec` floor carries the symbols its
package's artifact references" (19 of 39 published packages inspected,
341 (subpath, symbol) pairs judged). `pnpm --filter @object-ui/app-shell
type-check` exits 0 (`tsc --noEmit && tsc -p tsconfig.test.json`).

## Gates

- `pnpm check:spec-floors` — red before (4 `floor-too-low` findings) →
green after (0 findings; see M1/M4).
- `pnpm --filter @object-ui/app-shell type-check` — exit 0.
- `pnpm --filter @object-ui/app-shell test` — exit 0: `Test Files 841
passed | 1 skipped (842)`, `Tests 8618 passed | 9 skipped (8627)`
(root-form invocation, `vitest run --root ../.. packages/app-shell/`, no
filtering trap).
- `node scripts/check-control-bytes.mjs` — exit 0 (9120 tracked text
files scanned, 85 binary skipped).
- `node scripts/check-changeset-presence.mjs` — exit 0 (1 changeset
added; the `dependencies` version bump itself is not one of the eight
published-contract fields the gate tracks, so it reported "no changeset
is owed" independent of the one added).
- `node scripts/check-changeset-fixed.mjs` /
`check-changeset-no-major.mjs` — both exit 0.
- `node scripts/check-lockfile-integrity.mjs` — VERDICT clean (no
`@objectstack/*` identity moved backward, no package gained a copy).
- `node scripts/check-lockfile-dedupe.mjs` — VERDICT deduped (`pnpm
dedupe` would collapse nothing).
- `node scripts/check-installed-spec-pin-claims.mjs` — OK
(`@objectstack/spec = 17.4.0`, lockfile and resolved tree agree).
- `node scripts/check-changeset-claims.mjs` (report-only) — flagged 4
pending changesets naming a file this PR touches (`pnpm-lock.yaml` or
`packages/app-shell/package.json`). Read each against this diff:
`5793-spec-range-floors.md` and `6361-spec-floor-17-2-0.md` describe a
different importer's edge (their own packages resolving `17.2.0`, an
edge this one-line specifier bump does not move);
`6776-metadata-admin-lazy-registration.md` describes the `sideEffects`
array, which this diff does not touch;
`7122-objectstack-family-17-3-0.md` describes the `@objectstack/client`
/ `core` / `formula` / `lint` family pins, also untouched. None
falsified — this is the fifth pending changeset the gate named,
`5920-flow-runner-translation-overlay.md`, and that one *was* falsified
and is amended above.
- `node scripts/check-changeset-overwrite.mjs` (report-only) — reports
the one changeset this PR modifies (`5920-…`); case 2, "correcting a
declaration on purpose" — same package and bump level declared at base
and now, only the body gained a dated note.
- `node scripts/check-new-cross-file-line-citations.mjs` — 0 new
citations.
- `node scripts/check-pending-changeset-literals.mjs` — exit 0.

## Serial

Re-checked open PRs against this branch's file surface: 11 open
(`objectstack-ai#10880, objectstack-ai#10879, objectstack-ai#10878, objectstack-ai#10876, objectstack-ai#10875, objectstack-ai#10852, objectstack-ai#10780, objectstack-ai#10777,
objectstack-ai#10714, objectstack-ai#10278`) plus the release PR `objectstack-ai#5400`. Only `objectstack-ai#10878` touches
`pnpm-lock.yaml`, and only at the `@object-ui/data-objectstack` and
`@object-ui/plugin-grid` importer blocks (each raising its own
`@objectstack/spec` floor to `^17.4.0` independently) — not the
`@object-ui/app-shell` block this PR moves. No open PR touches
`packages/app-shell/package.json` or either changeset file. The release
PR regenerates and is not a hold.

---
_Generated by [Claude
Code](https://claude.ai/code/session_014mXUNuFomfj24w7s1pZzhN)_

---------

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Grid grouping and its per-group counts are computed over the fetched page, so a group can be missing entirely with nothing on screen saying so

2 participants