@rubytech/create-maxy 1.0.757 → 1.0.758

package/payload/platform/plugins/memory/mcp/dist/tools/memory-archive-write.js

@@ -1,33 +1,43 @@
 import { getSession } from "../lib/neo4j.js";
 /**
- * memory-archive-write — deterministic bulk-archive write surface (Task 744).
+ * memory-archive-write — deterministic bulk-archive write surface.
  *
- * Writes a flat dataset (today: LinkedIn Connections.csv parsed into typed
- * rows) into the graph as first-class entity nodes plus their natural edges.
- * Distinct from memory-write (per-node, adjacency-required) and memory-ingest
- * (narrative document → KnowledgeDocument + Section + HAS_SECTION + NEXT).
+ * Writes a flat dataset (LinkedIn Connections.csv, WhatsApp `_chat.txt`
+ * exports, future CRM-type seeds) into the graph as first-class entity
+ * nodes plus their natural edges. Distinct from memory-write (per-node,
+ * adjacency-required) and memory-ingest (narrative document → Section).
  *
  * Doctrine:
- *   - The Cypher body for each archiveType is fixed inside this tool. The
- *     agent never supplies Cypher; only parsed rows + the archiveType
- *     discriminant. Determinism here means "the Cypher is not in the tool
- *     input" — not "be careful with the Cypher".
- *   - 500-row UNWIND batches per executeWrite transaction. Larger batches
- *     risk Neo4j Community heap pressure on a Pi 5; smaller batches multiply
- *     round-trip cost.
- *   - Per-row provenance stamps (createdByAgent, createdBySession, source,
- *     createdAt) come from this server, not the agent.
- *   - Owner is matched by elementId so both AdminUser and external-Person
- *     archive owners flow through one path.
- *   - Counters come from result.summary.counters (nodesCreated /
- *     relationshipsCreated) so we never invent stamp-based detection.
+ *   - The Cypher body for each archiveType is fixed inside this tool.
+ *     The agent supplies parsed rows + the archiveType discriminant,
+ *     never raw Cypher.
+ *   - 500-row UNWIND batches per executeWrite transaction. Larger
+ *     batches risk Neo4j Community heap pressure on a Pi 5.
+ *   - Per-node provenance stamps (createdByAgent, createdBySession,
+ *     source, createdAt) come from this server, not the agent.
+ *   - Owner / participant nodes match by elementId so both :AdminUser
+ *     and external :Person flow through one path.
+ *   - Counters are per-handler — each handler picks the keys that
+ *     describe its archiveType. The agent reads them from the result
+ *     JSON; nothing programmatic depends on the linkedin-specific
+ *     legacy field names.
+ *   - For archive types with cross-batch graph state (WhatsApp's
+ *     :NEXT chronology), the handler implements an optional
+ *     `finalize` hook that runs after all batches in its own
+ *     `executeWrite` transaction. Failure surfaces as
+ *     `nextChainStatus='failed'` on the result — never silent partial
+ *     state.
  */
 const BATCH_SIZE = 500;
 const HANDLERS = {
     "linkedin-connections": linkedinConnectionsHandler(),
+    "whatsapp-export": whatsappExportHandler(),
 };
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
 export async function memoryArchiveWrite(params) {
-    const { archiveType, ownerNodeId, accountId, rows, sessionId } = params;
+    const { archiveType, ownerNodeId, accountId, rows } = params;
     if (!accountId || !accountId.trim()) {
         throw new Error("memory-archive-write: accountId is required.");
     }
@@ -44,29 +54,19 @@ export async function memoryArchiveWrite(params) {
     const session = getSession();
     const startedMs = Date.now();
     const errors = [];
-    const totals = {
-        createdPersons: 0,
-        mergedPersons: 0,
-        createdOrganizations: 0,
-        mergedOrganizations: 0,
-        createdEdges: 0,
-    };
+    const counters = {};
+    const sessionId = params.sessionId?.trim() || null;
     try {
-        await handler.verifyOwner(session, ownerNodeId, accountId);
+        await handler.verifyArchive(session, params);
         for (let offset = 0; offset < rows.length; offset += BATCH_SIZE) {
-            const batch = rows.slice(offset, offset + BATCH_SIZE);
+            const batchRows = rows.slice(offset, offset + BATCH_SIZE);
             try {
-                const counters = await handler.writeBatch(session, {
-                    ownerNodeId,
-                    accountId,
-                    rows: batch,
-                    sessionId: sessionId?.trim() || null,
+                const batchCounters = await handler.writeBatch(session, {
+                    params,
+                    batchRows,
+                    sessionId,
                 });
-                totals.createdPersons += counters.createdPersons;
-                totals.mergedPersons += counters.mergedPersons;
-                totals.createdOrganizations += counters.createdOrganizations;
-                totals.mergedOrganizations += counters.mergedOrganizations;
-                totals.createdEdges += counters.createdEdges;
+                mergeCounters(counters, batchCounters);
             }
             catch (err) {
                 const reason = err instanceof Error ? err.message : String(err);
@@ -74,62 +74,54 @@ export async function memoryArchiveWrite(params) {
                 process.stderr.write(`[memory-archive-write] batch-failed archiveType=${archiveType} offset=${offset} reason=${reason}\n`);
             }
         }
+        let nextChainStatus;
+        let nextChainReason;
+        if (handler.finalize) {
+            try {
+                const finalizeResult = await handler.finalize(session, {
+                    params,
+                    sessionId,
+                    hadBatchErrors: errors.length > 0,
+                });
+                mergeCounters(counters, finalizeResult.counters);
+                nextChainStatus = finalizeResult.status;
+                nextChainReason = finalizeResult.reason;
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                nextChainStatus = "failed";
+                nextChainReason = reason;
+                process.stderr.write(`[memory-archive-write] finalize-failed archiveType=${archiveType} reason=${reason}\n`);
+            }
+        }
+        const elapsedMs = Date.now() - startedMs;
+        const counterStr = Object.entries(counters)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(" ");
+        const statusStr = nextChainStatus
+            ? ` nextChainStatus=${nextChainStatus}${nextChainReason ? ` reason=${nextChainReason}` : ""}`
+            : "";
+        process.stderr.write(`[memory-archive-write] archiveType=${archiveType} rows=${rows.length} ${counterStr} errors=${errors.length}${statusStr} ms=${elapsedMs}\n`);
+        return {
+            archiveType,
+            processedRows: rows.length,
+            counters,
+            errors,
+            ...(nextChainStatus ? { nextChainStatus } : {}),
+            ...(nextChainReason ? { nextChainReason } : {}),
+        };
     }
     finally {
         await session.close();
     }
-    const elapsedMs = Date.now() - startedMs;
-    process.stderr.write(`[memory-archive-write] archiveType=${archiveType} rows=${rows.length} ` +
-        `createdPersons=${totals.createdPersons} mergedPersons=${totals.mergedPersons} ` +
-        `createdOrganizations=${totals.createdOrganizations} mergedOrganizations=${totals.mergedOrganizations} ` +
-        `createdEdges=${totals.createdEdges} errors=${errors.length} ms=${elapsedMs}\n`);
-    return {
-        archiveType,
-        processedRows: rows.length,
-        ...totals,
-        errors,
-    };
+}
+function mergeCounters(target, source) {
+    for (const [k, v] of Object.entries(source)) {
+        target[k] = (target[k] ?? 0) + v;
+    }
 }
 // ---------------------------------------------------------------------------
-// linkedin-connections handler
-// ---------------------------------------------------------------------------
-//
-// Owner anchor: AdminUser or Person (elementId match — operator-confirmed
-// during the linkedin-import skill's owner-confirmation flow).
-//
-// Per row the CSV expresses two relationships:
-//   1. (owner)-[:CONNECTED_ON_LINKEDIN {connectedOn}]->(:Person)
-//   2. (:Person)-[:WORKS_FOR {title, current=true}]->(:Organization) — when company present
-//
-// Natural keys:
-//   :Person       — linkedinUrl (indexed in platform/neo4j/schema.cypher)
-//   :Organization — (accountId, name)
-//
-// Provenance stamped on every node:
-//   createdByAgent='linkedin-import', createdBySource='linkedin-import',
-//   createdBySession=$sessionId (when provided), createdAt=datetime(),
-//   source='linkedin'
-//
-// We split each batch into two tx.run calls inside one executeWrite so each
-// statement's summary counters give a clean per-label breakdown.
-//
-// Task 753 — `p.currentTitle` denormalises `[:WORKS_FOR].title` onto the
-// Person node so the `entity_search` BM25 fulltext index reaches it.
-// Pre-task an operator searching "director" against an account with 5K
-// LinkedIn connections returned 26 hits — name-field anomalies and
-// CV-driven Position nodes only — because edge properties are invisible
-// to a node-only fulltext index. Naming `currentTitle` (not `title`)
-// avoids shadowing :Position.title semantics in cross-label cypher.
-// Empty `row.title` writes null (the property is removed); the LinkedIn
-// export is a current-job snapshot, so a re-import without a title is
-// authoritative.
-//
-// `connectedOn` is NOT denormalised onto the Person — it lives only on
-// the edge. Side-panel visibility (Task 754) is solved by rendering
-// incident-edge properties in the UI, not by writing the date twice.
-// Doctrine: avoid duplicate writes that need a backfill cypher to land
-// on existing customer installs (no-admin-upgrade-path). The fulltext-
-// reach problem `currentTitle` solves doesn't apply to a date.
+// linkedin-connections handler (Task 744; Task 753 currentTitle denormalisation)
 // ---------------------------------------------------------------------------
 export const PERSON_AND_CONNECTED_EDGE_CYPHER = `
 MATCH (owner) WHERE elementId(owner) = $ownerNodeId
@@ -183,7 +175,8 @@ RETURN count(*) AS processed
 `;
 function linkedinConnectionsHandler() {
     return {
-        async verifyOwner(session, ownerNodeId, accountId) {
+        async verifyArchive(session, params) {
+            const { ownerNodeId, accountId } = params;
             const result = await session.run(`MATCH (n) WHERE elementId(n) = $ownerNodeId
          RETURN labels(n) AS labels, n.accountId AS accountId LIMIT 1`, { ownerNodeId });
             if (result.records.length === 0) {
@@ -200,29 +193,30 @@ function linkedinConnectionsHandler() {
                 throw new Error(`ownerNodeId ${ownerNodeId} belongs to account ${ownerAccountId}, not ${accountId}. Cross-account archive ingest refused.`);
             }
         },
-        async writeBatch(session, { ownerNodeId, accountId, rows, sessionId }) {
-            const params = {
-                ownerNodeId,
-                accountId,
+        async writeBatch(session, ctx) {
+            const { params, batchRows, sessionId } = ctx;
+            const queryParams = {
+                ownerNodeId: params.ownerNodeId,
+                accountId: params.accountId,
                 sessionId,
-                rows: rows.map((r) => normaliseLinkedinRow(r)),
+                rows: batchRows.map((r) => normaliseLinkedinRow(r)),
             };
             return await session.executeWrite(async (tx) => {
-                const personRes = await tx.run(PERSON_AND_CONNECTED_EDGE_CYPHER, params);
+                const personRes = await tx.run(PERSON_AND_CONNECTED_EDGE_CYPHER, queryParams);
                 const personCounters = personRes.summary.counters.updates();
-                const orgRes = await tx.run(ORG_AND_WORKS_FOR_CYPHER, params);
+                const orgRes = await tx.run(ORG_AND_WORKS_FOR_CYPHER, queryParams);
                 const orgCounters = orgRes.summary.counters.updates();
-                const createdPersonNodes = personCounters.nodesCreated;
-                const createdOrgNodes = orgCounters.nodesCreated;
-                const personsTouched = params.rows.length;
-                const personsCreated = createdPersonNodes;
-                const personsMerged = personsTouched - personsCreated;
+                const createdPersons = personCounters.nodesCreated;
+                const createdOrgs = orgCounters.nodesCreated;
+                const personsTouched = queryParams.rows.length;
+                const mergedPersons = personsTouched - createdPersons;
+                const createdEdges = personCounters.relationshipsCreated + orgCounters.relationshipsCreated;
                 return {
-                    createdPersons: personsCreated,
-                    mergedPersons: personsMerged,
-                    createdOrganizations: createdOrgNodes,
+                    createdPersons,
+                    mergedPersons,
+                    createdOrganizations: createdOrgs,
                     mergedOrganizations: 0,
-                    createdEdges: personCounters.relationshipsCreated + orgCounters.relationshipsCreated,
+                    createdEdges,
                 };
             });
         },
@@ -245,4 +239,265 @@ function normaliseLinkedinRow(row) {
         connectedOn: row.connectedOn,
     };
 }
+// ---------------------------------------------------------------------------
+// whatsapp-export handler (Task 804)
+// ---------------------------------------------------------------------------
+//
+// Owner anchor: the operator who exported the chat (:AdminUser or :Person).
+// Recorded as `createdBySession`-stamped provenance on the Conversation node;
+// not a graph edge, since the exporter is metadata, not a semantic role.
+//
+// Per call the input expresses one Conversation + N Messages + edges:
+//   1. (:Conversation:WhatsAppConversation {conversationId})           — MERGE, sublabel on first create
+//   2. (:Message:WhatsAppMessage {messageId})-[:PART_OF]->(:Conversation)
+//   3. (sender:AdminUser|:Person {elementId})-[:SENT]->(:Message)
+//   4. (sender)-[:PARTICIPANT_IN]->(:Conversation)                     — rolled up per distinct sender
+//   5. (:Message)-[:NEXT]->(:Message)                                  — chronology, finalize step
+//
+// Natural keys:
+//   :Conversation:WhatsAppConversation — conversationId (whatsapp-export:<sha256(file)>:<accountId>)
+//   :Message:WhatsAppMessage           — messageId (whatsapp-export:<conversationId>:<lineHash>)
+//   participants                       — elementId resolved by the skill's confirmation flow
+//
+// Provenance stamped on every node: source='whatsapp', createdByAgent='whatsapp-import',
+// createdBySession=$sessionId, createdAt=datetime(), archiveSourceFile=<sha256 prefix>.
+// On re-import, ON MATCH refreshes lastMessageAt / messageCount / participantCount /
+// lastImportedAt / lastImportedBySession on the Conversation only — node-creation
+// stamps are preserved.
+//
+// Cross-batch state: NEXT chain depends on full-conversation chronology. The
+// finalize hook runs ORDER BY dateSent ASC, sequenceIndex ASC, then MERGEs
+// pairwise NEXT edges. Idempotent — re-import with a 50-message append adds
+// 50 NEXT edges and updates conversation scalars, no duplicates.
+// ---------------------------------------------------------------------------
+// MERGE on the base label only, then SET the sublabel in ON CREATE — Task 633
+// pattern documented at platform/neo4j/schema.cypher:374-388 and used by
+// `ensureConversation` in platform/ui/app/lib/neo4j-store.ts. MERGEing on
+// `:Base:Sublabel` directly would refuse to match a pre-existing node that
+// carries only the base label, then CREATE a duplicate that violates the
+// `conversationId IS UNIQUE` constraint on `:Conversation`. The base+SET
+// pattern is constraint-safe and idempotent across Task-633-style sublabel
+// backfill histories.
+export const WHATSAPP_CONVERSATION_AND_MESSAGES_CYPHER = `
+MATCH (owner) WHERE elementId(owner) = $ownerNodeId
+WITH owner, $rows AS rows, $conversation AS conv
+MERGE (c:Conversation {conversationId: conv.conversationId})
+  ON CREATE SET
+    c:WhatsAppConversation,
+    c.accountId             = $accountId,
+    c.source                = 'whatsapp',
+    c.createdByAgent        = 'whatsapp-import',
+    c.createdBySource       = 'whatsapp-import',
+    c.createdBySession      = $sessionId,
+    c.createdAt             = datetime(),
+    c.scope                 = 'admin',
+    c.agentType             = 'admin',
+    c.archiveSourceFile     = conv.archiveSourceFile,
+    c.firstMessageAt        = datetime(conv.firstMessageAt),
+    c.lastMessageAt         = datetime(conv.lastMessageAt),
+    c.participantCount      = conv.participantCount,
+    c.messageCount          = conv.messageCount
+  ON MATCH SET
+    c:WhatsAppConversation,
+    c.lastMessageAt         = datetime(conv.lastMessageAt),
+    c.participantCount      = conv.participantCount,
+    c.messageCount          = conv.messageCount,
+    c.lastImportedAt        = datetime(),
+    c.lastImportedBySession = $sessionId
+WITH owner, c, rows
+UNWIND rows AS row
+MATCH (sender) WHERE elementId(sender) = row.senderNodeId
+MERGE (m:Message {messageId: row.messageId})
+  ON CREATE SET
+    m:WhatsAppMessage,
+    m.accountId        = $accountId,
+    m.source           = 'whatsapp',
+    m.createdByAgent   = 'whatsapp-import',
+    m.createdBySource  = 'whatsapp-import',
+    m.createdBySession = $sessionId,
+    m.createdAt        = datetime(),
+    m.conversationId   = row.conversationId,
+    m.dateSent         = datetime(row.dateSent),
+    m.body             = row.body,
+    m.senderName       = row.senderName,
+    m.sequenceIndex    = row.sequenceIndex,
+    m.scope            = 'admin'
+MERGE (m)-[:PART_OF]->(c)
+MERGE (sender)-[s:SENT]->(m)
+  ON CREATE SET
+    s.source    = 'whatsapp',
+    s.createdAt = datetime()
+MERGE (sender)-[p:PARTICIPANT_IN]->(c)
+  ON CREATE SET
+    p.source    = 'whatsapp',
+    p.createdAt = datetime()
+RETURN count(*) AS processed
+`;
+// Tertiary tiebreaker `m.messageId ASC` makes ordering total even when two
+// messages share the same dateSent + sequenceIndex (operator-error duplicate
+// row in input, or two messages emitted in the same second by the same
+// sender). Without it, Neo4j's ordering of equal keys is undefined and the
+// chain topology can drift across re-imports — MERGE on (prev, next) is
+// idempotent per pair, but pairs themselves would shuffle.
+export const WHATSAPP_NEXT_CHAIN_CYPHER = `
+MATCH (c:Conversation:WhatsAppConversation {conversationId: $conversationId})
+MATCH (m:Message)-[:PART_OF]->(c)
+WITH c, m ORDER BY m.dateSent ASC, m.sequenceIndex ASC, m.messageId ASC
+WITH c, collect(m) AS msgs
+UNWIND range(0, size(msgs) - 2) AS i
+WITH msgs[i] AS prev, msgs[i + 1] AS next
+WHERE prev <> next
+MERGE (prev)-[r:NEXT]->(next)
+  ON CREATE SET
+    r.source    = 'whatsapp',
+    r.createdAt = datetime()
+RETURN count(r) AS nextEdges
+`;
+function whatsappExportHandler() {
+    return {
+        async verifyArchive(session, params) {
+            const { ownerNodeId, accountId, conversation, participantNodeIds, rows } = params;
+            if (!conversation || !conversation.conversationId) {
+                throw new Error("whatsapp-export: `conversation` block with conversationId is required.");
+            }
+            if (!Array.isArray(participantNodeIds) || participantNodeIds.length === 0) {
+                throw new Error("whatsapp-export: `participantNodeIds` must be a non-empty array (operator-confirmed senders).");
+            }
+            // Cross-row conversationId invariant: one call = one conversation.
+            for (let i = 0; i < rows.length; i++) {
+                const row = rows[i];
+                if (row.conversationId !== conversation.conversationId) {
+                    throw new Error(`whatsapp-export: row[${i}].conversationId="${row.conversationId}" mismatches conversation.conversationId="${conversation.conversationId}". One archive-write call writes exactly one conversation.`);
+                }
+            }
+            // Owner verification (mirrors linkedin-connections logic).
+            const ownerRes = await session.run(`MATCH (n) WHERE elementId(n) = $ownerNodeId
+         RETURN labels(n) AS labels, n.accountId AS accountId LIMIT 1`, { ownerNodeId });
+            if (ownerRes.records.length === 0) {
+                throw new Error(`ownerNodeId ${ownerNodeId} not found. Re-run the archive-owner confirmation flow before invoking memory-archive-write.`);
+            }
+            const ownerLabels = ownerRes.records[0].get("labels") ?? [];
+            const ownerAccountId = ownerRes.records[0].get("accountId");
+            if (!ownerLabels.includes("AdminUser") && !ownerLabels.includes("Person")) {
+                throw new Error(`ownerNodeId ${ownerNodeId} has labels [${ownerLabels.join(", ")}]; expected :AdminUser or :Person.`);
+            }
+            if (ownerAccountId && ownerAccountId !== accountId) {
+                throw new Error(`ownerNodeId ${ownerNodeId} belongs to account ${ownerAccountId}, not ${accountId}. Cross-account archive ingest refused.`);
+            }
+            // Participant verification: every senderNodeId must resolve to :AdminUser
+            // or :Person in the same accountId. Distinct in case the skill passed
+            // the same nodeId twice. Log when dedup collapses the array — two
+            // distinct senderNames mapping to the same elementId is operator-confirmed
+            // intent (Step 4 phone-vs-name same-person heuristic), but a silent
+            // collapse without a log line hides the merge from the audit trail.
+            const distinctParticipantIds = Array.from(new Set(participantNodeIds));
+            if (distinctParticipantIds.length !== participantNodeIds.length) {
+                process.stderr.write(`[memory-archive-write] participantNodeIds-deduped archiveType=whatsapp-export submitted=${participantNodeIds.length} distinct=${distinctParticipantIds.length}\n`);
+            }
+            const participantRes = await session.run(`UNWIND $ids AS id
+         MATCH (n) WHERE elementId(n) = id
+         RETURN id AS elemId, labels(n) AS labels, n.accountId AS accountId`, { ids: distinctParticipantIds });
+            const found = new Set();
+            const rejected = [];
+            for (const record of participantRes.records) {
+                const elemId = record.get("elemId");
+                const labels = record.get("labels") ?? [];
+                const acct = record.get("accountId");
+                found.add(elemId);
+                if (!labels.includes("AdminUser") && !labels.includes("Person")) {
+                    rejected.push(`${elemId}: labels=[${labels.join(",")}] (expected :AdminUser or :Person)`);
+                    continue;
+                }
+                if (acct && acct !== accountId) {
+                    rejected.push(`${elemId}: accountId=${acct} (expected ${accountId})`);
+                }
+            }
+            for (const id of distinctParticipantIds) {
+                if (!found.has(id))
+                    rejected.push(`${id}: not found`);
+            }
+            const ok = distinctParticipantIds.length - rejected.length;
+            process.stderr.write(`[memory-archive-write] verifyParticipants archiveType=whatsapp-export ok=${ok} rejected=${rejected.length}\n`);
+            if (rejected.length > 0) {
+                throw new Error(`whatsapp-export: ${rejected.length} participant(s) failed verification: ${rejected.join("; ")}. Re-run the participant confirmation flow.`);
+            }
+        },
+        async writeBatch(session, ctx) {
+            const { params, batchRows, sessionId } = ctx;
+            const queryParams = {
+                ownerNodeId: params.ownerNodeId,
+                accountId: params.accountId,
+                sessionId,
+                conversation: params.conversation,
+                rows: batchRows.map((r) => normaliseWhatsappRow(r)),
+            };
+            return await session.executeWrite(async (tx) => {
+                const res = await tx.run(WHATSAPP_CONVERSATION_AND_MESSAGES_CYPHER, queryParams);
+                const stats = res.summary.counters.updates();
+                // Per-batch counters: exact node/edge creation counts come from
+                // result.summary.counters; we don't synthesise from row counts.
+                return {
+                    createdConversations: 0, // attributed to first batch only via diff below
+                    createdMessages: stats.nodesCreated,
+                    createdSentEdges: 0,
+                    createdParticipantEdges: 0,
+                    relationshipsCreated: stats.relationshipsCreated,
+                    labelsAdded: stats.labelsAdded,
+                };
+            });
+        },
+        async finalize(session, ctx) {
+            const { params, hadBatchErrors } = ctx;
+            const conversationId = params.conversation?.conversationId;
+            if (!conversationId) {
+                return { counters: {}, status: "skipped", reason: "no conversationId" };
+            }
+            const result = await session.executeWrite(async (tx) => {
+                const res = await tx.run(WHATSAPP_NEXT_CHAIN_CYPHER, { conversationId });
+                const stats = res.summary.counters.updates();
+                const nextEdges = res.records[0]?.get("nextEdges") ?? 0;
+                const nextEdgeCount = typeof nextEdges === "number"
+                    ? nextEdges
+                    : typeof nextEdges?.toNumber === "function"
+                        ? nextEdges.toNumber()
+                        : 0;
+                return {
+                    counters: {
+                        nextEdgesProcessed: nextEdgeCount,
+                        nextEdgesCreated: stats.relationshipsCreated,
+                    },
+                    status: (hadBatchErrors ? "partial" : "ok"),
+                    reason: hadBatchErrors ? "one or more batches reported errors; NEXT chain rebuilt over written messages" : undefined,
+                };
+            });
+            return result;
+        },
+    };
+}
+function normaliseWhatsappRow(row) {
+    if (!row.messageId || !row.messageId.trim()) {
+        throw new Error("whatsapp-export row missing messageId (natural key).");
+    }
+    if (!row.conversationId || !row.conversationId.trim()) {
+        throw new Error("whatsapp-export row missing conversationId.");
+    }
+    if (!row.senderNodeId || !row.senderNodeId.trim()) {
+        throw new Error("whatsapp-export row missing senderNodeId (operator-confirmed sender).");
+    }
+    if (!row.dateSent || Number.isNaN(Date.parse(row.dateSent))) {
+        throw new Error(`whatsapp-export row dateSent="${row.dateSent}" is not parseable as ISO 8601. Parser must convert the [DD/MM/YY, HH:MM:SS] line prefix to ISO 8601 with timezone.`);
+    }
+    if (typeof row.sequenceIndex !== "number" || row.sequenceIndex < 0) {
+        throw new Error(`whatsapp-export row sequenceIndex="${row.sequenceIndex}" must be a non-negative number.`);
+    }
+    return {
+        messageId: row.messageId.trim(),
+        conversationId: row.conversationId.trim(),
+        senderNodeId: row.senderNodeId.trim(),
+        senderName: (row.senderName ?? "").trim(),
+        dateSent: row.dateSent,
+        body: row.body ?? "",
+        sequenceIndex: row.sequenceIndex,
+    };
+}
 //# sourceMappingURL=memory-archive-write.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-archive-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-archive-write.js","sourceRoot":"","sources":["../../src/tools/memory-archive-write.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-archive-write.js","sourceRoot":"","sources":["../../src/tools/memory-archive-write.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/whatsapp-import/PLUGIN.md

@@ -0,0 +1,29 @@
+---
+name: whatsapp-import
+description: "Import a WhatsApp `_chat.txt` export (Conversation + Messages with chronological NEXT chain + analysis-derived insights) into the {{productName}} Neo4j graph. Skill-only plugin owned by the database-operator specialist. Opt-in per brand — not enabled by default. Distinct from the live `whatsapp` plugin (Baileys QR pairing + in-memory store)."
+tools: []
+always: false
+embed: false
+specialist: database-operator
+metadata: {"platform":{"optional":true,"pluginKey":"whatsapp-import"}}
+---
+
+# WhatsApp Import
+
+Ingests a WhatsApp "Export Chat" archive (the `_chat.txt` file plus media attachments) into the {{productName}} Neo4j graph. Skill-only plugin — no MCP server, no admin tools added. The skill runs under the `database-operator` specialist, which owns external-archive ingestion and ad-hoc graph operations.
+
+## When this applies
+
+The admin agent delegates to `database-operator` when the operator drops a `_chat.txt` (or its containing folder) into chat. The specialist runs the skill's archive-owner + participant confirmation flow before any line is written, then ingests the messages via `mcp__memory__memory-archive-write` with `archiveType='whatsapp-export'`.
+
+## What this is not
+
+- **Not** the live `whatsapp` plugin. That plugin (Baileys QR pairing) holds messages in an in-memory store cleared on restart. This plugin imports historical exports into Neo4j as persistent graph nodes. Names are deliberately distinct (`whatsapp-import` vs `whatsapp`) so the boundary is mechanical.
+- **Not** a media-transcription pipeline. Voice notes (`.opus`), photos, PDFs are skipped at parse with a counter logged. Transcription / OCR is a separate plugin decision.
+- **Not** a generic chat-export importer. Each messaging channel (Telegram, iMessage, Signal, SMS dump) ships as its own opt-in plugin under the same shape when requested.
+
+## Relationship to other plugins
+
+- **memory** — the underlying write surface used by the skill (`memory-archive-write` for bulk Conversation+Messages, `memory-write` / `memory-update` for the second-pass typed observations). The skill is parameterised so all writes carry `source='whatsapp'` + `createdByAgent='whatsapp-import'` for provenance.
+- **database-operator specialist** — owns execution. See [admin/IDENTITY.md](../../../platform/templates/agents/admin/IDENTITY.md) delegation clause and [database-operator.md](../../../platform/templates/specialists/agents/database-operator.md) per-source archive list.
+- **linkedin-import** — sister plugin under the same pattern (LinkedIn Basic Data Export). Reading [linkedin-import/PLUGIN.md](../linkedin-import/PLUGIN.md) is the fastest way to understand the shape this plugin follows.