specli 0.0.32 → 0.0.33

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.33",
 	"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"
 	}
 }