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.
Files changed (31) hide show
  1. package/dist/assets/CHANGELOG.md +17 -0
  2. package/dist/assets/hooks/maxsim-check-update.cjs +2 -1
  3. package/dist/assets/hooks/maxsim-check-update.cjs.map +1 -1
  4. package/dist/assets/hooks/maxsim-notification-sound.cjs +3 -2
  5. package/dist/assets/hooks/maxsim-notification-sound.cjs.map +1 -1
  6. package/dist/assets/hooks/maxsim-statusline.cjs +6 -4
  7. package/dist/assets/hooks/maxsim-statusline.cjs.map +1 -1
  8. package/dist/assets/hooks/maxsim-stop-sound.cjs +3 -2
  9. package/dist/assets/hooks/maxsim-stop-sound.cjs.map +1 -1
  10. package/dist/assets/hooks/maxsim-sync-reminder.cjs.map +1 -1
  11. package/dist/assets/templates/commands/maxsim/quick.md +3 -5
  12. package/dist/assets/templates/references/thinking-partner.md +0 -2
  13. package/dist/assets/templates/skills/github-artifact-protocol/SKILL.md +0 -1
  14. package/dist/assets/templates/skills/github-tools-guide/SKILL.md +2 -9
  15. package/dist/assets/templates/templates/state.md +0 -10
  16. package/dist/assets/templates/workflows/execute.md +3 -3
  17. package/dist/assets/templates/workflows/go.md +1 -1
  18. package/dist/assets/templates/workflows/help.md +1 -2
  19. package/dist/assets/templates/workflows/new-milestone.md +1 -1
  20. package/dist/assets/templates/workflows/plan-create.md +1 -1
  21. package/dist/assets/templates/workflows/plan-discuss.md +1 -1
  22. package/dist/assets/templates/workflows/plan.md +4 -4
  23. package/dist/assets/templates/workflows/progress.md +0 -5
  24. package/dist/assets/templates/workflows/quick.md +1 -151
  25. package/dist/assets/templates/workflows/sdd.md +1 -1
  26. package/dist/assets/templates/workflows/verify-phase.md +2 -2
  27. package/dist/cli.cjs +8417 -8695
  28. package/dist/cli.cjs.map +1 -1
  29. package/dist/install.cjs +2 -1
  30. package/dist/install.cjs.map +1 -1
  31. 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). Also supports "save for later" todo capture via GitHub Issues.
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 --project-number P --item-id ID --status "Done"
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 --project-number P --item-id ID --status "In Progress"
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:**