@bradygaster/squad-sdk 0.8.24 → 0.9.0

package/dist/runtime/rework.js

@@ -0,0 +1,107 @@
+/**
+ * Rework Rate — Pure calculation helpers.
+ *
+ * Computes PR rework metrics from review and commit data.
+ * No I/O, no side effects — safe to import in tests.
+ *
+ * @module runtime/rework
+ */
+function getCommitDate(c) {
+    return c.committedDate ?? c.commit?.committedDate;
+}
+/**
+ * Calculate rework metrics for a single PR.
+ * Rework = commits pushed after the first review.
+ */
+export function calculatePrRework(pr, reviews, commits) {
+    const sortedReviews = reviews
+        .filter((r) => !!r.submittedAt)
+        .sort((a, b) => new Date(a.submittedAt).getTime() - new Date(b.submittedAt).getTime());
+    const sortedCommits = commits
+        .filter((c) => !!getCommitDate(c))
+        .sort((a, b) => new Date(getCommitDate(a)).getTime() - new Date(getCommitDate(b)).getTime());
+    const firstReview = sortedReviews[0];
+    const firstReviewTime = firstReview ? new Date(firstReview.submittedAt).getTime() : null;
+    // Count review cycles: changes-requested → approved transitions
+    let reviewCycles = 0;
+    let hadChangesRequested = false;
+    let firstChangesRequested = null;
+    let lastApproval = null;
+    let pendingChangeRequest = false;
+    for (const review of sortedReviews) {
+        const state = (review.state ?? '').toUpperCase();
+        if (state === 'CHANGES_REQUESTED') {
+            hadChangesRequested = true;
+            pendingChangeRequest = true;
+            if (!firstChangesRequested)
+                firstChangesRequested = review.submittedAt;
+        }
+        else if (state === 'APPROVED' && pendingChangeRequest) {
+            reviewCycles++;
+            pendingChangeRequest = false;
+            lastApproval = review.submittedAt;
+        }
+        else if (state === 'APPROVED') {
+            lastApproval = review.submittedAt;
+        }
+    }
+    // Count post-review commits (rework)
+    const postReviewCommits = firstReviewTime
+        ? sortedCommits.filter((c) => new Date(getCommitDate(c)).getTime() > firstReviewTime)
+        : [];
+    const totalCommits = sortedCommits.length;
+    const reworkCommits = postReviewCommits.length;
+    const reworkRate = totalCommits > 0 ? reworkCommits / totalCommits : 0;
+    // Rework time: first changes-requested to last approval
+    const reworkTimeMs = firstChangesRequested && lastApproval
+        ? new Date(lastApproval).getTime() - new Date(firstChangesRequested).getTime()
+        : null;
+    return {
+        number: pr.number,
+        title: pr.title,
+        author: pr.author?.login ?? 'unknown',
+        mergedAt: pr.mergedAt,
+        totalCommits,
+        reworkCommits,
+        reworkRate: Math.round(reworkRate * 100),
+        reviewCycles,
+        hadChangesRequested,
+        reworkTimeMs,
+        totalReviews: sortedReviews.length,
+        additions: pr.additions ?? 0,
+        deletions: pr.deletions ?? 0,
+    };
+}
+/**
+ * Calculate aggregate rework summary across all analyzed PRs.
+ */
+export function calculateReworkSummary(results) {
+    if (results.length === 0)
+        return { totalPrs: 0 };
+    const totalPrs = results.length;
+    const avgReworkRate = Math.round(results.reduce((s, r) => s + r.reworkRate, 0) / totalPrs);
+    const prsWithRework = results.filter((r) => r.reworkRate > 0).length;
+    const prsWithChangesRequested = results.filter((r) => r.hadChangesRequested).length;
+    const avgReviewCycles = +(results.reduce((s, r) => s + r.reviewCycles, 0) / totalPrs).toFixed(1);
+    const totalReworkCommits = results.reduce((s, r) => s + r.reworkCommits, 0);
+    const totalCommits = results.reduce((s, r) => s + r.totalCommits, 0);
+    // Average rework time (only for PRs that had rework time)
+    const reworkTimes = results
+        .filter((r) => r.reworkTimeMs !== null)
+        .map((r) => r.reworkTimeMs);
+    const avgReworkTimeHours = reworkTimes.length > 0
+        ? +(reworkTimes.reduce((s, t) => s + t, 0) / reworkTimes.length / 3_600_000).toFixed(1)
+        : null;
+    return {
+        totalPrs,
+        avgReworkRate,
+        prsWithRework,
+        prsWithChangesRequested,
+        avgReviewCycles,
+        totalReworkCommits,
+        totalCommits,
+        avgReworkTimeHours,
+        rejectionRate: Math.round((prsWithChangesRequested / totalPrs) * 100),
+    };
+}
+//# sourceMappingURL=rework.js.map

