Cosa c'è di Nuovo

🎉Nuove Funzionalità

• AVIF Output via `format`: `convert_images` now accepts `format: "webp" | "avif"` (default `"webp"`). Pass `"avif"` to write `.avif` siblings instead of `.webp` — slower to encode but typically smaller at the same perceptual quality.
• Optional SHA-256 Manifest Output: Pass `manifest_path` to `convert_images` to have the server write a JSON manifest containing a SHA-256 fingerprint for every successful conversion. The response also includes a `manifest: { path, entries, generated_at }` summary — useful for CI jobs and audit trails.
• Cross-Tool Rate-Limit State with the CLI: The MCP server and the CLI now share the same on-disk `usage.json` rolling-window counter, so a Free-plan user who alternates CLI runs and MCP calls is throttled across both — not per-tool.

✨Miglioramenti

• `skipped_by_limit` Surfaced on Free-Tier Truncation: When a Free-plan `convert_images` call exceeds the 20-file cap, the response still reports `success: true` and now surfaces `skipped_by_limit` with the count of inputs the cap trimmed, plus `upgrade_url`. Agents can report the truncation cleanly instead of failing the task.

• Structured `error` Shape (Breaking): The `error` field changed from a plain string to an object: `{ code, message, context? }`. `code` is a stable identifier from the shared `ErrorCode` enum (e.g. `rate_limited`, `input_not_found`, `io_error`); `context` carries per-code details (for rate limiting: `delay_seconds` and `recent_calls`). Consumers doing `error === "rate_limited"` must migrate to `error?.code === "rate_limited"`.

🐛Correzione Bug

• Nonexistent Inputs and I/O Errors Now Return Structured Errors: Missing input paths and filesystem failures previously propagated raw exceptions back to the MCP client. They now map cleanly to `error.code: "input_not_found"` and `error.code: "io_error"` with a readable `message`, so agents can branch on the code instead of parsing stack traces.
• Expired Pro Licenses Correctly Fall Back to Free Limits: An expired Pro license previously kept Pro-tier limits in effect. It now correctly falls back to Free-tier limits and tarpit behavior. `get_status` still reports the original license type so clients can distinguish "never paid" from "paid but expired".

🎉Nuove Funzionalità

• AVIF Output via `--format`: Use `getwebp convert --format avif` to write `.avif` files instead of `.webp`. Existing callers keep the same behavior because the default output format remains WebP.

✨Miglioramenti

• Absolute `outputPath` in JSON Results: Every successful `convert.completed` result now includes an absolute `outputPath`, making it easier for automation, MCP integrations, and downstream tools to locate the generated file.
• Safer AVIF Quality Fallback: When AVIF output is requested without an explicit `--quality`, the CLI now warns clearly and falls back to `quality=55` instead of pretending WebP auto-quality is available.

🐛Correzione Bug

• WordPress Queue NDJSON Parsing Fix: Fixed a critical integration bug where the WordPress plugin tried to `json_decode()` full NDJSON output, causing background CLI conversions to fail silently instead of reading the final `convert.completed` envelope.

🎉Nuove Funzionalità

• Structured JSON Output (NDJSON): Pass `--json` to any command for newline-delimited JSON output — every event has a consistent `type`, `@level`, and `data` envelope. Perfect for scripting and CI pipelines.
• Global Flags on All Commands: `--json`, `--quiet`, `--verbose`, `--debug`, and `--force` now work consistently across every subcommand — no more per-command restrictions.
• HTTP/HTTPS Proxy Support: Set `HTTP_PROXY`, `HTTPS_PROXY`, or `NO_PROXY` environment variables to route API requests through your corporate or local proxy. `GETWEBP_API_URL` replaces the old `API_BASE_URL`.

✨Miglioramenti

• Standardized Exit Codes: Exit codes are now consistent and documented: `0` success, `1` general error, `2` usage error, `3` auth error, `4` quota error. Shell scripts can now reliably branch on failure type.
• Atomic Config Writes: Configuration is now written atomically with a lockfile, preventing corruption when multiple processes run simultaneously.

🐛Correzione Bug

• Logout Security Hardening: Logout now verifies token removal by re-reading the config from disk — preventing a rare race where the in-memory cache still held the old token.

🎉Nuove Funzionalità

• Watch Mode — Stable Release: `getwebp convert --watch` is now production-ready. Automatically converts new and changed images in real time, with per-path coalescing to avoid duplicate work on rapid saves.
• Backfill Mode (`--backfill`): Start watch with `--backfill` to convert all existing unconverted images first, then switch to live watching — ideal for migrating large directories incrementally.
• .gitignore-Aware Ignore Rules: Watch mode respects `.gitignore` patterns automatically — files excluded from version control are also excluded from conversion.

✨Miglioramenti

• Error Recovery & Deduplication: Transient errors (disk full, temp failures) are retried with backoff. Repeated errors for the same file are deduplicated so your terminal stays readable.

🐛Correzione Bug

• License Plan Recognition Fix: Fixed an issue where some activated licenses were not correctly recognized as Pro, causing Pro features to be unavailable.

🎉Nuove Funzionalità

• Auto Quality (SSIM): Automatically finds the optimal WebP quality for each image. No more guessing — every file gets the smallest size that preserves visual fidelity. Disable with `--no-auto-quality`.
• HEIC & AVIF Input Support: Now accepts HEIC (iPhone photos) and AVIF images as input — convert them to WebP directly.
• Size Guard: WebP output is never larger than the original. If conversion would increase file size, the original is kept with metadata stripped.

✨Miglioramenti

• Zero Native Dependencies: No more native compilation issues — install is instant on any platform with zero system dependencies.

🎉Nuove Funzionalità

• CLI Launch: Install with `npx getwebp@latest` and start converting images from the command line. Supports WebP, AVIF, and PNG output formats.
• Batch & Glob Processing: Convert entire directories or use glob patterns to process hundreds of images in one command.
• Watch Mode: Automatically convert new or changed images in a directory with `--watch` mode — ideal for development workflows.
• Quality & Resize Controls: Fine-tune output quality and resize images with `--quality` and `--width`/`--height` flags.
• Offline & Private: All processing happens locally on your machine. No images are uploaded anywhere — your files stay private.

🎉Nuove Funzionalità

• Chrome Web Store Launch: GetWebP is now publicly available on the Chrome Web Store. Install in one click and start converting images immediately.
• Local WebP Conversion: Convert PNG and JPG images to WebP entirely in your browser — no files are ever uploaded to a server, keeping your data fully private.
• Batch Processing: Select and convert multiple images at once, saving time on repetitive tasks.
• Right-click Context Menu: Right-click any image on any webpage to convert it to WebP instantly, without opening the extension popup.
• Adjustable Quality Settings: Fine-tune the output quality to balance file size and visual fidelity for each use case.