@leemour/cli-messaging 0.87.0 → 0.88.0

package/dist/mcp/tools.js

@@ -12,6 +12,7 @@ import { messageDeleteTools } from "./tools/messages-delete.js";
 import { messagesPhotoTools } from "./tools/messages-photo.js";
 import { messageSendTools } from "./tools/messages-send.js";
 import { messagesTranscribeTools } from "./tools/messages-transcribe.js";
+import { moderationTools } from "./tools/moderation.js";
 import { pollReadTools, pollWriteTools } from "./tools/polls.js";
 import { reactionTools } from "./tools/reactions.js";
 import { reviewTools } from "./tools/review.js";
@@ -41,6 +42,7 @@ export const sendTools = (messenger) => ({
     ...adminTools(messenger),
     ...folderTools(messenger),
     ...contactWriteTools(messenger),
+    ...moderationTools(messenger),
     ...messageSendTools(messenger),
     ...messageActionTools(messenger),
     ...reactionTools(messenger),

package/dist/mcp/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,YAAY,CAAC,SAAS,CAAC;IAC1B,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,uBAAuB,CAAC,SAAS,CAAC;CACtC,CAAC,CAAA;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;AAEzG,kHAAkH;AAClH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;AAE3G,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,iBAAiB,CAAC,SAAS,CAAC;IAC/B,GAAG,gBAAgB,CAAC,SAAS,CAAC;IAC9B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,cAAc,CAAC,SAAS,CAAC;CAC7B,CAAC,CAAA"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,YAAY,CAAC,SAAS,CAAC;IAC1B,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,uBAAuB,CAAC,SAAS,CAAC;CACtC,CAAC,CAAA;AAEF,0GAA0G;AAC1G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;AAEzG,kHAAkH;AAClH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;AAE3G,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAoB,EAA2B,EAAE,CAAC,CAAC;IAC3E,GAAG,UAAU,CAAC,SAAS,CAAC;IACxB,GAAG,WAAW,CAAC,SAAS,CAAC;IACzB,GAAG,iBAAiB,CAAC,SAAS,CAAC;IAC/B,GAAG,eAAe,CAAC,SAAS,CAAC;IAC7B,GAAG,gBAAgB,CAAC,SAAS,CAAC;IAC9B,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,aAAa,CAAC,SAAS,CAAC;IAC3B,GAAG,cAAc,CAAC,SAAS,CAAC;CAC7B,CAAC,CAAA"}

package/dist/moderation/check.d.ts

@@ -0,0 +1,83 @@
+import type { MessengerAdapter } from "../cli/messenger/port.js";
+import type { GroupMember, Id, Message } from "../domain/models.js";
+import type { GroupRules } from "./rules.js";
+export type Action = "report" | "delete" | "remove";
+export type Outcome = "reported" | "done" | "planned" | "forbidden" | "declined" | "refused" | "failed" | "skipped";
+export interface Finding {
+    /** A message, or somebody who joined. */
+    kind: "message" | "member";
+    rule: "blocked" | "invites" | "links" | "forwards" | "flood" | "newAccount";
+    personId: Id;
+    personName: string | null;
+    messageId?: Id;
+    action: Action;
+}
+export interface CheckRow extends Finding {
+    outcome: Outcome;
+    reason?: string;
+    /** What the owner types to do it by hand, on a row that was not done. */
+    command?: string;
+}
+export interface CheckInput {
+    rules: GroupRules;
+    messages: Message[];
+    joined: GroupMember[];
+    /** The group's admins; the owner's own messages are known by `outgoing`. */
+    answerers: ReadonlySet<Id>;
+    /** Service messages — someone joined, the title changed — which no rule judges. */
+    service: ReadonlySet<Id>;
+    now: number;
+}
+/**
+ * What the rules say about what is new. Pure: nothing here talks to a messenger. One finding per
+ * message — the rule with the strongest action — and one removal per person, whatever else they did.
+ */
+export declare const judge: ({ rules, messages, joined, answerers, service, now }: CheckInput) => Finding[];
+/** The two things a check may do, whoever does them: the personal account, or a bot. */
+export interface Moderator {
+    deleteMessage(chatId: Id, messageId: Id): Promise<void>;
+    removePerson(chatId: Id, personId: Id): Promise<void>;
+}
+export interface ActOptions {
+    chatId: Id;
+    rules: GroupRules;
+    /** `--allow-dangerous`: yes to every action at level `ask`. */
+    allowDangerous: boolean;
+    dryRun: boolean;
+    maxActions: number;
+    /** Asks the owner about one action: `undefined` from it, or no `confirm`, when nobody is there to answer. */
+    confirm?: (finding: Finding) => Promise<boolean | undefined>;
+    /** The program's word, for the command a row says to type by hand: `tg`, `max`. */
+    command: string;
+}
+/**
+ * Does what the findings ask, as far as the group's levels, the per-run limit and the guard let it.
+ * `deny` never acts, `readonly` only reports, `ask` asks — or `--allow-dangerous` says yes — and
+ * `allow` acts. Stops acting at the first hourly-limit refusal: the rest is `skipped`, never tried.
+ */
+export declare const act: (moderator: Moderator, findings: Finding[], options: ActOptions) => Promise<CheckRow[]>;
+/** One action in words, for a question at the terminal. */
+export declare const describe: (finding: Finding) => string;
+export interface Gathered extends Omit<CheckInput, "rules" | "now"> {
+    /** The newest message read, ISO 8601: where the next check starts. */
+    until: string | null;
+    /** More history than one check reads. */
+    more: boolean;
+    notes: string[];
+}
+/** One check reads at most this many messages; the rest waits for the next. */
+export declare const CHECK_READS = 1000;
+/**
+ * What is new in the group since `since` (ms): its messages, who joined — from the chat's service
+ * messages — and who the admins are. Reads only.
+ */
+export declare const gather: (adapter: MessengerAdapter, chatId: Id, since: number) => Promise<Gathered>;
+export declare const MAX_ACTIONS = 10;
+/**
+ * Where the next check starts: after the newest message read, or just before the first message whose
+ * action is still undone — so it is judged again, and what came after it is still read. A person
+ * who joined and is still undone keeps the point where it was, since the join is not a row's message.
+ */
+export declare const nextPoint: (rows: CheckRow[], found: Gathered) => string | null;
+export declare const someUndone: (rows: CheckRow[]) => boolean;
+//# sourceMappingURL=check.d.ts.map

package/dist/moderation/check.d.ts.map

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

package/dist/moderation/check.js

@@ -0,0 +1,227 @@
+import { CliError } from "@leemour/cli-core";
+const INVITE = /max\.ru\/join\/|(t|telegram)\.me\/(\+|joinchat\/)|tg:\/\/join/i;
+const LINK = /https?:\/\/\S+/i;
+/** Which action wins when a message breaks several rules; the first rule listed breaks a tie. */
+const STRENGTH = { report: 0, delete: 1, remove: 2 };
+/**
+ * What the rules say about what is new. Pure: nothing here talks to a messenger. One finding per
+ * message — the rule with the strongest action — and one removal per person, whatever else they did.
+ */
+export const judge = ({ rules, messages, joined, answerers, service, now }) => {
+    const trusted = new Set(rules.trusted);
+    const blocked = (id, name) => (id !== null && rules.blocked.includes(id)) ||
+        (name !== null && rules.blockedNames.some((part) => name.toLocaleLowerCase().includes(part.toLocaleLowerCase())));
+    const young = (member) => rules.newAccount.days > 0 &&
+        typeof member.registeredAt === "string" &&
+        now - Date.parse(member.registeredAt) < rules.newAccount.days * 86_400_000;
+    const found = [];
+    const add = (finding) => {
+        if (finding.action === "remove" && found.some((f) => f.action === "remove" && f.personId === finding.personId)) {
+            return;
+        }
+        found.push(finding);
+    };
+    for (const member of joined) {
+        if (trusted.has(member.id) || answerers.has(member.id))
+            continue;
+        const person = { kind: "member", personId: member.id, personName: member.name };
+        if (blocked(member.id, member.name)) {
+            add({ ...person, rule: "blocked", action: rules.blockedPeople === "remove" ? "remove" : "report" });
+        }
+        else if (young(member)) {
+            add({ ...person, rule: "newAccount", action: rules.newAccount.action });
+        }
+    }
+    const flooding = floodOf(messages, rules.flood);
+    for (const message of messages) {
+        const id = message.senderId;
+        if (id === null || message.outgoing === true || answerers.has(id) || trusted.has(id))
+            continue;
+        if (service.has(message.id) || message.attachments.some((attachment) => attachment.kind === "control"))
+            continue;
+        const base = { kind: "message", personId: id, personName: message.senderName, messageId: message.id };
+        const text = message.text;
+        const broken = [];
+        if (blocked(id, message.senderName))
+            broken.push(["blocked", rules.blockedPeople]);
+        if (INVITE.test(text))
+            broken.push(["invites", rules.invites]);
+        if (LINK.test(text) || message.attachments.some((attachment) => attachment.kind === "share")) {
+            broken.push(["links", rules.links]);
+        }
+        if (message.forwardedFrom !== null)
+            broken.push(["forwards", rules.forwards]);
+        if (flooding.has(message.id))
+            broken.push(["flood", rules.flood.action]);
+        const strongest = broken.reduce((best, rule) => (best === undefined || STRENGTH[rule[1]] > STRENGTH[best[1]] ? rule : best), undefined);
+        if (strongest)
+            add({ ...base, rule: strongest[0], action: strongest[1] });
+    }
+    return found;
+};
+/** Messages past the limit: more than `messages` from one person within `minutes`. */
+const floodOf = (messages, flood) => {
+    const window = flood.minutes * 60_000;
+    const over = new Set();
+    const bySender = new Map();
+    for (const message of messages) {
+        if (message.senderId === null)
+            continue;
+        const times = bySender.get(message.senderId) ?? [];
+        const at = Date.parse(message.timestamp);
+        times.push(at);
+        bySender.set(message.senderId, times);
+        if (times.filter((time) => at - time < window).length > flood.messages)
+            over.add(message.id);
+    }
+    return over;
+};
+/**
+ * Does what the findings ask, as far as the group's levels, the per-run limit and the guard let it.
+ * `deny` never acts, `readonly` only reports, `ask` asks — or `--allow-dangerous` says yes — and
+ * `allow` acts. Stops acting at the first hourly-limit refusal: the rest is `skipped`, never tried.
+ */
+export const act = async (moderator, findings, options) => {
+    const { chatId, rules, allowDangerous, dryRun, maxActions, confirm, command } = options;
+    const rows = [];
+    let acted = 0;
+    let stopped;
+    for (const finding of findings) {
+        if (finding.action === "report") {
+            rows.push({ ...finding, outcome: "reported" });
+            continue;
+        }
+        const consent = finding.action;
+        const level = rules.consent[consent];
+        const row = (outcome, reason) => ({
+            ...finding,
+            outcome,
+            ...(reason ? { reason } : {}),
+            ...(outcome === "done" || outcome === "reported" ? {} : { command: commandFor(command, chatId, finding) }),
+        });
+        if (level === "deny") {
+            rows.push(row("forbidden", `consent.${consent} is deny`));
+            continue;
+        }
+        if (level === "readonly") {
+            rows.push(row("reported", `consent.${consent} is readonly`));
+            continue;
+        }
+        if (dryRun) {
+            rows.push(row("planned", "--dry-run"));
+            continue;
+        }
+        if (stopped || acted >= maxActions) {
+            rows.push(row("skipped", stopped ?? `over the limit of ${maxActions} actions per check`));
+            continue;
+        }
+        if (level === "ask" && !allowDangerous) {
+            const yes = confirm ? await confirm(finding) : undefined;
+            if (yes === undefined) {
+                rows.push(row("planned", `consent.${consent} is ask, and nobody is there to answer — run with --allow-dangerous`));
+                continue;
+            }
+            if (!yes) {
+                rows.push(row("declined", "the answer was no"));
+                continue;
+            }
+        }
+        acted += 1;
+        try {
+            if (finding.action === "delete" && finding.messageId) {
+                await moderator.deleteMessage(chatId, finding.messageId);
+            }
+            else {
+                await moderator.removePerson(chatId, finding.personId);
+            }
+            rows.push(row("done"));
+        }
+        catch (error) {
+            const failure = asCliError(error);
+            if (failure.code === "rate_limited")
+                stopped = failure.message;
+            const refused = ["rate_limited", "permission_error", "confirmation_required"].includes(failure.code);
+            rows.push(row(refused ? "refused" : "failed", failure.message));
+        }
+    }
+    return rows;
+};
+const asCliError = (error) => error instanceof CliError
+    ? error
+    : new CliError("provider_error", error instanceof Error ? error.message : String(error));
+const who = (finding) => finding.personName ?? finding.personId;
+/** One action in words, for a question at the terminal. */
+export const describe = (finding) => finding.action === "delete"
+    ? `delete message ${finding.messageId} from ${who(finding)} for everyone (${finding.rule})`
+    : `remove ${who(finding)} from the group (${finding.rule})`;
+const commandFor = (command, chatId, finding) => finding.action === "delete"
+    ? `${command} messages delete ${chatId} ${finding.messageId} --for-everyone --allow-dangerous`
+    : finding.action === "remove"
+        ? `${command} chats members remove ${chatId} ${finding.personId}`
+        : "";
+/** One check reads at most this many messages; the rest waits for the next. */
+export const CHECK_READS = 1000;
+const PAGE = 100;
+/**
+ * What is new in the group since `since` (ms): its messages, who joined — from the chat's service
+ * messages — and who the admins are. Reads only.
+ */
+export const gather = async (adapter, chatId, since) => {
+    const notes = [];
+    const historyAfter = adapter.historyAfter;
+    if (!historyAfter)
+        throw new CliError("validation_error", "this messenger cannot read a chat forward from a time");
+    const messages = [];
+    let more = true;
+    while (more && messages.length < CHECK_READS) {
+        const last = messages.at(-1);
+        const page = await historyAfter.call(adapter, chatId, {
+            limit: PAGE,
+            after: last ? { id: last.id } : { time: since },
+        });
+        messages.push(...page.items);
+        more = page.hasMore && page.items.length > 0;
+    }
+    const events = adapter.chatEvents ? (await adapter.chatEvents(chatId, { since })).events : [];
+    if (!adapter.chatEvents)
+        notes.push("this messenger does not say who joined, so only messages are judged");
+    const joinedIds = new Set(events
+        .filter((one) => one.event === "join" || one.event === "add")
+        .flatMap((one) => (one.people.length > 0 ? one.people.map((person) => person.id) : one.by.id ? [one.by.id] : [])));
+    const joined = joinedIds.size === 0 || !adapter.members
+        ? []
+        : (await adapter.members(chatId, { offset: 0 })).items.filter((member) => joinedIds.has(member.id));
+    const admins = adapter.admins ? await adapter.admins(chatId) : null;
+    if (admins === null)
+        notes.push("the group's admins are not known, so only your own messages are exempt");
+    return {
+        messages,
+        joined,
+        answerers: new Set(admins ?? []),
+        service: new Set(events.map((one) => one.messageId)),
+        until: messages.at(-1)?.timestamp ?? null,
+        more,
+        notes,
+    };
+};
+export const MAX_ACTIONS = 10;
+const undone = (row) => ["planned", "skipped", "failed"].includes(row.outcome);
+/**
+ * Where the next check starts: after the newest message read, or just before the first message whose
+ * action is still undone — so it is judged again, and what came after it is still read. A person
+ * who joined and is still undone keeps the point where it was, since the join is not a row's message.
+ */
+export const nextPoint = (rows, found) => {
+    const waiting = rows.filter(undone);
+    if (waiting.some((row) => row.messageId === undefined))
+        return null;
+    const times = waiting
+        .map((row) => found.messages.find((message) => message.id === row.messageId)?.timestamp)
+        .filter((time) => time !== undefined)
+        .map(Date.parse);
+    if (times.length === 0)
+        return found.until;
+    return new Date(Math.min(...times) - 1).toISOString();
+};
+export const someUndone = (rows) => rows.some(undone);
+//# sourceMappingURL=check.js.map

package/dist/moderation/check.js.map

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

package/dist/moderation/rules.d.ts

@@ -0,0 +1,105 @@
+import * as v from "valibot";
+import type { AppIdentity } from "../cli/app.js";
+import type { Id } from "../domain/models.js";
+/** What a rule does with what it finds; nothing but `report` acts until the group's level lets it. */
+export declare const RULE_ACTIONS: readonly ["report", "delete", "remove"];
+/** `requests` and `consent.accept|decline` were for join requests (max-cli `FIND-249`); a file with them loads and drops them. */
+declare const groupRules: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+    readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly trusted: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a person id is digits">]>, undefined>;
+    readonly blocked: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a person id is digits">]>, undefined>;
+    readonly blockedNames: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly links: v.PicklistSchema<readonly ["report", "delete", "remove"], undefined>;
+    readonly invites: v.PicklistSchema<readonly ["report", "delete", "remove"], undefined>;
+    readonly forwards: v.PicklistSchema<readonly ["report", "delete", "remove"], undefined>;
+    readonly blockedPeople: v.PicklistSchema<readonly ["report", "delete", "remove"], undefined>;
+    readonly flood: v.StrictObjectSchema<{
+        readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, number, undefined>]>;
+        readonly minutes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, number, undefined>]>;
+        readonly action: v.PicklistSchema<readonly ["report", "delete", "remove"], undefined>;
+    }, undefined>;
+    /** 0 days turns the rule off. */
+    readonly newAccount: v.StrictObjectSchema<{
+        readonly days: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, number, undefined>]>;
+        readonly action: v.PicklistSchema<["report", "remove"], undefined>;
+    }, undefined>;
+    readonly requests: v.OptionalSchema<v.UnknownSchema, undefined>;
+    readonly consent: v.StrictObjectSchema<{
+        readonly delete: v.SchemaWithPipe<readonly [v.PicklistSchema<["deny", "readonly", "ask", "allow", ...string[]], undefined>, v.TransformAction<string, "allow" | "ask" | "deny" | "readonly">]>;
+        readonly remove: v.SchemaWithPipe<readonly [v.PicklistSchema<["deny", "readonly", "ask", "allow", ...string[]], undefined>, v.TransformAction<string, "allow" | "ask" | "deny" | "readonly">]>;
+        readonly accept: v.OptionalSchema<v.UnknownSchema, undefined>;
+        readonly decline: v.OptionalSchema<v.UnknownSchema, undefined>;
+    }, undefined>;
+}, undefined>, v.TransformAction<{
+    title: string | null;
+    trusted: string[];
+    blocked: string[];
+    blockedNames: string[];
+    links: "delete" | "remove" | "report";
+    invites: "delete" | "remove" | "report";
+    forwards: "delete" | "remove" | "report";
+    blockedPeople: "delete" | "remove" | "report";
+    flood: {
+        messages: number;
+        minutes: number;
+        action: "delete" | "remove" | "report";
+    };
+    newAccount: {
+        days: number;
+        action: "remove" | "report";
+    };
+    requests?: unknown;
+    consent: {
+        delete: "allow" | "ask" | "deny" | "readonly";
+        remove: "allow" | "ask" | "deny" | "readonly";
+        accept?: unknown;
+        decline?: unknown;
+    };
+}, {
+    title: string | null;
+    trusted: string[];
+    blocked: string[];
+    blockedNames: string[];
+    links: "delete" | "remove" | "report";
+    invites: "delete" | "remove" | "report";
+    forwards: "delete" | "remove" | "report";
+    blockedPeople: "delete" | "remove" | "report";
+    flood: {
+        messages: number;
+        minutes: number;
+        action: "delete" | "remove" | "report";
+    };
+    newAccount: {
+        days: number;
+        action: "remove" | "report";
+    };
+    consent: {
+        delete: "allow" | "ask" | "deny" | "readonly";
+        remove: "allow" | "ask" | "deny" | "readonly";
+    };
+}>]>;
+export type GroupRules = v.InferOutput<typeof groupRules>;
+/** Every key written out, so the file shows all there is to set (max-cli `NEED-314`). Nothing here acts. */
+export declare const defaultRules: (title: string | null) => GroupRules;
+export declare const RULE_KEYS: string[];
+export declare const moderationPathFor: (app: AppIdentity, profile: string, env?: NodeJS.ProcessEnv) => string;
+/**
+ * The rules of each group this profile moderates, one file per profile beside the recipient list —
+ * the path max-cli used, so its rules carry over. May be edited by hand; a file that does not check
+ * out refuses rather than being guessed at.
+ */
+export declare class ModerationRules {
+    #private;
+    readonly path: string;
+    constructor(path: string);
+    /** `undefined` when this group has no section yet. */
+    read(chatId: Id): GroupRules | undefined;
+    /** Writes the group's whole section — the defaults first, if it had none — with one key changed. */
+    set(chatId: Id, title: string | null, key: string, value: string): GroupRules;
+    /** Puts one key back to its default. */
+    unset(chatId: Id, title: string | null, key: string): GroupRules;
+    checkedUntil(chatId: Id): string | undefined;
+    markChecked(chatId: Id, at: string): void;
+}
+export {};
+//# sourceMappingURL=rules.d.ts.map

