@vercel/dream 0.3.3 → 0.4.0

package/dist/dream.js

@@ -44,10 +44,12 @@ Environment variables required by the project are injected into the runtime envi
 
 ## Implementation Artifact Policy
 
-1. The deliverable is project source code that satisfies specs.
-2. For Vercel deployment, final build artifacts must conform to Build Output API in \`.vercel/output/\`, including a generated \`.vercel/output/config.json\`.
-3. Build Output API artifacts must be generated by the framework/app build pipeline (for example \`vercel build\` or framework-integrated build), not hand-authored as a shortcut.
-4. If required prerequisites are missing (for example env vars, credentials, unavailable services), do not produce a static fallback. Record a blocker in \`PROGRESS.md\` and stop the iteration.
+1. The deliverable is \`.vercel/output/\` conforming to Build Output API v3.
+2. \`.vercel/output/config.json\` must exist with \`{ "version": 3 }\`.
+3. Static assets go in \`.vercel/output/static/\`. Serverless functions go in \`.vercel/output/functions/\`.
+4. You may use any method to produce this: hand-write HTML, use a framework build, or any other approach.
+5. Run \`dream validate\` to verify the output before signaling completion.
+6. If required prerequisites are missing (for example env vars, credentials, unavailable services), do not produce a static fallback. Record a blocker in \`PROGRESS.md\` and stop the iteration.
 
 ## Critical: State Lives on Disk
 
@@ -165,7 +167,7 @@ Each iteration should complete a coherent unit (not trivial single-file churn),
 
 **When all work is done**, output completion signal. The bar is:
 1. All tasks in \`PROGRESS.md\` are checked off
-2. \`npm run build\` (or equivalent) exits 0
+2. \`dream validate\` passes
 3. No blockers in \`PROGRESS.md\`
 
 That's it. Do NOT loop on cosmetic verification (curling pages, grepping HTML, re-reading files you just wrote). If it builds clean and tasks are done, you are done.
@@ -276,6 +278,21 @@ ${INDENT_MAIN}${dim("specs")} ${dim(`(${specFiles.length})`)}`
   }
   printLine();
 });
+program.command("validate").description("Validate .vercel/output/ conforms to Build Output API v3").action(() => {
+  const workDir = path.resolve(program.opts().dir);
+  const result = validateBuildOutput(workDir);
+  if (result.valid) {
+    printSuccess("Build output is valid");
+    printLine();
+    process.exit(0);
+  }
+  printError("Build output validation failed:");
+  for (const error of result.errors) {
+    printListItem(error);
+  }
+  printLine();
+  process.exit(1);
+});
 program.command("models").description("List available models and check provider auth").action(async () => {
   printTitle("models");
   printStep("Starting OpenCode...");
@@ -449,12 +466,67 @@ ${INDENT_MAIN}${red("\u2717")} Timeout after ${formatTime(elapsed)}
         printLine(
           `${INDENT_MAIN}${cyan(`[${iteration}]`)} ${green("\u2713")} Done ${dim(`(${formatTime(iterElapsed)})`)}`
         );
-        printLine(
-          `
+        let validation = validateBuildOutput(workDir);
+        if (validation.valid) {
+          printSuccess("Build output validated");
+          printLine(
+            `
 ${INDENT_MAIN}${green("\u2713")} Completed in ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}
 `
-        );
-        process.exit(0);
+          );
+          process.exit(0);
+        }
+        const MAX_REMEDIATION_ATTEMPTS = 3;
+        for (let attempt = 1; attempt <= MAX_REMEDIATION_ATTEMPTS; attempt++) {
+          const remElapsed = Date.now() - startTime;
+          if (remElapsed >= timeout) {
+            printError(
+              `Timeout during remediation after ${formatTime(remElapsed)}`
+            );
+            printLine();
+            process.exit(1);
+          }
+          printError("Build output validation failed:");
+          for (const error of validation.errors) {
+            printListItem(error);
+          }
+          printLine(
+            `${INDENT_MAIN}${cyan(`[remediate ${attempt}/${MAX_REMEDIATION_ATTEMPTS}]`)} Running remediation session...`
+          );
+          const remediationMessage = [
+            "Build output validation failed:",
+            ...validation.errors.map((e) => `- ${e}`),
+            "",
+            "Produce .vercel/output/ conforming to Build Output API v3.",
+            "Run `dream validate` to verify before signaling completion."
+          ].join("\n");
+          await runSession(
+            client,
+            title,
+            `${effectivePrompt}
+
+## Remediation
+
+${remediationMessage}`,
+            verbose
+          );
+          validation = validateBuildOutput(workDir);
+          if (validation.valid) {
+            printSuccess("Build output validated after remediation");
+            printLine(
+              `
+${INDENT_MAIN}${green("\u2713")} Completed in ${bold(String(iteration))} iteration(s) ${dim(`(${formatTime(Date.now() - startTime)})`)}
+`
+            );
+            process.exit(0);
+          }
+        }
+        printError("Build output validation failed after remediation");
+        for (const error of validation.errors) {
+          printListItem(error);
+        }
+        printLine();
+        process.exit(1);
       }
       if (result === "error") {
         printLine(
@@ -684,6 +756,35 @@ function toolContext(tool, input) {
       return void 0;
   }
 }
+function validateBuildOutput(workDir) {
+  const errors = [];
+  const outputDir = path.join(workDir, ".vercel", "output");
+  const configPath = path.join(outputDir, "config.json");
+  if (!fs.existsSync(configPath)) {
+    errors.push(".vercel/output/config.json does not exist");
+  } else {
+    try {
+      const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+      if (config.version !== 3) {
+        errors.push(
+          `.vercel/output/config.json has version ${config.version}, expected 3`
+        );
+      }
+    } catch {
+      errors.push(".vercel/output/config.json is not valid JSON");
+    }
+  }
+  const staticDir = path.join(outputDir, "static");
+  const functionsDir = path.join(outputDir, "functions");
+  const hasStatic = fs.existsSync(staticDir) && fs.readdirSync(staticDir).length > 0;
+  const hasFunctions = fs.existsSync(functionsDir) && fs.readdirSync(functionsDir).length > 0;
+  if (!hasStatic && !hasFunctions) {
+    errors.push(
+      ".vercel/output/ must contain a non-empty static/ or functions/ directory"
+    );
+  }
+  return { valid: errors.length === 0, errors };
+}
 function loadProjectPrompt(specsDir) {
   for (const file of PROJECT_PROMPT_FILES) {
     const fullPath = path.join(specsDir, file);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/dream",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "A CLI that runs OpenCode in a loop until specs are complete",
   "type": "module",
   "bin": {