スクリプティング

複雑な payload は inline JSON、file、stdin で渡せます。明示 flag は入力 JSON の同名 field を上書きします。

epismo playbook create --input @playbook.json
epismo case record append <case-id> --input @record.json
epismo playbook suggestion create <playbook-id> --input - < suggestion.json

成功時は JSON を stdout へ出し exit code 0、失敗時は JSON 形式の error を stderr へ出し non-zero で終了します。automation では人向け文言ではなく code と retryable を判定してください。CI ではこの既定を保ち、--diagnostic-format human は terminal 向けに使います。

list/search は --page-size と --cursor を使います。すべての cursor を自動追跡するには --all、結果数を制限するには --limit を使います。1行1結果には --output jsonl を使えます。--output value --field checkout_url は scalar を抽出し、組み込みの --jq は .playbooks[] | .id のような field projection をサポートします。

mutation は idempotency key を省略すると CLI が UUID を生成します。応答が不明な同一 request を再送するときだけ同じ key を使い、内容を変えた request では新しい key を使います。案件/タスクの更新は最新 lock version を要求し、conflict 時は再取得して意図を再評価します。archive、delete、revoke、close、ACL 変更の前には --dry-run を使えます。