@sayue_ltr/fleq 1.50.0 → 1.51.0

package/dist/ui/repl-handlers/info-handlers.js

@@ -0,0 +1,577 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CATEGORY_ALIASES = exports.COMMAND_ALIASES = void 0;
+exports.getCurrentSettingValues = getCurrentSettingValues;
+exports.handleDetail = handleDetail;
+exports.handleHelp = handleHelp;
+exports.handleStats = handleStats;
+exports.handleHistory = handleHistory;
+exports.handleStatus = handleStatus;
+exports.handleConfig = handleConfig;
+exports.handleContract = handleContract;
+exports.handleSocket = handleSocket;
+exports.handleColors = handleColors;
+exports.hasBackupSupport = hasBackupSupport;
+exports.resolveCommand = resolveCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const types_1 = require("../../types");
+const rest_client_1 = require("../../dmdata/rest-client");
+const config_1 = require("../../config");
+const formatter_1 = require("../formatter");
+const themeModule = __importStar(require("../theme"));
+const statistics_formatter_1 = require("../statistics-formatter");
+const types_2 = require("./types");
+// ── ヘルパー (モジュール内のみ) ──
+/** ISO 文字列を "MM-DD HH:mm:ss" に整形 (テーブル用短縮形) */
+function formatShortTime(iso) {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+        return iso;
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+/** 文字列を視覚幅で指定幅に切り詰める */
+function truncate(str, maxWidth) {
+    if (maxWidth <= 0)
+        return "";
+    if ((0, formatter_1.visualWidth)(str) <= maxWidth)
+        return str;
+    const ellipsis = "\u2026";
+    const ellipsisWidth = (0, formatter_1.visualWidth)(ellipsis);
+    if (maxWidth <= ellipsisWidth)
+        return ellipsis;
+    const targetWidth = maxWidth - ellipsisWidth;
+    let result = "";
+    let width = 0;
+    for (const ch of str) {
+        const chWidth = (0, formatter_1.visualWidth)(ch);
+        if (width + chWidth > targetWidth)
+            break;
+        result += ch;
+        width += chWidth;
+    }
+    return result + ellipsis;
+}
+/** GdEarthquakeItem から深さ文字列を生成 */
+function formatDepth(item) {
+    if (item.hypocenter?.depth?.value != null) {
+        const val = item.hypocenter.depth.value;
+        const unit = item.hypocenter.depth.unit || "km";
+        return `${val}${unit}`;
+    }
+    return "---";
+}
+/** ミリ秒を人間可読な時間文字列に変換 */
+function formatDuration(ms) {
+    const totalSec = Math.ceil(ms / 1000);
+    if (totalSec < 60)
+        return `${totalSec}秒`;
+    const min = Math.floor(totalSec / 60);
+    const sec = totalSec % 60;
+    if (min < 60)
+        return sec > 0 ? `${min}分${sec}秒` : `${min}分`;
+    const hour = Math.floor(min / 60);
+    const remMin = min % 60;
+    return remMin > 0 ? `${hour}時間${remMin}分` : `${hour}時間`;
+}
+/** 震度キーから対応するロール名を返す */
+function getIntensityRole(key) {
+    const map = {
+        "1": "intensity1", "2": "intensity2", "3": "intensity3", "4": "intensity4",
+        "5弱": "intensity5Lower", "5強": "intensity5Upper",
+        "6弱": "intensity6Lower", "6強": "intensity6Upper", "7": "intensity7",
+    };
+    return map[key] ?? null;
+}
+/** 長周期階級キーから対応するロール名を返す */
+function getLgIntRole(key) {
+    const map = {
+        "0": "lgInt0", "1": "lgInt1", "2": "lgInt2", "3": "lgInt3", "4": "lgInt4",
+    };
+    return map[key] ?? null;
+}
+/**
+ * fg/bg 分離表示用のセルを生成する。
+ */
+function renderFgBgItem(label, fg, bg, style) {
+    const fgBlock = chalk_1.default.rgb(fg[0], fg[1], fg[2])("██");
+    const bgBlock = chalk_1.default.bgRgb(bg[0], bg[1], bg[2])("  ");
+    return { cell: `${fgBlock} ${bgBlock} ${style(label)}`, visualLen: (0, formatter_1.visualWidth)(label) + 6 };
+}
+/**
+ * 色付きアイテムをターミナル幅に応じたマルチカラムで出力する。
+ */
+function printColorGrid(termWidth, items, renderFn) {
+    const rendered = items.map(renderFn);
+    const maxVisual = Math.max(...rendered.map((r) => r.visualLen));
+    const colWidth = maxVisual + 3;
+    const indent = 2;
+    const cols = Math.max(1, Math.floor((termWidth - indent) / colWidth));
+    let line = "";
+    let col = 0;
+    for (const r of rendered) {
+        const pad = colWidth - r.visualLen;
+        line += r.cell + " ".repeat(Math.max(0, pad));
+        col++;
+        if (col >= cols) {
+            console.log(`${" ".repeat(indent)}${line}`);
+            line = "";
+            col = 0;
+        }
+    }
+    if (line.length > 0) {
+        console.log(`${" ".repeat(indent)}${line}`);
+    }
+}
+/** コマンドのエイリアス (逆引き用) */
+exports.COMMAND_ALIASES = {
+    hist: "history",
+    cols: "colors",
+    det: "detail",
+    stat: "status",
+    conf: "config",
+    cont: "contract",
+    sock: "socket",
+    noti: "notify",
+    ewlg: "eewlog",
+    tw: "tablewidth",
+    itxt: "infotext",
+    tint: "tipinterval",
+    snd: "sound",
+    thm: "theme",
+    bkup: "backup",
+    lim: "limit",
+    cls: "clear",
+};
+/** 通知カテゴリ名のエイリアス (短縮形 → 正式名) */
+exports.CATEGORY_ALIASES = {
+    eq: "earthquake",
+    tsu: "tsunami",
+    st: "seismicText",
+    nt: "nankaiTrough",
+    lgob: "lgObservation",
+};
+/** 設定変更可能なコマンドの現在値と設定可能な値を返す */
+function getCurrentSettingValues(ctx) {
+    const { config, notifier, eewLogger, statusLine } = ctx;
+    const notifySettings = notifier.getSettings();
+    const onCount = Object.values(notifySettings).filter(Boolean).length;
+    const totalCount = Object.keys(notifySettings).length;
+    const muteInfo = notifier.isMuted() ? `, ミュート中` : "";
+    return {
+        night: {
+            current: themeModule.isNightMode() ? "ON" : "OFF",
+            options: "on / off",
+        },
+        sound: {
+            current: notifier.getSoundEnabled() ? "ON" : "OFF",
+            options: "on / off",
+        },
+        tablewidth: {
+            current: config.tableWidth == null
+                ? `auto (${process.stdout.columns ?? 60})`
+                : `${config.tableWidth} (固定)`,
+            options: "40〜200 / auto",
+        },
+        infotext: {
+            current: config.infoFullText ? "full" : "short",
+            options: "full / short",
+        },
+        tipinterval: {
+            current: config.waitTipIntervalMin === 0
+                ? "無効"
+                : `${config.waitTipIntervalMin}分`,
+            options: "0〜1440 (0で無効)",
+        },
+        mode: {
+            current: (0, formatter_1.getDisplayMode)(),
+            options: "normal / compact",
+        },
+        clock: {
+            current: statusLine.getClockMode() === "clock" ? "現在時刻" : "経過時間",
+            options: "elapsed / now",
+        },
+        notify: {
+            current: `${onCount}/${totalCount} ON${muteInfo}`,
+            options: "eew, earthquake, tsunami, seismicText, nankaiTrough, lgObservation",
+        },
+        mute: {
+            current: notifier.isMuted()
+                ? `残り ${formatDuration(notifier.muteRemaining())}`
+                : "OFF",
+            options: "<duration> (例: 30m, 1h, 90s) / off",
+        },
+        eewlog: {
+            current: eewLogger.isEnabled()
+                ? (() => {
+                    const fields = eewLogger.getFields();
+                    const onCount = Object.values(fields).filter(Boolean).length;
+                    return `ON (${onCount}/${Object.keys(fields).length}項目)`;
+                })()
+                : "OFF",
+            options: "on / off / fields",
+        },
+        limit: {
+            current: (() => {
+                const t = config.truncation;
+                const d = types_1.DEFAULT_CONFIG.truncation;
+                const changed = Object.keys(d)
+                    .filter((k) => t[k] !== d[k]).length;
+                return changed > 0 ? `${changed}項目変更済` : "デフォルト";
+            })(),
+            options: "limit で詳細表示",
+        },
+    };
+}
+// ── コマンドハンドラ ──
+function handleDetail(ctx, args) {
+    const sub = args.trim().toLowerCase();
+    if (sub === "" || sub === "tsunami") {
+        const provider = ctx.detailProviders.find((p) => p.category === "tsunami");
+        if (provider == null || !provider.hasDetail()) {
+            console.log(chalk_1.default.gray("  現在、継続中の津波情報はありません。"));
+        }
+        else {
+            provider.showDetail();
+        }
+        return;
+    }
+    console.log(chalk_1.default.yellow(`  不明なサブコマンド: ${sub}`) + chalk_1.default.gray(" (利用可能: tsunami)"));
+}
+function handleHelp(ctx, args) {
+    const trimmed = args.trim();
+    if (trimmed.length > 0) {
+        const parts = trimmed.split(/\s+/);
+        const entry = resolveCommand(ctx, parts[0]);
+        if (entry == null) {
+            console.log(chalk_1.default.yellow(`  不明なコマンド: ${parts[0]}`));
+            return;
+        }
+        if (parts.length > 1 && entry.subcommands) {
+            const sub = entry.subcommands[parts[1]];
+            if (sub == null) {
+                console.log(chalk_1.default.yellow(`  不明なサブコマンド: ${parts[0]} ${parts[1]}`));
+                return;
+            }
+            console.log();
+            console.log(chalk_1.default.cyan.bold(`  ${parts[0]} ${parts[1]}`) + chalk_1.default.gray(` — ${sub.description}`));
+            if (sub.detail) {
+                console.log();
+                for (const line of sub.detail.split("\n")) {
+                    console.log(chalk_1.default.white(`  ${line}`));
+                }
+            }
+            console.log();
+            return;
+        }
+        console.log();
+        console.log(chalk_1.default.cyan.bold(`  ${parts[0]}`) + chalk_1.default.gray(` — ${entry.description}`));
+        if (entry.detail) {
+            console.log();
+            for (const line of entry.detail.split("\n")) {
+                console.log(chalk_1.default.white(`  ${line}`));
+            }
+        }
+        if (entry.subcommands) {
+            console.log();
+            const subNames = Object.keys(entry.subcommands).sort();
+            for (let i = 0; i < subNames.length; i++) {
+                const subName = subNames[i];
+                const sub = entry.subcommands[subName];
+                const prefix = i < subNames.length - 1 ? "├─" : "└─";
+                console.log(chalk_1.default.gray(`      ${prefix} `) + chalk_1.default.white(subName.padEnd(10)) + chalk_1.default.gray(sub.description));
+            }
+        }
+        console.log();
+        return;
+    }
+    // help — カテゴリ別一覧
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  利用可能なコマンド:"));
+    const currentValues = getCurrentSettingValues(ctx);
+    const displayed = new Set();
+    const categoryOrder = ["info", "status", "settings", "operation"];
+    for (const category of categoryOrder) {
+        console.log();
+        console.log(chalk_1.default.cyan(`  [${types_2.CATEGORY_LABELS[category]}]`));
+        const commandNames = Object.keys(ctx.commands)
+            .filter((name) => name !== "exit" && name !== "?" && ctx.commands[name].category === category)
+            .sort();
+        for (const name of commandNames) {
+            const entry = ctx.commands[name];
+            if (displayed.has(entry.description))
+                continue;
+            displayed.add(entry.description);
+            const setting = currentValues[name];
+            const valueSuffix = setting != null
+                ? chalk_1.default.gray(" [") + chalk_1.default.yellow(setting.current) + chalk_1.default.gray("]") +
+                    (setting.options ? chalk_1.default.gray(` (${setting.options})`) : "")
+                : "";
+            const alias = Object.entries(exports.COMMAND_ALIASES)
+                .find(([, v]) => v === name)?.[0];
+            const aliasSuffix = alias != null ? chalk_1.default.gray(` (${alias})`) : "";
+            console.log(chalk_1.default.white(`    ${name.padEnd(14)}`) + chalk_1.default.gray(entry.description) + aliasSuffix + valueSuffix);
+            if (entry.subcommands) {
+                const subNames = Object.keys(entry.subcommands).sort();
+                for (let i = 0; i < subNames.length; i++) {
+                    const subName = subNames[i];
+                    const sub = entry.subcommands[subName];
+                    const prefix = i < subNames.length - 1 ? "├─" : "└─";
+                    console.log(chalk_1.default.gray(`      ${prefix} `) + chalk_1.default.white(subName.padEnd(10)) + chalk_1.default.gray(sub.description));
+                }
+            }
+        }
+    }
+    console.log();
+    console.log(chalk_1.default.gray("  エイリアス: ") + chalk_1.default.white("?") + chalk_1.default.gray(" → help, ") + chalk_1.default.white("exit") + chalk_1.default.gray(" → quit (コマンド名の大文字小文字は区別しません)"));
+    console.log();
+}
+function handleStats(ctx) {
+    (0, statistics_formatter_1.displayStatistics)(ctx.stats.getSnapshot());
+}
+async function handleHistory(ctx, args) {
+    const MAX_HISTORY = 100;
+    const raw = args.length > 0 ? parseInt(args, 10) : 10;
+    if (isNaN(raw) || raw <= 0) {
+        console.log(chalk_1.default.yellow("  件数は正の整数で指定してください"));
+        return;
+    }
+    const limit = Math.min(raw, MAX_HISTORY);
+    console.log(chalk_1.default.gray("  地震履歴を取得中..."));
+    const res = await (0, rest_client_1.listEarthquakes)(ctx.config.apiKey, limit);
+    if (res.items.length === 0) {
+        console.log(chalk_1.default.gray("  該当する地震情報はありません"));
+        return;
+    }
+    const COL = { time: 18, hypo: 16, mag: 6, depth: 8, int: 8 };
+    const hLine = (l, m, r, h) => chalk_1.default.gray(`  ${l}${h.repeat(COL.time + 2)}${m}${h.repeat(COL.hypo + 2)}${m}${h.repeat(COL.mag + 2)}${m}${h.repeat(COL.depth + 2)}${m}${h.repeat(COL.int + 2)}${r}`);
+    console.log();
+    console.log(hLine("┌", "┬", "┐", "─"));
+    console.log(chalk_1.default.gray("  │ ") +
+        chalk_1.default.cyan((0, formatter_1.visualPadEnd)("発生時刻", COL.time)) + chalk_1.default.gray(" │ ") +
+        chalk_1.default.cyan((0, formatter_1.visualPadEnd)("震源地", COL.hypo)) + chalk_1.default.gray(" │ ") +
+        chalk_1.default.cyan((0, formatter_1.visualPadEnd)("規模", COL.mag)) + chalk_1.default.gray(" │ ") +
+        chalk_1.default.cyan((0, formatter_1.visualPadEnd)("深さ", COL.depth)) + chalk_1.default.gray(" │ ") +
+        chalk_1.default.cyan((0, formatter_1.visualPadEnd)("最大震度", COL.int)) + chalk_1.default.gray(" │"));
+    console.log(hLine("├", "┼", "┤", "─"));
+    const items = [...res.items].reverse();
+    for (const item of items) {
+        const time = formatShortTime(item.originTime || item.arrivalTime);
+        const hypo = truncate(item.hypocenter?.name || "不明", COL.hypo);
+        const mag = item.magnitude?.value != null ? `M${item.magnitude.value}` : "M---";
+        const depth = formatDepth(item);
+        const maxInt = item.maxInt != null ? item.maxInt : "---";
+        const intColor = item.maxInt != null ? (0, formatter_1.intensityColor)(item.maxInt) : chalk_1.default.gray;
+        console.log(chalk_1.default.gray("  │ ") +
+            chalk_1.default.white((0, formatter_1.visualPadEnd)(time, COL.time)) + chalk_1.default.gray(" │ ") +
+            chalk_1.default.white((0, formatter_1.visualPadEnd)(hypo, COL.hypo)) + chalk_1.default.gray(" │ ") +
+            chalk_1.default.yellow((0, formatter_1.visualPadEnd)(mag, COL.mag)) + chalk_1.default.gray(" │ ") +
+            chalk_1.default.white((0, formatter_1.visualPadEnd)(depth, COL.depth)) + chalk_1.default.gray(" │ ") +
+            intColor((0, formatter_1.visualPadEnd)(maxInt, COL.int)) + chalk_1.default.gray(" │"));
+    }
+    console.log(hLine("└", "┴", "┘", "─"));
+    console.log();
+}
+function handleStatus(ctx) {
+    const status = ctx.wsManager.getStatus();
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  WebSocket 接続状態:"));
+    console.log(chalk_1.default.white("  状態: ") +
+        (status.connected
+            ? chalk_1.default.green.bold("接続中")
+            : chalk_1.default.red.bold("切断")));
+    if (status.socketId != null) {
+        console.log(chalk_1.default.white("  SocketID: ") + chalk_1.default.white(String(status.socketId)));
+    }
+    if (status.reconnectAttempt > 0) {
+        console.log(chalk_1.default.white("  再接続試行: ") +
+            chalk_1.default.yellow(`#${status.reconnectAttempt}`));
+    }
+    if (hasBackupSupport(ctx.wsManager)) {
+        if (ctx.wsManager.isBackupRunning()) {
+            const backupStatus = ctx.wsManager.getBackupStatus();
+            console.log(chalk_1.default.white("  副回線: ") +
+                (backupStatus?.connected
+                    ? chalk_1.default.green.bold("接続中")
+                    : chalk_1.default.yellow("再接続中")));
+            if (backupStatus?.socketId != null) {
+                console.log(chalk_1.default.white("  副回線 SocketID: ") + chalk_1.default.white(String(backupStatus.socketId)));
+            }
+        }
+        else {
+            console.log(chalk_1.default.white("  副回線: ") + chalk_1.default.gray("未起動"));
+        }
+    }
+    console.log();
+}
+function handleConfig() {
+    (0, config_1.printConfig)();
+}
+async function handleContract(ctx) {
+    console.log(chalk_1.default.gray("  契約情報を取得中..."));
+    const classifications = await (0, rest_client_1.listContracts)(ctx.config.apiKey);
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  契約済み区分:"));
+    if (classifications.length === 0) {
+        console.log(chalk_1.default.gray("  (なし)"));
+    }
+    else {
+        for (const c of classifications) {
+            console.log(chalk_1.default.white(`  - ${c}`));
+        }
+    }
+    console.log();
+}
+async function handleSocket(ctx) {
+    console.log(chalk_1.default.gray("  ソケット情報を取得中..."));
+    const res = await (0, rest_client_1.listSockets)(ctx.config.apiKey);
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  接続中のソケット:"));
+    if (res.items.length === 0) {
+        console.log(chalk_1.default.gray("  (なし)"));
+    }
+    else {
+        for (const s of res.items) {
+            console.log(chalk_1.default.white(`  id=${s.id}`) +
+                chalk_1.default.gray(` status=${s.status}`) +
+                chalk_1.default.gray(` app=${s.appName || "---"}`) +
+                chalk_1.default.gray(` start=${s.start}`));
+        }
+    }
+    console.log();
+}
+function handleColors() {
+    const termWidth = process.stdout.columns || 80;
+    const palette = themeModule.getPalette();
+    const PALETTE_USAGE = {
+        gray: "低優先度・補助テキスト",
+        sky: "通常・長周期階級1",
+        blue: "震度3",
+        blueGreen: "震度4・津波なし",
+        yellow: "震度5弱・M3+",
+        orange: "警告レベル",
+        vermillion: "危険レベル",
+        raspberry: "取消・キャンセル",
+        darkRed: "最高警戒 (背景用)",
+    };
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  CUD カラーパレット:"));
+    if (themeModule.isCustomized()) {
+        console.log(chalk_1.default.gray("  (カスタムテーマ適用中)"));
+    }
+    console.log();
+    for (const name of themeModule.getPaletteNames()) {
+        const rgb = palette[name];
+        const swatch = chalk_1.default.rgb(rgb[0], rgb[1], rgb[2])("██");
+        const rgbStr = `(${rgb[0]}, ${rgb[1]}, ${rgb[2]})`;
+        console.log(`  ${swatch} ` +
+            chalk_1.default.white(name.padEnd(12)) +
+            chalk_1.default.gray(rgbStr.padEnd(16)) +
+            chalk_1.default.gray(PALETTE_USAGE[name] ?? ""));
+    }
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  震度カラー:"));
+    console.log();
+    const intensityKeys = ["1", "2", "3", "4", "5弱", "5強", "6弱", "6強", "7"];
+    const intensities = intensityKeys.map((key) => {
+        const label = `震度${key}`;
+        const style = (0, formatter_1.intensityColor)(key);
+        const role = getIntensityRole(key);
+        const resolved = role ? themeModule.getRole(role) : null;
+        return { label, key, style, resolved };
+    });
+    printColorGrid(termWidth, intensities, (item) => {
+        if (item.resolved?.bg && item.resolved?.fg) {
+            return renderFgBgItem(item.label, item.resolved.fg, item.resolved.bg, item.style);
+        }
+        return { cell: `${item.style("██")} ${item.style(item.label)}`, visualLen: (0, formatter_1.visualWidth)(item.label) + 3 };
+    });
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  長周期地震動階級カラー:"));
+    console.log();
+    const lgIntKeys = ["0", "1", "2", "3", "4"];
+    const lgInts = lgIntKeys.map((key) => {
+        const label = `階級${key}`;
+        const style = (0, formatter_1.lgIntensityColor)(key);
+        const role = getLgIntRole(key);
+        const resolved = role ? themeModule.getRole(role) : null;
+        return { label, key, style, resolved };
+    });
+    printColorGrid(termWidth, lgInts, (item) => {
+        if (item.resolved?.bg && item.resolved?.fg) {
+            return renderFgBgItem(item.label, item.resolved.fg, item.resolved.bg, item.style);
+        }
+        return { cell: `${item.style("██")} ${item.style(item.label)}`, visualLen: (0, formatter_1.visualWidth)(item.label) + 3 };
+    });
+    console.log();
+    console.log(chalk_1.default.cyan.bold("  フレームレベル:"));
+    console.log();
+    const frameRoles = [
+        { name: "critical", role: "frameCritical", label: "[緊急] 二重線" },
+        { name: "warning", role: "frameWarning", label: "[警告] 二重線" },
+        { name: "normal", role: "frameNormal", label: "[情報] 通常" },
+        { name: "info", role: "frameInfo", label: "[通知] 通常" },
+        { name: "cancel", role: "frameCancel", label: "[取消] 通常" },
+    ];
+    printColorGrid(termWidth, frameRoles, (lv) => {
+        const style = themeModule.getRoleChalk(lv.role);
+        const text = `${lv.name} ${lv.label}`;
+        return { cell: `${style("██")} ${style(text)}`, visualLen: (0, formatter_1.visualWidth)(text) + 3 };
+    });
+    console.log();
+}
+/** 構造的型ガード: backup 機能を持つ ConnectionManager か */
+function hasBackupSupport(m) {
+    return ("startBackup" in m &&
+        "stopBackup" in m &&
+        "isBackupRunning" in m &&
+        "getBackupStatus" in m);
+}
+/** コマンド名を解決する (case-insensitive + エイリアス) */
+function resolveCommand(ctx, input) {
+    const lower = input.toLowerCase();
+    for (const [name, entry] of Object.entries(ctx.commands)) {
+        if (name.toLowerCase() === lower)
+            return entry;
+    }
+    const canonical = exports.COMMAND_ALIASES[lower];
+    if (canonical != null)
+        return ctx.commands[canonical];
+    return undefined;
+}