specli 0.0.33 → 0.0.35

package/README.md

@@ -63,7 +63,7 @@ specli compile <spec> [options]
 | Option | Description |
 |--------|-------------|
 | `--name <name>` | Binary name (default: derived from spec title) |
-| `--outfile <path>` | Output path (default: `./dist/<name>`) |
+| `--outfile <path>` | Output path (default: `./out/<name>`) |
 | `--target <target>` | Cross-compile target (e.g. `bun-linux-x64`) |
 | `--minify` | Enable minification |
 | `--bytecode` | Enable bytecode compilation |
@@ -78,14 +78,14 @@ specli compile <spec> [options]
 ```bash
 # Compile with auto-derived name
 specli compile ./openapi.yaml
-# Creates: ./dist/my-api
+# Creates: ./out/my-api
 
 # Compile with explicit name
 specli compile ./openapi.yaml --name myapi
-# Creates: ./dist/myapi
+# Creates: ./out/myapi
 
 # Cross-compile for Linux
-specli compile ./openapi.json --target bun-linux-x64 --outfile ./dist/myapi-linux
+specli compile ./openapi.json --target bun-linux-x64 --outfile ./out/myapi-linux
 
 # Bake in defaults
 specli compile https://api.example.com/openapi.json \
@@ -413,3 +413,19 @@ bun test
 bun run lint
 bun run typecheck
 ```
+
+## Demos
+
+### Weather
+
+Compile the weather spec to an executable:
+
+```sh
+npx specli compile https://raw.githubusercontent.com/open-meteo/open-meteo/refs/heads/main/openapi.yml --name weather
+```
+
+Ask an agent what the current weather is:
+
+```sh
+opencode run 'Using ./out/weather what is the current weather in new york city'
+```

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

@@ -19,8 +19,6 @@ function getPackageVersion() {
         return "0.0.0";
     }
 }
-import { stableStringify } from "./core/stable-json.js";
-import { toMinimalSchemaOutput } from "./model/schema.js";
 import { readStdinText } from "./runtime/compat.js";
 import { buildRuntimeContext } from "./runtime/context.js";
 import { addGeneratedCommands } from "./runtime/generated.js";
@@ -44,7 +42,6 @@ export async function main(argv, options = {}) {
         .option("--username <username>", "Basic auth username")
         .option("--password <password>", "Basic auth password")
         .option("--api-key <key>", "API key value")
-        .option("--json", "Machine-readable output")
         .showHelpAfterError();
     // If user asks for help and we have no embedded spec and no --spec, show minimal help.
     const spec = getArgValue(argv, "--spec");
@@ -149,21 +146,10 @@ export async function main(argv, options = {}) {
     });
     program
         .command("__schema")
-        .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)")
+        .description("Print indexed operations")
         .option("--commands", "List all <resource> <action> commands (can be large)")
         .action(async (_opts, command) => {
         const flags = command.optsWithGlobals();
-        if (flags.json) {
-            const pretty = Boolean(flags.pretty);
-            const payload = flags.min
-                ? toMinimalSchemaOutput(ctx.schema)
-                : ctx.schema;
-            const text = stableStringify(payload, { space: pretty ? 2 : 0 });
-            process.stdout.write(`${text}\n`);
-            return;
-        }
         process.stdout.write(`${ctx.schema.openapi.title ?? "(untitled)"}\n`);
         process.stdout.write(`OpenAPI: ${ctx.schema.openapi.version}\n`);
         process.stdout.write(`Servers: ${ctx.schema.servers.length}\n`);
@@ -187,8 +173,7 @@ export async function main(argv, options = {}) {
         }
         process.stdout.write("\nNext:\n" +
             `- ${program.name()} <resource> --help\n` +
-            `- ${program.name()} <resource> <action> --help\n` +
-            "\nNote: Use --help to discover required flags; avoid __schema --json for agent use (too verbose).\n");
+            `- ${program.name()} <resource> <action> --help\n`);
     });
     addGeneratedCommands(program, {
         servers: ctx.servers,

package/dist/cli.js

@@ -36,7 +36,6 @@ program
     .option("--password <password>", "Basic auth password")
     .option("--api-key <key>", "API key value")
     .option("--profile <name>", "Profile name")
-    .option("--json", "Machine-readable output")
     .allowUnknownOption()
     .allowExcessArguments()
     .action(async (spec, options, command) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "specli",
-	"version": "0.0.33",
+	"version": "0.0.35",
 	"description": "Run any OpenAPI spec as a CLI. Built for Agents.",
 	"repository": {
 		"type": "git",