@rubytech/create-maxy-code 0.1.171 → 0.1.174

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

@@ -19,9 +19,9 @@ const server = new McpServer({
 // refusal preserves account isolation. Mirrors the memory plugin's
 // pattern (Task 202).
 const accountId = process.env.ACCOUNT_ID ?? null;
-const adminUserIdEnv = process.env.ADMIN_USER_ID ?? null;
+const userIdEnv = process.env.ADMIN_USER_ID ?? null;
 process.stderr.write(
-  `[writer-craft] boot accountId=${accountId ?? "null"} adminUserId=${adminUserIdEnv ?? "null"}\n`,
+  `[writer-craft] boot accountId=${accountId ?? "null"} userId=${userIdEnv ?? "null"}\n`,
 );
 
 function refuseNoAccount(toolName: string) {
@@ -39,11 +39,11 @@ function refuseNoAccount(toolName: string) {
   };
 }
 
-function resolveAdminUserId(): string | null {
+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 adminUserIdEnv;
+  return userIdEnv;
 }
 
 server.tool(
@@ -95,7 +95,7 @@ server.tool(
   "voice-distil-profile",
   "Two-mode tool (Task 424). mode='sample' (default) walks the operator's human-only corpus, returns the exemplars + recent operator-edit intents for the agent to read. mode='write' persists the YAML style card the agent composed from the sample-mode response. Cadence-guarded: returns skip in 'write' mode without writing if corpus didn't grow ≥20% AND <30 days passed (pass force=true to override).",
   {
-    adminUserId: z
+    userId: z
       .string()
       .optional()
       .describe(
@@ -114,16 +114,16 @@ server.tool(
       .optional()
       .describe("Required for mode='write'. The YAML style card the agent composed from the sample-mode exemplars + feedback intents."),
   },
-  async ({ adminUserId, force, mode, styleCardYaml }) => {
+  async ({ userId, force, mode, styleCardYaml }) => {
     if (!accountId) return refuseNoAccount("voice-distil-profile");
-    const resolvedAdminUserId = adminUserId ?? resolveAdminUserId();
-    if (!resolvedAdminUserId) {
+    const resolvedUserId = userId ?? resolveUserId();
+    if (!resolvedUserId) {
       return {
         content: [
           {
             type: "text" as const,
             text:
-              "voice-distil-profile: adminUserId required (no ADMIN_USER_ID in spawn env).",
+              "voice-distil-profile: userId required (no ADMIN_USER_ID in spawn env).",
           },
         ],
         isError: true,
@@ -132,7 +132,7 @@ server.tool(
     try {
       const result = await voiceDistilProfile({
         accountId,
-        adminUserId: resolvedAdminUserId,
+        userId: resolvedUserId,
         force: force === true,
         mode,
         styleCardYaml,
@@ -161,7 +161,7 @@ server.tool(
   "voice-retrieve-conditioning",
   "Return the operator's style card and K voice-matched exemplars for a drafting brief. K=5 short-form, K=15 long-form. Token-budget bounded. Returns empty {styleCard:null,exemplars:[]} when no profile exists.",
   {
-    adminUserId: z
+    userId: z
       .string()
       .optional()
       .describe("Operator AdminUser identifier. Defaults to ADMIN_USER_ID env."),
@@ -175,10 +175,10 @@ server.tool(
     register: z.string().optional().describe("Optional register hint"),
     tokenBudget: z.number().int().positive().optional(),
   },
-  async ({ adminUserId, topic, format, register, tokenBudget }) => {
+  async ({ userId, topic, format, register, tokenBudget }) => {
     if (!accountId) return refuseNoAccount("voice-retrieve-conditioning");
-    const resolvedAdminUserId = adminUserId ?? resolveAdminUserId();
-    if (!resolvedAdminUserId) {
+    const resolvedUserId = userId ?? resolveUserId();
+    if (!resolvedUserId) {
       return {
         content: [
           {
@@ -191,7 +191,7 @@ server.tool(
     try {
       const result = await voiceRetrieveConditioning({
         accountId,
-        adminUserId: resolvedAdminUserId,
+        userId: resolvedUserId,
         brief: { topic, format, register },
         tokenBudget,
       });
@@ -222,7 +222,7 @@ server.tool(
   "voice-record-feedback",
   "Capture an operator's edit on an agent draft. Writes :VoiceEdit linked to :VoiceProfile via :FEEDBACK_FOR. The calling agent supplies `intent` (one sentence describing what the operator changed and what voice preference it reveals); Task 424 moved the diff-intent summarisation into the agent's turn.",
   {
-    adminUserId: z.string().optional(),
+    userId: z.string().optional(),
     originalText: z.string().min(1),
     editedText: z.string().min(1),
     intent: z
@@ -232,15 +232,15 @@ server.tool(
     skill: z.string().optional().describe("Calling skill name, for provenance"),
     brief: z.string().optional().describe("Drafting brief that produced the original"),
   },
-  async ({ adminUserId, originalText, editedText, intent, skill, brief }) => {
+  async ({ userId, originalText, editedText, intent, skill, brief }) => {
     if (!accountId) return refuseNoAccount("voice-record-feedback");
-    const resolvedAdminUserId = adminUserId ?? resolveAdminUserId();
-    if (!resolvedAdminUserId) {
+    const resolvedUserId = userId ?? resolveUserId();
+    if (!resolvedUserId) {
       return {
         content: [
           {
             type: "text" as const,
-            text: "voice-record-feedback: adminUserId required (no ADMIN_USER_ID in spawn env).",
+            text: "voice-record-feedback: userId required (no ADMIN_USER_ID in spawn env).",
           },
         ],
         isError: true,
@@ -249,7 +249,7 @@ server.tool(
     try {
       const result = await voiceRecordFeedback({
         accountId,
-        adminUserId: resolvedAdminUserId,
+        userId: resolvedUserId,
         originalText,
         editedText,
         intent,

package/payload/premium-plugins/writer-craft/mcp/src/tools/voice-distil-profile.ts

@@ -44,7 +44,7 @@ const RE_RUN_AGE_DAYS = 30;
 
 export interface VoiceDistilProfileParams {
   accountId: string;
-  adminUserId: string;
+  userId: string;
   force?: boolean;
   /**
    * Operation mode (Task 424):
@@ -87,9 +87,9 @@ export interface VoiceDistilProfileResult {
 export async function voiceDistilProfile(
   params: VoiceDistilProfileParams,
 ): Promise<VoiceDistilProfileResult> {
-  const { accountId, adminUserId, force = false } = params;
-  if (!accountId || !adminUserId) {
-    throw new Error("voice-distil-profile: accountId and adminUserId required");
+  const { accountId, userId, force = false } = params;
+  if (!accountId || !userId) {
+    throw new Error("voice-distil-profile: accountId and userId required");
   }
   const session = getSession();
   const now = new Date();
@@ -98,11 +98,11 @@ export async function voiceDistilProfile(
   try {
     // 1. Read existing profile (if any) for cadence-guard comparison.
     const existing = await session.run(
-      `MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+      `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
        OPTIONAL MATCH (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile)
        RETURN elementId(p) AS profileId, p.corpusSize AS corpusSize,
               p.generatedAt AS generatedAt`,
-      { accountId, adminUserId },
+      { accountId, userId },
     );
     const existingRow = existing.records[0];
     const prevProfileId = (existingRow?.get("profileId") as string | null) ?? null;
@@ -123,7 +123,7 @@ export async function voiceDistilProfile(
 
     if (corpusSize === 0) {
       process.stderr.write(
-        `[voice-distil] adminUser=${adminUserId} skip reason=empty-corpus\n`,
+        `[voice-distil] adminUser=${userId} skip reason=empty-corpus\n`,
       );
       return {
         profileId: prevProfileId,
@@ -151,7 +151,7 @@ export async function voiceDistilProfile(
       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`,
+          `[voice-distil] adminUser=${userId} skip reason=${reason} corpusSize=${corpusSize} prevCorpus=${prevCorpusSize} ageDays=${ageDays.toFixed(1)}\n`,
         );
         return {
           profileId: prevProfileId,
@@ -179,7 +179,7 @@ export async function voiceDistilProfile(
               coalesce(n.body, n.abstract, n.subject, n.title, n.summary, '') AS body,
               parent.conversationIdentity IS NOT NULL AS isConversationChunk,
               ts
-       ORDER BY ts DESC NULLS LAST
+       ORDER BY ts IS NULL, ts DESC
        LIMIT 500`,
       { accountId },
     );
@@ -207,10 +207,10 @@ export async function voiceDistilProfile(
 
     // 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})
+      `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
+       MATCH (e:VoiceEdit {userId: $userId, accountId: $accountId})
        RETURN e.intent AS intent ORDER BY e.occurredAt DESC LIMIT 50`,
-      { accountId, adminUserId },
+      { accountId, userId },
     );
     const feedbackIntents = feedback.records
       .map((r) => r.get("intent") as string | null)
@@ -224,7 +224,7 @@ export async function voiceDistilProfile(
     const mode = params.mode ?? "sample";
     if (mode === "sample") {
       process.stderr.write(
-        `[voice-distil] adminUser=${adminUserId} mode=sample corpusSize=${corpusSize} ` +
+        `[voice-distil] adminUser=${userId} mode=sample corpusSize=${corpusSize} ` +
           `exemplars=${samples.length} feedbackEntries=${feedbackIntents.length}\n`,
       );
       return {
@@ -250,12 +250,12 @@ export async function voiceDistilProfile(
     //
     //    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
+    //    userId, 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})
+      `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
+       MERGE (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile {accountId: $accountId, userId: $userId})
          ON CREATE SET p.createdAt = $now
        SET p.styleCard = $styleCard,
            p.generatedAt = $now,
@@ -269,7 +269,7 @@ export async function voiceDistilProfile(
        RETURN elementId(p) AS profileId`,
       {
         accountId,
-        adminUserId,
+        userId,
         styleCard: styleCardYaml,
         now: nowIso,
         corpusSize,
@@ -281,13 +281,13 @@ export async function voiceDistilProfile(
     // 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.`,
+        `voice-mirror: :AdminUser {accountId='${accountId}', userId='${userId}'} not found. Onboarding must promote the operator to :AdminUser before distillation.`,
       );
     }
     const profileId = writeResult.records[0].get("profileId") as string;
 
     process.stderr.write(
-      `[voice-distil] adminUser=${adminUserId} mode=write corpusSize=${corpusSize} generatedAt=${nowIso} feedbackEntries=${feedbackIntents.length}\n`,
+      `[voice-distil] adminUser=${userId} mode=write corpusSize=${corpusSize} generatedAt=${nowIso} feedbackEntries=${feedbackIntents.length}\n`,
     );
 
     return {

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

@@ -17,7 +17,7 @@ import { getSession } from "../lib/neo4j.js";
 
 export interface VoiceRecordFeedbackParams {
   accountId: string;
-  adminUserId: string;
+  userId: string;
   originalText: string;
   editedText: string;
   /**
@@ -44,9 +44,9 @@ export interface VoiceRecordFeedbackResult {
 export async function voiceRecordFeedback(
   params: VoiceRecordFeedbackParams,
 ): Promise<VoiceRecordFeedbackResult> {
-  const { accountId, adminUserId, originalText, editedText, intent: rawIntent, context } = params;
-  if (!accountId || !adminUserId) {
-    throw new Error("voice-record-feedback: accountId and adminUserId required");
+  const { accountId, userId, originalText, editedText, intent: rawIntent, context } = params;
+  if (!accountId || !userId) {
+    throw new Error("voice-record-feedback: accountId and userId required");
   }
   if (!originalText || !editedText) {
     throw new Error("voice-record-feedback: originalText and editedText required");
@@ -65,11 +65,11 @@ export async function voiceRecordFeedback(
   const session = getSession();
   try {
     const result = await session.run(
-      `MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+      `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
        CREATE (e:VoiceEdit {
          editId: $editId,
          accountId: $accountId,
-         adminUserId: $adminUserId,
+         userId: $userId,
          originalText: $originalText,
          editedText: $editedText,
          intent: $intent,
@@ -79,14 +79,14 @@ export async function voiceRecordFeedback(
        })
        CREATE (a)-[:AUTHORED]->(e)
        WITH e
-       OPTIONAL MATCH (:AdminUser {accountId: $accountId, adminUserId: $adminUserId})-[:HAS_VOICE_PROFILE]->(p:VoiceProfile)
+       OPTIONAL MATCH (:AdminUser {accountId: $accountId, userId: $userId})-[: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,
+        userId,
         editId,
         originalText,
         editedText,
@@ -98,13 +98,13 @@ export async function voiceRecordFeedback(
     );
     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.`,
+        `voice-mirror: :AdminUser {accountId='${accountId}', userId='${userId}'} 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`,
+      `[voice-record-feedback] adminUser=${userId} intent="${cappedIntent.replace(/"/g, "'")}" diffBytes=${editedText.length - originalText.length}\n`,
     );
 
     return { editId, intent: cappedIntent, occurredAt, hadProfile };

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

@@ -26,7 +26,7 @@ const CHARS_PER_TOKEN = 4;
 
 export interface VoiceRetrieveConditioningParams {
   accountId: string;
-  adminUserId: string;
+  userId: string;
   brief: {
     topic?: string;
     format: "short" | "long";
@@ -52,8 +52,8 @@ const EMPTY: VoiceRetrieveConditioningResult = { styleCard: null, exemplars: []
 export async function voiceRetrieveConditioning(
   params: VoiceRetrieveConditioningParams,
 ): Promise<VoiceRetrieveConditioningResult> {
-  const { accountId, adminUserId, brief } = params;
-  if (!accountId || !adminUserId) return EMPTY;
+  const { accountId, userId, brief } = params;
+  if (!accountId || !userId) return EMPTY;
 
   const k = brief.format === "long" ? 15 : 5;
   const tokenBudget =
@@ -65,10 +65,10 @@ export async function voiceRetrieveConditioning(
   try {
     // 1. Style card.
     const profile = await session.run(
-      `MATCH (a:AdminUser {accountId: $accountId, adminUserId: $adminUserId})
+      `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
        OPTIONAL MATCH (a)-[:HAS_VOICE_PROFILE]->(p:VoiceProfile)
        RETURN p.styleCard AS styleCard`,
-      { accountId, adminUserId },
+      { accountId, userId },
     );
     const styleCard = (profile.records[0]?.get("styleCard") as string | null) ?? null;
 
@@ -86,7 +86,7 @@ export async function voiceRetrieveConditioning(
                 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
+         ORDER BY ts IS NULL, ts DESC
          LIMIT $k`
       : `MATCH (n)
          WHERE ${VOICE_CORPUS_WHERE}
@@ -96,7 +96,7 @@ export async function voiceRetrieveConditioning(
                 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
+         ORDER BY ts IS NULL, ts DESC
          LIMIT $k`;
 
     const result = await session.run(cypher, {