@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/store/sqlite/query-filter.d.ts

@@ -0,0 +1,27 @@
+import { type FieldType, type Predicate, type QueryAst, type QueryContext } from "@wirecat/cli-base/query";
+import type { SqlValue } from "../driver.js";
+export interface Where {
+    sql: string;
+    params: SqlValue[];
+}
+/**
+ * How a list's store answers one field. A column names its SQL expression; times are epoch milliseconds,
+ * booleans 0 or 1. A field that is not one column — words, a relation, an array — builds its own condition.
+ */
+export type ColumnMap = Readonly<Record<string, {
+    type: Exclude<FieldType, "txt">;
+    sql: string;
+} | {
+    where: (node: Predicate) => Where;
+}>>;
+export interface FilterOptions extends QueryContext {
+    zone?: string;
+    now?: number;
+}
+/**
+ * A validated list query as a `WHERE` condition with bound parameters, matching cli-base's `evaluate`: kw, enum
+ * and ref compare without case (SQLite's `lower()` folds ASCII only), a lone NOT means everything else, and a
+ * `should` clause counts only when nothing is required.
+ */
+export declare const queryFilter: (ast: QueryAst, columns: ColumnMap, options?: FilterOptions) => Where;
+//# sourceMappingURL=query-filter.d.ts.map

package/dist/store/sqlite/query-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-filter.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/query-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,YAAY,EAGlB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,QAAQ,EAAE,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAC9B,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,KAAK,CAAA;CAAE,CAAC,CACzG,CAAA;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAgFD;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAS,QAAQ,WAAW,SAAS,YAAW,aAAa,KAAQ,KACxD,CAAA"}

package/dist/store/sqlite/query-filter.js

@@ -0,0 +1,74 @@
+import { dateRange, queryError, } from "@wirecat/cli-base/query";
+const like = (value) => value
+    .toLowerCase()
+    .replace(/[\\%_]/gu, "\\$&")
+    .replaceAll("*", "%")
+    .replaceAll("?", "_");
+const leaf = (node, columns, options) => {
+    const column = columns[node.field];
+    if (!column)
+        throw new Error(`query filter: no column for "${node.field}"; validate the query first`);
+    if ("where" in column)
+        return column.where(node);
+    const { sql, type } = column;
+    if (node.operator === "wildcard" && node.value === "*")
+        return { sql: `${sql} IS NOT NULL AND ${sql} <> ''`, params: [] };
+    if (node.operator === "regex")
+        queryError("query.unsupported-operator", node.span, `${node.field} takes no regular expression`, options);
+    switch (type) {
+        case "num": {
+            if (node.operator !== "range")
+                return { sql: `${sql} = ?`, params: [Number(node.value)] };
+            const bounds = [];
+            if (node.value !== "*")
+                bounds.push({ sql: `${sql} ${node.lower_inclusive ? ">=" : ">"} ?`, params: [Number(node.value)] });
+            if (node.upper !== undefined && node.upper !== "*")
+                bounds.push({ sql: `${sql} ${node.upper_inclusive ? "<=" : "<"} ?`, params: [Number(node.upper)] });
+            return all([{ sql: `${sql} IS NOT NULL`, params: [] }, ...bounds]);
+        }
+        case "time": {
+            const range = node.operator === "range"
+                ? [node.value, node.upper ?? "*", node.lower_inclusive ?? true, node.upper_inclusive ?? true]
+                : [node.value, node.value, true, true];
+            const { lower, upper, lower_inclusive, upper_inclusive } = dateRange(range[0], range[1], range[2], range[3], options.zone ?? "UTC", node.span, options.now);
+            return all([
+                { sql: `${sql} IS NOT NULL`, params: [] },
+                ...(lower === undefined ? [] : [{ sql: `${sql} ${lower_inclusive ? ">=" : ">"} ?`, params: [lower] }]),
+                ...(upper === undefined ? [] : [{ sql: `${sql} ${upper_inclusive ? "<=" : "<"} ?`, params: [upper] }]),
+            ]);
+        }
+        case "bool":
+            return { sql: `${sql} = ?`, params: [node.value.toLowerCase() === "true" ? 1 : 0] };
+        default:
+            return node.operator === "wildcard"
+                ? { sql: `lower(${sql}) LIKE ? ESCAPE '\\'`, params: [like(node.value)] }
+                : { sql: `lower(${sql}) = ?`, params: [node.value.toLowerCase()] };
+    }
+};
+const all = (parts) => ({
+    sql: parts.map(({ sql }) => `(${sql})`).join(" AND "),
+    params: parts.flatMap(({ params }) => params),
+});
+// NULL is false here, as in cli-base's `evaluate`: without it, NOT over a missing value would drop the row.
+const known = ({ sql, params }) => ({ sql: `IFNULL((${sql}), 0)`, params });
+const compile = (node, columns, options) => {
+    if (node.kind === "predicate")
+        return known(leaf(node, columns, options));
+    const of = (occur) => node.clauses.filter((clause) => clause.occur === occur).map((clause) => compile(clause.node, columns, options));
+    const [must, should, mustNot] = [of("must"), of("should"), of("must_not")];
+    const parts = [
+        ...must,
+        ...(must.length === 0 && should.length > 0
+            ? [{ sql: should.map(({ sql }) => `(${sql})`).join(" OR "), params: should.flatMap(({ params }) => params) }]
+            : []),
+        ...mustNot.map(({ sql, params }) => ({ sql: `NOT (${sql})`, params })),
+    ];
+    return all(parts);
+};
+/**
+ * A validated list query as a `WHERE` condition with bound parameters, matching cli-base's `evaluate`: kw, enum
+ * and ref compare without case (SQLite's `lower()` folds ASCII only), a lone NOT means everything else, and a
+ * `should` clause counts only when nothing is required.
+ */
+export const queryFilter = (ast, columns, options = {}) => compile(ast.root, columns, options);
+//# sourceMappingURL=query-filter.js.map

