swwa-mcp 0.1.0

package/dist/tools/audit-url.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { assertUrlAllowed, BlockedUrlError } from "../engine/url-guard.js";
+import { runBrowser, NoBrowserError, NavigationError, BrowserTimeoutError } from "../engine/browser.js";
+import { summarize } from "../report/summarize.js";
+import { formatReportText } from "../report/format.js";
+import { reportOutputShape } from "./report-schema.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 120_000;
+const DEFAULT_MAX_FINDINGS = 200;
+function errorResult(code, message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+        structuredContent: { code },
+    };
+}
+export function registerAuditUrlTool(server, data) {
+    server.registerTool("audit_url", {
+        title: "브라우저 접근성 감사",
+        description: "실제 브라우저로 URL을 열어 KWCAG 2.2 기준 감사(axe + 초점·타깃 크기·본문 바로가기 등 동적 검사)를 수행한다. 사이트 점검·인증 준비 시 호출한다. 먼저 browser_status로 브라우저 가용성을 확인하라.",
+        inputSchema: {
+            url: z.string().min(1).describe("http/https/file. localhost 허용, 링크로컬·메타데이터 호스트 차단"),
+            viewport: z.enum(["desktop", "mobile"]).default("desktop"),
+            waitFor: z.string().default("load").describe('"load" | "networkidle" | CSS 셀렉터'),
+            timeoutMs: z.number().int().positive().max(MAX_TIMEOUT_MS).default(DEFAULT_TIMEOUT_MS),
+            checks: z.array(z.enum(["axe", "b-rules", "keyboard"])).optional().describe("기본 전부"),
+            screenshot: z.boolean().default(false),
+            outputDir: z.string().optional().describe("지정 시 스크린샷 저장(경로만 반환)"),
+            headers: z.record(z.string(), z.string()).optional(),
+            excludeRules: z.array(z.string()).optional(),
+            maxFindings: z.number().int().positive().default(DEFAULT_MAX_FINDINGS),
+        },
+        outputSchema: {
+            ...reportOutputShape,
+            meta: z.object({
+                finalUrl: z.string(),
+                title: z.string().optional(),
+                viewport: z.enum(["desktop", "mobile"]),
+                browser: z.object({ channel: z.string(), version: z.string() }),
+                durationMs: z.number(),
+                screenshotPath: z.string().optional(),
+            }),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ url, viewport, waitFor, timeoutMs, checks, screenshot, outputDir, headers, excludeRules, maxFindings }) => {
+        let parsedUrl;
+        try {
+            parsedUrl = assertUrlAllowed(url);
+        }
+        catch (err) {
+            if (err instanceof BlockedUrlError)
+                return errorResult("E_BLOCKED_URL", err.message);
+            throw err;
+        }
+        const start = Date.now();
+        let engineResult;
+        try {
+            engineResult = await runBrowser({
+                url: parsedUrl.href,
+                viewport,
+                waitFor,
+                timeoutMs,
+                checks,
+                headers,
+                excludeRules,
+                screenshot,
+                outputDir,
+                data,
+            });
+        }
+        catch (err) {
+            if (err instanceof NoBrowserError)
+                return errorResult("E_NO_BROWSER", err.message);
+            if (err instanceof BrowserTimeoutError)
+                return errorResult("E_TIMEOUT", err.message);
+            if (err instanceof NavigationError)
+                return errorResult("E_NAV", err.message);
+            return errorResult("E_INTERNAL", "브라우저 감사 중 오류가 발생했습니다.");
+        }
+        const durationMs = Date.now() - start;
+        const { verdict, summary, checkpoints, findings, manualChecklist, notices } = summarize(engineResult.findings, "browser", data, maxFindings);
+        const report = {
+            engine: { name: "swwa", version: "0.1.0", axe: "4.13.0", mode: "browser" },
+            target: { kind: "url", ref: parsedUrl.href, title: engineResult.title },
+            verdict,
+            summary,
+            checkpoints,
+            findings,
+            manualChecklist,
+            notices,
+        };
+        const structuredContent = {
+            ...report,
+            meta: {
+                finalUrl: engineResult.finalUrl,
+                title: engineResult.title,
+                viewport,
+                browser: engineResult.browser,
+                durationMs,
+                screenshotPath: engineResult.screenshotPath,
+            },
+        };
+        return {
+            content: [{ type: "text", text: formatReportText(report) }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=audit-url.js.map

package/dist/tools/audit-url.js.map

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

package/dist/tools/browser-status.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { detectBrowser } from "../engine/browser-detect.js";
+export function registerBrowserStatusTool(server) {
+    server.registerTool("browser_status", {
+        title: "브라우저 가용성 확인",
+        description: "audit_url이 사용할 브라우저(Chrome→Edge→Playwright chromium)가 설치되어 있는지 확인한다. audit_url 호출 전에 먼저 확인하라.",
+        inputSchema: {
+            refresh: z.boolean().default(false).describe("true면 프로세스 내 캐시를 무시하고 다시 탐지"),
+        },
+        outputSchema: {
+            available: z.boolean(),
+            channel: z.enum(["chrome", "msedge", "chromium"]).nullable(),
+            version: z.string().optional(),
+            executablePath: z.string().optional(),
+            installHint: z.string(),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ refresh }) => {
+        const status = await detectBrowser({ refresh });
+        const summary = status.available
+            ? `사용 가능: ${status.channel}${status.version ? ` ${status.version}` : ""}`
+            : `사용 불가 — ${status.installHint}`;
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: { ...status },
+        };
+    });
+}
+//# sourceMappingURL=browser-status.js.map

package/dist/tools/browser-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-status.js","sourceRoot":"","sources":["../../src/tools/browser-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,+FAA+F;QAC5G,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;SAC5E;QACD,YAAY,EAAE;YACZ,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;YACtB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;SACxB;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS;YAC9B,CAAC,CAAC,UAAU,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACzE,CAAC,CAAC,WAAW,MAAM,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACnD,iBAAiB,EAAE,EAAE,GAAG,MAAM,EAAE;SACjC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/cert-readiness.js

@@ -0,0 +1,76 @@
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+import { estimateCertReadiness } from "../report/cert.js";
+const MAX_REPORTS = 50;
+// 입력 Report는 checkpoints[].{id,status}만 있으면 된다(느슨하게 받되 형태는 검증한다).
+const inputReportSchema = z.object({
+    checkpoints: z
+        .array(z.object({
+        id: z.string(),
+        status: z.enum(["fail", "incomplete", "manual", "pass", "na"]),
+    }))
+        .min(1),
+});
+function errorResult(code, message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+        structuredContent: { code },
+    };
+}
+export function registerCertReadinessTool(server, data) {
+    server.registerTool("estimate_cert_readiness", {
+        title: "인증 준비도 추정",
+        description: "여러 페이지의 검사 Report를 검사항목별 준수율로 집계해 웹 접근성 품질인증 준비도를 추정한다. 자동 검사만으로 인증 통과를 판정하지 않으며 수동·사용자 심사 잔여를 함께 알린다.",
+        inputSchema: {
+            reports: z.array(z.unknown()).max(MAX_REPORTS).optional().describe("check_html·audit_url의 Report 배열(reportPaths와 택1)"),
+            reportPaths: z.array(z.string()).max(MAX_REPORTS).optional().describe("Report JSON 파일 경로 배열(reports와 택1)"),
+            pageCount: z.number().int().positive().optional().describe("표본 총 페이지 수(미지정 시 report 수)"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ reports, reportPaths, pageCount }) => {
+        if ((reports === undefined) === (reportPaths === undefined)) {
+            return errorResult("E_INPUT", "reports와 reportPaths 중 정확히 하나만 지정하세요.");
+        }
+        let rawReports;
+        if (reports !== undefined) {
+            rawReports = reports;
+        }
+        else {
+            rawReports = [];
+            for (const path of reportPaths) {
+                let json;
+                try {
+                    json = JSON.parse(readFileSync(path, "utf8"));
+                }
+                catch {
+                    return errorResult("E_NOT_FOUND", `Report 파일을 읽을 수 없습니다: ${path}`);
+                }
+                rawReports.push(json);
+            }
+        }
+        if (rawReports.length === 0)
+            return errorResult("E_INPUT", "집계할 Report가 없습니다.");
+        if (rawReports.length > MAX_REPORTS)
+            return errorResult("E_INPUT", `Report는 최대 ${MAX_REPORTS}건입니다.`);
+        const parsed = [];
+        for (const raw of rawReports) {
+            const result = inputReportSchema.safeParse(raw);
+            if (!result.success) {
+                return errorResult("E_INPUT", "Report 형식이 올바르지 않습니다(checkpoints[].id·status 필요).");
+            }
+            parsed.push(result.data);
+        }
+        const readiness = estimateCertReadiness(parsed, pageCount, data);
+        const text = [
+            `인증 준비도(추정): 자동 검사 커버리지 ${Math.round(readiness.overall.autoCheckedCoverage * 100)}% · 추정 전문가 준수율 ${Math.round(readiness.overall.estimatedExpertRate * 100)}% · 표본 ${readiness.overall.pagesAudited}p`,
+            readiness.gaps.length > 0
+                ? `우선 조치(${readiness.gaps.length}): ${readiness.gaps.slice(0, 5).map((g) => `${g.id}(${g.failingPages}p)`).join(", ")}`
+                : "자동 등급 항목에서 기준 미달 항목 없음",
+            `수동·사용자 심사 잔여 ${readiness.manualRemaining.length}항목`,
+            ...readiness.notices.map((n) => `- ${n}`),
+        ].join("\n");
+        return { content: [{ type: "text", text }], structuredContent: { ...readiness } };
+    });
+}
+//# sourceMappingURL=cert-readiness.js.map

package/dist/tools/cert-readiness.js.map

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

package/dist/tools/check-contrast.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { evaluateContrast } from "../color/contrast.js";
+function errorResult(code, message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+        structuredContent: { code },
+    };
+}
+export function registerCheckContrastTool(server) {
+    server.registerTool("check_contrast", {
+        title: "명도 대비 계산",
+        description: "두 색상 사이의 명도 대비를 계산하고 KWCAG 5.4.3(1.4.3) 기준 통과 여부를 판정한다.",
+        inputSchema: {
+            foreground: z.string().describe("전경(텍스트) 색. hex/rgb()/rgba()/hsl()/hsla()/CSS 색 이름"),
+            background: z.string().describe("배경 색. hex/rgb()/rgba()/hsl()/hsla()/CSS 색 이름"),
+            fontSizePx: z.number().positive().default(16),
+            bold: z.boolean().default(false),
+        },
+        outputSchema: {
+            ratio: z.number(),
+            largeText: z.boolean(),
+            aa: z.enum(["pass", "fail"]),
+            aaa: z.enum(["pass", "fail"]),
+            kwcag: z.literal("5.4.3"),
+            alias: z.literal("1.4.3"),
+            threshold: z.number(),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ foreground, background, fontSizePx, bold }) => {
+        let evaluation;
+        try {
+            evaluation = evaluateContrast(foreground, background, fontSizePx, bold);
+        }
+        catch (err) {
+            return errorResult("E_INPUT", err instanceof Error ? err.message : "색상 값을 해석할 수 없습니다.");
+        }
+        const structuredContent = {
+            ratio: Math.round(evaluation.ratio * 100) / 100,
+            largeText: evaluation.largeText,
+            aa: evaluation.aa,
+            aaa: evaluation.aaa,
+            kwcag: "5.4.3",
+            alias: "1.4.3",
+            threshold: evaluation.threshold,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `대비 ${structuredContent.ratio}:1 · AA ${structuredContent.aa} · AAA ${structuredContent.aaa} (5.4.3/1.4.3)`,
+                },
+            ],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=check-contrast.js.map

package/dist/tools/check-contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-contrast.js","sourceRoot":"","sources":["../../src/tools/check-contrast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,SAAS,WAAW,CAAC,IAAY,EAAE,OAAe;IAChD,OAAO;QACL,OAAO,EAAE,IAAa;QACtB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,iBAAiB,EAAE,EAAE,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;YACpF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACjC;QACD,YAAY,EAAE;YACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;YACtB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5B,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;QAC/C,IAAI,UAAU,CAAC;QACf,IAAI,CAAC;YACH,UAAU,GAAG,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,SAAS,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,iBAAiB,GAAG;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;YAC/C,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,GAAG,EAAE,UAAU,CAAC,GAAG;YACnB,KAAK,EAAE,OAAgB;YACvB,KAAK,EAAE,OAAgB;YACvB,SAAS,EAAE,UAAU,CAAC,SAAS;SAChC,CAAC;QACF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,MAAM,iBAAiB,CAAC,KAAK,WAAW,iBAAiB,CAAC,EAAE,UAAU,iBAAiB,CAAC,GAAG,gBAAgB;iBAClH;aACF;YACD,iBAAiB;SAClB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/check-html.js

@@ -0,0 +1,88 @@
+import { readFileSync, statSync } from "node:fs";
+import { z } from "zod";
+import { runStatic, EngineTimeoutError } from "../engine/static.js";
+import { summarize } from "../report/summarize.js";
+import { formatReportText } from "../report/format.js";
+import { reportOutputShape } from "./report-schema.js";
+const MAX_HTML_CHARS = 2_000_000;
+const MAX_FILE_BYTES = 2 * 1024 * 1024;
+const DEFAULT_MAX_FINDINGS = 200;
+function errorResult(code, message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+        structuredContent: { code },
+    };
+}
+export function registerCheckHtmlTool(server, data) {
+    server.registerTool("check_html", {
+        title: "HTML 정적 접근성 검사",
+        description: "HTML 문자열이나 로컬 HTML 파일을 KWCAG 2.2 기준으로 정적 검사한다. 웹 UI 코드를 작성·수정·리뷰할 때 반드시 호출한다. 브라우저 없이 동작하며, 렌더링이 필요한 항목(명도 대비·초점 표시·타깃 크기)은 '브라우저 감사 필요'로 표시한다.",
+        inputSchema: {
+            html: z.string().optional().describe("검사할 HTML 문자열(path와 택1)"),
+            path: z.string().optional().describe("로컬 .html/.htm 파일 경로(html과 택1)"),
+            baseUrl: z.string().optional().describe("상대 링크·#target 해석용"),
+            ruleset: z.enum(["kwcag22", "wcag22aa"]).default("kwcag22"),
+            excludeRules: z.array(z.string()).optional().describe("제외할 axe·k 규칙 ID"),
+            maxFindings: z.number().int().positive().default(DEFAULT_MAX_FINDINGS),
+        },
+        outputSchema: reportOutputShape,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ html, path, baseUrl, ruleset, excludeRules, maxFindings }) => {
+        if ((html === undefined) === (path === undefined)) {
+            return errorResult("E_INPUT", "html과 path 중 정확히 하나만 지정하세요.");
+        }
+        let source;
+        let targetKind;
+        let targetRef;
+        if (html !== undefined) {
+            if (html.length === 0)
+                return errorResult("E_INPUT", "html이 비어 있습니다.");
+            if (html.length > MAX_HTML_CHARS)
+                return errorResult("E_SIZE", `html이 ${MAX_HTML_CHARS}자를 초과합니다.`);
+            source = html;
+            targetKind = "html";
+            targetRef = "(inline html)";
+        }
+        else {
+            const filePath = path;
+            let stat;
+            try {
+                stat = statSync(filePath);
+            }
+            catch {
+                return errorResult("E_NOT_FOUND", `파일을 찾을 수 없습니다: ${filePath}`);
+            }
+            if (stat.size > MAX_FILE_BYTES)
+                return errorResult("E_SIZE", "파일이 2MB를 초과합니다.");
+            source = readFileSync(filePath, "utf8");
+            targetKind = "file";
+            targetRef = filePath;
+        }
+        let engineResult;
+        try {
+            engineResult = await runStatic({ html: source, baseUrl, ruleset, excludeRules, data });
+        }
+        catch (err) {
+            if (err instanceof EngineTimeoutError)
+                return errorResult("E_TIMEOUT", "정적 검사 시간이 초과되었습니다.");
+            return errorResult("E_INTERNAL", "정적 검사 중 오류가 발생했습니다.");
+        }
+        const { verdict, summary, checkpoints, findings, manualChecklist, notices } = summarize(engineResult.findings, "static", data, maxFindings);
+        const report = {
+            engine: { name: "swwa", version: "0.1.0", axe: "4.13.0", mode: "static" },
+            target: { kind: targetKind, ref: targetRef, title: engineResult.title },
+            verdict,
+            summary,
+            checkpoints,
+            findings,
+            manualChecklist,
+            notices: [...engineResult.notices, ...notices],
+        };
+        return {
+            content: [{ type: "text", text: formatReportText(report) }],
+            structuredContent: report,
+        };
+    });
+}
+//# sourceMappingURL=check-html.js.map

package/dist/tools/check-html.js.map

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

package/dist/tools/checklist.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+const COMPONENTS = [
+    "form", "table", "image", "media", "link", "navigation", "modal", "carousel", "auth", "iframe", "widget",
+];
+function toItem(cp) {
+    return {
+        kwcag: cp.id,
+        alias: cp.alias,
+        question: `${cp.name_ko} — ${cp.summary_ko}`,
+        how: cp.testMethod_ko.join(" "),
+        evidence: cp.passExamples_ko.join(" / ") || cp.commonErrors_ko.join(" / "),
+    };
+}
+/** 장애 유형별 사용자 평가 과업 예시(§3.1 get_checklist scope=user-eval). kwcag22.json과 별개로
+ * 이 도구가 직접 관리하는 소규모 큐레이션 데이터다 — 검사항목 자동화 등급표와는 성격이 다르다. */
+const USER_EVAL_TASKS = [
+    { category: "시각", kwcag: "7.3.2", task: "스크린리더만으로 로그인 폼을 작성한다", how: "NVDA/VoiceOver로 각 입력 필드의 레이블이 읽히는지 확인", evidence: "모든 필드에서 레이블 음성 안내 성공" },
+    { category: "시각", kwcag: "6.4.1", task: "스크린리더 사용자가 반복 메뉴를 건너뛰어 본문으로 바로 이동한다", how: "첫 Tab에서 본문 바로가기 링크로 이동 후 Enter", evidence: "본문 영역으로 초점 이동 확인" },
+    { category: "청각", kwcag: "5.2.1", task: "소리를 끄고 자막만으로 강의 영상 내용을 이해한다", how: "음소거 상태로 영상 시청, 자막과 음성 내용 비교", evidence: "자막만으로 핵심 내용 파악 가능" },
+    { category: "지체", kwcag: "6.1.1", task: "마우스 없이 키보드만으로 전체 기능을 사용한다", how: "Tab/Shift+Tab/Enter/Space만으로 주요 과업 수행", evidence: "모든 기능에 키보드로 도달·실행 가능" },
+    { category: "지체", kwcag: "6.1.2", task: "키보드로 이동하며 현재 초점 위치를 항상 시각적으로 확인한다", how: "Tab 이동마다 초점 표시(윤곽선 등) 육안 확인", evidence: "모든 초점 가능 요소에서 표시 확인" },
+    { category: "인지", kwcag: "7.3.1", task: "입력 오류 메시지만 보고 무엇을 고쳐야 하는지 이해한다", how: "일부러 잘못된 값을 입력해 오류 메시지 확인", evidence: "구체적인 정정 방법이 안내됨" },
+    { category: "인지", kwcag: "7.3.4", task: "이전 단계에서 입력한 정보를 다시 입력하지 않고 진행한다", how: "다단계 폼에서 배송지 등 반복 정보 자동완성 확인", evidence: "재입력 없이 다음 단계 진행 가능" },
+];
+function buildMarkdown(scope, items) {
+    const rows = items
+        .map((item) => `- [ ] **${item.kwcag}(${item.alias})** ${item.question}\n  - 확인 방법: ${item.how}\n  - 근거: ${item.evidence}`)
+        .join("\n");
+    return `# 체크리스트 (${scope})\n\n${rows || "(해당하는 항목이 없습니다)"}`;
+}
+export function registerChecklistTool(server, data) {
+    server.registerTool("get_checklist", {
+        title: "KWCAG 체크리스트 생성",
+        description: "검사항목·컴포넌트·페이지 전체·사용자 평가 스코프로 KWCAG 2.2 체크리스트를 만든다.",
+        inputSchema: {
+            scope: z.enum(["checkpoint", "component", "page", "user-eval"]),
+            id: z.string().min(1).optional().describe("scope=checkpoint일 때 필수(KWCAG ID 또는 별칭)"),
+            component: z.enum(COMPONENTS).optional().describe("scope=component일 때 필수"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ scope, id, component }) => {
+        if (scope === "checkpoint") {
+            if (!id) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: "scope=checkpoint에는 id가 필요합니다." }],
+                    structuredContent: { code: "E_INPUT" },
+                };
+            }
+            const cp = data.kwcag22.findById(id);
+            const items = cp ? [toItem(cp)] : [];
+            return {
+                content: [{ type: "text", text: buildMarkdown(scope, items) }],
+                structuredContent: { scope, items },
+            };
+        }
+        if (scope === "component") {
+            if (!component) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: "scope=component에는 component가 필요합니다." }],
+                    structuredContent: { code: "E_INPUT" },
+                };
+            }
+            const items = data.kwcag22.checkpoints
+                .filter((cp) => cp.components.includes(component))
+                .map(toItem);
+            return {
+                content: [{ type: "text", text: buildMarkdown(scope, items) }],
+                structuredContent: { scope, items },
+            };
+        }
+        if (scope === "page") {
+            const items = data.kwcag22.checkpoints.map(toItem);
+            return {
+                content: [{ type: "text", text: buildMarkdown(scope, items) }],
+                structuredContent: { scope, items },
+            };
+        }
+        // scope === "user-eval"
+        const items = USER_EVAL_TASKS.map((t) => ({
+            kwcag: t.kwcag,
+            alias: data.kwcag22.findById(t.kwcag)?.alias ?? t.kwcag,
+            question: `[${t.category}] ${t.task}`,
+            how: t.how,
+            evidence: t.evidence,
+        }));
+        return {
+            content: [{ type: "text", text: buildMarkdown(scope, items) }],
+            structuredContent: { scope, items },
+        };
+    });
+}
+//# sourceMappingURL=checklist.js.map

