project-auto-wizard 0.16.2 → 0.17.0

package/LICENSE

@@ -1,5 +1,6 @@
 MIT License
 
+Copyright (c) 2025 Cassiiopeia
 Copyright (c) 2026 Twin-Fang
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/README.ja.md

@@ -49,7 +49,7 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 生成されたファイルをコミットして push してください。`npx project-auto-wizard --mode doctor` は、ワークフローが依存するリポジトリ設定を確認します。
 
-メッセージの言語は英語または韓国語（`en` | `ko`）です。`--lang`、環境変数 `PROJECT_AUTO_WIZARD_LANG`、`version.yml` の `language` の順に優先されます。環境変数はその実行にのみ適用され、有効な保存済み `language` は上書きしません（有効な値がない場合のみ保存）。上書きするには `--lang` を使います。
+メッセージの言語は英語または韓国語（`en` | `ko`）です。使う言語が決まっていない場合、対話型ウィザードは最初に言語を尋ねます。`--lang` でも指定できます。`--lang`、環境変数 `PROJECT_AUTO_WIZARD_LANG`、`version.yml` の `language` の順に優先されます。環境変数はその実行にのみ適用され、有効な保存済み `language` は上書きしません（有効な値がない場合のみ保存）。上書きするには `--lang` を使います。
 
 ## インストールされるもの
 
