@switchbot/openapi-cli 3.1.0 → 3.2.0

package/dist/commands/history.js

@@ -1,320 +0,0 @@
-import path from 'node:path';
-import os from 'node:os';
-import { intArg, stringArg } from '../utils/arg-parsers.js';
-import { printJson, isJsonMode, handleError, UsageError, exitWithError } from '../utils/output.js';
-import { readAudit, verifyAudit } from '../utils/audit.js';
-import { executeCommand } from '../lib/devices.js';
-import { queryDeviceHistory, queryDeviceHistoryStats, } from '../devices/history-query.js';
-import { aggregateDeviceHistory, ALL_AGG_FNS, } from '../devices/history-agg.js';
-const DEFAULT_AUDIT = path.join(os.homedir(), '.switchbot', 'audit.log');
-export function registerHistoryCommand(program) {
-    const history = program
-        .command('history')
-        .description('View and replay SwitchBot commands recorded via --audit-log')
-        .addHelpText('after', `
-Every 'devices command' run with --audit-log is appended as JSONL to the
-audit file (default ~/.switchbot/audit.log). 'history show' prints the file,
-'history replay <n>' re-runs the Nth entry (1-indexed, most-recent last).
-
-Examples:
-  $ switchbot --audit-log devices command <id> turnOff
-  $ switchbot history show --limit 10
-  $ switchbot history replay 3
-`);
-    history
-        .command('show')
-        .description('Print recent audit entries')
-        .option('--file <path>', `Path to the audit log (default ${DEFAULT_AUDIT})`, stringArg('--file'))
-        .option('--limit <n>', 'Show only the last N entries', intArg('--limit', { min: 1 }))
-        .action((options) => {
-        const file = options.file ?? DEFAULT_AUDIT;
-        const entries = readAudit(file);
-        const limited = options.limit !== undefined
-            ? entries.slice(-Math.max(1, Number(options.limit) || 1))
-            : entries;
-        if (isJsonMode()) {
-            printJson({ file, total: entries.length, entries: limited });
-            return;
-        }
-        if (entries.length === 0) {
-            console.log(`(no entries in ${file})`);
-            return;
-        }
-        const startIdx = entries.length - limited.length;
-        limited.forEach((e, i) => {
-            const idx = startIdx + i + 1;
-            const mark = e.result === 'error' ? '✗' : e.dryRun ? '◦' : '✓';
-            const param = e.parameter !== undefined && e.parameter !== 'default'
-                ? ` ${JSON.stringify(e.parameter)}`
-                : '';
-            const err = e.error ? `  [err: ${e.error}]` : '';
-            console.log(`${String(idx).padStart(4)}  ${mark}  ${e.t}  ${e.deviceId}  ${e.command}${param}${err}`);
-        });
-    });
-    history
-        .command('replay')
-        .description('Re-run a recorded command by its 1-indexed position')
-        .argument('<index>', 'Entry index (1 = oldest; as shown by "history show")')
-        .option('--file <path>', `Path to the audit log (default ${DEFAULT_AUDIT})`, stringArg('--file'))
-        .addHelpText('after', `
-Dry-run-honouring: pass --dry-run on the parent command to preview without
-sending the actual call. Errors from the recorded entry are NOT replayed —
-replay always attempts the command fresh.
-
-Examples:
-  $ switchbot history replay 3
-  $ switchbot --dry-run history replay 3
-`)
-        .action(async (indexArg, options) => {
-        const file = options.file ?? DEFAULT_AUDIT;
-        const entries = readAudit(file);
-        const idx = Number(indexArg);
-        if (!Number.isInteger(idx) || idx < 1 || idx > entries.length) {
-            exitWithError({
-                code: 2,
-                kind: 'usage',
-                message: `Invalid index ${indexArg}. Log has ${entries.length} entries.`,
-            });
-        }
-        const entry = entries[idx - 1];
-        if (entry.kind !== 'command') {
-            exitWithError({
-                code: 2,
-                kind: 'usage',
-                message: `Entry ${idx} is not a command (kind=${entry.kind}).`,
-            });
-        }
-        try {
-            const result = await executeCommand(entry.deviceId, entry.command, entry.parameter, entry.commandType);
-            if (isJsonMode()) {
-                printJson({ replayed: entry, result });
-            }
-            else {
-                console.log(`✓ replayed ${entry.command} on ${entry.deviceId}`);
-            }
-        }
-        catch (err) {
-            handleError(err);
-        }
-    });
-    history
-        .command('range')
-        .description('Query time-ranged device history from JSONL storage (populated by events mqtt-tail / MCP)')
-        .argument('<deviceId>', 'Device ID to query')
-        .option('--since <duration>', 'Relative window ending now, e.g. "30s", "15m", "1h", "7d" (mutually exclusive with --from/--to)', stringArg('--since'))
-        .option('--from <iso>', 'Range start (ISO-8601)', stringArg('--from'))
-        .option('--to <iso>', 'Range end (ISO-8601)', stringArg('--to'))
-        .option('--field <name>', 'Project a payload field (repeat to keep multiple)', (v, acc = []) => acc.concat(v), [])
-        .option('--limit <n>', 'Maximum records to return (default 1000)', intArg('--limit', { min: 1 }))
-        .addHelpText('after', `
-History is the append-only JSONL mirror of the per-device ring buffer: every
-'events mqtt-tail' event and every MCP tool status-refresh is written to
-~/.switchbot/device-history/<deviceId>.jsonl (rotates at 50MB × 3 files).
-
-Examples:
-  $ switchbot history range <id> --since 7d --json
-  $ switchbot history range <id> --since 1h --field temperature --field humidity
-  $ switchbot history range <id> --from 2026-04-18T00:00:00Z --to 2026-04-19T00:00:00Z
-`)
-        .action(async (deviceId, options) => {
-        // Usage-level validation: keep synchronous and pre-query so handleError
-        // maps these to exit 2 (via UsageError) rather than runtime exit 1.
-        if (options.since && (options.from || options.to)) {
-            handleError(new UsageError('--since is mutually exclusive with --from/--to.'));
-        }
-        try {
-            const records = await queryDeviceHistory(deviceId, {
-                since: options.since,
-                from: options.from,
-                to: options.to,
-                fields: options.field ?? [],
-                limit: options.limit !== undefined ? Number(options.limit) : undefined,
-            });
-            if (isJsonMode()) {
-                printJson({ deviceId, count: records.length, records });
-                return;
-            }
-            if (records.length === 0) {
-                console.log(`(no history records for ${deviceId} in requested range)`);
-                return;
-            }
-            for (const r of records) {
-                const payloadStr = JSON.stringify(r.payload);
-                console.log(`${r.t}  ${r.topic}  ${payloadStr}`);
-            }
-        }
-        catch (err) {
-            // Convert history-query's plain Error range messages into UsageError so
-            // they exit 2 instead of 1.
-            if (err instanceof Error && /^(Invalid --|--from|--since)/i.test(err.message)) {
-                handleError(new UsageError(err.message));
-            }
-            handleError(err);
-        }
-    });
-    history
-        .command('stats')
-        .description('Show on-disk size + record counts for a device history')
-        .argument('<deviceId>', 'Device ID to inspect')
-        .action((deviceId) => {
-        try {
-            const stats = queryDeviceHistoryStats(deviceId);
-            if (isJsonMode()) {
-                printJson(stats);
-                return;
-            }
-            console.log(`Device:        ${stats.deviceId}`);
-            console.log(`History dir:   ${stats.historyDir}`);
-            console.log(`JSONL files:   ${stats.fileCount} (${stats.jsonlFiles.join(', ') || '—'})`);
-            console.log(`Total size:    ${stats.totalBytes.toLocaleString()} bytes`);
-            console.log(`Record count:  ${stats.recordCount}`);
-            console.log(`Oldest:        ${stats.oldest ?? '—'}`);
-            console.log(`Newest:        ${stats.newest ?? '—'}`);
-        }
-        catch (err) {
-            handleError(err);
-        }
-    });
-    history
-        .command('verify')
-        .description('Check the audit log for malformed lines and schema-version drift')
-        .option('--file <path>', `Path to the audit log (default ${DEFAULT_AUDIT})`, stringArg('--file'))
-        .addHelpText('after', `
-See docs/audit-log.md for the audit log format. Exit code:
-  0  every line parses and carries the current auditVersion, or file is missing (warn)
-  1  one or more lines are malformed or schema drift detected
-  2  (usage) — not emitted by this subcommand
-
-Examples:
-  $ switchbot history verify
-  $ switchbot history verify --file ./custom.log --json
-`)
-        .action((options) => {
-        const file = options.file ?? DEFAULT_AUDIT;
-        const report = verifyAudit(file);
-        // Determine status and exit code
-        let status = 'ok';
-        let exitCode = 0;
-        if (report.fileMissing) {
-            status = 'warn';
-        }
-        else if (report.malformedLines > 0 || report.unversionedEntries > 0) {
-            status = 'fail';
-            exitCode = 1;
-        }
-        if (isJsonMode()) {
-            const output = {
-                status,
-                fileMissing: report.fileMissing === true,
-                parsed: report.parsedLines,
-                malformed: report.malformedLines,
-                unversioned: report.unversionedEntries,
-                message: report.fileMissing
-                    ? 'Audit log file not found (fresh install)'
-                    : report.malformedLines > 0 || report.unversionedEntries > 0
-                        ? 'Audit log has malformed or unversioned entries'
-                        : 'Audit log is valid',
-            };
-            printJson(output);
-        }
-        else {
-            if (report.fileMissing) {
-                console.log(`Audit log:       ${report.file} (missing — fresh install)`);
-                console.log(`Status:          ✓ warn (expected for new accounts)`);
-            }
-            else {
-                console.log(`Audit log:       ${report.file}`);
-                console.log(`Parsed lines:    ${report.parsedLines} / ${report.totalLines}`);
-                console.log(`Malformed:       ${report.malformedLines}`);
-                console.log(`Unversioned:     ${report.unversionedEntries}`);
-                const versions = Object.entries(report.versionCounts)
-                    .map(([v, n]) => `${v}:${n}`)
-                    .join(', ');
-                console.log(`Version counts:  ${versions || '—'}`);
-                if (report.earliest)
-                    console.log(`Earliest:        ${report.earliest}`);
-                if (report.latest)
-                    console.log(`Latest:          ${report.latest}`);
-                if (report.problems.length > 0) {
-                    console.log('\nProblems:');
-                    for (const p of report.problems) {
-                        console.log(`  line ${p.line}: ${p.reason}${p.preview ? ` — "${p.preview}"` : ''}`);
-                    }
-                }
-            }
-        }
-        process.exit(exitCode);
-    });
-    history
-        .command('aggregate')
-        .description('Aggregate time-ranged device history metrics into buckets')
-        .argument('<deviceId>', 'Device ID to aggregate')
-        .option('--since <duration>', 'Relative window ending now, e.g. "1h", "7d" (mutually exclusive with --from/--to)', stringArg('--since'))
-        .option('--from <iso>', 'Range start (ISO-8601)', stringArg('--from'))
-        .option('--to <iso>', 'Range end (ISO-8601)', stringArg('--to'))
-        .requiredOption('--metric <name>', 'Payload field to aggregate (repeat for multiple; required)', (v, acc = []) => acc.concat(v))
-        .option('--agg <csv>', 'Comma-separated aggregation functions (count,min,max,avg,sum,p50,p95)', stringArg('--agg'))
-        .option('--bucket <duration>', 'Bucket width, e.g. "15m", "1h", "1d"', stringArg('--bucket'))
-        .option('--max-bucket-samples <n>', 'Max samples per bucket for quantiles (1–100000)', intArg('--max-bucket-samples', { min: 1, max: 100_000 }))
-        .action(async (deviceId, options) => {
-        const metrics = options.metric ?? [];
-        if (options.since && (options.from || options.to)) {
-            handleError(new UsageError('--since is mutually exclusive with --from/--to.'));
-        }
-        let aggs;
-        if (options.agg !== undefined) {
-            const parts = options.agg.split(',').map((s) => s.trim()).filter(Boolean);
-            const unknown = parts.filter((p) => !ALL_AGG_FNS.includes(p));
-            if (unknown.length > 0) {
-                handleError(new UsageError(`Unknown aggregation function(s): ${unknown.join(', ')}. Legal values: ${ALL_AGG_FNS.join(', ')}.`));
-            }
-            aggs = parts;
-        }
-        const aggOpts = {
-            metrics,
-            aggs,
-            since: options.since,
-            from: options.from,
-            to: options.to,
-            bucket: options.bucket,
-            maxBucketSamples: options.maxBucketSamples !== undefined ? Number(options.maxBucketSamples) : undefined,
-        };
-        try {
-            const res = await aggregateDeviceHistory(deviceId, aggOpts);
-            if (isJsonMode()) {
-                printJson(res);
-                return;
-            }
-            if (res.buckets.length === 0) {
-                console.log(`(no history records for ${deviceId} in requested range)`);
-                return;
-            }
-            const aggCols = res.aggs;
-            const cols = ['t', ...res.metrics.flatMap((m) => aggCols.map((a) => `${m}.${a}`))];
-            console.log(cols.join('\t'));
-            for (const bkt of res.buckets) {
-                const row = cols.map((col) => {
-                    if (col === 't')
-                        return bkt.t;
-                    const [metric, agg] = col.split('.');
-                    const val = bkt.metrics[metric]?.[agg];
-                    return val !== undefined ? String(val) : '\u2014';
-                });
-                console.log(row.join('\t'));
-            }
-            if (res.partial) {
-                for (const note of res.notes) {
-                    console.error('note: ' + note);
-                }
-            }
-        }
-        catch (err) {
-            if (err instanceof Error) {
-                if (/bucket/i.test(err.message) || /--since/i.test(err.message) || /--from/i.test(err.message) || /--to/i.test(err.message)) {
-                    handleError(new UsageError(err.message));
-                }
-            }
-            handleError(err);
-        }
-    });
-}

