@agile-vibe-coding/avc 0.2.3 → 0.3.2

package/cli/init.js

@@ -11,6 +11,60 @@ import { MESSAGES, getCeremonyHeader } from './message-constants.js';
 import { sendError, sendWarning, sendSuccess, sendInfo, sendOutput, sendIndented, sendSectionHeader } from './messaging-api.js';
 import { boldCyan, yellow, green, cyan } from './ansi-colors.js';
 
+/**
+ * Trace log written directly to /tmp/avc-init.log so we can diagnose mkdir
+ * failures that occur before .avc/ exists (where normal logging goes).
+ */
+function initTrace(message, data = null) {
+  try {
+    const ts = new Date().toISOString();
+    const line = data
+      ? `[${ts}] ${message} ${JSON.stringify(data)}\n`
+      : `[${ts}] ${message}\n`;
+    fs.appendFileSync('/tmp/avc-init.log', line);
+  } catch { /* never let tracing break init */ }
+}
+
+/**
+ * Reliable recursive mkdir for WSL2 /mnt/ Windows paths.
+ *
+ * Two-layer strategy:
+ *  1. Walk the tree manually and call plain mkdirSync() for each segment
+ *     (avoids Node's { recursive:true } which can race on DrvFS/9P).
+ *  2. If mkdirSync() still fails with ENOENT (VFS dentry-cache stale —
+ *     stat() says parent exists but mkdir() syscall disagrees), fall back
+ *     to a subprocess `mkdir -p`.  The subprocess starts with a clean
+ *     dentry cache and sees the filesystem state the kernel actually has.
+ */
+function mkdirp(dirPath) {
+  initTrace('mkdirp enter', { dirPath, exists: fs.existsSync(dirPath) });
+  if (fs.existsSync(dirPath)) return;
+  const parent = path.dirname(dirPath);
+  if (parent !== dirPath) mkdirp(parent);
+  try {
+    fs.mkdirSync(dirPath);
+    initTrace('mkdirp created via mkdirSync', { dirPath });
+  } catch (err) {
+    if (err.code === 'EEXIST') return;
+    if (err.code === 'ENOENT') {
+      // WSL2/DrvFS: VFS dentry cache reports parent as present but the 9P
+      // server disagrees at mkdir() time.  Spawn a fresh process whose cache
+      // is clean — shell mkdir -p goes straight to the 9P server correctly.
+      initTrace('mkdirp mkdirSync ENOENT — falling back to shell mkdir -p', { dirPath, parentExists: fs.existsSync(parent) });
+      try {
+        execSync(`mkdir -p ${JSON.stringify(dirPath)}`, { stdio: 'pipe' });
+        initTrace('mkdirp created via shell mkdir -p', { dirPath });
+        return;
+      } catch (shellErr) {
+        initTrace('mkdirp shell mkdir -p also failed', { dirPath, shellErr: shellErr.message });
+        if (!fs.existsSync(dirPath)) throw err; // throw original ENOENT
+        return; // shell failed but dir now exists — tolerate
+      }
+    }
+    throw err;
+  }
+}
+
 /**
  * Write a structured entry to the active command log file only.
  * Uses [DEBUG] prefix so ConsoleOutputManager routes to file, never terminal.
@@ -125,7 +179,7 @@ class ProjectInitiator {
    */
   createAvcFolder() {
     if (!this.hasAvcFolder()) {
-      fs.mkdirSync(this.avcDir, { recursive: true });
+      mkdirp(this.avcDir);
       return true;
     }
     return false;
@@ -143,7 +197,7 @@ class ProjectInitiator {
    */
   createSrcFolder() {
     if (!this.hasSrcFolder()) {
-      fs.mkdirSync(this.srcDir, { recursive: true });
+      mkdirp(this.srcDir);
       return true;
     }
     return false;
@@ -161,7 +215,7 @@ class ProjectInitiator {
    */
   createWorktreesFolder() {
     if (!this.hasWorktreesFolder()) {
-      fs.mkdirSync(this.worktreesDir, { recursive: true });
+      mkdirp(this.worktreesDir);
       return true;
     }
     return false;
@@ -207,6 +261,64 @@ class ProjectInitiator {
                 model: 'claude-sonnet-4-6'
               }
             },
+            providerPresets: {
+              claude: {
+                provider: 'claude', defaultModel: 'claude-sonnet-4-6',
+                stages: {
+                  suggestions:                   { provider: 'claude', model: 'claude-sonnet-4-6' },
+                  documentation:                 { provider: 'claude', model: 'claude-sonnet-4-6' },
+                  'architecture-recommendation': { provider: 'claude', model: 'claude-opus-4-6' },
+                  'question-prefilling':         { provider: 'claude', model: 'claude-haiku-4-5-20251001' }
+                },
+                validation: {
+                  provider: 'claude', model: 'claude-haiku-4-5-20251001',
+                  documentation: { provider: 'claude', model: 'claude-haiku-4-5-20251001' },
+                  refinement: { provider: 'claude', model: 'claude-sonnet-4-6' }
+                }
+              },
+              gemini: {
+                provider: 'gemini', defaultModel: 'gemini-2.5-flash',
+                stages: {
+                  suggestions:                   { provider: 'gemini', model: 'gemini-2.5-flash' },
+                  documentation:                 { provider: 'gemini', model: 'gemini-2.5-flash' },
+                  'architecture-recommendation': { provider: 'gemini', model: 'gemini-2.5-pro' },
+                  'question-prefilling':         { provider: 'gemini', model: 'gemini-2.5-flash-lite' }
+                },
+                validation: {
+                  provider: 'gemini', model: 'gemini-2.5-flash-lite',
+                  documentation: { provider: 'gemini', model: 'gemini-2.5-flash-lite' },
+                  refinement: { provider: 'gemini', model: 'gemini-2.5-flash' }
+                }
+              },
+              openai: {
+                provider: 'openai', defaultModel: 'gpt-5.4',
+                stages: {
+                  suggestions:                   { provider: 'openai', model: 'gpt-5.4' },
+                  documentation:                 { provider: 'openai', model: 'gpt-5.4' },
+                  'architecture-recommendation': { provider: 'openai', model: 'gpt-5.4' },
+                  'question-prefilling':         { provider: 'openai', model: 'gpt-5-mini' }
+                },
+                validation: {
+                  provider: 'openai', model: 'gpt-5.4',
+                  documentation: { provider: 'openai', model: 'gpt-5.4' },
+                  refinement: { provider: 'openai', model: 'gpt-5.4' }
+                }
+              },
+              xiaomi: {
+                provider: 'xiaomi', defaultModel: 'mimo-v2-pro',
+                stages: {
+                  suggestions:                   { provider: 'xiaomi', model: 'mimo-v2-flash' },
+                  documentation:                 { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  'architecture-recommendation': { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  'question-prefilling':         { provider: 'xiaomi', model: 'mimo-v2-pro' }
+                },
+                validation: {
+                  provider: 'xiaomi', model: 'mimo-v2-flash',
+                  documentation: { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  refinement: { provider: 'xiaomi', model: 'mimo-v2-pro' }
+                }
+              }
+            },
             agents: [
               {
                 name: 'project-documentation-creator',
@@ -253,21 +365,64 @@ class ProjectInitiator {
               validation: {
                 provider: 'claude',
                 model: 'claude-sonnet-4-6',
-                useContextualSelection: true
+                useContextualSelection: true,
+                epicConcurrency: 2,
+                concurrency: 5,
+                maxFixAttempts: 3
               },
-              'doc-distribution': {
+              'context-generation': {
                 provider: 'claude',
                 model: 'claude-sonnet-4-6'
               },
-              enrichment: {
+              'doc-generation': {
                 provider: 'claude',
                 model: 'claude-sonnet-4-6'
               },
-              solver: {
+              enrichment: {
                 provider: 'claude',
-                model: 'claude-haiku-4-5-20251001',
-                maxIterations: 3,
-                acceptanceThreshold: 95
+                model: 'claude-sonnet-4-6'
+              }
+            },
+            providerPresets: {
+              claude: {
+                provider: 'claude', defaultModel: 'claude-sonnet-4-6',
+                stages: {
+                  decomposition:        { provider: 'claude', model: 'claude-opus-4-6' },
+                  validation:           { provider: 'claude', model: 'claude-sonnet-4-6', useContextualSelection: true, epicConcurrency: 2, concurrency: 5, maxFixAttempts: 3 },
+                  'context-generation': { provider: 'claude', model: 'claude-sonnet-4-6' },
+                  'doc-generation':     { provider: 'claude', model: 'claude-sonnet-4-6' },
+                  enrichment:           { provider: 'claude', model: 'claude-sonnet-4-6' }
+                }
+              },
+              gemini: {
+                provider: 'gemini', defaultModel: 'gemini-2.5-flash',
+                stages: {
+                  decomposition:        { provider: 'gemini', model: 'gemini-2.5-pro' },
+                  validation:           { provider: 'gemini', model: 'gemini-2.5-flash', useContextualSelection: true, epicConcurrency: 2, concurrency: 5, maxFixAttempts: 3 },
+                  'context-generation': { provider: 'gemini', model: 'gemini-2.5-flash' },
+                  'doc-generation':     { provider: 'gemini', model: 'gemini-2.5-flash' },
+                  enrichment:           { provider: 'gemini', model: 'gemini-2.5-flash' }
+                }
+              },
+              openai: {
+                provider: 'openai', defaultModel: 'gpt-5.4',
+                stages: {
+                  decomposition:        { provider: 'openai', model: 'gpt-5.4' },
+                  validation:           { provider: 'openai', model: 'gpt-5.4', useContextualSelection: true, epicConcurrency: 2, concurrency: 5, maxFixAttempts: 3 },
+                  'context-generation': { provider: 'openai', model: 'gpt-5.4' },
+                  'doc-generation':     { provider: 'openai', model: 'gpt-5.4' },
+                  enrichment:           { provider: 'openai', model: 'gpt-5.4' }
+                }
+              },
+              xiaomi: {
+                provider: 'xiaomi', defaultModel: 'mimo-v2-pro',
+                stages: {
+                  decomposition:        { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  validation:           { provider: 'xiaomi', model: 'mimo-v2-flash', useContextualSelection: true, epicConcurrency: 2, concurrency: 5, maxFixAttempts: 3 },
+                  'context-generation': { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  'doc-generation':     { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  enrichment:           { provider: 'xiaomi', model: 'mimo-v2-pro' }
+                }
               }
             },
             agents: [
@@ -276,11 +431,6 @@ class ProjectInitiator {
                 instruction: 'epic-story-decomposer.md',
                 stage: 'decomposition'
               },
-              {
-                name: 'doc-distributor',
-                instruction: 'doc-distributor.md',
-                stage: 'doc-distribution'
-              },
               {
                 name: 'project-context-extractor',
                 instruction: 'project-context-extractor.md',
@@ -291,6 +441,26 @@ class ProjectInitiator {
                 instruction: 'agent-selector.md',
                 stage: 'validation'
               },
+              {
+                name: 'context-writer-epic',
+                instruction: 'context-writer-epic.md',
+                stage: 'context-generation'
+              },
+              {
+                name: 'context-writer-story',
+                instruction: 'context-writer-story.md',
+                stage: 'context-generation'
+              },
+              {
+                name: 'doc-writer-epic',
+                instruction: 'doc-writer-epic.md',
+                stage: 'doc-generation'
+              },
+              {
+                name: 'doc-writer-story',
+                instruction: 'doc-writer-story.md',
+                stage: 'doc-generation'
+              },
               {
                 name: 'story-doc-enricher',
                 instruction: 'story-doc-enricher.md',
@@ -307,11 +477,48 @@ class ProjectInitiator {
                 provider: 'claude',
                 model: 'claude-opus-4-6'
               },
-              'doc-distribution': {
+              'context-generation': {
                 provider: 'claude',
                 model: 'claude-sonnet-4-6'
               }
             },
+            providerPresets: {
+              claude: {
+                provider: 'claude', defaultModel: 'claude-sonnet-4-6',
+                stages: {
+                  decomposition:         { provider: 'claude', model: 'claude-opus-4-6' },
+                  'context-generation':  { provider: 'claude', model: 'claude-sonnet-4-6' }
+                }
+              },
+              gemini: {
+                provider: 'gemini', defaultModel: 'gemini-2.5-flash',
+                stages: {
+                  decomposition:         { provider: 'gemini', model: 'gemini-2.5-pro' },
+                  'context-generation':  { provider: 'gemini', model: 'gemini-2.5-flash' }
+                }
+              },
+              openai: {
+                provider: 'openai', defaultModel: 'gpt-5.4',
+                stages: {
+                  decomposition:         { provider: 'openai', model: 'gpt-5.4' },
+                  'context-generation':  { provider: 'openai', model: 'gpt-5.4' }
+                }
+              },
+              xiaomi: {
+                provider: 'xiaomi', defaultModel: 'mimo-v2-pro',
+                stages: {
+                  decomposition:         { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  'context-generation':  { provider: 'xiaomi', model: 'mimo-v2-pro' }
+                }
+              },
+              local: {
+                provider: 'local', defaultModel: 'qwen/qwen3-coder-next',
+                stages: {
+                  decomposition:         { provider: 'local', model: 'qwen/qwen3-coder-next' },
+                  'context-generation':  { provider: 'local', model: 'qwen/qwen3-coder-next' }
+                }
+              }
+            },
             agents: [
               {
                 name: 'task-subtask-decomposer',
@@ -329,6 +536,72 @@ class ProjectInitiator {
                 stage: 'decomposition'
               }
             ]
+          },
+          {
+            name: 'run',
+            provider: 'claude',
+            defaultModel: 'claude-sonnet-4-6',
+            stages: {
+              'code-generation': {
+                provider: 'claude',
+                model: 'claude-sonnet-4-6'
+              },
+              'code-validation': {
+                provider: 'claude',
+                model: 'claude-sonnet-4-6'
+              }
+            },
+            providerPresets: {
+              claude: {
+                provider: 'claude', defaultModel: 'claude-sonnet-4-6',
+                stages: {
+                  'code-generation':  { provider: 'claude', model: 'claude-sonnet-4-6' },
+                  'code-validation':  { provider: 'claude', model: 'claude-sonnet-4-6' }
+                }
+              },
+              gemini: {
+                provider: 'gemini', defaultModel: 'gemini-2.5-flash',
+                stages: {
+                  'code-generation':  { provider: 'gemini', model: 'gemini-2.5-flash' },
+                  'code-validation':  { provider: 'gemini', model: 'gemini-2.5-flash' }
+                }
+              },
+              openai: {
+                provider: 'openai', defaultModel: 'gpt-5.4',
+                stages: {
+                  'code-generation':  { provider: 'openai', model: 'gpt-5.4' },
+                  'code-validation':  { provider: 'openai', model: 'gpt-5.4' }
+                }
+              },
+              xiaomi: {
+                provider: 'xiaomi', defaultModel: 'mimo-v2-pro',
+                stages: {
+                  'code-generation':  { provider: 'xiaomi', model: 'mimo-v2-pro' },
+                  'code-validation':  { provider: 'xiaomi', model: 'mimo-v2-flash' }
+                }
+              },
+              local: {
+                provider: 'local', defaultModel: 'qwen/qwen3-coder-next',
+                stages: {
+                  'code-generation':  { provider: 'local', model: 'qwen/qwen3-coder-next' },
+                  'code-validation':  { provider: 'local', model: 'qwen/qwen3-coder-next' }
+                }
+              }
+            },
+            maxValidationIterations: 3,
+            acceptanceThreshold: 80,
+            agents: [
+              {
+                name: 'code-implementer',
+                instruction: 'code-implementer.md',
+                stage: 'code-generation'
+              },
+              {
+                name: 'code-validator',
+                instruction: 'code-validator.md',
+                stage: 'code-validation'
+              }
+            ]
           }
         ],
         missionGenerator: {
@@ -340,7 +613,8 @@ class ProjectInitiator {
         costThresholds: {
           'sponsor-call': 2,
           'sprint-planning': 2,
-          'seed': 2
+          'seed': 2,
+          'run': 2
         },
         questionnaire: {
           defaults: {
@@ -449,26 +723,26 @@ class ProjectInitiator {
 
           // OpenAI models (prices per 1M tokens in USD)
           // Source: https://openai.com/api/pricing
-          'gpt-5.2': {
+          'gpt-5.4': {
             provider: 'openai',
-            displayName: 'GPT-5.2',
+            displayName: 'GPT-5.4',
             pricing: {
-              input: 1.75,
-              output: 14.00,
+              input: 2.50,
+              output: 15.00,
               unit: 'million',
               source: 'https://openai.com/api/pricing',
-              lastUpdated: '2026-02-24'
+              lastUpdated: '2026-03-06'
             }
           },
-          'gpt-5.1': {
+          'gpt-5.4-pro': {
             provider: 'openai',
-            displayName: 'GPT-5.1',
+            displayName: 'GPT-5.4 Pro',
             pricing: {
-              input: 1.25,
-              output: 10.00,
+              input: 30.00,
+              output: 180.00,
               unit: 'million',
               source: 'https://openai.com/api/pricing',
-              lastUpdated: '2026-02-24'
+              lastUpdated: '2026-03-06'
             }
           },
           'gpt-5-mini': {
@@ -482,50 +756,53 @@ class ProjectInitiator {
               lastUpdated: '2026-02-24'
             }
           },
-          'o4-mini': {
+          'gpt-5-nano': {
             provider: 'openai',
-            displayName: 'o4-mini',
+            displayName: 'GPT-5 nano',
             pricing: {
-              input: 1.10,
-              output: 4.40,
+              input: 0.05,
+              output: 0.40,
               unit: 'million',
               source: 'https://openai.com/api/pricing',
-              lastUpdated: '2026-02-24'
+              lastUpdated: '2026-03-06'
             }
           },
-          'o3': {
-            provider: 'openai',
-            displayName: 'o3',
+
+          // Xiaomi MiMo models (prices per 1M tokens in USD)
+          // Source: https://platform.xiaomimimo.com
+          'mimo-v2-flash': {
+            provider: 'xiaomi',
+            displayName: 'MiMo V2 Flash',
             pricing: {
-              input: 2.00,
-              output: 8.00,
+              input: 0.09,
+              output: 0.29,
               unit: 'million',
-              source: 'https://openai.com/api/pricing',
-              lastUpdated: '2026-02-24'
+              source: 'https://platform.xiaomimimo.com',
+              lastUpdated: '2026-03-25'
             }
           },
-          'o3-mini': {
-            provider: 'openai',
-            displayName: 'o3-mini',
+          'mimo-v2-pro': {
+            provider: 'xiaomi',
+            displayName: 'MiMo V2 Pro',
             pricing: {
-              input: 0.50,
-              output: 2.00,
+              input: 1.00,
+              output: 3.00,
               unit: 'million',
-              source: 'https://openai.com/api/pricing',
-              lastUpdated: '2026-02-24'
+              source: 'https://platform.xiaomimimo.com',
+              lastUpdated: '2026-03-25'
             }
           },
-          'gpt-5.2-codex': {
-            provider: 'openai',
-            displayName: 'GPT-5.2-Codex',
+          'mimo-v2-omni': {
+            provider: 'xiaomi',
+            displayName: 'MiMo V2 Omni',
             pricing: {
-              input: 1.75,
-              output: 14.00,
+              input: 0.40,
+              output: 2.00,
               unit: 'million',
-              source: 'https://openai.com/api/pricing',
-              lastUpdated: '2026-02-24'
+              source: 'https://platform.xiaomimimo.com',
+              lastUpdated: '2026-03-25'
             }
-          }
+          },
         }
       }
     };
@@ -549,7 +826,7 @@ class ProjectInitiator {
 
       // Upgrade null cost thresholds to default (2 USD)
       if (mergedConfig.settings?.costThresholds) {
-        for (const ceremony of ['sponsor-call', 'sprint-planning', 'seed']) {
+        for (const ceremony of ['sponsor-call', 'sprint-planning', 'seed', 'run']) {
           if (mergedConfig.settings.costThresholds[ceremony] === null) {
             mergedConfig.settings.costThresholds[ceremony] = 2;
           }
@@ -611,6 +888,11 @@ class ProjectInitiator {
         key: 'OPENAI_API_KEY',
         comment: 'OpenAI API Key (alternative LLM provider)',
         url: 'https://platform.openai.com/api-keys'
+      },
+      {
+        key: 'XIAOMI_API_KEY',
+        comment: 'Xiaomi MiMo API Key (alternative LLM provider)',
+        url: 'https://platform.xiaomimimo.com/#/console/api-keys'
       }
     ];
 
@@ -714,11 +996,11 @@ class ProjectInitiator {
 
     // Create directory structure
     if (!fs.existsSync(vitepressDir)) {
-      fs.mkdirSync(vitepressDir, { recursive: true });
+      mkdirp(vitepressDir);
     }
 
     if (!fs.existsSync(publicDir)) {
-      fs.mkdirSync(publicDir, { recursive: true });
+      mkdirp(publicDir);
     }
 
     // Create VitePress config
@@ -765,7 +1047,7 @@ Documentation for this project will be generated automatically once the project
    */
   writeProgress(progress, progressPath) {
     if (!fs.existsSync(this.avcDir)) {
-      fs.mkdirSync(this.avcDir, { recursive: true });
+      mkdirp(this.avcDir);
     }
     fs.writeFileSync(progressPath, JSON.stringify(progress, null, 2), 'utf8');
   }
@@ -885,25 +1167,117 @@ Documentation for this project will be generated automatically once the project
     const envVarMap = {
       'claude': 'ANTHROPIC_API_KEY',
       'gemini': 'GEMINI_API_KEY',
-      'openai': 'OPENAI_API_KEY'
+      'openai': 'OPENAI_API_KEY',
+      'xiaomi': 'XIAOMI_API_KEY'
     };
 
     const urlMap = {
       'claude': 'https://console.anthropic.com/settings/keys',
       'gemini': 'https://aistudio.google.com/app/apikey',
-      'openai': 'https://platform.openai.com/api-keys'
+      'openai': 'https://platform.openai.com/api-keys',
+      'xiaomi': 'https://platform.xiaomimimo.com/#/console/api-keys'
     };
 
+    // Check if a provider has any valid auth credential (API key OR oauth token)
+    const hasProviderAuth = (provider) => {
+      if (provider === 'openai') {
+        const oauthFile = path.join(this.projectRoot, '.avc', 'openai-oauth.json');
+        return !!(process.env.OPENAI_API_KEY ||
+          (process.env.OPENAI_AUTH_MODE === 'oauth' && fs.existsSync(oauthFile)));
+      }
+      return !!process.env[envVarMap[provider]];
+    };
+
+    const authLabel = (provider) => {
+      if (provider === 'openai' && process.env.OPENAI_AUTH_MODE === 'oauth') return 'OpenAI OAuth token';
+      return envVarMap[provider];
+    };
+
+    // Local provider needs no API key — skip validation entirely
+    if (mainProvider === 'local') {
+      // Still validate the validation provider if it's a cloud provider
+      if (validationEnabled && validationProvider && validationProvider !== 'local') {
+        const validationEnvVar = envVarMap[validationProvider];
+        if (!validationEnvVar) {
+          return {
+            valid: false,
+            message: `Unknown validation provider "${validationProvider}".\n   Supported providers: claude, gemini, openai, xiaomi, local`
+          };
+        }
+        if (!hasProviderAuth(validationProvider)) {
+          return {
+            valid: false,
+            validationProviderMissing: true,
+            message: `${validationEnvVar} not found in .env file (needed for validation provider).`
+          };
+        }
+      }
+      return { valid: true };
+    }
+
     // Validate main provider
     const mainEnvVar = envVarMap[mainProvider];
     if (!mainEnvVar) {
       return {
         valid: false,
-        message: `Unknown provider "${mainProvider}".\n   Supported providers: claude, gemini, openai`
+        message: `Unknown provider "${mainProvider}".\n   Supported providers: claude, gemini, openai, xiaomi, local`
       };
     }
 
-    if (!process.env[mainEnvVar]) {
+    // Helper: switch ALL ceremonies in avc.json to the fallback provider/model.
+    // Updates ceremony-level provider + defaultModel and every stage override.
+    const switchCeremonyProvider = (resolved) => {
+      try {
+        const freshConfig = JSON.parse(fs.readFileSync(this.avcConfigPath, 'utf8'));
+        for (const c of (freshConfig.settings?.ceremonies || [])) {
+          const preset = c.providerPresets?.[resolved.provider];
+          const fallbackModel = preset?.defaultModel || resolved.model;
+
+          c.provider = resolved.provider;
+          c.defaultModel = fallbackModel;
+
+          // Apply preset stage config (model + extra props like concurrency)
+          if (c.stages && typeof c.stages === 'object') {
+            for (const stageName of Object.keys(c.stages)) {
+              const presetStage = preset?.stages?.[stageName];
+              if (presetStage) {
+                Object.assign(c.stages[stageName], presetStage);
+              } else {
+                c.stages[stageName].provider = resolved.provider;
+                c.stages[stageName].model = fallbackModel;
+              }
+            }
+          }
+
+          // Apply preset validation models or fall back to default model
+          if (c.validation && typeof c.validation === 'object') {
+            const presetVal = preset?.validation;
+            c.validation.provider = resolved.provider;
+            c.validation.model = presetVal?.model || fallbackModel;
+            for (const [k, v] of Object.entries(c.validation)) {
+              if (v && typeof v === 'object' && typeof v.provider === 'string') {
+                const presetSub = presetVal?.[k];
+                v.provider = resolved.provider;
+                v.model = presetSub?.model || presetVal?.model || fallbackModel;
+              }
+            }
+          }
+        }
+        fs.writeFileSync(this.avcConfigPath, JSON.stringify(freshConfig, null, 2), 'utf8');
+        fileLog('INFO', `Switched all ceremony models to ${resolved.provider} using presets in avc.json`);
+      } catch (writeErr) {
+        fileLog('WARN', `Could not persist provider switch: ${writeErr.message}`);
+      }
+    };
+
+    if (!hasProviderAuth(mainProvider)) {
+      // Try to find any available fallback provider
+      const resolved = await LLMProvider.resolveAvailableProvider(mainProvider, mainModel);
+      if (resolved.fellBack) {
+        fileLog('WARN', `Pre-ceremony fallback: ${mainProvider}→${resolved.provider} (no API key for ${mainProvider})`);
+        switchCeremonyProvider(resolved);
+        return { valid: true };
+      }
       return {
         valid: false,
         message: `${mainEnvVar} not found in .env file.\n\n   Steps to fix:\n   1. Open .env file in the current directory\n   2. Add your API key: ${mainEnvVar}=your-key-here\n   3. Save the file and run /sponsor-call again\n\n   Get your API key:\n   • ${urlMap[mainProvider]}`
@@ -915,6 +1289,13 @@ Documentation for this project will be generated automatically once the project
     try {
       result = await LLMProvider.validate(mainProvider, mainModel);
     } catch (error) {
+      // API key exists but validation failed — try fallback
+      const resolved = await LLMProvider.resolveAvailableProvider(mainProvider, mainModel);
+      if (resolved.fellBack) {
+        fileLog('WARN', `Pre-ceremony fallback after validation failure: ${mainProvider}→${resolved.provider}`);
+        switchCeremonyProvider(resolved);
+        return { valid: true };
+      }
       const parsedError = this.parseApiError(error.message || error);
       return {
         valid: false,
@@ -923,6 +1304,13 @@ Documentation for this project will be generated automatically once the project
     }
 
     if (!result.valid) {
+      // API call failed — try fallback
+      const resolved = await LLMProvider.resolveAvailableProvider(mainProvider, mainModel);
+      if (resolved.fellBack) {
+        fileLog('WARN', `Pre-ceremony fallback after API failure: ${mainProvider}→${resolved.provider}`);
+        switchCeremonyProvider(resolved);
+        return { valid: true };
+      }
       const parsedError = this.parseApiError(result.error || 'Unknown error');
       return {
         valid: false,
@@ -931,47 +1319,82 @@ Documentation for this project will be generated automatically once the project
     }
 
     // Validate validation provider if enabled and different from main
-    if (validationEnabled && validationProvider && validationProvider !== mainProvider) {
+    if (validationEnabled && validationProvider && validationProvider !== mainProvider && validationProvider !== 'local') {
       const validationEnvVar = envVarMap[validationProvider];
 
       if (!validationEnvVar) {
         return {
           valid: false,
-          message: `Unknown validation provider "${validationProvider}".\n   Supported providers: claude, gemini, openai`
+          message: `Unknown validation provider "${validationProvider}".\n   Supported providers: claude, gemini, openai, xiaomi, local`
         };
       }
 
-      if (!process.env[validationEnvVar]) {
-        // Enhanced error message with 3 options
-        return {
-          valid: false,
-          validationProviderMissing: true,
-          ceremonyConfig: {
-            mainProvider,
-            mainModel,
-            validationProvider,
-            validationModel
-          },
-          message: `Validation Provider API Key Missing\n\nYour ceremony is configured to use:\n  • Generation: ${mainProvider} (${mainModel}) ✓\n  • Validation: ${validationProvider} (${validationModel}) ✗ (${validationEnvVar} not found)\n\nYou have 3 options:\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nOption 1: Add the missing API key\n\n  1. Get API key: ${urlMap[validationProvider]}\n  2. Add to .env file: ${validationEnvVar}=your-key-here\n  3. Run /sponsor-call again\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nOption 2: Disable validation (faster, lower quality)\n\n  1. Edit .avc/avc.json\n  2. Find "sponsor-call" ceremony config\n  3. Set:\n     "validation": {\n       "enabled": false\n     }\n  4. Run /sponsor-call again\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nOption 3: Use same provider for validation (simpler setup)\n\n  1. Edit .avc/avc.json\n  2. Find "sponsor-call" ceremony config\n  3. Change:\n     "validation": {\n       "enabled": true,\n       "provider": "${mainProvider}",\n       "model": "${mainModel}"\n     }\n  4. Run /sponsor-call again\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`
-        };
+      if (!hasProviderAuth(validationProvider)) {
+        // Auto-switch validation to use the main provider (which we already verified works)
+        fileLog('WARN', `Validation provider ${validationProvider} has no key — switching to main provider ${mainProvider}`);
+        try {
+          const freshConfig = JSON.parse(fs.readFileSync(this.avcConfigPath, 'utf8'));
+          for (const c of (freshConfig.settings?.ceremonies || [])) {
+            if (c.validation && typeof c.validation === 'object') {
+              c.validation.provider = mainProvider;
+              c.validation.model = mainModel;
+              for (const [k, v] of Object.entries(c.validation)) {
+                if (v && typeof v === 'object' && typeof v.provider === 'string') {
+                  v.provider = mainProvider;
+                  v.model = mainModel;
+                }
+              }
+            }
+          }
+          fs.writeFileSync(this.avcConfigPath, JSON.stringify(freshConfig, null, 2), 'utf8');
+        } catch {}
+        return { valid: true };
       }
 
       try {
         result = await LLMProvider.validate(validationProvider, validationModel);
       } catch (error) {
-        const parsedError = this.parseApiError(error.message || error);
-        return {
-          valid: false,
-          message: `${validationEnvVar} validation failed.\n\n   ${parsedError}\n\n   Get a new API key if needed:\n   • ${urlMap[validationProvider]}`
-        };
+        // Validation provider failed — auto-switch to main provider
+        fileLog('WARN', `Validation provider ${validationProvider} failed — switching to main provider ${mainProvider}`);
+        try {
+          const freshConfig = JSON.parse(fs.readFileSync(this.avcConfigPath, 'utf8'));
+          for (const c of (freshConfig.settings?.ceremonies || [])) {
+            if (c.validation && typeof c.validation === 'object') {
+              c.validation.provider = mainProvider;
+              c.validation.model = mainModel;
+              for (const [k, v] of Object.entries(c.validation)) {
+                if (v && typeof v === 'object' && typeof v.provider === 'string') {
+                  v.provider = mainProvider;
+                  v.model = mainModel;
+                }
+              }
+            }
+          }
+          fs.writeFileSync(this.avcConfigPath, JSON.stringify(freshConfig, null, 2), 'utf8');
+        } catch {}
+        return { valid: true };
       }
 
       if (!result.valid) {
-        const parsedError = this.parseApiError(result.error || 'Unknown error');
-        return {
-          valid: false,
-          message: `${validationEnvVar} is set but API call failed.\n\n   ${parsedError}\n\n   Get a new API key if needed:\n   • ${urlMap[validationProvider]}`
-        };
+        // Validation provider API call failed — auto-switch to main provider
+        fileLog('WARN', `Validation provider ${validationProvider} API call failed — switching to main provider ${mainProvider}`);
+        try {
+          const freshConfig = JSON.parse(fs.readFileSync(this.avcConfigPath, 'utf8'));
+          for (const c of (freshConfig.settings?.ceremonies || [])) {
+            if (c.validation && typeof c.validation === 'object') {
+              c.validation.provider = mainProvider;
+              c.validation.model = mainModel;
+              for (const [k, v] of Object.entries(c.validation)) {
+                if (v && typeof v === 'object' && typeof v.provider === 'string') {
+                  v.provider = mainProvider;
+                  v.model = mainModel;
+                }
+              }
+            }
+          }
+          fs.writeFileSync(this.avcConfigPath, JSON.stringify(freshConfig, null, 2), 'utf8');
+        } catch {}
+        return { valid: true };
       }
 
     }
@@ -1080,7 +1503,7 @@ Documentation for this project will be generated automatically once the project
       avcConfig: this.hasAvcConfig(),
     });
 
-    sendOutput('Project initialized — set your API keys in .env (Anthropic, Gemini, OpenAI) then open the Kanban board to get started.');
+    sendOutput('Project initialized — open the Kanban board to get started.');
 
     return;
   }
@@ -1132,8 +1555,6 @@ Documentation for this project will be generated automatically once the project
     });
 
     ceremonies.forEach(c => {
-      const ceremonyUrl = `https://agilevibecoding.org/ceremonies/${c.name}.html`;
-
       const hasMainKey = configurator.availableProviders.includes(c.mainProvider);
       const stageDetails = {};
       Object.keys(c.stages).forEach(stageName => {
@@ -1441,13 +1862,13 @@ Documentation for this project will be generated automatically once the project
    * @returns {Promise<object>} Result with epicsCreated, storiesCreated, tokenUsage, model
    */
   async sprintPlanningWithCallback(progressCallback = null, options = {}) {
-    fileLog('INFO', 'sprintPlanningWithCallback() called', { projectRoot: this.projectRoot });
+    fileLog('INFO', 'sprintPlanningWithCallback() called', { projectRoot: this.projectRoot, resumeFrom: options.resumeFrom || null });
     if (!this.isAvcProject()) {
       throw new Error('Project not initialized. Run /init first.');
     }
     const { SprintPlanningProcessor } = await import('./sprint-planning-processor.js');
     const processor = new SprintPlanningProcessor(options);
-    return await processor.execute(progressCallback);
+    return await processor.execute(progressCallback, { resumeFrom: options.resumeFrom || null });
   }
 
   /**
@@ -1749,6 +2170,7 @@ Documentation for this project will be generated automatically once the project
                 sendIndented('• ANTHROPIC_API_KEY', 1);
                 sendIndented('• GEMINI_API_KEY', 1);
                 sendIndented('• OPENAI_API_KEY', 1);
+                sendIndented('• XIAOMI_API_KEY', 1);
                 sendIndented('• (and any other API keys you added)', 1);
                 sendOutput('If these API keys are not used elsewhere in your project,');
                 sendOutput('you may want to manually delete the .env file or remove');