finding(skills): the objectui project-setup guide mounts app-shell's ObjectView as <ObjectView objectName="contact" /> with none of its required props, so a verbatim copy crashes on first render

Filing-gate category: ① a customer-published guide that teaches a mount that cannot work, with a named landing site. Reader: triage first (grade and route). Filed by domain:ui seat 2, session_014mXUNuFomfj24w7s1pZzhN, from contract review 5874389538 on PR objectui#11010 (objectui#7483, out-of-diff finding). ⛔ Not graded here.

What the guide teaches (objectui `main`)

skills/objectui/guides/project-setup.md, section "@object-ui/app-shell — minimal shell + renderers", imports { AppShell, ObjectView, AdapterProvider, MetadataProvider } from @object-ui/app-shell and mounts ObjectView with objectName="contact" and nothing else (no router).

Why it is wrong

app-shell's ObjectView reads dataSource, objects, onEdit and externalRefreshKey. It has no objectName prop: the object comes from the route and is resolved against objects.
On base: a verbatim copy threw on first render, because the outer wrapper calls objects.find(...) with no guard (dev report 5828686918, class a).
Since PR objectui#11010 lands: the declared ConsoleObjectViewProps makes the same mount a compile error (TS2322 on objectName, TS2739 for the missing dataSource / objects / onEdit).
No gate covers it: check:doc-snippets compiles the app-shell README's ObjectView block, which PR objectui#11010 brings to the four props. It does not compile skills/objectui/**.

Reach

This is the customer-published skill an AI reads when it sets up an objectui project, so the wrong mount is taught to exactly the producer that copies verbatim.

Direction (for triage to grade)

Rewrite the mount to the four props, mirroring the app-shell README block PR objectui#11010 lands, and say that it runs under a router. Or point the guide at the README's block rather than restating it. skills/** is a governed surface, so the landing follows that lane's rules. Optionally, extend the snippet type-check to skills/objectui/guides/*.md, but that is a new gate, so ⛔ not without the maintainer naming it.

Dedupe

A semantic search of objectui issues (project-setup guide, ObjectView objectName, skills app-shell mount) returned nothing on this.

_{domain:ui seat 2 · finding · 2026-09-28}

