freelang-editor 11.7.4

package/docs/guide/frameworks.md

@@ -0,0 +1,319 @@
+# FreeLang v9 프레임워크
+
+FreeLang v9는 실무 개발을 위한 3가지 주요 프레임워크를 제공합니다.
+
+---
+
+## 1. FLNext — 웹 프레임워크
+
+Express 의존성 없이 순수 v9로 작성된 웹 프레임워크.
+
+### 기본 사용법
+
+```lisp
+(import flnext)
+
+[APP
+ :name "my-app"
+ :port 3000
+ :database {:url "sqlite:app.db"}
+ :routes [
+  [GET "/" (fn [req] {:body "Hello World"})]
+  [GET "/users/:id" (fn [req]
+    (user-service/get-user (:id (:params req))))]
+  [POST "/users" (fn [req]
+    (user-service/create-user (:body req)))]
+  [PUT "/users/:id" (fn [req]
+    (user-service/update-user (:id (:params req)) (:body req)))]
+  [DELETE "/users/:id" (fn [req]
+    (user-service/delete-user (:id (:params req))))]
+ ]
+ :middleware [
+  auth-middleware
+  logging-middleware
+  cors-middleware
+ ]]
+```
+
+### ORM (Object-Relational Mapping)
+
+```lisp
+[MODEL User
+ :table "users"
+ :fields [
+  {:name "id" :type "INTEGER" :primary-key true}
+  {:name "email" :type "TEXT" :unique true}
+  {:name "name" :type "TEXT"}
+  {:name "created-at" :type "TIMESTAMP"}
+ ]
+ :indexes [
+  {:name "email_idx" :columns ["email"]}
+ ]]
+
+; CRUD 연산
+(user/create {:email "user@example.com" :name "John"})
+(user/find-by-id 1)
+(user/find-by :email "user@example.com")
+(user/update 1 {:name "Jane"})
+(user/delete 1)
+```
+
+### 스키마 검증
+
+```lisp
+[SCHEMA UserSchema
+ :fields {
+  :email {:type "email" :required true}
+  :password {:type "string" :min 8 :max 128 :required true}
+  :name {:type "string" :min 1 :max 100 :required true}
+  :age {:type "integer" :min 0 :max 150}
+ }]
+
+; 검증
+(if (schema-valid? UserSchema user-data)
+  (print "유효한 데이터")
+  (print "검증 실패:" (schema-errors UserSchema user-data)))
+```
+
+### 미들웨어 체인
+
+```lisp
+[MIDDLEWARE auth-check
+ :condition (fn [req] (has? (:headers req) "authorization"))
+ :handler (fn [req]
+   (assoc req :user (validate-token (get-token (:headers req)))))
+ :on-fail (fn [req]
+   {:status 401 :body "Unauthorized"})]
+
+[MIDDLEWARE rate-limit
+ :condition (fn [req] (< (get-request-count (:ip req)) 100))
+ :handler (fn [req]
+   (increment-request-count (:ip req))
+   req)
+ :on-fail (fn [req]
+   {:status 429 :body "Too Many Requests"})]
+```
+
+---
+
+## 2. v9-data — 데이터 분석
+
+테이블, 통계, 시각화를 통한 데이터 처리:
+
+### 테이블 조작
+
+```lisp
+(import v9-data)
+
+; CSV 로드
+(let [data (table/load-csv "sales.csv")]
+  (-> data
+      (table/filter (fn [row] (> (:amount row) 1000)))
+      (table/sort :date :desc)
+      (table/group-by :region)))
+
+; 테이블 연산
+(table/select data ["name" "email" "amount"])
+(table/aggregate data "amount" :sum)
+(table/join data1 data2 :on "user_id")
+```
+
+### 통계 분석
+
+```lisp
+(let [scores [85 90 75 92 88 78 95]]
+  {:mean (stats/mean scores)
+   :median (stats/median scores)
+   :stddev (stats/stddev scores)
+   :min (stats/min scores)
+   :max (stats/max scores)
+   :quartiles (stats/percentiles scores [0.25 0.5 0.75])})
+
+; 상관 분석
+(let [x [1 2 3 4 5]
+      y [2 4 6 8 10]]
+  (stats/correlation x y))  ; → 1.0 (완벽한 양의 상관)
+
+; 정규화
+(stats/normalize [0 50 100])  ; → [0.0 0.5 1.0]
+```
+
+### 시각화
+
+```lisp
+; 히스토그램
+(plot/histogram [10 20 15 25 30 18 22]
+ :title "Distribution"
+ :bins 5)
+
+; 막대 그래프
+(plot/bar ["A" "B" "C" "D"]
+ [100 150 200 180]
+ :title "Sales by Region")
+
+; 선 그래프
+(plot/line [1 2 3 4 5]
+ [10 15 13 17 20]
+ :title "Trend")
+
+; 산점도
+(plot/scatter [1 2 3 4 5]
+ [10 15 13 17 20])
+
+; 파일로 저장
+(plot/save chart "output.svg")
+```
+
+---
+
+## 3. 마이크로서비스 프레임워크
+
+분산 시스템 구축:
+
+### 서비스 정의
+
+```lisp
+[SERVICE user-service
+ :port 8001
+ :database {:url "sqlite:users.db"}
+ :routes [
+  [GET "/users/:id" get-user]
+  [POST "/users" create-user]
+  [DELETE "/users/:id" delete-user]
+ ]]
+
+[SERVICE order-service
+ :port 8002
+ :database {:url "sqlite:orders.db"}
+ :routes [
+  [GET "/orders/:id" get-order]
+  [POST "/orders" create-order]
+ ]]
+```
+
+### 메시지 큐
+
+```lisp
+; 큐 생성
+(queue/create "events" :type "file")
+
+; 이벤트 발행
+(queue/publish "events" "user.created"
+ {:user-id 123 :email "user@example.com"})
+
+; 이벤트 구독
+(queue/subscribe "events" "user.created"
+ (fn [message]
+  (println "New user created:" (:user-id message))))
+
+; 구독 취소
+(queue/unsubscribe subscription-id)
+```
+
+### Circuit Breaker (장애 격리)
+
+```lisp
+[CIRCUIT-BREAKER external-api
+ :threshold 5        ; 5번 실패 시 OPEN
+ :timeout 30000      ; 30초 후 HALF-OPEN 시도
+ :fallback (fn []
+  {:status "error" :message "Service unavailable"})]
+
+; Circuit breaker를 통한 호출
+(circuit/call "external-api"
+ (fn []
+  (http/get "https://external-api.com/data")))
+```
+
+### 모니터링
+
+```lisp
+; 메트릭 기록
+(observe/metric "requests" 1 :type "counter")
+(observe/metric "latency" 125 :type "histogram")
+(observe/metric "active-connections" 42 :type "gauge")
+
+; 에러 카운팅
+(observe/count-errors "database")
+(observe/count-errors "external-api")
+
+; 로깅
+(observe/log "info" "User login successful" {:user-id 123})
+(observe/log "error" "Database connection failed" {:error "timeout"})
+
+; 메트릭 리포트
+(observe/report)
+; → {:metrics {...} :services [...] :health {...}}
+
+; Prometheus 형식 출력
+(observe/prometheus)
+```
+
+---
+
+## 통합 예제: SaaS 플랫폼
+
+```lisp
+(import flnext)
+(import v9-data)
+
+; 데이터 모델
+[MODEL User
+ :table "users"
+ :fields [
+  {:name "id" :type "INTEGER" :primary-key true}
+  {:name "email" :type "TEXT" :unique true}
+  {:name "created-at" :type "TIMESTAMP"}
+ ]]
+
+[MODEL Order
+ :table "orders"
+ :fields [
+  {:name "id" :type "INTEGER" :primary-key true}
+  {:name "user-id" :type "INTEGER" :foreign-key "users.id"}
+  {:name "amount" :type "DECIMAL"}
+  {:name "status" :type "TEXT"}
+ ]]
+
+; 검증 스키마
+[SCHEMA CreateOrderSchema
+ :fields {
+  :user-id {:type "integer" :required true}
+  :amount {:type "decimal" :required true :min 0.01}
+  :items {:type "array" :required true}
+ }]
+
+; 미들웨어
+[MIDDLEWARE request-logging
+ :handler (fn [req]
+  (observe/log "info" "Request" {:method (:method req) :path (:path req)})
+  req)]
+
+; 라우트
+(defn create-order [req]
+  (let [data (:body req)]
+    (if (schema-valid? CreateOrderSchema data)
+      (do
+        (order/create data)
+        {:status 201 :body {:success true}})
+      {:status 400 :body {:error (schema-errors CreateOrderSchema data)}})))
+
+; 앱 정의
+[APP sales-platform
+ :port 3000
+ :database {:url "sqlite:app.db"}
+ :middleware [request-logging]
+ :routes [
+  [POST "/orders" create-order]
+  [GET "/analytics" analytics-dashboard]
+  [GET "/health" health-check]
+ ]]
+```
+
+---
+
+## 다음 단계
+
+- [기초](./basics.md) — 핵심 문법 학습
+- [AI 블록](./ai-blocks.md) — 고급 추론 기능
+- [API 레퍼런스](../api/stdlib.md) — 모든 함수

