[discord-bot] Quest 申請を通知チャンネルへ投稿してレビューを促す

[yu23ki14]

依存: #530（Cron + subgraph ポーリング + 通知チャンネル設定の基盤）。#530 完了後に着手する。

背景

クエストの完了報告（submitCompletion）が出されるとクエストは PendingReview になるが、現状これに気づく手段は以下しかない。

• Discord /quest submit の結果は実行者本人にしか見えない ephemeral followup
• フロントエンドのクエスト詳細（/{treeId}/quest/{questId}）を能動的に見に行く

結果、申請が放置されエスクローされたロールシェアが宙に浮く。#530 で Thanks 送付の通知基盤（Cron + subgraph ポーリング + 通知チャンネル）ができるので、これに乗せて申請も通知したい。

承認できるのは誰か（重要）

IHatsQuestModule.approve の仕様上、承認できるのは 「クエスト作成者の単独承認」または「ワークスペースメンバー 2 名の承認」 で、どちらかが揃うと Completed になりエスクローが申請者へ渡る。専用の管理者ロールは存在しない。通知文面はこの前提に合わせる。

ゴール

#530 と同じ Cron の中で、前回チェック以降に新規発生したクエスト申請を検出し、#530 で設定済みの通知チャンネルへ投稿してレビューを促す。

• 通知チャンネルは feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 の discord_guild_config.notify_channel_id を共用（設定 UI の追加なし）
• 承認を促すためのメンションは付けない。本文中の人物表示は feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 の resolveDisplayName に従う（allowed_mentions: { parse: [] } により表示はメンション・ping は飛ばさない）
• クエスト詳細へのリンクを載せ、そこで承認してもらう

ポーリング設計

SubmissionAttempt には blockNumber も workspaceId も無く（submittedAt = ブロックタイムスタンプのみ）、Quest.blockNumber は作成時のまま更新されない。よって #530 のブロックカーソルは流用できない。既存スキーマのまま Quest を引く方式にする（サブグラフ変更なし）。

quests(
  where: { workspace: $treeId, status: PendingReview, submittedAt_gte: $cursor }
  orderBy: submittedAt
  orderDirection: asc
  first: $n
) { questId submitter amount hatId wearer creator submittedAt attemptCount metadata { title } }

カーソル

• last_submitted_at（タイムスタンプ）+ その境界タイムスタンプで通知済みのキー集合 を per-workspace で保持。submittedAt_gte で境界を再走査し、キー集合で de-dup する（feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 のブロック境界と同じ考え方）
• de-dup キーは questId 単体ではなく questId + attemptCount。 クエストは「申請 → 却下 → 再申請」がありえて、再申請は改めてレビューが必要なので別イベントとして通知する必要がある（SubmissionAttempt の attemptIndex に対応）
• 初回はカーソル無し → 「導入時点以降」を起点にし、既存の PendingReview を一斉通知しない（feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 と同方針）

自然に成り立つ性質（追加実装不要）

• ポーリング間隔内に申請 → 取り下げ / 却下された場合、status は Open に戻り submittedAt は null になる（questMapping.ts）ため、クエリに引っかからず通知されない。レビュー不要なものは自動的に落ちる

実装メモ

• feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 の scheduled() ハンドラの同一 tick 内で Thanks 通知と並走させる（Promise.allSettled。片方の失敗が他方を止めない）
• feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 側への依頼: カーソルテーブルを thanks_notify_cursor 固定ではなく notify_cursor(tree_id, kind, cursor, boundary_ids, updated_at)（kind = thanks / quest）の形にしておくと、この Issue でテーブル追加・API 追加が不要になる。feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 の実装時に検討したい
• 再利用するもの: postChannelMessage、resolveDisplayName、GET /api/guild-configs、カーソル read/write API
• 新規は subgraph クエリと整形ロジックのみ

メッセージ案

📝 クエストに完了報告が届きました
**{questTitle}** — {submitterLabel}
シェア {amount}
作成者の承認、またはメンバー2名の承認で完了します
{TOBAN_FRONTEND_URL}/{treeId}/quest/{questId}

変更対象（想定）

• pkgs/extensions/discord-bot/src/notifier/（feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 で新設される想定のディレクトリ）: クエスト申請ポーリング + 整形
• pkgs/extensions/discord-bot/src/index.ts: scheduled() へ追加
• pkgs/extensions/discord-bot/src/chain.ts: PendingReview クエスト取得クエリ
• pkgs/extensions/discord-bot/src/identity.ts: カーソル（kind=quest）クライアント
• pkgs/extensions/identity: カーソルの kind 対応（feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 で汎用化されていれば不要）
• pkgs/extensions/discord-bot/test/: 単体テスト

受け入れ条件

• Cron 実行時、前回チェック以降に PendingReview になったクエストのみが通知される（取りこぼし・重複なし）
• 通知に クエスト名 / 申請者 / シェア量 / クエスト詳細へのリンク が含まれる
• 承認条件（作成者単独 or メンバー2名）が文面から分かる
• 承認を促すためのメンションが付かない（本文の人物表示で ping も飛ばない）
• 通知先は feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 で設定した通知チャンネルと同じ
• 「申請 → 却下 → 再申請」で 2 回通知される（questId + attemptCount で区別される）
• ポーリング間隔内に申請が取り下げ / 却下された場合は通知されない
• 導入直後に既存の PendingReview クエストが一斉通知されない
• 1 つの workspace の失敗が他 workspace や Thanks 通知を止めない
• identity / subgraph をインターフェース stub した、ネットワーク非依存の単体テストがある

スコープ外

• 承認完了 / 却下 / 取り下げ / クエスト新規作成 の通知
• 承認を促すメンション（作成者メンション、通知ロール）
• Quest 申請専用の通知チャンネル設定（feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 のチャンネルを共用する）
• Discord 上から承認する操作（ボタン / スラッシュコマンド）
• サブグラフのスキーマ変更（SubmissionAttempt への blockNumber 追加など）

関連

• feat(discord-bot): Cron で subgraph 監視し Thanks 送付を指定チャンネルへ通知（複数workspace対応） #530 — 通知基盤（この Issue の前提）
• [discord-bot] オートコンプリートのクエスト一覧で同一内容の重複をまとめる #560 / [frontend] クエスト作成画面で同一内容のクエストを複数個まとめて作成できるようにする #561 — クエストの重複集約と複数作成

ブランチ

feat/discord-bot-notify-quest-submission（main から）