@shepai/cli 1.150.0 → 1.150.1-pr441.b309db7

package/apis/json-schema/FeatureFlags.yaml

@@ -30,6 +30,10 @@ properties:
     type: boolean
     default: false
     description: Use the built-in React file manager instead of the native OS folder picker
+  scheduledWorkflows:
+    type: boolean
+    default: false
+    description: Enable scheduled workflows feature — workflow creation, scheduling, and execution
 required:
   - skills
   - envDeploy
@@ -38,4 +42,5 @@ required:
   - adoptBranch
   - gitRebaseSync
   - reactFileManager
+  - scheduledWorkflows
 description: Feature flag toggles for runtime feature control

package/apis/json-schema/NotificationEventConfig.yaml

@@ -46,6 +46,18 @@ properties:
     type: boolean
     default: true
     description: Notify when feature is ready for merge review
+  workflowStarted:
+    type: boolean
+    default: true
+    description: Notify when a scheduled workflow execution starts
+  workflowCompleted:
+    type: boolean
+    default: true
+    description: Notify when a scheduled workflow execution completes successfully
+  workflowFailed:
+    type: boolean
+    default: true
+    description: Notify when a scheduled workflow execution fails
 required:
   - agentStarted
   - phaseCompleted
@@ -58,4 +70,7 @@ required:
   - prChecksFailed
   - prBlocked
   - mergeReviewReady
+  - workflowStarted
+  - workflowCompleted
+  - workflowFailed
 description: Notification event type filters

package/apis/json-schema/NotificationEventType.yaml

@@ -13,4 +13,7 @@ enum:
   - pr_checks_failed
   - pr_blocked
   - merge_review_ready
+  - workflow_started
+  - workflow_completed
+  - workflow_failed
 description: Types of agent lifecycle notification events

package/apis/json-schema/ScheduledWorkflow.yaml

@@ -0,0 +1,46 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: ScheduledWorkflow.yaml
+type: object
+properties:
+  name:
+    type: string
+    description: Unique human-readable name identifying this workflow within the repository
+  description:
+    type: string
+    description: Optional human-readable description of what this workflow does
+  prompt:
+    type: string
+    description: Agent prompt instruction that the AI agent will execute when the workflow runs
+  toolConstraints:
+    type: array
+    items:
+      type: string
+    description: Optional allowlist of tool names the workflow agent is permitted to use
+  cronExpression:
+    type: string
+    description: "Cron expression defining the schedule (5-field format: min hour dom month dow)"
+  timezone:
+    type: string
+    description: IANA timezone for cron evaluation (e.g. America/New_York). Defaults to UTC
+  enabled:
+    type: boolean
+    description: Whether the workflow schedule is active. Disabled workflows retain their cron expression but do not auto-execute
+  lastRunAt:
+    type: string
+    format: date-time
+    description: Timestamp of the most recent execution (manual or scheduled)
+  nextRunAt:
+    type: string
+    format: date-time
+    description: Calculated timestamp of the next scheduled execution based on cron expression
+  repositoryPath:
+    type: string
+    description: Absolute file system path to the repository this workflow operates on
+required:
+  - name
+  - prompt
+  - enabled
+  - repositoryPath
+allOf:
+  - $ref: SoftDeletableEntity.yaml
+description: User-defined reusable automation that runs on demand or on a cron schedule

package/apis/json-schema/WorkflowExecution.yaml

@@ -0,0 +1,38 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: WorkflowExecution.yaml
+type: object
+properties:
+  workflowId:
+    $ref: UUID.yaml
+    description: ID of the ScheduledWorkflow that was executed
+  triggerType:
+    $ref: WorkflowTriggerType.yaml
+    description: How this execution was triggered (manual or scheduled)
+  status:
+    $ref: WorkflowExecutionStatus.yaml
+    description: Current lifecycle status of this execution
+  startedAt:
+    type: string
+    format: date-time
+    description: Timestamp when the execution started running
+  completedAt:
+    type: string
+    format: date-time
+    description: Timestamp when the execution completed or failed (null if still running)
+  durationMs:
+    type: integer
+    description: Duration of the execution in milliseconds (null if still running)
+  outputSummary:
+    type: string
+    description: Summary of the execution output (truncated if too long)
+  errorMessage:
+    type: string
+    description: Error message if the execution failed
+required:
+  - workflowId
+  - triggerType
+  - status
+  - startedAt
+allOf:
+  - $ref: BaseEntity.yaml
+description: A single execution record for a scheduled workflow run

