@rubytech/create-realagent 1.0.832 → 1.0.834

package/payload/platform/plugins/memory/bin/conversation-archive-ingest.mjs

@@ -24,11 +24,16 @@
 // Argv (flags):       --source <enum>
 //                     --participant-person-ids <csv>
 //                     --scope <admin|public>
-//                     [--session-gap-hours <N>]   (default 12)
+//                     [--rebuild]                  (Task 902 — destructive rebuild)
 //                     [--timezone <iana>]
 //                     [--date-format <DD/MM/YY|MM/DD/YY|DD/MM/YYYY|MM/DD/YYYY>]
 //                     [--session-id <id>]
 //
+// Sessions split at SESSION_GAP_HOURS=8 (fixed constant — Task 902). The flag
+// `--session-gap-hours` is REMOVED; passing it FAILs at phase=argv. The
+// chunked chat-mode classify path (Task 902 sub-scope C) absorbs oversize
+// sessions internally — no operator lever required.
+//
 // Stdout (success): one JSON line — counters the skill needs to formulate
 // the three operator-facing messages. See SKILL.md for the shape.
 // Stderr + progress file: `[conversation-archive] ...` lines, fsync per write.
@@ -56,6 +61,16 @@ import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
+// Task 902 sub-scope D — fixed session gap. Pre-902 this was a CLI flag with a
+// 12h default; oversize sessions on dense archives drove operators to re-issue
+// with a smaller gap, which combined with cleanup-by-archiveSha256 to silently
+// destroy 138 chunks (Adam Mackay incident, 2026-05-04). The flag is gone;
+// chunked chat-mode classify (sub-scope C) absorbs oversize sessions
+// internally so the gap value is no longer an operational lever. 8h is a
+// tighter default than 12h and matches the operator-decided post-incident
+// constant.
+const SESSION_GAP_HOURS = 8;
+
 // ---------------------------------------------------------------------------
 // 1. Resolve dist paths.
 // ---------------------------------------------------------------------------
@@ -190,6 +205,9 @@ const VALID_SOURCES = new Set([
   "other",
 ]);
 
