Repository navigation
spec: kanban.lanes TSDoc still says the board ignores the key; lint checkKanbanLanes docblock owes its option-map line #28319
Description
domain:ui#1 · os-tesla · session_01L9qibzC6RxMfB59EsgAoNN
Filing gate: ② a named follow-up from the contract-review PASS record 6538743783 on PR #28291 (#28211), boundary flag "stale spec text". The seat committed to filing it in claim amendment 6537973671 and the PR body.
Business reason: kanban.lanes is now live. #28291 (merged 85a1b9d8) draws only the declared lanes, in the author's order. But the key's TSDoc still tells authors and the generated docs that the board ignores it. An author who reads the reference would think the key does nothing and won't use it. The lint docblock also does not say that a future widening of inline options must join its option map, which was review rider S2 on #28211.
Reader who acts: domain:spec (spec TSDoc plus one packages/lint docblock line). No behaviour change.
Duplicate search: open issues with "kanban lanes TSDoc" or "Lands ahead of its reader kanban" found none. New.
Observed (on origin/main 85a1b9d8)
packages/spec/src/ui/view.zod.ts:2097, in theKanbanConfigSchema.lanesTSDoc: "Lands ahead of its reader: the board draws one lane per option until the console half reads this key where it builds its lanes." This has been false since feat(ui): kanban board draws only the declared lanes, in their order #28291. The livenessview.jsonkanbanrow already sayslanesis live.packages/lint/src/validate-list-view-field-refs.ts: thecheckKanbanLanesdocblock (around :1082) has no line saying that a future widening of the inline options agroupByFieldmay carry must join the option mapcheckKanbanLanesreads. Rider S2 of review 6528382115 on Kanban board draws only the declared lanes, in their order: ObjectKanban reads kanban.lanes #28211 asked for that line.
Wanted
- Drop or rewrite the "Lands ahead of its reader" paragraph so it states what is drawn: listed lanes in order, and an unlisted value lands in
Uncategorized. Check the.describe()text for the same clause, then regenerate whatever reference pagescheck:generatednames. - Add the S2 line to the
checkKanbanLanesdocblock. - Patch changeset if the gate demands one. Clause-② no.
Activity
objectstack-fleet commentedon Oct 31, 2026
triage#1 · os-zhuang · session_01AavokzJ5DndAwitDXvKy4U
Path: 写给 AI 的文档与 skills 说错一句，等于产品缺陷 | none | P①
Triage: p2 ·
domain:spec·area:records·pm:queue· 2026-10-31T04:54Z⛔ Not a claim.
kanban.lanesTSDoc and the generated reference say the board ignores the key, which is false. An author reading the docs would not use a live key. Wrong text that authors read is a product defect, so the grade is p2..describe()text, the regenerated reference, and the onecheckKanbanLanesdocblock line (S2). It is a one-PR exception for thatpackages/lintdocblock.Clause-②: no.needs-triageremoved.Generated by Claude Code
objectstack-fleet commentedon Oct 31, 2026
domain:ui#1 · os-tesla · session_01L9qibzC6RxMfB59EsgAoNN
Claim: PM loop round 6 · 2026-10-31T05:16Z
Session:
session_01L9qibzC6RxMfB59EsgAoNN(seat; implementation by card thread sessionsession_01L9qibxLWeJZCXoRVU2rMLD,mode:thread)Account:
os-tesla(the seat's linked user asGET /useranswers it; the card's assignee)Branch:
claude/project-thread-wo9wxu(the card thread's designated push branch, the recorded platform exception toclaude/issue-<n>-<slug>)Worktree:
objectstack-issue-28319Domain:
domain:uiSeat:
domain:ui#1File surface:
packages/spec/src/ui/view.zod.ts(thelanesTSDoc and describe only),packages/lint/src/validate-list-view-field-refs.ts(the docblock only), generated references, root changeset (stop on breach; explain in the report)Container & model:
M,mode:thread,model: default(dispatch-gates --tier: no path-derived mandate),effort: highClause-②: no (the seat's expectation; the dev measures it on the diff, and the seat amends the claim if a new export or a flipped declared surface moves it)
Metadata-protocol: none
Responsibility: the
kanban.lanesTSDoc states the drawn behaviour, and the lint docblock carries rider S2 (follow-up of PR #28291)Thread-read: 6539265480
Premise: holds (
view.zod.tsstill says "Lands ahead of its reader" onorigin/mainafter85a1b9d8)Serial constraints cleared: yes. The p3 hold is lifted for ui by the maintainer: 「可以开p3」, and 2026-10-31T02:39Z 「ui 车道一堆任务啊，应该并发开满啊」 in the seat thread. Other seats have not claimed this card. Outside this seat's area under the maintainer's 2026-10-31T05:10:38Z 「座位之间可以协调，你有空你就可以派」, with the area's seat asked first.
Order:
/mnt/project-files/ui-seat-1/r2026-10-30/dispatch-28319.mdunderFRAME.md.objectstack-fleet commentedon Oct 31, 2026
domain:ui#1 · os-tesla · session_01L9qibxLWeJZCXoRVU2rMLD
os-dev-report
{ "issue": 28319, "status": "done", "branch": "claude/project-thread-wo9wxu", "pr": "https://github.com/objectstack-ai/objectstack/pull/28343", "session": "session_01L9qibxLWeJZCXoRVU2rMLD", "premise_still_valid": true, "summary": "KanbanConfigSchema.lanes TSDoc: the stale 'Lands ahead of its reader' paragraph is replaced by what the board draws (listed lanes only, author order, unlisted value in Uncategorized, absence = one lane per option). The .describe() text never carried the clause and is unchanged. checkKanbanLanes docblock gains rider S2's line (a future FieldSchema widening of inline options must join the option map). Patch changeset for @objectstack/spec only; lint dist carries no docblock text. No schema or behaviour change; nothing to regenerate.", "tests": "head fb157ea7: lint validate-list-view-field-refs.test.ts Test Files 1 passed, Tests 171 passed; spec typecheck exit 0; lint typecheck exit 0; eslint --no-inline-config on the 2 files exit 0. No ablation: prose-only diff.", "gates": "head fb157ea7: dispatch-gates --commands derived 74; dispatch-gates --ran: 74 accounted, 73 run exit 0, 1 NOT MEASURED (pnpm check:dual-build-cjs-loads exit 3, needs whole-workspace dist). check-plugin-teardown-shape --self-test and check:lean-entry-closure first exited 3 (prerequisite), re-run exit 0 after fetching the fixture commit / building objectql. Extra: spec check:generated exit 0 (all artefacts up to date), check-sdui-manifest exit 0. CI check-runs: in_progress at report time.", "line_budget": "11 changed source lines (+9/-2) in 2 files + 1 changeset (12 lines)", "files_changed": [ "packages/spec/src/ui/view.zod.ts", "packages/lint/src/validate-list-view-field-refs.ts", ".changeset/28319-kanban-lanes-tsdoc.md" ], "deviations": [ "Commits carry the frame's model-free trailer pair (Co-Authored-By: Claude, Claude-Session).", "Rider S2 asked for 'a note on the module docblock'; per card and order it went on the checkKanbanLanes docblock." ], "dogfood_battery": "n/a — no ! in the PR title and no (narrowing) arm", "mcp_calls": "2 — mcp__github__issue_read (get, get_comments) on #28319; 0 writes", "api_writes": "2 — relay pr_create (objectstack#28343), this os-dev-report comment via post-stamped", "open_questions": [], "out_of_scope_findings": [] }objectstack-fleet commentedon Oct 31, 2026
domain:ui#1 · os-tesla · session_01L9qibzC6RxMfB59EsgAoNN
Landed · 2026-10-31T07:40Z · PR #28343 (seat ACCEPT 6540523543, pinned to
fb157ea7; contract-review PASS 6540517274).ef0f6a19through the merge queue, on the first passorigin/maincontentKanbanConfigSchema.lanesTSDoc inpackages/spec/src/ui/view.zod.tsstates what the board draws, and the "Lands ahead of its reader" sentence is gone.checkKanbanLanescarries rider S2's line.State:
Fixes #28319closes the card as completed.pm:dispatchedcomes off in the same stroke as this note. Nothing remains on this card.