org-syncer

Step 1: Output Start Message

Output:

🎯 STARTING: Organization Sync
Organization: {organization}
Environment: {environment} (branch: {target_branch})
Direction: {direction}
Parallel: {parallel} projects at a time
Dry Run: {yes|no}
───────────────────────────────────────

Step 2: Build CLI Arguments

Construct arguments array from inputs:

args = ["sync", "org"]

// Add organization if provided (otherwise uses config default)
if (organization) {
  args.push("--org", organization)
}

// Add environment or target branch
if (environment) {
  args.push("--environment", environment)
} else if (target_branch) {
  args.push("--branch", target_branch)
}

// Add direction
args.push("--direction", direction)

// Add exclude patterns if provided
if (exclude && exclude.length > 0) {
  exclude.forEach(e => args.push("--exclude", e))
}

// Add parallel setting
if (parallel) {
  args.push("--parallel", parallel)
}

// Add dry-run flag
if (dry_run) {
  args.push("--dry-run")
}

Step 3: Delegate to CLI Helper

USE SKILL: cli-helper Operation: invoke-cli Parameters:

{
  "command": "sync",
  "args": ["org", ...organization, ...environment, ...direction, ...exclude, ...parallel, ...dry_run],
  "parse_output": true
}

The cli-helper will:

1. Validate CLI installation
2. Execute: fractary codex sync org [--org <org>] [--environment <env>|--branch <branch>] --direction <direction> [--exclude <pattern>] [--parallel <n>] [--dry-run] --json
3. Parse JSON output
4. Return results

The CLI handles:

• Repository discovery (excluding codex repo and patterns)
• Parallel execution (respecting parallel limit)
• Phase sequencing (to-codex, then from-codex)
• Progress tracking
• Result aggregation
• Per-project error handling

Step 4: Process CLI Response

The CLI returns JSON like:

Successful Sync:

{
  "status": "success",
  "operation": "sync-org",
  "organization": "fractary",
  "environment": "test",
  "target_branch": "test",
  "direction": "bidirectional",
  "discovered": {
    "total_repositories": 42,
    "excluded": 3,
    "to_sync": 39
  },
  "phase1_to_codex": {
    "succeeded": 37,
    "failed": 2,
    "files_synced": 1247,
    "files_deleted": 23,
    "failed_projects": [
      {
        "project": "legacy-service",
        "error": "Branch not found"
      }
    ]
  },
  "phase2_from_codex": {
    "succeeded": 38,
    "failed": 1,
    "files_synced": 892,
    "files_deleted": 5,
    "failed_projects": [
      {
        "project": "readonly-repo",
        "error": "Permission denied"
      }
    ]
  },
  "overall": {
    "total_succeeded": 36,
    "total_failed": 3,
    "total_files_synced": 2139,
    "total_files_deleted": 28
  },
  "dry_run": false,
  "duration_seconds": 145.7
}

Dry-Run Preview:

{
  "status": "success",
  "operation": "sync-org",
  "organization": "fractary",
  "environment": "test",
  "direction": "bidirectional",
  "dry_run": true,
  "discovered": {
    "total_repositories": 42,
    "excluded": 3,
    "to_sync": 39,
    "repositories": ["project1", "project2", ...]
  },
  "would_sync": {
    "phase1_to_codex": {
      "projects": 39,
      "estimated_files": 1200,
      "estimated_deletions": 20
    },
    "phase2_from_codex": {
      "projects": 39,
      "estimated_files": 900,
      "estimated_deletions": 5
    }
  },
  "recommendation": "Safe to proceed",
  "estimated_duration_minutes": 3
}

IF status == "success":

• Extract sync results from CLI response
• Proceed to output formatting
• CONTINUE

IF status == "failure":

• Extract error message from CLI
• Return error to caller
• DONE (with error)

Step 5: Output Completion Message

Output:

✅ COMPLETED: Organization Sync
Organization: {organization}
Environment: {environment} (branch: {target_branch})
Direction: {direction}

Discovery:
- Total repositories: {total}
- Excluded: {excluded}
- Synced: {to_sync}

Phase 1 (Projects → Codex):
- Succeeded: {count}
- Failed: {count}
- Files synced: {total}

Phase 2 (Codex → Projects):
- Succeeded: {count}
- Failed: {count}
- Files synced: {total}

Overall:
- Total succeeded: {count}
- Total failed: {count}
- Total files synced: {total}

Duration: {duration}s

───────────────────────────────────────
Next: Review failed projects (if any)

Step 6: Return Results

Return structured JSON with sync results (pass through from CLI).

COMPLETION: Operation complete when sync results shown.