Skip to content

docs(adr): true up ADR-0093 to as-built (descope console banner, ratify migration scope) - #2919

Merged
os-zhuang merged 1 commit into
mainfrom
claude/adr-0093-doc-truing
Jul 14, 2026
Merged

docs(adr): true up ADR-0093 to as-built (descope console banner, ratify migration scope)#2919
os-zhuang merged 1 commit into
mainfrom
claude/adr-0093-doc-truing

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Docs-only follow-up after ADR-0093 shipped (#2884 / #2887). Keeps the ADR honest with what was actually built and decided — no code.

Why

Two spots in ADR-0093 described an intended state that the implementation deliberately diverged from. Left as-is, a future contributor would "finish" work that was consciously descoped, or read a migration as incomplete when it's ratified.

Changes

1. D5 — descope the Setup-dashboard degraded banner.
The ADR promised degraded branding on "boot banner, /auth/config, and the Setup system-overview dashboard." Per product decision, the console banner is cut: it lives in objectui (separate repo/build), and this is an extreme misconfiguration a CE self-host only reaches by explicitly opting past a boot-time refusal — the terminal warning + the API flag reach the operator who set the flag. features.degradedTenancy stays in /auth/config (zero-cost) so a console can add a banner later without more framework work, but shipping that UI is out of scope. (Mirrored in tenancy-modes.mdx.)

2. D4 — record actual consumer-migration status, and ratify the two non-migrations.

  • Migrated to the tenancy service: SecurityPlugin RLS gate, /auth/config features, the reconciler.
  • By design, not migrated:
    • The SQL driver's tenant-audit gate keeps reading the env requested flag. The driver holds no PluginContext/service-registry handle, and the gate governs only a dev-time "no tenantId" warning — never the enforcement path (applyTenantScope, which keys off options.tenantId). Coupling a low-level driver to a kernel service to fire a warning is the wrong trade; if ever done it should be pushed in at wiring time.
    • The serve.ts boot guard reads the env flag directly by necessity — it runs before plugin-auth registers the service (it's the code deciding whether to load the org runtime at all).

Verification

Prose-only edits to docs/adr/0093-*.md and content/docs/deployment/tenancy-modes.mdx. No package source touched (no changeset expected; will add an empty one if the Check Changeset gate requires it).

🤖 Generated with Claude Code

https://claude.ai/code/session_01XbLd2KKeVs39EztDYMQ1YU


Generated by Claude Code

…ified consumer-migration scope)
Follow-up doc-truing after PRs #2884/#2887 shipped:
- D5: the degraded-state "Setup dashboard banner" is descoped. Branding is the
terminal boot warning + features.degradedTenancy in /auth/config (no objectui
console UI for this extreme, opt-in-past-a-refusal case). The API flag stays so
a console CAN render a banner later without more framework work.
- D4: record actual migration status. SecurityPlugin, /auth/config, and the
reconciler consume the tenancy service. The SQL driver's tenant-audit gate (a
dev-only warning; the driver holds no service handle) and serve.ts boot guard
(runs before the service is registered) keep reading the env flag BY DESIGN —
ratified, not pending. Deferred migration, if ever, pushes the value in at
wiring time rather than the driver reaching into the registry.
- tenancy-modes.mdx: same descope correction for consistency.
Docs-only; no package source touched.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XbLd2KKeVs39EztDYMQ1YU
@vercel

vercelBot commented Jul 14, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJul 14, 2026 1:51pm

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation size/s labels Jul 14, 2026
@os-zhuang
os-zhuang marked this pull request as ready for review July 14, 2026 14:00
@os-zhuang
os-zhuang merged commit 2d4bd6b into mainJul 14, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the claude/adr-0093-doc-truing branch July 14, 2026 14:00
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@os-zhuang@claude