@rubytech/create-maxy-code 0.1.174 → 0.1.175

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy-code",
-  "version": "0.1.174",
+  "version": "0.1.175",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy-code": "./dist/index.js"

package/payload/platform/neo4j/schema.cypher

@@ -1279,13 +1279,17 @@ CREATE INDEX postal_address_postcode IF NOT EXISTS
 FOR (a:PostalAddress) ON (a.postalCode);
 
 // ----------------------------------------------------------
-// Voice Mirror (Task 356) — authorial-voice capture + application
+// Voice Mirror (Task 356 + Task 462) — authorial-voice capture + application
 // ----------------------------------------------------------
-// :VoiceProfile holds the distilled style card for one :AdminUser.
-// One profile per AdminUser; the (accountId, adminUserId) pair is unique.
+// :VoiceProfile holds the distilled style card for one (AdminUser, format).
+// Task 462: one profile per (accountId, userId, format); format ∈
+// {text, email, social-post, article, marketing-copy, note}.
+// The old (accountId, adminUserId) unique constraint is dropped and replaced.
+//
 // :VoiceEdit captures operator edits on agent drafts as feedback,
 // stamped with a Haiku-summarised intent; many edits feed back into
-// the next distillation.
+// the next distillation. VoiceEdit now carries `format` to route
+// FEEDBACK_FOR edges to the matching per-format :VoiceProfile.
 //
 // `authorshipMode` is an enum property on content-bearing labels
 // (`:KnowledgeDocument`, `:ConversationArchive` (Task 397 — every chat
@@ -1293,30 +1297,62 @@ FOR (a:PostalAddress) ON (a.postalCode);
 // `:Message`, `:SocialPost`) with
 // values `human-only | human-led-agent-assisted | agent-led-human-reviewed
 // | agent-only | unknown`. Legacy nodes default to `unknown` until
-// reviewed via the voice-mirror backfill flow. The index lets the
-// distillation walk filter on `authorshipMode = 'human-only'` cheaply.
+// reviewed via the voice-mirror backfill flow. The per-label authorship
+// index lets the distillation walk filter cheaply.
+//
+// `format` is an enum property on corpus nodes (same label set) and on
+// :VoiceProfile nodes. The per-label format index lets per-format corpus
+// walks and profile reads avoid full-label scans.
+
+// Task 462 — drop the old (accountId, adminUserId) constraint before
+// creating the new (accountId, userId, format) three-key constraint.
+// `IF EXISTS` makes the DROP idempotent on fresh installs.
+DROP CONSTRAINT voice_profile_admin_unique IF EXISTS;
 
-CREATE CONSTRAINT voice_profile_admin_unique IF NOT EXISTS
-FOR (v:VoiceProfile) REQUIRE (v.accountId, v.adminUserId) IS UNIQUE;
+CREATE CONSTRAINT voice_profile_format_unique IF NOT EXISTS
+FOR (v:VoiceProfile) REQUIRE (v.accountId, v.userId, v.format) IS UNIQUE;
 
 CREATE INDEX voice_profile_account IF NOT EXISTS
 FOR (v:VoiceProfile) ON (v.accountId);
 
-CREATE INDEX voice_edit_admin IF NOT EXISTS
-FOR (e:VoiceEdit) ON (e.adminUserId);
+CREATE INDEX voice_profile_format IF NOT EXISTS
+FOR (v:VoiceProfile) ON (v.format);
+
+CREATE INDEX voice_edit_user IF NOT EXISTS
+FOR (e:VoiceEdit) ON (e.userId);
 
 CREATE INDEX knowledge_document_authorship IF NOT EXISTS
 FOR (k:KnowledgeDocument) ON (k.authorshipMode);
 
+CREATE INDEX knowledge_document_format IF NOT EXISTS
+FOR (k:KnowledgeDocument) ON (k.format);
+
 CREATE INDEX conversation_archive_authorship IF NOT EXISTS
 FOR (c:ConversationArchive) ON (c.authorshipMode);
 
+CREATE INDEX conversation_archive_format IF NOT EXISTS
+FOR (c:ConversationArchive) ON (c.format);
+
 CREATE INDEX message_authorship IF NOT EXISTS
 FOR (m:Message) ON (m.authorshipMode);
 
