hierarchical-approval 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -7,6 +7,93 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 _Nothing yet._
 
+## [1.2.0] - 2026-09-04
+
+### Added — template inheritance
+
+- **`extends` derives one template from another.** ERP tenants run many
+  near-identical workflows — one per region, legal entity or document class —
+  that share a spine and differ in a level or two. Each had to be written out in
+  full, so a change to the shared part meant editing every copy and hoping none
+  were missed.
+
+  ```ts
+  await engine.defineTemplate({
+    name: 'PO-EU',
+    extends: 'PO-base',
+    documentType: 'purchase_order',
+    removeLevels: [2],
+    levels: [{ level: 3, approvers: [{ type: 'user', userId: 'eu-fin' }] }],
+  });
+  ```
+
+  Levels are keyed by number: a child level overrides the base level *field by
+  field* (so a derived template can swap just the approvers and inherit name,
+  mode and deadlines), child-only levels are appended, and `removeLevels` drops
+  inherited ones. `conditions` are replaced wholesale when supplied — merging
+  two rule lists would produce a chain neither author intended. `escalation`,
+  `slaDeadlineDays` and `allowOverride` are inherited unless the child sets them.
+
+- **Resolution happens once, at define time, and the flattened result is what
+  gets stored.** Resolving lazily on read would mean editing a base silently
+  reshapes every derived template — and every in-flight instance running against
+  one — which is exactly the surprise `templateSnapshot` exists to prevent
+  elsewhere in the engine. A base that itself extends something is already
+  flattened, so chains resolve naturally and cycles cannot form.
+
+- **Validation runs on the flattened template**, not the fragment: a derived
+  config carrying no levels of its own is valid (it inherits the chain), while
+  one whose `removeLevels` strips the chain entirely is rejected at definition
+  time. `extends` and `removeLevels` are directives for the call and are not
+  persisted.
+
+## [1.1.0] - 2026-09-04
+
+### Added — approval reminders
+
+- **Levels can nudge their pending approvers before escalating.** Escalation
+  reassigns work, which is the wrong instrument for an approval that is merely
+  late; the only alternative was an out-of-band cron job reading the database.
+
+  ```ts
+  { level: 1, name: 'Manager', ...,
+    reminderAfterDays: 2,   // first nudge two days after the level opens
+    reminderEveryDays: 1,   // then daily
+    maxReminders: 3 }       // default 3
+  ```
+
+  Emits `approval:reminder` (`level`, `recipients`, `reminderNumber`), records a
+  `reminded` audit entry, and increments `approval.reminded`. Recipients exclude
+  anyone who has already voted, so a half-decided quorum level stops pestering
+  the approvers who did their part. Reminders stop when the level closes or the
+  cap is reached, and never change who can approve or when the level escalates.
+
+  `validateTemplate()` rejects non-positive intervals, a non-integer
+  `maxReminders`, and `reminderEveryDays` without `reminderAfterDays` — which
+  would configure a repeat for a reminder that never fires.
+
+  New export: `ReminderEvent`. `EscalationSchedulerOpts` gains `onRemind`.
+
+### Fixed — escalation could not reach every branch of a parallel group
+
+- **Only the lowest-numbered branch of a parallel group could escalate.** Both
+  the scheduler and `MemoryAdapter.getOverdueInstances` matched levels against
+  `instance.currentLevel`, which names just one level of a group. An overdue
+  upper branch was never fetched and never escalated — it would wait forever.
+  Introduced with parallel groups in 1.0.0.
+
+  Escalation now considers every open branch, and `escalateInternal` takes the
+  level to escalate rather than assuming the current one.
+
+  This also settles a pre-existing disagreement between the adapters:
+  `PostgresAdapter` already scanned *all* levels for `escalationDueAt` while
+  `MemoryAdapter` scanned one, so the same template escalated differently
+  depending on which adapter was in use. Both now scan every open branch.
+
+- **`getOverdueInstances` also reports due reminders** in both adapters —
+  without which the scheduler would never see a reminder-due instance and no
+  reminder would ever be sent.
+
 ## [1.0.0] - 2026-09-04
 
 First stable release. The public API is now considered settled: breaking changes

package/README.md

