crewly 1.4.63 → 1.4.64

package/dist/backend/backend/src/services/workflow/unified-scheduler.types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Type definitions for the Unified Scheduler Service.
+ *
+ * The Unified Scheduler consolidates cron, interval, and idle-based
+ * scheduling into a single interface with persistent storage and
+ * agent auto-start capabilities.
+ *
+ * @module services/workflow/unified-scheduler.types
+ */
+/** Supported schedule trigger types. */
+export type ScheduleType = 'cron' | 'interval' | 'idle';
+/** Runtime status of a schedule. */
+export type ScheduleStatus = 'active' | 'paused' | 'completed' | 'error';
+/**
+ * A unified schedule definition.
+ *
+ * Combines cron expressions, fixed intervals, and idle detection
+ * into a single structure. Only the fields relevant to the `type`
+ * are used at runtime:
+ * - type=cron: uses `cron`
+ * - type=interval: uses `intervalMinutes`
+ * - type=idle: uses `idleTimeoutMinutes`
+ */
+export interface UnifiedSchedule {
+    /** Unique schedule identifier (UUID) */
+    id: string;
+    /** Target agent session name */
+    target: string;
+    /** Schedule type determines which timing field is used */
+    type: ScheduleType;
+    /** Cron expression (5-field, e.g., "0 8,14,20 * * *") — required when type=cron */
+    cron?: string;
+    /** Interval in minutes between triggers — required when type=interval */
+    intervalMinutes?: number;
+    /** Minutes of idle time before triggering — required when type=idle */
+    idleTimeoutMinutes?: number;
+    /** Message to send to the target agent when triggered */
+    message: string;
+    /** Whether the schedule is actively running */
+    enabled: boolean;
+    /** Auto-start the target agent if it's offline when triggered */
+    autoStart: boolean;
+    /** Maximum consecutive triggers before auto-pausing (default: 10) */
+    maxConsecutiveTriggers: number;
+    /** ISO timestamp of creation */
+    createdAt: string;
+    /** ISO timestamp of last modification */
+    updatedAt: string;
+    /** ISO timestamp of last trigger, or null if never triggered */
+    lastTriggeredAt: string | null;
+    /** Total number of times this schedule has triggered */
+    triggerCount: number;
+    /** Consecutive triggers since last agent activity/response */
+    consecutiveTriggers: number;
+    /** Current runtime status */
+    status: ScheduleStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+}
+/** Request body for creating a new schedule. */
+export interface CreateScheduleRequest {
+    /** Target agent session name */
+    target: string;
+    /** Schedule type */
+    type: ScheduleType;
+    /** Cron expression (required when type=cron) */
+    cron?: string;
+    /** Interval in minutes (required when type=interval) */
+    intervalMinutes?: number;
+    /** Idle timeout in minutes (required when type=idle) */
+    idleTimeoutMinutes?: number;
+    /** Message to send to the agent */
+    message: string;
+    /** Whether to activate immediately (default: true) */
+    enabled?: boolean;
+    /** Auto-start agent if offline (default: true) */
+    autoStart?: boolean;
+    /** Max consecutive triggers before auto-pause (default: 10) */
+    maxConsecutiveTriggers?: number;
+}
+/** Request body for updating an existing schedule. */
+export interface UpdateScheduleRequest {
+    /** Updated cron expression */
+    cron?: string;
+    /** Updated interval */
+    intervalMinutes?: number;
+    /** Updated idle timeout */
+    idleTimeoutMinutes?: number;
+    /** Updated message */
+    message?: string;
+    /** Enable/disable */
+    enabled?: boolean;
+    /** Auto-start toggle */
+    autoStart?: boolean;
+    /** Updated max consecutive triggers */
+    maxConsecutiveTriggers?: number;
+}
+/** Persistent storage format for ~/.crewly/unified-schedules.json */
+export interface UnifiedScheduleStore {
+    /** Schema version for future migrations */
+    version: string;
+    /** Last persistence timestamp */
+    updatedAt: string;
+    /** All schedule definitions */
+    schedules: UnifiedSchedule[];
+}
+/** Scheduler health/stats response. */
+export interface SchedulerHealth {
+    /** Whether the scheduler loop is running */
+    running: boolean;
+    /** Number of active schedules */
+    activeCount: number;
+    /** Number of paused schedules */
+    pausedCount: number;
+    /** Total schedules (all statuses) */
+    totalCount: number;
+    /** Total triggers executed since service start */
+    totalTriggers: number;
+    /** Timestamp of last evaluation cycle */
+    lastEvaluatedAt: string | null;
+    /** Schedules grouped by type */
+    byType: Record<ScheduleType, number>;
+}
+/** Default values for the unified scheduler. */
+export declare const UNIFIED_SCHEDULER_CONSTANTS: {
+    /** Evaluation loop interval (60 seconds — matches cron granularity) */
+    readonly EVAL_INTERVAL_MS: 60000;
+    /** Storage file path (relative to ~/.crewly/) */
+    readonly STORAGE_FILE: "unified-schedules.json";
+    /** Default max consecutive triggers before auto-pause */
+    readonly DEFAULT_MAX_CONSECUTIVE: 10;
+    /** Storage schema version */
+    readonly SCHEMA_VERSION: "1.0.0";
+    /** Default idle timeout if not specified (30 minutes) */
+    readonly DEFAULT_IDLE_TIMEOUT_MINUTES: 30;
+};
+/** Valid schedule types for request validation. */
+export declare const VALID_SCHEDULE_TYPES: ReadonlySet<string>;
+/**
+ * Validate a cron expression (basic 5-field format).
+ *
+ * Checks that the expression has exactly 5 space-separated fields
+ * and each field contains only valid cron characters.
+ *
+ * @param expr - Cron expression to validate
+ * @returns True if valid
+ */
+export declare function isValidCronExpression(expr: string): boolean;
+/**
+ * Validate a CreateScheduleRequest.
+ *
+ * @param req - Request to validate
+ * @returns Error message or null if valid
+ */
+export declare function validateCreateRequest(req: CreateScheduleRequest): string | null;
+//# sourceMappingURL=unified-scheduler.types.d.ts.map

