activo 0.2.0

package/FINAL_SIMPLIFIED_SPEC.md

@@ -0,0 +1,456 @@
+# activo-code 최종 방안 (간소화)
+
+## 0. 참조 레포지토리
+
+### continue-cli GitHub
+- **메인 레포**: https://github.com/continuedev/continue
+- **CLI 코드 위치**: `extensions/cli/`
+- **Core 코드 위치**: `core/`
+
+### 작업 전 준비 (필수)
+
+```bash
+# continue 레포 클론 (참조용)
+cd ~/Downloads
+git clone https://github.com/continuedev/continue.git
+cd continue
+
+# CLI 구조 확인
+ls -la extensions/cli/
+ls -la extensions/cli/src/
+
+# Core 구조 확인  
+ls -la core/
+ls -la core/llm/
+```
+
+### 참조할 주요 파일
+
+```
+~/Downloads/continue/
+├── extensions/cli/
+│   ├── src/
+│   │   ├── index.ts              # CLI 엔트리포인트
+│   │   ├── commands/             # 명령어 구현
+│   │   ├── tui/                  # Terminal UI (React Ink)
+│   │   └── headless/             # Headless 모드
+│   └── package.json              # 의존성 참조
+├── core/
+│   ├── llm/
+│   │   ├── llms/                 # LLM 프로바이더들
+│   │   └── templates/            # 프롬프트 템플릿
+│   ├── config/                   # 설정 로딩
+│   └── tools/                    # Agent Tools
+└── packages/
+    └── openai-adapters/          # OpenAI 호환 어댑터
+```
+
+### 참조 시 주의사항
+- continue-cli는 범용 코딩 에이전트 (우리는 품질 분석 특화)
+- Ollama 연동 방식, CLI 구조, 세션 관리 참조
+- LLM Provider 추상화 패턴 참조
+- 프롬프트 구조는 우리 목적에 맞게 재설계
+
+---
+
+## 1. 결론 요약
+
+### 인터페이스: CLI 단일화
+```
+PDF → MD 변환: CLI (activo standards import)
+MD 수정: 에디터로 직접 (VS Code 등)
+코드 분석: CLI (activo improve, activo check)
+```
+
+### continue-cli RAG 기능
+**있음**, 하지만 제한적:
+- `.continue/rules/` 폴더에 MD 파일 배치 → 자동 컨텍스트 로드
+- `@docs` context provider → 문서 참조 (deprecated, MCP로 대체 중)
+- Custom Context Provider → 자체 RAG 서버 연동 가능
+
+**activo-code에서 활용 방안:**
+- 규칙 MD를 `.continue/rules/` 또는 `.activo/standards/`에 배치
+- 분석 시 해당 MD를 직접 로드하여 프롬프트에 포함 (자체 구현)
+
+---
+
+## 2. PDF → MD 변환 전략
+
+### 2.1 CLI 명령어
+
+```bash
+# PDF 변환 (청크 분할, 여러 MD 생성)
+activo standards import ./개발표준.pdf
+
+# 결과
+.activo/standards/
+├── _index.md           # 전체 목록/요약
+├── 01_명명규칙.md      # 청크 1
+├── 02_코드구조.md      # 청크 2
+├── 03_보안.md          # 청크 3
+├── 04_예외처리.md      # 청크 4
+└── 05_주석문서화.md    # 청크 5
+```
+
+### 2.2 청크 분할 전략
+
+| PDF 크기 | 청크 크기 | MD 파일 수 |
+|----------|----------|-----------|
+| ~20페이지 | 전체 1개 | 1개 |
+| 20~50페이지 | 장/절 단위 | 3~5개 |
+| 50페이지+ | 2000자 단위 | 다수 |
+
+**분할 기준:**
+1. 목차 기반 (장/절 경계)
+2. 페이지 단위 (목차 없을 경우)
+3. 고정 길이 (마지막 수단)
+
+### 2.3 생성되는 MD 구조
+
+```markdown
+# 명명규칙 (01_명명규칙.md)
+
+> 원본: 개발표준_v2.1.pdf (페이지 5-12)
+> 추출일: 2025-01-30
+
+## NR-001: 클래스명
+- 심각도: error
+- 규칙: PascalCase 사용
+- 예시: UserService (O), userService (X)
+
+## NR-002: 변수명
+- 심각도: warning
+- 규칙: camelCase 사용
+- 예시: userName (O), user_name (X)
+
+---
+[수동 수정 필요 시 이 파일을 직접 편집하세요]
+```
+
+### 2.4 수동 편집 가이드
+
+```bash
+# 변환 후 안내 메시지
+$ activo standards import ./개발표준.pdf
+
+PDF 변환 완료!
+- 생성된 파일: 5개
+- 위치: .activo/standards/
+
+[다음 단계]
+1. 생성된 MD 파일을 에디터로 확인하세요
+2. 잘못 추출된 규칙은 직접 수정/삭제하세요
+3. 누락된 규칙은 수동으로 추가하세요
+
+$ code .activo/standards/  # VS Code로 열기
+```
+
+---
+
+## 3. 아키텍처 (간소화)
+
+```
+┌─────────────────────────────────────────────────┐
+│                  activo-code                     │
+├─────────────────────────────────────────────────┤
+│                                                  │
+│  [CLI]                                          │
+│  ├── activo standards import <pdf>              │
+│  │   └── PDF → 청크 분할 → Ollama 추출 → MD들   │
+│  │                                              │
+│  ├── activo standards list                      │
+│  │   └── 현재 로드된 규칙 목록                  │
+│  │                                              │
+│  ├── activo improve <path>                      │
+│  │   └── 코드 개선점 분석 (Why/How)             │
+│  │                                              │
+│  ├── activo check <path>                        │
+│  │   └── 표준 규칙 준수 여부 점검               │
+│  │                                              │
+│  └── activo explain --input <cqc-result.json>   │
+│      └── code-quality-checker 결과 설명 추가    │
+│                                                  │
+├─────────────────────────────────────────────────┤
+│                                                  │
+│  [Standards Loader]                             │
+│  └── .activo/standards/*.md 로드                │
+│      └── 여러 MD 병합 → 프롬프트 컨텍스트       │
+│                                                  │
+├─────────────────────────────────────────────────┤
+│                                                  │
+│  [Ollama Engine]                                │
+│  ├── PDF 규칙 추출: qwen2.5:7b (한국어)         │
+│  └── 코드 분석: codellama:7b                    │
+│                                                  │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## 4. 분석 시 규칙 로드 방식
+
+### 4.1 단순 방식 (권장)
+
+```
+[분석 요청]
+     ↓
+[.activo/standards/*.md 전체 로드]
+     ↓
+[관련 규칙만 필터링] ← 파일 확장자, 카테고리 기반
+     ↓
+[프롬프트에 규칙 포함]
+     ↓
+[Ollama 호출]
+```
+
+**예시: Java 파일 분석 시**
+```
+로드할 규칙:
+- 01_명명규칙.md (전체)
+- 02_코드구조.md (전체)
+- 03_보안.md (전체)
+
+제외:
+- 06_HTML규칙.md
+- 07_CSS규칙.md
+```
+
+### 4.2 프롬프트 구성
+
+```
+[시스템]
+당신은 코드 품질 전문가입니다.
+아래 개발표준 규칙에 따라 코드를 점검하세요.
+
+[개발표준 규칙]
+## 명명규칙
+- NR-001: 클래스명 PascalCase (error)
+- NR-002: 변수명 camelCase (warning)
+...
+
+## 코드구조
+- CS-001: 메서드 50줄 이하 (warning)
+...
+
+[분석 대상 코드]
+```java
+public class userService { ... }
+```
+
+[질문]
+위 코드가 개발표준을 위반하는 부분을 찾고,
+각 위반에 대해 다음을 설명하세요:
+1. 위반 규칙 ID
+2. 위반 위치 (라인)
+3. 위반 이유
+4. 수정 방안
+```
+
+### 4.3 8GB Ollama 대응
+
+**규칙 MD가 너무 클 경우:**
+```
+전체 규칙: 10,000자 → 컨텍스트 초과
+
+해결책:
+1. 분석 대상 언어의 규칙만 로드
+2. 카테고리별로 나눠서 여러 번 호출
+3. 규칙 요약본 사용 (_index.md)
+```
+
+---
+
+## 5. CLI 명령어 최종
+
+```bash
+# 개발표준 관리
+activo standards import <pdf>     # PDF → MD 변환 (청크 분할)
+activo standards list             # 현재 규칙 목록
+activo standards validate         # MD 문법 검증
+
+# 코드 분석
+activo improve <path>             # 개선점 분석
+activo improve --focus naming     # 특정 영역 집중
+activo check <path>               # 표준 준수 점검
+activo check --strict             # 엄격 모드
+
+# code-quality-checker 연동
+activo explain -i result.json     # cqc 결과 설명
+
+# 설정
+activo config                     # 설정 확인/수정
+activo config set model codellama:7b
+```
+
+---
+
+## 6. continue-cli 참조 vs 자체 구현
+
+### continue-cli 레포 구조 (~/Downloads/continue/)
+
+```
+~/Downloads/continue/
+├── extensions/cli/           # ← 메인 참조 대상
+│   ├── src/
+│   │   ├── index.ts         # CLI 메인 (Commander.js)
+│   │   ├── commands/        # 명령어 핸들러
+│   │   ├── tui/             # React Ink TUI
+│   │   ├── headless/        # CI용 헤드리스 모드
+│   │   └── session/         # 세션 관리
+│   ├── package.json         # 의존성 목록
+│   └── tsconfig.json
+├── core/                     # ← LLM/Tool 참조
+│   ├── llm/
+│   │   ├── llms/            # 각 프로바이더 구현
+│   │   │   ├── Ollama.ts    # ★ Ollama 연동 참조
+│   │   │   ├── OpenAI.ts
+│   │   │   └── Anthropic.ts
+│   │   └── templates/       # 프롬프트 템플릿
+│   ├── config/              # 설정 로딩
+│   ├── tools/               # Agent Tools
+│   └── index.d.ts           # 타입 정의
+└── packages/
+    ├── config-types/        # 설정 타입
+    └── fetch/               # HTTP 클라이언트
+```
+
+### continue-cli에서 가져올 것
+- CLI 구조 (Commander.js 패턴) → `extensions/cli/src/index.ts`
+- Ollama 연동 방식 → `core/llm/llms/Ollama.ts`
+- 세션/히스토리 관리 → `extensions/cli/src/session/`
+- 설정 로딩 패턴 → `core/config/`
+
+### 자체 구현할 것
+- PDF 파싱 및 청크 분할
+- 개발표준 규칙 로더
+- 코드 품질 분석 프롬프트
+- code-quality-checker 연동
+
+### continue-cli RAG 활용 여부
+**활용 안 함** (자체 구현)
+- continue-cli RAG는 IDE 통합 위주
+- 우리는 단순히 MD 파일 로드 → 프롬프트 포함
+- 복잡한 벡터 DB 불필요 (규칙 MD는 작음)
+
+---
+
+## 7. 개발 우선순위
+
+### Phase 1 (1주)
+- [ ] CLI 프레임워크
+- [ ] Ollama 연동 (ollama-js)
+- [ ] 단일 파일 개선점 분석
+
+### Phase 2 (1주)
+- [ ] PDF 파싱 (pdf-parse)
+- [ ] 청크 분할 로직
+- [ ] MD 생성
+
+### Phase 3 (1주)
+- [ ] 규칙 MD 로더
+- [ ] 표준 준수 점검
+- [ ] cqc 연동
+
+---
+
+## 8. 파일 구조
+
+```
+activo-code/
+├── src/
+│   ├── cli/
+│   │   ├── index.ts
+│   │   └── commands/
+│   │       ├── standards.ts    # import, list, validate
+│   │       ├── improve.ts      # 개선점 분석
+│   │       ├── check.ts        # 표준 점검
+│   │       └── explain.ts      # cqc 연동
+│   ├── core/
+│   │   ├── pdf-parser.ts       # PDF → 텍스트
+│   │   ├── chunk-splitter.ts   # 청크 분할
+│   │   ├── rule-extractor.ts   # Ollama로 규칙 추출
+│   │   ├── rule-loader.ts      # MD 로드
+│   │   └── analyzer.ts         # 코드 분석
+│   └── llm/
+│       ├── ollama.ts           # Ollama 클라이언트
+│       └── prompts.ts          # 프롬프트 템플릿
+├── package.json
+└── .activo/                    # 프로젝트별 설정
+    └── standards/              # 규칙 MD 저장 위치
+```
+
+---
+
+## 9. 기술 스택
+
+| 영역 | 기술 |
+|------|------|
+| 언어 | TypeScript (Node.js) |
+| CLI | Commander.js |
+| PDF | pdf-parse |
+| LLM | ollama (npm 패키지) |
+| 출력 | chalk, ora |
+
+또는 Go로 통일 (code-quality-checker와 맞춤):
+
+| 영역 | 기술 |
+|------|------|
+| 언어 | Go |
+| CLI | cobra |
+| PDF | pdfcpu |
+| LLM | ollama Go client |
+
+---
+
+## 10. 개발 시작 전 체크리스트
+
+### 환경 준비
+
+```bash
+# 1. continue 레포 클론 (참조용)
+cd ~/Downloads
+git clone https://github.com/continuedev/continue.git
+
+# 2. continue-cli 구조 파악
+cd continue
+cat extensions/cli/package.json    # 의존성 확인
+cat extensions/cli/src/index.ts    # CLI 엔트리 확인
+cat core/llm/llms/Ollama.ts        # Ollama 연동 확인
+
+# 3. Ollama 설치 및 모델 다운로드
+ollama pull codellama:7b           # 코드 분석용
+ollama pull qwen2.5:7b             # 한국어 PDF용 (선택)
+
+# 4. activo-code 프로젝트 생성
+cd ~/Projects  # 또는 원하는 위치
+mkdir activo-code && cd activo-code
+pnpm init
+```
+
+### 참조 파일 복사 (선택)
+
+```bash
+# Ollama 연동 코드 참조용 복사
+cp ~/Downloads/continue/core/llm/llms/Ollama.ts ./reference/
+
+# CLI 구조 참조용 복사
+cp ~/Downloads/continue/extensions/cli/src/index.ts ./reference/
+```
+
+### Claude Code 작업 시 지시문
+
+```
+activo-code 프로젝트를 만들어주세요.
+
+참조 레포: ~/Downloads/continue/
+- CLI 구조: extensions/cli/src/
+- Ollama 연동: core/llm/llms/Ollama.ts
+- 설정 패턴: core/config/
+
+주요 기능:
+1. PDF → MD 변환 (청크 분할)
+2. 개발표준 규칙 점검
+3. 코드 개선점 분석
+
+Ollama 모델: codellama:7b (8GB 메모리 제한)
+```

package/README.md

@@ -0,0 +1,62 @@
+# ACTIVO
+
+AI 기반 코드 품질 분석 CLI 도구
+
+![Screenshot](screenshot.png)
+
+## 설치
+
+```bash
+pnpm install
+pnpm build
+npm link
+```
+
+## 사용법
+
+```bash
+# 대화형 모드
+activo
+
+# 프롬프트와 함께 실행
+activo "src 폴더 구조 보여줘"
+
+# 비대화형 모드
+activo --print "package.json 분석해줘"
+```
+
+## 주요 기능
+
+- **자연어 인터페이스**: 한글로 명령 입력
+- **Tool Calling**: 파일 읽기/쓰기, 검색, 명령 실행
+- **PDF 변환**: 개발표준 PDF → Markdown 변환
+- **코드 품질 분석**: 규칙 기반 코드 점검
+
+## 요구사항
+
+- Node.js 18+
+- [Ollama](https://ollama.ai) 실행 중
+
+## 설정
+
+`~/.activo/config.json`:
+```json
+{
+  "ollama": {
+    "baseUrl": "http://localhost:11434",
+    "model": "mistral:latest"
+  }
+}
+```
+
+## 단축키
+
+| 키 | 동작 |
+|---|------|
+| `Enter` | 메시지 전송 |
+| `ESC` | 진행 중 작업 취소 |
+| `Ctrl+C` x2 | 종료 |
+
+## 라이선스
+
+MIT

package/TODO.md

@@ -0,0 +1,193 @@
+# TODO.md - activo-code 개발 계획
+
+## 아키텍처 (v0.2.0 - React Ink TUI)
+
+### continue-cli 기반 새 구조
+```
+activo-code/
+├── src/
+│   ├── cli/
+│   │   ├── index.ts           # CLI 엔트리 (Commander.js + React Ink)
+│   │   ├── banner.ts          # ACTIVO ASCII 아트 배너
+│   │   └── headless.ts        # 비대화형 모드
+│   ├── core/
+│   │   ├── config.ts          # 설정 관리 (Ollama, MCP)
+│   │   ├── agent.ts           # 에이전트 (Tool Calling 루프)
+│   │   ├── llm/
+│   │   │   └── ollama.ts      # Ollama 클라이언트 (스트리밍, Tool Calling)
+│   │   ├── tools/
+│   │   │   ├── types.ts       # Tool, ToolCall, ToolResult 타입
+│   │   │   ├── builtIn.ts     # 내장 도구 (파일, 검색, 명령)
+│   │   │   ├── standards.ts   # 표준 도구 (PDF, 품질 체크)
+│   │   │   └── index.ts       # 도구 레지스트리
+│   │   └── mcp/
+│   │       └── client.ts      # MCP 프로토콜 클라이언트
+│   └── ui/
+│       ├── App.tsx            # 메인 React Ink 앱
+│       └── components/
+│           ├── InputBox.tsx   # 입력창 컴포넌트
+│           ├── MessageList.tsx # 메시지 목록
+│           ├── StatusBar.tsx  # 상태바 (모델, 메시지 수)
+│           └── ToolStatus.tsx # 도구 실행 상태
+├── package.json
+└── tsconfig.json
+```
+
+### 핵심 기능
+- **자연어 인터페이스**: 터미널에서 한글로 명령 입력
+- **Tool Calling**: Ollama가 필요한 도구 자동 선택/실행
+- **MCP 지원**: 외부 도구 서버 연결 가능
+- **스트리밍**: 실시간 응답 출력
+
+---
+
+## Phase 0: 프로젝트 리빌드 ✅
+
+### 0.1 React Ink TUI 구축
+- [x] ink, ink-spinner, ink-text-input 설치
+- [x] Commander.js + React Ink 통합
+- [x] ASCII 배너 (gradient-string)
+- [x] 대화형/비대화형 모드 분리
+
+**테스트:**
+```bash
+node dist/cli/index.js --version     # 0.2.0
+node dist/cli/index.js --help        # 옵션 목록
+node dist/cli/index.js --print "test" # 배너 + 응답
+```
+
+### 0.2 Ollama 클라이언트
+- [x] 스트리밍 chat 지원
+- [x] Tool Calling 지원
+- [x] 연결 상태 확인
+
+---
+
+## Phase 1: Tool Calling 시스템 ✅
+
+### 1.1 내장 도구 (Built-in Tools)
+- [x] `read_file` - 파일 읽기
+- [x] `write_file` - 파일 쓰기
+- [x] `list_directory` - 디렉토리 목록
+- [x] `grep_search` - 텍스트 검색
+- [x] `glob_search` - 파일 패턴 검색
+- [x] `run_command` - 명령 실행
+
+### 1.2 표준 도구 (Standards Tools)
+- [x] `import_pdf_standards` - PDF → MD 변환
+- [x] `list_standards` - 규칙 목록 조회
+- [x] `check_code_quality` - 코드 품질 체크
+
+### 1.3 에이전트 루프
+- [x] 시스템 프롬프트 정의
+- [x] 반복 Tool Calling 처리
+- [x] 스트리밍 이벤트 생성
+
+---
+
+## Phase 2: MCP 지원 ✅
+
+### 2.1 MCP 클라이언트
+- [x] StdioClientTransport 연동
+- [x] 도구 목록 조회
+- [x] 도구 호출 프록시
+
+### 2.2 설정
+- [x] ~/.activo/config.json 지원
+- [x] MCP 서버 설정 구조
+
+---
+
+## Phase 3: UI 컴포넌트 ✅
+
+### 3.1 React Ink 컴포넌트
+- [x] InputBox - 입력창 + 처리중 상태
+- [x] MessageList - 대화 기록 표시
+- [x] StatusBar - 모델, 메시지 수, 상태
+- [x] ToolStatus - 도구 실행 표시
+
+### 3.2 상태 관리
+- [x] 메시지 히스토리
+- [x] 도구 호출 추적
+- [x] 에러 표시
+- [x] Ctrl+C 처리 (2회 종료)
+
+---
+
+## Phase 4: 통합 및 테스트
+
+### 4.1 빌드 검증
+- [x] TypeScript 컴파일
+- [x] 배너 출력 확인
+- [ ] Ollama 연동 테스트
+- [ ] Tool Calling 실행 테스트
+
+### 4.2 사용 시나리오 테스트
+- [ ] "src 폴더 구조 보여줘"
+- [ ] "이 프로젝트의 코드 품질 분석해줘"
+- [ ] "PDF 파일을 규칙으로 변환해줘"
+- [ ] "명명규칙 위반 찾아줘"
+
+### 4.3 패키징
+- [ ] npm link 테스트
+- [ ] 글로벌 설치 테스트
+
+---
+
+## 테스트 체크리스트
+
+### 빌드 & 기본 테스트
+| 항목 | 명령어 | 예상 결과 | 상태 |
+|------|--------|-----------|------|
+| 빌드 | `pnpm build` | 성공 | ✅ |
+| 버전 | `node dist/cli/index.js --version` | 0.2.0 | ✅ |
+| 도움말 | `node dist/cli/index.js --help` | 옵션 목록 | ✅ |
+| 배너 | `node dist/cli/index.js --print "test"` | ASCII 아트 | ✅ |
+
+### 대화 테스트
+| 항목 | 명령어 | 예상 결과 | 상태 |
+|------|--------|-----------|------|
+| 파일 목록 | "src 폴더에 뭐가 있어?" | list_directory 호출 | ⬜ |
+| 파일 읽기 | "package.json 보여줘" | read_file 호출 | ⬜ |
+| 검색 | "TODO 찾아줘" | grep_search 호출 | ⬜ |
+| 품질 체크 | "코드 품질 분석해줘" | check_code_quality 호출 | ⬜ |
+
+---
+
+## 핵심 의존성
+
+```json
+{
+  "dependencies": {
+    "commander": "^14.0.0",
+    "chalk": "^5.4.1",
+    "ink": "^6.1.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.1.0",
+    "gradient-string": "^3.0.0",
+    "pdf-parse": "^1.1.1",
+    "@modelcontextprotocol/sdk": "^1.25.0",
+    "@anthropic-ai/sdk": "^0.52.0",
+    "uuid": "^9.0.1",
+    "date-fns": "^4.1.0"
+  }
+}
+```
+
+---
+
+## 진행 상황
+
+- **버전**: v0.2.0 (React Ink TUI 버전)
+- **현재 단계**: Phase 4.1 (빌드 검증)
+- **마지막 업데이트**: 2025-01-30
+- **다음 작업**: Ollama 연동 테스트, 실사용 시나리오 검증
+
+### 완료된 작업
+- [x] continue-cli 아키텍처 분석
+- [x] React Ink TUI 구현
+- [x] Tool Calling 시스템 구현
+- [x] MCP 클라이언트 구현
+- [x] ASCII 배너 구현
+- [x] 빌드 성공

package/dist/cli/banner.d.ts

@@ -0,0 +1,3 @@
+export declare function showBanner(): void;
+export declare function getShortBanner(): string;
+//# sourceMappingURL=banner.d.ts.map

package/dist/cli/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/cli/banner.ts"],"names":[],"mappings":"AAaA,wBAAgB,UAAU,IAAI,IAAI,CAgBjC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}