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

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

vercel Bot commented Jul 14, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jul 14, 2026 1:51pm

Request Review

@github-actions github-actions Bot 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 main Jul 14, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the claude/adr-0093-doc-truing branch July 14, 2026 14:00

This branch was successfully deployed

1 active deployment
Preview — dc6c3481 Deployed Jul 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants