@wirecat/cli-core 0.20.0 → 0.262.0

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 "@wirecat/cli-base";
+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

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/moderation/run.d.ts

@@ -0,0 +1,38 @@
+import type { Id } from "../domain/models.js";
+import { type CheckRow, type Finding, type Gathered, type Moderator } from "./check.js";
+import { type ModerationRules } from "./rules.js";
+/** A group never checked before is looked at this far back. */
+export declare const FIRST_LOOK_MS: number;
+/** Where a group's last check stopped; the personal account keeps it in the rules file, a bot beside its state. */
+export interface SavedPoint {
+    read(chatId: Id): string | undefined;
+    write(chatId: Id, at: string): void;
+}
+export interface ModerateRun {
+    chatId: Id;
+    title: string | null;
+    rules: ModerationRules;
+    point: SavedPoint;
+    /** Everything new since this time, ms. */
+    gather: (since: number) => Promise<Gathered>;
+    moderator: Moderator;
+    /** The messenger's invite-link pattern, for the `invites` rule. */
+    invites?: RegExp;
+    /** The program's word, for the command a row says to type by hand. */
+    command: string;
+    /** In place of the personal commands a row names: a bot's own. */
+    commandFor?: (chatId: Id, finding: Finding) => string;
+    /** ms; the saved point is neither read nor moved. */
+    since?: number;
+    dryRun: boolean;
+    allowDangerous: boolean;
+    maxActions: number;
+    confirm?: (finding: Finding) => Promise<boolean | undefined>;
+}
+/** Judges what is new in one group by its rules, acts as they allow, and moves the saved point. */
+export declare const moderateWith: (run: ModerateRun) => Promise<{
+    chatId: Id;
+    rows: CheckRow[];
+    notes: string[];
+}>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/moderation/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,QAAQ,EAEb,KAAK,SAAS,EAGf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAE/D,+DAA+D;AAC/D,eAAO,MAAM,aAAa,QAAiB,CAAA;AAE3C,mHAAmH;AACnH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,SAAS,CAAA;IACpC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,EAAE,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,KAAK,EAAE,eAAe,CAAA;IACtB,KAAK,EAAE,UAAU,CAAA;IACjB,0CAA0C;IAC1C,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC5C,SAAS,EAAE,SAAS,CAAA;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAA;IACrD,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;CAC7D;AAED,mGAAmG;AACnG,eAAO,MAAM,YAAY,QAAe,WAAW,KAAG,OAAO,CAAC;IAAE,MAAM,EAAE,EAAE,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAiC9G,CAAA"}

package/dist/moderation/run.js

