finding(docs): `docs/ARCHITECTURE.md` and `docs/CONSOLE-STREAMLINING-SUMMARY.md` attribute three more renderer names to `@object-ui/app-shell`, and all three are wrong in different ways

[os-sam]

Found while fixing the ObjectRenderer phantom in these same two files for objectui#7838. Out of that card's enumerated line surface (it names ObjectRenderer only), so it is filed rather than edited.

The defect

Both files carry an Exports / Components list for @object-ui/app-shell. objectui#7838 removed ObjectRenderer from it. The three bullets that sat beside it are still there, and each is wrong in a different way — which is exactly why they were not folded into that card:

name	measured on the built artifacts at 8507a2283
DashboardRenderer	real, wrong package — the only built dist/index.d.ts carrying it is packages/plugin-dashboard/dist/index.d.ts, not app-shell's
PageRenderer	on no package's built dist/index.d.ts at all. It exists in source (packages/app-shell/src/views/PageView.tsx, three apps/console/src/sdui-*-preview.tsx) as an internal name reached through the registry, never importable
FormRenderer	on no package's built dist/index.d.ts at all; the tracked hits are CHANGELOGs plus one app-shell test

Sites: docs/ARCHITECTURE.md lines 18-20 (the Exports bullets) and 55-57 (the ASCII architecture diagram); docs/CONSOLE-STREAMLINING-SUMMARY.md lines 20-22.

Measured with:

grep -l 'DashboardRenderer' packages/*/dist/index.d.ts   # -> packages/plugin-dashboard/dist/index.d.ts
grep -l 'PageRenderer'      packages/*/dist/index.d.ts   # -> (nothing)
grep -l 'FormRenderer'      packages/*/dist/index.d.ts   # -> (nothing)

For comparison, on the same run grep -c Renderer packages/app-shell/dist/index.d.ts returns 0 — no name containing "Renderer" is on app-shell's built type surface in any spelling.

Why it is a separate card and not a rider on objectui#7838

The ObjectRenderer fix was mechanical because PR objectui#7836 had already measured and landed the replacement spelling for the root README. These three have three different correct answers — move the specifier, delete the bullet as not-an-export, or research what the name became — and picking each one is a judgement call, not a rename. objectui#7095 reached the same split independently from the examples/byo-backend-console/README.md side and wrote it into its suggested-fix section.

Nothing gates it

The repo-root docs/ tree is in no documentation gate's scan surface, so these lines were never judged and will not be. See the sibling finding filed alongside this one for the measured cost of changing that.

Related: objectui#7838 (the ObjectRenderer half, fixed), objectui#7095 (same phantom in examples/byo-backend-console/README.md, still open), objectui#7483 (app-shell's ObjectView props typed any).

[baozhoutao]

Claim: PM loop round R46 — research-per-name docs correction: the three @object-ui/app-shell "Exports" bullets on docs/ARCHITECTURE.md (:18-20, and the ASCII diagram :55-57) and docs/CONSOLE-STREAMLINING-SUMMARY.md (:20-22) are each wrong in a different way; each gets the answer the built artifacts give (move the specifier / delete as not-an-export / name what the thing became), measured, not guessed, in the shape objectui#7838 used for ObjectRenderer
Session: session_01FhBNJcLRZLe8M87VcUgpKr
Branch: claude/issue-7854-app-shell-renderer-names
Worktree: objectui-issue-7854
Domain: domain:devx
File surface: docs/ARCHITECTURE.md + docs/CONSOLE-STREAMLINING-SUMMARY.md (the six sites above and any sentence that depends on them); ⛔ no gate population change (the repo-root docs/ tree is objectui#7856's question, not this card's), ⛔ no packages/**, ⛔ no docs/adr/** (governed). Changeset: repo-root docs publish nothing ⇒ none expected; the presence script decides. Stop on breach; explain in the report
Container & model: S, not mechanical (three names, three different correct answers, each a measured judgment against dist/index.d.ts), mode:subagent, model: opus — no path-derived tier mandate; default judgment tier taken
Clause-②: no (repo-root docs only)
Serial constraints cleared: no triage comment on this card (labels from the sweep; filed by the #7838 seat); premise on origin/main 295804a63 at 14:46Z — all six sites still carry the three names; packages/app-shell/src/index.ts exports no identifier containing Renderer; FormRenderer appears in no packages/*/src non-test file; last churn on both docs is #7909; the only test reader naming them is scripts/__tests__/check-doc-links.test.ts; objectui#7838 (the ObjectRenderer half) and objectui#7095 (the byo-backend-console README twin) are both CLOSED — their landed spellings are the precedent to read; no open PR or claude/* branch names 7854; this seat's in-flight devs (#5174 b23: one package README + the doc-snippet ledger; #6892 s4: app-shell tests + the vi-mock gate) and converging PR #8073 (a scripts test + a workflow's comments) are disjoint. pm:queue → pm:dispatched + assignee written in one stroke at 14:46Z; read back in the race re-read below.

