@crewx/cron 0.1.10-rc.24 → 0.1.10-rc.241

package/README.md

@@ -3,5 +3,5 @@
 Cron scheduler for CrewX - schedule and execute crewx commands automatically.
 
 ```bash
-npx cron add "0 9 * * *" "@agent task" --name "Daily Task"
+crewx cron add "0 9 * * *" "@agent task" --name "Daily Task"
 ```

package/dist/cli.d.ts

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
+export declare const CRON_RUNTIME_LIFECYCLE_MANAGED = "CRON_RUNTIME_LIFECYCLE_MANAGED";
+export declare function formatDisplayTimestamp(date: Date): string;
 export declare function main(inputArgs?: string[]): Promise<void>;
-//# sourceMappingURL=cli.d.ts.map
+                                 

package/dist/cli.js

@@ -1,93 +1,6 @@
 #!/usr/bin/env node
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = main;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-let PKG_VERSION = 'unknown';
-try {
-    const _pkgPath = fs.existsSync(path.join(__dirname, 'package.json'))
-        ? path.join(__dirname, 'package.json')
-        : path.join(__dirname, '..', 'package.json');
-    const _pkg = JSON.parse(fs.readFileSync(_pkgPath, 'utf-8'));
-    if (_pkg?.version)
-        PKG_VERSION = String(_pkg.version);
-}
-catch { }
-async function loadTracer() {
-    try {
-        return await Promise.resolve().then(() => __importStar(require('@crewx/shared/skill-tracer')));
-    }
-    catch {
-        return null;
-    }
-}
-const engine_1 = require("./src/engine");
-function getOpt(args, long, short) {
-    for (let i = 0; i < args.length; i++) {
-        const a = args[i];
-        if (!a)
-            continue;
-        if (a === long || (short && a === short)) {
-            return args[i + 1];
-        }
-        if (a.startsWith(long + '=')) {
-            return a.slice(long.length + 1);
-        }
-        if (short && a.startsWith(short + '=')) {
-            return a.slice(short.length + 1);
-        }
-    }
-    return undefined;
-}
-function hasFlag(args, long, short) {
-    return args.includes(long) || (short ? args.includes(short) : false);
-}
-function showDetailedUsage() {
-    const skillMd = path.join(__dirname, '..', 'SKILL.md');
-    if (fs.existsSync(skillMd)) {
-        process.stdout.write(fs.readFileSync(skillMd, 'utf-8'));
-    }
-    else {
-        console.log('No SKILL.md found. Use --help for usage.');
-    }
-}
-function printUsage() {
-    console.log(`
-@crewx/cron@${PKG_VERSION} - Cron-based task scheduler for AI agents
+"use strict";var N=exports&&exports.__createBinding||(Object.create?(function(e,t,r,n){if(n===void 0)n=r;var o=Object.getOwnPropertyDescriptor(t,r);if(!o||("get"in o?!t.__esModule:o.writable||o.configurable)){o={enumerable:true,get:function(){return t[r]}}}Object.defineProperty(e,n,o)}):(function(e,t,r,n){if(n===void 0)n=r;e[n]=t[r]}));var R=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:true,value:t})}):function(e,t){e["default"]=t});var h=exports&&exports.__importStar||(function(){var e=function(t){e=Object.getOwnPropertyNames||function(r){var n=[];for(var o in r)if(Object.prototype.hasOwnProperty.call(r,o))n[n.length]=o;return n};return e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null){for(var n=e(t),o=0;o<n.length;o++)if(n[o]!=="default")N(r,t,n[o])}R(r,t);return r}})();Object.defineProperty(exports,"__esModule",{value:true});exports.CRON_RUNTIME_LIFECYCLE_MANAGED=void 0;exports.formatDisplayTimestamp=g;exports.main=S;const m=h(require("fs"));const f=h(require("path"));let $="unknown";try{const e=m.existsSync(f.join(__dirname,"package.json"))?f.join(__dirname,"package.json"):f.join(__dirname,"..","package.json");const t=JSON.parse(m.readFileSync(e,"utf-8"));if(t?.version)$=String(t.version)}catch{}async function I(){try{return await Promise.resolve().then(()=>h(require("@crewx/shared/skill-tracer")))}catch{return null}}const _=require("@crewx/sdk");const a=require("./src/engine");const k=require("./src/run-record");exports.CRON_RUNTIME_LIFECYCLE_MANAGED="CRON_RUNTIME_LIFECYCLE_MANAGED";function x(e,t){if(e==="APP_LAUNCHER_UNAVAILABLE"){return"This schedule belongs to an App and runs only inside the CrewX server; it cannot be started from the CLI."}if(e==="APP_ROW_INVALID")return"This App schedule is not in its managed form, so it was not run.";if(e==="MODE_UNSUPPORTED")return`Unsupported schedule mode: ${t.mode}`;return"A desktop update is draining active work; cannot start a new schedule run right now."}function v(e){return e.app!==void 0?(0,_.appScheduleCommandLabel)(e.app):e.command}function w(e){const t=new Error(`${exports.CRON_RUNTIME_LIFECYCLE_MANAGED}: cron ${e} is managed by the CrewX server runtime; start the server instead`);t.code=exports.CRON_RUNTIME_LIFECYCLE_MANAGED;return t}const b=20;function C(e){if(e===null)return"-";return`${(e/1e3).toFixed(1)}s`}function A(e,t){if(e.length===0){console.log(t===void 0?"No runs yet.":`No runs yet for ${t}.`);return}console.log(`Recent runs (newest first, ${b} max)`);console.log(`${"STARTED".padEnd(28)}${"STATUS".padEnd(10)}${"MODE".padEnd(9)}${"DURATION".padEnd(10)}${"RUN".padEnd(16)}${"SCHEDULE".padEnd(18)}DETAIL`);for(const r of e){const n=[r.errorCode,r.highFrequency?"high frequency":null].filter(Boolean).join(", ");console.log(`${g(new Date(r.startedAt)).padEnd(28)}${r.status.padEnd(10)}${r.mode.padEnd(9)}${C(r.durationMs).padEnd(10)}${r.id.padEnd(16)}${r.scheduleId.padEnd(18)}`+n)}}function O(e){console.log(`Run: ${e.id}`);console.log(`Schedule: ${e.scheduleId}${e.scheduleName?` (${e.scheduleName})`:""}`);console.log(`Mode: ${e.mode}`);console.log(`Status: ${e.status}`);if(e.errorCode)console.log(`Error: ${e.errorCode}`);if(e.exitCode!==null)console.log(`Exit code: ${e.exitCode}`);if(e.signal)console.log(`Signal: ${e.signal}`);console.log(`Trigger: ${e.trigger}`);console.log(`Started: ${g(new Date(e.startedAt))}`);if(e.finishedAt)console.log(`Finished: ${g(new Date(e.finishedAt))}`);console.log(`Duration: ${C(e.durationMs)}`);if(e.appId)console.log(`App: ${e.appId}`);if(e.command)console.log(`Command: ${e.command}`);if(e.taskId)console.log(`Task: ${e.taskId}`);if(e.outputBytes!==null)console.log(`Output: ${e.outputBytes} bytes${e.outputTruncated?" (truncated during the run)":""}`);console.log("\u2500".repeat(40));if(e.outputTail===null){console.log(e.mode==="app"?"(App runs keep no output tail)":"(no output captured)")}else if(e.outputTail===""){console.log("(no output)")}else{console.log(e.outputTail)}}function U(e){try{return new _.ScheduleRunRepository().get(e)}catch(t){console.warn(`Run ${e} record could not be read; the exit code follows the run's own result: ${t.message}`);return void 0}}function i(e,t,r){for(let n=0;n<e.length;n++){const o=e[n];if(!o)continue;if(o===t||r&&o===r){return e[n+1]}if(o.startsWith(t+"=")){return o.slice(t.length+1)}if(r&&o.startsWith(r+"=")){return o.slice(r.length+1)}}return void 0}function u(e,t,r){return e.includes(t)||(r?e.includes(r):false)}function T(){const e=f.join(__dirname,"..","SKILL.md");if(m.existsSync(e)){process.stdout.write(m.readFileSync(e,"utf-8"))}else{console.log("No SKILL.md found. Use --help for usage.")}}function g(e){const t=e.toISOString();return`${t.slice(0,10)} ${t.slice(11,19)} UTC`}function y(){console.log(`
+@crewx/cron@${$} - Cron-based task scheduler for AI agents
 
 Usage:
   cron <command> [options]
@@ -101,6 +14,7 @@ Commands:
   cron update <id> [options]            Update a schedule
   cron info <id>                        Show schedule details
   cron run <id>                         Run a schedule immediately
+  cron runs [cron_\u2026 | crun_\u2026]           List recent runs, or show one run with its output
   cron start                            Start the cron daemon
   cron stop                             Stop the cron daemon
   cron status                           Check daemon status
@@ -117,323 +31,7 @@ Examples:
   cron start
 
 For detailed usage guide: cron usage
-`);
-}
-async function main(inputArgs) {
-    const args = inputArgs ?? process.argv.slice(2);
-    const command = args[0];
-    if (args.length > 0 && command !== 'daemon') {
-        (0, engine_1.logUsage)(args.join(' '));
-    }
-    if (hasFlag(args, '--version')) {
-        console.log(PKG_VERSION);
-        return;
-    }
-    if (!command || command === 'help' || hasFlag(args, '--help', '-h')) {
-        printUsage();
-        return;
-    }
-    switch (command) {
-        case 'usage': {
-            showDetailedUsage();
-            break;
-        }
-        case 'add': {
-            const positional = [];
-            for (let i = 1; i < args.length; i++) {
-                const arg = args[i];
-                if (!arg)
-                    continue;
-                if (arg.startsWith('-')) {
-                    if (['--name', '-n', '--mode', '-m', '--timezone', '-t', '--dir', '-d', '--timeout'].includes(arg)) {
-                        i++;
-                    }
-                    continue;
-                }
-                positional.push(arg);
-            }
-            if (positional.length < 2) {
-                console.error('Usage: cron add <schedule> <command> [--name <name>] [--mode <mode>]');
-                process.exit(1);
-            }
-            const cronExpr = positional[0];
-            const cmd = positional.slice(1).join(' ');
-            const subArgs = args.slice(1);
-            (0, engine_1.ensureDaemonRunning)();
-            const schedule = (0, engine_1.addSchedule)(cronExpr, cmd, {
-                name: getOpt(subArgs, '--name', '-n'),
-                mode: getOpt(subArgs, '--mode', '-m'),
-                timezone: getOpt(subArgs, '--timezone', '-t'),
-                dir: getOpt(subArgs, '--dir', '-d'),
-                timeout: getOpt(subArgs, '--timeout'),
-                allowConcurrent: hasFlag(subArgs, '--allow-concurrent'),
-            });
-            console.log(`Schedule created: ${schedule.id}`);
-            console.log(`Cron: ${cronExpr} (${(0, engine_1.describeCron)(cronExpr)})`);
-            console.log(`Command: ${cmd}`);
-            console.log(`Mode: ${schedule.mode}`);
-            if (schedule.timezone)
-                console.log(`Timezone: ${schedule.timezone}`);
-            if (schedule.next_run)
-                console.log(`Next run: ${new Date(schedule.next_run).toLocaleString()}`);
-            break;
-        }
-        case 'list':
-        case 'ls': {
-            const jsonOutput = hasFlag(args, '--json');
-            (0, engine_1.ensureDaemonRunning)();
-            const schedules = (0, engine_1.loadSchedules)();
-            if (jsonOutput) {
-                console.log(JSON.stringify(schedules, null, 2));
-                return;
-            }
-            if (schedules.length === 0) {
-                console.log('No schedules found.');
-                return;
-            }
-            console.log(`\nSchedules (${schedules.length}):\n`);
-            console.log('| ID     | Name           | Cron        | Status | Command                    |');
-            console.log('|--------|----------------|-------------|--------|----------------------------|');
-            for (const s of schedules) {
-                const status = s.enabled ? 'ON ' : 'OFF';
-                const name = (s.name ?? '-').substring(0, 14).padEnd(14);
-                const cron = s.cron.substring(0, 11).padEnd(11);
-                const cmd = s.command.substring(0, 26).padEnd(26);
-                console.log(`| ${s.id} | ${name} | ${cron} | ${status}    | ${cmd} |`);
-            }
-            console.log('');
-            break;
-        }
-        case 'remove':
-        case 'rm': {
-            const id = args[1];
-            if (!id) {
-                console.error('Usage: cron remove <id>');
-                process.exit(1);
-            }
-            (0, engine_1.ensureDaemonRunning)();
-            try {
-                const removed = (0, engine_1.removeSchedule)(id);
-                console.log(`Removed schedule: ${id}`);
-                console.log(`Cron: ${removed.cron}`);
-                console.log(`Command: ${removed.command}`);
-            }
-            catch (e) {
-                const err = e;
-                console.error(err.message);
-                process.exit(1);
-            }
-            break;
-        }
-        case 'enable': {
-            const id = args[1];
-            if (!id) {
-                console.error('Usage: cron enable <id>');
-                process.exit(1);
-            }
-            (0, engine_1.ensureDaemonRunning)();
-            try {
-                (0, engine_1.enableSchedule)(id);
-                console.log(`Enabled schedule: ${id}`);
-            }
-            catch (e) {
-                const err = e;
-                console.error(err.message);
-                process.exit(1);
-            }
-            break;
-        }
-        case 'disable': {
-            const id = args[1];
-            if (!id) {
-                console.error('Usage: cron disable <id>');
-                process.exit(1);
-            }
-            (0, engine_1.ensureDaemonRunning)();
-            try {
-                (0, engine_1.disableSchedule)(id);
-                console.log(`Disabled schedule: ${id}`);
-            }
-            catch (e) {
-                const err = e;
-                console.error(err.message);
-                process.exit(1);
-            }
-            break;
-        }
-        case 'update': {
-            const id = args[1];
-            if (!id) {
-                console.error('Usage: cron update <id> [--cron <expr>] [--command <cmd>] [--name <name>]');
-                process.exit(1);
-            }
-            const subArgs = args.slice(1);
-            (0, engine_1.ensureDaemonRunning)();
-            try {
-                const updateOpts = {
-                    cron: getOpt(subArgs, '--cron', '-c'),
-                    command: getOpt(subArgs, '--command', '-C'),
-                    name: getOpt(subArgs, '--name', '-n'),
-                    mode: getOpt(subArgs, '--mode', '-m'),
-                    timezone: getOpt(subArgs, '--timezone', '-t'),
-                    working_directory: getOpt(subArgs, '--dir', '-d'),
-                    timeout_ms: getOpt(subArgs, '--timeout') ? parseInt(getOpt(subArgs, '--timeout'), 10) : undefined,
-                    allow_concurrent: hasFlag(subArgs, '--allow-concurrent') ? true : hasFlag(subArgs, '--no-allow-concurrent') ? false : undefined,
-                };
-                const { schedule, changes } = (0, engine_1.updateSchedule)(id, updateOpts);
-                if (changes.length === 0) {
-                    console.log('No changes specified. Use --cron, --command, --name, etc.');
-                    process.exit(1);
-                }
-                console.log(`Updated schedule: ${id}`);
-                changes.forEach(c => console.log(`  ${c}`));
-                if (schedule.next_run) {
-                    console.log(`Next run: ${new Date(schedule.next_run).toLocaleString()}`);
-                }
-            }
-            catch (e) {
-                const err = e;
-                console.error(err.message);
-                process.exit(1);
-            }
-            break;
-        }
-        case 'info': {
-            const id = args[1];
-            if (!id) {
-                console.error('Usage: cron info <id>');
-                process.exit(1);
-            }
-            const jsonOutput = hasFlag(args, '--json');
-            (0, engine_1.ensureDaemonRunning)();
-            const schedules = (0, engine_1.loadSchedules)();
-            const schedule = schedules.find(s => s.id === id);
-            if (!schedule) {
-                console.error(`Schedule not found: ${id}`);
-                process.exit(1);
-            }
-            if (jsonOutput) {
-                console.log(JSON.stringify(schedule, null, 2));
-                return;
-            }
-            console.log(`\nSchedule: ${schedule.id}`);
-            console.log('─'.repeat(40));
-            console.log(`Name: ${schedule.name ?? '-'}`);
-            console.log(`Cron: ${schedule.cron} (${(0, engine_1.describeCron)(schedule.cron)})`);
-            console.log(`Command: ${schedule.command}`);
-            console.log(`Mode: ${schedule.mode}`);
-            console.log(`Status: ${schedule.enabled ? 'Enabled' : 'Disabled'}`);
-            console.log(`Timezone: ${schedule.timezone ?? 'Local'}`);
-            console.log(`Working Dir: ${schedule.working_directory ?? 'Project root'}`);
-            console.log(`Timeout: ${schedule.timeout_ms / 1000}s`);
-            console.log(`Allow Concurrent: ${schedule.allow_concurrent ? 'Yes' : 'No'}`);
-            console.log('─'.repeat(40));
-            console.log(`Created: ${new Date(schedule.created_at).toLocaleString()}`);
-            console.log(`Updated: ${new Date(schedule.updated_at).toLocaleString()}`);
-            console.log(`Last Run: ${schedule.last_run ? new Date(schedule.last_run).toLocaleString() : 'Never'}`);
-            console.log(`Next Run: ${schedule.next_run ? new Date(schedule.next_run).toLocaleString() : 'Unknown'}`);
-            console.log(`Run Count: ${schedule.run_count ?? 0}`);
-            console.log('');
-            break;
-        }
-        case 'run': {
-            const id = args[1];
-            if (!id) {
-                console.error('Usage: cron run <id>');
-                process.exit(1);
-            }
-            (0, engine_1.ensureDaemonRunning)();
-            const schedules = (0, engine_1.loadSchedules)();
-            const schedule = schedules.find(s => s.id === id);
-            if (!schedule) {
-                console.error(`Schedule not found: ${id}`);
-                process.exit(1);
-            }
-            console.log(`Running schedule: ${id}`);
-            const result = await (0, engine_1.executeSchedule)(schedule);
-            console.log(`Result: ${result.success ? 'Success' : 'Failed'}`);
-            if (result.error)
-                console.log(`Error: ${result.error}`);
-            break;
-        }
-        case 'start': {
-            if ((0, engine_1.isDaemonRunning)()) {
-                const status = (0, engine_1.getDaemonStatus)();
-                console.error(`Daemon already running (PID: ${status.pid ?? 'unknown'})`);
-                process.exit(1);
-            }
-            try {
-                const pid = (0, engine_1.startDaemon)();
-                console.log(`Cron daemon started (PID: ${pid})`);
-                console.log(`PID file: ${engine_1.DATA_PATHS.PID_FILE}`);
-            }
-            catch (e) {
-                const err = e;
-                console.error('Failed to start daemon:', err.message);
-                process.exit(1);
-            }
-            break;
-        }
-        case 'stop': {
-            try {
-                const stopped = (0, engine_1.stopDaemon)();
-                if (!stopped) {
-                    console.error('Daemon not running');
-                    process.exit(1);
-                }
-                console.log('Cron daemon stopped');
-            }
-            catch (e) {
-                const err = e;
-                console.error('Failed to stop daemon:', err.message);
-                process.exit(1);
-            }
-            break;
-        }
-        case 'status': {
-            const jsonOutput = hasFlag(args, '--json');
-            const status = (0, engine_1.getDaemonStatus)();
-            if (jsonOutput) {
-                console.log(JSON.stringify(status, null, 2));
-                return;
-            }
-            if (status.running && status.pid) {
-                console.log(`Daemon is running (PID: ${status.pid})`);
-                if (status.started_at) {
-                    console.log(`Started: ${new Date(status.started_at).toLocaleString()}`);
-                }
-            }
-            else {
-                console.log('Daemon is not running');
-            }
-            console.log(`Schedules: ${status.schedules.enabled}/${status.schedules.total} enabled`);
-            break;
-        }
-        case 'daemon': {
-            if (hasFlag(args, '--foreground')) {
-                (0, engine_1.runDaemonForeground)();
-            }
-            else {
-                console.log('Use "cron start" to start the daemon');
-            }
-            break;
-        }
-        default: {
-            console.error(`Unknown command: ${command}`);
-            printUsage();
-            process.exit(1);
-        }
-    }
-}
-if (require.main === module) {
-    const _args = process.argv.slice(2);
-    const _isDaemonForeground = _args[0] === 'daemon' && _args.includes('--foreground');
-    (_isDaemonForeground ? Promise.resolve(null) : loadTracer()).then(tracer => {
-        const opts = tracer ? { skillVersion: tracer.getOwnSkillVersion(__dirname) } : {};
-        return tracer ? tracer.run('crewx/cron', () => main(), opts) : main();
-    }).catch((e) => {
-        console.error(e.message);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=cli.js.map
+`)}async function S(e){const t=e??process.argv.slice(2);const r=t[0];if(u(t,"--version")){console.log($);return}if(!r||r==="help"||u(t,"--help","-h")){y();return}switch(r){case"usage":{T();break}case"add":{const n=[];for(let d=1;d<t.length;d++){const p=t[d];if(!p)continue;if(p.startsWith("-")){if(["--name","-n","--mode","-m","--timezone","-t","--dir","-d","--timeout","--model","--provider"].includes(p)){d++}continue}n.push(p)}if(n.length<2){console.error("Usage: cron add <schedule> <command> [--name <name>] [--mode <mode>] [--model <model>] [--provider <provider>]");process.exit(1)}const o=n[0];const c=n.slice(1).join(" ");const s=t.slice(1);const l=(0,a.addSchedule)(o,c,{name:i(s,"--name","-n"),mode:i(s,"--mode","-m"),timezone:i(s,"--timezone","-t"),dir:i(s,"--dir","-d"),timeout:i(s,"--timeout"),allowConcurrent:u(s,"--allow-concurrent"),model:i(s,"--model"),provider:i(s,"--provider")});console.log(`Schedule created: ${l.id}`);console.log(`Cron: ${o} (${(0,a.describeCron)(o)})`);console.log(`Command: ${c}`);console.log(`Mode: ${l.mode}`);if(l.model)console.log(`Model: ${l.model}`);if(l.provider)console.log(`Provider: ${l.provider}`);if(l.timezone)console.log(`Timezone: ${l.timezone}`);if(l.next_run)console.log(`Next run: ${g(new Date(l.next_run))}`);break}case"list":case"ls":{const n=u(t,"--json");const o=(0,a.loadSchedules)();if(n){console.log(JSON.stringify(o,null,2));return}if(o.length===0){console.log("No schedules found.");return}console.log(`
+Schedules (${o.length}):
+`);console.log("| ID     | Name           | Cron        | Status | Command                    |");console.log("|--------|----------------|-------------|--------|----------------------------|");for(const c of o){const s=(0,a.effectiveEnabled)(c)?"ON ":"OFF";const l=(c.name??"-").substring(0,14).padEnd(14);const d=c.cron.substring(0,11).padEnd(11);const p=v(c).substring(0,26).padEnd(26);console.log(`| ${c.id} | ${l} | ${d} | ${s}    | ${p} |`)}console.log("");break}case"remove":case"rm":{const n=t[1];if(!n){console.error("Usage: cron remove <id>");process.exit(1)}try{const o=(0,a.removeSchedule)(n);console.log(`Removed schedule: ${n}`);console.log(`Cron: ${o.cron}`);console.log(`Command: ${o.command}`)}catch(o){const c=o;console.error(c.message);process.exit(1)}break}case"enable":{const n=t[1];if(!n){console.error("Usage: cron enable <id>");process.exit(1)}try{(0,a.enableSchedule)(n);console.log(`Enabled schedule: ${n}`)}catch(o){const c=o;console.error(c.message);process.exit(1)}break}case"disable":{const n=t[1];if(!n){console.error("Usage: cron disable <id>");process.exit(1)}try{(0,a.disableSchedule)(n);console.log(`Disabled schedule: ${n}`)}catch(o){const c=o;console.error(c.message);process.exit(1)}break}case"update":{const n=t[1];if(!n){console.error("Usage: cron update <id> [--cron <expr>] [--command <cmd>] [--name <name>] [--model <model>] [--clear-model] [--provider <provider>] [--clear-provider]");process.exit(1)}const o=t.slice(1);try{const c={cron:i(o,"--cron","-c"),command:i(o,"--command","-C"),name:i(o,"--name","-n"),mode:i(o,"--mode","-m"),timezone:i(o,"--timezone","-t"),working_directory:i(o,"--dir","-d"),timeout_ms:i(o,"--timeout")?parseInt(i(o,"--timeout"),10):void 0,allow_concurrent:u(o,"--allow-concurrent")?true:u(o,"--no-allow-concurrent")?false:void 0,model:u(o,"--clear-model")?null:i(o,"--model"),provider:u(o,"--clear-provider")?null:i(o,"--provider")};const{schedule:s,changes:l}=(0,a.updateSchedule)(n,c);if(l.length===0){console.log("No changes specified. Use --cron, --command, --name, etc.");process.exit(1)}console.log(`Updated schedule: ${n}`);l.forEach(d=>console.log(`  ${d}`));if(s.next_run){console.log(`Next run: ${g(new Date(s.next_run))}`)}}catch(c){const s=c;console.error(s.message);process.exit(1)}break}case"info":{const n=t[1];if(!n){console.error("Usage: cron info <id>");process.exit(1)}const o=u(t,"--json");const c=(0,a.loadSchedules)();const s=c.find(l=>l.id===n);if(!s){console.error(`Schedule not found: ${n}`);process.exit(1)}if(o){console.log(JSON.stringify(s,null,2));return}console.log(`
+Schedule: ${s.id}`);console.log("\u2500".repeat(40));console.log(`Name: ${s.name??"-"}`);console.log(`Cron: ${s.cron} (${(0,a.describeCron)(s.cron)})`);console.log(`Command: ${v(s)}`);console.log(`Mode: ${s.mode}`);console.log(`Model: ${s.model??"(agent default)"}`);console.log(`Provider: ${s.provider??"(agent default)"}`);console.log(`Status: ${(0,a.effectiveEnabled)(s)?"Enabled":"Disabled"}`);if(s.app!==void 0)console.log(`App: ${s.app.appId} (${s.app.actionId}); change it from the App`);console.log(`Timezone: ${s.timezone??"Local"}`);console.log(`Working Dir: ${s.working_directory??"Project root"}`);console.log(`Timeout: ${s.timeout_ms/1e3}s`);console.log(`Allow Concurrent: ${s.allow_concurrent?"Yes":"No"}`);console.log("\u2500".repeat(40));console.log(`Created: ${g(new Date(s.created_at))}`);console.log(`Updated: ${g(new Date(s.updated_at))}`);console.log(`Last Run: ${s.last_run?g(new Date(s.last_run)):"Never"}`);console.log(`Next Run: ${s.next_run?g(new Date(s.next_run)):"Unknown"}`);console.log(`Run Count: ${s.run_count??0}`);console.log("");break}case"run":{const n=t[1];if(!n){console.error("Usage: cron run <id>");process.exit(1)}const o=(0,a.loadSchedules)();const c=o.find(D=>D.id===n);if(!c){console.error(`Schedule not found: ${n}`);process.exit(1)}console.log(`Running schedule: ${n}`);const s=await(0,a.executeSchedule)(c,{trigger:"cron_manual"});if(s.status==="blocked"){console.error(x(s.reason,c));process.exit(1)}if(s.status==="conflict"){console.error(`Schedule already running (run: ${s.runningRunId??"unknown"})`);process.exit(1)}if(s.status==="skipped"){console.error(`Schedule not run: ${s.reason}`);break}console.log(`Run started: ${s.runId}`);if(s.taskId!==void 0)console.log(`Task: ${s.taskId}`);const l=await s.done;const d=U(s.runId);const p=!l.success||d?.status==="failed"||d?.status==="lost";console.log(`Result: ${p?"Failed":"Success"}`);const E=l.error??d?.errorCode;if(E)console.log(`Error: ${E}`);if(p)process.exit(1);break}case"runs":{const n=t[1];const o=new _.ScheduleRunRepository;const c=(0,k.runWorkspaceId)(process.cwd());if(n!==void 0&&n.startsWith("crun_")){const l=o.get(n);if(l===void 0||l.workspaceId!==c){console.error(`Run not found in this workspace: ${n}`);process.exit(1)}O(l);break}const s=n===void 0?o.listByWorkspace(c,{limit:b}):o.listBySchedule(c,n,b);A(s,n);break}case"start":{throw w(r)}case"stop":{throw w(r)}case"status":{const n=u(t,"--json");const o=(0,a.getDaemonStatus)();if(n){console.log(JSON.stringify(o,null,2));return}if(o.running&&o.pid){console.log(`Daemon is running (PID: ${o.pid})`);if(o.started_at){console.log(`Started: ${g(new Date(o.started_at))}`)}}else{console.log("Daemon is not running")}console.log(`Schedules: ${o.schedules.enabled}/${o.schedules.total} enabled`);break}case"daemon":{if(u(t,"--foreground")){(0,a.runDaemonForeground)()}else{throw w(r)}break}default:{console.error(`Unknown command: ${r}`);y();process.exit(1)}}}if(require.main===module){const e=process.argv.slice(2);const t=e[0]==="daemon"&&e.includes("--foreground");(t?Promise.resolve(null):I()).then(r=>{const n=r?{skillVersion:r.getOwnSkillVersion(__dirname)}:{};return r?r.run("crewx/cron",()=>S(),n):S()}).catch(r=>{console.error(r.message);process.exit(1)})}