+CREATE INDEX message_format IF NOT EXISTS
+FOR (m:Message) ON (m.format);
+
+// contentHash index — deduplication MERGE in voice-ingest-session-text uses
+// MERGE (n:Message {contentHash: $hash, accountId: $accountId}). Without this
+// index, each MERGE scans all :Message nodes for the account. The index on
+// contentHash alone lets neo4j narrow the lookup before applying the
+// accountId predicate.
+CREATE INDEX message_content_hash IF NOT EXISTS
+FOR (m:Message) ON (m.contentHash);
+
 CREATE INDEX social_post_authorship IF NOT EXISTS
 FOR (s:SocialPost) ON (s.authorshipMode);
 
+CREATE INDEX social_post_format IF NOT EXISTS
+FOR (s:SocialPost) ON (s.format);
+
 // :Section authorshipMode — the corpus walk includes conversation-archive
 // :Section chunks (parent :ConversationArchive) alongside ordinary
 // document sections under :KnowledgeDocument. Index on the :Section label
@@ -1325,6 +1361,9 @@ FOR (s:SocialPost) ON (s.authorshipMode);
 CREATE INDEX section_authorship IF NOT EXISTS
 FOR (s:Section) ON (s.authorshipMode);
 
+CREATE INDEX section_format IF NOT EXISTS
+FOR (s:Section) ON (s.format);
+
 CREATE INDEX social_post_account IF NOT EXISTS
 FOR (s:SocialPost) ON (s.accountId);
 

package/payload/platform/plugins/docs/references/voice-mirror-guide.md

@@ -2,7 +2,7 @@
 
 ## What It Does
 
-{{productName}} reads emails, posts, and documents that you wrote yourself, and uses them to make sure agent-drafted copy reads like you wrote it — not like generic AI prose.
+{{productName}} reads emails, posts, documents, and your own chat messages, and uses them to make sure agent-drafted copy reads like you wrote it — not like generic AI prose.
 
 Anthropic models cannot be fine-tuned. Voice mirror works by feeding the model two things alongside every drafting task:
 
@@ -11,32 +11,34 @@ Anthropic models cannot be fine-tuned. Voice mirror works by feeding the model t
 
 The model conditions on both and produces copy that reads as yours.
 
-## Setup
+Voice mirror maintains a separate profile for each type of content you write: plain text, email, social posts, articles, notes, and marketing copy. The right profile is applied automatically based on what you're drafting.
 
-### 1. Tell {{productName}} what you wrote
+## How Your Voice Is Captured
 
-Voice mirror only learns from content you genuinely authored. Everything else stays unknown until you say otherwise.
+### Automatically — from chat
+
+Every admin chat session feeds your writing into the `text` profile automatically. When the session ends, {{productName}} reads the transcript, filters out slash commands, system messages, and large paste blocks, and adds each genuine turn as a corpus entry. This happens in the background with no action needed from you.
+
+### Via backfill — from historical content
+
+Use the backfill flow to teach {{productName}} your writing from emails, documents, and social posts you've already written.
 
 In the admin chat, ask: **"Start the voice-mirror backfill."**
 
 {{productName}} asks which stream to backfill first — discrete documents (emails, posts, PDFs) or chat archives (WhatsApp, Telegram, etc.). **Pick chat archives first if you have any imported.** Chat is where your unguarded voice lives; email is the same voice in dress clothes.
 
 - **Chat archives** — tag a whole conversation in one click. {{productName}} doesn't ask about individual messages because chunks within a conversation almost always share the same voice. Options per conversation: yours, mixed (multiple authors on your side — rare), or not yours (e.g. a Slack channel where you only forwarded other people's messages).
-- **Documents and posts** — paginated 10 at a time. Tag the whole batch, a subset by number, or per-item if you want a precise label like `human-led-agent-assisted` (you wrote the content, {{productName}} polished).
+- **Documents and posts** — paginated 10 at a time. {{productName}} shows each item with its detected format (email, article, note, social-post). Tag the whole batch, a subset by number, or per-item if you want a precise label like `human-led-agent-assisted` (you wrote the content, {{productName}} polished). Override the detected format if one is wrong.
 
 Skip a batch if none qualify, or stop at any time — the next session resumes where you left off.
 
-### 2. Distil the profile
-
-Once you have at least ~20 `human-only` items tagged, ask: **"Build my voice profile."**
-
-{{productName}} reads the corpus, summarises your style as a YAML card, and saves it to the graph. It picks up your sentence rhythms, the constructions you reach for, the words you avoid.
+## Distilling Your Profile
 
