<!-- task=m-backtest-scenario-automation/05+04_runtime_startup plan=2 tag=REVIEW_REVIEW_TEST -->

# Worker Availability Smoke Follow-up Plan

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

이 plan은 `code_review_cloud_G08_1.log`의 Required 이슈만 해결한다. 구현 완료 후 `CODE_REVIEW-cloud-G08.md`의 구현 에이전트 소유 섹션을 실제 결과와 검증 stdout/stderr로 채우고 active 파일을 유지한 채 리뷰 준비를 보고한다. 종결, log rename, `complete.log`, archive 이동은 code-review 전용이다. 구현 중 사용자 결정, 사용자 소유 외부 환경/secret/서비스 준비, 범위 충돌 없이는 진행할 수 없으면 review stub의 `사용자 리뷰 요청`에 정확한 근거를 남기고 멈춘다. 구현 에이전트는 사용자에게 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하거나 `USER_REVIEW.md`를 만들지 않는다.

## Roadmap Targets

- Milestone: `agent-roadmap/phase/backtest-loop/milestones/backtest-scenario-automation.md`
- Task ids:
  - `runtime-startup`: 원격 worker/API 실행 순서를 `migration -> worker -> API -> CLI scenario`로 정리하고 worker availability 및 import typed success를 검증한다.
- Completion mode: check-on-pass

## Archive Evidence Snapshot

- Archived plan: `agent-task/m-backtest-scenario-automation/05+04_runtime_startup/plan_cloud_G08_1.log`
- Archived review: `agent-task/m-backtest-scenario-automation/05+04_runtime_startup/code_review_cloud_G08_1.log`
- Verdict: FAIL
- Required summary: `api_connection_smoke.yaml` did not require `worker-available`, so the recorded remote JSONL only proved API hello success and did not prove API-to-worker connectivity.
- Affected files: `apps/cli/testdata/operator/api_connection_smoke.yaml`; active review stub evidence.
- Existing evidence retained: `04_remote_env_sync` PASS complete log exists at `agent-task/archive/2026/06/m-backtest-scenario-automation/04_remote_env_sync/complete.log`; remote migration completed; worker ready log showed store-backed surfaces; API started on the configured socket; `backtest_result_summary.yaml` recorded import step typed success before the known `result_poll_remote` failure.
- Verification evidence gap: rerun API smoke after the fixture requires `worker-available`, and record actual stdout/stderr plus cleanup evidence.
- Narrow reread allowed: if prior context is needed, read only `agent-task/m-backtest-scenario-automation/05+04_runtime_startup/plan_cloud_G08_1.log`, `agent-task/m-backtest-scenario-automation/05+04_runtime_startup/code_review_cloud_G08_1.log`, and `agent-task/archive/2026/06/m-backtest-scenario-automation/04_remote_env_sync/complete.log`.
- Roadmap carryover: same Roadmap Targets as this plan; do not call `update-roadmap`.

## 범위 결정 근거

이 후속은 `runtime-startup` 완료 조건 중 누락된 worker availability smoke만 보완한다. `backtest_result_summary.yaml`의 `get_backtest_result not_found`는 이미 `07+05_result_poll_remote` 범위이며, 이 후속에서 result polling을 고치거나 완료 처리하지 않는다. 이전 루프의 import typed success evidence는 유지하고, API smoke가 실제 worker 연결을 요구하도록 fixture와 원격 evidence를 맞춘다.

## 구현 체크리스트

