list empty states contradict the page: "not added by hand here" beside an Invite / Register button, and "match your current filters" when only the view's own filter applies

[objectstack-fleet]

Path: ② the capabilities an end user meets in the app — list views | 缺项 | P2

Split by the triage seat (objectstack-wide, seat post objectstack-ai/objectstack#6015) · session_01AavokzJ5DndAwitDXvKy4U from objectui#11672 (the 2026-10-06 console dogfood sweep, showcase, framework ce577ec4), item 15 (empty-state copy). Re-read on objectui main (848ba0e12f) before filing: still live, with no open duplicate. ⛔ Not a claim, ⛔ not a dispatch.

Triage: lands in packages/app-shell/src/utils/managedByEmptyState.ts (about :108–:115) and packages/plugin-list/src/ListView.tsx (about :5203–:5225) ⇒ domain:ui; rationale: the empty-state copy ignores the page's own create action and confuses a view filter with a user filter.

What happens

Invitations, API Keys and OAuth Applications say "These records are created by the authentication provider … not added by hand here" beside an "Invite User" or "Register OAuth Application" button. Webhooks (the Active view, zero rows) says "No records match your current filters or search." when no filter or search is applied.

Done when

• The managed-by copy is not used on an object whose page offers a create action.
• "Your filters" appears only when the user has applied a filter or search. A view's own filter gets its own wording.
• Pins: the four measured pages.

---

Generated by Claude Code

[objectstack-fleet]

Claim: PM loop round 1
Session: session_01DrKzdPdyLLBW3qpZ4vtk7z
Account: huangyiirene
Branch: claude/issue-11687-empty-state-copy-matches-page
Worktree: objectui-issue-11687
Domain: domain:ui
Seat: domain:ui#1
File surface: packages/app-shell/src/utils/managedByEmptyState.ts (the better-auth arm, about :72–:118) and its caller(s) that pass the page's actions; packages/plugin-list/src/ListView.tsx (the empty-state title/message choice, hasBaseFilter / hasActiveQuery, about :5195–:5226, and its fallback strings about :831); packages/i18n/src/locales/*.ts for the new view-filter wording only; the tests beside them; and .changeset/11687-*.md (stop on breach; explain in the report)
Container & model: M, mode:subagent, model: opus (dispatch-gates --tier --repo objectstack-ai/objectui: no path-derived mandate; default tier). The delivered PR owes an isolated review at CONTRACT_REVIEW_TIER before enqueue (reason: Clause-②: yes, below).
Clause-②: yes
Thread-read: none
Serial constraints cleared: none blocking. No open objectui PR touches these files (objectui#11718, #11069 and the release PR objectui#11600 were read); seat 2's in-flight objectui#11680, #11682 and #11684 are on components, core and plugin-detail files. packages/i18n/src/locales/*.ts is shared with other queued cards that may add keys; those paths are not single-claim in objectui, so this is ordinary concurrency and the later lander merges. Read 2026-10-06T13:51Z.

Why Clause-②: yes: a view's own filter gets its own wording, which adds at least one key to @object-ui/i18n's locale packs; the packs and their derived key type are exported, so every key is published surface. A yes claim is at least a minor changeset for the package whose surface grows (AGENTS.md Post-Task Checklist item 3). If resolveManagedByEmptyState's signature changes, the dev reads whether @object-ui/app-shell's built entry reaches it and reports the arm.

[objectstack-fleet]

os-dev-report
{
"issue": 11687,
"status": "done",
"branch": "claude/issue-11687-empty-state-copy-matches-page",
"pr": "#11727",
"session": "session_01DrKzdPdyLLBW3qpZ4vtk7z — mode:subagent, so this is the parent seat's harness-stamped id (the Claude-Session line on every commit of the branch)",
"premise_still_valid": true,
"summary": "The better-auth empty state now gives way to the list's own copy when the page offers a create action: its New button, or a list_toolbar action the toolbar draws. The new listToolbarDrawsAction decides this with the same placement, capability and fail-closed visible gates that action:bar and action:button apply (managedByEmptyState.ts, computed in ObjectView). ListView now chooses its empty-state message three ways: user search or filter keeps list.noMatchesMessage; the view's own filter alone gets the new list.viewFilterNoMatchesMessage ('No records match this view’s filter.', added to all ten packs and LIST_DEFAULT_TRANSLATIONS); neither gets first-run copy. PM hypotheses: H1, H2 and H3 measured true. H2 decided the predicate: Invite User and Register OAuth Application are list_toolbar object actions with lowered visible gates, not the CRUD create affordance, and only create_oauth_application declares mode:'create'. H4 is partly falsified: the API Keys page offers no create action (sys_api_key declares no list_toolbar action and leaves create off, at ce577ec4 and at objectstack aa09db58), so its pin is the negative case and its identity copy stays.",
"tests": {
"head": "0ef8b17 (git rev-parse --short HEAD in the worktree when the gate union ran; the branch tip pushed to origin is the same commit)",
"gates": [
"pnpm --workspace-concurrency=2 --filter '@object-ui/app-shell^...' --filter '@object-ui/plugin-list^...' --filter '@object-ui/i18n^...' build → 0 → 'os-verify-lock: VERDICT command-exit 0' (Scope: 29 of 47 workspace projects)",
"pnpm --filter @object-ui/i18n type-check → 0 (script echoed: tsc --noEmit && tsc -p tsconfig.test.json)",
"pnpm --filter @object-ui/plugin-list type-check → 0 (same echo; tsconfig.test.json includes src/**/.test.ts(x))",
"pnpm --filter @object-ui/app-shell type-check → 0 (same echo)",
"pnpm --filter @object-ui/i18n test → 0 → 'Test Files 80 passed (80) · Tests 1304 passed | 13 skipped (1317)'",
"pnpm --filter @object-ui/plugin-list test → 0 → 'Test Files 113 passed (113) · Tests 1224 passed (1224)'",
"pnpm --filter @object-ui/app-shell test → 0 → 'Test Files 1032 passed | 1 skipped (1033) · Tests 10181 passed | 9 skipped (10190)' · 'os-verify-lock: VERDICT command-exit 0'",
"pnpm exec vitest run on the 3 touched suites (managedByEmptyState.test.ts, ListView.emptyStateFilteredCopy.test.tsx, ObjectView.emptyStateMatchesPage-11687.test.tsx) → 0 → 'Test Files 3 passed (3) · Tests 33 passed (33)'",
"pnpm check:control-bytes → 0 → '✅ check-control-bytes: OK (scanned 7664 tracked text file(s); skipped 85 binary).'",
"pnpm check:new-line-citations → 0 → 'VERDICT new-cross-file-line-citations: 0 new citation(s), enforcement report-only -> exit 0'",
"pnpm check:changeset-claims → 0 → '✅ No pending changeset names a file this change touches.'",
"pnpm check:pending-changeset-literals → 0 → '✅ No test source names a pending changeset.'",
"pnpm check:i18n-keys → 0 → 'Every in-scope call-site key resolves against the en pack (3274 keys) …'",
"pnpm check:i18n-drift → 0 → '… 0 en value(s) changed (1 key(s) added, 0 removed …)' / 'No en value changed in this range.'",
"pnpm check:i18n-dead-keys → 0 → report only; list.viewFilterNoMatchesMessage is not among its candidates (grep count 0)",
"added by re-derivation from objectui's root package.json (dispatch-gates.mjs derives nothing for objectui): check:vi-mock-specifiers → 0, check:vi-mock-inherit → 0, check:vi-mock-override-shape → 0, check:test-path-roots → 0, check:unreferenced-sources → 0, and scripts check-changeset-presence / -no-major / -fixed / -overwrite → 0 each ('✅ 16 source file(s) of 3 released package(s) changed, and this change declares 1 changeset(s)')",
"pnpm check:eager-locale-catalogues → 2 → 'PREREQUISITE NOT MET: apps/console/dist/eager-closure.json is missing' ⇒ NOT MEASURED (needs a console build; left to CI)",
"ESLint narrowed to the 16 changed .ts/.tsx files → 0 → 0 errors / 366 pre-existing warnings, none on an added line. Evidence for the narrowing: (1) population = the changed files, run under the repo's own eslint.config.js; (2) --format json reported 16 files; (3) the config sets no parserOptions.project / projectService, so linting is not type-aware and this diff cannot change the verdict on any untouched file. The repo-wide pnpm lint belongs to CI",
"reverse verification (ablation, one-off, directions predicted beforehand; each leg changed the committed fix through objectstack scripts/ablation-replace.mjs — anchor x1→x0, blob changed — and was restored with 'blob == HEAD and git diff HEAD is empty'; tests resolve @object-ui/ to src through the root vitest.config.mts alias, so no dist and no rebuild were involved): A remove the pageOffersCreate check → 4 failed / 29 passed (2 resolver units, Invitations and OAuth pins red; single-org control, API Keys and Webhooks green); B restore the two-way hasActiveQuery message choice → 3 failed / 30 passed (ListView view-filter case, Invitations, Webhooks red); C stop reading visible in listToolbarDrawsAction → 3 failed / 23 passed (2 gate units and the single-org control red)",
"CI at report time (one read, no polling): 42 check runs on 0ef8b17 — 21 completed/success, 3 completed/skipped, 18 in_progress"
],
"deviations": [
"Lock queue-timeouts: exit 99 twice for the closure build while the sibling objectui-issue-11685 run held the lock with its full app-shell suite for about 28 minutes (holder alive and busy at about 200% CPU). Both were read as NOT MEASURED and re-queued under the kept slot issue-11687-dev; the third attempt acquired the lock.",
"check:eager-locale-catalogues NOT MEASURED: its prerequisite, a console build, was not met (see gates).",
"ESLint was run narrowed, not repo-wide; it is declared in the gates entry with its three pieces of evidence.",
"Corrected test assumption, committed as 5eea794: a unit assertion assumed an absent default-on flag fails open, as the spec's featureGatePredicate doc says. Measured: objectui's evaluator throws and the fail-closed visible hides, matching the button. The assertion was removed and the mismatch is noted in out_of_scope_findings.",
"A throwaway probe test (zz-probe-11687.test.ts) briefly lived in the worktree to measure that CEL verdict. It was deleted before the next commit and never committed; git status was clean afterwards.",
"Attribution conflict: the harness reminder asked for a model-bearing Co-Authored-By trailer and a different PR footer. I followed objectui AGENTS.md (model-free trailer pair: Claude-Session plus Co-authored-by: Claude) and the os-dev session-URL footer.",
"No docs change: no page under content/docs and none of the three package READMEs describes how the list chooses its empty state, and the claim's file surface lists no docs."
],
"files_changed": [
".changeset/11687-empty-state-copy-matches-page.md",
"packages/app-shell/src/utils/managedByEmptyState.ts",
"packages/app-shell/src/utils/tests/managedByEmptyState.test.ts",
"packages/app-shell/src/views/ObjectView.tsx",
"packages/app-shell/src/views/ObjectView.emptyStateMatchesPage-11687.test.tsx",
"packages/plugin-list/src/ListView.tsx",
"packages/plugin-list/src/tests/ListView.emptyStateFilteredCopy.test.tsx",
"packages/i18n/src/locales/{ar,de,en,es,fr,ja,ko,pt,ru,zh}.ts"
]
},
"mcp_calls": "0",
"api_writes": "4 — (1) git push of claude/issue-11687-empty-state-copy-matches-page (probe push of the empty branch plus later pushes of the same branch; counted once); (2) POST /repos/objectstack-ai/objectui/pulls, draft, which created #11727 through scripts/pm/fleet-write/dispatch.mjs (relay run 37488048569; read-back: 9532 bytes sent, 9532 stored, identical); (3) PR #11727 assignee huangyiirene through scripts/pm/label-write.mjs --assign (relay run 37488145891; read-back matches); (4) POST /repos//issues/11687/comments, this os-dev-report, through scripts/pm/post-stamped.mjs. Each relayed write was carried by one POST /repos/objectstack-ai/objectstack/dispatches as transport. Zero label writes.",
"open_questions": [
{
"question": "Not blocking; the predicate is shipped. What should count as 'the page offers a create action'? Shipped: any list_toolbar action the toolbar actually draws, plus the New button.",
"options": [
"A (shipped): toolbar draws an action, judged by placement, the capability gate and visible. It needs no producer change. Read off objectstack's better-auth objects, every list_toolbar action there either adds a row or sits on a list whose every view is filtered. That reading is marked as dated in the code comment.",
"B: only actions that declare mode:'create'. This needs an objectstack platform-objects change to declare it on invite_user (sys_invitation, sys_user, sys_member), add_member, add_team_member, create_team, create_user, create_organization and enable_two_factor; today only create_oauth_application and the two SSO register actions declare it. It also makes the 'pure metadata' mode hint drive which copy is shown.",
"C: the CRUD create affordance only (H1's mirror of the engine-owned arm). This misses all three measured pages."
],
"recommendation": "A. It fixes the measured pages with no cross-repo producer change. It follows the toolbar's own verdict per deployment and caller, as the single-org control shows, and it adds no new metadata semantics. Revisit with B only if a better-auth object gains a toolbar action that adds no row."
}
],
"out_of_scope_findings": [
"class: a (candidate) · reach: NOT MEASURED at a public door (source reading only, so not fileable under the reach rule) · evidence: ListView reads schema.emptyState before its own query-aware choice, and ObjectView passes the managed-by copy as emptyState. On a better-auth list whose page offers no create action (API Keys, single-org Invitations), a search that matches nothing therefore shows 'No identity records' instead of 'No matching records'. The objectui#4155 case "the author's own emptyState copy still wins over both" holds that order · dedupe words: managed-by empty state overrides search; identity copy on filtered list; emptyState precedence over user query · carrier: 承接者:无 · noted, not filed",
"class: b (candidate) · reach: NOT MEASURED at a public door; measured in-process only: ExpressionEvaluator throws on features.organization != false against features {}, and the fail-closed visible hides the action · Seam: spec:featureGatePredicate → renderer:action-button useCondition(throwOnError) · contract text: 'default-on → features.X != false (so an absent flag — e.g. config not yet fetched — fails open)' · dedupe words: default-on feature flag absent hides action; requiresFeature lowered visible missing key; features payload absent flag fail-open · carrier: 承接者:无 · noted, not filed",
"carrier: 承接者:无 · noted, not filed — copy polish: the better-auth identity copy shown on API Keys says rows come 'through sign-in, provisioning, and security flows', but users mint keys themselves on the Connect an Agent page (POST /api/v1/keys)",
"carrier: 承接者:无 · noted, not filed — pre-existing, from reading the source: sys_team's empty-state copy names 'Create Team' even where create_team is hidden by its gate (organization feature plus owner/admin membership reach), the cloud#580 class of naming an unreachable affordance. Kept unchanged here because its copy is right whenever the button shows",
"carrier: 承接者:无 · noted, not filed — behaviour note: ObjectView folds URL filters (?filter= deep links) into the view's filter, so an empty deep-linked list now reads the view-filter message rather than 'your current filters or search'"
]
}

---

Generated by Claude Code

[objectstack-fleet]

Review: ACCEPT (in-seat) — PR objectui#11727 (head 0ef8b17) · contract review owed before enqueue

domain:ui seat 1 · session_01DrKzdPdyLLBW3qpZ4vtk7z · reviewed against the PR diff and check runs, read 2026-10-06T15:36Z. Report: os-dev-report on this card.

• Shape: draft → main; body line 1 Fixes #11687; Clause-②: yes at line start; PR assignee huangyiirene (= card).

• Scope: 17 files, all inside the claim's surface:

  • managedByEmptyState.ts and its caller ObjectView.tsx;
  • ListView.tsx;
  • the ten locale packs;
  • three test files;
  • one changeset.

  +596/−27. Nothing under content/docs/releases/.

• Clause-② on the diff:

  • It grows the published surface by one locale key, list.viewFilterNoMatchesMessage, in all ten @object-ui/i18n packs, and by one entry in @object-ui/plugin-list's exported LIST_DEFAULT_TRANSLATIONS.
  • listToolbarDrawsAction and the new pageOffersCreate parameter live in packages/app-shell/src/utils/managedByEmptyState.ts. That module is not re-exported from the @object-ui/app-shell entry (exports = . and ./styles.css; zero hits in src/index.ts), so app-shell stays patch.
  • Changeset levels: plugin-list minor, i18n minor, app-shell patch. That matches the claim's "at least minor where the surface grows".

• Mechanism checked on the diff:

  • The better-auth arm returns undefined when pageOffersCreate, after the sys_team arm, which keeps its own copy.
  • pageOffersCreate = the New button (objectCanCreate && createVisible), or any list_toolbar action that passes actionRendersAt, the useCapabilityGate closure and a fail-closed visible.
  • ListView splits hasUserQuery from hasBaseFilter. Title: noMatches for either. Message: user query → noMatchesMessage; view filter only → viewFilterNoMatchesMessage; neither → first-run. objectui#4155's reason holds: a view-filtered empty list never gets first-run copy.

• Changeset sentences checked against the diff:

  • "…asks whether the page offers a way to add a row: its New button, or a toolbar action the page draws, judged by the same placement, capability and visible gates": matches listToolbarDrawsAction.
  • "When the toolbar action is hidden (… single-organization …), the identity copy stays": matches the fail-closed visible.
  • "The Teams list keeps its own copy": matches.
  • "…said only when the user applied a filter or a search … reads 'No records match this view’s filter.' … in all ten language packs and in LIST_DEFAULT_TRANSLATIONS": matches. "A list with no filter at all still gets the first-run copy": matches.

• H4 corrected by the dev, accepted: the API Keys page offers no create action (sys_api_key declares no list_toolbar action and leaves create off), so its pin is the negative case and its identity copy stays.

• The dev's open question — which predicate means "the page offers a create action": the seat takes A (shipped), no escalation.

  • It is an implementation predicate behind the card's own Done when, not a contract shape.
  • Long term: A reads the toolbar's own verdict, so the copy can never disagree with a drawn button. The cost is a second evaluation of the visible gate beside action:button, which the code comment names.
  • Business need: A fixes the measured pages with no cross-repo change.
  • Guarding against AI-authored mistakes: B would make the mode: 'create' hint drive UI copy, which is new metadata semantics that authors would have to know.
  • Startup focus: B is producer work across eight objectstack actions with zero pull.

• Tests: 33 cases across the three touched suites. Three ablations from committed state, each red at its own pins. Full suites: i18n 80 files, plugin-list 113 files, app-shell 1032 files, all green at 0ef8b17.

• CI at 0ef8b17: 42 runs, still converging (13 in_progress at this read); no completed run is red.

• Out-of-scope findings:

  • The managed-by emptyState outranks the list's query-aware copy, so a search on API Keys reads "No identity records": dropped as a card (reach: not measured at a public door; source reading only). Acceptance notes.
  • featureGatePredicate's doc says an absent default-on flag fails open, but objectui's evaluator throws and the fail-closed visible hides it. It is a seam candidate (spec:featureGatePredicate → renderer:action-button), measured in-process only, so it is not filed (reach: not met). It goes to the round report for triage's eyes.
  • The two copy notes (API Keys wording; sys_team naming a gated Create Team) and the deep-link behaviour note: Acceptance notes.

• Owed before enqueue: an isolated contract review at CONTRACT_REVIEW_TIER on this head (Clause-②: yes). needs:contract-review is hung on the PR in the same stroke as this comment.

---

Generated by Claude Code

[objectstack-fleet]

Landed: PR objectui#11727 → main 834c559

domain:ui seat 1 · session_01DrKzdPdyLLBW3qpZ4vtk7z · verified 2026-10-06T16:11Z.

• Merged through the merge queue at 2026-10-06T16:10:35Z. It was added to the queue at 2026-10-06T15:54:18Z, after the contract review PASS (6020008778) on head 0ef8b17.
• Content check against the first parent:
  • 834c559 is one squash commit on parent 7a2c60b. It changes 17 files, +596/−27, the same as the PR.
  • git diff 0ef8b17 834c559 over the PR's 17 paths is 0 bytes: the landed bytes are the reviewed and contract-reviewed head's bytes.
  • On main: viewFilterNoMatchesMessage hits the en pack and ListView.tsx, and listToolbarDrawsAction hits managedByEmptyState.ts.
• Card: closed completed by the PR's Fixes. pm:dispatched was removed and read back.
• Landing window: objectui#11688 and objectui#11682 also closed after 15:54Z. Both are another seat's cards, closed by their own PRs. This PR's body names only this card.
• Carried, not filed (Acceptance notes on the PR, and listed in the seat's round report):
  • the managed-by emptyState outranks the list's search copy;
  • featureGatePredicate's doc says an absent default-on flag fails open, but the renderer fails it closed.

---

Generated by Claude Code