handler-sync-github

Output:

🎯 STARTING: GitHub Sync Handler
Source: <source_repo>
Target: <target_repo>
Branch: <target_branch>
Patterns: <include_count> include, <exclude_count> exclude
Dry Run: <yes|no>
───────────────────────────────────────

Step 2: Validate Inputs

Execute validation:

• Check source_repo and target_repo are non-empty
• Check target_branch is non-empty
• Check patterns.include is non-empty array
• Check patterns.exclude is array (can be empty)
• Validate all patterns are valid glob expressions

If validation fails:

• Output error message
• Return failure
• Exit workflow

Step 3: Read Workflow for Sync Operation

Based on the operation, read the appropriate workflow file:

For operation = "sync-docs":

READ: skills/handler-sync-github/workflow/sync-files.md
EXECUTE: Steps from workflow

This workflow will:

1. Clone source (codex) repository (via repo plugin)
2. Checkout target_branch in codex repository (via repo plugin)
   • If branch doesn't exist, fail with clear error
3. Clone target repository if needed (via repo plugin)
4. Execute sync-docs.sh script to copy files
5. Validate results (deletion thresholds, file counts)
6. Return results to this skill

Branch Checkout Details:

• The codex repository must be checked out to the specified target_branch
• This ensures documentation is synced to/from the correct environment
• Example: git checkout test for test environment
• Example: git checkout main for production environment

Step 4: Process Workflow Results

The workflow returns:

{
  "status": "success|failure",
  "files_synced": 25,
  "files_deleted": 2,
  "files_modified": 15,
  "files_added": 10,
  "deletion_threshold_exceeded": false,
  "dry_run": false
}

If status is "failure":

• Output error from workflow
• Return failure
• Exit

If status is "success":

• Continue to step 5

Step 5: Output Completion Message

Output:

✅ COMPLETED: GitHub Sync Handler
Branch: <target_branch>
Files synced: <files_synced>
Files added: <files_added>
Files modified: <files_modified>
Files deleted: <files_deleted>
Deletion threshold: <passed|exceeded>
───────────────────────────────────────
Next: Caller will create commit and push

Step 6: Return Results

Return structured results to caller:

{
  "status": "success",
  "handler": "github",
  "target_branch": "<target_branch>",
  "files_synced": 25,
  "files_deleted": 2,
  "files_modified": 15,
  "files_added": 10,
  "deletion_threshold_exceeded": false,
  "files_list": {
    "added": ["file1.md", "file2.md", ...],
    "modified": ["file3.md", ...],
    "deleted": ["file4.md", ...]
  },
  "dry_run": false
}