specli 0.0.32 → 0.0.34

package/bin/cli.sh

@@ -22,15 +22,29 @@ for arg in "$@"; do
 	fi
 done
 
-# 1. Prefer Bun if installed
-if command -v bun >/dev/null 2>&1; then
+# Check if Bun version is >= 1.3
+bun_version_ok() {
+	version=$(bun --version 2>/dev/null) || return 1
+	major=$(printf '%s' "$version" | cut -d. -f1)
+	minor=$(printf '%s' "$version" | cut -d. -f2)
+	[ "$major" -gt 1 ] || { [ "$major" -eq 1 ] && [ "$minor" -ge 3 ]; }
+}
+
+# 1. Prefer Bun if installed and version >= 1.3
+if command -v bun >/dev/null 2>&1 && bun_version_ok; then
 	exec bun "$CLI_JS" "$@"
 fi
 
-# 2. Bun is required for compile
+# 2. Bun >= 1.3 is required for compile
 if [ "$is_compile" -eq 1 ]; then
-	printf '%s\n' "Error: The 'compile' command requires Bun." "Install Bun: https://bun.sh" >&2
-	exit 1
+	if ! command -v bun >/dev/null 2>&1; then
+		printf '%s\n' "Error: The 'compile' command requires Bun >= 1.3." "Install Bun: https://bun.sh" >&2
+		exit 1
+	fi
+	if ! bun_version_ok; then
+		printf '%s\n' "Error: The 'compile' command requires Bun >= 1.3 (found $(bun --version))." "Update Bun: https://bun.sh" >&2
+		exit 1
+	fi
 fi
 
 # 3. Fallback to Node.js

package/dist/cli/main.js

@@ -152,6 +152,7 @@ export async function main(argv, options = {}) {
         .description("Print indexed operations (machine-readable when --json)")
         .option("--pretty", "Pretty-print JSON when used with --json")
         .option("--min", "Minimal JSON output (commands + metadata only)")
+        .option("--commands", "List all <resource> <action> commands (can be large)")
         .action(async (_opts, command) => {
         const flags = command.optsWithGlobals();
         if (flags.json) {
@@ -165,11 +166,17 @@ export async function main(argv, options = {}) {
         }
         process.stdout.write(`${ctx.schema.openapi.title ?? "(untitled)"}\n`);
         process.stdout.write(`OpenAPI: ${ctx.schema.openapi.version}\n`);
-        process.stdout.write(`Spec: ${ctx.schema.spec.id} (${ctx.schema.spec.source})\n`);
-        process.stdout.write(`Fingerprint: ${ctx.schema.spec.fingerprint}\n`);
         process.stdout.write(`Servers: ${ctx.schema.servers.length}\n`);
         process.stdout.write(`Auth Schemes: ${ctx.schema.authSchemes.length}\n`);
-        if (ctx.schema.planned?.length) {
+        process.stdout.write(`Spec: ${ctx.schema.spec.id} (${ctx.schema.spec.source})\n`);
+        // Token-efficient default output: list resources (top-level commands)
+        // and push the user/agent toward --help for details.
+        process.stdout.write(`\nResources: ${ctx.commands.resources.length}\n\n`);
+        const resources = [...ctx.commands.resources].sort((a, b) => a.resource.localeCompare(b.resource));
+        for (const r of resources) {
+            process.stdout.write(`- ${r.resource} (${r.actions.length} actions)\n`);
+        }
+        if (flags.commands && ctx.schema.planned?.length) {
             process.stdout.write(`\nCommands: ${ctx.schema.planned.length}\n\n`);
             for (const op of ctx.schema.planned) {
                 const args = op.pathArgs.length
@@ -178,10 +185,10 @@ export async function main(argv, options = {}) {
                 process.stdout.write(`- ${program.name()} ${op.resource} ${op.action}${args}\n`);
             }
         }
-        process.stdout.write("\nTip: explore required flags with --help at each level:\n" +
-            `- ${program.name()} --help\n` +
+        process.stdout.write("\nNext:\n" +
             `- ${program.name()} <resource> --help\n` +
-            `- ${program.name()} <resource> <action> --help\n`);
+            `- ${program.name()} <resource> <action> --help\n` +
+            "\nNote: Use --help to discover required flags; avoid __schema --json for agent use (too verbose).\n");
     });
     addGeneratedCommands(program, {
         servers: ctx.servers,
@@ -256,9 +263,10 @@ export async function main(argv, options = {}) {
             }
             lines.push("");
             lines.push("Agent workflow:");
-            lines.push(`  1) ${name} __schema --json --min`);
+            lines.push(`  1) ${name} __schema`);
             lines.push(`  2) ${name} <resource> --help`);
             lines.push(`  3) ${name} <resource> <action> --help`);
+            lines.push(`  4) ${name} <resource> <action> --curl`);
             lines.push("");
             return lines.join("\n");
         },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "specli",
-	"version": "0.0.32",
+	"version": "0.0.34",
 	"description": "Run any OpenAPI spec as a CLI. Built for Agents.",
 	"repository": {
 		"type": "git",
@@ -31,7 +31,7 @@
 	],
 	"scripts": {
 		"build": "tsc",
-		"prepublishOnly": "tsc",
+		"prepublishOnly": "rm -rf dist && tsc",
 		"lint": "biome ci",
 		"lint:check": "biome check --write --unsafe",
 		"lint:format": "biome format --write",
@@ -54,7 +54,7 @@
 		"@tsconfig/node22": "^22.0.5",
 		"@types/bun": "^1.3.6",
 		"@types/node": "^22.19.7",
-		"@typescript/native-preview": "^7.0.0-dev.20260122.3",
+		"@typescript/native-preview": "^7.0.0-dev.20260122.4",
 		"typescript": "^5.9.3"
 	}
 }