package/dist/src/builtins.d.ts

@@ -0,0 +1,17 @@
+import type { ExecutionMode } from './types';
+export interface BuiltinScheduleDef {
+    builtin_id: string;
+    name: string;
+    cron: string;
+    mode: ExecutionMode;
+    buildCommand: () => string;
+    cliArgs: readonly string[];
+    isLegacyCommand: (command: string) => boolean;
+    isFrozenPathCommand: (command: string) => boolean;
+}
+export declare function normalizeBuiltinCommand(command: string): string;
+export declare function getProjectRoot(): string;
+export declare const BUILTIN_SCHEDULES: BuiltinScheduleDef[];
+export declare function findBuiltinByName(name: string | null | undefined): BuiltinScheduleDef | undefined;
+export declare function findBuiltinById(builtinId: string): BuiltinScheduleDef | undefined;
+                                      

package/dist/src/builtins.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.BUILTIN_SCHEDULES=void 0;exports.normalizeBuiltinCommand=t;exports.getProjectRoot=m;exports.findBuiltinByName=d;exports.findBuiltinById=u;const r=require("child_process");function t(e){return e.trim().replace(/\s+/g," ")}function m(){try{return(0,r.execSync)("git rev-parse --show-toplevel",{encoding:"utf8"}).trim()}catch{return process.cwd()}}const n=/^node .+[\\/]packages[\\/]built-in[\\/]memory[\\/]dist[\\/]cli\.js summarize-dirty$/;const o=[n,/^npx memory summarize-dirty$/,/^npx @crewx\/memory summarize-dirty$/];exports.BUILTIN_SCHEDULES=[{builtin_id:"memory-debounce",name:"memory-debounce",cron:"*/1 * * * *",mode:"command",buildCommand:()=>"crewx memory summarize-dirty",cliArgs:["memory","summarize-dirty"],isLegacyCommand:e=>o.some(i=>i.test(e)),isFrozenPathCommand:e=>n.test(e)}];function d(e){if(!e)return void 0;return exports.BUILTIN_SCHEDULES.find(i=>i.name===e)}function u(e){return exports.BUILTIN_SCHEDULES.find(i=>i.builtin_id===e)}

