aranea-sdk-cli 0.3.17 → 0.5.1

package/dist/commands/validate.d.ts

@@ -4,6 +4,13 @@
  * Usage:
  *   aranea-sdk validate type --type "aranea_ar-is04a"
  *   aranea-sdk validate lacis-id --lacis-id "3004AABBCCDDEEFF0001"
+ *   aranea-sdk validate product-code --code "1201"
+ *
+ * ProductCode 4進数ルール:
+ *   標準製品: 0, 1, 2, 3 のみで構成 (ASCII→4進数変換)
+ *   固有プロジェクト: 4-9 を含む (カスタムプロジェクト用)
+ *
+ * @see doc/APPS/araneaSDK/Design/11_ProductCode_Quaternary_Rule.md
  */
 import { Command } from 'commander';
 export declare const validateCommand: Command;

package/dist/commands/validate.js

@@ -5,6 +5,13 @@
  * Usage:
  *   aranea-sdk validate type --type "aranea_ar-is04a"
  *   aranea-sdk validate lacis-id --lacis-id "3004AABBCCDDEEFF0001"
+ *   aranea-sdk validate product-code --code "1201"
+ *
+ * ProductCode 4進数ルール:
+ *   標準製品: 0, 1, 2, 3 のみで構成 (ASCII→4進数変換)
+ *   固有プロジェクト: 4-9 を含む (カスタムプロジェクト用)
+ *
+ * @see doc/APPS/araneaSDK/Design/11_ProductCode_Quaternary_Rule.md
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -13,6 +20,55 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
+// ============================================================
+// ProductCode 4進数ユーティリティ
+// ============================================================
+/**
+ * ASCII文字を4進数 (quaternary) に変換
+ * @param char 単一の文字
+ * @returns 4桁の4進数文字列
+ */
+function asciiToQuaternary(char) {
+    const ascii = char.charCodeAt(0);
+    let result = '';
+    let num = ascii;
+    for (let i = 0; i < 4; i++) {
+        result = (num % 4) + result;
+        num = Math.floor(num / 4);
+    }
+    return result.padStart(4, '0');
+}
+/**
+ * 4進数を元のASCII文字に逆変換
+ * @param quaternary 4桁の4進数文字列
+ * @returns 元の文字 (変換不可能な場合はnull)
+ */
+function quaternaryToAscii(quaternary) {
+    if (!/^[0-3]{4}$/.test(quaternary)) {
+        return null;
+    }
+    let ascii = 0;
+    for (let i = 0; i < 4; i++) {
+        ascii = ascii * 4 + parseInt(quaternary[i], 10);
+    }
+    // ASCII printable range check (32-126)
+    if (ascii >= 32 && ascii <= 126) {
+        return String.fromCharCode(ascii);
+    }
+    return null;
+}
+/**
+ * ProductCodeが4進数のみで構成されているか (標準製品)
+ */
+function isQuaternaryProductCode(productCode) {
+    return /^[0-3]{4}$/.test(productCode);
+}
+/**
+ * ProductCodeが固有プロジェクト用か (4-9を含む)
+ */
+function isProprietaryProductCode(productCode) {
+    return /^\d{4}$/.test(productCode) && /[4-9]/.test(productCode);
+}
 exports.validateCommand = new commander_1.Command('validate')
     .description('入力値のバリデーション');
 // validate type
@@ -112,6 +168,24 @@ exports.validateCommand
             console.log(`  ProductType: ${productType}`);
             console.log(`  MAC:         ${mac}`);
             console.log(`  ProductCode: ${productCode}`);
+            // ProductCode 4進数チェック
+            console.log('');
+            console.log(chalk_1.default.bold('ProductCode 分析:'));
+            if (isQuaternaryProductCode(productCode)) {
+                const originalChar = quaternaryToAscii(productCode);
+                console.log(chalk_1.default.green(`  ✓ 標準製品 (4進数: 0-3のみ)`));
+                if (originalChar) {
+                    console.log(`    元の枝番: '${originalChar}' (ASCII ${originalChar.charCodeAt(0)})`);
+                }
+            }
+            else if (isProprietaryProductCode(productCode)) {
+                console.log(chalk_1.default.yellow(`  ⚠ 固有プロジェクト (4-9を含む)`));
+                console.log(chalk_1.default.yellow(`    このデバイスは固有プロジェクトとして登録されます`));
+                console.log(chalk_1.default.cyan(`    Admin UI の「プロジェクト」セクションで管理してください`));
+            }
+            else {
+                console.log(chalk_1.default.red(`  ✗ 無効なProductCode形式`));
+            }
         }
     }
     else {
@@ -165,3 +239,131 @@ exports.validateCommand
     }
     console.log('');
 });
