publish_to_github.py

#!/usr/bin/env python3
"""
GitHub Publisher Script

This script automates the process of publishing the AI Collaboration Framework
to GitHub with proper configuration and documentation.
"""

import os
import subprocess
from pathlib import Path


def run_command(cmd: str, cwd: str = None) -> tuple[bool, str]:
    """Run a shell command and return success status and output."""
    try:
        result = subprocess.run(
            cmd,
            shell=True,
            cwd=cwd,
            capture_output=True,
            text=True,
            timeout=30
        )
        return result.returncode == 0, result.stdout + result.stderr
    except subprocess.TimeoutExpired:
        return False, "Command timed out"
    except Exception as e:
        return False, str(e)


def init_git_repo(project_path: str) -> bool:
    """Initialize git repository."""
    print("📝 Initializing git repository...")
    
    success, output = run_command("git init", cwd=project_path)
    if not success:
        print(f"❌ Failed to init git: {output}")
        return False
    
    success, output = run_command(
        'git config user.name "AI Framework"',
        cwd=project_path
    )
    success, output = run_command(
        'git config user.email "ai@framework.dev"',
        cwd=project_path
    )
    
    print("✅ Git repository initialized")
    return True


def add_and_commit(project_path: str) -> bool:
    """Add files and create initial commit."""
    print("📦 Creating initial commit...")
    
    success, output = run_command("git add .", cwd=project_path)
    if not success:
        print(f"❌ Failed to add files: {output}")
        return False
    
    success, output = run_command(
        'git commit -m "Initial commit: AI Multi-Agent Collaboration Framework v1.0"',
        cwd=project_path
    )
    if not success:
        print(f"❌ Failed to commit: {output}")
        return False
    
    print("✅ Initial commit created")
    return True


def rename_branch(project_path: str) -> bool:
    """Rename master branch to main."""
    print("🔄 Renaming branch to main...")
    
    success, output = run_command("git branch -M main", cwd=project_path)
    if not success:
        print(f"⚠️  Could not rename branch: {output}")
        return False
    
    print("✅ Branch renamed to main")
    return True


def add_remote(project_path: str, github_url: str) -> bool:
    """Add remote repository."""
    print(f"🔗 Adding remote repository...")
    
    success, output = run_command(
        f"git remote add origin {github_url}",
        cwd=project_path
    )
    if not success:
        print(f"⚠️  Could not add remote: {output}")
        return False
    
    print("✅ Remote repository added")
    return True


def push_to_github(project_path: str) -> bool:
    """Push to GitHub."""
    print("🚀 Pushing to GitHub...")
    
    success, output = run_command(
        "git push -u origin main",
        cwd=project_path
    )
    if not success:
        print(f"❌ Failed to push: {output}")
        return False
    
    print("✅ Pushed to GitHub successfully")
    return True


def create_github_instructions(project_path: str, github_username: str, repo_name: str) -> None:
    """Create instructions file for GitHub setup."""
    instructions = f"""# GitHub Setup Instructions

## Repository Created Successfully!

Your AI Collaboration Framework has been initialized and is ready to be published to GitHub.

### Quick Setup

1. **Create repository on GitHub**
   - Visit: https://github.com/new
   - Repository name: `{repo_name}`
   - Description: "A production-grade AI multi-agent collaboration framework"
   - Public: Yes
   - Initialize: No

2. **Push to GitHub**
   ```bash
   cd {project_path}
   git remote add origin https://github.com/{github_username}/{repo_name}.git
   git branch -M main
   git push -u origin main
   ```

3. **Configure Repository**
   - Go to Settings → General
   - Add Topics: ai, multi-agent, collaboration, framework, crewai, langchain

4. **Create Release**
   - Go to Releases
   - Create new release v1.0.0
   - Copy README.md content as description

### Project Structure

```
{repo_name}/
├── README.md                    # Project documentation
├── LICENSE                      # MIT License
├── requirements.txt             # Python dependencies
├── setup.py                     # Package installation
├── .gitignore                   # Git ignore rules
├── src/
│   ├── __init__.py
│   ├── ai_collaboration_framework.py
│   └── advanced_ai_collaboration_system.py
├── examples/
│   └── basic_usage.py
├── tests/
│   └── (test files)
└── docs/
    ├── API_REFERENCE.md
    ├── BEST_PRACTICES.md
    └── EXTENDING.md
```

### Next Steps

1. ✅ Complete GitHub setup (see instructions above)
2. 📝 Customize README.md with your information
3. 🧪 Add unit tests in tests/
4. 🔄 Set up GitHub Actions for CI/CD
5. 📊 Add code coverage badges
6. 🌟 Share with the community!

---

For more information, see the documentation in the docs/ directory.
"""
    
    instructions_file = Path(project_path) / "GITHUB_INSTRUCTIONS.md"
    instructions_file.write_text(instructions)
    print(f"📄 Created GITHUB_INSTRUCTIONS.md")


def main():
    """Main function."""
    import sys
    
    if len(sys.argv) < 2:
        print("Usage: python publish_to_github.py <project_path> [github_username] [repo_name]")
        print("Example: python publish_to_github.py /home/ubuntu/my-framework coderyjq ai-collaboration-framework")
        sys.exit(1)
    
    project_path = sys.argv[1]
    github_username = sys.argv[2] if len(sys.argv) > 2 else "yourusername"
    repo_name = sys.argv[3] if len(sys.argv) > 3 else "ai-collaboration-framework"
    
    print("=" * 60)
    print("🚀 AI Collaboration Framework - GitHub Publisher")
    print("=" * 60)
    print(f"Project: {project_path}")
    print(f"GitHub: {github_username}/{repo_name}")
    print()
    
    # Initialize git
    if not init_git_repo(project_path):
        sys.exit(1)
    
    # Add and commit
    if not add_and_commit(project_path):
        sys.exit(1)
    
    # Rename branch
    rename_branch(project_path)
    
    # Create instructions
    github_url = f"https://github.com/{github_username}/{repo_name}.git"
    create_github_instructions(project_path, github_username, repo_name)
    
    print()
    print("=" * 60)
    print("✅ Framework prepared for GitHub!")
    print("=" * 60)
    print()
    print("📋 Next steps:")
    print(f"1. Create repository at: https://github.com/new")
    print(f"2. Run: cd {project_path}")
    print(f"3. Run: git remote add origin {github_url}")
    print(f"4. Run: git push -u origin main")
    print()
    print("📄 See GITHUB_INSTRUCTIONS.md for detailed setup")


if __name__ == "__main__":
    main()