スクリプティング

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

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

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

list/search は page-size と cursor を使います。次ページには返された next cursor をそのまま渡します。

mutation は idempotency key を省略すると CLI が UUID を生成します。応答が不明な同一 request を再送するときだけ同じ key を使い、内容を変えた request では新しい key を使います。Case/Task の更新は最新 lock version を要求し、conflict 時は再取得して意図を再評価します。