@rubytech/create-maxy-code 0.1.446 → 0.1.448

package/payload/premium-plugins/writer-craft/mcp/src/tools/voice-ingest-session-text.ts

@@ -1,153 +0,0 @@
-/**
- * voice-ingest-session-text — write operator turns the agent read from its
- * own session context as :Message {format:'text', source:'admin-pty'} corpus
- * nodes.
- *
- * Invoked on demand by the voice-mirror skill (Task 644): the operator asks to
- * capture this session's voice, the admin agent extracts its own operator
- * turns from the live conversation context, and passes them here as `turns`.
- * Re-running with the same turns is a no-op — MERGE on (contentHash, accountId)
- * is the deduplication primitive.
- *
- * After ingest, triggers voice-distil-profile {format:'text'} so the cadence
- * guard decides whether distillation runs.
- *
- * "Real operator text" filter (each supplied turn is excluded when):
- *   - text is empty after trimming                      → nothing to ingest
- *   - text starts with "/"                              → slash command
- *   - text contains "<system-reminder>"                 → harness injection
- *   - text.length >= 4096                              → likely pasted content
- */
-import { createHash } from "node:crypto";
-import { getSession } from "../lib/neo4j.js";
-import { voiceDistilProfile } from "./voice-distil-profile.js";
-
-export interface VoiceIngestSessionTextParams {
-  turns: string[];
-  accountId: string;
-  userId: string;
-  sessionId?: string;
-}
-
-export interface VoiceIngestSessionTextResult {
-  ingestedCount: number;
-  skippedCount: number;
-  sessionId: string | null;
-}
-
-/**
- * Applies the "real operator text" exclusions to a single supplied turn.
- * Returns the trimmed text to ingest, or null when the turn should be skipped.
- * Exported for testability (no DB required).
- */
-export function filterOperatorText(text: unknown): string | null {
-  if (typeof text !== "string") return null;
-  const trimmed = text.trim();
-  if (trimmed.length === 0) return null;
-  if (trimmed.startsWith("/")) return null; // slash command
-  if (trimmed.includes("<system-reminder>")) return null; // harness injection
-  if (trimmed.length >= 4096) return null; // paste block
-  return trimmed;
-}
-
-export async function voiceIngestSessionText(
-  params: VoiceIngestSessionTextParams,
-): Promise<VoiceIngestSessionTextResult> {
-  const { turns, accountId, userId, sessionId = null } = params;
-
-  if (!accountId || !userId) {
-    throw new Error("voice-ingest-session-text: accountId and userId required");
-  }
-  if (!Array.isArray(turns)) {
-    throw new Error("voice-ingest-session-text: turns array required");
-  }
-
-  // 1. Apply the operator-text filter to each supplied turn.
-  const allTurns: string[] = [];
-  for (const turn of turns) {
-    const text = filterOperatorText(turn);
-    if (text !== null) allTurns.push(text);
-  }
-
-  if (allTurns.length === 0) {
-    process.stderr.write(
-      `[voice-ingest-session-text] sessionId=${sessionId ?? "unknown"} adminUser=${userId} turns=0 bytes=0\n`,
-    );
-    return { ingestedCount: 0, skippedCount: 0, sessionId };
-  }
-
-  // 2. Write each turn as a :Message node. MERGE on contentHash+accountId dedupes.
-  const session = getSession();
-  const now = new Date().toISOString();
-  let ingestedCount = 0;
-  let skippedCount = 0;
-  let totalBytes = 0;
-
-  try {
-    for (const body of allTurns) {
-      const contentHash = createHash("sha256")
-        .update(body, "utf-8")
-        .digest("hex");
-
-      const result = await session.run(
-        `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
-         MERGE (n:Message {contentHash: $contentHash, accountId: $accountId})
-         ON CREATE SET
-           n.userId = $userId,
-           n.voiceAuthor = $userId,
-           n.body = $body,
-           n.occurredAt = $now,
-           n.sessionId = $sessionId,
-           n.source = 'admin-pty',
-           n.authorshipMode = 'human-only',
-           n.format = 'text',
-           n.createdAt = $now
-         MERGE (a)-[:AUTHORED]->(n)
-         RETURN n.createdAt = $now AS isNew`,
-        {
-          accountId,
-          userId,
-          contentHash,
-          body,
-          now,
-          sessionId,
-        },
-      );
-
-      if (result.records.length === 0) {
-        // :AdminUser not found — abort rather than orphan nodes.
-        throw new Error(
-          `voice-ingest-session-text: :AdminUser {accountId='${accountId}', userId='${userId}'} not found. Onboarding must promote the operator to :AdminUser before ingest.`,
-        );
-      }
-
-      const isNew = result.records[0].get("isNew") === true;
-      if (isNew) {
-        ingestedCount++;
-        totalBytes += body.length;
-      } else {
-        skippedCount++;
-      }
-    }
-  } finally {
-    await session.close();
-  }
-
-  process.stderr.write(
-    `[voice-ingest-session-text] sessionId=${sessionId ?? "unknown"} adminUser=${userId} turns=${ingestedCount} bytes=${totalBytes} skipped=${skippedCount}\n`,
-  );
-
-  // 3. Trigger text-format distillation (cadence guard decides whether to run).
-  if (ingestedCount > 0) {
-    try {
-      await voiceDistilProfile({ accountId, userId, format: "text" });
-    } catch (err) {
-      // Distil failure must not fail the ingest.
-      process.stderr.write(
-        `[voice-ingest-session-text] distil-after-ingest error: ${err instanceof Error ? err.message : String(err)}\n`,
-      );
-    }
-  }
-
-  return { ingestedCount, skippedCount, sessionId };
-}

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

