vibe-forge 0.4.0 → 0.8.1

package/docs/workflows/gitea.md

@@ -1,168 +0,0 @@
-# Gitea Workflow Guide
-
-Git workflow guidance for projects hosted on Gitea (including Codeberg and other Gitea-based instances).
-
-## Branch Naming
-
-```
-task/TASK-XXX-description     # Task branches
-feature/feature-name          # Feature branches
-bugfix/bug-description        # Bug fix branches
-hotfix/urgent-fix             # Urgent production fixes
-```
-
-## Daily Workflow
-
-### Starting a Task
-
-```bash
-# Ensure you're on latest main
-git checkout main && git pull origin main
-
-# Create feature branch
-git checkout -b task/TASK-XXX-description
-```
-
-### During Development
-
-```bash
-# Stage and commit changes
-git add .
-git commit -m "Add feature X"
-
-# Push to remote (first time)
-git push -u origin task/TASK-XXX-description
-
-# Subsequent pushes
-git push
-```
-
-### Creating a Pull Request
-
-```bash
-# Using tea CLI (Gitea's official CLI)
-tea pr create --title "TASK-XXX: Add feature X" --description "Description of changes"
-
-# Or create as draft
-tea pr create --title "TASK-XXX: WIP - Add feature X" --labels "work-in-progress"
-
-# If tea is not installed, use the web UI:
-# Navigate to your Gitea instance -> Repository -> Pull Requests -> New Pull Request
-```
-
-### After PR Approval
-
-```bash
-# Merge via Gitea UI (squash merge recommended)
-# Or via CLI
-tea pr merge --style squash
-
-# Clean up local branch
-git checkout main
-git pull origin main
-git branch -d task/TASK-XXX-description
-```
-
-## CI/CD with Gitea Actions
-
-Gitea Actions (v1.19+) uses GitHub Actions-compatible workflow syntax. Configuration goes in `.gitea/workflows/`:
-
-```yaml
-# .gitea/workflows/ci.yml
-name: CI
-on: [push, pull_request]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npm ci
-      - run: npm test
-```
-
-### Alternative: Drone CI
-
-Many Gitea installations use Drone CI. Configuration goes in `.drone.yml`:
-
-```yaml
-# .drone.yml
-kind: pipeline
-type: docker
-name: default
-
-steps:
-  - name: test
-    image: node:20
-    commands:
-      - npm ci
-      - npm test
-```
-
-## Installing tea CLI
-
-```bash
-# macOS
-brew install tea
-
-# Linux (download binary)
-curl -sL https://dl.gitea.io/tea/main/tea-main-linux-amd64 -o tea
-chmod +x tea
-sudo mv tea /usr/local/bin/
-
-# Windows (via scoop)
-scoop install tea
-```
-
-### Configure tea
-
-```bash
-# Add your Gitea instance
-tea login add --name myinstance --url https://gitea.example.com --token YOUR_TOKEN
-
-# Set as default
-tea login default myinstance
-```
-
-## Useful Commands
-
-```bash
-# tea CLI commands
-tea pr list                   # List open PRs
-tea pr view 123               # View PR details
-tea pr checkout 123           # Checkout PR locally
-tea issue list                # List issues
-tea repo list                 # List repositories
-
-# With specific login
-tea pr list --login myinstance
-```
-
-## Branch Protection
-
-Configure in Repository Settings > Branches > Branch Protection:
-- Enable branch protection for `main`
-- Require pull request reviews
-- Require status checks to pass
-- Block force push
-- Block branch deletion
-
-## Gitea vs GitHub Differences
-
-| Feature | GitHub | Gitea |
-|---------|--------|-------|
-| CLI | `gh` | `tea` |
-| CI | GitHub Actions | Gitea Actions / Drone |
-| Workflows | `.github/workflows/` | `.gitea/workflows/` |
-| PR Labels | Built-in | Instance-specific |
-
-## Self-Hosted Considerations
-
-- **Instance URL**: Replace `gitea.example.com` with your actual instance URL
-- **Runner Setup**: Gitea Actions requires act_runner for CI/CD
-- **Token Scopes**: Generate tokens with appropriate scopes in Settings > Applications
-- **Webhooks**: Configure webhooks for external CI if not using Gitea Actions

package/docs/workflows/github.md

