v0.3.1: Ignore system (.llmzipignore), API validation hardening, and post-audit stabilization

This release addresses stability, testing, and deployment issues identified during the post-v0.3.0 audit (covering ISSUE-01 to ISSUE-18 ), alongside introducing a new ignore file system.

Changelog

• feat(core): Implemented an ignore system ( .llmzipignore ) to exclude specific file patterns and paths during compression and batch processing ( ISSUE-01 ).
• fix(api): Avoided a KeyError when logging messages with a custom extra 'filename' key by renaming the property to 'input_filename' .
• refactor(api): Centralized and unified the warning generation logic ( get_warning ) using clean " | " formatting delimiters ( ISSUE-09 ).
• fix(core): Read package version dynamically via importlib.metadata to prevent startup import crashes ( ISSUE-02 ).
• fix(core): Implemented a reliable fallback behavior when LLMLingua-2 returns empty output due to over-compression or extreme thresholds ( ISSUE-05
• fix(core): Resolved API form validation issues on /v1/compress/file by using explicit Form() parameter annotations ( ISSUE-10 ).
• fix(core): Ensured configurable remote timeouts ( inference_timeout , scorer_timeout ) are strictly respected during split-mode communication ( ISSUE-06
• fix(pricing): Refactored local cache checks inside the pricing resolver to prevent redundant lock contentions and duplicate LiteLLM fetches. Updated fallback pricing metadata date to 2026-06-14 .
• fix(docker): Reorganized the monolith API Dockerfile ( ISSUE-03 ) and allowed the ready marker path to dynamically fall back to the MODELS_DIR environment variable.
• fix(docker): Reconfigured the interactive model downloader to dynamically parse the target port from the MODELS_URL environment variable.
• fix(tests): Removed module-level app instantiation ( ISSUE-04 ) and introduced lazy-loading ( ISSUE-08 ) to avoid premature crashes when .llmzip.config is missing during tests. Resolved test
contamination and Dockerfile factory pattern issues.

Upgrading from v0.3.0

This is a non-breaking, drop-in replacement version.

To configure ignored paths, you can create a .llmzipignore file in your working directory matching standard gitignore syntax.