<!-- task=m-agent-registration-capability-boundary/03+01,02_registration_wiring plan=0 tag=REFACTOR -->

# Plan - REFACTOR Registration Wiring

## 이 파일을 읽는 구현 에이전트에게

`CODE_REVIEW-*-G??.md` 작성이 필수 마지막 단계다. 선행 `01_agent_port`, `02+01_command_adapter`의 `complete.log`가 없으면 구현을 시작하지 않는다. 최종화와 roadmap 완료 처리는 code-review/runtime 책임이다.

## 배경

port와 adapter가 생긴 뒤에도 production 등록 경로가 adapter 계약만 소비하도록 wiring해야 milestone이 닫힌다. 이 subtask는 `OtoServerRegistrationClient`의 command imports를 제거하고, 기본 client 생성 경로가 command adapter provider를 주입하도록 연결한다.

## 사용자 리뷰 요청 흐름

구현 중 blocker는 active review stub의 `사용자 리뷰 요청` 섹션에 기록한다. 직접 사용자 prompt는 금지이며 code-review가 user review 여부를 결정한다.

## Roadmap Targets

- Milestone: `agent-roadmap/phase/message-based-build-agent/milestones/agent-registration-capability-boundary.md`
- Task ids:
  - `registration`: 기존 registration payload 의미를 유지하면서 agent registration client가 adapter 계약만 소비하도록 바꾼다.
  - `rule-evidence`: 변경 후 agent domain rule 위반 import가 남아 있지 않은지 확인한다.
- Completion mode: check-on-pass

## 분석 결과

### 읽은 파일

- `apps/runner/lib/oto/agent/registration_client.dart`
- `apps/runner/lib/oto/agent/agent_runner.dart`
- `apps/runner/lib/oto/commands/command.dart`
- `apps/runner/lib/oto/commands/command_catalog.dart`
- `apps/runner/lib/oto/commands/command_registry.dart`
- `apps/runner/test/oto_agent_registration_test.dart`
- `apps/runner/test/oto_server_connection_smoke_test.dart`
- `agent-test/local/agent-smoke.md`
- `agent-test/local/command-smoke.md`
- `agent-ops/rules/project/domain/agent/rules.md`
- `agent-ops/rules/project/domain/command/rules.md`

### 테스트 환경 규칙

`test_env=local`. agent-smoke 기준으로 `cd apps/runner && dart analyze`, agent registration tests, OTO Server connection smoke를 실행한다. rule evidence는 deterministic `rg --sort path` 검색으로 확인한다.

### 테스트 커버리지 공백

- 기존 request build test는 explicit `commandTypes` path만 검증한다. provider default path로 payload가 동일하게 생성되는 test를 추가해야 한다.
- OTO Server smoke는 explicit commandTypes call site가 많아 default provider path 자체는 별도 unit test로 보강해야 한다.

### 심볼 참조

- `OtoServerRegistrationClient(commandTypes:)` call sites: `oto_agent_registration_test.dart` lines 103, 150, 201, 257, 320, 374, 623 and `oto_server_connection_smoke_test.dart` lines 61, 390, 573, 727, 866, 997, 1114, 1250. 호환 유지 대상이다.
- 제거 대상 import: [registration_client.dart](/config/workspace/oto/apps/runner/lib/oto/agent/registration_client.dart:9), [registration_client.dart](/config/workspace/oto/apps/runner/lib/oto/agent/registration_client.dart:10).

### 분할 판단

multi-plan의 마지막 subtask다. `03+01,02_registration_wiring`는 predecessor `01_agent_port`, `02+01_command_adapter`의 완료가 필요하다. 두 predecessor의 active/archive `complete.log`를 구현 시작 전에 확인해야 한다.

### 범위 결정 근거

이 subtask는 production wiring, compatibility 유지, final smoke/evidence만 다룬다. command catalog 자체의 sample/data model 정책은 변경하지 않는다.

### 빌드 등급

`local-G06`: agent와 command 경계를 함께 연결하고 server smoke까지 확인하지만, schema/storage/concurrency 변경은 없다.

## 의존 관계 및 구현 순서

`01_agent_port`와 `02+01_command_adapter` complete가 선행 조건이다. 둘 중 하나라도 없으면 구현을 시작하지 않는다.

## 구현 체크리스트

- [ ] 선행 `01_agent_port`, `02+01_command_adapter` complete evidence를 확인한다.
- [ ] `OtoServerRegistrationClient`에서 command domain imports와 `_defaultCommandTypes()`를 제거한다.
- [ ] default production 생성 경로에서 command adapter provider를 주입하되 기존 `commandTypes:` call site 호환을 유지한다.
- [ ] provider default path request build test와 HTTP payload test를 추가/갱신한다.
- [ ] `rg --sort path "package:oto/oto/commands/" apps/runner/lib/oto/agent` 결과가 의도된 예외 없이 비어 있는지 확인한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [REFACTOR-1] Registration Wiring

문제: [registration_client.dart](/config/workspace/oto/apps/runner/lib/oto/agent/registration_client.dart:169)의 request build가 [registration_client.dart](/config/workspace/oto/apps/runner/lib/oto/agent/registration_client.dart:246)의 command catalog helper에 fallback한다.

해결 방법: `OtoServerRegistrationClient`는 `RunnerCapabilityProvider`만 소비한다. `agent_runner.dart`의 기본 client 생성은 command adapter provider를 import해서 전달한다.

```dart
DefaultAgentRunner({
  RegistrationClient? client,
  ...
}) : _client = client ?? OtoServerRegistrationClient(
       capabilityProvider: const CommandCatalogRunnerCapabilityProvider(),
     );
```

수정 파일 및 체크리스트:

- [ ] `apps/runner/lib/oto/agent/registration_client.dart` import 제거 및 provider 소비
- [ ] `apps/runner/lib/oto/agent/agent_runner.dart` default provider wiring
- [ ] `apps/runner/test/oto_agent_registration_test.dart` default/provider tests

테스트 작성: 작성. default provider path와 explicit `commandTypes:` compatibility를 모두 검증한다.

중간 검증:

```bash
rg --sort path "package:oto/oto/commands/" apps/runner/lib/oto/agent
cd apps/runner && dart test test/oto_agent_registration_test.dart
```

## 수정 파일 요약

| 파일 | 항목 |
|------|------|
| `apps/runner/lib/oto/agent/registration_client.dart` | REFACTOR-1 |
| `apps/runner/lib/oto/agent/agent_runner.dart` | REFACTOR-1 |
| `apps/runner/test/oto_agent_registration_test.dart` | REFACTOR-1 |

## 최종 검증

```bash
cd apps/runner && dart analyze
cd apps/runner && dart test test/oto_agent_registration_test.dart test/oto_command_catalog_test.dart test/oto_server_connection_smoke_test.dart
rg --sort path "package:oto/oto/commands/" apps/runner/lib/oto/agent
```

`rg` 명령은 출력이 없어야 통과다.

모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
