@rubytech/create-siteoffice-code 0.1.256

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

@@ -0,0 +1,134 @@
+---
+mcp-manifest: auto
+name: writer-craft
+description: "Manuscript review and writing craft tools grounded in neuroscience-based story theory, professional editing practice, and prose technique. 12 skills covering story architecture, reader engagement, prose craft, point of view, persuasive storytelling, editorial practice, citation style, three levels of manuscript review, and voice mirror (authorial-voice capture + application) — plus a specialist subagent for autonomous deep manuscript review."
+icon: ✍️
+tools:
+  - name: voice-tag-content
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: voice-distil-profile
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: voice-retrieve-conditioning
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: voice-record-feedback
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: voice-ingest-session-text
+    publicAllowlist: false
+    adminAllowlist: true
+always: false
+embed: false
+mcp:
+  command: node
+  args:
+    - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
+    - ${PLATFORM_ROOT}/../premium-plugins/writer-craft/mcp/dist/index.js
+  env:
+    MCP_SPAWN_TEE_NAME: writer-craft
+    LOG_DIR: ${LOG_DIR}
+    PLATFORM_ROOT: ${PLATFORM_ROOT}
+    ACCOUNT_ID: ${ACCOUNT_ID}
+    ADMIN_USER_ID: ${ADMIN_USER_ID}
+    SESSION_ID: ${SESSION_ID}
+    NEO4J_URI: ${NEO4J_URI}
+    NEO4J_USER: ${NEO4J_USER}
+    NEO4J_PASSWORD: ${NEO4J_PASSWORD}
+metadata: {"platform":{"optional":true,"pluginKey":"writer-craft","embed":["admin"]}}
+---
+
+# Writer Craft
+
+11 specialist skills for writers, editors, and anyone working with narrative. Each skill draws on neuroscience-based story theory (how the brain processes narrative), professional editing practice (developmental, line, and copyediting), and prose technique (sound, rhythm, word economy, POV). One specialist subagent performs autonomous deep manuscript review.
+
+## When to Activate
+
+The user is:
+- Writing fiction or nonfiction and wants craft-level guidance
+- Reviewing or editing a manuscript, chapter, scene, or passage
+- Building a story from scratch using blueprinting methodology
+- Working on persuasive writing, speeches, or advocacy storytelling
+- Formatting citations and references in Chicago author-date style
+- Seeking feedback on prose quality, POV consistency, or reader engagement
+
+## Skills
+
+### Story & Structure
+
+| Skill | Purpose |
+|-------|---------|
+| `story-architecture` | Build and analyze internal story architecture: misbelief, desire, third rail, worldview, origin scenes, scene cards |
+| `story-blueprint` | Walk a writer interactively through building a story from the inside out using the Story Genius blueprinting method |
+| `reader-engagement` | Analyze and teach reader engagement: hooking from page one, urgency, cause-and-effect, setup-payoff, conflict escalation |
+
+### Prose & Voice
+
+| Skill | Purpose |
+|-------|---------|
+| `prose-craft` | Review and teach prose technique: sound and rhythm, sentence variety, punctuation, repetition, word economy, crowding and leaping |
+| `point-of-view` | Guide point of view, narrative voice, tense, person, and indirect narration |
+| `persuasive-storytelling` | Guide persuasive storytelling for nonfiction, speeches, marketing, and advocacy |
+
+### Editing & Reference
+
+| Skill | Purpose |
+|-------|---------|
+| `editorial-practice` | Guide professional editing methods: developmental editing, line editing, copyediting, self-editing, genre-specific considerations |
+| `citation-style` | Guide Chicago author-date citation and reference formatting per the Chicago Manual of Style (17th edition) |
+
+### Review
+
+| Skill | Purpose |
+|-------|---------|
+| `review-manuscript` | Comprehensive multi-level review covering story architecture, reader engagement, prose craft, and editorial quality |
+| `review-scene` | Deep analysis of a single scene against scene card criteria, engagement principles, and prose craft standards |
+| `review-prose` | Prose-level review analyzing sound, rhythm, sentence variety, POV consistency, word economy, and crowding/leaping balance |
+
+### Authorial Voice
+
+| Skill | Purpose |
+|-------|---------|
+| `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 (operator supplies `format`), distil a per-format style card, retrieve conditioning for a drafting brief (requires `brief.format`), record operator edits as feedback, and capture the current session's turns on demand. 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
+
+| Agent | Purpose |
+|-------|---------|
+| `writer-craft--manuscript-reviewer` | Autonomous deep manuscript reviewer — reads a full manuscript or chapter and produces a structured report with inline observations and summary |
+
+The manuscript-reviewer agent operates in its own context window with file tools (Read, Glob, Grep, Write), allowing it to work through full manuscripts autonomously. Use it when the user submits a substantial piece of text for comprehensive review across all dimensions.
+
+## Tools
+
+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}` and `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. `format` is required — the operator's editorial classification of the content. |
+| `voice-distil-profile` | Three modes. `mode='sample'` (default) walks the operator's full `human-only` corpus for the given `format` and returns exemplars + recent edit intents for the agent to compose a style card; cadence-guarded (≥20% growth or ≥30 days). `mode='amend'` (Task 472) reads only `nodeIds` plus the existing `:VoiceProfile.styleCard` so the agent can decide whether named documents move the profile — operator-initiated, no cadence guard. `mode='write'` persists the YAML card; supply `amendedFromNodeIds` to attribute the write to specific documents (bypasses cadence + corpus walk). Trashed nodes are excluded from every walk. Omit `format` on `'sample'` to enumerate all formats in the corpus and distil each. |
+| `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` | Write operator turns from the current session as `:Message {format:'text', authorshipMode:'human-only'}` corpus nodes. The agent reads its own operator turns from context and passes them as `turns`. Deduplicates via SHA256 `contentHash`. Invoked on demand by the voice-mirror skill when the operator asks to capture this session's voice. |
+
+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.
+
+## References
+
+Domain knowledge files loaded on demand by each skill. See individual skill files for their specific reference listings.
+
+| Skill | References |
+|-------|-----------|
+| `story-architecture` | `misbelief-desire-worldview.md`, `blueprinting-and-scene-cards.md`, `origin-scenes-and-escalation.md`, `inner-issue-and-protagonist-goal.md` |
+| `story-blueprint` | `blueprinting-process.md`, `blueprinting-exercises.md` |
+| `prose-craft` | `sound-and-rhythm.md`, `word-economy.md`, `punctuation-and-grammar.md`, `repetition.md` |
+| `point-of-view` | `pov-types-and-voice.md`, `tense-and-person.md`, `indirect-narration.md`, `protagonist-filter.md` |
+| `reader-engagement` | `hooking-readers.md`, `cause-effect-setup-payoff.md`, `conflict-escalation.md`, `neurochemistry-of-engagement.md` |
+| `persuasive-storytelling` | `audience-analysis.md`, `transformation-framework.md`, `crafting-persuasive-story.md`, `persuasion-case-studies.md` |
+| `editorial-practice` | `developmental-editing.md`, `line-editing.md`, `copyediting.md`, `genre-specific-editing.md`, `self-editing.md` |
+| `citation-style` | `citation-rules.md`, `reference-list-rules.md`, `journal-article-models.md`, `book-and-chapter-models.md`, `other-source-models.md` |
+| `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 five tool contracts. Developer notes in `maxy-code/.docs/voice-mirror.md`. |

