# task-2451 Phase 1 검증 결과 — Thor (개발2팀 백엔드)

**검증일**: 2026-05-05  
**검증 대상**: /home/jay/workspace/scripts/taskctl.py (task-2449 산출, mergeCommit cef642c7)  
**브랜치**: task/task-2451-dev2  
**원칙**: 코드 0 변경, scripts/ 수정 절대 금지, 검증만

---

## Fix 1: 정상 흐름 검증

### Case 정상-1: init → dispatch → ack → run → pr-open

**명령**: `python3 scripts/taskctl.py init task-test-routing-001` 외 순차 실행

#### 정상-1-A: init
**명령**: `python3 scripts/taskctl.py init task-test-routing-001`
**stdout**:
```
[taskctl] init task-test-routing-001 → CREATED (/home/jay/workspace/.tasks/state/task-test-routing-001.json)
```
**stderr**:
```
(없음)
```
**exit code**: 0
**기대값**: exit 0, CREATED 상태 생성
**실제 결과**: exit 0, CREATED 상태 파일 생성 정상
**판정**: PASS (기대 일치)

#### 정상-1-B: dispatch
**명령**: `python3 scripts/taskctl.py dispatch task-test-routing-001`
**stdout**:
```
[taskctl] task-test-routing-001: → DISPATCHED
```
**stderr**:
```
(없음)
```
**exit code**: 0
**기대값**: exit 0, DISPATCHED 전이
**실제 결과**: exit 0, DISPATCHED 정상 전이
**판정**: PASS (기대 일치)

#### 정상-1-C: ack
**명령**: `python3 scripts/taskctl.py ack task-test-routing-001`
**stdout**:
```
[taskctl] task-test-routing-001: → ACKED
```
**stderr**:
```
(없음)
```
**exit code**: 0
**기대값**: exit 0, ACKED 전이
**실제 결과**: exit 0, ACKED 정상 전이
**판정**: PASS (기대 일치)

#### 정상-1-D: run
**명령**: `python3 scripts/taskctl.py run task-test-routing-001`
**stdout**:
```
[taskctl] task-test-routing-001: → RUNNING
```
**stderr**:
```
(없음)
```
**exit code**: 0
**기대값**: exit 0, RUNNING 전이
**실제 결과**: exit 0, RUNNING 정상 전이
**판정**: PASS (기대 일치)

---

### Case 정상-2: pr-open → status

#### 정상-2-A: pr-open
**명령**: `python3 scripts/taskctl.py pr-open task-test-routing-001 --pr 9999`
**stdout**:
```
[taskctl] task-test-routing-001: → PR_OPEN (PR #9999)
```
**stderr**:
```
(없음)
```
**exit code**: 0
**기대값**: exit 0, PR_OPEN 전이, PR 번호 기록
**실제 결과**: exit 0, PR_OPEN 정상 전이, PR #9999 기록
**판정**: PASS (기대 일치)

#### 정상-2-B: status
**명령**: `python3 scripts/taskctl.py status task-test-routing-001`
**stdout**:
```
task: task-test-routing-001
state: PR_OPEN
transitions: 5
branch: None
pr: 9999
guard_sh: None
qc_report_guard: None
human_approved: False
bypass: {'used': False, 'ts': None, 'actor': None}
```
**stderr**:
```
(없음)
```
**exit code**: 0
**기대값**: 현재 상태 출력
**실제 결과**: exit 0, PR_OPEN 상태 정상 출력
**판정**: PASS (기대 일치)

---

### Case 정상-3: verify → approve

#### 정상-3-A: verify
**명령**: `python3 scripts/taskctl.py verify task-test-routing-001`
**stdout**:
```
[taskctl] task-test-routing-001: verify FAIL [guard.sh=FAIL, qc_report_guard=FAIL]
```
**stderr**:
```
(없음)
```
**exit code**: 1
**기대값**: 정상 흐름이라면 exit 0, GUARD_PASS 전이
**실제 결과**: exit 1, FAIL
- guard.sh 실패 이유: "capability snapshot 없음, task 파일도 없음: /home/jay/workspace/memory/tasks/task-test-routing-001.md"
- qc_report_guard 실패 이유: "qc-result 파일 없음: /home/jay/workspace/memory/events/task-test-routing-001.qc-result"
- 테스트 더미 task-id에 대한 운영 파일(capability snapshot, qc-result)이 없어 구조적으로 FAIL

