ir: 중간 표현을 정의한다

명령 12개와 종결자 4개. 함수 단위 기본 블록이고 임시값은 블록을 넘지 않아
phi 노드가 없다 -- 블록을 넘겨야 하는 값은 지역을 경유한다. 코드가 조금 더
생기지만 레지스터 할당기를 블록 단위로 유지해 준다.

Ferro 타입은 여기서 사라진다. 구조체·슬라이스·옵셔널·에러 유니온이 전부
mem<N> 이고 필드는 lowering 이 계산한 바이트 오프셋이다. 모노모피제이션이
프론트엔드에서 끝나므로 IR 에 제네릭이라는 개념도 없다.

덩어리는 언제나 주소로 오간다. 크기 임계값이 없어서 ISA 마다 다른 구조체 전달
규칙을 통째로 피해간다. trap 은 이유와 줄 번호만 남기고 파일 이름 문자열은
유닛당 하나를 공유한다.

IR.md 가 설명이고 ir.h/ir.c 가 그 형태다. 아직 아무도 만들지 않는다.

TODO.md

@@ -1,38 +1,31 @@
 # TODO
 
-현재: **150/188** (`uv run python tests/run.py`)
+현재: **188/188** (`uv run python tests/run.py`)
 
-컴파일러는 프론트엔드뿐이다. IR·lowering·백엔드는 없다.
+프론트엔드는 끝났다. 목표는 **i386 백엔드 + stdlib 으로 Windows 11 용 컴파일러를
+완성하는 것**이다. 아직 실행된 Ferro 프로그램은 하나도 없다.
 
 ---
 
-## 프론트엔드 마무리
-
-| # | 일 | 규모 | fixture | 비고 |
-|---|---|---|---|---|
-| 1 | cross-unit 이름 해석 | 중 | units 8 | `util.answer()` 가 다른 유닛 선언을 보게. `check.c` 가 import binding 을 심볼로 알아야 함 |
-| 2 | 가시성 `pub`/private | 중 | units 4 | `privfn` `privfld` `dotpriv` `pubpriv` |
-| 3 | nominal error identity | 중 | units 3 | `errsame` `errdet` `errnom` |
-| 4 | **제네릭 실체화** | 대 | generic 25 | worklist 엔진. **IR 설계에 직접 영향 — 분기점** |
-| 5 | 마커 없는 fixture 37개 판정 | 중 | — | 개당 판단 필요. 아래 참조 |
-
-## 백엔드
+## 남은 일
 
 | # | 일 | 규모 | 비고 |
 |---|---|---|---|
-| 6 | IR 정의 | 중 | 초안 있음. 4번이 정해져야 확정 |
-| 7 | **lowering** | 대 | `try`/`catch`/`defer`/drop/`for`/메서드/경계검사 전개. **프로젝트 무게중심** |
-| 8 | i386 백엔드 | 대 | IR → x86 asm → `wasm` → `wlink`. W11 에서 실행 검증 |
-| 9 | 런타임 최소 세트 | 소~중 | 시작 스텁, `fe_trap`, `malloc`/`free` |
-| 10 | `pending-backend/` 3개 복귀 | 소 | bounds trap, `--no-checks` 차등, 소유권 drop |
+| 1 | **IR 정의** | 중 | 3-address, 기본 블록, 함수 단위. 명령 12 + 종결자 4 |
+| 2 | **lowering** | 대 | `try`/`catch`/`orelse`/`defer`/drop/`for`/메서드/경계검사/옵셔널·에러유니온 구성/제네릭 인스턴스 전개. **프로젝트 무게중심** |
+| 3 | i386 백엔드 | 대 | IR → x86 asm → `wasm` → `wlink` → PE. 명령 선택, 레지스터 할당, 호출 규약 |
+| 4 | 런타임 | 소~중 | 시작 스텁, `fe_trap(reason, file, line)`, 할당, 종료 |
+| 5 | `pending-backend/` 4개 복귀 | 소 | bounds trap, `--no-checks` 차등, 소유권 drop. **처음으로 실행이 검증됨** |
+| 6 | stdlib 명세 | 중 | SPEC §10 이 플레이스홀더. 시그니처·오류·경계 동작 미정 |
+| 7 | stdlib 구현 | 대 | `core` `mem` `fmt` `io` `sys`, 그리고 제네릭이 생겼으니 `list` `map` |
 
 ## 그 이후
 
-| # | 일 | 규모 | 비고 |
-|---|---|---|---|
-| 11 | stdlib | 대 | 현재 49줄, 본문 있는 함수 2개. `List`/`Map` 은 4번에 의존 |
-| 12 | bits16 백엔드 | 대 | `DX:AX` 32비트 산술, 세그먼트. 제일 어려움. 마지막 |
-| 13 | 타깃 의존 구문 | 중 | `far` `asm` `interrupt` `atomic` `critical` `shared` — 파싱만 되고 의미 없음. fixture 도 없음 |
+| | | |
+|---|---|---|
+| 셀프호스팅 | 대 | `fec` 을 Ferro 로. 여기까지 오면 언어가 자기 무게를 견딘다는 증거 |
+| 인터럽트·공유 상태 | 중 | `interrupt` `shared` `atomic` `critical` — 파싱만 되고 의미 없음. SPEC §11 에서 v0.2 |
+| 다른 32비트 타깃 | 대 | m68k / ARM / MIPS / RV32. IR 결정은 전부 ISA 중립이라 백엔드만 붙이면 됨 |
 
 ---
 
@@ -40,27 +33,32 @@
 
 | | 내용 | 언제 |
 |---|---|---|
