archpilot 0.2.0__tar.gz

archpilot-0.2.0/.env.example

@@ -0,0 +1,10 @@
+# ===== OpenAI =====
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4o
+OPENAI_MAX_TOKENS=4096
+
+# ===== ArchPilot =====
+ARCHPILOT_OUTPUT_DIR=./output
+ARCHPILOT_DIAGRAM_FORMAT=png
+ARCHPILOT_SERVER_HOST=127.0.0.1
+ARCHPILOT_SERVER_PORT=8080

archpilot-0.2.0/.gitignore

@@ -0,0 +1,33 @@
+# Environment
+.env
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+.python-version
+
+# Build
+dist/
+build/
+*.egg-info/
+.eggs/
+
+# Output
+output/
+dist/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/

archpilot-0.2.0/CLAUDE.md

@@ -0,0 +1,221 @@
+# ArchPilot — CLAUDE.md `v0.2.0`
+
+## 프로젝트 개요
+
+Legacy 시스템 구성을 코드화(다이어그램)하고, 자연어 요구사항을 기반으로 현대화된 신규 시스템을 설계·시각화하는 CLI 도구.
+
+- **패키지명**: `archpilot`
+- **PyPI**: `pip install archpilot`
+- **진입점**: `archpilot` CLI (Typer 기반)
+- **Python**: 3.11+
+- **LLM**: OpenAI GPT-4o (`OPENAI_API_KEY` via `.env`)
+
+---
+
+## 디렉토리 구조
+
+```
+archpilot/
+├── src/
+│   └── archpilot/
+│       ├── __init__.py
+│       ├── cli/
+│       │   ├── __init__.py
+│       │   ├── main.py          # Typer app 진입점
+│       │   ├── cmd_init.py      # archpilot init
+│       │   ├── cmd_ingest.py    # archpilot ingest
+│       │   ├── cmd_analyze.py   # archpilot analyze
+│       │   ├── cmd_modernize.py # archpilot modernize
+│       │   ├── cmd_serve.py     # archpilot serve / export
+│       │   └── cmd_drawio.py    # archpilot drawio (setup/edit/watch/export)
+│       ├── core/
+│       │   ├── models.py        # Pydantic SystemModel, Component, Connection, AnalysisResult
+│       │   ├── parser.py        # YAML/JSON/텍스트 → SystemModel
+│       │   ├── diff.py          # Legacy vs Modern 비교 유틸
+│       │   ├── tech_ontology.py # 기술 스택 온톨로지 (자동 타입 추론)
+│       │   └── drawio_config.py # draw.io Desktop 설정/LevelDB 통합
+│       ├── llm/
+│       │   ├── client.py        # OpenAI 비동기 클라이언트 래퍼 (스트리밍 지원)
+│       │   ├── prompts.py       # 프롬프트 템플릿 (상수)
+│       │   ├── analyzer.py      # 레거시 시스템 분석
+│       │   ├── modernizer.py    # 현대화 설계 생성
+│       │   └── parser_agent.py  # 자연어 텍스트 → SystemModel
+│       ├── renderers/
+│       │   ├── base.py          # BaseRenderer 추상 클래스
+│       │   ├── mermaid.py       # SystemModel → Mermaid DSL
+│       │   ├── mingrammer.py    # SystemModel → diagrams(mingrammer) → PNG/SVG
+│       │   ├── drawio.py        # SystemModel → draw.io XML
+│       │   ├── drawio_parser.py # draw.io XML → SystemModel (역방향 파서)
+│       │   └── drawio_library.py# ArchPilot 컴포넌트 라이브러리 파일 생성
+│       ├── ui/
+│       │   ├── server.py        # FastAPI 인터랙티브 UI 서버 (SSE 스트리밍)
+│       │   ├── session.py       # 인메모리 세션 관리
+│       │   └── templates/
+│       │       ├── app.html.j2      # 인터랙티브 웹 앱
+│       │       └── slides.html.j2   # reveal.js 발표 슬라이드
+│       └── config.py            # pydantic-settings, .env 로드
+├── tests/
+│   ├── conftest.py
+│   ├── test_parser.py
+│   ├── test_renderers.py
+│   ├── test_drawio_parser.py
+│   └── test_diff.py
+├── examples/
+│   ├── legacy_ecommerce.yaml
+│   └── legacy_bank.yaml
+├── docs/
+│   ├── SPEC.md                  # 기능 명세
+│   ├── ARCHITECTURE.md          # 내부 아키텍처
+│   ├── ONTOLOGY.md              # 기술 온톨로지 & 입력 표준화 상세
+│   └── USER_GUIDE.md            # 입력 → 발표까지 사용자 가이드
+├── pyproject.toml
+├── .env.example
+└── README.md
+```
+
+---
+
+## 개발 규칙
+
+### 언어 & 포맷
+- Python 3.11, 타입 힌트 필수
+- 포매터: `ruff format`, 린터: `ruff check`
+- 타입 체커: `mypy --strict` (llm/, core/ 우선)
+- 커밋 전 `pre-commit run --all-files` 통과 필수
+
+### 데이터 모델
+- 모든 내부 모델은 `core/models.py`의 `SystemModel` 사용
+- 렌더러는 반드시 `BaseRenderer`를 상속하고 `render(model) -> str` 구현
+- LLM 응답은 항상 스트리밍 SSE + Pydantic 파싱
+
+### LLM 호출
+- `llm/client.py`의 `LLMClient` / `get_async_client()` 만 사용 (직접 `openai.OpenAI()` 호출 금지)
+- 프롬프트는 `llm/prompts.py`에 상수로 정의 (하드코딩 금지)
+- API 오류는 `tenacity`로 최대 3회 재시도
+
+### CLI
+- 모든 커맨드는 `cmd_*.py`에 분리
+- 출력은 `rich` 사용 (print 직접 사용 금지)
+- 에러는 `typer.echo(err=True)` + `raise typer.Exit(1)`
+
+### 테스트
+- LLM 호출은 `pytest-mock`으로 모킹
+- 렌더러 테스트는 출력 문자열 스냅샷 비교
+- `pytest -x` 기준 전체 통과 유지
+
+### 환경 변수
+- `.env` 파일로만 관리, 코드에 키 하드코딩 금지
+- `config.py`의 `Settings` 객체를 통해서만 접근
+- `.env`는 절대 커밋 금지 (`.gitignore` 등록)
+
+---
+
+## 핵심 CLI 명령어
+
+```bash
+archpilot init                        # .env 초기화 마법사
+archpilot ingest <file> [options]     # 레거시 시스템 파일 주입
+archpilot analyze <system.json>       # LLM 분석 보고서 생성
+archpilot modernize <system.json>     # LLM 현대화 설계 생성
+archpilot serve <output_dir>          # 인터랙티브 UI + reveal.js 서버 실행
+archpilot export <system.json>        # system.json → .drawio 파일 내보내기
+
+# draw.io Desktop 통합 서브커맨드
+archpilot drawio setup                # draw.io Desktop에 ArchPilot 라이브러리 설치
+archpilot drawio edit [--output]      # draw.io Desktop으로 다이어그램 편집
+archpilot drawio watch <file>         # draw.io 파일 변경 자동 감시·반영
+archpilot drawio export <system.json> # system.json → .drawio 내보내기
+```
+
+---
+
+## 의존성 (주요)
+
+| 패키지 | 용도 |
+|--------|------|
+| `typer[all]` | CLI 프레임워크 |
+| `rich` | 터미널 출력 |
+| `openai>=1.30` | LLM 클라이언트 (비동기 스트리밍) |
+| `python-dotenv` | .env 로드 |
+| `pydantic>=2.0` | 데이터 모델 |
+| `pydantic-settings` | 설정 관리 |
+| `pyyaml` | YAML 파싱 |
+| `diagrams>=0.23` | mingrammer 다이어그램 |
+| `jinja2` | HTML 템플릿 |
+| `fastapi>=0.111` | 인터랙티브 UI + API 서버 |
+| `uvicorn[standard]` | ASGI 서버 |
+| `python-multipart` | 파일 업로드 |
+| `tenacity` | LLM 재시도 |
+| `watchdog>=4.0` | draw.io 파일 변경 감시 |
+
+---
+
+## .env 구조
+
+```env
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4o
+OPENAI_MAX_TOKENS=4096
+ARCHPILOT_OUTPUT_DIR=./output
+ARCHPILOT_DIAGRAM_FORMAT=png
+ARCHPILOT_SERVER_HOST=127.0.0.1
+ARCHPILOT_SERVER_PORT=8080
+```
+
+---
+
+## 출력 디렉토리 구조 (output/)
+
+```
+output/
+├── system.json              # 파싱된 SystemModel (중간 산출물)
+├── legacy/
+│   ├── diagram.mmd          # Mermaid DSL
+│   ├── diagram.png          # diagrams 렌더링
+│   └── diagram.drawio       # draw.io XML
+├── analysis.json            # LLM 분석 결과
+├── modern/
+│   ├── system.json          # 현대화된 SystemModel
+│   ├── diagram.mmd
+│   ├── diagram.png
+│   ├── diagram.drawio
+│   └── migration_plan.md    # 마이그레이션 로드맵 (마크다운)
+└── slides/
+    └── index.html           # reveal.js 발표 자료 (정적 export 시)
+```
+
+---
+
+## UI 서버 API 엔드포인트
+
+| 메서드 | 경로 | 설명 |
+|--------|------|------|
+| GET | `/` | 인터랙티브 웹 앱 |
+| GET | `/slides` | reveal.js 발표 슬라이드 |
+| GET | `/api/state` | 현재 세션 상태 조회 |
+| DELETE | `/api/state` | 세션 초기화 |
+| POST | `/api/ingest` | YAML/JSON/텍스트 주입 |
+| POST | `/api/ingest/file` | 파일 업로드 주입 |
+| POST | `/api/ingest/drawio` | draw.io XML 주입 |
+| POST | `/api/chat/ingest/stream` | 대화형 시스템 입력 (SSE) |
+| GET | `/api/analyze/stream` | LLM 분석 스트리밍 (SSE) |
+| POST | `/api/modernize/stream` | LLM 현대화 설계 스트리밍 (SSE) |
+| GET | `/api/diagram/{step}` | 다이어그램 다운로드 (mermaid/drawio) |
+
+---
+
+## 📝 변경 이력
+
+### v0.2.0 (2026-03-13) — 아키텍처 문서화 완료 및 PyPI 배포 준비
+
+- ✨ `core/tech_ontology.py` — TechOntology 설계 (70+ 기술 스택 자동 타입 추론)
+- ✨ `renderers/drawio_parser.py` — draw.io XML → SystemModel 역방향 파서
+- ✨ `renderers/drawio_library.py` — draw.io Desktop 컴포넌트 라이브러리 생성
+- ✨ `core/drawio_config.py` — Electron LevelDB 직접 주입으로 draw.io Desktop 설정 자동화
+- ✨ `ui/server.py` — Flask → FastAPI + SSE 스트리밍 전환
+- ✨ `ui/session.py` — 인메모리 세션 관리
+- ✨ `archpilot drawio export` — draw.io → system.json 변환 커맨드 추가
+- 📝 `docs/ARCHITECTURE.md` — TechOntology·DrawioParser·DrawioConfig·FastAPI 섹션 신규 작성
+- 📝 `docs/ONTOLOGY.md` — 입력 표준화 파이프라인 및 온톨로지 상세 문서 신규 작성
+- 📝 `docs/USER_GUIDE.md` — 5가지 입력 시나리오 실전 가이드 신규 작성
+- 🔧 `pyproject.toml` — PyPI 배포용 메타데이터 완성 (classifiers, keywords, authors)

