@reshotdev/screenshot 0.0.1-beta.2 → 0.0.1-beta.20

package/src/commands/setup-wizard.js

@@ -1,41 +1,21 @@
-// setup-wizard.js - Comprehensive interactive setup wizard
-// Consolidates the initial setup flow: auth + init + feature configuration
-// Individual commands (auth, init) still exist for power users
+// setup-wizard.js - Interactive setup wizard
+// Streamlined flow: choose lane, create config, optional Studio launch
 
 const inquirer = require("inquirer");
 const chalk = require("chalk");
 const fs = require("fs-extra");
 const path = require("path");
 const config = require("../lib/config");
-const {
-  validateStorageConfig,
-  getStorageSetupHelp,
-} = require("../lib/storage-providers");
+const { normalizeConfigContract } = require("../lib/target-contract");
+const { detectCI } = require("../lib/ci-detect");
 
 /**
- * Auto-detect documentation directories
+ * Whether the current process can prompt the user interactively.
+ * False in CI or when stdin is not a TTY (piped / redirected), where an
+ * inquirer prompt would throw `ERR_USE_AFTER_CLOSE: readline`.
  */
-function detectDocumentationRoot() {
-  const commonPaths = [
-    "docs",
-    "documentation",
-    "content",
-    "doc",
-    "guides",
-    ".vitepress/content",
-    ".docusaurus/docs",
-  ];
-
-  for (const dir of commonPaths) {
-    const fullPath = path.join(process.cwd(), dir);
-    if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
-      const files = fs.readdirSync(fullPath);
-      if (files.some((f) => f.endsWith(".md") || f.endsWith(".mdx"))) {
-        return dir;
-      }
-    }
-  }
-  return null;
+function isInteractive() {
+  return !!process.stdin.isTTY && !detectCI().isCI;
 }
 
 /**
@@ -91,184 +71,110 @@ function detectPlaywright() {
   return { hasPlaywright: false, configFile: null };
 }
 
-/**
- * Generate documentation block configuration
- */
-function generateDocumentationConfig(root = "./docs", strategy = "git_pr") {
-  return {
-    root,
-    include: ["**/*.md", "**/*.mdx"],
-    exclude: ["**/_*.mdx", "**/node_modules/**", "**/.next/**"],
-    strategy,
-    assetFormat: "markdown",
-    mappings: {},
-  };
-}
-
-/**
- * Scaffold a basic documentation structure
- */
-async function scaffoldDocumentation(template = "basic") {
-  const docsDir = path.join(process.cwd(), "docs");
-  fs.ensureDirSync(docsDir);
-
-  const readmeContent = `# Documentation
-
-This directory contains documentation for your project.
-
-## Linking Docs to Visual Journeys
-
-Add \`reshot_journey\` frontmatter to your markdown files to link them to Playwright test captures:
-
-\`\`\`markdown
----
-title: "Feature Name"
-reshot_journey: "feature/workflow-name"
----
-
-# Feature Documentation
-
-Your content here...
-\`\`\`
-
-The journey key should match your Playwright test structure. For example:
-- Test file: \`tests/01-auth-flows.spec.ts\` with "Login Flow" describe block
-- Journey key: \`auth-flows/login-flow\`
-
-## Commands
-
-- \`reshot import-tests\` - Import existing Playwright tests
-- \`reshot sync\` - Sync visuals and documentation  
-- \`reshot status\` - View sync status and drifts
-- \`reshot validate\` - Validate configuration
-- \`reshot studio\` - Open visual management UI
-
-For more information, visit: https://docs.reshot.dev
-`;
-
-  fs.writeFileSync(path.join(docsDir, "README.md"), readmeContent);
-
-  const exampleContent = `---
-title: "Getting Started"
-reshot_journey: "onboarding/first-steps"
-description: "Quick start guide for new users"
----
-
-# Getting Started
-
-Welcome! This is an example documentation file linked to the \`onboarding/first-steps\` journey.
-
-## Overview
-
-When Reshot detects UI changes in your Playwright tests, it will automatically propose updates to this document with new screenshots and descriptions.
+function detectSetupMode(projectConfig, useCloud) {
+  const normalizedConfig =
+    projectConfig && typeof projectConfig === "object"
+      ? normalizeConfigContract(projectConfig)
+      : null;
+  const targetTier = normalizedConfig?.target?.tier || null;
 
-## Steps
-
-1. **Step 1**: Description of first step
-
-   <!-- Reshot will inject screenshots here when visual drift is detected -->
-
-2. **Step 2**: Description of second step
-
-3. **Step 3**: Description of third step
-
-## Next Steps
+  if (targetTier === "certified") {
+    return "certified-target";
+  }
 
-- Link more documents to journeys
-- Run \`reshot sync\` to upload traces
-- Check \`reshot status\` for drift notifications
-`;
+  if (targetTier === "candidate") {
+    return "candidate-target";
+  }
 
-  fs.writeFileSync(path.join(docsDir, "getting-started.md"), exampleContent);
-  return "docs";
+  return useCloud ? "cloud-connected" : "local-only";
 }
 
