@pattern-stack/codegen 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -4,6 +4,99 @@ 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? }`** —
+`WebhookChangeSource` now prefers a queue-yielded `eventId` for
+`Change<T>.dedupKey` (gap #6 follow-through, swe-brain ADR-0009 Amendment B
+§B5). swe-brain's Slack inbound drain documented an `eventIdField: 'externalId'`
+substitution — delivery dedup happens at the receiver, so record identity stood
+in for event identity. That substitution becomes genuinely unsafe once a message
+and its edit (same `externalId`, different vendor event) can share one drain
+batch — they'd collapse to a single `dedupKey`. Vendor delivery metadata (the
+event id) should never need a field on the vendor-neutral canonical record; the
+queue-yield is the right channel for it. Backward-compatible: callbacks that
+yield `{ record, cursor? }` and configs that set `webhook.eventIdField` are
+unchanged; opting into `eventId` is the only migration, and it's optional.
+
+### Changed
+
+- **`WebhookFetchCallback<T>` yield shape** is now `{ record: T; eventId?:
+  string; cursor?: WebhookCursor }` (was `{ record: T; cursor?: WebhookCursor }`)
+  — the new `eventId` is opt-in and additive; existing callbacks compile and run
+  unchanged.
+- **`WebhookChangeSource.dedupKey` precedence** is now **yielded `eventId` >
+  `webhook.eventIdField` record extraction > undefined**. A non-empty yielded
+  `eventId` always wins; otherwise the configured `eventIdField` is read off the
+  emitted record (and still throws if the field is configured but absent on the
+  record); with neither, `dedupKey` is `undefined` (the orchestrator simply has
+  no delivery-level dedup signal for that change).
+- **`detection-config.schema.ts`: `webhook.eventIdField` is now optional**
+  (`z.string().min(1).optional()`). A callback that always yields `eventId` need
+  not declare a record field for it. The `webhook` block itself stays
+  structurally required in webhook mode (an empty `{}` is valid; a missing block
+  is not), so the existing "webhook-mode missing webhook block" validation is
+  unaffected.
+
+### Docs
+
+- ADR-033 §1 amended (the `webhook: { eventIdField? }` shape + the yield channel
+  + dedupKey precedence), integration `SKILL.md` + consumer
+  `change-sources-and-sinks.md` updated to the yield-preferred precedence.
+
 ## [0.16.0] — 2026-06-04
 
 **Postgres LISTEN/NOTIFY wakeups** for the jobs worker + events outbox drainer

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/consumer-skills/integration/change-sources-and-sinks.md

@@ -75,7 +75,7 @@ interface Change<T> {
   record: T;                           // canonical shape — provider mapping happens in the adapter
   cursor: unknown;                     // typed internally; opaque at the seam
   source: 'poll' | 'cdc' | 'webhook';  // provenance for the run-log audit
-  dedupKey?: string;                   // CDC replay_id / webhook event_id when available
+  dedupKey?: string;                   // CDC replay_id / webhook event id when available (webhook: prefers the eventId yielded by WebhookFetchCallback, else webhook.eventIdField)
   providerChangedFields?: string[];    // CDC-only hint; lets the differ skip untouched fields
 }
 ```

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

@@ -1,21 +1,18 @@
-import {
-  DrizzleJobStepService
-} from "./chunk-DV4RV2DC.js";
-import {
-  DrizzleJobOrchestrator
-} from "./chunk-OTR44OH6.js";
 import {
   MemoryJobOrchestrator
 } from "./chunk-BULPAAD3.js";
-import {
-  MemoryJobStepService
-} from "./chunk-PNZSGAB2.js";
 import {
   DrizzleJobRunService
-} from "./chunk-VNBC3VXM.js";
+} from "./chunk-3VEVGL74.js";
 import {
   MemoryJobRunService
-} from "./chunk-BHZP6LOV.js";
+} from "./chunk-CDLWYZVQ.js";
+import {
+  DrizzleJobStepService
+} from "./chunk-DV4RV2DC.js";
+import {
+  MemoryJobStepService
+} from "./chunk-PNZSGAB2.js";
 import {
   MemoryJobStore
 } from "./chunk-SNQ3TOWP.js";
