Track next durably adoption targets

[coji]

概要

crawl、recalculate、backfill、classify を durably ジョブ化済み。残りはスプレッドシートエクスポートのみ。

ステータス

• 完了: backfill の durably ジョブ化 (Move recalculate off the main thread and add durable backfill #207)
• 完了: refreshRequestedAt フラグポーリングを durably スケジュール実行に置換 (feat: replace refresh DB flag polling with durably job trigger #208)
• 完了: classify を shared-steps パイプラインから分離し standalone durably ジョブ化 (feat: make classify a standalone durably job #209)
• 将来: スプレッドシートエクスポートの分離を検討

動機

対象フローは以下の特性を1つ以上持つ:

• 長時間実行
• 外部 I/O
• 再開・リトライ可能であるべき
• 進捗・実行履歴の可視化が有用
• 重複実行の防止が必要

候補

スプレッドシートエクスポートジョブ

ファイル:

• batch/bizlogic/export-spreadsheet.ts

理由:

• 外部 API を使用し、analyze/upsert とは独立して失敗しうる
• 処理が重くなったり失敗が増えたら分離する価値がある

方針:

• 現状はインラインのまま維持。運用上の問題が出たら分離を検討

完了済み

backfill (#207)

ファイル:

• batch/commands/backfill.ts
• batch/github/backfill-repo.ts
• app/services/jobs/backfill.server.ts

実装内容:

• org 単位の backfill durable ジョブ
• リポジトリ単位の進捗ステップ
• files オプション維持
• CLI は durably.jobs.backfill.triggerAndWait(...) 経由で実行

リフレッシュスケジューリング (#208)

ファイル:

• app/routes/$orgSlug/settings/data-management/index.tsx
• batch/job-scheduler.ts
• app/services/jobs/crawl.server.ts

実装内容:

• UI から durably crawl ジョブを直接 trigger（DB フラグポーリング廃止）
• SSE によるリアルタイム進捗追跡
• 共通 RunStatusAlerts コンポーネント
• refresh_requested_at カラム削除（tenant マイグレーション）
• 不要な db/schema.sql を削除

standalone classify (#209)

ファイル:

• app/services/jobs/classify.server.ts
• app/services/jobs/shared-steps.server.ts
• app/services/jobs/crawl.server.ts
• batch/commands/classify.ts
• batch/usecases/classify-pull-requests.ts

実装内容:

• classifyJob を standalone durably ジョブとして定義（force/limit オプション対応）
• shared-steps パイプライン（analyze → upsert → export → finalize）から分離
• crawl 完了後に triggerClassifyStep で fire-and-forget trigger
• concurrencyKey: classify:${orgId} で同一 org の並行実行を防止
• CLI classify コマンドは triggerAndWait 経由に変更
• recalculate の --classify フラグ削除（classify コマンドに一本化）
• Data Management UI から classify チェックボックス削除

優先度

• 低: スプレッドシートエクスポート（運用上の問題が出るまでインライン維持）

[coji]

Standalone classify — Done (#209)

classify を shared-steps パイプラインから分離し、standalone durably job として実装完了。

Done shape:

• classifyJob を app/services/jobs/classify.server.ts に定義（force/limit オプション対応）
• crawl 完了後に triggerClassifyStep で fire-and-forget trigger
• concurrencyKey: classify:${orgId} で同一 org の並行実行を防止
• CLI classify コマンドは triggerAndWait 経由に変更
• recalculate の --classify フラグは削除（classify コマンドに一本化）
• Data Management UI から classify チェックボックスを削除

Remaining:

• Spreadsheet export job — 引き続き低優先