<!-- task=m-operation-event-outbox plan=0 tag=TEST -->

# Plan - TEST: event-store DB 검증

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

`CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채우는 것이 필수 마지막 단계다. 검증 명령을 실제로 실행하고, 실제 출력과 판단을 리뷰 스텁에 기록한 뒤 active 파일을 그대로 두고 리뷰 준비를 보고한다. 사용자 결정, 사용자 소유 외부 환경, secret, 서비스 준비, 또는 범위 충돌 없이는 안전하게 진행할 수 없으면 리뷰 스텁의 `사용자 리뷰 요청` 섹션에 정확한 근거와 재개 조건을 기록하고 멈춘다. 구현 중 사용자에게 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하거나, `USER_REVIEW.md`, `complete.log`, archive log를 만들지 않는다. 명령 재실행이나 증거 수집으로 닫을 수 있는 검증 공백은 사용자 리뷰 요청이 아니다.

## 배경

현재 마일스톤의 outbox 에픽에서 남은 항목은 `[event-store]` 하나다. 구현과 테스트 케이스는 이미 `services/core/internal/storage`와 migration에 존재하지만, 현재 세션에서는 `GITO_TEST_DATABASE_URL`이 없어 DB-backed 테스트가 `SKIP`되었다. 이 계획은 DB가 준비된 runner에서 fresh 검증을 수행해 event order와 publish retry 상태 증거를 확보하고, PASS 시 roadmap Task 완료 anchor를 제공한다.

## 사용자 리뷰 요청 흐름

구현 중 차단 사유는 active `CODE_REVIEW-*-G??.md`의 `사용자 리뷰 요청` 섹션에 기록한다. 직접 사용자 프롬프트는 금지이며, code-review가 요청의 정당성을 검증하고 실제 `USER_REVIEW.md` 작성 여부를 결정한다.

## Roadmap Targets

- Milestone: `agent-roadmap/phase/control-plane-foundation/milestones/operation-event-outbox.md`
- Task ids:
  - `event-store`: event append/list/mark-published boundary를 만든다. 검증: event order와 retry 가능한 publish 상태를 확인한다.
- Completion mode: check-on-pass

## 분석 결과

### 읽은 파일

- `agent-ops/rules/project/rules.md`
- `agent-ops/rules/common/rules-roadmap.md`
- `agent-ops/skills/common/router.md`
- `agent-ops/skills/common/analyze-roadmap-position/SKILL.md`
- `agent-ops/skills/common/plan/SKILL.md`
- `agent-ops/skills/common/_templates/roadmap-position-report-template.md`
- `agent-ops/skills/common/_templates/implementation-user-review-request-section.md`
- `agent-ops/rules/project/domain/core/rules.md`
- `agent-ops/rules/project/domain/workspace-ops/rules.md`
- `agent-test/local/rules.md`
- `agent-test/local/core-smoke.md`
- `agent-test/local/workspace-ops-smoke.md`
- `agent-roadmap/current.md`
- `agent-roadmap/ROADMAP.md`
- `agent-roadmap/phase/control-plane-foundation/PHASE.md`
- `agent-roadmap/phase/control-plane-foundation/milestones/operation-event-outbox.md`
- `.gitignore`
- `services/core/internal/storage/storage.go`
- `services/core/internal/storage/postgres.go`
- `services/core/internal/storage/postgres_test.go`
- `services/core/migrations/00001_initial.sql`

### 테스트 환경 규칙

- `test_env`: `local`.
- `agent-test/local/rules.md`는 존재하며 읽었다. local 기준은 standard remote runner이지만, 현재 확인에서 `toki@toki-labs.com:$HOME/agent-work/gito` checkout은 없었다.
- 매칭 프로필: `agent-test/local/core-smoke.md`, `agent-test/local/workspace-ops-smoke.md`.
- core-smoke 적용 명령: core 필수 검증은 `cd services/core && go test ./...`; storage behavior는 해당 동작 테스트 또는 차단 사유가 필요하다.
- workspace-ops 적용 명령: task artifact 변경은 `git diff --check`로 확인한다.
- 현재 세션에서 `GITO_TEST_DATABASE_URL`은 설정되지 않았고 Docker/Postgres 바이너리도 없어 DB-backed 검증은 완료하지 못했다.
- 실행된 사전 검증: `cd services/core && go test ./internal/storage -run TestPostgresOperationEventStoreAppendsListsMarksPublishedAndValidates -count=1 -v`는 `GITO_TEST_DATABASE_URL not set`으로 `SKIP`; `cd services/core && go test ./...`는 PASS지만 Postgres integration은 skip 상태다.

### 테스트 커버리지 공백

- `[event-store]` append/list/mark-published: `TestPostgresOperationEventStoreAppendsListsMarksPublishedAndValidates`가 order, pending retry 상태, `MarkPublished`, invalid payload/field를 커버한다. 공백은 DB 환경에서 실제 PASS 증거가 아직 없다는 점이다.
- source/migration 변경은 이 계획에서 하지 않는다.

### 심볼 참조

- none. 이 계획은 symbol rename/remove를 하지 않는다.

### 분할 판단

- split decision policy를 계획 파일 선택 전에 평가했다.
- 단일 계획을 사용한다. 변경 대상은 한 마일스톤 Task의 DB-backed 검증 하나이고, source API/foundation과 call-site rollout 경계가 없다.
- 도메인 경계는 core 검증과 workspace task artifact뿐이며, 코드 변경 없이 검증 증거를 수집하는 일이라 별도 subtask로 나누면 coordination overhead만 생긴다.
- 선행 split dependency는 없다.

### 범위 결정 근거

- 제외: `services/core/internal/storage/postgres.go`, `storage.go`, `postgres_test.go`, `migrations/00001_initial.sql`의 코드 수정.
- 제외: Redis Streams, provider projection, Flutter UI, distributed scheduler.
- 제외: roadmap 직접 체크. PASS 후 roadmap 업데이트는 `m-operation-event-outbox` 완료 이벤트를 읽는 런타임 책임이다.

### 빌드 등급

- `local-G04`: 구현 변경은 없고 검증 범위가 작지만, DB-backed integration 환경과 skip 방지 확인이 필요하다.

## 구현 체크리스트

- [ ] `GITO_TEST_DATABASE_URL`이 설정되어 있음을 값 출력 없이 확인한다.
- [ ] `TestPostgresOperationEventStoreAppendsListsMarksPublishedAndValidates`를 `-count=1 -v`로 실행하고 `PASS`이며 `SKIP`이 아님을 기록한다.
- [ ] `cd services/core && test -n "$GITO_TEST_DATABASE_URL" && go test ./... -count=1`로 core 전체 fresh 검증을 실행한다.
- [ ] DB 환경이 없어서 검증할 수 없으면 `CODE_REVIEW-*-G??.md`의 `사용자 리뷰 요청`에 실행 명령, 실제 출력, 필요한 준비 조건을 기록한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.

### [TEST-1] event-store DB 검증

#### 문제

`agent-roadmap/phase/control-plane-foundation/milestones/operation-event-outbox.md:48`의 `[event-store]`는 구현 체크가 아직 남아 있다. `services/core/internal/storage/postgres.go:881`부터 `AppendEvent`, `ListEvents`, `ListPendingEvents`, `MarkPublished`가 구현되어 있고, `services/core/internal/storage/postgres_test.go:744`에 검증 테스트가 있으나 현재 세션에서는 DB 환경 부재로 skip되었다.

#### 해결 방법

소스 코드는 수정하지 않는다. DB가 준비된 환경에서 아래 테스트를 fresh 실행하고, 출력에 `--- PASS: TestPostgresOperationEventStoreAppendsListsMarksPublishedAndValidates`가 있으며 `SKIP`이 없음을 리뷰 스텁에 기록한다.

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

- [ ] `services/core/internal/storage/postgres.go`: 수정 없음, 검증 대상만 확인.
- [ ] `services/core/internal/storage/postgres_test.go`: 수정 없음, 기존 DB-backed 테스트 실행.
- [ ] `services/core/migrations/00001_initial.sql`: 수정 없음, migration이 `operation_events` table/index를 제공하는지 검증 대상에 포함.
- [ ] `agent-task/m-operation-event-outbox/CODE_REVIEW-local-G03.md`: 실제 검증 출력 기록.

#### 테스트 작성

추가 테스트는 작성하지 않는다. 기존 `TestPostgresOperationEventStoreAppendsListsMarksPublishedAndValidates`가 event order, pending publish retry 상태, mark-published, invalid input을 직접 검증한다.

#### 중간 검증

```bash
cd services/core && test -n "$GITO_TEST_DATABASE_URL" && go test ./internal/storage -run TestPostgresOperationEventStoreAppendsListsMarksPublishedAndValidates -count=1 -v
```

기대 결과: exit 0, `--- PASS: TestPostgresOperationEventStoreAppendsListsMarksPublishedAndValidates`, `SKIP` 없음.

## 수정 파일 요약

| 파일 | 항목 |
| --- | --- |
| `agent-task/m-operation-event-outbox/PLAN-local-G04.md` | TEST-1 |
| `agent-task/m-operation-event-outbox/CODE_REVIEW-local-G03.md` | TEST-1 |

## 최종 검증

```bash
cd services/core && test -n "$GITO_TEST_DATABASE_URL" && go test ./... -count=1
```

기대 결과: exit 0. DB-backed storage tests가 skip 없이 실행되어야 한다.
모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
