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

스크립트는 다음 글로브를 통해 모든 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

수동 테스트

권장 흐름:

  • 개발 모드에서 게이트웨이 실행:
    • 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/를 유지하세요.

참조