-The profile re-runs automatically when your corpus grows by ≥20% or every 30 days, whichever comes first.
+Once you have corpus entries tagged (or after automatic PTY ingestion fills the `text` profile), ask: **"Build my voice profile."**
 
-### 3. Done
+{{productName}} reads the corpus for each format, summarises your style as a YAML card, and saves it to the graph. It picks up your sentence rhythms, the constructions you reach for, the words you avoid — separately for email, articles, social posts, and so on.
 
-That's it. Every agent-drafted email, social post, brochure paragraph, and prospectus section from this point conditions on your voice. You don't need to ask for it.
+The profile re-runs automatically when your corpus grows by ≥20% for any format or every 30 days, whichever comes first.
 
 ## Feedback Loop
 
@@ -50,11 +52,11 @@ Voice mirror is on by default for every drafting skill. To opt out for one, set
 
 ## What It Won't Do
 
-- **Blend voices** — one profile per person, no "Joel + Neo combined".
+- **Blend voices** — one profile set per person, no "Joel + Neo combined".
 - **Copy public figures** — voice mirror only learns from your own writing.
 - **Clone audio** — text only, no speech synthesis.
-- **Guess** — content stays `unknown` until you mark it. {{productName}} never auto-classifies your historical writing.
+- **Guess** — historical content stays `unknown` until you mark it. {{productName}} never auto-classifies your writing. (Automatic ingestion applies only to your live PTY sessions where authorship is certain.)
 
 ## Status
 
-Voice mirror shipped end-to-end. The schema, the four tools (`voice-tag-content`, `voice-distil-profile`, `voice-retrieve-conditioning`, `voice-record-feedback`), and wiring into the three live drafting surfaces (email composition, property brochures, investor data room) are all live. When no voice profile exists on the account, every drafting skill degrades gracefully — the output matches what it was before voice mirror was installed.
+Voice mirror is live end-to-end. Six corpus formats (text, email, social-post, article, note, marketing-copy), five tools (`voice-tag-content`, `voice-distil-profile`, `voice-retrieve-conditioning`, `voice-record-feedback`, `voice-ingest-session-text`), automatic PTY-turn ingestion via SessionEnd hook, and wiring into the three live drafting surfaces (email composition, property brochures, investor data room) are all live. When no voice profile exists on the account for a given format, every drafting skill degrades gracefully — the output matches what it was before voice mirror was installed.

package/payload/platform/scripts/setup-account.sh

@@ -58,6 +58,7 @@ mkdir -p "$ACCOUNT_DIR/agents/admin" "$ACCOUNT_DIR/agents/public" "$ACCOUNT_DIR/
 # to locate scripts relative to the platform installation, not the account dir.
 ACCOUNT_SETTINGS="$ACCOUNT_DIR/.claude/settings.json"
 HOOKS_PATH="\$PLATFORM_ROOT/plugins/admin/hooks"
+WRITER_CRAFT_HOOKS_PATH="\$PLATFORM_ROOT/../premium-plugins/writer-craft/hooks"
 cat > "$ACCOUNT_SETTINGS" << SETTINGS_EOF
 {
   "hooks": {
@@ -146,6 +147,13 @@ cat > "$ACCOUNT_SETTINGS" << SETTINGS_EOF
           { "type": "command", "command": "bash $HOOKS_PATH/session-end-retrospective.sh" }
         ]
       }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          { "type": "command", "command": "bash $WRITER_CRAFT_HOOKS_PATH/voice-session-end-text.sh" }
+        ]
+      }
     ]
   }
 }

package/payload/platform/scripts/verify-skill-tool-surface.sh

@@ -326,26 +326,45 @@ def main() -> int:
             )
             pairs_checked += 1
 
-    # Built-in-tool rule + WebFetch rule: sweep all specialist templates directly.
-    # These rules are orthogonal to the skill-pairing loop above — they check the
-    # specialist's own prompt body for directives that require built-in CC tools.
+    # Built-in-tool rule + WebFetch rule: sweep all agent template .md files.
+    # Covers platform specialists (SPECIALISTS_DIR) and premium-plugin agent
+    # templates (premium-plugins/*/agents/). These rules are orthogonal to the
+    # skill-pairing loop above — they check each agent's own prompt body for
+    # directives that require built-in CC tools.
     known_skills = collect_skill_names()
     builtin_checked = 0
