Pagonic v0.4.0 — Safe ZIP Inspector

Pagonic v0.4.0

Pagonic is a security-aware Python ZIP inspection and safe extraction toolkit.
The core workflow is simple:

Inspect before you extract.

This release turns the 0.4 API polish work on main into a coherent public
release surface while keeping the project intentionally ZIP-focused.

Highlights

• Stable inspection, verification, and safe-extract workflows.
• Typed result contracts for archive, compression, extraction, and file metadata.
• Focused ZipReader, ZipWriter, and inspect_archive APIs.
• ZipHandler remains available as a compatibility facade for older callers.
• Defensive configuration state handling.
• Cross-platform path safety and deterministic risk reporting.
• Directly runnable inspect-first basic usage example.
• Public contribution, security reporting, issue templates, and a 0.5 roadmap.
• Optional GUI remains outside the base installation.

Validation

• Main test suite: 329 passed, 8 skipped.
• Comprehensive suite: 334 passed, 3 skipped.
• Source distribution and wheel build succeeded.
• pip check passed.
• Clean wheel installation and CLI smoke passed for version, help, compress,
  inspect JSON, verify, safe-extract dry-run, and extraction.

Scope and limitations

• This is an alpha-stage early public release.
• Pagonic is ZIP-focused and is not a general multi-format archive manager.
• It is not a replacement for 7-Zip or WinRAR.
• It is not presented as production-ready for critical automation.
• Benchmark output is intended for local regression tracking, not a universal
  performance claim.
• No PyPI or TestPyPI package is published as part of this release.
• The optional GUI is secondary to the library and CLI inspection workflow.

For migration details, see docs/migration-0.4.md. For planned work, see the
0.5 roadmap in docs/roadmap.md.