A federated local-first social network.
  • Elixir 77.3%
  • Just 14.2%
  • Shell 8.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Tyler Hampton 4582ba91f3
Some checks are pending
Main branch / Prepare Localisation, Test, Lint (push) Waiting to run
Revise Phase 1 scope against the Bonfire Events audit
PRODUCT.md §10 scoped Phase 1 assuming we would build the whole events feature.
We would have duplicated a working one: Bonfire ships a real, tested, read-only
Events surface built on opaque ActivityPub JSON, with no Event schema, no RSVP
and no creation path. Upstream's own test reads "temp until an extension
implements events".

Adds §10.1 splitting Phase 1 into build / adapt / reuse. The build list is the
part that is actually ours — Event and Rsvp schemas, capacity and waitlist,
ordering by start time, radius discovery, our own category filter. Ordering by
start time is the strongest single argument for the native schema: Bonfire's
sort_by is a closed enum with no event-time option, so its events feed sorts by
when a thing was posted and "what's on this weekend" cannot be expressed against
jsonb.

Also records the trap that the event card fails silently rather than loudly when
handed a native struct — its accessor guards `when is_map(json)`, and a struct is
a map, so every field returns nil and the card renders blank.

Two §13 decisions were stale. The front-door entry is marked done and renamed for
bonfire_hearth. More substantively, "nothing inbound" no longer describes
reality: Bonfire ingests federated Events whether or not we want it, so Phase 1
either claims that handling or leaves it with the generic fallback — doing
nothing is not the neutral option.

That surfaces a real product question, now recorded in §12: federated events are
tempting as inventory exactly where a region is thinnest, which runs into P9's
ban on padding. Likely resolution is to filter geographically rather than by
origin, but it needs deciding rather than defaulting.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-02 21:37:10 -10:00
.claude Get the test suite running; 27 tests pass 2026-08-02 21:30:35 -10:00
.github/workflows Phase 0: prove the base 2026-08-02 20:51:52 -10:00
.tx Phase 0: prove the base 2026-08-02 20:51:52 -10:00
config Phase 0: prove the base 2026-08-02 20:51:52 -10:00
docs Revise Phase 1 scope against the Bonfire Events audit 2026-08-02 21:37:10 -10:00
lib Address review findings: edge uniqueness, changeset validation 2026-08-02 21:23:08 -10:00
priv Address review findings: edge uniqueness, changeset validation 2026-08-02 21:23:08 -10:00
test Phase 0: prove the base 2026-08-02 20:51:52 -10:00
.dockerignore Phase 0: prove the base 2026-08-02 20:51:52 -10:00
.formatter.exs Phase 0: prove the base 2026-08-02 20:51:52 -10:00
.gitattributes Phase 0: prove the base 2026-08-02 20:51:52 -10:00
.gitignore Phase 0: prove the base 2026-08-02 20:51:52 -10:00
.tool-versions Phase 0: prove the base 2026-08-02 20:51:52 -10:00
CLAUDE.md Get the test suite running; 27 tests pass 2026-08-02 21:30:35 -10:00
deps.git Phase 0: prove the base 2026-08-02 20:51:52 -10:00
deps.hex Phase 0: prove the base 2026-08-02 20:51:52 -10:00
justfile Phase 0: prove the base 2026-08-02 20:51:52 -10:00
LICENSE Phase 0: prove the base 2026-08-02 20:51:52 -10:00
mess.exs Phase 0: prove the base 2026-08-02 20:51:52 -10:00
mix.exs Phase 0: prove the base 2026-08-02 20:51:52 -10:00
README.md Phase 0: prove the base 2026-08-02 20:51:52 -10:00
tool-versions-to-env.sh Phase 0: prove the base 2026-08-02 20:51:52 -10:00

Little Hearth

A new bonfire extension created using the generator

NOTE: update this readme when you create a new extension.

Copyright (c) 2025 Bonfire Contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.