package/dist/commands/identity.js

@@ -1,59 +0,0 @@
-/**
- * Single source of truth for SwitchBot product identity.
- *
- * Consumed by:
- *   - `program.description()` / `--help`   (via PRODUCT_TAGLINE in src/index.ts)
- *   - `--help --json` root                  (via src/utils/help-json.ts)
- *   - `switchbot capabilities` / `--json`   (identity block)
- *   - `switchbot agent-bootstrap --json`    (identity block)
- *
- * Keeping this in one file prevents drift between those four surfaces.
- *
- * IMPORTANT: the SwitchBot CLI only talks to the SwitchBot Cloud API over
- * HTTPS. It does NOT drive BLE radios directly — BLE-only devices are
- * reached by going through a SwitchBot Hub, which the Cloud API already
- * handles transparently. Please do not reintroduce the word "BLE" into the
- * tagline / README: it is misleading for AI agents reading `--help`.
- */
-export const IDENTITY = {
-    product: 'SwitchBot',
-    domain: 'IoT smart home device control',
-    vendor: 'Wonderlabs, Inc.',
-    apiVersion: 'v1.1',
-    apiDocs: 'https://github.com/OpenWonderLabs/SwitchBotAPI',
-    // Product category keywords. AI agents scan these to judge scope
-    // ("does SwitchBot control door locks? air conditioners?") without
-    // parsing the full device catalog.
-    productCategories: [
-        'lights (bulbs / strips / color)',
-        'locks / keypads',
-        'curtains / blinds / shades',
-        'sensors (motion / contact / climate / water-leak)',
-        'plugs / strips',
-        'bots / mechanical pushers',
-        'robot vacuums',
-        'IR appliances via Hub (TV / AC / fan / projector)',
-    ],
-    deviceCategories: {
-        physical: 'Wi-Fi-connected and Hub-mediated devices — controlled via Cloud API (CLI does not drive BLE directly)',
-        ir: 'IR remote devices learned by a SwitchBot Hub (TV, AC, fan, etc.)',
-    },
-    constraints: {
-        quotaPerDay: 10000,
-        hubRequiredForBle: true,
-        transport: 'Cloud API v1.1 (HTTPS)',
-        authMethod: 'HMAC-SHA256 token+secret',
-    },
-    agentGuide: 'docs/agent-guide.md',
-};
-/**
- * One-line product description used for `program.description()` (the first
- * line an AI agent sees when running `switchbot --help`).
- *
- * Structure: "SwitchBot smart home CLI — <product categories> via <transport>;
- *             <verbs: scenes, events, MCP>." Keep categories in sync with
- * IDENTITY.productCategories above.
- */
-export const PRODUCT_TAGLINE = 'SwitchBot smart home CLI — control lights, locks, curtains, sensors, plugs, ' +
-    'and IR appliances (TV/AC/fan) via Cloud API v1.1; run scenes, stream real-time ' +
-    'events, and integrate AI agents via MCP.';

