@pattern-stack/codegen 0.16.1 → 0.17.0

package/dist/{chunk-BOPZWRJK.js → chunk-JYBFPNBJ.js}

@@ -11,26 +11,26 @@ var ActivityEntityService = class extends BaseService {
     return this.repository.findByDateRange(start, end);
   }
   /**
-   * Find all activities for a specific user.
+   * Find all activities for a specific user (actor / owner scoping).
    */
   findByUser(userId) {
     return this.repository.findByUserId(userId);
   }
   /**
-   * Find all activities for a specific opportunity.
+   * Find all activities for a specific subject (config-driven FK column).
    */
-  findByOpportunity(opportunityId) {
-    return this.repository.findByOpportunityId(opportunityId);
+  findBySubject(subjectId) {
+    return this.repository.findBySubjectId(subjectId);
   }
   /**
-   * Find the most recent activities for an opportunity.
+   * Find the most recent activities for a subject.
    */
-  findRecent(opportunityId, limit) {
-    return this.repository.findRecentByOpportunityId(opportunityId, limit);
+  findRecent(subjectId, limit) {
+    return this.repository.findRecentBySubjectId(subjectId, limit);
   }
 };
 
 export {
   ActivityEntityService
 };
-//# sourceMappingURL=chunk-BOPZWRJK.js.map
+//# sourceMappingURL=chunk-JYBFPNBJ.js.map

package/dist/chunk-JYBFPNBJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/base-classes/activity-entity-service.ts"],"sourcesContent":["/**\n * ActivityEntityService<TRepo, TEntity>\n *\n * Family-specific base service for activity / interaction entities. Delegates\n * to an activity repository that provides date-range, actor (`user_id`), and\n * config-driven subject queries. The subject FK column is resolved inside the\n * repository from its `patternConfig` (ADR-031 §4) — the service is\n * subject-name-agnostic. See ACTIVITY-SUBJECT-1.\n */\nimport { BaseService, type IBaseRepository } from './base-service';\n\nexport interface IActivityEntityRepository<TEntity> extends IBaseRepository<TEntity> {\n  findByDateRange(start: Date, end: Date): Promise<TEntity[]>;\n  findByUserId(userId: string): Promise<TEntity[]>;\n  findBySubjectId(subjectId: string): Promise<TEntity[]>;\n  findRecentBySubjectId(subjectId: string, limit?: number): Promise<TEntity[]>;\n}\n\nexport abstract class ActivityEntityService<\n  TRepo extends IActivityEntityRepository<TEntity>,\n  TEntity,\n> extends BaseService<TRepo, TEntity> {\n  /**\n   * Find activities within a date range (inclusive).\n   */\n  findByDateRange(start: Date, end: Date): Promise<TEntity[]> {\n    return this.repository.findByDateRange(start, end);\n  }\n\n  /**\n   * Find all activities for a specific user (actor / owner scoping).\n   */\n  findByUser(userId: string): Promise<TEntity[]> {\n    return this.repository.findByUserId(userId);\n  }\n\n  /**\n   * Find all activities for a specific subject (config-driven FK column).\n   */\n  findBySubject(subjectId: string): Promise<TEntity[]> {\n    return this.repository.findBySubjectId(subjectId);\n  }\n\n  /**\n   * Find the most recent activities for a subject.\n   */\n  findRecent(subjectId: string, limit?: number): Promise<TEntity[]> {\n    return this.repository.findRecentBySubjectId(subjectId, limit);\n  }\n}\n"],"mappings":";;;;;AAkBO,IAAe,wBAAf,cAGG,YAA4B;AAAA;AAAA;AAAA;AAAA,EAIpC,gBAAgB,OAAa,KAA+B;AAC1D,WAAO,KAAK,WAAW,gBAAgB,OAAO,GAAG;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,QAAoC;AAC7C,WAAO,KAAK,WAAW,aAAa,MAAM;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,WAAuC;AACnD,WAAO,KAAK,WAAW,gBAAgB,SAAS;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,WAAmB,OAAoC;AAChE,WAAO,KAAK,WAAW,sBAAsB,WAAW,KAAK;AAAA,EAC/D;AACF;","names":[]}

package/dist/{chunk-CRBVI4GE.js → chunk-L3VJ47BU.js}

@@ -15,7 +15,7 @@ import {
 } from "./chunk-4DOJBQTP.js";
 import {
   BridgeOutboxDrainHook
-} from "./chunk-DLG62MQY.js";
+} from "./chunk-DTXH24LR.js";
 import {
   BridgeDeliveryHandler
 } from "./chunk-NXNVTXKG.js";
