@taejung3852/project-scaffold 0.1.0 → 0.1.2

package/README.kr.md

@@ -27,7 +27,7 @@ project-scaffold는 두 레이어로 이 문제를 해결한다.
 
 ## 빠른 시작
 
-Node.js 20 이상과 Git 저장소가 필요하다.
+Node.js 20.12 이상과 Git 저장소가 필요하다.
 
 ### 새 프로젝트
 
@@ -181,7 +181,7 @@ npx @taejung3852/project-scaffold@latest agents
 
 전체 목록과 실제 설치 경로는 위 명령으로 확인한다. `--agent all`과 `--agent '*'`도 지원한다.
 
-CLI는 루트 `skills/{wiki,brief,review}`를 한 번 설치한 뒤 같은 경로를 사용하는 에이전트를 묶어서 상대 심링크를 생성한다. `--agent`를 생략하면 로컬 설치 흔적을 감지해 후보를 추천하고, 감지하지 못하면 범용 `.agents/skills/`를 기본값으로 사용한다. `claude`, `hermes` 같은 기존 별칭도 계속 지원한다.
+CLI는 루트 `skills/{wiki,brief,review}`를 한 번 설치한 뒤 같은 경로를 사용하는 에이전트를 묶어서 상대 심링크를 생성한다. `--agent`를 생략하면 로컬 설치 흔적을 감지해 후보를 추천하고, 감지하지 못하면 범용 `.agents/skills/`를 기본값으로 사용한다. `claude`, `hermes`, `gemini`, `agy` 같은 별칭도 지원한다. Gemini CLI, Antigravity CLI, Antigravity 2.0은 제품 표면과 전역 스킬 경로가 다르므로 레지스트리에서는 별도 대상으로 유지한다.
 
 ## 설치되는 구조
 
@@ -244,4 +244,4 @@ npm publish --access public
 | skills@1.5.16 기반 73개 에이전트 레지스트리 | ✅ 구현 |
 | 핵심 스킬 3개 (`wiki`, `brief`, `review`) | ✅ 구현 |
 | Hermes식 스킬 사용 추적·자가 진화 | 🗑️ 제거 |
-| npm 최초 publish | ⏳ 전체 수정 완료 후 진행 |
+| npm publish (`0.1.1`) | ✅ 완료 |

package/README.md

@@ -27,7 +27,7 @@ Users do not memorize twelve commands. The agent routes each request to one of t
 
 ## Quick start
 
-Requires Node.js 20+ and a Git repository.
+Requires Node.js 20.12+ and a Git repository.
 
 ### New project
 
@@ -181,7 +181,7 @@ npx @taejung3852/project-scaffold@latest agents
 
 Use this command to see every ID and path. `--agent all` and `--agent '*'` are also supported.
 
-The CLI installs canonical `skills/{wiki,brief,review}` once and deduplicates agents that share the same target directory. Without `--agent`, it recommends reliably detected local agents and falls back to universal `.agents/skills/` when none are found. Existing aliases such as `claude` and `hermes` remain supported.
+The CLI installs canonical `skills/{wiki,brief,review}` once and deduplicates agents that share the same target directory. Without `--agent`, it recommends reliably detected local agents and falls back to universal `.agents/skills/` when none are found. Existing aliases such as `claude`, `hermes`, `gemini`, and `agy` remain supported. Google agents are kept as separate registry targets because Gemini CLI, Antigravity CLI, and Antigravity 2.0 use different product surfaces and global skill paths.
 
 ## Installed structure
 
@@ -244,4 +244,4 @@ npm publish --access public
 | 73-agent registry based on skills@1.5.16 | ✅ Implemented |
 | Three core skills (`wiki`, `brief`, `review`) | ✅ Implemented |
 | Hermes-style usage tracking and self-evolution | 🗑️ Removed |
-| Initial npm publish | ⏳ After all planned changes |
+| npm publish (`0.1.1`) | ✅ Published |

package/lib/agents-registry.js