@@ -399,6 +399,65 @@ engine.registerConditionOperator('between', (actual, expected) => {
 });
 ```
 
+### Template inheritance
+
+ERP tenants run many near-identical workflows — one per region, entity or
+document class — that share a spine and differ in a level or two. `extends`
+derives one template from another:
+
+```ts
+await engine.defineTemplate({
+  name: 'PO-EU',
+  extends: 'PO-base',
+  documentType: 'purchase_order',
+  removeLevels: [2],                       // drop an inherited level
+  levels: [
+    { level: 3, approvers: [{ type: 'user', userId: 'eu-fin' }] },  // override just the approvers
+    { level: 4, name: 'EU Compliance', approvers: [...], mode: 'any' }, // add a new level
+  ],
+});
+```
+
+| Field | Merge rule |
+|---|---|
+| `levels` | Keyed by level number: a child level overrides the base level *field by field*, child-only levels are appended, `removeLevels` drops inherited ones |
+| `conditions` | Replaced wholesale when the child supplies them |
+| `escalation`, `slaDeadlineDays`, `allowOverride` | Child value if set, otherwise inherited |
+
+**Resolution happens once, at define time, and the flattened result is stored.**
+Editing a base later never silently reshapes a derived template or an instance
+already running against one — the same insulation `templateSnapshot` gives
+in-flight instances. A base that itself extends something is already flattened,
+so chains resolve naturally and cycles cannot form.
+
+Validation runs on the *flattened* template, so a derived config that strips its
+whole chain is rejected at definition time.
+
+### Reminders
+
+Escalation reassigns work; a reminder only nudges, which is usually what an
+overdue-but-not-yet-critical approval needs. Configure it per level:
+
+```ts
+{
+  level: 1,
+  name: 'Manager',
+  approvers: [{ type: 'user', userId: 'mgr-1' }],
+  mode: 'any',
+  reminderAfterDays: 2,   // first nudge two days after the level opens
+  reminderEveryDays: 1,   // then daily
+  maxReminders: 3,        // default is 3
+}
+```
+
+Emits `approval:reminder` with `level`, `recipients` and `reminderNumber`, and
+records a `reminded` audit entry. Recipients exclude anyone who has already
+voted, so a half-decided quorum level stops pestering the approvers who did
+their part. Reminders stop when the level closes or the cap is reached, and they
+never change who can approve or when the level escalates.
+
+Requires the escalation scheduler to be running (it is by default).
+
 ### Parallel branch groups
 
 Give levels the same `group` name and they activate together, joining before

package/dist/{ApprovalEngine-DzHUWix1.d.cts → ApprovalEngine-CdtOJOsu.d.cts}

@@ -1,14 +1,14 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-D-yIRiET.cjs';
-import { k as ConditionExpression, o as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, j as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-iaAIdMbs.cjs';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-Dld84ihs.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-CKV_FZFV.cjs';
+import { k as ConditionExpression, o as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, j as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-BsM0DUPf.cjs';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-BKMeGmaG.cjs';
 import { z } from 'zod';
 import { L as Logger } from './Logger-BplhlU7l.cjs';
 import { C as Clock } from './Clock-3FnOczFJ.cjs';
-import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-BSfjsnTe.cjs';
-import { I as IAuditAdapter } from './IAuditAdapter-zVO7XpWm.cjs';
-import { I as IMetricsAdapter } from './IMetricsAdapter-t7QpfA1I.cjs';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-BLw9Oc-S.cjs';
+import { I as IAuditAdapter } from './IAuditAdapter-B2I3CjaJ.cjs';
+import { I as IMetricsAdapter } from './IMetricsAdapter-QvyaKQCc.cjs';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.cjs';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-Dx9NzWx8.cjs';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-BHDZK9QL.cjs';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -521,6 +521,21 @@ declare class ApprovalEngine {
     private findNextGroup;
     /** Resolve approvers for a group, set its deadlines, and mark it pending. */
     private activateGroup;
+    /**
+     * Set (or clear) the next reminder deadline for a level that has just opened.
+     *
+     * Called wherever a level becomes pending, so a level activated by submit,
+     * by advancing, or by a group activation all schedule alike.
+     */
+    private scheduleReminder;
+    /**
+     * Nudge the approvers who still owe a decision on a pending level.
+     *
+     * Reminders never change who can approve or when the level escalates — they
+     * only notify. Recipients exclude anyone who has already voted, so a
+     * half-decided quorum level stops pestering the approvers who did their part.
+     */
+    private sendReminder;
     private findNextLevel;
     private findPreviousLevel;
     private guardBulkSize;

package/dist/{ApprovalEngine-DB62pkEk.d.ts → ApprovalEngine-DRC-o30z.d.ts}

@@ -1,14 +1,14 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-BYlHnm7_.js';
-import { k as ConditionExpression, o as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, j as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-iaAIdMbs.js';
-import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-u5ZE7wS6.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from './IStorageAdapter-DQJmR6Mt.js';
+import { k as ConditionExpression, o as ResolverFn, g as ApprovalTemplateConfig, A as ApprovalTemplate, j as AuditContext, a as ApprovalInstance, e as ApprovalMode, b as AuditEntry } from './instance-BsM0DUPf.js';
+import { I as INotificationAdapter, b as ApprovalEventName, a as ApprovalEventMap } from './INotificationAdapter-BmSeB7FZ.js';
 import { z } from 'zod';
 import { L as Logger } from './Logger-BplhlU7l.js';
 import { C as Clock } from './Clock-3FnOczFJ.js';
-import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-DndObWfg.js';
-import { I as IAuditAdapter } from './IAuditAdapter-RKagmrfi.js';
-import { I as IMetricsAdapter } from './IMetricsAdapter-t7QpfA1I.js';
+import { I as IOperationMiddleware, a as ApprovalError } from './IOperationMiddleware-BW9t8wPn.js';
+import { I as IAuditAdapter } from './IAuditAdapter-GixC9zS1.js';
+import { I as IMetricsAdapter } from './IMetricsAdapter-QvyaKQCc.js';
 import { I as ISchedulerAdapter } from './ISchedulerAdapter-DKv_QjVN.js';
-import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-DEDQnNzq.js';
+import { I as IAuthorizationPolicy } from './IAuthorizationPolicy-4ge9Gnxj.js';
 
 declare const SubmitOptionsSchema: z.ZodObject<{
     templateName: z.ZodString;
@@ -521,6 +521,21 @@ declare class ApprovalEngine {
     private findNextGroup;
     /** Resolve approvers for a group, set its deadlines, and mark it pending. */
     private activateGroup;
+    /**
+     * Set (or clear) the next reminder deadline for a level that has just opened.
+     *
+     * Called wherever a level becomes pending, so a level activated by submit,
+     * by advancing, or by a group activation all schedule alike.
+     */
+    private scheduleReminder;
+    /**
+     * Nudge the approvers who still owe a decision on a pending level.
+     *
+     * Reminders never change who can approve or when the level escalates — they
+     * only notify. Recipients exclude anyone who has already voted, so a
+     * half-decided quorum level stops pestering the approvers who did their part.
+     */
+    private sendReminder;
     private findNextLevel;
     private findPreviousLevel;
     private guardBulkSize;

package/dist/{IAuditAdapter-zVO7XpWm.d.cts → IAuditAdapter-B2I3CjaJ.d.cts}

@@ -1,4 +1,4 @@
-import { b as AuditEntry, a as ApprovalInstance } from './instance-iaAIdMbs.cjs';
+import { b as AuditEntry, a as ApprovalInstance } from './instance-BsM0DUPf.cjs';
 
 interface IAuditAdapter {
     /**

package/dist/{IAuditAdapter-RKagmrfi.d.ts → IAuditAdapter-GixC9zS1.d.ts}

@@ -1,4 +1,4 @@
-import { b as AuditEntry, a as ApprovalInstance } from './instance-iaAIdMbs.js';
+import { b as AuditEntry, a as ApprovalInstance } from './instance-BsM0DUPf.js';
 
 interface IAuditAdapter {
     /**

package/dist/{IAuthorizationPolicy-DEDQnNzq.d.ts → IAuthorizationPolicy-4ge9Gnxj.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-iaAIdMbs.js';
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-BsM0DUPf.js';
 
 interface AuthorizationContext {
     operation: 'submit' | 'approve' | 'reject' | 'delegate' | 'reassign' | 'cancel' | 'escalate' | 'override' | 'resubmit' | 'addComment' | 'updateData';

package/dist/{IAuthorizationPolicy-Dx9NzWx8.d.cts → IAuthorizationPolicy-BHDZK9QL.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-iaAIdMbs.cjs';
+import { a as ApprovalInstance, d as ApprovalLevelInstance } from './instance-BsM0DUPf.cjs';
 
 interface AuthorizationContext {
     operation: 'submit' | 'approve' | 'reject' | 'delegate' | 'reassign' | 'cancel' | 'escalate' | 'override' | 'resubmit' | 'addComment' | 'updateData';

package/dist/{IMetricsAdapter-t7QpfA1I.d.cts → IMetricsAdapter-QvyaKQCc.d.cts}

@@ -1,4 +1,4 @@
-type MetricName = 'approval.submitted' | 'approval.approved' | 'approval.rejected' | 'approval.cancelled' | 'approval.expired' | 'approval.sla_breached' | 'approval.escalated' | 'approval.reassigned' | 'approval.overridden' | 'approval.data_updated' | 'approval.conflict_retry' | 'approval.operation_duration_ms';
+type MetricName = 'approval.submitted' | 'approval.approved' | 'approval.rejected' | 'approval.cancelled' | 'approval.expired' | 'approval.sla_breached' | 'approval.escalated' | 'approval.reassigned' | 'approval.overridden' | 'approval.data_updated' | 'approval.reminded' | 'approval.conflict_retry' | 'approval.operation_duration_ms';
 interface IMetricsAdapter {
     /** Increment a counter. Synchronous — never awaited. */
     increment(metric: MetricName, labels?: Record<string, string>): void;

package/dist/{IMetricsAdapter-t7QpfA1I.d.ts → IMetricsAdapter-QvyaKQCc.d.ts}

@@ -1,4 +1,4 @@
-type MetricName = 'approval.submitted' | 'approval.approved' | 'approval.rejected' | 'approval.cancelled' | 'approval.expired' | 'approval.sla_breached' | 'approval.escalated' | 'approval.reassigned' | 'approval.overridden' | 'approval.data_updated' | 'approval.conflict_retry' | 'approval.operation_duration_ms';
+type MetricName = 'approval.submitted' | 'approval.approved' | 'approval.rejected' | 'approval.cancelled' | 'approval.expired' | 'approval.sla_breached' | 'approval.escalated' | 'approval.reassigned' | 'approval.overridden' | 'approval.data_updated' | 'approval.reminded' | 'approval.conflict_retry' | 'approval.operation_duration_ms';
 interface IMetricsAdapter {
     /** Increment a counter. Synchronous — never awaited. */
     increment(metric: MetricName, labels?: Record<string, string>): void;

package/dist/{INotificationAdapter-u5ZE7wS6.d.ts → INotificationAdapter-BKMeGmaG.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-iaAIdMbs.js';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-BsM0DUPf.cjs';
 
 interface ApprovalEvent {
     instanceId: string;
@@ -78,6 +78,14 @@ interface DataUpdatedEvent extends ApprovalEvent {
     /** Level numbers removed from the future chain by re-evaluating conditions. */
     removedLevels: number[];
 }
+/** Emitted when a pending level's approvers are nudged. */
+interface ReminderEvent extends ApprovalEvent {
+    level: number;
+    /** Approvers who still owe a decision on this level. */
+    recipients: string[];
+    /** 1 for the first reminder on this level, 2 for the next, and so on. */
+    reminderNumber: number;
+}
 interface ApprovalEventMap {
     'approval:submitted': SubmittedEvent;
     'approval:approved': ApprovedEvent;
@@ -93,6 +101,7 @@ interface ApprovalEventMap {
     'approval:expired': ExpiredEvent;
     'approval:sla_breached': SlaBreachedEvent;
     'approval:data_updated': DataUpdatedEvent;
+    'approval:reminder': ReminderEvent;
 }
 type ApprovalEventName = keyof ApprovalEventMap;
 interface HistoryEntry extends AuditEntry {
@@ -116,4 +125,4 @@ interface INotificationAdapter {
     notify(event: NotificationEvent): Promise<void>;
 }
 
-export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, DelegatedEvent as d, ExpiredEvent as e, RejectedEvent as f, ResubmittedEvent as g, SubmittedEvent as h };
+export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, DelegatedEvent as d, ExpiredEvent as e, RejectedEvent as f, ReminderEvent as g, ResubmittedEvent as h, SubmittedEvent as i };

package/dist/{INotificationAdapter-Dld84ihs.d.cts → INotificationAdapter-BmSeB7FZ.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance, b as AuditEntry } from './instance-iaAIdMbs.cjs';
+import { a as ApprovalInstance, b as AuditEntry } from './instance-BsM0DUPf.js';
 
 interface ApprovalEvent {
     instanceId: string;
@@ -78,6 +78,14 @@ interface DataUpdatedEvent extends ApprovalEvent {
     /** Level numbers removed from the future chain by re-evaluating conditions. */
     removedLevels: number[];
 }
+/** Emitted when a pending level's approvers are nudged. */
+interface ReminderEvent extends ApprovalEvent {
+    level: number;
+    /** Approvers who still owe a decision on this level. */
+    recipients: string[];
+    /** 1 for the first reminder on this level, 2 for the next, and so on. */
+    reminderNumber: number;
+}
 interface ApprovalEventMap {
     'approval:submitted': SubmittedEvent;
     'approval:approved': ApprovedEvent;
@@ -93,6 +101,7 @@ interface ApprovalEventMap {
     'approval:expired': ExpiredEvent;
     'approval:sla_breached': SlaBreachedEvent;
     'approval:data_updated': DataUpdatedEvent;
+    'approval:reminder': ReminderEvent;
 }
 type ApprovalEventName = keyof ApprovalEventMap;
 interface HistoryEntry extends AuditEntry {
@@ -116,4 +125,4 @@ interface INotificationAdapter {
     notify(event: NotificationEvent): Promise<void>;
 }
 
-export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, DelegatedEvent as d, ExpiredEvent as e, RejectedEvent as f, ResubmittedEvent as g, SubmittedEvent as h };
+export type { ApprovalEvent as A, CancelledEvent as C, DataUpdatedEvent as D, EscalatedEvent as E, HistoryEntry as H, INotificationAdapter as I, LevelAdvancedEvent as L, NotificationEvent as N, OverriddenEvent as O, ReassignedEvent as R, SlaBreachedEvent as S, ApprovalEventMap as a, ApprovalEventName as b, ApprovedEvent as c, DelegatedEvent as d, ExpiredEvent as e, RejectedEvent as f, ReminderEvent as g, ResubmittedEvent as h, SubmittedEvent as i };

package/dist/{IOperationMiddleware-BSfjsnTe.d.cts → IOperationMiddleware-BLw9Oc-S.d.cts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance } from './instance-iaAIdMbs.cjs';
+import { a as ApprovalInstance } from './instance-BsM0DUPf.cjs';
 
 declare class ApprovalError extends Error {
     readonly code: string;

package/dist/{IOperationMiddleware-DndObWfg.d.ts → IOperationMiddleware-BW9t8wPn.d.ts}

@@ -1,4 +1,4 @@
-import { a as ApprovalInstance } from './instance-iaAIdMbs.js';
+import { a as ApprovalInstance } from './instance-BsM0DUPf.js';
 
 declare class ApprovalError extends Error {
     readonly code: string;

package/dist/{IStorageAdapter-D-yIRiET.d.cts → IStorageAdapter-CKV_FZFV.d.cts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-iaAIdMbs.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-BsM0DUPf.cjs';
 
 interface PaginationOpts {
     limit: number;

package/dist/{IStorageAdapter-BYlHnm7_.d.ts → IStorageAdapter-DQJmR6Mt.d.ts}

@@ -1,4 +1,4 @@
-import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-iaAIdMbs.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, f as ApprovalStatus, b as AuditEntry } from './instance-BsM0DUPf.js';
 
 interface PaginationOpts {
     limit: number;

package/dist/adapters/MemoryAdapter.cjs

@@ -129,14 +129,18 @@ var MemoryAdapter = class {
       if (i.tenantId !== tenantId || i.status !== "pending") return false;
       if (filter.documentType && i.documentType !== filter.documentType) return false;
       if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;
-      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);
-      const hasOverdueEscalation = currentLevel?.escalationDueAt != null && new Date(currentLevel.escalationDueAt) <= asOf;
+      const hasOverdueEscalation = i.levels.some(
+        (l) => l.escalationDueAt != null && new Date(l.escalationDueAt) <= asOf
+      );
       const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;
       const hasSLABreach = i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;
       const hasDelegationExpiry = i.levels.some(
         (l) => l.status === "pending" && l.delegatedUntil != null && new Date(l.delegatedUntil) <= asOf && l.delegatedFrom != null
       );
-      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry;
+      const hasDueReminder = i.levels.some(
+        (l) => l.status === "pending" && l.reminderDueAt != null && new Date(l.reminderDueAt) <= asOf
+      );
+      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder;
     }).map((i) => reviveDates(deepClone(i)));
   }
   async getInstancesByCursor(tenantId, filter, opts) {

package/dist/adapters/MemoryAdapter.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors.ts","../../src/adapters/MemoryAdapter.ts"],"names":[],"mappings":"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","file":"MemoryAdapter.cjs","sourcesContent":["export class ApprovalError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'ApprovalError';\n  }\n\n  toJSON(): { code: string; message: string; name: string } {\n    return { code: this.code, message: this.message, name: this.name };\n  }\n\n  toHttpStatus(): number {\n    const map: Record<string, number> = {\n      NOT_FOUND: 404,\n      CONFLICT: 409,\n      FORBIDDEN: 403,\n      VALIDATION: 422,\n      TEMPLATE_NOT_FOUND: 404,\n    };\n    return map[this.code] ?? 500;\n  }\n}\n\nexport class ApprovalNotFoundError extends ApprovalError {\n  constructor(resource: string, id: string) {\n    super(`${resource} \"${id}\" not found.`, 'NOT_FOUND');\n    this.name = 'ApprovalNotFoundError';\n  }\n}\n\nexport class ApprovalConflictError extends ApprovalError {\n  constructor(instanceId: string) {\n    super(\n      `Concurrent modification detected on instance \"${instanceId}\". The record was updated by another process. Please retry.`,\n      'CONFLICT',\n    );\n    this.name = 'ApprovalConflictError';\n  }\n}\n\nexport class ApprovalForbiddenError extends ApprovalError {\n  constructor(message: string) {\n    super(message, 'FORBIDDEN');\n    this.name = 'ApprovalForbiddenError';\n  }\n}\n\nexport class ApprovalValidationError extends ApprovalError {\n  constructor(\n    message: string,\n    public readonly cause?: unknown,\n  ) {\n    super(message, 'VALIDATION');\n    this.name = 'ApprovalValidationError';\n  }\n}\n\nexport class ApprovalTemplateNotFoundError extends ApprovalError {\n  constructor(name: string) {\n    super(`Template \"${name}\" not found.`, 'TEMPLATE_NOT_FOUND');\n    this.name = 'ApprovalTemplateNotFoundError';\n  }\n}\n","import type {\n  IStorageAdapter,\n  PaginationOpts,\n  PaginatedResult,\n  InstanceFilter,\n  CursorPaginationOpts,\n  CursorPaginatedResult,\n} from './IStorageAdapter.js';\nimport type { ApprovalTemplate, ApprovalInstance, AuditEntry } from '../types/index.js';\nimport { ApprovalConflictError } from '../errors.js';\n\nfunction deepClone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction reviveDates(instance: ApprovalInstance): ApprovalInstance {\n  return {\n    ...instance,\n    createdAt: new Date(instance.createdAt),\n    updatedAt: new Date(instance.updatedAt),\n    expiresAt: instance.expiresAt ? new Date(instance.expiresAt) : undefined,\n    slaDeadlineAt: instance.slaDeadlineAt ? new Date(instance.slaDeadlineAt) : undefined,\n    slaBreachedAt: instance.slaBreachedAt ? new Date(instance.slaBreachedAt) : undefined,\n    auditLog: instance.auditLog.map((e) => ({ ...e, timestamp: new Date(e.timestamp) })),\n    levels: instance.levels.map((l) => {\n      const level: typeof l = { ...l };\n      if (l.escalationDueAt) level.escalationDueAt = new Date(l.escalationDueAt);\n      if (l.delegatedUntil) level.delegatedUntil = new Date(l.delegatedUntil);\n      return level;\n    }),\n  };\n}\n\nfunction reviveTemplateDates(template: ApprovalTemplate): ApprovalTemplate {\n  return { ...template, createdAt: new Date(template.createdAt) };\n}\n\nfunction applyFilter(instance: ApprovalInstance, filter: InstanceFilter): boolean {\n  if (filter.status && instance.status !== filter.status) return false;\n  if (filter.documentType && instance.documentType !== filter.documentType) return false;\n  if (filter.submittedBy && instance.submittedBy !== filter.submittedBy) return false;\n  if (filter.templateName && instance.templateName !== filter.templateName) return false;\n  // Stored instances carry string dates (deepClone JSON round-trip), so wrap before comparing.\n  if (filter.fromDate && new Date(instance.createdAt) < filter.fromDate) return false;\n  if (filter.toDate && new Date(instance.createdAt) > filter.toDate) return false;\n  return true;\n}\n\nexport class MemoryAdapter implements IStorageAdapter {\n  // keyed by `${tenantId}:${template.name}`\n  private templates = new Map<string, ApprovalTemplate>();\n  // keyed by `${tenantId}:${instance.id}`\n  private instances = new Map<string, ApprovalInstance>();\n\n  async saveTemplate(template: ApprovalTemplate): Promise<void> {\n    this.templates.set(`${template.tenantId}:${template.name}`, deepClone(template));\n  }\n\n  async getTemplate(tenantId: string, name: string): Promise<ApprovalTemplate | null> {\n    const template = this.templates.get(`${tenantId}:${name}`);\n    return template ? reviveTemplateDates(deepClone(template)) : null;\n  }\n\n  async listTemplates(tenantId: string): Promise<ApprovalTemplate[]> {\n    const result: ApprovalTemplate[] = [];\n    for (const [key, template] of this.templates) {\n      if (key.startsWith(`${tenantId}:`)) {\n        result.push(reviveTemplateDates(deepClone(template)));\n      }\n    }\n    return result;\n  }\n\n  async saveInstance(instance: ApprovalInstance): Promise<void> {\n    this.instances.set(`${instance.tenantId}:${instance.id}`, deepClone(instance));\n  }\n\n  async updateInstance(instance: ApprovalInstance, expectedVersion: number): Promise<void> {\n    const key = `${instance.tenantId}:${instance.id}`;\n    const stored = this.instances.get(key);\n    if (!stored) throw new ApprovalConflictError(instance.id);\n    if (stored.version !== expectedVersion) throw new ApprovalConflictError(instance.id);\n    const updated = deepClone(instance);\n    updated.version = expectedVersion + 1;\n    this.instances.set(key, updated);\n  }\n\n  async getInstance(tenantId: string, id: string): Promise<ApprovalInstance | null> {\n    const raw = this.instances.get(`${tenantId}:${id}`);\n    if (!raw) return null;\n    return reviveDates(deepClone(raw));\n  }\n\n  async getInstancesByApprover(\n    tenantId: string,\n    approverId: string,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter((i) => {\n      if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n      // Use .find() by level number, not array index (level numbers may not be consecutive)\n      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);\n      return currentLevel?.approverIds.includes(approverId) ?? false;\n    });\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getInstancesByFilter(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter(\n      (i) => i.tenantId === tenantId && applyFilter(i, filter),\n    );\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getOverdueInstances(\n    tenantId: string,\n    asOf: Date,\n    filter: InstanceFilter = {},\n  ): Promise<ApprovalInstance[]> {\n    return [...this.instances.values()]\n      .filter((i) => {\n        if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n        if (filter.documentType && i.documentType !== filter.documentType) return false;\n        if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;\n        // Escalation overdue\n        const currentLevel = i.levels.find((l) => l.level === i.currentLevel);\n        const hasOverdueEscalation =\n          currentLevel?.escalationDueAt != null && new Date(currentLevel.escalationDueAt) <= asOf;\n        // Instance deadline expired\n        const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;\n        // SLA breach (not yet recorded)\n        const hasSLABreach =\n          i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;\n        // Delegation expiry on any pending level\n        const hasDelegationExpiry = i.levels.some(\n          (l) =>\n            l.status === 'pending' &&\n            l.delegatedUntil != null &&\n            new Date(l.delegatedUntil) <= asOf &&\n            l.delegatedFrom != null,\n        );\n        return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry;\n      })\n      .map((i) => reviveDates(deepClone(i)));\n  }\n\n  async getInstancesByCursor(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts: CursorPaginationOpts,\n  ): Promise<CursorPaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()]\n      .filter((i) => i.tenantId === tenantId && applyFilter(i, filter))\n      .map((i) => reviveDates(deepClone(i)))\n      .sort((a, b) => {\n        const ta = a.updatedAt.getTime();\n        const tb = b.updatedAt.getTime();\n        return ta !== tb ? ta - tb : a.id.localeCompare(b.id);\n      });\n\n    const { cursor, limit, direction = 'forward' } = opts;\n    let startIdx = 0;\n\n    if (cursor) {\n      const [ts, id] = decodeCursor(cursor);\n      const idx = all.findIndex(\n        (i) => i.updatedAt.getTime() > ts || (i.updatedAt.getTime() === ts && i.id > id),\n      );\n      startIdx = idx === -1 ? all.length : idx;\n    }\n\n    if (direction === 'backward' && startIdx > 0) {\n      startIdx = Math.max(0, startIdx - limit - 1);\n    }\n\n    const slice = all.slice(startIdx, startIdx + limit);\n    const hasMore = startIdx + limit < all.length;\n    const nextCursor = hasMore ? encodeCursor(slice[slice.length - 1]!) : undefined;\n    const prevCursor = startIdx > 0 ? encodeCursor(all[startIdx - 1]!) : undefined;\n\n    return { items: slice, nextCursor, prevCursor, hasMore };\n  }\n\n  async getIdempotentInstance(\n    tenantId: string,\n    idempotencyKey: string,\n  ): Promise<ApprovalInstance | null> {\n    for (const instance of this.instances.values()) {\n      if (instance.tenantId === tenantId && instance.idempotencyKey === idempotencyKey) {\n        return reviveDates(deepClone(instance));\n      }\n    }\n    return null;\n  }\n\n  async appendAuditEntry(\n    _tenantId: string,\n    _instanceId: string,\n    _entry: AuditEntry,\n  ): Promise<void> {\n    // No-op by design. The engine already pushes each entry onto instance.auditLog\n    // and persists the whole instance via saveInstance()/updateInstance(), so the\n    // embedded log is the source of truth for this adapter. Pushing here too would\n    // duplicate every entry (as a dedicated, append-only audit table would in\n    // PostgresAdapter, this method exists to satisfy that separate-sink contract).\n  }\n\n  /** Test helper — total stored instances across all tenants. */\n  get size(): number {\n    return this.instances.size;\n  }\n}\n\nfunction paginate<T>(items: T[], opts?: PaginationOpts): PaginatedResult<T> {\n  const total = items.length;\n  if (!opts) return { items, total };\n  return { items: items.slice(opts.offset, opts.offset + opts.limit), total };\n}\n\nfunction encodeCursor(instance: ApprovalInstance): string {\n  return Buffer.from(`${instance.updatedAt.getTime()}|${instance.id}`).toString('base64');\n}\n\nfunction decodeCursor(cursor: string): [number, string] {\n  const decoded = Buffer.from(cursor, 'base64').toString('utf8');\n  const pipeIdx = decoded.indexOf('|');\n  return [Number(decoded.slice(0, pipeIdx)), decoded.slice(pipeIdx + 1)];\n}\n"]}
+{"version":3,"sources":["../../src/errors.ts","../../src/adapters/MemoryAdapter.ts"],"names":[],"mappings":"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","file":"MemoryAdapter.cjs","sourcesContent":["export class ApprovalError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = 'ApprovalError';\n  }\n\n  toJSON(): { code: string; message: string; name: string } {\n    return { code: this.code, message: this.message, name: this.name };\n  }\n\n  toHttpStatus(): number {\n    const map: Record<string, number> = {\n      NOT_FOUND: 404,\n      CONFLICT: 409,\n      FORBIDDEN: 403,\n      VALIDATION: 422,\n      TEMPLATE_NOT_FOUND: 404,\n    };\n    return map[this.code] ?? 500;\n  }\n}\n\nexport class ApprovalNotFoundError extends ApprovalError {\n  constructor(resource: string, id: string) {\n    super(`${resource} \"${id}\" not found.`, 'NOT_FOUND');\n    this.name = 'ApprovalNotFoundError';\n  }\n}\n\nexport class ApprovalConflictError extends ApprovalError {\n  constructor(instanceId: string) {\n    super(\n      `Concurrent modification detected on instance \"${instanceId}\". The record was updated by another process. Please retry.`,\n      'CONFLICT',\n    );\n    this.name = 'ApprovalConflictError';\n  }\n}\n\nexport class ApprovalForbiddenError extends ApprovalError {\n  constructor(message: string) {\n    super(message, 'FORBIDDEN');\n    this.name = 'ApprovalForbiddenError';\n  }\n}\n\nexport class ApprovalValidationError extends ApprovalError {\n  constructor(\n    message: string,\n    public readonly cause?: unknown,\n  ) {\n    super(message, 'VALIDATION');\n    this.name = 'ApprovalValidationError';\n  }\n}\n\nexport class ApprovalTemplateNotFoundError extends ApprovalError {\n  constructor(name: string) {\n    super(`Template \"${name}\" not found.`, 'TEMPLATE_NOT_FOUND');\n    this.name = 'ApprovalTemplateNotFoundError';\n  }\n}\n","import type {\n  IStorageAdapter,\n  PaginationOpts,\n  PaginatedResult,\n  InstanceFilter,\n  CursorPaginationOpts,\n  CursorPaginatedResult,\n} from './IStorageAdapter.js';\nimport type { ApprovalTemplate, ApprovalInstance, AuditEntry } from '../types/index.js';\nimport { ApprovalConflictError } from '../errors.js';\n\nfunction deepClone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction reviveDates(instance: ApprovalInstance): ApprovalInstance {\n  return {\n    ...instance,\n    createdAt: new Date(instance.createdAt),\n    updatedAt: new Date(instance.updatedAt),\n    expiresAt: instance.expiresAt ? new Date(instance.expiresAt) : undefined,\n    slaDeadlineAt: instance.slaDeadlineAt ? new Date(instance.slaDeadlineAt) : undefined,\n    slaBreachedAt: instance.slaBreachedAt ? new Date(instance.slaBreachedAt) : undefined,\n    auditLog: instance.auditLog.map((e) => ({ ...e, timestamp: new Date(e.timestamp) })),\n    levels: instance.levels.map((l) => {\n      const level: typeof l = { ...l };\n      if (l.escalationDueAt) level.escalationDueAt = new Date(l.escalationDueAt);\n      if (l.delegatedUntil) level.delegatedUntil = new Date(l.delegatedUntil);\n      return level;\n    }),\n  };\n}\n\nfunction reviveTemplateDates(template: ApprovalTemplate): ApprovalTemplate {\n  return { ...template, createdAt: new Date(template.createdAt) };\n}\n\nfunction applyFilter(instance: ApprovalInstance, filter: InstanceFilter): boolean {\n  if (filter.status && instance.status !== filter.status) return false;\n  if (filter.documentType && instance.documentType !== filter.documentType) return false;\n  if (filter.submittedBy && instance.submittedBy !== filter.submittedBy) return false;\n  if (filter.templateName && instance.templateName !== filter.templateName) return false;\n  // Stored instances carry string dates (deepClone JSON round-trip), so wrap before comparing.\n  if (filter.fromDate && new Date(instance.createdAt) < filter.fromDate) return false;\n  if (filter.toDate && new Date(instance.createdAt) > filter.toDate) return false;\n  return true;\n}\n\nexport class MemoryAdapter implements IStorageAdapter {\n  // keyed by `${tenantId}:${template.name}`\n  private templates = new Map<string, ApprovalTemplate>();\n  // keyed by `${tenantId}:${instance.id}`\n  private instances = new Map<string, ApprovalInstance>();\n\n  async saveTemplate(template: ApprovalTemplate): Promise<void> {\n    this.templates.set(`${template.tenantId}:${template.name}`, deepClone(template));\n  }\n\n  async getTemplate(tenantId: string, name: string): Promise<ApprovalTemplate | null> {\n    const template = this.templates.get(`${tenantId}:${name}`);\n    return template ? reviveTemplateDates(deepClone(template)) : null;\n  }\n\n  async listTemplates(tenantId: string): Promise<ApprovalTemplate[]> {\n    const result: ApprovalTemplate[] = [];\n    for (const [key, template] of this.templates) {\n      if (key.startsWith(`${tenantId}:`)) {\n        result.push(reviveTemplateDates(deepClone(template)));\n      }\n    }\n    return result;\n  }\n\n  async saveInstance(instance: ApprovalInstance): Promise<void> {\n    this.instances.set(`${instance.tenantId}:${instance.id}`, deepClone(instance));\n  }\n\n  async updateInstance(instance: ApprovalInstance, expectedVersion: number): Promise<void> {\n    const key = `${instance.tenantId}:${instance.id}`;\n    const stored = this.instances.get(key);\n    if (!stored) throw new ApprovalConflictError(instance.id);\n    if (stored.version !== expectedVersion) throw new ApprovalConflictError(instance.id);\n    const updated = deepClone(instance);\n    updated.version = expectedVersion + 1;\n    this.instances.set(key, updated);\n  }\n\n  async getInstance(tenantId: string, id: string): Promise<ApprovalInstance | null> {\n    const raw = this.instances.get(`${tenantId}:${id}`);\n    if (!raw) return null;\n    return reviveDates(deepClone(raw));\n  }\n\n  async getInstancesByApprover(\n    tenantId: string,\n    approverId: string,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter((i) => {\n      if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n      // Use .find() by level number, not array index (level numbers may not be consecutive)\n      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);\n      return currentLevel?.approverIds.includes(approverId) ?? false;\n    });\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getInstancesByFilter(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts?: PaginationOpts,\n  ): Promise<PaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()].filter(\n      (i) => i.tenantId === tenantId && applyFilter(i, filter),\n    );\n    return paginate(\n      all.map((i) => reviveDates(deepClone(i))),\n      opts,\n    );\n  }\n\n  async getOverdueInstances(\n    tenantId: string,\n    asOf: Date,\n    filter: InstanceFilter = {},\n  ): Promise<ApprovalInstance[]> {\n    return [...this.instances.values()]\n      .filter((i) => {\n        if (i.tenantId !== tenantId || i.status !== 'pending') return false;\n        if (filter.documentType && i.documentType !== filter.documentType) return false;\n        if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;\n        // Escalation overdue on ANY open branch. Filtering to i.currentLevel\n        // would miss the upper branches of a parallel group entirely, and left\n        // this adapter disagreeing with PostgresAdapter, which already scans\n        // every level.\n        const hasOverdueEscalation = i.levels.some(\n          (l) => l.escalationDueAt != null && new Date(l.escalationDueAt) <= asOf,\n        );\n        // Instance deadline expired\n        const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;\n        // SLA breach (not yet recorded)\n        const hasSLABreach =\n          i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;\n        // Delegation expiry on any pending level\n        const hasDelegationExpiry = i.levels.some(\n          (l) =>\n            l.status === 'pending' &&\n            l.delegatedUntil != null &&\n            new Date(l.delegatedUntil) <= asOf &&\n            l.delegatedFrom != null,\n        );\n        // Reminder due on any open branch. Without this the scheduler never\n        // sees the instance and no reminder is ever sent.\n        const hasDueReminder = i.levels.some(\n          (l) =>\n            l.status === 'pending' && l.reminderDueAt != null && new Date(l.reminderDueAt) <= asOf,\n        );\n        return (\n          hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder\n        );\n      })\n      .map((i) => reviveDates(deepClone(i)));\n  }\n\n  async getInstancesByCursor(\n    tenantId: string,\n    filter: InstanceFilter,\n    opts: CursorPaginationOpts,\n  ): Promise<CursorPaginatedResult<ApprovalInstance>> {\n    const all = [...this.instances.values()]\n      .filter((i) => i.tenantId === tenantId && applyFilter(i, filter))\n      .map((i) => reviveDates(deepClone(i)))\n      .sort((a, b) => {\n        const ta = a.updatedAt.getTime();\n        const tb = b.updatedAt.getTime();\n        return ta !== tb ? ta - tb : a.id.localeCompare(b.id);\n      });\n\n    const { cursor, limit, direction = 'forward' } = opts;\n    let startIdx = 0;\n\n    if (cursor) {\n      const [ts, id] = decodeCursor(cursor);\n      const idx = all.findIndex(\n        (i) => i.updatedAt.getTime() > ts || (i.updatedAt.getTime() === ts && i.id > id),\n      );\n      startIdx = idx === -1 ? all.length : idx;\n    }\n\n    if (direction === 'backward' && startIdx > 0) {\n      startIdx = Math.max(0, startIdx - limit - 1);\n    }\n\n    const slice = all.slice(startIdx, startIdx + limit);\n    const hasMore = startIdx + limit < all.length;\n    const nextCursor = hasMore ? encodeCursor(slice[slice.length - 1]!) : undefined;\n    const prevCursor = startIdx > 0 ? encodeCursor(all[startIdx - 1]!) : undefined;\n\n    return { items: slice, nextCursor, prevCursor, hasMore };\n  }\n\n  async getIdempotentInstance(\n    tenantId: string,\n    idempotencyKey: string,\n  ): Promise<ApprovalInstance | null> {\n    for (const instance of this.instances.values()) {\n      if (instance.tenantId === tenantId && instance.idempotencyKey === idempotencyKey) {\n        return reviveDates(deepClone(instance));\n      }\n    }\n    return null;\n  }\n\n  async appendAuditEntry(\n    _tenantId: string,\n    _instanceId: string,\n    _entry: AuditEntry,\n  ): Promise<void> {\n    // No-op by design. The engine already pushes each entry onto instance.auditLog\n    // and persists the whole instance via saveInstance()/updateInstance(), so the\n    // embedded log is the source of truth for this adapter. Pushing here too would\n    // duplicate every entry (as a dedicated, append-only audit table would in\n    // PostgresAdapter, this method exists to satisfy that separate-sink contract).\n  }\n\n  /** Test helper — total stored instances across all tenants. */\n  get size(): number {\n    return this.instances.size;\n  }\n}\n\nfunction paginate<T>(items: T[], opts?: PaginationOpts): PaginatedResult<T> {\n  const total = items.length;\n  if (!opts) return { items, total };\n  return { items: items.slice(opts.offset, opts.offset + opts.limit), total };\n}\n\nfunction encodeCursor(instance: ApprovalInstance): string {\n  return Buffer.from(`${instance.updatedAt.getTime()}|${instance.id}`).toString('base64');\n}\n\nfunction decodeCursor(cursor: string): [number, string] {\n  const decoded = Buffer.from(cursor, 'base64').toString('utf8');\n  const pipeIdx = decoded.indexOf('|');\n  return [Number(decoded.slice(0, pipeIdx)), decoded.slice(pipeIdx + 1)];\n}\n"]}