-/**
- * Check if a documentation framework is already set up
- */
-function detectDocumentationFramework() {
-  const frameworks = [
-    {
-      name: "Astro/Starlight",
-      files: ["astro.config.mjs", "astro.config.ts"],
-      deps: ["@astrojs/starlight"],
-    },
-    {
-      name: "Docusaurus",
-      files: ["docusaurus.config.js", "docusaurus.config.ts"],
-      deps: ["@docusaurus/core"],
-    },
-    {
-      name: "VitePress",
-      files: [".vitepress/config.js", ".vitepress/config.ts"],
-      deps: ["vitepress"],
-    },
-    { name: "Mintlify", files: ["mint.json"], deps: [] },
-    { name: "GitBook", files: [".gitbook.yaml"], deps: [] },
-  ];
+function getRecommendedLocalServerCommand(normalizedConfig) {
+  const explicitCommand = normalizedConfig?.target?.supportedLocalCommand;
+  if (explicitCommand) {
+    return explicitCommand;
+  }
 
-  // Check for config files
-  for (const fw of frameworks) {
-    for (const file of fw.files) {
-      if (fs.existsSync(path.join(process.cwd(), file))) {
-        return { framework: fw.name, detected: true };
-      }
-    }
+  if (normalizedConfig?.target?.tier === "certified") {
+    return "npm run build && npm run start";
   }
 
-  // Check package.json for deps
-  try {
-    const pkg = fs.readJsonSync(path.join(process.cwd(), "package.json"));
-    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+  return null;
+}
 
-    for (const fw of frameworks) {
-      for (const dep of fw.deps) {
-        if (allDeps[dep]) {
-          return { framework: fw.name, detected: true };
-        }
-      }
-    }
-  } catch {
-    // No package.json
+function getNextRecommendedCommand(mode, useCloud) {
+  if (mode === "certified-target" || mode === "candidate-target") {
+    return "reshot doctor target";
   }
 
-  return { framework: null, detected: false };
+  return useCloud ? "reshot publish" : "reshot run";
 }
 
-/**
- * Count documentation files in a directory
- */
-function countDocFiles(dir) {
-  if (!fs.existsSync(dir)) return 0;
-
-  let count = 0;
-  function walk(d) {
-    for (const item of fs.readdirSync(d)) {
-      const full = path.join(d, item);
-      if (fs.statSync(full).isDirectory()) {
-        if (!item.startsWith(".") && item !== "node_modules") walk(full);
-      } else if (item.endsWith(".md") || item.endsWith(".mdx")) {
-        count++;
-      }
-    }
-  }
-  walk(dir);
-  return count;
+function writeSetupReport({
+  mode,
+  useCloud,
+  projectId,
+  projectName,
+  configCreated,
+  playwrightDetected,
+  supportedLocalCommand,
+}) {
+  const reportPath = path.join(
+    process.cwd(),
+    ".reshot",
+    "reports",
+    "self-serve-setup.json",
+  );
+
+  fs.ensureDirSync(path.dirname(reportPath));
+  fs.writeJSONSync(
+    reportPath,
+    {
+      generatedAt: new Date().toISOString(),
+      mode,
+      nextRecommendedCommand: getNextRecommendedCommand(mode, useCloud),
+      useCloud,
+      projectId: projectId || null,
+      projectName: projectName || null,
+      configCreated,
+      playwrightDetected,
+      supportedEnvironment: {
+        launchSupported: "production-like localhost",
+        launchUnsupported: ["next dev"],
+        supportedLocalCommand: supportedLocalCommand || null,
+      },
+      blockingIssues: [],
+      advisories: [
+        "Run your target app with a production-like local server for launch-grade captures.",
+      ],
+      nextMilestones: [
+        "reshot setup",
+        "reshot run",
+        ...(useCloud ? ["reshot publish"] : []),
+      ],
+    },
+    { spaces: 2 },
+  );
+
+  return reportPath;
 }
 
 /**
  * Main setup wizard
  */
 async function setupWizard(options = {}) {
-  const { offline = false, force = false } = options;
+  const {
+    offline = false,
+    force = false,
+    noStudio = false,
+    project: linkedProjectId,
+    token: linkedToken,
+  } = options;
 
-  console.log(chalk.cyan.bold("\n🚀 Reshot Setup Wizard\n"));
-  console.log(chalk.gray("Let's configure Reshot for your project.\n"));
+  console.log(chalk.cyan.bold("\n🚀 Reshot Setup\n"));
 
   // Detect project context
-  const gitInfo = detectGitInfo();
   const playwrightInfo = detectPlaywright();
-  const existingDocsRoot = detectDocumentationRoot();
 
   // Check existing setup
   let existingSettings = null;
@@ -292,8 +198,55 @@ async function setupWizard(options = {}) {
     // No existing config
   }
 
-  // If already set up and not forcing, confirm continue
-  if ((isAlreadyAuthed || existingConfig) && !force) {
+  let didLinkFromOptions = false;
+  if (linkedProjectId && linkedToken && !offline) {
+    const authCommand = require("./auth");
+    const authResult = await authCommand({
+      projectId: linkedProjectId,
+      apiKey: linkedToken,
+    });
+    existingSettings = config.readSettings();
+    isAlreadyAuthed = !!(
+      existingSettings?.apiKey && existingSettings?.projectId
+    );
+    didLinkFromOptions = true;
+    console.log(
+      chalk.green("\n✔ Connected to"),
+      chalk.cyan(existingSettings.projectName || existingSettings.projectId),
+    );
+    if (authResult?.mode) {
+      console.log(chalk.gray(`  Mode: ${authResult.mode}`));
+    }
+  } else if (linkedProjectId && !linkedToken && !offline) {
+    console.log(
+      chalk.gray(
+        `Setup will target project ${linkedProjectId}. Complete browser authentication when prompted.`,
+      ),
+    );
+  }
+
+  // The interactive wizard below needs a TTY. In CI / piped-stdin contexts
+  // (and when no `--project/--token` were supplied to drive it non-
+  // interactively), bail out with clear guidance instead of letting inquirer
+  // throw an unhandled `ERR_USE_AFTER_CLOSE: readline` (audit run-11 F4).
+  if (!isInteractive() && !didLinkFromOptions) {
+    console.log(
+      chalk.yellow("\n⚠ Non-interactive environment detected (no TTY)."),
+    );
+    console.log(
+      chalk.gray("  Run setup with your project credentials instead:"),
+    );
+    console.log(
+      chalk.cyan("    npx reshot setup --project <projectId> --token <token>"),
+    );
+    console.log(
+      chalk.gray("  or set RESHOT_PROJECT_ID and RESHOT_API_KEY, then re-run.\n"),
+    );
+    return;
+  }
+
+  // If already set up and not forcing, show status and offer options
+  if ((isAlreadyAuthed || existingConfig) && !force && !didLinkFromOptions) {
     console.log(
       chalk.yellow("⚠ Reshot is already configured in this project.\n"),
     );
@@ -307,20 +260,39 @@ async function setupWizard(options = {}) {
     if (existingConfig) {
       console.log(
         chalk.green("  ✔ Config found:"),
-        chalk.cyan("docsync.config.json"),
+        chalk.cyan("reshot.config.json"),
       );
     }
 
-    const { continueSetup } = await inquirer.prompt([
+    const choices = [];
+
+    if (isAlreadyAuthed) {
+      choices.push({
+        name: "Re-authenticate (connect to a different project)",
+        value: "reauth",
+      });
+    }
+
+    choices.push({
+      name: "Reconfigure (regenerate reshot.config.json)",
+      value: "reconfig",
+    });
+
+    choices.push({
+      name: "Exit",
+      value: "exit",
+    });
+
+    const { action } = await inquirer.prompt([
       {
-        type: "confirm",
-        name: "continueSetup",
-        message: "Would you like to reconfigure?",
-        default: false,
+        type: "list",
+        name: "action",
+        message: "What would you like to do?",
+        choices,
       },
     ]);
 
-    if (!continueSetup) {
+    if (action === "exit") {
       console.log(
         chalk.gray("\nRun"),
         chalk.cyan("reshot studio"),
@@ -328,19 +300,50 @@ async function setupWizard(options = {}) {
       );
       return;
     }
+
+    if (action === "reauth") {
+      console.log(chalk.gray("\nOpening browser for authentication...\n"));
+      const authCommand = require("./auth");
+      const authResult = await authCommand();
+
+      // Re-read settings after auth
+      try {
+        existingSettings = config.readSettings();
+        isAlreadyAuthed = !!(
+          existingSettings?.apiKey && existingSettings?.projectId
+        );
+      } catch {
+        throw new Error("Authentication failed. Please try again.");
+      }
+
+      if (!isAlreadyAuthed) {
+        throw new Error("Authentication was not completed.");
+      }
+
+      console.log(
+        chalk.green("\n✔ Connected to"),
+        chalk.cyan(existingSettings.projectName || existingSettings.projectId),
+      );
+      if (authResult?.mode) {
+        console.log(chalk.gray(`  Mode: ${authResult.mode}`));
+      }
+      console.log(
+        chalk.gray("\nRun"),
+        chalk.cyan("reshot studio"),
+        chalk.gray("to manage your visuals.\n"),
+      );
+      return;
+    }
+
+    // action === "reconfig" — fall through to config generation below
   }
 
   // ========================================
   // STEP 1: Platform Connection
   // ========================================
-  console.log(chalk.cyan("\n━━━ Step 1: Platform Connection ━━━\n"));
+  if (!isAlreadyAuthed && !offline) {
+  console.log(chalk.cyan("\n━━━ Step 1: Choose Your Lane ━━━\n"));
 
-  let useCloud = false;
-  let projectId = existingSettings?.projectId;
-  let apiKey = existingSettings?.apiKey;
-  let projectName = existingSettings?.projectName;
-
-  if (!offline) {
     const { connectToCloud } = await inquirer.prompt([
       {
         type: "list",
@@ -348,33 +351,29 @@ async function setupWizard(options = {}) {
         message: "How would you like to use Reshot?",
         choices: [
           {
-            name: `${chalk.cyan("Connect to Reshot Cloud")} - Governance, CDN hosting, team collaboration`,
+            name: `${chalk.cyan("Set up hosted pipeline")} - Connect to Reshot Cloud for hosted assets, review workflows, and team collaboration`,
             value: true,
           },
           {
-            name: `${chalk.gray("Offline mode")} - Local-only visuals (no cloud sync)`,
+            name: `${chalk.gray("Start locally")} - Get a first capture working on your machine before you add hosted delivery`,
             value: false,
           },
         ],
-        default: isAlreadyAuthed ? 0 : 1,
       },
     ]);
 
-    useCloud = connectToCloud;
-
-    if (useCloud && !isAlreadyAuthed) {
+    if (connectToCloud) {
       console.log(chalk.gray("\nOpening browser for authentication...\n"));
 
       const authCommand = require("./auth");
-      await authCommand();
+      const authResult = await authCommand();
 
       // Re-read settings after auth
       try {
         existingSettings = config.readSettings();
-        projectId = existingSettings?.projectId;
-        apiKey = existingSettings?.apiKey;
-        projectName = existingSettings?.projectName;
-        isAlreadyAuthed = !!(apiKey && projectId);
+        isAlreadyAuthed = !!(
+          existingSettings?.apiKey && existingSettings?.projectId
+        );
       } catch {
         throw new Error("Authentication failed. Please try again.");
       }
@@ -385,105 +384,46 @@ async function setupWizard(options = {}) {
 
       console.log(
         chalk.green("\n✔ Connected to"),
-        chalk.cyan(projectName || projectId),
+        chalk.cyan(existingSettings.projectName || existingSettings.projectId),
       );
-    } else if (useCloud && isAlreadyAuthed) {
+      if (authResult?.mode) {
+        console.log(chalk.gray(`  Mode: ${authResult.mode}`));
+      }
+    } else {
       console.log(
-        chalk.green("✔ Already connected to"),
-        chalk.cyan(projectName || projectId),
+        chalk.gray(
+          "Running in local-only mode — hosted publish and pull stay unavailable until you run `reshot auth`.",
+        ),
       );
     }
-  } else {
-    console.log(chalk.gray("Running in offline mode - no cloud sync."));
+  } else if (offline) {
+    console.log(
+      chalk.gray(
+        "Running in local-only mode — hosted publish and pull stay unavailable until you run `reshot auth`.",
+      ),
+    );
   }
 
-  // ========================================
-  // STEP 2: Feature Selection
-  // ========================================
-  console.log(chalk.cyan("\n━━━ Step 2: Features ━━━\n"));
-
-  const { features } = await inquirer.prompt([
-    {
-      type: "checkbox",
-      name: "features",
-      message: "Which features would you like to enable?",
-      choices: [
-        {
-          name: "Visual capture from Playwright tests",
-          value: "visuals",
-          checked: playwrightInfo.hasPlaywright,
-        },
-        {
-          name: "Documentation sync (detect drift, auto-update docs)",
-          value: "docsync",
-          checked: !!existingDocsRoot,
-        },
-      ],
-      validate: (answers) => {
-        if (answers.length === 0) {
-          return "Please select at least one feature";
-        }
-        return true;
-      },
-    },
-  ]);
-
-  const enableVisuals = features.includes("visuals");
-  const enableDocSync = features.includes("docsync");
+  const useCloud = isAlreadyAuthed;
+  const projectId = existingSettings?.projectId;
+  const normalizedSetupConfig = normalizeConfigContract(
+    existingConfig && typeof existingConfig === "object" ? existingConfig : {},
+  );
+  const supportedLocalCommand =
+    getRecommendedLocalServerCommand(normalizedSetupConfig);
 
   // ========================================
-  // STEP 3: Visuals Configuration (if enabled)
+  // STEP 2: Project Defaults
   // ========================================
-  let traceDir = "./test-results";
-  let journeyMappings = {};
-
-  if (enableVisuals) {
-    console.log(chalk.cyan("\n━━━ Step 3: Visual Capture ━━━\n"));
+  console.log(chalk.cyan("\n━━━ Step 2: Project Defaults ━━━\n"));
 
-    if (playwrightInfo.hasPlaywright) {
-      console.log(chalk.green("✔ Playwright detected"));
-      if (playwrightInfo.configFile) {
-        console.log(chalk.gray(`  Config: ${playwrightInfo.configFile}`));
-      }
+  let traceDir = "./test-results";
 
-      // Offer to import existing tests
-      const { importTests } = await inquirer.prompt([
-        {
-          type: "confirm",
-          name: "importTests",
-          message:
-            "Import existing Playwright tests to create journey mappings?",
-          default: true,
-        },
-      ]);
-
-      if (importTests) {
-        console.log(chalk.gray("\nScanning Playwright tests..."));
-        try {
-          const importTestsCommand = require("./import-tests");
-          const result = await importTestsCommand({
-            interactive: false,
-            dryRun: false,
-          });
-          if (result?.journeyMappings) {
-            journeyMappings = result.journeyMappings;
-            console.log(
-              chalk.green(
-                `✔ Imported ${Object.keys(journeyMappings).length} journey mapping(s)`,
-              ),
-            );
-          }
-        } catch (err) {
-          console.log(chalk.yellow(`⚠ Could not import tests: ${err.message}`));
-        }
-      }
-    } else {
-      console.log(chalk.yellow("⚠ Playwright not detected"));
-      console.log(
-        chalk.gray("  Install with: npm install -D @playwright/test"),
-      );
+  if (playwrightInfo.hasPlaywright) {
+    console.log(chalk.green("✔ Playwright detected"));
+    if (playwrightInfo.configFile) {
+      console.log(chalk.gray(`  Config: ${playwrightInfo.configFile}`));
     }
-
     const { customTraceDir } = await inquirer.prompt([
       {
         type: "input",
@@ -494,253 +434,165 @@ async function setupWizard(options = {}) {
     ]);
 
     traceDir = customTraceDir;
+  } else {
+    console.log(chalk.green("✔ No Playwright setup detected"));
+    console.log(
+      chalk.gray(
+        "  That is okay for the local-first workflow. You can define or record scenarios and run them directly.",
+      ),
+    );
   }
 
   // ========================================
-  // STEP 4: Documentation Configuration (if enabled)
-  // ========================================
-  let docConfig = null;
-
-  if (enableDocSync) {
-    console.log(chalk.cyan("\n━━━ Step 4: Documentation Sync ━━━\n"));
-
-    // Check for existing documentation framework
-    const docFramework = detectDocumentationFramework();
-    let docsRoot = existingDocsRoot;
-
-    if (docFramework.detected) {
-      console.log(chalk.green(`✔ ${docFramework.framework} detected`));
-    }
-
-    if (docsRoot) {
-      const docCount = countDocFiles(path.join(process.cwd(), docsRoot));
-      console.log(
-        chalk.green(
-          `✔ Found documentation at: ${docsRoot}/ (${docCount} files)`,
-        ),
-      );
-
-      const { useDetected } = await inquirer.prompt([
-        {
-          type: "confirm",
-          name: "useDetected",
-          message: `Use ${docsRoot}/ for documentation sync?`,
-          default: true,
-        },
-      ]);
-
-      if (!useDetected) {
-        docsRoot = null;
-      }
-    }
-
-    if (!docsRoot) {
-      const choices = [
-        { name: "Create docs/ directory with examples", value: "scaffold" },
-        { name: "Specify existing directory path", value: "specify" },
-      ];
-
-      // Add Astro Starlight option if not already a docs framework
-      if (!docFramework.detected) {
-        choices.push({
-          name:
-            chalk.cyan("Create Astro Starlight project") +
-            chalk.gray(" (recommended for new docs)"),
-          value: "starlight",
-        });
-      }
-
-      const { docAction } = await inquirer.prompt([
-        {
-          type: "list",
-          name: "docAction",
-          message: "Documentation setup:",
-          choices,
-        },
-      ]);
-
-      if (docAction === "scaffold") {
-        console.log(chalk.gray("\nCreating docs/ directory..."));
-        docsRoot = await scaffoldDocumentation();
-        console.log(chalk.green("✔ Created docs/ with example files"));
-      } else if (docAction === "starlight") {
-        console.log(chalk.cyan("\nTo create an Astro Starlight project:\n"));
-        console.log(
-          chalk.white("  npm create astro@latest -- --template starlight"),
-        );
-        console.log(
-          chalk.gray(
-            "\nRun that command, then re-run reshot setup to link it.\n",
-          ),
-        );
-
-        // Still create a basic docs folder as fallback
-        const { createBasic } = await inquirer.prompt([
-          {
-            type: "confirm",
-            name: "createBasic",
-            message: "Create a basic docs/ folder for now?",
-            default: true,
-          },
-        ]);
-
-        if (createBasic) {
-          docsRoot = await scaffoldDocumentation();
-          console.log(chalk.green("✔ Created docs/ with example files"));
-        }
-      } else {
-        const { customPath } = await inquirer.prompt([
-          {
-            type: "input",
-            name: "customPath",
-            message: "Documentation directory path:",
-            default: "./docs",
-            validate: (input) => {
-              const fullPath = path.join(process.cwd(), input);
-              if (!fs.existsSync(fullPath)) {
-                return `Directory ${input} does not exist. Create it first or use scaffolding.`;
-              }
-              return true;
-            },
-          },
-        ]);
-        docsRoot = customPath;
-      }
-    }
-
-    // Determine strategy
-    let strategy = "git_pr";
-
-    if (useCloud && docsRoot) {
-      if (gitInfo.isGitHub) {
-        console.log(chalk.green("\n✔ GitHub repository detected"));
-        const { useGitPR } = await inquirer.prompt([
-          {
-            type: "confirm",
-            name: "useGitPR",
-            message: "Auto-create Pull Requests for documentation updates?",
-            default: true,
-          },
-        ]);
-        strategy = useGitPR ? "git_pr" : "external_host";
-      } else {
-        const { strategyChoice } = await inquirer.prompt([
-          {
-            type: "list",
-            name: "strategyChoice",
-            message: "How should documentation updates be delivered?",
-            choices: [
-              { name: "Git Pull Requests", value: "git_pr" },
-              {
-                name: "Notifications only (external CMS)",
-                value: "external_host",
-              },
-            ],
-          },
-        ]);
-        strategy = strategyChoice;
-      }
-    }
-
-    docConfig = generateDocumentationConfig(docsRoot, strategy);
-  }
-
-  // ========================================
-  // STEP 5: Generate Configuration
+  // Generate Configuration
   // ========================================
   console.log(chalk.cyan("\n━━━ Generating Configuration ━━━\n"));
 
   const newConfig = {
-    $schema: "https://reshot.dev/schemas/docsync-config.json",
+    $schema: "https://reshot.dev/schemas/reshot-config.json",
     version: "2.0",
     baseUrl: existingConfig?.baseUrl || "http://localhost:3000",
     viewport: existingConfig?.viewport || { width: 1280, height: 720 },
-    _metadata: {
-      features: {
-        visuals: enableVisuals,
-        docsync: enableDocSync,
-      },
-    },
   };
 
   if (useCloud && projectId) {
     newConfig.projectId = projectId;
   }
 
-  if (enableVisuals) {
-    newConfig.visuals = {
-      traceDir,
-      journeyMappings:
-        Object.keys(journeyMappings).length > 0 ? journeyMappings : undefined,
-    };
-
-    if (!useCloud) {
-      const { customAssetDir } = await inquirer.prompt([
-        {
-          type: "input",
-          name: "customAssetDir",
-          message: "Where should screenshots be saved?",
-          default: ".reshot/output",
-        },
-      ]);
-      newConfig.assetDir = customAssetDir;
-    } else {
-      newConfig.assetDir = ".reshot/output";
-    }
+  newConfig.visuals = {
+    traceDir,
+  };
 
-    newConfig.scenarios = existingConfig?.scenarios || [];
+  if (!useCloud) {
+    const { customAssetDir } = await inquirer.prompt([
+      {
+        type: "input",
+        name: "customAssetDir",
+        message: "Where should screenshots be saved?",
+        default: ".reshot/output",
+      },
+    ]);
+    newConfig.assetDir = customAssetDir;
+  } else {
+    newConfig.assetDir = ".reshot/output";
   }
 
-  if (enableDocSync && docConfig) {
-    newConfig.documentation = docConfig;
-  }
+  newConfig.scenarios = existingConfig?.scenarios || [];
 
   // Write configuration
   config.writeConfig(newConfig);
-  console.log(chalk.green("✔ Created docsync.config.json"));
+  console.log(chalk.green("✔ Created reshot.config.json"));
+
+  const combinedConfig =
+    existingConfig && typeof existingConfig === "object"
+      ? { ...existingConfig, ...newConfig }
+      : newConfig;
+  const normalizedCombinedConfig = normalizeConfigContract(combinedConfig);
+  const setupMode = detectSetupMode(combinedConfig, useCloud);
+  const finalSupportedLocalCommand =
+    getRecommendedLocalServerCommand(normalizedCombinedConfig) ||
+    supportedLocalCommand;
+  const reportPath = writeSetupReport({
+    mode: setupMode,
+    useCloud,
+    projectId,
+    projectName: existingSettings?.projectName,
+    configCreated: true,
+    playwrightDetected: playwrightInfo.hasPlaywright,
+    supportedLocalCommand: finalSupportedLocalCommand,
+  });
 
   // ========================================
-  // STEP 6: Success & Next Steps
+  // Success & Next Steps
   // ========================================
   console.log(chalk.green("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
   console.log(chalk.green.bold("✔ Reshot setup complete!"));
   console.log(chalk.green("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
 
-  console.log(chalk.cyan("Next steps:\n"));
+  console.log(chalk.cyan("Supported launch path:\n"));
+  console.log(
+    `  ${chalk.gray("Run your target app with a production-like local server before capture.")}`,
+  );
+  console.log(
+    `     ${chalk.cyan(finalSupportedLocalCommand || "npm run build && npm run start")}`,
+  );
+  console.log(
+    `  ${chalk.gray("Unsupported for launch reliability:")} ${chalk.yellow("next dev")}\n`,
+  );
 
+  console.log(chalk.cyan("Setup mode:\n"));
+  console.log(`  ${chalk.green(setupMode)}\n`);
+
+  console.log(chalk.cyan("Next steps:\n"));
+  console.log(
+    `  1. ${chalk.gray("Review")} ${chalk.cyan("reshot.config.json")} ${chalk.gray("and add your first scenario or recording")}`,
+  );
   console.log(
-    `  1. ${chalk.gray("Review")} ${chalk.cyan("docsync.config.json")} ${chalk.gray("and commit to your repo")}`,
+    `  2. ${chalk.gray("Start your app in the supported environment:")}`,
   );
+  console.log(
+    `     ${chalk.cyan(finalSupportedLocalCommand || "npm run build && npm run start")}`,
+  );
+  console.log(`  3. ${chalk.gray("Generate your first local capture:")}`);
+  console.log(`     ${chalk.cyan("reshot run")}`);
 
-  if (enableVisuals) {
+  if (useCloud) {
     console.log(
-      `  2. ${chalk.gray("Run Playwright tests to generate traces:")}`,
+      `\n  4. ${chalk.gray("Upgrade to hosted assets when you are ready:")}`,
     );
-    console.log(`     ${chalk.cyan("npx playwright test")}`);
+    console.log(`     ${chalk.cyan("reshot publish")}`);
+  } else {
+    console.log(
+      `\n  4. ${chalk.gray("Connect hosted delivery later when you are ready:")}`,
+    );
+    console.log(`     ${chalk.cyan("reshot auth")}`);
   }
 
-  if (enableDocSync) {
+  if (setupMode === "certified-target" || setupMode === "candidate-target") {
     console.log(
-      `  ${enableVisuals ? "3" : "2"}. ${chalk.gray("Add")} ${chalk.cyan("reshot_journey")} ${chalk.gray("frontmatter to your markdown files")}`,
+      `\n  5. ${chalk.gray("Use advanced target checks when you need them:")}`,
     );
+    console.log(`     ${chalk.cyan("reshot doctor target")}`);
+    console.log(`     ${chalk.cyan("reshot verify publish")}`);
+    if (setupMode === "certified-target") {
+      console.log(`     ${chalk.cyan("reshot certify")}`);
+    }
+  }
+
+  console.log(`\n  ${chalk.gray("Open Studio to inspect output locally:")}`);
+  console.log(`     ${chalk.cyan("reshot studio")}`);
+  console.log(
+    `\n  ${chalk.gray("Supported environments guide:")} ${chalk.cyan("https://reshot.dev/docs/cli/getting-started/supported-environments")}`,
+  );
+  console.log(
+    `\n  ${chalk.gray("Setup report written to:")} ${chalk.cyan(path.relative(process.cwd(), reportPath))}\n`,
+  );
+
+  if (noStudio) {
     console.log(
-      `     ${chalk.gray('Example: reshot_journey: "auth/login-flow"')}`,
+      chalk.gray("Studio launch skipped. Run `reshot studio` when you want the local UI.\n"),
     );
+    return;
   }
 
-  console.log(`\n  ${chalk.gray("Sync visuals and docs to Reshot:")}`);
-  console.log(`     ${chalk.cyan("reshot sync")}`);
-
-  console.log(`\n  ${chalk.gray("Launch the visual management UI:")}`);
-  console.log(`     ${chalk.cyan("reshot studio")}\n`);
+  // Offer to launch studio. In non-interactive environments (CI, piped stdin)
+  // an inquirer prompt throws `ERR_USE_AFTER_CLOSE: readline`, so skip the
+  // prompt and auto-answer the safe default (do NOT launch Studio).
+  if (!isInteractive()) {
+    console.log(
+      chalk.gray(
+        "Non-interactive environment detected — skipping Studio launch. Run `reshot studio` when you want the local UI.\n",
+      ),
+    );
+    return;
+  }
 
-  // Offer to launch studio
   const { launchStudio } = await inquirer.prompt([
     {
       type: "confirm",
       name: "launchStudio",
       message: "Launch Reshot Studio now?",
-      default: true,
+      default: false,
     },
   ]);