@@ -68,9 +68,9 @@
     },
     "enableOpenApi": {
       "status": "live",
-      "verifiedAt": "2026-09-21",
+      "verifiedAt": "2026-10-22",
       "evidenceScope": "in-repo",
-      "evidence": "packages/rest/src/rest-server.ts#registerRoutes (`if (this.config.api.enableOpenApi)` gates registerOpenApiEndpoints, which mounts both `/openapi.json` and the `/docs` viewer)",
+      "evidence": "packages/rest/src/rest-server.ts#registerRoutes (`if (this.config.api.enableOpenApi)` gates registerOpenApiEndpoints, which mounts `/openapi.json`, the OpenAPI document)",
       "producer": "packages/rest/src/rest-server.ts#normalizeConfig (parses `config.api` through `parseDeclaredApiConfig` and lists the key into `this.config.api`, the object every consumer below reads; the parsed schema's own `.default()`s supply the value when the host omits the key)",
       "note": "One consumer, and it is the mount. Worth reading beside `documentation.*` below: this flag decides WHETHER the OpenAPI document is served at all, and it is the only key on this block that the served document's existence depends on — nothing on this block decides what the document SAYS. REACHABILITY (#15543, standing reading): embedder-only. A RestServerConfig is the ARGUMENT a host passes when it constructs the server, and the one door is programmatic — createRestApiPlugin({ api }) (packages/rest/src/rest-api-plugin.ts). No shipped boot path opens it with a config of its own: packages/cli/src/commands/serve.ts forwards exactly two keys out of the stack's own top-level `api:` block (enableProjectScoping, projectResolution) and plugin-dev calls createRestApiPlugin() with no config at all, so a CLI-started deployment always gets the schema default for every key here. `live` answers who READS the key; reachability answers who can SET it, and the two never substitute for each other."
     },
 
@@ -30,11 +30,10 @@
  *
  * 1. **Every local `$ref` resolves.** Any `$ref` beginning with `#/` is a JSON
  *    Pointer into this same document; if it does not resolve, the document is
- *    broken for every consumer that parses it (Scalar's viewer at
- *    `GET /api/v1/docs`, and any client generator pointed at
- *    `GET /api/v1/openapi.json`). Resolution is by pointer rather than by a
- *    `#/components/schemas/` prefix match so that a future `#/$defs/…` ref
- *    is covered without touching this file.
+ *    broken for every consumer that parses it (any client generator or
+ *    API tool pointed at `GET /api/v1/openapi.json`). Resolution is by
+ *    pointer rather than by a `#/components/schemas/` prefix match so that a
+ *    future `#/$defs/…` ref is covered without touching this file.
  * 2. **No schema is silently degraded.** See `assertNoDegradedSchemas`.
  *
  * ## Rule 1 after #5744 — vacuous today, retained for `$defs`
@@ -153,9 +152,9 @@ export function assertRefsResolve(doc: unknown): void {
       `  defined components.schemas: [${defined.join(', ') || '<none>'}]\n` +
       `\n` +
       `  A $ref that resolves to nothing breaks every consumer of the published\n` +
-      `  document (the Scalar viewer at GET /api/v1/docs renders an empty schema\n` +
-      `  panel; client generators fail at parse time). If components.schemas is\n` +
-      `  empty, the collector in build-openapi.ts skipped its inputs — note that\n` +
+      `  document at GET /api/v1/openapi.json (client generators fail at parse\n` +
+      `  time). If components.schemas is empty, the collector in\n` +
+      `  build-openapi.ts skipped its inputs — note that\n` +
       `  lazySchema() returns a Proxy whose typeof is 'function', not 'object'\n` +
       `  (#5168).`,
   );
 
@@ -134,14 +134,13 @@ export const RestApiConfigSchema = lazySchema(() => z.object({
   enableDiscovery: z.boolean().default(true).describe('Enable API discovery endpoint'),
 
   /**
-   * Enable OpenAPI 3.1 spec endpoints — `GET <basePath>/openapi.json`
-   * for the machine-readable contract and `GET <basePath>/docs` for a
-   * zero-dep Scalar-rendered HTML viewer. The spec ships pre-generated
+   * Enable the OpenAPI 3.1 document endpoint — `GET <basePath>/openapi.json`,
+   * the machine-readable contract. The spec ships pre-generated
    * from @objectstack/spec and is enriched at request time with the
    * actual server URL + the runtime-registered objects (so `{object}`
    * placeholders expand into one path per concrete table).
    */
-  enableOpenApi: z.boolean().default(true).describe('Enable OpenAPI 3.1 spec & docs viewer endpoints'),
+  enableOpenApi: z.boolean().default(true).describe('Enable the OpenAPI 3.1 document endpoint (`GET <basePath>/openapi.json`)'),
 
   /**
    * Server-wide switch for the structured-search surface — and, like every key
@@ -232,8 +231,7 @@ export const RestApiConfigSchema = lazySchema(() => z.object({
       '`api.documentation.enabled` was removed in @objectstack/spec 17.5.0 (ADR-0049 enforce-or-remove) — '
       + 'nothing ever read it: whether the server publishes its OpenAPI document is decided by the sibling '
       + '`api.enableOpenApi` at the mount, so `enabled: false` turned nothing off. Delete the key; '
-      + '`api.enableOpenApi: false` is the switch that leaves the `/openapi.json` document and its `/docs` '
-      + 'viewer unmounted.',
+      + '`api.enableOpenApi: false` is the switch that leaves the `/openapi.json` document unmounted.',
     ),
     // [#20294] `.optional()`, no longer `.default('ObjectStack API')`: that
     // default was materialized into every present block and never served
 
@@ -17,7 +17,7 @@ export const entry: SemanticMigration = {
   surface: 'restServer.api.responseFormat / restServer.api.documentation.enabled',
   replacement:
     '(removed — delete each key; neither had an effect to preserve. Whether the server publishes its '
-    + 'OpenAPI document and the docs viewer is `api.enableOpenApi`, the switch the mount already reads. '
+    + 'OpenAPI document is `api.enableOpenApi`, the switch the mount already reads. '
     + 'Response shapes are fixed — each route answers in the response schema `@objectstack/spec/api` '
     + 'declares for it — and are not a server-wide option, so there is no replacement for `responseFormat`.)',
   reason:
@@ -43,7 +43,7 @@ export const entry: SemanticMigration = {
     + 'the REST plugin\'s `start`) with the retirement prescription, naming the key and '
     + '`RestApiConfigSchema`, instead of being accepted and ignored; `tsc` refuses the key at the '
     + 'authoring site (`never`). A host that meant "serve no OpenAPI document" sets `api.enableOpenApi: '
-    + 'false` and sees `GET /openapi.json` and `GET /docs` unmounted. Every client that parses REST '
+    + 'false` and sees `GET /openapi.json` unmounted. Every client that parses REST '
     + 'responses reads each route\'s declared response shape. Every LIVE key of the `api` block — '
     + 'including `documentation`\'s other members — parses byte-identically to before, and the mounted '
     + 'REST surface is unchanged: '