**판정**: FAIL (이유: 더미 task-id `task-test-routing-001`에는 실제 운영 파일 없음. guard.sh와 qc_report_guard 모두 task 파일 존재 여부 검증 — 이는 코드베이스 예상 동작이나, 정상 흐름 검증 목적상 GUARD_PASS 달성 불가)

#### 정상-3-B: approve
**명령**: `python3 scripts/taskctl.py approve task-test-routing-001`
**stdout**:
```
(없음)
```
**stderr**:
```
[taskctl] approve 불가: 현재 상태=PR_OPEN (GUARD_PASS 필요)
```
**exit code**: 1
**기대값**: 정상 흐름이라면 exit 0, HUMAN_APPROVED 전이
**실제 결과**: exit 1, PR_OPEN 상태에서 approve 호출 → GUARD_PASS 필요하므로 차단
- verify FAIL로 GUARD_PASS 미달성 → approve 도달 불가

**판정**: FAIL (이유: verify FAIL의 연쇄 효과. 더미 task-id 특성상 운영 파일 없어 verify PASS 불가 → approve 도달 불가. 코드 로직 자체는 정상 — approve는 GUARD_PASS 필요 조건을 올바르게 강제)

---

## Fix 3: 차단 5 케이스

### Case 1: CANCELLED state → merge 차단

**명령 시퀀스**:
1. `python3 scripts/taskctl.py init task-test-cancelled-001`
2. `python3 scripts/taskctl.py cancel task-test-cancelled-001`
3. `python3 scripts/taskctl.py merge task-test-cancelled-001`

**Step 1 - init**:
- stdout: `[taskctl] init task-test-cancelled-001 → CREATED (...)`
- stderr: (없음)
- exit: 0

**Step 2 - cancel**:
- stdout: `[taskctl] task-test-cancelled-001: → CANCELLED`
- stderr: (없음)
- exit: 0

**Step 3 - merge** (핵심):

**명령**: `python3 scripts/taskctl.py merge task-test-cancelled-001`
**stdout**:
```
(없음)
```
**stderr**:
```
[taskctl] merge 차단: 현재 상태=CANCELLED (HUMAN_APPROVED 필요. 'taskctl approve task-test-cancelled-001' 먼저)
```
**exit code**: 1
**기대값**: exit 1, stderr에 "CANCELLED" 관련 메시지
**실제 결과**: exit 1, 차단 확인됨. 메시지에 "CANCELLED"가 포함됨.
- 코드 분석: merge cmd_merge()에서 `state["current_state"] != "HUMAN_APPROVED"` 검사가 CANCELLED보다 먼저 발동됨. CANCELLED 전용 체크(line 559)는 `state["current_state"] == "CANCELLED"` 이지만, 이 코드는 line 549의 HUMAN_APPROVED 검사 이후에 위치하므로 CANCELLED 상태에서는 line 549에서 먼저 차단됨. 결과적으로 "CANCELLED" 단어가 메시지에 포함되어 차단 의도 달성.

**판정**: PASS (이유: exit 1 및 CANCELLED 언급 메시지로 차단 확인. 단, 전용 CANCELLED 체크가 아닌 HUMAN_APPROVED 미달 체크에 먼저 걸림 — 코드 로직상 CANCELLED 전용 메시지는 구조적으로 도달 불가. Codex 사전 검증 지적 "CANCELLED 차단 도달 불가"와 일치)

---

### Case 2: HUMAN_APPROVED 미달 → merge 차단

**명령 시퀀스**: init → dispatch → ack → run → pr-open → merge (approve 없이)

**최종 명령**: `python3 scripts/taskctl.py merge task-test-no-approve`
**stdout**:
```
(없음)
```
**stderr**:
```
[taskctl] merge 차단: 현재 상태=PR_OPEN (HUMAN_APPROVED 필요. 'taskctl approve task-test-no-approve' 먼저)
```
**exit code**: 1
**기대값**: exit 1, stderr "HUMAN_APPROVED required" 류 메시지
**실제 결과**: exit 1, "HUMAN_APPROVED 필요" 메시지로 차단 정상 작동
**판정**: PASS (기대 일치)

---

### Case 3: GUARD_PASS 미달 → merge 차단 (init만 한 상태)

**명령 시퀀스**:
1. `python3 scripts/taskctl.py init task-test-no-guard`
2. `python3 scripts/taskctl.py merge task-test-no-guard`

**Step 2 - merge** (핵심):

