crewly 1.20.245 → 1.20.246

package/dist/backend/backend/src/services/system/scheduled-commands.service.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Scheduled commands runner.
+ *
+ * Runs host commands listed in `<CREWLY_HOME>/scheduled-commands.json` on an
+ * interval. It exists because launchd jobs cannot read ~/Desktop (TCC), while
+ * the backend can. Design rules:
+ * - The list is read from disk only. There is deliberately no API route or
+ *   trigger action that adds an entry: that would be arbitrary shell
+ *   execution through the API.
+ * - No file = no jobs = feature off.
+ * - Each run is spawned DETACHED (own process group, unref'd, output to a log
+ *   file) so a Crewly restart cannot kill it mid-way (a rollout cut in half
+ *   leaves a mixed fleet).
+ * - A run never starts while the previous one is alive: checked by the pid we
+ *   spawned and, when `lockFile` is set, by the pid inside the command's own
+ *   lock file (a stale pid counts as dead).
+ * - Every skip is logged at debug; a run is logged at info only when spawned.
+ *
+ * Config shape: `[{name, cwd, command, args?, intervalMinutes, enabled?, lockFile?}]`.
+ *
+ * @module services/system/scheduled-commands
+ */
+import { type ChildProcess, type SpawnOptions } from 'child_process';
+/** One validated entry from the config file. */
+export interface ScheduledCommand {
+    /** Unique name (used in the log file name) */
+    name: string;
+    /** Absolute working directory */
+    cwd: string;
+    /** Executable, run without a shell */
+    command: string;
+    /** Arguments */
+    args: string[];
+    /** Minutes between runs */
+    intervalMinutes: number;
+    /** Absolute path of the command's own lock file (holds a pid), optional */
+    lockFile?: string;
+}
+/** Result of reading the config file. */
+export interface LoadedScheduledCommands {
+    /** Enabled, valid entries */
+    entries: ScheduledCommand[];
+    /** Entries in the file that were valid but disabled */
+    disabled: number;
+    /** Why the file or an entry was not used (one line each) */
+    warnings: string[];
+}
+/** Minimal logger contract. */
+export interface ScheduledCommandsLogger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/** Injection points (tests replace the process and filesystem edges). */
+export interface ScheduledCommandsDeps {
+    /** Path of the config file */
+    configPath: string;
+    /** Directory for per-command log files */
+    logDir: string;
+    logger: ScheduledCommandsLogger;
+    /** child_process.spawn */
+    spawn?: (command: string, args: string[], options: SpawnOptions) => ChildProcess;
+    /** True when a process with this pid exists */
+    isPidAlive?: (pid: number) => boolean;
+    /** Reads a text file; throws when missing */
+    readFile?: (file: string) => string;
+    /** True when the path exists */
+    pathExists?: (file: string) => boolean;
+    /** Opens the log file for appending and returns an fd */
+    openLog?: (file: string) => number;
+    /** Closes an fd */
+    closeLog?: (fd: number) => void;
+}
+/**
+ * True when a process with this pid exists (signal 0 probe).
+ *
+ * @param pid - Process id
+ * @returns Whether it is alive
+ */
+export declare function defaultIsPidAlive(pid: number): boolean;
+/**
+ * Parse and validate the config text.
+ *
+ * Invalid input never throws: it yields zero entries and a warning.
+ *
+ * @param text - File contents
+ * @returns Entries, disabled count and warnings
+ */
+export declare function parseScheduledCommands(text: string): LoadedScheduledCommands;
+/** Outcome of one tick for one entry (also returned to tests). */
+export type RunOutcome = 'spawned' | 'skipped-running' | 'skipped-lock' | 'skipped-no-cwd' | 'spawn-failed';
+/**
+ * Interval runner for owner-configured host commands.
+ */
+export declare class ScheduledCommandsService {
+    private readonly deps;
+    private entries;
+    private timers;
+    /** Last spawned pid per entry name */
+    private readonly lastPid;
+    /**
+     * @param deps - Paths, logger and optional process/filesystem overrides
+     */
+    constructor(deps: ScheduledCommandsDeps);
+    /**
+     * Load the config and schedule every enabled entry.
+     *
+     * Logs "N scheduled command(s) loaded" every time, including 0.
+     * A missing file is the normal off state (info); an unreadable or
+     * invalid file logs one warn line.
+     *
+     * @returns Number of jobs scheduled
+     */
+    start(): number;
+    /** Cancel all timers. Spawned children are NOT touched (they are detached). */
+    stop(): void;
+    /**
+     * Try to run one entry now.
+     *
+     * Skips (debug log) when the previous run or the command's own lock holder
+     * is alive, or the cwd is missing (warn). Never claims a run happened
+     * when it was skipped.
+     *
+     * @param entry - Entry to run
+     * @returns What happened
+     */
+    runEntry(entry: ScheduledCommand): RunOutcome;
+}
+//# sourceMappingURL=scheduled-commands.service.d.ts.map

