algokit-mcp 1.0.2 → 1.0.4

package/dist/tools/boj/fetch-problem-content-boj.js

@@ -0,0 +1,95 @@
+/**
+ * fetch_problem_content_boj MCP 도구
+ *
+ * Phase 6 - P6-004: BOJ 문제 본문 스크래핑 MCP 도구 구현
+ */
+import { z } from 'zod';
+import { BOJScraper, BojFetchError } from '../../api/boj-scraper.js';
+import { parseProblemContent, HtmlParseError } from '../../utils/html-parser.js';
+/**
+ * 입력 스키마
+ */
+export const FetchProblemContentBOJInputSchema = z.object({
+    problem_id: z.number().int().positive()
+        .describe('백준 문제 번호'),
+});
+/**
+ * fetch_problem_content_boj 도구 핸들러
+ *
+ * @param args - 입력 인자 (problem_id)
+ * @returns ProblemContent JSON 문자열
+ * @throws {Error} 검증 실패, 스크래핑 실패, 파싱 실패 시
+ */
+export async function handleFetchProblemContentBOJ(args) {
+    try {
+        // 1. 입력 검증
+        const { problem_id } = FetchProblemContentBOJInputSchema.parse(args);
+        // 2. BOJ 페이지 스크래핑
+        const scraper = new BOJScraper();
+        const html = await scraper.fetchProblemPage(problem_id);
+        // 3. HTML 파싱
+        const content = parseProblemContent(html, problem_id);
+        // 4. JSON 문자열로 반환
+        return {
+            type: 'text',
+            text: JSON.stringify(content, null, 2),
+        };
+    }
+    catch (error) {
+        // Zod 검증 에러
+        if (error instanceof z.ZodError) {
+            throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+        }
+        // BOJ 스크래핑 에러
+        if (error instanceof BojFetchError) {
+            if (error.code === 'NOT_FOUND') {
+                throw new Error(`문제를 찾을 수 없습니다: ${args.problem_id}번`);
+            }
+            if (error.code === 'TIMEOUT') {
+                throw new Error(`문제 페이지 요청이 타임아웃되었습니다: ${args.problem_id}번`);
+            }
+            if (error.code === 'NETWORK_ERROR') {
+                throw new Error(`네트워크 에러가 발생했습니다: ${error.message}`);
+            }
+            if (error.code === 'PARSE_ERROR') {
+                throw new Error(`문제 페이지 응답을 처리할 수 없습니다: ${error.message}`);
+            }
+        }
+        // HTML 파싱 에러
+        if (error instanceof HtmlParseError) {
+            throw new Error(`HTML 파싱 실패 (${error.field}): ${error.message}`);
+        }
+        // 기타 에러
+        throw error;
+    }
+}
+/**
+ * MCP 도구 정의
+ */
+export function fetchProblemContentBOJTool() {
+    return {
+        name: 'fetch_problem_content_boj',
+        description: `백준(BOJ) 문제 본문 스크래핑 (힌트 제외).
+
+BOJ 페이지에서 문제 제목, 설명, 입출력 형식, 예제, 제한사항을 가져옵니다.
+**힌트는 포함되지 않습니다** - generate_hint_boj 도구를 사용하세요.
+
+응답 구조: problemId, title, description, inputFormat, outputFormat, examples, limits, metadata
+
+**사용 시나리오**:
+- 문제 풀이 전 문제 본문 확인
+- 문제 복습 시 문제 내용 참조
+- 코드 분석 시 문제 요구사항 비교
+
+**제한사항**:
+- 스크래핑 대상: https://www.acmicpc.net/problem/{problem_id}
+- 타임아웃: 10초
+- 재시도: 최대 2회
+- 캐시: 30일
+
+⚠️ 플랫폼 판별: 문제 번호만 입력된 경우 대화 맥락에서 플랫폼을 파악하거나, 맥락이 없으면 반드시 BOJ/프로그래머스 중 어느 플랫폼인지 사용자에게 확인 후 호출하세요.`,
+        inputSchema: FetchProblemContentBOJInputSchema,
+        handler: handleFetchProblemContentBOJ,
+    };
+}
+//# sourceMappingURL=fetch-problem-content-boj.js.map

package/dist/tools/boj/fetch-problem-content-boj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-problem-content-boj.js","sourceRoot":"","sources":["../../../src/tools/boj/fetch-problem-content-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACpC,QAAQ,CAAC,UAAU,CAAC;CACxB,CAAC,CAAC;AAYH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,IAAa;IAC9D,IAAI,CAAC;QACH,WAAW;QACX,MAAM,EAAE,UAAU,EAAE,GAAG,iCAAiC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErE,kBAAkB;QAClB,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAExD,aAAa;QACb,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEtD,kBAAkB;QAClB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY;QACZ,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,cAAc;QACd,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,kBAAmB,IAAoC,CAAC,UAAU,GAAG,CAAC,CAAC;YACzF,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,yBAA0B,IAAoC,CAAC,UAAU,GAAG,CAAC,CAAC;YAChG,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,aAAa;QACb,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,QAAQ;QACR,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;iGAkBgF;QAC7F,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,4BAA4B;KACtC,CAAC;AACJ,CAAC"}

package/dist/tools/boj/generate-hint-boj.d.ts

@@ -0,0 +1,42 @@
+/**
+ * generate_hint_boj MCP 도구
+ *
+ * BOJ 문제 힌트 가이드 생성 (SRP: 힌트만)
+ */
+import { z } from 'zod';
+import type { ProblemAnalyzer } from '../../services/problem-analyzer.js';
+/**
+ * 입력 스키마
+ */
+export declare const GenerateHintBOJInputSchema: z.ZodObject<{
+    problem_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    problem_id: number;
+}, {
+    problem_id: number;
+}>;
+export type GenerateHintBOJInput = z.infer<typeof GenerateHintBOJInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * generate-hint 도구 핸들러
+ */
+export declare function generateHintBOJTool(analyzer: ProblemAnalyzer): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        problem_id: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        problem_id: number;
+    }, {
+        problem_id: number;
+    }>;
+    handler: (input: GenerateHintBOJInput) => Promise<TextContent>;
+};
+export {};
+//# sourceMappingURL=generate-hint-boj.d.ts.map

package/dist/tools/boj/generate-hint-boj.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-boj.d.ts","sourceRoot":"","sources":["../../../src/tools/boj/generate-hint-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAG1E;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;EAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe;;;;;;;;;;qBAqClC,oBAAoB,KAAG,OAAO,CAAC,WAAW,CAAC;EA6BrE"}

package/dist/tools/boj/generate-hint-boj.js