package/apis/json-schema/WorkflowExecutionStatus.yaml

@@ -0,0 +1,10 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: WorkflowExecutionStatus.yaml
+type: string
+enum:
+  - queued
+  - running
+  - completed
+  - failed
+  - cancelled
+description: Lifecycle status of a workflow execution

package/apis/json-schema/WorkflowTriggerType.yaml

@@ -0,0 +1,7 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: WorkflowTriggerType.yaml
+type: string
+enum:
+  - manual
+  - scheduled
+description: How a workflow execution was triggered

package/dist/packages/core/src/application/ports/output/repositories/index.d.ts

@@ -6,4 +6,6 @@
 export type { IFeatureRepository, FeatureListFilters } from './feature-repository.interface.js';
 export type { ISettingsRepository } from './settings.repository.interface.js';
 export type { IRepositoryRepository } from './repository-repository.interface.js';
+export type { IWorkflowRepository, WorkflowListFilters } from './workflow-repository.interface.js';
+export type { IWorkflowExecutionRepository } from './workflow-execution-repository.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/application/ports/output/repositories/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAChG,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,4BAA4B,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/packages/core/src/application/ports/output/repositories/workflow-execution-repository.interface.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Workflow Execution Repository Interface
+ *
+ * Output port for WorkflowExecution persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+import type { WorkflowExecution, WorkflowExecutionStatus } from '../../../../domain/generated/output.js';
+/**
+ * Repository interface for WorkflowExecution entity persistence.
+ *
+ * Implementations must:
+ * - Handle database connection management
+ * - Provide thread-safe operations
+ * - Support efficient queries by workflowId and status
+ * - Support retention cleanup via deleteOlderThan
+ */
+export interface IWorkflowExecutionRepository {
+    /**
+     * Create a new execution record.
+     *
+     * @param execution - The execution to persist
+     */
+    create(execution: WorkflowExecution): Promise<void>;
+    /**
+     * Find an execution by its unique ID.
+     *
+     * @param id - The execution ID
+     * @returns The execution or null if not found
+     */
+    findById(id: string): Promise<WorkflowExecution | null>;
+    /**
+     * Find executions for a specific workflow, ordered by started_at DESC.
+     *
+     * @param workflowId - The workflow ID
+     * @param limit - Optional maximum number of records to return
+     * @returns Array of executions, most recent first
+     */
+    findByWorkflowId(workflowId: string, limit?: number): Promise<WorkflowExecution[]>;
+    /**
+     * Find executions with a specific status.
+     * Used by the scheduler for crash recovery (finding stale 'running' records).
+     *
+     * @param status - The execution status to filter by
+     * @returns Array of matching executions
+     */
+    findByStatus(status: WorkflowExecutionStatus): Promise<WorkflowExecution[]>;
+    /**
+     * Update an existing execution record.
+     *
+     * @param execution - The execution with updated fields
+     */
+    update(execution: WorkflowExecution): Promise<void>;
+    /**
+     * Delete execution records older than the given date.
+     * Used for retention cleanup (default: 30 days).
+     *
+     * @param date - Delete records with started_at before this date
+     * @returns The number of records deleted
+     */
+    deleteOlderThan(date: Date): Promise<number>;
+}
+//# sourceMappingURL=workflow-execution-repository.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/repositories/workflow-execution-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-execution-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/workflow-execution-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,wCAAwC,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEnF;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAE5E;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;OAMG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C"}

package/dist/packages/core/src/application/ports/output/repositories/workflow-execution-repository.interface.js

