maxsimcli 5.0.3 → 5.0.5
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/dist/assets/CHANGELOG.md +17 -0
- package/dist/assets/hooks/maxsim-check-update.cjs +2 -1
- package/dist/assets/hooks/maxsim-check-update.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-notification-sound.cjs +3 -2
- package/dist/assets/hooks/maxsim-notification-sound.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-statusline.cjs +6 -4
- package/dist/assets/hooks/maxsim-statusline.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-stop-sound.cjs +3 -2
- package/dist/assets/hooks/maxsim-stop-sound.cjs.map +1 -1
- package/dist/assets/hooks/maxsim-sync-reminder.cjs.map +1 -1
- package/dist/assets/templates/commands/maxsim/quick.md +3 -5
- package/dist/assets/templates/references/thinking-partner.md +0 -2
- package/dist/assets/templates/skills/github-artifact-protocol/SKILL.md +0 -1
- package/dist/assets/templates/skills/github-tools-guide/SKILL.md +2 -9
- package/dist/assets/templates/templates/state.md +0 -10
- package/dist/assets/templates/workflows/execute.md +3 -3
- package/dist/assets/templates/workflows/go.md +1 -1
- package/dist/assets/templates/workflows/help.md +1 -2
- package/dist/assets/templates/workflows/new-milestone.md +1 -1
- package/dist/assets/templates/workflows/plan-create.md +1 -1
- package/dist/assets/templates/workflows/plan-discuss.md +1 -1
- package/dist/assets/templates/workflows/plan.md +4 -4
- package/dist/assets/templates/workflows/progress.md +0 -5
- package/dist/assets/templates/workflows/quick.md +1 -151
- package/dist/assets/templates/workflows/sdd.md +1 -1
- package/dist/assets/templates/workflows/verify-phase.md +2 -2
- package/dist/cli.cjs +8417 -8695
- package/dist/cli.cjs.map +1 -1
- package/dist/install.cjs +2 -1
- package/dist/install.cjs.map +1 -1
- package/package.json +1 -1
|
@@ -5,13 +5,11 @@ Before executing any step in this workflow, verify:
|
|
|
5
5
|
</sanity_check>
|
|
6
6
|
|
|
7
7
|
<purpose>
|
|
8
|
-
Execute small, ad-hoc tasks with MAXSIM guarantees (atomic commits, STATE.md tracking).
|
|
8
|
+
Execute small, ad-hoc tasks with MAXSIM guarantees (atomic commits, STATE.md tracking).
|
|
9
9
|
|
|
10
10
|
Quick mode spawns planner (quick mode) + executor(s), tracks tasks as GitHub Issues (label: "quick"), and updates STATE.md's "Quick Tasks Completed" table.
|
|
11
11
|
|
|
12
12
|
With `--full` flag: enables plan-checking (max 2 iterations) and post-execution verification for quality guarantees without full milestone ceremony.
|
|
13
|
-
|
|
14
|
-
With `--todo` flag (or trigger words): enters Todo Mode for listing, capturing, completing, and triaging todos via GitHub Issues.
|
|
15
13
|
</purpose>
|
|
16
14
|
|
|
17
15
|
<required_reading>
|
|
@@ -22,18 +20,9 @@ Read all files referenced by the invoking prompt's execution_context before star
|
|
|
22
20
|
**Step 1: Parse arguments and detect mode**
|
|
23
21
|
|
|
24
22
|
Parse `$ARGUMENTS` for:
|
|
25
|
-
- `--todo` flag → store as `$TODO_MODE` (true/false)
|
|
26
23
|
- `--full` flag → store as `$FULL_MODE` (true/false)
|
|
27
24
|
- Remaining text → use as `$DESCRIPTION` if non-empty
|
|
28
25
|
|
|
29
|
-
**Mode detection:** Enter Todo Mode if ANY of these are true:
|
|
30
|
-
1. `--todo` flag is present
|
|
31
|
-
2. `$DESCRIPTION` starts with "todo", "save", "remember", "later" (case-insensitive)
|
|
32
|
-
|
|
33
|
-
**If Todo Mode → skip to Step T1 (Todo Mode section below)**
|
|
34
|
-
|
|
35
|
-
If not Todo Mode, continue with Quick Task Mode:
|
|
36
|
-
|
|
37
26
|
If `$DESCRIPTION` is empty after parsing, prompt user interactively:
|
|
38
27
|
|
|
39
28
|
```
|
|
@@ -574,138 +563,6 @@ Ready for next task: /maxsim:quick
|
|
|
574
563
|
|
|
575
564
|
---
|
|
576
565
|
|
|
577
|
-
## Todo Mode
|
|
578
|
-
|
|
579
|
-
**Entered when `--todo` flag is set or description starts with "todo", "save", "remember", "later".**
|
|
580
|
-
|
|
581
|
-
```
|
|
582
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
583
|
-
MAXSIM ► TODO MODE
|
|
584
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
585
|
-
```
|
|
586
|
-
|
|
587
|
-
**Step T1: Initialize todo context**
|
|
588
|
-
|
|
589
|
-
```bash
|
|
590
|
-
INIT=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs init todos)
|
|
591
|
-
```
|
|
592
|
-
|
|
593
|
-
Extract from init JSON: `todo_count`, `todos`, `date`, `timestamp`, `github_ready`.
|
|
594
|
-
|
|
595
|
-
---
|
|
596
|
-
|
|
597
|
-
**Step T2: Determine todo action**
|
|
598
|
-
|
|
599
|
-
Parse `$DESCRIPTION` (text after `--todo` flag or trigger word) for intent:
|
|
600
|
-
|
|
601
|
-
| Intent | Trigger | Action |
|
|
602
|
-
|--------|---------|--------|
|
|
603
|
-
| List | No description, or "list", "show" | Go to **T3: List** |
|
|
604
|
-
| Capture | Has a description (not a trigger word) | Go to **T4: Capture** |
|
|
605
|
-
| Complete | "done", "complete", "finish" + identifier | Go to **T5: Complete** |
|
|
606
|
-
| Triage | "triage", "what next", "what should I work on" | Go to **T6: Triage** |
|
|
607
|
-
|
|
608
|
-
If intent is ambiguous, default to **T3: List** (shows todos, then offers options).
|
|
609
|
-
|
|
610
|
-
---
|
|
611
|
-
|
|
612
|
-
**Step T3: List Existing Todos**
|
|
613
|
-
|
|
614
|
-
```bash
|
|
615
|
-
node ~/.claude/maxsim/bin/maxsim-tools.cjs todos list
|
|
616
|
-
```
|
|
617
|
-
|
|
618
|
-
Display current todos in a clean table:
|
|
619
|
-
|
|
620
|
-
```
|
|
621
|
-
Pending Todos:
|
|
622
|
-
|
|
623
|
-
| # | Title | Area | Priority | Age |
|
|
624
|
-
|---|-------|------|----------|-----|
|
|
625
|
-
| 1 | [title] | [area] | [priority] | [relative time] |
|
|
626
|
-
|
|
627
|
-
---
|
|
628
|
-
|
|
629
|
-
Options:
|
|
630
|
-
1. Add a new todo: /maxsim:quick --todo [description]
|
|
631
|
-
2. Complete a todo: /maxsim:quick --todo done [number]
|
|
632
|
-
3. Triage: /maxsim:quick --todo triage
|
|
633
|
-
4. Back to quick tasks: /maxsim:quick [description]
|
|
634
|
-
```
|
|
635
|
-
|
|
636
|
-
If no pending todos: "No pending todos. Use `/maxsim:quick --todo [description]` to capture one."
|
|
637
|
-
|
|
638
|
-
Exit after display.
|
|
639
|
-
|
|
640
|
-
---
|
|
641
|
-
|
|
642
|
-
**Step T4: Capture New Todo**
|
|
643
|
-
|
|
644
|
-
If user provided a description:
|
|
645
|
-
|
|
646
|
-
1. Parse priority from description (look for HIGH/MEDIUM/LOW keywords, default MEDIUM)
|
|
647
|
-
2. Infer area from file paths mentioned or conversation context (default "general")
|
|
648
|
-
3. Create GitHub Issue (primary action):
|
|
649
|
-
- Run `github add-todo` with title, priority, area, and description to create a tracked GitHub Issue (label: "todo")
|
|
650
|
-
- If GitHub is unavailable, warn user: "GitHub unavailable. Run `/maxsim:init` to enable GitHub tracking."
|
|
651
|
-
|
|
652
|
-
```bash
|
|
653
|
-
node ~/.claude/maxsim/bin/maxsim-tools.cjs github add-todo --title "${TITLE}" --description "${DESCRIPTION}" --area "${AREA}"
|
|
654
|
-
```
|
|
655
|
-
4. Confirm: "Saved: ${TITLE} (priority: ${PRIORITY}) — GitHub Issue #{number}"
|
|
656
|
-
|
|
657
|
-
Exit after confirm.
|
|
658
|
-
|
|
659
|
-
---
|
|
660
|
-
|
|
661
|
-
**Step T5: Complete Todo**
|
|
662
|
-
|
|
663
|
-
If user references an existing todo to complete:
|
|
664
|
-
|
|
665
|
-
1. Parse identifier (number from list, or title fragment)
|
|
666
|
-
2. Close the corresponding GitHub Issue: run `github close-issue` with the todo's issue number
|
|
667
|
-
|
|
668
|
-
```bash
|
|
669
|
-
node ~/.claude/maxsim/bin/maxsim-tools.cjs github close-issue N
|
|
670
|
-
```
|
|
671
|
-
3. Confirm: "Completed: ${TITLE} — GitHub Issue closed"
|
|
672
|
-
|
|
673
|
-
Exit after confirm.
|
|
674
|
-
|
|
675
|
-
---
|
|
676
|
-
|
|
677
|
-
**Step T6: Triage**
|
|
678
|
-
|
|
679
|
-
Help user decide what to work on next:
|
|
680
|
-
|
|
681
|
-
1. List all pending todos sorted by priority (HIGH first)
|
|
682
|
-
2. Check if any todos relate to the current phase (cross-reference with ROADMAP.md):
|
|
683
|
-
|
|
684
|
-
```bash
|
|
685
|
-
ROADMAP=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs roadmap analyze)
|
|
686
|
-
```
|
|
687
|
-
|
|
688
|
-
3. Present prioritized view:
|
|
689
|
-
|
|
690
|
-
```
|
|
691
|
-
What should I work on?
|
|
692
|
-
|
|
693
|
-
## Phase-Related Todos
|
|
694
|
-
- [todo title] -- relates to Phase [N]: [phase name]
|
|
695
|
-
|
|
696
|
-
## Standalone Todos
|
|
697
|
-
- [HIGH] [todo title] (created [age] ago)
|
|
698
|
-
- [MEDIUM] [todo title] (created [age] ago)
|
|
699
|
-
|
|
700
|
-
---
|
|
701
|
-
|
|
702
|
-
Pick a todo to work on, or:
|
|
703
|
-
- /maxsim:quick [description] -- start a new task
|
|
704
|
-
- /maxsim:quick --todo [description] -- save something for later
|
|
705
|
-
```
|
|
706
|
-
|
|
707
|
-
Exit after display.
|
|
708
|
-
|
|
709
566
|
</process>
|
|
710
567
|
|
|
711
568
|
<success_criteria>
|
|
@@ -722,11 +579,4 @@ Exit after display.
|
|
|
722
579
|
- [ ] (--full) `${next_num}-VERIFICATION.md` created by verifier
|
|
723
580
|
- [ ] STATE.md updated with quick task row (Status column when --full)
|
|
724
581
|
- [ ] Artifacts committed
|
|
725
|
-
|
|
726
|
-
**Todo Mode:**
|
|
727
|
-
- [ ] `--todo` flag or trigger words detected
|
|
728
|
-
- [ ] Todo action determined (list/capture/complete/triage)
|
|
729
|
-
- [ ] (capture) GitHub Issue created with todo label
|
|
730
|
-
- [ ] (complete) GitHub Issue closed
|
|
731
|
-
- [ ] (triage) Prioritized view with phase context shown
|
|
732
582
|
</success_criteria>
|
|
@@ -35,7 +35,7 @@ Parse JSON for: `executor_model`, `verifier_model`, `commit_docs`, `phase_found`
|
|
|
35
35
|
Find incomplete plans by querying GitHub Issues (the source of truth for plans and completion status):
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
node ~/.claude/maxsim/bin/maxsim-tools.cjs github get-issue ${phase_issue_number} --comments
|
|
38
|
+
node ~/.claude/maxsim/bin/maxsim-tools.cjs github get-issue ${phase_issue_number} --include-comments
|
|
39
39
|
node ~/.claude/maxsim/bin/maxsim-tools.cjs github list-sub-issues ${phase_issue_number}
|
|
40
40
|
```
|
|
41
41
|
|
|
@@ -304,7 +304,7 @@ Do NOT write a UAT.md file to `.planning/phases/`.
|
|
|
304
304
|
3. Report to orchestrator: phase complete, issue closed
|
|
305
305
|
|
|
306
306
|
```bash
|
|
307
|
-
node ~/.claude/maxsim/bin/maxsim-tools.cjs github move-issue --
|
|
307
|
+
node ~/.claude/maxsim/bin/maxsim-tools.cjs github move-issue --issue-number N --status "Done"
|
|
308
308
|
node ~/.claude/maxsim/bin/maxsim-tools.cjs github close-issue N
|
|
309
309
|
```
|
|
310
310
|
|
|
@@ -319,7 +319,7 @@ node ~/.claude/maxsim/bin/maxsim-tools.cjs github close-issue N
|
|
|
319
319
|
4. Note which gaps need fixing before re-verification
|
|
320
320
|
|
|
321
321
|
```bash
|
|
322
|
-
node ~/.claude/maxsim/bin/maxsim-tools.cjs github move-issue --
|
|
322
|
+
node ~/.claude/maxsim/bin/maxsim-tools.cjs github move-issue --issue-number N --status "In Progress"
|
|
323
323
|
```
|
|
324
324
|
|
|
325
325
|
**If human_needed:**
|