@pattern-stack/codegen 0.16.1 → 0.17.0

package/CHANGELOG.md

@@ -4,6 +4,59 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.17.0] — 2026-06-04
+
+**`ActivityPattern` subject scoping is config-driven** (ACTIVITY-SUBJECT-1) —
+the library's Activity base classes no longer bake the CRM term "opportunity"
+into their finders. An activity/interaction entity declares which subject it is
+scoped to via the pattern's new `config:` block, and the generated repo/service
+expose generic, config-resolved subject lookups. Surfaced by the swe-brain
+dogfood, whose interactions (meeting, email, transcript, message) reference
+`person`/`repo`/`team` subjects (ADR-0006), not CRM opportunities.
+
+Consumer census confirmed **no project used the Activity pattern** (dealbrain's
+sole `findByOpportunityId` is a `JunctionSyncRepository` method, not the pattern;
+swe-brain's interactions are all `pattern: Integrated`), so this is a clean cut
+with no aliases per the "no backwards compatibility until users" rule. The
+`patterns: [Integrated, Activity]` composition — the swe-brain target — is
+validated and tested.
+
+### Added
+
+- **`ActivityPattern.configSchema`** — `{ subject?, subjectColumn?, occurredAt? }`
+  (all optional, `.strict()`). `subject` derives the FK column `<subject>_id`;
+  `subjectColumn` overrides it explicitly; `occurredAt` names the recency column
+  (default `occurred_at`). Validated at parse time via the standard ADR-031
+  composition path; emitted onto the concrete repo as `patternConfig` (the same
+  hand-off `IntegratedEntityRepository` uses for `integrationConfig`).
+- **`ActivityPatternConfig`** interface exported from
+  `runtime/base-classes/activity-entity-repository.ts`.
+
+### Changed
+
+- **`ActivityEntityRepository` finders are config-driven.**
+  `findByOpportunityId` / `findRecentByOpportunityId` are replaced by
+  `findBySubjectId` / `findRecentBySubjectId`, which resolve the subject FK column
+  (and recency-ordering column) from `this.patternConfig` at runtime. Calling a
+  subject finder with no subject configured throws a clear error naming the
+  config key to set. `findByDateRange` and `findByUserId` are unchanged (actor
+  scoping is generally applicable, not CRM-shaped).
+- **`ActivityEntityService`** mirrors the rename: `findBySubject` /
+  `findRecent` (was `findByOpportunity` / `findRecent`); `IActivityEntityRepository`
+  drops the opportunity methods for the subject ones. `findByDateRange` /
+  `findByUser` unchanged.
+- **`ActivityPattern` inherited-method comment strings** now advertise the
+  subject finders; the header's byte-identical-to-FAMILY_MAP claim is removed (it
+  was a one-time PATTERN-5 migration guarantee, not a standing contract).
+
+### Migration
+
+No consumer action required — no project used the Activity pattern. A project
+adopting it now declares `pattern: Activity` (or `patterns: [Integrated,
+Activity]`) plus `config: { Activity: { subject: <entity> } }`. Named per-subject
+finders (`findByPersonId`) remain available the same way they always were — via
+the entity's declarative `queries:` block.
+
 ## [0.16.1] — 2026-06-04
 
 **`WebhookFetchCallback<T>` yields `{ record, eventId?, cursor? }`** —

package/consumer-skills/entities/families-and-queries.md

@@ -16,7 +16,7 @@ an optional `tx?: DrizzleTx` for transactional composition.
 |---|---|---|
 | `Base` | plain tables with no special access pattern | nothing — standard CRUD only |
 | `Synced` | records mirrored from an external system (have an external id + per-user visibility) | `findByExternalId`, `findAllByUserId`, `findVisibleByUserId`, `syncUpsert` |
-| `Activity` | time-ordered activity/event rows tied to a parent | `findByDateRange`, `findByUserId`, `findByOpportunityId`, `findRecentByOpportunityId` |
+| `Activity` | time-ordered activity/interaction rows scoped to a subject | `findByDateRange`, `findByUserId`, `findBySubjectId`, `findRecentBySubjectId` (subject FK + recency column resolved from `config: { Activity: { subject: <entity> } }`) |
 | `Metadata` | key/value or definition/value rows describing other entities | `findByEntityIdAndType`, `listByEntityId`, `listHistoryByEntityId` |
 | `Knowledge` | semantically-searchable knowledge rows (pgvector at runtime) | `semanticSearch`, `findPendingByOpportunityId`, `updateStatus`, `updateStatusBatch` |
 
