@bonvoy/plugin-ai

@bonvoy/plugin-ai

AI-generated release notes summary for bonvoy changelogs. Prepends a human-readable summary above the conventional changelog.

Installation

npm install @bonvoy/plugin-ai

Usage

// bonvoy.config.js
export default {
  plugins: [
    ['@bonvoy/plugin-ai', { provider: 'openai' }]
  ]
};

Set the API key as an environment variable:

OPENAI_API_KEY=sk-...

Output

The plugin adds a blockquote summary after the version header:

## [0.9.0] - 2026-02-10

> Adds automatic rollback for failed releases and improves error messages.
> If a publish fails mid-way, bonvoy now undoes all completed steps automatically.

### ✨ Features
- add rollback & recovery for failed releases

### 🐛 Bug Fixes
- improve error messages for rollback status

The conventional changelog below remains unchanged.

Providers

Three providers are supported, each using native fetch with zero extra dependencies.

Provider	Default Model	Env Var
openai	gpt-4o-mini	OPENAI_API_KEY
anthropic	claude-sonnet-4-20250514	ANTHROPIC_API_KEY
gemini	gemini-2.0-flash	GEMINI_API_KEY

// Anthropic
['@bonvoy/plugin-ai', { provider: 'anthropic' }]

// Gemini
['@bonvoy/plugin-ai', { provider: 'gemini' }]

// Custom model
['@bonvoy/plugin-ai', { provider: 'openai', model: 'gpt-4o' }]

Configuration

Option	Type	Required	Description
provider	'openai' | 'anthropic' | 'gemini'	Yes	LLM provider
model	string	No	Model name (uses provider default)
apiKey	string	No	API key (defaults to env var)
promptTemplate	string	No	Custom prompt with {packageName}, {version}, {commitList} placeholders
maxTokens	number	No	Max response tokens (default: 200)

Behavior

• Runs after the conventional changelog is generated (afterChangelog hook)
• One LLM call per changed package
• Skipped in --dry-run mode (no API cost)
• On API failure: logs a warning, keeps the conventional changelog as-is

License

MIT