crewly 1.20.169 → 1.20.171

package/dist/backend/backend/src/services/v3/team-trigger-reconciler.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"team-trigger-reconciler.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/team-trigger-reconciler.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"team-trigger-reconciler.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/team-trigger-reconciler.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/v3/trigger-classification.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Trigger classification — who created a trigger and whether it is
+ * harness-internal plumbing the owner should not have to look at.
+ *
+ * Until 2026-09-30 the agent skills (`schedule-followup`, `watch-for-event`)
+ * stamped every trigger `createdBy: 'system'`, and the Schedules page hid
+ * everything `system`. The owner's own nightly report — an agent created it
+ * for them — was therefore invisible. Two fixes live here:
+ *
+ * 1. {@link resolveTriggerCreator}: the API decides `createdBy` from the
+ *    caller (the `X-Agent-Session` header, or the owner's dashboard) instead
+ *    of trusting the body.
+ * 2. {@link classifyTriggerOnLoad}: a one-time, per-row migration that fills
+ *    the new explicit `internal` flag for rows persisted before it existed.
+ *
+ * @module services/v3/trigger-classification
+ */
+import { type Trigger, type TriggerCreator } from '../../types/v2/trigger.types.js';
+/** Name prefix of the harness's own named triggers (e.g. `system:escalation`). */
+export declare const SYSTEM_TRIGGER_NAME_PREFIX = "system:";
+/** The creator fields the API stamps on a new trigger. */
+export interface ResolvedTriggerCreator {
+    createdBy: TriggerCreator;
+    createdBySession?: string;
+    internal: boolean;
+}
+/** What the API knows about the request when it creates a trigger. */
+export interface TriggerCreatorContext {
+    /** `createdBy` as sent in the body (untrusted) */
+    requestedCreatedBy?: TriggerCreator;
+    /** `internal` as sent in the body */
+    requestedInternal?: boolean;
+    /** `X-Agent-Session`, when an agent made the call */
+    callerSession?: string;
+    /** Whether the caller session is the orchestrator */
+    callerIsOrchestrator?: boolean;
+    /** Whether the call carried the owner-dashboard marker (and no agent session) */
+    isOwnerDashboard?: boolean;
+}
+/**
+ * Decide `createdBy` / `createdBySession` / `internal` for a trigger created
+ * through the API.
+ *
+ * - An agent session header wins: the trigger belongs to that agent
+ *   (`orchestrator` for the orc, `agent` otherwise), and it is owner-facing
+ *   unless the body explicitly marks it internal. delegate-task's fallback
+ *   check keeps `createdBy: 'delegate-task'` and is internal.
+ * - The owner's dashboard is always `user` and never internal.
+ * - Any other caller (server-to-server, curl without headers) keeps what it
+ *   sent, defaulting to `user`.
+ *
+ * @param ctx - Request facts
+ * @returns The creator fields to store
+ */
+export declare function resolveTriggerCreator(ctx: TriggerCreatorContext): ResolvedTriggerCreator;
+/**
+ * Whether a trigger is unmistakably harness plumbing: the escalation sweep
+ * (`runReconciler` / `system:*` names) or a delegate-task fallback check.
+ *
+ * A `fallback-*` name alone is not enough: team leads schedule their own
+ * "fallback check on X" follow-ups through schedule-followup, and those are
+ * reminders the owner may want to see. Only delegate-task's own rows
+ * (`createdBy: 'delegate-task'`) are plumbing.
+ *
+ * @param trigger - Trigger to inspect
+ * @returns True for harness-internal plumbing
+ */
+export declare function isHarnessPlumbing(trigger: Pick<Trigger, 'createdBy' | 'name' | 'action'>): boolean;
+/**
+ * One-time migration for a row persisted before `internal` existed. Mutates
+ * the trigger in place and reports whether it changed; rows that already
+ * carry `internal` are left alone, which is what makes it one-time.
+ *
+ * Rules, in order:
+ * 1. Harness plumbing ({@link isHarnessPlumbing}) → `internal: true`.
+ * 2. A trigger with a `name`, a recurring cron, or a `teamId` plus a
+ *    createWorkItem action is someone's real schedule or reminder →
+ *    `internal: false`. If it was mislabelled `system` it becomes `user`
+ *    (team-spec rows — the owner's team config) or `agent` (everything else:
+ *    the agent skills were the only other writers of `system`).
+ * 3. Anything else keeps its `createdBy` and gets the creator's default.
+ *
+ * @param trigger - Trigger loaded from disk (mutated)
+ * @returns True when the row was changed and should be persisted
+ */
+export declare function classifyTriggerOnLoad(trigger: Trigger): boolean;
+//# sourceMappingURL=trigger-classification.d.ts.map

package/dist/backend/backend/src/services/v3/trigger-classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-classification.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/trigger-classification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,cAAc,EAGpB,MAAM,iCAAiC,CAAC;AAEzC,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAEpD,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,sBAAsB,CA2BxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,GACtD,OAAO,CAIT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAsB/D"}

package/dist/backend/backend/src/services/v3/trigger-classification.js

@@ -0,0 +1,120 @@
+/**
+ * Trigger classification — who created a trigger and whether it is
+ * harness-internal plumbing the owner should not have to look at.
+ *
+ * Until 2026-09-30 the agent skills (`schedule-followup`, `watch-for-event`)
+ * stamped every trigger `createdBy: 'system'`, and the Schedules page hid
+ * everything `system`. The owner's own nightly report — an agent created it
+ * for them — was therefore invisible. Two fixes live here:
+ *
+ * 1. {@link resolveTriggerCreator}: the API decides `createdBy` from the
+ *    caller (the `X-Agent-Session` header, or the owner's dashboard) instead
+ *    of trusting the body.
+ * 2. {@link classifyTriggerOnLoad}: a one-time, per-row migration that fills
+ *    the new explicit `internal` flag for rows persisted before it existed.
+ *
+ * @module services/v3/trigger-classification
+ */
+import { isInternalByDefault, isRecurringTrigger, } from '../../types/v2/trigger.types.js';
+/** Name prefix of the harness's own named triggers (e.g. `system:escalation`). */
+export const SYSTEM_TRIGGER_NAME_PREFIX = 'system:';
+/**
+ * Decide `createdBy` / `createdBySession` / `internal` for a trigger created
+ * through the API.
+ *
+ * - An agent session header wins: the trigger belongs to that agent
+ *   (`orchestrator` for the orc, `agent` otherwise), and it is owner-facing
+ *   unless the body explicitly marks it internal. delegate-task's fallback
+ *   check keeps `createdBy: 'delegate-task'` and is internal.
+ * - The owner's dashboard is always `user` and never internal.
+ * - Any other caller (server-to-server, curl without headers) keeps what it
+ *   sent, defaulting to `user`.
+ *
+ * @param ctx - Request facts
+ * @returns The creator fields to store
+ */
+export function resolveTriggerCreator(ctx) {
+    const requested = ctx.requestedCreatedBy;
+    if (ctx.callerSession) {
+        if (requested === 'delegate-task') {
+            return {
+                createdBy: 'delegate-task',
+                createdBySession: ctx.callerSession,
+                internal: ctx.requestedInternal ?? true,
+            };
+        }
+        if (ctx.requestedInternal === true) {
+            return {
+                createdBy: requested ?? 'system',
+                createdBySession: ctx.callerSession,
+                internal: true,
+            };
+        }
+        const createdBy = requested === 'mission'
+            ? 'mission'
+            : ctx.callerIsOrchestrator ? 'orchestrator' : 'agent';
+        return { createdBy, createdBySession: ctx.callerSession, internal: false };
+    }
+    if (ctx.isOwnerDashboard) {
+        return { createdBy: 'user', internal: false };
+    }
+    const createdBy = requested ?? 'user';
+    return { createdBy, internal: ctx.requestedInternal ?? isInternalByDefault(createdBy) };
+}
+/**
+ * Whether a trigger is unmistakably harness plumbing: the escalation sweep
+ * (`runReconciler` / `system:*` names) or a delegate-task fallback check.
+ *
+ * A `fallback-*` name alone is not enough: team leads schedule their own
+ * "fallback check on X" follow-ups through schedule-followup, and those are
+ * reminders the owner may want to see. Only delegate-task's own rows
+ * (`createdBy: 'delegate-task'`) are plumbing.
+ *
+ * @param trigger - Trigger to inspect
+ * @returns True for harness-internal plumbing
+ */
+export function isHarnessPlumbing(trigger) {
+    if (trigger.createdBy === 'delegate-task')
+        return true;
+    if (trigger.action?.runReconciler)
+        return true;
+    return (trigger.name ?? '').startsWith(SYSTEM_TRIGGER_NAME_PREFIX);
+}
+/**
+ * One-time migration for a row persisted before `internal` existed. Mutates
+ * the trigger in place and reports whether it changed; rows that already
+ * carry `internal` are left alone, which is what makes it one-time.
+ *
+ * Rules, in order:
+ * 1. Harness plumbing ({@link isHarnessPlumbing}) → `internal: true`.
+ * 2. A trigger with a `name`, a recurring cron, or a `teamId` plus a
+ *    createWorkItem action is someone's real schedule or reminder →
+ *    `internal: false`. If it was mislabelled `system` it becomes `user`
+ *    (team-spec rows — the owner's team config) or `agent` (everything else:
+ *    the agent skills were the only other writers of `system`).
+ * 3. Anything else keeps its `createdBy` and gets the creator's default.
+ *
+ * @param trigger - Trigger loaded from disk (mutated)
+ * @returns True when the row was changed and should be persisted
+ */
+export function classifyTriggerOnLoad(trigger) {
+    if (typeof trigger.internal === 'boolean')
+        return false;
+    if (isHarnessPlumbing(trigger)) {
+        trigger.internal = true;
+        return true;
+    }
+    const ownerFacing = !!trigger.name ||
+        isRecurringTrigger(trigger) ||
+        (!!trigger.teamId && !!trigger.action?.createWorkItem);
+    if (ownerFacing) {
+        trigger.internal = false;
+        if (trigger.createdBy === 'system') {
+            trigger.createdBy = trigger.managedBy === 'team-spec' ? 'user' : 'agent';
+        }
+        return true;
+    }
+    trigger.internal = isInternalByDefault(trigger.createdBy);
+    return true;
+}
+//# sourceMappingURL=trigger-classification.js.map

package/dist/backend/backend/src/services/v3/trigger-classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-classification.js","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/trigger-classification.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/v3/trigger-engine.service.d.ts

@@ -13,15 +13,29 @@
  *
  * @module services/v3/trigger-engine.service
  */
-import { type Trigger, type TriggerStatus, type TriggerAction, type CreateTriggerInput } from '../../types/v2/index.js';
+import { type Trigger, type TriggerStatus, type TriggerAction, type CreateTriggerInput, type TriggerFireOutcome } from '../../types/v2/index.js';
 import type { EventBusService } from '../event-bus/event-bus.service.js';
 /**
  * Callback invoked when a trigger fires and produces an action.
  *
+ * It may report what the fire did; the engine stores that as the trigger's
+ * `lastFireResult` so the owner can see it. Returning nothing is fine.
+ *
  * @param trigger - The trigger that fired
  * @param action - The action to execute
+ * @returns Optional outcome of the fire
  */
-export type TriggerActionHandler = (trigger: Trigger, action: TriggerAction) => Promise<void>;
+export type TriggerActionHandler = (trigger: Trigger, action: TriggerAction) => Promise<void | TriggerFireOutcome>;
+/**
+ * Callback that tells a trigger's team lead it is about to run out of fires.
+ * Resolves true once the heads-up was delivered (the engine then records it
+ * and does not send it again), false to retry on a later fire.
+ *
+ * @param trigger - The trigger close to exhaustion
+ * @param remaining - Fires left
+ * @param lastFireAt - Projected final fire time, when computable
+ */
+export type TriggerExpiryNotifier = (trigger: Trigger, remaining: number, lastFireAt: string | undefined) => Promise<boolean>;
 /**
  * Result of a trigger fire attempt — indicates whether the fire was productive.
  */
@@ -67,6 +81,8 @@ export declare class TriggerEngine {
     private signalListener;
     /** Callback for executing trigger actions. */
     private actionHandler;
+    /** Callback for the expiry heads-up (see {@link TriggerExpiryNotifier}). */
+    private expiryNotifier;
     /** Interval handle for time trigger polling. */
     private timeCheckInterval;
     /** Timeout handles for one-shot delay/fireAt triggers, keyed by trigger ID. */
@@ -117,6 +133,13 @@ export declare class TriggerEngine {
      * @param handler - Callback invoked when a trigger fires
      */
     setActionHandler(handler: TriggerActionHandler): void;
+    /**
+     * Sets the callback that warns a team lead before a recurring trigger
+     * exhausts its `maxFires`. Without one, no heads-up is sent.
+     *
+     * @param notifier - Delivery callback
+     */
+    setExpiryNotifier(notifier: TriggerExpiryNotifier): void;
     /**
      * Starts the TriggerEngine: loads persisted triggers from disk,
      * sets up time polling interval, and registers signal listeners.
@@ -199,6 +222,29 @@ export declare class TriggerEngine {
      * @returns The fire result
      */
     fire(trigger: Trigger, productive?: boolean): Promise<TriggerFireResult>;
+    /**
+     * Projected time of a recurring trigger's final fire (for display).
+     *
+     * @param id - Trigger UUID
+     * @returns ISO time, or undefined when unlimited/unknown
+     */
+    projectLastFireAt(id: string): string | undefined;
+    /**
+     * Sends the expiry heads-up for every trigger that is inside the warning
+     * window and has not had one yet. Runs at start; fire() covers the rest.
+     *
+     * @returns Number of heads-ups delivered
+     */
+    checkExpiringTriggers(): Promise<number>;
+    /**
+     * Deliver the heads-up for one trigger if it is due. Marks
+     * `expiryNoticeSentAt` only on success; never changes `maxFires`.
+     * The caller persists.
+     *
+     * @param trigger - Trigger to check
+     * @returns True if a heads-up was delivered
+     */
+    private maybeSendExpiryNotice;
     /**
      * Sets up the polling interval for cron-based time triggers.
      */
@@ -458,6 +504,8 @@ export declare class TriggerEngine {
         total: number;
         byStatus: Record<TriggerStatus, number>;
         byType: Record<string, number>;
+        /** Active, owner-facing, recurring (cron) triggers — the Schedules badge */
+        recurringActive: number;
     };
 }
 //# sourceMappingURL=trigger-engine.service.d.ts.map

package/dist/backend/backend/src/services/v3/trigger-engine.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger-engine.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/trigger-engine.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trigger-engine.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/trigger-engine.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/v3/trigger-engine.service.js

@@ -18,10 +18,12 @@ import * as path from 'path';
 import { LoggerService } from '../core/logger.service.js';
 import { ensureDir } from '../../utils/file-io.utils.js';
 import { atomicWriteJsonWithGuard, IntegrityViolationError, } from '../../utils/integrity-guarded-write.utils.js';
-import { createTrigger, validateCreateTriggerInput, } from '../../types/v2/index.js';
+import { createTrigger, validateCreateTriggerInput, isRecurringTrigger, } from '../../types/v2/index.js';
 import { getNextRunTime } from '../workflow/cron-task.service.js';
 import { resolveProjectDataDir } from '../core/crewly-home.utils.js';
 import { TRIGGER_ENGINE_CONSTANTS } from '../../constants.js';
+import { classifyTriggerOnLoad } from './trigger-classification.js';
+import { needsExpiryNotice, projectLastFireAt, remainingFires } from './trigger-expiry.js';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -68,6 +70,8 @@ export class TriggerEngine {
     signalListener = null;
     /** Callback for executing trigger actions. */
     actionHandler = null;
+    /** Callback for the expiry heads-up (see {@link TriggerExpiryNotifier}). */
+    expiryNotifier = null;
     /** Interval handle for time trigger polling. */
     timeCheckInterval = null;
     /** Timeout handles for one-shot delay/fireAt triggers, keyed by trigger ID. */
@@ -141,6 +145,15 @@ export class TriggerEngine {
     setActionHandler(handler) {
         this.actionHandler = handler;
     }
+    /**
+     * Sets the callback that warns a team lead before a recurring trigger
+     * exhausts its `maxFires`. Without one, no heads-up is sent.
+     *
+     * @param notifier - Delivery callback
+     */
+    setExpiryNotifier(notifier) {
+        this.expiryNotifier = notifier;
+    }
     // ---------------------------------------------------------------------------
     // Lifecycle
     // ---------------------------------------------------------------------------
@@ -159,6 +172,9 @@ export class TriggerEngine {
         this.setupOneShotTimers();
         this.running = true;
         this.logger.info('TriggerEngine started', { triggerCount: this.triggers.size });
+        // Triggers already inside the warning window at boot (e.g. after an
+        // upgrade) get their heads-up now rather than at their next fire.
+        await this.checkExpiringTriggers();
     }
     /**
      * Stops the TriggerEngine: clears intervals, timers, and signal listeners.
@@ -379,12 +395,20 @@ export class TriggerEngine {
         // Execute action
         if (this.actionHandler) {
             try {
-                await this.actionHandler(trigger, trigger.action);
+                const outcome = await this.actionHandler(trigger, trigger.action);
+                if (outcome && typeof outcome === 'object' && 'status' in outcome) {
+                    trigger.lastFireResult = { ...outcome, at: now };
+                }
+                else {
+                    delete trigger.lastFireResult;
+                }
             }
             catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                trigger.lastFireResult = { status: 'failed', detail: message, at: now };
                 this.logger.error('Action handler failed', {
                     triggerId: trigger.id,
-                    error: err instanceof Error ? err.message : String(err),
+                    error: message,
                 });
             }
         }
@@ -409,10 +433,69 @@ export class TriggerEngine {
             // Recalculate next fire for cron triggers
             trigger.nextFireAt = this.calculateNextFireAt(trigger.config, trigger.createdAt);
         }
+        await this.maybeSendExpiryNotice(trigger);
         await this.persistTriggers();
         return { triggerId: trigger.id, productive, firedAt: now };
     }
     // ---------------------------------------------------------------------------
+    // Expiry heads-up
+    // ---------------------------------------------------------------------------
+    /**
+     * Projected time of a recurring trigger's final fire (for display).
+     *
+     * @param id - Trigger UUID
+     * @returns ISO time, or undefined when unlimited/unknown
+     */
+    projectLastFireAt(id) {
+        const trigger = this.triggers.get(id);
+        return trigger ? projectLastFireAt(trigger) : undefined;
+    }
+    /**
+     * Sends the expiry heads-up for every trigger that is inside the warning
+     * window and has not had one yet. Runs at start; fire() covers the rest.
+     *
+     * @returns Number of heads-ups delivered
+     */
+    async checkExpiringTriggers() {
+        let sent = 0;
+        for (const trigger of this.triggers.values()) {
+            if (await this.maybeSendExpiryNotice(trigger))
+                sent += 1;
+        }
+        if (sent > 0) {
+            await this.persistTriggers();
+        }
+        return sent;
+    }
+    /**
+     * Deliver the heads-up for one trigger if it is due. Marks
+     * `expiryNoticeSentAt` only on success; never changes `maxFires`.
+     * The caller persists.
+     *
+     * @param trigger - Trigger to check
+     * @returns True if a heads-up was delivered
+     */
+    async maybeSendExpiryNotice(trigger) {
+        if (!this.expiryNotifier || !needsExpiryNotice(trigger))
+            return false;
+        const remaining = remainingFires(trigger) ?? 0;
+        try {
+            const delivered = await this.expiryNotifier(trigger, remaining, projectLastFireAt(trigger));
+            if (!delivered)
+                return false;
+            trigger.expiryNoticeSentAt = new Date().toISOString();
+            this.logger.info('Trigger expiry heads-up sent', { id: trigger.id, remaining });
+            return true;
+        }
+        catch (err) {
+            this.logger.warn('Trigger expiry heads-up failed; will retry on the next fire', {
+                id: trigger.id,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return false;
+        }
+    }
+    // ---------------------------------------------------------------------------
     // Time Trigger Handling
     // ---------------------------------------------------------------------------
     /**
@@ -755,14 +838,23 @@ export class TriggerEngine {
         // would see lastKnownActiveCount=0 and incorrectly suppress its warn,
         // even when the loaded state had legitimate active triggers.
         this.lastKnownActiveCount = Array.from(this.triggers.values()).filter((t) => t.status === 'active').length;
+        // One-time classification of rows persisted before `internal` existed
+        // (see trigger-classification.ts). Rows that already carry the flag are
+        // untouched, so this is a no-op after the first boot.
+        let classified = 0;
+        for (const trigger of this.triggers.values()) {
+            if (classifyTriggerOnLoad(trigger))
+                classified += 1;
+        }
         const cancelledDuplicates = this.dedupeDuplicateTriggers();
-        if (cancelledDuplicates > 0) {
+        if (cancelledDuplicates > 0 || classified > 0) {
             await this.persistTriggers();
         }
         this.logger.info('Loaded triggers from disk', {
             count: this.triggers.size,
             activeCount: this.lastKnownActiveCount,
             cancelledDuplicates,
+            classified,
         });
     }
     /**
@@ -1047,15 +1139,20 @@ export class TriggerEngine {
             cancelled: 0,
         };
         const byType = {};
+        let recurringActive = 0;
         for (const trigger of this.triggers.values()) {
             byStatus[trigger.status] = (byStatus[trigger.status] || 0) + 1;
             byType[trigger.type] = (byType[trigger.type] || 0) + 1;
+            if (trigger.status === 'active' && trigger.internal !== true && isRecurringTrigger(trigger)) {
+                recurringActive += 1;
+            }
         }
         return {
             running: this.running,
             total: this.triggers.size,
             byStatus,
             byType,
+            recurringActive,
         };
     }
 }