perf(eve): speed up fresh npm init

.changeset/quick-npm-init.md

@@ -0,0 +1,5 @@
+---
+"eve": patch
+---
+
+Speed up fresh standalone npm scaffolds by skipping npm's resolution of unused optional peer dependencies. Existing projects and ancestor workspaces retain normal peer dependency resolution.

packages/eve/src/cli/commands/init.integration.test.ts

@@ -706,6 +706,28 @@ describe("runInitCommand", () => {
     },
   );
 
+  it("keeps npm peer resolution for a fresh ancestor workspace member", async () => {
+    const workspaceRoot = await mkdtemp(join(tmpdir(), "eve-init-npm-workspace-member-"));
+    const appsDirectory = join(workspaceRoot, "apps");
+    await mkdir(appsDirectory, { recursive: true });
+    await writeFile(
+      join(workspaceRoot, "package.json"),
+      `${JSON.stringify({ private: true, workspaces: ["apps/*"] }, null, 2)}\n`,
+      "utf8",
+    );
+    await writeFile(join(workspaceRoot, "package-lock.json"), "", "utf8");
+    const output = logger();
+    const deps = dependencies();
+
+    await runInitCommand(output, appsDirectory, "my-agent", {}, deps);
+
+    expect(deps.runPackageManagerInstall).toHaveBeenCalledWith(
+      "npm",
+      join(appsDirectory, "my-agent"),
+      expect.objectContaining({ skipPeerDependencyResolution: false }),
+    );
+  });
+
   it("adds Web Chat to an npm-owned fresh scaffold without pnpm configuration", async () => {
     const parentDirectory = await mkdtemp(join(tmpdir(), "eve-init-agent-web-npm-"));
     const output = logger();
@@ -720,7 +742,7 @@ describe("runInitCommand", () => {
     expect(deps.runPackageManagerInstall).toHaveBeenCalledWith(
       "npm",
       projectPath,
-      expect.anything(),
+      expect.objectContaining({ skipPeerDependencyResolution: true }),
     );
     expect(deps.spawnPackageManager).toHaveBeenCalledWith("npm", projectPath, [
       "exec",
@@ -1019,7 +1041,7 @@ describe("runInitCommand", () => {
       expect(deps.runPackageManagerInstall).toHaveBeenCalledWith(
         kind,
         projectRoot,
-        expect.anything(),
+        expect.objectContaining({ skipPeerDependencyResolution: false }),
       );
       expect(deps.spawnPackageManager).toHaveBeenCalledWith(kind, projectRoot, [...devArguments]);
     },

packages/eve/src/cli/commands/init.ts

@@ -485,6 +485,7 @@ async function runInitSteps(input: {
         // The scaffold pins versions younger than typical release-age cooldown
         // windows; gating them would fail every fresh bootstrap.
         bypassMinimumReleaseAge: true,
+        skipPeerDependencyResolution: project.kind === "created" && !project.workspaceMember,
         progressDetails: process.stdout.isTTY === true && !debug,
         onOutput: (line) => {
           if (line.text.trim() !== "") {

packages/eve/src/setup/primitives/pm/npm.ts

@@ -9,6 +9,7 @@ export const npmPackageManager = {
   installArguments: (options) => [
     "install",
     ...(options.bypassMinimumReleaseAge === true ? ["--min-release-age=0"] : []),
+    ...(options.skipPeerDependencyResolution === true ? ["--legacy-peer-deps"] : []),
     ...(options.progressDetails === true ? ["--loglevel=silly"] : []),
   ],
   prepareArguments: (_projectRoot, args) => args,

packages/eve/src/setup/primitives/pm/types.ts

@@ -28,6 +28,8 @@ export interface PackageManagerInstallOptions {
   readonly bypassMinimumReleaseAge?: boolean;
   /** Resolves the project standalone even when an ancestor workspace exists. */
   readonly ignoreWorkspace?: boolean;
+  /** Skips peer dependency resolution for an eve-owned standalone scaffold when supported. */
+  readonly skipPeerDependencyResolution?: boolean;
   /** Requests verbose package-manager output for a live progress display. */
   readonly progressDetails?: boolean;
 }

packages/eve/src/setup/primitives/run-pnpm.test.ts

@@ -169,6 +169,22 @@ describe("runPackageManagerInstall", () => {
     );
   });
 
+  test("skips npm peer dependency resolution when requested", async () => {
+    expect(
+      packageManagerInstallSucceeded(
+        await runPackageManagerInstall("npm", "/tmp/app", {
+          skipPeerDependencyResolution: true,
+        }),
+      ),
+    ).toBe(true);
+
+    expect(mockedSpawn).toHaveBeenCalledWith(
+      "npm",
+      ["install", "--legacy-peer-deps"],
+      expect.objectContaining({ cwd: "/tmp/app" }),
+    );
+  });
+
   test("requests npm output before registry operations complete", async () => {
     expect(
       packageManagerInstallSucceeded(

packages/eve/test/scenarios/eve-init.scenario.test.ts

@@ -262,7 +262,7 @@ describe("eve init smoke", () => {
     await expect(pathExists(join(projectDir, "package-lock.json"))).resolves.toBe(true);
     expect(await fakeNpm.readCalls()).toEqual([
       {
-        args: ["install", "--min-release-age=0"],
+        args: ["install", "--min-release-age=0", "--legacy-peer-deps"],
         cwd: canonicalProjectDir,
       },
       {