package/dist/src/engine.d.ts

@@ -1,23 +1,60 @@
-import type { Schedule, ExecutionMode, ExecuteResult, DaemonStatus, UpdateOptions } from './types';
-export type { Schedule, ExecutionMode, ExecuteResult, DaemonStatus, UpdateOptions };
+import { spawn } from 'child_process';
+import { CronStoreError } from './types';
+import type { Schedule, ExecutionMode, ExecuteResult, ExecuteScheduleOptions, ExecuteScheduleOutcome, DaemonStatus, UpdateOptions, StartDaemonResult, CronStoreErrorCode, ScheduleStore, ScheduleStoreLock, ScheduleStoreUpdate, ClaimOccurrenceOptions, ClaimOccurrenceResult, RecordFinishedOptions, RecordStartedOptions, AppScheduleBinding, AppScheduleChildExit, AppScheduleLaunchDecision, AppScheduleLauncher, AppScheduleOwner, AppScheduleSettle, AppScheduleSkipRecord, AppScheduleTemplate, AppScheduleWrite, ExecuteScheduleSkipped, ScheduleTrigger } from './types';
+import { BUILTIN_SCHEDULES, getProjectRoot } from './builtins';
+import type { BuiltinScheduleDef } from './builtins';
+export type { Schedule, ExecutionMode, ExecuteResult, ExecuteScheduleOptions, ExecuteScheduleOutcome, ExecuteScheduleSkipped, AppScheduleBinding, AppScheduleLaunchDecision, AppScheduleLauncher, AppScheduleOwner, AppScheduleSettle, AppScheduleChildExit, AppScheduleSkipRecord, AppScheduleTemplate, AppScheduleWrite, ScheduleTrigger, DaemonStatus, UpdateOptions, StartDaemonResult, CronStoreErrorCode, ScheduleStore, ScheduleStoreLock, ScheduleStoreUpdate, ClaimOccurrenceOptions, ClaimOccurrenceResult, RecordFinishedOptions, RecordStartedOptions, };
+export { CronStoreError };
+export type { BuiltinScheduleDef };
+export { BUILTIN_SCHEDULES, getProjectRoot, recognizeBuiltinRow };
 export declare function getLocalTimestamp(): string;
