@masslessai/push-todo 4.1.9 → 4.2.1

package/lib/auto-connect.js

@@ -20,6 +20,38 @@ import { discoverAllProjects } from './discovery.js';
 import { createSpinner } from './utils/spinner.js';
 import { bold, green, red, dim, cyan } from './utils/colors.js';
 import { ensureDaemonRunning } from './daemon-health.js';
+import { install as installLaunchAgent, getStatus as getLaunchAgentStatus } from './launchagent.js';
+
+/**
+ * Install or update LaunchAgent (macOS only).
+ * Called at the end of auto-connect, even for early-exit paths.
+ */
+function installLaunchAgentIfNeeded() {
+  if (process.platform !== 'darwin') return;
+
+  const laStatus = getLaunchAgentStatus();
+  if (!laStatus.installed) {
+    const laSpinner = createSpinner();
+    laSpinner.start('Installing LaunchAgent for auto-start on login...');
+
+    const laResult = installLaunchAgent();
+    if (laResult.success) {
+      laSpinner.succeed('LaunchAgent installed — daemon starts automatically on login');
+    } else {
+      laSpinner.fail(`LaunchAgent: ${laResult.message}`);
+      console.log(`  ${dim('Daemon will still self-heal via push-todo commands.')}`);
+    }
+  } else {
+    // Already installed — ensure it's loaded and up to date
+    const laResult = installLaunchAgent();
+    if (laResult.alreadyInstalled) {
+      console.log(`  ${green('✓')} LaunchAgent already configured`);
+    } else if (laResult.success) {
+      console.log(`  ${green('✓')} LaunchAgent updated`);
+    }
+  }
+  console.log('');
+}
 
 /**
  * Run the auto-connect flow.
@@ -98,6 +130,8 @@ export async function runAutoConnect(options = {}) {
     console.log('  No projects with git remotes found.');
     console.log(`  ${dim('Projects must have a git remote to be registered.')}`);
     console.log('');
+    // Still install LaunchAgent even with no projects
+    installLaunchAgentIfNeeded();
     return;
   }
 
@@ -127,6 +161,8 @@ export async function runAutoConnect(options = {}) {
     console.log(`  ${'='.repeat(40)}`);
     console.log(`  All ${alreadyConnected} projects already connected.`);
     console.log('');
+    // Still install LaunchAgent even when all projects connected
+    installLaunchAgentIfNeeded();
     return;
   }
 
@@ -192,4 +228,7 @@ export async function runAutoConnect(options = {}) {
     console.log(`  Run ${cyan("'push-todo'")} to see your tasks.`);
   }
   console.log('');
+
+  // Phase 6: Install LaunchAgent (macOS only)
+  installLaunchAgentIfNeeded();
 }

package/lib/cli.js

@@ -15,6 +15,7 @@ import { runConnect } from './connect.js';
 import { startWatch } from './watch.js';
 import { showSettings, toggleSetting, setMaxBatchSize } from './config.js';
 import { ensureDaemonRunning, getDaemonStatus, startDaemon, stopDaemon } from './daemon-health.js';
+import { install as installLaunchAgent, uninstall as uninstallLaunchAgent, getStatus as getLaunchAgentStatus } from './launchagent.js';
 import { getScreenshotPath, screenshotExists, openScreenshot } from './utils/screenshots.js';
 import { bold, red, cyan, dim, green } from './utils/colors.js';
 import { getMachineId } from './machine-id.js';
@@ -79,6 +80,8 @@ ${bold('OPTIONS:')}
   --daemon-status                  Show daemon status
   --daemon-start                   Start daemon manually
   --daemon-stop                    Stop daemon
+  --daemon-install                 Install LaunchAgent (auto-start on login)
+  --daemon-uninstall               Remove LaunchAgent
   --commands                       Show available user commands
   --json                           Output as JSON
   --version, -v                    Show version
@@ -121,6 +124,7 @@ ${bold('CRON (scheduled jobs):')}
     --cron <expression>            5-field cron expression
     --notify <message>             Send Mac notification
     --create-todo <content>        Create todo reminder
+    --health-check <path>          Run codebase health check (scope: general|tests|deps)
   push-todo cron list              List all cron jobs
   push-todo cron remove <id>       Remove a cron job by ID
 
@@ -154,6 +158,8 @@ const options = {
   'daemon-status': { type: 'boolean' },
   'daemon-start': { type: 'boolean' },
   'daemon-stop': { type: 'boolean' },
+  'daemon-install': { type: 'boolean' },
+  'daemon-uninstall': { type: 'boolean' },
   'commands': { type: 'boolean' },
   'json': { type: 'boolean' },
   'version': { type: 'boolean', short: 'v' },
@@ -182,6 +188,8 @@ const options = {
   'create-todo': { type: 'string' },
   'notify': { type: 'string' },
   'queue-execution': { type: 'string' },
+  'health-check': { type: 'string' },
+  'scope': { type: 'string' },
   // Skill CLI options (Phase 3)
   'report-progress': { type: 'string' },
   'phase': { type: 'string' },
@@ -251,6 +259,14 @@ export async function run(argv) {
     } else {
       console.log(`${bold('Daemon:')} Not running`);
     }
+    // Show LaunchAgent status
+    const laStatus = getLaunchAgentStatus();
+    if (laStatus.installed) {
+      console.log(`${bold('LaunchAgent:')} Installed${laStatus.loaded ? ' (loaded)' : ' (not loaded)'}`);
+    } else {
+      console.log(`${bold('LaunchAgent:')} Not installed`);
+      console.log(dim('  Run: push-todo --daemon-install'));
+    }
     return;
   }
 
@@ -278,6 +294,11 @@ export async function run(argv) {
       const success = stopDaemon();
       if (success) {
         console.log('Daemon stopped');
+        const laStatus = getLaunchAgentStatus();
+        if (laStatus.installed && laStatus.loaded) {
+          console.log(dim('Note: LaunchAgent will restart the daemon automatically.'));
+          console.log(dim('To fully stop: push-todo --daemon-uninstall'));
+        }
       } else {
         console.error(red('Failed to stop daemon'));
         process.exit(1);
@@ -286,6 +307,35 @@ export async function run(argv) {
     return;
   }
 
+  if (values['daemon-install']) {
+    const result = installLaunchAgent();
+    if (result.success) {
+      if (result.alreadyInstalled) {
+        console.log('LaunchAgent already installed');
+      } else {
+        console.log('LaunchAgent installed — daemon will start automatically on login');
+      }
+      const laStatus = getLaunchAgentStatus();
+      console.log(dim(`Plist: ${laStatus.plistPath}`));
+    } else {
+      console.error(red(result.message));
+      process.exit(1);
+    }
+    return;
+  }
+
+  if (values['daemon-uninstall']) {
+    const result = uninstallLaunchAgent();
+    if (result.success) {
+      console.log(result.message);
+      console.log(dim('Daemon will still self-heal via push-todo commands.'));
+    } else {
+      console.error(red(result.message));
+      process.exit(1);
+    }
+    return;
+  }
+
   // Handle --commands (simple user help)
   if (values.commands) {
     console.log(`
@@ -688,8 +738,14 @@ export async function run(argv) {
         action = { type: 'notify', content: values.notify };
       } else if (values['queue-execution']) {
         action = { type: 'queue-execution', todoId: values['queue-execution'] };
+      } else if (values['health-check']) {
+        action = {
+          type: 'health-check',
+          projectPath: values['health-check'],
+          scope: values.scope || 'general',
+        };
       } else {
-        console.error(red('Action required: --create-todo, --notify, or --queue-execution'));
+        console.error(red('Action required: --create-todo, --notify, --queue-execution, or --health-check'));
         process.exit(1);
       }
 

package/lib/cron.js

@@ -301,8 +301,11 @@ export function listJobs() {
  *
  * @param {Object} job - Job object
  * @param {Function} [logFn] - Optional log function
+ * @param {Object} [context] - Injected dependencies from daemon
+ * @param {Function} [context.apiRequest] - API request function
+ * @param {Function} [context.spawnHealthCheck] - Spawn a health check Claude session
  */