@@ -77,6 +77,8 @@ and a `GET /<plural>/search` route. `paginate: true` makes the route accept
 - **`order:` is the default sort**, not a parameter — add a `queries:` search
   entry if you need caller-controlled ordering.
 - **Family methods assume their columns exist.** `Synced` expects an external-id
-  + user-visibility shape; `Activity` expects a parent FK like
-  `opportunity_id`. If your table doesn't fit, pick `Base` and add explicit
+  + user-visibility shape; `Activity`'s subject finders expect the subject FK
+  named by its `config:` (`subject: person` → `person_id`, or an explicit
+  `subjectColumn`) plus a recency column (`occurred_at` by default, or
+  `config.occurredAt`). If your table doesn't fit, pick `Base` and add explicit
   `queries:`.

package/dist/{chunk-DGYTSCKN.js → chunk-3MAZ4TQH.js}

@@ -1,12 +1,21 @@
+import {
+  MemoryJobOrchestrator
+} from "./chunk-BULPAAD3.js";
 import {
   DrizzleJobRunService
-} from "./chunk-5LXOJGO2.js";
+} from "./chunk-3VEVGL74.js";
 import {
   MemoryJobRunService
-} from "./chunk-QSJ3J4HE.js";
+} from "./chunk-CDLWYZVQ.js";
 import {
   DrizzleJobStepService
 } from "./chunk-DV4RV2DC.js";