+// validate product-code
+exports.validateCommand
+    .command('product-code')
+    .description('ProductCodeの4進数ルールを検証')
+    .requiredOption('-c, --code <code>', '検証するProductCode (4桁)')
+    .option('-v, --variant <char>', '枝番から4進数を生成 (例: a, b, A)')
+    .action((options) => {
+    console.log(chalk_1.default.bold('\n=== ProductCode バリデーション ===\n'));
+    // 枝番から生成モード
+    if (options.variant) {
+        const variant = options.variant;
+        console.log(`枝番: '${variant}'`);
+        console.log('');
+        if (variant.length !== 1) {
+            console.log(chalk_1.default.red('✗ 枝番は1文字である必要があります'));
+            console.log('');
+            return;
+        }
+        const quaternary = asciiToQuaternary(variant);
+        const ascii = variant.charCodeAt(0);
+        console.log(chalk_1.default.green('✓ 4進数変換結果:'));
+        console.log(`  文字:       '${variant}'`);
+        console.log(`  ASCII:      ${ascii}`);
+        console.log(`  ProductCode: ${quaternary}`);
+        console.log('');
+        // よく使う枝番の一覧
+        console.log(chalk_1.default.bold('よく使う枝番の変換表:'));
+        const commonVariants = ['a', 'b', 'c', 'd', 'A', 'B', '0', '1'];
+        commonVariants.forEach((v) => {
+            const q = asciiToQuaternary(v);
+            const marker = v === variant ? chalk_1.default.cyan(' ← 選択中') : '';
+            console.log(`  '${v}' (ASCII ${v.charCodeAt(0).toString().padStart(3)}) → ${q}${marker}`);
+        });
+        console.log('');
+        return;
+    }
+    // ProductCode検証モード
+    const code = options.code;
+    console.log(`入力: ${code}`);
+    console.log('');
+    // 形式チェック
+    if (!/^\d{4}$/.test(code)) {
+        console.log(chalk_1.default.red('✗ ProductCodeは4桁の数字である必要があります'));
+        console.log('');
+        return;
+    }
+    // 4進数チェック
+    if (isQuaternaryProductCode(code)) {
+        const originalChar = quaternaryToAscii(code);
+        console.log(chalk_1.default.green('✓ 標準製品 ProductCode'));
+        console.log(`  種別: 4進数 (0, 1, 2, 3 のみ)`);
+        console.log('');
+        if (originalChar) {
+            console.log(chalk_1.default.bold('逆変換結果:'));
+            console.log(`  ProductCode ${code} → 枝番 '${originalChar}' (ASCII ${originalChar.charCodeAt(0)})`);
+        }
+        else {
+            console.log(chalk_1.default.dim('  (ASCII印字可能範囲外のため枝番を特定できません)'));
+        }
+    }
+    else if (isProprietaryProductCode(code)) {
+        console.log(chalk_1.default.yellow('⚠ 固有プロジェクト ProductCode'));
+        console.log(`  種別: 非4進数 (4-9 を含む)`);
+        console.log('');
+        console.log(chalk_1.default.bold('固有プロジェクトの登録:'));
+        console.log('  1. Admin UI の AraneaSDK → プロジェクト セクションを開く');
+        console.log('  2. 新規プロジェクトを作成');
+        console.log('  3. このProductCode を使用するデバイスタイプを紐付け');
+        console.log('');
+        console.log(chalk_1.default.cyan('ヒント: 標準製品にする場合は 0-3 のみで構成してください'));
+        console.log(chalk_1.default.cyan('  例: 枝番 "a" の場合は --variant a で確認できます'));
+    }
+    else {
+        console.log(chalk_1.default.red('✗ 無効なProductCode'));
+    }
+    console.log('');
+});
+// validate convert (4進数変換ツール)
+exports.validateCommand
+    .command('convert')
+    .description('枝番とProductCodeの相互変換')
+    .option('-t, --to-quaternary <char>', '枝番を4進数ProductCodeに変換')
+    .option('-f, --from-quaternary <code>', '4進数ProductCodeを枝番に逆変換')
+    .action((options) => {
+    console.log(chalk_1.default.bold('\n=== 4進数変換ツール ===\n'));
+    if (options.toQuaternary) {
+        const char = options.toQuaternary;
+        if (char.length !== 1) {
+            console.log(chalk_1.default.red('✗ 1文字を指定してください'));
+            return;
+        }
+        const quaternary = asciiToQuaternary(char);
+        console.log(`'${char}' (ASCII ${char.charCodeAt(0)}) → ProductCode: ${quaternary}`);
+    }
+    else if (options.fromQuaternary) {
+        const code = options.fromQuaternary;
+        if (!/^[0-3]{4}$/.test(code)) {
+            console.log(chalk_1.default.red('✗ 4桁の4進数 (0-3のみ) を指定してください'));
+            return;
+        }
+        const char = quaternaryToAscii(code);
+        if (char) {
+            console.log(`ProductCode: ${code} → '${char}' (ASCII ${char.charCodeAt(0)})`);
+        }
+        else {
+            console.log(chalk_1.default.yellow(`ProductCode: ${code} → (印字不可能文字)`));
+        }
+    }
+    else {
+        // 変換表を表示
+        console.log('使い方:');
+        console.log('  aranea-cli validate convert --to-quaternary a');
+        console.log('  aranea-cli validate convert --from-quaternary 1201');
+        console.log('');
+        console.log(chalk_1.default.bold('よく使う枝番の変換表:'));
+        const variants = [
+            'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h',
+            'A', 'B', 'C', 'D',
+            '0', '1', '2', '3', '4', '5'
+        ];
+        variants.forEach((v) => {
+            const q = asciiToQuaternary(v);
+            const type = isQuaternaryProductCode(q) ? chalk_1.default.green('標準') : chalk_1.default.yellow('固有');
+            console.log(`  '${v}' (ASCII ${v.charCodeAt(0).toString().padStart(3)}) → ${q} [${type}]`);
+        });
+    }
+    console.log('');
+});

