algokit-mcp 1.0.2 → 1.0.4

package/dist/tools/programmers/search-problems-programmers.js

@@ -0,0 +1,173 @@
+/**
+ * search_problems_programmers MCP 도구
+ *
+ * Phase 7 - Task 7.5: 프로그래머스 문제 검색 MCP 도구
+ */
+import { z } from 'zod';
+import { ProgrammersScraper } from '../../api/programmers-scraper.js';
+/**
+ * 입력 스키마
+ */
+export const SearchProgrammersProblemsInputSchema = z.object({
+    levels: z.array(z.number().int().min(0).max(5)).optional()
+        .describe('난이도 레벨 배열 (0: 입문, 1-5: 레벨1-5). 예: [1, 2] - 레벨1, 2 문제'),
+    order: z.enum(['recent', 'accuracy', 'popular']).optional()
+        .describe('정렬 방식. recent: 최신순, accuracy: 정확도순, popular: 인기순 (기본값: recent)'),
+    page: z.number().int().positive().optional()
+        .describe('페이지 번호 (기본값: 1, 페이지당 20개 문제)'),
+    limit: z.number().int().positive().max(20).optional()
+        .describe('반환할 문제 개수 (최대 20개, 기본값: 20)'),
+    query: z.string().optional()
+        .describe('검색 키워드 (문제 제목으로 검색)'),
+});
+/**
+ * 프로그래머스 문제 검색 도구 핸들러
+ *
+ * @param args - 입력 인자
+ * @returns 문제 목록 (마크다운 테이블 형식)
+ * @throws {Error} 검증 실패 또는 스크래핑 실패 시
+ */
+export async function searchProgrammersProblems(args) {
+    try {
+        // 1. 입력 검증
+        const input = SearchProgrammersProblemsInputSchema.parse(args);
+        // 2. 검색 옵션 구성
+        const options = {
+            levels: input.levels,
+            order: input.order || 'recent',
+            page: input.page || 1,
+            limit: input.limit || 20,
+            query: input.query,
+        };
+        // 3. 프로그래머스 스크래핑
+        const scraper = new ProgrammersScraper();
+        const problems = await scraper.searchProblems(options);
+        // 4. 결과가 없는 경우
+        if (problems.length === 0) {
+            return {
+                type: 'text',
+                text: '🔍 검색 결과가 없습니다.\n\n검색 조건을 변경해보세요.',
+            };
+        }
+        // 5. 마크다운 테이블 생성
+        const markdown = formatProblemsAsMarkdown(problems, options);
+        return {
+            type: 'text',
+            text: markdown,
+        };
+    }
+    catch (error) {
+        // Zod 검증 에러
+        if (error instanceof z.ZodError) {
+            throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+        }
+        // 기타 에러
+        if (error instanceof Error) {
+            throw new Error(`프로그래머스 검색 실패: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * 문제 목록을 마크다운 테이블로 포맷팅
+ */
+function formatProblemsAsMarkdown(problems, options) {
+    const lines = [];
+    // 헤더
+    lines.push('# 🔍 프로그래머스 문제 검색 결과\n');
+    // 검색 조건 요약
+    const conditions = [];
+    if (options.levels && options.levels.length > 0) {
+        conditions.push(`레벨 ${options.levels.join(', ')}`);
+    }
+    if (options.query) {
+        conditions.push(`키워드 "${options.query}"`);
+    }
+    if (options.order) {
+        const orderName = {
+            recent: '최신순',
+            accuracy: '정확도순',
+            popular: '인기순',
+        }[options.order];
+        conditions.push(`정렬: ${orderName}`);
+    }
+    if (conditions.length > 0) {
+        lines.push(`**검색 조건**: ${conditions.join(' | ')}\n`);
+    }
+    lines.push(`**결과**: ${problems.length}개 문제 (페이지 ${options.page || 1})\n`);
+    // 테이블 헤더
+    lines.push('| 번호 | 제목 | 레벨 | 카테고리 | 완료자 | 정답률 |');
+    lines.push('|------|------|------|----------|--------|--------|');
+    // 테이블 행
+    for (const problem of problems) {
+        const title = `[${problem.title}](${problem.url})`;
+        const level = formatLevel(problem.level);
+        const category = problem.category || '-';
+        const finishedCount = problem.finishedCount
+            ? problem.finishedCount.toLocaleString()
+            : '-';
+        const acceptanceRate = problem.acceptanceRate
+            ? `${problem.acceptanceRate}%`
+            : '-';
+        lines.push(`| ${problem.problemId} | ${title} | ${level} | ${category} | ${finishedCount} | ${acceptanceRate} |`);
+    }
+    lines.push('');
+    // 안내 메시지
+    lines.push('---');
+    lines.push('');
+    lines.push('💡 **다음 단계**:');
+    lines.push('- 문제를 선택하여 상세 정보 조회: `get_problem_programmers`');
+    lines.push('- 문제 분석 및 힌트 생성: `analyze_programmers_problem` (구현 예정)');
+    lines.push('');
+    lines.push('⚠️ **참고**:');
+    lines.push('- 프로그래머스는 페이지당 20개 문제를 반환합니다');
+    lines.push('- 실제 프로그래머스 사이트에서 문제를 풀어야 합니다');
+    return lines.join('\n');
+}
+/**
+ * 레벨을 이모지와 텍스트로 포맷팅
+ */
+function formatLevel(level) {
+    const levelEmoji = {
+        0: '🟢 입문',
+        1: '🟢 Lv.1',
+        2: '🟡 Lv.2',
+        3: '🟠 Lv.3',
+        4: '🔴 Lv.4',
+        5: '🔴 Lv.5',
+    };
+    return levelEmoji[level] || `Lv.${level}`;
+}
+/**
+ * MCP 도구 정의
+ */
+export function searchProgrammersProblemsTool() {
+    return {
+        name: 'search_problems_programmers',
+        description: `프로그래머스 문제를 검색합니다. 난이도, 정렬 방식, 키워드로 필터링할 수 있습니다.
+
+**사용 예시**:
+- 레벨 1 문제 검색: levels: [1]
+- 레벨 1-2 문제 검색: levels: [1, 2]
+- 최신 문제 검색: order: "recent"
+- 정확도순 정렬: order: "accuracy"
+- 키워드 검색: query: "동적계획법"
+- 페이지 이동: page: 2
+
+**제한사항**:
+- Puppeteer 기반 스크래핑 (응답 시간 3-5초)
+- 페이지당 20개 문제 반환
+- 프로그래머스 레벨 체계: 0(입문), 1-5
+
+**응답 형식**:
+- 마크다운 테이블 (번호, 제목, 레벨, 카테고리, 완료자, 정답률)
+- 문제 제목은 프로그래머스 링크로 제공
+
+⚠️ **중요**: 프로그래머스는 JavaScript 렌더링이 필요하여 BOJ보다 느립니다 (3-5초).
+
+⚠️ 플랫폼 미지정 시 사용자에게 어느 플랫폼에서 검색할지 확인하세요.`,
+        inputSchema: SearchProgrammersProblemsInputSchema,
+        handler: searchProgrammersProblems,
+    };
+}
+//# sourceMappingURL=search-problems-programmers.js.map

package/dist/tools/programmers/search-problems-programmers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-problems-programmers.js","sourceRoot":"","sources":["../../../src/tools/programmers/search-problems-programmers.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-problems-boj.d.ts

@@ -0,0 +1,42 @@
+/**
+ * search_problems 도구
+ *
+ * BOJ 문제를 티어, 태그, 키워드로 검색합니다.
+ */
+import { z } from 'zod';
+/**
+ * 입력 스키마
+ *
+ * level_min/level_max는 숫자(1-30) 또는 티어 문자열(예: "실버 3", "Gold I") 모두 지원
+ */
+export declare const SearchProblemsInputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    level_min: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodEffects<z.ZodString, number, string>]>>;
+    level_max: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodEffects<z.ZodString, number, string>]>>;
+    tags: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    sort: z.ZodOptional<z.ZodEnum<["level", "id", "average_try"]>>;
+    direction: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    tags?: string | string[] | undefined;
+    sort?: "level" | "id" | "average_try" | undefined;
+    query?: string | undefined;
+    direction?: "asc" | "desc" | undefined;
+    level_min?: number | undefined;
+    level_max?: number | undefined;
+}, {
+    tags?: string | string[] | undefined;
+    sort?: "level" | "id" | "average_try" | undefined;
+    query?: string | undefined;
+    direction?: "asc" | "desc" | undefined;
+    page?: number | undefined;
+    level_min?: string | number | undefined;
+    level_max?: string | number | undefined;
+}>;
+export type SearchProblemsInput = z.infer<typeof SearchProblemsInputSchema>;
+/**
+ * 문제 검색 도구 핸들러
+ */
+export declare function searchProblems(input: SearchProblemsInput): Promise<string>;
+//# sourceMappingURL=search-problems-boj.d.ts.map

package/dist/tools/search-problems-boj.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-problems-boj.d.ts","sourceRoot":"","sources":["../../src/tools/search-problems-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EA+DpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAiD5E;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiChF"}

package/dist/tools/search-problems-boj.js

@@ -0,0 +1,143 @@
+/**
+ * search_problems 도구
+ *
+ * BOJ 문제를 티어, 태그, 키워드로 검색합니다.
+ */
+import { z } from 'zod';
+import { SolvedAcClient } from '../api/solvedac-client.js';
+import { getTierBadge, parseTierString } from '../utils/tier-converter.js';
+/**
+ * 입력 스키마
+ *
+ * level_min/level_max는 숫자(1-30) 또는 티어 문자열(예: "실버 3", "Gold I") 모두 지원
+ */
+export const SearchProblemsInputSchema = z.object({
+    query: z.string().optional().describe('검색 키워드 (제목, 번호, 태그 등)'),
+    level_min: z
+        .union([
+        z.number().int().min(1).max(30),
+        z.string().transform((val, ctx) => {
+            // 숫자 문자열이면 숫자로 변환 (예: "16" → 16)
+            const numVal = Number(val);
+            if (!isNaN(numVal) && Number.isInteger(numVal)) {
+                if (numVal < 1 || numVal > 30) {
+                    ctx.addIssue({ code: z.ZodIssueCode.custom, message: '레벨은 1-30 사이여야 합니다.' });
+                    return z.NEVER;
+                }
+                return numVal;
+            }
+            // 티어 문자열 파싱 (예: "실버 3", "Gold I")
+            try {
+                return parseTierString(val);
+            }
+            catch (error) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: error instanceof Error ? error.message : '티어 파싱 실패',
+                });
+                return z.NEVER;
+            }
+        }),
+    ])
+        .optional()
+        .describe('최소 난이도 (숫자 1-30 또는 "실버 3", "Gold I" 형식)'),
+    level_max: z
+        .union([
+        z.number().int().min(1).max(30),
+        z.string().transform((val, ctx) => {
+            // 숫자 문자열이면 숫자로 변환 (예: "17" → 17)
+            const numVal = Number(val);
+            if (!isNaN(numVal) && Number.isInteger(numVal)) {
+                if (numVal < 1 || numVal > 30) {
+                    ctx.addIssue({ code: z.ZodIssueCode.custom, message: '레벨은 1-30 사이여야 합니다.' });
+                    return z.NEVER;
+                }
+                return numVal;
+            }
+            // 티어 문자열 파싱 (예: "실버 3", "Gold I")
+            try {
+                return parseTierString(val);
+            }
+            catch (error) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: error instanceof Error ? error.message : '티어 파싱 실패',
+                });
+                return z.NEVER;
+            }
+        }),
+    ])
+        .optional()
+        .describe('최대 난이도 (숫자 1-30 또는 "실버 3", "Gold I" 형식)'),
+    tags: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe('알고리즘 태그 (예: "dp" 또는 ["dp", "greedy", "bfs"])'),
+    sort: z.enum(['level', 'id', 'average_try']).optional().describe('정렬 기준'),
+    direction: z.enum(['asc', 'desc']).optional().describe('정렬 방향'),
+    page: z.number().int().min(1).optional().default(1).describe('페이지 번호 (기본: 1)'),
+});
+/**
+ * 한글 태그명 추출
+ */
+function getKoreanTagName(tag) {
+    const korean = tag.displayNames.find(dn => dn.language === 'ko');
+    return korean?.name || tag.key;
+}
+/**
+ * 문제 검색 결과를 마크다운 테이블로 포맷팅
+ */
+function formatSearchResults(items, count, page) {
+    if (items.length === 0) {
+        return '검색 결과가 없습니다.';
+    }
+    let result = `# 문제 검색 결과\n\n`;
+    result += `**총 ${count}개 문제** (${page}페이지)\n\n`;
+    result += `| 번호 | 제목 | 난이도 | 태그 | 해결자 수 | 평균 시도 |\n`;
+    result += `|------|------|--------|------|-----------|----------|\n`;
+    for (const problem of items) {
+        const tierBadge = getTierBadge(problem.level);
+        const tags = problem.tags.slice(0, 3).map(getKoreanTagName).join(', ');
+        const tagsDisplay = problem.tags.length > 3 ? `${tags}...` : tags;
+        const bojLink = `https://www.acmicpc.net/problem/${problem.problemId}`;
+        result += `| [${problem.problemId}](${bojLink}) | ${problem.titleKo} | ${tierBadge} | ${tagsDisplay} | ${problem.acceptedUserCount.toLocaleString()}명 | ${problem.averageTries.toFixed(1)}회 |\n`;
+    }
+    result += `\n---\n`;
+    result += `💡 **팁**: 문제 번호를 클릭하면 BOJ 페이지로 이동합니다.\n`;
+    return result;
+}
+/**
+ * 문제 검색 도구 핸들러
+ */
+export async function searchProblems(input) {
+    // 입력 검증
+    if (input.level_min !== undefined && input.level_max !== undefined) {
+        if (input.level_min > input.level_max) {
+            throw new Error('level_min은 level_max보다 작거나 같아야 합니다.');
+        }
+    }
+    const client = new SolvedAcClient();
+    try {
+        // API 호출
+        const params = {
+            query: input.query,
+            level_min: input.level_min,
+            level_max: input.level_max,
+            tags: input.tags,
+            sort: input.sort,
+            direction: input.direction,
+            page: input.page,
+        };
+        const result = await client.searchProblems(params);
+        // 결과 포맷팅
+        return formatSearchResults(result.items, result.count, input.page);
+    }
+    catch (error) {
+        // 에러 메시지 포맷팅
+        if (error instanceof Error) {
+            throw new Error(`문제 검색 중 오류가 발생했습니다: ${error.message}`);
+        }
+        throw new Error('문제 검색 중 알 수 없는 오류가 발생했습니다.');
+    }
+}
+//# sourceMappingURL=search-problems-boj.js.map

package/dist/tools/search-problems-boj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-problems-boj.js","sourceRoot":"","sources":["../../src/tools/search-problems-boj.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-tags-boj.d.ts

@@ -0,0 +1,22 @@
+/**
+ * search_tags 도구
+ *
+ * 알고리즘 태그를 키워드로 검색합니다.
+ */
+import { z } from 'zod';
+/**
+ * 입력 스키마
+ */
+export declare const SearchTagsInputSchema: z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>;
+export type SearchTagsInput = z.infer<typeof SearchTagsInputSchema>;
+/**
+ * 태그 검색 도구 핸들러
+ */
+export declare function searchTags(input: SearchTagsInput): Promise<string>;
+//# sourceMappingURL=search-tags-boj.d.ts.map

package/dist/tools/search-tags-boj.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tags-boj.d.ts","sourceRoot":"","sources":["../../src/tools/search-tags-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AA0CpE;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBxE"}

package/dist/tools/search-tags-boj.js

@@ -0,0 +1,70 @@
+/**
+ * search_tags 도구
+ *
+ * 알고리즘 태그를 키워드로 검색합니다.
+ */
+import { z } from 'zod';
+import { SolvedAcClient } from '../api/solvedac-client.js';
+/**
+ * 입력 스키마
+ */
+export const SearchTagsInputSchema = z.object({
+    query: z.string().min(1).describe('태그 검색 키워드 (최소 1글자)'),
+});
+/**
+ * 다국어 태그명 추출
+ */
+function getTagNames(tag) {
+    const korean = tag.displayNames.find(dn => dn.language === 'ko')?.name || tag.key;
+    const english = tag.displayNames.find(dn => dn.language === 'en')?.name || tag.key;
+    return { korean, english };
+}
+/**
+ * 태그 검색 결과를 마크다운 테이블로 포맷팅
+ */
+function formatTagResults(tags) {
+    if (tags.length === 0) {
+        return '검색 결과가 없습니다. 다른 키워드로 시도해보세요.';
+    }
+    let result = `# 태그 검색 결과\n\n`;
+    result += `**총 ${tags.length}개 태그**\n\n`;
+    result += `| 태그 키 | 한글명 | 영문명 | 문제 수 |\n`;
+    result += `|---------|--------|--------|----------|\n`;
+    for (const tag of tags) {
+        const { korean, english } = getTagNames(tag);
+        const problemCount = tag.problemCount ? tag.problemCount.toLocaleString() : '-';
+        result += `| \`${tag.key}\` | ${korean} | ${english} | ${problemCount}개 |\n`;
+    }
+    result += `\n---\n`;
+    result += `💡 **팁**: 태그 키를 사용하여 \`search_problems\` 도구로 해당 태그의 문제를 검색할 수 있습니다.\n`;
+    result += `\n**사용 예시**:\n`;
+    result += `\`\`\`\n`;
+    result += `search_problems(tag: "${tags[0]?.key || 'dp'}")\n`;
+    result += `\`\`\`\n`;
+    return result;
+}
+/**
+ * 태그 검색 도구 핸들러
+ */
+export async function searchTags(input) {
+    // 입력 검증 (공백 제거)
+    const query = input.query.trim();
+    if (query.length === 0) {
+        throw new Error('검색 키워드는 최소 1글자 이상이어야 합니다.');
+    }
+    const client = new SolvedAcClient();
+    try {
+        // API 호출
+        const tags = await client.searchTags(query);
+        // 결과 포맷팅
+        return formatTagResults(tags);
+    }
+    catch (error) {
+        // 에러 처리
+        if (error instanceof Error) {
+            throw new Error(`태그 검색 중 오류가 발생했습니다: ${error.message}`);
+        }
+        throw new Error('태그 검색 중 알 수 없는 오류가 발생했습니다.');
+    }
+}
+//# sourceMappingURL=search-tags-boj.js.map

package/dist/tools/search-tags-boj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tags-boj.js","sourceRoot":"","sources":["../../src/tools/search-tags-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CACxD,CAAC,CAAC;AAIH;;GAEG;AACH,SAAS,WAAW,CAAC,GAAQ;IAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC;IAClF,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC;IAEnF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAW;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,8BAA8B,CAAC;IACxC,CAAC;IAED,IAAI,MAAM,GAAG,gBAAgB,CAAC;IAC9B,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,YAAY,CAAC;IACzC,MAAM,IAAI,+BAA+B,CAAC;IAC1C,MAAM,IAAI,4CAA4C,CAAC;IAEvD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAEhF,MAAM,IAAI,OAAO,GAAG,CAAC,GAAG,QAAQ,MAAM,MAAM,OAAO,MAAM,YAAY,OAAO,CAAC;IAC/E,CAAC;IAED,MAAM,IAAI,SAAS,CAAC;IACpB,MAAM,IAAI,uEAAuE,CAAC;IAClF,MAAM,IAAI,gBAAgB,CAAC;IAC3B,MAAM,IAAI,UAAU,CAAC;IACrB,MAAM,IAAI,yBAAyB,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,MAAM,CAAC;IAC9D,MAAM,IAAI,UAAU,CAAC;IAErB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,gBAAgB;IAChB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,SAAS;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE5C,SAAS;QACT,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ;QACR,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/utils/agent-skill-installer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 감지된 모든 AI 에이전트 플랫폼에 스킬을 설치합니다.
+ *
+ * - 설치된 플랫폼만 대상으로 함 (미설치 플랫폼은 건너뜀)
+ * - 로컬/전역 등록 방식에 따라 적절한 경로에 설치
+ * - 버전이 같으면 재설치 없이 건너뜀
+ */
+export declare function ensureSkillsInstalled(): Promise<void>;
+//# sourceMappingURL=agent-skill-installer.d.ts.map

package/dist/utils/agent-skill-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skill-installer.d.ts","sourceRoot":"","sources":["../../src/utils/agent-skill-installer.ts"],"names":[],"mappings":"AAoFA;;;;;;GAMG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc3D"}

package/dist/utils/agent-skill-installer.js

@@ -0,0 +1,94 @@
+import { existsSync, readFileSync, writeFileSync, readdirSync } from 'fs';
+import { mkdir, cp } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * 지원하는 AI 에이전트 플랫폼 정의
+ *
+ * 각 플랫폼의 스킬 경로 결정 규칙:
+ * - 로컬 설정 디렉토리가 cwd에 있으면 → 로컬 스킬 경로
+ * - 전역 홈 디렉토리가 있으면 → 전역 스킬 경로
+ *
+ * | 플랫폼      | 로컬 감지 기준         | 로컬 스킬 경로          | 전역 스킬 경로          |
+ * |------------|---------------------|----------------------|----------------------|
+ * | Claude Code | .mcp.json           | .claude/skills/      | ~/.claude/skills/    |
+ * | Codex CLI   | .codex/             | .codex/skills/       | ~/.codex/skills/     |
+ * | Gemini CLI  | .gemini/            | .gemini/skills/      | ~/.gemini/skills/    |
+ *
+ * Codex 참고: 프로젝트 Skills 표준 경로는 .agents/skills/ (cwd → repo root 스캔)
+ * Gemini 참고: .agents/skills/도 alias로 지원하나 .gemini/skills/ 권장
+ */
+const PLATFORMS = [
+    {
+        name: 'Claude Code',
+        localIndicator: join(process.cwd(), '.mcp.json'),
+        localSkillsDir: join(process.cwd(), '.claude', 'skills'),
+        globalHomeDir: join(homedir(), '.claude'),
+        globalSkillsDir: join(homedir(), '.claude', 'skills'),
+    },
+    {
+        name: 'Codex',
+        localIndicator: join(process.cwd(), '.codex'),
+        localSkillsDir: join(process.cwd(), '.codex', 'skills'),
+        globalHomeDir: join(homedir(), '.codex'),
+        globalSkillsDir: join(homedir(), '.codex', 'skills'),
+    },
+    {
+        name: 'Gemini',
+        localIndicator: join(process.cwd(), '.gemini'),
+        localSkillsDir: join(process.cwd(), '.gemini', 'skills'),
+        globalHomeDir: join(homedir(), '.gemini'),
+        globalSkillsDir: join(homedir(), '.gemini', 'skills'),
+    },
+];
+/** 플랫폼별 스킬을 설치할 대상 경로를 결정합니다. */
+function resolveTargetDir(platform) {
+    if (existsSync(platform.localIndicator))
+        return platform.localSkillsDir;
+    if (existsSync(platform.globalHomeDir))
+        return platform.globalSkillsDir;
+    return null; // 해당 플랫폼 미설치
+}
+/** 스킬 디렉토리에 algokit 스킬을 복사합니다. 이미 같은 버전이면 건너뜁니다. */
+async function installSkillsTo(skillsSrc, targetDir, version, platformName) {
+    const versionFile = join(targetDir, '.algokit-skills-version');
+    if (existsSync(versionFile)) {
+        const installed = readFileSync(versionFile, 'utf-8').trim();
+        if (installed === version)
+            return;
+    }
+    await mkdir(targetDir, { recursive: true });
+    // 기존 다른 스킬을 건드리지 않도록 algokit 스킬 디렉토리만 선택적 복사
+    for (const skillDir of readdirSync(skillsSrc)) {
+        await cp(join(skillsSrc, skillDir), join(targetDir, skillDir), {
+            recursive: true,
+            force: true,
+        });
+    }
+    writeFileSync(versionFile, version);
+    process.stderr.write(`[algokit] skills v${version} installed → ${targetDir} (${platformName})\n`);
+}
+/**
+ * 감지된 모든 AI 에이전트 플랫폼에 스킬을 설치합니다.
+ *
+ * - 설치된 플랫폼만 대상으로 함 (미설치 플랫폼은 건너뜀)
+ * - 로컬/전역 등록 방식에 따라 적절한 경로에 설치
+ * - 버전이 같으면 재설치 없이 건너뜀
+ */
+export async function ensureSkillsInstalled() {
+    const skillsSrc = join(__dirname, '../../skills');
+    if (!existsSync(skillsSrc))
+        return;
+    const pkgPath = join(__dirname, '../../package.json');
+    const { version } = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    await Promise.all(PLATFORMS.map(async (platform) => {
+        const targetDir = resolveTargetDir(platform);
+        if (!targetDir)
+            return;
+        await installSkillsTo(skillsSrc, targetDir, version, platform.name);
+    }));
+}
+//# sourceMappingURL=agent-skill-installer.js.map

package/dist/utils/agent-skill-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skill-installer.js","sourceRoot":"","sources":["../../src/utils/agent-skill-installer.ts"],"names":[],"mappings":"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"}

package/dist/utils/claudecode-skill-installer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 패키지에 동봉된 skills/를 적절한 위치에 설치합니다.
+ * Claude Code 환경이 아니거나 이미 같은 버전이 설치되어 있으면 건너뜁니다.
+ */
+export declare function ensureSkillsInstalled(): Promise<void>;
+//# sourceMappingURL=claudecode-skill-installer.d.ts.map

package/dist/utils/claudecode-skill-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudecode-skill-installer.d.ts","sourceRoot":"","sources":["../../src/utils/claudecode-skill-installer.ts"],"names":[],"mappings":"AAuCA;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiC3D"}