projectops 3.0.193 → 3.0.195

package/src/core/version-yml.js

@@ -0,0 +1,146 @@
+// version.yml 파싱·생성 (.sh create_version_yml 등가, 전체 재생성 전략 D4).
+// ⚠️ YAML 재직렬화 금지 — 주석이 데이터. .sh heredoc과 바이트 동일한 템플릿 문자열.
+// 실측 기준: template_integrator.sh 2184~2354.
+
+const HEADER = `# ===================================================================
+# 프로젝트 버전 관리 파일
+# ===================================================================
+#
+# 이 파일은 다양한 프로젝트 타입에서 버전 정보를 중앙 관리하기 위한 파일입니다.
+# GitHub Actions 워크플로우가 이 파일을 읽어 자동으로 버전을 관리합니다.
+#
+# 사용법:
+# 1. version: "1.0.0" - 사용자에게 표시되는 버전
+# 2. version_code: 1 - Play Store/App Store 빌드 번호 (1부터 자동 증가)
+# 3. project_type: 프로젝트 타입 지정
+# 4. project_paths: 타입별 프로젝트 폴더 (레포 루트 기준 상대경로, 모노레포용)
+#
+# 자동 버전 업데이트:
+# - patch: 자동으로 세 번째 자리 증가 (x.x.x -> x.x.x+1)
+# - version_code: 매 빌드마다 자동으로 1씩 증가
+# - minor/major: 수동으로 직접 수정 필요
+#
+# 프로젝트 타입별 동기화 파일:
+# - spring: build.gradle (version = "x.y.z")
+# - flutter: pubspec.yaml (version: x.y.z+i, buildNumber 포함)
+# - react/node: package.json ("version": "x.y.z")
+# - react-native: iOS Info.plist 또는 Android build.gradle
+# - react-native-expo: app.json (expo.version)
+# - python: pyproject.toml (version = "x.y.z")
+# - basic/기타: version.yml 파일만 사용
+#
+# 연관된 워크플로우:
+# - .github/workflows/PROJECT-VERSION-CONTROL.yaml
+# - .github/workflows/PROJECT-README-VERSION-UPDATE.yaml
+# - .github/workflows/PROJECT-AUTO-CHANGELOG-CONTROL.yaml
+#
+# 주의사항:
+# - project_type은 최초 설정 후 변경하지 마세요
+# - 버전은 항상 높은 버전으로 자동 동기화됩니다
+# ===================================================================
+`;
+
+// 기존 version.yml에서 값 추출 (.sh grep/sed 등가, 주석 라인 오탐 방지).
+export function parseExisting(content) {
+  const text = String(content || "");
+  const line = (re) => {
+    for (const l of text.split("\n")) {
+      if (l.startsWith("#")) continue; // 주석 제외
+      const m = l.match(re);
+      if (m) return m[1];
+    }
+    return null;
+  };
+  // version: "x.y.z" (숫자.숫자.숫자 형태만)
+  const version = line(/^version:\s*["']?([0-9][0-9.]*)["']?/) || "";
+  // version_code: N (양의 정수, 아니면 1)
+  let versionCode = parseInt(line(/^version_code:\s*([0-9]+)/) || "", 10);
+  if (!Number.isInteger(versionCode) || versionCode <= 0) versionCode = 1;
+  // project_types: ["a","b"]
+  const typesRaw = line(/^project_types:\s*(\[[^\]]*\])/);
+  let types = [];
+  if (typesRaw) types = [...typesRaw.matchAll(/"([^"]+)"/g)].map((m) => m[1]);
+  // project_paths 블록: "  type: "path""
+  const paths = new Map();
+  let inPaths = false;
+  for (const l of text.split("\n")) {
+    if (/^project_paths:/.test(l)) { inPaths = true; continue; }
+    if (inPaths) {
+      const m = l.match(/^\s+([a-z-]+):\s*"([^"]*)"/);
+      if (m) paths.set(m[1], m[2]);
+      else if (/^\S/.test(l)) inPaths = false; // 들여쓰기 끝 → 블록 종료
+    }
+  }
+  // template: 블록 내 version
+  let templateVersion = "";
+  let inTemplate = false;
+  for (const l of text.split("\n")) {
+    if (/^\s*template:/.test(l)) { inTemplate = true; continue; }
+    if (inTemplate) {
+      const m = l.match(/^\s*version:\s*"([0-9][0-9.]*)"/);
+      if (m) { templateVersion = m[1]; break; }
+      if (/^\S/.test(l)) break;
+    }
+  }
+  return { version, versionCode, types, paths, templateVersion };
+}
+
+// version.yml 전체 생성 (.sh create_version_yml + save_template_options 신규 케이스 등가).
+// opts: { version, types:[], primaryType?, paths:Map, pathMarkers?:Map, branch, versionCode, now, today, templateOptions? }
+//   now   = "YYYY-MM-DD HH:MM:SS" (UTC) — 결정성 위해 주입
+//   today = "YYYY-MM-DD" (UTC)
+//   pathMarkers = Map<type, markerFilename> (project_paths 주석용)
+//   templateOptions = { templateVersion, includeNexus, includeSecretBackup, optionsDate } (template 블록)
+export function buildVersionYml({ version, types = [], primaryType, paths = new Map(), pathMarkers = new Map(), branch = "main", versionCode = 1, now, today, templateOptions = null, deployValues = new Map() }) {
+  const typesJson = types.length ? `[${types.map((t) => `"${t}"`).join(",")}]` : `["basic"]`;
+  const primary = primaryType || types[0] || "basic";
+
+  let out = HEADER + "\n";
+  out += `version: "${version}"\n`;
+  out += `version_code: ${versionCode}  # app build number\n`;
+  out += `project_types: ${typesJson}   # 멀티타입 배열 — 첫 항목이 primary, 직접 편집 가능\n`;
+  out += `project_type: "${primary}"  # project_types[0] 자동 미러 — 직접 수정 금지 (spring, flutter, next, react, react-native, react-native-expo, node, python, basic)\n`;
+
+  // project_paths 블록. pathMarkers: Map<type, markerFilename> (있으면 "  type: "path"   # path/marker" 주석).
+  if (paths.size) {
+    out += `project_paths:                # 타입별 프로젝트 폴더 (레포 루트 기준 상대경로)\n`;
+    for (const [t, p] of paths) {
+      const marker = pathMarkers.get(t) || "";
+      const pf = p === "." ? marker : (marker ? `${p}/${marker}` : p);
+      out += marker ? `  ${t}: "${p}"   # ${pf}\n` : `  ${t}: "${p}"\n`;
+    }
+  }
+
+  out += `metadata:\n`;
+  out += `  last_updated: "${now}"\n`;
+  out += `  last_updated_by: "template_integrator"\n`;
+  out += `  default_branch: "${branch}"\n`;
+  out += `  integrated_from: "projectops"\n`;
+  out += `  integration_date: "${today}"\n`;
+
+  // deploy 블록 (.sh update_version_yml_deploy). deployValues: Map<type, Map<key,value>>.
+  // WF ask 값이 있는 타입만. metadata 뒤, template 앞. (앞에 빈 줄 1개)
+  const deployTypes = [...deployValues.keys()].filter((t) => deployValues.get(t) && deployValues.get(t).size > 0);
+  if (deployTypes.length) {
+    out += `\n`;
+    out += `deploy:                          # 마법사가 기억하는 배포 설정 (비민감 / 직접 수정 가능)\n`;
+    for (const t of deployTypes) {
+      out += `  ${t}:\n`;
+      for (const [k, v] of deployValues.get(t)) out += `    ${k}: "${v}"\n`;
+    }
+  }
+
+  // template 옵션 블록 (.sh save_template_options 신규 추가 케이스). templateOptions 지정 시.
+  if (templateOptions) {
+    const { templateVersion = "unknown", includeNexus = false, includeSecretBackup = false, optionsDate = today } = templateOptions;
+    out += `  template:\n`;
+    out += `    source: "projectops"\n`;
+    out += `    version: "${templateVersion}"\n`;
+    out += `    integrated_date: "${optionsDate}"\n`;
+    out += `    last_update_date: "${optionsDate}"\n`;
+    out += `    options:\n`;
+    out += `      nexus: ${includeNexus}\n`;
+    out += `      secret_backup: ${includeSecretBackup}\n`;
+  }
+  return out;
+}

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,108 @@
+// 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";
+import { runSkills } from "./commands/skills.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 스킬 설치/업데이트/제거 (템플릿 통합 없음).
+  // Cursor 복사용 skills/ 소스가 필요하므로 템플릿을 획득한 뒤 실행한다.
+  if (opts.mode === "skills") {
+    const tempDir = join(cwd, PATHS.tempDir);
+    const interactive = !opts.force && process.stdout.isTTY;
+    try {
+      acquireTemplate({ tempDir, source });
+      const templateVersion = readTemplateVersion(tempDir);
+      return await runSkills({ templateVersion, tempDir, interactive });
+    } finally {
+      remove(tempDir);
+    }
+  }
+  // 대화형 모드 — 인자 없이 실행 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); }

