PR_26171_069 align message tts profile contract

Author: ToolboxAid

docs_build/dev/reports/PR_26171_069-manual-validation-notes.md

@@ -0,0 +1,7 @@
+# PR_26171_069 Manual Validation Notes
+
+- Confirmed Message Studio center work surface now presents the Messages parent table without detached Emotion Profile or Available TTS Profile tables.
+- Confirmed Message Parts remain directly under the expanded Message row.
+- Confirmed Message Studio exposes Play Message, Play Part, and Stop.
+- Confirmed TTS Studio default profiles render the expected parent/child TTS Profiles to Emotion Settings model.
+- Confirmed the scoped ZIP must be generated under `tmp/` and not staged.

docs_build/dev/reports/PR_26171_069-message-tts-ownership-checklist.md

@@ -0,0 +1,11 @@
+# PR_26171_069 Message/TTS Ownership Checklist
+
+- PASS: Message Studio owns text entered for Messages.
+- PASS: Message Studio owns ordered Message Parts.
+- PASS: Message Studio does not expose reusable Emotion Profile authoring.
+- PASS: Message Studio does not expose reusable TTS Profile authoring.
+- PASS: TTS Studio owns reusable TTS Profiles.
+- PASS: TTS Studio owns per-profile Emotion Settings.
+- PASS: `src/engine/audio/TextToSpeechEngine.js` remains the playback owner.
+- PASS: Message playback and Stop are routed through the Message Studio TTS service registry.
+- PASS: Audio output remains generated/played by the shared audio engine path.

docs_build/dev/reports/PR_26171_069-message-tts-profile-contract-alignment.md

@@ -0,0 +1,29 @@
+# PR_26171_069 Message/TTS Profile Contract Alignment
+
+## Scope
+- Align Message Studio and TTS Studio around the parent/child table model.
+- Keep Message Studio as the owner of game text and ordered Message Parts.
+- Keep TTS Studio as the owner of reusable TTS Profiles and per-profile Emotion Settings.
+- Keep playback routed through `src/engine/audio/TextToSpeechEngine`.
+
+## Requirement Evidence
+- PASS: Message Studio parent table remains `Messages` in `toolbox/messages/index.html`.
+- PASS: Clicking a Message row opens the `Message Parts` child table in `toolbox/messages/messages.js`.
+- PASS: Message Parts expose Text, Emotion, TTS Profile, and row actions.
+- PASS: Message Studio exposes Play Part, Play Message, and Stop.
+- PASS: Stop routes through `toolbox/messages/message-tts-service-registry.js` to `TextToSpeechEngine.stop()`.
+- PASS: Message Studio no longer displays Message-owned Emotion Profile or Available TTS Profile side tables.
+- PASS: TTS Studio parent table remains `TTS Profiles`.
+- PASS: Clicking a TTS Profile row opens the `Emotion Settings` child table.
+- PASS: `Man Profile 1` and `Woman Profile 2` seed Neutral, Happy, Angry, and Scared Emotion Settings.
+- PASS: No separate Emotion Studio was created.
+- PASS: No database schema changes were added.
+- PASS: Theme V2 and external JavaScript structure remain in use; no inline styles, style blocks, or inline handlers were added.
+
+## Git Workflow
+- Current branch: `codex/pr-26171-069-message-tts-profile-contract-alignment`
+- Created branch: `codex/pr-26171-069-message-tts-profile-contract-alignment`
+- Push result: pending at report creation
+- PR URL: pending at report creation
+- Merge result: pending at report creation
+- Final main commit: pending at report creation

docs_build/dev/reports/PR_26171_069-parent-child-table-checklist.md

@@ -0,0 +1,17 @@
+# PR_26171_069 Parent/Child Table Checklist
+
+## Message Studio
+- PASS: Parent table is `Messages`.
+- PASS: Message row click expands the child `Message Parts` table directly under the parent row.
+- PASS: Message Parts include Text, Emotion, and TTS Profile controls.
+- PASS: Message Parts provide row-level Play Part and inline edit behavior.
+- PASS: Message rows provide Play Message and inline edit behavior.
+- PASS: Stop is available from Message Studio playback controls.
+- PASS: Message-owned detached Emotion Profile and Available TTS Profile tables were removed.
+
+## TTS Studio
+- PASS: Parent table is `TTS Profiles`.
+- PASS: TTS Profile row click expands the child `Emotion Settings` table.
+- PASS: Emotion Settings belong to the selected TTS Profile.
+- PASS: Default profile data includes Neutral, Happy, Angry, and Scared settings for the example profiles.
+- PASS: No separate Emotion Studio was introduced.

