案件と引き継ぎ

実案件を開始し、責任を割り当て、成果を残し、レビューして再開します。

案件を開始して読む

epismo case start --version-id <version-id> --case-input '{"customer":"Acme"}'
epismo case start --title "Review contract exception"
epismo case get <case-id>
epismo case list --status open
epismo case list --assigned-to <user-id>

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

再現性のために指針を固定する場合は Version-backed 案件、共有価値はあるもののプレイブックがない場合は ad hoc 案件を使います。どちらもタスクを自動作成しません。

assign と役割分担

epismo case acl <case-id> --acl <principal-ids> --lock-version <n>
epismo case assign <case-id> --assigned-to <user-id> --lock-version <n>
epismo case task create <case-id> --kind work --title "Verify totals" \
  --instructions "Use the latest invoice" --assigned-to <user-id>
epismo case task create <case-id> --kind review --title "Approve recommendation" \
  --subject-record-id <record-id> --assigned-to <user-id>
epismo task list --status open

assignment 前に User を案件 ACL へ追加します。案件全体の責任には案件、一つの明示的な仕事または review にはタスクを assign します。review タスクは対象記録を正確に指定してください。top-level の task list は現在のユーザーに割り当てられたタスクを既定で表示します。別の担当者を見るときだけ --assigned-to を指定します。

案件の引き継ぎ（handoff）

epismo case handoff <from-case-id> --to-case-id <to-case-id>
epismo case handoff <to-case-id> --from-case-id <from-case-id>
epismo case handoff graph <case-id> --scope connected

連続する案件や依存関係にある案件を有向エッジ（fromCaseId -> toCaseId）で接続します。引き継ぎの作成には少なくとも一方の案件の管理権限と、両方の案件に対する ACL アクセス権が必要です。ループや循環は拒否されます。epismo case handoff graph で案件周辺の DAG を確認できます。

記録を追記して読む

epismo case record append <case-id> --kind result --origin agent --content "..."
epismo case record append <case-id> --task-id <task-id> --input @evidence.json
epismo case record list <case-id> --scope ancestors --order asc

open 案件の ACL に含まれる参加者は全員記録を追記できます。案件やタスクの管理権限は引き続き担当者に限定されます。--scope（self、ancestors、descendants、neighbors、connected）を指定することで、引き継ぎ関係にある案件の記録も含めて取得できます。filter はその timeline を絞り、返された cursor で安定 pagination を継続します。

update と close

epismo task update <task-id> --title "Verify totals and tax" \
  --instructions "Use the signed invoice" --lock-version <n>
epismo task close <task-id> --outcome approved --lock-version <n>
epismo task reopen <task-id> --lock-version <n>
epismo case update <case-id> --title "Updated title" --lock-version <n>
epismo case close <case-id> --outcome completed --lock-version <n>
epismo case reopen <case-id> --lock-version <n>

タスクまたは案件の close 時に --input または対応 flag で records array を渡すと、final 記録を atomic に追記できます。completed には全タスクの close が必要です。cancel と abandon は残りタスクを close し、案件を reopen してもタスクは closed のままです。