# 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으로 간주하지 않는다.