jishushell 0.4.10 → 0.4.24

package/dist/cli.js

@@ -6,801 +6,73 @@ if (process.platform === "darwin") {
     if (missing.length > 0)
         process.env.PATH = [...missing, current].join(":");
 }
-import { existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
-import { exec } from "child_process";
+import { buildDockerClientEnv } from "./utils/docker-host.js";
 if (process.platform === "darwin") {
     const jHome = process.env.JISHUSHELL_HOME || join(homedir(), ".jishushell");
-    const sock = join(jHome, "colima", "jishushell", "docker.sock");
-    if (existsSync(sock))
-        process.env.DOCKER_HOST = `unix://${sock}`;
-}
-import { createServer } from "./server.js";
-import { runInstall, parseInstallArgs } from "./install.js";
-import { startPanel, stopPanel, stopWithJobs, restartPanel, runDoctor, runOnboard, showStatus, resetAll, checkUpdate, runUpdate } from "./control.js";
-const JISHUSHELL_HOME = process.env.JISHUSHELL_HOME || join(homedir(), ".jishushell");
-const NOMAD_BIN = join(JISHUSHELL_HOME, "bin", "nomad");
-const PANEL_PORT = 8090;
-function openBrowser(url) {
-    const platform = process.platform;
-    const cmd = platform === "darwin" ? `open "${url}"`
-        : platform === "win32" ? `start "" "${url}"`
-            : `xdg-open "${url}"`;
-    exec(cmd, () => { });
-}
-const [subcommand, ...rest] = process.argv.slice(2);
-// ── HTTP thin-client helpers for backup commands ───────────────────────────
-async function apiCall(path, opts = {}) {
-    const port = process.env.JISHUSHELL_PORT || "8090";
-    const url = `http://127.0.0.1:${port}/api${path}`;
-    const res = await fetch(url, {
-        method: opts.method || "GET",
-        headers: opts.body ? { "Content-Type": "application/json" } : {},
-        body: opts.body ? JSON.stringify(opts.body) : undefined,
-    });
-    if (!res.ok) {
-        const err = await res.json().catch(() => ({ detail: res.statusText }));
-        throw new Error(err.detail || `HTTP ${res.status}`);
-    }
-    return res.json();
-}
-async function waitForJob(jobId) {
-    while (true) {
-        const job = await apiCall(`/backup/jobs/${jobId}`);
-        if (job.status === "completed")
-            return job;
-        if (job.status === "failed")
-            throw new Error(job.error || "Job failed");
-        process.stdout.write(`\r  ${job.progress || job.status}...`);
-        await new Promise(r => setTimeout(r, 1500));
-    }
-}
-// ── Helper to parse --port from remaining args ─────────────────────────────
-function parsePort(args) {
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === "--port" && args[i + 1]) {
-            const p = parseInt(args[i + 1], 10);
-            if (!isNaN(p) && p > 0 && p < 65536)
-                return p;
-        }
-    }
-    return undefined;
-}
-// ── install subcommand ─────────────────────────────────────────────────────
-if (subcommand === "install") {
-    const opts = parseInstallArgs(rest);
-    runInstall(opts).catch((err) => {
-        console.error("Installation failed:", err);
-        process.exit(1);
-    });
-    // runInstall is async and calls process.exit() itself
-    // ── start ──────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "start") {
-    startPanel(parsePort(rest)).then(() => process.exit(0)).catch((err) => {
-        console.error("start failed:", err.message);
-        process.exit(1);
-    });
-    // ── stop ───────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "stop") {
-    // --jobs: also stop (but not purge) all Nomad jobs before stopping the panel
-    const withJobs = rest.includes("--jobs") || rest.includes("-j");
-    const stopFn = withJobs ? stopWithJobs : stopPanel;
-    stopFn().then(() => process.exit(0)).catch((err) => {
-        console.error("stop failed:", err.message);
-        process.exit(1);
-    });
-    // ── restart ────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "restart") {
-    restartPanel(parsePort(rest)).then(() => process.exit(0)).catch((err) => {
-        console.error("restart failed:", err.message);
-        process.exit(1);
-    });
-    // ── status ─────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "status") {
-    showStatus().then(() => process.exit(0)).catch((err) => {
-        console.error("status failed:", err.message);
-        process.exit(1);
-    });
-    // ── doctor ─────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "doctor") {
-    const fix = rest.includes("--fix") || rest.includes("-f");
-    runDoctor({ fix }).then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
-        console.error("doctor failed:", err.message);
-        process.exit(1);
-    });
-    // ── onboard ────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "onboard") {
-    const force = rest.includes("--force") || rest.includes("-f");
-    runOnboard({ force }).then(() => process.exit(0)).catch((err) => {
-        console.error("onboard failed:", err.message);
-        process.exit(1);
-    });
-    // ── reset ──────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "reset") {
-    const yes = rest.includes("--yes") || rest.includes("-y");
-    resetAll({ yes }).then(() => process.exit(0)).catch((err) => {
-        console.error("reset failed:", err.message);
-        process.exit(1);
-    });
-    // ── update-check ───────────────────────────────────────────────────────────
-}
-else if (subcommand === "update-check") {
-    checkUpdate().then((info) => {
-        console.log(JSON.stringify(info));
-        process.exit(info.hasUpdate ? 0 : 1);
-    }).catch((err) => {
-        console.error("update-check failed:", err.message);
-        process.exit(2);
-    });
-    // ── update-run ─────────────────────────────────────────────────────────────
-}
-else if (subcommand === "update") {
-    runUpdate().then(() => process.exit(0)).catch((err) => {
-        console.error("update-run failed:", err.message);
-        process.exit(1);
-    });
-    // ── pairing: approve / list DM pairing requests inside running containers ──
+    const dockerEnv = buildDockerClientEnv({ jishuHome: jHome });
+    if (dockerEnv.DOCKER_HOST)
+        process.env.DOCKER_HOST = dockerEnv.DOCKER_HOST;
+    else
+        delete process.env.DOCKER_HOST;
+}
+const argv = process.argv.slice(2);
+const [subcommand] = argv;
+const CLI_MODULE_LOADERS = [
+    () => import("./cli/panel.js"),
+    () => import("./cli/doctor.js"),
+    () => import("./cli/job.js"),
+    () => import("./cli/app.js"),
+    () => import("./cli/llm.js"),
+    () => import("./cli/backup.js"),
+];
+function cliError(err) {
+    console.error(err.message || err);
+    process.exit(1);
 }
