@taejung3852/project-scaffold 0.1.1 → 0.1.3

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}`를 한 번 설치한 뒤 같은 프로젝트 경로를 사용하는 에이전트를 묶어서 상대 심링크를 생성한다. 대화형 선택에서는 `.agents/skills/`를 사용하는 에이전트가 `universal` 공용 그룹 하나로 표시되고, 전용 프로젝트 경로가 필요한 에이전트만 별도 선택지로 표시된다. `--agent`를 생략하면 로컬 설치 흔적을 감지해 후보를 추천하고, 감지하지 못하면 범용 그룹을 기본값으로 사용한다. `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. In the interactive flow, agents that share `.agents/skills/` are selected as one `universal` group; only agents with dedicated project paths appear as separate options. Without `--agent`, it recommends reliably detected local agents and falls back to the universal group 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

@@ -17,6 +17,7 @@ import {
 } from "@clack/prompts";
 
 export const supportedAgents = supportedAgentIds;
+const universalProjectSkillsDir = ".agents/skills";
 
 function writeFileSafely(file, content, force, managedFiles) {
   if (fs.existsSync(file) && !force) return false;
@@ -121,6 +122,53 @@ export function registryLines() {
   return lines;
 }
 
+function isUniversalProjectAgent(agentId) {
+  return agentRegistry[agentId]?.projectSkillsDir === universalProjectSkillsDir;
+}
+
+const universalProjectAgents = supportedAgentIds.filter(isUniversalProjectAgent);
+
+export function buildAgentSelectionOptions(detected = []) {
+  const detectedSet = new Set(detected);
+  const dedicatedAgents = supportedAgentIds.filter((agent) => !isUniversalProjectAgent(agent));
+  const universalNames = universalProjectAgents
+    .map((agent) => agentRegistry[agent]?.displayName ?? agent)
+    .filter(Boolean);
+  const previewNames = universalNames.slice(0, 4).join(", ");
+
+  return [
+    {
+      value: "all",
+      label: "모든 에이전트",
+      hint: `${supportedAgentIds.length}개 설치`,
+    },
+    {
+      value: "universal",
+      label: "공용 Agent Skills",
+      hint: `${universalProjectSkillsDir} · ${previewNames} 등 ${universalNames.length}개`,
+    },
+    ...dedicatedAgents.map((agent) => {
+      const entry = agentRegistry[agent];
+      return {
+        value: agent,
+        label: entry?.displayName ?? agent,
+        hint: detectedSet.has(agent)
+          ? `감지됨 · ${entry?.projectSkillsDir ?? ""}`
+          : entry?.projectSkillsDir,
+      };
+    }),
+  ];
+}
+
+export function buildAgentSelectionDefaults(detected = []) {
+  const detectedUniversal = detected.some(isUniversalProjectAgent);
+  const dedicatedDetected = detected.filter((agent) => !isUniversalProjectAgent(agent));
+  return [
+    ...(detectedUniversal || detected.length === 0 ? ["universal"] : []),
+    ...dedicatedDetected,
+  ];
+}
+
 export async function chooseAgents(
   values,
   yes = false,
@@ -131,35 +179,24 @@ export async function chooseAgents(
   }
 
   const detected = detectAgents({ target });
-  const defaults = detected.length > 0 ? detected : ["universal"];
+  const defaults = buildAgentSelectionDefaults(detected);
 
   if (yes || !process.stdin.isTTY) {
     return defaults;
   }
 
   if (detected.length > 0) {
-    console.log(`\n감지된 에이전트: ${detected.join(", ")}`);
+    const detectedLabels = detected.map((agent) => agentRegistry[agent]?.displayName ?? agent);
+    console.log(`\n감지된 에이전트: ${detectedLabels.join(", ")}`);
   } else {
     console.log("\n자동 감지된 에이전트가 없습니다.");
   }
 
-  const orderedAgents = [
-    ...defaults,
-    ...supportedAgentIds.filter(
-      (agent) => !defaults.includes(agent),
-    ),
-  ];
-
   const selected = await multiselect({
-    message: "설치할 에이전트를 선택하세요",
-    options: orderedAgents.map((agent) => ({
-      value: agent,
-      label: agent,
-      hint: detected.includes(agent) ? "감지됨" : undefined,
-    })),
+    message: "설치할 스킬 경로를 선택하세요",
+    options: buildAgentSelectionOptions(detected),
     initialValues: defaults,
     required: true,
-    maxItems: 10,
   });
 
   if (isCancel(selected)) {

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.1",
+  "version": "0.1.3",
   "description": "LLM Wiki-based project context scaffold for AI coding agents",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "pack:check": "npm pack --dry-run"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20.12.0"
   },
   "license": "MIT",
   "repository": {