GitFlowPro

🚀 GitFlowPro

The Ultimate Enterprise-Grade GitHub Automation & Intelligence Toolkit

GitFlowPro is a high-performance, security-first automation suite built in Go. It is designed to transform complex multi-repository environments into streamlined, self-managing, and intelligent workspaces. Whether you are managing a single project or an entire organization, GitFlowPro provides the tools you need to ensure code quality, security compliance, and developer productivity.

---

📖 Table of Contents

1. Core Features
2. Architecture Overview
3. Multi-Repo Management
4. AI-Powered Intelligence
5. Security & Compliance
6. Installation & Setup
7. CLI Usage
8. Workflow Automation
9. Project Structure
10. Contributing
11. License

---

🛠️ Core Features

1. 🤖 AI-Powered Intelligence

• AI Commit Generator: Instantly generate semantic, descriptive commit messages based on your staged changes.
• AI PR Reviewer (RepoPilot): Automatically summarizes PRs, flags security/performance risks, and assigns risk-based labels (risk:low, risk:medium, risk:high).
• AI Test Generator: Automatically generates pytest or Jest unit tests for PR changes and opens a specialized test PR for your review.

2. ⚡ Automation & Workflow

• Smart Labeler: Automatically categorizes PRs and Issues based on deep file path analysis and content inspection.
• PR Size Labeler: Flags large PRs to encourage smaller, more reviewable atomic changes.
• Stale Cleanup: Automatically manages inactive issues and PRs to keep your backlog clean and relevant.
• Semantic Release: Automated versioning and changelog generation following the Semantic Versioning (SemVer) standard.

3. 🛡️ Security & Compliance

• CodeQL Scanning: Real-time static analysis to detect common vulnerabilities and code smells.
• Secret Protection: Integrated gitleaks scanning to prevent sensitive credentials from ever entering your history.
• Principle of Least Privilege: All GitHub Actions are hardened with strictly scoped permissions.
• CODEOWNERS Integration: Ensures that every change is reviewed by the right person automatically.

4. 📊 Analytics & Reporting

• Multi-Repo Pulse: Generate aggregated reports across multiple repositories to track team velocity and repository health.
• Discord/Slack Integration: Automated delivery of weekly reports to your preferred communication channels.

---

🏗️ Architecture Overview

GitFlowPro is built on a hybrid architecture that combines the performance of a compiled Go CLI with the flexibility of GitHub Actions and Python scripts.

• Go CLI (cmd/gitflow): Handles heavy-duty data processing, multi-repo aggregation, and local developer tools (like the commit generator).
• GitHub Actions: Serves as the orchestration layer, triggering automation events based on repository state changes.
• Python Scripts: Used for lightweight API integrations and specialized reporting logic where rapid iteration is key.

---

🌐 Multi-Repo Management

GitFlowPro is uniquely designed to handle multiple repositories from a single installation. You can configure the toolkit to track several projects simultaneously.

How to Configure Multi-Repo

1. Environment Variable: Set REPO_NAME for single-repo focus.
2. Config File: Edit configs/repos.json to list all repositories you want to track:

   {
     "repos": [
       "your-org/backend-api",
       "your-org/frontend-app",
       "your-org/shared-utils"
     ]
   }
   

3. Aggregation: Running ./gitflow report will now iterate through all listed repos and provide a consolidated status.

---

🤖 AI Configuration

The AI features require an OpenAI API Key.

1. Local Usage: Add OPENAI_API_KEY to your local environment.
2. GitHub Actions: Add OPENAI_API_KEY to your GitHub Repository Secrets.

---

🛡️ Security & Compliance

We prioritize the safety of your code. GitFlowPro includes:

• Vulnerability Scanning: Automated CodeQL scans for Go, Python, and JavaScript.
• Credential Leak Prevention: Immediate detection of secrets in PRs.
• Hardened Permissions: Workflows run with the minimum contents: read permissions required.

For more details, see our SECURITY.md.

---

🚀 Installation & Setup

Prerequisites

• Go 1.21+
• Python 3.11+
• GitHub Personal Access Token (PAT) with repo and workflow scopes.

Quick Start

# 1. Clone the repo
git clone https://github.com/Raphasha27/GitFlowPro.git

# 2. Build the CLI
go build -o gitflow.exe ./cmd/gitflow

# 3. Initialize Git
git init

# 4. Set Environment Variables
$env:GH_TOKEN="your_token"
$env:REPO_NAME="Raphasha27/GitFlowPro"

---

💻 CLI Usage

The gitflow CLI is the Swiss Army knife for your development workflow.

• ./gitflow commit: Generate an AI commit message for staged changes.
• ./gitflow report: Generate a status report for all configured repositories.
• ./gitflow analytics: Run deep performance analytics.
• ./gitflow help: Display help information.

---

📂 Project Structure

GitFlowPro/
├── .github/
│   ├── ISSUE_TEMPLATE/     # Standardized Bug & Feature templates
│   ├── workflows/          # CI/CD & Automation pipelines
│   ├── CODEOWNERS          # Reviewer assignment rules
│   └── SECURITY.md         # Security policy & reporting
├── cmd/gitflow/            # Go CLI Source (Core logic)
├── configs/                # Automation & Multi-repo configurations
├── scripts/                # Python-based automation utilities
├── docs/                   # Extended documentation
├── go.mod                  # Go module definition
├── package.json            # Semantic release configuration
└── README.md               # You are here

---

🤝 Contributing

We love our contributors! Whether you are fixing a bug, adding a feature, or improving documentation, your help is welcome.

1. Read our Contributing Guide.
2. Follow our Code of Conduct.
3. Check the Open Issues.

---

❤️ Community & Support

• Issues: For bug reports and feature requests.
• Discussions: For general questions and community sharing.
• Security: Please report vulnerabilities via the Security Policy.

---

Built with ❤️ for the Developer Community by GitFlowPro Contributors

---

📊 Governance Dashboard (GitHub Pages)

GitFlowPro Governance Engine v3 automatically generates an organization-level governance dashboard.

The dashboard includes:

• Repo governance scores
• Risk distribution heatmap
• Security alert counts
• Required approval policy per risk category

Dashboard Publishing

The workflow publishes the dashboard to the gh-pages branch.

Enable GitHub Pages:

• Settings → Pages
• Source: gh-pages
• Folder: / (root)

Once enabled, your dashboard will be accessible publicly.

---

---

🐍 Part of the Raphasha27 Ecosystem

 

Product Ladder

GitHub (this repo)
    ↓
Portfolio → https://raphasha27.github.io/raphasha-dev-portfolio
    ↓
Case Study → (coming soon)
    ↓
Live Demo → https://github.com/Raphasha27/GitFlowPro
    ↓
Contact → https://github.com/Raphasha27

Part of the Kirov Dynamics ecosystem.

Built by Koketso Raphasha — Practical AI for Africa

Contributors

Built and maintained by the Kirov Dynamics team:

• Raphasha27 — Project lead & maintainer
• KirovDynamicsTechnology — Kirov Dynamics (company group)
• DkMash — Teammate & co-developer
• LindiweMotaung — Collaborator

We build together — credit goes to the whole team, not one person.

This site is open source. Improve this page.