jun-claude-code 0.0.17 → 0.1.0

package/README.md

@@ -2,66 +2,6 @@
 
 Claude Code 설정 템플릿 CLI. 미리 정의된 Agents, Skills, Hooks, Workflow를 프로젝트에 설치하여 Claude Code 환경을 빠르게 구축합니다.
 
-## 포함 내용
-
-### Agents (`templates/global/agents/`)
-
-작업별 전문 Subagent 13종. Main Agent의 Context Window를 절약하면서 각 작업을 위임합니다.
-
-| Agent | 역할 |
-|-------|------|
-| `explore` | 코드베이스 탐색 |
-| `task-planner` | 작업 계획 수립 |
-| `code-writer` | 코드 작성 (Opus) |
-| `simple-code-writer` | 단순 수정 (Haiku) |
-| `code-reviewer` | 셀프 코드 리뷰 |
-| `git-manager` | Git 커밋/PR |
-| `impact-analyzer` | 사이드이펙트 분석 |
-| `qa-tester` | 테스트/빌드 검증 |
-| `architect` | 아키텍처 설계 |
-| `designer` | UI/UX 스타일링 |
-| `director` | 작업 총괄 디렉터 |
-| `context-collector` | 소스 코드 기반 Context 수집 |
-| `context-manager` | Context 문서 관리 |
-
-### Skills (`templates/global/skills/`)
-
-| Skill | 설명 |
-|-------|------|
-| `Coding` | 공통 코딩 원칙 (SRP, 응집도, 가독성) |
-| `Git` | Git 커밋/PR 규칙, PR 리뷰, 피드백 적용 |
-| `Backend` | 백엔드 개발 원칙 (레이어, TypeORM) |
-| `React` | React 개발 (TanStack Router, React Hook Form, Tailwind) |
-| `Documentation` | .claude 문서 작성 가이드 |
-| `Director` | 디렉터 Agent 운영 스킬 |
-
-### Hooks (`templates/global/hooks/`)
-
-| Hook | 설명 |
-|------|------|
-| `workflow-enforced.sh` | 워크플로우 순서 강제 프로토콜 |
-| `skill-forced.sh` | Skill/Agent 평가 프로토콜 |
-
-### Project Agents (`templates/project/agents/`)
-
-프로젝트 `.claude/`에 설치되는 프로젝트별 Agent.
-
-| Agent | 역할 |
-|-------|------|
-| `project-task-manager` | GitHub Project 태스크 관리 |
-| `context-generator` | Context 자동 생성 |
-| `project-context-collector` | .claude/context/ 문서 기반 프로젝트 배경 수집 |
-
-### Project Skills (`templates/project/skills/`)
-
-| Skill | 설명 |
-|-------|------|
-| `ContextGeneration` | Context 자동 생성 스킬 |
-
-### Workflow
-
-Planning -> Validation -> Implementation -> Review 순서의 작업 워크플로우와 Context 절약 원칙(Subagent 위임 규칙)을 정의합니다.
-
 ## 설치
 
 ```bash
@@ -79,6 +19,7 @@ npm install -g jun-claude-code
 | 명령어 | 설명 | 활성화되는 기능 |
 |--------|------|----------------|
 | `jun-claude-code` | 전역 설정 (`~/.claude/`) 설치 | Agents 13종, Skills 6종, Hooks 2종, Workflow |
+| `jun-claude-code --project` | 프로젝트 설정 (`.claude/`) 설치 | 전역과 동일 (프로젝트별 오버라이드용) |
 | `jun-claude-code init-project` | GitHub Project 연동 | 세션 시작 시 태스크 자동 로드, 태스크 관리 Agent |
 | `jun-claude-code init-context` | Context 자동 생성 설정 | PR 기반 Context 자동 생성, Codebase/Business 문서화, 별도 브랜치 PR |
 
@@ -92,6 +33,7 @@ jun-claude-code
 
 | 옵션 | 설명 |
 |------|------|
+| `--project`, `-p` | 전역(`~/.claude/`) 대신 프로젝트(`.claude/`)에 설치 |
 | `--dry-run`, `-d` | 실제 복사 없이 복사될 파일 목록만 확인 |
 | `--force`, `-f` | 확인 없이 모든 파일 덮어쓰기 |
 
@@ -176,6 +118,66 @@ jun-claude-code init-context
 2. **CLAUDE_CODE_OAUTH_TOKEN 추가**
    - Settings → Secrets and variables → Actions → New repository secret
 
+## 포함 내용
+
+### Agents (`templates/global/agents/`)
+
+작업별 전문 Subagent 13종. Main Agent의 Context Window를 절약하면서 각 작업을 위임합니다.
+
+| Agent | 역할 |
+|-------|------|
+| `explore` | 코드베이스 탐색 |
+| `task-planner` | 작업 계획 수립 |
+| `code-writer` | 코드 작성 (Opus) |
+| `simple-code-writer` | 단순 수정 (Haiku) |
+| `code-reviewer` | 셀프 코드 리뷰 |
+| `git-manager` | Git 커밋/PR |
+| `impact-analyzer` | 사이드이펙트 분석 |
+| `qa-tester` | 테스트/빌드 검증 |
+| `architect` | 아키텍처 설계 |
+| `designer` | UI/UX 스타일링 |
+| `director` | 작업 총괄 디렉터 |
+| `context-collector` | 소스 코드 기반 Context 수집 |
+| `context-manager` | Context 문서 관리 |
+
+### Skills (`templates/global/skills/`)
+
+| Skill | 설명 |
+|-------|------|
+| `Coding` | 공통 코딩 원칙 (SRP, 응집도, 가독성) |
+| `Git` | Git 커밋/PR 규칙, PR 리뷰, 피드백 적용 |
+| `Backend` | 백엔드 개발 원칙 (레이어, TypeORM) |
+| `React` | React 개발 (TanStack Router, React Hook Form, Tailwind) |
+| `Documentation` | .claude 문서 작성 가이드 |
+| `Director` | 디렉터 Agent 운영 스킬 |
+
+### Hooks (`templates/global/hooks/`)
+
+| Hook | 설명 |
+|------|------|
+| `workflow-enforced.sh` | 워크플로우 순서 강제 프로토콜 |
+| `skill-forced.sh` | Skill/Agent 평가 프로토콜 |
+
+### Project Agents (`templates/project/agents/`)
+
+프로젝트 `.claude/`에 설치되는 프로젝트별 Agent.
+
+| Agent | 역할 |
+|-------|------|
+| `project-task-manager` | GitHub Project 태스크 관리 |
+| `context-generator` | Context 자동 생성 |
+| `project-context-collector` | .claude/context/ 문서 기반 프로젝트 배경 수집 |
+
+### Project Skills (`templates/project/skills/`)
+
+| Skill | 설명 |
+|-------|------|
+| `ContextGeneration` | Context 자동 생성 스킬 |
+
+### Workflow
+
+Planning -> Validation -> Implementation -> Review 순서의 작업 워크플로우와 Context 절약 원칙(Subagent 위임 규칙)을 정의합니다.
+
 ## 프로젝트 구조
 
 ```