@@ -0,0 +1,41 @@
+import { act, judge, nextPoint, someUndone, } from "./check.js";
+import { defaultRules } from "./rules.js";
+/** A group never checked before is looked at this far back. */
+export const FIRST_LOOK_MS = 24 * 3_600_000;
+/** Judges what is new in one group by its rules, acts as they allow, and moves the saved point. */
+export const moderateWith = async (run) => {
+    const { chatId, title, rules, point, since, dryRun } = run;
+    const saved = rules.read(chatId);
+    const groupRules = saved ?? defaultRules(title);
+    const last = point.read(chatId);
+    const from = since ?? (last === undefined ? Date.now() - FIRST_LOOK_MS : Date.parse(last));
+    const found = await run.gather(from);
+    const findings = judge({
+        ...found,
+        rules: groupRules,
+        now: Date.now(),
+        ...(run.invites ? { invites: run.invites } : {}),
+    });
+    const rows = await act(run.moderator, findings, {
+        chatId,
+        rules: groupRules,
+        allowDangerous: run.allowDangerous,
+        dryRun,
+        maxActions: run.maxActions,
+        command: run.command,
+        ...(run.commandFor ? { commandFor: run.commandFor } : {}),
+        ...(run.confirm ? { confirm: run.confirm } : {}),
+    });
+    const notes = [...(saved ? [] : [`${title ?? chatId} has no rules yet — the defaults only report`]), ...found.notes];
+    const next = nextPoint(rows, found);
+    if (since === undefined && !dryRun && next !== null)
+        point.write(chatId, next);
+    if (next !== found.until && someUndone(rows)) {
+        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 { chatId, rows, notes };
+};
+//# sourceMappingURL=run.js.map

package/dist/moderation/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/moderation/run.ts"],"names":[],"mappings":"AACA,OAAO,EACL,GAAG,EAIH,KAAK,EAEL,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAwB,MAAM,YAAY,CAAA;AAE/D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,SAAS,CAAA;AA8B3C,mGAAmG;AACnG,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,GAAgB,EAA8D,EAAE;IACjH,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAChC,MAAM,UAAU,GAAG,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1F,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC;QACrB,GAAG,KAAK;QACR,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;QACf,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE;QAC9C,MAAM;QACN,KAAK,EAAE,UAAU;QACjB,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,MAAM;QACN,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,8CAA8C,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;IACpH,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACnC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,IAAI,IAAI,KAAK,IAAI;QAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC9E,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAA;IACtF,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAChC,CAAC,CAAA"}

package/dist/output-detail.d.ts

@@ -0,0 +1,10 @@
+/**
+ * How much of a found message or email an answer carries. The default is what an agent needs to name it, place it
+ * and decide whether to read it: its reference, chat or thread, time, people and an excerpt, never its whole text.
+ * `brief` keeps what tells hits apart; `full` adds the whole text and every provider field.
+ */
+export type Detail = "brief" | "default" | "full";
+export declare const DETAILS: readonly ["brief", "full"];
+/** `value` with every found message in it, at the top or in `items`, cut to `detail`; anything else unchanged. */
+export declare const atDetail: <T>(value: T, detail?: Detail) => T;
+//# sourceMappingURL=output-detail.d.ts.map

package/dist/output-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-detail.d.ts","sourceRoot":"","sources":["../src/output-detail.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAEjD,eAAO,MAAM,OAAO,YAAI,OAAO,EAAE,MAAM,CAAU,CAAA;AA+BjD,kHAAkH;AAClH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,WAAU,MAAM,KAAe,CAOlE,CAAA"}

package/dist/output-detail.js

@@ -0,0 +1,36 @@
+export const DETAILS = ["brief", "full"];
+/** Message fields mail never has and a messenger hit rarely fills; a null one is noise. */
+const RARELY_SET = ["editedAt", "replyTo", "forwardedFrom", "reactions"];
+const BRIEF = ["locator", "chatTitle", "timestamp", "senderName", "excerpt", "score"];
+const isHit = (value) => typeof value === "object" &&
+    value !== null &&
+    typeof value.locator === "string" &&
+    typeof value.text === "string";
+const shaped = (hit, detail) => {
+    if (detail === "brief")
+        return Object.fromEntries(BRIEF.flatMap((key) => (hit[key] === undefined || hit[key] === null ? [] : [[key, hit[key]]])));
+    const { text, providerMetadata, ...rest } = hit;
+    for (const key of RARELY_SET)
+        if (rest[key] === null)
+            delete rest[key];
+    // An email's people are in `email`; the provider block repeated its cc and bcc.
+    const metadata = rest.email ? undefined : providerMetadata;
+    return {
+        ...rest,
+        ...(typeof rest.excerpt === "string" ? {} : { text }),
+        ...(metadata === undefined ? {} : { providerMetadata: metadata }),
+    };
+};
+/** `value` with every found message in it, at the top or in `items`, cut to `detail`; anything else unchanged. */
+export const atDetail = (value, detail = "default") => {
+    if (detail === "full")
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => (isHit(item) ? shaped(item, detail) : item));
+    if (isHit(value))
+        return shaped(value, detail);
+    if (typeof value === "object" && value !== null && Array.isArray(value.items))
+        return { ...value, items: atDetail(value.items, detail) };
+    return value;
+};
+//# sourceMappingURL=output-detail.js.map

