furtka-apps/CHANGELOG.md

# Changelog

All notable changes to the Furtka apps catalog will be documented here.
Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
Versioning: CalVer (`YY.N`) — same scheme as the core Furtka repo.

## [Unreleased]

### Added

- **Home Assistant** (v1.0.0, image `homeassistant/home-assistant:stable`,
  daniel/furtka-apps#1). Smart-home hub for lights, sensors, and locally
  controlled devices. Bridge-mode networking with explicit `8123:8123`
  port mapping for v1 — Cloud integrations (Hue Cloud, Tado, Sonos via
  account) work, mDNS/Bluetooth/Zigbee-stick discovery deferred until a
  manifest `network_mode` knob lands. One Docker volume (`config`),
  no manifest settings — onboarding (admin user, home location, units)
  happens in the browser on first visit to `:8123`.

## [26.11-alpha] - 2026-04-21

### Fixed

- **Jellyfin compose default-substitution.** Without an `.env` in the
  jellyfin app dir the CI validator's `docker compose config` step
  substituted an empty `${MEDIA_PATH}` into `:/media:ro` — which
  compose rejects as `empty section between colons`. Changed the
  spec to `${MEDIA_PATH:-/nonexistent}:/media:ro` so the CI syntax
  check always sees a valid volume even with no env file. Real
  install flow (form fill → .env with user path) is unchanged; a
  broken install that reaches `docker compose up` with no
  MEDIA_PATH now fails loudly on a nonexistent bind target instead
  of silently mounting something random.

## [26.10-alpha] - 2026-04-21

### Added

- **Jellyfin** (v1.0.0, image `jellyfin/jellyfin:latest`). Media
  server for movies, shows, music on the LAN. First app to use the new
  `path`-type setting (core ≥ 26.10-alpha): the user picks their
  existing media folder in the install form (`MEDIA_PATH=/mnt/media`),
  the installer validates the path server-side, and docker-compose
  mounts it read-only at `/media`. Docker-managed volumes handle
  `/config` and `/cache`. Admin account bootstraps from the first
  browser visit to port 8096. Ports: 8096. No HW transcoding yet —
  that's a later schema extension.

### Changed

- Vendored manifest schema (`scripts/vendor/furtka_manifest.py`)
  caught up to core 26.10-alpha: adds the `open_url` field (missing
  since 26.6-alpha cut) and the new `path` setting type. `validate-
  catalog.py` now accepts path-type settings without changes.

## [26.9-alpha] - 2026-04-21

### Added

- **IT-Tools** (v1.0.0, image `corentinth/it-tools:latest`). A browser
  toolbox: password/UUID/QR generators, hash and HMAC, Base64 / URL /
  JWT decoders, JSON/YAML/SQL formatters, regex tester, cron parser,
  subnet calculator, and the usual long tail. Runs fully client-side —
  no state, no volumes, no settings. Serves on port 8080.

## [26.8-alpha] - 2026-04-21

### Changed

- **fileshare** bumped to v0.1.2: adds `open_url` (`smb://{host}/files`)
  so the core UI can render an Open button that deep-links to the share.
- **Uptime Kuma** bumped to v1.0.1: adds `open_url`
  (`http://{host}:3001/`) for the same UI Open button. No image or
  compose changes.

## [26.7-alpha] - 2026-04-20

### Added

- **Uptime Kuma** (v1.0.0, image `louislam/uptime-kuma:1`). Self-hosted
  status monitor — pings hosts, checks HTTPS endpoints, watches Docker
  containers, and screams on Telegram/webhook when something breaks.
  No manifest settings: the admin account is created on the first
  browser visit to port 3001. Persists history + config via one
  namespaced volume `furtka_uptime-kuma_data`.

## [26.6-alpha] - 2026-04-20

### Added

- Initial catalog release. Carries one app: **fileshare** (v0.1.1, SMB
  share over `dperson/samba`). Copied from the `daniel/furtka` seed so
  boxes on 26.6 see the same fileshare bits whether they pull the
  catalog or fall back to the bundled seed.
- Release pipeline + CI parity with the core repo:
  `scripts/build-catalog-tarball.sh`, `scripts/publish-catalog-release.sh`,
  `scripts/validate-catalog.py` (CI guardrail — loads every manifest via
  the vendored `furtka.manifest.load_manifest` + cross-checks compose
  volume references).

[Unreleased]: https://forgejo.sourcegate.online/daniel/furtka-apps/compare/26.11-alpha...HEAD
[26.11-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.11-alpha
[26.10-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.10-alpha
[26.9-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.9-alpha
[26.8-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.8-alpha
[26.7-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.7-alpha
[26.6-alpha]: https://forgejo.sourcegate.online/daniel/furtka-apps/releases/tag/26.6-alpha