feat: bug-report collector tools/bugreport.py and instructions/bug-report.md (#157)

Files changed:
- .gitea/workflows/ci.yml
- CHANGES.md
- INSTALL.md
- VERSION
- instructions/bug-report.md
- instructions/gates.md
- instructions/setup-instance.md
- instructions/upgrade-instance.md
- reports/CONTRACT.md
- tools/README.md
- tools/bugreport.py
- tools/chemenu/tests/test_bugreport.py

.gitea/workflows/ci.yml

@@ -279,3 +279,18 @@ jobs:
             echo "reports/telemetry/ exists in a fresh distributed instance - telemetry should default off"
             exit 1
           fi
+
+      - name: The bug-report collector works in the distribution
+        # tools/bugreport.py is the one part of the stack that must run when
+        # nothing else does, so it is exercised as shipped: from the export,
+        # on the runner's plain python3, in the instance the step above set up.
+        # The unit tests cover what it collects; this covers that it arrives.
+        run: |
+          set -eu
+          cd "$DIST_DIR"
+          python3 tools/bugreport.py --no-trace
+          bundle=$(ls -d reports/bugreport-*/ | head -n 1)
+          test -f "$bundle/MANIFEST.md"
+          test -f "$bundle/environment.json"
+          grep -q '`wikitool` started' "$bundle/MANIFEST.md"
+          ls reports/bugreport-*.zip