package/dist/output-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-detail.js","sourceRoot":"","sources":["../src/output-detail.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAA;AAEjD,2FAA2F;AAC3F,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,CAAC,CAAA;AAExE,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;AAIrF,MAAM,KAAK,GAAG,CAAC,KAAc,EAAiB,EAAE,CAC9C,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,OAAQ,KAAc,CAAC,OAAO,KAAK,QAAQ;IAC3C,OAAQ,KAAc,CAAC,IAAI,KAAK,QAAQ,CAAA;AAE1C,MAAM,MAAM,GAAG,CAAC,GAAS,EAAE,MAAc,EAAQ,EAAE;IACjD,IAAI,MAAM,KAAK,OAAO;QACpB,OAAO,MAAM,CAAC,WAAW,CACvB,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAC/F,CAAA;IACH,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAA;IAC/C,KAAK,MAAM,GAAG,IAAI,UAAU;QAAE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;IACtE,gFAAgF;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAA;IAC1D,OAAO;QACL,GAAG,IAAI;QACP,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACrD,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC;KAClE,CAAA;AACH,CAAC,CAAA;AAED,kHAAkH;AAClH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,KAAQ,EAAE,MAAM,GAAW,SAAS,EAAK,EAAE;IACrE,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAM,CAAA;IACtG,IAAI,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,CAAM,CAAA;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,KAAc,CAAC,KAAK,CAAC;QACrF,OAAO,EAAE,GAAI,KAAc,EAAE,KAAK,EAAE,QAAQ,CAAE,KAAc,CAAC,KAAK,EAAE,MAAM,CAAC,EAAO,CAAA;IACpF,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/output.d.ts

@@ -0,0 +1,31 @@
+import { type Renderer, type Streams } from "@wirecat/cli-base";
+import { type Detail } from "./output-detail.js";
+export interface OutputOptions {
+    json?: boolean;
+    jsonl?: boolean;
+    agentJson?: boolean;
+    quiet?: boolean;
+    streams?: Streams;
+    /** Whether a person is looking. Defaults to whether stdout is a terminal. */
+    tty?: boolean;
+    color?: boolean;
+    env?: NodeJS.ProcessEnv;
+    fields?: string;
+    /** How much of each found message: `brief`, the default or `full` (src/output-detail.ts). */
+    hitDetail?: Detail;
+}
+/**
+ * One place decides the mode, so no command can disagree with another.
+ *
+ * `--json` forces machine output; otherwise a terminal gets the pretty renderer and a pipe gets
+ * JSON, because a pipe is a script until proven otherwise. `--jsonl` gives one JSON object per line
+ * instead. In every machine mode **stdout carries JSON and nothing else** — diagnostics are on stderr in all modes, which is what makes
+ * that contract hold by construction rather than by remembering.
+ */
+export declare const resolveOutput: ({ json, jsonl, agentJson, quiet, streams, tty, color, fields, hitDetail, env, }?: OutputOptions) => {
+    format: "json" | "jsonl" | "pretty";
+    color: boolean;
+    streams: Streams;
+    renderer: Renderer;
+};
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,OAAO,EAEb,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,qFAWvB,aAAa;;;;;CAoCf,CAAA"}

package/dist/output.js