docs_build/dev/reports/PR_26171_069-validation.md

@@ -0,0 +1,15 @@
+# PR_26171_069 Validation
+
+- PASS: `node --check toolbox/messages/messages.js`
+- PASS: `node --check toolbox/messages/message-tts-service-registry.js`
+- PASS: `node --check toolbox/text-to-speech/text2speech.js`
+- PASS: `node --check tests/playwright/tools/MessagesTool.spec.mjs`
+- PASS: `node --check tests/playwright/tools/TextToSpeechFunctional.spec.mjs`
+- PASS: `node --check tests/tools/Text2SpeechShell.test.mjs`
+- PASS: `node --test tests/tools/Text2SpeechShell.test.mjs`
+- PASS: `npx playwright test tests/playwright/tools/MessagesTool.spec.mjs tests/playwright/tools/TextToSpeechFunctional.spec.mjs --project=playwright --workers=1 --reporter=list`
+- PASS: `npm run test:workspace-v2`
+
+## Notes
+- `npm run test:workspace-v2` is the legacy command name; this report treats it as Project Workspace validation.
+- No full samples smoke was run.

docs_build/dev/reports/codex_changed_files.txt

@@ -1,54 +1,17 @@
-PR_26171_044-idea-board-game-hub-project-flow
-
-Changed files:
-- docs_build/pr/PR_26171_044-idea-board-game-hub-project-flow/PLAN_PR.md
-- docs_build/pr/PR_26171_044-idea-board-game-hub-project-flow/BUILD_PR.md
-- docs_build/pr/PR_26171_044-idea-board-game-hub-project-flow/APPLY_PR.md
-- docs_build/dev/reports/codex_review.diff
-- docs_build/dev/reports/codex_changed_files.txt
-- src/dev-runtime/persistence/tool-repositories/game-workspace-mock-repository.js
-- tests/playwright/tools/GameWorkspaceMockRepository.spec.mjs
-- tests/playwright/tools/IdeaBoardTableNotes.spec.mjs
-- tests/playwright/tools/ToolboxRoutePages.spec.mjs
-- toolbox/game-workspace/game-workspace.js
-- toolbox/game-workspace/index.html
-- toolbox/idea-board/index.html
-- toolbox/idea-board/index.js
-
-Requirement PASS evidence:
-- PASS: Create Project appears only for Ready ideas. Evidence: Idea Board actions remain Edit/Create Project/Delete for Ready rows and switch to Open in Game Hub/Archive after creation in targeted Playwright.
-- PASS: Create Project uses the shared Game Hub project contract. Evidence: Idea Board calls the existing game-workspace server repository client createGame method; Playwright asserts the createGame repository request occurs.
-- PASS: Create Project sets Idea status to Project. Evidence: targeted Playwright asserts the row status becomes Project.
-- PASS: Project ideas and notes are read-only. Evidence: targeted Playwright asserts no Edit/Delete/Add Note/note actions remain for the Project row.
-- PASS: Project row actions are Open in Game Hub and Archive. Evidence: targeted Playwright asserts exact action labels.
-- PASS: Project ideas cannot be edited or deleted while Project. Evidence: Project rows do not render Edit/Delete actions and deletion guard remains active.
-- PASS: Project ideas cannot add/edit/delete notes. Evidence: expanded Project notes render without Add Note or note actions.
-- PASS: Archived ideas remain hidden by default and show Restore/Delete when visible. Evidence: targeted Playwright archives, shows Archived through the filter, and asserts Restore/Delete.
-- PASS: Game Hub shows creator-facing Project Information. Evidence: Game Hub HTML/JS replaces internal record display with Project Information and targeted Game Hub Playwright passes.
-- PASS: Game Hub shows read-only Source Idea fields. Evidence: Idea Board-to-Game Hub Playwright asserts Idea, Pitch, and Notes from the source idea render in Game Hub.
-- PASS: Game Hub avoids internal IDs, DB/API/mock/debug/seed wording in creator-facing display. Evidence: touched runtime files pass creator-visible text scan and targeted Playwright checks the navigated Game Hub main content.
-- PASS: Open in Game Hub navigates to the related project. Evidence: targeted Playwright waits for /toolbox/game-workspace/index.html?game=lantern-reef-* and asserts the linked project renders.
-- PASS: No Game Journey expansion beyond existing link/reference. Evidence: implementation does not add Game Journey creation or new journey wiring.
-
-Validation evidence:
-- PASS: node --check toolbox/idea-board/index.js
-- PASS: node --check toolbox/game-workspace/game-workspace.js
-- PASS: node --check toolbox/game-workspace/game-workspace-api-client.js
-- PASS: node --check src/dev-runtime/persistence/tool-repositories/game-workspace-mock-repository.js
-- PASS: node --check tests/playwright/tools/IdeaBoardTableNotes.spec.mjs
-- PASS: node --check tests/playwright/tools/ToolboxRoutePages.spec.mjs
-- PASS: node --check tests/playwright/tools/GameWorkspaceMockRepository.spec.mjs
-- PASS: npx playwright test tests/playwright/tools/IdeaBoardTableNotes.spec.mjs --project=playwright --workers=1 --reporter=line
-- PASS: npx playwright test tests/playwright/tools/ToolboxRoutePages.spec.mjs --project=playwright --workers=1 --reporter=line --grep "Idea Board launches"
-- PASS: npx playwright test tests/playwright/tools/GameWorkspaceMockRepository.spec.mjs --project=playwright --workers=1 --reporter=line --grep "Game Hub"
-- PASS: npm run test:workspace-v2
-- PASS: git diff --check
-
-Git workflow:
-- Current branch: codex/pr-26171-044-idea-board-game-hub-project-flow
-- Created branch: codex/pr-26171-044-idea-board-game-hub-project-flow
-- Commit hash: 2a38796f81aae2dceb4151095b8f89a276cd2d32
-- Push result: pushed to origin/codex/pr-26171-044-idea-board-game-hub-project-flow
-- PR URL: https://github.com/ToolboxAid/HTML-JavaScript-Gaming/pull/22
-- Merge result: to be reported after merge
-- Final main commit: to be reported after returning to main and pulling latest
+A	docs_build/dev/reports/PR_26171_069-manual-validation-notes.md
+A	docs_build/dev/reports/PR_26171_069-message-tts-ownership-checklist.md
+A	docs_build/dev/reports/PR_26171_069-message-tts-profile-contract-alignment.md
+A	docs_build/dev/reports/PR_26171_069-parent-child-table-checklist.md
+A	docs_build/dev/reports/PR_26171_069-validation.md
+A	docs_build/pr/PR_26171_069-message-tts-profile-contract-alignment/APPLY_PR.md
+A	docs_build/pr/PR_26171_069-message-tts-profile-contract-alignment/BUILD_PR.md
+A	docs_build/pr/PR_26171_069-message-tts-profile-contract-alignment/PLAN_PR.md
+M	tests/playwright/tools/MessagesTool.spec.mjs
+M	tests/playwright/tools/TextToSpeechFunctional.spec.mjs
+M	tests/tools/Text2SpeechShell.test.mjs
+M	toolbox/messages/index.html
+M	toolbox/messages/message-tts-service-registry.js
+M	toolbox/messages/messages.js
+M	toolbox/text-to-speech/text2speech.js
+M	docs_build/dev/reports/codex_review.diff
+M	docs_build/dev/reports/codex_changed_files.txt

