@masslessai/push-todo 4.2.0 → 4.2.2

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
@@ -155,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' },
@@ -254,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;
   }
 
@@ -281,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);
@@ -289,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(`

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);
@@ -2918,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

package/lib/launchagent.js

@@ -0,0 +1,200 @@
+/**
+ * LaunchAgent management for Push daemon.
+ *
+ * Installs/uninstalls a user-level LaunchAgent plist that keeps the
+ * Push daemon running across reboots and logins. User-level LaunchAgents
+ * do NOT require sudo — they live in ~/Library/LaunchAgents/.
+ *
+ * This supplements (not replaces) the self-healing ensureDaemonRunning()
+ * pattern. LaunchAgent ensures startup; self-healing handles edge cases.
+ *
+ * Historical context:
+ * - Happy Engineering rejected LaunchAgent citing sudo friction (wrong —
+ *   user-level LaunchAgents don't need sudo)
+ * - OpenClaw proved zero-friction adoption with LaunchAgent at scale
+ * - See: docs/20260127_parallel_task_execution_research.md §9.9
+ *
+ * Architecture: docs/20260224_openclaw_autonomous_layer_research_and_push_integration_plan.md §Phase 6
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';
+import { execFileSync } from 'child_process';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const LABEL = 'ai.massless.push.daemon';
+const LAUNCH_AGENTS_DIR = join(homedir(), 'Library', 'LaunchAgents');
+const PLIST_PATH = join(LAUNCH_AGENTS_DIR, `${LABEL}.plist`);
+const PUSH_DIR = join(homedir(), '.push');
+const LOG_FILE = join(PUSH_DIR, 'daemon.log');
+
+/**
+ * Find the node binary used by push-todo.
+ */
+function findNodeBinary() {
+  try {
+    const path = execFileSync('which', ['node'], { encoding: 'utf8', timeout: 5000 }).trim();
+    if (path && existsSync(path)) return path;
+  } catch {}
+  return process.execPath;
+}
+
+/**
+ * Generate the plist XML content.
+ */
+function generatePlist() {
+  const nodeBin = findNodeBinary();
+  const daemonScript = join(__dirname, 'daemon.js');
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${LABEL}</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>${nodeBin}</string>
+        <string>${daemonScript}</string>
+    </array>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PUSH_DAEMON</key>
+        <string>1</string>
+        <key>PATH</key>
+        <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:${dirname(nodeBin)}</string>
+    </dict>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <true/>
+
+    <key>ThrottleInterval</key>
+    <integer>30</integer>
+
+    <key>StandardOutPath</key>
+    <string>${LOG_FILE}</string>
+
+    <key>StandardErrorPath</key>
+    <string>${LOG_FILE}</string>
+
+    <key>WorkingDirectory</key>
+    <string>${homedir()}</string>
+</dict>
+</plist>
+`;
+}
+
+/**
+ * Check if the LaunchAgent is installed.
+ * @returns {{ installed: boolean, loaded: boolean, plistPath: string }}
+ */
+export function getStatus() {
+  const installed = existsSync(PLIST_PATH);
+  let loaded = false;
+
+  if (installed) {
+    try {
+      const output = execFileSync('launchctl', ['list', LABEL], {
+        encoding: 'utf8',
+        timeout: 5000,
+      });
+      loaded = !output.includes('Could not find service');
+    } catch {
+      loaded = false;
+    }
+  }
+
+  return { installed, loaded, plistPath: PLIST_PATH };
+}
+
+/**
+ * Install the LaunchAgent plist and load it.
+ *
+ * Safe to call multiple times — updates existing plist if daemon script
+ * path has changed (e.g., after npm update).
+ *
+ * @returns {{ success: boolean, message: string, alreadyInstalled?: boolean }}
+ */
+export function install() {
+  try {
+    // Ensure directories exist
+    mkdirSync(LAUNCH_AGENTS_DIR, { recursive: true });
+    mkdirSync(PUSH_DIR, { recursive: true });
+
+    // Check if already installed with same content
+    const newContent = generatePlist();
+    if (existsSync(PLIST_PATH)) {
+      const existing = readFileSync(PLIST_PATH, 'utf8');
+      if (existing === newContent) {
+        // Ensure loaded
+        try {
+          execFileSync('launchctl', ['load', '-w', PLIST_PATH], {
+            encoding: 'utf8',
+            timeout: 5000,
+          });
+        } catch {}
+        return { success: true, message: 'LaunchAgent already installed', alreadyInstalled: true };
+      }
+
+      // Content changed (e.g., node path updated) — unload old, write new
+      try {
+        execFileSync('launchctl', ['unload', PLIST_PATH], {
+          encoding: 'utf8',
+          timeout: 5000,
+        });
+      } catch {}
+    }
+
+    // Write plist
+    writeFileSync(PLIST_PATH, newContent);
+
+    // Load it
+    execFileSync('launchctl', ['load', '-w', PLIST_PATH], {
+      encoding: 'utf8',
+      timeout: 5000,
+    });
+
+    return { success: true, message: 'LaunchAgent installed and loaded' };
+  } catch (error) {
+    return { success: false, message: `Failed to install LaunchAgent: ${error.message}` };
+  }
+}
+
+/**
+ * Uninstall the LaunchAgent — unload and remove plist.
+ *
+ * @returns {{ success: boolean, message: string }}
+ */
+export function uninstall() {
+  try {
+    if (!existsSync(PLIST_PATH)) {
+      return { success: true, message: 'LaunchAgent not installed (nothing to remove)' };
+    }
+
+    // Unload
+    try {
+      execFileSync('launchctl', ['unload', PLIST_PATH], {
+        encoding: 'utf8',
+        timeout: 5000,
+      });
+    } catch {}
+
+    // Remove plist
+    unlinkSync(PLIST_PATH);
+
+    return { success: true, message: 'LaunchAgent uninstalled' };
+  } catch (error) {
+    return { success: false, message: `Failed to uninstall LaunchAgent: ${error.message}` };
+  }
+}
+
+export { PLIST_PATH, LABEL };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masslessai/push-todo",
-  "version": "4.2.0",
+  "version": "4.2.2",
   "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');
   }
 }