案件

epismo_case_get は、案件本体、現在のタスク、その案件と祖先案件の記録、直接つながる引き継ぎ関係、そして読み取り権限が残っていれば開始元のプレイブックと固定した Version を、1 credit の取得でまとめて返します。

結果を共有または再開する必要があるときにepismo_case_startを使います。プレイブック Version を指定する方法と、title だけの ad hoc 案件があります。

• ローカルな途中作業は agent runtime に保つ。
• 結果、判断、引き継ぎの要約はepismo_case_record_appendで append する。
• 明示的な担当や review が必要なときだけepismo_case_task_createでタスクを作る。
• 関連する案件はepismo_case_handoff_createで接続し、epismo_case_handoff_graphで DAG を確認する。
• epismo_case_handoff_candidate_list（direction=outgoing または direction=incoming）でループや重複のない有効な接続候補を取得する。
• mutation ごとに新しい idempotency key を生成する。
• 案件/タスクの変更前に最新 lock version を取得する。

conflict 時は案件またはタスクを再取得し、新しい state で意図がまだ正しいか判断します。古い request を lock version だけ差し替えて再送しません。

agent 自身を暗黙の assignee にせず、User assignment が必要な場合だけ users resource から ID を選びます。assignment 前に案件 ACL へその User が含まれていることを確認します。

案件 ID を指定してepismo_case_record_listを使い、その案件の timeline から作業を再開します。scope（self、ancestors、descendants、neighbors、connected）を指定することで、各案件の ACL を維持したまま接続された案件の記録も含めて取得できます。filter は timeline を絞るだけで、ACL filter 自体が authorization になることはありません。