freelang-editor 11.7.4

package/scripts/gen-fixtures.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+// P00/10: self-diff 검증용 fixture 100+ 생성.
+// lex / parse / eval 3 범주, 각 40 개. 실측 가능한 소규모 FL 스니펫.
+
+const fs = require("fs");
+const path = require("path");
+
+const ROOT = path.resolve(__dirname, "..");
+const LEX  = path.join(ROOT, "self/fixtures/lex");
+const PARSE= path.join(ROOT, "self/fixtures/parse");
+const EVAL = path.join(ROOT, "self/fixtures/eval");
+for (const d of [LEX, PARSE, EVAL]) fs.mkdirSync(d, { recursive: true });
+
+// ── LEX fixtures (토큰 단위) ──────────────────────────
+const lex = [
+  // 1-10: 기본 원자
+  ['empty',        ''],
+  ['single-num',   '42'],
+  ['float',        '3.14'],
+  ['negative',     '-7'],
+  ['string',       '"hello"'],
+  ['string-esc',   '"line1\\nline2"'],
+  ['symbol',       'foo'],
+  ['kebab-sym',    'hello-world?'],
+  ['keyword',      ':name'],
+  ['variable',     '$x'],
+  // 11-20: 괄호/S-expression
+  ['empty-list',   '()'],
+  ['small-sexpr',  '(+ 1 2)'],
+  ['nested',       '(+ (* 2 3) 4)'],
+  ['array',        '[1 2 3]'],
+  ['map',          '{:a 1 :b 2}'],
+  ['deep-nest',    '(((1)))'],
+  ['mixed',        '[(a) {:k 1}]'],
+  ['spaces',       '  (  +   1   2  )  '],
+  ['tabs-nl',      '(+\n\t1\n\t2)'],
+  ['comment',      '; this is a comment\n(+ 1 2)'],
+  // 21-30: 문자열 케이스
+  ['empty-str',    '""'],
+  ['str-quote',    '"he said \\"hi\\""'],
+  ['str-tab',      '"a\\tb"'],
+  ['unicode',      '"한글😀"'],
+  ['long-num',     '1234567890'],
+  ['zero',         '0'],
+  ['leading-zero', '007'],
+  ['neg-float',    '-3.14'],
+  ['scientific',   '1.5e10'],
+  ['hex',          '0xFF'],
+  // 31-40: 특수 문법
+  ['block',        '[FUNC add :params [$a $b] :body (+ $a $b)]'],
+  ['route-like',   '[ROUTE :path "/users" :handler "h"]'],
+  ['dollar-dot',   '$env.vars'],
+  ['at-atom',      '@today'],
+  ['true-false',   '(if true 1 false)'],
+  ['null',         'null'],
+  ['deep-array',   '[[[[1]]]]'],
+  ['deep-map',     '{:a {:b {:c 1}}}'],
+  ['many-args',    '(+ 1 2 3 4 5 6 7 8 9 10)'],
+  ['pipe-op',      '(-> 1 inc double)'],
+].filter(x => Array.isArray(x));
+
+// ── PARSE fixtures (AST 구조) ─────────────────────────
+const parse = [
+  ['literal-num',  '42'],
+  ['literal-str',  '"hello"'],
+  ['sym',          'foo'],
+  ['var',          '$x'],
+  ['kw',           ':name'],
+  ['sexpr',        '(+ 1 2)'],
+  ['nested',       '(if (> $x 0) $x (- 0 $x))'],
+  ['let-1d',       '(let [$x 5] $x)'],
+  ['let-2d',       '(let [[$x 5] [$y 6]] (+ $x $y))'],
+  ['let-bare',     '(let [x 5 y 6] (+ x y))'],
+  ['fn',           '(fn [$x] (* $x 2))'],
+  ['defn',         '(defn sq [$x] (* $x $x))'],
+  ['define-val',   '(define $pi 3.14)'],
+  ['define-fn',    '(define sq [$x] (* $x $x))'],
+  ['cond',         '(cond [(< $x 0) "neg"] [true "pos"])'],
+  ['do-begin',     '(do 1 2 3)'],
+  ['quote',        '(quote (a b c))'],
+  ['set-bang',     '(set! $x 10)'],
+  ['array-lit',    '[1 2 3 4]'],
+  ['map-lit',      '{:name "alice" :age 30}'],
+  ['block-func',   '[FUNC add :params [$a $b] :body (+ $a $b)]'],
+  ['nested-block', '[FUNC outer :body [FUNC inner :body 1]]'],
+  ['str-interp',   '"count: {$n}"'],
+  ['and-or',       '(or (and true false) true)'],
+  ['try-catch',    '(try (risky) (catch $e (log $e)))'],
+  ['loop-recur',   '(loop [[$i 0]] (if (< $i 10) (recur (+ $i 1)) $i))'],
+  ['compose',      '(compose inc double)'],
+  ['pipe',         '(|> 5 inc double)'],
+  ['thread-first', '(-> 5 (+ 1) (* 2))'],
+  ['thread-last',  '(->> [1 2 3] (map inc) (reduce +))'],
+  ['match-simple', '(match $x [0 "zero"] [_ "other"])'],
+  ['keyword-arg',  '(fn-call :a 1 :b 2)'],
+  ['multi-body',   '(fn [$x] (println "hi") (* $x 2))'],
+  ['nested-arr',   '[[1 2] [3 4]]'],
+  ['nested-map',   '{:outer {:inner 1}}'],
+  ['empty-fn',     '(fn [] 42)'],
+  ['empty-list',   '()'],
+  ['dotted',       '$ctx.user.id'],
+  ['if-only',      '(if true 1)'],
+  ['if-else',      '(if false 0 1)'],
+];
+
+// ── EVAL fixtures (실행 결과) ─────────────────────────
+const evalFx = [
+  ['add',          '(+ 1 2)'],
+  ['mul-nested',   '(+ (* 2 3) 4)'],
+  ['sub',          '(- 10 3)'],
+  ['div',          '(/ 20 4)'],
+  ['mod',          '(% 10 3)'],
+  ['bool-true',    '(if true 1 2)'],
+  ['bool-false',   '(if false 1 2)'],
+  ['cmp-lt',       '(if (< 3 5) "yes" "no")'],
+  ['cmp-eq',       '(if (= 5 5) 1 0)'],
+  ['and-sc',       '(and true false true)'],
+  ['or-sc',        '(or false true false)'],
+  ['not',          '(not false)'],
+  ['null-p',       '(null? null)'],
+  ['let-use',      '(let [$x 5] (+ $x 10))'],
+  ['let-flat',     '(let [$x 2 $y 3] (* $x $y))'],
+  ['let-bare',     '(let [x 4 y 5] (+ x y))'],
+  ['fn-apply',     '((fn [$x] (* $x 2)) 21)'],
+  ['defn-call',    '(defn sq [$x] (* $x $x)) (sq 7)'],
+  ['defn-bare',    '(defn double [x] (* x 2)) (double 9)'],
+  ['define-var',   '(define $pi 3) (+ $pi 0)'],
+  ['define-fn3',   '(define tri [$x] (* $x 3)) (tri 4)'],
+  ['recursion',    '(defn fact [$n] (if (<= $n 1) 1 (* $n (fact (- $n 1))))) (fact 5)'],
+  ['cond-first',   '(cond [(> 1 2) "a"] [(> 5 3) "b"] [true "c"])'],
+  ['str-concat',   '(str "hello " "world")'],
+  ['str-num',      '(str "count: " 5)'],
+  ['list-first',   '(first (list 10 20 30))'],
+  ['list-last',    '(last (list 10 20 30))'],
+  ['list-len',     '(length (list 1 2 3 4 5))'],
+  ['get-idx',      '(get (list 10 20 30) 1)'],
+  ['get-key',      '(get {:a 1 :b 2} :a)'],
+  ['map-hof',      '(map (fn [$x] (* $x 2)) (list 1 2 3))'],
+  ['filter-hof',   '(filter (fn [$x] (> $x 2)) (list 1 2 3 4))'],
+  ['reduce-hof',   '(reduce (fn [$a $b] (+ $a $b)) 0 (list 1 2 3 4))'],
+  ['substring',    '(substring "hello" 1 4)'],
+  ['replace',      '(replace "a-b-c" "-" "_")'],
+  ['sqrt',         '(sqrt 16)'],
+  ['pow',          '(pow 2 10)'],
+  ['floor',        '(floor 3.7)'],
+  ['closure',      '(define make-add (fn [$n] (fn [$x] (+ $x $n)))) ((make-add 10) 5)'],
+  ['higher-order', '(define add1 (fn [$x] (+ $x 1))) (define mul2 (fn [$x] (* $x 2))) (mul2 (add1 3))'],
+];
+
+function write(dir, items) {
+  let count = 0;
+  for (const [name, code] of items) {
+    const file = path.join(dir, `${name}.fl`);
+    if (!fs.existsSync(file)) {
+      fs.writeFileSync(file, code + "\n", "utf8");
+      count++;
+    }
+  }
+  return count;
+}
+
+const lexN   = write(LEX, lex);
+const parseN = write(PARSE, parse);
+const evalN  = write(EVAL, evalFx);
+
+console.log(`fixtures=generated lex=${lexN} parse=${parseN} eval=${evalN} total=${lexN + parseN + evalN}`);

