aranea-sdk-cli 0.3.16 → 0.5.0

package/dist/commands/backlog.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AraneaSDK CLI - Backlog Command
+ *
+ * Issue/Feature/Idea管理
+ *
+ * Usage:
+ *   aranea-sdk backlog create --type bug --title "MQTT接続エラー" --desc "..."
+ *   aranea-sdk backlog list --status open --type bug
+ *   aranea-sdk backlog get BL-20251227-ABC123
+ *   aranea-sdk backlog update BL-20251227-ABC123 --status resolved
+ *   aranea-sdk backlog stats
+ */
+import { Command } from 'commander';
+export declare const backlogCommand: Command;
+export default backlogCommand;

package/dist/commands/backlog.js

@@ -0,0 +1,364 @@
+"use strict";
+/**
+ * AraneaSDK CLI - Backlog Command
+ *
+ * Issue/Feature/Idea管理
+ *
+ * Usage:
+ *   aranea-sdk backlog create --type bug --title "MQTT接続エラー" --desc "..."
+ *   aranea-sdk backlog list --status open --type bug
+ *   aranea-sdk backlog get BL-20251227-ABC123
+ *   aranea-sdk backlog update BL-20251227-ABC123 --status resolved
+ *   aranea-sdk backlog stats
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backlogCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const config_1 = require("../config");
+const auth_1 = require("./auth");
+const TYPE_COLORS = {
+    bug: 'red',
+    issue: 'yellow',
+    feature: 'green',
+    enhancement: 'cyan',
+    idea: 'magenta',
+    debt: 'gray',
+    security: 'red',
+    docs: 'blue',
+};
+const STATUS_COLORS = {
+    pending_audit: 'gray',
+    pending_review: 'gray',
+    open: 'yellow',
+    in_progress: 'cyan',
+    resolved: 'green',
+    closed: 'gray',
+    duplicate: 'gray',
+    wontfix: 'gray',
+    false_positive: 'gray',
+};
+const PRIORITY_COLORS = {
+    critical: 'red',
+    high: 'yellow',
+    medium: 'white',
+    low: 'gray',
+};
+// ========== Helper Functions ==========
+function colorize(text, color) {
+    const colorFn = chalk_1.default[color];
+    return colorFn ? colorFn(text) : text;
+}
+function formatItem(item, verbose = false) {
+    const typeColor = TYPE_COLORS[item.type] || 'white';
+    const statusColor = STATUS_COLORS[item.status] || 'white';
+    const priorityColor = PRIORITY_COLORS[item.priority] || 'white';
+    let output = '';
+    // ヘッダー
+    output += colorize(`[${item.itemId}]`, 'cyan') + ' ';
+    output += colorize(`[${item.type.toUpperCase()}]`, typeColor) + ' ';
+    output += colorize(`[${item.priority.toUpperCase()}]`, priorityColor) + ' ';
+    output += colorize(`${item.status}`, statusColor) + '\n';
+    // タイトル
+    output += chalk_1.default.bold(item.title) + '\n';
+    if (verbose) {
+        // 説明
+        output += chalk_1.default.gray('Description: ') + item.description + '\n';
+        // コンポーネント・タグ
+        output += chalk_1.default.gray('Component: ') + item.component;
+        if (item.tags && item.tags.length > 0) {
+            output += chalk_1.default.gray(' | Tags: ') + item.tags.join(', ');
+        }
+        output += '\n';
+        // エラーコード
+        if (item.errorCode) {
+            output += chalk_1.default.gray('Error Code: ') + chalk_1.default.red(item.errorCode) + '\n';
+        }
+        // 登録情報
+        output += chalk_1.default.gray('Source: ') + item.source;
+        output += chalk_1.default.gray(' | Submitted: ') + formatDate(item.submittedAt);
+        if (item.submittedBy) {
+            output += chalk_1.default.gray(' by ') + item.submittedBy;
+        }
+        output += '\n';
+        // Metatron監査
+        if (item.metatronAudit) {
+            const audit = item.metatronAudit;
+            output += chalk_1.default.gray('Metatron Audit: ');
+            output += colorize(audit.verdict, audit.verdict === 'approved' ? 'green' : 'yellow');
+            output += ` (Quality: ${audit.qualityScore}%)`;
+            if (audit.verdictReason) {
+                output += ` - ${audit.verdictReason}`;
+            }
+            output += '\n';
+        }
+        // Metatron検出
+        if (item.metatronDetection) {
+            const detection = item.metatronDetection;
+            output += chalk_1.default.gray('Metatron Detection: ');
+            output += `Confidence ${detection.confidence}% via ${detection.detectionSource}\n`;
+            if (detection.analysis?.suggestedFix) {
+                output += chalk_1.default.gray('Suggested Fix: ') + detection.analysis.suggestedFix + '\n';
+            }
+        }
+    }
+    return output;
+}
+function formatDate(timestamp) {
+    if (!timestamp)
+        return 'N/A';
+    if (timestamp._seconds) {
+        return new Date(timestamp._seconds * 1000).toLocaleString('ja-JP');
+    }
+    return new Date(timestamp).toLocaleString('ja-JP');
+}
+// ========== Commands ==========
+exports.backlogCommand = new commander_1.Command('backlog')
+    .description('AraneaBacklog - Issue/Feature管理')
+    .addHelpText('after', `
+Examples:
+  $ aranea-sdk backlog create --type bug --title "MQTT認証エラー" --desc "認証失敗が頻発"
+  $ aranea-sdk backlog list --status open
+  $ aranea-sdk backlog list --type bug --priority critical
+  $ aranea-sdk backlog get BL-20251227-ABC123
+  $ aranea-sdk backlog update BL-20251227-ABC123 --status resolved
+  $ aranea-sdk backlog stats
+
+Type options: bug, issue, feature, enhancement, idea, debt, security, docs
+Status options: pending_audit, pending_review, open, in_progress, resolved, closed, duplicate, wontfix
+Priority options: critical, high, medium, low
+`);
+// ========== create ==========
+exports.backlogCommand
+    .command('create')
+    .description('新しいBacklogアイテムを作成')
+    .requiredOption('--type <type>', 'アイテムタイプ (bug|issue|feature|enhancement|idea|debt|security|docs)')
+    .requiredOption('--title <title>', 'タイトル')
+    .requiredOption('--desc <description>', '説明')
+    .option('--priority <priority>', '優先度 (critical|high|medium|low)', 'medium')
+    .option('--component <component>', 'コンポーネント', 'general')
+    .option('--tags <tags>', 'タグ (カンマ区切り)')
+    .option('--error-code <code>', 'エラーコード')
+    .option('--lacis-id <lacisId>', '登録者LacisID')
+    .option('--endpoint <env>', '環境 (production|staging)', 'production')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('Creating backlog item...').start();
+    try {
+        // 認証トークン取得
+        const token = await (0, auth_1.getValidToken)();
+        if (!token) {
+            spinner.fail(chalk_1.default.red('認証が必要です。先に aranea-sdk auth login を実行してください'));
+            return;
+        }
+        const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'backlog create');
+        const endpoint = (0, config_1.getEndpoint)(env);
+        const body = {
+            type: options.type,
+            title: options.title,
+            description: options.desc,
+            priority: options.priority,
+            component: options.component,
+            tags: options.tags ? options.tags.split(',').map((t) => t.trim()) : [],
+            errorCode: options.errorCode,
+            source: 'human',
+            submittedBy: options.lacisId || 'cli-user',
+        };
+        const response = await (0, node_fetch_1.default)(`${endpoint.backlogAPI}?action=create`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(body),
+        });
+        const result = (await response.json());
+        if (!response.ok || !result.ok) {
+            spinner.fail(chalk_1.default.red(`Failed: ${result.error || 'Unknown error'}`));
+            return;
+        }
+        spinner.succeed(chalk_1.default.green(`Created: ${result.itemId}`));
+        console.log('');
+        console.log(formatItem(result.item, true));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Error: ${error.message}`));
+    }
+});
+// ========== list ==========
+exports.backlogCommand
+    .command('list')
+    .description('Backlogアイテム一覧')
+    .option('--status <status>', 'ステータスでフィルタ')
+    .option('--type <type>', 'タイプでフィルタ')
+    .option('--priority <priority>', '優先度でフィルタ')
+    .option('--component <component>', 'コンポーネントでフィルタ')
+    .option('--source <source>', 'ソースでフィルタ (human|metatron)')
+    .option('--limit <limit>', '取得件数', '20')
+    .option('--endpoint <env>', '環境 (production|staging)', 'production')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('Fetching backlog items...').start();
+    try {
+        const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'backlog list');
+        const endpoint = (0, config_1.getEndpoint)(env);
+        const params = new URLSearchParams({ action: 'list' });
+        if (options.status)
+            params.append('status', options.status);
+        if (options.type)
+            params.append('type', options.type);
+        if (options.priority)
+            params.append('priority', options.priority);
+        if (options.component)
+            params.append('component', options.component);
+        if (options.source)
+            params.append('source', options.source);
+        params.append('limit', options.limit);
+        const url = `${endpoint.backlogAPI}?${params.toString()}`;
+        const response = await (0, node_fetch_1.default)(url);
+        const result = (await response.json());
+        if (!response.ok || !result.ok) {
+            spinner.fail(chalk_1.default.red(`Failed: ${result.error || 'Unknown error'}`));
+            return;
+        }
+        spinner.succeed(chalk_1.default.green(`Found ${result.count} items`));
+        console.log('');
+        if (result.items.length === 0) {
+            console.log(chalk_1.default.gray('No items found.'));
+            return;
+        }
+        for (const item of result.items) {
+            console.log(formatItem(item));
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Error: ${error.message}`));
+    }
+});
+// ========== get ==========
+exports.backlogCommand
+    .command('get <itemId>')
+    .description('Backlogアイテム詳細')
+    .option('--endpoint <env>', '環境 (production|staging)', 'production')
+    .action(async (itemId, options) => {
+    const spinner = (0, ora_1.default)(`Fetching ${itemId}...`).start();
+    try {
+        const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'backlog get');
+        const endpoint = (0, config_1.getEndpoint)(env);
+        const url = `${endpoint.backlogAPI}?action=get&itemId=${itemId}`;
+        const response = await (0, node_fetch_1.default)(url);
+        const result = (await response.json());
+        if (!response.ok || !result.ok) {
+            spinner.fail(chalk_1.default.red(`Failed: ${result.error || 'Unknown error'}`));
+            return;
+        }
+        spinner.succeed(chalk_1.default.green(`Found: ${itemId}`));
+        console.log('');
+        console.log(formatItem(result.item, true));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Error: ${error.message}`));
+    }
+});
+// ========== update ==========
+exports.backlogCommand
+    .command('update <itemId>')
+    .description('Backlogアイテム更新')
+    .option('--status <status>', 'ステータス')
+    .option('--priority <priority>', '優先度')
+    .option('--assigned-to <lacisId>', '担当者')
+    .option('--resolution <text>', '解決方法')
+    .option('--endpoint <env>', '環境 (production|staging)', 'production')
+    .action(async (itemId, options) => {
+    const spinner = (0, ora_1.default)(`Updating ${itemId}...`).start();
+    try {
+        // 認証トークン取得
+        const token = await (0, auth_1.getValidToken)();
+        if (!token) {
+            spinner.fail(chalk_1.default.red('認証が必要です。先に aranea-sdk auth login を実行してください'));
+            return;
+        }
+        const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'backlog update');
+        const endpoint = (0, config_1.getEndpoint)(env);
+        const body = {};
+        if (options.status)
+            body.status = options.status;
+        if (options.priority)
+            body.priority = options.priority;
+        if (options.assignedTo)
+            body.assignedTo = options.assignedTo;
+        if (options.resolution)
+            body.resolution = options.resolution;
+        if (Object.keys(body).length === 0) {
+            spinner.fail(chalk_1.default.red('No update fields specified'));
+            return;
+        }
+        const url = `${endpoint.backlogAPI}?action=update&itemId=${itemId}`;
+        const response = await (0, node_fetch_1.default)(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(body),
+        });
+        const result = (await response.json());
+        if (!response.ok || !result.ok) {
+            spinner.fail(chalk_1.default.red(`Failed: ${result.error || 'Unknown error'}`));
+            return;
+        }
+        spinner.succeed(chalk_1.default.green(`Updated: ${itemId}`));
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Error: ${error.message}`));
+    }
+});
+// ========== stats ==========
+exports.backlogCommand
+    .command('stats')
+    .description('Backlog統計')
+    .option('--endpoint <env>', '環境 (production|staging)', 'production')
+    .action(async (options) => {
+    const spinner = (0, ora_1.default)('Fetching stats...').start();
+    try {
+        const env = (0, config_1.resolveEnvironment)(options.endpoint);
+        (0, config_1.checkStagingAvailability)(env, 'backlog stats');
+        const endpoint = (0, config_1.getEndpoint)(env);
+        const url = `${endpoint.backlogAPI}?action=stats`;
+        const response = await (0, node_fetch_1.default)(url);
+        const result = (await response.json());
+        if (!response.ok || !result.ok) {
+            spinner.fail(chalk_1.default.red(`Failed: ${result.error || 'Unknown error'}`));
+            return;
+        }
+        spinner.succeed(chalk_1.default.green('Statistics'));
+        console.log('');
+        const stats = result.stats;
+        console.log(chalk_1.default.bold('=== Overview ==='));
+        console.log(`Total Active: ${chalk_1.default.cyan(stats.totalActive)}`);
+        console.log(`Critical/High Priority: ${chalk_1.default.red(stats.criticalAndHigh)}`);
+        console.log('');
+        console.log(chalk_1.default.bold('=== By Status ==='));
+        for (const [status, count] of Object.entries(stats.byStatus || {})) {
+            const color = STATUS_COLORS[status] || 'white';
+            console.log(`  ${colorize(status, color)}: ${count}`);
+        }
+        console.log('');
+        console.log(chalk_1.default.bold('=== By Type ==='));
+        for (const [type, count] of Object.entries(stats.byType || {})) {
+            const color = TYPE_COLORS[type] || 'white';
+            console.log(`  ${colorize(type, color)}: ${count}`);
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Error: ${error.message}`));
+    }
+});
+exports.default = exports.backlogCommand;

package/dist/commands/control.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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]
+ */
+import { Command } from 'commander';
+export declare const controlCommand: Command;