@andrebuzeli/git-mcp 10.0.9 → 11.0.0

package/dist/resources/toolsGuide.js

@@ -1,1713 +0,0 @@
-/**
- * Git-MCP Tools Guide Resource
- * Comprehensive documentation for all 20 Git tools available in the MCP server
- */
-export const TOOLS_GUIDE = {
-    uri: "git-mcp://tools/guide",
-    name: "Git-MCP Tools Complete Guide",
-    description: "Detailed documentation and usage instructions for all 20 Git tools with 102 actions",
-    mimeType: "text/markdown",
-    content: `# 🛠️ Git-MCP v7.0.2 - Complete Tools Guide
-
-> **Comprehensive documentation for all 21 Git tools with 110+ actions**
-> **Supports:** Automatic DUAL execution on GitHub + Gitea APIs
-> **v7.0.2:** Central projectPath validation - ALL tools require projectPath (no exceptions)
-
----
-
-## 🚨 CRITICAL: projectPath is MANDATORY for ALL TOOLS
-
-**EVERY SINGLE TOOL CALL REQUIRES projectPath AS THE FIRST PARAMETER**
-
-### Why projectPath is Required:
-- ✅ It's where the .git folder is located
-- ✅ ALL Git commands run in this directory
-- ✅ Local AND remote operations use this context
-- ✅ It MUST be the absolute path to project ROOT
-- ✅ The server validates this BEFORE calling any tool
-
-### Validation:
-If you call ANY tool without projectPath, you will get:
-\\\`\\\`\\\`json
-{
-  "errorCode": "VALIDATION_ERROR",
-  "message": "projectPath is required for all tool calls"
-}
-\\\`\\\`\\\`
-
----
-
-## 🚀 v7.0.0 MAJOR UPDATE: AUTOMATIC DUAL EXECUTION
-
-**ALL TOOLS NOW:**
-- ✅ Execute on BOTH GitHub and Gitea APIs automatically
-- ✅ Use GITHUB_USERNAME and GITEA_USERNAME from environment variables
-- ✅ Return separated responses: { github: {...}, gitea: {...} }
-- ✅ NO manual owner/user/author parameters needed
-- ✅ Each provider uses its own credentials automatically
-
-### Environment Variables Required:
-\\\`\\\`\\\`bash
-GITHUB_TOKEN=your_github_token
-GITHUB_USERNAME=YourGitHubUsername
-GITEA_TOKEN=your_gitea_token
-GITEA_USERNAME=yourGiteaUsername
-GITEA_URL=http://your-gitea-server:port
-\\\`\\\`\\\`
-
----
-
-## ⚠️ projectPath Requirements (MANDATORY - NO EXCEPTIONS)
-
-**RULE: projectPath MUST be provided in EVERY tool call**
-
-### ✅ Correct Usage:
-\\\`\\\`\\\`javascript
-{
-  "projectPath": "Z:/absolute/path/to/project-root",  // ← MANDATORY FIRST PARAMETER
-  "action": "stats"
-  // projectPath must be absolute path to project ROOT folder
-  // NOT a subfolder, NOT a file, NOT a parent folder
-}
-\\\`\\\`\\\`
-
-### ❌ WRONG Usage:
-\\\`\\\`\\\`javascript
-// ❌ Missing projectPath (will be rejected by server)
-{
-  "action": "stats"
-}
-
-// ❌ Relative path
-"projectPath": "./my-project"
-
-// ❌ Subfolder instead of root
-"projectPath": "/project-root/src"
-
-// ❌ Parent folder
-"projectPath": "/path/to/workspace"
-
-// ❌ File path
-"projectPath": "/project/package.json"
-\\\`\\\`\\\`
-
-### 📋 Rules:
-**projectPath MUST be:**
-- ✅ **MANDATORY** - Cannot be omitted (server will reject)
-- ✅ Absolute path (starts with / or drive letter)
-- ✅ Points to the ROOT folder of the opened project
-- ✅ Where the .git folder is located
-- ✅ The working directory for ALL Git operations
-- ✅ The same folder you opened in your IDE
-- ✅ Contains .git folder (for Git operations)
-
----
-
-## 📚 Table of Contents
-
-1. [Quick Start](#quick-start)
-2. [Provider Types](#provider-types)
-3. [Core Workflow Tools](#core-workflow-tools)
-4. [Migration Tools (NEW)](#migration-tools)
-5. [Remote Management Tools](#remote-management-tools)
-6. [Issue & Pull Request Tools](#issue--pull-request-tools)
-7. [Release & Package Tools](#release--package-tools)
-8. [Branch & Tag Tools](#branch--tag-tools)
-9. [Configuration & Monitoring Tools](#configuration--monitoring-tools)
-10. [Advanced Tools](#advanced-tools)
-11. [Best Practices](#best-practices)
-
----
-
-## 🚀 Quick Start
-
-### Installation
-\`\`\`bash
-npm install @andrebuzeli/git-mcp
-\`\`\`
-
-### Configuration (mcp.json or .env)
-\`\`\`json
-{
-  "GITHUB_TOKEN": "ghp_your_token_here",
-  "GITHUB_USERNAME": "Your-GitHub-Username",
-  "GITEA_URL": "https://your-gitea.com",
-  "GITEA_TOKEN": "your_gitea_token",
-  "GITEA_USERNAME": "your-gitea-username"
-}
-\`\`\`
-
-### Basic Usage
-\`\`\`javascript
-// Call any tool via MCP protocol
-{
-  "tool": "git-workflow",
-  "params": {
-    "action": "status",
-    "projectPath": "/path/to/project"
-  }
-}
-\`\`\`
-
----
-
-## 🔧 Provider Types
-
-### LOCAL (10 tools)
-- **Scope:** Local Git operations only
-- **Requirements:** None (works offline)
-- **Examples:** git-config, git-stash, git-reset
-
-### DUAL (7 tools)
-- **Scope:** Automatic execution on BOTH GitHub AND Gitea
-- **Requirements:** Both providers configured
-- **Examples:** git-upload, git-issues, git-pulls
-- **Behavior:** Executes operation on both providers simultaneously
-
-### HYBRID (3 tools)
-- **Scope:** Local + optional remote operations
-- **Requirements:** Depends on action
-- **Examples:** git-workflow, git-sync, git-branches
-
----
-
-## 🔄 Core Workflow Tools
-
-### 1. **git-workflow** (HYBRID)
-**Description:** Core Git operations including init, status, commit, sync, backup, and remote repository management
-
-**Type:** HYBRID - Local operations + Remote operations (GitHub/Gitea)
-
-**projectPath:** ⚠️ REQUIRED - Absolute path to project ROOT folder (where you opened the project in IDE)
-
-**Actions:**
-- \`init\` - Initialize new repository
-- \`status\` - Check repository status
-- \`commit\` - Commit changes
-- \`sync\` - Sync with remote
-- \`backup\` - Create backup
-- \`create\` - Create remote repository
-- \`list\` - List repositories
-- \`get\` - Get repository details
-- \`update\` - Update repository
-- \`delete\` - Delete repository
-- \`fork\` - Fork repository
-- \`search\` - Search repositories
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Check repository status
-{
-  "tool": "git-workflow",
-  "params": {
-    "action": "status",
-    "projectPath": "/path/to/project"
-  }
-}
-
-// 2. Create repository on GitHub
-{
-  "tool": "git-workflow",
-  "params": {
-    "action": "create",
-    "projectPath": "/path/to/project",
-    "name": "my-new-repo",
-    "description": "My awesome project",
-    "private": true,
-    "provider": "github"
-  }
-}
-
-// 3. Get repository details from Gitea
-{
-  "tool": "git-workflow",
-  "params": {
-    "action": "get",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "owner": "username",
-    "provider": "gitea"
-  }
-}
-
-// 4. Sync with remote
-{
-  "tool": "git-workflow",
-  "params": {
-    "action": "sync",
-    "projectPath": "/path/to/project",
-    "remote": "origin",
-    "branch": "main"
-  }
-}
-\`\`\`
-
----
-
-### 2. **git-upload** (DUAL)
-**Description:** Upload complete project to BOTH GitHub AND Gitea automatically with full traceability
-
-**Type:** DUAL - Executes on BOTH providers simultaneously
-
-**Features:**
-- Automatic repository creation on both providers
-- Full commit history tracking
-- Automatic remote configuration
-- Traceability logs
-
-**Parameters:**
-- \`projectPath\` (required) - Path to project
-- \`name\` (optional) - Repository name (defaults to folder name)
-- \`description\` (optional) - Repository description
-- \`private\` (optional) - Make repository private (default: true)
-- \`branch\` (optional) - Branch name (default: master)
-- \`commitMessage\` (optional) - Custom commit message
-- \`force\` (optional) - Force overwrite if exists
-
-**Example:**
-
-\`\`\`javascript
-{
-  "tool": "git-upload",
-  "params": {
-    "projectPath": "/path/to/project",
-    "name": "my-project",
-    "description": "My awesome project",
-    "private": true,
-    "force": false
-  }
-}
-
-// Result: Creates repositories on:
-// - GitHub: github.com/Your-Username/my-project
-// - Gitea: your-gitea.com/your-username/my-project
-\`\`\`
-
----
-
-### 3. **git-update** (DUAL)
-**Description:** Complete update workflow (add, commit, push) to BOTH GitHub AND Gitea with full traceability
-
-**Type:** DUAL - Executes on BOTH providers simultaneously
-
-**Features:**
-- Automatic staging of changes
-- Smart commit with traceability
-- Push to both providers
-- Detailed change logs
-
-**Parameters:**
-- \`projectPath\` (required) - Path to project
-- \`message\` (required) - Commit message
-- \`files\` (optional) - Specific files to update (default: all changes)
-- \`push\` (optional) - Push to remote (default: true)
-- \`remote\` (optional) - Remote name (default: origin)
-- \`branch\` (optional) - Branch name (default: current)
-
-**Example:**
-
-\`\`\`javascript
-{
-  "tool": "git-update",
-  "params": {
-    "projectPath": "/path/to/project",
-    "message": "feat: add new feature X",
-    "push": true
-  }
-}
-
-// Result: 
-// 1. Stages all changes
-// 2. Creates commit with message
-// 3. Pushes to GitHub and Gitea simultaneously
-\`\`\`
-
----
-
-### 4. **git-history** (DUAL)
-**Description:** Maintain detailed history of all project changes with remote tracking via issues
-
-**Type:** DUAL - Creates tracking issues on BOTH providers
-
-**Actions:**
-- \`track\` - Track changes and create issue
-- \`sync\` - Sync history to remote trackers
-- \`list\` - List tracked changes
-- \`get\` - Get specific change details
-
-**Features:**
-- Automatic issue creation for changes
-- Cross-reference between commits and issues
-- Timeline of all changes
-- Remote backup via issue system
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Track changes and create issues
-{
-  "tool": "git-history",
-  "params": {
-    "action": "track",
-    "projectPath": "/path/to/project",
-    "message": "Implemented authentication system",
-    "labels": ["feature", "backend"]
-  }
-}
-
-// 2. Sync history to remote
-{
-  "tool": "git-history",
-  "params": {
-    "action": "sync",
-    "projectPath": "/path/to/project"
-  }
-}
-
-// 3. List all tracked changes
-{
-  "tool": "git-history",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "limit": 50
-  }
-}
-\`\`\`
-
----
-
-## 🔧 Migration Tools (NEW in v6.3.1)
-
-### 21. **git-fix** (LOCAL)
-**Description:** Fix local Git repositories to work with dual-provider system (GitHub + Gitea)
-
-**Type:** LOCAL - Converts existing repos to dual-provider configuration
-
-**projectPath:** ⚠️ REQUIRED - Absolute path to project ROOT folder that needs fixing
-
-**Features:**
-- 🔍 **Auto-detection:** Automatically detects repository name from existing remotes
-- ✅ **Username correction:** Uses correct usernames from GITHUB_USERNAME and GITEA_USERNAME env vars
-- 🗑️ **Clean setup:** Removes old remotes and creates standardized configuration
-- 🔄 **Dual-push:** Configures origin to push to both GitHub and Gitea simultaneously
-- 📝 **Preserves history:** Keeps all commits and Git history intact
-- ⚙️ **.gitignore creation:** Creates standard .gitignore if missing
-
-**Parameters:**
-- \\\`projectPath\\\` (required) - Absolute path to Git repository ROOT folder
-- \\\`autoDetect\\\` (optional) - Auto-detect repo name from remotes (default: true)
-- \\\`githubRepo\\\` (optional) - GitHub repo in format "owner/repo" (auto-detected if not provided)
-- \\\`giteaRepo\\\` (optional) - Gitea repo in format "owner/repo" (auto-detected if not provided)
-
-**Requirements:**
-- \\\`GITHUB_USERNAME\\\` env var (REQUIRED)
-- \\\`GITEA_USERNAME\\\` env var (REQUIRED)
-- \\\`GITEA_URL\\\` env var (default: http://localhost:3000)
-
-**When to use:**
-- ✅ Existing Git repo NOT configured for dual-provider
-- ✅ Migrating from single remote (GitHub OR Gitea) to dual-push
-- ✅ Fixing incorrect username configuration
-- ✅ Standardizing repository configuration across projects
-
-**What it does:**
-1. ✅ Verifies/initializes Git repository
-2. 🔍 Captures current remotes (before state)
-3. 🔍 Auto-detects repository name from existing URLs
-4. 🗑️ Removes old remotes (origin, github, gitea)
-5. ➕ Adds new 'github' remote with correct username
-6. ➕ Adds new 'gitea' remote with correct username
-7. ⚙️ Configures 'origin' for dual-push (GitHub + Gitea)
-8. 📝 Creates .gitignore if missing
-9. 📊 Shows before/after comparison
-
-**Examples:**
-
-\\\`\\\`\\\`javascript
-// 1. Auto-detect and fix repository
-{
-  "tool": "git-fix",
-  "params": {
-    "projectPath": "Z:/my-old-project",
-    "autoDetect": true
-  }
-}
-
-// Before:
-// origin → https://github.com/olduser/old-project.git
-
-// After:
-// github → https://github.com/Your-GitHub-Username/old-project.git
-// gitea  → http://nas-ubuntu:9999/your-gitea-username/old-project.git
-// origin → dual-push to both
-
-// 2. Manual repo specification
-{
-  "tool": "git-fix",
-  "params": {
-    "projectPath": "Z:/my-project",
-    "githubRepo": "Andre-Buzeli/my-project",
-    "giteaRepo": "andrebuzeli/my-project",
-    "autoDetect": false
-  }
-}
-
-// 3. Fix multiple projects (use sequentially)
-// Project 1
-{
-  "tool": "git-fix",
-  "params": {
-    "projectPath": "Z:/project-1",
-    "autoDetect": true
-  }
-}
-
-// Project 2
-{
-  "tool": "git-fix",
-  "params": {
-    "projectPath": "Z:/project-2",
-    "autoDetect": true
-  }
-}
-\\\`\\\`\\\`
-
-**Result Structure:**
-\\\`\\\`\\\`json
-{
-  "success": true,
-  "projectPath": "Z:/my-project",
-  "fixed": [
-    "✅ Repositório Git válido encontrado",
-    "🔍 Nome do repo auto-detectado: my-project",
-    "✅ GitHub repo: Andre-Buzeli/my-project",
-    "✅ Gitea repo: andrebuzeli/my-project",
-    "🗑️  Removido remote antigo: origin",
-    "✅ Adicionado remote GitHub: https://github.com/Andre-Buzeli/my-project.git",
-    "✅ Adicionado remote Gitea: http://nas-ubuntu:9999/andrebuzeli/my-project.git",
-    "✅ Configurado origin para push dual (GitHub + Gitea)",
-    "✅ Histórico de commits preservado",
-    "✅ Criado .gitignore padrão"
-  ],
-  "warnings": [],
-  "errors": [],
-  "remotes": {
-    "before": [...],
-    "after": [...]
-  }
-}
-\\\`\\\`\\\`
-
-**⚠️ Important Notes:**
-- Always backup your repository before running git-fix
-- Requires valid GITHUB_USERNAME and GITEA_USERNAME env vars
-- Repository name detection works with github.com and Gitea URLs
-- Falls back to folder name if no remote detected
-- Does NOT push to remotes (only configures them)
-- Safe to run multiple times (idempotent)
-
----
-
-## 🌐 Remote Management Tools
-
-### 5. **git-remote** (LOCAL)
-**Description:** Manage remote repository connections
-
-**Type:** LOCAL - Manages local Git remotes
-
-**Actions:**
-- \`add\` - Add new remote
-- \`remove\` - Remove remote
-- \`rename\` - Rename remote
-- \`show\` - Show remote details
-- \`set-url\` - Change remote URL
-- \`prune\` - Remove stale references
-- \`list\` - List all remotes
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Add remote
-{
-  "tool": "git-remote",
-  "params": {
-    "action": "add",
-    "projectPath": "/path/to/project",
-    "name": "upstream",
-    "url": "https://github.com/original/repo.git"
-  }
-}
-
-// 2. List remotes with URLs
-{
-  "tool": "git-remote",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "verbose": true
-  }
-}
-
-// 3. Change remote URL
-{
-  "tool": "git-remote",
-  "params": {
-    "action": "set-url",
-    "projectPath": "/path/to/project",
-    "name": "origin",
-    "url": "git@github.com:user/repo.git"
-  }
-}
-\`\`\`
-
----
-
-### 6. **git-sync** (HYBRID)
-**Description:** Advanced repository synchronization with conflict resolution
-
-**Type:** HYBRID - Local sync + Remote provider sync
-
-**Actions:**
-- \`sync\` - Synchronize repository
-- \`status\` - Check sync status
-
-**Features:**
-- Pull from remote
-- Push to remote
-- Conflict detection
-- Merge strategies (merge, rebase, fast-forward)
-- Ahead/behind commit tracking
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Sync with merge strategy
-{
-  "tool": "git-sync",
-  "params": {
-    "action": "sync",
-    "projectPath": "/path/to/project",
-    "remote": "origin",
-    "branch": "main",
-    "strategy": "merge"
-  }
-}
-
-// 2. Check sync status
-{
-  "tool": "git-sync",
-  "params": {
-    "action": "status",
-    "projectPath": "/path/to/project",
-    "detailed": true,
-    "checkAhead": true,
-    "includeRemote": true
-  }
-}
-
-// 3. Force sync (careful!)
-{
-  "tool": "git-sync",
-  "params": {
-    "action": "sync",
-    "projectPath": "/path/to/project",
-    "force": true,
-    "dryRun": false
-  }
-}
-\`\`\`
-
----
-
-## 🐛 Issue & Pull Request Tools
-
-### 7. **git-issues** (DUAL)
-**Description:** Complete issue management for BOTH GitHub AND Gitea
-
-**Type:** DUAL - Executes on BOTH providers simultaneously
-
-**Actions:**
-- \`create\` - Create new issue
-- \`list\` - List issues
-- \`get\` - Get issue details
-- \`update\` - Update issue
-- \`close\` - Close issue
-- \`comment\` - Add comment
-- \`search\` - Search issues
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Create issue on both providers
-{
-  "tool": "git-issues",
-  "params": {
-    "action": "create",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "title": "Bug: Login not working",
-    "body": "Description of the bug...",
-    "labels": ["bug", "urgent"],
-    "assignees": ["developer1"]
-  }
-}
-// Creates issue #X on GitHub AND Gitea simultaneously
-
-// 2. List open issues
-{
-  "tool": "git-issues",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "state_filter": "open",
-    "sort": "created",
-    "direction": "desc"
-  }
-}
-
-// 3. Update issue
-{
-  "tool": "git-issues",
-  "params": {
-    "action": "update",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "issue_number": 42,
-    "title": "Bug: Login fixed",
-    "state": "closed"
-  }
-}
-
-// 4. Add comment
-{
-  "tool": "git-issues",
-  "params": {
-    "action": "comment",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "issue_number": 42,
-    "comment_body": "Fixed in commit abc123"
-  }
-}
-
-// 5. Search issues
-{
-  "tool": "git-issues",
-  "params": {
-    "action": "search",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "query": "bug authentication",
-    "search_sort": "updated"
-  }
-}
-\`\`\`
-
----
-
-### 8. **git-pulls** (DUAL)
-**Description:** Pull request management for BOTH GitHub AND Gitea
-
-**Type:** DUAL - Executes on BOTH providers simultaneously
-
-**Actions:**
-- \`create\` - Create pull request
-- \`list\` - List pull requests
-- \`get\` - Get PR details
-- \`update\` - Update pull request
-- \`merge\` - Merge pull request
-- \`close\` - Close pull request
-- \`review\` - Review pull request
-- \`search\` - Search pull requests
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Create pull request on both providers
-{
-  "tool": "git-pulls",
-  "params": {
-    "action": "create",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "title": "Feature: Add user authentication",
-    "body": "Implements JWT authentication...",
-    "head": "feature/auth",
-    "base": "main"
-  }
-}
-
-// 2. List pull requests
-{
-  "tool": "git-pulls",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "state_filter": "open",
-    "sort": "created"
-  }
-}
-
-// 3. Review pull request
-{
-  "tool": "git-pulls",
-  "params": {
-    "action": "review",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "pull_number": 15,
-    "event": "APPROVE",
-    "review_body": "LGTM! Great work!"
-  }
-}
-
-// 4. Merge pull request
-{
-  "tool": "git-pulls",
-  "params": {
-    "action": "merge",
-    "projectPath": "/path/to/project",
-    "repo": "my-repo",
-    "pull_number": 15,
-    "merge_method": "squash",
-    "commit_title": "feat: add authentication",
-    "commit_message": "Squashed commits from PR #15"
-  }
-}
-\`\`\`
-
----
-
-## 🚀 Release & Package Tools
-
-### 9. **git-release** (DUAL)
-**Description:** Release management for BOTH GitHub AND Gitea
-
-**Type:** DUAL - Executes on BOTH providers simultaneously
-
-**Actions:**
-- \`create\` - Create release
-- \`list\` - List releases
-- \`get\` - Get release details
-- \`update\` - Update release
-- \`delete\` - Delete release
-- \`publish\` - Publish draft release
-- \`download\` - Download release assets
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Create release on both providers
-{
-  "tool": "git-release",
-  "params": {
-    "action": "create",
-    "projectPath": "/path/to/project",
-    "tagName": "v1.0.0",
-    "releaseName": "Version 1.0.0",
-    "description": "First stable release",
-    "draft": false,
-    "prerelease": false,
-    "generateNotes": true,
-    "assets": ["/path/to/binary.zip"]
-  }
-}
-
-// 2. List all releases
-{
-  "tool": "git-release",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "includeDrafts": true,
-    "includePrerelease": true,
-    "limit": 10
-  }
-}
-
-// 3. Get specific release
-{
-  "tool": "git-release",
-  "params": {
-    "action": "get",
-    "projectPath": "/path/to/project",
-    "tagName": "v1.0.0"
-  }
-}
-
-// 4. Update release
-{
-  "tool": "git-release",
-  "params": {
-    "action": "update",
-    "projectPath": "/path/to/project",
-    "tagName": "v1.0.0",
-    "description": "Updated release notes",
-    "draft": false
-  }
-}
-
-// 5. Delete release
-{
-  "tool": "git-release",
-  "params": {
-    "action": "delete",
-    "projectPath": "/path/to/project",
-    "tagName": "v1.0.0-beta",
-    "force": true
-  }
-}
-\`\`\`
-
----
-
-### 10. **git-packages** (HYBRID)
-**Description:** Package management operations
-
-**Type:** HYBRID - Local packages + Remote operations (GitHub/Gitea)
-
-**Actions:**
-- \`list\` - List packages
-- \`get\` - Get package details
-- \`create\` - Create package
-- \`update\` - Update package
-- \`delete\` - Delete package
-- \`publish\` - Publish package
-- \`download\` - Download package
-
-**Examples:**
-
-\`\`\`javascript
-// 1. List packages
-{
-  "tool": "git-packages",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "packageType": "npm",
-    "provider": "github"
-  }
-}
-
-// 2. Get package details
-{
-  "tool": "git-packages",
-  "params": {
-    "action": "get",
-    "projectPath": "/path/to/project",
-    "packageName": "my-package",
-    "version": "1.0.0",
-    "provider": "github"
-  }
-}
-
-// 3. Publish package
-{
-  "tool": "git-packages",
-  "params": {
-    "action": "publish",
-    "projectPath": "/path/to/project",
-    "packageName": "my-package",
-    "version": "1.0.0",
-    "provider": "github",
-    "registry": "npm"
-  }
-}
-\`\`\`
-
----
-
-## 🌿 Branch & Tag Tools
-
-### 11. **git-branches** (HYBRID)
-**Description:** Branch management operations
-
-**Type:** HYBRID - Local branches + Remote operations (GitHub/Gitea)
-
-**Actions:**
-- \`create\` - Create branch
-- \`list\` - List branches
-- \`get\` - Get branch details
-- \`delete\` - Delete branch
-- \`merge\` - Merge branches
-- \`compare\` - Compare branches
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Create new branch
-{
-  "tool": "git-branches",
-  "params": {
-    "action": "create",
-    "projectPath": "/path/to/project",
-    "branchName": "feature/new-feature",
-    "sourceBranch": "main",
-    "checkout": true
-  }
-}
-
-// 2. List all branches
-{
-  "tool": "git-branches",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "remote": "origin"
-  }
-}
-
-// 3. Compare branches
-{
-  "tool": "git-branches",
-  "params": {
-    "action": "compare",
-    "projectPath": "/path/to/project",
-    "baseBranch": "main",
-    "compareBranch": "feature/new-feature"
-  }
-}
-
-// 4. Delete branch
-{
-  "tool": "git-branches",
-  "params": {
-    "action": "delete",
-    "projectPath": "/path/to/project",
-    "branchName": "old-feature",
-    "force": false
-  }
-}
-\`\`\`
-
----
-
-### 12. **git-tags** (HYBRID)
-**Description:** Tag management operations
-
-**Type:** HYBRID - Local tags + Remote operations (GitHub/Gitea)
-
-**Actions:**
-- \`create\` - Create tag
-- \`list\` - List tags
-- \`get\` - Get tag details
-- \`delete\` - Delete tag
-- \`search\` - Search tags
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Create annotated tag
-{
-  "tool": "git-tags",
-  "params": {
-    "action": "create",
-    "projectPath": "/path/to/project",
-    "tagName": "v1.0.0",
-    "message": "Version 1.0.0 release",
-    "annotated": true,
-    "commit": "HEAD"
-  }
-}
-
-// 2. List all tags
-{
-  "tool": "git-tags",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "pattern": "v*"
-  }
-}
-
-// 3. Get tag details
-{
-  "tool": "git-tags",
-  "params": {
-    "action": "get",
-    "projectPath": "/path/to/project",
-    "tagName": "v1.0.0"
-  }
-}
-
-// 4. Delete tag
-{
-  "tool": "git-tags",
-  "params": {
-    "action": "delete",
-    "projectPath": "/path/to/project",
-    "tagName": "v0.9.0-beta",
-    "force": true
-  }
-}
-\`\`\`
-
----
-
-## ⚙️ Configuration & Monitoring Tools
-
-### 13. **git-config** (LOCAL)
-**Description:** Git configuration management
-
-**Type:** LOCAL - Manages local Git configuration
-
-**Actions:**
-- \`get\` - Get configuration value
-- \`set\` - Set configuration value
-- \`unset\` - Remove configuration
-- \`list\` - List all configuration
-- \`edit\` - Open editor
-- \`show\` - Show configuration details
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Get user name
-{
-  "tool": "git-config",
-  "params": {
-    "action": "get",
-    "projectPath": "/path/to/project",
-    "key": "user.name",
-    "local": true
-  }
-}
-
-// 2. Set user email
-{
-  "tool": "git-config",
-  "params": {
-    "action": "set",
-    "projectPath": "/path/to/project",
-    "key": "user.email",
-    "value": "dev@example.com",
-    "global": false
-  }
-}
-
-// 3. List all configuration
-{
-  "tool": "git-config",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "showOrigin": true
-  }
-}
-
-// 4. Show specific config with scope
-{
-  "tool": "git-config",
-  "params": {
-    "action": "show",
-    "projectPath": "/path/to/project",
-    "key": "core.editor",
-    "showScope": true
-  }
-}
-\`\`\`
-
----
-
-### 14. **git-monitor** (LOCAL)
-**Description:** Repository monitoring and status operations
-
-**Type:** LOCAL - Monitors local repository
-
-**Actions:**
-- \`log\` - Show commit log
-- \`status\` - Check repository status
-- \`commits\` - Detailed commit history
-- \`contributors\` - Show contributors
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Show recent commits
-{
-  "tool": "git-monitor",
-  "params": {
-    "action": "log",
-    "projectPath": "/path/to/project",
-    "limit": 10,
-    "since": "1 week ago"
-  }
-}
-
-// 2. Detailed status
-{
-  "tool": "git-monitor",
-  "params": {
-    "action": "status",
-    "projectPath": "/path/to/project",
-    "detailed": true
-  }
-}
-
-// 3. Get commits with statistics
-{
-  "tool": "git-monitor",
-  "params": {
-    "action": "commits",
-    "projectPath": "/path/to/project",
-    "limit": 50,
-    "author": "john@example.com",
-    "includeStats": true,
-    "format": "full"
-  }
-}
-
-// 4. Show contributors
-{
-  "tool": "git-monitor",
-  "params": {
-    "action": "contributors",
-    "projectPath": "/path/to/project",
-    "sortBy": "commits",
-    "since": "2024-01-01"
-  }
-}
-\`\`\`
-
----
-
-### 15. **git-analytics** (LOCAL)
-**Description:** Repository analytics and statistics
-
-**Type:** LOCAL - Analyzes local repository
-
-**Actions:**
-- \`stats\` - Repository statistics
-- \`commits\` - Commit analysis
-- \`contributors\` - Contributor analysis
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Get repository statistics
-{
-  "tool": "git-analytics",
-  "params": {
-    "action": "stats",
-    "projectPath": "/path/to/project",
-    "branch": "main",
-    "includeFileTypes": true,
-    "groupBy": "month"
-  }
-}
-
-// 2. Analyze commits
-{
-  "tool": "git-analytics",
-  "params": {
-    "action": "commits",
-    "projectPath": "/path/to/project",
-    "since": "2024-01-01",
-    "until": "2024-12-31",
-    "author": "developer1",
-    "includeStats": true
-  }
-}
-
-// 3. Contributor analysis
-{
-  "tool": "git-analytics",
-  "params": {
-    "action": "contributors",
-    "projectPath": "/path/to/project",
-    "sortBy": "additions",
-    "minCommits": 5
-  }
-}
-\`\`\`
-
----
-
-## 🔐 Advanced Tools
-
-### 16. **git-stash** (LOCAL)
-**Description:** Stash management for temporary changes
-
-**Type:** LOCAL - Manages local stash
-
-**Actions:**
-- \`stash\` - Stash changes
-- \`pop\` - Apply and remove stash
-- \`apply\` - Apply stash
-- \`list\` - List stashes
-- \`show\` - Show stash contents
-- \`drop\` - Remove stash
-- \`clear\` - Clear all stashes
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Stash current changes
-{
-  "tool": "git-stash",
-  "params": {
-    "action": "stash",
-    "projectPath": "/path/to/project",
-    "message": "WIP: feature development",
-    "includeUntracked": true
-  }
-}
-
-// 2. List all stashes
-{
-  "tool": "git-stash",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "oneline": false
-  }
-}
-
-// 3. Apply stash
-{
-  "tool": "git-stash",
-  "params": {
-    "action": "apply",
-    "projectPath": "/path/to/project",
-    "stashRef": "stash@{0}",
-    "index": true
-  }
-}
-
-// 4. Pop latest stash
-{
-  "tool": "git-stash",
-  "params": {
-    "action": "pop",
-    "projectPath": "/path/to/project"
-  }
-}
-\`\`\`
-
----
-
-### 17. **git-reset** (LOCAL)
-**Description:** Reset repository state (USE WITH CAUTION)
-
-**Type:** LOCAL - Resets local repository
-
-**Actions:**
-- \`soft\` - Reset keeping changes staged
-- \`mixed\` - Reset keeping changes unstaged
-- \`hard\` - Reset discarding all changes
-- \`file\` - Reset specific file
-
-**⚠️ WARNING: Destructive operations! Use with extreme caution!**
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Soft reset (keeps changes staged)
-{
-  "tool": "git-reset",
-  "params": {
-    "action": "soft",
-    "projectPath": "/path/to/project",
-    "commit": "HEAD~1"
-  }
-}
-
-// 2. Mixed reset (keeps changes unstaged)
-{
-  "tool": "git-reset",
-  "params": {
-    "action": "mixed",
-    "projectPath": "/path/to/project",
-    "commit": "abc123"
-  }
-}
-
-// 3. Hard reset (DANGEROUS - discards everything!)
-{
-  "tool": "git-reset",
-  "params": {
-    "action": "hard",
-    "projectPath": "/path/to/project",
-    "commit": "HEAD",
-    "force": true
-  }
-}
-
-// 4. Reset specific file
-{
-  "tool": "git-reset",
-  "params": {
-    "action": "file",
-    "projectPath": "/path/to/project",
-    "file": "src/config.js",
-    "commit": "HEAD"
-  }
-}
-\`\`\`
-
----
-
-### 18. **git-backup** (LOCAL)
-**Description:** Repository backup and restore operations
-
-**Type:** LOCAL - Manages local backups
-
-**Actions:**
-- \`backup\` - Create backup
-- \`restore\` - Restore from backup
-- \`list\` - List backups
-- \`verify\` - Verify backup integrity
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Create backup
-{
-  "tool": "git-backup",
-  "params": {
-    "action": "backup",
-    "projectPath": "/path/to/project",
-    "backupPath": "/backups/project-backup.tar.gz",
-    "name": "pre-refactor-backup",
-    "compression": true,
-    "includeUntracked": false
-  }
-}
-
-// 2. List backups
-{
-  "tool": "git-backup",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "sortBy": "date"
-  }
-}
-
-// 3. Restore from backup
-{
-  "tool": "git-backup",
-  "params": {
-    "action": "restore",
-    "projectPath": "/path/to/project",
-    "backupPath": "/backups/project-backup.tar.gz",
-    "targetPath": "/restore/location",
-    "overwrite": false
-  }
-}
-
-// 4. Verify backup
-{
-  "tool": "git-backup",
-  "params": {
-    "action": "verify",
-    "projectPath": "/path/to/project",
-    "backupPath": "/backups/project-backup.tar.gz",
-    "checkIntegrity": true
-  }
-}
-\`\`\`
-
----
-
-### 19. **git-archive** (LOCAL)
-**Description:** Archive repository for distribution
-
-**Type:** LOCAL - Creates archives
-
-**Actions:**
-- \`create\` - Create archive
-- \`extract\` - Extract archive
-- \`list\` - List archive contents
-- \`verify\` - Verify archive
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Create archive
-{
-  "tool": "git-archive",
-  "params": {
-    "action": "create",
-    "projectPath": "/path/to/project",
-    "outputPath": "/archives/project-v1.0.0.zip",
-    "format": "zip",
-    "ref": "v1.0.0",
-    "prefix": "project-v1.0.0/",
-    "includeSubmodules": true
-  }
-}
-
-// 2. Extract archive
-{
-  "tool": "git-archive",
-  "params": {
-    "action": "extract",
-    "projectPath": "/path/to/project",
-    "archivePath": "/archives/project.zip",
-    "targetPath": "/extract/location",
-    "overwrite": false
-  }
-}
-
-// 3. List archive contents
-{
-  "tool": "git-archive",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "archivePath": "/archives/project.zip",
-    "showDetails": true
-  }
-}
-\`\`\`
-
----
-
-### 20. **git-files** (LOCAL)
-**Description:** Read-only file operations for repositories
-
-**Type:** LOCAL - File browsing
-
-**Actions:**
-- \`read\` - Read file
-- \`list\` - List files
-- \`search\` - Search files
-- \`backup\` - Backup files
-
-**Examples:**
-
-\`\`\`javascript
-// 1. Read file
-{
-  "tool": "git-files",
-  "params": {
-    "action": "read",
-    "projectPath": "/path/to/project",
-    "filePath": "src/index.js",
-    "encoding": "utf8"
-  }
-}
-
-// 2. List files
-{
-  "tool": "git-files",
-  "params": {
-    "action": "list",
-    "projectPath": "/path/to/project",
-    "filePattern": "*.js"
-  }
-}
-
-// 3. Search in files
-{
-  "tool": "git-files",
-  "params": {
-    "action": "search",
-    "projectPath": "/path/to/project",
-    "query": "function authenticate",
-    "filePattern": "*.js",
-    "caseSensitive": false
-  }
-}
-\`\`\`
-
----
-
-## 💡 Best Practices
-
-### 1. Provider Configuration
-\`\`\`javascript
-// ALWAYS configure providers properly
-// GitHub uses capitalized username: "Your-Username"
-// Gitea uses lowercase username: "your-username"
-
-// mcp.json or .env:
-{
-  "GITHUB_USERNAME": "Andre-Buzeli",  // Capitalized
-  "GITEA_USERNAME": "andrebuzeli"     // Lowercase
-}
-\`\`\`
-
-### 2. DUAL Tools Behavior
-\`\`\`javascript
-// DUAL tools execute on BOTH providers automatically
-// No need to specify provider parameter
-// Example: git-upload creates repos on GitHub AND Gitea
-
-{
-  "tool": "git-upload",
-  "params": {
-    "projectPath": "/project"
-    // No "provider" parameter needed!
-  }
-}
-// Result: Repos created on BOTH providers
-\`\`\`
-
-### 3. Error Handling
-\`\`\`javascript
-// Always check result.success
-const result = await callTool("git-workflow", params);
-if (result.success) {
-  console.log("Operation successful:", result.result);
-} else {
-  console.error("Operation failed:", result.error);
-}
-\`\`\`
-
-### 4. Path Requirements
-\`\`\`javascript
-// ALWAYS use absolute paths
-{
-  "projectPath": "/absolute/path/to/project"  // ✅ Correct
-  // "projectPath": "./relative/path"         // ❌ Wrong
-}
-\`\`\`
-
-### 5. Destructive Operations
-\`\`\`javascript
-// For destructive operations, always:
-// 1. Create backup first
-// 2. Use dryRun when available
-// 3. Verify force parameter
-
-// Example: Before hard reset
-{
-  "tool": "git-backup",
-  "params": {
-    "action": "backup",
-    "projectPath": "/path/to/project"
-  }
-}
-
-// Then reset
-{
-  "tool": "git-reset",
-  "params": {
-    "action": "hard",
-    "force": true  // Explicit confirmation
-  }
-}
-\`\`\`
-
-### 6. Rate Limiting
-\`\`\`javascript
-// GitHub/Gitea have rate limits
-// For bulk operations, add delays:
-
-for (const repo of repos) {
-  await callTool("git-workflow", { action: "get", repo });
-  await sleep(1000); // 1 second delay
-}
-\`\`\`
-
----
-
-## 📊 Tool Summary Table
-
-| Tool | Type | Actions | Primary Use Case |
-|------|------|---------|------------------|
-| git-workflow | HYBRID | 12 | Repository lifecycle & remote management |
-| git-upload | DUAL | 1 | Upload project to both providers |
-| git-update | DUAL | 1 | Update & push to both providers |
-| git-history | DUAL | 4 | Track changes via issues |
-| git-issues | DUAL | 7 | Issue management on both providers |
-| git-pulls | DUAL | 8 | PR management on both providers |
-| git-release | DUAL | 7 | Release management on both providers |
-| git-packages | HYBRID | 7 | Package management |
-| git-branches | HYBRID | 6 | Branch operations |
-| git-tags | HYBRID | 5 | Tag operations |
-| git-remote | LOCAL | 7 | Remote management |
-| git-sync | HYBRID | 2 | Repository synchronization |
-| git-config | LOCAL | 6 | Configuration management |
-| git-monitor | LOCAL | 4 | Repository monitoring |
-| git-analytics | LOCAL | 3 | Statistics & analysis |
-| git-stash | LOCAL | 7 | Temporary changes |
-| git-reset | LOCAL | 4 | Repository reset |
-| git-backup | LOCAL | 4 | Backup operations |
-| git-archive | LOCAL | 4 | Archive creation |
-| git-files | LOCAL | 4 | File operations |
-| **git-fix** | **LOCAL** | **1** | **Migrate repos to dual-provider (NEW v6.3.1)** |
-
-**Total: 21 tools, 110+ actions**
-
----
-
-## 🎯 Common Workflows
-
-### Workflow 1: New Project Setup
-\`\`\`javascript
-// 1. Initialize local repository
-{ "tool": "git-workflow", "params": { "action": "init", "projectPath": "/project" }}
-
-// 2. Upload to both providers
-{ "tool": "git-upload", "params": { "projectPath": "/project", "name": "my-project" }}
-
-// 3. Create first release
-{ "tool": "git-release", "params": { "action": "create", "tagName": "v1.0.0" }}
-\`\`\`
-
-### Workflow 2: Daily Development
-\`\`\`javascript
-// 1. Check status
-{ "tool": "git-monitor", "params": { "action": "status" }}
-
-// 2. Update & push changes
-{ "tool": "git-update", "params": { "message": "feat: new feature" }}
-
-// 3. Track in history
-{ "tool": "git-history", "params": { "action": "track" }}
-\`\`\`
-
-### Workflow 3: Release Management
-\`\`\`javascript
-// 1. Create release branch
-{ "tool": "git-branches", "params": { "action": "create", "branchName": "release/v2.0" }}
-
-// 2. Tag version
-{ "tool": "git-tags", "params": { "action": "create", "tagName": "v2.0.0" }}
-
-// 3. Create release
-{ "tool": "git-release", "params": { "action": "create", "tagName": "v2.0.0" }}
-\`\`\`
-
----
-
-## 🔍 Troubleshooting
-
-### Issue: Username case-sensitivity
-**Problem:** Gitea returns 404 errors
-**Solution:** Ensure GITEA_USERNAME is lowercase
-
-### Issue: Authentication failed
-**Problem:** 401 errors
-**Solution:** Verify tokens are valid and have correct permissions
-
-### Issue: Remote not found
-**Problem:** Remote operations fail
-**Solution:** Check remote configuration with git-remote list
-
-### Issue: Merge conflicts
-**Problem:** Sync fails with conflicts
-**Solution:** Use git-stash before syncing, then apply after
-
----
-
-## 📚 Additional Resources
-
-- **GitHub API:** https://docs.github.com/en/rest
-- **Gitea API:** https://docs.gitea.io/en-us/api-usage/
-- **Git Documentation:** https://git-scm.com/doc
-- **MCP Protocol:** https://modelcontextprotocol.io
-
----
-
-**Git-MCP v6.3.1** | Built with ❤️ for developers | 110+ Actions | 21 Tools | 3 Provider Types | NEW: git-fix migration tool
-`
-};
-export default TOOLS_GUIDE;