botmux 2.13.2 → 2.15.0

package/dist/setup/detect-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-platform.d.ts","sourceRoot":"","sources":["../../src/setup/detect-platform.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,QAAQ,GAChB,QAAQ,GAAG,QAAQ,GACnB,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GACpD,MAAM,GAAG,SAAS,GAClB,QAAQ,GACR,UAAU,GAAG,eAAe,GAAG,qBAAqB,GACpD,SAAS,CAAC;AAEd,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,OAAO,GACP,KAAK,GACL,KAAK,GAAG,KAAK,GACb,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,MAAM,EAAE,QAAQ,CAAC;IACjB,uEAAuE;IACvE,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AA8GD,wBAAgB,cAAc,IAAI,YAAY,CAY7C"}

package/dist/setup/detect-platform.js

@@ -0,0 +1,139 @@
+/**
+ * Platform / package-manager detection for the auto-install flow.
+ *
+ * All probes are best-effort and synchronous; failures degrade gracefully
+ * to "unknown" so callers can route to a manual-install message.
+ */
+import { execSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+function which(cmd) {
+    try {
+        execSync(`command -v ${cmd}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readOsRelease() {
+    try {
+        const raw = readFileSync('/etc/os-release', 'utf-8');
+        const out = {};
+        for (const line of raw.split('\n')) {
+            const m = line.match(/^([A-Z_]+)=(.*)$/);
+            if (!m)
+                continue;
+            let val = m[2];
+            if (val.startsWith('"') && val.endsWith('"'))
+                val = val.slice(1, -1);
+            out[m[1]] = val;
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+function detectDistro() {
+    if (process.platform !== 'linux')
+        return 'unknown';
+    const rel = readOsRelease();
+    const id = (rel['ID'] ?? '').toLowerCase();
+    const idLike = (rel['ID_LIKE'] ?? '').toLowerCase();
+    const candidates = [id, ...idLike.split(/\s+/)].filter(Boolean);
+    for (const c of candidates) {
+        if (c === 'debian' || c === 'ubuntu')
+            return c;
+        if (c === 'fedora' || c === 'rhel' || c === 'centos' || c === 'rocky' || c === 'almalinux') {
+            return c;
+        }
+        if (c === 'arch' || c === 'manjaro')
+            return c;
+        if (c === 'alpine')
+            return 'alpine';
+        if (c === 'opensuse' || c === 'opensuse-leap' || c === 'opensuse-tumbleweed')
+            return c;
+    }
+    return 'unknown';
+}
+function detectPackageManagers(distro) {
+    const out = [];
+    // User-scope managers first. brew on Linux works the same as on macOS.
+    if (which('brew'))
+        out.push('brew');
+    if (which('conda') || which('mamba'))
+        out.push('conda');
+    // System managers — order by distro preference, but only include if the binary is present.
+    if (process.platform === 'linux') {
+        const tryAdd = (bin, pm) => {
+            if (which(bin))
+                out.push(pm);
+        };
+        switch (distro) {
+            case 'debian':
+            case 'ubuntu':
+                tryAdd('apt-get', 'apt');
+                break;
+            case 'fedora':
+            case 'rhel':
+            case 'centos':
+            case 'rocky':
+            case 'almalinux':
+                tryAdd('dnf', 'dnf');
+                if (!out.includes('dnf'))
+                    tryAdd('yum', 'yum');
+                break;
+            case 'arch':
+            case 'manjaro':
+                tryAdd('pacman', 'pacman');
+                break;
+            case 'alpine':
+                tryAdd('apk', 'apk');
+                break;
+            case 'opensuse':
+            case 'opensuse-leap':
+            case 'opensuse-tumbleweed':
+                tryAdd('zypper', 'zypper');
+                break;
+            default:
+                // Unknown distro — try generic probes so we still pick something up.
+                for (const [bin, pm] of [
+                    ['apt-get', 'apt'], ['dnf', 'dnf'], ['yum', 'yum'],
+                    ['pacman', 'pacman'], ['apk', 'apk'], ['zypper', 'zypper'],
+                ]) {
+                    if (which(bin))
+                        out.push(pm);
+                }
+        }
+    }
+    if (out.length === 0)
+        out.push('unknown');
+    return out;
+}
+function detectPasswordlessSudo() {
+    if (process.getuid && process.getuid() === 0)
+        return true; // already root
+    if (!which('sudo'))
+        return false;
+    try {
+        execSync('sudo -n true', { stdio: 'ignore', timeout: 3000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function detectPlatform() {
+    const os = process.platform === 'darwin' ? 'darwin'
+        : process.platform === 'linux' ? 'linux' : 'other';
+    const distro = detectDistro();
+    return {
+        os,
+        distro,
+        packageManagers: detectPackageManagers(distro),
+        isRoot: !!(process.getuid && process.getuid() === 0),
+        hasTty: !!(process.stdin.isTTY && process.stdout.isTTY),
+        passwordlessSudo: detectPasswordlessSudo(),
+    };
+}
+//# sourceMappingURL=detect-platform.js.map

package/dist/setup/detect-platform.js.map

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

package/dist/setup/ensure-fonts.d.ts

@@ -0,0 +1,13 @@
+import { type PlatformInfo } from './detect-platform.js';
+export interface FontResult {
+    /** The directory we downloaded into (or would have, if any download was needed). */
+    fontDir: string;
+    /** Categories we successfully ensured (system OR downloaded). */
+    ready: string[];
+    /** Categories we failed to ensure (download failed, etc.). Non-fatal. */
+    failed: string[];
+}
+/** Public: paths the screenshot-renderer should also probe. */
+export declare function botmuxFontDir(): string;
+export declare function ensureFonts(info?: PlatformInfo): Promise<FontResult>;
+//# sourceMappingURL=ensure-fonts.d.ts.map

package/dist/setup/ensure-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-fonts.d.ts","sourceRoot":"","sources":["../../src/setup/ensure-fonts.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAkFD,+DAA+D;AAC/D,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AA8FD,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAyB1E"}

package/dist/setup/ensure-fonts.js

@@ -0,0 +1,225 @@
+/**
+ * Ensure the screenshot-renderer (`@napi-rs/canvas`) has CJK / Latin / emoji
+ * fonts available. Downloads missing categories from GitHub release
+ * artifacts to `~/.botmux/fonts/` so registration (`GlobalFonts.registerFromPath`)
+ * can find them at runtime.
+ *
+ * macOS is skipped entirely — PingFang + Menlo + Apple Color Emoji are
+ * preinstalled.
+ *
+ * Failures are NOT fatal: missing fonts only degrade the screenshot rendered
+ * for Lark (CJK becomes tofu, emoji becomes monochrome). The daemon should
+ * still come up. Tmux is the load-bearing dep, fonts are nice-to-have.
+ */
+import { existsSync, mkdirSync, createWriteStream, statSync, unlinkSync, renameSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { get as httpsGet } from 'node:https';
+import { detectPlatform } from './detect-platform.js';
+const FONT_DIR = join(homedir(), '.botmux', 'fonts');
+/** Download targets — pinned to specific release tags so the URLs don't rot.
+ *
+ *  Sources (all permissive licenses, GitHub-hosted):
+ *  - notofonts/noto-cjk @ Sans2.004 (Mono variant) — OFL
+ *  - JetBrains/JetBrainsMono @ v2.304 — Apache 2.0 (replaces DejaVu since
+ *    DejaVu only ships .tar.bz2 release artifacts, not individual TTFs)
+ *  - googlefonts/noto-emoji @ v2.047 — OFL
+ */
+const FONT_SPECS = [
+    {
+        category: 'CJK',
+        files: [
+            {
+                name: 'NotoSansMonoCJKsc-Regular.otf',
+                url: 'https://github.com/notofonts/noto-cjk/raw/Sans2.004/Sans/Mono/NotoSansMonoCJKsc-Regular.otf',
+                minBytes: 1_000_000,
+            },
+            {
+                name: 'NotoSansMonoCJKsc-Bold.otf',
+                url: 'https://github.com/notofonts/noto-cjk/raw/Sans2.004/Sans/Mono/NotoSansMonoCJKsc-Bold.otf',
+                minBytes: 1_000_000,
+            },
+        ],
+        systemPaths: [
+            '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc',
+            '/usr/share/fonts/noto-cjk/NotoSansCJK-Regular.ttc',
+            '/usr/share/fonts/google-noto-cjk/NotoSansCJK-Regular.ttc',
+            '/usr/share/fonts/opentype/noto/NotoSansMonoCJK-Regular.ttc',
+        ],
+    },
+    {
+        category: 'Latin',
+        files: [
+            {
+                name: 'JetBrainsMono-Regular.ttf',
+                url: 'https://github.com/JetBrains/JetBrainsMono/raw/v2.304/fonts/ttf/JetBrainsMono-Regular.ttf',
+                minBytes: 100_000,
+            },
+            {
+                name: 'JetBrainsMono-Bold.ttf',
+                url: 'https://github.com/JetBrains/JetBrainsMono/raw/v2.304/fonts/ttf/JetBrainsMono-Bold.ttf',
+                minBytes: 100_000,
+            },
+        ],
+        systemPaths: [
+            '/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf',
+            '/usr/share/fonts/dejavu/DejaVuSansMono.ttf',
+            '/usr/share/fonts/truetype/liberation/LiberationMono-Regular.ttf',
+            '/usr/share/fonts/liberation/LiberationMono-Regular.ttf',
+            '/usr/share/fonts/truetype/jetbrains-mono/JetBrainsMono-Regular.ttf',
+        ],
+    },
+    {
+        category: 'Emoji',
+        files: [
+            {
+                name: 'NotoColorEmoji.ttf',
+                url: 'https://github.com/googlefonts/noto-emoji/raw/v2.047/fonts/NotoColorEmoji.ttf',
+                minBytes: 5_000_000,
+            },
+        ],
+        systemPaths: [
+            '/usr/share/fonts/truetype/noto/NotoColorEmoji.ttf',
+            '/usr/share/fonts/noto/NotoColorEmoji.ttf',
+            '/usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf',
+        ],
+    },
+];
+/** Public: paths the screenshot-renderer should also probe. */
+export function botmuxFontDir() {
+    return FONT_DIR;
+}
+function categoryAlreadyOk(spec) {
+    // 1. System path present?
+    if (spec.systemPaths.some(p => existsSync(p)))
+        return true;
+    // 2. We already downloaded it on a prior run?
+    return spec.files.every(f => {
+        const p = join(FONT_DIR, f.name);
+        if (!existsSync(p))
+            return false;
+        try {
+            return statSync(p).size >= f.minBytes;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** Download a URL to disk, following redirects (GitHub raw → CDN).
+ *  All FONT_SPECS URLs are https, so we don't bother with an http fallback.
+ *  Hard timeout (default 60s) covers connect + transfer; on expiry the
+ *  request is destroyed and the partial file is unlinked. */
+function downloadFile(url, destPath, timeoutMs = 60_000) {
+    return new Promise((resolve, reject) => {
+        const tmp = destPath + '.part';
+        let settled = false;
+        let activeReq = null;
+        const cleanup = () => {
+            try {
+                unlinkSync(tmp);
+            }
+            catch { /* may not exist */ }
+        };
+        const finish = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (activeReq)
+                try {
+                    activeReq.destroy();
+                }
+                catch { /* ignore */ }
+            if (err) {
+                cleanup();
+                reject(err);
+            }
+            else
+                resolve();
+        };
+        const timer = setTimeout(() => finish(new Error(`下载超时 (${timeoutMs}ms): ${url}`)), timeoutMs);
+        const followRedirect = (current, hops) => {
+            if (hops > 5)
+                return finish(new Error(`太多重定向: ${url}`));
+            const u = new URL(current);
+            if (u.protocol !== 'https:')
+                return finish(new Error(`仅支持 https://, got ${u.protocol} for ${current}`));
+            activeReq = httpsGet(u, { headers: { 'user-agent': 'botmux-font-installer' } }, (res) => {
+                if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                    res.resume();
+                    followRedirect(new URL(res.headers.location, u).toString(), hops + 1);
+                    return;
+                }
+                if (res.statusCode !== 200) {
+                    res.resume();
+                    return finish(new Error(`HTTP ${res.statusCode} for ${current}`));
+                }
+                const out = createWriteStream(tmp);
+                res.pipe(out);
+                out.on('error', (err) => finish(err));
+                out.on('finish', () => {
+                    out.close(() => {
+                        try {
+                            renameSync(tmp, destPath);
+                            finish();
+                        }
+                        catch (err) {
+                            finish(err);
+                        }
+                    });
+                });
+            });
+            activeReq.on('error', (err) => finish(err));
+        };
+        followRedirect(url, 0);
+    });
+}
+async function downloadCategory(spec) {
+    if (!existsSync(FONT_DIR))
+        mkdirSync(FONT_DIR, { recursive: true });
+    for (const f of spec.files) {
+        const dest = join(FONT_DIR, f.name);
+        // Skip if already present and big enough.
+        try {
+            if (existsSync(dest) && statSync(dest).size >= f.minBytes)
+                continue;
+        }
+        catch { /* fall through to redownload */ }
+        console.log(`   下载 ${spec.category}: ${f.name} ...`);
+        await downloadFile(f.url, dest);
+        const sz = statSync(dest).size;
+        if (sz < f.minBytes) {
+            try {
+                unlinkSync(dest);
+            }
+            catch { /* ignore */ }
+            throw new Error(`${f.name} 下载完毕但大小异常 (${sz} < ${f.minBytes})`);
+        }
+    }
+}
+export async function ensureFonts(info) {
+    const platform = info ?? detectPlatform();
+    const result = { fontDir: FONT_DIR, ready: [], failed: [] };
+    // macOS: skip — system fonts cover everything we need.
+    if (platform.os === 'darwin') {
+        result.ready.push('CJK', 'Latin', 'Emoji');
+        return result;
+    }
+    for (const spec of FONT_SPECS) {
+        if (categoryAlreadyOk(spec)) {
+            result.ready.push(spec.category);
+            continue;
+        }
+        try {
+            await downloadCategory(spec);
+            result.ready.push(spec.category);
+        }
+        catch (err) {
+            console.warn(`⚠️  字体下载失败 [${spec.category}]: ${err?.message ?? err}`);
+            result.failed.push(spec.category);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=ensure-fonts.js.map

package/dist/setup/ensure-fonts.js.map

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

package/dist/setup/ensure-tmux.d.ts

@@ -0,0 +1,11 @@
+import { type PackageManager, type PlatformInfo } from './detect-platform.js';
+export interface TmuxResult {
+    installed: boolean;
+    version?: string;
+    /** True iff we ran an installer (vs. tmux was already present). */
+    freshInstall: boolean;
+    /** Which strategy actually ran the install. */
+    strategy?: PackageManager;
+}
+export declare function ensureTmux(info?: PlatformInfo): Promise<TmuxResult>;
+//# sourceMappingURL=ensure-tmux.d.ts.map

package/dist/setup/ensure-tmux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-tmux.d.ts","sourceRoot":"","sources":["../../src/setup/ensure-tmux.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE9F,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA0ED,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CA2DzE"}

package/dist/setup/ensure-tmux.js

@@ -0,0 +1,151 @@
+/**
+ * Ensure tmux is installed before the daemon starts. Strategy (first one
+ * that fits wins):
+ *
+ *   1. Already installed → done.
+ *   2. brew available → `brew install tmux` (no sudo)
+ *   3. conda/mamba available → `conda install -y -c conda-forge tmux` (no sudo)
+ *   4. Linux + system pkg manager:
+ *        a. NOPASSWD sudo or running as root → run non-interactively
+ *        b. Has TTY → run interactively (sudo will prompt for password)
+ *        c. No TTY (autostart / pm2 fork) → skip and throw with manual command
+ *   5. Otherwise → throw with manual command.
+ *
+ * The caller (cli.ts) treats a thrown error as fatal: tmux is non-negotiable
+ * for the /adopt + multi-pane Web terminal experience, and the user explicitly
+ * opted into hard-fail-on-missing.
+ */
+import { execSync, spawnSync } from 'node:child_process';
+import { detectPlatform } from './detect-platform.js';
+function probeTmuxVersion() {
+    try {
+        const out = execSync('tmux -V', { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 3000 });
+        return out.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Wrap a system command with the appropriate sudo prefix for the current
+ *  platform context, or return undefined if we cannot escalate (no
+ *  passwordless sudo and no TTY to prompt on). */
+function sudoPrefix(cmd, info) {
+    if (info.isRoot)
+        return cmd;
+    if (info.passwordlessSudo)
+        return ['sudo', '-n', ...cmd];
+    if (info.hasTty)
+        return ['sudo', ...cmd];
+    return undefined;
+}
+/** Build the install argv for a given package manager. Pure: returns argv[]
+ *  ready for spawnSync, no side effects. Returns undefined if escalation
+ *  isn't possible. */
+function buildInstallArgv(pm, pkg, info) {
+    switch (pm) {
+        case 'brew': return ['brew', 'install', pkg];
+        case 'conda': return ['conda', 'install', '-y', '-c', 'conda-forge', pkg];
+        case 'apt': return sudoPrefix(['apt-get', 'install', '-y', pkg], info);
+        case 'dnf': return sudoPrefix(['dnf', 'install', '-y', pkg], info);
+        case 'yum': return sudoPrefix(['yum', 'install', '-y', pkg], info);
+        case 'pacman': return sudoPrefix(['pacman', '-S', '--noconfirm', pkg], info);
+        case 'apk': return sudoPrefix(['apk', 'add', pkg], info);
+        case 'zypper': return sudoPrefix(['zypper', 'install', '-y', pkg], info);
+        case 'unknown': return undefined;
+    }
+}
+/** apt-get specifically needs an updated package list on minimal images
+ *  before the install will find tmux. This is NOT part of buildInstallArgv
+ *  (which is pure) — it runs once just before the apt install attempt.
+ *  Failure here is non-fatal; the actual install will fail loudly if it
+ *  can't find the package. */
+function aptUpdateBeforeInstall(info) {
+    const argv = sudoPrefix(['apt-get', 'update'], info);
+    if (!argv)
+        return;
+    try {
+        spawnSync(argv[0], argv.slice(1), { stdio: 'inherit', timeout: 120_000 });
+    }
+    catch { /* best-effort */ }
+}
+/** Suggest the manual command we'd have run, for the failure message. */
+function suggestManualCommand(pm, pkg) {
+    switch (pm) {
+        case 'brew': return `brew install ${pkg}`;
+        case 'conda': return `conda install -y -c conda-forge ${pkg}`;
+        case 'apt': return `sudo apt-get update && sudo apt-get install -y ${pkg}`;
+        case 'dnf': return `sudo dnf install -y ${pkg}`;
+        case 'yum': return `sudo yum install -y ${pkg}`;
+        case 'pacman': return `sudo pacman -S --noconfirm ${pkg}`;
+        case 'apk': return `sudo apk add ${pkg}`;
+        case 'zypper': return `sudo zypper install -y ${pkg}`;
+        default: return `(请手动安装 ${pkg})`;
+    }
+}
+function runInstall(argv) {
+    const result = spawnSync(argv[0], argv.slice(1), {
+        stdio: 'inherit',
+        timeout: 10 * 60_000, // 10 min — apt-get on slow networks
+    });
+    return result.status === 0;
+}
+export async function ensureTmux(info) {
+    const platform = info ?? detectPlatform();
+    // Step 1: already installed?
+    const existing = probeTmuxVersion();
+    if (existing) {
+        return { installed: true, version: existing, freshInstall: false };
+    }
+    console.log('⚠️  tmux 未检测到，正在安装...');
+    // Step 2..4: walk the package-manager preference list.
+    const tried = [];
+    for (const pm of platform.packageManagers) {
+        if (pm === 'unknown')
+            continue;
+        const argv = buildInstallArgv(pm, 'tmux', platform);
+        if (!argv) {
+            tried.push(`${pm}（跳过：当前用户无 sudo 且无 TTY）`);
+            continue;
+        }
+        if (pm === 'apt')
+            aptUpdateBeforeInstall(platform);
+        console.log(`   尝试 ${pm}: ${argv.join(' ')}`);
+        if (runInstall(argv)) {
+            const v = probeTmuxVersion();
+            if (v) {
+                console.log(`✅ tmux ${v} 安装完成 (via ${pm})`);
+                return { installed: true, version: v, freshInstall: true, strategy: pm };
+            }
+            tried.push(`${pm}（命令成功但 tmux -V 仍失败）`);
+        }
+        else {
+            tried.push(`${pm}（命令返回非零）`);
+        }
+    }
+    // Build a useful failure message with the most relevant manual command.
+    const preferred = platform.packageManagers.find(p => p !== 'unknown') ?? 'unknown';
+    const manual = suggestManualCommand(preferred, 'tmux');
+    const lines = [
+        '❌ 自动安装 tmux 失败',
+        '',
+        '已尝试：',
+        ...tried.map(t => `  - ${t}`),
+        '',
+        '请手动安装后重试：',
+        `  ${manual}`,
+    ];
+    // macOS without Homebrew → guide the user to install brew first.
+    if (platform.os === 'darwin' && !platform.packageManagers.includes('brew')) {
+        lines.push('');
+        lines.push('macOS 推荐先安装 Homebrew：');
+        lines.push('  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"');
+        lines.push('安装完成后重试 `botmux start`，会走 brew 自动装 tmux。');
+    }
+    if (!platform.hasTty && !platform.isRoot && !platform.passwordlessSudo && platform.os === 'linux') {
+        lines.push('');
+        lines.push('提示：当前不是交互式 TTY 且 sudo 需要密码，systemd/pm2 自启场景下无法弹密码。');
+        lines.push('请在 shell 中手动跑一次 `botmux start`，或配置 NOPASSWD sudoers 后再启用 autostart。');
+    }
+    throw new Error(lines.join('\n'));
+}
+//# sourceMappingURL=ensure-tmux.js.map

package/dist/setup/ensure-tmux.js.map

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

package/dist/setup/index.d.ts

@@ -0,0 +1,9 @@
+import { type TmuxResult } from './ensure-tmux.js';
+import { type FontResult } from './ensure-fonts.js';
+export interface DependenciesReport {
+    tmux: TmuxResult;
+    fonts: FontResult;
+}
+export { botmuxFontDir } from './ensure-fonts.js';
+export declare function ensureDependencies(): Promise<DependenciesReport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/setup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAsBtE"}

package/dist/setup/index.js

@@ -0,0 +1,35 @@
+/**
+ * Dependency bootstrap. Called from `botmux start` and `botmux restart` so
+ * a fresh machine that just `npm i -g botmux`'d gets tmux + screenshot fonts
+ * provisioned without manual setup.
+ *
+ * - tmux is required: a failed install throws so cli.ts can exit non-zero.
+ * - fonts are nice-to-have: failures only print a warning.
+ */
+import { detectPlatform } from './detect-platform.js';
+import { ensureTmux } from './ensure-tmux.js';
+import { ensureFonts } from './ensure-fonts.js';
+export { botmuxFontDir } from './ensure-fonts.js';
+export async function ensureDependencies() {
+    const platform = detectPlatform();
+    // tmux first — it's the load-bearing dep. Throws on failure.
+    const tmux = await ensureTmux(platform);
+    if (!tmux.freshInstall) {
+        console.log(`✓ tmux ${tmux.version} (existing)`);
+    }
+    // Fonts second — best-effort.
+    const fonts = await ensureFonts(platform);
+    if (fonts.failed.length === 0) {
+        if (platform.os === 'darwin') {
+            console.log('✓ 字体: 系统字体已就绪 (macOS)');
+        }
+        else {
+            console.log(`✓ 字体: ${fonts.ready.join(' / ')} 已就绪`);
+        }
+    }
+    else {
+        console.warn(`⚠️  字体部分缺失: ${fonts.failed.join(' / ')} —— 飞书截图中相关字符可能渲染为方块`);
+    }
+    return { tmux, fonts };
+}
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAmB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AAOjE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,6DAA6D;IAC7D,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;IACnD,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}