Function writeReleaseNotes

scripts/draft-changelog.ts:455–476

(version: string, releaseNotes: string, force: boolean)

}

function writeReleaseNotes(version: string, releaseNotes: string, force: boolean) {
  const releasesDir = join(ROOT, "releases");
  const releasePath = join(releasesDir, `v${version}.md`);
  mkdirSync(releasesDir, { recursive: true });

  // Use an exclusive-write flag rather than a separate existsSync check so the
  // "already exists" guard is atomic with the write (no TOCTOU race).
  // EEXIST is only reachable when force is false (the "wx" flag); with force the
  // "w" flag overwrites and never throws it, so no separate force check is needed.
  try {
    writeFileSync(releasePath, `${releaseNotes}\n`, { flag: force ? "w" : "wx" });
  } catch (error) {
    if ((error as NodeJS.ErrnoException).code === "EEXIST") {
      console.log(
        `${releasePath} already exists; leaving it unchanged. Pass --force to overwrite it.`,
      );
      return;
    }
    throw error;
  }
  console.log(`Wrote ${releasePath}`);
}

function prependDocsUpdate(version: string, docsUpdate: string) {
  const changelogPath = join(ROOT, "docs", "changelog.mdx");