activo 0.4.4 → 0.5.0

package/src/core/tools/htmlAnalysis.ts

@@ -1,466 +0,0 @@
-import { Tool, ToolResult } from "./types.js";
-import * as fs from "fs";
-import * as path from "path";
-
-interface HtmlElement {
-  tag: string;
-  line: number;
-  issues: string[];
-  attributes?: string[];
-}
-
-interface HtmlAnalysisResult {
-  file: string;
-  type: "html" | "jsp" | "vue" | "template";
-  elements: HtmlElement[];
-  meta: {
-    title: boolean;
-    description: boolean;
-    viewport: boolean;
-    charset: boolean;
-    lang: boolean;
-  };
-  accessibility: {
-    missingAlt: number;
-    missingLabel: number;
-    missingAriaLabel: number;
-    emptyLinks: number;
-    emptyButtons: number;
-  };
-  semantic: {
-    hasHeader: boolean;
-    hasNav: boolean;
-    hasMain: boolean;
-    hasFooter: boolean;
-    hasArticle: boolean;
-    divCount: number;
-  };
-  issues: string[];
-  summary: {
-    totalElements: number;
-    elementsWithIssues: number;
-    a11yScore: number;
-    seoScore: number;
-  };
-}
-
-// HTML/JSP/Vue 분석
-function analyzeHtmlFile(filePath: string): HtmlAnalysisResult {
-  const content = fs.readFileSync(filePath, "utf-8");
-  const lines = content.split("\n");
-  const ext = path.extname(filePath).toLowerCase();
-
-  let type: "html" | "jsp" | "vue" | "template";
-  if (ext === ".jsp") type = "jsp";
-  else if (ext === ".vue") type = "vue";
-  else if (ext === ".ejs" || ext === ".hbs" || ext === ".pug") type = "template";
-  else type = "html";
-
-  const elements: HtmlElement[] = [];
-  const issues: string[] = [];
-
-  // Meta 태그 검사
-  const meta = {
-    title: /<title[^>]*>[^<]+<\/title>/i.test(content),
-    description: /<meta[^>]*name=["']description["'][^>]*>/i.test(content),
-    viewport: /<meta[^>]*name=["']viewport["'][^>]*>/i.test(content),
-    charset: /<meta[^>]*charset=/i.test(content) || /charset=/i.test(content),
-    lang: /<html[^>]*lang=/i.test(content),
-  };
-
-  // 접근성 검사
-  const accessibility = {
-    missingAlt: 0,
-    missingLabel: 0,
-    missingAriaLabel: 0,
-    emptyLinks: 0,
-    emptyButtons: 0,
-  };
-
-  // 시맨틱 태그 검사
-  const semantic = {
-    hasHeader: /<header[\s>]/i.test(content),
-    hasNav: /<nav[\s>]/i.test(content),
-    hasMain: /<main[\s>]/i.test(content),
-    hasFooter: /<footer[\s>]/i.test(content),
-    hasArticle: /<article[\s>]/i.test(content),
-    divCount: (content.match(/<div[\s>]/gi) || []).length,
-  };
-
-  // Deprecated 태그 목록
-  const deprecatedTags = [
-    "font", "center", "marquee", "blink", "strike", "big", "tt",
-    "frame", "frameset", "noframes", "applet", "basefont", "dir", "isindex",
-  ];
-
-  // 인라인 스타일/이벤트 핸들러
-  const inlineStyles = (content.match(/style=["'][^"']+["']/gi) || []).length;
-  const inlineEvents = (content.match(/on\w+=["'][^"']+["']/gi) || []).length;
-
-  // 라인 번호 찾기 함수
-  const findLineNumber = (index: number): number => {
-    let lineNum = 1;
-    for (let i = 0; i < index && i < content.length; i++) {
-      if (content[i] === "\n") lineNum++;
-    }
-    return lineNum;
-  };
-
-  // img 태그 검사
-  const imgRegex = /<img([^>]*)>/gi;
-  let match;
-  while ((match = imgRegex.exec(content)) !== null) {
-    const attrs = match[1];
-    const elementIssues: string[] = [];
-
-    if (!/alt=/i.test(attrs)) {
-      elementIssues.push("alt 속성 누락");
-      accessibility.missingAlt++;
-    } else if (/alt=["']\s*["']/i.test(attrs)) {
-      elementIssues.push("alt 속성 비어있음");
-    }
-
-    if (!/loading=/i.test(attrs)) {
-      elementIssues.push("loading 속성 권장 (lazy)");
-    }
-
-    if (elementIssues.length > 0) {
-      elements.push({
-        tag: "img",
-        line: findLineNumber(match.index),
-        issues: elementIssues,
-      });
-    }
-  }
-
-  // a 태그 검사
-  const aRegex = /<a([^>]*)>([^<]*)<\/a>/gi;
-  while ((match = aRegex.exec(content)) !== null) {
-    const attrs = match[1];
-    const text = match[2].trim();
-    const elementIssues: string[] = [];
-
-    if (!text && !/aria-label=/i.test(attrs)) {
-      elementIssues.push("빈 링크 텍스트");
-      accessibility.emptyLinks++;
-    }
-
-    if (/target=["']_blank["']/i.test(attrs) && !/rel=["'][^"']*noopener/i.test(attrs)) {
-      elementIssues.push("target=_blank에 rel=noopener 권장");
-    }
-
-    if (/href=["']#["']/i.test(attrs)) {
-      elementIssues.push("href='#' - 실제 링크 또는 button 사용 권장");
-    }
-
-    if (elementIssues.length > 0) {
-      elements.push({
-        tag: "a",
-        line: findLineNumber(match.index),
-        issues: elementIssues,
-      });
-    }
-  }
-
-  // button 태그 검사
-  const buttonRegex = /<button([^>]*)>([^<]*)<\/button>/gi;
-  while ((match = buttonRegex.exec(content)) !== null) {
-    const attrs = match[1];
-    const text = match[2].trim();
-    const elementIssues: string[] = [];
-
-    if (!text && !/aria-label=/i.test(attrs)) {
-      elementIssues.push("빈 버튼 텍스트");
-      accessibility.emptyButtons++;
-    }
-
-    if (!/type=/i.test(attrs)) {
-      elementIssues.push("type 속성 권장 (button/submit)");
-    }
-
-    if (elementIssues.length > 0) {
-      elements.push({
-        tag: "button",
-        line: findLineNumber(match.index),
-        issues: elementIssues,
-      });
-    }
-  }
-
-  // input 태그 검사
-  const inputRegex = /<input([^>]*)>/gi;
-  while ((match = inputRegex.exec(content)) !== null) {
-    const attrs = match[1];
-    const elementIssues: string[] = [];
-
-    // label 연결 검사 (id가 있어야 label for 가능)
-    const idMatch = attrs.match(/id=["']([^"']+)["']/i);
-    if (idMatch) {
-      const inputId = idMatch[1];
-      if (!new RegExp(`<label[^>]*for=["']${inputId}["']`, "i").test(content)) {
-        if (!/aria-label=/i.test(attrs) && !/placeholder=/i.test(attrs)) {
-          elementIssues.push("label 또는 aria-label 권장");
-          accessibility.missingLabel++;
-        }
-      }
-    } else if (!/aria-label=/i.test(attrs)) {
-      // id 없으면 aria-label 필요
-      if (!/type=["'](?:hidden|submit|button|reset)["']/i.test(attrs)) {
-        elementIssues.push("id 또는 aria-label 권장");
-        accessibility.missingLabel++;
-      }
-    }
-
-    // autocomplete 검사
-    if (/type=["'](?:password|email|tel|text)["']/i.test(attrs) && !/autocomplete=/i.test(attrs)) {
-      elementIssues.push("autocomplete 속성 권장");
-    }
-
-    if (elementIssues.length > 0) {
-      elements.push({
-        tag: "input",
-        line: findLineNumber(match.index),
-        issues: elementIssues,
-      });
-    }
-  }
-
-  // form 태그 검사
-  const formRegex = /<form([^>]*)>/gi;
-  while ((match = formRegex.exec(content)) !== null) {
-    const attrs = match[1];
-    const elementIssues: string[] = [];
-
-    if (!/action=/i.test(attrs)) {
-      elementIssues.push("action 속성 누락");
-    }
-
-    if (!/method=/i.test(attrs)) {
-      elementIssues.push("method 속성 권장");
-    }
-
-    if (elementIssues.length > 0) {
-      elements.push({
-        tag: "form",
-        line: findLineNumber(match.index),
-        issues: elementIssues,
-      });
-    }
-  }
-
-  // table 태그 검사
-  const tableRegex = /<table([^>]*)>/gi;
-  while ((match = tableRegex.exec(content)) !== null) {
-    const tableStart = match.index;
-    const tableEnd = content.indexOf("</table>", tableStart);
-    const tableContent = content.substring(tableStart, tableEnd);
-    const elementIssues: string[] = [];
-
-    if (!/<caption/i.test(tableContent)) {
-      elementIssues.push("caption 권장 (테이블 설명)");
-    }
-
-    if (!/<th[\s>]/i.test(tableContent)) {
-      elementIssues.push("th 요소 권장 (헤더 셀)");
-    }
-
-    if (elementIssues.length > 0) {
-      elements.push({
-        tag: "table",
-        line: findLineNumber(match.index),
-        issues: elementIssues,
-      });
-    }
-  }
-
-  // deprecated 태그 검사
-  deprecatedTags.forEach((tag) => {
-    const tagRegex = new RegExp(`<${tag}[\\s>]`, "gi");
-    let tagMatch;
-    while ((tagMatch = tagRegex.exec(content)) !== null) {
-      elements.push({
-        tag,
-        line: findLineNumber(tagMatch.index),
-        issues: [`deprecated 태그 - 사용 금지`],
-      });
-    }
-  });
-
-  // iframe 검사
-  const iframeRegex = /<iframe([^>]*)>/gi;
-  while ((match = iframeRegex.exec(content)) !== null) {
-    const attrs = match[1];
-    const elementIssues: string[] = [];
-
-    if (!/title=/i.test(attrs)) {
-      elementIssues.push("title 속성 권장 (접근성)");
-    }
-
-    if (!/sandbox=/i.test(attrs)) {
-      elementIssues.push("sandbox 속성 권장 (보안)");
-    }
-
-    if (elementIssues.length > 0) {
-      elements.push({
-        tag: "iframe",
-        line: findLineNumber(match.index),
-        issues: elementIssues,
-      });
-    }
-  }
-
-  // 전체 이슈 수집
-  if (!meta.title) issues.push("title 태그 누락 (SEO)");
-  if (!meta.description) issues.push("meta description 누락 (SEO)");
-  if (!meta.viewport) issues.push("viewport 설정 누락 (반응형)");
-  if (!meta.charset) issues.push("charset 설정 누락");
-  if (!meta.lang) issues.push("html lang 속성 누락 (접근성)");
-
-  if (!semantic.hasMain) issues.push("main 요소 없음 (시맨틱)");
-  if (semantic.divCount > 30) issues.push(`div 요소 ${semantic.divCount}개 - 시맨틱 태그 권장`);
-
-  if (inlineStyles > 5) issues.push(`인라인 스타일 ${inlineStyles}개 - CSS 클래스 권장`);
-  if (inlineEvents > 3) issues.push(`인라인 이벤트 ${inlineEvents}개 - JS 분리 권장`);
-
-  // 점수 계산
-  const a11yMaxPoints = 5;
-  let a11yPoints = a11yMaxPoints;
-  if (accessibility.missingAlt > 0) a11yPoints -= 1;
-  if (accessibility.missingLabel > 0) a11yPoints -= 1;
-  if (accessibility.emptyLinks > 0) a11yPoints -= 1;
-  if (accessibility.emptyButtons > 0) a11yPoints -= 1;
-  if (!meta.lang) a11yPoints -= 1;
-  const a11yScore = Math.max(0, Math.round((a11yPoints / a11yMaxPoints) * 100));
-
-  const seoMaxPoints = 5;
-  let seoPoints = seoMaxPoints;
-  if (!meta.title) seoPoints -= 1;
-  if (!meta.description) seoPoints -= 1;
-  if (!meta.viewport) seoPoints -= 1;
-  if (!semantic.hasMain) seoPoints -= 1;
-  if (!semantic.hasHeader && !semantic.hasNav) seoPoints -= 1;
-  const seoScore = Math.max(0, Math.round((seoPoints / seoMaxPoints) * 100));
-
-  return {
-    file: filePath,
-    type,
-    elements,
-    meta,
-    accessibility,
-    semantic,
-    issues,
-    summary: {
-      totalElements: elements.length,
-      elementsWithIssues: elements.filter((e) => e.issues.length > 0).length,
-      a11yScore,
-      seoScore,
-    },
-  };
-}
-
-// 도구 정의
-export const htmlTools: Tool[] = [
-  {
-    name: "html_check",
-    description:
-      "HTML/JSP/Vue 파일을 분석합니다. 접근성(a11y), SEO 메타태그, 시맨틱 태그, deprecated 태그, 폼 요소 등을 검사합니다.",
-    parameters: {
-      type: "object",
-      properties: {
-        path: {
-          type: "string",
-          description: "분석할 HTML/JSP/Vue 파일 또는 디렉토리 경로",
-        },
-        recursive: {
-          type: "boolean",
-          description: "디렉토리인 경우 하위 폴더 포함 여부 (기본: true)",
-        },
-      },
-      required: ["path"],
-    },
-    handler: async (args: Record<string, unknown>): Promise<ToolResult> => {
-      const targetPath = args.path as string;
-      const recursive = args.recursive !== false;
-
-      if (!fs.existsSync(targetPath)) {
-        return {
-          success: false,
-          content: "",
-          error: `경로를 찾을 수 없습니다: ${targetPath}`,
-        };
-      }
-
-      const results: HtmlAnalysisResult[] = [];
-      const stats = fs.statSync(targetPath);
-      const htmlExtensions = [".html", ".htm", ".jsp", ".vue", ".ejs", ".hbs"];
-
-      if (stats.isFile()) {
-        const ext = path.extname(targetPath).toLowerCase();
-        if (htmlExtensions.includes(ext)) {
-          results.push(analyzeHtmlFile(targetPath));
-        }
-      } else if (stats.isDirectory()) {
-        const walkDir = (dir: string) => {
-          const files = fs.readdirSync(dir);
-          for (const file of files) {
-            const filePath = path.join(dir, file);
-            const fileStat = fs.statSync(filePath);
-            if (fileStat.isDirectory() && recursive) {
-              if (!file.startsWith(".") && file !== "node_modules" && file !== "target" && file !== "build") {
-                walkDir(filePath);
-              }
-            } else {
-              const ext = path.extname(file).toLowerCase();
-              if (htmlExtensions.includes(ext)) {
-                results.push(analyzeHtmlFile(filePath));
-              }
-            }
-          }
-        };
-        walkDir(targetPath);
-      }
-
-      // 전체 통계
-      const avgA11y = results.length > 0
-        ? Math.round(results.reduce((sum, r) => sum + r.summary.a11yScore, 0) / results.length)
-        : 0;
-      const avgSeo = results.length > 0
-        ? Math.round(results.reduce((sum, r) => sum + r.summary.seoScore, 0) / results.length)
-        : 0;
-
-      const totalA11y = {
-        missingAlt: results.reduce((sum, r) => sum + r.accessibility.missingAlt, 0),
-        missingLabel: results.reduce((sum, r) => sum + r.accessibility.missingLabel, 0),
-        emptyLinks: results.reduce((sum, r) => sum + r.accessibility.emptyLinks, 0),
-        emptyButtons: results.reduce((sum, r) => sum + r.accessibility.emptyButtons, 0),
-      };
-
-      const output = {
-        analyzedFiles: results.length,
-        averageA11yScore: avgA11y,
-        averageSeoScore: avgSeo,
-        totalAccessibilityIssues: totalA11y,
-        files: results.map((r) => ({
-          file: r.file,
-          type: r.type,
-          a11yScore: r.summary.a11yScore,
-          seoScore: r.summary.seoScore,
-          meta: r.meta,
-          semantic: r.semantic,
-          accessibility: r.accessibility,
-          pageIssues: r.issues,
-          elementIssues: r.elements.map((e) => ({
-            tag: e.tag,
-            line: e.line,
-            issues: e.issues,
-          })),
-        })),
-      };
-
-      return {
-        success: true,
-        content: JSON.stringify(output, null, 2),
-      };
-    },
-  },
-];

package/src/core/tools/index.ts

@@ -1,160 +0,0 @@
-import { Tool, ToolCall, ToolResult } from "./types.js";
-import { builtInTools } from "./builtIn.js";
-import { standardsTools } from "./standards.js";
-import { cacheTools } from "./cache.js";
-import { astTools } from "./ast.js";
-import { embeddingTools } from "./embeddings.js";
-import { memoryTools } from "./memory.js";
-import { javaTools } from "./javaAst.js";
-import { frontendTools } from "./frontendAst.js";
-import { sqlTools } from "./sqlAnalysis.js";
-import { mybatisTools } from "./mybatisAnalysis.js";
-import { cssTools } from "./cssAnalysis.js";
-import { htmlTools } from "./htmlAnalysis.js";
-import { dependencyTools } from "./dependencyAnalysis.js";
-import { openapiTools } from "./openapiAnalysis.js";
-import { pythonTools } from "./pythonAnalysis.js";
-import { analyzeAllTools } from "./analyzeAll.js";
-
-export * from "./types.js";
-export * from "./builtIn.js";
-export * from "./standards.js";
-export * from "./cache.js";
-export * from "./ast.js";
-export * from "./embeddings.js";
-export * from "./memory.js";
-export * from "./javaAst.js";
-export * from "./frontendAst.js";
-export * from "./sqlAnalysis.js";
-export * from "./mybatisAnalysis.js";
-export * from "./cssAnalysis.js";
-export * from "./htmlAnalysis.js";
-export * from "./dependencyAnalysis.js";
-export * from "./openapiAnalysis.js";
-export * from "./pythonAnalysis.js";
-export * from "./analyzeAll.js";
-
-// All available tools
-export function getAllTools(): Tool[] {
-  return [...builtInTools, ...standardsTools, ...cacheTools, ...astTools, ...embeddingTools, ...memoryTools, ...javaTools, ...frontendTools, ...sqlTools, ...mybatisTools, ...cssTools, ...htmlTools, ...dependencyTools, ...openapiTools, ...pythonTools, ...analyzeAllTools];
-}
-
-// Get tool by name
-export function getTool(name: string): Tool | undefined {
-  return getAllTools().find((t) => t.name === name);
-}
-
-// Execute a tool call
-export async function executeTool(toolCall: ToolCall): Promise<ToolResult> {
-  const tool = getTool(toolCall.name);
-
-  if (!tool) {
-    return {
-      success: false,
-      content: "",
-      error: `Unknown tool: ${toolCall.name}`,
-    };
-  }
-
-  try {
-    return await tool.handler(toolCall.arguments);
-  } catch (error) {
-    return {
-      success: false,
-      content: "",
-      error: `Tool execution error: ${error}`,
-    };
-  }
-}
-
-// Get tool definitions for LLM
-export function getToolDefinitions(): Array<{
-  name: string;
-  description: string;
-  parameters: Tool["parameters"];
-}> {
-  return getAllTools().map((t) => ({
-    name: t.name,
-    description: t.description,
-    parameters: t.parameters,
-  }));
-}
-
-// Tool category mapping for selective loading
-const TOOL_CATEGORIES: Record<string, string[]> = {
-  core: ["analyze_all", "read_file", "list_directory", "grep_search", "glob_search"],
-  java: ["java_analyze", "java_complexity", "spring_check"],
-  frontend_js: ["ast_analyze", "get_call_graph", "find_symbol_usage", "complexity_report"],
-  react: ["react_check"],
-  vue: ["vue_check"],
-  jquery: ["jquery_check"],
-  sql: ["sql_check"],
-  mybatis: ["mybatis_check"],
-  css: ["css_check"],
-  html: ["html_check"],
-  python: ["python_check"],
-  dependency: ["dependency_check"],
-  openapi: ["openapi_check"],
-  standards: ["import_hwp_standards", "import_pdf_standards", "index_standards", "search_standards", "check_quality_rag", "list_standards", "check_code_quality"],
-  cache: ["summarize_file", "get_file_outline", "get_cached_summary", "list_cache", "clear_cache", "batch_summarize"],
-  embeddings: ["index_codebase", "semantic_search", "find_similar_code", "embeddings_status", "clear_embeddings"],
-  memory: ["init_project_memory", "add_key_file", "add_note", "add_fact", "save_conversation", "get_project_context", "search_memory", "clear_memory"],
-  file_write: ["write_file", "run_command"],
-};
-
-// Keyword-to-category mapping
-const KEYWORD_CATEGORIES: Array<{ keywords: string[]; categories: string[] }> = [
-  { keywords: ["java", "spring", ".java", "controller", "service", "repository", "entity"], categories: ["java"] },
-  { keywords: ["react", "jsx", "tsx", "hook", "usestate", "useeffect", "component"], categories: ["react", "frontend_js"] },
-  { keywords: ["vue", ".vue", "vuex", "composition"], categories: ["vue", "frontend_js"] },
-  { keywords: ["jquery", "$.", "$("], categories: ["jquery", "frontend_js"] },
-  { keywords: ["javascript", "typescript", "js", "ts", "ast", "복잡도", "complexity"], categories: ["frontend_js"] },
-  { keywords: ["sql", "query", "쿼리", "select", "insert", "update", "delete"], categories: ["sql"] },
-  { keywords: ["mybatis", "mapper", "xml"], categories: ["mybatis"] },
-  { keywords: ["css", "scss", "less", "style", "스타일"], categories: ["css"] },
-  { keywords: ["html", "jsp", "접근성", "a11y", "seo"], categories: ["html"] },
-  { keywords: ["python", ".py", "django", "flask", "fastapi"], categories: ["python"] },
-  { keywords: ["dependency", "의존성", "package.json", "pom.xml", "gradle", "취약점"], categories: ["dependency"] },
-  { keywords: ["openapi", "swagger", "api 스펙", "api spec"], categories: ["openapi"] },
-  { keywords: ["표준", "standard", "hwp", "pdf", "rag", "품질기준"], categories: ["standards"] },
-  { keywords: ["캐시", "cache", "요약", "summarize", "outline"], categories: ["cache"] },
-  { keywords: ["임베딩", "embedding", "벡터", "vector", "semantic", "의미검색", "인덱싱"], categories: ["embeddings"] },
-  { keywords: ["메모리", "memory", "컨텍스트", "context", "기억", "노트"], categories: ["memory"] },
-  { keywords: ["write", "쓰기", "실행", "run", "command", "명령"], categories: ["file_write"] },
-];
-
-// Select relevant tools based on user message (max ~15 tools)
-export function selectTools(userMessage: string): Tool[] {
-  const msg = userMessage.toLowerCase();
-  const allTools = getAllTools();
-  const selectedNames = new Set<string>();
-
-  // Always include core tools
-  for (const name of TOOL_CATEGORIES.core) {
-    selectedNames.add(name);
-  }
-
-  // Match keywords to categories
-  for (const { keywords, categories } of KEYWORD_CATEGORIES) {
-    if (keywords.some((kw) => msg.includes(kw))) {
-      for (const cat of categories) {
-        const names = TOOL_CATEGORIES[cat];
-        if (names) {
-          for (const name of names) {
-            selectedNames.add(name);
-          }
-        }
-      }
-    }
-  }
-
-  // If "분석", "analyze", "check", "전체" → add analyze_all (already in core)
-  // If very broad request or no specific match, add common analysis tools
-  if (selectedNames.size <= TOOL_CATEGORIES.core.length) {
-    // No specific category matched - add analyze_all + common ones
-    for (const name of TOOL_CATEGORIES.java) selectedNames.add(name);
-    for (const name of TOOL_CATEGORIES.frontend_js) selectedNames.add(name);
-  }
-
-  return allTools.filter((t) => selectedNames.has(t.name));
-}