projectops 3.0.192 → 3.0.194

package/src/core/wizard-env.js

@@ -0,0 +1,101 @@
+// @wizard env 토큰 엔진 (.sh configure_workflow_env / _wf_set_env / _wf_is_unchanged 등가).
+// ⚠️ YAML 파싱/재직렬화 금지 — 라인 단위 문자열 처리 (포맷·주석 보존이 unchanged 판정 전제).
+// 실측 기준: template_integrator.sh 3282~3360, 3003~3012.
+
+// KEY 정규식: .sh는 [A-Z_]+ (대문자+언더스코어만). ask/auto 마커가 있는 라인만 대상.
+const MARKER_RE = /#\s*@wizard\s+(ask|auto):(.*)$/;
+const KEY_RE = /^(\s*)([A-Z_]+):/;
+const PATHS_ANCHOR_RE = /#\s*@wizard\s+paths-anchor/;
+
+// 한 라인을 파싱해 {indent,key,action,arg} 반환. ask/auto 마커 없으면 null.
+export function parseWizardLine(line) {
+  const marker = line.match(MARKER_RE);
+  if (!marker) return null;
+  const km = line.match(KEY_RE);
+  if (!km) return null; // KEY: 형식 아니면 (예: paths-anchor 주석) 무시
+  return { indent: km[1], key: km[2], action: marker[1], arg: marker[2].trim() };
+}
+
+// .sh _wf_set_env 등가: `KEY: "..."` 따옴표 안 값 치환 + 그 줄 끝 `# @wizard ...` 주석 제거.
+// 라인 하나에 대해 수행. value가 빈문자면 (.sh는 [ -n "$_val" ] 가드) 치환 스킵.
+export function setEnvLine(line, key, value) {
+  if (value === "" || value == null) return line;
+  // CRLF 안전: 라인 끝 \r을 분리해 처리 후 복원 (autocrlf 프로젝트 대응)
+  const cr = line.endsWith("\r") ? "\r" : "";
+  const body = cr ? line.slice(0, -1) : line;
+  // 값 치환: KEY: "기존값" → KEY: "value"
+  let out = body.replace(
+    new RegExp(`^(\\s*${key}:\\s*")[^"]*(")`),
+    (_m, p1, p2) => `${p1}${value}${p2}`,
+  );
+  // 그 줄 끝 # @wizard ... 주석 제거 (앞 공백째)
+  out = out.replace(/(\S)[^\S\r\n]*#[^\S\r\n]*@wizard[^\S\r\n].*$/, "$1");
+  return out + cr;
+}
+
+// resolver — .sh resolve_token 등가. 값 계산은 주입된 resolvers로 위임(순수성 유지).
+// resolvers: { repo, "spring-app-yml-dir"(type), "spring-app-yml-path"(type), "flutter-root" }
+export function resolveToken(name, type, resolvers = {}) {
+  const fn = resolvers[name];
+  return typeof fn === "function" ? (fn(type) ?? "") : "";
+}
+
+// 파일 전체 치환 (configure_workflow_env 등가).
+// content: 원본 워크플로우 텍스트. 반환: 치환된 텍스트.
+// opts:
+//   type          - 프로젝트 타입 (resolver·값 조회용)
+//   values        - Map<key,value>: ask 키의 사용자 선택값 (없으면 기본값=arg 또는 resolver)
+//   useDefaults   - true면 ask도 기본값 사용 (WF_USE_DEFAULTS=true, unchanged 비교의 전제)
+//   resolvers     - resolveToken용
+//   repoName      - __PROJECT_NAME__/__APP_ARTIFACT_NAME__ 치환값
+//   projectPath   - paths-anchor 치환용 ('.'이면 anchor 미변경)
+export function substituteEnv(content, opts = {}) {
+  const { type = "", values = new Map(), useDefaults = true, resolvers = {}, repoName = "", projectPath = ".", collectAsks = null } = opts;
+  if (!content.includes("@wizard")) return content;
+
+  // CRLF 안전: EOL을 분리해 LF 기준으로 파싱·치환하고, 원래 EOL 스타일을 복원한다.
+  // (JS 정규식의 `.`은 \r을 매칭하지 않아 `(.*)$` 마커 파싱이 CRLF에서 실패하기 때문.)
+  const usesCRLF = content.includes("\r\n");
+  const lines = content.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i++) {
+    const p = parseWizardLine(lines[i]); // 이미 \r 제거된 라인
+    if (!p) continue;
+    let val = "";
+    if (p.action === "auto") {
+      val = resolveToken(p.arg, type, resolvers);
+    } else { // ask
+      let def = p.arg.startsWith("@") ? resolveToken(p.arg.slice(1), type, resolvers) : p.arg;
+      const chosen = values.get(p.key);
+      if (chosen != null && chosen !== "" && !useDefaults) val = chosen;
+      else val = def;
+      // ask 키만 수집 (.sh wf_deploy_set — auto는 저장 안 함). deploy 블록용.
+      if (collectAsks) collectAsks.set(p.key, val);
+    }
+    lines[i] = setEnvLine(lines[i], p.key, val);
+  }
+  let out = lines.join(usesCRLF ? "\r\n" : "\n");
+
+  // 잔여 전역 토큰 (.sh 3347~3351)
+  if (out.includes("__PROJECT_NAME__") || out.includes("__APP_ARTIFACT_NAME__")) {
+    out = out.replaceAll("__PROJECT_NAME__", repoName).replaceAll("__APP_ARTIFACT_NAME__", repoName);
+  }
+
+  // paths-anchor (.sh 3353~3360): 경로가 '.'이 아니면 주석 라인 전체를 paths 라인으로 교체
+  if (PATHS_ANCHOR_RE.test(out) && projectPath && projectPath !== ".") {
+    const eol = out.includes("\r\n") ? "\r\n" : "\n";
+    out = out.split(/\r?\n/).map((line) => {
+      if (PATHS_ANCHOR_RE.test(line)) {
+        const indent = (line.match(/^(\s*)/) || ["", ""])[1];
+        return `${indent}paths: ['${projectPath}/**']`;
+      }
+      return line;
+    }).join(eol);
+  }
+  return out;
+}
+
+// .sh _wf_is_unchanged 등가: 원본을 "기본값으로 가상 치환한 최종형"과 설치본을 바이트 비교.
+export function isUnchanged(templateContent, installedContent, opts = {}) {
+  const virtual = substituteEnv(templateContent, { ...opts, useDefaults: true });
+  return virtual === installedContent;
+}