docs_build/dev/reports/codex_review.diff

@@ -0,0 +1,18 @@
+# PR_26171_069-message-tts-profile-contract-alignment Apply
+
+## Apply Steps
+
+1. Start from clean latest `main`.
+2. Create `codex/pr-26171-069-message-tts-profile-contract-alignment`.
+3. Implement only the BUILD scope.
+4. Run targeted Message Studio validation.
+5. Run targeted TTS Studio validation.
+6. Run `npm run test:workspace-v2`.
+7. Stage only scoped files.
+8. Commit.
+9. Push branch.
+10. Create PR.
+11. Resolve merge conflicts if encountered and rerun validation.
+12. Merge after validation passes.
+13. Return to `main` and pull latest.
+14. Produce final code file change list only, excluding MD, TXT, reports, and other non-code files.

docs_build/pr/PR_26171_069-message-tts-profile-contract-alignment/APPLY_PR.md

@@ -0,0 +1,61 @@
+# PR_26171_069-message-tts-profile-contract-alignment Build
+
+## Source Of Truth
+
+Use this BUILD doc, the original PR request, `docs_build/dev/PROJECT_INSTRUCTIONS.md`, and `docs_build/dev/PROJECT_MULTI_PC.txt`.
+
+## Singular Purpose
+
+Align Message Studio and TTS Studio around reusable TTS Profiles, per-profile Emotion Settings, and Message Parts playback.
+
+## Exact Targets
+
+- `toolbox/messages/index.html`
+- `toolbox/messages/messages.js`
+- `toolbox/messages/message-tts-service-registry.js`
+- `toolbox/text-to-speech/index.html`
+- `toolbox/text-to-speech/text2speech.js`
+- `src/engine/audio/TextToSpeechEngine.js`
+- Targeted Message Studio Playwright/unit tests.
+- Targeted TTS Studio Playwright/unit tests.
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- PR-specific report.
+- Message/TTS ownership checklist.
+- Parent-child table checklist.
+- Validation report.
+- Manual validation notes.
+
+## Requirements
+
+- Message Studio parent table is Messages.
+- Clicking a Message row opens the Message Parts child table.
+- Message Parts select Text, Emotion, and TTS Profile.
+- Message Studio exposes Play Part, Play Message, and Stop.
+- Message playback uses `src/engine/audio/TextToSpeechEngine`.
+- Default TTS Profile exists until real profiles are available.
+- TTS Studio parent table is TTS Profiles.
+- Clicking a TTS Profile row opens Emotion Settings child table.
+- Emotion settings belong to the selected TTS Profile.
+- Do not create separate Emotion Studio.
+- Include example profiles with Neutral, Happy, Angry, and Scared settings.
+- Message Studio owns text and ordered message parts.
+- TTS Studio owns reusable profiles and per-profile emotion settings.
+- `src/engine/audio` owns playback.
+- Audio owns generated/played output.
+- Use Theme V2 and external JavaScript only.
+- Do not add inline styles, style blocks, inline event handlers, page-local CSS, or tool-local CSS.
+- Do not add database changes unless an existing Local API contract already supports them.
+- Do not use browser-owned product data as source of truth.
+- Do not add silent fallbacks.
+
+## Validation
+
+- Run targeted Message Studio validation.
+- Run targeted TTS Studio validation.
+- Run `npm run test:workspace-v2`.
+- Do not run full samples smoke.
+
+## ZIP
+
+Produce `tmp/PR_26171_069-message-tts-profile-contract-alignment_delta.zip` with repo-structured changed files only.

