chatlab-cli 0.30.2 → 0.31.1

package/dist/{chunk-LVEJHB3X.mjs → chunk-DQ45LDKZ.mjs}

@@ -2830,7 +2830,8 @@ function getChatSessionList(db) {
           cs.message_count as messageCount,
           cs.summary,
           (SELECT mc.message_id FROM message_context mc
-           WHERE mc.segment_id = cs.id ORDER BY mc.message_id LIMIT 1) as firstMessageId
+           JOIN message first_msg ON first_msg.id = mc.message_id
+           WHERE mc.segment_id = cs.id ORDER BY first_msg.ts ASC, first_msg.id ASC LIMIT 1) as firstMessageId
         FROM segment cs
         ORDER BY cs.start_ts ASC`
     ).all();
@@ -3899,6 +3900,348 @@ function notGroupSelfMemberCondition(db, memberAlias) {
   )`;
 }
 
+// ../../packages/core/src/owner/owner-matching.ts
+var NAME_MATCH_PLATFORMS = /* @__PURE__ */ new Set(["whatsapp", "line", "instagram"]);
+function isNameMatchPlatform(platform) {
+  return NAME_MATCH_PLATFORMS.has(platform);
+}
+var INVISIBLE_CHARS_RE = /[\u200B-\u200F\u202A-\u202E\u2060-\u2064\u2066-\u2069\uFEFF]/g;
+function normalizeOwnerName(name) {
+  return name.replace(INVISIBLE_CHARS_RE, "").normalize("NFKC").replace(/\s+/g, " ").trim().toLowerCase();
+}
+function collectCandidateNames(member) {
+  const names = [
+    member.platformId,
+    member.accountName ?? "",
+    member.groupNickname ?? "",
+    ...member.aliases ?? [],
+    member.displayName ?? ""
+  ];
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const name of names) {
+    if (!name || !name.trim()) continue;
+    if (seen.has(name)) continue;
+    seen.add(name);
+    result.push(name);
+  }
+  return result;
+}
+function mergeConfirmedNames(existing, member) {
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const name of [...existing, ...collectCandidateNames(member)]) {
+    if (!name || !name.trim()) continue;
+    if (seen.has(name)) continue;
+    seen.add(name);
+    result.push(name);
+  }
+  return result;
+}
+function matchOwnerProfile(platform, profile, members) {
+  const exact = members.find((m) => m.platformId === profile.platformId);
+  if (exact) {
+    return { type: "exact", platformId: exact.platformId };
+  }
+  if (!isNameMatchPlatform(platform)) {
+    return { type: "none" };
+  }
+  const confirmed = new Set(profile.confirmedNames.map(normalizeOwnerName).filter((n) => n.length > 0));
+  if (confirmed.size === 0) {
+    return { type: "none" };
+  }
+  const matched = members.filter(
+    (m) => collectCandidateNames(m).some((name) => confirmed.has(normalizeOwnerName(name)))
+  );
+  if (matched.length === 1) {
+    return { type: "name", platformId: matched[0].platformId };
+  }
+  if (matched.length > 1) {
+    return { type: "ambiguous", platformIds: matched.map((m) => m.platformId) };
+  }
+  return { type: "none" };
+}
+
+// ../../packages/core/src/query/contact-identity.ts
+function shouldScopeContactToSession(platform, contact) {
+  if (isNameMatchPlatform(platform)) return true;
+  return platform.trim().toLowerCase() === "qq" && contact.platformId.trim() === contact.name.trim();
+}
+function buildContactKey(platform, platformId, sessionId) {
+  const normalizedPlatform = platform.trim();
+  const normalizedPlatformId = platformId.trim();
+  if (!normalizedPlatform) throw new Error("platform is required");
+  if (!normalizedPlatformId) throw new Error("platformId is required");
+  return sessionId?.trim() ? `${normalizedPlatform}:${sessionId.trim()}:${normalizedPlatformId}` : `${normalizedPlatform}:${normalizedPlatformId}`;
+}
+
+// ../../packages/shared-types/index.ts
+var KNOWN_PLATFORMS = {
+  QQ: "qq",
+  WECHAT: "weixin",
+  DISCORD: "discord",
+  WHATSAPP: "whatsapp",
+  TELEGRAM: "telegram",
+  INSTAGRAM: "instagram",
+  GOOGLE_CHAT: "google-chat",
+  LINE: "line",
+  UNKNOWN: "unknown"
+};
+var CONTACTS_TIME_RANGE_PRESETS = ["1y", "2y", "3y", "5y", "all"];
+
+// ../../packages/core/src/query/global-insight.ts
+var SYSTEM_MESSAGE_TYPES2 = [80 /* SYSTEM */, 81 /* RECALL */];
+function getAnnualSummarySessionFacts(db, sessionId, range) {
+  if (!isChatSessionDb(db)) return emptyFacts("not_chat_db");
+  const meta = getSessionMeta(db);
+  if (!meta) return emptyFacts("missing_meta");
+  if (meta.type !== "private" /* PRIVATE */ && meta.type !== "group" /* GROUP */) return emptyFacts("unsupported_type");
+  if (!meta.ownerId?.trim()) return emptyFacts("missing_owner");
+  const owner = resolveOwnerMember(db);
+  if (!owner) return emptyFacts("unresolved_owner");
+  const contacts = getNonSystemMembersForContacts(db).filter((member) => member.id !== owner.id);
+  let privateContact = null;
+  if (meta.type === "private" /* PRIVATE */) {
+    const activeContacts = getActivePrivateContacts(db, contacts, owner.id, range);
+    const candidates = activeContacts.length > 0 ? activeContacts : contacts;
+    if (candidates.length === 0) return emptyFacts("private_missing");
+    if (candidates.length > 1) return emptyFacts("private_ambiguous");
+    privateContact = candidates[0];
+  }
+  const ownerMessagesByDay = rowsToNumberRecord(
+    db.prepare(
+      `SELECT strftime('%Y-%m-%d', msg.ts, 'unixepoch', 'localtime') as key, COUNT(*) as count
+         FROM message msg
+         WHERE msg.sender_id = ? AND msg.ts >= ? AND msg.ts <= ?
+           AND msg.type NOT IN (${SYSTEM_MESSAGE_TYPES2.join(", ")})
+         GROUP BY key ORDER BY key`
+    ).all(owner.id, range.startTs, range.endTs)
+  );
+  const messageTypeCounts = rowsToNumberRecord(
+    db.prepare(
+      `SELECT CAST(msg.type AS TEXT) as key, COUNT(*) as count
+         FROM message msg
+         WHERE msg.sender_id = ? AND msg.ts >= ? AND msg.ts <= ?
+           AND msg.type NOT IN (${SYSTEM_MESSAGE_TYPES2.join(", ")})
+         GROUP BY msg.type ORDER BY msg.type`
+    ).all(owner.id, range.startTs, range.endTs)
+  );
+  const textLengthCounts = rowsToNumberRecord(
+    db.prepare(
+      `SELECT CAST(LENGTH(msg.content) AS TEXT) as key, COUNT(*) as count
+         FROM message msg
+         WHERE msg.sender_id = ? AND msg.ts >= ? AND msg.ts <= ?
+           AND msg.type = ${0 /* TEXT */} AND msg.content IS NOT NULL AND LENGTH(msg.content) > 0
+         GROUP BY LENGTH(msg.content) ORDER BY LENGTH(msg.content)`
+    ).all(owner.id, range.startTs, range.endTs)
+  );
+  const availableDataYears = db.prepare(
+    `SELECT DISTINCT CAST(strftime('%Y', msg.ts, 'unixepoch', 'localtime') AS INTEGER) as year
+         FROM message msg
+         WHERE msg.sender_id = ? AND msg.type NOT IN (${SYSTEM_MESSAGE_TYPES2.join(", ")})
+         ORDER BY year DESC`
+  ).all(owner.id).map((row) => row.year);
+  return {
+    kind: "analyzed",
+    availableDataYears,
+    ownerMessagesByDay,
+    directContactKeysByDay: meta.type === "private" /* PRIVATE */ && privateContact ? getPrivateDirectContactsByDay(db, sessionId, meta.platform, owner.id, privateContact, range) : getGroupDirectContactsByDay(db, sessionId, meta.platform, owner.id, contacts, range),
+    messageTypeCounts,
+    textLengthCounts
+  };
+}
+function aggregateAnnualSummaryFacts(facts, range, elapsedDayCount) {
+  const ownerMessagesByDay = /* @__PURE__ */ new Map();
+  const directContactsByDay = /* @__PURE__ */ new Map();
+  const directContacts = /* @__PURE__ */ new Set();
+  const messageTypes = /* @__PURE__ */ new Map();
+  const textLengths = /* @__PURE__ */ new Map();
+  const availableDataYears = /* @__PURE__ */ new Set();
+  const coverage = {
+    totalSessions: 0,
+    analyzedSessions: 0,
+    missingOwnerSessions: 0,
+    unresolvedOwnerSessions: 0,
+    failedSessions: 0
+  };
+  for (const item of facts) {
+    if (item.kind === "not_chat_db" || item.kind === "missing_meta" || item.kind === "unsupported_type") continue;
+    coverage.totalSessions++;
+    if (item.kind === "missing_owner") {
+      coverage.missingOwnerSessions++;
+      continue;
+    }
+    if (item.kind === "unresolved_owner") {
+      coverage.unresolvedOwnerSessions++;
+      continue;
+    }
+    if (item.kind !== "analyzed") {
+      coverage.failedSessions++;
+      continue;
+    }
+    coverage.analyzedSessions++;
+    item.availableDataYears.forEach((year) => availableDataYears.add(year));
+    mergeNumberRecord(ownerMessagesByDay, item.ownerMessagesByDay);
+    mergeNumberRecord(messageTypes, item.messageTypeCounts, Number);
+    mergeNumberRecord(textLengths, item.textLengthCounts, Number);
+    for (const [date, keys] of Object.entries(item.directContactKeysByDay)) {
+      const daily = directContactsByDay.get(date) ?? /* @__PURE__ */ new Set();
+      keys.forEach((key) => {
+        daily.add(key);
+        directContacts.add(key);
+      });
+      directContactsByDay.set(date, daily);
+    }
+  }
+  const dailyActivity = [...ownerMessagesByDay.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([date, messageCount]) => ({ date, messageCount }));
+  const sentMessageCount = dailyActivity.reduce((sum, item) => sum + item.messageCount, 0);
+  const dailyDirectContactTotal = [...directContactsByDay.values()].reduce((sum, keys) => sum + keys.size, 0);
+  const years = [...availableDataYears].sort((a, b) => b - a);
+  return {
+    availableDataYears: years,
+    latestDataYear: years[0] ?? null,
+    metrics: {
+      sentMessageCount,
+      activeDayCount: dailyActivity.length,
+      directContactCount: directContacts.size,
+      averageMessagesPerDay: roundAverage(sentMessageCount, elapsedDayCount),
+      averageDirectContactsPerDay: roundAverage(dailyDirectContactTotal, elapsedDayCount)
+    },
+    monthlyActivity: buildMonthlyActivity(range, ownerMessagesByDay),
+    dailyActivity,
+    messageTypes: [...messageTypes.entries()].sort(([a], [b]) => a - b).map(([type, count]) => ({ type, count })),
+    textLength: buildTextLengthSummary(textLengths),
+    coverage
+  };
+}
+function getActivePrivateContacts(db, contacts, ownerId, range) {
+  if (contacts.length <= 1) return contacts;
+  const byId = new Map(contacts.map((contact) => [contact.id, contact]));
+  const rows = db.prepare(
+    `SELECT DISTINCT msg.sender_id as senderId FROM message msg
+       WHERE msg.sender_id <> ? AND msg.ts >= ? AND msg.ts <= ?
+         AND msg.type NOT IN (${SYSTEM_MESSAGE_TYPES2.join(", ")})`
+  ).all(ownerId, range.startTs, range.endTs);
+  return rows.map((row) => byId.get(row.senderId)).filter((contact) => Boolean(contact));
+}
+function getPrivateDirectContactsByDay(db, sessionId, platform, ownerId, contact, range) {
+  const rows = db.prepare(
+    `SELECT DISTINCT strftime('%Y-%m-%d', msg.ts, 'unixepoch', 'localtime') as date
+       FROM message msg
+       WHERE msg.sender_id IN (?, ?) AND msg.ts >= ? AND msg.ts <= ?
+         AND msg.type NOT IN (${SYSTEM_MESSAGE_TYPES2.join(", ")})
+       ORDER BY date`
+  ).all(ownerId, contact.id, range.startTs, range.endTs);
+  const key = buildContactKey(
+    platform,
+    contact.platformId,
+    shouldScopeContactToSession(platform, contact) ? sessionId : void 0
+  );
+  return Object.fromEntries(rows.map((row) => [row.date, [key]]));
+}
+function getGroupDirectContactsByDay(db, sessionId, platform, ownerId, contacts, range) {
+  const byId = new Map(contacts.map((contact) => [contact.id, contact]));
+  const rows = db.prepare(
+    `SELECT
+         strftime('%Y-%m-%d', msg.ts, 'unixepoch', 'localtime') as date,
+         msg.sender_id as replySenderId,
+         target.sender_id as targetSenderId
+       FROM message msg
+       JOIN message target ON msg.reply_to_message_id = target.platform_message_id
+       WHERE msg.ts >= ? AND msg.ts <= ? AND msg.reply_to_message_id IS NOT NULL
+         AND msg.type NOT IN (${SYSTEM_MESSAGE_TYPES2.join(", ")})`
+  ).all(range.startTs, range.endTs);
+  const byDay = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const contactId = row.replySenderId === ownerId ? row.targetSenderId : row.targetSenderId === ownerId ? row.replySenderId : null;
+    if (contactId === null) continue;
+    const contact = byId.get(contactId);
+    if (!contact) continue;
+    const key = buildContactKey(
+      platform,
+      contact.platformId,
+      shouldScopeContactToSession(platform, contact) ? sessionId : void 0
+    );
+    const keys = byDay.get(row.date) ?? /* @__PURE__ */ new Set();
+    keys.add(key);
+    byDay.set(row.date, keys);
+  }
+  return Object.fromEntries([...byDay.entries()].map(([date, keys]) => [date, [...keys].sort()]));
+}
+function buildMonthlyActivity(range, ownerMessagesByDay) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const [date, count] of ownerMessagesByDay) {
+    const month = date.slice(0, 7);
+    counts.set(month, (counts.get(month) ?? 0) + count);
+  }
+  return listMonths(range).map((month) => ({ month, messageCount: counts.get(month) ?? 0 }));
+}
+function listMonths(range) {
+  if (range.mode === "year" && range.year) {
+    return Array.from({ length: 12 }, (_, index) => `${range.year}-${String(index + 1).padStart(2, "0")}`);
+  }
+  const current = new Date(range.startTs * 1e3);
+  current.setDate(1);
+  current.setHours(0, 0, 0, 0);
+  const end = new Date(range.endTs * 1e3);
+  const result = [];
+  while (current <= end) {
+    result.push(`${current.getFullYear()}-${String(current.getMonth() + 1).padStart(2, "0")}`);
+    current.setMonth(current.getMonth() + 1);
+  }
+  return result;
+}
+function buildTextLengthSummary(lengths) {
+  const textMessageCount = [...lengths.values()].reduce((sum, count) => sum + count, 0);
+  return {
+    textMessageCount,
+    median: weightedPercentile(lengths, 0.5),
+    p90: weightedPercentile(lengths, 0.9),
+    buckets: [
+      { key: "1-10", count: countLengthRange(lengths, 1, 10) },
+      { key: "11-30", count: countLengthRange(lengths, 11, 30) },
+      { key: "31-100", count: countLengthRange(lengths, 31, 100) },
+      { key: "101-300", count: countLengthRange(lengths, 101, 300) },
+      { key: "300+", count: countLengthRange(lengths, 301, Number.POSITIVE_INFINITY) }
+    ]
+  };
+}
+function weightedPercentile(lengths, percentile) {
+  const entries = [...lengths.entries()].sort(([a], [b]) => a - b);
+  const total = entries.reduce((sum, [, count]) => sum + count, 0);
+  if (total === 0) return null;
+  const target = Math.floor((total - 1) * percentile);
+  let seen = 0;
+  for (const [length, count] of entries) {
+    seen += count;
+    if (seen > target) return length;
+  }
+  return entries.at(-1)?.[0] ?? null;
+}
+function countLengthRange(lengths, min, max) {
+  let count = 0;
+  for (const [length, value] of lengths) {
+    if (length >= min && length <= max) count += value;
+  }
+  return count;
+}
+function rowsToNumberRecord(rows) {
+  return Object.fromEntries(rows.filter((row) => row.key).map((row) => [row.key, row.count]));
+}
+function mergeNumberRecord(target, source, mapKey = (key) => key) {
+  for (const [key, value] of Object.entries(source)) {
+    const mapped = mapKey(key);
+    target.set(mapped, (target.get(mapped) ?? 0) + value);
+  }
+}
+function roundAverage(total, days) {
+  if (days <= 0) return 0;
+  return Math.round(total / days * 100) / 100;
+}
+function emptyFacts(kind) {
+  return { kind, availableDataYears: [] };
+}
+
 // ../../packages/core/src/query/contact-enablement.ts
 var MIN_PRIVATE_SESSIONS_FOR_CONTACTS = 5;
 var MIN_GROUP_SESSIONS_FOR_CONTACTS = 1;
