project-auto-wizard 0.14.0 → 0.15.0

package/src/commands/doctor.js

@@ -179,6 +179,11 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   return results;
 }
 
+// Exit code for the CLI: 0 when every item is OK/INFO, 1 when any WARN or FAIL item was found.
+// Warnings and errors are not split: both mean "something the workflows rely on needs attention",
+// and a script that wants to tolerate warnings can ignore the code (`|| true`).
+export const doctorExitCode = (results) => (results.some((r) => r.status === "WARN" || r.status === "FAIL") ? 1 : 0);
+
 const asLines = (v) => (Array.isArray(v) ? v : v ? [String(v)] : []);
 const headOf = (r) => `${r.label || r.name}${r.purpose ? ` — ${r.purpose}` : ""}`;
 

package/src/commands/dry-run.js

@@ -144,6 +144,7 @@ export function printDryRun(plan) {
         "skip-no-readme": t("cmd.dryRun.readme.skipNoReadme"),
         "skip-marker": t("cmd.dryRun.readme.skipMarker"),
         "skip-version-line": t("cmd.dryRun.readme.skipVersionLine"),
+        "heading-updated": t("cmd.dryRun.readme.headingUpdated"),
       }[plan.readme] || t("cmd.dryRun.readme.other", { status: plan.readme }));
     }
     if (plan.baselineExists !== undefined) {

package/src/core/copy/readme.js

@@ -15,15 +15,66 @@ export const README_STATUS_LABEL = {
   get "skip-no-readme"() { return t("copy.readme.status.skipNoReadme"); },
   get "skip-marker"() { return t("copy.readme.status.skipMarker"); },
   get "skip-version-line"() { return t("copy.readme.status.skipVersionLine"); },
+  get "heading-updated"() { return t("copy.readme.status.headingUpdated"); },
 };
 
+// Bundled default heading text ("Latest Version", ...) without the "## " prefix and version part, per language.
+const defaultHeading = (lang) => t("copy.readme.versionHeading", { version: "0" }, lang).replace(/^##\s*/, "").replace(/\s*:\s*v0$/, "");
+const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+
+// Text of the history link line in a given language (without the trailing newline).
+const historyLink = (lang) => t("copy.readme.historyLink", {}, lang);
+
+// Rewrites the wizard-made block (marker line, heading line, blank line, history link line) that was written
+// in another language so it matches the current one. Only text that exactly equals another language's bundled
+// default is replaced: a heading or link the user edited is left alone, and so is anything not directly
+// under the marker (code-block examples, a README without the marker).
+// Returns the new content, or null when nothing needs to change.
+function refreshBlockLanguage(content) {
+  const currentHeading = defaultHeading();
+  const currentLink = historyLink();
+  const markerRe = new RegExp("^" + escapeRe(MARKER_LINE.trimEnd()) + "[ \\t]*\\r?\\n", "gm");
+  let out = "";
+  let last = 0;
+  let changed = false;
+  for (let m = markerRe.exec(content); m; m = markerRe.exec(content)) {
+    // An odd number of fence lines before the marker means it sits inside a code block (an example).
+    if ((content.slice(0, m.index).match(/^[ \t]*(```|~~~)/gm) || []).length % 2 === 1) continue;
+    const start = m.index + m[0].length;
+    let rest = content.slice(start);
+    let head = "";
+    // Heading line directly under the marker.
+    for (const lang of SUPPORTED_LANGUAGES) {
+      const heading = defaultHeading(lang);
+      if (heading === currentHeading) continue;
+      const hm = new RegExp("^## " + escapeRe(heading) + " : (?=v[0-9])").exec(rest);
+      if (hm) { head = "## " + currentHeading + " : "; rest = rest.slice(hm[0].length); changed = true; break; }
+    }
+    out += content.slice(last, start) + head;
+    last = start + (content.slice(start).length - rest.length);
+    // History link line: heading line, one blank line, then the link.
+    const lm = /^([^\r\n]*\r?\n\r?\n)([^\r\n]*)/.exec(rest);
+    if (lm) {
+      const linkStart = last + lm[1].length;
+      const isStale = SUPPORTED_LANGUAGES.some((lang) => historyLink(lang) !== currentLink && lm[2] === historyLink(lang));
+      if (isStale) {
+        out += content.slice(last, linkStart) + currentLink;
+        last = linkStart + lm[2].length;
+        changed = true;
+      }
+    }
+  }
+  return changed ? out + content.slice(last) : null;
+}
+
 // Skip when README.md is missing, or when a marker or version line exists. Otherwise append to the end.
-// Returns: 'skip-no-readme' | 'skip-marker' | 'skip-version-line' | 'added'
+// Returns: 'skip-no-readme' | 'heading-updated' | 'skip-marker' | 'skip-version-line' | 'added'
 // Only decides without writing, so the real append and the --dry-run preview share one decision.
 export function planVersionSection(targetRoot = ".") {
   const p = join(targetRoot, "README.md");
   if (!existsSync(p)) return "skip-no-readme";
   const content = readFileSync(p, "utf8");
+  if (refreshBlockLanguage(content) !== null) return "heading-updated";
   if (content.includes(MARKER)) return "skip-marker";
   if (VERSION_LINE_RE.test(content)) return "skip-version-line";
   return "added";
@@ -31,8 +82,13 @@ export function planVersionSection(targetRoot = ".") {
 
 export function addVersionSectionToReadme(version, targetRoot = ".") {
   const status = planVersionSection(targetRoot);
-  if (status !== "added") return status;
   const p = join(targetRoot, "README.md");
+  if (status === "heading-updated") {
+    // Swap only the bundled default wording; version text after the colon stays as the workflow wrote it.
+    writeFileSync(p, refreshBlockLanguage(readFileSync(p, "utf8")));
+    return status;
+  }
+  if (status !== "added") return status;
   const content = readFileSync(p, "utf8");
 
   // The appended body starts with "\n---\n..." to leave a blank line between the existing text and the rule.

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

@@ -115,6 +115,7 @@ export default {
   "cmd.dryRun.readme.skipNoReadme": "README.md: no file, so no version section is added",
   "cmd.dryRun.readme.skipMarker": "README.md: a version section already exists, no change",
   "cmd.dryRun.readme.skipVersionLine": "README.md: a version line already exists, no change",
+  "cmd.dryRun.readme.headingUpdated": "README.md: the version heading will switch to the current language (it is the bundled default text)",
   "cmd.dryRun.readme.other": "README.md: {status}",
   "cmd.dryRun.baseline.update": "{path}: will be updated (reference for the next update)",
   "cmd.dryRun.baseline.create": "{path}: will be created (reference for the next update)",

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

@@ -4,6 +4,7 @@ export default {
   "copy.readme.status.skipNoReadme": "README.md not found; version section not added",
   "copy.readme.status.skipMarker": "Version section already present; left as is",
   "copy.readme.status.skipVersionLine": "Version line already present; left as is",
+  "copy.readme.status.headingUpdated": "Switched the version heading to the current language",
   "copy.readme.versionHeading": "## Latest Version : v{version}",
   "copy.readme.historyLink": "[View full version history](CHANGELOG.md)",
   "copy.gitignore.newFileHeader": "# project-auto-wizard: backup files created during conflict handling (safe to ignore)",

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

@@ -115,6 +115,7 @@ export default {
   "cmd.dryRun.readme.skipNoReadme": "README.md: 파일이 없어 버전 섹션을 추가하지 않음",
   "cmd.dryRun.readme.skipMarker": "README.md: 이미 버전 섹션이 있어 변경 없음",
   "cmd.dryRun.readme.skipVersionLine": "README.md: 이미 버전 줄이 있어 변경 없음",
+  "cmd.dryRun.readme.headingUpdated": "README.md: 버전 제목이 현재 언어로 교체될 예정 (기본 제목 그대로인 경우)",
   "cmd.dryRun.readme.other": "README.md: {status}",
   "cmd.dryRun.baseline.update": "{path}: 갱신될 예정 (다음 업데이트의 비교 기준)",
   "cmd.dryRun.baseline.create": "{path}: 새로 생성될 예정 (다음 업데이트의 비교 기준)",

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

@@ -4,6 +4,7 @@ export default {
   "copy.readme.status.skipNoReadme": "README.md가 없어 버전 섹션을 추가하지 않음",
   "copy.readme.status.skipMarker": "이미 버전 섹션이 있어 그대로 둠",
   "copy.readme.status.skipVersionLine": "이미 버전 줄이 있어 그대로 둠",
+  "copy.readme.status.headingUpdated": "버전 제목을 현재 언어로 교체",
   "copy.readme.versionHeading": "## 최신 버전 : v{version}",
   "copy.readme.historyLink": "[전체 버전 기록 보기](CHANGELOG.md)",
   "copy.gitignore.newFileHeader": "# project-auto-wizard: 충돌 처리 시 생성되는 백업 파일 (안전하게 무시해도 됩니다)",

package/src/index.js

@@ -31,7 +31,7 @@ import { runInteractive } from "./commands/interactive.js";
 import { resolveDeployStyle, resolveVersion, resolveVersionCode, buildInstallContext } from "./commands/install-settings.js";
 import { initLogger, closeLogger, currentLogPath, hasLegacyMdLogs, log } from "./core/logger.js";
 import { runStatus, printStatus } from "./commands/status.js";
-import { runDoctor, printDoctorReport } from "./commands/doctor.js";
+import { runDoctor, printDoctorReport, doctorExitCode } from "./commands/doctor.js";
 import { planDryRun, printDryRun } from "./commands/dry-run.js";
 import { planPurge, executePurge, printPurgePlan, printPurgeResult } from "./commands/purge.js";
 
@@ -271,8 +271,9 @@ async function runInner(argv, {
   }
   // doctor mode: read-only, always works regardless of TTY/--force
   if (opts.mode === "doctor") {
-    printDoctorReport(runDoctor(cwd));
-    return 0;
+    const results = runDoctor(cwd);
+    printDoctorReport(results);
+    return doctorExitCode(results);
   }
   // An explicit mode (full) without --force is rejected immediately, TTY or not
   // (fixes a defect where a TTY run installed at once without confirmation).

package/src/ui/summary.js

@@ -34,7 +34,7 @@ export function printSummary(ctx) {
   err(t("ui.summary.features.title"));
 
   // Mention the automatic update only when the README version section really exists (added now or already there).
-  const readmeTracked = readme === "added" || readme === "skip-marker" || readme === "skip-version-line";
+  const readmeTracked = readme === "added" || readme === "skip-marker" || readme === "skip-version-line" || readme === "heading-updated";
   if (mode === "full") {
     err(t("ui.summary.features.versionSystem"));
     if (readmeTracked) err(t("ui.summary.features.readmeAuto"));