Repository navigation
docs(datasource): external-datasource federation guide + objectstack-data skill rule (ADR-0062) - #2211
Merged
Conversation
…ack-data skill rule (ADR-0062)
The ADR-0062 federation runtime ("declare an external datasource → visible,
auto-connected, queryable with zero app code") had no narrative docs. Adds:
- content/docs/guides/external-datasources.mdx — how-to: defineDatasource +
schemaMode, object remoteName/remoteSchema/columnMap binding, auto-connect (D2
gate: external / explicit object.datasource / autoConnect; mapping-only managed
stays metadata-only), onEnable only as a dynamic-driver escape hatch,
credentialsRef fail-closed (D3), no field.columnName on external → use columnMap
(D7), writes double opt-in, analytics over external. Listed in the Integration
nav after Database Drivers. Browser-verified rendering.
- skills/objectstack-data/rules/datasources.md (+ SKILL.md link) — same rules in
the authoring skill, emphasizing the columnMap-not-columnName guardrail.
The autoConnect field is already auto-documented in the generated
references/data/datasource.mdx (from the spec describe()); not hand-edited.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This branch was successfully deployed
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
2 participants
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.
Docs + skill for the ADR-0062 federation runtime
Follow-up to the merged ADR-0062 epic (#2163). The headline capability — declare an external datasource → it's visible, auto-connected, validated, and queryable with zero app code — had no narrative documentation. This adds it.
Added
content/docs/guides/external-datasources.mdx— a how-to guide:defineDatasource({ schemaMode: 'external', external: {...} })datasource+external.remoteName/remoteSchema/columnMapobject.datasource/autoConnect:true; a mapping-only managed datasource stays metadata-only) — noonEnableneededonEnable+ctx.drivers.registeras the dynamic-driver escape hatch onlycredentialsReffail-closed (D3)field.columnNameon external objects → useexternal.columnMap(D7, build-rejected)skills/objectstack-data/rules/datasources.md(+ linked fromSKILL.md) — the same rules in the authoring skill, leading with thecolumnMap-not-columnNameguardrail.Not changed
autoConnect).🤖 Generated with Claude Code