@rubytech/create-realagent 1.0.838 → 1.0.840

package/payload/platform/neo4j/migrations/006-prune-bogus-whatsapp-persons.ts

@@ -1,132 +0,0 @@
-/**
- * Migration 006 — Prune bogus auto-created WhatsApp :Person nodes (Task 887).
- *
- * Sweeps the residue from pre-887 ingests where the parser miss (LRM-prefixed
- * timestamp headers — Adam Mackay archive, log
- * `claude-agent-stream-preflush-9048663e-489.log`) glued the polluted line
- * onto the previous body. The next clean header parsed its senderName off
- * the polluted body, leaking entries like
- *   "Adam Mackay:\n‎[04/02/2026, 11:52:16] Adam Mackay"
- * into `:Person {source:'whatsapp', participantStatus:'auto-created', name}`.
- * 23 leaked from one ingest of the Adam Mackay archive.
- *
- * Why a backstop, not just a writer fix: the writer fix (Task 887 §A0)
- * deletes the auto-create path entirely so the leak structurally cannot
- * recur. This migration cleans the graphs that were already polluted —
- * idempotent, runs once, deletes=0 on every subsequent boot.
- *
- * Match shape: `:Person {source:'whatsapp', participantStatus:'auto-created'}`
- * whose `name` contains `\n` or `[`. Both characters are impossible in a
- * legitimate WhatsApp display name; their presence is a parser-miss
- * fingerprint. DETACH DELETE removes the node and any incident edges
- * (`:SENT`, `:PARTICIPANT_IN`) so the chronology stays intact for the
- * canonical participants.
- *
- * Loud-fail discipline: a separate read pass first surfaces any :Person
- * with the polluted-name shape but NOT carrying `participantStatus =
- * 'auto-created'`. Such a node is operator-curated and the migration
- * refuses to delete it — we log the elementId for manual review and
- * proceed with the auto-created sweep. Better to leave one suspect node
- * standing than to delete a hand-edited canonical Person.
- *
- * Observability:
- *   `[migration:whatsapp-bogus-person-prune] matched=N deleted=N
- *    skipped-non-auto=N` — info, once per boot.
- *   `[migration:whatsapp-bogus-person-prune] non-auto-match elementId=…
- *    name=…` — warn, once per offending non-auto-created node.
- *
- * REMOVE WHEN: every install we ship has been booted at least once on
- * a version ≥ Task 887. The user controls all installs and will remove
- * this once that condition is met.
- */
-
-type Neo4jDriverLike = {
-  session(): {
-    run(
-      cypher: string,
-      params?: Record<string, unknown>,
-    ): Promise<{ records: Array<{ get(key: string): unknown }> }>;
-    close(): Promise<void>;
-  };
-};
-
-// Match shape: name carries either a newline or a `[` — both are
-// parser-miss fingerprints. The `(?s)` DOTALL flag is mandatory: Java
-// regex (which Neo4j's `=~` uses) defaults `.` to "any char EXCEPT
-// newline", so the trailing `.*` would fail to span across a second
-// newline in a doubly-polluted name (e.g. `Adam:\n[ts] Adam:\n[ts]`).
-// Without DOTALL, the doubly-polluted residue slips past the sweep.
-const POLLUTED_NAME_REGEX = "(?s).*[\\n\\[].*";
-
-export async function pruneBogusWhatsappPersons(
-  driver: Neo4jDriverLike,
-): Promise<void> {
-  const session = driver.session();
-  try {
-    // Step 1 — surface non-auto-created Persons whose name carries the
-    // pollution shape. Operator-curated nodes that happen to share the
-    // shape are kept and named in the log; the sweep runs only over
-    // auto-created residue.
-    const nonAutoRes = await session.run(
-      `MATCH (p:Person {source: 'whatsapp'})
-       WHERE coalesce(p.participantStatus, '') <> 'auto-created'
-         AND p.name =~ $regex
-       RETURN elementId(p) AS elementId, p.name AS name`,
-      { regex: POLLUTED_NAME_REGEX },
-    );
-    const skippedNonAuto = nonAutoRes.records.length;
-    for (const record of nonAutoRes.records) {
-      const elementId = record.get("elementId") as string;
-      const name = record.get("name") as string;
-      console.error(
-        `[migration:whatsapp-bogus-person-prune] non-auto-match elementId=${elementId} name=${JSON.stringify(name)}`,
-      );
-    }
-
-    // Step 2 — count the auto-created matches (separate from delete so
-    // `matched=N` reflects the discovered set even when the delete runs
-    // against a partially-overlapping snapshot).
-    const matchedRes = await session.run(
-      `MATCH (p:Person {source: 'whatsapp', participantStatus: 'auto-created'})
-       WHERE p.name =~ $regex
-       RETURN count(p) AS matched`,
-      { regex: POLLUTED_NAME_REGEX },
-    );
-    const matched = toNumber(matchedRes.records[0]?.get("matched"));
-
-    if (matched === 0) {
-      console.error(
-        `[migration:whatsapp-bogus-person-prune] matched=0 deleted=0 skipped-non-auto=${skippedNonAuto}`,
-      );
-      return;
-    }
-
-    // Step 3 — DETACH DELETE auto-created matches. `count(p)` over the
-    // matched-then-deleted node yields the deleted count for the log.
-    const deleteRes = await session.run(
-      `MATCH (p:Person {source: 'whatsapp', participantStatus: 'auto-created'})
-       WHERE p.name =~ $regex
-       DETACH DELETE p
-       RETURN count(p) AS deleted`,
-      { regex: POLLUTED_NAME_REGEX },
-    );
-    const deleted = toNumber(deleteRes.records[0]?.get("deleted"));
-
-    console.error(
-      `[migration:whatsapp-bogus-person-prune] matched=${matched} deleted=${deleted} skipped-non-auto=${skippedNonAuto}`,
-    );
-  } finally {
-    await session.close();
-  }
-}
-
-function toNumber(v: unknown): number {
-  if (typeof v === "number") return v;
-  if (
-    v &&
-    typeof (v as { toNumber?: () => number }).toNumber === "function"
-  ) {
-    return (v as { toNumber: () => number }).toNumber();
-  }
-  return 0;
-}