@@ -0,0 +1,11 @@
+/**
+ * Workflow Execution Repository Interface
+ *
+ * Output port for WorkflowExecution persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+export {};

package/dist/packages/core/src/application/ports/output/repositories/workflow-repository.interface.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Workflow Repository Interface
+ *
+ * Output port for ScheduledWorkflow persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+import type { ScheduledWorkflow } from '../../../../domain/generated/output.js';
+/**
+ * Filters for listing workflows.
+ */
+export interface WorkflowListFilters {
+    repositoryPath?: string;
+    enabled?: boolean;
+    /** When true, include soft-deleted workflows in results. Default: false. */
+    includeDeleted?: boolean;
+}
+/**
+ * Repository interface for ScheduledWorkflow entity persistence.
+ *
+ * Implementations must:
+ * - Handle database connection management
+ * - Provide thread-safe operations
+ * - Support query by name + repositoryPath for uniqueness
+ * - Exclude soft-deleted workflows from queries by default
+ */
+export interface IWorkflowRepository {
+    /**
+     * Create a new workflow record.
+     *
+     * @param workflow - The workflow to persist
+     */
+    create(workflow: ScheduledWorkflow): Promise<void>;
+    /**
+     * Find a workflow by its unique ID (excludes soft-deleted).
+     *
+     * @param id - The workflow ID
+     * @returns The workflow or null if not found
+     */
+    findById(id: string): Promise<ScheduledWorkflow | null>;
+    /**
+     * Find a workflow by name within a repository (excludes soft-deleted).
+     *
+     * @param name - The workflow name
+     * @param repositoryPath - The repository path to scope the search
+     * @returns The workflow or null if not found
+     */
+    findByName(name: string, repositoryPath: string): Promise<ScheduledWorkflow | null>;
+    /**
+     * Find all enabled, non-deleted workflows.
+     * Used by the scheduler service to determine which workflows need evaluation.
+     *
+     * @returns Array of enabled workflows
+     */
+    findEnabled(): Promise<ScheduledWorkflow[]>;
+    /**
+     * List workflows with optional filters.
+     * Excludes soft-deleted workflows unless includeDeleted is true.
+     *
+     * @param filters - Optional filters for repositoryPath, enabled state, and includeDeleted
+     * @returns Array of matching workflows
+     */
+    list(filters?: WorkflowListFilters): Promise<ScheduledWorkflow[]>;
+    /**
+     * Update an existing workflow.
+     *
+     * @param workflow - The workflow with updated fields
+     */
+    update(workflow: ScheduledWorkflow): Promise<void>;
+    /**
+     * Soft-delete a workflow by setting deletedAt timestamp.
+     * Preserves execution history for audit purposes.
+     *
+     * @param id - The workflow ID to soft-delete
+     */
+    softDelete(id: string): Promise<void>;
+}
+//# sourceMappingURL=workflow-repository.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/repositories/workflow-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-repository.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/repositories/workflow-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAEpF;;;;;OAKG;IACH,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAElE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/packages/core/src/application/ports/output/repositories/workflow-repository.interface.js

@@ -0,0 +1,11 @@
+/**
+ * Workflow Repository Interface
+ *
+ * Output port for ScheduledWorkflow persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/clock.interface.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Clock Service Interface
+ *
+ * Output port for reading the current time. Enables deterministic testing
+ * of time-dependent logic (cron evaluation, nextRunAt calculation, retention
+ * cleanup) without relying on system time or Vitest fake timers.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides concrete implementation (RealClock)
+ * - Tests provide MockClock with controllable time
+ */
+/**
+ * Port interface for reading the current time.
+ *
+ * Implementations must:
+ * - Return a Date representing the current moment
+ * - Be safe to call frequently (no side effects)
+ */
+export interface IClock {
+    /**
+     * Get the current date and time.
+     *
+     * @returns A Date representing the current moment
+     */
+    now(): Date;
+}
+//# sourceMappingURL=clock.interface.d.ts.map

package/dist/packages/core/src/application/ports/output/services/clock.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/clock.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,GAAG,IAAI,IAAI,CAAC;CACb"}

package/dist/packages/core/src/application/ports/output/services/clock.interface.js

@@ -0,0 +1,13 @@
+/**
+ * Clock Service Interface
+ *
+ * Output port for reading the current time. Enables deterministic testing
+ * of time-dependent logic (cron evaluation, nextRunAt calculation, retention
+ * cleanup) without relying on system time or Vitest fake timers.
+ *
+ * Following Clean Architecture:
+ * - Application layer depends on this interface
+ * - Infrastructure layer provides concrete implementation (RealClock)
+ * - Tests provide MockClock with controllable time
+ */
+export {};

package/dist/packages/core/src/application/ports/output/services/index.d.ts

@@ -15,6 +15,7 @@ export type { INotificationService } from './notification-service.interface.js';
 export type { IGitPrService, CiStatus, CiStatusResult, DiffSummary, MergeStrategy, PrCreateResult, } from './git-pr-service.interface.js';
 export { GitPrError, GitPrErrorCode } from './git-pr-service.interface.js';
 export type { IIdeLauncherService, LaunchIdeInput, LaunchIdeResult, LaunchIdeSuccess, LaunchIdeFailed, } from './ide-launcher-service.interface.js';
+export type { IClock } from './clock.interface.js';
 export type { IDaemonService, DaemonState } from './daemon-service.interface.js';
 export type { IDeploymentService, DeploymentStatus } from './deployment-service.interface.js';
 export type { IGitHubRepositoryService, GitHubRepo, ListUserRepositoriesOptions, CloneOptions, ParsedGitHubUrl, } from './github-repository-service.interface.js';

package/dist/packages/core/src/application/ports/output/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,2BAA2B,EAC3B,YAAY,EACZ,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0CAA0C,CAAC"}

package/dist/packages/core/src/application/use-cases/workflows/create-workflow.use-case.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Create Workflow Use Case
+ *
+ * Creates a new scheduled workflow definition. Validates:
+ * - Name uniqueness within the same repository path
+ * - Cron expression validity (if provided) using croner
+ * - Calculates nextRunAt if a cron expression is provided
+ */
+import type { ScheduledWorkflow } from '../../../domain/generated/output.js';
+import type { IWorkflowRepository } from '../../ports/output/repositories/workflow-repository.interface.js';
+import type { IClock } from '../../ports/output/services/clock.interface.js';
+export interface CreateWorkflowInput {
+    name: string;
+    description?: string;
+    prompt: string;
+    toolConstraints?: string[];
+    cronExpression?: string;
+    timezone?: string;
+    enabled?: boolean;
+    repositoryPath: string;
+}
+export declare class CreateWorkflowUseCase {
+    private readonly workflowRepo;
+    private readonly clock;
+    constructor(workflowRepo: IWorkflowRepository, clock: IClock);
+    execute(input: CreateWorkflowInput): Promise<ScheduledWorkflow>;
+}
+//# sourceMappingURL=create-workflow.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/workflows/create-workflow.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workflow.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/workflows/create-workflow.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AAC5G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gDAAgD,CAAC;AAG7E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,YAAY,EAAE,mBAAmB,EAEjC,KAAK,EAAE,MAAM;IAG1B,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwCtE"}

package/dist/packages/core/src/application/use-cases/workflows/create-workflow.use-case.js

@@ -0,0 +1,72 @@
+/**
+ * Create Workflow Use Case
+ *
+ * Creates a new scheduled workflow definition. Validates:
+ * - Name uniqueness within the same repository path
+ * - Cron expression validity (if provided) using croner
+ * - Calculates nextRunAt if a cron expression is provided
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { randomUUID } from 'node:crypto';
+import { validateCronExpression, calculateNextRunAt } from './cron-helpers.js';
+let CreateWorkflowUseCase = class CreateWorkflowUseCase {
+    workflowRepo;
+    clock;
+    constructor(workflowRepo, clock) {
+        this.workflowRepo = workflowRepo;
+        this.clock = clock;
+    }
+    async execute(input) {
+        // Validate name uniqueness within the repository
+        const existing = await this.workflowRepo.findByName(input.name, input.repositoryPath);
+        if (existing) {
+            throw new Error(`A workflow named "${input.name}" already exists in this repository.`);
+        }
+        // Validate cron expression if provided
+        if (input.cronExpression) {
+            validateCronExpression(input.cronExpression);
+        }
+        const now = this.clock.now();
+        // Calculate nextRunAt if cron expression is provided and workflow is enabled
+        let nextRunAt = null;
+        const enabled = input.enabled !== false; // default to true
+        if (input.cronExpression && enabled) {
+            nextRunAt = calculateNextRunAt(input.cronExpression, input.timezone, now);
+        }
+        const workflow = {
+            id: randomUUID(),
+            name: input.name,
+            prompt: input.prompt,
+            enabled,
+            repositoryPath: input.repositoryPath,
+            createdAt: now,
+            updatedAt: now,
+            ...(input.description != null && { description: input.description }),
+            ...(input.toolConstraints != null && { toolConstraints: input.toolConstraints }),
+            ...(input.cronExpression != null && { cronExpression: input.cronExpression }),
+            ...(input.timezone != null && { timezone: input.timezone }),
+            ...(nextRunAt != null && { nextRunAt }),
+        };
+        await this.workflowRepo.create(workflow);
+        return workflow;
+    }
+};
+CreateWorkflowUseCase = __decorate([
+    injectable(),
+    __param(0, inject('IWorkflowRepository')),
+    __param(1, inject('IClock')),
+    __metadata("design:paramtypes", [Object, Object])
+], CreateWorkflowUseCase);
+export { CreateWorkflowUseCase };

package/dist/packages/core/src/application/use-cases/workflows/cron-helpers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cron Expression Helpers
+ *
+ * Shared utilities for cron expression validation and next-run calculation
+ * used by CreateWorkflowUseCase, UpdateWorkflowUseCase, and ScheduleWorkflowUseCase.
+ *
+ * Uses croner for both validation and next-run calculation to ensure consistency
+ * between what the UI accepts and what the scheduler evaluates at runtime.
+ */
+/**
+ * Validate a cron expression using croner.
+ * Throws a descriptive error if the expression is invalid.
+ *
+ * @param cronExpression - The cron expression to validate
+ * @throws Error with a descriptive message if the expression is invalid
+ */
+export declare function validateCronExpression(cronExpression: string): void;
+/**
+ * Calculate the next run time for a cron expression from a reference date.
+ *
+ * @param cronExpression - A valid cron expression
+ * @param timezone - Optional IANA timezone (defaults to UTC)
+ * @param referenceDate - The reference date to calculate from (defaults to now)
+ * @returns The next run Date, or null if no future run exists
+ */
+export declare function calculateNextRunAt(cronExpression: string, timezone?: string, referenceDate?: Date): Date | null;
+//# sourceMappingURL=cron-helpers.d.ts.map

