Metadata-Version: 2.4
Name: isagellm-dev-tools
Version: 0.2.3.0
Summary: Developer tools for sageLLM multi-repository development
Author-email: IntelliStream Team <intellistream@outlook.com>
License: Proprietary
Project-URL: Homepage, https://github.com/intellistream/sagellm-dev-tools
Project-URL: Repository, https://github.com/intellistream/sagellm-dev-tools
Project-URL: Issues, https://github.com/intellistream/sagellm-dev-tools/issues
Keywords: llm,inference,developer-tools,sagellm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: ==3.11.*
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: GitPython>=3.1.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: ruff>=0.8.0; extra == "dev"
Requires-Dist: mypy>=1.5.0; extra == "dev"
Requires-Dist: pre-commit>=3.3.0; extra == "dev"

# sagellm-dev-tools: sageLLM Developer Tools

**Status**: 🚧 Under Development\
**PyPI Package**: `isagellm-dev-tools`\
**CLI Tool**: `sagellm-dev`

## 🎯 Purpose

Unified developer toolkit for sageLLM multi-repository development workflow.

## 📦 Installation

```bash
# Install from PyPI
pip install isagellm-dev-tools

# Or install from source
git clone git@github.com:intellistream/sagellm-dev-tools.git
cd sagellm-dev-tools
pip install -e .
```

## 🚀 Quick Start

```bash
# Initialize development environment (clone all repos)
sagellm-dev init

# Sync all repositories
sagellm-dev sync

# Check architecture and dependencies
sagellm-dev check

# Install git hooks to all repos
sagellm-dev hooks install

# Push all repositories
sagellm-dev push
```

## 📖 Command Reference

### Repository Management

```bash
sagellm-dev init                    # Clone all sageLLM repositories
sagellm-dev sync [--all]           # Sync all repos (git pull)
sagellm-dev push [--check]         # Batch push
sagellm-dev merge <from> <to>      # Batch merge branches
sagellm-dev status                 # Show status of all repos
```

### Architecture & Dependency Checks

```bash
sagellm-dev check                  # Run all checks
sagellm-dev check --arch          # Architecture conformance
sagellm-dev check --deps          # Dependency versions
sagellm-dev check --hooks         # Git hooks integrity
```

### Tool Fixes

```bash
sagellm-dev fix                   # Run all fixes
sagellm-dev fix --tools           # Fix tool versions (ruff, pre-commit)
sagellm-dev fix --deps            # Fix dependency mismatches
```

### Git Hooks Management

```bash
sagellm-dev hooks install         # Install hooks to all repos
sagellm-dev hooks uninstall       # Remove hooks
sagellm-dev hooks update          # Update hook templates
sagellm-dev hooks status          # Check hooks status
```

### PyTorch Management

```bash
sagellm-dev pytorch download <version> <platform>  # Download wheels
sagellm-dev pytorch upload <version> <platform>    # Upload to GitHub
sagellm-dev pytorch list                           # List versions

# Examples:
sagellm-dev pytorch download 2.5.1 cu121           # CUDA 12.1
sagellm-dev pytorch download 2.5.1 cpu             # CPU only
```

### Information

```bash
sagellm-dev info                  # Show environment info
sagellm-dev version               # Show version
```

### GitHub Issue Management

```bash
sagellm-dev gh list <repo>                                # List open issues
sagellm-dev gh view <repo> <issue>                        # View issue details
sagellm-dev gh assign <repo> <issue> <user>               # Assign issue to user
sagellm-dev gh assign-batch <repo> <user> <issues...>     # Batch assign
sagellm-dev gh priority <repo>                            # Group by assignee/priority
sagellm-dev gh stale [--days N] [--repos ...]             # Show stale issues (>N days)
sagellm-dev gh create <repo> --title "..."                # Create issue
		[--body "..."] [--assignee user]... [--label label]...

# Examples:
sagellm-dev gh create sagellm-website --title "[Feature] Leaderboard" \
	--body "负责人：王明琪" --assignee MingqiWang-coder --label enhancement

sagellm-dev gh stale                                      # All repos, >14 days
sagellm-dev gh stale --days 7                             # All repos, >7 days
sagellm-dev gh stale --repos sagellm-core --repos sagellm-kv-cache  # Specific repos
```

### Statistics & Analytics

```bash
sagellm-dev stats commits [--since DATE] [--until DATE]   # Commit statistics
sagellm-dev stats commits --repos <repo1> --repos <repo2> # Specific repos
sagellm-dev stats commits --author <pattern>              # Filter by author
sagellm-dev stats commits --show-details                  # Show commit details

# Examples:
sagellm-dev stats commits                                 # All time, all repos
sagellm-dev stats commits --since "1 month ago"           # Last month
sagellm-dev stats commits --since 2024-01-01 --until 2024-12-31
sagellm-dev stats commits --author yang                   # Filter by author name
sagellm-dev stats commits --repos sagellm-core --show-details
```

## 🏗️ Architecture

```
sagellm-dev-tools/
├── src/sagellm_dev_tools/
│   ├── cli.py                 # Main CLI entry
│   ├── repo_manager.py        # Repository operations
│   ├── checker.py             # Architecture/dependency checks
│   ├── fixer.py               # Automated fixes
│   ├── hooks_manager.py       # Git hooks management
│   ├── pytorch_manager.py     # PyTorch download/upload
│   ├── constants.py           # Constants
│   └── templates/             # Git hook templates
└── tests/
```

## 🔒 Privacy

This is a **private** repository. Internal use only for sageLLM development team.

## 📄 License

Proprietary - Internal Use Only

______________________________________________________________________

**Maintainer**: IntelliStream Team\
**Related**: [sagellm](https://github.com/intellistream/sagellm)
