# samples — 문법 탐침

여기 있는 `.cool` 파일은 **명세가 아니라 탐침**이다. 목적은 하나:
`docs/thesis.md`의 v0 성공 기준 중 "체감" 항목 — 확정된 규칙(use/own, affine,
effect 변수, TaskScope)으로 짠 코드가 사람이 읽을 만한지 — 을 EBNF를 쓰기 전에
눈으로 확인하는 것.

파서는 아직 없으므로 이 파일들은 컴파일되지 않는다.

| 파일 | 검증 대상 |
|---|---|
| 01_capability_signature | use 파라미터 + effects 절, capability struct 관용구 |
| 02_higher_order_effects | effect 변수, 구문 수준 제한, use 기본 / own 유표기 |
| 03_scope_concurrency | TaskScope, 이름 있는 scope, 중첩 시 수명 표현 |
| 04_enum_match_interface | enum 정의 본문이 interface surface에 들어가는 경로 |
| 05_move_errors | **에러가 나야 하는** 코드 — 진단 하나씩 |
| 06_affine_closure | callable affinity (fn vs affine fn), use/own과의 직교성 |
| 07_module_interface | interface artifact가 담아야 할 것 전부 |

`05_move_errors.cool`은 통과하면 안 되는 파일이다. 각 함수 주석의 `[E-...]`
태그가 기대 진단이며, 체커가 생기면 그대로 테스트 케이스가 된다.

## 확정된 표기

- 어순: `fn 이름(파라미터) effects {...} -> 반환타입`.
  함수 타입도 동일: `fn(a) effects e -> b`
- 모듈: 파일 = 모듈, `pub`이 exported, `import "domain/path" as Name`
- 재수출: `reexport Name` (전용 키워드 — hash 전파를 동반하므로 구분한다)
- capability 파라미터: `fn f(use pay: Gateway)`
- callable 파라미터: 기본이 use(비탈출, 무표기). 저장하는 쪽만 `own fn`
- 파라미터 밖(반환 타입, struct 필드, channel 원소)의 callable: 무표기 owned
- affine 클로저 타입: `affine fn(a) effects e -> b`
- effect 집합: `effects {Type.method, ...}`, 빈 집합은 생략
- effect 변수: `<e: effects>` 선언, 합집합 `e1 | e2`는 결과 위치 전용
- 제네릭: `List<a>`
- scope: `scope sc { ... }` — 이름 필수, 블록 종료 시 join/cancel
- 오류 전파: `?`

## 아직 열려 있는 것

- 표현식 `a < b`와 제네릭 `List<a>`의 `<` 모호성 해소 방법
- `?`의 정확한 의미론 (Result 전용인지, 어디까지 전파하는지)
- `match` 가드, 중첩 패턴의 범위
- 리터럴 배열 `[...]`과 컬렉션 표기