@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/domain/rankings-options.js

@@ -0,0 +1,157 @@
+import { CliError } from "@wirecat/cli-base";
+export const MESSAGE_MEASURES = ["views", "reactions", "forwards", "comments", "replies", "thread-size"];
+export const AUTHOR_MEASURES = [
+    "messages",
+    "words",
+    "reactions",
+    "replies",
+    "answers",
+    "answer-time",
+    "threads",
+    "active-days",
+];
+const CONTEXT = new Set([
+    "replies",
+    "replies-from-others",
+    "replies-from-others-per-message",
+    "thread-size",
+    "threads",
+    "answers",
+    "answer-time",
+]);
+export const needsRankingContext = (options) => options.components.some((name) => CONTEXT.has(name));
+const presets = {
+    helpful: { answers: 0.5, "replies-from-others": 0.25, reactions: 0.25 },
+    active: { "active-days": 0.6, messages: 0.4 },
+    engaging: { "reactions-per-message": 0.5, "replies-from-others-per-message": 0.5 },
+};
+function invalid(message) {
+    throw new CliError("validation_error", message, { reason: "ranking.invalid" });
+}
+export const rankingOptions = (target, input) => {
+    const measures = target === "messages" ? MESSAGE_MEASURES : AUTHOR_MEASURES;
+    const { measure, score, weights: given, minMessages } = input;
+    const messageKind = input.messageKind ?? "all";
+    if (!["all", "posts", "comments"].includes(messageKind))
+        invalid("--message-kind takes all, posts or comments");
+    if (target === "messages" && minMessages !== undefined)
+        invalid("--min-messages applies to stats contacts top");
+    if (minMessages !== undefined && (!Number.isSafeInteger(minMessages) || minMessages < 1))
+        invalid("--min-messages takes a positive integer");
+    if (measure !== undefined && !measures.includes(measure))
+        invalid(`--measure takes ${measures.join(", ")}`);
+    if (measure !== undefined && (score !== undefined || given !== undefined))
+        invalid("--measure cannot be combined with --score or --weights");
+    if (score !== undefined && !["helpful", "active", "engaging"].includes(score))
+        invalid("--score takes helpful, active or engaging");
+    if (target === "messages" && score !== undefined && score !== "engaging")
+        invalid("helpful and active scores apply to authors only");
+    const scoring = score !== undefined || given !== undefined;
+    const preset = score;
+    let weights = null;
+    if (scoring) {
+        let raw = given !== undefined
+            ? given
+            : target === "messages"
+                ? { reactions: 0.5, "replies-from-others": 0.5 }
+                : presets[preset];
+        if (typeof raw === "string") {
+            try {
+                raw = JSON.parse(raw);
+            }
+            catch {
+                invalid("--weights takes a JSON object of component weights");
+            }
+        }
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            invalid("--weights takes a JSON object of component weights");
+        const allowed = target === "messages"
+            ? [...MESSAGE_MEASURES, "replies-from-others"]
+            : [
+                ...AUTHOR_MEASURES.filter((name) => name !== "answer-time"),
+                "replies-from-others",
+                "reactions-per-message",
+                "replies-from-others-per-message",
+            ];
+        const entries = Object.entries(raw);
+        for (const [name, weight] of entries) {
+            if (!allowed.includes(name))
+                invalid(`unknown ${target} score component: ${name}`);
+            if (typeof weight !== "number" || !Number.isFinite(weight) || weight < 0)
+                invalid(`weight for ${name} must be a finite nonnegative number`);
+        }
+        if (!entries.some(([, weight]) => weight > 0))
+            invalid("--weights needs at least one positive weight");
+        weights = Object.fromEntries(entries);
+    }
+    const selected = (measure ?? (target === "messages" ? "reactions" : "messages"));
+    return {
+        target,
+        messageKind: messageKind,
+        minMessages: minMessages ?? (target === "contacts" && score === "engaging" ? 5 : 1),
+        measure: scoring ? "score" : selected,
+        order: !scoring && selected === "answer-time" ? "ascending" : "descending",
+        weights,
+        preset: scoring ? (preset ?? "custom") : null,
+        components: weights === null
+            ? [selected]
+            : Object.entries(weights)
+                .filter(([, weight]) => weight > 0)
+                .map(([name]) => name),
+    };
+};
+/** Scale weights first so valid finite weights cannot overflow their sum. */
+export const rankingScore = (raw, maxima, weights) => {
+    const entries = Object.entries(weights).filter(([, weight]) => weight > 0);
+    const scale = Math.max(...entries.map(([, weight]) => weight));
+    const denominator = entries.reduce((sum, [, weight]) => sum + weight / scale, 0);
+    if (!Number.isFinite(scale) || scale <= 0 || !Number.isFinite(denominator) || denominator <= 0)
+        return null;
+    const normalized = {};
+    const contributions = {};
+    let sum = 0;
+    for (const [name, weight] of entries) {
+        const value = raw[name];
+        const maximum = maxima[name];
+        if (value == null ||
+            !Number.isFinite(value) ||
+            value < 0 ||
+            maximum === undefined ||
+            !Number.isFinite(maximum) ||
+            maximum < value)
+            return null;
+        const part = maximum === 0 ? 0 : value / maximum;
+        normalized[name] = part;
+        contributions[name] = (100 * part * (weight / scale)) / denominator;
+        sum += contributions[name];
+    }
+    return { score: Math.min(100, sum), normalized, contributions };
+};
+export const RANKING_TOKENIZER_VERSION = 1;
+const withoutUrls = (text) => text.replace(/\S+/gu, (token) => {
+    for (let offset = 0;;) {
+        const marker = token.indexOf("://", offset);
+        if (marker < 0)
+            break;
+        let start = marker;
+        while (start > 0 && /[a-z0-9+.-]/iu.test(token[start - 1]))
+            start--;
+        if (/^[a-z][a-z0-9+.-]*$/iu.test(token.slice(start, marker)) &&
+            (start === 0 || !/\w/u.test(token[start - 1])))
+            return token.slice(0, start);
+        offset = marker + 3;
+    }
+    const folded = token.toLowerCase();
+    for (let offset = 0;;) {
+        const start = folded.indexOf("www.", offset);
+        if (start < 0)
+            break;
+        if (start === 0 || !/\w/u.test(token[start - 1]))
+            return token.slice(0, start);
+        offset = start + 4;
+    }
+    return token;
+});
+export const rankingWords = (text) => withoutUrls(text).match(/[\p{L}\p{N}]+/gu)?.length ?? 0;
+export const rankingQuestion = (text) => withoutUrls(text).includes("?");
+//# sourceMappingURL=rankings-options.js.map