package/dist/store/sqlite/query-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-filter.js","sourceRoot":"","sources":["../../../src/store/sqlite/query-filter.ts"],"names":[],"mappings":"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"}

package/dist/store/sqlite/ranges.d.ts

@@ -0,0 +1,6 @@
+import type { Range } from "../store.js";
+import type { StoreContext } from "./open.js";
+/** Merges `from`–`to` with every stretch it overlaps or touches, and answers the merged stretch. */
+export declare const markRange: ({ orm, now }: StoreContext, chatKey: number, from: number, to: number) => Range;
+export declare const ranges: ({ orm }: StoreContext, chatKey: number) => Range[];
+//# sourceMappingURL=ranges.d.ts.map

package/dist/store/sqlite/ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranges.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/ranges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG7C,oGAAoG;AACpG,eAAO,MAAM,SAAS,iBAAkB,YAAY,WAAW,MAAM,QAAQ,MAAM,MAAM,MAAM,KAAG,KAYjG,CAAA;AAED,eAAO,MAAM,MAAM,YAAa,YAAY,WAAW,MAAM,KAAG,KAAK,EAM3D,CAAA"}

package/dist/store/sqlite/ranges.js

@@ -0,0 +1,23 @@
+import { and, eq, gte, lte } from "./drizzle/core.js";
+import { syncRanges } from "./schema.js";
+/** Merges `from`–`to` with every stretch it overlaps or touches, and answers the merged stretch. */
+export const markRange = ({ orm, now }, chatKey, from, to) => {
+    const touching = and(eq(syncRanges.chatId, chatKey), lte(syncRanges.fromKey, to + 1), gte(syncRanges.toKey, from - 1));
+    let merged = { from, to };
+    for (const row of orm.select().from(syncRanges).where(touching).all()) {
+        merged = { from: Math.min(merged.from, row.fromKey), to: Math.max(merged.to, row.toKey) };
+    }
+    orm.delete(syncRanges).where(touching).run();
+    orm
+        .insert(syncRanges)
+        .values({ chatId: chatKey, fromKey: merged.from, toKey: merged.to, createdAt: now(), updatedAt: now() })
+        .run();
+    return merged;
+};
+export const ranges = ({ orm }, chatKey) => orm
+    .select({ from: syncRanges.fromKey, to: syncRanges.toKey })
+    .from(syncRanges)
+    .where(eq(syncRanges.chatId, chatKey))
+    .orderBy(syncRanges.fromKey)
+    .all();
+//# sourceMappingURL=ranges.js.map

