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

# Code Review Reference - TEST

> **[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation.**
> The task is NOT complete until every implementation-owned section below is filled in.
> Complete the `구현 체크리스트`; the final checklist item is mandatory before saving.
> Fill implementation-owned sections, then stop with active files in place and report ready for review.
> If implementation is blocked by a user-only decision, user-owned external environment prerequisite, or scope conflict, fill `사용자 리뷰 요청` with evidence and stop with active files in place; code-review decides whether to write `USER_REVIEW.md`.
> Do not ask the user directly, present choices in chat, or call `request_user_input` during implementation.
> Finalization (`코드리뷰 결과`, log rename, `complete.log`, archive moves, `코드리뷰 전용 체크리스트`) is review-agent-only.

## 개요

date=2026-06-16
task=m-backtest-scenario-automation/05+04_runtime_startup, plan=0, tag=TEST

## 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

## 이 파일을 읽는 리뷰 에이전트에게

> **[REVIEW AGENT ONLY]** 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다.

각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
리뷰 완료는 아래 순서까지 끝난 상태를 의미합니다.

1. 판정을 append한다.
2. active review/plan을 `.log`로 아카이브한다.
3. PASS이면 `complete.log` 작성 후 active task 디렉터리를 `agent-task/archive/YYYY/MM/m-backtest-scenario-automation/05+04_runtime_startup/`로 이동한다.
4. PASS이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고 roadmap 수정은 직접 하지 않는다.

---

## 구현 항목별 완료 여부

| 항목 | 완료 여부 |
|------|---------|
| [TEST-1] Worker/API startup and worker availability smoke | [ ] |

## 구현 체크리스트

- [ ] `04_remote_env_sync` complete.log가 있는지 확인하고 경로를 기록한다.
- [ ] 원격 runner에서 migration 이후 worker를 SOPS env wrapper와 DB/Redis env로 기동하고 `worker ready` 로그의 store-backed surface flags를 sanitized로 기록한다.
- [ ] 원격 runner에서 API를 `ALT_WORKER_SOCKET_URL`과 bind host/port를 명시해 기동하고 worker 연결 상태를 기록한다.
- [ ] `api_connection_smoke.yaml`이 `worker-available` capability를 요구하는 상태에서 원격 API socket을 대상으로 exit code 0을 기록한다.
- [ ] `backtest_result_summary.yaml` 또는 동등한 import/backtest scenario의 import step이 typed success로 반환되는지 원격 JSONL evidence를 기록한다.
- [ ] 필요하면 `apps/cli/testdata/operator/headless_validation.md`에 raw 값 없는 runtime startup handoff 절차를 보강한다.
- [ ] `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

## 코드리뷰 전용 체크리스트

> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
> 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.

- [x] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
- [x] 판정과 `차원별 평가`, Required/Suggested/Nit 분류가 서로 일치한다.
- [x] active `CODE_REVIEW-*-G??.md`를 `code_review_cloud_G08_N.log`로 아카이브한다.
- [x] active `PLAN-*-G??.md`를 `plan_cloud_G08_M.log`로 아카이브한다.
- [x] `.gitignore`의 Agent-Ops 관리 block이 task artifacts를 unignore하는지 확인한다.
- [ ] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
- [ ] PASS이면 active task 디렉터리를 archive로 이동한다.
- [ ] PASS이면 roadmap 수정이나 `update-roadmap` 직접 호출을 하지 않는다.
- [x] WARN/FAIL이면 다음 active plan/review 또는 `USER_REVIEW.md`를 규칙대로 작성한다.

## 계획 대비 변경 사항

_구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다._

## 주요 설계 결정

_구현 에이전트가 주요 설계 결정 사항을 기록한다._

## 사용자 리뷰 요청

_기본값은 `없음`이다. 구현 중 사용자 결정, 사용자 소유 외부 환경/secret/서비스 준비, 또는 계획 범위 변경 없이는 안전하게 진행할 수 없으면 아래 항목을 실제 내용으로 교체하고, 구현을 중단한 뒤 active 파일을 그대로 둔 채 리뷰를 요청한다. 구현 에이전트는 사용자에게 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 후속 에이전트가 명령 재실행이나 산출물 수집으로 해소할 수 있는 검증 증거 공백만으로는 사용자 리뷰 요청을 작성하지 않는다._

- 상태: 없음
- 사유 유형: 없음
- 결정 필요: 없음
- 차단 근거: 없음
- 실행한 검증/명령: 없음
- 자동 후속 불가 이유: 없음
- 재개 조건: 없음

## 리뷰어를 위한 체크포인트

- 04 predecessor complete.log가 확인됐는지 본다.
- worker/API가 같은 원격 checkout에서 순서대로 떠 있고 API smoke가 `worker-available`을 통과했는지 본다.
- raw secret/env 값이 task artifact에 남지 않았는지 확인한다.

## 검증 결과

_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._

### TEST-1 중간 검증

```bash
$ go test -count=1 ./apps/cli/internal/operator ./services/api/internal/socket ./services/worker/...
```

### 최종 검증

```bash
$ git diff --check
$ go test -count=1 ./apps/cli/internal/operator ./services/api/internal/socket ./services/worker/...
$ test -f agent-task/m-backtest-scenario-automation/04_remote_env_sync/complete.log || find agent-task/archive -path '*/m-backtest-scenario-automation/04_remote_env_sync/complete.log' -print -quit
$ 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\"; 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; cd \"$ALT_REMOTE_ALT_ROOT/apps/cli\"; go run ./cmd/alt operator scenario run --file testdata/operator/backtest_result_summary.yaml --api-url \"ws://127.0.0.1:18030/socket\" --output jsonl"
```

---

> **[IMPLEMENTING AGENT — BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, and verification output?**

## 코드리뷰 결과

- 종합 판정: FAIL
- 차원별 평가:
  - correctness: Fail
  - completeness: Fail
  - test coverage: Fail
  - API contract: Fail
  - code quality: Pass
  - plan deviation: Fail
  - verification trust: Fail
- 발견된 문제:
  - Required: `CODE_REVIEW-cloud-G08.md:43` 및 `CODE_REVIEW-cloud-G08.md:47`-`53`의 구현 항목/체크리스트가 전부 미완료 상태이고, `CODE_REVIEW-cloud-G08.md:70`-`76` 및 `CODE_REVIEW-cloud-G08.md:96`-`117`이 placeholder/명령 목록만 남아 있어 구현 결과와 실제 stdout/stderr가 없다. plan의 필수 완료 조건을 판단할 수 없으므로 구현 에이전트가 실제 runtime startup 검증을 수행하고 review stub을 채워야 한다.
  - Required: `PLAN-cloud-G08.md:75`-`81`이 요구하는 선행 `04_remote_env_sync` `complete.log`가 active 경로와 archive 경로 어디에도 없다. 현재는 `agent-task/m-backtest-scenario-automation/04_remote_env_sync/PLAN-cloud-G07.md` 및 `CODE_REVIEW-cloud-G07.md` active follow-up만 존재하므로, 이 split은 선행 작업 PASS 이후에만 구현을 시작해야 한다.
  - Required: `CODE_REVIEW-cloud-G08.md:108`-`117`의 최종 검증 명령은 실제 출력 없이 명령만 기록되어 있고, worker/API process startup, `worker-available` smoke, import typed success evidence가 없다. 원격 process orchestration 과제 특성상 실제 stdout/stderr, log tail, cleanup evidence 없이는 verification trust를 충족하지 못한다.
- 다음 단계: FAIL 후속 plan/review를 생성한다. USER_REVIEW gate는 트리거하지 않는다.
