Home/Tools/@tpmjs/tools-release-notes

releaseNotesTool

@tpmjs/tools-release-notes

Generate release notes from structured changes. Groups changes by type (features, fixes, breaking changes, etc.) and formats them as markdown. Returns formatted notes with version, date, and summary statistics.

Official
doc
v0.2.0
MIT
⚠️

This tool is currently broken

Execution Failed
Runtime error with test parameters
Changes array cannot be empty

Last checked: 1/1/2026, 8:17:45 AM

Interactive Playground

Test @tpmjs/tools-release-notes (releaseNotesTool) with AI-powered execution

0/2000 characters

Installation & Usage

Install this tool and use it with the AI SDK

1. Install the package

npm install @tpmjs/tools-release-notes
pnpm add @tpmjs/tools-release-notes
yarn add @tpmjs/tools-release-notes
bun add @tpmjs/tools-release-notes
deno add npm:@tpmjs/tools-release-notes

2. Import the tool

import { releaseNotesTool } from '@tpmjs/tools-release-notes';

3. Use with AI SDK

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { releaseNotesTool } from '@tpmjs/tools-release-notes';

const result = await generateText({
  model: openai('gpt-4o'),
  tools: { releaseNotesTool },
  prompt: 'Your prompt here...',
});

console.log(result.text);

Parameters

Available configuration options

Auto-extracted
version
Required
Type: string

Version number (e.g., "1.2.0", "v2.0.0-beta.1")

changes
Required
Type: array

Array of changes to include in the release notes

Schema extracted: 1/1/2026, 8:17:45 AM

README

@tpmjs/tools-release-notes

Generate release notes from structured changes. Groups changes by type and formats them as markdown.

Installation

npm install @tpmjs/tools-release-notes ai

Usage

import { releaseNotesTool } from '@tpmjs/tools-release-notes';

const result = await releaseNotesTool.execute({
  version: 'v1.2.0',
  changes: [
    {
      type: 'feature',
      description: 'Add dark mode support',
      issue: '123',
    },
    {
      type: 'fix',
      description: 'Fix memory leak in cache manager',
      issue: '456',
    },
    {
      type: 'breaking',
      description: 'Remove deprecated API methods',
    },
    {
      type: 'docs',
      description: 'Update installation guide',
    },
  ],
});

console.log(result.notes);

Output

# v1.2.0 (2025-12-31)

⚠️ **This release contains breaking changes!**

**Changes:** 4 total (1 feature, 1 fix, 1 breaking, 1 other)

---

## 💥 BREAKING CHANGES

- Remove deprecated API methods

## ✨ Features

- Add dark mode support ([#123](../../issues/123))

## 🐛 Bug Fixes

- Fix memory leak in cache manager ([#456](../../issues/456))

## 📝 Documentation

- Update installation guide

Features

  • Groups changes by type with emojis
  • Highlights breaking changes at the top
  • Generates summary statistics
  • Links to GitHub issues (if provided)
  • Clean markdown formatting
  • Automatic date generation

Parameters

  • version (string, required) - Version number (e.g., "1.2.0", "v2.0.0-beta.1")
  • changes (array, required) - Array of change objects:
    • type (string) - One of: feature, fix, breaking, docs, chore, perf, refactor, test, other
    • description (string) - Description of the change
    • issue (string, optional) - Issue number (e.g., "123")

Returns

{
  notes: string;           // Formatted markdown
  version: string;         // Version number
  date: string;           // ISO date (YYYY-MM-DD)
  summary: {
    features: number;
    fixes: number;
    breaking: number;
    other: number;
    total: number;
  };
}

Change Types

The tool supports the following change types:

  • feature - New features
  • fix - Bug fixes
  • breaking - Breaking changes
  • docs - Documentation updates
  • chore - Maintenance tasks
  • perf - Performance improvements
  • refactor - Code refactoring
  • test - Test updates
  • other - Other changes

License

MIT

Statistics

Downloads/month

0

Quality Score

0%

Bundle Size

NPM Keywords

tpmjs
doc
ai
release-notes
changelog
documentation

Maintainers

thomasdavis(thomasalwyndavis@gmail.com)

Frameworks

vercel-ai