Metadata-Version: 2.4
Name: live-casi
Version: 1.0.0
Summary: CASI structural-analysis toolkit for cipher validation, compression-assisted security indicators, and reproducible Nano-CASI artifacts.
Author-email: David Tom Foss <d.foss@ieee.org>
License-Expression: MIT
Project-URL: Homepage, https://github.com/DT-Foss/live-casi
Project-URL: Documentation, https://github.com/DT-Foss/live-casi#readme
Project-URL: Repository, https://github.com/DT-Foss/live-casi
Project-URL: Issues, https://github.com/DT-Foss/live-casi/issues
Project-URL: Nano-CASI-Artifact, https://github.com/DT-Foss/live-casi/tree/main/live_casi/artifacts/nano_casi_ieee_nano_2026
Keywords: cryptography,cryptanalysis,encryption,security,testing,validation,CASI,cipher,black-box,nano-iot,lightweight-cryptography,speck,simon,ieee-nano,pcap,network,tls,knowledge-graph,causal,channel-probe,inference,post-quantum,pqc,ml-kem,kyber,dilithium,hqc,ai-detection,academia,dissertation,plagiarism,chatgpt,deepl,text-analysis,authorship
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20
Provides-Extra: network
Requires-Dist: scapy>=2.5; extra == "network"
Provides-Extra: causal
Requires-Dist: dotcausal>=0.3.1; extra == "causal"
Provides-Extra: pqc
Requires-Dist: pqcrypto>=0.4.0; extra == "pqc"
Provides-Extra: academia
Requires-Dist: transformers>=4.20; extra == "academia"
Provides-Extra: all
Requires-Dist: scapy>=2.5; extra == "all"
Requires-Dist: dotcausal>=0.3.1; extra == "all"
Requires-Dist: pqcrypto>=0.4.0; extra == "all"
Requires-Dist: transformers>=4.20; extra == "all"
Dynamic: license-file

# live-casi

`live-casi` is a Python toolkit for Causal Amplification Security Index (CASI)
analysis of byte streams, lightweight-cipher outputs, post-quantum artifacts,
and related structural-integrity signals.

This repository also carries the reproducibility artifact for the IEEE NANO 2026
camera-ready paper:

**Compression-Based Trust Verification of Lightweight Ciphers Deployed in
Nano-IoT Communication Standards**

## Install

```bash
pip install live-casi
```

Optional extras:

```bash
pip install "live-casi[network]"   # pcap/network analysis
pip install "live-casi[causal]"    # causal graph export
pip install "live-casi[pqc]"       # post-quantum experiments
pip install "live-casi[academia]"  # text/PDF structural analysis
pip install "live-casi[all]"       # all optional dependencies
```

## Nano-CASI IEEE NANO 2026 Artifact

Version `1.0.0` includes the Nano-CASI camera-ready artifact under:

```text
live_casi/artifacts/nano_casi_ieee_nano_2026/
```

The artifact contains:

- `tables/full_coverage_matrix.csv`: full 41-cipher camera-ready matrix.
- `tables/representative_table.csv`: compact table used for paper reporting.
- `raw_data/`: full per-cipher sweeps grouped by family.
- `results/`: reduced-round, sample-sensitivity, aging, and sanitized master summaries.
- `figures/`: camera-ready figure source images.

Programmatic access after installation:

```python
from live_casi import nano_casi_artifact_path

artifact = nano_casi_artifact_path()
matrix = artifact / "tables" / "full_coverage_matrix.csv"
print(matrix)
```

The Speck rows use the camera-ready verdict `F8-DIST`: a full-round
cross-round statistical distinguisher under the F8 experiment, not a key
recovery result and not a practical chosen-plaintext or ciphertext-only
exploit.

## Core Usage

```python
import os
from live_casi import LiveCASI

engine = LiveCASI(key_size=32, window_keys=10_000)
engine.feed(os.urandom(320_000))
engine.force_update()

print(engine.current_casi)
print(engine.current_verdict)
```

Command line:

```bash
cat ciphertext.bin | live-casi
live-casi --file ciphertext.bin
live-casi --test
```

## Main Modules

| Module | Purpose |
| --- | --- |
| `live_casi.core` | CASI engine, structural strategies, CLI |
| `live_casi.ciphers` | Cipher generators used by the test suite |
| `live_casi.frontier` | Detection-boundary search |
| `live_casi.nist_compare` | CASI vs. NIST SP 800-22 comparison helpers |
| `live_casi.pqc` | Post-quantum compression-analysis helpers |
| `live_casi.network` | pcap and live-network analysis |
| `live_casi.causal` | causal graph export |
| `live_casi.academia` | text/PDF structural analysis |
| `live_casi.fingerprint` | stylometric fingerprinting |

## Development

```bash
python -m pip install -e ".[all]"
python -m pytest tests/test_casi.py
python -m build
```

## Citation

If you use the Nano-CASI artifact, cite:

```text
David Tom Foss, "Compression-Based Trust Verification of Lightweight Ciphers
Deployed in Nano-IoT Communication Standards," IEEE NANO, 2026.
```

## License

MIT