@@ -1,148 +0,0 @@
-/**
- * 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.
- *
- * Task 462: `format` is required. `:VoiceEdit` carries the format; the
- * `FEEDBACK_FOR` edge targets the per-format `:VoiceProfile`.
- *
- * Side effects:
- *   1. Write `(:VoiceEdit)-[:FEEDBACK_FOR]->(:VoiceProfile {format})` if the
- *      per-format 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";
-import {
-  profileUserIdForScope,
-  type VoiceFormat,
-  type VoiceScope,
-} from "../lib/voice-corpus.js";
-
-export interface VoiceRecordFeedbackParams {
-  accountId: string;
-  userId: string;
-  originalText: string;
-  editedText: string;
-  /**
-   * Writing format of the draft being edited. Routes feedback to the
-   * matching per-format :VoiceProfile.
-   */
-  format: VoiceFormat;
-  /**
-   * Scope of the edited draft (Task 676). `'org'` routes the edit to the
-   * account/house profile (`userId='__org__'`); `'personal'` (default) routes
-   * to the operator's own profile.
-   */
-  scope?: VoiceScope;
-  /**
-   * 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 async function voiceRecordFeedback(
-  params: VoiceRecordFeedbackParams,
-): Promise<VoiceRecordFeedbackResult> {
-  const { accountId, userId, originalText, editedText, format, intent: rawIntent, context } = params;
-  const scope: VoiceScope = params.scope ?? "personal";
-  const profileUserId = profileUserIdForScope(scope, userId);
-  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");
-  }
-  if (!format) {
-    throw new Error("voice-record-feedback: format is 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 {
-    // The :VoiceEdit carries the profile-key userId ($profileUserId — the
-    // sentinel for org) plus `scope`, so distillation's feedback query (keyed by
-    // profileUserId) reads org edits for the org profile and personal edits for
-    // the operator. The real editor is preserved via the AUTHORED edge from
-    // their :AdminUser. FEEDBACK_FOR targets the scoped profile (Task 676).
-    const result = await session.run(
-      `MATCH (a:AdminUser {accountId: $accountId, userId: $userId})
-       CREATE (e:VoiceEdit {
-         editId: $editId,
-         accountId: $accountId,
-         userId: $profileUserId,
-         scope: $scope,
-         format: $format,
-         originalText: $originalText,
-         editedText: $editedText,
-         intent: $intent,
-         occurredAt: $occurredAt,
-         skill: $skill,
-         brief: $brief
-       })
-       CREATE (a)-[:AUTHORED]->(e)
-       WITH e
-       OPTIONAL MATCH (p:VoiceProfile {accountId: $accountId, userId: $profileUserId, format: $format})
-       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,
-        userId,
-        profileUserId,
-        scope,
-        format,
-        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}', 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] scope=${scope} userId=${profileUserId} format=${format} intent="${cappedIntent.replace(/"/g, "'")}" diffBytes=${editedText.length - originalText.length}\n`,
-    );
-
-    return { editId, intent: cappedIntent, occurredAt, hadProfile };
-  } finally {
-    await session.close();
-  }
-}

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

@@ -1,270 +0,0 @@
-/**
- * voice-retrieve-conditioning — return the operator's style card plus K
- * voice-matched exemplars for a drafting brief.
- *
- * Task 462 changes:
- *   - `brief.format` (K-selector: 'short'|'long') renamed to `brief.length`
- *     to free the name for the new `brief.format: VoiceFormat` axis.
- *   - `brief.format: VoiceFormat` (required) — corpus exemplars are filtered
- *     to this writing format; the `:VoiceProfile` is the per-format profile.
- *   - All callers updated in the same commit.
- *
- * Retrieval order (best to worst):
- *   1. If brief.topic is provided AND keyword search on the per-format corpus
- *      returns ≥K matches → use those (ordered by recency).
- *   2. Otherwise, return the K most-recent per-format corpus 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, discriminated (Task 493): the function never throws.
- * Missing profile / empty corpus returns status "no-data"; a failed lookup
- * (blank identity, driver/connection fault, Cypher error) returns status
- * "error" with the message. The calling drafting skill falls back to its
- * default register on both, but only "no-data" means "you have no profile".
- */
-import neo4j, { type Session } from "neo4j-driver";
-import { getSession } from "../lib/neo4j.js";
-import { notTrashed } from "../lib/voice-corpus.js";
-import {
-  voiceCorpusWhereWithFormat,
-  voiceCorpusWhereWithFormatAndAuthor,
-  ORG_USER_ID,
-  type VoiceFormat,
-  type VoiceScope,
-} from "../lib/voice-corpus.js";
-
-const DEFAULT_TOKEN_BUDGET_SHORT = 16_000;
-const DEFAULT_TOKEN_BUDGET_LONG = 96_000;
-const CHARS_PER_TOKEN = 4;
-
-export interface VoiceRetrieveConditioningParams {
-  accountId: string;
-  userId: string;
-  brief: {
-    topic?: string;
-    /**
-     * Writing format for corpus and profile scoping (required, Task 462).
-     * One :VoiceProfile per (accountId, userId, format).
-     */
-    format: VoiceFormat;
-    /**
-     * K-selector: 'short' = K=5 (16k token budget, email/post);
-     *             'long'  = K=15 (96k token budget, brochure/prospectus).
-     * Renamed from `format` in Task 462 to free the name for VoiceFormat.
-     */
-    length?: "short" | "long";
-    register?: string;
-    /**
-     * Voice scope (Task 676). `'personal'` (default) retrieves the caller's own
-     * profile and author-filtered exemplars, falling back to the org profile
-     * when the caller has none. `'org'` retrieves the account/house profile and
-     * account-wide exemplars, degrading to the default register when absent.
-     */
-    scope?: VoiceScope;
-  };
-  tokenBudget?: number;
-}
-
-export interface VoiceExemplar {
-  nodeId: string;
-  label: string;
-  body: string;
-  source: string;
-}
-
-/**
- * Outcome discriminator (Task 493). Three mutually-exclusive states so the
- * drafting agent and operator can tell genuine no-data apart from a failed
- * lookup — both previously collapsed into the same empty payload:
- *   - "ok"          — query ran; a style card and/or exemplars were returned
- *                     for the requested scope.
- *   - "fallback-org"— a personal request found no personal profile/corpus, so
- *                     the org profile was returned instead (Task 676). Drafting
- *                     uses the org voice; this is the standing signal that the
- *                     caller has no personal attribution yet.
- *   - "no-data"     — query ran; no profile exists and the corpus is empty for
- *                     the requested scope (and, for personal, no org fallback).
- *   - "error"       — the lookup failed (blank identity, driver/connection
- *                     fault, or Cypher error). `error` carries the message.
- * Drafting degrades gracefully to default register on "no-data" and "error";
- * "fallback-org" still injects a (org) style card. The caller must only report
- * "no profile exists" on "no-data".
- */
-export type VoiceRetrieveStatus = "ok" | "fallback-org" | "no-data" | "error";
-
-export interface VoiceRetrieveConditioningResult {
-  styleCard: string | null;
-  exemplars: VoiceExemplar[];
-  status: VoiceRetrieveStatus;
-  error?: string;
-}
-
-function errorResult(error: string): VoiceRetrieveConditioningResult {
-  return { styleCard: null, exemplars: [], status: "error", error };
-}
-
-export async function voiceRetrieveConditioning(
-  params: VoiceRetrieveConditioningParams,
-): Promise<VoiceRetrieveConditioningResult> {
-  const { accountId, userId, brief } = params;
-  const scope: VoiceScope = brief.scope ?? "personal";
-  // Blank identity is an error, never genuine no-data — a blank value reaching
-  // here is a precondition failure, not "you have no profile". `accountId` is
-  // always required. `userId` is required only for personal scope: org scope is
-  // account-wide and keyed on the reserved ORG_USER_ID, so it resolves identity
-  // from `accountId` alone and never reads `userId` (Task 975). Emit a line so
-  // this path is no longer silent (Task 493 — closes the 06:46 path-1 ambiguity).
-  if (!accountId || (scope !== "org" && !userId)) {
-    process.stderr.write(
-      `[voice-retrieve] error: missing-identity scope=${scope} accountId=${Boolean(accountId)} userId=${Boolean(userId)}\n`,
-    );
-    return errorResult("missing accountId/userId");
-  }
-
-  const length = brief.length ?? "short";
-  const k = length === "long" ? 15 : 5;
-  const tokenBudget =
-    params.tokenBudget ??
-    (length === "long" ? DEFAULT_TOKEN_BUDGET_LONG : DEFAULT_TOKEN_BUDGET_SHORT);
-  const charBudget = tokenBudget * CHARS_PER_TOKEN;
-  const format = brief.format;
-  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
-         WITH n, ts, collect(s.body) AS sectionBodies
-         WITH n, ts, CASE
-           WHEN 'KnowledgeDocument' IN labels(n) AND size(sectionBodies) > 0
-             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`;
-
-  // 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: Session | undefined;
-  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: string,
-      exemplarWhere: string,
-      exemplarParams: Record<string, unknown>,
-    ): Promise<{ styleCard: string | null; exemplars: VoiceExemplar[] }> => {
-      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") as string | null) ?? 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),
-      });
-
-      let charsUsed = 0;
-      const exemplars: VoiceExemplar[] = [];
-      for (const r of result.records) {
-        const body = (r.get("body") as string | null) ?? "";
-        if (body.length === 0) continue;
-        const labels = (r.get("labels") as string[]) ?? [];
-        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") as string,
-          label,
-          body: truncated,
-          source: ((r.get("source") as string | null) ?? "").slice(0, 200),
-        });
-        charsUsed += truncated.length;
-      }
-      return { styleCard, exemplars };
-    };
-
-    const hasData = (r: { styleCard: string | null; exemplars: VoiceExemplar[] }) =>
-      (r.styleCard !== null && r.styleCard.length > 0) || r.exemplars.length > 0;
-
-    const orgLookup = () =>
-      lookup(ORG_USER_ID, voiceCorpusWhereWithFormat(format), { accountId, format });
-
-    let result: { styleCard: string | null; exemplars: VoiceExemplar[] };
-    let status: VoiceRetrieveStatus;
-    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] 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);
-    process.stderr.write(`[voice-retrieve] error: ${message}\n`);
-    return errorResult(message);
-  } finally {
-    if (session) await session.close();
-  }
-}