@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/cli/messenger/serve-stems.js

@@ -0,0 +1,46 @@
+import { failureKey } from "../failures.js";
+export const STEMS_EVERY_MS = 30_000;
+export const STEMS_SLICE_MS = 2_000;
+/**
+ * `serve`'s fill of stems still building — after an upgrade changed the default stemmers, a large store
+ * would otherwise wait for a search or `store migrate`. A short slice per interval, so the store stays free
+ * for everything else; it ends when the stems are ready, and never touches stems waiting for a reindex.
+ */
+export const stemFills = ({ withStore, warn, everyMs = STEMS_EVERY_MS, sliceMs = STEMS_SLICE_MS, }) => {
+    let timer;
+    let slice = Promise.resolve();
+    let stopped = false;
+    let stemmed = 0;
+    const fillOnce = () => withStore(async (store) => {
+        const state = await store.stemsState();
+        if (!state || state.ready || state.cause !== "building")
+            return false;
+        const stop = Date.now() + sliceMs;
+        stemmed += (await store.fillStems({ until: () => stopped || Date.now() >= stop })).stemmed;
+        return !(await store.stemsState())?.ready;
+    });
+    const tick = () => {
+        slice = fillOnce()
+            .catch((error) => {
+            warn(`the stems were not filled: ${failureKey(error)}`);
+            return true;
+        })
+            .then((more) => {
+            if (more && !stopped)
+                timer = setTimeout(tick, everyMs);
+        });
+    };
+    return {
+        start: () => {
+            if (timer === undefined && !stopped)
+                timer = setTimeout(tick, 0);
+        },
+        stop: async () => {
+            stopped = true;
+            clearTimeout(timer);
+            await slice;
+        },
+        summary: () => ({ stemmed }),
+    };
+};
+//# sourceMappingURL=serve-stems.js.map

package/dist/cli/messenger/serve-stems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-stems.js","sourceRoot":"","sources":["../../../src/cli/messenger/serve-stems.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAA;AAUnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EACxB,SAAS,EACT,IAAI,EACJ,OAAO,GAAG,cAAc,EACxB,OAAO,GAAG,cAAc,GAMzB,EAAa,EAAE;IACd,IAAI,KAAiC,CAAA;IACrC,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;IAC7B,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,MAAM,QAAQ,GAAG,GAAG,EAAE,CACpB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAA;QACtC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU;YAAE,OAAO,KAAK,CAAA;QACrE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;QACjC,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;QAC1F,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEJ,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,KAAK,GAAG,QAAQ,EAAE;aACf,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,IAAI,CAAC,8BAA8B,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACvD,OAAO,IAAI,CAAA;QACb,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,IAAI,IAAI,CAAC,OAAO;gBAAE,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACzD,CAAC,CAAC,CAAA;IACN,CAAC,CAAA;IAED,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO;gBAAE,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAClE,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,KAAK,CAAA;QACb,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC7B,CAAA;AACH,CAAC,CAAA"}

package/dist/cli/messenger/server-command.d.ts