package/payload/platform/neo4j/migrations/007-conversation-archive-source.ts

@@ -1,116 +0,0 @@
-/**
- * Migration 007 — Backfill `source` and rename provenance on existing
- * :ConversationArchive parents and :Section:Conversation chunks (Task 894).
- *
- * Pre-Task-894 the conversation-archive write path stamped every node with
- * `createdByAgent = 'whatsapp-import'` and `source = 'whatsapp'`. Task 894
- * generalises the path: `createdByAgent` becomes `'conversation-archive'`
- * (one orchestrator, one skill, regardless of source); `source` is a property
- * carrying the source format ('whatsapp', 'telegram', 'slack', …).
- *
- * Without this migration the diagnostic surface fragments — queries that
- * filter by createdByAgent return only post-894 data; the new
- * (accountId, source) index is empty for legacy archives. This migration
- * rewrites both sides idempotently:
- *
- *   1. :ConversationArchive without `source` → SET source='whatsapp'
- *      (every pre-894 archive came from the whatsapp-import bin script).
- *   2. :ConversationArchive.createdByAgent='whatsapp-import' →
- *      SET createdByAgent='conversation-archive'.
- *   3. :Section:Conversation without `source` → SET source='whatsapp'.
- *   4. :Section:Conversation.createdByAgent='whatsapp-import' →
- *      SET createdByAgent='conversation-archive'.
- *   5. :HAS_SECTION / :NEXT / :PARTICIPANT_IN edges with
- *      createdByAgent='whatsapp-import' → SET createdByAgent='conversation-archive'.
- *
- * Re-runs are no-ops (each WHERE clause excludes the post-rename state).
- *
- * Observability:
- *   `[migration:conversation-archive-source]
- *      archives-source-set=N archives-agent-renamed=N
- *      chunks-source-set=N chunks-agent-renamed=N edges-agent-renamed=N`
- *
- * REMOVE WHEN: every install we ship has been booted once on a version
- * ≥ Task 894 AND no live archive carries the legacy provenance string.
- */
-
-type Neo4jDriverLike = {
-  session(): {
-    run(
-      cypher: string,
-      params?: Record<string, unknown>,
-    ): Promise<{ records: Array<{ get(key: string): unknown }> }>;
-    close(): Promise<void>;
-  };
-};
-
-export async function backfillConversationArchiveSource(
-  driver: Neo4jDriverLike,
-): Promise<void> {
-  const session = driver.session();
-  try {
-    const archivesSourceSet = await runCount(
-      session,
-      `MATCH (a:ConversationArchive)
-       WHERE a.source IS NULL
-       SET a.source = 'whatsapp'
-       RETURN count(a) AS n`,
-    );
-
-    const archivesAgentRenamed = await runCount(
-      session,
-      `MATCH (a:ConversationArchive)
-       WHERE a.createdByAgent = 'whatsapp-import'
-       SET a.createdByAgent = 'conversation-archive'
-       RETURN count(a) AS n`,
-    );
-
-    const chunksSourceSet = await runCount(
-      session,
-      `MATCH (c:Section:Conversation)
-       WHERE c.source IS NULL
-       SET c.source = 'whatsapp'
-       RETURN count(c) AS n`,
-    );
-
-    const chunksAgentRenamed = await runCount(
-      session,
-      `MATCH (c:Section:Conversation)
-       WHERE c.createdByAgent = 'whatsapp-import'
-       SET c.createdByAgent = 'conversation-archive'
-       RETURN count(c) AS n`,
-    );
-
-    const edgesAgentRenamed = await runCount(
-      session,
-      `MATCH (a:ConversationArchive)-[r]-()
-       WHERE r.createdByAgent = 'whatsapp-import'
-       SET r.createdByAgent = 'conversation-archive'
-       RETURN count(r) AS n`,
-    );
-
-    console.error(
-      `[migration:conversation-archive-source] ` +
-        `archives-source-set=${archivesSourceSet} ` +
-        `archives-agent-renamed=${archivesAgentRenamed} ` +
-        `chunks-source-set=${chunksSourceSet} ` +
-        `chunks-agent-renamed=${chunksAgentRenamed} ` +
-        `edges-agent-renamed=${edgesAgentRenamed}`,
-    );
-  } finally {
-    await session.close();
-  }
-}
-
-async function runCount(
-  session: { run(c: string, p?: Record<string, unknown>): Promise<{ records: Array<{ get(k: string): unknown }> }> },
-  cypher: string,
-): Promise<number> {
-  const res = await session.run(cypher);
-  const v = res.records[0]?.get("n");
-  if (typeof v === "number") return v;
-  if (v && typeof (v as { toNumber?: () => number }).toNumber === "function") {
-    return (v as { toNumber: () => number }).toNumber();
-  }
-  return 0;
-}

