@made-by-moonlight/athene-cli 0.9.2

package/dist/commands/dashboard.js

@@ -0,0 +1,103 @@
+import { spawn } from "node:child_process";
+import { resolve } from "node:path";
+import chalk from "chalk";
+import { isWindows, loadConfig } from "@made-by-moonlight/athene-core";
+import { findWebDir, buildDashboardEnv, waitForPortAndOpen } from "../lib/web-dir.js";
+import { forwardSignalsToChild } from "../lib/shell.js";
+import { clearStaleCacheIfNeeded, isInstalledUnderNodeModules, rebuildDashboardProductionArtifacts, } from "../lib/dashboard-rebuild.js";
+import { preflight } from "../lib/preflight.js";
+import { DEFAULT_PORT } from "../lib/constants.js";
+import { dashboardUrl } from "../lib/dashboard-url.js";
+export function registerDashboard(program) {
+    program
+        .command("dashboard")
+        .description("Start the web dashboard")
+        .option("-p, --port <port>", "Port to listen on")
+        .option("--no-open", "Don't open browser automatically")
+        .option("--rebuild", "Clean stale build artifacts and rebuild before starting")
+        /* c8 ignore start -- process-spawning startup code, tested via integration/onboarding */
+        .action(async (opts) => {
+        const config = loadConfig();
+        const port = opts.port ? parseInt(opts.port, 10) : (config.port ?? DEFAULT_PORT);
+        if (isNaN(port) || port < 1 || port > 65535) {
+            console.error(chalk.red("Invalid port number. Must be 1-65535."));
+            process.exit(1);
+        }
+        const localWebDir = findWebDir(); // throws with install-specific guidance if not found
+        if (opts.rebuild) {
+            await rebuildDashboardProductionArtifacts(localWebDir, [port]);
+            // Fall through to start the dashboard on this port.
+        }
+        else {
+            await preflight.checkBuilt(localWebDir);
+            await clearStaleCacheIfNeeded(localWebDir);
+        }
+        const webDir = localWebDir;
+        console.log(chalk.bold(`Starting dashboard on ${dashboardUrl(port)}\n`));
+        const env = await buildDashboardEnv(port, config.configPath, config.terminalPort, config.directTerminalPort);
+        const startScript = resolve(webDir, "dist-server", "start-all.js");
+        const child = spawn("node", [startScript], {
+            cwd: webDir,
+            stdio: ["inherit", "inherit", "pipe"],
+            detached: !isWindows(),
+            env,
+        });
+        const stderrChunks = [];
+        const MAX_STDERR_CHUNKS = 100;
+        child.stderr?.on("data", (data) => {
+            const text = data.toString();
+            if (stderrChunks.length < MAX_STDERR_CHUNKS) {
+                stderrChunks.push(text);
+            }
+            // Still show stderr to the user
+            process.stderr.write(data);
+        });
+        child.on("error", (err) => {
+            console.error(chalk.red("Could not start dashboard. Ensure Next.js is installed."));
+            console.error(chalk.dim(String(err)));
+            process.exit(1);
+        });
+        // On Unix the child is spawned with detached:true (own process group) so
+        // Ctrl+C only reaches the parent's process group, not the dashboard's.
+        // Forward SIGINT/SIGTERM so the child group is cleaned up on exit.
+        const pid = child.pid;
+        if (!isWindows() && pid) {
+            forwardSignalsToChild(pid, child);
+        }
+        let openAbort;
+        if (opts.open !== false) {
+            openAbort = new AbortController();
+            void waitForPortAndOpen(port, dashboardUrl(port), openAbort.signal);
+        }
+        child.on("exit", (code) => {
+            if (openAbort)
+                openAbort.abort();
+            if (code !== 0 && code !== null && !opts.rebuild) {
+                const stderr = stderrChunks.join("");
+                if (looksLikeStaleBuild(stderr)) {
+                    const recoveryCommand = isInstalledUnderNodeModules(webDir)
+                        ? "npm install -g @made-by-moonlight/athene@latest"
+                        : "athene dashboard --rebuild";
+                    console.error(chalk.yellow("\nThis looks like a stale build cache issue. Try:\n\n" +
+                        `  ${chalk.cyan(recoveryCommand)}\n`));
+                }
+            }
+            process.exit(code ?? 0);
+        });
+        /* c8 ignore stop */
+    });
+}
+/**
+ * Check if stderr output suggests stale build artifacts.
+ */
+function looksLikeStaleBuild(stderr) {
+    const patterns = [
+        /Cannot find module.*vendor-chunks/,
+        /Cannot find module.*\.next/,
+        /Module not found.*\.next/,
+        /ENOENT.*\.next/,
+        /Could not find a production build/,
+    ];
+    return patterns.some((p) => p.test(stderr));
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/commands/dashboard.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerDoctor(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmZzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0DrD"}

package/dist/commands/doctor.js

@@ -0,0 +1,329 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import chalk from "chalk";
+import { createPluginRegistry, findConfigFile, getObservabilityBaseDir, loadConfig, resolveNotifierTarget, } from "@made-by-moonlight/athene-core";
+import { runNotifyTest } from "../lib/notify-test.js";
+import { runRepoScript } from "../lib/script-runner.js";
+import { detectOpenClawInstallation, validateToken } from "../lib/openclaw-probe.js";
+import { importPluginModuleFromSource } from "../lib/plugin-store.js";
+import { detectInstallMethod, getCurrentVersion, getUpdateCommand, isVersionOutdated, readCachedUpdateInfo, } from "../lib/update-check.js";
+// ---------------------------------------------------------------------------
+// Helpers — match the PASS / WARN / FAIL style of athene-doctor.sh
+// ---------------------------------------------------------------------------
+function pass(msg) {
+    console.log(`${chalk.green("PASS")} ${msg}`);
+}
+function warn(msg) {
+    console.log(`${chalk.yellow("WARN")} ${msg}`);
+}
+/** Returns a fail() recorder and a count() getter — local per invocation, no shared state. */
+function makeFailCounter() {
+    let n = 0;
+    return {
+        fail(msg) {
+            n++;
+            console.log(`${chalk.red("FAIL")} ${msg}`);
+        },
+        count() {
+            return n;
+        },
+    };
+}
+async function loadPluginRegistry(config) {
+    const registry = createPluginRegistry();
+    await registry.loadFromConfig(config, importPluginModuleFromSource);
+    return registry;
+}
+function addPluginReference(refs, slot, pluginName, source) {
+    if (!pluginName)
+        return;
+    refs.push({ slot, pluginName, source });
+}
+function collectPluginReferences(config) {
+    const refs = [];
+    addPluginReference(refs, "runtime", config.defaults.runtime, "defaults.runtime");
+    addPluginReference(refs, "agent", config.defaults.agent, "defaults.agent");
+    addPluginReference(refs, "workspace", config.defaults.workspace, "defaults.workspace");
+    addPluginReference(refs, "agent", config.defaults.orchestrator?.agent, "defaults.orchestrator.agent");
+    addPluginReference(refs, "agent", config.defaults.worker?.agent, "defaults.worker.agent");
+    for (const notifierName of config.defaults.notifiers ?? []) {
+        const target = resolveNotifierTarget(config, notifierName);
+        addPluginReference(refs, "notifier", target.pluginName, `defaults.notifiers: ${target.reference} (plugin: ${target.pluginName})`);
+    }
+    for (const [priority, notifierNames] of Object.entries(config.notificationRouting ?? {})) {
+        for (const notifierName of notifierNames) {
+            const target = resolveNotifierTarget(config, notifierName);
+            addPluginReference(refs, "notifier", target.pluginName, `notificationRouting.${priority}: ${target.reference} (plugin: ${target.pluginName})`);
+        }
+    }
+    for (const [name, notifierConfig] of Object.entries(config.notifiers ?? {})) {
+        addPluginReference(refs, "notifier", notifierConfig.plugin, `notifiers.${name} (plugin: ${notifierConfig.plugin})`);
+    }
+    for (const [projectId, project] of Object.entries(config.projects)) {
+        addPluginReference(refs, "runtime", project.runtime, `projects.${projectId}.runtime`);
+        addPluginReference(refs, "agent", project.agent, `projects.${projectId}.agent`);
+        addPluginReference(refs, "workspace", project.workspace, `projects.${projectId}.workspace`);
+        addPluginReference(refs, "agent", project.orchestrator?.agent, `projects.${projectId}.orchestrator.agent`);
+        addPluginReference(refs, "agent", project.worker?.agent, `projects.${projectId}.worker.agent`);
+        addPluginReference(refs, "tracker", project.tracker?.plugin, `projects.${projectId}.tracker.plugin`);
+        addPluginReference(refs, "scm", project.scm?.plugin, `projects.${projectId}.scm.plugin`);
+    }
+    return refs;
+}
+async function checkPluginResolution(config, fail) {
+    console.log("");
+    console.log("Plugin resolution:");
+    const registry = await loadPluginRegistry(config);
+    const loadedBySlot = new Map();
+    const slots = [
+        "runtime",
+        "agent",
+        "workspace",
+        "tracker",
+        "scm",
+        "notifier",
+    ];
+    for (const slot of slots) {
+        loadedBySlot.set(slot, new Set(registry.list(slot).map((manifest) => manifest.name)));
+    }
+    const references = collectPluginReferences(config);
+    if (references.length === 0) {
+        warn("No plugin references found in config.");
+        return registry;
+    }
+    for (const ref of references) {
+        const loaded = loadedBySlot.get(ref.slot);
+        if (loaded?.has(ref.pluginName)) {
+            pass(`${ref.source} -> ${ref.slot} plugin "${ref.pluginName}"`);
+        }
+        else {
+            fail(`${ref.source} references ${ref.slot} plugin "${ref.pluginName}", but it could not be loaded. ` +
+                `Fix: install the plugin or correct the config value.`);
+        }
+    }
+    return registry;
+}
+function formatTimestamp(timestamp) {
+    if (!timestamp)
+        return null;
+    const date = new Date(timestamp);
+    return Number.isNaN(date.getTime()) ? timestamp : date.toLocaleString();
+}
+function readOpenClawHealth(config) {
+    if (!config.configPath)
+        return null;
+    const healthPath = join(getObservabilityBaseDir(config.configPath), "openclaw-health.json");
+    if (!existsSync(healthPath))
+        return null;
+    try {
+        const raw = readFileSync(healthPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        return {
+            lastSuccessAt: typeof parsed.lastSuccessAt === "string" ? parsed.lastSuccessAt : null,
+            lastFailureAt: typeof parsed.lastFailureAt === "string" ? parsed.lastFailureAt : null,
+            lastFailureError: typeof parsed.lastFailureError === "string" ? parsed.lastFailureError : null,
+            totalSent: typeof parsed.totalSent === "number" ? parsed.totalSent : 0,
+            totalFailed: typeof parsed.totalFailed === "number" ? parsed.totalFailed : 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function checkOpenClawNotifier(config, fail) {
+    const openclawConfig = config.notifiers?.["openclaw"];
+    if (!openclawConfig || openclawConfig.plugin !== "openclaw") {
+        warn("OpenClaw notifier is not configured. Fix: run athene setup openclaw");
+        return;
+    }
+    const url = (typeof openclawConfig["url"] === "string" ? openclawConfig["url"] : undefined) ??
+        "http://127.0.0.1:18789";
+    // Resolve ${ENV_VAR} placeholders written by `athene setup openclaw` — the config
+    // stores the literal string "${OPENCLAW_HOOKS_TOKEN}" which is truthy but wrong.
+    const rawToken = typeof openclawConfig["token"] === "string" ? openclawConfig["token"] : undefined;
+    const envVarMatch = rawToken?.match(/^\$\{([^}]+)\}$/);
+    const token = (envVarMatch ? process.env[envVarMatch[1]] : rawToken) ?? process.env["OPENCLAW_HOOKS_TOKEN"];
+    const installation = await detectOpenClawInstallation(url);
+    if (installation.state === "running") {
+        pass(`OpenClaw gateway detected at ${installation.gatewayUrl} (HTTP ${installation.probe.httpStatus})`);
+    }
+    else if (installation.state === "installed-but-stopped") {
+        const installHint = installation.binaryPath
+            ? `installed at ${installation.binaryPath}`
+            : "configured on this machine";
+        fail(`OpenClaw is ${installHint} but the gateway is not running at ${installation.gatewayUrl}`);
+    }
+    else {
+        fail(`OpenClaw is not installed locally and the gateway is not reachable at ${installation.gatewayUrl}. ` +
+            `Fix: install/start OpenClaw or update the notifier URL`);
+    }
+    // Step 2: Validate auth token if present
+    if (!token) {
+        warn("OpenClaw token is not set. Fix: set OPENCLAW_HOOKS_TOKEN env var or add token to notifiers.openclaw in config");
+    }
+    else if (installation.state === "running") {
+        const tokenResult = await validateToken(installation.gatewayUrl, token);
+        if (!tokenResult.valid) {
+            fail(`OpenClaw token validation failed: ${tokenResult.error}`);
+        }
+        else {
+            pass("OpenClaw token is valid");
+        }
+    }
+    const health = readOpenClawHealth(config);
+    if (!health) {
+        warn("No OpenClaw notification history recorded yet");
+        return;
+    }
+    const lastSuccess = formatTimestamp(health.lastSuccessAt);
+    if (lastSuccess) {
+        pass(`OpenClaw last successful notification: ${lastSuccess}`);
+    }
+    else {
+        warn("OpenClaw has not recorded a successful notification yet");
+    }
+    if (health.lastFailureAt) {
+        const lastFailure = formatTimestamp(health.lastFailureAt);
+        warn(`OpenClaw last failure: ${lastFailure ?? health.lastFailureAt} (${health.lastFailureError ?? "unknown error"})`);
+    }
+    pass(`OpenClaw notification totals: ${health.totalSent} sent, ${health.totalFailed} failed`);
+}
+async function checkNotifierConnectivity(config, fail) {
+    console.log(""); // blank line before notifier section
+    console.log("Notifier connectivity:");
+    const configuredNotifiers = Object.keys(config.notifiers ?? {});
+    if (configuredNotifiers.length === 0) {
+        warn("No notifiers are configured. Fix: add notifiers to your agent-orchestrator.yaml");
+        return;
+    }
+    // Check OpenClaw specifically (it's the only one we can probe without side effects)
+    if (config.notifiers?.["openclaw"]) {
+        await checkOpenClawNotifier(config, fail);
+    }
+    // Report other configured notifiers as present (we can't health-check Slack/desktop/webhook without sending)
+    for (const [name, notifierConfig] of Object.entries(config.notifiers ?? {})) {
+        if (name === "openclaw")
+            continue; // already checked above
+        const plugin = notifierConfig.plugin;
+        pass(`${name} notifier is configured (plugin: ${plugin})`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Test-notify (Gap 3)
+// ---------------------------------------------------------------------------
+async function sendTestNotifications(config, registry, fail) {
+    const result = await runNotifyTest(config, registry, {
+        templateName: "basic",
+        all: true,
+        message: "Test notification from athene doctor --test-notify",
+        sessionId: "doctor-test",
+        projectId: "doctor",
+        data: { source: "athene-doctor" },
+    });
+    if (result.targets.length === 0) {
+        warn("No notifiers to test. Fix: configure notifiers in your agent-orchestrator.yaml");
+        return;
+    }
+    console.log(`\nSending test notification to ${result.targets.length} notifier(s)...\n`);
+    for (const delivery of result.deliveries) {
+        if (delivery.status === "sent") {
+            pass(`${delivery.reference}: test notification sent`);
+        }
+        else if (delivery.status === "unresolved") {
+            warn(`${delivery.reference}: plugin "${delivery.pluginName}" not loaded (may not be installed)`);
+        }
+        else if (delivery.error) {
+            fail(delivery.error);
+        }
+    }
+    for (const warning of result.warnings) {
+        warn(warning);
+    }
+}
+// ---------------------------------------------------------------------------
+// Version freshness (cache-only — no network call)
+// ---------------------------------------------------------------------------
+function checkVersionFreshness() {
+    console.log("");
+    console.log("Version:");
+    const current = getCurrentVersion();
+    const installMethod = detectInstallMethod();
+    const cached = readCachedUpdateInfo(installMethod);
+    if (!cached) {
+        pass(`athene v${current} installed (run any athene command to check for updates)`);
+        return;
+    }
+    const isOutdated = installMethod === "git"
+        ? cached.isOutdated === true
+        : isVersionOutdated(current, cached.latestVersion);
+    if (isOutdated) {
+        const latest = installMethod === "git" ? cached.latestVersion : `v${cached.latestVersion}`;
+        warn(`athene v${current} is outdated (latest: ${latest}). Run: ${getUpdateCommand(installMethod)}`);
+    }
+    else {
+        pass(`athene v${current} is the latest version`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+export function registerDoctor(program) {
+    program
+        .command("doctor")
+        .description("Run install, environment, and runtime health checks")
+        .option("--fix", "Apply safe fixes for launcher and stale temp issues")
+        .option("--test-notify", "Send a test notification through each configured notifier")
+        .action(async (opts) => {
+        const { fail, count: failCount } = makeFailCounter();
+        // 1. Run shell checks
+        const scriptArgs = [];
+        if (opts.fix) {
+            scriptArgs.push("--fix");
+        }
+        let shellExitCode;
+        try {
+            shellExitCode = await runRepoScript("athene-doctor.sh", scriptArgs);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            shellExitCode = 1;
+        }
+        // 2. Version freshness (cache-only, no network dependency)
+        checkVersionFreshness();
+        // 3. Run TypeScript-based notifier checks if a config file exists
+        const configPath = findConfigFile();
+        if (configPath) {
+            let config;
+            let registry;
+            try {
+                config = loadConfig(configPath);
+                registry = await checkPluginResolution(config, fail);
+                await checkNotifierConnectivity(config, fail);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                fail(`Config-aware doctor checks failed: ${message}`);
+            }
+            // 4. Send test notifications if requested (separate catch for accurate errors)
+            if (opts.testNotify && config && registry) {
+                try {
+                    await sendTestNotifications(config, registry, fail);
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    fail(`Sending test notifications failed: ${message}`);
+                }
+            }
+        }
+        else if (opts.testNotify) {
+            fail("No config file found. Cannot test notifiers without agent-orchestrator.yaml");
+        }
+        // Exit non-zero if shell checks or notifier checks failed
+        if (shellExitCode !== 0 || failCount() > 0) {
+            process.exit(shellExitCode || 1);
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/events.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerEvents(program: Command): void;
+//# sourceMappingURL=events.d.ts.map

package/dist/commands/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwEzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuJrD"}

package/dist/commands/events.js

@@ -0,0 +1,172 @@
+import chalk from "chalk";
+import { queryActivityEvents, searchActivityEvents, getActivityEventStats, droppedEventCount, isActivityEventsFtsEnabled, } from "@made-by-moonlight/athene-core";
+function toJsonOutput(ev) {
+    let data = ev.data;
+    if (typeof ev.data === "string") {
+        try {
+            data = JSON.parse(ev.data);
+        }
+        catch {
+            // leave as raw string if not valid JSON
+        }
+    }
+    return { ...ev, data };
+}
+function parseSinceDuration(raw) {
+    const match = raw.match(/^(\d+)(m|h|d)$/);
+    if (!match)
+        return undefined;
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const ms = unit === "m" ? value * 60_000 : unit === "h" ? value * 3_600_000 : value * 86_400_000;
+    return new Date(Date.now() - ms);
+}
+function formatRow(ev) {
+    const ts = new Date(ev.tsEpoch).toLocaleTimeString();
+    const session = ev.sessionId ? ev.sessionId.slice(0, 12) : "—";
+    const kind = chalk.cyan(ev.kind.padEnd(22));
+    // Pad raw string before chalk-wrapping: chalk adds ANSI codes that inflate .length
+    const levelLabel = ev.level.padEnd(9);
+    const level = ev.level === "error"
+        ? chalk.red(levelLabel)
+        : ev.level === "warn"
+            ? chalk.yellow(levelLabel)
+            : chalk.gray(levelLabel);
+    return `${chalk.dim(ts)}  ${kind}  ${level}  ${chalk.dim(session)}  ${ev.summary}`;
+}
+function jsonMeta(resultCount, fallbackUsed = false) {
+    return {
+        resultCount,
+        droppedEventCount: droppedEventCount(),
+        ftsEnabled: isActivityEventsFtsEnabled(),
+        fallbackUsed,
+        ts: new Date().toISOString(),
+    };
+}
+export function registerEvents(program) {
+    const events = program
+        .command("events")
+        .description("Query activity event log (session spawns, transitions, CI failures)");
+    events
+        .command("list")
+        .description("List recent activity events")
+        .option("-p, --project <id>", "Filter by project ID")
+        .option("-s, --session <id>", "Filter by session ID")
+        .option("-t, --type <kind>", "Filter by event kind (e.g. session.spawned, lifecycle.transition)")
+        .option("--kind <kind>", "Alias for --type")
+        .option("--source <source>", "Filter by event source (e.g. lifecycle, recovery, api)")
+        .option("--log-level <level>", "Filter by log level (debug, info, warn, error)")
+        .option("--since <duration>", "Show events from last N minutes/hours/days (e.g. 30m, 2h, 1d)")
+        .option("-n, --limit <n>", "Max results", "50")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const sinceRaw = opts["since"];
+        let since;
+        if (sinceRaw) {
+            since = parseSinceDuration(sinceRaw);
+            if (!since) {
+                console.error(chalk.yellow(`Warning: unrecognised --since format "${sinceRaw}" (use e.g. 30m, 2h, 1d). No time filter applied.`));
+            }
+        }
+        const limit = parseInt(opts["limit"] ?? "50", 10);
+        const kind = opts["type"] ?? opts["kind"];
+        const results = queryActivityEvents({
+            projectId: opts["project"],
+            sessionId: opts["session"],
+            kind: kind,
+            source: opts["source"],
+            level: opts["logLevel"],
+            since,
+            limit,
+        });
+        if (opts["json"]) {
+            const envelope = {
+                version: 1,
+                query: {
+                    projectId: opts["project"] ?? null,
+                    sessionId: opts["session"] ?? null,
+                    kind: kind ?? null,
+                    source: opts["source"] ?? null,
+                    level: opts["logLevel"] ?? null,
+                    since: sinceRaw ?? null,
+                    limit,
+                },
+                meta: jsonMeta(results.length),
+                events: results.map(toJsonOutput),
+            };
+            console.log(JSON.stringify(envelope, null, 2));
+            return;
+        }
+        if (results.length === 0) {
+            console.log(chalk.dim("No events found."));
+            return;
+        }
+        console.log(chalk.dim(`${"TIME".padEnd(10)}  ${"KIND".padEnd(22)}  ${"LEVEL".padEnd(9)}  ${"SESSION".padEnd(12)}  SUMMARY`));
+        for (const ev of results) {
+            console.log(formatRow(ev));
+        }
+        console.log(chalk.dim(`\n${results.length} event(s)`));
+    });
+    events
+        .command("search <query>")
+        .description("Full-text search across event summaries and data")
+        .option("-p, --project <id>", "Filter by project ID")
+        .option("-n, --limit <n>", "Max results", "100")
+        .option("--json", "Output as JSON")
+        .action(async (query, opts) => {
+        const limit = parseInt(opts["limit"] ?? "100", 10);
+        const results = searchActivityEvents(query, opts["project"], limit);
+        const fallbackUsed = !isActivityEventsFtsEnabled();
+        if (opts["json"]) {
+            const envelope = {
+                version: 1,
+                query: { q: query, projectId: opts["project"] ?? null, limit },
+                meta: jsonMeta(results.length, fallbackUsed),
+                events: results.map(toJsonOutput),
+            };
+            console.log(JSON.stringify(envelope, null, 2));
+            return;
+        }
+        if (results.length === 0) {
+            console.log(chalk.dim("No events found."));
+            return;
+        }
+        console.log(chalk.dim(`${"TIME".padEnd(10)}  ${"KIND".padEnd(22)}  ${"LEVEL".padEnd(9)}  ${"SESSION".padEnd(12)}  SUMMARY`));
+        for (const ev of results) {
+            console.log(formatRow(ev));
+        }
+        console.log(chalk.dim(`\n${results.length} event(s)`));
+    });
+    events
+        .command("stats")
+        .description("Show event log statistics")
+        .action(async () => {
+        const stats = getActivityEventStats();
+        if (!stats) {
+            console.log(chalk.yellow("Event log unavailable (better-sqlite3 not loaded)."));
+            return;
+        }
+        console.log(chalk.bold("Event Log Stats"));
+        console.log(`  Total events:      ${stats.total}`);
+        console.log(`  Dropped (process): ${stats.droppedThisProcess}`);
+        if (stats.oldestTs)
+            console.log(`  Oldest event:      ${stats.oldestTs}`);
+        if (stats.newestTs)
+            console.log(`  Newest event:      ${stats.newestTs}`);
+        if (Object.keys(stats.byKind).length > 0) {
+            console.log(chalk.bold("\nBy kind:"));
+            const byKind = Object.entries(stats.byKind);
+            for (const [kind, count] of byKind.sort((a, b) => b[1] - a[1])) {
+                console.log(`  ${kind.padEnd(30)} ${count}`);
+            }
+        }
+        if (Object.keys(stats.bySource).length > 0) {
+            console.log(chalk.bold("\nBy source:"));
+            const bySource = Object.entries(stats.bySource);
+            for (const [source, count] of bySource.sort((a, b) => b[1] - a[1])) {
+                console.log(`  ${source.padEnd(30)} ${count}`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=events.js.map