ScottW514
c1591e4f69
The dated record of dev image 20260822135848: the campaign of every non-operator, non-live test at 18 of 18 PASS with the measured floors and the operating-point rule (cooling.fan-gate-trips and the hunt leg of cloud.mode-switch as recorded), and the unplugged-exhaust-fan drill: AIRFLOW at the grace plus three ticks with the exhaust dead, the other fans held, the reason relayed on the Grbl port, the replugged fan ok inside the next session's grace. The drill showed the fault riding into idle, where the hold canceled jogs and would have refused the cloud print that re-proves the fan. forgectrl pin d51dbdb: the fault ends with its run session, and the next session judges every fan afresh. cooling.fan-gate-trips checks the verdict is OK with no hold once the tripped session is over (the unit fake mirrors it); its covers, and the cooling tests' shared covers, gain src/coolfmt.* (the tree manifest carries the new files at the bumped pin, and the lint was right to ask). cloud.mode-switch samples the hunt's gate rows twice a second: a hunt's run phase is a few seconds long. Docs: COOLING 3a, BRINGUP item 19, CAMPAIGN-LOG.
forgetest - the ForgeFIRM release acceptance tool
The daemon behind http://<machine>:8090/ on the dev image: runs the
acceptance catalog against the machine, keeps the append-only result log,
decides which results still apply to the image that is running, exports
the release artifact scripts/release.sh gates on, and serves the bench
diagnostics page. The contract - catalog, campaigns, fingerprints,
inheritance, the gate, the coverage rule - is
docs/ACCEPTANCE.md.
Run the host tests
cd forgetest
python3 -m unittest discover -s tests -v
Run the daemon on a workstation (against a mock or a manifest file)
FORGETEST_DATA=/tmp/ft FORGETEST_MANIFEST=../tree-manifest.json \
FORGECTRL_URL=http://<machine>:8080 python3 -m forgetest --port 8090
scripts/manifest-from-tree.py produces tree-manifest.json from the recipe
pins; the coverage lint is python3 -m forgetest.coverage --manifest ....
Environment
| Variable | Default | Purpose |
|---|---|---|
FORGETEST_DATA |
/data/forgetest |
results.jsonl, bench.jsonl, token, export/ |
FORGETEST_MANIFEST |
/etc/forgefirm-manifest.json |
the image manifest |
FORGETEST_PORT, FORGETEST_HOST |
8090, 0.0.0.0 | listener |
FORGETEST_BENCH_DIR |
/usr/share/forgetest/bench |
the installed bench scripts |
FORGETEST_BENCH_DATA |
<FORGETEST_DATA>/bench |
passed to bench tools: where they keep their data files (with GF_HOST=127.0.0.1 and the panel token in GF_TOKEN) |
FORGETEST_MARKER |
/run/forgetest.active |
takeover marker |
FORGECTRL_URL, FORGECTRL_TOKEN_FILE |
http://127.0.0.1:8080, /data/forgefirm/panel.token |
forgectrl client |
GF_SYSFS_ROOT |
/sys/glowforge/ |
kernel module sysfs |
GRBL_HOST, GRBL_PORT |
127.0.0.1, 23 | Grbl TCP |
Adding a test
Register it in the subsystem module under forgetest/suite/ with
@test(...): id subsystem.name, kind, hardware, mode (the controller
mode the test needs; the runner switches to it first), covers,
requires, always, steps. The body gets a Context (log, check, fail,
prompt, confirm, instruct, sleep, evidence, forgectrl, sysfs,
grbl, takeover). Return normally for PASS, raise runner.Failed for
FAIL. Then run the unit tests and the coverage lint.