fix(create): show helpful error for unknown vite: templates (#1130)

### Linked issue

<!-- resolves # -->

resolves #1128 

###  Description

When an unknown template with a vite: prefix (e.g., vite:test) was
specified in the vp create command, the CLI would crash with an
unhandled ENOENT error instead of displaying a user-friendly error
message.

This happened because the vite:application command is rewritten to
create-vite@latest before being passed to subsequent logic.
Consequently, any vite:* command remaining at the fall-through stage is
inevitably an unknown command. By detecting this and implementing an
early return, we have prevented both the crash and the confusing error
message.

Additionally, this fix adds protection to the setPackageName call by
checking the exit code. This prevents the function from attempting to
read package.json from a directory that was never created.

### Manual Verification Results

Specifying an unknown template -> An error message is displayed

```bash
❯ vp create vite:test
Using default package name: remaining-very
"vite:test" is an unknown built-in template. Run vp create --list to see available templates.
```

Specifying an existing template -> Completes successfully (no
regression)

```bash
❯ vp create vite:library
VITE+ - Integrated toolchain for the web

◇ Package name:
  receive-weigh
◇ Select package manager to use:
  pnpm
...
◇ Finished scaffolding receive-weigh as a TypeScript library
• Node 24.14.0  pnpm 10.33.0
✓ Dependencies installed successfully (4.1s)
→ Next steps: cd receive-weigh && vp run dev
```

---------

Co-authored-by: MK (fengmk2) <fengmk2@gmail.com>

Author: naokihaba

packages/cli/src/create/__tests__/builtin.spec.ts

@@ -0,0 +1,66 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import { executeBuiltinTemplate } from '../templates/builtin.js';
+
+const { mockLogError } = vi.hoisted(() => ({ mockLogError: vi.fn() }));
+
+vi.mock('../templates/remote.js', () => ({
+  runRemoteTemplateCommand: vi.fn(),
+}));
+
+vi.mock('@voidzero-dev/vite-plus-prompts', () => ({
+  log: { error: mockLogError },
+}));
+
+const workspaceInfo = {
+  rootDir: '/tmp/workspace',
+} as any;
+
+const baseTemplateInfo = {
+  packageName: 'wage-meeting',
+  targetDir: 'wage-meeting',
+  args: [],
+  envs: {},
+  type: 'builtin' as any,
+  interactive: false,
+};
+
+describe('executeBuiltinTemplate', () => {
+  it('returns exitCode 1 for unknown vite: template', async () => {
+    const { runRemoteTemplateCommand } = await import('../templates/remote.js');
+
+    const result = await executeBuiltinTemplate(workspaceInfo, {
+      ...baseTemplateInfo,
+      command: 'vite:test',
+    });
+
+    expect(result.exitCode).toBe(1);
+    expect(runRemoteTemplateCommand).not.toHaveBeenCalled();
+  });
+
+  it('shows error message with template name and --list hint', async () => {
+    mockLogError.mockClear();
+
+    await executeBuiltinTemplate(workspaceInfo, {
+      ...baseTemplateInfo,
+      command: 'vite:unknown',
+    });
+
+    expect(mockLogError).toHaveBeenCalledOnce();
+    const message = mockLogError.mock.calls[0][0] as string;
+    expect(message).toContain('vite:unknown');
+    expect(message).toContain('vp create --list');
+  });
+
+  it('does not show error message in silent mode', async () => {
+    mockLogError.mockClear();
+
+    await executeBuiltinTemplate(
+      workspaceInfo,
+      { ...baseTemplateInfo, command: 'vite:test' },
+      { silent: true },
+    );
+
+    expect(mockLogError).not.toHaveBeenCalled();
+  });
+});

packages/cli/src/create/templates/builtin.ts

@@ -1,6 +1,9 @@
 import assert from 'node:assert';
 import path from 'node:path';
 
+import * as prompts from '@voidzero-dev/vite-plus-prompts';
+import colors from 'picocolors';
+
 import type { WorkspaceInfo } from '../../types/index.js';
 import type { ExecutionResult } from '../command.js';
 import { discoverTemplate } from '../discovery.js';
@@ -41,11 +44,24 @@ export async function executeBuiltinTemplate(
       false,
       options?.silent ?? false,
     );
+    if (result.exitCode !== 0) {
+      return { exitCode: result.exitCode };
+    }
     const fullPath = path.join(workspaceInfo.rootDir, templateInfo.targetDir);
     setPackageName(fullPath, templateInfo.packageName);
     return { ...result, projectDir: templateInfo.targetDir };
   }
 
+  // Unknown vite: template (e.g. vite:test) — application was already rewritten to create-vite@latest
+  if (templateInfo.command.startsWith('vite:')) {
+    if (!options?.silent) {
+      prompts.log.error(
+        `Unknown builtin template "${templateInfo.command}". Run ${colors.yellow('vp create --list')} to see available templates.`,
+      );
+    }
+    return { exitCode: 1 };
+  }
+
   // Handle remote/external templates with fspy monitoring
   const result = await runRemoteTemplateCommand(
     workspaceInfo,
@@ -54,6 +70,9 @@ export async function executeBuiltinTemplate(
     false,
     options?.silent ?? false,
   );
+  if (result.exitCode !== 0) {
+    return { exitCode: result.exitCode };
+  }
   const fullPath = path.join(workspaceInfo.rootDir, templateInfo.targetDir);
   // set package name in the project directory
   setPackageName(fullPath, templateInfo.packageName);