@songsid/agend 2.1.3 → 2.1.4-beta.10

package/dist/cli.js

@@ -16,7 +16,7 @@ import { hasPausedMarker } from "./pause-marker.js";
 import { clampContextPercent, parseContextPercent } from "./context-percent.js";
 import { COMPLETION_SHELLS, completionScript } from "./completion.js";
 import { getUpdateSelector, lookupTargetVersion, reportUpdateRestart, shouldSkipUpdate, } from "./update-check.js";
-import { clearUpdateMarker, markUpdateInProgress } from "./update-marker.js";
+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";
 /** Prefix tmux args with -L when socket isolation is active. */
@@ -598,20 +598,19 @@ const backend = program.command("backend").description("Backend diagnostics");
 backend
     .command("doctor")
     .description("Check backend prerequisites and configuration")
-    .argument("[backend]", "Backend to check (claude-code, codex, gemini-cli, opencode, kiro-cli)", "claude-code")
+    .argument("[backend]", "Backend to check (claude-code, codex, opencode, kiro-cli, antigravity, grok, gemini-cli [deprecated])", "claude-code")
     .action(async (backendName) => {
-    const backends = {
-        "claude-code": { binary: "claude", label: "Claude Code", install: "npm i -g @anthropic-ai/claude-code", auth: "claude (OAuth) or ANTHROPIC_API_KEY" },
-        "codex": { binary: "codex", label: "OpenAI Codex", install: "npm i -g @openai/codex", auth: "OPENAI_API_KEY" },
-        "gemini-cli": { binary: "gemini", label: "Gemini CLI", install: "npm i -g @google/gemini-cli", auth: "gemini (Google OAuth)" },
-        "opencode": { binary: "opencode", label: "OpenCode", install: "go install github.com/opencode-ai/opencode@latest", auth: "Configure provider API key" },
-        "kiro-cli": { binary: "kiro-cli", label: "Kiro CLI", install: "brew install --cask kiro-cli", auth: "kiro-cli login (AWS Builder ID)" },
-    };
-    const info = backends[backendName];
+    // Single source of truth for backend metadata — a hand-copied list here is
+    // how the doctor previously drifted (missing antigravity/grok entirely).
+    const { BACKENDS } = await import("./setup-wizard.js");
+    const info = BACKENDS.find(b => b.id === backendName);
     if (!info) {
-        console.error(`Unknown backend: ${backendName}. Available: ${Object.keys(backends).join(", ")}`);
+        console.error(`Unknown backend: ${backendName}. Available: ${BACKENDS.map(b => b.id).join(", ")}`);
         process.exit(1);
     }
+    if (info.deprecated) {
+        console.warn(`⚠️  ${info.label} is deprecated (stops 2026-06-18). Consider switching to backend: antigravity`);
+    }
     let issues = 0;
     const ok = (msg) => console.log(`  \x1b[32m✓\x1b[0m ${msg}`);
     const fail = (msg) => { issues++; console.log(`  \x1b[31m✗\x1b[0m ${msg}`); };
@@ -1158,6 +1157,7 @@ program
     const targetVersion = lookupTargetVersion(tag);
     if (shouldSkipUpdate(pkgVersion, targetVersion, opts.force)) {
         console.log(`\n  ✓ Already up to date (v${pkgVersion})\n`);
+        setUpdateProgressStage(DATA_DIR, "complete", { version: pkgVersion });
         return;
     }
     if (targetVersion) {
@@ -1174,10 +1174,13 @@ program
     // dies here does not silence real alerts.
     markUpdateInProgress(DATA_DIR);
     const failUpdate = (message) => {
-        clearUpdateMarker(DATA_DIR);
+        if (!setUpdateProgressStage(DATA_DIR, "failed", { error: message.trim() })) {
+            clearUpdateMarker(DATA_DIR);
+        }
         console.error(message);
         process.exit(1);
     };
+    setUpdateProgressStage(DATA_DIR, "downloading");
     // Detect and remove stale npm link (local build that shadows global install)
     try {
         const agendPath = execSync("which agend", { encoding: "utf-8", stdio: "pipe" }).trim();
@@ -1265,6 +1268,7 @@ program
     }
     const newVersion = (verifyResult.stdout ?? "").trim();
     console.log(`  ✓ Installed: ${newVersion}`);
+    setUpdateProgressStage(DATA_DIR, "installed", { version: newVersion.replace(/^v/, "") });
     // ── Update service file ──
     if (agendPath) {
         try {
@@ -1281,6 +1285,20 @@ program
             console.log(`  ⚠ Service file update failed (non-fatal): ${e.message}`);
         }
     }
+    // ── Refresh installed shell completions ──
+    // The completion script embeds this version's subcommand names, so a
+    // previously installed static file goes stale on update. --refresh only
+    // rewrites artifacts that already exist — an update never starts
+    // installing completions the user didn't ask for. Run through the NEW
+    // binary so the regenerated names are the new version's.
+    try {
+        spawnSync(agendPath, ["completion", "install", "--refresh"], {
+            encoding: "utf-8",
+            timeout: 15_000,
+            stdio: "ignore",
+        });
+    }
+    catch { /* cosmetic — never block an update on completion refresh */ }
     // ── Restart fleet ──
     // Run the restart through the NEWLY-INSTALLED binary (agendPath), not inline.
     // The inline restart would execute the OLD binary's code — exactly the logic
@@ -1288,6 +1306,7 @@ program
     // restart` (new binary) does the 4-environment service detection (system
     // systemd → user systemd → launchd → detached pid).
     console.log("  Restarting fleet...");
+    setUpdateProgressStage(DATA_DIR, "stopping", { version: newVersion.replace(/^v/, "") });
     // `agend restart` may synchronously wait for a Type=notify service to finish
     // a multi-minute stop/start and send READY=1. Keep this parent wrapper alive
     // longer than the restart command's own bounded wait.
@@ -1299,7 +1318,9 @@ program
     if (!reportUpdateRestart(restartResult.status)) {
         // No new fleet is coming up to clear the marker — do it here, or the next
         // 15 minutes of genuine crashes would go unreported.
-        clearUpdateMarker(DATA_DIR);
+        if (!setUpdateProgressStage(DATA_DIR, "failed", { error: "fleet restart failed" })) {
+            clearUpdateMarker(DATA_DIR);
+        }
         process.exitCode = 1;
     }
 });
@@ -2381,29 +2402,59 @@ program
 });
 program
     .command("completion")