+
+    agent_template_dirs: list[str] = []
     if os.path.isdir(SPECIALISTS_DIR):
-        for fname in sorted(os.listdir(SPECIALISTS_DIR)):
+        agent_template_dirs.append(SPECIALISTS_DIR)
+    pp_root = os.path.join(REPO_ROOT, "premium-plugins")
+    if os.path.isdir(pp_root):
+        for plugin in sorted(os.listdir(pp_root)):
+            adir = os.path.join(pp_root, plugin, "agents")
+            if os.path.isdir(adir):
+                agent_template_dirs.append(adir)
+
+    for adir in agent_template_dirs:
+        for fname in sorted(os.listdir(adir)):
             if not fname.endswith(".md"):
                 continue
-            specialist = fname[:-3]
-            spath = os.path.join(SPECIALISTS_DIR, fname)
-            tools = specialist_tools(specialist)
-            if tools is None:
+            spath = os.path.join(adir, fname)
+            fm = parse_frontmatter(spath)
+            if fm is None:
                 continue
+            specialist = fm.get("name") or fname[:-3]
+            raw = fm.get("tools", "")
+            if isinstance(raw, list):
+                tools = {t for t in raw if t}
+            else:
+                tools = {t.strip() for t in str(raw).split(",") if t.strip()}
             body = specialist_body(spath)
             for err in check_builtin_tool_rule(specialist, body, tools, known_skills):
                 errors.append(err)
             for err in check_webfetch_rule(specialist, body, tools):
                 errors.append(err)
             builtin_checked += 1
+
     summary.append(
         f"[verify] builtin-tool-check specialists_checked={builtin_checked}"
     )

package/payload/premium-plugins/writer-craft/PLUGIN.md

@@ -16,6 +16,9 @@ tools:
   - name: voice-record-feedback
     publicAllowlist: false
     adminAllowlist: true
+  - name: voice-ingest-session-text
+    publicAllowlist: false
+    adminAllowlist: true
 always: false
 embed: false
 mcp:
@@ -87,7 +90,7 @@ The user is:
 
 | Skill | Purpose |
 |-------|---------|
-| `voice-mirror` | Capture the operator's voice from their own writing (`human-only` corpus) and condition agent drafts on it. Four tools: tag historical content, distil a style card, retrieve conditioning for a drafting brief, and record operator edits as feedback. Other drafting skills (email composition, Postiz, property-brochure, prospectus) call it transparently — opt-out via `voiceMirror: false` in the calling skill's frontmatter. |
+| `voice-mirror` | Capture the operator's voice from their own writing (`human-only` corpus) and condition agent drafts on it. Five tools: tag historical content (with auto-derived format), distil a per-format style card, retrieve conditioning for a drafting brief (requires `brief.format`), record operator edits as feedback, and auto-ingest PTY turns at SessionEnd. Other drafting skills (email composition, Postiz, property-brochure, prospectus) call it transparently — opt-out via `voiceMirror: false` in the calling skill's frontmatter. |
 
 ## Specialist Agent
 
@@ -99,14 +102,15 @@ The manuscript-reviewer agent operates in its own context window with file tools
 
 ## Tools
 
-Voice-mirror introduces four deterministic plugin tools. They route writes through `memory-write` so the graph-write gate stamps provenance on every node.
+Voice-mirror introduces five deterministic plugin tools. They route writes through `memory-write` so the graph-write gate stamps provenance on every node.
 
 | Tool | Purpose |
 |------|---------|
