crewly 1.3.31 → 1.4.1

package/dist/backend/backend/src/services/agent/auditor-scheduler.service.d.ts

@@ -2,11 +2,11 @@
  * Auditor Scheduler Service
  *
  * Manages the lifecycle and triggering of the Crewly Auditor agent.
- * The auditor runs in always-active mode — initialized at server start
+ * The auditor runs as a Claude Code PTY session — initialized at server start
  * and kept alive until the service stops.
  *
  * Three trigger layers:
- *   L1 — Periodic: setInterval every AUDIT_INTERVAL_MS (30 min)
+ *   L1 — Periodic: setInterval every AUDIT_INTERVAL_MS (15 min)
  *   L2 — Event-driven: EventBus events (agent:inactive, task:failed) with debounce
  *   L3 — API: POST /api/auditor/trigger manual trigger
  *
@@ -15,7 +15,7 @@
  * @module services/agent/auditor-scheduler
  */
 import type { EventBusService } from '../event-bus/event-bus.service.js';
-import type { CrewlyAgentRuntimeService } from './crewly-agent/crewly-agent-runtime.service.js';
+import type { AgentRegistrationService } from './agent-registration.service.js';
 /**
  * Status of the AuditorSchedulerService.
  */
@@ -41,17 +41,30 @@ export interface SlackContext {
     threadTs: string;
 }
 /**
- * Scheduler service that orchestrates Auditor agent lifecycle.
+ * A scheduled audit item that may need catch-up on restart.
+ */
+export interface ScheduledAuditItem {
+    /** Unique identifier */
+    id: string;
+    /** When the audit was scheduled to fire */
+    scheduledTime: number;
+    /** Source of the schedule */
+    source: AuditTriggerResult['source'];
+    /** Whether the audit was actually fired */
+    fired: boolean;
+}
+/**
+ * Scheduler service that orchestrates Auditor agent lifecycle via Claude Code PTY session.
  *
- * Always-active mode: the auditor runtime is initialized at start()
- * and remains alive until stop(). Audit runs do NOT shut down the runtime.
+ * Always-active mode: the auditor PTY session is created at start()
+ * and remains alive until stop(). Audit runs send messages to the existing session.
  *
  * Singleton — use AuditorSchedulerService.getInstance().
  *
  * @example
  * ```typescript
  * const scheduler = AuditorSchedulerService.getInstance();
- * scheduler.setAuditorRuntime(runtime);
+ * scheduler.setAgentRegistrationService(agentRegService);
  * scheduler.setEventBusService(eventBus);
  * scheduler.start();
  * ```
@@ -60,14 +73,20 @@ export declare class AuditorSchedulerService {
     private static instance;
     private logger;
     private status;
-    private auditorRuntime;
+    private agentRegistrationService;
     private eventBusService;
     private periodicTimer;
     private eventDebounceTimer;
     private eventListenerBound;
+    private sessionRecoveryTimer;
     private auditTimeoutTimer;
     private lastAuditStart;
     private auditCount;
+    private sessionReady;
+    private sessionInitializing;
+    private sessionRetryCount;
+    private sessionCooldownUntil;
+    private scheduledItems;
     private constructor();
     /**
      * Get the singleton instance.
@@ -80,11 +99,11 @@ export declare class AuditorSchedulerService {
      */
     static resetInstance(): void;
     /**
-     * Set the Auditor runtime service for lifecycle management.
+     * Set the AgentRegistrationService for PTY session management.
      *
-     * @param runtime - The CrewlyAgentRuntimeService configured for the auditor
+     * @param service - The AgentRegistrationService instance
      */