-    .description("Print a shell completion script (bash or zsh)")
-    .argument("<shell>", `Shell to generate for (${COMPLETION_SHELLS.join(", ")})`)
+    .description("Print a shell completion script, or install it (bash or zsh)")
+    .argument("<target>", `"install", or a shell to print for (${COMPLETION_SHELLS.join(", ")})`)
+    .argument("[shell]", "with install: limit to one shell (default: detect)")
+    .option("--modify-rc", "with install: authorize adding the zsh eval line to ~/.zshrc")
+    .option("--refresh", "with install: only rewrite artifacts that already exist (used by agend update)")
     .addHelpText("after", `
-Install:
+Recommended:
+  agend completion install          # bash: static file, no rc edit; zsh: prints what to do
+  agend completion install --modify-rc   # also add the zsh line to ~/.zshrc
+
+Manual (fallback):
   bash   echo 'eval "$(agend completion bash)"' >> ~/.bashrc
   zsh    echo 'eval "$(agend completion zsh)"'  >> ~/.zshrc
 
 Then reload the shell. Tab-completes instance names for \`agend attach\` and
 \`agend fleet start|stop|restart\`, and subcommands elsewhere.`)
-    .action((shell) => {
-    if (!COMPLETION_SHELLS.includes(shell)) {
-        console.error(`Unsupported shell: ${shell}. Supported: ${COMPLETION_SHELLS.join(", ")}`);
-        process.exit(2);
-    }
+    .action(async (target, shellArg, opts) => {
     // Subcommand names come from commander itself, so the script can't drift
     // out of sync with the CLI the way a hardcoded list would.
     const fleetCmd = program.commands.find(c => c.name() === "fleet");
-    console.log(completionScript(shell, {
+    const spec = {
         topLevel: program.commands.map(c => c.name()),
         fleetSub: fleetCmd?.commands.map(c => c.name()) ?? [],
         instanceCommands: ["attach"],
         fleetInstanceCommands: ["start", "stop", "restart"],
-    }));
+    };
+    if (target === "install") {
+        const { detectShells, installCompletions } = await import("./completion-install.js");
+        const { zshCompletion } = await import("./completion.js");
+        if (shellArg && !COMPLETION_SHELLS.includes(shellArg)) {
+            console.error(`Unsupported shell: ${shellArg}. Supported: ${COMPLETION_SHELLS.join(", ")}`);
+            process.exit(2);
+        }
+        const shells = shellArg ? [shellArg] : detectShells();
+        if (shells.length === 0) {
+            console.log("  No bash or zsh detected — nothing to install.");
+            return;
+        }
+        const results = installCompletions({ bash: completionScript("bash", spec), zshFpath: zshCompletion(spec, "fpath") }, shells, { modifyRc: opts.modifyRc, refresh: opts.refresh });
+        for (const r of results) {
+            if (r.status === "hint")
+                console.log(`  ${r.shell}: ${r.hint}`);
+            else if (r.status === "skipped") { /* refresh mode, nothing was installed before */ }
+            else
+                console.log(`  ${r.shell}: completion ${r.status}${r.path ? ` (${r.path})` : ""}`);
+        }
+        return;
+    }
+    if (!COMPLETION_SHELLS.includes(target)) {
+        console.error(`Unsupported target: ${target}. Supported: install, ${COMPLETION_SHELLS.join(", ")}`);
+        process.exit(2);
+    }
+    console.log(completionScript(target, spec));
 });
 program
     .command("health").description("Fleet health check — shows problems and diagnostics")