package/dist/commands/install.js

@@ -1,246 +0,0 @@
-/**
- * `switchbot install` — one-command bootstrap (Phase 3B in-repo).
- *
- * Collapses the 7-step Quickstart (credentials → policy → skill link →
- * doctor verify) into a single orchestrated command with automatic
- * rollback on any step failure. The step library
- * (`src/install/default-steps.ts`) does the heavy lifting; this file
- * composes the steps based on user flags, drives the step runner, and
- * formats the outcome.
- *
- * Design notes:
- * - `switchbot install` assumes the CLI is already on PATH (the user
- *   ran `npm i -g @switchbot/openapi-cli` to get here). We do not
- *   re-install the CLI from inside itself.
- * - Doctor verification is NOT a step — if it failed, an automatic
- *   rollback would destroy good state. Instead we print a "next: run
- *   `switchbot doctor`" hint after success.
- */
-import { InvalidArgumentError } from 'commander';
-import fs from 'node:fs';
-import path from 'node:path';
-import { resolvePolicyPath } from '../policy/load.js';
-import { runInstall } from '../install/steps.js';
-import { runPreflight } from '../install/preflight.js';
-import { stepPromptCredentials, stepWriteKeychain, stepScaffoldPolicy, stepSymlinkSkill, stepDoctorVerify, } from '../install/default-steps.js';
-import { isJsonMode, printJson } from '../utils/output.js';
-import { getActiveProfile } from '../lib/request-context.js';
-import chalk from 'chalk';
-const AGENT_VALUES = ['claude-code', 'cursor', 'copilot', 'none'];
-function parseAgent(value) {
-    if (!value)
-        return 'claude-code';
-    if (!AGENT_VALUES.includes(value)) {
-        throw new InvalidArgumentError(`--agent must be one of ${AGENT_VALUES.join(', ')} (got "${value}")`);
-    }
-    return value;
-}
-function parseSkipList(value) {
-    if (!value)
-        return new Set();
-    return new Set(value
-        .split(',')
-        .map((s) => s.trim())
-        .filter(Boolean));
-}
-function printRecipe(ctx) {
-    if (!ctx.skillRecipePrinted)
-        return;
-    const lines = [];
-    lines.push('');
-    lines.push(chalk.bold(`Skill-install recipe for agent=${ctx.agent}:`));
-    switch (ctx.agent) {
-        case 'claude-code':
-            lines.push('  # re-run with --skill-path pointing at your local clone of openclaw-switchbot-skill', '  switchbot install --agent claude-code --skill-path /path/to/openclaw-switchbot-skill');
-            break;
-        case 'cursor':
-            lines.push('  # Cursor expects a rules file, not a skill directory. See:', '  #   openclaw-switchbot-skill/docs/agents/cursor.md');
-            break;
-        case 'copilot':
-            lines.push('  # Copilot merges instructions into .github/copilot-instructions.md. See:', '  #   openclaw-switchbot-skill/docs/agents/copilot.md');
-            break;
-        case 'none':
-            lines.push('  (none — skill step skipped)');
-            break;
-    }
-    console.error(lines.join('\n'));
-}
-function printDryRun(steps, ctx) {
-    if (isJsonMode()) {
-        printJson({
-            dryRun: true,
-            profile: ctx.profile,
-            agent: ctx.agent,
-            skillPath: ctx.skillPath ?? null,
-            policyPath: ctx.policyPath,
-            steps: steps.map((s) => ({ name: s.name, description: s.description })),
-        });
-        return;
-    }
-    console.log(chalk.bold('switchbot install — dry run'));
-    console.log(`  profile: ${ctx.profile}`);
-    console.log(`  agent:   ${ctx.agent}`);
-    console.log(`  skill:   ${ctx.skillPath ?? '(none — recipe will be printed)'}`);
-    console.log(`  policy:  ${ctx.policyPath}`);
-    console.log('');
-    console.log(chalk.bold('Steps that would run (in order):'));
-    for (const s of steps) {
-        console.log(`  • ${s.name}${s.description ? `  — ${s.description}` : ''}`);
-    }
-    console.log('');
-    console.log(chalk.dim('No changes made. Re-run without --dry-run to apply.'));
-}
-export function registerInstallCommand(program) {
-    program
-        .command('install')
-        .description('One-command bootstrap: credentials + policy + skill link (rolls back on failure)')
-        .option('--agent <name>', `target agent: ${AGENT_VALUES.join(' | ')} (default: claude-code)`)
-        .option('--skill-path <dir>', 'local clone of openclaw-switchbot-skill (enables auto-link)')
-        .option('--token-file <path>', 'two-line credential file (token, secret); read once and deleted on success')
-        .option('--skip <names>', 'comma-separated list of step names to skip (e.g. "scaffold-policy,symlink-skill")')
-        .option('--force', 'replace an existing skill symlink pointing at a different path; allow link even without SKILL.md')
-        .option('--verify', 'after a successful install, run `switchbot doctor --json` as a warn-only post-check')
-        .addHelpText('after', `
-The global --dry-run flag previews the step list without making changes.
-Global --json emits the install report as JSON to stdout.
-
-Exit codes:
-  0  success
-  2  preflight check failed (nothing changed)
-  3  step failed; rollback completed
-  4  step failed; rollback had residue (see output)
-
-Examples:
-  # Interactive install, Claude Code skill not linked (recipe printed):
-  switchbot install
-
-  # Full install with skill link:
-  switchbot install --skill-path ../openclaw-switchbot-skill
-
-  # Non-interactive (CI) install:
-  printf '%s\\n%s\\n' "$TOKEN" "$SECRET" > /tmp/sb-creds
-  switchbot install --token-file /tmp/sb-creds --skill-path ./skill
-`)
-        .action(async (opts, command) => {
-        const agent = parseAgent(opts.agent);
-        const profile = getActiveProfile() ?? 'default';
-        const skip = parseSkipList(opts.skip);
-        const skillPath = opts.skillPath ? path.resolve(opts.skillPath) : undefined;
-        const tokenFile = opts.tokenFile ? path.resolve(opts.tokenFile) : undefined;
-        const force = Boolean(opts.force);
-        const verify = Boolean(opts.verify);
-        const globalOpts = command.parent?.opts() ?? {};
-        const dryRun = Boolean(globalOpts.dryRun);
-        // Pre-flight: read-only checks, never mutate anything.
-        const pf = await runPreflight({
-            agent,
-            expectSkillLink: agent === 'claude-code' && Boolean(skillPath),
-        });
-        if (!pf.ok) {
-            if (isJsonMode()) {
-                printJson({ ok: false, stage: 'preflight', preflight: pf });
-            }
-            else {
-                console.error(chalk.red('✗ preflight failed — nothing changed'));
-                for (const c of pf.checks) {
-                    const mark = c.status === 'fail' ? chalk.red('✗') : c.status === 'warn' ? chalk.yellow('!') : chalk.green('✓');
-                    console.error(`  ${mark} ${c.name}: ${c.message}`);
-                    if (c.hint)
-                        console.error(`      hint: ${c.hint}`);
-                }
-            }
-            process.exit(2);
-        }
-        const ctx = {
-            profile,
-            agent,
-            skillPath,
-            tokenFile,
-            policyPath: resolvePolicyPath(),
-            nonInteractive: !process.stdin.isTTY && !tokenFile,
-        };
-        const allSteps = [
-            stepPromptCredentials(),
-            stepWriteKeychain(),
-            stepScaffoldPolicy(),
-            stepSymlinkSkill({ force }),
-        ];
-        const steps = allSteps.filter((s) => !skip.has(s.name));
-        if (dryRun) {
-            printDryRun(steps, ctx);
-            return;
-        }
-        const report = await runInstall(steps, { context: ctx });
-        // Delete the token file now that credentials are committed.
-        if (report.ok && tokenFile) {
-            try {
-                fs.unlinkSync(tokenFile);
-            }
-            catch {
-                // non-fatal: credentials are already in the keychain
-            }
-        }
-        // A7: opt-in post-install verification. Doctor is NEVER part of the
-        // rollback chain — a failing doctor after a good install would
-        // destroy working state. So we run it AFTER runInstall resolves, as
-        // a warn-only check. The outcome is reported but never flips the
-        // command's exit code.
-        if (report.ok && verify) {
-            const cliPath = process.argv[1] ?? '';
-            const step = stepDoctorVerify({ cliPath });
-            await step.execute(ctx);
-        }
-        if (isJsonMode()) {
-            printJson({
-                ok: report.ok,
-                profile: ctx.profile,
-                agent: ctx.agent,
-                report,
-                preflight: pf,
-                policyPath: ctx.policyPath,
-                policyScaffolded: ctx.policyScaffoldResult && !ctx.policyScaffoldResult.skipped,
-                skillLinkPath: ctx.skillLinkPath,
-                skillLinkCreated: Boolean(ctx.skillLinkCreated),
-                verify: verify ? { ok: ctx.doctorOk ?? null, report: ctx.doctorReport ?? null } : undefined,
-            });
-        }
-        else if (report.ok) {
-            console.log(chalk.green('✓ install complete'));
-            if (ctx.skillLinkCreated)
-                console.log(`  linked skill: ${ctx.skillLinkPath}`);
-            if (ctx.policyScaffoldResult?.skipped === false)
-                console.log(`  wrote policy: ${ctx.policyScaffoldResult.policyPath}`);
-            printRecipe(ctx);
-            if (verify) {
-                if (ctx.doctorOk) {
-                    console.log(chalk.green('✓ doctor --json: all green'));
-                }
-                else {
-                    console.log(chalk.yellow('! doctor --json reported issues — install is committed; run `switchbot doctor` to inspect'));
-                }
-            }
-            console.log('');
-            console.log(chalk.bold('Next:'));
-            console.log('  switchbot doctor        # verify the setup');
-            console.log('  switchbot devices list  # smoke test');
-        }
-        else {
-            console.error(chalk.red(`✗ install failed at step: ${report.failedAt}`));
-            const residue = report.outcomes.some((o) => o.status === 'rollback-failed');
-            for (const o of report.outcomes) {
-                const tag = o.status === 'succeeded' ? chalk.green('✓') :
-                    o.status === 'failed' ? chalk.red('✗') :
-                        o.status === 'rolled-back' ? chalk.yellow('↺') :
-                            o.status === 'rollback-failed' ? chalk.red('!!') :
-                                chalk.dim('·');
-                const msg = o.status === 'failed' || o.status === 'rollback-failed' ? ` — ${o.error}` : '';
-                console.error(`  ${tag} ${o.step} [${o.status}]${msg}`);
-            }
-            if (residue) {
-                console.error(chalk.red('Rollback left residue. Run `switchbot uninstall` to clean up or review output above.'));
-                process.exit(4);
-            }
-            process.exit(3);
-        }
-    });
-}