paperclip-monitor

Paperclip Monitor

Paperclip の実行状況を調査し、オペレーターの対応が必要な項目を明らかにします。

参照資料

最初に以下をお読みください。

• references/CONTEXT.md
• references/docs/paperclip-operator/control-plane.md
• references/docs/paperclip-operator/workflow.md
• references/docs/paperclip-operator/cli-contract.md
• references/docs/paperclip-operator/integration-matrix.md

これらのプロジェクトドキュメントが見つからない場合は、まず paperclip-setup を実行して、同梱のテンプレートから作成してください。

読み取り専用のワークフロー

1. CLI のコンテキストと会社のスコープを確認します。
2. ダッシュボードの概要を読み取ります。
3. イシューを読み取り、以下に注目します。
   • blocked
   • in_review
   • in_progress
   • 長期間更新されていない todo
   • 未完了の子イシューがある親イシュー
4. 承認を確認し、特に保留中および修正依頼中のものに注目します。
5. エージェントを確認し、一時停止中、エラー、実行中、または予算によるブロック状態を記録します。
6. 対応中または最近割り当てられたイシューについて、利用可能な場合は paperclipai issue live-runs、active-run、runs、recovery-actions を --json とともに使用します。キューに入った配信、プロセスの復旧、コメントの欠落による再試行、明示的な復旧アクションを区別し、すべての後続実行を一律に再試行と扱わないでください。新しい環境では、追加の実行稼働状況フィールドを機能検出してください。
7. 最近の重要なイベントを把握するため、アクティビティを読み取ります。
8. 最近割り当てられた作業について、正常なディスパッチ（wake queued、キューに入った／実行中の実行、または workspace ready）と、スキップ／失敗したディスパッチを区別します。正常にキューに入った、または実行中の作業の引き取りは成功として扱い、介入対象にしないでください。
9. レビュー段階のイシューでは、利用可能な場合、executionState.currentStageType、currentParticipant、returnAssignee を確認します。通常、実行担当者はステータスを done に変更して提出します。その結果生じる in_review のルーティングは Paperclip が担当し、エージェントのレビュアーに割り当てます。最終承認に人間の対応が必要な場合は、イシューのインタラクションも確認します。保留中の request_confirmation は正常な待機状態です。一方、承認／却下されたインタラクション後に再開に失敗した場合や、レビュアーによる後続対応がない場合は注意が必要です。ユーザーが承認段階の参加者になっている場合はフローの不具合であり、オペレーターに CLI の使用を指示する理由にはなりません。
10. 注意が必要な項目を優先度順にまとめます。すべてのブロック中、in_review、承認保留中、エージェントのエラー、未解決の復旧アクション、明示的にスキップ／失敗したディスパッチ項目をレポートに記載するか、該当なしと明記すれば完了です。

レポート形式

## Paperclip Monitor Report

### Needs Operator Attention

### Blocked Work

### Pending Reviews And Approvals

### Run And Recovery State

### Agent Health

### Cost And Budget Signals

### Recent Progress

### Recommended Actions

アクションの推奨事項

変更は実行せず、以下を推奨してください。

• 承認、却下、または修正を依頼する
• 保留中のイシュー request_confirmation を承認または却下する
• イシューのステータスを変更する
• コメントを追加する
• ブロッカーを作成する
• 明示的にスキップ／失敗したディスパッチを調査する
• 作業の割り当て先を変更する
• エージェントを一時停止、再開、または終了する

wake がキューに入っている、実行が進行中、またはワークスペースの準備が完了したという理由だけで、コメント、ハートビート／再開、再割り当て、ワークスペース／環境の変更、割り込みを推奨しないでください。キューに入っている実行中または実行中の実行に対するコメントは、作業への割り込みとなります。割り込みによってプロセスの復旧が発生する場合があり、必須コメントが欠けているとコメントの再試行が 1 回発生する場合があります。割り当て解除や再割り当てを行うための修正計画は、すべての実行中の実行と関連する復旧アクションが完了するまで待つ必要があります。

変更ルール

監視はデフォルトで読み取り専用です。Paperclip に変更を加える前に確認を求めてください。