+// Boolean flags carry no value; every other flag consumes the following arg.
+const BOOLEAN_FLAGS = new Set(["rebuild"]);
+
 function parseArgv(argv) {
   const args = argv.slice(2);
   let archive = null;
@@ -202,6 +220,18 @@ function parseArgv(argv) {
       continue;
     }
     const key = a.slice(2);
+    // Task 902 sub-scope D — the flag re-introduced the surface that enabled
+    // the silent-partial-wipe failure (Defect B). Reject loudly with the
+    // remediation the operator should use instead.
+    if (key === "session-gap-hours") {
+      fail("argv", {
+        reason: `--session-gap-hours is no longer supported; gap is fixed at 8h. Use --rebuild on the prior export bytes if you need to re-classify.`,
+      });
+    }
+    if (BOOLEAN_FLAGS.has(camelCase(key))) {
+      flags[camelCase(key)] = true;
+      continue;
+    }
     const v = args[++i];
     if (v == null) fail("argv", { reason: `flag --${key} requires a value` });
     flags[camelCase(key)] = v;
@@ -281,6 +311,87 @@ function findChatTxt(dir) {
   return null;
 }
 
+// ---------------------------------------------------------------------------
+// 4b. Stable archive title (Task 902 sub-scope A).
+//
+// Format: `<source> · <owner> ↔ <other1>, <other2>, … · <YYYY-MM-DD>→<YYYY-MM-DD>`.
+//
+// The title is computed once per ingest from inputs that are immutable for
+// the conversation (source, accountId, sortedParticipantElementIds, archive
+// dateRange) so re-ingests produce the same string. Memory-ingest writes it
+// to `:ConversationArchive.title` ON CREATE and COALESCE-on-MATCH so the UI
+// (display-helpers.ts) reads a stable label without ever falling through to
+// `summary`. Per-session counter strings stay in the progress file only.
+//
+// Names: AdminUser uses `displayName` then `slug`; Person composes
+// `givenName + familyName`. When neither resolves, fall back to a short
+// elementId prefix — same degraded format the migration uses on backfill,
+// so a re-ingest after the migration produces the same title shape that
+// already populated the node.
+// ---------------------------------------------------------------------------
+
+function isoToYmd(iso) {
+  // Read the YYYY-MM-DD prefix verbatim — same tz-stable contract as
+  // formatRunDate in display-helpers.ts. Parsing to Date + reformatting
+  // would flip the day between operator timezones.
+  const m = typeof iso === "string" ? iso.match(/^(\d{4}-\d{2}-\d{2})/) : null;
+  return m ? m[1] : "?";
+}
+
+function pickNameForRow(labels, props) {
+  if (Array.isArray(labels) && labels.includes("AdminUser")) {
+    const dn = typeof props.displayName === "string" ? props.displayName.trim() : "";
+    if (dn) return dn;
+    const slug = typeof props.slug === "string" ? props.slug.trim() : "";
+    if (slug) return slug;
+  }
+  if (Array.isArray(labels) && labels.includes("Person")) {
+    const given = typeof props.givenName === "string" ? props.givenName.trim() : "";
+    const family = typeof props.familyName === "string" ? props.familyName.trim() : "";
+    const full = [given, family].filter((s) => s.length > 0).join(" ");
+    if (full) return full;
+  }
+  return "";
+}
+
+async function computeArchiveTitle({
+  source,
+  accountId,
+  ownerElementId,
+  participantElementIds,
+  firstMessageAt,
+  lastMessageAt,
+  getSession,
+}) {
+  const session = getSession();
+  let nameByElementId = new Map();
+  try {
+    const ids = [ownerElementId, ...participantElementIds];
+    const r = await session.run(
+      `UNWIND $ids AS id
+       MATCH (n) WHERE elementId(n) = id AND n.accountId = $accountId
+       RETURN elementId(n) AS elemId, labels(n) AS labels, properties(n) AS props`,
+      { ids, accountId },
+    );
+    for (const rec of r.records) {
+      const elemId = rec.get("elemId");
+      const labels = rec.get("labels");
+      const props = rec.get("props") || {};
+      const name = pickNameForRow(labels, props);
+      if (name) nameByElementId.set(elemId, name);
+    }
+  } finally {
+    await session.close().catch(() => {});
+  }
+  const ownerName = nameByElementId.get(ownerElementId) || ownerElementId.slice(0, 8);
+  const otherNames = participantElementIds
+    .map((id) => nameByElementId.get(id) || id.slice(0, 8))
+    .join(", ");
+  const firstYmd = isoToYmd(firstMessageAt);
+  const lastYmd = isoToYmd(lastMessageAt);
+  return `${source} · ${ownerName} ↔ ${otherNames} · ${firstYmd}→${lastYmd}`;
+}
+
 // ---------------------------------------------------------------------------
 // 5. Main
 // ---------------------------------------------------------------------------
@@ -327,12 +438,12 @@ async function main() {
   const scope = flags.scope;
   const timezone = flags.timezone || "Europe/London";
   const dateFormat = flags.dateFormat;
-  const sessionGapHours = flags.sessionGapHours
-    ? parseFloat(flags.sessionGapHours)
-    : 12;
-  if (!Number.isFinite(sessionGapHours) || sessionGapHours <= 0) {
-    fail("argv", { reason: `invalid --session-gap-hours "${flags.sessionGapHours}" (must be positive number)` });
-  }
+  // Task 902 sub-scope B — `--rebuild` is the single opt-in for destructive
+  // re-run-with-same-bytes. Without it, re-issuing the bin on the same export
+  // is a no-op (chunk-count summary, exit 0). With it, the bin treats the run
+  // as first-ingest (skips prior-cursor lookup) and the FIRST session's
+  // memoryIngest call cleans prior chunks for the archiveSha256.
+  const rebuild = flags.rebuild === true;
   const sessionId =
     flags.sessionId ||
     `conversation-archive:${source}:${Date.now()}:${Math.random().toString(36).slice(2, 10)}`;
@@ -426,7 +537,7 @@ async function main() {
   const archiveSha256 = normaliserResult.archiveSha256;
   const archiveSourceFile = normaliserResult.archiveSourceFile;
   log(
-    `source=${source} file=${archiveSourceFile} owner=${ownerElementId} participants=${participantElementIds.length} scope=${scope} accountId=${accountId} archiveSha256=${archiveSha256.slice(0, 12)} session-gap-hours=${sessionGapHours}`,
+    `source=${source} file=${archiveSourceFile} owner=${ownerElementId} participants=${participantElementIds.length} scope=${scope} accountId=${accountId} archiveSha256=${archiveSha256.slice(0, 12)} gap=${SESSION_GAP_HOURS} rebuild=${rebuild}`,
   );
   log(
     `parsed lines=${normaliserResult.counters.parsed} media-skipped=${normaliserResult.counters.mediaSkipped} system-skipped=${normaliserResult.counters.systemSkipped}`,
@@ -463,38 +574,56 @@ async function main() {
     fail("argv", { reason: err instanceof Error ? err.message : String(err) });
   }
 
-  // 6d. Derive conversationIdentity and look up prior :ConversationArchive
+  // 6d. Derive conversationIdentity and look up prior :ConversationArchive.
+  // Task 902 sub-scope B — under `--rebuild` we skip the prior-cursor lookup
+  // entirely; the run is treated as first-ingest, the first session cleans
+  // prior chunks (cleanupPriorChunks=true), and the cursor is overwritten
+  // by that session's MERGE. Without `--rebuild`, the prior cursor drives
+  // delta-append OR (Task 902 sub-scope B) the same-bytes no-op exit when
+  // chunks already exist for this archiveSha256.
   const conversationIdentity = deriveConversationIdentity({
     accountId,
     participantElementIds: [ownerElementId, ...participantElementIds],
   });
   let priorArchive = null;
-  try {
-    const r = await session.run(
-      `MATCH (a:ConversationArchive { conversationIdentity: $cid })
-       RETURN elementId(a) AS elemId,
-              a.lastIngestedMessageHash AS lastHash,
-              a.lastIngestedMessageAt   AS lastAt LIMIT 1`,
-      { cid: conversationIdentity },
-    );
-    if (r.records[0]) {
-      priorArchive = {
-        elemId: r.records[0].get("elemId"),
-        lastHash: r.records[0].get("lastHash"),
-        lastAt: r.records[0].get("lastAt"),
-      };
+  let priorChunkCountForSha = 0;
+  if (!rebuild) {
+    try {
+      const r = await session.run(
+        `MATCH (a:ConversationArchive { conversationIdentity: $cid })
+         OPTIONAL MATCH (a)-[:HAS_SECTION]->(c:Section:Conversation { archiveSha256: $sha })
+         RETURN elementId(a) AS elemId,
+                a.lastIngestedMessageHash AS lastHash,
+                a.lastIngestedMessageAt   AS lastAt,
+                count(c)                  AS chunksForSha LIMIT 1`,
+        { cid: conversationIdentity, sha: archiveSha256 },
+      );
+      if (r.records[0] && r.records[0].get("elemId")) {
+        priorArchive = {
+          elemId: r.records[0].get("elemId"),
+          lastHash: r.records[0].get("lastHash"),
+          lastAt: r.records[0].get("lastAt"),
+        };
+        const cs = r.records[0].get("chunksForSha");
+        priorChunkCountForSha =
+          typeof cs === "number" ? cs : cs?.toNumber?.() ?? 0;
+      }
+    } catch (err) {
+      await session.close().catch(() => {});
+      cleanup();
+      fail("delta-cursor-missing", { reason: `conversationArchive lookup failed: ${err instanceof Error ? err.message : String(err)}` });
     }
-  } catch (err) {
-    await session.close().catch(() => {});
-    cleanup();
-    fail("delta-cursor-missing", { reason: `conversationArchive lookup failed: ${err instanceof Error ? err.message : String(err)}` });
   }
   await session.close().catch(() => {});
 
-  // 6e. Compute deltaStart
+  // 6e. Compute deltaStart. Three branches:
+  //   (i) --rebuild: deltaStart=0, kind=rebuild, classify entire archive.
+  //  (ii) no prior archive (or no cursor): first-ingest, deltaStart=0.
+  // (iii) prior archive + cursor: standard delta-append. Same-bytes (no
+  //       cursor advance possible) AND chunks exist for this sha → no-op.
   let deltaStart = 0;
-  let deltaKind = "first-ingest";
-  if (priorArchive && priorArchive.lastHash) {
+  let deltaKind = rebuild ? "rebuild" : "first-ingest";
+  if (!rebuild && priorArchive && priorArchive.lastHash) {
     const cursor = findDeltaCursor(allLines, priorArchive.lastHash);
     if (cursor.kind === "missing") {
       cleanup();
@@ -505,7 +634,7 @@ async function main() {
       });
     }
     if (cursor.kind === "empty") {
-      log(`noop reason="no new messages since ${priorArchive.lastAt}"`);
+      log(`noop reason="no new messages since ${priorArchive.lastAt}" prior-chunks=${priorChunkCountForSha}`);
       cleanup();
       const totalMs = Date.now() - startedMs;
       process.stdout.write(JSON.stringify({
@@ -519,7 +648,7 @@ async function main() {
         systemSkipped: normaliserResult.counters.systemSkipped,
         delta: { kind: "empty-delta", deltaStart: allLines.length, deltaMessages: 0 },
         sessions: 0,
-        chunks: 0,
+        chunks: priorChunkCountForSha,
         nextEdgesCreated: 0,
         participantsLinked: 0,
         dateRange: { first: allLines[0].dateSent, last: allLines[allLines.length - 1].dateSent },
@@ -536,15 +665,31 @@ async function main() {
   }
   const deltaLines = allLines.slice(deltaStart);
   log(
-    `delta cursor=${priorArchive ? priorArchive.lastHash.slice(0, 12) : "(first-ingest)"} cursor-line=${deltaStart} delta-messages=${deltaLines.length}`,
+    `delta kind=${deltaKind} cursor=${priorArchive && priorArchive.lastHash && !rebuild ? priorArchive.lastHash.slice(0, 12) : "(first-ingest)"} cursor-line=${deltaStart} delta-messages=${deltaLines.length}`,
   );
 
-  // 6f. Sessionize delta
-  const sessions = sessionize(deltaLines, sessionGapHours);
+  // 6f. Sessionize delta at the fixed 8h gap (Task 902 sub-scope D).
+  const sessions = sessionize(deltaLines, SESSION_GAP_HOURS);
   log(
-    `sessionize source=${source} archiveSha256=${archiveSha256.slice(0, 12)} messages=${deltaLines.length} sessions=${sessions.length} gap-hours=${sessionGapHours}`,
+    `sessionize source=${source} archiveSha256=${archiveSha256.slice(0, 12)} messages=${deltaLines.length} sessions=${sessions.length} gap-hours=${SESSION_GAP_HOURS}`,
   );
 
+  // Task 902 sub-scope A — compute the stable archive title once, before
+  // the per-session loop. The title is `<source> · <owner> ↔ <others> ·
+  // <YYYY-MM-DD>→<YYYY-MM-DD>`. Operator-confirmed participant names come
+  // from one Cypher hop; absent canonical names fall back to elementId
+  // prefixes so the migration's degraded-title path mirrors live behaviour.
+  const archiveTitle = await computeArchiveTitle({
+    source,
+    accountId,
+    ownerElementId,
+    participantElementIds,
+    firstMessageAt: allLines[0].dateSent,
+    lastMessageAt: allLines[allLines.length - 1].dateSent,
+    getSession,
+  });
+  log(`archive-title=${archiveTitle}`);
+
   // 6g. Per-session classify + immediate memoryIngest (Task 900 sub-scope E).
   // Each session commits atomically: chunks + cursor advance happen together
   // via memoryIngest. A kill mid-loop leaves a partial archive whose cursor
@@ -621,7 +766,6 @@ async function main() {
       body: lastSessionLine.body,
     });
     const sessionLastAt = lastSessionLine.dateSent;
-    const sessionDocumentSummary = `Session ${s.index + 1}/${sessions.length}: ${s.messages.length} messages, ${sessionChunks.length} chunks.`;
 
     let ingestResult;
     const ingestStart = Date.now();
@@ -631,7 +775,13 @@ async function main() {
         attachmentId: conversationIdentity,
         parentLabel: "ConversationArchive",
         source,
-        documentSummary: sessionDocumentSummary,
+        // Task 902 sub-scope A — `archiveTitle` is the stable label written
+        // to `:ConversationArchive.title` (UI prefers it over `summary`).
+        // `documentSummary` is also the stable title rather than the
+        // per-session counter that previously locked the parent's first
+        // checkpoint into "Session 1/N: …".
+        archiveTitle,
+        documentSummary: archiveTitle,
         anchorNodeId: ownerElementId,
         anchorLabel: "AdminUser",
         sections: sessionChunks,
@@ -643,11 +793,11 @@ async function main() {
         lastIngestedMessageHash: sessionLastHash,
         lastIngestedMessageAt: sessionLastAt,
         participantElementIds: [ownerElementId, ...participantElementIds],
-        // First session of THIS run cleans prior chunks for matching
-        // archiveSha256 (re-run-with-same-bytes idempotency); subsequent
-        // sessions in the same run skip cleanup or they would delete the
-        // chunks just written by sessions above them.
-        cleanupPriorChunks: isFirstSessionInRun,
+        // Task 902 sub-scope B — cleanup-by-archiveSha256 runs ONLY under
+        // `--rebuild`, AND only on the first session of the run (subsequent
+        // sessions skip cleanup or they would delete chunks the earlier
+        // sessions in the same run just wrote).
+        cleanupPriorChunks: rebuild && isFirstSessionInRun,
       });
     } catch (err) {
       cleanup();
@@ -663,10 +813,32 @@ async function main() {
     totalNextEdges += ingestResult.edgeBreakdown.NEXT ?? 0;
     if (isFirstSessionInRun) {
       participantsLinked = ingestResult.edgeBreakdown.PARTICIPANT_IN ?? 0;
+      // Task 902 sub-scope E — surface destructive cleanup as a WARN line in
+      // the progress sink (not just memory-ingest's stderr). The agent's
+      // heartbeat grep-matches this exact prefix and elevates to operator
+      // chat. Cleanup only ever fires under `--rebuild` per sub-scope B,
+      // so seeing the line outside of an operator-issued `--rebuild` is a
+      // doctrine violation worth surfacing loudly.
+      const cleaned = ingestResult.cleanedPriorChunks ?? 0;
+      if (cleaned > 0) {
+        log(
+          `WARN cleanup-dropped chunks=${cleaned} archiveSha256=${archiveSha256.slice(0, 12)} — prior data deleted, expected only under --rebuild`,
+        );
+      }
     }
     log(
       `session-committed sessionIndex=${s.index + 1}/${sessions.length} chunks-written=${ingestResult.sectionCount} cursor-at="${sessionLastAt}" ms=${Date.now() - ingestStart}`,
     );
+    // Task 902 sub-scope F — derived progress line. The agent's heartbeat
+    // surfaces only `progress` lines as chat tokens; raw `classify-session`
+    // and `session-committed` lines remain on disk for diagnosis. The render
+    // is computed in the bin (deterministic) instead of in SKILL.md prose
+    // (LLM drift) — sessionIndex/N → P% with running totals comes from one
+    // place, not from per-tick agent arithmetic.
+    const pct = Math.round((100 * (s.index + 1)) / sessions.length);
+    log(
+      `progress sessionIndex=${s.index + 1}/${sessions.length} pct=${pct} chunks-so-far=${totalChunksWritten} elapsed-ms=${Date.now() - startedMs}`,
+    );
   }
 
   if (sessionsUnenriched > 0) {

package/payload/platform/plugins/memory/bin/conversation-archive-ingest.sh

@@ -18,11 +18,14 @@
 #         --source <whatsapp|telegram|signal|linkedin-messages|zoom-transcript|meeting-minutes|imessage|slack|other>
 #         --participant-person-ids <csv>
 #         --scope <admin|public>
-#         [--session-gap-hours <N>]    (default 12)
+#         [--rebuild]                  (Task 902 — opt-in destructive rebuild)
 #         [--timezone <iana-zone>]
 #         [--date-format <DD/MM/YY|MM/DD/YY|DD/MM/YYYY|MM/DD/YYYY>]   (whatsapp only)
 #         [--session-id <id>]
 #
+# Sessions split deterministically at 8h gap (fixed code constant — Task 902).
+# `--session-gap-hours` is REMOVED; passing it FAILs at phase=argv.
+#
 # Identity (Task 900): `ACCOUNT_ID` + `USER_ID` come from the caller's env
 # (plumbed by `spawn-env.ts` into every Bash subprocess). The owner :AdminUser
 # elementId is derived from (accountId, userId) inside the bin via Cypher.
@@ -82,7 +85,9 @@ while [ $i -lt ${#ARGS[@]} ]; do
     --participant-person-ids)  HAS_PARTICIPANTS=1; PARTICIPANTS_VAL="${ARGS[$((i + 1))]:-}"; i=$((i + 2)); continue ;;
     --scope)                   HAS_SCOPE=1;        SCOPE_VAL="${ARGS[$((i + 1))]:-}";        i=$((i + 2)); continue ;;
     --session-id)              SESSION_ID_VAL="${ARGS[$((i + 1))]:-}";                       i=$((i + 2)); continue ;;
-    --session-gap-hours|--timezone|--date-format) i=$((i + 2)); continue ;;
+    --rebuild)                 i=$((i + 1)); continue ;;
+    --session-gap-hours)       arg_fail "--session-gap-hours is no longer supported; gap is fixed at 8h. Use --rebuild on the prior export bytes if you need to re-classify." ;;
+    --timezone|--date-format)  i=$((i + 2)); continue ;;
     --*)                       i=$((i + 2)); continue ;;
     *)
       if [ -z "$ARCHIVE" ]; then ARCHIVE="$a"; fi

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/llm-classifier.test.js

@@ -139,6 +139,81 @@ test("Task 891: classifyDocument logs `mode=` for grep parity", () => {
     const source = readClassifier();
     assert.match(source, /\[memory-classify\][^\n]*calling haiku[^\n]*mode=/, "calling-haiku log line must include `mode=<document|chat>` for grep parity");
 });
+// ---------------------------------------------------------------------------
+// Task 898 — classifier + ranker structured tool-use migration.
+//
+// The classifier and ranker now force Haiku to emit `tool_use.input` matching
+// a typed `input_schema`. The migration deletes `extractJson` (used to strip
+// markdown fences from a free-form text response) and the malformed-JSON
+// fallback path entirely — Anthropic enforces the schema at the API boundary,
+// so structural failures (missing fields, wrong types, truncation mid-tool-input)
+// surface as fallback responses or as the existing missing-offsets loud-fail.
+//
+// These tests grep source so a future refactor that reverts to free-form text
+// re-fails the test suite on `main` pre-fix.
+// ---------------------------------------------------------------------------
+const RANKER_PATH = resolve(PACKAGE_ROOT, "src/lib/llm-ranker.ts");
+function readRanker() {
+    return readFileSync(RANKER_PATH, "utf-8");
+}
+test("Task 898: classifier defines a ClassifierOutputTool with input_schema", () => {
+    const source = readClassifier();
+    assert.match(source, /ClassifierOutputTool[\s\S]{0,200}name:\s*["']emit_classifier_output["']/, "classifier must export a ClassifierOutputTool whose name is 'emit_classifier_output'");
+    assert.match(source, /ClassifierOutputTool[\s\S]*?input_schema/, "ClassifierOutputTool must declare an input_schema");
+});
+test("Task 898: classifier call site forces tool selection", () => {
+    const source = readClassifier();
+    const callMatch = source.match(/callOauthLlm\(\{[\s\S]*?\}\)/);
+    assert.ok(callMatch, "expected to find callOauthLlm({...}) call site");
+    assert.match(callMatch[0], /tools:\s*\[ClassifierOutputTool\]/, "classifier MUST pass `tools: [ClassifierOutputTool]` so Haiku emits structured output");
+    assert.match(callMatch[0], /toolChoiceName:\s*ClassifierOutputTool\.name/, "classifier MUST force the tool by name — Anthropic only validates the schema when forced");
+});
+test("Task 898: classifier `kind` schema is enforced as an enum (closed enumeration)", () => {
+    const source = readClassifier();
+    // The schema must declare `kind` with an `enum` whose membership is sourced
+    // from ALL_SECTION_KINDS. We check the structural shape rather than the
+    // exact list — the list is exported and tested elsewhere.
+    assert.match(source, /kind:\s*\{\s*type:\s*["']string["'],\s*enum:\s*ALL_SECTION_KINDS_LIST/, "ClassifierOutputTool.input_schema must enforce `kind` as an enum sourced from ALL_SECTION_KINDS — schema-level enforcement is what makes hallucinated kinds impossible");
+});
+test("Task 898: classifier no longer references extractJson (dead code removed)", () => {
+    const source = readClassifier();
+    assert.doesNotMatch(source, /extractJson/, "extractJson is unreachable on the structured-output path and was deleted; reintroducing it is the regression");
+});
+test("Task 898: classifier no longer collapses unknown kinds to Other (unreachable on structured path)", () => {
+    const source = readClassifier();
+    // The pre-Task-898 collapse used `isKnownKind ? rawKind : SECTION_KIND_OTHER`.
+    // With a strict schema enum on `kind`, the collapse is unreachable. The
+    // variable name is the load-bearing fingerprint of the dead branch.
+    assert.doesNotMatch(source, /isKnownKind/, "the `isKnownKind` collapse is dead code on the structured path; reintroducing it weakens the schema-as-enforcement contract");
+});
+test("Task 898: classifier emits `structured-output ok` log line per call", () => {
+    const source = readClassifier();
+    assert.match(source, /\[memory-classify\][^\n]*structured-output ok[^\n]*stop-reason=/, "classifier must log `structured-output ok stop-reason=...` per call so observability names the structured path");
+});
+test("Task 898: ranker defines a RankerOutputTool with input_schema", () => {
+    const source = readRanker();
+    assert.match(source, /RankerOutputTool[\s\S]{0,200}name:\s*["']emit_ranker_output["']/, "ranker must export a RankerOutputTool whose name is 'emit_ranker_output'");
+    assert.match(source, /RankerOutputTool[\s\S]*?input_schema/, "RankerOutputTool must declare an input_schema");
+});
+test("Task 898: ranker call site forces tool selection", () => {
+    const source = readRanker();
+    const callMatch = source.match(/callOauthLlm\(\{[\s\S]*?\}\)/);
+    assert.ok(callMatch, "expected to find callOauthLlm({...}) call site");
+    assert.match(callMatch[0], /tools:\s*\[RankerOutputTool\]/, "ranker MUST pass `tools: [RankerOutputTool]`");
+    assert.match(callMatch[0], /toolChoiceName:\s*RankerOutputTool\.name/, "ranker MUST force the tool by name");
+});
+test("Task 898: ranker no longer references extractJson", () => {
+    const source = readRanker();
+    assert.doesNotMatch(source, /extractJson/, "extractJson is unreachable on the structured-output path and was deleted");
+});
+test("Task 898: ranker no longer parses JSON.parse on response text", () => {
+    const source = readRanker();
+    assert.doesNotMatch(source, /JSON\.parse\(jsonText\)/, "structured tool-use returns a typed object — JSON.parse on response text is dead code");
+});
+test("Task 898: ranker emits `structured-output ok` log line per call", () => {
+    const source = readRanker();
+    assert.match(source, /\[memory-rank\][^\n]*structured-output ok[^\n]*stop-reason=/, "ranker must log `structured-output ok stop-reason=...` per call");
+});
 test("Task 781 fixture is still >=10K chars (regression anchor)", () => {
     // The fixture is named in the brief so the same evidence shape can be
     // re-run on demand. If it ever shrinks below 10K, this test fails loud

package/payload/platform/plugins/memory/mcp/dist/lib/__tests__/llm-classifier.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-classifier.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/llm-classifier.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"llm-classifier.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/llm-classifier.test.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/memory/mcp/dist/lib/llm-classifier.d.ts

@@ -14,14 +14,18 @@
  * the Anthropic API key. The API-key path is reserved for the public
  * agent.
  *
- * Hallucination defence: every returned `kind` is verified against the
- * loaded ontology label set. Sections whose `kind` is not a real label
- * are tagged `UNMAPPED`. Failure of the LLM call (missing creds, network,
- * malformed JSON) returns `{kind: "error", reason}` (Task 897 vocabulary
- * — was `kind: "fallback"`). The caller decides whether to abort the
- * ingest or degrade-on-error per session; classifier never silently
- * substitutes a degraded write.
+ * Hallucination defence: section `kind` is enforced as a closed enum in
+ * `ClassifierOutputTool.input_schema`, so a hallucinated kind cannot reach
+ * this module — Anthropic rejects the tool_use input at the API boundary.
+ * For `related[].kind` and `documentEdges[].targetKind` (which the static
+ * schema cannot constrain because the live ontology label set is a runtime
+ * input), the post-validator drops any label not in `ontologyLabels`.
+ * Failure of the LLM call (missing creds, network, schema-violating
+ * `tool_use.input`) returns `{kind: "error", reason}`. The caller decides
+ * whether to abort the ingest or degrade-on-error per session; classifier
+ * never silently substitutes a degraded write.
  */
+import { type OauthLlmTool } from "../../../../../lib/oauth-llm/dist/index.js";
 /** Direction of the anchor edge relative to the typed node. */
 export type AnchorEdgeDirection = "from-anchor" | "to-anchor";
 /** Direction of a related-node edge relative to the typed node. */
@@ -166,9 +170,10 @@ export type ClassifyResult = {
 };
 /**
  * Closed enumeration of section `kind` values. Each becomes a secondary
- * label on the `:Section` node (e.g. `:Section:Position`). Anything outside
- * this list collapses to `Other` (the writer stamps the classifier's
- * one-line reason on `:Section:Other.classifierReason` for ontology growth).
+ * label on the `:Section` node (e.g. `:Section:Position`). The `kind` field
+ * is enforced as an `enum` in `ClassifierOutputTool.input_schema`, so a
+ * hallucinated kind cannot reach the post-validator — Anthropic rejects the
+ * tool_use input at the API boundary (Task 898).
  *
  * Source of truth: schema-base.md "Section kinds" table. Changes here MUST
  * be mirrored there or the validator will reject the secondary label.
@@ -180,6 +185,7 @@ export declare const CONTRACT_SECTION_KINDS: readonly ["Parties", "Recitals", "D
 /** Standalone (non-Section) node kind the classifier may emit per section. */
 export declare const STANDALONE_NODE_KINDS: readonly ["Project"];
 export declare const ALL_SECTION_KINDS: ReadonlySet<string>;
+export declare const ClassifierOutputTool: OauthLlmTool;
 export interface ClassifyParams {
     /** Account scope, for log prefixing. */
     accountId: string;

package/payload/platform/plugins/memory/mcp/dist/lib/llm-classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-classifier.d.ts","sourceRoot":"","sources":["../../src/lib/llm-classifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"llm-classifier.d.ts","sourceRoot":"","sources":["../../src/lib/llm-classifier.ts"],"names":[],"mappings":"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"}