package/dist/backend/backend/src/services/workflow/unified-scheduler.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-scheduler.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/workflow/unified-scheduler.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAExD,oCAAoC;AACpC,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,IAAI,EAAE,YAAY,CAAC;IACnB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,gDAAgD;AAChD,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAMD,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAMD,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACtC;AAMD,gDAAgD;AAChD,eAAO,MAAM,2BAA2B;IACtC,uEAAuE;;IAEvE,iDAAiD;;IAEjD,yDAAyD;;IAEzD,6BAA6B;;IAE7B,yDAAyD;;CAEjD,CAAC;AAMX,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAyC,CAAC;AAE/F;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAyB/E"}

package/dist/backend/backend/src/services/workflow/unified-scheduler.types.js

@@ -0,0 +1,81 @@
+/**
+ * Type definitions for the Unified Scheduler Service.
+ *
+ * The Unified Scheduler consolidates cron, interval, and idle-based
+ * scheduling into a single interface with persistent storage and
+ * agent auto-start capabilities.
+ *
+ * @module services/workflow/unified-scheduler.types
+ */
+// =============================================================================
+// Constants
+// =============================================================================
+/** Default values for the unified scheduler. */
+export const UNIFIED_SCHEDULER_CONSTANTS = {
+    /** Evaluation loop interval (60 seconds — matches cron granularity) */
+    EVAL_INTERVAL_MS: 60_000,
+    /** Storage file path (relative to ~/.crewly/) */
+    STORAGE_FILE: 'unified-schedules.json',
+    /** Default max consecutive triggers before auto-pause */
+    DEFAULT_MAX_CONSECUTIVE: 10,
+    /** Storage schema version */
+    SCHEMA_VERSION: '1.0.0',
+    /** Default idle timeout if not specified (30 minutes) */
+    DEFAULT_IDLE_TIMEOUT_MINUTES: 30,
+};
+// =============================================================================
+// Validation
+// =============================================================================
+/** Valid schedule types for request validation. */
+export const VALID_SCHEDULE_TYPES = new Set(['cron', 'interval', 'idle']);
+/**
+ * Validate a cron expression (basic 5-field format).
+ *
+ * Checks that the expression has exactly 5 space-separated fields
+ * and each field contains only valid cron characters.
+ *
+ * @param expr - Cron expression to validate
+ * @returns True if valid
+ */
+export function isValidCronExpression(expr) {
+    const fields = expr.trim().split(/\s+/);
+    if (fields.length !== 5)
+        return false;
+    const validChars = /^[\d,\-\*\/]+$/;
+    return fields.every(f => validChars.test(f));
+}
+/**
+ * Validate a CreateScheduleRequest.
+ *
+ * @param req - Request to validate
+ * @returns Error message or null if valid
+ */
+export function validateCreateRequest(req) {
+    if (!req.target || typeof req.target !== 'string')
+        return 'target is required';
+    if (!req.message || typeof req.message !== 'string')
+        return 'message is required';
+    if (!req.type || !VALID_SCHEDULE_TYPES.has(req.type)) {
+        return `type must be one of: ${[...VALID_SCHEDULE_TYPES].join(', ')}`;
+    }
+    switch (req.type) {
+        case 'cron':
+            if (!req.cron)
+                return 'cron expression is required when type=cron';
+            if (!isValidCronExpression(req.cron))
+                return `Invalid cron expression: ${req.cron}`;
+            break;
+        case 'interval':
+            if (!req.intervalMinutes || req.intervalMinutes <= 0) {
+                return 'intervalMinutes must be a positive number when type=interval';
+            }
+            break;
+        case 'idle':
+            if (!req.idleTimeoutMinutes || req.idleTimeoutMinutes <= 0) {
+                return 'idleTimeoutMinutes must be a positive number when type=idle';
+            }
+            break;
+    }
+    return null;
+}
+//# sourceMappingURL=unified-scheduler.types.js.map

