---
title: "Phileas 4.0.0"
description: "Phileas 4.0.0 is on Maven Central: authenticated AES-GCM encryption, ReDoS guards, faster span handling, PhiSQL policy input, and a Java 25 build."
url: "https://philterd.ai/blog/phileas-4-0-0/"
---

[← All posts](https://philterd.ai/blog/)

# Phileas 4.0.0

By [Jeff Zemerick](https://philterd.ai/authors/jeff-zemerick/) June 10, 2026 [Phileas](https://philterd.ai/categories/phileas/)

[Phileas](https://philterd.ai/phileas/) 4.0.0 has been released and is available now on [Maven Central](https://central.sonatype.com/artifact/ai.philterd/phileas) as `ai.philterd:phileas:4.0.0`. This is a major version of the open source library that finds and redacts PII and PHI in text, and the engine underneath [Philter](https://philterd.ai/philter/). The headline themes are stronger cryptography, hardening against untrusted input, and a faster redaction pipeline.

## Security hardening

- **Authenticated encryption.** The encrypt and format-preserving encryption filter strategies now use authenticated AES-GCM in place of AES-CBC with a static IV. Encrypted values are both confidential and tamper-evident, and identical plaintext no longer produces identical ciphertext.
- **ReDoS protection.** A new configurable regex match timeout (`regex.timeout.ms`) guards user-supplied identifier and section patterns. A pathological or adversarial pattern can no longer hang the redaction pipeline.

## Performance

- **No more O(n^2) span shifting.** The replacement loop in the unstructured document processor was rewritten so applying redactions across many detected spans scales linearly instead of quadratically.
- **Precompiled regexes and a hand-written `Span.equals`** cut per-document overhead on the hot path.
- **Exact set lookups replace dictionary bloom filters,** removing the false-positive surface bloom filters carried while keeping lookups fast.

## New capabilities

- **PhiSQL as a policy input.** Policies can now be loaded from [PhiSQL](https://philterd.ai/blog/introducing-phisql-the-query-language-for-pii-operations/), the declarative query language for PII operations, via `Policy.fromPhiSQL`. Express what to detect and how to handle it in PhiSQL instead of hand-writing JSON.
- **Spelled-out ages.** The age filter now detects ages written as words, not just digits.
- **Valid VIN replacements.** Synthetic VIN replacements are generated only from the valid VIN character set (excluding I, O, and Q), so replaced values still pass VIN validation downstream.

Alongside these, 4.0.0 includes a batch of correctness fixes: a pseudonymization bug where a detected token equal to an existing replacement value could be left unredacted (surfacing as the literal text `null`), corrected sensitivity levels on fuzzy filters, and improved span disambiguation when multiple filters overlap.

## Breaking changes

This is a major version because it carries breaking changes. The largest is that the **redaction policy schema is now managed externally and upstream**, rather than living inside Phileas. Decoupling the schema from the library lets each evolve independently and lets the same schema be reused by other PII-focused applications. The full set of breaking changes and upgrade notes is in the [release notes](https://github.com/philterd/phileas/blob/4.0.0/RELEASE_NOTES.md).

## Upgrading

Phileas 4.0.0 is built on **Java 25**, so confirm your runtime before upgrading. Then bump the Maven coordinate:

```xml
<dependency>
    <groupId>ai.philterd</groupId>
    <artifactId>phileas</artifactId>
    <version>4.0.0</version>
</dependency>
```

See the [Phileas product page](https://philterd.ai/phileas/) for the full feature overview and the [documentation](https://philterd.github.io/phileas/) for configuration details, including the new `regex.timeout.ms` setting and PhiSQL policy loading.

* * *

**Related posts:**

- [Introducing PhiSQL: The Query Language for PII Operations](https://philterd.ai/blog/introducing-phisql-the-query-language-for-pii-operations/)
- [From Phileas to Philter: The Evolution of Our Open Source Engine](https://philterd.ai/blog/from-phileas-to-philter-the-evolution-of-our-open-source-engine/)

## Got a redaction problem that looks like this in your own pipeline?

Spend 30 minutes with Jeff (the engineer behind Philter) and walk away with a clear view of the architecture that fits your stack. No sales pitch.

[← Older post: philter-sdk-java 2.0.0: Built for Philter 4.0.0](https://philterd.ai/blog/philter-sdk-java-2-0-0/)

[Newer post →: How to Redact PII Before Sending to an LLM: Chat, RAG, and AI Agents](https://philterd.ai/blog/redact-pii-before-sending-to-an-llm/)

[← Back to all posts](https://philterd.ai/blog/)

Questions, ideas, or want to contribute? Join the conversation at [community.philterd.ai](https://philterd.ai/community/). Everything happens in public on GitHub.
