discoclaw 0.1.0

package/dist/tasks/task-sync-engine.js

@@ -0,0 +1,88 @@
+import { createTaskService } from './service.js';
+import { ingestTaskSyncSnapshot, planTaskSyncApplyExecution, } from './task-sync-pipeline.js';
+import { createTaskSyncApplyCounters, } from './task-sync-apply-types.js';
+import { applyTaskSyncExecutionPlan, } from './task-sync-phase-apply.js';
+import { runTaskSyncReconcilePhase, } from './task-sync-reconcile.js';
+import { resolveTasksForum } from './thread-ops.js';
+/**
+ * 5-phase safety-net sync between tasks DB and Discord forum threads.
+ *
+ * Phase 1: Create threads for tasks missing external_ref.
+ * Phase 2: Fix label mismatches (e.g., blocked label on open tasks).
+ * Phase 3: Sync emoji/names/starter content for existing threads.
+ * Phase 4: Archive threads for closed tasks.
+ * Phase 5: Reconcile forum threads against tasks — archive stale threads
+ *          for closed tasks and detect orphan threads with no matching task.
+ */
+export async function runTaskSync(opts) {
+    const { client, guild, forumId, tagMap, log } = opts;
+    const taskService = opts.taskService ?? createTaskService(opts.store);
+    const throttleMs = opts.throttleMs ?? 250;
+    const hasInFlightForChannel = opts.hasInFlightForChannel ?? (() => false);
+    const forum = await resolveTasksForum(guild, forumId);
+    if (!forum) {
+        log?.warn({ forumId }, 'task-sync: forum not found');
+        const result = {
+            threadsCreated: 0,
+            emojisUpdated: 0,
+            starterMessagesUpdated: 0,
+            threadsArchived: 0,
+            statusesUpdated: 0,
+            tagsUpdated: 0,
+            warnings: 1,
+        };
+        if (opts.statusPoster?.taskSyncComplete)
+            await opts.statusPoster.taskSyncComplete(result);
+        return result;
+    }
+    const counters = createTaskSyncApplyCounters();
+    // Stage 1: ingest
+    const allTasks = ingestTaskSyncSnapshot(opts.store.list({ status: 'all' }));
+    // Stage 2-4: compose normalize+diff+apply plan
+    const applyPlan = planTaskSyncApplyExecution(allTasks);
+    // Stage 4: apply
+    const applyCtx = {
+        client,
+        forum,
+        tagMap,
+        store: opts.store,
+        taskService,
+        log,
+        throttleMs,
+        archivedDedupeLimit: opts.archivedDedupeLimit,
+        mentionUserId: opts.mentionUserId,
+        hasInFlightForChannel,
+        counters,
+    };
+    await applyTaskSyncExecutionPlan(applyCtx, applyPlan);
+    const phase5 = await runTaskSyncReconcilePhase(applyCtx, allTasks, opts);
+    const threadsReconciled = phase5.threadsReconciled;
+    const orphanThreadsFound = phase5.orphanThreadsFound;
+    log?.info({
+        threadsCreated: counters.threadsCreated,
+        emojisUpdated: counters.emojisUpdated,
+        starterMessagesUpdated: counters.starterMessagesUpdated,
+        threadsArchived: counters.threadsArchived,
+        statusesUpdated: counters.statusesUpdated,
+        tagsUpdated: counters.tagsUpdated,
+        threadsReconciled,
+        orphanThreadsFound,
+        closesDeferred: counters.closesDeferred,
+        warnings: counters.warnings,
+    }, 'task-sync: complete');
+    const result = {
+        threadsCreated: counters.threadsCreated,
+        emojisUpdated: counters.emojisUpdated,
+        starterMessagesUpdated: counters.starterMessagesUpdated,
+        threadsArchived: counters.threadsArchived,
+        statusesUpdated: counters.statusesUpdated,
+        tagsUpdated: counters.tagsUpdated,
+        warnings: counters.warnings,
+        threadsReconciled,
+        orphanThreadsFound,
+        closesDeferred: counters.closesDeferred,
+    };
+    if (opts.statusPoster?.taskSyncComplete)
+        await opts.statusPoster.taskSyncComplete(result);
+    return result;
+}