@@ -11,10 +11,12 @@ Defines the standard connector specification for external system integration.
1111Connectors enable ObjectStack to sync data with SaaS apps, databases, file storage,
1212and message queues through a unified protocol.
1313
14- ** Positioning in the sync/integration layering** (L1 "Simple Sync" was
15- retired in #4738 — narrative-only, zero consumers; see
16- ` packages/spec/docs/SYNC_ARCHITECTURE.md ` ):
17- - ** ETL Pipeline** ([ automation/etl.zod.ts] ( /docs/references/automation/etl ) ) - Data engineers - Aggregate 10 sources to warehouse
14+ ** Positioning in the sync/integration layering** — this file is now the ONLY
15+ layer. Both layers above it were retired under ADR-0049 for the same measured
16+ reason, that no engine ever executed them: L1 "Simple Sync"
17+ (` automation/sync.zod.ts ` ) in #4738 , and L2 "ETL Pipeline"
18+ (` automation/etl.zod.ts ` ) in #6414 . See
19+ ` packages/spec/docs/SYNC_ARCHITECTURE.md ` :
1820- ** Enterprise Connector** (THIS FILE) - System integrators - Full SAP integration; connector-attached sync via ` syncConfig `
1921
2022** SCOPE: Most comprehensive integration layer.**
@@ -95,9 +97,11 @@ Authentication is now imported from the canonical `auth/config.zod.ts`.
9597- Microsoft Dynamics 365 connector
9698
9799** When to downgrade:**
98- - Data transformation only → Use [ ETL Pipeline] ( /docs/references/automation/etl )
99-
100- See also: [ ../automation/etl.zod.ts] ( /docs/references/automation/etl ) for the ETL Pipeline layer (data engineering)
100+ - Per-field value conversion on import only → the import mapping's own
101+ ` transform ` (` data/mapping.zod.ts ` ), which the REST import path executes
102+ row by row. (This used to point at ` automation/etl.zod.ts ` ; L2 was retired
103+ at #6414 for having no executor, so the pointer would have been a signpost
104+ landing nowhere — the same defect class this header names below.)
101105
102106## There is no "Trigger Registry" alternative
103107
@@ -110,9 +114,11 @@ platform's authority, at a dead end (#4499; removed alongside the #4480
110114per-provider template cluster). The same defect class as the
111115` capabilities.readOnly ` prescription #4487 corrected: a signpost must land
112116somewhere enforced. Lightweight cases are served HERE — a connector instance
113- with simple ` auth ` — or by ` automation/etl.zod.ts ` for transformation
114- pipelines. (The automation-side L1 "Simple Sync" file was itself retired as
115- a dead end of the same class in #4738 .)
117+ with simple ` auth ` . (Both automation-side layers were themselves retired as
118+ dead ends of the same class: L1 "Simple Sync" in #4738 , L2 ` etl.zod.ts ` in
119+ #6414 . This paragraph named L2 as the transformation destination until the
120+ second retirement; a signpost that must land somewhere enforced cannot make
121+ an exception for itself.)
116122
117123<Callout type = " info" >
118124** Source:** ` packages/spec/src/integration/connector.zod.ts `
0 commit comments