package/dist/runtime/rework.js.map

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

package/dist/runtime/scheduler.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Scheduler — Generic, provider-agnostic scheduler for Squad (#296)
+ *
+ * Unified schedule manifest + provider adapters that replace scattered
+ * cron jobs, polling scripts, and manual triggers with a single
+ * `.squad/schedule.json` configuration file.
+ *
+ * Provider model:
+ *   - LocalPollingProvider  — evaluates schedule in ralph-watch loop
+ *   - GitHubActionsProvider — generates/updates workflow files from schedule
+ *   - Custom providers via ScheduleProvider interface
+ */
+export interface ScheduleManifest {
+    version: number;
+    schedules: ScheduleEntry[];
+}
+export interface ScheduleEntry {
+    id: string;
+    name: string;
+    enabled: boolean;
+    trigger: TriggerConfig;
+    task: TaskConfig;
+    providers: string[];
+    retry?: RetryConfig;
+}
+export type TriggerConfig = CronTrigger | IntervalTrigger | EventTrigger | StartupTrigger;
+export interface CronTrigger {
+    type: 'cron';
+    cron: string;
+}
+export interface IntervalTrigger {
+    type: 'interval';
+    intervalSeconds: number;
+}
+export interface EventTrigger {
+    type: 'event';
+    event: string;
+}
+export interface StartupTrigger {
+    type: 'startup';
+}
+export interface TaskConfig {
+    type: 'workflow' | 'script' | 'copilot' | 'webhook';
+    ref: string;
+    args?: Record<string, string>;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    backoffSeconds: number;
+}
+export interface ScheduleState {
+    /** Map of schedule id → last run info */
+    runs: Record<string, RunRecord>;
+}
+export interface RunRecord {
+    lastRun: string;
+    nextDue?: string;
+    status: 'success' | 'failure' | 'running';
+    error?: string;
+}
+export interface TaskResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+}
+export interface ScheduleProvider {
+    readonly name: string;
+    execute(entry: ScheduleEntry): Promise<TaskResult>;
+    /** Optional: generate platform-native config (e.g. GitHub Actions workflow) */
+    generate?(manifest: ScheduleManifest, outDir: string): Promise<string[]>;
+}
+export declare class ScheduleValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate a raw object against the ScheduleManifest schema.
+ * Throws ScheduleValidationError on invalid input.
+ */
+export declare function validateManifest(data: unknown): ScheduleManifest;
+/**
+ * Parse and validate a schedule.json file from disk.
+ */
+export declare function parseSchedule(filePath: string): Promise<ScheduleManifest>;
+/**
+ * Evaluate which schedules are due now, based on trigger config and state.
+ * Returns a list of entries that should be executed.
+ */
+export declare function evaluateSchedule(manifest: ScheduleManifest, state: ScheduleState, now?: Date): ScheduleEntry[];
+/**
+ * Minimal cron evaluation for 5-field cron expressions.
+ * Supports: minute hour day-of-month month day-of-week
+ * Wildcard (*) and specific values only (no ranges/lists for simplicity).
+ */
+export declare function isCronDue(cron: string, run: RunRecord | undefined, now: Date): boolean;
+/**
+ * Execute a scheduled task using the specified provider.
+ * Includes retry logic if configured.
+ */
+export declare function executeTask(entry: ScheduleEntry, provider: ScheduleProvider): Promise<TaskResult>;
+/**
+ * Load schedule state from disk. Returns empty state if file doesn't exist.
+ */
+export declare function loadState(statePath: string): Promise<ScheduleState>;
+/**
+ * Save schedule state to disk.
+ */
+export declare function saveState(statePath: string, state: ScheduleState): Promise<void>;
+/**
+ * LocalPollingProvider — evaluates schedule in the ralph-watch loop.
+ * Executes tasks as local processes or stubs.
+ */
+export declare class LocalPollingProvider implements ScheduleProvider {
+    readonly name = "local-polling";
+    execute(entry: ScheduleEntry): Promise<TaskResult>;
+}
+/**
+ * GitHubActionsProvider — generates workflow YAML files from schedule manifest.
+ */
+export declare class GitHubActionsProvider implements ScheduleProvider {
+    readonly name = "github-actions";
+    execute(entry: ScheduleEntry): Promise<TaskResult>;
+    generate(manifest: ScheduleManifest, outDir: string): Promise<string[]>;
+}
+/**
+ * Default schedule.json template for `squad schedule init`.
+ */
+export declare function defaultScheduleTemplate(): ScheduleManifest;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/runtime/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/runtime/scheduler.ts"],"names":[],"mappings":"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"}

