@leemour/max-cli 0.13.0 → 0.15.0

package/dist/moderation/check.js

@@ -0,0 +1,306 @@
+import { CliError } from "@leemour/cli-core";
+import { defaultRules, ModerationRules, moderationPathFor } from "./rules.js";
+const INVITE = /max\.ru\/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 MAX. 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, requests, answerers, 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 &&
+        member.registeredAt !== null &&
+        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 request of requests) {
+        const person = { kind: "request", personId: request.id, personName: request.name };
+        const policy = rules.requests;
+        if (trusted.has(request.id) && (policy === "accept-trusted" || policy === "both")) {
+            add({ ...person, rule: "trusted", action: "accept" });
+        }
+        else if (blocked(request.id, request.name)) {
+            add({
+                ...person,
+                rule: "blocked",
+                action: policy === "decline-blocked" || policy === "both" ? "decline" : "report",
+            });
+        }
+        else if (young(request)) {
+            add({ ...person, rule: "newAccount", action: rules.newAccount.action === "remove" ? "decline" : "report" });
+        }
+        else {
+            add({ ...person, rule: "request", action: "report" });
+        }
+    }
+    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 (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;
+};
+const CONSENT = {
+    delete: "delete",
+    remove: "remove",
+    accept: "accept",
+    decline: "decline",
+};
+/** The personal account: deleting is for everyone, removing leaves messages and cannot ban. */
+export const personal = (client) => ({
+    deleteMessage: async (chatId, messageId) => {
+        await client.messages.delete(chatId, [messageId], { forEveryone: true });
+    },
+    removePerson: async (chatId, personId) => {
+        await client.chats.members.remove(chatId, [personId]);
+    },
+});
+export const act = async (moderator, findings, options) => {
+    const { chatId, rules, allowDangerous, dryRun, maxActions, confirm } = options;
+    const rows = [];
+    let acted = 0;
+    let stopped;
+    for (const finding of findings) {
+        if (finding.action === "report") {
+            rows.push({ ...finding, outcome: "reported" });
+            continue;
+        }
+        const command = commandFor(chatId, finding);
+        const level = rules.consent[CONSENT[finding.action]];
+        const row = (outcome, reason) => ({
+            ...finding,
+            outcome,
+            ...(reason ? { reason } : {}),
+            ...(outcome === "done" ? {} : { command }),
+        });
+        if (level === "forbid") {
+            rows.push(row("forbidden", `consent.${CONSENT[finding.action]} is forbid`));
+            continue;
+        }
+        if (finding.action === "accept" || finding.action === "decline") {
+            rows.push(row("planned", "accepting and declining are not measured against MAX yet (MAX-41)"));
+            continue;
+        }
+        if (dryRun) {
+            rows.push(row("planned", "--dry-run"));
+            continue;
+        }
+        if (level === "flag" && !allowDangerous) {
+            rows.push(row("planned", `consent.${CONSENT[finding.action]} is flag — run with --allow-dangerous`));
+            continue;
+        }
+        if (stopped || acted >= maxActions) {
+            rows.push(row("skipped", stopped ?? `over the limit of ${maxActions} actions per check`));
+            continue;
+        }
+        if (level === "confirm") {
+            if (!confirm) {
+                rows.push(row("planned", `consent.${CONSENT[finding.action]} is confirm, and nobody is there to ask`));
+                continue;
+            }
+            if (!(await confirm(finding))) {
+                rows.push(row("declined", "not confirmed"));
+                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 prompt or a confirmation form. */
+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})`;
+/** Whether acting on it waits for the owner's yes. */
+export const needsConfirm = (rules, finding) => (finding.action === "delete" || finding.action === "remove") && rules.consent[finding.action] === "confirm";
+const commandFor = (chatId, finding) => {
+    switch (finding.action) {
+        case "delete":
+            return `max messages delete ${chatId} ${finding.messageId} --for-everyone --allow-dangerous`;
+        case "remove":
+            return `max chats members remove ${chatId} ${finding.personId}`;
+        case "accept":
+            return `max chats requests accept ${chatId} ${finding.personId}`;
+        case "decline":
+            return `max chats requests decline ${chatId} ${finding.personId}`;
+        default:
+            return "";
+    }
+};
+/**
+ * What is new in the group since `since`: its messages, who joined (from the service messages —
+ * `add` measured, `joinByLink` assumed to name the joiner or be sent by them), who asks to join,
+ * and who the admins are.
+ */
+export const gather = async (client, chatId, since) => {
+    const notes = [];
+    const { messages, more } = await client.chats.since(chatId, since);
+    const joinedIds = new Set(messages.flatMap((message) => message.attachments.flatMap((attachment) => {
+        if (attachment.event === "add")
+            return attachment.userIds ?? [];
+        if (attachment.event === "joinByLink") {
+            return attachment.userIds?.length ? attachment.userIds : message.senderId ? [message.senderId] : [];
+        }
+        return [];
+    })));
+    const joined = joinedIds.size === 0
+        ? []
+        : (await client.chats.members.list(chatId)).members.filter((member) => joinedIds.has(member.id));
+    let requests = [];
+    try {
+        requests = await client.chats.requests.list(chatId);
+    }
+    catch (error) {
+        notes.push(`join requests not read: ${asCliError(error).message}`);
+    }
+    const admins = await client.chats.adminIds(chatId);
+    if (admins === undefined)
+        notes.push("the group's admins are not known, so only your own messages are exempt");
+    return {
+        messages,
+        joined,
+        requests,
+        answerers: new Set(admins ?? []),
+        until: messages.at(-1)?.timestamp ?? null,
+        more,
+        notes,
+    };
+};
+export const MAX_ACTIONS = 10;
+/** A group never checked before is looked at this far back. */
+const FIRST_LOOK_MS = 24 * 3_600_000;
+/** Reads and judges; changes nothing. `since` overrides the group's saved point. */
+export const prepare = async (client, { store, profile, chat, since }) => {
+    const group = await client.chats.show(chat);
+    const saved = new ModerationRules(moderationPathFor(profile)).read(group.id);
+    const rules = saved ?? defaultRules(group.title);
+    const point = store.readState().checkedUntil?.[group.id];
+    const from = since ?? (point === undefined ? Date.now() - FIRST_LOOK_MS : Date.parse(point));
+    const found = await gather(client, group.id, from);
+    return {
+        chatId: group.id,
+        title: group.title,
+        rules,
+        found,
+        findings: judge({ ...found, rules, now: Date.now() }),
+        explicit: since !== undefined,
+        notes: [
+            ...(saved ? [] : [`${group.title ?? group.id} has no rules yet — the defaults only report`]),
+            ...found.notes,
+        ],
+    };
+};
+/** Acts on what `prepare` found, moves the group's saved point, and says what is left. */
+export const finish = async (moderator, store, prepared, options) => {
+    const { chatId, rules, found, findings, explicit } = prepared;
+    const rows = await act(moderator, findings, { ...options, chatId, rules });
+    const notes = [...prepared.notes];
+    const next = nextPoint(rows, found);
+    if (!explicit && !options.dryRun && next !== null) {
+        const state = store.readState();
+        store.writeState({ ...state, checkedUntil: { ...state.checkedUntil, [chatId]: next } });
+    }
+    if (next !== found.until && rows.some(undone)) {
+        notes.push("some actions are not done — the next check starts at the first of them");
+    }
+    else if (found.more) {
+        notes.push("more history than one check reads — the next check goes on from here");
+    }
+    return { rows, notes };
+};
+const undone = (row) => ["planned", "skipped", "failed"].includes(row.outcome) && row.kind !== "request";
+/**
+ * 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.
+ */
+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();
+};
+//# 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,56 @@
+import * as v from "valibot";
+import type { Id } from "../domain/models.js";
+/** How much say the owner keeps over one kind of action (`NEED-308`). */
+export declare const CONSENT_LEVELS: readonly ["forbid", "flag", "confirm", "allow"];
+/** What a rule does with what it finds; nothing but `report` acts until consent lets it. */
+export declare const RULE_ACTIONS: readonly ["report", "delete", "remove"];
+export declare const REQUEST_POLICIES: readonly ["report", "accept-trusted", "decline-blocked", "both"];
+declare const groupRules: 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>;
+    /** `remove` declines a join request and removes a member. 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.PicklistSchema<readonly ["report", "accept-trusted", "decline-blocked", "both"], undefined>;
+    readonly consent: v.StrictObjectSchema<{
+        readonly delete: v.PicklistSchema<readonly ["forbid", "flag", "confirm", "allow"], undefined>;
+        readonly remove: v.PicklistSchema<readonly ["forbid", "flag", "confirm", "allow"], undefined>;
+        readonly accept: v.PicklistSchema<readonly ["forbid", "flag", "confirm", "allow"], undefined>;
+        readonly decline: v.PicklistSchema<readonly ["forbid", "flag", "confirm", "allow"], undefined>;
+    }, undefined>;
+}, undefined>;
+export type GroupRules = v.InferOutput<typeof groupRules>;
+/** Every key written out, so the file shows all there is to set (`NEED-314`). Nothing here acts. */
+export declare const defaultRules: (title: string | null) => GroupRules;
+export declare const RULE_KEYS: string[];
+export declare const moderationPathFor: (profile: string, env?: NodeJS.ProcessEnv) => string;
+/**
+ * The rules of each group this profile moderates, one state file per profile beside the recipient
+ * list. 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;
+}
+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,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAE7C,yEAAyE;AACzE,eAAO,MAAM,cAAc,YAAI,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAC7E,4FAA4F;AAC5F,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAA;AACnE,eAAO,MAAM,gBAAgB,YAAI,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,CAAU,CAAA;AAOhG,QAAA,MAAM,UAAU;;;;;;;;;;;;;;IAUd,wFAAwF;;;;;;;;;;;;aAIxF,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,UAAU,CAAC,CAAA;AAIzD,oGAAoG;AACpG,eAAO,MAAM,YAAY,UAAW,MAAM,GAAG,IAAI,KAAG,UAalD,CAAA;AA+BF,eAAO,MAAM,SAAS,UAAoB,CAAA;AAE1C,eAAO,MAAM,iBAAiB,YAAa,MAAM,QAAO,MAAM,CAAC,UAAU,KAAiB,MACsB,CAAA;AAEhH;;;GAGG;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;CAqBF"}

package/dist/moderation/rules.js

@@ -0,0 +1,138 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@leemour/cli-core";
+import * as v from "valibot";
+/** How much say the owner keeps over one kind of action (`NEED-308`). */
+export const CONSENT_LEVELS = ["forbid", "flag", "confirm", "allow"];
+/** What a rule does with what it finds; nothing but `report` acts until consent lets it. */
+export const RULE_ACTIONS = ["report", "delete", "remove"];
+export const REQUEST_POLICIES = ["report", "accept-trusted", "decline-blocked", "both"];
+const level = v.picklist(CONSENT_LEVELS);
+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));
+const groupRules = 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 }),
+    /** `remove` declines a join request and removes a member. 0 days turns the rule off. */
+    newAccount: v.strictObject({ days: atLeast(0), action: v.picklist(["report", "remove"]) }),
+    requests: v.picklist(REQUEST_POLICIES),
+    consent: v.strictObject({ delete: level, remove: level, accept: level, decline: level }),
+});
+const file = v.strictObject({ groups: v.record(v.string(), groupRules) });
+/** Every key written out, so the file shows all there is to set (`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" },
+    requests: "report",
+    consent: { delete: "flag", remove: "flag", accept: "flag", decline: "flag" },
+});
+const list = (value) => value
+    .split(",")
+    .map((item) => item.trim())
+    .filter(Boolean);
+const whole = (value) => (/^\d+$/.test(value.trim()) ? Number(value) : Number.NaN);
+/** What `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 },
+    requests: { help: REQUEST_POLICIES.join("|"), parse: String },
+    "consent.delete": { help: CONSENT_LEVELS.join("|"), parse: String },
+    "consent.remove": { help: CONSENT_LEVELS.join("|"), parse: String },
+    "consent.accept": { help: CONSENT_LEVELS.join("|"), parse: String },
+    "consent.decline": { help: CONSENT_LEVELS.join("|"), parse: String },
+};
+export const RULE_KEYS = Object.keys(KEYS);
+export const moderationPathFor = (profile, env = process.env) => join(resolvePaths({ appName: "max-cli", prefix: "MAX", env }).state, "profiles", `${profile}.moderation.json`);
+/**
+ * The rules of each group this profile moderates, one state file per profile beside the recipient
+ * list. 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.#all()[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 changed = assign(current, key, known.parse(value));
+        const checked = v.safeParse(groupRules, changed);
+        if (!checked.success)
+            throw invalid(`${key} ${JSON.stringify(value)} is not valid — ${known.help}`);
+        this.#write({ ...this.#all(), [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 fallback = lookup(defaultRules(title), key);
+        const current = this.read(chatId) ?? defaultRules(title);
+        const changed = assign(current, key, fallback);
+        this.#write({ ...this.#all(), [chatId]: changed });
+        return changed;
+    }
+    #all() {
+        if (!existsSync(this.path))
+            return {};
+        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.groups;
+    }
+    #write(groups) {
+        writeSecurely(this.path, `${JSON.stringify({ groups }, 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

package/dist/moderation/rules.js.map

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

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAA;AASnD,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,uBAAuB,CAAA;AAwBjE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,kBAAkB,cAAc,KAAQ,OAwEjE,CAAA;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,SAAgB,MAAM,EAAE,YAAW,UAAU,KAAQ,OAAO,CAAC,MAAM,CAuElF,CAAA"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAA;AAUnD,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,uBAAuB,CAAA;AAwBjE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,kBAAkB,cAAc,KAAQ,OAyEjE,CAAA;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,SAAgB,MAAM,EAAE,YAAW,UAAU,KAAQ,OAAO,CAAC,MAAM,CAwElF,CAAA"}

package/dist/program.js

@@ -1,7 +1,8 @@
-import { CliError, exitCodeFor, GENERIC_FAILURE, processStreams, visibleControls, } from "@leemour/cli-core";
+import { CliError, errorCodes, exitCodeFor, GENERIC_FAILURE, processStreams, visibleControls, } from "@leemour/cli-core";
 import { Command, CommanderError } from "commander";
 import { accountCommand } from "./commands/account.js";
 import { backupCommand } from "./commands/backup.js";
+import { botCommand } from "./commands/bot.js";
 import { cacheCommand } from "./commands/cache.js";
 import { chatsCommand } from "./commands/chats.js";
 import { commandsCommand } from "./commands/commands.js";
@@ -43,7 +44,7 @@ export const createProgram = ({ out, err } = {}) => {
     program
         .name("max")
         .usage("[profile] [options] <command>")
-        .description("A local command line interface for a personal MAX Messenger account\n\n" +
+        .description("MAX Messenger from the terminal: bots through the official Bot API (`max bot …`), and your personal account\n\n" +
         "The first word is the profile whenever it is not a command — `max personal chats list`.\n" +
         "`MAX_PROFILE` says the same thing for a whole shell session; without either it is `default`.")
         .version(VERSION, "-V, --version")
@@ -87,6 +88,7 @@ export const createProgram = ({ out, err } = {}) => {
     program.addCommand(selfUpdateCommand());
     program.addCommand(completeCommand(), { hidden: true });
     program.addCommand(mcpCommand());
+    program.addCommand(botCommand());
     // Depth-first: Commander does not pass `configureOutput` down to a command added with
     // `addCommand`, so `max messages --help` would write to the real terminal while the top level
     // wrote to the injected streams — and a test reading stdout would see nothing at all.
@@ -149,7 +151,8 @@ export const run = async (argv, options = {}) => {
             streams.diagnostic(line);
         return process.exitCode === undefined ? 0 : Number(process.exitCode);
     }
-    catch (error) {
+    catch (thrown) {
+        const error = ownCliError(thrown);
         if (!(error instanceof CommanderError) || error.exitCode !== 0) {
             const failure = error instanceof CommanderError ? new CliError("validation_error", error.message) : error;
             await keepFailure(failure, program, rest, profile, streams);
@@ -178,6 +181,18 @@ export const run = async (argv, options = {}) => {
  * command that never opens one — through the same recorder, unless recording was turned off by
  * name (`OPS-15`). Only the command's words are named, never its arguments: those can be a message.
  */
+/**
+ * cli-messaging brings its own copy of cli-core, and its `CliError` is not an `instanceof` ours —
+ * a recipient-list refusal would otherwise leave with exit 1 and `generic_failure`.
+ */
+const ownCliError = (error) => {
+    if (error instanceof CliError || !(error instanceof Error) || error.name !== "CliError")
+        return error;
+    const { code, details } = error;
+    if (typeof code !== "string" || !errorCodes.includes(code))
+        return error;
+    return new CliError(code, error.message, details ?? {});
+};
 const keepFailure = async (error, program, rest, profile, streams) => {
     if (wasSettled(error))
         return;