package/dist/domain/rankings-options.js.map

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

package/dist/domain/rankings-range.d.ts

@@ -0,0 +1,5 @@
+import type { DateRange } from "@wirecat/cli-base/query";
+import type { ResolvedNode } from "../search/lucene/resolved.js";
+/** A common positive date range bounds reply events independently of author/body filters. */
+export declare const rankingContextRange: (root: ResolvedNode) => DateRange | undefined;
+//# sourceMappingURL=rankings-range.d.ts.map

package/dist/domain/rankings-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankings-range.d.ts","sourceRoot":"","sources":["../../src/domain/rankings-range.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,8BAA8B,CAAA;AAEnF,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,SAAU,YAAY,KAAG,SAAS,GAAG,SAwBpE,CAAA"}

package/dist/domain/rankings-range.js

@@ -0,0 +1,23 @@
+import { CliError } from "@wirecat/cli-base";
+/** A common positive date range bounds reply events independently of author/body filters. */
+export const rankingContextRange = (root) => {
+    const dates = [];
+    const visit = (node, required) => {
+        if (node.kind === "predicate") {
+            if (node.field === "date")
+                dates.push({ node, required });
+            return;
+        }
+        const must = node.clauses.some(({ occur }) => occur === "must");
+        const positive = node.clauses.filter(({ occur }) => occur === "should");
+        for (const clause of node.clauses)
+            visit(clause.node, required && (clause.occur === "must" || (!must && positive.length === 1 && clause.occur === "should")));
+    };
+    visit(root, true);
+    if (dates.length === 0)
+        return undefined;
+    if (dates.length !== 1 || !dates[0]?.required || !dates[0].node.resolution?.date)
+        throw new CliError("validation_error", "reply rankings need one common positive date range; move date: outside Boolean alternatives", { reason: "period.ambiguous" });
+    return dates[0].node.resolution.date;
+};
+//# sourceMappingURL=rankings-range.js.map

