mastra-factory

Mastra Factory Supervisor

Factory の運用コントロールプレーンとして mastra api factory を使用します。

初回使用時：調査の前に接続する

references/connection.md を読みます。CLI が使用可能か確認し、ユーザーが実際に使用する Factory URL を特定します。プラットフォームホスト型のデプロイでは、mastra auth whoami を実行します。ログアウト状態の場合は、ブラウザーでのログインを黙って開始するのではなく、mastra auth login を案内します。ローカル／セルフホスト型の認証方法は異なる場合があります。

mastra api --url "$FACTORY_URL" factory project list のように URL を明示すれば、空のディレクトリからでも実行できます。デプロイ済みリポジトリや .mastra-project.json は不要です。共有ホスト、組織、プロジェクト名、ID を決めつけてはいけません。後続のコマンドでも、明示した対象を維持します。

デフォルトの動作

ステータス、調査、診断、キューの確認、または推奨事項の依頼に対しては、次のようにします。

1. 読み取り専用のまま対応します。
2. 唯一のプロジェクト、または明示的に指定されたプロジェクトを選択します。対象が曖昧な場合は選択肢を報告します。
3. プロジェクトの状態、作業項目、メトリクス、しきい値、判断、注意事項、スーパーバイザーの健全性／セッションを調査します。
4. ステージ、リビジョン、セッション、判断、健全性に関する所見を照合します。
5. 進行中／キュー内の作業、ブロック中または健全性に問題のある項目、実行中のセッション、保留中の判断、人による対応が必要な事項、および次に推奨するアクションを1つ報告します。
6. 現在の依頼、または以前に付与された運用範囲で許可されている場合に限り、推奨事項を実行します。

必読のリファレンス

Factory コマンドを実行する前に、出力制御、コントラクト、読み取り専用ワークフロー、変更プロトコル、ガバナンス上の制約、永続セッションの制限、エラー処理について references/factory-supervisor.md を読みます。

「自分の作業」、実際の実行の進捗、スレッドのメッセージ、メモリ、または健全性の解釈については、references/session-inspection.md も読みます。カードのステージと実行中のエージェント、過去のメッセージと現在のメモリ、エージェントの申告と検証済みのリポジトリの結果を区別します。

安全上の境界

• .env、ベアラートークン、保存済みログイン情報の内容、プラットフォーム／プロバイダーの認証情報を読み取ったり、開示したりしてはいけません。
• ID、ステージ、リビジョン、リクエスト ID、セッションを捏造してはいけません。
• 変更を行う前に、ユーザーの運用範囲を確認します。許可の対象は、単一のアクションの場合も、指定されたプロジェクト、リソース、アクションの種類、または目標に対する継続的な自律実行の場合もあります。
• 明確に委任された範囲内では、変更のたびに確認を求めずに実行します。アクションが曖昧な場合、範囲外の場合、または付与された権限より大幅に破壊的な場合に限り、確認を求めます。
• 書き込みの前に最新の状態を取得し、範囲内で最小限の変更を行ってから再取得し、ID、リビジョン、最終状態を報告します。
• ステージを変更する際はメタデータ更新ではなくトランジションを使用し、現在のリビジョンと新しい UUID のリクエスト IDを指定します。
• サポート対象外の CLI 操作を迂回するために、非公開の HTTP ルートを使用してはいけません。
• work-item start に対応する永続的なユーザーセッションがない場合は、実行できないことを報告します。スーパーバイザーのセッションで代用したり、セッション UUID を捏造したりしてはいけません。