Skip to content

fix(physical): 자세·프리셋 실패 시 자세 불명으로 두고 재조회로 복구 (#98) - #110

Open
exijn wants to merge 7 commits into
developfrom
fix/98-sit-lock-recovery
Open

exijn wants to merge 7 commits into
developfrom
fix/98-sit-lock-recovery

Conversation

@exijn

@exijn exijn commented Nov 10, 2026

Copy link
Copy Markdown
Member

Part of #98 (sportmodestate 기반 실제 자세 조회 구현은 #97 구독 이후 후속)

배경

10/31·11/1 잠김: Sit 이 SDK 에서 거절됐는데 guard 는 SIT 전송 시점부터 sitting=true 로 간주 → HELLO 는 "after SIT" 거부, STAND 는 서 있는 로봇에 RiseSit 전송 → 거절 → 재시작 전까지 잠김.

변경

  • OpenMotionGuard 자세를 STANDING/SITTING/UNKNOWN 3상태로 추적(TrackedPosture).
  • POSTURE·PRESET 실패(SDK 거절·예외)와 STAND 취소 시 mark_posture_unknown() → UNKNOWN. MOVE 실패는 자세 불변(기존 동작 유지).
  • UNKNOWN 동안 물리 명령이 있는 프로그램은 dispatch 전에 거부(맹목적 RiseSit/StandUp 없음). guard 상태 POSTURE_UNKNOWN → READY 아님, status reasons: ["POSTURE_UNKNOWN"], trial.posture/postureUnknownReason 노출.
  • 재조회 경로: adapter 가 읽기 전용 observed_posture() 를 제공하면 실패 직후·READY 계산·승인 때 자동 재조회/동기화, 로봇 응답이 있을 때만 UNKNOWN 해제(운영자 경로 resync_posture()). 현재 develop adapter 에는 없으므로 운영 동작은 "실패 → 잠김(사유 표시) → 로봇이 서 있음을 눈으로 확인 후 재시작" 이다(문서화).
  • 새 SDK 호출·구독·설정 키 없음. 로봇에 보내는 명령은 늘지 않고, 실패 뒤 보내던 명령만 줄어든다(fail-closed).

검증

harness, ruff, ruff format, mypy, pytest 433 passed(신규 17, fake 전용). 로봇·네트워크 접근 없음.

  • 잠김 재현: Sit 거절 → HELLO/STAND/MOVE 모두 거부, SDK 호출 0건.
  • 복구: probe 가 STAND → HELLO 실행, SIT → STAND 가 RiseSit.

남은 일(#98)

🤖 Generated with Claude Code

- SIT/STAND/PRESET 실패(SDK 거절·예외)와 STAND 취소 시 추적 자세를 UNKNOWN 으로 둔다.
- UNKNOWN 동안 물리 명령 프로그램은 dispatch 전에 거부하고 NOT_READY(POSTURE_UNKNOWN)로 보고한다.
- adapter 의 읽기 전용 observed_posture() 가 있으면 실패 직후·READY 계산·승인 때 재조회해 동기화한다.
- 10/31·11/1 잠김(Sit 거절 → sitting=true → RiseSit 거절) 재현·복구 회귀 테스트 추가.

Part of #98

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@inryeok-bot inryeok-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경사항과 관련 코드 경로를 확인했으며, 현재 수정이 필요한 문제는 발견하지 못했습니다.

@exijn

exijn commented Nov 10, 2026

Copy link
Copy Markdown
Member Author

자동화 정리(2026-11-10): CI 성공·충돌 없음·로컬 검증 통과(433 passed, fake 전용) 상태이며, 자동화 기준으로는 머지 가능하다고 판단했습니다(로봇에 보내는 명령이 늘지 않고 실패 뒤 명령만 줄어드는 fail-closed 변경, 새 SDK 호출·구독 없음). 다만 자동화 실행 환경의 권한 검사에서 이 PR 의 머지가 거부되어 사람이 최종 확인 후 squash merge 해 주세요(needs-human).

확인 포인트: 운영 중 POSTURE/PRESET 실패 시 이제 재시작 전까지 물리 명령이 막힙니다(이전과 같은 잠김이지만 원인이 POSTURE_UNKNOWN 으로 보이고, 서 있는 로봇에 RiseSit 을 보내지 않음). 재시작 전 로봇이 서 있는지 눈으로 확인하는 절차가 docs/controlled-motion-open.md 에 추가되었습니다.

@exijn

exijn commented Nov 10, 2026

Copy link
Copy Markdown
Member Author

업데이트: develop(#113 실패 코드) 반영 후 자세 불명 거부에 failure_code=POSTURE_UNKNOWN 연결. CI 성공, 로컬 459 passed. 머지는 위 코멘트대로 사람 확인 대기(needs-human).

@exijn exijn mentioned this pull request Nov 10, 2026
12 tasks
@exijn exijn added the P2 POPPY P2 label Nov 11, 2026
@exijn

exijn commented Nov 11, 2026 •

Copy link
Copy Markdown
Member Author

11/12 3×3 부스 시연 분류

  • 우선도: P2 — 이번 이틀에서 잘라냄
  • 범위: 이번 이틀 범위 밖. 시연 이후 재개.
  • 실행 주체: 사람필요
  • 일정: 11/12까지 실행하지 않음.
  • 판단 근거: SIT·PRESET을 시연에서 제외하므로 자세 복구 PR은 이번에 잘라낸다. CI 통과는 실기 완료를 뜻하지 않는다.
  • 선행: [3일-핵심] 앉기·동작 실패 시 잠김 자동 복구 #98
  • 후속: 없음

@exijn exijn added the 사람필요 사람 판단·승인·외부 설정이 필요한 작업 label Nov 11, 2026
@exijn

exijn commented Nov 11, 2026

Copy link
Copy Markdown
Member Author

시연 준비 자동화가 검토했습니다. 오늘(11/11) 시연 전에는 머지하지 않습니다.

이유:

  • 지금 운영 UnitreeGo2Adapter 에는 observed_posture() 가 없어서, 이 PR 의 자동 복구(자세 재조회)가 운영에서는 동작하지 않습니다(test_without_probe_operator_resync_keeps_the_lock). 재조회 구현은 feat(physical): MOVE·TURN을 sportmodestate 기반 폐루프로 전환 (r11) #97 의 rt/sportmodestate 위에서 실기 확인이 필요합니다.
  • probe 가 없으면 이 PR 은 PRESET(인사·하트·춤) 실패도 POSTURE_UNKNOWN 으로 바꿔, 이후 모든 물리 실행을 Agent 재시작 전까지 막습니다. 지금 develop 에서는 PRESET 실패가 그 실행 1회만 실패하고 다음 실행은 됩니다. 시연에서는 인사·하트·춤을 쓰므로, 이 PR 을 넣으면 시연이 잠길 위험이 오히려 커집니다.
  • 원래 문제였던 SIT 거절 잠김은 Client 에서 앉기 블록을 기본으로 숨긴 상태(NEXT_PUBLIC_ENABLE_SIT_BLOCK=false)라 시연 경로에서는 일어나지 않습니다.

다음 단계: #97 실기 검증 → observed_posture() 구현 → 이 PR 머지. 그 전에 PRESET 실패만 따로 다룰지(예: PRESET 실패는 UNKNOWN 으로 바꾸지 않음)도 정해야 합니다. 시연 중 잠김 대응은 Agent 재시작 절차로 합니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-human 사람 판단/승인 필요 P2 POPPY P2 robot POPPY robot safety POPPY safety 사람필요 사람 판단·승인·외부 설정이 필요한 작업

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant