singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

feat: add /gsd help command with categorized reference for all subcommands (#630)

Browse source 
Adds /gsd help (aliases: h, ?) that displays a grouped reference of
every available subcommand with usage, flags, and shortcuts.

Commands are organized by category: Workflow, Visibility, Course
Correction, Project Knowledge, Configuration, and Maintenance.

Also simplifies the "Unknown command" error to point users to /gsd help
instead of listing all commands inline.
This commit is contained in:
Juan Francisco Lebrero 2026-03-16 11:41:08 -03:00 • committed by GitHub
parent da1a77d723
commit 370897df81
1 changed files with 50 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

53
src/resources/extensions/gsd/commands.ts
View file

@ -66,10 +66,10 @@ function projectRoot(): string {
export function registerGSDCommand(pi: ExtensionAPI): void {
pi.registerCommand("gsd", {
description: "GSD — Get Shit Done: /gsd next|auto|stop|pause|status|visualize|queue|capture|triage|history|undo|skip|export|cleanup|prefs|config|hooks|doctor|migrate|remote|steer|knowledge",
description: "GSD — Get Shit Done: /gsd help|next|auto|stop|pause|status|visualize|queue|capture|triage|history|undo|skip|export|cleanup|prefs|config|hooks|doctor|migrate|remote|steer|knowledge",
getArgumentCompletions: (prefix: string) => {
const subcommands = [
"next", "auto", "stop", "pause", "status", "visualize", "queue", "discuss",
"help", "next", "auto", "stop", "pause", "status", "visualize", "queue", "discuss",
"capture", "triage",
"history", "undo", "skip", "export", "cleanup", "prefs",
"config", "hooks", "doctor", "migrate", "remote", "steer", "knowledge",
@ -161,6 +161,11 @@ export function registerGSDCommand(pi: ExtensionAPI): void {
async handler(args: string, ctx: ExtensionCommandContext) {
const trimmed = (typeof args === "string" ? args : "").trim();
if (trimmed === "help" || trimmed === "h" || trimmed === "?") {
showHelp(ctx);
return;
}
if (trimmed === "status") {
await handleStatus(ctx);
return;
@ -324,13 +329,55 @@ export function registerGSDCommand(pi: ExtensionAPI): void {
}
ctx.ui.notify(
`Unknown: /gsd ${trimmed}. Use /gsd next|auto|stop|pause|status|visualize|queue|capture|triage|discuss|history|undo|skip <unit>|export|cleanup|prefs|config|hooks|doctor|migrate|remote|steer <change>|knowledge <type> <entry>.`,
`Unknown: /gsd ${trimmed}. Run /gsd help for available commands.`,
"warning",
);
},
});
}
function showHelp(ctx: ExtensionCommandContext): void {
const lines = [
"GSD — Get Shit Done\n",
"WORKFLOW",
" /gsd Run next unit in step mode (same as /gsd next)",
" /gsd next Execute next task, then pause [--dry-run] [--verbose]",
" /gsd auto Run all queued units continuously [--verbose]",
" /gsd stop Stop auto-mode gracefully",
" /gsd pause Pause auto-mode (preserves state, /gsd auto to resume)",
" /gsd discuss Start guided milestone/slice discussion",
"",
"VISIBILITY",
" /gsd status Show progress dashboard (Ctrl+Alt+G)",
" /gsd visualize Interactive tree visualizer with 4-tab TUI",
" /gsd queue Show queued/dispatched units and execution order",
" /gsd history View execution history [--cost] [--phase] [--model] [N]",
"",
"COURSE CORRECTION",
" /gsd steer <desc> Apply user override to active work",
" /gsd capture <text> Quick-capture a thought to CAPTURES.md",
" /gsd triage Classify and route pending captures",
" /gsd skip <unit> Prevent a unit from auto-mode dispatch",
" /gsd undo Revert last completed unit [--force]",
"",
"PROJECT KNOWLEDGE",
" /gsd knowledge <type> <text> Add rule, pattern, or lesson to KNOWLEDGE.md",
"",
"CONFIGURATION",
" /gsd prefs Manage preferences [global|project|status|wizard|setup]",
" /gsd config Set API keys for external tools",
" /gsd hooks Show post-unit hook configuration",
"",
"MAINTENANCE",
" /gsd doctor Diagnose and repair .gsd/ state [audit|fix|heal] [scope]",
" /gsd export Export milestone/slice results [--json|--markdown]",
" /gsd cleanup Remove merged branches or snapshots [branches|snapshots]",
" /gsd migrate Upgrade .gsd/ structures to new format",
" /gsd remote Control remote auto-mode [slack|discord|status|disconnect]",
];
ctx.ui.notify(lines.join("\n"), "info");
}
async function handleStatus(ctx: ExtensionCommandContext): Promise<void> {
const basePath = projectRoot();
const state = await deriveState(basePath);