docs: retire the stale "Where this is headed" federation forecast on extend-existing-systems - #257
Merged
os-bill merged 1 commit intoSep 2, 2026
Conversation
`extend-existing-systems.mdx` told readers that turn-key external
datasource federation — one-step schema import, externally owned schema
binding, built-in safety gates — was "in active design" under ADR-0015
with status *Proposed*. Every one of those claims is stale at the source
(objectstack `origin/main` @ 87ad30c):
- ADR-0015's own status line reads "Accepted — backend/REST/CLI
implemented".
- One-step schema import: `packages/cli/src/commands/datasource/`
{introspect,validate,list-tables}.ts; ADR-0062 R7 marked shipped.
- Externally owned schema binding: `SchemaModeSchema`
(`spec/src/data/datasource.zod.ts:238`, wired at :651) and
`ObjectExternalBindingSchema` (`spec/src/data/object.zod.ts:1262`,
wired at :1919); ADR-0062 R1 marked shipped.
- Safety gates: `runtime/src/external-validation-plugin.ts` (R6) and the
double opt-in write gate (R5c), both marked shipped.
The section is removed rather than rewritten. The page already routes the
reader correctly: "Start here" links /docs/configure/data-sources, and
that page carries the pointer to the framework guide that owns this
surface. Re-describing federation here would make this the third page
describing it — the mirror follows, it does not lead.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ChPQM8jamxLUfUAxwFpJ8S
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #254
content/docs/extend-existing-systems.mdxtold readers that turn-key externaldatasource federation — one-step schema import, externally owned schema binding,
built-in safety gates — was "in active design" under ADR-0015 with status
Proposed, and that "until it lands" the manual path was the supported way. Every
one of those claims is stale at the source.
Measured on
objectstackorigin/main@87ad30cThe card's table was taken at
2514d49; upstream moved, so each leg was re-run atthe current tip rather than carried over. All five hold, at the same line numbers.
**Status**: Accepted — backend/REST/CLI implemented; Studio UI + extra dialect drivers pendingpackages/cli/src/commands/datasource/{introspect,validate,list-tables}.tsall present; ADR-0062 R7 row reads✅ shippedSchemaModeSchemaatpackages/spec/src/data/datasource.zod.ts:238, wired at:651;ObjectExternalBindingSchemaatpackages/spec/src/data/object.zod.ts:1262, wired at:1919; ADR-0062 R1 row reads✅ shippedpackages/runtime/src/external-validation-plugin.tspresent; ADR-0062 R6 and R5c rows both read✅ shippedcontent/docs/data-modeling/external-datasources.mdx, whose stated headline guarantee is "declare an external datasource and it is visible, auto-connected, validated at boot, and queryable — with no application code"One leg initially returned zero hits and was control-probed rather than reported:
the rollout ADR is
docs/adr/0062-external-datasource-runtime.md, not the-rolloutfilename the search assumed. Re-run against the real file, the fourrows above are present.
Why the section is deleted rather than rewritten
This page already routes the reader correctly, so a replacement paragraph would
have been the third page describing one surface. Verified on current
main, notassumed:
/docs/configure/data-sources(the body links ittwice more, at "Connect the existing database as a datasource" and under
"Generating objects with a coding agent");
configure/data-sources.mdxcarries the pointer to the framework guide as of1034f5f— confirmed by rendering that page locally, wheredata-modeling/external-datasourcesappears in the served HTML.So the reader reaches the owning guide in two hops, and this page makes no
federation claim of its own to go stale again. That follows #250's adjudication as
landed in
1034f5f: the mirror follows, it does not lead.Nothing unique is lost. The section's closing clause ("the documented path —
connect, model, bind, query") restates "The shape of the move" at the top of the
same page, which is unchanged.
Per the card, the diff makes no claim about which dialect drivers or Studio
surfaces remain pending. That forecast is what this lane keeps deleting, and a
smaller version of it here would be the third occurrence.
Locale siblings deliberately untouched
The seven siblings (
.de,.es,.fr,.ja,.ko,.zh-Hans,.zh-Hant) arebyte-identical to base — each one's blob sha at HEAD equals its blob sha at
origin/main. They are generated artifacts, AGENTS.md forbids hand-editing them,and what to do about the stale claim they inherit is an open decision on #256 that
governs them as a class across both pages. Not this PR's call, and left alone
deliberately rather than by oversight.
They were already stale before this diff, so the freshness gate's report is not
a new debt: the recorded
source_shain the siblings' frontmatter(
42c3777f…) does not match the sha256 of the English page atorigin/main(
e2431d53…). Per AGENTS.md that staleness is reported, not blocking.Local gates — all at
76579e5, this PR's headUnion re-run after the final commit, on a tree where
git statusis empty (so thetested tree is exactly the committed one). Quoting each gate's own verdict line,
not a bare exit code:
apps/docs/scripts/gen-zh-hant.mjs --check✓ zh-Hant: 73 generated file(s) match the zh-Hans sources byte for byte.check-translations.mjs✓ translations gate passedcheck-translation-ownership.mjsThis PR touches 0 translation artifact(s) and 1 other file(s).— report-only,TRANSLATION_BOT_LOGINis unsetcheck-node-floor.mjs --self-test✓ self-test: 17 rule case(s), 24 satisfies case(s) and 18 range case(s) — every rule demonstrated able to failcheck-node-floor.mjs✅ Every declared floor clears what the dependency tree requires, and the declarations agree.turbo run type-check --continueTasks: 1 successful, 1 total(tsc --noEmitexecuted on the pre-commit run of the identical tree; cache hit at76579e5)turbo run buildTasks: 1 successful, 1 total(same: executed pre-commit, cache hit at76579e5)check-locale-surface.mjs✓ every advertised URL has a source file and every source file is advertised—sitemap.xml409 read / 409 expected / 0 unexpected / 0 missingturbo run testTasks: 1 successful, 1 total;✓ self-test: 18 case(s) over 10 rule(s) and 3 artifact(s) — every rule demonstrated able to failBuild emits
Failed to load dynamic font … self-signed certificate in certificate chainfor the OG-card fonts. That is this container's egress proxy, unrelated tothe diff, and the build task still reports success.
Render check
Dev server on port 3254, page fetched over HTTP (HTTP 200, 114042 bytes). After the
edit the served HTML contains zero occurrences of
Where this is headed,turn-key federation,Proposed,in active design, and0015-external-datasource-federation. Those zeros were control-probed against thetwin page served from the same process, where the same needles return 2 — so the
zeros are real absences, not a grep that cannot match. Rendered
h2ids are nowthe-shape-of-the-move,why-this-works-without-a-rewrite,generating-objects-with-a-coding-agent,what-you-get-on-day-one,start-here.No file in the repo references the removed
#where-this-is-headedanchor.No changeset: this repo has no
.changeset/directory and publishes no packages.🤖 Generated with Claude Code
https://claude.ai/code/session_01ChPQM8jamxLUfUAxwFpJ8S
Generated by Claude Code