Tracks

Task/goal の create/search/update/bulk apply を行います。

進行中の作業は epismo track で操作します。

Create a task

epismo track create --type task --title "Fix API docs" --personal \
  --task '{"status":"todo","dueDate":"2026-06-05"}'

Task status は backlog, todo, in_progress, done です。日付は YYYY-MM-DD です。Update では、対応している optional task date、status、parent、goal linkage fields を空文字で clear できます。

Create a goal

epismo track create --type goal --title "Ship docs v1" --projects <project-id> \
  --goal '{"status":"on_track","progress":40}'

Goal status は not_started, on_track, at_risk, postponed, completed です。

Search tracks

epismo track search --type task --personal --filter '{"status":["todo","in_progress"]}'
epismo track search --type goal --projects <project-id> --filter '{"progressMin":50}'

epismo track search は credit を消費します。Search result から対象を絞ったあと、必要な record だけ epismo track get <id> で detail を取得してください。

Bulk apply

epismo track apply --personal --input '{
  "updateDrafts": [
    {"id":"t001","title":"Task A","task":{"status":"todo"}},
    {"id":"t002","title":"Task B","task":{"status":"todo","dependsOn":["t001"]}}
  ]
}'

非 UUID の draft ID は新規作成として扱われ、同じ request 内の他 draft から参照できます。

Server は task または goal から draft type を推論します。同じ draft に両方を渡さないでください。New draft には title が必要です。UUID draft は既存 record を更新し、省略 fields は維持されます。