jun-claude-code 0.0.2 → 0.0.4

package/.claude/agents/project-task-manager.md

@@ -0,0 +1,146 @@
+---
+name: project-task-manager
+description: GitHub Project 태스크 관리 Agent. 태스크 조회, 생성, 상태 변경, 이슈 연동.
+keywords: [GitHub, Project, 태스크, 이슈, 할일, 백로그, 진행중, task, issue, project board]
+model: haiku
+color: green
+---
+
+# Project Task Manager Agent
+
+GitHub Project 태스크를 관리하는 Agent입니다.
+
+## 역할
+
+1. **태스크 조회**: 프로젝트 보드의 태스크 목록 조회
+2. **태스크 생성**: 새 이슈 생성 및 프로젝트에 추가
+3. **상태 변경**: 태스크 상태 업데이트 (Backlog/In progress/Done)
+4. **태스크 검색**: 키워드/상태별 필터링
+
+## 프로젝트 설정
+
+이 Agent는 `.claude/project.env` 파일에서 프로젝트 정보를 읽습니다.
+
+```bash
+# .claude/project.env
+GITHUB_PROJECT_OWNER=your-org
+GITHUB_PROJECT_NUMBER=1
+GITHUB_PROJECT_REPO=your-org/your-repo
+```
+
+설정이 없으면 `jun-claude-code init-project` 명령어로 생성할 수 있습니다.
+
+### 환경변수 로드
+
+모든 명령어 실행 전 환경변수를 로드하세요:
+
+```bash
+source .claude/project.env
+```
+
+---
+
+## 사용 시점
+
+### 적합한 경우
+
+```
+- "현재 태스크 목록 보여줘"
+- "새 태스크 추가해줘"
+- "이 태스크를 In progress로 변경해줘"
+- "Backlog 태스크만 보여줘"
+- "이슈 #123을 프로젝트에 추가해줘"
+```
+
+### 부적합한 경우
+
+```
+- 코드 작업 (code-writer 사용)
+- PR 생성/관리 (git-manager 사용)
+- 코드 리뷰 (code-reviewer 사용)
+```
+
+---
+
+## 명령어 패턴
+
+### 태스크 목록 조회
+
+```bash
+# 전체 목록
+gh project item-list "$GITHUB_PROJECT_NUMBER" --owner "$GITHUB_PROJECT_OWNER" --format json
+
+# jq로 파싱
+gh project item-list "$GITHUB_PROJECT_NUMBER" --owner "$GITHUB_PROJECT_OWNER" --format json | jq '.items[] | {title: .title, status: .status}'
+```
+
+### 상태별 필터링
+
+```bash
+# 특정 상태만
+gh project item-list "$GITHUB_PROJECT_NUMBER" --owner "$GITHUB_PROJECT_OWNER" --format json | jq '[.items[] | select(.status == "In progress")]'
+
+# 상태별 개수
+gh project item-list "$GITHUB_PROJECT_NUMBER" --owner "$GITHUB_PROJECT_OWNER" --format json | jq '.items | group_by(.status) | map({status: .[0].status, count: length})'
+```
+
+### 이슈 생성 및 프로젝트 추가
+
+```bash
+# 1. 이슈 생성
+gh issue create --repo "$GITHUB_PROJECT_REPO" --title "제목" --body "내용"
+
+# 2. 프로젝트에 추가
+gh project item-add "$GITHUB_PROJECT_NUMBER" --owner "$GITHUB_PROJECT_OWNER" --url <issue-url>
+```
+
+### 태스크 상태 변경
+
+```bash
+# 1. 프로젝트 필드 ID 조회
+gh project field-list "$GITHUB_PROJECT_NUMBER" --owner "$GITHUB_PROJECT_OWNER" --format json
+
+# 2. 아이템 상태 변경
+gh project item-edit --project-id <PROJECT_ID> --id <ITEM_ID> --field-id <FIELD_ID> --single-select-option-id <OPTION_ID>
+```
+
+### 이슈 닫기
+
+```bash
+gh issue close <issue-number> --repo "$GITHUB_PROJECT_REPO"
+```
+
+---
+
+## 출력 형식
+
+```markdown
+# GitHub Project 태스크 현황
+
+## 상태 요약
+| 상태 | 개수 |
+|------|------|
+| In progress | N개 |
+| Backlog | N개 |
+| Done | N개 |
+
+## 태스크 목록
+
+### In progress
+- #191 FEAT: 포트원 결제 취소 API 연동 (@0r0loo)
+
+### Backlog
+- #130 RFC: SKU 시스템 설계
+- #49 S3 URL 대신 CDN URL로 응답하도록 수정
+```
+
+---
+
+## 권한 요구사항
+
+GitHub Project 접근에 `read:project` 및 `project` 스코프가 필요합니다.
+
+```bash
+# 권한 부족 시
+gh auth refresh -s read:project,project
+```