-export declare function logUsage(...args: string[]): void;
-export declare function getProjectRoot(): string;
+export declare function logUsage(dirOrMessage?: string, ...args: string[]): void;
+export declare function acquireWorkspaceLock(workspacePath: string, timeout?: number): ScheduleStoreLock;
+export declare function releaseWorkspaceLock(owner: ScheduleStoreLock): boolean;
+export declare function migrateLegacyMemoryDebounceSchedule(workspacePath?: string): void;
 export declare function normalizeMode(mode: string): ExecutionMode;
+export declare function effectiveEnabled(schedule: Pick<Schedule, 'enabled' | 'app'>): boolean;
+export declare function createScheduleStore(workspacePath?: string): ScheduleStore;
 export declare function loadSchedules(dir?: string): Schedule[];
 export declare function saveSchedules(schedules: Schedule[], dir?: string): void;
-export declare function acquireLock(timeout?: number): Promise<boolean>;
-export declare function releaseLock(): void;
+export declare function getRemovedBuiltins(dir?: string): string[];
+export declare function seedBuiltinSchedules(dir?: string): string[];
+declare function recognizeBuiltinRow(schedule: Schedule): BuiltinScheduleDef | undefined;
+export declare function acquireLock(timeout?: number, dir?: string): Promise<boolean>;
+export declare function releaseLock(dir?: string): void;
+export declare function releaseRunLock(scheduleId: string, leaseId: string, dir?: string): boolean;
 export declare function shouldRunNow(cronExpr: string, now: Date, timezone?: string | null): boolean;
 export declare function describeCron(cronExpr: string): string;
 export declare function calculateNextRun(cronExpr: string, timezone?: string | null): string | null;
