activo 0.4.0 → 0.4.2

package/README.md

@@ -1,190 +1,128 @@
 # ACTIVO
 
-AI 기반 코드 품질 분석 CLI 도구 (Ollama 전용)
+AI 기반 코드 품질 분석 CLI (Ollama)
 
-![Screenshot](screenshot.png)
+![Demo](demo.gif)
+
+Ollama를 활용한 대화형 코드 분석 에이전트. Java, TypeScript, Python, SQL, CSS 등 다국어·멀티스택 프로젝트를 자동 감지하고 품질 이슈를 분석합니다.
+
+- **Tool Calling**: LLM이 상황에 맞는 도구를 직접 호출
+- **MCP 지원**: Model Context Protocol 연동
+- **React Ink TUI**: 터미널용 대화형 UI
+
+## 주요 기능
+
+| 카테고리 | 도구 | 설명 |
+|----------|------|------|
+| **전체 분석** | `analyze_all` | 디렉토리 전체 자동 감지 및 분석 (권장) |
+| **코드 분석** | Java, JS/TS, Python, React, Vue | AST, 순환 복잡도, 프레임워크 패턴 |
+| **SQL/DB** | `sql_check`, `mybatis_check` | SQL Injection, N+1, 동적 SQL 분석 |
+| **웹** | `css_check`, `html_check` | !important, 접근성(a11y), SEO 검사 |
+| **의존성** | `dependency_check` | npm/Maven/Gradle 보안 취약점 검출 |
+| **표준/RAG** | `import_hwp_standards`, `check_quality_rag` | HWP/PDF → 마크다운, RAG 기반 품질 검사 |
 
 ## 설치
 
 ```bash
-# 글로벌 설치 (권장)
 npm install -g activo
-
-# 또는 npx로 바로 실행
-npx activo
 ```
 
