프로젝트 소개

SparkLang(저장소 sparklang, CLI spark, 제품명 SparkLang)은 일반 .spark 파일을 실행하는 MIT 라이선스 프로그래밍 언어 및 런타임입니다. README에서는 드라이 런 픽스처, 컴파일/바이트코드 처리, 플레이북 및 Spark IDE를 핵심 요소로 정의하며, 네트워크/웹, 음성/PSTN 및 라이브 모델 호출은 선택적 인터페이스로 취급합니다. 또한 Apache Spark, AdaCore SPARK, Bifrost 플러그인이 아님을 명시적으로 밝히고 있습니다. 기본 동작은 오프라인입니다. 드라이 런은 키나 네트워크가 필요 없으며, 선택 사항인 --live 플래그를 사용할 때만 AI_GATEWAY_URL 및 API 키를 통해 구성된 OpenAI 호환 게이트웨이와 동반 HTTP 헬퍼를 사용합니다. SPARK_STT_URL / SPARK_TTS_URL 및 SPARK_TRAIN_*와 같은 환경 변수는 선택적인 음성 및 학습 엔드포인트를 제어합니다. README에 설명된 언어 인터페이스에는 슬롯이 포함된 ask/generate 모델 호출, 단일 또는 다중 레이블 열거형 및 신뢰도를 사용하는 classify, 인라인 스키마를 통한 extract, 파이프라인 체이닝, 도구 선언, listen/speak/voice 세션, 정적 리뷰 및 out/ 폴더로의 코드 생성을 위한 review/builder/implement, 모델 작업(train, build, status, analyze, compare, improve, plan), 로컬 모델의 IDK 게이트를 위한 head abstain/train/attach/ask, binary open/elf/disasm/understand, 네트워크 캡처 및 pcap 분석, os design/specify/generate 블루프린트, browser/mitm 작업, cuda/memory/pcie 프로브, 그리고 AES-256-GCM을 사용하는 모델 암호화 엔벨로프를 위한 crypto/encrypt/gateway가 포함됩니다. 저장소는 A+B+C로 표시된 문서화된 저작 계획을 중심으로 구성되어 있습니다. 이는 장기적인 셀프 호스트 목적지, 얇은 C 부트스트랩 VM(bootstrap/), 그리고 Spark 네이티브 어셈블러(sparkasm/)를 의미합니다. asm/ 아래의 GAS x86_64 어셈블리 트리는 영구적인 소스 오브 트루스(source of truth)가 아닌 일회성 실행 스캐폴드로 설명됩니다. 레이아웃 항목에는 asm/, tools/ask/, tools/engine/, tools/browser/, selfhost/, hdl/classify_score.v, examples/*.spark, docs/*.md 및 마케팅 사이트를 위한 website/ 디렉토리가 포함됩니다. 검증은 구체적인 명령어를 통해 제공됩니다: make, make machine-proof(asm-to-ELF 출력을 주장하며 file로 검증), hello.spark, http_get.spark, classify_intent.spark 및 model_improve.spark와 같은 드라이 런 예제, 그리고 make test, make test-e2e-browser, make sparkbc-e2e 및 make test-ide-paint가 있습니다. Python 및 Node 진입점은 run()으로 표시됩니다. 안전 및 정직성 선언이 강조되어 있습니다: review는 웹 JavaScript를 절대 평가하지 않으며, 원격 리뷰 URL은 --allow-net이 필요하고 그렇지 않으면 명확한 오류와 함께 종료됩니다. 네트워크 캡처는 --allow-net-capture 뒤에 유지되며 CAP_NET_RAW가 없을 경우 문서화된 종료 코드 4를 반환합니다. 드라이 런 네트워크 프로브는 claimed:false로 보고합니다. os generate는 교육용 스텁만 작성하며 절대 OS를 재부팅하거나 설치하지 않습니다. 드라이 런에서의 모델 학습은 절대 작업을 시작하지 않습니다. 문서화된 비목표(non-goals)에는 커스텀 CPU ISA, 프로덕션 베어메탈 OS, 전체 ES/CSS 렌더링, 완성된 셀프 호스트 컴파일러, FPGA 비트스트림 배포 주장, 그리고 모든 무음 GPU 학습이 포함됩니다. README에 명시된 버전은 0.6.2이며, 설치 키트는 0.6.0으로 기재되어 있습니다.