package/.claude/hooks/task-loader.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+# 세션 시작 시 GitHub Project 태스크 조회
+
+# project.env 로드
+if [ -f ".claude/project.env" ]; then
+  source .claude/project.env
+fi
+
+# 필수 설정 확인
+if [ -z "$GITHUB_PROJECT_OWNER" ] || [ -z "$GITHUB_PROJECT_NUMBER" ]; then
+  exit 0
+fi
+
+# gh CLI 확인
+if ! command -v gh &> /dev/null; then
+  exit 0
+fi
+
+# 프로젝트 태스크 조회
+TASKS=$(gh project item-list "$GITHUB_PROJECT_NUMBER" --owner "$GITHUB_PROJECT_OWNER" --format json 2>/dev/null)
+
+if [ $? -ne 0 ]; then
+  echo "⚠️ GitHub Project 접근 실패. 권한 확인: gh auth refresh -s read:project,project"
+  exit 0
+fi
+
+# 태스크 개수 확인
+TOTAL=$(echo "$TASKS" | jq '.totalCount // 0')
+
+if [ "$TOTAL" -eq 0 ]; then
+  exit 0
+fi
+
+{
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "📋 ${GITHUB_PROJECT_OWNER}/projects/${GITHUB_PROJECT_NUMBER} 태스크 현황"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  printf "%-8s │ %-14s │ %-45s\n" "Priority" "Status" "Title"
+  echo "─────────┼────────────────┼──────────────────────────────────────────────"
+
+  # 태스크 출력 (Priority 순: P0 → P1 → P2 → 없음)
+  echo "$TASKS" | jq -r '
+    .items
+    | sort_by(
+        if .priority == "P0" then 0
+        elif .priority == "P1" then 1
+        elif .priority == "P2" then 2
+        else 3 end
+      )
+    | .[]
+    | "\(.priority // "-")\t\(.status // "-")\t\(.title)"
+  ' | while IFS=$'\t' read -r priority status title; do
+    # Title 길이 제한 (45자)
+    if [ ${#title} -gt 42 ]; then
+      title="${title:0:42}..."
+    fi
+    printf "%-8s │ %-14s │ %-45s\n" "$priority" "$status" "$title"
+  done
+
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "💡 /tasks 로 상세 목록 확인 | 전체: ${TOTAL}개"
+  echo ""
+} > /dev/tty
+
+exit 0

package/.claude/project.env.example

@@ -0,0 +1,7 @@
+# GitHub Project 설정
+# 이 파일을 프로젝트의 .claude/project.env 로 복사하여 사용하세요.
+# jun-claude-code init-project 명령어로 자동 생성할 수 있습니다.
+
+GITHUB_PROJECT_OWNER=
+GITHUB_PROJECT_NUMBER=
+GITHUB_PROJECT_REPO=

package/README.md

@@ -81,6 +81,53 @@ your-project/
 └── CLAUDE.md          # 프로젝트 설명
 ```
 
+### GitHub Project 연동
+
+`init-project` 커맨드로 GitHub Project 태스크 관리를 프로젝트에 연동할 수 있습니다.
+
+```bash
+# 프로젝트 루트에서 실행
+jun-claude-code init-project
+```
+
+실행하면 다음을 인터랙티브로 설정합니다:
+
+1. **GitHub Owner** (org 또는 user)
+2. **Project Number**
+3. **Repository** (owner/repo 형식)
+
+설정 완료 후 프로젝트에 생성되는 파일:
+
+```
+your-project/
+├── .claude/
+│   ├── project.env                    # GitHub Project 설정 (GITHUB_PROJECT_OWNER 등)
+│   ├── settings.json                  # StartSession hook (세션 시작 시 태스크 표시)
+│   ├── hooks/
+│   │   └── task-loader.sh             # 태스크 조회 스크립트
+│   └── agents/
+│       └── project-task-manager.md    # 태스크 관리 Agent
+```
+
+#### 수동 설정
+
+`init-project` 대신 직접 `.claude/project.env`를 생성할 수도 있습니다:
+
+```bash
+# .claude/project.env
+GITHUB_PROJECT_OWNER=your-org
+GITHUB_PROJECT_NUMBER=1
+GITHUB_PROJECT_REPO=your-org/your-repo
+```
+
+#### 필요 권한
+
+GitHub Project 접근에 `read:project` 스코프가 필요합니다:
+
+```bash
+gh auth refresh -s read:project,project
+```
+
 ## 핵심 원칙
 
 이 템플릿의 핵심 원칙:

package/dist/cli.js

@@ -1,5 +1,38 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const copy_1 = require("./copy");
@@ -27,4 +60,22 @@ program
         process.exit(1);
     }
 });
+program
+    .command('init-project')
+    .description('Initialize GitHub Project integration in current directory')
+    .action(async () => {
+    try {
+        const { initProject } = await Promise.resolve().then(() => __importStar(require('./init-project')));
+        await initProject();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error('Error:', error.message);
+        }
+        else {
+            console.error('An unexpected error occurred');
+        }
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/copy.js

@@ -125,8 +125,17 @@ async function copyClaudeFiles(options = {}) {
         console.error(chalk_1.default.red('Error:'), 'Source .claude directory not found');
         process.exit(1);
     }
+    // Files to exclude from global copy (project-specific files)
+    const EXCLUDE_FROM_GLOBAL = [
+        'hooks/task-loader.sh',
+        'agents/project-task-manager.md',
+        'project.env.example',
+    ];
     // Get all files to copy
-    const files = getAllFiles(sourceDir);
+    const allFiles = getAllFiles(sourceDir);
+    const files = allFiles.filter((file) => {
+        return !EXCLUDE_FROM_GLOBAL.includes(file);
+    });
     if (files.length === 0) {
         console.log(chalk_1.default.yellow('No files found in .claude directory'));
         return;

package/dist/index.d.ts

@@ -1 +1,2 @@
 export { copyClaudeFiles, CopyOptions } from './copy';
+export { initProject } from './init-project';

package/dist/index.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.copyClaudeFiles = void 0;
+exports.initProject = exports.copyClaudeFiles = void 0;
 var copy_1 = require("./copy");
 Object.defineProperty(exports, "copyClaudeFiles", { enumerable: true, get: function () { return copy_1.copyClaudeFiles; } });
+var init_project_1 = require("./init-project");
+Object.defineProperty(exports, "initProject", { enumerable: true, get: function () { return init_project_1.initProject; } });

package/dist/init-project.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Initialize GitHub Project integration in current directory
+ */
+export declare function initProject(): Promise<void>;

package/dist/init-project.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initProject = initProject;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Prompt user for input using readline
+ */
+function askQuestion(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Get the source .claude directory path (from package installation)
+ */
+function getSourceClaudeDir() {
+    return path.resolve(__dirname, '..', '.claude');
+}
+/**
+ * Get the project .claude directory path (current working directory)
+ */
+function getProjectClaudeDir() {
+    return path.join(process.cwd(), '.claude');
+}
+/**
+ * Prompt user for GitHub Project configuration
+ */
+async function promptProjectConfig() {
+    console.log(chalk_1.default.cyan('\n📋 GitHub Project 설정\n'));
+    const owner = await askQuestion(chalk_1.default.white('GitHub Owner (org 또는 user): '));
+    if (!owner) {
+        console.log(chalk_1.default.red('Owner는 필수입니다.'));
+        process.exit(1);
+    }
+    const projectNumber = await askQuestion(chalk_1.default.white('Project Number: '));
+    if (!projectNumber || isNaN(Number(projectNumber))) {
+        console.log(chalk_1.default.red('유효한 Project Number를 입력하세요.'));
+        process.exit(1);
+    }
+    const repo = await askQuestion(chalk_1.default.white(`Repository (기본값: ${owner}/): `));
+    const finalRepo = repo || `${owner}/`;
+    return { owner, projectNumber, repo: finalRepo };
+}
+/**
+ * Create project.env file with GitHub Project configuration
+ */
+function createProjectEnv(destDir, config) {
+    const envPath = path.join(destDir, 'project.env');
+    const content = `# GitHub Project 설정\nGITHUB_PROJECT_OWNER=${config.owner}\nGITHUB_PROJECT_NUMBER=${config.projectNumber}\nGITHUB_PROJECT_REPO=${config.repo}\n`;
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.writeFileSync(envPath, content, 'utf-8');
+    console.log(chalk_1.default.green(`  ✓ ${path.relative(process.cwd(), envPath)}`));
+}
+/**
+ * Copy a project-specific file from package source to project directory
+ */
+function copyProjectFile(srcRelative, destDir) {
+    const srcPath = path.join(getSourceClaudeDir(), srcRelative);
+    const destPath = path.join(destDir, srcRelative);
+    if (!fs.existsSync(srcPath)) {
+        console.log(chalk_1.default.yellow(`  ⚠ 소스 파일 없음: ${srcRelative}`));
+        return;
+    }
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.copyFileSync(srcPath, destPath);
+    console.log(chalk_1.default.green(`  ✓ ${path.relative(process.cwd(), destPath)}`));
+}
+/**
+ * Merge StartSession hook into settings.json
+ */
+function mergeSettingsJson(destDir) {
+    const settingsPath = path.join(destDir, 'settings.json');
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+        }
+        catch {
+            console.log(chalk_1.default.yellow('  ⚠ 기존 settings.json 파싱 실패, 새로 생성합니다.'));
+            settings = {};
+        }
+    }
+    if (!settings.hooks) {
+        settings.hooks = {};
+    }
+    settings.hooks.StartSession = [
+        {
+            type: 'command',
+            command: 'bash .claude/hooks/task-loader.sh',
+        },
+    ];
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+    console.log(chalk_1.default.green(`  ✓ ${path.relative(process.cwd(), settingsPath)} (StartSession hook 추가)`));
+}
+/**
+ * Initialize GitHub Project integration in current directory
+ */
+async function initProject() {
+    const config = await promptProjectConfig();
+    const destDir = getProjectClaudeDir();
+    console.log(chalk_1.default.cyan('\n🔧 프로젝트 설정 파일 생성\n'));
+    // 1. project.env 생성
+    createProjectEnv(destDir, config);
+    // 2. 프로젝트별 파일 복사
+    copyProjectFile('hooks/task-loader.sh', destDir);
+    copyProjectFile('agents/project-task-manager.md', destDir);
+    // 3. settings.json merge
+    mergeSettingsJson(destDir);
+    console.log(chalk_1.default.cyan('\n✅ GitHub Project 설정 완료!'));
+    console.log(chalk_1.default.gray(`   Owner: ${config.owner}`));
+    console.log(chalk_1.default.gray(`   Project: #${config.projectNumber}`));
+    console.log(chalk_1.default.gray(`   Repo: ${config.repo}\n`));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jun-claude-code",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Claude Code configuration template - copy .claude settings to your project",
   "main": "dist/index.js",
   "bin": "dist/cli.js",