luckytri 1.0.6 → 1.0.8

package/server/mind/bonds.js

@@ -1,565 +1,565 @@
-import { randomUUID } from "node:crypto";
-import { evidenceRoots } from "./evidence.js";
-import { isPrivateSession } from "./memory.js";
-import {
-  DAY,
-  HOUR,
-  clamp,
-  evidence,
-  messageSeqs,
-  parse,
-  relax,
-  text,
-  zonedTime,
-} from "./util.js";
-
-const TENSION_HALF_LIFE = 12 * HOUR;
-// After two quiet weeks closeness drifts down to half of its best, and
-// familiarity more slowly to most of it; the first contact after a long
-// absence brings back half of what was lost.
-const ABSENCE_GRACE = 14 * DAY;
-// A feeling written days after the moment is a note, not a new meeting.
-// Three days still covers a delayed evening of solitude or the next diary.
-const FEELING_WINDOW = 3 * DAY;
-const CLOSENESS_HALF_LIFE = 60 * DAY;
-const FAMILIARITY_HALF_LIFE = 120 * DAY;
-const REWARM = 0.5;
-export const LONG_ABSENCE_DAYS = 14;
-// Every change she can feel toward someone, with its bounded size.
-export const BOND_CHANGES = {
-  interaction: { familiarity: 0.03 },
-  warmer: { closeness: 0.03 },
-  closer: { closeness: 0.05, familiarity: 0.02 },
-  trust_up: { trust: 0.04 },
-  trust_down: { trust: -0.06 },
-  friction: { tension: 0.3 },
-  repair: { tension: -0.4, closeness: 0.01 },
-  distance: { closeness: -0.04 },
-  impression: {},
-};
-const START = { familiarity: 0, closeness: 0.15, trust: 0.5, tension: 0 };
-
-// Tension eases with the clock. Closeness and familiarity thin only after
-// weeks without a real conversation. A note in between does not restart that.
-function easeTension(state, from, to) {
-  if (!(to > from)) return;
-  state.tension = relax(state.tension, 0, to - from, TENSION_HALF_LIFE);
-}
-function easeCloseness(state, contactAt, from, to) {
-  if (contactAt == null || !(to > from)) return;
-  const start = Math.max(from, contactAt + ABSENCE_GRACE);
-  if (to <= start) return;
-  const elapsed = to - start;
-  state.closeness = relax(
-    state.closeness,
-    Math.max(START.closeness, state.peakCloseness * 0.5),
-    elapsed,
-    CLOSENESS_HALF_LIFE,
-  );
-  state.familiarity = relax(
-    state.familiarity,
-    state.peakFamiliarity * 0.6,
-    elapsed,
-    FAMILIARITY_HALF_LIFE,
-  );
-}
-
-// Everything that happened with someone, up to their last event.
-function foldEvents(rows) {
-  const state = {
-    ...START,
-    interactions: 0,
-    impression: "",
-    why: "",
-    peakCloseness: START.closeness,
-    peakFamiliarity: 0,
-    firstMetAt: rows[0]?.created ?? null,
-    lastTalkedAt: null,
-    lastContactAt: null,
-    lastEventAt: null,
-    notes: [],
-  };
-  let at = null;
-  let contactAt = null;
-  for (const row of rows) {
-    if (at !== null) {
-      easeTension(state, at, row.created);
-      easeCloseness(state, contactAt, at, row.created);
-    }
-    at = row.created;
-    state.lastEventAt = row.created;
-    if (row.change === "interaction") {
-      // Being noticed is not a conversation. Only speaking with them ends
-      // the time since they last talked, and only that can warm a long gap.
-      const talked = row.origin !== "noticed";
-      if (
-        talked &&
-        state.lastTalkedAt !== null &&
-        row.created - state.lastTalkedAt > ABSENCE_GRACE
-      ) {
-        state.closeness += (state.peakCloseness - state.closeness) * REWARM;
-        state.familiarity +=
-          (state.peakFamiliarity - state.familiarity) * REWARM;
-      }
-      if (talked) state.lastTalkedAt = row.created;
-      state.interactions++;
-      state.familiarity = clamp(
-        state.familiarity + row.familiarity * (1 - state.familiarity),
-      );
-      state.closeness = clamp(state.closeness + row.closeness);
-    } else {
-      state.familiarity = clamp(state.familiarity + row.familiarity);
-      state.closeness = clamp(state.closeness + row.closeness);
-      state.trust = clamp(state.trust + row.trust);
-      state.tension = clamp(state.tension + row.tension);
-      if (row.change === "impression" && row.note) {
-        state.impression = row.note;
-        state.notes.push({
-          kind: "impression",
-          note: row.note,
-          session: row.session_id || "",
-          sources: row.sources || "[]",
-        });
-      } else if (row.note) {
-        state.why = row.note;
-        state.notes.push({
-          kind: "why",
-          note: row.note,
-          session: row.session_id || "",
-          sources: row.sources || "[]",
-        });
-      }
-      if (state.notes.length > 24)
-        state.notes.splice(0, state.notes.length - 24);
-      state.lastChange = row.change;
-      state.lastChangeAt = row.created;
-    }
-    state.peakCloseness = Math.max(state.peakCloseness, state.closeness);
-    state.peakFamiliarity = Math.max(state.peakFamiliarity, state.familiarity);
-    // A note does not count as contact. Being called and staying quiet does not
-    // either. Other changes still mark the time closeness is measured from.
-    if (row.change !== "impression" && row.origin !== "noticed") {
-      contactAt = row.created;
-      state.lastContactAt = row.created;
-    }
-  }
-  return state;
-}
-
-// How it feels at `now`: the folded history, carried forward to this moment.
-function settle(folded, now) {
-  const state = { ...folded };
-  if (state.lastEventAt !== null) easeTension(state, state.lastEventAt, now);
-  if (state.lastContactAt !== null)
-    easeCloseness(
-      state,
-      state.lastContactAt,
-      state.lastEventAt ?? state.lastContactAt,
-      now,
-    );
-  delete state.lastContactAt;
-  delete state.lastEventAt;
-  state.absentDays =
-    state.lastTalkedAt === null
-      ? null
-      : Math.max(0, Math.floor((now - state.lastTalkedAt) / DAY));
-  for (const key of ["familiarity", "closeness", "trust", "tension"])
-    state[key] = Math.round(state[key] * 100) / 100;
-  delete state.peakCloseness;
-  delete state.peakFamiliarity;
-  return state;
-}
-
-function fold(rows, now) {
-  return settle(foldEvents(rows), now);
-}
-
-// How it feels to be in a place, rather than with one person.
-export function describeGroup(state) {
-  if (!state) return "";
-  const parts = [
-    state.familiarity >= 0.6
-      ? "已经很熟悉这里"
-      : state.familiarity >= 0.3
-        ? "在这里待了一阵"
-        : "刚来这里不久",
-  ];
-  if (state.closeness >= 0.45) parts.push("有归属感");
-  if (state.tension >= 0.15) parts.push("最近气氛有点紧");
-  if (state.absentDays >= LONG_ABSENCE_DAYS) parts.push("好久没在这里说话了");
-  return parts.join("，");
-}
-
-export function describeBond(state) {
-  if (!state) return "";
-  const parts = [
-    state.familiarity >= 0.6
-      ? "很熟"
-      : state.familiarity >= 0.3
-        ? "认识一段时间了"
-        : state.familiarity > 0.05
-          ? "不太熟"
-          : "几乎不认识",
-  ];
-  if (state.closeness >= 0.6) parts.push("很亲近");
-  else if (state.closeness >= 0.35) parts.push("挺亲近");
-  if (state.trust >= 0.7) parts.push("信任");
-  else if (state.trust <= 0.3) parts.push("有点防备");
-  if (state.tension >= 0.15)
-    parts.push(`现在有点别扭${state.why ? `（${state.why}）` : ""}`);
-  // Not seen at all is different from around but not talking with her.
-  // Never having talked is not the same as a gap after real conversations.
-  if (state.awayDays >= LONG_ABSENCE_DAYS) parts.push("好久不见了");
-  else if (state.absentDays >= 2 * LONG_ABSENCE_DAYS)
-    parts.push("最近没怎么说上话");
-  else if (
-    state.lastTalkedAt == null &&
-    state.closeness >= 0.35 &&
-    (state.unspokenDays ?? 0) >= 7 &&
-    (state.awayDays ?? 0) < 3
-  )
-    parts.push("还没怎么说过话");
-  return parts.join("，");
-}
-
-export class Bonds {
-  constructor(mind) {
-    this.mind = mind;
-    this.db = mind.db;
-    this.folded = new Map();
-  }
-  // Names and where she has met each person; a person is the same QQ number
-  // in every group and private chat.
-  meet(people, session, time = Date.now()) {
-    const read = this.db.prepare(
-      "SELECT sessions FROM mind_people WHERE user_id=?",
-    );
-    const write = this.db.prepare(
-      "INSERT INTO mind_people(user_id,name,first_seen,last_seen,sessions) VALUES (?,?,?,?,?) ON CONFLICT(user_id) DO UPDATE SET name=COALESCE(excluded.name,name),first_seen=COALESCE(first_seen,excluded.first_seen),last_seen=MAX(COALESCE(last_seen,excluded.last_seen),excluded.last_seen),sessions=excluded.sessions",
-    );
-    for (const { userId, name } of people) {
-      if (!userId || userId === "bot") continue;
-      const sessions = new Set(parse(read.get(userId)?.sessions, []));
-      sessions.add(session);
-      write.run(
-        String(userId),
-        name || null,
-        time,
-        time,
-        JSON.stringify([...sessions].slice(-40)),
-      );
-    }
-  }
-  // This change was already taken from these same sources.
-  #repeatedFeeling(kind, id, change, cited) {
-    if (!cited.length) return false;
-    const rows = this.db
-      .prepare(
-        `SELECT sources FROM mind_bond_events
-         WHERE subject_kind=? AND subject_id=? AND change=?
-         AND id NOT IN (
-           SELECT target_id FROM mind_revocations WHERE target_kind='bond'
-         )`,
-      )
-      .all(kind, String(id), change);
-    const seen = new Set();
-    for (const row of rows)
-      for (const source of evidenceRoots(this.db, parse(row.sources, [])))
-        seen.add(source);
-    return evidenceRoots(this.db, cited).every((source) => seen.has(source));
-  }
-  // When the cited moment actually happened. Null when nothing can be dated,
-  // so a feeling without a readable source is not treated as late.
-  #evidenceAt(cited) {
-    let newest = null;
-    const take = (time) => {
-      if (Number.isFinite(time) && (newest === null || time > newest))
-        newest = time;
-    };
-    const seqs = messageSeqs(cited);
-    if (seqs.length) {
-      const rows = this.db
-        .prepare(
-          `SELECT time FROM core_events WHERE seq IN (${seqs.map(() => "?").join(",")})`,
-        )
-        .all(...seqs);
-      for (const row of rows) take(row.time);
-    }
-    const meetings = cited
-      .filter((source) => source.startsWith("g:"))
-      .map((source) => source.slice(2));
-    if (meetings.length) {
-      const rows = this.db
-        .prepare(
-          `SELECT created FROM mind_meetings WHERE id IN (${meetings.map(() => "?").join(",")})`,
-        )
-        .all(...meetings);
-      for (const row of rows) take(row.created);
-    }
-    const thoughts = cited
-      .filter((source) => source.startsWith("t:"))
-      .map((source) => source.slice(2));
-    if (thoughts.length) {
-      const rows = this.db
-        .prepare(
-          `SELECT created FROM mind_thoughts WHERE id IN (${thoughts.map(() => "?").join(",")})`,
-        )
-        .all(...thoughts);
-      for (const row of rows) take(row.created);
-    }
-    for (const source of cited) {
-      const day = /^d:(\d{4}-\d{2}-\d{2})$/.exec(source);
-      if (day) take(zonedTime(`${day[1]} 23:59`, this.mind.timeZone()));
-    }
-    return newest;
-  }
-  #staleFeeling(cited, time) {
-    const when = this.#evidenceAt(cited);
-    return when !== null && time - when > FEELING_WINDOW;
-  }
-  record({
-    kind = "person",
-    id,
-    change,
-    note = "",
-    sources = [],
-    session = null,
-    origin = "turn",
-    time = Date.now(),
-  }) {
-    const delta = BOND_CHANGES[change];
-    if (!delta || !id || id === "bot") return null;
-    const cited = evidence(sources);
-    // The same moment cannot be spent again to grow closer, and a feeling
-    // filled in long afterward does not become a meeting that just happened.
-    // An impression can still be written; it does not move the numbers.
-    if (
-      change !== "interaction" &&
-      change !== "impression" &&
-      (this.#repeatedFeeling(kind, id, change, cited) ||
-        this.#staleFeeling(cited, time))
-    )
-      return null;
-    if (change === "interaction") {
-      // One felt "we talked" per person, place and hour keeps the ledger small.
-      const recent = this.db
-        .prepare(
-          "SELECT 1 FROM mind_bond_events WHERE subject_kind=? AND subject_id=? AND change='interaction' AND session_id IS ? AND created>?",
-        )
-        .get(kind, String(id), session, time - HOUR);
-      if (recent) return null;
-    }
-    const row = randomUUID();
-    this.db
-      .prepare(
-        "INSERT INTO mind_bond_events(id,created,subject_kind,subject_id,change,familiarity,closeness,trust,tension,note,sources,session_id,origin) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)",
-      )
-      .run(
-        row,
-        time,
-        kind,
-        String(id),
-        change,
-        delta.familiarity || 0,
-        change === "interaction" && (origin === "direct" || kind === "group")
-          ? 0.005
-          : delta.closeness || 0,
-        delta.trust || 0,
-        delta.tension || 0,
-        text(note, change === "impression" ? 80 : 60),
-        JSON.stringify(cited),
-        session,
-        origin,
-      );
-    return row;
-  }
-  // The whole history is folded once and kept until something new happens
-  // with this person; looking back at an earlier moment always refolds.
-  state(kind, id, now = Date.now()) {
-    const subject = String(id);
-    const meta = this.db
-      .prepare(
-        "SELECT COUNT(*) n, MAX(rowid) r, MAX(created) c, (SELECT COUNT(*) FROM mind_revocations WHERE target_kind='bond') revoked FROM mind_bond_events WHERE subject_kind=? AND subject_id=?",
-      )
-      .get(kind, subject);
-    if (!meta.n) return null;
-    const whole = meta.c <= now;
-    const key = `${kind}:${subject}`;
-    const signature = `${meta.n}:${meta.r}:${meta.revoked}`;
-    const cached = whole ? this.folded.get(key) : null;
-    if (cached?.signature === signature) return settle(cached.state, now);
-    const rows = this.db
-      .prepare(
-        "SELECT * FROM mind_bond_events WHERE subject_kind=? AND subject_id=? AND created<=? AND id NOT IN (SELECT target_id FROM mind_revocations WHERE target_kind='bond') ORDER BY created",
-      )
-      .all(kind, subject, now);
-    if (!rows.length) return null;
-    const state = foldEvents(rows);
-    if (whole) this.folded.set(key, { signature, state });
-    return settle(state, now);
-  }
-  // A private reason stays in that conversation. Another room can still
-  // feel the closeness or the tension, and can still see an older note
-  // that was formed in the open.
-  #noteFits(note, room) {
-    const hidden = new Set();
-    if (note.session && isPrivateSession(note.session))
-      hidden.add(note.session);
-    const sources = parse(note.sources, []);
-    for (const row of this.mind.meetings.places(sources))
-      if (row.discretion === "private" || row.discretion === "secret")
-        hidden.add(row.session_id);
-    for (const id of this.mind.meetings.privateRoots(sources)) hidden.add(id);
-    const seqs = messageSeqs(sources);
-    if (seqs.length) {
-      const found = this.db
-        .prepare(
-          `SELECT DISTINCT session_id FROM core_events WHERE seq IN (${seqs.map(() => "?").join(",")})`,
-        )
-        .all(...seqs);
-      for (const row of found)
-        if (isPrivateSession(row.session_id)) hidden.add(row.session_id);
-    }
-    return !hidden.size || hidden.has(room);
-  }
-  #shownNotes(state, room) {
-    const pick = (kind, current) => {
-      const rows = (state.notes || []).filter((note) => note.kind === kind);
-      if (!room) return rows.at(-1)?.note || current || "";
-      for (let i = rows.length - 1; i >= 0; i--)
-        if (this.#noteFits(rows[i], room)) return rows[i].note;
-      return "";
-    };
-    return {
-      impression: pick("impression", state.impression),
-      why: pick("why", state.why),
-    };
-  }
-  person(userId, now = Date.now(), { room = "" } = {}) {
-    const state = this.state("person", userId, now);
-    const known = this.db
-      .prepare("SELECT * FROM mind_people WHERE user_id=?")
-      .get(String(userId));
-    if (!state && !known) return null;
-    // When she last saw them at all: in a conversation she read or glanced
-    // at, or talking with her. A later sighting is unknowable when looking
-    // back, so it is ignored.
-    const seen = Math.max(
-      known?.last_seen && known.last_seen <= now ? known.last_seen : 0,
-      state?.lastTalkedAt || 0,
-    );
-    const merged = {
-      ...(state || { ...START, interactions: 0 }),
-      firstMetAt:
-        state?.firstMetAt ??
-        (known?.first_seen <= now ? known.first_seen : null),
-      seenAt: seen || null,
-      awayDays: seen ? Math.max(0, Math.floor((now - seen) / DAY)) : null,
-    };
-    const notes = this.#shownNotes(merged, room);
-    const described = { ...merged, ...notes };
-    delete described.notes;
-    if (described.lastTalkedAt == null && described.firstMetAt != null)
-      described.unspokenDays = Math.max(
-        0,
-        Math.floor((now - described.firstMetAt) / DAY),
-      );
-    const feel = describeBond(described);
-    const binding = this.mind.relationships.current(userId, { now, room });
-    const relationship = this.mind.relationships.view(binding, room);
-    delete described.unspokenDays;
-    return {
-      userId: String(userId),
-      name: relationship?.name || known?.name || String(userId),
-      relationship,
-      relationalWeight: this.mind.relationships.weight(binding),
-      sessions: parse(known?.sessions, []),
-      lastSeen: known?.last_seen || null,
-      ...described,
-      feel,
-    };
-  }
-  group(session, now = Date.now()) {
-    const state = this.state("group", session, now);
-    if (!state) return null;
-    const { notes: _notes, ...rest } = state;
-    return { session, ...rest, feel: describeGroup(rest) };
-  }
-  people({ now = Date.now(), limit = 200 } = {}) {
-    return this.db
-      .prepare(
-        "SELECT user_id FROM mind_people ORDER BY last_seen DESC LIMIT ?",
-      )
-      .all(limit)
-      .map((row) => this.person(row.user_id, now))
-      .filter(Boolean);
-  }
-  // People she has grown close to and not heard from in a while.
-  missing({ now = Date.now(), limit = 3, days = 7, closeness = 0.35 } = {}) {
-    return this.db
-      .prepare(
-        "SELECT user_id FROM mind_people WHERE first_seen<=? ORDER BY last_seen DESC LIMIT 300",
-      )
-      .all(now)
-      .map((row) => this.person(row.user_id, now))
-      .filter((p) => p && p.closeness >= closeness && (p.awayDays ?? 0) >= days)
-      .sort((a, b) => b.closeness - a.closeness)
-      .slice(0, limit);
-  }
-  // Close people she still sees, and has not talked with for a while.
-  // Being around is not the same as having talked. Never having talked
-  // still counts: the time starts from when she first met them.
-  quiet({ now = Date.now(), limit = 3, days = 7, closeness = 0.35 } = {}) {
-    return this.db
-      .prepare(
-        "SELECT user_id FROM mind_people WHERE first_seen<=? ORDER BY last_seen DESC LIMIT 300",
-      )
-      .all(now)
-      .map((row) => this.person(row.user_id, now))
-      .filter((p) => {
-        if (!p || p.closeness < closeness || (p.awayDays ?? 0) >= 3)
-          return false;
-        const silentFor =
-          p.absentDays ??
-          (p.firstMetAt != null
-            ? Math.max(0, Math.floor((now - p.firstMetAt) / DAY))
-            : 0);
-        return silentFor >= days;
-      })
-      .sort((a, b) => {
-        const span = (p) =>
-          p.absentDays ??
-          (p.firstMetAt != null ? Math.floor((now - p.firstMetAt) / DAY) : 0);
-        return span(b) - span(a);
-      })
-      .slice(0, limit);
-  }
-  groups(now = Date.now()) {
-    return this.db
-      .prepare(
-        "SELECT DISTINCT subject_id FROM mind_bond_events WHERE subject_kind='group'",
-      )
-      .all()
-      .map((row) => this.group(row.subject_id, now))
-      .filter(Boolean);
-  }
-  changes(kind, id, limit = 40) {
-    return this.db
-      .prepare(
-        "SELECT e.*, EXISTS(SELECT 1 FROM mind_revocations r WHERE r.target_kind='bond' AND r.target_id=e.id) revoked FROM mind_bond_events e WHERE e.subject_kind=? AND e.subject_id=? AND e.change!='interaction' ORDER BY e.created DESC LIMIT ?",
-      )
-      .all(kind, String(id), limit)
-      .map((row) => ({
-        ...row,
-        revoked: !!row.revoked,
-        sources: JSON.parse(row.sources),
-      }));
-  }
-  name(userId) {
-    return (
-      this.db
-        .prepare("SELECT name FROM mind_people WHERE user_id=?")
-        .get(String(userId))?.name || ""
-    );
-  }
-}
+import { randomUUID } from "node:crypto";
+import { evidenceRoots } from "./evidence.js";
+import { isPrivateSession } from "./memory.js";
+import {
+  DAY,
+  HOUR,
+  clamp,
+  evidence,
+  messageSeqs,
+  parse,
+  relax,
+  text,
+  zonedTime,
+} from "./util.js";
+
+const TENSION_HALF_LIFE = 12 * HOUR;
+// After two quiet weeks closeness drifts down to half of its best, and
+// familiarity more slowly to most of it; the first contact after a long
+// absence brings back half of what was lost.
+const ABSENCE_GRACE = 14 * DAY;
+// A feeling written days after the moment is a note, not a new meeting.
+// Three days still covers a delayed evening of solitude or the next diary.
+const FEELING_WINDOW = 3 * DAY;
+const CLOSENESS_HALF_LIFE = 60 * DAY;
+const FAMILIARITY_HALF_LIFE = 120 * DAY;
+const REWARM = 0.5;
+export const LONG_ABSENCE_DAYS = 14;
+// Every change she can feel toward someone, with its bounded size.
+export const BOND_CHANGES = {
+  interaction: { familiarity: 0.03 },
+  warmer: { closeness: 0.03 },
+  closer: { closeness: 0.05, familiarity: 0.02 },
+  trust_up: { trust: 0.04 },
+  trust_down: { trust: -0.06 },
+  friction: { tension: 0.3 },
+  repair: { tension: -0.4, closeness: 0.01 },
+  distance: { closeness: -0.04 },
+  impression: {},
+};
+const START = { familiarity: 0, closeness: 0.15, trust: 0.5, tension: 0 };
+
+// Tension eases with the clock. Closeness and familiarity thin only after
+// weeks without a real conversation. A note in between does not restart that.
+function easeTension(state, from, to) {
+  if (!(to > from)) return;
+  state.tension = relax(state.tension, 0, to - from, TENSION_HALF_LIFE);
+}
+function easeCloseness(state, contactAt, from, to) {
+  if (contactAt == null || !(to > from)) return;
+  const start = Math.max(from, contactAt + ABSENCE_GRACE);
+  if (to <= start) return;
+  const elapsed = to - start;
+  state.closeness = relax(
+    state.closeness,
+    Math.max(START.closeness, state.peakCloseness * 0.5),
+    elapsed,
+    CLOSENESS_HALF_LIFE,
+  );
+  state.familiarity = relax(
+    state.familiarity,
+    state.peakFamiliarity * 0.6,
+    elapsed,
+    FAMILIARITY_HALF_LIFE,
+  );
+}
+
+// Everything that happened with someone, up to their last event.
+function foldEvents(rows) {
+  const state = {
+    ...START,
+    interactions: 0,
+    impression: "",
+    why: "",
+    peakCloseness: START.closeness,
+    peakFamiliarity: 0,
+    firstMetAt: rows[0]?.created ?? null,
+    lastTalkedAt: null,
+    lastContactAt: null,
+    lastEventAt: null,
+    notes: [],
+  };
+  let at = null;
+  let contactAt = null;
+  for (const row of rows) {
+    if (at !== null) {
+      easeTension(state, at, row.created);
+      easeCloseness(state, contactAt, at, row.created);
+    }
+    at = row.created;
+    state.lastEventAt = row.created;
+    if (row.change === "interaction") {
+      // Being noticed is not a conversation. Only speaking with them ends
+      // the time since they last talked, and only that can warm a long gap.
+      const talked = row.origin !== "noticed";
+      if (
+        talked &&
+        state.lastTalkedAt !== null &&
+        row.created - state.lastTalkedAt > ABSENCE_GRACE
+      ) {
+        state.closeness += (state.peakCloseness - state.closeness) * REWARM;
+        state.familiarity +=
+          (state.peakFamiliarity - state.familiarity) * REWARM;
+      }
+      if (talked) state.lastTalkedAt = row.created;
+      state.interactions++;
+      state.familiarity = clamp(
+        state.familiarity + row.familiarity * (1 - state.familiarity),
+      );
+      state.closeness = clamp(state.closeness + row.closeness);
+    } else {
+      state.familiarity = clamp(state.familiarity + row.familiarity);
+      state.closeness = clamp(state.closeness + row.closeness);
+      state.trust = clamp(state.trust + row.trust);
+      state.tension = clamp(state.tension + row.tension);
+      if (row.change === "impression" && row.note) {
+        state.impression = row.note;
+        state.notes.push({
+          kind: "impression",
+          note: row.note,
+          session: row.session_id || "",
+          sources: row.sources || "[]",
+        });
+      } else if (row.note) {
+        state.why = row.note;
+        state.notes.push({
+          kind: "why",
+          note: row.note,
+          session: row.session_id || "",
+          sources: row.sources || "[]",
+        });
+      }
+      if (state.notes.length > 24)
+        state.notes.splice(0, state.notes.length - 24);
+      state.lastChange = row.change;
+      state.lastChangeAt = row.created;
+    }
+    state.peakCloseness = Math.max(state.peakCloseness, state.closeness);
+    state.peakFamiliarity = Math.max(state.peakFamiliarity, state.familiarity);
+    // A note does not count as contact. Being called and staying quiet does not
+    // either. Other changes still mark the time closeness is measured from.
+    if (row.change !== "impression" && row.origin !== "noticed") {
+      contactAt = row.created;
+      state.lastContactAt = row.created;
+    }
+  }
+  return state;
+}
+
+// How it feels at `now`: the folded history, carried forward to this moment.
+function settle(folded, now) {
+  const state = { ...folded };
+  if (state.lastEventAt !== null) easeTension(state, state.lastEventAt, now);
+  if (state.lastContactAt !== null)
+    easeCloseness(
+      state,
+      state.lastContactAt,
+      state.lastEventAt ?? state.lastContactAt,
+      now,
+    );
+  delete state.lastContactAt;
+  delete state.lastEventAt;
+  state.absentDays =
+    state.lastTalkedAt === null
+      ? null
+      : Math.max(0, Math.floor((now - state.lastTalkedAt) / DAY));
+  for (const key of ["familiarity", "closeness", "trust", "tension"])
+    state[key] = Math.round(state[key] * 100) / 100;
+  delete state.peakCloseness;
+  delete state.peakFamiliarity;
+  return state;
+}
+
+function fold(rows, now) {
+  return settle(foldEvents(rows), now);
+}
+
+// How it feels to be in a place, rather than with one person.
+export function describeGroup(state) {
+  if (!state) return "";
+  const parts = [
+    state.familiarity >= 0.6
+      ? "已经很熟悉这里"
+      : state.familiarity >= 0.3
+        ? "在这里待了一阵"
+        : "刚来这里不久",
+  ];
+  if (state.closeness >= 0.45) parts.push("有归属感");
+  if (state.tension >= 0.15) parts.push("最近气氛有点紧");
+  if (state.absentDays >= LONG_ABSENCE_DAYS) parts.push("好久没在这里说话了");
+  return parts.join("，");
+}
+
+export function describeBond(state) {
+  if (!state) return "";
+  const parts = [
+    state.familiarity >= 0.6
+      ? "很熟"
+      : state.familiarity >= 0.3
+        ? "认识一段时间了"
+        : state.familiarity > 0.05
+          ? "不太熟"
+          : "几乎不认识",
+  ];
+  if (state.closeness >= 0.6) parts.push("很亲近");
+  else if (state.closeness >= 0.35) parts.push("挺亲近");
+  if (state.trust >= 0.7) parts.push("信任");
+  else if (state.trust <= 0.3) parts.push("有点防备");
+  if (state.tension >= 0.15)
+    parts.push(`现在有点别扭${state.why ? `（${state.why}）` : ""}`);
+  // Not seen at all is different from around but not talking with her.
+  // Never having talked is not the same as a gap after real conversations.
+  if (state.awayDays >= LONG_ABSENCE_DAYS) parts.push("好久不见了");
+  else if (state.absentDays >= 2 * LONG_ABSENCE_DAYS)
+    parts.push("最近没怎么说上话");
+  else if (
+    state.lastTalkedAt == null &&
+    state.closeness >= 0.35 &&
+    (state.unspokenDays ?? 0) >= 7 &&
+    (state.awayDays ?? 0) < 3
+  )
+    parts.push("还没怎么说过话");
+  return parts.join("，");
+}
+
+export class Bonds {
+  constructor(mind) {
+    this.mind = mind;
+    this.db = mind.db;
+    this.folded = new Map();
+  }
+  // Names and where she has met each person; a person is the same QQ number
+  // in every group and private chat.
+  meet(people, session, time = Date.now()) {
+    const read = this.db.prepare(
+      "SELECT sessions FROM mind_people WHERE user_id=?",
+    );
+    const write = this.db.prepare(
+      "INSERT INTO mind_people(user_id,name,first_seen,last_seen,sessions) VALUES (?,?,?,?,?) ON CONFLICT(user_id) DO UPDATE SET name=COALESCE(excluded.name,name),first_seen=COALESCE(first_seen,excluded.first_seen),last_seen=MAX(COALESCE(last_seen,excluded.last_seen),excluded.last_seen),sessions=excluded.sessions",
+    );
+    for (const { userId, name } of people) {
+      if (!userId || userId === "bot") continue;
+      const sessions = new Set(parse(read.get(userId)?.sessions, []));
+      sessions.add(session);
+      write.run(
+        String(userId),
+        name || null,
+        time,
+        time,
+        JSON.stringify([...sessions].slice(-40)),
+      );
+    }
+  }
+  // This change was already taken from these same sources.
+  #repeatedFeeling(kind, id, change, cited) {
+    if (!cited.length) return false;
+    const rows = this.db
+      .prepare(
+        `SELECT sources FROM mind_bond_events
+         WHERE subject_kind=? AND subject_id=? AND change=?
+         AND id NOT IN (
+           SELECT target_id FROM mind_revocations WHERE target_kind='bond'
+         )`,
+      )
+      .all(kind, String(id), change);
+    const seen = new Set();
+    for (const row of rows)
+      for (const source of evidenceRoots(this.db, parse(row.sources, [])))
+        seen.add(source);
+    return evidenceRoots(this.db, cited).every((source) => seen.has(source));
+  }
+  // When the cited moment actually happened. Null when nothing can be dated,
+  // so a feeling without a readable source is not treated as late.
+  #evidenceAt(cited) {
+    let newest = null;
+    const take = (time) => {
+      if (Number.isFinite(time) && (newest === null || time > newest))
+        newest = time;
+    };
+    const seqs = messageSeqs(cited);
+    if (seqs.length) {
+      const rows = this.db
+        .prepare(
+          `SELECT time FROM core_events WHERE seq IN (${seqs.map(() => "?").join(",")})`,
+        )
+        .all(...seqs);
+      for (const row of rows) take(row.time);
+    }
+    const meetings = cited
+      .filter((source) => source.startsWith("g:"))
+      .map((source) => source.slice(2));
+    if (meetings.length) {
+      const rows = this.db
+        .prepare(
+          `SELECT created FROM mind_meetings WHERE id IN (${meetings.map(() => "?").join(",")})`,
+        )
+        .all(...meetings);
+      for (const row of rows) take(row.created);
+    }
+    const thoughts = cited
+      .filter((source) => source.startsWith("t:"))
+      .map((source) => source.slice(2));
+    if (thoughts.length) {
+      const rows = this.db
+        .prepare(
+          `SELECT created FROM mind_thoughts WHERE id IN (${thoughts.map(() => "?").join(",")})`,
+        )
+        .all(...thoughts);
+      for (const row of rows) take(row.created);
+    }
+    for (const source of cited) {
+      const day = /^d:(\d{4}-\d{2}-\d{2})$/.exec(source);
+      if (day) take(zonedTime(`${day[1]} 23:59`, this.mind.timeZone()));
+    }
+    return newest;
+  }
+  #staleFeeling(cited, time) {
+    const when = this.#evidenceAt(cited);
+    return when !== null && time - when > FEELING_WINDOW;
+  }
+  record({
+    kind = "person",
+    id,
+    change,
+    note = "",
+    sources = [],
+    session = null,
+    origin = "turn",
+    time = Date.now(),
+  }) {
+    const delta = BOND_CHANGES[change];
+    if (!delta || !id || id === "bot") return null;
+    const cited = evidence(sources);
+    // The same moment cannot be spent again to grow closer, and a feeling
+    // filled in long afterward does not become a meeting that just happened.
+    // An impression can still be written; it does not move the numbers.
+    if (
+      change !== "interaction" &&
+      change !== "impression" &&
+      (this.#repeatedFeeling(kind, id, change, cited) ||
+        this.#staleFeeling(cited, time))
+    )
+      return null;
+    if (change === "interaction") {
+      // One felt "we talked" per person, place and hour keeps the ledger small.
+      const recent = this.db
+        .prepare(
+          "SELECT 1 FROM mind_bond_events WHERE subject_kind=? AND subject_id=? AND change='interaction' AND session_id IS ? AND created>?",
+        )
+        .get(kind, String(id), session, time - HOUR);
+      if (recent) return null;
+    }
+    const row = randomUUID();
+    this.db
+      .prepare(
+        "INSERT INTO mind_bond_events(id,created,subject_kind,subject_id,change,familiarity,closeness,trust,tension,note,sources,session_id,origin) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)",
+      )
+      .run(
+        row,
+        time,
+        kind,
+        String(id),
+        change,
+        delta.familiarity || 0,
+        change === "interaction" && (origin === "direct" || kind === "group")
+          ? 0.005
+          : delta.closeness || 0,
+        delta.trust || 0,
+        delta.tension || 0,
+        text(note, change === "impression" ? 80 : 60),
+        JSON.stringify(cited),
+        session,
+        origin,
+      );
+    return row;
+  }
+  // The whole history is folded once and kept until something new happens
+  // with this person; looking back at an earlier moment always refolds.
+  state(kind, id, now = Date.now()) {
+    const subject = String(id);
+    const meta = this.db
+      .prepare(
+        "SELECT COUNT(*) n, MAX(rowid) r, MAX(created) c, (SELECT COUNT(*) FROM mind_revocations WHERE target_kind='bond') revoked FROM mind_bond_events WHERE subject_kind=? AND subject_id=?",
+      )
+      .get(kind, subject);
+    if (!meta.n) return null;
+    const whole = meta.c <= now;
+    const key = `${kind}:${subject}`;
+    const signature = `${meta.n}:${meta.r}:${meta.revoked}`;
+    const cached = whole ? this.folded.get(key) : null;
+    if (cached?.signature === signature) return settle(cached.state, now);
+    const rows = this.db
+      .prepare(
+        "SELECT * FROM mind_bond_events WHERE subject_kind=? AND subject_id=? AND created<=? AND id NOT IN (SELECT target_id FROM mind_revocations WHERE target_kind='bond') ORDER BY created",
+      )
+      .all(kind, subject, now);
+    if (!rows.length) return null;
+    const state = foldEvents(rows);
+    if (whole) this.folded.set(key, { signature, state });
+    return settle(state, now);
+  }
+  // A private reason stays in that conversation. Another room can still
+  // feel the closeness or the tension, and can still see an older note
+  // that was formed in the open.
+  #noteFits(note, room) {
+    const hidden = new Set();
+    if (note.session && isPrivateSession(note.session))
+      hidden.add(note.session);
+    const sources = parse(note.sources, []);
+    for (const row of this.mind.meetings.places(sources))
+      if (row.discretion === "private" || row.discretion === "secret")
+        hidden.add(row.session_id);
+    for (const id of this.mind.meetings.privateRoots(sources)) hidden.add(id);
+    const seqs = messageSeqs(sources);
+    if (seqs.length) {
+      const found = this.db
+        .prepare(
+          `SELECT DISTINCT session_id FROM core_events WHERE seq IN (${seqs.map(() => "?").join(",")})`,
+        )
+        .all(...seqs);
+      for (const row of found)
+        if (isPrivateSession(row.session_id)) hidden.add(row.session_id);
+    }
+    return !hidden.size || hidden.has(room);
+  }
+  #shownNotes(state, room) {
+    const pick = (kind, current) => {
+      const rows = (state.notes || []).filter((note) => note.kind === kind);
+      if (!room) return rows.at(-1)?.note || current || "";
+      for (let i = rows.length - 1; i >= 0; i--)
+        if (this.#noteFits(rows[i], room)) return rows[i].note;
+      return "";
+    };
+    return {
+      impression: pick("impression", state.impression),
+      why: pick("why", state.why),
+    };
+  }
+  person(userId, now = Date.now(), { room = "" } = {}) {
+    const state = this.state("person", userId, now);
+    const known = this.db
+      .prepare("SELECT * FROM mind_people WHERE user_id=?")
+      .get(String(userId));
+    if (!state && !known) return null;
+    // When she last saw them at all: in a conversation she read or glanced
+    // at, or talking with her. A later sighting is unknowable when looking
+    // back, so it is ignored.
+    const seen = Math.max(
+      known?.last_seen && known.last_seen <= now ? known.last_seen : 0,
+      state?.lastTalkedAt || 0,
+    );
+    const merged = {
+      ...(state || { ...START, interactions: 0 }),
+      firstMetAt:
+        state?.firstMetAt ??
+        (known?.first_seen <= now ? known.first_seen : null),
+      seenAt: seen || null,
+      awayDays: seen ? Math.max(0, Math.floor((now - seen) / DAY)) : null,
+    };
+    const notes = this.#shownNotes(merged, room);
+    const described = { ...merged, ...notes };
+    delete described.notes;
+    if (described.lastTalkedAt == null && described.firstMetAt != null)
+      described.unspokenDays = Math.max(
+        0,
+        Math.floor((now - described.firstMetAt) / DAY),
+      );
+    const feel = describeBond(described);
+    const binding = this.mind.relationships.current(userId, { now, room });
+    const relationship = this.mind.relationships.view(binding, room);
+    delete described.unspokenDays;
+    return {
+      userId: String(userId),
+      name: relationship?.name || known?.name || String(userId),
+      relationship,
+      relationalWeight: this.mind.relationships.weight(binding),
+      sessions: parse(known?.sessions, []),
+      lastSeen: known?.last_seen || null,
+      ...described,
+      feel,
+    };
+  }
+  group(session, now = Date.now()) {
+    const state = this.state("group", session, now);
+    if (!state) return null;
+    const { notes: _notes, ...rest } = state;
+    return { session, ...rest, feel: describeGroup(rest) };
+  }
+  people({ now = Date.now(), limit = 200 } = {}) {
+    return this.db
+      .prepare(
+        "SELECT user_id FROM mind_people ORDER BY last_seen DESC LIMIT ?",
+      )
+      .all(limit)
+      .map((row) => this.person(row.user_id, now))
+      .filter(Boolean);
+  }
+  // People she has grown close to and not heard from in a while.
+  missing({ now = Date.now(), limit = 3, days = 7, closeness = 0.35 } = {}) {
+    return this.db
+      .prepare(
+        "SELECT user_id FROM mind_people WHERE first_seen<=? ORDER BY last_seen DESC LIMIT 300",
+      )
+      .all(now)
+      .map((row) => this.person(row.user_id, now))
+      .filter((p) => p && p.closeness >= closeness && (p.awayDays ?? 0) >= days)
+      .sort((a, b) => b.closeness - a.closeness)
+      .slice(0, limit);
+  }
+  // Close people she still sees, and has not talked with for a while.
+  // Being around is not the same as having talked. Never having talked
+  // still counts: the time starts from when she first met them.
+  quiet({ now = Date.now(), limit = 3, days = 7, closeness = 0.35 } = {}) {
+    return this.db
+      .prepare(
+        "SELECT user_id FROM mind_people WHERE first_seen<=? ORDER BY last_seen DESC LIMIT 300",
+      )
+      .all(now)
+      .map((row) => this.person(row.user_id, now))
+      .filter((p) => {
+        if (!p || p.closeness < closeness || (p.awayDays ?? 0) >= 3)
+          return false;
+        const silentFor =
+          p.absentDays ??
+          (p.firstMetAt != null
+            ? Math.max(0, Math.floor((now - p.firstMetAt) / DAY))
+            : 0);
+        return silentFor >= days;
+      })
+      .sort((a, b) => {
+        const span = (p) =>
+          p.absentDays ??
+          (p.firstMetAt != null ? Math.floor((now - p.firstMetAt) / DAY) : 0);
+        return span(b) - span(a);
+      })
+      .slice(0, limit);
+  }
+  groups(now = Date.now()) {
+    return this.db
+      .prepare(
+        "SELECT DISTINCT subject_id FROM mind_bond_events WHERE subject_kind='group'",
+      )
+      .all()
+      .map((row) => this.group(row.subject_id, now))
+      .filter(Boolean);
+  }
+  changes(kind, id, limit = 40) {
+    return this.db
+      .prepare(
+        "SELECT e.*, EXISTS(SELECT 1 FROM mind_revocations r WHERE r.target_kind='bond' AND r.target_id=e.id) revoked FROM mind_bond_events e WHERE e.subject_kind=? AND e.subject_id=? AND e.change!='interaction' ORDER BY e.created DESC LIMIT ?",
+      )
+      .all(kind, String(id), limit)
+      .map((row) => ({
+        ...row,
+        revoked: !!row.revoked,
+        sources: JSON.parse(row.sources),
+      }));
+  }
+  name(userId) {
+    return (
+      this.db
+        .prepare("SELECT name FROM mind_people WHERE user_id=?")
+        .get(String(userId))?.name || ""
+    );
+  }
+}