+## 요구사항
+
+- Node.js 18+
+- [Ollama](https://ollama.ai) 실행 중
+- 모델: `ollama pull mistral:latest` (또는 `qwen2.5:7b` 등)
+
 ## 사용법
 
 ```bash
 # 대화형 모드
 activo
 
-# 프롬프트와 함께 실행
-activo "src 폴더 구조 보여줘"
-
-# 비대화형 모드
-activo --print "package.json 분석해줘"
+# 프롬프트와 함께 실행 (권장)
+activo "src 폴더 품질 분석해줘"
 
 # 특정 모델 사용
-activo --model qwen2.5:7b
-```
-
-## 주요 기능
-
-### 기본 도구
-- **파일 작업**: 읽기, 쓰기, 디렉토리 목록
-- **검색**: grep (패턴), glob (파일명)
-- **명령 실행**: 셸 명령 (안전 필터 적용)
-
-### 코드 분석
-- **AST 분석**: 함수, 클래스, 타입 구조 파악 (TypeScript Compiler API)
-- **복잡도 분석**: 순환 복잡도 계산 및 리포트
-- **호출 그래프**: 함수 간 호출 관계 추적
-- **심볼 사용처**: 특정 심볼이 어디서 사용되는지 검색
-
-### 파일 요약 캐싱
-- **LLM 요약**: 파일 내용을 LLM으로 요약 후 캐싱
-- **아웃라인**: 함수/클래스 시그니처 빠른 추출 (LLM 없음)
-- **변경 감지**: 파일 해시로 변경 시에만 재생성
-
-### 의미 기반 검색 (RAG)
-- **코드베이스 인덱싱**: 벡터 임베딩 생성 (`nomic-embed-text`)
-- **의미 검색**: "로그인 관련 코드" → 관련 코드 찾기
-- **유사 코드 찾기**: 코드 패턴 검색
-
-### 프로젝트 메모리
-- **컨텍스트 저장**: 프로젝트 정보, 기술 스택, 컨벤션
-- **노트/사실**: 중요 정보 기억
-- **대화 요약**: 세션 간 컨텍스트 유지
-
-### 프론트엔드 분석
-- **React**: 컴포넌트 구조, Hooks 사용, 클래스 컴포넌트 감지
-- **Vue**: Options/Composition/Script Setup API 분석
-- **jQuery**: deprecated 메서드 검출 (bind, live, size 등)
-
-### SQL/데이터베이스 분석
-- **SQL**: Java 내 @Query, JDBC 쿼리 분석 (SELECT *, N+1 패턴)
-- **MyBatis**: XML 매퍼 분석, ${} 인젝션 위험, 동적 SQL
-
-### 웹 표준 분석
-- **CSS/SCSS/LESS**: !important, 중첩 깊이, vendor prefix
-- **HTML/JSP**: 접근성(a11y), SEO, 시맨틱 태그, deprecated 태그
-
-### 의존성/API/Python
-- **의존성 검사**: package.json, pom.xml 취약점, deprecated 패키지
-- **OpenAPI 분석**: Swagger 스펙 검증, 엔드포인트 문서화 품질
-- **Python 분석**: Django/Flask/FastAPI 패턴, PEP8, 보안 이슈
-
-### 개발 표준
-- **PDF 변환**: 개발표준 PDF → Markdown 변환
-- **코드 품질 분석**: 규칙 기반 코드 점검
+activo --model qwen2.5:7b "Java 코드 복잡도 점검해줘"
 
-## 도구 목록
+# Headless 모드 (CI/스크립트)
+activo --headless "analyze_all 해줘"
 
-| 카테고리 | 도구 | 설명 |
-|----------|------|------|
-| **기본** | `read_file` | 파일 읽기 |
-| | `write_file` | 파일 쓰기 |
-| | `list_directory` | 디렉토리 목록 |
-| | `grep_search` | 패턴 검색 |
-| | `glob_search` | 파일명 검색 |
-| | `run_command` | 셸 명령 실행 |
-| **캐시** | `summarize_file` | 파일 요약 (LLM + 캐싱) |
-| | `get_file_outline` | 구조 추출 (빠름) |
-| | `batch_summarize` | 다중 파일 요약 |
-| **AST (TS/JS)** | `ast_analyze` | 심층 코드 분석 |
-| | `get_call_graph` | 호출 그래프 |
-| | `find_symbol_usage` | 심볼 사용처 |
-| | `complexity_report` | 복잡도 리포트 |
-| **Java** | `java_analyze` | Java AST 분석 |
-| | `java_complexity` | Java 복잡도 리포트 |
-| | `spring_check` | Spring 패턴 검사 |
-| **Frontend** | `react_check` | React 컴포넌트/Hooks 분석 |
-| | `vue_check` | Vue 컴포넌트 분석 |
-| | `jquery_check` | jQuery deprecated 메서드 검사 |
-| **SQL/DB** | `sql_check` | Java 내 SQL 쿼리 분석 |
-| | `mybatis_check` | MyBatis XML 매퍼 분석 |
-| **Web** | `css_check` | CSS/SCSS/LESS 분석 |
-| | `html_check` | HTML/JSP 접근성/SEO 분석 |
-| **의존성** | `dependency_check` | package.json, pom.xml 취약점 검사 |
-| **API** | `openapi_check` | OpenAPI/Swagger 스펙 분석 |
-| **Python** | `python_check` | Python/Django/Flask 분석 |
-| **통합** | `analyze_all` | 디렉토리 전체 자동 분석 |
-| **RAG** | `index_codebase` | 벡터 인덱싱 |
-| | `semantic_search` | 의미 검색 |
-| | `find_similar_code` | 유사 코드 찾기 |
-| **메모리** | `init_project_memory` | 프로젝트 컨텍스트 |
-| | `add_note` | 노트 저장 |
-| | `get_project_context` | 컨텍스트 조회 |
-| | `search_memory` | 메모리 검색 |
-
-## 요구사항
-
-- Node.js 18+
-- [Ollama](https://ollama.ai) 실행 중
+# 프롬프트만 출력 후 종료
+activo --print "분석 요약해줘"
 
-## Ollama 설정
-
-### 1. Ollama 설치
+# 이전 세션 이어서
+activo --resume
+```
 
-```bash
-# macOS
-brew install ollama
+## 설정
 
-# Windows
-# https://ollama.ai 에서 다운로드
+설정 파일: `~/.activo/config.json` (전역), `.activo/config.json` (프로젝트별)
 
-# Linux
-curl -fsSL https://ollama.ai/install.sh | sh
+```json
+{
+  "ollama": {
+    "baseUrl": "http://localhost:11434",
+    "model": "mistral:latest",
+    "contextLength": 8192,
+    "keepAlive": 1800
+  },
+  "standards": {
+    "directory": ".activo/standards"
+  },
+  "mcp": {
+    "servers": {
+      "my-server": {
+        "command": "npx",
+        "args": ["-y", "my-mcp-server"],
+        "env": {}
+      }
+    }
+  }
+}
 ```
 
-### 2. 모델 다운로드
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| `ollama.baseUrl` | Ollama API URL | `http://localhost:11434` |
+| `ollama.model` | 사용할 모델 | `mistral:latest` |
+| `ollama.contextLength` | 컨텍스트 길이 | `8192` |
+| `ollama.keepAlive` | 모델 유지 시간(초) | `1800` |
 
-```bash
-# 권장 모델
-ollama pull mistral:latest
+## 프로젝트 데이터
 
-# 한국어 지원 모델
-ollama pull qwen2.5:7b
+분석 시 프로젝트 루트에 `.activo/` 디렉토리가 생성됩니다.
 
-# 코드 특화 모델
-ollama pull codellama:7b
+| 경로 | 용도 |
+|------|------|
+| `.activo/cache/` | 파일 요약 캐시 |
+| `.activo/embeddings/` | 코드 임베딩 인덱스 |
+| `.activo/memory/` | 프로젝트 메모리·대화 요약 |
+| `.activo/standards-rag/` | 표준 문서 RAG (HWP/PDF import 후) |
 
-# 임베딩 모델 (의미 검색용)
-ollama pull nomic-embed-text
-```
+## MCP 연동
 
-### 3. Ollama 실행
-
-```bash
-ollama serve
-```
+`~/.activo/config.json`의 `mcp.servers`에 MCP 서버를 등록하면 activo가 해당 도구를 자동으로 사용할 수 있습니다.
 
-### 4. activo 설정
-
-`~/.activo/config.json`:
 ```json
 {
-  "ollama": {
-    "baseUrl": "http://localhost:11434",
-    "model": "mistral:latest"
+  "mcp": {
+    "servers": {
+      "filesystem": {
+        "command": "npx",
+        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
+      }
+    }
   }
 }
 ```
 
-또는 CLI 옵션으로 모델 지정:
-```bash
-activo --model qwen2.5:7b
-```
-
-## 단축키
+## 기술 스택
 
-| 키 | 동작 |
-|---|------|
-| `Enter` | 메시지 전송 |
-| `ESC` | 진행 중 작업 취소 |
-| `Ctrl+C` x2 | 종료 |
+- **Ollama** - 로컬 LLM
+- **TypeScript Compiler API** - JS/TS AST 분석
+- **java-ast** - Java 파싱 (ANTLR4)
+- **React Ink** - 터미널 UI
 
 ## 라이선스
 

package/demo.tape

@@ -0,0 +1,53 @@
+# VHS Demo for ACTIVO - Full Feature Showcase
+Output demo.gif
+
+Set FontSize 13
+Set Width 900
+Set Height 600
+Set Theme "Dracula"
+Set TypingSpeed 50ms
+
+# 1. Start activo in centerpoint project
+Type "cd /Users/mhb8436/Workspaces/centerpoint/server && activo"
+Enter
+Sleep 3s
+
+# 2. Directory structure
+Type "프로젝트 구조 보여줘"
+Enter
+Sleep 6s
+
+# 3. Java code analysis
+Type "api-server 자바 코드 분석해줘"
+Enter
+Sleep 10s
+
+# 4. Spring pattern check
+Type "Spring 패턴 검사해줘"
+Enter
+Sleep 8s
+
+# 5. Dependency check
+Type "pom.xml 의존성 분석해줘"
+Enter
+Sleep 6s
+
+# 6. Find specific code
+Type "WebSecurityConfig 파일 찾아서 보여줘"
+Enter
+Sleep 6s
+
+# 7. SQL analysis
+Type "SQL 쿼리 분석해줘"
+Enter
+Sleep 6s
+
+# 8. Full analysis
+Type "전체 코드 품질 분석해줘"
+Enter
+Sleep 10s
+
+# 9. Exit
+Type "/exit"
+Enter
+Sleep 1s

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "activo",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "AI-powered code quality analyzer with React Ink TUI, Tool Calling, and MCP support",
   "repository": {
     "type": "git",
@@ -51,6 +51,7 @@
     "java-ast": "^0.4.1",
     "pdf-parse": "^1.1.1",
     "react": "^19.1.0",
+    "typescript": "^5.8.0",
     "uuid": "^10.0.0"
   },
   "devDependencies": {
@@ -60,7 +61,6 @@
     "@types/react": "^19.1.0",
     "@types/uuid": "^10.0.0",
     "tsx": "^4.20.0",
-    "typescript": "^5.8.0",
     "vitest": "^3.2.0"
   }
 }

package/src/core/tools/standards.test.ts

@@ -0,0 +1,186 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+
+// Test helpers
+const TEST_DIR = ".activo-test";
+const STANDARDS_DIR = `${TEST_DIR}/standards`;
+const RAG_DIR = `${TEST_DIR}/standards-rag`;
+
+// Helper to create test directory
+function setupTestDir() {
+  if (fs.existsSync(TEST_DIR)) {
+    fs.rmSync(TEST_DIR, { recursive: true });
+  }
+  fs.mkdirSync(STANDARDS_DIR, { recursive: true });
+}
+
+// Helper to cleanup test directory
+function cleanupTestDir() {
+  if (fs.existsSync(TEST_DIR)) {
+    fs.rmSync(TEST_DIR, { recursive: true });
+  }
+}
+
+// Helper to create test markdown file
+function createTestMarkdown(filename: string, content: string) {
+  fs.writeFileSync(path.join(STANDARDS_DIR, filename), content);
+}
+
+describe("Standards Tools", () => {
+  beforeEach(() => {
+    setupTestDir();
+  });
+
+  afterEach(() => {
+    cleanupTestDir();
+  });
+
+  describe("splitStandardsIntoChunks", () => {
+    it("should split markdown by sections", () => {
+      const content = `# Development Standards
+
+## Introduction
+This is the introduction.
+
+## RULE-001: Variable Naming
+- Severity: error
+- Rule: Use camelCase for variables
+
+## RULE-002: Function Naming
+- Severity: warning
+- Rule: Use descriptive names
+`;
+      createTestMarkdown("test.md", content);
+
+      // Read and verify file was created
+      const savedContent = fs.readFileSync(path.join(STANDARDS_DIR, "test.md"), "utf-8");
+      expect(savedContent).toContain("RULE-001");
+      expect(savedContent).toContain("RULE-002");
+    });
+
+    it("should handle empty files", () => {
+      createTestMarkdown("empty.md", "");
+      const savedContent = fs.readFileSync(path.join(STANDARDS_DIR, "empty.md"), "utf-8");
+      expect(savedContent).toBe("");
+    });
+
+    it("should handle files without rules", () => {
+      const content = `# Simple Document
+
+Just some text without rules.
+`;
+      createTestMarkdown("simple.md", content);
+      const savedContent = fs.readFileSync(path.join(STANDARDS_DIR, "simple.md"), "utf-8");
+      expect(savedContent).toContain("Simple Document");
+    });
+  });
+
+  describe("cosineSimilarity", () => {
+    it("should return 1 for identical vectors", () => {
+      const a = [1, 2, 3];
+      const b = [1, 2, 3];
+      // Inline test for cosine similarity logic
+      let dotProduct = 0;
+      let normA = 0;
+      let normB = 0;
+      for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+      }
+      const similarity = dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+      expect(similarity).toBeCloseTo(1, 5);
+    });
+
+    it("should return 0 for orthogonal vectors", () => {
+      const a = [1, 0];
+      const b = [0, 1];
+      let dotProduct = 0;
+      let normA = 0;
+      let normB = 0;
+      for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+      }
+      const similarity = dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+      expect(similarity).toBeCloseTo(0, 5);
+    });
+
+    it("should handle different length vectors", () => {
+      const a = [1, 2, 3];
+      const b = [1, 2];
+      // Should return 0 or handle gracefully
+      if (a.length !== b.length) {
+        expect(true).toBe(true); // Different lengths not comparable
+      }
+    });
+  });
+
+  describe("File hash calculation", () => {
+    it("should generate consistent hashes for same content", () => {
+      const crypto = require("crypto");
+      const content = "test content";
+      const hash1 = crypto.createHash("md5").update(content).digest("hex");
+      const hash2 = crypto.createHash("md5").update(content).digest("hex");
+      expect(hash1).toBe(hash2);
+    });
+
+    it("should generate different hashes for different content", () => {
+      const crypto = require("crypto");
+      const hash1 = crypto.createHash("md5").update("content1").digest("hex");
+      const hash2 = crypto.createHash("md5").update("content2").digest("hex");
+      expect(hash1).not.toBe(hash2);
+    });
+  });
+});
+
+describe("RAG Directory Structure", () => {
+  beforeEach(() => {
+    setupTestDir();
+  });
+
+  afterEach(() => {
+    cleanupTestDir();
+  });
+
+  it("should create RAG directory when needed", () => {
+    fs.mkdirSync(RAG_DIR, { recursive: true });
+    expect(fs.existsSync(RAG_DIR)).toBe(true);
+  });
+
+  it("should save and load index file", () => {
+    fs.mkdirSync(RAG_DIR, { recursive: true });
+    const index = {
+      version: "1.0",
+      model: "nomic-embed-text",
+      createdAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString(),
+      totalChunks: 10,
+    };
+    const indexPath = path.join(RAG_DIR, "index.json");
+    fs.writeFileSync(indexPath, JSON.stringify(index, null, 2));
+
+    const loaded = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
+    expect(loaded.version).toBe("1.0");
+    expect(loaded.totalChunks).toBe(10);
+  });
+
+  it("should save and load embeddings file", () => {
+    fs.mkdirSync(RAG_DIR, { recursive: true });
+    const embeddings = [
+      {
+        chunk: { filepath: "test.md", section: "Test", content: "Test content" },
+        embedding: [0.1, 0.2, 0.3],
+        hash: "abc123",
+      },
+    ];
+    const dataPath = path.join(RAG_DIR, "embeddings.json");
+    fs.writeFileSync(dataPath, JSON.stringify(embeddings));
+
+    const loaded = JSON.parse(fs.readFileSync(dataPath, "utf-8"));
+    expect(loaded.length).toBe(1);
+    expect(loaded[0].chunk.filepath).toBe("test.md");
+  });
+});