aranea-sdk-cli 0.3.17 → 0.5.1

package/dist/commands/control.js

@@ -0,0 +1,700 @@
+"use strict";
+/**
+ * control command
+ *
+ * Control型（UIコンポーネント定義）の管理コマンド
+ *
+ * 安全設計:
+ * - list, show, sync: 許可
+ * - add: 類似チェック付きで許可
+ * - modify, delete: 禁止（Admin UIのみ）
+ *
+ * @see doc/APPS/araneaSDK/headDesign/59_METATRON_CONTROL_SUGGESTION.md Section 8
+ *
+ * Usage:
+ *   aranea-sdk control list [--category <category>] [--type <dataType>]
+ *   aranea-sdk control show <controlId>
+ *   aranea-sdk control sync [--dry-run]
+ *   aranea-sdk control add --id <id> --name <name> --category <category> [--dry-run]
+ */
+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.controlCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const admin = __importStar(require("firebase-admin"));
+const readline = __importStar(require("readline"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+// Firebase initialization helper
+let firebaseInitialized = false;
+function initializeFirebase() {
+    if (firebaseInitialized)
+        return;
+    // Try to find service account key in common locations
+    const keyPaths = [
+        process.env.GOOGLE_APPLICATION_CREDENTIALS,
+        path.resolve(__dirname, '../../../../KEY/mobesorder-firebase-adminsdk-fbsvc-8b62efc60c.json'),
+        path.resolve(process.cwd(), 'KEY/mobesorder-firebase-adminsdk-fbsvc-8b62efc60c.json'),
+    ].filter(Boolean);
+    let keyPath;
+    for (const p of keyPaths) {
+        if (fs.existsSync(p)) {
+            keyPath = p;
+            break;
+        }
+    }
+    if (!keyPath) {
+        throw new Error('Firebase service account key not found.\n' +
+            'Set GOOGLE_APPLICATION_CREDENTIALS environment variable or place key in KEY/ directory.');
+    }
+    admin.initializeApp({
+        credential: admin.credential.cert(keyPath),
+        projectId: 'mobesorder',
+    });
+    firebaseInitialized = true;
+}
+function getFirestore() {
+    initializeFirebase();
+    return admin.firestore();
+}
+// Built-in control definitions (synced from ControlRegistry)
+const BUILTIN_CONTROLS = [
+    // Boolean Controls
+    {
+        id: 'slide-switch',
+        displayName: 'スライドスイッチ',
+        description: 'ON/OFF切り替え用のスライドスイッチ',
+        category: 'Boolean',
+        subcategory: 'Switch',
+        dataTypes: ['boolean'],
+        protocols: ['mqtt', 'http', 'websocket'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(power|switch|toggle|on_off|enable|active|isOn)$'],
+            fieldLabelPatterns: ['電源', 'スイッチ', 'ON/OFF', 'オン', 'オフ', '有効', '無効'],
+            useCaseKeywords: ['電源制御', 'スイッチ操作', 'トグル'],
+            priority: 90,
+            exclusiveDataTypes: ['boolean'],
+        },
+        defaultProps: { labelTrue: 'ON', labelFalse: 'OFF', size: 'md' },
+        tags: ['switch', 'toggle', 'on/off', 'スイッチ', '電源'],
+        iconName: 'ToggleOn',
+        enabled: true,
+        isSystem: true,
+    },
+    {
+        id: 'status-led',
+        displayName: 'ステータスLED',
+        description: '状態表示用のLEDインジケータ（読取専用）',
+        category: 'Boolean',
+        subcategory: 'Indicator',
+        dataTypes: ['boolean'],
+        protocols: ['mqtt', 'http', 'websocket'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(status|state|is_.*|has_.*)$'],
+            fieldLabelPatterns: ['ステータス', '状態', 'インジケータ', 'ランプ'],
+            useCaseKeywords: ['状態表示', 'インジケータ', 'モニタリング'],
+            priority: 85,
+            exclusiveDataTypes: ['boolean'],
+        },
+        defaultProps: { operationMode: 'read', size: 'md' },
+        tags: ['led', 'indicator', 'status', 'ランプ', 'インジケータ'],
+        iconName: 'Circle',
+        enabled: true,
+        isSystem: true,
+    },
+    {
+        id: 'push-button',
+        displayName: '押しボタン',
+        description: 'アクション実行用の押しボタン',
+        category: 'Boolean',
+        subcategory: 'Button',
+        dataTypes: ['boolean'],
+        protocols: ['mqtt', 'http', 'websocket'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(button|trigger|action|execute|run)$'],
+            fieldLabelPatterns: ['ボタン', 'トリガー', '実行', 'アクション'],
+            useCaseKeywords: ['ワンショット', 'トリガー', 'アクション実行'],
+            priority: 80,
+            exclusiveDataTypes: ['boolean'],
+        },
+        defaultProps: { size: 'md' },
+        tags: ['button', 'push', 'momentary', 'ボタン', 'プッシュ'],
+        iconName: 'TouchApp',
+        enabled: true,
+        isSystem: true,
+    },
+    // Numeric Controls
+    {
+        id: 'slider',
+        displayName: 'スライダー',
+        description: '範囲内の数値を選択するスライダー',
+        category: 'Numeric',
+        subcategory: 'Slider',
+        dataTypes: ['number'],
+        protocols: ['mqtt', 'http', 'websocket', 'modbus', 'opcua'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(level|brightness|volume|speed|rate|percent|ratio)$'],
+            fieldLabelPatterns: ['レベル', '明るさ', '音量', '速度', '割合', 'パーセント'],
+            useCaseKeywords: ['調整', 'レベル制御', 'パーセンテージ'],
+            priority: 85,
+            exclusiveDataTypes: ['number'],
+        },
+        defaultProps: { min: 0, max: 100, step: 1, size: 'md' },
+        tags: ['slider', 'range', 'スライダー', '範囲', 'レベル'],
+        iconName: 'Tune',
+        enabled: true,
+        isSystem: true,
+    },
+    {
+        id: 'circular-gauge',
+        displayName: '円形ゲージ',
+        description: '円形のゲージで数値を表示（読取専用）',
+        category: 'Numeric',
+        subcategory: 'Gauge',
+        dataTypes: ['number'],
+        protocols: ['mqtt', 'http', 'websocket', 'modbus', 'opcua', 'bacnet'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(temperature|humidity|pressure|voltage|current|power|energy)$'],
+            fieldLabelPatterns: ['温度', '湿度', '気圧', '電圧', '電流', '電力', 'エネルギー', 'センサー値'],
+            useCaseKeywords: ['センサー表示', 'メーター', 'ゲージ', '計測値'],
+            priority: 90,
+            exclusiveDataTypes: ['number'],
+        },
+        defaultProps: { operationMode: 'read', min: 0, max: 100, size: 'md' },
+        tags: ['gauge', 'meter', 'dial', 'ゲージ', 'メーター', '円形'],
+        iconName: 'Speed',
+        enabled: true,
+        isSystem: true,
+    },
+    // String Controls
+    {
+        id: 'text-input',
+        displayName: 'テキスト入力',
+        description: '単一行テキスト入力フィールド',
+        category: 'String',
+        subcategory: 'Input',
+        dataTypes: ['string'],
+        protocols: ['mqtt', 'http', 'websocket'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(name|label|title|description|comment|note)$'],
+            fieldLabelPatterns: ['名前', 'ラベル', 'タイトル', '説明', 'コメント', 'メモ'],
+            useCaseKeywords: ['テキスト入力', '名前設定', 'ラベル設定'],
+            priority: 80,
+            exclusiveDataTypes: ['string'],
+        },
+        defaultProps: { size: 'md' },
+        tags: ['text', 'input', 'field', 'テキスト', '入力'],
+        iconName: 'TextFields',
+        enabled: true,
+        isSystem: true,
+    },
+    {
+        id: 'dropdown',
+        displayName: 'ドロップダウン',
+        description: '選択肢からひとつを選ぶドロップダウン',
+        category: 'String',
+        subcategory: 'Select',
+        dataTypes: ['string', 'enum'],
+        protocols: ['mqtt', 'http', 'websocket'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(mode|type|category|option|select|choice)$'],
+            fieldLabelPatterns: ['モード', 'タイプ', 'カテゴリ', 'オプション', '選択', '種類'],
+            useCaseKeywords: ['選択', 'モード切替', 'オプション選択'],
+            priority: 85,
+            exclusiveDataTypes: ['string', 'enum'],
+        },
+        defaultProps: { size: 'md' },
+        tags: ['dropdown', 'select', 'choice', 'ドロップダウン', '選択'],
+        iconName: 'ArrowDropDown',
+        enabled: true,
+        isSystem: true,
+    },
+    {
+        id: 'label-display',
+        displayName: 'ラベル表示',
+        description: 'テキストを読取専用で表示',
+        category: 'String',
+        subcategory: 'Display',
+        dataTypes: ['string'],
+        protocols: ['mqtt', 'http', 'websocket'],
+        platforms: ['aranea', 'switchbot', 'tuya', 'ewelink'],
+        suggestionRules: {
+            fieldNamePatterns: ['^(message|info|text|display|output)$'],
+            fieldLabelPatterns: ['メッセージ', '情報', 'テキスト', '表示', '出力'],
+            useCaseKeywords: ['情報表示', 'ステータステキスト', 'メッセージ表示'],
+            priority: 75,
+            exclusiveDataTypes: ['string'],
+        },
+        defaultProps: { operationMode: 'read', size: 'md' },
+        tags: ['label', 'display', 'text', 'ラベル', '表示'],
+        iconName: 'Label',
+        enabled: true,
+        isSystem: true,
+    },
+];
+// Helper: Prompt for confirmation
+async function promptConfirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${message} (y/N): `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
+// Calculate Levenshtein distance
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= a.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= b.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            if (a[i - 1] === b[j - 1]) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+            }
+        }
+    }
+    return matrix[a.length][b.length];
+}
+// Calculate string similarity (0-1)
+function stringSimilarity(a, b) {
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 1;
+    return 1 - levenshteinDistance(a.toLowerCase(), b.toLowerCase()) / maxLen;
+}
+// Calculate control similarity
+function calculateControlSimilarity(newControl, existing) {
+    let score = 0;
+    let weight = 0;
+    // displayName similarity (30%)
+    if (newControl.displayName && existing.displayName) {
+        score += stringSimilarity(newControl.displayName, existing.displayName) * 0.3;
+        weight += 0.3;
+    }
+    // dataTypes overlap (30%)
+    if (newControl.dataTypes && existing.dataTypes) {
+        const overlap = newControl.dataTypes.filter(t => existing.dataTypes.includes(t)).length;
+        score += (overlap / Math.max(newControl.dataTypes.length, existing.dataTypes.length)) * 0.3;
+        weight += 0.3;
+    }
+    // category match (20%)
+    if (newControl.category && existing.category) {
+        score += (newControl.category === existing.category ? 1 : 0) * 0.2;
+        weight += 0.2;
+    }
+    // tags overlap (20%)
+    if (newControl.tags && existing.tags) {
+        const overlap = newControl.tags.filter(t => existing.tags.includes(t)).length;
+        score += (overlap / Math.max(newControl.tags.length, existing.tags.length)) * 0.2;
+        weight += 0.2;
+    }
+    return weight > 0 ? score / weight : 0;
+}
+// Detect similar controls
+async function detectSimilarControls(db, newControl) {
+    const snapshot = await db.collection('araneaControlDefinitions')
+        .where('isDeleted', '==', false)
+        .get();
+    const matches = [];
+    for (const doc of snapshot.docs) {
+        const existing = { id: doc.id, ...doc.data() };
+        const similarity = calculateControlSimilarity(newControl, existing);
+        if (similarity >= 0.7) {
+            matches.push({ ...existing, similarity });
+        }
+    }
+    return matches.sort((a, b) => b.similarity - a.similarity);
+}
+// Command implementation
+exports.controlCommand = new commander_1.Command('control')
+    .description('Control型（UIコンポーネント定義）の管理');
+// control list
+exports.controlCommand
+    .command('list')
+    .description('利用可能なコントロール一覧を表示')
+    .option('-c, --category <category>', 'カテゴリでフィルタ')
+    .option('-t, --type <dataType>', 'データ型でフィルタ')
+    .option('--include-deleted', '削除済みも表示')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('コントロール一覧を取得中...').start();
+    try {
+        initializeFirebase();
+        const db = getFirestore();
+        let query = db.collection('araneaControlDefinitions');
+        if (!options.includeDeleted) {
+            query = query.where('isDeleted', '==', false);
+        }
+        const snapshot = await query.get();
+        if (snapshot.empty) {
+            spinner.warn('コントロールが見つかりません');
+            console.log(chalk_1.default.yellow('\nヒント: `aranea-sdk control sync` でビルトインコントロールを同期してください'));
+            return;
+        }
+        let controls = snapshot.docs.map(doc => ({
+            id: doc.id,
+            ...doc.data(),
+        }));
+        // Apply filters
+        if (options.category) {
+            controls = controls.filter(c => c.category === options.category);
+        }
+        if (options.type) {
+            controls = controls.filter(c => c.dataTypes.includes(options.type));
+        }
+        spinner.succeed(`${controls.length} 件のコントロールを取得しました`);
+        console.log('\n' + chalk_1.default.bold('=== コントロール一覧 ==='));
+        console.log('');
+        // Group by category
+        const byCategory = controls.reduce((acc, c) => {
+            if (!acc[c.category])
+                acc[c.category] = [];
+            acc[c.category].push(c);
+            return acc;
+        }, {});
+        for (const [category, items] of Object.entries(byCategory)) {
+            console.log(chalk_1.default.cyan.bold(`[${category}]`));
+            for (const c of items) {
+                const systemBadge = c.isSystem ? chalk_1.default.gray('[System]') : chalk_1.default.blue('[Custom]');
+                const enabledBadge = c.enabled ? chalk_1.default.green('✓') : chalk_1.default.red('✗');
+                const refCount = c.referenceCount > 0 ? chalk_1.default.yellow(`(${c.referenceCount} refs)`) : '';
+                console.log(`  ${enabledBadge} ${c.id} ${systemBadge} ${refCount}`);
+                console.log(`      ${c.displayName} - ${c.description}`);
+                console.log(`      DataTypes: ${c.dataTypes.join(', ')}`);
+            }
+            console.log('');
+        }
+    }
+    catch (error) {
+        spinner.fail('エラーが発生しました');
+        console.error(chalk_1.default.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// control show
+exports.controlCommand
+    .command('show <controlId>')
+    .description('コントロールの詳細を表示')
+    .action(async (controlId) => {
+    const spinner = (0, ora_1.default)(`コントロール "${controlId}" を取得中...`).start();
+    try {
+        initializeFirebase();
+        const db = getFirestore();
+        const doc = await db.collection('araneaControlDefinitions').doc(controlId).get();
+        if (!doc.exists) {
+            spinner.fail(`コントロール "${controlId}" が見つかりません`);
+            process.exit(1);
+        }
+        const control = { id: doc.id, ...doc.data() };
+        spinner.succeed('コントロール詳細を取得しました');
+        console.log('');
+        console.log(chalk_1.default.bold('=== コントロール詳細 ==='));
+        console.log('');
+        console.log(`${chalk_1.default.cyan('ID:')} ${control.id}`);
+        console.log(`${chalk_1.default.cyan('表示名:')} ${control.displayName}`);
+        console.log(`${chalk_1.default.cyan('説明:')} ${control.description}`);
+        console.log(`${chalk_1.default.cyan('カテゴリ:')} ${control.category}${control.subcategory ? ` / ${control.subcategory}` : ''}`);
+        console.log(`${chalk_1.default.cyan('データ型:')} ${control.dataTypes.join(', ')}`);
+        console.log(`${chalk_1.default.cyan('プロトコル:')} ${control.protocols.join(', ')}`);
+        console.log(`${chalk_1.default.cyan('プラットフォーム:')} ${control.platforms.join(', ')}`);
+        console.log(`${chalk_1.default.cyan('タグ:')} ${control.tags.join(', ')}`);
+        console.log(`${chalk_1.default.cyan('アイコン:')} ${control.iconName}`);
+        console.log(`${chalk_1.default.cyan('有効:')} ${control.enabled ? 'Yes' : 'No'}`);
+        console.log('');
+        console.log(chalk_1.default.bold('--- 安全情報 ---'));
+        console.log(`${chalk_1.default.cyan('システム定義:')} ${control.isSystem ? 'Yes (変更不可)' : 'No'}`);
+        console.log(`${chalk_1.default.cyan('参照カウント:')} ${control.referenceCount}`);
+        console.log(`${chalk_1.default.cyan('削除済み:')} ${control.isDeleted ? 'Yes' : 'No'}`);
+        if (control.createdByLacisId) {
+            console.log(`${chalk_1.default.cyan('作成者:')} ${control.createdByLacisId}`);
+        }
+        console.log('');
+        console.log(chalk_1.default.bold('--- サジェストルール ---'));
+        console.log(JSON.stringify(control.suggestionRules, null, 2));
+        console.log('');
+        console.log(chalk_1.default.bold('--- デフォルトProps ---'));
+        console.log(JSON.stringify(control.defaultProps, null, 2));
+    }
+    catch (error) {
+        spinner.fail('エラーが発生しました');
+        console.error(chalk_1.default.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// control sync
+exports.controlCommand
+    .command('sync')
+    .description('ビルトインコントロールをFirestoreに同期')
+    .option('--dry-run', '実際の書き込みを行わずプレビュー')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('ビルトインコントロールを同期中...').start();
+    try {
+        initializeFirebase();
+        const db = getFirestore();
+        const collectionRef = db.collection('araneaControlDefinitions');
+        // Get existing controls
+        const existingSnapshot = await collectionRef.get();
+        const existingData = new Map();
+        existingSnapshot.forEach(doc => {
+            existingData.set(doc.id, { id: doc.id, ...doc.data() });
+        });
+        spinner.info(`既存コントロール: ${existingData.size} 件`);
+        let createdCount = 0;
+        let updatedCount = 0;
+        let skippedCount = 0;
+        for (const def of BUILTIN_CONTROLS) {
+            const existing = existingData.get(def.id);
+            if (!existing) {
+                // Create new
+                console.log(chalk_1.default.green(`  [CREATE] ${def.id}: ${def.displayName}`));
+                if (!options.dryRun) {
+                    await collectionRef.doc(def.id).set({
+                        ...def,
+                        referenceCount: 0,
+                        isDeleted: false,
+                        createdAt: admin.firestore.FieldValue.serverTimestamp(),
+                        updatedAt: admin.firestore.FieldValue.serverTimestamp(),
+                    });
+                }
+                createdCount++;
+            }
+            else if (existing.isSystem === false) {
+                // Skip custom controls
+                console.log(chalk_1.default.gray(`  [SKIP] ${def.id}: カスタム定義のため同期対象外`));
+                skippedCount++;
+            }
+            else {
+                // Update system control
+                console.log(chalk_1.default.blue(`  [UPDATE] ${def.id}: ${def.displayName}`));
+                if (!options.dryRun) {
+                    await collectionRef.doc(def.id).update({
+                        ...def,
+                        // Preserve these fields
+                        referenceCount: existing.referenceCount || 0,
+                        isDeleted: false,
+                        createdAt: existing.createdAt,
+                        updatedAt: admin.firestore.FieldValue.serverTimestamp(),
+                    });
+                }
+                updatedCount++;
+            }
+        }
+        spinner.succeed('同期完了');
+        console.log('');
+        console.log(chalk_1.default.bold('=== 同期結果 ==='));
+        console.log(`  新規作成: ${createdCount} 件`);
+        console.log(`  更新: ${updatedCount} 件`);
+        console.log(`  スキップ: ${skippedCount} 件`);
+        if (options.dryRun) {
+            console.log('');
+            console.log(chalk_1.default.yellow('(Dry Run モード - 実際の変更は行われていません)'));
+        }
+    }
+    catch (error) {
+        spinner.fail('エラーが発生しました');
+        console.error(chalk_1.default.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// control add (with similarity check)
+exports.controlCommand
+    .command('add')
+    .description('カスタムコントロールを追加（類似チェック付き）')
+    .requiredOption('--id <id>', 'コントロールID')
+    .requiredOption('--name <name>', '表示名')
+    .requiredOption('--category <category>', 'カテゴリ (Boolean, Numeric, String)')
+    .option('--description <desc>', '説明')
+    .option('--data-types <types>', 'データ型 (カンマ区切り)', 'string')
+    .option('--dry-run', '実際の書き込みを行わずプレビュー')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('コントロール追加の準備中...').start();
+    try {
+        initializeFirebase();
+        const db = getFirestore();
+        // Check if ID already exists
+        const existingDoc = await db.collection('araneaControlDefinitions').doc(options.id).get();
+        if (existingDoc.exists) {
+            spinner.fail(`コントロールID "${options.id}" は既に存在します`);
+            process.exit(1);
+        }
+        // Build new control
+        const newControl = {
+            id: options.id,
+            displayName: options.name,
+            description: options.description || '',
+            category: options.category,
+            dataTypes: options.dataTypes.split(',').map((t) => t.trim()),
+            tags: [],
+        };
+        // Check for similar controls
+        spinner.text = '類似コントロールを検索中...';
+        const similarControls = await detectSimilarControls(db, newControl);
+        spinner.stop();
+        if (similarControls.length > 0) {
+            console.log('');
+            console.log(chalk_1.default.yellow.bold('⚠️  類似するコントロールが見つかりました:'));
+            console.log('');
+            for (let i = 0; i < Math.min(5, similarControls.length); i++) {
+                const sc = similarControls[i];
+                const similarity = Math.round(sc.similarity * 100);
+                console.log(`  ${i + 1}. ${chalk_1.default.cyan(sc.id)} (${sc.displayName}) - 類似度: ${chalk_1.default.yellow(`${similarity}%`)}`);
+                console.log(`     ${sc.description}`);
+                console.log(`     DataTypes: ${sc.dataTypes.join(', ')}`);
+                console.log('');
+            }
+            if (!options.dryRun) {
+                const confirmed = await promptConfirm('本当に新規作成しますか？');
+                if (!confirmed) {
+                    console.log(chalk_1.default.gray('キャンセルしました'));
+                    process.exit(0);
+                }
+            }
+        }
+        if (options.dryRun) {
+            console.log('');
+            console.log(chalk_1.default.bold('=== 作成予定のコントロール ==='));
+            console.log(JSON.stringify(newControl, null, 2));
+            console.log('');
+            console.log(chalk_1.default.yellow('(Dry Run モード - 実際の作成は行われていません)'));
+            return;
+        }
+        // Create the control
+        const controlData = {
+            ...newControl,
+            protocols: ['mqtt', 'http'],
+            platforms: ['aranea'],
+            suggestionRules: { priority: 50 },
+            defaultProps: {},
+            iconName: 'Extension',
+            enabled: true,
+            isSystem: false,
+            // Note: createdByLacisId should be set from auth context in production
+            referenceCount: 0,
+            isDeleted: false,
+            createdAt: admin.firestore.FieldValue.serverTimestamp(),
+            updatedAt: admin.firestore.FieldValue.serverTimestamp(),
+        };
+        await db.collection('araneaControlDefinitions').doc(options.id).set(controlData);
+        console.log('');
+        console.log(chalk_1.default.green.bold(`✓ コントロール "${options.id}" を作成しました`));
+    }
+    catch (error) {
+        spinner.fail('エラーが発生しました');
+        console.error(chalk_1.default.red(error instanceof Error ? error.message : String(error)));
+        process.exit(1);
+    }
+});
+// ============================================================
+// FORBIDDEN COMMANDS - These must show error messages
+// ============================================================
+// control modify (FORBIDDEN)
+exports.controlCommand
+    .command('modify <controlId>')
+    .description('コントロールを変更（禁止）')
+    .action(async (controlId) => {
+    console.log('');
+    console.log(chalk_1.default.red.bold('❌ エラー: Control変更はAdmin UIからのみ実行可能です。'));
+    console.log('');
+    console.log(chalk_1.default.yellow('理由:'));
+    console.log('  - システム定義コントロールの変更は禁止されています');
+    console.log('  - カスタムコントロールは所有者のみ変更可能です');
+    console.log('  - 変更にはUI上での確認ダイアログが必要です');
+    console.log('');
+    console.log(chalk_1.default.cyan('代わりに以下にアクセスしてください:'));
+    console.log(`  ${chalk_1.default.underline('https://mobesorder.web.app/admin/aranea/controls')}`);
+    console.log('');
+    process.exit(1);
+});
+// control delete (FORBIDDEN)
+exports.controlCommand
+    .command('delete <controlId>')
+    .description('コントロールを削除（禁止）')
+    .action(async (controlId) => {
+    console.log('');
+    console.log(chalk_1.default.red.bold('❌ エラー: Control削除はAdmin UIからのみ実行可能です。'));
+    console.log('');
+    console.log(chalk_1.default.yellow('理由:'));
+    console.log('  - システム定義コントロールは削除できません');
+    console.log('  - 削除には参照チェックが必要です（使用中のスキーマがある場合は削除不可）');
+    console.log('  - 削除には確認ダイアログと論理削除処理が必要です');
+    console.log('');
+    console.log(chalk_1.default.cyan('代わりに以下にアクセスしてください:'));
+    console.log(`  ${chalk_1.default.underline('https://mobesorder.web.app/admin/aranea/controls')}`);
+    console.log('');
+    process.exit(1);
+});
+// Alias commands that also need to be blocked
+exports.controlCommand
+    .command('update <controlId>')
+    .description('コントロールを更新（禁止）')
+    .action(async () => {
+    console.log('');
+    console.log(chalk_1.default.red.bold('❌ エラー: Control更新はAdmin UIからのみ実行可能です。'));
+    console.log('');
+    console.log(chalk_1.default.cyan('詳細は `aranea-sdk control modify --help` を参照してください'));
+    process.exit(1);
+});
+exports.controlCommand
+    .command('remove <controlId>')
+    .description('コントロールを削除（禁止）')
+    .action(async () => {
+    console.log('');
+    console.log(chalk_1.default.red.bold('❌ エラー: Control削除はAdmin UIからのみ実行可能です。'));
+    console.log('');
+    console.log(chalk_1.default.cyan('詳細は `aranea-sdk control delete --help` を参照してください'));
+    process.exit(1);
+});