-else if (subcommand === "pairing") {
-    const action = rest[0];
-    // Parse --instance <id> flag
-    let instanceId;
-    const instIdx = rest.indexOf("--instance");
-    if (instIdx !== -1 && rest[instIdx + 1])
-        instanceId = rest[instIdx + 1];
-    if (action === "list") {
-        const { runPairingList } = await import("./control.js");
-        runPairingList({ instanceId }).then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
-            console.error("pairing list failed:", err.message);
-            process.exit(1);
-        });
-    }
-    else if (action === "approve") {
-        // args after "approve": [channel, code] or [code] (single-arg form)
-        const actionArgs = rest.slice(1).filter((a) => !a.startsWith("--") && a !== instanceId);
-        let channel;
-        let code;
-        if (actionArgs.length >= 2) {
-            [channel, code] = actionArgs;
-        }
-        else if (actionArgs.length === 1) {
-            channel = "feishu";
-            code = actionArgs[0];
-        }
-        else {
-            console.error("Usage: jishushell pairing approve <channel> <code> [--instance <id>]");
-            process.exit(1);
-        }
-        const notify = rest.includes("--notify");
-        const { runPairingApprove } = await import("./control.js");
-        runPairingApprove({ instanceId, channel, code, notify }).then((ok) => process.exit(ok ? 0 : 1)).catch((err) => {
-            console.error("pairing approve failed:", err.message);
-            process.exit(1);
-        });
-    }
-    else {
-        console.log(`
-Usage: jishushell pairing <command> [options]
+async function printTopLevelHelp() {
+    const modules = await Promise.all(CLI_MODULE_LOADERS.map((load) => load()));
+    const briefs = modules
+        .map((module) => module.brief?.())
+        .filter((brief) => Boolean(brief))
+        .join("\n");
+    console.log(`
+JishuShell — 实例管理面板
 
-Commands:
-  list                               列出等待审批的配对请求
-  approve <channel> <code>           审批配对码（例: feishu LVU7PNYK）
-  approve <code>                     默认 channel=feishu 简写形式
+Usage:
+  jishushell <command> [options]
 
-Options:
-  --instance <id>   指定实例 ID（只有一个实例时可省略）
-  --notify          审批后通知申请方
+Commands:
+${briefs}
+  help                                              显示此帮助
 
-Examples:
-  jishushell pairing list
-  jishushell pairing approve feishu LVU7PNYK
-  jishushell pairing approve LVU7PNYK
-  jishushell pairing approve feishu LVU7PNYK --instance my-instance
+运行 'jishushell <command> help' 查看详细用法。
 `);
-        process.exit(1);
-    }
-    // ── serve: foreground server (used by systemd/launchd ExecStart) ──────────
-}
-else if (subcommand === "serve") {
-    const args = rest;
-    let port = PANEL_PORT;
-    let host = "0.0.0.0";
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === "--port" && args[i + 1]) {
-            const parsed = parseInt(args[i + 1], 10);
-            if (isNaN(parsed) || parsed < 1 || parsed > 65535) {
-                console.error(`Invalid port: ${args[i + 1]}. Must be 1-65535.`);
-                process.exit(1);
-            }
-            port = parsed;
-            i++;
-        }
-        else if (args[i] === "--host" && args[i + 1]) {
-            host = args[i + 1];
-            i++;
-        }
-    }
-    createServer({ port, host }).catch((err) => {
-        console.error("serve failed:", err.message);
-        process.exit(1);
-    });
-    // ── uninstall ─────────────────────────────────────────────────────────────
-}
-else if (subcommand === "uninstall") {
-    const yes = rest.includes("--yes") || rest.includes("-y");
-    const { spawnSync } = await import("child_process");
-    const uninstallSh = join(JISHUSHELL_HOME, "install", "post-uninstall.sh");
-    if (!existsSync(uninstallSh)) {
-        console.error(`Uninstall script not found: ${uninstallSh}`);
-        console.error("Please run: sudo bash ~/.jishushell/install/jishu-uninstall.sh --data --yes");
-        process.exit(1);
-    }
-    if (!yes) {
-        const { createInterface } = await import("readline");
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        await new Promise((resolve) => {
-            rl.question("This will stop all services, remove auto-start and delete ~/.jishushell. Continue? [y/N] ", (ans) => {
-                rl.close();
-                if (ans.toLowerCase() !== "y") {
-                    console.log("Cancelled.");
-                    process.exit(0);
-                }
-                resolve();
-            });
-        });
-    }
-    // Step 1: stop services and remove ~/.jishushell via the backed-up script
-    const cleanResult = spawnSync("bash", [uninstallSh], { stdio: "inherit" });
-    // Step 2: remove the npm global package (now ~/.jishushell is already gone)
-    const npmResult = spawnSync("npm", ["uninstall", "-g", "jishushell"], { stdio: "inherit" });
-    process.exit((cleanResult.status ?? 0) || (npmResult.status ?? 0));
-    // ── backup ─────────────────────────────────────────────────────────────────
 }
-else if (subcommand === "backup") {
-    // Handle "backup verify <instance-id> <filename>" subcommand
-    if (rest[0] === "verify") {
-        const instanceId = rest[1];
-        const filename = rest[2];
-        if (!instanceId || !filename) {
-            console.error("Usage: jishushell backup verify <instance-id> <filename>");
-            process.exit(1);
-        }
-        try {
-            const result = await apiCall(`/instances/${instanceId}/backup/verify/${encodeURIComponent(filename)}`, { method: "POST" });
-            console.log(result.valid ? "Verification PASSED." : "Verification FAILED.");
-            for (const check of result.checks || []) {
-                console.log(`  ${check.passed ? "+" : "x"} ${check.name}${check.detail ? ": " + check.detail : ""}`);
-            }
-            if (rest.includes("--json"))
-                console.log(JSON.stringify(result, null, 2));
-        }
-        catch (e) {
-            console.error(`Verify failed: ${e.message}`);
-            process.exit(1);
-        }
-        process.exit(0);
-    }
-    const id = rest[0];
-    if (!id) {
-        console.error("Usage: jishushell backup <id> [--with-sessions] [--only-config] [--state-only] [--no-workspace]");
-        process.exit(1);
-    }
-    const withSessions = rest.includes("--with-sessions");
-    const onlyConfig = rest.includes("--only-config");
-    const stateOnly = rest.includes("--state-only");
-    const noWorkspace = rest.includes("--no-workspace");
-    try {
-        console.log(`Creating backup for ${id}...`);
-        const result = await apiCall(`/instances/${id}/backup`, {
-            method: "POST",
-            body: {
-                include_sessions: withSessions,
-                only_config: onlyConfig,
-                scope: stateOnly ? "state" : "home",
-                // Only send include_workspace when the user explicitly opted out;
-                // otherwise let the backend default (include=true unless only_config).
-                ...(noWorkspace ? { include_workspace: false } : {}),
-            },
-        });
-        if (result.job_id) {
-            const job = await waitForJob(result.job_id);
-            console.log(`\nBackup complete: ${job.result?.filename} (${job.result?.size} bytes)`);
-        }
-        if (rest.includes("--verify") && result.job_id) {
-            const job = await apiCall(`/backup/jobs/${result.job_id}`);
-            if (job.result?.filename) {
-                console.log("Verifying...");
-                const v = await apiCall(`/instances/${id}/backup/verify/${encodeURIComponent(job.result.filename)}`, { method: "POST" });
-                console.log(v.valid ? "Verification passed." : "Verification FAILED.");
-            }
-        }
-    }
-    catch (e) {
-        console.error(`Backup failed: ${e.message}`);
-        process.exit(1);
-    }
+if (!subcommand || subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
+    await printTopLevelHelp();
     process.exit(0);
-    // ── restore ────────────────────────────────────────────────────────────────
 }
-else if (subcommand === "restore") {
-    // Handle restore --new (create new instance from backup, no existing instance ID required)
-    if (rest.includes("--new")) {
-        const fromIdx = rest.indexOf("--from");
-        const idxNewId = rest.indexOf("--id");
-        if (fromIdx !== -1) {
-            // restore --new --from <src-id> --latest|--pick [--id <new-id>]
-            const sourceId = rest[fromIdx + 1];
-            if (!sourceId) {
-                console.error("Usage: jishushell restore --new --from <src-id> --latest|--pick [--id <new-id>]");
-                process.exit(1);
-            }
-            let backups;
-            try {
-                backups = await apiCall(`/instances/${sourceId}/backups`);
-            }
-            catch (e) {
-                console.error(`Restore failed: ${e.message}`);
-                process.exit(1);
-            }
-            if (!backups.length) {
-                console.error("No backups found.");
-                process.exit(1);
-            }
-            let backupFile = "";
-            if (rest.includes("--latest")) {
-                backupFile = backups[0].filename;
-            }
-            else {
-                console.log("Available backups:");
-                backups.forEach((b, i) => {
-                    console.log(`  ${i + 1}. [${b.type}] ${new Date(b.created_at).toLocaleString()} (${(b.size / 1024 / 1024).toFixed(1)}MB)`);
-                });
-                const readline = await import("readline");
-                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-                const answer = await new Promise(r => rl.question("Select number: ", r));
-                rl.close();
-                const idx = parseInt(answer, 10) - 1;
-                if (idx < 0 || idx >= backups.length) {
-                    console.error("Invalid selection.");
-                    process.exit(1);
-                }
-                backupFile = backups[idx].filename;
-            }
-            const newId = idxNewId !== -1 ? rest[idxNewId + 1] : `${sourceId}-copy`;
-            console.log(`Creating new instance ${newId} from ${sourceId}/${backupFile}...`);
-            try {
-                const result = await apiCall("/instances/create-from-backup", {
-                    method: "POST",
-                    body: { source_id: sourceId, backup_file: backupFile, new_id: newId, new_name: newId },
-                });
-                if (result.ok) {
-                    console.log(`Instance created: ${result.instance_id}`);
-                    if (result.warnings?.length)
-                        result.warnings.forEach((w) => console.log(`  Warning: ${w}`));
-                }
-                else {
-                    console.error(`Create from backup failed: ${result.detail || "unknown error"}`);
-                    if (result.warnings?.length)
-                        result.warnings.forEach((w) => console.log(`  Warning: ${w}`));
-                    process.exit(1);
-                }
-            }
-            catch (e) {
-                console.error(`Restore --new failed: ${e.message}`);
-                process.exit(1);
-            }
-        }
-        else {
-            // restore --new <file> [--id <new-id>]
-            const file = rest.find((a) => !a.startsWith("--") && a !== "restore");
-            if (!file) {
-                console.error("Usage: jishushell restore --new <file> [--id <new-id>]");
-                process.exit(1);
-            }
-            console.log("Note: restore --new from local file requires import flow.");
-            console.log(`Use: jishushell import ${file}`);
-        }
-        process.exit(0);
-    }
-    const id = rest[0];
-    if (!id) {
-        console.error("Usage: jishushell restore <id> <--latest|--pick|file>");
-        process.exit(1);
-    }
-    let file = "";
-    if (rest.includes("--latest") || rest.includes("--pick")) {
-        let backups;
-        try {
-            backups = await apiCall(`/instances/${id}/backups`);
-        }
-        catch (e) {
-            console.error(`Restore failed: ${e.message}`);
-            process.exit(1);
-        }
-        if (!backups.length) {
-            console.error("No backups found.");
-            process.exit(1);
-        }
-        if (rest.includes("--latest")) {
-            file = backups[0].filename;
-        }
-        else {
-            console.log("Available backups:");
-            backups.forEach((b, i) => {
-                console.log(`  ${i + 1}. ${b.type} ${new Date(b.created_at).toLocaleString()} (${(b.size / 1024 / 1024).toFixed(1)}MB)`);
-            });
-            const readline = await import("readline");
-            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-            const answer = await new Promise(r => rl.question("Select number: ", r));
-            rl.close();
-            const idx = parseInt(answer, 10) - 1;
-            if (idx < 0 || idx >= backups.length) {
-                console.error("Invalid selection.");
-                process.exit(1);
-            }
-            file = backups[idx].filename;
-        }
-    }
-    else {
-        file = rest[1];
-    }
-    if (!file) {
-        console.error("No backup file specified.");
-        process.exit(1);
-    }
-    try {
-        console.log(`Restoring ${id} from ${file}...`);
-        const result = await apiCall(`/instances/${id}/restore/${encodeURIComponent(file)}`, { method: "POST" });
-        if (result.job_id) {
-            const job = await waitForJob(result.job_id);
-            const r = job.result || {};
-            if (r.ok) {
-                console.log(`\nRestore complete.`);
-                if (r.api_key_status === "lost") {
-                    console.log("Warning: archive was built on a different platform/arch; verify API Key configuration still matches this host.");
-                }
-                if (r.warnings?.length)
-                    r.warnings.forEach((w) => console.log(`  Warning: ${w}`));
-            }
-            else {
-                console.error(`\nRestore failed.${r.rolled_back ? " Auto-rollback completed." : ""}`);
-                if (r.warnings?.length)
-                    r.warnings.forEach((w) => console.log(`  ${w}`));
-            }
-        }
-    }
-    catch (e) {
-        console.error(`Restore failed: ${e.message}`);
-        process.exit(1);
-    }
-    process.exit(0);
-    // ── export ─────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "export") {
-    const id = rest[0];
-    if (!id) {
-        console.error("Usage: jishushell export <id> [--with-sessions]");
-        process.exit(1);
-    }
-    const withSessions = rest.includes("--with-sessions");
-    try {
-        console.log(`Exporting ${id}...`);
-        const result = await apiCall(`/instances/${id}/export`, {
-            method: "POST",
-            body: { include_sessions: withSessions },
-        });
-        if (result.job_id) {
-            const job = await waitForJob(result.job_id);
-            const r = job.result || {};
-            console.log(`\nExport complete: ${r.filename}`);
-            console.log(`Download: http://127.0.0.1:${process.env.JISHUSHELL_PORT || "8090"}/api/instances/${id}/export/download/${encodeURIComponent(r.filename)}`);
-            if (r.warnings?.length)
-                r.warnings.forEach((w) => console.log(`  Warning: ${w}`));
-        }
-    }
-    catch (e) {
-        console.error(`Export failed: ${e.message}`);
-        process.exit(1);
-    }
-    process.exit(0);
-    // ── import ─────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "import") {
-    const file = rest[0];
-    if (!file) {
-        console.error("Usage: jishushell import <file> [--id <id>] [--name <name>]");
-        process.exit(1);
-    }
-    const idIdx = rest.indexOf("--id");
-    const nameIdx = rest.indexOf("--name");
-    const customId = idIdx !== -1 ? rest[idIdx + 1] : undefined;
-    const customName = nameIdx !== -1 ? rest[nameIdx + 1] : undefined;
-    try {
-        const { readFileSync } = await import("fs");
-        const { basename } = await import("path");
-        const port = process.env.JISHUSHELL_PORT || "8090";
-        console.log("Uploading file...");
-        const fileData = readFileSync(file);
-        const boundary = "----JishuShellCLI" + Date.now();
-        const fileName = basename(file);
-        const body = Buffer.concat([
-            Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="${fileName}"\r\nContent-Type: application/gzip\r\n\r\n`),
-            fileData,
-            Buffer.from(`\r\n--${boundary}--\r\n`),
-        ]);
-        const uploadRes = await fetch(`http://127.0.0.1:${port}/api/instances/import/upload`, {
-            method: "POST",
-            headers: { "Content-Type": `multipart/form-data; boundary=${boundary}` },
-            body,
-        });
-        if (!uploadRes.ok) {
-            const err = await uploadRes.json().catch(() => ({ detail: uploadRes.statusText }));
-            throw new Error(err.detail || `Upload failed: ${uploadRes.status}`);
-        }
-        const { temp_id } = await uploadRes.json();
-        console.log("Previewing...");
-        const preview = await apiCall("/instances/import/preview", { method: "POST", body: { temp_id } });
-        console.log(`  Name: ${preview.manifest?.name || "unknown"}`);
-        console.log(`  Type: ${preview.manifest?.type || "unknown"}`);
-        console.log(`  Size: ${((preview.estimated_size || 0) / 1024 / 1024).toFixed(1)}MB`);
-        if (preview.warnings?.length) {
-            for (const w of preview.warnings)
-                console.log(`  Warning: ${w}`);
-        }
-        const instanceId = customId || preview.manifest?.name?.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 63) || `import-${Date.now()}`;
-        const instanceName = customName || preview.manifest?.name || instanceId;
-        console.log(`Creating instance ${instanceId}...`);
-        const result = await apiCall("/instances/import", {
-            method: "POST",
-            body: { temp_id, id: instanceId, name: instanceName },
-        });
-        if (result.ok) {
-            console.log(`Instance created: ${result.instance_id}`);
-            if (result.warnings?.length) {
-                for (const w of result.warnings)
-                    console.log(`  Warning: ${w}`);
-            }
-        }
-        else {
-            console.error(`Import failed: ${result.detail || "unknown error"}`);
-            if (result.warnings?.length) {
-                for (const w of result.warnings)
-                    console.log(`  Warning: ${w}`);
-            }
-            process.exit(1);
-        }
-    }
-    catch (e) {
-        console.error(`Import failed: ${e.message}`);
-        process.exit(1);
-    }
-    process.exit(0);
-    // ── clone ──────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "clone") {
-    const src = rest[0];
-    const newId = rest[1];
-    if (!src || !newId) {
-        console.error("Usage: jishushell clone <src-id> <new-id> [--with-sessions] [--no-memory]");
-        process.exit(1);
-    }
-    const withSessions = rest.includes("--with-sessions");
-    const noMemory = rest.includes("--no-memory");
-    try {
-        console.log(`Cloning ${src} to ${newId}...`);
-        const result = await apiCall("/instances", {
-            method: "POST",
-            body: {
-                id: newId,
-                name: newId,
-                clone_from: src,
-                clone_options: {
-                    include_sessions: withSessions,
-                    include_memory: !noMemory,
-                },
-            },
-        });
-        console.log(`Clone created: ${result.id || newId}`);
-    }
-    catch (e) {
-        console.error(`Clone failed: ${e.message}`);
-        process.exit(1);
-    }
-    process.exit(0);
-    // ── backups ────────────────────────────────────────────────────────────────
-}
-else if (subcommand === "backups") {
-    const sub = rest[0];
-    if (sub === "list") {
-        const id = rest[1];
-        try {
-            if (id) {
-                const backups = await apiCall(`/instances/${id}/backups`);
-                if (!backups.length) {
-                    console.log("No backups.");
-                }
-                else {
-                    backups.forEach((b, i) => {
-                        console.log(`  ${i + 1}. [${b.type}] ${new Date(b.created_at).toLocaleString()} ${(b.size / 1024 / 1024).toFixed(1)}MB ${b.filename}`);
-                    });
-                }
-            }
-            else {
-                const orphans = await apiCall("/backups/orphaned");
-                if (orphans.length) {
-                    console.log("Orphaned backups:");
-                    for (const o of orphans) {
-                        console.log(`  ${o.instance_id}: ${o.backups?.length || 0} files`);
-                    }
-                }
-                else {
-                    console.log("No orphaned backups.");
-                }
-            }
-        }
-        catch (e) {
-            console.error(`backups list failed: ${e.message}`);
-            process.exit(1);
-        }
-    }
-    else if (sub === "clean") {
-        try {
-            const orphans = await apiCall("/backups/orphaned");
-            if (!orphans.length) {
-                console.log("No orphaned backups to clean.");
-                process.exit(0);
-            }
-            const force = rest.includes("--force");
-            console.log(`Found ${orphans.length} orphaned backup(s):`);
-            for (const o of orphans) {
-                console.log(`  ${o.instance_id}: ${o.backups?.length || 0} files`);
-            }
-            if (!force) {
-                const readline = await import("readline");
-                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-                const answer = await new Promise(r => rl.question("Delete all orphaned backups? (y/N): ", r));
-                rl.close();
-                if (answer.toLowerCase() !== "y") {
-                    console.log("Cancelled.");
-                    process.exit(0);
-                }
-            }
-            for (const o of orphans) {
-                for (const b of o.backups || []) {
-                    await apiCall(`/backups/orphaned/${encodeURIComponent(o.instance_id)}/${encodeURIComponent(b.filename)}`, { method: "DELETE" });
-                }
-                console.log(`  Cleaned: ${o.instance_id}`);
-            }
-            console.log("Done.");
-        }
-        catch (e) {
-            console.error(`backups clean failed: ${e.message}`);
-            process.exit(1);
-        }
-    }
-    else {
-        console.error("Usage: jishushell backups list [id]\n       jishushell backups clean [--force]");
-        process.exit(1);
-    }
-    process.exit(0);
-    // ── auto-backup ────────────────────────────────────────────────────────────
-}
-else if (subcommand === "auto-backup") {
-    const id = rest[0];
-    const action = rest[1];
-    if (!id || !action) {
-        console.error("Usage: jishushell auto-backup <id> enable|disable|status");
-        process.exit(1);
-    }
+let handled = false;
+for (const load of CLI_MODULE_LOADERS) {
     try {
-        if (action === "status") {
-            const config = await apiCall(`/instances/${id}/auto-backup`);
-            console.log(JSON.stringify(config, null, 2));
-        }
-        else if (action === "enable") {
-            const interval = parseInt(rest[rest.indexOf("--interval") + 1], 10) || 24;
-            const keep = parseInt(rest[rest.indexOf("--keep") + 1], 10) || 7;
-            await apiCall(`/instances/${id}/auto-backup`, { method: "PUT", body: { enabled: true, interval_hours: interval, keep_count: keep } });
-            console.log(`Auto-backup enabled for ${id} (every ${interval}h, keep ${keep})`);
-        }
-        else if (action === "disable") {
-            await apiCall(`/instances/${id}/auto-backup`, { method: "PUT", body: { enabled: false } });
-            console.log(`Auto-backup disabled for ${id}`);
-        }
-        else {
-            console.error(`Unknown action: ${action}. Use enable|disable|status`);
-            process.exit(1);
+        const module = await load();
+        if (await module.dispatch(argv)) {
+            handled = true;
+            break;
         }
     }
-    catch (e) {
-        console.error(`auto-backup failed: ${e.message}`);
-        process.exit(1);
+    catch (err) {
+        cliError(err);
     }
-    process.exit(0);
-    // ── help ───────────────────────────────────────────────────────────────────
 }
-else if (!subcommand || subcommand === "help" || subcommand === "--help" || subcommand === "-h") {
-    console.log(`
-JishuShell — OpenClaw 实例管理面板
-
-Usage:
-  jishushell                       前台启动面板服务器
-  jishushell <command> [options]
-
-Commands:
-  status                           显示各模块运行状态（面板、Docker、Nomad 及所有 Job）
-  serve [--port N] [--host H]       前台启动面板服务器（供 systemd/launchd 使用）
-  start [--port N]                 在后台启动面板
-  stop [--jobs]                    停止面板；加 --jobs 同时停止所有 Nomad Job
-  restart [--port N]               重启面板
-  doctor                           检查所有组件健康状态
-  doctor --fix                     检查并尝试自动修复问题
-  onboard [--force]                首次引导：设置管理员密码
-  reset [--yes]                    重置配置与所有 Nomad Job（保留实例数据目录）
-  uninstall [--yes]                停止服务、删除 ~/.jishushell 并卸载 npm 包
-  update-check                     检查是否有新版本（0=有新版本，1=已是最新）
-  update                           安装最新版本并重启面板
-  install [options]                安装依赖并配置 JishuShell
-  llm list                         列出已配置的 LLM provider
-  llm add <name> <url> <key>       新增 LLM provider
-  llm update <name> <url> <key>    更新 LLM provider
-  llm delete <name>                删除 LLM provider
-  llm set-default <name>           设置默认 LLM provider
-  llm help                         LLM 子命令帮助
-  job list                         列出所有实例及运行状态
-  job status <id>                  查看实例详细状态
-  job start/stop/restart <id>      启停实例
-  job logs <id>                    查看实例日志
-  job exec <id> -- <cmd>           在容器内执行命令
-  pairing list                     列出等待审批的 DM 配对请求
-  pairing approve <ch> <code>      审批飞书/Lark 配对码（在容器内执行）
-  backup <id> [--with-sessions] [--only-config]  备份实例（加 --verify 校验完整性）
-  backup verify <id> <filename>    校验备份文件完整性
-  restore <id> <--latest|--pick|file>  从备份文件还原实例
-  restore --new --from <src-id> --latest|--pick [--id <new-id>]  从备份创建新实例
-  export <id> [--with-sessions]    导出实例为可迁移归档包
-  import <file> [--id <id>] [--name <name>]  导入归档包为新实例
-  clone <src-id> <new-id> [--with-sessions] [--no-memory]  克隆实例
-  backups list [id]                列出备份（不指定 id 则列孤立备份）
-  backups clean [--force]          清理孤立备份文件
-  auto-backup <id> enable|disable|status  管理定时自动备份
-  help                             显示此帮助信息
-
-Server options:
-  --port <port>    监听端口（默认 8090 或 panel.json 中的值）
-  --host <host>    监听地址（默认 0.0.0.0）
-
-Install options:
-  --port <port>    面板端口（默认 8090）
-  --yes, -y        跳过所有交互提示（非交互模式）
-  --no-service     跳过 systemd/launchd 注册
-  --skip-docker    跳过 Docker 安装
-  --skip-nomad     跳过 Nomad 安装
-  --skip-openclaw  跳过 OpenClaw 安装
-  --force, -f      即使已配置也强制重新安装
-  --dry-run, -n    预演，不实际执行任何变更
-
-Examples:
-  jishushell status               # 查看当前所有组件状态
-  jishushell start                # 后台启动面板
-  jishushell stop --jobs          # 停止面板及所有实例 Job
-  jishushell restart              # 重启面板
-  jishushell doctor --fix         # 检查并自动修复
-  jishushell reset --yes          # 非交互式重置（CI 场景）
-`);
-    process.exit(0);
-    // ── unknown command ────────────────────────────────────────────────────────
+if (handled) {
+    // Let long-running commands like `serve` keep the event loop alive naturally.
 }
 else {
-    console.error(`Unknown command: ${subcommand}\nRun 'jishushell help' for usage.`);
+    console.error(`Unknown command: ${subcommand}`);
+    await printTopLevelHelp();
     process.exit(1);
 }
 //# sourceMappingURL=cli.js.map