project-auto-wizard 0.2.0 → 0.3.0

package/README.md

@@ -17,7 +17,7 @@ npx project-auto-wizard
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.1.34 (2026-08-10)
+## 최신 버전 : v0.2.1 (2026-08-10)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -67,11 +67,21 @@ flutter.APP_ARTIFACT_NAME:
 `spring`/`flutter`는 아래처럼 단일 CI 이상으로 깊게 구성되어 있습니다:
 
 - **flutter**: Android(Firebase/Playstore/Selfhosted/TestAPK 배포), iOS(TestFlight/Test-TestFlight), CI, Lab 트리거까지 8종
-- **spring**: 단일 서버 배포(SIMPLE-CICD, **기본 활성**) + 무중단 배포 2종(Nginx/Traefik, opt-in) + PR 프리뷰 + GitHub Packages publish(항상 설치) + Nexus publish(`--nexus` opt-in)
-  - 무중단 배포 워크플로우는 파일은 설치되지만 `push` 트리거가 기본적으로 비활성(`workflow_dispatch`만 활성)입니다. 기본 배포는 SIMPLE-CICD가 담당하며, 무중단 배포로 전환하려면 해당 워크플로우 YAML의 `push.branches` 주석을 해제하고 SIMPLE-CICD의 `push` 트리거는 주석 처리해야 합니다(각 YAML 상단 주석에 안내되어 있습니다).
+- **spring**: 서버 배포 1종(단일 서버 / 무중단 Nginx / 무중단 Traefik 중 택1) + PR 프리뷰 + 라이브러리 publish 2종(Nexus·GitHub Packages, `--nexus` opt-in)
+  - 서버 배포 워크플로우는 **서로 대체재**라 하나만 설치합니다. 대화형에서 고르면 그것만 깔리고 **`push` 트리거까지 켜진 채로** 설치됩니다. 비대화형은 `--deploy-style simple|nginx|traefik` (기본: `simple`).
+  - 고른 방식은 `version.yml`에 기록되므로 다시 실행해도 묻지 않습니다. 방식을 바꾸면 **이전 워크플로우를 마법사가 정리합니다** — 손대지 않은 파일은 삭제하고, 수정한 파일은 `.bak`으로 옮겨 내용을 보존합니다. 남겨두면 배포가 두 번 돕니다.
+  - PR 프리뷰는 배포 방식과 무관한 별개 축이라 선택과 관계없이 함께 설치됩니다.
 - **react/next**: CI와 CI+CD 분리 구성
 - **python**: CI / PR 프리뷰 / SimpleCICD
 
+### 설치 기록 (`.github/.wizard/logs/`)
+
+설치가 끝나면 그 실행에서 무엇을 어떤 값으로 설치했는지 `.github/.wizard/logs/<시각>-install.md`에 한 건 남깁니다. 감지된 타입과 그 근거 파일, 버전, 브랜치, 선택 워크플로우, **환경설정 질문별 답변(기본값 그대로인지 여부 포함)**, 설치된 파일, 값이 채워지지 않은 항목, 등록해야 하는 GitHub Secret이 담깁니다.
+
+상단은 기계가 읽는 YAML front matter, 아래는 사람이 읽는 마크다운입니다. 배포가 예상과 다르게 동작할 때 "설치할 때 뭘로 답했더라"를 여기서 확인할 수 있고, 레포에 커밋되므로 AI 에이전트나 다른 팀원도 참고할 수 있습니다. 로그 기록에 실패해도 설치 자체는 정상 완료됩니다.
+
+`.github/.wizard/`에는 업데이트 3-way 판정에 쓰는 `baseline.json`도 함께 들어 있어, 완전 삭제 시 워크플로우와 함께 제거됩니다.
+
 ### 완전 삭제(`--mode uninstall`)
 
 `npx project-auto-wizard --mode uninstall`은 마법사가 설치한 것을 제거합니다 — 워크플로우·스크립트는 물론, README.md의 `AUTO-VERSION-SECTION` 버전 섹션과 `.gitignore`에 자동 추가된 항목, `version.yml`까지 선택적으로 제거할 수 있습니다.
