toki
6e2a1fc2f2
- Add edge runtime config and opsconsole package - Refactor edge console to use new runtime config - Add service source metadata support - Update CLI adapter with target terminology - Add edge operation contract and event bus replay - Update node label and command ops surface - Add E2E smoke tests and full validation - Update proto runtime definitions - Update documentation and agent-ops rules
106 lines
4.3 KiB
Text
106 lines
4.3 KiB
Text
<!-- task=09_ops_console_docs plan=5 tag=REVIEW_REVIEW_REVIEW_REVIEW_REVIEW_OCD -->
|
|
|
|
# 09 Ops Console Docs Follow-up Plan - REVIEW_REVIEW_REVIEW_REVIEW_REVIEW_OCD
|
|
|
|
## 이 파일을 읽는 구현 에이전트에게
|
|
|
|
**필수: 구현 마지막에는 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다.**
|
|
이 follow-up은 review 파일의 최종 검증 기록만 다룬다. README, docs, apps/edge README 본문은 새로 수정하지 않는다. review 파일의 아카이브 지시와 `코드리뷰 전용 체크리스트`는 코드리뷰 에이전트 전용이므로 수정하거나 체크하지 않는다.
|
|
|
|
## 배경
|
|
|
|
plan 4 구현은 본문 상태와 대부분의 검증 기록을 맞췄지만, 최종 검증에서 fixed command에 없는 `--no-heading` 옵션을 추가했고 `docs/architecture.md:53` 출력 한 줄을 실제 stdout과 다르게 기록했다.
|
|
|
|
## 분석 결과
|
|
|
|
### 읽은 파일
|
|
|
|
- `agent-ops/rules/project/rules.md`
|
|
- `agent-ops/skills/common/code-review/SKILL.md`
|
|
- `README.md`
|
|
- `docs/architecture.md`
|
|
- `apps/edge/README.md`
|
|
- `agent-task/09_ops_console_docs/plan_cloud_G07_4.log`
|
|
- `agent-task/09_ops_console_docs/code_review_cloud_G07_4.log`
|
|
|
|
### 테스트 커버리지 공백
|
|
|
|
- Review 기록 fidelity는 Go unit test가 커버하지 않는다.
|
|
- exact command 재실행 출력과 review 파일 기록을 대조한다.
|
|
|
|
### 심볼 참조
|
|
|
|
- 코드 심볼 rename은 없다.
|
|
|
|
### 범위 결정 근거
|
|
|
|
- README/docs/apps/edge README 본문은 새로 수정하지 않는다.
|
|
- 최종 검증 기록만 fixed command와 실제 stdout/stderr에 맞춘다.
|
|
|
|
### 빌드 등급
|
|
|
|
- Build `cloud-G07`: verification trust failure follow-up.
|
|
- Review `cloud-G07`: exact output fidelity 확인이 필요하다.
|
|
|
|
## 구현 체크리스트
|
|
|
|
- [ ] `CODE_REVIEW-cloud-G07.md`의 최종 검증 명령을 plan의 fixed command와 동일하게 기록한다.
|
|
- [ ] `docs/architecture.md:53` 출력 줄을 실제 stdout과 동일하게 기록한다.
|
|
- [ ] README/docs/apps/edge README 본문을 새로 수정하지 않는다.
|
|
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
|
|
|
|
### [REVIEW_REVIEW_REVIEW_REVIEW_REVIEW_OCD-1] 최종 검증 기록을 fixed command와 실제 출력에 맞춤
|
|
|
|
#### 문제
|
|
|
|
`code_review_cloud_G07_4.log`에서 final verification command가 plan의 fixed command와 달리 `--no-heading`을 포함한다. 또한 `docs/architecture.md:53` 출력이 실제 stdout과 다르다.
|
|
|
|
#### 해결 방법
|
|
|
|
새 `CODE_REVIEW-cloud-G07.md`에는 아래 명령을 옵션 변경 없이 그대로 실행한 결과를 기록한다.
|
|
|
|
```bash
|
|
git diff --check -- README.md docs/architecture.md apps/edge/README.md
|
|
rg --sort path -n "Policy/Config|Job/Worker|Audit, Metrics/Event" README.md
|
|
rg --sort path -n "Web Portal|IOP Portal" README.md docs apps/edge
|
|
rg --sort path -n "임시 디버그|temporary debug|임시 수동 테스트 UI" README.md docs apps/edge
|
|
rg --sort path -n "ops console|cli adapter|edge-local" README.md docs apps/edge
|
|
go build ./...
|
|
```
|
|
|
|
No-match `rg`는 `(no output, exit code 1 - no matches)`로 적고, match가 있는 `rg`는 실제 `path:line:text` 형식을 그대로 붙여 넣는다.
|
|
|
|
#### 수정 파일 및 체크리스트
|
|
|
|
- [ ] `CODE_REVIEW-cloud-G07.md`
|
|
|
|
#### 테스트 작성
|
|
|
|
- 별도 테스트 없음. review 기록 자체가 검증 대상이다.
|
|
|
|
#### 중간 검증
|
|
|
|
```bash
|
|
rg --sort path -n "HTTP/API to central|--no-heading" agent-task/09_ops_console_docs/CODE_REVIEW-cloud-G07.md
|
|
```
|
|
|
|
Expected: no output.
|
|
|
|
## 수정 파일 요약
|
|
|
|
| 파일 | 항목 |
|
|
|---|---|
|
|
| `CODE_REVIEW-cloud-G07.md` | REVIEW_REVIEW_REVIEW_REVIEW_REVIEW_OCD-1 |
|
|
|
|
## 최종 검증
|
|
|
|
```bash
|
|
git diff --check -- README.md docs/architecture.md apps/edge/README.md
|
|
rg --sort path -n "Policy/Config|Job/Worker|Audit, Metrics/Event" README.md
|
|
rg --sort path -n "Web Portal|IOP Portal" README.md docs apps/edge
|
|
rg --sort path -n "임시 디버그|temporary debug|임시 수동 테스트 UI" README.md docs apps/edge
|
|
rg --sort path -n "ops console|cli adapter|edge-local" README.md docs apps/edge
|
|
go build ./...
|
|
```
|
|
|
|
모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
|