feat(create): ask setup questions after the create-xxx CLI runs

Author: liangmiQwQ

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_remote_generated_setup/mock-manifest.json

@@ -0,0 +1,21 @@
+{
+  "create-vp-test-generated-setup": {
+    "name": "create-vp-test-generated-setup",
+    "dist-tags": {
+      "latest": "1.0.0"
+    },
+    "versions": {
+      "1.0.0": {
+        "name": "create-vp-test-generated-setup",
+        "version": "1.0.0",
+        "bin": {
+          "create-vp-test-generated-setup": "index.cjs"
+        },
+        "dist": {
+          "tarball": "{REGISTRY}/create-vp-test-generated-setup/-/create-vp-test-generated-setup-1.0.0.tgz",
+          "integrity": "sha512-eg95ZfZTfRmqgWms3s+wI5sd8Jl9lMMYWcHsfWtdKKP2hEeIpWUlHAuELDWc/3vyUi8KZDB6edDGwZtIZ2w+Zw=="
+        }
+      }
+    }
+  }
+}

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_remote_generated_setup/snapshots.toml

@@ -0,0 +1,19 @@
+# The fake `create-vp-test-generated-setup` CLI writes AGENTS.md and
+# .vscode/settings.json and runs `git init`, so the setup prompts that follow
+# it must react to those files.
+[[case]]
+name = "create_remote_generated_setup"
+vp = "local"
+steps = [
+  { argv = ["vp", "create", "vp-test-generated-setup", "--package-manager", "pnpm", "--", "my-app"], comment = "after the create CLI: no git prompt, a hooks prompt, then append/skip for the generated AGENTS.md", snapshot = false, continue-on-failure = true, interactions = [
+    { "expect-milestone" = "confirm:confirm:yes" },
+    { "write-key" = "enter" },
+    { "expect-milestone" = "select:select:1" },
+    { "write-key" = "up" },
+    { "expect-milestone" = "select:select:0" },
+    { "write-key" = "enter" },
+  ] },
+  { argv = ["vpt", "grep-file", "my-app/AGENTS.md", "<!--VITE PLUS START-->"], comment = "Vite+ instructions are appended to the generated AGENTS.md", continue-on-failure = true },
+  { argv = ["vpt", "print-file", "my-app/.vscode/settings.json"], comment = "generated editor config is merged without a prompt", continue-on-failure = true },
+  { argv = ["vpt", "stat-file", "my-app/.vite-hooks/pre-commit", "--assert", "file"], comment = "hooks are set up in the repository the create CLI initialized", continue-on-failure = true },
+]

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_remote_generated_setup/snapshots/create_remote_generated_setup.md

@@ -0,0 +1,53 @@
+# create_remote_generated_setup
+
+## `vp create vp-test-generated-setup --package-manager pnpm -- my-app`
+
+after the create CLI: no git prompt, a hooks prompt, then append/skip for the generated AGENTS.md
+
+
+## `vpt grep-file my-app/AGENTS.md '<'\!'--VITE PLUS START-->'`
+
+Vite+ instructions are appended to the generated AGENTS.md
+
+```
+my-app/AGENTS.md: found "<!--VITE PLUS START-->"
+```
+
+## `vpt print-file my-app/.vscode/settings.json`
+
+generated editor config is merged without a prompt
+
+```
+{
+  "editor.tabSize": 2,
+  "npm.scriptRunner": "vp",
+  "editor.defaultFormatter": "oxc.oxc-vscode",
+  "[javascript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "oxc.disableNestedConfig": true,
+  "oxc.fmt.disableNestedConfig": true,
+  "editor.formatOnSave": true,
+  "editor.formatOnSaveMode": "file",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.oxc": "explicit"
+  }
+}
+```
+
+## `vpt stat-file my-app/.vite-hooks/pre-commit --assert file`
+
+hooks are set up in the repository the create CLI initialized
+
+```
+my-app/.vite-hooks/pre-commit: file
+```

crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_remote_generated_setup/tarballs/create-vp-test-generated-setup-1.0.0.tgz

@@ -74,6 +74,8 @@ Vite+ ships with these built-in templates:
 
 Run `vp create --list` to see the built-in templates and the common shorthand templates Vite+ recognizes.
 
+A third-party template runs right after the package manager is chosen. `vp create` asks about agent instructions, editor configs, git, and commit hooks once the template finishes, based on the files it generated: an existing agent instructions file can be appended to or kept, existing editor configs are merged, and an existing git repository is reused.
+
 After a third-party template runs, `vp create` migrates the generated project to Vite+. When a standalone project already depends on `vite-plus`, `vp create` skips this migration and keeps the template's tooling choices.
 
 ## Options

docs/guide/create.md