-async function executeAction(job, logFn) {
+async function executeAction(job, logFn, context = {}) {
   const log = logFn || (() => {});
 
   switch (job.action.type) {
@@ -312,17 +315,69 @@ async function executeAction(job, logFn) {
       break;
 
     case 'create-todo':
-      // Phase 2: notification-based (no Supabase edge function yet)
-      sendMacNotification('Push: Scheduled Todo', job.action.content || job.name);
-      log(`Cron "${job.name}": todo reminder sent (notification)`);
+      if (context.apiRequest) {
+        try {
+          const response = await context.apiRequest('create-todo', {
+            method: 'POST',
+            body: JSON.stringify({
+              title: job.action.content || job.name,
+              normalizedContent: job.action.detail || null,
+              isBacklog: job.action.backlog || false,
+              createdByClient: 'daemon-cron',
+            }),
+          });
+          if (response.ok) {
+            const data = await response.json();
+            log(`Cron "${job.name}": created todo #${data.todo?.displayNumber || '?'}`);
+          } else {
+            log(`Cron "${job.name}": create-todo failed (HTTP ${response.status})`);
+            // Fall back to notification
+            sendMacNotification('Push: Scheduled Todo', job.action.content || job.name);
+          }
+        } catch (error) {
+          log(`Cron "${job.name}": create-todo error: ${error.message}`);
+          sendMacNotification('Push: Scheduled Todo', job.action.content || job.name);
+        }
+      } else {
+        sendMacNotification('Push: Scheduled Todo', job.action.content || job.name);
+        log(`Cron "${job.name}": todo reminder sent (notification, no API context)`);
+      }
       break;
 
     case 'queue-execution':
-      // Requires todoId — log warning if missing
       if (!job.action.todoId) {
         log(`Cron "${job.name}": queue-execution requires todoId, skipping`);
+      } else if (context.apiRequest) {
+        try {
+          const response = await context.apiRequest('update-task-execution', {
+            method: 'PATCH',
+            body: JSON.stringify({
+              todoId: job.action.todoId,
+              status: 'queued',
+            }),
+          });
+          if (response.ok) {
+            log(`Cron "${job.name}": queued todo ${job.action.todoId} for execution`);
+          } else {
+            log(`Cron "${job.name}": queue-execution failed (HTTP ${response.status})`);
+          }
+        } catch (error) {
+          log(`Cron "${job.name}": queue-execution error: ${error.message}`);
+        }
+      } else {
+        log(`Cron "${job.name}": queue-execution not available (no API context)`);
+      }
+      break;
+
+    case 'health-check':
+      if (context.spawnHealthCheck) {
+        try {
+          await context.spawnHealthCheck(job, log);
+        } catch (error) {
+          log(`Cron "${job.name}": health-check error: ${error.message}`);
+        }
       } else {
-        log(`Cron "${job.name}": queue-execution for todo ${job.action.todoId} (not yet implemented)`);
+        log(`Cron "${job.name}": health-check not available (no daemon context)`);
       }
       break;
 
@@ -336,8 +391,9 @@ async function executeAction(job, logFn) {
  * Called from daemon poll loop on every cycle.
  *
  * @param {Function} [logFn] - Optional log function
+ * @param {Object} [context] - Injected dependencies (apiRequest, spawnHealthCheck)
  */
-export async function checkAndRunDueJobs(logFn) {
+export async function checkAndRunDueJobs(logFn, context = {}) {
   const jobs = loadJobs();
   if (jobs.length === 0) return;
 
@@ -353,7 +409,7 @@ export async function checkAndRunDueJobs(logFn) {
 
     // Job is due — execute
     try {
-      await executeAction(job, logFn);
+      await executeAction(job, logFn, context);
     } catch (error) {
       if (logFn) logFn(`Cron "${job.name}" execution failed: ${error.message}`);
     }

package/lib/daemon.js

@@ -27,6 +27,7 @@ import { checkAndRunDueJobs } from './cron.js';
 import { runHeartbeatChecks } from './heartbeat.js';
 import { getAgentVersions, formatAgentVersionSummary, checkAllAgentUpdates, performAgentUpdate, checkVersionParity } from './agent-versions.js';
 import { checkAllProjectsFreshness } from './project-freshness.js';
+import { getStatus as getLaunchAgentStatus, install as refreshLaunchAgent } from './launchagent.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -1514,6 +1515,295 @@ function handleCancellation(displayNumber, source) {
   });
 }
 
+// ==================== Message Injection (Phase 4) ====================
+
+const MESSAGE_POLL_INTERVAL_MS = 30000; // Check for messages every 30s
+let lastMessagePoll = 0;
+
+/**
+ * Poll for urgent messages directed to running tasks.
+ * Called from checkTimeouts() on each poll cycle.
+ *
+ * Normal messages: agent picks up via push-todo --check-messages at natural pauses.
+ * Urgent messages: daemon kills the session and respawns with --continue + injected message.
+ */
+async function checkUrgentMessages() {
+  const now = Date.now();
+  if (now - lastMessagePoll < MESSAGE_POLL_INTERVAL_MS) return;
+  lastMessagePoll = now;
+
+  if (runningTasks.size === 0) return;
+
+  for (const [displayNumber, taskInfo] of runningTasks) {
+    const info = taskDetails.get(displayNumber) || {};
+    const taskId = info.taskId;
+    if (!taskId) continue;
+
+    // Skip tasks already being cancelled or injected
+    if (info.phase === 'cancelled' || info.phase === 'injecting_message') continue;
+
+    try {
+      const params = new URLSearchParams({
+        todo_id: taskId,
+        direction: 'to_agent',
+      });
+
+      const response = await apiRequest(`task-messages?${params}`, {}, false);
+      if (!response.ok) continue;
+
+      const data = await response.json();
+      const messages = data.messages || [];
+
+      // Only process urgent messages via kill+continue
+      const urgentMessages = messages.filter(m => m.is_urgent || m.type === 'urgent');
+      if (urgentMessages.length === 0) continue;
+
+      // Combine all urgent messages into one injection
+      const combinedMessage = urgentMessages
+        .map(m => m.message)
+        .join('\n\n');
+
+      log(`Task #${displayNumber}: ${urgentMessages.length} urgent message(s) detected, initiating kill+continue`);
+
+      // Mark messages as read
+      for (const msg of urgentMessages) {
+        apiRequest('task-messages', {
+          method: 'PATCH',
+          body: JSON.stringify({ message_id: msg.id }),
+        }).catch(() => {}); // fire-and-forget
+      }
+
+      // Kill the current session and respawn with injected message
+      await injectMessageViaKillContinue(displayNumber, combinedMessage);
+    } catch (err) {
+      log(`Task #${displayNumber}: message poll failed (non-fatal): ${err.message}`);
+    }
+  }
+}
+
+/**
+ * Kill the current Claude session and respawn with --continue, injecting a human message.
+ *
+ * Flow:
+ * 1. SIGTERM the running process
+ * 2. Wait for it to exit (handleTaskCompletion sees phase='injecting_message' and skips cleanup)
+ * 3. Respawn with `claude --continue <sessionId> -p "Human sent: <message>"`
+ *
+ * The ~12s penalty is for Claude to reload context from the session transcript.
+ */
+async function injectMessageViaKillContinue(displayNumber, message) {
+  const taskInfo = runningTasks.get(displayNumber);
+  if (!taskInfo) return;
+
+  const sessionId = taskInfo.sessionId;
+  const projectPath = taskInfo.projectPath || taskProjectPaths.get(displayNumber);
+  const info = taskDetails.get(displayNumber) || {};
+  const taskId = info.taskId;
+
+  // Mark phase so handleTaskCompletion knows to respawn instead of cleaning up
+  updateTaskDetail(displayNumber, {
+    phase: 'injecting_message',
+    detail: `Injecting message: ${message.slice(0, 50)}...`
+  });
+
+  // Report the injection event to Supabase
+  apiRequest('update-task-execution', {
+    method: 'PATCH',
+    body: JSON.stringify({
+      todoId: taskId,
+      displayNumber,
+      event: {
+        type: 'message_injected',
+        timestamp: new Date().toISOString(),
+        machineName: getMachineName() || undefined,
+        summary: `Human message injected: ${message.slice(0, 100)}`,
+      }
+    })
+  }).catch(() => {});
+
+  // Store the message for respawn (handleTaskCompletion will read this)
+  taskInfo.pendingInjection = { message, sessionId, projectPath, taskId };
+
+  // Kill the current process
+  try {
+    taskInfo.process.kill('SIGTERM');
+  } catch (err) {
+    log(`Task #${displayNumber}: SIGTERM for injection failed: ${err.message}`);
+    // Reset phase if kill failed
+    updateTaskDetail(displayNumber, { phase: 'executing' });
+    delete taskInfo.pendingInjection;
+  }
+}
+
+/**
+ * Respawn a Claude session after kill, with the human message injected.
+ * Called from handleTaskCompletion when phase === 'injecting_message'.
+ */
+function respawnWithInjectedMessage(displayNumber) {
+  const taskInfo = runningTasks.get(displayNumber);
+  if (!taskInfo || !taskInfo.pendingInjection) {
+    log(`Task #${displayNumber}: no pending injection found, cannot respawn`);
+    return;
+  }
+
+  const { message, sessionId, projectPath, taskId } = taskInfo.pendingInjection;
+  delete taskInfo.pendingInjection;
+
+  const injectionPrompt = `IMPORTANT: The human sent you an urgent message while you were working:\n\n---\n${message}\n---\n\nPlease address this message and then continue with your task.`;
+
+  const allowedTools = [
+    'Read', 'Edit', 'Write', 'Glob', 'Grep',
+    'Bash(git *)',
+    'Bash(npm *)', 'Bash(npx *)', 'Bash(yarn *)',
+    'Bash(python *)', 'Bash(python3 *)', 'Bash(pip *)', 'Bash(pip3 *)',
+    'Bash(push-todo *)',
+    'Task'
+  ].join(',');
+
+  // Generate new session ID for the respawned session
+  const newSessionId = randomUUID();
+
+  const claudeArgs = [
+    '--continue', sessionId,
+    '-p', injectionPrompt,
+    '--allowedTools', allowedTools,
+    '--output-format', 'stream-json',
+    '--permission-mode', 'bypassPermissions',
+    '--session-id', newSessionId,
+  ];
+
+  log(`Task #${displayNumber}: respawning with injected message (session: ${sessionId} -> ${newSessionId})`);
+
+  try {
+    const child = spawn('claude', claudeArgs, {
+      cwd: projectPath || process.cwd(),
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: (() => {
+        const env = { ...process.env, PUSH_TASK_ID: taskId, PUSH_DISPLAY_NUMBER: String(displayNumber) };
+        delete env.CLAUDECODE;
+        delete env.CLAUDE_CODE_ENTRYPOINT;
+        return env;
+      })()
+    });
+
+    // Replace the old process info
+    taskInfo.process = child;
+    taskInfo.sessionId = newSessionId;
+    taskInfo.startTime = taskInfo.startTime; // Keep original start time
+
+    // Re-initialize stream parsing state
+    taskStreamLineBuffer.set(displayNumber, '');
+    taskActivityState.set(displayNumber, {
+      filesRead: new Set(), filesEdited: new Set(),
+      currentTool: null, lastText: '', sessionId: null
+    });
+    taskLastStreamProgress.set(displayNumber, Date.now());
+    taskLastOutput.set(displayNumber, Date.now());
+    taskStdoutBuffer.set(displayNumber, []);
+    taskStderrBuffer.set(displayNumber, []);
+    taskLastHeartbeat.set(displayNumber, Date.now());
+
+    // Re-attach stdout handler (same as executeTask)
+    child.stdout.on('data', (data) => {
+      taskLastOutput.set(displayNumber, Date.now());
+
+      const pending = (taskStreamLineBuffer.get(displayNumber) || '') + data.toString();
+      const lines = pending.split('\n');
+      taskStreamLineBuffer.set(displayNumber, lines.pop() || '');
+
+      for (const line of lines) {
+        if (!line.trim()) continue;
+
+        const buffer = taskStdoutBuffer.get(displayNumber) || [];
+        buffer.push(line);
+        if (buffer.length > 50) buffer.shift();
+        taskStdoutBuffer.set(displayNumber, buffer);
+
+        const event = parseStreamJsonLine(line);
+        if (event) {
+          processStreamEvent(displayNumber, event);
+        } else {
+          if (line.includes('[push-confirm] Waiting for')) {
+            updateTaskDetail(displayNumber, {
+              phase: 'awaiting_confirmation',
+              detail: 'Waiting for user confirmation on iPhone'
+            });
+          }
+          const stuckReason = checkStuckPatterns(displayNumber, line);
+          if (stuckReason) {
+            log(`Task #${displayNumber} may be stuck: ${stuckReason}`);
+            updateTaskDetail(displayNumber, { phase: 'stuck', detail: `Waiting for input: ${stuckReason}` });
+          }
+        }
+      }
+    });
+
+    child.stderr.on('data', (data) => {
+      const lines = data.toString().split('\n');
+      for (const line of lines) {
+        if (line.trim()) {
+          const buffer = taskStderrBuffer.get(displayNumber) || [];
+          buffer.push(line);
+          if (buffer.length > 20) buffer.shift();
+          taskStderrBuffer.set(displayNumber, buffer);
+        }
+      }
+    });
+
+    child.on('close', (code) => {
+      handleTaskCompletion(displayNumber, code);
+    });
+
+    child.on('error', async (error) => {
+      logError(`Task #${displayNumber} respawn error: ${error.message}`);
+      runningTasks.delete(displayNumber);
+      await updateTaskStatus(displayNumber, 'failed', { error: `Respawn failed: ${error.message}` }, taskId);
+      taskDetails.delete(displayNumber);
+      taskLastHeartbeat.delete(displayNumber);
+      taskStreamLineBuffer.delete(displayNumber);
+      taskActivityState.delete(displayNumber);
+      taskLastStreamProgress.delete(displayNumber);
+      updateStatusFile();
+    });
+
+    updateTaskDetail(displayNumber, {
+      phase: 'executing',
+      detail: 'Resumed with injected message',
+      claudePid: child.pid
+    });
+
+    // Update session ID in Supabase
+    apiRequest('update-task-execution', {
+      method: 'PATCH',
+      body: JSON.stringify({
+        todoId: taskId,
+        displayNumber,
+        sessionId: newSessionId,
+        event: {
+          type: 'progress',
+          timestamp: new Date().toISOString(),
+          machineName: getMachineName() || undefined,
+          summary: `Respawned with injected human message (new session: ${newSessionId.slice(0, 8)})`,
+        }
+      })
+    }).catch(() => {});
+
+    log(`Task #${displayNumber}: respawned successfully (PID: ${child.pid})`);
+  } catch (error) {
+    logError(`Task #${displayNumber}: respawn failed: ${error.message}`);
+    // Clean up — task is effectively dead
+    runningTasks.delete(displayNumber);
+    updateTaskStatus(displayNumber, 'failed', {
+      error: `Message injection respawn failed: ${error.message}`
+    }, taskId).catch(() => {});
+    taskDetails.delete(displayNumber);
+    taskStreamLineBuffer.delete(displayNumber);
+    taskActivityState.delete(displayNumber);
+    taskLastStreamProgress.delete(displayNumber);
+    updateStatusFile();
+  }
+}
+
 function monitorTaskStdout(displayNumber, proc) {
   if (!proc.stdout) return;
 
@@ -2188,10 +2478,19 @@ async function handleTaskCompletion(displayNumber, exitCode) {
   const taskInfo = runningTasks.get(displayNumber);
   if (!taskInfo) return;
 
+  const info = taskDetails.get(displayNumber) || {};
+
+  // Message injection: process was killed to inject a human message.
+  // Don't clean up — respawn with --continue instead.
+  if (info.phase === 'injecting_message' && taskInfo.pendingInjection) {
+    log(`Task #${displayNumber}: process exited for message injection (code ${exitCode}), respawning...`);
+    respawnWithInjectedMessage(displayNumber);
+    return;
+  }
+
   runningTasks.delete(displayNumber);
 
   const duration = Math.floor((Date.now() - taskInfo.startTime) / 1000);
-  const info = taskDetails.get(displayNumber) || {};
   const summary = info.summary || 'Unknown task';
   const projectPath = taskProjectPaths.get(displayNumber);
 
@@ -2502,6 +2801,13 @@ async function checkTimeouts() {
   // Level A: Send progress heartbeats for long-running tasks
   await sendProgressHeartbeats();
 
+  // Phase 4: Check for urgent human messages to inject into running tasks
+  try {
+    await checkUrgentMessages();
+  } catch (error) {
+    logError(`Urgent message check failed (non-fatal): ${error.message}`);
+  }
+
   // Level B: Kill tasks that have been idle too long (fires at 15 min, before 60 min absolute)
   await killIdleTasks();
 
@@ -2613,7 +2919,16 @@ function checkAndApplyUpdate() {
     if (success) {
       log(`Update to v${pendingUpdateVersion} successful. Restarting daemon...`);
 
-      // Spawn new daemon from updated code, then exit
+      // If LaunchAgent is installed, refresh plist (paths may have changed)
+      // and let launchd handle the restart instead of spawning manually
+      const laStatus = getLaunchAgentStatus();
+      if (laStatus.installed && laStatus.loaded) {
+        refreshLaunchAgent(); // Update plist with current node/daemon paths
+        log('LaunchAgent installed — letting launchd restart daemon.');
+        process.exit(0);
+      }
+
+      // No LaunchAgent — spawn new daemon manually, then exit
       const daemonScript = join(__dirname, 'daemon.js');
       const selfUpdateEnv = { ...process.env, PUSH_DAEMON: '1' };
       delete selfUpdateEnv.CLAUDECODE;  // Strip to avoid leaking into Claude child processes
@@ -2684,6 +2999,127 @@ function logVersionParityWarnings() {
   }
 }
 
+// ==================== Health Check (Phase 5) ====================
+
+/**
+ * Spawn a health check Claude session for a project.
+ * Called by the cron module when a health-check job fires.
+ *
+ * The session runs in the project directory with a special prompt that asks
+ * Claude to review the codebase and suggest tasks. Results are created as
+ * draft todos via the create-todo API.
+ *
+ * @param {Object} job - Cron job object
+ * @param {Function} logFn - Log function
+ */
+async function spawnHealthCheck(job, logFn) {
+  const projectPath = job.action.projectPath;
+  if (!projectPath || !existsSync(projectPath)) {
+    logFn(`Health check: project path not found: ${projectPath}`);
+    return;
+  }
+
+  // Don't run if task slots are full
+  if (runningTasks.size >= MAX_CONCURRENT_TASKS) {
+    logFn(`Health check: all ${MAX_CONCURRENT_TASKS} slots in use, deferring`);
+    return;
+  }
+
+  const scope = job.action.scope || 'general';
+  const customPrompt = job.action.prompt || '';
+
+  const healthPrompts = {
+    general: `Review this codebase briefly. Check for:
+1. Failing tests (run the test suite if one exists)
+2. Obvious bugs or issues in recently modified files (last 7 days)
+3. Outdated dependencies worth updating
+
+For each issue found, create a todo using: push-todo create "<clear description of the issue>"
+Only create todos for real, actionable issues — not style preferences or minor improvements.
+If everything looks good, just say "No issues found" and don't create any todos.`,
+    tests: `Run the test suite for this project. If any tests fail, create a todo for each failure:
+push-todo create "Fix failing test: <test name> - <brief reason>"
+If all tests pass, say "All tests pass" and don't create any todos.`,
+    dependencies: `Check for outdated dependencies in this project. Only flag dependencies with:
+- Known security vulnerabilities
+- Major version bumps (not minor/patch)
+For each, create a todo: push-todo create "Update <dep> from <old> to <new> (<reason>)"
+If dependencies are current, say "All dependencies up to date."`,
+  };
+
+  const prompt = customPrompt || healthPrompts[scope] || healthPrompts.general;
+
+  const allowedTools = [
+    'Read', 'Glob', 'Grep',
+    'Bash(git *)',
+    'Bash(npm *)', 'Bash(npx *)',
+    'Bash(python *)', 'Bash(python3 *)',
+    'Bash(push-todo create *)',
+  ].join(',');
+
+  const claudeArgs = [
+    '-p', prompt,
+    '--allowedTools', allowedTools,
+    '--output-format', 'stream-json',
+    '--permission-mode', 'bypassPermissions',
+  ];
+
+  logFn(`Health check "${job.name}": spawning Claude in ${projectPath} (scope: ${scope})`);
+
+  try {
+    const child = spawn('claude', claudeArgs, {
+      cwd: projectPath,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: (() => {
+        const env = { ...process.env };
+        delete env.CLAUDECODE;
+        delete env.CLAUDE_CODE_ENTRYPOINT;
+        return env;
+      })(),
+      timeout: 300000, // 5 min max for health checks
+    });
+
+    // Simple output tracking — health checks are lightweight, no full task tracking
+    let output = '';
+    child.stdout.on('data', (data) => {
+      output += data.toString();
+    });
+
+    child.stderr.on('data', (data) => {
+      const errLine = data.toString().trim();
+      if (errLine) logFn(`Health check "${job.name}" stderr: ${errLine}`);
+    });
+
+    await new Promise((resolve) => {
+      child.on('close', (code) => {
+        if (code === 0) {
+          logFn(`Health check "${job.name}": completed successfully`);
+        } else {
+          logFn(`Health check "${job.name}": exited with code ${code}`);
+        }
+        resolve();
+      });
+      child.on('error', (err) => {
+        logFn(`Health check "${job.name}": spawn error: ${err.message}`);
+        resolve();
+      });
+    });
+
+    // Extract any text summary from stream-json output
+    const lines = output.split('\n').filter(l => l.trim());
+    for (const line of lines) {
+      try {
+        const event = JSON.parse(line);
+        if (event.type === 'result' && event.result) {
+          logFn(`Health check "${job.name}" result: ${event.result.slice(0, 200)}`);
+        }
+      } catch { /* ignore non-JSON lines */ }
+    }
+  } catch (error) {
+    logFn(`Health check "${job.name}": error: ${error.message}`);
+  }
+}
+
 // ==================== Main Loop ====================
 
 async function pollAndExecute() {
@@ -2845,7 +3281,7 @@ async function mainLoop() {
 
       // Cron jobs (check every poll cycle, execution throttled by nextRunAt)
       try {
-        await checkAndRunDueJobs(log);
+        await checkAndRunDueJobs(log, { apiRequest, spawnHealthCheck });
       } catch (error) {
         logError(`Cron check error: ${error.message}`);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masslessai/push-todo",
-  "version": "4.1.9",
+  "version": "4.2.1",
   "description": "Voice tasks from Push iOS app for Claude Code",
   "type": "module",
   "bin": {

package/scripts/postinstall.js

@@ -407,11 +407,11 @@ async function main() {
     }
     console.log('');
     console.log('[push-todo] Quick start:');
-    console.log('[push-todo]   push-todo connect     Set up authentication');
-    console.log('[push-todo]   push-todo             List your tasks');
-    if (claudeSuccess) console.log('[push-todo]   /push-todo            Use in Claude Code');
-    if (codexSuccess) console.log('[push-todo]   $push-todo            Use in OpenAI Codex');
-    if (openclawSuccess) console.log('[push-todo]   /push-todo            Use in OpenClaw');
+    console.log('[push-todo]   push-todo connect --auto   One-command setup (auth + projects + daemon)');
+    console.log('[push-todo]   push-todo                  List your tasks');
+    if (claudeSuccess) console.log('[push-todo]   /push-todo                Use in Claude Code');
+    if (codexSuccess) console.log('[push-todo]   $push-todo                Use in OpenAI Codex');
+    if (openclawSuccess) console.log('[push-todo]   /push-todo                Use in OpenClaw');
     return;
   }
 
@@ -440,16 +440,16 @@ async function main() {
   }
   console.log('');
   console.log('[push-todo] Quick start:');
-  console.log('[push-todo]   push-todo connect     Set up authentication');
-  console.log('[push-todo]   push-todo             List your tasks');
+  console.log('[push-todo]   push-todo connect --auto   One-command setup (auth + projects + daemon)');
+  console.log('[push-todo]   push-todo                  List your tasks');
   if (claudeSuccess) {
-    console.log('[push-todo]   /push-todo            Use in Claude Code');
+    console.log('[push-todo]   /push-todo                Use in Claude Code');
   }
   if (codexSuccess) {
-    console.log('[push-todo]   $push-todo            Use in OpenAI Codex');
+    console.log('[push-todo]   $push-todo                Use in OpenAI Codex');
   }
   if (openclawSuccess) {
-    console.log('[push-todo]   /push-todo            Use in OpenClaw');
+    console.log('[push-todo]   /push-todo                Use in OpenClaw');
   }
 }