freelang-editor 11.7.4

package/scripts/check-parens.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python3
+"""
+check-parens.py — FreeLang .fl 파일 괄호/브래킷 균형 검증기
+
+사용법:
+  python3 scripts/check-parens.py app/server.fl
+  python3 scripts/check-parens.py app/*.fl
+  python3 scripts/check-parens.py app/server.fl --verbose
+"""
+
+import sys
+import argparse
+
+
+def check_file(path: str, verbose: bool = False) -> bool:
+    try:
+        with open(path, encoding="utf-8") as f:
+            content = f.read()
+    except FileNotFoundError:
+        print(f"❌ {path}: 파일 없음")
+        return False
+
+    # 열린 브래킷 스택 추적 (paren + bracket)
+    stack = []         # (char, line, col)
+    paren_depth = 0
+    bracket_depth = 0
+    line = 1
+    col = 0
+    in_string = False
+    in_comment = False
+
+    for i, ch in enumerate(content):
+        col += 1
+        if ch == '\n':
+            line += 1
+            col = 0
+            in_comment = False
+            continue
+
+        if in_comment:
+            continue
+
+        if ch == ';' and not in_string:
+            in_comment = True
+            continue
+
+        if ch == '"':
+            in_string = not in_string
+            continue
+
+        if in_string:
+            continue
+
+        if ch == '(':
+            paren_depth += 1
+            stack.append(('(', line, col))
+        elif ch == ')':
+            paren_depth -= 1
+            if paren_depth < 0:
+                print(f"❌ {path}:{line}:{col} — ')' 가 열린 '(' 없이 등장")
+                if verbose and stack:
+                    print("   마지막 열린 괄호 스택:")
+                    for c, l, co in stack[-5:]:
+                        print(f"     '{c}' at line {l}:{co}")
+                return False
+            if stack and stack[-1][0] == '(':
+                stack.pop()
+        elif ch == '[':
+            bracket_depth += 1
+            stack.append(('[', line, col))
+        elif ch == ']':
+            bracket_depth -= 1
+            if bracket_depth < 0:
+                print(f"❌ {path}:{line}:{col} — ']' 가 열린 '[' 없이 등장")
+                return False
+            if stack and stack[-1][0] == '[':
+                stack.pop()
+
+    ok = True
+    if paren_depth != 0:
+        print(f"❌ {path}: 괄호 불균형 (미닫힘 '(' = {paren_depth}개)")
+        ok = False
+    if bracket_depth != 0:
+        print(f"❌ {path}: 브래킷 불균형 (미닫힘 '[' = {bracket_depth}개)")
+        ok = False
+
+    if not ok and verbose and stack:
+        print(f"   미닫힘 스택 (최대 10개):")
+        for c, l, co in stack[-10:]:
+            print(f"     '{c}' at {path}:{l}:{co}")
+
+    if ok:
+        lines = content.count('\n') + 1
+        print(f"✅ {path} ({lines}줄, depth=0)")
+
+    return ok
+
+
+def main():
+    parser = argparse.ArgumentParser(description="FreeLang .fl 파일 괄호 검증기")
+    parser.add_argument("files", nargs="+", help=".fl 파일 경로")
+    parser.add_argument("--verbose", "-v", action="store_true",
+                        help="미닫힘 스택 상세 출력")
+    args = parser.parse_args()
+
+    results = [check_file(f, args.verbose) for f in args.files]
+    passed = sum(results)
+    total = len(results)
+
+    if total > 1:
+        print(f"\n결과: {passed}/{total} 통과")
+
+    sys.exit(0 if all(results) else 1)
+
+
+if __name__ == "__main__":
+    main()