@@ -732,45 +732,64 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
     ? formatLocalVpCommand(packageManager, 'vp run')
     : 'vp run';
 
-  const existingAgentTargetPaths =
-    options.agent !== undefined || !options.interactive
-      ? undefined
-      : detectExistingAgentTargetPaths(workspaceInfoOptional.rootDir);
-  if (existingAgentTargetPaths !== undefined) {
-    selectedAgentTargetPaths = existingAgentTargetPaths;
-  } else {
-    const agentSelection = await selectAgentTargets({
-      interactive: options.interactive,
-      agent: options.agent,
-      onCancel: () => cancelAndExit(),
-    });
-    selectedAgentTargetPaths = agentSelection.targetPaths;
-    shouldWriteCopilotSetupWorkflow = agentSelection.selectedAgents.some(
-      (agent) => agent.id === COPILOT_AGENT_ID,
-    );
-  }
-
   const shouldConfigureEditors = shouldConfigureEditorsForCreate({
     editor: options.editor,
     isMonorepo,
   });
-  if (shouldConfigureEditors) {
-    const existingEditors =
-      options.editor || !options.interactive
+
+  // Agent, editor, git and hook choices. Direct scaffolds ask up front. A
+  // `create-xxx` CLI asks after it ran (`generatedProjectPath`), so its own
+  // prompts come first and the answers reflect the files it generated.
+  let shouldSetupGit = false;
+  const resolveProjectSetup = async (generatedProjectPath?: string) => {
+    const agentInstructionsRoot =
+      generatedProjectPath && !isMonorepo ? generatedProjectPath : workspaceInfoOptional.rootDir;
+    const existingAgentTargetPaths =
+      options.agent !== undefined || !options.interactive
         ? undefined
-        : detectExistingEditors(workspaceInfoOptional.rootDir);
-    selectedEditors =
-      existingEditors ??
-      (await selectEditors({
+        : detectExistingAgentTargetPaths(agentInstructionsRoot);
+    if (existingAgentTargetPaths !== undefined) {
+      selectedAgentTargetPaths = existingAgentTargetPaths;
+    } else {
+      const agentSelection = await selectAgentTargets({
         interactive: options.interactive,
-        editor: options.editor,
+        agent: options.agent,
         onCancel: () => cancelAndExit(),
-      }));
-  }
+      });
+      selectedAgentTargetPaths = agentSelection.targetPaths;
+      shouldWriteCopilotSetupWorkflow = agentSelection.selectedAgents.some(
+        (agent) => agent.id === COPILOT_AGENT_ID,
+      );
+    }
+
+    if (shouldConfigureEditors) {
+      const existingEditors =
+        options.editor || !options.interactive
+          ? undefined
+          : detectExistingEditors(generatedProjectPath ?? workspaceInfoOptional.rootDir);
+      selectedEditors =
+        existingEditors ??
+        (await selectEditors({
+          interactive: options.interactive,
+          editor: options.editor,
+          onCancel: () => cancelAndExit(),
+        }));
+    }
 
-  const shouldSetupGit = await resolveGitInit(options, isMonorepo);
-  if (!isMonorepo && (!options.interactive || shouldSetupGit || options.hooks === true)) {
-    shouldSetupHooks = await promptGitHooks(options);
+    // A `create-xxx` CLI may have initialized the repository itself.
+    const hasGitRepository =
+      generatedProjectPath !== undefined && fs.existsSync(path.join(generatedProjectPath, '.git'));
+    shouldSetupGit = !hasGitRepository && (await resolveGitInit(options, isMonorepo));
+    if (
+      !isMonorepo &&
+      (!options.interactive || hasGitRepository || shouldSetupGit || options.hooks === true)
+    ) {
+      shouldSetupHooks = await promptGitHooks(options);
+    }
+  };
+
+  if (isDirectScaffoldTemplate) {
+    await resolveProjectSetup();
   }
 
   const createProgress =
@@ -1079,6 +1098,9 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
   }
 
   const fullPath = path.join(workspaceInfo.rootDir, projectDir);
+  if (!isDirectScaffoldTemplate) {
+    await resolveProjectSetup(fullPath);
+  }
 
   // Register a scaffolded generator in `create.templates` so it appears in the
   // `vp create` picker (and resolves by name) without a manual config edit.
@@ -1140,7 +1162,8 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
     await writeEditorConfigs({
       projectRoot: fullPath,
       editorId: selectedEditors,
-      interactive: options.interactive,
+      // Editor configs a `create-xxx` CLI generated are merged without asking per file.
+      interactive: options.interactive && isDirectScaffoldTemplate,
       silent: compactOutput,
       extraVsCodeSettings: { 'npm.scriptRunner': 'vp' },
       packageManager,