lint: 파서 오류 복구와 두 lint — 남은 부채를 턴다

파서 오류 복구:
항목 단위로만 회복한다. 문 단위로 더 잘게 회복하려 하면 파서가 추측을
하게 되고, 틀린 추측은 없는 오류를 지어낸다. 한 항목에 오류 하나가
상한이라는 것은 정직한 한계다. 동기화 지점은 중괄호 깊이 0 + 줄 첫머리
+ 선언 시작 토큰 — 셋 다 필요하다. 본문 안의 fn을 새 항목으로 오인하면
그 뒤가 전부 어긋난다. 샘플 08이 이제 오류 넷을 한 번에 보고한다.

두 lint (취향이 아니라 비용이다):
- 미사용 import는 재검사 범위를 넓힌다. 쓰지 않는 모듈의 시그니처가
  바뀌면 이 모듈이 재검사된다.
- effect 과잉 선언은 호출자에게 없는 의무를 지운다. 시그니처는 실제보다
  좁아도 안 되고 넓어도 안 된다.

과잉 선언은 effect 변수가 있거나 본문에 모르는 이름이 있으면 판정하지
않는다. 첫 구현이 샘플 03/06을 오탐으로 잡았는데, 원인이 외부 타입이었다
— 외부 capability의 메서드는 effect를 모르므로 "수행하지 않았다"고 말할
근거가 없다. saw_unknown으로 판정을 보류한다.

Resolve.error에 blocking을 나눴다. 이름 해소 실패는 뒤 단계를 막지만
lint는 막지 않는다 — lint 하나가 진짜 타입 오류를 가리면 루프가 느려진다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019ZVDeU6KLuUVL3gs18Hm3E

samples/08_syntax_errors.cool

@@ -2,7 +2,9 @@
 //
 // 05와 목적이 다르다. 05는 구문은 맞지만 검사기가 거부해야 하는 파일이고,
 // 이 파일은 파서가 거부해야 하는 파일이다.
-// 아직 오류 복구가 없으므로 파서는 첫 오류에서 멈춘다 — 한 번에 하나씩 확인한다.
+// 파서는 항목 단위로 회복한다. 오류가 난 선언은 통째로 버리고 다음 선언에서
+// 다시 시작하므로, 한 항목에 오류 하나가 상한이다. 이 파일은 항목마다 하나씩
+// 심어 회복이 실제로 되는지 본다 — 아래 넷이 모두 보고되어야 한다.
 
 // [E-syntax-effect-union] 파라미터 위치의 합집합은 문법에 존재하지 않는다.
 // 검사기가 아니라 파서가 거부한다 (eff_param 프로덕션에 "|"가 없다).
@@ -19,3 +21,25 @@ pub fn classify(e: PayError) -> String {
         _ => "other",
     }
 }
+
+// [E-syntax-trailing-comma] 다중 줄 목록에는 후행 콤마가 필요하다.
+// 줄바꿈이 목록을 닫으려 하면 원인을 직접 말한다.
+pub fn missing_comma(
+    a: Int,
+    b: Int
+) -> Int
+// ERROR (parse): 다중 줄 목록에는 후행 콤마가 필요합니다
+
+// [E-syntax-scope-parent] 자식 scope는 부모를 명시해야 한다.
+// 부모 없는 작업이 생기지 않게 하는 것은 문법의 일이다.
+pub fn orphan(root: TaskScope) {
+    scope sc {
+        sc.spawn(fn() { })
+    }
+}
+// ERROR (parse): = (자식 scope의 부모를 명시해야 합니다)
+
+// 회복이 되었다는 증거: 이 마지막 선언은 정상적으로 읽혀야 한다.
+pub fn fine(n: Int) -> Int {
+    n + 1
+}

samples/13_lints.cool

@@ -0,0 +1,35 @@
+// 13. 두 lint — 미사용 import와 effect 과잉 선언
+//
+// 둘 다 취향 문제가 아니라 비용 문제다.
+//
+// 미사용 import: 쓰지도 않는 모듈의 시그니처가 바뀌면 이 모듈이 재검사된다.
+// 증분 루프의 비용을 아무 이유 없이 넓히는 선언이다.
+//
+// effect 과잉 선언: 선언한 effect를 수행하지 않으면 호출자는 하지도 않는
+// 일에 대한 의무를 진다 — 자기 effects 절을 넓히거나 capability를 받아온다.
+// 시그니처는 실제보다 좁아도 안 되고 넓어도 안 된다.
+
+import "cool.dev/std/list" as List
+// ERROR: List을(를) 가져왔지만 쓰지 않습니다
+
+pub capability Db {
+    fn read(id: Int) effects {Db.read} -> Int
+    fn write(id: Int) effects {Db.write}
+}
+
+// Db.write는 선언만 하고 수행하지 않는다.
+pub fn only_reads(db: Db, id: Int) effects {Db.read, Db.write} -> Int {
+    db.read(id)
+}
+// ERROR: only_reads은(는) Db.write을(를) 선언했지만 수행하지 않습니다
+
+// 정확히 선언하면 통과한다.
+pub fn honest(db: Db, id: Int) effects {Db.read} -> Int {
+    db.read(id)
+}
+
+// effect 변수가 있으면 판정하지 않는다. e에 무엇이 묶일지는 호출 지점이
+// 정하고, 본문만 보고는 알 수 없다 — 모르는 것을 틀렸다고 말하지 않는다.
+pub fn polymorphic[e: effects](f: fn() effects e) effects e {
+    f()
+}

samples/README.md

@@ -31,6 +31,11 @@
 capability를 직접 정의해야 메서드의 effect가 알려지고, 05는 affinity의 뿌리가
 capability라 자원 타입을 정의해야 affine임이 유도된다.
 
+13은 두 lint다. 미사용 import는 재검사 범위를 넓히고, effect 과잉 선언은
+호출자에게 없는 의무를 지운다 — 둘 다 취향이 아니라 비용이다. 미사용
+import는 lint이므로 뒤 단계를 막지 않는다: 같은 파일의 타입 오류가 함께
+보고된다.
+
 12는 표준 라이브러리가 생긴 뒤에야 가능해진 파일이다. std가 없을 때는
 `List.each`가 모르는 이름이라 조용히 통과했다 — "모르는 것을 틀렸다고 말하지
 않는다"는 맞는 원칙이지만 그 그늘에 검사되지 않는 영역이 있었다.