Metadata-Version: 2.4
Name: fss-core
Version: 0.3.3
Summary: FSS protocol primitives: provenance, integrity, auth, FIT
Project-URL: Repository, https://github.com/3soos3/fss-chassis
Author-email: 3soos3 <fss-chassis@3soos3.online>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: jcs>=0.2.0
Provides-Extra: auth
Requires-Dist: cryptography>=42.0.0; extra == 'auth'
Requires-Dist: httpx<1.0,>=0.25; extra == 'auth'
Requires-Dist: pyjwt>=2.8.0; extra == 'auth'
Description-Content-Type: text/markdown

# fss-core

[![PyPI](https://img.shields.io/pypi/v/fss-core)](https://pypi.org/project/fss-core/)
[![Python](https://img.shields.io/badge/python-3.11_%7C_3.12_%7C_3.13-blue)](https://pypi.org/project/fss-core/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/3soos3/fss-chassis/badge)](https://securityscorecards.dev/viewer/?uri=github.com/3soos3/fss-chassis)

Protocol primitives for the [Forensic Software Standards (FSS)](https://fss.3soos3.online) series. Used by FSS-compliant forensic tool providers to produce auditable, signed provenance records on every tool invocation.

## What it provides

- **`provenance`** — construct and sign `_provenance` blocks (FSS-0004)
- **`integrity`** — JCS (RFC 8785) canonical form and SHA-256 CAI hashes (FSS-0005)
- **`errors`** — standard FSS error codes (`FSS_AUTH_DENIED`, `FSS_RATE_LIMITED`, …)
- **`fss_context`** — context variables for investigation ID, FIT token, analyst identity

## Install

```bash
pip install fss-core

# with JWT/Ed25519 auth support (L2+):
pip install "fss-core[auth]"
```

## Links

- Repository: <https://github.com/3soos3/fss-chassis>
- FSS standard: <https://fss.3soos3.online>
- OpenSSF Scorecard: <https://securityscorecards.dev/viewer/?uri=github.com/3soos3/fss-chassis>
- Security advisories: <https://github.com/3soos3/fss-chassis/security/advisories>
