Files
felhom.eu/STATUS.md
T
admin c718aad1bc
gates / gates (push) Successful in 7s
docs: R-168 SHIPPED, R-29 CLOSED on the demonstrated alarm, R-169 minted
SPIKE-ci-runner-2026-08-02.md: all six probes with method, measurement and ruling; none
STOPped. P2 (stock image has git but no python3) and P6 (a runner that loses its state
re-registers and orphans the old record) changed the design; P5 (a failed run signals
NOTHING) is why the alarm exists at all.

R-168 SHIPPED with its evidence. R-29 CLOSED — on the demonstrated alarm and not on a green
run, as required: the class it opened is answered at both ends, the hook refusing locally and
CI catching a --no-verify bypass and emailing. R-161 noted: its automatic half now exists for
the STATIC gate, while its original scope, the runtime gate, is deliberately still not
automatic and should stay that way.

NEW R-169 (grep established R-168 was the highest in use): CI can only report, because there
is no gate in the road. Making it blocking needs branch protection plus a PR workflow, both
of which change how the operator works — so it is theirs to decide, and the row states the
cost honestly rather than recommending it.

CONTEXT gains S-8 (CI detects, does not block, and why that is structural), S-9 (a detector
that tells no one is not finished, plus the curl and Cloudflare-1010 traps), S-10 (the runner
is unprivileged because DooPlex is Tier 2), S-11 (CI reproduces the sibling layout).

CLAUDE.md gains the rule earned by red-proofing: a go test -run pattern that matches no test
prints ok and exits 0, and an instrument that can silently drop results is not a measurement.
2026-08-02 16:35:34 +02:00

5.0 KiB

STATUS — what works, what's broken, what's next

Updated 2026-08-02.

A view, not a source. documentation/backlog/OPEN-ITEMS.md is the authority on open work; this page restates part of it in plain words, and nothing may exist only here. Not CONTEXT.md, which is technical state written for Claude Code — keep the two separate. Maintenance: update at the end of every session in which something shipped, broke, or was decided. One screen; cut items rather than extend it.

What works right now

A blank machine boots the Felhom disc, installs itself unattended, and is claimed by the customer, who sets their own password. They install apps from a catalogue of fifty-three, share files over the home network, and open apps from a launcher or a shared link. Backups run on their own to three places — the machine's drive, a second drive, and an encrypted off-site copy — and a customer can restore files and app data from the drive alone. Proven end to end on real hardware.

What's broken

After a power cut, an app can stay switched off — and nothing says so. The machine looks for apps that didn't come back, but looks too early and never again. In one case it decides the customer switched it off deliberately, so it isn't even counted as down. (R-157)

The off-site copy can be erased by the machine that made it — the credential that writes it can also delete it. A daily snapshot is armed as a stopgap, and we have never restored from that copy. (R-95, R-87)

Three apps out of fifty-three kept their data where backups never looked. They reported healthy; the data would vanish on the next update. Two are fixed, the third is now clear to fix because it is installed nowhere. (R-156)

Local backups get 20 GB while apps get 50 GB. An app that outgrows the smaller space stops being backed up locally — and the off-site copy is made from the local one, so that stops too. Nothing is lost: the last good copy is kept intact. (R-163)

When that happens, only one page says so — no email, no alert. The page that answers "is this app backed up?" is the one that stays silent. (R-158)

The checks now have two nets, and the second one emails you. Every repository has one command that runs all of its checks; it runs by itself before every push and refuses a push that fails. That one lives on the workstation and can be skipped. So the build server now runs the same checks again, on a machine that does not care who pushed or what they typed — and when they fail it sends you an email, because a red mark on a page nobody watches is not a warning. Proven with a real broken change, not assumed. The one thing it still cannot do is stop the change: every change here goes straight to the main copy with no review step, so there is no point in the road for it to stand at. It notices, quickly, and tells you. (R-29, R-161, R-168, R-169)

What we're working on

  • Now: the last app whose data was never saved; today's decisions written down.
  • Next: merging the small backup partition into the large one, with the drive-filling warning and the backup-failure alert in the same step.
  • After: rebuilding how the machine records whether an app is meant to be running.

Waiting on you

  • How a new version reaches a machine. Pushing the installer publishes it — half a minute later every new machine downloads it, with no staging and no way back but another push. And publishing is a step we remember rather than one the release performs, forgotten twice: a fix can be live here and still not reach a new machine. Nothing is installing today, so this is the cheapest moment to settle both. (R-110, R-115)
  • A job, not a decision: the hub password needs changing. A diagnostic command printed it into a session log; nothing suggests anyone else saw it. (R-132)

Changed since last update

  • 2026-08-02 — Fixed and then doubled: thirteen mechanical checks had built up across the four repositories and nothing ran most of them; two were failing quietly, one since 14 July. Both fixed. Every repository now has one command that runs all its checks, it runs automatically before every push, and the build server re-runs it after every push and emails you when it fails — proven with a real broken change. One of the two failures was the setup page claiming the installer was version 1.19.0 while machines got 1.22.0; that number is now gone rather than corrected, because the page cannot know it — the installer is fetched fresh each run, so any number there is a guess. A check refuses to let one be added back.
  • 2026-08-02 — Decided: the 20 GB backup partition goes away and shares space with app data. That changes the disk layout, so it happens before any machine is installed outside the house.
  • 2026-08-02 — Decided: only this machine and the tester's box are protected; every other box, demo boxes included, may be broken or reinstalled freely. Two of the three apps that never saved their data are fixed; this page created.