Add local API diagnostics reports

Author: ToolboxAid

docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics-manual-validation-notes.md

@@ -0,0 +1,18 @@
+# PR_26171_018 Manual Validation Notes
+
+## Startup Diagnostics Review
+- Confirmed the old compact `.env loaded for API runtime (...)` line is not present in the captured startup diagnostics.
+- Confirmed `.env` runtime variables print under the exact `Environment Variables` divider section.
+- Confirmed variables are sorted alphabetically in the startup capture.
+- Confirmed the runtime capture printed applied `.env` variables with `+`.
+- Confirmed the existing startup logging assertion covers already-set variables with `-`.
+
+## Port Diagnostics Review
+- Confirmed startup diagnostics print the exact `All Runtime Ports being used by Service` divider section.
+- Confirmed the runtime capture includes readable labels for live server, API server, configured API URL, DB/Postgres, Supabase, and storage ports.
+- Confirmed missing optional ports are represented as `not configured` in the formatter test path.
+
+## Secret Handling Review
+- Confirmed secret-key values are masked as `********`.
+- Confirmed database URL credentials are redacted before the URL is printed.
+- Confirmed generated PR reports do not include raw secret values.

docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics-validation-report.md

@@ -0,0 +1,18 @@
+# PR_26171_018 Validation Report
+
+## Validation Commands
+- PASS: `npm run test:workspace-v2`
+  - Result: 5 Playwright tests passed in the `workspace-contract` lane.
+- PASS: `npm run dev:local-api`
+  - Startup was run through the repo npm script on an open alternate API port and stopped after `Press Ctrl+C to stop.` printed.
+  - Captured diagnostics contained `Environment Variables`, `All Runtime Ports being used by Service`, and `API server port:`.
+  - Capture path: `docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics-local-api-startup.log` (local ignored log).
+
+## Secret Mask Confirmation
+- PASS: startup capture scan checked 4 secret-key values from `.env`; no raw secret-key values were found in the captured log.
+- PASS: startup capture scan checked 2 URL credentials from `.env`; no raw URL credentials were found in the captured log.
+- PASS: captured startup output used `********` for masked secret keys and redacted database URL credentials.
+
+## Notes
+- The validation wrapper intentionally terminated the local API process after startup diagnostics printed.
+- No SQLite implementation work was performed.

docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics.md

@@ -0,0 +1,25 @@
+# PR_26171_018-local-api-startup-diagnostics
+
+## Purpose
+Improve `npm run dev:local-api` startup diagnostics without changing server startup behavior.
+
+## Implementation
+- Replaced the compact `.env loaded for API runtime (...)` line with an `Environment Variables` section.
+- Prints one `.env` runtime variable per line, sorted alphabetically.
+- Uses `+` for variables applied from `.env` and `-` for variables already set before `.env`.
+- Masks values for keys containing `PASSWORD`, `SECRET`, `TOKEN`, `KEY`, `SERVICE_ROLE`, or `JWT`.
+- Redacts URL username/password credentials before printing non-masked URL values.
+- Added an `All Runtime Ports being used by Service` section covering live site, API server, configured API URL, DB/Postgres, Supabase, and storage ports, with `not configured` for missing optional ports.
+
+## Changed Files
+- `scripts/start-local-api-server.mjs`
+- `tests/dev-runtime/LocalApiStartupLogging.test.mjs`
+
+## Reports
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics-validation-report.md`
+- `docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics-manual-validation-notes.md`
+
+## Delta ZIP
+- `tmp/PR_26171_018-local-api-startup-diagnostics_delta.zip`

docs_build/dev/reports/codex_changed_files.txt

@@ -1,13 +1,19 @@
-docs_build/dev/reports/codex_changed_files.txt
-docs_build/dev/reports/codex_review.diff
-docs_build/dev/reports/PR_26171_BETA_083-message-tts-polish-and-dead-code-dead-code-cleanup-checklist.md
-docs_build/dev/reports/PR_26171_BETA_083-message-tts-polish-and-dead-code-manual-validation-notes.md
-docs_build/dev/reports/PR_26171_BETA_083-message-tts-polish-and-dead-code-message-tts-ux-checklist.md
-docs_build/dev/reports/PR_26171_BETA_083-message-tts-polish-and-dead-code-validation-report.md
-docs_build/dev/reports/PR_26171_BETA_083-message-tts-polish-and-dead-code.md
-tests/playwright/tools/MessagesTool.spec.mjs
-tests/playwright/tools/TextToSpeechFunctional.spec.mjs
-toolbox/messages/index.html
-toolbox/messages/messages.js
-toolbox/text-to-speech/index.html
-toolbox/text-to-speech/text2speech.js
+# PR_26171_018-local-api-startup-diagnostics changed files
+
+## Source/test changes
+- scripts/start-local-api-server.mjs
+- tests/dev-runtime/LocalApiStartupLogging.test.mjs
+
+## Required reports
+- docs_build/dev/reports/codex_review.diff
+- docs_build/dev/reports/codex_changed_files.txt
+- docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics.md
+- docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics-validation-report.md
+- docs_build/dev/reports/PR_26171_018-local-api-startup-diagnostics-manual-validation-notes.md
+
+## Local package artifact
+- tmp/PR_26171_018-local-api-startup-diagnostics_delta.zip
+
+## Validation evidence
+- npm run test:workspace-v2: PASS
+- npm run dev:local-api startup capture: PASS