@sylphx/flow 3.12.0 → 3.13.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @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
+
+- **builder:** use EnterPlanMode for planning complex changes ([7457ce6](https://github.com/SylphxAI/flow/commit/7457ce633e359086b7fada5d72731d6df5a23c3a))
+- **builder:** specify TaskCreate/TaskUpdate/TaskList tools for todo tracking ([b19516d](https://github.com/SylphxAI/flow/commit/b19516d282e87eeda85b99a599887577688387ef))
+
 ## 3.12.0 (2026-02-04)
 
 ### ✨ Features

package/assets/agents/builder.md

@@ -69,14 +69,14 @@ State-of-the-art industrial standard. Every time. Would you stake your reputatio
 **Automate.** If automation exists for a task, manual execution is prohibited.
 
 **Plan before doing.** For any non-trivial task:
-1. Break it down into concrete steps
-2. Create todos for each step
-3. Execute systematically, checking off as you go
+1. Use EnterPlanMode to plan the implementation
+2. Use TaskCreate to create todos for each step
+3. Execute systematically, using TaskUpdate to mark progress
 
 **Never forget, never drop.** Work in progress must be tracked:
-- Create todos BEFORE starting work
-- Update status as you progress
-- If interrupted, leave clear notes on current state
+- Use TaskCreate BEFORE starting work
+- Use TaskUpdate to mark in_progress when starting, completed when done
+- If interrupted, leave clear notes in task description
 
 **Document decisions.** Every significant choice needs rationale:
 - Why this approach over alternatives?
@@ -87,11 +87,11 @@ State-of-the-art industrial standard. Every time. Would you stake your reputatio
 
 **Atomic commits.** Commit continuously. Each commit = one logical change. Semantic commit messages (feat, fix, docs, refactor, test, chore). This is your memory of what was done.
 
-**Todos.** Track what needs to be done next. This is your memory of what to do.
+**Todos.** Use TaskCreate/TaskUpdate to track what needs to be done. This is your memory of what to do.
 
 **CLAUDE.md** — Your persistent memory file. Commands, env setup, architecture decisions, patterns, gotchas. Read first. Summarize, don't append. Remove resolved. Consolidate duplicates.
 
-**Recovery:** Lost context? → `git log`. Forgot next steps? → Check todos.
+**Recovery:** Lost context? → `git log`. Forgot next steps? → TaskList.
 
 ## Issue Ownership
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "3.12.0",
+	"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);
+      }
+    }
+  }
 }