| Task | Status | Observed result | Evidence |
|---|
| Download and extraction | Pass | Outer ZIP and nested runtime ZIP available. | Script transcript in terminal; package files on disk. |
| Full progressive scan | Pass | Completed with $full_hosts admitted hosts. | summary, raw JSON |
| Host inventory | Pass | CSV inventory and host JSON generated. | CSV, host JSON |
| Discovery method summaries | Pass | Hostname, MAC, and port distribution summaries generated. | port frequency, MAC counts |
| SSE stream | Pass | Bounded event stream captured. | SSE events |
| Discovery-only scan | Pass | Completed with $disco_hosts admitted hosts. | summary |
| Baseline save and compare | Pass | Baseline $baseline_hosts hosts; current $current_hosts hosts; new $new_count, missing $missing_count, changed $changed_count. | compare JSON |
| History and schedule | Pass | History summary and daily 02:00 UTC schedule request captured. | history, schedule |
| HTML/PDF report endpoints | HTML pass; PDF checked | HTML report saved ($html_size bytes). $pdf_status. | HTML report, PDF response |
| Cleanup | Pass after script exit | $cleanup_status | cleanup log |
This report records observed evidence, not expected sample output. If host counts or MAC fields differ from the PDF examples, the JSON evidence files are the source of truth for this run.
HTML
}
cleanup_lab() {
if [ "$DRY_RUN" = "1" ]; then
return 0
fi
local abs_lab_dir="$ROOT_DIR/$LAB_DIR"
if [ ! -d "$abs_lab_dir" ]; then
return 0
fi
cd "$abs_lab_dir"
mkdir -p "$EVIDENCE_REL"
if [ "$KEEP_LAB" = "1" ]; then
echo "KEEP_LAB=1 set; compose stack left running for debugging." >"$EVIDENCE_REL/99-cleanup.txt"
return 0
fi
{
echo '$ docker compose down -v --remove-orphans'
docker compose down -v --remove-orphans
echo
echo '$ docker compose ps'
docker compose ps
} >"$EVIDENCE_REL/99-cleanup.txt" 2>&1 || true
if [ -f "$RESULTS_REL/index.html" ]; then
python3 - "$RESULTS_REL/index.html" "$EVIDENCE_REL/99-cleanup.txt" <<'PY'
from pathlib import Path
report = Path(__import__("sys").argv[1])
cleanup = Path(__import__("sys").argv[2])
text = report.read_text()
status = "Cleanup completed; compose stack and volume removal attempted. See cleanup evidence."
if cleanup.exists() and "NAME IMAGE" in cleanup.read_text():
status = "Cleanup completed; final docker compose ps was empty."
text = text.replace("Pending when report first written; see cleanup evidence after script exits.", status)
report.write_text(text)
PY
fi
}
main() {
trap cleanup_lab EXIT
download_and_extract
cd "$LAB_DIR"
mkdir -p "$EVIDENCE_REL"
{
echo "Started: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
echo "Root: $ROOT_DIR"
echo "Lab dir: $LAB_DIR"
echo "Subnet: $SUBNET"
echo "Note: this package uses student-lab, not students-labs."
} >"$EVIDENCE_REL/00-run-metadata.txt"
if [ "$DRY_RUN" = "1" ]; then
log "Dry run complete"
echo "$ROOT_DIR/$LAB_DIR"
return 0
fi
run_lab
write_html_report
log "Report generated"
echo "$ROOT_DIR/$LAB_DIR/$RESULTS_REL/index.html"
log "Verifying report links"
if [ ! -f "$EVIDENCE_REL/99-cleanup.txt" ]; then
echo "Cleanup pending; final cleanup evidence is written at script exit." >"$EVIDENCE_REL/99-cleanup.txt"
fi
missing=0
for href in $(grep -Eo 'href="[^"]+"' "$RESULTS_REL/index.html" | sed 's/^href="//; s/"$//' | grep '^evidence/'); do
if [ ! -e "$RESULTS_REL/$href" ]; then
echo "Missing linked evidence: $href" >&2
missing=1
fi
done
if [ "$missing" -ne 0 ]; then
exit 1
fi
echo "All report evidence links resolved." >"$EVIDENCE_REL/98-html-verification.txt"
}
main "$@"