antemortem-structural-lab 0.7.0a1__py3-none-any.whl

antemortem_structural_lab-0.7.0a1.data/data/share/antemortem-structural-lab/PUBLIC_IMPORT_NOTICE.md

@@ -0,0 +1,15 @@
+# Public Git history provenance
+
+The v0.1.0, v0.1.1, and v0.2.0 experiments were initially developed and archived outside Git. Their code snapshots were validated, reviewed for public release, and imported sequentially into this repository later.
+
+The Git commits are **reconstructed import events**, not contemporaneous evidence of when each idea was first written. This is intentionally visible in the commit messages and annotated tag messages. Original generated result JSONs and `build/lib/` artifacts were excluded: some contained absolute paths to temporary development machines or duplicated source files. The public source and regression fixtures are available.
+
+Research reports describing unrelated private work, secrets and real API credentials were not imported. No published version implies production-grade reliability, universally sound AI verification, or an advantage over established tools.
+
+## Unpublished v0.2.0 tag finalization
+
+Before publication, an authenticated GitHub lookup confirmed that the intended repository did not exist. The original release kit is preserved unchanged. Its v0.2.0 annotated tag object was `d1aa9ecacaf6a38ff2cd95b5ade997e70e6c2596`, pointing to commit `375e010124706a498d026045624dc10adf0a2d23`.
+
+The local v0.2.0 tag was finalized on the subsequent public release commit so that its source archive, bilingual README, package description and rebuilt distribution agree. All original commits remain ancestors of the public main branch. The v0.1.0 and v0.1.1 tag objects are unchanged, including the explicit v0.1.1 package metadata repair. Historical READMEs in those two tags retain their archived wording; the release notes describe their historical scope.
+
+The finalization adds documentation, explicit UTF-8 reading in one Windows-sensitive test, and distribution metadata. A wheel installation check also exposed missing bundled examples; the wheel now includes them, and the CLI locates the installed copies. Git attributes fix text line endings for byte-level source/distribution checks. The probing and claim algorithms are unchanged. These fixes do not backdate commits or claim a new experimental result. The import bundle, original tag hashes and rebuilt artifact checksums are retained in the release audit.

antemortem_structural_lab-0.7.0a1.data/data/share/antemortem-structural-lab/README.ko.md