package/scripts/gen-mistakes-split.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+// _classifications.json → MISTAKES.md / LEARNING.md / LANGUAGE-FAULTS.md 자동 생성
+
+const path = require("path");
+const fs = require("fs");
+
+const docsDir = path.resolve(__dirname, "..", "docs");
+const cls = JSON.parse(fs.readFileSync(path.join(docsDir, "_classifications.json"), "utf-8"));
+
+// 본 MISTAKES-100.md에서 코드 블록 추출
+const orig = fs.readFileSync(path.join(docsDir, "MISTAKES-100.md"), "utf-8");
+
+function extractItem(num) {
+  // ;; #N — 으로 시작하는 단락 추출 (다음 ;; #N+ 또는 --- 까지)
+  const re = new RegExp(`;;\\s*#${num}\\b[\\s\\S]*?(?=\\n;;\\s*#\\d+\\b|\\n\`\`\`|\\n---)`, "m");
+  const m = orig.match(re);
+  return m ? m[0].trim() : null;
+}
+
+// ─────────────────────────────────────────────────────────────
+// 분류 컬렉션
+// ─────────────────────────────────────────────────────────────
+const groups = {};
+for (const t of Object.keys(cls._categories)) groups[t] = [];
+
+for (const [id, item] of Object.entries(cls.items)) {
+  groups[item.type].push({ id, ...item, code: extractItem(id.slice(1)) });
+}
+
+// ─────────────────────────────────────────────────────────────
+// MISTAKES.md — 진짜 실수 (user + learning + missing)
+// ─────────────────────────────────────────────────────────────
+function genMistakes() {
+  const lines = [
+    "# FreeLang v11 — 진짜 실수 모음",
+    "",
+    "> 사용자/AI가 *진짜로 잘못 쓰는* 항목. 28개.",
+    "> v11.4.2 기준 28개 중 20개 ALIAS hint로 자동 처리됨.",
+    "",
+    "관련 문서:",
+    "- `LEARNING.md` — Lisp/FreeLang 학습 (실수 아님, 25개)",
+    "- `LANGUAGE-FAULTS.md` — 언어 디자인 결함 (44개, v12 fix 대상)",
+    "- `MISTAKES-COVERAGE.json` — 자동 처리 카운트",
+    "",
+    "---",
+    "",
+    "## 💀 진짜 부주의 (3개)",
+    "",
+    "코드 작성자가 명백히 실수한 경우.",
+    "",
+  ];
+  for (const it of groups.user) {
+    lines.push(`### ${it.id} — ${it.summary}`);
+    lines.push("");
+    if (it.code) lines.push("```lisp\n" + it.code + "\n```");
+    lines.push("");
+  }
+
+  lines.push("---");
+  lines.push("");
+  lines.push("## 💡 다른 언어 습관 (20개)");
+  lines.push("");
+  lines.push("AI/사용자가 다른 언어 습관으로 잘못된 함수명을 쓰는 경우. **모두 ALIAS hint 자동 처리됨**.");
+  lines.push("");
+  lines.push("| # | 잘못된 호출 | 올바른 호출 | 출처 |");
+  lines.push("|---|------------|------------|------|");
+  for (const it of groups.learning) {
+    lines.push(`| ${it.id} | ${it.summary} | ALIAS 처리 | ${it.fix || "—"} |`);
+  }
+  lines.push("");
+  lines.push("→ `freelang-smart`로 실행하면 자동 hint.");
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## 🚧 언어 미구현 (5개)");
+  lines.push("");
+  lines.push("기능 자체가 미구현이라 *대안*을 알아야 하는 경우. Phase Y 대상.");
+  lines.push("");
+  for (const it of groups.missing) {
+    lines.push(`### ${it.id} — ${it.summary}`);
+    lines.push("");
+    if (it.code) lines.push("```lisp\n" + it.code + "\n```");
+    lines.push("");
+    if (it.fix) lines.push(`**Fix**: ${it.fix}`);
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+// ─────────────────────────────────────────────────────────────
+// LEARNING.md — Lisp/FreeLang 학습 (정상 동작)
+// ─────────────────────────────────────────────────────────────
+function genLearning() {
+  const lines = [
+    "# FreeLang v11 — 학습 자료 (정상 동작)",
+    "",
+    "> 다른 언어와 다른 동작이지만 **FreeLang에서 정상**. 25개.",
+    "> 실수가 아닌 *학습 사항*. JS/Python 출신이 헷갈리는 패턴.",
+    "",
+    "관련 문서:",
+    "- `MISTAKES.md` — 진짜 실수",
+    "- `LANGUAGE-FAULTS.md` — 언어 결함 (다음 메이저에서 수정)",
+    "",
+    "---",
+    "",
+    "## 📚 Lisp/함수형 표준 동작",
+    "",
+  ];
+  for (const it of groups.normal) {
+    lines.push(`### ${it.id} — ${it.summary}`);
+    lines.push("");
+    if (it.code) lines.push("```lisp\n" + it.code + "\n```");
+    lines.push("");
+  }
+
+  lines.push("---");
+  lines.push("");
+  lines.push("## 📝 문서 오류 (3개)");
+  lines.push("");
+  lines.push("MISTAKES-100에서 *틀린 코드*라고 표시했지만 **실제로는 작동**하는 경우.");
+  lines.push("문서가 outdated. 정정 예정.");
+  lines.push("");
+  for (const it of groups.doc) {
+    lines.push(`### ${it.id} — ${it.summary}`);
+    lines.push("");
+    if (it.code) lines.push("```lisp\n" + it.code + "\n```");
+    lines.push("");
+    if (it.fix) lines.push(`**Fix**: ${it.fix}`);
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+// ─────────────────────────────────────────────────────────────
+// LANGUAGE-FAULTS.md — 언어 디자인 결함
+// ─────────────────────────────────────────────────────────────
+function genFaults() {
+  const lines = [
+    "# FreeLang v11 — 언어 디자인 결함 (44개)",
+    "",
+    "> *사용자가 실수하는 게 아니라 언어가 일관성 없게 만들어졌다.*",
+    "> Phase X (v12) 대상. Breaking change + 마이그레이션 도구.",
+    "",
+    "관련 문서:",
+    "- `MISTAKES.md` — 진짜 사용자 실수",
+    "- `LEARNING.md` — Lisp 학습 자료",
+    "- `ROADMAP.md` Phase X — v12 통일 계획",
+    "",
+    "---",
+    "",
+    "## 🔧 분류",
+    "",
+    "| 분류 | 개수 | 핵심 문제 |",
+    "|-----|------|----------|",
+    "| 인자 순서 | 10 | fn-first vs col-first vs key-first 혼재 |",
+    "| HTTP API | 10 | 반환 구조체 vs 직접 / 시그니처 비일관 |",
+    "| 상태 관리 | 5  | atom 의무화 / set! 클로저 미반영 |",
+    "| 함수 선언 | 4  | $ 접두사 / [FUNC] deprecated |",
+    "| 작명 비일관 | 5 | kebab vs snake / suffix `?` 임의 |",
+    "| 데이터 타입 | 3 | 키워드 키 강제 / 깊은 동등성 미지원 |",
+    "| 기타 | 7 | (str map) → \"[object]\" 등 |",
+    "| **합계** | **44** | — |",
+    "",
+    "---",
+    "",
+    "## 모든 항목 (44개)",
+    "",
+    "각 항목의 **fix**는 v12 Phase X 작업 항목.",
+    "",
+  ];
+  for (const it of groups.design) {
+    lines.push(`### ${it.id} — ${it.summary}`);
+    lines.push("");
+    if (it.code) lines.push("```lisp\n" + it.code + "\n```");
+    if (it.fix) {
+      lines.push("");
+      lines.push(`**v12 fix**: ${it.fix}`);
+    }
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+// 쓰기
+fs.writeFileSync(path.join(docsDir, "MISTAKES.md"),         genMistakes());
+fs.writeFileSync(path.join(docsDir, "LEARNING.md"),         genLearning());
+fs.writeFileSync(path.join(docsDir, "LANGUAGE-FAULTS.md"),  genFaults());
+
+console.log("✓ docs/MISTAKES.md          생성");
+console.log("✓ docs/LEARNING.md          생성");
+console.log("✓ docs/LANGUAGE-FAULTS.md   생성");
+console.log();
+console.log("분류 카운트:");
+for (const [type, info] of Object.entries(cls._categories)) {
+  console.log(`  ${info.icon} ${info.label.padEnd(20)} ${(groups[type]?.length || 0).toString().padStart(2)}`);
+}

package/scripts/gen-stdlib-docs.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// FreeLang v11.2: stdlib-*.ts 파일에서 함수 API 주석을 추출하여 docs/API.md 생성.
+// 주석 형식: `// func_name params -> return` 다음 줄에 `"func_name": (...)` 패턴.
+
+const fs = require("fs");
+const path = require("path");
+
+const SRC_DIR = path.resolve(__dirname, "..", "src");
+const OUT = path.resolve(__dirname, "..", "docs", "API.md");
+
+function extractModule(filePath) {
+  const content = fs.readFileSync(filePath, "utf8");
+  const lines = content.split("\n");
+  const modName = path.basename(filePath, ".ts").replace(/^stdlib-/, "");
+  const funcs = [];
+
+  for (let i = 0; i < lines.length; i++) {
+    const cur = lines[i].trim();
+    // 주석 패턴: `// name args -> return` 그리고 다음 줄이 `"name": (...)` 인 경우
+    const commentMatch = cur.match(/^\/\/\s*([a-z][a-z0-9_\-!?]*)\s+(.*?)\s*->\s*(.+)$/);
+    if (!commentMatch) continue;
+    const [, name, params, retType] = commentMatch;
+    // 다음 줄 확인
+    const next = (lines[i + 1] || "").trim();
+    const defMatch = next.match(/^"([^"]+)"\s*:/);
+    if (!defMatch || defMatch[1] !== name) continue;
+    funcs.push({ name, params: params.trim(), ret: retType.trim() });
+  }
+
+  return { module: modName, funcs };
+}
+
+function render(modules) {
+  const now = new Date().toISOString().slice(0, 10);
+  let md = `# FreeLang v11 — stdlib API\n\n`;
+  md += `> Auto-generated by \`scripts/gen-stdlib-docs.js\` (${now}). Do not edit by hand.\n\n`;
+  md += `## Modules\n\n`;
+  for (const m of modules) {
+    if (m.funcs.length === 0) continue;
+    md += `- [${m.module}](#${m.module}) (${m.funcs.length} functions)\n`;
+  }
+  md += `\n---\n\n`;
+  for (const m of modules) {
+    if (m.funcs.length === 0) continue;
+    md += `## ${m.module}\n\n`;
+    md += `| Function | Params | Returns |\n|----------|--------|---------|\n`;
+    for (const f of m.funcs) {
+      md += `| \`${f.name}\` | ${f.params} | ${f.ret} |\n`;
+    }
+    md += `\n`;
+  }
+  return md;
+}
+
+function main() {
+  const files = fs.readdirSync(SRC_DIR)
+    .filter((f) => f.startsWith("stdlib-") && f.endsWith(".ts"))
+    .map((f) => path.join(SRC_DIR, f));
+
+  const modules = files.map(extractModule);
+  const md = render(modules);
+
+  fs.mkdirSync(path.dirname(OUT), { recursive: true });
+  fs.writeFileSync(OUT, md, "utf8");
+  const total = modules.reduce((s, m) => s + m.funcs.length, 0);
+  console.log(`✅ ${OUT} — ${modules.length} modules, ${total} functions`);
+}
+
+main();

package/scripts/lint-stdlib-aliases.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+// scripts/lint-stdlib-aliases.js — stdlib 함수명 hyphen/underscore alias 일관성 lint
+//
+// 목적:
+//   AI는 Lisp 관례(hyphen)와 PHP/Python 관례(underscore) 둘 다 자연스럽게 작성.
+//   stdlib에 한쪽만 등록되면 AI 코드가 "Function not found"로 깨짐.
+//   양쪽 모두 등록 (alias)되어야 호환성 보장.
+//
+// 검사:
+//   1. src/stdlib-*.ts 모든 함수명 추출
+//   2. 함수명에 _ 또는 - 가 있으면 alias 후보
+//      - foo_bar 있는데 foo-bar 없으면 → MISSING_HYPHEN_ALIAS
+//      - foo-bar 있는데 foo_bar 없으면 → MISSING_UNDERSCORE_ALIAS
+//   3. 분류:
+//      - 핵심 alias 누락: WARN (권장)
+//      - 단일 자만 다름 (json_get vs json-get): WARN
+//
+// 사용:
+//   node scripts/lint-stdlib-aliases.js          # 진단만
+//   node scripts/lint-stdlib-aliases.js --json   # CI용
+//   node scripts/lint-stdlib-aliases.js --quiet  # exit code만
+//
+// 통합:
+//   scripts/build.js의 extractSignatures 직후 자동 실행 가능
+//   make lint-aliases 명령
+
+const fs = require("fs");
+const path = require("path");
+
+const REPO = path.resolve(__dirname, "..");
+const SRC_DIR = path.join(REPO, "src");
+
+const args = process.argv.slice(2);
+const JSON_OUT = args.includes("--json");
+const QUIET = args.includes("--quiet");
+
+// ─────────────────────────────────────────────────────────────
+// stdlib-*.ts 파일에서 함수명 추출
+// ─────────────────────────────────────────────────────────────
+
+function extractFunctionNames(filePath) {
+  const content = fs.readFileSync(filePath, "utf-8");
+  // 패턴: "name": (...) => 또는 "name": function 또는 "name": fn
+  // 객체 리터럴 키 형태
+  const re = /"([a-zA-Z_][a-zA-Z0-9_-]*[?!]?)"\s*:/g;
+  const names = new Set();
+  let m;
+  while ((m = re.exec(content)) !== null) {
+    names.add(m[1]);
+  }
+  // case fall-through 패턴: case "name": case "alias":
+  // (eval-builtins.ts에 있는 패턴)
+  const caseRe = /case\s+"([a-zA-Z_][a-zA-Z0-9_-]*[?!]?)":/g;
+  while ((m = caseRe.exec(content)) !== null) {
+    names.add(m[1]);
+  }
+  return names;
+}
+
+function loadAllStdlibNames() {
+  const files = fs.readdirSync(SRC_DIR).filter(f =>
+    (f.startsWith("stdlib-") && f.endsWith(".ts")) ||
+    f === "eval-builtins.ts"
+  );
+  const all = new Set();
+  const byFile = {};
+  for (const f of files) {
+    const names = extractFunctionNames(path.join(SRC_DIR, f));
+    byFile[f] = names;
+    for (const n of names) all.add(n);
+  }
+  return { all, byFile };
+}
+
+// ─────────────────────────────────────────────────────────────
+// alias 누락 검출
+// ─────────────────────────────────────────────────────────────
+
+function findMissingAliases(allNames) {
+  const issues = [];
+  for (const name of allNames) {
+    // hyphen 있으면 underscore 버전 확인
+    if (name.includes("-")) {
+      const underscored = name.replace(/-/g, "_");
+      if (!allNames.has(underscored)) {
+        issues.push({
+          level: "info",
+          code: "MISSING_UNDERSCORE_ALIAS",
+          name,
+          missing: underscored,
+          msg: `'${name}' 있음, '${underscored}' 누락 (AI underscore 표기 호환)`,
+        });
+      }
+    }
+    // underscore 있으면 hyphen 버전 확인 (ai_, ws_, db_ 등 namespace는 제외)
+    if (name.includes("_")) {
+      // namespace prefix 패턴 제외 (e.g., ws_send, db_query, ai_complete)
+      // 단순 짧은 prefix는 lib namespace로 보고 skip
+      const parts = name.split("_");
+      const isShortNamespace = parts[0].length <= 3 && parts.length === 2;
+      if (isShortNamespace) continue;
+
+      const hyphenated = name.replace(/_/g, "-");
+      if (!allNames.has(hyphenated) && hyphenated !== name) {
+        issues.push({
+          level: "info",
+          code: "MISSING_HYPHEN_ALIAS",
+          name,
+          missing: hyphenated,
+          msg: `'${name}' 있음, '${hyphenated}' 누락 (AI hyphen 표기 호환)`,
+        });
+      }
+    }
+  }
+  return issues;
+}
+
+// ─────────────────────────────────────────────────────────────
+// Report
+// ─────────────────────────────────────────────────────────────
+
+function main() {
+  const { all, byFile } = loadAllStdlibNames();
+  const issues = findMissingAliases(all);
+
+  // 분류
+  const missingHyphen = issues.filter(i => i.code === "MISSING_HYPHEN_ALIAS");
+  const missingUnderscore = issues.filter(i => i.code === "MISSING_UNDERSCORE_ALIAS");
+
+  if (JSON_OUT) {
+    const out = {
+      timestamp: new Date().toISOString(),
+      total_functions: all.size,
+      total_issues: issues.length,
+      missing_hyphen_aliases: missingHyphen.length,
+      missing_underscore_aliases: missingUnderscore.length,
+      issues: issues.slice(0, 100), // 처음 100개만 (너무 많으면 truncate)
+    };
+    process.stdout.write(JSON.stringify(out, null, 2));
+  } else if (!QUIET) {
+    console.log(`\n📋 stdlib alias lint`);
+    console.log(`   총 함수: ${all.size}`);
+    console.log(`   진단 이슈: ${issues.length}개`);
+    console.log(`     - hyphen alias 누락: ${missingHyphen.length} (underscore→hyphen)`);
+    console.log(`     - underscore alias 누락: ${missingUnderscore.length} (hyphen→underscore)\n`);
+
+    if (issues.length > 0) {
+      console.log(`상세 (처음 30개):\n`);
+      for (const i of issues.slice(0, 30)) {
+        const icon = { error: "❌", warn: "⚠️", info: "💡" }[i.level] ?? "·";
+        console.log(`  ${icon} [${i.code}] ${i.msg}`);
+      }
+      if (issues.length > 30) {
+        console.log(`\n  ... 외 ${issues.length - 30}개 (--json 으로 전체 보기)`);
+      }
+    } else {
+      console.log(`✅ alias 일관성 완벽`);
+    }
+  }
+
+  // CI: warning만 → exit 0 (advisory)
+  // 향후: 'error' 레벨 추가 시 exit 1
+  process.exit(0);
+}
+
+main();

package/scripts/measure-baseline.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# 벤치마크 기준선 측정
+set -euo pipefail
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+RESULTS="$PROJECT_ROOT/benchmark-baseline.json"
+
+echo "🔍 벤치마크 기준선 측정 중..."
+
+cat > "$RESULTS" <<'JSON'
+{
+  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "baseline": "interpreter-only (no VM)",
+  "results": [
+JSON
+
+for bench_file in "$PROJECT_ROOT"/self/bench/_*.fl; do
+  name=$(basename "$bench_file" .fl)
+  echo "  측정 중: $name"
+  
+  # 컴파일
+  output="/tmp/$name.js"
+  node bootstrap.js run self/codegen.fl "$bench_file" "$output" 2>/dev/null || continue
+  
+  # 시간 측정 (3회 실행 후 평균)
+  times=()
+  for i in {1..3}; do
+    start=$(date +%s%N)
+    node "$output" >/dev/null 2>&1 || true
+    end=$(date +%s%N)
+    elapsed=$(( (end - start) / 1000000 ))  # ns to ms
+    times+=($elapsed)
+  done
+  
+  # 평균 계산
+  sum=0
+  for t in "${times[@]}"; do sum=$((sum + t)); done
+  avg=$((sum / 3))
+  
+  echo "    $name: ${avg}ms"
+done
+
+echo "✅ 벤치마크 기준선 저장: $RESULTS"