From 4ee9bca315eef4b22a511fb0799650eb228d20ad Mon Sep 17 00:00:00 2001
From: rUv <ruv@ruv.net>
Date: Sun, 4 Jan 2026 19:19:51 +0000
Subject: [PATCH] checkpoint: File edit:
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🚀 Generated with [Claude Code](https://claude.com/claude-code)
📊 V3 Development Progress Checkpoint

Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
---
 v3/coordination/swarm-hub.ts | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/v3/coordination/swarm-hub.ts b/v3/coordination/swarm-hub.ts
index e5e5915fa6..a584391be5 100644
--- a/v3/coordination/swarm-hub.ts
+++ b/v3/coordination/swarm-hub.ts
@@ -1,6 +1,26 @@
 /**
- * V3 Swarm Hub
- * Central coordination hub for the 15-agent hierarchical mesh swarm
+ * V3 Swarm Hub - DUPLICATE FILE (DEPRECATED)
+ *
+ * ⚠️ DEPRECATION WARNING:
+ * This file is a DUPLICATE and should NOT be used.
+ * Use the canonical implementation at:
+ * /workspaces/claude-flow/v3/@claude-flow/swarm/src/coordination/swarm-hub.ts
+ *
+ * ADR-003 Decision:
+ * - ONE canonical coordination engine: UnifiedSwarmCoordinator
+ * - ONE SwarmHub compatibility layer: @claude-flow/swarm/coordination/swarm-hub.ts
+ * - This duplicate file is marked for removal
+ *
+ * Migration:
+ * ```typescript
+ * // CORRECT IMPORT:
+ * import { createUnifiedSwarmCoordinator } from '@claude-flow/swarm';
+ * const coordinator = createUnifiedSwarmCoordinator();
+ *
+ * // OR use compatibility layer:
+ * import { createSwarmHub } from '@claude-flow/swarm';
+ * const hub = createSwarmHub();
+ * ```
  *
  * Based on ADR-001 (agentic-flow integration), ADR-003 (Single Coordination Engine),
  * and the 15-Agent Swarm Architecture