doslang 작업 규칙

DOS용 시스템 프로그래밍 언어 Ferro와 그 컴파일러 fec. 규범 문서는 SPEC.md이며 이 파일은 그것을 구현할 때의 작업 규칙만 다룬다.

문서 지도

VM 자동화 명령 목록과 플래그는 문서가 아니라 CLI가 규범이다. 문서에 복제하면 반드시 드리프트하므로 아래로 확인한다.

uv run ferro-vm --help
uv run ferro-vm <command> --help
uv run ferro-test --help

개발 중 빠른 회귀 검사는 uv run ferro-test run --through <milestone>로 DOSBox-X에서 수행한다. 이 경로도 컴파일러 A를 DOS 내부 Open Watcom으로 매번 새로 빌드한다.
마일스톤의 최종 공식 검증은 QEMU FreeDOS 내부에서만 한다. DOSBox-X 결과는 개발용 smoke test이며 완료 게이트를 대체하지 않는다.
컴파일러 A와 생성 C 모두 VM 안의 Open Watcom으로 컴파일한다. 컴파일러 A와 bits16은 WCL, bits32 생성 C는 WCL386.
호스트에서 컴파일하지 않는다. WSL이나 호스트 C 컴파일러 결과는 정식 검증으로 인정하지 않는다. 호스트는 편집, diff, Git, 파일 전송에만 쓴다.
authoritative workspace는 VM의 C:\FEC다.
마일스톤 완료 기준은 C:\FEC\BUILD.OK, C:\FEC\TEST.OK, TEST-DOS.BAT exit 0 세 가지를 모두 확인하는 것이다. 테스트가 증명하지 않는 기능은 완료로 처리하지 않는다.
VGA 데모처럼 멀티모달 수동 검증이 필요한 항목은 완료 게이트에서 제외한다.

VM 안에서 반복해서 물렸던 것들. 어기면 원인 찾기 어려운 실패가 난다.

컴파일러 A는 16비트 large model로 빌드한다. small model은 메모리 부족으로 실패한다.
링크는 *.obj 와일드카드로 한다. DOS 명령줄 길이 제한 때문에 오브젝트를 나열할 수 없다. 그래서 fec/build-dos.bat는 먼저 C:\FEC\*.obj를 지워 stale 32비트 test object가 섞이지 않게 한다.
M4 Watcom 테스트는 -wx -wcd=202를 쓴다. 생성 C의 보수적 미사용 helper 때문에 W202만 끄고 나머지 경고는 오류로 유지한다.
fixture는 짧은 이름으로 전송한다. DOS 8.3 파일명 때문에 긴 이름은 BAD-ARI.FE, TRY-FPR.FE처럼 명시적으로 줄여야 한다.
D:에서 빌드하지 않는다. QEMU의 vvfat 뷰는 교환용이며, 과거 D:에서 빌드하다 rename 처리 오류로 QEMU가 종료된 적이 있다. 호스트에서 편집한 파일은 put으로 C:에 올린 뒤 컴파일한다.
긴 DOS 배치가 멈추면 QEMU를 재시작하기 전에 Ctrl+C 주입을 먼저 시도한다. Terminate batch file ... (Yes/No/All)?가 뜨면 y, ret을 보내고 ping 복구를 확인한다.

명세 판단이 바뀌면 SPEC.md를 즉시 갱신하고 SPEC.AUDIT.md에 사유를 누적한다. 구현이 명세와 다르면 둘 중 하나가 틀린 것이므로 그 자리에서 결론을 낸다.
검증된 마일스톤마다 커밋하고 항상 origin에 푸시한다.
primary 브랜치는 master다.
.qemu/*.png, .qemu/*.ppm은 진단용이며 커밋하지 않는다.

M1~M5 완료 및 QEMU/Open Watcom 검증됨.
다음은 M6(R1~R8 대여 검사)다. 착수할 때 소유권 로직을 check.c/emit_c.c에서 own.c/h로 분리한다 (SPEC.md §11.3).
v0.1.6에서 R8(파생 반환), R6(마지막 사용까지 대여), R10(전역 대여 금지)이 바뀌었다. 셋 다 own.c의 상태 기계를 건드리므로 분리 이후에 함께 구현한다.