@elyun/bylane 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyun/bylane",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Frontend development harness for Claude Code",
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
   "scripts": {
     "monitor": "node src/monitor/index.js",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "release": "bash scripts/release.sh"
   },
   "dependencies": {
     "blessed": "^0.1.81",

package/scripts/release.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+set -e
+
+FORCE_RELEASE=false
+for arg in "$@"; do
+  [ "$arg" = "--force-release" ] && FORCE_RELEASE=true
+done
+# npm run release --force-release 방식 지원 (npm_config_* 환경변수)
+[ -n "$npm_config_force_release" ] && FORCE_RELEASE=true
+
+echo "byLane 릴리즈 시작..."
+
+# 작업 디렉토리 클린 확인 (--force-release 시 건너뜀)
+if [ "$FORCE_RELEASE" = false ] && [ -n "$(git status --short)" ]; then
+  echo "오류: 커밋되지 않은 변경사항이 있습니다. 먼저 커밋하거나 --force-release 를 사용하세요."
+  git status --short
+  exit 1
+fi
+
+# 테스트 실행
+echo "테스트 실행 중..."
+npm test
+
+if [ "$FORCE_RELEASE" = true ]; then
+  # 현재 package.json 버전 그대로 사용
+  NEW_VERSION="v$(node -p "require('./package.json').version")"
+  echo "현재 버전으로 배포: $NEW_VERSION"
+
+  # 태그가 없으면 생성
+  if ! git tag | grep -q "^$NEW_VERSION$"; then
+    git tag "$NEW_VERSION"
+    git push origin "$NEW_VERSION"
+    echo "태그 생성: $NEW_VERSION"
+  else
+    echo "태그 이미 존재: $NEW_VERSION"
+  fi
+else
+  # 마이너 버전 올리기
+  echo "버전 올리는 중..."
+  NEW_VERSION=$(npm version minor --no-git-tag-version)
+  echo "새 버전: $NEW_VERSION"
+
+  # package-lock.json 업데이트
+  npm install --package-lock-only 2>/dev/null || true
+
+  # 커밋 + 태그
+  git add package.json package-lock.json
+  git commit -m "chore: release $NEW_VERSION"
+  git tag "$NEW_VERSION"
+
+  # GitHub 푸시
+  echo "GitHub 푸시 중..."
+  git push origin main --tags
+fi
+
+# npm 배포 (2FA 필요 시 프롬프트)
+echo "npm 배포 중... (2FA 코드가 필요할 수 있습니다)"
+npm publish --access public
+
+echo ""
+echo "릴리즈 완료: $NEW_VERSION"
+echo "https://www.npmjs.com/package/@elyun/bylane"

package/skills/issue-agent.md

@@ -5,6 +5,17 @@ description: GitHub Issue 생성 및 분석. Figma 링크 감지 시 스펙 추
 
 # Issue Agent
 
+## GitHub 접근 방법
+
+`.bylane/bylane.json`의 `github.method` 확인:
+
+| 값 | 동작 |
+|----|------|
+| `"mcp"` | GitHub MCP 도구 사용 |
+| `"cli"` | `gh` CLI 사용 |
+| `"api"` | REST API + `$GITHUB_TOKEN` |
+| `"auto"` (기본) | MCP → CLI → API 순서로 시도 |
+
 ## 입력
 
 - 자유 텍스트 (새 이슈 생성용) OR GitHub Issue 번호 (#N)
@@ -13,44 +24,65 @@ description: GitHub Issue 생성 및 분석. Figma 링크 감지 시 스펙 추
 
 ### 새 이슈 생성 모드 (텍스트 입력)
 
-1. 입력 텍스트에서 다음을 추출:
-   - 제목 (50자 이내)
-   - 상세 설명
-   - 구현 체크리스트 (예상 가능한 경우)
-   - Figma URL (있는 경우)
+1. 입력 텍스트에서 추출:
+   - 제목 (50자 이내), 상세 설명, 구현 체크리스트, Figma URL
+
+2. 이슈 생성:
+
+   **MCP:**
+   → GitHub MCP `create_issue` 도구 사용
+
+   **CLI:**
+   ```bash
+   gh issue create \
+     --title "TITLE" \
+     --body "BODY" \
+     --label "bylane-auto"
+   ```
 
-2. GitHub MCP로 이슈 생성:
-   - `title`: 추출된 제목
-   - `body`: Markdown 형식 설명 + 체크리스트
-   - `labels`: `bylane-auto` 라벨 추가 (라벨이 없으면 생성)
+   **API:**
+   ```bash
+   curl -s -X POST \
+     -H "Authorization: Bearer $GITHUB_TOKEN" \
+     -H "Content-Type: application/json" \
+     https://api.github.com/repos/OWNER/REPO/issues \
+     -d '{"title":"TITLE","body":"BODY","labels":["bylane-auto"]}'
+   ```
 
-3. Figma MCP 활성화 여부 확인 (`.bylane/bylane.json` → `extensions.figma.enabled`):
-   - `true`이고 Figma URL이 있으면 → **Figma 분석** 단계 실행
-   - `false`이면 → 텍스트 기반 스펙만 생성
+3. Figma MCP 활성화 여부 확인 (`extensions.figma.enabled`):
+   - `true`이고 Figma URL 있으면 → Figma 분석 단계 실행
+   - `false` → 텍스트 기반 스펙만 생성
 
 ### 기존 이슈 분석 모드 (Issue 번호 입력)
 
-1. GitHub MCP로 이슈 내용 로드
-2. 본문에서 Figma URL 추출 시도
-3. 스펙 생성 (아래 참조)
+1. 이슈 내용 로드:
 
-### Figma 분석 (활성화된 경우)
+   **MCP:**
+   → GitHub MCP `get_issue` 도구 사용
+
+   **CLI:**
+   ```bash
+   gh issue view NUMBER --json title,body,labels
+   ```
+
+   **API:**
+   ```bash
+   curl -s \
+     -H "Authorization: Bearer $GITHUB_TOKEN" \
+     https://api.github.com/repos/OWNER/REPO/issues/NUMBER
+   ```
 
-Figma MCP `get_file` 또는 `get_node` 도구로 해당 프레임/컴포넌트 분석:
-- 컴포넌트 계층 구조
-- 색상 토큰
-- 타이포그래피
-- 스페이싱 값
+2. 본문에서 Figma URL 추출 시도 후 스펙 생성
+
+### Figma 분석 (활성화된 경우)
 
-추출 결과를 스펙에 포함.
+Figma MCP `get_file` 또는 `get_node` 도구로 프레임/컴포넌트 분석.
 
-**Figma 분석 실패 시 fallback:**
-- MCP 미설치 또는 URL 유효하지 않은 경우: 경고 로그 기록 후 텍스트 기반 스펙만 사용
-- `figmaSpec.enabled = false`로 출력
+**실패 시 fallback:** 경고 로그 후 텍스트 기반 스펙 사용
 
-## 출력: 구현 스펙
+## 출력
 
-`.bylane/state/issue-agent.json`에 저장:
+`.bylane/state/issue-agent.json`:
 
 ```json
 {
@@ -63,27 +95,14 @@ Figma MCP `get_file` 또는 `get_node` 도구로 해당 프레임/컴포넌트
     "title": "다크모드 토글 버튼 추가",
     "description": "...",
     "checklist": ["ThemeToggle 컴포넌트 생성", "useTheme hook 구현"],
-    "figmaSpec": {
-      "enabled": false,
-      "components": [],
-      "colorTokens": {}
-    }
+    "figmaSpec": { "enabled": false, "components": [], "colorTokens": {} }
   }
 }
 ```
 
 상태 기록:
 ```bash
-node -e "
-import('./src/state.js').then(({writeState, appendLog}) => {
-  writeState('issue-agent', {
-    status: 'in_progress',
-    startedAt: new Date().toISOString(),
-    progress: 0,
-    retries: 0
-  })
-})
-"
+node -e "import('./src/state.js').then(({writeState})=>writeState('issue-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0}))"
 ```
 
 ## 수동 실행

package/skills/pr-agent.md

@@ -5,6 +5,17 @@ description: 현재 브랜치의 커밋들로 GitHub Pull Request를 생성한
 
 # PR Agent
 
+## GitHub 접근 방법
+
+`.bylane/bylane.json`의 `github.method` 확인:
+
+| 값 | 동작 |
+|----|------|
+| `"mcp"` | GitHub MCP 도구 사용 |
+| `"cli"` | `gh` CLI 사용 |
+| `"api"` | REST API + `$GITHUB_TOKEN` |
+| `"auto"` (기본) | MCP → CLI → API 순서로 시도 |
+
 ## 입력
 
 - `.bylane/state/commit-agent.json`의 `branchName`, `commitSha`
@@ -23,36 +34,44 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('pr-agent',{st
    git push -u origin BRANCH_NAME
    ```
 
-2. PR 제목/본문 생성:
-   - 제목: 스펙 제목 (70자 이내)
-   - 본문:
-     ```
-     ## Summary
-     - [변경 요약]
+2. PR 본문 생성:
+   ```
+   ## Summary
+   - [변경 요약]
+
+   ## Test Plan
+   - [ ] 변경된 기능 동작 확인
+   - [ ] 기존 테스트 통과 확인
+
+   Closes #ISSUE_NUMBER
+   ```
+
+3. PR 생성:
 
-     ## Test Plan
-     - [ ] 변경된 기능 동작 확인
-     - [ ] 기존 테스트 통과 확인
+   **MCP:**
+   → GitHub MCP `create_pull_request` 도구 사용
 
-     Closes #ISSUE_NUMBER
-     ```
+   **CLI:**
+   ```bash
+   gh pr create \
+     --title "TITLE" \
+     --body "BODY" \
+     --head BRANCH_NAME \
+     --base main
+   ```
 
-3. GitHub MCP로 PR 생성:
-   - `title`: 생성된 제목
-   - `body`: 생성된 본문
-   - `head`: 현재 브랜치명
-   - `base`: main
+   **API:**
+   ```bash
+   curl -s -X POST \
+     -H "Authorization: Bearer $GITHUB_TOKEN" \
+     -H "Content-Type: application/json" \
+     https://api.github.com/repos/OWNER/REPO/pulls \
+     -d '{"title":"TITLE","body":"BODY","head":"BRANCH_NAME","base":"main"}'
+   ```
 
 4. 상태 업데이트:
    ```bash
-   node -e "
-   import('./src/state.js').then(({writeState})=>writeState('pr-agent',{
-     status:'completed',
-     progress:100,
-     prNumber:'PR_NUMBER',
-     prUrl:'PR_URL'
-   }))
-   "
+   node -e "import('./src/state.js').then(({writeState})=>writeState('pr-agent',{status:'completed',progress:100,prNumber:PR_NUMBER,prUrl:'PR_URL'}))"
    ```
 
 ## 출력

package/skills/respond-agent.md

@@ -5,6 +5,17 @@ description: PR 리뷰 코멘트에 반박하거나 코드를 수정하여 반
 
 # Respond Agent
 
+## GitHub 접근 방법
+
+`.bylane/bylane.json`의 `github.method` 확인:
+
+| 값 | 동작 |
+|----|------|
+| `"mcp"` | GitHub MCP 도구 사용 |
+| `"cli"` | `gh` CLI 사용 |
+| `"api"` | REST API + `$GITHUB_TOKEN` |
+| `"auto"` (기본) | MCP → CLI → API 순서로 시도 |
+
 ## 입력
 
 - PR 번호
@@ -18,23 +29,55 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('respond-agent
 
 ## 실행 흐름
 
+### 리뷰 코멘트 로드
+
+**MCP:**
+→ GitHub MCP `list_review_comments` 도구 사용
+
+**CLI:**
+```bash
+gh pr view PR_NUMBER --json reviews,comments
+```
+
+**API:**
+```bash
+curl -s \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/comments
+```
+
 ### accept 모드
 
-1. GitHub MCP로 미해결 리뷰 코멘트 로드
-2. 각 코멘트별 수정 사항 결정
-3. 코드 수정 (code-agent 서브 실행)
-4. test-agent로 검증
-5. commit-agent로 수정 커밋 (`fix: address review comments`)
-6. GitHub MCP로 각 코멘트에 "반영 완료" 답글 작성
+1. 각 코멘트별 수정 사항 결정
+2. 코드 수정 (code-agent 서브 실행)
+3. test-agent로 검증
+4. commit-agent로 수정 커밋 (`fix: address review comments`)
+5. 코멘트에 "반영 완료" 답글 게시:
+
+   **MCP:**
+   → GitHub MCP `create_review_comment_reply` 도구 사용
+
+   **CLI:**
+   ```bash
+   gh pr comment PR_NUMBER --body "REPLY_BODY"
+   ```
+
+   **API:**
+   ```bash
+   curl -s -X POST \
+     -H "Authorization: Bearer $GITHUB_TOKEN" \
+     -H "Content-Type: application/json" \
+     https://api.github.com/repos/OWNER/REPO/issues/PR_NUMBER/comments \
+     -d '{"body":"REPLY_BODY"}'
+   ```
 
 ### rebut 모드
 
-1. GitHub MCP로 미해결 리뷰 코멘트 로드
-2. 각 코멘트에 대해 근거를 기술한 반박 답글 작성:
-   - 의도적 설계 결정인 경우: 배경 설명
-   - 성능 트레이드오프: 구체적 수치 근거 제시
+1. 각 코멘트에 근거를 기술한 반박 답글 작성:
+   - 의도적 설계 결정: 배경 설명
+   - 성능 트레이드오프: 구체적 수치 근거
    - 스펙 요구사항과 일치하는 경우: 이슈 링크 첨부
-3. GitHub MCP로 반박 답글 게시
+2. 위와 동일한 방법으로 답글 게시
 
 ## 출력
 

package/skills/review-agent.md

@@ -5,6 +5,17 @@ description: PR의 diff를 분석하여 코드 리뷰 코멘트를 작성한다.
 
 # Review Agent
 
+## GitHub 접근 방법
+
+`.bylane/bylane.json`의 `github.method` 확인:
+
+| 값 | 동작 |
+|----|------|
+| `"mcp"` | GitHub MCP 도구 사용 |
+| `"cli"` | `gh` CLI 사용 |
+| `"api"` | REST API + `$GITHUB_TOKEN` |
+| `"auto"` (기본) | MCP → CLI → API 순서로 시도 |
+
 ## 입력
 
 PR 번호 (`.bylane/state/pr-agent.json`에서 자동 로드, 또는 수동 전달)
@@ -17,7 +28,25 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent'
 
 ## 실행 흐름
 
-1. GitHub MCP로 PR diff 로드
+1. PR diff 로드:
+
+   **MCP:**
+   → GitHub MCP `get_pull_request_files` 도구 사용
+
+   **CLI:**
+   ```bash
+   gh pr diff PR_NUMBER
+   # 파일 목록
+   gh pr view PR_NUMBER --json files
+   ```
+
+   **API:**
+   ```bash
+   curl -s \
+     -H "Authorization: Bearer $GITHUB_TOKEN" \
+     https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/files
+   ```
+
 2. 변경된 파일별 분석:
    - 버그 가능성 (null check, 경계값 등)
    - 타입 오류 (TypeScript)
@@ -31,20 +60,33 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent'
    - **MEDIUM**: 개선 권장
    - **LOW**: 선택적 개선
 
-4. GitHub MCP로 리뷰 제출:
-   - CRITICAL/HIGH 없으면 → `approve`
-   - CRITICAL/HIGH 있으면 → `request_changes`
+4. 리뷰 제출:
+
+   **MCP:**
+   → GitHub MCP `create_review` 도구 사용 (event: `APPROVE` 또는 `REQUEST_CHANGES`)
+
+   **CLI:**
+   ```bash
+   # 승인
+   gh pr review PR_NUMBER --approve --body "REVIEW_BODY"
+   # 변경 요청
+   gh pr review PR_NUMBER --request-changes --body "REVIEW_BODY"
+   # 개별 라인 코멘트
+   gh pr comment PR_NUMBER --body "COMMENT"
+   ```
+
+   **API:**
+   ```bash
+   curl -s -X POST \
+     -H "Authorization: Bearer $GITHUB_TOKEN" \
+     -H "Content-Type: application/json" \
+     https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/reviews \
+     -d '{"body":"REVIEW_BODY","event":"APPROVE","comments":[]}'
+   ```
 
 5. 상태 업데이트:
    ```bash
-   node -e "
-   import('./src/state.js').then(({writeState})=>writeState('review-agent',{
-     status:'completed',
-     progress:100,
-     approved:APPROVED_BOOL,
-     commentCount:COMMENT_COUNT
-   }))
-   "
+   node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'completed',progress:100,approved:APPROVED_BOOL,commentCount:COMMENT_COUNT}))"
    ```
 
 ## 출력

package/skills/setup.md

@@ -17,6 +17,28 @@ ALWAYS complete all 6 steps before saving. NEVER skip steps.
 
 2. 기존 bylane.json 있으면 현재 설정을 로드해 기본값으로 사용.
 
+## Step 0/6 — GitHub 접근 방법
+
+사용 가능한 방법을 자동 감지한 뒤 사용자에게 확인한다:
+
+```bash
+# MCP 확인: Claude Code 세션에서 GitHub MCP 도구 응답 여부
+# CLI 확인
+gh auth status 2>/dev/null && echo "cli_ok"
+# API 확인
+echo ${GITHUB_TOKEN:+api_ok}
+```
+
+> GitHub 접근 방법을 선택하세요:
+> 1. auto  — MCP → CLI → API 순서로 자동 시도 (권장)
+> 2. mcp   — GitHub MCP 도구만 사용
+> 3. cli   — gh CLI만 사용
+> 4. api   — REST API + GITHUB_TOKEN만 사용
+
+`github.method`에 저장. `cli` 또는 `api` 선택 시 추가 입력:
+- `cli`: `gh repo view`로 owner/repo 자동 감지, 실패 시 직접 입력
+- `api`: `GITHUB_TOKEN` 환경변수명 확인, owner/repo 입력
+
 ## Step 1/6 — 이슈 트래커
 
 사용자에게 묻는다:

package/src/config.js

@@ -34,6 +34,11 @@ export const DEFAULT_CONFIG = {
   },
   extensions: {
     figma: { enabled: false, useAt: 'issue-analysis' }
+  },
+  github: {
+    method: 'auto',
+    owner: '',
+    repo: ''
   }
 }