fix(spec): re-point dead #6590 citations to the live v18 tracker #11509

[os-steve]

Fixes#11269

Two comment-prose sites in packages/spec/src/ui/component.zod.ts anchored a v18 direction-B decision (retire the flat object/filter data-binding family, dataSource as the single data-binding door) to #6590, which now 404s (deleted/transferred/converted — undeterminable, per #11269's measurement). The triage seat filed #11509 as the resolvable re-anchor tracker. This PR re-points both citations.

What changed

Citations only — the zod shapes are byte-identical, the two-line diff is entirely comment prose:

• component.zod.ts:137 — // v18 as #6590 — not rejected. → // v18 as #11509 — not rejected.
• component.zod.ts:1896 (now :1919 after rebasing past docs(spec): visibleWhen's describe states the bound roots per ADR-0068 (was three of nine) #11600, below) — tracked as #6590 for v18 → tracked as #11509 for v18

No breadcrumb (re-anchor of deleted #6590) added to either site: the swapped sentence is fully true on its own (#11509is the v18 direction-B tracker), and the historical link back to #6590 is already preserved at the issue level — #11509's own title and body record it as "re-anchor of the deleted #6590 tracker".

Repo-wide under packages/spec/src, grep for 6590 found exactly these two sites (matching #11269's measurement); zero remain after the edit. The only other repo hit is packages/spec/CHANGELOG.md (historical release-note text, generated/append-only — correctly left untouched).

Neither site is inside a .describe() string

Line 137 is a // line comment inside a top-level architecture note (not attached to any schema). Line 1896 is inside a /** */ JSDoc block that precedes an export but is plain source comment, not a .describe(...) call — build-docs.ts extracts descriptions from the runtime zod schema's .description (populated only by .describe()), and has no JSDoc-scraping path. Confirmed empirically: check:generated reports all 14 generated artifacts still up to date after the edit (zero regeneration diff), so no .mdx reference doc needed touching.

The #9249 landing note

#9249's triage ruling assigned its PM a landing-time step: "leave the subsumption note on hold #6590" — undeliverable to a 404. That note is delivered as a comment on #11509 (the resolvable home), not here — out of this PR's file surface: #11509 (comment)

Changeset: skip-changeset, not a changeset file

The repo's convention for comment-only spec diffs picks the changeset route by whether the diff touches a .describe() string: #11215/PR #11593 used a patch changeset because its diff regenerated docs. This diff does not — check:generated confirms zero doc regeneration (see above) — so it falls in the "pure comment diff" carve-out and uses the skip-changeset label (#11416/#11403 precedent) instead. Label applied at PR creation via the additive labels endpoint per AGENTS.md; read back below.

Verification

Gate list derived mechanically: node scripts/pm/dispatch-gates.mjs --repo objectstack-ai/objectstack (provenance: this checkout at 5fba383c64). All commands' exit codes captured before any pipe; quotes below are each gate's own printed verdict line.

• pnpm --filter @objectstack/spec build — exit 0.
• pnpm --filter @objectstack/spec check:generated — ✓ All 14 generated artifacts are up to date.
• pnpm --filter @objectstack/spec test — Test Files 420 passed (420) / Tests 11213 passed (11213).
• pnpm --filter @objectstack/spec typecheck — check:test-typecheck: OK.
• Local gate families matched by the diff, all green: check:cross-package-test-inputs, check:merge-driver, check:published-files, check:slot-lookup, check:spec-parsed-alias, check:test-source-alias, check:type-source-resolution, check:doc-formula-expressions (lint), check:empty-state, check:liveness, check:strictness-ledger, check:variant-docs (spec-liveness-check family), check-ci-filter-parity, check-cross-package-test-inputs, check-plugin-teardown-shape, check-affected-docs.
• check:dev-prereqs — not cleared locally, by design. It fails on a workspace-build precondition (this worktree has only @objectstack/spec built), not on anything in this diff; PR docs(spec): visibleWhen's describe states the bound roots per ADR-0068 (was three of nine) #11600 (same lane, landed just before this one) treated it identically: "a repo-scale run CI performs before its gates," not runnable meaningfully in a single-package worktree.
• Whole-repo pnpm lint is CI-owned, not run locally; no lint-rule surface touched by a two-line comment diff.

Sibling-PR rebase

This branch shares its file (component.zod.ts) with PR #11600 (PageTabsProps.visibleWhen region, lines ~662–700), a disjoint hunk. Per the PM's guidance this PR was held un-opened until #11600 merged (644ad5043e, confirmed via polling before this branch was pushed), then rebased onto the new origin/main — a clean rebase, no conflicts, as expected from the disjoint hunks. The rebase shifted the second citation site from :1896 to :1919 (+23 lines from #11600's own docblock expansion above it); line 137 is unaffected (before #11600's insertion point). build / check:generated / test / typecheck were all re-run on the rebased head (5fba383c64) and are the results quoted above — not carried over from the pre-rebase run.

Fences honored

• content/docs/releases/: untouched.
• No shape/behaviour change: zod shapes byte-identical, confirmed by diff and by check:generated.
• #11509 touched by exactly one comment (the delivered landing note above), nothing else.

---

Generated by Claude Code

[github-actions]

📓 Docs Drift Check

Nothing in this diff resolved to a documentable surface (no symbol, route or SDK anchor derived from 1 changed package(s)), so this run has no opinion about the docs.

What this run could not see

• 1 changed file(s) yielded no anchor (packages/spec/src/ui/component.zod.ts) — pages documenting those are invisible to this run

Coarse fallback — 126 page(s) merely mention a changed package (the pre-#9192 predicate, kept for the deliberately-wide backstop): node scripts/docs-audit/affected-docs.mjs --json 2cf5a96cc77cc4a7b64c2512246ac1e121f348d8 → packageMentionDocs.