# Complete - work_item_provider_interface

## 완료 일시

2026-05-23

## 요약

Provider-neutral work item contract와 Plane adapter facet 구현을 1회 루프에서 PASS로 완료했다.

## 루프 이력

| Plan | Review | Verdict | 메모 |
|------|--------|---------|------|
| `plan_cloud_G06_0.log` | `code_review_cloud_G06_0.log` | PASS | Required/Suggested issue 없음. |

## 구현/정리 내용

- `services/core/internal/workitem`에 provider-neutral DTO, optional facet interface, ref normalization, state/label mapping helper를 추가했다.
- Plane adapter에 `workitem.Provider`, `Reader`, `Commenter`, `StatusProjector` facet 구현과 conformance 테스트를 추가하고 기존 Plane-specific API를 유지했다.

## 최종 검증

- `cd services/core && gofmt -w internal/workitem/*.go internal/adapters/plane/client.go internal/adapters/plane/client_test.go` - PASS; 출력 없음.
- `cd services/core && ! rg --sort path -n '"github.com/nomadcode/nomadcode-core/internal/adapters/plane"|plane\\.' internal/workitem internal/workflow` - PASS with documented false positive; `internal/workflow/service_test.go`의 `https://plane.example/...` 문자열만 매치됐고 adapter import는 없음.
- `cd services/core && go test -count=1 ./internal/workitem ./internal/adapters/plane ./internal/http ./internal/workflow` - PASS; 관련 패키지 fresh run 통과.
- `git diff --check` - PASS; 출력 없음.
- `cd services/core && go test -count=1 ./...` - PASS; core 전체 패키지 테스트 통과.

## 잔여 Nit

- 없음

## 후속 작업

- 없음
