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): scaffold workspace + campaign lifecycle core
CarterPerez-dev23bb143f05b3
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/.gitignore b/PROJECTS/advanced/zero-day-vulnerability-scanner/.gitignorenew file mode 100644index 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.examplediff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.lock b/PROJECTS/advanced/zero-day-vulnerability-scanner/Cargo.locknew file mode 100644index 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.tomlnew file mode 100644index 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 = 1diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/Cargo.toml b/PROJECTS/advanced/zero-day-vulnerability-scanner/crates/lisdex-core/Cargo.tomlnew file mode 100644index 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 = truediff --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.rsnew file mode 100644index 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.rsnew file mode 100644index 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/justfilenew file mode 100644index 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 testdiff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/rust-toolchain.toml b/PROJECTS/advanced/zero-day-vulnerability-scanner/rust-toolchain.tomlnew file mode 100644index 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"]