wayback-cache

# Wayback Cache Management

Manage the OS tmpdir-based cache for Wayback Machine API responses.

## Usage

```bash
npx tsx scripts/cache.ts <command> [options]
```

### Commands

| Command | Description |
|---------|-------------|
| `clear` | Clear all cached Wayback data |
| `status` | Show cache directory location and file count |

### Options

| Option | Description |
|--------|-------------|
| `--no-cache` | Bypass cache for single operation |

## Cache Location

Cached responses are stored in the OS temporary directory:
```
os.tmpdir()/wayback-cache/
```

Cache keys are generated from URLs and parameters using SHA-256 hashing.

## Cache TTL by Operation

| Operation | TTL | Rationale |
|-----------|-----|-----------|
| Availability API | 24 hours | Snapshots don't change often |
| CDX API | 1 hour | Snapshot list can change |
| Save status | 30 seconds | Only during polling |

Cached entries expire automatically and are deleted on access.

## Script Execution

```bash
npx tsx scripts/cache.ts <command> [options]
```

Commands:
- `clear` - Clear all cached Wayback data
- `status` - Show cache directory location and file count

## Clear Cache

Remove all cached API responses:
```bash
npx tsx scripts/cache.ts clear
```

This deletes all `.json` cache files from the cache directory.

## Check Cache Status

Display cache information:
```bash
npx tsx scripts/cache.ts status
```

Shows:
- Cache directory path
- Number of cached files
- Total cache size (if available)

## Usage Examples

```bash
# Clear all cache before checking a URL
npx tsx scripts/cache.ts clear
npx tsx scripts/check.ts https://example.com

# Clear cache, then list snapshots
npx tsx scripts/cache.ts clear
npx tsx scripts/list.ts https://example.com 20

# Check cache status
npx tsx scripts/cache.ts status
```

## Bypass Cache for Single Operation

Individual scripts support `--no-cache` to skip cache for one operation without clearing all cached data:

```bash
npx tsx scripts/check.ts https://example