@@ -0,0 +1,352 @@
+# Antemortem Structural Lab
+
+신뢰할 수 있는 Python 함수를 검사하고, 실패한 입력을 저장하며, 그 실패를 설명하는 경쟁 가설로 다음 테스트를 선택하는 실험 도구입니다. 코드 구조를 읽는 **MRI**, 실행 결과를 관측하는 **CAST**, 반례를 찾는 **Claim-to-Witness**, 실패 조건을 학습하는 **Mold**를 제공합니다.
+
+**한국어 사용자 안내** · [English](README.md) · [변경 이력](CHANGELOG.md) · [검증 기록](docs/RELEASE_VALIDATION.md)
+
+`0.7.0a1`은 **Evidence-Gated Structural Knowledge**를 추가한 실험적 사전 릴리스입니다. 과거 실패에서 만든 가설을 반증·적용 계약과 함께 보존하고, 검토된 별도 구현의 대조 증거가 있는 관계만 새 탐색에 사용합니다. 범용 생성·축소는 Hypothesis에 맡깁니다. [실제 구조와 신뢰 계약](docs/E7_KNOWLEDGE.md) · [E7 독립 평가](docs/E7_EVALUATION_REPORT.md).
+
+## E7: 증거가 있는 구조적 지식 사용하기
+
+지식은 `HYPOTHESIS → SUPPORTED_WITHIN_SCOPE → QUALIFIED_FOR_PROBING`으로 구분하고, 반증은 `CONTRADICTED`, 적용 근거 부족은 `APPLICABILITY_UNKNOWN`으로 남깁니다. 승격에는 동일한 별도 검토 구현에서 얻은 실패·정상 대조 관측과 호환되는 역할·타입·연산·상태/IR 계약이 필요합니다. 출처 해시는 신원을 결속하며 의미적 독립성·원인을 증명하지 않습니다.
+
+자격 있는 지식이 없으면 worker·후보 풀·solver를 시작하지 않고 native Hypothesis를 실행합니다. 자격 있는 경우 guidance를 전체 계획 예산의 최대 절반으로 제한하고 native 탐색 경로를 유지합니다. 유한 도메인이 소진되면 실제 후보 비율은 달라질 수 있습니다. bounded prefix 뒤 동결하고 native search/shrinking과 독립 replay를 수행합니다. 새 시간 가설·상태 API는 기존 E6와 함께 사용할 수 있습니다.
+
+이번 CI 검증 범위는 Python 3.11~3.13입니다. 패키지 메타데이터는 3.11 이상을 허용하며 더 최신 Python은 이번 검증 범위에 포함하지 않습니다. 로컬 QA는 Hypothesis6.170.11·Z35.3.2.0으로 실행했습니다.
+
+```bash
+python -m pip install "antemortem-structural-lab[qa,solver] @ https://github.com/hibou04-ops/antemortem-structural-lab/releases/download/v0.7.0a1/antemortem_structural_lab-0.7.0a1-py3-none-any.whl"
+python -m tomolab knowledge-demo --budget 16 --guidance-budget 4 --pool-size 16 --shrink-budget 16 --output results/e7.json
+python -m tomolab knowledge-demo --case clean --budget 12 --guidance-budget 4 --pool-size 8 --shrink-budget 0 --output results/e7-clean.json
+```
+
+동봉된 directed-width 예제는 직접 작성한 기능 검사입니다. 공개 참조 모델의 `lower > upper` 관계가 실제 후보 순서를 바꾸는지 확인합니다. 이 IR은 **공개 참조 모델**의 구조이며 비공개 대상 구현을 분석한 결과가 아닙니다. 예제의 같은 실패 형태를 다른 코드로 표현한 결과를 실제 프로젝트 일반화로 계산하지 않습니다.
+
+소스 checkout 또는 wheel에 동봉된 예제 폴더에서 최소 개발 로그를 학습하고 동결 계획을 생성하려면:
+
+```bash
+python -m tomolab knowledge-inspect --spec examples/knowledge/target-spec.json
+python -m tomolab knowledge-learn --spec examples/knowledge/source-spec.json --failure-log examples/knowledge/source-failures.json --provenance examples/knowledge/source-provenance.json --public-ir examples/knowledge/source-ir.json --observations examples/knowledge/observations.json --approve-development-evidence --store results/e7-journal.jsonl --record-id development-1 --output results/e7-mold.json
+python -m tomolab knowledge-plan --archive results/e7-mold.json --spec examples/knowledge/target-spec.json --target-provenance examples/knowledge/target-provenance.json --public-ir examples/knowledge/target-ir.json --budget 8 --guidance-budget 4 --pool-size 16 --output results/e7-plan.json
+python -m tomolab knowledge-run examples/knowledge/target.py --oracle-file examples/knowledge/target_oracle.py --archive results/e7-mold.json --spec examples/knowledge/target-spec.json --target-provenance examples/knowledge/target-provenance.json --public-ir examples/knowledge/target-ir.json --failure-signature directed-width --allow-local-execution --budget 16 --guidance-budget 4 --pool-size 16 --shrink-budget 16 --output results/e7-run.json
+```
+
+`knowledge-learn`은 JSON 증거를 해석하고 대상 코드를 실행하지 않습니다. `--approve-development-evidence`는 출처와 독립 Oracle를 검토한 호스트의 명시적 확인이며, 임의 로그를 사실로 인증하는 장치가 아닙니다. `knowledge-run`은 별도 파일의 신뢰된 `implementation(**inputs)`·`reference(**inputs)`만 실행합니다. 실행 동의는 대상 코드의 보안 격리가 아닙니다.
+
+새 반증을 축적할 때는 동결 부모를 보존한 새 개발 세대를 만듭니다:
+
+```bash
+python -m tomolab knowledge-update --archive results/e7-mold.json --observations examples/knowledge/counterevidence.json --generation-id development-2 --approve-development-evidence --store results/e7-journal.jsonl --record-id development-2 --output results/e7-updated.json
+python -m tomolab knowledge-inspect --archive results/e7-updated.json --spec examples/knowledge/target-spec.json --target-provenance examples/knowledge/target-provenance.json --public-ir examples/knowledge/target-ir.json --output results/e7-updated-gate.json
+```
+
+append-only 저장소는 같은 record ID의 동일 입력을 중복 추가하지 않으며, 기존 반증을 버리는 과거 snapshot 복귀를 거부합니다. 세대는 최대32번, source/개발 관측은 각각 총256개로 제한합니다. 중단된 append·충돌 lock은 자동 삭제하거나 덮어쓰지 않습니다. 최종 평가 자료를 개발 관측으로 재사용하지 않습니다.
+
+기본 subprocess는 `LOGICAL_ISOLATION_ONLY`. 선택적 Docker는 Generator만 제한하고, 대상·Oracle는 신뢰된 호스트 코드입니다:
+
+```bash
+docker build -f containers/e7-generator.Dockerfile -t tomolab-e7-generator:local containers
+python -m tomolab knowledge-demo --backend docker --budget 16 --guidance-budget 4 --pool-size 16 --shrink-budget 16 --output results/e7-container.json
+```
+
+기존 E1~E6 동결 결과는 보존합니다. E6의 `NO_IMPROVEMENT`·대표 후보12/13 반증을 전체 가설 정확도로 확대하지 않습니다. E7의 개발 v1은 Oracle 정밀도 오류로 `INVALID_ORACLE / INCONCLUSIVE` 처리했습니다. 정확 산술로 수정한 Oracle의 독립 검토와 v2 계약 등록을 마쳤으며, 실제 검증 결과는 [별도 기록](docs/E7_EVALUATION_REPORT.md)에 구분해 공개합니다. 이미 관측한 개발 문제의 재검증은 새 블라인드 평가가 아닙니다. 가설을 모두 보류하고 baseline과 같아진 결과는 추가 발견 성과가 아닙니다. 계획 snapshot의 재생은 같은 Hypothesis/Z3 환경에서 검증하며 버전 간 동일 재생을 보장하지 않습니다.
+
+새 최종 비교72건은 54 COMPLETE·18 Stateful NOT_COMPARABLE이며 필수 방법의 오류·시간 초과·대조군 오탐·Generator feedback은0입니다. Native Hypothesis·E6·E7 모두 발견0이었고, 주평가 archive의 qualified/guided도0이었습니다. 발견 우위·지식 전이 효용·외적 일반화 판정은 **INCONCLUSIVE**입니다. 최종 비교는 피드백 없는 최대64개 동결 계획에 한정하며 Hypothesis 전체 적응형 PBT 능력을 평가한 것이 아닙니다. 임의 Python 프로그램의 의미 대응을 자동 학습하는 기능은 아직 없고, 검토된 역할·의미 계약에 의존합니다.
+
+## 보존된 E6 기능과 결과
+
+`0.6.0a1`의 Stateful Structural Mold와 typed 입력·EFSM 지원은 유지합니다. [E6 구현](docs/E6_INTEGRATION.md) · [E6 독립 평가](docs/E6_EVALUATION_REPORT.md).
+
+## E6: 실패 시퀀스에서 관계를 배우기
+
+단순히 `push(0), pop(0)`을 저장하는 대신, 공개 모델의 전이 전후 상태·행동 역할·순서와 실제 첫 실패 위치를 결합합니다. `remove` 행동의 직전 크기가 1인 관계, 이전 행동이 `insert`인 관계, 인자 조건 등 여러 후보를 같은 Version Space에 유지하고 개발 반증으로 제거합니다. 이는 검증 가능한 **실패 소속 가설**이며 원인의 증명이 아닙니다.
+
+```mermaid
+flowchart LR
+    C[공개 EFSM / typed 계약] --> H[Native Hypothesis RuleBasedStateMachine]
+    H --> R[평가 전 public 입력 등록]
+    R --> O[신뢰된 대상 / 독립 Model 평가]
+    O --> E[최소 개발 증거 / 첫 실패 전이]
+    E --> V[E5 공유 Version Space + temporal 관계]
+    V --> Q[적용 가능·새로운 판별 입력만 선택]
+    Q --> O
+    V --> F[동결 snapshot / 역할·행동 전이]
+    F --> P[피드백 없는 새 대상 계획]
+    O --> S[동결 후 평가기 전용 native shrinking / 재실행]
+```
+
+E5의 정적·AST 가설과 E6 시간 관계는 같은 가설 그룹·반증 제거 루프를 사용합니다. 상태·행동 이름, 전제조건, 동시 상태 갱신식, 불변식, 행동 의존성, 근거·반증·버전을 JSON으로 보존합니다. 초기 상태는 선언과 일치해야 합니다. `APPLICABLE_FOR_PROBING`, `NOT_APPLICABLE`, `UNKNOWN`, `CONTRADICTED`를 구별하며 전이 허용은 결함 재현 보장이 아닙니다.
+
+### 설치와 실제 CLI
+
+Python 3.11 이상. GitHub wheel에서 시작할 수 있습니다.
+
+```bash
+python -m pip install "antemortem-structural-lab[qa,solver] @ https://github.com/hibou04-ops/antemortem-structural-lab/releases/download/v0.6.0a1/antemortem_structural_lab-0.6.0a1-py3-none-any.whl"
+python -m tomolab stateful-demo --budget 128 --pool-size 12 --shrink-budget 64 --output results/e6.json
+python -m tomolab stateful-demo --case clean --budget 24 --pool-size 8 --shrink-budget 0 --output results/e6-clean.json
+```
+
+동봉된 stack 예제는 E5에서 알려진 마지막 항목 삭제 문제의 **기능 회귀용**입니다. 새 독립 연구 결함으로 계산하지 않습니다. 별도 Oracle는 크기 불변식만 검사하며 모든 stack 내용·순서를 검증하지 않습니다. 결과의 실제 전이 호출 수, `snapshot`, 경쟁 제약, 비용 범위, `counterexample.replay`를 확인하세요. `RESOURCE_BUDGET`은 미완료 축소이며 최소성·정확성 증명이 아닙니다.
+
+소스 checkout의 명세를 검사하고 이름과 구현이 다른 대상으로 계획을 옮기려면:
+
+```bash
+python -m tomolab stateful-inspect --contract examples/temporal/stack-contract.json --output results/e6-contract.json
+python -m tomolab stateful-run examples/temporal/stack_target.py --oracle-file examples/temporal/stack_oracle.py --contract examples/temporal/stack-contract.json --allow-local-execution --budget 128 --pool-size 12 --shrink-budget 64 --output results/e6.json
+python -m tomolab stateful-plan --snapshot results/e6.json --contract examples/temporal/renamed-contract.json --budget 8 --pool-size 12 --output results/e6-plan.json
+```
+
+외부 `stateful-run` 파일은 각각 `make_subject()` factory를 제공하고, 반환 객체는 `step(action, argument)`와 `snapshot()`을 구현합니다. snapshot은 선언한 상태 역할을 키로 갖는 수치 사전입니다. 대상과 Oracle는 직접 작성하거나 검토한 별도 파일만 사용하세요. `--allow-local-execution`은 실행 동의이며 보안 격리가 아닙니다. 검사·예산·선택 의존성 확인 후에만 파일을 import합니다.
+
+### Hypothesis-First와 비용 범위
+
+조건에 맞는 실패 증거가 없으면 native `rule`·`precondition`·`invariant`·`Bundle` 경로를 유지합니다. cold 초기화는 빈 유효 seed만 보존하고, 첫 실패나 승인된 prior가 생길 때 후보 풀과 시간 가설을 한 번 활성화합니다. 실제 query 순서에 영향을 주지 않는 제약을 반복 적용하지 않습니다. Z3의 incremental `push/pop`·정규화 캐시와 새 정수 인자 witness를 사용하고, 이미 선택할 SAT witness가 있으면 중복 후보 생성을 생략합니다.
+
+캐시는 명세·엔진 버전·실제 입력을 포함합니다. 상태 객체의 변이를 캐시로 생략하지 않습니다. 서비스는 개발·축소·재실행의 **실제 model/target 전이 호출**을 셉니다. E5의 whole-trace 함수 호출과 단위를 섞지 마세요. 시간은 전체 wall을 기본으로 하고 worker 계산, pool, Version Space, solver, Oracle, 축소, transport 잔차를 구분합니다. 일부 phase는 겹치며 RSS 표본은 실제 peak가 아닙니다.
+
+### 지원 범위와 안전 모델
+
+- EFSM: 최대 4개 유한 int/float 상태 투영, 최대 16개 행동, 공개 산술·조건부 동시 갱신, 전제·사후 조건과 불변식.
+- native stateful 실행: 정수 행동 인자 최대 129개 값, trace 최대 16단계, `min_size=0`. Float 인자·임의 객체 의미·무한 반복은 명시적 미지원입니다.
+- 기존 E5의 int/float/str/list/tuple/dict 검증과 MRI·CAST·Claim·Mold CLI는 보존합니다.
+- Generator에는 공개 계약·승인된 IR·최소 개발 label만 보냅니다. raw Oracle 상태·정답·비공개 최종 source·주관적 점수는 보내지 않으며 동결 후 등록·feedback을 전송 전에 차단합니다.
+- 기본 subprocess는 `LOGICAL_ISOLATION_ONLY`. 선택적 Docker는 Generator의 파일·네트워크·권한 접근을 제한하고 실제 CI에서 따로 검사합니다. 대상·Model은 계속 신뢰된 호스트 코드입니다.
+
+```bash
+docker build -f containers/e6-generator.Dockerfile -t tomolab-e6-generator:local containers
+python -m tomolab stateful-demo --backend docker --budget 128 --pool-size 12 --shrink-budget 64 --output results/e6-container.json
+```
+
+E1~E5의 부정적 연구 결과와 소비된 홀드아웃은 보존합니다. E6의 새 동결 최종84건은 오류·timeout·drift·Generator feedback0, 78 COMPLETE와 Native Stateful 정적6 NOT_COMPARABLE입니다. 모든 방법이 상태 run15/15를 발견했지만 E6/Hypothesis paired wall 중앙 비율2.321로 **개발·최종 모두 NO_IMPROVEMENT**입니다. 개발 가설13개 중12개가 새 입력에서 반증됐고 OUT_OF_GRAMMAR1건이 남아 표현 해결은 PARTIAL입니다. 외부 실제 프로젝트 일반화는 NOT_EXECUTED입니다. [보안 모델](SECURITY.md)과 [E6 평가 기록](docs/E6_EVALUATION_REPORT.md)을 함께 확인하세요.
+
+## 보존된 E5 통합 기능
+
+
+
+## E5 통합 엔진
+
+기존 E4의 두 정수용 Mold는 그대로 사용할 수 있습니다. 새 `discovery-*` 명령은 유한 범위의 정수·실수·문자열·리스트·튜플·문자열 키 사전과 제한된 상태 전이 trace를 지원합니다. 복합 자료형은 명세의 크기·깊이·값 범위 안에서 생성합니다.
+
+```mermaid
+flowchart LR
+    P[공개 타입·역할·계약] --> IR[승인된 공개 AST → typed IR]
+    IR --> VS[경쟁 구조 가설 / Version Space]
+    VS --> Q[불일치·다양성·공개 비용 선택]
+    H[Hypothesis native Strategy] --> Q
+    Z[지원된 정수 Z3 witness] --> Q
+    Q --> O[호스트의 신뢰된 대상 + 독립 Oracle]
+    O --> E[최소 개발 실패·반증]
+    E --> VS
+    VS --> F[동결 snapshot / 역할·타입·계약 전이]
+    F --> V[피드백 없는 최종 검증]
+    O --> S[평가기 전용 native shrinking·재실행]
+```
+
+AST 조건식은 가설 문법과 실제 입력 선택에 사용됩니다. 실패·반증은 경쟁 가설을 제거하고 다음 질문을 바꿉니다. fresh Hypothesis Strategy와 지원된 Z3 판별 입력도 실제 후보 풀에 들어갑니다. SAT는 프로그램 정답의 증명이 아닙니다. 반례 축소는 동결 후 평가기에서 수행하며 최종 결과를 Generator에 돌려보내지 않습니다.
+
+한 실패로 형상을 확정하지 않습니다. 예를 들어 리스트 합이 0일 때 실패했다면 `sum(items) == 0`과 다른 경쟁 관계를 함께 유지하고 추가 관측으로 반박된 관계만 제거합니다. typed 역할, 조건·의존성·상태 관계, 증거와 버전은 snapshot/IR에 남습니다. 선언된 구조의 대응은 탐색 허용 근거이며 결함 재현의 보증이 아닙니다.
+
+### 설치 후 바로 실행
+
+Python 3.11 이상에서 다음 명령은 동봉된 직접 작성 예제만 실행합니다. 유료 모델 호출은 없습니다.
+
+```bash
+python -m pip install "antemortem-structural-lab[qa,solver] @ https://github.com/hibou04-ops/antemortem-structural-lab/releases/download/v0.6.0a1/antemortem_structural_lab-0.6.0a1-py3-none-any.whl"
+python -m tomolab discovery-demo --case sequence --budget 12 --pool-size 32 --shrink-budget 16 --solver z3 --output results/discovery.json
+python -m tomolab discovery-demo --case state --budget 16 --pool-size 32 --shrink-budget 32 --output results/state.json
+```
+
+`sequence`는 리스트와 offset을 검사하고, `state`는 push/pop trace의 상태 불변식을 검사합니다. 결과에는 실제 호출 수, 생성·평가·축소를 포함한 시간, 동결 상태, native Strategy/Z3 계측, 축소 반례와 재실행 결과가 들어갑니다. CPU는 평가기와 관측 가능한 worker process tree를 나누고 RSS는 동결 시점 표본이며 peak가 아닙니다. 시간 예산은 협력적 검사여서 종료하지 않는 대상 함수를 중단하지 않습니다.
+
+소스 checkout에서 승인된 공개 구조와 전이를 확인하려면:
+
+```bash
+python -m pip install -e ".[qa,solver,analysis]"
+python -m tomolab discovery-inspect examples/discovery/sequence_target.py --spec examples/discovery/sequence-spec.json --output results/public-ir.json
+python -m tomolab discovery-run examples/discovery/sequence_target.py --oracle-file examples/discovery/sequence_oracle.py --spec examples/discovery/sequence-spec.json --public-source examples/discovery/sequence_target.py --allow-local-execution --budget 12 --pool-size 32 --shrink-budget 16 --solver z3 --output results/discovery.json
+python -m tomolab discovery-plan --snapshot results/discovery.json --spec examples/discovery/sequence-renamed-spec.json --public-source examples/discovery/sequence_renamed.py --budget 8 --pool-size 32 --solver z3 --output results/transfer.json
+```
+
+`--public-source`는 사용자가 Generator에 제공하도록 승인한 개발 소스입니다. 생략하면 대상 소스를 자동 공개하지 않습니다. `discovery-inspect`는 import/실행 없이 AST를 읽습니다. 실행 어댑터는 한 개의 명시적 불변식과 서로 다른 신뢰된 대상·Oracle callable을 요구합니다. Oracle 예외는 기본 전파하며, 승인한 내장 예외 종류만 `--expected-exception ValueError` 등으로 계약에 포함할 수 있습니다.
+
+### 정보 경계와 기존 도구의 역할
+
+기본 `subprocess`는 `LOGICAL_ISOLATION_ONLY`입니다. JSON 필드 검증과 동결 후 feedback 차단은 부모·worker 양쪽에서 강제하지만 같은 호스트 파일 권한을 공유합니다. 선택적 Docker는 Generator allowlist만 읽기 전용 mount하고 네트워크·권한을 제한합니다. 대상과 Oracle은 호스트에서 실행되므로 반드시 신뢰해야 합니다. [보안 모델](SECURITY.md)을 먼저 확인하세요.
+
+```bash
+docker build -f containers/e5-generator.Dockerfile -t tomolab-e5-generator:local containers
+python -m tomolab discovery-demo --backend docker --solver z3 --budget 12 --pool-size 32 --output results/container-discovery.json
+```
+
+Hypothesis는 본래의 복합 Strategy와 shrinking을 담당합니다. Z3는 지원된 유한 정수 관계의 일관성·판별 witness를 담당합니다. CrossHair는 `analysis` extra의 **소스 접근형 별도 평가 기준선**이며 Generator에 포함되지 않습니다. CrossHair의 내부 호출 수는 관측되지 않으면 `UNKNOWN`입니다. E5는 이 도구들의 보편적 대체나 우월성을 주장하지 않습니다.
+
+### 검증 결과와 한계
+
+E1·E2·E3의 `NO_IMPROVEMENT`와 E4의 외적 일반화 미입증 기록, 기존 태그와 MRI·CAST·Claim-to-Witness 기능은 보존합니다. E5 개발 비교는 새로 작성한 다섯 mutation 계열과 두 clean control을 사용했습니다. 적용 가능한 Hypothesis·E5·CrossHair는 모두 다섯 계열을 찾았고 control 오탐은 없었습니다. E4는 두 정수 이외 영역을 `NOT_COMPARABLE`로 처리했습니다. E5/Hypothesis 개발 wall time 중앙 비율은 2.660, 최초 발견 호출 비율은 1.0이며 효율 개선 판정은 `NO_IMPROVEMENT`입니다.
+
+440개 새 개발 입력의 후보 제약 점검에서 5개 대표 후보 중 2개가 반증됐습니다. 반증된 후보를 확정 제약으로 승격하지 않습니다. 전이 gate 28/28은 타입·역할·정적 계약의 허용/거부 검사이며 새 대상의 결함 재현 정확도가 아닙니다. 최종 검증은 코드·계약·source mold를 먼저 동결하고 한 번만 실행하며, 이전 E1~E4 소비 홀드아웃은 재사용하지 않습니다. 자세한 결과와 미검증 범위는 [E5 평가 기록](docs/E5_INTEGRATION.md)에 있습니다.
+
+동적 import, async, 임의 부작용 코드, 무제한 상태 객체·반복문 의미 복원, 전역 최소 반례 보장, 임의 자연어 계약 증명은 지원하지 않습니다. finite float는 Python 실행으로 확인하며 Z3 실수 근사로 float 정답을 증명하지 않습니다. 정적 graph 일치는 의미 동치가 아니고, 개발 로그의 진실성은 해시만으로 인증되지 않습니다.
+
+
+## 어떤 문제를 다루나요?
+
+정적 분석은 코드의 조건을 보여 주지만 실제 위반을 확인하려면 실행이 필요합니다. 무작위 테스트는 위반을 찾을 수 있지만 이전 실패에서 얻은 구조를 다음 입력에 사용하지 않을 수 있습니다. 이 도구는 두 정보를 연결하고, 발견한 반례와 가설의 출처를 남깁니다.
+
+Mold는 실패 좌표 하나를 다른 프로그램에 그대로 적용하지 않습니다. 같은 증거를 설명하는 여러 관계식을 유지하고, 서로 다른 예측을 내는 입력을 선택합니다. 새 대상에서는 변수의 역할과 명시된 계약을 먼저 확인합니다. 계약이 맞더라도 **탐색에 사용할 수 있다는 뜻이며, 같은 결함이 존재한다는 증명은 아닙니다.**
+
+## 구조와 지원 기능
+
+```mermaid
+flowchart LR
+    S[공개 명세] --> G[Generator]
+    M[MRI: 코드 구조] --> C[기존 CAST 탐사]
+    G --> X[입력 후보]
+    X --> O[별도 Oracle 평가]
+    O --> F[최소 실패·반증 증거]
+    F --> V[경쟁 가설 제거·Mold 버전]
+    V --> Q[정보 획득·다양성 선택]
+    Q --> G
+    V --> Z[동결된 후보 계획]
+    Z --> H[독립 최종 평가]
+```
+
+| 기능 | 구현 범위 |
+| --- | --- |
+| MRI / CAST | 제한된 Python 조건문 분석, 분기 관측, 참조 함수와 결과 비교 |
+| Claim-to-Witness | 한국어·영어의 고정 문장 6개를 관계식 3종에 연결, 반례 저장·재실행 |
+| Mold | 실패 로그 정규화, 유한 관계식 가설 공간, 반례에 의한 후보 제거 |
+| 다음 입력 선택 | 가설 간 불일치가 큰 입력과 주기적인 공간 다양성 탐사 |
+| 제약·이력 | 증거, 반증, 경쟁 가설, 버전, 출처, 범위, 불확실성을 JSON으로 보존 |
+| 적용 검사 | 변수 역할의 일대일 대응, 연산 의미·불변식·계약 일치 확인; 불충분하면 `UNKNOWN` |
+| Solver | 기본 유한 영역 열거; 선택적으로 Z3 사용 |
+| 평가 경계 | 생성기 별도 프로세스, 선택적 Docker 생성기, 동결 후 학습 차단 |
+| 속성 기반 테스트 | 기존 Mold 후보를 Hypothesis로 검사, 평가기 전용 수치 반례 축소, 중복 평가 캐시 |
+| 확장 구조 관계 | 공개 AST 산술·비교·Boolean 관계식, enum/Z3 일관성, 구조 증거 기반 후보 필터 |
+
+새 Mold의 관계식은 `left`와 `right` 역할에 대한 합·차·절댓값 관계와 합의 나머지(2·3·5)입니다. 지원하는 정수 임계값과 `eq` / `le` / `ge` 비교로 가설 공간을 구성합니다. 자유로운 프로그램 의미를 자동으로 복원하지 않습니다.
+
+## 빠른 시작
+
+Python **3.11 이상**이 필요합니다. 기본 실행에는 유료 모델·API나 Z3가 필요하지 않습니다.
+
+GitHub Release의 wheel 설치:
+
+```bash
+python -m pip install https://github.com/hibou04-ops/antemortem-structural-lab/releases/download/v0.6.0a1/antemortem_structural_lab-0.6.0a1-py3-none-any.whl
+python -m tomolab mold-demo --budget 32 --seed 7 --backend subprocess --solver enumeration --output results/mold.json
+```
+
+`mold-demo`는 동봉된 검토 가능한 예제만 실행합니다. 결과의 `status`는 `COUNTEREXAMPLES_FOUND` 또는 `NOT_REFUTED_WITHIN_BUDGET`입니다. `failures`에는 최소 실패 증거, `snapshot`에는 경쟁 가설과 Mold 버전이 들어갑니다. 대상·Oracle 해시, 호출 수, 격리 수준도 기록합니다. 실패를 찾지 못했거나 가설이 하나로 줄었다는 사실만으로 함수의 정확성이 증명되지는 않습니다.
+
+소스와 예제를 함께 받으려면:
+
+```bash
+git clone https://github.com/hibou04-ops/antemortem-structural-lab.git
+cd antemortem-structural-lab
+python -m pip install -e .
+```
+
+PowerShell에서도 명령을 한 줄씩 실행할 수 있습니다. `tomolab` 명령과 `python -m tomolab`은 같은 CLI를 사용합니다. 이 배포는 GitHub Release에 게시하며, PyPI 게시를 전제로 하지 않습니다.
+
+## 사용 예제
+
+### 기존 Claim-to-Witness
+
+첫 명령은 대상 코드를 실행하지 않습니다. 뒤의 실행·재실행 명령은 신뢰하는 로컬 예제를 실행합니다.
+
+```bash
+python -m tomolab claim-compile --claim "두 정수 입력의 순서를 바꿔도 반환값은 같다"
+python -m tomolab claim-run examples/claim_only/symmetry_bug.py --claim "두 정수 입력의 순서를 바꿔도 반환값은 같다" --mode cross --budget 12 --allow-local-execution --output results/symmetry.json
+python -m tomolab claim-replay results/symmetry.json --allow-local-execution
+python -m tomolab demo --mode cross --budget 12
+```
+
+대칭성 예제는 `(17, -3)`에서 15, `(-3, 17)`에서 14를 반환합니다. 정의한 관계식의 반례입니다. 원래 자연어 요구사항의 모든 의미가 검증된 것은 아닙니다. 반례가 없으면 `NOT_REFUTED_WITHIN_BUDGET`으로 남습니다. [Phase C0 상세 설명](PHASE_C_README_KO.md)을 참고하세요.
+
+### 별도 Oracle로 Mold 학습
+
+저장소의 예제 명세·대상·Oracle을 분리해 실행합니다.
+
+```bash
+python -m tomolab mold-run examples/mold/target.py --oracle-file examples/mold/oracle.py --spec examples/mold/spec.json --function implementation --oracle reference --allow-local-execution --budget 32 --seed 7 --output results/mold-run.json
+```
+
+Oracle은 생성기와 별도로 정답을 계산합니다. 생성기는 허용된 구조화 증거만 받아 가설을 갱신합니다. 성공 점수나 자연어 평가는 보상으로 사용하지 않습니다. 관측으로 제거된 가설과 남은 가설을 함께 확인해야 합니다.
+
+### 동결 후 새 명세에 입력 계획
+
+```bash
+python -m tomolab mold-plan --snapshot results/mold-run.json --spec examples/mold/renamed-spec.json --budget 32 --output results/mold-plan.json
+```
+
+이 명령은 대상 함수를 실행하지 않습니다. 동결한 Mold와 공개 명세로 후보만 만듭니다. 변수 이름이 바뀌어도 역할과 계약이 대응하면 `APPLICABLE_FOR_PROBING`으로 탐색을 허용합니다. 근거가 맞지 않으면 `UNKNOWN`으로 남기고 전이 제약 없이 탐색합니다. 최종 평가 결과는 동결된 생성기로 돌려보내지 않습니다.
+
+선택적 Z3 설치는 소스 디렉터리에서 `python -m pip install -e ".[solver]"`로 할 수 있습니다. 이후 `--solver z3`를 사용하세요. Z3가 없으면 해당 선택은 명시적으로 실패하며, Z3로 검사한 것처럼 표시하지 않습니다. 기본 Docker 이미지는 Z3를 포함하지 않습니다.
+
+### Hypothesis 반례 생성·축소와 AST 제약 검사
+
+```bash
+python -m pip install -e ".[qa,solver]"
+python -m tomolab pbt-demo --budget 32 --shrink-budget 128 --output results/pbt.json
+python -m tomolab constraints-check --spec examples/mold/spec.json --expression "abs(x - y) <= 3 and x + y >= 2" --solver z3
+python -m tomolab pbt-run examples/mold/target.py --oracle-file examples/mold/oracle.py --spec examples/mold/spec.json --allow-local-execution --output results/pbt-run.json
+```
+
+Hypothesis는 고정된 Mold 후보에서 검사·인덱스 축소를 수행하고, 동결 후 평가기에서
+정수 반례를 추가로 축소합니다. `budget`은 후보 수이며 실제 호출수는 JSON의
+`metrics.oracle_calls`입니다. 반복 검색은 캐시로 제거합니다. AST 관계식은 별도 API로
+확장하며 기존 Mold 선택 문법은 유지합니다. 두 정수 입력과 유한 범위만 지원합니다.
+Oracle 판정과 주관적 평가를 분리하고 최종 피드백은 차단합니다.
+[E4 구현·검증·미구현 범위](docs/E4_IMPLEMENTATION.md)에 측정 정의와 한계를 기록했습니다.
+
+## 기존 도구와의 관계
+
+- **Hypothesis**는 폭넓은 속성 기반 테스트 도구이며 E4에서 직접 통합합니다. 이 패키지가 이를 대체하거나 성능에서 앞선다는 증거는 없습니다.
+- **CrossHair**는 Python의 계약을 심볼릭 실행으로 검사합니다. 기존 비교에서 동일한 합성 결함 세 종류를 모두 찾았습니다. [비교 fixture](baselines/crosshair_claim_contracts.py)는 보존합니다.
+- **Z3**는 선택적인 제약 검사 backend입니다. 기본은 작은 유한 영역을 완전히 열거하는 방식이며, 무제한 정수 공간의 증명을 주장하지 않습니다.
+- **Jev**는 기존 분기 탐사에서 선택할 수 있는 후보 생성 연결입니다. Mold·Claim 경로는 유료 호출 없이 실행됩니다. [연결 이력](JEV_CONNECTION_CHANGELOG.md)과 [외부 기술 안내](docs/THIRD_PARTY.md)를 참고하세요.
+
+## 연구 결과와 한계
+
+E1은 `E1_EXECUTED_NO_IMPROVEMENT`, E2는 `E2_EXECUTED_NO_IMPROVEMENT`였습니다. E2의 후보 평가 26,880회에서 A/B/C/D의 주입 지점×시드 발견 합계는 76/75/72/76이었고, 시드를 합친 고유 주입 지점은 모두 16개였습니다. D와 기준선 A의 최종 후보·결과는 동일했고 새로운 portable constraint는 0개였습니다. 이 숫자는 독립적인 실제 결함 수가 아닙니다.
+
+E3에서는 새로운 합성 문제로 후보 7,040회를 평가했습니다. 최종 평가에서 uniform/Mold의 주입 지점×시드 발견 수는 **30/30**, 고유 지점은 **6/6**이었습니다. 첫 발견 평균 호출은 21.025에서 17.5로 줄었지만(미발견은 65로 처리), 사전 기준이 요구한 발견 범위 증가는 없어 **`NO_IMPROVEMENT`**, 일반화는 **`GENERALIZATION_UNKNOWN`**입니다. 반복 실패 입력 증가를 새 결함 발견으로 세지 않습니다.
+
+조건·집계는 [E3 평가 설명](docs/E3_EVALUATION.md), 구현·설치 검증은 [릴리스 검증 기록](docs/RELEASE_VALIDATION.md)과 [v0.3.0a1 릴리스 노트](docs/releases/v0.3.0a1.md)에 구분해 기록합니다. E1/E2 평가 자료는 이미 소비된 자료이며 새 블라인드 결과로 재사용하지 않았습니다. 일반적인 실제 프로젝트에 대한 우월성은 입증되지 않았습니다.
+
+현재 Mold는 **순수하고 결정적인 정수 입력 2개·정수 출력 함수**와 최대 4,225개의 유한 입력 영역(각 축 최대 65개)을 대상으로 합니다. 임의의 상태 전이 프로그램, 부동소수점, 외부 부작용, 자유로운 자연어 의미 검증은 지원하지 않습니다. 가설 공간 밖의 실패 구조를 복원할 수 있다고 가정하지 않습니다.
+
+## 안전 모델
+
+`--allow-local-execution`은 실행 동의 표시이며 보안 샌드박스가 아닙니다. 대상과 Oracle은 평가기 호스트에서 현재 사용자 권한으로 실행되므로 직접 작성했거나 검토한 코드에만 사용하세요.
+
+기본 `subprocess` backend는 별도 프로세스 통신을 사용하지만 파일 접근 권한은 공유하므로 **`LOGICAL_ISOLATION_ONLY`**입니다. Docker backend는 생성기에 공개 코드만 읽기 전용으로 제공하고 네트워크·쓰기·권한을 제한합니다. 이것이 대상 Python 코드를 적대적 코드용 샌드박스로 바꾸지는 않습니다. Docker 준비와 실제 접근 통제 검증 범위는 [보안 안내](SECURITY.md)를 확인하세요.
+
+결과에는 입력과 로컬 경로가 포함될 수 있습니다. `results/`와 비공개 연구 자료를 공개 저장소나 릴리스에 올리지 마세요.
+
+## 개발·기여·이력
+
+```bash
+python -m pip install pytest build twine
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+```
+
+[기여 안내](CONTRIBUTING.md) · [이슈](https://github.com/hibou04-ops/antemortem-structural-lab/issues) · [Actions](https://github.com/hibou04-ops/antemortem-structural-lab/actions)
+
+보이지 않는 개미집에 거푸집을 떠 내부 통로를 드러내는 모습에서 MRI·CAST라는 비유를 가져왔습니다. 초기 실험은 별도 보관본에서 Git으로 가져왔고, 커밋 시각을 과거 연구 시각으로 꾸미지 않았습니다. 기존 태그와 가져오기 기록은 [공개 이력 안내](PUBLIC_IMPORT_NOTICE.md)에 보존합니다.
+
+| 버전 | 주요 변화 |
+| --- | --- |
+| [v0.1.0](docs/releases/v0.1.0.md) | 참조 함수를 사용하는 MRI·CAST 분기 탐사 |
+| [v0.1.1](docs/releases/v0.1.1.md) | 선택적 TypeSafe Jev 연결 |
+| [v0.2.0](docs/releases/v0.2.0.md) | Claim-to-Witness 관계식 반례 탐사 |
+| [v0.3.0a1](docs/releases/v0.3.0a1.md) | 경쟁 가설·능동 질의·적용 검사 기반 Mold 통합 |
+| [v0.4.0a1](docs/releases/v0.4.0a1.md) | Hypothesis 생성·축소, AST/Z3 검사, typed 정보 경계 강화 |
+
+자연어와 검증 조건 사이의 의미 보존을 다루는 C1은 [별도 연구 PR](https://github.com/hibou04-ops/antemortem-structural-lab/pull/1)입니다. 이 릴리스의 Mold 구현과 혼동하지 마세요. 이 저장소는 [antemortem-cli](https://github.com/hibou04-ops/antemortem-cli)와 별개의 실험 프로젝트입니다.
+
+Apache License 2.0 — [LICENSE](LICENSE).