@rubytech/create-maxy-code 0.1.174 → 0.1.177

package/payload/premium-plugins/writer-craft/mcp/src/tools/voice-retrieve-conditioning.ts

@@ -2,10 +2,17 @@
  * voice-retrieve-conditioning — return the operator's style card plus K
  * voice-matched exemplars for a drafting brief.
  *
+ * Task 462 changes:
+ *   - `brief.format` (K-selector: 'short'|'long') renamed to `brief.length`
+ *     to free the name for the new `brief.format: VoiceFormat` axis.
+ *   - `brief.format: VoiceFormat` (required) — corpus exemplars are filtered
+ *     to this writing format; the `:VoiceProfile` is the per-format profile.
+ *   - All callers updated in the same commit.
+ *
  * Retrieval order (best to worst):
- *   1. If brief.topic is provided AND keyword search on the human-only corpus
+ *   1. If brief.topic is provided AND keyword search on the per-format corpus
  *      returns ≥K matches → use those (ordered by recency).
- *   2. Otherwise, return the K most-recent human-only nodes.
+ *   2. Otherwise, return the K most-recent per-format corpus nodes.
  *
  * Embeddings are not used in v1: the corpus is small (single operator's
  * personal writing — typically <500 docs), and recency-with-keyword-filter
@@ -18,7 +25,11 @@
  * calling drafting skill falls back to its existing default register.
  */
 import { getSession } from "../lib/neo4j.js";
-import { VOICE_CORPUS_WHERE } from "../lib/voice-corpus.js";
+import {
+  VOICE_CORPUS_WHERE,
+  voiceCorpusWhereWithFormat,
+  type VoiceFormat,
+} from "../lib/voice-corpus.js";
 
 const DEFAULT_TOKEN_BUDGET_SHORT = 16_000;
 const DEFAULT_TOKEN_BUDGET_LONG = 96_000;
