specweave 0.28.68 → 0.29.0

package/dist/src/core/scheduler/schedule-persistence.js

@@ -0,0 +1,180 @@
+/**
+ * Schedule Persistence
+ *
+ * Persists job schedules to disk so they survive session restarts.
+ * Uses atomic writes to prevent corruption.
+ *
+ * @module core/scheduler/schedule-persistence
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * Current schema version
+ */
+const CURRENT_VERSION = 1;
+/**
+ * SchedulePersistence - Saves and loads job schedules from disk
+ *
+ * Features:
+ * - Atomic writes using temp file + rename
+ * - Schema versioning for migration
+ * - Corruption recovery with defaults
+ */
+export class SchedulePersistence {
+    constructor(options = {}) {
+        const specweavePath = options.specweavePath ?? path.join(process.cwd(), '.specweave');
+        this.filePath = path.join(specweavePath, 'state', 'scheduled-jobs.json');
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Load schedules from disk
+     *
+     * @returns Array of persisted jobs, empty array if file doesn't exist or is corrupted
+     */
+    async loadSchedules() {
+        try {
+            const content = await fs.readFile(this.filePath, 'utf-8');
+            const data = JSON.parse(content);
+            // Validate schema version
+            if (!data.version || typeof data.version !== 'number') {
+                this.logger.warn('Invalid schedule file format, returning empty');
+                return [];
+            }
+            // Handle schema migration if needed
+            if (data.version < CURRENT_VERSION) {
+                this.logger.log(`Migrating schedules from v${data.version} to v${CURRENT_VERSION}`);
+                return this.migrateSchedules(data);
+            }
+            // Validate jobs array
+            if (!Array.isArray(data.jobs)) {
+                this.logger.warn('Invalid jobs array in schedule file, returning empty');
+                return [];
+            }
+            this.logger.debug(`Loaded ${data.jobs.length} scheduled jobs from disk`);
+            return data.jobs;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist - normal for first run
+                this.logger.debug('No scheduled jobs file found (first run)');
+                return [];
+            }
+            if (error instanceof SyntaxError) {
+                // JSON parse error - corrupted file
+                this.logger.warn(`Corrupted schedule file, creating backup: ${error.message}`);
+                await this.backupCorruptedFile();
+                return [];
+            }
+            this.logger.error(`Failed to load schedules: ${error}`);
+            return [];
+        }
+    }
+    /**
+     * Save schedules to disk
+     *
+     * Uses atomic write (write to temp file, then rename) to prevent corruption.
+     *
+     * @param jobs - Jobs to persist
+     */
+    async saveSchedules(jobs) {
+        const data = {
+            version: CURRENT_VERSION,
+            jobs,
+            lastUpdated: new Date().toISOString(),
+        };
+        // Ensure directory exists
+        const dir = path.dirname(this.filePath);
+        await fs.mkdir(dir, { recursive: true });
+        // Write to temp file first
+        const tempPath = `${this.filePath}.tmp`;
+        const content = JSON.stringify(data, null, 2);
+        try {
+            await fs.writeFile(tempPath, content, 'utf-8');
+            // Atomic rename
+            await fs.rename(tempPath, this.filePath);
+            this.logger.debug(`Saved ${jobs.length} scheduled jobs to disk`);
+        }
+        catch (error) {
+            // Clean up temp file if it exists
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update a single job in persistence
+     *
+     * @param jobId - Job ID to update
+     * @param updates - Partial job updates
+     */
+    async updateJob(jobId, updates) {
+        const jobs = await this.loadSchedules();
+        const index = jobs.findIndex((j) => j.id === jobId);
+        if (index === -1) {
+            this.logger.warn(`Job not found for update: ${jobId}`);
+            return;
+        }
+        jobs[index] = { ...jobs[index], ...updates };
+        await this.saveSchedules(jobs);
+    }
+    /**
+     * Delete a job from persistence
+     *
+     * @param jobId - Job ID to delete
+     */
+    async deleteJob(jobId) {
+        const jobs = await this.loadSchedules();
+        const filtered = jobs.filter((j) => j.id !== jobId);
+        if (filtered.length < jobs.length) {
+            await this.saveSchedules(filtered);
+            this.logger.debug(`Deleted job from persistence: ${jobId}`);
+        }
+    }
+    /**
+     * Check if persistence file exists
+     *
+     * @returns true if file exists
+     */
+    async exists() {
+        try {
+            await fs.access(this.filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get file path (for testing/debugging)
+     */
+    getFilePath() {
+        return this.filePath;
+    }
+    /**
+     * Migrate schedules from older schema versions
+     */
+    async migrateSchedules(data) {
+        // Currently only v1, no migrations needed
+        // Future migrations would go here
+        return data.jobs || [];
+    }
+    /**
+     * Backup corrupted file for debugging
+     */
+    async backupCorruptedFile() {
+        try {
+            const backupPath = `${this.filePath}.corrupted.${Date.now()}`;
+            await fs.copyFile(this.filePath, backupPath);
+            this.logger.log(`Backed up corrupted file to: ${backupPath}`);
+        }
+        catch {
+            // Ignore backup errors
+        }
+    }
+}
+//# sourceMappingURL=schedule-persistence.js.map

package/dist/src/core/scheduler/schedule-persistence.js.map

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

package/dist/src/core/scheduler/scheduled-job.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Scheduled Job Types
+ *
+ * Defines the types for scheduled jobs in the sync orchestration system.
+ *
+ * @module core/scheduler/scheduled-job
+ */
+/**
+ * Job types supported by the scheduler
+ */
+export type JobType = 'external-sync' | 'discrepancy-check' | 'living-docs-sync' | 'notification-cleanup';
+/**
+ * Job status values
+ */
+export type JobStatus = 'idle' | 'running' | 'failed' | 'disabled';
+/**
+ * Job schedule configuration
+ */
+export interface JobSchedule {
+    /**
+     * Interval between job runs in milliseconds
+     */
+    intervalMs: number;
+    /**
+     * Whether the job is enabled
+     */
+    enabled: boolean;
+    /**
+     * ISO timestamp of last successful run
+     */
+    lastRun?: string;
+    /**
+     * ISO timestamp of next scheduled run
+     */
+    nextRun?: string;
+    /**
+     * Current retry count for failed jobs
+     */
+    retryCount: number;
+    /**
+     * Maximum retries before giving up
+     * @default 3
+     */
+    maxRetries: number;
+}
+/**
+ * Scheduled job definition
+ */
+export interface ScheduledJob {
+    /**
+     * Unique job identifier (e.g., 'external-sync', 'discrepancy-check')
+     */
+    id: string;
+    /**
+     * Job type
+     */
+    type: JobType;
+    /**
+     * Schedule configuration
+     */
+    schedule: JobSchedule;
+    /**
+     * Current job status
+     */
+    status: JobStatus;
+    /**
+     * Error message if job failed
+     */
+    lastError?: string;
+    /**
+     * ISO timestamp of last state change
+     */
+    lastStateChange?: string;
+}
+/**
+ * Configuration for registering a new job
+ */
+export interface ScheduledJobConfig {
+    /**
+     * Job identifier
+     */
+    id: string;
+    /**
+     * Job type
+     */
+    type: JobType;
+    /**
+     * Interval in milliseconds
+     */
+    intervalMs: number;
+    /**
+     * Initial enabled state
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Maximum retries
+     * @default 3
+     */
+    maxRetries?: number;
+}
+/**
+ * Job execution result
+ */
+export interface JobExecutionResult {
+    /**
+     * Whether the job succeeded
+     */
+    success: boolean;
+    /**
+     * Duration in milliseconds
+     */
+    durationMs: number;
+    /**
+     * Error message if failed
+     */
+    error?: string;
+    /**
+     * Job-specific result data
+     */
+    data?: Record<string, unknown>;
+}
+/**
+ * Create a new scheduled job from config
+ *
+ * @param config - Job configuration
+ * @returns New scheduled job
+ */
+export declare function createScheduledJob(config: ScheduledJobConfig): ScheduledJob;
+/**
+ * Calculate next run time with optional exponential backoff
+ *
+ * @param job - The job to calculate next run for
+ * @param withBackoff - Whether to apply exponential backoff (for retries)
+ * @returns ISO timestamp of next run
+ */
+export declare function calculateNextRun(job: ScheduledJob, withBackoff?: boolean): string;
+/**
+ * Check if a job is due for execution
+ *
+ * @param job - The job to check
+ * @returns true if job should run now
+ */
+export declare function isJobDue(job: ScheduledJob): boolean;
+/**
+ * Update job state after successful execution
+ *
+ * @param job - The job to update
+ * @returns Updated job
+ */
+export declare function markJobComplete(job: ScheduledJob): ScheduledJob;
+/**
+ * Update job state after failed execution
+ *
+ * @param job - The job to update
+ * @param error - Error message
+ * @returns Updated job
+ */
+export declare function markJobFailed(job: ScheduledJob, error: string): ScheduledJob;
+/**
+ * Mark job as running
+ *
+ * @param job - The job to update
+ * @returns Updated job
+ */
+export declare function markJobRunning(job: ScheduledJob): ScheduledJob;
+/**
+ * Pause a job (disable without clearing schedule)
+ *
+ * @param job - The job to pause
+ * @returns Updated job
+ */
+export declare function pauseJob(job: ScheduledJob): ScheduledJob;
+/**
+ * Resume a paused job
+ *
+ * @param job - The job to resume
+ * @returns Updated job
+ */
+export declare function resumeJob(job: ScheduledJob): ScheduledJob;
+/**
+ * Reset a failed job for retry
+ *
+ * @param job - The job to reset
+ * @returns Updated job
+ */
+export declare function resetJob(job: ScheduledJob): ScheduledJob;
+//# sourceMappingURL=scheduled-job.d.ts.map

package/dist/src/core/scheduler/scheduled-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-job.d.ts","sourceRoot":"","sources":["../../../../src/core/scheduler/scheduled-job.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GACf,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAkB3E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,WAAW,UAAQ,GAAG,MAAM,CAU/E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAgBnD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAc/D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAkB5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAM9D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAUxD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAazD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAYxD"}

package/dist/src/core/scheduler/scheduled-job.js

@@ -0,0 +1,182 @@
+/**
+ * Scheduled Job Types
+ *
+ * Defines the types for scheduled jobs in the sync orchestration system.
+ *
+ * @module core/scheduler/scheduled-job
+ */
+/**
+ * Create a new scheduled job from config
+ *
+ * @param config - Job configuration
+ * @returns New scheduled job
+ */
+export function createScheduledJob(config) {
+    const now = new Date().toISOString();
+    const intervalMs = config.intervalMs;
+    const nextRun = new Date(Date.now() + intervalMs).toISOString();
+    return {
+        id: config.id,
+        type: config.type,
+        schedule: {
+            intervalMs,
+            enabled: config.enabled ?? true,
+            nextRun,
+            retryCount: 0,
+            maxRetries: config.maxRetries ?? 3,
+        },
+        status: 'idle',
+        lastStateChange: now,
+    };
+}
+/**
+ * Calculate next run time with optional exponential backoff
+ *
+ * @param job - The job to calculate next run for
+ * @param withBackoff - Whether to apply exponential backoff (for retries)
+ * @returns ISO timestamp of next run
+ */
+export function calculateNextRun(job, withBackoff = false) {
+    let delayMs = job.schedule.intervalMs;
+    if (withBackoff && job.schedule.retryCount > 0) {
+        // Exponential backoff: 2^retryCount * base interval, capped at 1 hour
+        const backoffMultiplier = Math.pow(2, job.schedule.retryCount);
+        delayMs = Math.min(delayMs * backoffMultiplier, 60 * 60 * 1000);
+    }
+    return new Date(Date.now() + delayMs).toISOString();
+}
+/**
+ * Check if a job is due for execution
+ *
+ * @param job - The job to check
+ * @returns true if job should run now
+ */
+export function isJobDue(job) {
+    // Job must be enabled and idle
+    if (!job.schedule.enabled || job.status !== 'idle') {
+        return false;
+    }
+    // If no next run scheduled, it's due
+    if (!job.schedule.nextRun) {
+        return true;
+    }
+    // Check if current time is past scheduled time
+    const now = Date.now();
+    const nextRun = new Date(job.schedule.nextRun).getTime();
+    return now >= nextRun;
+}
+/**
+ * Update job state after successful execution
+ *
+ * @param job - The job to update
+ * @returns Updated job
+ */
+export function markJobComplete(job) {
+    const now = new Date().toISOString();
+    return {
+        ...job,
+        status: 'idle',
+        schedule: {
+            ...job.schedule,
+            lastRun: now,
+            nextRun: calculateNextRun(job),
+            retryCount: 0, // Reset retry count on success
+        },
+        lastError: undefined,
+        lastStateChange: now,
+    };
+}
+/**
+ * Update job state after failed execution
+ *
+ * @param job - The job to update
+ * @param error - Error message
+ * @returns Updated job
+ */
+export function markJobFailed(job, error) {
+    const now = new Date().toISOString();
+    const newRetryCount = job.schedule.retryCount + 1;
+    const maxRetriesReached = newRetryCount >= job.schedule.maxRetries;
+    const updatedJob = {
+        ...job,
+        status: maxRetriesReached ? 'failed' : 'idle',
+        schedule: {
+            ...job.schedule,
+            retryCount: newRetryCount,
+            nextRun: maxRetriesReached ? undefined : calculateNextRun(job, true),
+        },
+        lastError: error,
+        lastStateChange: now,
+    };
+    return updatedJob;
+}
+/**
+ * Mark job as running
+ *
+ * @param job - The job to update
+ * @returns Updated job
+ */
+export function markJobRunning(job) {
+    return {
+        ...job,
+        status: 'running',
+        lastStateChange: new Date().toISOString(),
+    };
+}
+/**
+ * Pause a job (disable without clearing schedule)
+ *
+ * @param job - The job to pause
+ * @returns Updated job
+ */
+export function pauseJob(job) {
+    return {
+        ...job,
+        status: 'disabled',
+        schedule: {
+            ...job.schedule,
+            enabled: false,
+        },
+        lastStateChange: new Date().toISOString(),
+    };
+}
+/**
+ * Resume a paused job
+ *
+ * @param job - The job to resume
+ * @returns Updated job
+ */
+export function resumeJob(job) {
+    return {
+        ...job,
+        status: 'idle',
+        schedule: {
+            ...job.schedule,
+            enabled: true,
+            nextRun: calculateNextRun(job),
+            retryCount: 0, // Reset retries on resume
+        },
+        lastError: undefined,
+        lastStateChange: new Date().toISOString(),
+    };
+}
+/**
+ * Reset a failed job for retry
+ *
+ * @param job - The job to reset
+ * @returns Updated job
+ */
+export function resetJob(job) {
+    return {
+        ...job,
+        status: 'idle',
+        schedule: {
+            ...job.schedule,
+            retryCount: 0,
+            nextRun: calculateNextRun(job),
+        },
+        lastError: undefined,
+        lastStateChange: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=scheduled-job.js.map

package/dist/src/core/scheduler/scheduled-job.js.map

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