@@ -24,7 +24,7 @@ import {
 } from "./chunk-NXXDZ6ZF.js";
 import {
   JOB_WORKER_MODULE_OPTIONS
-} from "./chunk-AYC2HEAL.js";
+} from "./chunk-GJDEPTPY.js";
 import {
   BRIDGE_DELIVERY_REPO,
   BRIDGE_MODULE_OPTIONS,
@@ -119,4 +119,4 @@ BridgeModule = __decorateClass([
 export {
   BridgeModule
 };
-//# sourceMappingURL=chunk-CRBVI4GE.js.map
+//# sourceMappingURL=chunk-L3VJ47BU.js.map

package/dist/chunk-MKWQKKK7.js

@@ -0,0 +1,72 @@
+import {
+  BaseRepository
+} from "./chunk-J6KZS54B.js";
+
+// runtime/base-classes/activity-entity-repository.ts
+import { eq, between, desc } from "drizzle-orm";
+var toCamel = (snake) => snake.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+var ActivityEntityRepository = class extends BaseRepository {
+  /**
+   * Per-entity Activity config. The template emits this from `config:
+   * { Activity: {...} }`; entities that only use date-range / user scoping omit
+   * it (and must not call the subject finders).
+   */
+  patternConfig;
+  /**
+   * camelCase key for the recency-ordering column. Defaults to `occurredAt`
+   * (column `occurred_at`); override via `patternConfig.occurredAt`.
+   */
+  get occurredAtColumn() {
+    const snake = this.patternConfig?.occurredAt ?? "occurred_at";
+    return toCamel(snake);
+  }
+  /**
+   * camelCase key for the subject FK column, resolved from `patternConfig`:
+   * `subjectColumn` (explicit) → `<subject>_id` (derived). Throws when neither
+   * is configured — the subject finders are unusable without it, and a clear
+   * error beats a silent `undefined` column index.
+   */
+  get subjectColumn() {
+    const explicit = this.patternConfig?.subjectColumn;
+    if (explicit) return toCamel(explicit);
+    const subject = this.patternConfig?.subject;
+    if (subject) return toCamel(`${subject}_id`);
+    throw new Error(
+      "ActivityEntityRepository: subject finders require a subject column. Set `config: { Activity: { subject: '<entity>' } }` (\u2192 <entity>_id) or `config: { Activity: { subjectColumn: '<column>' } }` on the entity YAML."
+    );
+  }
+  /**
+   * Find activities within a date range (inclusive), by the recency column.
+   */
+  async findByDateRange(start, end) {
+    const rows = await this.baseQuery().where(between(this.table[this.occurredAtColumn], start, end));
+    return rows;
+  }
+  /**
+   * Find all activities for a specific user (actor / owner scoping).
+   */
+  async findByUserId(userId) {
+    const rows = await this.baseQuery().where(eq(this.table["userId"], userId));
+    return rows;
+  }
+  /**
+   * Find all activities for a specific subject (config-driven FK column).
+   */
+  async findBySubjectId(subjectId) {
+    const rows = await this.baseQuery().where(eq(this.table[this.subjectColumn], subjectId));
+    return rows;
+  }
+  /**
+   * Find the most recent activities for a subject, ordered by the recency
+   * column descending.
+   */
+  async findRecentBySubjectId(subjectId, limit = 10) {
+    const rows = await this.baseQuery().where(eq(this.table[this.subjectColumn], subjectId)).orderBy(desc(this.table[this.occurredAtColumn])).limit(limit);
+    return rows;
+  }
+};
+
+export {
+  ActivityEntityRepository
+};
+//# sourceMappingURL=chunk-MKWQKKK7.js.map

package/dist/chunk-MKWQKKK7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/base-classes/activity-entity-repository.ts"],"sourcesContent":["/**\n * ActivityEntityRepository<TEntity>\n *\n * Family-specific base for activity / interaction entities (emails, calls,\n * meetings, messages, transcripts). Adds date-range queries, actor (`user_id`)\n * scoping, recency ordering, and **config-driven subject scoping** — the\n * subject FK column is resolved from the concrete repo's `patternConfig`\n * (ADR-031 §4) rather than hardcoded, so the same base serves a CRM\n * `opportunity`-scoped activity and a swe-brain `person`-scoped interaction.\n *\n * Concrete repos extend this and declare their table + behaviors, and (when\n * they use the subject finders) a `patternConfig` carrying `subject` /\n * `subjectColumn` / `occurredAt`. The template emits that property from the\n * entity's `config: { Activity: {...} }` block. See ACTIVITY-SUBJECT-1.\n */\nimport { eq, between, desc } from 'drizzle-orm';\nimport { BaseRepository } from './base-repository';\n\n/**\n * Per-entity Activity config (matches `ActivityPatternConfigSchema` in\n * `src/patterns/library/activity.pattern.ts`). Carried on the concrete repo as\n * `patternConfig` and read here to resolve column names at runtime.\n */\nexport interface ActivityPatternConfig {\n  /** Subject entity name → derives the FK column `<subject>_id`. */\n  subject?: string;\n  /** Explicit snake_case FK column, when it does not follow `<subject>_id`. */\n  subjectColumn?: string;\n  /** snake_case recency-ordering column; defaults to `occurred_at`. */\n  occurredAt?: string;\n}\n\nconst toCamel = (snake: string): string =>\n  snake.replace(/_([a-z0-9])/g, (_, c: string) => c.toUpperCase());\n\nexport abstract class ActivityEntityRepository<TEntity> extends BaseRepository<TEntity> {\n  /**\n   * Per-entity Activity config. The template emits this from `config:\n   * { Activity: {...} }`; entities that only use date-range / user scoping omit\n   * it (and must not call the subject finders).\n   */\n  protected readonly patternConfig?: ActivityPatternConfig;\n\n  /**\n   * camelCase key for the recency-ordering column. Defaults to `occurredAt`\n   * (column `occurred_at`); override via `patternConfig.occurredAt`.\n   */\n  protected get occurredAtColumn(): string {\n    const snake = this.patternConfig?.occurredAt ?? 'occurred_at';\n    return toCamel(snake);\n  }\n\n  /**\n   * camelCase key for the subject FK column, resolved from `patternConfig`:\n   * `subjectColumn` (explicit) → `<subject>_id` (derived). Throws when neither\n   * is configured — the subject finders are unusable without it, and a clear\n   * error beats a silent `undefined` column index.\n   */\n  protected get subjectColumn(): string {\n    const explicit = this.patternConfig?.subjectColumn;\n    if (explicit) return toCamel(explicit);\n    const subject = this.patternConfig?.subject;\n    if (subject) return toCamel(`${subject}_id`);\n    throw new Error(\n      'ActivityEntityRepository: subject finders require a subject column. ' +\n        \"Set `config: { Activity: { subject: '<entity>' } }` (→ <entity>_id) \" +\n        \"or `config: { Activity: { subjectColumn: '<column>' } }` on the entity YAML.\",\n    );\n  }\n\n  /**\n   * Find activities within a date range (inclusive), by the recency column.\n   */\n  async findByDateRange(start: Date, end: Date): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(between(this.table[this.occurredAtColumn], start, end));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find all activities for a specific user (actor / owner scoping).\n   */\n  async findByUserId(userId: string): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table['userId'], userId));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find all activities for a specific subject (config-driven FK column).\n   */\n  async findBySubjectId(subjectId: string): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table[this.subjectColumn], subjectId));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find the most recent activities for a subject, ordered by the recency\n   * column descending.\n   */\n  async findRecentBySubjectId(subjectId: string, limit = 10): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table[this.subjectColumn], subjectId))\n      .orderBy(desc(this.table[this.occurredAtColumn]))\n      .limit(limit);\n    return rows as TEntity[];\n  }\n}\n"],"mappings":";;;;;AAeA,SAAS,IAAI,SAAS,YAAY;AAiBlC,IAAM,UAAU,CAAC,UACf,MAAM,QAAQ,gBAAgB,CAAC,GAAG,MAAc,EAAE,YAAY,CAAC;AAE1D,IAAe,2BAAf,cAAyD,eAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnB,IAAc,mBAA2B;AACvC,UAAM,QAAQ,KAAK,eAAe,cAAc;AAChD,WAAO,QAAQ,KAAK;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAc,gBAAwB;AACpC,UAAM,WAAW,KAAK,eAAe;AACrC,QAAI,SAAU,QAAO,QAAQ,QAAQ;AACrC,UAAM,UAAU,KAAK,eAAe;AACpC,QAAI,QAAS,QAAO,QAAQ,GAAG,OAAO,KAAK;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,OAAa,KAA+B;AAChE,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,QAAQ,KAAK,MAAM,KAAK,gBAAgB,GAAG,OAAO,GAAG,CAAC;AAC/D,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,QAAoC;AACrD,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,QAAQ,GAAG,MAAM,CAAC;AACzC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,WAAuC;AAC3D,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;AACtD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,sBAAsB,WAAmB,QAAQ,IAAwB;AAC7E,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC,EACnD,QAAQ,KAAK,KAAK,MAAM,KAAK,gBAAgB,CAAC,CAAC,EAC/C,MAAM,KAAK;AACd,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/{chunk-TDEHU73T.js → chunk-OGIZXGPY.js}

@@ -1,3 +1,6 @@
+import {
+  assertTenantId
+} from "./chunk-MZ6GV4YF.js";
 import {
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_CURSOR_STORE,
@@ -6,9 +9,6 @@ import {
   INTEGRATION_RUN_RECORDER,
   INTEGRATION_SINK
 } from "./chunk-S7C6TIIF.js";
-import {
-  assertTenantId
-} from "./chunk-MZ6GV4YF.js";
 import {
   __decorateClass,
   __decorateParam
@@ -219,4 +219,4 @@ ExecuteIntegrationUseCase = __decorateClass([
 export {
   ExecuteIntegrationUseCase
 };
-//# sourceMappingURL=chunk-TDEHU73T.js.map
+//# sourceMappingURL=chunk-OGIZXGPY.js.map

package/dist/{chunk-JM3T27ZW.js → chunk-OITTYGJS.js}

@@ -1,6 +1,3 @@
-import {
-  jobRuns
-} from "./chunk-OKXZ63IA.js";
 import {
   JOB_HANDLER_REGISTRY
 } from "./chunk-CO6LUM72.js";
@@ -9,6 +6,9 @@ import {
   JOB_RUN_SERVICE,
   JOB_STEP_SERVICE
 } from "./chunk-ZPL74UQN.js";
+import {
+  jobRuns
+} from "./chunk-OKXZ63IA.js";
 import {
   JOBS_WAKE_CHANNEL,
   PgNotifyListener
@@ -518,4 +518,4 @@ export {
   buildStaleSweepQuery,
   JobWorker
 };
-//# sourceMappingURL=chunk-JM3T27ZW.js.map
+//# sourceMappingURL=chunk-OITTYGJS.js.map

package/dist/{chunk-IT6FRTEW.js → chunk-OTR44OH6.js}

@@ -1,12 +1,3 @@
-import {
-  jobRuns,
-  jobSteps,
-  jobs
-} from "./chunk-OKXZ63IA.js";
-import {
-  JOBS_LISTEN_NOTIFY,
-  JOBS_MULTI_TENANT
-} from "./chunk-ZPL74UQN.js";
 import {
   JobCollisionError,
   JobNotReplayableError,
@@ -14,6 +5,15 @@ import {
   JobTypeNotFoundError,
   MissingTenantIdError
 } from "./chunk-T4BIIU5E.js";
+import {
+  JOBS_LISTEN_NOTIFY,
+  JOBS_MULTI_TENANT
+} from "./chunk-ZPL74UQN.js";
+import {
+  jobRuns,
+  jobSteps,
+  jobs
+} from "./chunk-OKXZ63IA.js";
 import {
   JOBS_WAKE_CHANNEL,
   pgNotify
@@ -372,4 +372,4 @@ export {
   evaluateKeyTemplate,
   DrizzleJobOrchestrator
 };
-//# sourceMappingURL=chunk-IT6FRTEW.js.map
+//# sourceMappingURL=chunk-OTR44OH6.js.map

package/dist/{chunk-24WXSC3C.js → chunk-P3AYBRP6.js}

@@ -1,15 +1,18 @@
+import {
+  DrizzleIntegrationRunRecorder
+} from "./chunk-SR7F3TJY.js";
 import {
   MemoryRunRecorder
 } from "./chunk-EO2QPOKH.js";
 import {
   PostgresCursorStore
-} from "./chunk-XWBK3XJK.js";
+} from "./chunk-DCCZB4UC.js";
 import {
   MemoryCursorStore
 } from "./chunk-AHV4GDYM.js";
 import {
-  DrizzleIntegrationRunRecorder
-} from "./chunk-YK5JEVLX.js";
+  DeepEqualDiffer
+} from "./chunk-36U5UGIO.js";
 import {
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_FIELD_DIFFER,
@@ -17,9 +20,6 @@ import {
   INTEGRATION_MULTI_TENANT,
   INTEGRATION_RUN_RECORDER
 } from "./chunk-S7C6TIIF.js";
-import {
-  DeepEqualDiffer
-} from "./chunk-36U5UGIO.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -78,4 +78,4 @@ IntegrationModule = __decorateClass([
 export {
   IntegrationModule
 };
-//# sourceMappingURL=chunk-24WXSC3C.js.map
+//# sourceMappingURL=chunk-P3AYBRP6.js.map

package/dist/{chunk-TKVTEUBD.js → chunk-RHYNACZS.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-GM3RMJIJ.js";
 import {
   DrizzleEventBus
-} from "./chunk-H6FO2ZDJ.js";
+} from "./chunk-UTNWFHJF.js";
 import {
   MemoryEventBus
-} from "./chunk-LQ6PYFU6.js";
+} from "./chunk-Z7PQCAVK.js";
 import {
   EVENTS_MODULE_OPTIONS,
   EVENTS_MULTI_TENANT,
@@ -152,4 +152,4 @@ EventsModule = __decorateClass([
 export {
   EventsModule
 };
-//# sourceMappingURL=chunk-TKVTEUBD.js.map
+//# sourceMappingURL=chunk-RHYNACZS.js.map

package/dist/{chunk-YK5JEVLX.js → chunk-SR7F3TJY.js}

@@ -1,9 +1,6 @@
 import {
   FieldDiffSchema
 } from "./chunk-SQDOBLBP.js";
-import {
-  INTEGRATION_MULTI_TENANT
-} from "./chunk-S7C6TIIF.js";
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
@@ -12,6 +9,9 @@ import {
   integrationRuns,
   integrationSubscriptions
 } from "./chunk-HNWZFNKP.js";
+import {
+  INTEGRATION_MULTI_TENANT
+} from "./chunk-S7C6TIIF.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -127,4 +127,4 @@ DrizzleIntegrationRunRecorder = __decorateClass([
 export {
   DrizzleIntegrationRunRecorder
 };
-//# sourceMappingURL=chunk-YK5JEVLX.js.map
+//# sourceMappingURL=chunk-SR7F3TJY.js.map

package/dist/{chunk-H6FO2ZDJ.js → chunk-UTNWFHJF.js}

@@ -1,22 +1,22 @@
-import {
-  BRIDGE_OUTBOX_DRAIN_HOOK
-} from "./chunk-4LH67P4U.js";
 import {
   EVENTS_WAKE_CHANNEL,
   PgNotifyListener,
   pgNotify
 } from "./chunk-MYQIQ27N.js";
+import {
+  BRIDGE_OUTBOX_DRAIN_HOOK
+} from "./chunk-4LH67P4U.js";
 import {
   domainEvents
 } from "./chunk-OFRRBC7M.js";
-import {
-  EVENTS_MODULE_OPTIONS
-} from "./chunk-H5NH7KPE.js";
 import {
   clampEventLimit,
   decodeEventCursor,
   encodeEventCursor
 } from "./chunk-UQ5EHOH2.js";
+import {
+  EVENTS_MODULE_OPTIONS
+} from "./chunk-H5NH7KPE.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -393,4 +393,4 @@ DrizzleEventBus = __decorateClass([
 export {
   DrizzleEventBus
 };
-//# sourceMappingURL=chunk-H6FO2ZDJ.js.map
+//# sourceMappingURL=chunk-UTNWFHJF.js.map

package/dist/{chunk-LQ6PYFU6.js → chunk-Z7PQCAVK.js}

@@ -1,11 +1,11 @@
-import {
-  EVENTS_MODULE_OPTIONS
-} from "./chunk-H5NH7KPE.js";
 import {
   clampEventLimit,
   decodeEventCursor,
   encodeEventCursor
 } from "./chunk-UQ5EHOH2.js";
+import {
+  EVENTS_MODULE_OPTIONS
+} from "./chunk-H5NH7KPE.js";
 import {
   __decorateClass,
   __decorateParam
@@ -197,4 +197,4 @@ MemoryEventBus = __decorateClass([
 export {
   MemoryEventBus
 };
-//# sourceMappingURL=chunk-LQ6PYFU6.js.map
+//# sourceMappingURL=chunk-Z7PQCAVK.js.map

package/dist/runtime/base-classes/activity-entity-repository.d.ts

@@ -4,23 +4,55 @@ import 'drizzle-orm';
 import '../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
 
+/**
+ * Per-entity Activity config (matches `ActivityPatternConfigSchema` in
+ * `src/patterns/library/activity.pattern.ts`). Carried on the concrete repo as
+ * `patternConfig` and read here to resolve column names at runtime.
+ */
+interface ActivityPatternConfig {
+    /** Subject entity name → derives the FK column `<subject>_id`. */
+    subject?: string;
+    /** Explicit snake_case FK column, when it does not follow `<subject>_id`. */
+    subjectColumn?: string;
+    /** snake_case recency-ordering column; defaults to `occurred_at`. */
+    occurredAt?: string;
+}
 declare abstract class ActivityEntityRepository<TEntity> extends BaseRepository<TEntity> {
     /**
-     * Find activities within a date range (inclusive).
+     * Per-entity Activity config. The template emits this from `config:
+     * { Activity: {...} }`; entities that only use date-range / user scoping omit
+     * it (and must not call the subject finders).
+     */
+    protected readonly patternConfig?: ActivityPatternConfig;
+    /**
+     * camelCase key for the recency-ordering column. Defaults to `occurredAt`
+     * (column `occurred_at`); override via `patternConfig.occurredAt`.
+     */
+    protected get occurredAtColumn(): string;
+    /**
+     * camelCase key for the subject FK column, resolved from `patternConfig`:
+     * `subjectColumn` (explicit) → `<subject>_id` (derived). Throws when neither
+     * is configured — the subject finders are unusable without it, and a clear
+     * error beats a silent `undefined` column index.
+     */
+    protected get subjectColumn(): string;
+    /**
+     * Find activities within a date range (inclusive), by the recency column.
      */
     findByDateRange(start: Date, end: Date): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific user.
+     * Find all activities for a specific user (actor / owner scoping).
      */
     findByUserId(userId: string): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific opportunity.
+     * Find all activities for a specific subject (config-driven FK column).
      */
-    findByOpportunityId(opportunityId: string): Promise<TEntity[]>;
+    findBySubjectId(subjectId: string): Promise<TEntity[]>;
     /**
-     * Find the most recent activities for an opportunity, ordered by occurredAt desc.
+     * Find the most recent activities for a subject, ordered by the recency
+     * column descending.
      */
-    findRecentByOpportunityId(opportunityId: string, limit?: number): Promise<TEntity[]>;
+    findRecentBySubjectId(subjectId: string, limit?: number): Promise<TEntity[]>;
 }
 
-export { ActivityEntityRepository };
+export { ActivityEntityRepository, type ActivityPatternConfig };

package/dist/runtime/base-classes/activity-entity-repository.js

@@ -1,6 +1,6 @@
 import {
   ActivityEntityRepository
-} from "../../chunk-XCEI7NUH.js";
+} from "../../chunk-MKWQKKK7.js";
 import "../../chunk-J6KZS54B.js";
 import "../../chunk-ZUKFQL6E.js";
 import "../../chunk-2E224ZSN.js";

package/dist/runtime/base-classes/activity-entity-service.d.ts

@@ -6,16 +6,18 @@ import 'drizzle-orm/node-postgres';
 /**
  * ActivityEntityService<TRepo, TEntity>
  *
- * Family-specific base service for activity entities.
- * Delegates to an activity repository that provides date-range,
- * user, and opportunity queries.
+ * Family-specific base service for activity / interaction entities. Delegates
+ * to an activity repository that provides date-range, actor (`user_id`), and
+ * config-driven subject queries. The subject FK column is resolved inside the
+ * repository from its `patternConfig` (ADR-031 §4) — the service is
+ * subject-name-agnostic. See ACTIVITY-SUBJECT-1.
  */
 
 interface IActivityEntityRepository<TEntity> extends IBaseRepository<TEntity> {
     findByDateRange(start: Date, end: Date): Promise<TEntity[]>;
     findByUserId(userId: string): Promise<TEntity[]>;
-    findByOpportunityId(opportunityId: string): Promise<TEntity[]>;
-    findRecentByOpportunityId(opportunityId: string, limit?: number): Promise<TEntity[]>;
+    findBySubjectId(subjectId: string): Promise<TEntity[]>;
+    findRecentBySubjectId(subjectId: string, limit?: number): Promise<TEntity[]>;
 }
 declare abstract class ActivityEntityService<TRepo extends IActivityEntityRepository<TEntity>, TEntity> extends BaseService<TRepo, TEntity> {
     /**
@@ -23,17 +25,17 @@ declare abstract class ActivityEntityService<TRepo extends IActivityEntityReposi
      */
     findByDateRange(start: Date, end: Date): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific user.
+     * Find all activities for a specific user (actor / owner scoping).
      */
     findByUser(userId: string): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific opportunity.
+     * Find all activities for a specific subject (config-driven FK column).
      */
-    findByOpportunity(opportunityId: string): Promise<TEntity[]>;
+    findBySubject(subjectId: string): Promise<TEntity[]>;
     /**
-     * Find the most recent activities for an opportunity.
+     * Find the most recent activities for a subject.
      */
-    findRecent(opportunityId: string, limit?: number): Promise<TEntity[]>;
+    findRecent(subjectId: string, limit?: number): Promise<TEntity[]>;
 }
 
 export { ActivityEntityService, type IActivityEntityRepository };

package/dist/runtime/base-classes/activity-entity-service.js

@@ -1,6 +1,6 @@
 import {
   ActivityEntityService
-} from "../../chunk-BOPZWRJK.js";
+} from "../../chunk-JYBFPNBJ.js";
 import "../../chunk-W72PRNJY.js";
 import "../../chunk-KYR3B3OW.js";
 import "../../chunk-2E224ZSN.js";

package/dist/runtime/base-classes/index.js

@@ -1,9 +1,3 @@
-import {
-  KnowledgeEntityRepository
-} from "../../chunk-NN7XZEGF.js";
-import {
-  KnowledgeEntityService
-} from "../../chunk-AS3NAZB6.js";
 import {
   MetadataEntityRepository
 } from "../../chunk-7KOW6PU6.js";
@@ -13,10 +7,6 @@ import {
 import {
   WithAnalytics
 } from "../../chunk-IBGER4YK.js";
-import {
-  BaseFindByIdUseCase,
-  BaseListUseCase
-} from "../../chunk-EXVDJMIY.js";
 import {
   IntegratedEntityRepository
 } from "../../chunk-OTDN3OUQ.js";
@@ -29,23 +19,24 @@ import {
   parseCompositeExternalId
 } from "../../chunk-2FTZLDBP.js";
 import {
-  ActivityEntityRepository
-} from "../../chunk-XCEI7NUH.js";
+  KnowledgeEntityRepository
+} from "../../chunk-NN7XZEGF.js";
 import {
-  BaseRepository
-} from "../../chunk-J6KZS54B.js";
+  KnowledgeEntityService
+} from "../../chunk-AS3NAZB6.js";
 import {
-  requireRequester,
-  requireRequesterScope,
-  tryGetRequester,
-  withOrgScope,
-  withRequester,
-  withSuperuserScope,
-  withUserScope
-} from "../../chunk-ZUKFQL6E.js";
+  ActivityEntityRepository
+} from "../../chunk-MKWQKKK7.js";
 import {
   ActivityEntityService
-} from "../../chunk-BOPZWRJK.js";
+} from "../../chunk-JYBFPNBJ.js";
+import {
+  BaseFindByIdUseCase,
+  BaseListUseCase
+} from "../../chunk-EXVDJMIY.js";
+import {
+  BaseRepository
+} from "../../chunk-J6KZS54B.js";
 import {
   BaseService
 } from "../../chunk-W72PRNJY.js";
@@ -56,6 +47,15 @@ import {
   emitSafely,
   entitySnapshot
 } from "../../chunk-KYR3B3OW.js";
+import {
+  requireRequester,
+  requireRequesterScope,
+  tryGetRequester,
+  withOrgScope,
+  withRequester,
+  withSuperuserScope,
+  withUserScope
+} from "../../chunk-ZUKFQL6E.js";
 import "../../chunk-2E224ZSN.js";
 export {
   ActivityEntityRepository,

package/dist/runtime/shared/openapi/index.js

@@ -3,15 +3,15 @@ import {
 } from "../../../chunk-PSXUNOVU.js";
 import {
   OpenApiRegistry
-} from "../../../chunk-Y7GDG744.js";
-import {
-  ERROR_RESPONSE_SCHEMA_NAME,
-  errorResponseSchema
-} from "../../../chunk-SOVM2VEK.js";
+} from "../../../chunk-4GLNY5V6.js";
 import {
   DuplicateSchemaError,
   OpenApiPeerDepMissingError
 } from "../../../chunk-YSLTTQLC.js";
+import {
+  ERROR_RESPONSE_SCHEMA_NAME,
+  errorResponseSchema
+} from "../../../chunk-SOVM2VEK.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   DuplicateSchemaError,

package/dist/runtime/shared/openapi/registry.js

@@ -1,8 +1,8 @@
 import {
   OpenApiRegistry
-} from "../../../chunk-Y7GDG744.js";
-import "../../../chunk-SOVM2VEK.js";
+} from "../../../chunk-4GLNY5V6.js";
 import "../../../chunk-YSLTTQLC.js";
+import "../../../chunk-SOVM2VEK.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   OpenApiRegistry

package/dist/runtime/subsystems/auth/auth.module.js

@@ -1,11 +1,11 @@
 import {
   AuthModule
-} from "../../../chunk-T6SCOJF4.js";
+} from "../../../chunk-7LKAMLV4.js";
 import "../../../chunk-IP4OO26U.js";
-import "../../../chunk-SZVPIHWE.js";
 import "../../../chunk-N5OTOWTP.js";
 import "../../../chunk-QLTJSCE6.js";
 import "../../../chunk-BPARRK6F.js";
+import "../../../chunk-SZVPIHWE.js";
 import "../../../chunk-6XY6ZMMD.js";
 import "../../../chunk-NPFPZ2HO.js";
 import "../../../chunk-GYGNEQSC.js";