package/dist/runtime/scheduler.js

@@ -0,0 +1,427 @@
+/**
+ * Scheduler — Generic, provider-agnostic scheduler for Squad (#296)
+ *
+ * Unified schedule manifest + provider adapters that replace scattered
+ * cron jobs, polling scripts, and manual triggers with a single
+ * `.squad/schedule.json` configuration file.
+ *
+ * Provider model:
+ *   - LocalPollingProvider  — evaluates schedule in ralph-watch loop
+ *   - GitHubActionsProvider — generates/updates workflow files from schedule
+ *   - Custom providers via ScheduleProvider interface
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import fs from 'node:fs';
+import path from 'node:path';
+// ============================================================================
+// Validation
+// ============================================================================
+export class ScheduleValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ScheduleValidationError';
+    }
+}
+const VALID_TRIGGER_TYPES = ['cron', 'interval', 'event', 'startup'];
+const VALID_TASK_TYPES = ['workflow', 'script', 'copilot', 'webhook'];
+/**
+ * Validate a raw object against the ScheduleManifest schema.
+ * Throws ScheduleValidationError on invalid input.
+ */
+export function validateManifest(data) {
+    if (data === null || typeof data !== 'object') {
+        throw new ScheduleValidationError('Schedule manifest must be a JSON object');
+    }
+    const obj = data;
+    if (typeof obj.version !== 'number' || obj.version < 1) {
+        throw new ScheduleValidationError('Schedule manifest requires a positive integer "version" field');
+    }
+    if (!Array.isArray(obj.schedules)) {
+        throw new ScheduleValidationError('Schedule manifest requires a "schedules" array');
+    }
+    const seenIds = new Set();
+    for (let i = 0; i < obj.schedules.length; i++) {
+        const entry = obj.schedules[i];
+        validateEntry(entry, i, seenIds);
+    }
+    return data;
+}
+function validateEntry(entry, index, seenIds) {
+    if (entry === null || typeof entry !== 'object') {
+        throw new ScheduleValidationError(`schedules[${index}] must be an object`);
+    }
+    const e = entry;
+    const prefix = `schedules[${index}]`;
+    if (typeof e.id !== 'string' || e.id.length === 0) {
+        throw new ScheduleValidationError(`${prefix}.id must be a non-empty string`);
+    }
+    if (seenIds.has(e.id)) {
+        throw new ScheduleValidationError(`Duplicate schedule id: "${e.id}"`);
+    }
+    seenIds.add(e.id);
+    if (typeof e.name !== 'string' || e.name.length === 0) {
+        throw new ScheduleValidationError(`${prefix}.name must be a non-empty string`);
+    }
+    if (typeof e.enabled !== 'boolean') {
+        throw new ScheduleValidationError(`${prefix}.enabled must be a boolean`);
+    }
+    // Trigger validation
+    if (e.trigger === null || typeof e.trigger !== 'object') {
+        throw new ScheduleValidationError(`${prefix}.trigger must be an object`);
+    }
+    const trigger = e.trigger;
+    if (!VALID_TRIGGER_TYPES.includes(trigger.type)) {
+        throw new ScheduleValidationError(`${prefix}.trigger.type must be one of: ${VALID_TRIGGER_TYPES.join(', ')}`);
+    }
+    if (trigger.type === 'cron' && (typeof trigger.cron !== 'string' || trigger.cron.length === 0)) {
+        throw new ScheduleValidationError(`${prefix}.trigger.cron must be a non-empty string`);
+    }
+    if (trigger.type === 'interval') {
+        if (typeof trigger.intervalSeconds !== 'number' || trigger.intervalSeconds <= 0) {
+            throw new ScheduleValidationError(`${prefix}.trigger.intervalSeconds must be a positive number`);
+        }
+    }
+    if (trigger.type === 'event' && (typeof trigger.event !== 'string' || trigger.event.length === 0)) {
+        throw new ScheduleValidationError(`${prefix}.trigger.event must be a non-empty string`);
+    }
+    // Task validation
+    if (e.task === null || typeof e.task !== 'object') {
+        throw new ScheduleValidationError(`${prefix}.task must be an object`);
+    }
+    const task = e.task;
+    if (!VALID_TASK_TYPES.includes(task.type)) {
+        throw new ScheduleValidationError(`${prefix}.task.type must be one of: ${VALID_TASK_TYPES.join(', ')}`);
+    }
+    if (typeof task.ref !== 'string' || task.ref.length === 0) {
+        throw new ScheduleValidationError(`${prefix}.task.ref must be a non-empty string`);
+    }
+    // Providers validation
+    if (!Array.isArray(e.providers) || e.providers.length === 0) {
+        throw new ScheduleValidationError(`${prefix}.providers must be a non-empty array of strings`);
+    }
+    for (const p of e.providers) {
+        if (typeof p !== 'string' || p.length === 0) {
+            throw new ScheduleValidationError(`${prefix}.providers must contain only non-empty strings`);
+        }
+    }
+    // Optional retry validation
+    if (e.retry !== undefined) {
+        if (e.retry === null || typeof e.retry !== 'object') {
+            throw new ScheduleValidationError(`${prefix}.retry must be an object`);
+        }
+        const retry = e.retry;
+        if (typeof retry.maxRetries !== 'number' || retry.maxRetries < 0) {
+            throw new ScheduleValidationError(`${prefix}.retry.maxRetries must be a non-negative number`);
+        }
+        if (typeof retry.backoffSeconds !== 'number' || retry.backoffSeconds <= 0) {
+            throw new ScheduleValidationError(`${prefix}.retry.backoffSeconds must be a positive number`);
+        }
+    }
+}
+// ============================================================================
+// Schedule Operations
+// ============================================================================
+/**
+ * Parse and validate a schedule.json file from disk.
+ */
+export async function parseSchedule(filePath) {
+    let raw;
+    try {
+        raw = await readFile(filePath, 'utf8');
+    }
+    catch (err) {
+        throw new ScheduleValidationError(`Cannot read schedule file: ${filePath} — ${err.message}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        throw new ScheduleValidationError(`Invalid JSON in schedule file: ${filePath}`);
+    }
+    return validateManifest(data);
+}
+/**
+ * Evaluate which schedules are due now, based on trigger config and state.
+ * Returns a list of entries that should be executed.
+ */
+export function evaluateSchedule(manifest, state, now = new Date()) {
+    const due = [];
+    for (const entry of manifest.schedules) {
+        if (!entry.enabled)
+            continue;
+        const run = state.runs[entry.id];
+        if (run?.status === 'running')
+            continue;
+        if (isDue(entry.trigger, run, now)) {
+            due.push(entry);
+        }
+    }
+    return due;
+}
+function isDue(trigger, run, now) {
+    switch (trigger.type) {
+        case 'startup':
+            // Due if never run
+            return run === undefined;
+        case 'interval': {
+            if (!run)
+                return true;
+            const lastRun = new Date(run.lastRun);
+            const elapsed = (now.getTime() - lastRun.getTime()) / 1000;
+            return elapsed >= trigger.intervalSeconds;
+        }
+        case 'cron':
+            return isCronDue(trigger.cron, run, now);
+        case 'event':
+            // Event triggers are fired externally, not by polling
+            return false;
+        default:
+            return false;
+    }
+}
+/**
+ * Minimal cron evaluation for 5-field cron expressions.
+ * Supports: minute hour day-of-month month day-of-week
+ * Wildcard (*) and specific values only (no ranges/lists for simplicity).
+ */
+export function isCronDue(cron, run, now) {
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return false;
+    const [minField, hourField, domField, monthField, dowField] = parts;
+    const minute = now.getMinutes();
+    const hour = now.getHours();
+    const dom = now.getDate();
+    const month = now.getMonth() + 1; // 1-12
+    const dow = now.getDay(); // 0-6 (Sun-Sat)
+    if (!cronFieldMatches(minField, minute))
+        return false;
+    if (!cronFieldMatches(hourField, hour))
+        return false;
+    if (!cronFieldMatches(domField, dom))
+        return false;
+    if (!cronFieldMatches(monthField, month))
+        return false;
+    if (!cronFieldMatches(dowField, dow))
+        return false;
+    // Don't run again within the same minute
+    if (run) {
+        const lastRun = new Date(run.lastRun);
+        if (lastRun.getFullYear() === now.getFullYear() &&
+            lastRun.getMonth() === now.getMonth() &&
+            lastRun.getDate() === now.getDate() &&
+            lastRun.getHours() === now.getHours() &&
+            lastRun.getMinutes() === now.getMinutes()) {
+            return false;
+        }
+    }
+    return true;
+}
+function cronFieldMatches(field, value) {
+    if (field === '*')
+        return true;
+    // Support */N step syntax
+    if (field.startsWith('*/')) {
+        const step = parseInt(field.slice(2), 10);
+        if (isNaN(step) || step <= 0)
+            return false;
+        return value % step === 0;
+    }
+    // Support comma-separated values
+    const values = field.split(',').map(v => parseInt(v, 10));
+    return values.includes(value);
+}
+// ============================================================================
+// Task Execution
+// ============================================================================
+/**
+ * Execute a scheduled task using the specified provider.
+ * Includes retry logic if configured.
+ */
+export async function executeTask(entry, provider) {
+    const maxRetries = entry.retry?.maxRetries ?? 0;
+    const backoffSeconds = entry.retry?.backoffSeconds ?? 1;
+    let lastResult = { success: false, error: 'No attempt made' };
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        if (attempt > 0) {
+            const delay = backoffSeconds * Math.pow(2, attempt - 1) * 1000;
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+        try {
+            lastResult = await provider.execute(entry);
+            if (lastResult.success)
+                return lastResult;
+        }
+        catch (err) {
+            lastResult = { success: false, error: err.message };
+        }
+    }
+    return lastResult;
+}
+// ============================================================================
+// State Persistence
+// ============================================================================
+/**
+ * Load schedule state from disk. Returns empty state if file doesn't exist.
+ */
+export async function loadState(statePath) {
+    try {
+        const raw = await readFile(statePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { runs: {} };
+    }
+}
+/**
+ * Save schedule state to disk.
+ */
+export async function saveState(statePath, state) {
+    await writeFile(statePath, JSON.stringify(state, null, 2) + '\n', 'utf8');
+}
+// ============================================================================
+// Built-in Providers
+// ============================================================================
+/**
+ * LocalPollingProvider — evaluates schedule in the ralph-watch loop.
+ * Executes tasks as local processes or stubs.
+ */
+export class LocalPollingProvider {
+    name = 'local-polling';
+    async execute(entry) {
+        switch (entry.task.type) {
+            case 'script': {
+                try {
+                    const { execSync } = await import('node:child_process');
+                    const output = execSync(entry.task.ref, {
+                        encoding: 'utf8',
+                        timeout: 60_000,
+                    });
+                    return { success: true, output: output.trim() };
+                }
+                catch (err) {
+                    return { success: false, error: err.message };
+                }
+            }
+            case 'workflow':
+                return {
+                    success: true,
+                    output: `Workflow ${entry.task.ref} triggered (local stub — use github-actions provider for real dispatch)`,
+                };
+            case 'copilot':
+                return {
+                    success: true,
+                    output: `Copilot task ${entry.task.ref} dispatched (stub)`,
+                };
+            case 'webhook': {
+                try {
+                    const resp = await fetch(entry.task.ref, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({ scheduleId: entry.id, timestamp: new Date().toISOString() }),
+                    });
+                    return {
+                        success: resp.ok,
+                        output: `HTTP ${resp.status} ${resp.statusText}`,
+                        error: resp.ok ? undefined : `HTTP ${resp.status}`,
+                    };
+                }
+                catch (err) {
+                    return { success: false, error: err.message };
+                }
+            }
+            default:
+                return { success: false, error: `Unknown task type: ${entry.task.type}` };
+        }
+    }
+}
+/**
+ * GitHubActionsProvider — generates workflow YAML files from schedule manifest.
+ */
+export class GitHubActionsProvider {
+    name = 'github-actions';
+    async execute(entry) {
+        // GitHub Actions execution is handled by the platform itself.
+        // This provider's main value is generate(), not execute().
+        return {
+            success: true,
+            output: `GitHub Actions handles execution of ${entry.task.ref} natively`,
+        };
+    }
+    async generate(manifest, outDir) {
+        const generated = [];
+        for (const entry of manifest.schedules) {
+            if (!entry.enabled)
+                continue;
+            if (!entry.providers.includes('github-actions'))
+                continue;
+            if (entry.trigger.type !== 'cron' && entry.trigger.type !== 'interval')
+                continue;
+            const cronExpr = entry.trigger.type === 'cron'
+                ? entry.trigger.cron
+                : intervalToCron(entry.trigger.intervalSeconds);
+            const workflowName = `squad-schedule-${entry.id}.yml`;
+            const workflowPath = path.join(outDir, workflowName);
+            const yaml = [
+                `# Auto-generated by Squad Scheduler from schedule.json`,
+                `# Schedule: ${entry.name} (${entry.id})`,
+                `name: "Squad: ${entry.name}"`,
+                ``,
+                `on:`,
+                `  schedule:`,
+                `    - cron: '${cronExpr}'`,
+                `  workflow_dispatch: {}`,
+                ``,
+                `jobs:`,
+                `  run:`,
+                `    runs-on: ubuntu-latest`,
+                `    steps:`,
+                `      - uses: actions/checkout@v4`,
+                `      - name: Run scheduled task`,
+                `        run: echo "Executing ${entry.id} — ${entry.task.type}:${entry.task.ref}"`,
+            ].join('\n') + '\n';
+            const dir = path.dirname(workflowPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(workflowPath, yaml, 'utf8');
+            generated.push(workflowPath);
+        }
+        return generated;
+    }
+}
+/**
+ * Convert an interval in seconds to the nearest cron expression.
+ */
+function intervalToCron(seconds) {
+    const minutes = Math.max(1, Math.round(seconds / 60));
+    if (minutes < 60)
+        return `*/${minutes} * * * *`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 24)
+        return `0 */${hours} * * *`;
+    return '0 0 * * *'; // daily fallback
+}
+// ============================================================================
+// Default Template
+// ============================================================================
+/**
+ * Default schedule.json template for `squad schedule init`.
+ */
+export function defaultScheduleTemplate() {
+    return {
+        version: 1,
+        schedules: [
+            {
+                id: 'ralph-heartbeat',
+                name: 'Ralph Heartbeat',
+                enabled: true,
+                trigger: { type: 'interval', intervalSeconds: 300 },
+                task: { type: 'workflow', ref: '.github/workflows/squad-heartbeat.yml' },
+                providers: ['local-polling', 'github-actions'],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=scheduler.js.map