Skip to content

Commit b93ee57

Browse files
committed
fix(ci): 补 ADR-0087 disposition 标记,并把两处指向已退役 ETL 页的死链修在源头
- 三份 changeset 各补 `adr-0087: registered <id>`(#6148 门禁要求书面处置) - `integration/connector.zod.ts` 的三处 TSDoc 指向 automation/etl.zod.ts: L2 已退役,指针改指真正执行的面(data/mapping.zod.ts 的 transform), 而不是转到另一个不执行的层——这正是该文件 header 自己写的"signpost 必须 落在被执行的地方" - quick-reference.mdx 删掉 ETL 行并把 Automation 计数 5 → 4
1 parent 80bce97 commit b93ee57

5 files changed

Lines changed: 23 additions & 12 deletions

File tree

.changeset/etl-pipeline-layer-retired.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,3 +47,5 @@ a rename on a shape that does not survive the major has no observable effect, an
4747
The retirement kit — route 3: no tombstone, no D2 conversion.
4848
`RETIRED_DEFS_BY_MAJOR[17]` (9 defs) plus the D3 `SemanticMigration`
4949
`etl-pipeline-layer-retired` are the declaration.
50+
51+
<!-- adr-0087: registered etl-pipeline-layer-retired -->

.changeset/http-server-runtime-vocabulary-retired.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,3 +48,5 @@ baselines (`json-schema.manifest/system.json`, `authorable-surface/system.json`,
4848

4949
If host-implementer conformance becomes a real requirement it returns through the
5050
ENFORCE route: an adapter contract with a checker behind it, vocabulary second.
51+
52+
<!-- adr-0087: registered http-server-runtime-vocabulary-retired -->

.changeset/view-management-protocol-retired.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,3 +51,5 @@ generated baselines and reference docs lose their entries in the same change.
5151

5252
If "read and write ONE view by id" becomes a real requirement, it returns
5353
implementation-first.
54+
55+
<!-- adr-0087: registered view-management-protocol-retired -->

content/docs/getting-started/quick-reference.mdx

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ REST/GraphQL endpoints, real-time subscriptions, and discovery.
145145
| **[Metadata](/docs/references/api/metadata)** | `metadata.zod.ts` | Metadata | API metadata endpoints |
146146
| **[Storage](/docs/references/api/storage)** | `storage.zod.ts` | Storage | API storage operations |
147147

148-
## Automation Protocol (5 schemas)
148+
## Automation Protocol (4 schemas)
149149

150150
Flows, state machines, approvals, and integrations.
151151

@@ -155,7 +155,6 @@ Flows, state machines, approvals, and integrations.
155155
| **[Approval](/docs/references/automation/approval)** | `approval.zod.ts` | ApprovalNodeConfig | Flow approval-node config |
156156
| **[State Machine](/docs/references/automation/state-machine)** | `state-machine.zod.ts` | StateMachine | State machine definitions |
157157
| **[Webhook](/docs/references/automation/webhook)** | `webhook.zod.ts` | Webhook | Outbound webhooks |
158-
| **[ETL](/docs/references/automation/etl)** | `etl.zod.ts` | ETLPipeline | Data transformation pipelines |
159158

160159
## Security Protocol (3 schemas)
161160

packages/spec/src/integration/connector.zod.ts

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)