jjj 0.4.1

Distributed project management and code review for Jujutsu
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

---
title: Critique Commands
description: CLI reference for creating, listing, editing, and resolving critiques
---

# Critique Commands

Critiques are criticisms of solutions. They track issues found during review, with severity levels and a lifecycle: open, addressed, valid, or dismissed. Critiques can reference specific files and lines.

## `jjj critique new`

Add a critique to a solution.

```
jjj critique new <solution_id> <title> [OPTIONS]
```

| Flag | Type | Default | Description |
|------|------|---------|-------------|
| `--severity` | string | `medium` | Severity: low, medium, high, critical |
| `--file` | string | | File path for code-level critique |
| `--line` | integer | | Line number for code-level critique |
| `--reviewer` | string | | Mark as a review request from this reviewer (e.g., `@alice`) |

When `--reviewer` is specified, the critique is created as a review request. The reviewer field indicates which reviewer should address this critique. This unifies the concepts of review requests and critiques into a single model.

```bash,test
jjj init
jjj problem new "Fix login flow"
jjj solution new "Refactor auth handler" --problem "Fix login"
jjj critique new "Refactor auth" "Missing error handling" --severity high
jjj critique new "Refactor auth" "Unused import" --severity low --file src/auth.rs --line 3
jjj critique list
```

## `jjj critique list`

List critiques.

```
jjj critique list [OPTIONS]
```

| Flag | Type | Description |
|------|------|-------------|
| `--solution` | string | Filter by solution |
| `--status` | string | Filter by status (open, addressed, valid, dismissed) |
| `--reviewer` | string | Filter by reviewer (e.g., `@alice`) |
| `--author` | string | Filter by critique author (substring match) |
| `--mine` | flag | Show only critiques authored by you |
| `--search` | string | Search critiques by title text |
| `--json` | bool | Output in JSON format |

```bash,test
jjj critique list --solution "Refactor auth"
jjj critique list --status open
jjj critique list --json
```

## `jjj critique show`

Show critique details.

```
jjj critique show <critique_id> [OPTIONS]
```

| Flag | Type | Description |
|------|------|-------------|
| `--json` | bool | Output in JSON format |

```bash,test
jjj critique show "Missing error"
jjj critique show "Missing error" --json
```

## `jjj critique edit`

Edit critique details.

```
jjj critique edit <critique_id> [OPTIONS]
```

| Flag | Type | Description |
|------|------|-------------|
| `--title` | string | New title |
| `--severity` | string | New severity (low, medium, high, critical) |
| `--status` | string | New status (open, addressed, valid, dismissed) |

```bash
jjj critique edit "Missing error" --severity critical --title "Missing error handling in auth"
```

## `jjj critique address`

Mark a critique as addressed (the solution was modified to fix the issue).

```
jjj critique address <critique_id>
```

```bash,test
jjj critique address "Missing error"
```

## `jjj critique validate`

Validate a critique (confirm it is correct; the solution should be withdrawn).

```
jjj critique validate <critique_id>
```

```bash
jjj critique validate "Missing error"
```

## `jjj critique dismiss`

Dismiss a critique (incorrect or irrelevant).

```
jjj critique dismiss <critique_id>
```

```bash
jjj critique dismiss "Unused import"
```

## `jjj critique reply`

Reply to a critique.

```
jjj critique reply <critique_id> <body>
```

```bash
jjj critique reply "Missing error" "Fixed in latest change, added error handling for all auth paths"
```