개발 · 명령 참조

`qzx prepareRelease`

기능

버전 메타데이터 업데이트를 계획하고 매니페스트와 CHANGELOG.md를 원자적으로 수정할 수 있습니다. 빌드, 커밋, 태그 생성 또는 게시를 수행하지 않습니다.

명령 성숙도: Alpha

실제 사용과 피드백에 사용할 수 있지만 인터페이스와 동작은 아직 바뀔 수 있습니다. 현재 개발 체크아웃에 대한 평가입니다. 이후의 각 불변 릴리스 태그는 해당 버전에 포함된 정확한 평가를 보존합니다. PyPI 0.2.2.0.9에서 사용할 수 있습니다. 문서는 alpha 체크아웃 0.2.2.0.9에 해당합니다.

동작 및 내장 보호

실제 모드는 요청한 변경 사항을 적용합니다

미리보기 제공

필요할 때 네이티브 도구를 사용합니다

네트워크를 사용하지 않고 작동합니다

현재 권한을 사용하며 결과는 달라질 수 있습니다

미리보기가 기본 동작입니다. 적용하려면 실패 보호가 있는 프로젝트 백업, 명확한 단일 매니페스트, changelog 업데이트 시 검토된 노트, 그리고 기본적으로 깨끗한 Git 작업 트리가 필요합니다. 테스트, build, commit, tag, 게시 또는 배포를 절대 실행하지 않습니다.

QZX는 실제 변경 전에 복구 파일을 만듭니다. 이를 의도적으로 생략하기로 결정한 경우에만 --dangerously-bypass-approvals-and-sandbox/--yolo를 사용하세요.

이 안전 분류는 2026-08-25에 OpenAI GPT-5.6 Pro가 구현 다이제스트 sha256:50bb166bd5377dc55fb00399daa06e678700dee990c8e0069b2b75e14bd88a7f를 기준으로 검토했습니다.

정확한 구문

qzx prepareRelease [bump] [path] [dry_run] [new_version] [release_notes] [update_changelog] [require_clean_git] [manifest] --json

매개변수

밀거나 가로 스크롤 막대를 사용해 모든 열을 확인하세요.

이름	유형	필수	기본값	설명
bump	str	아니요	"patch"	버전 증가: patch, minor 또는 major
path	str	아니요	"."	준비할 프로젝트 디렉터리
dry_run	bool	아니요	true	메타데이터의 정확한 변경을 쓰지 않고 미리보기
new_version	str	아니요	선언되지 않음	명시적 대상 버전. 프리릴리스 및 3부분 SemVer를 사용하지 않는 프로젝트에 권장
release_notes	str	아니요	선언되지 않음	검토된 changelog 텍스트. update_changelog=true로 적용할 때 필수
update_changelog	bool	아니요	true	CHANGELOG.md 맨 앞에 검토된 항목 추가
require_clean_git	bool	아니요	true	변경 적용 전에 프로젝트 Git 작업 트리가 깨끗해야 함
manifest	str	아니요	선언되지 않음	자동 감지가 모호할 때 프로젝트 내부 호환 매니페스트의 명시적 경로

입력 예제

qzx prepareRelease

다음 patch 버전과 모든 준비 전제조건 미리보기

qzx prepareRelease --new-version 2.0.0rc1 --release-notes "Release candidate with reviewed fixes" --dry-run false

깨끗한 프로젝트를 백업하고 commit이나 tag 생성 없이 명시적 Python 프리릴리스를 원자적으로 준비

전체 구조화 페이로드를 받으려면 --json을 추가하세요: qzx prepareRelease [bump] [path] [dry_run] [new_version] [release_notes] [update_changelog] [require_clean_git] [manifest] --json

대표 출력 예제

이 예시 JSON은 현재 구현이 뒷받침하는 결과 계약에서 파생됩니다. 기록된 실행이라고 주장하지 않고 명령이 반환할 수 있는 내용을 보여 주며, 값은 입력, 장비, 권한 및 선택 도구에 따라 달라집니다.

예제 명령: qzx prepareRelease --json

{
    "success": true,
    "message": "Plans a release metadata update and can atomically update one manifest plus CHANGELOG.md; it never builds, commits, tags, or publishes. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "prepareRelease",
        "command_maturity": {
            "stage": "alpha",
            "label": "Alpha",
            "sequence": 2,
            "public_executable": true,
            "stability": "interface_may_change",
            "summary": "Available for real use and feedback while its interface and behavior can still evolve.",
            "promotion_review_required": false,
            "assessment_scope": "development_checkout"
        },
        "duration_ms": 0,
        "schema_version": 1
    },
    "changes_applied": true,
    "details": {
        "summary": "Additional structured context is included here."
    },
    "dry_run": true,
    "plan": "Example value",
    "status": "ok"
}

JSON 결과 계약 보기

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message",
        "meta"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "meta": {
            "type": "object",
            "required": [
                "command",
                "command_maturity",
                "duration_ms",
                "schema_version"
            ],
            "properties": {
                "command": {
                    "type": "string"
                },
                "command_maturity": {
                    "type": "object",
                    "required": [
                        "stage",
                        "label",
                        "sequence",
                        "public_executable",
                        "stability",
                        "summary",
                        "promotion_review_required",
                        "assessment_scope"
                    ],
                    "properties": {
                        "stage": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "sequence": {
                            "type": "integer"
                        },
                        "public_executable": {
                            "type": "boolean"
                        },
                        "stability": {
                            "type": "string"
                        },
                        "summary": {
                            "type": "string"
                        },
                        "promotion_review_required": {
                            "type": "boolean"
                        },
                        "assessment_scope": {
                            "type": "string"
                        },
                        "note": {
                            "type": "string"
                        },
                        "review": {
                            "type": "object",
                            "required": [
                                "reviewed_on",
                                "rationale",
                                "evidence"
                            ],
                            "properties": {
                                "reviewed_on": {
                                    "type": "string",
                                    "format": "date"
                                },
                                "rationale": {
                                    "type": "string"
                                },
                                "evidence": {
                                    "type": "array",
                                    "minItems": 1,
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "replacement": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": true
                },
                "duration_ms": {
                    "type": "number"
                },
                "schema_version": {
                    "type": "integer"
                }
            },
            "additionalProperties": true
        },
        "changes_applied": {
            "type": "boolean"
        },
        "details": [],
        "dry_run": {
            "type": "boolean"
        },
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "plan": [],
        "status": {
            "type": "string"
        }
    },
    "additionalProperties": true
}

오류 및 제한

공개 계약은 실패 시 success=false와 설명적인 message를 요구합니다. 이 카탈로그는 아직 명령별 오류 분류 체계를 선언하지 않으므로 결과를 확인하고 존재하지 않는 코드를 추정하지 마세요.

QZX는 alpha 단계입니다. 선택적 종속성, 권한 및 호스트 기능에 따라 결과가 달라질 수 있습니다.

근거 흐름: 통제된 특권 환경 필요.

근거 및 출처

구현: src/qzx/commands/development/prepare_release.py
테스트: tests/test_development_commands/test_prepare_release.py
문서 채널: 개발 문서 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
제공 여부: 0.2.2.0.9 또는 이전

계속 살펴보기

이 명령들도 개발 범주에 속합니다. 비교하여 작업에 가장 적합한 작업을 선택하세요.

모든 QZX 명령 살펴보기