Pi開発ワークフロー

このガイドは、MayrosでのPi統合作業のための健全なワークフローをまとめたものです。

型チェックとリンティング

  • 型チェックとビルド: pnpm build
  • リント: pnpm lint
  • フォーマットチェック: pnpm format
  • プッシュ前の完全なゲート: pnpm lint && pnpm build && pnpm test

Piテストの実行

Pi統合テストセット用の専用スクリプトを使用します：

bash
scripts/pi/run-tests.sh

実際のプロバイダー動作を実行するライブテストを含めるには：

bash
scripts/pi/run-tests.sh --live

スクリプトは、これらのglob経由ですべてのPi関連ユニットテストを実行します：

  • src/agents/pi-*.test.ts
  • src/agents/pi-embedded-*.test.ts
  • src/agents/pi-tools*.test.ts
  • src/agents/pi-settings.test.ts
  • src/agents/pi-tool-definition-adapter.test.ts
  • src/agents/pi-extensions/*.test.ts

手動テスト

推奨フロー：

  • 開発モードでgatewayを実行：
    • pnpm gateway:dev
  • エージェントを直接トリガー：
    • pnpm mayros agent --message "Hello" --thinking low
  • インタラクティブデバッグにTUIを使用：
    • pnpm tui

ツール呼び出し動作については、readまたはexecアクションを促して、ツールストリーミングとペイロード処理を確認できます。

クリーンスレートリセット

状態はMayros状態ディレクトリの下にあります。デフォルトは~/.mayrosです。MAYROS_STATE_DIRが設定されている場合は、そのディレクトリを使用します。

すべてをリセットするには：

  • 設定用のmayros.json
  • 認証プロファイルとトークン用のcredentials/
  • エージェントセッション履歴用のagents/<agentId>/sessions/
  • セッションインデックス用のagents/<agentId>/sessions.json
  • レガシーパスが存在する場合はsessions/
  • 空白のワークスペースが必要な場合はworkspace/

セッションのみをリセットしたい場合は、そのエージェントのagents/<agentId>/sessions/とagents/<agentId>/sessions.jsonを削除します。再認証したくない場合はcredentials/を保持します。

リファレンス