activo 0.4.0 → 0.4.1

package/README.md

@@ -1,191 +1,34 @@
 # ACTIVO
 
-AI 기반 코드 품질 분석 CLI 도구 (Ollama 전용)
+AI 기반 코드 품질 분석 CLI (Ollama)
 
-![Screenshot](screenshot.png)
+![Demo](demo.gif)
 
 ## 설치
 
 ```bash
-# 글로벌 설치 (권장)
 npm install -g activo
-
-# 또는 npx로 바로 실행
-npx activo
-```
-
-## 사용법
-
-```bash
-# 대화형 모드
-activo
-
-# 프롬프트와 함께 실행
-activo "src 폴더 구조 보여줘"
-
-# 비대화형 모드
-activo --print "package.json 분석해줘"
-
-# 특정 모델 사용
-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 변환
-- **코드 품질 분석**: 규칙 기반 코드 점검
-
-## 도구 목록
-
-| 카테고리 | 도구 | 설명 |
-|----------|------|------|
-| **기본** | `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) 실행 중
+- 모델: `ollama pull mistral:latest`
 
-## Ollama 설정
-
-### 1. Ollama 설치
-
-```bash
-# macOS
-brew install ollama
-
-# Windows
-# https://ollama.ai 에서 다운로드
-
-# Linux
-curl -fsSL https://ollama.ai/install.sh | sh
-```
-
-### 2. 모델 다운로드
-
-```bash
-# 권장 모델
-ollama pull mistral:latest
-
-# 한국어 지원 모델
-ollama pull qwen2.5:7b
-
-# 코드 특화 모델
-ollama pull codellama:7b
-
-# 임베딩 모델 (의미 검색용)
-ollama pull nomic-embed-text
-```
-
-### 3. Ollama 실행
+## 사용법
 
 ```bash
-ollama serve
-```
-
-### 4. activo 설정
+# 대화형 모드
+activo
 
-`~/.activo/config.json`:
-```json
-{
-  "ollama": {
-    "baseUrl": "http://localhost:11434",
-    "model": "mistral:latest"
-  }
-}
-```
+# 프롬프트와 함께 실행
+activo "src 폴더 분석해줘"
 
-또는 CLI 옵션으로 모델 지정:
-```bash
+# 특정 모델 사용
 activo --model qwen2.5:7b
 ```
 
-## 단축키
-
-| 키 | 동작 |
-|---|------|
-| `Enter` | 메시지 전송 |
-| `ESC` | 진행 중 작업 취소 |
-| `Ctrl+C` x2 | 종료 |
-
 ## 라이선스
 
 MIT

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.1",
   "description": "AI-powered code quality analyzer with React Ink TUI, Tool Calling, and MCP support",
   "repository": {
     "type": "git",

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");
+  });
+});