git-slop 0.16.3

A deterministic repository token-defragmenter for humans and AI agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# Git Slop CLI Reference: `report`

Generated from the live Clap command tree.

## `git-slop report`

Validate or inspect the versioned report contract

**Usage**

```text
Usage: git-slop report <COMMAND>
```

**Machine contract:** schema 5 report (`git slop schema report`).

**Example**

```sh
git slop report validate .slop/latest/report.json
```

## `git-slop report validate`

Validate one report against the complete schema-5 contract

**Usage**

```text
Usage: git-slop report validate [OPTIONS] [REPORT_JSON]
```

**Machine contract:** schema 5 report (`git slop schema report`).

| Argument | Value | Default | Constraints | Description |
| --- | --- | --- | --- | --- |
| `path` | `REPORT_JSON` | `-` | - | Report JSON to validate |
| `--report` | `REPORT_JSON` | `-` | - | Report JSON to validate (alias for the positional path) |
| `--allow-legacy` | `flag` | `-` | - | Accept schema 4 as migration input and validate its normalized schema-5 form |
| `--format` | `FORMAT` | `text` | values: text, json, yaml | Success output format |

**Example**

```sh
git slop report validate .slop/latest/report.json
```

## `git-slop report migrate`

Migrate a schema-4 report to normalized schema 5

**Usage**

```text
Usage: git-slop report migrate --output <PATH> <REPORT_JSON>
```

**Machine contract:** schema 5 report (`git slop schema report`).

| Argument | Value | Default | Constraints | Description |
| --- | --- | --- | --- | --- |
| `path` | `REPORT_JSON` | `-` | required | Legacy report to migrate |
| `--output` | `PATH` | `-` | required | Destination for the normalized schema-5 report |

**Example**

```sh
git slop report migrate old.json --output report.json
```

## `git-slop report schema`

Print the published JSON Schema for report schema 5

**Usage**

```text
Usage: git-slop report schema
```

**Machine contract:** schema 5 report (`git slop schema report`).

**Example**

```sh
git slop report schema
```