Jasper Configguard

# Jasper ConfigGuard v1.0.0

Safe config changes for OpenClaw with automatic rollback. Never brick your gateway again.

## Setup

```bash
npm install -g jasper-configguard
```

## Usage

### Apply a config change safely

```bash
jasper-configguard patch '{"gateway":{"bind":"tailnet"}}'
```

The tool will:
1. Back up your current config
2. Apply the patch (deep merge)
3. Restart the gateway
4. Wait for health check
5. **Auto-rollback** if gateway fails

### Preview changes

```bash
jasper-configguard patch --dry-run '{"agents":{"defaults":{"model":{"primary":"opus"}}}}'
```

### Restore from backup

```bash
jasper-configguard restore
```

### List backups

```bash
jasper-configguard list
```

### Check health

```bash
jasper-configguard doctor
```

## Agent Integration

Use from your agent to safely modify OpenClaw config:

```bash
# Safe model switch
jasper-configguard patch '{"agents":{"defaults":{"model":{"primary":"anthropic/claude-opus-4-5"}}}}'

# Enable a plugin safely
jasper-configguard patch '{"plugins":{"entries":{"my-plugin":{"enabled":true}}}}'

# If something breaks, restore
jasper-configguard restore
```

## API

```javascript
const { ConfigGuard } = require('jasper-configguard');
const guard = new ConfigGuard();

// Safe patch
const result = await guard.patch({ gateway: { bind: 'tailnet' } });
if (!result.success) console.log('Rolled back:', result.error);

// Dry run
const preview = guard.dryRun({ agents: { defaults: { model: { primary: 'opus' } } } });
console.log(preview.diff);
```

# 🛡️ jasper-configguard

Safe config changes for [OpenClaw](https://openclaw.ai) with automatic rollback. Never brick your gateway again.

## The Problem

One bad config change can take down your OpenClaw gateway. Missing a comma, wrong model name, invalid plugin path — and suddenly your AI agent is unreachable. You're SSH-ing in at 3am to manually restore a backup you hope exists.

## The Solution

`jasper-configguard` wraps every config change in a safety net:

1. **Backup** current config
2. **Apply** your patch (deep merge)
3. **Restart** the gateway
4. **Health check** (waits up to 30s)
5. **Auto-rollback** if gateway fails to come up

## Install

```bash
npm install -g jasper-configguard
```

Or use directly:

```bash
npx jasper-configguard patch '{"gateway":{"bind":"tailnet"}}'
```

## Usage

### Apply a config change safely

```bash
jasper-configguard patch '{"gateway":{"controlUi":{"enabled":true}}}'
```

### Preview changes (dry run)

```bash
jasper-configguard patch --dry-run '{"agents":{"defaults":{"model":{"primary":"anthropic/claude-sonnet-4-5"}}}}'
```

### From a file

```bash
jasper-configguard patch --file my-changes.json
```

### Restore last backup

```bash
jasper-configguard restore
```

### List backups

```bash
jasper-configguard list
```

### Show config diff

```bash
jasper-configguard diff
```

### Validate config

```bash
jasper-configguard validate
```

### Health check

```bash
jasper-configguard doctor
```

## Programmatic Usage

```javascript
const { ConfigGuard } = require('jasper-configguard');

const guard = new ConfigGuard({
  configPath: '~/.openclaw/openclaw.json',  // auto-detected
  timeout: 30,  // health check timeout in seconds
});

// Safe patch with rollback
const result = await guard.patch({
  gateway: { bind: 'tailnet' }
});

if (result.success) {
  console.log('Applied! Backup:', result.backupId);
} else {
  console.log('Rolled back:', result.error);
}

// Dry run
const preview = guard.dryRun({ agents: { defaults: { mod...