@@ -29,7 +40,17 @@ export interface VoiceRetrieveConditioningParams {
   userId: string;
   brief: {
     topic?: string;
-    format: "short" | "long";
+    /**
+     * Writing format for corpus and profile scoping (required, Task 462).
+     * One :VoiceProfile per (accountId, userId, format).
+     */
+    format: VoiceFormat;
+    /**
+     * K-selector: 'short' = K=5 (16k token budget, email/post);
+     *             'long'  = K=15 (96k token budget, brochure/prospectus).
+     * Renamed from `format` in Task 462 to free the name for VoiceFormat.
+     */
+    length?: "short" | "long";
     register?: string;
   };
   tokenBudget?: number;
@@ -55,30 +76,33 @@ export async function voiceRetrieveConditioning(
   const { accountId, userId, brief } = params;
   if (!accountId || !userId) return EMPTY;
 
-  const k = brief.format === "long" ? 15 : 5;
+  const length = brief.length ?? "short";
+  const k = length === "long" ? 15 : 5;
   const tokenBudget =
     params.tokenBudget ??
-    (brief.format === "long" ? DEFAULT_TOKEN_BUDGET_LONG : DEFAULT_TOKEN_BUDGET_SHORT);
+    (length === "long" ? DEFAULT_TOKEN_BUDGET_LONG : DEFAULT_TOKEN_BUDGET_SHORT);
   const charBudget = tokenBudget * CHARS_PER_TOKEN;
+  const format = brief.format;
+  const corpusWhere = voiceCorpusWhereWithFormat(format);
 
   const session = getSession();
   try {
-    // 1. Style card.
+    // 1. Style card — per-format profile.
     const profile = await session.run(
       `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
-       OPTIONAL MATCH (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile)
+       OPTIONAL MATCH (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile {accountId: $accountId, userId: $userId, format: $format})
        RETURN p.styleCard AS styleCard`,
-      { accountId, userId },
+      { accountId, userId, format },
     );
     const styleCard = (profile.records[0]?.get("styleCard") as string | null) ?? null;
 
-    // 2. Exemplars. Keyword-aware filter when brief.topic is set.
+    // 2. Exemplars — filtered to brief.format. Keyword-aware when topic is set.
     const topic = (brief.topic ?? "").trim();
     const usesTopic = topic.length > 0;
 
     const cypher = usesTopic
       ? `MATCH (n)
-         WHERE ${VOICE_CORPUS_WHERE}
+         WHERE ${corpusWhere}
            AND toLower(coalesce(n.body, n.abstract, n.subject, n.title, n.summary, '')) CONTAINS toLower($topic)
          WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
          RETURN elementId(n) AS id,
@@ -89,7 +113,7 @@ export async function voiceRetrieveConditioning(
          ORDER BY ts IS NULL, ts DESC
          LIMIT $k`
       : `MATCH (n)
-         WHERE ${VOICE_CORPUS_WHERE}
+         WHERE ${corpusWhere}
          WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
          RETURN elementId(n) AS id,
                 labels(n) AS labels,
@@ -101,6 +125,7 @@ export async function voiceRetrieveConditioning(
 
     const result = await session.run(cypher, {
       accountId,
+      format,
       topic,
       k,
     });
@@ -128,7 +153,7 @@ export async function voiceRetrieveConditioning(
     }
 
     process.stderr.write(
-      `[voice-retrieve] task=${brief.topic ?? brief.format} styleCardBytes=${
+      `[voice-retrieve] task=${brief.topic ?? length} format=${format} styleCardBytes=${
         styleCard?.length ?? 0
       } exemplarCount=${exemplars.length} tokenBudget=${tokenBudget}\n`,
     );

package/payload/premium-plugins/writer-craft/mcp/src/tools/voice-tag-content.ts

@@ -1,13 +1,25 @@
 /**
- * voice-tag-content — set `authorshipMode` on one or many content nodes.
+ * voice-tag-content — set `authorshipMode` (and optionally `format`) on one
+ * or many content nodes.
  *
  * The tool routes through neo4j directly with an account-scoped MERGE so
  * the operator can only mutate their own nodes. We do not go through
  * `memory-update` because that tool re-embeds and re-validates on every
  * call — overkill for a single-property authorship stamp.
+ *
+ * Format stamping (Task 462):
+ *   - When `format` is provided: validated against FORMAT_VALUES and written
+ *     to `n.format` alongside `authorshipMode`.
+ *   - When `format` is omitted: a Cypher CASE expression derives format from
+ *     each node's labels and `source` property, matching the `deriveFormat()`
+ *     rule table in voice-corpus.ts. This keeps tag and ingest in lockstep.
  */
 import { getSession } from "../lib/neo4j.js";
-import { TAGGABLE_PRIMARY_LABELS } from "../lib/voice-corpus.js";
+import {
+  TAGGABLE_PRIMARY_LABELS,
+  FORMAT_VALUES,
+  type VoiceFormat,
+} from "../lib/voice-corpus.js";
 
 export type AuthorshipMode =
   | "human-only"
@@ -28,6 +40,8 @@ export interface VoiceTagContentParams {
   nodeIds: string[];
   mode: AuthorshipMode;
   accountId: string;
+  /** Optional format. When omitted, derived from each node's labels. */
+  format?: VoiceFormat;
 }
 
 export interface VoiceTagContentResult {
@@ -36,10 +50,22 @@ export interface VoiceTagContentResult {
   skippedReasons: Record<string, number>;
 }
 
+// Cypher CASE expression that mirrors deriveFormat() for in-query derivation.
+// Used when the caller does not supply an explicit format.
+const FORMAT_DERIVE_CASE = `CASE
+  WHEN 'Message' IN labels(n) THEN 'text'
+  WHEN 'SocialPost' IN labels(n) THEN 'social-post'
+  WHEN ('KnowledgeDocument' IN labels(n) OR 'ConversationArchive' IN labels(n))
+       AND n.source = 'email' THEN 'email'
+  WHEN 'KnowledgeDocument' IN labels(n) AND size(coalesce(n.body, '')) > 1500 THEN 'article'
+  WHEN 'KnowledgeDocument' IN labels(n) THEN 'note'
+  ELSE 'text'
+END`;
+
 export async function voiceTagContent(
   params: VoiceTagContentParams,
 ): Promise<VoiceTagContentResult> {
-  const { nodeIds, mode, accountId } = params;
+  const { nodeIds, mode, accountId, format } = params;
 
   if (!AUTHORSHIP_MODES.has(mode)) {
     throw new Error(
@@ -51,6 +77,11 @@ export async function voiceTagContent(
   if (!accountId) {
     throw new Error("voice-tag-content: accountId is required");
   }
+  if (format !== undefined && !(FORMAT_VALUES as readonly string[]).includes(format)) {
+    throw new Error(
+      `voice-tag-content: invalid format '${format}'. Valid values: ${FORMAT_VALUES.join(", ")}`,
+    );
+  }
   if (!Array.isArray(nodeIds) || nodeIds.length === 0) {
     return { updated: 0, skipped: 0, skippedReasons: {} };
   }
@@ -72,6 +103,10 @@ export async function voiceTagContent(
         // accidentally tagging document-path :Section rows AND parent
         // `:Conversation` / `:AdminConversation` nodes (which are not
         // body-bearing content).
+        //
+        // Format is either the caller-supplied constant ($format is non-null)
+        // or derived per-node via the CASE expression that mirrors
+        // deriveFormat() in voice-corpus.ts.
         `UNWIND $ids AS id
          MATCH (n) WHERE elementId(n) = id AND n.accountId = $accountId
          WITH n
@@ -81,13 +116,15 @@ export async function voiceTagContent(
                  WHERE parent.conversationIdentity IS NOT NULL
                })
          SET n.authorshipMode = $mode,
-             n.authorshipTaggedAt = $now
+             n.authorshipTaggedAt = $now,
+             n.format = CASE WHEN $format IS NOT NULL THEN $format ELSE ${FORMAT_DERIVE_CASE} END
          RETURN elementId(n) AS id`,
         {
           ids: batch,
           accountId,
           mode,
           now,
+          format: format ?? null,
           primaryLabels: [...TAGGABLE_PRIMARY_LABELS],
         },
       );
@@ -104,7 +141,7 @@ export async function voiceTagContent(
   }
 
   process.stderr.write(
-    `[voice-tag] mode=${mode} accountId=${accountId} updated=${updated} skipped=${
+    `[voice-tag] mode=${mode} format=${format ?? "derived"} accountId=${accountId} updated=${updated} skipped=${
       nodeIds.length - updated
     }\n`,
   );

package/payload/premium-plugins/writer-craft/skills/voice-mirror/SKILL.md

@@ -7,14 +7,15 @@ description: "Capture the operator's authorial voice from their own writing and
 
 Distil the operator's own voice from the content they have actually written, and condition agent drafts on it so generated copy reads as theirs. Anthropic models cannot be fine-tuned; voice mimicry comes from in-context conditioning — a style card plus a handful of real exemplars. The 1M context window makes this affordable.
 
-The skill is built on four deterministic MCP tools served by the `writer-craft` plugin's MCP server (`premium-plugins/writer-craft/mcp/`):
+The skill is built on five deterministic MCP tools served by the `writer-craft` plugin's MCP server (`premium-plugins/writer-craft/mcp/`):
 
 | Tool | Purpose |
 |------|---------|
-| `voice-tag-content` | Stamp historical or new content nodes with `authorshipMode`. Bulk-tags arrays of node ids. |
-| `voice-distil-profile` | Walk the operator's `human-only` corpus and produce a `:VoiceProfile {styleCard, generatedAt, corpusSize, feedbackEntries}` node. |
-| `voice-retrieve-conditioning` | Return `{styleCard, exemplars[]}` for a drafting brief. K=5 for short-form, K=15 for long-form. Token-budget bounded. |
-| `voice-record-feedback` | When the operator edits an agent draft, write a `:VoiceEdit {originalText, editedText, intent, occurredAt}-[:FEEDBACK_FOR]->(:VoiceProfile)` node. The `intent` field is a Haiku-summarised diff. |
+| `voice-tag-content` | Stamp historical or new content nodes with `authorshipMode` and derived `format`. Bulk-tags arrays of node ids. |
+| `voice-distil-profile` | Walk the operator's `human-only` corpus for a given `format` and produce a `:VoiceProfile {styleCard, generatedAt, corpusSize, feedbackEntries, format}` node. Without a `format`, enumerates all formats present in the corpus and distils each. |
+| `voice-retrieve-conditioning` | Return `{styleCard, exemplars[]}` for a drafting brief. Requires `brief.format` (one of the six corpus formats). K=5 for short-form, K=15 for long-form. Token-budget bounded. |
+| `voice-record-feedback` | When the operator edits an agent draft, write a `:VoiceEdit {originalText, editedText, intent, occurredAt, format}-[:FEEDBACK_FOR]->(:VoiceProfile {format})` node. The `intent` field is a Haiku-summarised diff. |
+| `voice-ingest-session-text` | (Called by the SessionEnd hook, not directly.) Ingest operator PTY turns from the session transcript as `:Message {format:'text', authorshipMode:'human-only'}` corpus nodes. Deduplicates via `contentHash`. |
 
 ## When to activate
 
@@ -32,6 +33,21 @@ Do **not** activate for:
 - Public-figure voice mimicry. Out of scope — see the `## Out of scope` section.
 - Audio voice cloning. Different domain entirely.
 
+## Corpus formats
+
+Voice profiles are segmented by content format. The closed enum is:
+
+| Format | Derived from |
+|--------|-------------|
+| `text` | `:Message` nodes, operator PTY turns (auto-ingested via SessionEnd hook) |
+| `email` | `:KnowledgeDocument {source:'email'}`, `:ConversationArchive {source:'email'}` |
+| `social-post` | `:SocialPost` nodes |
+| `article` | `:KnowledgeDocument` with body > 1,500 chars |
+| `note` | `:KnowledgeDocument` with body ≤ 1,500 chars |
+| `marketing-copy` | No automatic derivation path — tag explicitly via `voice-tag-content` |
+
+Format is derived automatically when tagging via `voice-tag-content`. Pass `format` explicitly to override the derivation.
+
 ## Flow — backfill review (one-shot session)
 
 Run when the operator first installs voice-mirror, then whenever they want to refresh the corpus.
@@ -49,14 +65,17 @@ Ask the operator which stream to backfill first. Default to chat archives when t
 
 Query for `:KnowledgeDocument | :SocialPost | :Message` nodes belonging to this operator's account whose `authorshipMode` is `unknown`. Order by `dateSent | datePublished | dateCreated` descending — most recent first. For each batch, surface a numbered list with: source label, date, recipient or topic, and a one-line preview (first ~120 chars of body). Offer bulk shortcuts:
 
-- `1-10 human-only` — tag every item in the batch as `human-only`.
+- `1-10 human-only` — tag every item in the batch as `human-only` with auto-derived format.
+- `1-10 human-only article` — tag the whole batch as `human-only` and force format to `article`.
 - `1,3,7 human-only` — tag a subset.
 - `2 human-led-agent-assisted` — single-item mode override.
-- `5 agent-led-human-reviewed` — single-item mode override.
+- `5 agent-led-human-reviewed marketing-copy` — single-item mode and format override.
 - `skip` — leave the batch as `unknown` and advance.
 - `stop` — exit the backfill; the next session resumes from where the operator left off.
 
-Bulk-tag via `voice-tag-content` once per operator response. Emit `[voice-tag] mode=<mode> count=<n>` per write.
+The tool derives `format` automatically from node labels and properties. Show the derived format alongside each item's preview so the operator can spot misclassifications. Append a format token to any batch or single-item command to override the derivation.
+
+Bulk-tag via `voice-tag-content` once per operator response. Emit `[voice-tag] mode=<mode> format=<format> count=<n>` per write.
 
 ### 2b. Chat archives — paginate per conversation-document parent
 
@@ -67,17 +86,30 @@ For each conversation-document `:KnowledgeDocument` (with `conversationIdentity`
 - `not me` — tag every chunk as `agent-only` (e.g. a Slack channel where the operator only forwarded other people's messages).
 - `skip` / `stop` — same semantics as 2a.
 
-Bulk-tag via `voice-tag-content` with the list of `:Section` element IDs the conversation-document contains. The skill emits `[voice-tag] mode=<mode> count=<chunk-count>` once per conversation.
+Bulk-tag via `voice-tag-content` with the list of `:Section` element IDs the conversation-document contains. The skill emits `[voice-tag] mode=<mode> format=<format> count=<chunk-count>` once per conversation.
 
 Authorship at conversation granularity is a deliberate UX trade-off: chunks within a conversation almost always share the same operator's voice, and per-chunk tagging at archive scale would burn the operator's attention. The `mixed` opt-in covers the rare case where it matters.
 
 ### 3. Distil when the corpus crosses threshold
 
-After each backfill batch, check whether the qualifying corpus (`authorshipMode IN ['human-only', 'human-led-agent-assisted']`) has grown ≥20% since the last `:VoiceProfile.corpusSize` (or ≥1 entry if no profile exists). If yes, offer to run `voice-distil-profile` immediately. The operator can defer; the next scheduled distillation will pick it up.
+After each backfill batch, check whether the qualifying corpus (`authorshipMode IN ['human-only', 'human-led-agent-assisted']`) for any format has grown ≥20% since the last `:VoiceProfile.corpusSize` for that format (or ≥1 entry if no profile exists for that format). If yes, offer to run `voice-distil-profile` immediately. The operator can defer; the next scheduled distillation will pick it up.
+
+## Automatic text-format capture (SessionEnd hook)
+
+Operator PTY turns are automatically ingested into the `text` corpus at the end of every session — no operator action required. The `voice-session-end-text.sh` hook fires when Claude Code terminates the PTY session. It reads the JSONL transcript, filters to genuine operator turns (excludes slash commands, system reminders, and large paste blocks), deduplicates via SHA256 content hash, and writes each new turn as a `:Message {format:'text', authorshipMode:'human-only'}` node.
+
+The hook only runs for admin sessions (role=admin, no specialist flag). Accounts without writer-craft installed skip silently — the hook guards on CLI existence.
+
+After ingestion the hook triggers an incremental distillation for the `text` format if the corpus grew ≥20% since the last profile.
+
+Observe via:
+```
+journalctl -u maxy-code | grep '\[voice-session-end-hook\]'
+```
 
 ## Flow — drafting-time conditioning
 
-Drafting skills (email composition, Postiz, property-brochure, prospectus) call `voice-retrieve-conditioning` transparently before assembling their prompt. The skill takes a brief — `{topic, format, register}` — and returns:
+Drafting skills (email composition, Postiz, property-brochure, prospectus) call `voice-retrieve-conditioning` transparently before assembling their prompt. The skill takes a brief — `{topic, format, length, register}` — where `format` is the target corpus format and returns:
 
 ```yaml
 styleCard: |
@@ -97,58 +129,61 @@ exemplars:
 
 Drafting skills inject both blocks into their prompt. Opt-out is per-skill: declare `voiceMirror: false` in the skill's frontmatter and the calling site skips the fetch. Default is on.
 
-If the `:VoiceProfile` does not yet exist (corpus too small, or distillation never run), the tool returns `{styleCard: null, exemplars: []}` and the calling skill falls back to its existing default register. No error, no draft refusal.
+If the `:VoiceProfile` for the requested format does not yet exist (corpus too small, or distillation never run), the tool returns `{styleCard: null, exemplars: []}` and the calling skill falls back to its existing default register. No error, no draft refusal.
 
-Emit `[voice-retrieve] task=<brief> styleCardBytes=<n> exemplarCount=<k> tokenBudget=<n>` per call.
+Emit `[voice-retrieve] task=<brief> format=<format> styleCardBytes=<n> exemplarCount=<k> tokenBudget=<n>` per call.
 
 ## Flow — feedback capture
 
 When the operator edits an agent draft (in the email composer's edit loop, or in any drafting skill that supports inline edits), capture the diff:
 
-1. The calling skill passes `{originalText, editedText}` to `voice-record-feedback`.
+1. The calling skill passes `{originalText, editedText, format}` to `voice-record-feedback`.
 2. The tool runs a Haiku diff summarisation to produce an `intent` field — a one-sentence description of what the operator changed and why. Example intents: "shorter and dropped the apology", "switched to first person", "removed sign-off", "added a specific date".
-3. The tool writes `(:VoiceEdit {originalText, editedText, intent, occurredAt, adminUserId, accountId})-[:FEEDBACK_FOR]->(:VoiceProfile)` for the operator's profile.
+3. The tool writes `(:VoiceEdit {originalText, editedText, intent, occurredAt, userId, accountId, format})-[:FEEDBACK_FOR]->(:VoiceProfile {format})` for the operator's profile.
 
 Feedback accumulates between distillations. The next `voice-distil-profile` run reads every `:VoiceEdit` linked to the profile and feeds the intents into the style-card refinement.
 
-Emit `[voice-record-feedback] adminUser=<id> intent="<haiku-summary>" diffBytes=<n>`.
+Emit `[voice-record-feedback] userId=<id> format=<format> intent="<haiku-summary>" diffBytes=<n>`.
 
 ## Distillation cadence
 
-`voice-distil-profile` re-runs when **either**:
+`voice-distil-profile` re-runs per format when **either**:
 
-- the `human-only` corpus has grown ≥20% since the last `:VoiceProfile.corpusSize`, OR
-- 30 days have passed since `:VoiceProfile.generatedAt`.
+- the `human-only` corpus for that format has grown ≥20% since the last `:VoiceProfile.corpusSize` for that format, OR
+- 30 days have passed since `:VoiceProfile.generatedAt` for that format.
 
-A re-run within the 30-day window with <20% growth is a no-op — the tool returns the existing profile unchanged and emits `[voice-distil] skip reason=below-threshold`.
+A re-run within the 30-day window with <20% growth is a no-op — the tool returns the existing profile unchanged and emits `[voice-distil] skip reason=below-threshold format=<format>`.
 
 The triggering surface is the skill, not a scheduled job. Distillation runs on demand: at the end of a backfill batch, when the email composer notices stale-profile narration, or when the operator says "rebuild my voice profile".
 
 ## Per-operator scope
 
-One `:VoiceProfile` per `:AdminUser`. Multi-author accounts (an agency with several operators) get one profile per person. Identity is the `(accountId, adminUserId)` pair, enforced by the schema constraint.
+One `:VoiceProfile` per `(accountId, userId, format)`. Multi-author accounts (an agency with several operators) get one profile per person per format. Identity is the `(accountId, userId, format)` triple, enforced by the schema constraint.
 
 ## Observability
 
 | Tag | When |
 |-----|------|
-| `[voice-tag] mode=<mode> nodeId=<id> count=<n>` | Every tag write. |
-| `[voice-distil] adminUser=<id> corpusSize=<n> generatedAt=<iso> feedbackEntries=<n>` | Each distillation. |
-| `[voice-distil] skip reason=<below-threshold\|recent>` | When the cadence guard fires. |
-| `[voice-retrieve] task=<topic\|format> styleCardBytes=<n> exemplarCount=<k> tokenBudget=<n>` | Each retrieval. |
-| `[voice-record-feedback] adminUser=<id> intent="<haiku-summary>" diffBytes=<n>` | Each feedback write. |
+| `[voice-tag] mode=<mode> format=<format> nodeId=<id> count=<n>` | Every tag write. |
+| `[voice-distil] userId=<id> format=<format> corpusSize=<n> generatedAt=<iso> feedbackEntries=<n>` | Each distillation. |
+| `[voice-distil] skip reason=<below-threshold\|recent> format=<format>` | When the cadence guard fires. |
+| `[voice-retrieve] task=<topic> format=<format> styleCardBytes=<n> exemplarCount=<k> tokenBudget=<n>` | Each retrieval. |
+| `[voice-record-feedback] userId=<id> format=<format> intent="<haiku-summary>" diffBytes=<n>` | Each feedback write. |
+| `[voice-session-end-hook] trigger sessionId=<id>` | Hook fires for an eligible session. |
+| `[voice-session-end-hook] result=ok sessionId=<id> turns=<n> skipped=<m>` | Successful ingest. |
+| `[voice-session-end-hook] trigger-skipped sessionId=<id> reason=<reason>` | Hook guard fired. |
 
-**Confirms working:** `[voice-retrieve] exemplarCount≥1` precedes every drafting-skill prompt assembly when the calling skill has not opted out. `[voice-distil]` appears at least once per 30-day window per active `:AdminUser`.
+**Confirms working:** `[voice-retrieve] exemplarCount≥1` precedes every drafting-skill prompt assembly when the calling skill has not opted out. `[voice-distil]` appears at least once per 30-day window per active format per operator. `[voice-session-end-hook] result=ok` appears after each admin PTY session.
 
-**Indicates failure:** `[voice-retrieve] exemplarCount=0` with non-empty corpus → similarity index broken; `[voice-distil] error …` → corpus walk or LLM call failed; absence of `[voice-record-feedback]` after an operator-edit-then-send flow → feedback loop is dead.
+**Indicates failure:** `[voice-retrieve] exemplarCount=0` with non-empty corpus → similarity index broken; `[voice-distil] error …` → corpus walk or LLM call failed; absence of `[voice-record-feedback]` after an operator-edit-then-send flow → feedback loop is dead; `[voice-session-end-hook] result=err` → CLI or Neo4j issue.
 
 **Diagnostic path:**
 
 ```
-journalctl -u maxy-code | grep -E '\[voice-(tag|distil|retrieve|record-feedback)\]'
+journalctl -u maxy-code | grep -E '\[voice-(tag|distil|retrieve|record-feedback|session-end-hook)\]'
 ```
 
-Filter by `adminUser=<id>` for per-operator drill-down.
+Filter by `userId=<id>` for per-operator drill-down.
 
 ## Out of scope
 
@@ -156,7 +191,6 @@ Filter by `adminUser=<id>` for per-operator drill-down.
 - Style transfer from public-figure corpora — voice-mirror only learns from the operator's own writing.
 - Audio voice cloning / speech synthesis — different domain.
 - Auto-tagging legacy content via heuristics — backfill is operator-driven only; the agent never guesses authorship.
-- Register-segmented profiles (one profile per author, not one per formality level).
 - Admin-UI editing of the `styleCard` — operator edits via `database-operator` for now. Surfacing this in a dedicated UI is a follow-up task.
 
 ## Dependencies