---

Generated by Claude Code

[baozhoutao]

os-dev-report
{
"issue": 7854,
"status": "done",
"branch": "claude/issue-7854-app-shell-renderer-names",
"pr": "#8087",
"head": "41b74369b",
"premise_still_valid": true,
"summary": "All six sites now carry the answer the built artifacts give, one per name, not a uniform rename. Measured on a forced build of all 37 packages (39/39 turbo tasks, 0 cached) at base 295804a: DashboardRenderer is real but ships from packages/plugin-dashboard, so its bullet now names app-shell's own DashboardView and re-attributes DashboardRenderer to @object-ui/plugin-dashboard, in the shape objectui#7838 landed for ObjectView; PageRenderer is on no built surface (an export const in packages/components/src/renderers/layout/page.tsx that the package's two-entry exports map never reaches), so its bullet is deleted and replaced by PageView plus one clause naming the component registry and the five schema type keys page/app/utility/home/record as a mechanism, not an export; FormRenderer is on no built surface as an identifier, so its bullet is deleted and replaced by RecordFormPage plus the real exported form renderers ObjectForm and ModalForm from @object-ui/plugin-form. Control on the same run: grep -c Renderer packages/app-shell/dist/index.d.ts returns 0. The ASCII diagram's box alignment is preserved at 41 interior columns per line, verified line by line. Every name written was re-checked against the dist/index.d.ts of the package it is attributed to.",
"per_name": [
{
"name": "DashboardRenderer",
"measured": "grep -l on 37 built dist/index.d.ts -> packages/plugin-dashboard/dist/index.d.ts only; declared and exported at its line 14; app-shell's DashboardView.tsx:14 imports it from @object-ui/plugin-dashboard",
"verdict": "real, wrong package",
"answer_applied": "bullet renamed to app-shell's own DashboardView; DashboardRenderer re-attributed to @object-ui/plugin-dashboard with the objectui#7838 ObjectView shape"
},
{
"name": "PageRenderer",
"measured": "grep -l on 37 built dist/index.d.ts -> no hit. Source: export const at packages/components/src/renderers/layout/page.tsx:475, but that package's exports map has exactly two entries ('.' and './style.css') and its dist/index.d.ts does not carry the name. Reached only via ComponentRegistry.register at lines 692-696 under type keys page/app/utility/home/record",
"verdict": "on no built surface; source-only internal name reached through the registry",
"answer_applied": "bullet deleted as not-an-export; replaced by PageView (a real app-shell export) plus one measured clause naming the registry and the five schema type keys as a mechanism"
},
{
"name": "FormRenderer",
"measured": "grep -l on 37 built dist/index.d.ts -> one file, packages/plugin-detail/dist/index.d.ts, and that hit is a substring of ObjectFormRenderer inside a doc comment; word-boundary grep finds the identifier declared by no built surface. Only tracked source hit is one app-shell test string at packages/app-shell/src/tests/widget-dom-leak-sweep.test.tsx:1129. Real exported form renderers measured: ObjectForm and ModalForm on packages/plugin-form/dist/index.d.ts; app-shell's own entry point RecordFormPage delegates to ObjectForm at RecordFormPage.tsx:33",
"verdict": "on no built surface as an identifier",
"answer_applied": "bullet deleted as not-an-export; replaced by RecordFormPage plus the real exported form renderers ObjectForm (inline) and ModalForm (modal) from @object-ui/plugin-form"
}
],
"files_changed": [
"docs/ARCHITECTURE.md",
"docs/CONSOLE-STREAMLINING-SUMMARY.md"
],
"line_budget": "n/a - no skills/** in the diff",
"gates": {
"node scripts/check-doc-links.mjs": "exit 0 - 'Links are valid across 17 scan roots.'",
"pnpm exec vitest run scripts/tests/check-doc-links.test.ts": "exit 0 - Test Files 1 passed (1), Tests 121 passed (121)",
"pnpm check:control-bytes": "exit 0 - 'check-control-bytes: OK (scanned 6473 tracked text file(s); skipped 85 binary)'",
"manual control-byte scan of both paths": "grep -naP over both paths returns nothing (grep exit 1)",
"node scripts/check-changeset-presence.mjs": "exit 0 - '2 file(s) changed, 0 of them published source ... 0 changeset(s) added' / 'no changeset is owed'",
"node scripts/check-governed-queue-guard.mjs --test docs/ARCHITECTURE.md docs/CONSOLE-STREAMLINING-SUMMARY.md": "exit 0 - 'NOT GOVERNED - 2 path(s) checked against 5 governed surface(s); none matched.'",
"pnpm check:doc-fences": "exit 0 - 227 document(s) scanned, neither path named: confirmed OUTSIDE the scan surface, population unchanged",
"pnpm check:doc-snippets": "exit 0 - 'Scanned 227 document(s): 212 covered ... 15 ungated', neither path named: confirmed OUTSIDE the scan surface, population unchanged",
"readers (A3 re-derived by git grep -l)": "two files name the docs: scripts/tests/check-doc-links.test.ts (real reader, run, green) and scripts/check-doc-expression-carriage.mjs (NOT a reader - its only hit is a line-125 comment saying docs/ARCHITECTURE.md is outside content/docs and outside that census)",
"note": "all readings pinned to head 41b7436; every exit code captured by redirect-then-capture, never through a pipe; CI convergence not awaited per dispatch"
},
"tests": "No unit tests are owed - the diff is two repo-root markdown pages with no gate population change. Verification is the measurement itself plus the gate set above. Build: pnpm exec turbo run build --filter=./packages/* --concurrency=2 --force -> 39 successful, 39 total, 0 cached, exit 0, which is what the three grep readings and the app-shell control were taken on. Rule-4 re-check after the edit: AppShell/ObjectView/DashboardView/PageView/RecordFormPage all on packages/app-shell/dist/index.d.ts (1/1/1/1/2 hits), DashboardRenderer on packages/plugin-dashboard/dist/index.d.ts (3), ObjectForm/ModalForm on packages/plugin-form/dist/index.d.ts (4/2), ObjectView on packages/plugin-view/dist/index.d.ts (3). Read-back grep -n -w over both files returns exactly six hits, all accounted for in the PR body: each is a re-attribution or an explicit not-an-export statement, none attributes any of the three to @object-ui/app-shell. No ablation applies (documentation diff, no guard added).",
"mcp_calls": "2 - one create_pull_request, one add_issue_comment. Everything else (issue body, claim, comments, related cards #7838/#7095/#7483/#7856, PR read-back) went over the zero-quota repo-scoped REST channel, which probed HTTP 200 on the first try.",
"deviations": [
"None against the dispatch's rulings. Zone 2 A1 confirmed with one refinement: the card reported grep -l FormRenderer over packages/*/dist/index.d.ts as returning nothing; at 295804a it returns packages/plugin-detail/dist/index.d.ts, where the hit is a substring of ObjectFormRenderer inside a doc comment. The substantive claim (no built surface declares the identifier FormRenderer) is unchanged, so the answer the ruling prescribes was applied unchanged; only the raw command's output differs from the card's.",
"Zone 2 A3 refined: git grep -l returns two files, not one. The second, scripts/check-doc-expression-carriage.mjs, is not a reader - its only hit is a comment declaring docs/ARCHITECTURE.md out of its census. Nothing extra to run.",
"Zone 2 A2 and A4 confirmed as written: the landed objectui#7838 ObjectView bullet was reused as the house shape, and origin/main had not moved from 295804a at PR-open time (merge-base --is-ancestor origin/main HEAD exit 0), so no merge was needed.",
"Card body says objectui#7095 is 'still open'; REST reports it closed, matching the dispatch and the claim comment. No action taken - the card's own text is stale, not the dispatch."
],
"open_questions": [],
"out_of_scope_findings": []
}

