Metadata-Version: 2.4
Name: aos-git
Version: 0.11.3
Summary: AI-powered Git merge conflict resolver — let AI merge both sides intelligently
License: MIT
Project-URL: Homepage, http://mod.lge.com/hub/esdataplfm/part_de/aos-git.git
Project-URL: Issues, http://mod.lge.com/hub/esdataplfm/part_de/aos-git.git/issues
Keywords: git,merge,conflict,ai,cli
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1
Requires-Dist: rich>=13.0
Requires-Dist: tomli_w>=1.0
Requires-Dist: openai>=1.0
Requires-Dist: anthropic>=0.25
Requires-Dist: typing_extensions>=4.15
Requires-Dist: questionary>=2.0

# aos — AI-powered Git Helper

git을 몰라도, AI가 충돌을 해결해주는 Git 도우미입니다.

---

## 🚀 5분 만에 시작하기 (팀원)

```bash
pip install aos-git           # 설치
cd 내프로젝트 && aos init      # 프로젝트 초기화 (hooks + 알림 수신자)
aos setup                     # Databricks Token 입력만 (SMTP/AI는 사내 기본값 자동 적용)
aos doctor                    # 모든 항목 ✔ 확인
```

**자세한 가이드:**
- 👥 **팀원** → `docs/03-team-member-quickstart.md`
- 👑 **관리자** → `docs/03-admin-guide.md`

---

## 🔥 이 5개만 알면 됩니다

| 명령어 | 언제 쓰나요 |
|--------|-------------|
| **`aos init`** | 프로젝트에 aos 처음 설정할 때 (hooks + 알림) |
| **`aos setup`** | Databricks Token 설정 (SMTP/AI는 사내 기본값); `--notify`로 수신자/관리자 변경 |
| **`aos checkout -b feature/내작업`** | 새 브랜치를 만들어 작업 시작할 때 |
| **`aos commit -m "작업 내용"`** | 변경사항을 커밋할 때 |
| **`aos push`** | 커밋한 내용을 원격에 올릴 때 (팀원에게 이메일 자동 발송) |

---

## 📋 일상 작업 흐름

```bash
# 1. 새 브랜치에서 시작
aos checkout -b feature/데이터정제

# 2. 코드 수정 후
aos add                           # 변경사항 스테이징
aos commit -m "데이터 정제 로직 추가"  # 커밋
aos push                          # push → 팀원에게 이메일 자동 발송

# 3. 메일 수신 후 (상대방 작업 반영)
aos sync      # 충돌 시 AI가 자동 해결 후 커밋
aos push
```

---

## 🩺 문제 해결

```bash
aos doctor                  # 한 방에 진단
```

### 자주 보는 ✗ 와 해결
| 화면 메시지 | 원인 | 해결 |
|------------|------|------|
| 전역 설정 파일이 없습니다 | `~/.aos/config.toml` 없음 | `aos setup` |
| 수신자(recipients) 비어있음 | 팀원 이메일 미등록 | `aos setup --notify` |
| pre-push hook 미설치 | hooksPath 미설정 | `aos init --hooks-only` |

> 💡 가장 빠른 진단: `aos doctor`. ✗ 항목마다 정확한 해결 명령어가 표시됩니다.

---

## 📖 전체 명령어 레퍼런스

| 명령어 | 설명 | 예시 |
|--------|------|------|
| `aos init` | 프로젝트에 aos 처음 설정 (hooks + 알림 수신자) | `aos init` |
| `aos setup` | Databricks Token 설정 (SMTP/AI는 사내 기본값); `--notify`로 수신자/관리자 변경 | `aos setup --notify` |
| `aos checkout` | 브랜치 전환 / 생성 (화살표 선택 가능) | `aos checkout -b feature/x` |
| `aos branch` | 브랜치 목록 / 삭제 | `aos branch -a` |
| `aos add` | 변경사항 스테이징 (파일 미지정 시 전체) | `aos add src/` |
| `aos commit` | 커밋 (AI 충돌 해결이 필요하면 자동으로 처리) | `aos commit -m "fix: .."` |
| `aos push` | 원격에 올리기 + 팀원 이메일 발송 | `aos push` |
| `aos sync` | 최신 main을 내 브랜치에 반영 (충돌 시 AI 자동 해결) | `aos sync` |
| `aos merge` | 다른 브랜치를 병합 (충돌 시 AI 자동 해결) | `aos merge feature/x` |
| `aos resolve` | 남아 있는 충돌 수동 해결 후 스테이징 | `aos resolve` |
| `aos release` | PyPI 자동 배포 (patch / minor / major) | `aos release patch` |
| `aos status` | 현재 상태 확인 | `aos status` |
| `aos doctor` | 전체 환경 진단 | `aos doctor` |
| `aos install` | 전역 skill 설치 | `aos install` |

---

## 처음 사용자

**Q: `aos init`과 `aos setup`은 뭐가 다릅니까?**
`aos init`은 프로젝트별로 실행 (hooks + 알림 수신자), `aos setup`은 내 PC에서 1회만 실행 (Databricks Token).

**Q: `--hooks-only`는 언제 쓰나요?**
`aos init`을 실행했더라도 hook만 다시 설치하고 싶을 때.

### Claude Code 연동
**Q: Claude Code와 aos를 함께 쓸 수 있나요?**
네. Claude Code 안에서 `!aos push`처럼 shell을 통해 aos 명령어를 그대로 사용 가능합니다.

---

## Claude Code / AI coding 도구 연동

aos의 모든 명령어는 CLI로 제공되므로, Claude Code, GitHub Copilot Chat, Cursor 등
AI 코딩 어시스턴트 안에서도 그대로 사용할 수 있습니다.

```bash
# Claude Code 안에서 실행
!aos push

# Copilot Chat에서
/aos sync
```

---

## 설치

```bash
pip install aos-git
```

자세한 설치 방법은 [docs/03-admin-guide.md](docs/03-admin-guide.md)를 참고하세요.
