오류 코드

E_RANGE_UNSATISFIED

HTTP 409 · exit 4

모든 범위를 만족하는 버전이 없습니다: …

해결: 충돌하는 패키지의 호환 버전을 먼저 설치하거나 다른 버전으로 고정하세요.

E_ALREADY_INSTALLED

HTTP 409 · exit 4

… …은(는) 이미 설치되어 있습니다.

해결: 할 일이 없습니다. genpm list로 설치된 패키지를 확인하세요.

E_VERSION_EXISTS

HTTP 409 · exit 4

…@…은(는) 이미 게시되었습니다.

해결: 버전은 변경할 수 없습니다. genpm.json의 버전을 올리고 새 태그를 만드세요.

E_DRIFT

HTTP 409 · exit 4

…의 …에 로컬 변경 사항이 있습니다.

해결: 코드를 유지하려면 --keep-code를, 그래도 삭제하려면 --force를 사용하세요.

E_REQUIRED_BY

HTTP 409 · exit 4

…에서 …이(가) 필요합니다.

해결: 의존하는 패키지를 먼저 제거하세요.

E_BUSY

HTTP 409 · exit 4

다른 GenPM 프로세스가 이 프로젝트를 수정하고 있습니다.

해결: 끝날 때까지 기다리세요. 실행 중인 프로세스가 없다면 .genpm/.lock을 삭제하세요.

E_PLAN_STALE

HTTP 409 · exit 4

계획을 계산한 뒤 프로젝트가 변경되었습니다.

해결: 계획을 다시 계산(시험 실행)하고 확인하세요.

E_NETWORK

HTTP 502 · exit 5

…에 연결할 수 없습니다.

해결: 연결, 프록시 또는 GENPM_REGISTRY를 확인한 뒤 다시 시도하세요.

E_UPSTREAM_GIT

HTTP 502 · exit 5

Git 호스트에서 오류가 발생했습니다: …

해결: Git 자격 증명으로 저장소에 접근할 수 있는지 확인한 뒤 다시 시도하세요.

E_RATE_LIMITED

HTTP 429 · exit 5

요청이 너무 많습니다.

해결: … 기다린 뒤 다시 시도하세요.

E_READ_ONLY

HTTP 503 · exit 5

점검 중이라 레지스트리가 읽기 전용입니다.

해결: 설치는 계속 가능합니다. 게시는 나중에 다시 시도하세요. 상태는 genpm.net에서 안내합니다.

E_INTEGRITY

HTTP 422 · exit 6

…의 무결성 검사에 실패했습니다: …

해결: 이 패키지를 사용하지 마세요. 계속되면 genpm.net/report에서 신고하세요.

E_SIGNATURE

HTTP 422 · exit 6

…의 레지스트리 서명이 유효하지 않습니다.

해결: 설치하지 마세요. GenPM을 업데이트(새 서명 키)하고 계속되면 신고하세요.

E_PATH_UNSAFE

HTTP 422 · exit 6

안전하지 않은 경로 …(…).

해결: 프로젝트 내부의 상대 경로를 사용하세요. .., 절대 경로, 예약된 폴더는 사용할 수 없습니다.

E_AUTORUN_FILE

HTTP 422 · exit 6

…에 자동으로 실행되는 파일이 있습니다: ….

해결: 이 파일들은 설치되지 않습니다. 작성자에게 제거를 요청하거나, 인증된 게시자에 한해 --allow-autorun을 사용하세요.

E_SCAN_FAILED

HTTP 422 · exit 6

보안 검사에서 …이(가) 거부되었습니다: …

해결: genpm validate가 알려 준 문제를 수정하고 새 버전을 게시하세요.

E_INSECURE_PERMS

HTTP 400 · exit 6

…을(를) 다른 사용자가 읽을 수 있습니다.

해결: chmod 600 …을(를) 실행하세요.

E_QUARANTINED

HTTP 451 · exit 6

…은(는) 보안 검토 중입니다.

해결: 나중에 다시 시도하거나 다른 패키지를 선택하세요. 검토는 영업시간 기준 24시간 이내에 끝납니다.

E_REF_MUTABLE

HTTP 422 · exit 6

…은(는) 변경 불가능한 참조가 아닙니다.

해결: Git 태그나 40자 전체 커밋 SHA를 사용하세요. 브랜치는 사용할 수 없습니다.

E_ADVISORY

HTTP 409 · exit 6

… …에 심각도 …의 보안 권고가 있습니다.

해결: … 이상으로 업데이트하세요.

E_TOO_LARGE

HTTP 422 · exit 6

…이(가) 크기 제한을 초과합니다: …

해결: .genpmignore로 파일을 제외하거나, 정상적인 패키지라면 --max-size로 제한을 늘리세요.