@@ -24,6 +21,9 @@ import {
   BULLMQ_RESOLVED_CONFIG,
   resolveBullMqConfig
 } from "./chunk-I6MVCB5A.js";
+import {
+  DrizzleJobOrchestrator
+} from "./chunk-OTR44OH6.js";
 import {
   JOBS_LISTEN_NOTIFY,
   JOBS_MULTI_TENANT,
@@ -114,4 +114,4 @@ JobsDomainModule = __decorateClass([
 export {
   JobsDomainModule
 };
-//# sourceMappingURL=chunk-3RWMQC3K.js.map
+//# sourceMappingURL=chunk-3MAZ4TQH.js.map

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

@@ -1,12 +1,12 @@
-import {
-  MissingTenantIdError
-} from "./chunk-T4BIIU5E.js";
 import {
   clampLimit,
   decodeKeysetCursor,
   encodeKeysetCursor,
   toJobRunSummary
 } from "./chunk-L3LZWWSX.js";
+import {
+  MissingTenantIdError
+} from "./chunk-T4BIIU5E.js";
 import {
   JOBS_MULTI_TENANT,
   JOB_ORCHESTRATOR
@@ -198,4 +198,4 @@ DrizzleJobRunService = __decorateClass([
 export {
   DrizzleJobRunService
 };
-//# sourceMappingURL=chunk-VNBC3VXM.js.map
+//# sourceMappingURL=chunk-3VEVGL74.js.map

package/dist/{chunk-WWGYCIJX.js → chunk-43SBT72G.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-4MF3HKJA.js";
 import {
   WebhookChangeSource
-} from "./chunk-YLPAPPLW.js";
+} from "./chunk-TIZXQU26.js";
 
 // runtime/subsystems/integration/build-change-source.ts
 function buildChangeSource(cfg, fetch, middlewares = []) {
@@ -26,4 +26,4 @@ function buildChangeSource(cfg, fetch, middlewares = []) {
 export {
   buildChangeSource
 };
-//# sourceMappingURL=chunk-WWGYCIJX.js.map
+//# sourceMappingURL=chunk-43SBT72G.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-BK5ICA2F.js → chunk-4MVGAMUA.js}

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

package/dist/{chunk-3NMCDN7L.js → chunk-5TK7MEN4.js}

@@ -58,7 +58,7 @@ var PollDetectionSchema = z.object({
   provenance: z.enum(["poll", "cdc"]).optional()
 });
 var WebhookDetectionSchema = z.object({
-  eventIdField: z.string().min(1)
+  eventIdField: z.string().min(1).optional()
 });
 var PollModeSchema = z.object({
   mode: z.literal("poll"),
@@ -87,4 +87,4 @@ export {
   WebhookDetectionSchema,
   DetectionConfigSchema
 };
-//# sourceMappingURL=chunk-3NMCDN7L.js.map
+//# sourceMappingURL=chunk-5TK7MEN4.js.map

package/dist/chunk-5TK7MEN4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/integration/detection-config.schema.ts"],"sourcesContent":["/**\n * Integration subsystem — DetectionConfig schema (#226-1)\n *\n * Canonical Zod schema for per-entity integration detection config. The schema is\n * the single source of truth for filter/mapping shape and is consumed by:\n *\n *   1. Runtime primitives — `PollChangeSource<T>`, `WebhookChangeSource<T>`\n *      (#226-3, #226-4) accept a parsed `DetectionConfig` at construction.\n *   2. Codegen — `src/schema/entity-definition.schema.ts` (#226-6) imports\n *      this schema so per-entity YAML `detection:` blocks validate against\n *      the same shape the runtime enforces.\n *\n * Locked decisions (see ADR-033 + decision memo Q1–Q6):\n *   - Filter vocabulary is flat AND of `{ field, op, value }` triples; richer\n *     boolean expressions (OR / NOT / nested) are deferred per epic open Q3.\n *   - Cursor strategy is a tagged union over the four shapes the three modes\n *     need (`systemModstamp`, `replayId`, `timestamp`, `eventId`). Each\n *     strategy types its cursor internally; the orchestrator persists what\n *     the iterator last yielded (integration skill rule 2).\n *   - `mode: 'poll'` may opt into `provenance: 'cdc'` so Stripe-style event\n *     endpoints (mechanically a poll, semantically CDC) reuse the poll\n *     primitive while emitting `Change<T>.source = 'cdc'`. Long-lived\n *     streaming CDC (SFDC Pub-Sub, Debezium) is a separate primitive\n *     deferred to #226-8.\n *   - `webhook` mode's `eventIdField` is optional: `WebhookChangeSource<T>`\n *     prefers an `eventId` yielded by the queue iterator and falls back to the\n *     `eventIdField` record extraction (precedence: yielded eventId >\n *     eventIdField extraction > undefined dedupKey).\n */\nimport { z } from \"zod\";\n\n// ============================================================================\n// Field mapping — provider field → canonical target\n// ============================================================================\n\n/**\n * Maps a single provider field onto the canonical record. `transform` is an\n * opt-in tag the adapter callback may inspect (`date-iso`, `decimal-string`,\n * etc.); the schema does not enumerate transforms — adapters interpret them.\n */\nexport const FieldMappingSchema = z.object({\n\tsource: z.string().min(1),\n\ttarget: z.string().min(1),\n\ttransform: z.string().min(1).optional(),\n});\n\nexport type FieldMapping = z.infer<typeof FieldMappingSchema>;\n\n// ============================================================================\n// Resolved filter — flat-AND triple\n// ============================================================================\n\n/**\n * A single resolved filter clause applied at fetch time. `value` is `unknown`\n * to admit primitives, arrays (for `in` / `nin`), and dates as ISO strings —\n * adapters interpret per provider.\n */\nexport const ResolvedFilterSchema = z.object({\n\tfield: z.string().min(1),\n\top: z.enum([\"eq\", \"neq\", \"in\", \"nin\", \"gt\", \"gte\", \"lt\", \"lte\"]),\n\tvalue: z.unknown(),\n});\n\nexport type ResolvedFilter = z.infer<typeof ResolvedFilterSchema>;\n\n// ============================================================================\n// Cursor strategy — tagged union over the four shapes the modes need\n// ============================================================================\n\nconst SystemModstampCursorSchema = z.object({\n\tkind: z.literal(\"systemModstamp\"),\n\tfield: z.string().min(1),\n});\n\nconst ReplayIdCursorSchema = z.object({\n\tkind: z.literal(\"replayId\"),\n\tfield: z.string().min(1),\n});\n\nconst TimestampCursorSchema = z.object({\n\tkind: z.literal(\"timestamp\"),\n\tfield: z.string().min(1),\n});\n\nconst EventIdCursorSchema = z.object({\n\tkind: z.literal(\"eventId\"),\n\tfield: z.string().min(1),\n});\n\n/**\n * Gmail `historyId` (RFC-0003 §3) — an opaque, atomic vendor token. The next\n * watermark only exists at end-of-walk; there is no resumable mid-walk value.\n * `field` is metadata for codegen/adapters (the response key the token lives on).\n */\nconst HistoryIdCursorSchema = z.object({\n\tkind: z.literal(\"historyId\"),\n\tfield: z.string().min(1),\n});\n\n/**\n * Google Calendar `syncToken` (RFC-0003 §3) — an opaque, atomic sync token,\n * same divisibility profile as `historyId`.\n */\nconst SyncTokenCursorSchema = z.object({\n\tkind: z.literal(\"syncToken\"),\n\tfield: z.string().min(1),\n});\n\nexport const CursorStrategySchema = z.discriminatedUnion(\"kind\", [\n\tSystemModstampCursorSchema,\n\tReplayIdCursorSchema,\n\tTimestampCursorSchema,\n\tEventIdCursorSchema,\n\tHistoryIdCursorSchema,\n\tSyncTokenCursorSchema,\n]);\n\nexport type CursorStrategy = z.infer<typeof CursorStrategySchema>;\n\n// ============================================================================\n// Cursor divisibility (RFC-0003 §3)\n// ============================================================================\n\n/**\n * Whether a cursor strategy is *divisible* — a property of the strategy, not\n * the read primitive. Divisible cursors are sortable/monotonic watermarks whose\n * value is meaningful AS OF any single record (HubSpot `systemModstamp`, a\n * `timestamp` field, a Salesforce CDC `replayId`); the read primitive may\n * checkpoint per-ref mid-walk, so a crash resumes from the last delivered ref.\n *\n * Atomic cursors are opaque vendor tokens (Gmail `historyId`, Calendar\n * `syncToken`, a generic `eventId`) whose next value only exists at end-of-walk.\n * The primitive must withhold per-ref cursors and emit the token only at a safe\n * boundary, so an interrupted run never persists an unresumable mid-walk token\n * (it resumes all-or-nothing from the prior token — see `IncrementalReadBase`).\n *\n * `eventId` is classified atomic conservatively: a generic opaque id is treated\n * all-or-nothing unless a concrete strategy proves it monotonically resumable.\n */\nexport const CURSOR_DIVISIBILITY: Readonly<\n\tRecord<CursorStrategy[\"kind\"], boolean>\n> = {\n\tsystemModstamp: true,\n\ttimestamp: true,\n\treplayId: true,\n\teventId: false,\n\thistoryId: false,\n\tsyncToken: false,\n};\n\n/** Predicate form of {@link CURSOR_DIVISIBILITY}. */\nexport function isDivisibleCursor(kind: CursorStrategy[\"kind\"]): boolean {\n\treturn CURSOR_DIVISIBILITY[kind];\n}\n\n// ============================================================================\n// Mode-specific blocks\n// ============================================================================\n\n/**\n * Poll-mode block. `provenance: 'cdc'` opts the poll primitive into stamping\n * `Change<T>.source = 'cdc'` and populating `dedupKey` from the cursor's\n * `field` — used for Stripe-style event endpoints. Defaults to `'poll'`.\n */\nexport const PollDetectionSchema = z.object({\n\tcursor: CursorStrategySchema,\n\tprovenance: z.enum([\"poll\", \"cdc\"]).optional(),\n});\n\nexport type PollDetection = z.infer<typeof PollDetectionSchema>;\n\n/**\n * Webhook-mode block. `eventIdField`, when present, names the field on the\n * emitted canonical record that `WebhookChangeSource<T>` reads to set\n * `Change<T>.dedupKey` — used only as the fallback when the queue iterator\n * does NOT yield an `eventId` alongside the record.\n *\n * `eventIdField` is **optional**: a queue iterator that always yields an\n * `eventId` (vendor delivery metadata, the preferred channel) need not declare\n * a record field for it. dedupKey precedence is: yielded `eventId` >\n * `eventIdField` record extraction > undefined.\n */\nexport const WebhookDetectionSchema = z.object({\n\teventIdField: z.string().min(1).optional(),\n});\n\nexport type WebhookDetection = z.infer<typeof WebhookDetectionSchema>;\n\n// ============================================================================\n// DetectionConfig — top-level discriminated union over `mode`\n// ============================================================================\n\nconst PollModeSchema = z.object({\n\tmode: z.literal(\"poll\"),\n\tpoll: PollDetectionSchema,\n\tmapping: z.array(FieldMappingSchema).min(1),\n\tfilters: z.array(ResolvedFilterSchema).default([]),\n});\n\nconst WebhookModeSchema = z.object({\n\tmode: z.literal(\"webhook\"),\n\twebhook: WebhookDetectionSchema,\n\tmapping: z.array(FieldMappingSchema).min(1),\n\tfilters: z.array(ResolvedFilterSchema).default([]),\n});\n\n/**\n * Top-level detection config. Discriminated on `mode` so the relevant\n * mode-block (poll/webhook) is structurally required for that mode. CDC as a\n * long-lived streaming primitive is deferred (#226-8); CDC-as-provenance\n * (Stripe-style event endpoints) is expressed via `mode: 'poll'` with\n * `poll.provenance: 'cdc'`.\n */\nexport const DetectionConfigSchema = z.discriminatedUnion(\"mode\", [\n\tPollModeSchema,\n\tWebhookModeSchema,\n]);\n\nexport type DetectionConfig = z.infer<typeof DetectionConfigSchema>;\n"],"mappings":";AA6BA,SAAS,SAAS;AAWX,IAAM,qBAAqB,EAAE,OAAO;AAAA,EAC1C,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACxB,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACxB,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AACvC,CAAC;AAaM,IAAM,uBAAuB,EAAE,OAAO;AAAA,EAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACvB,IAAI,EAAE,KAAK,CAAC,MAAM,OAAO,MAAM,OAAO,MAAM,OAAO,MAAM,KAAK,CAAC;AAAA,EAC/D,OAAO,EAAE,QAAQ;AAClB,CAAC;AAQD,IAAM,6BAA6B,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,QAAQ,gBAAgB;AAAA,EAChC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACxB,CAAC;AAED,IAAM,uBAAuB,EAAE,OAAO;AAAA,EACrC,MAAM,EAAE,QAAQ,UAAU;AAAA,EAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACxB,CAAC;AAED,IAAM,wBAAwB,EAAE,OAAO;AAAA,EACtC,MAAM,EAAE,QAAQ,WAAW;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACxB,CAAC;AAED,IAAM,sBAAsB,EAAE,OAAO;AAAA,EACpC,MAAM,EAAE,QAAQ,SAAS;AAAA,EACzB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACxB,CAAC;AAOD,IAAM,wBAAwB,EAAE,OAAO;AAAA,EACtC,MAAM,EAAE,QAAQ,WAAW;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACxB,CAAC;AAMD,IAAM,wBAAwB,EAAE,OAAO;AAAA,EACtC,MAAM,EAAE,QAAQ,WAAW;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACxB,CAAC;AAEM,IAAM,uBAAuB,EAAE,mBAAmB,QAAQ;AAAA,EAChE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,CAAC;AAwBM,IAAM,sBAET;AAAA,EACH,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,UAAU;AAAA,EACV,SAAS;AAAA,EACT,WAAW;AAAA,EACX,WAAW;AACZ;AAGO,SAAS,kBAAkB,MAAuC;AACxE,SAAO,oBAAoB,IAAI;AAChC;AAWO,IAAM,sBAAsB,EAAE,OAAO;AAAA,EAC3C,QAAQ;AAAA,EACR,YAAY,EAAE,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,SAAS;AAC9C,CAAC;AAeM,IAAM,yBAAyB,EAAE,OAAO;AAAA,EAC9C,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AAC1C,CAAC;AAQD,IAAM,iBAAiB,EAAE,OAAO;AAAA,EAC/B,MAAM,EAAE,QAAQ,MAAM;AAAA,EACtB,MAAM;AAAA,EACN,SAAS,EAAE,MAAM,kBAAkB,EAAE,IAAI,CAAC;AAAA,EAC1C,SAAS,EAAE,MAAM,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,IAAM,oBAAoB,EAAE,OAAO;AAAA,EAClC,MAAM,EAAE,QAAQ,SAAS;AAAA,EACzB,SAAS;AAAA,EACT,SAAS,EAAE,MAAM,kBAAkB,EAAE,IAAI,CAAC;AAAA,EAC1C,SAAS,EAAE,MAAM,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AASM,IAAM,wBAAwB,EAAE,mBAAmB,QAAQ;AAAA,EACjE;AAAA,EACA;AACD,CAAC;","names":[]}

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-BHZP6LOV.js → chunk-CDLWYZVQ.js}

@@ -1,15 +1,15 @@
-import {
-  MemoryJobStore
-} from "./chunk-SNQ3TOWP.js";
-import {
-  MissingTenantIdError
-} from "./chunk-T4BIIU5E.js";
 import {
   clampLimit,
   decodeKeysetCursor,
   encodeKeysetCursor,
   toJobRunSummary
 } from "./chunk-L3LZWWSX.js";
+import {
+  MemoryJobStore
+} from "./chunk-SNQ3TOWP.js";
+import {
+  MissingTenantIdError
+} from "./chunk-T4BIIU5E.js";
 import {
   JOBS_MULTI_TENANT,
   JOB_ORCHESTRATOR
@@ -209,4 +209,4 @@ function compareBy(a, b, order) {
 export {
   MemoryJobRunService
 };
-//# sourceMappingURL=chunk-BHZP6LOV.js.map
+//# sourceMappingURL=chunk-CDLWYZVQ.js.map

package/dist/{chunk-DKKFTHHI.js → chunk-CZQUOIDY.js}

@@ -1,6 +1,3 @@
-import {
-  NoopAnalyticsBackend
-} from "./chunk-J37YWU7Y.js";
 import {
   CubeAnalyticsBackend
 } from "./chunk-7B3RYX45.js";
@@ -9,6 +6,9 @@ import {
   CUBE_API_SECRET,
   CUBE_API_URL
 } from "./chunk-6I7ULIN6.js";
+import {
+  NoopAnalyticsBackend
+} from "./chunk-J37YWU7Y.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -50,4 +50,4 @@ AnalyticsModule = __decorateClass([
 export {
   AnalyticsModule
 };
-//# sourceMappingURL=chunk-DKKFTHHI.js.map
+//# sourceMappingURL=chunk-CZQUOIDY.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-EBKVKN75.js → chunk-DTXH24LR.js}

@@ -1,6 +1,6 @@
 import {
   BRIDGE_DELIVERY_JOB_TYPE
-} from "./chunk-DRCLNYH7.js";
+} from "./chunk-NXNVTXKG.js";
 import {
   bridgeDelivery
 } from "./chunk-2TVVBC53.js";
@@ -151,4 +151,4 @@ BridgeOutboxDrainHook = __decorateClass([
 export {
   BridgeOutboxDrainHook
 };
-//# sourceMappingURL=chunk-EBKVKN75.js.map
+//# sourceMappingURL=chunk-DTXH24LR.js.map

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

@@ -1,13 +1,9 @@
 import {
   JobWorker
-} from "./chunk-XDIIVIIK.js";
+} from "./chunk-OITTYGJS.js";
 import {
   JobsDomainModule
-} from "./chunk-3RWMQC3K.js";
-import {
-  BootValidationError,
-  ReservedPoolViolationError
-} from "./chunk-T4BIIU5E.js";
+} from "./chunk-3MAZ4TQH.js";
 import {
   BULLMQ_CONNECTION,
   BULLMQ_RESOLVED_CONFIG,
@@ -18,14 +14,18 @@ import {
   allPoolNames,
   loadPoolConfig
 } from "./chunk-RHVN6NA7.js";
+import {
+  BootValidationError,
+  ReservedPoolViolationError
+} from "./chunk-T4BIIU5E.js";
+import {
+  HandlerRegistry
+} from "./chunk-CO6LUM72.js";
 import {
   JOB_ORCHESTRATOR,
   JOB_RUN_SERVICE,
   JOB_STEP_SERVICE
 } from "./chunk-ZPL74UQN.js";
-import {
-  HandlerRegistry
-} from "./chunk-CO6LUM72.js";
 import {
   tokenKey
 } from "./chunk-GYGNEQSC.js";
@@ -290,4 +290,4 @@ export {
   JobWorkerOrchestrator,
   JobWorkerModule
 };
-//# sourceMappingURL=chunk-RUYLXR5F.js.map
+//# sourceMappingURL=chunk-GJDEPTPY.js.map

package/dist/{chunk-32DOFN3T.js → chunk-IOQMMH6C.js}

@@ -1,6 +1,6 @@
 import {
   DetectionConfigSchema
-} from "./chunk-3NMCDN7L.js";
+} from "./chunk-5TK7MEN4.js";
 
 // src/parser/load-entities.ts
 import { resolve as resolve2 } from "path";
@@ -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-32DOFN3T.js.map
+//# sourceMappingURL=chunk-IOQMMH6C.js.map