refactor: Address PR review comments

- Fix docs: Change 'craft prepare auto' to 'craft prepare' in quick example
- Merge first release logic with version calculation:
  - Use default bump type (minor) instead of hardcoded version
  - Allow explicit bump types to work for first release (e.g., major -> 1.0.0)
  - More consistent code flow

Author: BYK

docs/src/content/docs/index.mdx

@@ -50,7 +50,7 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 craft init
 
 # Auto-determine version from conventional commits
-craft prepare auto
+craft prepare
 
 # Or specify a bump type
 craft prepare minor

src/__tests__/prepare-dry-run.e2e.test.ts

@@ -586,10 +586,12 @@ targets: []
 
     const combinedOutput = stdout + stderr;
 
-    // Should detect first release and default to 0.1.0
+    // Should detect first release and default to 0.1.0 (minor bump from 0.0.0)
     expect(combinedOutput).toContain('No previous releases found');
     expect(combinedOutput).toContain('first release');
-    expect(combinedOutput).toContain('default first version: 0.1.0');
+    expect(combinedOutput).toContain(
+      'default bump type for first release: minor',
+    );
     expect(combinedOutput).toContain('Releasing version 0.1.0');
     expect(combinedOutput).toContain('release/0.1.0');
   }, 60000);

src/commands/prepare.ts

@@ -67,8 +67,8 @@ const DEFAULT_BUMP_VERSION_PATH = join('scripts', 'bump-version.sh');
 /** Minimum craft version required for auto-versioning */
 const AUTO_VERSION_MIN_VERSION = '2.14.0';
 
-/** Default version for first release when no tags exist */
-const DEFAULT_FIRST_VERSION = '0.1.0';
+/** Default bump type for first release when using auto-versioning */
+const DEFAULT_FIRST_RELEASE_BUMP: BumpType = 'minor';
 
 export const builder: CommandBuilder = (yargs: Argv) =>
   yargs
@@ -601,30 +601,37 @@ async function resolveVersion(
     }
 
     const latestTag = await getLatestTag(git);
+    const isFirstRelease = !latestTag;
 
-    // Handle first release (no existing tags)
-    if (!latestTag) {
+    if (isFirstRelease) {
       logger.info(
         `No previous releases found. This appears to be the first release.`,
       );
-      logger.info(`Using default first version: ${DEFAULT_FIRST_VERSION}`);
-      return DEFAULT_FIRST_VERSION;
     }
 
     // Determine bump type - either from arg or from commit analysis
     let bumpType: BumpType;
     if (version === 'auto') {
-      const changelogResult = await getChangelogWithBumpType(git, latestTag);
-      validateBumpType(changelogResult);
-      bumpType = changelogResult.bumpType;
+      if (isFirstRelease) {
+        // For first release with auto, default to minor bump (0.0.0 -> 0.1.0)
+        logger.info(
+          `Using default bump type for first release: ${DEFAULT_FIRST_RELEASE_BUMP}`,
+        );
+        bumpType = DEFAULT_FIRST_RELEASE_BUMP;
+      } else {
+        const changelogResult = await getChangelogWithBumpType(git, latestTag);
+        validateBumpType(changelogResult);
+        bumpType = changelogResult.bumpType;
+      }
     } else {
       bumpType = version as BumpType;
     }
 
-    // Calculate new version from latest tag
-    const currentVersion = latestTag.replace(/^v/, '').match(/^\d/)
-      ? latestTag.replace(/^v/, '')
-      : '0.0.0';
+    // Calculate new version from latest tag (or 0.0.0 for first release)
+    const currentVersion =
+      latestTag && latestTag.replace(/^v/, '').match(/^\d/)
+        ? latestTag.replace(/^v/, '')
+        : '0.0.0';
 
     const newVersion = calculateNextVersion(currentVersion, bumpType);
     logger.info(