@morit/cli

Morit Plugin의 공식 개발 CLI입니다. 프로젝트 scaffold, Cloud 연결·동기화, 계약 검증, Ed25519 서명 package build, immutable Deployment 배포를 같은 SDK로 처리합니다.

빠른 시작

Node.js 20.12 이상에서 실행합니다.

npx -y @morit/cli login
npx -y @morit/cli plugin setup . --id com.example.study --name "Study" --publisher example
npx -y @morit/cli plugin add .
npx -y @morit/cli plugin validate .
npx -y @morit/cli plugin preview . --output ./dist/preview.html
npx -y @morit/cli plugin build .
npx -y @morit/cli plugin deploy . --visibility private

plugin preview는 validate된 Runtime v2 화면을 script-free HTML로 렌더링하고 light/dark 토글을 제공합니다. Node SDK의 previewProjectDirectory, @morit/plugin-mcp의 morit_project_preview, 저장소 도구 python tools/morit_plugin.py preview <directory>도 같은 계약을 사용합니다.

전체 명령은 npx -y @morit/cli --help에서 확인하고 자동화에서는 --json을 사용합니다.

프로젝트와 인증

morit login은 브라우저 device flow를 사용합니다. Windows는 DPAPI, macOS는 Keychain, Linux는 Secret Service를 통해 credential을 보호합니다. CI는 파일에 저장하지 않고 MORIT_ACCESS_TOKEN을 전달할 수 있습니다.

Cloud 연결 정보는 프로젝트 root의 morit-plugin.json에 기록됩니다. 이 파일에는 Project UUID와 revision만 들어가며 credential이나 Secret 평문은 포함되지 않습니다. Project source와 .mplg도 Secret identifier만 선언하고 실제 값은 Morit Cloud Project Secrets에 저장합니다.

동기화는 revision 충돌을 검사합니다.

npx -y @morit/cli plugin sync .          # local → Cloud
npx -y @morit/cli plugin sync . --pull   # Cloud → local

--force pull은 로컬 변경을 교체하므로 변경 내용을 확인한 뒤 명시적으로 사용합니다.

SDK와 문서

Node SDK는 @morit/cli/sdk export에서 같은 contract, validator, preview, build 기능을 제공합니다. 배포 package의 assets/plugin_contract.json과 assets/docs/에는 빌드 시점의 공통 계약과 공식 개발 문서가 함께 들어갑니다. 문서는 assets/docs/README.md의 실제 개발 순서를 따라 읽습니다.

Plugin MCP 설정과 Local/Remote Tool 흐름은 bundled assets/docs/sdk-and-mcp.md, manifest와 UI 계약은 assets/docs/manifest.md, assets/docs/ui-runtime-v2.md를 참고하세요.

파일과 보안 경계

PNG/JPEG/WebP/GIF asset과 직접 children/*.mplg dependency는 JSON Cloud 경계를 건널 때만 검증된 binary envelope로 변환되며 pull, source ZIP, 최종 .mplg에서는 원본 바이트가 유지됩니다. 그 밖의 source는 UTF-8 text입니다.

build는 manifest와 source 구조를 검증하고 package에 검증용 public key와 signature를 포함합니다. publisher private key, OS credential, Secret 평문은 source, source ZIP, package, CLI JSON 응답에 포함하지 않습니다.