@@ -0,0 +1,79 @@
+import { createRenderer, processStreams, singleLine, } from "@wirecat/cli-base";
+import { fieldsOf, projectFields } from "./cli/result-fields.js";
+import { agentJson as serializeAgentJson } from "./mcp/text.js";
+import { atDetail } from "./output-detail.js";
+/**
+ * One place decides the mode, so no command can disagree with another.
+ *
+ * `--json` forces machine output; otherwise a terminal gets the pretty renderer and a pipe gets
+ * JSON, because a pipe is a script until proven otherwise. `--jsonl` gives one JSON object per line
+ * instead. In every machine mode **stdout carries JSON and nothing else** — diagnostics are on stderr in all modes, which is what makes
+ * that contract hold by construction rather than by remembering.
+ */
+export const resolveOutput = ({ json, jsonl, agentJson, quiet, streams = processStreams, tty, color, fields, hitDetail, env = process.env, } = {}) => {
+    const interactive = tty ?? process.stdout.isTTY === true;
+    const format = jsonl ? "jsonl" : agentJson || json || !interactive ? "json" : "pretty";
+    const painted = format === "pretty" && (color ?? (env.NO_COLOR === undefined && env.TERM !== "dumb" && !env.CI));
+    const rendered = createRenderer({ format, color: painted, streams });
+    // `--fields` names exactly what to keep, so it chooses from everything unless a level was asked for too.
+    const level = hitDetail ?? (fields === undefined ? "default" : "full");
+    const standard = format === "pretty"
+        ? rendered
+        : {
+            ...rendered,
+            result: (value) => rendered.result(atDetail(value, level)),
+            stream: (items) => rendered.stream(atDetail([...items], level)),
+        };
+    const safe = (value) => JSON.parse(serializeAgentJson(value));
+    const created = agentJson
+        ? {
+            ...standard,
+            result: (value) => standard.result(safe(value)),
+            stream: (items) => standard.stream([...items].map(safe)),
+        }
+        : standard;
+    const paths = fields === undefined ? undefined : fieldsOf(fields);
+    const renderer = format === "pretty"
+        ? oneLineFields(created)
+        : paths
+            ? {
+                ...created,
+                result: (value) => created.result(projectFields(value, paths)),
+                stream: (items) => created.stream([...items].map((item) => projectFields(item, paths))),
+            }
+            : created;
+    return { format, color: painted, streams, renderer: quiet ? silence(renderer) : renderer };
+};
+/** Fields a person writes in paragraphs; every other string is a name, a title, an id or a path. */
+const MULTI_LINE = new Set(["text", "description"]);
+/**
+ * The pretty renderer keeps a newline inside a cell, which is right for a message and wrong for a
+ * title: somebody else's chat title would print a row of its own. Machine output is left alone.
+ */
+const oneLineFields = (renderer) => ({
+    ...renderer,
+    result: (value) => renderer.result(oneLine(value)),
+    stream: (items) => renderer.stream([...items].map((item) => oneLine(item))),
+});
+const oneLine = (value, key) => {
+    if (typeof value === "string")
+        return key !== undefined && MULTI_LINE.has(key) ? value : singleLine(value);
+    if (Array.isArray(value))
+        return value.map((item) => oneLine(item, key));
+    if (value !== null && typeof value === "object" && Object.getPrototypeOf(value) === Object.prototype) {
+        return Object.fromEntries(Object.entries(value).map(([field, item]) => [field, oneLine(item, field)]));
+    }
+    return value;
+};
+/**
+ * Everything diagnostic, and **not** `failure`: an exit code says which kind of thing went wrong
+ * and nothing about which chat or how long to wait, so silencing the sentence too would leave a
+ * script with a number and a person with nothing.
+ */
+const silence = (renderer) => ({
+    ...renderer,
+    note: () => { },
+    success: () => { },
+    warn: () => { },
+});
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,cAAc,EAId,UAAU,GACX,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAe,MAAM,oBAAoB,CAAA;AAiB1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,SAAS,EACT,KAAK,EACL,OAAO,GAAG,cAAc,EACxB,GAAG,EACH,KAAK,EACL,MAAM,EACN,SAAS,EACT,GAAG,GAAG,OAAO,CAAC,GAAG,GAClB,GAAkB,EAAE,EAAE,EAAE;IACvB,MAAM,WAAW,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAA;IACxD,MAAM,MAAM,GAAiB,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAA;IACpG,MAAM,OAAO,GAAG,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IAChH,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IACpE,yGAAyG;IACzG,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IACtE,MAAM,QAAQ,GACZ,MAAM,KAAK,QAAQ;QACjB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC;YACE,GAAG,QAAQ;YACX,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACnE,MAAM,EAAE,CAAC,KAAwB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;SACnF,CAAA;IACP,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAY,CAAA;IACjF,MAAM,OAAO,GAAG,SAAS;QACvB,CAAC,CAAC;YACE,GAAG,QAAQ;YACX,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,KAAwB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SAC5E;QACH,CAAC,CAAC,QAAQ,CAAA;IACZ,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjE,MAAM,QAAQ,GACZ,MAAM,KAAK,QAAQ;QACjB,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC;QACxB,CAAC,CAAC,KAAK;YACL,CAAC,CAAC;gBACE,GAAG,OAAO;gBACV,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACvE,MAAM,EAAE,CAAC,KAAwB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;aAC3G;YACH,CAAC,CAAC,OAAO,CAAA;IAEf,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC5F,CAAC,CAAA;AAED,oGAAoG;AACpG,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;AAEnD;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,QAAkB,EAAY,EAAE,CAAC,CAAC;IACvD,GAAG,QAAQ;IACX,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAC5E,CAAC,CAAA;AAEF,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,GAAY,EAAW,EAAE;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAC1G,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;IACxE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QACrG,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACxG,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,OAAO,GAAG,CAAC,QAAkB,EAAY,EAAE,CAAC,CAAC;IACjD,GAAG,QAAQ;IACX,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;CACf,CAAC,CAAA"}