-    setAuditorRuntime(runtime: CrewlyAgentRuntimeService): void;
+    setAgentRegistrationService(service: AgentRegistrationService): void;
     /**
      * Set the EventBusService for L2 event-driven triggers.
      *
@@ -92,21 +111,21 @@ export declare class AuditorSchedulerService {
      */
     setEventBusService(eventBus: EventBusService): void;
     /**
-     * Start all trigger layers and initialize the auditor runtime.
-     * The auditor is initialized immediately (always-active mode).
+     * Start all trigger layers and initialize the auditor PTY session.
+     * The auditor session is created immediately (always-active mode).
      * L1: periodic interval. L2: EventBus listener.
      */
     start(): void;
     /**
-     * Stop all trigger layers, clean up timers, and shut down the runtime.
+     * Stop all trigger layers, clean up timers, and terminate the PTY session.
      * Only called when the entire service is shutting down.
      */
     stop(): void;
     /**
      * Trigger an audit run.
      *
-     * Checks if an audit is already running, ensures the auditor is ready,
-     * sends the audit command, and keeps the runtime alive after completion.
+     * Checks if an audit is already running, ensures the auditor session exists,
+     * sends the audit command via PTY, and keeps the session alive after completion.
      *
      * @param source - What triggered this audit ('periodic', 'event', 'api')
      * @returns Result indicating whether the audit was triggered
@@ -115,7 +134,7 @@ export declare class AuditorSchedulerService {
     /**
      * Handle a user message routed from Slack.
      *
-     * Passes the message to the auditor runtime with Slack context
+     * Passes the message to the auditor PTY session with Slack context
      * so the auditor can reply directly via the reply_slack tool.
      *
      * @param message - User message text (auditor prefix already stripped)
@@ -137,13 +156,40 @@ export declare class AuditorSchedulerService {
         runtimeReady: boolean;
     };
     /**
-     * Initialize the auditor runtime with the auditor role prompt.
-     * Called at start() and as defensive fallback in trigger()/handleUserMessage().
+     * Add a scheduled audit item for future tracking.
+     * Items that are overdue at next startup will be caught up.
+     *
+     * @param scheduledTime - Unix timestamp when the audit should fire
+     * @param source - Trigger source
+     * @returns The created ScheduledAuditItem
+     */
+    addScheduledItem(scheduledTime: number, source: AuditTriggerResult['source']): ScheduledAuditItem;
+    /**
+     * Get all scheduled items (for testing/diagnostics).
+     *
+     * @returns Copy of the scheduled items array
+     */
+    getScheduledItems(): ScheduledAuditItem[];
+    /**
+     * Check for scheduled items where scheduledTime < now and status !== fired,
+     * then fire them immediately. Called on startup/restore to catch up on any
+     * audits that were missed during downtime.
+     *
+     * @returns Number of missed checks that were caught up
+     */
+    catchUpMissedChecks(): Promise<number>;
+    /**
+     * Ensure the auditor Claude Code PTY session exists.
+     * Creates a new session via AgentRegistrationService if not ready.
+     * Guards against concurrent initialization and enforces retry limits
+     * with exponential backoff to prevent restart loops.
      */
-    private initializeAuditorRuntime;
+    private ensureAuditorSession;
     /**
      * Bind the EventBus listener for L2 event-driven triggers.
      * Listens for agent:inactive and task:failed events with debounce.
+     * Uses event_published (fires on ALL published events) instead of
+     * event_delivered (only fires when a subscription match exists).
      */
     private bindEventBusListener;
 }

package/dist/backend/backend/src/services/agent/auditor-scheduler.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auditor-scheduler.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/auditor-scheduler.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAEhG;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,GAAG,eAAe,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;IACrC,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAwC;IAE/D,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAqC;IAGnD,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,eAAe,CAAgC;IAGvD,OAAO,CAAC,aAAa,CAA+C;IAGpE,OAAO,CAAC,kBAAkB,CAA8C;IACxE,OAAO,CAAC,kBAAkB,CAAS;IAGnC,OAAO,CAAC,iBAAiB,CAA8C;IACvE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,UAAU,CAAa;IAE/B,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,uBAAuB;IAO7C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAO5B;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAI3D;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IA2Bb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAwBZ;;;;;;;;OAQG;IACG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0EhF;;;;;;;;;OASG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAkC9B;;;;OAIG;IACH,SAAS,IAAI;QACX,MAAM,EAAE,sBAAsB,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,eAAe,EAAE,OAAO,CAAC;QACzB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,YAAY,EAAE,OAAO,CAAC;KACvB;IAeD;;;OAGG;YACW,wBAAwB;IAkBtC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;CA8B7B"}
+{"version":3,"file":"auditor-scheduler.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/auditor-scheduler.service.ts"],"names":[],"mappings":"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"}