@crewx/cron 0.1.10-rc.19 → 0.1.10-rc.190

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 w=exports&&exports.__createBinding||(Object.create?(function(t,n,s,o){if(o===void 0)o=s;var e=Object.getOwnPropertyDescriptor(n,s);if(!e||("get"in e?!n.__esModule:e.writable||e.configurable)){e={enumerable:true,get:function(){return n[s]}}}Object.defineProperty(t,o,e)}):(function(t,n,s,o){if(o===void 0)o=s;t[o]=n[s]}));var S=exports&&exports.__setModuleDefault||(Object.create?(function(t,n){Object.defineProperty(t,"default",{enumerable:true,value:n})}):function(t,n){t["default"]=n});var p=exports&&exports.__importStar||(function(){var t=function(n){t=Object.getOwnPropertyNames||function(s){var o=[];for(var e in s)if(Object.prototype.hasOwnProperty.call(s,e))o[o.length]=e;return o};return t(n)};return function(n){if(n&&n.__esModule)return n;var s={};if(n!=null){for(var o=t(n),e=0;e<o.length;e++)if(o[e]!=="default")w(s,n,o[e])}S(s,n);return s}})();Object.defineProperty(exports,"__esModule",{value:true});exports.CRON_RUNTIME_LIFECYCLE_MANAGED=void 0;exports.formatDisplayTimestamp=m;exports.main=b;const f=p(require("fs"));const h=p(require("path"));let _="unknown";try{const t=f.existsSync(h.join(__dirname,"package.json"))?h.join(__dirname,"package.json"):h.join(__dirname,"..","package.json");const n=JSON.parse(f.readFileSync(t,"utf-8"));if(n?.version)_=String(n.version)}catch{}async function C(){try{return await Promise.resolve().then(()=>p(require("@crewx/shared/skill-tracer")))}catch{return null}}const a=require("./src/engine");exports.CRON_RUNTIME_LIFECYCLE_MANAGED="CRON_RUNTIME_LIFECYCLE_MANAGED";function $(t){const n=new Error(`${exports.CRON_RUNTIME_LIFECYCLE_MANAGED}: cron ${t} is managed by the CrewX server runtime; start the server instead`);n.code=exports.CRON_RUNTIME_LIFECYCLE_MANAGED;return n}function i(t,n,s){for(let o=0;o<t.length;o++){const e=t[o];if(!e)continue;if(e===n||s&&e===s){return t[o+1]}if(e.startsWith(n+"=")){return e.slice(n.length+1)}if(s&&e.startsWith(s+"=")){return e.slice(s.length+1)}}return void 0}function d(t,n,s){return t.includes(n)||(s?t.includes(s):false)}function E(){const t=h.join(__dirname,"..","SKILL.md");if(f.existsSync(t)){process.stdout.write(f.readFileSync(t,"utf-8"))}else{console.log("No SKILL.md found. Use --help for usage.")}}function m(t){const n=t.toISOString();return`${n.slice(0,10)} ${n.slice(11,19)} UTC`}function v(){console.log(`
+@crewx/cron@${_} - Cron-based task scheduler for AI agents
 
 Usage:
   cron <command> [options]
@@ -117,323 +30,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 b(t){const n=t??process.argv.slice(2);const s=n[0];if(d(n,"--version")){console.log(_);return}if(!s||s==="help"||d(n,"--help","-h")){v();return}switch(s){case"usage":{E();break}case"add":{const o=[];for(let u=1;u<n.length;u++){const g=n[u];if(!g)continue;if(g.startsWith("-")){if(["--name","-n","--mode","-m","--timezone","-t","--dir","-d","--timeout","--model","--provider"].includes(g)){u++}continue}o.push(g)}if(o.length<2){console.error("Usage: cron add <schedule> <command> [--name <name>] [--mode <mode>] [--model <model>] [--provider <provider>]");process.exit(1)}const e=o[0];const c=o.slice(1).join(" ");const r=n.slice(1);const l=(0,a.addSchedule)(e,c,{name:i(r,"--name","-n"),mode:i(r,"--mode","-m"),timezone:i(r,"--timezone","-t"),dir:i(r,"--dir","-d"),timeout:i(r,"--timeout"),allowConcurrent:d(r,"--allow-concurrent"),model:i(r,"--model"),provider:i(r,"--provider")});console.log(`Schedule created: ${l.id}`);console.log(`Cron: ${e} (${(0,a.describeCron)(e)})`);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: ${m(new Date(l.next_run))}`);break}case"list":case"ls":{const o=d(n,"--json");const e=(0,a.loadSchedules)();if(o){console.log(JSON.stringify(e,null,2));return}if(e.length===0){console.log("No schedules found.");return}console.log(`
+Schedules (${e.length}):
+`);console.log("| ID     | Name           | Cron        | Status | Command                    |");console.log("|--------|----------------|-------------|--------|----------------------------|");for(const c of e){const r=c.enabled?"ON ":"OFF";const l=(c.name??"-").substring(0,14).padEnd(14);const u=c.cron.substring(0,11).padEnd(11);const g=c.command.substring(0,26).padEnd(26);console.log(`| ${c.id} | ${l} | ${u} | ${r}    | ${g} |`)}console.log("");break}case"remove":case"rm":{const o=n[1];if(!o){console.error("Usage: cron remove <id>");process.exit(1)}try{const e=(0,a.removeSchedule)(o);console.log(`Removed schedule: ${o}`);console.log(`Cron: ${e.cron}`);console.log(`Command: ${e.command}`)}catch(e){const c=e;console.error(c.message);process.exit(1)}break}case"enable":{const o=n[1];if(!o){console.error("Usage: cron enable <id>");process.exit(1)}try{(0,a.enableSchedule)(o);console.log(`Enabled schedule: ${o}`)}catch(e){const c=e;console.error(c.message);process.exit(1)}break}case"disable":{const o=n[1];if(!o){console.error("Usage: cron disable <id>");process.exit(1)}try{(0,a.disableSchedule)(o);console.log(`Disabled schedule: ${o}`)}catch(e){const c=e;console.error(c.message);process.exit(1)}break}case"update":{const o=n[1];if(!o){console.error("Usage: cron update <id> [--cron <expr>] [--command <cmd>] [--name <name>] [--model <model>] [--clear-model] [--provider <provider>] [--clear-provider]");process.exit(1)}const e=n.slice(1);try{const c={cron:i(e,"--cron","-c"),command:i(e,"--command","-C"),name:i(e,"--name","-n"),mode:i(e,"--mode","-m"),timezone:i(e,"--timezone","-t"),working_directory:i(e,"--dir","-d"),timeout_ms:i(e,"--timeout")?parseInt(i(e,"--timeout"),10):void 0,allow_concurrent:d(e,"--allow-concurrent")?true:d(e,"--no-allow-concurrent")?false:void 0,model:d(e,"--clear-model")?null:i(e,"--model"),provider:d(e,"--clear-provider")?null:i(e,"--provider")};const{schedule:r,changes:l}=(0,a.updateSchedule)(o,c);if(l.length===0){console.log("No changes specified. Use --cron, --command, --name, etc.");process.exit(1)}console.log(`Updated schedule: ${o}`);l.forEach(u=>console.log(`  ${u}`));if(r.next_run){console.log(`Next run: ${m(new Date(r.next_run))}`)}}catch(c){const r=c;console.error(r.message);process.exit(1)}break}case"info":{const o=n[1];if(!o){console.error("Usage: cron info <id>");process.exit(1)}const e=d(n,"--json");const c=(0,a.loadSchedules)();const r=c.find(l=>l.id===o);if(!r){console.error(`Schedule not found: ${o}`);process.exit(1)}if(e){console.log(JSON.stringify(r,null,2));return}console.log(`
+Schedule: ${r.id}`);console.log("\u2500".repeat(40));console.log(`Name: ${r.name??"-"}`);console.log(`Cron: ${r.cron} (${(0,a.describeCron)(r.cron)})`);console.log(`Command: ${r.command}`);console.log(`Mode: ${r.mode}`);console.log(`Model: ${r.model??"(agent default)"}`);console.log(`Provider: ${r.provider??"(agent default)"}`);console.log(`Status: ${r.enabled?"Enabled":"Disabled"}`);console.log(`Timezone: ${r.timezone??"Local"}`);console.log(`Working Dir: ${r.working_directory??"Project root"}`);console.log(`Timeout: ${r.timeout_ms/1e3}s`);console.log(`Allow Concurrent: ${r.allow_concurrent?"Yes":"No"}`);console.log("\u2500".repeat(40));console.log(`Created: ${m(new Date(r.created_at))}`);console.log(`Updated: ${m(new Date(r.updated_at))}`);console.log(`Last Run: ${r.last_run?m(new Date(r.last_run)):"Never"}`);console.log(`Next Run: ${r.next_run?m(new Date(r.next_run)):"Unknown"}`);console.log(`Run Count: ${r.run_count??0}`);console.log("");break}case"run":{const o=n[1];if(!o){console.error("Usage: cron run <id>");process.exit(1)}const e=(0,a.loadSchedules)();const c=e.find(u=>u.id===o);if(!c){console.error(`Schedule not found: ${o}`);process.exit(1)}console.log(`Running schedule: ${o}`);const r=await(0,a.executeSchedule)(c,{trigger:"cron_manual"});if(r.status==="blocked"){console.error("A desktop update is draining active work; cannot start a new schedule run right now.");process.exit(1)}if(r.status==="conflict"){console.error(`Schedule already running (task: ${r.runningTaskId})`);process.exit(1)}console.log(`Task started: ${r.taskId}`);const l=await r.done;console.log(`Result: ${l.success?"Success":"Failed"}`);if(l.error)console.log(`Error: ${l.error}`);break}case"start":{throw $(s)}case"stop":{throw $(s)}case"status":{const o=d(n,"--json");const e=(0,a.getDaemonStatus)();if(o){console.log(JSON.stringify(e,null,2));return}if(e.running&&e.pid){console.log(`Daemon is running (PID: ${e.pid})`);if(e.started_at){console.log(`Started: ${m(new Date(e.started_at))}`)}}else{console.log("Daemon is not running")}console.log(`Schedules: ${e.schedules.enabled}/${e.schedules.total} enabled`);break}case"daemon":{if(d(n,"--foreground")){(0,a.runDaemonForeground)()}else{throw $(s)}break}default:{console.error(`Unknown command: ${s}`);v();process.exit(1)}}}if(require.main===module){const t=process.argv.slice(2);const n=t[0]==="daemon"&&t.includes("--foreground");(n?Promise.resolve(null):C()).then(s=>{const o=s?{skillVersion:s.getOwnSkillVersion(__dirname)}:{};return s?s.run("crewx/cron",()=>b(),o):b()}).catch(s=>{console.error(s.message);process.exit(1)})}

