rara/agent-test/README.md

agent-test 환경 기준

이 디렉터리는 RARA의 환경별 실행 기준과 도메인별 smoke profile을 둔다.

기본 환경

• 사용자가 환경을 별도로 지정하지 않으면 기본 테스트 환경은 원격 dev다.
• dev의 기준 runner는 ssh toki@toki-labs.com이며, 목표 checkout은 /Users/toki/agent-work/rara-dev다.
• local은 현재 checkout에서 빠르게 수행하는 source 단위 검증이나 사용자가 명시적으로 local을 요청한 경우에만 사용한다.
• 원격 checkout이 없거나 현재 변경과 동기화되지 않았으면 local 결과로 원격 evidence를 대신하지 않고 setup/sync 차단 사유를 보고한다.

환경 구조

• 환경 공통값과 프리플라이트는 agent-test/<env>/rules.md에 둔다.
• 반복해서 읽어야 하는 runner, checkout, port 상태는 agent-test/<env>/inventory.yaml에 둔다.
• 도메인별 검증 기준은 agent-test/<env>/<domain>-smoke.md에 둔다.
• secret, token, password, private key, 개인 endpoint 원문은 기록하지 않는다.

현재 환경

• dev: 원격 Mac runner를 사용하는 기본 테스트 환경
• local: 현재 host의 빠른 source/build 검증 환경

포트 선택 기준

• workspace root의 포트 원장 .workspace-ops/docs/ports.md에서 project-owned 슬롯과 shared IOP field 포트를 먼저 확인한다.
• RARA dev는 2026-07-18 충돌 점검 당시 미배정이던 70 슬롯을 전용으로 배정해 사용한다.
• 실행 직전에는 원격 runner의 실제 listen 상태를 다시 확인한다. 문서에 기록된 점검 결과는 영구적인 port lock으로 간주하지 않는다.