54e6da3126
* fix(#2767): pass paths via --files to gsd-sdk query commit + lint guard Workflows, agents, commands, and references passed file paths positionally to `gsd-sdk query commit`, which silently appended them to the commit subject and triggered the `.planning/` wholesale-stage fallback in sdk/src/query/commit.ts:136. Regression of #733/#798. Inserted `--files` before the path list at every site (81 invocations across 50 files). Added tests/bug-2767-gsd-sdk-commit-files-flag.test.cjs as a permanent lint that scans every shipped .md file and asserts each `gsd-sdk query commit[-to-subrepo]` invocation either uses `--files` or carries no path arguments. Closes #2767 * test(#2767): replace source-grep with behavioral SDK test The original test walked every shipped .md file and regex-tokenized `gsd-sdk query commit` invocations to assert `--files` was present. CONTRIBUTING.md prohibits this source-grep pattern. Rewrite as behavioral SDK tests against `sdk/dist/cli.js` over a real tmp git project (createTempGitProject helper). Cover both the well-formed (`--files <paths>`) form — clean subject, exactly-staged files, .planning/ left untouched — and the buggy positional form, asserting the documented misbehavior (paths leak into subject + the `.planning/` wholesale-stage fallback at commit.ts:136). Also asserts `commit-to-subrepo` rejects when `--files` is omitted (commit.ts:258). The doc-lint is retained as a supplementary defense-in-depth guard since agent-prompt markdown invocations cannot be exercised end-to-end — but it is no longer the primary contract. * docs(#2767): correct contradictory --files guidance in zh-CN/en docs + fix test docstring
3.7 KiB
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.
<required_reading>
.planning/MILESTONES.md.planning/milestones/directory listing.planning/phases/directory listing
</required_reading>
Read .planning/MILESTONES.md to identify completed milestones and their versions.
cat .planning/MILESTONES.md
Extract each milestone version (e.g., v1.0, v1.1, v2.0).
Check which milestone archive dirs already exist:
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.
For each completed milestone without a -phases archive, read the archived ROADMAP snapshot to determine which phases belong to it:
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/:
ls -d .planning/phases/*/ 2>/dev/null || true
Match phase directories to milestone membership. Only include directories that still exist in .planning/phases/.
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.
For each milestone, move phase directories:
mkdir -p .planning/milestones/v{X.Y}-phases
For each phase directory belonging to this milestone:
mv .planning/phases/{dir} .planning/milestones/v{X.Y}-phases/
Repeat for all milestones in the cleanup set.
Commit the changes:
gsd-sdk query commit "chore: archive phase directories from completed milestones" --files .planning/milestones/ .planning/phases/
Archived:
{For each milestone}
- v{X.Y}: {N} phase directories → .planning/milestones/v{X.Y}-phases/
.planning/phases/ cleaned up.
<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>