package/dist/parity/audit.d.ts

@@ -0,0 +1,54 @@
+import { type CommandsJson, type Manifest } from "./manifest.js";
+/** What the audit reads from one CLI's checkout and build. Gathered by `scripts/parity-audit.ts`. */
+export interface CliSide {
+    commit: string;
+    /** The `@wirecat/*` packages it pins, by name. */
+    pins: Record<string, string>;
+    program: CommandsJson;
+    /** `tools/list` of its MCP server with every `--allow-*`, prefix kept. */
+    tools: string[];
+    /** `README.md` and `docs/*.md`, by path from the checkout, with their text. */
+    pages: Record<string, string>;
+    scripts: string[];
+    skills: string[];
+    /** Its CI workflows, with each `pnpm <script>` they run followed by that script's command. */
+    ci: string;
+}
+export interface AuditInput {
+    shared: {
+        commit: string;
+        version: string;
+    };
+    manifest: Manifest;
+    /** STANDARD.md, whose Documents rule names the pages one tool has alone. */
+    standard: string;
+    /** Each CLI of the manifest that was measured, by name. */
+    sides: Record<string, CliSide>;
+}
+export interface Split {
+    /** In every list. */
+    all: string[];
+    /** In some lists and not others, with the names of the lists that have it. */
+    some: [string, string[]][];
+}
+export declare const split: (lists: Record<string, Iterable<string>>) => Split;
+/** `##` and `###` headings outside code blocks — the same in both languages, unlike the number of lines. */
+export declare const headingCount: (text?: string) => number;
+export declare const pageSplit: (input: AuditInput) => {
+    /** In every list. */
+    all: string[];
+    /** In some lists and not others, with the names of the lists that have it. */
+    some: [string, string[]][];
+    explained: (name: string) => boolean;
+};
+export declare const readmeSections: (readme?: string) => string[];
+export declare const toolNames: (side: CliSide, cli: string) => string[];
+/** The `--allow-*` options of `mcp`; opt-in configuration may expose additional tools. */
+export declare const allowFlags: (program: CommandsJson) => string[];
+export declare const ciRuns: (side: CliSide) => {
+    parity: boolean;
+    pages: boolean;
+};
+/** The measured half of a parity audit, as Markdown: everything a script can say without judging. */
+export declare const renderAudit: (input: AuditInput) => string;
+//# sourceMappingURL=audit.d.ts.map

package/dist/parity/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/parity/audit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAY,KAAK,QAAQ,EAAkB,MAAM,eAAe,CAAA;AAI1F,qGAAqG;AACrG,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,OAAO,EAAE,YAAY,CAAA;IACrB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,8FAA8F;IAC9F,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,QAAQ,EAAE,QAAQ,CAAA;IAClB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,KAAK;IACpB,qBAAqB;IACrB,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,8EAA8E;IAC9E,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAA;CAC3B;AAED,eAAO,MAAM,KAAK,UAAW,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAG,KAU/D,CAAA;AAeD,4GAA4G;AAC5G,eAAO,MAAM,YAAY,2BAQxB,CAAA;AAID,eAAO,MAAM,SAAS,UAAW,UAAU;IA5CzC,qBAAqB;SAChB,MAAM,EAAE;IACb,8EAA8E;UACxE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE;sBA4CD,MAAM;CAEhC,CAAA;AAED,eAAO,MAAM,cAAc,+BAAsF,CAAA;AAEjH,eAAO,MAAM,SAAS,SAAU,OAAO,OAAO,MAAM,aAA0D,CAAA;AAE9G,0FAA0F;AAC1F,eAAO,MAAM,UAAU,YAAa,YAAY,KAAG,MAAM,EAGxD,CAAA;AAED,eAAO,MAAM,MAAM,SAAU,OAAO;IAClC,MAAM;IACN,KAAK;CACL,CAAA;AAkBF,qGAAqG;AACrG,eAAO,MAAM,WAAW,UAAW,UAAU,KAAG,MAoG/C,CAAA"}

