blackvectorops/Semantic Firewall

Behavioral analysis engine for Go. Detects malware, proves loop equivalence, and enforces semantic immutability.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jul 4, 2026
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: blackvectorops/semantic_firewall@de79499c295c2b3947439f11bab85826f1060275 # v4.2.0

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
pathPath to file or directory to analyzeno.
modeOperation mode: check, diff, scan, or auditnocheck
go-versionGo version to useno1.24
signaturesPath to signature database (scan mode only). Required for scan mode.no""
thresholdMatch confidence threshold 0.0-1.0 (scan mode only)no0.75
strictEnable strict mode validation (check mode only)nofalse
fail-on-alertFail workflow if malware detected (scan mode only)notrue
scan-depsScan imported dependencies (scan mode only)nofalse
deps-depthDependency scan depth: direct or transitive (scan mode only)nodirect
api-keyLLM API Key (audit mode only). Required for intent verification.no
modelLLM Model to use (audit mode only).nogpt-4
api-baseCustom LLM API Base URL (audit mode only).no
namedescription
resultJSON output from the selected mode
alert-countNumber of malware alerts (scan mode)
deps-scannedNumber of dependency functions scanned (scan mode with --deps)
semantic-match-pctSemantic match percentage (diff mode)
audit-verdictFinal audit verdict (audit mode): PASS or FAIL