@acomo/cli 1.0.0

package/README.md

@@ -0,0 +1,220 @@
+# @acomo/cli
+
+acomo ワークフロー管理プラットフォームの公式 CLI ツールです。
+
+## 📦 インストール
+
+```bash
+npm install -g @acomo/cli
+```
+
+## 🚀 クイックスタート
+
+### 1. ログイン
+
+```bash
+# アクセストークンでログイン（推奨）
+acomo login --tenant-id <your-tenant-id> --token <your-access-token>
+
+# または、メール/パスワードでログイン
+acomo login --tenant-id <your-tenant-id>
+```
+
+### 2. API を呼び出す
+
+```bash
+# 現在のユーザー情報を取得
+acomo getCurrentUser
+
+# ワークフローモデル一覧を取得
+acomo listWorkflowModels
+
+# JSON パラメータを指定して呼び出す
+acomo listWorkflowModels '{"filter":"published","take":10}'
+```
+
+## 📖 使い方
+
+### ログイン
+
+#### アクセストークンでログイン
+
+```bash
+acomo login --tenant-id <tenant-id> --token <access-token>
+```
+
+Web 画面などで取得したアクセストークンを直接指定できます。
+
+#### メール/パスワードでログイン
+
+```bash
+# オプション指定
+acomo login --tenant-id <tenant-id> --email user@example.com --password pass123
+
+# インタラクティブ入力
+acomo login --tenant-id <tenant-id>
+```
+
+#### カスタム URL を指定
+
+```bash
+acomo login --url https://custom.acomo.app --tenant-id <tenant-id> --token <token>
+```
+
+### API 呼び出し
+
+全ての acomo API がコマンドとして利用可能です。
+
+#### 基本的な使い方
+
+```bash
+acomo <operationId> [JSON引数]
+```
+
+#### 引数なしの API
+
+```bash
+acomo getCurrentUser
+acomo getCurrentTenant
+acomo getAccount
+```
+
+#### JSON 引数を渡す
+
+```bash
+# コマンドライン引数として渡す
+acomo getWorkflowModel '{"modelId":"wf_xxx"}'
+
+# stdin から渡す
+echo '{"modelId":"wf_xxx"}' | acomo getWorkflowModel
+
+# ファイルから渡す
+acomo createWorkflowModel < model-data.json
+```
+
+### 出力フォーマット
+
+```bash
+# JSON 形式（デフォルト、整形済み）
+acomo listWorkflowModels
+
+# compact 形式（1行、パイプ処理に便利）
+acomo listWorkflowModels --format compact
+
+# jq と組み合わせる
+acomo listWorkflowModels --format compact | jq '.[0].id'
+```
+
+### 設定管理
+
+```bash
+# 現在の設定を表示（トークンはマスク表示）
+acomo config show
+
+# 設定を更新
+acomo config set baseUrl https://custom.acomo.app
+
+# ログアウト（設定をクリア）
+acomo logout
+```
+
+## 🎯 主要なコマンド例
+
+### ワークフローモデル
+
+```bash
+# モデル一覧を取得
+acomo listWorkflowModels
+
+# フィルタ付きで取得
+acomo listWorkflowModels '{"filter":"published","take":10}'
+
+# 特定のモデルを取得
+acomo getWorkflowModel '{"modelId":"wf_xxx"}'
+
+# モデルを作成
+acomo createWorkflowModel '{"body":{"name":"新しいワークフロー","description":"説明"}}'
+
+# モデルを削除
+acomo deleteWorkflowModel '{"modelId":"wf_xxx"}'
+```
+
+### ワークフロープロセス
+
+```bash
+# プロセス一覧を取得
+acomo listWorkflowProcesses
+
+# フィルタ付きで取得
+acomo listWorkflowProcesses '{"filter":"running","take":20}'
+
+# 特定のプロセスを取得
+acomo getWorkflowProcess '{"processId":"proc_xxx"}'
+
+# プロセス履歴を取得
+acomo listWorkflowProcessHistories '{"processId":"proc_xxx"}'
+```
+
+### プロフィール・アカウント
+
+```bash
+# 現在のユーザー情報
+acomo getCurrentUser
+
+# 現在のテナント情報
+acomo getCurrentTenant
+
+# アカウント情報
+acomo getAccount
+
+# 組織情報
+acomo getMyOrganization
+```
+
+## ⚙️ 設定ファイル
+
+設定は `~/.acomo/config.json` に保存されます。
+
+```json
+{
+  "baseUrl": "https://acomo.app",
+  "tenantId": "your-tenant-id",
+  "accessToken": "your-access-token",
+  "email": "user@example.com"
+}
+```
+
+ファイルのパーミッションは `0600` に設定され、本人のみがアクセス可能です。
+
+## 🔧 開発者向け
+
+### ビルド
+
+```bash
+npm run build
+```
+
+### 開発モード
+
+```bash
+npm run dev
+```
+
+### クリーンビルド
+
+```bash
+npm run clean && npm run build
+```
+
+## 📝 ライセンス
+
+ISC
+
+## 🔗 関連リンク
+
+- [acomo 公式サイト](https://acomo.app)
+- [@acomo/client NPM パッケージ](https://www.npmjs.com/package/@acomo/client)
+
+## 🤝 サポート
+
+質問や問題がある場合は、[GitHub Issues](https://github.com/progress-all/acomo/issues) でお知らせください。

package/bin/acomo

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');