@@ -5890,20 +6233,6 @@ function getRepeatAnalysis(db, filter) {
   return computeRepeat(messages);
 }
 
-// ../../packages/shared-types/index.ts
-var KNOWN_PLATFORMS = {
-  QQ: "qq",
-  WECHAT: "weixin",
-  DISCORD: "discord",
-  WHATSAPP: "whatsapp",
-  TELEGRAM: "telegram",
-  INSTAGRAM: "instagram",
-  GOOGLE_CHAT: "google-chat",
-  LINE: "line",
-  UNKNOWN: "unknown"
-};
-var CONTACTS_TIME_RANGE_PRESETS = ["1y", "2y", "3y", "5y", "all"];
-
 // ../../packages/core/src/message-type.ts
 var TYPE_STRING_MAP = {
   [0 /* TEXT */]: "text",
@@ -7093,68 +7422,6 @@ function isValidWord(word, locale, minLength, enableStopwords, isStopwordFn) {
   return true;
 }
 
-// ../../packages/core/src/owner/owner-matching.ts
-var NAME_MATCH_PLATFORMS = /* @__PURE__ */ new Set(["whatsapp", "line", "instagram"]);
-function isNameMatchPlatform(platform) {
-  return NAME_MATCH_PLATFORMS.has(platform);
-}
-var INVISIBLE_CHARS_RE = /[\u200B-\u200F\u202A-\u202E\u2060-\u2064\u2066-\u2069\uFEFF]/g;
-function normalizeOwnerName(name) {
-  return name.replace(INVISIBLE_CHARS_RE, "").normalize("NFKC").replace(/\s+/g, " ").trim().toLowerCase();
-}
-function collectCandidateNames(member) {
-  const names = [
-    member.platformId,
-    member.accountName ?? "",
-    member.groupNickname ?? "",
-    ...member.aliases ?? [],
-    member.displayName ?? ""
-  ];
-  const result = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const name of names) {
-    if (!name || !name.trim()) continue;
-    if (seen.has(name)) continue;
-    seen.add(name);
-    result.push(name);
-  }
-  return result;
-}
-function mergeConfirmedNames(existing, member) {
-  const result = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const name of [...existing, ...collectCandidateNames(member)]) {
-    if (!name || !name.trim()) continue;
-    if (seen.has(name)) continue;
-    seen.add(name);
-    result.push(name);
-  }
-  return result;
-}
-function matchOwnerProfile(platform, profile, members) {
-  const exact = members.find((m) => m.platformId === profile.platformId);
-  if (exact) {
-    return { type: "exact", platformId: exact.platformId };
-  }
-  if (!isNameMatchPlatform(platform)) {
-    return { type: "none" };
-  }
-  const confirmed = new Set(profile.confirmedNames.map(normalizeOwnerName).filter((n) => n.length > 0));
-  if (confirmed.size === 0) {
-    return { type: "none" };
-  }
-  const matched = members.filter(
-    (m) => collectCandidateNames(m).some((name) => confirmed.has(normalizeOwnerName(name)))
-  );
-  if (matched.length === 1) {
-    return { type: "name", platformId: matched[0].platformId };
-  }
-  if (matched.length > 1) {
-    return { type: "ambiguous", platformIds: matched.map((m) => m.platformId) };
-  }
-  return { type: "none" };
-}
-
 // ../../packages/core/src/import/dedup.ts
 function fnv1a64(input) {
   let h0 = 2166136261;
@@ -8479,21 +8746,132 @@ function getContactsFactsCacheDir(userDataDir) {
   return path16.join(getContactsDir(userDataDir), CONTACTS_FACTS_DIR_NAME);
 }
 
-// ../../packages/node-runtime/src/services/people/relationships/paths.ts
+// ../../packages/node-runtime/src/services/global-insight/paths.ts
 import path17 from "path";
+function getGlobalInsightDir(userDataDir) {
+  return path17.join(userDataDir, "insight", "annual-summary");
+}
+function getGlobalInsightFactsCacheDir(userDataDir) {
+  return path17.join(getGlobalInsightDir(userDataDir), "facts");
+}
+
+// ../../packages/node-runtime/src/services/people/relationships/paths.ts
+import path18 from "path";
 var PEOPLE_DIR_NAME = "people";
 var RELATIONSHIPS_DIR_NAME = "relationships";
 var RELATIONSHIPS_FACTS_DIR_NAME = "facts";
 function getPeopleRelationshipsDir(userDataDir) {
-  return path17.join(userDataDir, PEOPLE_DIR_NAME, RELATIONSHIPS_DIR_NAME);
+  return path18.join(userDataDir, PEOPLE_DIR_NAME, RELATIONSHIPS_DIR_NAME);
 }
 function getPeopleRelationshipsFactsCacheDir(userDataDir) {
-  return path17.join(getPeopleRelationshipsDir(userDataDir), RELATIONSHIPS_FACTS_DIR_NAME);
+  return path18.join(getPeopleRelationshipsDir(userDataDir), RELATIONSHIPS_FACTS_DIR_NAME);
+}
+
+// ../../packages/node-runtime/src/database-manager.ts
+import * as fs17 from "fs";
+import * as path20 from "path";
+
+// ../../packages/node-runtime/src/services/global-insight/snapshot.ts
+import fs16 from "fs";
+import path19 from "path";
+
+// ../../packages/node-runtime/src/services/global-insight/time-range.ts
+function normalizeAnnualSummaryRange(input, nowInput = /* @__PURE__ */ new Date()) {
+  const now = new Date(nowInput);
+  const nowTs = Math.floor(now.getTime() / 1e3);
+  if (input.mode === "recent") {
+    const start2 = new Date(now);
+    start2.setHours(0, 0, 0, 0);
+    start2.setDate(start2.getDate() - 364);
+    return {
+      mode: "recent",
+      days: 365,
+      startTs: Math.floor(start2.getTime() / 1e3),
+      endTs: nowTs
+    };
+  }
+  const currentYear = now.getFullYear();
+  const parsedYear = Number(input.year);
+  const year = Number.isInteger(parsedYear) && parsedYear >= 1970 && parsedYear <= currentYear ? parsedYear : currentYear;
+  const start = new Date(year, 0, 1, 0, 0, 0);
+  const end = year === currentYear ? now : new Date(year, 11, 31, 23, 59, 59);
+  return {
+    mode: "year",
+    year,
+    startTs: Math.floor(start.getTime() / 1e3),
+    endTs: Math.floor(end.getTime() / 1e3)
+  };
+}
+function getAnnualSummaryElapsedDayCount(range) {
+  const start = new Date(range.startTs * 1e3);
+  const end = new Date(range.endTs * 1e3);
+  const startDay = Date.UTC(start.getFullYear(), start.getMonth(), start.getDate());
+  const endDay = Date.UTC(end.getFullYear(), end.getMonth(), end.getDate());
+  return Math.max(Math.floor((endDay - startDay) / 864e5) + 1, 0);
+}
+function toAnnualSummaryRangeKey(range) {
+  return range.mode === "year" ? `year-${range.year}` : "recent-365";
+}
+function toAnnualSummaryLocalDate(range) {
+  const date = new Date(range.endTs * 1e3);
+  return [
+    date.getFullYear(),
+    String(date.getMonth() + 1).padStart(2, "0"),
+    String(date.getDate()).padStart(2, "0")
+  ].join("-");
+}
+
+// ../../packages/node-runtime/src/services/global-insight/snapshot.ts
+var SNAPSHOT_TMP_PREFIX = "annual-summary.tmp-";
+function getAnnualSummarySnapshotPath(snapshotDir, range) {
+  return path19.join(snapshotDir, `annual-summary-${toAnnualSummaryRangeKey(range)}.json`);
+}
+function readAnnualSummarySnapshot(snapshotDir, range, options = {}) {
+  const snapshotPath = getAnnualSummarySnapshotPath(snapshotDir, range);
+  if (!fs16.existsSync(snapshotPath)) return null;
+  try {
+    return JSON.parse(fs16.readFileSync(snapshotPath, "utf-8"));
+  } catch (error) {
+    const backupPath = path19.join(snapshotDir, `annual-summary.corrupt-${options.now?.() ?? Date.now()}.json`);
+    try {
+      fs16.renameSync(snapshotPath, backupPath);
+    } catch (renameError) {
+      appLogger.warn("global-insight", "failed to backup corrupt annual summary snapshot", renameError);
+    }
+    appLogger.warn("global-insight", "annual summary snapshot is corrupt", error);
+    return null;
+  }
+}
+function writeAnnualSummarySnapshot(snapshotDir, snapshot) {
+  fs16.mkdirSync(snapshotDir, { recursive: true });
+  const tmpPath = path19.join(snapshotDir, `${SNAPSHOT_TMP_PREFIX}${process.pid}-${Date.now()}`);
+  fs16.writeFileSync(tmpPath, JSON.stringify(snapshot, null, 2), "utf-8");
+  fs16.renameSync(tmpPath, getAnnualSummarySnapshotPath(snapshotDir, snapshot.range));
+}
+function cleanupAnnualSummarySnapshotTempFiles(snapshotDir) {
+  if (!fs16.existsSync(snapshotDir)) return;
+  for (const name of fs16.readdirSync(snapshotDir)) {
+    if (!name.startsWith(SNAPSHOT_TMP_PREFIX)) continue;
+    try {
+      fs16.rmSync(path19.join(snapshotDir, name), { force: true });
+    } catch (error) {
+      appLogger.warn("global-insight", "failed to remove annual summary snapshot temp file", error);
+    }
+  }
+}
+function deleteAnnualSummarySnapshots(snapshotDir) {
+  if (!fs16.existsSync(snapshotDir)) return;
+  for (const name of fs16.readdirSync(snapshotDir)) {
+    if (!name.startsWith("annual-summary-") && !name.startsWith("annual-summary.")) continue;
+    try {
+      fs16.rmSync(path19.join(snapshotDir, name), { force: true });
+    } catch (error) {
+      appLogger.warn("global-insight", "failed to remove annual summary snapshot", error);
+    }
+  }
 }
 
 // ../../packages/node-runtime/src/database-manager.ts
-import * as fs16 from "fs";
-import * as path18 from "path";
 function createMigrationDeps(overrides) {
   return {
     tokenizeForFts,
@@ -8524,7 +8902,7 @@ var DatabaseManager = class {
       return this.cache.get(sessionId);
     }
     const dbPath = this.getDbPath(sessionId);
-    if (!fs16.existsSync(dbPath)) return null;
+    if (!fs17.existsSync(dbPath)) return null;
     this.migrateIfNeeded(dbPath);
     this.assertCompatible();
     const adapter = openBetterSqliteDatabase(dbPath, {
@@ -8570,7 +8948,7 @@ var DatabaseManager = class {
       this.cache.delete(sessionId);
     }
     const dbPath = this.getDbPath(sessionId);
-    if (!fs16.existsSync(dbPath)) return null;
+    if (!fs17.existsSync(dbPath)) return null;
     const adapter = openBetterSqliteDatabase(dbPath, {
       readonly: false,
       nativeBinding: this.nativeBinding
@@ -8610,28 +8988,47 @@ var DatabaseManager = class {
   listSessionIds() {
     this.assertCompatible();
     const dbDir = this.pathProvider.getDatabaseDir();
-    if (!fs16.existsSync(dbDir)) return [];
-    return fs16.readdirSync(dbDir).filter((f) => f.endsWith(".db")).map((f) => f.replace(".db", "")).filter((id) => {
+    if (!fs17.existsSync(dbDir)) return [];
+    return fs17.readdirSync(dbDir).filter((f) => f.endsWith(".db")).map((f) => f.replace(".db", "")).filter((id) => {
       const db = this.open(id);
       if (!db) return false;
       return isChatSessionDb(db);
     });
   }
+  /**
+   * 只读列举聊天会话 ID，不触发数据库迁移或兼容门禁提升。
+   */
+  listSessionIdsReadonly() {
+    this.assertCompatible();
+    const dbDir = this.pathProvider.getDatabaseDir();
+    if (!fs17.existsSync(dbDir)) return [];
+    return fs17.readdirSync(dbDir).filter((fileName) => fileName.endsWith(".db")).map((fileName) => fileName.replace(".db", "")).filter((sessionId) => {
+      const db = this.openRawSessionDatabase(sessionId, { readonly: true });
+      try {
+        return isChatSessionDb(db);
+      } finally {
+        db.close();
+      }
+    });
+  }
+  getUserDataDir() {
+    return this.pathProvider.getUserDataDir();
+  }
   /**
    * 获取数据库文件路径
    */
   getDbPath(sessionId) {
-    return path18.join(this.pathProvider.getDatabaseDir(), `${sessionId}.db`);
+    return path20.join(this.pathProvider.getDatabaseDir(), `${sessionId}.db`);
   }
   openRawSessionDatabase(sessionId, options = {}) {
     this.assertCompatible();
     const dbPath = this.getDbPath(sessionId);
-    if (!options.create && !fs16.existsSync(dbPath)) {
+    if (!options.create && !fs17.existsSync(dbPath)) {
       throw new Error(`Session database not found: ${sessionId}`);
     }
     if (!options.readonly) {
       this.close(sessionId);
-      fs16.mkdirSync(path18.dirname(dbPath), { recursive: true });
+      fs17.mkdirSync(path20.dirname(dbPath), { recursive: true });
     }
     const adapter = openBetterSqliteDatabase(dbPath, {
       readonly: options.readonly ?? false,
@@ -8649,18 +9046,20 @@ var DatabaseManager = class {
   deleteSessionDatabaseFiles(sessionId) {
     this.close(sessionId);
     const dbPath = this.getDbPath(sessionId);
-    const existed = ["", "-wal", "-shm"].some((suffix) => fs16.existsSync(dbPath + suffix));
+    const existed = ["", "-wal", "-shm"].some((suffix) => fs17.existsSync(dbPath + suffix));
     for (const suffix of ["", "-wal", "-shm"]) {
       try {
         const filePath = dbPath + suffix;
-        if (fs16.existsSync(filePath)) fs16.unlinkSync(filePath);
+        if (fs17.existsSync(filePath)) fs17.unlinkSync(filePath);
       } catch {
       }
     }
     const cacheDir = this.pathProvider.getCacheDir();
     deleteSessionCache(sessionId, cacheDir);
-    deleteSessionCache(sessionId, path18.join(cacheDir, "query"));
+    deleteSessionCache(sessionId, path20.join(cacheDir, "query"));
     deleteSessionCache(sessionId, getContactsFactsCacheDir(this.pathProvider.getUserDataDir()));
+    deleteSessionCache(sessionId, getGlobalInsightFactsCacheDir(this.pathProvider.getUserDataDir()));
+    deleteAnnualSummarySnapshots(getGlobalInsightDir(this.pathProvider.getUserDataDir()));
     deleteSessionCache(sessionId, getPeopleRelationshipsFactsCacheDir(this.pathProvider.getUserDataDir()));
     return existed;
   }
@@ -8698,12 +9097,12 @@ function shouldRepairCompatibilityGate(schemaVersion) {
 }
 
 // ../../packages/node-runtime/src/cache/analytics-cache.ts
-import * as fs17 from "fs";
+import * as fs18 from "fs";
 function getDbFileVersion(dbPath) {
   const parts = [];
   for (const p of [dbPath, `${dbPath}-wal`]) {
     try {
-      const st = fs17.statSync(p);
+      const st = fs18.statSync(p);
       parts.push(`${Math.floor(st.mtimeMs)}:${st.size}`);
     } catch {
       parts.push("-");
@@ -8866,6 +9265,13 @@ export {
   getPrivateContactFacts,
   getGroupContactFacts,
   getGroupRelationshipGraphFacts,
+  isNameMatchPlatform,
+  mergeConfirmedNames,
+  matchOwnerProfile,
+  shouldScopeContactToSession,
+  buildContactKey,
+  getAnnualSummarySessionFacts,
+  aggregateAnnualSummaryFacts,
   shouldEnableContactsEntry,
   computeFriendScores,
   computeNonFriendScores,
@@ -8916,9 +9322,6 @@ export {
   isReasoningModel,
   getThinkingCompat,
   truncateToolResultText,
-  isNameMatchPlatform,
-  mergeConfirmedNames,
-  matchOwnerProfile,
   generateMessageKey,
   getCollidingPlatformIds,
   normalizePlatformId,
@@ -8959,6 +9362,17 @@ export {
   getChatDbMigrations,
   getContactsDir,
   getContactsFactsCacheDir,
+  getGlobalInsightDir,
+  getGlobalInsightFactsCacheDir,
+  normalizeAnnualSummaryRange,
+  getAnnualSummaryElapsedDayCount,
+  toAnnualSummaryRangeKey,
+  toAnnualSummaryLocalDate,
+  getAnnualSummarySnapshotPath,
+  readAnnualSummarySnapshot,
+  writeAnnualSummarySnapshot,
+  cleanupAnnualSummarySnapshotTempFiles,
+  deleteAnnualSummarySnapshots,
   getPeopleRelationshipsDir,
   getPeopleRelationshipsFactsCacheDir,
   DatabaseManager,
@@ -8968,4 +9382,4 @@ export {
   StaticPathProvider,
   createDatabaseManagerAdapter
 };
-//# sourceMappingURL=chunk-LVEJHB3X.mjs.map
+//# sourceMappingURL=chunk-DQ45LDKZ.mjs.map