Skip to content

feat(arena): Server 체험 공간 설정 수신 — 환경변수 기준선을 좁히기만 허용 (#124) - #125

Open
exijn wants to merge 2 commits into
developfrom
feature/arena-settings-sync
Open

exijn wants to merge 2 commits into
developfrom
feature/arena-settings-sync

Conversation

@exijn

@exijn exijn commented Nov 12, 2026

Copy link
Copy Markdown
Member

Refs #124

머지하지 않는다 (needs-robot-test). 운영 Agent(/opt/poppy-agent)에 반영하지 않았다. 기본이 꺼짐이라 켜기 전에는 동작이 바뀌지 않는다.
#95(feature/94-arena-position-safety) 위에 쌓았다. develop 에는 공간 위치 기반 안전 검사(arena_*·start_*)가 아직 없다(#95 에만 있고, #95 는 develop 과 이미 충돌). base 가 #95 브랜치인 이유다 — #95 가 정리되면 이 PR 의 base 를 바꾼다.

변경

  • config/arena_override.py — narrow_arena(baseline, payload): Server 값이 환경변수 기준선보다 조금이라도 넓으면 전체 거부(한 변 > 기준선·하드 상한 6 m, 벽 여유 < 기준선·하드 최소 0.4 m, 출발점이 여유 밖, 가용 영역 < 1.3 m, 숫자가 아니거나 유한하지 않음, 방향 이상). 받으면 arena·출발점·1회 이동 한도만 바꾼다. 1회 이동 한도 = min(기준선, 3.0, 가용 영역 짧은 변 − 0.8, Server 값) — Server 가 큰 값을 줘도 기하에서 따로 계산한다. 만료·승인·속도·총 시간·허용 명령은 Server 에서 받지 않는다.
  • execution/arena_sync.py — 시작 시 + 주기 조회. 연결 실패·거부 → 마지막 수신값이 아니라 기준선.
  • OpenMotionGuard.apply_arena — 실행 중에는 보류, release() 뒤 적용. _inside_arena 는 한 번의 plan 안에서 값이 바뀌지 않게 인자로 받는다.
  • ServerClient.get_arena_settings, main.py: POPPY_ARENA_SETTINGS_SYNC=true 일 때만 시작(기본 꺼짐), 상태에 arenaSource 노출
  • 문서 docs/controlled-motion-open.md

판단 (요청과 다르거나 해석한 부분)

  • 하드 상한 한 변 6 m: 요청 문서는 8 m 라고 했으나 feat(physical): 안전 검사를 공간 위치 기반으로 교체 (최대 6 m × 6 m) #95 코드(MAX_ARENA_SIDE_METERS = 6.0, 교사 승인 6 m)가 6 m 다. 더 좁은 쪽을 그대로 썼다.
  • "서버 미연결 시 가장 보수적인 기본값" = 환경변수 기준선으로 해석했다. 상수(3×3)로 정하면 좌표 원점·출발점이 환경변수와 달라 의미가 어긋난다. 대신 부스 당일에는 환경변수도 3×3 으로 맞춘다(문서의 ⚠️) — 그러면 연결이 끊겨도 3×3 이 유지되고, Server 가 6×6 을 줘도 거부된다.
  • 1회 이동 한도·기본값의 공식(가용 짧은 변 − 0.8)은 Server(#159)와 같다.

테스트 (476 통과, 신규 36)

설정으로 안전을 넓힐 수 없음: 폭·깊이·여유·출발점·하드 상한·NaN/음수/bool/문자열/빈 객체/비객체 거부(기준선 객체 그대로 유지), 3×3 기준선에 6×6 을 주면 거부되고 2.1 m 이동 거부 유지, 1회 이동 한도는 낮추기만, 만료·승인은 Server 에서 안 받음. 3×3 적용 후 guard: 1.2 m 허용·1.3 m 거부·1.2+1.2 m 이탈 거부·오른쪽 회전 후 이동 거부·왼쪽 회전 후 허용·네모(1 m ×4 왼쪽) 허용. 연결 실패·거부 후 기준선 복귀(마지막 수신값 아님), 실행 중 갱신은 release 뒤, 기본 꺼짐, 공개 엔드포인트 호출. ruff/mypy/harness 통과.

로봇 시험 필요 (needs-robot-test)

로봇 실기에서 3×3 영역(출발 (2.5,0.5))으로 인사·1 m 이동·네모 걷기를 확인한 적이 없다. 실기 전에는 운영에 올리지 않는다.

🤖 Generated with Claude Code

- narrow_arena: 넓히거나 이상한 값은 전체 거부, 1회 이동 한도는 기하에서 독립 계산
- ArenaSettingsSync: 시작 시 + 주기 조회, 실패하면 마지막 수신값이 아니라 기준선
- OpenMotionGuard.apply_arena: 실행 중에는 release 뒤에 적용
- POPPY_ARENA_SETTINGS_SYNC=true 일 때만 동작(기본 꺼짐)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@exijn exijn added enhancement New feature or request safety POPPY safety robot POPPY robot needs-robot-test 실기(로봇) 검증 전 머지 금지 소웨-3x3 소프트웨이브 3×3m 부스 전환 마감 labels Nov 12, 2026
@exijn
exijn changed the base branch from feature/94-arena-position-safety to develop November 16, 2026 08:06
#95 머지 뒤 base 를 develop 으로 바꾸며 생긴 충돌(docs/controlled-motion-open.md 끝에 두 절이 각각 추가됨)을 두 절 모두 남겨 푼다.
pytest 540·ruff·ruff format·mypy·harness 통과.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

소웨-3x3 소프트웨이브 3×3m 부스 전환 마감 enhancement New feature or request needs-robot-test 실기(로봇) 검증 전 머지 금지 robot POPPY robot safety POPPY safety

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant