🔍 FreeLang Ledger v1

코드와 문서의 진실 원장 시스템

📋 개요

FreeLang 생태계에서 코드와 문서의 일치성을 자동으로 검증하고, 패턴을 학습하여 자동 생성하는 통합 플랫폼.

3가지 핵심 엔진

1. Spec Validator - 문서 ↔ 코드 자동 검증
2. Pattern Extractor - 반복 패턴 인식 & 자동 생성
3. Dist Verifier - 분산 환경에서 동일성 보장

🎯 목표

| Phase | 목표 | 상태 | |-------|------|------| | Phase 1 | 핵심 엔진 (Spec Parser + AST Analyzer) | 🔵 설계 중 | | Phase 2 | Validator Engine | ⚪ 예정 | | Phase 3 | Pattern DB & Extractor | ⚪ 예정 | | Phase 4 | CLI 완성 | ⚪ 예정 | | Phase 5 | API 서버 | ⚪ 예정 | | Phase 6 | Dist Verification | ⚪ 예정 |

📁 프로젝트 구조

src/
├── core/              # 핵심 엔진
│   ├── spec-parser.ts        (MD → 스펙)
│   ├── ast-analyzer.ts       (코드 분석)
│   ├── validator-engine.ts   (검증)
│   └── pattern-db.ts         (패턴)
├── cli/               # 커맨드라인 도구
├── api/               # REST API
└── ...
tests/                 # 테스트 스위트
docs/                  # 문서

🔑 주요 개념

Spec (스펙)

# README.md에서 추출된 "기대값"
function:
  name: compute_hash
  inputs:
    - name: data
      type: string
  outputs:
    - name: result
      type: uint8
  deterministic: true
  languages: [c, go, python]

Pattern (패턴)

{
  "name": "namespace_hash",
  "code": "SHA256(name:size:dataType)",
  "languages": ["c", "go", "rust"],
  "frequency": "high",
  "stability": "phase-10-validated"
}

🚀 빠른 시작

# 설치
npm install

# Spec 검증
npm run cli validate --spec README.md --code src/

# 패턴 추출
npm run cli extract --dir src/ --output patterns.json

# 분산 검증
npm run cli verify-dist --manifest manifest.json

📚 더 보기

• PHASES.md - 각 Phase별 상세
• SPEC.md - 스펙 형식 정의
• API.md - API 문서

Created: 2026-03-24 Status: Phase 1 설계 Lead: FreeLang Nexus Integration