Files
ipx/crates/directory/CHANGELOG.md
rays 62a3241139 Database connections kept open; a click's wait is measured (#241, #245, #246)
#241: on production, All Subscriptions' query runs in 31 ms, unread oldest-first in 30, the
feed list's count in 5, generic plans included (EXPLAIN ANALYZE, BUFFERS, read only), against
0.3-1.6 s in ipx. A new Postgres connection takes 80-330 ms to open, and a page load asks for
more than are idle: four of six slow loads came as the pool grew (3 to 6, 2 to 6, 3 to 5, 6 to
8), and 20 requests at once took a median 414 ms while the pool grew from 8 to 20. The daemon
and the directory's server now keep their whole pool open (min = max); a command such as `ipx
status`, and the tests, which share the server's 100 connections, open as they need.

#246: the page reports list_shown, the ms from asking for a list to drawing it, with the view
and filter, under the click's trace; background refreshes are not timed. Timings skip report()'s
once-a-minute limit, which is for errors in a loop. A dashboard panel and table, and the prod
check, read it.

#245: the load test's browse scenario subscribes by OPML and leaves the Directory, which is
ipx-directory's since #204, to it.

CLAUDE.md records the owner's leave to EXPLAIN (ANALYZE, BUFFERS) any query on production,
read only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 14:52:14 +00:00

2.9 KiB

Changelog: ipx-directory

The directory of public podcasts that ipx servers share (docs/directory.md). ipx's changelog is crates/ipx/CHANGELOG.md, the page's web/CHANGELOG.md.

Its version is in crates/directory/Cargo.toml, and a release is tagged directory-vX.Y.Z.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Changed

  • Each feed is checked every twelve hours instead of six (#243).
  • Feeds are fetched accepting brotli and zstd as well as gzip (#244).
  • On Postgres the server keeps all ten of its database connections open, so a request does not wait for a new one (#241).

1.1.1 - 2026-10-15

Changed

  • The directory checks five feeds at a time, so a publisher that does not answer no longer holds up the rest of its round (#227).
  • A feed's server that takes 10 s to connect, or sends nothing for 15 s, is given up on (#230).

Security

  • A failed feed check is logged without its address's query or password (#238).

1.1.0 - 2026-10-13

Added

  • With metrics_bind set, the directory serves Prometheus metrics on a port of its own: memory, open files, and the feeds it has fetched and their bytes. A feed check's trace says how large the feed was (#224).

Changed

  • The directory uses mimalloc instead of glibc's allocator, so it gives back memory it has freed instead of holding over a gigabyte while idle (#224).
  • The example in docs/directory.md has no healthcheck; ipx-directory health is still there to run by hand (#218).

Security

  • A feed check's trace keeps the feed's address without its query or password (#225).

1.0.0 - 2026-10-12

Added

  • Anyone can browse the directory in a web browser, read only: the most subscribed, categories, every feed A to Z, a search by name, and each feed's page with its latest items and its address to copy into any podcast app (#215).
  • GET /v1/instances lists the servers holding a snapshot, with their feeds and subscribers, for an admin token (#206).
  • ipx-directory, a directory of public podcasts that ipx servers share: each sends the public feeds its people subscribe to, and any server with a token browses them, each feed listed once it has been read. Tokens are in its config file, each read-only, read-write or admin, and revoked one at a time (#204, #205).
  • Traces: a span a request, joining the trace of the ipx server that called, and a trace a refresher round with a span a feed (#213).