package/dist/config.d.ts

@@ -16,6 +16,8 @@ export interface Endpoint {
     schemaAPI: string;
     knowledgeAPI: string;
     metatronAPI: string;
+    backlogAPI: string;
+    registryAPI: string;
     webhookBase: string;
 }
 export declare const ENDPOINTS: Record<Environment, Endpoint>;

package/dist/config.js

@@ -26,6 +26,8 @@ exports.ENDPOINTS = {
         schemaAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaSchemaAPI',
         knowledgeAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaSDK_knowledgeManagement',
         metatronAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaSDK_metatronQuery',
+        backlogAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaBacklogAPI',
+        registryAPI: 'https://asia-northeast1-mobesorder.cloudfunctions.net/araneaRegistryAPI',
         webhookBase: 'https://us-central1-mobesorder.cloudfunctions.net',
     },
     staging: {
@@ -37,6 +39,8 @@ exports.ENDPOINTS = {
         schemaAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaSchemaAPI',
         knowledgeAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaSDK_knowledgeManagement',
         metatronAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaSDK_metatronQuery',
+        backlogAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaBacklogAPI',
+        registryAPI: 'https://asia-northeast1-mobesorder-staging.cloudfunctions.net/araneaRegistryAPI',
         webhookBase: 'https://us-central1-mobesorder-staging.cloudfunctions.net',
     },
 };

package/dist/index.js

@@ -25,11 +25,14 @@ const device_1 = require("./commands/device");
 const knowledge_1 = require("./commands/knowledge");
 const metatron_1 = require("./commands/metatron");
 const auth_1 = require("./commands/auth");
+const backlog_1 = require("./commands/backlog");
+const registry_1 = require("./commands/registry");
+const control_1 = require("./commands/control");
 const program = new commander_1.Command();
 program
     .name('aranea-sdk')
     .description('AraneaSDK CLI - デバイス開発支援ツール')
-    .version('0.3.17');
+    .version('0.4.1');
 // test コマンド
 program.addCommand(test_1.testCommand);
 // simulate コマンド
@@ -50,4 +53,11 @@ program.addCommand(knowledge_1.knowledgeCommand);
 program.addCommand(metatron_1.metatronCommand);
 // auth コマンド (v0.3.1)
 program.addCommand(auth_1.authCommand);
+// backlog コマンド (v0.4.0)
+program.addCommand(backlog_1.backlogCommand);
+// registry コマンド (v0.4.0)
+program.addCommand(registry_1.registryCommand);
+// control コマンド (v0.4.1) - Control型管理（安全機構付き）
+// @see doc/APPS/araneaSDK/headDesign/59_METATRON_CONTROL_SUGGESTION.md Section 8
+program.addCommand(control_1.controlCommand);
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aranea-sdk-cli",
-  "version": "0.3.17",
+  "version": "0.5.1",
   "description": "AraneaSDK CLI - ESP32 IoTデバイス開発支援ツール",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,6 +45,7 @@
     "axios": "^1.6.0",
     "chalk": "^4.1.2",
     "commander": "^12.0.0",
+    "firebase-admin": "^13.0.0",
     "inquirer": "^8.2.6",
     "node-fetch": "^2.7.0",
     "ora": "^5.4.1"
@@ -59,15 +60,7 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "peerDependencies": {
-    "firebase-admin": ">=11.0.0"
-  },
-  "peerDependenciesMeta": {
-    "firebase-admin": {
-      "optional": true
-    }
-  },
-  "publishConfig": {
+    "publishConfig": {
     "access": "public"
   }
 }