@@ -0,0 +1,43 @@
+import { Command } from "commander";
+import { type ServerSystem } from "../../background/system.js";
+import { type Unit } from "../../background/units.js";
+import { type Messenger, type MessengerContext } from "./context.js";
+export type { Ran, ServerSystem } from "../../background/system.js";
+export declare const followUpsPrompt: (command: string) => string;
+/** A running server, as its CLI can tell. */
+export interface Running {
+    pid: number;
+    startedAt: string;
+    connected: boolean;
+    connectedAt?: string;
+    version?: string;
+    /** The server says a command that needed it started it (max); `start` takes its place. */
+    byCommand?: boolean;
+}
+/** How a CLI finds, starts and stops its server. Without one, `server` uses tg's: the lock file and a signal. */
+export interface ServerProcess {
+    probe: () => Promise<Running | undefined>;
+    /** Starts `serve` apart from this process with `args` and the variables in `env` added; its PID. Throws when it cannot start now. */
+    launch: (args: string[], env: Record<string, string>) => number;
+    /** Asks it to stop; `server` then waits for its PID to be gone. */
+    stop: (running: Running) => Promise<void>;
+}
+export interface ServerOptions {
+    process?: (context: MessengerContext, system: ServerSystem, logPath: string) => ServerProcess;
+    /** Where a server started without a unit writes its log. tg's: `<state>/serve/<profile>.log`. */
+    logPath?: (context: MessengerContext) => string;
+    /** The words after the CLI's own entry that run `serve` in the foreground — what a unit runs. */
+    serveArgv?: string[];
+    /** `start` and `restart` take `--idle <duration>` and hand it to `serve`. */
+    idle?: boolean;
+    unit?: Pick<Unit, "purpose" | "noRestartOn">;
+}
+/**
+ * `serve` in the background: `start`, `stop`, `restart`, `status`, `logs`. Without a unit, `start`
+ * runs `serve` as a process of its own; with one — `install`, a systemd user unit or a launchd
+ * agent — it goes through systemd or launchd. **Nothing starts until `start` is typed** (NEED-9):
+ * `install` only writes the file. What the server does stays each CLI's; `options.process` says how
+ * to find, start and stop it.
+ */
+export declare const serverCommand: (messenger: Messenger, options?: ServerOptions) => Command;
+//# sourceMappingURL=server-command.d.ts.map

package/dist/cli/messenger/server-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/server-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,4BAA4B,CAAA;AAC3E,OAAO,EAAqD,KAAK,IAAI,EAAE,MAAM,2BAA2B,CAAA;AAMxG,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAoB,MAAM,cAAc,CAAA;AAEtF,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEnE,eAAO,MAAM,eAAe,YAAa,MAAM,WACwE,CAAA;AAOvH,6CAA6C;AAC7C,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,iHAAiH;AACjH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IACzC,qIAAqI;IACrI,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;IAC/D,mEAAmE;IACnE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,KAAK,aAAa,CAAA;IAC7F,iGAAiG;IACjG,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,CAAA;IAC/C,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC,CAAA;CAC7C;AA+CD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,cAAe,SAAS,YAAW,aAAa,KAAQ,OAySjF,CAAA"}

package/dist/cli/messenger/server-command.js

