@pmelab/gtd 6.0.0 → 6.1.0

package/README.md

@@ -76,6 +76,10 @@ Four commands drive it:
   `<commitish>..HEAD` (e.g. a colleague's PR branch), reusing the workflow's
   existing review/feedback machinery over that diff.
 
+`gtd version` (or `gtd --version`/`-v`) prints the installed version and exits;
+`gtd help` (or `gtd --help`/`-h`) prints the command list. Both short-circuit
+before any repo work, so they run anywhere.
+
 The loop is one beat, repeated: run `gtd next --json` and dispatch on `kind` —
 `"message"` means it's a human's move (stop and hand off); `"script"` means the
 driver runs `content` itself, then steps its actor; `"prompt"` means feed

package/dist/gtd.bundle.mjs

@@ -204198,6 +204198,8 @@ Commands:
   mermaid          Print the active workflow's shape as Mermaid
                    stateDiagram-v2 source (no mutation)
   lsp              Start the LSP server for .gtd/ steering files (stdio)
+  version          Print version and exit
+  help             Print this help and exit
 
 Options:
   --json           Output structured JSON instead of plain text
@@ -204664,17 +204666,19 @@ const KNOWN_SUBCOMMANDS = [
 	"mermaid"
 ];
 /**
-* `--version`/`-v` or `--help`/`-h`: short-circuits before any git or state
-* work, so it works outside a repo too. Exported so main.ts can run the same
-* check synchronously BEFORE the Effect runtime builds any layer — layer
-* construction must never observe a version/help invocation.
+* `--version`/`-v`/`version` or `--help`/`-h`/`help`: short-circuits before any
+* git or state work, so it works outside a repo too. The bare `version`/`help`
+* subcommands are equivalent to their flag forms. Exported so main.ts can run
+* the same check synchronously BEFORE the Effect runtime builds any layer —
+* layer construction must never observe a version/help invocation.
 */
 const runVersionOrHelp = (argv, write) => {
-	if (argv.includes("--version") || argv.includes("-v")) {
+	const positional = argv.slice(2).find((a) => !a.startsWith("--"));
+	if (argv.includes("--version") || argv.includes("-v") || positional === "version") {
 		write(GTD_VERSION + "\n");
 		return true;
 	}
-	if (argv.includes("--help") || argv.includes("-h")) {
+	if (argv.includes("--help") || argv.includes("-h") || positional === "help") {
 		write(HELP_TEXT);
 		return true;
 	}

package/docs/cli.md

@@ -29,6 +29,8 @@ Commands:
   mermaid          Print the active workflow's shape as Mermaid
                    stateDiagram-v2 source (no mutation)
   lsp              Start the LSP server for .gtd/ steering files (stdio)
+  version          Print version and exit
+  help             Print this help and exit
 
 Options:
   --json           Output structured JSON instead of plain text
@@ -38,11 +40,12 @@ Options:
   --help, -h       Print this help and exit
 ```
 
-`--version` (`-v`) and `--help` (`-h`) short-circuit before any git or
-repository-state work — they run outside a repo and in any repo state. Bare
-`gtd` (no subcommand) is a usage error: it prints the help text and exits 1
-without touching the repository. Every other command must be run from the
-**repository root** — gtd derives the workflow, pending changes, and process
+`--version` (`-v`) / `gtd version` and `--help` (`-h`) / `gtd help`
+short-circuit before any git or repository-state work — they run outside a repo
+and in any repo state (the bare subcommands are exact equivalents of their flag
+forms). Bare `gtd` (no subcommand) is a usage error: it prints the help text and
+exits 1 without touching the repository. Every other command must be run from
+the **repository root** — gtd derives the workflow, pending changes, and process
 history relative to cwd, so it refuses with a clear error if invoked from a
 subdirectory.
 
@@ -438,5 +441,6 @@ the plain-text one.
 - **Repository root invocation.** Every state subcommand (`step`/`review`/
   `next`/`status`/`mermaid`) must run from the git repository root — the
   workflow, pending changes, and process history are resolved against the
-  process cwd. `--help`/`--version`, `format`, and `lsp` skip this guard
-  entirely (and any git/`.gtdrc` dependency along with it).
+  process cwd. `--help`/`--version` (and the `help`/`version` subcommands),
+  `format`, and `lsp` skip this guard entirely (and any git/`.gtdrc` dependency
+  along with it).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmelab/gtd",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "private": false,
   "description": "Git-aware CLI that emits the next prompt for an autonomous coding agent based on the current repository state",
   "bin": {