package/dist/src/builtins.d.ts

@@ -0,0 +1,14 @@
+import type { ExecutionMode } from './types';
+export interface BuiltinScheduleDef {
+    builtin_id: string;
+    name: string;
+    cron: string;
+    mode: ExecutionMode;
+    buildCommand: () => string;
+}
+export declare function getProjectRoot(): string;
+export declare function getBuiltinMemoryCliPath(): 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";var o=exports&&exports.__createBinding||(Object.create?(function(t,e,r,n){if(n===void 0)n=r;var i=Object.getOwnPropertyDescriptor(e,r);if(!i||("get"in i?!e.__esModule:i.writable||i.configurable)){i={enumerable:true,get:function(){return e[r]}}}Object.defineProperty(t,n,i)}):(function(t,e,r,n){if(n===void 0)n=r;t[n]=e[r]}));var a=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:true,value:e})}):function(t,e){t["default"]=e});var f=exports&&exports.__importStar||(function(){var t=function(e){t=Object.getOwnPropertyNames||function(r){var n=[];for(var i in r)if(Object.prototype.hasOwnProperty.call(r,i))n[n.length]=i;return n};return t(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(e!=null){for(var n=t(e),i=0;i<n.length;i++)if(n[i]!=="default")o(r,e,n[i])}a(r,e);return r}})();Object.defineProperty(exports,"__esModule",{value:true});exports.BUILTIN_SCHEDULES=void 0;exports.getProjectRoot=u;exports.getBuiltinMemoryCliPath=c;exports.findBuiltinByName=_;exports.findBuiltinById=s;const l=require("child_process");const d=f(require("path"));function u(){try{return(0,l.execSync)("git rev-parse --show-toplevel",{encoding:"utf8"}).trim()}catch{return process.cwd()}}function c(){return d.join(u(),"packages","built-in","memory","dist","cli.js")}exports.BUILTIN_SCHEDULES=[{builtin_id:"memory-debounce",name:"memory-debounce",cron:"*/1 * * * *",mode:"command",buildCommand:()=>`node ${c()} summarize-dirty`}];function _(t){if(!t)return void 0;return exports.BUILTIN_SCHEDULES.find(e=>e.name===t)}function s(t){return exports.BUILTIN_SCHEDULES.find(e=>e.builtin_id===t)}

package/dist/src/engine.d.ts

@@ -1,23 +1,46 @@
-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 } from './types';
+import { BUILTIN_SCHEDULES, getProjectRoot } from './builtins';
+import type { BuiltinScheduleDef } from './builtins';
+export type { Schedule, ExecutionMode, ExecuteResult, ExecuteScheduleOptions, ExecuteScheduleOutcome, DaemonStatus, UpdateOptions, StartDaemonResult, CronStoreErrorCode, ScheduleStore, ScheduleStoreLock, ScheduleStoreUpdate, ClaimOccurrenceOptions, ClaimOccurrenceResult, RecordFinishedOptions, RecordStartedOptions, };
+export { CronStoreError };
+export type { BuiltinScheduleDef };
+export { BUILTIN_SCHEDULES, getProjectRoot };
 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 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[];
+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 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, } 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 +49,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 +63,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
+