@@ -0,0 +1,331 @@
+import { existsSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, EXIT_CODES, exitCodeFor, resolvePaths, writeSecurely } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { lockPath, readLock } from "../../background/lock.js";
+import { alive, carries } from "../../background/processes.js";
+import { thisMachine } from "../../background/system.js";
+import { locationVariables, platformFor, readableLog, tail } from "../../background/units.js";
+import { FloodMemory, floodPathFor } from "../../sends/flood.js";
+import { environmentOf } from "../context.js";
+import { listed } from "../paging.js";
+import { parseDuration } from "../settings.js";
+import { messengerContext } from "./context.js";
+export const followUpsPrompt = (command) => `Run the daily follow-up review: read \`${command} skill show follow-ups\` and follow it. Draft replies; never send.`;
+/** How many looks, a pause apart, `start` gives `serve` to connect — about 30 seconds on a real machine. */
+const LOOKS = 120;
+/** A person reads paths under their home as `~/…`. */
+const tilde = (path, env) => env.HOME && path.startsWith(`${env.HOME}/`) ? `~${path.slice(env.HOME.length)}` : path;
+/** Local time, and the date too when it is not today. */
+const clock = (iso) => {
+    const when = new Date(iso);
+    const time = when.toLocaleTimeString("en-GB", { hour: "2-digit", minute: "2-digit" });
+    return when.toDateString() === new Date().toDateString() ? time : `${when.toLocaleDateString("sv-SE")} ${time}`;
+};
+const lockProcess = (app, marker, serveArgv) => (context, system, logPath) => ({
+    probe: async () => {
+        const held = readLock(lockPath(app, context.profile, context.env));
+        if (!held || !alive(held.pid))
+            return undefined;
+        return {
+            pid: held.pid,
+            startedAt: held.startedAt,
+            connected: held.listeningAt !== undefined,
+            ...(held.listeningAt ? { connectedAt: held.listeningAt } : {}),
+            ...(held.version ? { version: held.version } : {}),
+        };
+    },
+    launch: (args, env) => {
+        // A shell's --timeout default would end a server meant to outlive the shell.
+        const { [`${app.envPrefix}_TIMEOUT`]: _timeout, ...inherited } = context.env;
+        return system.spawn([...serveArgv, ...args], { ...inherited, [`${app.envPrefix}_PROFILE`]: context.profile, ...env }, logPath);
+    },
+    stop: async ({ pid }) => {
+        if (!carries(pid, marker)) {
+            throw new CliError("validation_error", `serve for profile ${context.profile} (PID ${pid}) was not started by \`${app.command} server start\` — stop it where it runs`);
+        }
+        process.kill(pid, "SIGTERM");
+    },
+});
+/**
+ * `serve` in the background: `start`, `stop`, `restart`, `status`, `logs`. Without a unit, `start`
+ * runs `serve` as a process of its own; with one — `install`, a systemd user unit or a launchd
+ * agent — it goes through systemd or launchd. **Nothing starts until `start` is typed** (NEED-9):
+ * `install` only writes the file. What the server does stays each CLI's; `options.process` says how
+ * to find, start and stop it.
+ */
+export const serverCommand = (messenger, options = {}) => {
+    const { app } = messenger;
+    const command = new Command("server").description(`\`${app.command} serve\` in the background: start, stop, restart, status, logs; install adds a systemd or launchd unit`);
+    const marker = (profile) => `${app.envPrefix}_SERVER=${profile}`;
+    const serveArgv = options.serveArgv ?? ["serve"];
+    const prepare = (self) => {
+        const context = messengerContext(self, messenger);
+        const system = environmentOf(self).system ?? thisMachine();
+        const platform = platformFor(app, system, context.env);
+        const state = resolvePaths({ appName: app.appName, prefix: app.envPrefix, env: context.env }).state;
+        const logPath = options.logPath?.(context) ?? join(state, "serve", `${context.profile}.log`);
+        const unit = platform.unit({
+            profile: context.profile,
+            command: [...system.entry, ...serveArgv],
+            environment: { [`${app.envPrefix}_PROFILE`]: context.profile, ...locationVariables(app, context.env) },
+            logPath,
+            ...options.unit,
+        });
+        const server = (options.process ?? lockProcess(app, marker(context.profile), serveArgv))(context, system, logPath);
+        const each = async (argvs) => {
+            for (const argv of argvs) {
+                const ran = await system.run(argv, context.env);
+                if (ran.code !== 0)
+                    throw new CliError("configuration_error", `${argv.join(" ")} failed: ${ran.stderr.trim()}`);
+            }
+        };
+        const say = (value, lines) => {
+            if (context.format === "pretty")
+                context.streams.data(lines.join("\n"));
+            else
+                context.renderer.result(value);
+        };
+        return { context, system, platform, unit, server, each, say };
+    };
+    const installed = (unit) => {
+        if (!existsSync(unit.path)) {
+            throw new CliError("not_found", `no unit for profile ${unit.profile} — \`${app.command} server install\` writes it`);
+        }
+    };
+    const byOf = async ({ platform, unit }, running) => {
+        if (existsSync(unit.path) && (await platform.state(unit)).pid === running.pid)
+            return "unit";
+        if (running.byCommand)
+            return "command";
+        return carries(running.pid, marker(unit.profile)) ? "server" : "hand";
+    };
+    const how = (by, unit) => by === "unit"
+        ? `under ${unit.path.endsWith(".plist") ? "launchd" : "systemd"} (${unit.name})`
+        : by === "server"
+            ? `started by \`${app.command} server start\``
+            : by === "command"
+                ? `started by a ${app.command} command that needed it — it stops once unused`
+                : `started by hand — \`${app.command} server stop\` leaves it alone`;
+    const start = async (prepared, args) => {
+        const { system, platform, unit, server, each, say } = prepared;
+        const before = await server.probe();
+        if (before && !before.byCommand) {
+            say({ profile: unit.profile, started: false, running: true, pid: before.pid, startedAt: before.startedAt }, [
+                `Already serving profile ${unit.profile} since ${clock(before.startedAt)} (PID ${before.pid}).`,
+            ]);
+            return;
+        }
+        let by;
+        let spawned;
+        if (existsSync(unit.path)) {
+            await each(platform.start(unit));
+            by = "unit";
+        }
+        else {
+            const [name = "", value = ""] = marker(unit.profile).split("=");
+            spawned = server.launch(args, { [name]: value });
+            by = "server";
+        }
+        for (let look = 0; look < LOOKS; look++) {
+            const now = await server.probe();
+            // A server a command started answers until the new one takes its place.
+            if (now?.connected && now.pid !== before?.pid) {
+                say({
+                    profile: unit.profile,
+                    started: true,
+                    by,
+                    pid: now.pid,
+                    startedAt: now.startedAt,
+                    ...(now.connectedAt ? { connectedAt: now.connectedAt } : {}),
+                    log: unit.logPath,
+                }, [
+                    `Started: serving profile ${unit.profile} (PID ${now.pid}), connected${now.connectedAt ? ` since ${clock(now.connectedAt)}` : ""}, ${how(by, unit)}.`,
+                    `Its log: ${app.command} server logs`,
+                ]);
+                return;
+            }
+            const gone = spawned !== undefined ? !alive(spawned) : look > 8 && !(await platform.state(unit)).active;
+            if (gone) {
+                const last = readableLog(by === "unit" ? await platform.logs(unit, 5) : tail(unit.logPath, 5)).trim();
+                throw new CliError("provider_unavailable", `serve stopped before it was connected${last ? `:\n${last}` : ""}`);
+            }
+            await system.pause();
+        }
+        throw new CliError("timeout", `serve is running but not connected yet — \`${app.command} server status\`, \`${app.command} server logs\``);
+    };
+    const stop = async (prepared) => {
+        const { platform, unit, server, each, say, system } = prepared;
+        if (existsSync(unit.path) && (await platform.state(unit)).active) {
+            await each(platform.stop(unit));
+            say({ profile: unit.profile, stopped: true, by: "unit" }, [`Stopped ${unit.name}.`]);
+            return;
+        }
+        const running = await server.probe();
+        if (!running) {
+            say({ profile: unit.profile, stopped: false }, [`Nothing to stop: profile ${unit.profile} is not being served.`]);
+            return;
+        }
+        const by = await byOf(prepared, running);
+        await server.stop(running);
+        for (let look = 0; look < LOOKS && alive(running.pid); look++)
+            await system.pause();
+        say({ profile: unit.profile, stopped: true, by, pid: running.pid }, [
+            `Stopped serving profile ${unit.profile} (PID ${running.pid}).`,
+        ]);
+    };
+    const idleArgs = (self) => {
+        const { idle } = self.opts();
+        if (idle === undefined)
+            return [];
+        parseDuration(idle, "--idle");
+        return ["--idle", idle];
+    };
+    const withIdle = (sub) => options.idle ? sub.option("--idle <duration>", "stop after this long with nobody using it — 15m, 1h") : sub;
+    withIdle(command
+        .command("start")
+        .description("start serve in the background — through the unit if one is installed — and answer once it connects")).action(async function () {
+        await start(prepare(this), idleArgs(this));
+    });
+    command
+        .command("stop")
+        .description("stop this profile's serve — through the unit if it runs under one")
+        .action(async function () {
+        await stop(prepare(this));
+    });
+    withIdle(command.command("restart").description("stop it and start it again")).action(async function () {
+        const args = idleArgs(this);
+        const prepared = prepare(this);
+        await stop({ ...prepared, say: () => { } });
+        await start(prepared, args);
+    });
+    command
+        .command("status")
+        .description("whether serve runs for this profile, since when, who started it, and the unit if there is one")
+        .action(async function () {
+        const prepared = prepare(this);
+        const { context, platform, unit, server, say } = prepared;
+        const isInstalled = existsSync(unit.path);
+        const state = isInstalled ? await platform.state(unit) : { loaded: false, active: false };
+        const held = await server.probe();
+        const by = held ? await byOf(prepared, held) : null;
+        const left = held ? undefined : readLock(lockPath(app, unit.profile, context.env));
+        // An update leaves a running serve on the old code.
+        const outdated = held?.version && held.version !== app.version
+            ? `It runs ${app.command} ${held.version}, and ${app.command} is now ${app.version} — \`${app.command} server restart\`.`
+            : undefined;
+        if (outdated && context.format !== "pretty")
+            context.renderer.note(outdated);
+        const gaveUp = !held && !state.active && state.exitCode !== undefined && unit.noRestartOn?.includes(state.exitCode)
+            ? state.exitCode
+            : undefined;
+        const gaveUpReason = gaveUp === undefined ? undefined : Object.entries(EXIT_CODES).find(([, code]) => code === gaveUp)?.[0];
+        const flood = new FloodMemory(floodPathFor(app, unit.profile, context.env)).read();
+        const unitLine = isInstalled
+            ? `Unit: ${tilde(unit.path, context.env)} — ${state.detail ?? (state.active ? "active" : "inactive")}.`
+            : `No unit installed — \`${app.command} server install\` adds one, for starting under systemd or launchd.`;
+        say({
+            profile: unit.profile,
+            running: held !== undefined,
+            ...(held
+                ? {
+                    pid: held.pid,
+                    startedAt: held.startedAt,
+                    connected: held.connected,
+                    ...(held.connectedAt ? { connectedAt: held.connectedAt } : {}),
+                    by,
+                }
+                : {}),
+            ...(held?.version ? { version: held.version } : {}),
+            cliVersion: app.version,
+            log: isInstalled && unit.path.endsWith(".service") ? `journalctl --user -u ${unit.name}` : unit.logPath,
+            ...(left ? { stale: { pid: left.pid, startedAt: left.startedAt } } : {}),
+            ...(gaveUp !== undefined
+                ? { stopped: { exitCode: gaveUp, reason: gaveUpReason ?? null, restarts: false } }
+                : {}),
+            unit: { name: unit.name, path: unit.path, installed: isInstalled, ...state },
+            flood: { deadlines: flood.deadlines, sendBlock: flood.sendBlock ?? null },
+        }, [
+            held
+                ? held.connected
+                    ? `Serving profile ${unit.profile} since ${clock(held.startedAt)} (PID ${held.pid}), connected${held.connectedAt ? ` since ${clock(held.connectedAt)}` : ""}, ${how(by ?? "hand", unit)}.`
+                    : `Starting profile ${unit.profile} since ${clock(held.startedAt)} (PID ${held.pid}) — not connected yet, ${how(by ?? "hand", unit)}.`
+                : `Not serving profile ${unit.profile}.${isInstalled && gaveUp === undefined && state.detail?.startsWith("failed") ? ` The unit failed — \`${app.command} server logs\`.` : ""}`,
+            ...(gaveUp === exitCodeFor("authentication_error")
+                ? [
+                    `It stopped because the login is no longer valid, and it will not restart by itself — \`${app.command} session start\`, then \`${app.command} server start\`.`,
+                ]
+                : gaveUp !== undefined
+                    ? [
+                        `It stopped with ${gaveUpReason ?? `exit code ${gaveUp}`}, which a restart would not fix, so it will not restart by itself — \`${app.command} server logs\`, then \`${app.command} server start\`.`,
+                    ]
+                    : []),
+            ...(left
+                ? [
+                    `A serve that started ${clock(left.startedAt)} (PID ${left.pid}) is gone and left its lock — the next start takes it over.`,
+                ]
+                : []),
+            unitLine,
+            ...(flood.sendBlock
+                ? [`Writes are held until ${clock(flood.sendBlock.until)}: ${flood.sendBlock.hint}.`]
+                : []),
+            ...flood.deadlines.map((one) => `Asked to wait before ${one.operation}${one.chatId ? ` in chat ${one.chatId}` : ""} until ${clock(one.until)}.`),
+            ...(outdated ? [outdated] : []),
+        ]);
+    });
+    command
+        .command("logs")
+        .description("serve's latest log lines — from the journal under systemd, else its log file")
+        .option("-n, --lines <n>", "how many lines", (value) => wholeNumber(value), 50)
+        .action(async function () {
+        const { lines } = this.opts();
+        const { context, platform, unit } = prepare(this);
+        const text = existsSync(unit.path) ? await platform.logs(unit, lines) : tail(unit.logPath, lines);
+        if (!text)
+            context.renderer.note(`no log yet for profile ${unit.profile}`);
+        if (context.format === "pretty") {
+            if (text)
+                context.streams.data(readableLog(text.replace(/\n$/, "")));
+        }
+        else
+            context.renderer.result({ ...listed(text.split("\n").filter(Boolean)), profile: unit.profile, unit: unit.name });
+    });
+    command
+        .command("install")
+        .description("write a systemd user unit or a launchd agent for this profile; starts nothing")
+        .action(function () {
+        const { context, platform, unit, say } = prepare(this);
+        const replaced = existsSync(unit.path);
+        writeSecurely(unit.path, platform.text(unit, app), 0o644);
+        platform.prepare?.(unit);
+        say({ profile: unit.profile, unit: unit.name, path: unit.path, command: unit.command, replaced }, [
+            `${replaced ? "Rewrote" : "Wrote"} ${tilde(unit.path, context.env)} — nothing started.`,
+            `It runs: ${unit.command.map((word) => tilde(word, context.env)).join(" ")}`,
+            `Start it now: ${app.command} server start · ${platform.atLogin(unit)}`,
+            // Suggested, never turned on: an agent reading chats every morning is the owner's choice (NEED-161).
+            `A daily follow-up review is off. To turn it on: ${app.command} schedule agent follow-ups claude "${followUpsPrompt(app.command)}" --at 08:30`,
+        ]);
+    });
+    command
+        .command("uninstall")
+        .description("remove this profile's unit; stop it first")
+        .action(async function () {
+        const { context, platform, unit, say } = prepare(this);
+        installed(unit);
+        if ((await platform.state(unit)).active) {
+            throw new CliError("validation_error", `the unit is running — \`${app.command} server stop\` first`);
+        }
+        rmSync(unit.path, { force: true });
+        say({ profile: unit.profile, unit: unit.name, path: unit.path, removed: true }, [
+            `Removed ${tilde(unit.path, context.env)}.`,
+        ]);
+    });
+    return command;
+};
+const wholeNumber = (value) => {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1)
+        throw new CliError("validation_error", `"${value}" is not a count`);
+    return parsed;
+};
+//# sourceMappingURL=server-command.js.map

