<!-- task=m-scheduled-market-data-refresh/05+04_backtest_readiness plan=3 tag=REVIEW_REVIEW_REVIEW_cloud-G08 -->

# Code Review Reference - REVIEW_REVIEW_REVIEW_cloud-G08

> **[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 selected Milestone `구현 잠금 > 결정 필요` item, fill `사용자 리뷰 요청` with evidence and stop with active files in place; code-review decides whether to write `USER_REVIEW.md`. Environment/secret/service setup, generic scope conflicts, loop exhaustion, and evidence gaps that a follow-up agent can close are normal follow-up issues, not user-review blockers by themselves.
> Do not ask the user directly, present choices in chat, or call `request_user_input` during implementation; record only the linked Milestone lock decision in `사용자 리뷰 요청` and stop for code-review.
> Finalization (`코드리뷰 결과`, log rename, `complete.log`, archive moves, `코드리뷰 전용 체크리스트`) is review-agent-only, even after compaction/resume.
> Follow the ownership table at the bottom of this file for which sections you own.

## 개요

date=2026-06-22
task=m-scheduled-market-data-refresh/05+04_backtest_readiness, plan=3, tag=REVIEW_REVIEW_REVIEW_cloud-G08

## Roadmap Targets

- `agent-roadmap/phase/backtest-loop/milestones/scheduled-market-data-refresh.md`
  - Handoff epic: `[backtest-readiness] remote runner`

## Archive Evidence Snapshot

- Current archived plan: `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/plan_cloud_G08_2.log`
- Current archived review: `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/code_review_cloud_G08_2.log`
- Verdict: FAIL
- Required summary:
  - `code_review_cloud_G08_2.log`: `[REVIEW_REVIEW_cloud-G08-1]` remained unchecked and the recorded remote verification shows `ALT_OPERATOR_API_URL` unset, `scheduler_refresh_status` not run, and `scheduled_backtest_readiness` not run.
  - `agent-roadmap/sdd/backtest-loop/scheduled-market-data-refresh/SDD.md`: S05 requires remote runner smoke after scheduler tick and exit code `0` evidence for `[backtest-readiness]`.
- Affected files:
  - `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/CODE_REVIEW_cloud_G08.md`
  - No source file change is expected unless the remote run exposes a real code defect.
- Verification evidence from archived review and reviewer rerun:
  - `go test -count=1 ./apps/cli/internal/operator -run 'Test(ScheduledBacktestReadiness|RunScenarioRefreshStatus|HeadlessValidationHandoff|ExpectedOutputFixtures)'` passed locally in the implementation log.
  - Reviewer rerun of the same local guard passed: `ok git.toki-labs.com/toki/alt/apps/cli/internal/operator 0.017s`.
  - `ALT_OPERATOR_API_URL` was unset in the review environment, so replacement S05 remote evidence was not collected.
- Roadmap carryover:
  - Do not modify `agent-roadmap/**` in this follow-up. PASS completion metadata will carry `backtest-readiness`; runtime owns roadmap updates.
  - USER_REVIEW gate is not triggered by missing endpoint/secret/service setup or missing evidence; record the blocker and leave the task failing if S05 evidence still cannot be collected.
- Allowed narrow archive reread:
  - `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/plan_cloud_G08_2.log`
  - `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/code_review_cloud_G08_2.log`

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

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

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

1. 판정을 append한다.
2. `CODE_REVIEW_cloud_G08.md` -> `code_review_cloud_G08_N.log`, `PLAN_cloud_G08.md` -> `plan_cloud_G08_M.log`로 아카이브한다.
3. PASS이면 `complete.log` 작성 후 active task 디렉터리를 `agent-task/archive/YYYY/MM/m-scheduled-market-data-refresh/05+04_backtest_readiness/`로 이동한다. WARN/FAIL이면 user-review gate를 확인한 뒤 다음 active plan/review 파일 또는 `USER_REVIEW.md`를 작성한다.
4. PASS이면 완료 이벤트 메타데이터를 보고한다. roadmap 수정이나 `update-roadmap` 직접 호출은 하지 않는다.
5. 적용 가능한 `코드리뷰 전용 체크리스트` 항목을 최종 `.log` 위치에서 체크한 뒤 보고한다.

---

## 구현 항목별 완료 여부

| 항목 | 완료 여부 |
|------|---------|
| [REVIEW_REVIEW_REVIEW_cloud-G08-1] scheduler-enabled remote runner에서 S05 `scheduler_refresh_status`와 `scheduled_backtest_readiness`를 exit code `0`으로 실행하고 sanitized transcript/artifact evidence를 기록한다. | [ ] |

## 구현 체크리스트

- [ ] [REVIEW_REVIEW_REVIEW_cloud-G08-1] scheduler-enabled remote runner에서 S05 `scheduler_refresh_status`와 `scheduled_backtest_readiness`를 exit code `0`으로 실행하고 sanitized transcript/artifact evidence를 기록한다.
- [x] 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이 `agent-task/**/*.md`와 `agent-task/**/*.log`를 unignore하고 `agent-roadmap/current.md`를 ignore하는지 확인한다.
- [ ] PASS이면 `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준으로 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
- [ ] PASS이면 active task 디렉터리 `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/`를 `agent-task/archive/YYYY/MM/m-scheduled-market-data-refresh/05+04_backtest_readiness/`로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
- [ ] PASS이고 task group이 `m-scheduled-market-data-refresh`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, roadmap 수정이나 `update-roadmap` 직접 호출을 하지 않는다.
- [ ] PASS split 작업이면 이동 후 빈 active parent `agent-task/m-scheduled-market-data-refresh/`를 제거하거나, 남은 sibling/file이 있어 유지했다고 확인한다.
- [x] WARN/FAIL이고 user-review gate가 트리거되지 않았으면 다음 active `PLAN_cloud_G08.md`와 `CODE_REVIEW_cloud_G08.md`를 작성하고 `complete.log`를 작성하지 않는다.
- [ ] USER_REVIEW이면 `agent-ops/skills/common/code-review/templates/user-review-template.md` 기준으로 `USER_REVIEW.md`를 작성하고 active `PLAN-*.md`, `CODE_REVIEW-*.md`, `complete.log`를 남기지 않는다.
- [ ] USER_REVIEW가 연결된 Milestone 결정으로 완료/PASS 해소되면 `USER_REVIEW.md`를 해소 상태로 갱신하고 `complete.log`를 작성한 뒤 task directory를 archive로 이동한다.

## 계획 대비 변경 사항

- `ALT_OPERATOR_API_URL` 설정 여부는 raw 값 노출 없이 길이만 출력하는 방식(`len=${#VAR}` / `SET|UNSET`)으로 확인했다. plan의 "raw 값을 출력하지 않는 방식으로 확인한다" 요구를 지키기 위함이다.
- 계약된 remote 명령(`scheduler_refresh_status`, `scheduled_backtest_readiness`)은 plan에 명시된 그대로 실행했다. endpoint가 없어 결과는 실패지만, 명령을 임의 대체하지 않고 실제 stdout/exit code를 `검증 결과`에 남겼다.

## 주요 설계 결정

- S05 remote PASS evidence는 이번 루프에서 수집하지 못했고, 이는 코드 결함이 아니라 scheduler-enabled operator API runtime 미가용 때문이다. 따라서 source 변경 없이 차단 사유만 기록한다.
- 차단 근거: (1) local·remote(`ssh toki@toki-labs.com`) 셸 모두 `ALT_OPERATOR_API_URL`이 UNSET이고, git-untracked private rule(`agent-ops/rules/private/testing-env.md`)에도 scheduler-enabled operator API endpoint 정의가 없다. (2) 원격 host에서 operator API/worker socket 포트 `18030`/`18031`은 닫혀 있다(열린 `3000`/`13000`은 code-server 표면으로 operator control plane이 아님). (3) 두 scenario는 seed `import_daily_bars` 없이 scheduler tick으로 import된 bar(`imported_bar_count >= 1`)를 요구하므로, DB·Redis·scheduler 설정·KIS provider 데이터 import·실제 tick까지 갖춘 전체 런타임 stand-up이 선행되어야 한다.
- 이 차단은 외부 환경/서비스 준비 미비에 해당하며, 선택 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 막는 경우가 아니다. plan 지시(line 53)에 따라 `[REVIEW_REVIEW_REVIEW_cloud-G08-1]`을 체크하지 않고 USER_REVIEW도 요청하지 않는다. local guard는 통과하므로 회귀는 없다.

## 사용자 리뷰 요청

_기본값은 `없음`이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 이 섹션은 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 `검증 결과`, `계획 대비 변경 사항`, 또는 code-review의 일반 follow-up plan으로 처리한다._

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

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

- S05 evidence가 scheduler tick 이후 remote runner smoke임을 확인한다.
- `scheduler_refresh_status` transcript가 `scheduler_status=success`, `imported_bar_count >= 1`, summary exit code `0`을 직접 보여주는지 확인한다.
- `scheduled_backtest_readiness` transcript가 seed import 없이 backtest result evidence와 process exit code `0`을 직접 보여주는지 확인한다.
- raw endpoint, token, credential, 개인 host 원문이 기록되지 않았는지 확인한다.

## 검증 결과

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

필수 규칙:
- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
- 사용자 리뷰 요청으로 명령을 끝까지 실행하지 못했다면 `사용자 리뷰 요청`에 실행한 명령, 실제 출력, 미실행 명령의 사유를 기록한다.
- mobile/UI hang, timeout, 또는 2분 무진행은 blind retry를 중단하고 focused rerun 명령과 screenshot/window/UI-tree evidence path를 남기며, 불가능하면 정확한 사유를 남긴다.

### REVIEW_REVIEW_REVIEW_cloud-G08-1 local guard
```bash
$ go test -count=1 ./apps/cli/internal/operator -run 'Test(ScheduledBacktestReadiness|RunScenarioRefreshStatus|HeadlessValidationHandoff|ExpectedOutputFixtures)'
ok  	git.toki-labs.com/toki/alt/apps/cli/internal/operator	0.015s
```
PASS — local headless guard 통과(회귀 없음).

### REVIEW_REVIEW_REVIEW_cloud-G08-1 endpoint 가용성 확인 (raw 값 미출력)
```bash
# local
$ if [ -n "$ALT_OPERATOR_API_URL" ]; then echo "SET (len=${#ALT_OPERATOR_API_URL})"; else echo "UNSET"; fi
UNSET

# remote runner
$ ssh -o BatchMode=yes toki@toki-labs.com 'echo SSH_OK; [ -n "$ALT_OPERATOR_API_URL" ] && echo REMOTE:SET || echo REMOTE:UNSET; [ -d ~/agent-work/alt ] && echo CHECKOUT:present || echo CHECKOUT:missing'
SSH_OK
REMOTE_ALT_OPERATOR_API_URL: UNSET
CHECKOUT: present

# remote operator/worker socket 포트
$ ssh toki@toki-labs.com 'for p in 18030 18031 3000 13000; do nc -z -w3 127.0.0.1 $p && echo "port $p: OPEN" || echo "port $p: closed"; done'
port 18030: closed
port 18031: closed
port 3000: OPEN
port 13000: OPEN
```
operator control plane(`18030`)/worker(`18031`) socket 미기동. `3000`/`13000`은 code-server 표면으로 operator runtime 아님. private rule에도 scheduler-enabled operator API endpoint 정의 없음.

### REVIEW_REVIEW_REVIEW_cloud-G08-1 remote Step 1
```bash
$ go run ./apps/cli/cmd/alt operator scenario run --file apps/cli/testdata/operator/scheduler_refresh_status.yaml --api-url "$ALT_OPERATOR_API_URL" --output jsonl
api url is required: --api-url <ws-url>
exit status 2  (process exit=1)
```
미실행 사유: `ALT_OPERATOR_API_URL` UNSET + scheduler-enabled operator API runtime 미가용. exit code `0` 미충족.

### REVIEW_REVIEW_REVIEW_cloud-G08-1 remote Step 2
```bash
$ go run ./apps/cli/cmd/alt operator scenario run --file apps/cli/testdata/operator/scheduled_backtest_readiness.yaml --api-url "$ALT_OPERATOR_API_URL" --output jsonl
api url is required: --api-url <ws-url>
exit status 2  (process exit=1)
```
미실행 사유: Step 1과 동일. 추가로 이 scenario는 seed import 없이 scheduler tick 기반 `imported_bar_count >= 1`을 요구하므로, 실제 scheduler tick이 수행된 worker+API 런타임이 선행되어야 한다. 현재 미가용.

> S05 remote PASS evidence는 endpoint/runtime 미가용으로 이번 루프에서 수집 불가. `[REVIEW_REVIEW_REVIEW_cloud-G08-1]` 미체크 유지. 외부 환경/서비스 준비 미비 차단이며 USER_REVIEW 비대상(plan line 31, 53).

---

> **[IMPLEMENTING AGENT - BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, and verification output?**
> If anything is blank, go back and fill it in before saving this file.
> Leave review-agent-only sections unchanged.

## Sections and Ownership

| 섹션 | 소유자 | 설명 |
|------|--------|------|
| 헤더 주석, 개요(date/task/plan/tag), 리뷰 에이전트 지시 | 스텁 생성 시 고정 | 구현 에이전트가 수정하거나 실행하지 않음 |
| Roadmap Targets | follow-up plan에서 복사해 스텁 생성 시 고정 | 구현 에이전트가 수정하지 않음; PASS 시 code-review가 `complete.log`의 `Roadmap Completion`으로 복사 |
| Archive Evidence Snapshot | follow-up plan에서 복사해 스텁 생성 시 고정 | 구현 에이전트의 기본 이전 루프 컨텍스트; 추가 확인이 필요할 때 여기에 명시된 archive 파일만 좁게 읽음 |
| 구현 항목별 완료 여부 | 구현 에이전트 | `[ ]` -> `[x]` 체크만 수행 |
| 구현 체크리스트 | 구현 에이전트 | `[ ]` -> `[x]` 체크만 수행; 마지막 체크박스는 저장 전 필수 |
| 코드리뷰 전용 체크리스트 | Review agent only | Implementing agent must not modify or check this section |
| 계획 대비 변경 사항, 주요 설계 결정 | 구현 에이전트 | placeholder 텍스트를 실제 내용으로 교체 |
| 사용자 리뷰 요청 | 구현 에이전트 | 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채움 |
| 리뷰어를 위한 체크포인트 | 스텁 생성 시 고정 | 계획에서 추출한 리뷰 포인트 |
| 검증 결과 | 구현 에이전트 | 실행 출력만 구현 에이전트가 채움 |
| 코드리뷰 결과 | 리뷰 에이전트 | 스텁에 포함하지 않음 |

## 코드리뷰 결과

- 종합 판정: FAIL
- 차원별 평가:
  - correctness: Pass
  - completeness: Fail
  - test coverage: Pass
  - API contract: Pass
  - code quality: Pass
  - implementation deviation: Pass
  - verification trust: Fail
  - spec conformance: Fail
- 발견된 문제:
  - Required: `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/CODE_REVIEW_cloud_G08.md:65`와 `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/CODE_REVIEW_cloud_G08.md:69`의 S05 remote evidence 항목이 미완료로 남아 있으며, 같은 파일 `agent-task/m-scheduled-market-data-refresh/05+04_backtest_readiness/CODE_REVIEW_cloud_G08.md:160`-`174`도 `ALT_OPERATOR_API_URL` 미설정 및 scheduler-enabled worker/API runtime 미가용 때문에 `scheduler_refresh_status`와 `scheduled_backtest_readiness`가 exit code `0`으로 실행되지 않았음을 기록한다. SDD S05는 `agent-roadmap/sdd/backtest-loop/scheduled-market-data-refresh/SDD.md:89` 및 `agent-roadmap/sdd/backtest-loop/scheduled-market-data-refresh/SDD.md:99`에서 scheduler tick 이후 remote runner smoke와 exit code `0` evidence를 `[backtest-readiness]` 완료 근거로 요구한다. 수정: scheduler-enabled remote worker/API runtime에서 `scheduler_refresh_status` success 및 `scheduled_backtest_readiness` exit code `0` sanitized transcript/artifact를 수집하고, 그 증거가 있을 때만 해당 항목을 완료로 표시한다.
- 다음 단계: FAIL follow-up plan/review를 작성한다. USER_REVIEW gate는 트리거하지 않는다.