-| `voice-tag-content` | Stamp `authorshipMode ∈ {human-only, human-led-agent-assisted, agent-led-human-reviewed, agent-only, unknown}` on one or many `:KnowledgeDocument | :Message | :SocialPost` nodes (email threads live as `:KnowledgeDocument {source:'email'}` since Task 321). Bulk-mode for backfill batches. |
-| `voice-distil-profile` | Walk the operator's `human-only` corpus and persist a `:VoiceProfile {styleCard, generatedAt, corpusSize, feedbackEntries}` linked to the `:AdminUser`. Cadence-guarded: re-runs on ≥20% corpus growth or ≥30 days, otherwise no-op. |
-| `voice-retrieve-conditioning` | Return `{styleCard, exemplars[]}` for a drafting brief. K=5 short-form, K=15 long-form. Token-budget bounded. Graceful degradation: empty profile → `{styleCard: null, exemplars: []}`. |
-| `voice-record-feedback` | Capture an operator edit on an agent draft as a `:VoiceEdit` with a Haiku-summarised `intent`, linked back to the operator's `:VoiceProfile` via `:FEEDBACK_FOR`. |
+| `voice-tag-content` | Stamp `authorshipMode ∈ {human-only, human-led-agent-assisted, agent-led-human-reviewed, agent-only, unknown}` and derived `format ∈ {text, email, social-post, article, note, marketing-copy}` on one or many `:KnowledgeDocument | :Message | :SocialPost` nodes (email threads live as `:KnowledgeDocument {source:'email'}` since Task 321). Bulk-mode for backfill batches. Pass `format` explicitly to override auto-derivation. |
+| `voice-distil-profile` | Walk the operator's `human-only` corpus for the given `format` and persist a `:VoiceProfile {styleCard, generatedAt, corpusSize, feedbackEntries, format}` linked to the `:AdminUser`. Omit `format` to enumerate all formats in the corpus and distil each. Cadence-guarded per format: re-runs on ≥20% corpus growth or ≥30 days, otherwise no-op. |
+| `voice-retrieve-conditioning` | Return `{styleCard, exemplars[]}` for a drafting brief. Requires `brief.format` (one of the six corpus formats). K=5 short-form (`brief.length:'short'`), K=15 long-form (`brief.length:'long'`). Token-budget bounded. Graceful degradation: empty profile → `{styleCard: null, exemplars: []}`. |
+| `voice-record-feedback` | Capture an operator edit on an agent draft as a `:VoiceEdit {format}` with a Haiku-summarised `intent`, linked back to the operator's per-format `:VoiceProfile` via `:FEEDBACK_FOR`. Requires `format`. |
+| `voice-ingest-session-text` | Ingest operator PTY turns from a JSONL transcript as `:Message {format:'text', authorshipMode:'human-only'}` corpus nodes. Deduplicates via SHA256 `contentHash`. Called by `voice-session-end-text.sh` at SessionEnd; not intended for direct agent invocation. |
 
 The non-voice skills continue to operate via existing platform tools (`memory-search` for knowledge retrieval). Structured choices are still presented as numbered lists in plain chat — the platform has no inline-UI component primitive on the admin / native-CC surface.
 
@@ -127,4 +131,4 @@ Domain knowledge files loaded on demand by each skill. See individual skill file
 | `review-manuscript` | `review-manuscript-checklist.md` |
 | `review-scene` | `scene-analysis-framework.md` |
 | `review-prose` | `prose-review-checklist.md` |
-| `voice-mirror` | No external references; the skill body defines the four tool contracts. Developer notes in `maxy-code/.docs/voice-mirror.md`. |
+| `voice-mirror` | No external references; the skill body defines the five tool contracts. Developer notes in `maxy-code/.docs/voice-mirror.md`. |

package/payload/premium-plugins/writer-craft/hooks/__tests__/voice-session-end-text.test.sh