package/payload/premium-plugins/writer-craft/agents/writer-craft--manuscript-reviewer.md

@@ -0,0 +1,96 @@
+---
+name: manuscript-reviewer
+description: "Autonomous deep manuscript reviewer. Delegate when the user submits a manuscript, chapter, or substantial passage for comprehensive review, asks for a 'full review', 'manuscript assessment', or 'deep critique', or wants feedback across all dimensions of writing quality rather than a specific aspect."
+summary: "Reads a full manuscript or chapter and produces a structured report with inline observations and a summary covering story architecture, reader engagement, prose craft, and editorial quality."
+model: claude-sonnet-4-6
+tools: Read, Glob, Grep, Write
+---
+
+# Manuscript Reviewer Agent
+
+## Doctrine
+
+Never run uncommanded git writes. `git init`, `git commit`, `git add`, `git stash`, `git reset`, `git checkout`, and branch mutations are forbidden unless the operator named the action in this turn. If a harness precondition demands a git state you don't have, stop and report — never improvise a repo or commit.
+
+You are a manuscript reviewer with deep expertise in neuroscience-based story theory, professional editing practice, and prose craft. Your job is to read the submitted text carefully and produce a comprehensive review that helps the writer make their work better.
+
+## Your Knowledge Base
+
+You draw on three bodies of knowledge:
+
+1. **Neuroscience-based story theory** — how the brain processes narrative, why readers engage or disengage, the internal architecture of story (misbelief, desire, third rail, cause-and-effect, setup-payoff)
+2. **Professional editing practice** — developmental editing, line editing, copyediting, genre-specific considerations
+3. **Prose craft technique** — sound, rhythm, sentence variety, POV, voice, word economy, crowding and leaping
+
+## Review Process
+
+### Step 1: Read the Full Text
+Read everything before making observations. Note your first impressions — where you were engaged, confused, bored, or delighted. These are data.
+
+### Step 2: Identify the Story's Core
+Before critiquing, establish what exists:
+- What is the story about (the internal journey, not the plot)?
+- Who is the protagonist and what do they want?
+- What is the misbelief or inner issue?
+- What is the story question the reader is tracking?
+
+If these cannot be identified, that is the primary finding.
+
+### Step 3: Apply Four Lenses (in order)
+
+**Lens 1 — Story Architecture:**
+Check misbelief (specific, earned, active?), desire (in conflict with misbelief?), third rail (does every scene touch it?), cause-and-effect chain through the internal story, opening (last possible moment?), trajectory toward the Aha moment.
+
+**Lens 2 — Reader Engagement:**
+Check the opening hook, urgency, cause-and-effect scene to scene, setup-payoff integrity, conflict escalation, emotional resonance (protagonist reacting, reader able to mirror).
+
+**Lens 3 — Prose Craft:**
+Check sound and rhythm (mind's ear test), sentence variety, adjective/adverb economy, repetition (deliberate vs. accidental), POV consistency, exposition integration, crowding/leaping balance.
+
+**Lens 4 — Editorial Quality:**
+Check structural pacing, line-level clarity, internal consistency (names, timeline, details), passages where the reader would disengage.
+
+### Step 4: Produce the Report
+
+Output two parts:
+
+**Part A — Inline Observations:**
+Walk through the text, noting observations at the specific points where they occur. For each:
+- Quote or reference the passage
+- Name the issue precisely
+- Explain why it matters to the reader's experience
+- Suggest a direction for revision where possible
+
+**Part B — Summary Report:**
+
+```
+## Manuscript Review: [Title/Description]
+
+### What Works
+[Specific, genuine praise — name what the writer does well]
+
+### Story Architecture
+[Misbelief, desire, third rail, internal story, cause-and-effect]
+
+### Reader Engagement
+[Hooks, urgency, setup-payoff, conflict, emotional resonance]
+
+### Prose Craft
+[Sound, rhythm, POV, word economy, crowding/leaping]
+
+### Editorial Notes
+[Structure, pacing, consistency, line-level issues]
+
+### Priority Recommendations
+[3-5 most important things to address, ordered by impact]
+```
+
+## Review Principles
+
+- **Start with what works.** Every manuscript has strengths. Name them.
+- **Biggest issues first.** If story architecture is broken, don't lead with comma placement.
+- **Be specific.** Not "the pacing is off" but "Chapters 4-6 lose momentum because the protagonist has no active goal."
+- **Explain why.** Don't just flag problems — explain what they do to the reader.
+- **Preserve the author's voice.** Never suggest changes that would make the writing sound like you.
+- **Frame as possibilities.** "What if..." rather than "You must..."
+- **The book belongs to the author.** Help them write the best version of their book.

package/payload/premium-plugins/writer-craft/lib/mcp-stderr-tee/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MCP server stderr tee — dual-destination log capture.
+ *
+ * Claude Code spawns MCP servers as child processes and consumes their stderr
+ * internally. The platform cannot intercept at the spawn level. Each server
+ * must tee its own stderr so diagnostic output is retrievable.
+ *
+ * ┌─────────────────────────┐
+ * │ MCP server process      │
+ * │                         │
+ * │ console.error("[x] ..") │
+ * │           │             │
+ * │           ▼             │
+ * │ patched stderr.write()  │
+ * │     │                   │
+ * │     ├──► original stderr (consumed by Claude Code — opaque)
+ * │     │
+ * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks, per-plugin)
+ * │     │
+ * │     └──► $STREAM_LOG_PATH                      (per-line, prefixed)
+ * │           "[<iso>] [mcp:{name}] <line>"
+ * └─────────────────────────┘
+ *
+ * $STREAM_LOG_PATH is set by the spawner (`getMcpServers` in `claude-agent.ts`)
+ * to the per-conversation stream log file. The MCP server code itself knows
+ * nothing about conversations — it just trusts the spawner's path. This is
+ * the scope boundary introduced: the tee is attached per spawn,
+ * not per MCP-server process lifetime. Servers spawned for conversation A
+ * write to conversation A's file; servers for B write to B's file.
+ *
+ * Every decision is logged via `[mcp-tee-*]` markers on both the target file
+ * and the original stderr so an investigator can confirm from the stream log
+ * which tees were wired up, which were skipped, and why.
+ */
+/**
+ * Patch process.stderr.write to tee to:
+ *   1. Per-server raw log (`mcp-<serverName>-stderr-<date>.log` under LOG_DIR).
+ *   2. The per-conversation stream log at `STREAM_LOG_PATH` — per-line, prefixed.
+ *   3. The original stderr (consumed by Claude Code) — always preserved.
+ *
+ * LOG_DIR absent → skip per-server raw file (dev mode / tool discovery).
+ * STREAM_LOG_PATH absent → skip stream-log destination (older spawner or
+ *   standalone invocation). In both absent cases, stderr works unchanged —
+ *   a `[mcp-tee-skip]` marker is written to original stderr so the skip is
+ *   visible to journalctl-level readers.
+ *
+ * Safe to call once at MCP server module load. Refused on second call to
+ * prevent stacking patches.
+ */
+export declare function initStderrTee(serverName: string): void;
+//# sourceMappingURL=index.d.ts.map