docs_build/pr/PR_26171_069-message-tts-profile-contract-alignment/BUILD_PR.md

@@ -0,0 +1,32 @@
+# PR_26171_069-message-tts-profile-contract-alignment Plan
+
+## Purpose
+
+Align Message Studio and TTS Studio around the parent/child table model and shared TTS profile contract.
+
+## Scope
+
+- Message Studio owns Messages and ordered Message Parts.
+- Message Parts select Text, Emotion, and TTS Profile.
+- Message Studio provides Play Part, Play Message, and Stop using `src/engine/audio/TextToSpeechEngine`.
+- TTS Studio owns TTS Profiles and per-profile Emotion Settings.
+- TTS Profile rows expand to Emotion Settings child rows.
+- Keep Theme V2 only, external JavaScript only, no page-local or tool-local CSS.
+- Add targeted validation and required PR reports.
+
+## Non-Goals
+
+- Do not add database schema or persistence changes.
+- Do not create a separate Emotion Studio.
+- Do not introduce browser storage as product source of truth.
+- Do not change unrelated tools or shared runtime behavior beyond the audio playback contract needed by Message Studio.
+
+## Validation
+
+- Targeted Message Studio validation.
+- Targeted TTS Studio validation.
+- `npm run test:workspace-v2` with note that the command name is legacy and the user-facing language is Project Workspace.
+
+## Delivery
+
+- Commit, push, create PR, resolve conflicts if encountered, merge after validation passes, return to `main`, pull latest, and produce `tmp/PR_26171_069-message-tts-profile-contract-alignment_delta.zip`.