@jals1212/pi-spaces-cli 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -6,6 +6,17 @@ commands and options and a patch version fixes.
 
 ## Unreleased
 
+## 0.2.0
+
+### Added
+
+- `pi-space --version` (or `-v`) prints the version.
+
+### Fixed
+
+- An unknown option such as `--bogus` in first place is reported as an unknown
+  option with the usage, exit code 2, instead of as an invalid space name.
+
 ## 0.1.0
 
 ### Added

package/README.md

@@ -18,6 +18,7 @@ Node 20 or later. The Pi extension `@jals1212/pi-spaces` must be installed in th
 | `pi-space <name> [pi args...]` | Starts Pi in that space (`base` for the home Pi starts with). |
 | `pi-space list` | Lists the spaces. A space named `list` can still be opened from the picker. |
 | `pi-space --help` | Shows the usage. |
+| `pi-space --version` | Prints the version. |
 
 ## Another program that runs Pi
 

package/dist/cli.js

@@ -1,29 +1,41 @@
 // The optional `pi-space` command: pick a space and start Pi in it.
 // It only passes `--space <name>`; the extension does the switch, so it never sets PI_CODING_AGENT_DIR.
 import { spawn as nodeSpawn } from "node:child_process";
+import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { createInterface } from "node:readline";
 import { BASE,           listSpaces, spacesDir, validateName } from "@jals1212/pi-spaces/spaces";
 
-export const USAGE = `Usage: pi-space [<name> [pi args...] | list | --help]
+export const USAGE = `Usage: pi-space [<name> [pi args...] | list | --help | --version]
   pi-space              pick a space and start Pi in it
   pi-space <name> ...   start Pi in a space ("base" for the home Pi starts with)
   pi-space list         list the spaces
+  pi-space --version    print the version
 PI_SPACES_COMMAND sets the program to run (default: pi), e.g. "my-launcher --".
 `;
 
+/** This package's version; package.json sits one folder above both src/ and dist/. */
+export const VERSION         = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+
                         
 	                  
+	                     
+	                                            
 	                  
 	                    
 	                   
 	                                                   
 
-/** `list` is the subcommand, so a space named "list" can only be opened from the picker. */
+/**
+ * `list` is the subcommand, so a space named "list" can only be opened from the picker.
+ * A space name never starts with "-", so any other option in first place is unknown, not a name.
+ */
 export function parseCli(args          )             {
 	const [first, ...rest] = args;
 	if (first === undefined) return { kind: "picker" };
 	if (first === "--help" || first === "-h") return { kind: "help" };
+	if (first === "--version" || first === "-v") return { kind: "version" };
+	if (first.startsWith("-")) return { kind: "unknown-option", option: first };
 	if (first === "list") return rest.length === 0 ? { kind: "list" } : { kind: "usage" };
 	return { kind: "launch", name: first, args: rest };
 }
@@ -81,6 +93,12 @@ export async function main(argv          , io       )                {
 		case "help":
 			io.stdout.write(USAGE);
 			return io.exit(0);
+		case "version":
+			io.stdout.write(`${VERSION}\n`);
+			return io.exit(0);
+		case "unknown-option":
+			io.stderr.write(`pi-space: Unknown option "${command.option}".\n${USAGE}`);
+			return io.exit(2);
 		case "usage":
 			io.stderr.write(USAGE);
 			return io.exit(2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jals1212/pi-spaces-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The pi-space command: pick a space and start Pi in it. Companion to the Pi extension @jals1212/pi-spaces.",
   "license": "MIT",
   "author": "jals1212",