PR_26171_014 Message Studio table governance

Author: ToolboxAid

docs_build/dev/PROJECT_INSTRUCTIONS.md

@@ -358,13 +358,15 @@ Prohibited product-data ownership:
 
 Toolbox and Admin tool metadata must use a shared DB-backed tool metadata source for `toolKey`, `toolName`, `group`, `path`, `order`, and `status`. Browser pages may render metadata returned by the API/service contract, but they must not own a separate runtime copy of that metadata.
 
-## POSTGRES DATABASE DIRECTION
+## DATABASE DIRECTION
 
-SQLite is deprecated for new database work.
+SQLite is deprecated.
+Postgres is authoritative.
 
 Rules:
 - New database work must target Postgres.
-- New persistence must flow through Local API / Postgres direction only.
+- Local API -> Postgres is the required direction.
+- New PRs must not introduce SQLite persistence.
 - Do not add new SQLite services.
 - Do not add new SQLite DDL.
 - Do not add new SQLite seed data.

docs_build/dev/reports/PR_26171_014-message-studio-table-governance-manual-validation.txt

@@ -0,0 +1,14 @@
+PR_26171_014-message-studio-table-governance manual validation notes
+
+Reviewed Message Studio page structure after the table governance conversion:
+- Message Rows use table columns Name, Primary Emotion, Segments, Tags, Status, Actions.
+- Add Message Row opens an inline editable row.
+- Edit opens inline row editing.
+- Disable actions are present for active rows and no Delete actions are present.
+- Selected Message Row renders a nested Segment Table.
+- Segment rows support Edit, Move Up, Move Down, and Disable.
+- Emotion Profiles and TTS Profiles use inline table rows for add/edit.
+- Speech Preview is display-only and has no playback buttons.
+
+No browser category UI is present in toolbox/messages.
+No manual provider/audio playback was attempted because it is out of scope.

docs_build/dev/reports/PR_26171_014-message-studio-table-governance-validation.txt

@@ -0,0 +1,22 @@
+PR_26171_014-message-studio-table-governance validation report
+
+Branch:
+PASS - Started from main.
+
+Static and syntax checks:
+PASS - node --check toolbox/messages/messages.js
+PASS - node --check toolbox/messages/messages-api-client.js
+PASS - node --check src/dev-runtime/messages/messages-sqlite-service.mjs
+PASS - node --check tests/playwright/tools/MessagesTool.spec.mjs
+PASS - git diff --check
+
+Targeted runtime/static assertions:
+PASS - No category references remain in toolbox/messages browser files.
+PASS - No speech synthesis or preview action hooks remain in toolbox/messages browser files.
+PASS - No Delete labels exist in Message Studio browser files or the targeted Playwright spec.
+
+Playwright:
+PASS - npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --workers=1 --reporter=list
+
+Samples:
+SKIPPED - Full samples smoke was out of scope.

docs_build/dev/reports/PR_26171_014-message-studio-table-governance.md

@@ -0,0 +1,45 @@
+# PR_26171_014-message-studio-table-governance
+
+## Branch Validation
+
+PASS - Work was executed from `main` with `git status --short --branch` reporting `## main...origin/main` before edits.
+
+## Requirement Checklist
+
+- PASS - Project instructions now define `DATABASE DIRECTION`, state SQLite is deprecated, Postgres is authoritative, and require Local API -> Postgres for new database work.
+- PASS - Browser Message Studio category imports, state, API usage, and rendering were removed from `toolbox/messages/`.
+- PASS - Message rows render as a Summary Table with Name, Primary Emotion, Segments, Tags, Status, and Actions.
+- PASS - Add Message Row opens an inline editable row inside the table.
+- PASS - Message row actions are Edit and Disable; no delete UI is present.
+- PASS - Emotion Profiles render as table governance with Name, Volume, Pitch, Rate, Status, and Actions.
+- PASS - Add Profile opens an inline emotion profile row; actions are Edit and Disable.
+- PASS - TTS Profiles render as table governance with Name, Provider, Voice, Language, Status, and Actions.
+- PASS - Add Profile opens an inline TTS profile row; actions are Edit and Disable.
+- PASS - Message Segments render nested under the selected message row with Order, Emotion, Text, Status, and Actions.
+- PASS - Segment actions are Edit, Move Up, Move Down, and Disable; no delete UI is present.
+- PASS - Speech Preview remains display-only with no playback controls, provider calls, or browser speech synthesis calls.
+- PASS - Legacy SQLite category storage remains only inside the existing dev adapter as technical debt compatibility for the old schema.
+
+## Impacted Lane
+
+Message Studio Theme V2 tool, browser API client, existing dev-runtime messages adapter compatibility, and targeted Playwright coverage.
+
+## Skipped Lanes
+
+Samples smoke, unrelated toolbox pages, provider/runtime speech playback, audio generation, and repo-wide refactors were skipped as out of scope.
+
+## Validation
+
+- PASS - `node --check toolbox/messages/messages.js`
+- PASS - `node --check toolbox/messages/messages-api-client.js`
+- PASS - `node --check src/dev-runtime/messages/messages-sqlite-service.mjs`
+- PASS - `node --check tests/playwright/tools/MessagesTool.spec.mjs`
+- PASS - `rg -n "category|Category" toolbox/messages` returned no browser-surface matches.
+- PASS - `rg -n "speechSynthesis|SpeechSynthesis|speak\\(|Preview Message|Preview Segments|Stop Preview" toolbox/messages` returned no matches.
+- PASS - `rg -n "Delete" toolbox/messages tests/playwright/tools/MessagesTool.spec.mjs` returned no matches.
+- PASS - `npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --workers=1 --reporter=list`
+- PASS - `git diff --check`
+
+## Manual Notes
+
+Reviewed the updated Message Studio route structure and confirmed the visible workflow is table-driven. The Speech Preview accordion now displays only status text. No full samples validation was run.

docs_build/dev/reports/codex_changed_files.txt

@@ -1,12 +1,12 @@
-docs_build/dev/PROJECT_INSTRUCTIONS.md
-docs_build/dev/reports/PR_26171_012-message-tool-postgres-table-layout-cleanup-manual-validation.md
-docs_build/dev/reports/PR_26171_012-message-tool-postgres-table-layout-cleanup-validation.txt
-docs_build/dev/reports/PR_26171_012-message-tool-postgres-table-layout-cleanup.md
-docs_build/dev/reports/codex_changed_files.txt
+docs_build/dev/PROJECT_INSTRUCTIONS.md
 docs_build/dev/reports/codex_review.diff
-src/dev-runtime/server/local-api-router.mjs
-src/shared/toolbox/tool-metadata-inventory.js
+docs_build/dev/reports/coverage_changed_js_guardrail.txt
+docs_build/dev/reports/playwright_v8_coverage_report.txt
+docs_build/dev/reports/PR_26171_014-message-studio-table-governance.md
+docs_build/dev/reports/PR_26171_014-message-studio-table-governance-manual-validation.txt
+docs_build/dev/reports/PR_26171_014-message-studio-table-governance-validation.txt
+src/dev-runtime/messages/messages-sqlite-service.mjs
 tests/playwright/tools/MessagesTool.spec.mjs
-tests/playwright/tools/RootToolsFutureState.spec.mjs
 toolbox/messages/index.html
 toolbox/messages/messages.js
+toolbox/messages/messages-api-client.js