@@ -100,6 +100,8 @@ const displayNameOverrides = {
   devin: "Devin for Terminal",
   droid: "Droid",
   "gemini-cli": "Gemini CLI",
+  antigravity: "Antigravity 2.0 (desktop)",
+  "antigravity-cli": "Antigravity CLI (agy)",
   "github-copilot": "GitHub Copilot",
   "hermes-agent": "Hermes Agent",
   "iflow-cli": "iFlow CLI",
@@ -121,6 +123,8 @@ const displayNameOverrides = {
 export const agentAliases = Object.freeze({
   claude: "claude-code",
   hermes: "hermes-agent",
+  gemini: "gemini-cli",
+  agy: "antigravity-cli",
   "continue-dev": "continue",
 });
 
@@ -165,7 +169,7 @@ const detectionPaths = {
   cursor: ["~/.cursor", ".cursor"],
   devin: ["~/.config/devin"],
   droid: ["~/.factory"],
-  "gemini-cli": ["~/.gemini"],
+  "gemini-cli": ["~/.gemini/skills", "~/.gemini/settings.json"],
   goose: ["~/.config/goose"],
   "hermes-agent": ["~/.hermes"],
   "kiro-cli": ["~/.kiro"],

package/lib/agents.js

@@ -1,7 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
-import readline from "node:readline/promises";
 import {
   agentRegistry,
   detectAgents,
@@ -11,6 +10,11 @@ import {
   supportedAgentIds,
   uniqueProjectSkillDirs,
 } from "./agents-registry.js";
+import {
+  multiselect,
+  isCancel,
+  cancel,
+} from "@clack/prompts";
 
 export const supportedAgents = supportedAgentIds;
 
@@ -117,29 +121,64 @@ export function registryLines() {
   return lines;
 }
 
-export async function chooseAgents(values, yes = false, target = process.cwd()) {
-  if (values.length > 0) return normalizeAgents(values);
+export async function chooseAgents(
+  values,
+  yes = false,
+  target = process.cwd(),
+) {
+  if (values.length > 0) {
+    return normalizeAgents(values);
+  }
 
   const detected = detectAgents({ target });
   const defaults = detected.length > 0 ? detected : ["universal"];
-  if (yes || !process.stdin.isTTY) return defaults;
+
+  if (yes || !process.stdin.isTTY) {
+    return defaults;
+  }
 
   if (detected.length > 0) {
     console.log(`\n감지된 에이전트: ${detected.join(", ")}`);
   } else {
     console.log("\n자동 감지된 에이전트가 없습니다.");
-    console.log("추천: claude-code, codex, cursor, gemini-cli, github-copilot, opencode, windsurf, universal");
   }
-  console.log("쉼표로 복수 선택할 수 있습니다. 전체 목록은 'list', 모두 설치는 'all'입니다.");
 
-  const terminal = readline.createInterface({ input: process.stdin, output: process.stdout });
-  let answer = await terminal.question(`선택 [${defaults.join(",")}]: `);
-  if (answer.trim().toLowerCase() === "list") {
-    console.log(`\n${registryLines().join("\n")}\n`);
-    answer = await terminal.question(`선택 [${defaults.join(",")}]: `);
+  const orderedAgents = [
+    ...defaults,
+    ...supportedAgentIds.filter(
+      (agent) => !defaults.includes(agent),
+    ),
+  ];
+
+  const selected = await multiselect({
+    message: "설치할 에이전트를 선택하세요",
+    options: [
+      {
+        value: "all",
+        label: "모든 에이전트",
+        hint: `${supportedAgentIds.length}개 설치`,
+      },
+      ...orderedAgents.map((agent) => {
+        const entry = agentRegistry[agent];
+        return {
+          value: agent,
+          label: entry?.displayName ?? agent,
+          hint: detected.includes(agent)
+            ? `감지됨 · ${entry?.projectSkillsDir ?? ""}`
+            : entry?.projectSkillsDir,
+        };
+      }),
+    ],
+    initialValues: defaults,
+    required: true,
+  });
+
+  if (isCancel(selected)) {
+    cancel("설치를 취소했습니다.");
+    process.exit(0);
   }
-  terminal.close();
-  return normalizeAgents((answer || defaults.join(",")).split(","));
+
+  return normalizeAgents(selected);
 }
 
 export function configureAgents({ target, agents, force = false, managedFiles = new Set() }) {

package/lib/install.js

@@ -306,6 +306,7 @@ function loadManifest(target) {
 export async function doctor(options) {
   const target = path.resolve(options.target ?? process.cwd());
   const manifest = loadManifest(target);
+  const legacy = legacyArtifacts(target);
   const checks = [
     { label: "Git 저장소", ok: fs.existsSync(path.join(target, ".git")) },
     { label: "설치 manifest", ok: manifest !== null },
@@ -315,7 +316,6 @@ export async function doctor(options) {
     },
     { label: "AGENT.md", ok: fs.existsSync(path.join(target, "AGENT.md")) },
     { label: "skills/", ok: fs.existsSync(path.join(target, "skills")) },
-    { label: "legacy 스킬·자가 진화 상태 없음", ok: legacyArtifacts(target).length === 0 },
     { label: "wiki/index.md", ok: fs.existsSync(path.join(target, "wiki", "index.md")) },
     { label: "raw/", ok: fs.existsSync(path.join(target, "raw")) },
   ];
@@ -326,17 +326,41 @@ export async function doctor(options) {
     );
   }
   checks.push(...agentChecks(target, manifest?.agents ?? []));
-  const result = { ok: checks.every((check) => check.ok), target, version: manifest?.version ?? null, checks };
+  const warnings = legacy.length > 0
+    ? [{
+        code: "legacy-artifacts",
+        message: `이전 설치 잔여물 ${legacy.length}개가 발견되었습니다.`,
+        fix: "정리하려면 project-scaffold add --force를 실행하세요.",
+        paths: legacy,
+      }]
+    : [];
+  const result = {
+    ok: checks.every((check) => check.ok),
+    target,
+    version: manifest?.version ?? null,
+    checks,
+    warnings,
+  };
 
   if (options.json) {
     console.log(JSON.stringify(result, null, 2));
   } else {
     console.log(`project-scaffold doctor\n대상: ${target}\n`);
     for (const check of checks) console.log(`${check.ok ? "✅" : "❌"} ${check.label}`);
+    for (const warning of warnings) {
+      console.log(`⚠️  ${warning.message}`);
+      console.log(`   ${warning.fix}`);
+    }
     if (manifest?.agents?.includes("hermes-agent")) {
       console.log("ℹ️  Hermes는 ~/.hermes/config.yaml의 skills.external_dirs에 프로젝트 skills/ 경로를 등록해야 합니다.");
     }
-    console.log(result.ok ? "\n✅ 설치 상태가 정상입니다." : "\n❌ 누락된 항목을 확인하세요.");
+    if (!result.ok) {
+      console.log("\n❌ 누락된 항목을 확인하세요.");
+    } else if (warnings.length > 0) {
+      console.log("\n✅ 핵심 설치 상태는 정상입니다.");
+    } else {
+      console.log("\n✅ 설치 상태가 정상입니다.");
+    }
   }
   return result;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taejung3852/project-scaffold",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "LLM Wiki-based project context scaffold for AI coding agents",
   "type": "module",
   "bin": {
@@ -23,11 +23,14 @@
     "pack:check": "npm pack --dry-run"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20.12.0"
   },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/taejung3852/project-scaffold.git"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0"
   }
 }