Files
iptvnator/CHANGELOG.md
T
4grayandClaude Opus 5 270350c2e1 chore(release): author release notes in .changes instead of reconstructing them (#1256)
* chore(release): author release notes in .changes instead of reconstructing them

CHANGELOG.md has been frozen at 0.12.0 since 2023 while the app shipped
0.23.0, semantic-release sat in devDependencies with no config, and the real
user-facing notes were a 280-line MDX post written from memory at release
time. The gap was never version math — it was authored notes captured while
the context is still fresh.

Add a `.changes/*.md` note format (type, area, issues, screenshot; no version
field, since the release version is chosen deliberately) plus a generator that
composes the GitHub release body, the CHANGELOG.md section and a blog-post
scaffold from the accumulated notes.

Changesets was considered and rejected: it versions multiple published
packages, and this repo has exactly one private package. Its `version` step
would also rewrite CHANGELOG.md into a flatter format than the blog post and
fight the deliberate, updater-constrained version choice.

- hand-rolled frontmatter parser over a YAML engine: the schema is closed, so
  it can reject unknown keys, which is what catches typos
- PR numbers are resolved from the commit that added the note, never written
  by the author
- MDX-significant characters in note bodies are escaped so a stray `<` cannot
  break the website build
- blog scaffold ships `draft: true` with explicit TODO headings; the prose is
  editorial work, only the inventory is mechanical
- revive CHANGELOG.md with an honest pointer for 0.13.0-0.23.0 rather than
  fabricating the missing history
- drop the five unused semantic-release/conventional-changelog packages

Docs: `.changes/README.md`, plus a "Release Notes For User-Visible Changes"
section mirrored in CLAUDE.md and AGENTS.md, and a PR template checkbox for
contributors who never read either.

Tests: 26 unit tests in tools/release/release-notes.test.mjs covering parsing,
validation, grouping and all three renderers.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(release): default the notes version to package.json and harden alt escaping

Review follow-ups on the release-notes generator.

- `--version` now defaults to the root package.json version, so the
  `release🎶*` package scripts run bare instead of failing on a missing
  argument. Bumping package.json is the deliberate act that starts a release,
  which makes it the right single source of truth; `--version` remains as an
  override for dry runs before the bump. The notice goes to stderr so
  `--format github` keeps a pipeable stdout.
- Escape backslashes before apostrophes when building the MDX `alt` string
  literal. A note body ending in a backslash previously produced an
  unterminated string and would have broken the website build.
- Document that release posts are one per minor version, in the slug helper,
  the overwrite error, and `.changes/README.md` — a patch release edits the
  existing post rather than creating a second one.

Tests: +1 regression test for the alt escaping, verified to fail without the
fix (27 total, all passing).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* feat(ci): put authored notes into the tag release body, fail-closed

Wires the .changes pipeline into the release workflow (Codex review P1 on
#1256). Calling the generator from the tag build cannot work — --consume
deletes .changes/ before the tag exists — so the tag build reads what the
generator already wrote: release-meta now fills BODY from the CHANGELOG.md
section matching the tag's version via tools/release/extract-changelog-section.mjs.

generate_release_notes stays on, so GitHub's commit list renders below the
authored notes; the existing draft-metadata repair step already concatenates
RELEASE_BODY with the generated notes, so the rare duplicate-draft path keeps
the same layering unchanged.

The extractor exits non-zero when the section is missing or empty, failing
the release instead of silently shipping PR-title-only notes. A hotfix tag
cut without running release:notes:changelog therefore fails at create-release
by design; the error message names the exact commands to run.

Tests: 5 new extractor tests (32 total in release-tools, all passing);
packaging suite (247) re-run green since build-and-make.yaml is one of its
inputs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(release): escape all regex metacharacters in the changelog extractor

CodeQL flagged the version-to-RegExp interpolation in
extract-changelog-section.mjs (regex injection + incomplete escaping): only
dots were escaped, and while the CLI validates its argument as bare semver
before calling, the exported extractSection() carries no such guarantee on
its own. Escape the full metacharacter set so no caller can inject pattern
syntax, with tests covering wildcard dots, alternation, `.*` and backslashes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(release): make changelog generation idempotent per version

Codex review P2 on #1256: rerunning `release:notes:changelog` for the same
version — the normal move after correcting a note before --consume —
prepended a second section instead of replacing the first, leaving duplicate
release entries.

Extract the marker insertion into upsertChangelogSection(): it removes any
existing section for the version, then rebuilds around the marker rather than
string-replacing into it, so the blank-line count on both sides stays exact
on both the fresh-insert and replace paths. The CLI reports when a section
was replaced.

Tests: 4 new cases (insert, replace-not-duplicate, neighbours untouched,
missing marker); 37 total passing. End-to-end rerun verified: one heading,
latest date wins, extractor output unchanged.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
2026-07-25 18:22:43 +02:00

16 KiB
Raw Blame History

Changelog

Releases 0.13.0 – 0.23.0 were published as GitHub releases and website posts rather than collected here. This file resumes from the next release onwards; the entries below are kept as they were written.

New sections are generated from .changes/*.md and inserted directly below this marker — see .changes/README.md.

0.12.0 (2023-03-11)

Important change

The storage location of playlists has been changed, now everything is stored in IndexedDB. So after the update you will see a panel offering to migrate playlists.

Bug Fixes

  • macos related window management improvements (b336680)
  • set epgSource as not required field (049ed6b), closes #175

Features

  • add cmd+q hotkey to close the app (macOS) (f3e00e7), closes #181
  • add dockerfile and docker-compose (4b97e3d)
  • add italian language (3e3f18c)
  • draggable channels in favorites list (ba41c8d)
  • export playlist as m3u (7e4d6b1)
  • persist window size (2ce60e0), closes #205
  • pwa: load a m3u playlist as a URL parameter #176 (344bd75)

0.11.1 (2022-10-01)

Bug Fixes

  • allow file:// protocol for epg source (c4e1076)
  • disable service worker in electron app (df4e99a)
  • red screen in PIP window (9756a76)
  • service worker injection (ba3dd88)

Reverts

  • Revert "Update release.yml" (5ac1992)

0.11.0 (2022-09-11)

Bug Fixes

  • set default value for video player (ab1d0bf)
  • show notification after playlist refresh (PWA) (b18e537)

Features

  • check for available updates in PWA (17b265f)
  • implement multi epg view (b4db751)
  • import playlist as text (6676fa0)
  • support multiple epg sources (f8c6874)

0.10.0 (2022-04-24)

Bug Fixes

Features

  • add context menu with default actions (44e76e0), closes #96
  • add option to change aspect ratio (b8a3f76), closes #80
  • add option to select stream resolution (c23fe3a), closes #93
  • add pwa support (5a5085d)
  • auto-detect if OS is in dark mode (ad26588)
  • generate global playlist with all favorites (764201a), closes #97
  • integrate french localization (ab75a2f)
  • pwa: auto-generate playlist with global favorites (98ff7f4)
  • switch playlists from the sidebar (0bc71d4)

0.9.0 (2021-10-14)

Bug Fixes

  • search feature should not affect favorites list (ef52f77), closes #71

Features

  • add chinese translation (a497f05)
  • global subtitle display setting (4d2e175)
  • rearrange the display order of playlists (757c739), closes #77

0.8.0 (2021-07-17)

Features

  • add info popup with epg info for active channel (0eecfd1), closes #51
  • add support of specific user-agent and referer on channel level (a55f741), closes #57

0.7.0 (2021-05-24)

Bug Fixes

  • promise issue after channel switch #29 (d1f194a)

Features

  • auto-refresh playlists on app startup (e8ab576)
  • refresh playlist from file system or imported url (57cf247)
  • support of timeshift and catchup attributes in playlists (ced16a8)

0.6.0 (2021-04-10)

Bug Fixes

  • quit application via window close icon (24d5584), closes #33

Features

  • add "what is new" dialog (cc375a4)
  • add dark theme (0cf010a)
  • add dialog with detailed epg description (96e93c5)
  • set custom user agent for a playlist (a8167c4), closes #26
  • show channel logos in the list (41998ff), closes #28

0.5.0 (2021-02-28)

Bug Fixes

  • less strict url validation of playlist URL (4f366d9), closes #22
  • macOS corrupt icon fix, closes #21 (955bb27)

Features

  • add dialog about playlist details (9f951fa)
  • add german language (i18n) (7888e85)
  • add internationalization (0f8ca2a)
  • add russian language (i18n) (a93af69)

0.4.0 (2021-02-11)

Bug Fixes

  • default html5 player initialization fix (4a6b976)

Features

  • add ctrl+f as hotkey to focus search field (cad162d)
  • add epg worker with new ipc commands (418566f)
  • add moment.js based date pipe (4881ba8)
  • check for available update (68ccabb)
  • epg integration (2e861b6)
  • epg: epg program list with date navigation (fdbe02b)
  • favorite channels list (f02bbe3)
  • integrate epg feature (e896af0)
  • integrate epg worker & refactor app menu (3b97d74)
  • sort playlists by import date (d967b12)
  • validation of playlist url (da2fe5e)

Performance Improvements

  • destroy hls instance after view change (2e3681c)

0.2.0 (2020-09-27)

Features

  • add new video.js based player (1e852e3)
  • add settings page (1a44ecd)
  • video player configuration in app settings (05c0c25)

0.1.0 (2020-09-12)

Bug Fixes

Features

  • add new application icon (0ce0b1f)
  • open playlist from file system (861e480)

0.0.2 (2020-09-06)

Bug Fixes

  • define path to userData folder as db store (8e8c107)
  • enable copy-paste hotkeys for mac os (4357c17)

0.0.1 (2020-09-05)

Bug Fixes

  • full screen permissions (fff2aaa)
  • full screen permissions (f0d0fb1)
  • start_url fix in manifest file (e05b7eb)
  • start_url fix in manifest file (3929655)
  • update paths to make app installable (fd9fc53)
  • update paths to make app installable (4b7d1b5)

Features

  • add channel search function (d1b9461)
  • add channel search function (7a039af)
  • add favorites and tab based navigation (8d333d9)
  • add favorites and tab based navigation (c6e3e1f)
  • add icon, about dialog and menu (bcf49b8)
  • change sidebar mode (22f2bc1)
  • change sidebar mode (ca9f7a2)
  • electron based app (0feb657)
  • electron based app (998e7e9)
  • implement channel groups view (20e0a40)
  • implement channel groups view (773e1ed)
  • initial commit (79332aa)
  • initial commit (2f1701a)
  • list with recent playlists (1735026)
  • list with recent playlists (8ee96ee)