Context
Go modules often use pseudo-versions (v0.0.0-yyyymmddhhmmss-abcdef) and +incompatible tags. Adjacent scanners frequently mis-match these against advisory ranges (false positives/negatives). Contributors and CI authors need Vibgrate-specific docs for how local vg scan --vulns resolves Go versions against the advisory corpus — without implying network lookup unless the user opts in.
What to do
- Document observed matching rules for:
- pseudo-versions vs tagged releases
+incompatible major versions
- replace/exclude directives (high level; point to graph/scan behavior)
- Include a short “how to verify locally” snippet with
vg (fixture or minimal go.mod example).
- Call out honest limitations and how to file a false-positive with a reproducible local repro.
Acceptance
Context
Go modules often use pseudo-versions (
v0.0.0-yyyymmddhhmmss-abcdef) and+incompatibletags. Adjacent scanners frequently mis-match these against advisory ranges (false positives/negatives). Contributors and CI authors need Vibgrate-specific docs for how localvg scan --vulnsresolves Go versions against the advisory corpus — without implying network lookup unless the user opts in.What to do
+incompatiblemajor versionsvg(fixture or minimalgo.modexample).Acceptance
+incompatiblehandling invg scan --vulnsin contributor-friendly language