gsd-opencode 1.10.2 → 1.20.0

package/{commands/gsd → get-shit-done/workflows}/check-todos.md

@@ -1,35 +1,23 @@
----
-name: gsd-check-todos
-description: List pending todos and select one to work on
-argument-hint: [area filter]
-tools:
-  - read
-  - write
-  - bash
-  - glob
-  - question
----
-
-<objective>
+<purpose>
 List all pending todos, allow selection, load full context for the selected todo, and route to appropriate action.
+</purpose>
 
-Enables reviewing captured ideas and deciding what to work on next.
-</objective>
-
-<context>
-@.planning/STATE.md
-@.planning/ROADMAP.md
-</context>
+<required_reading>
+read all files referenced by the invoking prompt's execution_context before starting.
+</required_reading>
 
 <process>
 
-<step name="check_exist">
+<step name="init_context">
+Load todo context:
+
 ```bash
-TODO_COUNT=$(ls .planning/todos/pending/*.md 2>/dev/null | wc -l | tr -d ' ')
-echo "Pending todos: $TODO_COUNT"
+INIT=$(node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs init todos)
 ```
 
-If count is 0:
+Extract from init JSON: `todo_count`, `todos`, `pending_dir`.
+
+If `todo_count` is 0:
 ```
 No pending todos.
 
@@ -53,16 +41,9 @@ Check for area filter in arguments:
 </step>
 
 <step name="list_todos">
-```bash
-for file in .planning/todos/pending/*.md; do
-  created=$(grep "^created:" "$file" | cut -d' ' -f2)
-  title=$(grep "^title:" "$file" | cut -d':' -f2- | xargs)
-  area=$(grep "^area:" "$file" | cut -d' ' -f2)
-  echo "$created|$title|$area|$file"
-done | sort
-```
+Use the `todos` array from init context (already filtered by area if specified).
 
-Apply area filter if specified. Display as numbered list:
+Parse and display as numbered list:
 
 ```
 Pending Todos:
@@ -78,7 +59,7 @@ Reply with a number to view details, or:
 - `q` to exit
 ```
 
-Format age as relative time.
+Format age as relative time from created timestamp.
 </step>
 
 <step name="handle_selection">
@@ -109,11 +90,9 @@ If `files` field has entries, read and briefly summarize each.
 </step>
 
 <step name="check_roadmap">
-```bash
-ls .planning/ROADMAP.md 2>/dev/null && echo "Roadmap exists"
-```
+Check for roadmap (can use init progress or directly check file existence):
 
-If roadmap exists:
+If `.planning/ROADMAP.md` exists:
 1. Check if todo's area matches an upcoming phase
 2. Check if todo's files overlap with a phase's scope
 3. Note any match for action options
@@ -167,55 +146,24 @@ Return to list_todos step.
 <step name="update_state">
 After any action that changes todo count:
 
-```bash
-ls .planning/todos/pending/*.md 2>/dev/null | wc -l
-```
-
-Update STATE.md "### Pending Todos" section if exists.
+Re-run `init todos` to get updated count, then update STATE.md "### Pending Todos" section if exists.
 </step>
 
 <step name="git_commit">
 If todo was moved to done/, commit the change:
 
-**Check planning config:**
-
 ```bash
-COMMIT_PLANNING_DOCS=$(cat .planning/config.json 2>/dev/null | grep -o '"commit_docs"[[:space:]]*:[[:space:]]*[^,}]*' | grep -o 'true\|false' || echo "true")
-git check-ignore -q .planning 2>/dev/null && COMMIT_PLANNING_DOCS=false
-```
-
-**If `COMMIT_PLANNING_DOCS=false`:** Skip git operations, log "Todo moved (not committed - commit_docs: false)"
-
-**If `COMMIT_PLANNING_DOCS=true` (default):**
-
-```bash
-git add .planning/todos/done/[filename]
 git rm --cached .planning/todos/pending/[filename] 2>/dev/null || true
-[ -f .planning/STATE.md ] && git add .planning/STATE.md
-git commit -m "$(cat <<'EOF'
-docs: start work on todo - [title]
-
-Moved to done/, beginning implementation.
-EOF
-)"
+node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs commit "docs: start work on todo - [title]" --files .planning/todos/done/[filename] .planning/STATE.md
 ```
 
+Tool respects `commit_docs` config and gitignore automatically.
+
 Confirm: "Committed: docs: start work on todo - [title]"
 </step>
 
 </process>
 
-<output>
-- Moved todo to `.planning/todos/done/` (if "Work on it now")
-- Updated `.planning/STATE.md` (if todo count changed)
-</output>
-
-<anti_patterns>
-- Don't delete todos — move to done/ when work begins
-- Don't start work without moving to done/ first
-- Don't create plans from this command — route to /gsd-plan-phase or /gsd-add-phase
-</anti_patterns>
-
 <success_criteria>
 - [ ] All pending todos listed with title, area, age
 - [ ] Area filter applied if specified

package/get-shit-done/workflows/cleanup.md

@@ -0,0 +1,152 @@
+<purpose>
+
+Archive accumulated phase directories from completed milestones into `.planning/milestones/v{X.Y}-phases/`. Identifies which phases belong to each completed milestone, shows a dry-run summary, and moves directories on confirmation.
+
+</purpose>
+
+<required_reading>
+
+1. `.planning/MILESTONES.md`
+2. `.planning/milestones/` directory listing
+3. `.planning/phases/` directory listing
+
+</required_reading>
+
+<process>
+
+<step name="identify_completed_milestones">
+
+read `.planning/MILESTONES.md` to identify completed milestones and their versions.
+
+```bash
+cat .planning/MILESTONES.md
+```
+
+Extract each milestone version (e.g., v1.0, v1.1, v2.0).
+
+Check which milestone archive dirs already exist:
+
+```bash
+ls -d .planning/milestones/v*-phases 2>/dev/null
+```
+
+Filter to milestones that do NOT already have a `-phases` archive directory.
+
+If all milestones already have phase archives:
+
+```
+All completed milestones already have phase directories archived. Nothing to clean up.
+```
+
+Stop here.
+
+</step>
+
+<step name="determine_phase_membership">
+
+For each completed milestone without a `-phases` archive, read the archived ROADMAP snapshot to determine which phases belong to it:
+
+```bash
+cat .planning/milestones/v{X.Y}-ROADMAP.md
+```
+
+Extract phase numbers and names from the archived roadmap (e.g., Phase 1: Foundation, Phase 2: Auth).
+
+Check which of those phase directories still exist in `.planning/phases/`:
+
+```bash
+ls -d .planning/phases/*/ 2>/dev/null
+```
+
+Match phase directories to milestone membership. Only include directories that still exist in `.planning/phases/`.
+
+</step>
+
+<step name="show_dry_run">
+
+Present a dry-run summary for each milestone:
+
+```
+## Cleanup Summary
+
+### v{X.Y} — {Milestone Name}
+These phase directories will be archived:
+- 01-foundation/
+- 02-auth/
+- 03-core-features/
+
+Destination: .planning/milestones/v{X.Y}-phases/
+
+### v{X.Z} — {Milestone Name}
+These phase directories will be archived:
+- 04-security/
+- 05-hardening/
+
+Destination: .planning/milestones/v{X.Z}-phases/
+```
+
+If no phase directories remain to archive (all already moved or deleted):
+
+```
+No phase directories found to archive. Phases may have been removed or archived previously.
+```
+
+Stop here.
+
+question: "Proceed with archiving?" with options: "Yes — archive listed phases" | "Cancel"
+
+If "Cancel": Stop.
+
+</step>
+
+<step name="archive_phases">
+
+For each milestone, move phase directories:
+
+```bash
+mkdir -p .planning/milestones/v{X.Y}-phases
+```
+
+For each phase directory belonging to this milestone:
+
+```bash
+mv .planning/phases/{dir} .planning/milestones/v{X.Y}-phases/
+```
+
+Repeat for all milestones in the cleanup set.
+
+</step>
+
+<step name="commit">
+
+Commit the changes:
+
+```bash
+node ~/.config/opencode/get-shit-done/bin/gsd-tools.cjs commit "chore: archive phase directories from completed milestones" --files .planning/milestones/ .planning/phases/
+```
+
+</step>
+
+<step name="report">
+
+```
+Archived:
+{For each milestone}
+- v{X.Y}: {N} phase directories → .planning/milestones/v{X.Y}-phases/
+
+.planning/phases/ cleaned up.
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+
+- [ ] All completed milestones without existing phase archives identified
+- [ ] Phase membership determined from archived ROADMAP snapshots
+- [ ] Dry-run summary shown and user confirmed
+- [ ] Phase directories moved to `.planning/milestones/v{X.Y}-phases/`
+- [ ] Changes committed
+
+</success_criteria>