package/dist/backend/backend/src/services/workflow/unified-scheduler.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-scheduler.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/workflow/unified-scheduler.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2IH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,gDAAgD;AAChD,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,uEAAuE;IACvE,gBAAgB,EAAE,MAAM;IACxB,iDAAiD;IACjD,YAAY,EAAE,wBAAwB;IACtC,yDAAyD;IACzD,uBAAuB,EAAE,EAAE;IAC3B,6BAA6B;IAC7B,cAAc,EAAE,OAAO;IACvB,yDAAyD;IACzD,4BAA4B,EAAE,EAAE;CACxB,CAAC;AAEX,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,mDAAmD;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/F;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,UAAU,GAAG,gBAAgB,CAAC;IACpC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAA0B;IAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,oBAAoB,CAAC;IAC/E,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,qBAAqB,CAAC;IAClF,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO,wBAAwB,CAAC,GAAG,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACxE,CAAC;IAED,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,IAAI,CAAC,GAAG,CAAC,IAAI;gBAAE,OAAO,4CAA4C,CAAC;YACnE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,4BAA4B,GAAG,CAAC,IAAI,EAAE,CAAC;YACpF,MAAM;QACR,KAAK,UAAU;YACb,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;gBACrD,OAAO,8DAA8D,CAAC;YACxE,CAAC;YACD,MAAM;QACR,KAAK,MAAM;YACT,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,GAAG,CAAC,kBAAkB,IAAI,CAAC,EAAE,CAAC;gBAC3D,OAAO,6DAA6D,CAAC;YACvE,CAAC;YACD,MAAM;IACV,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crewly",
-  "version": "1.4.63",
+  "version": "1.4.64",
   "type": "module",
   "description": "Multi-agent orchestration platform for AI coding teams — coordinates Claude Code, Gemini CLI, and Codex agents with a real-time web dashboard",
   "main": "dist/cli/cli/src/index.js",