package/dist/cli/messenger/server-command.js.map

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

package/dist/cli/messenger/stats-command.d.ts

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+import { chartRenderer } from "../../charts/render.js";
+import { type Messenger } from "./context.js";
+export declare const statsCommand: (messenger: Messenger, loadRenderer?: typeof chartRenderer) => Command;
+//# sourceMappingURL=stats-command.d.ts.map

package/dist/cli/messenger/stats-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/stats-command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAKtD,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAQ/D,eAAO,MAAM,YAAY,cAAe,SAAS,0CAAiC,OA2FjF,CAAA"}

package/dist/cli/messenger/stats-command.js

@@ -0,0 +1,90 @@
+import { writeFileSync } from "node:fs";
+import { extname, resolve } from "node:path";
+import { CliError } from "@wirecat/cli-base";
+import { timezoneOf } from "@wirecat/cli-base/query";
+import { Command } from "commander";
+import { chartKindOf, chartPeriodOf, chatChart } from "../../charts/chat.js";
+import { CHART_SIZE } from "../../charts/model.js";
+import { chartPng } from "../../charts/png.js";
+import { chartRenderer } from "../../charts/render.js";
+import { EVENTS_DAYS } from "../../services/chats.js";
+import { momentOf } from "../../services/moment.js";
+import { adminStatisticsCommand } from "./admin-statistics-command.js";
+import { statsCommand as chatStatsCommand } from "./chats-stats-command.js";
+import { messengerContext } from "./context.js";
+import { countersCommand } from "./counters-command.js";
+import { messagesStatsCommand } from "./messages-stats-command.js";
+import { officialStatsCommand } from "./official-stats-command.js";
+import { rankingEvidenceCommand, rankingsTopCommand } from "./rankings-command.js";
+import { retentionCommand } from "./retention-command.js";
+import { tasksStatsCommand } from "./tasks-command.js";
+export const statsCommand = (messenger, loadRenderer = chartRenderer) => {
+    const stats = new Command("stats").description("statistics about messages, chats and their authors");
+    stats.addCommand(new Command("messages")
+        .description("message statistics from the local store")
+        .addCommand(messagesStatsCommand(messenger))
+        .addCommand(countersCommand(messenger))
+        .addCommand(adminStatisticsCommand(messenger, "unanswered"))
+        .addCommand(adminStatisticsCommand(messenger, "discussion"))
+        .addCommand(rankingsTopCommand(messenger, "messages"))
+        .addCommand(rankingEvidenceCommand(messenger, "messages")));
+    stats.addCommand(new Command("contacts")
+        .description("statistics about human authors")
+        .addCommand(adminStatisticsCommand(messenger, "responses"))
+        .addCommand(rankingsTopCommand(messenger, "contacts"))
+        .addCommand(rankingEvidenceCommand(messenger, "contacts")));
+    const chats = new Command("chats").description("statistics about one chat").addCommand(chatStatsCommand(messenger));
+    chats.addCommand(adminStatisticsCommand(messenger, "newcomers"));
+    chats.addCommand(retentionCommand(messenger));
+    if (messenger.officialStats === true)
+        chats.addCommand(officialStatsCommand(messenger));
+    stats.addCommand(chats);
+    stats.addCommand(new Command("tasks").description("task statistics").addCommand(tasksStatsCommand(messenger)));
+    stats
+        .command("charts")
+        .description("a chart's data from a chat's statistics, and optionally a dark SVG or PNG image")
+        .argument("<chat>", messenger.chatArgument)
+        .option("--chart-kind <messages|active|membership>", "what to draw: messages, active authors, or joins and leaves", chartKindOf, "messages")
+        .option("--by <day|week>", "one point per calendar day or week (weeks start on Monday)", chartPeriodOf, "day")
+        .option("--since-time <time>", `ISO 8601, or 2h / 1d ago; ${EVENTS_DAYS} days ago if not given`)
+        .option("--timezone <zone>", "the IANA timezone for calendar days")
+        .option("--output <file>", "write a dark image to a new .svg or .png file")
+        .action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        const { chartKind, by, sinceTime, timezone: given, output, } = this.opts();
+        if (context.format === "jsonl")
+            throw new CliError("validation_error", "charts return one JSON object — use --json, not --jsonl");
+        const extension = output === undefined ? undefined : extname(output).toLowerCase();
+        if (output !== undefined && extension !== ".svg" && extension !== ".png") {
+            throw new CliError("validation_error", "--output takes a .svg or .png file; image output to stdout is unavailable");
+        }
+        const timezone = timezoneOf(given);
+        const found = await context.withServices((services) => services.chats.stats(chat, {
+            by,
+            timezone,
+            ...(sinceTime === undefined ? {} : { since: momentOf(sinceTime, "--since-time") }),
+        }));
+        const chart = chatChart(found, { kind: chartKind, by, timezone });
+        let chartFile;
+        if (output !== undefined) {
+            const svg = await (await loadRenderer()).render(chart, CHART_SIZE);
+            const rendered = extension === ".png" ? await chartPng(svg) : svg;
+            const path = resolve(output);
+            try {
+                writeFileSync(path, rendered.bytes, { flag: "wx", mode: 0o600 });
+            }
+            catch (error) {
+                if (error.code === "EEXIST")
+                    throw new CliError("validation_error", `${path} exists — a chart never overwrites a file`);
+                throw error;
+            }
+            chartFile = { path, format: rendered.format, width: rendered.width, height: rendered.height };
+            context.renderer.note(`chart written to ${path}`);
+        }
+        if (chart.partial)
+            context.renderer.note("partial data — the chart shows lower bounds");
+        context.renderer.result({ chart, ...(chartFile === undefined ? {} : { chartFile }) });
+    });
+    return stats;
+};
+//# sourceMappingURL=stats-command.js.map