package/dist/adapters/MemoryAdapter.d.cts

@@ -1,5 +1,5 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-D-yIRiET.cjs';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-iaAIdMbs.cjs';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-CKV_FZFV.cjs';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BsM0DUPf.cjs';
 
 declare class MemoryAdapter implements IStorageAdapter {
     private templates;

package/dist/adapters/MemoryAdapter.d.ts

@@ -1,5 +1,5 @@
-import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-BYlHnm7_.js';
-import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-iaAIdMbs.js';
+import { I as IStorageAdapter, P as PaginationOpts, a as PaginatedResult, b as InstanceFilter, C as CursorPaginationOpts, c as CursorPaginatedResult } from '../IStorageAdapter-DQJmR6Mt.js';
+import { A as ApprovalTemplate, a as ApprovalInstance, b as AuditEntry } from '../instance-BsM0DUPf.js';
 
 declare class MemoryAdapter implements IStorageAdapter {
     private templates;

package/dist/adapters/MemoryAdapter.js

@@ -127,14 +127,18 @@ var MemoryAdapter = class {
       if (i.tenantId !== tenantId || i.status !== "pending") return false;
       if (filter.documentType && i.documentType !== filter.documentType) return false;
       if (filter.submittedBy && i.submittedBy !== filter.submittedBy) return false;
-      const currentLevel = i.levels.find((l) => l.level === i.currentLevel);
-      const hasOverdueEscalation = currentLevel?.escalationDueAt != null && new Date(currentLevel.escalationDueAt) <= asOf;
+      const hasOverdueEscalation = i.levels.some(
+        (l) => l.escalationDueAt != null && new Date(l.escalationDueAt) <= asOf
+      );
       const isExpired = i.expiresAt != null && new Date(i.expiresAt) <= asOf;
       const hasSLABreach = i.slaDeadlineAt != null && new Date(i.slaDeadlineAt) <= asOf && !i.slaBreachedAt;
       const hasDelegationExpiry = i.levels.some(
         (l) => l.status === "pending" && l.delegatedUntil != null && new Date(l.delegatedUntil) <= asOf && l.delegatedFrom != null
       );
-      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry;
+      const hasDueReminder = i.levels.some(
+        (l) => l.status === "pending" && l.reminderDueAt != null && new Date(l.reminderDueAt) <= asOf
+      );
+      return hasOverdueEscalation || isExpired || hasSLABreach || hasDelegationExpiry || hasDueReminder;
     }).map((i) => reviveDates(deepClone(i)));
   }
   async getInstancesByCursor(tenantId, filter, opts) {