@pattern-stack/codegen 0.10.1 → 0.11.0

package/dist/src/cli/index.js

@@ -1081,7 +1081,7 @@ import { parse as parseYaml } from "yaml";
 // src/schema/entity-definition.schema.ts
 import { z as z3 } from "zod";
 
-// runtime/subsystems/sync/sync-field-diff.protocol.ts
+// runtime/subsystems/integration/integration-field-diff.protocol.ts
 import { z } from "zod";
 var FieldDiffValueSchema = z.object({
   from: z.unknown(),
@@ -1089,7 +1089,7 @@ var FieldDiffValueSchema = z.object({
 });
 var FieldDiffSchema = z.record(z.string(), FieldDiffValueSchema);
 
-// runtime/subsystems/sync/detection-config.schema.ts
+// runtime/subsystems/integration/detection-config.schema.ts
 import { z as z2 } from "zod";
 var FieldMappingSchema = z2.object({
   source: z2.string().min(1),
@@ -1147,21 +1147,21 @@ var DetectionConfigSchema = z2.discriminatedUnion("mode", [
   WebhookModeSchema
 ]);
 
-// runtime/subsystems/sync/sync.tokens.ts
-var SYNC_CHANGE_SOURCE = "SYNC_CHANGE_SOURCE";
-var SYNC_CURSOR_STORE = "SYNC_CURSOR_STORE";
-var SYNC_FIELD_DIFFER = "SYNC_FIELD_DIFFER";
-var SYNC_SINK = "SYNC_SINK";
-var SYNC_RUN_RECORDER = "SYNC_RUN_RECORDER";
-var SYNC_MODULE_OPTIONS = "SYNC_MODULE_OPTIONS";
-var SYNC_MULTI_TENANT = "SYNC_MULTI_TENANT";
+// runtime/subsystems/integration/integration.tokens.ts
+var INTEGRATION_CHANGE_SOURCE = "INTEGRATION_CHANGE_SOURCE";
+var INTEGRATION_CURSOR_STORE = "INTEGRATION_CURSOR_STORE";
+var INTEGRATION_FIELD_DIFFER = "INTEGRATION_FIELD_DIFFER";
+var INTEGRATION_SINK = "INTEGRATION_SINK";
+var INTEGRATION_RUN_RECORDER = "INTEGRATION_RUN_RECORDER";
+var INTEGRATION_MODULE_OPTIONS = "INTEGRATION_MODULE_OPTIONS";
+var INTEGRATION_MULTI_TENANT = "INTEGRATION_MULTI_TENANT";
 
-// runtime/subsystems/sync/sync-errors.ts
+// runtime/subsystems/integration/integration-errors.ts
 var MissingTenantIdError = class extends Error {
   name = "MissingTenantIdError";
   constructor(operation) {
     super(
-      `Missing tenantId for sync operation '${operation}'. SyncModule is configured with multiTenant: true \u2014 every call must include a non-null tenantId. Either pass the tenantId or disable multi-tenancy on the module.`
+      `Missing tenantId for integration operation '${operation}'. IntegrationModule is configured with multiTenant: true \u2014 every call must include a non-null tenantId. Either pass the tenantId or disable multi-tenancy on the module.`
     );
   }
 };
@@ -1172,7 +1172,7 @@ function assertTenantId(tenantId, options) {
   }
 }
 
-// runtime/subsystems/sync/sync-audit.schema.ts
+// runtime/subsystems/integration/integration-audit.schema.ts
 import {
   pgEnum,
   pgTable,
@@ -1185,39 +1185,39 @@ import {
   index,
   uniqueIndex
 } from "drizzle-orm/pg-core";
-var syncRunDirectionEnum = pgEnum("sync_run_direction", [
+var integrationRunDirectionEnum = pgEnum("integration_run_direction", [
   "inbound",
   "outbound"
 ]);
-var syncRunActionEnum = pgEnum("sync_run_action", [
+var integrationRunActionEnum = pgEnum("integration_run_action", [
   "poll",
   "cdc",
   "webhook",
   "manual",
   "writeback"
 ]);
-var syncRunStatusEnum = pgEnum("sync_run_status", [
+var integrationRunStatusEnum = pgEnum("integration_run_status", [
   "running",
   "success",
   "no_changes",
   "failed"
 ]);
-var syncRunItemOperationEnum = pgEnum("sync_run_item_operation", [
+var integrationRunItemOperationEnum = pgEnum("integration_run_item_operation", [
   "created",
   "updated",
   "deleted",
   "noop"
 ]);
-var syncRunItemStatusEnum = pgEnum("sync_run_item_status", [
+var integrationRunItemStatusEnum = pgEnum("integration_run_item_status", [
   "success",
   "failed",
   "skipped"
 ]);
-var syncSubscriptions = pgTable(
-  "sync_subscriptions",
+var integrationSubscriptions = pgTable(
+  "integration_subscriptions",
   {
     id: uuid("id").primaryKey().defaultRandom(),
-    integrationId: text("integration_id").notNull(),
+    connectionId: text("connection_id").notNull(),
     adapter: text("adapter").notNull(),
     domain: text("domain").notNull(),
     externalRef: text("external_ref"),
@@ -1232,8 +1232,8 @@ var syncSubscriptions = pgTable(
      * successful run advances it.
      */
     cursor: jsonb("cursor").$type(),
-    lastSyncAt: timestamp("last_sync_at", { withTimezone: true }),
-    /** Runtime-enforced when `SYNC_MULTI_TENANT` is true; see SYNC-6. */
+    lastIntegrationAt: timestamp("last_integration_at", { withTimezone: true }),
+    /** Runtime-enforced when `INTEGRATION_MULTI_TENANT` is true; see SYNC-6. */
     tenantId: text("tenant_id"),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
@@ -1242,31 +1242,31 @@ var syncSubscriptions = pgTable(
     /**
      * Composite uniqueness per the epic shape. `external_ref` is nullable;
      * Postgres treats NULLs as distinct in a UNIQUE constraint, which means
-     * two rows with the same `(integration_id, adapter, domain)` and NULL
+     * two rows with the same `(connection_id, adapter, domain)` and NULL
      * external_ref are allowed. That's intentional — a subscription with
      * NULL external_ref covers the full domain, and duplicates there would
      * be a consumer-layer modeling issue, not a schema concern.
      */
-    uqSyncSubscriptionTuple: uniqueIndex("uq_sync_subscriptions_tuple").on(
-      t.integrationId,
+    uqIntegrationSubscriptionTuple: uniqueIndex("uq_integration_subscriptions_tuple").on(
+      t.connectionId,
       t.adapter,
       t.domain,
       t.externalRef
     ),
     /** Scheduling query: list enabled subscriptions ordered by staleness. */
-    idxSyncSubscriptionsEnabledLastSync: index(
-      "idx_sync_subscriptions_enabled_last_sync"
-    ).on(t.enabled, t.lastSyncAt)
+    idxIntegrationSubscriptionsEnabledLastIntegration: index(
+      "idx_integration_subscriptions_enabled_last_integration"
+    ).on(t.enabled, t.lastIntegrationAt)
   })
 );
-var syncRuns = pgTable(
-  "sync_runs",
+var integrationRuns = pgTable(
+  "integration_runs",
   {
     id: uuid("id").primaryKey().defaultRandom(),
-    subscriptionId: uuid("subscription_id").notNull().references(() => syncSubscriptions.id, { onDelete: "cascade" }),
-    direction: syncRunDirectionEnum("direction").notNull(),
-    action: syncRunActionEnum("action").notNull(),
-    status: syncRunStatusEnum("status").notNull().default("running"),
+    subscriptionId: uuid("subscription_id").notNull().references(() => integrationSubscriptions.id, { onDelete: "cascade" }),
+    direction: integrationRunDirectionEnum("direction").notNull(),
+    action: integrationRunActionEnum("action").notNull(),
+    status: integrationRunStatusEnum("status").notNull().default("running"),
     recordsFound: integer("records_found").notNull().default(0),
     recordsProcessed: integer("records_processed").notNull().default(0),
     cursorBefore: jsonb("cursor_before").$type(),
@@ -1275,31 +1275,31 @@ var syncRuns = pgTable(
     error: text("error"),
     startedAt: timestamp("started_at", { withTimezone: true }).notNull().defaultNow(),
     completedAt: timestamp("completed_at", { withTimezone: true }),
-    /** Runtime-enforced when `SYNC_MULTI_TENANT` is true; see SYNC-6. */
+    /** Runtime-enforced when `INTEGRATION_MULTI_TENANT` is true; see SYNC-6. */
     tenantId: text("tenant_id")
   },
   (t) => ({
     /** Timeline read: "most recent runs for this subscription". */
-    idxSyncRunsSubscriptionStartedAt: index(
-      "idx_sync_runs_subscription_started_at"
+    idxIntegrationRunsSubscriptionStartedAt: index(
+      "idx_integration_runs_subscription_started_at"
     ).on(t.subscriptionId, t.startedAt),
     /** Stale-run sweeper: "runs that started > N minutes ago and are still running". */
-    idxSyncRunsStatusStartedAt: index("idx_sync_runs_status_started_at").on(
+    idxIntegrationRunsStatusStartedAt: index("idx_integration_runs_status_started_at").on(
       t.status,
       t.startedAt
     )
   })
 );
-var syncRunItems = pgTable(
-  "sync_run_items",
+var integrationRunItems = pgTable(
+  "integration_run_items",
   {
     id: uuid("id").primaryKey().defaultRandom(),
-    syncRunId: uuid("sync_run_id").notNull().references(() => syncRuns.id, { onDelete: "cascade" }),
+    integrationRunId: uuid("integration_run_id").notNull().references(() => integrationRuns.id, { onDelete: "cascade" }),
     entityType: text("entity_type").notNull(),
     externalId: text("external_id").notNull(),
     localId: text("local_id"),
-    operation: syncRunItemOperationEnum("operation").notNull(),
-    status: syncRunItemStatusEnum("status").notNull(),
+    operation: integrationRunItemOperationEnum("operation").notNull(),
+    status: integrationRunItemStatusEnum("status").notNull(),
     /**
      * Structured per-field diff — ADR-0003 shape enforced by
      * `FieldDiffSchema.parse` at the recorder service layer.
@@ -1313,23 +1313,23 @@ var syncRunItems = pgTable(
     title: text("title"),
     error: text("error"),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
-    /** Runtime-enforced when `SYNC_MULTI_TENANT` is true; see SYNC-6. */
+    /** Runtime-enforced when `INTEGRATION_MULTI_TENANT` is true; see SYNC-6. */
     tenantId: text("tenant_id")
   },
   (t) => ({
     /** Ordered timeline within a run. */
-    idxSyncRunItemsRunCreatedAt: index("idx_sync_run_items_run_created_at").on(
-      t.syncRunId,
+    idxIntegrationRunItemsRunCreatedAt: index("idx_integration_run_items_run_created_at").on(
+      t.integrationRunId,
       t.createdAt
     ),
-    /** Per-record history: "every sync that touched opportunity/$extId". */
-    idxSyncRunItemsEntityExternal: index(
-      "idx_sync_run_items_entity_external"
+    /** Per-record history: "every integration that touched opportunity/$extId". */
+    idxIntegrationRunItemsEntityExternal: index(
+      "idx_integration_run_items_entity_external"
     ).on(t.entityType, t.externalId)
   })
 );
 
-// runtime/subsystems/sync/sync-cursor-store.memory-backend.ts
+// runtime/subsystems/integration/integration-cursor-store.memory-backend.ts
 import { Injectable } from "@nestjs/common";
 var MemoryCursorStore = class {
   /**
@@ -1340,7 +1340,7 @@ var MemoryCursorStore = class {
   /**
    * Seedable subscription metadata for `listAll` — the memory backend
    * stores only `subscriptionId → cursor` in its write path, so the
-   * snapshot shape (`integrationId`, `adapter`, `domain`, `externalRef`,
+   * snapshot shape (`connectionId`, `adapter`, `domain`, `externalRef`,
    * timestamps) has no natural source without test seeding. Tests populate
    * this map; unseeded entries get empty-string metadata and `new Date(0)`
    * timestamps so the shape stays stable. Production paths go through the
@@ -1360,12 +1360,12 @@ var MemoryCursorStore = class {
       const meta = this.subscriptions.get(subscriptionId);
       snapshots.push({
         subscriptionId,
-        integrationId: meta?.integrationId ?? "",
+        connectionId: meta?.connectionId ?? "",
         adapter: meta?.adapter ?? "",
         domain: meta?.domain ?? "",
         externalRef: meta?.externalRef ?? null,
         cursor: cursor ?? null,
-        lastSyncAt: meta?.lastSyncAt ?? null,
+        lastIntegrationAt: meta?.lastIntegrationAt ?? null,
         updatedAt: meta?.updatedAt ?? /* @__PURE__ */ new Date(0),
         tenantId: null
       });
@@ -1384,7 +1384,7 @@ MemoryCursorStore = __decorateClass([
   Injectable()
 ], MemoryCursorStore);
 
-// runtime/subsystems/sync/sync-run-recorder.memory-backend.ts
+// runtime/subsystems/integration/integration-run-recorder.memory-backend.ts
 import { Injectable as Injectable2 } from "@nestjs/common";
 var MemoryRunRecorder = class {
   /**
@@ -1393,14 +1393,14 @@ var MemoryRunRecorder = class {
    */
   runs = /* @__PURE__ */ new Map();
   /**
-   * Items keyed by `sync_run_id`, array order matches insertion order —
-   * mirrors the timeline the `(sync_run_id, created_at)` index produces
+   * Items keyed by `integration_run_id`, array order matches insertion order —
+   * mirrors the timeline the `(integration_run_id, created_at)` index produces
    * in Postgres.
    */
   items = /* @__PURE__ */ new Map();
   /**
    * Seedable subscription metadata — tests populate this to make
-   * `listRecent` return meaningful `integrationId` values. The memory
+   * `listRecent` return meaningful `connectionId` values. The memory
    * backend doesn't track subscriptions on its own (only runs + items), so
    * this map is the intentional extension point: tests write entries for
    * the subscription ids they use, production code never touches it.
@@ -1429,10 +1429,10 @@ var MemoryRunRecorder = class {
   }
   async recordItem(input) {
     FieldDiffSchema.parse(input.changedFields);
-    const bucket = this.items.get(input.syncRunId);
+    const bucket = this.items.get(input.integrationRunId);
     if (!bucket) {
       throw new Error(
-        `MemoryRunRecorder.recordItem: no run started for id '${input.syncRunId}'. Call startRun(...) first.`
+        `MemoryRunRecorder.recordItem: no run started for id '${input.integrationRunId}'. Call startRun(...) first.`
       );
     }
     bucket.push(input);
@@ -1458,10 +1458,10 @@ var MemoryRunRecorder = class {
     return filtered.sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime()).slice(0, limit).map((r) => ({
       id: r.id,
       subscriptionId: r.subscriptionId,
-      // integrationId is only knowable if the test seeded subscriptions
+      // connectionId is only knowable if the test seeded subscriptions
       // metadata; empty string otherwise. The Drizzle backend resolves
       // it via JOIN, which is the production path.
-      integrationId: this.subscriptions.get(r.subscriptionId)?.integrationId ?? "",
+      connectionId: this.subscriptions.get(r.subscriptionId)?.connectionId ?? "",
       status: r.status,
       startedAt: r.startedAt,
       completedAt: r.completedAt,
@@ -1489,7 +1489,7 @@ MemoryRunRecorder = __decorateClass([
   Injectable2()
 ], MemoryRunRecorder);
 
-// runtime/subsystems/sync/deep-equal.differ.ts
+// runtime/subsystems/integration/deep-equal.differ.ts
 import { Injectable as Injectable3 } from "@nestjs/common";
 var DEFAULT_IGNORE_FIELDS = /* @__PURE__ */ new Set([
   "id",
@@ -1588,9 +1588,9 @@ function deepEqualObject(a, b) {
   return true;
 }
 
-// runtime/subsystems/sync/execute-sync.use-case.ts
+// runtime/subsystems/integration/execute-integration.use-case.ts
 import { Inject, Injectable as Injectable4, Logger, Optional } from "@nestjs/common";
-var ExecuteSyncUseCase = class {
+var ExecuteIntegrationUseCase = class {
   constructor(source, cursors, differ, sink, recorder, multiTenant = false) {
     this.source = source;
     this.cursors = cursors;
@@ -1605,7 +1605,7 @@ var ExecuteSyncUseCase = class {
   sink;
   recorder;
   multiTenant;
-  logger = new Logger(ExecuteSyncUseCase.name);
+  logger = new Logger(ExecuteIntegrationUseCase.name);
   async execute(input) {
     assertTenantId(input.tenantId, {
       multiTenant: this.multiTenant,
@@ -1640,10 +1640,10 @@ var ExecuteSyncUseCase = class {
           recordsFailed++;
           const message = err instanceof Error ? err.message : String(err);
           this.logger.warn(
-            `sync item failed: subscription=${input.subscription.id} externalId=${change.externalId}: ${message}`
+            `integration item failed: subscription=${input.subscription.id} externalId=${change.externalId}: ${message}`
           );
           await this.recorder.recordItem({
-            syncRunId: runId,
+            integrationRunId: runId,
             entityType: input.subscription.domain,
             externalId: change.externalId,
             operation: change.operation === "deleted" ? "deleted" : "updated",
@@ -1666,7 +1666,7 @@ var ExecuteSyncUseCase = class {
       status = "failed";
       runError = err instanceof Error ? err.message : String(err);
       this.logger.error(
-        `sync source failed: subscription=${input.subscription.id}: ${runError}`
+        `integration source failed: subscription=${input.subscription.id}: ${runError}`
       );
     }
     if (cursorAdvanced && latestCursor !== null && latestCursor !== void 0) {
@@ -1711,7 +1711,7 @@ var ExecuteSyncUseCase = class {
         change.externalId
       );
       await this.recorder.recordItem({
-        syncRunId: runId,
+        integrationRunId: runId,
         entityType: input.subscription.domain,
         externalId: change.externalId,
         localId: result?.id ?? null,
@@ -1734,7 +1734,7 @@ var ExecuteSyncUseCase = class {
     if (diff === "noop") {
       if (!this.sink.reprojectsOnNoop) {
         await this.recorder.recordItem({
-          syncRunId: runId,
+          integrationRunId: runId,
           entityType: input.subscription.domain,
           externalId: change.externalId,
           localId: null,
@@ -1751,7 +1751,7 @@ var ExecuteSyncUseCase = class {
         input.provider
       );
       await this.recorder.recordItem({
-        syncRunId: runId,
+        integrationRunId: runId,
         entityType: input.subscription.domain,
         externalId: change.externalId,
         localId: noopLocalId,
@@ -1768,7 +1768,7 @@ var ExecuteSyncUseCase = class {
       input.provider
     );
     await this.recorder.recordItem({
-      syncRunId: runId,
+      integrationRunId: runId,
       entityType: input.subscription.domain,
       externalId: change.externalId,
       localId,
@@ -1779,25 +1779,25 @@ var ExecuteSyncUseCase = class {
     });
   }
 };
-ExecuteSyncUseCase = __decorateClass([
+ExecuteIntegrationUseCase = __decorateClass([
   Injectable4(),
-  __decorateParam(0, Inject(SYNC_CHANGE_SOURCE)),
-  __decorateParam(1, Inject(SYNC_CURSOR_STORE)),
-  __decorateParam(2, Inject(SYNC_FIELD_DIFFER)),
-  __decorateParam(3, Inject(SYNC_SINK)),
-  __decorateParam(4, Inject(SYNC_RUN_RECORDER)),
+  __decorateParam(0, Inject(INTEGRATION_CHANGE_SOURCE)),
+  __decorateParam(1, Inject(INTEGRATION_CURSOR_STORE)),
+  __decorateParam(2, Inject(INTEGRATION_FIELD_DIFFER)),
+  __decorateParam(3, Inject(INTEGRATION_SINK)),
+  __decorateParam(4, Inject(INTEGRATION_RUN_RECORDER)),
   __decorateParam(5, Optional()),
-  __decorateParam(5, Inject(SYNC_MULTI_TENANT))
-], ExecuteSyncUseCase);
+  __decorateParam(5, Inject(INTEGRATION_MULTI_TENANT))
+], ExecuteIntegrationUseCase);
 
-// runtime/subsystems/sync/sync-cursor-store.drizzle-backend.ts
+// runtime/subsystems/integration/integration-cursor-store.drizzle-backend.ts
 import { Inject as Inject2, Injectable as Injectable5, Optional as Optional2 } from "@nestjs/common";
 import { and, desc, eq } from "drizzle-orm";
 
 // runtime/constants/tokens.ts
 var DRIZZLE = "DRIZZLE";
 
-// runtime/subsystems/sync/sync-cursor-store.drizzle-backend.ts
+// runtime/subsystems/integration/integration-cursor-store.drizzle-backend.ts
 var PostgresCursorStore = class {
   constructor(db, multiTenant) {
     this.db = db;
@@ -1807,15 +1807,15 @@ var PostgresCursorStore = class {
   multiTenant;
   async get(subscriptionId, tenantId) {
     const where = this.buildWhere(subscriptionId, tenantId, "cursor.get");
-    const rows = await this.db.select({ cursor: syncSubscriptions.cursor }).from(syncSubscriptions).where(where).limit(1);
+    const rows = await this.db.select({ cursor: integrationSubscriptions.cursor }).from(integrationSubscriptions).where(where).limit(1);
     if (rows.length === 0) return null;
     return rows[0]?.cursor ?? null;
   }
   async put(subscriptionId, cursor, tenantId) {
     const where = this.buildWhere(subscriptionId, tenantId, "cursor.put");
-    await this.db.update(syncSubscriptions).set({
+    await this.db.update(integrationSubscriptions).set({
       cursor,
-      lastSyncAt: /* @__PURE__ */ new Date(),
+      lastIntegrationAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
     }).where(where);
   }
@@ -1824,26 +1824,26 @@ var PostgresCursorStore = class {
       multiTenant: this.multiTenant,
       operation: "cursor.listAll"
     });
-    const where = this.multiTenant ? eq(syncSubscriptions.tenantId, tenantId) : void 0;
+    const where = this.multiTenant ? eq(integrationSubscriptions.tenantId, tenantId) : void 0;
     const rows = await this.db.select({
-      id: syncSubscriptions.id,
-      integrationId: syncSubscriptions.integrationId,
-      adapter: syncSubscriptions.adapter,
-      domain: syncSubscriptions.domain,
-      externalRef: syncSubscriptions.externalRef,
-      cursor: syncSubscriptions.cursor,
-      lastSyncAt: syncSubscriptions.lastSyncAt,
-      updatedAt: syncSubscriptions.updatedAt,
-      tenantId: syncSubscriptions.tenantId
-    }).from(syncSubscriptions).where(where).orderBy(desc(syncSubscriptions.updatedAt));
+      id: integrationSubscriptions.id,
+      connectionId: integrationSubscriptions.connectionId,
+      adapter: integrationSubscriptions.adapter,
+      domain: integrationSubscriptions.domain,
+      externalRef: integrationSubscriptions.externalRef,
+      cursor: integrationSubscriptions.cursor,
+      lastIntegrationAt: integrationSubscriptions.lastIntegrationAt,
+      updatedAt: integrationSubscriptions.updatedAt,
+      tenantId: integrationSubscriptions.tenantId
+    }).from(integrationSubscriptions).where(where).orderBy(desc(integrationSubscriptions.updatedAt));
     return rows.map((row) => ({
       subscriptionId: row.id,
-      integrationId: row.integrationId,
+      connectionId: row.connectionId,
       adapter: row.adapter,
       domain: row.domain,
       externalRef: row.externalRef,
       cursor: row.cursor ?? null,
-      lastSyncAt: row.lastSyncAt,
+      lastIntegrationAt: row.lastIntegrationAt,
       updatedAt: row.updatedAt,
       tenantId: row.tenantId
     }));
@@ -1860,24 +1860,24 @@ var PostgresCursorStore = class {
     });
     if (this.multiTenant) {
       return and(
-        eq(syncSubscriptions.id, subscriptionId),
-        eq(syncSubscriptions.tenantId, tenantId)
+        eq(integrationSubscriptions.id, subscriptionId),
+        eq(integrationSubscriptions.tenantId, tenantId)
       );
     }
-    return eq(syncSubscriptions.id, subscriptionId);
+    return eq(integrationSubscriptions.id, subscriptionId);
   }
 };
 PostgresCursorStore = __decorateClass([
   Injectable5(),
   __decorateParam(0, Inject2(DRIZZLE)),
   __decorateParam(1, Optional2()),
-  __decorateParam(1, Inject2(SYNC_MULTI_TENANT))
+  __decorateParam(1, Inject2(INTEGRATION_MULTI_TENANT))
 ], PostgresCursorStore);
 
-// runtime/subsystems/sync/sync-run-recorder.drizzle-backend.ts
+// runtime/subsystems/integration/integration-run-recorder.drizzle-backend.ts
 import { Inject as Inject3, Injectable as Injectable6, Optional as Optional3 } from "@nestjs/common";
 import { and as and2, desc as desc2, eq as eq2 } from "drizzle-orm";
-var DrizzleSyncRunRecorder = class {
+var DrizzleIntegrationRunRecorder = class {
   constructor(db, multiTenant) {
     this.db = db;
     this.multiTenant = multiTenant ?? false;
@@ -1889,17 +1889,17 @@ var DrizzleSyncRunRecorder = class {
       multiTenant: this.multiTenant,
       operation: "startRun"
     });
-    const rows = await this.db.insert(syncRuns).values({
+    const rows = await this.db.insert(integrationRuns).values({
       subscriptionId: input.subscriptionId,
       direction: input.direction,
       action: input.action,
       status: "running",
       cursorBefore: input.cursorBefore ?? null,
       tenantId: input.tenantId ?? null
-    }).returning({ id: syncRuns.id });
+    }).returning({ id: integrationRuns.id });
     const id = rows[0]?.id;
     if (!id) {
-      throw new Error("DrizzleSyncRunRecorder: INSERT RETURNING produced no id");
+      throw new Error("DrizzleIntegrationRunRecorder: INSERT RETURNING produced no id");
     }
     return { id };
   }
@@ -1909,8 +1909,8 @@ var DrizzleSyncRunRecorder = class {
       operation: "recordItem"
     });
     FieldDiffSchema.parse(input.changedFields);
-    await this.db.insert(syncRunItems).values({
-      syncRunId: input.syncRunId,
+    await this.db.insert(integrationRunItems).values({
+      integrationRunId: input.integrationRunId,
       entityType: input.entityType,
       externalId: input.externalId,
       localId: input.localId ?? null,
@@ -1929,29 +1929,29 @@ var DrizzleSyncRunRecorder = class {
     });
     const conditions = [];
     if (subscriptionId !== void 0) {
-      conditions.push(eq2(syncRuns.subscriptionId, subscriptionId));
+      conditions.push(eq2(integrationRuns.subscriptionId, subscriptionId));
     }
     if (this.multiTenant) {
-      conditions.push(eq2(syncRuns.tenantId, tenantId));
+      conditions.push(eq2(integrationRuns.tenantId, tenantId));
     }
     const where = conditions.length === 0 ? void 0 : conditions.length === 1 ? conditions[0] : and2(...conditions);
     const rows = await this.db.select({
-      id: syncRuns.id,
-      subscriptionId: syncRuns.subscriptionId,
-      integrationId: syncSubscriptions.integrationId,
-      status: syncRuns.status,
-      startedAt: syncRuns.startedAt,
-      completedAt: syncRuns.completedAt,
-      recordsProcessed: syncRuns.recordsProcessed,
-      tenantId: syncRuns.tenantId
-    }).from(syncRuns).innerJoin(
-      syncSubscriptions,
-      eq2(syncRuns.subscriptionId, syncSubscriptions.id)
-    ).where(where).orderBy(desc2(syncRuns.startedAt)).limit(limit);
+      id: integrationRuns.id,
+      subscriptionId: integrationRuns.subscriptionId,
+      connectionId: integrationSubscriptions.connectionId,
+      status: integrationRuns.status,
+      startedAt: integrationRuns.startedAt,
+      completedAt: integrationRuns.completedAt,
+      recordsProcessed: integrationRuns.recordsProcessed,
+      tenantId: integrationRuns.tenantId
+    }).from(integrationRuns).innerJoin(
+      integrationSubscriptions,
+      eq2(integrationRuns.subscriptionId, integrationSubscriptions.id)
+    ).where(where).orderBy(desc2(integrationRuns.startedAt)).limit(limit);
     return rows.map((row) => ({
       id: row.id,
       subscriptionId: row.subscriptionId,
-      integrationId: row.integrationId,
+      connectionId: row.connectionId,
       status: row.status,
       startedAt: row.startedAt,
       completedAt: row.completedAt,
@@ -1960,7 +1960,7 @@ var DrizzleSyncRunRecorder = class {
     }));
   }
   async completeRun(runId, input) {
-    await this.db.update(syncRuns).set({
+    await this.db.update(integrationRuns).set({
       status: input.status,
       recordsFound: input.recordsFound,
       recordsProcessed: input.recordsProcessed,
@@ -1968,27 +1968,27 @@ var DrizzleSyncRunRecorder = class {
       durationMs: input.durationMs,
       error: input.error ?? null,
       completedAt: /* @__PURE__ */ new Date()
-    }).where(eq2(syncRuns.id, runId));
+    }).where(eq2(integrationRuns.id, runId));
   }
 };
-DrizzleSyncRunRecorder = __decorateClass([
+DrizzleIntegrationRunRecorder = __decorateClass([
   Injectable6(),
   __decorateParam(0, Inject3(DRIZZLE)),
   __decorateParam(1, Optional3()),
-  __decorateParam(1, Inject3(SYNC_MULTI_TENANT))
-], DrizzleSyncRunRecorder);
+  __decorateParam(1, Inject3(INTEGRATION_MULTI_TENANT))
+], DrizzleIntegrationRunRecorder);
 
-// runtime/subsystems/sync/sync.module.ts
+// runtime/subsystems/integration/integration.module.ts
 import { Module } from "@nestjs/common";
-var SyncModule = class {
+var IntegrationModule = class {
   static forRoot(options) {
     const multiTenant = options.multiTenant ?? false;
     const sharedProviders = [
-      { provide: SYNC_MODULE_OPTIONS, useValue: options },
-      { provide: SYNC_MULTI_TENANT, useValue: multiTenant },
+      { provide: INTEGRATION_MODULE_OPTIONS, useValue: options },
+      { provide: INTEGRATION_MULTI_TENANT, useValue: multiTenant },
       // Default differ — consumers can override by binding a different
-      // `IFieldDiffer<T>` to `SYNC_FIELD_DIFFER` in their feature module.
-      { provide: SYNC_FIELD_DIFFER, useValue: new DeepEqualDiffer() }
+      // `IFieldDiffer<T>` to `INTEGRATION_FIELD_DIFFER` in their feature module.
+      { provide: INTEGRATION_FIELD_DIFFER, useValue: new DeepEqualDiffer() }
     ];
     const backendProviders = options.backend === "memory" ? [
       // Wired as singletons via `useValue` so tests can pull
@@ -1996,38 +1996,38 @@ var SyncModule = class {
       // direct assertions. Matches JOB-4 / MemoryJobStore shape.
       { provide: MemoryCursorStore, useValue: new MemoryCursorStore() },
       {
-        provide: SYNC_CURSOR_STORE,
+        provide: INTEGRATION_CURSOR_STORE,
         useExisting: MemoryCursorStore
       },
       { provide: MemoryRunRecorder, useValue: new MemoryRunRecorder() },
       {
-        provide: SYNC_RUN_RECORDER,
+        provide: INTEGRATION_RUN_RECORDER,
         useExisting: MemoryRunRecorder
       }
     ] : [
       // Drizzle backends — injected with DRIZZLE (provided by the
-      // consumer's DrizzleModule) + the SYNC_MULTI_TENANT flag
+      // consumer's DrizzleModule) + the INTEGRATION_MULTI_TENANT flag
       // we bound above.
-      { provide: SYNC_CURSOR_STORE, useClass: PostgresCursorStore },
-      { provide: SYNC_RUN_RECORDER, useClass: DrizzleSyncRunRecorder }
+      { provide: INTEGRATION_CURSOR_STORE, useClass: PostgresCursorStore },
+      { provide: INTEGRATION_RUN_RECORDER, useClass: DrizzleIntegrationRunRecorder }
     ];
     return {
-      module: SyncModule,
+      module: IntegrationModule,
       global: true,
       providers: [...sharedProviders, ...backendProviders],
       exports: [
-        SYNC_MODULE_OPTIONS,
-        SYNC_MULTI_TENANT,
-        SYNC_FIELD_DIFFER,
-        SYNC_CURSOR_STORE,
-        SYNC_RUN_RECORDER
+        INTEGRATION_MODULE_OPTIONS,
+        INTEGRATION_MULTI_TENANT,
+        INTEGRATION_FIELD_DIFFER,
+        INTEGRATION_CURSOR_STORE,
+        INTEGRATION_RUN_RECORDER
       ]
     };
   }
 };
-SyncModule = __decorateClass([
+IntegrationModule = __decorateClass([
   Module({})
-], SyncModule);
+], IntegrationModule);
 
 // src/schema/entity-definition.schema.ts
 var FieldTypeSchema = z3.enum([
@@ -2335,21 +2335,21 @@ var AnyQueryDeclarationSchema = z3.union([
   SearchQueryDeclarationSchema,
   QueryDeclarationSchema
 ]);
-var SyncDirectionSchema = z3.enum([
+var IntegrationDirectionSchema = z3.enum([
   "inbound",
   "outbound",
   "bidirectional"
 ]);
-var ProviderSyncSchema = z3.object({
+var ProviderIntegrationSchema = z3.object({
   remote_entity: z3.string(),
-  direction: SyncDirectionSchema,
+  direction: IntegrationDirectionSchema,
   cdc: z3.boolean().optional().default(false),
   field_mapping: z3.record(z3.string(), z3.string()).optional(),
   read_only_fields: z3.array(z3.string()).optional()
 });
-var SyncConfigSchema = z3.object({
+var IntegrationConfigSchema = z3.object({
   electric: z3.boolean().optional().default(false),
-  providers: z3.record(z3.string(), ProviderSyncSchema).optional()
+  providers: z3.record(z3.string(), ProviderIntegrationSchema).optional()
 });
 var EventDeclarationSchema = z3.object({
   name: z3.string().regex(/^[a-z][a-z0-9_]*$/, "Event name must be snake_case"),
@@ -2449,20 +2449,20 @@ var EntityDefinitionSchema = z3.object({
   // v2: Declarative query generation (ADR-005)
   // Generates repository + service + use case methods from declarations
   queries: z3.array(AnyQueryDeclarationSchema).optional(),
-  // v2: Integration sync configuration (CODEGEN-EVOLUTION-PLAN Phase 2)
-  // Electric SQL + provider sync (Salesforce, HubSpot, etc.)
-  sync: SyncConfigSchema.optional(),
+  // v2: Integration integration configuration (CODEGEN-EVOLUTION-PLAN Phase 2)
+  // Electric SQL + provider integration (Salesforce, HubSpot, etc.)
+  integration: IntegrationConfigSchema.optional(),
   // ADR-033.1: Provider-keyed change-source detection.
   //
   // Map of provider name → DetectionConfig. Single-provider entities use
   // a one-key map; multi-provider entities list each provider as a
   // separate key. Each value is an independent `DetectionConfig` (its
   // own mode/cursor/mapping/filters) sourced from the canonical schema
-  // in `runtime/subsystems/sync` so this validator and the runtime
+  // in `runtime/subsystems/integration` so this validator and the runtime
   // parser stay in lockstep.
   //
   // Within-file cross-check (ADR-033.1 §6): every key here must also
-  // appear in `sync.providers` — see the superRefine on
+  // appear in `integration.providers` — see the superRefine on
   // `EntityDefinitionSchema` below.
   detection: z3.record(z3.string(), DetectionConfigSchema).optional(),
   // v2: Domain event declarations (CODEGEN-EVOLUTION-PLAN Phase 2)
@@ -2492,13 +2492,13 @@ var EntityDefinitionSchema = z3.object({
   }
 ).superRefine((entity, ctx) => {
   if (!entity.detection) return;
-  const declared = new Set(Object.keys(entity.sync?.providers ?? {}));
+  const declared = new Set(Object.keys(entity.integration?.providers ?? {}));
   for (const provider of Object.keys(entity.detection)) {
     if (!declared.has(provider)) {
       ctx.addIssue({
         code: "custom",
         path: ["detection", provider],
-        message: `Provider '${provider}' used in detection: but not declared in sync.providers. Known providers: ${[...declared].join(", ")}`
+        message: `Provider '${provider}' used in detection: but not declared in integration.providers. Known providers: ${[...declared].join(", ")}`
       });
     }
   }
@@ -3182,14 +3182,14 @@ function transformToEntity(result) {
       entity.relationships.set(name, relationship);
     }
   }
-  if (definition.sync) {
-    const syncDef = definition.sync;
-    const parsedSync = {
-      electric: syncDef.electric ?? false
+  if (definition.integration) {
+    const integrationDef = definition.integration;
+    const parsedIntegration = {
+      electric: integrationDef.electric ?? false
     };
-    if (syncDef.providers) {
-      parsedSync.providers = {};
-      for (const [providerName, providerDef] of Object.entries(syncDef.providers)) {
+    if (integrationDef.providers) {
+      parsedIntegration.providers = {};
+      for (const [providerName, providerDef] of Object.entries(integrationDef.providers)) {
         const parsedProvider = {
           remoteEntity: providerDef.remote_entity,
           direction: providerDef.direction,
@@ -3201,10 +3201,10 @@ function transformToEntity(result) {
         if (providerDef.read_only_fields) {
           parsedProvider.readOnlyFields = providerDef.read_only_fields;
         }
-        parsedSync.providers[providerName] = parsedProvider;
+        parsedIntegration.providers[providerName] = parsedProvider;
       }
     }
-    entity.sync = parsedSync;
+    entity.integration = parsedIntegration;
   }
   if (definition.events) {
     entity.events = definition.events.map((ev) => ({
@@ -3833,8 +3833,8 @@ function checkConsistency(graph) {
     if (entity.queries !== void 0) {
       issues.push(...checkQueryFieldReferences(entity));
     }
-    if (entity.sync !== void 0) {
-      issues.push(...checkSyncFieldMappingReferences(entity));
+    if (entity.integration !== void 0) {
+      issues.push(...checkIntegrationFieldMappingReferences(entity));
       issues.push(...checkExternalIdTrackingCollision(entity));
     }
   }
@@ -4070,19 +4070,19 @@ function checkQueryFieldReferences(entity) {
   }
   return issues;
 }
-function checkSyncFieldMappingReferences(entity) {
+function checkIntegrationFieldMappingReferences(entity) {
   const issues = [];
   const availableFields = getAvailableFieldNames(entity);
   const availableSet = new Set(availableFields);
-  for (const [providerName, provider] of Object.entries(entity.sync?.providers ?? {})) {
+  for (const [providerName, provider] of Object.entries(entity.integration?.providers ?? {})) {
     for (const fieldName of Object.keys(provider.fieldMapping ?? {})) {
       if (!availableSet.has(fieldName)) {
         issues.push({
           severity: "warning",
-          type: "unknown_sync_field_mapping",
+          type: "unknown_integration_field_mapping",
           entity: entity.name,
           field: fieldName,
-          message: `Sync field mapping references unknown field "${fieldName}" for provider "${providerName}" in entity "${entity.name}"`
+          message: `Integration field mapping references unknown field "${fieldName}" for provider "${providerName}" in entity "${entity.name}"`
         });
       }
     }
@@ -4090,10 +4090,10 @@ function checkSyncFieldMappingReferences(entity) {
       if (!availableSet.has(fieldName)) {
         issues.push({
           severity: "warning",
-          type: "unknown_sync_field_mapping",
+          type: "unknown_integration_field_mapping",
           entity: entity.name,
           field: fieldName,
-          message: `Sync field mapping references unknown field "${fieldName}" for provider "${providerName}" in entity "${entity.name}"`
+          message: `Integration field mapping references unknown field "${fieldName}" for provider "${providerName}" in entity "${entity.name}"`
         });
       }
     }
@@ -4104,14 +4104,14 @@ function checkExternalIdTrackingCollision(entity) {
   const issues = [];
   const hasExternalIdTracking = entity.behaviors.includes("external_id_tracking");
   if (!hasExternalIdTracking) return issues;
-  for (const [providerName, provider] of Object.entries(entity.sync?.providers ?? {})) {
+  for (const [providerName, provider] of Object.entries(entity.integration?.providers ?? {})) {
     if (provider.fieldMapping && "external_id" in provider.fieldMapping) {
       issues.push({
         severity: "warning",
         type: "external_id_tracking_collision",
         entity: entity.name,
         field: "external_id",
-        message: `Entity "${entity.name}" has external_id_tracking behavior and also maps "external_id" in sync field_mapping for provider "${providerName}". The behavior-added field may collide with the mapped field.`
+        message: `Entity "${entity.name}" has external_id_tracking behavior and also maps "external_id" in integration field_mapping for provider "${providerName}". The behavior-added field may collide with the mapped field.`
       });
     }
   }
@@ -5489,30 +5489,30 @@ var MetadataPattern = definePattern({
   description: "History-tracked metadata rows \u2014 entity-id + type scoped lookups"
 });
 
-// src/patterns/library/synced.pattern.ts
-var SyncedPattern = definePattern({
-  name: "Synced",
+// src/patterns/library/integrated.pattern.ts
+var IntegratedPattern = definePattern({
+  name: "Integrated",
   extends: ["Base"],
-  repositoryClass: "SyncedEntityRepository",
-  serviceClass: "SyncedEntityService",
-  repositoryImport: "@shared/base-classes/synced-entity-repository",
-  serviceImport: "@shared/base-classes/synced-entity-service",
+  repositoryClass: "IntegratedEntityRepository",
+  serviceClass: "IntegratedEntityService",
+  repositoryImport: "@shared/base-classes/integrated-entity-repository",
+  serviceImport: "@shared/base-classes/integrated-entity-service",
   repositoryInheritedMethods: [
     "findById, findByIds, list, count, exists, create, update, delete, upsertMany",
     "findByExternalId, findManyByExternalIds, findAllByUserId, findVisibleByUserId",
-    "syncUpsertOne, findByExternalIdProjected, softDeleteByExternalId, syncUpsert"
+    "integrationUpsertOne, findByExternalIdProjected, softDeleteByExternalId, integrationUpsert"
   ],
   serviceInheritedMethods: [
     "findById, findByIds, list, count, exists, create, update, delete",
     "findByExternalId, findAllByUserId, findVisibleByUserId"
   ],
   impliedBehaviors: ["external_id_tracking"],
-  description: "External CRM/system sync columns and syncUpsert methods"
+  description: "External CRM/system integration columns and integrationUpsert methods"
 });
 
 // src/patterns/library/index.ts
 registerLibraryPattern(BasePattern);
-registerLibraryPattern(SyncedPattern);
+registerLibraryPattern(IntegratedPattern);
 registerLibraryPattern(ActivityPattern);
 registerLibraryPattern(KnowledgePattern);
 registerLibraryPattern(MetadataPattern);
@@ -5953,8 +5953,8 @@ var SUBSYSTEMS = [
     defaultBackend: "local"
   },
   {
-    name: "sync",
-    description: "External-system sync engine (IChangeSource<T> + orchestrator + audit log)",
+    name: "integration",
+    description: "External-system integration engine (IChangeSource<T> + orchestrator + audit log)",
     backends: ["drizzle", "memory"],
     defaultBackend: "drizzle"
   },
@@ -5977,7 +5977,7 @@ var SUBSYSTEMS = [
   {
     // OBS-7 / ADR-025. Combiner subsystem — no schema, no worker, no
     // generated/ dir. `ObservabilityModule` composes sibling read ports
-    // (events/jobs/bridge/sync) via @Optional() DI. The `combiner`
+    // (events/jobs/bridge/integration) via @Optional() DI. The `combiner`
     // pseudo-backend is parallel to `openapi-config`'s `config-only`.
     name: "observability",
     description: "Observability combiner \u2014 composes sibling read ports via @Optional() DI (ADR-025)",
@@ -5999,14 +5999,14 @@ var SUBSYSTEMS = [
   {
     // #287. Auth-integrations starter (PR #290) — vendored from
     // `examples/auth-integrations/`, NOT from `runtime/subsystems/`.
-    // Bundles a canonical `integration` entity yaml + the three
-    // integration-store-port adapters + the `IntegrationsService`
+    // Bundles a canonical `connection` entity yaml + the three
+    // connection-store-port adapters + the `ConnectionsService`
     // facade. Single-backend (drizzle); the runtime adapters call
-    // directly into the codegen-emitted `IntegrationService` from the
+    // directly into the codegen-emitted `ConnectionService` from the
     // entity layer. Detection: presence of
-    // `<sharedRoot>/integrations/integrations-auth.module.ts`.
+    // `<vendorRoot>/connections/connections-auth.module.ts`.
     name: "auth-integrations",
-    description: "Vendored integrations entity + adapters (consumes auth subsystem)",
+    description: "Vendored connection entity + adapters (consumes auth subsystem)",
     backends: ["drizzle"],
     defaultBackend: "drizzle"
   }
@@ -6017,7 +6017,7 @@ var SUBSYSTEM_MODULE_FILE = {
   jobs: "jobs-domain.module.ts",
   cache: "cache.module.ts",
   storage: "storage.module.ts",
-  sync: "sync.module.ts",
+  integration: "integration.module.ts",
   bridge: "bridge.module.ts",
   observability: "observability.module.ts",
   auth: "auth.module.ts"
@@ -6099,11 +6099,8 @@ async function detectSubsystemStatesImpl(ctx) {
     const pathsAny = ctx.config?.paths;
     const modulesConfigured = pathsAny?.modules_dir;
     const vendorRoot = typeof modulesConfigured === "string" && modulesConfigured.length > 0 ? path6.resolve(ctx.cwd, modulesConfigured) : path6.resolve(ctx.cwd, backendSrc, "modules");
-    const sharedConfigured = pathsAny?.shared;
-    const sharedRoot = typeof sharedConfigured === "string" && sharedConfigured.length > 0 ? path6.resolve(ctx.cwd, sharedConfigured) : path6.resolve(ctx.cwd, backendSrc, "shared");
     const candidates = [
-      path6.join(vendorRoot, "integrations", "integrations-auth.module.ts"),
-      path6.join(sharedRoot, "integrations", "integrations-auth.module.ts")
+      path6.join(vendorRoot, "connections", "connections-auth.module.ts")
     ];
     for (const moduleFile of candidates) {
       if (fs4.existsSync(moduleFile)) {
@@ -6217,24 +6214,24 @@ var COMPOSERS = {
       ]
     };
   },
-  sync: ({ subsystemsRel, cfg }) => {
+  integration: ({ subsystemsRel, cfg }) => {
     const backend = cfg?.backend ?? "drizzle";
     const multiTenant = Boolean(cfg?.multi_tenant);
     return {
       imports: [
-        `import { SyncModule } from '${subsystemsRel}/sync/sync.module';`
+        `import { IntegrationModule } from '${subsystemsRel}/integration/integration.module';`
       ],
       calls: [
-        `	SyncModule.forRoot(${quoteOpts({ backend, multiTenant })}),`
+        `	IntegrationModule.forRoot(${quoteOpts({ backend, multiTenant })}),`
       ]
     };
   }
 };
-var COMPOSABLE_ORDER = ["events", "jobs", "bridge", "sync"];
+var COMPOSABLE_ORDER = ["events", "jobs", "bridge", "integration"];
 var HEADER3 = `// AUTO-GENERATED by @pattern-stack/codegen. DO NOT EDIT.
 // Subsystem composition barrel \u2014 reflects \`subsystems.install\` in
 // codegen.config.yaml and the per-subsystem option blocks
-// (\`events:\`, \`jobs:\`, \`bridge:\`, \`sync:\`).
+// (\`events:\`, \`jobs:\`, \`bridge:\`, \`integration:\`).
 //
 // Wire into AppModule once:
 //
@@ -8627,22 +8624,22 @@ function localsToHygenArgs2(locals) {
   ];
 }
 
-// src/cli/shared/sync-scaffold-locals.ts
+// src/cli/shared/integration-scaffold-locals.ts
 import path16 from "path";
-function resolveSyncScaffoldLocals(input) {
+function resolveIntegrationScaffoldLocals(input) {
   const { cwd, config } = input;
   void input.fileExists;
-  const syncBlock = config?.sync ?? {};
+  const integrationBlock = config?.integration ?? {};
   const subsystemsRoot = resolveSubsystemsRootFromConfig(cwd, config);
   const configPath = path16.resolve(cwd, "codegen.config.yaml");
   const schemaPath = path16.resolve(
     subsystemsRoot,
-    "sync",
-    "sync-audit.schema.ts"
+    "integration",
+    "integration-audit.schema.ts"
   );
   return {
     appName: path16.basename(cwd),
-    multiTenant: normaliseMultiTenant3(syncBlock.multi_tenant),
+    multiTenant: normaliseMultiTenant3(integrationBlock.multi_tenant),
     configPath,
     schemaPath
   };
@@ -8781,19 +8778,16 @@ function localsToHygenArgs6(locals) {
 // src/cli/shared/auth-integrations-scaffold-locals.ts
 import path20 from "path";
 var FALLBACK_BACKEND_SRC4 = "src";
-var SHARED_DIR_NAME = "shared";
 var DEFAULT_MODULES_DIR = "modules";
 var DEFAULT_DEFINITIONS_DIR = "definitions/entities";
 function resolveAuthIntegrationsScaffoldLocals(input) {
   const { cwd, config } = input;
   const backendSrc = typeof config?.paths?.backend_src === "string" && config.paths.backend_src.length > 0 ? config.paths.backend_src : FALLBACK_BACKEND_SRC4;
   const pathsAny = config?.paths;
-  const sharedConfigured = pathsAny?.shared;
-  const sharedRoot = typeof sharedConfigured === "string" && sharedConfigured.length > 0 ? path20.resolve(cwd, sharedConfigured) : path20.resolve(cwd, backendSrc, SHARED_DIR_NAME);
   const modulesConfigured = pathsAny?.modules_dir;
   const vendorRoot = typeof modulesConfigured === "string" && modulesConfigured.length > 0 ? path20.resolve(cwd, modulesConfigured) : path20.resolve(cwd, backendSrc, DEFAULT_MODULES_DIR);
   const entitiesConfigured = typeof pathsAny?.entities === "string" && pathsAny.entities.length > 0 ? pathsAny.entities : typeof pathsAny?.entities_dir === "string" && pathsAny.entities_dir.length > 0 ? pathsAny.entities_dir : null;
-  const definitionsPath = entitiesConfigured !== null ? path20.resolve(cwd, entitiesConfigured, "integration.yaml") : path20.resolve(cwd, DEFAULT_DEFINITIONS_DIR, "integration.yaml");
+  const definitionsPath = entitiesConfigured !== null ? path20.resolve(cwd, entitiesConfigured, "connection.yaml") : path20.resolve(cwd, DEFAULT_DEFINITIONS_DIR, "connection.yaml");
   const appModulePath = path20.resolve(cwd, backendSrc, "app.module.ts");
   let authModuleRegistered = false;
   const appModuleSource = input.readFile(appModulePath);
@@ -8803,7 +8797,6 @@ function resolveAuthIntegrationsScaffoldLocals(input) {
   return {
     appName: path20.basename(cwd),
     appModulePath,
-    sharedRoot,
     vendorRoot,
     definitionsPath,
     authModuleRegistered
@@ -9002,7 +8995,7 @@ function backendFileFilter(backend, subsystemName) {
     if (subsystemName === "events" && file === "domain-events.schema.ts") {
       return false;
     }
-    if (subsystemName === "sync" && file === "sync-audit.schema.ts") {
+    if (subsystemName === "integration" && file === "integration-audit.schema.ts") {
       return false;
     }
     if (subsystemName === "auth" && file === "auth-oauth-state.schema.ts") {
@@ -9126,7 +9119,7 @@ var SubsystemInstallCommand = class extends Command3 {
       json: isJsonMode(),
       forceConfig: this.forceConfig
     }) : null;
-    const syncScaffold = desc3.name === "sync" ? runSyncScaffold(ctx.cwd, ctx.config, {
+    const integrationScaffold = desc3.name === "integration" ? runIntegrationScaffold(ctx.cwd, ctx.config, {
       dryRun: this.dryRun,
       json: isJsonMode(),
       forceConfig: this.forceConfig
@@ -9158,9 +9151,9 @@ var SubsystemInstallCommand = class extends Command3 {
       );
       return 1;
     }
-    if (syncScaffold?.configBlockOutcome === "parse-error") {
+    if (integrationScaffold?.configBlockOutcome === "parse-error") {
       printError(
-        "codegen.config.yaml is not valid YAML: refusing to inject sync config block. Fix the YAML and re-run."
+        "codegen.config.yaml is not valid YAML: refusing to inject integration config block. Fix the YAML and re-run."
       );
       return 1;
     }
@@ -9198,7 +9191,7 @@ var SubsystemInstallCommand = class extends Command3 {
         },
         ...jobsScaffold ? { scaffold: jobsScaffold } : {},
         ...eventsScaffold ? { scaffold: eventsScaffold } : {},
-        ...syncScaffold ? { scaffold: syncScaffold } : {},
+        ...integrationScaffold ? { scaffold: integrationScaffold } : {},
         ...bridgeScaffold ? { scaffold: bridgeScaffold } : {},
         ...observabilityScaffold ? { scaffold: observabilityScaffold } : {},
         ...authScaffold ? { scaffold: authScaffold } : {}
@@ -9226,11 +9219,11 @@ var SubsystemInstallCommand = class extends Command3 {
           console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
-      if (syncScaffold?.planned?.length) {
+      if (integrationScaffold?.planned?.length) {
         printInfo(
-          `Sync scaffold \u2014 ${syncScaffold.planned.length} template targets`
+          `Integration scaffold \u2014 ${integrationScaffold.planned.length} template targets`
         );
-        for (const p of syncScaffold.planned) {
+        for (const p of integrationScaffold.planned) {
           console.log(`  ${theme.muted(icons.arrow)} ${path22.relative(ctx.cwd, p) || p}`);
         }
       }
@@ -9289,14 +9282,14 @@ var SubsystemInstallCommand = class extends Command3 {
         );
       }
     }
-    if (syncScaffold) {
-      if (syncScaffold.ok) {
+    if (integrationScaffold) {
+      if (integrationScaffold.ok) {
         printSuccess(
-          `sync scaffold applied (config block, schema)`
+          `integration scaffold applied (config block, schema)`
         );
       } else {
         printWarning(
-          `sync scaffold (Hygen) failed \u2014 runtime files were written; re-run after fixing: ${syncScaffold.error ?? "unknown error"}`
+          `integration scaffold (Hygen) failed \u2014 runtime files were written; re-run after fixing: ${integrationScaffold.error ?? "unknown error"}`
         );
       }
     }
@@ -9343,7 +9336,7 @@ var SubsystemInstallCommand = class extends Command3 {
     }
     if (desc3.name === "observability") {
       printInfo(
-        "Register `ObservabilityModule.forRoot()` AFTER Events/Jobs/Bridge/Sync in app.module.ts"
+        "Register `ObservabilityModule.forRoot()` AFTER Events/Jobs/Bridge/Integration in app.module.ts"
       );
     } else if (desc3.name === "auth") {
       printInfo("auth subsystem installed.");
@@ -9357,9 +9350,9 @@ var SubsystemInstallCommand = class extends Command3 {
         `Register ${capitalize(desc3.name)}Module.forRoot({ backend: '${backend}' }) in your app.module.ts`
       );
     }
-    if (desc3.name === "sync") {
+    if (desc3.name === "integration") {
       printInfo(
-        `Per-entity: register ExecuteSyncUseCase + your IChangeSource/ISyncSink bindings in a feature module (see SyncModule docstring).`
+        `Per-entity: register ExecuteIntegrationUseCase + your IChangeSource/IIntegrationSink bindings in a feature module (see IntegrationModule docstring).`
       );
     }
     return 0;
@@ -9372,7 +9365,7 @@ var SubsystemInstallCommand = class extends Command3 {
    * `codegen project init`. This method just invokes the
    * `subsystem/openapi-config` Hygen action to inject the `openapi:`
    * block into `codegen.config.yaml`, honoring the same `--force-config`
-   * semantics as jobs/events/sync/bridge.
+   * semantics as jobs/events/integration/bridge.
    */
   async executeOpenApiConfig(ctx) {
     const configPath = path22.join(ctx.cwd, "codegen.config.yaml");
@@ -9435,9 +9428,9 @@ var SubsystemInstallCommand = class extends Command3 {
    *
    * Source is `examples/auth-integrations/`, NOT `runtime/subsystems/`,
    * so this method short-circuits the `copyRuntime` flow. It vendors the
-   * adapters tree + the canonical `integration.yaml`, then invokes the
+   * adapters tree + the canonical `connection.yaml`, then invokes the
    * `subsystem auth-integrations` Hygen action to append the
-   * `IntegrationsAuthModule` TODO to `app.module.ts`.
+   * `ConnectionsAuthModule` TODO to `app.module.ts`.
    *
    * Idempotent: pre-existing files are skipped unless `--force` is set.
    */
@@ -9485,7 +9478,7 @@ var SubsystemInstallCommand = class extends Command3 {
     }
     if (this.dryRun) {
       printInfo(
-        `Dry run \u2014 auth-integrations would vendor adapters + integration.yaml + append TODO`
+        `Dry run \u2014 auth-integrations would vendor adapters + connection.yaml + append TODO`
       );
       for (const p of scaffold.planned) {
         console.log(
@@ -9501,14 +9494,14 @@ var SubsystemInstallCommand = class extends Command3 {
     );
     if (scaffold.authModuleRegistered === false) {
       printWarning(
-        "AuthModule.forRoot(...) not detected in app.module.ts. Run `cdp subsystem install auth` first \u2014 IntegrationsAuthModule requires ENCRYPTION_KEY from it."
+        "AuthModule.forRoot(...) not detected in app.module.ts. Run `cdp subsystem install auth` first \u2014 ConnectionsAuthModule requires ENCRYPTION_KEY from it."
       );
     }
     printInfo("auth-integrations starter vendored.");
     printInfo("Next steps:");
-    printInfo("  1. Run `cdp entity new integration` to scaffold the codegen layer (apps/api/src/modules/integrations/integration.service) the adapters import.");
+    printInfo("  1. Run `cdp entity new connection` to scaffold the codegen layer (apps/api/src/modules/connections/connection.service) the adapters import.");
     printInfo("  2. Ensure AuthModule.forRoot(...) is registered in AppModule (run `cdp subsystem install auth` if not).");
-    printInfo("  3. Wire IntegrationsAuthModule into AppModule (see TODO appended to app.module.ts).");
+    printInfo("  3. Wire ConnectionsAuthModule into AppModule (see TODO appended to app.module.ts).");
     return 0;
   }
 };
@@ -9689,8 +9682,8 @@ function runEventsScaffold(cwd, config, opts) {
   }
   return { ok: true, planned, configBlockOutcome };
 }
-function runSyncScaffold(cwd, config, opts) {
-  const locals = resolveSyncScaffoldLocals({
+function runIntegrationScaffold(cwd, config, opts) {
+  const locals = resolveIntegrationScaffoldLocals({
     cwd,
     config,
     fileExists: (p) => fs11.existsSync(p)
@@ -9701,7 +9694,7 @@ function runSyncScaffold(cwd, config, opts) {
   ];
   const configBlockOutcome = planConfigBlockAction(
     locals.configPath,
-    "sync",
+    "integration",
     opts.forceConfig
   );
   if (configBlockOutcome === "parse-error") {
@@ -9712,7 +9705,7 @@ function runSyncScaffold(cwd, config, opts) {
   }
   const result = invokeHygen({
     generator: "subsystem",
-    action: "sync",
+    action: "integration",
     cwd,
     args: localsToHygenArgs3(locals),
     // Suppress Hygen stdout in JSON mode so it doesn't corrupt the JSON output.
@@ -9728,9 +9721,9 @@ function runSyncScaffold(cwd, config, opts) {
   }
   const configResult = runConfigBlockAction({
     cwd,
-    actionFolder: "sync-config",
+    actionFolder: "integration-config",
     configPath: locals.configPath,
-    subsystem: "sync",
+    subsystem: "integration",
     outcome: configBlockOutcome,
     json: opts.json
   });
@@ -9981,18 +9974,18 @@ function runAuthIntegrationsScaffold(cwd, config, opts) {
       error: `auth-integrations starter source missing: ${examplesRoot}`
     };
   }
-  const adaptersSrc = path22.join(examplesRoot, "runtime", "integrations");
-  const adaptersDest = path22.join(locals.vendorRoot, "integrations");
-  const integrationYamlSrc = path22.join(
+  const adaptersSrc = path22.join(examplesRoot, "runtime", "connections");
+  const adaptersDest = path22.join(locals.vendorRoot, "connections");
+  const connectionYamlSrc = path22.join(
     examplesRoot,
     "definitions",
     "entities",
-    "integration.yaml"
+    "connection.yaml"
   );
-  const integrationYamlDest = locals.definitionsPath;
+  const connectionYamlDest = locals.definitionsPath;
   const planned = [
     adaptersDest,
-    integrationYamlDest,
+    connectionYamlDest,
     locals.appModulePath
   ];
   if (opts.dryRun) {
@@ -10012,18 +10005,18 @@ function runAuthIntegrationsScaffold(cwd, config, opts) {
   let yamlWritten = false;
   let yamlSkipped = false;
   try {
-    if (fs11.existsSync(integrationYamlDest) && !opts.force) {
+    if (fs11.existsSync(connectionYamlDest) && !opts.force) {
       yamlSkipped = true;
-    } else if (fs11.existsSync(integrationYamlSrc)) {
-      fs11.mkdirSync(path22.dirname(integrationYamlDest), { recursive: true });
-      fs11.copyFileSync(integrationYamlSrc, integrationYamlDest);
+    } else if (fs11.existsSync(connectionYamlSrc)) {
+      fs11.mkdirSync(path22.dirname(connectionYamlDest), { recursive: true });
+      fs11.copyFileSync(connectionYamlSrc, connectionYamlDest);
       yamlWritten = true;
     }
   } catch (err) {
     return {
       ok: false,
       planned,
-      error: `failed to vendor integration.yaml: ${err instanceof Error ? err.message : String(err)}`,
+      error: `failed to vendor connection.yaml: ${err instanceof Error ? err.message : String(err)}`,
       authModuleRegistered: locals.authModuleRegistered
     };
   }
@@ -10039,16 +10032,16 @@ function runAuthIntegrationsScaffold(cwd, config, opts) {
       ok: false,
       planned,
       error: result.stderr?.trim() || "hygen exited non-zero",
-      written: adapterCopy.written.concat(yamlWritten ? [integrationYamlDest] : []),
-      skipped: adapterCopy.skipped.concat(yamlSkipped ? [integrationYamlDest] : []),
+      written: adapterCopy.written.concat(yamlWritten ? [connectionYamlDest] : []),
+      skipped: adapterCopy.skipped.concat(yamlSkipped ? [connectionYamlDest] : []),
       authModuleRegistered: locals.authModuleRegistered
     };
   }
   return {
     ok: true,
     planned,
-    written: adapterCopy.written.concat(yamlWritten ? [integrationYamlDest] : []),
-    skipped: adapterCopy.skipped.concat(yamlSkipped ? [integrationYamlDest] : []),
+    written: adapterCopy.written.concat(yamlWritten ? [connectionYamlDest] : []),
+    skipped: adapterCopy.skipped.concat(yamlSkipped ? [connectionYamlDest] : []),
     authModuleRegistered: locals.authModuleRegistered
   };
 }
@@ -10151,7 +10144,7 @@ var SubsystemRemoveCommand = class extends Command3 {
         "auth-integrations is vendored under <modules>/integrations/ alongside the codegen-emitted entity layer \u2014 not auto-removable here."
       );
       printInfo(
-        "To uninstall: remove the integrations/ directory and the IntegrationsAuthModule registration from app.module.ts by hand."
+        "To uninstall: remove the integrations/ directory and the ConnectionsAuthModule registration from app.module.ts by hand."
       );
       return 1;
     }
@@ -10270,11 +10263,11 @@ var VENDORED_RUNTIME_FILES = [
   // Ambient tenant scope — imported by base-repository.ts (scopePredicate)
   { runtime: "base-classes/tenant-context.ts", target: "src/shared/base-classes/tenant-context.ts" },
   { runtime: "base-classes/base-service.ts", target: "src/shared/base-classes/base-service.ts" },
-  { runtime: "base-classes/synced-entity-repository.ts", target: "src/shared/base-classes/synced-entity-repository.ts" },
-  { runtime: "base-classes/synced-entity-service.ts", target: "src/shared/base-classes/synced-entity-service.ts" },
-  // Inbound-sync write surface (#374) — deps of synced/junction repos
-  { runtime: "base-classes/sync-upsert-config.ts", target: "src/shared/base-classes/sync-upsert-config.ts" },
-  { runtime: "base-classes/junction-sync-repository.ts", target: "src/shared/base-classes/junction-sync-repository.ts" },
+  { runtime: "base-classes/integrated-entity-repository.ts", target: "src/shared/base-classes/integrated-entity-repository.ts" },
+  { runtime: "base-classes/integrated-entity-service.ts", target: "src/shared/base-classes/integrated-entity-service.ts" },
+  // Inbound-integration write surface (#374) — deps of integrated/junction repos
+  { runtime: "base-classes/integration-upsert-config.ts", target: "src/shared/base-classes/integration-upsert-config.ts" },
+  { runtime: "base-classes/junction-integration-repository.ts", target: "src/shared/base-classes/junction-integration-repository.ts" },
   { runtime: "base-classes/activity-entity-repository.ts", target: "src/shared/base-classes/activity-entity-repository.ts" },
   { runtime: "base-classes/activity-entity-service.ts", target: "src/shared/base-classes/activity-entity-service.ts" },
   { runtime: "base-classes/metadata-entity-repository.ts", target: "src/shared/base-classes/metadata-entity-repository.ts" },
@@ -10539,7 +10532,7 @@ function exampleEntityYaml() {
 #
 # entity:
 #   name: account
-#   pattern: Synced       # Base | Synced | Activity | Metadata | Knowledge (or app-defined)
+#   pattern: Integrated   # Base | Integrated | Activity | Metadata | Knowledge (or app-defined)
 #
 # fields:
 #   name: