MokoCLI/docs/automation/push-files.md

Push Files

Push specific files from MokoStandards to selected repositories. Unlike bulk_sync.php which syncs all defined files, push_files.php pushes only the files you specify.

Usage

# Push a file to a single repo (creates a PR)
php api/automation/push_files.php --repos MokoCRM --files "src/config.php" --yes

# Push to multiple repos
php api/automation/push_files.php --repos "MokoCRM MokoDoliHRM" --files "LICENSE GOVERNANCE.md" --yes

# Direct commit (no PR) — pushes straight to main
php api/automation/push_files.php --repos MokoCRM --files "LICENSE" --direct --yes

# Skip tracking issue creation
php api/automation/push_files.php --repos MokoCRM --files "LICENSE" --yes --no-issue

Options

Flag	Description
--org	GitHub organization (default: MokoConsulting)
--repos	Target repositories (space-separated, required)
--files	Files to push (space-separated, required)
--direct	Push directly to main (no PR)
--no-issue	Skip creating a tracking issue
--dry-run	Preview without making changes
--yes	Auto-confirm prompts

Behaviour

• Creates a PR with the pushed files (unless --direct is used)
• Creates/updates a tracking issue in each target repo
• Cross-links the tracking issue to the PR in the Development sidebar
• Assigns jmiller to both PR and issue
• Applies standard labels: standards-update, mokostandards, type: chore, automation