FESADev/docs/shell-surface-pressure-load/lessons.md

# Shell 표면 압력 수정과 시행착오

아래는 당시 실패 재현·원인·수정·검증 기록이다. 임시 shell/Hook/phase 복구 명령은 현재 실행 절차가 아니다.

<a id="corrections"></a>

<a id="corrections--shell-surface-pressure-load-correction-report"></a>
## Shell Surface Pressure Load Correction Report

<a id="corrections--1-metadata"></a>
### 1. Metadata

- feature_id: `shell-surface-pressure-load`
- source failure report: `phases/shell-surface-pressure-load/step1-output.json`, `phases/shell-surface-pressure-load/step2-output.json`, `.harness/build/Testing/Temporary/LastTest.log`
- source implementation plan: `docs/shell-surface-pressure-load/README.md`
- status: `corrected-for-implementation-rerun`
- date: `2026-09-01`
- normalized failure: `harness-parallel-duplicate-full-verification-timeout`
- attempt count: `2`

<a id="corrections--2-failure-triage"></a>
### 2. Failure Triage

- classification: `harness`
- first failed command: `python scripts/execute.py shell-surface-pressure-load`
- failed target or test: 제품 test 실패가 아니라 Implementation Agent가 실행한 unfiltered full CTest와 automatic Stop whole-project CTest의 중복 실행으로 인한 Harness outer timeout
- evidence tail: Step 2 agent full CTest PID `21572`가 `12:44:03`에 시작되었고, agent command가 `12:45:41`에 반환되기 전에 Codex Stop-hook `stop_validation.py` PIDs `21496`/`20712`가 시작되었다. 별도 Stop full CTest PID `8816`은 `12:46:01`에 시작되었으며 최종 test PID `21964`가 실행되는 동안 Harness는 pipe EOF를 기다렸다. 같은 형태의 overlap이 두 번의 1800초 timeout/slowdown을 만들었다.

<a id="corrections--3-root-cause-summary"></a>
### 3. Root Cause Summary

Root cause는 implementation defect, test defect 또는 CMake registration issue가 아니다. Pending Step 문서가 Implementation Agent에게 whole-project `cmake --build`와 unfiltered full CTest를 직접 실행하도록 요구하면서 `.codex/hooks.json`의 automatic Stop도 동일한 whole-project 검증을 수행했다. 장시간 reference tests가 병렬로 중복 실행되어 Executor가 Codex process와 pipe 종료를 기다리다 timeout됐다. 따라서 Step 2 output의 `exitCode: 124`는 product test failure가 아니라 Harness orchestration timeout이다.

<a id="corrections--5-verification-evidence"></a>
### 5. Verification Evidence

<a id="corrections--step-12-evidence-audit"></a>
#### Step 1/2 evidence audit

| Step | RED evidence | focused evidence | whole-project evidence | audit decision |
| --- | --- | --- | --- | --- |
| Step 1 | 신규 surface/DSLOAD semantic mapping 부재로 targeted RED가 실제 관찰됨 | parser/domain focused tests `36/36 passed` | MSVC Debug build passed, full CTest `310/310 passed` in `954.19 sec`; feature commit `ca3e4bc`, output commit `d5fc316` 존재 | feature/test evidence는 신뢰 가능하며 outer 1800초 timeout은 Harness overlap으로 분리 |
| Step 2 | invalid pressure input/diagnostic negative-contract assertions의 expected RED가 실제 관찰됨 | Step 2 targeted/focused verification passed | `.harness/build/Testing/Temporary/LastTest.log` LastWrite `2026-09-01 13:11:27`, `Test Passed.` 321, `Test Failed.` 0, CTest error marker 0; feature commit `c3b671d`, output commit `adebfae` 존재 | `exitCode: 124`는 test failure가 아니라 overlapping agent/Stop full CTest timeout |

<a id="corrections--correction-verification"></a>
#### Correction verification

- targeted reproducer: 실행하지 않음. 요구된 correction은 기존 두 overlap의 PID/timestamp 및 output/log evidence를 감사하는 문서/phase-instruction 교정이며 Harness/build/test 실행은 명시적으로 금지되었다.
- config-resolved full MSVC build/test: 이번 correction에서 실행하지 않음. 다음 Implementation Agent는 focused commands까지만 수행하고 automatic Stop이 exactly one whole-project validation을 소유한다.
- Stop result: 이번 correction turn에서는 Stop/Harness를 실행하지 않음.
- Harness Python pytest: hook/script/config를 변경하지 않았으므로 해당 없음.
- static verification: pending Step 3–7에서 agent-owned unfiltered full CTest와 target 없는 whole-project build가 제거되고, focused/reference commands와 automatic Stop 책임이 남는지 `rg` 및 `git diff --check`로 확인한다.