@@ -11,6 +11,12 @@
    
    작업자 추적과 정지·호출 제스처를 구조화하는 참조 MVP입니다.
    
  + ## MVP 동작 범위
  + 
  + - 최고 신뢰도 작업자 트랙 선택
  + - 제스처를 로봇 명령으로 변환
  + - 신뢰도 미달 시 안전 대기
  + 
    ## 실행
    
    ```bash
@@ -18,4 +24,4 @@ python run.py examples/input.json
    python -m unittest discover -s tests -v
    ```
    
  − 실제 기관 구현은 `contracts/component.interface.json`의 저장소 식별자와 제품 기준선 연결 규칙을 유지하면서 교체할 수 있습니다.
  + 정상 입력은 `examples/input.json`, 차단·안전 경로는 `examples/failure-input.json`으로 재현합니다. 실제 기관 구현은 `contracts/component.interface.json`의 저장소 식별자와 제품 기준선 연결 규칙을 유지하면서 교체할 수 있습니다.

modified asw_component/component.py +12−3 View file

@@ -1,7 +1,16 @@
    from __future__ import annotations
    
  + COMMANDS = {"STOP": "SAFETY_STOP", "FOLLOW": "FOLLOW_WORKER", "CALL": "APPROACH_WORKER"}
  + 
    
    def execute(payload: dict) -> dict:
  −     if not isinstance(payload, dict) or not payload:
  −         raise ValueError("a non-empty object is required")
  −     return {"component": "cnu/worker-gesture-perception", "accepted": True, "status": "READY", "target": "vpu", "input_fields": sorted(payload.keys())}
  +     threshold = float(payload.get("confidenceThreshold", 0.8))
  +     candidates = [track for track in payload.get("tracks", []) if float(track.get("confidence", 0)) >= threshold]
  +     candidates.sort(key=lambda track: (-float(track["confidence"]), track["id"]))
  +     selected = candidates[0] if candidates else None
  +     command = "WAIT" if not selected else COMMANDS.get(selected.get("gesture"), "WAIT")
  +     worker = None if not selected else {"id": selected["id"], "confidence": float(selected["confidence"]), "distanceM": float(selected.get("distanceM", 0)), "gesture": selected.get("gesture", "UNKNOWN")}
  +     return {"component": "cnu/worker-gesture-perception", "accepted": selected is not None,
  +             "status": "WORKER_READY" if selected else "NO_WORKER", "target": "vpu",
  +             "selectedWorker": worker, "command": command, "stopRequired": command == "SAFETY_STOP",
  +             "consideredTracks": len(payload.get("tracks", []))}

modified contracts/component.interface.json +21−1 View file

@@ -5,7 +5,12 @@
      "required": [
        "component",
        "accepted",
  −     "status"
  +     "status",
  +     "target",
  +     "selectedWorker",
  +     "command",
  +     "stopRequired",
  +     "consideredTracks"
      ],
      "properties": {
        "component": {
@@ -19,6 +24,21 @@
        },
        "target": {
          "const": "vpu"
  +     },
  +     "selectedWorker": {
  +       "type": [
  +         "object",
  +         "null"
  +       ]
  +     },
  +     "command": {
  +       "type": "string"
  +     },
  +     "stopRequired": {
  +       "type": "boolean"
  +     },
  +     "consideredTracks": {
  +       "type": "integer"
        }
      }
    }

added examples/failure-input.json +11−0 View file

@@ -0,0 +1,11 @@
  + {
  +   "tracks": [
  +     {
  +       "id": "worker-04",
  +       "confidence": 0.52,
  +       "gesture": "FOLLOW",
  +       "distanceM": 2.3
  +     }
  +   ],
  +   "confidenceThreshold": 0.8
  + }

modified examples/input.json +8−1 View file

@@ -3,7 +3,14 @@
        {
          "id": "worker-04",
          "confidence": 0.93,
  −       "gesture": "FOLLOW"
  +       "gesture": "FOLLOW",
  +       "distanceM": 2.3
  +     },
  +     {
  +       "id": "worker-07",
  +       "confidence": 0.81,
  +       "gesture": "CALL",
  +       "distanceM": 4.1
        }
      ],
      "confidenceThreshold": 0.8

modified pyproject.toml +1−1 View file

@@ -1,5 +1,5 @@
    [project]
    name = "worker-gesture-perception"
  − version = "0.1.0"
  + version = "0.2.0"
    description = "작업자 추적과 정지·호출 제스처를 구조화하는 참조 MVP입니다."
    requires-python = ">=3.11"

modified release/manifest.json +1−1 View file

@@ -4,7 +4,7 @@
      "displayName": "작업자·제스처 인지",
      "owner": "충남대학교",
      "implementationAuthor": "주식회사 비아 (연동 검증용 참조 구현)",
  −   "version": "0.1.0-mvp",
  +   "version": "0.2.0-mvp",
      "domain": "AI Perception",
      "status": "REFERENCE_MVP",
      "compatibility": {

modified tests/test_component.py +12−0 View file

@@ -12,6 +12,18 @@ class ComponentTest(unittest.TestCase):
            result = execute(payload)
            self.assertTrue(result["accepted"])
            self.assertEqual(result["component"], "cnu/worker-gesture-perception")
  +         self.assertEqual(result["target"], "vpu")
  +         self.assertEqual(result["selectedWorker"]["id"], "worker-04")
  +         self.assertEqual(result["command"], "FOLLOW_WORKER")
  +         self.assertFalse(result["stopRequired"])
  + 
  +     def test_safety_or_failure_path(self):
  +         payload = json.loads((ROOT / "examples/failure-input.json").read_text(encoding="utf-8"))
  +         result = execute(payload)
  +         self.assertEqual(result["component"], "cnu/worker-gesture-perception")
  +         self.assertFalse(result["accepted"])
  +         self.assertEqual(result["status"], "NO_WORKER")
  +         self.assertEqual(result["command"], "WAIT")
    
    if __name__ == "__main__":
        unittest.main()