E_MANIFEST_INVALID

HTTP 422 · exit 6

genpm.json이 올바르지 않습니다.

해결: 세부 정보에 나열된 필드를 수정하세요. 전체 보고서는 genpm validate로 확인하세요.

E_LOCK_INVALID

HTTP 422 · exit 6

genpm.lock이 올바르지 않거나 손상되었습니다.

해결: Git에서 복원하세요. genpm.lock을 직접 수정하지 마세요.

E_NAME_MISMATCH

HTTP 422 · exit 6

매니페스트 이름 …이(가) …와(과) 일치하지 않습니다.

해결: genpm.json에 선언된 이름으로 게시하세요.

E_REF_NOT_FOUND

HTTP 422 · exit 3

…에 …이(가) 없습니다.

해결: 태그를 만들고 푸시하세요: git tag … && git push --tags.

E_REF_NOT_PUSHED

HTTP 422 · exit 4

…이(가) 원격에 없거나 다른 커밋을 가리킵니다.

해결: git push origin …로 태그를 푸시하세요.

E_REPO_NOT_ALLOWED

HTTP 422 · exit 7

…은(는) 스코프 @…의 소유가 아닙니다.

해결: 스코프에 연결된 GitHub 소유자의 저장소에서 게시하세요.

E_REPO_CHANGED

HTTP 422 · exit 6

…의 저장소가 변경되었습니다(저장소 하이재킹 가능성).

해결: 패키지를 이전하려면 제목을 [SECURITY]로 하여 hello@genpm.net에 메일을 보내세요.

E_CONTEXT_MISSING

HTTP 422 · exit 6

AI 규칙 파일 …이(가) 없습니다.

해결: …을(를) 만들거나(genpm init이 템플릿을 생성함) genpm.json에서 x를 설정하세요.

E_CONTEXT_TOO_LARGE

HTTP 422 · exit 6

AI 규칙 파일 …이(가) 16 KB를 넘습니다.

해결: 줄이세요. 규칙은 목적, 구조, 통합, 규약, 금지 사항에 집중하세요.

E_AUTH

HTTP 401 · exit 7

로그인하지 않았거나 토큰이 유효하지 않거나 만료되었습니다.

해결: genpm login을 실행하세요(CI에서는 GENPM_TOKEN 설정).

E_FORBIDDEN_SCOPE

HTTP 403 · exit 7

@…에 게시할 수 없습니다.

해결: @…의 소유자에게 게시 권한을 요청하거나 자신의 스코프를 사용하세요.

E_GIT_MISSING

HTTP 500 · exit 8

Git이 설치되어 있지 않거나 2.25보다 오래되었습니다.

해결: Git 2.25 이상을 설치한 뒤 다시 시도하세요.

E_NODE_VERSION

HTTP 500 · exit 8

GenPM에는 Node.js 20.11 이상이 필요합니다(현재 …).

해결: Node.js를 업데이트하거나 Node.js가 필요 없는 독립 실행형 genpm 바이너리를 설치하세요: genpm.net/docs/install

E_UPGRADE_UNSUPPORTED

HTTP 400 · exit 8

이 GenPM은 …(으)로 설치되었습니다. genpm upgrade는 독립 실행형 바이너리만 업데이트합니다.

해결: …(으)로 업데이트하거나 genpm.net/docs/install에서 바이너리를 설치하세요.

E_UPGRADE_PERMISSION

HTTP 500 · exit 8

…을(를) 교체할 수 없습니다: 권한이 거부되었습니다.

해결: 해당 파일 소유자로 genpm upgrade를 실행하거나 genpm.net/docs/install의 스크립트로 다시 설치하세요.

E_UPGRADE_INTEGRITY

HTTP 422 · exit 6

다운로드한 …이(가) 게시된 SHA-256 체크섬과 일치하지 않습니다.

해결: 아무것도 변경되지 않았습니다. 나중에 다시 시도하고, 다시 발생하면 제목을 [SECURITY]로 하여 hello@genpm.net에 알려 주세요.

E_MCP_SERVE_UNAVAILABLE

HTTP 500 · exit 8

genpm mcp serve는 독립 실행형 genpm 바이너리에만 포함되어 있습니다.

해결: MCP 명령으로 npx -y @genpm/mcp를 사용하거나(genpm mcp setup이 대신 설정합니다) genpm.net/docs/install에서 바이너리를 설치하세요.

E_NOT_A_PROJECT

HTTP 400 · exit 8

…에서 프로젝트를 찾을 수 없습니다.

해결: 프로젝트(package.json 또는 .git이 있는 곳) 안에서 명령을 실행하거나 --cwd