mokocli/templates/required/README.md

Required Templates

<<<<<<< HEAD This directory contains REQUIRED files that must be present in all MokoCLI-compliant repositories.

Overview

Required templates are essential files that provide core functionality and ensure consistency across all repositories in the organization. These files must be copied to target repositories and kept synchronized with MokoCLI updates.

This directory contains REQUIRED files that must be present in all mokoplatform-compliant repositories.

Overview

Required templates are essential files that provide core functionality and ensure consistency across all repositories in the organization. These files must be copied to target repositories and kept synchronized with mokoplatform updates.

main

Required Files

1. setup-labels.sh

Status: ✅ REQUIRED
Target Location: scripts/maintenance/setup-labels.sh
Purpose: Deploy standardized GitHub labels to repository

Installation:

# Quick install
<<<<<<< HEAD
curl -fsSL https://raw.githubusercontent.com/MokoConsulting/MokoCLI/main/templates/required/setup-labels.sh > scripts/maintenance/setup-labels.sh
chmod +x scripts/maintenance/setup-labels.sh

# Or copy from MokoCLI
cp /path/to/MokoCLI/templates/required/setup-labels.sh scripts/maintenance/setup-labels.sh
=======
curl -fsSL https://raw.githubusercontent.com/MokoConsulting/mokoplatform/main/templates/required/setup-labels.sh > scripts/maintenance/setup-labels.sh
chmod +x scripts/maintenance/setup-labels.sh

# Or copy from mokoplatform
cp /path/to/mokoplatform/templates/required/setup-labels.sh scripts/maintenance/setup-labels.sh
>>>>>>> main
chmod +x scripts/maintenance/setup-labels.sh

Usage:

# Preview labels (dry-run)
./scripts/maintenance/setup-labels.sh --dry-run

# Deploy labels
./scripts/maintenance/setup-labels.sh

Features:

• 46 standard labels across 8 categories
• Project types (joomla, dolibarr, generic)
• Languages (php, javascript, typescript, python, css, html)
• Components (documentation, ci-cd, docker, tests, security, dependencies, config, build) <<<<<<< HEAD
• Workflow (automation, MokoCLI, needs-review, work-in-progress, breaking-change) =======
• Workflow (automation, mokoplatform, needs-review, work-in-progress, breaking-change)

main

• Priority (critical, high, medium, low)
• Type (bug, feature, enhancement, refactor, chore)
• Status (pending, in-progress, blocked, on-hold, wontfix)
• Size (xs, s, m, l, xl, xxl)
• Health (excellent, good, fair, poor)

Requirements:

• GitHub CLI (gh) installed
• Authenticated with GitHub CLI
• Admin access to repository

Validation:

# Check if present
[ -f scripts/maintenance/setup-labels.sh ] && echo "✅ Present" || echo "❌ Missing"

# Check if executable
[ -x scripts/maintenance/setup-labels.sh ] && echo "✅ Executable" || echo "❌ Not executable"

# Verify labels deployed
gh label list | wc -l  # Should show 46+ labels

Compliance Checking

Check Repository Compliance

# Check if all required files are present
required_files=(
    "scripts/maintenance/setup-labels.sh"
)

for file in "${required_files[@]}"; do
    if [ -f "$file" ]; then
        echo "✅ $file"
    else
        echo "❌ $file - MISSING"
    fi
done

Automated Compliance

<<<<<<< HEAD Use the MokoCLI validation scripts:

# From MokoCLI repository
=======
Use the mokoplatform validation scripts:

```bash
# From mokoplatform repository
>>>>>>> main
python3 scripts/validate/validate_repo_health.py --check-required-files

# Or use bulk validation
php scripts/automation/bulk_update_repos.php --validate-only

Syncing Updates

<<<<<<< HEAD Required files should be kept in sync with MokoCLI:

# Update single file
curl -fsSL https://raw.githubusercontent.com/MokoConsulting/MokoCLI/main/templates/required/setup-labels.sh > scripts/maintenance/setup-labels.sh

# Or use bulk sync
cd /path/to/MokoCLI
=======
Required files should be kept in sync with mokoplatform:

```bash
# Update single file
curl -fsSL https://raw.githubusercontent.com/MokoConsulting/mokoplatform/main/templates/required/setup-labels.sh > scripts/maintenance/setup-labels.sh

# Or use bulk sync
cd /path/to/mokoplatform
>>>>>>> main
./scripts/automation/bulk_update_repos.sh --org MokoConsulting --sync-required

Using with GitHub Copilot

To deploy required files to a repository using GitHub Copilot:

<<<<<<< HEAD
Deploy required MokoCLI files to this repository.
=======
Deploy required mokoplatform files to this repository.
>>>>>>> main

Required files to deploy:
1. setup-labels.sh - Label deployment script

Process:
1. Create scripts/maintenance/ directory if not exists
<<<<<<< HEAD
2. Download setup-labels.sh from MokoConsulting/MokoCLI
=======
2. Download setup-labels.sh from MokoConsulting/mokoplatform
>>>>>>> main
3. Copy to scripts/maintenance/setup-labels.sh
4. Make executable: chmod +x scripts/maintenance/setup-labels.sh
5. Test with dry-run: ./scripts/maintenance/setup-labels.sh --dry-run
6. Deploy labels: ./scripts/maintenance/setup-labels.sh
7. Verify labels in repository settings

<<<<<<< HEAD
Source: https://git.mokoconsulting.tech/MokoConsulting/mokocli/tree/main/templates/required
=======
Source: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/tree/main/templates/required
>>>>>>> main

Future Required Files

<<<<<<< HEAD As MokoCLI evolves, additional required files may be added:

As mokoplatform evolves, additional required files may be added:

main

• PLANNED: .github/labeler.yml - Auto-labeling configuration
• PLANNED: .editorconfig - Editor configuration
• PLANNED: scripts/validate/check_compliance.sh - Standards compliance checker
• PLANNED: .github/workflows/standards-check.yml - Automated standards validation

Support

• Documentation: Copilot Sync Standards Guide
• Label Guide: Label Deployment Guide <<<<<<< HEAD
• Issues: https://git.mokoconsulting.tech/MokoConsulting/mokocli/issues =======
• Issues: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/issues

main

• Contact: hello@mokoconsulting.tech

Related Documentation

• Copilot Sync Standards Guide
• Label Deployment Guide
• Bulk Repository Updates
• Template Catalog

---

Last Updated: 2026-01-28
Version: 03.01.00
<<<<<<< HEAD Maintained By: MokoCLI Team

Maintained By: mokoplatform Team

main