docs(hex8): record comparison evidence and reference options

This commit is contained in:
KOKO\Mimi
2026-10-10 02:15:30 +09:00
parent 317fe5caf6
commit 7b75f37462
9 changed files with 221 additions and 14 deletions
+13 -4
View File
@@ -15,8 +15,12 @@
같은 원본 형상·변위의 Gauss 구성식도 현재 stress/strain을 재현한다. 승인된 full8 식을
원본 값에 맞춰 조용히 바꾸거나 tolerance를 완화할 근거가 아니다. 원본 응력의 체적 성분은
요소 평균 trace로 재구성하면 크게 가까워지지만 이것만으로 private algorithm을 증명하지 않는다.
- 후속 방향: 정식 비교기·독립 수치 검토를 완료하고, 원본의 observable 체적 처리와 승인
정식화의 차이 및 변경 영향을 구체화한다. Physics·필수 reference 판정 변경은 사용자 결정
- 후속 방향: 정식 비교기·독립 수치 검토를 완료했다. 두 정적 공식 결과는 source/schema
검사와 CLI native0이나 U/RF/S family가 모두 FAIL이다. 별도 선형 체적 평균 energy의
독립 Python 후보는 unchanged 수치 기준에 일치했으며 현재 생산 구현의 PASS가 아니다.
[미채택 변경안](../hex8-structural-analysis/reference-discrepancy-proposal.md)에 정식화 유지와
별도 reference, 또는 energy/force/Hessian 체적 변경의 영향을 구체화했다.
Physics·필수 reference 판정 변경은 사용자 결정
사항이며, 다른 원본 실행과 현재 범위 검증은 원본·수치 기준을 유지한 채 계속한다.
## Hex8 동해석의 엄격 잔차와 내부 상태 정밀도
@@ -49,6 +53,10 @@
## Python 운영 계약 검사의 기대값 불일치
- 추가 관찰(2026-10-10 Hex8 비교기 작업): 설정된 전체 Python 명령에 h5py dependency를
추가해 실행했으나 기존 `msvc_harness`·폐기된 `scripts.hooks` import의 collection5
오류로 native2·실행0개였다. 관련 comparator124/124 native0과 구분하며 전체 PASS가 아니다.
정확한 명령과 raw는 [Hex8 verification](../hex8-structural-analysis/verification.md)에 있다.
- 조건·현상: `tests/test_agent_skill_workflow_contract.py`의 inventory 검사는 11개
profile을 기대하지만 현재 `.codex/agents`에는 7개가 있다. 같은 파일은 루트 지침의
고정 단계 표를 parsing하고, 과거 phase 실행 예제를 검사한다. 현재 명시 실행기와
@@ -56,8 +64,9 @@
- 영향: 이 검사를 현행 운영의 통과 증거로 쓰거나 통과시키기 위해 삭제된 절차를
복원하면 잘못된 개발 흐름을 다시 도입한다. 루트 문서 재구성 이후에는 옛 표 위치에
의존하는 검사도 조정 대상이다.
- 현재 해결하지 않는 이유: 기존 불일치는 source 정적 대조로 확인했지만 이번 요청은
문서 변경이다. Python 검사를 실행하거나 테스트 코드를 수정하지 않았다.
- 현재 해결하지 않는 이유: 2026-10-04 문서 정리에서는 source 정적 대조만 했고 Python
검사를 실행하지 않았다. 이후 위 collection 문제를 실제 관찰했지만 Hex8 기능 작업에서
기존 운영 검사나 폐기된 절차를 복원하는 수정은 범위 밖이다.
- 후속 방향: 유효한 동작·권한·검증 범위를 검사하도록 기대값을 정리하고 Python suite를
별도로 실행한다. 현재 CTest의 성공으로 대체하지 않는다.
+12 -4
View File
@@ -1,14 +1,16 @@
# 개발 현황
기준일은 2026-10-04이다. 주목적은 개인 연구용 솔버 개발이며 외부 사용자 배포는 장기
목표다. 문서 정리에서 solver나 검증 suite를 다시 실행하지 않았다. 아래는 보존된 실제
실행과 기능별 계약을 대조한 요약이며 상세 checklist를 대신하지 않는다.
기준일은 2026-10-10이다. 주목적은 개인 연구용 솔버 개발이며 외부 사용자 배포는 장기
목표다. 아래는 실제 실행과 기능별 계약을 대조한 요약이며 상세 checklist를 대신하지 않는다.
2026-10-04 문서 정리 당시의 기존 기능 기록과 이후 Hex8 개발의 실행 증거를 구분한다.
최신 전체 MSVC x64 Debug 통합 회귀는 source `9f7fb2e`에서 **617개: 614 PASS·2 FAIL·1 SKIP**,
종료된 전체 MSVC x64 Debug 통합 회귀는 source `9f7fb2e`에서 **617개: 614 PASS·2 FAIL·1 SKIP**,
native CTest exit **8**이다. 기존 478개 검사가 포함되고 추가139개 모두 PASS다.
두 HHT 실패와 skipped 항목은 구현 전 baseline의 status·metric body와 정확히 같다.
실행·복구·보존 경로는 [전체 회귀 보고서](../shell-transient-heat-transfer/implementation-verification.md#통합-전체-회귀와-남은-완료-조건)에 있다.
dev 병합 `858e87b`는 검증한 구현과 동일한 tree이고 별도의 새 실행을 뜻하지 않는다.
Hex8 연결 후 source `1eb9cdd`의 전체 build는 native exit0이며, 발견된780개 CTest의
제외 없는 실행은 진행 중이다. 이 실행의 종료 결과를617개 과거 기록으로 대체하지 않는다.
## 구현과 검증 상태
@@ -22,11 +24,17 @@ dev 병합 `858e87b`는 검증한 구현과 동일한 tree이고 별도의 새
| HHT 굽힘 단면력 복구 | 두께 계수 수정됨 | 관련 Debug 14 tests와 원본 HDF5 재생성·독립 식 대조 완료 기록. 전체 동해석 완료와 별개 |
| HHT 관련 전체 CTest | 기존 실패2개·SKIP1개 유지 | 최신617개 검사에서 제외 없이 실행. 기존 metric과 동일하며 전체 green 아님 |
| Shell transient heat transfer | 구현·내부 검증 완료, 필수 외부 비교 대기 | [추가139개 PASS·수렴/수지·독립 수치/물리 검토](../shell-transient-heat-transfer/README.md). 기존 NT11은87/729행 수치 FAIL인 diagnostic; 새 모델·CSV 준비 중 |
| Hex8 선형·기하비선형 강성·consistent mass | static/frequency/HHT·CLI/HDF5 연결됨, 기능 검증 미완료 | [기능 PRD](../hex8-structural-analysis/PRD.md)의 범위를 따름. 내부 검증과 공식 출력 관련 검사 PASS. 두 정적 원본은 CLI native0이나 U/RF/S 필수 비교 FAIL; 체적 정식화 차이 조사 중. 동적 전체 원본 실행·전체 회귀 진행 중, modal Value 원본 부재 |
| Python 검증 실행기 | 구현됨 | 명시 build/test runner와 별도 Python suite가 존재. 일부 운영 계약 검사는 현행 절차와 맞지 않는 기대값을 유지 |
| 외부 사용자 배포 | 계획 | 배포 방식·설치·지원 정책과 dependency 재배포 검토가 아직 정해지지 않음 |
## 남은 작업과 의존성
Hex8은 현재 정식화와 원본·tolerance를 보존하며 동적101 frame 비교와 전체 회귀를
마무리한다. 정적 원본과 표준 full8의 차이는 [미해결 문제](findings.md)에 기록했다.
Physics 또는 필수 reference 계약 변경은 별도 사용자 결정이며, 원본을 보정하거나
기능 검증 완료로 처리하지 않는다. 세부 현재 checklist는 기능 PRD 한 곳에 유지한다.
1. Shell 열해석은 준비 중인 새 reference 모델·CSV의 별도 경로·identity·시점·hash를
확정하고 승인 tolerance로 필수 비교를 실행한다. 기존 NT11 diagnostic FAIL과 고정
5점 두께 모델의 해상도·곡면·접합부 검증 한계를 유지한다. 구현을 처음부터 재개하지 않는다.