@pattern-stack/codegen 0.10.0 → 0.11.0

package/runtime/subsystems/observability/observability.protocol.ts

@@ -5,7 +5,7 @@
  * Every method:
  *   - Accepts an optional `tenantId`, passed VERBATIM to the owning sibling
  *     port. Observability never re-implements tenant filtering — that is
- *     the owning subsystem's job (jobs / bridge / sync). See
+ *     the owning subsystem's job (jobs / bridge / integration). See
  *     `.claude/skills/observability/SKILL.md` §3.
  *       - `undefined` — "not provided"; sibling default semantics apply.
  *       - `null`      — explicit cross-tenant match (sibling-specific).
@@ -32,8 +32,8 @@ import type {
   ListEventsQuery,
 } from '../events/event-read.protocol';
 import type { StatusHistogram } from '../bridge/bridge.protocol';
-import type { SyncRunSummary } from '../sync/sync-run-recorder.protocol';
-import type { CursorSnapshot } from '../sync/sync-cursor-store.protocol';
+import type { IntegrationRunSummary } from '../integration/integration-run-recorder.protocol';
+import type { CursorSnapshot } from '../integration/integration-cursor-store.protocol';
 
 /**
  * One chronological entry in a correlation timeline (OBS-LIST-1). Either a
@@ -98,22 +98,22 @@ export interface IObservability {
   ): Promise<StatusHistogram>;
 
   /**
-   * Recent `sync_runs` (optionally filtered by subscription). Delegates to
-   * `ISyncRunRecorder.listRecent`.
+   * Recent `integration_runs` (optionally filtered by subscription). Delegates to
+   * `IIntegrationRunRecorder.listRecent`.
    *
-   * Empty array when the sync subsystem is not installed.
+   * Empty array when the integration subsystem is not installed.
    */
-  getRecentSyncRuns(
+  getRecentIntegrationRuns(
     limit: number,
     subscriptionId?: string,
     tenantId?: string | null,
-  ): Promise<SyncRunSummary[]>;
+  ): Promise<IntegrationRunSummary[]>;
 
   /**
-   * Cursor state per enabled `sync_subscriptions` row. Delegates to
+   * Cursor state per enabled `integration_subscriptions` row. Delegates to
    * `ICursorStore.listAll`.
    *
-   * Empty array when the sync subsystem is not installed.
+   * Empty array when the integration subsystem is not installed.
    */
   getCursors(tenantId?: string | null): Promise<CursorSnapshot[]>;
 
@@ -163,6 +163,6 @@ export type {
   EventPage,
   ListEventsQuery,
   StatusHistogram,
-  SyncRunSummary,
+  IntegrationRunSummary,
   CursorSnapshot,
 };

package/runtime/subsystems/observability/observability.service.ts

@@ -2,7 +2,7 @@
  * ObservabilityService — `IObservability` combiner implementation
  * (ADR-025, OBS-5).
  *
- * Composes read methods across the jobs, bridge, and sync subsystems via
+ * Composes read methods across the jobs, bridge, and integration subsystems via
  * DI. Owns no state, no schema, no SQL. Every method is a one-line
  * delegation to the sibling port that already encodes the semantics.
  *
