[finding] EmptyStateSchema declares no action, so an empty list cannot name its next step (a docs link, a how-to); the console's only empty-state button is add-record

Filed by the repo:cloud#1 seat (session session_01WVbr5J6u8BHh8EyFtcWciH), from the objectstack-ai/cloud#2776 dev report (cloud PR objectstack-ai/cloud#2793). ⛔ Not graded: grading is triage's. ⛔ Not a claim.

The claim

The maintainer accepted, for the cloud console's empty pages, "one plain sentence and one action" (objectstack-ai/cloud#2772 item 6 → objectstack-ai/cloud#2776, 「同意」). The ruling also says: if the spec cannot express it, the fix is contract-first in the spec, not a special case in objectui. The spec cannot express the action. An empty list can carry a title, a message and an icon, and nothing that leads anywhere. Where nobody can add a row (a list of connections a remote server registers, a list of packages a publisher pushes), the only button the console draws there, add-record, is off, so the empty state has no next step at all.

Evidence

packages/spec/src/ui/view.zod.ts (EmptyStateSchema, :1769 on main 6a7eca68; :1732-1772 at cloud's pin 56bf27affb) is a strict object of title, message and icon. EMPTY_STATE_ACTION_GUIDANCE (:1746) states that the empty state renders text only, and that the add-record button is the renderer's.
objectui packages/plugin-list/src/ListView.tsx:5518-5590 (at cloud's objectui pin d758f2f2): the DataEmptyState action slot is add-record only.
Measured producers of emptyState today: cloud's my_environments (objectstack-ai/cloud#844), cloud's connected_runtimes (objectstack-ai/cloud#2793, text only because of this gap), and objectui's managedByEmptyState.

What the consumer needs

One declared action in the empty state: a link (label + url), a closed shape refused at parse when malformed. For cloud#2776, the two links are "how to connect a self-hosted ObjectOS server" and "how to publish a package".

A url target has to be one the console's action runner accepts: objectui's ActionRunner.isValidUrl refuses mailto: ([finding] ActionRunner.isValidUrl refuses mailto:, so a url action or element:button whose target is mailto: parses and publishes, then answers an error toast at click objectui#12191).
The renderer half is objectui's (ListView.tsx's empty branch). A seam card in the usual order: spec first, then objectui.

Alternatives the dev weighed (not chosen here)

Hiding the empty pages instead. The nav visible scope binds only current_user and features, so it reads neither a plan nor a row count, and in cloud the plan is per environment, not per account. A data-reading nav gate would be new surface, and objectui's nav visible is fail-open. The dev recommended the action key over this.
Stopping at text only (cloud PR objectstack-ai/cloud#2793 as it stands).

Delivery note

Cloud's framework pin is held at 56bf27affb until the v18 move (objectstack-ai/cloud#2709), so a fix reaches cloud with that move.

Dedupe: searched objectstack issues for emptyState, "empty state action" and EmptyStateSchema: no match.

Generated by Claude Code

Evidence for triage's grading, from the repo:cloud#1 seat (session session_01WVbr5J6u8BHh8EyFtcWciH), 2026-10-12T10:01Z. ⛔ Not a grade; grading stays triage's.

The consumer card objectstack-ai/cloud#2776 was raised from priority:p3 to priority:p1 by hotlong at 2026-10-12T08:46Z. Its text-only part landed as cloud PR objectstack-ai/cloud#2793 (15e489b7, both staging planes green). The rest is now pm:blocked on #23004 and #23005, and reaches cloud with its v18 pin move (objectstack-ai/cloud#2709).

Generated by Claude Code

Triage: first grade, `enhancement` · `priority:p1` · `domain:spec` · `area:records`, into `pm:queue`. The empty state gains one declared link, contract first

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

Why p1: objectstack-ai/cloud#2776 is priority:p1 (the maintainer raised it on 2026-10-12) and is pm:blocked on this card. Cloud cannot add a spec key, so this is a wall.
Why the queue: the maintainer's ruling on objectstack-ai/cloud#2776 asks for "one plain sentence and one action", contract first in the spec if the spec cannot express it. This is that execution. It is Clause-②: yes (a new accepted key), built at the judgment tier.
Direction:
- EmptyStateSchema gains one optional link, a label and a target, as a closed shape refused at parse when malformed.
- The target follows the spec's existing url action rules, which [finding] ActionRunner.isValidUrl refuses mailto:, so a url action or element:button whose target is mailto: parses and publishes, then answers an error toast at click objectui#12191's ruling (A+) now has the runner honour. ⛔ No second URL grammar.
- ⛔ No arbitrary action invocation from an empty state: a link only, as the consumer asks.
- EMPTY_STATE_ACTION_GUIDANCE is restated to match.
The renderer half (ListView's empty branch in objectui) is filed by the claiming seat at claim, as [finding] A record:details section heading is static, so it cannot say how many values a field holds (「N 项功能需要更高套餐 · 查看」) objectui#12192's spec half was.
Serial: [finding] A list page (type: list, InterfacePageConfigSchema) declares no emptyState, and objectui's InterfaceListPage passes on only a source view's, so a page-level list cannot say what belongs there #23005 reuses this shape, so it sequences after this card. One seat may claim both.
Triage: lands in packages/spec/src/ui/view.zod.ts (domain:spec); rationale: a new published key.

Evidence for triage, from the repo:cloud#1 seat (session session_01WVbr5J6u8BHh8EyFtcWciH), 2026-10-12T12:22Z. ⛔ Not a grade; grading stays triage's.

The maintainer ruled the consumer's route: objectstack-ai/cloud#2803 letter A, contract first (6124111568 on that card, the maintainer's 「2797 2803 同意。」). objectstack-ai/cloud#2776 (priority:p1) finishes through this card and its sibling (#23004 · #23005), not by hiding the pages and not by stopping at text only.

Generated by Claude Code

`pm:queue` → `pm:blocked`, `Blocked-by: #23010`: this card's link target reuses the url-action rule #23010 declares, so #23010 lands first

domain:spec seat 2 (#18549) · zhuangjianguo · session session_01GZSPSQ5ArPjSJdxxuqwGoZ · 2026-10-12T14:09Z. A technical ordering decision (the seat's call), ⛔ not a re-grade and ⛔ not a claim on this card.

Why: triage's direction for this card (6122915275) reads "The target follows the spec's existing url action rules … ⛔ No second URL grammar." On origin/main df7a137923 those rules do not exist yet: ActionSchema.target (packages/spec/src/ui/action.zod.ts) declares no admitted set. spec: a type:'url' action's target declares its closed scheme set (http:, https:, mailto:, in-app relative paths) and refuses every other scheme at the authoring door (objectui#12191 ruled A+) #23010 is the card that declares it, the spec half of ruling A+ on [finding] ActionRunner.isValidUrl refuses mailto:, so a url action or element:button whose target is mailto: parses and publishes, then answers an error toast at click objectui#12191. Dispatched in parallel, the two would each write the predicate, and that is the second grammar.
spec: a type:'url' action's target declares its closed scheme set (http:, https:, mailto:, in-app relative paths) and refuses every other scheme at the authoring door (objectui#12191 ruled A+) #23010 is claimed and dispatched by this seat in this round (6125926019), raised to priority:p1 as this card's blocker.
Unlock: when spec: a type:'url' action's target declares its closed scheme set (http:, https:, mailto:, in-app relative paths) and refuses every other scheme at the authoring door (objectui#12191 ruled A+) #23010 closes, the unlock scan returns this card to pm:queue. Its dispatch then reuses spec: a type:'url' action's target declares its closed scheme set (http:, https:, mailto:, in-app relative paths) and refuses every other scheme at the authoring door (objectui#12191 ruled A+) #23010's predicate for the link's target, with no new URL grammar. [finding] A list page (type: list, InterfacePageConfigSchema) declares no emptyState, and objectui's InterfaceListPage passes on only a source view's, so a page-level list cannot say what belongs there #23005 stays as triage ordered it: after this card, whose link its shape carries.

`pm:blocked` → `pm:queue`: #23010 landed (`9b37edbd7`, PR #23076)

domain:spec seat 2 · session session_01GZSPSQ5ArPjSJdxxuqwGoZ · 2026-10-12T18:11Z.

Re-derived: no new blocker. The Blocked-by: #23010 line is removed from the body.
What spec: a type:'url' action's target declares its closed scheme set (http:, https:, mailto:, in-app relative paths) and refuses every other scheme at the authoring door (objectui#12191 ruled A+) #23010 settled for this card: the url-action target grammar now exists once, as navigationTargetRefusal in packages/spec/src/ui/navigation-target.ts (non-public, relative import). This card's link url reuses that one predicate, which satisfies triage's "⛔ No second URL grammar".
What it changed for this card: it is simpler now. The link target needs no grammar of its own.
Triage's serial note puts [finding] A list page (type: list, InterfacePageConfigSchema) declares no emptyState, and objectui's InterfaceListPage passes on only a source view's, so a page-level list cannot say what belongs there #23005 after this card, and says one seat may claim both. This seat claims the two as one fold in this round.

Claim: PM loop round 1, fold (#23004 + #23005: the empty state gains one declared link, and a list page carries its own emptyState of that same shape; chain head #23004) · 2026-10-12T18:15Z
Session: session_01GZSPSQ5ArPjSJdxxuqwGoZ
Account: zhuangjianguo (the seat's linked user as GET /user answers it; the card's assignee from this act)
Branch: claude/issue-23004-empty-state-link
Worktree: objectstack-issue-23004
Domain: domain:spec
Seat: domain:spec#2 (seat post #18549)
File surface (at origin/main 9b37edbd7 or later; stop on breach and explain in the report): packages/spec/src/ui/view.zod.ts (EmptyStateSchema, EMPTY_STATE_ACTION_GUIDANCE) and packages/spec/src/ui/page.zod.ts (InterfacePageConfigSchema only), plus their tests; a relative import of navigationTargetRefusal from packages/spec/src/ui/navigation-target.ts (read-only reuse, ⛔ no second URL grammar); packages/spec/liveness/view.json / page.json notes if a measured row exists for the key; the generated artifacts check:generated names; one .changeset/23004-*.md carrying both cards. ⛔ Not objectui: the renderer halves are objectstack-ai/objectui#12270.
Container & model: M (two new keys sharing one shape, with a reused predicate and pins), mode:subagent, model: default tier (dispatch-gates --tier --repo objectstack-ai/objectstack: "no path-derived mandate"; Clause-② suspect on packages/spec/src/**). It owes a review at CONTRACT_REVIEW_TIER before the queue, by an isolated at-tier subagent.
Clause-②: yes (widening: two new accepted keys)
Responsibility: n/a — not a defect card (the maintainer's ruling on objectstack-ai/cloud#2776, 「同意」, contract first; objectstack-ai/cloud#2803 letter A)
Thread-read: 6129937133
Fold (five gates): ① the same defect form, the empty-state contract that cannot carry the ruled "one plain sentence and one action", with the same fix, one declared EmptyStateSchema shape the page reuses by reference; ② one package (packages/spec/src/ui), one worktree, one changeset, one queue slot; ③ both are graded p1 by triage (6122915275, 6122932405) and neither is in the decision box; ④ each is checkable alone: #23004 EmptyStateSchema accepts the link and refuses a malformed one, and #23005 InterfacePageConfigSchema accepts emptyState; ⑤ excluded: the url-target doors in #23077 (another family, after PR #23076), the props-gate tier (#23026), and the renderer halves (objectstack-ai/objectui#12270).
Serial constraints cleared (all 17 open PRs' file lists read at 2026-10-12T18:13Z): PR #23079 (#23016, in the merge queue) edits page.zod.ts ElementDataSourceSchema and liveness/page.json, a different region, so it is ordinary concurrency. Merge origin/main before opening the PR. PR #23080 (#23013) shares generated shards only, and lands by serial relay. Triage's serial note on #23005 ("after #23004") is answered by the fold.

This act moves #23004 and #23005 pm:queue → pm:dispatched and assigns zhuangjianguo. One PR closes both, with one Fixes line per card and per-card commits.

os-dev-report
{
"issue": 23004,
"status": "done",
"branch": "claude/issue-23004-empty-state-link",
"pr": "#23098",
"session": "session_01GZSPSQ5ArPjSJdxxuqwGoZ (subagent; parent's harness-stamped id)",
"premise_still_valid": true,
"summary": "Fold of #23004 + #23005, one draft PR (#23098, Fixes lines for both, Clause-② yes (widening: two new accepted keys), changeset minor). #23004 (commit ec742e9): EmptyStateSchema gains one optional closed link: { label, url } (label I18nLabel, both required, nothing else). url is judged by navigationTargetRefusal from navigation-target.ts (relative import, no copy, subject "An empty-state link's url"); an empty url is refused once by .min(1). A link only, no action invocation. EMPTY_STATE_ACTION_GUIDANCE restated: action/button point at link and keep the addRecord pointer; a flat url/href points into link. #23005 (commit 477cede): InterfacePageConfigSchema gains emptyState: EmptyStateSchema.optional() by reference (identity pinned). Doors measured: on origin/main EmptyStateSchema is referenced by ListViewSchema.emptyState and ComponentPropsMap['object-grid'].emptyState; this PR adds the list page as a third. At objectui origin/main 7af0ab3 none reads the link: ListView.tsx:5688-5696 and ObjectGrid.tsx:6647-6655 draw title/message/icon only, and InterfaceListPage.tsx:503 passes the source view's emptyState only. A grep finds 0 readers of emptyState.link or interfaceConfig.emptyState (control: emptyState 5/3/1 hits). So both new keys carry a [PLANNED — not yet rendered] describe marker plus a ledger row note (view.json emptyState, page.json interfaceConfig). That is the describe-marker + note mechanism (the #23079 precedent). A gate-read planned row is impossible because view/list.emptyState and page/interfaceConfig are recorded undrilled containers. Carrier objectui#12270 covers ListView and InterfaceListPage but NOT ObjectGrid (finding below). The url grammar is a refinement the published JSON Schema cannot express, so dropped-refinements.baseline.json gains 18 sites (new ui/EmptyState entry) exactly as the build printed them. The page form does not offer interfaceConfig.emptyState: the form/Zod reconciliation gate went red and got an omit row whose reason ties it to the renderer half. Merged origin/main twice via os-regen-merge.sh (#23080, then #23062), with a hand-resolved baseline-count conflict. Final head eb4d7de; net delta still 16 files +604/-25.",
"tests": "At eb4d7de (final head): spec build exit 0; check:generated exit 0 ('All 14 generated artifacts are up to date'); targeted spec run of 9 files (empty-state-link 61, page-interface-empty-state 23, metadata-form-zod-reconciliation, alias-integrity, component-object-grid-declared-keys.pin, view-strictness-batch18, type-alias-convention.pin, page, action-url-target-scheme-set) 474 passed, exit 0. At a449f54 (after the first merge; the second merge brought only src/automation + baseline counts): pnpm --filter @objectstack/spec test 659 files / 19950 passed, exit 0; spec typecheck exit 0 incl. check:test-typecheck (52 files / 246 errors / 135 signatures held, no new debt). At 5bbc190 (same net diff, older base): spec test 658 files / 19933 passed; consumers @objectstack/lint 137 files / 6569 passed; @objectstack/platform-objects 70 / 1096; @objectstack/example-showcase 33 / 409; @objectstack/cli vitest --project unit 284 / 4276 (integration tier declared to CI; no spawn entry touched). Reverse type check against rebuilt dist/ui/index.d.mts: link with an extra openIn → tsc exit 2 TS2353; removed → exit 0 with EmptyState link and InterfacePageConfig.emptyState both compiling. Gates: dispatch-gates --commands (no paths) derived 110 families at eb4d7de (same list at 5bbc190); all 110 run at eb4d7de: 109 exit 0, 1 exit 1 = pnpm check:platform-checklist (8 ABSENT SYMBOL/anchor-floor problems in docs/qa/platform-checklist/areas/*.json, untouched here; control leg in a clean worktree at origin/main 6662e3f exits 1 with the identical 8 lines, diff empty). --ran: '110 derived, 110 run, 0 NOT-MEASURED, 0 UNRUN', exit 0. Control bytes: grep -naP over the 16 changed files finds none; check:nul-bytes exit 0. No ablation run (none owed: no gate or tool script edited).",
"mcp_calls": "0 — no MCP GitHub tool called (reads were gh api REST GETs; writes went through scripts/pm/fleet-write).",
"api_writes": "2 relay dispatches (POST /repos/objectstack-ai/objectstack/dispatches, executed as objectstack-fleet[bot]): (1) pr_create → POST /repos/objectstack-ai/objectstack/pulls (draft) + POST /repos//issues/23098/assignees [zhuangjianguo], read back byte-identical (13947 bytes); (2) this os-dev-report comment → POST /repos//issues/23004/comments. Plus git push (not REST). label-write: 0 writes (the dispatch named no label and skip-changeset does not apply: a changeset ships).",
"open_questions": [],
"out_of_scope_findings": [
"carrier: objectstack-ai/objectui#12270 (the seat) · noted, not filed — the object-grid page block door now accepts emptyState.link, and #12270 names only ListView.tsx (item 1) and InterfaceListPage.tsx (item 2); ObjectGrid.tsx:6647-6655 (objectui 7af0ab3) draws title/message/icon only. Suggested: add the grid to #12270's scope.",
"carrier: the next PR touching component.zod.ts' object-grid emptyState describe (承接者:无 named) · noted, not filed — that describe still reads { title, message, icon }; accurate about what the grid draws, but lists three of four accepted members. component.zod.ts was #23080's surface this round, so untouched.",
"carrier: 承接者:无 · noted, not filed — link.label has no translation-bundle address: _views.VIEW.emptyState declares title/message only and os i18n extract emits only those; the inline locale map is the route.",
"carrier: objectstack-ai/objectui#12270's landing · noted, not filed — when the renderer lands: drop both [PLANNED] markers, rewrite the two ledger notes, drill view/list.emptyState into gate-read rows, offer emptyState in the page form and delete the reconciliation omit row."
],
"gates": [
"node scripts/check-adr-0087-registration.mjs --base origin/main :: exit 0",
"node scripts/check-adr-0087-registration.mjs --self-test :: exit 0",
"node scripts/check-changeset-no-major.mjs --base origin/main :: exit 0",
"node scripts/check-changeset-no-major.mjs --self-test :: exit 0",
"node scripts/check-ci-filter-parity.mjs :: exit 0",
"node scripts/check-closing-keyword-parity.mjs :: exit 0",
"node scripts/check-closing-keyword-parity.mjs --self-test :: exit 0",
"node scripts/check-comment-mask-adoption.mjs :: exit 0",
"node scripts/check-comment-mask-adoption.mjs --self-test :: exit 0",
"node scripts/check-comment-mask-corpus.mjs :: exit 0",
"node scripts/check-dev-prereqs.mjs --self-test :: exit 0",
"node scripts/check-doc-frontmatter.mjs :: exit 0",
"node scripts/check-doc-frontmatter.mjs --self-test :: exit 0",
"node scripts/check-doc-route-spelling.mjs --advisory :: exit 0",
"node scripts/check-doc-route-spelling.mjs --self-test :: exit 0",
"node scripts/check-docs-section-name.mjs :: exit 0",
"node scripts/check-docs-section-name.mjs --self-test :: exit 0",
"node scripts/check-dts-emitted.mjs --self-test :: exit 0",
"node scripts/check-empty-changeset.mjs --base origin/main :: exit 0",
"node scripts/check-empty-changeset.mjs --self-test :: exit 0",
"node scripts/check-issue-citations.mjs :: exit 0",
"node scripts/check-keyed-text-bounds.mjs :: exit 0",
"node scripts/check-keyed-text-bounds.mjs --self-test :: exit 0",
"node scripts/check-platform-object-tenancy-census.mjs :: exit 0",
"node scripts/check-platform-object-tenancy-census.mjs --self-test :: exit 0",
"node scripts/check-plugin-teardown-shape.mjs :: exit 0",
"node scripts/check-plugin-teardown-shape.mjs --self-test :: exit 0",
"node scripts/check-registry-log-declared.mjs :: exit 0",
"node scripts/check-registry-log-declared.mjs --self-test :: exit 0",
"node scripts/check-rest-log-spy-declared.mjs :: exit 0",
"node scripts/check-rest-log-spy-declared.mjs --self-test :: exit 0",
"node scripts/check-section-landing-index.mjs :: exit 0",
"node scripts/check-section-landing-index.mjs --self-test :: exit 0",
"node scripts/check-spec-docblock-symbol-anchors.mjs :: exit 0",
"node scripts/check-spec-docblock-symbol-anchors.mjs --self-test :: exit 0",
"node scripts/check-system-context-census.mjs :: exit 0",
"node scripts/check-system-context-census.mjs --self-test :: exit 0",
"node scripts/check-undeclared-dep-imports.mjs :: exit 0",
"node scripts/check-undeclared-dep-imports.mjs --self-test :: exit 0",
"node scripts/docs-audit/check-affected-docs.mjs :: exit 0",
"node scripts/docs-audit/check-drift-comment.mjs :: exit 0",
"node scripts/pm/release-rehearsal-clone.mjs --self-test :: exit 0",
"node scripts/release-pending-publish.mjs --self-test :: exit 0",
"pnpm --filter @objectstack/lint run check:doc-formula-expressions :: exit 0",
"pnpm --filter @objectstack/lint run check:doc-security-posture :: exit 0",
"pnpm --filter @objectstack/spec run check:api-surface :: exit 0",
"pnpm --filter @objectstack/spec run check:authorable-surface :: exit 0",
"pnpm --filter @objectstack/spec run check:browser-reachable-entries :: exit 0",
"pnpm --filter @objectstack/spec run check:docs :: exit 0",
"pnpm --filter @objectstack/spec run check:dual-source-exports :: exit 0",
"pnpm --filter @objectstack/spec run check:duration-unit-keys :: exit 0",
"pnpm --filter @objectstack/spec run check:empty-state :: exit 0",
"pnpm --filter @objectstack/spec run check:entry-nameability :: exit 0",
"pnpm --filter @objectstack/spec run check:export-origins :: exit 0",
"pnpm --filter @objectstack/spec run check:exported-any :: exit 0",
"pnpm --filter @objectstack/spec run check:generated :: exit 0",
"pnpm --filter @objectstack/spec run check:liveness :: exit 0",
"pnpm --filter @objectstack/spec run check:llms-txt :: exit 0",
"pnpm --filter @objectstack/spec run check:objectui-pin-citations :: exit 0",
"pnpm --filter @objectstack/spec run check:skill-examples :: exit 0",
"pnpm --filter @objectstack/spec run check:skill-refs :: exit 0",
"pnpm --filter @objectstack/spec run check:strictness-ledger :: exit 0",
"pnpm --filter @objectstack/spec run check:variant-docs :: exit 0",
"pnpm --filter @objectstack/spec run check:yaml-examples :: exit 0",
"pnpm check:changeset-gate-self-tests :: exit 0",
"pnpm check:corpus-claim-drift :: exit 0",
"pnpm check:cross-package-test-inputs :: exit 0",
"pnpm check:dispatcher-error-vocabulary :: exit 0",
"pnpm check:doc-anchors :: exit 0",
"pnpm check:doc-authoring :: exit 0",
"pnpm check:docs-audit-scope :: exit 0",
"pnpm check:docs-redirects :: exit 0",
"pnpm check:docs-single-h1 :: exit 0",
"pnpm check:docs-spec-enumerations :: exit 0",
"pnpm check:docs-transcript-drift :: exit 0",
"pnpm check:driver-memory-census :: exit 0",
"pnpm check:dts-closure :: exit 0",
"pnpm check:dual-build-cjs-loads :: exit 0",
"pnpm check:engine-double-contract :: exit 0",
"pnpm check:gitlink-declared :: exit 0",
"pnpm check:issue-citations :: exit 0",
"pnpm check:lean-entry-closure :: exit 0",
"pnpm check:logger-receiver-detach :: exit 0",
"pnpm check:merge-driver :: exit 0",
"pnpm check:nul-bytes :: exit 0",
"pnpm check:objectql-double-limit :: exit 0",
"pnpm check:objectui-changeset :: exit 0",
"pnpm check:org-identifier :: exit 0",
"pnpm check:page-declaration-shape :: exit 0",
"pnpm check:platform-checklist :: exit 1",
"pnpm check:pm-changeset-deadline-census :: exit 0",
"pnpm check:pm-prior-rulings :: exit 0",
"pnpm check:published-files :: exit 0",
"pnpm check:published-readme-links :: exit 0",
"pnpm check:query-options-erasure :: exit 0",
"pnpm check:quick-reference-counts :: exit 0",
"pnpm check:react-page-adapter-contract :: exit 0",
"pnpm check:refd-timer-probe :: exit 0",
"pnpm check:role-word :: exit 0",
"pnpm check:skill-identifier-liveness :: exit 0",
"pnpm check:slot-lookup :: exit 0",
"pnpm check:sourcemap-no-sources-content :: exit 0",
"pnpm check:spec-parsed-alias :: exit 0",
"pnpm check:test-source-alias :: exit 0",
"pnpm check:tier-file-adoption :: exit 0",
"pnpm check:type-check-coverage :: exit 0",
"pnpm check:type-check-debt :: exit 0",
"pnpm check:vendor-version-stamps :: exit 0",
"pnpm check:watch-hint-literal :: exit 0",
"pnpm check:where-matcher :: exit 0"
],
"line_budget": {
"additions": 604,
"deletions": 25,
"changed_files": 16,
"changed_lines": 629,
"human_merge_threshold": 3000
},
"files_changed": [
".changeset/23004-empty-state-link.md",
"content/docs/references/api/protocol.mdx",
"content/docs/references/data/object.mdx",
"content/docs/references/ui/component.mdx",
"content/docs/references/ui/page.mdx",
"content/docs/references/ui/view.mdx",
"docs/audits/2026-07-unknown-key-strictness-ledger.counts/ui.md",
"packages/spec/authorable-surface/ui.json",
"packages/spec/dropped-refinements.baseline.json",
"packages/spec/liveness/page.json",
"packages/spec/liveness/view.json",
"packages/spec/src/system/metadata-form-zod-reconciliation.test.ts",
"packages/spec/src/ui/empty-state-link.test.ts",
"packages/spec/src/ui/page-interface-empty-state.test.ts",
"packages/spec/src/ui/page.zod.ts",
"packages/spec/src/ui/view.zod.ts"
],
"deviations": [
"File surface: two paths outside the claim, both forced by a gate and stated in the PR body. packages/spec/src/system/metadata-form-zod-reconciliation.test.ts got one omit row for page interfaceConfig.emptyState (the gate went red: 'accepted by the Zod but unauthorable in the form'). packages/spec/dropped-refinements.baseline.json got 18 sites, because the build refused the new refinement until they were declared.",
"Second origin/main merge (#23062): dropped-refinements.baseline.json conflicted on droppedRefinementSites, resolved by stacking to 731. Git auto-merged publishedSchemasWithDroppedRefinements to 227 because both sides went 226→227, which is jointly wrong; it was corrected by hand to 228 (228 entries / 731 sites counted).",
"Narrowed re-run: after the second merge only the targeted spec files, the build, check:generated and the full gate battery were re-run at eb4d7de. The full spec suite and typecheck are from a449f54, and the consumer suites from 5bbc190. The incoming #23062 touches src/automation/** and the baseline counts only; CI runs the full set.",
"Liveness mechanism: describe marker + ledger row note, not a gate-read planned row. Drilling view/list.emptyState would also edit undrilled-containers.baseline.json, which is outside the claimed surface.",
"Commit trailers use AGENTS.md's model-free pair (Claude-Session + Co-authored-by: Claude), and the PR footer uses the AGENTS.md session-URL form, rather than the harness reminder's model-named / robot-emoji forms; the user's instruction file takes precedence.",
"The cli unit run passed the 600s foreground cap and was moved to the background by the harness. I waited on its holder PID in the foreground (tail --pid) and read the lock VERDICT, command-exit 0.",
"A Contract review at CONTRACT_REVIEW_TIER is owed before the queue (claim); not mine to perform."
]
}

ACCEPT · PR #23098 @ `eb4d7de12`, the fold of #23004 + #23005 (seat review; a `CONTRACT_REVIEW_TIER` review is owed before the queue)

domain:spec seat 2 (#18549) · session session_01GZSPSQ5ArPjSJdxxuqwGoZ · 2026-10-12T21:07Z. Reviewed against GitHub, not the report.

Shape

Draft, base main. Lines 1–2 are Fixes #23004 and Fixes #23005, and those are the only closing keywords.
Clause-②: yes (widening: two new accepted keys) sits at line start. Assignee zhuangjianguo.
16 files, +604/−25. check-governed-merges --pr 23098: NOT governed, under 3,000 lines.

Diff, read against triage (6122915275, 6122932405)

EmptyStateSchema.link is a closed { label, url }, both required. It is a link only and invokes no action.
url is judged by navigationTargetRefusal from navigation-target.ts (landed in 9b37edbd7) by relative import, with no second predicate. That satisfies "⛔ No second URL grammar". An empty url is refused once, by .min(1).
EMPTY_STATE_ACTION_GUIDANCE is restated as triage asked. InterfacePageConfigSchema.emptyState is EmptyStateSchema.optional() by reference, which satisfies "⛔ No second empty-state shape".
The three doors the link widens (list view, object-grid block, list page) are enumerated with the renderer read at objectui 7af0ab3. Both keys carry [PLANNED — not yet rendered].

Changeset, checked sentence by sentence

minor, Clause-②: yes (widening …).
"The targets a type: 'url' action opens, and no others" matches the shared predicate.
"Every door that carries the empty state takes the link" matches the by-reference use.
"Published JSON Schema … x-dropped-refinements" matches the 18 baseline sites.

Deviations accepted

Two gate-forced files outside the claim:
- the form reconciliation omit row, reasoned and naming its removal trigger, Render a list's declared empty-state link, and let a list page's own emptyState win over its source view's (the objectui half of objectstack#23004 and objectstack#23005) objectui#12270;
- dropped-refinements.baseline.json.
The baseline's publishedSchemasWithDroppedRefinements was hand-corrected from git's jointly-wrong 227 to 228. The build and check:generated on the PR head are what certify it. That is a CI reading this seat reads before any landing act, not the report's word.
The narrowed re-run after the second merge is declared, and CI runs the full set.

CI on eb4d7de12 at review time: 23 checks green and 11 in_progress.

Out-of-scope findings

ObjectGrid.tsx does not draw the link, and Render a list's declared empty-state link, and let a list page's own emptyState win over its source view's (the objectui half of objectstack#23004 and objectstack#23005) objectui#12270 named only ListView and InterfaceListPage. Carried: this seat adds the grid to [finding] admin-has-permission-endpoint's "Fail direction" header claims a delegation the code does not do — the unreadable-options path runs on the vendor's defaultRoles #12270 now.
The object-grid emptyState describe in component.zod.ts lists three of the four members. Noted: it rides the next PR that touches that describe.
link.label has no translation-bundle address yet. Noted: the inline locale map is the route.
The marker, note and form-row removal when the renderer lands is carried by Render a list's declared empty-state link, and let a list page's own emptyState win over its source view's (the objectui half of objectstack#23004 and objectstack#23005) objectui#12270's landing.

Landing order: PR #23095 is in the queue and shares no file with this PR. PR #23073's work will regenerate content/docs/references/api/protocol.mdx, which this PR also writes, so this PR lands first in the seat's serial relay.

Patch round on PR #23098 (fold #23004 + #23005), from the dev subagent of domain:spec seat 2 (session session_01GZSPSQ5ArPjSJdxxuqwGoZ). New head: 5adfbc141.

Cause of the red Test Core (1/6): the EmptyStateSchema.link.url describe wrote a lone ${ inside an inline-code span. gen:docs copied it into content/docs/references/ui/view.mdx, which scripts/escape-mdx.test.ts refuses.
Fix (9a6bebdd8): the describe now reads "a template that opens with ${…}, such as ${ctx.origin}/docs, is judged when it is clicked, after interpolation". The meaning is unchanged. The changeset's matching sentence is balanced the same way. A scan of every added line of the diff (spec src, changeset) for an inline-code span with unbalanced braces finds 0. page.zod.ts's describe was already balanced.
Regeneration (5adfbc141): after pnpm --filter @objectstack/spec build, check:generated proved one artifact stale, content/docs/references/**, and --fix regenerated only ui/view.mdx.
Readings at 5adfbc141:
- vitest --project repo scripts/escape-mdx.test.ts: 12 passed.
- The touched spec files (--project local): 9 files, 474 passed.
- check:generated: "All 14 generated artifacts are up to date".
- The families the fix reaches, 14 commands, all exit 0: check:empty-state, check:docs, check:liveness, check:authorable-surface, check:api-surface, check:nul-bytes, check:doc-authoring, check:doc-anchors, check:issue-citations, check:docs-spec-enumerations, check-spec-docblock-symbol-anchors, check-adr-0087-registration, check-changeset-no-major and check-empty-changeset.
- dispatch-gates --commands derives the same 110 families as at eb4d7de12. The other 96 were not re-run, because this round changes describe text only.
Net diff: unchanged at 16 files, +604/−25. origin/main moved one commit (1badd3183), which touches none of these files, so no merge.

Landed. PR #23098, the fold of #23004 and #23005, merged through the queue as 55828c514 on main · domain:spec seat 2 · session session_01GZSPSQ5ArPjSJdxxuqwGoZ · 2026-10-12T22:25Z. This seat's claim on both cards ends with the merge.

Seat ACCEPT 6132626774. The CONTRACT_REVIEW_TIER record 6133160304 (PASS) is on the head that landed, 5adfbc141. Not governed.
What shipped in the spec:
- EmptyStateSchema.link: { label, url }, a link only. url is judged by the one navigation grammar navigationTargetRefusal, which the url action's target also uses.
- InterfacePageConfigSchema.emptyState, by reference.
- Both are marked [PLANNED — not yet rendered].
Renderer half: Render a list's declared empty-state link, and let a list page's own emptyState win over its source view's (the objectui half of objectstack#23004 and objectstack#23005) objectui#12270. The pointer 6132635356 there adds the third door, object-grid.
Owed when objectui#12270 lands: a domain:spec follow-up card. It drops the two planned markers, rewrites the two ledger notes, offers interfaceConfig.emptyState in the page form, and deletes its reconciliation omit row.

feat(empty-state): draw the declared empty-state link through the act…

Navigation Menu

Repository navigation

[finding] EmptyStateSchema declares no action, so an empty list cannot name its next step (a docs link, a how-to); the console's only empty-state button is add-record #23004

The claim

Evidence

What the consumer needs

Alternatives the dev weighed (not chosen here)

Delivery note

Triage: first grade, `enhancement` · `priority:p1` · `domain:spec` · `area:records`, into `pm:queue`. The empty state gains one declared link, contract first

`pm:queue` → `pm:blocked`, `Blocked-by: #23010`: this card's link target reuses the url-action rule #23010 declares, so #23010 lands first

`pm:blocked` → `pm:queue`: #23010 landed (`9b37edbd7`, PR #23076)

ACCEPT · PR #23098 @ `eb4d7de12`, the fold of #23004 + #23005 (seat review; a `CONTRACT_REVIEW_TIER` review is owed before the queue)

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

[finding] EmptyStateSchema declares no action, so an empty list cannot name its next step (a docs link, a how-to); the console's only empty-state button is add-record #23004

Description

The claim

Evidence

What the consumer needs

Alternatives the dev weighed (not chosen here)

Delivery note

Activity

objectstack-fleet commented on Oct 12, 2026

objectstack-fleet commented on Oct 12, 2026

Triage: first grade, enhancement · priority:p1 · domain:spec · area:records, into pm:queue. The empty state gains one declared link, contract first

objectstack-fleet commented on Oct 12, 2026

objectstack-fleet commented on Oct 12, 2026

pm:queue → pm:blocked, Blocked-by: #23010: this card's link target reuses the url-action rule #23010 declares, so #23010 lands first

objectstack-fleet commented on Oct 12, 2026

pm:blocked → pm:queue: #23010 landed (9b37edbd7, PR #23076)

objectstack-fleet commented on Oct 12, 2026

objectstack-fleet commented on Oct 12, 2026

objectstack-fleet commented on Oct 12, 2026

ACCEPT · PR #23098 @ eb4d7de12, the fold of #23004 + #23005 (seat review; a CONTRACT_REVIEW_TIER review is owed before the queue)

objectstack-fleet commented on Oct 12, 2026

objectstack-fleet commented on Oct 12, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

Triage: first grade, `enhancement` · `priority:p1` · `domain:spec` · `area:records`, into `pm:queue`. The empty state gains one declared link, contract first

`pm:queue` → `pm:blocked`, `Blocked-by: #23010`: this card's link target reuses the url-action rule #23010 declares, so #23010 lands first

`pm:blocked` → `pm:queue`: #23010 landed (`9b37edbd7`, PR #23076)

ACCEPT · PR #23098 @ `eb4d7de12`, the fold of #23004 + #23005 (seat review; a `CONTRACT_REVIEW_TIER` review is owed before the queue)