freelang-editor 11.7.4

package/.github/CONTRIBUTING.md

@@ -0,0 +1,296 @@
+# FreeLang v9에 기여하기
+
+FreeLang v9 프로젝트에 기여해주셔서 감사합니다! 🙏
+
+이 가이드는 어떻게 기여할 수 있는지 설명합니다.
+
+---
+
+## 🤝 기여하는 방법
+
+### 1. 버그 리포트
+**문제를 찾으셨나요?**
+
+1. [버그 리포트 이슈](./github/ISSUE_TEMPLATE/bug-report.md) 생성
+2. 다음 정보 포함:
+   - 재현 방법
+   - 예상 동작
+   - 실제 동작
+   - 환경 정보
+   - 스크린샷/로그
+
+**체크리스트:**
+- [ ] 비슷한 이슈 검색함
+- [ ] 최신 버전에서도 발생하는지 확인
+- [ ] 재현 단계가 명확함
+- [ ] 환경 정보 포함함
+
+### 2. 기능 요청
+**새로운 기능 아이디어가 있나요?**
+
+1. [기능 요청 이슈](./github/ISSUE_TEMPLATE/feature-request.md) 생성
+2. 또는 [Discussion](./github/DISCUSSIONS.md)에서 토론
+
+**포함할 내용:**
+- [ ] 기능 설명
+- [ ] 사용 사례
+- [ ] 코드 예제
+- [ ] 대안 검토
+
+### 3. 코드 기여
+**코드로 기여하고 싶으신가요?**
+
+#### Step 1: 준비
+```bash
+# 저장소 포크
+git clone https://github.com/YOUR_USERNAME/freelang-v9.git
+cd freelang-v9
+
+# 브랜치 생성
+git checkout -b feature/your-feature-name
+```
+
+#### Step 2: 개발
+```bash
+# 의존성 설치
+npm install
+
+# 테스트 실행
+npm test
+
+# 개발 서버 시작
+npm run dev
+```
+
+#### Step 3: 커밋
+```bash
+# 변경사항 스테이징
+git add .
+
+# 의미 있는 메시지로 커밋
+git commit -m "feat: 기능 설명"
+
+# 푸시
+git push origin feature/your-feature-name
+```
+
+#### Step 4: Pull Request
+1. GitHub에서 PR 생성
+2. PR 템플릿 채우기:
+   - 무엇을 변경했는가?
+   - 왜 이 변경이 필요한가?
+   - 어떻게 테스트했는가?
+
+#### Step 5: 리뷰
+- 코드 리뷰 받기
+- 피드백 반영
+- 승인 후 머지
+
+---
+
+## 📋 기여 체크리스트
+
+### 코드 기여 전
+- [ ] 이슈나 Discussion에서 먼저 논의
+- [ ] 비슷한 PR이 없는지 확인
+- [ ] 타겟 브랜치는 `master`
+- [ ] 최신 코드로 리베이스
+
+### 코드 작성 중
+- [ ] v9-First 정책 따름 (stdlib는 TS, 앱은 v9)
+- [ ] 기존 패턴 따름
+- [ ] 주석 추가 (필요시)
+- [ ] 타입 안정성 유지
+
+### 제출 전
+- [ ] 테스트 추가/수정
+- [ ] 모든 테스트 통과: `npm test`
+- [ ] TypeScript 오류 없음: `npm run type-check`
+- [ ] 커밋 메시지가 명확함
+- [ ] CHANGELOG 업데이트
+
+---
+
+## 💻 개발 환경
+
+### 요구사항
+- Node.js 18+
+- npm 9+
+- 터미널 (bash/zsh/PowerShell)
+
+### 설치
+```bash
+git clone https://github.com/kimjindol2025/freelang-v9.git
+cd freelang-v9
+npm install
+```
+
+### 주요 명령어
+```bash
+npm test          # 테스트 실행
+npm run build     # 빌드
+npm run dev       # 개발 모드
+npm run format    # 코드 포매팅
+npm run type-check # 타입 체크
+```
+
+---
+
+## 📚 코드 스타일
+
+### 커밋 메시지
+```
+type: 짧은 설명 (50자 이하)
+
+자세한 설명 (필요시)
+- 줄 바꿈으로 구분
+- 70자 이내로 감싸기
+```
+
+**타입:**
+- `feat:` 새로운 기능
+- `fix:` 버그 수정
+- `docs:` 문서
+- `style:` 코드 스타일
+- `refactor:` 리팩토링
+- `test:` 테스트
+- `chore:` 기타
+
+### 코드 포매팅
+```bash
+# 자동 포매팅
+npm run format
+
+# 체크만
+npm run format:check
+```
+
+---
+
+## 🧪 테스트
+
+### 테스트 작성
+```typescript
+describe('기능명', () => {
+  it('동작을 설명', () => {
+    expect(result).toBe(expected);
+  });
+});
+```
+
+### 테스트 실행
+```bash
+npm test                    # 모든 테스트
+npm test -- --watch        # 감시 모드
+npm test -- --coverage     # 커버리지 리포트
+```
+
+### 커버리지 목표
+- 최소 80% 라인 커버리지
+- 모든 새로운 기능은 테스트 필수
+
+---
+
+## 📖 문서 기여
+
+### 문서 추가
+```bash
+# 새 문서 생성
+docs/guide/새-주제.md
+```
+
+### 마크다운 템플릿
+```markdown
+# 제목
+
+## 소개
+
+## 사용법
+
+## 예제
+
+## 다음 단계
+
+---
+
+[이전 페이지](../path/) | [메인](../README.md)
+```
+
+### 문서 테스트
+```bash
+# 로컬에서 보기
+cd docs
+bundle install
+jekyll serve
+```
+
+---
+
+## 🎯 기여 아이디어
+
+### 쉬운 작업 (초보자)
+- 문서 개선
+- 오타 수정
+- 예제 추가
+- 라벨 추가
+
+### 중간 작업
+- 버그 수정
+- 테스트 추가
+- 작은 기능
+- 리팩토링
+
+### 어려운 작업
+- 새로운 stdlib 모듈
+- 언어 기능 추가
+- 성능 최적화
+- 아키텍처 개선
+
+---
+
+## 🚀 릴리스 프로세스
+
+1. **기능 완료**: 모든 테스트 통과
+2. **버전 업데이트**: package.json
+3. **CHANGELOG 작성**: 변경 사항 기록
+4. **PR 검토**: 유지보수자 승인
+5. **머지**: main 브랜치에 머지
+6. **릴리스**: npm publish
+7. **태그**: Git 태그 생성
+
+---
+
+## 🤔 FAQ
+
+### Q: 첫 기여는 어떻게 시작하나요?
+A: "good first issue" 라벨을 찾아서 시작해보세요!
+
+### Q: 큰 변경을 하려면?
+A: 먼저 Discussion이나 이슈에서 논의해주세요.
+
+### Q: 리뷰는 얼마나 걸리나요?
+A: 보통 3-7일 내에 피드백을 드립니다.
+
+### Q: 내 PR이 거절되면?
+A: 피드백을 반영해서 다시 시도하거나 Discussion에서 논의할 수 있습니다.
+
+---
+
+## 📞 도움이 필요하신가요?
+
+- **질문**: [Discussions - Help](https://github.com/kimjindol2025/freelang-v9/discussions?discussions_q=category%3AHelp)
+- **버그**: [Issues - Bug](https://github.com/kimjindol2025/freelang-v9/issues?q=is%3Aissue+label%3Abug)
+- **문서**: [CLAUDE.md](./CLAUDE.md)
+- **블로그**: [blog.dclub.kr](https://blog.dclub.kr)
+
+---
+
+## 💝 감사의 말
+
+FreeLang v9에 기여해주셔서 감사합니다! 🙏
+
+당신의 기여는 AI를 위한, AI에 의한, AI가 쓰고 싶은 언어를 만드는 데 도움이 됩니다.
+
+---
+
+**Happy coding! 🚀**

package/.github/DISCUSSIONS.md

@@ -0,0 +1,179 @@
+# GitHub Discussions 가이드
+
+FreeLang v9 커뮤니티와 소통하는 방법입니다.
+
+## 📌 Discussion 카테고리
+
+### 💬 General
+**일반 토론, 질문, 아이디어**
+
+- 언어 설계 토론
+- 생태계 개선 아이디어
+- 일반적인 질문
+- 잡담
+
+예제:
+- "v9로 가장 좋아하는 기능은 뭔가요?"
+- "다음 Phase에서 어떤 기능이 필요할까요?"
+
+### 🆘 Help
+**도움 요청, 튜토리얼 질문**
+
+- 설치 문제
+- 문법 이해 어려움
+- API 사용 방법
+- 디버깅 도움
+
+예제:
+- "FLNext로 API를 만드는 방법이 뭔가요?"
+- "이 에러가 무엇을 의미하나요?"
+
+### 📚 Ideas
+**새로운 기능/라이브러리 아이디어**
+
+- stdlib 모듈 제안
+- 언어 기능 제안
+- 개발자 도구 아이디어
+- 통합 제안
+
+예제:
+- "GraphQL 지원 추가하면 좋을 것 같아요"
+- "CLI 대시보드가 있으면 어떨까요?"
+
+### 📢 Announcements
+**공식 소식, 새 릴리스**
+
+- 버전 릴리스
+- 주요 업데이트
+- 행사 안내
+- 일정 공지
+
+### 🎉 Show & Tell
+**만든 것 자랑, 프로젝트 공유**
+
+- v9로 만든 프로젝트
+- 기술 튜토리얼
+- 사용 사례 공유
+- 팁과 트릭
+
+예제:
+- "v9로 TODO 앱을 만들었어요!"
+- "데이터 분석할 때 이렇게 사용하면 좋습니다"
+
+---
+
+## 🚀 시작하기
+
+### Discussion 만들기
+1. GitHub 저장소 → **Discussions** 탭
+2. **New discussion** 버튼 클릭
+3. **Category** 선택
+4. **Title** 작성
+5. **Description** 작성
+6. **Start discussion** 클릭
+
+### Best Practices
+
+#### ✅ DO
+- 명확하고 구체적인 제목 작성
+- 필요하면 코드 예제 포함
+- 관련 이슈/PR 링크 추가
+- 댓글 달 때도 존중하기
+
+#### ❌ DON'T
+- 스팸이나 광고
+- 다른 사람 비난
+- 버그 리포트는 Issues 사용
+- 기술 지원 급함은 Issues 사용
+
+---
+
+## 💡 좋은 Discussion 예제
+
+### 제목
+```
+"v9로 Next.js 같은 풀스택 프레임워크 만들 수 있을까?"
+```
+
+### 본문
+```
+저는 v9로 풀스택 웹 애플리케이션을 만들려고 생각 중입니다.
+현재 FLNext가 있는데, 백엔드 라우팅, 데이터베이스, 
+인증을 한 번에 다룰 수 있는 상위 수준의 프레임워크가 있으면 좋을 것 같습니다.
+
+Next.js의 `app/` 디렉토리 같은 파일 기반 라우팅이라든지,
+자동 API 생성 같은 기능들이요.
+
+혹시 이미 계획이 있거나 구현하신 분 있을까요?
+```
+
+---
+
+## 🤝 커뮤니티 역할
+
+### 유지보수자
+- Discussion 관리
+- 질문 답변
+- Announcement 작성
+- 토론 진행
+
+### 사용자
+- 질문하기
+- 피드백 공유
+- 아이디어 제안
+- 다른 사용자 돕기
+
+### 기여자
+- 아이디어 논의
+- 기술 멘토링
+- 코드 리뷰
+- 튜토리얼 작성
+
+---
+
+## 📊 활동 확인
+
+### 인기 있는 Discussion 보기
+1. **Discussions** 탭 → **Trending**
+2. 최근 활동 확인
+3. 흥미로운 주제 참여
+
+### 팔로우
+- Discussion 옆 **Watch** 클릭
+- 답변이 달리면 알림 받기
+
+---
+
+## 🎯 Community Guidelines
+
+1. **존중**: 모든 사람의 의견 존중
+2. **건설적**: 비판은 건설적으로
+3. **온토픽**: 카테고리에 맞는 내용
+4. **도움**: 질문에 성실하게 답변
+5. **공개**: 개인 정보 공개 금지
+
+---
+
+## 📞 기술 지원
+
+**이런 경우는 Discussion이 아니라 Issue를 사용해주세요:**
+
+- 🐛 버그 발견: [Bug Report Issue](./ISSUE_TEMPLATE/bug-report.md)
+- ✨ 기능 요청: [Feature Request Issue](./ISSUE_TEMPLATE/feature-request.md)
+- 📚 문서: 문서 저장소
+- 🔗 통합: Integration Issues
+
+---
+
+## 🔗 관련 자료
+
+- [Issues 가이드](./CONTRIBUTING.md)
+- [Code of Conduct](./CODE_OF_CONDUCT.md)
+- [공식 문서](../docs/)
+- [블로그](https://blog.dclub.kr)
+
+---
+
+**FreeLang v9 커뮤니티에 참여해주셔서 감사합니다! 🙏**
+
+언어를 함께 발전시켜나가요! 🚀

package/.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,44 @@
+---
+name: 🐛 버그 리포트
+about: 문제가 있나요? 버그를 리포트해주세요.
+title: "[BUG] "
+labels: bug
+assignees: ''
+
+---
+
+## 버그 설명
+<!-- 버그가 무엇인지 명확하고 간결하게 설명해주세요. -->
+
+## 재현 방법
+<!-- 버그를 재현하기 위한 단계를 나열해주세요. -->
+
+1. ...
+2. ...
+3. ...
+
+## 예상 동작
+<!-- 정상적으로 동작했을 때 어떤 일이 일어나야 하나요? -->
+
+## 실제 동작
+<!-- 실제로는 어떻게 되었나요? -->
+
+## 스크린샷/로그
+<!-- 시각적으로 보여주거나 로그를 첨부해주세요. -->
+
+## 환경
+<!-- 당신의 환경 정보를 입력해주세요. -->
+
+- OS: [e.g. Ubuntu 22.04, macOS 13, Windows 11]
+- Node.js 버전: [e.g. 18.0.0]
+- FreeLang v9 버전: [e.g. 9.0.0]
+- 설치 방법: [e.g. npm install -g, 소스에서 빌드]
+
+## 추가 정보
+<!-- 다른 관련 정보가 있으면 추가해주세요. -->
+
+---
+
+**🙏 버그 리포트 감사합니다!**
+
+이 이슈는 가능한 빨리 검토될 것입니다.

package/.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,39 @@
+---
+name: ✨ 기능 요청
+about: 새로운 기능 아이디어를 제안하세요.
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+
+---
+
+## 요청 설명
+<!-- 새로운 기능이 무엇인지 설명해주세요. -->
+
+## 문제/동기
+<!-- 현재 어떤 문제가 있나요? 왜 이 기능이 필요하나요? -->
+
+## 해결책
+<!-- 당신이 생각하는 해결책을 설명해주세요. -->
+
+## 대안
+<!-- 다른 해결책이 있으면 설명해주세요. -->
+
+## 사용 예제
+<!-- 이 기능이 어떻게 사용될지 코드 예제를 보여주세요. -->
+
+```lisp
+; 예제 코드
+```
+
+## 유사 기능
+<!-- 다른 언어나 도구에서 비슷한 기능이 있으면 언급해주세요. -->
+
+## 추가 정보
+<!-- 다른 정보가 있으면 추가해주세요. -->
+
+---
+
+**💡 기능 제안 감사합니다!**
+
+이 요청은 커뮤니티 투표와 검토를 거칩니다.

package/.github/pull_request_template.md

@@ -0,0 +1,87 @@
+## 📝 Pull Request
+
+### 🎯 목적 (What & Why)
+
+<!-- 이 PR이 해결하는 문제 또는 추가하는 기능을 간단히 설명하세요 -->
+
+- [ ] 버그 수정
+- [ ] 기능 추가
+- [ ] 성능 개선
+- [ ] 테스트 추가
+- [ ] 리팩토링
+- [ ] 문서 업데이트
+
+### 📋 변경사항 요약
+
+<!-- 구체적인 변경 내용을 설명하세요 -->
+
+### 🧪 테스트 및 검증
+
+#### Phase C — 자가호스팅 검증 체크리스트
+
+- [ ] ✅ **FL-Token Scan**: `bash scripts/scan-for-fl-tokens.sh stage1.js`
+  - 결과: `All files clean — no FL tokens found`
+
+- [ ] ✅ **Fixed-Point Verify**: `bash scripts/verify-fixed-point.sh`
+  - 예상: `stage1 == stage2 == stage3 == stage4 == stage5` (SHA 일치)
+
+- [ ] ✅ **Let-in-Expression Regression**: `node scripts/check-let-regressions.js`
+  - 예상: `5 passed, 0 failed`
+
+- [ ] ✅ **Jest Regression (Codegen)**: `npm test -- src/__tests__/codegen.let.test.ts`
+  - 예상: `5 passed`
+
+- [ ] ✅ **Full Jest (643 tests)**: `npm test -- --silent`
+  - 로컬: `npm test`
+  - CI: 3 shards 병렬 실행
+  - 예상: 모든 shard PASS
+
+#### CI 상태
+- PR CI Status: [![Build](https://github.com/your-org/freelang-v11/workflows/Phase%20C/badge.svg?branch=feature%2F...)](https://github.com/your-org/freelang-v11/actions)
+
+### 🔄 로컬 검증 순서 (개발자용)
+
+```bash
+# 1. stage1 재생성
+bash scripts/build-stage1.sh
+
+# 2. 토큰 검사 (Early-fail)
+bash scripts/scan-for-fl-tokens.sh stage1.js
+
+# 3. 고정점 검증
+bash scripts/verify-fixed-point.sh
+
+# 4. 회귀 테스트
+node scripts/check-let-regressions.js
+
+# 5. Jest (단일 또는 sharded)
+npm test                          # 전체 (느림)
+./scripts/run-jest-shard.sh all   # 병렬 (빠름)
+```
+
+### 📊 코드 리뷰 포인트
+
+<!-- 리뷰어가 특히 주목해야 할 부분 -->
+
+- [ ] 새로운 symbol/encoding 추가 시: `src/codegen-js.ts` BUILTIN_MAP 및 flNameToJs 확인
+- [ ] let 표현식 변경 시: genSExpr IIFE 래핑 로직 재검증
+- [ ] 생성 JS 변경 시: 위의 검증 체크리스트 필수
+
+### 🔗 관련 이슈
+
+<!-- 관련 이슈 번호 (예: Closes #123) -->
+
+- Closes #
+- Related to #
+
+### 📸 스크린샷 또는 로그
+
+<!-- 필요시 output, logs, artifacts 첨부 -->
+
+### 🚀 추가 정보
+
+<!-- 기타 필요한 정보 -->
+
+---
+
+**Note**: PR이 자동으로 CI를 트리거합니다. Scan 단계 실패 시 머지 불가합니다.