package/src/index.js

@@ -0,0 +1,99 @@
+// projectops CLI 진입 파이프라인 (.sh main + execute_integration 등가).
+// 감지 → 다운로드 → 모드 라우팅 → 통합 실행 → 정리. 비대화형(--force) 우선.
+import { join } from "node:path";
+import { parseArgs, parsePathsCsv, CliError } from "./cli/args.js";
+import { HELP_TEXT } from "./cli/help.js";
+import { createContext } from "./context.js";
+import { PATHS } from "./core/paths.js";
+import { remove } from "./core/fsutil.js";
+import { acquireTemplate, readTemplateVersion } from "./core/assets.js";
+import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName } from "./core/detect-fs.js";
+import { runFull } from "./commands/full.js";
+import { runVersion } from "./commands/version.js";
+import { runWorkflows } from "./commands/workflows.js";
+import { runIssues } from "./commands/issues.js";
+import { runInteractive } from "./commands/interactive.js";
+
+// 결정적 UTC 타임스탬프 (주입 가능 — 테스트/골든용)
+function utcNow(date = new Date()) {
+  const p = (n) => String(n).padStart(2, "0");
+  const d = `${date.getUTCFullYear()}-${p(date.getUTCMonth() + 1)}-${p(date.getUTCDate())}`;
+  const t = `${p(date.getUTCHours())}:${p(date.getUTCMinutes())}:${p(date.getUTCSeconds())}`;
+  return { now: `${d} ${t}`, today: d };
+}
+
+// run(argv, opts) → exitCode. opts: { cwd, source?, clock? }
+//   source: acquireTemplate용 (기본 git clone). 테스트는 {type:'local', path} 주입.
+//   clock: {now, today} 주입 (기본 현재 UTC).
+export async function run(argv, { cwd = process.cwd(), source = { type: "git" }, clock } = {}) {
+  let opts;
+  try {
+    opts = parseArgs(argv);
+  } catch (e) {
+    if (e instanceof CliError) { console.error(e.message); return 1; }
+    throw e;
+  }
+  if (opts.help) { console.log(HELP_TEXT); return 0; }
+
+  // skills 모드는 IDE 설치 전용 (SP2-D)
+  if (opts.mode === "skills") {
+    console.error("skills 모드는 아직 지원되지 않습니다 (SP2-D 예정). 기존 template_integrator를 사용하세요.");
+    return 1;
+  }
+  // 대화형 모드 — 인자 없이 실행 or --mode interactive
+  if (opts.mode === "interactive") {
+    if (!process.stdout.isTTY) {
+      console.error("대화형 입력이 불가능한 환경입니다. --mode <full|version|workflows|issues> 와 --force 를 지정하세요.");
+      return 1;
+    }
+    return await runInteractive({}, { cwd, source, clock });
+  }
+  // 명시 모드인데 --force 없으면 (비대화형 CLI는 --force 필요)
+  if (!opts.force && !process.stdout.isTTY) {
+    console.error("비대화형 환경에서는 --force 옵션이 필요합니다.");
+    return 1;
+  }
+
+  // 감지 (CLI 인자 우선, 없으면 자동 감지 — version.yml 우선 규칙은 detectTypes/detectVersion 내부)
+  const types = opts.types.length ? opts.types : detectTypes(cwd);
+  const version = opts.version || detectVersion(cwd);
+  const branch = detectDefaultBranch(cwd);
+  const repoName = detectRepoName(cwd);
+  const paths = parsePathsCsv(opts.pathsCsv);
+  // paths 미지정 타입은 루트(".") — basic 제외
+  for (const t of types) if (t !== "basic" && !paths.has(t)) paths.set(t, ".");
+
+  const { now, today } = clock || utcNow();
+  const tempDir = join(cwd, PATHS.tempDir);
+
+  const context = createContext({
+    mode: opts.mode, force: true, types, version, branch,
+    paths, includeNexus: opts.includeNexus === true, includeSecretBackup: opts.includeSecretBackup === true,
+    repoName,
+    resolvers: {
+      repo: () => repoName,
+      "spring-app-yml-dir": () => "",
+      "spring-app-yml-path": () => "",
+      "flutter-root": () => paths.get("flutter") || ".",
+    },
+    now, today,
+  });
+
+  try {
+    acquireTemplate({ tempDir, source });
+    context.templateVersion = readTemplateVersion(tempDir);
+
+    switch (opts.mode) {
+      case "full": runFull(context, tempDir, cwd); break;
+      case "version": runVersion(context, tempDir, cwd); break;
+      case "workflows": runWorkflows(context, tempDir, cwd); break;
+      case "issues": runIssues(context, tempDir, cwd); break;
+      default:
+        // 알 수 없는 모드 → .sh와 동일하게 복사 0건, 에러 아님
+        break;
+    }
+  } finally {
+    remove(tempDir);
+  }
+  return 0;
+}