@@ -196,7 +198,7 @@ templates/
 
 ## 커스터마이징
 
-설치 후 `~/.claude/`에서 필요에 맞게 수정할 수 있습니다. 프로젝트별로는 프로젝트 루트에 `.claude/`를 만들어 설정을 추가합니다.
+`--project` 옵션을 사용하면 전역 템플릿을 프로젝트 `.claude/`에 바로 설치할 수 있습니다. 설치 후 필요에 맞게 수정하세요.
 
 ```
 your-project/

package/dist/__tests__/merge-settings.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/merge-settings.test.js

@@ -0,0 +1,340 @@
+"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 vitest_1 = require("vitest");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const utils_1 = require("../utils");
+const copy_1 = require("../copy");
+const init_project_1 = require("../init-project");
+function createTmpDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'merge-settings-test-'));
+}
+function cleanupDir(dir) {
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+function readJson(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+}
+function writeJson(filePath, data) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+// ─── getHookKey ───
+(0, vitest_1.describe)('getHookKey', () => {
+    (0, vitest_1.it)('should generate key for flat hook entry', () => {
+        const entry = { type: 'command', command: 'echo hello' };
+        (0, vitest_1.expect)((0, utils_1.getHookKey)(entry)).toBe('command:echo hello');
+    });
+    (0, vitest_1.it)('should generate key for nested hooks entry without matcher', () => {
+        const entry = {
+            hooks: [
+                { type: 'command', command: 'cmd-a' },
+                { type: 'command', command: 'cmd-b' },
+            ],
+        };
+        const key = (0, utils_1.getHookKey)(entry);
+        (0, vitest_1.expect)(key).toBe('command:cmd-a\ncommand:cmd-b');
+    });
+    (0, vitest_1.it)('should sort nested hooks for consistent key', () => {
+        const entry1 = {
+            hooks: [
+                { type: 'command', command: 'cmd-b' },
+                { type: 'command', command: 'cmd-a' },
+            ],
+        };
+        const entry2 = {
+            hooks: [
+                { type: 'command', command: 'cmd-a' },
+                { type: 'command', command: 'cmd-b' },
+            ],
+        };
+        (0, vitest_1.expect)((0, utils_1.getHookKey)(entry1)).toBe((0, utils_1.getHookKey)(entry2));
+    });
+    (0, vitest_1.it)('should include matcher in key when present', () => {
+        const entry = {
+            matcher: 'Bash',
+            hooks: [{ type: 'command', command: 'blocker.sh' }],
+        };
+        (0, vitest_1.expect)((0, utils_1.getHookKey)(entry)).toBe('[Bash]command:blocker.sh');
+    });
+    (0, vitest_1.it)('should generate different keys for same hooks with different matchers', () => {
+        const entryBash = {
+            matcher: 'Bash',
+            hooks: [{ type: 'command', command: 'blocker.sh' }],
+        };
+        const entryWrite = {
+            matcher: 'Write',
+            hooks: [{ type: 'command', command: 'blocker.sh' }],
+        };
+        (0, vitest_1.expect)((0, utils_1.getHookKey)(entryBash)).not.toBe((0, utils_1.getHookKey)(entryWrite));
+    });
+    (0, vitest_1.it)('should generate different keys for same hooks with vs without matcher', () => {
+        const withMatcher = {
+            matcher: 'Bash',
+            hooks: [{ type: 'command', command: 'blocker.sh' }],
+        };
+        const withoutMatcher = {
+            hooks: [{ type: 'command', command: 'blocker.sh' }],
+        };
+        (0, vitest_1.expect)((0, utils_1.getHookKey)(withMatcher)).not.toBe((0, utils_1.getHookKey)(withoutMatcher));
+    });
+    (0, vitest_1.it)('should handle empty matcher as no matcher', () => {
+        const entry = {
+            matcher: '',
+            hooks: [{ type: 'command', command: 'test.sh' }],
+        };
+        const entryNoMatcher = {
+            hooks: [{ type: 'command', command: 'test.sh' }],
+        };
+        (0, vitest_1.expect)((0, utils_1.getHookKey)(entry)).toBe((0, utils_1.getHookKey)(entryNoMatcher));
+    });
+});
+// ─── copy.ts mergeSettingsJson (global) ───
+(0, vitest_1.describe)('copy.ts mergeSettingsJson', () => {
+    let sourceDir;
+    let destDir;
+    (0, vitest_1.beforeEach)(() => {
+        sourceDir = createTmpDir();
+        destDir = createTmpDir();
+    });
+    (0, vitest_1.afterEach)(() => {
+        cleanupDir(sourceDir);
+        cleanupDir(destDir);
+    });
+    (0, vitest_1.it)('should create settings.json on fresh install', () => {
+        const sourceSettings = {
+            statusLine: { type: 'command', command: 'echo test' },
+            hooks: {
+                UserPromptSubmit: [
+                    {
+                        hooks: [{ type: 'command', command: 'skill-forced.sh' }],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        (0, vitest_1.expect)(result.statusLine).toEqual(sourceSettings.statusLine);
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit).toHaveLength(1);
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit[0].hooks[0].command).toBe('skill-forced.sh');
+    });
+    (0, vitest_1.it)('should skip duplicate hooks on re-run', () => {
+        const sourceSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    { hooks: [{ type: 'command', command: 'skill-forced.sh' }] },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        // First run
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        // Second run (re-install)
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit).toHaveLength(1);
+    });
+    (0, vitest_1.it)('should distinguish entries with different matchers', () => {
+        const sourceSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        matcher: 'Bash',
+                        hooks: [{ type: 'command', command: 'blocker.sh' }],
+                    },
+                    {
+                        matcher: 'Write',
+                        hooks: [{ type: 'command', command: 'blocker.sh' }],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        (0, vitest_1.expect)(result.hooks.PreToolUse).toHaveLength(2);
+        (0, vitest_1.expect)(result.hooks.PreToolUse[0].matcher).toBe('Bash');
+        (0, vitest_1.expect)(result.hooks.PreToolUse[1].matcher).toBe('Write');
+    });
+    (0, vitest_1.it)('should not add duplicate when matcher-entry already exists in dest', () => {
+        const sourceSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        matcher: 'Bash',
+                        hooks: [{ type: 'command', command: 'blocker.sh' }],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        const destSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        matcher: 'Bash',
+                        hooks: [{ type: 'command', command: 'blocker.sh' }],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(destDir, 'settings.json'), destSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        (0, vitest_1.expect)(result.hooks.PreToolUse).toHaveLength(1);
+    });
+    (0, vitest_1.it)('should preserve existing hooks in dest that are not in source', () => {
+        const sourceSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    { hooks: [{ type: 'command', command: 'new-hook.sh' }] },
+                ],
+            },
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        const destSettings = {
+            hooks: {
+                StartSession: [
+                    { hooks: [{ type: 'command', command: 'existing-hook.sh' }] },
+                ],
+            },
+        };
+        writeJson(path.join(destDir, 'settings.json'), destSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        // Source hook merged in
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit).toHaveLength(1);
+        // Existing hook preserved
+        (0, vitest_1.expect)(result.hooks.StartSession).toHaveLength(1);
+        (0, vitest_1.expect)(result.hooks.StartSession[0].hooks[0].command).toBe('existing-hook.sh');
+    });
+    (0, vitest_1.it)('should preserve existing top-level keys in dest', () => {
+        const sourceSettings = {
+            statusLine: { type: 'command', command: 'source-status' },
+            hooks: {},
+        };
+        writeJson(path.join(sourceDir, 'settings.json'), sourceSettings);
+        const destSettings = {
+            statusLine: { type: 'command', command: 'dest-status' },
+            customKey: 'preserved',
+        };
+        writeJson(path.join(destDir, 'settings.json'), destSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        // Dest's existing key is preserved (not overwritten)
+        (0, vitest_1.expect)(result.statusLine.command).toBe('dest-status');
+        (0, vitest_1.expect)(result.customKey).toBe('preserved');
+    });
+    (0, vitest_1.it)('should skip merge when source settings.json does not exist', () => {
+        // No settings.json in sourceDir
+        const destSettings = { hooks: { StartSession: [] } };
+        writeJson(path.join(destDir, 'settings.json'), destSettings);
+        (0, copy_1.mergeSettingsJson)(sourceDir, destDir);
+        const result = readJson(path.join(destDir, 'settings.json'));
+        (0, vitest_1.expect)(result).toEqual(destSettings);
+    });
+});
+// ─── init-project.ts mergeSettingsJson (project) ───
+(0, vitest_1.describe)('init-project.ts mergeSettingsJson', () => {
+    let tmpDir;
+    (0, vitest_1.beforeEach)(() => {
+        tmpDir = createTmpDir();
+    });
+    (0, vitest_1.afterEach)(() => {
+        cleanupDir(tmpDir);
+    });
+    (0, vitest_1.it)('should create settings.json with StartSession hook on fresh init', () => {
+        (0, init_project_1.mergeProjectSettingsJson)(tmpDir);
+        const result = readJson(path.join(tmpDir, 'settings.json'));
+        (0, vitest_1.expect)(result.hooks.StartSession).toHaveLength(1);
+        (0, vitest_1.expect)(result.hooks.StartSession[0].hooks[0].command).toBe('bash .claude/hooks/task-loader.sh');
+    });
+    (0, vitest_1.it)('should skip duplicate StartSession hook on re-run', () => {
+        // First run
+        (0, init_project_1.mergeProjectSettingsJson)(tmpDir);
+        // Second run
+        (0, init_project_1.mergeProjectSettingsJson)(tmpDir);
+        const result = readJson(path.join(tmpDir, 'settings.json'));
+        (0, vitest_1.expect)(result.hooks.StartSession).toHaveLength(1);
+    });
+    (0, vitest_1.it)('should preserve existing StartSession hooks while adding new one', () => {
+        const existingSettings = {
+            hooks: {
+                StartSession: [
+                    {
+                        hooks: [{ type: 'command', command: 'existing-session-hook.sh' }],
+                    },
+                ],
+            },
+        };
+        writeJson(path.join(tmpDir, 'settings.json'), existingSettings);
+        (0, init_project_1.mergeProjectSettingsJson)(tmpDir);
+        const result = readJson(path.join(tmpDir, 'settings.json'));
+        (0, vitest_1.expect)(result.hooks.StartSession).toHaveLength(2);
+        (0, vitest_1.expect)(result.hooks.StartSession[0].hooks[0].command).toBe('existing-session-hook.sh');
+        (0, vitest_1.expect)(result.hooks.StartSession[1].hooks[0].command).toBe('bash .claude/hooks/task-loader.sh');
+    });
+    (0, vitest_1.it)('should preserve other hook events', () => {
+        const existingSettings = {
+            hooks: {
+                UserPromptSubmit: [
+                    { hooks: [{ type: 'command', command: 'prompt-hook.sh' }] },
+                ],
+            },
+        };
+        writeJson(path.join(tmpDir, 'settings.json'), existingSettings);
+        (0, init_project_1.mergeProjectSettingsJson)(tmpDir);
+        const result = readJson(path.join(tmpDir, 'settings.json'));
+        // Existing event preserved
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit).toHaveLength(1);
+        (0, vitest_1.expect)(result.hooks.UserPromptSubmit[0].hooks[0].command).toBe('prompt-hook.sh');
+        // New hook added
+        (0, vitest_1.expect)(result.hooks.StartSession).toHaveLength(1);
+    });
+    (0, vitest_1.it)('should preserve non-hook settings', () => {
+        const existingSettings = {
+            statusLine: { type: 'command', command: 'echo status' },
+            hooks: {},
+        };
+        writeJson(path.join(tmpDir, 'settings.json'), existingSettings);
+        (0, init_project_1.mergeProjectSettingsJson)(tmpDir);
+        const result = readJson(path.join(tmpDir, 'settings.json'));
+        (0, vitest_1.expect)(result.statusLine.command).toBe('echo status');
+        (0, vitest_1.expect)(result.hooks.StartSession).toHaveLength(1);
+    });
+});

package/dist/cli.js

@@ -45,15 +45,17 @@ const validate_1 = require("./validate");
 const program = new commander_1.Command();
 program
     .name('jun-claude-code')
-    .description('Copy .claude configuration files to your home directory (~/.claude)')
+    .description('Copy .claude configuration files to ~/.claude (global) or .claude/ (project)')
     .version('1.0.0')
     .option('-d, --dry-run', 'Preview files to be copied without actually copying')
     .option('-f, --force', 'Overwrite existing files without confirmation')
+    .option('-p, --project', 'Install to project .claude/ instead of global ~/.claude/')
     .action(async (options) => {
     try {
         await (0, copy_1.copyClaudeFiles)({
             dryRun: options.dryRun,
             force: options.force,
+            project: options.project,
         });
     }
     catch (error) {

package/dist/copy.d.ts

@@ -1,7 +1,14 @@
 export interface CopyOptions {
     dryRun?: boolean;
     force?: boolean;
+    project?: boolean;
 }
+/**
+ * Merge settings.json from source into destination.
+ * Hooks are merged per event key; duplicate hook entries (by deep equality) are skipped.
+ * Non-hook keys are shallow-merged (source wins for new keys, dest preserved for existing).
+ */
+export declare function mergeSettingsJson(sourceDir: string, destDir: string): void;
 /**
  * Copy .claude files to user's home directory
  */

package/dist/copy.js

@@ -36,12 +36,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeSettingsJson = mergeSettingsJson;
 exports.copyClaudeFiles = copyClaudeFiles;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const readline = __importStar(require("readline"));
 const crypto = __importStar(require("crypto"));
 const chalk_1 = __importDefault(require("chalk"));
+const utils_1 = require("./utils");
 /**
  * Prompt user for confirmation using readline
  */
@@ -168,22 +170,10 @@ function mergeSettingsJson(sourceDir, destDir) {
             destHooks[event] = [];
         }
         const destEntries = destHooks[event];
-        // Extract a command-based key from a hook entry for duplicate detection.
-        // Type 1: { type: "command", command: "..." } → returns "type:command"
-        // Type 2: { hooks: [{ type: "command", command: "..." }, ...] } → returns sorted "type:command" joined
-        const getHookKey = (entry) => {
-            if (entry.hooks && Array.isArray(entry.hooks)) {
-                return entry.hooks
-                    .map((h) => `${h.type || ''}:${h.command || ''}`)
-                    .sort()
-                    .join('\n');
-            }
-            return `${entry.type || ''}:${entry.command || ''}`;
-        };
         // Build a Set of command keys from existing entries for fast duplicate detection
-        const existingKeys = new Set(destEntries.map((entry) => getHookKey(entry)));
+        const existingKeys = new Set(destEntries.map((entry) => (0, utils_1.getHookKey)(entry)));
         for (const entry of sourceEntries) {
-            const key = getHookKey(entry);
+            const key = (0, utils_1.getHookKey)(entry);
             if (!existingKeys.has(key)) {
                 destEntries.push(entry);
                 existingKeys.add(key);
@@ -198,11 +188,12 @@ function mergeSettingsJson(sourceDir, destDir) {
  * Copy .claude files to user's home directory
  */
 async function copyClaudeFiles(options = {}) {
-    const { dryRun = false, force = false } = options;
+    const { dryRun = false, force = false, project = false } = options;
     const sourceDir = getSourceGlobalDir();
-    const destDir = getDestClaudeDir();
+    const destDir = project ? path.join(process.cwd(), '.claude') : getDestClaudeDir();
+    const targetLabel = project ? 'project' : 'global';
     console.log(chalk_1.default.blue('Source:'), sourceDir);
-    console.log(chalk_1.default.blue('Destination:'), destDir);
+    console.log(chalk_1.default.blue('Destination:'), `${destDir} ${chalk_1.default.gray(`(${targetLabel})`)}`);
     console.log();
     // Check if source exists
     if (!fs.existsSync(sourceDir)) {

package/dist/init-project.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Merge StartSession hook into settings.json.
+ * Appends the task-loader hook if not already present (duplicate detection via getHookKey).
+ */
+export declare function mergeProjectSettingsJson(destDir: string): void;
 /**
  * Initialize GitHub Project integration in current directory
  */

package/dist/init-project.js

@@ -36,11 +36,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeProjectSettingsJson = mergeProjectSettingsJson;
 exports.initProject = initProject;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const readline = __importStar(require("readline"));
 const chalk_1 = __importDefault(require("chalk"));
+const utils_1 = require("./utils");
 /**
  * Prompt user for input using readline
  */
@@ -112,9 +114,10 @@ function copyProjectFile(srcRelative, destDir) {
     console.log(chalk_1.default.green(`  ✓ ${path.relative(process.cwd(), destPath)}`));
 }
 /**
- * Merge StartSession hook into settings.json
+ * Merge StartSession hook into settings.json.
+ * Appends the task-loader hook if not already present (duplicate detection via getHookKey).
  */
-function mergeSettingsJson(destDir) {
+function mergeProjectSettingsJson(destDir) {
     const settingsPath = path.join(destDir, 'settings.json');
     let settings = {};
     if (fs.existsSync(settingsPath)) {
@@ -129,12 +132,21 @@ function mergeSettingsJson(destDir) {
     if (!settings.hooks) {
         settings.hooks = {};
     }
-    settings.hooks.StartSession = [
-        {
-            type: 'command',
-            command: 'bash .claude/hooks/task-loader.sh',
-        },
-    ];
+    if (!settings.hooks.StartSession) {
+        settings.hooks.StartSession = [];
+    }
+    const newEntry = {
+        hooks: [
+            {
+                type: 'command',
+                command: 'bash .claude/hooks/task-loader.sh',
+            },
+        ],
+    };
+    const existingKeys = new Set(settings.hooks.StartSession.map((e) => (0, utils_1.getHookKey)(e)));
+    if (!existingKeys.has((0, utils_1.getHookKey)(newEntry))) {
+        settings.hooks.StartSession.push(newEntry);
+    }
     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 추가)`));
@@ -152,7 +164,7 @@ async function initProject() {
     copyProjectFile('hooks/task-loader.sh', destDir);
     copyProjectFile('agents/project-task-manager.md', destDir);
     // 3. settings.json merge
-    mergeSettingsJson(destDir);
+    mergeProjectSettingsJson(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}`));

package/dist/utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extract a command-based key from a hook entry for duplicate detection.
+ * Includes the matcher field so that entries with the same command but different matchers
+ * are treated as distinct items.
+ *
+ * Type 1 (nested): { matcher?: "...", hooks: [{ type: "command", command: "..." }, ...] }
+ *   -> returns "[matcher]type:command\ntype:command" (sorted) or "type:command\ntype:command" if no matcher
+ *
+ * Type 2 (flat): { type: "command", command: "..." }
+ *   -> returns "type:command"
+ */
+export declare const getHookKey: (entry: any) => string;

package/dist/utils.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHookKey = void 0;
+/**
+ * Extract a command-based key from a hook entry for duplicate detection.
+ * Includes the matcher field so that entries with the same command but different matchers
+ * are treated as distinct items.
+ *
+ * Type 1 (nested): { matcher?: "...", hooks: [{ type: "command", command: "..." }, ...] }
+ *   -> returns "[matcher]type:command\ntype:command" (sorted) or "type:command\ntype:command" if no matcher
+ *
+ * Type 2 (flat): { type: "command", command: "..." }
+ *   -> returns "type:command"
+ */
+const getHookKey = (entry) => {
+    const matcher = entry.matcher || '';
+    if (entry.hooks && Array.isArray(entry.hooks)) {
+        const hooksKey = entry.hooks
+            .map((h) => `${h.type || ''}:${h.command || ''}`)
+            .sort()
+            .join('\n');
+        return matcher ? `[${matcher}]${hooksKey}` : hooksKey;
+    }
+    return `${entry.type || ''}:${entry.command || ''}`;
+};
+exports.getHookKey = getHookKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jun-claude-code",
-  "version": "0.0.17",
+  "version": "0.1.0",
   "description": "Claude Code configuration template - copy .claude settings to your project",
   "main": "dist/index.js",
   "bin": "dist/cli.js",
@@ -10,6 +10,7 @@
   ],
   "scripts": {
     "build": "tsc",
+    "test": "vitest run",
     "prepublishOnly": "yarn build"
   },
   "packageManager": "yarn@3.8.7",
@@ -19,7 +20,8 @@
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "typescript": "^5.5.3"
+    "typescript": "^5.5.3",
+    "vitest": "^4.0.18"
   },
   "keywords": [
     "claude",

package/templates/global/settings.json

@@ -1,7 +1,7 @@
 {
   "statusLine": {
-    "format": "{{dir}} {{git}} | {{tokens}} | {{model}}",
-    "updateInterval": 1000
+    "type": "command",
+    "command": "~/.claude/statusline-command.sh"
   },
   "hooks": {
     "UserPromptSubmit": [

package/templates/global/statusline-command.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+
+# Read JSON input from stdin
+input=$(cat)
+
+# Extract data from JSON
+cwd=$(echo "$input" | jq -r '.workspace.current_dir')
+model=$(echo "$input" | jq -r '.model.display_name')
+session_name=$(echo "$input" | jq -r '.session_name // empty')
+remaining=$(echo "$input" | jq -r '.context_window.remaining_percentage // empty')
+used_tokens=$(echo "$input" | jq -r '.context_window.total_input_tokens // empty')
+total_tokens=$(echo "$input" | jq -r '.context_window.context_window_size // empty')
+
+# Get short directory name (basename)
+dir_name=$(basename "$cwd")
+
+# Git information
+git_info=""
+if git -C "$cwd" rev-parse --git-dir > /dev/null 2>&1; then
+  branch=$(git -C "$cwd" -c core.useBuiltinFSMonitor=false -c core.fsmonitor=false symbolic-ref --short HEAD 2>/dev/null || echo "detached")
+
+  # Check for uncommitted changes
+  if ! git -C "$cwd" -c core.useBuiltinFSMonitor=false -c core.fsmonitor=false diff --quiet 2>/dev/null || \
+     ! git -C "$cwd" -c core.useBuiltinFSMonitor=false -c core.fsmonitor=false diff --cached --quiet 2>/dev/null; then
+    status="✗"
+  else
+    status=""
+  fi
+
+  git_info=" git:($(printf '\033[31m')${branch}$(printf '\033[0m'))${status}"
+fi
+
+# Format token information
+format_token_count() {
+  local value=$1
+  if (( value >= 1000 )); then
+    printf "%.1fk" "$(bc <<< "scale=1; $value / 1000")"
+  else
+    echo "$value"
+  fi
+}
+
+# Get color based on usage percentage
+get_color_for_percentage() {
+  local percentage=$1
+  if (( percentage >= 90 )); then
+    printf '\033[31m'  # red
+  elif (( percentage >= 70 )); then
+    printf '\033[33m'  # yellow
+  else
+    printf '\033[0m'   # reset (no color)
+  fi
+}
+
+# Build status line in robbyrussell style
+status_line="$(printf '\033[36m')${dir_name}$(printf '\033[0m')${git_info}"
+
+# Add context percentage if available
+if [ -n "$remaining" ]; then
+  # Calculate usage percentage (100 - remaining)
+  usage=$((100 - remaining))
+  color=$(get_color_for_percentage "$usage")
+  status_line="${status_line} | ctx:${color}${usage}%$(printf '\033[0m')"
+fi
+
+# Add token information if available
+if [ -n "$used_tokens" ] && [ -n "$total_tokens" ]; then
+  used_formatted=$(format_token_count "$used_tokens")
+  total_formatted=$(format_token_count "$total_tokens")
+  # Calculate token usage percentage
+  token_usage=$(echo "scale=0; $used_tokens * 100 / $total_tokens" | bc)
+  color=$(get_color_for_percentage "$token_usage")
+  status_line="${status_line} | token:${color}${used_formatted}/${total_formatted}$(printf '\033[0m')"
+fi
+
+# Add model info
+status_line="${status_line} | ${model}"
+
+# Add session name if set
+if [ -n "$session_name" ]; then
+  status_line="${status_line} [${session_name}]"
+fi
+
+printf "%s" "$status_line"