package/payload/platform/neo4j/migrations/008-adminuser-accountid-backfill.ts

@@ -1,85 +0,0 @@
-/**
- * Migration 008 — Backfill `accountId` on legacy `:AdminUser` nodes (Task 897).
- *
- * Pre-Task-897 the `admin-add` MERGE in admin/mcp/src/index.ts stamped only
- * `userId/name/createdAt` on `:AdminUser` ON CREATE. Migration 004
- * (pruneAlienAccounts) DETACH DELETEs every node whose `accountId` is not
- * a valid on-disk account UUID, including null-accountId :AdminUser entries
- * — silently wiping the admin's pin and Person ownership.
- *
- * The fix in admin/mcp/src/index.ts now stamps `accountId` ON CREATE and
- * COALESCEs ON MATCH. This migration cleans the existing graphs that already
- * carry the legacy null-accountId fingerprint, by reading the surviving
- * `:ADMIN_OF` edge to `:LocalBusiness` and copying the LocalBusiness's
- * `accountId` onto the orphan AdminUser.
- *
- * Migration ordering: this runs AFTER pruneAlienAccounts (migration 004).
- * pruneAlienAccounts only deletes nodes whose `accountId` is *non-null but
- * unknown* — null-accountId nodes survive its sweep and reach this backfill.
- * After backfill, any remaining null-accountId AdminUser is a structural bug
- * (no ADMIN_OF edge → cannot derive accountId) and the boot fails loudly.
- *
- * Observability:
- *   `[migration:adminuser-accountid] backfilled=N residual-null=M` — info
- *     once per boot. residual-null > 0 throws and crashes boot.
- *
- * REMOVE WHEN: every install we ship has been booted at least once on a
- * version ≥ Task 897 AND no live `:AdminUser` carries a null accountId.
- */
-
-type Neo4jDriverLike = {
-  session(): {
-    run(
-      cypher: string,
-      params?: Record<string, unknown>,
-    ): Promise<{ records: Array<{ get(key: string): unknown }> }>;
-    close(): Promise<void>;
-  };
-};
-
-export async function backfillAdminUserAccountId(
-  driver: Neo4jDriverLike,
-): Promise<void> {
-  const session = driver.session();
-  try {
-    const backfilled = await runCount(
-      session,
-      `MATCH (au:AdminUser) WHERE au.accountId IS NULL
-       OPTIONAL MATCH (au)-[:ADMIN_OF]->(b:LocalBusiness)
-       WITH au, b WHERE b IS NOT NULL AND b.accountId IS NOT NULL
-       SET au.accountId = b.accountId
-       RETURN count(au) AS n`,
-    );
-
-    const residualNull = await runCount(
-      session,
-      `MATCH (au:AdminUser) WHERE au.accountId IS NULL
-       RETURN count(au) AS n`,
-    );
-
-    console.error(
-      `[migration:adminuser-accountid] backfilled=${backfilled} residual-null=${residualNull}`,
-    );
-
-    if (residualNull > 0) {
-      throw new Error(
-        `migration:adminuser-accountid: ${residualNull} :AdminUser node(s) still carry a null accountId after backfill — no ADMIN_OF edge to derive from. Manual reconciliation required (cypher-shell into the graph; either DELETE the orphan or attach a valid ADMIN_OF edge and re-run boot).`,
-      );
-    }
-  } finally {
-    await session.close();
-  }
-}
-
-async function runCount(
-  session: { run(c: string, p?: Record<string, unknown>): Promise<{ records: Array<{ get(k: string): unknown }> }> },
-  cypher: string,
-): Promise<number> {
-  const res = await session.run(cypher);
-  const v = res.records[0]?.get("n");
-  if (typeof v === "number") return v;
-  if (v && typeof (v as { toNumber?: () => number }).toNumber === "function") {
-    return (v as { toNumber: () => number }).toNumber();
-  }
-  return 0;
-}

