@rubytech/create-siteoffice-code 0.1.256

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

@@ -0,0 +1,362 @@
+import { initStderrTee } from "../../lib/mcp-stderr-tee/dist/index.js";
+initStderrTee("writer-craft");
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { voiceTagContent, AUTHORSHIP_MODES } from "./tools/voice-tag-content.js";
+import { voiceDistilProfile } from "./tools/voice-distil-profile.js";
+import { voiceRetrieveConditioning } from "./tools/voice-retrieve-conditioning.js";
+import { voiceRecordFeedback } from "./tools/voice-record-feedback.js";
+import { voiceIngestSessionText } from "./tools/voice-ingest-session-text.js";
+import { FORMAT_VALUES } from "./lib/voice-corpus.js";
+import { closeDriver } from "./lib/neo4j.js";
+const server = new McpServer({
+    name: "maxy-writer-craft",
+    version: "0.1.0",
+});
+// Plugin-system boot tolerance — module-init must never throw. Per-call
+// refusal preserves account isolation. Mirrors the memory plugin's
+// pattern (Task 202).
+const accountId = process.env.ACCOUNT_ID ?? null;
+const userIdEnv = process.env.ADMIN_USER_ID ?? null;
+process.stderr.write(`[writer-craft] boot accountId=${accountId ?? "null"} userId=${userIdEnv ?? "null"}\n`);
+function refuseNoAccount(toolName) {
+    process.stderr.write(`[writer-craft] tool=${toolName} refuse reason=no-account-context\n`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${toolName} cannot execute: this MCP instance was launched without ACCOUNT_ID. Per-account graph access requires ACCOUNT_ID at spawn.`,
+            },
+        ],
+        isError: true,
+    };
+}
+function resolveUserId() {
+    // ADMIN_USER_ID is stamped by the admin session manager at spawn time.
+    // When absent (e.g. specialist subagents), the operator must pass it as
+    // a tool argument or the tools refuse rather than orphan a profile.
+    return userIdEnv;
+}
+// Format enum schema — shared across tools that accept VoiceFormat.
+const zFormat = z.enum([...FORMAT_VALUES]).describe("Writing format: text | email | social-post | article | marketing-copy | note. One :VoiceProfile per (accountId, userId, format).");
+server.tool("voice-tag-content", "Stamp authorshipMode and format on one or many content nodes (:KnowledgeDocument | :Message | :SocialPost) the operator owns. Email threads live as :KnowledgeDocument {source:'email'} since Task 321. Valid modes: human-only, human-led-agent-assisted, agent-led-human-reviewed, agent-only, unknown. Valid formats: text, email, social-post, article, marketing-copy, note. format is editorial — the operator chooses it per node; the tool does not infer it.", {
+    nodeIds: z.array(z.string()).min(1).describe("Element IDs of nodes to tag"),
+    mode: z
+        .enum([
+        "human-only",
+        "human-led-agent-assisted",
+        "agent-led-human-reviewed",
+        "agent-only",
+        "unknown",
+    ])
+        .describe("Authorship mode to apply"),
+    format: zFormat.describe("Writing format. Required — the operator's editorial classification of the content."),
+}, async ({ nodeIds, mode, format }) => {
+    if (!accountId)
+        return refuseNoAccount("voice-tag-content");
+    try {
+        const result = await voiceTagContent({
+            nodeIds,
+            mode: mode,
+            accountId,
+            format: format,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `voice-tag: mode=${mode} format=${format} updated=${result.updated} skipped=${result.skipped}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `voice-tag-content failed: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.tool("voice-distil-profile", "Three-mode tool. mode='sample' (default) walks the operator's full per-format human-only corpus and returns exemplars + recent edit intents for the agent to compose a fresh style card; cadence-guarded (≥20% corpus growth OR ≥30 days). mode='amend' (Task 472) reads only the named documents plus the existing :VoiceProfile.styleCard so the agent can decide whether one or more specific documents move the profile — operator-initiated, no cadence guard. mode='write' persists the YAML style card the agent composed; supply amendedFromNodeIds to attribute the write to specific documents (Task 472, bypasses cadence + corpus walk; existing LEARNED_FROM edges remain via MERGE). Trashed nodes are excluded from every walk. When format is omitted on 'sample', enumerates all formats in the corpus and distils each.", {
+    userId: z
+        .string()
+        .optional()
+        .describe("Operator AdminUser identifier. Defaults to ADMIN_USER_ID env from spawn context."),
+    format: zFormat.optional().describe("Writing format to distil. Required for mode='amend' and mode='write'. When omitted on 'sample', enumerates corpus formats and distils each that fires the cadence guard."),
+    force: z
+        .boolean()
+        .optional()
+        .describe("Override cadence guard on full-corpus sample/write; ignored by mode='amend' (always proceeds)."),
+    mode: z
+        .enum(["sample", "amend", "write"])
+        .optional()
+        .describe("'sample' returns full-corpus exemplars + feedback for in-turn distillation; 'amend' returns existing styleCard + bodies of one or more named documents for incremental update; 'write' persists the agent-produced styleCardYaml."),
+    styleCardYaml: z
+        .string()
+        .optional()
+        .describe("Required for mode='write'. The YAML style card the agent composed (from the sample exemplars + feedback intents, or from the amend bodies + existing card)."),
+    nodeIds: z
+        .array(z.string())
+        .optional()
+        .describe("Required for mode='amend'. ElementIds of the documents the operator wants folded into the per-format profile (one or more). Each id is eligibility-checked; ineligible ones come back in the ineligible[] payload."),
+    amendedFromNodeIds: z
+        .array(z.string())
+        .optional()
+        .describe("Optional for mode='write' after an amend sample. ElementIds the agent decided actually moved the profile. Each becomes a LEARNED_FROM edge from the persisted :VoiceProfile. Setting this routes the write through the amend-write path (no corpus walk, cadence bypassed)."),
+}, async ({ userId, format, force, mode, styleCardYaml, nodeIds, amendedFromNodeIds }) => {
+    if (!accountId)
+        return refuseNoAccount("voice-distil-profile");
+    const resolvedUserId = userId ?? resolveUserId();
+    if (!resolvedUserId) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "voice-distil-profile: userId required (no ADMIN_USER_ID in spawn env).",
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const result = await voiceDistilProfile({
+            accountId,
+            userId: resolvedUserId,
+            format: format,
+            force: force === true,
+            mode,
+            styleCardYaml,
+            nodeIds,
+            amendedFromNodeIds,
+        });
+        // Summarise single-format or multi-format result.
+        const summariseOne = (r, fmt) => {
+            const tag = fmt ? ` format=${fmt}` : "";
+            if (r.eligible !== undefined) {
+                // amend sample
+                return `voice-distil amend${tag}: eligible=${r.eligible} ineligible=${r.ineligible?.length ?? 0} exemplars=${r.exemplars?.length ?? 0} existingProfile=${r.profileId ?? "none"} feedbackEntries=${r.feedbackEntries}\n${JSON.stringify({ existingStyleCard: r.existingStyleCard, exemplars: r.exemplars, feedbackIntents: r.feedbackIntents, ineligible: r.ineligible }, null, 2)}`;
+            }
+            if (r.skipped && r.exemplars) {
+                return `voice-distil sample${tag}: corpusSize=${r.corpusSize} exemplars=${r.exemplars.length} feedbackEntries=${r.feedbackEntries}\n${JSON.stringify({ exemplars: r.exemplars, feedbackIntents: r.feedbackIntents }, null, 2)}`;
+            }
+            if (r.skipped) {
+                return `voice-distil${tag}: skipped reason=${r.skipReason} corpusSize=${r.corpusSize}`;
+            }
+            return `voice-distil${tag}: ok profileId=${r.profileId} corpusSize=${r.corpusSize} feedbackEntries=${r.feedbackEntries} generatedAt=${r.generatedAt}`;
+        };
+        let summary;
+        if (Array.isArray(result)) {
+            summary = result.map((r, i) => summariseOne(r)).join("\n---\n");
+        }
+        else {
+            summary = summariseOne(result, format);
+        }
+        return { content: [{ type: "text", text: summary }] };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `voice-distil-profile failed: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.tool("voice-retrieve-conditioning", "Return the operator's per-format style card and K voice-matched exemplars for a drafting brief. K=5 short-form (length='short'), K=15 long-form (length='long'). Token-budget bounded. format is required (the writing type: text|email|social-post|article|marketing-copy|note). Returns {styleCard, exemplars, status} where status is one of: 'ok' (profile and/or exemplars returned), 'no-data' (no profile exists and the corpus is empty), 'error' (the lookup failed — carries an error message). Drafting falls back to default register on both 'no-data' and 'error', but only 'no-data' means 'you have no voice profile yet' — never report no-profile on 'error'.", {
+    userId: z
+        .string()
+        .optional()
+        .describe("Operator AdminUser identifier. Defaults to ADMIN_USER_ID env."),
+    format: zFormat.describe("Writing format for corpus and profile scoping."),
+    topic: z
+        .string()
+        .optional()
+        .describe("Drafting topic keyword (filters exemplars to relevant ones)"),
+    length: z
+        .enum(["short", "long"])
+        .optional()
+        .describe("K-selector: short = K=5 (16k tokens, email/post); long = K=15 (96k tokens, brochure/prospectus). Defaults to short."),
+    register: z.string().optional().describe("Optional register hint"),
+    tokenBudget: z.number().int().positive().optional(),
+}, async ({ userId, format, topic, length, register, tokenBudget }) => {
+    if (!accountId)
+        return refuseNoAccount("voice-retrieve-conditioning");
+    const resolvedUserId = userId ?? resolveUserId();
+    if (!resolvedUserId) {
+        // Soft (no isError) so drafting degrades, but status:error keeps this
+        // distinct from genuine no-data (Task 493).
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        styleCard: null,
+                        exemplars: [],
+                        status: "error",
+                        error: "no userId (no ADMIN_USER_ID in spawn env)",
+                    }),
+                },
+            ],
+        };
+    }
+    try {
+        const result = await voiceRetrieveConditioning({
+            accountId,
+            userId: resolvedUserId,
+            brief: {
+                format: format,
+                topic,
+                length: length,
+                register,
+            },
+            tokenBudget,
+        });
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(result) },
+            ],
+        };
+    }
+    catch (err) {
+        // Graceful degradation: never an error response (no isError) so drafting
+        // does not crash — but the payload carries status:error so the failure
+        // is not masquerading as no-data (Task 493).
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[voice-retrieve] tool error: ${message}\n`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        styleCard: null,
+                        exemplars: [],
+                        status: "error",
+                        error: message,
+                    }),
+                },
+            ],
+        };
+    }
+});
+server.tool("voice-record-feedback", "Capture an operator's edit on an agent draft. Writes :VoiceEdit linked to the per-format :VoiceProfile via :FEEDBACK_FOR. The calling agent supplies `intent` (one sentence describing what changed and what voice preference it reveals — Task 424) and `format` (the writing format of the draft).", {
+    userId: z.string().optional(),
+    format: zFormat.describe("Writing format of the draft being edited."),
+    originalText: z.string().min(1),
+    editedText: z.string().min(1),
+    intent: z
+        .string()
+        .min(1)
+        .describe("One sentence summarising what changed and what voice preference it reveals — produced by the calling agent in-turn from originalText vs editedText (Task 424)."),
+    skill: z.string().optional().describe("Calling skill name, for provenance"),
+    brief: z.string().optional().describe("Drafting brief that produced the original"),
+}, async ({ userId, format, originalText, editedText, intent, skill, brief }) => {
+    if (!accountId)
+        return refuseNoAccount("voice-record-feedback");
+    const resolvedUserId = userId ?? resolveUserId();
+    if (!resolvedUserId) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "voice-record-feedback: userId required (no ADMIN_USER_ID in spawn env).",
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const result = await voiceRecordFeedback({
+            accountId,
+            userId: resolvedUserId,
+            format: format,
+            originalText,
+            editedText,
+            intent,
+            context: { skill, brief },
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `voice-record-feedback: editId=${result.editId} format=${format} intent="${result.intent}" hadProfile=${result.hadProfile}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `voice-record-feedback failed: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+server.tool("voice-ingest-session-text", "Write operator turns from the current session as :Message {format:'text', source:'admin-pty', authorshipMode:'human-only'} corpus nodes. The admin agent reads its own operator turns from the live conversation context and passes them as `turns`. Deduplication via SHA256 contentHash — re-running with the same turns is a no-op. Triggers voice-distil-profile {format:'text'} after ingest (cadence guard decides whether distillation runs). Invoked on demand by the voice-mirror skill when the operator asks to capture this session's voice.", {
+    turns: z.array(z.string()).describe("Operator turns the agent read from its own session context (one string per operator message). Slash commands, harness injections, and large paste blocks are filtered out by the tool."),
+    sessionId: z.string().optional().describe("Session ID for provenance."),
+    userId: z.string().optional().describe("Operator AdminUser identifier. Defaults to ADMIN_USER_ID env."),
+}, async ({ turns, sessionId, userId }) => {
+    if (!accountId)
+        return refuseNoAccount("voice-ingest-session-text");
+    const resolvedUserId = userId ?? resolveUserId();
+    if (!resolvedUserId) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "voice-ingest-session-text: userId required (no ADMIN_USER_ID in spawn env).",
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const result = await voiceIngestSessionText({
+            turns,
+            accountId,
+            userId: resolvedUserId,
+            sessionId,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `voice-ingest-session-text: ingestedCount=${result.ingestedCount} skippedCount=${result.skippedCount} sessionId=${result.sessionId ?? "unknown"}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `voice-ingest-session-text failed: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.on("SIGTERM", async () => {
+    await closeDriver();
+    process.exit(0);
+});
+// Surface AUTHORSHIP_MODES for downstream callers / docs.
+export { AUTHORSHIP_MODES };
+//# sourceMappingURL=index.js.map

package/payload/premium-plugins/writer-craft/mcp/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/mcp/dist/lib/neo4j.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal neo4j driver wrapper for the writer-craft MCP server.
+ *
+ * Mirrors the public surface of `platform/plugins/memory/mcp/src/lib/neo4j.ts`:
+ * `getSession()` returns a session, `closeDriver()` releases the singleton.
+ * Password resolution follows the same `PLATFORM_ROOT/config/.neo4j-password`
+ * convention, with an explicit `NEO4J_URI` requirement to avoid silent
+ * cross-account orphaning.
+ */
+import { Driver, Session } from "neo4j-driver";
+export declare function getDriver(): Driver;
+export declare function getSession(): Session;
+export declare function closeDriver(): Promise<void>;
+//# sourceMappingURL=neo4j.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.d.ts","sourceRoot":"","sources":["../../src/lib/neo4j.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAqBtD,wBAAgB,SAAS,IAAI,MAAM,CAclC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjD"}

package/payload/premium-plugins/writer-craft/mcp/dist/lib/neo4j.js

@@ -0,0 +1,47 @@
+/**
+ * Minimal neo4j driver wrapper for the writer-craft MCP server.
+ *
+ * Mirrors the public surface of `platform/plugins/memory/mcp/src/lib/neo4j.ts`:
+ * `getSession()` returns a session, `closeDriver()` releases the singleton.
+ * Password resolution follows the same `PLATFORM_ROOT/config/.neo4j-password`
+ * convention, with an explicit `NEO4J_URI` requirement to avoid silent
+ * cross-account orphaning.
+ */
+import neo4j from "neo4j-driver";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+let driver = null;
+function readPassword() {
+    if (process.env.NEO4J_PASSWORD)
+        return process.env.NEO4J_PASSWORD;
+    const passwordFile = resolve(process.env.PLATFORM_ROOT ?? resolve(import.meta.dirname, "../../../../../platform"), "config/.neo4j-password");
+    try {
+        return readFileSync(passwordFile, "utf-8").trim();
+    }
+    catch {
+        throw new Error(`Neo4j password not found. Expected at ${passwordFile} or in NEO4J_PASSWORD env var.`);
+    }
+}
+export function getDriver() {
+    if (!driver) {
+        const uri = process.env.NEO4J_URI;
+        if (!uri) {
+            throw new Error("[writer-craft] NEO4J_URI unset — refusing to default to bolt://localhost:7687");
+        }
+        const user = process.env.NEO4J_USER ?? "neo4j";
+        const password = readPassword();
+        process.stderr.write(`[writer-craft] resolved neo4j_uri=${uri}\n`);
+        driver = neo4j.driver(uri, neo4j.auth.basic(user, password));
+    }
+    return driver;
+}
+export function getSession() {
+    return getDriver().session();
+}
+export async function closeDriver() {
+    if (driver) {
+        await driver.close();
+        driver = null;
+    }
+}
+//# sourceMappingURL=neo4j.js.map

package/payload/premium-plugins/writer-craft/mcp/dist/lib/neo4j.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.js","sourceRoot":"","sources":["../../src/lib/neo4j.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAA0B,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClE,MAAM,YAAY,GAAG,OAAO,CAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,CAAC,EACpF,wBAAwB,CACzB,CAAC;IACF,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yCAAyC,YAAY,gCAAgC,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAC;QACnE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/payload/premium-plugins/writer-craft/mcp/dist/lib/voice-corpus.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Cypher fragment that excludes trashed nodes for the given alias.
+ *
+ * Mirrors the platform's soft-delete model: a node is trashed if it
+ * carries the `:Trashed` label OR a non-null `deletedAt` timestamp.
+ * Inlined here (Task 473) instead of imported from
+ * `platform/lib/graph-trash` — the cross-package import path did not
+ * survive `tsc` emit (the `rootDir: "src"` config collapsed
+ * `../../../../../platform/...` to `../../...`, pointing the dist
+ * file at a non-existent location and crashing the MCP on boot). The
+ * predicate is one line; copying it costs less than the build coupling.
+ */
+export declare function notTrashed(alias: string): string;
+/**
+ * Shared corpus-filter clauses and format helpers for the voice-mirror tools.
+ *
+ * Imported by `voice-distil-profile` (count + sample walks),
+ * `voice-retrieve-conditioning` (exemplar walk), `voice-tag-content` (tag
+ * writes), and `voice-ingest-session-text` (on-demand session-text ingest). The single
+ * load-bearing filter — when the corpus rules change, this is the only place
+ * to edit.
+ *
+ * Three predicates in VOICE_CORPUS_WHERE:
+ *
+ *   1. `authorshipMode IN ['human-only', 'human-led-agent-assisted']`.
+ *      `human-only` is the operator's own writing verbatim;
+ *      `human-led-agent-assisted` is operator-authored with light agent
+ *      polish, which still carries voice signal (the operator chose the
+ *      claims and the structure). Including this expands the available
+ *      corpus to match how most modern writing actually happens.
+ *
+ *   2. Label is one of the four primary content labels OR is a
+ *      conversation-document `:Section` chunk (unguarded chat voice from
+ *      WhatsApp / Telegram / Signal / Granola / Otter / Circleback etc.
+ *      archives). After the Task 324 collapse, conversation transcripts
+ *      land as `:KnowledgeDocument` parents carrying `conversationIdentity`
+ *      with plain `:Section` children — no `:Conversation` secondary label.
+ *      Conversation-document sections are identified by their parent's
+ *      `conversationIdentity` property via an EXISTS sub-pattern. The
+ *      conversation parent must itself be live — a trashed parent excludes
+ *      its child chunks.
+ *      Chat captures voice in a way email rarely does — this is the
+ *      single highest-leverage corpus addition for voice fidelity.
+ *
+ *   3. The node is not trashed — `notTrashed("n")` filters both the
+ *      `:Trashed` label and the `deletedAt` property (Task 472). This is
+ *      the read-side equivalent of `graph-trash`'s soft-delete model: a
+ *      node marked by either signal is excluded from every voice-mirror
+ *      walk that goes through VOICE_CORPUS_WHERE.
+ *
+ * The clause expects `$accountId` to be bound in the calling Cypher
+ * parameters. It does not bind any other parameters.
+ */
+export declare const VOICE_CORPUS_WHERE: string;
+/**
+ * The label set the tag tool accepts when stamping `authorshipMode`.
+ * Mirrors the label predicate inside VOICE_CORPUS_WHERE so the tag tool
+ * and the corpus walk stay in lockstep. The tag tool does not filter
+ * by authorshipMode (that's the property it's setting).
+ *
+ * `:Email` retired with Task 321 — email threads now land as
+ * `:KnowledgeDocument {source:'email'}` and are already covered.
+ */
+export declare const TAGGABLE_PRIMARY_LABELS: readonly ["KnowledgeDocument", "Message", "SocialPost"];
+/**
+ * Closed enum of writing-format values. One `:VoiceProfile` exists per
+ * `(accountId, userId, format)`. Adding a new value is a separate task.
+ *
+ * Format is an editorial classification set by the operator at tag time.
+ * The only auto-tagged path is `voice-ingest-session-text`, which hard-codes
+ * `format='text'` on `:Message` because chat turns are unambiguously text and
+ * the operator is not in the loop on session end.
+ */
+export declare const FORMAT_VALUES: readonly ["text", "email", "social-post", "article", "marketing-copy", "note"];
+export type VoiceFormat = (typeof FORMAT_VALUES)[number];
+/**
+ * Returns VOICE_CORPUS_WHERE with an additional `n.format = $format`
+ * predicate appended. Requires `$format` to be bound alongside `$accountId`
+ * in the calling Cypher parameters.
+ *
+ * Format-discovery queries (which enumerate distinct formats from the
+ * corpus) use the base `VOICE_CORPUS_WHERE` directly; per-format corpus
+ * walks use this function.
+ */
+export declare function voiceCorpusWhereWithFormat(format: VoiceFormat): string;
+//# sourceMappingURL=voice-corpus.d.ts.map

package/payload/premium-plugins/writer-craft/mcp/dist/lib/voice-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-corpus.d.ts","sourceRoot":"","sources":["../../src/lib/voice-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,kBAAkB,QAU3B,CAAC;AAEL;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,yDAI1B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,gFAOhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEtE"}

package/payload/premium-plugins/writer-craft/mcp/dist/lib/voice-corpus.js

@@ -0,0 +1,110 @@
+/**
+ * Cypher fragment that excludes trashed nodes for the given alias.
+ *
+ * Mirrors the platform's soft-delete model: a node is trashed if it
+ * carries the `:Trashed` label OR a non-null `deletedAt` timestamp.
+ * Inlined here (Task 473) instead of imported from
+ * `platform/lib/graph-trash` — the cross-package import path did not
+ * survive `tsc` emit (the `rootDir: "src"` config collapsed
+ * `../../../../../platform/...` to `../../...`, pointing the dist
+ * file at a non-existent location and crashing the MCP on boot). The
+ * predicate is one line; copying it costs less than the build coupling.
+ */
+export function notTrashed(alias) {
+    return `(NOT \`${alias}\`:Trashed AND \`${alias}\`.deletedAt IS NULL)`;
+}
+/**
+ * Shared corpus-filter clauses and format helpers for the voice-mirror tools.
+ *
+ * Imported by `voice-distil-profile` (count + sample walks),
+ * `voice-retrieve-conditioning` (exemplar walk), `voice-tag-content` (tag
+ * writes), and `voice-ingest-session-text` (on-demand session-text ingest). The single
+ * load-bearing filter — when the corpus rules change, this is the only place
+ * to edit.
+ *
+ * Three predicates in VOICE_CORPUS_WHERE:
+ *
+ *   1. `authorshipMode IN ['human-only', 'human-led-agent-assisted']`.
+ *      `human-only` is the operator's own writing verbatim;
+ *      `human-led-agent-assisted` is operator-authored with light agent
+ *      polish, which still carries voice signal (the operator chose the
+ *      claims and the structure). Including this expands the available
+ *      corpus to match how most modern writing actually happens.
+ *
+ *   2. Label is one of the four primary content labels OR is a
+ *      conversation-document `:Section` chunk (unguarded chat voice from
+ *      WhatsApp / Telegram / Signal / Granola / Otter / Circleback etc.
+ *      archives). After the Task 324 collapse, conversation transcripts
+ *      land as `:KnowledgeDocument` parents carrying `conversationIdentity`
+ *      with plain `:Section` children — no `:Conversation` secondary label.
+ *      Conversation-document sections are identified by their parent's
+ *      `conversationIdentity` property via an EXISTS sub-pattern. The
+ *      conversation parent must itself be live — a trashed parent excludes
+ *      its child chunks.
+ *      Chat captures voice in a way email rarely does — this is the
+ *      single highest-leverage corpus addition for voice fidelity.
+ *
+ *   3. The node is not trashed — `notTrashed("n")` filters both the
+ *      `:Trashed` label and the `deletedAt` property (Task 472). This is
+ *      the read-side equivalent of `graph-trash`'s soft-delete model: a
+ *      node marked by either signal is excluded from every voice-mirror
+ *      walk that goes through VOICE_CORPUS_WHERE.
+ *
+ * The clause expects `$accountId` to be bound in the calling Cypher
+ * parameters. It does not bind any other parameters.
+ */
+export const VOICE_CORPUS_WHERE = `n.accountId = $accountId
+  AND n.authorshipMode IN ['human-only', 'human-led-agent-assisted']
+  AND ${notTrashed("n")}
+  AND (
+    any(lbl IN labels(n) WHERE lbl IN ['KnowledgeDocument', 'Message', 'SocialPost'])
+    OR ('Section' IN labels(n) AND EXISTS {
+      MATCH (parent:KnowledgeDocument)-[:HAS_SECTION]->(n)
+      WHERE parent.conversationIdentity IS NOT NULL
+        AND ${notTrashed("parent")}
+    })
+  )`;
+/**
+ * The label set the tag tool accepts when stamping `authorshipMode`.
+ * Mirrors the label predicate inside VOICE_CORPUS_WHERE so the tag tool
+ * and the corpus walk stay in lockstep. The tag tool does not filter
+ * by authorshipMode (that's the property it's setting).
+ *
+ * `:Email` retired with Task 321 — email threads now land as
+ * `:KnowledgeDocument {source:'email'}` and are already covered.
+ */
+export const TAGGABLE_PRIMARY_LABELS = [
+    "KnowledgeDocument",
+    "Message",
+    "SocialPost",
+];
+/**
+ * Closed enum of writing-format values. One `:VoiceProfile` exists per
+ * `(accountId, userId, format)`. Adding a new value is a separate task.
+ *
+ * Format is an editorial classification set by the operator at tag time.
+ * The only auto-tagged path is `voice-ingest-session-text`, which hard-codes
+ * `format='text'` on `:Message` because chat turns are unambiguously text and
+ * the operator is not in the loop on session end.
+ */
+export const FORMAT_VALUES = [
+    "text",
+    "email",
+    "social-post",
+    "article",
+    "marketing-copy",
+    "note",
+];
+/**
+ * Returns VOICE_CORPUS_WHERE with an additional `n.format = $format`
+ * predicate appended. Requires `$format` to be bound alongside `$accountId`
+ * in the calling Cypher parameters.
+ *
+ * Format-discovery queries (which enumerate distinct formats from the
+ * corpus) use the base `VOICE_CORPUS_WHERE` directly; per-format corpus
+ * walks use this function.
+ */
+export function voiceCorpusWhereWithFormat(format) {
+    return `${VOICE_CORPUS_WHERE}\n  AND n.format = $format`;
+}
+//# sourceMappingURL=voice-corpus.js.map

package/payload/premium-plugins/writer-craft/mcp/dist/lib/voice-corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-corpus.js","sourceRoot":"","sources":["../../src/lib/voice-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,UAAU,KAAK,oBAAoB,KAAK,uBAAuB,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;QAE1B,UAAU,CAAC,GAAG,CAAC;;;;;;cAMT,UAAU,CAAC,QAAQ,CAAC;;IAE9B,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,mBAAmB;IACnB,SAAS;IACT,YAAY;CACJ,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM;IACN,OAAO;IACP,aAAa;IACb,SAAS;IACT,gBAAgB;IAChB,MAAM;CACE,CAAC;AAIX;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAmB;IAC5D,OAAO,GAAG,kBAAkB,4BAA4B,CAAC;AAC3D,CAAC"}