トラック

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

タスクの作成

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

タスクのステータスは backlog, todo, in_progress, done です。 日付は YYYY-MM-DD です。更新では、対応している任意のタスクの日付、ステータス、親、ゴールへの紐づけの項目を空文字でクリアできます。

ゴールの作成

epismo track create --type goal --title "Ship docs v1" --projects $PROJECT_ID \
  --goal '{"status":"on_track","progress":40}'

ゴールのステータスは not_started, on_track, at_risk, postponed, completed です。

トラックの検索

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 --type task --query "認証 バグ" --search-mode semantic

--search-mode はランキング方式を選びます: keyword（既定）または semantic（キーワード一致にベクトル類似を加味）。省略するとキーワード検索になります。

検索結果から対象を絞ったあと、必要なレコードだけ epismo track get <track-reference> で詳細を取得してください。track reference は task/goal UUID またはその UUID を含む URL です。track に alias はありません。

一括適用

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

非 UUID の id は新規作成として扱われ、同じリクエスト内の他の作成・更新から参照できます。

サーバーは task または goal からトラックの種別を推論します。同じ作成・更新に両方を渡さないでください。新規トラックには title が必要です。UUID の id は既存のレコードを更新し、省略した項目は維持されます。

レビュー

epismo track review <track-reference>
epismo track review <track-reference> <another-track-reference> --instruction "対象間の共通パターンに注目してください。"

1件以上のタスクまたはゴールに対する読み取り専用のレビューを生成します（UUID またはその UUID を含む URL を指定可能）。複数指定すると、作業内容を比較して横断的なパターンを抽出できます。

詳細レビューは Markdown の content と stats を返し、AI token usage に基づいてクレジットを消費します。ステータス更新時に返る軽量な review stats は無料です。

レビュー内容はログやパックに自動保存されません。結果をトラックの履歴に残したい場合は、明示的にログに記録してください：

epismo log create <track-reference> --kind review --content "$REVIEW_SUMMARY"

トラックへの活動/コメントログの追加・一覧(1トラックまたは全トラック横断)・削除についてはログを参照してください。