@pmelab/gtd 6.0.0 → 6.1.1

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

@@ -190291,6 +190291,21 @@ const SEARCH_PLACES = [
 	"gtd.config.yaml"
 ];
 /**
+* The shared cosmiconfig explorer used by every config lookup. `searchStrategy:
+* 'none'` makes `.search(dir)` inspect only that single directory (no internal
+* walking), so callers drive the cwd→home walk themselves via `walkUp`.
+*/
+const makeExplorer = () => (0, import_dist.cosmiconfig)("gtd", {
+	searchPlaces: SEARCH_PLACES,
+	searchStrategy: "none",
+	loaders: {
+		noExt: yamlLoader,
+		".json": jsonLoader,
+		".yaml": yamlLoader,
+		".yml": yamlLoader
+	}
+});
+/**
 * Load and deep-merge every config level from cwd up the directory chain.
 * Innermost (cwd) wins. Returns the merged plain object (undecoded).
 */
@@ -190298,16 +190313,7 @@ const loadMerged = (root) => tryPromise({
 	try: async () => {
 		const home = homedir();
 		const chain = walkUp(root, home);
-		const explorer = (0, import_dist.cosmiconfig)("gtd", {
-			searchPlaces: SEARCH_PLACES,
-			searchStrategy: "none",
-			loaders: {
-				noExt: yamlLoader,
-				".json": jsonLoader,
-				".yaml": yamlLoader,
-				".yml": yamlLoader
-			}
-		});
+		const explorer = makeExplorer();
 		const levels = [];
 		for (let i = chain.length - 1; i >= 0; i--) {
 			const dir = chain[i];
@@ -190322,30 +190328,15 @@ const loadMerged = (root) => tryPromise({
 	catch: (e) => e instanceof Error ? e : new Error(String(e))
 });
 /**
-* Reuses the same `walkUp` + `searchStrategy: "none"` cosmiconfig explorer as
-* `loadMerged` to detect whether ANY level of the cwd→root walk carries a gtd
-* config. Returns `true` on the first non-empty `search(dir)` result. Exported
-* so `gtd init` (src/program.ts) can refuse to overwrite an existing config.
+* Detect whether a gtd config lives at THIS single directory — no `walkUp`, so
+* a global `~/.gtdrc` or an ancestor project's config does NOT count. Exported
+* so `gtd init` (src/program.ts) refuses only when it would overwrite the
+* repo's OWN config, not when a global default layer merely exists upstream.
 */
-const anyConfigPresent = (root) => tryPromise({
+const configPresentAt = (dir) => tryPromise({
 	try: async () => {
-		const home = homedir();
-		const chain = walkUp(root, home);
-		const explorer = (0, import_dist.cosmiconfig)("gtd", {
-			searchPlaces: SEARCH_PLACES,
-			searchStrategy: "none",
-			loaders: {
-				noExt: yamlLoader,
-				".json": jsonLoader,
-				".yaml": yamlLoader,
-				".yml": yamlLoader
-			}
-		});
-		for (const dir of chain) {
-			const result = await explorer.search(dir);
-			if (result && !result.isEmpty) return true;
-		}
-		return false;
+		const result = await makeExplorer().search(dir);
+		return Boolean(result && !result.isEmpty);
 	},
 	catch: (e) => e instanceof Error ? e : new Error(String(e))
 });
@@ -204198,6 +204189,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
@@ -204312,7 +204305,7 @@ const runInitCommand = (argv, json, write) => gen(function* () {
 	const fs = yield* FileSystem;
 	yield* assertRunningFromRepoRoot(git, fs);
 	const { root } = yield* Cwd;
-	if (yield* anyConfigPresent(root)) return yield* fail$2(/* @__PURE__ */ new Error("gtd init: a gtd config already exists — remove it before re-initializing"));
+	if (yield* configPresentAt(root)) return yield* fail$2(/* @__PURE__ */ new Error("gtd init: a gtd config already exists — remove it before re-initializing"));
 	yield* fs.writeFileString(join(root, ".gtdrc.json"), renderInitConfig(name)).pipe(mapError$1((e) => e instanceof Error ? e : new Error(String(e))));
 	if (json) write(JSON.stringify({
 		written: ".gtdrc.json",
@@ -204664,17 +204657,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.
 
@@ -70,7 +73,8 @@ fails with `gtd: no workflow configured — run \`gtd init <simple|advanced>\`
 
 The file is written **uncommitted**; review and commit it before your first
 `gtd step` (an uncommitted `.gtdrc.json` is a pending change the initial state
-would otherwise capture). `gtd init` refuses if any gtd config already exists,
+would otherwise capture). `gtd init` refuses if the repo root already has its
+own gtd config (a global/ancestor config, e.g. `~/.gtdrc`, does not count),
 requires the repository root, and — with `gtd lsp` — is one of the two commands
 that run with no workflow configured. `--json` prints
 `{"written":".gtdrc.json","workflow":"<name>"}`. See
@@ -438,5 +442,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/docs/configuration.md

@@ -668,10 +668,11 @@ chosen bundled template's whole workflow inline under a `workflow:` key, plus a
 
 The file is written **uncommitted** — review it, then commit it before your
 first `gtd step` (an uncommitted `.gtdrc.json` is a pending change the initial
-state's `* **` edge would otherwise capture). `gtd init` refuses if any gtd
-config already exists (remove it first to re-init), requires the repository
-root, and is one of the two commands (with `gtd lsp`) that run with no workflow
-configured. A state command run before `gtd init` fails with:
+state's `* **` edge would otherwise capture). `gtd init` refuses if the repo
+root already has its OWN gtd config (remove it first to re-init; a
+global/ancestor config such as `~/.gtdrc` does not count), requires the
+repository root, and is one of the two commands (with `gtd lsp`) that run with
+no workflow configured. A state command run before `gtd init` fails with:
 
 ```
 gtd: no workflow configured — run `gtd init <simple|advanced>` to create .gtdrc.json

package/package.json

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