package/dist/domain/rankings-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankings-range.js","sourceRoot":"","sources":["../../src/domain/rankings-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAI5C,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAkB,EAAyB,EAAE;IAC/E,MAAM,KAAK,GAAqD,EAAE,CAAA;IAClE,MAAM,KAAK,GAAG,CAAC,IAAkB,EAAE,QAAiB,EAAE,EAAE;QACtD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;YACzD,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAA;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAA;QACvE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAC/B,KAAK,CACH,MAAM,CAAC,IAAI,EACX,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CACvG,CAAA;IACL,CAAC,CAAA;IACD,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI;QAC9E,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,6FAA6F,EAC7F,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAC/B,CAAA;IACH,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAA;AACtC,CAAC,CAAA"}

package/dist/domain/recovery.d.ts

@@ -0,0 +1,15 @@
+export interface RecoveryAction {
+    type: "wait" | "retry" | "configure" | "skip" | "check";
+    message: string;
+    afterMs?: number;
+    setting?: string;
+}
+export interface ActionableError {
+    code: string;
+    message: string;
+    retryable: boolean;
+    actions: RecoveryAction[];
+    retry_after_ms?: number;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=recovery.d.ts.map

package/dist/domain/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/domain/recovery.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB"}

package/dist/domain/recovery.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recovery.js.map

package/dist/domain/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/domain/recovery.ts"],"names":[],"mappings":""}

package/dist/domain/references.d.ts

@@ -0,0 +1,42 @@
+/**
+ * One typed form for every kind of thing a link, a tag or an argument can name. The prefix makes a
+ * wrong kind fail loudly instead of matching another row. Parts that are ids of someone else's system
+ * are percent-encoded, as in a message locator, so no id can add a part.
+ */
+export type Reference = {
+    type: "message";
+    provider: string;
+    account: string;
+    chat: string;
+    message: string;
+} | {
+    type: "chat";
+    provider: string;
+    account: string;
+    chat: string;
+} | {
+    type: "contact";
+    provider: string;
+    id: string;
+} | {
+    type: SimpleReference;
+    id: string;
+}
+/** A notes folder, or one subfolder of it: `path` is inside the folder, `null` the folder itself. */
+ | {
+    type: "folder";
+    id: string;
+    path: string | null;
+};
+/**
+ * Things named by their store id (a task also by its key or the task package's id). `entity` is the name
+ * before organizations and projects: it still parses, so an old file's reference resolves as not found.
+ */
+export declare const SIMPLE_REFERENCES: readonly ["note", "document", "person", "organization", "project", "task", "memory", "fact", "bot", "entity"];
+export type SimpleReference = (typeof SIMPLE_REFERENCES)[number];
+export declare const formatReference: (reference: Reference) => string;
+export declare const parseReference: (text: string) => Reference;
+/** The stored spelling of a reference, so two spellings of one thing compare equal. */
+export declare const canonicalReference: (text: string) => string;
+export { canonicalMeetingReference, formatMeetingReference, type MeetingReference, parseMeetingReference, } from "./meeting-reference.js";
+//# sourceMappingURL=references.d.ts.map

package/dist/domain/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/domain/references.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AACvC,qGAAqG;GACnG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAC5B,MAAM,EACN,UAAU,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EACT,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EACL,QAAQ,CACA,CAAA;AACV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAShE,eAAO,MAAM,eAAe,cAAe,SAAS,KAAG,MAetD,CAAA;AAED,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,SAyC7C,CAAA;AAWD,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,MAA+C,CAAA;AAGjG,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,qBAAqB,GACtB,MAAM,wBAAwB,CAAA"}

package/dist/domain/references.js

@@ -0,0 +1,86 @@
+import { CliError, singleLine } from "@wirecat/cli-base";
+import { formatLocator, parseLocator } from "./locator.js";
+/**
+ * Things named by their store id (a task also by its key or the task package's id). `entity` is the name
+ * before organizations and projects: it still parses, so an old file's reference resolves as not found.
+ */
+export const SIMPLE_REFERENCES = [
+    "note",
+    "document",
+    "person",
+    "organization",
+    "project",
+    "task",
+    "memory",
+    "fact",
+    "bot",
+    "entity",
+];
+const parts = (rest, count, reference, shape) => {
+    const split = rest.split("/");
+    if (split.length !== count || split.some((part) => part === ""))
+        throw new CliError("validation_error", `"${singleLine(reference)}" is not a reference — expected ${shape}`);
+    return split.map(decodeURIComponent);
+};
+export const formatReference = (reference) => {
+    switch (reference.type) {
+        case "message":
+            return formatLocator(reference);
+        case "chat":
+            return `chat:${[reference.provider, reference.account, reference.chat].map(encodeURIComponent).join("/")}`;
+        case "contact":
+            return `contact:${[reference.provider, reference.id].map(encodeURIComponent).join("/")}`;
+        case "folder":
+            return reference.path === null
+                ? `folder:${encodeURIComponent(reference.id)}`
+                : `folder:${encodeURIComponent(reference.id)}/${encodeURIComponent(reference.path)}`;
+        default:
+            return `${reference.type}:${reference.id}`;
+    }
+};
+export const parseReference = (text) => {
+    const reference = text.trim();
+    const colon = reference.indexOf(":");
+    const prefix = colon < 0 ? "" : reference.slice(0, colon);
+    const rest = reference.slice(colon + 1);
+    switch (prefix) {
+        case "msg":
+            return { type: "message", ...parseLocator(reference) };
+        case "chat": {
+            const [provider, account, chat] = parts(rest, 3, reference, "chat:<provider>/<account>/<chat>");
+            return { type: "chat", provider, account, chat };
+        }
+        case "contact": {
+            const [provider, id] = parts(rest, 2, reference, "contact:<provider>/<id>");
+            return { type: "contact", provider, id };
+        }
+        case "folder": {
+            const slash = rest.indexOf("/");
+            const id = decodeURIComponent(slash < 0 ? rest : rest.slice(0, slash));
+            const path = slash < 0 ? null : folderPath(decodeURIComponent(rest.slice(slash + 1)));
+            if (!id.trim() || path === "")
+                throw new CliError("validation_error", `"${singleLine(reference)}" is not a reference — expected folder:<id>[/<path>]`);
+            return { type: "folder", id, path };
+        }
+        default:
+            if (SIMPLE_REFERENCES.includes(prefix)) {
+                if (!rest.trim())
+                    throw new CliError("validation_error", `"${singleLine(reference)}" names no ${prefix}`);
+                return { type: prefix, id: rest };
+            }
+            throw new CliError("validation_error", `"${singleLine(reference)}" is not a reference — expected msg:, chat:, contact:, folder:, ${SIMPLE_REFERENCES.filter((one) => one !== "entity").join(":, ")}:`);
+    }
+};
+/** A subfolder spelled one way: no leading, trailing or doubled slash, and `.` for the folder itself. */
+const folderPath = (path) => {
+    const clean = path
+        .split("/")
+        .filter((part) => part !== "" && part !== ".")
+        .join("/");
+    return clean === "" ? (path.trim() === "" ? "" : null) : clean;
+};
+/** The stored spelling of a reference, so two spellings of one thing compare equal. */
+export const canonicalReference = (text) => formatReference(parseReference(text));
+// Meeting evidence is intentionally separate until every polymorphic store target supports it.
+export { canonicalMeetingReference, formatMeetingReference, parseMeetingReference, } from "./meeting-reference.js";
+//# sourceMappingURL=references.js.map

package/dist/domain/references.js.map

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

package/dist/domain/retention.d.ts

@@ -0,0 +1,66 @@
+export declare const RETENTION_TOLERANCE = 86400000;
+export interface RetentionOptions {
+    since: number;
+    until: number;
+    cutoff: number;
+    checkpoints: number[];
+    within: number;
+    by: "day" | "week";
+    timezone: string;
+    limit: number;
+}
+export interface RetentionObservation {
+    checkpoint: number;
+    targetAt: string;
+    state: "present" | "absent" | "unknown" | "pending";
+    observedAt: string | null;
+    lagMilliseconds: number | null;
+    complete: boolean | null;
+}
+export interface RetentionStay {
+    stay: number;
+    person: string;
+    joinedAt: string;
+    cohort: string;
+    checkpoints: RetentionObservation[];
+    activity: {
+        state: "observed-message" | "no-observed-message" | "pending";
+        firstMessageAt: string | null;
+        windowEnd: string;
+        archiveCovered: boolean;
+    };
+    departure: {
+        after: string | null;
+        atOrBefore: string | null;
+        early: "observed" | "not-observed" | "unknown" | "pending";
+    };
+}
+export interface RetentionCohort {
+    cohort: string;
+    stays: number;
+    checkpoints: {
+        ageMilliseconds: number;
+        eligible: number;
+        observable: number;
+        present: number;
+        absent: number;
+        unknown: number;
+        pending: number;
+        rate: number | null;
+    }[];
+    activity: {
+        observed: number;
+        noObserved: number;
+        pending: number;
+        archiveCovered: number;
+    };
+    earlyDeparture: {
+        observed: number;
+        notObserved: number;
+        unknown: number;
+        pending: number;
+    };
+}
+export declare const validateRetentionOptions: (options: RetentionOptions) => void;
+export declare const retentionCohorts: (stays: RetentionStay[], options: RetentionOptions) => RetentionCohort[];
+//# sourceMappingURL=retention.d.ts.map

package/dist/domain/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/domain/retention.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,WAAa,CAAA;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,KAAK,GAAG,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AACD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;IACnD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;CACzB;AACD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,oBAAoB,EAAE,CAAA;IACnC,QAAQ,EAAE;QACR,KAAK,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,SAAS,CAAA;QAC7D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;QAC7B,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,OAAO,CAAA;KACxB,CAAA;IACD,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,CAAA;KAC3D,CAAA;CACF;AACD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE;QACX,eAAe,EAAE,MAAM,CAAA;QACvB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KACpB,EAAE,CAAA;IACH,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3F,cAAc,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5F;AACD,eAAO,MAAM,wBAAwB,YAAa,gBAAgB,KAAG,IAqCpE,CAAA;AACD,eAAO,MAAM,gBAAgB,UAAW,aAAa,EAAE,WAAW,gBAAgB,KAAG,eAAe,EAwCnG,CAAA"}

package/dist/domain/retention.js

@@ -0,0 +1,73 @@
+import { CliError } from "@wirecat/cli-base";
+export const RETENTION_TOLERANCE = 86_400_000;
+export const validateRetentionOptions = (options) => {
+    const { since, until, cutoff, checkpoints, within, limit, by } = options;
+    if (![since, until, cutoff].every((one) => Number.isSafeInteger(one) && one >= 0 && one <= 8.64e15) ||
+        since > until ||
+        until > cutoff ||
+        !Number.isSafeInteger(within) ||
+        within <= 0 ||
+        !Number.isSafeInteger(limit) ||
+        limit < 1 ||
+        limit > 100 ||
+        !["day", "week"].includes(by) ||
+        !Array.isArray(checkpoints) ||
+        !checkpoints.length ||
+        checkpoints.length > 10 ||
+        checkpoints.some((one, index) => !Number.isSafeInteger(one) || one <= 0 || (index > 0 && one <= (checkpoints[index - 1] ?? 0))))
+        throw new CliError("validation_error", "retention requires an ordered date window, up to 10 increasing positive checkpoints and a limit of 1–100");
+    try {
+        new Intl.DateTimeFormat("en", { timeZone: options.timezone }).format(cutoff);
+    }
+    catch {
+        throw new CliError("validation_error", "invalid retention timezone");
+    }
+    if (checkpoints.some((one) => !Number.isSafeInteger(cutoff + one + RETENTION_TOLERANCE) || cutoff + one + RETENTION_TOLERANCE > 8.64e15) ||
+        !Number.isSafeInteger(cutoff + within) ||
+        cutoff + within > 8.64e15)
+        throw new CliError("validation_error", "retention durations exceed the timestamp range");
+};
+export const retentionCohorts = (stays, options) => {
+    const groups = new Map();
+    for (const stay of stays) {
+        const group = groups.get(stay.cohort) ?? {
+            cohort: stay.cohort,
+            stays: 0,
+            checkpoints: options.checkpoints.map((ageMilliseconds) => ({
+                ageMilliseconds,
+                eligible: 0,
+                observable: 0,
+                present: 0,
+                absent: 0,
+                unknown: 0,
+                pending: 0,
+                rate: null,
+            })),
+            activity: { observed: 0, noObserved: 0, pending: 0, archiveCovered: 0 },
+            earlyDeparture: { observed: 0, notObserved: 0, unknown: 0, pending: 0 },
+        };
+        group.stays++;
+        for (const [index, observation] of stay.checkpoints.entries()) {
+            const point = group.checkpoints[index];
+            if (!point)
+                continue;
+            point[observation.state]++;
+            if (observation.state !== "pending")
+                point.eligible++;
+            if (observation.state === "present" || observation.state === "absent")
+                point.observable++;
+            point.rate = point.observable ? point.present / point.observable : null;
+        }
+        group.activity[stay.activity.state === "observed-message"
+            ? "observed"
+            : stay.activity.state === "pending"
+                ? "pending"
+                : "noObserved"]++;
+        if (stay.activity.archiveCovered)
+            group.activity.archiveCovered++;
+        group.earlyDeparture[stay.departure.early === "not-observed" ? "notObserved" : stay.departure.early]++;
+        groups.set(stay.cohort, group);
+    }
+    return [...groups.values()].sort((a, b) => a.cohort.localeCompare(b.cohort));
+};
+//# sourceMappingURL=retention.js.map

package/dist/domain/retention.js.map

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

package/dist/domain/send-time.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `--at-time`: a time like `2026-09-25T09:00`, or a delay like `30m`, `2h`, `1d`, as an ISO time — the
+ * same words max-cli takes. Rounded down to the minute, because messengers send at the start of it
+ * (MAX measured, max-cli `FIND-141`), so the time printed is the time it goes. A time without an
+ * offset is local, which is how `Date.parse` reads one with a clock and no zone.
+ */
+export declare const sendTime: (value: string, now?: number, flag?: string) => string;
+//# sourceMappingURL=send-time.d.ts.map

package/dist/domain/send-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-time.d.ts","sourceRoot":"","sources":["../../src/domain/send-time.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,UAAW,MAAM,kCAAyC,MAiB9E,CAAA"}

package/dist/domain/send-time.js

@@ -0,0 +1,29 @@
+import { CliError } from "@wirecat/cli-base";
+const MINUTE = 60_000;
+const YEAR = 365 * 24 * 60 * MINUTE;
+const DELAY = /^(\d+)(m|h|d)$/;
+const UNIT_MS = { m: MINUTE, h: 60 * MINUTE, d: 24 * 60 * MINUTE };
+/**
+ * `--at-time`: a time like `2026-09-25T09:00`, or a delay like `30m`, `2h`, `1d`, as an ISO time — the
+ * same words max-cli takes. Rounded down to the minute, because messengers send at the start of it
+ * (MAX measured, max-cli `FIND-141`), so the time printed is the time it goes. A time without an
+ * offset is local, which is how `Date.parse` reads one with a clock and no zone.
+ */
+export const sendTime = (value, now = Date.now(), flag = "--at-time") => {
+    const trimmed = value.trim();
+    const [, amount, unit] = DELAY.exec(trimmed) ?? [];
+    const at = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}/.test(trimmed)
+        ? Date.parse(trimmed.replace(" ", "T"))
+        : amount && unit
+            ? now + Number(amount) * (UNIT_MS[unit] ?? 0)
+            : Number.NaN;
+    if (Number.isNaN(at)) {
+        throw new CliError("validation_error", `${flag} takes a time like 2026-09-25T09:00 or a delay like 30m, 2h, 1d — not "${value}"`);
+    }
+    if (at < now + MINUTE)
+        throw new CliError("validation_error", `${flag} has to be at least a minute from now`);
+    if (at > now + YEAR)
+        throw new CliError("validation_error", `${flag} can be at most a year from now`);
+    return new Date(at - (at % MINUTE)).toISOString();
+};
+//# sourceMappingURL=send-time.js.map

