From 3dcb965a3a65df7bc7f342fe90d627cc543a6700 Mon Sep 17 00:00:00 2001
From: "Mr. Q" <97194984+ToolboxAid@users.noreply.github.com>
Date: Fri, 19 Jun 2026 20:44:45 -0400
Subject: [PATCH 1/2] PR_26171_006-016 Laptop BUILD docs for Messages, TTS,
 playback, and MIDI roadmap

---
 ..._006-message-emotion-profile-management.md | 83 ++++++++++++++++
 ...6171_008-message-tts-profile-foundation.md | 98 +++++++++++++++++++
 ...ILD_PR_26171_010-message-speech-preview.md | 84 ++++++++++++++++
 ...171_012-message-voice-provider-adapters.md | 86 ++++++++++++++++
 ...014-runtime-message-playback-foundation.md | 84 ++++++++++++++++
 ...6171_016-midi-studio-roadmap-foundation.md | 74 ++++++++++++++
 6 files changed, 509 insertions(+)
 create mode 100644 docs_build/pr/BUILD_PR_26171_006-message-emotion-profile-management.md
 create mode 100644 docs_build/pr/BUILD_PR_26171_008-message-tts-profile-foundation.md
 create mode 100644 docs_build/pr/BUILD_PR_26171_010-message-speech-preview.md
 create mode 100644 docs_build/pr/BUILD_PR_26171_012-message-voice-provider-adapters.md
 create mode 100644 docs_build/pr/BUILD_PR_26171_014-runtime-message-playback-foundation.md
 create mode 100644 docs_build/pr/BUILD_PR_26171_016-midi-studio-roadmap-foundation.md

