@rubytech/create-maxy-code 0.1.174 → 0.1.177

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

@@ -2,10 +2,17 @@
  * 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 human-only corpus
+ *   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 human-only nodes.
+ *   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
@@ -18,7 +25,7 @@
  * 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";
+import { voiceCorpusWhereWithFormat, } from "../lib/voice-corpus.js";
 const DEFAULT_TOKEN_BUDGET_SHORT = 16_000;
 const DEFAULT_TOKEN_BUDGET_LONG = 96_000;
 const CHARS_PER_TOKEN = 4;
@@ -27,23 +34,26 @@ export async function voiceRetrieveConditioning(params) {
     const { accountId, userId, brief } = params;
     if (!accountId || !userId)
         return EMPTY;
-    const k = brief.format === "long" ? 15 : 5;
+    const length = brief.length ?? "short";
+    const k = length === "long" ? 15 : 5;
     const tokenBudget = params.tokenBudget ??
-        (brief.format === "long" ? DEFAULT_TOKEN_BUDGET_LONG : DEFAULT_TOKEN_BUDGET_SHORT);
+        (length === "long" ? DEFAULT_TOKEN_BUDGET_LONG : DEFAULT_TOKEN_BUDGET_SHORT);
     const charBudget = tokenBudget * CHARS_PER_TOKEN;
+    const format = brief.format;
+    const corpusWhere = voiceCorpusWhereWithFormat(format);
     const session = getSession();
     try {
-        // 1. Style card.
+        // 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)
-       RETURN p.styleCard AS styleCard`, { accountId, 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. Keyword-aware filter when brief.topic is set.
+        // 2. Exemplars — filtered to brief.format. Keyword-aware when topic is set.
         const topic = (brief.topic ?? "").trim();
         const usesTopic = topic.length > 0;
         const cypher = usesTopic
             ? `MATCH (n)
-         WHERE ${VOICE_CORPUS_WHERE}
+         WHERE ${corpusWhere}
            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,
@@ -54,7 +64,7 @@ export async function voiceRetrieveConditioning(params) {
          ORDER BY ts IS NULL, ts DESC
          LIMIT $k`
             : `MATCH (n)
-         WHERE ${VOICE_CORPUS_WHERE}
+         WHERE ${corpusWhere}
          WITH n, coalesce(n.dateSent, n.datePublished, n.firstMessageAt, n.dateCreated, n.createdAt) AS ts
          RETURN elementId(n) AS id,
                 labels(n) AS labels,
@@ -65,6 +75,7 @@ export async function voiceRetrieveConditioning(params) {
          LIMIT $k`;
         const result = await session.run(cypher, {
             accountId,
+            format,
             topic,
             k,
         });
@@ -88,7 +99,7 @@ export async function voiceRetrieveConditioning(params) {
             });
             charsUsed += truncated.length;
         }
-        process.stderr.write(`[voice-retrieve] task=${brief.topic ?? brief.format} styleCardBytes=${styleCard?.length ?? 0} exemplarCount=${exemplars.length} tokenBudget=${tokenBudget}\n`);
+        process.stderr.write(`[voice-retrieve] task=${brief.topic ?? length} format=${format} styleCardBytes=${styleCard?.length ?? 0} exemplarCount=${exemplars.length} tokenBudget=${tokenBudget}\n`);
         return { styleCard, exemplars };
     }
     catch (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,9 +1,12 @@
+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>;
 export interface VoiceTagContentParams {
     nodeIds: string[];
     mode: AuthorshipMode;
     accountId: string;
+    /** Optional format. When omitted, derived from each node's labels. */
+    format?: VoiceFormat;
 }
 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":"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"}
+{"version":3,"file":"voice-tag-content.d.ts","sourceRoot":"","sources":["../../src/tools/voice-tag-content.ts"],"names":[],"mappings":"AAiBA,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,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;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;AAcD,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAuFhC"}

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

@@ -1,13 +1,21 @@
 /**
- * voice-tag-content — set `authorshipMode` on one or many content nodes.
+ * voice-tag-content — set `authorshipMode` (and optionally `format`) 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.
+ *
+ * Format stamping (Task 462):
+ *   - When `format` is provided: validated against FORMAT_VALUES and written
+ *     to `n.format` alongside `authorshipMode`.
+ *   - When `format` is omitted: a Cypher CASE expression derives format from
+ *     each node's labels and `source` property, matching the `deriveFormat()`
+ *     rule table in voice-corpus.ts. This keeps tag and ingest in lockstep.
  */
 import { getSession } from "../lib/neo4j.js";
-import { TAGGABLE_PRIMARY_LABELS } from "../lib/voice-corpus.js";
+import { TAGGABLE_PRIMARY_LABELS, FORMAT_VALUES, } from "../lib/voice-corpus.js";
 export const AUTHORSHIP_MODES = new Set([
     "human-only",
     "human-led-agent-assisted",
@@ -15,8 +23,19 @@ export const AUTHORSHIP_MODES = new Set([
     "agent-only",
     "unknown",
 ]);
+// Cypher CASE expression that mirrors deriveFormat() for in-query derivation.
+// Used when the caller does not supply an explicit format.
+const FORMAT_DERIVE_CASE = `CASE
+  WHEN 'Message' IN labels(n) THEN 'text'
+  WHEN 'SocialPost' IN labels(n) THEN 'social-post'
+  WHEN ('KnowledgeDocument' IN labels(n) OR 'ConversationArchive' IN labels(n))
+       AND n.source = 'email' THEN 'email'
+  WHEN 'KnowledgeDocument' IN labels(n) AND size(coalesce(n.body, '')) > 1500 THEN 'article'
+  WHEN 'KnowledgeDocument' IN labels(n) THEN 'note'
+  ELSE 'text'
+END`;
 export async function voiceTagContent(params) {
-    const { nodeIds, mode, accountId } = params;
+    const { nodeIds, mode, accountId, format } = params;
     if (!AUTHORSHIP_MODES.has(mode)) {
         throw new Error(`voice-tag-content: invalid authorshipMode '${mode}'. Valid values: ${[
             ...AUTHORSHIP_MODES,
@@ -25,6 +44,9 @@ export async function voiceTagContent(params) {
     if (!accountId) {
         throw new Error("voice-tag-content: accountId is required");
     }
+    if (format !== undefined && !FORMAT_VALUES.includes(format)) {
+        throw new Error(`voice-tag-content: invalid format '${format}'. Valid values: ${FORMAT_VALUES.join(", ")}`);
+    }
     if (!Array.isArray(nodeIds) || nodeIds.length === 0) {
         return { updated: 0, skipped: 0, skippedReasons: {} };
     }
@@ -44,6 +66,10 @@ export async function voiceTagContent(params) {
             // accidentally tagging document-path :Section rows AND parent
             // `:Conversation` / `:AdminConversation` nodes (which are not
             // body-bearing content).
+            //
+            // Format is either the caller-supplied constant ($format is non-null)
+            // or derived per-node via the CASE expression that mirrors
+            // deriveFormat() in voice-corpus.ts.
             `UNWIND $ids AS id
          MATCH (n) WHERE elementId(n) = id AND n.accountId = $accountId
          WITH n
@@ -53,12 +79,14 @@ export async function voiceTagContent(params) {
                  WHERE parent.conversationIdentity IS NOT NULL
                })
          SET n.authorshipMode = $mode,
-             n.authorshipTaggedAt = $now
+             n.authorshipTaggedAt = $now,
+             n.format = CASE WHEN $format IS NOT NULL THEN $format ELSE ${FORMAT_DERIVE_CASE} END
          RETURN elementId(n) AS id`, {
                 ids: batch,
                 accountId,
                 mode,
                 now,
+                format: format ?? null,
                 primaryLabels: [...TAGGABLE_PRIMARY_LABELS],
             });
             const matched = new Set(result.records.map((r) => r.get("id")));
@@ -74,7 +102,7 @@ export async function voiceTagContent(params) {
     finally {
         await session.close();
     }
-    process.stderr.write(`[voice-tag] mode=${mode} accountId=${accountId} updated=${updated} skipped=${nodeIds.length - updated}\n`);
+    process.stderr.write(`[voice-tag] mode=${mode} format=${format ?? "derived"} 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

@@ -2,26 +2,35 @@
 /**
  * Boot + shape smoke test for the writer-craft MCP server.
  *
- * Verifies:
- *   1. Every compiled tool module loads without throwing.
- *   2. Every exported handler is a function with the expected name.
- *   3. AUTHORSHIP_MODES enum covers the five spec-required values.
- *   4. TAGGABLE_PRIMARY_LABELS covers the four content labels.
- *   5. `voice-retrieve-conditioning` returns the graceful-degradation
- *      shape `{styleCard: null, exemplars: []}` when accountId is empty
- *      (the contract the calling drafting skills depend on).
+ * Verifies without a live Neo4j connection:
+ *   1. Cypher forbidden-pattern gate (Task 458 fold-in): no NULLS LAST /
+ *      NULLS FIRST / RETURNING patterns in the Cypher emitted by tool sources.
+ *   2. Every compiled tool module loads without throwing.
+ *   3. Every exported handler is a function with the expected name.
+ *   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.
+ *   8. deriveFormat() maps all node shapes to the correct format value.
+ *   9. voice-retrieve-conditioning returns the graceful-degradation shape
+ *      {styleCard: null, exemplars: []} on empty accountId/userId.
+ *  10. voice-tag-content validates mode and format enums; returns zero counts
+ *      on empty nodeIds.
+ *  11. voice-ingest-session-text: extractOperatorTurns() extracts real turns
+ *      and excludes slash commands, paste blocks, and system reminders.
  *
- * Runs with no external dependencies and no neo4j connection — the
- * graceful-degradation case never opens a session. The four other tools
- * are not exercised against the database here; their unit test coverage
- * is filed as a follow-up. This smoke harness catches import errors,
- * accidental contract changes on the empty-corpus return shape, and
- * structural drift on the exported enum.
- *
- * Exit code: 0 on pass, 1 on any assertion failure. Designed for CI
- * gating and `npm run smoke` in the build pipeline.
+ * Exit code: 0 on pass, 1 on any assertion failure.
  */
 import { strict as assert } from "node:assert";
+import { readFileSync, writeFileSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readdirSync } from "node:fs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TOOLS_SRC = join(__dirname, "../src/tools");
+const LIB_SRC = join(__dirname, "../src/lib");
 
 const errors = [];
 function check(name, fn) {
@@ -45,11 +54,57 @@ function check(name, fn) {
 
 console.log("[writer-craft smoke] starting");
 
-// 1. Modules load.
+// ---------------------------------------------------------------------------
+// 1. Cypher forbidden-pattern gate (Task 458).
+//    No NULLS LAST / NULLS FIRST / RETURNING in tool source files.
+//    These patterns are Postgres-isms; neo4j-driver silently ignores or
+//    errors on them. The gate runs on .ts source files so it catches issues
+//    before compilation.
+// ---------------------------------------------------------------------------
+console.log("\n-- Cypher gate --");
+const FORBIDDEN_PATTERNS = [/NULLS\s+LAST/i, /NULLS\s+FIRST/i, /\bRETURNING\b/];
+
+function scanFile(filePath) {
+  const content = readFileSync(filePath, "utf-8");
+  const hits = [];
+  for (const pat of FORBIDDEN_PATTERNS) {
+    if (pat.test(content)) hits.push(pat.toString());
+  }
+  return hits;
+}
+
+function scanDir(dirPath) {
+  const allHits = {};
+  for (const entry of readdirSync(dirPath)) {
+    if (!entry.endsWith(".ts")) continue;
+    const filePath = join(dirPath, entry);
+    const hits = scanFile(filePath);
+    if (hits.length > 0) allHits[filePath] = hits;
+  }
+  return allHits;
+}
+
+await check("no forbidden Cypher patterns in tool sources", () => {
+  const toolHits = scanDir(TOOLS_SRC);
+  const libHits = scanDir(LIB_SRC);
+  const allHits = { ...toolHits, ...libHits };
+  const fileList = Object.keys(allHits);
+  assert.equal(
+    fileList.length,
+    0,
+    `Forbidden Cypher patterns found:\n${fileList.map((f) => `  ${f}: ${allHits[f].join(", ")}`).join("\n")}`,
+  );
+});
+
+// ---------------------------------------------------------------------------
+// 2. Module load + export shape checks.
+// ---------------------------------------------------------------------------
+console.log("\n-- Module shapes --");
 const tagMod = await import("../dist/tools/voice-tag-content.js");
 const distilMod = await import("../dist/tools/voice-distil-profile.js");
 const retrieveMod = await import("../dist/tools/voice-retrieve-conditioning.js");
 const feedbackMod = await import("../dist/tools/voice-record-feedback.js");
+const ingestMod = await import("../dist/tools/voice-ingest-session-text.js");
 const corpusMod = await import("../dist/lib/voice-corpus.js");
 
 await check("voice-tag-content exports voiceTagContent function", () => {
@@ -75,45 +130,111 @@ await check("voice-retrieve-conditioning exports voiceRetrieveConditioning funct
 await check("voice-record-feedback exports voiceRecordFeedback function", () => {
   assert.equal(typeof feedbackMod.voiceRecordFeedback, "function");
 });
+await check("voice-ingest-session-text exports required functions", () => {
+  assert.equal(typeof ingestMod.voiceIngestSessionText, "function");
+  assert.equal(typeof ingestMod.extractOperatorTurns, "function");
+  assert.equal(typeof ingestMod.extractOperatorText, "function");
+});
+
+// ---------------------------------------------------------------------------
+// 3. voice-corpus exports — format axis (Task 462).
+// ---------------------------------------------------------------------------
+console.log("\n-- voice-corpus format exports --");
 await check("VOICE_CORPUS_WHERE is non-empty string with both predicates", () => {
   assert.equal(typeof corpusMod.VOICE_CORPUS_WHERE, "string");
   assert.ok(corpusMod.VOICE_CORPUS_WHERE.includes("authorshipMode IN"));
   assert.ok(corpusMod.VOICE_CORPUS_WHERE.includes("human-only"));
-  assert.ok(corpusMod.VOICE_CORPUS_WHERE.includes("human-led-agent-assisted"));
   assert.ok(corpusMod.VOICE_CORPUS_WHERE.includes("Section"));
 });
 await check("TAGGABLE_PRIMARY_LABELS covers the three content labels", () => {
   const labels = [...corpusMod.TAGGABLE_PRIMARY_LABELS];
   assert.deepEqual(labels.sort(), ["KnowledgeDocument", "Message", "SocialPost"]);
 });
+await check("FORMAT_VALUES covers all six writing formats", () => {
+  const expected = ["text", "email", "social-post", "article", "marketing-copy", "note"];
+  const actual = [...corpusMod.FORMAT_VALUES].sort();
+  assert.deepEqual(actual.sort(), expected.sort());
+});
+await check("voiceCorpusWhereWithFormat appends format predicate", () => {
+  const result = corpusMod.voiceCorpusWhereWithFormat("email");
+  assert.ok(typeof result === "string");
+  assert.ok(result.includes(corpusMod.VOICE_CORPUS_WHERE));
+  assert.ok(result.includes("n.format = $format"));
+  assert.ok(result.includes("email") || result.includes("$format"));
+});
 
-// 2. Graceful-degradation contract — the drafting skills depend on this.
-//    Empty accountId/adminUserId path returns the empty shape without
-//    opening a neo4j session. This is the load-bearing contract.
+// ---------------------------------------------------------------------------
+// 4. deriveFormat() unit tests — all derivation rules.
+// ---------------------------------------------------------------------------
+console.log("\n-- deriveFormat() rules --");
+const { deriveFormat } = corpusMod;
+
+await check("deriveFormat: :Message → text", () => {
+  assert.equal(deriveFormat(["Message"]), "text");
+  assert.equal(deriveFormat(["Message", "SomeOther"]), "text");
+});
+await check("deriveFormat: :SocialPost → social-post", () => {
+  assert.equal(deriveFormat(["SocialPost"]), "social-post");
+});
+await check("deriveFormat: :KnowledgeDocument {source:'email'} → email", () => {
+  assert.equal(deriveFormat(["KnowledgeDocument"], "email"), "email");
+});
+await check("deriveFormat: :ConversationArchive {source:'email'} → email", () => {
+  assert.equal(deriveFormat(["ConversationArchive"], "email"), "email");
+});
+await check("deriveFormat: :KnowledgeDocument body > 1500 → article", () => {
+  const longBody = "x".repeat(1501);
+  assert.equal(deriveFormat(["KnowledgeDocument"], null, longBody), "article");
+  assert.equal(deriveFormat(["KnowledgeDocument"], "other", longBody), "article");
+});
+await check("deriveFormat: :KnowledgeDocument body = 1500 → note", () => {
+  const borderBody = "x".repeat(1500);
+  assert.equal(deriveFormat(["KnowledgeDocument"], null, borderBody), "note");
+});
+await check("deriveFormat: :KnowledgeDocument body ≤ 1500 → note", () => {
+  const shortBody = "x".repeat(100);
+  assert.equal(deriveFormat(["KnowledgeDocument"], null, shortBody), "note");
+  assert.equal(deriveFormat(["KnowledgeDocument"], undefined, undefined), "note");
+});
+await check("deriveFormat: :Section (conversation chunk) → text", () => {
+  assert.equal(deriveFormat(["Section"]), "text");
+});
+await check("deriveFormat: unknown label → text (fallback)", () => {
+  assert.equal(deriveFormat(["Unknown"]), "text");
+  assert.equal(deriveFormat([]), "text");
+});
+
+// ---------------------------------------------------------------------------
+// 5. Graceful-degradation contract for voice-retrieve-conditioning.
+// ---------------------------------------------------------------------------
+console.log("\n-- graceful-degradation contracts --");
 await check(
   "voice-retrieve-conditioning returns empty shape on missing accountId",
   async () => {
     const result = await retrieveMod.voiceRetrieveConditioning({
       accountId: "",
-      adminUserId: "u",
-      brief: { format: "short" },
+      userId: "u",
+      brief: { format: "text", length: "short" },
     });
     assert.deepEqual(result, { styleCard: null, exemplars: [] });
   },
 );
 await check(
-  "voice-retrieve-conditioning returns empty shape on missing adminUserId",
+  "voice-retrieve-conditioning returns empty shape on missing userId",
   async () => {
     const result = await retrieveMod.voiceRetrieveConditioning({
       accountId: "acc",
-      adminUserId: "",
-      brief: { format: "long" },
+      userId: "",
+      brief: { format: "email", length: "long" },
     });
     assert.deepEqual(result, { styleCard: null, exemplars: [] });
   },
 );
 
-// 3. voice-tag-content validates the mode enum before any DB work.
+// ---------------------------------------------------------------------------
+// 6. voice-tag-content enum validation.
+// ---------------------------------------------------------------------------
+console.log("\n-- voice-tag-content validation --");
 await check("voice-tag-content rejects an invalid mode", async () => {
   await assert.rejects(
     () =>
@@ -125,6 +246,18 @@ await check("voice-tag-content rejects an invalid mode", async () => {
     /invalid authorshipMode/,
   );
 });
+await check("voice-tag-content rejects an invalid format", async () => {
+  await assert.rejects(
+    () =>
+      tagMod.voiceTagContent({
+        nodeIds: ["x"],
+        mode: "human-only",
+        accountId: "acc",
+        format: "bad-format",
+      }),
+    /invalid format/,
+  );
+});
 await check("voice-tag-content rejects empty accountId", async () => {
   await assert.rejects(
     () =>
@@ -145,6 +278,134 @@ await check("voice-tag-content returns zero counts on empty nodeIds (no DB hit)"
   assert.deepEqual(result, { updated: 0, skipped: 0, skippedReasons: {} });
 });
 
+// ---------------------------------------------------------------------------
+// 7. voice-ingest-session-text: JSONL extraction (no DB required).
+// ---------------------------------------------------------------------------
+console.log("\n-- JSONL extraction --");
+
+function makeJsonlLine(type, role, content) {
+  return JSON.stringify({ type, message: { role, content } });
+}
+
+await check("extractOperatorText: real user turn is extracted", () => {
+  const record = { type: "user", message: { role: "user", content: "Hello world" } };
+  const result = ingestMod.extractOperatorText(record);
+  assert.equal(result, "Hello world");
+});
+await check("extractOperatorText: slash command is excluded", () => {
+  const record = { type: "user", message: { role: "user", content: "/end" } };
+  assert.equal(ingestMod.extractOperatorText(record), null);
+});
+await check("extractOperatorText: system-reminder is excluded", () => {
+  const record = {
+    type: "user",
+    message: { role: "user", content: "<system-reminder>some injected text</system-reminder>" },
+  };
+  assert.equal(ingestMod.extractOperatorText(record), null);
+});
+await check("extractOperatorText: paste block > 4096 chars is excluded", () => {
+  const record = {
+    type: "user",
+    message: { role: "user", content: "x".repeat(4097) },
+  };
+  assert.equal(ingestMod.extractOperatorText(record), null);
+});
+await check("extractOperatorText: paste block = 4096 chars is excluded", () => {
+  const record = {
+    type: "user",
+    message: { role: "user", content: "x".repeat(4096) },
+  };
+  assert.equal(ingestMod.extractOperatorText(record), null);
+});
+await check("extractOperatorText: paste block = 4095 chars is included", () => {
+  const body = "x".repeat(4095);
+  const record = { type: "user", message: { role: "user", content: body } };
+  assert.equal(ingestMod.extractOperatorText(record), body);
+});
+await check("extractOperatorText: assistant turn is excluded", () => {
+  const record = { type: "assistant", message: { role: "assistant", content: "Reply" } };
+  assert.equal(ingestMod.extractOperatorText(record), null);
+});
+await check("extractOperatorText: tool_result-only content is excluded", () => {
+  const record = {
+    type: "user",
+    message: {
+      role: "user",
+      content: [{ type: "tool_result", tool_use_id: "x", content: "ok" }],
+    },
+  };
+  assert.equal(ingestMod.extractOperatorText(record), null);
+});
+await check("extractOperatorText: content array with text block is extracted", () => {
+  const record = {
+    type: "user",
+    message: {
+      role: "user",
+      content: [{ type: "text", text: "Hello from array" }],
+    },
+  };
+  assert.equal(ingestMod.extractOperatorText(record), "Hello from array");
+});
+
+// Full JSONL fixture: 3 real turns + 2 assistant + 1 slash + 1 system-reminder.
+// Expected: extractOperatorTurns returns 3 strings.
+await check(
+  "extractOperatorTurns: fixture with 3 real turns + 4 excluded → 3 results",
+  async () => {
+    const tmp = mkdtempSync(join(tmpdir(), "smoke-ingest-"));
+    const jsonlPath = join(tmp, "session.jsonl");
+    const lines = [
+      // 3 real operator turns
+      makeJsonlLine("user", "user", "First real turn"),
+      makeJsonlLine("user", "user", "Second real turn"),
+      makeJsonlLine("user", "user", "Third real turn"),
+      // 2 assistant turns
+      makeJsonlLine("assistant", "assistant", "Agent reply 1"),
+      makeJsonlLine("assistant", "assistant", "Agent reply 2"),
+      // 1 slash command
+      makeJsonlLine("user", "user", "/end"),
+      // 1 system reminder
+      makeJsonlLine("user", "user", "<system-reminder>injected</system-reminder>"),
+    ];
+    writeFileSync(jsonlPath, lines.join("\n") + "\n");
+    try {
+      const turns = await ingestMod.extractOperatorTurns(jsonlPath);
+      assert.equal(turns.length, 3, `expected 3 turns, got ${turns.length}`);
+      assert.equal(turns[0], "First real turn");
+      assert.equal(turns[1], "Second real turn");
+      assert.equal(turns[2], "Third real turn");
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+    }
+  },
+);
+
+// Second-run fixture: same lines written to same path → same 3 turns extracted.
+// (Actual dedup happens in the DB via contentHash MERGE; extraction is idempotent.)
+await check(
+  "extractOperatorTurns: re-running same JSONL extracts same turns (dedup is in DB)",
+  async () => {
+    const tmp = mkdtempSync(join(tmpdir(), "smoke-ingest-dedup-"));
+    const jsonlPath = join(tmp, "session.jsonl");
+    const lines = [
+      makeJsonlLine("user", "user", "Dedupe turn"),
+      makeJsonlLine("user", "user", "/skip-cmd"),
+    ];
+    writeFileSync(jsonlPath, lines.join("\n") + "\n");
+    try {
+      const turns1 = await ingestMod.extractOperatorTurns(jsonlPath);
+      const turns2 = await ingestMod.extractOperatorTurns(jsonlPath);
+      assert.deepEqual(turns1, turns2, "idempotent: same JSONL gives same turns");
+      assert.equal(turns1.length, 1);
+    } finally {
+      rmSync(tmp, { recursive: true, force: true });
+    }
+  },
+);
+
+// ---------------------------------------------------------------------------
+// Final summary.
+// ---------------------------------------------------------------------------
 if (errors.length > 0) {
   console.error(`\n[writer-craft smoke] FAILED — ${errors.length} assertion(s)`);
   process.exit(1);