Repository navigation
0.1.0 - 2026-10-02
Release Notes
Added
piiflow, a deterministic, offline static analyser of personal-data flows in TypeScript,
JavaScript and Python, built on tree-sitter, with a shared IR, provenance-based call resolution
across files, workspace packages and tsconfig aliases, function summaries, and a worklist engine
that reconstructs one shortest cited path per (source, sink, category). A Datalog engine
(ascent) computes the same reachability and is the test oracle.- Rules PF001 to PF006 and PFC01, each with a documentation page, failing and passing fixtures in
both languages, and a control mapping pending review. - The catalogue as YAML: sinks for logs, error tracking, analytics, messaging, LLM providers,
outbound HTTP, browser storage and other processors; Express, Fastify, Next.js, FastAPI, Flask
and Django request input; default sanitisers and propagators; supported and unsupported
frameworks. Projects extend it in.privacy-flow.yml, validated by a published schema. - Commands
scan,diff,explain,check,validate,rules,doctor,completions,
manpage; outputs table, RFC 8785 JSON with a digest, SARIF 2.1.0 with code flows, Fides egress
declarations, in-toto Statement v1, facts (JSON lines) and a Markdown review queue. - Dispositions with
acc's semantics, carried across scans by line-independent finding IDs. - Coverage gaps for unresolved calls, dynamic calls, unresolved imports, the depth bound,
unsupported languages, frameworks and constructs, and parse errors; exit 4 whenever a clean
result cannot be claimed. - Ingestion of Fides data maps and privacy-datamap derived facts.
- A conformance corpus of 32 vectors with an external-runner contract, a composite GitHub Action,
criterion benchmarks, a CI performance budget, and a release pipeline with artifact
attestations, checksums and an SBOM.
Install privacy-flow 0.1.0
Install prebuilt binaries via Homebrew
brew install noru-tech/tap/piiflowDownload privacy-flow 0.1.0
| File | Platform | Checksum |
|---|---|---|
| privacy-flow-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| privacy-flow-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| privacy-flow-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| privacy-flow-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo noru-tech/privacy-flowYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation> --repo noru-tech/privacy-flow