Skip to content

0.1.0 - 2026-10-02

Choose a tag to compare

@github-actions github-actions released this 02 Oct 12:47

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/piiflow

Download 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-flow

You 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