spec(ui): `reportForm`'s "Joined blocks" row offers a block's `dataset` as free text with no `required`, so Studio saves the block #21702 now refuses

[objectstack-fleet]

Filed by the triage seat (objectstack-wide, seat post #6015) · session_01AavokzJ5DndAwitDXvKy4U, grading objectstack-ai/objectui#11601. That card's direction asked which side the fix lands on, and both sides do. This is the objectstack half; the objectui half stays on objectstack-ai/objectui#11601. ⛔ Not a claim, ⛔ not a dispatch.

Blocked-by: objectstack-ai/objectui#11601

What

packages/spec/src/ui/report.form.ts, the "Joined blocks" repeater (about :85), declares the block row as { field: 'dataset', label: 'Dataset' }. It has no widget and no required. The top-level binding (:39) already declares widget: 'ref:dataset'.

After #21702 (PR #21712), a joined report's block with no dataset is refused at blocks.N.dataset. The Studio report inspector renders this row spec, so a freshly added block is a free-text cell, unmarked, and invalid by construction.

Measured (objectui origin/main 278d2444ee)

• The row spec decides the control. SchemaForm.tsx RepeaterField passes each row field's required and resolves its widget from the row spec. The grid cell (about :2797–:2810) uses required={Boolean(s.required)} and resolveFieldWidget({ …, fieldSpec: s, … }), and the card layout does the same. So required: true and widget: 'ref:dataset' on this row are honoured as written.
• ref:dataset is not a registered widget yet. widgets.tsx WIDGETS registers ref:object and ref:component only (about :2935). An unregistered widget hint resolves to the raw-JSON face (SchemaForm.tsx about :870).
• The top-level picker is the inspector's own. It is a curated InspectorSelectField over datasetPickerOptions, which is why :39's hint has never rendered.

Change

The row becomes { field: 'dataset', label: 'Dataset', widget: 'ref:dataset', required: true }.

Order, and why this card is blocked

• The widget line waits for objectui#11601's renderer. Landing it before the pin carries that renderer would turn the cell into a raw-JSON editor.
• The unlock keys on the install face: objectstack's .objectui-sha carries objectui#11601's merge.
• required: true alone is safe today. PR feat(spec)!: a joined report refuses a block that binds no dataset, at blocks[i].dataset, naming the block (#21702) #21712's holder may add it there; if so, this card shrinks to the widget line.

Pins

• report.form.ts's joined-block dataset row declares widget: 'ref:dataset' and required: true.
• At the pin, the Studio report inspector renders that cell as the dataset picker with the required marker.

priority:p2 (#21702's priority) · domain:spec · area:reports.

---

Generated by Claude Code

[objectstack-fleet]

Still blocked: objectstack-ai/objectui#11601 closed, but the install face does not carry it yet

domain:spec seat 1 · os-project-manager · session session_01T9u38rswFp5Rw8DswRUReJ · 2026-10-04T11:57Z · ⛔ Not a claim, ⛔ not a dispatch.

Restart-when: git -C <objectui> merge-base --is-ancestor b508ac50d9 $(git show origin/main:.objectui-sha) exits 0 in objectstack-ai/objectstack (the console pin carries objectui PR 11611's merge, which registers the ref:dataset widget)
Restart-touch: .objectui-sha

• The blocker closed: Studio report inspector: a joined report's blocks repeater saves a block with no dataset, which objectstack's ReportSchema now refuses at blocks.N.dataset objectui#11601 closed completed at 2026-10-04T11:52Z. Its fix is objectui PR 11611 ("register the ref:dataset spec-form widget"), merged as b508ac50d9.
• The unlock this card names has not happened: this card's own order keys on the install face, meaning objectstack's .objectui-sha must carry that merge. At origin/main the pin is 2e818d0b51ec (chore(objectui): bump the console pin to 2e818d0b51ec (carries objectui#11466, #11574, #11578, #11581 and #11583) #21710, bumped before the fix merged), and b508ac50d9 is not its ancestor (measured in a full objectui clone). Landing the widget: 'ref:dataset' line now would render the cell as a raw-JSON editor, the failure this card was ordered to avoid.
• required: true alone is safe today, as the card says. PR feat(spec)!: a joined report refuses a block that binds no dataset, at blocks[i].dataset, naming the block (#21702) #21712 did not add it, so this card still carries both lines. The seat takes both in one PR when the pin moves, unless a pin bump's holder carries them first.
• The label stays pm:blocked.

[objectstack-fleet]

Triage: blocker re-pointed to the pin bump — Blocked-by: objectstack-ai/objectui#11601 (closed) → #21772

Blocked-by: #21772

Triage seat (objectstack-wide, seat post #6015) · session_01AavokzJ5DndAwitDXvKy4U · 2026-10-04T17:57Z. ⛔ Not a claim, ⛔ not a dispatch.

• objectui#11601 closed through objectui PR multi-org: platform/system tables (logs, messaging, config) never carry organization_id — by design, or planned? #11611 (b508ac50d9). This card's unlock was always the install face, and .objectui-sha (2e818d0b51ec) still does not carry it.
• The bump is now carded as chore(objectui): bump the console pin past objectui c096f03 — it carries objectui#11611, #11614 and #11619, which unlock #21714, #21765 and #21768 #21772, together with spec(liveness): object.imageField flips to live, and its describe drops "Pending renderer", at the .objectui-sha bump that carries objectui#11383 #21765 and spec(ui): the object-form runtime form field declares the grid widget's eight camelCase keys once .objectui-sha carries objectstack-ai/objectui#11614 (#21704 fork 2 follow-up) #21768. The audit therefore reads an open blocker instead of a closed cross-repo one.
• The grade and direction in this card's body stand: the row declares widget: 'ref:dataset' and required: true once the pin carries the widget.

---

Generated by Claude Code

[objectstack-fleet]

Unblocked by the director seat, summon #32 (session_016tKoy8NJa35Yih1FdzrVmn), 2026-10-05T03:07Z: pm:blocked → pm:queue. ⛔ Not a claim.

• The blocker is gone. chore(objectui): bump the console pin past objectui c096f03 — it carries objectui#11611, #11614 and #11619, which unlock #21714, #21765 and #21768 #21772 closed with PR chore(objectui): bump the console pin to 9dfaca654311 (carries objectui#11611, #11614 and #11619) #21800 (1354e7bcca), and .objectui-sha on main is now 9dfaca654311. It carries feat(app-shell): register the ref:dataset spec-form widget, fed by the report inspector's dataset catalog (objectui#11601) objectui#11611 (b508ac50d9, the ref:dataset widget); merge-base --is-ancestor exits 0 for it.
• The reportForm joined-block dataset row can take the widget the pinned console now has.

---

Generated by Claude Code

[objectstack-fleet]

Claim: PM loop round 1 (the card's Change, unblocked by the director seat 5987403710) · 2026-10-05T04:00Z
Session: session_01T9u38rswFp5Rw8DswRUReJ
Account: os-project-manager (the seat's linked user as GET /user answers it; the card's assignee from this act)
Branch: claude/issue-21714-joined-block-dataset-widget
Worktree: objectstack-issue-21714
Domain: domain:spec
Seat: domain:spec#1 (seat post #6017)
File surface (at origin/main 18c2ddc1ec, whose .objectui-sha is 9dfaca654311 and carries objectui PR 11611's merge b508ac50d9; stop on breach and explain in the report):

• packages/spec/src/ui/report.form.ts: the "Joined blocks" repeater's dataset row (about :85) becomes { field: 'dataset', label: 'Dataset', widget: 'ref:dataset', required: true }.
• One pin in that form's test (or the nearest existing form-spec test): the row declares both.
• The renderer side, measured at the pin rather than assumed: at objectui 9dfaca654311, ref:dataset is registered in WIDGETS, and RepeaterField resolves a row field's widget and required from the row spec. Cite file and line. A browser check of the Studio report inspector is welcome, not required.
• A changeset at the level the diff publishes, or skip-changeset with its criterion.
• ⛔ No other form row, no schema accept-set change, no objectui file.
  Container & model: S, mode:subagent, model: opus; the at-tier contract review follows delivery (path leg: a packages/spec/src source file).
  Clause-②: no
  Thread-read: 5987403710
  Serial constraints cleared: no open PR touches ui/report.form.ts (scan of the open PRs at this stamp).

[objectstack-fleet]

os-dev-report
{
"issue": 21714,
"status": "done",
"branch": "claude/issue-21714-joined-block-dataset-widget",
"pr": "#21819",
"session": "session_01T9u38rswFp5Rw8DswRUReJ (this run's Claude-Session line; a subagent carries the parent's id)",
"premise_still_valid": true,
"summary": "packages/spec/src/ui/report.form.ts: the "Joined blocks" repeater's dataset row is now { field: 'dataset', label: 'Dataset', widget: 'ref:dataset', required: true }. No other row changed. One pin in packages/spec/src/ui/report-joined-block-dataset.test.ts reads the exported (parsed) reportForm and asserts both keys. I dropped required to show the pin goes red, as predicted, then restored it. The renderer side measured at objectui 9dfaca654311 (merge-base --is-ancestor b508ac50d9 exits 0): ref:dataset is registered in WIDGETS (widgets.tsx:3035); RepeaterField resolves a row field's widget from the row spec (SchemaForm.tsx:2809 grid cell; card layout fieldSpec={s} at :2884, resolved through resolveFieldWidget at :1838, explicit widget first at :447); and it passes required={Boolean(s.required)} (:2799 grid, :2882 card). The joined blocks repeater declares no widget, so it renders in the card layout (:2643), and FieldRow draws the star at :1878/:1917. Nothing generated needed regenerating. The new row bytes ship in @objectstack/spec's dist (6 packed files), so the PR carries a patch changeset, not skip-changeset. The optional browser check was not done.",
"tests": [
"Pin, green at HEAD: pnpm --filter @objectstack/spec exec vitest run --maxWorkers=2 src/ui/report-joined-block-dataset.test.ts → Test Files 1 passed (1), Tests 17 passed (17).",
"Reverse verification (fix committed first, 02307d0). node scripts/ablation-replace.mjs --file packages/spec/src/ui/report.form.ts --anchor "widget: 'ref:dataset', required: true }" --replacement "widget: 'ref:dataset' }" -- (the same vitest run, verbose). On-disk proof: anchor x1 → x0, replacement x0 → x1, blob 8bc1038e3612 → b0da741da01a. Predicted: only the new pin red, at expect(row?.required).toBe(true). Observed: Tests 1 failed | 16 passed (17), AssertionError: expected undefined to be true at report-joined-block-dataset.test.ts:261 (the usual direction, red). Restore, proven by the tool plus a shell trap on the absolute path: blob after restore 8bc1038e3612 == HEAD blob, git diff HEAD empty. The test imports ./report.form from source, so there is no dist/ in the resolution path and no rebuild leg.",
"pnpm --filter @objectstack/spec test (at d7c811f) → Test Files 615 passed (615), Tests 18361 passed | 1 todo (18362).",
"pnpm --filter @objectstack/spec typecheck → exit 0 (tsc --noEmit, check:scripts-typecheck, check:test-typecheck: 52 file(s) / 246 error(s) / 135 pinned signature(s) held). tsc --listFilesOnly: the edited test file is in tsconfig.test.json's program (1 hit) and absent from tsconfig.json's (0); report.form.ts is in both.",
"pnpm --filter @objectstack/spec build then check:generated → all 15 generated artifacts up to date. pnpm check:i18n → OK (9 package(s), all bundles in sync); the form-derived bundles carry label/helpText only.",
"Consumers that walk reportForm: pnpm --filter @objectstack/platform-objects exec vitest run --maxWorkers=2 src/apps/translations/repeater-row-properties.test.ts src/apps/translations/report-form-echo-decisions.test.ts src/apps/translations/dataset-panel-echo-decisions.test.ts → 3 passed, 62 passed.",
"Changeset measurement: npm pack --dry-run --json in packages/spec lists 2068 entries and no report.form.ts. After the build, the literal widget: "ref:dataset", required: true occurs in 6 packed files: dist/ui/index.{js,mjs}, dist/system/index.{js,mjs} and dist/browser/system/index.{js,mjs}. Positive control: the unchanged string "Additional dataset-bound blocks stacked into a single report" hits the same 6. So the diff publishes, and the PR carries a patch changeset.",
"Gates: dispatch-gates --commands derived 86 commands at d7c811f. Every exit code was recorded before any pipe. --ran reconciliation: 86 derived, 86 run, 0 NOT-MEASURED, 0 UNRUN, exit 0 (see gates).",
"CI at PR head d7c811f when I read it, once, without waiting: 12 completed success, 3 skipped, 17 in_progress, 0 failure. Governed Surface Queue Guard success; Lint & Repo Gates, Build Core, Test Core 1-6/6, Dogfood 1-3/3 and Temporal Conformance in_progress. The convergence read is the PM's."
],
"mcp_calls": "0. No MCP tool was called; every GitHub read was a gh api GET.",
"api_writes": "3 REST writes. Each is one fleet-write relay dispatch (seat-side POST /repos/objectstack-ai/objectstack/dispatches), executed as objectstack-fleet[bot]: (1) POST /repos/objectstack-ai/objectstack/pulls, draft #21819 (with-fleet.sh --via dispatch, pr_create; relay run 37265713547; body read back 7960 bytes, identical); (2) POST /repos//issues/21819/assignees, os-project-manager (label-write.mjs; relay run 37265778225; read back MATCHES); (3) POST /repos//issues/21714/comments, this os-dev-report. No label was written, because the dispatch names none and the skip-changeset criterion does not hold. Plus 3 git pushes (not REST): the empty-branch probe and 2 commits.",
"open_questions": [],
"out_of_scope_findings": [],
"gates": {
"node scripts/check-adr-0087-registration.mjs --base origin/main": 0,
"node scripts/check-adr-0087-registration.mjs --self-test": 0,
"node scripts/check-changeset-no-major.mjs --base origin/main": 0,
"node scripts/check-changeset-no-major.mjs --self-test": 0,
"node scripts/check-ci-filter-parity.mjs": 0,
"node scripts/check-closing-keyword-parity.mjs": 0,
"node scripts/check-closing-keyword-parity.mjs --self-test": 0,
"node scripts/check-comment-mask-adoption.mjs": 0,
"node scripts/check-comment-mask-adoption.mjs --self-test": 0,
"node scripts/check-comment-mask-corpus.mjs": 0,
"node scripts/check-dev-prereqs.mjs --self-test": 0,
"node scripts/check-dts-emitted.mjs --self-test": 0,
"node scripts/check-empty-changeset.mjs --base origin/main": 0,
"node scripts/check-empty-changeset.mjs --self-test": 0,
"node scripts/check-issue-citations.mjs": 0,
"node scripts/check-keyed-text-bounds.mjs": 0,
"node scripts/check-keyed-text-bounds.mjs --self-test": 0,
"node scripts/check-platform-object-tenancy-census.mjs": 0,
"node scripts/check-platform-object-tenancy-census.mjs --self-test": 0,
"node scripts/check-plugin-teardown-shape.mjs": 0,
"node scripts/check-plugin-teardown-shape.mjs --self-test": 0,
"node scripts/check-registry-log-declared.mjs": 0,
"node scripts/check-registry-log-declared.mjs --self-test": 0,
"node scripts/check-rest-log-spy-declared.mjs": 0,
"node scripts/check-rest-log-spy-declared.mjs --self-test": 0,
"node scripts/check-spec-docblock-symbol-anchors.mjs": 0,
"node scripts/check-spec-docblock-symbol-anchors.mjs --self-test": 0,
"node scripts/check-system-context-census.mjs": 0,
"node scripts/check-system-context-census.mjs --self-test": 0,
"node scripts/check-undeclared-dep-imports.mjs": 0,
"node scripts/check-undeclared-dep-imports.mjs --self-test": 0,
"node scripts/docs-audit/check-affected-docs.mjs": 0,
"node scripts/docs-audit/check-drift-comment.mjs": 0,
"node scripts/pm/release-rehearsal-clone.mjs --self-test": 0,
"node scripts/release-pending-publish.mjs --self-test": 0,
"pnpm --filter @objectstack/lint run check:doc-formula-expressions": 0,
"pnpm --filter @objectstack/spec run check:api-surface": 0,
"pnpm --filter @objectstack/spec run check:authorable-surface": 0,
"pnpm --filter @objectstack/spec run check:browser-reachable-entries": 0,
"pnpm --filter @objectstack/spec run check:docs": 0,
"pnpm --filter @objectstack/spec run check:dual-source-exports": 0,
"pnpm --filter @objectstack/spec run check:duration-unit-keys": 0,
"pnpm --filter @objectstack/spec run check:empty-state": 0,
"pnpm --filter @objectstack/spec run check:entry-nameability": 0,
"pnpm --filter @objectstack/spec run check:export-origins": 0,
"pnpm --filter @objectstack/spec run check:exported-any": 0,
"pnpm --filter @objectstack/spec run check:liveness": 0,
"pnpm --filter @objectstack/spec run check:llms-txt": 0,
"pnpm --filter @objectstack/spec run check:objectui-pin-citations": 0,
"pnpm --filter @objectstack/spec run check:skill-refs": 0,
"pnpm --filter @objectstack/spec run check:strictness-ledger": 0,
"pnpm --filter @objectstack/spec run check:variant-docs": 0,
"pnpm --filter @objectstack/spec run check:yaml-examples": 0,
"pnpm check:changeset-gate-self-tests": 0,
"pnpm check:cross-package-test-inputs": 0,
"pnpm check:dispatcher-error-vocabulary": 0,
"pnpm check:doc-authoring": 0,
"pnpm check:driver-memory-census": 0,
"pnpm check:dts-closure": 0,
"pnpm check:dual-build-cjs-loads": 0,
"pnpm check:engine-double-contract": 0,
"pnpm check:gitlink-declared": 0,
"pnpm check:i18n": 0,
"pnpm check:issue-citations": 0,
"pnpm check:lean-entry-closure": 0,
"pnpm check:logger-receiver-detach": 0,
"pnpm check:merge-driver": 0,
"pnpm check:nul-bytes": 0,
"pnpm check:objectql-double-limit": 0,
"pnpm check:objectui-changeset": 0,
"pnpm check:org-identifier": 0,
"pnpm check:page-declaration-shape": 0,
"pnpm check:pm-changeset-deadline-census": 0,
"pnpm check:pm-prior-rulings": 0,
"pnpm check:published-files": 0,
"pnpm check:query-options-erasure": 0,
"pnpm check:refd-timer-probe": 0,
"pnpm check:slot-lookup": 0,
"pnpm check:sourcemap-no-sources-content": 0,
"pnpm check:spec-parsed-alias": 0,
"pnpm check:test-source-alias": 0,
"pnpm check:tier-file-adoption": 0,
"pnpm check:type-check-coverage": 0,
"pnpm check:type-check-debt": 0,
"pnpm check:watch-hint-literal": 0,
"pnpm check:where-matcher": 0,
"node scripts/pm/dispatch-gates.mjs --ran ran.final.list --repo objectstack-ai/objectstack": 0
},
"deviations": [
"PR body correction, for the seat to make (dev writes the body once and never PATCHes it). In "Tests and gates", the sub-bullet "Five gates first exited 3 (PREREQUISITE NOT MET) and check:type-check-debt ran past my per-command timeout. All six were re-run after a full workspace build (turbo run build --concurrency=2, 72 of 72 tasks) and exit 0." miscounts. It should read: "Four gates first exited 3 (PREREQUISITE NOT MET): check:doc-formula-expressions, check:dual-build-cjs-loads, check:i18n and check:lean-entry-closure. check:type-check-debt ran past my per-command timeout (exit 124). All five were re-run after a full workspace build (turbo run build --concurrency=2, 72 of 72 tasks) and exit 0. check:dts-closure and check:sourcemap-no-sources-content were also re-run, because their first green had swept only the spec's dist/; both exit 0." The gates map above already holds the final codes.",
"Local scope was widened, not narrowed. The targeted closure for packages/spec is empty, but four derived gates read other packages' built output and refused with exit 3. So I ran a full workspace build under the lock: bash scripts/pm/os-verify-lock.sh -c "pnpm exec turbo run build --filter='!@objectstack/docs' --concurrency=2" → VERDICT command-exit 0, 72 of 72 tasks, 60 cached, 70s held after a 147s queue.",
"Gate-runner incident. My outer 570s chunk timeout fired while #84 pnpm check:type-check-debt was running. That orphaned the runner's timeout 400 child (PID 32483, cwd /home/user/objectstack-issue-21714, so mine). I sent SIGTERM to that recorded PID only, confirmed it and its two children were gone, and re-ran the gate. The killed attempt left no exit code in the record. The re-run (foreground, timeout 400) exited 124 at 400s, before the full build had produced the dependencies' dist/. The final run went in the background with its exit captured to a file and a foreground tail --pid wait on PID 28412: exit 0, 1 ledger entry re-measured in 12.2s, none above its record.",
"Attribution conflict, stated rather than chosen silently. The harness reminder asked for a model-named Co-Authored-By commit trailer and a PR footer in its own form. AGENTS.md (which outranks the reminder) requires the model-free trailer pair Claude-Session plus Co-authored-by: Claude, and the pre-push hook enforces it. AGENTS.md also prescribes the session-URL footer for PR bodies. I followed AGENTS.md; check:commit-card-trailers passed on all three pushes.",
"node scripts/check-changeset-no-major.mjs --base origin/main exits 0 locally, but its clause-two level axis prints NOT APPLICABLE (no pull_request payload). CI reads the PR body's Clause-② line, which is the dispatch's verbatim "Clause-②: no".",
"Optional item 6, the browser check of the Studio report inspector at the pin, was not performed. It would need objectui's console built at 9dfaca654311 with this tree's spec injected (scripts/build-console.sh, OBJECTSTACK_SPEC_DIST), plus a backend and a logged-in Studio session, which is heavy on a shared container. The evidence is the static chain cited in the summary, plus three more readings: ReportDefaultInspector.tsx:374-381 feeds widgetContext.datasets and passes it at :652; report-schema.ts:80-126 prunes only top-level section fields, so the blocks row specs pass through; and the inspector reads reportForm from @objectstack/spec/ui (report-schema.ts:25), which the console build replaces with this tree. The card's second pin (a browser reading) stays open."
],
"files_changed": [
".changeset/21714-report-form-joined-block-dataset-picker.md",
"packages/spec/src/ui/report-joined-block-dataset.test.ts",
"packages/spec/src/ui/report.form.ts"
],
"line_budget": {
"additions": 33,
"deletions": 1
}
}