@sylphx/flow 3.12.1 → 3.13.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @sylphx/flow
 
+## 3.13.0 (2026-02-04)
+
+### ✨ Features
+
+- **auto-upgrade:** add periodic background update check every 30 minutes ([4a14414](https://github.com/SylphxAI/flow/commit/4a14414350f31899a5dadaf596216c53406f7ffc))
+
 ## 3.12.1 (2026-02-04)
 
 ### 🐛 Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "3.12.1",
+	"version": "3.13.0",
 	"description": "One CLI to rule them all. Unified orchestration layer for AI coding assistants. Auto-detection, auto-installation, auto-upgrade.",
 	"type": "module",
 	"bin": {

package/src/commands/flow/execute-v2.ts

@@ -242,6 +242,9 @@ export async function executeFlowV2(
   const autoUpgrade = new AutoUpgrade(projectPath);
   const upgradeResult = await autoUpgrade.runAutoUpgrade(selectedTargetId);
 
+  // Start periodic background checks (every 30 minutes)
+  autoUpgrade.startPeriodicCheck(selectedTargetId);
+
   // Show upgrade notice (minimal - only if upgraded)
   if (upgradeResult.flowUpgraded && upgradeResult.flowVersion) {
     console.log(chalk.dim(`↑ flow ${upgradeResult.flowVersion.latest}`));

package/src/services/auto-upgrade.ts

@@ -43,10 +43,14 @@ export interface AutoUpgradeOptions {
   skipTarget?: boolean;
 }
 
+// Default interval: 30 minutes
+const DEFAULT_CHECK_INTERVAL_MS = 30 * 60 * 1000;
+
 export class AutoUpgrade {
   private projectPath: string;
   private options: AutoUpgradeOptions;
   private targetInstaller: TargetInstaller;
+  private periodicCheckInterval: NodeJS.Timeout | null = null;
 
   constructor(projectPath: string = process.cwd(), options: AutoUpgradeOptions = {}) {
     this.projectPath = projectPath;
@@ -396,4 +400,64 @@ export class AutoUpgrade {
       return false;
     }
   }
+
+  /**
+   * Start periodic background checks for updates
+   * Runs every intervalMs (default 30 minutes)
+   * Silently upgrades if updates are available
+   * @param targetId - Optional target CLI ID to check
+   * @param intervalMs - Check interval in milliseconds (default 30 minutes)
+   */
+  startPeriodicCheck(targetId?: string, intervalMs: number = DEFAULT_CHECK_INTERVAL_MS): void {
+    // Clear any existing interval
+    this.stopPeriodicCheck();
+
+    // Start periodic check
+    this.periodicCheckInterval = setInterval(() => {
+      this.performPeriodicUpgrade(targetId).catch(() => {
+        // Silent fail
+      });
+    }, intervalMs);
+
+    // Don't prevent process from exiting
+    this.periodicCheckInterval.unref();
+  }
+
+  /**
+   * Stop periodic background checks
+   */
+  stopPeriodicCheck(): void {
+    if (this.periodicCheckInterval) {
+      clearInterval(this.periodicCheckInterval);
+      this.periodicCheckInterval = null;
+    }
+  }
+
+  /**
+   * Perform periodic upgrade check and silent upgrade
+   */
+  private async performPeriodicUpgrade(targetId?: string): Promise<void> {
+    // Perform background check first (updates version info)
+    await this.performBackgroundCheck(targetId);
+
+    // Read the fresh version info
+    const info = await this.readVersionInfo();
+    if (!info) return;
+
+    const currentVersion = await this.getCurrentFlowVersion();
+
+    // Silently upgrade Flow if needed
+    if (info.flowLatest && info.flowLatest !== currentVersion) {
+      await this.upgradeFlowSilent();
+    }
+
+    // Silently upgrade target if needed
+    if (targetId && info.targetLatest?.[targetId] && info.targetCurrent?.[targetId]) {
+      const current = info.targetCurrent[targetId];
+      const latest = info.targetLatest[targetId];
+      if (current !== latest) {
+        await this.upgradeTargetSilent(targetId);
+      }
+    }
+  }
 }