package/src/ui/prompts.js

@@ -0,0 +1,82 @@
+// 대화형 프롬프트 래핑 (.sh interactive_menu/choose_menu/ask_* 등가) — @clack/prompts 기반.
+// 취소(ESC/Ctrl+C)는 각 함수가 CANCEL 심볼을 반환 → 호출부가 정상 종료(exit 0) 처리.
+import * as clack from "@clack/prompts";
+
+export const CANCEL = Symbol("cancel");
+const wrap = (v) => (clack.isCancel(v) ? CANCEL : v);
+
+// 모드 선택 — 한국어 라벨, 내부 키 반환. 취소 시 CANCEL.
+export async function selectMode() {
+  const v = await clack.select({
+    message: "무엇을 설치할까요?",
+    options: [
+      { value: "full", label: "전체 설치 — 버전관리 + 자동화 워크플로우 + 이슈·PR 템플릿 (처음이라면 추천)" },
+      { value: "version", label: "버전 관리만 — 버전 자동 증가·동기화 시스템만 설치" },
+      { value: "workflows", label: "워크플로우만 — 빌드·배포 GitHub Actions만 설치" },
+      { value: "issues", label: "이슈·PR 템플릿만 — GitHub 이슈/PR 양식만 설치" },
+      { value: "skills", label: "AI 스킬만 — Claude·Cursor·Gemini·Codex·PI용 스킬만 설치" },
+    ],
+  });
+  return wrap(v);
+}
+
+// 프로젝트 확인 화면 메뉴 (계속/수정/취소).
+export async function confirmProjectMenu() {
+  const v = await clack.select({
+    message: "이 정보로 진행할까요?",
+    options: [
+      { value: "continue", label: "예, 계속 진행" },
+      { value: "edit", label: "수정하기" },
+      { value: "cancel", label: "아니오, 취소" },
+    ],
+  });
+  return wrap(v);
+}
+
+// 수정 메뉴 — 어떤 항목을 고칠지. showOptional=full/workflows에서만 nexus/secret 노출.
+export async function editMenu({ showOptional = false } = {}) {
+  const options = [
+    { value: "type", label: "프로젝트 타입" },
+    { value: "version", label: "버전" },
+    { value: "branch", label: "기본 브랜치" },
+  ];
+  if (showOptional) {
+    options.push({ value: "nexus", label: "Nexus publish 포함 여부" });
+    options.push({ value: "secret", label: "Secret 백업 포함 여부" });
+  }
+  options.push({ value: "done", label: "모두 맞음, 계속" });
+  const v = await clack.select({ message: "어떤 항목을 수정할까요?", options });
+  return wrap(v);
+}
+
+// 타입 멀티선택.
+export async function selectTypes(current = []) {
+  const all = ["spring", "flutter", "next", "react", "react-native", "react-native-expo", "node", "python", "basic"];
+  const v = await clack.multiselect({
+    message: "프로젝트 타입을 선택하세요 (Space 토글, Enter 확정)",
+    options: all.map((t) => ({ value: t, label: t })),
+    initialValues: current.length ? current : ["basic"],
+    required: true,
+  });
+  return wrap(v);
+}
+
+// 텍스트 입력 (빈 입력=기본값 유지).
+export async function askText(message, defaultValue = "") {
+  const v = await clack.text({ message, placeholder: defaultValue, defaultValue });
+  const w = wrap(v);
+  if (w === CANCEL) return CANCEL;
+  return w === "" || w == null ? defaultValue : w;
+}
+
+// 예/아니오.
+export async function askYesNo(message, initial = true) {
+  const v = await clack.confirm({ message, initialValue: initial });
+  return wrap(v);
+}
+
+// 배너·안내 출력.
+export function intro(text) { clack.intro(text); }
+export function outro(text) { clack.outro(text); }
+export function note(text, title) { clack.note(text, title); }
+export function cancelMessage(text = "취소했습니다.") { clack.cancel(text); }