package/docs/homepage/README.md

@@ -0,0 +1,164 @@
+# FreeLang v9 공식 홈페이지
+
+이 폴더에는 FreeLang v9의 공식 홈페이지가 포함되어 있습니다. **v9로 만든 v9의 홈페이지**입니다.
+
+## 🎯 특징
+
+- **순수 v9 코드**: FLNext 웹 프레임워크로 작성
+- **의존성 제로**: Express, React 등 외부 라이브러리 없음
+- **자기기술적**: 홈페이지 자체가 v9의 강력함을 보여줌
+- **최소주의**: 핵심만 간단하게 구현
+
+---
+
+## 🚀 실행 방법
+
+### 방법 1: v9 CLI (설치 필요)
+```bash
+npm install -g freelang-v9
+cd homepage
+v9 main.fl
+```
+
+### 방법 2: 소스 코드에서 직접
+```bash
+cd freelang-v9
+npx ts-node src/cli.ts homepage/main.fl
+```
+
+### 브라우저에서 확인
+```
+http://localhost:3000
+```
+
+---
+
+## 📂 파일 구조
+
+```
+homepage/
+├── main.fl               # 메인 홈페이지 (순수 v9)
+└── README.md             # 이 파일
+```
+
+---
+
+## 🏗️ 구조 설명
+
+### 데이터 섹션
+```lisp
+(def project-info {...})    ; 프로젝트 정보
+(def features [...])         ; 기능 목록
+(def stats [...])            ; 통계
+(def examples [...])         ; 코드 예제
+```
+
+### 렌더링 함수
+```lisp
+(defn render-header [...])   ; HTML 헤더 생성
+(defn render-css [...])      ; CSS 스타일 생성
+(defn render-features [...]) ; 기능 영역 렌더링
+...
+```
+
+### 라우트
+```lisp
+GET /              ; 홈페이지
+GET /api/info      ; API 정보
+GET /health        ; 헬스 체크
+```
+
+---
+
+## 💻 기술 스택
+
+| 항목 | 사용 기술 |
+|------|---------|
+| **언어** | FreeLang v9 |
+| **프레임워크** | FLNext |
+| **스타일링** | 인라인 CSS |
+| **데이터** | Lisp 맵/벡터 |
+| **포트** | 3000 |
+
+---
+
+## 🔧 커스터마이징
+
+### 데이터 수정
+```lisp
+(def project-info {
+  :name "..."
+  :tagline "..."
+  ...
+})
+```
+
+### 새로운 섹션 추가
+1. 데이터 추가 (예: `(def new-section [...])`)
+2. 렌더링 함수 작성 (예: `(defn render-new-section [...])`)
+3. 라우트에 HTML 추가
+
+### 스타일 수정
+`render-css` 함수의 CSS 문자열 수정
+
+---
+
+## 📊 페이지 구성
+
+### Header
+- 프로젝트명, 태그라인
+- 문서/GitHub 링크 버튼
+
+### Features Section
+6개의 핵심 기능 카드 표시
+
+### Stats Section
+프로젝트 통계 (Phase, Tests, Stdlib 등)
+
+### Examples Section
+3개의 코드 예제 표시
+
+### Getting Started Section
+빠른 설치 명령어
+
+### Footer
+프로젝트 링크 및 정보
+
+---
+
+## 🎨 디자인 철학
+
+- **간결함**: 최소한의 CSS로 깔끔한 디자인
+- **반응형**: 모든 기기에서 작동
+- **성능**: HTML 문자열 직렬화로 빠른 로딩
+- **접근성**: 시맨틱 HTML 구조
+
+---
+
+## 📈 향후 개선
+
+- [ ] 다국어 지원 (영어, 중국어)
+- [ ] 대시보드 (실시간 통계)
+- [ ] 블로그 통합
+- [ ] 커뮤니티 페이지
+- [ ] 튜토리얼 페이지
+- [ ] 다운로드 통계
+
+---
+
+## 🔗 관련 링크
+
+- [공식 문서](../docs/)
+- [GitHub 저장소](https://github.com/kimjindol2025/freelang-v9)
+- [npm 패키지](https://www.npmjs.com/package/freelang-v9)
+
+---
+
+## 🤖 참고
+
+이 홈페이지는 FreeLang v9의 강력함을 보여주기 위해 의도적으로 v9로만 작성되었습니다.
+Express, React, Next.js 같은 외부 라이브러리 없이 순수 v9 코드로 완전한 웹 애플리케이션을 만들 수 있습니다.
+
+---
+
+[메인 저장소로 돌아가기](../)

package/docs/index.md

@@ -0,0 +1,183 @@
+# FreeLang v9
+
+**AI를 위한, AI에 의한, AI가 쓰고 싶은 언어**
+
+FreeLang v9는 AI가 자연스럽게 생각하는 방식으로 코드를 작성할 수 있는 프로그래밍 언어입니다. S-expression 기반의 명확한 문법과 AI-native 블록들로 인공지능과 인간이 함께 코드를 작성할 수 있습니다.
+
+---
+
+## 🚀 빠른 시작
+
+### 설치
+```bash
+npm install -g freelang-v9
+v9 --version
+```
+
+### 첫 번째 프로그램
+```lisp
+(print "Hello, FreeLang!")
+
+; 함수 정의
+(defn greet [name]
+  (str "안녕, " name "!"))
+
+(print (greet "World"))
+```
+
+### REPL 실행
+```bash
+v9 repl
+```
+
+---
+
+## ✨ 핵심 기능
+
+### 1. AI-Native 블록
+AI가 하는 추론, 검색, 기억을 언어 수준에서 지원:
+
+```lisp
+; 체계적 추론 (Chain-of-Thought)
+(reasoning
+  :goal "사용자 인증 구현"
+  :steps [
+    "토큰 생성 함수 정의"
+    "비밀번호 검증 로직"
+    "토큰 저장소 준비"
+  ])
+
+; 가설 설정 및 검증
+(hypothesis
+  :claim "HTTP 요청이 3초 이내 완료될 것"
+  :test (fn [] (< (measure-time api-call) 3000)))
+
+; 불확실성을 값으로 표현
+(maybe 0.95 best-guess)  ; 95% 확신도로 값 표현
+```
+
+### 2. S-Expression 문법
+Lisp 전통의 명확하고 균일한 문법:
+
+```lisp
+(defn calculate [x y]
+  (-> x
+      (+ y)
+      (* 2)
+      (- 5)))
+
+(calculate 10 20)  ; → 55
+```
+
+### 3. 내장 표준 라이브러리
+30개 이상의 모듈로 실무 개발 지원:
+
+- **io**: 파일 읽기/쓰기
+- **net**: HTTP 클라이언트/서버
+- **db**: SQLite 데이터베이스
+- **crypto**: JWT, 암호화
+- **time**: 날짜/시간 처리
+- **service**: 마이크로서비스 프레임워크
+- **test**: 자동 테스트 및 커버리지
+
+### 4. 완전한 생태계
+- **vpm**: v9 패키지 관리자
+- **FLNext**: 웹 프레임워크 (Express 제거)
+- **v9-data**: 데이터 분석 라이브러리
+- **Registry**: npm 호환 패키지 서버
+
+---
+
+## 📚 문서
+
+### [언어 기초](./guide/basics.md)
+- 문법과 타입
+- 함수 정의 및 호출
+- 제어 흐름
+
+### [AI 블록 상세](./guide/ai-blocks.md)
+- Chain-of-Thought
+- Tree-of-Thought
+- 반성 (Reflection)
+- 자기 개선
+
+### [프레임워크](./guide/frameworks.md)
+- FLNext 웹 개발
+- v9-data 데이터 분석
+- 서비스 및 마이크로서비스
+
+### [API 레퍼런스](./api/stdlib.md)
+- 표준 라이브러리 모든 함수
+- HTTP, 파일, 데이터베이스
+- 테스트 및 모니터링
+
+### [예제](./examples/)
+- 웹 애플리케이션
+- CLI 도구
+- 데이터 처리
+- 마이크로서비스
+
+---
+
+## 🎯 왜 FreeLang v9인가?
+
+### 문제: AI와 인간의 사고 방식 불일치
+기존 프로그래밍 언어는 AI가 생각하는 방식으로 코드 작성을 방해합니다.
+
+### 해결책: AI-Native 언어 설계
+```
+기존 언어의 한계:
+❌ 추론 과정을 코드로 표현 불가
+❌ 불확실성을 값으로 다룰 수 없음
+❌ 기억과 상태 관리가 복잡
+❌ AI 블록이 언어 수준에서 없음
+
+FreeLang v9의 장점:
+✅ 체계적 추론을 [REASON] 블록으로
+✅ 확률을 (maybe 0.8 value)로 표현
+✅ 장기/단기 메모리 내장
+✅ 30개 AI-native 블록 지원
+```
+
+---
+
+## 📊 프로덕션 준비 완료
+
+| 항목 | 상태 | 평가 |
+|------|------|------|
+| **코드 품질** | ✅ | 1,800+ 줄 신규 (Phase 7-12) |
+| **테스트** | ✅ | 589/589 PASS (100%) |
+| **회귀 테스트** | ✅ | 439/439 PASS (100%) |
+| **npm 배포** | ✅ | freelang-v9@9.0.0 public |
+| **의존성** | ✅ | express/npm/tsc 모두 제거 |
+
+---
+
+## 🤝 커뮤니티
+
+- [GitHub Discussions](https://github.com/kimjindol2025/freelang-v9/discussions) — 질문과 아이디어
+- [GitHub Issues](https://github.com/kimjindol2025/freelang-v9/issues) — 버그 리포트 및 기능 요청
+- [블로그](https://blog.dclub.kr) — 기술 기록 및 튜토리얼
+
+---
+
+## 📄 라이선스
+
+MIT License - 자유롭게 사용, 수정, 배포 가능합니다.
+
+---
+
+## 🎉 시작해보기
+
+```bash
+npm install -g freelang-v9
+v9 repl
+```
+
+FreeLang v9로 AI가 원하는 방식으로 코드를 작성하세요!
+
+---
+
+**Made by**: Kim Jindol  
+**Version**: v9.0.0  
+**Last Updated**: 2026-04-13