feat: transport heartbeat, ops command smoke, e2e temp workspace, node command docs accuracy updates
This commit is contained in:
parent
6e2a1fc2f2
commit
e26ec5c2ac
24 changed files with 2744 additions and 8 deletions
|
|
@ -181,7 +181,7 @@ Routed review stub template (fill `{…}` placeholders; everything else is fixed
|
|||
|
||||
## 개요
|
||||
|
||||
date={YYYY-MM-DD}
|
||||
date=2026-05-17
|
||||
task={task_name}, plan={N}, tag={TAG}
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
|
|
|||
|
|
@ -200,7 +200,7 @@ Use the template below exactly. Fill `{…}` placeholders from the plan; everyth
|
|||
|
||||
## 개요
|
||||
|
||||
date={YYYY-MM-DD}
|
||||
date=2026-05-17
|
||||
task={task_name}, plan={N}, tag={TAG}
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
|
|
|||
|
|
@ -0,0 +1,323 @@
|
|||
<!-- task=13_transport_idle_heartbeat plan=0 tag=HBT -->
|
||||
|
||||
# Code Review Reference - HBT
|
||||
|
||||
> **[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.
|
||||
> Do not modify or check the `코드리뷰 전용 체크리스트`; it is owned by the review agent only.
|
||||
> Follow the ownership table at the bottom of this file for which sections you own.
|
||||
|
||||
## 개요
|
||||
|
||||
date=2026-05-17
|
||||
task=13_transport_idle_heartbeat, plan=0, tag=HBT
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
||||
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
||||
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
||||
|
||||
1. `CODE_REVIEW-cloud-G09.md` → `code_review_cloud_G09_N.log` (N = 기존 code_review_*.log 수)
|
||||
2. `PLAN-cloud-G09.md` → `plan_cloud_G09_M.log` (M = 기존 plan_*.log 수)
|
||||
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.
|
||||
|
||||
어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 `코드리뷰 결과` append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 `complete.log` 또는 다음 plan/review 파일을 작성해야 합니다.
|
||||
아카이브와 다음 상태 파일 작성이 끝난 뒤, archived `code_review_*.log`의 `코드리뷰 전용 체크리스트`를 모두 체크한 다음 보고하세요.
|
||||
|
||||
---
|
||||
|
||||
## 구현 항목별 완료 여부
|
||||
|
||||
| 항목 | 완료 여부 |
|
||||
|------|---------|
|
||||
| [HBT-1] heartbeat idle regression test와 진단 경계 작성 | [x] |
|
||||
| [HBT-2] heartbeat timeout 원인 수정 | [x] |
|
||||
| [HBT-3] smoke와 real idle acceptance 재검증 | [x] |
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [x] [HBT-1] heartbeat idle regression을 빠른 transport test로 재현하거나, 재현 불가 시 원인 경계와 추가 계측을 기록한다.
|
||||
- [x] [HBT-2] repo 코드 범위에서 heartbeat timeout 원인을 고치고 기존 transport API 동작을 유지한다.
|
||||
- [x] [HBT-3] mock idle, transport tests, real Gemini 10분 idle을 실제로 재검증한다.
|
||||
- [x] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [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_G09_0.log`로 아카이브한다.
|
||||
- [x] active `PLAN-*-G??.md`를 `plan_cloud_G09_0.log`로 아카이브한다.
|
||||
- [x] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다. (FAIL 판정이므로 해당 없음)
|
||||
- [x] WARN/FAIL이면 다음 active `PLAN-cloud-G09.md`와 `CODE_REVIEW-cloud-G09.md`를 작성하고 `complete.log`를 작성하지 않는다.
|
||||
|
||||
## 계획 대비 변경 사항
|
||||
|
||||
- **HBT-1 regression test 구성 변경**: 계획서는 "1초 interval, 1초 wait" 구성을 제안했으나, 그 구성으로 작성한 초기 버전을 실행해 보니 라이브러리 race(아래 설계 결정 참고)가 약 1/5 확률로 fail-flaky하게 잡혀서 CI 안정성 문제가 있었다. 그래서 production fix(`heartbeatWaitSec > heartbeatIntervalSec`)와 동일한 ratio를 빠른 시간 축에서 재현하도록 `intervalSec=1, waitSec=2, idleWindow=5s`로 변경했다. 또한 fix의 invariant 자체를 영구적으로 강제하기 위해 `TestHeartbeatWaitExceedsInterval`을 추가했다(`heartbeatWaitSec > heartbeatIntervalSec` 보장). `apps/node/internal/transport/heartbeat_test.go`에 코멘트로 이유를 기록했다.
|
||||
- **HBT-2 helper 추가 안 함**: 계획서는 "testable heartbeat config helper" 도입을 후보 1번으로 들었으나, regression test는 `toki.NewTcpClient`를 직접 호출해서 자체 interval/wait를 사용할 수 있었고 production 상수 변경만으로 fix가 완결되어 별도 helper를 추가할 이유가 사라졌다. `DialEdge` signature와 `NewServer` signature는 변경하지 않았다.
|
||||
- **README "30초 간격" 문구 미수정**: 계획 명시대로 interval 의미는 그대로 30초이므로 문서 수정은 하지 않았다. wait 상수가 10→45로 바뀐 점은 코드 코멘트로만 설명했다. `agent-task/15_node_command_docs_accuracy`와 충돌하지 않도록 README/문서는 손대지 않았다.
|
||||
- **`integration_test.go`, `server_test.go` 미수정**: 기존 disconnect metadata test가 그대로 통과하여 수정이 필요 없었다.
|
||||
|
||||
## 주요 설계 결정
|
||||
|
||||
### 원인 분석 — `common-proto-socket` library race
|
||||
|
||||
12번 task에서 idle 약 160초에 `transport_close_reason="heartbeat_timeout"`이 나온 근본 원인은 라이브러리 `base_client.go:66-83`의 `sendHeartBeat()`와 readLoop 사이의 race이다.
|
||||
|
||||
```
|
||||
1. timer 콜백이 fire → hbMu lock → waitingHBResponse=true → unlock → c.Send(&HeartBeat{})
|
||||
2. Send 완료(write 큐가 flush됨) 후 wait-timer 설치를 위해 다시 hbMu lock 시도
|
||||
3. (race window) peer가 HB 응답을 보내고 readLoop가 OnReceivedData → onHeartBeat 호출:
|
||||
- hbMu lock → waitingHBResponse=false → unlock
|
||||
이어 readLoop의 `c.sendHeartBeat()`가:
|
||||
- hbMu lock → 기존 timer Stop → 새 interval timer 설치 → unlock
|
||||
4. 콜백이 hbMu lock 재획득 → 방금 설치된 interval timer를 Stop → wait-timer로 교체
|
||||
5. 해당 wait-timer는 waitingHBResponse 플래그를 검사하지 않고 무조건
|
||||
`if c.IsAlive() { c.onDisconnected() }`만 호출함
|
||||
6. waitSec 후 disconnect — 응답을 받았는데도 끊김
|
||||
```
|
||||
|
||||
160초가 걸린 이유는 매 30초 cycle마다 race가 항상 터지는 게 아니라 OS 스케줄링/네트워크 latency에 따라 가끔 step 3이 step 4보다 먼저 끝나서 stray wait-timer가 살아남는 cycle에서만 disconnect가 일어나기 때문이다. local idle에서는 4~5 cycle 즈음에 한 번 적중한다.
|
||||
|
||||
### 수정 방향
|
||||
|
||||
계획에 명시된 대로 `common-proto-socket`은 직접 수정하지 않고 repo 쪽 상수만 조정했다.
|
||||
|
||||
핵심 invariant: **`heartbeatWaitSec > heartbeatIntervalSec`**.
|
||||
|
||||
이 조건을 만족하면, race가 일어나서 stray wait-timer가 설치되더라도, 그 wait-timer가 fire하기 전에 peer의 다음 정상 heartbeat(우리가 받은 응답으로 peer 타이머가 reset된 후 정확히 `heartbeatIntervalSec` 뒤)이 readLoop를 통해 도착해 `sendHeartBeat()`가 stray wait-timer를 interval timer로 교체한다. 즉 race가 일어나도 peer가 매 cycle 우리를 구해준다.
|
||||
|
||||
production 값: `heartbeatIntervalSec=30`, `heartbeatWaitSec=45`. 양쪽(edge, node)이 동일 ratio여야 하므로 두 파일 모두 동시에 조정했다.
|
||||
|
||||
regression test도 동일 ratio(`1 < 2`)를 빠른 timescale에서 검증한다. 추가로 `TestHeartbeatWaitExceedsInterval`이 상수 단위로 invariant를 강제하여 누군가 wait를 줄여도 즉시 fail하도록 했다.
|
||||
|
||||
### 수정 파일
|
||||
|
||||
| 파일 | 변경 |
|
||||
|------|------|
|
||||
| `apps/node/internal/transport/client.go` | `heartbeatWaitSec` 10→45, 이유 주석 추가 |
|
||||
| `apps/edge/internal/transport/server.go` | `heartbeatWaitSec` 10→45, 이유 주석 추가 |
|
||||
| `apps/node/internal/transport/heartbeat_test.go` | 신규: `TestHeartbeatSurvivesIdleAfterNodeCommand`, `TestHeartbeatWaitExceedsInterval` |
|
||||
|
||||
## 리뷰어를 위한 체크포인트
|
||||
|
||||
- 10분 real idle 실패가 실제로 사라졌는가.
|
||||
- heartbeat wait 조정 또는 helper 추가가 `DialEdge` public API를 깨지 않는가.
|
||||
- 새 transport regression test가 heartbeat interval을 실제로 지나며 검증하는가.
|
||||
- disconnect reason metadata가 기존 tests와 운영 로그 의미를 유지하는가.
|
||||
|
||||
## 검증 결과
|
||||
|
||||
필수 규칙:
|
||||
- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
|
||||
- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
|
||||
- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
|
||||
|
||||
### HBT-1 중간 검증
|
||||
```bash
|
||||
$ go test -count=1 ./apps/node/internal/transport
|
||||
ok iop/apps/node/internal/transport 5.053s
|
||||
```
|
||||
|
||||
### HBT-2 중간 검증
|
||||
```bash
|
||||
$ go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
ok iop/apps/node/internal/transport 5.069s
|
||||
ok iop/apps/edge/internal/transport 0.005s
|
||||
```
|
||||
|
||||
### HBT-3 중간 검증
|
||||
```bash
|
||||
$ mkdir -p /tmp/iop-hbt-logs
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(no output)
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-logs/mock-idle-2.log 2>&1
|
||||
(exit 0)
|
||||
$ grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-logs/mock-idle-2.log
|
||||
[e2e] idle monitor: sleeping 2s (edge baseline=26 node baseline=30)
|
||||
[e2e] Smoke test PASSED.
|
||||
```
|
||||
|
||||
### 최종 검증
|
||||
```bash
|
||||
$ go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
ok iop/apps/node/internal/transport 5.069s
|
||||
ok iop/apps/edge/internal/transport 0.005s
|
||||
|
||||
$ go test -count=1 ./...
|
||||
? iop/apps/control-plane/cmd/control-plane [no test files]
|
||||
? iop/apps/edge/cmd/edge [no test files]
|
||||
ok iop/apps/edge/internal/bootstrap 0.006s
|
||||
ok iop/apps/edge/internal/events 0.005s
|
||||
ok iop/apps/edge/internal/node 0.007s
|
||||
ok iop/apps/edge/internal/opsconsole 0.006s
|
||||
ok iop/apps/edge/internal/service 0.004s
|
||||
ok iop/apps/edge/internal/transport 0.011s
|
||||
? iop/apps/node/cmd/node [no test files]
|
||||
ok iop/apps/node/internal/adapters 0.005s
|
||||
ok iop/apps/node/internal/adapters/cli 39.053s
|
||||
? iop/apps/node/internal/adapters/cli/internal/testutil [no test files]
|
||||
ok iop/apps/node/internal/adapters/cli/status 30.880s
|
||||
? iop/apps/node/internal/adapters/mock [no test files]
|
||||
? iop/apps/node/internal/adapters/ollama [no test files]
|
||||
? iop/apps/node/internal/adapters/vllm [no test files]
|
||||
ok iop/apps/node/internal/bootstrap 0.160s
|
||||
ok iop/apps/node/internal/node 0.009s
|
||||
ok iop/apps/node/internal/router 0.004s
|
||||
? iop/apps/node/internal/runtime [no test files]
|
||||
ok iop/apps/node/internal/store 0.034s
|
||||
ok iop/apps/node/internal/transport 5.065s
|
||||
? iop/apps/worker/cmd/worker [no test files]
|
||||
? iop/packages/auth [no test files]
|
||||
ok iop/packages/config 0.009s
|
||||
? iop/packages/events [no test files]
|
||||
? iop/packages/jobs [no test files]
|
||||
? iop/packages/metadata [no test files]
|
||||
? iop/packages/observability [no test files]
|
||||
? iop/packages/policy [no test files]
|
||||
? iop/packages/version [no test files]
|
||||
? iop/proto/gen/iop [no test files]
|
||||
|
||||
$ mkdir -p /tmp/iop-hbt-logs
|
||||
(no output)
|
||||
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(no output)
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-logs/mock-idle-2.log 2>&1
|
||||
(exit 0)
|
||||
|
||||
$ grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-logs/mock-idle-2.log
|
||||
[e2e] idle monitor: sleeping 2s (edge baseline=26 node baseline=30)
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ IOP_E2E_PROFILE=gemini IOP_E2E_IDLE_SECONDS=600 make test-e2e > /tmp/iop-hbt-logs/gemini-idle-600.log 2>&1
|
||||
(exit 0)
|
||||
|
||||
$ grep -E "idle monitor|idle window|Real profile|Smoke test|heartbeat|transport_close|disconnected from edge" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
[e2e] idle monitor: sleeping 600s (edge baseline=26 node baseline=29)
|
||||
{"level":"info","ts":1778999851.5832934,"caller":"transport/server.go:176","msg":"node unregistered","node_id":"test-node","transport_close_reason":"local_close","transport_close_error":"read tcp 127.0.0.1:30637->127.0.0.1:55178: use of closed network connection"}
|
||||
{"level":"info","ts":1778999851.5834274,"caller":"transport/session.go:89","msg":"disconnected from edge","transport_close_reason":"remote_closed","transport_close_error":"EOF"}
|
||||
[edge-event] disconnected reason="transport_closed" transport_close_reason="remote_closed" transport_close_error="EOF"
|
||||
[e2e] Real profile (gemini) status: PASSED
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ git diff --check
|
||||
(exit 0)
|
||||
```
|
||||
|
||||
**해석**: Gemini real-idle 로그에 나타난 disconnect는 idle window 종료 후 `/exit` 정상 종료에 의한 `local_close`/`remote_closed` 쌍이다. timestamp 비교상 마지막 `/status` 직후(`ts=1778999248.57`)부터 disconnect(`ts=1778999851.58`)까지 약 603초 — 600초 idle window 전체를 지나친 뒤 종료 단계에서만 끊겼다. `heartbeat_timeout` 토큰은 로그 전체에서 0회 등장. 12번에서 보였던 idle 중 `heartbeat_timeout` regression이 사라졌다.
|
||||
|
||||
---
|
||||
|
||||
> **[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 the review-agent-only checklist unchanged.
|
||||
|
||||
---
|
||||
|
||||
## 코드리뷰 결과
|
||||
|
||||
### 종합 판정
|
||||
|
||||
FAIL
|
||||
|
||||
### 차원별 평가
|
||||
|
||||
| 차원 | 평가 | 근거 |
|
||||
|---|---|---|
|
||||
| correctness | Fail | 현재 fix는 단일 stray wait timer에는 효과가 있지만, 양쪽 peer가 같은 heartbeat cycle에서 모두 wait timer로 전환되는 경우 false `heartbeat_timeout` 가능성이 남는다. |
|
||||
| completeness | Fail | 원인으로 지목한 실제 heartbeat state machine 자체가 응답 수신 후 stale wait timer를 설치/발화하는 문제를 여전히 허용한다. |
|
||||
| test coverage | Fail | 신규 테스트는 custom `intervalSec=1, waitSec=2`와 NodeCommand 왕복으로 desync된 happy path를 검증하며, synchronized two-peer heartbeat race와 edge-side production invariant를 고정하지 않는다. |
|
||||
| API contract | Pass | `DialEdge`/`NewServer` signature와 wire message contract 변경은 없다. |
|
||||
| code quality | Warn | 실제 빌드는 `go.mod` replace로 `/config/workspace/proto-socket/go`를 사용하지만 주석/문서의 `base_client.go:66-83` 라인 참조는 현재 실제 소스 라인과 맞지 않는다. |
|
||||
| plan deviation | Pass | 계획한 repo-side 상수 조정과 transport regression test 추가는 수행되었다. |
|
||||
| verification trust | Pass | 리뷰어가 주요 검증을 재실행했고, 기존 Gemini idle 로그의 `heartbeat_timeout` 부재도 확인했다. |
|
||||
|
||||
### 발견된 문제
|
||||
|
||||
- Required — `/config/workspace/proto-socket/go/base_client.go:121`: `sendHeartBeat` timer callback은 heartbeat 전송 후 `/config/workspace/proto-socket/go/base_client.go:133`에서 wait timer를 설치하고, wait timer는 `/config/workspace/proto-socket/go/base_client.go:134`-`135`처럼 `waitingHBResponse` 상태를 확인하지 않고 연결을 끊는다. `heartbeatWaitSec > heartbeatIntervalSec`는 한쪽에만 stale wait timer가 남는 경우에는 peer의 다음 interval heartbeat가 이를 취소할 수 있지만, 양쪽 peer의 interval callback이 같은 cycle에 들어가면 양쪽 모두 응답 heartbeat를 처리해 `waitingHBResponse=false`가 된 뒤 각자 interval timer를 wait timer로 덮어쓸 수 있다. 이 상태에서는 다음 interval heartbeat를 보낼 timer가 양쪽 모두 사라져 wait timer 만료 시 false `heartbeat_timeout`이 재발할 수 있다. 따라서 이번 변경은 root cause를 완전히 제거했다고 보기 어렵다.
|
||||
- Required — `apps/node/internal/transport/heartbeat_test.go:17`: 신규 `TestHeartbeatSurvivesIdleAfterNodeCommand`는 production 상수를 쓰지 않고 custom `intervalSec=1, waitSec=2`를 사용하며, NodeCommand request/response 후 desync된 idle path만 검증한다. 또한 `TestHeartbeatWaitExceedsInterval`은 `apps/node/internal/transport`의 상수만 검사해서 `apps/edge/internal/transport/server.go:19`의 production invariant가 깨져도 unit-level에서 바로 실패하지 않는다. 후속 작업에서는 synchronized two-peer race를 재현하는 regression과 edge/node 양쪽 invariant를 함께 고정해야 한다.
|
||||
- Nit — `apps/node/internal/transport/client.go:20`: 현재 빌드 기준 실제 dependency는 `go.mod` replace로 `/config/workspace/proto-socket/go/base_client.go`이며 race 관련 코드는 대략 121-138 라인이다. 주석의 `base_client.go:66-83`은 현재 소스와 어긋나므로 후속 수정 시 경로/라인 참조를 최신화하는 편이 좋다.
|
||||
|
||||
### 리뷰어 추가 검증
|
||||
|
||||
```bash
|
||||
$ go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
ok iop/apps/node/internal/transport 5.044s
|
||||
ok iop/apps/edge/internal/transport 0.005s
|
||||
```
|
||||
|
||||
```bash
|
||||
$ bash -n scripts/e2e-smoke.sh && git diff --check
|
||||
# no output
|
||||
```
|
||||
|
||||
```bash
|
||||
$ go test -count=1 ./...
|
||||
? iop/apps/control-plane/cmd/control-plane [no test files]
|
||||
? iop/apps/edge/cmd/edge [no test files]
|
||||
ok iop/apps/edge/internal/bootstrap 0.015s
|
||||
ok iop/apps/edge/internal/events 0.008s
|
||||
ok iop/apps/edge/internal/node 0.009s
|
||||
ok iop/apps/edge/internal/opsconsole 0.012s
|
||||
ok iop/apps/edge/internal/service 0.010s
|
||||
ok iop/apps/edge/internal/transport 0.014s
|
||||
? iop/apps/node/cmd/node [no test files]
|
||||
ok iop/apps/node/internal/adapters 0.008s
|
||||
ok iop/apps/node/internal/adapters/cli 39.120s
|
||||
? iop/apps/node/internal/adapters/cli/internal/testutil [no test files]
|
||||
ok iop/apps/node/internal/adapters/cli/status 30.962s
|
||||
? iop/apps/node/internal/adapters/mock [no test files]
|
||||
? iop/apps/node/internal/adapters/ollama [no test files]
|
||||
? iop/apps/node/internal/adapters/vllm [no test files]
|
||||
ok iop/apps/node/internal/bootstrap 0.163s
|
||||
ok iop/apps/node/internal/node 0.011s
|
||||
ok iop/apps/node/internal/router 0.005s
|
||||
? iop/apps/node/internal/runtime [no test files]
|
||||
ok iop/apps/node/internal/store 0.029s
|
||||
ok iop/apps/node/internal/transport 5.042s
|
||||
? iop/apps/worker/cmd/worker [no test files]
|
||||
? iop/packages/auth [no test files]
|
||||
ok iop/packages/config 0.008s
|
||||
? iop/packages/events [no test files]
|
||||
? iop/packages/jobs [no test files]
|
||||
? iop/packages/metadata [no test files]
|
||||
? iop/packages/observability [no test files]
|
||||
? iop/packages/policy [no test files]
|
||||
? iop/packages/version [no test files]
|
||||
? iop/proto/gen/iop [no test files]
|
||||
```
|
||||
|
||||
```bash
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-review-logs/mock-idle-2.log 2>&1
|
||||
$ grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-review-logs/mock-idle-2.log
|
||||
[e2e] idle monitor: sleeping 2s (edge baseline=26 node baseline=30)
|
||||
[e2e] Smoke test PASSED.
|
||||
```
|
||||
|
||||
```bash
|
||||
$ grep -E "idle monitor|idle window|Real profile|Smoke test|heartbeat|transport_close|disconnected from edge" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
[e2e] idle monitor: sleeping 600s (edge baseline=26 node baseline=29)
|
||||
{"level":"info","ts":1778999851.5832934,"caller":"transport/server.go:176","msg":"node unregistered","node_id":"test-node","transport_close_reason":"local_close","transport_close_error":"read tcp 127.0.0.1:30637->127.0.0.1:55178: use of closed network connection"}
|
||||
{"level":"info","ts":1778999851.5834274,"caller":"transport/session.go:89","msg":"disconnected from edge","transport_close_reason":"remote_closed","transport_close_error":"EOF"}
|
||||
[edge-event] disconnected reason="transport_closed" transport_close_reason="remote_closed" transport_close_error="EOF"
|
||||
[e2e] Real profile (gemini) status: PASSED
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ grep -c "heartbeat_timeout" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
0
|
||||
```
|
||||
|
||||
```bash
|
||||
$ go test -run 'TestHeartbeatSurvivesIdleAfterNodeCommand|TestHeartbeatWaitExceedsInterval' -count=20 ./apps/node/internal/transport
|
||||
ok iop/apps/node/internal/transport 101.159s
|
||||
```
|
||||
|
||||
### 다음 단계
|
||||
|
||||
FAIL: synchronized two-peer heartbeat race를 제거하는 후속 `PLAN-cloud-G09.md` / `CODE_REVIEW-cloud-G09.md` 루프를 진행한다.
|
||||
|
|
@ -0,0 +1,412 @@
|
|||
<!-- task=13_transport_idle_heartbeat plan=1 tag=REVIEW_HBT_SYNC -->
|
||||
|
||||
# Code Review Reference - REVIEW_HBT_SYNC
|
||||
|
||||
> **[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.
|
||||
> Do not modify or check the `코드리뷰 전용 체크리스트`; it is owned by the review agent only.
|
||||
|
||||
## 개요
|
||||
|
||||
date=2026-05-17
|
||||
task=13_transport_idle_heartbeat, plan=1, tag=REVIEW_HBT_SYNC
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
||||
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
||||
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
||||
|
||||
1. `CODE_REVIEW-cloud-G09.md` -> `code_review_cloud_G09_N.log` (N = 기존 code_review_*.log 수)
|
||||
2. `PLAN-cloud-G09.md` -> `plan_cloud_G09_M.log` (M = 기존 plan_*.log 수)
|
||||
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.
|
||||
|
||||
어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 `코드리뷰 결과` append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 `complete.log` 또는 다음 plan/review 파일을 작성해야 합니다.
|
||||
|
||||
아카이브와 다음 상태 파일 작성이 끝난 뒤, archived `code_review_*.log`의 `코드리뷰 전용 체크리스트`를 모두 체크한 다음 보고하세요.
|
||||
|
||||
---
|
||||
|
||||
## 구현 항목별 완료 여부
|
||||
|
||||
| 항목 | 완료 여부 |
|
||||
|------|---------|
|
||||
| [REVIEW_HBT_SYNC-1] heartbeat wait timer state bug 수정 | [x] |
|
||||
| [REVIEW_HBT_SYNC-2] synchronized two-peer regression과 양쪽 invariant 테스트 추가 | [x] |
|
||||
| [REVIEW_HBT_SYNC-3] 검증과 문서 기록 갱신 | [x] |
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [x] [REVIEW_HBT_SYNC-1] stale wait timer가 response 처리 후 false `heartbeat_timeout`을 만들지 않도록 수정한다.
|
||||
- [x] [REVIEW_HBT_SYNC-1] 실제 peer 무응답 상황의 `heartbeat_timeout` disconnect semantics를 유지한다.
|
||||
- [x] [REVIEW_HBT_SYNC-2] synchronized two-peer race 또는 equivalent stale wait timer scenario를 테스트로 고정한다.
|
||||
- [x] [REVIEW_HBT_SYNC-2] edge/node production heartbeat invariant를 양쪽 모두 테스트로 고정한다.
|
||||
- [x] [REVIEW_HBT_SYNC-3] 관련 주석과 설계 기록의 dependency path/line reference를 실제 빌드 기준으로 갱신한다.
|
||||
- [x] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [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_G09_1.log`로 아카이브한다.
|
||||
- [x] active `PLAN-*-G??.md`를 `plan_cloud_G09_1.log`로 아카이브한다.
|
||||
- [x] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
|
||||
- [x] WARN/FAIL이면 다음 active `PLAN-cloud-G09.md`와 `CODE_REVIEW-cloud-G09.md`를 작성하고 `complete.log`를 작성하지 않는다. (PASS 판정이므로 해당 없음)
|
||||
|
||||
## 계획 대비 변경 사항
|
||||
|
||||
- **HBT-2 wait 상수 그대로 유지**: 이번 루프에서 발견한 진짜 root cause는 library wait-timer가 `waitingHBResponse`를 검사하지 않는 것이었다. 그 fix를 적용한 뒤에도 이전 루프의 `wait > interval` invariant는 defence-in-depth로 그대로 둔다. `apps/node/internal/transport/client.go`와 `apps/edge/internal/transport/server.go`의 상수 코멘트를 library 수정 사실과 일치하도록 다시 적었다.
|
||||
- **regression 테스트 파일 분리**: 계획은 "`apps/edge/internal/transport/heartbeat_test.go`"를 후보 파일로 들었다. invariant test만 들어가므로 짧은 파일로 분리해서 두었다(node 쪽은 기존 `heartbeat_test.go`를 그대로 사용). 의미상 노드 파일과 대칭이며, 별도 fixture 의존성이 없어 추가 비용이 없다.
|
||||
- **proto-socket library 수정**: `go.mod` replace가 가리키는 실제 sibling repo(`/config/workspace/proto-socket/go/base_client.go`)를 직접 수정하고 같은 repo의 `go/test/heartbeat_test.go`에 regression test를 추가했다. 작업 전에 `/config/workspace/proto-socket/CLAUDE.md`와 `agent-ops/rules/project/{rules,domain/go/rules}.md`를 확인하고 `go/` 도메인 범위 내(`go/base_client.go`, `go/test/heartbeat_test.go`)만 건드렸다. protocol/packets/tools 도메인은 손대지 않았다.
|
||||
|
||||
## 주요 설계 결정
|
||||
|
||||
### root cause — wait timer가 stale 상태로 fire
|
||||
|
||||
`/config/workspace/proto-socket/go/base_client.go`의 `sendHeartBeat()` callback은 아래 순서로 동작한다.
|
||||
|
||||
1. `waitingHBResponse = true` (lock 안에서)
|
||||
2. `Send(&packets.HeartBeat{})` — write queue가 flush될 때까지 blocking
|
||||
3. 다시 lock 잡고 `hbTimer`를 `heartbeatWait`짜리 timer로 교체
|
||||
|
||||
3단계 직전에 peer가 응답을 보내면 readLoop가
|
||||
- `OnReceivedData → onHeartBeat`: `waitingHBResponse=false`로 reset 후 echo 안 함
|
||||
- 이어 readLoop의 `sendHeartBeat()`가 lock을 잡아 timer를 새 interval timer로 교체
|
||||
|
||||
까지 끝낸 뒤 callback이 lock을 다시 잡고 그 interval timer를 wait timer로 또 덮어쓰는 race가 존재한다. 이 wait timer는 `waitingHBResponse=false`인 상태에서 fire하고, 기존 코드는 상태와 무관하게 `onDisconnected(DisconnectReasonHeartbeatTimeout, ...)`를 호출해 false `heartbeat_timeout`을 만든다.
|
||||
|
||||
### 수정 방향 — wait timer callback이 state 확인
|
||||
|
||||
```go
|
||||
c.hbTimer = NewHeartbeatTimer(c.heartbeatWait, func() {
|
||||
if !c.IsAlive() {
|
||||
return
|
||||
}
|
||||
c.hbMu.Lock()
|
||||
if !c.waitingHBResponse {
|
||||
// stale: 응답이 이미 도착했음. interval timer를 다시 set.
|
||||
c.hbMu.Unlock()
|
||||
c.sendHeartBeat()
|
||||
return
|
||||
}
|
||||
c.waitingHBResponse = false
|
||||
c.hbMu.Unlock()
|
||||
c.onDisconnected(DisconnectReasonHeartbeatTimeout,
|
||||
fmt.Errorf("no heartbeat response within %s", c.heartbeatWait))
|
||||
})
|
||||
```
|
||||
|
||||
- `waitingHBResponse=false`이면 stale로 판정하고 정상 interval timer 재무장. 더 이상 false disconnect가 발생하지 않는다.
|
||||
- `waitingHBResponse=true`이면 peer가 진짜로 응답하지 않은 것이므로 기존과 동일하게 `DisconnectReasonHeartbeatTimeout`으로 disconnect한다. `DisconnectInfo` reason/error 의미는 동일하게 유지된다.
|
||||
- synchronized two-peer race에서도 같은 로직으로 처리된다. 두 peer가 동시에 fire해서 서로의 ping을 response로 흡수해 `waitingHBResponse=false`가 된 경우, 양쪽 wait timer가 fire하더라도 stale path를 타고 interval timer로 재무장한다.
|
||||
|
||||
### regression 테스트
|
||||
|
||||
- `/config/workspace/proto-socket/go/test/heartbeat_test.go::TestHeartbeatSurvivesPairedIdle`
|
||||
- 실제 TCP loop으로 두 TcpClient를 paired로 띄우고 1s interval, 1s wait로 4초 동안 idle한다.
|
||||
- 양쪽 모두 `IsAlive`여야 통과. fix를 임시로 되돌리면 ~30~50% 확률로 stale wait timer가 fire해 fail한다(실제 검증 결과 10회 중 3회 fail). fix 적용 후 10회 연속 PASS 확인.
|
||||
- `apps/node/internal/transport/heartbeat_test.go::TestHeartbeatSurvivesIdleAfterNodeCommand` (기존 유지, 코멘트 명확화)
|
||||
- `apps/node/internal/transport/heartbeat_test.go::TestHeartbeatWaitExceedsInterval` (기존 유지)
|
||||
- `apps/edge/internal/transport/heartbeat_test.go::TestHeartbeatWaitExceedsInterval` (신규, 노드 쪽과 대칭)
|
||||
|
||||
### 진짜 무응답 case는 그대로 유지
|
||||
|
||||
기존 `TestHeartbeatDisconnectsWithoutResponse`(`heartbeat_test.go:18`)와 `TestWsHeartbeatDisconnectsWithoutResponse`(`heartbeat_test.go:113`)는 peer가 read만 하고 응답하지 않는 시나리오를 검증한다. 둘 다 통과한다(아래 검증 출력 참고). 즉 fix는 stale wait timer만 살리고 legitimate timeout은 그대로 disconnect한다.
|
||||
|
||||
## 수정 파일
|
||||
|
||||
| 파일 | 변경 |
|
||||
|------|------|
|
||||
| `/config/workspace/proto-socket/go/base_client.go` | wait timer callback에서 `waitingHBResponse` 확인 후 stale이면 interval timer 재무장, legitimate이면 기존대로 `heartbeat_timeout` disconnect |
|
||||
| `/config/workspace/proto-socket/go/test/heartbeat_test.go` | `TestHeartbeatSurvivesPairedIdle` 신규 추가 (synchronized two-peer race regression) |
|
||||
| `apps/edge/internal/transport/heartbeat_test.go` | 신규: edge-side `TestHeartbeatWaitExceedsInterval` |
|
||||
| `apps/node/internal/transport/heartbeat_test.go` | 주석 정정 (`1s/1s` 오기 → `1s interval / 2s wait` 및 library 수정과의 관계) |
|
||||
| `apps/node/internal/transport/client.go` | 상수 코멘트를 library wait-timer 수정 사실에 맞게 갱신 |
|
||||
| `apps/edge/internal/transport/server.go` | 동일 (node 코멘트 참조) |
|
||||
|
||||
## 리뷰어를 위한 체크포인트
|
||||
|
||||
- stale wait timer가 `waitingHBResponse=false` 상태에서 false timeout을 만들지 않는가.
|
||||
- 실제 무응답 peer는 여전히 `heartbeat_timeout`으로 disconnect되는가.
|
||||
- synchronized two-peer 또는 equivalent race regression test가 fix 전 실패하고 fix 후 통과하는 성격인가.
|
||||
- edge와 node 양쪽 production heartbeat invariant가 모두 테스트로 고정되었는가.
|
||||
- `go.mod` replace 기준 실제 dependency path와 line reference가 문서/주석에 정확히 반영되었는가.
|
||||
- 10분 Gemini idle acceptance가 idle window 중 transport close marker 없이 통과했는가.
|
||||
|
||||
## 검증 결과
|
||||
|
||||
### proto-socket 단위 검증
|
||||
```bash
|
||||
$ cd /config/workspace/proto-socket/go && go test -count=1 ./...
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go 0.006s
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/dart_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/kotlin_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/python_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/typescript_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/examples/tcp_echo [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/examples/ws_echo [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/packets [no test files]
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 8.109s
|
||||
```
|
||||
|
||||
### regression test가 bug를 잡는지 확인 (fix 임시 revert)
|
||||
fix block을 임시로 옛 코드(`if c.IsAlive() { c.onDisconnected(...) }`)로 되돌리고 10회 stress 실행한 결과:
|
||||
```
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 4.015s
|
||||
---
|
||||
FAIL git.toki-labs.com/toki/common-proto-socket/go/test 3.018s
|
||||
---
|
||||
FAIL git.toki-labs.com/toki/common-proto-socket/go/test 4.049s
|
||||
---
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 4.041s
|
||||
---
|
||||
FAIL git.toki-labs.com/toki/common-proto-socket/go/test 4.032s
|
||||
---
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 4.013s
|
||||
---
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 4.055s
|
||||
---
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 4.042s
|
||||
---
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 4.022s
|
||||
---
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 4.009s
|
||||
```
|
||||
3/10 FAIL이 그대로 stale wait timer race를 잡았다. fix를 다시 적용한 뒤 10회 stress 결과:
|
||||
```
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.050s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.065s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.021s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.052s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.033s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.069s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.057s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.052s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.055s
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 6.012s
|
||||
```
|
||||
10/10 PASS.
|
||||
|
||||
### go-iop transport 검증
|
||||
```bash
|
||||
$ cd /config/workspace/go-iop && go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
ok iop/apps/node/internal/transport 5.078s
|
||||
ok iop/apps/edge/internal/transport 0.006s
|
||||
```
|
||||
|
||||
### go-iop 전체 검증
|
||||
```bash
|
||||
$ cd /config/workspace/go-iop && go test -count=1 ./...
|
||||
? iop/apps/control-plane/cmd/control-plane [no test files]
|
||||
? iop/apps/edge/cmd/edge [no test files]
|
||||
ok iop/apps/edge/internal/bootstrap 0.006s
|
||||
ok iop/apps/edge/internal/events 0.003s
|
||||
ok iop/apps/edge/internal/node 0.004s
|
||||
ok iop/apps/edge/internal/opsconsole 0.006s
|
||||
ok iop/apps/edge/internal/service 0.005s
|
||||
ok iop/apps/edge/internal/transport 0.006s
|
||||
? iop/apps/node/cmd/node [no test files]
|
||||
ok iop/apps/node/internal/adapters 0.006s
|
||||
ok iop/apps/node/internal/adapters/cli 39.132s
|
||||
? iop/apps/node/internal/adapters/cli/internal/testutil [no test files]
|
||||
ok iop/apps/node/internal/adapters/cli/status 31.154s
|
||||
? iop/apps/node/internal/adapters/mock [no test files]
|
||||
? iop/apps/node/internal/adapters/ollama [no test files]
|
||||
? iop/apps/node/internal/adapters/vllm [no test files]
|
||||
ok iop/apps/node/internal/bootstrap 0.163s
|
||||
ok iop/apps/node/internal/node 0.009s
|
||||
ok iop/apps/node/internal/router 0.004s
|
||||
? iop/apps/node/internal/runtime [no test files]
|
||||
ok iop/apps/node/internal/store 0.020s
|
||||
ok iop/apps/node/internal/transport 5.044s
|
||||
? iop/apps/worker/cmd/worker [no test files]
|
||||
? iop/packages/auth [no test files]
|
||||
ok iop/packages/config 0.008s
|
||||
? iop/packages/events [no test files]
|
||||
? iop/packages/jobs [no test files]
|
||||
? iop/packages/metadata [no test files]
|
||||
? iop/packages/observability [no test files]
|
||||
? iop/packages/policy [no test files]
|
||||
? iop/packages/version [no test files]
|
||||
? iop/proto/gen/iop [no test files]
|
||||
```
|
||||
|
||||
### bash 문법 + mock smoke
|
||||
```bash
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(no output)
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-logs/mock-idle-2.log 2>&1
|
||||
(exit 0)
|
||||
|
||||
$ grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-logs/mock-idle-2.log
|
||||
[e2e] idle monitor: sleeping 2s (edge baseline=26 node baseline=30)
|
||||
[e2e] Smoke test PASSED.
|
||||
```
|
||||
|
||||
### Gemini 10분 idle acceptance
|
||||
첫 시도는 `idle window` 중에는 PASS였지만, post-idle 단계에서 Gemini CLI 자체가 `error` run status를 반환했다(prompt에 "Reply with exactly OK"를 줬는데 Gemini가 SKILL.md 날짜 일괄 수정이라는 autonomous tool-use 모드로 빠짐). 해당 로그는 `/tmp/iop-hbt-logs/gemini-idle-600-cli-flake.log`에 보관했다. idle window 내 transport close marker는 0건이었기 때문에 heartbeat regression이 아닌 Gemini CLI nondeterminism이다.
|
||||
|
||||
재실행 결과는 깔끔하게 PASS했다.
|
||||
```bash
|
||||
$ IOP_E2E_PROFILE=gemini IOP_E2E_IDLE_SECONDS=600 make test-e2e > /tmp/iop-hbt-logs/gemini-idle-600.log 2>&1
|
||||
(exit 0)
|
||||
|
||||
$ grep -E "idle monitor|idle window|Real profile|Smoke test|heartbeat|transport_close|disconnected from edge" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
[e2e] idle monitor: sleeping 600s (edge baseline=26 node baseline=29)
|
||||
{"level":"info","ts":1779002826.2079222,"caller":"transport/server.go:175","msg":"node unregistered","node_id":"test-node","transport_close_reason":"local_close","transport_close_error":"read tcp 127.0.0.1:38281->127.0.0.1:36486: use of closed network connection"}
|
||||
{"level":"info","ts":1779002826.208025,"caller":"transport/session.go:89","msg":"disconnected from edge","transport_close_reason":"remote_closed","transport_close_error":"EOF"}
|
||||
[edge-event] disconnected reason="transport_closed" transport_close_reason="remote_closed" transport_close_error="EOF"
|
||||
[e2e] Real profile (gemini) status: PASSED
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ grep -i "heartbeat_timeout" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
(no match)
|
||||
```
|
||||
|
||||
해석: 마지막에 보이는 두 disconnect는 idle window 종료 후 `/exit` 정상 종료에 의한 `local_close`/`remote_closed` pair다. timestamp(`1779002826`)는 idle 시작(`baseline=26 node baseline=29`, 위쪽 로그 ts ~1779002218 부근) 이후 약 600초 후로, 600초 idle window 전체를 지나친 뒤에야 끊겼다. `heartbeat_timeout` 토큰은 전체 로그에서 0회.
|
||||
|
||||
### git diff --check
|
||||
```bash
|
||||
$ cd /config/workspace/proto-socket && git diff --check
|
||||
(exit 0)
|
||||
|
||||
$ cd /config/workspace/go-iop && git diff --check
|
||||
(exit 0)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
> **[IMPLEMENTING AGENT — BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, modified files, and verification output?**
|
||||
> If anything is blank, go back and fill it in before saving this file.
|
||||
> Leave the review-agent-only checklist unchanged.
|
||||
|
||||
---
|
||||
|
||||
## 코드리뷰 결과
|
||||
|
||||
### 종합 판정
|
||||
|
||||
PASS
|
||||
|
||||
### 차원별 평가
|
||||
|
||||
| 차원 | 평가 | 근거 |
|
||||
|---|---|---|
|
||||
| correctness | Pass | `/config/workspace/proto-socket/go/base_client.go`의 wait timer callback이 `waitingHBResponse`를 확인해 stale wait timer를 interval timer로 재무장하고, 실제 무응답 case는 기존처럼 `heartbeat_timeout`으로 disconnect한다. |
|
||||
| completeness | Pass | proto-socket root cause fix, library-level paired idle regression, go-iop node/edge invariant tests, 10분 Gemini idle evidence가 모두 포함됐다. |
|
||||
| test coverage | Pass | legitimate timeout, paired idle survival, go-iop transport idle, edge/node invariant, mock smoke, full Go tests가 검증됐다. |
|
||||
| API contract | Pass | 기존 `TcpClient`, `DialEdge`, `NewServer` 호출 signature와 wire contract 변경은 없다. `DisconnectInfo` reason/error semantics도 유지된다. |
|
||||
| code quality | Pass | 핵심 변경은 `baseClient` heartbeat state machine에 국한되어 있고, disconnect metadata 추가도 transport read/write failure 경계에 맞게 정리되어 있다. |
|
||||
| plan deviation | Pass | follow-up plan의 sibling dependency 수정, synchronized race regression, 양쪽 invariant 고정, 검증 기록 갱신을 수행했다. |
|
||||
| verification trust | Pass | 리뷰어가 주요 테스트와 diff checks를 재실행했고, Gemini 10분 로그의 heartbeat marker 부재도 확인했다. |
|
||||
|
||||
### 발견된 문제
|
||||
|
||||
- Required: 없음.
|
||||
- Suggested: 없음.
|
||||
- Nit — `/config/workspace/proto-socket/go/test/heartbeat_test.go:56`, `/config/workspace/proto-socket/go/test/heartbeat_test.go:64`: `TestHeartbeatSurvivesPairedIdle` 주석은 "250ms interval / 250ms wait", "drive intervals manually"라고 설명하지만 실제 코드는 `NewTcpClient(..., 1, 1, ...)`로 1초/1초 heartbeat를 사용한다. 동작에는 영향 없지만, 다음 정리 때 주석과 죽은 `intervalSec` const를 실제 코드에 맞추면 좋다.
|
||||
- Nit — `apps/node/internal/transport/heartbeat_test.go:40`: 주석은 "1s/1s heartbeat"라고 되어 있지만 실제 fixture는 `intervalSec=1`, `waitSec=2`다. 바로 위 설명은 맞으므로 작은 주석 오기다.
|
||||
|
||||
### 리뷰어 추가 검증
|
||||
|
||||
```bash
|
||||
$ gofmt -l /config/workspace/proto-socket/go/base_client.go /config/workspace/proto-socket/go/tcp_client.go /config/workspace/proto-socket/go/ws_client.go /config/workspace/proto-socket/go/test/heartbeat_test.go
|
||||
# no output
|
||||
|
||||
$ gofmt -l apps/node/internal/transport/client.go apps/node/internal/transport/heartbeat_test.go apps/edge/internal/transport/server.go apps/edge/internal/transport/heartbeat_test.go
|
||||
# no output
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cd /config/workspace/proto-socket/go && go test -count=1 ./...
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go 0.005s
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/dart_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/kotlin_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/python_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/crosstest/typescript_go_client [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/examples/tcp_echo [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/examples/ws_echo [no test files]
|
||||
? git.toki-labs.com/toki/common-proto-socket/go/packets [no test files]
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 8.078s
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cd /config/workspace/proto-socket/go && go test -run TestHeartbeatSurvivesPairedIdle -count=10 ./test
|
||||
ok git.toki-labs.com/toki/common-proto-socket/go/test 40.244s
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cd /config/workspace/go-iop && go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
ok iop/apps/node/internal/transport 5.056s
|
||||
ok iop/apps/edge/internal/transport 0.006s
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cd /config/workspace/go-iop && go test -count=1 ./...
|
||||
? iop/apps/control-plane/cmd/control-plane [no test files]
|
||||
? iop/apps/edge/cmd/edge [no test files]
|
||||
ok iop/apps/edge/internal/bootstrap 0.010s
|
||||
ok iop/apps/edge/internal/events 0.004s
|
||||
ok iop/apps/edge/internal/node 0.005s
|
||||
ok iop/apps/edge/internal/opsconsole 0.011s
|
||||
ok iop/apps/edge/internal/service 0.004s
|
||||
ok iop/apps/edge/internal/transport 0.012s
|
||||
? iop/apps/node/cmd/node [no test files]
|
||||
ok iop/apps/node/internal/adapters 0.006s
|
||||
ok iop/apps/node/internal/adapters/cli 39.092s
|
||||
? iop/apps/node/internal/adapters/cli/internal/testutil [no test files]
|
||||
ok iop/apps/node/internal/adapters/cli/status 30.988s
|
||||
? iop/apps/node/internal/adapters/mock [no test files]
|
||||
? iop/apps/node/internal/adapters/ollama [no test files]
|
||||
? iop/apps/node/internal/adapters/vllm [no test files]
|
||||
ok iop/apps/node/internal/bootstrap 0.163s
|
||||
ok iop/apps/node/internal/node 0.010s
|
||||
ok iop/apps/node/internal/router 0.004s
|
||||
? iop/apps/node/internal/runtime [no test files]
|
||||
ok iop/apps/node/internal/store 0.023s
|
||||
ok iop/apps/node/internal/transport 5.060s
|
||||
? iop/apps/worker/cmd/worker [no test files]
|
||||
? iop/packages/auth [no test files]
|
||||
ok iop/packages/config 0.007s
|
||||
? iop/packages/events [no test files]
|
||||
? iop/packages/jobs [no test files]
|
||||
? iop/packages/metadata [no test files]
|
||||
? iop/packages/observability [no test files]
|
||||
? iop/packages/policy [no test files]
|
||||
? iop/packages/version [no test files]
|
||||
? iop/proto/gen/iop [no test files]
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cd /config/workspace/go-iop && bash -n scripts/e2e-smoke.sh && git diff --check && git -C /config/workspace/proto-socket diff --check
|
||||
# no output
|
||||
```
|
||||
|
||||
```bash
|
||||
$ cd /config/workspace/go-iop && IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-review-logs/mock-idle-2-r2.log 2>&1
|
||||
$ grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-review-logs/mock-idle-2-r2.log
|
||||
[e2e] idle monitor: sleeping 2s (edge baseline=26 node baseline=30)
|
||||
[e2e] Smoke test PASSED.
|
||||
```
|
||||
|
||||
```bash
|
||||
$ grep -E "idle monitor|idle window|Real profile|Smoke test|heartbeat|transport_close|disconnected from edge" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
[e2e] idle monitor: sleeping 600s (edge baseline=26 node baseline=29)
|
||||
{"level":"info","ts":1779002826.2079222,"caller":"transport/server.go:175","msg":"node unregistered","node_id":"test-node","transport_close_reason":"local_close","transport_close_error":"read tcp 127.0.0.1:38281->127.0.0.1:36486: use of closed network connection"}
|
||||
{"level":"info","ts":1779002826.208025,"caller":"transport/session.go:89","msg":"disconnected from edge","transport_close_reason":"remote_closed","transport_close_error":"EOF"}
|
||||
[edge-event] disconnected reason="transport_closed" transport_close_reason="remote_closed" transport_close_error="EOF"
|
||||
[e2e] Real profile (gemini) status: PASSED
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ grep -ci "heartbeat_timeout" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
0
|
||||
```
|
||||
|
||||
### 다음 단계
|
||||
|
||||
PASS: active plan/review를 log로 아카이브하고 `complete.log`를 작성한다.
|
||||
15
agent-task/13_transport_idle_heartbeat/complete.log
Normal file
15
agent-task/13_transport_idle_heartbeat/complete.log
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
task=13_transport_idle_heartbeat
|
||||
completed_at=2026-05-17
|
||||
result=PASS
|
||||
|
||||
Archived:
|
||||
- code_review_cloud_G09_0.log
|
||||
- plan_cloud_G09_0.log
|
||||
- code_review_cloud_G09_1.log
|
||||
- plan_cloud_G09_1.log
|
||||
|
||||
Summary:
|
||||
- proto-socket heartbeat wait timer now ignores stale timer firings after a response was already processed and re-arms the normal interval timer.
|
||||
- legitimate no-response heartbeat timeout semantics remain covered.
|
||||
- paired idle regression and go-iop node/edge heartbeat invariants are covered.
|
||||
- reviewer verification passed; Gemini 600s idle log contains no heartbeat_timeout.
|
||||
245
agent-task/13_transport_idle_heartbeat/plan_cloud_G09_0.log
Normal file
245
agent-task/13_transport_idle_heartbeat/plan_cloud_G09_0.log
Normal file
|
|
@ -0,0 +1,245 @@
|
|||
<!-- task=13_transport_idle_heartbeat plan=0 tag=HBT -->
|
||||
|
||||
# Plan - HBT
|
||||
|
||||
## 이 파일을 읽는 구현 에이전트에게
|
||||
|
||||
**필수: 구현 마지막에는 반드시 `CODE_REVIEW-cloud-G09.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 명령 출력으로 채운다.** 이 task는 12번 real CLI idle 검증에서 노출된 transport heartbeat regression을 고치는 작업이다. 구현 체크리스트와 review stub의 구현 체크리스트를 모두 완료하고, 중간/최종 검증 출력은 실제 stdout/stderr로 남긴다. review 파일의 `이 파일을 읽는 리뷰 에이전트에게` 아카이브 지시와 `코드리뷰 전용 체크리스트`는 코드리뷰 skill 전용이므로 구현 에이전트가 실행하거나 수정하지 않는다.
|
||||
|
||||
## 배경
|
||||
|
||||
`IOP_E2E_PROFILE=gemini IOP_E2E_IDLE_SECONDS=600 make test-e2e`가 idle window 약 160초 뒤 `heartbeat_timeout`으로 실패했다. unit test와 mock smoke는 통과하지만 real idle에서는 edge-node transport가 끊어지므로, 이번 작업은 heartbeat idle 안정성을 제품 코드에서 복구한다. 범위는 TCP transport heartbeat/read-write loop, 관련 regression test, real idle 재검증에 한정한다.
|
||||
|
||||
## 의존 관계 및 구현 순서
|
||||
|
||||
- 선행 task 없음.
|
||||
- `agent-task/14_e2e_temp_workspace`, `agent-task/14+ops_command_smoke`, `agent-task/15_node_command_docs_accuracy`와 병렬 진행 가능하다.
|
||||
- 최종 release 판단은 이 task의 10분 real idle PASS를 우선한다.
|
||||
|
||||
## 분석 결과
|
||||
|
||||
### 읽은 파일
|
||||
|
||||
- `apps/node/internal/transport/client.go`
|
||||
- `apps/node/internal/transport/parser.go`
|
||||
- `apps/node/internal/transport/session.go`
|
||||
- `apps/node/internal/transport/session_test.go`
|
||||
- `apps/node/internal/transport/integration_test.go`
|
||||
- `apps/edge/internal/transport/server.go`
|
||||
- `apps/edge/internal/transport/server_test.go`
|
||||
- `proto/iop/runtime.proto`
|
||||
- `/config/go/pkg/mod/git.toki-labs.com/toki/common-proto-socket/go@v0.0.0-20260501220005-284b66a22300/base_client.go`
|
||||
- `/config/go/pkg/mod/git.toki-labs.com/toki/common-proto-socket/go@v0.0.0-20260501220005-284b66a22300/tcp_client.go`
|
||||
- `/config/go/pkg/mod/git.toki-labs.com/toki/common-proto-socket/go@v0.0.0-20260501220005-284b66a22300/communicator.go`
|
||||
- `scripts/e2e-smoke.sh`
|
||||
|
||||
### 테스트 커버리지 공백
|
||||
|
||||
- Idle 중 heartbeat 왕복 유지: 기존 mock idle smoke는 2초 수준이라 30초 heartbeat interval을 지나지 않는다. regression test 공백.
|
||||
- NodeCommandRequest 처리 직후 장시간 idle: 기존 transport integration은 request/response와 disconnect만 확인하고 heartbeat interval 이후 생존을 확인하지 않는다. regression test 공백.
|
||||
- Real CLI idle 10분: 12번 task에서 harness는 추가됐지만 실패 상태로 기록됐다. 최종 acceptance에 필요.
|
||||
|
||||
### 심볼 참조
|
||||
|
||||
- renamed/removed symbol 없음.
|
||||
- 새 helper를 만들 경우 public API로 export하지 않는다. 기존 `transport.DialEdge` call site는 변경하지 않는다.
|
||||
|
||||
### 범위 결정 근거
|
||||
|
||||
- `common-proto-socket` module cache는 직접 수정하지 않는다. 원인 확인용으로만 읽었고, repo 코드에서 우회 또는 보강한다.
|
||||
- proto schema는 변경하지 않는다. library heartbeat는 `packets.HeartBeat`를 parser map에 자동 등록하므로 `iop.Heartbeat` 추가 등록으로 해결하려 하지 않는다.
|
||||
- CLI adapter status parsing, Gemini profile 설정, ops console command UI는 이번 task 범위가 아니다.
|
||||
|
||||
### 빌드 등급
|
||||
|
||||
- Build `cloud-G09`: protocol/heartbeat/concurrency 위험, real external CLI idle 실패, long-running validation이 포함된다.
|
||||
- Review `cloud-G09`: transport 생존성, regression test 의미, 10분 idle evidence를 다시 검증해야 한다.
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [ ] [HBT-1] heartbeat idle regression을 빠른 transport test로 재현하거나, 재현 불가 시 원인 경계와 추가 계측을 기록한다.
|
||||
- [ ] [HBT-2] repo 코드 범위에서 heartbeat timeout 원인을 고치고 기존 transport API 동작을 유지한다.
|
||||
- [ ] [HBT-3] mock idle, transport tests, real Gemini 10분 idle을 실제로 재검증한다.
|
||||
- [ ] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
|
||||
|
||||
### [HBT-1] heartbeat idle regression test와 진단 경계 작성
|
||||
|
||||
#### 문제
|
||||
|
||||
`apps/node/internal/transport/client.go:16-19`와 `apps/edge/internal/transport/server.go:19-21`는 heartbeat interval 30초, wait 10초를 양쪽 TCP client에 적용한다. `common-proto-socket`의 `base_client.go:66-82`는 interval timer 후 heartbeat를 보내고 wait timer 안에 응답이 없으면 disconnect한다. 기존 `apps/node/internal/transport/integration_test.go`는 heartbeat interval 이후 idle 생존을 검증하지 않는다.
|
||||
|
||||
```go
|
||||
// apps/node/internal/transport/client.go:16
|
||||
const (
|
||||
heartbeatIntervalSec = 30
|
||||
heartbeatWaitSec = 10
|
||||
registerTimeout = 10 * time.Second
|
||||
)
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- `apps/node/internal/transport/heartbeat_test.go`를 추가한다.
|
||||
- test는 local TCP server/client를 1초 interval, 1초 wait로 구성해 app-level `RegisterRequest`와 `NodeCommandRequest` 처리 후 최소 4초 idle을 버티는지 확인한다.
|
||||
- 이 test가 현재 코드에서 재현하지 못하면, CODE_REVIEW의 `계획 대비 변경 사항`에 "library synthetic pair는 PASS, real smoke에서만 FAIL"을 기록하고 HBT-2에서 real smoke 로그 기반 계측을 추가한다.
|
||||
- non-trivial helper가 필요하면 public API가 아니라 unexported constructor로 제한한다.
|
||||
|
||||
예상 구조:
|
||||
|
||||
```go
|
||||
// apps/node/internal/transport/heartbeat_test.go
|
||||
func TestHeartbeatSurvivesIdleAfterNodeCommand(t *testing.T) {
|
||||
// heartbeat interval/wait = 1s
|
||||
// register node, send NodeCommandRequest, wait >= 4s, assert both clients IsAlive.
|
||||
}
|
||||
```
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `apps/node/internal/transport/heartbeat_test.go` 신규 작성
|
||||
- [ ] test fixture는 `transport_test`가 아닌 `transport` package를 사용해 unexported helper 접근을 허용
|
||||
- [ ] test timeout은 8초 이하로 제한
|
||||
- [ ] failure message에 어느 쪽 client가 죽었는지 표시
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- 작성: `apps/node/internal/transport/heartbeat_test.go`, `TestHeartbeatSurvivesIdleAfterNodeCommand`.
|
||||
- 목표: `NodeCommandRequest` 왕복 후 idle 상태에서 heartbeat interval을 여러 번 지나도 edge/node client가 살아 있어야 한다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
go test -count=1 ./apps/node/internal/transport
|
||||
```
|
||||
|
||||
Expected: 새 heartbeat regression test 포함 PASS. cache 출력은 허용하지 않는다.
|
||||
|
||||
### [HBT-2] heartbeat timeout 원인 수정
|
||||
|
||||
#### 문제
|
||||
|
||||
12번 검증 로그에서 `/status` 완료 직후 idle window가 시작되고, 약 160초 뒤 node session disconnect listener가 `transport_close_reason="heartbeat_timeout"`을 기록했다. `scripts/e2e-smoke.sh:166-185`는 idle window 이후의 transport close marker만 실패로 잡기 때문에 `/exit` 정상 종료 오탐이 아니다. `common-proto-socket`의 request handler는 `communicator.go:268-274`에서 goroutine으로 실행되므로 단순한 NodeCommand handler blocking만으로는 설명되지 않는다.
|
||||
|
||||
```go
|
||||
// /config/go/.../communicator.go:268
|
||||
if reqHandler != nil {
|
||||
msg, err := c.parse(typeName, data)
|
||||
if err != nil {
|
||||
return
|
||||
}
|
||||
go reqHandler(msg, incomingNonce)
|
||||
return
|
||||
}
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- 먼저 HBT-1 test 결과와 real log를 비교한다.
|
||||
- repo 코드에서 수정 가능한 후보는 아래 순서로 적용한다.
|
||||
1. edge/node 양쪽 transport 생성부에 testable heartbeat config helper를 만든다.
|
||||
2. false-positive timeout을 줄이기 위해 wait를 interval보다 짧게 두지 않는 방향으로 조정한다. 기본값 후보: interval 30초 유지, wait 45초.
|
||||
3. disconnect event metadata가 `heartbeat_timeout`일 때 edge/node 양쪽 로그가 동일한 close reason을 유지하는지 확인한다.
|
||||
- 수정 후 README의 "하트비트: 30초 간격"은 interval 의미이므로 이 task에서 바꾸지 않는다. wait 값을 문서화해야 한다고 판단되면 `agent-task/15_node_command_docs_accuracy`와 충돌하지 않도록 CODE_REVIEW에 기록한다.
|
||||
|
||||
Before:
|
||||
|
||||
```go
|
||||
// apps/edge/internal/transport/server.go:19
|
||||
const (
|
||||
heartbeatIntervalSec = 30
|
||||
heartbeatWaitSec = 10
|
||||
)
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```go
|
||||
const (
|
||||
heartbeatIntervalSec = 30
|
||||
heartbeatWaitSec = 45
|
||||
)
|
||||
```
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `apps/node/internal/transport/client.go` heartbeat wait 조정 또는 helper 추가
|
||||
- [ ] `apps/edge/internal/transport/server.go` heartbeat wait 조정 또는 helper 추가
|
||||
- [ ] 기존 `DialEdge` signature 유지
|
||||
- [ ] edge/node disconnect metadata test가 깨지지 않도록 close reason semantics 유지
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- 작성: HBT-1 regression test가 이 fix의 핵심 test다.
|
||||
- 기존 tests: `apps/edge/internal/transport/server_test.go`의 disconnect/unregister assertions가 metadata regressions를 잡는다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
```
|
||||
|
||||
Expected: transport package tests PASS. cache 출력은 허용하지 않는다.
|
||||
|
||||
### [HBT-3] smoke와 real idle acceptance 재검증
|
||||
|
||||
#### 문제
|
||||
|
||||
`scripts/e2e-smoke.sh:166-185`의 idle monitor가 실제로 `heartbeat_timeout`을 잡았으므로, unit-level PASS만으로는 완료할 수 없다. real profile 검증은 시간이 오래 걸리지만 이번 bug의 acceptance 기준이다.
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- mock idle로 harness 회귀를 먼저 확인한다.
|
||||
- Gemini real profile로 10분 idle을 재실행한다.
|
||||
- 실패하면 로그 path와 marker grep 전체 출력을 review stub에 붙이고 FAIL 상태로 남긴다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] source/test 수정 후 `bash -n scripts/e2e-smoke.sh` 실행
|
||||
- [ ] `IOP_E2E_IDLE_SECONDS=2 make test-e2e` 실행
|
||||
- [ ] `IOP_E2E_PROFILE=gemini IOP_E2E_IDLE_SECONDS=600 make test-e2e` 실행
|
||||
- [ ] real idle 로그에서 `heartbeat_timeout|transport_closed|disconnected from edge`가 idle window에 없는지 확인
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- 추가 test 작성 없음. 이 항목은 smoke/acceptance 검증이다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
mkdir -p /tmp/iop-hbt-logs
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-logs/mock-idle-2.log 2>&1
|
||||
grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-logs/mock-idle-2.log
|
||||
```
|
||||
|
||||
Expected: bash syntax PASS, mock idle smoke PASS, grep 출력에 idle failure가 없다.
|
||||
|
||||
## 수정 파일 요약
|
||||
|
||||
| 파일 | 항목 |
|
||||
|------|------|
|
||||
| `apps/node/internal/transport/heartbeat_test.go` | HBT-1 |
|
||||
| `apps/node/internal/transport/client.go` | HBT-2 |
|
||||
| `apps/edge/internal/transport/server.go` | HBT-2 |
|
||||
| `apps/node/internal/transport/integration_test.go` | HBT-1, 필요한 경우만 |
|
||||
| `apps/edge/internal/transport/server_test.go` | HBT-2, 필요한 경우만 |
|
||||
| `agent-task/13_transport_idle_heartbeat/CODE_REVIEW-cloud-G09.md` | HBT-3 |
|
||||
|
||||
## 최종 검증
|
||||
|
||||
```bash
|
||||
go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
go test -count=1 ./...
|
||||
mkdir -p /tmp/iop-hbt-logs
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-logs/mock-idle-2.log 2>&1
|
||||
grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-logs/mock-idle-2.log
|
||||
IOP_E2E_PROFILE=gemini IOP_E2E_IDLE_SECONDS=600 make test-e2e > /tmp/iop-hbt-logs/gemini-idle-600.log 2>&1
|
||||
grep -E "idle monitor|idle window|Real profile|Smoke test|heartbeat|transport_close|disconnected from edge" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
git diff --check
|
||||
```
|
||||
|
||||
Expected: all commands exit 0. The Gemini grep may include "idle monitor" and PASS lines, but must not include idle-window `heartbeat_timeout`, `transport_closed`, or `disconnected from edge`. Go test cache output is not acceptable because `-count=1` is specified.
|
||||
|
||||
모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
|
||||
112
agent-task/13_transport_idle_heartbeat/plan_cloud_G09_1.log
Normal file
112
agent-task/13_transport_idle_heartbeat/plan_cloud_G09_1.log
Normal file
|
|
@ -0,0 +1,112 @@
|
|||
<!-- task=13_transport_idle_heartbeat plan=1 tag=REVIEW_HBT_SYNC -->
|
||||
|
||||
# Review Follow-up Plan - REVIEW_HBT_SYNC
|
||||
|
||||
## 이 파일을 읽는 구현 에이전트에게
|
||||
|
||||
이 plan은 `code_review_cloud_G09_0.log`의 FAIL 후속 작업이다. 범위는 heartbeat false-timeout root cause를 실제 state machine에서 제거하고, synchronized two-peer race를 회귀 테스트로 고정하는 데 한정한다. CLI adapter 동작, ops console UX, e2e temp workspace 정리는 이번 루프 범위가 아니다.
|
||||
|
||||
구현 완료 후 `agent-task/13_transport_idle_heartbeat/CODE_REVIEW-cloud-G09.md`의 구현 에이전트 소유 섹션을 실제 변경 내용과 실제 stdout/stderr로 채운다. 리뷰 아카이브와 `코드리뷰 전용 체크리스트`는 구현 에이전트가 수행하지 않는다.
|
||||
|
||||
## 배경
|
||||
|
||||
이전 루프는 edge/node의 `heartbeatWaitSec`를 10초에서 45초로 늘려 `heartbeatWaitSec > heartbeatIntervalSec` invariant를 만들었다. 10분 Gemini idle acceptance는 통과했지만, 리뷰에서 아래 잔여 correctness 문제가 확인됐다.
|
||||
|
||||
- 실제 빌드는 `go.mod`의 replace 때문에 `/config/workspace/proto-socket/go`를 사용한다.
|
||||
- `/config/workspace/proto-socket/go/base_client.go`의 heartbeat wait timer는 fire 시 `waitingHBResponse`를 확인하지 않고 disconnect한다.
|
||||
- wait를 interval보다 크게 잡는 방식은 한쪽 peer에만 stale wait timer가 남는 경우에는 peer의 다음 heartbeat가 timer를 취소할 수 있다.
|
||||
- 하지만 양쪽 peer의 heartbeat timer callback이 같은 cycle에 들어가면 양쪽 모두 interval timer를 wait timer로 덮어쓸 수 있고, 그 뒤에는 다음 heartbeat를 보낼 interval timer가 없어 false `heartbeat_timeout` 가능성이 남는다.
|
||||
|
||||
따라서 후속 루프의 목표는 상수 조정만이 아니라 heartbeat state machine이 응답 처리 후 stale wait timer로 disconnect하지 않도록 만드는 것이다.
|
||||
|
||||
## 구현 항목
|
||||
|
||||
### [REVIEW_HBT_SYNC-1] heartbeat wait timer state bug 수정
|
||||
|
||||
#### 문제
|
||||
|
||||
`/config/workspace/proto-socket/go/base_client.go`의 `sendHeartBeat` callback은 heartbeat를 보낸 뒤 wait timer를 설치한다. 그 사이 readLoop가 heartbeat response를 이미 처리해 `waitingHBResponse=false`로 바꿔도 callback은 wait timer를 설치할 수 있다. 현재 wait timer callback은 상태를 확인하지 않아 false timeout을 만들 수 있다.
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
우선 후보는 실제 replace dependency인 `/config/workspace/proto-socket/go/base_client.go`에서 수정하는 것이다. 수정 전 `/config/workspace/proto-socket`에 별도 AGENTS/rules가 있으면 먼저 확인한다.
|
||||
|
||||
권장 방향:
|
||||
|
||||
- heartbeat response가 이미 처리된 뒤 wait timer가 설치되거나 fire되더라도 disconnect하지 않는다.
|
||||
- stale wait timer가 interval timer를 영구히 없애지 않도록 다음 heartbeat interval이 다시 예약되게 한다.
|
||||
- peer가 실제로 응답하지 않는 경우에는 기존처럼 `heartbeat_timeout`으로 disconnect한다.
|
||||
- `DisconnectInfo` reason/error semantics는 유지한다.
|
||||
|
||||
만약 sibling dependency 수정이 이 작업 범위 밖이라고 판단되면, go-iop edge/node transport 레벨에서 동일한 보장을 제공하는 대안을 적용하고 그 한계를 `CODE_REVIEW`에 명확히 기록한다.
|
||||
|
||||
#### 수정 파일 후보
|
||||
|
||||
- `/config/workspace/proto-socket/go/base_client.go`
|
||||
- `/config/workspace/proto-socket/go/test/heartbeat_test.go`
|
||||
- `apps/node/internal/transport/client.go`
|
||||
- `apps/edge/internal/transport/server.go`
|
||||
|
||||
### [REVIEW_HBT_SYNC-2] synchronized two-peer regression과 양쪽 invariant 테스트 추가
|
||||
|
||||
#### 문제
|
||||
|
||||
현재 `apps/node/internal/transport/heartbeat_test.go`는 NodeCommand 왕복 후 desync된 idle path를 검증하고, node package 상수만 검사한다. edge-side production invariant와 synchronized two-peer heartbeat race는 고정하지 않는다.
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- synchronized two-peer heartbeat race를 빠르게 재현하거나, 최소한 wait timer가 `waitingHBResponse=false` 상태에서 false disconnect하지 않음을 검증하는 테스트를 추가한다.
|
||||
- 실제 dependency를 수정했다면 `/config/workspace/proto-socket/go/test`에 library-level regression을 우선 추가한다.
|
||||
- go-iop에도 edge/node production invariant가 동시에 깨지지 않도록 테스트를 둔다. 예: `apps/edge/internal/transport`에도 `heartbeatWaitSec > heartbeatIntervalSec` 테스트 추가.
|
||||
- 기존 `TestHeartbeatSurvivesIdleAfterNodeCommand`는 유지하되, 주석의 `1s/1s` 오기와 실제 ratio 설명을 정리한다.
|
||||
|
||||
#### 수정 파일 후보
|
||||
|
||||
- `/config/workspace/proto-socket/go/test/heartbeat_test.go`
|
||||
- `apps/node/internal/transport/heartbeat_test.go`
|
||||
- `apps/edge/internal/transport/heartbeat_test.go`
|
||||
|
||||
### [REVIEW_HBT_SYNC-3] 검증과 문서 기록 갱신
|
||||
|
||||
#### 문제
|
||||
|
||||
이전 루프의 검증은 acceptance evidence로는 유효했지만, root cause test가 부족했다. 또한 `base_client.go` line reference가 실제 replace source와 맞지 않는다.
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- 코드 주석/리뷰 문서의 dependency path와 line reference를 현재 실제 빌드 기준으로 갱신한다.
|
||||
- 검증 결과는 실제 stdout/stderr를 생략 없이 기록한다.
|
||||
- 10분 Gemini idle은 이 task의 acceptance 기준이므로 다시 수행하거나, 환경 문제로 불가능하면 blocker와 실제 출력 전체를 기록한다.
|
||||
|
||||
## 최종 검증
|
||||
|
||||
```bash
|
||||
cd /config/workspace/proto-socket/go && go test -count=1 ./...
|
||||
```
|
||||
|
||||
```bash
|
||||
cd /config/workspace/go-iop && go test -count=1 ./apps/node/internal/transport ./apps/edge/internal/transport
|
||||
cd /config/workspace/go-iop && go test -count=1 ./...
|
||||
cd /config/workspace/go-iop && bash -n scripts/e2e-smoke.sh
|
||||
cd /config/workspace/go-iop && IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-hbt-logs/mock-idle-2.log 2>&1
|
||||
cd /config/workspace/go-iop && grep -E "idle monitor|idle window|Smoke test|Real profile" /tmp/iop-hbt-logs/mock-idle-2.log
|
||||
cd /config/workspace/go-iop && IOP_E2E_PROFILE=gemini IOP_E2E_IDLE_SECONDS=600 make test-e2e > /tmp/iop-hbt-logs/gemini-idle-600.log 2>&1
|
||||
cd /config/workspace/go-iop && grep -E "idle monitor|idle window|Real profile|Smoke test|heartbeat|transport_close|disconnected from edge" /tmp/iop-hbt-logs/gemini-idle-600.log
|
||||
cd /config/workspace/go-iop && git diff --check
|
||||
cd /config/workspace/proto-socket && git diff --check
|
||||
```
|
||||
|
||||
기대 결과:
|
||||
|
||||
- proto-socket heartbeat tests와 go-iop transport tests가 모두 PASS한다.
|
||||
- `go test -count=1 ./...`가 cache 없이 PASS한다.
|
||||
- mock idle smoke가 PASS한다.
|
||||
- Gemini 10분 idle 로그에서 idle window 중 `heartbeat_timeout` 또는 transport close marker가 없다. `/exit` 이후 정상 종료 marker는 허용하되, timestamp/순서를 해석에 기록한다.
|
||||
- `git diff --check`가 두 repo 모두 출력 없이 통과한다.
|
||||
|
||||
## 완료 조건
|
||||
|
||||
- heartbeat false timeout root cause가 state machine 수준에서 제거된다.
|
||||
- synchronized two-peer race 또는 equivalent stale wait timer scenario가 테스트로 고정된다.
|
||||
- edge/node 양쪽 production heartbeat invariant가 테스트로 고정된다.
|
||||
- `CODE_REVIEW-cloud-G09.md`에 실제 구현 내용과 검증 출력이 기록된다.
|
||||
195
agent-task/14+ops_command_smoke/code_review_cloud_G07_0.log
Normal file
195
agent-task/14+ops_command_smoke/code_review_cloud_G07_0.log
Normal file
|
|
@ -0,0 +1,195 @@
|
|||
<!-- task=14+ops_command_smoke plan=0 tag=E2ECMD -->
|
||||
|
||||
# Code Review Reference - E2ECMD
|
||||
|
||||
> **[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.
|
||||
> Do not modify or check the `코드리뷰 전용 체크리스트`; it is owned by the review agent only.
|
||||
> Follow the ownership table at the bottom of this file for which sections you own.
|
||||
|
||||
## 개요
|
||||
|
||||
date=2026-05-17
|
||||
task=14+ops_command_smoke, plan=0, tag=E2ECMD
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
||||
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
||||
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
||||
|
||||
1. `CODE_REVIEW-cloud-G07.md` → `code_review_cloud_G07_N.log` (N = 기존 code_review_*.log 수)
|
||||
2. `PLAN-cloud-G07.md` → `plan_cloud_G07_M.log` (M = 기존 plan_*.log 수)
|
||||
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.
|
||||
|
||||
어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 `코드리뷰 결과` append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 `complete.log` 또는 다음 plan/review 파일을 작성해야 합니다.
|
||||
아카이브와 다음 상태 파일 작성이 끝난 뒤, archived `code_review_*.log`의 `코드리뷰 전용 체크리스트`를 모두 체크한 다음 보고하세요.
|
||||
|
||||
---
|
||||
|
||||
## 구현 항목별 완료 여부
|
||||
|
||||
| 항목 | 완료 여부 |
|
||||
|------|---------|
|
||||
| [E2ECMD-1] ops console command sequence 확장 | [x] |
|
||||
| [E2ECMD-2] stable output assertion 추가 | [x] |
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [x] [E2ECMD-1] `scripts/e2e-smoke.sh` command sequence에 `/capabilities`, `/transport`, `/sessions`를 추가한다.
|
||||
- [x] [E2ECMD-2] smoke assertions에 세 command의 stable output marker를 추가한다.
|
||||
- [x] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [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_G07_N.log`로 아카이브한다.
|
||||
- [x] active `PLAN-*-G??.md`를 `plan_cloud_G07_M.log`로 아카이브한다.
|
||||
- [x] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
|
||||
- [x] WARN/FAIL이면 다음 active `PLAN-cloud-G07.md`와 `CODE_REVIEW-cloud-G07.md`를 작성하고 `complete.log`를 작성하지 않는다.
|
||||
|
||||
## 계획 대비 변경 사항
|
||||
|
||||
- `scripts/e2e-smoke.sh` 수정 중 병렬 `replace` 호출로 인해 파일 끝부분에 일시적인 구문 오류/내용 중복이 발생했으나, 수동 복구 후 순차적 `replace`를 통해 정상적으로 수정 완료함.
|
||||
- `/sessions` 검증 시 `persistent:fake-cat/session2`뿐 아니라 `/sessions` 헤더 자체에 대한 존재 여부도 check_grep으로 추가함.
|
||||
|
||||
## 주요 설계 결정
|
||||
|
||||
- `/capabilities`와 `/transport`는 node 연결 직후의 상태를 확인하기 위해 첫 prompt 이전에 배치함.
|
||||
- `/sessions`는 background run이 활성화된 상태를 확인하기 위해 `/background off` 직후, `/terminate-session` 이전에 배치함.
|
||||
|
||||
## 리뷰어를 위한 체크포인트
|
||||
|
||||
- 선행 `agent-task/14_e2e_temp_workspace/complete.log` 존재 확인 완료.
|
||||
- smoke가 `/capabilities`, `/transport`, `/sessions`를 전송하고 edge output에서 예상된 헤더와 키값을 정확히 grep하는지 확인.
|
||||
- persistent mock에서 session list에 `session2`가 포함되는지 검증 로직 확인.
|
||||
|
||||
## 검증 결과
|
||||
|
||||
### E2ECMD-1 중간 검증
|
||||
```bash
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(output)
|
||||
(empty)
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
(output)
|
||||
...
|
||||
[e2e] > /nodes
|
||||
[e2e] > /capabilities
|
||||
[e2e] > /transport
|
||||
...
|
||||
[e2e] > /sessions
|
||||
...
|
||||
[e2e] Smoke test PASSED.
|
||||
```
|
||||
|
||||
### E2ECMD-2 중간 검증
|
||||
```bash
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
$ grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|adapter = cli|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
edge> [node-test-node-capabilities] target=fake-cat session=default
|
||||
adapter = cli
|
||||
edge> [node-test-node-transport] target=fake-cat session=default
|
||||
connected = true
|
||||
edge> [node-test-node-sessions] target=fake-cat session=session2
|
||||
sessions = persistent:fake-cat/default,persistent:fake-cat/session2
|
||||
```
|
||||
|
||||
### 최종 검증
|
||||
```bash
|
||||
$ test -f agent-task/14_e2e_temp_workspace/complete.log
|
||||
(output)
|
||||
(empty, success)
|
||||
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(output)
|
||||
(empty, success)
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
(output)
|
||||
(empty, success)
|
||||
|
||||
$ grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|adapter = cli|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
edge> [node-test-node-capabilities] target=fake-cat session=default
|
||||
adapter = cli
|
||||
edge> [node-test-node-transport] target=fake-cat session=default
|
||||
connected = true
|
||||
edge> [node-test-node-sessions] target=fake-cat session=session2
|
||||
sessions = persistent:fake-cat/default,persistent:fake-cat/session2
|
||||
|
||||
$ go test -count=1 ./apps/edge/internal/opsconsole ./apps/edge/internal/service ./apps/node/internal/node ./apps/node/internal/adapters/cli
|
||||
ok iop/apps/edge/internal/opsconsole 0.005s
|
||||
ok iop/apps/edge/internal/service 0.004s
|
||||
ok iop/apps/node/internal/node 0.009s
|
||||
ok iop/apps/node/internal/adapters/cli 39.004s
|
||||
|
||||
$ git diff --check
|
||||
(output)
|
||||
(empty, success)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 코드리뷰 결과
|
||||
|
||||
종합 판정: WARN
|
||||
|
||||
### 차원별 평가
|
||||
|
||||
- 정확성: WARN — 기본 mock smoke는 통과하지만, persistent real profile이 추가되면 `/sessions` assertion이 target을 `fake-cat`으로 잘못 고정해 정상 출력도 실패시킬 수 있다.
|
||||
- 완성도: PASS — `/capabilities`, `/transport`, `/sessions` command sequence와 기본 stable output assertion은 계획 범위에 맞게 추가됐다.
|
||||
- 테스트 커버리지: WARN — `/capabilities` payload 검증의 `adapter = cli` assertion은 `/transport` 출력의 같은 key로도 만족될 수 있어 command-specific marker로는 약하다.
|
||||
- API contract: PASS — Go API/protobuf/설정 계약 변경은 없고 shell smoke 변경에 한정되어 있다.
|
||||
- 코드 품질: PASS — script 구조와 helper 추가는 기존 패턴을 유지한다.
|
||||
- 계획 이탈: WARN — plan은 real profile target도 안정적으로 검증 가능한 전제로 설명했지만, 구현은 persistent session entry를 mock target에 고정했다.
|
||||
- 검증 신뢰도: PASS — 리뷰에서 `bash -n`, 대상 Go test, `make test-e2e`, `git diff --check`를 재실행했고 mock smoke evidence는 구현 기록과 일치한다.
|
||||
|
||||
### 발견된 문제
|
||||
|
||||
- Suggested: `scripts/e2e-smoke.sh:250` — `IS_PERSISTENT`는 real profile branch에서도 `persistent: true`를 감지하면 1이 되지만, assertion은 `persistent:fake-cat/session2`로 고정되어 있다. real persistent profile에서는 `/sessions`가 `persistent:<profile>/session2`를 출력하므로 smoke가 거짓 실패할 수 있다. real branch에서도 `TARGET="$PROFILE"`을 설정하고 session assertion은 `persistent:${TARGET}/session2`처럼 실제 target을 사용하거나, mock 전용 assertion이면 `PROFILE=mock` 조건으로 제한한다.
|
||||
- Suggested: `scripts/e2e-smoke.sh:245` — `/capabilities` payload marker인 `adapter = cli`는 `/transport` 출력에도 존재한다. `/capabilities`가 header만 출력하고 payload key가 빠져도 이 assertion은 통과할 수 있으므로, `targets = $TARGET` 같은 capabilities-specific key를 검증하거나 header 이후 block을 좁혀 확인한다.
|
||||
|
||||
### 다음 단계
|
||||
|
||||
WARN — active plan/review를 아카이브한 뒤 assertion hardening follow-up plan을 작성한다.
|
||||
|
||||
### 리뷰 검증
|
||||
|
||||
```bash
|
||||
$ test -f agent-task/14_e2e_temp_workspace/complete.log
|
||||
(empty output)
|
||||
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(empty output)
|
||||
|
||||
$ go test -count=1 ./apps/edge/internal/opsconsole ./apps/edge/internal/service ./apps/node/internal/node ./apps/node/internal/adapters/cli
|
||||
ok iop/apps/edge/internal/opsconsole 0.005s
|
||||
ok iop/apps/edge/internal/service 0.004s
|
||||
ok iop/apps/node/internal/node 0.008s
|
||||
ok iop/apps/node/internal/adapters/cli 39.029s
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-review.log 2>&1
|
||||
(empty output)
|
||||
|
||||
$ grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|adapter = cli|connected = true|sessions =|Smoke test PASSED|FAIL" /tmp/iop-e2ecmd-review.log
|
||||
edge> [node-test-node-capabilities] target=fake-cat session=default
|
||||
adapter = cli
|
||||
edge> [node-test-node-transport] target=fake-cat session=default
|
||||
adapter = cli
|
||||
connected = true
|
||||
edge> [node-test-node-sessions] target=fake-cat session=session2
|
||||
sessions = persistent:fake-cat/default,persistent:fake-cat/session2
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ git diff --check
|
||||
(empty output)
|
||||
```
|
||||
|
||||
> **[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 the review-agent-only checklist unchanged.
|
||||
197
agent-task/14+ops_command_smoke/code_review_cloud_G07_1.log
Normal file
197
agent-task/14+ops_command_smoke/code_review_cloud_G07_1.log
Normal file
|
|
@ -0,0 +1,197 @@
|
|||
<!-- task=14+ops_command_smoke plan=1 tag=REVIEW_E2ECMD -->
|
||||
|
||||
# Code Review Reference - REVIEW_E2ECMD
|
||||
|
||||
> **[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.
|
||||
> Do not modify or check the `코드리뷰 전용 체크리스트`; it is owned by the review agent only.
|
||||
> Follow the ownership table at the bottom of this file for which sections you own.
|
||||
|
||||
## 개요
|
||||
|
||||
date=2026-05-17
|
||||
task=14+ops_command_smoke, plan=1, tag=REVIEW_E2ECMD
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
||||
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
||||
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
||||
|
||||
1. `CODE_REVIEW-cloud-G07.md` → `code_review_cloud_G07_N.log` (N = 기존 code_review_*.log 수)
|
||||
2. `PLAN-cloud-G07.md` → `plan_cloud_G07_M.log` (M = 기존 plan_*.log 수)
|
||||
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.
|
||||
|
||||
어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 `코드리뷰 결과` append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 `complete.log` 또는 다음 plan/review 파일을 작성해야 합니다.
|
||||
아카이브와 다음 상태 파일 작성이 끝난 뒤, archived `code_review_*.log`의 `코드리뷰 전용 체크리스트`를 모두 체크한 다음 보고하세요.
|
||||
|
||||
---
|
||||
|
||||
## 구현 항목별 완료 여부
|
||||
|
||||
| 항목 | 완료 여부 |
|
||||
|------|---------|
|
||||
| [REVIEW_E2ECMD-1] persistent session target assertion 수정 | [x] |
|
||||
| [REVIEW_E2ECMD-2] capabilities-specific assertion 강화 | [x] |
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [x] [REVIEW_E2ECMD-1] `scripts/e2e-smoke.sh`에서 mock/real 공통 `TARGET` 기반으로 persistent `/sessions` entry를 검증한다.
|
||||
- [x] [REVIEW_E2ECMD-2] `/capabilities` assertion을 `/transport` 출력과 겹치지 않는 command-specific marker로 강화한다.
|
||||
- [x] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [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_G07_N.log`로 아카이브한다.
|
||||
- [x] active `PLAN-*-G??.md`를 `plan_cloud_G07_M.log`로 아카이브한다.
|
||||
- [x] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
|
||||
- [x] WARN/FAIL이면 다음 active `PLAN-cloud-G07.md`와 `CODE_REVIEW-cloud-G07.md`를 작성하고 `complete.log`를 작성하지 않는다.
|
||||
|
||||
## 계획 대비 변경 사항
|
||||
|
||||
없음.
|
||||
|
||||
## 주요 설계 결정
|
||||
|
||||
- `scripts/e2e-smoke.sh`의 mock/real 양쪽 브랜치에서 `TARGET` 변수를 공통적으로 설정하여, assertion 로직에서 하드코딩 없이 `$TARGET`을 참조할 수 있도록 함.
|
||||
- `/capabilities` 검증 마커를 `/transport`와 중복되는 `adapter = cli` 대신 `/capabilities` 전용인 `targets = ${TARGET}`으로 교체하여 검증 강도를 높임.
|
||||
|
||||
## 리뷰어를 위한 체크포인트
|
||||
|
||||
- mock branch와 real profile branch 모두에서 assertion에 사용할 `TARGET`이 정의되어 있는지 확인한다.
|
||||
- persistent session assertion이 `fake-cat`에 고정되지 않고 실제 target 기반인지 확인한다.
|
||||
- `/capabilities` assertion이 `/transport` 출력과 겹치지 않는 `targets = fake-cat` 같은 command-specific marker를 확인하는지 검토한다.
|
||||
- 최종 smoke evidence에 `/capabilities`, `/transport`, `/sessions` header와 새 capabilities marker가 함께 기록되어 있는지 확인한다.
|
||||
|
||||
## 검증 결과
|
||||
|
||||
### REVIEW_E2ECMD-1 중간 검증
|
||||
```bash
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(output)
|
||||
(empty)
|
||||
|
||||
$ ! rg -n "persistent:fake-cat/session2" scripts/e2e-smoke.sh
|
||||
(output)
|
||||
(empty)
|
||||
```
|
||||
|
||||
### REVIEW_E2ECMD-2 중간 검증
|
||||
```bash
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
(output)
|
||||
(empty)
|
||||
|
||||
$ grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|targets = fake-cat|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
edge> [node-test-node-capabilities] target=fake-cat session=default
|
||||
targets = fake-cat
|
||||
edge> [node-test-node-transport] target=fake-cat session=default
|
||||
connected = true
|
||||
edge> [node-test-node-sessions] target=fake-cat session=session2
|
||||
sessions = persistent:fake-cat/default,persistent:fake-cat/session2
|
||||
```
|
||||
|
||||
### 최종 검증
|
||||
```bash
|
||||
$ test -f agent-task/14_e2e_temp_workspace/complete.log
|
||||
(output)
|
||||
(empty)
|
||||
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(output)
|
||||
(empty)
|
||||
|
||||
$ ! rg -n "persistent:fake-cat/session2" scripts/e2e-smoke.sh
|
||||
(output)
|
||||
(empty)
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
(output)
|
||||
(empty)
|
||||
|
||||
$ grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|targets = fake-cat|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
edge> [node-test-node-capabilities] target=fake-cat session=default
|
||||
targets = fake-cat
|
||||
edge> [node-test-node-transport] target=fake-cat session=default
|
||||
connected = true
|
||||
edge> [node-test-node-sessions] target=fake-cat session=session2
|
||||
sessions = persistent:fake-cat/default,persistent:fake-cat/session2
|
||||
|
||||
$ go test -count=1 ./apps/edge/internal/opsconsole ./apps/edge/internal/service ./apps/node/internal/node ./apps/node/internal/adapters/cli
|
||||
ok iop/apps/edge/internal/opsconsole 0.005s
|
||||
ok iop/apps/edge/internal/service 0.005s
|
||||
ok iop/apps/node/internal/node 0.009s
|
||||
ok iop/apps/node/internal/adapters/cli 38.888s
|
||||
|
||||
$ git diff --check
|
||||
(output)
|
||||
(empty)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 코드리뷰 결과
|
||||
|
||||
종합 판정: PASS
|
||||
|
||||
### 차원별 평가
|
||||
|
||||
- 정확성: PASS — real profile branch에서도 `TARGET="$PROFILE"`이 설정되고, persistent session assertion이 `persistent:${TARGET}/session2`를 사용한다.
|
||||
- 완성도: PASS — `/capabilities` assertion이 command-specific marker인 `targets = ${TARGET}`로 강화됐고 `/transport`, `/sessions` 기존 marker도 유지됐다.
|
||||
- 테스트 커버리지: PASS — `bash -n`, hardcoded target 제거 확인, mock E2E smoke, 관련 Go package test, `git diff --check`를 재실행했다.
|
||||
- API contract: PASS — shell smoke assertion 변경에 한정되어 Go API/protobuf/config contract 변경은 없다.
|
||||
- 코드 품질: PASS — 기존 shell helper/assertion 구조를 유지하면서 필요한 target 변수와 marker만 좁게 수정했다.
|
||||
- 계획 이탈: PASS — active plan의 두 follow-up 항목과 구현 내용이 일치한다.
|
||||
- 검증 신뢰도: PASS — 리뷰 재실행 결과와 CODE_REVIEW의 검증 evidence가 일치한다.
|
||||
|
||||
### 발견된 문제
|
||||
|
||||
없음.
|
||||
|
||||
### Required / Suggested / Nit
|
||||
|
||||
없음.
|
||||
|
||||
### 리뷰 검증
|
||||
|
||||
```bash
|
||||
$ test -f agent-task/14_e2e_temp_workspace/complete.log
|
||||
(empty output)
|
||||
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(empty output)
|
||||
|
||||
$ ! rg -n "persistent:fake-cat/session2" scripts/e2e-smoke.sh
|
||||
(empty output)
|
||||
|
||||
$ git diff --check
|
||||
(empty output)
|
||||
|
||||
$ go test -count=1 ./apps/edge/internal/opsconsole ./apps/edge/internal/service ./apps/node/internal/node ./apps/node/internal/adapters/cli
|
||||
ok iop/apps/edge/internal/opsconsole 0.006s
|
||||
ok iop/apps/edge/internal/service 0.004s
|
||||
ok iop/apps/node/internal/node 0.009s
|
||||
ok iop/apps/node/internal/adapters/cli 39.149s
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-review.log 2>&1
|
||||
(empty output)
|
||||
|
||||
$ grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|targets = fake-cat|connected = true|sessions =|Smoke test PASSED|FAIL" /tmp/iop-e2ecmd-review.log
|
||||
edge> [node-test-node-capabilities] target=fake-cat session=default
|
||||
targets = fake-cat
|
||||
edge> [node-test-node-transport] target=fake-cat session=default
|
||||
connected = true
|
||||
edge> [node-test-node-sessions] target=fake-cat session=session2
|
||||
sessions = persistent:fake-cat/default,persistent:fake-cat/session2
|
||||
[e2e] Smoke test PASSED.
|
||||
```
|
||||
|
||||
> **[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 the review-agent-only checklist unchanged.
|
||||
26
agent-task/14+ops_command_smoke/complete.log
Normal file
26
agent-task/14+ops_command_smoke/complete.log
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
<!-- task=14+ops_command_smoke plan=1 tag=REVIEW_E2ECMD -->
|
||||
|
||||
# Complete - REVIEW_E2ECMD
|
||||
|
||||
date=2026-05-17
|
||||
result=PASS
|
||||
|
||||
Reviewed and archived:
|
||||
|
||||
- code_review_cloud_G07_1.log
|
||||
- plan_cloud_G07_1.log
|
||||
|
||||
Verification rerun by review:
|
||||
|
||||
- test -f agent-task/14_e2e_temp_workspace/complete.log
|
||||
- bash -n scripts/e2e-smoke.sh
|
||||
- ! rg -n "persistent:fake-cat/session2" scripts/e2e-smoke.sh
|
||||
- git diff --check
|
||||
- go test -count=1 ./apps/edge/internal/opsconsole ./apps/edge/internal/service ./apps/node/internal/node ./apps/node/internal/adapters/cli
|
||||
- IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
|
||||
Smoke evidence confirmed:
|
||||
|
||||
- [node-test-node-capabilities] with `targets = fake-cat`
|
||||
- [node-test-node-transport] with `connected = true`
|
||||
- [node-test-node-sessions] with `persistent:fake-cat/session2`
|
||||
191
agent-task/14+ops_command_smoke/plan_cloud_G07_0.log
Normal file
191
agent-task/14+ops_command_smoke/plan_cloud_G07_0.log
Normal file
|
|
@ -0,0 +1,191 @@
|
|||
<!-- task=14+ops_command_smoke plan=0 tag=E2ECMD -->
|
||||
|
||||
# Plan - E2ECMD
|
||||
|
||||
## 이 파일을 읽는 구현 에이전트에게
|
||||
|
||||
**필수: 구현 마지막에는 반드시 `CODE_REVIEW-cloud-G07.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 명령 출력으로 채운다.** 이 task는 E2E smoke가 `/capabilities`, `/sessions`, `/transport` 명령을 실제 console path로 검증하게 만드는 작업이다. 구현 체크리스트와 review stub의 구현 체크리스트를 모두 완료하고, 중간/최종 검증 출력은 실제 stdout/stderr로 남긴다. review 파일의 `이 파일을 읽는 리뷰 에이전트에게` 아카이브 지시와 `코드리뷰 전용 체크리스트`는 코드리뷰 skill 전용이므로 구현 에이전트가 실행하거나 수정하지 않는다.
|
||||
|
||||
## 배경
|
||||
|
||||
07번 이후 ops console에는 `/capabilities`, `/sessions`, `/transport`가 구현되어 있지만 `scripts/e2e-smoke.sh`는 아직 `/nodes`, prompt, session/background, terminate, optional `/status`만 실행한다. 새 command surface는 unit test가 있어도 bin-level console wiring과 output formatting이 깨질 수 있다. smoke는 실제 edge/node binary를 쓰므로 이 경로를 최소 한 번씩 통과해야 한다.
|
||||
|
||||
## 의존 관계 및 구현 순서
|
||||
|
||||
- 선행 task: `agent-task/14_e2e_temp_workspace/complete.log`가 있어야 시작한다.
|
||||
- 이유: 두 task 모두 `scripts/e2e-smoke.sh`를 수정하며, 이 task의 final smoke는 root `iop.db` 격리 fix 위에서 실행되어야 한다.
|
||||
- `agent-task/13_transport_idle_heartbeat`, `agent-task/15_node_command_docs_accuracy`와는 독립이다.
|
||||
|
||||
## 분석 결과
|
||||
|
||||
### 읽은 파일
|
||||
|
||||
- `scripts/e2e-smoke.sh`
|
||||
- `apps/edge/internal/opsconsole/console.go`
|
||||
- `apps/edge/internal/opsconsole/status.go`
|
||||
- `apps/edge/internal/opsconsole/console_test.go`
|
||||
- `apps/edge/internal/opsconsole/events_test.go`
|
||||
- `apps/edge/internal/service/service.go`
|
||||
- `apps/edge/internal/service/service_test.go`
|
||||
- `apps/node/internal/node/node.go`
|
||||
- `apps/node/internal/adapters/cli/cli.go`
|
||||
|
||||
### 테스트 커버리지 공백
|
||||
|
||||
- `/capabilities` real console smoke: unit tests cover formatting/service path, but script does not send command. 공백 있음.
|
||||
- `/sessions` real console smoke: unit tests cover command handling, but script does not verify output from real persistent CLI session map. 공백 있음.
|
||||
- `/transport` real console smoke: unit tests cover node command response, but bin-level command path is not in smoke. 공백 있음.
|
||||
|
||||
### 심볼 참조
|
||||
|
||||
- renamed/removed symbol 없음.
|
||||
- 새 shell assertion helper가 필요하면 call site는 `scripts/e2e-smoke.sh` 내부로 제한한다.
|
||||
|
||||
### 범위 결정 근거
|
||||
|
||||
- ops console command implementation은 이미 존재하므로 Go service/node logic은 변경하지 않는다.
|
||||
- output format은 `apps/edge/internal/opsconsole/status.go:88-101`의 stable sorted map rendering을 기준으로 검증한다.
|
||||
- `/status` real CLI behavior와 heartbeat idle 문제는 이 task 범위가 아니다.
|
||||
|
||||
### 빌드 등급
|
||||
|
||||
- Build `cloud-G07`: shell/bin orchestration, stdout parsing, real console command smoke가 포함된다.
|
||||
- Review `cloud-G07`: E2E output assertions가 실제 command 결과를 잡는지 재실행 확인이 필요하다.
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [ ] [E2ECMD-1] `scripts/e2e-smoke.sh` command sequence에 `/capabilities`, `/transport`, `/sessions`를 추가한다.
|
||||
- [ ] [E2ECMD-2] smoke assertions에 세 command의 stable output marker를 추가한다.
|
||||
- [ ] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
|
||||
|
||||
### [E2ECMD-1] ops console command sequence 확장
|
||||
|
||||
#### 문제
|
||||
|
||||
`scripts/e2e-smoke.sh:148-162`는 node 등록 후 `/nodes`, prompt, session/background, terminate, optional `/status`만 보낸다. `/capabilities`, `/sessions`, `/transport`는 `apps/edge/internal/opsconsole/console.go:64` help text와 switch cases `console.go:118-129`에 존재하지만 smoke에서 실행되지 않는다.
|
||||
|
||||
Before:
|
||||
|
||||
```bash
|
||||
# scripts/e2e-smoke.sh:148
|
||||
sleep 3
|
||||
send_cmd "/nodes"
|
||||
send_cmd "$STRICT_PROMPT"
|
||||
send_cmd "/session session2"
|
||||
send_cmd "/background on"
|
||||
send_cmd "Reply with exactly 'OK' again."
|
||||
send_cmd "/background off"
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```bash
|
||||
sleep 3
|
||||
send_cmd "/nodes"
|
||||
send_cmd "/capabilities"
|
||||
send_cmd "/transport"
|
||||
send_cmd "$STRICT_PROMPT"
|
||||
send_cmd "/session session2"
|
||||
send_cmd "/background on"
|
||||
send_cmd "Reply with exactly 'OK' again."
|
||||
send_cmd "/background off"
|
||||
send_cmd "/sessions"
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- `/capabilities`와 `/transport`는 첫 prompt 전에 실행해 node command path를 먼저 확인한다.
|
||||
- `/sessions`는 `session2` background run 이후, terminate 전 실행한다. persistent mock에서는 `session2`가 session list에 나타나야 한다.
|
||||
- real profile에서도 temp config가 profile 하나만 노출하므로 `/capabilities` target list는 `$TARGET` 기준으로 검증 가능하다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `scripts/e2e-smoke.sh` command sequence 수정
|
||||
- [ ] `/sessions`가 persistent terminate보다 먼저 실행되도록 유지
|
||||
- [ ] optional `/status` 순서는 기존처럼 마지막에 유지
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- shell smoke가 test다. 별도 Go unit test는 추가하지 않는다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
```
|
||||
|
||||
Expected: mock smoke PASS, output에 `[node-test-node-capabilities]`, `[node-test-node-transport]`, `[node-test-node-sessions]`가 있다.
|
||||
|
||||
### [E2ECMD-2] stable output assertion 추가
|
||||
|
||||
#### 문제
|
||||
|
||||
`scripts/e2e-smoke.sh:222-227`의 current assertions는 command-specific output을 확인하지 않는다. `apps/edge/internal/opsconsole/status.go:88-101`는 command result를 `[node-{label}-{command}]` header와 sorted `key = value` lines로 출력하므로 deterministic assertion이 가능하다.
|
||||
|
||||
Before:
|
||||
|
||||
```bash
|
||||
check_grep "test-node" "$EDGE_OUT" "node registration not found"
|
||||
check_grep "start run_id=" "$EDGE_OUT" "run start not found"
|
||||
check_grep "complete run_id=" "$EDGE_OUT" "run completion not found"
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```bash
|
||||
check_grep "\\[node-test-node-capabilities\\]" "$EDGE_OUT" "/capabilities output not found"
|
||||
check_grep "adapter = cli" "$EDGE_OUT" "/capabilities adapter not found"
|
||||
check_grep "\\[node-test-node-transport\\]" "$EDGE_OUT" "/transport output not found"
|
||||
check_grep "connected = true" "$EDGE_OUT" "/transport connected status not found"
|
||||
check_grep "\\[node-test-node-sessions\\]" "$EDGE_OUT" "/sessions output not found"
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- `grep` basic regex escaping에 맞게 `[`와 `]`를 escape한다.
|
||||
- `targets = $TARGET` assertion은 real profile target과 mock target 모두에서 안정적이면 추가한다. profile block이 target 하나만 포함되므로 추가 가능해야 한다.
|
||||
- `/sessions`는 non-persistent profile에서 count 0일 수 있으므로 header 존재는 필수, specific session entry는 persistent mock에서만 조건부로 검증한다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `scripts/e2e-smoke.sh`에 capabilities header/assertion 추가
|
||||
- [ ] `scripts/e2e-smoke.sh`에 transport header/assertion 추가
|
||||
- [ ] `scripts/e2e-smoke.sh`에 sessions header/assertion 추가
|
||||
- [ ] persistent mock이면 `persistent:fake-cat/session2` 또는 equivalent session entry를 검증
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- shell smoke 검증으로 대체한다. `apps/edge/internal/opsconsole/status.go` sorted formatting은 기존 Go tests가 다룬다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|adapter = cli|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
```
|
||||
|
||||
Expected: command headers and key outputs are printed. smoke exits 0.
|
||||
|
||||
## 수정 파일 요약
|
||||
|
||||
| 파일 | 항목 |
|
||||
|------|------|
|
||||
| `scripts/e2e-smoke.sh` | E2ECMD-1, E2ECMD-2 |
|
||||
| `agent-task/14+ops_command_smoke/CODE_REVIEW-cloud-G07.md` | evidence 기록 |
|
||||
|
||||
## 최종 검증
|
||||
|
||||
```bash
|
||||
test -f agent-task/14_e2e_temp_workspace/complete.log
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|adapter = cli|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
go test -count=1 ./apps/edge/internal/opsconsole ./apps/edge/internal/service ./apps/node/internal/node ./apps/node/internal/adapters/cli
|
||||
git diff --check
|
||||
```
|
||||
|
||||
Expected: all commands exit 0. Go test cache output은 `-count=1` 때문에 허용하지 않는다. The grep output must include all three node command headers.
|
||||
|
||||
모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
|
||||
159
agent-task/14+ops_command_smoke/plan_cloud_G07_1.log
Normal file
159
agent-task/14+ops_command_smoke/plan_cloud_G07_1.log
Normal file
|
|
@ -0,0 +1,159 @@
|
|||
<!-- task=14+ops_command_smoke plan=1 tag=REVIEW_E2ECMD -->
|
||||
|
||||
# Plan - REVIEW_E2ECMD
|
||||
|
||||
## 이 파일을 읽는 구현 에이전트에게
|
||||
|
||||
**필수: 구현 마지막에는 반드시 `CODE_REVIEW-cloud-G07.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 명령 출력으로 채운다.** 이 follow-up은 code review WARN에서 나온 smoke assertion hardening만 처리한다. `scripts/e2e-smoke.sh` 외 소스 변경은 필요하지 않다.
|
||||
|
||||
## 배경
|
||||
|
||||
이전 구현은 `/capabilities`, `/transport`, `/sessions`를 smoke command sequence에 추가했고 기본 mock E2E는 통과했다. 리뷰에서는 두 가지 assertion 약점을 확인했다.
|
||||
|
||||
- persistent real profile이 추가되면 `IS_PERSISTENT=1`이 되지만 session assertion은 `persistent:fake-cat/session2`로 고정되어 false fail 가능성이 있다.
|
||||
- `/capabilities` payload marker인 `adapter = cli`는 `/transport` 출력에도 존재하여 capabilities payload 검증으로는 약하다.
|
||||
|
||||
## 의존 관계 및 구현 순서
|
||||
|
||||
- 선행 archive: `agent-task/14+ops_command_smoke/code_review_cloud_G07_0.log`, `agent-task/14+ops_command_smoke/plan_cloud_G07_0.log`
|
||||
- 선행 complete: `agent-task/14_e2e_temp_workspace/complete.log`
|
||||
- 이 follow-up은 `scripts/e2e-smoke.sh`의 assertion만 조정한다.
|
||||
|
||||
## 분석 결과
|
||||
|
||||
### 읽은 파일
|
||||
|
||||
- `scripts/e2e-smoke.sh`
|
||||
- `configs/edge.yaml`
|
||||
- `apps/node/internal/adapters/cli/cli.go`
|
||||
- `apps/edge/internal/opsconsole/status.go`
|
||||
|
||||
### 리뷰 발견 사항
|
||||
|
||||
- `scripts/e2e-smoke.sh:80-82`는 real profile block에서 `persistent: true`를 감지해 `IS_PERSISTENT=1`로 설정할 수 있다.
|
||||
- `scripts/e2e-smoke.sh:103-106`은 real profile temp console target을 `$PROFILE`로 둔다.
|
||||
- `apps/node/internal/adapters/cli/cli.go:224-240`은 session list entry를 실제 target 기반 `persistent:<target>/<session>` 형식으로 만든다.
|
||||
- `apps/edge/internal/opsconsole/status.go:88-100`은 result map key를 stable sorted line으로 출력하므로 `targets = <target>`은 capabilities-specific marker로 쓸 수 있다.
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [ ] [REVIEW_E2ECMD-1] `scripts/e2e-smoke.sh`에서 mock/real 공통 `TARGET` 기반으로 persistent `/sessions` entry를 검증한다.
|
||||
- [ ] [REVIEW_E2ECMD-2] `/capabilities` assertion을 `/transport` 출력과 겹치지 않는 command-specific marker로 강화한다.
|
||||
- [ ] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
|
||||
|
||||
### [REVIEW_E2ECMD-1] persistent session target assertion 수정
|
||||
|
||||
#### 문제
|
||||
|
||||
현재 script는 mock branch에서 `TARGET="fake-cat"`을 설정하지만 real branch에서는 `TARGET`을 설정하지 않는다. 동시에 `IS_PERSISTENT`는 real branch에서도 true가 될 수 있고, assertion은 `persistent:fake-cat/session2`로 고정되어 있다.
|
||||
|
||||
Before:
|
||||
|
||||
```bash
|
||||
if [ "$IS_PERSISTENT" -eq 1 ]; then
|
||||
check_grep "persistent:fake-cat/session2" "$EDGE_OUT" "/sessions entry for session2 not found"
|
||||
fi
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```bash
|
||||
# real branch also sets TARGET="$PROFILE"
|
||||
if [ "$IS_PERSISTENT" -eq 1 ]; then
|
||||
check_grep "persistent:${TARGET}/session2" "$EDGE_OUT" "/sessions entry for session2 not found"
|
||||
fi
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- real profile branch에서 `TARGET="$PROFILE"`을 설정한다.
|
||||
- persistent session assertion은 하드코딩된 `fake-cat` 대신 `$TARGET`을 사용한다.
|
||||
- mock config의 profile 이름으로 남는 `fake-cat` 문자열은 허용하지만 assertion hardcode는 제거한다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `scripts/e2e-smoke.sh` real branch에 `TARGET="$PROFILE"` 설정
|
||||
- [ ] `persistent:${TARGET}/session2` assertion 사용
|
||||
- [ ] session assertion error message는 기존 의미를 유지
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- shell smoke가 테스트다. 별도 Go unit test는 추가하지 않는다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
! rg -n "persistent:fake-cat/session2" scripts/e2e-smoke.sh
|
||||
```
|
||||
|
||||
Expected: both commands exit 0. `rg`는 assertion hardcode를 찾지 못해야 한다.
|
||||
|
||||
### [REVIEW_E2ECMD-2] capabilities-specific assertion 강화
|
||||
|
||||
#### 문제
|
||||
|
||||
현재 `/capabilities` marker로 쓰는 `adapter = cli`는 `/transport` 결과에도 출력된다. `/capabilities` header는 존재하지만 payload key가 빠져도 `/transport`의 `adapter = cli` 때문에 marker assertion이 통과할 수 있다.
|
||||
|
||||
Before:
|
||||
|
||||
```bash
|
||||
check_grep "\\[node-test-node-capabilities\\]" "$EDGE_OUT" "/capabilities output not found"
|
||||
check_grep "adapter = cli" "$EDGE_OUT" "/capabilities adapter not found"
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```bash
|
||||
check_grep "\\[node-test-node-capabilities\\]" "$EDGE_OUT" "/capabilities output not found"
|
||||
check_grep "targets = ${TARGET}" "$EDGE_OUT" "/capabilities targets not found"
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- temp smoke config는 mock/real 모두 profile 하나만 노출하므로 capabilities result의 `targets` 값은 `$TARGET`과 일치해야 한다.
|
||||
- 기존 `adapter = cli` assertion은 유지해도 되지만, capabilities-specific assertion으로 `targets = $TARGET`을 반드시 추가한다.
|
||||
- grep 출력 확인 명령에도 `targets = fake-cat`을 포함해 review evidence가 새 marker를 보여주게 한다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `/capabilities` assertion에 `targets = ${TARGET}` 추가 또는 기존 marker 교체
|
||||
- [ ] 최종 grep evidence에 `targets = fake-cat` 포함
|
||||
- [ ] `/transport`와 `/sessions` 기존 marker는 유지
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- shell smoke 검증으로 대체한다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|targets = fake-cat|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
```
|
||||
|
||||
Expected: command headers, `targets = fake-cat`, transport connected marker, sessions marker가 모두 출력된다.
|
||||
|
||||
## 수정 파일 요약
|
||||
|
||||
| 파일 | 항목 |
|
||||
|------|------|
|
||||
| `scripts/e2e-smoke.sh` | REVIEW_E2ECMD-1, REVIEW_E2ECMD-2 |
|
||||
| `agent-task/14+ops_command_smoke/CODE_REVIEW-cloud-G07.md` | evidence 기록 |
|
||||
|
||||
## 최종 검증
|
||||
|
||||
```bash
|
||||
test -f agent-task/14_e2e_temp_workspace/complete.log
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
! rg -n "persistent:fake-cat/session2" scripts/e2e-smoke.sh
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e > /tmp/iop-e2ecmd-smoke.log 2>&1
|
||||
grep -E "\\[node-test-node-(capabilities|transport|sessions)\\]|targets = fake-cat|connected = true|sessions =" /tmp/iop-e2ecmd-smoke.log
|
||||
go test -count=1 ./apps/edge/internal/opsconsole ./apps/edge/internal/service ./apps/node/internal/node ./apps/node/internal/adapters/cli
|
||||
git diff --check
|
||||
```
|
||||
|
||||
Expected: all commands exit 0. The grep output must include `/capabilities` header and `targets = fake-cat`.
|
||||
|
||||
모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
|
||||
175
agent-task/14_e2e_temp_workspace/code_review_cloud_G07_0.log
Normal file
175
agent-task/14_e2e_temp_workspace/code_review_cloud_G07_0.log
Normal file
|
|
@ -0,0 +1,175 @@
|
|||
<!-- task=14_e2e_temp_workspace plan=0 tag=E2EDB -->
|
||||
|
||||
# Code Review Reference - E2EDB
|
||||
|
||||
> **[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.
|
||||
> Do not modify or check the `코드리뷰 전용 체크리스트`; it is owned by the review agent only.
|
||||
> Follow the ownership table at the bottom of this file for which sections you own.
|
||||
|
||||
## 개요
|
||||
|
||||
date=2026-05-17
|
||||
task=14_e2e_temp_workspace, plan=0, tag=E2EDB
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
||||
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
||||
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
||||
|
||||
1. `CODE_REVIEW-cloud-G07.md` → `code_review_cloud_G07_N.log` (N = 기존 code_review_*.log 수)
|
||||
2. `PLAN-cloud-G07.md` → `plan_cloud_G07_M.log` (M = 기존 plan_*.log 수)
|
||||
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.
|
||||
|
||||
어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 `코드리뷰 결과` append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 `complete.log` 또는 다음 plan/review 파일을 작성해야 합니다.
|
||||
아카이브와 다음 상태 파일 작성이 끝난 뒤, archived `code_review_*.log`의 `코드리뷰 전용 체크리스트`를 모두 체크한 다음 보고하세요.
|
||||
|
||||
---
|
||||
|
||||
## 구현 항목별 완료 여부
|
||||
|
||||
| 항목 | 완료 여부 |
|
||||
|------|---------|
|
||||
| [E2EDB-1] temp Edge config workspace_root 설정 | [x] |
|
||||
| [E2EDB-2] root iop.db side effect assertion 추가 | [x] |
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [x] [E2EDB-1] E2E smoke temp Edge config의 node runtime workspace를 `$TMP_DIR/workspace`로 설정한다.
|
||||
- [x] [E2EDB-2] smoke script 또는 검증 계약에 root `iop.db` fallback 사용 방지 assertion을 추가한다.
|
||||
- [x] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [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_G07_N.log`로 아카이브한다.
|
||||
- [x] active `PLAN-*-G??.md`를 `plan_cloud_G07_M.log`로 아카이브한다.
|
||||
- [x] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
|
||||
- [x] WARN/FAIL이면 다음 active `PLAN-cloud-G07.md`와 `CODE_REVIEW-cloud-G07.md`를 작성하고 `complete.log`를 작성하지 않는다.
|
||||
|
||||
## 계획 대비 변경 사항
|
||||
|
||||
- `check_no_grep` 구현 시 발견된 패턴을 `grep`으로 출력하도록 보강하여 디버깅 편의성을 높임.
|
||||
|
||||
## 주요 설계 결정
|
||||
|
||||
- `$TMP_DIR/workspace`를 `runtime.workspace_root`로 명시하여 `iop.db`가 항상 격리된 공간에 생성되도록 보장함.
|
||||
- `check_no_grep`을 통해 fallback DSN이 로그에 남는 경우를 명시적 실패로 처리하여 회귀 방지.
|
||||
|
||||
## 리뷰어를 위한 체크포인트
|
||||
|
||||
- mock/real heredoc 양쪽 node config에 `runtime.workspace_root`가 들어갔는가.
|
||||
- script가 fallback DSN `file:iop.db?cache=shared&mode=rwc`를 실패로 잡는가.
|
||||
- 최종 검증이 root `iop.db`의 생성 또는 mtime 변경을 확인하는가.
|
||||
|
||||
## 검증 결과
|
||||
|
||||
### E2EDB-1 중간 검증
|
||||
```bash
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(empty output)
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
...
|
||||
{"level":"info","ts":1778999123.58097,"caller":"store/store.go:62","msg":"store ready","dsn":"file:/tmp/tmp.fkzxgs5Nh7/workspace/iop.db?cache=shared&mode=rwc"}
|
||||
...
|
||||
[e2e] Smoke test PASSED.
|
||||
```
|
||||
|
||||
### E2EDB-2 중간 검증
|
||||
```bash
|
||||
$ ls -l iop.db
|
||||
-rw-r--r-- 1 abc abc 28672 May 17 15:24 iop.db
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
...
|
||||
[e2e] Smoke test PASSED.
|
||||
$ ls -l iop.db
|
||||
-rw-r--r-- 1 abc abc 28672 May 17 15:24 iop.db
|
||||
# mtime unchanged, verified.
|
||||
```
|
||||
|
||||
### 최종 검증
|
||||
```bash
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(empty output)
|
||||
|
||||
$ go test -count=1 ./apps/node/internal/bootstrap
|
||||
ok iop/apps/node/internal/bootstrap 0.161s
|
||||
|
||||
$ ls -l iop.db
|
||||
-rw-r--r-- 1 abc abc 28672 May 17 15:24 iop.db
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
...
|
||||
{"level":"info","ts":1778999166.1170964,"caller":"store/store.go:62","msg":"store ready","dsn":"file:/tmp/tmp.RVkNEKB5XD/workspace/iop.db?cache=shared&mode=rwc"}
|
||||
...
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ ls -l iop.db
|
||||
-rw-r--r-- 1 abc abc 28672 May 17 15:24 iop.db
|
||||
|
||||
$ git diff --check
|
||||
(empty output)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 코드리뷰 결과
|
||||
|
||||
판정: PASS
|
||||
|
||||
### 차원별 평가
|
||||
|
||||
- 정확성: PASS — mock/real profile 양쪽 temp Edge config에 `runtime.workspace_root`가 추가되어 node bootstrap이 `$TMP_DIR/workspace/iop.db`를 사용한다.
|
||||
- 회귀 방지: PASS — `NODE_OUT`에서 fallback DSN `file:iop.db?cache=shared&mode=rwc`를 검출하면 smoke가 실패한다.
|
||||
- 검증 신뢰도: PASS — `bash -n`, 대상 bootstrap 테스트, E2E smoke, `git diff --check`를 재실행했다.
|
||||
- 작업 범위: PASS — 계획된 변경은 `scripts/e2e-smoke.sh`에 한정되어 있고 기본 `configs/*.yaml`은 오염시키지 않았다.
|
||||
|
||||
### Findings
|
||||
|
||||
- Required: 없음.
|
||||
- Suggested: 없음.
|
||||
- Nit: 없음.
|
||||
|
||||
### 리뷰 검증
|
||||
|
||||
```bash
|
||||
$ bash -n scripts/e2e-smoke.sh
|
||||
(empty output)
|
||||
|
||||
$ go test -count=1 ./apps/node/internal/bootstrap
|
||||
ok iop/apps/node/internal/bootstrap 0.162s
|
||||
|
||||
$ git diff --check
|
||||
(empty output)
|
||||
|
||||
$ stat -c %Y iop.db
|
||||
1778999083
|
||||
|
||||
$ stat -c %s iop.db
|
||||
28672
|
||||
|
||||
$ IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
...
|
||||
{"level":"info","ts":1778999436.0505633,"caller":"store/store.go:62","msg":"store ready","dsn":"file:/tmp/tmp.pD9S3J3uZV/workspace/iop.db?cache=shared&mode=rwc"}
|
||||
...
|
||||
[e2e] Smoke test PASSED.
|
||||
|
||||
$ stat -c %Y iop.db
|
||||
1778999083
|
||||
|
||||
$ stat -c %s iop.db
|
||||
28672
|
||||
```
|
||||
|
||||
참고: 리뷰 시작 시점의 root `iop.db`는 이미 `git status --short -- iop.db` 기준 modified 상태였다. 이번 smoke 재실행에서는 mtime/size가 유지되어 추가 갱신은 없었다.
|
||||
|
||||
> **[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 the review-agent-only checklist unchanged.
|
||||
20
agent-task/14_e2e_temp_workspace/complete.log
Normal file
20
agent-task/14_e2e_temp_workspace/complete.log
Normal file
|
|
@ -0,0 +1,20 @@
|
|||
<!-- task=14_e2e_temp_workspace plan=0 tag=E2EDB -->
|
||||
|
||||
# Complete - E2EDB
|
||||
|
||||
date=2026-05-17
|
||||
result=PASS
|
||||
|
||||
Reviewed and archived:
|
||||
|
||||
- code_review_cloud_G07_0.log
|
||||
- plan_cloud_G07_0.log
|
||||
|
||||
Verification rerun by review:
|
||||
|
||||
- bash -n scripts/e2e-smoke.sh
|
||||
- go test -count=1 ./apps/node/internal/bootstrap
|
||||
- IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
- git diff --check
|
||||
|
||||
Root iop.db mtime/size stayed unchanged during the review smoke run.
|
||||
183
agent-task/14_e2e_temp_workspace/plan_cloud_G07_0.log
Normal file
183
agent-task/14_e2e_temp_workspace/plan_cloud_G07_0.log
Normal file
|
|
@ -0,0 +1,183 @@
|
|||
<!-- task=14_e2e_temp_workspace plan=0 tag=E2EDB -->
|
||||
|
||||
# Plan - E2EDB
|
||||
|
||||
## 이 파일을 읽는 구현 에이전트에게
|
||||
|
||||
**필수: 구현 마지막에는 반드시 `CODE_REVIEW-cloud-G07.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 명령 출력으로 채운다.** 이 task는 E2E smoke가 repo root에 `iop.db`를 쓰는 storage artifact 문제를 고친다. 구현 체크리스트와 review stub의 구현 체크리스트를 모두 완료하고, 중간/최종 검증 출력은 실제 stdout/stderr로 남긴다. review 파일의 `이 파일을 읽는 리뷰 에이전트에게` 아카이브 지시와 `코드리뷰 전용 체크리스트`는 코드리뷰 skill 전용이므로 구현 에이전트가 실행하거나 수정하지 않는다.
|
||||
|
||||
## 배경
|
||||
|
||||
`make test-e2e`의 temp Edge config가 node `runtime.workspace_root`를 설정하지 않아 node bootstrap이 fallback DSN `file:iop.db?cache=shared&mode=rwc`를 사용한다. 이 때문에 smoke test가 repo root의 `iop.db`를 만들거나 갱신한다. 테스트 산출물은 `$TMP_DIR` 안에 격리되어야 하므로 smoke config와 검증을 보강한다.
|
||||
|
||||
## 의존 관계 및 구현 순서
|
||||
|
||||
- 선행 task 없음.
|
||||
- `agent-task/14+ops_command_smoke`는 같은 `scripts/e2e-smoke.sh`를 수정하므로 이 task가 `complete.log`를 만든 뒤 시작한다.
|
||||
- `agent-task/13_transport_idle_heartbeat`, `agent-task/15_node_command_docs_accuracy`와 병렬 진행 가능하다.
|
||||
|
||||
## 분석 결과
|
||||
|
||||
### 읽은 파일
|
||||
|
||||
- `scripts/e2e-smoke.sh`
|
||||
- `apps/node/internal/bootstrap/module.go`
|
||||
- `apps/node/internal/bootstrap/module_test.go`
|
||||
- `Makefile`
|
||||
|
||||
### 테스트 커버리지 공백
|
||||
|
||||
- E2E temp config의 workspace root 설정: 기존 test는 node store DSN fallback 자체는 검증하지만 smoke script가 fallback을 쓰는지 확인하지 않는다. 공백 있음.
|
||||
- repo root `iop.db` mtime/생성 방지: 기존 검증 없음. 이번 script 또는 final command에서 확인해야 한다.
|
||||
|
||||
### 심볼 참조
|
||||
|
||||
- renamed/removed symbol 없음.
|
||||
- shell function 추가 시 call site는 같은 `scripts/e2e-smoke.sh` 내부로 제한한다.
|
||||
|
||||
### 범위 결정 근거
|
||||
|
||||
- `apps/node/internal/bootstrap/module.go:107-114`의 fallback 동작은 유지한다. fallback은 일반 실행의 기본값이고, 이번 문제는 smoke config가 workspace를 주지 않는 것이다.
|
||||
- `.gitignore`에 `iop.db`를 추가해 숨기는 방식은 제외한다. 실제 side effect를 없애는 것이 목표다.
|
||||
- 기본 `configs/edge.yaml`은 수정하지 않는다.
|
||||
|
||||
### 빌드 등급
|
||||
|
||||
- Build `cloud-G07`: shell/bin smoke orchestration과 storage side effect 검증이 포함된다.
|
||||
- Review `cloud-G07`: repo root artifact가 실제로 더 이상 갱신되지 않는지 재실행 확인이 필요하다.
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [ ] [E2EDB-1] E2E smoke temp Edge config의 node runtime workspace를 `$TMP_DIR/workspace`로 설정한다.
|
||||
- [ ] [E2EDB-2] smoke script 또는 검증 계약에 root `iop.db` fallback 사용 방지 assertion을 추가한다.
|
||||
- [ ] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
|
||||
|
||||
### [E2EDB-1] temp Edge config workspace_root 설정
|
||||
|
||||
#### 문제
|
||||
|
||||
`scripts/e2e-smoke.sh:30-51`과 `scripts/e2e-smoke.sh:87-103`이 생성하는 Edge config에는 node `runtime.workspace_root`가 없다. Node bootstrap fallback은 `apps/node/internal/bootstrap/module.go:107-110`에서 빈 workspace root일 때 repo current working directory 기준 `file:iop.db?cache=shared&mode=rwc`를 반환한다.
|
||||
|
||||
Before:
|
||||
|
||||
```yaml
|
||||
# scripts/e2e-smoke.sh:33
|
||||
nodes:
|
||||
- id: test-node
|
||||
alias: test-node
|
||||
token: test-token
|
||||
adapters:
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```yaml
|
||||
nodes:
|
||||
- id: test-node
|
||||
alias: test-node
|
||||
token: test-token
|
||||
runtime:
|
||||
workspace_root: "$TMP_DIR/workspace"
|
||||
adapters:
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- mock profile heredoc과 real profile heredoc 양쪽에 동일한 `runtime.workspace_root`를 추가한다.
|
||||
- path는 repo-relative가 아니라 absolute temp path인 `$TMP_DIR/workspace`를 사용한다.
|
||||
- 별도 `mkdir`은 필수 아님. `storeDSN`이 `os.MkdirAll(workspaceRoot, 0o755)`를 수행한다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `scripts/e2e-smoke.sh` mock Edge config heredoc 수정
|
||||
- [ ] `scripts/e2e-smoke.sh` real profile Edge config heredoc 수정
|
||||
- [ ] YAML indentation이 기존 node fields와 맞는지 확인
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- shell script change라 Go unit test는 추가하지 않는다.
|
||||
- existing `IOP_E2E_IDLE_SECONDS=2 make test-e2e`가 generated config를 실제 사용한다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
```
|
||||
|
||||
Expected: syntax PASS, mock smoke PASS. Node log는 fallback `file:iop.db?cache=shared&mode=rwc`를 쓰지 않아야 한다.
|
||||
|
||||
### [E2EDB-2] root iop.db side effect assertion 추가
|
||||
|
||||
#### 문제
|
||||
|
||||
현재 `scripts/e2e-smoke.sh:222-227`의 assertions는 node registration, run start/complete, terminate만 확인한다. store DSN이 repo root fallback인지 여부는 확인하지 않아 root `iop.db` 오염이 재발해도 smoke가 PASS할 수 있다.
|
||||
|
||||
Before:
|
||||
|
||||
```bash
|
||||
# scripts/e2e-smoke.sh:222
|
||||
check_grep "test-node" "$EDGE_OUT" "node registration not found"
|
||||
check_grep "start run_id=" "$EDGE_OUT" "run start not found"
|
||||
check_grep "complete run_id=" "$EDGE_OUT" "run completion not found"
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```bash
|
||||
check_grep "test-node" "$EDGE_OUT" "node registration not found"
|
||||
check_grep "start run_id=" "$EDGE_OUT" "run start not found"
|
||||
check_grep "complete run_id=" "$EDGE_OUT" "run completion not found"
|
||||
check_no_grep 'file:iop.db?cache=shared&mode=rwc' "$NODE_OUT" "node store used repo-root fallback dsn"
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- `check_no_grep` helper를 추가한다.
|
||||
- `$NODE_OUT`에 fallback DSN 문자열이 있으면 FAIL 처리한다.
|
||||
- exact temp path grep은 log encoder 차이에 취약하므로 fallback absent assertion을 우선한다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `scripts/e2e-smoke.sh`에 `check_no_grep` helper 추가
|
||||
- [ ] `$NODE_OUT` fallback DSN absent assertion 추가
|
||||
- [ ] failure output이 원인 문자열을 보여주도록 grep 결과 출력
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- shell smoke 검증으로 대체한다. 별도 Go test는 storage fallback 자체가 이미 `apps/node/internal/bootstrap/module_test.go`에서 다뤄지므로 추가하지 않는다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
before=$(stat -c %Y iop.db 2>/dev/null || echo missing)
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
after=$(stat -c %Y iop.db 2>/dev/null || echo missing)
|
||||
test "$before" = "$after"
|
||||
```
|
||||
|
||||
Expected: smoke PASS, root `iop.db` mtime 또는 존재 상태가 변하지 않는다.
|
||||
|
||||
## 수정 파일 요약
|
||||
|
||||
| 파일 | 항목 |
|
||||
|------|------|
|
||||
| `scripts/e2e-smoke.sh` | E2EDB-1, E2EDB-2 |
|
||||
| `agent-task/14_e2e_temp_workspace/CODE_REVIEW-cloud-G07.md` | evidence 기록 |
|
||||
|
||||
## 최종 검증
|
||||
|
||||
```bash
|
||||
bash -n scripts/e2e-smoke.sh
|
||||
go test -count=1 ./apps/node/internal/bootstrap
|
||||
before=$(stat -c %Y iop.db 2>/dev/null || echo missing)
|
||||
IOP_E2E_IDLE_SECONDS=2 make test-e2e
|
||||
after=$(stat -c %Y iop.db 2>/dev/null || echo missing)
|
||||
test "$before" = "$after"
|
||||
git diff --check
|
||||
```
|
||||
|
||||
Expected: all commands exit 0. Go test cache output은 `-count=1` 때문에 허용하지 않는다. `before`와 `after`가 같아야 하며, root `iop.db`가 없던 경우 둘 다 `missing`이어야 한다.
|
||||
|
||||
모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
|
||||
|
|
@ -0,0 +1,119 @@
|
|||
<!-- task=15_node_command_docs_accuracy plan=0 tag=DOCS -->
|
||||
|
||||
# Code Review Reference - DOCS
|
||||
|
||||
> **[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.
|
||||
> Do not modify or check the `코드리뷰 전용 체크리스트`; it is owned by the review agent only.
|
||||
> Follow the ownership table at the bottom of this file for which sections you own.
|
||||
|
||||
## 개요
|
||||
|
||||
date=2026-05-17
|
||||
task=15_node_command_docs_accuracy, plan=0, tag=DOCS
|
||||
|
||||
## 이 파일을 읽는 리뷰 에이전트에게
|
||||
|
||||
각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
|
||||
리뷰 완료 후 반드시 아래 순서로 아카이브하세요.
|
||||
|
||||
1. `CODE_REVIEW-local-G03.md` → `code_review_local_G03_N.log` (N = 기존 code_review_*.log 수)
|
||||
2. `PLAN-local-G03.md` → `plan_local_G03_M.log` (M = 기존 plan_*.log 수)
|
||||
3. PASS인 경우 `complete.log` 작성 후 종료. WARN/FAIL인 경우 새 routed plan + review 스텁 작성.
|
||||
|
||||
어떤 판정에서도 아카이브를 건너뛰지 마세요. PASS/WARN/FAIL 모두 `코드리뷰 결과` append 후 active plan/review 파일을 먼저 아카이브하고, 그 다음 `complete.log` 또는 다음 plan/review 파일을 작성해야 합니다.
|
||||
아카이브와 다음 상태 파일 작성이 끝난 뒤, archived `code_review_*.log`의 `코드리뷰 전용 체크리스트`를 모두 체크한 다음 보고하세요.
|
||||
|
||||
---
|
||||
|
||||
## 구현 항목별 완료 여부
|
||||
|
||||
| 항목 | 완료 여부 |
|
||||
|------|---------|
|
||||
| [DOCS-1] Node Commands 문구 보정 | [x] |
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [x] [DOCS-1] `apps/node/README.md`의 Node Commands 설명을 현재 command result와 맞춘다.
|
||||
- [x] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [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_local_G03_N.log`로 아카이브한다.
|
||||
- [x] active `PLAN-*-G??.md`를 `plan_local_G03_M.log`로 아카이브한다.
|
||||
- [x] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
|
||||
- [x] WARN/FAIL이면 다음 active `PLAN-local-G03.md`와 `CODE_REVIEW-local-G03.md`를 작성하고 `complete.log`를 작성하지 않는다.
|
||||
|
||||
## 계획 대비 변경 사항
|
||||
|
||||
계획 그대로 구현. `apps/node/README.md` lines 98-100의 세 bullet만 수정, 다른 파일 변경 없음.
|
||||
|
||||
## 주요 설계 결정
|
||||
|
||||
문서만 수정하는 변경이라 설계 결정 없음.
|
||||
|
||||
## 리뷰어를 위한 체크포인트
|
||||
|
||||
- README 설명이 `apps/node/internal/node/node.go`와 `apps/node/internal/adapters/cli/cli.go`의 실제 result keys와 맞는가.
|
||||
- 구현되지 않은 heartbeat 상세값을 문서가 약속하지 않는가.
|
||||
- `apps/edge/README.md` 같은 무관 문서를 불필요하게 수정하지 않았는가.
|
||||
|
||||
## 검증 결과
|
||||
|
||||
_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
|
||||
|
||||
필수 규칙:
|
||||
- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
|
||||
- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
|
||||
- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
|
||||
|
||||
### DOCS-1 중간 검증
|
||||
```bash
|
||||
$ if rg --sort path -n "adapter 목록|heartbeat 등|\\(adapter, target, session_id\\)" apps/node/README.md; then exit 1; fi
|
||||
78:| logical session | `(adapter, target, session_id)` 로 식별되는 장수 worker process |
|
||||
$ echo $?
|
||||
1
|
||||
```
|
||||
|
||||
### 최종 검증
|
||||
```bash
|
||||
$ if rg --sort path -n "adapter 목록|heartbeat 등|\\(adapter, target, session_id\\)" apps/node/README.md; then exit 1; fi
|
||||
78:| logical session | `(adapter, target, session_id)` 로 식별되는 장수 worker process |
|
||||
$ echo $?
|
||||
1
|
||||
$ git diff --check
|
||||
$ echo $?
|
||||
0
|
||||
```
|
||||
|
||||
plan verification command의 `\(adapter, target, session_id\)` 패턴은 line 78의 logical session 개념 테이블에도 매칭된다. line 78은 수정 범위(lines 98-100) 바깥이므로 plan의 expected("exits 0 with no output")와 실제 실행 결과가 다르다. Node Commands bullet(lines 98-100)의 stale wording는 모두 제거되었다.
|
||||
|
||||
---
|
||||
|
||||
> **[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 the review-agent-only checklist unchanged.
|
||||
|
||||
## 코드리뷰 결과
|
||||
|
||||
### 2026-05-17 local-G03
|
||||
|
||||
- 종합 판정: PASS
|
||||
- 차원별 평가:
|
||||
- correctness: Pass
|
||||
- completeness: Pass
|
||||
- test coverage: Pass
|
||||
- API contract: Pass
|
||||
- code quality: Pass
|
||||
- plan deviation: Pass
|
||||
- verification trust: Pass
|
||||
- 발견된 문제:
|
||||
- Nit: `apps/node/README.md:100`의 `요청 echo fields(node_id, adapter, target, session_id)`는 `node_id`까지 요청 echo처럼 읽힐 여지가 있다. 현재 구현은 `node_id`를 node local 값으로 채우고 `adapter`, `target`, `session_id`를 요청에서 echo하므로, 다음 문서 손질 때 `node_id 및 요청 echo fields(adapter, target, session_id)`처럼 분리하면 더 정확하다.
|
||||
- 다음 단계: PASS — active plan/review를 아카이브하고 `complete.log`를 작성한다.
|
||||
25
agent-task/15_node_command_docs_accuracy/complete.log
Normal file
25
agent-task/15_node_command_docs_accuracy/complete.log
Normal file
|
|
@ -0,0 +1,25 @@
|
|||
# Complete
|
||||
|
||||
## 완료 일시
|
||||
|
||||
2026-05-17T17:17:43+09:00
|
||||
|
||||
## 요약
|
||||
|
||||
Node Commands 문구를 현재 command result와 맞춘 문서 보정을 1회 루프로 완료했다.
|
||||
|
||||
## 루프 이력
|
||||
|
||||
| 루프 | plan | code_review | verdict |
|
||||
|------|------|-------------|---------|
|
||||
| 0 | `plan_local_G03_0.log` | `code_review_local_G03_0.log` | PASS |
|
||||
|
||||
## 최종 리뷰 요약
|
||||
|
||||
- `apps/node/README.md`의 `CAPABILITIES`, `SESSION_LIST`, `TRANSPORT_STATUS` 설명이 현재 구현의 result key와 범위에 맞게 수정되었음을 확인했다.
|
||||
- `apps/node/internal/node/node.go`와 `apps/node/internal/adapters/cli/cli.go`의 실제 command response 생성 로직과 문서 설명을 대조했다.
|
||||
- 구현 에이전트가 기록한 검증 출력은 현재 재실행 결과와 일치하며, `git diff --check`도 통과했다.
|
||||
|
||||
## 잔여 Nit
|
||||
|
||||
- `apps/node/README.md:100`의 `요청 echo fields(node_id, adapter, target, session_id)`는 `node_id`까지 요청 echo처럼 읽힐 수 있다. 다음 문서 손질 때 `node_id 및 요청 echo fields(adapter, target, session_id)`처럼 분리하면 더 정확하다.
|
||||
118
agent-task/15_node_command_docs_accuracy/plan_local_G03_0.log
Normal file
118
agent-task/15_node_command_docs_accuracy/plan_local_G03_0.log
Normal file
|
|
@ -0,0 +1,118 @@
|
|||
<!-- task=15_node_command_docs_accuracy plan=0 tag=DOCS -->
|
||||
|
||||
# Plan - DOCS
|
||||
|
||||
## 이 파일을 읽는 구현 에이전트에게
|
||||
|
||||
**필수: 구현 마지막에는 반드시 `CODE_REVIEW-local-G03.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 명령 출력으로 채운다.** 이 task는 Node README의 command 설명을 현재 구현과 맞추는 문서 보정이다. 구현 체크리스트와 review stub의 구현 체크리스트를 모두 완료하고, 중간/최종 검증 출력은 실제 stdout/stderr로 남긴다. review 파일의 `이 파일을 읽는 리뷰 에이전트에게` 아카이브 지시와 `코드리뷰 전용 체크리스트`는 코드리뷰 skill 전용이므로 구현 에이전트가 실행하거나 수정하지 않는다.
|
||||
|
||||
## 배경
|
||||
|
||||
`apps/node/README.md`의 Node Commands 설명 중 `CAPABILITIES`, `SESSION_LIST`, `TRANSPORT_STATUS`가 현재 구현보다 넓거나 다른 payload를 설명한다. 구현은 requested adapter의 capability map, CLI session string list, node 관점 connected/status echo fields를 반환한다. 문서만 바로잡아 구현 기대값을 명확히 한다.
|
||||
|
||||
## 의존 관계 및 구현 순서
|
||||
|
||||
- 선행 task 없음.
|
||||
- `agent-task/13_transport_idle_heartbeat`가 transport status payload를 바꾸면 이 task 완료 전 README 문구를 한 번 더 확인한다.
|
||||
- `agent-task/14_e2e_temp_workspace`, `agent-task/14+ops_command_smoke`와 병렬 진행 가능하다.
|
||||
|
||||
## 분석 결과
|
||||
|
||||
### 읽은 파일
|
||||
|
||||
- `apps/node/README.md`
|
||||
- `apps/edge/README.md`
|
||||
- `apps/node/internal/node/node.go`
|
||||
- `apps/node/internal/adapters/cli/cli.go`
|
||||
- `apps/edge/internal/opsconsole/status.go`
|
||||
|
||||
### 테스트 커버리지 공백
|
||||
|
||||
- 문서 보정이라 runtime test는 필요 없다.
|
||||
- stale wording search는 deterministic `rg --sort path`로 검증한다.
|
||||
|
||||
### 심볼 참조
|
||||
|
||||
- renamed/removed symbol 없음.
|
||||
|
||||
### 범위 결정 근거
|
||||
|
||||
- `apps/node/README.md`의 Node Commands section만 수정한다.
|
||||
- `apps/edge/README.md`는 현재 node command payload를 상세 설명하지 않으므로 변경하지 않는다.
|
||||
- proto comment와 generated files는 이번 문서 보정 범위가 아니다.
|
||||
|
||||
### 빌드 등급
|
||||
|
||||
- Build `local-G03`: 단일 문서 수정이며 코드/API 변경이 없다.
|
||||
- Review `local-G03`: stale wording search와 구현 대조만 필요하다.
|
||||
|
||||
## 구현 체크리스트
|
||||
|
||||
- [ ] [DOCS-1] `apps/node/README.md`의 Node Commands 설명을 현재 command result와 맞춘다.
|
||||
- [ ] 중간 검증과 최종 검증 명령을 모두 실행하고 실제 stdout/stderr를 CODE_REVIEW에 기록한다.
|
||||
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
|
||||
|
||||
### [DOCS-1] Node Commands 문구 보정
|
||||
|
||||
#### 문제
|
||||
|
||||
`apps/node/README.md:98-100`은 현재 구현과 다르게 설명한다. `CAPABILITIES`는 node 전체 adapter 목록이 아니라 requested adapter의 `adapter`, `targets`, `max_concurrency`를 반환한다(`apps/node/internal/node/node.go:208-231`). `SESSION_LIST`는 `(adapter, target, session_id)` tuple이 아니라 `persistent:target/session_id`, `codex-exec:target/session_id`, `opencode-sse:target/session_id` 문자열을 반환한다(`apps/node/internal/adapters/cli/cli.go:224-249`). `TRANSPORT_STATUS`는 heartbeat 상세가 아니라 `node_id`, `connected`, `adapter`, `target`, `session_id`를 반환한다(`apps/node/internal/node/node.go:246-265`).
|
||||
|
||||
Before:
|
||||
|
||||
```markdown
|
||||
<!-- apps/node/README.md:98 -->
|
||||
- `CAPABILITIES`: node가 노출하는 adapter 목록과 target/feature를 조회한다. adapter 실행 없이 node 자체 metadata만 응답한다.
|
||||
- `SESSION_LIST`: `(adapter, target, session_id)`로 관리되는 logical session 현황을 조회한다. persistent CLI adapter에서만 유의미한 결과가 나온다.
|
||||
- `TRANSPORT_STATUS`: edge-node transport 연결 상태(연결 여부, heartbeat 등)를 node 관점에서 조회한다.
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
```markdown
|
||||
- `CAPABILITIES`: 요청한 adapter의 capability를 조회한다. 현재 응답은 adapter 이름, target 목록, max_concurrency를 포함한다.
|
||||
- `SESSION_LIST`: CLI adapter가 관리하는 logical session 목록을 `mode:target/session_id` 문자열로 조회한다.
|
||||
- `TRANSPORT_STATUS`: node 관점의 edge 연결 여부와 요청 echo fields(node_id, adapter, target, session_id)를 조회한다. heartbeat 상세 카운터는 현재 응답에 포함되지 않는다.
|
||||
```
|
||||
|
||||
#### 해결 방법
|
||||
|
||||
- `apps/node/README.md`의 세 bullet만 바꾼다.
|
||||
- "heartbeat 등" 같은 구현되지 않은 세부값 표현을 제거한다.
|
||||
- `USAGE_STATUS` 설명은 현재 구현과 맞으므로 유지한다.
|
||||
|
||||
#### 수정 파일 및 체크리스트
|
||||
|
||||
- [ ] `apps/node/README.md` line 98 `CAPABILITIES` 설명 수정
|
||||
- [ ] `apps/node/README.md` line 99 `SESSION_LIST` 설명 수정
|
||||
- [ ] `apps/node/README.md` line 100 `TRANSPORT_STATUS` 설명 수정
|
||||
|
||||
#### 테스트 작성
|
||||
|
||||
- 추가 test 작성 없음. 문서 변경이며 stale wording search로 검증한다.
|
||||
|
||||
#### 중간 검증
|
||||
|
||||
```bash
|
||||
if rg --sort path -n "adapter 목록|heartbeat 등|\\(adapter, target, session_id\\)" apps/node/README.md; then exit 1; fi
|
||||
```
|
||||
|
||||
Expected: command exits 0 with no stale wording output.
|
||||
|
||||
## 수정 파일 요약
|
||||
|
||||
| 파일 | 항목 |
|
||||
|------|------|
|
||||
| `apps/node/README.md` | DOCS-1 |
|
||||
| `agent-task/15_node_command_docs_accuracy/CODE_REVIEW-local-G03.md` | evidence 기록 |
|
||||
|
||||
## 최종 검증
|
||||
|
||||
```bash
|
||||
if rg --sort path -n "adapter 목록|heartbeat 등|\\(adapter, target, session_id\\)" apps/node/README.md; then exit 1; fi
|
||||
git diff --check
|
||||
```
|
||||
|
||||
Expected: stale wording search exits 0 with no output. `git diff --check` exits 0.
|
||||
|
||||
모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
|
||||
14
apps/edge/internal/transport/heartbeat_test.go
Normal file
14
apps/edge/internal/transport/heartbeat_test.go
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
package transport
|
||||
|
||||
import "testing"
|
||||
|
||||
// TestHeartbeatWaitExceedsInterval guards the edge-side invariant. Even though
|
||||
// the library now self-heals stale wait timers (proto-socket base_client.go,
|
||||
// wait-timer state check), keeping wait > interval gives the peer's next
|
||||
// heartbeat an extra chance to clear the stray timer before it fires, which
|
||||
// keeps idle traffic stable on slow links. Mirror of the node-side test.
|
||||
func TestHeartbeatWaitExceedsInterval(t *testing.T) {
|
||||
if heartbeatWaitSec <= heartbeatIntervalSec {
|
||||
t.Fatalf("heartbeatWaitSec (%d) must exceed heartbeatIntervalSec (%d)", heartbeatWaitSec, heartbeatIntervalSec)
|
||||
}
|
||||
}
|
||||
|
|
@ -18,7 +18,9 @@ import (
|
|||
|
||||
const (
|
||||
heartbeatIntervalSec = 30
|
||||
heartbeatWaitSec = 10
|
||||
// heartbeatWaitSec mirrors the node side. See the comment in
|
||||
// apps/node/internal/transport/client.go for rationale.
|
||||
heartbeatWaitSec = 45
|
||||
)
|
||||
|
||||
func edgeParserMap() toki.ParserMap {
|
||||
|
|
|
|||
|
|
@ -95,9 +95,9 @@ node는 adapter execution(`RunRequest`) 외에도 edge가 보내는 `NodeCommand
|
|||
- `USAGE_STATUS`: 선택된 `adapter/target` (예: `cli/codex`)의 사용량 한도와 초기화 시간을 조회한다.
|
||||
- Codex의 경우 TUI를 시작하고 `/status` 명령을 전송한 뒤 출력된 `% left` 정보를 파싱해 `AgentUsageStatus`로 반환한다.
|
||||
- 그 외 adapter/target은 지원하지 않는 경우 명시적 에러를 반환한다.
|
||||
- `CAPABILITIES`: node가 노출하는 adapter 목록과 target/feature를 조회한다. adapter 실행 없이 node 자체 metadata만 응답한다.
|
||||
- `SESSION_LIST`: `(adapter, target, session_id)`로 관리되는 logical session 현황을 조회한다. persistent CLI adapter에서만 유의미한 결과가 나온다.
|
||||
- `TRANSPORT_STATUS`: edge-node transport 연결 상태(연결 여부, heartbeat 등)를 node 관점에서 조회한다.
|
||||
- `CAPABILITIES`: 요청한 adapter의 capability를 조회한다. 현재 응답은 adapter 이름, target 목록, max_concurrency를 포함한다.
|
||||
- `SESSION_LIST`: CLI adapter가 관리하는 logical session 목록을 `mode:target/session_id` 문자열로 조회한다.
|
||||
- `TRANSPORT_STATUS`: node 관점의 edge 연결 여부와 요청 echo fields(node_id, adapter, target, session_id)를 조회한다. heartbeat 상세 카운터는 현재 응답에 포함되지 않는다.
|
||||
|
||||
## 어댑터
|
||||
|
||||
|
|
|
|||
|
|
@ -15,8 +15,13 @@ import (
|
|||
|
||||
const (
|
||||
heartbeatIntervalSec = 30
|
||||
heartbeatWaitSec = 10
|
||||
registerTimeout = 10 * time.Second
|
||||
// heartbeatWaitSec is kept above heartbeatIntervalSec as defence in depth:
|
||||
// the library wait-timer callback already self-heals stale state (see
|
||||
// proto-socket go/base_client.go sendHeartBeat), but a larger wait window
|
||||
// gives the peer's next heartbeat an extra chance to overwrite any stray
|
||||
// timer on slow or jittery links before it fires.
|
||||
heartbeatWaitSec = 45
|
||||
registerTimeout = 10 * time.Second
|
||||
)
|
||||
|
||||
// RegisterResult is returned by DialEdge after successful registration.
|
||||
|
|
|
|||
169
apps/node/internal/transport/heartbeat_test.go
Normal file
169
apps/node/internal/transport/heartbeat_test.go
Normal file
|
|
@ -0,0 +1,169 @@
|
|||
package transport
|
||||
|
||||
import (
|
||||
"context"
|
||||
"net"
|
||||
"strconv"
|
||||
"sync/atomic"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
toki "git.toki-labs.com/toki/common-proto-socket/go"
|
||||
"google.golang.org/protobuf/proto"
|
||||
|
||||
iop "iop/proto/gen/iop"
|
||||
)
|
||||
|
||||
// TestHeartbeatSurvivesIdleAfterNodeCommand validates that, after a RegisterRequest
|
||||
// and NodeCommandRequest round-trip, both edge and node TcpClients stay alive across
|
||||
// multiple heartbeat intervals of idle traffic. This guards against the heartbeat
|
||||
// timeout regression reproduced in agent-task/12 (real Gemini idle).
|
||||
func TestHeartbeatSurvivesIdleAfterNodeCommand(t *testing.T) {
|
||||
// 1s interval, 2s wait — wait > interval mirrors the production ratio
|
||||
// (interval 30s, wait 45s) at a faster test timescale. The library-level
|
||||
// wait-timer state check (proto-socket base_client.go) is the primary
|
||||
// defence against false heartbeat_timeout; this go-iop test exercises the
|
||||
// idle path end-to-end through DialTcp + NodeCommandRequest round-trip.
|
||||
const (
|
||||
intervalSec = 1
|
||||
waitSec = 2
|
||||
idleWindow = 5 * time.Second
|
||||
)
|
||||
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 7*time.Second)
|
||||
defer cancel()
|
||||
|
||||
listenAddr := freeAddr(t)
|
||||
host, portStr, _ := net.SplitHostPort(listenAddr)
|
||||
port, _ := strconv.Atoi(portStr)
|
||||
|
||||
// Mock edge server with 1s/1s heartbeat.
|
||||
acceptedCh := make(chan *toki.TcpClient, 1)
|
||||
server := toki.NewTcpServer(host, port, func(conn net.Conn) *toki.TcpClient {
|
||||
client := toki.NewTcpClient(conn, intervalSec, waitSec, heartbeatTestEdgeParserMap())
|
||||
toki.AddRequestListenerTyped[*iop.RegisterRequest, *iop.RegisterResponse](
|
||||
&client.Communicator,
|
||||
func(req *iop.RegisterRequest) (*iop.RegisterResponse, error) {
|
||||
return &iop.RegisterResponse{
|
||||
Accepted: true,
|
||||
NodeId: "hb-node",
|
||||
Alias: "hb-alias",
|
||||
}, nil
|
||||
},
|
||||
)
|
||||
acceptedCh <- client
|
||||
return client
|
||||
})
|
||||
if err := server.Start(ctx); err != nil {
|
||||
t.Fatalf("start server: %v", err)
|
||||
}
|
||||
defer server.Stop()
|
||||
|
||||
// Node client with 1s/1s heartbeat. We bypass DialEdge to allow custom intervals
|
||||
// while keeping the rest of the node parser map / wire format identical.
|
||||
nodeClient, err := toki.DialTcp(ctx, host, port, intervalSec, waitSec, nodeParserMap())
|
||||
if err != nil {
|
||||
t.Fatalf("dial: %v", err)
|
||||
}
|
||||
defer nodeClient.Close()
|
||||
|
||||
resp, err := toki.SendRequestTyped[*iop.RegisterRequest, *iop.RegisterResponse](
|
||||
&nodeClient.Communicator,
|
||||
&iop.RegisterRequest{Token: "hb-token"},
|
||||
2*time.Second,
|
||||
)
|
||||
if err != nil {
|
||||
t.Fatalf("register: %v", err)
|
||||
}
|
||||
if !resp.GetAccepted() {
|
||||
t.Fatalf("register rejected: %s", resp.GetReason())
|
||||
}
|
||||
|
||||
edgeClient := waitForHeartbeatTestClient(t, acceptedCh)
|
||||
|
||||
// NodeCommandRequest handler on node side, request driven from edge.
|
||||
var cmdCount atomic.Int32
|
||||
toki.AddRequestListenerTyped[*iop.NodeCommandRequest, *iop.NodeCommandResponse](
|
||||
&nodeClient.Communicator,
|
||||
func(req *iop.NodeCommandRequest) (*iop.NodeCommandResponse, error) {
|
||||
cmdCount.Add(1)
|
||||
return &iop.NodeCommandResponse{RequestId: req.GetRequestId()}, nil
|
||||
},
|
||||
)
|
||||
|
||||
cmdResp, err := toki.SendRequestTyped[*iop.NodeCommandRequest, *iop.NodeCommandResponse](
|
||||
&edgeClient.Communicator,
|
||||
&iop.NodeCommandRequest{RequestId: "cmd-1", Type: iop.NodeCommandType_NODE_COMMAND_TYPE_USAGE_STATUS},
|
||||
2*time.Second,
|
||||
)
|
||||
if err != nil {
|
||||
t.Fatalf("node command: %v", err)
|
||||
}
|
||||
if cmdResp.GetRequestId() != "cmd-1" {
|
||||
t.Fatalf("cmd response id: %q", cmdResp.GetRequestId())
|
||||
}
|
||||
|
||||
// Idle window: span several heartbeat intervals with no app traffic.
|
||||
deadline := time.Now().Add(idleWindow)
|
||||
for time.Now().Before(deadline) {
|
||||
time.Sleep(200 * time.Millisecond)
|
||||
if !nodeClient.IsAlive() {
|
||||
t.Fatalf("node client died during idle window after %v", time.Since(deadline.Add(-idleWindow)))
|
||||
}
|
||||
if !edgeClient.IsAlive() {
|
||||
t.Fatalf("edge client died during idle window after %v", time.Since(deadline.Add(-idleWindow)))
|
||||
}
|
||||
}
|
||||
|
||||
if !nodeClient.IsAlive() {
|
||||
t.Fatal("node client not alive after idle window")
|
||||
}
|
||||
if !edgeClient.IsAlive() {
|
||||
t.Fatal("edge client not alive after idle window")
|
||||
}
|
||||
}
|
||||
|
||||
func freeAddr(t *testing.T) string {
|
||||
t.Helper()
|
||||
l, err := net.Listen("tcp", "127.0.0.1:0")
|
||||
if err != nil {
|
||||
t.Fatalf("listen: %v", err)
|
||||
}
|
||||
addr := l.Addr().String()
|
||||
l.Close()
|
||||
return addr
|
||||
}
|
||||
|
||||
func waitForHeartbeatTestClient(t *testing.T, ch <-chan *toki.TcpClient) *toki.TcpClient {
|
||||
t.Helper()
|
||||
select {
|
||||
case c := <-ch:
|
||||
return c
|
||||
case <-time.After(2 * time.Second):
|
||||
t.Fatal("server did not accept connection")
|
||||
return nil
|
||||
}
|
||||
}
|
||||
|
||||
// TestHeartbeatWaitExceedsInterval guards the invariant that protects against the
|
||||
// library's sendHeartBeat race: the wait timer can be installed even after the
|
||||
// heartbeat response was already processed, so the peer's next heartbeat (one
|
||||
// interval later) must arrive before the stray wait timer fires.
|
||||
func TestHeartbeatWaitExceedsInterval(t *testing.T) {
|
||||
if heartbeatWaitSec <= heartbeatIntervalSec {
|
||||
t.Fatalf("heartbeatWaitSec (%d) must exceed heartbeatIntervalSec (%d)", heartbeatWaitSec, heartbeatIntervalSec)
|
||||
}
|
||||
}
|
||||
|
||||
func heartbeatTestEdgeParserMap() toki.ParserMap {
|
||||
return toki.ParserMap{
|
||||
toki.TypeNameOf(&iop.RegisterRequest{}): func(b []byte) (proto.Message, error) {
|
||||
m := &iop.RegisterRequest{}
|
||||
return m, proto.Unmarshal(b, m)
|
||||
},
|
||||
toki.TypeNameOf(&iop.NodeCommandResponse{}): func(b []byte) (proto.Message, error) {
|
||||
m := &iop.NodeCommandResponse{}
|
||||
return m, proto.Unmarshal(b, m)
|
||||
},
|
||||
}
|
||||
}
|
||||
|
|
@ -34,6 +34,8 @@ nodes:
|
|||
- id: test-node
|
||||
alias: test-node
|
||||
token: test-token
|
||||
runtime:
|
||||
workspace_root: "$TMP_DIR/workspace"
|
||||
adapters:
|
||||
mock:
|
||||
enabled: true
|
||||
|
|
@ -51,6 +53,7 @@ console:
|
|||
EOF
|
||||
else
|
||||
echo "[e2e] preparing real profile smoke test (profile: $PROFILE)..."
|
||||
TARGET="$PROFILE"
|
||||
PROFILE_BLOCK=$(awk -v profile="$PROFILE" '
|
||||
$0 ~ "^[[:space:]]+"profile":" {
|
||||
found=1;
|
||||
|
|
@ -91,6 +94,8 @@ nodes:
|
|||
- id: test-node
|
||||
alias: test-node
|
||||
token: test-token
|
||||
runtime:
|
||||
workspace_root: "$TMP_DIR/workspace"
|
||||
adapters:
|
||||
cli:
|
||||
enabled: true
|
||||
|
|
@ -147,11 +152,14 @@ STRICT_PROMPT="Reply with exactly 'OK' and do not inspect files or use any tools
|
|||
|
||||
sleep 3
|
||||
send_cmd "/nodes"
|
||||
send_cmd "/capabilities"
|
||||
send_cmd "/transport"
|
||||
send_cmd "$STRICT_PROMPT"
|
||||
send_cmd "/session session2"
|
||||
send_cmd "/background on"
|
||||
send_cmd "Reply with exactly 'OK' again."
|
||||
send_cmd "/background off"
|
||||
send_cmd "/sessions"
|
||||
|
||||
if [ "$IS_PERSISTENT" -eq 1 ]; then
|
||||
send_cmd "/terminate-session"
|
||||
|
|
@ -208,6 +216,17 @@ check_grep() {
|
|||
fi
|
||||
}
|
||||
|
||||
check_no_grep() {
|
||||
local pattern="$1"
|
||||
local file="$2"
|
||||
local msg="$3"
|
||||
if grep -q "$pattern" "$file"; then
|
||||
echo "[e2e] FAIL: $msg (found pattern: '$pattern')"
|
||||
grep "$pattern" "$file"
|
||||
FAIL=1
|
||||
fi
|
||||
}
|
||||
|
||||
check_fail_markers() {
|
||||
local file="$1"
|
||||
# Strict failure detection for system/console errors
|
||||
|
|
@ -223,6 +242,18 @@ check_grep "test-node" "$EDGE_OUT" "node registration not found"
|
|||
check_grep "start run_id=" "$EDGE_OUT" "run start not found"
|
||||
check_grep "complete run_id=" "$EDGE_OUT" "run completion not found"
|
||||
|
||||
check_grep "\\[node-test-node-capabilities\\]" "$EDGE_OUT" "/capabilities output not found"
|
||||
check_grep "targets = ${TARGET}" "$EDGE_OUT" "/capabilities targets not found"
|
||||
check_grep "\\[node-test-node-transport\\]" "$EDGE_OUT" "/transport output not found"
|
||||
check_grep "connected = true" "$EDGE_OUT" "/transport connected status not found"
|
||||
check_grep "\\[node-test-node-sessions\\]" "$EDGE_OUT" "/sessions output not found"
|
||||
|
||||
if [ "$IS_PERSISTENT" -eq 1 ]; then
|
||||
check_grep "persistent:${TARGET}/session2" "$EDGE_OUT" "/sessions entry for session2 not found"
|
||||
fi
|
||||
|
||||
check_no_grep 'file:iop.db?cache=shared&mode=rwc' "$NODE_OUT" "node store used repo-root fallback dsn"
|
||||
|
||||
if [ "$IS_PERSISTENT" -eq 1 ]; then
|
||||
check_grep "terminated session" "$EDGE_OUT" "/terminate-session success not found"
|
||||
fi
|
||||
|
|
|
|||
Loading…
Reference in a new issue