Open source · Security & Privacy

Data Retention Policy Linter

Check retention rules for data classes, environments and deletion jobs.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

Check exported data-class retention policies for owners, durations, legal-hold states, deletion-job references and conflicting environments.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+; inspect the source before using it on your own files.

Run the checked-in example

npm run example                                         # examples/clean,      exit 0
node bin/data-retention-policy-linter.mjs --root examples/broken      # exit 1
node bin/data-retention-policy-linter.mjs --root examples/held        # exit 1
node bin/data-retention-policy-linter.mjs --root examples/incomplete  # exit 2

Read the result

recommendation is one of eligible, blocked, blocked-by-hold or undecided, in reverse order of precedence: a hold outranks everything, an unknown outranks a known problem, and only eligible permits deletion.

Where this check stops

This tool reads four exported documents. Everything it says is a statement about those documents, and the list below is what it deliberately does not do and cannot conclude.

Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.

Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.