Reliability Evidence Pack

# Reliability Evidence Pack (REP)

A comprehensive runtime system for documenting and verifying agent operational reliability through structured artifact recording, validation, and compliance reporting.

## What's Included

### Core Scripts (`/scripts`)
- `rep.mjs` - Main CLI for initialization, validation, and bundle management
- `rep-validate.mjs` - Schema validation engine for REP artifacts
- `rep-heartbeat-cron.mjs` - Records agent heartbeats on a schedule
- `rep-near-miss-cron.mjs` - Tracks near-miss reliability events
- `rep-performance-baseline.mjs` - Captures performance metrics
- `rep-generate-bundle.mjs` - Generates REP bundles from artifacts

### CLI Package (`/cli`)
- Installable npm package for convenient command-line access
- See `cli/README.md` for installation and usage

### GitHub Action (`/github-action`)
- CI/CD integration for automated validation
- See `github-action/README.md` for setup

### Schemas (`/schemas`)
- JSON Schema definitions for all REP artifact types:
  - `decision_rejection_log.json`
  - `handoff_acceptance_packet.json`
  - `memory_reconstruction_audit.json`
  - `near_miss_reliability_trailer.json`
  - `signed_divergence_violation_record.json`

### Examples (`/examples`)
- Sample artifacts and workflows
- Integration patterns for different use cases

## Required Binaries

- **Node.js** (v16 or higher - required for runtime scripts)
- **npm** (for CLI package installation)

No other system binaries required.

## Installation

### Option 1: Direct Scripts
```bash
# Clone or copy this bundle to your project
cp -r rep-bundle-v2 /path/to/your/project/rep
cd rep

# Make scripts executable
chmod +x scripts/*.mjs

# Test
node scripts/rep.mjs --help
```

### Option 2: CLI Package
```bash
cd cli
npm install -g
rep --help
```

### Option 3: GitHub Action
```yaml
- uses: ./github-action
  with:
    bundle-path: ./rep
```

## Configuration

Set environment variables to configure behavior:

```bash
# Path to artifacts directory (default: ./art...