@@ -0,0 +1,284 @@
+#!/usr/bin/env bash
+# voice-session-end-text.sh hook test suite.
+#
+# Pattern: a local Python HTTP server stands in for /api/admin/log-ingest
+# and records every POST so the assertions can inspect every log line the
+# hook emitted. The CLI is stubbed with a mock node script so tests run
+# without a live Neo4j connection.
+#
+# Contract under test:
+#   - Hook skips with reason=role-not-admin when MAXY_SESSION_ROLE != admin.
+#   - Hook skips with reason=is-specialist when MAXY_SPECIALIST is set.
+#   - Hook skips with reason=empty-stdin when no stdin is piped.
+#   - Hook skips with reason=missing-transcript when the JSONL path in the
+#     stdin envelope does not exist.
+#   - Hook skips with reason=cli-not-found when the compiled CLI is absent.
+#   - Happy path: hook emits trigger + result=ok when all guards pass and the
+#     stub CLI exits 0.
+#   - Dedupe path: stub CLI returns turns=0 skipped=3 → result=ok with those
+#     counts (verifying the hook forwards the CLI stdout to the log-ingest).
+
+set -u
+
+HOOK="$(cd "$(dirname "$0")/.." && pwd)/voice-session-end-text.sh"
+if [[ ! -f "$HOOK" ]]; then
+  echo "FAIL: hook not found at $HOOK" >&2
+  exit 1
+fi
+
+PASS=0
+FAIL=0
+TMPFILES=()
+LISTENER_PIDS=()
+
+cleanup() {
+  for pid in "${LISTENER_PIDS[@]:-}"; do
+    [[ -n "$pid" ]] && { kill "$pid" 2>/dev/null || true; wait "$pid" 2>/dev/null || true; }
+  done
+  for f in "${TMPFILES[@]:-}"; do
+    [[ -n "$f" ]] && rm -f "$f" 2>/dev/null || true
+  done
+}
+trap cleanup EXIT
+
+# ---- helpers ---------------------------------------------------------------
+
+make_tmp_file() {
+  local tmp
+  tmp=$(mktemp)
+  TMPFILES+=("$tmp")
+  echo "$tmp"
+}
+
+# Start a listener on a random port; capture every POST body.
+# Sets LISTENER_PORT and LISTENER_LOG globals.
+start_listener() {
+  LISTENER_LOG=$(make_tmp_file)
+  LISTENER_PORT=$(python3 -c 'import socket; s=socket.socket(); s.bind(("",0)); print(s.getsockname()[1]); s.close()')
+  python3 - "$LISTENER_PORT" "$LISTENER_LOG" <<'PY' &
+import sys, http.server, json
+
+port = int(sys.argv[1])
+log  = sys.argv[2]
+
+class H(http.server.BaseHTTPRequestHandler):
+    def do_POST(self):
+        n = int(self.headers.get("Content-Length", 0))
+        body = self.rfile.read(n).decode()
+        with open(log, "a") as f:
+            f.write(body + "\n")
+        self.send_response(200)
+        self.end_headers()
+    def log_message(self, *a): pass
+
+http.server.HTTPServer(("127.0.0.1", port), H).serve_forever()
+PY
+  local pid=$!
+  LISTENER_PIDS+=("$pid")
+  sleep 0.3   # let the server start
+}
+
+# Run the hook with given env overrides and optional stdin.
+# Returns: HOOK_EXIT, LISTENER_LINES (array of log-ingest line bodies).
+run_hook() {
+  local env_args=("$@")
+  local stdin_data="${HOOK_STDIN:-}"
+  local hook_exit=0
+  if [[ -n "$stdin_data" ]]; then
+    printf '%s' "$stdin_data" | env \
+      MAXY_UI_INTERNAL_PORT="$LISTENER_PORT" \
+      MAXY_SESSION_ROLE="${MAXY_SESSION_ROLE:-admin}" \
+      MAXY_SPECIALIST="${MAXY_SPECIALIST:-}" \
+      PLATFORM_ROOT="${FAKE_PLATFORM_ROOT:-}" \
+      ACCOUNT_ID="${ACCOUNT_ID:-acct-test}" \
+      USER_ID="${USER_ID:-user-test}" \
+      SESSION_ID="" \
+      NEO4J_URI="bolt://localhost:7688" \
+      NEO4J_USER="neo4j" \
+      NEO4J_PASSWORD="test" \
+      ${env_args[@]+"${env_args[@]}"} \
+      bash "$HOOK" >/dev/null 2>/dev/null || hook_exit=$?
+  else
+    env \
+      MAXY_UI_INTERNAL_PORT="$LISTENER_PORT" \
+      MAXY_SESSION_ROLE="${MAXY_SESSION_ROLE:-admin}" \
+      MAXY_SPECIALIST="${MAXY_SPECIALIST:-}" \
+      PLATFORM_ROOT="${FAKE_PLATFORM_ROOT:-}" \
+      ACCOUNT_ID="${ACCOUNT_ID:-acct-test}" \
+      USER_ID="${USER_ID:-user-test}" \
+      SESSION_ID="" \
+      NEO4J_URI="bolt://localhost:7688" \
+      NEO4J_USER="neo4j" \
+      NEO4J_PASSWORD="test" \
+      ${env_args[@]+"${env_args[@]}"} \
+      bash "$HOOK" </dev/null >/dev/null 2>/dev/null || hook_exit=$?
+  fi
+  HOOK_EXIT=$hook_exit
+  # Read all log-ingest POSTs.
+  LISTENER_LINES=()
+  while IFS= read -r raw; do
+    [[ -z "$raw" ]] && continue
+    LISTENER_LINES+=("$raw")
+  done < "$LISTENER_LOG"
+  # Reset log for next run.
+  > "$LISTENER_LOG"
+}
+
+assert_contains_line() {
+  local test_name="$1"
+  local fragment="$2"
+  for line in "${LISTENER_LINES[@]:-}"; do
+    if [[ "$line" == *"$fragment"* ]]; then
+      echo "  PASS: $test_name"
+      PASS=$((PASS + 1))
+      return 0
+    fi
+  done
+  echo "  FAIL: $test_name (expected fragment: '$fragment' not found in log lines)"
+  printf '       lines:\n'
+  for line in "${LISTENER_LINES[@]:-}"; do printf '         %s\n' "$line"; done
+  FAIL=$((FAIL + 1))
+}
+
+assert_exit() {
+  local test_name="$1"
+  local expected="$2"
+  if [[ "$HOOK_EXIT" -eq "$expected" ]]; then
+    echo "  PASS: $test_name (exit $expected)"
+    PASS=$((PASS + 1))
+  else
+    echo "  FAIL: $test_name (expected exit $expected, got $HOOK_EXIT)"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+# ---- setup -----------------------------------------------------------------
+
+start_listener
+
+# Create a fake platform root structure so the lib source works.
+FAKE_PLATFORM_ROOT=$(mktemp -d)
+TMPFILES+=("$FAKE_PLATFORM_ROOT")
+mkdir -p "$FAKE_PLATFORM_ROOT/plugins/admin/hooks/lib"
+# Copy the real lib so guards work correctly.
+REAL_LIB="$(cd "$(dirname "$0")/../../../../platform/plugins/admin/hooks/lib" && pwd)/admin-graph-pass-common.sh"
+if [[ ! -f "$REAL_LIB" ]]; then
+  echo "FAIL: admin-graph-pass-common.sh not found at $REAL_LIB" >&2
+  exit 1
+fi
+cp "$REAL_LIB" "$FAKE_PLATFORM_ROOT/plugins/admin/hooks/lib/admin-graph-pass-common.sh"
+
+# Create a minimal fake JSONL transcript.
+FAKE_TRANSCRIPT=$(make_tmp_file)
+printf '{"type":"user","message":{"role":"user","content":"Hello world"}}\n' > "$FAKE_TRANSCRIPT"
+
+# Create a stub CLI that exits 0 with a canned result.
+FAKE_CLI_DIR=$(mktemp -d)
+TMPFILES+=("$FAKE_CLI_DIR")
+STUB_CLI="$FAKE_CLI_DIR/ingest-session-text.js"
+cat > "$STUB_CLI" <<'STUB'
+process.stdout.write("turns=3 skipped=0 sessionId=test-session\n");
+process.exit(0);
+STUB
+
+# Stub CLI for dedupe scenario (turns=0).
+STUB_CLI_DEDUP="$FAKE_CLI_DIR/ingest-dedup.js"
+cat > "$STUB_CLI_DEDUP" <<'STUB'
+process.stdout.write("turns=0 skipped=3 sessionId=test-session\n");
+process.exit(0);
+STUB
+
+# Stub CLI that exits 1 (error).
+STUB_CLI_ERR="$FAKE_CLI_DIR/ingest-error.js"
+cat > "$STUB_CLI_ERR" <<'STUB'
+process.stderr.write("simulated error\n");
+process.exit(1);
+STUB
+
+# Valid stdin envelope for the SessionEnd hook.
+valid_envelope() {
+  local transcript="${1:-$FAKE_TRANSCRIPT}"
+  printf '{"session_id":"test-session","transcript_path":"%s","hook_event_name":"SessionEnd"}' "$transcript"
+}
+
+# Override CLI path by symlinking ingest-session-text.js inside a fake platform layout.
+make_platform_with_cli() {
+  local stub="$1"
+  local proot
+  proot=$(mktemp -d)
+  TMPFILES+=("$proot")
+  cp "$FAKE_PLATFORM_ROOT/plugins/admin/hooks/lib/admin-graph-pass-common.sh" \
+     "$proot/plugins/admin/hooks/lib/" 2>/dev/null || \
+     { mkdir -p "$proot/plugins/admin/hooks/lib"; cp "$REAL_LIB" "$proot/plugins/admin/hooks/lib/admin-graph-pass-common.sh"; }
+  mkdir -p "$proot/../premium-plugins/writer-craft/mcp/dist/cli" 2>/dev/null || \
+    mkdir -p "$(dirname "$proot")/../premium-plugins/writer-craft/mcp/dist/cli" 2>/dev/null || true
+  # Simpler: build the expected path from $PLATFORM_ROOT/../premium-plugins/...
+  # The hook computes: ${PLATFORM_ROOT}/../premium-plugins/writer-craft/mcp/dist/cli/ingest-session-text.js
+  # So parent of $proot + /premium-plugins/writer-craft/mcp/dist/cli/
+  local parent
+  parent=$(dirname "$proot")
+  mkdir -p "$parent/premium-plugins/writer-craft/mcp/dist/cli"
+  cp "$stub" "$parent/premium-plugins/writer-craft/mcp/dist/cli/ingest-session-text.js"
+  echo "$proot"
+}
+
+# ---- tests -----------------------------------------------------------------
+echo "[voice-session-end-text.test] starting"
+
+# T1: non-admin role → skip
+MAXY_SESSION_ROLE="public" HOOK_STDIN=$(valid_envelope) run_hook
+assert_exit "T1: non-admin exits 0" 0
+assert_contains_line "T1: non-admin emits trigger-skipped" "trigger-skipped"
+
+# T2: specialist → skip
+unset MAXY_SESSION_ROLE 2>/dev/null || true
+MAXY_SESSION_ROLE="admin" MAXY_SPECIALIST="database-operator" HOOK_STDIN=$(valid_envelope) run_hook
+assert_exit "T2: specialist exits 0" 0
+assert_contains_line "T2: specialist emits trigger-skipped" "trigger-skipped"
+
+# T3: empty stdin → skip
+MAXY_SPECIALIST="" MAXY_SESSION_ROLE="admin"
+HOOK_STDIN="" run_hook   # no stdin piped
+assert_exit "T3: empty-stdin exits 0" 0
+assert_contains_line "T3: empty-stdin emits trigger-skipped" "trigger-skipped"
+
+# T4: missing transcript → skip
+FAKE_MISSING=$(make_tmp_file)
+rm -f "$FAKE_MISSING"
+HOOK_STDIN=$(valid_envelope "$FAKE_MISSING") run_hook
+assert_exit "T4: missing-transcript exits 0" 0
+assert_contains_line "T4: missing-transcript emits trigger-skipped" "trigger-skipped"
+
+# T5: CLI not found → skip
+FAKE_PLATFORM_ROOT="$FAKE_PLATFORM_ROOT" HOOK_STDIN=$(valid_envelope) run_hook
+assert_exit "T5: cli-not-found exits 0" 0
+assert_contains_line "T5: cli-not-found emits trigger-skipped" "cli-not-found"
+
+# T6: happy path — stub CLI exits 0
+HAPPY_PROOT=$(make_platform_with_cli "$STUB_CLI")
+FAKE_PLATFORM_ROOT="$HAPPY_PROOT" HOOK_STDIN=$(valid_envelope) run_hook
+assert_exit "T6: happy path exits 0" 0
+assert_contains_line "T6: happy path emits trigger" "trigger"
+assert_contains_line "T6: happy path emits result=ok" "result=ok"
+
+# T7: dedupe — stub returns turns=0 skipped=3
+DEDUP_PROOT=$(make_platform_with_cli "$STUB_CLI_DEDUP")
+FAKE_PLATFORM_ROOT="$DEDUP_PROOT" HOOK_STDIN=$(valid_envelope) run_hook
+assert_exit "T7: dedupe exits 0" 0
+assert_contains_line "T7: dedupe emits result=ok" "result=ok"
+
+# T8: CLI error — stub exits 1
+ERR_PROOT=$(make_platform_with_cli "$STUB_CLI_ERR")
+FAKE_PLATFORM_ROOT="$ERR_PROOT" HOOK_STDIN=$(valid_envelope) run_hook
+assert_exit "T8: cli-error exits 0" 0
+assert_contains_line "T8: cli-error emits result=err" "result=err"
+
+# ---- summary ---------------------------------------------------------------
+echo ""
+if [[ "$FAIL" -eq 0 ]]; then
+  echo "[voice-session-end-text.test] all $PASS tests passed"
+  exit 0
+else
+  echo "[voice-session-end-text.test] FAILED — $FAIL/$((PASS + FAIL)) tests failed"
+  exit 1
+fi