bmad-setup 1.8.0 → 1.8.2

package/README.md

@@ -1,21 +1,21 @@
 # BMAD Framework Submodule
 
-![Version](https://img.shields.io/badge/version-1.5.0-blue.svg)
+![Version](https://img.shields.io/badge/version-1.8.1-blue.svg)
 ![npm](https://img.shields.io/npm/v/bmad-setup.svg)
-![BMAD](https://img.shields.io/badge/BMAD-6.0.0--beta.8-orange.svg)
+![BMAD](https://img.shields.io/badge/BMAD-6.0.4-orange.svg)
 ![License](https://img.shields.io/badge/license-MIT-green.svg)
 ![Claude Code](https://img.shields.io/badge/Claude%20Code-only-purple.svg)
 
 BMAD 프레임워크를 Git Submodule로 관리하여 **팀별, 프로젝트별로 간편하게 커스터마이징**할 수 있는 세팅 도구입니다.
 
-한 줄 설치(`npx bmad-setup`)로 에이전트, 워크플로우, 지식 베이스를 프로젝트에 즉시 적용하고, 필요한 모듈만 골라 사용할 수 있습니다.
+한 줄 설치(`npx bmad-setup@latest`)로 에이전트, 워크플로우, 지식 베이스를 프로젝트에 즉시 적용하고, 필요한 모듈만 골라 사용할 수 있습니다.
 
 > **Claude Code 전용** — 슬래시 커맨드 및 에이전트 시스템이 Claude Code의 커맨드 구조에 맞춰 설계되어 있습니다.
 
 | 항목              | 버전         |
 | ----------------- | ------------ |
-| Submodule Version | v1.5.0       |
-| BMAD Framework    | 6.0.0-beta.8 |
+| Submodule Version | v1.8.1 |
+| BMAD Framework    | 6.0.4  |
 
 > [Changelog](./CHANGELOG.md)에서 변경 이력을 확인하세요.
 
@@ -53,7 +53,7 @@ BMAD 프레임워크 원본은 범용으로 설계되어 있습니다. 이 서
 | PR 크기   | 300개 이상 파일 변경      | 2개 파일만 변경           |
 | 업데이트  | 각 프로젝트마다 수동 복사 | `git pull` 한 번으로 해결 |
 | 버전 관리 | 어떤 버전인지 추적 어려움 | 커밋 SHA로 정확한 버전 추적 |
-| 설치      | 수동 복사                 | `npx bmad-setup` 한 줄    |
+| 설치      | 수동 복사                 | `npx bmad-setup@latest` 한 줄 |
 
 프레임워크 원본이 업데이트되더라도, 커스터마이징한 설정은 프로젝트에 그대로 유지됩니다.
 
@@ -78,7 +78,7 @@ BMAD 프레임워크 원본은 범용으로 설계되어 있습니다. 이 서
 ### 설치
 
 ```bash
-npx bmad-setup
+npx bmad-setup@latest
 ```
 
 자동으로 수행되는 작업:
@@ -86,18 +86,20 @@ npx bmad-setup
 1. `bmad-submodule` Git Submodule 추가 및 초기화
 2. `.gitmodules`에 `ignore = dirty` 설정
 3. `install.sh` 실행 (심볼릭 링크 생성)
-4. `.gitignore`에 BMAD 항목 추가
-5. `package.json`에 postinstall / bmad:install / bmad:uninstall 스크립트 추가
+4. `post-checkout` hook 설치 (worktree 자동 지원)
+5. `.gitignore`에 BMAD 항목 추가
+6. `package.json`에 postinstall / bmad:install / bmad:uninstall 스크립트 추가
 
 > 이미 설치된 항목은 자동으로 스킵됩니다 (멱등성 보장).
+> Git worktree 환경에서는 자동 감지되어 submodule 초기화 + 심링크만 실행됩니다.
 
 ### 업데이트
 
 ```bash
-npx bmad-setup --update
+npx bmad-setup@latest --update
 ```
 
-Submodule을 최신 버전으로 pull하고 심볼릭 링크를 갱신합니다.
+Submodule을 최신 버전으로 fetch하고, 부모 repo 참조를 갱신하고, 심볼릭 링크를 재생성합니다.
 
 ### 동작 확인
 
@@ -150,7 +152,7 @@ bmad-submodule/
 
 ## 수동 설치
 
-`npx bmad-setup` 대신 직접 설치하려면 아래 단계를 따르세요.
+`npx bmad-setup@latest` 대신 직접 설치하려면 아래 단계를 따르세요.
 
 ### 1단계: Submodule 추가
 
@@ -180,9 +182,9 @@ git config -f .gitmodules submodule.bmad-submodule.ignore dirty
 ```json
 {
   "scripts": {
-    "postinstall": "[ -z \"$CI\" ] && git submodule update --init --recursive && git -C bmad-submodule pull origin master && ./bmad-submodule/install.sh || true",
-    "bmad:install": "./bmad-submodule/install.sh",
-    "bmad:uninstall": "./bmad-submodule/uninstall.sh"
+    "postinstall": "[ -z \"$CI\" ] && git -C bmad-submodule fetch origin master && git -C bmad-submodule checkout origin/master && git add bmad-submodule && ./bmad-submodule/install.sh \"$(pwd)\" || true",
+    "bmad:install": "./bmad-submodule/install.sh \"$(pwd)\"",
+    "bmad:uninstall": "./bmad-submodule/uninstall.sh \"$(pwd)\""
   }
 }
 ```

package/bin/cli.js

@@ -3,6 +3,7 @@
 'use strict';
 
 const { execSync, execFileSync } = require('child_process');
+const https = require('https');
 const fs = require('fs');
 const path = require('path');
 
@@ -53,10 +54,10 @@ bmad-setup v${VERSION}
 BMAD Framework 서브모듈을 한 줄로 설치합니다.
 
 Usage:
-  npx bmad-setup            전체 설치 실행 (worktree 자동 감지)
-  npx bmad-setup --update   서브모듈 최신화 + 심링크 재생성 + 부모 참조 갱신
-  npx bmad-setup --help     도움말 표시
-  npx bmad-setup --version  버전 표시
+  npx bmad-setup@latest            전체 설치 실행 (worktree 자동 감지)
+  npx bmad-setup@latest --update   서브모듈 최신화 + 심링크 재생성 + 부모 참조 갱신
+  npx bmad-setup@latest --help     도움말 표시
+  npx bmad-setup@latest --version  버전 표시
 
 Install steps:
   1. git submodule add (bmad-submodule)
@@ -83,6 +84,39 @@ Requirements:
   }
 }
 
+// --- Version check against npm registry ---
+function checkLatestVersion() {
+  return new Promise((resolve) => {
+    const req = https.get(
+      'https://registry.npmjs.org/bmad-setup/latest',
+      { timeout: 3000 },
+      (res) => {
+        let data = '';
+        res.on('data', (chunk) => (data += chunk));
+        res.on('end', () => {
+          try {
+            const latest = JSON.parse(data).version;
+            if (latest && latest !== VERSION) {
+              console.log('');
+              log('\u26a0', `새 버전이 있습니다: v${latest} (현재: v${VERSION})`);
+              log('', '  최신 버전으로 실행하세요: npx bmad-setup@latest');
+              console.log('');
+            }
+          } catch (e) {
+            // ignore parse errors
+          }
+          resolve();
+        });
+      },
+    );
+    req.on('error', () => resolve());
+    req.on('timeout', () => {
+      req.destroy();
+      resolve();
+    });
+  });
+}
+
 // --- Step 0: Pre-validation ---
 function validateGitRepo() {
   try {
@@ -136,7 +170,7 @@ function isWorktree() {
 // --- Update mode ---
 function pullLatest() {
   if (!fs.existsSync(SUBMODULE_DIR)) {
-    log('  \u274c', `${SUBMODULE_DIR}/ 디렉토리가 없습니다. 먼저 \`npx bmad-setup\`으로 설치하세요.`);
+    log('  \u274c', `${SUBMODULE_DIR}/ 디렉토리가 없습니다. 먼저 \`npx bmad-setup@latest\`으로 설치하세요.`);
     process.exit(1);
   }
   runSafe(`git -C ${SUBMODULE_DIR} fetch origin master`, 'Submodule fetch');
@@ -354,9 +388,11 @@ function patchPackageJson() {
 }
 
 // --- Main ---
-function main() {
+async function main() {
   handleFlags();
 
+  await checkLatestVersion();
+
   validateGitRepo();
   validateGitVersion();
 
@@ -441,4 +477,7 @@ function runSteps(steps, doneMessage) {
   console.log('');
 }
 
-main();
+main().catch((e) => {
+  log('\u274c', e.message);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-setup",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "BMAD Framework submodule installer - one command setup",
   "bin": {
     "bmad-setup": "bin/cli.js"