fix(python): ship typing metadata and prepare 0.3.1

[sidmohan0]

Objective

Fix missing Python type information in published wheels. Consumers can import and type-check the compiled API, including finding properties, configuration dictionaries, and awaitable privacy operations. Closes #17.

Changes

• Package complete API stubs and py.typed in a mixed Python/Rust layout with explicit public re-exports. This also preserves typing metadata in wheels rebuilt from the source distribution.
• Add installed-wheel checks with mypy and Pyright: valid calls retain concrete types, invalid calls fail, and stubs cover every native export and read-only property. Run these checks across the Python CI matrix and after a source-distribution rebuild.
• Prepare 0.3.1 by aligning all package versions and lockfiles as required by release validation, and add release notes. Detection and transformation behavior are unchanged.

Verification

• cargo fmt --all --check
• cargo clippy --workspace --all-targets --all-features -- -D warnings
• cargo test --workspace --all-features (84 passed; one manual benchmark ignored)
• Python installed-wheel runtime and typing tests on CPython 3.10 and 3.14
• Source distribution rebuilt through pip; installed-wheel runtime and typing tests pass
• Pyright type completeness: all 110 public symbols have known types
• Regression test fails against the original wheel without typing metadata
• python3 scripts/check-release.py python
• Reviewed the diff for unrelated refactoring and duplicated binding logic

Detection behavior is unchanged, so detector-specific test changes are not applicable. Full PR CI must pass before merging; release tags will target the merge commit.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
data-fog	🟢 Ready	View Preview	Sep 9, 2026, 1:51 AM

💡 Tip: Enable Automations to automatically generate PRs for you.