package/dist/backend/backend/src/services/system/scheduled-commands.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-commands.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/system/scheduled-commands.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/system/scheduled-commands.service.js

@@ -0,0 +1,286 @@
+/**
+ * Scheduled commands runner.
+ *
+ * Runs host commands listed in `<CREWLY_HOME>/scheduled-commands.json` on an
+ * interval. It exists because launchd jobs cannot read ~/Desktop (TCC), while
+ * the backend can. Design rules:
+ * - The list is read from disk only. There is deliberately no API route or
+ *   trigger action that adds an entry: that would be arbitrary shell
+ *   execution through the API.
+ * - No file = no jobs = feature off.
+ * - Each run is spawned DETACHED (own process group, unref'd, output to a log
+ *   file) so a Crewly restart cannot kill it mid-way (a rollout cut in half
+ *   leaves a mixed fleet).
+ * - A run never starts while the previous one is alive: checked by the pid we
+ *   spawned and, when `lockFile` is set, by the pid inside the command's own
+ *   lock file (a stale pid counts as dead).
+ * - Every skip is logged at debug; a run is logged at info only when spawned.
+ *
+ * Config shape: `[{name, cwd, command, args?, intervalMinutes, enabled?, lockFile?}]`.
+ *
+ * @module services/system/scheduled-commands
+ */
+import { spawn as nodeSpawn } from 'child_process';
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { SCHEDULED_COMMANDS } from '../../constants.js';
+/**
+ * Expand a leading `~` to the home directory.
+ *
+ * @param p - Path from the config file
+ * @returns Path with `~` expanded
+ */
+function expandHome(p) {
+    if (p === '~')
+        return os.homedir();
+    if (p.startsWith('~/'))
+        return path.join(os.homedir(), p.slice(2));
+    return p;
+}
+/**
+ * True when a process with this pid exists (signal 0 probe).
+ *
+ * @param pid - Process id
+ * @returns Whether it is alive
+ */
+export function defaultIsPidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM = exists but not ours: still alive.
+        return err.code === 'EPERM';
+    }
+}
+/**
+ * Parse and validate the config text.
+ *
+ * Invalid input never throws: it yields zero entries and a warning.
+ *
+ * @param text - File contents
+ * @returns Entries, disabled count and warnings
+ */
+export function parseScheduledCommands(text) {
+    const out = { entries: [], disabled: 0, warnings: [] };
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (err) {
+        out.warnings.push(`config is not valid JSON (${err instanceof Error ? err.message : String(err)}); 0 jobs`);
+        return out;
+    }
+    if (!Array.isArray(raw)) {
+        out.warnings.push('config must be a JSON array; 0 jobs');
+        return out;
+    }
+    const seen = new Set();
+    raw.forEach((item, i) => {
+        const label = `entry ${i}`;
+        if (!item || typeof item !== 'object') {
+            out.warnings.push(`${label}: not an object; skipped`);
+            return;
+        }
+        const e = item;
+        if (typeof e.name !== 'string' || !SCHEDULED_COMMANDS.NAME_PATTERN.test(e.name)) {
+            out.warnings.push(`${label}: name must match ${SCHEDULED_COMMANDS.NAME_PATTERN}; skipped`);
+            return;
+        }
+        if (seen.has(e.name)) {
+            out.warnings.push(`${label} (${e.name}): duplicate name; skipped`);
+            return;
+        }
+        if (typeof e.command !== 'string' || e.command.trim() === '') {
+            out.warnings.push(`${label} (${e.name}): command is required; skipped`);
+            return;
+        }
+        if (typeof e.cwd !== 'string' || !path.isAbsolute(expandHome(e.cwd))) {
+            out.warnings.push(`${label} (${e.name}): cwd must be an absolute path; skipped`);
+            return;
+        }
+        if (e.args !== undefined && (!Array.isArray(e.args) || e.args.some((a) => typeof a !== 'string'))) {
+            out.warnings.push(`${label} (${e.name}): args must be an array of strings; skipped`);
+            return;
+        }
+        if (typeof e.intervalMinutes !== 'number' ||
+            !Number.isFinite(e.intervalMinutes) ||
+            e.intervalMinutes < SCHEDULED_COMMANDS.MIN_INTERVAL_MINUTES) {
+            out.warnings.push(`${label} (${e.name}): intervalMinutes must be a number >= ${SCHEDULED_COMMANDS.MIN_INTERVAL_MINUTES}; skipped`);
+            return;
+        }
+        if (e.lockFile !== undefined && (typeof e.lockFile !== 'string' || !path.isAbsolute(expandHome(e.lockFile)))) {
+            out.warnings.push(`${label} (${e.name}): lockFile must be an absolute path; skipped`);
+            return;
+        }
+        seen.add(e.name);
+        if (e.enabled === false) {
+            out.disabled++;
+            return;
+        }
+        out.entries.push({
+            name: e.name,
+            cwd: expandHome(e.cwd),
+            command: e.command,
+            args: e.args ?? [],
+            intervalMinutes: e.intervalMinutes,
+            lockFile: typeof e.lockFile === 'string' ? expandHome(e.lockFile) : undefined,
+        });
+    });
+    return out;
+}
+/**
+ * Interval runner for owner-configured host commands.
+ */
+export class ScheduledCommandsService {
+    deps;
+    entries = [];
+    timers = [];
+    /** Last spawned pid per entry name */
+    lastPid = new Map();
+    /**
+     * @param deps - Paths, logger and optional process/filesystem overrides
+     */
+    constructor(deps) {
+        this.deps = {
+            spawn: nodeSpawn,
+            isPidAlive: defaultIsPidAlive,
+            readFile: (f) => readFileSync(f, 'utf-8'),
+            pathExists: existsSync,
+            openLog: (f) => {
+                mkdirSync(path.dirname(f), { recursive: true });
+                return openSync(f, 'a');
+            },
+            closeLog: closeSync,
+            ...deps,
+        };
+    }
+    /**
+     * Load the config and schedule every enabled entry.
+     *
+     * Logs "N scheduled command(s) loaded" every time, including 0.
+     * A missing file is the normal off state (info); an unreadable or
+     * invalid file logs one warn line.
+     *
+     * @returns Number of jobs scheduled
+     */
+    start() {
+        this.stop();
+        let text;
+        try {
+            text = this.deps.readFile(this.deps.configPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                this.deps.logger.info('0 scheduled command(s) loaded (no config file)', { path: this.deps.configPath });
+            }
+            else {
+                this.deps.logger.warn('0 scheduled command(s) loaded: config unreadable', {
+                    path: this.deps.configPath,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+            return 0;
+        }
+        const loaded = parseScheduledCommands(text);
+        loaded.warnings.forEach((w) => this.deps.logger.warn(`scheduled-commands: ${w}`));
+        this.entries = loaded.entries;
+        this.deps.logger.info(`${loaded.entries.length} scheduled command(s) loaded`, {
+            disabled: loaded.disabled,
+            invalid: loaded.warnings.length,
+            names: loaded.entries.map((e) => e.name),
+        });
+        for (const entry of this.entries) {
+            const every = entry.intervalMinutes * SCHEDULED_COMMANDS.MS_PER_MINUTE;
+            const first = setTimeout(() => this.runEntry(entry), SCHEDULED_COMMANDS.INITIAL_DELAY_MS);
+            const repeat = setInterval(() => this.runEntry(entry), every);
+            first.unref();
+            repeat.unref();
+            this.timers.push(first, repeat);
+        }
+        return this.entries.length;
+    }
+    /** Cancel all timers. Spawned children are NOT touched (they are detached). */
+    stop() {
+        for (const t of this.timers) {
+            clearTimeout(t);
+            clearInterval(t);
+        }
+        this.timers = [];
+        this.entries = [];
+    }
+    /**
+     * Try to run one entry now.
+     *
+     * Skips (debug log) when the previous run or the command's own lock holder
+     * is alive, or the cwd is missing (warn). Never claims a run happened
+     * when it was skipped.
+     *
+     * @param entry - Entry to run
+     * @returns What happened
+     */
+    runEntry(entry) {
+        const { logger, isPidAlive } = this.deps;
+        const prev = this.lastPid.get(entry.name);
+        if (prev !== undefined && isPidAlive(prev)) {
+            logger.debug(`scheduled-commands: ${entry.name} skipped, previous run pid ${prev} still alive`);
+            return 'skipped-running';
+        }
+        if (entry.lockFile) {
+            let holder = NaN;
+            try {
+                holder = parseInt(this.deps.readFile(entry.lockFile).trim(), 10);
+            }
+            catch {
+                // No lock file = nobody holds it.
+            }
+            if (Number.isInteger(holder) && isPidAlive(holder)) {
+                logger.debug(`scheduled-commands: ${entry.name} skipped, lock held by pid ${holder}`);
+                return 'skipped-lock';
+            }
+        }
+        if (!this.deps.pathExists(entry.cwd)) {
+            logger.warn(`scheduled-commands: ${entry.name} not run, cwd missing`, { cwd: entry.cwd });
+            return 'skipped-no-cwd';
+        }
+        let fd = -1;
+        try {
+            const logFile = path.join(this.deps.logDir, SCHEDULED_COMMANDS.LOG_FILE_TEMPLATE.replace('{name}', entry.name));
+            fd = this.deps.openLog(logFile);
+            const child = this.deps.spawn(entry.command, entry.args, {
+                cwd: entry.cwd,
+                detached: true,
+                stdio: ['ignore', fd, fd],
+            });
+            child.on('error', (err) => logger.error(`scheduled-commands: ${entry.name} failed to start`, { error: err.message }));
+            child.unref();
+            if (child.pid === undefined) {
+                logger.error(`scheduled-commands: ${entry.name} did not start (no pid)`);
+                return 'spawn-failed';
+            }
+            this.lastPid.set(entry.name, child.pid);
+            logger.info(`scheduled-commands: ${entry.name} started`, { pid: child.pid, cwd: entry.cwd });
+            return 'spawned';
+        }
+        catch (err) {
+            logger.error(`scheduled-commands: ${entry.name} spawn threw`, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return 'spawn-failed';
+        }
+        finally {
+            if (fd >= 0) {
+                try {
+                    this.deps.closeLog(fd);
+                }
+                catch {
+                    // Already closed.
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=scheduled-commands.service.js.map

package/dist/backend/backend/src/services/system/scheduled-commands.service.js.map

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

package/dist/backend/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "3665a7ae6aa59f814baa1d84c501a1c0135ef4e3",
-  "builtAt": "2026-10-07T02:38:12.073Z"
+  "commit": "fc5d3138f87924ba2a7018dd3f9b31c3618ea654",
+  "builtAt": "2026-10-07T03:38:58.515Z"
 }

package/dist/cli/backend/src/constants.d.ts

@@ -6989,4 +6989,24 @@ export declare const TEAM_PAUSE_CONSTANTS: {
     /** Metadata key on a WorkItem unassigned because its team was paused */
     readonly UNASSIGNED_METADATA_KEY: "pausedTeamUnassigned";
 };
+/**
+ * Scheduled commands: an owner-edited list of host commands the backend runs
+ * on an interval (e.g. the crewly-web release script). Read from disk only.
+ */
+export declare const SCHEDULED_COMMANDS: {
+    /** Config file under CREWLY_HOME; absent = feature off */
+    readonly CONFIG_FILE: "scheduled-commands.json";
+    /** Directory under CREWLY_HOME that receives each command's stdout/stderr */
+    readonly LOG_DIR: "logs";
+    /** Log file name pattern; `{name}` is the entry name */
+    readonly LOG_FILE_TEMPLATE: "scheduled-{name}.log";
+    /** Shortest interval accepted (minutes); smaller values are rejected */
+    readonly MIN_INTERVAL_MINUTES: 1;
+    /** Delay before the first run after boot (ms), so restarts do not starve a run */
+    readonly INITIAL_DELAY_MS: 30000;
+    /** Entry names: letters, digits, dot, dash, underscore */
+    readonly NAME_PATTERN: RegExp;
+    /** Milliseconds per minute */
+    readonly MS_PER_MINUTE: 60000;
+};
 //# sourceMappingURL=constants.d.ts.map