Files
felhom.eu/documentation/audits/endings-list-2026-11-10/tools/marks.py
T
admin 807175c27d
gates / gates (push) Successful in 2m1s
audits: the Endings list (2026-11-10) — 67 endings, 536 answers, 22 not found in 6 classes
What every thing a customer can end leaves behind, and who is told.
- documentation/audits/endings-list-2026-11-10/: README (one page), TABLE (67 endings x 8 questions,
  each answer with a mark and a pointer), MATRIX, the search list with controls, the helpers' raw
  answers, and the ageing drill on scratch guest 9202 (five rounds, put back).
- Marks: A 499, D 0, K 15, N 22. 9 endings are not named in the architecture folder.
- Register: six new rows, one per class (R-1373 … R-1378); 230 -> 236 open rows. Nine existing rows
  get a dated pointer line; none is closed, merged or re-ranked.
- STATUS.md: four decisions for the operator (D71 … D74).

No code change. No release. Machines: scratch guest 9202 only, put back.

Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
2026-11-10 13:52:31 +01:00

324 lines
35 KiB
Python

"""marks.py — the main session's rulings for the Endings list (2026-11-10). Data only; make-table.py reads it.
One entry for each ending that is in the table:
src (helper, index) the helper section the default answers come from (evidence/helpers/resolved-<helper>.json)
name the heading
seed the seed kind from the brief (App, Drive, Copies, Box, Household, Access, Versions, Outside)
named a fixed status with its reason, or ("grep", REGEX): 0 lines in the architecture folder = UNNAMED, else MENTIONED
o {question: (mark, answer, pointers)} — an answer the MAIN SESSION wrote after it read the source by eye.
A question with no entry here takes the helper's answer and the mark A; its pointers were opened by
resolve-helper.py (file exists, line exists, the named identifier stands at the line), not read by eye.
rb the ninth line: is the hand step written in a runbook?
"""
SEEN = "seed row %s in `EV/helpers/helper-docs.md`"
M = {
# ------------------------------------------------------------------ controller
"EC00": dict(src=("controller", 0), name="An app is removed and its data is kept", seed="App", named=("NAMED", SEEN % 1),
o={4: ("K", "Docker volumes with no name and the empty import folder stay. The kept data folder stays on purpose (see EC09).", "R-995"),
7: ("A", "A remove writes a 'remove pending' record first. A controller that starts and finds the record finishes the containers and volumes, and it does not delete drive data.",
"`CT/internal/stacks/delete.go:723` `CT/internal/stacks/remove_interrupted.go:48-94`")},
rb="yes — `RB/VOLUNTEER-first-hour.en.md:182`"),
"EC01": dict(src=("controller", 1), name="An app is removed with its drive data", seed="App", named=("NAMED", SEEN % 2),
o={4: ("K", "The empty parent folder on the drive stays.", "R-1276"),
7: ("A", "The start-up recovery finishes the containers and volumes. It does not delete drive data on its own: the household must press remove again.",
"`CT/internal/stacks/remove_interrupted.go:22-26`")},
rb="no hand step"),
"EC02": dict(src=("controller", 2), name="An app is removed with its backups", seed="App", named=("MENTIONED", SEEN % 3),
o={4: ("N", "The app's snapshots in the off-site store stay. The removal keeps them by ruling (closed R-474). No rule says when they end: the store keeps the last snapshots of each app for ever. "
"The restore copy does go (the open row R-1268 still says that it stays).",
"`AR/07-backup-architecture.md:380` `CT/internal/backup/offbox_window.go:80-82` `CT/internal/api/router.go:1064` · class E2 · S04")},
rb="no hand step"),
"EC03": dict(src=("controller", 3), name="An app's record is deleted by the second door (orphan delete)", seed="App", named=("grep", r"orphan.{0,40}(delete|stack)|DELETE /api/stacks"),
o={4: ("N", "This door removes the containers, the volumes and the stack record. It does not remove the undo copy, the update record or the backup folders that the normal remove takes away.",
"`CT/internal/stacks/delete.go:305-460` `CT/internal/api/router.go:1150-1178` · class E1 · S01"),
6: ("N", "The hub gets a fresh report and no 'app removed' event.", "`CT/internal/api/router.go:1150-1178` · class E5 · S01"),
7: ("N", "This door writes no 'remove pending' record. A controller that stops in the middle does not finish the job at the next start.",
"`CT/internal/stacks/delete.go:305-460` · class E6 · S01")},
rb="NO — no document says when to use this door"),
"EC04": dict(src=("controller", 4), name="An install fails or is cut", seed="App", named=("MENTIONED", SEEN % 4), o={}, rb="no hand step"),
"EC06": dict(src=("controller", 6), name="An update ends well", seed="Versions", named=("NAMED", SEEN % "28a"),
o={4: ("K", "The small helper image has no version and no cleaner. Old app images wait for the image clean-up (EC11).", "R-1372")},
rb="no hand step"),
"EC07": dict(src=("controller", 7), name="An update is undone or held", seed="Versions", named=("NAMED", SEEN % 5),
o={4: ("A", "The undo copy goes when the restore that lifts the hold ends (closed R-671). The hold logs stay on purpose: 400 lines for each service (closed R-651).",
"`CT/internal/backup/update_guard.go:694` `CT/cmd/controller/main.go:684`")},
rb="yes — `RB/VOLUNTEER-first-hour.en.md:182`"),
"EC08": dict(src=("controller", 8), name="The copy from a database conversion is released", seed="Copies", named=("grep", r"conversion.{0,60}(copy|kept|dump)"),
o={4: ("A", "The copy stays until a backup made after the conversion is proven. That is the rule, not a leftover.", "`AR/07-backup-architecture.md:1124-1125`")},
rb="no hand step"),
"EC09": dict(src=("controller", 9), name="Kept data of a removed app is deleted or used again", seed="App", named=("NAMED", SEEN % 1),
o={4: ("A", "Kept data has no age limit, on purpose. Only the household deletes it.", "`CT/internal/stacks/kept.go:39-42` `AR/07-backup-architecture.md:1045`")},
rb="no hand step"),
"EC11": dict(src=("controller", 11), name="Old app images are cleaned", seed="Versions", named=("grep", r"image.{0,30}(prune|clean-up|cleanup)"),
o={4: ("K", "Images with no version tag (the helper image) are outside the clean-up.", "R-1372")},
rb="no hand step"),
"EC12": dict(src=("controller", 12), name="A drive is retired by the household", seed="Drive", named=("NAMED", SEEN % 7),
o={4: ("A", "The apps that lived on the drive stay stopped, by design. The data on the drive stays; the host mount stays until the drive is gone (EA09).", None),
6: ("N", "The household sees the page. The handlers send no event to the hub; the operator learns it only from the next report.",
"`CT/internal/web/storage_handlers.go:521-780` · class E5 · S41")},
rb="no hand step"),
"EC13": dict(src=("controller", 13), name="An app's data is moved to another drive", seed="Drive", named=("grep", r"(migrat|move).{0,40}(another|other|new) drive"),
o={4: ("N", "A move of ONE app removes that app's data folder and its backup unit from the old drive. The restore copy, a set-aside backup and kept data of that app stay on the old drive. Only the move of ALL apps clears the old drive.",
"`CT/internal/stacks/migrate.go:616-654` · class E1 · S22")},
rb="no hand step"),
"EC14": dict(src=("controller", 14), name="A drive is ejected", seed="Drive", named=("MENTIONED", SEEN % 8),
o={4: ("A", "The agent takes the drive out of the guest and keeps the host mount, so that a drive that comes back binds again. It does not refuse when guests use the drive: it lists them in its answer.",
"`AG/internal/localapi/disks.go:537-556` `CT/internal/web/storage_handlers.go:1143-1200`")},
rb="no hand step"),
"EC15": dict(src=("controller", 15), name="A drive is wiped", seed="Drive", named=("grep", r"(wipe|format).{0,40}(drive|disk)"),
o={4: ("N", "The handler removes the drive from the registered places BEFORE the format. If the format then fails, the drive is not registered and still holds the old data. A failed eject is a warning only, and the handler does not look for apps on the drive.",
"`CT/internal/web/storage_handlers.go:911-1000` · class E6 · S21"),
6: ("N", "The household types a word to confirm. No event goes to the hub.", "`CT/internal/web/storage_handlers.go:911-1000` · class E5 · S41"),
7: ("N", "There is no record of a wipe in progress. A controller that stops between 'not registered' and 'formatted' leaves that state, and nothing finishes or undoes it.",
"`CT/internal/web/storage_handlers.go:911-1000` · class E6 · S21"),
8: ("A", "SOURCE only — no test pins the order of the steps.", "`CT/internal/web/storage_handlers.go:911-1000`")},
rb="no hand step"),
"EC16": dict(src=("controller", 16), name="A storage place or a network share is removed", seed="Drive", named=("grep", r"(storage path|network share).{0,60}remov"),
o={4: ("K", "The page does not name the backup copies on the other drive that stay.", "R-1064")},
rb="no hand step"),
"EC17": dict(src=("controller", 17), name="A restore ends: the copy of the old state", seed="Copies", named=("NAMED", SEEN % 12),
o={4: ("A", "A restore copy that nobody uses goes after 30 days. It also goes when the app's backups are removed.",
"`CT/internal/backup/restore_copy_sweep.go:29` `CT/internal/backup/restore_copy_sweep.go:89` `CT/internal/api/router.go:1064`")},
rb="yes — `RB/VOLUNTEER-first-hour.en.md:182`"),
"EC18": dict(src=("controller", 18), name="A whole restore from the second drive ends", seed="Copies", named=("grep", r"whole.{0,30}restore|before-restore"),
o={4: ("N", "The restore moves the old files beside the restored ones, with a fixed ending in the name. Nothing in the source removes them later, and no page lists them.",
"`CT/internal/backup/tier2_whole.go:52` `CT/internal/backup/tier2_whole.go:132` `CT/internal/backup/tier2_whole.go:345` · class E2 · S05")},
rb="no hand step"),
"EC19": dict(src=("controller", 19), name="A second-drive copy whose source is gone", seed="Copies", named=("NAMED", SEEN % 11), o={}, rb="no hand step"),
"EC20": dict(src=("controller", 20), name="A backup unit is set aside", seed="Copies", named=("NAMED", "`AR/07-backup-architecture.md:1800`"), o={}, rb="no hand step"),
"EC21": dict(src=("controller", 21), name="A copy fetched from the off-site store", seed="Copies", named=("MENTIONED", "`AR/07-backup-architecture.md:1019`"),
o={4: ("K", "The fetched copy has no age limit and no cleaner.", "R-1372")},
rb="no hand step"),
"EC22": dict(src=("controller", 22), name="Old local backups are cleaned", seed="Copies", named=("grep", r"retention"), o={}, rb="no hand step"),
"EC23": dict(src=("controller", 23), name="Old off-site snapshots are cleaned", seed="Copies", named=("NAMED", SEEN % 14),
o={4: ("N", "The weekly clean-up keeps the last snapshots of each app for ever, also for an app that is removed (same finding as EC02).",
"`CT/internal/backup/offbox_window.go:80-82` · class E2 · S04"),
7: ("K", "A clean-up that its own guard refuses removes nothing, and each refused week makes the next plan bigger.", "R-1294")},
rb="no hand step"),
"EC24": dict(src=("controller", 24), name="The off-site target is cleared on the box", seed="Copies", named=("grep", r"off-?site.{0,40}(target|config).{0,40}(clear|remov|unset)"), o={}, rb="no hand step"),
"EC25": dict(src=("controller", 25), name="An off-site store that belongs to nobody is reset", seed="Copies", named=("NAMED", SEEN % 14),
o={4: ("A", "The old history is moved aside and stays with no end date. The source says that this is on purpose: a box as delivered must not start a 14-day delete clock on a store it did not make.",
"`CT/internal/backup/offbox.go:473-481`")},
rb="no hand step"),
"EC26": dict(src=("controller", 26), name="An off-site store is abandoned (14 days)", seed="Copies", named=("NAMED", SEEN % 14), o={}, rb="no hand step"),
"EC27": dict(src=("controller", 27), name="An app is exported to a file or imported from one", seed="Copies", named=("grep", r"\.fab"),
o={4: ("N", "An exported file stays in the export folder of the drive. The export pages can start, list and read an export; none deletes one, and nothing ages it. Only half-uploaded parts are swept.",
"`CT/internal/web/handler_export.go:30-87` `CT/internal/web/handler_export_upload.go:400-416` · class E2 · S07"),
5: ("N", "An import over an installed app replaces the app's volumes. The import code makes no undo copy first.",
"`CT/internal/web/handler_export.go:312-356` `CT/internal/appexport/restore.go:288` · class E6 · S32")},
rb="no hand step"),
"EC28": dict(src=("controller", 28), name="The controller replaces itself (and the swap is rolled back)", seed="Versions", named=("NAMED", SEEN % "28a"), o={}, rb="no hand step"),
# ------------------------------------------------------------------ agent + installer
"EA00": dict(src=("agent", 0), name="The uninstall script on a host", seed="Box", named=("MENTIONED", SEEN % 19),
o={4: ("N", "The mount units and host mounts of household drives stay. This was said when R-179 closed, and capability A22 is PARTIAL, but no open row carries it. "
"The storage entries stay by the no-delete law. Not determined without a box: whether the role removal stops on an access rule that is left.",
"`E/scripts/felhom-host-install.sh:1109-1129` `E/scripts/felhom-host-install.sh:1359-1380` `AR/00-capability-map.md:98` · class E4 · S26")},
rb="yes — `RB/day0-install.md:490`"),
"EA01": dict(src=("agent", 1), name="The box is installed again on the same hardware", seed="Box", named=("NAMED", SEEN % 17),
o={4: ("K", "Each run leaves dated copies of the files it replaces.", "R-1368")},
rb="yes — `RB/day0-install.md:113`"),
"EA02": dict(src=("agent", 2), name="An install with --force over a guest", seed="Box", named=("grep", r"--force"), o={}, rb="yes — `RB/day0-install.md:113`"),
"EA03": dict(src=("agent", 3), name="The hardware is replaced (bring-up from the copies)", seed="Box", named=("NAMED", SEEN % 18), o={}, rb="yes — `RB/RUNBOOK-manual-guest-restore.md:1`"),
"EA04": dict(src=("agent", 4), name="The emergency password is replaced", seed="Access", named=("grep", r"break-glass.{0,60}(rotat|replac)"), o={}, rb="no hand step"),
"EA06": dict(src=("agent", 6), name="A drive is ejected (host side)", seed="Drive", named=("MENTIONED", SEEN % 8), o={}, rb="no hand step"),
"EA07": dict(src=("agent", 7), name="A drive is retired by the household (host side)", seed="Drive", named=("NAMED", SEEN % 7), o={}, rb="no hand step"),
"EA08": dict(src=("agent", 8), name="A drive is retired by a signed operator job", seed="Drive", named=("grep", r"signed.{0,60}decommission|decommission.{0,60}signed"),
o={4: ("N", "The signed job sets the 'retired' record and removes the drive from the guest's record. It does not take the drive out of the running guest, which the household's own door does.",
"`AG/internal/signedjobs/decommission.go:86-103` `AG/internal/localapi/disks.go:559-567` · class E1 · S20")},
rb="NO"),
"EA09": dict(src=("agent", 9), name="A retired drive that is gone is forgotten", seed="Drive", named=("NAMED", "`AR/03-host-agent.md:118`"),
o={4: ("A", "Only a drive that is retired AND gone is forgotten. An ejected drive that never comes back keeps its mount unit and its record, by design: it can come back.",
"`AG/internal/storage/forget_retired.go:10-20`")},
rb="no hand step"),
"EA10": dict(src=("agent", 10), name="A drive is formatted", seed="Drive", named=("grep", r"mkfs|format.{0,30}(drive|disk)"), o={}, rb="no hand step"),
"EA11": dict(src=("agent", 11), name="A drive is wiped by a signed job", seed="Drive", named=("grep", r"signed.{0,60}wipe|wipe.{0,60}signed"),
o={4: ("N", "The job formats the drive and touches neither the drive's record nor its mount unit. A wiped drive that was added before keeps a record and a unit that name the old filesystem.",
"`AG/internal/signedjobs/wipe.go:61-110` · class E4 · S20")},
rb="NO"),
"EA12": dict(src=("agent", 12), name="A network share is removed (host side)", seed="Drive", named=("grep", r"network (share|storage).{0,60}remov"), o={}, rb="no hand step"),
"EA14": dict(src=("agent", 14), name="A test guest of the restore test is removed", seed="Copies", named=("NAMED", "`AR/03-host-agent.md:524`"), o={}, rb="no hand step"),
"EA16": dict(src=("agent", 16), name="Old whole-guest copies are cleaned", seed="Copies", named=("grep", r"prune-backups|keep-last"),
o={4: ("K", "The clean-up rides the backup of a living guest on the present target. Copies of a guest that is gone, or copies on an old target, have no cleaner.",
"`AG/internal/backup/runner.go:138-160` · R-1087")},
rb="no hand step"),
"EA20": dict(src=("agent", 20), name="The target of the whole-guest copy is moved", seed="Copies", named=("UNNAMED", SEEN % 15),
o={4: ("K", "The copies on the old target stay.", "R-1087")},
rb="a dated record, not a procedure — `RB/RUNBOOK-vzdump-target-move-2026-07-29.md:1`"),
"EA21": dict(src=("agent", 21), name="The second off-site tier (ep0) is switched off", seed="Outside", named=("MENTIONED", "`AR/05-hub-architecture.md:391`"),
o={4: ("N", "Nothing is taken down: the storage entry, the token and the copies stay. The source calls the teardown 'a deliberate future op'; no row carries it.",
"`AG/internal/pbsdr/manager.go:274` `AG/internal/pbsdr/loop.go:15` · class E3 · S34")},
rb="NO"),
"EA22": dict(src=("agent", 22), name="A key ceremony runs out of time", seed="Access", named=("grep", r"ceremony.{0,60}(expir|timeout|time out)"), o={}, rb="no hand step"),
"EA23": dict(src=("agent", 23), name="The agent replaces itself", seed="Versions", named=("NAMED", SEEN % "28a"),
o={4: ("K", "Each update leaves its downloaded file in the update folder.", "`AG/internal/selfupdate/executor.go:100-172` · R-1368")},
rb="no hand step"),
"EA24": dict(src=("agent", 24), name="A signed file set or a system update is replaced (old kernels)", seed="Versions", named=("NAMED", "`AR/11-os-updates.md:1`"),
o={4: ("K", "Old kernels and dated copies of replaced files stay.", "R-1368")},
rb="no hand step"),
"EA25": dict(src=("agent", 25), name="An old published agent version", seed="Versions", named=("NAMED", SEEN % "28a"), o={}, rb="yes — `RB/RUNBOOK-manual-build.md:244`"),
"EA26": dict(src=("agent", 26), name="An old guest template (golden)", seed="Versions", named=("UNNAMED", SEEN % "28b"),
o={4: ("K", "Old templates stay on the host system disk.", "R-1368")},
rb="only a flag — `RB/day0-install.md:531`"),
"EA27": dict(src=("agent", 27), name="A guest's token is replaced", seed="Access", named=("grep", r"per-guest token|guest token"),
o={4: ("N", "A new token for the same guest number replaces the old one. The token store has no remove: the token of a guest that is destroyed stays valid until a new guest takes its number.",
"`AG/internal/localapi/tokenstore.go:127-210` · class E4 · S12")},
rb="no hand step"),
"EA28": dict(src=("agent", 28), name="The tunnel key is replaced", seed="Access", named=("NAMED", SEEN % 25), o={}, rb="no hand step"),
"EA29": dict(src=("agent", 29), name="The hub revokes the box's tunnel", seed="Access", named=("NAMED", SEEN % 27),
o={4: ("A", "The tunnel is switched off. The marker and the key stay on purpose, so that the box does not register again.", "`AG/internal/wgtunnel/manager.go:470-486`")},
rb="no hand step"),
# ------------------------------------------------------------------ hub
"EH00": dict(src=("hub", 0), name="The operator deletes a box in the hub", seed="Household", named=("NAMED", SEEN % 22),
o={4: ("N", "The delete removes the box, its guests, reports, keys and tunnel rows. Three tables keyed by the box have no delete statement at all: the box's update settings, its update reports and its kernel notices.",
"`HUB/store/store.go:3286-3328` `EV/hub-delete-statements.txt` · class E4 · S11")},
rb="no hand step"),
"EH01": dict(src=("hub", 1), name="The operator resets a household (RESET)", seed="Household", named=("NAMED", SEEN % 16),
o={4: ("N", "RESET takes the off-site account down only when the tier is ticked. A household whose tier was unticked before the RESET keeps its account and data at the provider, and the hub keeps no record of it.",
"`HUB/web/customer_reset.go:203-245` `HUB/web/configs.go:1737-1743` · class E3 · S09")},
rb="a draft — `RB/RUNBOOK-onboarding-draft-v4.md:217`"),
"EH02": dict(src=("hub", 2), name="The operator deletes a household", seed="Household", named=("NAMED", SEEN % 32),
o={4: ("N", "The purge walks seven tables. The off-site key rows, the off-site window rows and the abandon requests of the household have no delete statement in the hub source (the operator's action log and the two delete journals also stay; they read as kept records). The rows of EH00 stay too.",
"`HUB/store/customer_delete.go:55-66` `HUB/store/customer_delete.go:89-108` `EV/hub-delete-statements.txt` · class E4 · S11"),
6: ("K", "The operator gets a critical event and the dialog lists the outside objects. No mail goes to the household: a household that leaves has no designed path (capability E16, MISSING).",
"`HUB/web/customer_delete.go:306` · R-810 (`E/documentation/backlog/ROADMAP.md:59`)")},
rb="a draft — `RB/RUNBOOK-onboarding-draft-v4.md:217`"),
"EH03": dict(src=("hub", 3), name="The off-site account is taken down", seed="Outside", named=("NAMED", SEEN % 30),
o={4: ("K", "The account is an access object: taking it down does not remove the data folder behind it.", "R-32")},
rb="a draft — `RB/RUNBOOK-onboarding-draft-v4.md:217`"),
"EH04": dict(src=("hub", 4), name="The copies on ep0 are taken down", seed="Outside", named=("NAMED", SEEN % 31), o={}, rb="yes — `RB/ep0-datastore-copy.md:84` (the heading is stale)"),
"EH05": dict(src=("hub", 5), name="The tunnel and the DNS record of a deleted household", seed="Outside", named=("MENTIONED", SEEN % 29),
o={4: ("A", "They stay. The operator accepted that on 2026-10-05 (closed R-688); the dialog lists them for removal by hand. The capability map still says 'tunnel + zone removed'.",
"`HUB/web/customer_delete.go:319-339` `AR/00-capability-map.md:97`")},
rb="NO — the dialog names the objects; no runbook gives the steps"),
"EH06": dict(src=("hub", 6), name="The off-site tier is switched off for a household", seed="Outside", named=("grep", r"tier.{0,40}(untick|switched off|disabled)"),
o={4: ("N", "Unticking the tier takes nothing down and leaves no reminder. A later RESET or delete then skips the account (see EH01).",
"`HUB/web/configs.go:1737-1743` · class E3 · S09")},
rb="NO"),
"EH07": dict(src=("hub", 7), name="An old off-site copy is set aside, then abandoned", seed="Copies", named=("NAMED", SEEN % 14),
o={4: ("A", "A set-aside copy that nobody abandons stays. The architecture says so: no automatic abandon on a date.", "`AR/07-backup-architecture.md:2093`")},
rb="no hand step"),
"EH08": dict(src=("hub", 8), name="The window to clean the off-site store closes", seed="Access", named=("grep", r"offsite.{0,20}window|clean-up window"), o={}, rb="no hand step"),
"EH09": dict(src=("hub", 9), name="A key package is replaced and the old one is kept", seed="Access", named=("NAMED", "`AR/05-hub-architecture.md:236-254`"), o={}, rb="yes — `RB/RUNBOOK-open-retained-package.md:1`"),
"EH10": dict(src=("hub", 10), name="A box installs again and takes its old record", seed="Box", named=("NAMED", SEEN % 17), o={}, rb="yes — `RB/day0-install.md:113`"),
"EH11": dict(src=("hub", 11), name="A box enrolls again after a disaster (its hub key is replaced)", seed="Access", named=("NAMED", SEEN % 25),
o={6: ("A", "A hub log line only. The operator starts the recovery, so the operator knows.", "`HUB/api/dr.go:101-145`")},
rb="yes — `RB/RUNBOOK-manual-guest-restore.md:1`"),
"EH12": dict(src=("hub", 12), name="A box that never reports again", seed="Box", named=("grep", r"(silent|stale).{0,60}(for ever|forever|never)"),
o={4: ("A", "Nothing ends it. The record and everything that hangs on it stay until the operator deletes the box (EH00). The alarm is not repeated, by choice.",
"`HUB/monitor/host_staleness.go:60-70`")},
rb="NO"),
"EH13": dict(src=("hub", 13), name="The registered address of a household changes", seed="Household", named=("MENTIONED", SEEN % 24),
o={4: ("A", "The alarm address is a second, separate setting of the household (decision 196). A change of the registered address does not change it: alarms go to the old address until the household saves its notification page.",
"`HUB/web/configs.go:877-951` `HUB/store/store.go:1043-1050` `HUB/notify/dispatcher.go:352` `AR/09-update-architecture.md:1473`")},
rb="NO"),
"EH19": dict(src=("hub", 19), name="A tunnel peer is removed", seed="Access", named=("NAMED", SEEN % 27), o={}, rb="no hand step"),
"EH21": dict(src=("hub", 21), name="The hub's daily clean-up", seed="Household", named=("grep", r"(daily|nightly).{0,30}prune|Prune\("),
o={4: ("N", "The clean-up covers reports, events, app telemetry, log issues and log bundles. Thirteen tables have no delete statement anywhere; the file lists them. Most are small. The update reports of each box are the one that grows with time.",
"`EV/hub-delete-statements.txt` `HUB/store/store.go:1606` `HUB/store/store.go:2872` · class E4 · S37")},
rb="no hand step"),
"EH23": dict(src=("hub", 23), name="Old snapshots of the hub's database", seed="Outside", named=("NAMED", "`AR/05-hub-architecture.md:606-624`"), o={}, rb="no hand step"),
}
# Endings that are tiny and cannot grow: named once, not tabled (change 2 of D70). Helper section ids in brackets.
TINY = [
"an app is stopped (C05)", "the gate files of an install (C10)", "a catalog sync replaces the templates (C29)",
"the file browser's database is reset (C30)", "a launcher link (C31)", "a file share is removed (C32)",
"a session ends (C33)", "old metric rows (C34)", "the first-boot bootstrap file (A05)", "a half-written copy (A17)",
"a stale lock (A18)", "a claim code (H14)", "a bind link (H15; decision 210)", "a device registration (H16)",
"an operator token (H17)", "an operator session or password (H18)", "a finished signed job (H20)",
"a diagnostics upload (H22)", "a pruned artifact version (H24)",
]
# Left out for another reason, each with the reason.
LEFT_OUT = [
("A13 the internal place", "it has no ending"),
("A15 a leaked test guest", "the helper's leak claim was not confirmed; the architecture says the next run removes it (`AR/03-host-agent.md:524`, closed R-1298)"),
("A19 a guest snapshot", "the agent has the route, and no line in the controller calls it (grep `\"/snapshot` in `CT/`: 0 lines); no product path makes one"),
("A30 the controller swap rolled back", "it is the host half of EC28"),
("the hold logs of an update", "400 lines for each service, kept as evidence by closed R-651; an orphan delete removes them with the stack folder"),
("H08 key rows after the window closes", "tiny rows; inside EH21's count"),
]
# Seed endings from the brief that no code path carries.
NO_DOOR = [
("A household leaves Felhom", "K", "No designed path; capability E16 is MISSING. The pieces are EH01, EH02, EH03, EH04, EH05.", "R-810 (`E/documentation/backlog/ROADMAP.md:59`) `AR/00-capability-map.md:206`"),
("A tester ends", "N", "No handler and no runbook. It is done by hand with EH00 and EH02 (Peti's box, 2026-09-25); no list says what to collect from the tester or the box.", "`RB/target-selection.md:170` · class E3 · S40"),
("A drive is dead or is replaced", "A", "No single operation. The parts exist: move all apps (EC13) when the old drive still works; the restore paths when it does not.", "`AR/07-backup-architecture.md:1675-1676`"),
("An app is taken out of the catalog while installed", "A", "No ending by design: the app keeps full function.", "`AR/capability-map-detail/C.md:196`"),
("The guest is rebuilt in place", "A", "By hand, with a runbook.", "`RB/RUNBOOK-manual-guest-restore.md:1`"),
("The household's place on a mail list", "A", "No mail list exists in the source or in the documents. The mail service's own account was NOT MEASURED (fence: no account call).", "`EV/helpers/helper-docs.md:1`"),
("An old installer or install disc", "A", "Published by tag; an old one is replaced at the next publish. Old discs that people hold: NOT MEASURED.", "`E/INSTALLER-TAG:1`"),
]
CLASSES = {
"E1": "a second door that does less than the first",
"E2": "kept with no end named, and nobody is reminded",
"E3": "the outside part of an ending is by hand, or is not done at all",
"E4": "records of a thing that is gone",
"E5": "nobody is told",
"E6": "half-way with no finish, or no way back that nobody chose",
}
CLASS_ROW = {"E1": "R-1373", "E2": "R-1374", "E3": "R-1375", "E4": "R-1376", "E5": "R-1377", "E6": "R-1378"}
# Drill results (9202), appended to question 8. Filled after the drill ended.
DRILL = {}
# Second pass: a helper answer that still said "candidate" or "nothing found" does not enter the table as it stood.
# Each line below is the part that the main session confirmed; the unconfirmed part is left out (rule: verify before you state).
O2 = {
"EA00": {7: ("A", "Each step accepts 'already gone', and the state file goes last. A second run finishes the job. There is no journal.", None)},
"EA02": {4: ("A", "The flag removes nothing by itself. It lets the install go on, and the bring-up then destroys the guest. The log line says so before it happens.", "`E/scripts/felhom-host-install.sh:2362-2376`")},
"EA03": {4: ("A", "A guest that a crash leaves half-built can stay; the source names it as an accepted rest. A displaced volume whose delete fails is logged.", None)},
"EA06": {4: ("A", "The host mount stays after the eject, by design (see EC14).", "`AG/internal/localapi/disks.go:537-556`")},
"EA07": {4: ("A", "The host mount and its unit stay until the drive is gone. Then EA09 forgets them.", "`AG/internal/storage/forget_retired.go:10-20`")},
"EA10": {4: ("A", "Nothing found in the source. Not measured on a box: 9202 has no agent.", None)},
"EA14": {4: ("A", "A test guest that a crash leaves is removed by the next run.", "`AR/03-host-agent.md:524`")},
"EA22": {4: ("A", "Nothing on the box. The hub's side is EH09.", None)},
"EA25": {4: ("A", "Old versions stay published until the operator prunes them. The runbook has the step.", "`RB/RUNBOOK-manual-build.md:244`")},
"EA28": {4: ("A", "Nothing found in the source. Not measured on a box.", None)},
"EC04": {4: ("A", "The images that the failed install pulled stay until the image clean-up (EC11). Named volumes of an app that never ran stay until a remove. Both are by design.", None)},
"EC06": {7: ("A", "A controller that starts finishes or resumes an update that was cut.", None)},
"EC19": {4: ("A", "A kept second-drive copy stays until the household removes it. No age limit, by design.", None)},
"EC20": {4: ("A", "A set-aside unit stays with no limit, by design. The household removes it.", None)},
"EC22": {4: ("A", "One unit for each app; the newest replaces the last. There is nothing to prune.", None)},
"EC24": {4: ("A", "Clearing the target on the box deletes nothing at the far end. The far store ends only by the abandon path (EC26) or by the operator.", None)},
"EC26": {4: ("A", "A store whose delete fails stays due, and the box tries again each day.", None)},
"EC28": {4: ("A", "Nothing in the controller. The old container is the agent's to remove.", None)},
"EH04": {4: ("A", "A box delete alone keeps the copies on ep0, on purpose; the household delete takes them down. The copy of ep0 on DooPlex: NOT MEASURED (operator ruling: DooPlex is not measured).", "`RB/ep0-datastore-copy.md:84`")},
"EH08": {4: ("A", "One row for each clean-up window. The rows stay; they are counted in EH21.", "`EV/hub-delete-statements.txt`")},
"EH09": {4: ("A", "Kept packages only grow: each replace and each box delete adds one. That is the ruling: only the operator opens or removes one.", "`HUB/store/store.go:417-439`")},
"EH10": {4: ("A", "A box that installs again while its old record stands cannot enroll. The operator deletes the old record first; until then the old record alarms as silent (EH12).", None)},
"EH11": {4: ("A", "Nothing found in the hub source.", None)},
"EH19": {4: ("A", "The hub deletes the peer row first and pushes the change after. An end point that cannot be reached keeps the peer until the next push.", None)},
"EH23": {4: ("A", "A deleted household's rows stay in these snapshots for up to 8 weeks. The retention bounds it.", "`AR/05-hub-architecture.md:606-624`")},
}
for _k, _v in O2.items():
for _q, _t in _v.items():
M[_k]["o"].setdefault(_q, _t)
del M["EA04"]
TINY.insert(8, "the emergency password is replaced (A04)")
# The ageing drill on scratch guest 9202 (evidence/drill/, diff-all.txt). Added to question 8 of the ending it covered.
DRILL.update({
"EC00": "MEASURED on 9202 (`EV/drill/diff-all.txt`, snaps keep-2, drive-5, drive-7): the drive folder stays and the kept-data page lists it; the named volume goes.",
"EC01": "MEASURED on 9202 (`EV/drill/diff-all.txt`): ten install-and-remove rounds left nothing (snaps cheap-01…10). With a drive app (snap drive-2) one empty folder stayed, 4,096 bytes, and it does not grow with more rounds.",
"EC02": "MEASURED on 9202 (`EV/drill/diff-all.txt`, snap upd1-4): the remove took away the local unit, the second-drive copy and the restore copy. Off-site: 9202 has none.",
"EC06": "MEASURED on 9202 (snaps upd1-2, upd1-4): after the update the old image stayed (+0.8 GB); the remove took both images away.",
"EC09": "MEASURED on 9202 (`EV/drill/putback-1.txt`): the delete on the kept-data page removed the data and left the empty folder `appdata/grimmory` (the same leftover as R-1276).",
"EC17": "MEASURED on 9202 (snaps upd1-3, upd1-4): the restore made a restore copy (1.8 MB); the remove with backups took it away.",
})
# EA24: the helper cited a file with no extension, so the resolver made no pointer. Lines read by the main session.
for _q, _t, _p in (
(1, "Older root files, a staged kernel step and update leftovers end. The operator starts it with a signed job; the wrapper `felhom-os-apply` does the work.", "`AG/configs/felhom-os-apply:2113-2116` `AG/configs/felhom-os-apply:158` `AG/configs/felhom-os-apply:1488-1495`"),
(2, "Previous copies of each replaced root file, the used-number file, the package cache, the installed kernels, the one-shot boot flag and the default-kernel pin.", "`AG/configs/felhom-os-apply:189-190` `AG/configs/felhom-os-apply:127` `AG/configs/felhom-os-apply:144`"),
(3, "Keeps the newest 3 sets of previous copies and removes older sets. Cleans the package cache. Keeps on purpose: a plan that would remove a package is refused (rule R4), so the product never removes an old kernel. A cancelled kernel step leaves the package installed.", "`AG/configs/felhom-os-apply:2315-2318` `AG/configs/felhom-os-apply:1417` `AG/configs/felhom-os-apply:1369` `AG/configs/felhom-os-apply:1712`"),
(5, "Root files: a signed undo puts a kept previous copy back, 3 sets deep. Kernel: one revert into the old kernel, which is still the default.", "`AG/configs/felhom-os-apply:2294-2296` `AG/configs/felhom-os-apply:1488-1495`"),
(6, "The job result goes to the hub, and the wrapper writes its log.", "`AG/configs/felhom-os-apply:1488-1495` `AR/11-os-updates.md:1`"),
(7, "The used number is burned after the flip. After a reboot the wrapper reads what became of the kernel step and judges it.", "`AG/configs/felhom-os-apply:729` `AG/configs/felhom-os-apply:1488-1495`"),
):
M["EA24"]["o"].setdefault(_q, ("A", _t, _p))
# S41 found closed row R-888: the hub does not read `storage.decommissioned`, by ruling (decision 130). So "the hub is
# not told that a drive was retired" was CHOSEN: A, not N. The wipe (EC15) has no such ruling and stays N.
M["EC12"]["o"][6] = ("A", "The household sees the page. The box's report carries the retired drive, and the hub does not read that field: ruled 2026-10-05 (decision 130, closed row R-888) that the hub does not need it. No event goes to the hub.", "`E/documentation/backlog/CLOSED-ITEMS.md:994` `CT/internal/web/storage_handlers.go:521-780`")