package/payload/platform/neo4j/migrations/009-conversation-archive-title.ts

@@ -1,197 +0,0 @@
-/**
- * Migration 009 — Backfill `title` on every legacy `:ConversationArchive`
- * (Task 902 sub-scope A).
- *
- * Pre-902 the bin wrote per-session counter strings ("Session 1/N: K messages,
- * X chunks") into `:ConversationArchive.summary`. Because the MERGE Cypher
- * set `summary` ONLY in `ON CREATE SET`, the FIRST per-session call's counter
- * was frozen for the lifetime of the archive — and the UI's `pickDisplayName`
- * fell through to `summary` for `:ConversationArchive`, so every archive
- * rendered as the literal "Session 1/N…" string of its first checkpoint.
- *
- * Task 902 added a stable `title` property and a UI branch that prefers it.
- * This migration backfills `title` on every legacy archive that predates the
- * new contract, so the UI never label-falls-through:
- *
- *   <source> · <owner> ↔ <other1>, <other2>, … · <YYYY-MM-DD>→<YYYY-MM-DD>
- *
- * Owner / participant resolution: query `(p)-[:PARTICIPANT_IN]->(a)` for the
- * archive's participant set, then pick a name per node by label:
- *   :AdminUser → displayName, then slug
- *   :Person    → givenName + familyName
- * Owner is identified by AdminUser presence in the set; other participants
- * are everyone else. When neither name resolves on a node, fall back to a
- * short elementId prefix (mirrors the bin's degraded behaviour at
- * `computeArchiveTitle`, so the live ingest produces the same shape).
- *
- * Date range: head and tail `:Section:Conversation` chunks via
- * `firstMessageAt` / `lastMessageAt` properties (Task 891 chunk schema).
- * When chunks lack those properties (rare — pre-Task-891 archives), fall
- * back to the parent's `lastIngestedMessageAt` for both ends. When even
- * that is missing, the date segment is `?→?`. The migration NEVER leaves
- * `title` NULL — every row gets a string, even if degraded — so the
- * verification query `MATCH (a:ConversationArchive) WHERE a.title IS NULL
- * RETURN count(a)` returns 0 unconditionally.
- *
- * Idempotency: only archives where `title IS NULL` are touched. A second
- * boot finds zero rows and emits `archives-titled=0`.
- *
- * Observability:
- *   `[migration:conversation-archive-title]
- *      archives-titled=N degraded-no-dates=N degraded-no-names=N`
- *
- * REMOVE WHEN: every install we ship has been booted once on a version
- * ≥ Task 902 AND no live archive carries `title IS NULL`.
- */
-
-type Neo4jDriverLike = {
-  session(): {
-    run(
-      cypher: string,
-      params?: Record<string, unknown>,
-    ): Promise<{ records: Array<{ get(key: string): unknown }> }>;
-    close(): Promise<void>;
-  };
-};
-
-interface ParticipantRow {
-  elementId: string;
-  labels: string[];
-  displayName?: string;
-  slug?: string;
-  givenName?: string;
-  familyName?: string;
-}
-
-const ISO_DATE_RE = /^(\d{4}-\d{2}-\d{2})/;
-
-function isoToYmd(iso: unknown): string {
-  if (typeof iso !== "string") return "?";
-  const m = iso.match(ISO_DATE_RE);
-  return m ? m[1] : "?";
-}
-
-function pickName(row: ParticipantRow): string {
-  if (row.labels.includes("AdminUser")) {
-    if (row.displayName && row.displayName.trim()) return row.displayName.trim();
-    if (row.slug && row.slug.trim()) return row.slug.trim();
-  }
-  if (row.labels.includes("Person")) {
-    const full = [row.givenName, row.familyName]
-      .filter((s): s is string => typeof s === "string" && s.trim().length > 0)
-      .map((s) => s.trim())
-      .join(" ");
-    if (full) return full;
-  }
-  return row.elementId.slice(0, 8);
-}
-
-function asString(v: unknown): string | undefined {
-  return typeof v === "string" ? v : undefined;
-}
-
-export async function backfillConversationArchiveTitle(
-  driver: Neo4jDriverLike,
-): Promise<void> {
-  const session = driver.session();
-  let archivesTitled = 0;
-  let degradedNoDates = 0;
-  let degradedNoNames = 0;
-  try {
-    // 1. Find every archive lacking a title. For each, pull the participant
-    //    set + head/tail chunk timestamps in one batch round-trip per archive.
-    //    Idempotent: re-runs return zero rows.
-    const archives = await session.run(
-      `MATCH (a:ConversationArchive)
-       WHERE a.title IS NULL
-       RETURN elementId(a) AS elemId,
-              coalesce(a.source, 'whatsapp') AS source,
-              a.lastIngestedMessageAt AS lastAt`,
-    );
-    for (const rec of archives.records) {
-      const elemId = rec.get("elemId") as string;
-      const source = rec.get("source") as string;
-      const fallbackLastAt = rec.get("lastAt") as string | null;
-
-      // 2. Pull the participant rows.
-      const partRes = await session.run(
-        `MATCH (p)-[:PARTICIPANT_IN]->(a:ConversationArchive)
-         WHERE elementId(a) = $elemId AND (p:Person OR p:AdminUser)
-         RETURN elementId(p) AS elemId, labels(p) AS labels, properties(p) AS props`,
-        { elemId },
-      );
-      const owner: ParticipantRow[] = [];
-      const others: ParticipantRow[] = [];
-      let anyDegraded = false;
-      for (const r of partRes.records) {
-        const labels = (r.get("labels") as string[]) || [];
-        const props = (r.get("props") as Record<string, unknown>) || {};
-        const row: ParticipantRow = {
-          elementId: r.get("elemId") as string,
-          labels,
-          displayName: asString(props.displayName),
-          slug: asString(props.slug),
-          givenName: asString(props.givenName),
-          familyName: asString(props.familyName),
-        };
-        const name = pickName(row);
-        if (name === row.elementId.slice(0, 8)) anyDegraded = true;
-        if (labels.includes("AdminUser")) owner.push(row);
-        else others.push(row);
-      }
-      if (anyDegraded) degradedNoNames += 1;
-      const ownerName = owner.length > 0 ? pickName(owner[0]) : "?";
-      const otherNames = others.length > 0
-        ? others.map((o) => pickName(o)).join(", ")
-        : "?";
-
-      // 3. Pull the head and tail chunk timestamps. Chunks land in NEXT-chain
-      //    order; the chain head has no incoming :NEXT edge inside the
-      //    same archive, the tail has no outgoing :NEXT.
-      const datesRes = await session.run(
-        `MATCH (a:ConversationArchive)-[:HAS_SECTION]->(c:Section:Conversation)
-         WHERE elementId(a) = $elemId
-         WITH c, c.firstMessageAt AS first, c.lastMessageAt AS last
-         RETURN min(first) AS firstAt, max(last) AS lastAt`,
-        { elemId },
-      );
-      let firstAt = asString(datesRes.records[0]?.get("firstAt"));
-      let lastAt = asString(datesRes.records[0]?.get("lastAt"));
-      if (!firstAt || !lastAt) {
-        if (fallbackLastAt) {
-          firstAt = firstAt ?? fallbackLastAt;
-          lastAt = lastAt ?? fallbackLastAt;
-        }
-      }
-      if (!firstAt || !lastAt) {
-        degradedNoDates += 1;
-      }
-      const firstYmd = isoToYmd(firstAt);
-      const lastYmd = isoToYmd(lastAt);
-
-      const title = `${source} · ${ownerName} ↔ ${otherNames} · ${firstYmd}→${lastYmd}`;
-
-      // 4. Stamp the title. Guarded by `title IS NULL` so a concurrent live
-      //    ingest that has already written a real title is never overwritten.
-      const upd = await session.run(
-        `MATCH (a:ConversationArchive)
-         WHERE elementId(a) = $elemId AND a.title IS NULL
-         SET a.title = $title
-         RETURN count(a) AS n`,
-        { elemId, title },
-      );
-      const n = upd.records[0]?.get("n");
-      const v = typeof n === "number" ? n : (n as { toNumber?: () => number })?.toNumber?.() ?? 0;
-      if (v > 0) archivesTitled += 1;
-    }
-
-    console.error(
-      `[migration:conversation-archive-title] ` +
-        `archives-titled=${archivesTitled} ` +
-        `degraded-no-dates=${degradedNoDates} ` +
-        `degraded-no-names=${degradedNoNames}`,
-    );
-  } finally {
-    await session.close();
-  }
-}

package/payload/server/public/assets/data-DwZZ7qbH.js

@@ -1 +0,0 @@
-import{i as e,t}from"./jsx-runtime-DH5S-MwB.js";import{t as n}from"./page-CFWoVkgV.js";import"./useAdminFetch-B93ig7ef.js";var r=e(),i=t();(0,r.createRoot)(document.getElementById(`root`)).render((0,i.jsx)(n,{}));

package/payload/server/public/assets/graph-DceEv42K.js

@@ -1 +0,0 @@
-import{i as e,t}from"./jsx-runtime-DH5S-MwB.js";import{n}from"./page-Bpi_jPw6.js";import"./useAdminFetch-B93ig7ef.js";import"./Checkbox-Bq6ORjz2.js";var r=e(),i=t();(0,r.createRoot)(document.getElementById(`root`)).render((0,i.jsx)(n,{}));