@rubytech/create-maxy-code 0.1.170 → 0.1.172

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-distil-profile.js

@@ -0,0 +1,225 @@
+/**
+ * voice-distil-profile — walk the operator's `human-only` corpus and
+ * persist a `:VoiceProfile` style card.
+ *
+ * Cadence guard: re-runs on ≥20% corpus growth since last profile, OR
+ * ≥30 days since `generatedAt`. `force: true` overrides both.
+ *
+ * Body-text sampling caps at ~120k chars (rough proxy for tokens at
+ * 4 chars/token = 30k tokens) — well inside Haiku's 200k context window
+ * with headroom for the system prompt + tool schema.
+ */
+import neo4j from "neo4j-driver";
+import { getSession } from "../lib/neo4j.js";
+import { VOICE_CORPUS_WHERE } from "../lib/voice-corpus.js";
+// Task 424 — the Haiku style-card composition moved into the calling agent's
+// turn. The agent reads the corpus exemplars and feedback intents (this tool
+// returns them when called with `mode='sample'`), composes the style-card YAML,
+// then calls this tool again with `mode='write'` + `styleCardYaml` set.
+/**
+ * Coerce a neo4j cypher RETURN value to a plain JS number.
+ *
+ * Neo4j-driver represents INTs as `Integer` objects (high/low 32-bit
+ * pair to safely carry int64). `Number()` *usually* works via valueOf()
+ * but the safe path is `Integer#toNumber()`. Returns null when the
+ * value is null/undefined so cadence-guard arithmetic stays explicit
+ * about the "no prior profile" case.
+ */
+function toJsNumber(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === "number")
+        return value;
+    if (neo4j.isInt(value))
+        return value.toNumber();
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+const SAMPLE_CHAR_CAP = 120_000;
+const RE_RUN_GROWTH_FRACTION = 0.2;
+const RE_RUN_AGE_DAYS = 30;
+// The agent produces a YAML style card with at minimum these keys:
+//   sentenceLengthDistribution, register, favoured, avoided, taboos,
+//   openingPattern, closingPattern, exemplarSentences
+// Exemplar sentences should be quoted verbatim from the returned corpus.
+export async function voiceDistilProfile(params) {
+    const { accountId, adminUserId, force = false } = params;
+    if (!accountId || !adminUserId) {
+        throw new Error("voice-distil-profile: accountId and adminUserId required");
+    }
+    const session = getSession();
+    const now = new Date();
+    const nowIso = now.toISOString();
+    try {
+        // 1. Read existing profile (if any) for cadence-guard comparison.
+        const existing = await session.run(`MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+       OPTIONAL MATCH (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile)
+       RETURN elementId(p) AS profileId, p.corpusSize AS corpusSize,
+              p.generatedAt AS generatedAt`, { accountId, adminUserId });
+        const existingRow = existing.records[0];
+        const prevProfileId = existingRow?.get("profileId") ?? null;
+        const prevCorpusSize = toJsNumber(existingRow?.get("corpusSize"));
+        const prevGeneratedAt = existingRow?.get("generatedAt") ?? null;
+        // 2. Count corpus. Filter matches human-only + human-led-agent-assisted
+        //    across the four primary content labels plus conversation-document
+        //    :Section chunks (chat archives — children of a :KnowledgeDocument
+        //    with `conversationIdentity` set). See VOICE_CORPUS_WHERE above.
+        const countResult = await session.run(`MATCH (n)
+       WHERE ${VOICE_CORPUS_WHERE}
+       RETURN count(n) AS c`, { accountId });
+        const corpusSize = toJsNumber(countResult.records[0]?.get("c")) ?? 0;
+        if (corpusSize === 0) {
+            process.stderr.write(`[voice-distil] adminUser=${adminUserId} skip reason=empty-corpus\n`);
+            return {
+                profileId: prevProfileId,
+                corpusSize: 0,
+                generatedAt: prevGeneratedAt,
+                feedbackEntries: 0,
+                skipped: true,
+                skipReason: "empty-corpus",
+            };
+        }
+        // 3. Cadence guard.
+        if (!force && prevProfileId && prevCorpusSize !== null && prevGeneratedAt) {
+            const ageMs = now.getTime() - new Date(prevGeneratedAt).getTime();
+            const ageDays = ageMs / (24 * 60 * 60 * 1000);
+            // prevCorpusSize is non-null here (the guard above checks). When it's
+            // zero we treat growth as infinite — first real corpus always triggers
+            // a re-run.
+            const growth = prevCorpusSize > 0
+                ? (corpusSize - prevCorpusSize) / prevCorpusSize
+                : 1;
+            const ageTrigger = ageDays >= RE_RUN_AGE_DAYS;
+            const growthTrigger = growth >= RE_RUN_GROWTH_FRACTION;
+            if (!ageTrigger && !growthTrigger) {
+                const reason = ageDays < 1 ? "recent" : "below-threshold";
+                process.stderr.write(`[voice-distil] adminUser=${adminUserId} skip reason=${reason} corpusSize=${corpusSize} prevCorpus=${prevCorpusSize} ageDays=${ageDays.toFixed(1)}\n`);
+                return {
+                    profileId: prevProfileId,
+                    corpusSize,
+                    generatedAt: prevGeneratedAt,
+                    feedbackEntries: 0,
+                    skipped: true,
+                    skipReason: reason,
+                };
+            }
+        }
+        // 4. Sample corpus bodies up to the char cap. Pick recent first.
+        //    Timestamp coalesces include `firstMessageAt` for conversation-document
+        //    :Section chunks so chat archives sort by when the conversation
+        //    actually happened.
+        const sampled = await session.run(`MATCH (n)
+       WHERE ${VOICE_CORPUS_WHERE}
+       WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
+       OPTIONAL MATCH (parent:KnowledgeDocument)-[:HAS_SECTION]->(n)
+       WHERE 'Section' IN labels(n) AND parent.conversationIdentity IS NOT NULL
+       RETURN elementId(n) AS id,
+              labels(n) AS labels,
+              coalesce(n.body, n.abstract, n.subject, n.title, n.summary, '') AS body,
+              parent.conversationIdentity IS NOT NULL AS isConversationChunk,
+              ts
+       ORDER BY ts IS NULL, ts DESC
+       LIMIT 500`, { accountId });
+        const samples = [];
+        let charBudget = SAMPLE_CHAR_CAP;
+        for (const r of sampled.records) {
+            const body = r.get("body") ?? "";
+            const labels = r.get("labels") ?? [];
+            // Conversation-document sections carry `:Section` only after the Task
+            // 324 collapse; surface "Conversation" via the parent's
+            // `conversationIdentity` so the LLM exemplar header still says "this
+            // is chat" rather than the bare base label.
+            const isConversationChunk = Boolean(r.get("isConversationChunk"));
+            const label = isConversationChunk
+                ? "Conversation"
+                : (labels.find((l) => ["KnowledgeDocument", "Message", "SocialPost"].includes(l)) ?? labels[0] ?? "Unknown");
+            if (body.length === 0)
+                continue;
+            const trimmed = body.length > charBudget ? body.slice(0, charBudget) : body;
+            samples.push({ id: r.get("id"), label, body: trimmed });
+            charBudget -= trimmed.length;
+            if (charBudget <= 0)
+                break;
+        }
+        // 5. Pull feedback intents from existing :VoiceEdit nodes for this operator.
+        const feedback = await session.run(`MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+       MATCH (e:VoiceEdit {adminUserId: $adminUserId, accountId: $accountId})
+       RETURN e.intent AS intent ORDER BY e.occurredAt DESC LIMIT 50`, { accountId, adminUserId });
+        const feedbackIntents = feedback.records
+            .map((r) => r.get("intent"))
+            .filter((x) => typeof x === "string" && x.length > 0);
+        // 6. Mode branch (Task 424).
+        //   - `sample` (default): return the exemplars + feedback intents to the
+        //     calling agent. The agent composes the YAML style card in its own
+        //     turn and re-invokes with mode='write'.
+        //   - `write`: persist the agent-produced style card.
+        const mode = params.mode ?? "sample";
+        if (mode === "sample") {
+            process.stderr.write(`[voice-distil] adminUser=${adminUserId} mode=sample corpusSize=${corpusSize} ` +
+                `exemplars=${samples.length} feedbackEntries=${feedbackIntents.length}\n`);
+            return {
+                profileId: prevProfileId,
+                corpusSize,
+                generatedAt: prevGeneratedAt,
+                feedbackEntries: feedbackIntents.length,
+                skipped: true,
+                skipReason: "missing-style-card",
+                exemplars: samples,
+                feedbackIntents,
+            };
+        }
+        const styleCardYaml = (params.styleCardYaml ?? "").trim();
+        if (!styleCardYaml) {
+            throw new Error("voice-distil-profile: mode='write' requires styleCardYaml (the YAML you composed from the sample-mode response).");
+        }
+        // 7. Write the :VoiceProfile node + LEARNED_FROM edges to every sampled node.
+        //
+        //    The :AdminUser must already exist (onboarding/auth is the only
+        //    legitimate origin for :AdminUser). MATCH not MERGE: a typo in
+        //    adminUserId, an env mismatch, or a dropped credential surfaces
+        //    here as a typed error rather than silently minting an orphan
+        //    AdminUser that bypasses the platform's label-origin protection.
+        const writeResult = await session.run(`MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+       MERGE (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile {accountId: $accountId, adminUserId: $adminUserId})
+         ON CREATE SET p.createdAt = $now
+       SET p.styleCard = $styleCard,
+           p.generatedAt = $now,
+           p.corpusSize = $corpusSize,
+           p.feedbackEntries = $feedbackEntries,
+           p.updatedAt = $now
+       WITH p
+       UNWIND $sampleIds AS sid
+       MATCH (s) WHERE elementId(s) = sid
+       MERGE (p)-[:LEARNED_FROM]->(s)
+       RETURN elementId(p) AS profileId`, {
+            accountId,
+            adminUserId,
+            styleCard: styleCardYaml,
+            now: nowIso,
+            corpusSize,
+            feedbackEntries: feedbackIntents.length,
+            sampleIds: samples.map((s) => s.id),
+        });
+        // MATCH-on-:AdminUser failure yields zero records. Throw the typed
+        // error here rather than returning a half-baked result.
+        if (writeResult.records.length === 0) {
+            throw new Error(`voice-mirror: :AdminUser {accountId='${accountId}', adminUserId='${adminUserId}'} not found. Onboarding must promote the operator to :AdminUser before distillation.`);
+        }
+        const profileId = writeResult.records[0].get("profileId");
+        process.stderr.write(`[voice-distil] adminUser=${adminUserId} mode=write corpusSize=${corpusSize} generatedAt=${nowIso} feedbackEntries=${feedbackIntents.length}\n`);
+        return {
+            profileId,
+            corpusSize,
+            generatedAt: nowIso,
+            feedbackEntries: feedbackIntents.length,
+            skipped: false,
+        };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=voice-distil-profile.js.map

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-distil-profile.js.map

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

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-record-feedback.d.ts

@@ -0,0 +1,26 @@
+export interface VoiceRecordFeedbackParams {
+    accountId: string;
+    adminUserId: string;
+    originalText: string;
+    editedText: string;
+    /**
+     * One sentence describing what changed and what voice preference it reveals.
+     * The calling agent summarises this from `originalText` vs `editedText` in
+     * its own turn before invoking the tool (Task 424). Examples: "shorter and
+     * dropped the apology", "switched to first person", "removed corporate
+     * sign-off", "added a specific date".
+     */
+    intent: string;
+    context?: {
+        skill?: string;
+        brief?: string;
+    };
+}
+export interface VoiceRecordFeedbackResult {
+    editId: string;
+    intent: string;
+    occurredAt: string;
+    hadProfile: boolean;
+}
+export declare function voiceRecordFeedback(params: VoiceRecordFeedbackParams): Promise<VoiceRecordFeedbackResult>;
+//# sourceMappingURL=voice-record-feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-record-feedback.d.ts","sourceRoot":"","sources":["../../src/tools/voice-record-feedback.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAoEpC"}

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-record-feedback.js

@@ -0,0 +1,74 @@
+/**
+ * voice-record-feedback — capture an operator's edit on an agent draft
+ * as feedback for the next distillation.
+ *
+ * Task 424: the Haiku diff-intent summarisation moved into the calling
+ * agent's turn. The agent compares `originalText` to `editedText` itself
+ * and passes the resulting `intent` string as a required parameter. The
+ * tool now does the graph writes only.
+ *
+ * Side effects:
+ *   1. Write `(:VoiceEdit)-[:FEEDBACK_FOR]->(:VoiceProfile)` if the profile
+ *      exists; otherwise write the :VoiceEdit alone so the next distillation
+ *      back-fills the edge.
+ */
+import { randomUUID } from "node:crypto";
+import { getSession } from "../lib/neo4j.js";
+export async function voiceRecordFeedback(params) {
+    const { accountId, adminUserId, originalText, editedText, intent: rawIntent, context } = params;
+    if (!accountId || !adminUserId) {
+        throw new Error("voice-record-feedback: accountId and adminUserId required");
+    }
+    if (!originalText || !editedText) {
+        throw new Error("voice-record-feedback: originalText and editedText required");
+    }
+    const intent = (rawIntent ?? "").trim();
+    if (!intent) {
+        throw new Error("voice-record-feedback: intent is required — summarise what the operator changed in-turn before calling this tool (Task 424).");
+    }
+    const editId = randomUUID();
+    const occurredAt = new Date().toISOString();
+    const cappedIntent = intent.slice(0, 500);
+    const session = getSession();
+    try {
+        const result = await session.run(`MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+       CREATE (e:VoiceEdit {
+         editId: $editId,
+         accountId: $accountId,
+         adminUserId: $adminUserId,
+         originalText: $originalText,
+         editedText: $editedText,
+         intent: $intent,
+         occurredAt: $occurredAt,
+         skill: $skill,
+         brief: $brief
+       })
+       CREATE (a)-[:AUTHORED]->(e)
+       WITH e
+       OPTIONAL MATCH (:AdminUser {accountId: $accountId, adminUserId: $adminUserId})-[:HAS_VOICE_PROFILE]->(p:VoiceProfile)
+       FOREACH (_ IN CASE WHEN p IS NULL THEN [] ELSE [1] END |
+         MERGE (e)-[:FEEDBACK_FOR]->(p)
+       )
+       RETURN elementId(e) AS editId, (p IS NOT NULL) AS hadProfile`, {
+            accountId,
+            adminUserId,
+            editId,
+            originalText,
+            editedText,
+            intent: cappedIntent,
+            occurredAt,
+            skill: context?.skill ?? null,
+            brief: context?.brief ?? null,
+        });
+        if (result.records.length === 0) {
+            throw new Error(`voice-mirror: :AdminUser {accountId='${accountId}', adminUserId='${adminUserId}'} not found. Onboarding must promote the operator to :AdminUser before feedback can be recorded.`);
+        }
+        const hadProfile = result.records[0].get("hadProfile") === true;
+        process.stderr.write(`[voice-record-feedback] adminUser=${adminUserId} intent="${cappedIntent.replace(/"/g, "'")}" diffBytes=${editedText.length - originalText.length}\n`);
+        return { editId, intent: cappedIntent, occurredAt, hadProfile };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=voice-record-feedback.js.map

package/payload/premium-plugins/writer-craft/mcp/dist/tools/voice-record-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-record-feedback.js","sourceRoot":"","sources":["../../src/tools/voice-record-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA4B7C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiC;IAEjC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAChG,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,8HAA8H,CAC/H,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B;;;;;;;;;;;;;;;;;;oEAkB8D,EAC9D;YACE,SAAS;YACT,WAAW;YACX,MAAM;YACN,YAAY;YACZ,UAAU;YACV,MAAM,EAAE,YAAY;YACpB,UAAU;YACV,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;YAC7B,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;SAC9B,CACF,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,wCAAwC,SAAS,mBAAmB,WAAW,mGAAmG,CACnL,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;QAEhE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qCAAqC,WAAW,YAAY,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,eAAe,UAAU,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,CACtJ,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IAClE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,22 @@
+export interface VoiceRetrieveConditioningParams {
+    accountId: string;
+    adminUserId: string;
+    brief: {
+        topic?: string;
+        format: "short" | "long";
+        register?: string;
+    };
+    tokenBudget?: number;
+}
+export interface VoiceExemplar {
+    nodeId: string;
+    label: string;
+    body: string;
+    source: string;
+}
+export interface VoiceRetrieveConditioningResult {
+    styleCard: string | null;
+    exemplars: VoiceExemplar[];
+}
+export declare function voiceRetrieveConditioning(params: VoiceRetrieveConditioningParams): Promise<VoiceRetrieveConditioningResult>;
+//# sourceMappingURL=voice-retrieve-conditioning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-retrieve-conditioning.d.ts","sourceRoot":"","sources":["../../src/tools/voice-retrieve-conditioning.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAID,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,+BAA+B,CAAC,CA2F1C"}

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

@@ -0,0 +1,102 @@
+/**
+ * voice-retrieve-conditioning — return the operator's style card plus K
+ * voice-matched exemplars for a drafting brief.
+ *
+ * Retrieval order (best to worst):
+ *   1. If brief.topic is provided AND keyword search on the human-only corpus
+ *      returns ≥K matches → use those (ordered by recency).
+ *   2. Otherwise, return the K most-recent human-only nodes.
+ *
+ * Embeddings are not used in v1: the corpus is small (single operator's
+ * personal writing — typically <500 docs), and recency-with-keyword-filter
+ * is both faster and more predictable than vector ANN at that scale.
+ * Vector-search is a Task 365-follow-up if the corpus grows beyond the
+ * 500-doc breakeven point.
+ *
+ * Graceful degradation: missing profile, empty corpus, and DB errors all
+ * return `{styleCard: null, exemplars: []}` rather than throwing — the
+ * calling drafting skill falls back to its existing default register.
+ */
+import { getSession } from "../lib/neo4j.js";
+import { VOICE_CORPUS_WHERE } from "../lib/voice-corpus.js";
+const DEFAULT_TOKEN_BUDGET_SHORT = 16_000;
+const DEFAULT_TOKEN_BUDGET_LONG = 96_000;
+const CHARS_PER_TOKEN = 4;
+const EMPTY = { styleCard: null, exemplars: [] };
+export async function voiceRetrieveConditioning(params) {
+    const { accountId, adminUserId, brief } = params;
+    if (!accountId || !adminUserId)
+        return EMPTY;
+    const k = brief.format === "long" ? 15 : 5;
+    const tokenBudget = params.tokenBudget ??
+        (brief.format === "long" ? DEFAULT_TOKEN_BUDGET_LONG : DEFAULT_TOKEN_BUDGET_SHORT);
+    const charBudget = tokenBudget * CHARS_PER_TOKEN;
+    const session = getSession();
+    try {
+        // 1. Style card.
+        const profile = await session.run(`MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+       OPTIONAL MATCH (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile)
+       RETURN p.styleCard AS styleCard`, { accountId, adminUserId });
+        const styleCard = profile.records[0]?.get("styleCard") ?? null;
+        // 2. Exemplars. Keyword-aware filter when brief.topic is set.
+        const topic = (brief.topic ?? "").trim();
+        const usesTopic = topic.length > 0;
+        const cypher = usesTopic
+            ? `MATCH (n)
+         WHERE ${VOICE_CORPUS_WHERE}
+           AND toLower(coalesce(n.body, n.abstract, n.subject, n.title, n.summary, '')) CONTAINS toLower($topic)
+         WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
+         RETURN elementId(n) AS id,
+                labels(n) AS labels,
+                coalesce(n.body, n.abstract, n.subject, n.title, n.summary, '') AS body,
+                coalesce(n.subject, n.title, n.name, '') AS source,
+                ts
+         ORDER BY ts IS NULL, ts DESC
+         LIMIT $k`
+            : `MATCH (n)
+         WHERE ${VOICE_CORPUS_WHERE}
+         WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
+         RETURN elementId(n) AS id,
+                labels(n) AS labels,
+                coalesce(n.body, n.abstract, n.subject, n.title, n.summary, '') AS 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,
+            topic,
+            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),
+            });
+            charsUsed += truncated.length;
+        }
+        process.stderr.write(`[voice-retrieve] task=${brief.topic ?? brief.format} styleCardBytes=${styleCard?.length ?? 0} exemplarCount=${exemplars.length} tokenBudget=${tokenBudget}\n`);
+        return { styleCard, exemplars };
+    }
+    catch (err) {
+        process.stderr.write(`[voice-retrieve] error: ${err instanceof Error ? err.message : String(err)}\n`);
+        return EMPTY;
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=voice-retrieve-conditioning.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-retrieve-conditioning.js","sourceRoot":"","sources":["../../src/tools/voice-retrieve-conditioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,yBAAyB,GAAG,MAAM,CAAC;AACzC,MAAM,eAAe,GAAG,CAAC,CAAC;AAyB1B,MAAM,KAAK,GAAoC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAElF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAuC;IAEvC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACjD,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,WAAW,GACf,MAAM,CAAC,WAAW;QAClB,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,WAAW,GAAG,eAAe,CAAC;IAEjD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,iBAAiB;QACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B;;uCAEiC,EACjC,EAAE,SAAS,EAAE,WAAW,EAAE,CAC3B,CAAC;QACF,MAAM,SAAS,GAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,CAAmB,IAAI,IAAI,CAAC;QAElF,8DAA8D;QAC9D,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG,SAAS;YACtB,CAAC,CAAC;iBACS,kBAAkB;;;;;;;;;kBASjB;YACZ,CAAC,CAAC;iBACS,kBAAkB;;;;;;;;kBAQjB,CAAC;QAEf,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;YACvC,SAAS;YACT,KAAK;YACL,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAmB,IAAI,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAChC,MAAM,MAAM,GAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAc,IAAI,EAAE,CAAC;YACnD,MAAM,KAAK,GACT,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAChB,CAAC,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC3E,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;YAC9B,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;YACzC,IAAI,SAAS,IAAI,CAAC;gBAAE,MAAM;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5E,SAAS,CAAC,IAAI,CAAC;gBACb,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAW;gBAC7B,KAAK;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,CAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAmB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aACjE,CAAC,CAAC;YACH,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC;QAChC,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yBAAyB,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,mBAClD,SAAS,EAAE,MAAM,IAAI,CACvB,kBAAkB,SAAS,CAAC,MAAM,gBAAgB,WAAW,IAAI,CAClE,CAAC;QAEF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChF,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,14 @@
+export type AuthorshipMode = "human-only" | "human-led-agent-assisted" | "agent-led-human-reviewed" | "agent-only" | "unknown";
+export declare const AUTHORSHIP_MODES: ReadonlySet<AuthorshipMode>;
+export interface VoiceTagContentParams {
+    nodeIds: string[];
+    mode: AuthorshipMode;
+    accountId: string;
+}
+export interface VoiceTagContentResult {
+    updated: number;
+    skipped: number;
+    skippedReasons: Record<string, number>;
+}
+export declare function voiceTagContent(params: VoiceTagContentParams): Promise<VoiceTagContentResult>;
+//# sourceMappingURL=voice-tag-content.d.ts.map

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

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

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

@@ -0,0 +1,84 @@
+/**
+ * voice-tag-content — set `authorshipMode` on one or many content nodes.
+ *
+ * The tool routes through neo4j directly with an account-scoped MERGE so
+ * the operator can only mutate their own nodes. We do not go through
+ * `memory-update` because that tool re-embeds and re-validates on every
+ * call — overkill for a single-property authorship stamp.
+ */
+import { getSession } from "../lib/neo4j.js";
+import { TAGGABLE_PRIMARY_LABELS } from "../lib/voice-corpus.js";
+export const AUTHORSHIP_MODES = new Set([
+    "human-only",
+    "human-led-agent-assisted",
+    "agent-led-human-reviewed",
+    "agent-only",
+    "unknown",
+]);
+export async function voiceTagContent(params) {
+    const { nodeIds, mode, accountId } = params;
+    if (!AUTHORSHIP_MODES.has(mode)) {
+        throw new Error(`voice-tag-content: invalid authorshipMode '${mode}'. Valid values: ${[
+            ...AUTHORSHIP_MODES,
+        ].join(", ")}`);
+    }
+    if (!accountId) {
+        throw new Error("voice-tag-content: accountId is required");
+    }
+    if (!Array.isArray(nodeIds) || nodeIds.length === 0) {
+        return { updated: 0, skipped: 0, skippedReasons: {} };
+    }
+    const session = getSession();
+    const now = new Date().toISOString();
+    const skippedReasons = {};
+    let updated = 0;
+    try {
+        // Bulk update in batches of 50 to keep transaction latency bounded.
+        const BATCH = 50;
+        for (let i = 0; i < nodeIds.length; i += BATCH) {
+            const batch = nodeIds.slice(i, i + BATCH);
+            const result = await session.run(
+            // Tag any of the four primary content labels, or a conversation-
+            // document :Section chunk (parent :KnowledgeDocument carries
+            // `conversationIdentity`). The EXISTS sub-pattern guards against
+            // accidentally tagging document-path :Section rows AND parent
+            // `:Conversation` / `:AdminConversation` nodes (which are not
+            // body-bearing content).
+            `UNWIND $ids AS id
+         MATCH (n) WHERE elementId(n) = id AND n.accountId = $accountId
+         WITH n
+         WHERE any(lbl IN labels(n) WHERE lbl IN $primaryLabels)
+            OR ('Section' IN labels(n) AND EXISTS {
+                 MATCH (parent:KnowledgeDocument)-[:HAS_SECTION]->(n)
+                 WHERE parent.conversationIdentity IS NOT NULL
+               })
+         SET n.authorshipMode = $mode,
+             n.authorshipTaggedAt = $now
+         RETURN elementId(n) AS id`, {
+                ids: batch,
+                accountId,
+                mode,
+                now,
+                primaryLabels: [...TAGGABLE_PRIMARY_LABELS],
+            });
+            const matched = new Set(result.records.map((r) => r.get("id")));
+            updated += matched.size;
+            for (const id of batch) {
+                if (matched.has(id))
+                    continue;
+                const reason = "not-found-or-not-content-label";
+                skippedReasons[reason] = (skippedReasons[reason] ?? 0) + 1;
+            }
+        }
+    }
+    finally {
+        await session.close();
+    }
+    process.stderr.write(`[voice-tag] mode=${mode} accountId=${accountId} updated=${updated} skipped=${nodeIds.length - updated}\n`);
+    return {
+        updated,
+        skipped: nodeIds.length - updated,
+        skippedReasons,
+    };
+}
+//# sourceMappingURL=voice-tag-content.js.map

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

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