package/dist/moderation/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/moderation/rules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAG7C,sGAAsG;AACtG,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAgBnE,kIAAkI;AAClI,QAAA,MAAM,UAAU;;;;;;;;;;;;;;IAWZ,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcpC,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,UAAU,CAAC,CAAA;AAQzD,4GAA4G;AAC5G,eAAO,MAAM,YAAY,UAAW,MAAM,GAAG,IAAI,KAAG,UAYlD,CAAA;AA4BF,eAAO,MAAM,SAAS,UAAoB,CAAA;AAE1C,eAAO,MAAM,iBAAiB,QAAS,WAAW,WAAW,MAAM,QAAO,MAAM,CAAC,UAAU,KAAiB,MAKzG,CAAA;AAEH;;;;GAIG;AACH,qBAAa,eAAe;;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAjC,YAAqB,IAAI,EAAE,MAAM,EAAI;IAErC,sDAAsD;IACtD,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,UAAU,GAAG,SAAS,CAEvC;IAED,oGAAoG;IACpG,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAS5E;IAED,wCAAwC;IACxC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAO/D;IAED,YAAY,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,SAAS,CAE3C;IAED,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAGxC;CAqBF"}

package/dist/moderation/rules.js

@@ -0,0 +1,158 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@leemour/cli-core";
+import * as v from "valibot";
+import { LEVELS } from "../sends/permissions.js";
+/** What a rule does with what it finds; nothing but `report` acts until the group's level lets it. */
+export const RULE_ACTIONS = ["report", "delete", "remove"];
+/**
+ * max-cli's first words for a group's consent (`NEED-308`), read as the profile's levels
+ * (`NEED-462` B): `flag` and `confirm` both ask, `forbid` denies.
+ */
+const OLD_LEVELS = { forbid: "deny", flag: "ask", confirm: "ask", allow: "allow" };
+const level = v.pipe(v.picklist([...LEVELS, ...Object.keys(OLD_LEVELS)]), v.transform((typed) => (OLD_LEVELS[typed] ?? typed)));
+const action = v.picklist(RULE_ACTIONS);
+const personIds = v.array(v.pipe(v.string(), v.regex(/^-?\d+$/, "a person id is digits")));
+const atLeast = (min) => v.pipe(v.number(), v.integer(), v.minValue(min));
+/** `requests` and `consent.accept|decline` were for join requests (max-cli `FIND-249`); a file with them loads and drops them. */
+const groupRules = v.pipe(v.strictObject({
+    title: v.nullable(v.string()),
+    trusted: personIds,
+    blocked: personIds,
+    blockedNames: v.array(v.pipe(v.string(), v.minLength(1))),
+    links: action,
+    invites: action,
+    forwards: action,
+    blockedPeople: action,
+    flood: v.strictObject({ messages: atLeast(1), minutes: atLeast(1), action }),
+    /** 0 days turns the rule off. */
+    newAccount: v.strictObject({ days: atLeast(0), action: v.picklist(["report", "remove"]) }),
+    requests: v.optional(v.unknown()),
+    consent: v.strictObject({
+        delete: level,
+        remove: level,
+        accept: v.optional(v.unknown()),
+        decline: v.optional(v.unknown()),
+    }),
+}), v.transform(({ requests: _, consent: { accept: _accept, decline: _decline, ...consent }, ...rules }) => ({
+    ...rules,
+    consent,
+})));
+const file = v.strictObject({
+    groups: v.record(v.string(), groupRules),
+    /** Where each group's next `chats moderate` starts, ISO 8601. */
+    checkedUntil: v.optional(v.record(v.string(), v.string())),
+});
+/** Every key written out, so the file shows all there is to set (max-cli `NEED-314`). Nothing here acts. */
+export const defaultRules = (title) => ({
+    title,
+    trusted: [],
+    blocked: [],
+    blockedNames: [],
+    links: "report",
+    invites: "report",
+    forwards: "report",
+    blockedPeople: "report",
+    flood: { messages: 5, minutes: 1, action: "report" },
+    newAccount: { days: 7, action: "report" },
+    consent: { delete: "ask", remove: "ask" },
+});
+const list = (value) => value
+    .split(",")
+    .map((item) => item.trim())
+    .filter(Boolean);
+const whole = (value) => (/^\d+$/.test(value.trim()) ? Number(value) : Number.NaN);
+/** What `chats rules set` accepts, and how its text becomes the stored value. */
+const KEYS = {
+    trusted: { help: "person ids, comma-separated; never acted on", parse: list },
+    blocked: { help: "person ids, comma-separated", parse: list },
+    blockedNames: { help: "parts of a name, comma-separated, any case", parse: list },
+    links: { help: RULE_ACTIONS.join("|"), parse: String },
+    invites: { help: RULE_ACTIONS.join("|"), parse: String },
+    forwards: { help: RULE_ACTIONS.join("|"), parse: String },
+    blockedPeople: { help: RULE_ACTIONS.join("|"), parse: String },
+    "flood.messages": { help: "a whole number, 1 or more", parse: whole },
+    "flood.minutes": { help: "a whole number, 1 or more", parse: whole },
+    "flood.action": { help: RULE_ACTIONS.join("|"), parse: String },
+    "newAccount.days": { help: "a whole number; 0 turns it off", parse: whole },
+    "newAccount.action": { help: "report|remove", parse: String },
+    "consent.delete": { help: LEVELS.join("|"), parse: String },
+    "consent.remove": { help: LEVELS.join("|"), parse: String },
+};
+export const RULE_KEYS = Object.keys(KEYS);
+export const moderationPathFor = (app, profile, env = process.env) => join(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).state, "profiles", `${profile}.moderation.json`);
+/**
+ * The rules of each group this profile moderates, one file per profile beside the recipient list —
+ * the path max-cli used, so its rules carry over. May be edited by hand; a file that does not check
+ * out refuses rather than being guessed at.
+ */
+export class ModerationRules {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    /** `undefined` when this group has no section yet. */
+    read(chatId) {
+        return this.#file().groups[chatId];
+    }
+    /** Writes the group's whole section — the defaults first, if it had none — with one key changed. */
+    set(chatId, title, key, value) {
+        const known = KEYS[key];
+        if (!known)
+            throw invalid(`no rule ${key} — one of: ${RULE_KEYS.join(", ")}`);
+        const current = this.read(chatId) ?? defaultRules(title);
+        const checked = v.safeParse(groupRules, assign(current, key, known.parse(value)));
+        if (!checked.success)
+            throw invalid(`${key} ${JSON.stringify(value)} is not valid — ${known.help}`);
+        const saved = this.#file();
+        this.#write({ ...saved, groups: { ...saved.groups, [chatId]: checked.output } });
+        return checked.output;
+    }
+    /** Puts one key back to its default. */
+    unset(chatId, title, key) {
+        if (!KEYS[key])
+            throw invalid(`no rule ${key} — one of: ${RULE_KEYS.join(", ")}`);
+        const current = this.read(chatId) ?? defaultRules(title);
+        const changed = assign(current, key, lookup(defaultRules(title), key));
+        const saved = this.#file();
+        this.#write({ ...saved, groups: { ...saved.groups, [chatId]: changed } });
+        return changed;
+    }
+    checkedUntil(chatId) {
+        return this.#file().checkedUntil?.[chatId];
+    }
+    markChecked(chatId, at) {
+        const saved = this.#file();
+        this.#write({ ...saved, checkedUntil: { ...saved.checkedUntil, [chatId]: at } });
+    }
+    #file() {
+        if (!existsSync(this.path))
+            return { groups: {} };
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(this.path, "utf8"));
+        }
+        catch (error) {
+            throw broken(this.path, error instanceof Error ? error.message : String(error));
+        }
+        const checked = v.safeParse(file, parsed);
+        if (!checked.success) {
+            const problems = checked.issues.map((issue) => `${v.getDotPath(issue) ?? "file"}: ${issue.message}`);
+            throw broken(this.path, problems.join("; "));
+        }
+        return checked.output;
+    }
+    #write(content) {
+        writeSecurely(this.path, `${JSON.stringify(content, null, 2)}\n`, 0o600);
+    }
+}
+const invalid = (message) => new CliError("validation_error", message);
+const broken = (path, why) => new CliError("configuration_error", `the moderation rules ${path} cannot be read (${why}) — fix the file`);
+const lookup = (rules, key) => key.split(".").reduce((value, part) => value[part], rules);
+const assign = (rules, key, value) => {
+    const [head, tail] = key.split(".");
+    if (tail === undefined)
+        return { ...rules, [head]: value };
+    return { ...rules, [head]: { ...rules[head], [tail]: value } };
+};
+//# sourceMappingURL=rules.js.map