project-auto-wizard 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Twin-Fang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+# project-auto-wizard
+
+> **One command DevOps** — `npx` 한 줄로 어떤 프로젝트든 GitHub-native AI 릴리스 자동화를 설치하는 마법사
+
+```bash
+npx project-auto-wizard
+```
+
+<!-- TODO: 30초 데모 GIF (docs/assets/demo.gif) -->
+<!-- TODO: 3분 데모 YouTube 링크 -->
+
+[![npm](https://img.shields.io/npm/v/project-auto-wizard)](https://www.npmjs.com/package/project-auto-wizard)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
+
+<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
+## 최신 버전 : v0.1.4 (2026-07-09)
+
+[전체 버전 기록 보기](CHANGELOG.md)
+
+---
+
+## 왜 만들었나
+
+새 프로젝트를 시작할 때마다 반복되는 일: CI/CD 파이프라인, 버전 관리, 체인지로그, 릴리스 자동화 셋업에 **반나절**.
+project-auto-wizard는 이걸 **한 줄, 3분**으로 줄입니다.
+
+```bash
+npx project-auto-wizard          # 대화형 마법사
+npx project-auto-wizard --mode full --force --type spring,react   # CI에서 비대화형
+```
+
+## 무엇을 설치하나 — 3축
+
+| 축 | 내용 |
+|---|---|
+| ① **npx 마법사** | 마커 파일로 프로젝트 타입 자동 감지 — **9타입 + 멀티타입 + 모노레포 경로**까지. 질문은 최소한만 |
+| ② **GitHub-native AI Release Automation** | 릴리스 PR을 열면: 버전 확정 → **AI가 릴리스 노트 작성** → CHANGELOG 갱신 → automerge → tag + GitHub Release. **API 키 0개** (GitHub Models) |
+| ③ **타입별 CI/CD 워크플로우** | Spring(무중단 배포 포함)·Flutter(스토어 배포)·React·Next·Python 등 타입에 맞는 GitHub Actions 자동 배치 |
+
+### 지원 프로젝트 타입
+
+`spring` `flutter` `react` `next` `node` `python` `react-native` `react-native-expo` `basic`
+
+- **멀티타입**: `--type spring,react,python` — 한 레포에 여러 타입 공존
+- **모노레포**: `--paths "flutter=app,react=client"` — 타입별 서브폴더 지정 (마커 파일 자동 감지)
+
+## API 키 0개 AI — 요약 엔진 체인
+
+릴리스 노트는 4단 엔진 체인으로 생성됩니다. **어떤 단계가 실패해도 릴리스는 절대 막히지 않습니다.**
+
+```mermaid
+flowchart LR
+    A["CodeRabbit PR 요약<br/>(opt-in, 30s×10 폴링)"] -->|"미도착/미사용"| B["사용자 지정 AI<br/>(AI_API_KEY)"]
+    B -->|"키 없음/실패"| C["GitHub Models<br/>(GITHUB_TOKEN만, 무료)"]
+    C -->|"rate limit/실패"| D["규칙 기반 fallback<br/>(항상 성공)"]
+```
+
+- 기본값은 **GitHub Models** — Actions의 `GITHUB_TOKEN` + `permissions: models: read`만으로 동작. **비용 0, 설정 0.**
+- `AI_API_KEY`/`AI_API_BASE_URL`/`AI_MODEL` secret으로 OpenAI-호환 엔드포인트(Groq, Gemini 호환 모드, Ollama 등) 교체 가능.
+- 규칙 fallback 3단: 프로젝트 컨벤션 → Conventional Commits → 무형식 bullet. 커밋 컨벤션이 없어도 동작.
+
+## 릴리스 흐름
+
+```mermaid
+flowchart LR
+    subgraph pr-flow ["pr-flow (기본)"]
+        D1[develop push] --> PR[develop→main 릴리스 PR]
+        PR --> V["버전 확정 (patch+1)"]
+        V --> AI[AI 릴리스 노트]
+        AI --> CL[CHANGELOG.json/md 갱신]
+        CL --> AM[automerge]
+        AM --> TAG["tag vX.Y.Z + GitHub Release"]
+    end
+```
+
+- **pr-flow** (기본): `VERSION-CONTROL`(main 직접 push 안전망) + `AUTO-CHANGELOG-CONTROL`(릴리스 PR) + `RELEASE-PUBLISH`(tag+Release) 3종 설치
+- **trunk-based** (릴리스 브랜치 = 개발 브랜치): `RELEASE-PUBLISH` 하나가 main push마다 버전확정 → 체인지로그 → tag → Release를 순차 처리
+- 마법사가 브랜치를 묻고(`--main-branch`/`--develop-branch`) 없으면 **생성 + push**까지. 선택은 `version.yml`에 저장되어 업데이트 시 재질문 없음
+
+## 설치 옵션
+
+```
+npx project-auto-wizard [옵션]
+
+  -m, --mode MODE          full | version | workflows  (기본: 대화형)
+  -t, --type CSV           spring,react,... (미지정 시 자동 감지)
+      --project-version V  초기 버전 (미지정 시 자동 감지)
+      --paths "t=p,..."    모노레포 타입별 경로
+      --main-branch B      릴리스 브랜치 (기본: 감지된 default branch)
+      --develop-branch B   개발 브랜치 (기본: develop)
+      --nexus              Nexus 라이브러리 publish 워크플로우 포함
+      --secret-backup      Secret 서버 백업 워크플로우 포함
+      --coderabbit         CodeRabbit PR 요약을 릴리스 노트 1순위로
+      --force              전 질문 생략 (CI용)
+```
+
+## 설치 후 확인할 것
+
+| 항목 | 내용 |
+|---|---|
+| **`WORKFLOW_PAT` secret** (권장) | automerge 후 후속 워크플로우(tag/Release)가 이어지려면 PAT가 필요합니다 — `GITHUB_TOKEN`으로 머지하면 GitHub 정책상 후속 워크플로우가 트리거되지 않습니다. Settings → Secrets → Actions에 `WORKFLOW_PAT` (scopes: `repo`, `workflow`) 등록. 없으면 `GITHUB_TOKEN`으로 동작하되 Release 발행은 수동 재실행이 필요할 수 있습니다 |
+| **Workflow permissions** | Settings → Actions → Workflow permissions: **Read and write** |
+| **GitHub Models** | 기본 활성 — 별도 설정 불필요. 조직 정책으로 차단된 경우 자동으로 규칙 fallback |
+
+## 설계 원칙
+
+- **payload 단일 진실**: 마법사가 설치하는 모든 자산은 npm 패키지 동봉 `payload/` 하나에서 나옵니다. 템플릿 레포 clone 없음, 네트워크 접근 0, 설치 재현성 100%
+- **크로스플랫폼 무결점**: 마법사는 Node, 설치되는 스크립트는 전부 Python. bash/PowerShell 이중 유지·macOS bash 3.2 함정을 **설계로 제거**
+- **graceful degradation**: AI 실패 → 다음 엔진 → 규칙 fallback. 릴리스가 도구 때문에 막히는 일은 없습니다
+- **표준 존중**: GitHub 기본 라벨·Releases·Conventional Commits — 커스텀 발명 대신 생태계 표준 위에 구축
+- **멱등성**: 같은 명령을 다시 실행해도 안전 — unchanged 파일은 건너뛰고, 충돌은 3지선(유지/백업 후 교체/참고본 추가)으로 처리
+
+## 아키텍처
+
+```mermaid
+flowchart TB
+    CLI["npx project-auto-wizard<br/>(Node CLI — 감지·질문·치환)"] --> P["payload/ (단일 진실)"]
+    P --> W[".github/workflows/*<br/>(브랜치 placeholder 치환 설치)"]
+    P --> S[".github/scripts/*.py<br/>(version_manager · changelog_manager)"]
+    P --> V["version.yml<br/>(버전·타입·경로·브랜치·옵션 기록)"]
+    W --> R["릴리스 자동화<br/>(AI 요약 엔진 체인)"]
+    S --> R
+    V --> R
+```
+
+## 개발
+
+```bash
+npm test          # node --test + python unittest (py 51 + node 59)
+npm run test:node
+npm run test:py
+```
+
+이 레포 자체가 project-auto-wizard로 관리됩니다 (도그푸딩) — `.github/workflows/PROJECT-COMMON-*`는 마법사가 설치한 산출물입니다.
+
+## License
+
+[MIT](LICENSE)

package/bin/project-auto-wizard.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+// project-auto-wizard CLI 엔트리 — argv를 src/index.js의 run()에 넘긴다.
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { dirname, join } from "node:path";
+
+const [nodeMajor, nodeMinor] = process.versions.node.split(".").map(Number);
+if (nodeMajor < 20 || (nodeMajor === 20 && nodeMinor < 12)) {
+  console.error(`Node.js 20.12 이상이 필요합니다 (현재: ${process.versions.node})`);
+  process.exit(1);
+}
+
+const here = dirname(fileURLToPath(import.meta.url));
+const indexPath = join(here, "..", "src", "index.js");
+const { run } = await import(pathToFileURL(indexPath).href);
+
+const code = await run(process.argv.slice(2), { cwd: process.cwd() });
+// process.exit() 금지 — fetch(undici) keep-alive 소켓·타이머와 경합해
+// Windows libuv assertion(src/win/async.c)으로 비정상 종료(127)한다. 실측 확인.
+process.exitCode = code;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "project-auto-wizard",
+  "version": "0.1.5",
+  "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "project-auto-wizard": "bin/project-auto-wizard.js"
+  },
+  "engines": {
+    "node": ">=20.12"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "payload/"
+  ],
+  "scripts": {
+    "test": "npm run test:node && npm run test:py",
+    "test:node": "node --test \"tests/node/**/*.test.js\"",
+    "test:py": "python -m unittest discover -s tests/py -v"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Twin-Fang/project-auto-wizard.git"
+  },
+  "keywords": [
+    "devops",
+    "automation",
+    "github-actions",
+    "cli",
+    "release-automation",
+    "changelog",
+    "wizard"
+  ]
+}

