agentic-dev 0.2.8 → 0.2.10

package/README.md

@@ -19,12 +19,14 @@ npx agentic-dev init my-app --template template-web --yes --skip-bootstrap
 
 1. GitHub에서 공개 `say828/template-*` 레포 목록을 조회한다.
 2. 사용자가 프로젝트 디렉터리와 템플릿 레포를 고른다.
-3. 선택한 레포를 새 디렉터리로 복제한다.
-4. `.env.example`이 있으면 `.env`를 자동 생성한다.
-5. `pnpm install`을 자동 실행한다.
-6. 템플릿의 `repo-contract.json`에서 `frontend.default_target`을 읽는다.
-7. 그 target에 대해 `playwright install chromium`을 실행한다.
-8. 그 target에 대해 parity bootstrap을 실행한다.
+   - interactive TTY에서는 템플릿 레포를 `↑/↓ + Enter`로 선택한다.
+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,6 +1,8 @@
 #!/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";
 import { createInterface } from "node:readline/promises";
 import {
   ensureTargetDir,
@@ -12,6 +14,196 @@ import {
   usage,
 } from "../lib/scaffold.mjs";
 
+function clearMenu(lines) {
+  if (lines <= 0) {
+    return;
+  }
+  readline.moveCursor(process.stdout, 0, -lines);
+  readline.clearScreenDown(process.stdout);
+}
+
+function renderRepoSelect(label, repos, cursor) {
+  const lines = [`${label} Use ↑/↓ and Enter.`];
+  for (let index = 0; index < repos.length; index += 1) {
+    const pointer = index === cursor ? ">" : " ";
+    const summary = repos[index].description ? ` - ${repos[index].description}` : "";
+    lines.push(`${pointer} ${repos[index].name}${summary}`);
+  }
+  process.stdout.write(`${lines.join("\n")}\n`);
+  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;
+  const previousRawMode = typeof stdin.setRawMode === "function" ? stdin.isRaw : undefined;
+
+  if (typeof stdin.setRawMode === "function") {
+    stdin.setRawMode(true);
+  }
+  stdin.resume();
+  stdin.setEncoding("utf8");
+
+  return new Promise((resolve, reject) => {
+    let renderedLines = render();
+
+    const cleanup = () => {
+      stdin.removeListener("data", handleData);
+      if (typeof stdin.setRawMode === "function") {
+        stdin.setRawMode(Boolean(previousRawMode));
+      }
+      stdout.write("\n");
+    };
+
+    const rerender = () => {
+      clearMenu(renderedLines);
+      renderedLines = render();
+    };
+
+    const handleData = (chunk) => {
+      try {
+        const result = onInput(chunk, rerender);
+        if (result !== undefined) {
+          clearMenu(renderedLines);
+          cleanup();
+          resolve(result);
+        }
+      } catch (error) {
+        clearMenu(renderedLines);
+        cleanup();
+        reject(error);
+      }
+    };
+
+    stdin.on("data", handleData);
+  });
+}
+
+async function promptForTemplateRepo(rl, repos, owner) {
+  if (process.stdin.isTTY && process.stdout.isTTY) {
+    console.log("");
+    let cursor = 0;
+    return runArrowMenu(
+      () => renderRepoSelect(`Public template repos from ${owner}:`, repos, cursor),
+      (chunk, rerender) => {
+        if (chunk === "\u0003") {
+          throw new Error("Prompt cancelled");
+        }
+        if (chunk === "\r" || chunk === "\n") {
+          return repos[cursor].name;
+        }
+        if (chunk === "\u001b[A") {
+          cursor = (cursor - 1 + repos.length) % repos.length;
+          rerender();
+        } else if (chunk === "\u001b[B") {
+          cursor = (cursor + 1) % repos.length;
+          rerender();
+        }
+        return undefined;
+      },
+    );
+  }
+
+  console.log("");
+  console.log(`Public template repos from ${owner}:`);
+  repos.forEach((repo, index) => {
+    const summary = repo.description ? ` - ${repo.description}` : "";
+    console.log(`  ${index + 1}. ${repo.name}${summary}`);
+  });
+  console.log("");
+
+  while (true) {
+    const answer = await rl.question("Select template repo (number or repo name): ");
+    try {
+      return selectTemplateRepo(answer, repos).name;
+    } catch (error) {
+      console.log(error.message);
+    }
+  }
+}
+
+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.");
@@ -36,21 +228,28 @@ async function promptForMissing(options, repos) {
     }
 
     if (!options.template) {
-      console.log("");
-      console.log(`Public template repos from ${options.owner}:`);
-      repos.forEach((repo, index) => {
-        const summary = repo.description ? ` - ${repo.description}` : "";
-        console.log(`  ${index + 1}. ${repo.name}${summary}`);
-      });
-      console.log("");
-      while (!options.template) {
-        const answer = await rl.question("Select template repo (number or repo name): ");
-        try {
-          options.template = selectTemplateRepo(answer, repos).name;
-        } catch (error) {
-          console.log(error.message);
-          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 {

package/package.json

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