Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[1.0.1] - 2026-02-23

Added

• Added .github/workflows/publish.yml to publish tagged releases to Clojars (or manual dispatch), preparing cljdoc indexing.
• Added :deps-deploy alias (slipset/deps-deploy) for Maven/Clojars deployment.

Changed

• build.clj now resolves version from PACLO_VERSION/tag context, writes Maven metadata (SCM/description/url), and adds a local install task.
• Switched publish/cljdoc coordinates from io.github.nantes-rfli/paclo to org.clojars.nanto/paclo.
• Added MIT license metadata to generated POM and added a repository LICENSE file.
• Rewrote user-facing docs in English and clarified README/docs structure for Clojars/cljdoc readers.
• Normalized docstrings/comments across source, examples, and tests for consistency.

[1.0.0] - 2026-02-23

Changed

• Promoted v1.0.0-rc.1 to stable v1.0.0.
• Kept the v1 API/CLI/BPF contracts, compatibility matrix, and CI gates established during RC.

[1.0.0-rc.1] - 2026-02-23

Changed

• Added :deps/prep-lib (build/javac) to enable Java class preparation for git dependencies before use.
• Updated install/release docs to require clojure -X:deps prep for first-time git dependency setup.

[1.0.0-rc] - 2026-02-23

Added

• Added docs/migration-0.4-to-1.0.md with a migration checklist, compatibility policy, CLI exit-code contract, and deprecation timeline notes.
• Added docs/release-v1-rc-checklist.md to standardize v1.0.0-rc release gates and tagging steps.
• Added .github/workflows/arm64-promotion-report.yml to report arm64 required-gate promotion readiness (14-day window, success/rerun/duration thresholds).
• Added dev/script/arm64_promotion_report.sh to compute the same arm64 promotion metrics locally via gh API.

Changed

• Roadmap progress for v1.0 Phase I is now tracked with concrete items (BPF error contract tests, invalid :filter contract test, migration guide draft).
• Docs index and README documentation links now include the 0.4 -> 1.0 migration guide.
• Added arm64 required-gate promotion criteria to the v1 freeze draft (success/flake/perf thresholds and promotion procedure).
• Updated README deps.edn install snippet from v0.3.0 to v0.4.0 tag/sha.
• Made arm64-monitor a required CI gate by removing continue-on-error (exception path without waiting 14-day observation window).
• Updated compatibility matrix macOS runner label to macos-latest (replacing unsupported macos-13 configuration).
• Isolated Clojure deps cache keys by runner.arch to prevent x64/arm64 cache cross-restore in CI jobs.
• Stabilized arm64 required gate by excluding paclo.pcap-loop-test from the gating test regex and running it as a non-gating observation step.
• Re-integrated paclo.pcap-loop-test into arm64 required unit tests after removing reflection-based PointerByReference mutation in tests.
• Recorded v1.0.0-rc local gate execution results in the release checklist and updated P3 acceptance progress in ROADMAP.

Tests

• Strengthened BPF error-contract tests to assert ex-message and ex-data for unknown proto/op and unsupported forms.
• Added explicit core/packets invalid-filter contract test (ex-message + ex-data).

[0.4.0] - 2025-12-10

Added

• DNS aggregation CLIs examples.dns-topn / examples.dns-qps (EDN/JSONL/CSV, async/drop/cancel, qname punycode normalization, SNI/ALPN aggregation, empty-bucket fill).
• Added four TLS sample PCAPs (tls-sni-sample.pcap, tls-sni-alpn-sample.pcap, tls-sni-h3-sample.pcap, tls-sni-alpn-h3mix-sample.pcap) and expanded smoke tests.
• Added DNS QPS benchmark reference to README/ROADMAP (dns-synth-small 10pkt, bucket=1000, decode?=true, ~16.2ms).
• CI: added dns-ext smoke (examples.dns-topn) and cljdoc CLI dry-run to the build job.
• CI: set coverage job to Temurin 17 with continue-on-error to mitigate cloverage native crashes.

Fixed

• Added --log-punycode-fail to dns-qps, aligning README/help with implementation; punycode decode failures now log WARN to stderr.

Notes

• Eastwood passes via -M:eastwood:dns-ext (+ data.xml); warnings limited to boxed-math/performance/reflection.
• nvd-clojure runs in GitHub Actions Dependency Audit using secrets.NVD_API_TOKEN; to reproduce locally set NVD_API_TOKEN and run clojure -M:nvd dev/nvd-clojure.edn "$(clojure -Spath -A:dev:dns-ext)".
• 2025-12-10: GitHub Actions "Dependency Audit" (nvd-clojure) completed with NVD_API_TOKEN, no critical CVEs.

[0.3.0] - 2025-12-05

Added

• TLS ClientHello SNI/ALPN decode extension (paclo.proto.tls-ext) and example examples.tls-sni-scan (EDN/JSONL).
• REPL pipeline benchmark sample numbers for small / mid (50k) / large (100k) synthetic PCAPs.
• Synthetic PCAP generator make-synth-pcap to reproduce benchmark inputs (count/caplen configurable).
• Property test to assert decode_ext isolates exceptions yet keeps later hooks running.
• Added decode_ext guard coverage for packets without :decoded or with :decode-error (hooks are skipped).
• Added JSONL metadata smoke test for examples.pcap-filter.
• Added opt-in --async support to pcap-filter / flow-topn / pcap-stats / dns-rtt (backpressure/drop/timeout demos).

Docs

• docs/extensions.md stability notes for decode_ext hooks (map-only apply, exception isolation, API compatibility).
• Roadmap updated to reflect Phase B progress and outstanding tasks; mid-size REPL turnaround numbers added; proto-dns split draft added (dev/proto-dns-split-plan.md).
• README REPL turnaround section now lists small/mid/large pipeline-bench samples.
• Aligned examples docs/help text (dns-summary alias hint, tls-sni-scan formats/tips), including shared EDN/JSONL flags and _ skip usage.
• Updated docs/extensions.md with v0.3 stability notes and explicit hook guard conditions.
• Added async opt-in examples and long-PCAP backpressure/drop observation steps to README (pcap-filter / flow-topn / pcap-stats / dns-rtt) and synced ROADMAP core.async progress.

Fixed

• examples.dns-summary help text now references the required :dns-ext alias.
• examples.tls-sni-scan accepts skipped optional args via _ and emits consistent format errors.
• BPF arg _ now correctly treated as "unset" in examples.pcap-filter / flow-topn / pcap-stats to match Usage tips.

Versioning / SemVer

This project follows SemVer. Until v1.0.0, minor versions may include breaking changes. Patch versions never do.

[0.2.0] - 2025-08-24

Added

• :xform transducer support in core/packets.
• BPF DSL extensions: :proto (:ip/:ipv4/:ip6/:ipv6), :src-net/:dst-net, :port-range variants.
• core/list-devices facade and minimal test.
• Golden PCAP round-trip tests and error propagation tests.

Changed

• Documentation: added roadmap and README Quick Start.

Fixed

• Stabilized AI_HANDOFF generation and primary links (ROADMAP added).