feat(config): support English schedule phrases

Add human-readable schedule syntax as alternative to cron expressions.
Uses english-to-cron crate to convert phrases like "7pm every Thursday"
or "every 5 minutes" into cron format.

Supported patterns:
- "every minute", "every 5 minutes"
- "every day at 4:00 pm", "at 10:00 am"
- "7pm every Thursday", "Sunday at 12:00"
- "midnight on Tuesdays"

Standard cron syntax is tried first; English is used as fallback.

Author: aster-void

CLAUDE.md

@@ -32,8 +32,8 @@ src/
 // All support shorthand (string) or full (object) form via #[serde(untagged)]
 
 enum ScheduleConfigRaw {
-    Simple(String),        // "*/5 * * * *"
-    Full { cron: String, timezone: Option<String> },
+    Simple(String),        // "*/5 * * * *" or "7pm every Thursday"
+    Full { cron: String, timezone: Option<String> },  // cron also accepts English
 }
 
 enum BuildConfigRaw {
@@ -150,6 +150,31 @@ jobs:
     log: output.log           # Shorthand for { file: "..." }
 ```
 
+### English schedule (alternative to cron)
+
+```yaml
+jobs:
+  weekly:
+    schedule: "7pm every Thursday"    # Human-readable schedule
+    run: ./weekly-report.sh
+
+  daily:
+    schedule: "every day at 4:00 pm"  # Also supported
+    run: ./backup.sh
+
+  frequent:
+    schedule: "every 5 minutes"       # Interval-based
+    run: ./health-check.sh
+```
+
+Supported patterns (via [english-to-cron](https://github.com/kaplanelad/english-to-cron)):
+- `"every minute"`, `"every 5 minutes"`
+- `"every day at 4:00 pm"`, `"at 10:00 am"`
+- `"7pm every Thursday"`, `"Sunday at 12:00"`
+- `"midnight on Tuesdays"`, `"midnight on the 1st and 15th"`
+
+Standard cron syntax is tried first; English is used as fallback.
+
 ### Full syntax (all options)
 
 ```yaml
@@ -225,7 +250,7 @@ mise exec -- cargo test     # Run tests
 2. **Tar available**: `tar` command for archive extraction
 3. **Shell available**: Jobs run via `sh -c "<command>"`
 4. **Remote auth**: SSH keys or credentials pre-configured for remote repos
-5. **Cron format**: Standard 5-field cron (via `croner` crate)
+5. **Schedule format**: Standard cron or English phrases (via `croner` + `english-to-cron`)
 
 ## Key Flows
 

Cargo.lock

@@ -6,6 +6,7 @@ edition = "2024"
 [dependencies]
 tokio = { version = "1", features = ["full"] }
 croner = "3"
+english-to-cron = "0.1"
 chrono = "0.4"
 chrono-tz = "0.10"
 anyhow = "1"

Cargo.toml

@@ -49,6 +49,23 @@ jobs:
         delay: 10s
 ```
 
+### Human-readable schedules
+
+```yaml
+jobs:
+  weekly:
+    schedule: "7pm every Thursday"
+    run: ./weekly-report.sh
+
+  daily:
+    schedule: "every day at 4:00 pm"
+    run: ./backup.sh
+
+  frequent:
+    schedule: "every 5 minutes"
+    run: ./health-check.sh
+```
+
 ### Build and run (compiled languages)
 
 ```yaml
@@ -178,13 +195,13 @@ Options:
 
 #### `jobs.<job-id>.schedule`
 
-Shorthand: `schedule: "*/5 * * * *"`
+Shorthand: `schedule: "*/5 * * * *"` or `schedule: "7pm every Thursday"`
 
 Full form:
 
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
-| `cron` | string | **required** | Cron expression (5 fields: min hour day month weekday) |
+| `cron` | string | **required** | Cron expression or English phrase |
 | `timezone` | string, optional | runner's | Job-specific timezone override |
 
 #### `jobs.<job-id>.build` (optional)
@@ -248,7 +265,9 @@ Full form:
 
 **Size**: `512K`, `10M`, `1G`, or bytes
 
-**Cron**: `min hour day month weekday` (e.g., `*/5 * * * *` = every 5 minutes)
+**Schedule**: Cron or English phrase
+- Cron: `min hour day month weekday` (e.g., `*/5 * * * *` = every 5 minutes)
+- English: `every 5 minutes`, `every day at 4:00 pm`, `7pm every Thursday`, `Sunday at 12:00`, `midnight on Tuesdays`
 
 ### Environment variable priority
 

README.md

@@ -313,8 +313,7 @@ fn parse_job(
         ScheduleConfigRaw::Full(full) => (full.cron, full.timezone),
     };
 
-    let schedule = Cron::from_str(&cron_expr)
-        .map_err(|e| anyhow!("Invalid cron '{}': {}", cron_expr, e))?;
+    let schedule = parse_schedule(&cron_expr)?;
 
     // Extract run config
     let (run_sh, run_timeout, run_concurrency, run_retry, run_working_dir, run_env_file, run_env) =
@@ -456,6 +455,20 @@ fn parse_size(s: &str) -> Result<u64> {
     }
 }
 
+/// Parse schedule expression - supports both cron syntax and English phrases
+fn parse_schedule(expr: &str) -> Result<Cron> {
+    // Try standard cron first
+    Cron::from_str(expr).or_else(|cron_err| {
+        // Try English phrase (e.g., "7pm every Thursday")
+        english_to_cron::str_cron_syntax(expr)
+            .map_err(|_| anyhow!("Invalid schedule '{}': {}", expr, cron_err))
+            .and_then(|converted| {
+                Cron::from_str(&converted)
+                    .map_err(|e| anyhow!("Invalid schedule '{}' (converted to '{}'): {}", expr, converted, e))
+            })
+    })
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;
@@ -1559,4 +1572,59 @@ jobs:
         assert_eq!(jobs[0].timeout, Duration::from_secs(30));
         assert_eq!(jobs[0].log_file.as_deref(), Some("app.log"));
     }
+
+    #[test]
+    fn parse_english_schedule() {
+        let yaml = r#"
+jobs:
+  weekly:
+    schedule: "7pm every Thursday"
+    run: echo weekly
+"#;
+        let (_, jobs) = parse_config(yaml).unwrap();
+        assert_eq!(jobs.len(), 1);
+        assert_eq!(jobs[0].command, "echo weekly");
+    }
+
+    #[test]
+    fn parse_english_schedule_daily() {
+        let yaml = r#"
+jobs:
+  daily:
+    schedule: "every day at 4:00 pm"
+    run: echo daily
+"#;
+        let (_, jobs) = parse_config(yaml).unwrap();
+        assert_eq!(jobs.len(), 1);
+    }
+
+    #[test]
+    fn parse_english_schedule_every_minute() {
+        let yaml = r#"
+jobs:
+  frequent:
+    schedule: "every 5 minutes"
+    run: echo ping
+"#;
+        let (_, jobs) = parse_config(yaml).unwrap();
+        assert_eq!(jobs.len(), 1);
+    }
+
+    #[test]
+    fn parse_english_schedule_with_full_syntax() {
+        let yaml = r#"
+jobs:
+  test:
+    schedule:
+      cron: "Sunday at 12:00"
+      timezone: Asia/Tokyo
+    run: echo sunday
+"#;
+        let (_, jobs) = parse_config(yaml).unwrap();
+        assert_eq!(jobs.len(), 1);
+        assert_eq!(
+            jobs[0].timezone,
+            Some(TimezoneConfig::Named(chrono_tz::Asia::Tokyo))
+        );
+    }
 }