oto/agent-test/local/agent-smoke.md

test_env	test_profile	domain	verification_type	last_rule_updated_at
local	agent-smoke	agent	smoke	2026-06-07

agent-smoke local 테스트

읽기 조건

• apps/runner/lib/oto/agent/**, apps/runner/lib/cli/commands/command_agent.dart, apps/runner/assets/script/shell/oto_agent_bootstrap.sh, services/core/cmd/oto-core/main.go, services/core/internal/httpserver/**, 또는 services/core/internal/runnerregistry/** 변경 검증이 필요한 경우

적용 범위

• OTO agent 등록/설정/CLI/bootstrap smoke 경로
• OTO Server runner registration, bootstrap command, release URL validation 경로
• legacy iop smoke는 별도 iop 쪽 OTO 제거 작업의 검증 대상이며, 이 OTO 독립 마이그레이션 agent-smoke 필수 검증에서는 제외한다.

분류

• domain: agent
• verification_type: smoke
• scope: OTO agent 로컬 동작과 기존 smoke test

환경

• host:
• port: backend host publish 후보 18020; local compatibility 기본값 127.0.0.1:8080
• runtime: Dart SDK, Go toolchain
• package manager: dart pub, Go modules
• docker:
• external service: 없음
• model endpoint:
• credential:

포트/환경 체크리스트

• Core publish 검증은 OTO_CORE_ADDR=0.0.0.0:18020 기준 후보를 사용한다. 127.0.0.1:8080은 기존 local default compatibility로만 남긴다.
• bootstrap command는 --server-url을 기준 인자로 문서화한다. --edge-url은 script 호환 alias로만 본다.
• OTO_RUNNER_RELEASE_BASE_URL은 https:// scheme만 허용한다. token, credential, private release host 원문은 테스트 규칙과 tracked 문서에 쓰지 않는다.
• iop Edge/wire endpoint는 독립 OTO Control Plane smoke의 필수 검증 대상이 아니다.

명령

• setup:
  • runner: cd apps/runner && dart pub get (또는 make runner-get)
  • core: cd services/core && go mod download
• lint:
  • runner: cd apps/runner && dart analyze (또는 make runner-analyze)
• unit:
  • runner: cd apps/runner && dart test test/oto_agent_migration_plan_test.dart test/oto_agent_bootstrap_script_test.dart test/oto_agent_cli_test.dart test/oto_agent_config_test.dart test/oto_agent_registration_test.dart test/oto_server_connection_smoke_test.dart (또는 make runner-test)
  • core: cd services/core && go test ./... (또는 make core-test)
• smoke:
• e2e:
• model:
• full-cycle:

필수 검증

• runner agent 도메인 변경 후 cd apps/runner && dart analyze를 실행한다.
• runner agent 도메인 변경 후 agent 관련 cd apps/runner && dart test ... 명령을 실행한다.
• services/core registration, bootstrap command, release URL validation 변경 후 cd services/core && go test ./...를 실행한다.

보조 검증

• 전체 회귀가 필요한 경우 cd apps/runner && dart test 또는 make runner-test를 실행한다.
• OTO Server 전체 회귀가 필요한 경우 make core-test를 실행한다.

판정 기준

• cd apps/runner && dart analyze가 issue 없이 종료한다.
• 지정한 cd apps/runner && dart test가 모두 통과한다.
• 지정한 cd services/core && go test ./...가 모두 통과한다.

기준 출력 예시

No issues found!
All tests passed!

차단 기준

• Dart SDK 또는 path dependency가 없어 dart pub get, dart analyze, dart test를 시작할 수 없는 경우

보고 항목

• 실행한 명령:
• 성공한 검증:
• 실패/차단된 검증:
• 생략 사유:
• 남은 위험:

금지 사항

• 외부 iop endpoint, secret, token 원문을 테스트 규칙이나 tracked 문서에 기록하지 않는다.