package/src/ui/skills-prompts.js

@@ -0,0 +1,37 @@
+// IDE Skills 대화형 프롬프트 (.sh 라우터 choose_menu 등가) — @clack/prompts 기반.
+import * as clack from "@clack/prompts";
+
+export const CANCEL = Symbol("cancel");
+const wrap = (v) => (clack.isCancel(v) ? CANCEL : v);
+
+// 동작 선택: 설치/업데이트 · 제거 · 그대로. 취소=skip.
+export async function selectAction() {
+  const v = await clack.select({
+    message: "AI 스킬을 어떻게 할까요?",
+    options: [
+      { value: "apply", label: "설치 / 업데이트 — 최신 상태로 맞추기" },
+      { value: "remove", label: "제거 — 설치된 스킬 삭제하기" },
+      { value: "skip", label: "그대로 두기" },
+    ],
+  });
+  const w = wrap(v);
+  return w === CANCEL ? "skip" : w;
+}
+
+// IDE 멀티셀렉트. choices=[{id,label,disabled}], preselect=[id...], action.
+export async function selectTargets(choices, preselect = [], action = "apply") {
+  const options = choices.map((c) => ({
+    value: c.id,
+    label: c.label + (c.disabled ? " (미감지)" : ""),
+    hint: c.disabled ? "CLI 없음" : undefined,
+  }));
+  const v = await clack.multiselect({
+    message: `${action === "apply" ? "설치 / 업데이트" : "제거"}할 IDE를 고르세요 (Space 토글, Enter 확정)`,
+    options,
+    initialValues: preselect,
+    required: false,
+  });
+  return wrap(v);
+}
+
+export function note(text, title) { clack.note(text, title); }