Complete provider failure behavior, Supabase activation readiness, users roles migration, Site Setup ownership, and final DB/Auth lane audit - PR_26166_130-134-db-auth-finish-line

Author: ToolboxAid

.env.example

@@ -1,7 +1,7 @@
 # Game Foundry Studio local development environment
 
-# Keep Local DB active by default. Future Supabase provider selectors stay inactive
-# until a dedicated adapter PR enables them.
+# Local DB is explicitly selected for local development. Selecting Supabase
+# without complete configuration reports provider diagnostics instead of falling back.
 GAMEFOUNDRY_AUTH_PROVIDER=local-db
 GAMEFOUNDRY_DB_PROVIDER=local-db
 

admin/site-setup.html

@@ -46,6 +46,7 @@ <h2>Admin</h2>
                                     <label>Setup Area <select disabled><option>Default roles</option><option>First admin</option><option>Tool metadata bootstrap</option><option>Starter platform settings</option><option>Ticket categories</option></select></label>
                                     <label>Review Mode <select disabled><option>Foundation only</option><option>Local DB dry run</option><option>Admin approval</option></select></label>
                                     <button class="btn btn--compact" type="button" data-admin-setup-reseed>Reseed Local DB</button>
+                                    <button class="btn btn--compact" type="button" data-admin-setup-refresh>Refresh Setup Status</button>
                                     <p class="status" role="status" data-admin-setup-status>SKIP: No setup action has been run.</p>
                                 </div>
                             </details>
@@ -69,12 +70,12 @@ <h2 id="admin-site-setup-title">Controlled Setup Foundation</h2>
                                         <th scope="col">Guardrail</th>
                                     </tr>
                                 </thead>
-                                <tbody>
-                                    <tr><td>Default Roles</td><td>Create approved role records</td><td>Foundation</td><td>Local DB contract required</td></tr>
-                                    <tr><td>First Admin</td><td>Assign the initial admin user</td><td>Foundation</td><td>No hidden default user</td></tr>
-                                    <tr><td>Tool Metadata Bootstrap</td><td>Seed active tool metadata</td><td>Foundation</td><td>Shared metadata source required</td></tr>
-                                    <tr><td>Starter Platform Settings</td><td>Create baseline settings records</td><td>Foundation</td><td>Visible diagnostics required</td></tr>
-                                    <tr><td>Ticket/Support Categories</td><td>Prepare support category setup</td><td>Foundation</td><td>Admin approval required</td></tr>
+                                <tbody data-admin-setup-status-rows>
+                                    <tr><td>Default Roles</td><td>Create approved role records</td><td>SKIP</td><td>Refresh setup status to read server-owned diagnostics.</td></tr>
+                                    <tr><td>First Admin</td><td>Assign the initial admin user</td><td>SKIP</td><td>Refresh setup status to read server-owned diagnostics.</td></tr>
+                                    <tr><td>Tool Metadata Bootstrap</td><td>Seed active tool metadata</td><td>SKIP</td><td>Refresh setup status to read server-owned diagnostics.</td></tr>
+                                    <tr><td>Starter Platform Settings</td><td>Create baseline settings records</td><td>SKIP</td><td>Refresh setup status to read server-owned diagnostics.</td></tr>
+                                    <tr><td>Support Categories</td><td>Prepare support category setup</td><td>SKIP</td><td>Refresh setup status to read server-owned diagnostics.</td></tr>
                                 </tbody>
                             </table>
                         </div>

assets/theme-v2/js/admin-setup-actions.js

@@ -1,7 +1,9 @@
-import { reseedAdminSetup } from "../../../src/engine/api/admin-setup-api-client.js";
+import { readAdminSetupStatus, reseedAdminSetup } from "../../../src/engine/api/admin-setup-api-client.js";
 
 const reseedButtons = Array.from(document.querySelectorAll("[data-admin-setup-reseed]"));