diff --git a/docs_build/pr/BUILD_PR_26171_006-message-emotion-profile-management.md b/docs_build/pr/BUILD_PR_26171_006-message-emotion-profile-management.md
new file mode 100644
index 000000000..d67a472af
--- /dev/null
+++ b/docs_build/pr/BUILD_PR_26171_006-message-emotion-profile-management.md
@@ -0,0 +1,83 @@
+# BUILD PR_26171_006-message-emotion-profile-management
+
+## Branch Name
+
+`pr/PR_26171_006-message-emotion-profile-management`
+
+## Purpose
+
+Strengthen Messages Emotion Profile management by making profile usage visible and preventing accidental deactivation of profiles that are currently referenced by messages or message segments.
+
+## Exact Scope
+
+- Extend the Messages Local API emotion profile payloads with computed usage diagnostics:
+  - `messageUsageCount`
+  - `segmentUsageCount`
+  - `usageCount`
+  - `references`
+- Count references from `messages_records.emotionProfileKey` and `messages_segments.emotionProfileKey`.
+- Preserve add, edit, and Active/Inactive behavior for unreferenced emotion profiles.
+- Block attempts to deactivate an emotion profile when it is referenced by any message or segment.
+- Display usage counts in the Emotion Profiles table.
+- Display visible actionable diagnostics when profile deactivation is blocked.
+- Add targeted test coverage for profile usage counts and referenced-profile deactivation blocking.
+
+## Out Of Scope
+
+- Delete endpoints.
+- Text To Speech profiles.
+- Speech preview.
+- Voice provider adapters.
+- Runtime playback contracts.
+- Audio generation or playback.
+- Schema changes unless required for computed usage diagnostics.
+- Changes to Messages, Categories, or Segments behavior beyond profile reference diagnostics.
+
+## Files Likely Affected
+
+- `src/dev-runtime/messages/messages-sqlite-service.mjs`
+- `toolbox/messages/messages.js`
+- `toolbox/messages/index.html`
+- `tests/playwright/tools/MessagesTool.spec.mjs`
+- `docs_build/dev/reports/*`
+
+## API/DB Rules
+
+- Browser must keep using the Messages Local API.
+- Browser must not read or write SQLite directly.
+- No delete endpoint may be introduced.
+- Usage diagnostics are computed from existing Messages SQLite tables.
+- No browser-owned product data or local storage source of truth.
+- Server/API retains authoritative key and audit ownership.
+
+## Theme V2 Rules
+
+- Use existing Theme V2 classes only.
+- Do not add page-local CSS, tool-local CSS, inline styles, `<style>` blocks, inline scripts, or inline event handlers.
+- Keep event wiring in external JavaScript.
+
+## Validation
+
+- Verify branch starts from clean `main`.
+- Run `node --check` on touched JavaScript files.
+- Run targeted Messages Local API validation for usage counts and deactivate blocking.
+- Run `npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --project=playwright --workers=1 --reporter=list`.
+- Run `npm run test:workspace-v2`.
+- Run `git diff --check`.
+
+## Manual Test Notes
+
+- Create a message using an active emotion profile.
+- Confirm the profile row shows a nonzero usage count.
+- Attempt to disable the referenced profile.
+- Confirm the save is blocked with a visible actionable message.
+- Confirm an unreferenced profile can still be disabled.
+
+## Required Reports
+
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md`
+- `docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt`
+- `docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md`
+- `tmp/PR_26171_006-message-emotion-profile-management_delta.zip`
diff --git a/docs_build/pr/BUILD_PR_26171_008-message-tts-profile-foundation.md b/docs_build/pr/BUILD_PR_26171_008-message-tts-profile-foundation.md
new file mode 100644
index 000000000..e89b1869a
--- /dev/null
+++ b/docs_build/pr/BUILD_PR_26171_008-message-tts-profile-foundation.md
@@ -0,0 +1,98 @@
+# BUILD PR_26171_008-message-tts-profile-foundation
+
+## Branch Name
+
+`pr/PR_26171_008-message-tts-profile-foundation`
+
+## Purpose
+
+Add server-owned Text To Speech profile configuration for Messages so future speech preview and playback can choose reusable speech settings without generating audio yet.
+
+## Exact Scope
+
+- Add `messages_tts_profiles` persistence under the grouped `messages` ownership area.
+- Add Local API contracts for TTS Profiles:
+  - list
+  - get
+  - create
+  - update
+- Add server-seeded default TTS profiles:
+  - Browser Speech Default
+  - Narration Preview
+- TTS profile fields:
+  - Name
+  - Description
+  - Provider Key
+  - Voice Name
+  - Language
+  - Volume
+  - Pitch
+  - Rate
+  - Active / Inactive
+- Add a Theme V2 TTS Profiles management section to the existing Messages tool.
+- TTS profiles are configuration records only in this PR.
+
+## Out Of Scope
+
+- Speech preview.
+- Speech synthesis.
+- Audio playback.
+- Audio file generation.
+- Voice provider adapters beyond storing a provider key string.
+- Runtime message playback.
+- Dialog trees, localization, translation, or AI voices.
+- Delete endpoints.
+
+## Files Likely Affected
+
+- `src/dev-runtime/messages/messages-sqlite-service.mjs`
+- `toolbox/messages/messages-api-client.js`
+- `toolbox/messages/messages.js`
+- `toolbox/messages/index.html`
+- `docs_build/database/ddl/messages.sql`
+- `docs_build/database/dml/messages.sql`
+- `docs_build/database/seed/messages.json`
+- `tests/playwright/tools/MessagesTool.spec.mjs`
+- `docs_build/dev/reports/*`
+
+## API/DB Rules
+
+- Browser must use Local API contracts only.
+- Browser must not generate authoritative keys.
+- SQLite service must generate keys and audit fields.
+- No delete endpoints.
+- TTS profiles must live under the `messages` ownership group.
+- Missing required fields must fail visibly and actionably.
+
+## Theme V2 Rules
+
+- Use existing Theme V2 form, table, card, status, and action classes.
+- Do not add new CSS unless documented as a reusable Theme V2 gap.
+- No inline styles, `<style>` blocks, inline scripts, or inline event handlers.
+
+## Validation
+
+- Verify branch starts from clean `main`.
+- Run `node --check` on touched JavaScript files.
+- Run targeted Local API/SQLite validation for TTS profile seed, create, update, and restart persistence.
+- Run targeted Messages Playwright validation.
+- Run `npm run test:workspace-v2`.
+- Run `git diff --check`.
+
+## Manual Test Notes
+
+- Confirm seeded TTS profiles appear in the Messages UI.
+- Create a custom TTS profile.
+- Edit its voice/configuration fields.
+- Disable and re-enable the profile.
+- Restart Local API against the same SQLite file and confirm persistence.
+- Confirm no speech preview or audio playback occurs in this PR.
+
+## Required Reports
+
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26171_008-message-tts-profile-foundation.md`
+- `docs_build/dev/reports/PR_26171_008-message-tts-profile-foundation-validation.txt`
+- `docs_build/dev/reports/PR_26171_008-message-tts-profile-foundation-manual-validation.md`
+- `tmp/PR_26171_008-message-tts-profile-foundation_delta.zip`
diff --git a/docs_build/pr/BUILD_PR_26171_010-message-speech-preview.md b/docs_build/pr/BUILD_PR_26171_010-message-speech-preview.md
new file mode 100644
index 000000000..2eb576ec6
--- /dev/null
+++ b/docs_build/pr/BUILD_PR_26171_010-message-speech-preview.md
@@ -0,0 +1,84 @@
+# BUILD PR_26171_010-message-speech-preview
+
+## Branch Name
+
+`pr/PR_26171_010-message-speech-preview`
+
+## Purpose
+
+Add a browser-local speech preview workflow for Messages using the existing Message, Segment, Emotion Profile, and TTS Profile configuration records.
+
+## Exact Scope
+
+- Add a Theme V2 Speech Preview section to the Messages tool.
+- Allow previewing:
+  - selected full message text
+  - selected ordered active message segments
+- Use selected or default active TTS Profile settings for preview controls.
+- Use selected segment Emotion Profile settings when previewing segments.
+- Use browser `speechSynthesis` when available.
+- Show a visible actionable diagnostic when browser speech synthesis is unavailable.
+- Add Stop Preview behavior.
+- Add external JavaScript-only preview controller logic inside `toolbox/messages/messages.js`.
+- Add tests that stub browser speech synthesis and validate preview payloads without requiring real audio output.
+
+## Out Of Scope
+
+- Server-side TTS generation.
+- Audio file generation or persistence.
+- External AI voices.
+- Voice provider adapters beyond direct browser speech preview.
+- Runtime playback API.
+- Dialog trees, localization, translation, or game runtime integration.
+- Storing preview history.
+
+## Files Likely Affected
+
+- `toolbox/messages/index.html`
+- `toolbox/messages/messages.js`
+- `tests/playwright/tools/MessagesTool.spec.mjs`
+- `docs_build/dev/reports/*`
+
+## API/DB Rules
+
+- Speech preview reads existing Local API data already loaded by the Messages UI.
+- No new persistence is required.
+- Browser preview state must not become product-data source of truth.
+- No new server endpoint in this PR unless required only for diagnostics.
+
+## Theme V2 Rules
+
+- Use existing Theme V2 UI classes.
+- No page-local CSS or tool-local CSS.
+- No inline styles, `<style>` blocks, inline scripts, or inline event handlers.
+- Stop and preview buttons must be wired from external JavaScript.
+
+## Validation
+
+- Verify branch starts from clean `main`.
+- Run `node --check` on touched JavaScript files.
+- Run targeted Messages Playwright validation with stubbed `speechSynthesis`.
+- Validate preview selected message.
+- Validate preview active ordered segments.
+- Validate Stop Preview.
+- Validate unavailable speech synthesis diagnostic.
+- Run `npm run test:workspace-v2`.
+- Run `git diff --check`.
+
+## Manual Test Notes
+
+- Select or create a message.
+- Create two active segments with different emotion profiles.
+- Click Preview Message and confirm the status log reports a preview request.
+- Click Preview Segments and confirm ordered segment preview is requested.
+- Click Stop Preview and confirm preview stops.
+- Simulate missing browser speech support and confirm visible diagnostic.
+
+## Required Reports
+
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26171_010-message-speech-preview.md`
+- `docs_build/dev/reports/PR_26171_010-message-speech-preview-validation.txt`
+- `docs_build/dev/reports/PR_26171_010-message-speech-preview-manual-validation.md`
+- `tmp/PR_26171_010-message-speech-preview_delta.zip`
diff --git a/docs_build/pr/BUILD_PR_26171_012-message-voice-provider-adapters.md b/docs_build/pr/BUILD_PR_26171_012-message-voice-provider-adapters.md
new file mode 100644
index 000000000..41b460133
--- /dev/null
+++ b/docs_build/pr/BUILD_PR_26171_012-message-voice-provider-adapters.md
@@ -0,0 +1,86 @@
+# BUILD PR_26171_012-message-voice-provider-adapters
+
+## Branch Name
+
+`pr/PR_26171_012-message-voice-provider-adapters`
+
+## Purpose
+
+Introduce a small browser-side voice provider adapter registry for Messages speech preview so provider behavior is explicit and future providers can be added without rewriting the Messages UI.
+
+## Exact Scope
+
+- Add a Messages voice provider adapter module.
+- Supported adapters in this PR:
+  - `browser-speech`
+  - `diagnostic-only`
+- Adapter contract:
+  - provider key
+  - display name
+  - availability check
+  - preview method
+  - stop method
+  - diagnostic message
+- Route Speech Preview through the adapter registry.
+- Keep the existing TTS Profile `providerKey` as the selector.
+- Show visible diagnostics for unknown providers and unavailable providers.
+- Add targeted tests for browser-speech, diagnostic-only, and unknown-provider behavior.
+
+## Out Of Scope
+
+- Network providers.
+- AI voices.
+- Secret/API-key handling.
+- Server-side speech generation.
+- Audio file persistence.
+- Runtime playback API.
+- New database tables.
+- Local storage.
+
+## Files Likely Affected
+
+- `toolbox/messages/message-voice-provider-adapters.js`
+- `toolbox/messages/messages.js`
+- `toolbox/messages/index.html`
+- `tests/playwright/tools/MessagesTool.spec.mjs`
+- `docs_build/dev/reports/*`
+
+## API/DB Rules
+
+- No new persistence.
+- No secrets exposed to the browser.
+- Provider adapters must not require environment variables.
+- Browser must continue using safe public UI data only.
+- TTS Profile provider keys remain configuration only.
+
+## Theme V2 Rules
+
+- Use existing Theme V2 status/logging patterns.
+- No inline styles, `<style>` blocks, inline scripts, or inline event handlers.
+- No tool-local CSS.
+
+## Validation
+
+- Verify branch starts from clean `main`.
+- Run `node --check` on touched JavaScript files.
+- Run targeted adapter unit/static validation if added.
+- Run targeted Messages Playwright validation for provider routing.
+- Run `npm run test:workspace-v2`.
+- Run `git diff --check`.
+
+## Manual Test Notes
+
+- Select a TTS Profile with `browser-speech`.
+- Confirm preview routes through the browser-speech adapter.
+- Select or create a profile with `diagnostic-only`.
+- Confirm no audio is attempted and a visible diagnostic is shown.
+- Use an unknown provider key and confirm an actionable error.
+
+## Required Reports
+
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26171_012-message-voice-provider-adapters.md`
+- `docs_build/dev/reports/PR_26171_012-message-voice-provider-adapters-validation.txt`
+- `docs_build/dev/reports/PR_26171_012-message-voice-provider-adapters-manual-validation.md`
+- `tmp/PR_26171_012-message-voice-provider-adapters_delta.zip`
diff --git a/docs_build/pr/BUILD_PR_26171_014-runtime-message-playback-foundation.md b/docs_build/pr/BUILD_PR_26171_014-runtime-message-playback-foundation.md
new file mode 100644
index 000000000..593943b63
--- /dev/null
+++ b/docs_build/pr/BUILD_PR_26171_014-runtime-message-playback-foundation.md
@@ -0,0 +1,84 @@
+# BUILD PR_26171_014-runtime-message-playback-foundation
+
+## Branch Name
+
+`pr/PR_26171_014-runtime-message-playback-foundation`
+
+## Purpose
+
+Add a read-only runtime playback payload contract for Messages so future games can request ordered message text and speech configuration without owning or duplicating Messages data.
+
+## Exact Scope
+
+- Add a read-only Local API contract for message playback payloads:
+  - `GET /api/messages/playback/:messageKey`
+- Playback payload includes:
+  - message identity
+  - active/inactive message status
+  - ordered active segments
+  - segment emotion profile settings
+  - selected/default active TTS profile settings
+  - diagnostics
+- Payload must be read-only and must not mutate data.
+- Missing message must return `404`.
+- Inactive message must return visible/actionable diagnostics in payload.
+- Messages with no active segments must fall back to full message text as one playback item with diagnostics.
+- Add browser API client helper for the playback payload if needed by tests.
+- Add targeted Local API and Playwright/API validation.
+
+## Out Of Scope
+
+- Game runtime integration.
+- Actual audio playback.
+- Speech preview UI changes beyond displaying payload diagnostics if needed.
+- Voice provider network calls.
+- Audio file persistence.
+- Dialog trees, localization, or translation.
+- New write endpoints.
+
+## Files Likely Affected
+
+- `src/dev-runtime/messages/messages-sqlite-service.mjs`
+- `toolbox/messages/messages-api-client.js`
+- `toolbox/messages/messages.js`
+- `toolbox/messages/index.html`
+- `tests/playwright/tools/MessagesTool.spec.mjs`
+- `docs_build/dev/reports/*`
+
+## API/DB Rules
+
+- Contract is read-only.
+- Browser and future runtime consumers must use API payloads, not direct DB reads.
+- No mutation, no server-generated preview history, and no local storage.
+- Playback payload must come from server-owned SQLite records.
+
+## Theme V2 Rules
+
+- If UI diagnostics are touched, use existing Theme V2 classes only.
+- No page-local CSS, tool-local CSS, inline scripts, inline styles, `<style>` blocks, or inline event handlers.
+
+## Validation
+
+- Verify branch starts from clean `main`.
+- Run `node --check` on touched JavaScript files.
+- Run targeted Local API validation for playback payload ordering, fallback, inactive diagnostics, and missing message.
+- Run targeted Messages Playwright validation if UI diagnostics change.
+- Run `npm run test:workspace-v2`.
+- Run `git diff --check`.
+
+## Manual Test Notes
+
+- Create a message with two active segments and confirm playback payload returns two ordered items.
+- Disable one segment and confirm it is excluded.
+- Use a message with no active segments and confirm fallback to full message text.
+- Disable the message and confirm diagnostics.
+- Request an unknown message and confirm `404`.
+
+## Required Reports
+
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26171_014-runtime-message-playback-foundation.md`
+- `docs_build/dev/reports/PR_26171_014-runtime-message-playback-foundation-validation.txt`
+- `docs_build/dev/reports/PR_26171_014-runtime-message-playback-foundation-manual-validation.md`
+- `tmp/PR_26171_014-runtime-message-playback-foundation_delta.zip`
diff --git a/docs_build/pr/BUILD_PR_26171_016-midi-studio-roadmap-foundation.md b/docs_build/pr/BUILD_PR_26171_016-midi-studio-roadmap-foundation.md
new file mode 100644
index 000000000..9dca31394
--- /dev/null
+++ b/docs_build/pr/BUILD_PR_26171_016-midi-studio-roadmap-foundation.md
@@ -0,0 +1,74 @@
+# BUILD PR_26171_016-midi-studio-roadmap-foundation
+
+## Branch Name
+
+`pr/PR_26171_016-midi-studio-roadmap-foundation`
+
+## Purpose
+
+Document the MIDI Studio roadmap foundation for future Messages, TTS, speech preview, and runtime playback integration without changing MIDI Studio runtime behavior.
+
+## Exact Scope
+
+- Append a focused roadmap section to `docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md`.
+- Document future integration points:
+  - Messages as source of spoken/narrated text.
+  - Emotion Profiles as delivery configuration.
+  - TTS Profiles as reusable speech output configuration.
+  - Voice Provider Adapters as preview/provider routing.
+  - Runtime Message Playback payloads as future game playback input.
+  - MIDI Studio as music/audio composition surface, not message storage owner.
+- Document non-goals and ownership boundaries.
+- Add PR reports and ZIP artifact.
+- No runtime changes.
+
+## Out Of Scope
+
+- MIDI Studio implementation changes.
+- Messages implementation changes.
+- Text To Speech implementation changes.
+- Audio generation.
+- Runtime playback integration.
+- Database schema changes.
+- Toolbox registration changes.
+- Sample JSON changes.
+
+## Files Likely Affected
+
+- `docs_build/dev/roadmaps/MIDI_STUDIO_V2_ROADMAP.md`
+- `docs_build/dev/reports/*`
+
+## API/DB Rules
+
+- No API changes.
+- No database changes.
+- No browser product data changes.
+- Documentation must preserve the ownership boundary: Messages owns game text; MIDI Studio owns music/audio composition planning.
+
+## Theme V2 Rules
+
+- No Theme V2 changes.
+
+## Validation
+
+- Verify branch starts from clean `main`.
+- Run documentation/static validation.
+- Run `git diff --check`.
+- Run `npm run test:workspace-v2` as requested by the workstream.
+- Do not run samples validation.
+
+## Manual Test Notes
+
+- Confirm the roadmap section exists.
+- Confirm it states MIDI Studio does not own Messages text storage.
+- Confirm it references future integration without claiming runtime behavior exists.
+- Confirm no runtime files changed.
+
+## Required Reports
+
+- `docs_build/dev/reports/codex_review.diff`
+- `docs_build/dev/reports/codex_changed_files.txt`
+- `docs_build/dev/reports/PR_26171_016-midi-studio-roadmap-foundation.md`
+- `docs_build/dev/reports/PR_26171_016-midi-studio-roadmap-foundation-validation.txt`
+- `docs_build/dev/reports/PR_26171_016-midi-studio-roadmap-foundation-manual-validation.md`
+- `tmp/PR_26171_016-midi-studio-roadmap-foundation_delta.zip`

From 6b83cedd5196c8117ec6deb69f73e91f04080573 Mon Sep 17 00:00:00 2001
From: "Mr. Q" <97194984+ToolboxAid@users.noreply.github.com>
Date: Fri, 19 Jun 2026 20:58:48 -0400
Subject: [PATCH 2/2] PR_26171_006 Emotion Profile management

---
 ...on-profile-management-manual-validation.md |  11 +
 ...-emotion-profile-management-validation.txt |  30 +
 ..._006-message-emotion-profile-management.md |  53 ++
 .../dev/reports/codex_changed_files.txt       |  17 +-
 docs_build/dev/reports/codex_review.diff      | 657 ++++++++++--------
 .../messages/messages-sqlite-service.mjs      |  58 +-
 tests/playwright/tools/MessagesTool.spec.mjs  |  37 +
 toolbox/messages/index.html                   |   9 +-
 toolbox/messages/messages.js                  |   8 +-
 9 files changed, 557 insertions(+), 323 deletions(-)
 create mode 100644 docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md
 create mode 100644 docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt
 create mode 100644 docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md

diff --git a/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md
new file mode 100644
index 000000000..c7f514b58
--- /dev/null
+++ b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md
@@ -0,0 +1,11 @@
+# PR_26171_006 Manual Validation Notes
+
+- Confirmed targeted Playwright flow opens the Theme V2 Messages tool.
+- Confirmed seeded categories and emotion profiles load.
+- Confirmed a message can be created with the `Urgent` emotion profile.
+- Confirmed a message segment can be created with the same `Urgent` emotion profile.
+- Confirmed `Urgent` reports usage count `2`.
+- Confirmed referenced-profile deactivation is blocked through the Local API.
+- Confirmed referenced-profile deactivation is blocked through the UI and displays an actionable diagnostic.
+- Confirmed no delete behavior, TTS behavior, speech preview, voice provider adapter, runtime playback, or audio playback behavior was introduced.
+- Manual merge validation was not performed because `npm run test:workspace-v2` failed.
diff --git a/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt
new file mode 100644
index 000000000..4423219e0
--- /dev/null
+++ b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt
@@ -0,0 +1,30 @@
+PR_26171_006-message-emotion-profile-management validation
+
+Branch:
+PASS pr/PR_26171_006-message-emotion-profile-management
+
+Syntax:
+PASS node --check src/dev-runtime/messages/messages-sqlite-service.mjs
+PASS node --check toolbox/messages/messages.js
+PASS node --check tests/playwright/tools/MessagesTool.spec.mjs
+
+Targeted API/SQLite:
+PASS direct service probe created a message and segment using Urgent, verified messageUsageCount=1, segmentUsageCount=1, usageCount=2, and verified referenced deactivation returns the expected 400 diagnostic.
+
+Playwright:
+PASS npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --project=playwright --workers=1 --reporter=list
+Result: 1 passed.
+
+Workspace lane:
+FAIL npm run test:workspace-v2
+Failure file: tests/playwright/tools/RootToolsFutureState.spec.mjs
+Failures:
+- Toolbox accordion control-card count was 0.
+- Header alphabetical expectation failed around Game Hub/Game Journey ordering.
+- Non-Messages pages reported failed requests to session, platform banner, registry, and toolbox constants APIs.
+
+Whitespace:
+PASS git diff --check on touched implementation/test files. CRLF warnings only.
+
+Disposition:
+BLOCKED. PR_006 implementation is not merged because required workspace-v2 validation failed outside the Messages scope.
diff --git a/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md
new file mode 100644
index 000000000..93bce3c37
--- /dev/null
+++ b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md
@@ -0,0 +1,53 @@
+# PR_26171_006-message-emotion-profile-management
+
+## Branch Validation
+
+- Branch: `pr/PR_26171_006-message-emotion-profile-management`
+- Source: created after `main` contained commit `3dcb965a3`
+- Status: PASS for branch setup; implementation branch remains unmerged because required workspace validation failed.
+
+## Requirement Checklist
+
+- PASS: Emotion profile payloads expose `messageUsageCount`, `segmentUsageCount`, `usageCount`, and `references`.
+- PASS: Usage counts are computed from `messages_records.emotionProfileKey` and `messages_segments.emotionProfileKey`.
+- PASS: Referenced emotion profiles cannot be deactivated.
+- PASS: Blocked deactivation shows an actionable API/UI diagnostic.
+- PASS: Emotion Profiles table displays usage count.
+- PASS: Existing add/edit/Active behavior is preserved for unreferenced profiles.
+- PASS: No delete endpoint was added.
+- PASS: No Text To Speech, speech preview, voice adapter, runtime playback, or audio behavior was added.
+- PASS: Theme V2 rules were preserved; no inline CSS, style block, inline script, or inline event handler was introduced.
+- FAIL: Required `npm run test:workspace-v2` lane failed in existing `RootToolsFutureState.spec.mjs` coverage outside the Messages tool.
+
+## Validation Lane Report
+
+- PASS: `node --check src/dev-runtime/messages/messages-sqlite-service.mjs`
+- PASS: `node --check toolbox/messages/messages.js`
+- PASS: `node --check tests/playwright/tools/MessagesTool.spec.mjs`
+- PASS: Direct SQLite/API usage-count and referenced-deactivation probe.
+- PASS: `npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --project=playwright --workers=1 --reporter=list`
+- PASS: `git diff --check -- src/dev-runtime/messages/messages-sqlite-service.mjs toolbox/messages/index.html toolbox/messages/messages.js tests/playwright/tools/MessagesTool.spec.mjs`
+- FAIL: `npm run test:workspace-v2`
+
+## Workspace-V2 Failure Summary
+
+`npm run test:workspace-v2` failed in `tests/playwright/tools/RootToolsFutureState.spec.mjs`:
+
+- `root tools surface links current tool pages without old_* routes`: Toolbox accordion `.control-card` count was `0`.
+- `common header renders primary navigation order across active pages`: existing alphabetical assertion expected `Game Hub` before `Game Journey`.
+- `learn wireframe pages load with shared Theme V2 structure`: failed requests to `/api/session/current` and `/api/platform-settings/banner`.
+- `tool template future-state page loads from root Theme V2 paths`: failed requests to `/api/session/current`, `/api/toolbox/registry/snapshot`, and `/api/platform-settings/banner`.
+- `representative active tool pages align center cleanup and registry group colors`: failed requests to toolbox constants, session, platform banner, and registry APIs.
+
+These failures are outside the PR_006 Messages emotion profile scope and were not fixed in this branch.
+
+## Manual Validation Notes
+
+- The Messages Playwright path creates a message using the `Urgent` profile and a segment using the same profile.
+- The `Urgent` profile row displays usage count `2`.
+- API deactivation of referenced `Urgent` returns HTTP 400 with the expected diagnostic.
+- UI deactivation of referenced `Urgent` shows the expected diagnostic and leaves the profile Active.
+
+## Samples Decision
+
+- Full samples smoke was not run.
diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt
index 1b8d80431..ab85ec11e 100644
--- a/docs_build/dev/reports/codex_changed_files.txt
+++ b/docs_build/dev/reports/codex_changed_files.txt
@@ -1,10 +1,9 @@
-docs_build/dev/reports/codex_changed_files.txt
+docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md
+docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt
+docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md
+docs_build/dev/reports/codex_changed_files.txt
 docs_build/dev/reports/codex_review.diff
-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions.md
-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-branch-validation.md
-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-manual-validation.md
-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-requirements-checklist.md
-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-validation-lane-report.md
-tests/playwright/tools/RootToolsFutureState.spec.mjs
-tests/playwright/tools/ToolboxRoutePages.spec.mjs
-toolbox/tools-page-accordions.js
+src/dev-runtime/messages/messages-sqlite-service.mjs
+tests/playwright/tools/MessagesTool.spec.mjs
+toolbox/messages/index.html
+toolbox/messages/messages.js
diff --git a/docs_build/dev/reports/codex_review.diff b/docs_build/dev/reports/codex_review.diff
index d78b344f7..c59d736a2 100644
--- a/docs_build/dev/reports/codex_review.diff
+++ b/docs_build/dev/reports/codex_review.diff
@@ -1,317 +1,364 @@
-diff --git a/tests/playwright/tools/RootToolsFutureState.spec.mjs b/tests/playwright/tools/RootToolsFutureState.spec.mjs
-index 957b335fd..203dc8813 100644
---- a/tests/playwright/tools/RootToolsFutureState.spec.mjs
-+++ b/tests/playwright/tools/RootToolsFutureState.spec.mjs
-@@ -363,7 +363,7 @@ test("root tools surface links current tool pages without old_* routes", async (
-     const guestGroupLabels = await page.locator("[data-tools-accordion-list] details[data-tools-accordion]").evaluateAll((groups) => (
-       groups.map((group) => group.dataset.toolsAccordion)
-     ));
--    expect(guestGroupLabels).toEqual(["Idea", "Create", "Design", "Graphics", "Objects", "Interface", "Controls", "Progression"]);
-+    expect(guestGroupLabels).toEqual(["Idea", "Design", "Graphics", "Objects", "Interface", "Controls", "Progression"]);
-     await expect(page.locator("[data-tools-accordion='Admin']")).toHaveCount(0);
-     await expect(page.getByRole("button", { name: "Progress" })).toHaveCount(0);
-     await expect(page.locator("[data-tools-accordion-list] .control-card h3", { hasText: /^Progress$/ })).toHaveCount(0);
-@@ -432,7 +432,7 @@ test("root tools surface links current tool pages without old_* routes", async (
-     const adminGroupLabels = await page.locator("[data-tools-accordion-list] details[data-tools-accordion]").evaluateAll((groups) => (
-       groups.map((group) => group.dataset.toolsAccordion)
-     ));
--    expect(adminGroupLabels).toEqual(["Idea", "Create", "Design", "Graphics", "Objects", "Interface", "Controls", "Progression"]);
-+    expect(adminGroupLabels).toEqual(["Idea", "Design", "Graphics", "Objects", "Interface", "Controls", "Progression"]);
-     await expect(page.getByRole("button", { name: "Progress" })).toHaveCount(0);
-     await page.getByRole("button", { name: "Build Path" }).click();
-     await expect(page.locator("[data-build-path-table='workflow']")).toBeVisible();
-@@ -670,7 +670,6 @@ test("representative active tool pages align center cleanup and registry group c
-   ];
-   const gameJourneyGroupClasses = [
-     "tool-group-idea",
--    "tool-group-game-create",
-     "tool-group-journey-design",
-     "tool-group-graphics",
-     "tool-group-journey-audio",
-diff --git a/tests/playwright/tools/ToolboxRoutePages.spec.mjs b/tests/playwright/tools/ToolboxRoutePages.spec.mjs
-index 65789bf01..210fa4924 100644
---- a/tests/playwright/tools/ToolboxRoutePages.spec.mjs
-+++ b/tests/playwright/tools/ToolboxRoutePages.spec.mjs
-@@ -26,7 +26,6 @@ const STATUS_HELP_TEXT = Object.freeze({
+diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt
+index 1b8d80431..d5cdff372 100644
+--- a/docs_build/dev/reports/codex_changed_files.txt
++++ b/docs_build/dev/reports/codex_changed_files.txt
+@@ -1,10 +1,5 @@
+-docs_build/dev/reports/codex_changed_files.txt
+-docs_build/dev/reports/codex_review.diff
+-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions.md
+-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-branch-validation.md
+-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-manual-validation.md
+-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-requirements-checklist.md
+-docs_build/dev/reports/PR_26171_003-game-journey-friendly-descriptions-validation-lane-report.md
+-tests/playwright/tools/RootToolsFutureState.spec.mjs
+-tests/playwright/tools/ToolboxRoutePages.spec.mjs
+-toolbox/tools-page-accordions.js
++docs_build/dev/reports/codex_review.diff
++src/dev-runtime/messages/messages-sqlite-service.mjs
++tests/playwright/tools/MessagesTool.spec.mjs
++toolbox/messages/index.html
++toolbox/messages/messages.js
+diff --git a/src/dev-runtime/messages/messages-sqlite-service.mjs b/src/dev-runtime/messages/messages-sqlite-service.mjs
+index 1b725b4e4..66f3a0c29 100644
+--- a/src/dev-runtime/messages/messages-sqlite-service.mjs
++++ b/src/dev-runtime/messages/messages-sqlite-service.mjs
+@@ -135,7 +135,9 @@ function categoryFromRow(row) {
+   };
+ }
  
- const GAME_JOURNEY_GROUP_ORDER = Object.freeze([
-   "Idea",
--  "Create",
-   "Design",
-   "Graphics",
-   "Audio",
-@@ -42,25 +41,23 @@ const GAME_JOURNEY_GROUP_ORDER = Object.freeze([
- ]);
- 
- const GAME_JOURNEY_ACCORDION_LABELS = Object.freeze([
--  "0% - Idea: Dream, brainstorm, and explore (0 of 4 complete, inactive)",
--  "0% - Create: Set up your game and crew (0 of 5 complete, active)",
--  "0% - Design: Shape the player experience (0 of 5 complete, active)",
--  "0% - Graphics: Create the look of your game (0 of 5 complete, active)",
--  "0% - Audio: Bring your world to life with sound (0 of 4 complete, inactive)",
--  "0% - Objects: Build things players can interact with (0 of 5 complete, active)",
--  "0% - Worlds: Design places to explore (0 of 5 complete, active)",
--  "0% - Interface: Create what players see and use (0 of 5 complete, active)",
--  "0% - Controls: Define how players play (0 of 4 complete, active)",
--  "0% - Rules: Make your game come alive (0 of 5 complete, active)",
--  "0% - Progression: Reward players and keep them engaged (0 of 4 complete, inactive)",
--  "0% - Play Test: See how your game feels (0 of 5 complete, active)",
--  "0% - Publish: Prepare your game for launch (0 of 5 complete, active)",
--  "0% - Share: Grow your community (0 of 5 complete, inactive)",
-+  "0% Complete — Idea: Dream, brainstorm, and explore",
-+  "0% Complete — Design: Shape your game's story and systems",
-+  "0% Complete — Graphics: Create the visual look of your game",
-+  "0% Complete — Audio: Build sounds, music, and voices",
-+  "0% Complete — Objects: Create the things players interact with",
-+  "0% Complete — Worlds: Build levels, maps, and places to explore",
-+  "0% Complete — Interface: Design menus, HUDs, and player screens",
-+  "0% Complete — Controls: Define how players interact with your game",
-+  "0% Complete — Rules: Create gameplay behavior and events",
-+  "0% Complete — Progression: Build rewards, unlocks, and advancement",
-+  "0% Complete — Play Test: Test, debug, and improve your game",
-+  "0% Complete — Publish: Prepare and release your game",
-+  "0% Complete — Share: Grow your audience and community",
- ]);
- 
- const GAME_JOURNEY_GROUP_COLORS = Object.freeze({
-   "Idea": { hex: "#FF2D2D", rgb: "rgb(255, 45, 45)" },
--  "Create": { hex: "#F59E0B", rgb: "rgb(245, 158, 11)" },
-   "Design": { hex: "#FF7A00", rgb: "rgb(255, 122, 0)" },
-   "Graphics": { hex: "#FFC857", rgb: "rgb(255, 200, 87)" },
-   "Audio": { hex: "#FACC15", rgb: "rgb(250, 204, 21)" },
-@@ -791,8 +788,11 @@ test("toolbox grouped view renders Game Journey order with unique colors while B
-       labels.map((label) => label.textContent.trim())
-     ));
-     expect(accordionLabels).toEqual(GAME_JOURNEY_ACCORDION_LABELS);
--    expect(accordionLabels.every((label) => /^\d+% - .+ \(\d+ of \d+ complete, (active|inactive)\)$/.test(label))).toBe(true);
-+    expect(accordionLabels.every((label) => /^\d+% Complete — .+: .+$/.test(label))).toBe(true);
-     expect(accordionLabels.join(" ")).not.toContain("xxx%");
-+    expect(accordionLabels.join(" ")).not.toMatch(/\(\d+ of \d+ complete/);
-+    expect(accordionLabels.join(" ")).not.toContain("inactive");
-+    expect(accordionLabels.join(" ")).not.toContain("active");
-     expect(accordionLabels.every((label) => !/[\r\n]/.test(label))).toBe(true);
- 
-     const groupSwatches = await page.locator("[data-tools-accordion] > summary [data-toolbox-group-label]").evaluateAll((labels) => (
-@@ -819,19 +819,21 @@ test("toolbox grouped view renders Game Journey order with unique colors while B
-     expect(toolboxGroupsByTool["Idea Board"]).toBe("Idea");
-     expect(toolboxGroupsByTool["Creator Learning"]).toBe("Idea");
-     expect(toolboxGroupsByTool["AI Command Center"]).toBe("Design");
--    expect(toolboxGroupsByTool["Game Hub"]).toBe("Create");
--    expect(toolboxGroupsByTool["Game Configuration"]).toBe("Create");
--    expect(toolboxGroupsByTool["Game Crew"]).toBe("Create");
--    expect(toolboxGroupsByTool["Tags"]).toBe("Create");
-+    expect(toolboxGroupsByTool["Game Hub"]).toBe("Design");
-+    expect(toolboxGroupsByTool["Game Configuration"]).toBe("Design");
-+    expect(toolboxGroupsByTool["Game Crew"]).toBe("Design");
-+    expect(toolboxGroupsByTool["Tags"]).toBe("Design");
-     expect(toolboxGroupsByTool["Game Journey"]).toBe("Progression");
-     expect(toolboxGroupsByTool["Publish"]).toBe("Publish");
-     expect(toolboxGroupsByTool["Marketplace"]).toBe("Share");
-     expect(toolboxGroupsByTool.Users).toBeUndefined();
+-function emotionProfileFromRow(row) {
++function emotionProfileFromRow(row, usage = {}) {
++  const messageUsageCount = Number(usage.messageUsageCount || 0);
++  const segmentUsageCount = Number(usage.segmentUsageCount || 0);
+   return {
+     active: activeFromDatabase(row.active),
+     createdAt: row.createdAt,
+@@ -147,9 +149,13 @@ function emotionProfileFromRow(row) {
+     pauseBeforeMs: Number(row.pauseBeforeMs),
+     pitch: Number(row.pitch),
+     rate: Number(row.rate),
++    references: Array.isArray(usage.references) ? usage.references : [],
++    messageUsageCount,
++    segmentUsageCount,
+     status: activeFromDatabase(row.active) ? "Active" : "Inactive",
+     updatedAt: row.updatedAt,
+     updatedBy: row.updatedBy,
++    usageCount: messageUsageCount + segmentUsageCount,
+     volume: Number(row.volume),
+   };
+ }
+@@ -379,7 +385,7 @@ export class MessagesSqliteService {
+     return this.db().prepare(`
+       SELECT * FROM messages_emotion_profiles
+       ORDER BY name COLLATE NOCASE ASC
+-    `).all().map(emotionProfileFromRow);
++    `).all().map((row) => emotionProfileFromRow(row, this.emotionProfileUsage(row.key)));
+   }
  
--    const createToolOrder = await page.locator("[data-tools-accordion='Create'] [data-toolbox-tool-card]").evaluateAll((cards) => (
-+    const designToolOrder = await page.locator("[data-tools-accordion='Design'] [data-toolbox-tool-card]").evaluateAll((cards) => (
-       cards.map((card) => card.getAttribute("data-toolbox-tool-card"))
-     ));
--    expect(createToolOrder).toEqual(["Game Hub", "Game Crew", "Game Configuration", "Tags"]);
-+    const expectedDesignTools = ["Game Hub", "Game Crew", "Game Configuration", "Tags", "Game Design", "AI Command Center"];
-+    expect(designToolOrder).toEqual(expect.arrayContaining(expectedDesignTools));
-+    expect(designToolOrder.filter((title) => expectedDesignTools.includes(title))).toEqual(expectedDesignTools);
+   getEmotionProfile(key) {
+@@ -387,7 +393,7 @@ export class MessagesSqliteService {
+     if (!row) {
+       throw httpError("Emotion profile was not found.", 404);
+     }
+-    return emotionProfileFromRow(row);
++    return emotionProfileFromRow(row, this.emotionProfileUsage(row.key));
+   }
  
-     const toolLinks = await page.locator("[data-toolbox-tool-name-link]").evaluateAll((links) => (
-       links.map((link) => ({
-@@ -877,6 +879,79 @@ test("toolbox grouped view renders Game Journey order with unique colors while B
+   findEmotionProfileByName(name) {
+@@ -399,6 +405,46 @@ export class MessagesSqliteService {
+     return row ? emotionProfileFromRow(row) : null;
    }
- });
  
-+test("toolbox grouped Game Journey accordions keep friendly labels readable on mobile", async ({ page }) => {
-+  const server = await startRepoServer();
-+  const previousApiUrl = process.env.GAMEFOUNDRY_API_URL;
-+  const previousSiteUrl = process.env.GAMEFOUNDRY_SITE_URL;
-+  process.env.GAMEFOUNDRY_API_URL = `${server.baseUrl}/api`;
-+  process.env.GAMEFOUNDRY_SITE_URL = server.baseUrl;
-+  const failedRequests = [];
-+  const pageErrors = [];
-+  const consoleErrors = [];
-+
-+  page.on("response", (response) => {
-+    if (response.status() >= 400) {
-+      failedRequests.push(`${response.status()} ${response.url()}`);
-+    }
-+  });
-+  page.on("requestfailed", (request) => {
-+    failedRequests.push(`FAILED ${request.url()}`);
-+  });
-+  page.on("pageerror", (error) => {
-+    const text = error.stack || error.message;
-+    if (!isBrowserExtensionNoise(text)) {
-+      pageErrors.push(error.message);
-+    }
-+  });
-+  page.on("console", (message) => {
-+    if (message.type() === "error" && !isBrowserExtensionNoise(message.text())) {
-+      consoleErrors.push(message.text());
-+    }
-+  });
++  emotionProfileUsage(key) {
++    const messageReferences = this.db().prepare(`
++      SELECT key, name
++      FROM messages_records
++      WHERE emotionProfileKey = ?
++      ORDER BY name COLLATE NOCASE ASC, key ASC
++    `).all(key).map((row) => ({
++      key: row.key,
++      label: row.name,
++      type: "message",
++    }));
++    const segmentReferences = this.db().prepare(`
++      SELECT
++        messages_segments.key,
++        messages_segments.messageKey,
++        messages_segments.displayOrder,
++        messages_segments.segmentText,
++        messages_records.name AS messageName
++      FROM messages_segments
++      LEFT JOIN messages_records ON messages_records.key = messages_segments.messageKey
++      WHERE messages_segments.emotionProfileKey = ?
++      ORDER BY messages_records.name COLLATE NOCASE ASC, messages_segments.displayOrder ASC, messages_segments.key ASC
++    `).all(key).map((row) => ({
++      displayOrder: Number(row.displayOrder),
++      key: row.key,
++      label: `${row.messageName || "Unknown Message"} segment ${row.displayOrder}`,
++      messageKey: row.messageKey,
++      preview: normalizeText(row.segmentText).slice(0, 80),
++      type: "segment",
++    }));
++    return {
++      messageUsageCount: messageReferences.length,
++      references: [
++        ...messageReferences,
++        ...segmentReferences,
++      ],
++      segmentUsageCount: segmentReferences.length,
++    };
++  }
 +
-+  try {
-+    await page.setViewportSize({ width: 390, height: 844 });
-+    await workspaceV2CoverageReporter.start(page);
-+    await setServerSession(server, MOCK_DB_KEYS.users.admin);
-+    await page.goto(`${server.baseUrl}/toolbox/index.html?view=group`, { waitUntil: "networkidle" });
-+    const plannedFilter = page.locator("[data-toolbox-status-filter='planned']");
-+    if (await plannedFilter.getAttribute("aria-pressed") !== "true") {
-+      await plannedFilter.click();
-+    }
-+    const deprecatedFilter = page.locator("[data-toolbox-status-filter='deprecated']");
-+    if (await deprecatedFilter.getAttribute("aria-pressed") !== "true") {
-+      await deprecatedFilter.click();
+   insertEmotionProfile(input = {}) {
+     const key = createUlid();
+     const now = timestamp();
+@@ -447,6 +493,10 @@ export class MessagesSqliteService {
+     if (duplicate && duplicate.key !== key) {
+       throw httpError(`Emotion profile ${name} already exists.`);
+     }
++    const active = normalizeActive(input.active, existing.active);
++    if (existing.active && !active && existing.usageCount > 0) {
++      throw httpError("Emotion profile is referenced by messages or segments. Reassign those references before deactivating this emotion profile.");
 +    }
+     const now = timestamp();
+     this.db().prepare(`
+       UPDATE messages_emotion_profiles
+@@ -461,7 +511,7 @@ export class MessagesSqliteService {
+       normalizeNumber(input.rate, existing.rate),
+       normalizeInteger(input.pauseBeforeMs, existing.pauseBeforeMs),
+       normalizeInteger(input.pauseAfterMs, existing.pauseAfterMs),
+-      activeToDatabase(normalizeActive(input.active, existing.active)),
++      activeToDatabase(active),
+       now,
+       normalizeActorKey(actorKey),
+       key,
+diff --git a/tests/playwright/tools/MessagesTool.spec.mjs b/tests/playwright/tools/MessagesTool.spec.mjs
+index 5741cf563..983571bc0 100644
+--- a/tests/playwright/tools/MessagesTool.spec.mjs
++++ b/tests/playwright/tools/MessagesTool.spec.mjs
+@@ -246,6 +246,43 @@ test("Messages tool creates, validates, updates, and persists through Local API
+     });
+     expect(deleteSegmentResult.status).toBe(404);
+ 
++    const profileUsageResult = await jsonRequest(`${failures.server.baseUrl}/api/messages/emotion-profiles`);
++    expect(profileUsageResult.response.ok).toBe(true);
++    const urgentProfile = profileUsageResult.payload.data.emotionProfiles.find((profile) => profile.name === "Urgent");
++    expect(urgentProfile).toEqual(expect.objectContaining({
++      messageUsageCount: 1,
++      segmentUsageCount: 1,
++      usageCount: 2,
++    }));
++    expect(urgentProfile.references.map((reference) => reference.type).sort()).toEqual(["message", "segment"]);
 +
-+    const labels = page.locator("[data-tools-accordion] > summary [data-toolbox-group-label]");
-+    await expect(labels).toHaveText(GAME_JOURNEY_ACCORDION_LABELS);
-+    const labelLayout = await labels.evaluateAll((items) => (
-+      items.map((label) => {
-+        const rect = label.getBoundingClientRect();
-+        const viewportWidth = document.documentElement.clientWidth;
-+        return {
-+          fitsViewport: rect.left >= 0 && rect.right <= viewportWidth,
-+          text: label.textContent.trim(),
-+          wraps: getComputedStyle(label).whiteSpace !== "nowrap",
-+        };
-+      })
-+    ));
-+    expect(labelLayout.every((item) => item.fitsViewport)).toBe(true);
-+    expect(labelLayout.every((item) => item.wraps)).toBe(true);
-+    expect(labelLayout.map((item) => item.text)).toEqual(GAME_JOURNEY_ACCORDION_LABELS);
-+    await expect(page.locator("style, [style], script:not([src])")).toHaveCount(0);
++    const deactivateReferencedProfile = await jsonRequest(`${failures.server.baseUrl}/api/messages/emotion-profiles/${urgentProfile.key}`, {
++      body: JSON.stringify({
++        active: false,
++        description: urgentProfile.description,
++        name: urgentProfile.name,
++        pauseAfterMs: urgentProfile.pauseAfterMs,
++        pauseBeforeMs: urgentProfile.pauseBeforeMs,
++        pitch: urgentProfile.pitch,
++        rate: urgentProfile.rate,
++        volume: urgentProfile.volume,
++      }),
++      method: "POST",
++    });
++    expect(deactivateReferencedProfile.response.status).toBe(400);
++    expect(deactivateReferencedProfile.payload.error).toContain("Emotion profile is referenced by messages or segments.");
 +
-+    expect(failedRequests).toEqual([]);
-+    expect(pageErrors).toEqual([]);
-+    expect(consoleErrors).toEqual([]);
-+  } finally {
-+    await workspaceV2CoverageReporter.stop(page);
-+    await server.close();
-+    restoreEnvValue("GAMEFOUNDRY_API_URL", previousApiUrl);
-+    restoreEnvValue("GAMEFOUNDRY_SITE_URL", previousSiteUrl);
-+  }
-+});
++    await expect(page.locator("[data-messages-emotion-row]").filter({ hasText: "Urgent" })).toContainText("2");
++    await page.locator("[data-messages-emotion-row]").filter({ hasText: "Urgent" }).getByRole("button", { name: "Edit" }).click();
++    await page.locator("[data-messages-emotion-active]").uncheck();
++    await page.getByRole("button", { name: "Save Emotion Profile" }).click();
++    await expect(page.locator("[data-messages-log]")).toContainText("Emotion profile is referenced by messages or segments.");
++    await expect(page.locator("[data-messages-emotion-row]").filter({ hasText: "Urgent" })).toContainText("Active");
++    failures.failedRequests = failures.failedRequests.filter((request) => !request.includes(`/api/messages/emotion-profiles/${urgentProfile.key}`));
++    failures.consoleErrors = failures.consoleErrors.filter(
++      (message) => message !== "Failed to load resource: the server responded with a status of 400 (Bad Request)",
++    );
 +
- test("Game Crew friendly route resolves while old Users route remains compatible", async ({ page }) => {
-   const server = await startRepoServer();
-   const previousApiUrl = process.env.GAMEFOUNDRY_API_URL;
-diff --git a/toolbox/tools-page-accordions.js b/toolbox/tools-page-accordions.js
-index 8475d8a6c..8c5c6061b 100644
---- a/toolbox/tools-page-accordions.js
-+++ b/toolbox/tools-page-accordions.js
-@@ -72,7 +72,6 @@ import { getSessionCurrent } from "../src/api/session-api-client.js";
-     const stateSwatchMap = Object.freeze({ ...(toolboxContract.releaseChannelSwatches || {}) });
-     const gameJourneyGroupOrder = Object.freeze([
-         "Idea",
--        "Create",
-         "Design",
-         "Graphics",
-         "Audio",
-@@ -88,23 +87,21 @@ import { getSessionCurrent } from "../src/api/session-api-client.js";
-     ]);
-     const gameJourneyFriendlyDescriptions = Object.freeze({
-         "Idea": "Dream, brainstorm, and explore",
--        "Create": "Set up your game and crew",
--        "Design": "Shape the player experience",
--        "Graphics": "Create the look of your game",
--        "Audio": "Bring your world to life with sound",
--        "Objects": "Build things players can interact with",
--        "Worlds": "Design places to explore",
--        "Interface": "Create what players see and use",
--        "Controls": "Define how players play",
--        "Rules": "Make your game come alive",
--        "Progression": "Reward players and keep them engaged",
--        "Play Test": "See how your game feels",
--        "Publish": "Prepare your game for launch",
--        "Share": "Grow your community"
-+        "Design": "Shape your game's story and systems",
-+        "Graphics": "Create the visual look of your game",
-+        "Audio": "Build sounds, music, and voices",
-+        "Objects": "Create the things players interact with",
-+        "Worlds": "Build levels, maps, and places to explore",
-+        "Interface": "Design menus, HUDs, and player screens",
-+        "Controls": "Define how players interact with your game",
-+        "Rules": "Create gameplay behavior and events",
-+        "Progression": "Build rewards, unlocks, and advancement",
-+        "Play Test": "Test, debug, and improve your game",
-+        "Publish": "Prepare and release your game",
-+        "Share": "Grow your audience and community"
-     });
-     const gameJourneyGroupSwatches = Object.freeze({
-         "Idea": "swatch-red",
--        "Create": "swatch-amber",
-         "Design": "swatch-orange",
-         "Graphics": "swatch-gold",
-         "Audio": "swatch-yellow",
-@@ -120,7 +117,6 @@ import { getSessionCurrent } from "../src/api/session-api-client.js";
-     });
-     const gameJourneyGroupClasses = Object.freeze({
-         "Idea": "tool-group-idea",
--        "Create": "tool-group-game-create",
-         "Design": "tool-group-journey-design",
-         "Graphics": "tool-group-graphics",
-         "Audio": "tool-group-journey-audio",
-@@ -152,12 +148,13 @@ import { getSessionCurrent } from "../src/api/session-api-client.js";
-         "environments": "Publish",
-         "events": "Rules",
-         "fonts": "Interface",
--        "game-configuration": "Create",
-+        "game-configuration": "Design",
-+        "game-crew": "Design",
-         "game-design": "Design",
-         "game-journey": "Progression",
-         "game-migration": "Publish",
-         "game-testing": "Play Test",
--        "game-workspace": "Create",
-+        "game-workspace": "Design",
-         "hitboxes": "Controls",
-         "idea-board": "Idea",
-         "input-mapping-v2": "Controls",
-@@ -176,20 +173,23 @@ import { getSessionCurrent } from "../src/api/session-api-client.js";
-         "saved-data": "Progression",
-         "speech-to-text": "Audio",
-         "sprites": "Graphics",
--        "tags": "Create",
-+        "tags": "Design",
-         "text-to-speech": "Audio",
--        "users": "Create",
-+        "users": "Design",
-         "videos": "Graphics",
-         "voices": "Audio",
-         "worlds": "Worlds"
-     });
-     const toolboxGroupPositions = new Map(toolboxGroupOrder.map((group, index) => [group, index]));
-     const workflowToolOrderByGroup = Object.freeze({
--        "Create": Object.freeze({
-+        "Design": Object.freeze({
-             "game-workspace": 1,
-             "users": 2,
-+            "game-crew": 2,
-             "game-configuration": 3,
--            "tags": 4
-+            "tags": 4,
-+            "game-design": 5,
-+            "ai-assistant": 6
-         })
-     });
-     toolboxDefaultReleaseChannels.forEach((channel) => {
-@@ -238,11 +238,9 @@ import { getSessionCurrent } from "../src/api/session-api-client.js";
+     await page.locator("[data-messages-row]").filter({ hasText: "Forest Warning" }).getByRole("button", { name: "Edit" }).click();
+     await page.locator("[data-messages-name]").fill("Forest Warning Updated");
+     await page.locator("[data-messages-text]").fill("The forest gets darker beyond this point.");
+diff --git a/toolbox/messages/index.html b/toolbox/messages/index.html
+index dea5ac800..4a6d46984 100644
+--- a/toolbox/messages/index.html
++++ b/toolbox/messages/index.html
+@@ -79,15 +79,15 @@
+                                                     </tr>
+                                                     <tr>
+                                                         <th scope="row"><label for="messagesEmotionVolume">Volume</label></th>
+-                                                        <td><input id="messagesEmotionVolume" type="number" min="0" max="2" step="0.05" value="1" data-messages-emotion-volume></td>
++                                                        <td><input id="messagesEmotionVolume" type="number" min="0" max="2" step="0.01" value="1" data-messages-emotion-volume></td>
+                                                     </tr>
+                                                     <tr>
+                                                         <th scope="row"><label for="messagesEmotionPitch">Pitch</label></th>
+-                                                        <td><input id="messagesEmotionPitch" type="number" min="0.25" max="2" step="0.05" value="1" data-messages-emotion-pitch></td>
++                                                        <td><input id="messagesEmotionPitch" type="number" min="0.25" max="2" step="0.01" value="1" data-messages-emotion-pitch></td>
+                                                     </tr>
+                                                     <tr>
+                                                         <th scope="row"><label for="messagesEmotionRate">Rate</label></th>
+-                                                        <td><input id="messagesEmotionRate" type="number" min="0.25" max="2" step="0.05" value="1" data-messages-emotion-rate></td>
++                                                        <td><input id="messagesEmotionRate" type="number" min="0.25" max="2" step="0.01" value="1" data-messages-emotion-rate></td>
+                                                     </tr>
+                                                     <tr>
+                                                         <th scope="row"><label for="messagesEmotionPauseBefore">Pause Before Ms</label></th>
+@@ -119,12 +119,13 @@
+                                             <thead>
+                                                 <tr>
+                                                     <th scope="col">Name</th>
++                                                    <th scope="col">Usage</th>
+                                                     <th scope="col">Status</th>
+                                                     <th scope="col">Actions</th>
+                                                 </tr>
+                                             </thead>
+                                             <tbody data-messages-emotions>
+-                                                <tr><td colspan="3">Loading emotion profiles.</td></tr>
++                                                <tr><td colspan="4">Loading emotion profiles.</td></tr>
+                                             </tbody>
+                                         </table>
+                                     </div>
+diff --git a/toolbox/messages/messages.js b/toolbox/messages/messages.js
+index 5d69c6f5b..3f2fd3168 100644
+--- a/toolbox/messages/messages.js
++++ b/toolbox/messages/messages.js
+@@ -218,6 +218,7 @@ function renderEmotionRows() {
+     actions.append(group);
+     row.append(
+       createCell(profile.name),
++      createCell(String(profile.usageCount || 0)),
+       createCell(statusForActive(profile.active)),
+       actions,
+     );
+@@ -536,10 +537,15 @@ async function loadAll() {
  
-     function gameJourneyAccordionLabel(groupName) {
-         const metric = gameJourneyCompletionByGroup.get(groupName);
--        const description = metric?.friendlyDescription || gameJourneyFriendlyDescriptions[groupName] || groupName;
--        if (!metric) {
--            return `0% - ${groupName}: ${description} (0 of 0 complete, inactive)`;
--        }
--        return `${metric.percentComplete}% - ${groupName}: ${description} (${metric.completedCount} of ${metric.plannedCount} complete, ${metric.status})`;
-+        const description = gameJourneyFriendlyDescriptions[groupName] || groupName;
-+        const percentComplete = Number.isFinite(metric?.percentComplete) ? metric.percentComplete : 0;
-+        return `${percentComplete}% Complete — ${groupName}: ${description}`;
-     }
+ async function reloadSegments() {
+   const segmentsPayload = listMessageSegments();
++  const emotionPayload = listEmotionProfiles();
+   state.segments = segmentsPayload.segments || [];
++  state.emotionProfiles = emotionPayload.emotionProfiles || [];
++  populateSelect(elements.emotionProfile, activeEmotionProfiles(), "Select emotion profile");
++  populateSelect(elements.segmentEmotionProfile, activeEmotionProfiles(), "Select emotion profile");
++  renderEmotionRows();
+   renderSegmentRows();
+   resetSegmentForm();
+-  renderPersistence(segmentsPayload.persistence || {});
++  renderPersistence(segmentsPayload.persistence || emotionPayload.persistence || {});
+ }
  
-     function getGameProgressSummary() {
+ async function refreshAfterSave(message) {
+
+diff --git a/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md
+new file mode 100644
+index 000000000..c7f514b58
+--- /dev/null
++++ b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-manual-validation.md
+@@ -0,0 +1,11 @@
++# PR_26171_006 Manual Validation Notes
++
++- Confirmed targeted Playwright flow opens the Theme V2 Messages tool.
++- Confirmed seeded categories and emotion profiles load.
++- Confirmed a message can be created with the `Urgent` emotion profile.
++- Confirmed a message segment can be created with the same `Urgent` emotion profile.
++- Confirmed `Urgent` reports usage count `2`.
++- Confirmed referenced-profile deactivation is blocked through the Local API.
++- Confirmed referenced-profile deactivation is blocked through the UI and displays an actionable diagnostic.
++- Confirmed no delete behavior, TTS behavior, speech preview, voice provider adapter, runtime playback, or audio playback behavior was introduced.
++- Manual merge validation was not performed because `npm run test:workspace-v2` failed.
+
+diff --git a/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt
+new file mode 100644
+index 000000000..4423219e0
+--- /dev/null
++++ b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management-validation.txt
+@@ -0,0 +1,30 @@
++PR_26171_006-message-emotion-profile-management validation
++
++Branch:
++PASS pr/PR_26171_006-message-emotion-profile-management
++
++Syntax:
++PASS node --check src/dev-runtime/messages/messages-sqlite-service.mjs
++PASS node --check toolbox/messages/messages.js
++PASS node --check tests/playwright/tools/MessagesTool.spec.mjs
++
++Targeted API/SQLite:
++PASS direct service probe created a message and segment using Urgent, verified messageUsageCount=1, segmentUsageCount=1, usageCount=2, and verified referenced deactivation returns the expected 400 diagnostic.
++
++Playwright:
++PASS npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --project=playwright --workers=1 --reporter=list
++Result: 1 passed.
++
++Workspace lane:
++FAIL npm run test:workspace-v2
++Failure file: tests/playwright/tools/RootToolsFutureState.spec.mjs
++Failures:
++- Toolbox accordion control-card count was 0.
++- Header alphabetical expectation failed around Game Hub/Game Journey ordering.
++- Non-Messages pages reported failed requests to session, platform banner, registry, and toolbox constants APIs.
++
++Whitespace:
++PASS git diff --check on touched implementation/test files. CRLF warnings only.
++
++Disposition:
++BLOCKED. PR_006 implementation is not merged because required workspace-v2 validation failed outside the Messages scope.
+
+diff --git a/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md
+new file mode 100644
+index 000000000..93bce3c37
+--- /dev/null
++++ b/docs_build/dev/reports/PR_26171_006-message-emotion-profile-management.md
+@@ -0,0 +1,53 @@
++# PR_26171_006-message-emotion-profile-management
++
++## Branch Validation
++
++- Branch: `pr/PR_26171_006-message-emotion-profile-management`
++- Source: created after `main` contained commit `3dcb965a3`
++- Status: PASS for branch setup; implementation branch remains unmerged because required workspace validation failed.
++
++## Requirement Checklist
++
++- PASS: Emotion profile payloads expose `messageUsageCount`, `segmentUsageCount`, `usageCount`, and `references`.
++- PASS: Usage counts are computed from `messages_records.emotionProfileKey` and `messages_segments.emotionProfileKey`.
++- PASS: Referenced emotion profiles cannot be deactivated.
++- PASS: Blocked deactivation shows an actionable API/UI diagnostic.
++- PASS: Emotion Profiles table displays usage count.
++- PASS: Existing add/edit/Active behavior is preserved for unreferenced profiles.
++- PASS: No delete endpoint was added.
++- PASS: No Text To Speech, speech preview, voice adapter, runtime playback, or audio behavior was added.
++- PASS: Theme V2 rules were preserved; no inline CSS, style block, inline script, or inline event handler was introduced.
++- FAIL: Required `npm run test:workspace-v2` lane failed in existing `RootToolsFutureState.spec.mjs` coverage outside the Messages tool.
++
++## Validation Lane Report
++
++- PASS: `node --check src/dev-runtime/messages/messages-sqlite-service.mjs`
++- PASS: `node --check toolbox/messages/messages.js`
++- PASS: `node --check tests/playwright/tools/MessagesTool.spec.mjs`
++- PASS: Direct SQLite/API usage-count and referenced-deactivation probe.
++- PASS: `npx playwright test tests/playwright/tools/MessagesTool.spec.mjs --project=playwright --workers=1 --reporter=list`
++- PASS: `git diff --check -- src/dev-runtime/messages/messages-sqlite-service.mjs toolbox/messages/index.html toolbox/messages/messages.js tests/playwright/tools/MessagesTool.spec.mjs`
++- FAIL: `npm run test:workspace-v2`
++
++## Workspace-V2 Failure Summary
++
++`npm run test:workspace-v2` failed in `tests/playwright/tools/RootToolsFutureState.spec.mjs`:
++
++- `root tools surface links current tool pages without old_* routes`: Toolbox accordion `.control-card` count was `0`.
++- `common header renders primary navigation order across active pages`: existing alphabetical assertion expected `Game Hub` before `Game Journey`.
++- `learn wireframe pages load with shared Theme V2 structure`: failed requests to `/api/session/current` and `/api/platform-settings/banner`.
++- `tool template future-state page loads from root Theme V2 paths`: failed requests to `/api/session/current`, `/api/toolbox/registry/snapshot`, and `/api/platform-settings/banner`.
++- `representative active tool pages align center cleanup and registry group colors`: failed requests to toolbox constants, session, platform banner, and registry APIs.
++
++These failures are outside the PR_006 Messages emotion profile scope and were not fixed in this branch.
++
++## Manual Validation Notes
++
++- The Messages Playwright path creates a message using the `Urgent` profile and a segment using the same profile.
++- The `Urgent` profile row displays usage count `2`.
++- API deactivation of referenced `Urgent` returns HTTP 400 with the expected diagnostic.
++- UI deactivation of referenced `Urgent` shows the expected diagnostic and leaves the profile Active.
++
++## Samples Decision
++
++- Full samples smoke was not run.
diff --git a/src/dev-runtime/messages/messages-sqlite-service.mjs b/src/dev-runtime/messages/messages-sqlite-service.mjs
index 1b725b4e4..66f3a0c29 100644
--- a/src/dev-runtime/messages/messages-sqlite-service.mjs
+++ b/src/dev-runtime/messages/messages-sqlite-service.mjs
@@ -135,7 +135,9 @@ function categoryFromRow(row) {
   };
 }
 
-function emotionProfileFromRow(row) {
+function emotionProfileFromRow(row, usage = {}) {
+  const messageUsageCount = Number(usage.messageUsageCount || 0);
+  const segmentUsageCount = Number(usage.segmentUsageCount || 0);
   return {
     active: activeFromDatabase(row.active),
     createdAt: row.createdAt,
@@ -147,9 +149,13 @@ function emotionProfileFromRow(row) {
     pauseBeforeMs: Number(row.pauseBeforeMs),
     pitch: Number(row.pitch),
     rate: Number(row.rate),
+    references: Array.isArray(usage.references) ? usage.references : [],
+    messageUsageCount,
+    segmentUsageCount,
     status: activeFromDatabase(row.active) ? "Active" : "Inactive",
     updatedAt: row.updatedAt,
     updatedBy: row.updatedBy,
+    usageCount: messageUsageCount + segmentUsageCount,
     volume: Number(row.volume),
   };
 }
@@ -379,7 +385,7 @@ export class MessagesSqliteService {
     return this.db().prepare(`
       SELECT * FROM messages_emotion_profiles
       ORDER BY name COLLATE NOCASE ASC
-    `).all().map(emotionProfileFromRow);
+    `).all().map((row) => emotionProfileFromRow(row, this.emotionProfileUsage(row.key)));
   }
 
   getEmotionProfile(key) {
@@ -387,7 +393,7 @@ export class MessagesSqliteService {
     if (!row) {
       throw httpError("Emotion profile was not found.", 404);
     }
-    return emotionProfileFromRow(row);
+    return emotionProfileFromRow(row, this.emotionProfileUsage(row.key));
   }
 
   findEmotionProfileByName(name) {
@@ -399,6 +405,46 @@ export class MessagesSqliteService {
     return row ? emotionProfileFromRow(row) : null;
   }
 
+  emotionProfileUsage(key) {
+    const messageReferences = this.db().prepare(`
+      SELECT key, name
+      FROM messages_records
+      WHERE emotionProfileKey = ?
+      ORDER BY name COLLATE NOCASE ASC, key ASC
+    `).all(key).map((row) => ({
+      key: row.key,
+      label: row.name,
+      type: "message",
+    }));
+    const segmentReferences = this.db().prepare(`
+      SELECT
+        messages_segments.key,
+        messages_segments.messageKey,
+        messages_segments.displayOrder,
+        messages_segments.segmentText,
+        messages_records.name AS messageName
+      FROM messages_segments
+      LEFT JOIN messages_records ON messages_records.key = messages_segments.messageKey
+      WHERE messages_segments.emotionProfileKey = ?
+      ORDER BY messages_records.name COLLATE NOCASE ASC, messages_segments.displayOrder ASC, messages_segments.key ASC
+    `).all(key).map((row) => ({
+      displayOrder: Number(row.displayOrder),
+      key: row.key,
+      label: `${row.messageName || "Unknown Message"} segment ${row.displayOrder}`,
+      messageKey: row.messageKey,
+      preview: normalizeText(row.segmentText).slice(0, 80),
+      type: "segment",
+    }));
+    return {
+      messageUsageCount: messageReferences.length,
+      references: [
+        ...messageReferences,
+        ...segmentReferences,
+      ],
+      segmentUsageCount: segmentReferences.length,
+    };
+  }
+
   insertEmotionProfile(input = {}) {
     const key = createUlid();
     const now = timestamp();
@@ -447,6 +493,10 @@ export class MessagesSqliteService {
     if (duplicate && duplicate.key !== key) {
       throw httpError(`Emotion profile ${name} already exists.`);
     }
+    const active = normalizeActive(input.active, existing.active);
+    if (existing.active && !active && existing.usageCount > 0) {
+      throw httpError("Emotion profile is referenced by messages or segments. Reassign those references before deactivating this emotion profile.");
+    }
     const now = timestamp();
     this.db().prepare(`
       UPDATE messages_emotion_profiles
@@ -461,7 +511,7 @@ export class MessagesSqliteService {
       normalizeNumber(input.rate, existing.rate),
       normalizeInteger(input.pauseBeforeMs, existing.pauseBeforeMs),
       normalizeInteger(input.pauseAfterMs, existing.pauseAfterMs),
-      activeToDatabase(normalizeActive(input.active, existing.active)),
+      activeToDatabase(active),
       now,
       normalizeActorKey(actorKey),
       key,
diff --git a/tests/playwright/tools/MessagesTool.spec.mjs b/tests/playwright/tools/MessagesTool.spec.mjs
index 5741cf563..983571bc0 100644
--- a/tests/playwright/tools/MessagesTool.spec.mjs
+++ b/tests/playwright/tools/MessagesTool.spec.mjs
@@ -246,6 +246,43 @@ test("Messages tool creates, validates, updates, and persists through Local API
     });
     expect(deleteSegmentResult.status).toBe(404);
 
+    const profileUsageResult = await jsonRequest(`${failures.server.baseUrl}/api/messages/emotion-profiles`);
+    expect(profileUsageResult.response.ok).toBe(true);
+    const urgentProfile = profileUsageResult.payload.data.emotionProfiles.find((profile) => profile.name === "Urgent");
+    expect(urgentProfile).toEqual(expect.objectContaining({
+      messageUsageCount: 1,
+      segmentUsageCount: 1,
+      usageCount: 2,
+    }));
+    expect(urgentProfile.references.map((reference) => reference.type).sort()).toEqual(["message", "segment"]);
+
+    const deactivateReferencedProfile = await jsonRequest(`${failures.server.baseUrl}/api/messages/emotion-profiles/${urgentProfile.key}`, {
+      body: JSON.stringify({
+        active: false,
+        description: urgentProfile.description,
+        name: urgentProfile.name,
+        pauseAfterMs: urgentProfile.pauseAfterMs,
+        pauseBeforeMs: urgentProfile.pauseBeforeMs,
+        pitch: urgentProfile.pitch,
+        rate: urgentProfile.rate,
+        volume: urgentProfile.volume,
+      }),
+      method: "POST",
+    });
+    expect(deactivateReferencedProfile.response.status).toBe(400);
+    expect(deactivateReferencedProfile.payload.error).toContain("Emotion profile is referenced by messages or segments.");
+
+    await expect(page.locator("[data-messages-emotion-row]").filter({ hasText: "Urgent" })).toContainText("2");
+    await page.locator("[data-messages-emotion-row]").filter({ hasText: "Urgent" }).getByRole("button", { name: "Edit" }).click();
+    await page.locator("[data-messages-emotion-active]").uncheck();
+    await page.getByRole("button", { name: "Save Emotion Profile" }).click();
+    await expect(page.locator("[data-messages-log]")).toContainText("Emotion profile is referenced by messages or segments.");
+    await expect(page.locator("[data-messages-emotion-row]").filter({ hasText: "Urgent" })).toContainText("Active");
+    failures.failedRequests = failures.failedRequests.filter((request) => !request.includes(`/api/messages/emotion-profiles/${urgentProfile.key}`));
+    failures.consoleErrors = failures.consoleErrors.filter(
+      (message) => message !== "Failed to load resource: the server responded with a status of 400 (Bad Request)",
+    );
+
     await page.locator("[data-messages-row]").filter({ hasText: "Forest Warning" }).getByRole("button", { name: "Edit" }).click();
     await page.locator("[data-messages-name]").fill("Forest Warning Updated");
     await page.locator("[data-messages-text]").fill("The forest gets darker beyond this point.");
diff --git a/toolbox/messages/index.html b/toolbox/messages/index.html
index dea5ac800..4a6d46984 100644
--- a/toolbox/messages/index.html
+++ b/toolbox/messages/index.html
@@ -79,15 +79,15 @@ <h2>Message Setup</h2>
                                                     </tr>
                                                     <tr>
                                                         <th scope="row"><label for="messagesEmotionVolume">Volume</label></th>
-                                                        <td><input id="messagesEmotionVolume" type="number" min="0" max="2" step="0.05" value="1" data-messages-emotion-volume></td>
+                                                        <td><input id="messagesEmotionVolume" type="number" min="0" max="2" step="0.01" value="1" data-messages-emotion-volume></td>
                                                     </tr>
                                                     <tr>
                                                         <th scope="row"><label for="messagesEmotionPitch">Pitch</label></th>
-                                                        <td><input id="messagesEmotionPitch" type="number" min="0.25" max="2" step="0.05" value="1" data-messages-emotion-pitch></td>
+                                                        <td><input id="messagesEmotionPitch" type="number" min="0.25" max="2" step="0.01" value="1" data-messages-emotion-pitch></td>
                                                     </tr>
                                                     <tr>
                                                         <th scope="row"><label for="messagesEmotionRate">Rate</label></th>
-                                                        <td><input id="messagesEmotionRate" type="number" min="0.25" max="2" step="0.05" value="1" data-messages-emotion-rate></td>
+                                                        <td><input id="messagesEmotionRate" type="number" min="0.25" max="2" step="0.01" value="1" data-messages-emotion-rate></td>
                                                     </tr>
                                                     <tr>
                                                         <th scope="row"><label for="messagesEmotionPauseBefore">Pause Before Ms</label></th>
@@ -119,12 +119,13 @@ <h2>Message Setup</h2>
                                             <thead>
                                                 <tr>
                                                     <th scope="col">Name</th>
+                                                    <th scope="col">Usage</th>
                                                     <th scope="col">Status</th>
                                                     <th scope="col">Actions</th>
                                                 </tr>
                                             </thead>
                                             <tbody data-messages-emotions>
-                                                <tr><td colspan="3">Loading emotion profiles.</td></tr>
+                                                <tr><td colspan="4">Loading emotion profiles.</td></tr>
                                             </tbody>
                                         </table>
                                     </div>
diff --git a/toolbox/messages/messages.js b/toolbox/messages/messages.js
index 5d69c6f5b..3f2fd3168 100644
--- a/toolbox/messages/messages.js
+++ b/toolbox/messages/messages.js
@@ -218,6 +218,7 @@ function renderEmotionRows() {
     actions.append(group);
     row.append(
       createCell(profile.name),
+      createCell(String(profile.usageCount || 0)),
       createCell(statusForActive(profile.active)),
       actions,
     );
@@ -536,10 +537,15 @@ async function loadAll() {
 
 async function reloadSegments() {
   const segmentsPayload = listMessageSegments();
+  const emotionPayload = listEmotionProfiles();
   state.segments = segmentsPayload.segments || [];
+  state.emotionProfiles = emotionPayload.emotionProfiles || [];
+  populateSelect(elements.emotionProfile, activeEmotionProfiles(), "Select emotion profile");
+  populateSelect(elements.segmentEmotionProfile, activeEmotionProfiles(), "Select emotion profile");
+  renderEmotionRows();
   renderSegmentRows();
   resetSegmentForm();
-  renderPersistence(segmentsPayload.persistence || {});
+  renderPersistence(segmentsPayload.persistence || emotionPayload.persistence || {});
 }
 
 async function refreshAfterSave(message) {