-export declare function isDaemonRunning(dir?: string): boolean;
-export declare function startDaemon(dir?: string): number;
-export declare function stopDaemon(dir?: string): boolean;
-export declare function ensureDaemonRunning(dir?: string): void;
+type DaemonProcessProbe = {
+    isAlive: (pid: number) => boolean | 'unknown';
+    getCommandLine: (pid: number) => string | null;
+    spawnImpl?: typeof spawn;
+};
+export declare function isDaemonRunning(dir?: string, probe?: DaemonProcessProbe): boolean;
+export declare function startDaemon(dir?: string, probe?: DaemonProcessProbe): number;
+export declare function stopDaemon(dir?: string, probe?: DaemonProcessProbe): boolean;
+export declare function startDaemonSafe(dir?: string, probe?: DaemonProcessProbe): StartDaemonResult;
+export declare function ensureDaemonRunning(dir?: string, probe?: DaemonProcessProbe): void;
 export declare function getDaemonStatus(dir?: string): DaemonStatus;
-export declare function executeSchedule(schedule: Schedule, dir?: string): Promise<ExecuteResult>;
+export declare function executeSchedule(schedule: Schedule, options?: ExecuteScheduleOptions): Promise<ExecuteScheduleOutcome>;
+export declare function isHighFrequencyCron(cronExpr: string, now: Date, timezone?: string | null): boolean;
+export declare const SCHEDULE_RUN_SWEEP_INTERVAL_MS: number;
+export interface ScheduleRunSweepResult {
+    lost: number;
+    logsRemoved: number;
+    deleted: number;
+    tailsCleared: number;
+}
+export declare function sweepScheduleRuns(options?: {
+    dir?: string;
+    now?: Date;
+}): ScheduleRunSweepResult;
+export declare function getLocalMinuteKey(now: Date, timezone?: string | null): string;
+export declare function buildOccurrenceKey(cronExpression: string, scheduledMinute: string): string;
 export declare function daemonTick(dir?: string): Promise<void>;
