1. OUTPUT START MESSAGE:

🎯 STARTING: Branch Pusher
Branch: {branch_name}
Remote: {remote}
Set Upstream: {set_upstream}
Force: {force}
───────────────────────────────────────

2. LOAD CONFIGURATION:

Load repo configuration to determine:

• Active handler platform (github|gitlab|bitbucket)
• Default remote name
• Protected branches list
• Force push policies
• Push sync strategy (auto-merge|pull-rebase|pull-merge|manual|fail)

Use repo-common skill to load configuration.

Note: If config doesn't exist, defaults will be used (including push_sync_strategy: "auto-merge")

3. VALIDATE INPUTS:

Branch Validation:

• If branch_name not provided, use current branch (git rev-parse --abbrev-ref HEAD)
• Check branch_name exists locally
• Verify branch has commits to push
• Validate branch is checked out or exists

Remote Validation:

• Verify remote exists in Git config
• Check remote is accessible
• Validate remote URL format

4. CHECK PROTECTED BRANCHES:

PROTECTED_BRANCHES = config.defaults.protected_branches
if branch_name in PROTECTED_BRANCHES and force:
    ERROR: "CRITICAL: Cannot force push to protected branch: {branch_name}"
    EXIT CODE 10

if branch_name in PROTECTED_BRANCHES:
    WARN: "Warning: Pushing to protected branch: {branch_name}"
    # Require explicit confirmation unless autonomous mode

5. VALIDATE FORCE PUSH:

If force=true:

• Check if branch exists on remote
• Verify local ref state
• Ensure force-with-lease is used (not bare force)
• Warn user about potential consequences

if force and not force_unsafe:
    # Use --force-with-lease (safe force push)
    push_flags = "--force-with-lease"
elif force_unsafe:
    # DANGEROUS: Only allow with explicit override
    ERROR: "CRITICAL: Unsafe force push requires explicit confirmation"
    EXIT CODE 10

6. CHECK AUTHENTICATION:

Verify credentials before attempting push:

• Check Git credentials cached or available
• Verify platform API token (if needed)
• Test remote connectivity

7. INVOKE HANDLER:

Invoke the active source control handler skill.

IMPORTANT: You MUST use the Skill tool to invoke the handler. The handler skill name is constructed as follows:

1. Read the platform from config: config.handlers.source_control.active (e.g., "github")
2. Construct the full skill name: fractary-repo:handler-source-control-<platform>
3. For example, if platform is "github", invoke: fractary-repo:handler-source-control-github

DO NOT use any other handler name pattern. The correct pattern is always fractary-repo:handler-source-control-<platform>.

Use the Skill tool with:

• command: fractary-repo:handler-source-control-<platform> (where is from config)
• Pass parameters: {branch_name, remote, set_upstream, force, push_flags, sync_strategy}

The handler will:

• Execute Git push with appropriate flags
• If push fails due to non-fast-forward (branch out of sync):
  • Apply configured sync_strategy (auto-merge, pull-rebase, pull-merge, manual, fail)
  • Retry push after sync (unless strategy is 'fail')
  • Report sync actions taken
• Set upstream tracking if requested
• Handle authentication and network errors
• Return push status and details

8. VALIDATE RESPONSE:

• Check handler returned success status
• Verify branch was pushed to remote
• Confirm upstream was set if requested
• Check remote ref matches local ref

9. CHECK CONFIG AND OUTPUT COMPLETION MESSAGE:

Check if configuration file exists using repo-common:check-config-exists utility.

If config_exists is false, include the recommendation in completion message:

✅ COMPLETED: Branch Pusher
Branch Pushed: {branch_name} → {remote}/{branch_name}
Upstream Set: {upstream_set}
Commits Pushed: {commit_count}
───────────────────────────────────────
Next: Run /fractary-repo:pr-create to open pull request when ready

💡 Tip: Run /fractary-repo:init to create a configuration file for this repository.
   This allows you to customize branch naming, merge strategies, and other plugin settings.

If config exists, omit the recommendation:

✅ COMPLETED: Branch Pusher
Branch Pushed: {branch_name} → {remote}/{branch_name}
Upstream Set: {upstream_set}
Commits Pushed: {commit_count}
───────────────────────────────────────
Next: Run /fractary-repo:pr-create to open pull request when ready