@@ -1,103 +0,0 @@
-# GitHub Workflow Guide
-
-Git workflow guidance for projects hosted on GitHub.
-
-## Branch Naming
-
-```
-task/TASK-XXX-description     # Task branches
-feature/feature-name          # Feature branches
-bugfix/bug-description        # Bug fix branches
-hotfix/urgent-fix             # Urgent production fixes
-```
-
-## Daily Workflow
-
-### Starting a Task
-
-```bash
-# Ensure you're on latest main
-git checkout main && git pull origin main
-
-# Create feature branch
-git checkout -b task/TASK-XXX-description
-```
-
-### During Development
-
-```bash
-# Stage and commit changes
-git add .
-git commit -m "Add feature X"
-
-# Push to remote (first time)
-git push -u origin task/TASK-XXX-description
-
-# Subsequent pushes
-git push
-```
-
-### Creating a Pull Request
-
-```bash
-# Using GitHub CLI (recommended)
-gh pr create --title "TASK-XXX: Add feature X" --body "Description of changes"
-
-# Or with draft PR
-gh pr create --draft --title "TASK-XXX: WIP - Add feature X"
-```
-
-### After PR Approval
-
-```bash
-# Squash merge via GitHub UI or CLI
-gh pr merge --squash
-
-# Clean up local branch
-git checkout main
-git pull origin main
-git branch -d task/TASK-XXX-description
-```
-
-## CI/CD
-
-GitHub Actions configuration goes in `.github/workflows/`:
-
-```yaml
-# .github/workflows/ci.yml
-name: CI
-on: [push, pull_request]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Run tests
-        run: npm test
-```
-
-## Useful Commands
-
-```bash
-# Check PR status
-gh pr status
-
-# View PR in browser
-gh pr view --web
-
-# List open PRs
-gh pr list
-
-# Check CI status
-gh run list
-```
-
-## Branch Protection
-
-If on a paid plan, configure branch protection rules:
-- Require PR reviews before merging
-- Require status checks to pass
-- Require branches to be up to date
-
-For free plans, use the pre-push hook in `.githooks/pre-push`.

package/docs/workflows/gitlab.md

@@ -1,105 +0,0 @@
-# GitLab Workflow Guide
-
-Git workflow guidance for projects hosted on GitLab.
-
-## Branch Naming
-
-```
-task/TASK-XXX-description     # Task branches
-feature/feature-name          # Feature branches
-bugfix/bug-description        # Bug fix branches
-hotfix/urgent-fix             # Urgent production fixes
-```
-
-## Daily Workflow
-
-### Starting a Task
-
-```bash
-# Ensure you're on latest main
-git checkout main && git pull origin main
-
-# Create feature branch
-git checkout -b task/TASK-XXX-description
-```
-
-### During Development
-
-```bash
-# Stage and commit changes
-git add .
-git commit -m "Add feature X"
-
-# Push to remote (first time)
-git push -u origin task/TASK-XXX-description
-
-# Subsequent pushes
-git push
-```
-
-### Creating a Merge Request
-
-```bash
-# Push with merge request creation
-git push -o merge_request.create -o merge_request.title="TASK-XXX: Add feature X"
-
-# Or create via GitLab CLI (glab)
-glab mr create --title "TASK-XXX: Add feature X" --description "Description of changes"
-
-# Draft merge request
-glab mr create --draft --title "TASK-XXX: WIP - Add feature X"
-```
-
-### After MR Approval
-
-```bash
-# Merge via GitLab UI (squash merge recommended)
-# Or via CLI
-glab mr merge --squash
-
-# Clean up local branch
-git checkout main
-git pull origin main
-git branch -d task/TASK-XXX-description
-```
-
-## CI/CD
-
-GitLab CI configuration goes in `.gitlab-ci.yml`:
-
-```yaml
-# .gitlab-ci.yml
-stages:
-  - test
-  - build
-
-test:
-  stage: test
-  script:
-    - npm ci
-    - npm test
-
-build:
-  stage: build
-  script:
-    - npm run build
-  only:
-    - main
-```
-
-## Useful Commands
-
-```bash
-# Using GitLab CLI (glab)
-glab mr list              # List open MRs
-glab mr view              # View current MR
-glab mr checkout 123      # Checkout MR locally
-glab ci status            # Check pipeline status
-```
-
-## Branch Protection
-
-Configure in Settings > Repository > Protected Branches:
-- Require merge request approval
-- Require pipeline to succeed
-- Prevent force push