Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
feat(lisdex): B63 - the six gates that graded a binary nothing proved matched its source
CarterPerez-dev0248d22652d3
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.shindex e2772840..32ff3589 100755--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.sh+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.sh@@ -4,6 +4,9 @@set -euo pipefail+# shellcheck source=scripts/magma-guard.sh+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"+MAGMA_SRC="${MAGMA_ROOT:-/opt/magma}"MAGMA="$MAGMA_SRC/magma"WORK="${MAGMA_WORK:-/opt/magma-work}"@@ -19,7 +22,7 @@ elseOUT_ROOT="$WORK/out/libpng-nonfatal"CANARY_MODE="FATAL canaries OFF - canaries LOG ONLY and execution continues into the real corruption"fi-HARNESS_SRC="${LISDEX_HARNESS:-/work/harnesses/libpng_read.c}"+HARNESS_SRC="$LISDEX_HARNESS_SRC"DRIVER="${LISDEX_AFL_DRIVER:-/usr/local/lib/afl/libAFLDriver.a}"HARNESS_BIN="lisdex_libpng_read"PATCH_STAMP="$TARGET/.lisdex-patched"@@ -208,6 +211,9 @@ doneprintf '\n'if [ "$FAILURES" -eq 0 ]; then+ # Written only here, so a build that failed verification never leaves a stamp claiming the+ # binaries match the source. The gates read it back and refuse to grade a stale target.+ lisdex_stamp_harness "$OUT_ROOT"printf '[lisdex] MAGMA LIBPNG TARGET READY (canaries ON, fixes OFF, %s)\n' "$CANARY_MODE"printf '[lisdex] fuzz target : %s\n' "$OUT_ROOT/afl/$HARNESS_BIN"printf '[lisdex] cmplog : %s\n' "$OUT_ROOT/cmplog/$HARNESS_BIN"diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.shindex aeaa4372..35931c3f 100755--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.sh+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.sh@@ -4,6 +4,9 @@set -euo pipefail+# shellcheck source=scripts/magma-guard.sh+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"+WORK="${MAGMA_WORK:-/opt/magma-work}"OUT_ROOT="$WORK/out/libpng"REPO="$WORK/libpng/repo"@@ -28,6 +31,7 @@ die() {[ -x "$OUT_ROOT/afl/$HARNESS_BIN" ] || die "target not built; run: just magma-libpng"[ -x "$OUT_ROOT/cmplog/$HARNESS_BIN" ] || die "cmplog target not built; run: just magma-libpng"+require_harness_current "$OUT_ROOT"log "stage 1/5: build lisdex CLI"cargo build -p lisdexdiff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.shindex 5408ecf4..0dc74007 100755--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.sh+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.sh@@ -4,6 +4,9 @@set -euo pipefail+# shellcheck source=scripts/magma-guard.sh+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"+WORK="${MAGMA_WORK:-/opt/magma-work}"OUT_ROOT="$WORK/out/libpng"SEEDS="$WORK/libpng/corpus/libpng_read_fuzzer"@@ -46,6 +49,7 @@ if [ "${1:-}" = "reset" ]; thenfi[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"+require_harness_current "$OUT_ROOT"[ -f "$DASH_MANIFEST" ] || die "run this from the project root; $DASH_MANIFEST not found"mkdir -p "$GATE" "$EMPTY"diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.shindex 38f6285c..aa91c0ff 100755--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.sh+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.sh@@ -4,6 +4,9 @@set -euo pipefail+# shellcheck source=scripts/magma-guard.sh+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"+WORK="${MAGMA_WORK:-/opt/magma-work}"OUT_ROOT="$WORK/out/libpng"SEEDS="$WORK/libpng/corpus/libpng_read_fuzzer"@@ -36,6 +39,7 @@ if [ "${1:-}" = "reset" ]; thenfi[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"+require_harness_current "$OUT_ROOT"[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"[ -d "$DICT_DIR" ] || die "AFL++ dictionaries missing at $DICT_DIR"diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.shindex 4f57cc98..8e22498d 100755--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.sh+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.sh@@ -4,6 +4,9 @@set -euo pipefail+# shellcheck source=scripts/magma-guard.sh+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"+WORK="${MAGMA_WORK:-/opt/magma-work}"REPO="$WORK/libpng/repo"OUT_ROOT="$WORK/out/libpng"@@ -41,6 +44,7 @@ fi[ -d "$REPO" ] || die "magma libpng not fetched; run: just magma-libpng"[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"+require_harness_current "$OUT_ROOT"[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"[ -d "$FIXTURES" ] || die "captured report fixtures missing at $FIXTURES"diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.shindex d91fd16f..9c0ab1dd 100755--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.sh+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.sh@@ -4,6 +4,9 @@set -euo pipefail+# shellcheck source=scripts/magma-guard.sh+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"+WORK="${MAGMA_WORK:-/opt/magma-work}"REPO="$WORK/libpng/repo"OUT_ROOT="$WORK/out/libpng"@@ -40,6 +43,7 @@ fi[ -d "$REPO" ] || die "magma libpng not fetched; run: just magma-libpng"[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"+require_harness_current "$OUT_ROOT"[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"[ -d "$FIXTURES" ] || die "captured report fixtures missing at $FIXTURES"diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.shindex 733260ed..ca675815 100755--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.sh+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.sh@@ -4,6 +4,9 @@set -euo pipefail+# shellcheck source=scripts/magma-guard.sh+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"+WORK="${MAGMA_WORK:-/opt/magma-work}"OUT_ROOT="$WORK/out/libpng"SEEDS="$WORK/libpng/corpus/libpng_read_fuzzer"@@ -54,6 +57,7 @@ if [ "${1:-}" = "reset" ]; thenfi[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"+require_harness_current "$OUT_ROOT"[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"[ -f "$TUI_MANIFEST" ] || die "run this from the project root; $TUI_MANIFEST not found"diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/magma-guard.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/magma-guard.shnew file mode 100644index 00000000..0f328acb--- /dev/null+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/magma-guard.sh@@ -0,0 +1,54 @@+# ©AngelaMos | 2026+# magma-guard.sh+# shellcheck shell=bash++# The hand-written magma harness is the one build input no stamp covered. `build-magma-libpng.sh`+# already refuses to run against a drifted magma commit or a changed canary selection, but the+# harness it compiles into the target was only ever existence-checked, so editing+# `harnesses/libpng_read.c` and running a gate graded the previous binary and reported PASS.+# Measured 2026-08-18: with LISDEX_MAX_PIXELS cut from 1<<24 to 1<<2, a change that rejects+# essentially every seed before it reaches png_read_row, `just m1-gate` still printed+# "M1 EXIT GATE PASSED" at exit 0 against a byte-identical binary.++LISDEX_HARNESS_SRC="${LISDEX_HARNESS:-/work/harnesses/libpng_read.c}"+LISDEX_HARNESS_STAMP_NAME=".lisdex-harness-sha"++lisdex_harness_sha() {+ sha256sum "$LISDEX_HARNESS_SRC" | cut -d' ' -f1+}++lisdex_stamp_harness() {+ local out_root="$1"+ lisdex_harness_sha > "$out_root/$LISDEX_HARNESS_STAMP_NAME"+}++# Sourced by every gate that runs the hand-written target, so the diagnosis is written once.+# Exits rather than returning: a gate that graded the wrong binary has no result worth printing.+require_harness_current() {+ local out_root="$1"+ local stamp="$out_root/$LISDEX_HARNESS_STAMP_NAME"+ local want have++ if [ ! -f "$LISDEX_HARNESS_SRC" ]; then+ printf '\n[gate] FAIL: hand-written harness missing at %s\n' \+ "$LISDEX_HARNESS_SRC" >&2+ exit 1+ fi++ want="$(lisdex_harness_sha)"++ if [ ! -f "$stamp" ]; then+ printf '\n[gate] FAIL: %s was built before the harness was stamped, so nothing proves it+ matches %s - run: just magma-libpng\n' "$out_root" "$LISDEX_HARNESS_SRC" >&2+ exit 1+ fi++ have="$(cat "$stamp")"+ if [ "$want" != "$have" ]; then+ printf '\n[gate] FAIL: %s changed since the target was built, so this gate would grade+ the previous binary - run: just magma-libpng+ source now : %s+ built from : %s\n' "$LISDEX_HARNESS_SRC" "$want" "$have" >&2+ exit 1+ fi+}