chore: Update smart defaults minVersion from 2.20.0 to 2.21.0

Updates all references to the smart defaults minimum version across
source code, tests, and documentation.

Author: BYK

docs/src/content/docs/configuration.md

@@ -487,21 +487,21 @@ minVersion: '0.5.0'
 
 ### Smart Defaults
 
-Setting `minVersion` to `2.20.0` or higher enables smart defaults that simplify configuration:
+Setting `minVersion` to `2.21.0` or higher enables smart defaults that simplify configuration:
 
 ```yaml
-minVersion: '2.20.0'
+minVersion: '2.21.0'
 ```
 
-| Feature             | Default with `minVersion >= 2.20.0` | Default without |
+| Feature             | Default with `minVersion >= 2.21.0` | Default without |
 | ------------------- | ----------------------------------- | --------------- |
 | `changelog.policy`  | `auto`                              | `none`          |
 | `versioning.policy` | `auto` (with `>= 2.14.0`)           | `manual`        |
 
 This means a minimal configuration like this:
 
 ```yaml
-minVersion: '2.20.0'
+minVersion: '2.21.0'
 targets:
   - name: npm
   - name: github
@@ -514,7 +514,7 @@ Will automatically:
 - Create `CHANGELOG.md` if it doesn't exist
 
 :::tip[Recommended for New Projects]
-Use `minVersion: '2.20.0'` for new projects to take advantage of smart defaults.
+Use `minVersion: '2.21.0'` for new projects to take advantage of smart defaults.
 Run `craft init` to automatically generate this configuration.
 :::
 

docs/src/content/docs/getting-started.md

@@ -48,7 +48,7 @@ Example output:
 
 Proposed .craft.yml:
 ────────────────────────────────────────
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 targets:
   - name: npm
   - name: github
@@ -438,7 +438,7 @@ craft prepare  # Defaults to 0.1.0 for first release
 craft publish 0.1.0
 ```
 
-With smart defaults enabled (`minVersion: "2.20.0"`), Craft will:
+With smart defaults enabled (`minVersion: "2.21.0"`), Craft will:
 
 - Auto-detect version bumps from commits
 - Automatically generate changelogs

src/commands/__tests__/validate.test.ts

@@ -57,7 +57,7 @@ describe('validate command', () => {
 github:
   owner: getsentry
   repo: craft
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 targets:
   - name: github
 `,
@@ -170,7 +170,7 @@ targets:
 github:
   owner: getsentry
   repo: craft
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 targets:
   - name: npm
     id: npm-main
@@ -218,7 +218,7 @@ targets:
 github:
   owner: getsentry
   repo: craft
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 changelogPolicy: auto
 targets:
   - name: github
@@ -299,7 +299,7 @@ targets:
 github:
   owner: getsentry
   repo: craft
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 targets:
   - name: github
 `,
@@ -322,7 +322,7 @@ targets:
 github:
   owner: getsentry
   repo: craft
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 targets:
   - name: github
 `,
@@ -344,7 +344,7 @@ targets:
 github:
   owner: getsentry
   repo: craft
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 targets:
   - name: github
 `,
@@ -399,7 +399,7 @@ jobs:
 github:
   owner: getsentry
   repo: craft
-minVersion: "2.20.0"
+minVersion: "2.21.0"
 targets:
   - name: github
 `,

src/commands/validate.ts

@@ -152,9 +152,9 @@ function validateCraftConfig(configPath: string): ValidationIssue[] {
     });
   }
 
-  // Recommend minVersion >= 2.20.0 for smart defaults
+  // Recommend minVersion >= 2.21.0 for smart defaults
   const minVersion = rawConfig.minVersion as string | undefined;
-  const smartDefaultsVersion = '2.20.0';
+  const smartDefaultsVersion = '2.21.0';
   if (!minVersion) {
     issues.push({
       level: 'warning',

src/config.ts

@@ -248,7 +248,7 @@ export function requiresMinVersion(requiredVersion: string): boolean {
 const AUTO_VERSION_MIN_VERSION = '2.14.0';
 
 /** Minimum craft version required for smart defaults (auto changelog, etc.) */
-const SMART_DEFAULTS_MIN_VERSION = '2.20.0';
+const SMART_DEFAULTS_MIN_VERSION = '2.21.0';
 
 /**
  * Returns the effective versioning policy for the project.
@@ -427,13 +427,13 @@ const DEFAULT_CHANGELOG_FILE_PATH = 'CHANGELOG.md';
  * Handles both legacy `changelogPolicy` and new `changelog` object format.
  * Emits deprecation warning when using `changelogPolicy`.
  *
- * Smart defaults (when minVersion >= 2.20.0):
+ * Smart defaults (when minVersion >= 2.21.0):
  * - policy defaults to 'auto' instead of 'none'
  */
 export function getChangelogConfig(): NormalizedChangelogConfig {
   const config = getConfiguration();
 
-  // Default values - use smart defaults for minVersion >= 2.20.0
+  // Default values - use smart defaults for minVersion >= 2.21.0
   let filePath = DEFAULT_CHANGELOG_FILE_PATH;
   let policy = requiresMinVersion(SMART_DEFAULTS_MIN_VERSION)
     ? ChangelogPolicy.Auto

src/utils/__tests__/templates.test.ts

@@ -21,7 +21,7 @@ describe('Template Generation', () => {
       const yaml = generateCraftConfig(baseContext);
       const parsed = load(yaml) as Record<string, unknown>;
 
-      expect(parsed.minVersion).toBe('2.20.0');
+      expect(parsed.minVersion).toBe('2.21.0');
       expect(parsed.targets).toHaveLength(2);
     });
 

src/utils/templates.ts

@@ -52,7 +52,7 @@ export interface TemplateContext {
  */
 export function generateCraftConfig(context: TemplateContext): string {
   const config: Record<string, unknown> = {
-    minVersion: '2.20.0',
+    minVersion: '2.21.0',
   };
 
   // Sort targets by priority (already sorted from detection)