agentic-dev 0.2.9 → 0.2.10

package/README.md

@@ -20,12 +20,13 @@ npx agentic-dev init my-app --template template-web --yes --skip-bootstrap
 1. GitHub에서 공개 `say828/template-*` 레포 목록을 조회한다.
 2. 사용자가 프로젝트 디렉터리와 템플릿 레포를 고른다.
    - interactive TTY에서는 템플릿 레포를 `↑/↓ + Enter`로 선택한다.
-3. 선택한 레포를 새 디렉터리로 복제한다.
-4. `.env.example`이 있으면 `.env`를 자동 생성한다.
-5. `pnpm install`을 자동 실행한다.
-6. 템플릿의 `repo-contract.json`에서 `frontend.default_target`을 읽는다.
-7. 그 target에 대해 `playwright install chromium`을 실행한다.
-8. 그 target에 대해 parity bootstrap을 실행한다.
+3. 모든 선택을 받은 뒤 실행 계획 요약을 보여주고 최종 확인을 받는다.
+4. 확인 후에만 선택한 레포를 새 디렉터리로 복제한다.
+5. `.env.example`이 있으면 `.env`를 자동 생성한다.
+6. `pnpm install`을 자동 실행한다.
+7. 템플릿의 `repo-contract.json`에서 `frontend.default_target`을 읽는다.
+8. 그 target에 대해 `playwright install chromium`을 실행한다.
+9. 그 target에 대해 parity bootstrap을 실행한다.
 
 `frontend.default_target`이 있으면 multi-surface 템플릿도 그대로 지원한다. 예를 들어 `template-fullstack-mono`는 `client/web`과 `client/admin`을 함께 포함하지만 기본 bootstrap 대상은 `web`이다.
 

package/bin/agentic-dev.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import * as readline from "node:readline";
@@ -32,6 +33,17 @@ function renderRepoSelect(label, repos, cursor) {
   return lines.length;
 }
 
+function renderChoiceSelect(label, choices, cursor) {
+  const lines = [`${label} Use ↑/↓ and Enter.`];
+  for (let index = 0; index < choices.length; index += 1) {
+    const pointer = index === cursor ? ">" : " ";
+    const summary = choices[index].description ? ` - ${choices[index].description}` : "";
+    lines.push(`${pointer} ${choices[index].label}${summary}`);
+  }
+  process.stdout.write(`${lines.join("\n")}\n`);
+  return lines.length;
+}
+
 async function runArrowMenu(render, onInput) {
   const stdin = process.stdin;
   const stdout = process.stdout;
@@ -121,6 +133,77 @@ async function promptForTemplateRepo(rl, repos, owner) {
   }
 }
 
+async function promptForChoice(rl, label, choices) {
+  if (process.stdin.isTTY && process.stdout.isTTY) {
+    console.log("");
+    let cursor = 0;
+    return runArrowMenu(
+      () => renderChoiceSelect(label, choices, cursor),
+      (chunk, rerender) => {
+        if (chunk === "\u0003") {
+          throw new Error("Prompt cancelled");
+        }
+        if (chunk === "\r" || chunk === "\n") {
+          return choices[cursor].value;
+        }
+        if (chunk === "\u001b[A") {
+          cursor = (cursor - 1 + choices.length) % choices.length;
+          rerender();
+        } else if (chunk === "\u001b[B") {
+          cursor = (cursor + 1) % choices.length;
+          rerender();
+        }
+        return undefined;
+      },
+    );
+  }
+
+  console.log("");
+  console.log(label);
+  choices.forEach((choice, index) => {
+    const summary = choice.description ? ` - ${choice.description}` : "";
+    console.log(`  ${index + 1}. ${choice.label}${summary}`);
+  });
+  console.log("");
+
+  while (true) {
+    const answer = (await rl.question("Select option: ")).trim();
+    if (/^\d+$/.test(answer)) {
+      const index = Number.parseInt(answer, 10) - 1;
+      if (index >= 0 && index < choices.length) {
+        return choices[index].value;
+      }
+    }
+    const exact = choices.find((choice) => choice.label === answer || choice.value === answer);
+    if (exact) {
+      return exact.value;
+    }
+    console.log(`Invalid selection: ${answer || "(empty)"}`);
+  }
+}
+
+function directoryHasUserFiles(targetDir) {
+  const resolved = path.resolve(process.cwd(), targetDir);
+  if (!fs.existsSync(resolved)) {
+    return false;
+  }
+
+  const entries = fs
+    .readdirSync(resolved, { withFileTypes: true })
+    .filter((entry) => entry.name !== ".git");
+  return entries.length > 0;
+}
+
+function printPlannedRun(options) {
+  console.log("");
+  console.log("Plan:");
+  console.log(`  Project directory: ${path.resolve(process.cwd(), options.targetDir)}`);
+  console.log(`  Template repo: ${options.template}`);
+  console.log(`  GitHub owner: ${options.owner}`);
+  console.log(`  Allow non-empty directory: ${options.force ? "yes" : "no"}`);
+  console.log(`  Run install/bootstrap: ${options.skipBootstrap ? "no" : "yes"}`);
+}
+
 async function promptForMissing(options, repos) {
   if (options.yes && (!options.targetDir || !options.template)) {
     throw new Error("`--yes` requires both target directory and template repo.");
@@ -147,6 +230,28 @@ async function promptForMissing(options, repos) {
     if (!options.template) {
       options.template = await promptForTemplateRepo(rl, repos, options.owner);
     }
+
+    if (!options.force && directoryHasUserFiles(options.targetDir)) {
+      const allowOverwrite = await promptForChoice(rl, "Target directory is not empty.", [
+        { label: "Continue", value: true, description: "Scaffold into the existing directory" },
+        { label: "Cancel", value: false, description: "Stop without changing files" },
+      ]);
+      if (!allowOverwrite) {
+        throw new Error("Prompt cancelled");
+      }
+      options.force = true;
+    }
+
+    if (!options.yes) {
+      printPlannedRun(options);
+      const proceed = await promptForChoice(rl, "Run scaffold now?", [
+        { label: "Proceed", value: true, description: "Clone, install, and bootstrap now" },
+        { label: "Cancel", value: false, description: "Stop before running commands" },
+      ]);
+      if (!proceed) {
+        throw new Error("Prompt cancelled");
+      }
+    }
   } finally {
     rl.close();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-dev",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Scaffold a public say828/template-* repo and run install/bootstrap automatically.",
   "type": "module",
   "packageManager": "pnpm@10.32.0",