@starfetch-js/cli 0.1.1 → 0.2.1

package/README.md

@@ -1,24 +1,51 @@
 # @starfetch-js/cli
 
-Command-line interface for Starfetch TAP/ADQL workflows.
+Query Gaia, SIMBAD, VizieR, the NASA Exoplanet Archive, IRSA, and other public
+astronomy TAP services from the command line. Starfetch keeps ADQL visible so
+an agent result, script, or investigation can be reproduced exactly.
+
+Requires Node.js 22 or newer.
 
 ```sh
 npm install -g @starfetch-js/cli
+starfetch tap tables --service gaia
 ```
 
-Run once without a global install:
+Run once without installing globally:
 
 ```sh
 npx -y @starfetch-js/cli tap tables --service gaia
 ```
 
+## Metadata first, then a bounded query
+
+Inspect the live schema before writing service-specific ADQL:
+
 ```sh
+starfetch tap availability --service gaia
 starfetch tap tables --service gaia
+starfetch tap columns --service gaia --table gaiadr3.gaia_source
+```
+
+Then run a reproducible query. `TOP` bounds the ADQL result and `--maxrec`
+bounds the TAP request:
+
+```sh
 starfetch tap query \
   --service gaia \
   --query "SELECT TOP 5 source_id, ra, dec FROM gaiadr3.gaia_source" \
+  --maxrec 5 \
   --format json
 ```
 
-The CLI exposes TAP metadata, registry search, sync queries, explicit async
-jobs, and `starfetch skill` commands for installing the packaged agent skill.
+```json
+[{ "source_id": "…", "ra": 56.64828, "dec": 24.38537 }]
+```
+
+The CLI also supports VO registry discovery, explicit TAP/UWS async jobs,
+CSV/TSV/VOTable output, and `starfetch skill` commands. It is intended for
+public TAP services, not authenticated/private archives, image processing, or
+authoritative astrophysical interpretation.
+
+For the complete Gaia proper-motion workflow and TypeScript API, see the
+[repository README](https://github.com/starfetch-js/starfetch#readme).

package/dist/index.js

@@ -3218,7 +3218,7 @@ var TapUploadError = class extends StarfetchError {
 		this.name = "TapUploadError";
 	}
 };
-/** TAP service requires authentication that Starfetch v1 does not support. */
+/** TAP service requires authentication that Starfetch does not support. */
 var TapAuthUnsupportedError = class extends StarfetchError {
 	constructor(message) {
 		super(message);
@@ -6874,7 +6874,7 @@ async function readTapCapabilitiesIfAvailable(target, options) {
 	return capabilities;
 }
 function assertCapabilitiesAllowAnonymousTap(capabilities) {
-	if (capabilities.auth === "unsupported-auth") throw new TapAuthUnsupportedError("This TAP query interface requires authentication, but Starfetch v1 only supports anonymous TAP requests.");
+	if (capabilities.auth === "unsupported-auth") throw new TapAuthUnsupportedError("This TAP query interface requires authentication, but Starfetch only supports anonymous TAP requests.");
 }
 async function readParsedTapTables(target, options) {
 	return parseTapTables(await readTapMetadataXml(target, "tables", options));

package/package.json

@@ -1,15 +1,22 @@
 {
   "name": "@starfetch-js/cli",
-  "version": "0.1.1",
-  "description": "Command-line interface for Starfetch.",
+  "version": "0.2.1",
+  "description": "CLI for querying Gaia, SIMBAD, VizieR, and other public astronomy TAP services with reproducible ADQL.",
   "type": "module",
   "license": "MIT",
   "keywords": [
     "astronomy",
+    "gaia",
+    "simbad",
+    "vizier",
+    "exoplanets",
+    "nasa-exoplanet-archive",
+    "irsa",
+    "star-catalog",
+    "virtual-observatory",
     "tap",
     "adql",
-    "cli",
-    "virtual-observatory"
+    "cli"
   ],
   "homepage": "https://github.com/starfetch-js/starfetch#readme",
   "bugs": {
@@ -42,8 +49,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@starfetch-js/core": "0.1.1",
-    "@starfetch-js/skill": "0.1.1",
+    "@starfetch-js/core": "0.2.1",
+    "@starfetch-js/skill": "0.2.1",
     "commander": "15.0.0"
   },
   "devDependencies": {
@@ -54,5 +61,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "gitHead": "5edb8bd748ade8549c9336576ca2da3ce60654dc"
 }