Function syncGithubWorkflow

ai/scripts/maintenance/syncGithubWorkflow.mjs:70–107

* @summary CLI entry point for the full GitHub Workflow mirror sync. * @returns {Promise }

()

 * @returns {Promise<void>}
 */
async function syncGithubWorkflow() {
    const verbose = process.argv.includes('--verbose');
    GH_Config.data.logLevel = verbose ? 'debug' : 'info';

    try {
        await assertSyncGithubWorkflowDevBranch();
    } catch (error) {
        console.error(error.message);
        process.exit(1);
    }

    console.log('🔄 Starting full GitHub Workflow sync via GH_SyncService.runFullSync()...');

    // Run the full workflow sync under the shared heavy-maintenance lease so this CLI
    // cannot collide with orchestrator maintenance tasks or another manual graph-heavy
    // script. The whole-run guard keeps graph ingestion protected until the sync stages
    // have a narrower concurrency boundary.
    let outcome;
    try {
        outcome = await withHeavyMaintenanceLease(
            async () => GH_SyncService.runFullSync(),
            {owner: 'syncGithubWorkflow', reason: 'manual-cli', metadata: {script: 'ai/scripts/maintenance/syncGithubWorkflow.mjs', verbose}}
        );
    } catch (e) {
        console.error('❌ Sync failed:', e);
        process.exit(1);
    }

    if (outcome.status === 'held') {
        const held = outcome.lease;
        console.log(`⏸️  Deferred: heavy-maintenance lease held by '${held.owner}' (reason='${held.reason}', pid=${held.pid}, acquiredAt=${held.acquiredAt}).`);
        console.log('   This script will not run while another heavy-maintenance task is active. Re-invoke once the active owner completes.');
        process.exit(0);
    }

    console.log('✅ Sync complete:', outcome.result);
    process.exit(0);
}

if (import.meta.url === pathToFileURL(process.argv[1] || '').href) {
    syncGithubWorkflow();