1 Changelog V1.21.82
Forgejo Actions edited this page 2026-10-17 08:19:43 +00:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

v1.21.82

Date: 2026-10-17

Features

  • Add photos to an existing album (spec 064, highlight): a new idempotent batch endpoint POST /api/albums/{id}/items/batch adds many items to one album in a single transaction — safe to retry, unknown/inactive album or media normalize to 404 (#1278). On the web, an "Add to existing album" selection action plus a generalized multi-item dialog drive it from the timeline selection and the viewer (#1279); Android got a viewer "…" overflow menu and timeline multi-select with the same flow (#1280). Spec marked complete (#1281, #1282).
  • People clustering: semisupervised-v3 (ADR 0113): representative density-graph clustering in the people-worker behind a v3 result envelope, with the API-side contract matrix, allowlist and enqueue stamping (#1258, #1259), a V6 fingerprint-keyed representative cache (#1268, #1269), the accepted ADR and its measured G1/G4 validation trail (#1254, #1255, #1260–#1262, #1266, #1267, #1271).
  • Canonical representative thumbnail (ADR 0114): one shared resolution ladder (manual pin via manual_selection → medoid of the largest cluster → deterministic fallback) now backs every face surface; the worker ships the medoid member face id per representative and the API re-enqueues the canonical crop on re-pin (#1276, #1277; confirmed-images-only rule #1283).
  • Family relations (spec 063): relations between persons (API #1236, web section with en/de/da i18n #1237), gender-neutral relation types (#1242), a relations carousel with chosen-representative thumbnails (#1245), derived and multi-level derived relations (#1248, #1253), and a picker that hides already-related persons (#1240). Spec marked complete (#1239).
  • Album suggestions: runs auto-trigger after new imports (#1270) and are sorted by newest photo date (#1264).
  • Cast follow-ups (Android): UX round 2 with always-visible cast button, chronology and day headers (#1228), the cast viewport crop mirror (spec 061, API + Android #1230/#1231), and a viewer autoplay slideshow (spec 062 #1234).
  • Stash for named people (name discarded, ADR 0112): API + web, stash action moved to the instance-detail overflow menu (#1225, #1226, #1229). Web: Uploads moved into the mobile navigation drawer (#1256).

Fixes

  • Android: backup keeps GPS EXIF again — ACCESS_MEDIA_LOCATION + original-byte reads prevent scrubbed copies from losing location on upload (#1275).
  • Worker: empty EXIF GPS treated as missing location; existing Null-Island (0,0) rows backfilled (#1272).
  • API: MediaTokenClaim is now Serializable — ?st= media fetches no longer 500 after serving bytes, which had broken every Chromecast cast (ISSUE-160, #1227).
  • Ops: worker_jobs history bounded by a 30-day purge, ProcessingSummary index-covered (#1251); API JVM heap capped at 6% of host (JAVA_TOOL_OPTIONS, #1246).
  • Face suggestions: faster lookups with a regression guard (#1252), person-accurate dialog thumbnails (ISSUE-161, #1250), self-occurrences excluded from instance suggestions (#1244).
  • Album suggestions: candidate-window anchors interleaved so recent media still gets windows (#1273); minimum 4 images (#1243); collapsed preview strips fixed (#1241).
  • People-worker: single-source v3 envelope contract-version stamp (ISSUE-164, #1263); releasedTentativeFaces filtered to canonical UUIDs (ISSUE-165, #1265).

Notes

  • Newly documented ADRs: docs/adr/0113-representative-density-graph.md (semisupervised-v3, accepted) and docs/adr/0114-canonical-representative-thumbnail.md.
  • Known-issues follow-ups: days with >500 photos still produce no suggestion window at all (ISSUE-166); the legacy single-item album endpoints can surface unknown/deleted albums as uncaught 500s — the spec 064 batch endpoint normalizes these, single-item path tracked as ISSUE-168.
  • Android app releases 0.6.0–0.8.0 were merged to main during this window (#1224, #1232, #1235).
  • Release: version bump 1.21.81 → 1.21.82 (PR branch, gradle.properties).