@@ -14,10 +14,12 @@ import { retiredKey } from '../shared/retired-key';
1414 * Connectors enable ObjectStack to sync data with SaaS apps, databases, file storage,
1515 * and message queues through a unified protocol.
1616 *
17- * **Positioning in the sync/integration layering** (L1 "Simple Sync" was
18- * retired in #4738 — narrative-only, zero consumers; see
19- * `packages/spec/docs/SYNC_ARCHITECTURE.md`):
20- * - **ETL Pipeline** (automation/etl.zod.ts) - Data engineers - Aggregate 10 sources to warehouse
17+ * **Positioning in the sync/integration layering** — this file is now the ONLY
18+ * layer. Both layers above it were retired under ADR-0049 for the same measured
19+ * reason, that no engine ever executed them: L1 "Simple Sync"
20+ * (`automation/sync.zod.ts`) in #4738, and L2 "ETL Pipeline"
21+ * (`automation/etl.zod.ts`) in #6414. See
22+ * `packages/spec/docs/SYNC_ARCHITECTURE.md`:
2123 * - **Enterprise Connector** (THIS FILE) - System integrators - Full SAP integration; connector-attached sync via `syncConfig`
2224 *
2325 * **SCOPE: Most comprehensive integration layer.**
@@ -98,9 +100,11 @@ import { retiredKey } from '../shared/retired-key';
98100 * - Microsoft Dynamics 365 connector
99101 *
100102 * **When to downgrade:**
101- * - Data transformation only → Use {@link file://../automation/etl.zod.ts | ETL Pipeline}
102- *
103- * @see {@link file://../automation/etl.zod.ts } for the ETL Pipeline layer (data engineering)
103+ * - Per-field value conversion on import only → the import mapping's own
104+ * `transform` (`data/mapping.zod.ts`), which the REST import path executes
105+ * row by row. (This used to point at `automation/etl.zod.ts`; L2 was retired
106+ * at #6414 for having no executor, so the pointer would have been a signpost
107+ * landing nowhere — the same defect class this header names below.)
104108 *
105109 * ## There is no "Trigger Registry" alternative
106110 *
@@ -113,9 +117,11 @@ import { retiredKey } from '../shared/retired-key';
113117 * per-provider template cluster). The same defect class as the
114118 * `capabilities.readOnly` prescription #4487 corrected: a signpost must land
115119 * somewhere enforced. Lightweight cases are served HERE — a connector instance
116- * with simple `auth` — or by `automation/etl.zod.ts` for transformation
117- * pipelines. (The automation-side L1 "Simple Sync" file was itself retired as
118- * a dead end of the same class in #4738.)
120+ * with simple `auth`. (Both automation-side layers were themselves retired as
121+ * dead ends of the same class: L1 "Simple Sync" in #4738, L2 `etl.zod.ts` in
122+ * #6414. This paragraph named L2 as the transformation destination until the
123+ * second retirement; a signpost that must land somewhere enforced cannot make
124+ * an exception for itself.)
119125 */
120126
121127// ============================================================================
0 commit comments