@@ -162,6 +162,10 @@ Flutter のストアデプロイ（Play Store、Firebase、TestFlight）の設
 
 issue と pull request を歓迎します。`develop` からブランチを作り、`develop` に対して PR を開いてください。セットアップとテスト（`npm test`）は [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。このリポジトリは、自身がインストールするワークフローで自分自身をリリースしています。
 
+## 由来と謝辞
+
+このプロジェクトは [Cassiiopeia/projectops](https://github.com/Cassiiopeia/projectops)（MIT、Copyright (c) 2025 Cassiiopeia）の GitHub Actions 自動化テンプレートから発展しました。ワークフローの構成や名前の一部（例: `PROJECT-COMMON-*` ワークフロー）はその成果を引き継いでおり、project-auto-wizard はそれを `npx` インストーラーとして再構成し拡張したものです。原作の著作権表示は [LICENSE](LICENSE) に残しています。
+
 ## ライセンス
 
 [MIT](LICENSE)

package/README.ko.md

@@ -49,7 +49,7 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 생성된 파일을 커밋하고 push하세요. `npx project-auto-wizard --mode doctor`는 워크플로우가 의존하는 레포 설정을 점검합니다.
 
-메시지 언어는 영어 또는 한국어(`en` | `ko`)입니다. `--lang`, 환경변수 `PROJECT_AUTO_WIZARD_LANG`, `version.yml`의 `language` 순서로 우선 적용됩니다. 환경변수는 그 실행에만 적용되며 저장된 유효한 `language`를 덮어쓰지 않습니다(유효한 값이 없을 때만 저장). 덮어쓰려면 `--lang`을 쓰세요.
+메시지 언어는 영어 또는 한국어(`en` | `ko`)입니다. 어떤 언어를 쓸지 정해진 것이 없으면 대화형 마법사가 가장 먼저 언어를 묻고, `--lang`으로도 지정할 수 있습니다. `--lang`, 환경변수 `PROJECT_AUTO_WIZARD_LANG`, `version.yml`의 `language` 순서로 우선 적용됩니다. 환경변수는 그 실행에만 적용되며 저장된 유효한 `language`를 덮어쓰지 않습니다(유효한 값이 없을 때만 저장). 덮어쓰려면 `--lang`을 쓰세요.
 
 ## 설치되는 것
 
@@ -162,6 +162,10 @@ Flutter 스토어 배포(Play Store, Firebase, TestFlight) 설정은 [문서 사
 
 이슈와 풀 리퀘스트를 환영합니다. `develop`에서 브랜치를 만들고 `develop`을 대상으로 PR을 여세요. 설정과 테스트(`npm test`)는 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요. 이 레포는 마법사가 설치하는 워크플로우로 스스로 릴리스됩니다.
 
+## 출처와 감사
+
+이 프로젝트는 [Cassiiopeia/projectops](https://github.com/Cassiiopeia/projectops)(MIT, Copyright (c) 2025 Cassiiopeia)의 GitHub Actions 자동화 템플릿에서 출발했습니다. 워크플로우 구조와 이름 일부(예: `PROJECT-COMMON-*` 워크플로우)는 해당 작업에서 이어졌고, project-auto-wizard는 이를 `npx` 설치기로 다시 구성하고 확장했습니다. 원작의 저작권 고지는 [LICENSE](LICENSE)에 유지합니다.
+
 ## 라이선스
 
 [MIT](LICENSE)

package/README.md

@@ -21,7 +21,7 @@ Everything it installs is plain GitHub Actions in your own repository. No API ke
 </div>
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest Version : v0.16.2 (2026-10-01)
+## Latest Version : v0.17.0 (2026-10-01)
 
 [Full release history](CHANGELOG.md)
 
@@ -50,7 +50,7 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 Commit the generated files and push. `npx project-auto-wizard --mode doctor` checks the repository settings the workflows depend on.
 
-Messages are in English or Korean (`en` | `ko`). Pick one with `--lang`, the `PROJECT_AUTO_WIZARD_LANG` environment variable, or `language` in `version.yml`, in that order of precedence. The environment variable applies to that run only and does not overwrite a valid saved `language` (it is saved only when there is none); `--lang` does.
+Messages are in English or Korean (`en` | `ko`). The interactive wizard asks for the language first when nothing says which one to use; you can also pick one with `--lang`, the `PROJECT_AUTO_WIZARD_LANG` environment variable, or `language` in `version.yml`, in that order of precedence. The environment variable applies to that run only and does not overwrite a valid saved `language` (it is saved only when there is none); `--lang` does.
 
 ## What you get
 
@@ -167,6 +167,10 @@ Issues and pull requests are welcome. Branch from `develop` and open PRs against
 - [ADDING-A-PROJECT-TYPE.md](ADDING-A-PROJECT-TYPE.md) — step-by-step guide to adding a project type
 - [CONTRIBUTING.md](CONTRIBUTING.md) — dev setup and pull request rules
 
+## Origin & Acknowledgements
+
+This project grew out of the GitHub Actions automation templates of [Cassiiopeia/projectops](https://github.com/Cassiiopeia/projectops) (MIT, Copyright (c) 2025 Cassiiopeia). Some of the workflow structure and naming (for example the `PROJECT-COMMON-*` workflows) carries over from that work; project-auto-wizard repackages and extends it as an `npx` installer. The original copyright notice is kept in [LICENSE](LICENSE).
+
 ## License
 
 [MIT](LICENSE)

package/README.zh-CN.md

@@ -49,7 +49,7 @@ npx project-auto-wizard --mode full --force --type node --dry-run   # preview on
 
 提交生成的文件并 push。`npx project-auto-wizard --mode doctor` 会检查工作流所依赖的仓库设置。
 
-消息语言为英语或韩语（`en` | `ko`）。可通过 `--lang`、环境变量 `PROJECT_AUTO_WIZARD_LANG` 或 `version.yml` 中的 `language` 指定，优先级依次降低。环境变量仅对该次运行生效，不会覆盖已保存的有效 `language`（仅在没有有效值时才保存）；如需覆盖请使用 `--lang`。
+消息语言为英语或韩语（`en` | `ko`）。如果没有任何信息指明语言，交互式向导会首先询问语言，也可以通过 `--lang`、环境变量 `PROJECT_AUTO_WIZARD_LANG` 或 `version.yml` 中的 `language` 指定，优先级依次降低。环境变量仅对该次运行生效，不会覆盖已保存的有效 `language`（仅在没有有效值时才保存）；如需覆盖请使用 `--lang`。
 
 ## 安装内容
 
@@ -162,6 +162,10 @@ Flutter 商店部署（Play Store、Firebase、TestFlight）的设置见[文档
 
 欢迎提交 issue 和 pull request。请从 `develop` 创建分支，并向 `develop` 发起 PR；环境搭建和测试（`npm test`）见 [CONTRIBUTING.md](CONTRIBUTING.md)。本仓库使用它自己安装的工作流来发布自身。
 
+## 来源与致谢
+
+本项目源自 [Cassiiopeia/projectops](https://github.com/Cassiiopeia/projectops)（MIT，Copyright (c) 2025 Cassiiopeia）的 GitHub Actions 自动化模板。工作流的部分结构和命名（例如 `PROJECT-COMMON-*` 工作流）沿用自该项目；project-auto-wizard 将其重新整理并扩展为 `npx` 安装器。原作的版权声明保留在 [LICENSE](LICENSE) 中。
+
 ## 许可证
 
 [MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "description": "One command DevOps: npx wizard that installs GitHub-native Release Automation (optional GitHub Copilot AI summaries) into any project",
   "license": "MIT",
   "type": "module",

package/payload/version.yml.template

@@ -44,11 +44,11 @@ metadata:
   last_updated: "{{NOW}}"
   last_updated_by: "{{LAST_UPDATED_BY}}"
   default_branch: "{{DEFAULT_BRANCH}}"
-  integration_date: "{{TODAY}}"
+  integration_date: "{{INTEGRATION_DATE}}"
   template:
     source: "project-auto-wizard"
     version: "{{TEMPLATE_VERSION}}"
-    integrated_date: "{{TODAY}}"
+    integrated_date: "{{INTEGRATED_DATE}}"
     last_update_date: "{{TODAY}}"
     branches:
       main: "{{MAIN_BRANCH}}"

package/payload/workflows/spring/PROJECT-SPRING-CI.yml

@@ -371,7 +371,8 @@ jobs:
             owner: context.repo.owner,
             repo: context.repo.repo,
             name: 'Build Verification',
-            head_sha: context.sha,
+            // On a PR, context.sha is the temporary merge commit; attach the check run to the PR head commit
+            head_sha: context.payload.pull_request?.head?.sha ?? context.sha,
             status: 'completed',
             conclusion: conclusion,
             output: {

package/src/commands/dry-run.js

@@ -29,6 +29,7 @@ function versionYmlPreview(context, payloadRoot, targetRoot) {
   // Use the same render function as the real install; assembling separately drifts the preview whenever an option is added.
   const wouldBe = renderVersionYml(context, readVersionYmlTemplate(payloadRoot), {
     pathMarkers, extraTopLevel, lastUpdatedBy: prevParsed?.lastUpdatedBy || "",
+    integrationDate: prevParsed?.integrationDate || "", integratedDate: prevParsed?.integratedDate || "",
   });
   // Compare by the same rule as the real install: if only the timestamp lines differ, the install does not rewrite the file either.
   return { existed: existingRaw !== null, changed: existingRaw === null || !sameIgnoringTimestamps(existingRaw, wouldBe) };

package/src/commands/full.js

@@ -78,7 +78,7 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
 
   // 2. Generate version.yml (render payload/version.yml.template; full regeneration)
   //    A re-run where only the date lines differ does not rewrite it (idempotent).
-  const vyText = renderVersionYml(context, readVersionYmlTemplate(payloadRoot), { pathMarkers, deployValues, extraTopLevel, lastUpdatedBy: prevParsed?.lastUpdatedBy || "" });
+  const vyText = renderVersionYml(context, readVersionYmlTemplate(payloadRoot), { pathMarkers, deployValues, extraTopLevel, lastUpdatedBy: prevParsed?.lastUpdatedBy || "", integrationDate: prevParsed?.integrationDate || "", integratedDate: prevParsed?.integratedDate || "" });
   if (prevVy == null || !sameIgnoringTimestamps(prevVy, vyText)) {
     writeText(vyPath, vyText);
     log.info("version", "write", `version.yml (v${version}, code=${versionCode})`);

package/src/commands/interactive.js

@@ -29,7 +29,7 @@ import * as prompts from "../ui/prompts.js";
 import { runStatus, printStatus } from "./status.js";
 import { runDoctor, printDoctorReport } from "./doctor.js";
 import { currentLogPath, hasLegacyMdLogs } from "../core/logger.js";
-import { t, getLanguage } from "../i18n/index.js";
+import { t, getLanguage, setLanguage, isSupportedLanguage, DEFAULT_LANGUAGE } from "../i18n/index.js";
 
 const CANCEL = prompts.CANCEL;
 
@@ -40,6 +40,15 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const payload = assertPayload(payloadRoot ?? resolvePayloadRoot());
   const templateVersion = readTemplateVersion();
 
+  // No language is known yet (no --lang, env var or saved value): ask before anything is printed so the banner
+  // already uses the pick. ESC or an unusable answer keeps the default. Stubs without the prompt skip it.
+  let language = baseCtx.language ?? null;
+  if (baseCtx.askLanguage && io.selectLanguage) {
+    const picked = await io.selectLanguage();
+    language = isSupportedLanguage(picked) ? picked : DEFAULT_LANGUAGE;
+    setLanguage(language);
+  }
+
   // Start banner. Stubs have no banner -> fall back to intro.
   if (io.banner) io.banner({ version: templateVersion, modeLabel: t("interactive.banner.modeLabel") });
   else io.intro?.(t("interactive.intro"));
@@ -324,7 +333,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     releaseOptions: Object.fromEntries(OPTIONS.map((o) => [o.ctxField, optionState[o.name]])),
     mode, force: true, version, versionCode, branch, branches, paths,
     repoName, resolvers, envValues, envUseDefaults, now, today,
-    language: baseCtx.language ?? existing?.language ?? getLanguage(),
+    language: language ?? existing?.language ?? getLanguage(),
     // Extra context used by the install log and completion summary - does not change the install behaviour itself.
     markers, envAnswers, detectWarnings,
   });

package/src/core/version-yml.js

@@ -145,6 +145,10 @@ export function parseExisting(content) {
   // (quoted values are unescaped; an unquoted one ends at whitespace or a comment)
   const byMatch = /^[ \t]+last_updated_by:[ \t]*(?:"((?:[^"\\]|\\.)*)"|([^\s#"']+))/m.exec(text);
   const lastUpdatedBy = byMatch ? (byMatch[1] !== undefined ? byMatch[1].replace(/\\(.)/g, "$1") : byMatch[2]) : null;
+  // The original install dates: a re-install keeps them instead of overwriting them with the re-install date
+  const dateLine = (key) => line(new RegExp(`^\\s+${key}:\\s*["']?(\\d{4}-\\d{2}-\\d{2})["']?\\s*(?:#.*)?$`));
+  const integrationDate = dateLine("integration_date");
+  const integratedDate = dateLine("integrated_date");
   // project_paths block: `  type: "path"`
   const paths = new Map();
   // Entries folded into another entry of the same canonical type with a different folder (react: client + next: web).
@@ -196,7 +200,7 @@ export function parseExisting(content) {
   // metadata.template.branches - main/develop/mode (to skip re-asking in update mode)
   const branches = parseTemplateBranches(text);
   return {
-    version, versionCode, types, language, languageUnsupported, lastUpdatedBy, paths, droppedPaths, templateVersion, options, invalidOptions, branches,
+    version, versionCode, types, language, languageUnsupported, lastUpdatedBy, integrationDate, integratedDate, paths, droppedPaths, templateVersion, options, invalidOptions, branches,
     deploy: parseDeployBlock(text), extraTopLevel: parseExtraTopLevel(text),
   };
 }
@@ -268,7 +272,7 @@ export function buildVersionYml({
   templateText, version, types = [], paths = new Map(), pathMarkers = new Map(),
   branch = "main", branches = null, versionCode = 1, now, today,
   templateOptions = null, deployValues = new Map(), extraTopLevel = [], typeOptions = {}, language = DEFAULT_LANGUAGE,
-  lastUpdatedBy = "",
+  lastUpdatedBy = "", integrationDate = "", integratedDate = "",
 }) {
   if (!templateText) throw new Error(tr("core.versionYml.error.templateRequired"));
   const typesJson = types.length ? `[${types.map((t) => `"${t}"`).join(", ")}]` : `["basic"]`;
@@ -313,6 +317,8 @@ export function buildVersionYml({
     PROJECT_TYPES: typesJson,
     LANGUAGE: isSupportedLanguage(language) ? language : DEFAULT_LANGUAGE,
     NOW: now, TODAY: today || optionsDate, DEFAULT_BRANCH: branch,
+    // The original install dates win; today is written only when the key is absent (fresh install)
+    INTEGRATION_DATE: integrationDate || today || optionsDate, INTEGRATED_DATE: integratedDate || today || optionsDate,
     // A previously recorded value (e.g. the user who last bumped the version) wins over the installer's own name
     LAST_UPDATED_BY: escapeYamlDoubleQuoted(lastUpdatedBy || "project-auto-wizard"),
     TEMPLATE_VERSION: templateVersion,
@@ -353,13 +359,13 @@ export function sameIgnoringTimestamps(a, b) {
 // Builds the final version.yml from a single context - the real install (full) and the preview (dry-run)
 // use the same function, structurally preventing "the preview differs from the result".
 // deployValues exist only in a real install (the preview performs no substitution, so it is an empty Map).
-export function renderVersionYml(context, templateText, { pathMarkers, deployValues = new Map(), extraTopLevel = [], lastUpdatedBy = "" }) {
+export function renderVersionYml(context, templateText, { pathMarkers, deployValues = new Map(), extraTopLevel = [], lastUpdatedBy = "", integrationDate = "", integratedDate = "" }) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown", branches = null, language,
     deployStyle } = context;
   return buildVersionYml({
     templateText, version, types, paths, pathMarkers, branch, branches, versionCode, now, today,
-    deployValues, extraTopLevel, language, lastUpdatedBy,
+    deployValues, extraTopLevel, language, lastUpdatedBy, integrationDate, integratedDate,
     typeOptions: mergeHookResults(types, "optionsFromContext", context),
     templateOptions: {
       templateVersion,

package/src/i18n/catalog/en/ui.js

@@ -116,6 +116,8 @@ export default {
   "ui.readline-engine.yes": "Yes",
   "ui.readline-engine.no": "No",
   "ui.readline-engine.cancelled": "Cancelled.",
+  "ui.prompts.language.message": "Select language",
+  "ui.prompts.language.label": "English",
   "ui.prompts.mode.messageAgain": "What would you like to do next?",
   "ui.prompts.mode.message": "What would you like to install?",
   "ui.prompts.mode.full": "Install / update — version management + automation workflows (recommended for first time)",

package/src/i18n/catalog/ko/ui.js

@@ -116,6 +116,8 @@ export default {
   "ui.readline-engine.yes": "예",
   "ui.readline-engine.no": "아니오",
   "ui.readline-engine.cancelled": "취소했습니다.",
+  "ui.prompts.language.message": "언어 선택",
+  "ui.prompts.language.label": "한국어",
   "ui.prompts.mode.messageAgain": "다음으로 무엇을 할까요?",
   "ui.prompts.mode.message": "무엇을 설치할까요?",
   "ui.prompts.mode.full": "설치 / 업데이트 — 버전관리 + 자동화 워크플로우 (처음이라면 추천)",

package/src/index.js

@@ -103,6 +103,8 @@ async function runInner(argv, {
   // Language written to version.yml: the environment variable only decides this run's output, so it must not
   // overwrite a saved choice. Only --lang (or a first install / an unusable saved value) sets the stored language.
   let storedLanguage;
+  // Interactive mode asks for the language itself when nothing says which one to use.
+  let askLanguage = false;
   try {
     const savedVy = join(cwd, "version.yml");
     const savedParsed = existsSync(savedVy) ? parseExisting(readFileSync(savedVy, "utf8")) : null;
@@ -114,11 +116,15 @@ async function runInner(argv, {
     // falls back to English, but it was never the old default, so it gets its own wording.
     const existingWithoutLanguage = existsSync(savedVy) && !saved;
     const unspecified = !normalizeLanguage(opts.lang) && !normalizeLanguage(process.env[LANG_ENV_VAR]);
+    askLanguage = opts.mode === "interactive" && unspecified && !saved;
     if (existingWithoutLanguage && unspecified && ["full", "interactive"].includes(opts.mode)) {
       const unknown = savedParsed?.languageUnsupported;
-      console.error(unknown
-        ? t("cli.lang.unsupportedSavedNotice", { value: unknown, supported: SUPPORTED_LANGUAGES.join(", ") }, DEFAULT_LANGUAGE)
-        : t("cli.lang.defaultNotice", {}, DEFAULT_LANGUAGE));
+      if (unknown) {
+        console.error(t("cli.lang.unsupportedSavedNotice", { value: unknown, supported: SUPPORTED_LANGUAGES.join(", ") }, DEFAULT_LANGUAGE));
+      } else if (!askLanguage) {
+        // When the user is asked instead, there is no silent fallback left to explain.
+        console.error(t("cli.lang.defaultNotice", {}, DEFAULT_LANGUAGE));
+      }
     }
   } catch (e) {
     if (e instanceof CliError) { console.error(e.message); return 1; }
@@ -159,7 +165,7 @@ async function runInner(argv, {
     // The log file is created on the first write, so viewing only status/doctor from the menu leaves nothing behind.
     startLog("install");
     return await runInteractive(
-      { ...optionContextFields(opts), language: storedLanguage },
+      { ...optionContextFields(opts), language: askLanguage ? null : storedLanguage, askLanguage },
       { cwd, payloadRoot: payload, clock },
     );
   }

package/src/ui/prompts.js

@@ -3,7 +3,7 @@
 // On ESC each function returns the CANCEL symbol -> the caller interprets it as default/stay.
 // Ctrl+C / Ctrl+D make the engine reject with PromptAbortError -> run() catches it and exits with code 130.
 import * as engine from "./readline-engine.js";
-import { t } from "../i18n/index.js";
+import { t, SUPPORTED_LANGUAGES, DEFAULT_LANGUAGE } from "../i18n/index.js";
 import { DEPLOY_STYLES, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { TYPE_IDS, typeInfo } from "../core/types.js";
 import { askableOptions } from "../core/options.js";
@@ -11,6 +11,16 @@ import { ENV_MODES, DEFAULT_ENV_MODE, STORE_PLATFORMS, DEPLOY_MODES, DEFAULT_DEP
 
 export const CANCEL = engine.CANCEL;
 
+// Language selection - asked before any language is known, so the message and every label are rendered
+// once per supported language instead of in the active one. Returns the language code. CANCEL on cancel.
+export async function selectLanguage() {
+  return engine.select({
+    message: SUPPORTED_LANGUAGES.map((lang) => t("ui.prompts.language.message", {}, lang)).join(" / "),
+    options: SUPPORTED_LANGUAGES.map((lang) => ({ value: lang, label: t("ui.prompts.language.label", {}, lang) })),
+    initialIndex: Math.max(0, SUPPORTED_LANGUAGES.indexOf(DEFAULT_LANGUAGE)),
+  });
+}
+
 // Mode selection - localized labels, returns the internal key. CANCEL on cancel.
 // again=true is a re-entry after running a read-only mode (status/doctor) and returning to the menu -
 // asking "what should we install?" again would feel odd, so the wording changes.