fix: harden archive install with staging directory and network resilience

.github/workflows/test.yml

@@ -211,7 +211,7 @@ jobs:
   migration-test:
     name: Migration Test on ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
-    timeout-minutes: 60
+    timeout-minutes: 45
 
     strategy:
       fail-fast: true

fvm_mcp/lib/src/process_runner.dart

@@ -28,6 +28,7 @@ class ProcessRunner {
     return [exe, ...args]
         .map((part) {
           final escaped = part.replaceAll('"', r'\"');
+
           return escaped.contains(' ') ? '"$escaped"' : escaped;
         })
         .join(' ');

lib/src/commands/install_command.dart

@@ -33,13 +33,20 @@ class InstallCommand extends BaseFvmCommand {
         help: 'Skip resolving dependencies after switching Flutter SDK',
         defaultsTo: false,
         negatable: false,
+      )
+      ..addFlag(
+        'archive',
+        help: 'Install from a precompiled archive instead of cloning from git',
+        defaultsTo: false,
+        negatable: false,
       );
   }
 
   @override
   Future<int> run() async {
     final setup = boolArg('setup');
     final skipPubGet = boolArg('skip-pub-get');
+    final useArchive = boolArg('archive');
 
     final ensureCache = EnsureCacheWorkflow(context);
     final useVersion = UseVersionWorkflow(context);
@@ -63,8 +70,11 @@ class InstallCommand extends BaseFvmCommand {
       // Apply fork/ref ambiguity resolution to project-pinned versions
       final resolvedVersion = validateFlutterVersion(version.nameWithAlias);
 
-      final cacheVersion =
-          await ensureCache(resolvedVersion, shouldInstall: true);
+      final cacheVersion = await ensureCache(
+        resolvedVersion,
+        shouldInstall: true,
+        useArchive: useArchive,
+      );
 
       await useVersion(
         version: cacheVersion,
@@ -80,7 +90,11 @@ class InstallCommand extends BaseFvmCommand {
 
     final flutterVersion = validateFlutterVersion(version);
 
-    final cacheVersion = await ensureCache(flutterVersion, shouldInstall: true);
+    final cacheVersion = await ensureCache(
+      flutterVersion,
+      shouldInstall: true,
+      useArchive: useArchive,
+    );
 
     if (setup) {
       await setupFlutter(cacheVersion);

lib/src/commands/use_command.dart

@@ -51,6 +51,12 @@ class UseCommand extends BaseFvmCommand {
         abbr: 's',
         help: 'Skips downloading SDK dependencies after switching versions',
         negatable: false,
+      )
+      ..addFlag(
+        'archive',
+        help: 'Install from a precompiled archive instead of cloning from git',
+        defaultsTo: false,
+        negatable: false,
       );
   }
   @override
@@ -60,6 +66,7 @@ class UseCommand extends BaseFvmCommand {
     final skipPubGet = boolArg('skip-pub-get');
     final flavorOption = stringArg('flavor');
     final skipSetup = boolArg('skip-setup');
+    final useArchive = boolArg('archive');
 
     String? version;
 
@@ -136,7 +143,11 @@ class UseCommand extends BaseFvmCommand {
 
     final flutterVersion = validateFlutterVersion(version);
 
-    final cacheVersion = await ensureCache(flutterVersion, force: forceOption);
+    final cacheVersion = await ensureCache(
+      flutterVersion,
+      force: forceOption,
+      useArchive: useArchive,
+    );
 
     /// Run use workflow
     await useVersion(