package/dist/packages/core/src/application/use-cases/workflows/cron-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/workflows/cron-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAUnE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,IAAI,GACnB,IAAI,GAAG,IAAI,CAOb"}

package/dist/packages/core/src/application/use-cases/workflows/cron-helpers.js

@@ -0,0 +1,43 @@
+/**
+ * Cron Expression Helpers
+ *
+ * Shared utilities for cron expression validation and next-run calculation
+ * used by CreateWorkflowUseCase, UpdateWorkflowUseCase, and ScheduleWorkflowUseCase.
+ *
+ * Uses croner for both validation and next-run calculation to ensure consistency
+ * between what the UI accepts and what the scheduler evaluates at runtime.
+ */
+import { Cron } from 'croner';
+/**
+ * Validate a cron expression using croner.
+ * Throws a descriptive error if the expression is invalid.
+ *
+ * @param cronExpression - The cron expression to validate
+ * @throws Error with a descriptive message if the expression is invalid
+ */
+export function validateCronExpression(cronExpression) {
+    try {
+        new Cron(cronExpression, { paused: true });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid cron expression "${cronExpression}": ${message}. ` +
+            `Example: "0 9 * * MON" runs every Monday at 9am.`);
+    }
+}
+/**
+ * Calculate the next run time for a cron expression from a reference date.
+ *
+ * @param cronExpression - A valid cron expression
+ * @param timezone - Optional IANA timezone (defaults to UTC)
+ * @param referenceDate - The reference date to calculate from (defaults to now)
+ * @returns The next run Date, or null if no future run exists
+ */
+export function calculateNextRunAt(cronExpression, timezone, referenceDate) {
+    const cron = new Cron(cronExpression, {
+        paused: true,
+        ...(timezone ? { timezone } : {}),
+    });
+    const next = cron.nextRun(referenceDate);
+    return next ?? null;
+}

package/dist/packages/core/src/application/use-cases/workflows/delete-workflow.use-case.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Delete Workflow Use Case
+ *
+ * Soft-deletes a workflow and cancels any queued executions for it.
+ * Execution history is preserved subject to the retention policy.
+ */
+import type { ScheduledWorkflow } from '../../../domain/generated/output.js';
+import type { IWorkflowRepository } from '../../ports/output/repositories/workflow-repository.interface.js';
+import type { IWorkflowExecutionRepository } from '../../ports/output/repositories/workflow-execution-repository.interface.js';
+import type { IClock } from '../../ports/output/services/clock.interface.js';
+export declare class DeleteWorkflowUseCase {
+    private readonly workflowRepo;
+    private readonly executionRepo;
+    private readonly clock;
+    constructor(workflowRepo: IWorkflowRepository, executionRepo: IWorkflowExecutionRepository, clock: IClock);
+    execute(nameOrId: string, repositoryPath?: string): Promise<ScheduledWorkflow>;
+}
+//# sourceMappingURL=delete-workflow.use-case.d.ts.map

package/dist/packages/core/src/application/use-cases/workflows/delete-workflow.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-workflow.use-case.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/src/application/use-cases/workflows/delete-workflow.use-case.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AAC5G,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4EAA4E,CAAC;AAC/H,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gDAAgD,CAAC;AAE7E,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAJL,YAAY,EAAE,mBAAmB,EAEjC,aAAa,EAAE,4BAA4B,EAE3C,KAAK,EAAE,MAAM;IAG1B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA6BrF"}