# TODO

현재: **188/188** (`uv run python tests/run.py`)

프론트엔드는 끝났다. 목표는 **i386 백엔드 + stdlib 으로 Windows 11 용 컴파일러를
완성하는 것**이다. 아직 실행된 Ferro 프로그램은 하나도 없다.

---

## 남은 일

| # | 일 | 규모 | 비고 |
|---|---|---|---|
| 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` |

## 그 이후

| | | |
|---|---|---|
| 셀프호스팅 | 대 | `fec` 을 Ferro 로. 여기까지 오면 언어가 자기 무게를 견딘다는 증거 |
| 인터럽트·공유 상태 | 중 | `interrupt` `shared` `atomic` `critical` — 파싱만 되고 의미 없음. SPEC §11 에서 v0.2 |
| 다른 32비트 타깃 | 대 | m68k / ARM / MIPS / RV32. IR 결정은 전부 ISA 중립이라 백엔드만 붙이면 됨 |

---

## 미결 결정

| | 내용 | 언제 |
|---|---|---|
| 덩어리 전달 규약 | 정함 (전부 주소로). 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            IR + lowering
3 → 4 → 5        i386 백엔드, 런타임, 실행 검증 복귀   ← 여기서 처음 실행됨
6 → 7            stdlib
```

---

## 위임 정책

**위임 가능** — 결과가 자명하고 판단이 없는 것

- fixture 이름 개선, README 갱신, 문서 정합
- 파일 목록을 **명시적으로 열거해서** 줄 것. "찾아서 하라" 는 약함
- 기준선 두 숫자(`N/188`, `M pin`)를 주고 **변하면 안 된다**고 못박을 것

**위임 불가** — 언어 의미론 판단이 섞인 것

- 마커 판정, IR/lowering/백엔드, stdlib 명세

---

## 미뤄둔 정리 작업

fixture 122개 이름이 아직 DOS 8.3 시절 잔재라 무엇을 검사하는지 이름만으로는
알 수 없다. 마커가 전부 붙었으므로 `bad`/`ok` 접두사는 이제 기대값이 아니고,
자유롭게 이름을 지을 수 있다. 급하지 않다.