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 기록의 보존과 승인 후 조건부 재개는 복구 계획을 따른다. 원 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의 source2 보존 뒤 E6의 확인된 Python 및 정상 TEMP/TMP 설정으로 후속 검증을 준비한다. 현재 source checkpoint, status reset과 DFA 실행은 미실행이며 exact-run 명시 승인도 아직 없다.

FEATURED_AGENTS, PRD, ADR와 coordination, 승인된 requirements, research, formulation, NR, I/O 및 각 상세 r2를 적용한다. 공통 architecture, tolerance, agent 계약, 문서 관리, harness, fem-implementation-tdd가 실행 기준이다.

실행 구성

별도 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
0	Frequency semantic model과 exact 입력 subset	Step0
1	공변 drilling scale과 정적 회귀	Step1
2	Consistent→lumped 질량과 deterministic 조립	Step2
3	실제 제약의 null 공간과 sparse whitening	Step3
4	MKL FEAST adapter와 bounded lowest-N 검색	Step4
5	전체 c 검증과 별도 frequency procedure	Step5
6	Additive HDF5와 CLI candidate transaction	Step6
7	Value-only comparator·fresh reference·구현 evidence	Step7

실행 환경은 actual autodetect VS18/x64/Debug cache/dependencies, one-time prep module invocation과 새 main activation, 유한 timeout·Git ownership을 고정한다. 8개로 합친 이유와 시간 추정의 한계도 명시했다. API/source-test 경계는 기존 확장점과 vendor 격리·별도 state/procedure·candidate commit을 정한다. Verification mapping은 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와 prep index에 있다. 미래 보고서를 미리 생성하지 않았다. Planning 소유는 이 main/detail4문서와 할당된 phase files뿐이다. Solver C++·FEAST·reference comparison은 미실행이다. 운영 prep의 부분 변경과 실제 검증 관찰은 현재 상태와 복구 계획에 구분한다. 계획 정적 감사 명령/exit/coverage는 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 권한은 없다.