app-catalog-felhom.eu/REPORT.md

REPORT — docs: REUSE.md introduced (cross-repo reuse map)

Date: 2026-07-03 · Class: docs-only (no template change, no deploy effect) Baseline: main @ bb81cd414afcb89e28ac60f405133f40195e6c43

What was done

• REUSE.md created at the repo root (58 lines, light §2/§5-focused variant per spec): the canonical example app (paperless-ngx — copy its structure), .felhom.yml required-field set (verified across all 53 apps), deploy_fields conventions, the five Docker-healthcheck families (BusyBox wget / curl / Node / Python / DB sidecars) each with a cited example, the memory request/limit convention (mem_limit = sum of compose limits; limits enforced, no reservations), the new-app checklist, and traps (gokapi entrypoint hack; legacy templates.json + scripts/generate-customer.sh; uptime-kuma's image-specific healthcheck binary).
• CLAUDE.md created (minimal — this repo had none): the REUSE.md pointer + same-commit maintenance rule + the workspace CHANGELOG/REPORT convention. A full CLAUDE.md is a separate task.
• CHANGELOG.md entry + CONTEXT.md created (one-liner).

Verification

python felhom.eu/scripts/reuse_refs_check.py e:/git/app-catalog-felhom.eu → OK [app-catalog-felhom.eu]: 10 cited paths, all exist. Sweep: 53 apps scanned (all 53 descriptors share the same top-level key set; optional extras verified per file).

Observations (NOT acted on) — README drift, recorded in REUSE.md §6

• README lists templates/filebrowser/ (doesn't exist); omits templates/recipe-importer/ (does).
• README field-type table omits subdomain (all 53 apps use it) and secret_input (romm); lists boolean which nothing uses.
• README says smtp_mapping = "Vaultwarden, Mealie"; six apps carry it (calcom, gitea, mealie, nextcloud, rallly, vaultwarden).
• Healthcheck URL style drift (localhost vs 127.0.0.1, curl -f vs -sf, two Node one-liner styles).

Cross-repo summary + full sweep counts: felhom.eu/REPORT.md.