Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
C# audioaudio-unitavaloniacpp20cross-platformdawdigital-audio-workstationdspjucelinux-audiomcp-servermidimusicmusic-productionpiano-rollplugin-hostsequencersynthesizervstvst3
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2026 Egor Khindikaynen (Nota). See LICENSES/ for license terms.
//
// What's New shows a release's curated notes (release-notes/X.Y.Z.en.md, the GitHub
// release text) instead of its raw CHANGELOG.md section. Every shipped notes file must
// parse into a lede and titled sections, and the parser must read the format the release
// skill writes: a summary, the full change list after "<!-- changes -->" (every item ending
// in a commit link) and the contributors after "<!-- contributors -->". Also runnable alone: `dotnet run --project tests/Nota.SmokeTest -- --release-notes`.
using Nota.App;
namespace Nota.SmokeTest;
internal static class ReleaseNotesTests
{
public static IEnumerable<(bool Ok, string Label)> Run()
{
const string sample = """
<!-- SPDX-License-Identifier: AGPL-3.0-only -->
Nota 9.9 is a **big** one.
**1. First feature**
What it is and why it matters.
**2. Second feature**
One paragraph.
Another line of it.
**Also**
• a small fix with `code`
• **bold** start, plain end
""";
var e = ReleaseNotesParser.Parse("9.9.1", "2026-01-01", sample);
yield return (e.IsReleaseNotes && e.Lede == "Nota 9.9 is a **big** one.",
"release notes: the lede is the text before the first heading (SPDX line skipped)");
yield return (e.Sections.Count == 3
&& e.Sections[0].Title == "First feature"
&& e.Sections[1].Title == "Second feature"
&& e.Sections[2].Title == "Also",
$"release notes: \"**N. Title**\" lines become sections, number dropped ({string.Join(" | ", e.Sections.Select(s => s.Title))})");
yield return (e.Sections[1].Text == "One paragraph.\nAnother line of it." && e.Sections[1].Items.Count == 0,
"release notes: a feature's paragraph is its text");
yield return (e.Sections[2].Items.SequenceEqual(new[] { "a small fix with `code`", "**bold** start, plain end" }),
"release notes: \"•\" lines become bullets, and a bold-led bullet isn't a heading");
yield return (e.Sections.All(s => s.Kind == SectionKind.Feature),
"release notes: notes without part markers are all summary sections");
const string link = "([a1b2c3d](https://github.com/nota-daw/nota/commit/a1b2c3d4e5f60718293a4b5c6d7e8f9012345678))";
var full = $"""
<!-- SPDX-License-Identifier: AGPL-3.0-only -->
Nota 9.9 has a full list.
**1. First feature**
What it is.
<!-- changes -->
**Added**
• A new thing {link}
**Fixed**
• A fix {link}
• Another fix {link}
<!--Contributors -->
**Contributors**
[@ambertape](https://github.com/ambertape), [@rafi612](https://github.com/rafi612)
""";
var n = ReleaseNotesParser.Parse("9.9.2", "", full);
yield return (n.Lede == "Nota 9.9 has a full list."
&& n.Sections.Select(s => (s.Title, s.Kind)).SequenceEqual(new[]
{
("First feature", SectionKind.Feature),
("Added", SectionKind.Changes),
("Fixed", SectionKind.Changes),
("Contributors", SectionKind.Contributors),
}),
$"release notes: the markers split summary, change groups and contributors ({string.Join(" | ", n.Sections.Select(s => $"{s.Title}:{s.Kind}"))})");
yield return (n.Sections[2].Items.SequenceEqual(new[] { $"A fix {link}", $"Another fix {link}" })
&& n.Sections[0].Text == "What it is.",
"release notes: change items keep their commit links, no marker leaks into the text");
yield return (n.Sections[3].Items.Count == 0
&& n.Sections[3].Text == "[@ambertape](https://github.com/ambertape), [@rafi612](https://github.com/rafi612)",
"release notes: the contributors line is the section's text");
var root = RepoRoot();
yield return (root is not null, "release notes: repo root found");
if (root is null) yield break;
var changelog = ChangelogParser.Parse(File.ReadAllText(Path.Combine(root, "CHANGELOG.md")));
var files = Directory.EnumerateFiles(Path.Combine(root, "release-notes"), "*.en.md").OrderBy(f => f).ToList();
yield return (files.Count > 0, $"release notes: shipped EN notes found ({files.Count})");
foreach (var f in files)
{
var version = Path.GetFileName(f)[..^".en.md".Length];
var text = File.ReadAllText(f);
var notes = ReleaseNotesParser.Parse(version, "", text);
yield return (notes.IsReleaseNotes && notes.Sections.Count > 0
&& notes.Sections.All(s => s.Title.Length > 0 && (s.Text.Length > 0 || s.Items.Count > 0)),
$"release notes {version}: parses into a lede and {notes.Sections.Count} titled sections");
yield return (changelog.Any(c => c.Version == version),
$"release notes {version}: CHANGELOG.md has its section (What's New pairs them by version)");
// Notes with the full list: both markers in order, and every change item
// ends in its commit link(s).
var lines = text.Split('\n').Select(l => l.Trim()).ToList();
int changes = lines.FindIndex(l => ReleaseNotesParser.ChangesMarker.IsMatch(l));
if (changes < 0) continue;
int contributors = lines.FindIndex(l => ReleaseNotesParser.ContributorsMarker.IsMatch(l));
var unlinked = notes.Sections.Where(s => s.Kind == SectionKind.Changes)
.SelectMany(s => s.Items).Where(i => !CommitLinks.IsMatch(i)).ToList();
yield return (contributors > changes
&& notes.Sections.Any(s => s.Kind == SectionKind.Changes)
&& notes.Sections.Any(s => s.Kind == SectionKind.Contributors),
$"release notes {version}: the full list is followed by the contributors");
yield return (unlinked.Count == 0,
$"release notes {version}: every change ends in a commit link{(unlinked.Count > 0 ? " — missing: " + unlinked[0] : "")}");
}
var csproj = File.ReadAllText(Path.Combine(root, "src/managed/Nota.App/Nota.App.csproj"));
yield return (csproj.Contains(@"release-notes\*.en.md") && csproj.Contains("Assets/ReleaseNotes/"),
"release notes: Nota.App embeds release-notes/*.en.md where AppInfo reads them");
}
// "… ([a1b2c3d](https://github.com/nota-daw/nota/commit/<40 hex>), […](…))" at the end.
private const string CommitLink = @"\[[0-9a-f]{7}\]\(https://github\.com/nota-daw/nota/commit/[0-9a-f]{40}\)";
private static readonly System.Text.RegularExpressions.Regex CommitLinks =
new($@"\({CommitLink}(, {CommitLink})*\)$");
private static string? RepoRoot()
{
var d = new DirectoryInfo(AppContext.BaseDirectory);
while (d is not null && !File.Exists(Path.Combine(d.FullName, "Nota.sln"))) d = d.Parent;
return d?.FullName;
}
}