@mytechtoday/augment-extensions 1.2.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +2 -2
- package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +8 -8
- package/augment-extensions/workflows/beads/rules/best-practices.md +2 -2
- package/augment-extensions/workflows/beads/rules/file-format.md +4 -4
- package/augment-extensions/workflows/beads/rules/manual-setup.md +4 -4
- package/augment-extensions/workflows/beads/rules/workflow.md +2 -2
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -157,7 +157,7 @@ Use 'bd' for task tracking
|
|
|
157
157
|
1. **Create Task**: Append to `.beads/issues.jsonl` with unique hash-based ID
|
|
158
158
|
2. **Add Dependencies**: Use `blocks` and `blocked_by` fields
|
|
159
159
|
3. **Find Ready Tasks**: Tasks with no open blockers
|
|
160
|
-
4. **Work on Task**: Update status to `
|
|
160
|
+
4. **Work on Task**: Update status to `in_progress`, add comments
|
|
161
161
|
5. **Close Task**: Update status to `closed`
|
|
162
162
|
|
|
163
163
|
### Beads Files
|
|
@@ -246,7 +246,7 @@ const specsForFile = Object.entries(coord.specs)
|
|
|
246
246
|
|
|
247
247
|
1. **File issues for remaining work** - Create issues for anything that needs follow-up
|
|
248
248
|
2. **Run quality gates** (if code changed) - Tests, linters, builds
|
|
249
|
-
3. **Update issue status** - Close finished work, update
|
|
249
|
+
3. **Update issue status** - Close finished work, update in_progress items
|
|
250
250
|
4. **PUSH TO REMOTE** - This is MANDATORY:
|
|
251
251
|
```bash
|
|
252
252
|
git pull --rebase
|
|
@@ -95,14 +95,14 @@ Only `bd-a3f8.1` is ready because it has no blockers.
|
|
|
95
95
|
|
|
96
96
|
```bash
|
|
97
97
|
# With CLI
|
|
98
|
-
bd update bd-a3f8.1 --status
|
|
98
|
+
bd update bd-a3f8.1 --status in_progress
|
|
99
99
|
bd comment bd-a3f8.1 "Creating users table with email, password_hash, created_at columns"
|
|
100
100
|
```
|
|
101
101
|
|
|
102
102
|
**Without CLI** - Append to `.beads/issues.jsonl`:
|
|
103
103
|
|
|
104
104
|
```jsonl
|
|
105
|
-
{"id":"bd-a3f8.1","status":"
|
|
105
|
+
{"id":"bd-a3f8.1","status":"in_progress","updated":"2024-01-20T11:00:00Z"}
|
|
106
106
|
{"id":"bd-a3f8.1","comments":[{"text":"Creating users table with email, password_hash, created_at columns","timestamp":"2024-01-20T11:00:00Z"}],"updated":"2024-01-20T11:00:00Z"}
|
|
107
107
|
```
|
|
108
108
|
|
|
@@ -145,7 +145,7 @@ bd comment bd-a3f8.2 "Using bcrypt with cost factor 12"
|
|
|
145
145
|
bd close bd-a3f8.2
|
|
146
146
|
|
|
147
147
|
# Work on JWT generation
|
|
148
|
-
bd update bd-a3f8.3 --status
|
|
148
|
+
bd update bd-a3f8.3 --status in_progress
|
|
149
149
|
bd comment bd-a3f8.3 "Using HS256 algorithm, 24-hour expiry"
|
|
150
150
|
|
|
151
151
|
# Complete it
|
|
@@ -155,10 +155,10 @@ bd close bd-a3f8.3
|
|
|
155
155
|
**Without CLI** - Append to `.beads/issues.jsonl`:
|
|
156
156
|
|
|
157
157
|
```jsonl
|
|
158
|
-
{"id":"bd-a3f8.2","status":"
|
|
158
|
+
{"id":"bd-a3f8.2","status":"in_progress","updated":"2024-01-20T12:30:00Z"}
|
|
159
159
|
{"id":"bd-a3f8.2","comments":[{"text":"Using bcrypt with cost factor 12","timestamp":"2024-01-20T12:30:00Z"}],"updated":"2024-01-20T12:30:00Z"}
|
|
160
160
|
{"id":"bd-a3f8.2","status":"closed","closed":"2024-01-20T13:00:00Z","updated":"2024-01-20T13:00:00Z"}
|
|
161
|
-
{"id":"bd-a3f8.3","status":"
|
|
161
|
+
{"id":"bd-a3f8.3","status":"in_progress","updated":"2024-01-20T13:30:00Z"}
|
|
162
162
|
{"id":"bd-a3f8.3","comments":[{"text":"Using HS256 algorithm, 24-hour expiry","timestamp":"2024-01-20T13:30:00Z"}],"updated":"2024-01-20T13:30:00Z"}
|
|
163
163
|
{"id":"bd-a3f8.3","status":"closed","closed":"2024-01-20T14:00:00Z","updated":"2024-01-20T14:00:00Z"}
|
|
164
164
|
```
|
|
@@ -179,7 +179,7 @@ Now `bd-a3f8.4` is ready because both blockers are closed.
|
|
|
179
179
|
|
|
180
180
|
```bash
|
|
181
181
|
# With CLI
|
|
182
|
-
bd update bd-a3f8.4 --status
|
|
182
|
+
bd update bd-a3f8.4 --status in_progress
|
|
183
183
|
bd comment bd-a3f8.4 "POST /api/auth/login endpoint created, returns JWT on success"
|
|
184
184
|
bd close bd-a3f8.4
|
|
185
185
|
```
|
|
@@ -187,7 +187,7 @@ bd close bd-a3f8.4
|
|
|
187
187
|
**Without CLI** - Append to `.beads/issues.jsonl`:
|
|
188
188
|
|
|
189
189
|
```jsonl
|
|
190
|
-
{"id":"bd-a3f8.4","status":"
|
|
190
|
+
{"id":"bd-a3f8.4","status":"in_progress","updated":"2024-01-20T14:30:00Z"}
|
|
191
191
|
{"id":"bd-a3f8.4","comments":[{"text":"POST /api/auth/login endpoint created, returns JWT on success","timestamp":"2024-01-20T14:30:00Z"}],"updated":"2024-01-20T14:30:00Z"}
|
|
192
192
|
{"id":"bd-a3f8.4","status":"closed","closed":"2024-01-20T15:00:00Z","updated":"2024-01-20T15:00:00Z"}
|
|
193
193
|
```
|
|
@@ -266,7 +266,7 @@ What Beads tasks are ready to work on?
|
|
|
266
266
|
### Documenting Progress
|
|
267
267
|
|
|
268
268
|
```
|
|
269
|
-
Update Beads task bd-a3f8.2 to
|
|
269
|
+
Update Beads task bd-a3f8.2 to in_progress.
|
|
270
270
|
Add comment: "Using bcrypt with cost factor 12"
|
|
271
271
|
```
|
|
272
272
|
|
|
@@ -116,7 +116,7 @@ Deeper hierarchies become hard to manage.
|
|
|
116
116
|
Keep status current:
|
|
117
117
|
|
|
118
118
|
```
|
|
119
|
-
open →
|
|
119
|
+
open → in_progress → closed
|
|
120
120
|
```
|
|
121
121
|
|
|
122
122
|
### Use Blocked Status
|
|
@@ -223,7 +223,7 @@ Track who is working on what:
|
|
|
223
223
|
"id": "bd-a1b2",
|
|
224
224
|
"title": "Add authentication",
|
|
225
225
|
"assignee": "agent-1",
|
|
226
|
-
"status": "
|
|
226
|
+
"status": "in_progress"
|
|
227
227
|
}
|
|
228
228
|
```
|
|
229
229
|
|
|
@@ -64,7 +64,7 @@ Beads stores issues in `.beads/issues.jsonl` using JSONL (JSON Lines) format. Ea
|
|
|
64
64
|
|
|
65
65
|
- **id** (string): Unique hash-based ID, format: `bd-<hash>` or `bd-<hash>.<number>` for hierarchical
|
|
66
66
|
- **title** (string): Short description of the task
|
|
67
|
-
- **status** (string): One of: `"open"`, `"
|
|
67
|
+
- **status** (string): One of: `"open"`, `"in_progress"`, `"blocked"`, `"closed"`
|
|
68
68
|
- **created** (string): ISO 8601 timestamp
|
|
69
69
|
- **updated** (string): ISO 8601 timestamp
|
|
70
70
|
|
|
@@ -109,7 +109,7 @@ bd-a3f8.2 # Another task under epic
|
|
|
109
109
|
## Status Values
|
|
110
110
|
|
|
111
111
|
- **open** - Task is ready to work on (no blockers)
|
|
112
|
-
- **
|
|
112
|
+
- **in_progress** - Currently being worked on
|
|
113
113
|
- **blocked** - Waiting on dependencies
|
|
114
114
|
- **closed** - Completed or cancelled
|
|
115
115
|
|
|
@@ -227,7 +227,7 @@ Tasks that are related but not blocking:
|
|
|
227
227
|
|
|
228
228
|
```jsonl
|
|
229
229
|
{"id":"bd-a1b2","title":"Task 1","status":"open","created":"2024-01-20T10:00:00Z","updated":"2024-01-20T10:00:00Z"}
|
|
230
|
-
{"id":"bd-a1b2","status":"
|
|
230
|
+
{"id":"bd-a1b2","status":"in_progress","updated":"2024-01-20T11:00:00Z"}
|
|
231
231
|
{"id":"bd-a1b2","status":"closed","closed":"2024-01-20T12:00:00Z","updated":"2024-01-20T12:00:00Z"}
|
|
232
232
|
```
|
|
233
233
|
|
|
@@ -310,7 +310,7 @@ echo '{"id":"bd-a1b2","title":"New task","status":"open","created":"2024-01-20T1
|
|
|
310
310
|
### Start Work
|
|
311
311
|
|
|
312
312
|
```jsonl
|
|
313
|
-
{"id":"bd-a1b2","status":"
|
|
313
|
+
{"id":"bd-a1b2","status":"in_progress","updated":"2024-01-20T11:00:00Z"}
|
|
314
314
|
```
|
|
315
315
|
|
|
316
316
|
### Add Comment
|
|
@@ -63,7 +63,7 @@ Append a JSON line:
|
|
|
63
63
|
Append a JSON line with the same ID and updated fields:
|
|
64
64
|
|
|
65
65
|
```json
|
|
66
|
-
{"id":"bd-<hash>","status":"
|
|
66
|
+
{"id":"bd-<hash>","status":"in_progress","updated":"<ISO-8601>"}
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
### Closing Tasks
|
|
@@ -77,7 +77,7 @@ Append a JSON line with status "closed":
|
|
|
77
77
|
## Task States
|
|
78
78
|
|
|
79
79
|
- **open** - Ready to work on
|
|
80
|
-
- **
|
|
80
|
+
- **in_progress** - Currently being worked on
|
|
81
81
|
- **blocked** - Waiting on dependencies
|
|
82
82
|
- **closed** - Completed
|
|
83
83
|
|
|
@@ -100,7 +100,7 @@ Tasks are ready when:
|
|
|
100
100
|
1. Create task by appending to `.beads/issues.jsonl`
|
|
101
101
|
2. Add dependencies with `blocks`/`blocked_by` fields
|
|
102
102
|
3. Find ready tasks (no open blockers)
|
|
103
|
-
4. Update status to "
|
|
103
|
+
4. Update status to "in_progress"
|
|
104
104
|
5. Add comments as needed
|
|
105
105
|
6. Close task when complete
|
|
106
106
|
```
|
|
@@ -206,7 +206,7 @@ Parse .beads/issues.jsonl and find tasks where:
|
|
|
206
206
|
Ask your AI:
|
|
207
207
|
|
|
208
208
|
```
|
|
209
|
-
Update Beads task bd-a1b2 to status "
|
|
209
|
+
Update Beads task bd-a1b2 to status "in_progress"
|
|
210
210
|
Append an update to .beads/issues.jsonl
|
|
211
211
|
```
|
|
212
212
|
|
|
@@ -220,7 +220,7 @@ The AI will:
|
|
|
220
220
|
bd comment bd-a1b2 "Started implementation, added login endpoint"
|
|
221
221
|
|
|
222
222
|
# Update status
|
|
223
|
-
bd update bd-a1b2 --status
|
|
223
|
+
bd update bd-a1b2 --status in_progress
|
|
224
224
|
|
|
225
225
|
# Add labels
|
|
226
226
|
bd update bd-a1b2 --labels backend,auth
|
|
@@ -231,7 +231,7 @@ bd update bd-a1b2 --labels backend,auth
|
|
|
231
231
|
Append update to `.beads/issues.jsonl`:
|
|
232
232
|
|
|
233
233
|
```json
|
|
234
|
-
{"id":"bd-a1b2","title":"Implement user authentication","status":"
|
|
234
|
+
{"id":"bd-a1b2","title":"Implement user authentication","status":"in_progress","priority":0,"comments":[{"text":"Started implementation","timestamp":"2024-01-20T11:00:00Z"}],"updated":"2024-01-20T11:00:00Z"}
|
|
235
235
|
```
|
|
236
236
|
|
|
237
237
|
## Step 6: Close Task
|