archpilot-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sungwoo Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

archpilot-0.2.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: archpilot
+Version: 0.2.0
+Summary: 레거시 시스템 구성을 다이어그램으로 코드화하고 AI 기반으로 현대화 아키텍처를 설계·시각화하는 CLI 도구
+Project-URL: Homepage, https://github.com/bullpeng72/ArchPilot
+Project-URL: Repository, https://github.com/bullpeng72/ArchPilot
+Project-URL: Bug Tracker, https://github.com/bullpeng72/ArchPilot/issues
+Project-URL: Changelog, https://github.com/bullpeng72/ArchPilot/blob/main/README.md
+Author-email: Sungwoo Kim <sungwoo.kim@gmail.com>
+Maintainer-email: Sungwoo Kim <sungwoo.kim@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,architecture,cli,cloud,diagram,diagrams,drawio,fastapi,infrastructure,legacy,llm,mermaid,microservices,migration,modernization,openai,reveal.js,system-design
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Korean
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: System :: Systems Administration
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: diagrams>=0.23
+Requires-Dist: fastapi>=0.111
+Requires-Dist: jinja2>=3.1
+Requires-Dist: openai<2,>=1.30
+Requires-Dist: pydantic-settings<3,>=2.0
+Requires-Dist: pydantic<3,>=2.0
+Requires-Dist: python-dotenv<2,>=1.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tenacity>=8.0
+Requires-Dist: typer[all]>=0.12
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: watchdog>=4.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ArchPilot
+
+![version](https://img.shields.io/badge/version-0.2.0-blue)
+![python](https://img.shields.io/badge/python-3.11%2B-blue)
+![license](https://img.shields.io/badge/license-MIT-green)
+
+Legacy 시스템 구성을 다이어그램으로 코드화하고, AI 기반으로 현대화된 아키텍처를 설계·시각화하는 CLI 도구.
+
+## 설치
+
+```bash
+pip install archpilot
+```
+
+## 빠른 시작
+
+```bash
+# 1. 초기화 (.env 생성 — OpenAI API Key 입력)
+archpilot init
+
+# 2. 레거시 시스템 다이어그램화
+archpilot ingest examples/legacy_ecommerce.yaml
+
+# 3. AI 분석
+archpilot analyze output/system.json
+
+# 4. 현대화 설계
+archpilot modernize output/system.json -r "AWS 마이크로서비스, Kubernetes, Redis"
+
+# 5. 인터랙티브 UI + 발표 자료 서버
+archpilot serve output/
+```
+
+## draw.io Desktop 통합
+
+draw.io에서 직접 아키텍처를 그리고 ArchPilot으로 분석할 수 있습니다.
+
+```bash
+# ArchPilot 컴포넌트 라이브러리를 draw.io Desktop에 설치
+archpilot drawio setup
+
+# draw.io Desktop으로 다이어그램 열기 + 변경 자동 감지
+archpilot drawio edit --output output/
+
+# draw.io 파일 변경 감시 (저장 시 자동 반영)
+archpilot drawio watch output/legacy/diagram.drawio
+```
+
+## 전체 CLI 명령어
+
+```
+archpilot init                        .env 초기화 마법사
+archpilot ingest <file>               레거시 시스템 파일 주입 (YAML/JSON/텍스트)
+archpilot analyze <system.json>       LLM 분석 보고서 생성
+archpilot modernize <system.json>     LLM 현대화 설계 생성
+archpilot serve <output_dir>          인터랙티브 UI 서버 실행
+archpilot export [output_dir]         발표 슬라이드 → 정적 HTML 내보내기 (dist/)
+archpilot drawio setup                draw.io Desktop 라이브러리 설치
+archpilot drawio edit                 draw.io Desktop으로 편집
+archpilot drawio watch <file>         파일 변경 자동 감시
+archpilot drawio export <file>        draw.io → system.json 변환
+```
+
+## 요구사항
+
+- Python 3.11+
+- OpenAI API Key
+- Graphviz (PNG 출력 시)
+- draw.io Desktop (drawio 통합 기능 사용 시)
+
+## 변경 이력
+
+### v0.2.0 (2026-03-13)
+
+- draw.io XML → SystemModel 역방향 파서 (`drawio_parser`)
+- draw.io Desktop LevelDB 설정 자동 주입 (`drawio_config`)
+- Flask → FastAPI + SSE 스트리밍 전환
+- `archpilot drawio export` 커맨드 추가
+- TechOntology — 70+ 기술 스택 자동 타입 추론
+- PyPI 배포용 메타데이터 완성

archpilot-0.2.0/README.md

@@ -0,0 +1,80 @@
+# ArchPilot
+
+![version](https://img.shields.io/badge/version-0.2.0-blue)
+![python](https://img.shields.io/badge/python-3.11%2B-blue)
+![license](https://img.shields.io/badge/license-MIT-green)
+
+Legacy 시스템 구성을 다이어그램으로 코드화하고, AI 기반으로 현대화된 아키텍처를 설계·시각화하는 CLI 도구.
+
+## 설치
+
+```bash
+pip install archpilot
+```
+
+## 빠른 시작
+
+```bash
+# 1. 초기화 (.env 생성 — OpenAI API Key 입력)
+archpilot init
+
+# 2. 레거시 시스템 다이어그램화
+archpilot ingest examples/legacy_ecommerce.yaml
+
+# 3. AI 분석
+archpilot analyze output/system.json
+
+# 4. 현대화 설계
+archpilot modernize output/system.json -r "AWS 마이크로서비스, Kubernetes, Redis"
+
+# 5. 인터랙티브 UI + 발표 자료 서버
+archpilot serve output/
+```
+
+## draw.io Desktop 통합
+
+draw.io에서 직접 아키텍처를 그리고 ArchPilot으로 분석할 수 있습니다.
+
+```bash
+# ArchPilot 컴포넌트 라이브러리를 draw.io Desktop에 설치
+archpilot drawio setup
+
+# draw.io Desktop으로 다이어그램 열기 + 변경 자동 감지
+archpilot drawio edit --output output/
+
+# draw.io 파일 변경 감시 (저장 시 자동 반영)
+archpilot drawio watch output/legacy/diagram.drawio
+```
+
+## 전체 CLI 명령어
+
+```
+archpilot init                        .env 초기화 마법사
+archpilot ingest <file>               레거시 시스템 파일 주입 (YAML/JSON/텍스트)
+archpilot analyze <system.json>       LLM 분석 보고서 생성
+archpilot modernize <system.json>     LLM 현대화 설계 생성
+archpilot serve <output_dir>          인터랙티브 UI 서버 실행
+archpilot export [output_dir]         발표 슬라이드 → 정적 HTML 내보내기 (dist/)
+archpilot drawio setup                draw.io Desktop 라이브러리 설치
+archpilot drawio edit                 draw.io Desktop으로 편집
+archpilot drawio watch <file>         파일 변경 자동 감시
+archpilot drawio export <file>        draw.io → system.json 변환
+```
+
+## 요구사항
+
+- Python 3.11+
+- OpenAI API Key
+- Graphviz (PNG 출력 시)
+- draw.io Desktop (drawio 통합 기능 사용 시)
+
+## 변경 이력
+
+### v0.2.0 (2026-03-13)
+
+- draw.io XML → SystemModel 역방향 파서 (`drawio_parser`)
+- draw.io Desktop LevelDB 설정 자동 주입 (`drawio_config`)
+- Flask → FastAPI + SSE 스트리밍 전환
+- `archpilot drawio export` 커맨드 추가
+- TechOntology — 70+ 기술 스택 자동 타입 추론
+- PyPI 배포용 메타데이터 완성