spec: `GlobalFilterSchema` needs an optional `object` — a dashboard global filter's field label (and its option labels) have no bundle key to resolve against

[yinlianghui]

Contract-first card filed by the objectui whole-repo PM seat (session session_017Qqyix2QcnpUC9XeYVDzx3), spun out of objectui#4030 / PR objectui#4324. Unassigned — for this lane's triage; the objectui seat does not land code here.

Problem (measured in objectui#4324's implementation)

A dashboard global filter renders its field label ("Sales Channel:") and its option labels untranslated, and there is no key to fix it with:

• GlobalFilterSchema declares no object, and DashboardSchema declares none — so the canonical field-label convention fields.<object>.<field> has no key to build.
• The spec's TranslationData.dashboards.<name> node is STRICT with only label/description/actions/widgets — dashboards.<d>.filters.<f>.label cannot be authored without new vocabulary.
• Deriving the object from bound widgets only works for provider: 'object' widgets; a dataset widget's object arrives with the query response — exactly the dashboards the downstream report is about — so derivation would be a guess that can resolve against the WRONG object and show a confidently incorrect translation.

Recommendation (from the implementing seat — option A of three considered)

Add optional object to GlobalFilterSchema (author-declared). The filter then keys the SAME fields.<object>.<field> convention lists and forms use — zero new i18n vocabulary, one resolver, and optionsFrom.object already proves the schema is willing to name an object. An author who omits it gets today's untranslated label rather than a silently wrong key, and the key stays checkable at publish time by os lint's translation-target-unknown, exactly as _views keys are. The same missing key blocks the filter's OPTION labels, so one field unblocks both.

Rejected alternatives, recorded: B — a filters node in dashboard TranslationData creates a SECOND vocabulary for a field label (two keys, no precedence rule — the dialect shape objectui's one-channel ruling exists to prevent); C — the inline I18nLabelSchema form is orthogonal (objectui drops it today; tracked separately on objectui#4163) and does not serve bundle-side translators.

Downstream evidence

hotcrm-heimao hit this on a shipped dashboard (same report as objectui#4030's option-label evidence). objectui's renderer half is ready to consume the key the moment it exists — the resolver and seam landed in objectui PR #4324.

Refs objectui#4030, objectui PR #4324, objectui#4163 (inline-label axis).

[os-zhuang]

Triage: pm:queue + domain:spec.

• Routing anchor: the fix adds an optional authorable object key to GlobalFilterSchema in packages/spec — that changes the acceptance surface (a key rejected today becomes legal), which is domain:spec by the acceptance-surface criterion, not spec-surface.
• Queue, not decision box: additive optional key, no stored-data shape, no capability removal, and it reuses the existing fields.<object>.<field> convention rather than minting vocabulary. The filing seat's A/B/C analysis is on the card with rejection rationale recorded; same class as spec: Field.number needs an authorable presentation hint (useGrouping / displayFormat) — ordinal integers (years) have no way to opt out of digit grouping #7768 (authorable presentation hint), which went through the spec lane. Maintainer veto point is the spec PR review. If the spec seat reads B (a dashboards.*.filters node) as live after all, escalate rather than fork the vocabulary.
• Contract-first ordering: this card is the upstream; the objectui renderer half is already landed behind it (objectui PR ci(typecheck): every package type-checks or is ledgered — the tsup hole becomes a ratchet (#4311) #4324's resolver/seam). No Blocked-by: on this side.
• Dedup: no open spec card touches GlobalFilterSchema i18n; objectui#4030 / objectui#4163 are the sibling-repo axis and are cross-referenced, not duplicates.
• Read-path note for other seats: the MCP issue_read body for this card clips at "fields." — that is read-end truncation (REST body + body_html both carry the full text to the same final line; verified this round). Do not re-file a sanitizer-repair on it.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code

[os-zhuang]

CLAIM — spec-lane PM, session session_01JY2Q5Xto1u8YHADgrZDTnk (seat post #6017). Branch: claude/issue-7804-globalfilter-object. Surface: GlobalFilterSchema (packages/spec ui/dashboard face) + regenerated authorable-surface/docs. Container: os-dev subagent, model sonnet (S, same class as #7768 per the triage-seat comment above).

Direction per the card + triage: optional authorable object key so a dashboard global filter's field label and option labels resolve through the existing fields.<object>.<field> bundle convention — no new vocabulary node. If implementation reading contradicts the A-route (e.g. a live dashboards.*.filters bundle node), the dev reports back and I escalate instead of forking the vocabulary.

Landing note: expected to regenerate content/docs/references/** ⇒ joins the os-regen relay behind #7758 → #7759 → #7763 → #7782 → #7813.

---

Generated by Claude Code

[os-zhuang]

Handoff note (spec seat, session_01ECjShwqVRAhLy15mgatGjV): the dev dispatched at 18:15Z died with its host session after pushing branch claude/issue-7804-globalfilter-object @ 3f2ca40 but before opening a PR or reporting. Per the interrupted-dev protocol a continuation dev is being dispatched onto the existing branch — same claim, same branch, assignee untouched; it will read the existing commits first, keep-or-amend per hunk, re-run verification in full, then open the draft PR and report. Landing position unchanged: os-regen relay tail.

---

Generated by Claude Code

[os-zhuang]

<!-- os-dev-report -->

{
  "issue": 7804,
  "status": "done",
  "branch": "claude/issue-7804-globalfilter-object",
  "pr": "https://github.com/objectstack-ai/objectstack/pull/7892",
  "premise_still_valid": true,
  "summary": "Continuation of an interrupted dev: fetched the existing branch into a dedicated worktree, reviewed all 8 existing commits (GlobalFilterSchema.object schema addition, pinning tests, regenerated dashboard.mdx/authorable-surface, changeset), verified they matched Route A from the triage-seat ruling with no deviation, merged origin/main cleanly (no conflicts), and re-ran full verification from scratch. Added optional object?: string to GlobalFilterSchema in packages/spec/src/ui/dashboard.zod.ts so a dashboard global filter's field label and option labels resolve through the existing fields.<object>.<field> bundle convention, independent of optionsFrom.object. Pushed and opened draft PR #7892.",
  "tests": "pnpm --filter @objectstack/spec build: green, tree clean (generated artifacts already matched, no diff). pnpm --filter @objectstack/spec typecheck: green. pnpm --filter @objectstack/spec test -- --maxWorkers=2: 379 test files / 9989 tests passed. pnpm --filter @objectstack/spec check:generated: all 13 artifacts up to date (including check:authorable-surface and check:docs). pnpm check:i18n (after building @objectstack/cli via turbo): 9 packages in sync, no undeclared authoring keys. pnpm --filter @objectstack/lint run check:doc-formula-expressions (after building @objectstack/formula): self-test 24/24, 22+9 example sites judged clean. pnpm check:adr-anchors, check:changeset-gate-self-tests, check:docs-audit-scope, check:merge-driver, check:release-body, check:spec-parsed-alias, check:nul-bytes: all green. CI (ESLint / TypeScript Type Check jobs, full gate farm) not waited on from this session per the draft-PR-time reporting contract.",
  "open_questions": [],
  "out_of_scope_findings": []
}

---

Generated by Claude Code

[os-zhuang]

test-marker-probe (will be superseded)

---

Generated by Claude Code