aranea-sdk-cli 0.3.1 → 0.3.2

package/README.md

@@ -4,6 +4,42 @@
 
 AraneaSDK CLI - ESP32 IoTデバイス開発支援ツール
 
+---
+
+## 🤖 AIエージェント向けガイド
+
+> **AIエージェント (Claude, Codex, etc.) がAraneaSDK関連タスクを実行する際は、このCLIを使用してください。**
+
+### ナレッジ追加 (ローカルファイルではなくCLI経由で)
+
+```bash
+# ❌ ローカルファイル作成ではなく
+# ✅ CLIでナレッジベースに追加
+aranea-sdk knowledge add \
+  --title "ESP32 HTTPSタイムアウト設定" \
+  --category tip \
+  --content "ESP32でHTTPS接続する場合、最低15秒のタイムアウトが必要。初回SSL handshakeは特に時間がかかる。" \
+  --keywords "esp32,https,timeout,ssl"
+```
+
+### Metatronへの質問 (AIアシスタント連携)
+
+```bash
+# AraneaSDK専門AIに質問
+aranea-sdk metatron ask "ESP32のHTTPSタイムアウトのベストプラクティスは？"
+
+# 対話モード
+aranea-sdk metatron chat
+```
+
+### 典型的なワークフロー
+
+1. **問題解決時**: `metatron ask "問題の説明"` で既存ナレッジを確認
+2. **新知見発見時**: `knowledge add` でナレッジベースに追加
+3. **デバイス登録時**: `register --dry-run` で検証後、実登録
+
+---
+
 ## 概要
 
 AraneaSDK CLIは、AraneaSDK対応ESP32デバイスの開発・テスト・登録を支援するコマンドラインツールです。
@@ -39,12 +75,13 @@ aranea-sdk metatron ask "State Reportの送信方法は？"
 |---------|------|------|
 | `test` | 接続・認証テスト | 不要 |
 | `register` | デバイス登録 | 不要（テストテナント） |
-| `schema` | スキーマ取得・State Report検証 | 不要 |
+| `schema` | スキーマ取得・検証・プッシュ | push/promote時必要 |
 | `validate` | Type名検証 | 不要 |
 | `simulate` | 状態レポートシミュレーション | 不要 |
 | `mqtt` | コマンド送信・ACKモニタリング | **必要** |
 | `knowledge` | ナレッジベース管理 | **必要** |
 | `metatron` | AI対話アシスタント | **必要** |
+| `auth` | 認証トークン管理 | - |
 
 ---
 
@@ -166,11 +203,27 @@ aranea-sdk schema validate --file state.json --type aranea_ar-is04a
 | `list` | ✅ 実装済み | 登録済みスキーマ一覧 |
 | `get` | ✅ 実装済み | スキーマ詳細取得 |
 | `validate` | ✅ 実装済み | State Report 検証 |
-| `create` | 🔜 計画中 | スキーマ新規作成 |
-| `push` | 🔜 計画中 | 開発環境へプッシュ |
-| `promote` | 🔜 計画中 | 本番環境へ昇格 |
+| `validate-schema` | ✅ 実装済み | スキーマ定義の静的検証 |
+| `push` | ✅ 実装済み | 開発環境へプッシュ (認証必要) |
+| `promote` | ✅ 実装済み | 本番環境へ昇格 (認証必要、確認ステップあり) |
+| `info` | ✅ 実装済み | スキーマ詳細情報・リビジョン履歴 |
 | `rollback` | 🔜 計画中 | バージョンロールバック |
 
+### 環境切替 (v0.3.1)
+
+すべてのschemaサブコマンドで `--endpoint` オプションが使用可能です:
+
+```bash
+# デフォルト: staging
+aranea-sdk schema list
+
+# 明示的にproduction指定
+aranea-sdk schema list --endpoint production
+
+# 環境変数でも指定可能
+ARANEA_ENV=production aranea-sdk schema list
+```
+
 ---
 
 ## validate - Type名検証
@@ -339,6 +392,45 @@ aranea-sdk metatron examples
 
 ---
 
+## auth - 認証管理 (v0.3.1)
+
+Firebase Auth IDトークンを管理します。トークンは `~/.aranea-sdk/credentials.json` に保存されます。
+
+### 使用例
+
+```bash
+# ログイン (対話式)
+aranea-sdk auth login
+
+# メールアドレス指定でログイン
+aranea-sdk auth login --email dev@example.com
+
+# トークン情報表示
+aranea-sdk auth token
+
+# トークンのみ出力 (スクリプト用)
+aranea-sdk auth token --raw
+
+# トークン更新 (1時間で期限切れ)
+aranea-sdk auth refresh
+
+# ログアウト
+aranea-sdk auth logout
+```
+
+### トークンライフサイクル
+
+- IDトークンは **1時間** で期限切れ
+- `auth refresh` で新しいトークンを取得
+- `auth token --raw` でスクリプトからトークン取得可能
+
+```bash
+# 他コマンドでトークンを使用
+aranea-sdk metatron ask "質問" --token "$(aranea-sdk auth token --raw)"
+```
+
+---
+
 ## 対応デバイスType
 
 ### 新規 (aranea_ar-*)

package/dist/index.js

@@ -28,7 +28,7 @@ const program = new commander_1.Command();
 program
     .name('aranea-sdk')
     .description('AraneaSDK CLI - デバイス開発支援ツール')
-    .version('0.3.1');
+    .version('0.3.2');
 // test コマンド
 program.addCommand(test_1.testCommand);
 // simulate コマンド

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aranea-sdk-cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "AraneaSDK CLI - ESP32 IoTデバイス開発支援ツール",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",