aranea-sdk-cli 0.1.4 → 0.3.0

package/dist/commands/knowledge.js

@@ -0,0 +1,374 @@
+"use strict";
+/**
+ * knowledge コマンド - ナレッジベース管理
+ *
+ * Usage:
+ *   aranea-sdk knowledge add --title "..." --content "..." --category guide
+ *   aranea-sdk knowledge search --query "state report"
+ *   aranea-sdk knowledge list --category api
+ *   aranea-sdk knowledge get --id <id>
+ *
+ * @see doc/APPS/araneaSDK/headDesign/20_ARANEA_METATRON_ARCHITECTURE.md
+ */
+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.knowledgeCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const axios_1 = __importDefault(require("axios"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ============================================================================
+// Config
+// ============================================================================
+const KNOWLEDGE_API_BASE = 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaSDK_knowledgeManagement';
+// カテゴリ定義
+const CATEGORIES = ['api', 'guide', 'code', 'reference', 'incident', 'tip'];
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Firebase Auth トークンを環境変数から取得
+ */
+function getAuthToken() {
+    return process.env.ARANEA_AUTH_TOKEN || process.env.FIREBASE_AUTH_TOKEN || null;
+}
+/**
+ * API呼び出し（Callable形式）
+ */
+async function callKnowledgeAPI(action, params, token) {
+    const response = await axios_1.default.post(KNOWLEDGE_API_BASE, { data: { action, ...params } }, {
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+        },
+    });
+    if (response.data.error) {
+        throw new Error(response.data.error.message || response.data.error);
+    }
+    return response.data.result;
+}
+/**
+ * ナレッジエントリのフォーマット表示
+ */
+function formatEntry(entry, detailed = false) {
+    const statusIcon = entry.status === 'published'
+        ? chalk_1.default.green('●')
+        : entry.status === 'draft'
+            ? chalk_1.default.yellow('○')
+            : chalk_1.default.gray('◌');
+    console.log(`${statusIcon} ${chalk_1.default.bold(entry.title)}`);
+    console.log(`   ID: ${chalk_1.default.gray(entry.id)}`);
+    console.log(`   Category: ${chalk_1.default.cyan(entry.category)} | Version: ${entry.version}`);
+    console.log(`   Keywords: ${(entry.keywords || []).slice(0, 5).join(', ')}`);
+    if (entry.viewCount !== undefined || entry.usefulCount !== undefined) {
+        console.log(`   Stats: 👁 ${entry.viewCount || 0} views | 👍 ${entry.usefulCount || 0} useful`);
+    }
+    if (detailed && entry.content) {
+        console.log('');
+        console.log(chalk_1.default.gray('─'.repeat(60)));
+        console.log(entry.content);
+        if (entry.codeExample) {
+            console.log('');
+            console.log(chalk_1.default.cyan('Code Example:'));
+            console.log(chalk_1.default.gray(entry.codeExample));
+        }
+        console.log(chalk_1.default.gray('─'.repeat(60)));
+    }
+    console.log('');
+}
+// ============================================================================
+// Commands
+// ============================================================================
+exports.knowledgeCommand = new commander_1.Command('knowledge').description('AraneaMetatron ナレッジベース管理');
+// knowledge add
+exports.knowledgeCommand
+    .command('add')
+    .description('ナレッジエントリを追加')
+    .requiredOption('-t, --title <title>', 'タイトル')
+    .requiredOption('-c, --category <category>', `カテゴリ (${CATEGORIES.join('|')})`)
+    .option('--content <content>', '本文 (Markdown)')
+    .option('-f, --file <path>', 'ファイルから本文を読み込み')
+    .option('--code <code>', 'コードサンプル')
+    .option('--code-file <path>', 'ファイルからコードサンプルを読み込み')
+    .option('-k, --keywords <keywords>', 'キーワード (カンマ区切り)')
+    .option('--device-types <types>', '関連デバイスタイプ (カンマ区切り)')
+    .option('--status <status>', 'ステータス (draft|published)', 'draft')
+    .option('--token <token>', '認証トークン')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== Knowledge Add ===\n'));
+        // 認証トークン
+        const token = options.token || getAuthToken();
+        if (!token) {
+            console.error(chalk_1.default.red('❌ 認証トークンが必要です。--token または ARANEA_AUTH_TOKEN 環境変数を設定'));
+            process.exit(1);
+        }
+        // カテゴリ検証
+        if (!CATEGORIES.includes(options.category)) {
+            console.error(chalk_1.default.red(`❌ 無効なカテゴリ: ${options.category}`));
+            console.error(`   有効なカテゴリ: ${CATEGORIES.join(', ')}`);
+            process.exit(1);
+        }
+        // 本文取得
+        let content = options.content || '';
+        if (options.file) {
+            const filePath = path.resolve(options.file);
+            if (!fs.existsSync(filePath)) {
+                console.error(chalk_1.default.red(`❌ ファイルが見つかりません: ${filePath}`));
+                process.exit(1);
+            }
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        if (!content) {
+            console.error(chalk_1.default.red('❌ --content または --file で本文を指定してください'));
+            process.exit(1);
+        }
+        // コードサンプル取得
+        let codeExample = options.code;
+        if (options.codeFile) {
+            const codePath = path.resolve(options.codeFile);
+            if (fs.existsSync(codePath)) {
+                codeExample = fs.readFileSync(codePath, 'utf-8');
+            }
+        }
+        // キーワード解析
+        const keywords = options.keywords
+            ? options.keywords.split(',').map((k) => k.trim())
+            : [];
+        const deviceTypes = options.deviceTypes
+            ? options.deviceTypes.split(',').map((t) => t.trim())
+            : [];
+        const spinner = (0, ora_1.default)('ナレッジ追加中...').start();
+        const result = await callKnowledgeAPI('create', {
+            data: {
+                title: options.title,
+                category: options.category,
+                content,
+                codeExample,
+                keywords,
+                relatedDeviceTypes: deviceTypes,
+                status: options.status,
+            },
+        }, token);
+        spinner.stop();
+        if (result.success) {
+            console.log(chalk_1.default.green('✓ ナレッジエントリを追加しました'));
+            console.log(`   ID: ${result.id}`);
+            console.log(`   Title: ${options.title}`);
+            console.log(`   Category: ${options.category}`);
+            console.log(`   Status: ${options.status}`);
+        }
+        else {
+            console.log(chalk_1.default.red(`✗ 追加失敗: ${result.error}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// knowledge search
+exports.knowledgeCommand
+    .command('search')
+    .description('ナレッジを検索')
+    .requiredOption('-q, --query <query>', '検索クエリ')
+    .option('-c, --category <category>', 'カテゴリフィルタ')
+    .option('-l, --limit <limit>', '結果数', '10')
+    .option('--token <token>', '認証トークン')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== Knowledge Search ===\n'));
+        const token = options.token || getAuthToken();
+        if (!token) {
+            console.error(chalk_1.default.red('❌ 認証トークンが必要です'));
+            process.exit(1);
+        }
+        const spinner = (0, ora_1.default)(`"${options.query}" を検索中...`).start();
+        const result = await callKnowledgeAPI('search', {
+            query: options.query,
+            category: options.category,
+            limit: parseInt(options.limit, 10),
+        }, token);
+        spinner.stop();
+        if (result.success && result.data) {
+            const entries = Array.isArray(result.data) ? result.data : [];
+            console.log(chalk_1.default.cyan(`${entries.length} 件見つかりました\n`));
+            for (const entry of entries) {
+                formatEntry(entry);
+            }
+            if (entries.length === 0) {
+                console.log(chalk_1.default.gray('検索結果がありません'));
+            }
+        }
+        else {
+            console.log(chalk_1.default.red(`✗ 検索失敗: ${result.error}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// knowledge list
+exports.knowledgeCommand
+    .command('list')
+    .description('ナレッジ一覧を表示')
+    .option('-c, --category <category>', 'カテゴリフィルタ')
+    .option('-s, --status <status>', 'ステータスフィルタ (draft|published|archived)')
+    .option('-l, --limit <limit>', '表示数', '20')
+    .option('--token <token>', '認証トークン')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== Knowledge List ===\n'));
+        const token = options.token || getAuthToken();
+        if (!token) {
+            console.error(chalk_1.default.red('❌ 認証トークンが必要です'));
+            process.exit(1);
+        }
+        const spinner = (0, ora_1.default)('ナレッジ一覧を取得中...').start();
+        const result = await callKnowledgeAPI('list', {
+            category: options.category,
+            status: options.status,
+            limit: parseInt(options.limit, 10),
+        }, token);
+        spinner.stop();
+        if (result.success && result.data) {
+            const entries = Array.isArray(result.data) ? result.data : [];
+            console.log(chalk_1.default.cyan(`${entries.length} 件\n`));
+            for (const entry of entries) {
+                formatEntry(entry);
+            }
+            if (entries.length === 0) {
+                console.log(chalk_1.default.gray('ナレッジエントリがありません'));
+            }
+        }
+        else {
+            console.log(chalk_1.default.red(`✗ 取得失敗: ${result.error}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// knowledge get
+exports.knowledgeCommand
+    .command('get')
+    .description('ナレッジエントリを取得')
+    .requiredOption('-i, --id <id>', 'エントリID')
+    .option('--token <token>', '認証トークン')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== Knowledge Get ===\n'));
+        const token = options.token || getAuthToken();
+        if (!token) {
+            console.error(chalk_1.default.red('❌ 認証トークンが必要です'));
+            process.exit(1);
+        }
+        const spinner = (0, ora_1.default)('ナレッジを取得中...').start();
+        const result = await callKnowledgeAPI('get', { id: options.id }, token);
+        spinner.stop();
+        if (result.success && result.data) {
+            formatEntry(result.data, true);
+        }
+        else {
+            console.log(chalk_1.default.red(`✗ 取得失敗: ${result.error}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// knowledge delete
+exports.knowledgeCommand
+    .command('delete')
+    .description('ナレッジエントリを削除 (アーカイブ)')
+    .requiredOption('-i, --id <id>', 'エントリID')
+    .option('--token <token>', '認証トークン')
+    .option('-y, --yes', '確認をスキップ')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.bold('\n=== Knowledge Delete ===\n'));
+        const token = options.token || getAuthToken();
+        if (!token) {
+            console.error(chalk_1.default.red('❌ 認証トークンが必要です'));
+            process.exit(1);
+        }
+        if (!options.yes) {
+            console.log(chalk_1.default.yellow(`⚠ エントリ ${options.id} をアーカイブします`));
+            console.log(chalk_1.default.gray('  (--yes オプションで確認をスキップ)'));
+            // Note: In a real CLI, would use inquirer for confirmation
+        }
+        const spinner = (0, ora_1.default)('削除中...').start();
+        const result = await callKnowledgeAPI('delete', { id: options.id }, token);
+        spinner.stop();
+        if (result.success) {
+            console.log(chalk_1.default.green('✓ ナレッジエントリをアーカイブしました'));
+        }
+        else {
+            console.log(chalk_1.default.red(`✗ 削除失敗: ${result.error}`));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// knowledge categories
+exports.knowledgeCommand
+    .command('categories')
+    .description('利用可能なカテゴリ一覧')
+    .action(() => {
+    console.log(chalk_1.default.bold('\n=== Knowledge Categories ===\n'));
+    const categoryDescriptions = {
+        api: 'API仕様・エンドポイント',
+        guide: '実装ガイド・チュートリアル',
+        code: 'コードサンプル・スニペット',
+        reference: 'リファレンス・仕様書',
+        incident: 'インシデント・トラブルシューティング',
+        tip: 'Tips・ノウハウ',
+    };
+    for (const cat of CATEGORIES) {
+        console.log(`  ${chalk_1.default.cyan(cat.padEnd(12))} ${categoryDescriptions[cat]}`);
+    }
+    console.log('');
+});
+exports.default = exports.knowledgeCommand;

package/dist/commands/metatron.d.ts

@@ -0,0 +1,12 @@
+/**
+ * metatron コマンド - AraneaMetatron AI対話
+ *
+ * Usage:
+ *   aranea-sdk metatron ask "State Reportの送信方法は？"
+ *   aranea-sdk metatron chat   # REPLモード
+ *
+ * @see doc/APPS/araneaSDK/headDesign/20_ARANEA_METATRON_ARCHITECTURE.md
+ */
+import { Command } from 'commander';
+export declare const metatronCommand: Command;
+export default metatronCommand;

package/dist/commands/metatron.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * metatron コマンド - AraneaMetatron AI対話
+ *
+ * Usage:
+ *   aranea-sdk metatron ask "State Reportの送信方法は？"
+ *   aranea-sdk metatron chat   # REPLモード
+ *
+ * @see doc/APPS/araneaSDK/headDesign/20_ARANEA_METATRON_ARCHITECTURE.md
+ */
+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.metatronCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const axios_1 = __importDefault(require("axios"));
+const readline = __importStar(require("readline"));
+// ============================================================================
+// Config
+// ============================================================================
+const METATRON_API_BASE = 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaSDK_metatronQuery';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Firebase Auth トークンを環境変数から取得
+ */
+function getAuthToken() {
+    return process.env.ARANEA_AUTH_TOKEN || process.env.FIREBASE_AUTH_TOKEN || null;
+}
+/**
+ * Metatron API呼び出し
+ */
+async function queryMetatron(query, context, token) {
+    const response = await axios_1.default.post(METATRON_API_BASE, { data: { query, context } }, {
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+        },
+        timeout: 60000, // 60秒タイムアウト
+    });
+    if (response.data.error) {
+        throw new Error(response.data.error.message || response.data.error);
+    }
+    return response.data.result || response.data;
+}
+/**
+ * 回答をフォーマット表示
+ */
+function formatAnswer(result) {
+    console.log('');
+    console.log(chalk_1.default.cyan('📝 Answer:'));
+    console.log(chalk_1.default.white(result.answer));
+    if (result.codeSnippet) {
+        console.log('');
+        console.log(chalk_1.default.cyan('💻 Code:'));
+        console.log(chalk_1.default.gray('─'.repeat(60)));
+        console.log(chalk_1.default.yellow(result.codeSnippet));
+        console.log(chalk_1.default.gray('─'.repeat(60)));
+    }
+    if (result.sources && result.sources.length > 0) {
+        console.log('');
+        console.log(chalk_1.default.gray(`📚 Sources: ${result.sources.join(', ')}`));
+    }
+    console.log('');
+}
+// ============================================================================
+// Commands
+// ============================================================================
+exports.metatronCommand = new commander_1.Command('metatron').description('AraneaMetatron AI対話 - AraneaSDK専門アシスタント');
+// metatron ask
+exports.metatronCommand
+    .command('ask <question>')
+    .description('単発質問')
+    .option('--context <context>', 'コンテキスト', 'aranea_sdk_cli')
+    .option('--token <token>', '認証トークン')
+    .option('--raw', 'JSON出力')
+    .action(async (question, options) => {
+    try {
+        if (!options.raw) {
+            console.log(chalk_1.default.bold('\n=== AraneaMetatron ===\n'));
+            console.log(chalk_1.default.gray(`Q: ${question}`));
+        }
+        const token = options.token || getAuthToken();
+        if (!token) {
+            console.error(chalk_1.default.red('❌ 認証トークンが必要です。--token または ARANEA_AUTH_TOKEN 環境変数を設定'));
+            process.exit(1);
+        }
+        const spinner = options.raw ? null : (0, ora_1.default)('回答生成中...').start();
+        const result = await queryMetatron(question, options.context, token);
+        spinner?.stop();
+        if (options.raw) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            formatAnswer(result);
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`エラー: ${error.message}`));
+        process.exit(1);
+    }
+});
+// metatron chat (REPL mode)
+exports.metatronCommand
+    .command('chat')
+    .description('対話モード (REPL)')
+    .option('--context <context>', 'コンテキスト', 'aranea_sdk_cli')
+    .option('--token <token>', '認証トークン')
+    .action(async (options) => {
+    console.log(chalk_1.default.bold('\n=== AraneaMetatron Chat ===\n'));
+    console.log(chalk_1.default.gray('AraneaSDKについて質問してください。'));
+    console.log(chalk_1.default.gray('終了するには "exit" または Ctrl+C を入力\n'));
+    const token = options.token || getAuthToken();
+    if (!token) {
+        console.error(chalk_1.default.red('❌ 認証トークンが必要です。--token または ARANEA_AUTH_TOKEN 環境変数を設定'));
+        process.exit(1);
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const askQuestion = () => {
+        rl.question(chalk_1.default.cyan('You: '), async (input) => {
+            const query = input.trim();
+            if (query.toLowerCase() === 'exit' || query.toLowerCase() === 'quit') {
+                console.log(chalk_1.default.gray('\nさようなら！\n'));
+                rl.close();
+                process.exit(0);
+            }
+            if (!query) {
+                askQuestion();
+                return;
+            }
+            const spinner = (0, ora_1.default)('').start();
+            spinner.text = '';
+            try {
+                const result = await queryMetatron(query, options.context, token);
+                spinner.stop();
+                console.log('');
+                console.log(chalk_1.default.green('Metatron:'), result.answer);
+                if (result.codeSnippet) {
+                    console.log('');
+                    console.log(chalk_1.default.gray('```'));
+                    console.log(chalk_1.default.yellow(result.codeSnippet));
+                    console.log(chalk_1.default.gray('```'));
+                }
+                console.log('');
+            }
+            catch (error) {
+                spinner.stop();
+                console.log(chalk_1.default.red(`Error: ${error.message}`));
+                console.log('');
+            }
+            askQuestion();
+        });
+    };
+    askQuestion();
+});
+// metatron topics
+exports.metatronCommand
+    .command('topics')
+    .description('対話可能なトピック一覧')
+    .action(() => {
+    console.log(chalk_1.default.bold('\n=== AraneaMetatron Topics ===\n'));
+    const topics = [
+        { topic: 'State Report API', example: 'State Reportの送信方法は？' },
+        { topic: 'デバイス登録', example: 'デバイス登録のフローを教えて' },
+        { topic: 'スキーマ設計', example: 'stateSchemaの設計ガイドは？' },
+        { topic: 'MQTT/コマンド', example: 'コマンド送信の仕組みは？' },
+        { topic: 'ESP32実装', example: 'ESP32のサンプルコードを見せて' },
+        { topic: 'デバイスタイプ', example: '利用可能なデバイスタイプは？' },
+        { topic: 'CelestialGlobe', example: 'トポロジーマップの使い方は？' },
+        { topic: 'トラブルシューティング', example: '認証エラーの対処法は？' },
+    ];
+    console.log(chalk_1.default.gray('以下のトピックについて質問できます:\n'));
+    for (const { topic, example } of topics) {
+        console.log(`  ${chalk_1.default.cyan('●')} ${chalk_1.default.bold(topic)}`);
+        console.log(`    ${chalk_1.default.gray('例:')} ${example}`);
+        console.log('');
+    }
+    console.log(chalk_1.default.gray('使用例:'));
+    console.log(chalk_1.default.white('  aranea-sdk metatron ask "State Reportの送信方法は？"'));
+    console.log(chalk_1.default.white('  aranea-sdk metatron chat'));
+    console.log('');
+});
+// metatron examples
+exports.metatronCommand
+    .command('examples')
+    .description('質問例を表示')
+    .action(() => {
+    console.log(chalk_1.default.bold('\n=== AraneaMetatron Examples ===\n'));
+    const examples = [
+        // 基本的な質問
+        'State Reportの送信方法は？',
+        'デバイス登録に必要なパラメータは？',
+        'CICとは何ですか？',
+        // 技術的な質問
+        'stateSchemaにはどんなフィールドを定義できる？',
+        'ESP32でHTTPS通信するサンプルコードは？',
+        'MQTTコマンドの送信方法は？',
+        // トラブルシューティング
+        'TID format errorの対処法は？',
+        'CIC認証が失敗する原因は？',
+        'BigQuery同期が失敗した時の対応は？',
+        // 運用
+        'デバイスの状態を確認する方法は？',
+        'CelestialGlobeでトポロジーを見る方法は？',
+    ];
+    console.log(chalk_1.default.gray('Metatronに質問できる例:\n'));
+    for (const example of examples) {
+        console.log(`  ${chalk_1.default.cyan('•')} ${example}`);
+    }
+    console.log('');
+    console.log(chalk_1.default.gray('使用方法:'));
+    console.log(chalk_1.default.white(`  aranea-sdk metatron ask "${examples[0]}"`));
+    console.log('');
+});
+exports.default = exports.metatronCommand;

package/dist/commands/mqtt.d.ts

@@ -0,0 +1,16 @@
+/**
+ * mqtt コマンド - MQTT/Pub/Sub コマンド発行・モニタリング
+ *
+ * P0 機能 (v0.2.x):
+ *   aranea-sdk mqtt send-command --lacis-id <id> --type relay --params '{"channel":1,"state":true}'
+ *   aranea-sdk mqtt monitor --lacis-id <id> --timeout 30
+ *   aranea-sdk mqtt periodic --lacis-id <id> --type ping --interval 5 --count 10
+ *
+ * Cloud Pub/Sub経由でaraneaDeviceCommandエンドポイントを呼び出す
+ *
+ * @see doc/APPS/araneaSDK/headDesign/20_ARANEA_METATRON_ARCHITECTURE.md Section 12
+ * @see functions/src/araneaDevice/araneaDeviceCommand.ts
+ */
+import { Command } from 'commander';
+export declare const mqttCommand: Command;
+export default mqttCommand;