@rubytech/create-maxy-code 0.1.264 → 0.1.266

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-retrieve-conditioning.js

@@ -29,7 +29,7 @@
 import neo4j from "neo4j-driver";
 import { getSession } from "../lib/neo4j.js";
 import { notTrashed } from "../lib/voice-corpus.js";
-import { voiceCorpusWhereWithFormat, } from "../lib/voice-corpus.js";
+import { voiceCorpusWhereWithFormat, voiceCorpusWhereWithFormatAndAuthor, ORG_USER_ID, } from "../lib/voice-corpus.js";
 const DEFAULT_TOKEN_BUDGET_SHORT = 16_000;
 const DEFAULT_TOKEN_BUDGET_LONG = 96_000;
 const CHARS_PER_TOKEN = 4;
@@ -52,33 +52,14 @@ export async function voiceRetrieveConditioning(params) {
         (length === "long" ? DEFAULT_TOKEN_BUDGET_LONG : DEFAULT_TOKEN_BUDGET_SHORT);
     const charBudget = tokenBudget * CHARS_PER_TOKEN;
     const format = brief.format;
-    const corpusWhere = voiceCorpusWhereWithFormat(format);
-    // getSession() is inside the try so driver-construction / connection-config
-    // faults (NEO4J_URI unset, password file missing) are caught, logged, and
-    // returned as the error state rather than escaping the function silently
-    // (Task 493).
-    let session;
-    try {
-        session = getSession();
-        // 1. Style card — per-format profile.
-        const profile = await session.run(`MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
-       OPTIONAL MATCH (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile {accountId: $accountId, userId: $userId, format: $format})
-       RETURN p.styleCard AS styleCard`, { accountId, userId, format });
-        const styleCard = profile.records[0]?.get("styleCard") ?? null;
-        // 2. Exemplars — filtered to brief.format. Keyword-aware when topic is set.
-        //
-        // Body resolution (Task 471):
-        //   - For :KnowledgeDocument with HAS_SECTION children, concatenate
-        //     child :Section bodies in `position` order. KD.body is null after
-        //     Task 465 server-slicing.
-        //   - Other labels read n.body directly via the COALESCE fallback chain.
-        //
-        // The topic filter runs against the computed body, so a topic that
-        // appears only in n.summary (LLM abstract) no longer matches — by
-        // design: the corpus surfaces verbatim prose, not the abstract.
-        const topic = (brief.topic ?? "").trim();
-        const usesTopic = topic.length > 0;
-        const bodyComputeBlock = `WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
+    const scope = brief.scope ?? "personal";
+    const topic = (brief.topic ?? "").trim();
+    const usesTopic = topic.length > 0;
+    // Body resolution (Task 471): for :KnowledgeDocument with HAS_SECTION
+    // children, concatenate child :Section bodies in `position` order (KD.body is
+    // null after Task 465 server-slicing); other labels read n.body via the
+    // COALESCE chain. The topic filter runs against the computed body.
+    const bodyComputeBlock = `WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
          OPTIONAL MATCH (n)-[:HAS_SECTION]->(s:Section)
          WHERE ${notTrashed("s")}
          WITH n, ts, s ORDER BY s.position
@@ -88,64 +69,92 @@ export async function voiceRetrieveConditioning(params) {
              THEN reduce(acc = '', b IN sectionBodies | acc + b + '\n\n')
            ELSE coalesce(n.body, n.abstract, n.subject, n.title, n.summary, '')
          END AS body`;
-        const cypher = usesTopic
-            ? `MATCH (n)
-         WHERE ${corpusWhere}
-         ${bodyComputeBlock}
-         WHERE toLower(body) CONTAINS toLower($topic)
-         RETURN elementId(n) AS id,
-                labels(n) AS labels,
-                body,
-                coalesce(n.subject, n.title, n.name, '') AS source,
-                ts
-         ORDER BY ts IS NULL, ts DESC
-         LIMIT $k`
-            : `MATCH (n)
-         WHERE ${corpusWhere}
-         ${bodyComputeBlock}
-         RETURN elementId(n) AS id,
-                labels(n) AS labels,
-                body,
-                coalesce(n.subject, n.title, n.name, '') AS source,
-                ts
-         ORDER BY ts IS NULL, ts DESC
-         LIMIT $k`;
-        const result = await session.run(cypher, {
-            accountId,
-            format,
-            topic,
-            // neo4j-driver serializes a plain JS number as a Cypher float (15 → 15.0),
-            // which LIMIT rejects ("not a valid value. Must be a non-negative integer").
-            // Send it as a Neo4j integer.
-            k: neo4j.int(k),
-        });
-        let charsUsed = 0;
-        const exemplars = [];
-        for (const r of result.records) {
-            const body = r.get("body") ?? "";
-            if (body.length === 0)
-                continue;
-            const labels = r.get("labels") ?? [];
-            const label = labels.find((l) => ["KnowledgeDocument", "Message", "SocialPost", "Conversation"].includes(l)) ?? labels[0] ?? "Unknown";
-            const remaining = charBudget - charsUsed;
-            if (remaining <= 0)
-                break;
-            const truncated = body.length > remaining ? body.slice(0, remaining) : body;
-            exemplars.push({
-                nodeId: r.get("id"),
-                label,
-                body: truncated,
-                source: (r.get("source") ?? "").slice(0, 200),
+    // getSession() is inside the try so driver-construction / connection-config
+    // faults (NEO4J_URI unset, password file missing) are caught, logged, and
+    // returned as the error state rather than escaping the function silently
+    // (Task 493).
+    let session;
+    try {
+        session = getSession();
+        // One scoped lookup: the profile style card (keyed on the profile's userId)
+        // plus K voice-matched exemplars over the scope's corpus. Org passes the
+        // account-wide corpus + `__org__`; personal passes the author-filtered
+        // corpus + the operator's userId. Each call gets a fresh char budget.
+        const lookup = async (profileUserId, exemplarWhere, exemplarParams) => {
+            const profile = await session.run(`OPTIONAL MATCH (p:VoiceProfile {accountId: $accountId, userId: $profileUserId, format: $format})
+         RETURN p.styleCard AS styleCard`, { accountId, profileUserId, format });
+            const styleCard = profile.records[0]?.get("styleCard") ?? null;
+            const cypher = usesTopic
+                ? `MATCH (n)
+           WHERE ${exemplarWhere}
+           ${bodyComputeBlock}
+           WHERE toLower(body) CONTAINS toLower($topic)
+           RETURN elementId(n) AS id, labels(n) AS labels, body,
+                  coalesce(n.subject, n.title, n.name, '') AS source, ts
+           ORDER BY ts IS NULL, ts DESC
+           LIMIT $k`
+                : `MATCH (n)
+           WHERE ${exemplarWhere}
+           ${bodyComputeBlock}
+           RETURN elementId(n) AS id, labels(n) AS labels, body,
+                  coalesce(n.subject, n.title, n.name, '') AS source, ts
+           ORDER BY ts IS NULL, ts DESC
+           LIMIT $k`;
+            const result = await session.run(cypher, {
+                ...exemplarParams,
+                topic,
+                // neo4j-driver serializes a plain JS number as a Cypher float (15 →
+                // 15.0), which LIMIT rejects. Send a Neo4j integer.
+                k: neo4j.int(k),
             });
-            charsUsed += truncated.length;
+            let charsUsed = 0;
+            const exemplars = [];
+            for (const r of result.records) {
+                const body = r.get("body") ?? "";
+                if (body.length === 0)
+                    continue;
+                const labels = r.get("labels") ?? [];
+                const label = labels.find((l) => ["KnowledgeDocument", "Message", "SocialPost", "Conversation"].includes(l)) ?? labels[0] ?? "Unknown";
+                const remaining = charBudget - charsUsed;
+                if (remaining <= 0)
+                    break;
+                const truncated = body.length > remaining ? body.slice(0, remaining) : body;
+                exemplars.push({
+                    nodeId: r.get("id"),
+                    label,
+                    body: truncated,
+                    source: (r.get("source") ?? "").slice(0, 200),
+                });
+                charsUsed += truncated.length;
+            }
+            return { styleCard, exemplars };
+        };
+        const hasData = (r) => (r.styleCard !== null && r.styleCard.length > 0) || r.exemplars.length > 0;
+        const orgLookup = () => lookup(ORG_USER_ID, voiceCorpusWhereWithFormat(format), { accountId, format });
+        let result;
+        let status;
+        if (scope === "personal") {
+            const personal = await lookup(userId, voiceCorpusWhereWithFormatAndAuthor(format), { accountId, format, voiceAuthor: userId });
+            if (hasData(personal)) {
+                result = personal;
+                status = "ok";
+            }
+            else {
+                // No personal profile/corpus yet — borrow the org (house) voice rather
+                // than the bare default register (Task 676).
+                const org = await orgLookup();
+                result = org;
+                status = hasData(org) ? "fallback-org" : "no-data";
+            }
+        }
+        else {
+            const org = await orgLookup();
+            result = org;
+            status = hasData(org) ? "ok" : "no-data";
         }
-        process.stderr.write(`[voice-retrieve] task=${brief.topic ?? length} format=${format} styleCardBytes=${styleCard?.length ?? 0} exemplarCount=${exemplars.length} tokenBudget=${tokenBudget}\n`);
-        // An empty-string styleCard with no exemplars is no-data, not ok — a blank
-        // card conditions nothing, so reporting "ok" would be the same lie this
-        // discriminator exists to prevent (Task 493).
-        const hasStyleCard = styleCard !== null && styleCard.length > 0;
-        const status = hasStyleCard || exemplars.length > 0 ? "ok" : "no-data";
-        return { styleCard, exemplars, status };
+        process.stderr.write(`[voice-retrieve] scope=${scope} format=${format} status=${status} ` +
+            `styleCardBytes=${result.styleCard?.length ?? 0} exemplarCount=${result.exemplars.length} tokenBudget=${tokenBudget}\n`);
+        return { styleCard: result.styleCard, exemplars: result.exemplars, status };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-retrieve-conditioning.js.map

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

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

@@ -1,12 +1,30 @@
 import { type VoiceFormat } from "../lib/voice-corpus.js";
 export type AuthorshipMode = "human-only" | "human-led-agent-assisted" | "agent-led-human-reviewed" | "agent-only" | "unknown";
 export declare const AUTHORSHIP_MODES: ReadonlySet<AuthorshipMode>;
+/**
+ * Resolve the corpus author for a tag write (Task 676). An explicit, non-blank
+ * `author` wins; otherwise the tagging operator's `userId`. Throws when neither
+ * is available (no `author` argument and no `ADMIN_USER_ID` in spawn env), so a
+ * tag can never silently land with a null author.
+ *
+ * This is why single-operator accounts get personal attribution for free: with
+ * `author` omitted, the sole operator is the implicit author, so their personal
+ * corpus equals the account-wide corpus and prior behaviour is reproduced.
+ */
+export declare function resolveVoiceAuthor(author: string | undefined, operatorUserId: string | null): string;
 export interface VoiceTagContentParams {
     nodeIds: string[];
     mode: AuthorshipMode;
     accountId: string;
     /** Writing format (required). Editorial classification — operator-supplied. */
     format: VoiceFormat;
+    /**
+     * The corpus author (a userId) to stamp on each node (Task 676). Resolve via
+     * `resolveVoiceAuthor` before calling — explicit author, else the tagging
+     * operator. Personal distillation filters on this; org distillation ignores
+     * it (account-wide).
+     */
+    voiceAuthor: string;
 }
 export interface VoiceTagContentResult {
     updated: number;

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-tag-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice-tag-content.d.ts","sourceRoot":"","sources":["../../src/tools/voice-tag-content.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,0BAA0B,GAC1B,0BAA0B,GAC1B,YAAY,GACZ,SAAS,CAAC;AAEd,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAMvD,CAAC;AAEH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAsFhC"}
+{"version":3,"file":"voice-tag-content.d.ts","sourceRoot":"","sources":["../../src/tools/voice-tag-content.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,0BAA0B,GAC1B,0BAA0B,GAC1B,YAAY,GACZ,SAAS,CAAC;AAEd,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAMvD,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,MAAM,CAOR;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAmGhC"}

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-tag-content.js

@@ -21,8 +21,26 @@ export const AUTHORSHIP_MODES = new Set([
     "agent-only",
     "unknown",
 ]);
+/**
+ * Resolve the corpus author for a tag write (Task 676). An explicit, non-blank
+ * `author` wins; otherwise the tagging operator's `userId`. Throws when neither
+ * is available (no `author` argument and no `ADMIN_USER_ID` in spawn env), so a
+ * tag can never silently land with a null author.
+ *
+ * This is why single-operator accounts get personal attribution for free: with
+ * `author` omitted, the sole operator is the implicit author, so their personal
+ * corpus equals the account-wide corpus and prior behaviour is reproduced.
+ */
+export function resolveVoiceAuthor(author, operatorUserId) {
+    const explicit = (author ?? "").trim();
+    if (explicit)
+        return explicit;
+    if (operatorUserId)
+        return operatorUserId;
+    throw new Error("voice-tag-content: author required — no ADMIN_USER_ID in spawn env and no author given.");
+}
 export async function voiceTagContent(params) {
-    const { nodeIds, mode, accountId, format } = params;
+    const { nodeIds, mode, accountId, format, voiceAuthor } = params;
     if (!AUTHORSHIP_MODES.has(mode)) {
         throw new Error(`voice-tag-content: invalid authorshipMode '${mode}'. Valid values: ${[
             ...AUTHORSHIP_MODES,
@@ -40,6 +58,12 @@ export async function voiceTagContent(params) {
     if (!Array.isArray(nodeIds) || nodeIds.length === 0) {
         return { updated: 0, skipped: 0, skippedReasons: {} };
     }
+    // voiceAuthor is checked after the empty-nodeIds early return: an empty tag is
+    // a no-op, so there is nothing to attribute. With nodes to tag, the author
+    // must be resolved (index.ts always supplies it via resolveVoiceAuthor).
+    if (!voiceAuthor) {
+        throw new Error("voice-tag-content: voiceAuthor is required (resolve via resolveVoiceAuthor before calling).");
+    }
     const session = getSession();
     const now = new Date().toISOString();
     const skippedReasons = {};
@@ -66,13 +90,15 @@ export async function voiceTagContent(params) {
                })
          SET n.authorshipMode = $mode,
              n.authorshipTaggedAt = $now,
-             n.format = $format
+             n.format = $format,
+             n.voiceAuthor = $voiceAuthor
          RETURN elementId(n) AS id`, {
                 ids: batch,
                 accountId,
                 mode,
                 now,
                 format,
+                voiceAuthor,
                 primaryLabels: [...TAGGABLE_PRIMARY_LABELS],
             });
             const matched = new Set(result.records.map((r) => r.get("id")));
@@ -88,7 +114,10 @@ export async function voiceTagContent(params) {
     finally {
         await session.close();
     }
-    process.stderr.write(`[voice-tag] mode=${mode} format=${format} accountId=${accountId} updated=${updated} skipped=${nodeIds.length - updated}\n`);
+    // Tagging is always a personal-attribution act: every tagged node carries an
+    // author and feeds both that author's personal walk and the account-wide org
+    // walk. There is no org-only corpus node, so scope is constant `personal`.
+    process.stderr.write(`[voice-tag] mode=${mode} format=${format} scope=personal author=${voiceAuthor} accountId=${accountId} updated=${updated} skipped=${nodeIds.length - updated}\n`);
     return {
         updated,
         skipped: nodeIds.length - updated,

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-tag-content.js.map

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

package/payload/premium-plugins/writer-craft/mcp/scripts/smoke.mjs

@@ -10,12 +10,16 @@
  *   4. AUTHORSHIP_MODES enum covers the five spec-required values.
  *   5. TAGGABLE_PRIMARY_LABELS covers the three content labels.
  *   6. FORMAT_VALUES covers the six writing-format values (Task 462).
- *   7. voiceCorpusWhereWithFormat() appends the format predicate.
+ *   7. voiceCorpusWhereWithFormat() appends the format predicate;
+ *      voiceCorpusWhereWithFormatAndAuthor() also appends the author predicate,
+ *      and ORG_USER_ID / profileUserIdForScope map scope→userId (Task 676).
  * *   8. voice-retrieve-conditioning discriminates error from no-data (Task 493):
  *      status:"error" on blank identity and on a forced lookup throw, never
  *      collapsing a failed lookup into the no-data payload.
  *   9. voice-tag-content validates mode and format enums, requires format,
- *      and returns zero counts on empty nodeIds (with format supplied).
+ *      returns zero counts on empty nodeIds, and requires voiceAuthor when
+ *      there are nodes to tag; resolveVoiceAuthor defaults to the operator
+ *      (Task 676).
  *  11. voice-ingest-session-text: filterOperatorText() keeps real turns
  *      and excludes slash commands, paste blocks, and system reminders.
  *
@@ -160,6 +164,17 @@ await check("voiceCorpusWhereWithFormat appends format predicate", () => {
   assert.ok(result.includes("n.format = $format"));
   assert.ok(result.includes("email") || result.includes("$format"));
 });
+await check("voiceCorpusWhereWithFormatAndAuthor appends format + author predicates (Task 676)", () => {
+  const result = corpusMod.voiceCorpusWhereWithFormatAndAuthor("article");
+  assert.ok(result.includes(corpusMod.VOICE_CORPUS_WHERE));
+  assert.ok(result.includes("n.format = $format"));
+  assert.ok(result.includes("n.voiceAuthor = $voiceAuthor"));
+});
+await check("ORG_USER_ID sentinel + profileUserIdForScope map scope→userId (Task 676)", () => {
+  assert.equal(corpusMod.ORG_USER_ID, "__org__");
+  assert.equal(corpusMod.profileUserIdForScope("org", "ua"), "__org__");
+  assert.equal(corpusMod.profileUserIdForScope("personal", "ua"), "ua");
+});
 
 // ---------------------------------------------------------------------------
 // 4. deriveFormat is gone (Task 471) — format is operator-supplied editorial.
@@ -290,6 +305,24 @@ await check("voice-tag-content returns zero counts on empty nodeIds (no DB hit)"
   });
   assert.deepEqual(result, { updated: 0, skipped: 0, skippedReasons: {} });
 });
+await check("voice-tag-content requires voiceAuthor when there are nodes to tag (Task 676)", async () => {
+  await assert.rejects(
+    () =>
+      tagMod.voiceTagContent({
+        nodeIds: ["x"],
+        mode: "human-only",
+        accountId: "acc",
+        format: "text",
+      }),
+    /voiceAuthor is required/,
+  );
+});
+await check("resolveVoiceAuthor: explicit author wins, omitted defaults to operator, neither throws (Task 676)", () => {
+  assert.equal(tagMod.resolveVoiceAuthor("B", "ua"), "B");
+  assert.equal(tagMod.resolveVoiceAuthor(undefined, "ua"), "ua");
+  assert.equal(tagMod.resolveVoiceAuthor("  ", "ua"), "ua");
+  assert.throws(() => tagMod.resolveVoiceAuthor(undefined, null));
+});
 
 // ---------------------------------------------------------------------------
 // 7. voice-ingest-session-text: operator-turn filter (no DB required).

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

@@ -4,7 +4,8 @@ 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, type AuthorshipMode } from "./tools/voice-tag-content.js";
+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";
@@ -53,6 +54,14 @@ 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__'.",
+  );
+
 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.",
@@ -70,21 +79,48 @@ server.tool(
     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 }) => {
+  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 import("./lib/voice-corpus.js").VoiceFormat,
+        format: format as VoiceFormat,
+        voiceAuthor,
       });
       return {
         content: [
           {
             type: "text" as const,
-            text: `voice-tag: mode=${mode} format=${format} updated=${result.updated} skipped=${result.skipped}`,
+            text: `voice-tag: mode=${mode} format=${format} author=${voiceAuthor} updated=${result.updated} skipped=${result.skipped}`,
           },
         ],
       };
@@ -104,7 +140,7 @@ server.tool(
 
 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.",
+  "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()
@@ -139,8 +175,9 @@ server.tool(
       .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 }) => {
+  async ({ userId, format, force, mode, styleCardYaml, nodeIds, amendedFromNodeIds, scope }) => {
     if (!accountId) return refuseNoAccount("voice-distil-profile");
     const resolvedUserId = userId ?? resolveUserId();
     if (!resolvedUserId) {
@@ -165,6 +202,7 @@ server.tool(
         styleCardYaml,
         nodeIds,
         amendedFromNodeIds,
+        scope: scope as import("./lib/voice-corpus.js").VoiceScope | undefined,
       });
 
       // Summarise single-format or multi-format result.
@@ -207,7 +245,7 @@ server.tool(
 
 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'.",
+  "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()
@@ -223,9 +261,10 @@ server.tool(
       .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, tokenBudget }) => {
+  async ({ userId, format, topic, length, register, scope, tokenBudget }) => {
     if (!accountId) return refuseNoAccount("voice-retrieve-conditioning");
     const resolvedUserId = userId ?? resolveUserId();
     if (!resolvedUserId) {
@@ -254,6 +293,7 @@ server.tool(
           topic,
           length: length as "short" | "long" | undefined,
           register,
+          scope: scope as import("./lib/voice-corpus.js").VoiceScope | undefined,
         },
         tokenBudget,
       });
@@ -287,7 +327,7 @@ server.tool(
 
 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).",
+  "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."),
@@ -299,8 +339,9 @@ server.tool(
       .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 }) => {
+  async ({ userId, format, originalText, editedText, intent, skill, brief, scope }) => {
     if (!accountId) return refuseNoAccount("voice-record-feedback");
     const resolvedUserId = userId ?? resolveUserId();
     if (!resolvedUserId) {
@@ -322,6 +363,7 @@ server.tool(
         originalText,
         editedText,
         intent,
+        scope: scope as import("./lib/voice-corpus.js").VoiceScope | undefined,
         context: { skill, brief },
       });
       return {

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

@@ -113,3 +113,42 @@ export type VoiceFormat = (typeof FORMAT_VALUES)[number];
 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`;
+}