+export { createCronRuntime, CRON_RUNTIME_PROCESS_LEASE_FILENAME, scheduledPeriodicAvailability, } from './runtime';
+export type { CronRuntimeAdmissionContext, CronRuntimeBeforeExecutorAdmission, CronRuntime, CronRuntimeExecutor, CronRuntimeFenceResult, CronRuntimeFenceToken, CronRuntimeOptions, CronRuntimeProcessLeaseProvider, CronRuntimeScheduleResult, CronRuntimeScheduleResultStatus, CronRuntimeRole, CronRuntimeShouldRunNow, CronRuntimeSnapshot, CronRuntimeStatus, CronRuntimeStopResult, CronRuntimeTickResult, CronRuntimeTickSkipReason, CronRuntimeTestHooks, CronRuntimeWorkspace, CronRuntimeWorkspaceState, CronRuntimeWorkspaceStatus, CronRuntimeWorkspaceTickResult, CronRuntimeStoreFactory, } from './runtime';
 export declare function runDaemonForeground(dir?: string): void;
 export declare function addSchedule(cron: string, command: string, options: {
     name?: string;
@@ -26,6 +63,8 @@ export declare function addSchedule(cron: string, command: string, options: {
     dir?: string;
     timeout?: string;
     allowConcurrent?: boolean;
+    model?: string;
+    provider?: string;
 }, dataDir?: string): Schedule;
 export declare function removeSchedule(id: string, dir?: string): Schedule;
 export declare function enableSchedule(id: string, dir?: string): Schedule;
@@ -38,7 +77,9 @@ export declare const DATA_PATHS: {
     DATA_DIR: string;
     SCHEDULES_FILE: string;
     LOG_FILE: string;
+    LOCK_FILE: string;
     USAGE_LOG_FILE: string;
     PID_FILE: string;
+    BUILTINS_META_FILE: string;
 };
-//# sourceMappingURL=engine.d.ts.map
+