FESADev/docs/mitc4-shell-feast-eigen/implementation-plan.md

# MITC4 질량·FEAST 구현 계획

- Feature ID: `mitc4-shell-feast-eigen`
- Owner: `implementation-planning-agent`
- Input contract revision: `r2`
- 요청 outcome: `pass`; 다음 owner: `implementation-agent`
- 의미: 실행 가능한 계획의 Coordinator gate 검토 요청이다. 구현/검증 완료 판정이 아니다.

최초 prep attempt1은 지정 Hook 설정 쓰기 거부로 종료되었다. 부분 구현·blocked 기록의
보존과 승인 후 조건부 재개는 [복구 계획](implementation-recovery.md)을 따른다.
원 6단계 gate와 아래 main 계획은 유지하며 WIP 보존을 구현 성공으로 판정하지 않는다.
Prep에는 성공한 source echo를 helper failure로 오판한 재현 결함의 최소 classifier TDD도
포함한다. 기존 scripts/execute.py/tests/test_execute.py 소유 안에서 수행한다.

별도 Correction은 실제 RED21fail/16pass 뒤 GREEN37pass를 확보했다. 전체 pytest의 Hook
불일치와 manual build의 TEMP 접근 거부는 남아 있다. [R6](implementation-recovery.md#r6-실제-correction-source2의-보존과-남은-실행-조건)의
source2 보존 뒤 [E6](implementation-environment.md#e6-correction-후의-pythonpytest와-process-temp)의
확인된 Python 및 정상 TEMP/TMP 설정으로 후속 검증을 준비한다. 현재 source checkpoint,
status reset과 DFA 실행은 미실행이며 exact-run 명시 승인도 아직 없다.

위 E6 승인·재개는 이후 실제 attempt2로 수행됐다. Hook7500/focused136pass와 build는
완료됐지만 긴 inherited TEMP의 test323 실패로 전체 gate는 미완료다. 현재 복구는
[R7](implementation-recovery.md#r7-attempt2-실패-보존과-정상-workspace-write-재개)의
error/history2 WIP 보존 뒤 [E7](implementation-environment.md#e7-짧은-temp를-사용하는-정상-재개)의
짧은 TEMP와 정상 workspace-write를 사용한다. 이번에는 추가 DFA 승인이나 source Correction이 없다.

이후 attempt3은 짧은 TEMP를 같은 shell에 지정해도 manual build의 FileTracker 접근 거부로
종료됐다. 현재 작업은 [R8](implementation-recovery.md#r8-attempt3의-blocked-기록-보존)의
report1/controls2 blocked/history3 WIP 보존이다. [E8](implementation-environment.md#e8-attempt3-후의-정상-backend-대안)의
정상 Ninja 대안은 후속 bounded delta에서 명령을 확정하며 이번에는 설정·status reset·재실행하지 않는다.

R8 report/controls 보존은 실제 두 commit과 clean 확인까지 완료됐다. 현재
[E8](implementation-environment.md#e8-attempt3-후의-정상-backend-대안)은 Root의 ignored 설정 준비와
Coordinator의 별도 정상 Ninja invocation, 기존 Step 명령 대응을 확정한다.
[R9](implementation-recovery.md#r9-e8-활성화-전의-status-only-checkpoint)의 status-only 변경·checkpoint는
후속 할당으로 남는다. 이번 delta는 문서/정적 확인이며 native Ninja 성공은 아직 미검증이다.

[FEATURED_AGENTS](FEATURED_AGENTS.md), [PRD](PRD.md), [ADR](ADR.md)와
[coordination](coordination.md), 승인된 [requirements](requirements.md), [research](research.md),
[formulation](formulation.md), [NR](numerical-review.md), [I/O](io.md) 및 각 상세 r2를 적용한다.
공통 [architecture](../ARCHITECTURE.md), [tolerance](../TOLERANCE.md),
[agent 계약](../SOLVER_AGENT_DESIGN.md), [문서 관리](../FEATURE_DOCUMENTATION.md),
[harness](../../.agents/skills/harness/SKILL.md),
[fem-implementation-tdd](../../.codex/skills/fem-implementation-tdd/SKILL.md)가 실행 기준이다.

## 실행 구성

별도 execution-prep1 Step을 마친 뒤 새 invocation에서 main8 Steps를 수행한다.
각 Step은 behavior별 RED→observed failure→minimal GREEN→focused VERIFY를 끝내고
전체 MSVC/x64/Debug CMake/CTest와 등록 Stop을 통과한다. 새 compiler warning은0이다.

| 순서 | 완결되는 범위 | 실행 artifact |
| --- | --- | --- |
| Prep0 | 다섯 유한 deadline 설정·Harness regression·activation | [prep Step0](../../phases/mitc4-shell-feast-eigen-execution-prep/step0.md) |
| 0 | Frequency semantic model과 exact 입력 subset | [Step0](../../phases/mitc4-shell-feast-eigen/step0.md) |
| 1 | 공변 drilling scale과 정적 회귀 | [Step1](../../phases/mitc4-shell-feast-eigen/step1.md) |
| 2 | Consistent→lumped 질량과 deterministic 조립 | [Step2](../../phases/mitc4-shell-feast-eigen/step2.md) |
| 3 | 실제 제약의 null 공간과 sparse whitening | [Step3](../../phases/mitc4-shell-feast-eigen/step3.md) |
| 4 | MKL FEAST adapter와 bounded lowest-N 검색 | [Step4](../../phases/mitc4-shell-feast-eigen/step4.md) |
| 5 | 전체 c 검증과 별도 frequency procedure | [Step5](../../phases/mitc4-shell-feast-eigen/step5.md) |
| 6 | Additive HDF5와 CLI candidate transaction | [Step6](../../phases/mitc4-shell-feast-eigen/step6.md) |
| 7 | Value-only comparator·fresh reference·구현 evidence | [Step7](../../phases/mitc4-shell-feast-eigen/step7.md) |

[실행 환경](implementation-environment.md)은 actual autodetect VS18/x64/Debug cache/dependencies,
one-time prep module invocation과 새 main activation, 유한 timeout·Git ownership을 고정한다.
8개로 합친 이유와 시간 추정의 한계도 명시했다. [API/source-test 경계](implementation-interfaces.md)는
기존 확장점과 vendor 격리·별도 state/procedure·candidate commit을 정한다.
[Verification mapping](implementation-verification.md)은 must27/NR27/I/O11 및 formulation/schema
items를 독립 oracle·mutation·실제 test discovery/full evidence에 연결한다.

## 계약과 handoff

계산은 `consistent -> moment-derived lumped -> actual MKL FEAST`이며 all-c residual/Gram도
같은 ML을 사용한다. 입력 N은 원본 FREQUENCY의10, 공개 N과 검증 c를 구분한다.
공변 trace stabilization과 영향 static 재검증을 포함한다. 새 eigen external comparison은 원본
TXT의 Value10개와10singleton common families이며 기존 static U/UR/reaction 역할은 유지한다.

모든 exact implementation/test/build/report paths는 [main index](../../phases/mitc4-shell-feast-eigen/index.json)와
[prep index](../../phases/mitc4-shell-feast-eigen-execution-prep/index.json)에 있다.
미래 보고서를 미리 생성하지 않았다. Planning 소유는 이 main/detail4문서와 할당된 phase files뿐이다.
Solver C++·FEAST·reference comparison은 미실행이다. 운영 prep의 부분 변경과 실제 검증
관찰은 [현재 상태](coordination.md)와 [복구 계획](implementation-recovery.md)에 구분한다.
계획 정적 감사 명령/exit/coverage는 [V7](implementation-verification.md#v7-계획-정적-감사)에 기록한다.

현재 upstream physics/schema/tolerance 미결정은 없다. Native Codex sandbox/runtime와 실제
FEAST count/condition/메모리/외부 오차는 실행 전 성공을 보장할 수 없다. Actual failure는 계약된
owner/환경 경로로 반환하고 수치 기준을 바꾸지 않는다. Workflow 전이·독립 Physics/Release와
closure는 Coordinator/각 owner 소유이며 push/tag/publish/deploy/package 권한은 없다.