@@ -50,15 +50,15 @@ import type {
 import { BRIDGE_DELIVERY_REPO } from '../bridge/bridge.tokens';
 import type { IJobBridge, StatusHistogram } from '../bridge/bridge.protocol';
 
-import { SYNC_CURSOR_STORE, SYNC_RUN_RECORDER } from '../sync/sync.tokens';
+import { INTEGRATION_CURSOR_STORE, INTEGRATION_RUN_RECORDER } from '../integration/integration.tokens';
 import type {
-  ISyncRunRecorder,
-  SyncRunSummary,
-} from '../sync/sync-run-recorder.protocol';
+  IIntegrationRunRecorder,
+  IntegrationRunSummary,
+} from '../integration/integration-run-recorder.protocol';
 import type {
   CursorSnapshot,
   ICursorStore,
-} from '../sync/sync-cursor-store.protocol';
+} from '../integration/integration-cursor-store.protocol';
 
 import type {
   CorrelationTimeline,
@@ -106,10 +106,10 @@ export class ObservabilityService implements IObservability {
     @Inject(BRIDGE_DELIVERY_REPO)
     private readonly bridge?: IJobBridge,
     @Optional()
-    @Inject(SYNC_RUN_RECORDER)
-    private readonly syncRuns?: ISyncRunRecorder,
+    @Inject(INTEGRATION_RUN_RECORDER)
+    private readonly integrationRuns?: IIntegrationRunRecorder,
     @Optional()
-    @Inject(SYNC_CURSOR_STORE)
+    @Inject(INTEGRATION_CURSOR_STORE)
     private readonly cursors?: ICursorStore,
     @Optional()
     @Inject(EVENT_READ_PORT)
@@ -137,13 +137,13 @@ export class ObservabilityService implements IObservability {
     return this.bridge.getStatusHistogram(windowHours, tenantId);
   }
 
-  async getRecentSyncRuns(
+  async getRecentIntegrationRuns(
     limit: number,
     subscriptionId?: string,
     tenantId?: string | null,
-  ): Promise<SyncRunSummary[]> {
-    if (!this.syncRuns) return [];
-    return this.syncRuns.listRecent(limit, subscriptionId, tenantId);
+  ): Promise<IntegrationRunSummary[]> {
+    if (!this.integrationRuns) return [];
+    return this.integrationRuns.listRecent(limit, subscriptionId, tenantId);
   }
 
   async getCursors(tenantId?: string | null): Promise<CursorSnapshot[]> {

package/runtime/subsystems/observability/observability.tokens.ts

@@ -1,7 +1,7 @@
 /**
  * Observability combiner subsystem — DI tokens (ADR-025, OBS-5).
  *
- * String constants (not Symbols), matching the events / bridge / sync
+ * String constants (not Symbols), matching the events / bridge / integration
  * convention. The jobs subsystem uses Symbols for its analogous tokens;
  * observability stays internally consistent with its sibling combiner
  * (bridge) because the two are structurally paired (ADR-025).

package/src/patterns/library/index.ts

@@ -1,7 +1,7 @@
 /**
  * Library pattern bootstrap — imports every shipped pattern and registers
  * it with the shared library registry. Side-effect-only module: importing
- * this barrel is what pre-registers `Base`, `Synced`, `Activity`,
+ * this barrel is what pre-registers `Base`, `Integrated`, `Activity`,
  * `Knowledge`, and `Metadata`.
  *
  * Adding a new library pattern is two edits: create the `*.pattern.ts`
@@ -14,10 +14,10 @@ import { BasePattern } from './base.pattern.js';
 import { JunctionPattern } from './junction.pattern.js';
 import { KnowledgePattern } from './knowledge.pattern.js';
 import { MetadataPattern } from './metadata.pattern.js';
-import { SyncedPattern } from './synced.pattern.js';
+import { IntegratedPattern } from './integrated.pattern.js';
 
 registerLibraryPattern(BasePattern);
-registerLibraryPattern(SyncedPattern);
+registerLibraryPattern(IntegratedPattern);
 registerLibraryPattern(ActivityPattern);
 registerLibraryPattern(KnowledgePattern);
 registerLibraryPattern(MetadataPattern);
@@ -29,7 +29,7 @@ export {
 	JunctionPattern,
 	KnowledgePattern,
 	MetadataPattern,
-	SyncedPattern,
+	IntegratedPattern,
 };
 export {
 	BaseJunctionFields,

package/src/patterns/library/{synced.pattern.ts → integrated.pattern.ts}

@@ -1,35 +1,35 @@
 /**
- * SyncedPattern — adds external-system sync columns and methods.
+ * IntegratedPattern — adds external-system integration columns and methods.
  *
- * Replaces the legacy `family: synced` entry in
+ * Replaces the legacy `family: integrated` entry in
  * `templates/entity/new/clean-lite-ps/prompt-extension.js`. Class names,
  * import paths, and inherited-method comment lines are preserved verbatim
  * so PATTERN-5's template swap produces byte-identical output for
- * pre-existing `family: synced` fixtures.
+ * pre-existing `family: integrated` fixtures.
  *
  * Implies `external_id_tracking` — the behavior that contributes the
  * `external_id`, `provider`, and `provider_metadata` columns to the table.
- * An entity declaring `pattern: Synced` need not re-declare the behavior.
+ * An entity declaring `pattern: Integrated` need not re-declare the behavior.
  */
 
 import { definePattern } from '../pattern-definition.js';
 
-export const SyncedPattern = definePattern({
-	name: 'Synced',
+export const 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',
 });

package/src/patterns/library/junction.pattern.ts

@@ -2,7 +2,7 @@
  * JunctionPattern — top-level discriminator for explicit many-to-many
  * junction YAML files.
  *
- * Unlike `Activity` / `Synced` / `Metadata` (which attach to an entity via
+ * Unlike `Activity` / `Integrated` / `Metadata` (which attach to an entity via
  * `pattern:` / `patterns:`), `Junction` IS the top-level YAML shape — a
  * junction file's discriminator is `pattern: Junction`, not `entity:`.
  * It therefore does not declare `repositoryClass` / `serviceClass`: the

package/src/patterns/pattern-definition.ts

@@ -52,7 +52,7 @@ export type PatternKind = 'domain' | 'orchestration';
  * store these and look them up by `name`.
  */
 export interface PatternDefinition<TConfig = unknown> {
-	/** Unique name used in YAML — e.g. `pattern: Synced` */
+	/** Unique name used in YAML — e.g. `pattern: Integrated` */
 	name: string;
 
 	/**
@@ -65,7 +65,7 @@ export interface PatternDefinition<TConfig = unknown> {
 
 	/**
 	 * Built-in patterns this extends, by name. Phase 1 supports single-depth
-	 * chains only — a pattern may `extends: ['Synced']` but the transitive
+	 * chains only — a pattern may `extends: ['Integrated']` but the transitive
 	 * chain is not yet resolved. Multi-depth inheritance is deferred until
 	 * a real consumer asks.
 	 */
@@ -79,7 +79,7 @@ export interface PatternDefinition<TConfig = unknown> {
 	/**
 	 * Fully-qualified TypeScript path alias the consumer's tsconfig resolves.
 	 * Library patterns use the consumer-installed runtime base class path
-	 * (e.g. `@shared/base-classes/synced-entity-repository`); app patterns
+	 * (e.g. `@shared/base-classes/integrated-entity-repository`); app patterns
 	 * use whatever alias the consumer has configured (e.g. `@/patterns/...`).
 	 */
 	repositoryImport?: string;

package/templates/entity/new/backend/modules/core/{sync-source.ejs.t → integration-source.ejs.t}

@@ -1,17 +1,17 @@
 ---
-to: "<%= hasDetection ? (isCleanLitePs ? clpOutputPaths.syncSourceModule : `${basePaths.backendSrc}/${paths.modules}/${name}-sync-source.module.ts`) : null %>"
+to: "<%= hasDetection ? (isCleanLitePs ? clpOutputPaths.integrationSourceModule : `${basePaths.backendSrc}/${paths.modules}/${name}-integration-source.module.ts`) : null %>"
 skip_if: <%= !hasDetection %>
 force: true
 ---
 <%- typeof generatedBanner !== 'undefined' ? generatedBanner : '' %>
 import { Module } from '@nestjs/common';
-import { buildChangeSource } from '@shared/subsystems/sync';
+import { buildChangeSource } from '@shared/subsystems/integration';
 import type {
   DetectionConfig,
   IChangeSource,
   PollFetchCallback,
-} from '@shared/subsystems/sync';
-import type { <%= className %> } from '<%= isCleanLitePs ? clpImports.syncSourceToEntity : imports.moduleToDomain %>';
+} from '@shared/subsystems/integration';
+import type { <%= className %> } from '<%= isCleanLitePs ? clpImports.integrationSourceToEntity : imports.moduleToDomain %>';
 
 const <%= name.toUpperCase() %>_DETECTION_CONFIGS: Record<string, DetectionConfig> = <%- detectionConfigsLiteral %>;
 
@@ -31,7 +31,7 @@ export const <%= name.toUpperCase() %>_CHANGE_SOURCES = Symbol('<%= name.toUpper
             const fetch = fetches[provider];
             if (!fetch) {
               throw new Error(
-                `<%= className %>SyncSourceModule: missing fetch callback for provider '${provider}' in <%= name.toUpperCase() %>_POLL_FETCH_REGISTRY`,
+                `<%= className %>IntegrationSourceModule: missing fetch callback for provider '${provider}' in <%= name.toUpperCase() %>_POLL_FETCH_REGISTRY`,
               );
             }
             return [provider, buildChangeSource(cfg, fetch)];
@@ -41,4 +41,4 @@ export const <%= name.toUpperCase() %>_CHANGE_SOURCES = Symbol('<%= name.toUpper
   ],
   exports: [<%= name.toUpperCase() %>_CHANGE_SOURCES],
 })
-export class <%= className %>SyncSourceModule {}
+export class <%= className %>IntegrationSourceModule {}

package/templates/entity/new/backend/modules/core/{sync-source.providers.ejs.t → integration-source.providers.ejs.t}

@@ -1,11 +1,11 @@
 ---
-to: "<%= hasDetection ? (isCleanLitePs ? clpOutputPaths.syncSourceProviders : `${basePaths.backendSrc}/${paths.modules}/${name}-sync-source.providers.ts`) : null %>"
+to: "<%= hasDetection ? (isCleanLitePs ? clpOutputPaths.integrationSourceProviders : `${basePaths.backendSrc}/${paths.modules}/${name}-integration-source.providers.ts`) : null %>"
 skip_if: <%= !hasDetection %>
 force: true
 ---
 <%- typeof generatedBanner !== 'undefined' ? generatedBanner : '' %>
 /**
- * <%= className %> sync-source providers
+ * <%= className %> integration-source providers
  * Generated by entity codegen — do not edit directly.
  *
  * ADR-033.2: typed provider artifacts. Consumers type their registry as

package/templates/entity/new/clean-lite-ps/entity.ejs.t

@@ -67,7 +67,7 @@ export const <%= entityNamePlural %> = pgTable(
   },
 <%_ if (hasExternalIdTracking) { _%>
   (t) => [
-    // external_id_tracking behavior — ON CONFLICT target for syncUpsert
+    // external_id_tracking behavior — ON CONFLICT target for integrationUpsert
     uniqueIndex('uq_<%= entityNamePlural %>_provider_external_id').on(t.provider, t.externalId),
   ],
 <%_ } _%>

package/templates/entity/new/clean-lite-ps/module.ejs.t

@@ -116,7 +116,7 @@ import { <%= classNames.searchController %> } from './<%= entityName %>-search.c
   // exported so sibling modules that compose this entity cross-module (junction
   // `.list()`, EAV value→definition resolution) inject the home-module instance
   // — the only place the repo's own deps are wired (e.g. an EAV entity's repo
-  // injects FieldValueService for the #374 sync dual-write tx). Local-providing
+  // injects FieldValueService for the #374 integration dual-write tx). Local-providing
   // such a repo elsewhere can't satisfy those deps. Use-case internals stay unexported.
   exports: [<%= classNames.service %>, <%= classNames.repository %>],
 })

package/templates/entity/new/clean-lite-ps/prompt-extension.js

@@ -9,7 +9,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import pluralizePkg from 'pluralize';
 // The patterns barrel has the side effect of pre-registering the five
-// library-shipped patterns (Base / Synced / Activity / Knowledge /
+// library-shipped patterns (Base / Integrated / Activity / Knowledge /
 // Metadata). App-defined patterns are loaded separately in the parent
 // prompt.js via loadAppPatterns() against `codegen.config.yaml patterns:`
 // globs before this helper runs — we only read the registry here.
@@ -108,7 +108,7 @@ export function resolvePatternBaseClasses(entity) {
 /**
  * Resolve the behaviors implied by an entity's declared pattern(s).
  *
- * A pattern (e.g. `Synced`) may declare `impliedBehaviors` — behaviors the
+ * A pattern (e.g. `Integrated`) may declare `impliedBehaviors` — behaviors the
  * entity gets for free without re-declaring them in its `behaviors:` array.
  * Walks every declared pattern (both the `pattern: X` and `patterns: [...]`
  * shapes), unions their `impliedBehaviors`, and returns a deduped list.
@@ -475,7 +475,7 @@ function collectDrizzleImports(processedFields, belongsTo, hasTimestamps, hasSof
 
   // external_id_tracking behavior injects varchar + jsonb columns plus a
   // unique index over (provider, external_id) — the ON CONFLICT target the
-  // sync sink's syncUpsert relies on.
+  // integration sink's integrationUpsert relies on.
   if (hasExternalIdTracking) {
     imports.add('varchar');
     imports.add('jsonb');
@@ -725,16 +725,16 @@ function processSearchQueries(queriesBlock, processedFields, belongsTo, entityNa
 }
 
 // ============================================================================
-// Sync write-surface derivation (#374)
+// Integration write-surface derivation (#374)
 // ============================================================================
 
 /**
- * Pre-compute the inbound-sync write surface for a `pattern: Synced` entity.
- * Keeps the EJS thin + unit-testable: the template hand-emits the syncConfig
+ * Pre-compute the inbound-integration write surface for a `pattern: Integrated` entity.
+ * Keeps the EJS thin + unit-testable: the template hand-emits the integrationConfig
  * literal (so `refTable` can carry a LIVE Drizzle table handle, which
  * renderPatternConfigLiteral cannot express) using these locals.
  *
- * Returns null when the entity is not Synced.
+ * Returns null when the entity is not Integrated.
  *
  * @param {string} patternName     resolved pattern name
  * @param {object[]} processedFields  nonFkFields (camel + tsType + nullable)
@@ -743,8 +743,8 @@ function processSearchQueries(queriesBlock, processedFields, belongsTo, entityNa
  * @param {boolean} eavEnabled
  * @param {boolean} hasSoftDelete
  */
-export function buildSyncSurface(patternName, processedFields, belongsTo, hasTimestamps, eavEnabled, hasSoftDelete, fields) {
-  if (patternName !== 'Synced') return null;
+export function buildIntegrationSurface(patternName, processedFields, belongsTo, hasTimestamps, eavEnabled, hasSoftDelete, fields) {
+  if (patternName !== 'Integrated') return null;
 
   // Copy-through columns: every non-FK declared field. external_id_tracking
   // columns (external_id/provider/provider_metadata) are injected by the
@@ -782,10 +782,10 @@ export function buildSyncSurface(patternName, processedFields, belongsTo, hasTim
     ...(hasTimestamps ? ['createdAt', 'updatedAt'] : []),
   ];
 
-  // The syncConfig object literal the template hand-emits. fkResolvers carry a
+  // The integrationConfig object literal the template hand-emits. fkResolvers carry a
   // sentinel so the template can swap `refTable` to either 'self' or the live
   // table identifier.
-  const syncConfig = {
+  const integrationConfig = {
     conflictTarget: ['provider', 'externalId'],
     writeColumns,
     projectionColumns,
@@ -793,7 +793,7 @@ export function buildSyncSurface(patternName, processedFields, belongsTo, hasTim
     softDelete: !!hasSoftDelete,
   };
 
-  // TSyncWrite fields: externalId:string, copy-through (typed, nullable-aware),
+  // TIntegrationWrite fields: externalId:string, copy-through (typed, nullable-aware),
   // one `<writeKey>?: string | null` per FK, fields?: Record<string, unknown>.
   const writeFields = processedFields.map((f) => ({
     camelName: f.camelName,
@@ -804,7 +804,7 @@ export function buildSyncSurface(patternName, processedFields, belongsTo, hasTim
     tsType: 'string | null',
   }));
 
-  // TSyncProjection fields: id + externalId + copy-through (typed) + each local
+  // TIntegrationProjection fields: id + externalId + copy-through (typed) + each local
   // FK column (typed string, nullable per rel) + createdAt/updatedAt.
   const projectionFields = [
     { camelName: 'id', tsType: 'string' },
@@ -841,7 +841,7 @@ export function buildSyncSurface(patternName, processedFields, belongsTo, hasTim
   const parentTableImports = Array.from(parentImportMap.values());
 
   return {
-    syncConfig,
+    integrationConfig,
     fkResolvers,
     writeFields,
     writeFkFields,
@@ -953,7 +953,7 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
   // Behavior flags (re-read from behaviors array for clean-lite-ps use).
   //
   // Fold in the resolved pattern's `impliedBehaviors` (ADR-031): an entity
-  // declaring e.g. `pattern: Synced` need not re-declare the
+  // declaring e.g. `pattern: Integrated` need not re-declare the
   // `external_id_tracking` behavior — the pattern contributes it. Deduped
   // with any explicit `behaviors:` entries, explicit-first so order is
   // stable for pre-existing fixtures. Mirrors the dedup in
@@ -1087,17 +1087,17 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     declarativeQueries: hasDeclarativeQueries
       ? `${srcRoot}/modules/${entityNamePlural}/use-cases/declarative-queries.ts`
       : null,
-    // ADR-033.1 §8 — sync-source module emission for clean-lite-ps. Co-located
+    // ADR-033.1 §8 — integration-source module emission for clean-lite-ps. Co-located
     // with the entity feature module under src/modules/<plural>/. Closes #267.
-    syncSourceModule: `${srcRoot}/modules/${entityNamePlural}/${entityName}-sync-source.module.ts`,
-    syncSourceProviders: `${srcRoot}/modules/${entityNamePlural}/${entityName}-sync-source.providers.ts`,
+    integrationSourceModule: `${srcRoot}/modules/${entityNamePlural}/${entityName}-integration-source.module.ts`,
+    integrationSourceProviders: `${srcRoot}/modules/${entityNamePlural}/${entityName}-integration-source.providers.ts`,
   };
 
-  // Architecture-specific imports for clean-lite-ps. The sync-source module
+  // Architecture-specific imports for clean-lite-ps. The integration-source module
   // imports the entity type sibling-style (`./<entity>.entity`) since the
   // module file lives next to the entity file in the same feature folder.
   const clpImports = {
-    syncSourceToEntity: `./${entityName}.entity`,
+    integrationSourceToEntity: `./${entityName}.entity`,
   };
 
   // Class names
@@ -1156,8 +1156,8 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     zodChainOutput: zodChainForOutput(f),
   }));
 
-  // Sync write-surface derivation (#374) — null unless pattern: Synced.
-  const syncSurface = buildSyncSurface(
+  // Integration write-surface derivation (#374) — null unless pattern: Integrated.
+  const integrationSurface = buildIntegrationSurface(
     patternName,
     nonFkFields,
     belongsTo,
@@ -1211,16 +1211,16 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     renderPatternConfigLiteral,
     ...patternConfigClasses,
 
-    // Sync write-surface (#374) — emitted only for pattern: Synced. The
-    // template hand-emits the syncConfig literal (live refTable handles) +
-    // TSyncWrite/TSyncProjection from these.
-    hasSyncSurface: syncSurface !== null,
-    clpSyncConfig: syncSurface?.syncConfig ?? null,
-    clpSyncFkResolvers: syncSurface?.fkResolvers ?? [],
-    clpSyncWriteFields: syncSurface?.writeFields ?? [],
-    clpSyncWriteFkFields: syncSurface?.writeFkFields ?? [],
-    clpSyncProjectionFields: syncSurface?.projectionFields ?? [],
-    clpSyncParentTableImports: syncSurface?.parentTableImports ?? [],
+    // Integration write-surface (#374) — emitted only for pattern: Integrated. The
+    // template hand-emits the integrationConfig literal (live refTable handles) +
+    // TIntegrationWrite/TIntegrationProjection from these.
+    hasIntegrationSurface: integrationSurface !== null,
+    clpIntegrationConfig: integrationSurface?.integrationConfig ?? null,
+    clpIntegrationFkResolvers: integrationSurface?.fkResolvers ?? [],
+    clpIntegrationWriteFields: integrationSurface?.writeFields ?? [],
+    clpIntegrationWriteFkFields: integrationSurface?.writeFkFields ?? [],
+    clpIntegrationProjectionFields: integrationSurface?.projectionFields ?? [],
+    clpIntegrationParentTableImports: integrationSurface?.parentTableImports ?? [],
 
     // Behavior flags (also exposed at top level for template use)
     hasTimestamps,
@@ -1248,7 +1248,7 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     // Output paths
     clpOutputPaths: outputPaths,
 
-    // Architecture-specific imports (ADR-033.1 §8 — sync-source closes #267)
+    // Architecture-specific imports (ADR-033.1 §8 — integration-source closes #267)
     clpImports,
 
     // Class names

package/templates/entity/new/clean-lite-ps/repository.ejs.t

@@ -22,10 +22,10 @@ import { eq<%= hasMultiFieldQuery ? ', and' : '' %><%= hasOrderedQuery ? ', desc
 import { sql } from 'drizzle-orm';
 <% } -%>
 import { DRIZZLE } from '@shared/constants/tokens';
-import type { DrizzleClient<% if (eavValueTable || (typeof hasSyncSurface !== 'undefined' && hasSyncSurface)) { %>, DrizzleTx<% } %> } from '@shared/types/drizzle';
+import type { DrizzleClient<% if (eavValueTable || (typeof hasIntegrationSurface !== 'undefined' && hasIntegrationSurface)) { %>, DrizzleTx<% } %> } from '@shared/types/drizzle';
 import { <%= repositoryBaseClass %> } from '<%= repositoryBaseImport %>';
-<% if (typeof hasSyncSurface !== 'undefined' && hasSyncSurface) { -%>
-import type { SyncUpsertConfig } from '@shared/base-classes/sync-upsert-config';
+<% if (typeof hasIntegrationSurface !== 'undefined' && hasIntegrationSurface) { -%>
+import type { IntegrationUpsertConfig } from '@shared/base-classes/integration-upsert-config';
 <% } -%>
 <% if (hasTimestamps || hasSoftDelete || hasUserTracking) { -%>
 import type { BehaviorConfig } from '@shared/base-classes/base-repository';
@@ -34,25 +34,25 @@ import type { BehaviorConfig } from '@shared/base-classes/base-repository';
 import { FieldValueService } from '../field_values/field_value.service';
 <% } -%>
 import { <%= entityNamePlural %>, type <%= classNames.entity %> } from './<%= entityName %>.entity';
-<%_ if (typeof hasSyncSurface !== 'undefined' && hasSyncSurface) { _%>
-<%_ clpSyncParentTableImports.forEach((imp) => { _%>
+<%_ if (typeof hasIntegrationSurface !== 'undefined' && hasIntegrationSurface) { _%>
+<%_ clpIntegrationParentTableImports.forEach((imp) => { _%>
 import { <%= imp.table %> } from '<%= imp.importPath %>';
 <%_ }); _%>
 <%_ } _%>
-<%_ if (typeof hasSyncSurface !== 'undefined' && hasSyncSurface) { _%>
+<%_ if (typeof hasIntegrationSurface !== 'undefined' && hasIntegrationSurface) { _%>
 
 /**
- * Canonical fields a synced <%= entityName %> write carries (#374). Copy-through
+ * Canonical fields a integrated <%= entityName %> write carries (#374). Copy-through
  * columns are typed from the entity; each FK is named by its parent's external
- * id and resolved <%= clpSyncFkResolvers.length > 0 ? 'in syncUpsertOne' : 'as configured' %>. Provider/providerMetadata are persistence
+ * id and resolved <%= clpIntegrationFkResolvers.length > 0 ? 'in integrationUpsertOne' : 'as configured' %>. Provider/providerMetadata are persistence
  * seam, not carried here.
  */
-export interface <%= classNames.entity %>SyncWrite {
+export interface <%= classNames.entity %>IntegrationWrite {
   readonly externalId: string;
-<%_ clpSyncWriteFields.forEach((f) => { _%>
+<%_ clpIntegrationWriteFields.forEach((f) => { _%>
   readonly <%= f.camelName %>: <%- f.tsType %>;
 <%_ }); _%>
-<%_ clpSyncWriteFkFields.forEach((f) => { _%>
+<%_ clpIntegrationWriteFkFields.forEach((f) => { _%>
   readonly <%= f.name %>?: <%- f.tsType %>;
 <%_ }); _%>
   /** Flat custom-field bag (EAV). */
@@ -60,23 +60,23 @@ export interface <%= classNames.entity %>SyncWrite {
 }
 
 /**
- * Canonical-projected view of a <%= entityName %> row, keyed for the sync differ
+ * Canonical-projected view of a <%= entityName %> row, keyed for the integration differ
  * (#374). external_id_tracking columns (provider/providerMetadata) are OMITTED;
  * externalId is kept.
  */
-export interface <%= classNames.entity %>SyncProjection {
-<%_ clpSyncProjectionFields.forEach((f) => { _%>
+export interface <%= classNames.entity %>IntegrationProjection {
+<%_ clpIntegrationProjectionFields.forEach((f) => { _%>
   readonly <%= f.camelName %>: <%- f.tsType %>;
 <%_ }); _%>
 }
 <%_ } _%>
 
 @Injectable()
-<%_ if (typeof hasSyncSurface !== 'undefined' && hasSyncSurface) { _%>
+<%_ if (typeof hasIntegrationSurface !== 'undefined' && hasIntegrationSurface) { _%>
 export class <%= classNames.repository %> extends <%= repositoryBaseClass %><
   <%= classNames.entity %>,
-  <%= classNames.entity %>SyncWrite,
-  <%= classNames.entity %>SyncProjection
+  <%= classNames.entity %>IntegrationWrite,
+  <%= classNames.entity %>IntegrationProjection
 > {
 <%_ } else { _%>
 export class <%= classNames.repository %> extends <%= repositoryBaseClass %><<%= classNames.entity %>> {
@@ -99,22 +99,22 @@ export class <%= classNames.repository %> extends <%= repositoryBaseClass %><<%=
   // runtime (identical shape to `behaviors: BehaviorConfig`).
   protected override readonly patternConfig = <%- renderPatternConfigLiteral(patternConfig, '  ', '  ') %> as const;
 <% } -%>
-<%_ if (typeof hasSyncSurface !== 'undefined' && hasSyncSurface) { _%>
+<%_ if (typeof hasIntegrationSurface !== 'undefined' && hasIntegrationSurface) { _%>
 
-  // Inbound-sync write surface (#374). Drives the generic syncUpsertOne /
+  // Inbound-integration write surface (#374). Drives the generic integrationUpsertOne /
   // findByExternalIdProjected / softDeleteByExternalId on the base. FK
   // resolvers carry LIVE Drizzle table handles ('self' → this.table).
-  protected readonly syncConfig: SyncUpsertConfig = {
-    conflictTarget: [<%- clpSyncConfig.conflictTarget.map((c) => `'${c}'`).join(', ') %>],
-    writeColumns: [<%- clpSyncConfig.writeColumns.map((c) => `'${c}'`).join(', ') %>],
+  protected readonly integrationConfig: IntegrationUpsertConfig = {
+    conflictTarget: [<%- clpIntegrationConfig.conflictTarget.map((c) => `'${c}'`).join(', ') %>],
+    writeColumns: [<%- clpIntegrationConfig.writeColumns.map((c) => `'${c}'`).join(', ') %>],
     fkResolvers: [
-<%_ clpSyncFkResolvers.forEach((fk) => { _%>
+<%_ clpIntegrationFkResolvers.forEach((fk) => { _%>
       { column: '<%= fk.column %>', writeKey: '<%= fk.writeKey %>', refTable: <%- fk.isSelfFk ? "'self'" : fk.refTable %><%= fk.strict ? ', strict: true' : '' %> },
 <%_ }); _%>
     ],
-    projectionColumns: [<%- clpSyncConfig.projectionColumns.map((c) => `'${c}'`).join(', ') %>],
-    eav: <%= clpSyncConfig.eav %>,
-    softDelete: <%= clpSyncConfig.softDelete %>,
+    projectionColumns: [<%- clpIntegrationConfig.projectionColumns.map((c) => `'${c}'`).join(', ') %>],
+    eav: <%= clpIntegrationConfig.eav %>,
+    softDelete: <%= clpIntegrationConfig.softDelete %>,
   };
 <%_ } _%>
 
@@ -128,7 +128,7 @@ export class <%= classNames.repository %> extends <%= repositoryBaseClass %><<%=
 
   /**
    * EAV dual-write override (#374 seam → #124 live path). Delegates to the
-   * shared FieldValueService so the inbound-sync write joins the same tx.
+   * shared FieldValueService so the inbound-integration write joins the same tx.
    */
   protected override async writeCustomFields(
     db: DrizzleTx,