toki/oto

toki 67625af737 fix(core): heartbeat 타임아웃 처리와 테스트를 보강한다

IOP 경로의 동작 안정성을 높이기 위해 서버 상태 처리와 관련한
연결 테스트 검증을 함께 정합성 있게 갱신한다.

2026-06-10 18:14:59 +09:00

test_env	last_rule_updated_at
local	2026-06-10

local 테스트 규칙

현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.

공통 규칙

local 테스트/검증은 이 파일을 기준으로 판단한다.
작업 완료 검증은 변경 범위 기준으로 선택한다.
필수 검증을 실행하지 못하면 차단 사유로 보고한다.
최종 보고에는 실행 명령, 결과, 생략 사유, 남은 위험을 남긴다.
환경값, secret, 개인 endpoint는 tracked docs/roadmap에 쓰지 않는다.
테스트용 Docker 환경을 작성/수정할 때는 Docker Compose networks, IPAM subnet, static IPv4, extra_hosts, host publish 문서 어디에도 192.168.0.0/24 (192.168.0.X) 대역을 사용하지 않는다.
새 Docker 테스트 subnet이 필요하면 기존 프로젝트 포트/네트워크 표준을 먼저 따르고, 불가피한 경우 host LAN/VPN과 충돌하지 않는 192.168.0.0/24 밖의 private subnet만 사용한다.

OTO Core host publish 후보는 backend 18020이다. 로컬 실행 기본값 127.0.0.1:8080은 compatibility 경로로만 해석한다.
Flutter client/web preview 후보는 frontend 13020이다. preview 포트와 OTO_SERVER_HTTP_URL 서버 연결 URL을 혼동하지 않는다.
OTO_RUNNER_RELEASE_BASE_URL과 bootstrap command 검증은 source of truth와 validation 기준만 기록한다. secret, token, private release host 원문은 tracked 문서와 테스트 규칙에 남기지 않는다.
독립 OTO Control Plane 검증에서 iop Edge/wire 포트를 OTO workspace 포트 표준으로 간주하지 않는다.

agent / smoke / OTO agent CLI, OTO Server registration, bootstrap script: agent-test/local/agent-smoke.md
cli / smoke / CLI entrypoint, resource importer, scripts, package assets: agent-test/local/cli-smoke.md
command / smoke / command implementations and data models: agent-test/local/command-smoke.md
core / smoke / Application, tag system, composer, core utilities: agent-test/local/core-smoke.md
framework / smoke / pubspec, analyzer options, dependency and generated-code boundary: agent-test/local/framework-smoke.md
pipeline / smoke / pipeline execution and pipeline data model: agent-test/local/pipeline-smoke.md
sample / smoke / sample YAML and template-facing examples: agent-test/local/sample-smoke.md
scheduler / smoke / scheduler CLI and runtime: agent-test/local/scheduler-smoke.md

apps/runner (Dart CLI runner):
- Setup: make runner-get 또는 cd apps/runner && dart pub get
- Lint: make runner-analyze 또는 cd apps/runner && dart analyze
- Test: make runner-test 또는 cd apps/runner && dart test
apps/client (Flutter OTO client app):
- Setup: make client-get 또는 cd apps/client && flutter pub get
- Lint: make client-analyze 또는 cd apps/client && flutter analyze
- Test: make client-test 또는 cd apps/client && flutter test
services/core (Go OTO Server):
- Test: make core-test 또는 cd services/core && go test ./...
packages/flutter/oto_console (Flutter OTO console package):
- Setup: cd packages/flutter/oto_console && flutter pub get
- Lint: cd packages/flutter/oto_console && flutter analyze
- Test: cd packages/flutter/oto_console && flutter test
protobuf (proto contract):
- Generate: make proto (또는 make proto-go, make proto-dart)