package/dist/tools/checklist.js.map

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

package/dist/tools/lookup.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+const KWCAG_NUMBER = /^\d\.\d\.\d$/;
+/** detail="summary"일 때 검사 방법·오류·통과 예시 필드를 생략한다(§3.1 lookup_checkpoint). */
+function toMatch(cp, detail) {
+    if (detail === "full")
+        return cp;
+    const { testMethod_ko: _testMethod_ko, commonErrors_ko: _commonErrors_ko, passExamples_ko: _passExamples_ko, ...summary } = cp;
+    return summary;
+}
+function relatedWcagFor(data, sc) {
+    const criterion = data.wcag22.findBySc(sc);
+    if (!criterion)
+        return [];
+    return [{ sc: criterion.sc, name_ko: criterion.name_ko, level: criterion.level, kwcagIds: criterion.kwcagIds }];
+}
+function findByAxeRule(data, ruleId) {
+    return data.kwcag22.checkpoints.filter((cp) => cp.axeRules.includes(ruleId));
+}
+function findByKeyword(data, query) {
+    const needle = query.trim();
+    return data.kwcag22.checkpoints.filter((cp) => cp.name_ko.includes(needle) || cp.summary_ko.includes(needle) || cp.requirement_ko.includes(needle));
+}
+/**
+ * query 해석 우선순위(§3.1): "wcag:" 접두 → WCAG SC 직접 조회. 순수 숫자(X.X.X) → KWCAG
+ * 별칭 우선 조회 + WCAG 해석을 relatedWcag로 병기(모호한 숫자, 예 "2.4.1"). axe 규칙 ID →
+ * 귀속 검사항목. 그 외 → 이름·요약·요구문 부분 일치 키워드 검색.
+ */
+export function resolveQuery(data, query) {
+    const trimmed = query.trim();
+    if (trimmed.startsWith("wcag:")) {
+        const sc = trimmed.slice("wcag:".length).trim();
+        const criterion = data.wcag22.findBySc(sc);
+        const matches = criterion
+            ? data.kwcag22.checkpoints.filter((cp) => criterion.kwcagIds.includes(cp.id))
+            : [];
+        return { matches, relatedWcag: relatedWcagFor(data, sc) };
+    }
+    if (KWCAG_NUMBER.test(trimmed)) {
+        const cp = data.kwcag22.findById(trimmed);
+        return { matches: cp ? [cp] : [], relatedWcag: relatedWcagFor(data, trimmed) };
+    }
+    const byAxeRule = findByAxeRule(data, trimmed);
+    if (byAxeRule.length > 0)
+        return { matches: byAxeRule, relatedWcag: [] };
+    return { matches: findByKeyword(data, trimmed), relatedWcag: [] };
+}
+export function registerLookupTool(server, data) {
+    server.registerTool("lookup_checkpoint", {
+        title: "KWCAG 검사항목 조회",
+        description: "KWCAG 2.2 검사항목 ID(공식 번호·별칭)·WCAG SC(wcag: 접두)·axe 규칙 ID·키워드로 검사항목을 조회한다.",
+        inputSchema: {
+            query: z.string().min(1).max(100).describe("검사항목 ID(6.4.1 또는 2.4.1), wcag:2.4.1, axe 규칙 ID, 키워드"),
+            detail: z.enum(["summary", "full"]).default("summary"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ query, detail }) => {
+        const { matches, relatedWcag } = resolveQuery(data, query);
+        const summary = matches.length === 0
+            ? `"${query}"에 해당하는 검사항목을 찾지 못했습니다.`
+            : matches.map((cp) => `- ${cp.id}(${cp.alias}) ${cp.name_ko} [${cp.automation}]`).join("\n");
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: {
+                matches: matches.map((cp) => toMatch(cp, detail)),
+                relatedWcag,
+            },
+        };
+    });
+}
+//# sourceMappingURL=lookup.js.map

