Skip to content

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 đŸ‘‡

feat(lisdex): scaffold workspace + campaign lifecycle core

CarterPerez-dev23bb143f05b3
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/.gitignore b/PROJECTS/advanced/zero-day-vulnerability-scanner/.gitignore
new file mode 100644
index 00000000..a3a86b28
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/.gitignore
@@ -0,0 +1,22 @@
+# ©AngelaMos | 2026
+# .gitignore
+
+# Dev-only docs (research / plans / context / handoffs) never ship to the public repo
+docs/
+
+# Rust build artifacts
+/target
+**/*.rs.bk
+Cargo.lock.bak
+
+# Fuzzing campaign working data
+/campaigns
+/corpus
+/crashes
+*.profraw
+*.profdata
+
+# Local env / secrets
+.env
+.env.*
+!.env.example
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.lock b/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.lock
new file mode 100644
index 00000000..3355e1f2
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.lock
@@ -0,0 +1,65 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "lisdex-core"
+version = "0.0.0"
+dependencies = [
+ "thiserror",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "syn"
+version = "3.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53e9bae58849f64dfa4f5d5ae372c8341f7305f82a3868709269343628b659a3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09a43598840e33d5b0331f38c5e30d13bb11c11210a4b58f0d9b18a5a5eefcd9"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "43cbfe0cf76104d42a574802844187e84a305e531ed54455f11fbde0f10541cd"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.toml b/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.toml
new file mode 100644
index 00000000..f5f64874
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.toml
@@ -0,0 +1,26 @@
+# ©AngelaMos | 2026
+# Cargo.toml
+
+[workspace]
+resolver = "3"
+members = ["crates/*"]
+
+[workspace.package]
+edition = "2024"
+rust-version = "1.97"
+license = "AGPL-3.0"
+authors = ["Carter Perez <[email protected]>"]
+
+[workspace.dependencies]
+thiserror = "2"
+
+[workspace.lints.clippy]
+all = { level = "warn", priority = -1 }
+pedantic = { level = "warn", priority = -1 }
+missing_errors_doc = "allow"
+missing_panics_doc = "allow"
+module_name_repetitions = "allow"
+
+[profile.release]
+lto = true
+codegen-units = 1
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/Cargo.toml b/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/Cargo.toml
new file mode 100644
index 00000000..ad994cdb
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/Cargo.toml
@@ -0,0 +1,16 @@
+# ©AngelaMos | 2026
+# Cargo.toml
+
+[package]
+name = "lisdex-core"
+version = "0.0.0"
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+authors.workspace = true
+
+[lints]
+workspace = true
+
+[dependencies]
+thiserror.workspace = true
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/src/campaign.rs b/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/src/campaign.rs
new file mode 100644
index 00000000..8bb9c978
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/src/campaign.rs
@@ -0,0 +1,115 @@
+// ©AngelaMos | 2026
+// campaign.rs
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum CampaignStatus {
+ Pending,
+ Building,
+ Fuzzing,
+ Completed,
+ Failed,
+}
+
+impl CampaignStatus {
+ #[must_use]
+ pub fn can_transition_to(self, next: CampaignStatus) -> bool {
+ use CampaignStatus::{Building, Completed, Failed, Fuzzing, Pending};
+ matches!(
+ (self, next),
+ (Pending, Building) | (Building, Fuzzing | Failed) | (Fuzzing, Completed | Failed)
+ )
+ }
+}
+
+#[derive(Debug, thiserror::Error, Clone, Copy, PartialEq, Eq)]
+#[error("illegal campaign transition from {from:?} to {to:?}")]
+pub struct TransitionError {
+ pub from: CampaignStatus,
+ pub to: CampaignStatus,
+}
+
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct Campaign {
+ target: String,
+ status: CampaignStatus,
+}
+
+impl Campaign {
+ #[must_use]
+ pub fn new(target: impl Into<String>) -> Self {
+ Self {
+ target: target.into(),
+ status: CampaignStatus::Pending,
+ }
+ }
+
+ #[must_use]
+ pub fn status(&self) -> CampaignStatus {
+ self.status
+ }
+
+ #[must_use]
+ pub fn target(&self) -> &str {
+ &self.target
+ }
+
+ pub fn advance(&mut self, next: CampaignStatus) -> Result<(), TransitionError> {
+ if self.status.can_transition_to(next) {
+ self.status = next;
+ Ok(())
+ } else {
+ Err(TransitionError {
+ from: self.status,
+ to: next,
+ })
+ }
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+
+ #[test]
+ fn new_campaign_starts_pending() {
+ let campaign = Campaign::new("libpng");
+ assert_eq!(campaign.status(), CampaignStatus::Pending);
+ assert_eq!(campaign.target(), "libpng");
+ }
+
+ #[test]
+ fn advance_follows_legal_transition() {
+ let mut campaign = Campaign::new("libpng");
+ assert!(campaign.advance(CampaignStatus::Building).is_ok());
+ assert_eq!(campaign.status(), CampaignStatus::Building);
+ }
+
+ #[test]
+ fn advance_rejects_illegal_transition() {
+ let mut campaign = Campaign::new("libpng");
+ let err = campaign.advance(CampaignStatus::Fuzzing).unwrap_err();
+ assert_eq!(err.from, CampaignStatus::Pending);
+ assert_eq!(err.to, CampaignStatus::Fuzzing);
+ assert_eq!(campaign.status(), CampaignStatus::Pending);
+ }
+
+ #[test]
+ fn pending_may_transition_to_building() {
+ assert!(CampaignStatus::Pending.can_transition_to(CampaignStatus::Building));
+ }
+
+ #[test]
+ fn completed_is_terminal() {
+ assert!(!CampaignStatus::Completed.can_transition_to(CampaignStatus::Building));
+ }
+
+ #[test]
+ fn building_may_fail() {
+ assert!(CampaignStatus::Building.can_transition_to(CampaignStatus::Failed));
+ }
+
+ #[test]
+ fn pending_may_not_skip_to_fuzzing() {
+ assert!(!CampaignStatus::Pending.can_transition_to(CampaignStatus::Fuzzing));
+ }
+}
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/src/lib.rs b/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/src/lib.rs
new file mode 100644
index 00000000..0507572d
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/src/lib.rs
@@ -0,0 +1,4 @@
+// ©AngelaMos | 2026
+// lib.rs
+
+pub mod campaign;
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/justfile b/PROJECTS/advanced/zero-day-vulnerability-scanner/justfile
new file mode 100644
index 00000000..aabf6709
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/justfile
@@ -0,0 +1,26 @@
+# ©AngelaMos | 2026
+# justfile
+
+set shell := ["bash", "-uc"]
+
+default:
+ @just --list
+
+build:
+ cargo build --workspace
+
+test:
+ cargo test --workspace
+
+clippy:
+ cargo clippy --workspace --all-targets
+
+fmt:
+ cargo fmt
+
+fmt-check:
+ cargo fmt --check
+
+lint: fmt-check clippy
+
+check: lint test
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/rust-toolchain.toml b/PROJECTS/advanced/zero-day-vulnerability-scanner/rust-toolchain.toml
new file mode 100644
index 00000000..94013440
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/rust-toolchain.toml
@@ -0,0 +1,6 @@
+# ©AngelaMos | 2026
+# rust-toolchain.toml
+
+[toolchain]
+channel = "1.97.0"
+components = ["rustfmt", "clippy"]