package/payload/premium-plugins/writer-craft/lib/mcp-stderr-tee/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAeH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CA8ItD"}

package/payload/premium-plugins/writer-craft/lib/mcp-stderr-tee/dist/index.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * MCP server stderr tee — dual-destination log capture.
+ *
+ * Claude Code spawns MCP servers as child processes and consumes their stderr
+ * internally. The platform cannot intercept at the spawn level. Each server
+ * must tee its own stderr so diagnostic output is retrievable.
+ *
+ * ┌─────────────────────────┐
+ * │ MCP server process      │
+ * │                         │
+ * │ console.error("[x] ..") │
+ * │           │             │
+ * │           ▼             │
+ * │ patched stderr.write()  │
+ * │     │                   │
+ * │     ├──► original stderr (consumed by Claude Code — opaque)
+ * │     │
+ * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks, per-plugin)
+ * │     │
+ * │     └──► $STREAM_LOG_PATH                      (per-line, prefixed)
+ * │           "[<iso>] [mcp:{name}] <line>"
+ * └─────────────────────────┘
+ *
+ * $STREAM_LOG_PATH is set by the spawner (`getMcpServers` in `claude-agent.ts`)
+ * to the per-conversation stream log file. The MCP server code itself knows
+ * nothing about conversations — it just trusts the spawner's path. This is
+ * the scope boundary introduced: the tee is attached per spawn,
+ * not per MCP-server process lifetime. Servers spawned for conversation A
+ * write to conversation A's file; servers for B write to B's file.
+ *
+ * Every decision is logged via `[mcp-tee-*]` markers on both the target file
+ * and the original stderr so an investigator can confirm from the stream log
+ * which tees were wired up, which were skipped, and why.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initStderrTee = initStderrTee;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_string_decoder_1 = require("node:string_decoder");
+// Marker on process.stderr.write so repeat calls to initStderrTee() are
+// detected at runtime, not just warned about in the docstring. A second
+// call would stack patches and double-log every chunk.
+const INIT_MARKER = Symbol.for("maxy.mcpStderrTee.installed");
+/**
+ * Patch process.stderr.write to tee to:
+ *   1. Per-server raw log (`mcp-<serverName>-stderr-<date>.log` under LOG_DIR).
+ *   2. The per-conversation stream log at `STREAM_LOG_PATH` — per-line, prefixed.
+ *   3. The original stderr (consumed by Claude Code) — always preserved.
+ *
+ * LOG_DIR absent → skip per-server raw file (dev mode / tool discovery).
+ * STREAM_LOG_PATH absent → skip stream-log destination (older spawner or
+ *   standalone invocation). In both absent cases, stderr works unchanged —
+ *   a `[mcp-tee-skip]` marker is written to original stderr so the skip is
+ *   visible to journalctl-level readers.
+ *
+ * Safe to call once at MCP server module load. Refused on second call to
+ * prevent stacking patches.
+ */
+function initStderrTee(serverName) {
+    const logDir = process.env.LOG_DIR;
+    const streamLogPath = process.env.STREAM_LOG_PATH;
+    // Refuse repeat patches — stacking them would double-log every chunk
+    // and corrupt the re-entrancy guard (originalWrite would capture the
+    // already-patched function on the second call).
+    if (process.stderr.write[INIT_MARKER])
+        return;
+    // Keep a direct reference to the unpatched writer. All diagnostic output
+    // from inside this module MUST go through originalWrite to avoid
+    // re-entering the patched writer (which would recurse on a tee failure).
+    const originalWrite = process.stderr.write.bind(process.stderr);
+    const tsPrefix = () => `[${new Date().toISOString()}]`;
+    const skipTee = (reason, destination) => {
+        originalWrite(`${tsPrefix()} [platform] [mcp-tee-skip] server=${serverName} destination=${destination} reason=${JSON.stringify(reason)}\n`);
+    };
+    // --- Destination 1: per-server raw file (optional, existing behaviour)
+    let perServerStream;
+    if (logDir) {
+        try {
+            (0, node_fs_1.mkdirSync)(logDir, { recursive: true });
+            const date = new Date().toISOString().slice(0, 10);
+            perServerStream = (0, node_fs_1.createWriteStream)((0, node_path_1.resolve)(logDir, `mcp-${serverName}-stderr-${date}.log`), { flags: "a" });
+            perServerStream.on("error", (err) => {
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=per-server reason=${JSON.stringify(err.message)}\n`);
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            skipTee(msg, "per-server");
+            perServerStream = undefined;
+        }
+    }
+    else {
+        skipTee("LOG_DIR not set", "per-server");
+    }
+    // --- Destination 2: per-conversation stream log
+    let streamLogStream;
+    if (streamLogPath) {
+        try {
+            (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(streamLogPath), { recursive: true });
+            const s = (0, node_fs_1.createWriteStream)(streamLogPath, { flags: "a" });
+            s.on("error", (err) => {
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=stream-log reason=${JSON.stringify(err.message)}\n`);
+            });
+            streamLogStream = s;
+            // Attach marker lands in the stream log itself so investigators can
+            // confirm per-conversation the tee was wired up.
+            s.write(`${tsPrefix()} [platform] [mcp-tee-attach] server=${serverName} streamLogPath=${streamLogPath}\n`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            skipTee(msg, "stream-log");
+            streamLogStream = undefined;
+        }
+    }
+    else {
+        skipTee("STREAM_LOG_PATH not set", "stream-log");
+    }
+    // If neither tee target is available, leave stderr untouched — patching
+    // the writer to a no-op tee would still consume event-loop cycles on
+    // every write for zero observability gain.
+    if (!perServerStream && !streamLogStream) {
+        return;
+    }
+    // Line buffer — accumulates characters written to stderr so complete
+    // newline-terminated lines can be prefixed and emitted to the stream log.
+    // Partial chunks are held until a newline arrives (or beforeExit flushes).
+    let lineBuffer = "";
+    // StringDecoder buffers trailing UTF-8 continuation bytes across chunks.
+    // Without it, a multi-byte codepoint that straddles a write boundary would
+    // render as two U+FFFD replacement characters in the stream log. Only
+    // matters when a caller writes Uint8Array chunks directly — console.error
+    // produces strings — but plugins piping child-process stderr can hit this.
+    const utf8 = new node_string_decoder_1.StringDecoder("utf8");
+    const emitCompleteLinesToStreamLog = (chunk) => {
+        if (!streamLogStream)
+            return;
+        lineBuffer += chunk;
+        let newlineIndex;
+        // eslint-disable-next-line no-cond-assign
+        while ((newlineIndex = lineBuffer.indexOf("\n")) !== -1) {
+            const line = lineBuffer.slice(0, newlineIndex);
+            lineBuffer = lineBuffer.slice(newlineIndex + 1);
+            if (line.length === 0)
+                continue; // skip blank lines
+            if (streamLogStream.destroyed || streamLogStream.writableEnded)
+                continue;
+            streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${line}\n`);
+        }
+    };
+    process.stderr.write = (chunk, ...args) => {
+        // 1. Per-server raw file — behaviour (no prefix).
+        if (perServerStream && !perServerStream.destroyed) {
+            perServerStream.write(chunk);
+        }
+        // 2. Stream log — per-line, prefixed.
+        if (streamLogStream) {
+            try {
+                const text = typeof chunk === "string"
+                    ? chunk
+                    : utf8.write(Buffer.from(chunk));
+                emitCompleteLinesToStreamLog(text);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-emit-error] server=${serverName} reason=${JSON.stringify(msg)}\n`);
+            }
+        }
+        // 3. Original stderr — Claude Code still gets what it's always got.
+        return originalWrite(chunk, ...args);
+    };
+    // Mark the patch so a second initStderrTee() call is refused at the top.
+    process.stderr.write[INIT_MARKER] = true;
+    // Flush any trailing unterminated segment on graceful event-loop drain.
+    // `beforeExit` can fire repeatedly: each async write to `streamLogStream`
+    // schedules I/O that keeps the event loop alive, which drains, which fires
+    // `beforeExit` again. With N MCP servers attached, the handler can emit
+    // thousands of detach lines per second. The `detached` flag gates the
+    // drain+detach emission to a single invocation; subsequent firings are
+    // no-ops. Buffer flushing also runs only once — partial-line state at true
+    // process exit doesn't change across re-fires.
+    let detached = false;
+    process.on("beforeExit", () => {
+        if (detached)
+            return;
+        detached = true;
+        if (streamLogStream && !streamLogStream.destroyed && !streamLogStream.writableEnded) {
+            if (lineBuffer.length > 0) {
+                streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${lineBuffer}\n`);
+            }
+            streamLogStream.write(`${tsPrefix()} [platform] [mcp-tee-detach] server=${serverName} reason=process-before-exit\n`);
+        }
+        lineBuffer = "";
+    });
+}
+//# sourceMappingURL=index.js.map

package/payload/premium-plugins/writer-craft/lib/mcp-stderr-tee/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/payload/premium-plugins/writer-craft/lib/mcp-stderr-tee/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@maxy/mcp-stderr-tee",
+  "version": "0.1.0",
+  "private": true,
+  "type": "commonjs",
+  "main": "dist/index.js"
+}

package/payload/premium-plugins/writer-craft/mcp/dist/cli/ingest-session-text.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=ingest-session-text.d.ts.map

package/payload/premium-plugins/writer-craft/mcp/dist/cli/ingest-session-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-session-text.d.ts","sourceRoot":"","sources":["../../src/cli/ingest-session-text.ts"],"names":[],"mappings":""}

package/payload/premium-plugins/writer-craft/mcp/dist/cli/ingest-session-text.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * CLI wrapper for voice-ingest-session-text.
+ *
+ * Invoked by the SessionEnd hook after each admin PTY session:
+ *   node dist/cli/ingest-session-text.js <transcript_path>
+ *
+ * All other parameters are read from environment variables inherited from
+ * the PTY session (which inherits from the session manager's systemd unit):
+ *
+ *   ACCOUNT_ID    — operator's account identifier
+ *   USER_ID       — operator's userId (= adminUserId)
+ *   SESSION_ID    — session identifier (parsed by hook from stdin)
+ *   NEO4J_URI     — neo4j bolt URI
+ *   NEO4J_USER    — neo4j username
+ *   NEO4J_PASSWORD — neo4j password
+ *
+ * Exit codes:
+ *   0 — success (includes no-new-turns case)
+ *   1 — error (missing required env, JSONL not found, DB error)
+ *
+ * stdout: one-line result summary ("turns=N skipped=M") for the hook to
+ * capture and forward to the log-ingest endpoint.
+ * stderr: detailed diagnostics (tool log lines).
+ */
+import { voiceIngestSessionText } from "../tools/voice-ingest-session-text.js";
+import { closeDriver } from "../lib/neo4j.js";
+const transcriptPath = process.argv[2];
+if (!transcriptPath) {
+    process.stderr.write("[ingest-session-text] error: transcript path required as argv[2]\n");
+    process.exit(1);
+}
+const accountId = process.env.ACCOUNT_ID ?? "";
+const userId = process.env.USER_ID ?? "";
+const sessionId = process.env.SESSION_ID ?? undefined;
+if (!accountId || !userId) {
+    process.stderr.write(`[ingest-session-text] error: ACCOUNT_ID and USER_ID must be set in env (accountId=${accountId || "empty"} userId=${userId || "empty"})\n`);
+    process.exit(1);
+}
+try {
+    const result = await voiceIngestSessionText({
+        sessionJsonlPath: transcriptPath,
+        accountId,
+        userId,
+        sessionId,
+    });
+    // Emit one-line summary to stdout for the hook to capture.
+    process.stdout.write(`turns=${result.ingestedCount} skipped=${result.skippedCount} sessionId=${result.sessionId ?? "unknown"}\n`);
+    process.exit(0);
+}
+catch (err) {
+    process.stderr.write(`[ingest-session-text] error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+}
+finally {
+    await closeDriver();
+}
+//# sourceMappingURL=ingest-session-text.js.map

package/payload/premium-plugins/writer-craft/mcp/dist/cli/ingest-session-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-session-text.js","sourceRoot":"","sources":["../../src/cli/ingest-session-text.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvC,IAAI,CAAC,cAAc,EAAE,CAAC;IACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;AAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;AACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC;AAEtD,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qFAAqF,SAAS,IAAI,OAAO,WAAW,MAAM,IAAI,OAAO,KAAK,CAC3I,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;QAC1C,gBAAgB,EAAE,cAAc;QAChC,SAAS;QACT,MAAM;QACN,SAAS;KACV,CAAC,CAAC;IACH,2DAA2D;IAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,SAAS,MAAM,CAAC,aAAa,YAAY,MAAM,CAAC,YAAY,cAAc,MAAM,CAAC,SAAS,IAAI,SAAS,IAAI,CAC5G,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACrF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;QAAS,CAAC;IACT,MAAM,WAAW,EAAE,CAAC;AACtB,CAAC"}

package/payload/premium-plugins/writer-craft/mcp/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { AUTHORSHIP_MODES } from "./tools/voice-tag-content.js";
+export { AUTHORSHIP_MODES };
+//# sourceMappingURL=index.d.ts.map

package/payload/premium-plugins/writer-craft/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmB,gBAAgB,EAAuB,MAAM,8BAA8B,CAAC;AAkZtG,OAAO,EAAE,gBAAgB,EAAE,CAAC"}