- [ ] `apps/cli/testdata/operator/api_connection_smoke.yaml`의 expected capabilities에 `worker-available`을 추가한다.
- [ ] local checkout에서 `go test -count=1 ./apps/cli/internal/operator ./services/api/internal/socket`를 실행하고 실제 stdout/stderr를 기록한다.
- [ ] `rg --sort path -n "worker-available|worker-unavailable|capabilities:" apps/cli/testdata/operator/api_connection_smoke.yaml services/api/internal/socket`로 fixture와 API capability surface를 확인한다.
- [ ] 원격 runner에서 `migration -> worker -> API -> api_connection_smoke.yaml` 순서로 실행하고, updated smoke가 exit code 0인 실제 JSONL/stdout을 기록한다.
- [ ] 원격 worker/API process cleanup을 실행하고 결과를 기록한다.
- [ ] `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [REVIEW_REVIEW_TEST-1] Worker-available capability smoke

#### 문제

`code_review_cloud_G08_1.log`의 Required 이슈는 `CODE_REVIEW-cloud-G08.md:52`가 `api_connection_smoke.yaml`의 `worker-available` expectation을 전제로 체크됐지만 실제 `apps/cli/testdata/operator/api_connection_smoke.yaml`에는 `hello`, `request-response`만 있었다는 점이다. 따라서 원격 smoke exit code 0은 API hello만 증명하고 worker 연결을 증명하지 못했다.

#### 해결 방법

`api_connection_smoke.yaml`의 `expect.capabilities`에 `worker-available`을 추가한다. local operator/API socket tests로 fixture 계약과 capability handling을 확인한 뒤, 원격 runner에서 worker와 API를 다시 기동하고 같은 fixture를 실행해 exit code 0 evidence를 남긴다. 실패하면 API/worker log tail을 sanitized로 기록하고 review stub의 검증 결과에 그대로 남긴다.

#### 수정 파일 및 체크리스트

- [ ] `apps/cli/testdata/operator/api_connection_smoke.yaml` - `worker-available` capability expectation 추가
- [ ] `CODE_REVIEW-cloud-G08.md` - local/remote verification stdout/stderr 기록

#### 테스트 작성

새 test 파일은 기본적으로 작성하지 않는다. 기존 operator fixture tests와 API socket tests가 capability expectation과 advertised capabilities를 검증한다. fixture 변경으로 local test가 실패하면 기대 fixture 또는 테스트 helper를 함께 정합화하고 이유를 `계획 대비 변경 사항`에 기록한다.

#### 중간 검증

```bash
go test -count=1 ./apps/cli/internal/operator ./services/api/internal/socket
rg --sort path -n "worker-available|worker-unavailable|capabilities:" apps/cli/testdata/operator/api_connection_smoke.yaml services/api/internal/socket
```

기대 결과: Go tests exit code 0. `rg` output에 `api_connection_smoke.yaml`의 `worker-available` expectation과 API handler/test의 worker capability surface가 함께 보인다.

## 수정 파일 요약

| 파일 | 항목 |
|------|------|
| `apps/cli/testdata/operator/api_connection_smoke.yaml` | REVIEW_REVIEW_TEST-1 |
| active review stub | REVIEW_REVIEW_TEST-1 evidence 기록 |

## 최종 검증

```bash
git diff --check
go test -count=1 ./apps/cli/internal/operator ./services/api/internal/socket
rg --sort path -n "worker-available|worker-unavailable|capabilities:" apps/cli/testdata/operator/api_connection_smoke.yaml services/api/internal/socket
ssh "$ALT_REMOTE_SSH" "set -euo pipefail; cd \"$ALT_REMOTE_ALT_ROOT/services/worker\"; go run ./cmd/alt-worker-migrate"
ssh "$ALT_REMOTE_SSH" "set -euo pipefail; cd \"$ALT_REMOTE_ALT_ROOT\"; KIS_ACTIVE_ENV=paper SOPS_AGE_KEY_FILE=~/.config/sops/age/keys.txt bin/kis-sops-env sh -lc 'go run ./services/worker/cmd/alt-worker' > /tmp/alt-worker.log 2>&1 & echo \$! > /tmp/alt-worker.pid"
ssh "$ALT_REMOTE_SSH" "set -euo pipefail; cd \"$ALT_REMOTE_ALT_ROOT\"; ALT_WORKER_SOCKET_URL=\"ws://127.0.0.1:18031/socket\" go run ./services/api/cmd/alt-api > /tmp/alt-api.log 2>&1 & echo \$! > /tmp/alt-api.pid"
ssh "$ALT_REMOTE_SSH" "set -euo pipefail; cd \"$ALT_REMOTE_ALT_ROOT/apps/cli\"; go run ./cmd/alt operator scenario run --file testdata/operator/api_connection_smoke.yaml --api-url \"ws://127.0.0.1:18030/socket\" --output jsonl"
ssh "$ALT_REMOTE_SSH" "set -euo pipefail; test ! -f /tmp/alt-api.pid || kill \"$(cat /tmp/alt-api.pid)\"; test ! -f /tmp/alt-worker.pid || kill \"$(cat /tmp/alt-worker.pid)\"; rm -f /tmp/alt-api.pid /tmp/alt-worker.pid"
```

기대 결과: local commands exit code 0. Remote `api_connection_smoke.yaml` exits 0 with the updated `worker-available` expectation. Worker/API startup and cleanup output are recorded without raw secret values.
