Repository navigation
plugin-kanban + types: align with the typed ComponentPropsMap['object-kanban'].grouping (objectstack#20831) once a release carries it — the strict face stops refusing grouping, and two descriptions stop calling it z.unknown() #11216
Description
Blocked-by: objectstack-ai/objectstack#20831
The objectui half of objectstack-ai/objectstack#20831, filed by the domain:spec execution seat 1 (objectstack-ai/objectstack#6017, session_018fxqvRJW12TaHC7DUQ89Y6) at that card's ACCEPT, as triage directed ("the objectui mirror is a follow-up card on objectui, Blocked-by: this one, once a release carries it", objectstack-ai/objectstack#20831 comment 5908917971). ⛔ Not a claim.
What changes upstream
PR objectstack-ai/objectstack#20856 types ComponentPropsMap['object-kanban'].grouping and ['object-grid'].grouping by reference to the spec's GroupingConfigSchema, which is the list view's own schema. A padded field name, a bare string, a non-object, fields: [] or an undeclared key inside the config is now refused. A well-formed { fields: [{ field, order?, collapsed? }] } parses byte-identically.
What objectui carries today (per the #20831 dev report and card, at objectstack's pin db11afd49; re-measure at claim)
- The strict face refuses
groupingonobject-kanbanby name (unrecognized_keys), which is narrower than the typed spec row. The card body records that objectui's two faces and the spec gave three answers for this key. After the release, the strict face should acceptgroupingin the spec'sGroupingConfigshape, and not in a copy of its shape. - Two descriptions call the spec row
z.unknown().optional():- the kanban registration description (
packages/plugin-kanban/src/index.tsx, ≈:684at the pin); - the header of the
structuredKeysAreDeclaredAndHonoured8313 test.
Both read stale once the release carries the typed row. That test's row-4 fixture,{ fields: [{ field: 'owner' }] }, stays valid.
- the kanban registration description (
- The renderer needs no change:
ObjectKanban.tsxreadsswimlaneField || grouping.fields[0].field, exactly the typed shape.
Unlock
The installable @objectstack/spec that objectui's lockfile resolves exports the typed row: ObjectKanbanPropsSchema.shape.grouping refuses { fields: [{ field: ' x ' }] }. A cross-repo unlock is the install face, not the upstream merge.
Dedupe: search_issues in objectstack-ai/objectui, "object-kanban grouping typed GroupingConfigSchema mirror strict face swimlane fallback": 37 hits. The nearest are #8652 (kanban navigation), #8990 (groupBy requiredness) and #7772 (inspector groupField); none carries this key's typing.
Activity
objectstack-fleet commentedon Sep 30, 2026
Triage:
pm:blocked→pm:on-hold. The objectstack half has landed, but it is not installable yetTriage seat (objectstack-wide, seat post objectstack-ai/objectstack#6015) ·
session_01AavokzJ5DndAwitDXvKy4U· 2026-09-30T14:58Z. ⛔ Not a claim, ⛔ not a dispatch.Measured. objectstack-ai/objectstack#20831 closed: PR objectstack-ai/objectstack#20856 merged as
f7501191e5. npm@objectstack/speclatestis still 17.5.0, without it. A cross-repo unlock means installable, so theBlocked-by:line alone no longer describes the wait. The card moves topm:on-holdwith the measurable condition below, so the unlock scan stops flagging a met-in-name block.Restart-when: npm
@objectstack/speclatestis above 17.5.0 and its published tarball typesComponentPropsMap['object-kanban'].groupingby reference toGroupingConfigSchema(objectstack PR #20856,f7501191e5); the objectui bump that installs it has mergedThe scope and grade are unchanged.
objectstack-fleet commentedon Oct 3, 2026
pm:on-hold→pm:queue: the restart condition holds ·domain:uiseat 1 ·session_01FjqrwXPfSMkSfkKYDSRkN2· 2026-10-03T17:32Z · standby unlock scan.5913870889: npm@objectstack/speclatestabove 17.5.0, its tarball typingComponentPropsMap['object-kanban'].groupingby reference toGroupingConfigSchema, and the objectui bump that installs it merged.latestis 17.6.0 (published 2026-10-02T03:03Z).main'spnpm-lock.yamlresolves@objectstack/spec@17.6.0.dist/ui/index.d.ts,'object-kanban''sgroupingis the same strict objectGroupingConfigSchemadeclares:fields[]offield,orderandcollapsed.5913870889. The one cross-reference since then, objectui#11355, is a closed issue.Generated by Claude Code
objectstack-fleet commentedon Oct 3, 2026
Claim: PM loop round 2
Session:
session_01FjqrwXPfSMkSfkKYDSRkN2Account:
os-zhuang(the seat's linked user asGET /useranswers it; the card's assignee)Branch:
claude/issue-11216-kanban-grouping-typedWorktree:
objectui-issue-11216Domain:
domain:uiSeat:
domain:ui#1File surface: the card body, read at objectui
origin/mainab18797as leads:packages/types/src/zod/objectql.zod.ts: theobject-kanbanarm declaresgroupingas the spec'sGroupingConfigSchemaby reference. That is the moveobject-gridalready makes (grouping: stripImportedDefaults(SpecGroupingConfigSchema).optional()). The "stays undeclared here: that is objectui#11216's" comment goes.packages/types/src/objectql.ts: the kanban TS twin, only if it lacksgrouping;packages/plugin-kanban/src/index.tsx: the description calling the spec rowz.unknown().optional();packages/plugin-kanban/src/__tests__/ObjectKanban.structuredMembersReachTheirSinks-8313.test.tsx(header);apps/console/src/__tests__/registry-inputs-spec-parity.test.tsonly if a booked difference moves; one changeset for each touched package.authoring-nodes.ts,zod/base.zod.ts,zod-mirror-parity.test.ts,packages/types/README.md, among its 88). Needing one is a breach.The dev stops on a breach and explains it in the report.
Container & model:
S,mode:subagent,model: opus(default judgment tier;dispatch-gates --tier --repo objectstack-ai/objectuiprinted "no path-derived mandate" forobjectql.zod.tsandplugin-kanban/src/index.tsx)Clause-②: yes
Why yes: the strict face stops refusing
groupingonobject-kanbanand judges it by the spec's schema. An accept set widens.Thread-read: 5971694440
Serial constraints cleared: read 2026-10-03T17:40Z.
public-blocks.zod.ts) and objectui#10380 (app-shell,plugin-list) are claimed in this act, with disjoint files.Generated by Claude Code
objectstack-fleet commentedon Oct 3, 2026
os-dev-report
{ "issue": 11216, "status": "done", "branch": "claude/issue-11216-kanban-grouping-typed", "pr": "https://github.com/objectstack-ai/objectui/pull/11568", "session": "session_01FjqrwXPfSMkSfkKYDSRkN2 (mode:subagent of the PM session)", "premise_still_valid": true, "summary": "object-kanban now declares grouping on both @object-ui/types faces as @objectstack/spec's GroupingConfigSchema, by reference. The zod mirror has grouping: stripImportedDefaults(SpecGroupingConfigSchema).optional(), spelled as ObjectGridSchema.grouping spells it. The TS twin has grouping?: GroupingConfig. The strict face now accepts { fields: [{ field: 'owner' }] }. Both runtime faces refuse a padded name, a bare string, fields: [] and an undeclared key, which are the spec row's refusals; the tolerant face used to keep all four unjudged. The renderer and the registration inputs are unchanged. Premise held: on ab18797 the strict face refused the well-formed config with unrecognized_keys at the node, and the 17.6.0 row is typed. One card detail was wrong: packages/plugin-kanban/src/index.tsx has no z.unknown wording (two unrelated 'unknown' code lines only; control swimlaneField found). The wording the card meant lives in the two 8313 test headers and in the console MEMBER_PINS entry object-kanban.grouping. All three now describe the typed row. The grouping census in grouping-field-padded-refused-7347 went red on the new declaring arm and gained an object-kanban row. Docs gained grouping rows: plugin-kanban.mdx, plus schema-reference.md, whose 'still undeclared' paragraph is corrected. Changeset: @object-ui/types minor.", "tests": "At HEAD cf8c860. RED FIRST on the base tree with only the new pin added: Tests 28 failed | 12 passed (40). The strict face gave unrecognized_keys at the node; the tolerant faces kept the refused shapes. That run used an earlier version of the pin's issue-flattening helper; the committed pin is measured by ablation 1. GREEN: object-kanban-grouping-typed-11216 40/40. vitest packages/types/: Test Files 348 passed, Tests 9366 passed. vitest packages/plugin-kanban/: 65 files, 442 tests passed. Console registry-inputs-spec-parity: 255 passed. Consumer radius (11 files in app-shell, plugin-view, plugin-list, schema-catalog, none edited): 176 passed. type-check @object-ui/types and @object-ui/plugin-kanban: exit 0, both script names echoed; tsc -p tsconfig.test.json --listFiles lists both edited types pins. Build pnpm --workspace-concurrency=2 --filter '@object-ui/plugin-kanban^...' build: exit 0. ABLATION 1 (zod member deleted via objectstack scripts/ablation-replace.mjs): anchor 1 to 0, blob 4abab7e182f1 to 78fdd976f360; the new pin plus the 7347 census gave Tests 47 failed | 116 passed (163); restored blob == HEAD 4abab7e182f1, git diff HEAD empty. ABLATION 2 (TS member deleted): tsc -p tsconfig.test.json exit 2, TS2344 at both type rows of the new pin, plus zod-mirror-parity.test.ts naming objectql.zod.ts#ObjectKanbanSchema / grouping; restored blob == HEAD 9d326515ade6, git diff HEAD empty. The first attempt at ablation 2 was refused by the tool and nothing landed (the replacement was a prefix of the anchor); it was re-run with a marker replacement. The subject resolves through relative imports to src/, so no dist leg.", "mcp_calls": "0", "api_writes": "2 REST writes, both through the fleet-write relay as objectstack-fleet[bot]. (1) pr_create: POST /repos/objectstack-ai/objectstack/dispatches, which ran POST /repos/objectstack-ai/objectui/pulls and opened draft #11568; the read-back found 8362 bytes sent and 8362 stored, identical. (2) This os-dev-report comment: post-stamped.mjs to POST /repos/objectstack-ai/objectui/issues/11216/comments. label-write --assign (POST /repos/objectstack-ai/objectui/issues/11568/assignees) was denied by the auto-mode classifier before it ran, so 0 requests were sent. Git, not REST: 2 pushes of claude/issue-11216-kanban-grouping-typed (the empty-branch probe, then cf8c860).", "gates": [ { "command": "pnpm exec vitest run packages/types/src/__tests__/object-kanban-grouping-typed-11216.test.ts", "exit": 0, "verdict": "Tests 40 passed (40)" }, { "command": "pnpm exec vitest run packages/types/", "exit": 0, "verdict": "Test Files 348 passed (348) / Tests 9366 passed (9366)" }, { "command": "pnpm exec vitest run packages/plugin-kanban/", "exit": 0, "verdict": "Test Files 65 passed (65) / Tests 442 passed (442)" }, { "command": "pnpm exec vitest run apps/console/src/__tests__/registry-inputs-spec-parity.test.ts", "exit": 0, "verdict": "Tests 255 passed (255)" }, { "command": "pnpm --filter @object-ui/types type-check && pnpm --filter @object-ui/plugin-kanban type-check", "exit": 0, "verdict": "os-verify-lock: VERDICT command-exit 0" }, { "command": "pnpm --workspace-concurrency=2 --filter '@object-ui/plugin-kanban^...' build", "exit": 0, "verdict": "os-verify-lock: VERDICT command-exit 0" }, { "command": "pnpm check:control-bytes", "exit": 0, "verdict": "check-control-bytes: OK" }, { "command": "pnpm check:new-line-citations", "exit": 0, "verdict": "VERDICT new-cross-file-line-citations: 0 new citation(s)" }, { "command": "pnpm check:changeset-claims", "exit": 0, "verdict": "Every package declared across those 1 body(ies) is either not negated" }, { "command": "pnpm check:pending-changeset-literals", "exit": 0, "verdict": "No test source names a pending changeset." }, { "command": "node scripts/check-changeset-presence.mjs", "exit": 0, "verdict": "this change declares 1 changeset(s)" }, { "command": "node scripts/check-changeset-no-major.mjs / check-changeset-overwrite.mjs", "exit": 0, "verdict": "No changeset declares a major bump / No pre-existing changeset was modified or deleted" }, { "command": "pnpm check:installed-pin-claims", "exit": 0, "verdict": "OK" }, { "command": "pnpm check:spec-symbols / doc-types / prompt-keys / doc-fences / doc-example-ids; node scripts/check-doc-links.mjs", "exit": 0, "verdict": "all exit 0" }, { "command": "pnpm check:component-surface-parity / designer-field-key-parity / handler-key-reads / element-data-source-declaration / test-path-roots / shell-escape-residue / vi-mock-specifiers", "exit": 0, "verdict": "all exit 0" }, { "command": "eslint --no-inline-config --format json (7 edited TS files)", "exit": 0, "verdict": "7 files, 0 errors, 50 no-explicit-any warnings, all on lines this diff does not touch" }, { "command": "pnpm lint (repo-wide), pnpm check (objectui check), full pnpm test", "exit": null, "verdict": "NOT MEASURED locally: left to CI, which owns the repo-wide run" } ], "files_changed": [ "packages/types/src/zod/objectql.zod.ts", "packages/types/src/objectql.ts", "packages/types/src/__tests__/object-kanban-grouping-typed-11216.test.ts (new)", "packages/types/src/__tests__/grouping-field-padded-refused-7347.test.ts", "packages/plugin-kanban/src/__tests__/structuredKeysAreDeclaredAndHonoured-8313.test.ts", "packages/plugin-kanban/src/__tests__/ObjectKanban.structuredMembersReachTheirSinks-8313.test.tsx", "apps/console/src/__tests__/registry-inputs-spec-parity.test.ts", "content/docs/plugins/plugin-kanban.mdx", "content/docs/api/schema-reference.md", ".changeset/11216-kanban-grouping-typed.md (new)" ], "deviations": [ "Card premise detail measured false: packages/plugin-kanban/src/index.tsx carries no z.unknown description, so it is unchanged. The stale wording sat in the two 8313 test headers and the console MEMBER_PINS entry object-kanban.grouping; all three were rewritten. The claim listed the console file as conditional surface; only its pins string changed, and no booked difference moved.", "grouping-field-padded-refused-7347.test.ts is outside the claim's named file list. Its census goes red on any new arm that declares grouping, so it gained an object-kanban DECLARING row: a test-only fixture row in the same gate family. It is not in PR objectui#11512's 88 files.", "PR assignee NOT written. node scripts/pm/label-write.mjs --repo objectstack-ai/objectui --issue 11568 --assign os-zhuang was denied by the Claude Code auto-mode classifier (reason: External System Writes) before anything ran. Not re-sent by another route. The seat should set the assignee.", "Commit trailers follow AGENTS.md's model-free pair (Claude-Session + Co-authored-by: Claude) rather than the harness reminder's model-named Co-Authored-By. The PR body footer uses the os-dev session-URL form. Reported, not a conflict." ], "line_budget": "n/a (no skills/** touched)", "open_questions": [], "out_of_scope_findings": [ "carrier: 承接者:无 · noted in the PR's Acceptance notes, not filed. ObjectKanban.filterMembersReachTheWire-8176.test.tsx (header) and the console MEMBER_PINS entry object-kanban.filter still call filter's spec row z.unknown(). On the installed 17.6.0 row, filter is an array of closed { field, operator, value } objects, and sort is absent from the object-kanban row. This is stale prose in tests, not class a/b/c. Dedupe words: object-kanban filter spec row z.unknown stale header 8176.", "carrier: 承接者:无 · noted, not filed. The pending .changeset/11355-small-p1-sites.md says grouping is still undeclared. It is a dated record, and check-changeset-overwrite refuses edits to it. It publishes in the same release as this change's changeset." ] }Generated by Claude Code
objectstack-fleet commentedon Oct 3, 2026
Seat review of PR objectui#11568 at head
cf8c86054(dev report5971991209): content ACCEPT;Clause-②: yes, so the at-tier contract review is owed before readydomain:uiseat 1 ·session_01FjqrwXPfSMkSfkKYDSRkN2· 2026-10-03T18:09Z. Reviewed against GitHub, not the report.main. The first line isFixes #11216, with no other closing keyword.Clause-②: yesis at line start. 10 files, +264 / −21, no governed path (check-governed-merges: NOT governed).ObjectKanbanSchema(zod/objectql.zod.ts) gainsgrouping: stripImportedDefaults(SpecGroupingConfigSchema).optional(). That is the spellingObjectGridSchema.groupinguses, by reference.objectql.ts) gainsgrouping?: GroupingConfig, the typeObjectGridSchemaalready uses.plugin-kanban/src/index.tsxcarries noz.unknownwording.MEMBER_PINSentryobject-kanban.grouping. All three are rewritten. That entry's text is the only change inregistry-inputs-spec-parity.test.ts, and no booked count moves.5971759511amended here:packages/types/src/__tests__/grouping-field-padded-refused-7347.test.tsjoins the surface. Its census goes red on any arm that newly declaresgrouping, so it gains anobject-kanbanrow.content/docs/plugins/plugin-kanban.mdxandcontent/docs/api/schema-reference.mdjoin as docs-driven rows; the second one's "groupingis still undeclared" paragraph is corrected.@object-ui/typesminor. Its table matches the diff: the strict face now accepts a well-formed config, and both faces refuse the four shapes the spec row refuses. The tolerant face used to keep them unjudged.minorfollows this repo's practice for a spec-aligned refusal on a new member.zod-mirror-parityhit.carrier:):object-kanban.filterpins entry still callfilter's rowz.unknown(). That is stale test prose ⇒ Acceptance notes..changeset/11355-small-p1-sites.mdsaysgroupingis undeclared. The overwrite gate protects it ⇒ Acceptance notes.needs:contract-reviewis hung on the PR, and an isolated at-tier review runs before ready.Generated by Claude Code
objectstack-fleet commentedon Oct 3, 2026
Landed and verified by content: closed
completedby PR objectui#11568 ·domain:uiseat 1 ·session_01FjqrwXPfSMkSfkKYDSRkN2· 2026-10-03T18:58Z.The merge: PR objectui#11568 went through the merge queue to
mainasa7557a7at 2026-10-03T18:57Z, after an at-tier contract review PASS (5972130497) and the escalated changeset note (5972268383).Content check on
maina7557a7against its first parentab18797:mainzod/objectql.zod.ts: the kanbangrouping: stripImportedDefaults(SpecGroupingConfigSchema).optional()memberzod/objectql.zod.ts: "stays undeclared here: that is objectui#11216's"objectql.ts:grouping?: GroupingConfig;(grid twin and others, plus kanban).changeset/11355-small-p1-sites.md: the dated "is now declared — objectui#11216" noteThe changeset
11216-kanban-grouping-typed.mdis in the tree.No other card closed in that window.
pm:dispatchedis removed in the same act.domain:ui, the priority and the type stay.Generated by Claude Code
Merge main (0a53c67) into claude/issue-11466-node-slot-union-v1 (obje…
feat(types): object-kanban declares grouping as the spec's GroupingCo…