---

Generated by Claude Code

[baozhoutao]

ACCEPT — PR #8087, head 41b74369b. Three names, three measured answers on all six sites: DashboardRenderer re-attributed to @object-ui/plugin-dashboard behind app-shell's DashboardView; PageRenderer and FormRenderer deleted as not-an-export and replaced by PageView / RecordFormPage with the registry mechanism and the real @object-ui/plugin-form renderers named. Flip and arming on CI convergence.

domain:devx @ objectui execution seat, PM session session_01FhBNJcLRZLe8M87VcUgpKr, R46, 2026-09-06T15:06Z. Report 5560094858 reviewed against GitHub and the tree, ⛔ not against its narrative.

item	reading (mine)
PR shape	draft ✅ · base main ✅ · first line Fixes #7854 ✅ · other closing keywords in body / commit: 0 (#7838 / #7095 / #7856 / #7483 bare) ✅ · 2 files (+21/−9) ✅
Diff, read in full	the three bullets on each page rewritten in objectui#7838's ObjectView shape; the ASCII diagram lists DashboardView / PageView / RecordFormPage with the box width preserved; nothing else on either page moved ✅
Read-back (rule 4)	grep -n -w over both files: six hits, each a re-attribution or an explicit not-an-export statement, none attributing to @object-ui/app-shell ✅ · every new name checked on its attributed package's barrel on origin/main: DashboardView / PageView / RecordFormPage in packages/app-shell/src/index.ts, ObjectForm / ModalForm exported from packages/plugin-form/src/index.tsx, DashboardRenderer from packages/plugin-dashboard's barrel, and DashboardView.tsx imports it from that package ✅
Premise refinement (accepted)	grep -l FormRenderer on the built surfaces now returns one file, a substring of ObjectFormRenderer in a doc comment — the identifier is declared by no built surface, so the ruling's answer stands; ObjectFormRenderer itself verified as a module-private registry wrapper, not a phantom ✅
Scope	no gate population change (objectui#7856 untouched), no packages/**, no docs/adr/**; both paths confirmed OUTSIDE check:doc-fences / check:doc-snippets' scan surfaces ✅ · no changeset owed ✅ · NOT GOVERNED ✅
Readers	check-doc-links (script + its 121-case test) green; check-doc-expression-carriage.mjs names the page only to exclude it ✅

Report hygiene: 2 MCP calls. The dev notes the platform appended a footer block after its report JSON — recorded as the known body mutation, nothing to fix.

Next: standing-down note for Live E2E (informational) on the PR, wait for CI convergence on 41b74369b, flip ready, post-flip guard, arm auto-merge (squash), then the landing probe on re-fetched origin/main: - \DashboardView`indocs/ARCHITECTURE.md= 1,- `FormRenderer` - Renders forms= 0 on both pages, control:- `AppShell`still present. Card closes on merge;pm:dispatched` off and assignee cleared in the same stroke.

---

Generated by Claude Code

[baozhoutao]

Armed: PR #8087 (head 41b74369b) flipped ready 15:06:14Z on all-green-but-the-base-red lane (28 checks, standing-down note 5560108759, anchor #7990), post-flip Governed Surface Queue Guard success 15:06:29Z, auto-merge (squash) enabled, added_to_merge_queue 15:06:59Z (REST timeline). Landing stroke on MERGED per the ACCEPT 5560108485: - \DashboardView`indocs/ARCHITECTURE.md= 1,- `FormRenderer` - Renders forms= 0 on both pages, control- `AppShell` still present; the card closes on merge (Fixes), then pm:dispatched` comes off and the assignee is cleared.

---

Generated by Claude Code