devchain-cli 0.2.1 → 0.3.1

package/README.md

@@ -2,6 +2,8 @@
 
 AI driven development platform
 
+**[Homepage](https://devchain.twitechlab.com/)** · **[GitHub](https://github.com/twitech-lab/devchain)**
+
 Devchain coordinates AI coding agents (Claude, Codex) through a visual workflow interface with tmux-backed terminal sessions.
 
 ## Features

package/dist/cli.js

@@ -52,6 +52,113 @@ async function fetchWithTimeout(url, options = {}, timeoutMs = 2000) {
   }
 }
 
+function isNewerVersion(latest, current) {
+  const l = latest.split('.').map(Number);
+  const c = current.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] || 0) > (c[i] || 0)) return true;
+    if ((l[i] || 0) < (c[i] || 0)) return false;
+  }
+  return false;
+}
+
+function getChangelogBetweenVersions(changelog, fromVersion, toVersion) {
+  if (!changelog || typeof changelog !== 'object') return [];
+
+  const changes = [];
+  const versions = Object.keys(changelog).sort((a, b) => {
+    // Sort versions descending
+    const aParts = a.split('.').map(Number);
+    const bParts = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+      if ((bParts[i] || 0) !== (aParts[i] || 0)) {
+        return (bParts[i] || 0) - (aParts[i] || 0);
+      }
+    }
+    return 0;
+  });
+
+  for (const version of versions) {
+    if (isNewerVersion(version, fromVersion) && !isNewerVersion(version, toVersion)) {
+      // Include this version's changes
+      if (Array.isArray(changelog[version])) {
+        changes.push({ version, items: changelog[version] });
+      }
+    }
+    // Also include the target version itself
+    if (version === toVersion && Array.isArray(changelog[version])) {
+      if (!changes.find(c => c.version === version)) {
+        changes.unshift({ version, items: changelog[version] });
+      }
+    }
+  }
+
+  return changes;
+}
+
+async function checkForUpdates(cli, askYesNoFn) {
+  try {
+    const pkg = require('../package.json');
+    const currentVersion = pkg.version;
+    const packageName = pkg.name;
+
+    // Fetch latest package info from npm registry (with short timeout)
+    const res = await fetchWithTimeout(`https://registry.npmjs.org/${packageName}/latest`, {}, 3000);
+    if (!res.ok) return;
+
+    const data = await res.json();
+    const latestVersion = data.version;
+
+    if (latestVersion !== currentVersion && isNewerVersion(latestVersion, currentVersion)) {
+      cli.blank();
+      cli.warn(`A new version of devchain is available: ${currentVersion} → ${latestVersion}`);
+
+      // Show changelog if available
+      const changelog = data.changelog;
+      const changes = getChangelogBetweenVersions(changelog, currentVersion, latestVersion);
+      if (changes.length > 0) {
+        cli.blank();
+        cli.info("What's new:");
+        for (const { version, items } of changes) {
+          for (const item of items) {
+            console.log(`  • ${item}`);
+          }
+        }
+      }
+      cli.blank();
+
+      const shouldUpdate = await askYesNoFn('Would you like to update now?', true);
+
+      if (shouldUpdate) {
+        cli.info('Updating devchain...');
+        try {
+          // Try without sudo first (works for nvm/fnm/Windows)
+          execSync(`npm update -g ${packageName}`, { stdio: 'inherit' });
+          cli.success('Update complete! Please restart devchain.');
+          process.exit(0);
+        } catch (e) {
+          // On Linux/Mac, might need sudo for system npm
+          if (platform() !== 'win32') {
+            cli.info('Retrying with sudo...');
+            try {
+              execSync(`sudo npm update -g ${packageName}`, { stdio: 'inherit' });
+              cli.success('Update complete! Please restart devchain.');
+              process.exit(0);
+            } catch (e2) {
+              cli.error('Update failed. You can manually run: sudo npm update -g ' + packageName);
+            }
+          } else {
+            cli.error('Update failed. You can manually run: npm update -g ' + packageName);
+          }
+        }
+      }
+      cli.blank();
+    }
+  } catch (e) {
+    // Silently ignore - don't block startup for update check failures
+  }
+}
+
 function isBinaryInstalled(cmd) {
   try {
     const out = execSync(`which ${cmd}`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] })
@@ -218,15 +325,32 @@ async function validateMcpForProviders(baseUrl, cli, opts, log, projectPath) {
   }
 }
 
-function askYesNo(question) {
+function askYesNo(question, defaultYes = false) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout,
     });
-    rl.question(`${question} [y/N] `, (answer) => {
+    const prompt = defaultYes ? `${question} [Y/n] ` : `${question} [y/N] `;
+    let answered = false;
+
+    // Handle Ctrl+D (EOF) - user wants to cancel/exit
+    rl.on('close', () => {
+      if (!answered) {
+        console.log(); // Print newline since Ctrl+D doesn't
+        process.exit(0);
+      }
+    });
+
+    rl.question(prompt, (answer) => {
+      answered = true;
       rl.close();
-      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+      const trimmed = answer.trim().toLowerCase();
+      if (trimmed === '') {
+        resolve(defaultYes);
+      } else {
+        resolve(trimmed === 'y' || trimmed === 'yes');
+      }
     });
   });
 }