package/dist/domain/send-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-time.js","sourceRoot":"","sources":["../../src/domain/send-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,MAAM,MAAM,GAAG,MAAM,CAAA;AACrB,MAAM,IAAI,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;AACnC,MAAM,KAAK,GAAG,gBAAgB,CAAA;AAC9B,MAAM,OAAO,GAA2B,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;AAE1F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,GAAG,WAAW,EAAU,EAAE;IACtF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;IAClD,MAAM,EAAE,GAAG,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC;QAC1D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,CAAC,CAAC,MAAM,IAAI,IAAI;YACd,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;IAChB,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,IAAI,0EAA0E,KAAK,GAAG,CAC1F,CAAA;IACH,CAAC;IACD,IAAI,EAAE,GAAG,GAAG,GAAG,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,uCAAuC,CAAC,CAAA;IAC7G,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,iCAAiC,CAAC,CAAA;IACrG,OAAO,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;AACnD,CAAC,CAAA"}

package/dist/domain/tags.d.ts

@@ -0,0 +1,6 @@
+export declare const TAG_TYPES: readonly ["chat", "contact", "message"];
+export type TagType = (typeof TAG_TYPES)[number];
+/** Lowercase, so `Work` and `work` are one tag; otherwise refused rather than rewritten into another word. */
+export declare const tagOf: (value: string) => string | undefined;
+export declare const normalizeTag: (value: string) => string;
+//# sourceMappingURL=tags.d.ts.map