package/dist/tools/lookup.js.map

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

package/dist/tools/report-schema.js

@@ -0,0 +1,49 @@
+// check_html·audit_url이 공유하는 Report의 MCP outputSchema(zod raw shape). registerTool의
+// outputSchema는 최상위 키의 zod 스키마 맵이어야 하므로 z.object로 감싸지 않고 그대로 export한다.
+import { z } from "zod";
+const findingSchema = z.object({
+    ruleId: z.string(),
+    engine: z.enum(["k-rule", "axe", "b-rule"]),
+    kwcag: z.string().nullable(),
+    wcag: z.array(z.string()),
+    impact: z.enum(["critical", "serious", "moderate", "minor"]),
+    outcome: z.enum(["fail", "incomplete"]),
+    confidence: z.enum(["high", "medium", "low"]),
+    selector: z.string(),
+    html: z.string(),
+    message: z.string(),
+    fix: z.string(),
+    helpUrl: z.string().optional(),
+});
+const checkpointResultSchema = z.object({
+    id: z.string(),
+    alias: z.string(),
+    name: z.string(),
+    automation: z.enum(["auto", "assist", "manual", "na"]),
+    status: z.enum(["fail", "incomplete", "manual", "pass", "na"]),
+    findings: z.number(),
+});
+export const reportOutputShape = {
+    engine: z.object({
+        name: z.literal("swwa"),
+        version: z.string(),
+        axe: z.string(),
+        mode: z.enum(["static", "browser"]),
+    }),
+    target: z.object({ kind: z.enum(["html", "file", "url"]), ref: z.string(), title: z.string().optional() }),
+    verdict: z.enum(["fail", "needs-review", "pass"]),
+    summary: z.object({
+        fail: z.number(),
+        incomplete: z.number(),
+        manual: z.number(),
+        pass: z.number(),
+        na: z.number(),
+        byImpact: z.object({ critical: z.number(), serious: z.number(), moderate: z.number(), minor: z.number() }),
+        truncated: z.boolean(),
+    }),
+    checkpoints: z.array(checkpointResultSchema),
+    findings: z.array(findingSchema),
+    manualChecklist: z.array(z.object({ kwcag: z.string(), alias: z.string(), question: z.string() })),
+    notices: z.array(z.string()),
+};
+//# sourceMappingURL=report-schema.js.map