package/dist/cli/messenger/stats-command.js.map

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

package/dist/cli/messenger/stdin.d.ts

@@ -0,0 +1,5 @@
+/** All of stdin as text; nothing when it is a terminal, where nobody would press Ctrl-D. */
+export declare const readAll: (input: NodeJS.ReadableStream & {
+    isTTY?: boolean;
+}) => Promise<string>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/cli/messenger/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/stdin.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,eAAO,MAAM,OAAO,UAAiB,MAAM,CAAC,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,OAAO,CAAC,MAAM,CAGhG,CAAA"}

package/dist/cli/messenger/stdin.js

@@ -0,0 +1,8 @@
+import { bufferedInput } from "../input-policy.js";
+/** All of stdin as text; nothing when it is a terminal, where nobody would press Ctrl-D. */
+export const readAll = async (input) => {
+    if (input.isTTY)
+        return "";
+    return (await bufferedInput(input)).toString("utf8");
+};
+//# sourceMappingURL=stdin.js.map

package/dist/cli/messenger/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../../src/cli/messenger/stdin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,KAAkD,EAAmB,EAAE;IACnG,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IAC1B,OAAO,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AACtD,CAAC,CAAA"}

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -0,0 +1,22 @@
+import { Command } from "commander";
+import type { Messenger } from "./context.js";
+/** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
+export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
+    error?: undefined;
+    path: string;
+    exists: boolean;
+} | {
+    path: string;
+    exists: boolean;
+    schema: number;
+    speaks: number;
+    writable: boolean;
+    chats?: number | undefined;
+    messages?: number | undefined;
+} | {
+    path: string;
+    exists: boolean;
+    error: string;
+}>;
+export declare const storeMaintenanceCommands: (messenger: Messenger) => Command[];
+//# sourceMappingURL=store-maintenance-command.d.ts.map

package/dist/cli/messenger/store-maintenance-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-maintenance-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/store-maintenance-command.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA4BnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAyC7C,oGAAoG;AACpG,eAAO,MAAM,YAAY,QAAe,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;EAkBxD,CAAA;AAED,eAAO,MAAM,wBAAwB,cAAe,SAAS,KAAG,OAAO,EAWtE,CAAA"}