48824f258c
The gsd_run resolver preamble now probes
<repo-root>/.claude/get-shit-done/bin/${_GSD_SHIM_NAME} as the second
check — immediately after the existing get-shit-done/bin/ check and
before command -v / $HOME/.claude fallbacks. This covers the install
layout produced by npx @opengsd/get-shit-done-redux@latest --claude --local.
A _GSD_RUNTIME_ROOT variable is introduced to bind the repo-root
expression once and reuse it for both checks without repeating the
git rev-parse subshell.
76 workflow files regenerated via node scripts/sync-runtime-launcher.cjs.
All parity, size-budget, and new regression tests pass.
Co-authored-by: CI Rebase Check <ci@gsd-redux>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
156 lines
4.6 KiB
Markdown
156 lines
4.6 KiB
Markdown
<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 || true
|
|
```
|
|
|
|
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 || true
|
|
```
|
|
|
|
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.
|
|
|
|
|
|
**Text mode (`workflow.text_mode: true` in config or `--text` flag):** Set `TEXT_MODE=true` if `--text` is present in `$ARGUMENTS` OR `text_mode` from init JSON is `true`. When TEXT_MODE is active, replace every `AskUserQuestion` call with a plain-text numbered list and ask the user to type their choice number. This is required for non-Claude runtimes (OpenAI Codex, Gemini CLI, etc.) where `AskUserQuestion` is not available.
|
|
AskUserQuestion: "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
|
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/get-shit-done/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/get-shit-done/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/get-shit-done-redux@latest --claude --local" >&2; exit 1; fi
|
|
gsd_run query 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>
|