@rubytech/create-maxy-code 0.1.446 → 0.1.448

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

@@ -1,457 +0,0 @@
-import { initStderrTee } from "../../../../platform/lib/mcp-stderr-tee/dist/index.js";
-import { lifelineTool } from "../../../../platform/lib/mcp-lifeline/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, resolveVoiceAuthor, AUTHORSHIP_MODES, type AuthorshipMode } from "./tools/voice-tag-content.js";
-import type { VoiceFormat } from "./lib/voice-corpus.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: string) {
-  process.stderr.write(
-    `[writer-craft] tool=${toolName} refuse reason=no-account-context\n`,
-  );
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: `${toolName} cannot execute: this MCP instance was launched without ACCOUNT_ID. Per-account graph access requires ACCOUNT_ID at spawn.`,
-      },
-    ],
-    isError: true as const,
-  };
-}
-
-function resolveUserId(): string | null {
-  // 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] as [string, ...string[]]).describe(
-  "Writing format: text | email | social-post | article | marketing-copy | note. One :VoiceProfile per (accountId, userId, format).",
-);
-
-// Scope enum schema — shared across distil / retrieve / feedback (Task 676).
-const zScope = z
-  .enum(["personal", "org"])
-  .optional()
-  .describe(
-    "Voice scope: 'personal' (default) = the operator's own voice, distilled from their author-tagged content and anchored on :AdminUser. 'org' = the account/house voice, distilled from the whole account and anchored on :LocalBusiness under the reserved userId '__org__'.",
-  );
-
-lifelineTool(server,
-  "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.",
-    ),
-    userId: z
-      .string()
-      .optional()
-      .describe(
-        "Operator AdminUser id. Defaults to ADMIN_USER_ID env. Used as the default author when `author` is omitted.",
-      ),
-    author: z
-      .string()
-      .optional()
-      .describe(
-        "voiceAuthor userId to stamp on the nodes. Omit to attribute to the tagging operator — single-operator accounts get personal attribution for free.",
-      ),
-  },
-  async ({ nodeIds, mode, format, userId, author }) => {
-    if (!accountId) return refuseNoAccount("voice-tag-content");
-    let voiceAuthor: string;
-    try {
-      voiceAuthor = resolveVoiceAuthor(author, userId ?? resolveUserId());
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: err instanceof Error ? err.message : String(err),
-          },
-        ],
-        isError: true,
-      };
-    }
-    try {
-      const result = await voiceTagContent({
-        nodeIds,
-        mode: mode as AuthorshipMode,
-        accountId,
-        format: format as VoiceFormat,
-        voiceAuthor,
-      });
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `voice-tag: mode=${mode} format=${format} author=${voiceAuthor} updated=${result.updated} skipped=${result.skipped}`,
-          },
-        ],
-      };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `voice-tag-content failed: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-lifelineTool(server,
-  "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. scope (Task 676): 'personal' (default) distils the operator's author-tagged content; 'org' distils the whole account into the house voice anchored on the business.",
-  {
-    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).",
-      ),
-    scope: zScope,
-  },
-  async ({ userId, format, force, mode, styleCardYaml, nodeIds, amendedFromNodeIds, scope }) => {
-    if (!accountId) return refuseNoAccount("voice-distil-profile");
-    const resolvedUserId = userId ?? resolveUserId();
-    if (!resolvedUserId) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            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 as import("./lib/voice-corpus.js").VoiceFormat | undefined,
-        force: force === true,
-        mode,
-        styleCardYaml,
-        nodeIds,
-        amendedFromNodeIds,
-        scope: scope as import("./lib/voice-corpus.js").VoiceScope | undefined,
-      });
-
-      // Summarise single-format or multi-format result.
-      const summariseOne = (r: import("./tools/voice-distil-profile.js").VoiceDistilProfileResult, fmt?: string): string => {
-        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: string;
-      if (Array.isArray(result)) {
-        summary = result.map((r) => summariseOne(r, r.format)).join("\n---\n");
-      } else {
-        summary = summariseOne(result, format);
-      }
-
-      return { content: [{ type: "text" as const, text: summary }] };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `voice-distil-profile failed: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-lifelineTool(server,
-  "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). scope (Task 676): 'personal' (default) returns the caller's own voice; 'org' returns the account/house voice. A personal request with no personal profile/corpus falls back to the org profile (status 'fallback-org'). Returns {styleCard, exemplars, status} where status is one of: 'ok', 'fallback-org' (personal asked, org returned), 'no-data' (no profile and empty corpus for the scope), 'error' (lookup failed — carries a message). Drafting falls back to default register on 'no-data' and 'error' and injects the org card on 'fallback-org'; 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"),
-    scope: zScope,
-    tokenBudget: z.number().int().positive().optional(),
-  },
-  async ({ userId, format, topic, length, register, scope, tokenBudget }) => {
-    if (!accountId) return refuseNoAccount("voice-retrieve-conditioning");
-    const resolvedUserId = userId ?? resolveUserId();
-    // org scope is account-wide (keyed on ORG_USER_ID + accountId) and never
-    // reads a userId, so a specialist spawn that carries ACCOUNT_ID but no
-    // ADMIN_USER_ID can still retrieve the house voice. Only personal scope
-    // requires a resolved userId (Task 975).
-    if ((scope ?? "personal") !== "org" && !resolvedUserId) {
-      // Soft (no isError) so drafting degrades, but status:error keeps this
-      // distinct from genuine no-data (Task 493).
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: JSON.stringify({
-              styleCard: null,
-              exemplars: [],
-              status: "error",
-              error: "no userId (no ADMIN_USER_ID in spawn env)",
-            }),
-          },
-        ],
-      };
-    }
-    try {
-      const result = await voiceRetrieveConditioning({
-        accountId,
-        // org scope ignores userId; pass through for personal scope.
-        userId: resolvedUserId ?? "",
-        brief: {
-          format: format as import("./lib/voice-corpus.js").VoiceFormat,
-          topic,
-          length: length as "short" | "long" | undefined,
-          register,
-          scope: scope as import("./lib/voice-corpus.js").VoiceScope | undefined,
-        },
-        tokenBudget,
-      });
-      return {
-        content: [
-          { type: "text" as const, 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" as const,
-            text: JSON.stringify({
-              styleCard: null,
-              exemplars: [],
-              status: "error",
-              error: message,
-            }),
-          },
-        ],
-      };
-    }
-  },
-);
-
-lifelineTool(server,
-  "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). scope (Task 676): 'org' routes the edit to the account/house profile; 'personal' (default) to the operator's own. The editor is always preserved via the AUTHORED edge.",
-  {
-    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"),
-    scope: zScope,
-  },
-  async ({ userId, format, originalText, editedText, intent, skill, brief, scope }) => {
-    if (!accountId) return refuseNoAccount("voice-record-feedback");
-    const resolvedUserId = userId ?? resolveUserId();
-    if (!resolvedUserId) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            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 as import("./lib/voice-corpus.js").VoiceFormat,
-        originalText,
-        editedText,
-        intent,
-        scope: scope as import("./lib/voice-corpus.js").VoiceScope | undefined,
-        context: { skill, brief },
-      });
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `voice-record-feedback: editId=${result.editId} format=${format} intent="${result.intent}" hadProfile=${result.hadProfile}`,
-          },
-        ],
-      };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            text: `voice-record-feedback failed: ${err instanceof Error ? err.message : String(err)}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  },
-);
-
-lifelineTool(server,
-  "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" as const,
-            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" as const,
-            text: `voice-ingest-session-text: ingestedCount=${result.ingestedCount} skippedCount=${result.skippedCount} sessionId=${result.sessionId ?? "unknown"}`,
-          },
-        ],
-      };
-    } catch (err) {
-      return {
-        content: [
-          {
-            type: "text" as const,
-            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 };

package/payload/premium-plugins/writer-craft/mcp/src/lib/neo4j.ts

@@ -1,56 +0,0 @@
-/**
- * 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, { Driver, Session } from "neo4j-driver";
-import { readFileSync } from "node:fs";
-import { resolve } from "node:path";
-
-let driver: Driver | null = null;
-
-function readPassword(): string {
-  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(): Driver {
-  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(): Session {
-  return getDriver().session();
-}
-
-export async function closeDriver(): Promise<void> {
-  if (driver) {
-    await driver.close();
-    driver = null;
-  }
-}

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

@@ -1,154 +0,0 @@
-/**
- * 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: string): string {
-  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",
-] as const;
-
-/**
- * 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",
-] as const;
-
-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 function voiceCorpusWhereWithFormat(format: VoiceFormat): string {
-  return `${VOICE_CORPUS_WHERE}\n  AND n.format = $format`;
-}
-
-/**
- * Reserved sentinel userId for the per-account org voice profile (Task 676).
- *
- * Keeps the `(accountId, userId, format)` UNIQUE constraint valid with no
- * migration: exactly one org profile per `(account, format)`. A real
- * `:AdminUser` must never hold this userId — `voice-distil-profile` surfaces
- * a Neo4j constraint error (does not swallow it) if one does.
- */
-export const ORG_USER_ID = "__org__";
-
-/**
- * Voice profile scope. `personal` = one operator's own voice, keyed
- * `(accountId, userId, format)` and anchored on `:AdminUser`. `org` = the
- * account/house voice, keyed `(accountId, '__org__', format)` and anchored on
- * `:LocalBusiness`.
- */
-export type VoiceScope = "personal" | "org";
-
-/**
- * The profile-key userId for a scope: the operator's own id for personal, the
- * reserved sentinel for org. The single place that maps scope → key userId, so
- * distillation, retrieval, and feedback agree on where an org profile lives.
- */
-export function profileUserIdForScope(scope: VoiceScope, userId: string): string {
-  return scope === "org" ? ORG_USER_ID : userId;
-}
-
-/**
- * `VOICE_CORPUS_WHERE` + format predicate + author predicate. Requires both
- * `$format` and `$voiceAuthor` bound in the calling Cypher parameters.
- *
- * Personal distillation and personal retrieval use this to narrow the
- * account-wide corpus to one author's content; org walks use the unchanged
- * account-wide `voiceCorpusWhereWithFormat`.
- */
-export function voiceCorpusWhereWithFormatAndAuthor(format: VoiceFormat): string {
-  return `${VOICE_CORPUS_WHERE}\n  AND n.format = $format\n  AND n.voiceAuthor = $voiceAuthor`;
-}