package/dist/domain/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/domain/tags.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,YAAI,MAAM,EAAE,SAAS,EAAE,SAAS,CAAU,CAAA;AAChE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;AAIhD,8GAA8G;AAC9G,eAAO,MAAM,KAAK,UAAW,MAAM,KAAG,MAAM,GAAG,SAG9C,CAAA;AAED,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,MAS5C,CAAA"}

package/dist/domain/tags.js

@@ -0,0 +1,15 @@
+import { CliError, singleLine } from "@wirecat/cli-base";
+export const TAG_TYPES = ["chat", "contact", "message"];
+const TAG = /^[a-z0-9-]{1,32}$/;
+/** Lowercase, so `Work` and `work` are one tag; otherwise refused rather than rewritten into another word. */
+export const tagOf = (value) => {
+    const tag = value.trim().toLowerCase();
+    return TAG.test(tag) ? tag : undefined;
+};
+export const normalizeTag = (value) => {
+    const tag = tagOf(value);
+    if (tag === undefined)
+        throw new CliError("validation_error", `"${singleLine(value)}" is not a tag — use 1–32 letters a–z, digits and hyphens`, { reason: "tag.invalid" });
+    return tag;
+};
+//# sourceMappingURL=tags.js.map

package/dist/domain/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/domain/tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAU,CAAA;AAGhE,MAAM,GAAG,GAAG,mBAAmB,CAAA;AAE/B,8GAA8G;AAC9G,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAsB,EAAE;IACzD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACtC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AACxC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;IACxB,IAAI,GAAG,KAAK,SAAS;QACnB,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,IAAI,UAAU,CAAC,KAAK,CAAC,2DAA2D,EAChF,EAAE,MAAM,EAAE,aAAa,EAAE,CAC1B,CAAA;IACH,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/dist/domain/vocabulary.d.ts

@@ -0,0 +1,5 @@
+/** Search accent folding would make distinct names equal; canonical aliases retain their letters. */
+export declare const normalizeVocabularyName: (input: string) => string;
+/** Similarity is a review hint; only exact normalized names resolve canonical records. */
+export declare const vocabularySimilarity: (left: string, right: string) => number;
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/domain/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/domain/vocabulary.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,eAAO,MAAM,uBAAuB,UAAW,MAAM,KAAG,MAMvD,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,SAAU,MAAM,SAAS,MAAM,KAAG,MAkBlE,CAAA"}