DOCS/REFERENCE
REFERENCE10 MIN READUPDATED 03 SEP 2026

REFERENCE / 02

Policies decide what precision may travel.

Built-in modes, seven transformation actions, custom policy shape, and canonical hashes.
A policy maps each detected entity class to one explicit action. Privacy mode adds task-aware minimization behavior; it does not silently override credential blocking or the Vault boundary.
BUILT-IN POLICIES

Balanced, strict, and maximum

POLICYDEFAULT MODECHARACTER
balanced-v1balancedPseudonymize direct identifiers, generalize precision, remove unnecessary labeled facts, block credentials
strict-v1strictRemove contact, IP, bank, and wallet identifiers; preserve relational usefulness through controlled pseudonyms
maximum-v1maximumAggressive line minimization, organisation conceptualization, secret blocking, and local routing for health data
ACTION SET

Seven decisions—no ambiguous redact flag

01

KEEP

Preserve the value only when policy and purpose explicitly allow its precision.

02

REMOVE

Delete the value and do not create a reversible mapping.

03

PSEUDONYMIZE

Replace the value with a session-bound placeholder stored only in the Vault.

04

GENERALIZE

Reduce precision while keeping a useful category, band, or range.

05

CONCEPTUALIZE

Replace the literal with a role or semantic description.

06

BLOCK

Stop the operation because credential-like material must not proceed.

07

LOCAL_ONLY

Keep processing inside the trusted environment and prohibit external routing.

CUSTOM POLICY

Create a versioned rule set

  • policy_id must match the lowercase identifier pattern and be unique.
  • A custom policy contains one to 100 rules.
  • The server canonicalizes the complete policy and records its SHA-256 hash on each receipt.
  • Unknown entity classes fall back to pseudonymize in the current alpha.
JSONjson
{
  "policy_id": "legal-review-v1",
  "name": "Legal review",
  "description": "Retain obligations; minimize direct identity.",
  "rules": {
    "PERSON": { "action": "pseudonymize", "description": "Keep party relationships" },
    "EMAIL": { "action": "remove", "description": "Not needed for review" },
    "FINANCIAL_VALUE": { "action": "generalize", "description": "Preserve magnitude" },
    "PRIVATE_KEY": { "action": "block", "description": "Never externalize" }
  }
}
POLICY ACCEPTANCE

Test by entity class and failure mode

  1. 01

    FIXTURE

    Build an authorized synthetic corpus for every entity class relevant to the workflow.

  2. 02

    EXPECTED ACTION

    Declare the exact transformation and route for every fixture before running it.

  3. 03

    FALSE NEGATIVES

    Treat missed high-impact entities and credentials as release blockers.

  4. 04

    UTILITY

    Verify that protected output still supports the declared task instead of measuring privacy alone.

  5. 05

    HASH

    Record the policy hash with deployment and receipt evidence so later behavior can be attributed.

SHREDDAR DOCSYOUR DOC. YOUR DATA. YOUR CONTROL.

Public alpha documentation. Capability labels describe implementation state, not certification or guaranteed suitability.