@switchbot/openapi-cli 3.1.1 → 3.2.0

package/dist/commands/daemon.js

@@ -1,410 +0,0 @@
-import { spawn } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { isJsonMode, printJson, exitWithError } from '../utils/output.js';
-import { readPidFile, writePidFile, clearPidFile, isPidAlive, getDefaultPidFilePaths, writeReloadSentinel, sighupSupported } from '../rules/pid-file.js';
-import { stringArg } from '../utils/arg-parsers.js';
-import chalk from 'chalk';
-import { DAEMON_LOG_FILE, DAEMON_PID_FILE, DAEMON_STATE_FILE, HEALTHZ_PID_FILE, readDaemonState, writeDaemonState, } from '../lib/daemon-state.js';
-function readDaemonPid() {
-    return readPidFile(DAEMON_PID_FILE);
-}
-function readHealthPid() {
-    return readPidFile(HEALTHZ_PID_FILE);
-}
-function killIfAlive(pid, signal = 'SIGTERM') {
-    if (!pid)
-        return;
-    if (!isPidAlive(pid))
-        return;
-    process.kill(pid, signal);
-}
-function buildHealthSummary(state) {
-    const healthPid = readHealthPid();
-    const healthRunning = healthPid !== null && isPidAlive(healthPid);
-    const port = state?.healthzPort ?? null;
-    return {
-        configured: port !== null,
-        pid: healthRunning ? healthPid : null,
-        pidFile: HEALTHZ_PID_FILE,
-        port,
-        running: healthRunning,
-        url: port !== null ? `http://127.0.0.1:${port}/healthz` : null,
-    };
-}
-function getDaemonStatus() {
-    const state = readDaemonState();
-    const pid = readDaemonPid();
-    const running = pid !== null && isPidAlive(pid);
-    return {
-        status: running ? 'running' : 'stopped',
-        pid: running ? pid : null,
-        pidFile: DAEMON_PID_FILE,
-        logFile: DAEMON_LOG_FILE,
-        stateFile: DAEMON_STATE_FILE,
-        health: buildHealthSummary(state),
-        lastReloadAt: state?.lastReloadAt ?? null,
-        lastReloadStatus: state?.lastReloadStatus ?? null,
-        lastReloadMessage: state?.lastReloadMessage ?? null,
-        startedAt: state?.startedAt ?? null,
-        stoppedAt: state?.stoppedAt ?? null,
-    };
-}
-function persistState(partial) {
-    const previous = readDaemonState();
-    const next = {
-        ...(previous ?? {}),
-        status: partial.status ?? previous?.status ?? 'stopped',
-        pid: partial.pid ?? previous?.pid ?? null,
-        ...partial,
-        logFile: DAEMON_LOG_FILE,
-        pidFile: DAEMON_PID_FILE,
-        stateFile: DAEMON_STATE_FILE,
-    };
-    writeDaemonState(next);
-    return next;
-}
-function readLastLines(filePath, n = 20) {
-    try {
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const lines = content.split('\n');
-        return lines.slice(Math.max(0, lines.length - n)).join('\n').trim();
-    }
-    catch {
-        return '';
-    }
-}
-async function probeLiveness(opts) {
-    await new Promise((resolve) => setTimeout(resolve, opts.delayMs));
-    const dead = opts.child.exitCode !== null || opts.child.killed;
-    if (!dead)
-        return true;
-    if (opts.fatal) {
-        if (opts.pidFile)
-            clearPidFile(opts.pidFile);
-        const exitCode = opts.child.exitCode ?? 'unknown';
-        const logSnippet = opts.logFile ? readLastLines(opts.logFile) : '';
-        const trailingLog = logSnippet ? `\n\nLast log lines:\n${logSnippet}` : '';
-        const logRef = opts.logFile ?? 'daemon log';
-        persistState({
-            status: 'failed', pid: null, failedAt: new Date().toISOString(),
-            failureReason: `Daemon exited immediately (code ${exitCode}). Check ${logRef}.`,
-        });
-        exitWithError({
-            code: 1, kind: 'runtime',
-            message: `Daemon process exited immediately (code ${exitCode}). Check ${logRef} for details.${trailingLog}`,
-        });
-    }
-    return false;
-}
-function renderHumanStatus(status) {
-    if (status.status === 'running' && status.pid !== null) {
-        console.log(`${chalk.green('●')} Daemon is running (pid ${status.pid}).`);
-    }
-    else {
-        console.log(`${chalk.grey('○')} Daemon is not running.`);
-    }
-    if (status.startedAt)
-        console.log(`  Started: ${status.startedAt}`);
-    if (status.stoppedAt)
-        console.log(`  Stopped: ${status.stoppedAt}`);
-    console.log(`  Log:     ${status.logFile}`);
-    console.log(`  PID:     ${status.pidFile}`);
-    console.log(`  State:   ${status.stateFile}`);
-    if (status.lastReloadAt) {
-        console.log(`  Reload:  ${status.lastReloadAt} (${status.lastReloadStatus ?? 'unknown'})`);
-        if (status.lastReloadMessage)
-            console.log(`           ${status.lastReloadMessage}`);
-    }
-    if (status.health.configured) {
-        if (status.health.running) {
-            console.log(`${chalk.green('✓')} Health server running (pid ${status.health.pid})`);
-        }
-        else {
-            console.log(`${chalk.yellow('!')} Health server configured but not running`);
-        }
-        if (status.health.url)
-            console.log(`  Health:  ${status.health.url}`);
-    }
-}
-export function registerDaemonCommand(program) {
-    const daemon = program
-        .command('daemon')
-        .description('Manage the background SwitchBot rules daemon and its health endpoint.')
-        .addHelpText('after', `
-The daemon runs \`switchbot rules run\` as a detached background process,
-tracks runtime metadata in ~/.switchbot/daemon.state.json, and can optionally
-co-launch a health endpoint via \`switchbot health serve\`.
-
-Subcommands:
-  start [--policy <path>]   Start the daemon (no-op if already running).
-  stop                      Stop the daemon and any co-launched health server.
-  status                    Report the daemon state, log path, and health summary.
-  reload                    Trigger a hot reload for the running rules engine.
-
-The daemon reads the same policy file as \`switchbot rules run\`.
-`);
-    daemon
-        .command('start')
-        .description('Start the rules-engine daemon in the background.')
-        .option('--policy <path>', 'Policy file path (default: auto-detected)', stringArg('--policy'))
-        .option('--force', 'Restart even if the daemon appears to be running.')
-        .option('--healthz-port <n>', 'Also start a health HTTP server on this port (default: disabled).')
-        .action(async (opts) => {
-        const current = getDaemonStatus();
-        if (current.status === 'running' && !opts.force) {
-            if (isJsonMode()) {
-                printJson({ result: 'already-running', ...current });
-            }
-            else {
-                console.log(`Daemon is already running (pid ${current.pid}). Use --force to restart.`);
-            }
-            return;
-        }
-        if (opts.force) {
-            try {
-                killIfAlive(current.pid);
-                killIfAlive(current.health.pid);
-            }
-            catch {
-                // best effort
-            }
-        }
-        const thisFile = fileURLToPath(import.meta.url);
-        const cliEntry = path.resolve(path.dirname(thisFile), '..', 'index.js');
-        const args = ['rules', 'run'];
-        if (opts.policy)
-            args.push(opts.policy);
-        fs.mkdirSync(path.dirname(DAEMON_PID_FILE), { recursive: true, mode: 0o700 });
-        persistState({
-            status: 'starting',
-            pid: null,
-            startedAt: new Date().toISOString(),
-            stoppedAt: undefined,
-            failedAt: undefined,
-            failureReason: undefined,
-            healthzPort: opts.healthzPort ? Number.parseInt(opts.healthzPort, 10) : null,
-            healthzPid: null,
-            healthzPidFile: HEALTHZ_PID_FILE,
-        });
-        const logFd = fs.openSync(DAEMON_LOG_FILE, 'a');
-        const child = spawn(process.execPath, [cliEntry, ...args], {
-            detached: true,
-            stdio: ['ignore', logFd, logFd],
-            env: { ...process.env },
-        });
-        child.unref();
-        fs.closeSync(logFd);
-        // Liveness probe: wait 300 ms then verify the child is still alive.
-        await probeLiveness({
-            child, delayMs: 300, fatal: true,
-            pidFile: DAEMON_PID_FILE, logFile: DAEMON_LOG_FILE,
-        });
-        const newPid = child.pid;
-        if (!newPid) {
-            persistState({
-                status: 'failed',
-                pid: null,
-                failedAt: new Date().toISOString(),
-                failureReason: 'Failed to spawn daemon process.',
-            });
-            exitWithError({ code: 1, kind: 'runtime', message: 'Failed to spawn daemon process.' });
-        }
-        writePidFile(DAEMON_PID_FILE, newPid);
-        let healthzPid = null;
-        let healthzPort = opts.healthzPort ? Number.parseInt(opts.healthzPort, 10) : null;
-        if (healthzPort !== null) {
-            const healthArgs = ['health', 'serve', '--port', String(healthzPort)];
-            const healthLogFd = fs.openSync(DAEMON_LOG_FILE, 'a');
-            const healthChild = spawn(process.execPath, [cliEntry, ...healthArgs], {
-                detached: true,
-                stdio: ['ignore', healthLogFd, healthLogFd],
-                env: { ...process.env },
-            });
-            healthChild.unref();
-            fs.closeSync(healthLogFd);
-            if (healthChild.pid) {
-                // Brief liveness probe for the health server process.
-                const healthAlive = await probeLiveness({ child: healthChild, delayMs: 200, fatal: false });
-                if (healthAlive) {
-                    healthzPid = healthChild.pid;
-                    writePidFile(HEALTHZ_PID_FILE, healthzPid);
-                }
-                // Non-fatal if health server dies — daemon itself is still running.
-            }
-        }
-        persistState({
-            status: 'running',
-            pid: newPid,
-            startedAt: new Date().toISOString(),
-            stoppedAt: undefined,
-            failedAt: undefined,
-            failureReason: undefined,
-            healthzPort,
-            healthzPid,
-            healthzPidFile: HEALTHZ_PID_FILE,
-        });
-        const status = getDaemonStatus();
-        if (isJsonMode()) {
-            printJson({ result: 'started', ...status });
-        }
-        else {
-            console.log(`${chalk.green('✓')} Daemon started (pid ${newPid})`);
-            console.log(`  Log:     ${DAEMON_LOG_FILE}`);
-            console.log(`  PID:     ${DAEMON_PID_FILE}`);
-            console.log(`  State:   ${DAEMON_STATE_FILE}`);
-            console.log(`  Reload:  switchbot daemon reload`);
-            if (status.health.running && status.health.url) {
-                console.log(`${chalk.green('✓')} Health server started (pid ${status.health.pid})`);
-                console.log(`  Health:  ${status.health.url}`);
-            }
-        }
-    });
-    daemon
-        .command('stop')
-        .description('Stop the background daemon by sending SIGTERM.')
-        .action(() => {
-        const status = getDaemonStatus();
-        if (status.status !== 'running' || status.pid === null) {
-            persistState({ status: 'stopped', pid: null, stoppedAt: new Date().toISOString() });
-            if (isJsonMode()) {
-                printJson({ result: 'not-running', ...getDaemonStatus() });
-            }
-            else {
-                console.log(`No running daemon found (pid file: ${DAEMON_PID_FILE}).`);
-            }
-            return;
-        }
-        try {
-            killIfAlive(status.pid);
-            killIfAlive(status.health.pid);
-        }
-        catch (err) {
-            persistState({
-                status: 'failed',
-                pid: status.pid,
-                failedAt: new Date().toISOString(),
-                failureReason: err instanceof Error ? err.message : String(err),
-            });
-            exitWithError({
-                code: 1,
-                kind: 'runtime',
-                message: `Failed to stop daemon (pid ${status.pid}): ${err instanceof Error ? err.message : String(err)}`,
-            });
-        }
-        try {
-            fs.unlinkSync(DAEMON_PID_FILE);
-        }
-        catch { /* best effort */ }
-        try {
-            fs.unlinkSync(HEALTHZ_PID_FILE);
-        }
-        catch { /* best effort */ }
-        persistState({
-            status: 'stopped',
-            pid: null,
-            healthzPid: null,
-            stoppedAt: new Date().toISOString(),
-        });
-        if (isJsonMode()) {
-            printJson({ result: 'stopped', ...getDaemonStatus() });
-        }
-        else {
-            console.log(`${chalk.green('✓')} Daemon stopped (pid ${status.pid}).`);
-        }
-    });
-    daemon
-        .command('status')
-        .description('Report whether the daemon is currently running.')
-        .action(() => {
-        const status = getDaemonStatus();
-        if (isJsonMode()) {
-            printJson(status);
-            return;
-        }
-        renderHumanStatus(status);
-    });
-    daemon
-        .command('reload')
-        .description('Trigger a hot reload on the running rules-engine daemon.')
-        .action(() => {
-        const daemonStatus = getDaemonStatus();
-        if (daemonStatus.status !== 'running' || daemonStatus.pid === null) {
-            persistState({
-                status: 'failed',
-                failedAt: new Date().toISOString(),
-                failureReason: 'No running daemon to reload.',
-                lastReloadAt: new Date().toISOString(),
-                lastReloadStatus: 'failed',
-                lastReloadMessage: 'No running daemon to reload.',
-            });
-            exitWithError({
-                code: 2,
-                kind: 'usage',
-                message: `No running daemon found (pid file: ${DAEMON_PID_FILE}).`,
-            });
-        }
-        const pidPaths = getDefaultPidFilePaths();
-        const rulesPid = readPidFile(pidPaths.pidFile);
-        if (rulesPid === null || !isPidAlive(rulesPid)) {
-            persistState({
-                status: 'failed',
-                failedAt: new Date().toISOString(),
-                failureReason: 'Rules engine PID is missing or stale.',
-                lastReloadAt: new Date().toISOString(),
-                lastReloadStatus: 'failed',
-                lastReloadMessage: 'Rules engine PID is missing or stale.',
-            });
-            exitWithError({
-                code: 2,
-                kind: 'usage',
-                message: `No running rules engine found for daemon reload (pid file: ${pidPaths.pidFile}).`,
-            });
-        }
-        let method;
-        try {
-            if (sighupSupported()) {
-                process.kill(rulesPid, 'SIGHUP');
-                method = 'SIGHUP';
-            }
-            else {
-                writeReloadSentinel(pidPaths.reloadFile);
-                method = 'sentinel';
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            persistState({
-                status: 'failed',
-                failedAt: new Date().toISOString(),
-                failureReason: message,
-                lastReloadAt: new Date().toISOString(),
-                lastReloadStatus: 'failed',
-                lastReloadMessage: message,
-            });
-            exitWithError({
-                code: 1,
-                kind: 'runtime',
-                message: `Failed to reload daemon: ${message}`,
-            });
-        }
-        persistState({
-            status: 'running',
-            lastReloadAt: new Date().toISOString(),
-            lastReloadStatus: 'ok',
-            lastReloadMessage: method === 'SIGHUP'
-                ? `Sent SIGHUP to rules engine pid ${rulesPid}.`
-                : `Wrote reload sentinel ${pidPaths.reloadFile}.`,
-        });
-        const status = getDaemonStatus();
-        if (isJsonMode()) {
-            printJson({ result: 'reloaded', method, ...status });
-        }
-        else {
-            console.log(`${chalk.green('✓')} Reload requested via ${method}.`);
-            if (status.lastReloadMessage)
-                console.log(`  ${status.lastReloadMessage}`);
-        }
-    });
-}

package/dist/commands/device-meta.js

@@ -1,159 +0,0 @@
-import { stringArg } from '../utils/arg-parsers.js';
-import { handleError, isJsonMode, printJson, printTable, UsageError } from '../utils/output.js';
-import { loadDeviceMeta, saveDeviceMeta, setDeviceMeta, clearDeviceMeta, getDeviceMeta, getMetaFilePath, } from '../devices/device-meta.js';
-export function registerDevicesMetaCommand(devices) {
-    const meta = devices
-        .command('meta')
-        .description('Manage local device metadata (alias, hide, notes) stored in ~/.switchbot/device-meta.json');
-    // switchbot devices meta set <deviceId>
-    meta
-        .command('set')
-        .description('Set local metadata for a device (alias, hide/show, notes)')
-        .argument('<deviceId>', 'Target device ID')
-        .option('--alias <name>', 'Local alias for the device (used with --name flag)', stringArg('--alias'))
-        .option('--hide', 'Hide this device from "devices list"')
-        .option('--show', 'Un-hide this device')
-        .option('--notes <text>', 'Freeform notes shown in "devices describe"', stringArg('--notes'))
-        .option('--force', 'Reassign alias even if it already belongs to another device')
-        .action((deviceId, options) => {
-        try {
-            if (options.hide && options.show) {
-                throw new UsageError('--hide and --show cannot be used together.');
-            }
-            if (!options.alias && !options.hide && !options.show && !options.notes) {
-                throw new UsageError('Specify at least one of: --alias, --hide, --show, --notes');
-            }
-            // Enforce alias uniqueness across devices
-            if (options.alias !== undefined) {
-                const meta = loadDeviceMeta();
-                const holder = Object.entries(meta.devices).find(([id, m]) => m.alias === options.alias && id !== deviceId);
-                if (holder) {
-                    if (!options.force) {
-                        throw new UsageError(`Alias "${options.alias}" is already assigned to device ${holder[0]}. Use --force to reassign.`);
-                    }
-                    // --force: clear the alias from the previous holder
-                    meta.devices[holder[0]] = { ...meta.devices[holder[0]], alias: undefined };
-                    saveDeviceMeta(meta);
-                    if (!isJsonMode()) {
-                        console.log(`(reassigned alias from ${holder[0]})`);
-                    }
-                }
-            }
-            const patch = {};
-            if (options.alias !== undefined)
-                patch.alias = options.alias;
-            if (options.notes !== undefined)
-                patch.notes = options.notes;
-            if (options.hide)
-                patch.hidden = true;
-            if (options.show)
-                patch.hidden = false;
-            setDeviceMeta(deviceId, patch);
-            const updated = getDeviceMeta(deviceId);
-            if (isJsonMode()) {
-                printJson({ ok: true, deviceId, meta: updated });
-            }
-            else {
-                console.log(`✓ Metadata updated for ${deviceId}`);
-                if (updated?.alias)
-                    console.log(`  alias:  ${updated.alias}`);
-                if (updated?.hidden)
-                    console.log(`  hidden: true`);
-                if (updated?.notes)
-                    console.log(`  notes:  ${updated.notes}`);
-            }
-        }
-        catch (error) {
-            handleError(error);
-        }
-    });
-    // switchbot devices meta get <deviceId>
-    meta
-        .command('get')
-        .description('Show local metadata for a device')
-        .argument('<deviceId>', 'Target device ID')
-        .action((deviceId) => {
-        try {
-            const entry = getDeviceMeta(deviceId);
-            if (!entry) {
-                if (isJsonMode()) {
-                    printJson({ deviceId, meta: null });
-                }
-                else {
-                    console.log(`No local metadata for ${deviceId}`);
-                }
-                return;
-            }
-            if (isJsonMode()) {
-                printJson({ deviceId, meta: entry });
-            }
-            else {
-                if (entry.alias)
-                    console.log(`alias:  ${entry.alias}`);
-                if (entry.hidden !== undefined)
-                    console.log(`hidden: ${entry.hidden}`);
-                if (entry.notes)
-                    console.log(`notes:  ${entry.notes}`);
-            }
-        }
-        catch (error) {
-            handleError(error);
-        }
-    });
-    // switchbot devices meta list
-    meta
-        .command('list')
-        .description('List all devices with local metadata')
-        .option('--hidden-only', 'Show only hidden devices')
-        .action((options) => {
-        try {
-            const file = loadDeviceMeta();
-            let entries = Object.entries(file.devices);
-            if (options.hiddenOnly)
-                entries = entries.filter(([, m]) => m.hidden);
-            if (entries.length === 0) {
-                if (isJsonMode()) {
-                    printJson([]);
-                }
-                else {
-                    console.log('No local metadata entries.');
-                    console.log(`File: ${getMetaFilePath()}`);
-                }
-                return;
-            }
-            if (isJsonMode()) {
-                printJson(entries.map(([id, m]) => ({ deviceId: id, ...m })));
-                return;
-            }
-            const rows = entries.map(([id, m]) => [
-                id,
-                m.alias ?? '—',
-                m.hidden ? 'yes' : '—',
-                m.notes ?? '—',
-            ]);
-            printTable(['deviceId', 'alias', 'hidden', 'notes'], rows);
-        }
-        catch (error) {
-            handleError(error);
-        }
-    });
-    // switchbot devices meta clear <deviceId>
-    meta
-        .command('clear')
-        .description('Remove all local metadata for a device')
-        .argument('<deviceId>', 'Target device ID')
-        .action((deviceId) => {
-        try {
-            clearDeviceMeta(deviceId);
-            if (isJsonMode()) {
-                printJson({ ok: true, deviceId });
-            }
-            else {
-                console.log(`✓ Metadata cleared for ${deviceId}`);
-            }
-        }
-        catch (error) {
-            handleError(error);
-        }
-    });
-}