+const refreshButtons = Array.from(document.querySelectorAll("[data-admin-setup-refresh]"));
 const statusFields = Array.from(document.querySelectorAll("[data-admin-setup-status]"));
+const statusRows = Array.from(document.querySelectorAll("[data-admin-setup-status-rows]"));
 
 function setStatus(message, status = "PASS") {
   const text = `${status}: ${message}`;
@@ -11,7 +13,7 @@ function setStatus(message, status = "PASS") {
 }
 
 function setBusy(isBusy) {
-  reseedButtons.forEach((button) => {
+  [...reseedButtons, ...refreshButtons].forEach((button) => {
     button.disabled = isBusy;
     if (isBusy) {
       button.setAttribute("aria-disabled", "true");
@@ -21,6 +23,41 @@ function setBusy(isBusy) {
   });
 }
 
+function appendCell(row, text) {
+  const cell = document.createElement("td");
+  cell.textContent = text;
+  row.appendChild(cell);
+}
+
+function renderSetupRows(report) {
+  statusRows.forEach((body) => {
+    body.replaceChildren();
+    (report.areas || []).forEach((area) => {
+      const row = document.createElement("tr");
+      appendCell(row, area.label || area.id || "Setup Area");
+      appendCell(row, area.action || "Server-owned setup check");
+      appendCell(row, area.status || "WARN");
+      appendCell(row, area.message || "No setup status message returned.");
+      body.appendChild(row);
+    });
+  });
+}
+
+function refreshSetupStatus() {
+  setBusy(true);
+  setStatus("Reading Site Setup status through Admin setup.", "WARN");
+  try {
+    const report = readAdminSetupStatus();
+    renderSetupRows(report);
+    setStatus(report.message || "Site Setup status refreshed.", report.status || "PASS");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error || "Admin setup status failed.");
+    setStatus(message, "FAIL");
+  } finally {
+    setBusy(false);
+  }
+}
+
 function runReseed() {
   setBusy(true);
   setStatus("Running Local DB reseed through Admin setup.", "WARN");
@@ -41,3 +78,7 @@ function runReseed() {
 reseedButtons.forEach((button) => {
   button.addEventListener("click", runReseed);
 });
+
+refreshButtons.forEach((button) => {
+  button.addEventListener("click", refreshSetupStatus);
+});

docs_build/dev/reports/codex_changed_files.txt

@@ -1,12 +1,17 @@
-# git status --short
-M docs_build/dev/reports/codex_changed_files.txt
- M docs_build/dev/reports/codex_review.diff
-?? docs_build/dev/reports/pr129-local-db-migration-audit.md
-
-# git ls-files --others --exclude-standard
-docs_build/dev/reports/pr129-local-db-migration-audit.md
-
-# git diff --stat
-docs_build/dev/reports/codex_changed_files.txt |   20 +-
- docs_build/dev/reports/codex_review.diff       | 1001 +++++-------------------
- 2 files changed, 215 insertions(+), 806 deletions(-)
+.env.example
+admin/site-setup.html
+assets/theme-v2/js/admin-setup-actions.js
+docs_build/dev/reports/codex_changed_files.txt
+docs_build/dev/reports/codex_review.diff
+docs_build/dev/reports/coverage_changed_js_guardrail.txt
+docs_build/dev/reports/playwright_v8_coverage_report.txt
+docs_build/dev/reports/pr130-provider-failure-contract.md
+docs_build/dev/reports/pr131-supabase-dev-activation-runtime.md
+docs_build/dev/reports/pr132-supabase-users-roles-migration.md
+docs_build/dev/reports/pr133-site-setup-productionization.md
+docs_build/dev/reports/pr134-db-migration-finish-line-audit.md
+src/dev-runtime/auth/provider-contract-stubs.mjs
+src/dev-runtime/server/local-api-router.mjs
+src/engine/api/admin-setup-api-client.js
+tests/dev-runtime/SupabaseProviderContractStub.test.mjs
+tests/playwright/tools/LoginSessionMode.spec.mjs