package/scripts/check-ports.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# FreeLang v11 포트 체크 스크립트
+# 30000~35000 범위에서 사용 가능한 포트 확인
+
+echo "🔍 포트 상태 확인 (30000~35000)"
+echo "════════════════════════════════════"
+echo ""
+
+# 컬러 정의
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# 포트 범위
+START_PORT=30000
+END_PORT=35000
+AVAILABLE_PORTS=()
+
+# 각 포트 체크
+for PORT in $(seq $START_PORT $END_PORT); do
+  if ! nc -z localhost $PORT 2>/dev/null; then
+    AVAILABLE_PORTS+=($PORT)
+  fi
+done
+
+echo "사용 가능한 포트 (처음 10개):"
+echo ""
+
+count=0
+for PORT in "${AVAILABLE_PORTS[@]}"; do
+  if [ $count -lt 10 ]; then
+    echo -e "  ${GREEN}✓${NC} 포트 $PORT"
+    ((count++))
+  fi
+done
+
+echo ""
+echo "════════════════════════════════════"
+echo "총 사용 가능: ${#AVAILABLE_PORTS[@]}개 포트"
+echo ""
+
+if [ ${#AVAILABLE_PORTS[@]} -gt 0 ]; then
+  FIRST_AVAILABLE=${AVAILABLE_PORTS[0]}
+  echo -e "${GREEN}✅ 추천 포트: $FIRST_AVAILABLE${NC}"
+  echo ""
+  echo "사용 방법:"
+  echo "  PORT=$FIRST_AVAILABLE npm run dev"
+fi

package/scripts/check-syntax.js

@@ -0,0 +1,30 @@
+const fs = require('fs');
+
+function countParens(content) {
+  let open = 0, close = 0;
+  let bracketOpen = 0, bracketClose = 0;
+  
+  for (let i = 0; i < content.length; i++) {
+    const c = content[i];
+    if (c === '(') open++;
+    else if (c === ')') close++;
+    else if (c === '[') bracketOpen++;
+    else if (c === ']') bracketClose++;
+  }
+  
+  return { open, close, bracketOpen, bracketClose };
+}
+
+function checkFile(path) {
+  const content = fs.readFileSync(path, 'utf8');
+  const counts = countParens(content);
+  console.log(`\n${path}:`);
+  console.log(`  ( : ${counts.open}`);
+  console.log(`  ) : ${counts.close}`);
+  console.log(`  [ : ${counts.bracketOpen}`);
+  console.log(`  ] : ${counts.bracketClose}`);
+  console.log(`  Balance: ( ${counts.open - counts.close}, [ ${counts.bracketOpen - counts.bracketClose}`);
+}
+
+checkFile('self/all.fl');
+checkFile('self/codegen.fl');

package/scripts/cli-extras.js

@@ -0,0 +1,135 @@
+// freelang patch + migrate 명령 구현
+"use strict";
+const fs = require("fs");
+const path = require("path");
+
+function cmdPatch(patchArgs) {
+  const filePath = patchArgs[0];
+  if (!filePath) {
+    console.error("Usage:\n  freelang patch <file> --find <text> --replace <text>\n  freelang patch <file> --insert-after <anchor> --content <block>\n  freelang patch <file> --insert-before <anchor> --content <block>\n  freelang patch <file> --delete-line <pattern>");
+    process.exit(1);
+  }
+  if (!fs.existsSync(filePath)) { console.error(`[patch] 파일 없음: ${filePath}`); process.exit(1); }
+  let content = fs.readFileSync(filePath, "utf8");
+  const get = (f) => { const i = patchArgs.indexOf(f); return i >= 0 ? patchArgs[i + 1] : null; };
+  const findText = get("--find"), replaceText = get("--replace");
+  const insertAfter = get("--insert-after"), insertBefore = get("--insert-before");
+  const insertContent = get("--content"), deleteLine = get("--delete-line"), nth = get("--nth");
+  let changed = false;
+  if (findText !== null && replaceText !== null) {
+    if (nth !== null) {
+      let count = 0; const target = parseInt(nth, 10);
+      const nc = content.replace(new RegExp(findText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g"), (m) => { count++; return count === target ? replaceText : m; });
+      if (nc === content) { console.error(`[patch] 텍스트 없음 (${nth}번째): ${findText}`); process.exit(1); }
+      content = nc;
+    } else {
+      if (!content.includes(findText)) { console.error(`[patch] --find 텍스트 없음: ${findText}`); process.exit(1); }
+      content = content.split(findText).join(replaceText);
+    }
+    changed = true;
+  } else if (insertAfter !== null && insertContent !== null) {
+    const idx = content.indexOf(insertAfter);
+    if (idx < 0) { console.error(`[patch] --insert-after 앵커 없음: ${insertAfter}`); process.exit(1); }
+    content = content.slice(0, idx + insertAfter.length) + "\n" + insertContent + content.slice(idx + insertAfter.length);
+    changed = true;
+  } else if (insertBefore !== null && insertContent !== null) {
+    const idx = content.indexOf(insertBefore);
+    if (idx < 0) { console.error(`[patch] --insert-before 앵커 없음: ${insertBefore}`); process.exit(1); }
+    content = content.slice(0, idx) + insertContent + "\n" + content.slice(idx);
+    changed = true;
+  } else if (deleteLine !== null) {
+    const lines = content.split("\n"), before = lines.length;
+    const filtered = lines.filter((l) => !l.includes(deleteLine));
+    if (filtered.length === before) { console.error(`[patch] --delete-line 패턴 없음: ${deleteLine}`); process.exit(1); }
+    content = filtered.join("\n"); changed = true;
+  } else { console.error("[patch] 옵션 부족: --find/--replace, --insert-after/--content, --insert-before/--content, --delete-line 필요"); process.exit(1); }
+  if (changed) { fs.writeFileSync(filePath, content, "utf8"); console.log(`\x1B[32m[patch]\x1B[0m ✓ ${filePath}`); }
+}
+
+async function cmdMigrate(migrateArgs) {
+  let mysql;
+  try { mysql = require("mysql2/promise"); } catch {
+    try { mysql = require(path.join(__dirname, "node_modules/mysql2/promise")); } catch {
+      console.error("[migrate] mysql2 필요: npm install mysql2 (freelang-v11 디렉토리에서)"); process.exit(1);
+    }
+  }
+  const sub = migrateArgs[0];
+  const dir = path.resolve(process.cwd(), "migrations");
+  const envFile = path.resolve(process.cwd(), ".env");
+  const loadEnv = () => {
+    const e = {};
+    if (fs.existsSync(envFile)) fs.readFileSync(envFile, "utf8").split("\n").forEach((l) => { const m = l.match(/^([^#=]+)=(.*)/); if (m) e[m[1].trim()] = m[2].trim().replace(/^["']|["']$/g, ""); });
+    return e;
+  };
+  const getConn = async () => {
+    const e = { ...loadEnv(), ...process.env };
+    return mysql.createConnection({ host: e.DB_HOST || "127.0.0.1", port: parseInt(e.DB_PORT || "3306"), user: e.DB_USER || "akl", password: e.DB_PASS || e.DB_PASSWORD || "akl_pass_2026", database: e.DB_NAME || e.DB_DATABASE || "akl", multipleStatements: true });
+  };
+  const ensureTable = async (c) => c.execute("CREATE TABLE IF NOT EXISTS _migrations (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255) NOT NULL UNIQUE, applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP)");
+  if (!sub || sub === "help") {
+    console.log("\nUsage:\n  freelang migrate create <name>   새 마이그레이션 생성\n  freelang migrate up               미적용 실행\n  freelang migrate down             마지막 롤백\n  freelang migrate status           현황 확인\n  freelang migrate reset            전체 롤백\n");
+    return;
+  }
+  if (sub === "create") {
+    const name = migrateArgs[1]; if (!name) { console.error("Usage: freelang migrate create <name>"); process.exit(1); }
+    fs.mkdirSync(dir, { recursive: true });
+    const ts = new Date().toISOString().replace(/[-:T.Z]/g, "").slice(0, 14);
+    const fname = `${ts}_${name.replace(/[^a-z0-9]/gi, "_").toLowerCase()}.sql`;
+    fs.writeFileSync(path.join(dir, fname), `-- Migration: ${name}\n-- Created: ${new Date().toISOString()}\n\n-- UP\n\n\n-- DOWN\n-- 롤백 SQL\n`);
+    console.log(`\x1B[32m[migrate]\x1B[0m ✓ migrations/${fname}`);
+    return;
+  }
+  const conn = await getConn();
+  try {
+    await ensureTable(conn);
+    const getFiles = () => { fs.mkdirSync(dir, { recursive: true }); return fs.readdirSync(dir).filter((f) => f.endsWith(".sql")).sort(); };
+    const getApplied = async () => { const [rows] = await conn.execute("SELECT name FROM _migrations"); return new Set(rows.map((r) => r.name)); };
+    if (sub === "status") {
+      const files = getFiles(), applied = await getApplied();
+      if (!files.length) { console.log("\x1B[2m[migrate] 없음\x1B[0m"); return; }
+      console.log(`\n\x1B[36m[migrate]\x1B[0m  ${dir}\n`);
+      for (const f of files) console.log(`  ${applied.has(f) ? "\x1B[32m✓\x1B[0m" : "\x1B[33m○\x1B[0m"}  ${f}`);
+      console.log(`\n  총 ${files.length} / 적용 ${applied.size} / 미적용 ${files.filter((f) => !applied.has(f)).length}\n`);
+    } else if (sub === "up") {
+      const files = getFiles(), applied = await getApplied();
+      const pending = files.filter((f) => !applied.has(f));
+      if (!pending.length) { console.log("\x1B[32m[migrate]\x1B[0m 최신 상태."); return; }
+      for (const f of pending) {
+        const sql = fs.readFileSync(path.join(dir, f), "utf8");
+        const upSql = (sql.includes("-- DOWN") ? sql.split("-- DOWN")[0] : sql).replace(/^--[^\n]*\n/gm, "").trim();
+        if (!upSql) { console.log(`\x1B[33m[migrate]\x1B[0m 건너뜀: ${f}`); continue; }
+        process.stdout.write(`\x1B[36m[migrate]\x1B[0m  ${f} ... `);
+        await conn.execute(upSql);
+        await conn.execute("INSERT INTO _migrations (name) VALUES (?)", [f]);
+        console.log("\x1B[32m✓\x1B[0m");
+      }
+      console.log(`\x1B[32m[migrate]\x1B[0m ${pending.length}개 완료`);
+    } else if (sub === "down") {
+      const [rows] = await conn.execute("SELECT name FROM _migrations ORDER BY applied_at DESC LIMIT 1");
+      if (!rows.length) { console.log("[migrate] 롤백할 항목 없음"); return; }
+      const last = rows[0].name, fp = path.join(dir, last);
+      if (!fs.existsSync(fp)) { console.error(`[migrate] 파일 없음: ${fp}`); process.exit(1); }
+      const sql = fs.readFileSync(fp, "utf8");
+      const downSql = sql.includes("-- DOWN") ? sql.split("-- DOWN")[1].replace(/^--[^\n]*\n/gm, "").trim() : "";
+      if (!downSql) { console.error(`[migrate] DOWN SQL 없음: ${last}`); process.exit(1); }
+      process.stdout.write(`\x1B[36m[migrate]\x1B[0m  롤백: ${last} ... `);
+      await conn.execute(downSql);
+      await conn.execute("DELETE FROM _migrations WHERE name = ?", [last]);
+      console.log("\x1B[32m✓\x1B[0m");
+    } else if (sub === "reset") {
+      const [rows] = await conn.execute("SELECT name FROM _migrations ORDER BY applied_at DESC");
+      if (!rows.length) { console.log("[migrate] 없음"); return; }
+      for (const row of rows) {
+        const fp = path.join(dir, row.name);
+        if (!fs.existsSync(fp)) continue;
+        const sql = fs.readFileSync(fp, "utf8");
+        const downSql = sql.includes("-- DOWN") ? sql.split("-- DOWN")[1].replace(/^--[^\n]*\n/gm, "").trim() : "";
+        if (downSql) await conn.execute(downSql);
+        await conn.execute("DELETE FROM _migrations WHERE name = ?", [row.name]);
+        console.log(`\x1B[33m[migrate]\x1B[0m  롤백: ${row.name}`);
+      }
+    } else { console.error(`[migrate] 알 수 없는 명령: ${sub}`); process.exit(1); }
+  } finally { await conn.end(); }
+}
+
+module.exports = { cmdPatch, cmdMigrate };

package/scripts/cron-daily-verify.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# scripts/cron-daily-verify.sh — 매일 자동 회귀 검출 cron job
+#
+# 매일 새벽 3시(또는 사용자 지정 시각)에 실행:
+#   1. git pull (최신 master)
+#   2. npm run build
+#   3. make verify-all (4개 검증)
+#   4. 결과 비교 (이전 vs 오늘)
+#   5. 회귀 발생 시 블로그 알림 또는 로그
+#
+# 등록:
+#   crontab -e
+#   0 3 * * * /bin/bash /root/kim/freelang-v11/scripts/cron-daily-verify.sh
+#
+# 수동 실행:
+#   bash scripts/cron-daily-verify.sh
+#
+# 결과:
+#   logs/cron-verify-{YYYY-MM-DD}.log  (성공/실패 로그)
+#   VERIFY-ALL-RESULTS.json            (덮어쓰기, 최신 결과)
+
+set -u
+
+REPO="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$REPO"
+
+LOG_DIR="$REPO/logs"
+mkdir -p "$LOG_DIR"
+
+DATE=$(date +%Y-%m-%d)
+TS=$(date +%Y-%m-%dT%H:%M:%S%z)
+LOG_FILE="$LOG_DIR/cron-verify-$DATE.log"
+
+log() {
+  echo "[$TS] $1" | tee -a "$LOG_FILE"
+}
+
+log "════════════════════════════════════════════"
+log "  FreeLang v11 — Daily Verification Cron"
+log "  $TS"
+log "════════════════════════════════════════════"
+
+# 1. git pull (옵션 — 환경에 따라 skip)
+if [ -d .git ] && [ -z "${SKIP_GIT_PULL:-}" ]; then
+  log "▶ git pull"
+  git pull --rebase 2>&1 | tee -a "$LOG_FILE" || log "  ⚠️  git pull 실패 (계속 진행)"
+fi
+
+# 2. npm run build (bootstrap.js 갱신)
+log "▶ npm run build"
+if npm run build > /tmp/cron-build.log 2>&1; then
+  log "  ✅ build OK"
+else
+  log "  ❌ build FAIL"
+  tail -5 /tmp/cron-build.log >> "$LOG_FILE"
+  exit 1
+fi
+
+# 3. verify-all
+log "▶ verify-all (4개 검증)"
+T0=$(date +%s)
+if bash scripts/verify-all.sh --json > /tmp/cron-verify.json 2>&1; then
+  log "  ✅ verify-all PASS"
+  VERIFY_OK=1
+else
+  log "  ❌ verify-all FAIL"
+  VERIFY_OK=0
+fi
+ELAPSED=$(( $(date +%s) - T0 ))
+
+# JSON 결과 분석
+if [ -f /tmp/cron-verify.json ]; then
+  PASS=$(grep -oE '"pass":\s*[0-9]+' /tmp/cron-verify.json | head -1 | grep -oE '[0-9]+')
+  FAIL=$(grep -oE '"fail":\s*[0-9]+' /tmp/cron-verify.json | head -1 | grep -oE '[0-9]+')
+  log "  결과: ${PASS}/4 PASS, ${FAIL}/4 FAIL, ${ELAPSED}s"
+fi
+
+# 4. 회귀 검출 (이전 결과와 비교)
+if [ -f "$LOG_DIR/last-verify.json" ]; then
+  PREV_PASS=$(grep -oE '"pass":\s*[0-9]+' "$LOG_DIR/last-verify.json" | head -1 | grep -oE '[0-9]+')
+  if [ "${PREV_PASS:-0}" -gt "${PASS:-0}" ]; then
+    log "  ⚠️  회귀 발견! 이전 PASS=$PREV_PASS, 현재 PASS=$PASS"
+    # 회귀 알림 (옵션 — 블로그 또는 webhook)
+    if [ -n "${BLOG_API_KEY:-}" ]; then
+      curl -sS -X POST https://blog.dclub.kr/api/posts \
+        -H "Content-Type: application/json" \
+        -H "X-API-Key: $BLOG_API_KEY" \
+        -d "{\"title\":\"⚠️ FreeLang v11 회귀 발생 ($DATE)\",\"content\":\"verify-all PASS $PREV_PASS → $PASS\\n\\n로그: $LOG_FILE\\n결과: VERIFY-ALL-RESULTS.json\",\"category\":\"개발 이야기\",\"tags\":[\"FreeLang\",\"회귀\",\"cron\"],\"author\":\"cron-bot\"}" \
+        >> "$LOG_FILE" 2>&1
+    fi
+  fi
+fi
+
+# 5. 결과 보존 (다음 회귀 검출용)
+cp /tmp/cron-verify.json "$LOG_DIR/last-verify.json" 2>/dev/null || true
+
+log "════════════════════════════════════════════"
+log "  Cron 종료 — exit $([ $VERIFY_OK -eq 1 ] && echo 0 || echo 1)"
+log "════════════════════════════════════════════"
+
+[ $VERIFY_OK -eq 1 ] && exit 0 || exit 1

package/scripts/deploy.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# FreeLang v11 배포 자동화
+
+set -e
+
+echo "╔════════════════════════════════════════════════════════════╗"
+echo "║  FreeLang v11 배포 자동화 시작                            ║"
+echo "╚════════════════════════════════════════════════════════════╝"
+
+# 1. 환경 설정
+export NODE_ENV=${NODE_ENV:-production}
+export PORT=${PORT:-43011}
+export LOG_LEVEL=${LOG_LEVEL:-info}
+
+echo ""
+echo "📋 단계 1: 사전 검사"
+echo "  - Node.js 버전: $(node --version)"
+echo "  - npm 버전: $(npm --version)"
+echo "  - 환경: $NODE_ENV"
+echo "  - 포트: $PORT"
+
+# 2. 테스트 실행
+echo ""
+echo "📋 단계 2: 테스트 실행"
+npm test || { echo "❌ 테스트 실패"; exit 1; }
+echo "  ✅ 모든 테스트 통과"
+
+# 3. 빌드
+echo ""
+echo "📋 단계 3: 빌드"
+npm run build 2>/dev/null || echo "  ℹ️  빌드 스크립트 없음 (bootstrap.js 사용)"
+
+# 4. 의존성 확인
+echo ""
+echo "📋 단계 4: 의존성 확인"
+if grep -q "\"dependencies\"" package.json; then
+  DEPS=$(grep -c "\":" package.json)
+  echo "  ⚠️  의존성 감지됨: $DEPS개"
+else
+  echo "  ✅ 의존성 0 (완전 독립)"
+fi
+
+# 5. 파일 무결성 확인
+echo ""
+echo "📋 단계 5: 파일 무결성 확인"
+if [ ! -f "bootstrap.js" ]; then
+  echo "  ❌ bootstrap.js 없음"
+  exit 1
+fi
+echo "  ✅ bootstrap.js ($(du -h bootstrap.js | cut -f1))"
+
+if [ ! -d "self/stdlib" ]; then
+  echo "  ❌ self/stdlib 없음"
+  exit 1
+fi
+MODULES=$(ls -1 self/stdlib/*.fl 2>/dev/null | wc -l)
+echo "  ✅ stdlib 모듈: $MODULES개"
+
+# 6. 배포 준비
+echo ""
+echo "📋 단계 6: 배포 준비"
+mkdir -p logs
+mkdir -p app
+echo "  ✅ 디렉토리 준비"
+
+# 7. 성능 정보
+echo ""
+echo "📋 단계 7: 성능 정보"
+echo "  - Bootstrap 크기: $(du -h bootstrap.js | cut -f1)"
+echo "  - Stdlib 코드량: $(cat self/stdlib/*.fl 2>/dev/null | wc -l) 줄"
+echo "  - 총 모듈: $(ls -1 self/stdlib/*.fl 2>/dev/null | wc -l)개"
+
+# 8. 최종 확인
+echo ""
+echo "📋 단계 8: 최종 확인"
+echo "  ✅ 배포 준비 완료"
+
+echo ""
+echo "╔════════════════════════════════════════════════════════════╗"
+echo "║  배포 시작                                                ║"
+echo "╚════════════════════════════════════════════════════════════╝"
+echo ""
+echo "명령어:"
+echo "  npm start                           # 기본 시작"
+echo "  PORT=3000 npm start                 # 포트 변경"
+echo "  npm run dev                         # 개발 모드"
+echo "  npm run dev:watch                   # 핫 리로드"
+echo ""
+
+# 9. 서버 시작
+node bootstrap.js serve app/ 2>&1 | tee logs/$(date +%Y%m%d-%H%M%S).log

package/scripts/dev.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# FreeLang v11 개발 서버 자동 포트 할당 스크립트
+
+echo ""
+echo "🚀 FreeLang v11 개발 서버 시작..."
+echo ""
+
+# 포트 범위
+START_PORT=30000
+END_PORT=35000
+
+# 사용 가능한 첫 번째 포트 찾기
+ASSIGNED_PORT=""
+for PORT in $(seq $START_PORT $END_PORT); do
+  if ! nc -z localhost $PORT 2>/dev/null; then
+    ASSIGNED_PORT=$PORT
+    break
+  fi
+done
+
+if [ -z "$ASSIGNED_PORT" ]; then
+  echo "❌ 사용 가능한 포트가 없습니다 (30000~35000)"
+  echo "다른 포트를 지정해주세요:"
+  echo "  PORT=30000 npm run dev"
+  exit 1
+fi
+
+echo "📍 자동 할당 포트: $ASSIGNED_PORT"
+echo ""
+echo "🔗 접근 URL:"
+echo "  http://localhost:$ASSIGNED_PORT"
+echo ""
+echo "💡 Ctrl+C 로 서버 중지"
+echo ""
+
+# 환경변수로 포트 지정하고 서버 실행
+PORT=$ASSIGNED_PORT npm run dev

package/scripts/extract-fl-examples.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+// FreeLang v11.1: CLAUDE.md / README.md 의 ```lisp 코드 블록을 추출하여 stdout으로 출력.
+// CI 에서 `node bootstrap.js check -` 로 파이프해 파서 검증용.
+
+const fs = require("fs");
+const path = require("path");
+
+function extract(filePath) {
+  const src = fs.readFileSync(filePath, "utf8");
+  const blocks = [];
+  const re = /```(lisp|fl|freelang)\s*\n([\s\S]*?)```/g;
+  let m;
+  while ((m = re.exec(src)) !== null) {
+    const code = m[2].trim();
+    if (code) blocks.push(`; ─── ${path.basename(filePath)} ─────\n${code}\n`);
+  }
+  return blocks.join("\n");
+}
+
+const files = process.argv.slice(2);
+if (files.length === 0) {
+  console.error("Usage: extract-fl-examples.js <file.md> [<file.md>...]");
+  process.exit(1);
+}
+
+for (const f of files) {
+  if (!fs.existsSync(f)) { console.error(`[skip] ${f} not found`); continue; }
+  process.stdout.write(extract(f));
+}