onadit 0.0.1 → 0.1.0-beta.45

package/dist/src/cli/commands/menubar.js

@@ -0,0 +1,585 @@
+/**
+ * `onadit menubar install` — install/refresh the SwiftBar heartbeat plugin AND
+ * make it actually visible.
+ *
+ * The menu surface lives in `operator/swiftbar/` because it is a tiny
+ * operator-adjacent script, but beta users should not have to wire repo paths
+ * by hand. This command installs a self-contained COPY of the wrapper AND the
+ * renderer into SwiftBar's plugin folder (the default). Copy — not symlink —
+ * because a symlink points back into the package root, which npm/Homebrew can
+ * move or delete on update (and a temp-prefix install would point at a dir
+ * that vanishes), leaving SwiftBar running a dangling `rift.10s.sh`. The
+ * wrapper already self-resolves the renderer beside itself and the `rift` CLI
+ * from absolute system paths, so the copied pair depends on nothing under the
+ * package. `--symlink` keeps the old dev/auto-update behavior for checkouts.
+ * Writes are atomic (temp + rename) so SwiftBar's 10s poll never reads a
+ * half-written file. `onadit update` / postinstall re-run this, so the copy
+ * stays fresh and any pre-migration dangling symlink self-heals.
+ *
+ * Dropping the plugin file is necessary but NOT sufficient for the icon to
+ * appear (this was the beta.20 first-run bug): SwiftBar is a separate app, and
+ * if it is not installed, or installed but never launched, the friend sees
+ * nothing. So this command now also:
+ *   1. resolves SwiftBar's REAL plugin directory (`defaults read … PluginDirectory`)
+ *      and installs into it, configuring the default the first time so a fresh
+ *      SwiftBar reads our plugin instead of prompting the user to pick a folder;
+ *   2. launches (or refreshes) SwiftBar when the app is present, so the icon
+ *      shows without a second manual step;
+ *   3. when SwiftBar is missing, returns a structured, non-fatal recovery
+ *      action (`brew install --cask swiftbar`, or a direct download) instead of
+ *      silently "succeeding" with no visible menu.
+ *
+ * Every system side effect (reading/writing SwiftBar defaults, launching the
+ * app, detecting Homebrew) goes through an injectable `MenuBarHost` so the
+ * behavior is unit-testable without touching the real machine.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { printError, printJson, printText } from "../output.js";
+export const SWIFTBAR_PLUGIN_NAME = "rift.10s.sh";
+export const SWIFTBAR_RENDERER_NAME = "render-menu.py";
+/**
+ * Private subdir the renderer is copied into so SwiftBar never loads the helper
+ * as a phantom (off-screen) top-level plugin. SwiftBar ignores subdirectories
+ * AND dotfiles, so a dot-prefixed subdir is doubly out of its plugin scan.
+ * MUST match the path resolved in `operator/swiftbar/rift.10s.sh`.
+ */
+export const SWIFTBAR_RENDERER_SUBDIR = ".rift-menu";
+/**
+ * Private subdir replaced plugins are backed up into. Like the renderer subdir,
+ * a dot-prefixed directory is doubly out of SwiftBar's plugin scan (it ignores
+ * subdirectories AND dotfiles), so a backup never reappears as a phantom
+ * `rift.10s.sh.bak.<ts>` menu item — the beta.25 upgrade bug. (The old code
+ * dropped backups top-level in the watched folder, where SwiftBar's `name.<n>.<ext>`
+ * parse still recognized them.)
+ */
+export const SWIFTBAR_BACKUP_SUBDIR = ".rift-backups";
+/** SwiftBar's macOS preferences domain (used for `defaults` reads/writes). */
+export const SWIFTBAR_DEFAULTS_DOMAIN = "com.ameba.SwiftBar";
+const SWIFTBAR_DOWNLOAD_URL = "https://swiftbar.app";
+/**
+ * Seeded into `NSStatusItem Preferred Position <plugin>` when the item has no
+ * slot, so a fresh/recreated status item lands on the visible bar instead of
+ * being parked off-screen by a menu-bar manager (or macOS notch overflow) —
+ * the beta.24 "icon vanished after update" bug.
+ * ponytail: fixed heuristic (proven on a notched MacBook); the user can
+ * ⌘-drag to taste — the point is that it is non-null so the item isn't parked.
+ */
+const SWIFTBAR_DEFAULT_POSITION = 350;
+export function makeMenuBarCommand() {
+    const cmd = new Command("menubar").description("Install and manage the Onadit menu bar");
+    cmd
+        .command("install")
+        .description("Install or refresh the SwiftBar menu plugin")
+        .option("--plugin-dir <path>", "Override SwiftBar's plugin directory")
+        .option("--symlink", "Symlink to the packaged files instead of copying (dev checkouts; fragile if the package moves)")
+        .option("--yes", "Non-interactive install; accepted for install scripts")
+        .action((opts, command) => {
+        const globalOpts = command.optsWithGlobals();
+        let result;
+        try {
+            const installOpts = {};
+            if (opts.pluginDir)
+                installOpts.pluginDir = opts.pluginDir;
+            if (opts.symlink !== undefined)
+                installOpts.symlink = opts.symlink;
+            result = installMenuBar(installOpts);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (globalOpts.json) {
+                printJson({ ok: false, error: message });
+            }
+            else {
+                printError(`Menu bar install failed: ${message}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (globalOpts.json) {
+            printJson(result);
+        }
+        else {
+            for (const line of result.transcript)
+                printText(line);
+        }
+        if (!result.ok)
+            process.exitCode = result.skipped ? 0 : 1;
+    });
+    return cmd;
+}
+export function defaultSwiftBarPluginDir(homeDir = os.homedir()) {
+    return path.join(homeDir, "Library", "Application Support", "SwiftBar", "Plugins");
+}
+export function installMenuBar(opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const homeDir = opts.homeDir ?? os.homedir();
+    const host = opts.host ?? defaultMenuBarHost(homeDir);
+    if (platform !== "darwin") {
+        const reason = "SwiftBar menu is macOS-only.";
+        const pluginDir = path.resolve(opts.pluginDir ?? process.env.RIFT_SWIFTBAR_PLUGIN_DIR ?? defaultSwiftBarPluginDir(homeDir));
+        return {
+            ok: true,
+            skipped: true,
+            reason,
+            pluginDir,
+            pluginPath: path.join(pluginDir, SWIFTBAR_PLUGIN_NAME),
+            sourceDir: null,
+            sourcePath: null,
+            rendererPath: null,
+            mode: null,
+            backupPath: null,
+            swiftBarDetected: false,
+            swiftBarOpened: false,
+            pluginDirSource: "default",
+            menuVisible: false,
+            positionSeeded: false,
+            recovery: null,
+            transcript: [`Menu bar skipped: ${reason}`],
+        };
+    }
+    const swiftBarApp = host.findSwiftBarApp();
+    const swiftBarDetected = swiftBarApp !== null;
+    // --- Resolve the plugin directory SwiftBar actually reads from ---
+    // Precedence: an explicit override (operator/test) wins; otherwise honor
+    // SwiftBar's own configured directory; otherwise fall back to the default
+    // and, when SwiftBar is present but unconfigured, persist that default so a
+    // fresh SwiftBar loads our plugin instead of prompting for a folder.
+    const explicitDir = opts.pluginDir ?? process.env.RIFT_SWIFTBAR_PLUGIN_DIR ?? null;
+    let pluginDirSource;
+    let resolvedDir;
+    if (explicitDir) {
+        resolvedDir = explicitDir;
+        pluginDirSource = "override";
+    }
+    else {
+        const configured = swiftBarDetected ? host.readPluginDirectory() : null;
+        if (configured) {
+            resolvedDir = configured;
+            pluginDirSource = "configured";
+        }
+        else {
+            resolvedDir = defaultSwiftBarPluginDir(homeDir);
+            // Only write SwiftBar's default when the app is present but has no
+            // directory yet — never clobber a folder the user already chose.
+            if (swiftBarDetected && host.writePluginDirectory(resolvedDir)) {
+                pluginDirSource = "default-written";
+            }
+            else {
+                pluginDirSource = "default";
+            }
+        }
+    }
+    const pluginDir = path.resolve(resolvedDir);
+    const pluginPath = path.join(pluginDir, SWIFTBAR_PLUGIN_NAME);
+    const transcript = [];
+    const sourceDir = path.resolve(opts.sourceDir ??
+        path.join(opts.packageRoot ?? findPackageRoot(), "operator", "swiftbar"));
+    const sourcePath = path.join(sourceDir, SWIFTBAR_PLUGIN_NAME);
+    const rendererPath = path.join(sourceDir, SWIFTBAR_RENDERER_NAME);
+    assertReadableFile(sourcePath, "SwiftBar wrapper");
+    assertReadableFile(rendererPath, "SwiftBar renderer");
+    fs.mkdirSync(pluginDir, { recursive: true });
+    let backupPath = null;
+    // Older installs left two kinds of top-level phantom in the watched folder,
+    // both of which SwiftBar re-loaded as extra menu items. Remove them so an
+    // upgrade self-heals (everything cleared here is ours — the wrapper writes
+    // nothing else top-level):
+    //   - the renderer as a sibling (`render-menu.py`); it now lives in a private
+    //     SwiftBar-ignored subdir.
+    //   - replaced-plugin backups (`rift.10s.sh.bak.<ts>`) and a torn atomic-copy
+    //     temp (`rift.10s.sh.rift-tmp`); backups now go to a private subdir too.
+    const staleRenderer = path.join(pluginDir, SWIFTBAR_RENDERER_NAME);
+    if (fs.existsSync(staleRenderer))
+        fs.rmSync(staleRenderer, { force: true });
+    removeStalePluginArtifacts(pluginDir);
+    // Copy is the default; symlink is opt-in (dev/auto-update). See module header.
+    const mode = opts.symlink ? "symlink" : "copy";
+    if (mode === "symlink") {
+        // Dev/auto-update: the wrapper symlinks to the package, and rift.10s.sh
+        // resolves its own symlink so SCRIPT_DIR lands in operator/swiftbar where
+        // the renderer sits beside it — nothing to copy into the plugin folder.
+        backupPath = replaceExistingPlugin(pluginPath, sourcePath, opts.now);
+        fs.symlinkSync(sourcePath, pluginPath);
+    }
+    else {
+        // Clear/back up any existing plugin (incl. a pre-migration dangling
+        // symlink) BEFORE writing, then atomic-copy the wrapper and the renderer
+        // (into its private subdir) so SwiftBar's 10s poll never sees a torn write
+        // or a wrapper without its renderer.
+        backupPath = replaceExistingPlugin(pluginPath, sourcePath, opts.now);
+        atomicCopyFile(sourcePath, pluginPath, 0o755);
+        const rendererSubdir = path.join(pluginDir, SWIFTBAR_RENDERER_SUBDIR);
+        fs.mkdirSync(rendererSubdir, { recursive: true });
+        atomicCopyFile(rendererPath, path.join(rendererSubdir, SWIFTBAR_RENDERER_NAME));
+    }
+    transcript.push("Menu bar installed.");
+    // --- Make it visible: launch/refresh SwiftBar, or hand back a recovery ---
+    // Invariant: when `menuVisible` is false on a non-skipped install, `recovery`
+    // is ALWAYS non-null. Callers (postinstall, update) branch on that, so a
+    // launch/config failure can never be laundered into a silent "installed".
+    let swiftBarOpened = false;
+    let menuVisible = false;
+    let positionSeeded = false;
+    let recovery = null;
+    if (!swiftBarDetected) {
+        recovery = buildRecovery(host.hasHomebrew());
+        transcript.push("SwiftBar is not installed — it is the free app that draws Onadit's menu bar icon.");
+        transcript.push(`  ${recovery}`);
+    }
+    else if (pluginDirSource === "default") {
+        // SwiftBar is present but we could NOT tell it which folder to scan: it had
+        // no PluginDirectory configured and `defaults write` failed. Launching it
+        // now would just prompt the user to pick a folder, so the icon is not
+        // reliably shown. Be honest — attempt the launch, but report not-visible
+        // with the one manual step (point SwiftBar at our folder).
+        const wasRunning = host.isSwiftBarRunning();
+        swiftBarOpened = host.openSwiftBar(wasRunning);
+        recovery =
+            "SwiftBar could not be pointed at Onadit's plugin folder automatically. " +
+                `Open SwiftBar's preferences and set the plugin folder to ${pluginDir}, ` +
+                "then re-run: onadit menubar install";
+        transcript.push("SwiftBar is installed, but Onadit could not set its plugin folder automatically.");
+        transcript.push(`  ${recovery}`);
+    }
+    else {
+        // Seed a stable menu-bar slot when the item has none, so a fresh/recreated
+        // status item isn't parked off-screen by a menu-bar manager (or macOS
+        // notch overflow) — invisible but "running". Only when missing, so a slot
+        // the user dragged is never clobbered. The slot is honored when SwiftBar
+        // next CREATES the item: immediately on a fresh launch, or on the next
+        // relaunch if SwiftBar is already running (a plain refresh reloads plugin
+        // CONTENT, not item placement).
+        // Both IDs are seeded so a later SwiftBar upgrade still finds a slot, but
+        // only a seed of the ID this SwiftBar reads changes placement (and needs
+        // the relaunch below). Unknown version: either ID may be the live one.
+        const ids = swiftBarItemIds(pluginPath);
+        const usesFullPath = swiftBarUsesFullPathId(swiftBarApp ? host.readSwiftBarVersion(swiftBarApp) : null);
+        for (const itemId of [ids.fileName, ids.fullPath]) {
+            const seeded = host.readPluginPreferredPosition(itemId) === null &&
+                host.writePluginPreferredPosition(itemId, SWIFTBAR_DEFAULT_POSITION);
+            const live = usesFullPath === null || usesFullPath === (itemId === ids.fullPath);
+            if (seeded && live)
+                positionSeeded = true;
+        }
+        const wasRunning = host.isSwiftBarRunning();
+        swiftBarOpened = host.openSwiftBar(wasRunning);
+        if (!swiftBarOpened) {
+            // App is there and pointed at the right folder, but we could not drive it
+            // (sandboxed context, GUI session unavailable, etc.). Not a silent
+            // success: hand back the one manual step.
+            recovery =
+                "SwiftBar is installed but Onadit could not launch it automatically. " +
+                    "Open SwiftBar yourself to show the Onadit icon.";
+            transcript.push("SwiftBar is installed but could not be launched automatically.");
+            transcript.push(`  ${recovery}`);
+        }
+        else if (positionSeeded && wasRunning) {
+            // We just pinned a NEW slot, but SwiftBar was already running — a refresh
+            // won't re-place an existing status item, so the icon is not reliably
+            // visible until SwiftBar recreates it. Don't overclaim: report
+            // not-visible with the one manual step (a quick SwiftBar restart).
+            recovery =
+                "Onadit was pinned to a menu-bar slot. Quit and reopen SwiftBar to reveal " +
+                    "the icon — a refresh alone won't reposition an already-running item.";
+            transcript.push("Pinned Onadit to a menu-bar slot — quit and reopen SwiftBar to reveal it.");
+            transcript.push(`  ${recovery}`);
+        }
+        else {
+            // Fresh launch (slot honored on creation), or the slot was already set.
+            menuVisible = true;
+            transcript.push(wasRunning
+                ? "Refreshed the Onadit menu in SwiftBar — the icon is in your menu bar."
+                : "Launched SwiftBar — the Onadit icon should appear in your menu bar.");
+        }
+    }
+    return {
+        ok: true,
+        skipped: false,
+        reason: null,
+        pluginDir,
+        pluginPath,
+        sourceDir,
+        sourcePath,
+        rendererPath,
+        mode,
+        backupPath,
+        swiftBarDetected,
+        swiftBarOpened,
+        pluginDirSource,
+        menuVisible,
+        positionSeeded,
+        recovery,
+        transcript,
+    };
+}
+/** Plain-language recovery line for a machine without SwiftBar installed. */
+function buildRecovery(hasHomebrew) {
+    return hasHomebrew
+        ? "Install it: brew install --cask swiftbar — then re-run: onadit menubar install"
+        : `Download it from ${SWIFTBAR_DOWNLOAD_URL}, then re-run: onadit menubar install`;
+}
+function assertReadableFile(filePath, label) {
+    if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+        throw new Error(`${label} missing from package: ${filePath}`);
+    }
+}
+function replaceExistingPlugin(pluginPath, sourcePath, now) {
+    let stat;
+    try {
+        stat = fs.lstatSync(pluginPath);
+    }
+    catch {
+        return null;
+    }
+    if (stat.isSymbolicLink()) {
+        const target = fs.readlinkSync(pluginPath);
+        const resolved = path.resolve(path.dirname(pluginPath), target);
+        if (resolved === sourcePath) {
+            fs.unlinkSync(pluginPath);
+            return null;
+        }
+        fs.unlinkSync(pluginPath);
+        return null;
+    }
+    // Back up into a private, SwiftBar-ignored subdir — NOT top-level, where the
+    // backup's `rift.10s.sh.bak.<ts>` name was re-parsed as a second "rift"
+    // plugin (the beta.25 upgrade phantom).
+    const backupDir = path.join(path.dirname(pluginPath), SWIFTBAR_BACKUP_SUBDIR);
+    fs.mkdirSync(backupDir, { recursive: true });
+    const stamp = toBackupStamp((now ? now() : new Date()).toISOString());
+    const backupPath = path.join(backupDir, `${SWIFTBAR_PLUGIN_NAME}.bak.${stamp}`);
+    fs.renameSync(pluginPath, backupPath);
+    return backupPath;
+}
+function toBackupStamp(iso) {
+    return iso.replace(/[:.]/g, "-");
+}
+/**
+ * The IDs SwiftBar may save this plugin's menu-bar slot under (its status
+ * item's `autosaveName`, the `<plugin>` in `NSStatusItem Preferred Position
+ * <plugin>`): the file name up to 2.0.x, the symlink-resolved full path from
+ * 2.1.0 (`fileURL.resolvingSymlinksInPath().path`). Seeding only the file name
+ * left 2.1+ items with no slot, so a menu-bar manager parked them off-screen.
+ */
+function swiftBarItemIds(pluginPath) {
+    let resolved = pluginPath;
+    try {
+        resolved = fs.realpathSync(pluginPath);
+    }
+    catch {
+        // Keep the unresolved path; the file-name ID still covers older SwiftBar.
+    }
+    return { fileName: SWIFTBAR_PLUGIN_NAME, fullPath: foundationResolvedPath(resolved) };
+}
+/**
+ * Foundation's `resolvingSymlinksInPath` drops a leading `/private` when the
+ * shorter path exists (`/private/var/…` → `/var/…`); Node's realpath keeps it.
+ * Applied to a realpath so the seeded key matches the ID SwiftBar computes.
+ */
+export function foundationResolvedPath(realPath, exists = fs.existsSync) {
+    if (!realPath.startsWith("/private/"))
+        return realPath;
+    const stripped = realPath.slice("/private".length);
+    return exists(stripped) ? stripped : realPath;
+}
+/**
+ * Whether this SwiftBar keys slots by the full path (2.1.0+) rather than the
+ * file name, or null when the version is unknown.
+ */
+export function swiftBarUsesFullPathId(version) {
+    const match = version?.match(/^(\d+)\.(\d+)/);
+    if (!match)
+        return null;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major > 2 || (major === 2 && minor >= 1);
+}
+/**
+ * Sweep top-level install leftovers SwiftBar would mis-load as phantom "rift"
+ * plugins: timestamped backups from pre-fix installs (`rift.10s.sh.bak.<ts>`)
+ * and a torn atomic-copy temp (`rift.10s.sh.rift-tmp`). Backups now live in a
+ * SwiftBar-ignored subdir; this self-heals folders left dirty by older betas.
+ * Best-effort — an unreadable plugin dir is not fatal to the install.
+ */
+function removeStalePluginArtifacts(pluginDir) {
+    let entries;
+    try {
+        entries = fs.readdirSync(pluginDir);
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        if (name.startsWith(`${SWIFTBAR_PLUGIN_NAME}.bak.`) ||
+            name === `${SWIFTBAR_PLUGIN_NAME}.rift-tmp`) {
+            fs.rmSync(path.join(pluginDir, name), { force: true, recursive: true });
+        }
+    }
+}
+/**
+ * Copy `src` onto `dest` atomically: write a sibling temp file, chmod it, then
+ * `rename` over `dest` (atomic within one directory/filesystem). SwiftBar polls
+ * the plugin every 10s, so a plain `copyFileSync` could be read half-written;
+ * the rename guarantees an observer sees either the old file or the whole new
+ * one. The temp sits beside `dest` so the rename never crosses filesystems.
+ */
+function atomicCopyFile(src, dest, modeBits) {
+    const tmp = `${dest}.rift-tmp`;
+    fs.copyFileSync(src, tmp);
+    if (modeBits !== undefined)
+        fs.chmodSync(tmp, modeBits);
+    fs.renameSync(tmp, dest);
+}
+function findPackageRoot() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 8; i += 1) {
+        if (fs.existsSync(path.join(dir, "package.json")) &&
+            fs.existsSync(path.join(dir, "operator", "swiftbar", SWIFTBAR_PLUGIN_NAME))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error("Could not locate packaged SwiftBar assets.");
+}
+// ---------------------------------------------------------------------------
+// Default host: real, best-effort system operations. Every call swallows its
+// own failures and degrades to a safe value — a missing `defaults`/`open`/
+// `brew`/`pgrep`, a sandboxed context, or a non-macOS host never throws.
+// ---------------------------------------------------------------------------
+export function defaultMenuBarHost(homeDir) {
+    return {
+        findSwiftBarApp() {
+            const candidates = [
+                "/Applications/SwiftBar.app",
+                path.join(homeDir, "Applications", "SwiftBar.app"),
+            ];
+            const direct = candidates.find((candidate) => fs.existsSync(candidate));
+            if (direct)
+                return direct;
+            // Fallback: a SwiftBar installed somewhere non-standard (direct download
+            // dragged elsewhere, Setapp, etc.) is still registered with macOS. Ask
+            // LaunchServices via Spotlight for the bundle id so we don't mislabel a
+            // present app as "missing" and skip reading its real plugin folder.
+            const found = runCapture("mdfind", [
+                `kMDItemCFBundleIdentifier == '${SWIFTBAR_DEFAULTS_DOMAIN}'`,
+            ]);
+            if (found) {
+                const first = found.split("\n")[0]?.trim();
+                if (first && fs.existsSync(first))
+                    return first;
+            }
+            return null;
+        },
+        readSwiftBarVersion(appPath) {
+            return runCapture("plutil", [
+                "-extract",
+                "CFBundleShortVersionString",
+                "raw",
+                "-o",
+                "-",
+                path.join(appPath, "Contents", "Info.plist"),
+            ]);
+        },
+        readPluginDirectory() {
+            const raw = runCapture("defaults", [
+                "read",
+                SWIFTBAR_DEFAULTS_DOMAIN,
+                "PluginDirectory",
+            ]);
+            if (!raw)
+                return null;
+            return expandTilde(raw.trim(), homeDir);
+        },
+        writePluginDirectory(dir) {
+            return runOk("defaults", [
+                "write",
+                SWIFTBAR_DEFAULTS_DOMAIN,
+                "PluginDirectory",
+                "-string",
+                dir,
+            ]);
+        },
+        readPluginPreferredPosition(itemId) {
+            // SwiftBar stores per-plugin slots under a key with a literal space:
+            // `NSStatusItem Preferred Position <itemId>`. execFileSync passes it as a
+            // single argv, so the spaces are safe (no shell).
+            return runCapture("defaults", [
+                "read",
+                SWIFTBAR_DEFAULTS_DOMAIN,
+                `NSStatusItem Preferred Position ${itemId}`,
+            ]);
+        },
+        writePluginPreferredPosition(itemId, position) {
+            return runOk("defaults", [
+                "write",
+                SWIFTBAR_DEFAULTS_DOMAIN,
+                `NSStatusItem Preferred Position ${itemId}`,
+                "-int",
+                String(position),
+            ]);
+        },
+        isSwiftBarRunning() {
+            // pgrep exits 0 when a match exists, 1 when none — runOk maps that.
+            return runOk("pgrep", ["-x", "SwiftBar"]);
+        },
+        openSwiftBar(refresh) {
+            if (refresh) {
+                // Ask a running SwiftBar to reload plugins so a just-updated wrapper
+                // is reflected immediately; fall through to a plain launch if that
+                // URL scheme is unavailable.
+                if (runOk("open", ["-g", "swiftbar://refreshallplugins"]))
+                    return true;
+            }
+            // `-g` launches in the background without stealing focus from the user.
+            return runOk("open", ["-g", "-a", "SwiftBar"]);
+        },
+        hasHomebrew() {
+            return runOk("/bin/sh", ["-c", "command -v brew"]);
+        },
+    };
+}
+/** Expand a leading `~` to the home dir; SwiftBar stores `~`-relative paths. */
+function expandTilde(value, homeDir) {
+    if (value === "~")
+        return homeDir;
+    if (value.startsWith("~/"))
+        return path.join(homeDir, value.slice(2));
+    return value;
+}
+/** Run a command, return trimmed stdout, or null on any non-zero/failure. */
+function runCapture(cmd, args) {
+    try {
+        const out = execFileSync(cmd, args, {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 10_000,
+        });
+        const trimmed = out.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Run a command, return true on exit 0, false on any non-zero/failure. */
+function runOk(cmd, args) {
+    try {
+        execFileSync(cmd, args, {
+            stdio: ["ignore", "ignore", "ignore"],
+            timeout: 10_000,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=menubar.js.map

package/dist/src/cli/commands/menubar.js.map

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

package/dist/src/cli/commands/onboard-first-run.d.ts

@@ -0,0 +1,5 @@
+import { type GlobalOpts, type OnboardOpts } from "./onboard.js";
+/** Strip terminal controls from archive content before displaying it. */
+export declare function terminalText(value: unknown): string;
+export declare function runFirstRun(opts: OnboardOpts, globalOpts: GlobalOpts): Promise<void>;
+//# sourceMappingURL=onboard-first-run.d.ts.map

package/dist/src/cli/commands/onboard-first-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard-first-run.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/onboard-first-run.ts"],"names":[],"mappings":"AAUA,OAAO,EAAyD,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAExH,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA8G1F"}