Release Notes - v0.8.0¶

Overview¶

This release adds monorepo tag path support, enabling correct version comparison and tag links for repositories that use path-prefixed tags (e.g., sdk/go/v1.0.0 instead of v1.0.0).

Highlights¶

New tag_path field for monorepo-style version tags with path prefixes

Added¶

Tag Path Support for Monorepos¶

Many monorepos use path-prefixed tags to version multiple components independently. For example:

sdk/go/v1.0.0 for the Go SDK
sdk/python/v2.3.0 for the Python SDK
cli/v0.5.0 for the CLI tool

The new tag_path field in the changelog IR enables correct link generation for these repositories.

Configuration¶

Add tag_path to your CHANGELOG.json:

{
  "ir_version": "1.0",
  "project": "multi-agent-spec/sdk/go",
  "repository": "https://github.com/example/multi-agent-spec",
  "tag_path": "sdk/go",
  "releases": [...]
}

Generated Links¶

With tag_path: "sdk/go", the renderer generates correct comparison URLs:

Link Type	Without tag_path	With tag_path
Compare	`/compare/v1.0.0...v1.1.0`	`/compare/sdk/go/v1.0.0...sdk/go/v1.1.0`
Tag	`/releases/tag/v1.0.0`	`/releases/tag/sdk/go/v1.0.0`
Unreleased	`/compare/v1.1.0...HEAD`	`/compare/sdk/go/v1.1.0...HEAD`

Platform Support¶

Works with both GitHub and GitLab repositories:

<!-- GitHub -->
[v1.1.0]: https://github.com/example/repo/compare/sdk/go/v1.0.0...sdk/go/v1.1.0

<!-- GitLab -->
[v1.1.0]: https://gitlab.com/example/repo/-/compare/sdk/go/v1.0.0...sdk/go/v1.1.0

Schema Update¶

The JSON schema (changelog-v1.schema.json) now includes the tag_path property:

{
  "tag_path": {
    "type": "string",
    "description": "Path prefix for version tags (e.g., 'sdk/go' for nested Go modules)"
  }
}

What's Next¶

v0.9.0 will focus on Localization:

Localized section headers (Added → Ajouté, Fixed → Corrigé)
25+ language support matching Keep a Changelog translations
Embedded locale files via //go:embed