+import {
+  MemoryJobStepService
+} from "./chunk-PNZSGAB2.js";
+import {
+  MemoryJobStore
+} from "./chunk-SNQ3TOWP.js";
 import {
   BULLMQ_CONNECTION,
   BULLMQ_RESOLVED_CONFIG,
@@ -14,16 +23,7 @@ import {
 } from "./chunk-I6MVCB5A.js";
 import {
   DrizzleJobOrchestrator
-} from "./chunk-IT6FRTEW.js";
-import {
-  MemoryJobOrchestrator
-} from "./chunk-T4YJRD22.js";
-import {
-  MemoryJobStepService
-} from "./chunk-PNZSGAB2.js";
-import {
-  MemoryJobStore
-} from "./chunk-SNQ3TOWP.js";
+} from "./chunk-OTR44OH6.js";
 import {
   JOBS_LISTEN_NOTIFY,
   JOBS_MULTI_TENANT,
@@ -114,4 +114,4 @@ JobsDomainModule = __decorateClass([
 export {
   JobsDomainModule
 };
-//# sourceMappingURL=chunk-DGYTSCKN.js.map
+//# sourceMappingURL=chunk-3MAZ4TQH.js.map

package/dist/{chunk-5LXOJGO2.js → chunk-3VEVGL74.js}

@@ -5,15 +5,15 @@ import {
   toJobRunSummary
 } from "./chunk-L3LZWWSX.js";
 import {
-  jobRuns
-} from "./chunk-OKXZ63IA.js";
+  MissingTenantIdError
+} from "./chunk-T4BIIU5E.js";
 import {
   JOBS_MULTI_TENANT,
   JOB_ORCHESTRATOR
 } from "./chunk-ZPL74UQN.js";
 import {
-  MissingTenantIdError
-} from "./chunk-T4BIIU5E.js";
+  jobRuns
+} from "./chunk-OKXZ63IA.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -198,4 +198,4 @@ DrizzleJobRunService = __decorateClass([
 export {
   DrizzleJobRunService
 };
-//# sourceMappingURL=chunk-5LXOJGO2.js.map
+//# sourceMappingURL=chunk-3VEVGL74.js.map

package/dist/{chunk-Y7GDG744.js → chunk-4GLNY5V6.js}

@@ -1,11 +1,11 @@
-import {
-  ERROR_RESPONSE_SCHEMA_NAME,
-  errorResponseSchema
-} from "./chunk-SOVM2VEK.js";
 import {
   DuplicateSchemaError,
   OpenApiPeerDepMissingError
 } from "./chunk-YSLTTQLC.js";
+import {
+  ERROR_RESPONSE_SCHEMA_NAME,
+  errorResponseSchema
+} from "./chunk-SOVM2VEK.js";
 
 // runtime/shared/openapi/registry.ts
 var OpenApiRegistry = class {
@@ -85,4 +85,4 @@ var OpenApiRegistry = class {
 export {
   OpenApiRegistry
 };
-//# sourceMappingURL=chunk-Y7GDG744.js.map
+//# sourceMappingURL=chunk-4GLNY5V6.js.map

package/dist/{chunk-RUSUZZAF.js → chunk-4MVGAMUA.js}

@@ -1,12 +1,12 @@
+import {
+  LocalStorageBackend
+} from "./chunk-JWNHNUYL.js";
 import {
   MemoryStorageBackend
 } from "./chunk-3SZFUTXE.js";
 import {
   STORAGE
 } from "./chunk-NYBCQZC7.js";
-import {
-  LocalStorageBackend
-} from "./chunk-JWNHNUYL.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -37,4 +37,4 @@ StorageModule = __decorateClass([
 export {
   StorageModule
 };
-//# sourceMappingURL=chunk-RUSUZZAF.js.map
+//# sourceMappingURL=chunk-4MVGAMUA.js.map

package/dist/{chunk-T6SCOJF4.js → chunk-7LKAMLV4.js}

@@ -1,15 +1,15 @@
 import {
   EnvEncryptionKey
 } from "./chunk-IP4OO26U.js";
-import {
-  AuthController
-} from "./chunk-SZVPIHWE.js";
 import {
   DrizzleOAuthStateStore
 } from "./chunk-N5OTOWTP.js";
 import {
   MemoryOAuthStateStore
 } from "./chunk-QLTJSCE6.js";
+import {
+  AuthController
+} from "./chunk-SZVPIHWE.js";
 import {
   AUTH_OPTIONS,
   ENCRYPTION_KEY,
@@ -89,4 +89,4 @@ AuthModule = __decorateClass([
 export {
   AuthModule
 };
-//# sourceMappingURL=chunk-T6SCOJF4.js.map
+//# sourceMappingURL=chunk-7LKAMLV4.js.map

package/dist/{chunk-T4YJRD22.js → chunk-BULPAAD3.js}

@@ -4,9 +4,6 @@ import {
 import {
   MemoryJobStore
 } from "./chunk-SNQ3TOWP.js";
-import {
-  JOBS_MULTI_TENANT
-} from "./chunk-ZPL74UQN.js";
 import {
   JobCollisionError,
   JobNotReplayableError,
@@ -14,6 +11,9 @@ import {
   JobTypeNotFoundError,
   MissingTenantIdError
 } from "./chunk-T4BIIU5E.js";
+import {
+  JOBS_MULTI_TENANT
+} from "./chunk-ZPL74UQN.js";
 import {
   __decorateClass,
   __decorateParam
@@ -632,4 +632,4 @@ function serialiseError(err, attempt, retryable) {
 export {
   MemoryJobOrchestrator
 };
-//# sourceMappingURL=chunk-T4YJRD22.js.map
+//# sourceMappingURL=chunk-BULPAAD3.js.map

package/dist/{chunk-QSJ3J4HE.js → chunk-CDLWYZVQ.js}

@@ -7,13 +7,13 @@ import {
 import {
   MemoryJobStore
 } from "./chunk-SNQ3TOWP.js";
+import {
+  MissingTenantIdError
+} from "./chunk-T4BIIU5E.js";
 import {
   JOBS_MULTI_TENANT,
   JOB_ORCHESTRATOR
 } from "./chunk-ZPL74UQN.js";
-import {
-  MissingTenantIdError
-} from "./chunk-T4BIIU5E.js";
 import {
   __decorateClass,
   __decorateParam
@@ -209,4 +209,4 @@ function compareBy(a, b, order) {
 export {
   MemoryJobRunService
 };
-//# sourceMappingURL=chunk-QSJ3J4HE.js.map
+//# sourceMappingURL=chunk-CDLWYZVQ.js.map

package/dist/{chunk-XWBK3XJK.js → chunk-DCCZB4UC.js}

@@ -1,12 +1,12 @@
-import {
-  INTEGRATION_MULTI_TENANT
-} from "./chunk-S7C6TIIF.js";
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
 import {
   integrationSubscriptions
 } from "./chunk-HNWZFNKP.js";
+import {
+  INTEGRATION_MULTI_TENANT
+} from "./chunk-S7C6TIIF.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -97,4 +97,4 @@ PostgresCursorStore = __decorateClass([
 export {
   PostgresCursorStore
 };
-//# sourceMappingURL=chunk-XWBK3XJK.js.map
+//# sourceMappingURL=chunk-DCCZB4UC.js.map

package/dist/{chunk-DLG62MQY.js → chunk-DTXH24LR.js}

@@ -4,19 +4,19 @@ import {
 import {
   bridgeDelivery
 } from "./chunk-2TVVBC53.js";
-import {
-  jobRuns
-} from "./chunk-OKXZ63IA.js";
 import {
   JOBS_LISTEN_NOTIFY
 } from "./chunk-ZPL74UQN.js";
 import {
-  BRIDGE_REGISTRY
-} from "./chunk-4LH67P4U.js";
+  jobRuns
+} from "./chunk-OKXZ63IA.js";
 import {
   JOBS_WAKE_CHANNEL,
   pgNotify
 } from "./chunk-MYQIQ27N.js";
+import {
+  BRIDGE_REGISTRY
+} from "./chunk-4LH67P4U.js";
 import {
   __decorateClass,
   __decorateParam
@@ -151,4 +151,4 @@ BridgeOutboxDrainHook = __decorateClass([
 export {
   BridgeOutboxDrainHook
 };
-//# sourceMappingURL=chunk-DLG62MQY.js.map
+//# sourceMappingURL=chunk-DTXH24LR.js.map

package/dist/{chunk-AYC2HEAL.js → chunk-GJDEPTPY.js}

@@ -1,9 +1,9 @@
 import {
   JobWorker
-} from "./chunk-JM3T27ZW.js";
+} from "./chunk-OITTYGJS.js";
 import {
   JobsDomainModule
-} from "./chunk-DGYTSCKN.js";
+} from "./chunk-3MAZ4TQH.js";
 import {
   BULLMQ_CONNECTION,
   BULLMQ_RESOLVED_CONFIG,
@@ -14,6 +14,10 @@ import {
   allPoolNames,
   loadPoolConfig
 } from "./chunk-RHVN6NA7.js";
+import {
+  BootValidationError,
+  ReservedPoolViolationError
+} from "./chunk-T4BIIU5E.js";
 import {
   HandlerRegistry
 } from "./chunk-CO6LUM72.js";
@@ -22,10 +26,6 @@ import {
   JOB_RUN_SERVICE,
   JOB_STEP_SERVICE
 } from "./chunk-ZPL74UQN.js";
-import {
-  BootValidationError,
-  ReservedPoolViolationError
-} from "./chunk-T4BIIU5E.js";
 import {
   tokenKey
 } from "./chunk-GYGNEQSC.js";
@@ -290,4 +290,4 @@ export {
   JobWorkerOrchestrator,
   JobWorkerModule
 };
-//# sourceMappingURL=chunk-AYC2HEAL.js.map
+//# sourceMappingURL=chunk-GJDEPTPY.js.map

package/dist/{chunk-2WDX6I7T.js → chunk-IOQMMH6C.js}

@@ -3807,6 +3807,15 @@ function formatMermaidGraph(result) {
 }
 
 // src/patterns/library/activity.pattern.ts
+import { z as z6 } from "zod";
+var ActivityPatternConfigSchema = z6.object({
+  /** Subject entity name → derives the FK column `<subject>_id`. */
+  subject: z6.string().optional(),
+  /** Explicit snake_case FK column, when it does not follow `<subject>_id`. */
+  subjectColumn: z6.string().optional(),
+  /** snake_case recency-ordering column; defaults to `occurred_at`. */
+  occurredAt: z6.string().optional()
+}).strict();
 var ActivityPattern = definePattern({
   name: "Activity",
   extends: ["Base"],
@@ -3814,15 +3823,16 @@ var ActivityPattern = definePattern({
   serviceClass: "ActivityEntityService",
   repositoryImport: "@shared/base-classes/activity-entity-repository",
   serviceImport: "@shared/base-classes/activity-entity-service",
+  configSchema: ActivityPatternConfigSchema,
   repositoryInheritedMethods: [
     "findById, findByIds, list, count, exists, create, update, delete, upsertMany",
-    "findByDateRange, findByUserId, findByOpportunityId, findRecentByOpportunityId"
+    "findByDateRange, findByUserId, findBySubjectId, findRecentBySubjectId"
   ],
   serviceInheritedMethods: [
     "findById, findByIds, list, count, exists, create, update, delete",
-    "findByDateRange, findByUserId, findByOpportunityId, findRecentByOpportunityId"
+    "findByDateRange, findByUser, findBySubject, findRecent"
   ],
-  description: "Time-bounded interaction entities \u2014 date-range + opportunity scoped lookups"
+  description: "Subject-scoped interaction entities \u2014 date-range + actor + config-driven subject lookups"
 });
 
 // src/patterns/library/base.pattern.ts
@@ -3842,8 +3852,8 @@ var BasePattern = definePattern({
 });
 
 // src/patterns/library/junction.pattern.ts
-import { z as z6 } from "zod";
-var JunctionPatternConfigSchema = z6.object({}).strict();
+import { z as z7 } from "zod";
+var JunctionPatternConfigSchema = z7.object({}).strict();
 var JunctionPattern = definePattern({
   name: "Junction",
   description: "Explicit many-to-many junction with role + temporal + sourcing metadata",
@@ -4039,4 +4049,4 @@ export {
   analyzeDomain,
   validateEntities
 };
-//# sourceMappingURL=chunk-2WDX6I7T.js.map
+//# sourceMappingURL=chunk-IOQMMH6C.js.map