package/dist/parity/audit.js

@@ -0,0 +1,127 @@
+import { longName, parityProblems } from "./manifest.js";
+import { pageProblems } from "./pages.js";
+import { wordingProblems } from "./wording.js";
+export const split = (lists) => {
+    const sets = Object.entries(lists).map(([cli, names]) => [cli, new Set(names)]);
+    const names = [...new Set(sets.flatMap(([, set]) => [...set]))].sort();
+    const having = (name) => sets.filter(([, set]) => set.has(name)).map(([cli]) => cli);
+    return {
+        all: names.filter((name) => having(name).length === sets.length),
+        some: names
+            .map((name) => [name, having(name)])
+            .filter(([, clis]) => clis.length < sets.length),
+    };
+};
+/** The pages that answer a user's question: the generated command list and the docs index are not counted. */
+const NOT_PAGES = new Set(["docs/commands.md", "docs/README.md"]);
+const userPages = (side) => Object.keys(side.pages)
+    .filter((path) => path.startsWith("docs/") && !NOT_PAGES.has(path))
+    .map((path) => path.slice("docs/".length));
+const lineCount = (text = "") => text.split("\n").length - 1;
+const apart = (counts) => {
+    const [low, high] = [Math.min(...counts), Math.max(...counts)];
+    return high - low > 2 && low < high * 0.75;
+};
+/** `##` and `###` headings outside code blocks — the same in both languages, unlike the number of lines. */
+export const headingCount = (text = "") => {
+    let fenced = false;
+    let count = 0;
+    for (const line of text.split("\n")) {
+        if (line.startsWith("```"))
+            fenced = !fenced;
+        else if (!fenced && /^#{2,3} /.test(line))
+            count++;
+    }
+    return count;
+};
+const documentsRule = (standard) => standard.split(/^## Documents$/m)[1]?.split(/^## /m)[0] ?? "";
+export const pageSplit = (input) => {
+    const pages = split(Object.fromEntries(Object.entries(input.sides).map(([cli, side]) => [cli, userPages(side)])));
+    const rule = documentsRule(input.standard);
+    const explained = (name) => rule.includes(`\`${name}\``);
+    return { ...pages, explained };
+};
+export const readmeSections = (readme = "") => [...readme.matchAll(/^## (.+)$/gm)].map((match) => match[1] ?? "");
+export const toolNames = (side, cli) => side.tools.map((name) => name.replace(`${cli}_`, ""));
+/** The `--allow-*` options of `mcp`; opt-in configuration may expose additional tools. */
+export const allowFlags = (program) => {
+    const mcp = program.commands.find((command) => command.path.join(" ") === "mcp");
+    return (mcp?.options ?? []).map((option) => longName(option.flags)).filter((name) => name.startsWith("--allow-"));
+};
+export const ciRuns = (side) => ({
+    parity: /cli-(?:core|messaging)-parity/.test(side.ci),
+    pages: /cli-(?:core|messaging)-parity \S+ --pages/.test(side.ci),
+});
+const mark = (ok) => (ok ? "✅" : "🔴");
+const code = (names) => (names.length === 0 ? "none" : names.map((name) => `\`${name}\``).join(", "));
+/** A table of the names some CLIs have and others lack: one column per CLI. */
+const table = (clis, some) => some.length === 0
+    ? []
+    : [
+        "",
+        `| | ${clis.join(" | ")} |`,
+        `|---|${clis.map(() => "---").join("|")}|`,
+        ...some.map(([name, having]) => `| \`${name}\` | ${clis.map((cli) => (having.includes(cli) ? "✅" : "—")).join(" | ")} |`),
+    ];
+/** The measured half of a parity audit, as Markdown: everything a script can say without judging. */
+export const renderAudit = (input) => {
+    const { manifest, sides } = input;
+    const clis = Object.keys(sides);
+    const each = (read) => clis.map((cli) => read(sides[cli], cli));
+    const out = [];
+    const section = (title) => out.push("", `### ${title}`, "");
+    out.push(`## Measured from the ${clis.length} CLIs`, "", `cli-core \`${input.shared.commit}\` (${input.shared.version}) · ` +
+        each((side, cli) => `${cli}-cli \`${side.commit}\``).join(" · ") +
+        ". Statuses: ✅ agrees · 🔴 differs · ⚪ one-sided with a stated reason.");
+    section("The checks CI runs");
+    for (const cli of clis) {
+        const problems = parityProblems(manifest, cli, sides[cli].program);
+        out.push(`- ${mark(problems.length === 0)} **${cli} against this manifest** — ${problems.length} difference(s) ${code(problems)}`);
+    }
+    const wording = wordingProblems(manifest, each((side) => side.program));
+    out.push(`- ${mark(wording.length === 0)} **Help sentences of shared options** — ${wording.length} differ ${code(wording)}`);
+    for (const cli of clis) {
+        const side = sides[cli];
+        const pages = Object.entries(side.pages).flatMap(([name, text]) => pageProblems(text, cli, manifest, side.program).map((found) => `${name}: ${found}`));
+        out.push(`- ${mark(pages.length === 0)} **${cli}'s pages name only real options** — ${code(pages)}`);
+    }
+    for (const cli of clis) {
+        const runs = ciRuns(sides[cli]);
+        out.push(`- ${mark(runs.parity)} **${cli}'s CI runs the parity check**`, `- ${mark(runs.pages)} **${cli}'s CI runs the page check** (STANDARD, Documents rule 4)`);
+    }
+    section("Shared package pinned");
+    for (const name of ["@wirecat/cli-core", "@wirecat/cli-base"]) {
+        const latest = name === "@wirecat/cli-core" ? input.shared.version : undefined;
+        const pins = each((side) => side.pins[name]);
+        const same = pins.every((pin) => pin === pins[0]) && (latest === undefined || pins[0] === latest);
+        out.push(`- ${mark(same)} **${name}** — ` +
+            clis.map((cli, index) => `${cli} ${pins[index] ?? "none"}`).join(", ") +
+            (latest ? `, main ${latest}` : ""));
+    }
+    section("MCP tools");
+    const tools = split(Object.fromEntries(clis.map((cli) => [cli, toolNames(sides[cli], cli)])));
+    out.push(`- **In every CLI** (${tools.all.length}) — ${code(tools.all)}`, ...table(clis, tools.some));
+    section("User pages");
+    const pages = pageSplit(input);
+    for (const name of pages.all) {
+        const texts = each((side) => side.pages[`docs/${name}`]);
+        const headings = texts.map((text) => headingCount(text));
+        out.push(`- ${mark(!apart(headings))} \`${name}\` — ` +
+            clis.map((cli, index) => `${cli} ${headings[index]}`).join(", ") +
+            ` headings (${texts.map((text) => lineCount(text)).join(", ")} lines)`);
+    }
+    for (const [name, having] of pages.some)
+        out.push(`- ${pages.explained(name) ? "⚪" : "🔴"} \`${name}\` — only in ${having.join(", ")}; ` +
+            (pages.explained(name) ? "STANDARD says why" : "STANDARD gives no reason"));
+    out.push("", "A page is 🔴 when one CLI's copy has over a quarter, and more than two, fewer `##` and `###` headings than another's. Lines are not compared: Russian runs longer than English.");
+    section("README sections");
+    const sections = each((side) => readmeSections(side.pages["README.md"]));
+    out.push(`- ${mark(sections.every((one) => one.length === sections[0]?.length))} ` +
+        clis.map((cli, index) => `${cli} ${sections[index]?.length}`).join(", "), ...clis.map((cli, index) => `- **${cli}:** ${sections[index]?.join(" · ")}`));
+    section("Release and QA tooling");
+    const scripts = split(Object.fromEntries(clis.map((cli) => [cli, sides[cli].scripts])));
+    const skills = split(Object.fromEntries(clis.map((cli) => [cli, sides[cli].skills])));
+    out.push(`- **pnpm scripts not in every CLI** (${scripts.some.length})`, ...table(clis, scripts.some), "", `- **Skills in every CLI** — ${code(skills.all)}`, ...table(clis, skills.some));
+    return out.join("\n");
+};
+//# sourceMappingURL=audit.js.map