@songsid/agend 2.1.4-beta.9 → 2.1.4

package/dist/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-// Force IPv4 for all DNS lookups (fixes IPv6 timeout issues in corporate/WSL environments)
-import dns from "node:dns";
-dns.setDefaultResultOrder("ipv4first");
+import { applyNetworkReliabilityDefaults } from "./network-family.js";
+// Preserve Node's dual-stack Happy Eyeballs behavior, but avoid its 250ms
+// premature-connect failure on WSL/VPN/high-load hosts (#658).
+applyNetworkReliabilityDefaults();
 import { Command } from "commander";
 import { join, dirname } from "node:path";
 import { SchedulerDb } from "./scheduler/db.js";
@@ -19,6 +20,8 @@ import { getUpdateSelector, lookupTargetVersion, reportUpdateRestart, shouldSkip
 import { clearUpdateMarker, markUpdateInProgress, setUpdateProgressStage } from "./update-marker.js";
 import { acquireFleetLock, releaseProcessFleetLock, setProcessFleetLock } from "./fleet-lock.js";
 import { SYSTEMD_RESTART_TIMEOUT_MS } from "./service-installer.js";
+import { loadRawFleetConfig } from "./config.js";
+import { setLocale, t } from "./locale.js";
 /** Prefix tmux args with -L when socket isolation is active. */
 function tmuxArgs(args) {
     const socket = getTmuxSocketName();
@@ -28,6 +31,14 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const DATA_DIR = getAgendHome();
 const FLEET_CONFIG_PATH = join(DATA_DIR, "fleet.yaml");
+// CLI commands run outside FleetManager. Honor an explicit fleet locale while
+// keeping the historical English CLI default when config is missing/unset.
+try {
+    const configuredLocale = loadRawFleetConfig(FLEET_CONFIG_PATH).defaults?.locale;
+    if (configuredLocale === "en" || configuredLocale === "zh-TW")
+        setLocale(configuredLocale);
+}
+catch { /* malformed or missing config: keep the English CLI default */ }
 const program = new Command();
 function claimFleetSingleton() {
     try {
@@ -549,7 +560,7 @@ function generateMermaid(rows) {
 }
 fleet
     .command("cleanup")
-    .description("Remove orphaned instance directories not in fleet.yaml")
+    .description("Remove orphaned instance directories and stale instance files")
     .option("--dry-run", "List orphans without deleting")
     .action(async (opts) => {
     const { FleetManager } = await import("./fleet-manager.js");
@@ -818,15 +829,24 @@ backend
 // ── doctor mcp ──
 program
     .command("doctor")
-    .description("Run fleet health diagnostics")
-    .argument("[check]", "Specific check to run (mcp)")
+    .description("Diagnose backends, tmux, service, D-Bus, fleet, IPC, and network; use `mcp` for a deep MCP check")
+    .argument("[check]", "Optional deep check: mcp (omit for the full fleet diagnostic)")
     .action(async (check) => {
     if (check === "mcp") {
         await doctorMcp();
     }
-    else {
+    else if (check) {
         console.log("Usage: agend doctor mcp");
         console.log("  mcp  — Check fleet MCP health (IPC sockets, MCP configs, backends)");
+        process.exitCode = 2;
+    }
+    else {
+        const { inspectService } = await import("./service-installer.js");
+        const { collectDoctorReport, formatDoctorReport } = await import("./doctor.js");
+        const report = await collectDoctorReport(DATA_DIR, inspectService());
+        console.log(formatDoctorReport(report));
+        if (report.errors > 0)
+            process.exitCode = 1;
     }
 });
 async function doctorMcp() {
@@ -959,8 +979,8 @@ async function doctorMcp() {
 }
 backend
     .command("trust")
-    .description("Pre-trust working directories for a backend (prevents trust dialogs)")
-    .argument("<backend>", "Backend (gemini-cli)")
+    .description("Pre-trust Gemini CLI working directories (prevents trust dialogs)")
+    .argument("<backend>", "Backend (gemini-cli only)")
     .argument("[directories...]", "Directories to trust (defaults to all fleet instance dirs)")
     .action(async (backendName, directories) => {
     if (backendName !== "gemini-cli") {
@@ -1146,7 +1166,7 @@ access
 // === Update + Reload ===
 program
     .command("update")
-    .description("Update AgEnD to latest version and restart service")
+    .description("Update AgEnD to the selected release and restart the fleet service")
     .option("--version <ver>", "Specific version to install")
     .option("--beta", "Install beta version")
     .option("--force", "Force reinstall and restart even when already up to date")
@@ -1273,7 +1293,10 @@ program
     if (agendPath) {
         try {
             // Use the NEW binary to install service (old binary's templates may be deleted)
-            const installResult = spawnSync(agendPath, ["install"], { encoding: "utf-8", timeout: 15000 });
+            // `agend install` activates by default. During update the existing
+            // restart stage owns stop/start and progress reporting, so only refresh
+            // the service file here to avoid restarting the fleet twice.
+            const installResult = spawnSync(agendPath, ["install", "--no-activate"], { encoding: "utf-8", timeout: 15000 });
             if (installResult.status === 0) {
                 console.log(`  ✓ Service updated`);
             }
@@ -1326,7 +1349,7 @@ program
 });
 program
     .command("reload")
-    .description("Hot-reload fleet config (re-read fleet.yaml, start new instances)")
+    .description("Hot-reload fleet.yaml and reconcile instance configuration")
     .action(async () => {
     const pidPath = join(DATA_DIR, "fleet.pid");
     if (!existsSync(pidPath)) {
@@ -1346,8 +1369,9 @@ program
 // === Install/Uninstall ===
 program
     .command("install")
-    .description("Install as system service")
-    .option("--activate", "Stop manual fleet and load the service immediately")
+    .description("Install the AgEnD system service and start it by default")
+    .option("--activate", "Deprecated; service activation is now the default")
+    .option("--no-activate", "Write the service file without activating it")
     .action(async (opts) => {
     const { installService, activateService, detectPlatform } = await import("./service-installer.js");
     const execPath = process.argv[1];
@@ -1358,38 +1382,86 @@ program
         workingDirectory: DATA_DIR,
         logPath: join(DATA_DIR, "fleet.log"),
     });
-    console.log(`Service installed at: ${svcPath}`);
-    if (opts.activate) {
+    console.log(t("install.path", svcPath));
+    if (opts.activate !== false) {
         const pidPath = join(DATA_DIR, "fleet.pid");
-        activateService(svcPath, pidPath);
-        console.log("Service activated.");
-    }
-    else {
-        const plat = detectPlatform();
-        if (plat === "macos") {
-            console.log(`Run: launchctl load ${svcPath}`);
+        try {
+            activateService(svcPath, pidPath);
+            console.log(t("install.running"));
         }
-        else {
-            console.log(`Run: systemctl --user enable --now com.agend.fleet`);
+        catch (err) {
+            console.error(t("install.start_failed", err.message));
+            const plat = detectPlatform();
+            if (plat === "macos") {
+                console.error(`Run manually: launchctl load ${svcPath}`);
+            }
+            else {
+                console.error("Run manually: systemctl --user daemon-reload && systemctl --user enable --now com.agend.fleet");
+            }
+            process.exitCode = 1;
         }
     }
+    else {
+        console.log(t("install.updated"));
+    }
 });
 program
     .command("uninstall")
-    .description("Remove system service")
-    .action(async () => {
-    const { uninstallService } = await import("./service-installer.js");
-    const removed = uninstallService("com.agend.fleet");
-    if (removed) {
-        console.log("Service uninstalled");
+    .description("Remove the AgEnD system service")
+    .option("-f, --force", "Skip confirmation (for CI/automation)")
+    .action(async (opts) => {
+    const { inspectService, isServiceRemovalConfirmed, uninstallService } = await import("./service-installer.js");
+    const service = inspectService("com.agend.fleet");
+    if (!service.installed) {
+        console.log(t("uninstall.none"));
+        return;
     }
-    else {
-        console.log("No service found to uninstall");
+    const state = (value, yes, no) => value == null ? t("uninstall.unknown") : value ? yes : no;
+    console.log(t("uninstall.found"));
+    console.log(`  ${t("uninstall.manager", service.manager ?? t("uninstall.unknown"))}`);
+    console.log(`  ${t("uninstall.path", service.path ?? t("uninstall.unknown"))}`);
+    console.log(`  ${t("uninstall.enabled", state(service.enabled, t("uninstall.yes"), t("uninstall.no")))}`);
+    console.log(`  ${t("uninstall.active", state(service.active, t("uninstall.running"), t("uninstall.inactive")))}`);
+    if (!opts.force && !process.stdin.isTTY) {
+        console.log(t("uninstall.non_interactive"));
+        process.exitCode = 1;
+        return;
+    }
+    if (!opts.force) {
+        const { createInterface } = await import("node:readline/promises");
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        let answer = "";
+        try {
+            answer = await rl.question(t("uninstall.confirm"));
+        }
+        catch {
+            console.log(t("uninstall.cancelled_force"));
+            return;
+        }
+        finally {
+            rl.close();
+        }
+        if (!isServiceRemovalConfirmed(answer)) {
+            console.log(t("uninstall.cancelled"));
+            return;
+        }
+    }
+    try {
+        if (uninstallService("com.agend.fleet")) {
+            console.log(t("uninstall.removed"));
+        }
+        else {
+            console.log(t("uninstall.none"));
+        }
+    }
+    catch (err) {
+        console.error(t("uninstall.failed", err.message));
+        process.exitCode = 1;
     }
 });
 program
     .command("stop")
-    .description("Stop the AgEnD service")
+    .description("Stop the AgEnD service or detached fleet")
     .action(async () => {
     const { getServicePath, stopService } = await import("./service-installer.js");
     if (!getServicePath()) {
@@ -1433,7 +1505,7 @@ program
 });
 program
     .command("start")
-    .description("Start the AgEnD service (must be installed first)")
+    .description("Start the AgEnD service, or start a detached fleet if no service is installed")
     .action(async () => {
     const { getServicePath, getSystemServicePath, startService, startSystemService } = await import("./service-installer.js");
     const userServicePath = getServicePath();
@@ -1589,7 +1661,7 @@ program
 });
 program
     .command("quickstart")
-    .description("Quick 3-step setup: detect backend, create bot, connect group")
+    .description("Guided setup for a Backend, chat channel, projects, and fleet service")
     .action(async () => {
     const { runQuickstart } = await import("./quickstart.js");
     await runQuickstart();
@@ -1862,7 +1934,7 @@ schedule
 });
 schedule
     .command("trigger")
-    .description("Manually trigger a schedule")
+    .description("Show how to manually trigger a schedule")
     .argument("<id>", "Schedule ID")
     .action((id) => {
     console.log("Manual trigger requires fleet manager running. Use the Telegram interface instead.");
@@ -1959,46 +2031,8 @@ async function resolveInstance(query, config) {
     }
     return match;
 }
-/** Get total RSS (KB) for a process and all its descendants. */
-function getTreeRssKb(pid, depth = 0) {
-    if (depth > 10)
-        return 0;
-    if (!Number.isInteger(pid) || pid <= 0)
-        return 0;
-    let total = 0;
-    try {
-        // Try PSS from smaps_rollup (more accurate — excludes shared page double-counting)
-        const smaps = readFileSync(`/proc/${pid}/smaps_rollup`, "utf-8");
-        const match = smaps.match(/^Pss:\s+(\d+)/m);
-        if (match) {
-            total += parseInt(match[1], 10);
-        }
-        else {
-            throw new Error("no Pss line");
-        }
-    }
-    catch {
-        // Fallback to RSS via ps
-        try {
-            const rss = parseInt(execFileSync("ps", ["-o", "rss=", "-p", String(pid)], { stdio: "pipe" }).toString().trim(), 10);
-            if (!isNaN(rss))
-                total += rss;
-        }
-        catch {
-            return 0;
-        }
-    }
-    try {
-        const children = execFileSync("pgrep", ["-P", String(pid)], { stdio: "pipe" }).toString().trim();
-        for (const line of children.split("\n")) {
-            const childPid = parseInt(line, 10);
-            if (!isNaN(childPid))
-                total += getTreeRssKb(childPid, depth + 1);
-        }
-    }
-    catch { /* no children */ }
-    return total;
-}
+// Imported from process-memory.ts — see that module for implementation
+import { getTreeRssKb } from "./process-memory.js";
 function getInstanceStatusStandalone(name) {
     if (hasPausedMarker(join(DATA_DIR, "instances", name)))
         return "paused";
@@ -2521,6 +2555,10 @@ program
         if (procStatus === "stopped") {
             return { name, status: "stopped", issues: ["Not running"], general: isGeneral };
         }
+        // Paused instances have no tmux window by design — skip running-only checks
+        if (procStatus === "paused") {
+            return { name, status: "paused", issues: [], general: isGeneral };
+        }
         // Tmux window alive?
         if (!tmuxWindows.has(name))
             issues.push("Tmux window missing");
@@ -2552,10 +2590,11 @@ program
     });
     // Fleet classification
     const crashed = results.filter(r => r.status === "crash");
-    const problems = results.filter(r => r.status !== "ok" && r.status !== "idle" && r.status !== "stopped");
+    const problems = results.filter(r => r.status !== "ok" && r.status !== "idle" && r.status !== "stopped" && r.status !== "paused");
     const healthy = results.filter(r => r.status === "ok" || r.status === "idle");
     const stopped = results.filter(r => r.status === "stopped");
-    const generalDown = results.some(r => r.general && r.status !== "ok" && r.status !== "idle");
+    const paused = results.filter(r => r.status === "paused");
+    const generalDown = results.some(r => r.general && r.status !== "ok" && r.status !== "idle" && r.status !== "paused");
     let classification;
     if (generalDown || crashed.length > 0)
         classification = "unhealthy";
@@ -2570,7 +2609,8 @@ program
     }
     if (opts.quiet) {
         const icon = classification === "healthy" ? "✓" : classification === "degraded" ? "⚠" : "✗";
-        console.log(`${icon} ${classification}: ${healthy.length}/${names.length} healthy${problems.length > 0 ? `, ${problems.length} issues` : ""}`);
+        const pausedPart = paused.length > 0 ? `, ${paused.length} paused` : "";
+        console.log(`${icon} ${classification}: ${healthy.length}/${names.length} healthy${problems.length > 0 ? `, ${problems.length} issues` : ""}${pausedPart}`);
         process.exit(exitCode);
     }
     // Full output
@@ -2578,9 +2618,10 @@ program
     const upH = Math.floor(uptime / 3600);
     const upM = Math.floor((uptime % 3600) / 60);
     console.log(`Fleet: ${fleetIcon} ${fleetUp ? `running (uptime ${upH}h ${upM}m, PID ${fleetPid})` : "not running"}`);
-    console.log(`Instances: ${healthy.length} healthy, ${problems.length + crashed.length} issues, ${stopped.length} stopped\n`);
-    // Only show instances with problems
-    const unhealthy = results.filter(r => r.issues.length > 0 && r.status !== "stopped");
+    const pausedPart = paused.length > 0 ? `, ${paused.length} paused` : "";
+    console.log(`Instances: ${healthy.length} healthy, ${problems.length + crashed.length} issues, ${stopped.length} stopped${pausedPart}\n`);
+    // Only show instances with problems (paused is not a problem)
+    const unhealthy = results.filter(r => r.issues.length > 0 && r.status !== "stopped" && r.status !== "paused");
     if (unhealthy.length === 0) {
         console.log("\x1b[32m✓ All instances healthy\x1b[0m");
     }