package/dist/store/sqlite/ranges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranges.js","sourceRoot":"","sources":["../../../src/store/sqlite/ranges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAgB,EAAE,OAAe,EAAE,IAAY,EAAE,EAAU,EAAS,EAAE;IACxG,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA;IACtH,IAAI,MAAM,GAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;IAChC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QACtE,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAA;IAC3F,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAA;IAC5C,GAAG;SACA,MAAM,CAAC,UAAU,CAAC;SAClB,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;SACvG,GAAG,EAAE,CAAA;IACR,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAgB,EAAE,OAAe,EAAW,EAAE,CACxE,GAAG;KACA,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;KAC1D,IAAI,CAAC,UAAU,CAAC;KAChB,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;KAC3B,GAAG,EAAE,CAAA"}

package/dist/store/sqlite/ranking-evidence.d.ts

@@ -0,0 +1,35 @@
+import type { CounterState } from "../../domain/counters.js";
+import type { QueryExecution } from "../../search/lucene/resolved.js";
+import type { AccountKey, StoredHit } from "../store.js";
+import type { StoreContext } from "./open.js";
+import { type RankingRequest } from "./rankings.js";
+export interface EvidenceTarget {
+    account: AccountKey;
+    id: string;
+    chatId?: string;
+}
+export interface RankingEvidenceRequest extends RankingRequest {
+    target: EvidenceTarget;
+    component: string;
+    limit: number;
+    cursor?: string;
+}
+export interface RankingEvidenceItem {
+    message: StoredHit;
+    related?: StoredHit;
+    contribution: number | null;
+    counters?: CounterState[];
+}
+export interface RankedEvidence {
+    items: RankingEvidenceItem[];
+    total: number;
+    included: number;
+    hasMore: boolean;
+    nextCursor: string | null;
+    fingerprint: string;
+    component: string;
+    componentValue: number | null;
+    byteLimit: number;
+}
+export declare const rankingEvidence: (context: StoreContext, execution: QueryExecution, request: RankingEvidenceRequest) => RankedEvidence;
+//# sourceMappingURL=ranking-evidence.d.ts.map

package/dist/store/sqlite/ranking-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-evidence.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/ranking-evidence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,KAAK,cAAc,EAA6B,MAAM,eAAe,CAAA;AAG9E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,UAAU,CAAA;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AACD,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AACD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AACD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,mBAAmB,EAAE,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAOD,eAAO,MAAM,eAAe,YACjB,YAAY,aACV,cAAc,WAChB,sBAAsB,KAC9B,cAuKF,CAAA"}

package/dist/store/sqlite/ranking-evidence.js