@@ -133,7 +143,8 @@ npx project-auto-wizard [옵션]
       --paths "t=p,..."    모노레포 타입별 경로
       --main-branch B      릴리스 브랜치 (기본: 감지된 default branch)
       --develop-branch B   개발 브랜치 (기본: develop)
-      --nexus              Nexus 라이브러리 publish 워크플로우 포함
+      --deploy-style S     서버 배포 방식: simple | nginx | traefik (기본: simple)
+      --nexus              라이브러리 publish 워크플로우 포함 (Nexus + GitHub Packages)
       --secret-backup      Secret 서버 백업 워크플로우 포함
       --semver-auto        커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함, --no-semver-auto로 끔)
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/payload/scripts/issue_helper.py

@@ -0,0 +1,334 @@
+#!/usr/bin/env python3
+"""
+issue_helper.py — normalizes a GitHub issue's title/URL into a branch name
+and commit message, posts/updates a comment on the issue with both, and
+optionally creates the branch (stdlib only).
+
+This script is copied into user repos (.github/scripts/) by
+project-auto-wizard and is triggered by the `issues: [opened, edited]`
+event via PROJECT-COMMON-ISSUE-HELPER.yaml.
+
+Python rewrite of Chuseok22/github-issue-helper (same author, a repo
+without a LICENSE file) — ported to remove the external Action dependency
+(project-auto-wizard#68) and drop the Chuseok22-branded comment output.
+
+Usage:
+    issue_helper.py run
+
+Reads GITHUB_EVENT_PATH (issues event JSON), GITHUB_TOKEN,
+GITHUB_REPOSITORY (all auto-provided by the Actions runner except
+GITHUB_TOKEN, which the workflow wires from secrets.GITHUB_TOKEN), and
+ISSUE_HELPER_* env vars set by the workflow (branch_prefix,
+max_branch_length, commit_template, create_branch, base_branch,
+comment_marker).
+
+Contract:
+    - Exit 0 on success, including the no-op case (event isn't a
+      relevant issues action).
+    - Exit 1 on a configuration/runtime failure (missing token, GitHub
+      API error, etc.) — mirrors the original Action's core.setFailed.
+    - Exit 2 on argument-parsing errors (argparse default).
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+import unicodedata
+import urllib.error
+import urllib.request
+from datetime import datetime, timedelta, timezone
+
+KST = timezone(timedelta(hours=9))
+COMMENT_MARKER_DEFAULT = "<!-- project-auto-wizard issue helper -->"
+API_BASE = "https://api.github.com"
+
+
+def log(message):
+    print(message, file=sys.stderr)
+
+
+# ===================================================================
+# 정규화 (순수 함수 — GitHub API 호출 없음)
+# ===================================================================
+
+def extract_issue_number(issue_url):
+    trimmed = issue_url.strip().rstrip("/")
+    parts = trimmed.split("/")
+    return parts[-1] if parts and parts[-1] else ""
+
+
+_TAG_RE = re.compile(r"\[.*?]")
+_VARIATION_SELECTOR = "️"
+_ZWJ = "‍"
+
+
+def _is_removable_char(ch):
+    # 원본(TS) 정규식 \p{So}|\p{C}|️|‍ 이식.
+    # Python re는 \p{...}를 지원하지 않으므로 unicodedata.category()로 대체:
+    # "So"(Symbol, other) 또는 "C"로 시작(Cc/Cf/Co/Cs/Cn)하면 제거 대상.
+    # 변형 선택자(U+FE0F, 카테고리 Mn)는 위 두 조건에 안 걸리므로 명시적으로 추가.
+    if ch in (_VARIATION_SELECTOR, _ZWJ):
+        return True
+    category = unicodedata.category(ch)
+    return category == "So" or category.startswith("C")
+
+
+def extract_issue_title(raw_title):
+    title = _TAG_RE.sub("", raw_title).strip()
+    title = "".join(ch for ch in title if not _is_removable_char(ch)).strip()
+    return title if title else raw_title.strip()
+
+
+def format_date_yyyymmdd(dt):
+    return dt.strftime("%Y%m%d")
+
+
+_NON_ALNUM_KO_RE = re.compile(r"[^a-zA-Z0-9가-힣]")
+_MULTI_UNDERSCORE_RE = re.compile(r"_+")
+
+
+def normalize_title(title):
+    normalized = _NON_ALNUM_KO_RE.sub("_", title)
+    normalized = _MULTI_UNDERSCORE_RE.sub("_", normalized)
+    return normalized.strip("_")
+
+
+def create_branch_name(issue_title, issue_number, date_yyyymmdd, branch_prefix, max_branch_length):
+    normalized_title = normalize_title(issue_title)
+    base = f"{date_yyyymmdd}_#{issue_number}_{normalized_title}"
+    limited_base = base[:max_branch_length] if max_branch_length > 0 else base
+    return f"{branch_prefix}{limited_base}"
+
+
+def render_commit_message(template, issue_title, issue_url, issue_number, branch_name, date_yyyymmdd):
+    result = template
+    result = result.replace("${issueTitle}", issue_title)
+    result = result.replace("${issueUrl}", issue_url)
+    result = result.replace("${issueNumber}", issue_number)
+    result = result.replace("${branchName}", branch_name)
+    result = result.replace("${date}", date_yyyymmdd)
+    return result.strip()
+
+
+def normalize_all(title, issue_url, issue_number, date_yyyymmdd, branch_prefix, max_branch_length, commit_template):
+    normalized_title = normalize_title(title)
+    branch_name = create_branch_name(title, issue_number, date_yyyymmdd, branch_prefix, max_branch_length)
+    commit_message = render_commit_message(
+        commit_template, normalized_title, issue_url, issue_number, branch_name, date_yyyymmdd,
+    )
+    return branch_name, commit_message
+
+
+# ===================================================================
+# GitHub REST API (urllib.request + GITHUB_TOKEN, 서드파티 의존 없음)
+# ===================================================================
+
+def _headers(token, has_body):
+    headers = {
+        "Authorization": f"Bearer {token}",
+        "Accept": "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28",
+        "User-Agent": "project-auto-wizard-issue-helper",
+    }
+    if has_body:
+        headers["Content-Type"] = "application/json"
+    return headers
+
+
+def _api_request(method, url, token, body=None):
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    req = urllib.request.Request(url, data=data, method=method, headers=_headers(token, data is not None))
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            raw = resp.read()
+            return resp.status, (json.loads(raw) if raw else None), resp.headers.get("Link")
+    except urllib.error.HTTPError as e:
+        raw = e.read()
+        try:
+            parsed = json.loads(raw) if raw else None
+        except json.JSONDecodeError:
+            parsed = None
+        return e.code, parsed, None
+
+
+def _find_next_link(link_header):
+    if not link_header:
+        return None
+    for part in link_header.split(","):
+        segment = part.strip()
+        if 'rel="next"' in segment and "<" in segment and ">" in segment:
+            return segment[segment.index("<") + 1:segment.index(">")]
+    return None
+
+
+def list_comments(owner, repo, issue_number, token):
+    comments = []
+    url = f"{API_BASE}/repos/{owner}/{repo}/issues/{issue_number}/comments?per_page=100"
+    while url:
+        status, page, link = _api_request("GET", url, token)
+        if status >= 400:
+            raise RuntimeError(f"이슈 코멘트 조회 실패({status}): {issue_number}")
+        comments.extend(page or [])
+        url = _find_next_link(link)
+    return comments
+
+
+def upsert_comment(owner, repo, issue_number, token, marker, body):
+    comments = list_comments(owner, repo, issue_number, token)
+    existing = next((c for c in comments if marker in (c.get("body") or "")), None)
+    if existing:
+        status, _, _ = _api_request(
+            "PATCH", f"{API_BASE}/repos/{owner}/{repo}/issues/comments/{existing['id']}", token, {"body": body},
+        )
+        if status >= 400:
+            raise RuntimeError(f"코멘트 갱신 실패({status})")
+        log("기존 코멘트를 갱신했습니다.")
+    else:
+        status, _, _ = _api_request(
+            "POST", f"{API_BASE}/repos/{owner}/{repo}/issues/{issue_number}/comments", token, {"body": body},
+        )
+        if status >= 400:
+            raise RuntimeError(f"코멘트 작성 실패({status})")
+        log("새 코멘트를 작성했습니다.")
+
+
+def create_branch_if_needed(owner, repo, branch_name, base_branch, create_branch, token):
+    if not create_branch:
+        return
+
+    base = base_branch
+    if not base:
+        status, repo_data, _ = _api_request("GET", f"{API_BASE}/repos/{owner}/{repo}", token)
+        if status >= 400:
+            raise RuntimeError(f"레포 정보 조회 실패({status})")
+        base = repo_data["default_branch"]
+
+    status, ref_data, _ = _api_request("GET", f"{API_BASE}/repos/{owner}/{repo}/git/ref/heads/{base}", token)
+    if status >= 400:
+        raise RuntimeError(f"base 브랜치 ref 조회 실패({base}, {status})")
+    sha = ref_data["object"]["sha"]
+
+    status, _, _ = _api_request(
+        "POST", f"{API_BASE}/repos/{owner}/{repo}/git/refs", token,
+        {"ref": f"refs/heads/{branch_name}", "sha": sha},
+    )
+    if status == 422:
+        log(f"브랜치가 이미 존재함, 건너뜀: {branch_name}")
+        return
+    if status >= 400:
+        raise RuntimeError(f"브랜치 생성 실패({branch_name}, {status})")
+    log(f"브랜치 생성됨: {branch_name}")
+
+
+# ===================================================================
+# 이벤트 처리 / CLI
+# ===================================================================
+
+def _bool_env(name, default):
+    val = os.environ.get(name)
+    if val is None or val.strip() == "":
+        return default
+    return val.strip().lower() == "true"
+
+
+def cmd_run():
+    event_path = os.environ.get("GITHUB_EVENT_PATH")
+    if not event_path:
+        log("ERROR: GITHUB_EVENT_PATH가 없습니다.")
+        return 1
+    try:
+        with open(event_path, "r", encoding="utf-8") as f:
+            payload = json.load(f)
+    except (OSError, json.JSONDecodeError) as e:
+        log(f"ERROR: 이벤트 페이로드를 읽을 수 없습니다: {e}")
+        return 1
+
+    action = payload.get("action")
+    issue = payload.get("issue") or {}
+    changes = payload.get("changes") or {}
+    is_opened = action == "opened"
+    is_edited_with_title = action == "edited" and "title" in changes
+
+    if not is_opened and not is_edited_with_title:
+        log("열림 또는 제목 변경 이벤트가 아님 → 종료")
+        return 0
+
+    repo_full = os.environ.get("GITHUB_REPOSITORY", "")
+    if "/" not in repo_full or repo_full.count("/") != 1 or not all(repo_full.split("/")):
+        log(f"ERROR: GITHUB_REPOSITORY 형식이 올바르지 않습니다: {repo_full!r}")
+        return 1
+    owner, repo = repo_full.split("/", 1)
+
+    token = os.environ.get("GITHUB_TOKEN", "").strip()
+    if not token:
+        log("ERROR: GITHUB_TOKEN이 없습니다.")
+        return 1
+
+    raw_title = issue.get("title", "")
+    issue_url = issue.get("html_url", "")
+    issue_number_str = extract_issue_number(issue_url) or str(issue.get("number", ""))
+
+    date_yyyymmdd = format_date_yyyymmdd(datetime.now(KST))
+
+    comment_marker = os.environ.get("ISSUE_HELPER_COMMENT_MARKER") or COMMENT_MARKER_DEFAULT
+    branch_prefix = os.environ.get("ISSUE_HELPER_BRANCH_PREFIX", "")
+    max_branch_length = int(os.environ.get("ISSUE_HELPER_MAX_BRANCH_LENGTH") or "120")
+    commit_template = (
+        os.environ.get("ISSUE_HELPER_COMMIT_TEMPLATE")
+        or "${issueTitle} : feat : {변경 사항에 대한 설명} ${issueUrl}"
+    )
+    create_branch = _bool_env("ISSUE_HELPER_CREATE_BRANCH", False)
+    base_branch = os.environ.get("ISSUE_HELPER_BASE_BRANCH", "").strip()
+
+    title = extract_issue_title(raw_title)
+    branch_name, commit_message = normalize_all(
+        title, issue_url, issue_number_str, date_yyyymmdd, branch_prefix, max_branch_length, commit_template,
+    )
+
+    body = (
+        f"{comment_marker}\n"
+        "## Issue Helper\n"
+        "### 브랜치명\n"
+        "```\n"
+        f"{branch_name}\n"
+        "```\n\n"
+        "### 커밋 메시지\n"
+        "```\n"
+        f"{commit_message}\n"
+        "```"
+    )
+
+    upsert_comment(owner, repo, issue["number"], token, comment_marker, body)
+
+    github_output = os.environ.get("GITHUB_OUTPUT")
+    if github_output:
+        with open(github_output, "a", encoding="utf-8") as f:
+            f.write(f"branchName={branch_name}\n")
+            f.write(f"commitMessage={commit_message}\n")
+
+    create_branch_if_needed(owner, repo, branch_name, base_branch, create_branch, token)
+    return 0
+
+
+def build_parser():
+    parser = argparse.ArgumentParser(prog="issue_helper.py")
+    parser.add_argument("command", choices=["run"])
+    return parser
+
+
+def main(argv=None):
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if args.command == "run":
+        try:
+            return cmd_run()
+        except Exception as e:
+            log(f"실행 실패: {e}")
+            return 1
+    return 2
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/payload/scripts/truncate_release_notes.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+"""
+truncate_release_notes.py — truncate a release notes file in place to fit a
+store-imposed length limit (stdlib only).
+
+This script is copied into user repos (.github/scripts/) by project-auto-wizard
+and is called by the Flutter deploy workflows right before store upload
+(Google Play, Firebase App Distribution, App Store Connect) — each of which
+enforces its own release-notes length limit.
+
+Usage:
+    truncate_release_notes.py <file> <limit> <char|byte>
+
+Behavior:
+    - Missing file: no-op, exit 0 (a missing notes file is not a reason to
+      block deployment).
+    - File within limit: left unchanged, exit 0.
+    - File over limit: truncated in place to `limit`, no marker text added.
+      char mode counts Unicode code points (Google Play); byte mode counts
+      UTF-8 bytes and never splits a multi-byte character (Firebase / App
+      Store Connect).
+    - Bytes in the input that are not valid UTF-8 are replaced, never fatal.
+
+Contract:
+    - Exit 0 on success (including the no-op cases above).
+    - Exit 1 if `limit` is not a positive integer (caller bug).
+    - Exit 2 on argument-parsing errors (argparse default — wrong arg count,
+      non-integer limit, unknown mode).
+"""
+
+import argparse
+import sys
+
+
+def log(message):
+    print(message, file=sys.stderr)
+
+
+def truncate_text(text, limit, mode):
+    if mode == "char":
+        return text[:limit]
+    return text.encode("utf-8")[:limit].decode("utf-8", errors="ignore")
+
+
+def run(path, limit, mode):
+    try:
+        with open(path, "r", encoding="utf-8", newline="", errors="replace") as f:
+            text = f.read()
+    except FileNotFoundError:
+        log(f"릴리즈 노트 파일 없음, 건너뜀: {path}")
+        return 0
+
+    length = len(text) if mode == "char" else len(text.encode("utf-8"))
+    if length <= limit:
+        log(f"한도 이내 ({length}/{limit} {mode}), 자르지 않음: {path}")
+        return 0
+
+    truncated = truncate_text(text, limit, mode)
+    with open(path, "w", encoding="utf-8", newline="") as f:
+        f.write(truncated)
+
+    log(f"한도 초과 ({length} -> {limit} {mode} 이하로 절단): {path}")
+    return 0
+
+
+def build_parser():
+    parser = argparse.ArgumentParser(prog="truncate_release_notes.py")
+    parser.add_argument("file")
+    parser.add_argument("limit", type=int)
+    parser.add_argument("mode", choices=["char", "byte"])
+    return parser
+
+
+def main(argv=None):
+    sys.stdout.reconfigure(errors="replace")
+    sys.stderr.reconfigure(errors="replace")
+
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if args.limit <= 0:
+        log(f"ERROR: limit은 양수여야 함: {args.limit}")
+        return 1
+
+    return run(args.file, args.limit, args.mode)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/payload/version.yml.template

@@ -46,4 +46,5 @@ metadata:
       nexus: {{OPT_NEXUS}}
       secret_backup: {{OPT_SECRET_BACKUP}}
       semver_auto: {{OPT_SEMVER_AUTO}}
+      deploy_style: "{{OPT_DEPLOY_STYLE}}" # simple | nginx | traefik (서버 배포 워크플로우)
 {{DEPLOY}}

package/payload/workflows/common/PROJECT-COMMON-ISSUE-HELPER.yaml

@@ -0,0 +1,47 @@
+# project-auto-wizard:managed-workflow
+# ===================================================================
+# PROJECT-COMMON-ISSUE-HELPER.yaml
+# 이슈 생성/제목 수정 시 브랜치명·커밋 메시지를 댓글로 안내
+# ===================================================================
+#
+# 이슈가 열리거나(opened) 제목이 수정되면(edited + 제목 변경),
+# 정규화된 브랜치명과 커밋 메시지를 이슈 댓글로 생성/갱신한다.
+# ISSUE_HELPER_CREATE_BRANCH=true로 바꾸면 브랜치도 함께 생성한다
+# (기본값은 false — 이슈를 열 때마다 브랜치가 자동 생성되는 것을
+# 막기 위해 옵트인으로 전환됨, project-auto-wizard#68).
+#
+# 로직 본체는 .github/scripts/issue_helper.py (Chuseok22/github-issue-helper의
+# Python 재작성, 동일 작성자 — project-auto-wizard#68).
+# ===================================================================
+
+name: PROJECT-ISSUE-HELPER
+
+on:
+  issues:
+    types: [opened, edited]
+
+# ISSUE_HELPER_CREATE_BRANCH를 "true"로 켜서 브랜치 자동 생성을 쓰려면
+# git/refs API 쓰기 권한이 필요하므로 contents를 write로 올려야 한다.
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  issue-helper:
+    name: 브랜치명 & 커밋 메시지 안내
+    if: github.event.action == 'opened' || (github.event.action == 'edited' && github.event.changes.title)
+    runs-on: ubuntu-latest
+    env:
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      ISSUE_HELPER_BRANCH_PREFIX: ""
+      ISSUE_HELPER_MAX_BRANCH_LENGTH: "100"
+      ISSUE_HELPER_COMMIT_TEMPLATE: "${issueTitle} : feat : {변경 사항에 대한 설명} ${issueUrl}"
+      ISSUE_HELPER_CREATE_BRANCH: "false"
+      ISSUE_HELPER_BASE_BRANCH: "{{MAIN_BRANCH}}"
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: 브랜치명 & 커밋 메시지 생성
+        id: issue-helper
+        run: python3 .github/scripts/issue_helper.py run

package/payload/workflows/common/secret-backup/PROJECT-COMMON-SECRET-FILE-UPLOAD.yaml

@@ -75,11 +75,11 @@ concurrency:
 # 환경 변수 설정
 # ===================================================================
 env:
-  # 🔧 프로젝트 설정 - 프로젝트에 맞게 수정하세요
-  PROJECT_NAME: "my-project"
+  # 🔧 프로젝트 설정 - 마법사가 설치 시 채웁니다
+  PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
   ROLE: "backend"
-  SERVER_BASE_PATH: "/volume1/projects"
-  SSH_PORT: "2022"
+  SERVER_BASE_PATH: "__SERVER_BASE_PATH__"  # @wizard ask:/volume1/projects
+  SSH_PORT: "__SSH_PORT__"  # @wizard ask:2022
 
 jobs:
   upload-secret-files:

package/payload/workflows/flutter/PROJECT-FLUTTER-ANDROID-FIREBASE-CICD.yaml

@@ -564,7 +564,7 @@ jobs:
         run: |
           if [ -f "final_release_notes.txt" ]; then
             # Firebase App Distribution release notes 길이 제한 안전망 (4000자)
-            bash ./.github/scripts/truncate_release_notes.sh final_release_notes.txt 4000 char
+            python3 ./.github/scripts/truncate_release_notes.py final_release_notes.txt 4000 char
           fi
 
       # Firebase App Distribution에 AAB 업로드

package/payload/workflows/flutter/PROJECT-FLUTTER-ANDROID-PLAYSTORE-CICD.yaml

@@ -665,7 +665,7 @@ jobs:
           if [ -f "$GITHUB_WORKSPACE/final_release_notes.txt" ]; then
             # Google Play release notes 한도(500 글자)에 맞춰 절단 (마진 두어 480자)
             # final_release_notes.txt·truncate 스크립트는 레포 루트 기준 — working-directory가 FLUTTER_PROJECT_DIR이므로 절대경로 사용
-            bash "$GITHUB_WORKSPACE/.github/scripts/truncate_release_notes.sh" "$GITHUB_WORKSPACE/final_release_notes.txt" 480 char
+            python3 "$GITHUB_WORKSPACE/.github/scripts/truncate_release_notes.py" "$GITHUB_WORKSPACE/final_release_notes.txt" 480 char
             cp "$GITHUB_WORKSPACE/final_release_notes.txt" "$CHANGELOG_DIR/${VERSION_CODE}.txt"
             echo "✅ Changelog 준비 완료 (버전 코드: $VERSION_CODE)"
           else

package/payload/workflows/flutter/PROJECT-FLUTTER-IOS-TESTFLIGHT.yaml

@@ -445,7 +445,7 @@ jobs:
           # Release notes 준비 (final_release_notes.txt·truncate 스크립트는 레포 루트 기준 — working-directory가 FLUTTER_PROJECT_DIR이므로 절대경로 사용)
           if [ -f "$GITHUB_WORKSPACE/final_release_notes.txt" ]; then
             # App Store Connect "What to Test" 한도(4000 바이트)에 맞춰 절단 (마진 두어 3800byte)
-            bash "$GITHUB_WORKSPACE/.github/scripts/truncate_release_notes.sh" "$GITHUB_WORKSPACE/final_release_notes.txt" 3800 byte
+            python3 "$GITHUB_WORKSPACE/.github/scripts/truncate_release_notes.py" "$GITHUB_WORKSPACE/final_release_notes.txt" 3800 byte
             RELEASE_NOTES=$(cat "$GITHUB_WORKSPACE/final_release_notes.txt")
             echo "📝 Release Notes:"
             echo "$RELEASE_NOTES"

package/payload/workflows/python/PROJECT-PYTHON-PR-PREVIEW.yaml

@@ -25,11 +25,11 @@
 #
 # 📊 리소스 네이밍:
 # - 컨테이너: {PROJECT_NAME}-pr-{번호}
-# - 도메인: {PROJECT_NAME}-pr-{번호}.pr.suhsaechan.kr
+# - 도메인: {PROJECT_NAME}-pr-{번호}.pr.example.com
 #
 # 📋 사전 요구사항:
 # - Traefik 컨테이너 실행 중 (traefik-network)
-# - 와일드카드 DNS 설정: *.pr.suhsaechan.kr → 서버
+# - 와일드카드 DNS 설정: *.pr.example.com → 서버
 # ===================================================================
 
 name: PROJECT-PYTHON-PR-PREVIEW
@@ -46,12 +46,12 @@ env:
   INTERNAL_PORT: '8000'
 
   # 🗂️ 볼륨 마운트 설정 (프로젝트별 수정 필요, 빈값이면 마운트 안함)
-  PROJECT_TARGET_DIR: "/volume1/projects/프로젝트명/ai"  # 서버의 데이터 디렉토리
-  PROJECT_MNT_DIR: "/mnt/프로젝트명"                     # 컨테이너 내부 마운트 경로
+  PROJECT_TARGET_DIR: "__PROJECT_TARGET_DIR__"  # @wizard ask:/volume1/projects/__PROJECT_NAME__
+  PROJECT_MNT_DIR: "__PROJECT_MNT_DIR__"  # @wizard ask:/mnt/__PROJECT_NAME__
 
   # Traefik & Preview 도메인 설정 (환경 구축 후 수정 금지)
   TRAEFIK_NETWORK: traefik-network
-  PREVIEW_DOMAIN_SUFFIX: pr.suhsaechan.kr
+  PREVIEW_DOMAIN_SUFFIX: "__PREVIEW_DOMAIN_SUFFIX__"  # @wizard ask:pr.example.com
   PREVIEW_PORT: '8079'
 
   # 🔐 SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
@@ -60,7 +60,7 @@ env:
   SSH_AUTH_METHOD: "password"  # @wizard ask:password
 
   # SSH 포트 (서버 포트 환경 구축 후 수정 금지)
-  SSH_PORT: '2022'
+  SSH_PORT: "__SSH_PORT__"  # @wizard ask:2022
 
   # Issue Helper 댓글 마커 (프로젝트별 수정 필요)
   # Issue 댓글에서 브랜치명을 추출할 때 사용

package/payload/workflows/python/PROJECT-PYTHON-SIMPLE-CICD.yaml

@@ -87,7 +87,7 @@ env:
   SSH_AUTH_METHOD: "password"  # @wizard ask:password
 
   # 🔌 SSH 연결 설정
-  SSH_PORT: "2022"  # SSH 포트 (Synology 기본: 2022)
+  SSH_PORT: "__SSH_PORT__"  # @wizard ask:2022
   SSH_COMMAND_TIMEOUT: "600s"  # SSH 명령 실행 타임아웃
   SSH_CONNECTION_TIMEOUT: "60s"  # SSH 연결 타임아웃
 

package/payload/workflows/spring/{PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH.yml → nexus/PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH.yml}

@@ -45,16 +45,22 @@ permissions:
   contents: read
   packages: write
 
+# ===================================================================
+# 환경 변수 설정
+# ===================================================================
+env:
+  JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:@jdk
+
 jobs:
   publish:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
 
-      - name: Set up JDK 17
+      - name: Set up JDK
         uses: actions/setup-java@v5
         with:
-          java-version: '17'
+          java-version: ${{ env.JAVA_VERSION }}
           distribution: 'temurin'
 
       - name: Setup Gradle