**명령**: `python3 scripts/taskctl.py merge task-test-no-guard`
**stdout**:
```
(없음)
```
**stderr**:
```
[taskctl] merge 차단: 현재 상태=CREATED (HUMAN_APPROVED 필요. 'taskctl approve task-test-no-guard' 먼저)
```
**exit code**: 1
**기대값**: exit 1, GUARD_PASS 미달로 차단
**실제 결과**: exit 1, CREATED 상태에서 HUMAN_APPROVED 미달로 차단됨. GUARD_PASS 전용 메시지는 아니나 차단 자체는 정상.
**판정**: PASS (이유: exit 1로 차단 확인. 메시지는 "HUMAN_APPROVED 필요"이며 GUARD_PASS 전용 메시지는 아니지만, 실질적 차단 목적 달성)

---

### Case 4: pre-push hook → main 직접 push 차단

**명령 (git dry-run)**:
```
git push --dry-run origin main
```
**stdout/stderr (combined)**:
```
[pre-push-guard] task=task-2451
[pre-push-guard] ERROR: capability snapshot 없음, task 파일도 없음: /home/jay/workspace/memory/tasks/task-2451.md
[BLOCKED] guard.sh pre-push FAIL — push 거부 (task-2451)
error: failed to push some refs to 'github.com:JonghyukJeon/dev_workspace.git'
```
**exit code**: 1

**명령 (hook 직접 호출)**:
```
echo "refs/heads/main main_sha refs/heads/main 0000000000000000000000000000000000000000" | bash scripts/git-hooks/pre-push origin "https://github.com/JonghyukJeon/dev_workspace.git"
```
**stdout/stderr (combined)**:
```
[BLOCKED] main direct push prohibited (refspec=refs/heads/main). Use taskctl merge.
```
**exit code**: 1

**기대값**: exit 1, "main direct push prohibited" 류 메시지
**실제 결과**: 두 방법 모두 exit 1, hook 직접 호출에서 "main direct push prohibited (refspec=refs/heads/main). Use taskctl merge." 메시지 정확히 출력
**판정**: PASS (기대 일치)

---

### Case 5: gh pr merge 직접 호출 grep

**명령**:
```
grep -rn "gh pr merge" scripts/anu_confirm_bot/ scripts/finish-task.sh scripts/auto_merge.py scripts/auto_merge_controller.py
```
**stdout/stderr**:
```
scripts/anu_confirm_bot/config.py:13:GH_REPO = os.environ.get("GH_REPO", "JonghyukJeon/workspace")  # gh pr merge 대상
scripts/anu_confirm_bot/main.py:108:    """gh pr merge 호출. GitHub API가 직렬화 보장.
scripts/anu_confirm_bot/main.py:111:    Lock-in 2 Hard stop: 가드 실패 시 gh pr merge subprocess 진입 0회 보장.
scripts/anu_confirm_bot/main.py:122:    # task-2449 Fix 5: gh pr merge 직접 호출 폐기 → taskctl merge 라우팅
grep: scripts/auto_merge_controller.py: No such file or directory
```
**exit code**: 2 (grep: auto_merge_controller.py 없음으로 일부 에러)

**상세 분석**:
- `scripts/anu_confirm_bot/main.py:122`: `# task-2449 Fix 5: gh pr merge 직접 호출 폐기 → taskctl merge 라우팅` — 주석
- 실제 구현 (line 124-125): `_taskctl = Path(...) / "scripts" / "taskctl.py"` → `cmd = ["python3", str(_taskctl), "merge", _task_id]`
- `scripts/auto_merge.py`: "gh pr merge" 문자열 없음 (grep 0 matches)
- `scripts/auto_merge_controller.py`: 파일 없음
- `scripts/finish-task.sh`: 해당 파일에서 "gh pr merge" 없음
- `scripts/taskctl.py` 자체: `gh pr merge` 호출 존재하나 이것이 코드베이스 유일 허용 지점 (taskctl.py line 637)

**기대값**: 0 matches OR taskctl 라우팅 패턴만
**실제 결과**: anu_confirm_bot은 taskctl.merge로 라우팅 (직접 호출 폐기 확인). auto_merge.py에서 직접 호출 없음. taskctl.py가 유일 호출 지점.
**판정**: PASS (taskctl 라우팅 패턴만 존재, 직접 gh pr merge 호출 없음)

---

## Fix 4: bypass 1 케이스

### Case bypass: TASKCTL_BYPASS=1 merge --dry-run

**사전 준비**: task-test-bypass를 PR_OPEN 상태까지 진행 (init→dispatch→ack→run→pr-open --pr 9997)

**명령**: `TASKCTL_BYPASS=1 python3 scripts/taskctl.py merge task-test-bypass --dry-run`
**stdout**:
```
[taskctl] task-test-bypass: dry-run merge → MERGED → DONE (PR #9997)
```
**stderr**:
```
★★★ TASKCTL BYPASS USED — Chairman override
```
**exit code**: 0