package/payload/coderabbit.yaml

@@ -0,0 +1,19 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+language: "ko-KR"
+early_access: false
+reviews:
+  profile: "chill"
+  request_changes_workflow: false
+  high_level_summary: true
+  poem: false
+  review_status: true
+  collapse_walkthrough: false
+  auto_review:
+    enabled: true
+    drafts: false
+    base_branches: ["main"]
+chat:
+  auto_reply: true
+issue_enrichment:
+  auto_enrich:
+    enabled: false

package/payload/config/breaking-changes.json

@@ -0,0 +1 @@
+{}

package/payload/config/wizard-prompts.yml

@@ -0,0 +1,62 @@
+# @wizard ask 마커의 사용자 질문 문구.
+# 형식 1 (구형, 지원 유지): KEY: "라벨"
+# 형식 2 (신규 블록): KEY 아래 label/help/example 들여쓰기 2칸
+# 형식 3 (타입 오버라이드): "{type}.KEY" 키로 타입별 문구 분리
+# 조회 우선순위: {type}.KEY -> KEY -> 구형 -> 폴백(KEY명)
+# 기본값/resolver는 여기 두지 않는다(@wizard 마커 소관).
+
+PROJECT_NAME:
+  label: "서비스 식별자 (영문 슬러그)"
+  help: "Docker 컨테이너명·이미지명·배포 도메인 prefix에 그대로 사용됩니다. 소문자-하이픈 권장."
+  example: "my-service"
+
+flutter.APP_ARTIFACT_NAME:
+  label: "앱 산출물 이름 (영문)"
+  help: "빌드된 APK 파일명·아티팩트명·빌드 히스토리 파일명에 사용됩니다."
+  example: "my-app"
+
+SERVICE_DOMAIN:
+  label: "서비스 도메인"
+  help: "배포 후 외부에서 접속할 운영 도메인입니다. 실제 보유한 도메인으로 바꿔야 합니다."
+  example: "api.example.com"
+
+JAVA_VERSION:
+  label: "빌드 JDK 버전"
+  help: "GitHub Actions 빌드 러너의 JDK 버전입니다. Spring은 보통 21, Flutter Android는 17."
+  example: "21"
+
+DEPLOY_PORT:
+  label: "외부 노출 포트"
+  help: "호스트(서버)에서 컨테이너로 연결할 포트입니다. 다른 서비스와 겹치지 않게 정하세요."
+  example: "8080"
+
+VOLUME_HOST_PATH:
+  label: "호스트(NAS) 볼륨 경로"
+  help: "서버에 데이터를 영구 저장할 실제 디렉토리 경로입니다."
+  example: "/volume1/projects/my-service"
+
+VOLUME_CONTAINER_PATH:
+  label: "컨테이너 내부 마운트 경로"
+  help: "컨테이너 안에서 위 볼륨이 보일 위치입니다."
+  example: "/mnt/my-service"
+
+SSH_AUTH_METHOD:
+  label: "SSH 인증 방식"
+  help: "배포 서버 접속 방식입니다. 둘 중 하나를 그대로 입력하세요."
+  example: "password 또는 key"
+
+# workflow filename (partial match) -> human readable short name
+# wizard uses this to build "[usage]" in env questions.
+_workflow_names:
+  NONSTOP-NGINX: "무중단배포(Nginx)"
+  NONSTOP-TRAEFIK: "무중단배포(Traefik)"
+  PR-PREVIEW: "PR 프리뷰"
+  SIMPLE-CICD: "단일 서버 배포"
+  REACT-CICD: "프론트 배포"
+  REACT-CI: "프론트 빌드"
+  NEXT-CICD: "프론트 배포"
+  NEXT-CI: "프론트 빌드"
+  PYTHON-CI: "빌드 검증"
+  FLUTTER-ANDROID-SELFHOSTED: "안드로이드 자체배포"
+  FLUTTER-ANDROID-PLAYSTORE: "플레이스토어 배포"
+  FLUTTER-ANDROID-FIREBASE: "Firebase 배포"