Skip to content

feat(types)!: remove ObjectStack's own legacy env-var aliases (11.0, #2379) - #2383

Merged
os-zhuang merged 1 commit into
mainfrom
v11-remove-env-aliases
Jun 27, 2026
Merged

feat(types)!: remove ObjectStack's own legacy env-var aliases (11.0, #2379)#2383
os-zhuang merged 1 commit into
mainfrom
v11-remove-env-aliases

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Closes#2379. Part of the 11.0 breaking-change batch (#2364).

Scope (per owner decision: remove only ObjectStack's own renames; keep ecosystem standards)

Removed — rename required:

removed legacy nameuse
OS_MULTI_TENANTOS_MULTI_ORG_ENABLED
OBJECTSTACK_METADATA_WRITABLEOS_METADATA_WRITABLE
OS_AUTH_BASE_URL, AUTH_BASE_URLOS_AUTH_URL

Kept (reclassified to silent — permanent conventions, no longer nag):DATABASE_URL, AUTH_SECRET, BETTER_AUTH_SECRET, BETTER_AUTH_URL, PORT, CORS_*, LOG_LEVEL, ROOT_DOMAIN, MCP_SERVER_*.

Changes

  • resolveMultiOrgEnabled reads only OS_MULTI_ORG_ENABLED; sys-metadata-repository only OS_METADATA_WRITABLE; serve auth-url drops the two OS-own aliases (keeps BETTER_AUTH_URL silent).
  • ~15 ecosystem call sites get { silent: true }.
  • Stale comments + plugin-org-scoping/plugin-security READMEs + object.zod/protocol.zod describe text → canonical names.
  • Generic readEnvWithDeprecation helper + env.test.ts unchanged (CHANGELOGs/ADR-0010 left as historical record).

Verification

types env 7, cli 436, objectql 718, driver-sql 234, plugin-auth 175, mcp 53, plugin-hono-server 40 — all green. spec check:api-surface unchanged; 53 build tasks green. No test referenced the removed aliases.

🤖 Generated with Claude Code

…2379)
Removes the framework's own renamed env names; keeps ubiquitous ecosystem
conventions working (now silent, since they're permanent — not deprecated).
Removed (rename required):
- OS_MULTI_TENANT → OS_MULTI_ORG_ENABLED (resolveMultiOrgEnabled)
- OBJECTSTACK_METADATA_WRITABLE → OS_METADATA_WRITABLE (sys-metadata-repository)
- OS_AUTH_BASE_URL / AUTH_BASE_URL → OS_AUTH_URL (cli serve)
Reclassified to silent (kept, no more nag): DATABASE_URL, AUTH_SECRET,
BETTER_AUTH_SECRET, BETTER_AUTH_URL, CORS_*, LOG_LEVEL, ROOT_DOMAIN,
MCP_SERVER_*, PORT.
Also updated now-stale comments + plugin-org-scoping / plugin-security READMEs +
object.zod / protocol.zod describe text to the canonical names. The generic
readEnvWithDeprecation helper + env.test.ts (synthetic names) are unchanged.
Verified: types env (7), cli (436), objectql (718), driver-sql (234),
plugin-auth (175), mcp (53), plugin-hono-server (40) all green; spec
api-surface check unchanged; 53 build tasks green.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercelBot commented Jun 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJun 27, 2026 3:03pm

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

This PR changes 12 package(s): packages/adapters, @objectstack/cli, @objectstack/mcp, @objectstack/objectql, @objectstack/driver-sql, @objectstack/plugin-auth, @objectstack/plugin-hono-server, @objectstack/plugin-org-scoping, @objectstack/plugin-security, @objectstack/runtime, @objectstack/spec, @objectstack/types.

107 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

  • content/docs/concepts/architecture.mdx(via @objectstack/spec)
  • content/docs/concepts/cloud-artifact-api.mdx(via packages/cli, packages/runtime, packages/spec)
  • content/docs/concepts/cluster-semantics.mdx(via @objectstack/spec)
  • content/docs/concepts/core/plugins.mdx(via @objectstack/driver-sql)
  • content/docs/concepts/core/services.mdx(via @objectstack/objectql)
  • content/docs/concepts/design-principles.mdx(via packages/spec)
  • content/docs/concepts/implementation-status.mdx(via @objectstack/cli, @objectstack/mcp, @objectstack/objectql, @objectstack/driver-sql, @objectstack/plugin-auth, @objectstack/plugin-hono-server, @objectstack/plugin-security, @objectstack/runtime, @objectstack/spec)
  • content/docs/concepts/index.mdx(via @objectstack/spec)
  • content/docs/concepts/metadata-driven.mdx(via @objectstack/spec)
  • content/docs/concepts/metadata-lifecycle.mdx(via @objectstack/objectql, packages/spec)
  • content/docs/concepts/north-star.mdx(via packages/runtime, packages/spec)
  • content/docs/concepts/packages.mdx(via @objectstack/cli, @objectstack/mcp, @objectstack/objectql, @objectstack/plugin-auth, @objectstack/plugin-hono-server, @objectstack/plugin-org-scoping, @objectstack/plugin-security, @objectstack/runtime, @objectstack/spec, @objectstack/types)
  • content/docs/concepts/setup-app.mdx(via @objectstack/spec)
  • content/docs/concepts/skills.mdx(via @objectstack/spec)
  • content/docs/concepts/terminology.mdx(via @objectstack/driver-sql)
  • content/docs/concepts/webhook-delivery.mdx(via @objectstack/spec)
  • content/docs/getting-started/architecture.mdx(via @objectstack/spec)
  • content/docs/getting-started/cli.mdx(via @objectstack/cli, @objectstack/plugin-auth, @objectstack/plugin-security, @objectstack/spec)
  • content/docs/getting-started/core-concepts.mdx(via @objectstack/spec)
  • content/docs/getting-started/examples.mdx(via @objectstack/spec)
  • content/docs/getting-started/glossary.mdx(via @objectstack/driver-sql)
  • content/docs/getting-started/quick-start.mdx(via @objectstack/cli, @objectstack/spec)
  • content/docs/guides/adding-a-metadata-type.mdx(via @objectstack/spec)
  • content/docs/guides/ai-capabilities.mdx(via @objectstack/mcp, @objectstack/spec)
  • content/docs/guides/airtable-dashboard-analysis.mdx(via @objectstack/spec)
  • content/docs/guides/analytics-datasets.mdx(via @objectstack/spec)
  • content/docs/guides/api-reference.mdx(via @objectstack/runtime, @objectstack/spec)
  • content/docs/guides/auth-sso.mdx(via @objectstack/plugin-auth)
  • content/docs/guides/authentication.mdx(via @objectstack/cli, @objectstack/objectql, @objectstack/plugin-auth, @objectstack/plugin-hono-server, @objectstack/runtime)
  • content/docs/guides/business-logic.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/backward-compatibility.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/error-catalog.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/field-type-gallery.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/field-validation-rules.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/permissions-matrix.mdx(via packages/plugins/plugin-security, @objectstack/spec)
  • content/docs/guides/cheatsheets/protocol-diagram.mdx(via packages/spec)
  • content/docs/guides/cheatsheets/query-cheat-sheet.mdx(via @objectstack/spec)
  • content/docs/guides/cheatsheets/quick-reference.mdx(via @objectstack/spec)
  • content/docs/guides/client-sdk.mdx(via @objectstack/cli, @objectstack/spec)
  • content/docs/guides/cloud-deployment.mdx(via @objectstack/runtime)
  • content/docs/guides/common-patterns.mdx(via @objectstack/spec)
  • content/docs/guides/contracts/auth-service.mdx(via packages/spec)
  • content/docs/guides/contracts/cache-service.mdx(via packages/spec)
  • content/docs/guides/contracts/data-engine.mdx(via @objectstack/spec)
  • content/docs/guides/contracts/index.mdx(via @objectstack/spec)
  • content/docs/guides/contracts/metadata-service.mdx(via packages/spec)
  • content/docs/guides/contracts/storage-service.mdx(via packages/spec)
  • content/docs/guides/data-modeling.mdx(via @objectstack/spec)
  • content/docs/guides/deployment-vercel.mdx(via @objectstack/objectql, @objectstack/runtime, @objectstack/spec)
  • content/docs/guides/driver-configuration.mdx(via @objectstack/driver-sql, @objectstack/runtime, @objectstack/spec)
  • content/docs/guides/environment-variables.mdx(via @objectstack/mcp)
  • content/docs/guides/error-handling-client.mdx(via @objectstack/spec)
  • content/docs/guides/error-handling-server.mdx(via @objectstack/spec)
  • content/docs/guides/external-datasources.mdx(via @objectstack/spec)
  • content/docs/guides/formula.mdx(via packages/objectql, @objectstack/spec)
  • content/docs/guides/hook-bodies.mdx(via packages/cli, @objectstack/runtime, packages/spec)
  • content/docs/guides/kernel-services.mdx(via @objectstack/objectql, @objectstack/plugin-auth, @objectstack/spec)
  • content/docs/guides/metadata/dashboard.mdx(via @objectstack/plugin-security, @objectstack/spec)
  • content/docs/guides/metadata/field.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/flow.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/index.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/object.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/validation.mdx(via @objectstack/spec)
  • content/docs/guides/metadata/workflow.mdx(via @objectstack/spec)
  • content/docs/guides/objectql-migration.mdx(via @objectstack/objectql)
  • content/docs/guides/packages.mdx(via packages/adapters, @objectstack/cli, @objectstack/mcp, @objectstack/objectql, @objectstack/driver-sql, @objectstack/plugin-auth, @objectstack/plugin-hono-server, @objectstack/plugin-org-scoping, @objectstack/plugin-security, @objectstack/runtime, @objectstack/spec, @objectstack/types)
  • content/docs/guides/plugin-chatbot-integration.mdx(via @objectstack/mcp, @objectstack/runtime)
  • content/docs/guides/plugin-development.mdx(via @objectstack/spec)
  • content/docs/guides/plugins.mdx(via @objectstack/objectql, @objectstack/plugin-auth, @objectstack/plugin-hono-server, @objectstack/plugin-security, @objectstack/spec)
  • content/docs/guides/production-readiness.mdx(via @objectstack/plugin-auth, @objectstack/runtime)
  • content/docs/guides/project-scoping.mdx(via @objectstack/cli, @objectstack/spec)
  • content/docs/guides/public-forms.mdx(via @objectstack/spec)
  • content/docs/guides/runtime-services/data-service.mdx(via packages/cli)
  • content/docs/guides/runtime-services/email-service.mdx(via packages/spec)
  • content/docs/guides/runtime-services/index.mdx(via packages/cli, packages/spec)
  • content/docs/guides/runtime-services/queue-service.mdx(via packages/spec)
  • content/docs/guides/runtime-services/sharing-service.mdx(via packages/spec)
  • content/docs/guides/runtime-services/storage-service.mdx(via packages/spec)
  • content/docs/guides/security.mdx(via @objectstack/plugin-org-scoping, @objectstack/plugin-security, @objectstack/spec)
  • content/docs/guides/seed-data.mdx(via @objectstack/spec)
  • content/docs/guides/single-project-mode.mdx(via @objectstack/runtime)
  • content/docs/guides/skills.mdx(via packages/cli, @objectstack/spec)
  • content/docs/guides/standards.mdx(via @objectstack/spec)
  • content/docs/guides/troubleshooting.mdx(via @objectstack/spec)
  • content/docs/guides/validating-metadata.mdx(via @objectstack/spec)
  • content/docs/protocol/knowledge.mdx(via @objectstack/mcp, @objectstack/spec)
  • content/docs/protocol/objectos/config-resolution.mdx(via @objectstack/spec)
  • content/docs/protocol/objectos/http-protocol.mdx(via @objectstack/runtime)
  • content/docs/protocol/objectos/i18n-standard.mdx(via @objectstack/spec)
  • content/docs/protocol/objectos/index.mdx(via @objectstack/objectql, @objectstack/driver-sql, @objectstack/runtime)
  • content/docs/protocol/objectos/lifecycle.mdx(via @objectstack/driver-sql, @objectstack/runtime, @objectstack/spec)
  • content/docs/protocol/objectos/plugin-spec.mdx(via @objectstack/cli, @objectstack/spec)
  • content/docs/protocol/objectos/realtime-protocol.mdx(via @objectstack/cli)
  • content/docs/protocol/objectos/runtime-capabilities.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/index.mdx(via packages/spec)
  • content/docs/protocol/objectql/query-syntax.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/schema.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/security.mdx(via packages/spec)
  • content/docs/protocol/objectql/state-machine.mdx(via @objectstack/objectql, @objectstack/spec)
  • content/docs/protocol/objectui/actions.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/concept.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/index.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/layout-dsl.mdx(via packages/spec)
  • content/docs/protocol/objectui/record-alert.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/widget-contract.mdx(via @objectstack/spec)
  • content/docs/releases/index.mdx(via @objectstack/spec)
  • content/docs/releases/v9.mdx(via @objectstack/objectql, @objectstack/plugin-auth, @objectstack/spec)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationprotocol:datasize/mtooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[11.0][A3] Remove legacy environment-variable aliases (OS_MULTI_TENANT, …)

1 participant

@os-zhuang