-| 덩어리 전달 규약 | 정함 (전부 주소로). 8번 착수 전 재확인 | 8 전 |
-| `extern` C 상호운용 | 위 규약이 C ABI 와 안 맞음. 경계 변환 필요 | 8 전 |
-| 주 타깃 | i386/W11 로 기울었으나 SPEC §1.2 는 아직 "640KB 셀프호스팅" | 아무 때나 |
-| stdlib 명세 | SPEC §10 이 플레이스홀더. 시그니처·오류·경계 동작 미정 | 11 전 |
-| `far` 의 거취 | IR 에 안 두기로 함. 언어에서 뺄지 bits16 전용으로 둘지는 미정 | 12 전 |
+| 덩어리 전달 규약 | 정함 (전부 주소로). 3번 착수 전 재확인 | 3 전 |
+| `extern` C 상호운용 | 위 규약이 C ABI 와 안 맞음. 경계 변환 필요 | 3 전 |
+| 엔디안 | 리틀엔디안 가정. `packed struct` 가 바이트 배치를 약속하므로, 빅엔디안 타깃(m68k·MIPS·POWER)이 생기면 타깃 파라미터가 된다 | 다른 타깃 전 |
+| stdlib 명세 | SPEC §10 이 플레이스홀더 | 6 |
+
+## 정해진 것
+
+| | |
+|---|---|
+| 타깃 | **i386 하나.** 세그먼트 없음, `far` 영구 제외 (SPEC §2) |
+| `usize`/`isize` | **타깃의 포인터 폭.** 비트 수를 약속하지 않으므로 64비트 문이 닫히지 않음 |
+| 제네릭 | 모노모피제이션. 순수 프론트엔드 기능이라 IR 에 제네릭 개념이 없음 |
+| 덩어리 전달 | 전부 주소로. 크기 임계값 없음 — ISA 마다 다른 구조체 전달 ABI 를 피해감 |
+| 트랩 | `trap <reason> <line>` → `fe_trap(reason, UNIT_FILE, line)`. 유닛당 파일 문자열 하나 |
+| 셀프호스팅 | 640KB 목표 아님. 32비트 보호모드에서 돈다 (SPEC §2.1) |
 
 ---
 
 ## 순서
 
 ```
-1 → 2 → 3        프론트엔드 유닛 완성
-4                제네릭.  ← 여기서 IR 형태가 결정됨
-6 → 7            IR + lowering
-8 → 9 → 10       i386 백엔드, 실행 검증 복귀
-11               stdlib
-12 → 13          DOS 고유
+1 → 2            IR + lowering
+3 → 4 → 5        i386 백엔드, 런타임, 실행 검증 복귀   ← 여기서 처음 실행됨
+6 → 7            stdlib
 ```
 
-5번은 독립적이라 아무 때나 끼워 넣는다.
-
 ---
 
 ## 위임 정책
@@ -73,43 +71,12 @@
 
 **위임 불가** — 언어 의미론 판단이 섞인 것
 
-- 마커 판정, cross-unit 해석, 가시성, 제네릭, IR/lowering/백엔드
+- 마커 판정, IR/lowering/백엔드, stdlib 명세
 
 ---
 
-## 5번에 대하여 (마커 없는 fixture 37개)
+## 미뤄둔 정리 작업
 
-거부 fixture 76개 중 **37개에 `// ERROR:` 마커가 없다.** 마커가 없으면 러너는
-"거부되기만 하면 통과" 로 판정한다. 즉 **엉뚱한 이유로 거부돼도 초록이다.**
-
-```
-format  10    own  8    types  19
-```
-
-마커를 붙이려면 fixture 마다 "지금 나오는 진단이 옳은가" 를 판정해야 하고,
-그 판정은 세 갈래로 갈린다. 오늘 5건을 조사했을 때 실제로 셋 다 나왔다:
-
-| 결론 | 예 | 조치 |
-|---|---|---|
-| 마커가 틀렸다 | `badbrmov` 한 줄 밀림 | 마커 수정 |
-| 마커가 언어를 오해했다 | `badloop` — 루프 안에서 이미 걸림 | 마커 수정 |
-| **진단이 부실하다** | `badweak` — "type mismatch" 로만 나옴 | **컴파일러 수정** |
-
-세 번째 때문에 위임이 위험하다. 실제 출력을 마커에 그대로 베끼면 전부 초록이
-되지만 **컴파일러가 틀린 곳까지 정답으로 굳는다.**
-
-### 병렬화
-
-판정 자체는 **fixture 간 독립**이라 병렬 가능하다. 다만 **판정을 위임하면 안 된다.**
-쓸 수 있는 형태는 증거 수집과 판정을 나누는 것이다:
-
-```
-위임:  fixture 를 열고 → fec 를 돌리고 → 다음을 보고
-         파일 경로 / 검사하려는 것으로 보이는 규칙 / 실제 진단 전문(줄·문구)
-       마커는 만들지 않는다
-
-직접:  보고를 읽고 세 갈래 중 무엇인지 판정 → 마커를 쓰거나 컴파일러를 고침
-```
-
-이러면 37개를 디렉터리별로 병렬로 뿌려 증거를 모으고, 판정만 직접 하면 된다.
-느린 부분(파일 읽기·실행·정리)이 병렬화되고 위험한 부분은 남는다.
+fixture 122개 이름이 아직 DOS 8.3 시절 잔재라 무엇을 검사하는지 이름만으로는
+알 수 없다. 마커가 전부 붙었으므로 `bad`/`ok` 접두사는 이제 기대값이 아니고,
+자유롭게 이름을 지을 수 있다. 급하지 않다.