docs: align AI docs with open=MCP-only / in-UI AI=cloud (cloud ADR-0025)#2337
Merged
Conversation
Propagate framework #2325 (service-ai removed from the open framework) across the remaining docs. Canonical decision: cloud ADR-0025 (service-ai -> cloud; open = MCP-only). Disambiguates the cross-repo "ADR-0025" reference, since framework ADR-0025 is plugin-distribution and unrelated. New model documented everywhere: - Open edition (cloud free tier / Docker / desktop / on-prem): no in-product ask/build chat. Data query via @objectstack/mcp (BYO-AI); metadata authoring via source mode + an AI coding agent. - Cloud / Enterprise: in-UI AI runtime (ask + build + in-product chat + /api/v1/ai/*), governed ask, managed/metered AI. User-facing: ai-capabilities (ask edition open->cloud, fixed the ambiguous ADR-0025 ref, added the open-edition two-path callout), plugin-chatbot-integration, environment-variables, knowledge, implementation-status, README (AI bullet -> MCP; drop the dead service-ai Services row), both objectstack-* skills. ADRs: cloud-owned banners on 0033/0038/0040/0063/0064 per cloud ADR-0025 (banners only; ADR bodies preserved as historical record). Left as historical/unaffected: docs/audits/2026-06-*, RELEASE_NOTES.md, ARCHITECTURE.md (spec/ai schemas stay open), apps/docs/app/llms* (generated route handlers), other ADRs' incidental service-ai mentions. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
github-actions
Bot
added
documentation
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
1 participant
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.
What & why
Propagates framework #2325 (
@objectstack/service-airemoved from the open framework) across all the docs that were still describing the old model. The canonical decision lives in cloud ADR-0025 (service-ai → cloud; open = MCP-only, Accepted 2026-06-25).Also fixes a cross-repo reference trap: the old
ai-capabilities.mdxnote said "Per ADR-0025", but framework ADR-0025 isplugin-package-distribution(unrelated) — the decision is cloud ADR-0025. All references now say "cloud ADR-0025" explicitly and link the cloud repo.New model (now stated consistently)
ask/buildchat. Two BYO-AI paths, zero platform AI cost:@objectstack/mcp(Claude / Cursor / local model / any MCP client; RLS-governed; local model keeps data + inference in-boundary).skills/+ MCP introspection).ask+build+ in-product chat +/api/v1/ai/*), governedask, managed/metered AI.Changes (13 files)
User-facing (8)
ai-capabilities.mdx—askedition open→cloud; fixed the ambiguous ADR-0025 ref; added the open-edition two-path callout.plugin-chatbot-integration.mdx,environment-variables.mdx,knowledge.mdx,implementation-status.mdx— cloud/EE tier banners.README.md— AI-service bullet → MCP/BYO-AI; removed the dead@objectstack/service-aiServices row.skills/objectstack-ai/SKILL.md,skills/objectstack-platform/SKILL.md— edition-boundary banner; fixedask=open line;AIServicePluginmarked cloud/EE-only.ADR cloud-owned banners (5) — per cloud ADR-0025:
0033,0038,0040,0063,0064. Banners only — ADR bodies are preserved as historical record.Deliberately left untouched:
docs/audits/2026-06-*(dated snapshots),RELEASE_NOTES.md(historical log),ARCHITECTURE.md(@objectstack/spec/aischemas stay open),apps/docs/app/llms*(generated route handlers), other ADRs' incidentalservice-aimentions.Verification
Docs-only. No stale "ask = open-source/free" claims remain; all
<Callout>tags balanced (Callout is a global Fumadocs component — 295 files use it, 0 import it); added internal links resolve. Full Next.js docs build not run.🤖 Generated with Claude Code