Add README, license, and check script

README.md

@@ -0,0 +1,72 @@
+# Vid-Repair
+
+Vid-Repair is a cross‑platform Rust CLI that scans video files for container/stream/decode problems and applies safe repairs using system `ffmpeg`/`ffprobe`.
+
+## Features
+
+- Scan: ffprobe metadata + ffmpeg decode pass
+- Data‑driven rulesets (TOML) with linting
+- Safe fix planning (remux/faststart) + optional aggressive re‑encode
+- Atomic replace + optional keep‑original
+- Watch mode with settle window
+- Text output by default, JSON with schema version
+
+## Requirements
+
+- `ffmpeg` and `ffprobe` available on PATH
+
+## Install
+
+```bash
+cargo build --release
+```
+
+## Usage
+
+```bash
+# Scan
+vid-repair scan /path/to/videos
+
+# Scan and watch for new files
+vid-repair scan --watch /path/to/videos
+
+# Fix (safe policy, in-place)
+vid-repair fix /path/to/videos
+
+# Fix with aggressive policy
+vid-repair fix --policy aggressive /path/to/videos
+
+# JSON output
+vid-repair scan --json /path/to/videos
+
+# Lint rulesets
+vid-repair rules lint
+```
+
+Exit codes:
+- `0` no issues
+- `1` issues found
+- `2` fix failed
+- `3` fatal error
+
+## Config
+
+On first run, a commented TOML config is created in the XDG config directory:
+
+- Linux: `~/.config/vid-repair/config.toml`
+- macOS: `~/Library/Application Support/vid-repair/config.toml`
+- Windows: `%APPDATA%/vid-repair/config.toml`
+
+CLI flags override config values.
+
+## Rulesets
+
+Rules are stored in `rulesets/*.toml`. Use `vid-repair rules lint` before shipping changes.
+
+## Fixtures
+
+Generate fixtures (git‑ignored) with:
+
+```bash
+scripts/generate_fixtures.sh
+```