Goose Release Manager

Step-by-Step Instructions

1. Determine the Version Bump

Apply Semantic Versioning 2.0.0:

SEMANTIC VERSIONING: MAJOR.MINOR.PATCH
═══════════════════════════════════════

Current version: 2.3.1

PATCH (2.3.1 → 2.3.2):
  → Bug fixes that don't change the API
  → Security patches
  → Documentation corrections
  → Performance improvements (no API change)
  Commit prefixes: fix:, perf:, docs:

MINOR (2.3.1 → 2.4.0):
  → New features that are backward compatible
  → New API endpoints or methods
  → Deprecation notices (not removals)
  → New optional parameters
  Commit prefixes: feat:

MAJOR (2.3.1 → 3.0.0):
  → Breaking changes to the public API
  → Removed endpoints or methods
  → Changed request/response formats
  → Required parameter additions
  → Minimum version bumps for dependencies
  Commit prefixes: feat!:, fix!:, or BREAKING CHANGE in footer

2. Analyze Commits Since Last Release

COMMIT ANALYSIS: v2.3.1...HEAD
═══════════════════════════════

Conventional Commits Found: 24

Breaking Changes (MAJOR):
  (none found)

Features (MINOR):
  feat: add user notification preferences API (#234)
  feat: implement bulk export for inventory reports (#241)
  feat: add dark mode support to dashboard (#245)

Bug Fixes (PATCH):
  fix: resolve session timeout on mobile devices (#236)
  fix: correct currency formatting for EUR locale (#238)
  fix: prevent duplicate order submissions (#242)
  fix: handle null values in search results (#247)

Other:
  perf: optimize database queries for inventory list (#237)
  docs: update API documentation for v2 endpoints (#239)
  refactor: extract notification service (#240)
  chore: update CI pipeline configuration (#243)
  test: add integration tests for bulk export (#244)
  ci: add security scanning to PR checks (#246)

━━━━━━━━━━━━━━━━━━━━━━━━━━━
RECOMMENDED VERSION: 2.4.0 (MINOR — new features, no breaking changes)

3. Generate Changelog

# Changelog

## [2.4.0] — 2026-02-22

### ✨ Features
- **Notification preferences**: Users can now configure notification channels
  and frequency from the settings page (#234)
- **Bulk export**: Export inventory reports in CSV, Excel, and PDF formats
  with filtering options (#241)
- **Dark mode**: Dashboard now supports dark mode with automatic system
  preference detection (#245)

### 🐛 Bug Fixes
- **Session timeout**: Fixed premature session expiry on mobile devices
  caused by incorrect timeout calculation (#236)
- **Currency formatting**: Corrected EUR locale formatting to use comma
  as decimal separator (#238)
- **Duplicate orders**: Added idempotency key to prevent duplicate order
  submissions during network retries (#242)
- **Search null handling**: Search results no longer crash when fields
  contain null values (#247)

### ⚡ Performance
- Optimized inventory list queries reducing load time by 40% (#237)

### 📚 Documentation
- Updated API documentation for all v2 endpoints (#239)

### 🔧 Internal
- Extracted notification logic into a dedicated service (#240)
- Added integration tests for bulk export feature (#244)
- Added automated security scanning to PR pipeline (#246)

4. Draft Release Notes

# Release Notes — v2.4.0

**Release Date:** February 22, 2026

## Highlights

### 🔔 Notification Preferences
Configure how and when you receive notifications. Choose from email,
in-app, and Slack channels. Set per-category frequency (immediate,
daily digest, weekly summary).

### 📊 Bulk Export
Export your inventory reports in multiple formats:
- **CSV** — For spreadsheet analysis
- **Excel** — With formatting and charts
- **PDF** — For printing and sharing

Apply date ranges, category filters, and custom columns before export.

### 🌙 Dark Mode
The dashboard now respects your system theme preference. Toggle between
light, dark, and auto modes from the settings panel.

## Bug Fixes
- Fixed session timeouts on mobile browsers
- Corrected currency display for European locales
- Prevented duplicate orders during slow network conditions
- Fixed crash when search results contain empty fields

## Upgrade Guide
This is a backward-compatible release. No action required for API consumers.

```bash
# npm
npm install @company/[email protected]

# Docker
docker pull company/inventory-app:2.4.0

Full Changelog

See CHANGELOG.md for the complete list of changes.

### 5. Pre-Release Validation

PRE-RELEASE VALIDATION CHECKLIST: ═════════════════════════════════

Code Quality: [✓] All CI checks passing on release branch [✓] Linting: 0 errors, 0 warnings [✓] Type checking: no type errors [✓] Code formatting: consistent

Testing: [✓] Unit tests: 847/847 passing (100%) [✓] Integration tests: 124/124 passing (100%) [✓] E2E tests: 38/38 passing (100%) [✓] Test coverage: 87.3% (threshold: 80%) [✓] No flaky tests detected

Security: [✓] Dependency audit: 0 known vulnerabilities [✓] Secret scanning: no secrets in code [✓] SAST scan: 0 critical or high findings [✓] License compliance: all dependencies MIT/Apache-2.0/BSD

Build: [✓] Production build successful [✓] Bundle size: 245KB gzipped (within budget) [✓] Docker image: 89MB (within limit) [✓] Build reproducible (deterministic output)

Documentation: [✓] CHANGELOG.md updated [✓] API docs updated [✓] Migration guide written (if breaking changes) [✓] README version references updated

━━━━━━━━━━━━━━━━━━━━━━━━━━━ VALIDATION RESULT: ✅ PASS — Ready for release

### 6. Execute Release

#### Git Tag Creation

```bash
# Create annotated tag
git tag -a v2.4.0 -m "Release v2.4.0

Features:
- User notification preferences API
- Bulk export for inventory reports
- Dark mode support for dashboard

Bug Fixes:
- Session timeout on mobile devices
- Currency formatting for EUR locale
- Duplicate order submissions prevention
- Null value handling in search results"

# Push tag
git push origin v2.4.0

GitHub Release Creation

GITHUB RELEASE:
═══════════════

Tag: v2.4.0
Target: main (commit abc123f)
Title: v2.4.0 — Notification Preferences, Bulk Export, Dark Mode
Pre-release: No

Body: [Release notes from Step 4]

Assets:
  - inventory-app-2.4.0.tar.gz (source)
  - inventory-app-2.4.0-linux-amd64.tar.gz
  - inventory-app-2.4.0-darwin-arm64.tar.gz
  - inventory-app-2.4.0-windows-amd64.zip
  - checksums.sha256

Package Publishing

PACKAGE PUBLISHING:
═══════════════════