@@ -0,0 +1,177 @@
+import { createHash } from "node:crypto";
+import { CliError } from "@wirecat/cli-base";
+import { formatLocator } from "../../domain/locator.js";
+import { counterStates } from "./counters.js";
+import { rankingCounter, rankQuery } from "./rankings.js";
+import { hitsByPk } from "./search.js";
+const EVIDENCE_BYTES = 64 * 1024;
+const FINGERPRINT_BYTES = 8 * 1024 * 1024;
+function fail(message, reason) {
+    throw new CliError("validation_error", message, { reason, complete: false });
+}
+export const rankingEvidence = (context, execution, request) => {
+    if (!Number.isSafeInteger(request.limit) || request.limit < 1 || request.limit > 100)
+        fail("evidence limit must be 1–100", "query.invalid-limit");
+    if (!request.options.components.includes(request.component) &&
+        !(request.options.target === "contacts" && request.component === "messages"))
+        fail("component is not exposed by this ranking selection", "invalid_component");
+    let result;
+    rankQuery(context, execution, request, ({ prefix, params, filtered, check }) => {
+        const { database } = context;
+        const { target, component } = request;
+        const identity = request.options.target === "messages"
+            ? "provider=? AND account=? AND chat=? AND id=?"
+            : "provider=? AND account=? AND id=?";
+        const identityParams = [
+            target.account.provider,
+            target.account.account,
+            ...(request.options.target === "messages" ? [target.chatId ?? ""] : []),
+            target.id,
+        ];
+        const ranked = database
+            .prepare(`${prefix}SELECT * FROM eligible WHERE ${identity}`)
+            .get(...params, ...identityParams);
+        if (!ranked)
+            throw new CliError("not_found", "ranking row is no longer eligible in this selection — run stats top again", {
+                reason: "selection.changed",
+            });
+        const targetSql = `${filtered} AND ac.provider=? AND ac.external_id=? AND ${request.options.target === "messages" ? "c.external_id=? AND m.external_id=?" : "i.external_id=?"}`;
+        const targetParams = [...params, ...identityParams];
+        const roots = `target_messages AS (SELECT m.id ${targetSql})`;
+        let source = "SELECT id AS id,NULL AS related,NULL AS contribution FROM target_messages";
+        if (["replies", "replies-from-others", "replies-from-others-per-message"].includes(component)) {
+            source = `SELECT g.id AS id,g.parent AS related,1 AS contribution FROM ranking_graph g JOIN ranking_graph parent ON parent.id=g.parent WHERE g.event=1 AND g.id<>g.parent AND g.parent IN (SELECT id FROM target_messages)${component === "replies" ? "" : " AND g.sender IS NOT NULL AND g.sender_chat=0 AND parent.sender IS NOT NULL AND (parent.sender<>g.sender OR parent.sender_chat<>g.sender_chat)"}`;
+        }
+        else if (["answers", "answer-time"].includes(component)) {
+            source = `SELECT d.id AS id,d.answer_for AS related,${component === "answers" ? "1" : "d.delay"} AS contribution FROM ranking_derived d WHERE d.id IN (SELECT id FROM target_messages) AND d.answer_for IS NOT NULL`;
+        }
+        else if (component === "threads") {
+            source =
+                "SELECT d.id AS id,NULL AS related,1 AS contribution FROM ranking_derived d WHERE d.id IN (SELECT id FROM target_messages) AND d.thread=1";
+        }
+        else if (component === "thread-size") {
+            source = `WITH RECURSIVE descendants(root,id,path) AS (
+        SELECT g.parent,g.id,'/'||g.parent||'/'||g.id||'/' FROM ranking_graph g WHERE g.parent IN (SELECT id FROM target_messages) AND g.id<>g.parent
+        UNION ALL SELECT d.root,g.id,d.path||g.id||'/' FROM descendants d JOIN ranking_graph g ON g.parent=d.id WHERE instr(d.path,'/'||g.id||'/')=0 LIMIT 50001)
+        SELECT DISTINCT d.id,d.root AS related,1 AS contribution FROM descendants d JOIN ranking_graph g ON g.id=d.id WHERE g.event=1 AND coalesce(g.kind,'')<>'bridge'`;
+        }
+        else if (component === "words")
+            source =
+                "SELECT d.id AS id,NULL AS related,d.words AS contribution FROM ranking_derived d WHERE d.id IN (SELECT id FROM target_messages)";
+        else if (component === "active-days" || component === "messages")
+            source = "SELECT id AS id,NULL AS related,1 AS contribution FROM target_messages";
+        else if (["reactions", "reactions-per-message"].includes(component))
+            source = `SELECT m.id AS id,NULL AS related,${rankingCounter("m", "reactions", true)} AS contribution FROM messages m WHERE m.id IN (SELECT id FROM target_messages)`;
+        else
+            source = `SELECT m.id AS id,NULL AS related,${rankingCounter("m", component)} AS contribution FROM messages m WHERE m.id IN (SELECT id FROM target_messages)`;
+        const rows = `WITH ${roots},evidence AS (${source}) SELECT e.id AS pk,e.related,e.contribution,m.text,m.reactions,m.metadata,m.edited_at,m.sent_at,ac.provider,ac.external_id AS account,c.external_id AS chat,m.external_id AS id,(SELECT json_group_array(json_object('counter',counter,'value',value,'at',created_at,'source',source)) FROM message_counter_observations WHERE message_id=m.id) AS counter_observations,(SELECT json_group_array(json_object('counter',counter,'value',value,'at',created_at,'source',source)) FROM message_counter_observations WHERE message_id=q.id) AS related_counter_observations,q.text AS related_text,q.reactions AS related_reactions,q.metadata AS related_metadata,q.edited_at AS related_edited_at,
+      (SELECT json_group_array(json_object('kind',att.kind,'name',att.name,'mime',att.mime,'size',att.size,'url',att.url,'ref',att.provider_ref,'local',att.local_path)) FROM attachments att WHERE att.attachable_type='message' AND att.attachable_id=m.id) AS files,
+      (SELECT json_group_array(json_object('kind',att.kind,'name',att.name,'mime',att.mime,'size',att.size,'url',att.url,'ref',att.provider_ref,'local',att.local_path)) FROM attachments att WHERE att.attachable_type='message' AND att.attachable_id=q.id) AS related_files
+      FROM evidence e JOIN messages m ON m.id=e.id JOIN chats c ON c.id=m.chat_id JOIN accounts ac ON ac.id=m.account_id LEFT JOIN messages q ON q.id=e.related`;
+        const size = database
+            .prepare(`SELECT count(*) AS n,sum(coalesce(length(cast(text AS BLOB)),0)+coalesce(length(cast(reactions AS BLOB)),0)+coalesce(length(cast(metadata AS BLOB)),0)+coalesce(length(cast(edited_at AS BLOB)),0)+coalesce(length(cast(related_text AS BLOB)),0)+coalesce(length(cast(related_reactions AS BLOB)),0)+coalesce(length(cast(related_metadata AS BLOB)),0)+coalesce(length(cast(related_edited_at AS BLOB)),0)+coalesce(length(cast(files AS BLOB)),0)+coalesce(length(cast(related_files AS BLOB)),0)) AS bytes FROM (${rows})`)
+            .get(...targetParams);
+        const total = Number(size?.n ?? 0);
+        if (total > 50_000 || Number(size?.bytes ?? 0) > FINGERPRINT_BYTES)
+            fail("evidence exceeds its fingerprint budget — narrow chat/date scope", "query.too-large");
+        const ordered = `${rows} ORDER BY m.sent_at,ac.provider,ac.external_id,c.external_id,m.external_id`;
+        const seed = JSON.stringify([
+            execution.root,
+            execution.accounts,
+            request.options,
+            target,
+            component,
+            request.timezone,
+        ]);
+        let fingerprintBytes = Buffer.byteLength(seed);
+        const hash = createHash("sha256").update(seed);
+        const page = database.prepare(`${ordered} LIMIT 500 OFFSET ?`);
+        for (let offset = 0; offset < total; offset += 500) {
+            check();
+            for (const row of page.all(...targetParams, offset)) {
+                const serialized = JSON.stringify(row);
+                fingerprintBytes += Buffer.byteLength(serialized) + 1;
+                if (fingerprintBytes > FINGERPRINT_BYTES)
+                    fail("evidence exceeds its fingerprint budget — narrow chat/date scope", "query.too-large");
+                hash.update(serialized).update("\n");
+            }
+        }
+        const fingerprint = hash.digest("hex");
+        let offset = 0;
+        if (request.cursor !== undefined) {
+            if (request.cursor.length > 4096)
+                fail("evidence cursor is invalid", "invalid_cursor");
+            let cursor;
+            try {
+                cursor = JSON.parse(Buffer.from(request.cursor, "base64url").toString("utf8"));
+            }
+            catch {
+                fail("evidence cursor is invalid", "invalid_cursor");
+            }
+            if (!cursor ||
+                typeof cursor !== "object" ||
+                !("version" in cursor) ||
+                cursor.version !== 1 ||
+                !("offset" in cursor) ||
+                typeof cursor.offset !== "number" ||
+                !Number.isSafeInteger(cursor.offset) ||
+                cursor.offset < 0 ||
+                !("fingerprint" in cursor))
+                fail("evidence cursor is invalid", "invalid_cursor");
+            if (cursor.fingerprint !== fingerprint)
+                fail("stored evidence changed — restart without --cursor", "evidence_changed");
+            offset = cursor.offset;
+            if (offset > total)
+                fail("evidence cursor is beyond this selection", "invalid_cursor");
+        }
+        const selected = database.prepare(`${ordered} LIMIT ? OFFSET ?`).all(...targetParams, request.limit, offset);
+        const messages = hitsByPk(context, selected.flatMap((row) => [Number(row.pk), ...(row.related == null ? [] : [Number(row.related)])]));
+        const byLocator = new Map(messages.map((message) => [message.locator, message]));
+        const items = [];
+        let bytes = 2;
+        for (const row of selected) {
+            check();
+            const message = byLocator.get(formatLocator({
+                provider: String(row.provider),
+                account: String(row.account),
+                chat: String(row.chat),
+                message: String(row.id),
+            }));
+            if (!message)
+                throw new Error("evidence message disappeared inside its read snapshot");
+            const related = row.related == null ? undefined : hitsByPk(context, [Number(row.related)])[0];
+            const value = typeof row.contribution === "number" && Number.isFinite(row.contribution) ? row.contribution : null;
+            const item = {
+                message,
+                ...(related ? { related } : {}),
+                contribution: value,
+                counters: counterStates(context, Number(row.pk), context.now(), 86_400_000),
+            };
+            const added = Buffer.byteLength(JSON.stringify(item)) + (items.length ? 1 : 0);
+            if (bytes + added > EVIDENCE_BYTES)
+                break;
+            bytes += added;
+            items.push(item);
+        }
+        if (selected.length > 0 && items.length === 0)
+            fail("one evidence row exceeds 64 KiB — use messages show for that locator", "evidence.row-too-large");
+        const next = offset + items.length;
+        result = {
+            items,
+            total,
+            included: items.length,
+            hasMore: next < total,
+            nextCursor: next < total
+                ? Buffer.from(JSON.stringify({ version: 1, offset: next, fingerprint })).toString("base64url")
+                : null,
+            fingerprint,
+            component,
+            componentValue: typeof ranked[component] === "number" ? Number(ranked[component]) : null,
+            byteLimit: EVIDENCE_BYTES,
+        };
+    });
+    if (!result)
+        throw new CliError("not_found", "ranking selection has no matching row");
+    return result;
+};
+//# sourceMappingURL=ranking-evidence.js.map

