Skip to content

docs(audit): v0.15.3 — correct stale references across CLAUDE.md and docs site#163

Merged
lewta merged 3 commits into
mainfrom
docs/v0.15.3-docs-audit
Mar 24, 2026
Merged

docs(audit): v0.15.3 — correct stale references across CLAUDE.md and docs site#163
lewta merged 3 commits into
mainfrom
docs/v0.15.3-docs-audit

Conversation

@lewta

@lewta lewta commented Mar 24, 2026

Copy link
Copy Markdown
Owner

Summary

Docs audit before v1.0.0 TUI work, plus a fix for the recurring flaky fuzz CI check.

Docs fixes (all staleness from features added after docs were last updated):

  • CLAUDE.md: fix Go download URL (go1.22go1.24); add burst to pacing modes; add internal/output and internal/pcap to key packages table
  • docs/_index.md: add burst to pacing modes description in the sections table
  • docs/dependencies.md: remove howett.net/plist from direct dependencies (it is // indirect in go.mod); correct count 13 → 12; remove from licence table

CI fix:

  • scripts/fuzz.sh: thin wrapper around go test -fuzz that tolerates the Go fuzz engine's known behaviour of reporting context deadline exceeded on -fuzztime expiry. Real findings (corpus entries written) are still caught and fail the job.
  • All fuzz steps in ci.yml updated to use the wrapper.

Cutting as v0.15.3 patch release after merge.

Test plan

  • CI passes — especially the fuzz job
  • Docs site builds cleanly

🤖 Generated with Claude Code

lewta and others added 3 commits March 24, 2026 12:51
…docs site

CLAUDE.md:
- Fix Go download URL: go1.22 → go1.24
- Add burst pacing mode to architecture notes
- Add internal/output and internal/pcap to key packages table

docs/_index.md:
- Add burst to pacing modes description in sections table

docs/dependencies.md:
- Remove howett.net/plist from direct dependencies (it is indirect)
- Correct dependency count: 13 → 12
- Remove plist from licence compatibility table

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
The Go fuzz engine occasionally reports "context deadline exceeded" and
exits non-zero when -fuzztime expires, instead of exiting cleanly. This
is a known Go fuzz engine behaviour unrelated to actual test failures.

Add scripts/fuzz.sh — a thin wrapper around go test -fuzz that:
- Passes on clean exit (exit 0)
- Passes on non-zero exit if output contains "context deadline exceeded"
  but no "Failing input written to" (the marker for a real finding)
- Fails on any other non-zero exit or if a corpus entry was written

Update all fuzz steps in ci.yml to use the wrapper.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@lewta lewta merged commit 0dd9dc8 into main Mar 24, 2026
12 checks passed
@lewta lewta deleted the docs/v0.15.3-docs-audit branch March 24, 2026 18:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant