Distillation

Date: Jul 21, 2026

• 🟢 (16:10) Assistant stated next step: "Now index.ts, changelog.ts, autoVersion.ts, and search for publish_repo & action.yml."
• 🟡 (16:10) [tool-result] Assistant read GitHub target implementation file (src/targets/github.ts, partial view via elided dump) — key structures found (file:line):
  • import { getGitHubClient } from '../utils/githubApi'; (line 17).
  • export interface GitHubTargetConfig extends GitHubGlobalConfig { ... } (line 55).
  • export class GitHubTarget extends BaseTarget { ... } (line 93).
  • const repo = typedConfig.repo || githubRepo.repo; (line 112).
  • Release creation call includes tag_name: tag, (line 207).
  • deletedAny = true; set inside asset-deletion loop (line 282).
  • return this.createDraftRelease(version, revision, changes); (line 301).
  • const { data: releases } = await this.github.repos.listReleases({...}); (line 319).
  • body: '' set when preparing release payload (line 338).
  • public async deleteRelease(release: GitHubRelease): Promise<boolean> (line 376).
  • public async getReleaseByTag(...) (line 432).
  • JSDoc "Fetches a list of all assets for the given release" (line 451).
  • JSDoc "Deletes the asset with the given name from the specific release" (line 470).
  • private async handleGitHubUpload(...) (line 526) — includes size check if (ret.size != stats.size) (line 563) inside try/finally.
  • draft: false, set when finalizing a release (line 601).
  • this.logger.info(\Pushing the tag reference: "${tagRef}"...`);` (line 620).
  • JSDoc "Resolves a floating tag pattern by replacing placeholders with version components." (line 630) — implementation does .replace('{minor}', String(parsedVersion.minor)) and similar placeholder replacements (line 639).
  • const latestReleaseTag = latestRelease?.tag_name; (line 752).
  • Code comment: "// Preview versions should never be marked as latest" (line 759) — governs latest-tag assignment logic.
  • const existingRelease = await this.getReleaseByTag(tag); (line 772).
  • if (currentRelease && currentRelease.draft === false) { ... } (line 809).
  • Comment: "// Release was already deleted or never created" (line 828).
  • this.logger.warn(...) call (line 847).
• 🔴 (16:10) Craft's GitHub target implementation (src/targets/github.ts, line 759) contains the rule "Preview versions should never be marked as latest" — governing how latestReleaseTag is determined when publishing GitHub releases.
• 🔴 (16:10) Craft's GitHub target implementation (src/targets/github.ts, line 630) documents a floating-tag resolution mechanism: "Resolves a floating tag pattern by replacing placeholders with version components," implemented via chained .replace() calls substituting placeholders like {minor} with actual parsed version fields (e.g. parsedVersion.minor, line 639).
• 🟡 (16:10) [tool-result] Assistant read src/index.ts (116 lines total, full file) — key structures found (file:line):
  • Shebang #!/usr/bin/env node (line 1); imports ./instrument first "before any other code" for Sentry instrumentation (line 3).
  • Imports: isCI from 'is-ci' (line 5), yargs (line 6), logger, LogLevel from './logger' (line 8), sanitizeDynamicLinkerEnv, warnIfCraftEnvFileExists from './utils/env' (lines 9-12), envToBool, setGlobals from './utils/helpers' (line 13), getPackageVersion from './utils/version' (line 14), withTracing from './utils/tracing' (line 15).
  • Command modules imported: prepare, publish, targets, config, artifacts, changelog (lines 18-23, all from ./commands/*).
  • function printVersion(): void (line 25) — logs `craft ${getPackageVersion()}` via logger.debug unless -v/--version flag present.
  • const GLOBAL_BOOLEAN_FLAGS (line 32) defines two flags: 'no-input' (coerce envToBool, default isCI, "Suppresses all user prompts") and 'dry-run' (coerce envToBool, default process.env.DRY_RUN, describe "Dry run mode: no file writes, commits, pushes, or API mutations"); comment // TODO(byk): Deprecate this in favor of CRAFT_DRY_RUN (line 41).
  • function fixGlobalBooleanFlags(argv: string[]): string[] (line 61) — JSDoc explains it works around a yargs limitation by injecting a truthy '1' string after standalone boolean flags so they can still be overridden via --flag=no env-var notation.
  • async function main(): Promise<void> (line 75) — calls sanitizeDynamicLinkerEnv(), printVersion(), warnIfCraftEnvFileExists(), builds argv via fixGlobalBooleanFlags(process.argv.slice(2)), then configures yargs: .parserConfiguration({ 'boolean-negation': false }), .env('CRAFT'), .command(prepare/publish/targets/config/artifacts/changelog), .demandCommand(), .version(getPackageVersion()), .alias('v','version'), .help(), .alias('h','help'), .options(GLOBAL_BOOLEAN_FLAGS), .option('log-level', {default:'Info', choices: non-numeric LogLevel keys, coerce: capitalize first letter, global:true}), .strictCommands(), .showHelpOnFail(true), .middleware(setGlobals), .parse(argv).
  • Entrypoint: withTracing(main, { name: 'craft.cli', op: 'cli' })(); (line 116).
• 🟡 (16:10) Assistant noted .env('CRAFT') in src/index.ts main() enables env-var layering where CLI options can be set via CRAFT_-prefixed environment variables.
• 🟢 (16:10) Assistant stated next step: "Now search for publish_repo and action files, and read changelog.ts & autoVersion.ts."