Merge remote-tracking branch 'origin/main' into team/ALPHA/game-journey

# Conflicts:
#	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
#	src/dev-runtime/server/local-api-router.mjs
#	tests/helpers/playwrightRepoServer.mjs

Author: ToolboxAid

docs_build/database/dml/DML_INDEX.md

@@ -14,7 +14,7 @@ Direct SQL setup is intentionally narrow. Account DEV users now require server-s
 | Game Design | `game-design.sql` | Server-seed-owned | Server-side seed API |
 | Game Journey | `game-journey.sql` | Server-seed-owned | Server-side seed API |
 | Game Hub | `game-workspace.sql` | Server-seed-owned | Server-side seed API |
-| Messages | `messages.sql` | Server-seed-owned | Messages Local API/server-side SQLite service |
+| Messages | `messages.sql` | Server-seed-owned | Messages Local API/server-side Postgres service |
 | Objects | `objects.sql` | Server-seed-owned | Server-side seed API |
 | Palette | `palette.sql` | Server-seed-owned | Server-side seed API |
 | Support Tickets | `support-tickets.sql` | Server-seed-owned | Admin Site Setup/server-side seed API |

docs_build/database/dml/messages.sql

@@ -6,7 +6,7 @@
 -- Owned tables: messages_categories, messages_emotion_profiles, messages_tts_profiles, messages_records, messages_segments
 
 -- DML status: Server-seed-owned.
--- Setup is performed through the Messages Local API / server-side SQLite service for this PR.
+-- Setup is performed through the Messages Local API / server-side Postgres service for this PR.
 -- Browser pages must not seed authoritative records.
 -- The server/API layer generates all keys and audit fields.
 -- This SQL file intentionally has no direct INSERT statements because direct SQL would bypass key/audit ownership.

docs_build/database/seed/messages.json

@@ -31,5 +31,5 @@
     "messages_records": [],
     "messages_segments": []
   },
-  "note": "Seed names are applied by the server-side Messages SQLite service. Browser pages must not seed authoritative records."
+  "note": "Seed names are applied by the server-side Messages Postgres service. Browser pages must not seed authoritative records."
 }

docs_build/dev/reports/PR_26171_BETA_022-messages-postgres-service-cutover-instruction-compliance-checklist.md

@@ -0,0 +1,16 @@
+# PR_26171_BETA_022 Instruction Compliance Checklist
+
+TEAM ownership: BETA.
+
+- PASS: Read `docs_build/dev/PROJECT_INSTRUCTIONS.md`.
+- PASS: Read `docs_build/dev/PROJECT_MULTI_PC.txt`.
+- PASS: Verified Messages belongs to Team Beta ownership.
+- PASS: Started from latest `main` before creating `team/BETA/messages`.
+- PASS: Scope stayed within Messages Local API/service/tests and directly affected active database docs.
+- PASS: Removed active Messages SQLite runtime dependency without touching unrelated SQLite work.
+- PASS: Used targeted validation only.
+- PASS: Did not run samples.
+- PASS: Did not merge.
+- PASS: Required shared reports are generated under `docs_build/dev/reports/`.
+- PASS: Manual validation notes are present.
+- PASS: Repo-structured ZIP is required under `tmp/`.

docs_build/dev/reports/PR_26171_BETA_022-messages-postgres-service-cutover-manual-validation-notes.md

@@ -0,0 +1,21 @@
+# PR_26171_BETA_022 Manual Validation Notes
+
+TEAM ownership: BETA.
+
+Manual validation performed:
+- Confirmed the Messages page loads through the repo Playwright server with the injected Postgres client stub.
+- Confirmed seeded Messages categories, emotion profiles, and TTS profiles are available from `/api/messages/*`.
+- Confirmed creating a message preserves `message`, `persistence`, `categoryName`, and `emotionProfileName` response shape fields.
+- Confirmed creating a message segment preserves `segment`, `messageName`, and `emotionProfileName` response shape fields.
+- Confirmed playback behavior remains covered by the Messages Playwright spec.
+- Confirmed active Messages SQLite runtime dependency strings are absent from scoped active paths.
+
+Expected outcome:
+- Messages Local API persists through the Postgres service contract.
+- Messages tool behavior remains unchanged from the browser user's perspective.
+- No `messages.sqlite` file is created or required by the Messages tool tests.
+
+Out of scope:
+- Full samples smoke.
+- Broad runtime regression suite.
+- Production database connectivity against a live Postgres instance.

docs_build/dev/reports/PR_26171_BETA_022-messages-postgres-service-cutover.md

@@ -0,0 +1,39 @@
+# PR_26171_BETA_022-messages-postgres-service-cutover
+
+## Summary
+
+TEAM ownership: BETA.
+
+Branch: `team/BETA/messages`.
+
+Scope completed:
+- Replaced the active Messages Local API persistence service with a Postgres-backed implementation.
+- Routed `/api/messages/*` through `createMessagesPostgresService`.
+- Preserved the existing Local API response envelopes for Messages, categories, emotion profiles, TTS profiles, and segments.
+- Removed the active Messages `node:sqlite`, `DatabaseSync`, `messages.sqlite`, and `GAMEFOUNDRY_MESSAGES_SQLITE_PATH` runtime path.
+- Updated targeted Messages Playwright coverage to use an injected Postgres client stub.
+- Updated active Messages DML/seed documentation from SQLite service wording to Postgres service wording.
+
+Compatibility wrapper:
+- No wrapper was kept. Active imports were migrated to `messages-postgres-service.mjs`, and targeted text checks found no remaining active reference to `messages-sqlite-service`.
+
+Postgres authority:
+- The runtime service uses the existing `createPostgresConnectionClient` path, which reads `GAMEFOUNDRY_DATABASE_URL` for the server-side database connection.
+- Tests inject `createMessagesPostgresClientStub()` to preserve deterministic Local API and Playwright behavior without creating a local SQLite file.
+
+## Validation
+
+Passed:
+- `node --test --test-name-pattern "Messages Local API" tests/dev-runtime/DbSeedIntegrity.test.mjs`
+- `npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --config=codex_playwright_system_chrome.config.cjs --project=playwright`
+- `git diff --check`
+- Targeted stale SQLite dependency check across Messages service, Local API router, affected tests, helper stubs, and active Messages docs.
+- Targeted Postgres wiring check for `GAMEFOUNDRY_DATABASE_URL`, `createPostgresConnectionClient`, and Postgres service references.
+
+Skipped:
+- Full samples smoke: out of scope for this Messages Local API cutover.
+- Broad runtime test suite: out of scope; validation was limited to the affected Messages and Local API surfaces.
+
+## Notes
+
+Playwright V8 coverage reports were refreshed by the targeted Messages Playwright run. Server-side runtime files are listed as advisory warnings because browser V8 coverage does not collect Node-side Local API modules.