@songsid/agend 2.1.4-beta.4 → 2.1.4-beta.40

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.");