@mandors/cli 0.4.6 → 0.4.8
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/README.md
CHANGED
|
@@ -148,22 +148,19 @@ mandor feature create "Authentication" --project api \
|
|
|
148
148
|
|
|
149
149
|
```bash
|
|
150
150
|
# Create first task (no dependencies)
|
|
151
|
-
mandor task create api-feature-
|
|
151
|
+
mandor task create api-feature-xxxx "JWT Parser" \
|
|
152
152
|
--goal "Parse and validate JWT tokens in incoming requests with expiry and signature verification" \
|
|
153
153
|
--implementation-steps "Setup crypto library|Add token validation|Handle expiry|Return errors" \
|
|
154
154
|
--test-cases "Valid token accepted|Expired token rejected|Invalid signature rejected" \
|
|
155
|
-
--derivable-files "jwt_validator.go|jwt_test.go" \
|
|
156
155
|
--library-needs "golang-jwt" \
|
|
157
156
|
--priority P1
|
|
158
157
|
|
|
159
158
|
# Create dependent task (depends on JWT Parser)
|
|
160
|
-
mandor task create api-feature-
|
|
159
|
+
mandor task create api-feature-xxxx "Login Endpoint" \
|
|
161
160
|
--goal "Accept user credentials and return JWT token with refresh token flow" \
|
|
162
161
|
--implementation-steps "Setup endpoint|Validate credentials|Generate JWT|Return tokens" \
|
|
163
162
|
--test-cases "Valid creds return token|Invalid creds rejected|Tokens properly formatted" \
|
|
164
|
-
--
|
|
165
|
-
--library-needs "none" \
|
|
166
|
-
--depends-on api-feature-xxx-task-001 \
|
|
163
|
+
--depends-on api-feature-xxxx-task-xxxx \
|
|
167
164
|
--priority P1
|
|
168
165
|
```
|
|
169
166
|
|
|
@@ -171,7 +168,7 @@ mandor task create api-feature-xxx "Login Endpoint" \
|
|
|
171
168
|
|
|
172
169
|
```bash
|
|
173
170
|
# See all tasks in feature with visualization
|
|
174
|
-
mandor track feature api-feature-
|
|
171
|
+
mandor track feature api-feature-xxxx
|
|
175
172
|
|
|
176
173
|
# Get task details
|
|
177
174
|
mandor task detail <task-id>
|
|
@@ -185,7 +182,7 @@ mandor task update <task-id> --status in_progress
|
|
|
185
182
|
mandor task update <task-id> --status done
|
|
186
183
|
|
|
187
184
|
# Dependent tasks auto-transition to "ready"
|
|
188
|
-
mandor track feature api-feature-
|
|
185
|
+
mandor track feature api-feature-xxxx # Now shows "Login Endpoint" as ready
|
|
189
186
|
```
|
|
190
187
|
|
|
191
188
|
---
|
|
@@ -349,22 +346,21 @@ mandor feature create "Authentication" --project api \
|
|
|
349
346
|
--scope backend
|
|
350
347
|
|
|
351
348
|
# Create tasks with explicit dependencies
|
|
352
|
-
mandor task create api-feature-
|
|
349
|
+
mandor task create api-feature-xxxx "JWT Parser" \
|
|
353
350
|
--goal "Validate JWT tokens..." \
|
|
354
351
|
--implementation-steps "Step 1|Step 2" \
|
|
355
352
|
--test-cases "Test invalid tokens|Test expired" \
|
|
356
|
-
--derivable-files "jwt.go|jwt_test.go" \
|
|
357
353
|
--library-needs "jsonwebtoken" \
|
|
358
354
|
--priority P1
|
|
359
355
|
|
|
360
|
-
mandor task create api-feature-
|
|
356
|
+
mandor task create api-feature-xxxx "Login Endpoint" \
|
|
361
357
|
--goal "Accept credentials and return JWT..." \
|
|
362
|
-
--depends-on api-feature-
|
|
358
|
+
--depends-on api-feature-xxxx-task-xxxx \
|
|
363
359
|
--priority P1
|
|
364
360
|
|
|
365
361
|
# Real-time progress queries
|
|
366
|
-
mandor track feature api-feature-
|
|
367
|
-
mandor track task api-feature-
|
|
362
|
+
mandor track feature api-feature-xxxx # See all tasks and status
|
|
363
|
+
mandor track task api-feature-xxxx-task-xxxx # See specific task details
|
|
368
364
|
```
|
|
369
365
|
|
|
370
366
|
**Benefits:**
|
|
@@ -388,22 +384,21 @@ mandor status --project api
|
|
|
388
384
|
mandor track project api
|
|
389
385
|
|
|
390
386
|
# Create tasks with dependencies
|
|
391
|
-
mandor task create api-feature-
|
|
387
|
+
mandor task create api-feature-xxxx "Task" \
|
|
392
388
|
--goal "..." \
|
|
393
389
|
--implementation-steps "..." \
|
|
394
390
|
--test-cases "..." \
|
|
395
|
-
--derivable-files "..." \
|
|
396
391
|
--library-needs "..." \
|
|
397
|
-
--depends-on api-feature-
|
|
392
|
+
--depends-on api-feature-xxxx-task-xxxx
|
|
398
393
|
|
|
399
394
|
# See all feature tasks with status
|
|
400
|
-
mandor track feature api-feature-
|
|
395
|
+
mandor track feature api-feature-xxxx
|
|
401
396
|
|
|
402
397
|
# Mark as done (auto-unblocks dependents)
|
|
403
|
-
mandor task update api-feature-
|
|
398
|
+
mandor task update api-feature-xxxx-task-xxxx --status done
|
|
404
399
|
|
|
405
400
|
# Verify dependents auto-transitioned to ready
|
|
406
|
-
mandor track feature api-feature-
|
|
401
|
+
mandor track feature api-feature-xxxx
|
|
407
402
|
```
|
|
408
403
|
|
|
409
404
|
### Issue Tracking
|
|
@@ -510,13 +505,11 @@ Deep dependency chains (>5 levels) are hard to manage. Consider breaking into sm
|
|
|
510
505
|
|
|
511
506
|
```bash
|
|
512
507
|
# Good: tasks depend on other tasks in same feature
|
|
513
|
-
mandor task create api-feature-
|
|
508
|
+
mandor task create api-feature-xxxx "Task B" \
|
|
514
509
|
--goal "..." \
|
|
515
510
|
--implementation-steps "..." \
|
|
516
511
|
--test-cases "..." \
|
|
517
|
-
--
|
|
518
|
-
--library-needs "none" \
|
|
519
|
-
--depends-on api-feature-xxx-task-001
|
|
512
|
+
--depends-on api-feature-xxxx-task-xxxx
|
|
520
513
|
|
|
521
514
|
# Consider splitting if: task chains exceed 5 levels
|
|
522
515
|
```
|
|
@@ -528,12 +521,11 @@ mandor task create api-feature-xxx "Task B" \
|
|
|
528
521
|
|
|
529
522
|
```bash
|
|
530
523
|
# Feature work
|
|
531
|
-
mandor task create api-feature-
|
|
524
|
+
mandor task create api-feature-xxxx "Add OAuth2" \
|
|
532
525
|
--goal "..." \
|
|
533
526
|
--implementation-steps "..." \
|
|
534
527
|
--test-cases "..." \
|
|
535
|
-
--
|
|
536
|
-
--library-needs "..."
|
|
528
|
+
--library-needs "oauth2-lib"
|
|
537
529
|
|
|
538
530
|
# Bug fix
|
|
539
531
|
mandor issue create "Fix auth timeout" --project api --type bug
|
|
@@ -544,8 +536,8 @@ mandor issue create "Fix auth timeout" --project api --type bug
|
|
|
544
536
|
Always provide clear reasons when cancelling:
|
|
545
537
|
|
|
546
538
|
```bash
|
|
547
|
-
mandor task update api-feature-
|
|
548
|
-
mandor feature update api-feature-
|
|
539
|
+
mandor task update api-feature-xxxx-task-xxxx --cancel --reason "Superseded by feature X"
|
|
540
|
+
mandor feature update api-feature-xxxx --project api --cancel --reason "Sticking with JWT, OAuth2 adds too much complexity"
|
|
549
541
|
```
|
|
550
542
|
|
|
551
543
|
### 7. Use Pipe Separators For Lists
|
|
@@ -568,8 +560,8 @@ For flags accepting multiple values, use pipe separators:
|
|
|
568
560
|
Before making significant updates, preview with `--dry-run`:
|
|
569
561
|
|
|
570
562
|
```bash
|
|
571
|
-
mandor task update api-feature-
|
|
572
|
-
mandor feature update api-feature-
|
|
563
|
+
mandor task update api-feature-xxxx-task-xxxx --status done --dry-run
|
|
564
|
+
mandor feature update api-feature-xxxx --project api --cancel --reason "..." --dry-run
|
|
573
565
|
```
|
|
574
566
|
|
|
575
567
|
### 9. Dependency Auto-Resolution
|
|
@@ -601,10 +593,10 @@ mandor status --project api
|
|
|
601
593
|
mandor track project api
|
|
602
594
|
|
|
603
595
|
# See feature tasks
|
|
604
|
-
mandor track feature api-feature-
|
|
596
|
+
mandor track feature api-feature-xxxx
|
|
605
597
|
|
|
606
598
|
# See task details
|
|
607
|
-
mandor track task api-feature-
|
|
599
|
+
mandor track task api-feature-xxxx-task-xxxx
|
|
608
600
|
```
|
|
609
601
|
|
|
610
602
|
---
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|