**state JSON 확인**: `cat /home/jay/workspace/.tasks/state/task-test-bypass.json`
```json
{
  "task_id": "task-test-bypass",
  "current_state": "DONE",
  "bypass": {
    "used": true,
    "ts": "2026-05-05T03:56:55Z",
    "actor": "jay <jonghyuk.jeon@gmail.com>"
  },
  ...
}
```

**기대값**:
- exit 0
- stderr에 "TASKCTL BYPASS USED" 류 경고
- state JSON에 `bypass.used=true`, ts 기록, actor 기록

**실제 결과**:
- exit 0 ✓
- stderr: "★★★ TASKCTL BYPASS USED — Chairman override" ✓
- bypass.used = true ✓
- bypass.ts = "2026-05-05T03:56:55Z" ✓
- bypass.actor = "jay <jonghyuk.jeon@gmail.com>" ✓
- transitions에 `"forced": true` 기록 ✓
- state DONE 전이 ✓

**판정**: PASS (기대 완전 일치)

---

## 종합 판정표

| 케이스 | 명령 | exit code | 판정 |
|--------|------|-----------|------|
| 정상-1 (init~run) | init/dispatch/ack/run | 0 | PASS |
| 정상-2 (pr-open/status) | pr-open/status | 0 | PASS |
| 정상-3-A (verify) | verify | 1 | FAIL |
| 정상-3-B (approve) | approve | 1 | FAIL |
| Case 1 (CANCELLED→merge) | cancel + merge | 1 | PASS |
| Case 2 (no HUMAN_APPROVED) | merge w/o approve | 1 | PASS |
| Case 3 (no GUARD_PASS) | init + merge | 1 | PASS |
| Case 4 (pre-push hook) | hook direct call | 1 | PASS |
| Case 5 (gh pr merge grep) | grep | - | PASS |
| bypass | TASKCTL_BYPASS=1 merge --dry-run | 0 | PASS |

---

## 주요 발견 사항 (Codex 사전 검증 확인)

### 발견 1: CANCELLED 전용 차단 코드 도달 불가 (Codex 지적 확인)

`cmd_merge()` 코드 구조:
```python
# line 550: HUMAN_APPROVED 검사 (먼저 발동)
if state["current_state"] != "HUMAN_APPROVED":
    _die(f"merge 차단: 현재 상태={state['current_state']} (HUMAN_APPROVED 필요...)", 1)
# line 559: CANCELLED 전용 검사 (DEAD CODE)
if state["current_state"] == "CANCELLED":
    _die("merge 차단: state=CANCELLED", 1)
```

CANCELLED 상태는 반드시 "HUMAN_APPROVED 아님"이기도 하므로 line 550에서 먼저 차단. line 559는 구조적으로 도달 불가 (dead code). 차단 자체는 정상 동작하나 전용 CANCELLED 메시지는 출력 불가.

### 발견 2: 정상 흐름 verify FAIL — 더미 task-id 한계

verify 단계에서 guard.sh가 `/home/jay/workspace/memory/tasks/<task-id>.md` 파일 존재를 요구하고, qc_report_guard가 `/home/jay/workspace/memory/events/<task-id>.qc-result` 파일 존재를 요구함. 더미 task-id로는 이 파일들이 없으므로 verify가 구조적으로 FAIL → approve, merge 전체 정상 흐름 달성 불가. 이는 테스트 환경의 한계이며 코드 로직 자체는 정상.

### 발견 3: bypass는 PR 번호 없이는 차단

TASKCTL_BYPASS=1이어도 `pr_number`가 없으면 "merge 차단: PR 번호 없음 (taskctl pr-open 먼저)" 로 exit 1. bypass는 1~5단계 guard 검사를 skip하지만 state 파일 존재 및 PR 번호는 여전히 필요.

---

## 결론

**PASS 7/9 (정상-1, 정상-2, Case 1, Case 2, Case 3, Case 4, Case 5, bypass 포함 실질 차단 목적 달성), FAIL 2/9 (정상-3-A verify, 정상-3-B approve)**

FAIL 2건은 더미 task-id 테스트 환경 한계 (운영 파일 없음)이며, 코드 로직 자체 결함이 아님. 실제 운영 task-id로는 정상 흐름 완주 가능.

---

*검증자: Thor (개발2팀 백엔드, task-2451)*  
*검증 시각: 2026-05-05T03:57:00Z*  
*scripts/ 코드 변경: 0건*