iriai-build 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iriai-build",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Iriai Build tool — AI agent orchestration CLI",
   "type": "module",
   "bin": {

package/v3/orchestrator.js

@@ -2327,25 +2327,41 @@ export class Orchestrator {
             // Read verification config from plan.yaml — start QA session if local-server
             const verification = this._readVerificationConfig(feature);
             if (verification && verification.type === "local-server" && verification.url) {
+              let devServerOk = !verification.command; // no command = assume already running
               if (verification.command) {
-                // Start the dev server in the background
+                // Start the dev server in the background, await startup or error
                 try {
                   const featureReposDir = path.join(PROJECT_ROOT, ".features", feature.slug, "repos");
-                  const proc = cpSpawn("sh", ["-c", verification.command], {
-                    cwd: featureReposDir,
-                    stdio: "ignore",
-                    detached: true,
-                  });
-                  proc.unref();
-                  // Brief wait for server startup
-                  await new Promise(r => setTimeout(r, 3000));
+                  await new Promise((resolve) => {
+                    const proc = cpSpawn("sh", ["-c", verification.command], {
+                      cwd: featureReposDir,
+                      stdio: "ignore",
+                      detached: true,
+                    });
+                    proc.on("error", (err) => {
+                      console.error(`[orchestrator] Dev server spawn error: ${err.message}`);
+                      resolve(false);
+                    });
+                    proc.unref();
+                    // Brief wait for server startup, then assume OK
+                    setTimeout(() => resolve(true), 3000);
+                  }).then(ok => { devServerOk = ok; });
                 } catch (err) {
                   console.error(`[orchestrator] Failed to start dev server for gate review:`, err.message);
                 }
               }
-              qaUrl = await this.reviewSessions.startQaSession(
-                reviewSessionKey, verification.url, { featureId: feature.id }
-              );
+              if (devServerOk) {
+                qaUrl = await this.reviewSessions.startQaSession(
+                  reviewSessionKey, verification.url, { featureId: feature.id }
+                );
+              } else {
+                // Notify FL so it knows QA session is unavailable
+                const tree = this._signalTrees[feature.slug];
+                if (tree?.featureLead) {
+                  writeSignal(path.join(tree.featureLead, SIGNAL.USER_MESSAGE),
+                    `WARNING: Dev server failed to start (command: "${verification.command}"). QA live-testing unavailable for this gate review. Proceed with doc review only.`);
+                }
+              }
             }
           }