Skip to content

eunhhu/orv

BranchesTags

Repository files navigation

orv

프로젝트 특화(Project-Specialized) 풀스택 언어 플랫폼

orv는 단순한 새 언어가 아니다. 언어, 컴파일러, 에디터, 런타임, 디자인 시스템이 같은 프로젝트 그래프를 공유하는 통합 플랫폼을 목표로 한다.

철학

북극성 목표: 비개발자가 AI 없이 5시간 안에 쇼핑몰을 만든다

orv의 생산성 목표는 슬로건이 아니라 제품 벤치마크다. 코딩 경험이 거의 없는 사람이 Copilot, Cursor, ChatGPT 같은 AI 보조 없이 결제, 배송, 회원 기능이 있는 작은 쇼핑몰을 5시간 안에 만들고 검증할 수 있어야 한다.

이 목표 때문에 orv는 다음을 우선한다.

  • 빌드 도구, 프레임워크 조합, 라이브러리 선택 같은 우발적 복잡성을 줄인다.
  • 라우트, DB, 폼, 디자인, 보안, adapter boundary를 first-party compiler plugin이 제공하는 도메인 문법으로 표현한다.
  • 타입/스키마 선언이 폼 검증, HTTP body 검증, DB schema, migration과 이어지게 한다.
  • 에디터와 런타임이 같은 프로젝트 그래프를 보며 source-to-production reveal을 가능하게 한다.
  • 안전한 auth/session/csrf/secret/adapter 기본값을 scaffold와 library layer에 포함한다.

벤치마크 절차는 BENCHMARK_SHOP_5H.md에 둔다.

진짜 차별점

orv의 차별점은 "새 문법" 자체보다 프로젝트 그래프를 중심으로 한 도메인 UX다. 현재 안정화 단계에서는 RC 메모리 모델, 자체 DB 엔진, full native optimizer보다 @route + @db + @html + @design + editor reveal + deploy smoke를 압도적으로 잘 만드는 것이 더 중요하다.

Platform Boundary

쇼핑몰은 benchmark와 first-party template이다. Compiler core는 도메인별 추상화 자체를 intrinsic으로 알면 안 된다. Payment, shipping, Stripe, carrier, cart/order business rules도 core가 알면 안 된다.

Compiler core가 알아야 하는 것은 표준 이론, 보편 기술 추상화, compiler plugin protocol이다.

  • syntax / AST / HIR
  • normalized domain call
  • type / schema / validation
  • ProjectGraph / origin / reveal
  • compiler plugin registry/hook protocol
  • generic capability metadata
  • secret/env/redaction
  • generic adapter/capability call
  • build/deploy/preflight artifact schema

@server, @route, @html, @db, @design, @Auth 같은 도메인별 추상화는 first-party compiler plugin surface다. @payment, @shipping, Stripe webhook, carrier booking, cart/order/admin flow는 orv-commerce, orv-shop, provider package, 또는 template surface로 취급한다. 현재 repo의 commerce reference adapters는 benchmark를 닫기 위한 implementation convenience이며 compiler core intrinsic이 아니다. 자세한 경계는 PLATFORM_BOUNDARY.md를 따른다.

현재 구현 상태 요약

현재 orv는 Rust workspace 기반 MVP로 구현 중이다.

  • .orv source load / lex / parse
  • import 기반 project loading과 AST ProjectGraph v1
  • name resolution / semantic analysis / HIR lowering
  • reference tree-walking runtime
  • HTTP/1.1 @server through first-party web plugin surface
  • in-memory DB 및 SQLite row JSON reference adapter
  • benchmark용 commerce reference adapter와 generic HTTP bridge contract
  • HIR origin map과 semantic contains/calls edge
  • orv graph, orv origins, orv reveal
  • build/deploy artifact contract
  • orv init <dir> --template shop
  • 일부 editor/LSP/DAP/bootstrap surface

Native optimizer, production editor reveal UI, full project-specialized runtime generation, custom DB engine, CRDT, @gpu, @net, broad FFI는 아직 안정 제품 계약이 아니다. 현재 상태를 가장 짧게 말하면 reference MVP와 artifact contract는 많이 구현됐고, production-grade platform과 first-party editor 제품은 아직 남아 있다.

상세 판정은 MVP.md, IMPLEMENTATION_MATRIX.md, IMPLEMENTATION_GAP_REPORT.md, OPERATIONAL_SURFACES.md를 본다.

현재 안정화 중심축

ProjectGraph + HIR Origin + Reference Runtime + Trace/Reveal

지금 중요한 것은 기능을 더 넓히는 것보다 이 축의 계약을 안정화하는 것이다. Span -> AST node -> HIR node -> runtime event -> origin id 연결, orv graph/orv origins/x-orv-origin-id/trace JSON의 같은 origin schema, CLI/static graph view만으로 production output에서 source로 돌아가는 reveal path가 먼저 단단해야 한다.

MVP 범위

구현 중인 제품 MVP는 "쇼핑몰 benchmark를 통과시키는 데 필요한 플랫폼 primitive와 first-party template surface"에 집중한다.

포함 뒤로 미룸
first-party web/data/security/design compiler plugins: @server, @route, @html, @form, @db, @Auth, @session, @csrf, @rateLimit, @design @gpu, @net, CRDT as product-ready plugins
schema/migration DSL through data plugin custom DB optimizer, sharding, replication
compiler plugin protocol boundary full self-host editor
generic adapter/secret/idempotency/reveal boundary broad FFI and @unsafe workflows
orv-shop/orv-commerce style template/library surface provider-specific compiler core intrinsics
orv init <dir> --template shop, orv dev, orv build --prod full native compiler and optimized client runtime
orv deploy-env-check, orv benchmark-prepare, orv benchmark-report, generated preflight/benchmark evidence artifacts, generated smoke-test advanced cloud object storage/provider matrix

Generated smoke tests are part of the MVP contract: production builds should check reachable server routes, the reference shop checkout/admin flow, and interactive client bundle files/markers before a non-developer treats a build as deployable.

통합 플랫폼의 네 레이어

┌─────────────────────────────────────────┐
│ Editor    — 프로젝트 그래프의 라이브 뷰 │
├─────────────────────────────────────────┤
│ Language  — 도메인 의도를 문법으로 표현 │
├─────────────────────────────────────────┤
│ Compiler  — 그래프, 검증, 산출물 계약   │
├─────────────────────────────────────────┤
│ Runtime   — reference 실행과 배포 경로   │
└─────────────────────────────────────────┘

현재 MVP의 source-to-production 연결은 HIR origin map, contains/calls edge, HTTP route origin id 헤더, build artifact reveal CLI에서 시작한다. DOM 요소, DB 쿼리, job, trace, 로그에서 에디터로 직접 reveal하는 풍부한 native UI는 로드맵이다.

문서 구조와 읽는 순서

문서 책임
README.md 비전, 대상 사용자, MVP 경계
MVP.md 지금 되는 것과 MVP non-goal
PLATFORM_BOUNDARY.md compiler core, compiler plugin, library/template, provider package 경계
IMPLEMENTATION_MATRIX.md 상태, 계약 레벨, milestone, crate, fixture, CLI 표
IMPLEMENTATION_STATUS.md 상태 용어와 빠른 요약
IMPLEMENTATION_GAP_REPORT.md 전체 문서 대비 진행률과 남은 기능 분석
SPEC.md 공식 문법과 목표 의미론
ARCHITECTURE.md 현재 Rust crate 구조와 데이터 흐름
OPERATIONAL_SURFACES.md CLI/LSP/DAP/build/DB 운영 surface
contracts/ ProjectGraph/origin-map 등 public artifact JSON 계약
AI_FEATURES.md 에디터 AI autocomplete와 학습 전략
BENCHMARK_SHOP_5H.md 5시간 쇼핑몰 테스트 프로토콜
SECURITY_MODEL.md 안전한 기본값과 scaffold 보안 기대치
ROADMAP.md 미래 기능
CHANGELOG.md 날짜가 붙은 구현 델타
DOCUMENTATION.md 문서 수정 규칙

처음 읽을 때 빠른 경로는 README -> MVP -> PLATFORM_BOUNDARY -> IMPLEMENTATION_MATRIX -> IMPLEMENTATION_GAP_REPORT -> SPEC -> ARCHITECTURE -> OPERATIONAL_SURFACES이고, 전체 권장 순서는 DOCUMENTATION.md를 따른다. 문서 간 충돌 시 언어 의미론은 SPEC.md, compiler/library/provider 경계는 PLATFORM_BOUNDARY.md, 구현/계약 상태는 IMPLEMENTATION_MATRIX.md, 운영 surface는 OPERATIONAL_SURFACES.md, 에디터 AI 전략은 AI_FEATURES.md를 따른다.

성능 목표

orv의 "Zero-runtime" 원칙은 사용하지 않는 런타임 계층을 번들에 넣지 않는다는 뜻이다. 모든 앱이 0 byte 또는 3 KB가 된다는 뜻은 아니다.

앱 유형 초기 번들 목표 예시
정적 랜딩/블로그 0 byte JS 문서, 마케팅 페이지
가벼운 대화형 SPA <= 3 KB JS/WASM shell 폼, 카운터
표준 SPA <= 30 KB initial shell + lazy route dashboard
그래픽스/미디어 SPA <= 200 KB shell + streamed assets design/media tool
게임/네이티브급 <= 1 MB shell + streamed assets browser game

Backend, editor, and compiler performance targets are targets, not published claims. Any external comparison must include hardware, route shape, payload, concurrency, warm/cold mode, TLS, compiler profile, and benchmark harness.

프로젝트 구조

miol/
├── crates/
│   ├── orv-analyzer
│   ├── orv-cli
│   ├── orv-compiler
│   ├── orv-core
│   ├── orv-diagnostics
│   ├── orv-hir
│   ├── orv-ids
│   ├── orv-macros
│   ├── orv-project
│   ├── orv-resolve
│   ├── orv-runtime
│   └── orv-syntax
├── docs/
│   ├── README.md
│   ├── MVP.md
│   ├── PLATFORM_BOUNDARY.md
│   ├── IMPLEMENTATION_MATRIX.md
│   ├── IMPLEMENTATION_STATUS.md
│   ├── IMPLEMENTATION_GAP_REPORT.md
│   ├── SPEC.md
│   ├── ARCHITECTURE.md
│   ├── OPERATIONAL_SURFACES.md
│   ├── AI_FEATURES.md
│   ├── BENCHMARK_SHOP_5H.md
│   ├── SECURITY_MODEL.md
│   ├── ROADMAP.md
│   ├── CHANGELOG.md
│   └── DOCUMENTATION.md
└── fixtures/
    ├── default-syntax.orv
    ├── e2e/
    └── plan/

기술 스택

  • Rust edition 2021, MSRV 1.86.0
  • wgpu 29
  • codespan-reporting 0.11
  • serde + serde_json
  • clap 4

빌드

rtk cargo build
rtk cargo test
rtk cargo clippy

라이선스

MIT

About

best dsl for all

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages