jun-claude-code 0.0.16 → 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` | 확인 없이 모든 파일 덮어쓰기 |
 
@@ -165,7 +107,76 @@ jun-claude-code init-context
         └── INDEX.md               # 비즈니스 도메인 참조 목록
 ```
 
-> `CLAUDE_CODE_OAUTH_TOKEN`를 GitHub repository secrets에 추가해야 합니다.
+**필수 설정:**
+
+1. **Repository Actions 권한 활성화**
+   - Repository → Settings → Actions → General
+   - **Workflow permissions** 섹션에서:
+     - "Read and write permissions" 선택
+     - ✅ "Allow GitHub Actions to create and approve pull requests" 체크
+
+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 위임 규칙)을 정의합니다.
 
 ## 프로젝트 구조
 
@@ -187,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,11 +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
  */
@@ -57,6 +60,13 @@ function askConfirmation(question) {
         });
     });
 }
+/**
+ * Calculate SHA-256 hash of a file
+ */
+function getFileHash(filePath) {
+    const content = fs.readFileSync(filePath);
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
 /**
  * Get all files recursively from a directory
  */
@@ -160,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);
@@ -190,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)) {
@@ -221,10 +220,18 @@ async function copyClaudeFiles(options = {}) {
         console.log(chalk_1.default.yellow('[DRY RUN] Files that would be copied:'));
         console.log();
         for (const file of files) {
+            const sourcePath = path.join(sourceDir, file);
             const destPath = path.join(destDir, file);
             const exists = fs.existsSync(destPath);
-            const status = exists ? chalk_1.default.yellow('[overwrite]') : chalk_1.default.green('[new]');
-            console.log(`  ${status} ${file}`);
+            if (exists) {
+                const sourceHash = getFileHash(sourcePath);
+                const destHash = getFileHash(destPath);
+                const status = sourceHash === destHash ? chalk_1.default.gray('[unchanged]') : chalk_1.default.yellow('[overwrite]');
+                console.log(`  ${status} ${file}`);
+            }
+            else {
+                console.log(`  ${chalk_1.default.green('[new]')} ${file}`);
+            }
         }
         // settings.json merge indicator
         const sourceSettingsExists = fs.existsSync(path.join(sourceDir, 'settings.json'));
@@ -243,8 +250,15 @@ async function copyClaudeFiles(options = {}) {
         const destPath = path.join(destDir, file);
         const exists = fs.existsSync(destPath);
         if (exists && !force) {
-            // Ask for confirmation
-            const shouldOverwrite = await askConfirmation(chalk_1.default.yellow(`File exists: ${file}. Overwrite? (y/N): `));
+            const sourceHash = getFileHash(sourcePath);
+            const destHash = getFileHash(destPath);
+            if (sourceHash === destHash) {
+                console.log(`  ${chalk_1.default.gray('[unchanged]')} ${file}`);
+                skippedCount++;
+                continue;
+            }
+            // Hash differs - ask for confirmation
+            const shouldOverwrite = await askConfirmation(chalk_1.default.yellow(`File changed: ${file}. Overwrite? (y/N): `));
             if (!shouldOverwrite) {
                 console.log(chalk_1.default.gray(`  Skipped: ${file}`));
                 skippedCount++;