Distillation

Date: Jul 21, 2026

• 🟡 (16:06) [tool-result] Assistant read src/commands/prepare.ts (part of todo item 3: "prepare command flow") — key structures found (file:line):
  • Imports include ConfigurationError, getVersion, isValidVersion from '../utils/version' (line 66).
  • Yargs option description: "a bump type ("major", "minor", or "patch"), "auto" to determine automatically" (line 89); another option "Do not check for changelog entries" (line 112).
  • Version validation error message template: Invalid version or version part specified: "${version}" (line 202).
  • logger.info(\Switched to branch "${branchName}"`);` (line 242) — logged after checking out a branch.
  • JSDoc comment (line 278): explains a function ensures "that stray working-tree changes are never swept in by accident." — related to a git-status-check helper (params start at line 249, includes @param git Local git client).
  • logger.info('Running automatic version bumping from targets...'); (line 363).
  • sysCommand = '/bin/bash'; set at line 408 (shell used for pre-release command execution).
  • JSDoc comment at line 459: "This function will never return: it terminates the process with the" [exit code] — precedes a process-exit helper; nearby config object at line 477 sets noMerge: false.
  • existsSync(relativePath) guard at line 545; default: switch case at line 591.
  • Comment at line 636: "// equals signs (at least 3 characters long)." — parsing changelog delimiter heuristic.
  • versionArg?: string; field (line 681); const config = getConfiguration(); (line 704).
  • Error message at line 727: CalVer versioning requires minVersion >= ${AUTO_VERSION_MIN_VERSION} in .craft.yml. — ties back to AUTO_VERSION_MIN_VERSION = '2.14.0' constant from config.ts noted earlier.
  • Version resolution logic at line 751: if (version === 'auto' || isBumpType(version)).
  • Fallback default version at line 775: const currentVersion = (latestTag && getVersion(latestTag)) || '0.0.0';.
  • Comment at line 798: "// config's preReleaseCommand will be executed by Craft."
  • const defaultBranch = await getDefaultBranch(git, argv.remote); (line 822).
  • logger.warn("You're not on your default branch, so I have to ask..."); (line 845).
  • Comment block starting "// TL;DR - WARNING:" (line 868).
  • await commitChanges(git, newVersion, preReleaseCommandRan); (line 913).
  • Comment (line 927): "// For CalVer releases, replace @-mentions with bold formatting in the" [changelog/commit message] — precedes formatting logic.
  • setGitHubActionsOutput( call at line 959 for exposing outputs to GitHub Actions.
• 🟡 (16:06) Assistant concluded review of prepare.ts and moved on: "Now the publish command." (next todo item: publish command flow, item 4 of 10).