@exaudeus/workrail 3.70.5 → 3.70.7

package/dist/cli/commands/worktrain-daemon.d.ts

@@ -27,5 +27,8 @@ export interface WorktrainDaemonCommandOpts {
     readonly install?: boolean;
     readonly uninstall?: boolean;
     readonly status?: boolean;
+    readonly start?: boolean;
+    readonly stop?: boolean;
 }
+export declare function parseDotEnv(content: string): Record<string, string>;
 export declare function executeWorktrainDaemonCommand(deps: WorktrainDaemonCommandDeps, opts: WorktrainDaemonCommandOpts): Promise<CliResult>;

package/dist/cli/commands/worktrain-daemon.js

@@ -1,19 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDotEnv = parseDotEnv;
 exports.executeWorktrainDaemonCommand = executeWorktrainDaemonCommand;
 const cli_result_js_1 = require("../types/cli-result.js");
 const LAUNCHD_LABEL = 'io.worktrain.daemon';
 const PLIST_FILENAME = `${LAUNCHD_LABEL}.plist`;
 const CAPTURED_ENV_VARS = [
     'AWS_PROFILE',
-    'AWS_ACCESS_KEY_ID',
-    'AWS_SECRET_ACCESS_KEY',
-    'AWS_SESSION_TOKEN',
-    'ANTHROPIC_API_KEY',
     'WORKRAIL_TRIGGERS_ENABLED',
     'WORKRAIL_DEFAULT_WORKSPACE',
-    'GITHUB_TOKEN',
-    'GITLAB_TOKEN',
     'HOME',
     'USER',
     'PATH',
@@ -56,20 +51,16 @@ ${envEntries}
   <key>StandardErrorPath</key>
   <string>${escapeXml(stderrLog)}</string>
 
-  <key>RunAtLoad</key>
-  <true/>
-
-  <key>KeepAlive</key>
-  <true/>
-
   <!--
-    ThrottleInterval: minimum seconds between launchd restarts.
-    WHY 30s: prevents launchd from spinning in a tight restart loop if the daemon
-    exits immediately (e.g., missing credentials or invalid workspace path).
-    Without this, a misconfigured service consumes CPU and spams logs.
+    No RunAtLoad or KeepAlive: the daemon must be started explicitly with
+    'worktrain daemon --start'. Auto-starting at login and auto-restarting
+    on crash is unsafe -- WorkTrain acts autonomously in your repos and the
+    operator must decide when it runs.
+
+    To start:  worktrain daemon --start
+    To stop:   worktrain daemon --stop
+    To status: worktrain daemon --status
   -->
-  <key>ThrottleInterval</key>
-  <integer>30</integer>
 </dict>
 </plist>
 `;
@@ -121,19 +112,7 @@ async function runInstall(deps) {
     const plistPath = deps.joinPath(plistDir, PLIST_FILENAME);
     const logDir = deps.joinPath(home, '.workrail', 'logs');
     const env = deps.env;
-    const hasBedrock = !!(env['AWS_PROFILE'] || env['AWS_ACCESS_KEY_ID']);
-    const hasAnthropic = !!env['ANTHROPIC_API_KEY'];
-    if (!hasBedrock && !hasAnthropic) {
-        return (0, cli_result_js_1.failure)('No LLM credentials found in the current environment. ' +
-            'Set AWS_PROFILE (for Bedrock) or ANTHROPIC_API_KEY (for Anthropic) ' +
-            'before running --install so the daemon can authenticate.', {
-            suggestions: [
-                'export AWS_PROFILE=your-sso-profile',
-                'export ANTHROPIC_API_KEY=sk-ant-...',
-            ],
-        });
-    }
-    deps.print('Installing WorkTrain daemon as a launchd service...');
+    deps.print('Registering WorkTrain daemon with launchd...');
     await deps.mkdir(plistDir, { recursive: true });
     await deps.mkdir(logDir, { recursive: true });
     const alreadyInstalled = await deps.exists(plistPath);
@@ -167,21 +146,30 @@ async function runInstall(deps) {
         });
     }
     deps.print('');
-    if (status.running) {
-        deps.print(`WorkTrain daemon installed and running (PID ${status.pid}).`);
-    }
-    else {
-        deps.print(`WorkTrain daemon installed. Service loaded but not yet running.`);
-        deps.print(`This may be normal if WORKRAIL_TRIGGERS_ENABLED was not set.`);
-    }
+    deps.print('WorkTrain daemon registered with launchd.');
+    deps.print('');
+    deps.print('Before starting, put your secrets in ~/.workrail/.env');
+    deps.print('(see docs/configuration.md for the full list):');
+    deps.print('');
+    deps.print('  ANTHROPIC_API_KEY=sk-ant-...');
+    deps.print('  # or for AWS Bedrock: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY');
+    deps.print('  GITHUB_TOKEN=ghp_...          # for GitHub polling triggers');
+    deps.print('  WORKTRAIN_BOT_TOKEN=ghp_...   # for self-improvement queue');
+    deps.print('');
+    deps.print('Then start the daemon:');
+    deps.print('');
+    deps.print('  worktrain daemon --start     Start the daemon now');
+    deps.print('  worktrain daemon --stop      Stop the daemon');
+    deps.print('  worktrain daemon --status    Check if running');
+    deps.print('  worktrain daemon --uninstall Remove the registration');
+    deps.print('');
     deps.print(`Logs: ${logDir}/daemon.stdout.log`);
     deps.print(`      ${logDir}/daemon.stderr.log`);
     return (0, cli_result_js_1.success)({
-        message: status.running
-            ? `WorkTrain daemon installed and running (PID ${status.pid})`
-            : 'WorkTrain daemon installed (service loaded, not yet running)',
+        message: 'WorkTrain daemon registered. Run: worktrain daemon --start',
         details: [
             `Plist: ${plistPath}`,
+            `Start: worktrain daemon --start`,
             `Logs:  ${logDir}/daemon.stdout.log`,
             `       ${logDir}/daemon.stderr.log`,
         ],
@@ -239,24 +227,107 @@ async function runStatus(deps) {
                 : 'WorkTrain daemon is not installed',
     });
 }
+function parseDotEnv(content) {
+    const result = {};
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const value = trimmed.slice(eqIdx + 1).trim();
+        if (key)
+            result[key] = value;
+    }
+    return result;
+}
+async function checkCredentials(deps) {
+    const home = deps.homedir();
+    const envFilePath = deps.joinPath(home, '.workrail', '.env');
+    const merged = { ...deps.env };
+    try {
+        const envContent = await deps.readFile(envFilePath);
+        const parsed = parseDotEnv(envContent);
+        for (const [k, v] of Object.entries(parsed)) {
+            if (!(k in merged))
+                merged[k] = v;
+        }
+    }
+    catch {
+    }
+    const hasAnthropic = !!(merged['ANTHROPIC_API_KEY']);
+    const hasBedrock = !!(merged['AWS_PROFILE'] || merged['AWS_ACCESS_KEY_ID']);
+    if (!hasAnthropic && !hasBedrock) {
+        return ('No LLM credentials found in process env or ~/.workrail/.env.\n' +
+            'The daemon will fail when it tries to call the LLM.\n' +
+            'Add one of the following to ~/.workrail/.env:\n' +
+            '  ANTHROPIC_API_KEY=sk-ant-...\n' +
+            '  AWS_PROFILE=your-sso-profile');
+    }
+    return null;
+}
+async function runStart(deps) {
+    const home = deps.homedir();
+    const plistPath = deps.joinPath(home, 'Library', 'LaunchAgents', PLIST_FILENAME);
+    const logDir = deps.joinPath(home, '.workrail', 'logs');
+    if (!(await deps.exists(plistPath))) {
+        return (0, cli_result_js_1.failure)('WorkTrain daemon is not installed. Run: worktrain daemon --install', { suggestions: ['worktrain daemon --install'] });
+    }
+    const credWarning = await checkCredentials(deps);
+    if (credWarning) {
+        deps.print('');
+        deps.print('WARNING: ' + credWarning);
+        deps.print('');
+    }
+    const result = await deps.exec('launchctl', ['start', LAUNCHD_LABEL]);
+    if (result.exitCode !== 0) {
+        return (0, cli_result_js_1.failure)(`launchctl start failed (exit ${result.exitCode}): ${result.stderr.trim() || result.stdout.trim()}`, { suggestions: [`View logs: tail -f ${logDir}/daemon.stderr.log`] });
+    }
+    await deps.sleep(1000);
+    const listResult = await deps.exec('launchctl', ['list', LAUNCHD_LABEL]);
+    const status = parseLaunchctlList(listResult.stdout, listResult.exitCode);
+    if (status.running) {
+        deps.print(`WorkTrain daemon started (PID ${status.pid}).`);
+        deps.print(`Logs: ${logDir}/daemon.stdout.log`);
+        return (0, cli_result_js_1.success)({ message: `WorkTrain daemon started (PID ${status.pid})` });
+    }
+    return (0, cli_result_js_1.failure)('launchctl start returned 0 but daemon does not appear to be running.', { suggestions: [`View logs: tail -f ${logDir}/daemon.stderr.log`] });
+}
+async function runStop(deps) {
+    const result = await deps.exec('launchctl', ['stop', LAUNCHD_LABEL]);
+    if (result.exitCode !== 0) {
+        const msg = result.stderr.trim() || result.stdout.trim();
+        if (msg.toLowerCase().includes('not running') || msg.toLowerCase().includes('no such process')) {
+            deps.print('WorkTrain daemon is not running.');
+            return (0, cli_result_js_1.success)({ message: 'WorkTrain daemon is not running.' });
+        }
+        return (0, cli_result_js_1.failure)(`launchctl stop failed (exit ${result.exitCode}): ${msg}`);
+    }
+    deps.print('WorkTrain daemon stopped.');
+    return (0, cli_result_js_1.success)({ message: 'WorkTrain daemon stopped.' });
+}
 async function executeWorktrainDaemonCommand(deps, opts) {
-    const flagCount = [opts.install, opts.uninstall, opts.status].filter(Boolean).length;
+    const flagCount = [opts.install, opts.uninstall, opts.status, opts.start, opts.stop].filter(Boolean).length;
     if (flagCount === 0) {
         if (deps.startDaemon) {
             await deps.startDaemon();
             return (0, cli_result_js_1.success)({ message: 'WorkTrain daemon stopped.' });
         }
-        return (0, cli_result_js_1.misuse)('Specify one of: --install, --uninstall, or --status', [
-            'worktrain daemon --install    Install and start as a launchd service',
-            'worktrain daemon --uninstall  Stop and remove the launchd service',
+        return (0, cli_result_js_1.misuse)('Specify one of: --install, --uninstall, --start, --stop, or --status', [
+            'worktrain daemon --install    Register as a launchd service (does not auto-start)',
+            'worktrain daemon --start      Start the daemon',
+            'worktrain daemon --stop       Stop the daemon',
             'worktrain daemon --status     Show service status',
+            'worktrain daemon --uninstall  Remove the launchd service registration',
         ]);
     }
     if (flagCount > 1) {
-        return (0, cli_result_js_1.misuse)('--install, --uninstall, and --status are mutually exclusive. Specify only one.');
+        return (0, cli_result_js_1.misuse)('--install, --uninstall, --start, --stop, and --status are mutually exclusive. Specify only one.');
     }
     if (deps.platform !== 'darwin') {
-        return (0, cli_result_js_1.failure)(`worktrain daemon --install requires macOS (launchd). ` +
+        return (0, cli_result_js_1.failure)(`worktrain daemon management flags require macOS (launchd). ` +
             `Current platform: ${deps.platform}.`, {
             suggestions: [
                 'On Linux, use systemd: create a user service with systemctl --user.',
@@ -268,5 +339,9 @@ async function executeWorktrainDaemonCommand(deps, opts) {
         return runInstall(deps);
     if (opts.uninstall)
         return runUninstall(deps);
+    if (opts.start)
+        return runStart(deps);
+    if (opts.stop)
+        return runStop(deps);
     return runStatus(deps);
 }

package/dist/cli-worktrain.js

@@ -241,8 +241,10 @@ program
 program
     .command('daemon')
     .description('Start the WorkTrain daemon, or manage it as a macOS launchd service')
-    .option('--install', 'Create the launchd plist and start the daemon service')
-    .option('--uninstall', 'Stop the daemon service and remove the launchd plist')
+    .option('--install', 'Register the daemon as a launchd service (does not auto-start)')
+    .option('--uninstall', 'Unregister the daemon from launchd and remove the plist')
+    .option('--start', 'Start the daemon via launchctl (must be installed first)')
+    .option('--stop', 'Stop the running daemon via launchctl')
     .option('--status', 'Show the current status of the daemon service')
     .action(async (options) => {
     await (0, daemon_env_js_1.loadDaemonEnv)();
@@ -385,6 +387,8 @@ program
     }, {
         install: options.install,
         uninstall: options.uninstall,
+        start: options.start,
+        stop: options.stop,
         status: options.status,
     });
     (0, interpret_result_js_1.interpretCliResultWithoutDI)(result);