@rubytech/create-maxy-code 0.1.170 → 0.1.171

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 DESC NULLS LAST
+         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 DESC NULLS LAST
+         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":"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"}

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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"}