@@ -0,0 +1,82 @@
+/**
+ * generate_hint_boj MCP 도구
+ *
+ * BOJ 문제 힌트 가이드 생성 (SRP: 힌트만)
+ */
+import { z } from 'zod';
+import { ProblemNotFoundError } from '../../api/types.js';
+/**
+ * 입력 스키마
+ */
+export const GenerateHintBOJInputSchema = z.object({
+    problem_id: z.number().int().positive()
+        .describe('백준 문제 번호'),
+});
+/**
+ * generate-hint 도구 핸들러
+ */
+export function generateHintBOJTool(analyzer) {
+    return {
+        name: 'generate_hint_boj',
+        description: `백준(BOJ) 문제 힌트 생성. 3단계 가이드 프롬프트 제공.
+
+🎯 **핵심: 한 번에 1개 레벨 힌트만 제공. 1,2,3 단계를 동시에 제시하지 마세요.**
+
+📋 응답에 포함된 정보:
+- hint_levels[0]: Level 1 - 문제 분석 (처음 시도)
+- hint_levels[1]: Level 2 - 핵심 아이디어 (부분 구현)
+- hint_levels[2]: Level 3 - 상세 풀이 (거의 완성)
+
+🤖 **사용자 상황 판단 → 적절한 1개 레벨만 제시**:
+
+1️⃣ Level 1 제시 (처음/막힐 때):
+   "사용자가 코드 없거나 어디서부터 시작해야 할지 모를 때"
+   → hint_levels[0].prompt로 문제 접근법 제시
+
+2️⃣ Level 2 제시 (다시 요청하거나 부분 구현 언급):
+   "사용자가 '더 필요해', '더 자세히' 요청하거나, 이미 코드를 시작했다고 언급"
+   → hint_levels[1].prompt로 핵심 로직 제시
+
+3️⃣ Level 3 제시 (상세 풀이 명시 요청):
+   "사용자가 '정답', '풀이', '코드' 등 최종 답변 요청"
+   → hint_levels[2].prompt로 상세 구현 가이드 제시
+
+📖 **[권장] 어려운 문제는 본문 먼저 확인**:
+   - 난이도 높은 문제(Gold 이상, level ≥ 11)는 메타데이터만으로 부족할 수 있음
+   - fetch_problem_content로 실제 문제 본문 확인 후 힌트 생성 권장
+   - 문제 본문을 보면 더 정확하고 맞춤형 힌트 제공 가능
+   - 예: mcp-cli call algokit/fetch_problem_content '{"problem_id": 1234}'
+   - 본문 확인은 권장사항이며 필수는 아님
+
+**정답 정책**: 힌트만 기본 제공. 사용자가 "정답", "풀이", "코드" 명시 요청 시만 전체 풀이 제공.
+
+⚠️ 플랫폼 판별: 문제 번호만 입력된 경우 대화 맥락에서 플랫폼을 파악하거나, 맥락이 없으면 반드시 BOJ/프로그래머스 중 어느 플랫폼인지 사용자에게 확인 후 호출하세요.`,
+        inputSchema: GenerateHintBOJInputSchema,
+        handler: async (input) => {
+            try {
+                // 입력 검증
+                const { problem_id } = GenerateHintBOJInputSchema.parse(input);
+                // 힌트 가이드 생성 (유사 문제 제외)
+                const result = await analyzer.analyze(problem_id, false);
+                // JSON 문자열로 반환 (Claude Code가 파싱)
+                return {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                };
+            }
+            catch (error) {
+                // Zod 검증 에러
+                if (error instanceof z.ZodError) {
+                    throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+                }
+                // ProblemNotFoundError
+                if (error instanceof ProblemNotFoundError) {
+                    throw new Error(`문제를 찾을 수 없습니다: ${input.problem_id}번`);
+                }
+                // 기타 에러
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=generate-hint-boj.js.map

package/dist/tools/boj/generate-hint-boj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-hint-boj.js","sourceRoot":"","sources":["../../../src/tools/boj/generate-hint-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACpC,QAAQ,CAAC,UAAU,CAAC;CACxB,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAyB;IAC3D,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iGAgCgF;QAC7F,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,KAAK,EAAE,KAA2B,EAAwB,EAAE;YACnE,IAAI,CAAC;gBACH,QAAQ;gBACR,MAAM,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAE/D,uBAAuB;gBACvB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBAEzD,iCAAiC;gBACjC,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY;gBACZ,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1D,CAAC;gBAED,uBAAuB;gBACvB,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;oBAC1C,MAAM,IAAI,KAAK,CAAC,kBAAmB,KAA8B,CAAC,UAAU,GAAG,CAAC,CAAC;gBACnF,CAAC;gBAED,QAAQ;gBACR,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/boj/generate-review-template-boj.d.ts

@@ -0,0 +1,48 @@
+/**
+ * generate_review_template_boj MCP 도구
+ *
+ * BOJ 복습 템플릿 및 가이드 제공 (Keyless Architecture)
+ */
+import { z } from 'zod';
+import type { ReviewTemplateGenerator } from '../../services/review-template-generator.js';
+/**
+ * 입력 스키마
+ */
+export declare const GenerateReviewTemplateBOJInputSchema: z.ZodObject<{
+    problem_id: z.ZodNumber;
+    user_notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    problem_id: number;
+    user_notes?: string | undefined;
+}, {
+    problem_id: number;
+    user_notes?: string | undefined;
+}>;
+export type GenerateReviewTemplateBOJInput = z.infer<typeof GenerateReviewTemplateBOJInputSchema>;
+/**
+ * MCP TextContent 타입
+ */
+interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * generate_review_template_boj 도구 핸들러
+ */
+export declare function generateReviewTemplateBOJTool(generator: ReviewTemplateGenerator): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        problem_id: z.ZodNumber;
+        user_notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        problem_id: number;
+        user_notes?: string | undefined;
+    }, {
+        problem_id: number;
+        user_notes?: string | undefined;
+    }>;
+    handler: (input: GenerateReviewTemplateBOJInput) => Promise<TextContent>;
+};
+export {};
+//# sourceMappingURL=generate-review-template-boj.d.ts.map

package/dist/tools/boj/generate-review-template-boj.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-review-template-boj.d.ts","sourceRoot":"","sources":["../../../src/tools/boj/generate-review-template-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAG3F;;GAEG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;EAK/C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,uBAAuB;;;;;;;;;;;;;qBAKrD,8BAA8B,KAAG,OAAO,CAAC,WAAW,CAAC;EA6B/E"}

package/dist/tools/boj/generate-review-template-boj.js

@@ -0,0 +1,52 @@
+/**
+ * generate_review_template_boj MCP 도구
+ *
+ * BOJ 복습 템플릿 및 가이드 제공 (Keyless Architecture)
+ */
+import { z } from 'zod';
+import { ProblemNotFoundError } from '../../api/types.js';
+/**
+ * 입력 스키마
+ */
+export const GenerateReviewTemplateBOJInputSchema = z.object({
+    problem_id: z.number().int().positive()
+        .describe('백준 문제 번호'),
+    user_notes: z.string().optional()
+        .describe('사용자가 미리 작성한 메모 (선택)'),
+});
+/**
+ * generate_review_template_boj 도구 핸들러
+ */
+export function generateReviewTemplateBOJTool(generator) {
+    return {
+        name: 'generate_review_template_boj',
+        description: '백준(BOJ) 문제에 대한 사용자의 제출 코드와 문제 본문을 분석해서 사용자 맞춤형 복기용 가이드를 제공합니다. 마크다운 템플릿, 문제 분석, 관련 문제, 작성 프롬프트를 포함합니다.\n\n⚠️ 플랫폼 판별: 문제 번호만 입력된 경우 대화 맥락에서 플랫폼을 파악하거나, 맥락이 없으면 반드시 BOJ/프로그래머스 중 어느 플랫폼인지 사용자에게 확인 후 호출하세요.',
+        inputSchema: GenerateReviewTemplateBOJInputSchema,
+        handler: async (input) => {
+            try {
+                // 입력 검증
+                const { problem_id, user_notes } = GenerateReviewTemplateBOJInputSchema.parse(input);
+                // 템플릿 생성
+                const template = await generator.generate(problem_id, user_notes);
+                // JSON 문자열로 반환
+                return {
+                    type: 'text',
+                    text: JSON.stringify(template, null, 2),
+                };
+            }
+            catch (error) {
+                // Zod 검증 에러
+                if (error instanceof z.ZodError) {
+                    throw new Error(`입력 검증 실패: ${error.issues[0].message}`);
+                }
+                // ProblemNotFoundError
+                if (error instanceof ProblemNotFoundError) {
+                    throw new Error(`문제를 찾을 수 없습니다: ${input.problem_id}번`);
+                }
+                // 기타 에러
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=generate-review-template-boj.js.map

package/dist/tools/boj/generate-review-template-boj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-review-template-boj.js","sourceRoot":"","sources":["../../../src/tools/boj/generate-review-template-boj.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACpC,QAAQ,CAAC,UAAU,CAAC;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B,QAAQ,CAAC,qBAAqB,CAAC;CACnC,CAAC,CAAC;AAYH;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,SAAkC;IAC9E,OAAO;QACL,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,4MAA4M;QACzN,WAAW,EAAE,oCAAoC;QACjD,OAAO,EAAE,KAAK,EAAE,KAAqC,EAAwB,EAAE;YAC7E,IAAI,CAAC;gBACH,QAAQ;gBACR,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,oCAAoC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAErF,SAAS;gBACT,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;gBAElE,eAAe;gBACf,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY;gBACZ,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1D,CAAC;gBAED,uBAAuB;gBACvB,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;oBAC1C,MAAM,IAAI,KAAK,CAAC,kBAAmB,KAAwC,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC7F,CAAC;gBAED,QAAQ;gBACR,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/boj/get-problem-boj.d.ts

@@ -0,0 +1,22 @@
+/**
+ * get_problem 도구
+ *
+ * 특정 BOJ 문제의 상세 정보를 조회합니다.
+ */
+import { z } from 'zod';
+/**
+ * 입력 스키마
+ */
+export declare const GetProblemInputSchema: z.ZodObject<{
+    problem_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    problem_id: number;
+}, {
+    problem_id: number;
+}>;
+export type GetProblemInput = z.infer<typeof GetProblemInputSchema>;
+/**
+ * 문제 상세 조회 도구 핸들러
+ */
+export declare function getProblem(input: GetProblemInput): Promise<string>;
+//# sourceMappingURL=get-problem-boj.d.ts.map

package/dist/tools/boj/get-problem-boj.d.ts.map

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

package/dist/tools/boj/get-problem-boj.js

@@ -0,0 +1,89 @@
+/**
+ * get_problem 도구
+ *
+ * 특정 BOJ 문제의 상세 정보를 조회합니다.
+ */
+import { z } from 'zod';
+import { SolvedAcClient } from '../../api/solvedac-client.js';
+import { ProblemNotFoundError } from '../../api/types.js';
+import { getTierBadge, levelToTier } from '../../utils/tier-converter.js';
+/**
+ * 입력 스키마
+ */
+export const GetProblemInputSchema = z.object({
+    problem_id: z.number().int().positive().describe('BOJ 문제 번호 (양의 정수)'),
+});
+/**
+ * 한글 태그명 추출 (우선순위: 한글 > 영어 > 키)
+ */
+function getKoreanTagName(tag) {
+    const korean = tag.displayNames.find(dn => dn.language === 'ko');
+    if (korean)
+        return korean.name;
+    const english = tag.displayNames.find(dn => dn.language === 'en');
+    if (english)
+        return english.name;
+    return tag.key;
+}
+/**
+ * 문제 상세 정보를 마크다운으로 포맷팅
+ */
+function formatProblemDetail(problem) {
+    const tierBadge = getTierBadge(problem.level);
+    const tierName = levelToTier(problem.level);
+    const bojLink = `https://www.acmicpc.net/problem/${problem.problemId}`;
+    let result = `# [${problem.problemId}] ${problem.titleKo}\n\n`;
+    // 기본 정보
+    result += `## 📋 기본 정보\n\n`;
+    result += `- **문제 번호**: ${problem.problemId}\n`;
+    result += `- **제목**: ${problem.titleKo}\n`;
+    result += `- **난이도**: ${tierBadge} (레벨 ${problem.level})\n`;
+    result += `- **링크**: [BOJ ${problem.problemId}](${bojLink})\n\n`;
+    // 태그
+    if (problem.tags.length > 0) {
+        result += `## 🏷️ 알고리즘 태그\n\n`;
+        const tagList = problem.tags.map(tag => {
+            const koreanName = getKoreanTagName(tag);
+            return `- **${koreanName}** (\`${tag.key}\`)`;
+        }).join('\n');
+        result += `${tagList}\n\n`;
+    }
+    // 통계
+    result += `## 📊 통계\n\n`;
+    result += `- **해결한 사용자**: ${problem.acceptedUserCount.toLocaleString()}명\n`;
+    result += `- **평균 시도 횟수**: ${problem.averageTries.toFixed(1)}회\n`;
+    // 풀이 가능 여부
+    if (problem.isSolvable !== undefined) {
+        result += `- **풀이 가능**: ${problem.isSolvable ? '✅ 예' : '❌ 아니오'}\n`;
+    }
+    if (problem.isPartial !== undefined) {
+        result += `- **부분 점수**: ${problem.isPartial ? '✅ 있음' : '❌ 없음'}\n`;
+    }
+    result += `\n---\n`;
+    result += `💡 **팁**: 위 링크를 클릭하면 BOJ에서 문제를 확인할 수 있습니다.\n`;
+    return result;
+}
+/**
+ * 문제 상세 조회 도구 핸들러
+ */
+export async function getProblem(input) {
+    const client = new SolvedAcClient();
+    try {
+        // API 호출
+        const problem = await client.getProblem(input.problem_id);
+        // 결과 포맷팅
+        return formatProblemDetail(problem);
+    }
+    catch (error) {
+        // 에러 처리
+        if (error instanceof ProblemNotFoundError) {
+            throw new Error(`문제 ${input.problem_id}를 찾을 수 없습니다. 문제 번호를 확인해주세요.\n` +
+                `BOJ 링크: https://www.acmicpc.net/problem/${input.problem_id}`);
+        }
+        if (error instanceof Error) {
+            throw new Error(`문제 조회 중 오류가 발생했습니다: ${error.message}`);
+        }
+        throw new Error('문제 조회 중 알 수 없는 오류가 발생했습니다.');
+    }
+}
+//# sourceMappingURL=get-problem-boj.js.map

package/dist/tools/boj/get-problem-boj.js.map

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

package/dist/tools/boj/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;
+    sort?: "level" | "id" | "average_try" | undefined;
+    tags?: string | string[] | undefined;
+    query?: string | undefined;
+    direction?: "asc" | "desc" | undefined;
+    level_min?: number | undefined;
+    level_max?: number | undefined;
+}, {
+    sort?: "level" | "id" | "average_try" | undefined;
+    tags?: string | string[] | 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/boj/search-problems-boj.d.ts.map

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