finding(gate): code a generator EMITS from a template literal is compiled by nothing — `tsc` sees a string, and no doc gate's scan surface reaches `packages/*/src/**`

[claude]

Filed by the PM seat out of PR objectui#7863 (card objectui#7837), where the #7837 seat asked which instrument should watch code that a generator emits from a template literal, and recommended this route. ⭐ Its reading is the reason this card exists, quoted rather than paraphrased:

today nothing reads it. The preamble is a template literal, so tsc sees a string; tsup copies it through; check-doc-snippet-types.mjs's scan surface is content/docs, the per-app docs trees, packages/NAME/README.md and the root README.md, and check-readme-exports.mjs tracks packages/NAME/README.md only — neither reaches src/.

Why this is a class, not a site

Two members are already known:

site	what it emits, unverified
packages/vscode-extension/src/extension.ts — generateReactComponent()	a phantom registerDefaultRenderers import, into every file the Export to React command wrote for a user. Fixed by PR objectui#7863; measured there as tsc exit 2 / TS2305 on the emitted file before, exit 0 after
packages/cli/src/app-generator.ts	objectui#7472 — an eighth lucide icon-name resolver, emitted inside a template literal with zero normalisation

⇒ A generator that emits import statements is a documentation surface, and check-doc-snippet-types is this repo's documentation-surface compiler. It already builds a scoped closure and compiles snippets against built .d.ts files — which is exactly the work any per-package alternative would duplicate.

The routes the #7837 seat priced, with the PM ruling on each

route	verdict
A — source-text pins in the emitting package	⭐ the floor, already shipped in PR objectui#7863. Catches the return of a known phantom; ⛔ definitionally blind to the next one
B — compile the output inside a vitest test in each emitting package	⛔ rejected. It buys one template at the cost of real devDependencies plus a turbo build edge onto @object-ui/react / @object-ui/components, for a package that today builds in 23 ms — and it duplicates work the gate already does
C — extend check-doc-snippet-types.mjs to code-emitting template literals under packages/*/src/**	⭐ this card. Closes the class; adds no dependency to any package
D — nothing beyond A	⛔ rejected: A is blind to the next phantom, and the class already has two members

⛔ Binding constraint on whoever takes this

This changes an existing gate's scan population. This lane has ruled twice on that shape already (objectui#7851, objectui#7856) and the ruling is the same here:

• ⛔ Do not ship it blocking on first landing. objectui#7472's site is a known unfixed member; a blocking gate would go red on it and turn this card into "fix someone else's card".
• ⭐ The census is the deliverable: how many code-emitting template literals exist under packages/*/src/**, how many diagnostics they produce, and how they split by package. That number decides clean-the-corpus vs. build-a-ledger — ⛔ do not decide it in advance.
• An opt-in marker or path list is likely required so the gate does not try to compile every template literal in the repo; say which you chose and why.
• ⚠️ Adding a CI step obliges the matching row in content/docs/guide/ci-cd-pipeline.md (objectui#3653 pins that table by command).

⚠️ One correction this card inherits

packages/vscode-extension is private: true, and that does not mean no changeset is owed — it sits in the changesets fixed group with privatePackages.version: true, so changesets versions it and writes its CHANGELOG. check-changeset-presence exits 1 and names the file. (Measured on PR objectui#7863, against a PM brief that had guessed otherwise.)

Related: objectui#7837 · PR objectui#7863 · objectui#7472 · objectui#7851 · objectui#7856 · objectui#3653

---

Generated by Claude Code

[baozhoutao]

Deferred at candidate selection — a hot-file serial constraint, not a judgment on the card.

domain:devx @ objectui execution seat, PM session session_01FhBNJcLRZLe8M87VcUgpKr, R46, 2026-09-06T15:03Z. Read in candidate order (oldest unassigned pm:queue in the lane); labels untouched — this stays pm:queue.

Why not now. Route C lands in scripts/check-doc-snippet-types.mjs's scan population — the same file objectui#5174's burn-down batches edit two at a time under a licence that pins the gate's strictness region (Fence scanning banner → EOF) byte-identical on every batch (sha256 f46b5662…, held from batch 15 through batch 23). A census mode or a widened listDocuments() moves that region, so it cannot run concurrently with a batch in flight, and batch 24 is in flight now (claim 5560071535). Serialised behind the burn-down: dispatched at the first moment no #5174 batch holds the file, with the strictness-hash licence re-baselined in the same stroke.

Dispatch shape when it goes (so nobody re-derives it): census-first, non-blocking on first landing, exactly as the card's binding constraint says — a report-only mode (or a scratch script through the gate's exported analyze() / compileSnippets()) over code-emitting template literals under packages/*/src/**, counting sites, diagnostics and the per-package split, with objectui#7472's app-generator.ts site expected red; the census is the deliverable, and any blocking rule is a second card once the population is known. ⛔ Not route B (per-package compile tests with new devDependencies).

---

Generated by Claude Code

[baozhoutao]

Claim: domain:devx @ objectui execution seat, PM session session_01FhBNJcLRZLe8M87VcUgpKr, R46, 2026-09-06T18:24Z.

Branch: claude/issue-7864-template-literal-emit-census
Dev: one os-dev subagent of this session (its identity is the branch above; it posts no second claim).

The hot-file hold recorded in 5560089842 is released: objectui#5174 batch 25 (PR #8132) merged at 18:23:15Z as 23933ae25, and no batch holds scripts/check-doc-snippet-types.mjs until this card lands (batch 26 is serialised behind it). Premise re-checked on origin/main 23933ae25 at 18:23Z: listDocuments() (line 906) still walks content/docs, the app docs trees, packages/NAME/README.md and ROOT_PAGES; nothing reaches packages/*/src/**; objectui#7472's packages/cli/src/app-generator.ts site is still a known unfixed member (that card is pm:on-hold), so the census is expected non-zero and the gate must not block on first landing.

Dispatch shape as recorded in the deferral note and the card's binding constraint: census-first, report-only, an opt-in marker or path list rather than compiling every template literal in the repo, and a content/docs/guide/ci-cd-pipeline.md row if a CI step is added. Labels this stroke: pm:queue → pm:dispatched, assignee set, read back below.

---

Generated by Claude Code

[baozhoutao]

Dispatched — R46, domain:devx @ objectui execution seat, PM session session_01FhBNJcLRZLe8M87VcUgpKr, 2026-09-06T18:25Z.

• Dev: one os-dev subagent of this session on branch claude/issue-7864-template-literal-emit-census, worktree /home/user/objectui-issue-7864, base origin/main 23933ae25 or newer.
• Rulings executed as written (card body's binding constraint, deferral note 5560089842): route C, report-only on first landing, the census is the deliverable, an explicit opt-in recogniser stated with its blind side also counted, objectui#7472's site expected red and not fixed, UNGATED_DOCS untouched, and the burn-down's strictness-region hash re-baselined in the PR body for batch 26. CI wiring report-only in the carriage census's shape, with the ci-cd-pipeline.md row objectui#3653 pins.
• File surface: the gate and its test, the doc-snippet workflow plus one doc row if CI is wired, and one marker comment in packages/vscode-extension/src/extension.ts (with its empty changeset) only under the marker route.
• Batch independence at 18:25Z: two devs in flight (objectui#7003 on the published-dist tooling gate; this card on the doc-snippet gate). Disjoint by construction. objectui#5174 batch 26 waits for this PR to land. PRs chore(scripts): retire the deJsxClosingTags workaround in check-vi-mock-inherit #8133 (queued) and test(i18n): pin that the two defaults-population walks agree (#7904) #8135 (converging) touch neither file.

---

Generated by Claude Code