# Binary Diff Examples

This directory contains examples demonstrating the binary diff attestation feature.

## Prerequisites

- StellaOps CLI (`stella`) installed
- Access to a container registry
- Docker or containerd runtime (for image pulling)

## Examples

### Basic Comparison

[basic-comparison.md](./basic-comparison.md) - Simple binary diff between two image versions

### DSSE Attestation

[dsse-attestation.md](./dsse-attestation.md) - Generating and verifying DSSE-signed attestations

### Policy Integration

[policy-integration.md](./policy-integration.md) - Using binary diff evidence in policy rules

### CI/CD Integration

[ci-cd-integration.md](./ci-cd-integration.md) - GitHub Actions and GitLab CI examples

## Sample Outputs

The `sample-outputs/` directory contains:

- `diff-table.txt` - Sample table-formatted output
- `diff.json` - Sample JSON output
- `attestation.dsse.json` - Sample DSSE envelope

## Quick Start

```bash
# Compare two image versions
stella scan diff --base myapp:1.0.0 --target myapp:1.0.1

# Generate attestation
stella scan diff --base myapp:1.0.0 --target myapp:1.0.1 \
  --mode=elf --emit-dsse=./attestations/

# Verify attestation
stella verify attestation ./attestations/linux-amd64-binarydiff.dsse.json
```

## Related Documentation

- [Binary Diff Attestation Architecture](../../modules/scanner/binary-diff-attestation.md)
- [BinaryDiffV1 JSON Schema](../../schemas/binarydiff-v1.schema.json)
- [CLI Reference](../../API_CLI_REFERENCE.md#stella-scan-diff)