package/dist/store/sqlite/ranking-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking-evidence.js","sourceRoot":"","sources":["../../../src/store/sqlite/ranking-evidence.ts"],"names":[],"mappings":"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"}

package/dist/store/sqlite/rankings.d.ts

@@ -0,0 +1,53 @@
+import type { CounterState } from "../../domain/counters.js";
+import { rankReplyGraph } from "../../domain/rankings-graph.js";
+import { type RankingComponent, type RankingOptions, type ScoreComponents } from "../../domain/rankings-options.js";
+import type { QueryExecution } from "../../search/lucene/resolved.js";
+import type { SqlValue } from "../driver.js";
+import type { StoreContext } from "./open.js";
+export interface RankingRequest {
+    options: RankingOptions;
+    timezone: string;
+    contextChat?: QueryExecution["chat"];
+}
+export interface RankedStoreRow {
+    provider: string;
+    account: string;
+    id: string;
+    chatId: string | null;
+    name: string | null;
+    pk: number | null;
+    kind: string | null;
+    rank: number;
+    value: number;
+    components: Record<string, number | null>;
+    messages: number;
+    knownReactions: number;
+    unknownReactions: number;
+    score: ScoreComponents | null;
+    counterObservations?: CounterState[];
+    graphComplete?: boolean;
+}
+export interface RankedStoreFound {
+    total: number;
+    population: number;
+    eligible: number;
+    excludedMinimum: number;
+    excludedMissing: number;
+    excludedUnknownSender: number;
+    excludedUnknownKind: number;
+    items: RankedStoreRow[];
+    maxima: Partial<Record<RankingComponent, number>>;
+    hasMore: boolean;
+    graphQuality?: ReturnType<typeof rankReplyGraph>["quality"];
+}
+export declare const rankingCounter: (alias: string, field: string, reactions?: boolean) => string;
+/** Aggregate and normalize the whole population, returning only a bounded page. */
+export interface RankingSnapshot {
+    prefix: string;
+    params: SqlValue[];
+    filtered: string;
+    found: RankedStoreFound;
+    check: () => void;
+}
+export declare const rankQuery: (context: StoreContext, execution: QueryExecution, request: RankingRequest, inspect?: (snapshot: RankingSnapshot) => void) => RankedStoreFound;
+//# sourceMappingURL=rankings.d.ts.map

package/dist/store/sqlite/rankings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankings.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/rankings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAIL,cAAc,EACf,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAGnB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CACrC;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IAC7B,mBAAmB,CAAC,EAAE,YAAY,EAAE,CAAA;IACpC,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AACD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,SAAS,CAAC,CAAA;CAC5D;AAKD,eAAO,MAAM,cAAc,UAAW,MAAM,SAAS,MAAM,gCAO1D,CAAA;AAmJD,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,gBAAgB,CAAA;IACvB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AACD,eAAO,MAAM,SAAS,YACX,YAAY,aACV,cAAc,WAChB,cAAc,YACb,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,KAC5C,gBA0OF,CAAA"}