@@ -258,7 +382,8 @@ async function ensureClaudeBypassPermissions(cli) {
   cli.info('Claude requires permission approval for each command by default.');
   cli.info('Enabling bypass mode allows devchain to auto-approve commands.');
 
-  const confirmed = await askYesNo('Enable bypass permissions mode for Claude?');
+  const confirmed = await askYesNo('Enable bypass permissions mode for Claude?', true);
+  cli.blank();
 
   if (confirmed) {
     config.bypassPermissionsModeAccepted = true;
@@ -444,45 +569,34 @@ async function main(argv) {
         startCommand.help();
         return;
       }
+
+      // Check if already running (skip for detached child - parent already checked)
+      if (!opts.internalDetachedChild) {
+        const existingPid = readPidFile();
+        if (existingPid && isProcessRunning(existingPid.pid)) {
+          console.error(`Devchain is already running (PID ${existingPid.pid}, port ${existingPid.port})`);
+          console.error(`Access it at: http://127.0.0.1:${existingPid.port}`);
+          console.error('Use "devchain stop" to stop it first.');
+          process.exit(1);
+        }
+        // Clean up stale PID file if process is not running
+        if (existingPid && !isProcessRunning(existingPid.pid)) {
+          removePidFile();
+        }
+      }
+
       // Normalize defaults for negatable options (Commander may leave undefined)
       if (typeof opts.open === 'undefined') {
         opts.open = true;
       }
       // Detached mode by default, unless foreground is explicitly requested
       // Don't detach again if we're already the detached child process
-      const shouldDetach = opts.foreground !== true && !opts.internalDetachedChild;
-
-      // If detached mode, respawn as a background process
-      if (shouldDetach) {
-        const args = process.argv.slice(2).filter(arg => arg !== '-d' && arg !== '--detach');
-        // Add internal flag to prevent infinite respawning
-        args.push('--internal-detached-child');
-
-        // Create log file for detached process output
-        const devchainDir = join(homedir(), '.devchain');
-        if (!existsSync(devchainDir)) {
-          mkdirSync(devchainDir, { recursive: true });
-        }
-        const logFile = join(devchainDir, 'devchain.log');
-        const out = openSync(logFile, 'a');
-        const err = openSync(logFile, 'a');
-
-        const child = spawn(process.execPath, [__filename, ...args], {
-          detached: true,
-          stdio: ['ignore', out, err],
-        });
-
-        child.unref();
-
-        console.log(`Devchain is starting in background (PID ${child.pid})...`);
-        console.log(`Log file: ${logFile}`);
-        console.log('Use "devchain stop" to stop it.');
-        process.exit(0);
-      }
+      const isDetachedChild = opts.internalDetachedChild;
+      const shouldDetach = opts.foreground !== true && !isDetachedChild;
 
       // Initialize interactive CLI (user-friendly output unless in foreground mode)
       const cli = new InteractiveCLI({
-        interactive: !opts.foreground,
+        interactive: !opts.foreground && !isDetachedChild,
         colors: true,
         spinners: true
       });
@@ -492,6 +606,11 @@ async function main(argv) {
         console.log(JSON.stringify(entry));
       };
 
+      // Check for updates (parent process only, skip in dev mode)
+      if (!isDetachedChild && !opts.dev) {
+        await checkForUpdates(cli, askYesNo);
+      }
+
       // Show startup banner (interactive mode only)
       if (!opts.foreground) {
         cli.blank();
@@ -612,9 +731,53 @@ async function main(argv) {
         }
       }
 
+      // Prompt for Claude bypass permissions (parent only - requires stdin)
+      // This runs BEFORE detach since it needs user interaction
+      if (!isDetachedChild && opts.__providersDetected && opts.__providersDetected.has('claude')) {
+        await ensureClaudeBypassPermissions(cli);
+      }
+
       const preferPort = opts.port ? Number(opts.port) : 3000;
       const port = await getPort({ port: preferPort });
 
+      // === DETACH POINT ===
+      // All interactive prompts are done. Now spawn the detached child if needed.
+      if (shouldDetach) {
+        // Build child args, passing the selected port
+        const childArgs = process.argv.slice(2)
+          .filter(arg => arg !== '-d' && arg !== '--detach')
+          .filter((arg, i, arr) => {
+            // Remove existing --port and its value
+            if (arg === '--port' || arg === '-p') return false;
+            if (i > 0 && (arr[i - 1] === '--port' || arr[i - 1] === '-p')) return false;
+            return true;
+          });
+        childArgs.push('--internal-detached-child');
+        childArgs.push('--port', String(port));
+
+        // Create log file for detached process output
+        const devchainDir = join(homedir(), '.devchain');
+        if (!existsSync(devchainDir)) {
+          mkdirSync(devchainDir, { recursive: true });
+        }
+        const logFile = join(devchainDir, 'devchain.log');
+        const out = openSync(logFile, 'a');
+        const err = openSync(logFile, 'a');
+
+        const child = spawn(process.execPath, [__filename, ...childArgs], {
+          detached: true,
+          stdio: ['ignore', out, err],
+        });
+
+        child.unref();
+
+        cli.blank();
+        cli.success(`Devchain starting in background (PID ${child.pid})`);
+        cli.info(`Log file: ${logFile}`);
+        cli.info('Use "devchain stop" to stop it.');
+        process.exit(0);
+      }
+
       // Apply env before requiring the server
       process.env.PORT = String(port);
       process.env.HOST = process.env.HOST || '127.0.0.1';
@@ -697,10 +860,7 @@ async function main(argv) {
         // Validate MCP for all providers
         await validateMcpForProviders(baseUrl, cli, opts, log, startupPath);
 
-        // Prompt for Claude bypass permissions
-        if (opts.__providersDetected && opts.__providersDetected.has('claude')) {
-          await ensureClaudeBypassPermissions(cli);
-        }
+        // Note: Claude bypass prompt already handled before server start
 
         cli.blank();
         cli.info('Starting UI (dev mode)...');
@@ -798,10 +958,7 @@ async function main(argv) {
       // Validate MCP for all providers (with project context)
       await validateMcpForProviders(baseUrl, cli, opts, log, startupPath);
 
-      // Prompt for Claude bypass permissions (if Claude provider detected)
-      if (opts.__providersDetected && opts.__providersDetected.has('claude')) {
-        await ensureClaudeBypassPermissions(cli);
-      }
+      // Note: Claude bypass prompt already handled before server start (in parent process for detach mode)
 
       // Determine URL to open based on project path
       let urlToOpen = baseUrl;

package/dist/drizzle/0018_whole_zodiak.sql

@@ -0,0 +1,43 @@
+CREATE TABLE `automation_subscribers` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`name` text NOT NULL,
+	`description` text,
+	`enabled` integer DEFAULT true NOT NULL,
+	`event_name` text NOT NULL,
+	`event_filter` text,
+	`action_type` text NOT NULL,
+	`action_inputs` text NOT NULL,
+	`delay_ms` integer DEFAULT 0 NOT NULL,
+	`cooldown_ms` integer DEFAULT 5000 NOT NULL,
+	`retry_on_error` integer DEFAULT false NOT NULL,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `automation_subscribers_project_id_idx` ON `automation_subscribers` (`project_id`);--> statement-breakpoint
+CREATE INDEX `automation_subscribers_event_name_idx` ON `automation_subscribers` (`event_name`);--> statement-breakpoint
+CREATE INDEX `automation_subscribers_enabled_idx` ON `automation_subscribers` (`enabled`);--> statement-breakpoint
+CREATE TABLE `terminal_watchers` (
+	`id` text PRIMARY KEY NOT NULL,
+	`project_id` text NOT NULL,
+	`name` text NOT NULL,
+	`description` text,
+	`enabled` integer DEFAULT true NOT NULL,
+	`scope` text DEFAULT 'all' NOT NULL,
+	`scope_filter_id` text,
+	`poll_interval_ms` integer DEFAULT 5000 NOT NULL,
+	`viewport_lines` integer DEFAULT 50 NOT NULL,
+	`condition` text NOT NULL,
+	`cooldown_ms` integer DEFAULT 60000 NOT NULL,
+	`cooldown_mode` text DEFAULT 'time' NOT NULL,
+	`event_name` text NOT NULL,
+	`created_at` text NOT NULL,
+	`updated_at` text NOT NULL,
+	FOREIGN KEY (`project_id`) REFERENCES `projects`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `terminal_watchers_project_id_idx` ON `terminal_watchers` (`project_id`);--> statement-breakpoint
+CREATE INDEX `terminal_watchers_enabled_idx` ON `terminal_watchers` (`enabled`);--> statement-breakpoint
+CREATE UNIQUE INDEX `terminal_watchers_event_name_unique` ON `terminal_watchers` (`project_id`,`event_name`);

package/dist/drizzle/0019_flat_avengers.sql

@@ -0,0 +1,3 @@
+ALTER TABLE `automation_subscribers` ADD `group_name` text;--> statement-breakpoint
+ALTER TABLE `automation_subscribers` ADD `position` integer DEFAULT 0 NOT NULL;--> statement-breakpoint
+ALTER TABLE `automation_subscribers` ADD `priority` integer DEFAULT 0 NOT NULL;

package/dist/drizzle/0020_statuses_mcp_hidden.sql

@@ -0,0 +1 @@
+ALTER TABLE `statuses` ADD `mcp_hidden` integer DEFAULT 0 NOT NULL;