cli-matrix

# Mallet CLI Matrix

Mallet's CLI generator is driven by deterministic, reviewable JSON:

- `packages/cli-matrix/data/flags.json` — individual flag definitions
- `packages/cli-matrix/data/commands.json` — commands composed from flags
- `packages/cli-matrix/data/templates.json` — systemd/docker/env templates
- `packages/cli-matrix/data/presets.json` — operator intent presets (safe bundles)

## Versioning
Every flag and preset is gated by a semver range:

```json
"available": { "min": "1.17.0", "max": "2.0.0" }
```

The generator will refuse to output invalid combos.

## Conflicts and implies
Flags can declare:

- `conflictsWith`: list of flags that cannot be used together
- `implies`: list of flags that should be added when this flag is present

## Deprecations
Flags can declare:

```json
"deprecated": { "since": "1.18.0", "message": "...", "replacedBy": "--new-flag" }
```

Mallet will surface warnings in the UI while still generating output if the flag is still available.