Add runtime health JSON endpoint

Author: ToolboxAid

docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints.md

@@ -0,0 +1,29 @@
+# PR_26177_CHARLIE_032-runtime-health-json-endpoints
+
+Team: Charlie
+Branch: pr/26177-CHARLIE-032-runtime-health-json-endpoints
+Base: pr/26177-CHARLIE-031-environment-health-comparison
+Lifecycle: Build / Validation
+
+## Scope
+- Added GET /api/runtime/health as a structured Local API JSON health endpoint.
+- Endpoint includes environment, API status, database status, storage status, and timestamp.
+- Endpoint is server-owned, does not expose secrets, and does not give the browser direct database ownership.
+
+## Changed Files
+- src/dev-runtime/server/local-api-router.mjs
+- tests/api/admin-system-health/contract.test.mjs
+- tests/dev-runtime/AdminHealthOperations.test.mjs
+- tests/playwright/tools/AdminHealthOperationsPage.spec.mjs
+- docs_build/dev/reports/coverage_changed_js_guardrail.txt
+- docs_build/dev/reports/playwright_v8_coverage_report.txt
+
+## Validation
+- PASS: node --check src/dev-runtime/server/local-api-router.mjs
+- PASS: node --test tests/api/admin-system-health/contract.test.mjs
+- PASS: node --test tests/dev-runtime/AdminHealthOperations.test.mjs
+- PASS: npx playwright test tests/playwright/tools/AdminHealthOperationsPage.spec.mjs --workers=1 --reporter=line
+- PASS: git diff --check
+
+## ZIP
+- Pending until commit: C:\Users\DavidQ\Documents\GitHub\HTML-JavaScript-Gaming\tmp\PR_26177_CHARLIE_032-runtime-health-json-endpoints_delta.zip

docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_branch-validation.md

@@ -0,0 +1,19 @@
+# PR_26177_CHARLIE_032-runtime-health-json-endpoints Branch Validation
+
+Branch: pr/26177-CHARLIE-032-runtime-health-json-endpoints
+Expected stack base: pr/26177-CHARLIE-031-environment-health-comparison
+Current status at validation:
+## pr/26177-CHARLIE-032-runtime-health-json-endpoints
+ M docs_build/dev/reports/coverage_changed_js_guardrail.txt
+ M docs_build/dev/reports/playwright_v8_coverage_report.txt
+ M src/dev-runtime/server/local-api-router.mjs
+ M tests/api/admin-system-health/contract.test.mjs
+ M tests/dev-runtime/AdminHealthOperations.test.mjs
+ M tests/playwright/tools/AdminHealthOperationsPage.spec.mjs
+
+Result: PASS
+
+Checks:
+- PASS: Branch created from PR 031 branch for the approved stacked chain.
+- PASS: Active branch matches PR identity.
+- PASS: Worktree contained only scoped PR changes and generated validation reports.

docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_manual-validation-notes.md

@@ -0,0 +1,6 @@
+# PR_26177_CHARLIE_032-runtime-health-json-endpoints Manual Validation Notes
+
+- Confirmed GET /api/runtime/health returns JSON through the Local API router.
+- Confirmed payload includes environment, API, database, storage, and timestamp fields.
+- Confirmed payload excludes configured API/site credentials and secret values.
+- Confirmed System Health API Contract/Admin API Registry list the runtime health endpoint.

docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_requirements-checklist.md

@@ -0,0 +1,12 @@
+# PR_26177_CHARLIE_032-runtime-health-json-endpoints Requirement Checklist
+
+- PASS: Added structured Local API JSON health endpoint.
+- PASS: Includes environment details.
+- PASS: Includes API status.
+- PASS: Includes DB status when available.
+- PASS: Includes storage status when available.
+- PASS: Includes timestamp.
+- PASS: Does not expose secrets or URL credentials.
+- PASS: Browser UI remains API/service-contract based.
+- PASS: No direct browser database access added.
+- PASS: No unrelated files or start_of_day files modified.

docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_validation-lane.md

@@ -0,0 +1,20 @@
+# PR_26177_CHARLIE_032-runtime-health-json-endpoints Validation Lane Report
+
+Impacted lanes:
+- runtime: Local API route contract.
+- contract: Admin System Health API contract tests.
+- UI-adjacent: Admin System Health API registry display.
+- Playwright: targeted Admin System Health page spec.
+
+Commands:
+- node --check src/dev-runtime/server/local-api-router.mjs
+- node --test tests/api/admin-system-health/contract.test.mjs
+- node --test tests/dev-runtime/AdminHealthOperations.test.mjs
+- npx playwright test tests/playwright/tools/AdminHealthOperationsPage.spec.mjs --workers=1 --reporter=line
+- git diff --check
+
+Skipped lanes:
+- Full samples smoke skipped; no samples/runtime game code changed.
+- Full Project Workspace suite skipped; endpoint and Admin registry were covered by targeted tests.
+
+Result: PASS

docs_build/dev/reports/codex_changed_files.txt

@@ -1,32 +1,28 @@
 # git status --short
-M admin/system-health.html
- M assets/theme-v2/js/admin-system-health.js
- M docs_build/dev/reports/coverage_changed_js_guardrail.txt
+M docs_build/dev/reports/coverage_changed_js_guardrail.txt
  M docs_build/dev/reports/playwright_v8_coverage_report.txt
  M src/dev-runtime/server/local-api-router.mjs
  M tests/api/admin-system-health/contract.test.mjs
  M tests/dev-runtime/AdminHealthOperations.test.mjs
  M tests/playwright/tools/AdminHealthOperationsPage.spec.mjs
-?? docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison.md
-?? docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_branch-validation.md
-?? docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_manual-validation-notes.md
-?? docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_requirements-checklist.md
-?? docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_validation-lane.md
+?? docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints.md
+?? docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_branch-validation.md
+?? docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_manual-validation-notes.md
+?? docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_requirements-checklist.md
+?? docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_validation-lane.md
 
 # git ls-files --others --exclude-standard
-docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison.md
-docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_branch-validation.md
-docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_manual-validation-notes.md
-docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_requirements-checklist.md
-docs_build/dev/reports/PR_26177_CHARLIE_031-environment-health-comparison_validation-lane.md
+docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints.md
+docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_branch-validation.md
+docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_manual-validation-notes.md
+docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_requirements-checklist.md
+docs_build/dev/reports/PR_26177_CHARLIE_032-runtime-health-json-endpoints_validation-lane.md
 
 # git diff --stat
-admin/system-health.html                           | 20 ++++++
- assets/theme-v2/js/admin-system-health.js          | 50 ++++++++++++++
- .../dev/reports/coverage_changed_js_guardrail.txt  |  2 +-
- .../dev/reports/playwright_v8_coverage_report.txt  |  6 +-
- src/dev-runtime/server/local-api-router.mjs        | 76 ++++++++++++++++++++++
- tests/api/admin-system-health/contract.test.mjs    | 13 ++++
- tests/dev-runtime/AdminHealthOperations.test.mjs   |  9 +++
- .../tools/AdminHealthOperationsPage.spec.mjs       | 11 ++++
- 8 files changed, 183 insertions(+), 4 deletions(-)
+.../dev/reports/coverage_changed_js_guardrail.txt  |  1 -
+ .../dev/reports/playwright_v8_coverage_report.txt  |  2 -
+ src/dev-runtime/server/local-api-router.mjs        | 48 ++++++++++++++++++++++
+ tests/api/admin-system-health/contract.test.mjs    |  9 ++++
+ tests/dev-runtime/AdminHealthOperations.test.mjs   | 12 ++++++
+ .../tools/AdminHealthOperationsPage.spec.mjs       |  2 +
+ 6 files changed, 71 insertions(+), 3 deletions(-)