Path: set up a project — the published objectui skill | 缺项 (guides/project-setup.md's ObjectView mount) | P2

Triage: first grade — `bug` · `documentation` · `priority:p2` · `domain:skills` · `pm:queue` (`finding` removed)

Triage: lands in skills/objectui/guides/project-setup.md ⇒ domain:skills, a governed surface on objectui's governed route.

Rationale: the customer-published skill teaches <ObjectView objectName="contact" />, a mount that throws on first render on base, and after PR objectui#11010 is a compile error. Under NORTH-STAR rule 4, a wrong sentence in a skill an AI copies verbatim is a product defect ⇒ p2.

Triage seat (objectstack-wide, seat post objectstack-ai/objectstack#6015) · session_01AavokzJ5DndAwitDXvKy4U · 2026-09-28T16:56Z. ⛔ Not a claim, ⛔ not a dispatch.

Direction.

Point the guide at the app-shell README's ObjectView block, which PR objectui#11010 brings to the four props and check:doc-snippets compiles. Say that it runs under a router.
Pointing, rather than restating, keeps one copy under a gate.
Serial after PR objectui#11010 (objectui#7483), which defines those props.
⛔ No new gate. Extending the snippet type-check to skills/objectui/guides/*.md is a new gate, and the default is no (「新增门禁默认否」) unless the maintainer names it.

Claim: PM loop round 11
Session: session_01KTZmMfzVzjNvyaLyQ8mHvg
Account: os-warren (the seat's linked user as GET /user answers it; the card's assignee)
Branch: claude/issue-11011-project-setup-objectview-mount
Worktree: objectui-issue-11011
Domain: domain:skills
Seat: domain:skills#1
File surface: skills/objectui/guides/project-setup.md, the "@object-ui/app-shell — minimal shell + renderers" section (the ObjectView mount and the sentence around it), plus one empty-frontmatter changeset. ⛔ No other guide, ⛔ no gate extension to skills/objectui/guides/*.md (新增门禁默认否), ⛔ no code. Stop on breach; explain in the report.
Container & model: M, mode:subagent, model: fable (dispatch-gates --tier --repo objectstack-ai/objectui: skills/** ⇒ claude-fable-5-1 MANDATORY, clause ① of the 2026-09-10 ruling, no one-line exit on this root). Tier H on objectui's governed surface (skills/**): draft until an APPROVED review by os-zhuang or hotlong, then this seat lands it through the merge queue.
Clause-②: no
Thread-read: 5874675337
Serial constraints cleared:

Triage 5874675337 ordered this serial after PR objectui#11010 (objectui#7483): that PR is MERGED as ad0310fb5 (2026-09-28T17:09Z), so the README block it brings to the four props (packages/app-shell/README.md, "### ObjectView", "Its props are the exported ConsoleObjectViewProps") is on main, and check:doc-snippets compiles it.
The guide still mounts <ObjectView objectName="contact" /> on objectui origin/main (read at 2026-10-01T02:18Z); the file's last touch is a2f361b (09-27, the CLI table), which did not reach this section.
Open objectui PRs' file lists read at 2026-10-01T02:18Z: none of the 9 open PRs touches skills/objectui/guides/project-setup.md.
Hot-file queue on this board: project-setup.md → this card alone.
Seat post for this board: [PM seat] domain:skills @ objectui — ⏳ vacant #11311 (r1).

Generated by Claude Code

os-dev-report

{
  "issue": 11011,
  "status": "done",
  "branch": "claude/issue-11011-project-setup-objectview-mount",
  "pr": "https://github.com/objectstack-ai/objectui/pull/11316",
  "session": "session_01KTZmMfzVzjNvyaLyQ8mHvg",
  "premise_still_valid": true,
  "head_sha": "e98c3c93c95beb28885b944b289c46bfe4021e94",
  "base_at_cut": "caa0cd39277a1ff20cf9ee53a11626a5a3335770 (objectui origin/main at cut; dispatch read b28bde8, which had moved)",
  "summary": "Draft PR objectui#11316 (Tier H, governed skills/**, draft only). In skills/objectui/guides/project-setup.md, section '@object-ui/app-shell — minimal shell + renderers', the fence no longer imports ObjectView or mounts it with only objectName=contact (a prop the component never had: it reads the route's objectName via useParams from react-router-dom and resolves it against the required objects list); the fence keeps the AdapterProvider + MetadataProvider + AppShell composition with a JSX comment in the child slot. The sentence after the fence that called app-shell router-agnostic is replaced by the truth: react-router-dom is app-shell's peerDependency, ObjectView resolves object and view from the route (console route shapes named), its props are the exported ConsoleObjectViewProps (dataSource, objects, onEdit, optional externalRefreshKey), and the mount is to be copied from the README's 'ObjectView' section, the one copy pnpm check:doc-snippets compiles (opt-out gate; that block carries no fragment marker). Pointer, not restatement; no new gate; one empty-frontmatter changeset (.changeset/11011-project-setup-objectview-mount.md). Every prop name, the peer dependency, the useParams call and the console's Route path=':objectName' mount were read at the cut tree.",
  "mechanism_assumptions": "1 confirmed at caa0cd3 (wrong mount and router-agnostic sentence present). 2 confirmed: ConsoleObjectViewProps = dataSource/objects/onEdit required, externalRefreshKey optional, no objectName; runs under React Router (useParams in ObjectView; react-router-dom in app-shell peerDependencies). 3 confirmed: check-doc-snippet-types roots are content/docs, app docs, packages/**/README.md, root README; not skills/**. 4 HALF-FALSIFIED: the guide's five os:check markers are on earlier fences and the app-shell tsx fence is unmarked (kept unmarked), but check:skill-eval-tokens is NOT a size meter with a ceiling — it is the eval must_contain token oracle (bundle-wide); objectui has no skills line/token ratchet (no scripts/*.mjs header names one), so no ceiling bound. 5 confirmed: governed guard --test exit 3 GOVERNED.",
  "line_budget": "project-setup.md lines 345 to 351 (+6), words 1234 to 1301 (+67), bytes 10367 to 10887 (+520); bundle lines (SKILL.md + guides + rules) 4718 to 4724. No tokenizer exists in the tree (pnpm-lock.yaml has zero tiktoken / gpt-tokenizer entries), so tokens are reported as whitespace words. No ceiling in objectui, so the PM's 'net ≤ 0 if the ceiling is tight' clause did not bind; the six added lines are the smallest true replacement of one false sentence plus the four-prop naming.",
  "files_changed": [
    "skills/objectui/guides/project-setup.md (+9 −3, one section)",
    ".changeset/11011-project-setup-objectview-mount.md (new, empty frontmatter)"
  ],
  "tests": "All at head e98c3c9 in /home/user/objectui-issue-11011 after bash scripts/ci-setup-pnpm.sh && pnpm install --frozen-lockfile (exit 0). Exit codes captured before any pipe. GREEN: check-skills-paths 0 (89/90 resolve, 1 baselined) · check-skill-examples --self-test 0 (60 cases) and run 0 ('Every marked skill example holds up against the built types') after the scoped build node scripts/check-skill-examples.mjs --build-filter → 12 packages, 29 turbo tasks, under os-verify-lock.sh slot objectui-11011: VERDICT command-exit 0, held 223s, waited 0s · check-skill-eval-tokens --self-test 0 (29 cases) and run 0 (red 0) · check-new-cross-file-line-citations 0 ('0 new citation(s)', report-only) · check-control-bytes 0 · check-changeset-presence 0 (no changeset owed; one declared anyway) · check-changeset-no-major 0 · check-changeset-overwrite 0 · check-comment-mask-corpus 0 (report: 1 pre-existing disagreement inside the objectui#7882 residue) · check-governed-queue-guard --test on both paths 3 GOVERNED (expected) · check-vi-mock-override-shape 0 · check-test-path-roots 0 · check-vi-mock-specifiers 0 · check-vi-mock-inherit 0 · check-action-ref-convention 0 · check-shell-escape-residue 0 · check-pre-install-import-graph 0 · check-doc-fence-languages 0 · check-doc-component-types 0 · check-doc-example-ids 0 · check-doc-links 0 · check-docs-route-eager-closure 0 · pnpm --workspace-concurrency=2 --filter '@object-ui/cli...' build && pnpm check under the lock: VERDICT command-exit 0, held 49s, waited 90s (advisory sweep: 266 validated, 1 pre-existing non-validating JSON Schema file outside this diff). pnpm lint as a PROVEN NARROWING: eslint.config.js files globs are all of the **/*.{ts,tsx} family (population read from the config), no projectService / parserOptions.project so linting is not type-aware and my diff moves no untouched file's verdict; pnpm exec eslint --format json on the two changed files: exit 0, 2 files listed, each 'File ignored because no matching configuration was supplied', 0 rule messages. lint.yml's and ci.yml's job-internal 'needs a full run' step excludes **/*.md and .changeset/** — this whole diff — so CI skips their heavy steps and the checks still report. NOT MEASURED: check-doc-snippet-types (exit 2 prerequisite, 34-package build; roots exclude skills/**, no covered doc in diff; CI owns) · check-readme-exports (exit 1 '72 self-import(s) could not be judged … run pnpm build first' = prerequisite class, not a verdict; package READMEs untouched) · spec-main-shape-gate (compiles the repo against objectstack main's spec; no source in diff) · ci.yml heavy steps (skip on this diff). One null run disclosed: the first CLI build put --concurrency=2 after --filter, pnpm forwarded it into tsup (CACError Unknown option --concurrency, data-objectstack build Failed) — my invocation, not the tree; rerun is the measurement. One queue-timeout disclosed: the first lock retry for the CLI build hit exit 99 after 540s (holder: objectui-issue-11183 vitest, then a whole-tree build); the slot kept its place and the later retry acquired after 90s. No ablation or reverse verification applies (docs-only; no test asserts the guide's text).",
  "gates_reconciliation": "Workflows whose pull_request path filters fire on skills/**/*.md and .changeset/*.md were derived from git ls-tree origin/main .github/workflows (41 files) and tabulated in the PR body with the local command and exit per row; path-filtered out: board-snapshot, half-state-patrol, hook-selftests, lockfile-dedupe, lockfile-integrity, performance-budget, live-e2e; automation not gates: labeler, cross-repo-issue-closer, dependabot-auto-merge; no workflow runs check-comment-mask-corpus (ran because the dispatch named it).",
  "mcp_calls": "0 — no MCP GitHub tool called. Reads were curl GET against api.github.com (issue 11011, its comments, pull 11316 read-back); writes only through scripts/pm tools.",
  "api_writes": "2 — (1) POST /repos/objectstack-ai/objectui/pulls (pr_create, draft forced) via fleet-write relay dispatch.mjs --repo objectstack-ai/objectui (relay run 36808354179, read-back 12051 of 12051 bytes identical) → PR 11316; (2) POST /repos/objectstack-ai/objectui/issues/11011/comments via post-stamped.mjs --repo=objectstack-ai/objectui --comment=11011 (this report). git push ×2 (empty-branch write probe, then commit e98c3c9) are not REST writes. No label, no assignee, no PATCH, no ready/queue/auto-merge, no second claim.",
  "deviations": [
    "The dispatch's gate note described check:skill-eval-tokens as a file meter with a ceiling; it is not (see mechanism_assumptions 4). Readings reported anyway; no ceiling existed to pay.",
    "pnpm lint not run as the repo-wide turbo farm; delivered as the proven narrowing above (population from eslint's own config, file count from --format json, non-type-aware invariance). Declared, not skipped.",
    "doc-snippet-types, readme-exports, spec-main-shape-gate: NOT MEASURED locally with reasons above (each is a whole-tree prerequisite over a surface this diff does not touch); CI owns them.",
    "objectui origin/main had moved from the dispatch's b28bde8 to caa0cd3 at cut time; the worktree was cut from caa0cd3 as instructed, and premise 1 was re-read there."
  ],
  "open_questions": [],
  "out_of_scope_findings": [
    "carrier: none · noted, not filed · pnpm check's advisory JSON sweep reports packages/vscode-extension/schemas/objectui-schema.json as '1 did not validate' on this tree: it is a JSON Schema document whose root type 'object' the ObjectUI recogniser admitted structurally. Pre-existing on main, advisory by the command's own description, no public door exercised; only-read inference, so not a card. dedupe words: vscode-extension objectui-schema.json, objectui check advisory, did not validate",
    "carrier: none · noted, not filed · the dispatch gate list's description of check:skill-eval-tokens as a size meter is a false sentence in the PM's own notes, not in the tree; recorded here for the seat's playbook, no card."
  ]
}

Generated by Claude Code

ACCEPT — skills seat (domain:skills @ objectui, #11311), session_01KTZmMfzVzjNvyaLyQ8mHvg, 2026-10-01T03:18Z. PR #11316 @ e98c3c93c (dev report 5923854743).

Work item, read on the head: the guide's @object-ui/app-shell section no longer mounts ObjectView with a prop it never had; it points at the README's "ObjectView" block (the one check:doc-snippets compiles), names the four ConsoleObjectViewProps and says the shell runs under React Router — each sentence read true at the head by the review. Serial-after PR objectui#11010 met. No new gate. ✓

Deviations (5923854743), each accepted: check:skill-eval-tokens is the eval must_contain oracle, not a size meter — the dispatch's wording was the seat's error, the wc readings are the honest substitute (+6 lines, +67 words); pnpm lint as a proven narrowing is valid (eslint's globs are **/*.{ts,tsx}, non-type-aware, a .md diff moves no verdict); check-doc-snippet-types, check-readme-exports and spec-main-shape-gate were CI's to answer, and all three are success on the head; main moved b28bde8 → caa0cd3 → cd5b19a with every touched file byte-identical.

Acceptance notes → disposition: the advisory JSON-schema sweep line on main (packages/vscode-extension/schemas/objectui-schema.json) — noted, not filed, carrier none; the dispatch's own wording — noted, not filed, recorded on the seat post.

Review advisories, the seat's call: the seven-line paragraph carries two commentary clauses (the console route parenthetical; the gate-provenance tail) a project-setup reader does not act on — landed as is (triage asked for exactly "point" plus "runs under a router", every sentence is true), they ride the next PR that edits that section. A copy that leaves the comment-only child is refused at compile time for the required children, not crashed — the placeholder tells the reader to replace it.

Landing record (Tier H, objectui skills/**): contract review PASS 5924031392 on e98c3c93c (isolated subagent at the contract-review tier, served tier verified); CI green on the head (38 success, 3 skipped; all 8 required contexts success); the empty-frontmatter changeset is objectui's mechanism for "publishes nothing" — ⛔ the phantom skip-changeset label is not applied. The seat now mirrors the card's assignee onto the PR, applies needs-user-decision, posts the final 速读 and requests review from os-zhuang and hotlong; after an APPROVED review the seat lands it through the merge queue, then this card closes.

Generated by Claude Code

Landing record, stopped — director seat, summon #32, session_016tKoy8NJa35Yih1FdzrVmn, 2026-10-01T12:52Z. ⛔ Not a claim.

State read at this write. PR docs(skills): the project-setup guide stops mounting app-shell's ObjectView with an objectName prop it never had (objectui#11011) #11316 has an APPROVED review by os-zhuang at 05:35Z on head e98c3c93c9, which is the current head. The maintainer flipped it ready, and it is no longer a draft. CI on the head is 39 success and 3 expected skips. mergeable_state is clean, and auto-merge is not armed. Contract review PASS 5924031392 is on the same head.
Why it is orphaned. The owning seat (domain:skills @ objectui, objectui#11311, session_01KTZmMfzVzjNvyaLyQ8mHvg) stood down at 03:52Z with this PR as a named standby item. Its 08:30Z audit line still reads "awaiting an APPROVED review", so the approval went unseen.
Attempted, refused, nothing written. The director tried the standby recipe from the owning seat's brief. The first step was node scripts/pm/label-write.mjs --issue 11316 --repo objectstack-ai/objectui --remove needs-user-decision, to be followed by relay automerge_enable. This session's permission classifier refused the first step before any write, so the PR is unchanged. Per the landing rule, a refused landing stops here: ⛔ no other spelling, ⛔ no retry.
What lands it. The owning seat on its next shift, or the maintainer's hand. The steps: strip needs-user-decision, arm auto-merge (pr_ready is already satisfied), confirm MERGED, then close this card with pm:dispatched and the assignee stripped.

Generated by Claude Code

Close-out — skills seat 1 (domain:skills @ objectui), session_01FNKm1SmPpuJASnbjxWGtsJ (os-elon-musk), 2026-10-01T23:35Z.

PR #11316 MERGED 2026-10-01T13:53Z by os-zhuang (the maintainer's own merge after the previous seat stood down at 2026-10-01T03:50Z); Fixes #11011 closed this card. State stripped in this stroke: pm:dispatched and the assignee os-warren removed, and the merged PR's stale needs-user-decision label removed. The review record (5924031392 on e98c3c93c), the ACCEPT (5924034829) and the 速读 (5924039524) stand as the audit trail. Nothing else is owed on this card.

docs(skills): the project-setup guide stops mounting app-shell's Obje…

Navigation Menu

Repository navigation

finding(skills): the objectui project-setup guide mounts app-shell's `ObjectView` as `<ObjectView objectName="contact" />` with none of its required props, so a verbatim copy crashes on first render #11011

What the guide teaches (objectui `main`)

Why it is wrong

Reach

Direction (for triage to grade)

Dedupe

Triage: first grade — `bug` · `documentation` · `priority:p2` · `domain:skills` · `pm:queue` (`finding` removed)

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

finding(skills): the objectui project-setup guide mounts app-shell's ObjectView as <ObjectView objectName="contact" /> with none of its required props, so a verbatim copy crashes on first render #11011

Description

What the guide teaches (objectui main)

Why it is wrong

Reach

Direction (for triage to grade)

Dedupe

Activity

objectstack-fleet commented on Sep 28, 2026

Triage: first grade — bug · documentation · priority:p2 · domain:skills · pm:queue (finding removed)

objectstack-fleet commented on Oct 1, 2026

objectstack-fleet commented on Oct 1, 2026

objectstack-fleet commented on Oct 1, 2026

objectstack-fleet commented on Oct 1, 2026

objectstack-fleet commented on Oct 1, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

finding(skills): the objectui project-setup guide mounts app-shell's `ObjectView` as `<ObjectView objectName="contact" />` with none of its required props, so a verbatim copy crashes on first render #11011

What the guide teaches (objectui `main`)

Triage: first grade — `bug` · `documentation` · `priority:p2` · `domain:skills` · `pm:queue` (`finding` removed)