@glubean/cli 0.1.2

package/templates/demo.test.ts.tpl

@@ -0,0 +1,226 @@
+/**
+ * Demo API tests — showcases Glubean SDK features against DummyJSON.
+ *
+ * This file is designed to produce rich, visually impressive results:
+ * - Multiple test types (simple + multi-step builder)
+ * - Auto-traced HTTP calls via ctx.http (method, URL, status, duration)
+ * - Fluent assertions, structured logs
+ * - Auth flows, data integrity checks, pagination
+ *
+ * Run: glubean run demo.test.ts --result-json
+ */
+import { test } from "@glubean/sdk";
+
+// ---------------------------------------------------------------------------
+// 1. Simple test — List products
+// ---------------------------------------------------------------------------
+
+export const listProducts = test(
+  { id: "list-products", name: "List Products", tags: ["smoke"] },
+  async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const data = await ctx.http.get(`${baseUrl}/products?limit=5`).json<{
+      products: unknown[];
+      total: number;
+    }>();
+
+    ctx.expect(data.products.length).toBe(5);
+    ctx.expect(data.total).toBeGreaterThan(0);
+
+    ctx.log(`Found ${data.total} products total`);
+  },
+);
+
+// ---------------------------------------------------------------------------
+// 2. Simple test — Search products
+// ---------------------------------------------------------------------------
+
+export const searchProducts = test(
+  { id: "search-products", name: "Search Products", tags: ["smoke"] },
+  async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const data = await ctx.http
+      .get(`${baseUrl}/products/search?q=phone`)
+      .json<{ products: { title: string }[] }>();
+
+    ctx.expect(data.products.length).toBeGreaterThan(0);
+
+    const names = data.products.map((p) => p.title);
+    ctx.log(`Found ${data.products.length} products matching 'phone'`, names);
+  },
+);
+
+// ---------------------------------------------------------------------------
+// 3. Multi-step builder — Authentication flow
+// ---------------------------------------------------------------------------
+
+export const authFlow = test("auth-flow")
+  .meta({ name: "Authentication Flow", tags: ["auth"] })
+  .step("login", async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+    const username = ctx.secrets.require("USERNAME");
+    const password = ctx.secrets.require("PASSWORD");
+
+    const data = await ctx.http
+      .post(`${baseUrl}/auth/login`, {
+        json: { username, password, expiresInMins: 1 },
+      })
+      .json<{
+        accessToken: string;
+        refreshToken: string;
+        username: string;
+      }>();
+
+    ctx.expect(data.accessToken).toBeDefined();
+    ctx.expect(data.username).toBe(username);
+
+    ctx.log(`Logged in as ${data.username}`);
+
+    return { token: data.accessToken, refreshToken: data.refreshToken };
+  })
+  .step("get profile", async (ctx, state) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const data = await ctx.http
+      .get(`${baseUrl}/auth/me`, {
+        headers: { Authorization: `Bearer ${state.token}` },
+      })
+      .json<{
+        email: string;
+        firstName: string;
+        lastName: string;
+      }>();
+
+    ctx.expect(data.email).toBeDefined();
+    ctx.expect(data.firstName).toBeDefined();
+
+    ctx.log(`Profile: ${data.firstName} ${data.lastName} (${data.email})`);
+
+    return state;
+  })
+  .step("refresh token", async (ctx, state) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const data = await ctx.http
+      .post(`${baseUrl}/auth/refresh`, {
+        json: { refreshToken: state.refreshToken, expiresInMins: 1 },
+      })
+      .json<{ accessToken: string }>();
+
+    ctx.expect(data.accessToken).toBeDefined();
+
+    ctx.log("Token refreshed successfully");
+  });
+
+// ---------------------------------------------------------------------------
+// 4. Simple test — Cart data integrity
+// ---------------------------------------------------------------------------
+
+export const cartIntegrity = test(
+  {
+    id: "cart-integrity",
+    name: "Cart Data Integrity",
+    tags: ["data-integrity"],
+  },
+  async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const cart = await ctx.http.get(`${baseUrl}/carts/1`).json<{
+      products: { quantity: number; price: number }[];
+      total: number;
+      discountedTotal: number;
+    }>();
+
+    ctx.expect(cart.products.length).toBeGreaterThan(0);
+
+    // Verify each product has valid data
+    for (const p of cart.products.slice(0, 3)) {
+      ctx.expect(p.quantity).toBeGreaterThan(0);
+      ctx.expect(p.price).toBeGreaterThan(0);
+    }
+
+    // Verify discount math
+    ctx.assert(
+      cart.discountedTotal <= cart.total,
+      "Discounted total should be <= total",
+      { actual: cart.discountedTotal, expected: `<= ${cart.total}` },
+    );
+
+    ctx.log(`Cart has ${cart.products.length} items`);
+    ctx.log(`Total: $${cart.total}, After discount: $${cart.discountedTotal}`);
+  },
+);
+
+// ---------------------------------------------------------------------------
+// 5. Simple test — Pagination consistency
+// ---------------------------------------------------------------------------
+
+export const paginationCheck = test(
+  { id: "pagination-check", name: "Pagination Consistency", tags: ["data"] },
+  async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const d1 = await ctx.http
+      .get(`${baseUrl}/products?limit=10&skip=0`)
+      .json<{ products: unknown[]; total: number; skip: number }>();
+
+    const d2 = await ctx.http
+      .get(`${baseUrl}/products?limit=10&skip=10`)
+      .json<{ products: unknown[]; total: number; skip: number }>();
+
+    ctx.expect(d1.products.length).toBe(10);
+    ctx.expect(d2.skip).toBe(10);
+    ctx.assert(
+      d2.skip + d2.products.length <= d2.total,
+      "skip + length should be <= total",
+      { actual: d2.skip + d2.products.length, expected: `<= ${d2.total}` },
+    );
+
+    ctx.log(`Page 1: ${d1.products.length} items (skip=0)`);
+    ctx.log(`Page 2: ${d2.products.length} items (skip=10)`);
+    ctx.log(`Total: ${d2.total}, verified skip + length <= total`);
+  },
+);
+
+// ---------------------------------------------------------------------------
+// 6. Multi-step builder — User-Todos cross-resource integrity
+// ---------------------------------------------------------------------------
+
+export const userTodosIntegrity = test("user-todos-integrity")
+  .meta({ name: "User Todos Cross-Resource", tags: ["data-integrity"] })
+  .step("fetch user", async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const user = await ctx.http
+      .get(`${baseUrl}/users/1`)
+      .json<{ id: number; firstName: string; lastName: string }>();
+
+    ctx.expect(user.id).toBe(1);
+    ctx.log(`User: ${user.firstName} ${user.lastName} (id=${user.id})`);
+
+    return { userId: user.id };
+  })
+  .step("verify todos", async (ctx, state) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const data = await ctx.http
+      .get(`${baseUrl}/todos?limit=5&skip=0`)
+      .json<{ todos: { id: number; todo: string; userId: number }[] }>();
+
+    ctx.expect(data.todos.length).toBeGreaterThan(0);
+
+    // Check that we can find todos for this user
+    const userTodos = data.todos.filter((t) => t.userId === state.userId);
+
+    ctx.log(
+      `Found ${data.todos.length} todos, ${userTodos.length} belong to user ${state.userId}`,
+    );
+
+    // Each todo should have required fields
+    for (const todo of data.todos.slice(0, 3)) {
+      ctx.expect(todo.id).toBeDefined();
+      ctx.expect(todo.todo).toBeDefined();
+    }
+  });

package/templates/explore-api.test.result.json

@@ -0,0 +1,79 @@
+{
+  "target": "/Users/peisong/glubean/oss/packages/cli/templates/explore-api.test.ts",
+  "files": [
+    "packages/cli/templates/explore-api.test.ts"
+  ],
+  "runAt": "2026-02-16 13:46:19",
+  "summary": {
+    "total": 1,
+    "passed": 0,
+    "failed": 1,
+    "skipped": 0,
+    "durationMs": 34,
+    "stats": {
+      "httpRequestTotal": 0,
+      "httpErrorTotal": 0,
+      "assertionTotal": 0,
+      "assertionFailed": 0,
+      "warningTotal": 0,
+      "warningTriggered": 0,
+      "stepTotal": 0,
+      "stepPassed": 0,
+      "stepFailed": 0
+    }
+  },
+  "tests": [
+    {
+      "testId": "quick-check",
+      "testName": "Quick Endpoint Check",
+      "tags": [
+        "explore"
+      ],
+      "success": false,
+      "durationMs": 34,
+      "events": [
+        {
+          "type": "log",
+          "message": "Loading test module: file:///Users/peisong/glubean/oss/packages/cli/templates/explore-api.test.ts"
+        },
+        {
+          "type": "start",
+          "id": "quick-check",
+          "name": "Quick Endpoint Check",
+          "tags": [
+            "explore"
+          ]
+        },
+        {
+          "type": "summary",
+          "data": {
+            "httpRequestTotal": 0,
+            "httpErrorTotal": 0,
+            "httpErrorRate": 0,
+            "assertionTotal": 0,
+            "assertionFailed": 0,
+            "warningTotal": 0,
+            "warningTriggered": 0,
+            "schemaValidationTotal": 0,
+            "schemaValidationFailed": 0,
+            "schemaValidationWarnings": 0,
+            "stepTotal": 0,
+            "stepPassed": 0,
+            "stepFailed": 0,
+            "stepSkipped": 0
+          }
+        },
+        {
+          "type": "status",
+          "status": "failed",
+          "error": "Missing required var: BASE_URL",
+          "stack": "Error: Missing required var: BASE_URL\n    at Object.require (file:///Users/peisong/glubean/oss/packages/runner/harness.ts:360:15)\n    at Object.fn (file:///Users/peisong/glubean/oss/packages/cli/templates/explore-api.test.ts:18:30)\n    at executeNewTest (file:///Users/peisong/glubean/oss/packages/runner/harness.ts:1192:18)\n    at file:///Users/peisong/glubean/oss/packages/runner/harness.ts:971:11"
+        },
+        {
+          "type": "error",
+          "message": "Process exited with code 1"
+        }
+      ]
+    }
+  ]
+}

package/templates/minimal/README.md

@@ -0,0 +1,42 @@
+# Glubean — Playground
+
+This is a quick playground for exploring APIs with [Glubean](https://glubean.com). Write TypeScript, run it, see every
+request traced.
+
+```bash
+deno task explore
+```
+
+## What's here
+
+| Path                        | Purpose                                         |
+| --------------------------- | ----------------------------------------------- |
+| `explore/api.test.ts`       | GET and POST examples — edit and run            |
+| `explore/search.test.ts`    | `test.pick` — one test, multiple variations     |
+| `explore/auth.test.ts`      | Multi-step auth — login, use token, get profile |
+| `data/search-examples.json` | Search parameters for pick examples             |
+
+Edit the files, change the URLs, hit play. That's it.
+
+---
+
+## Ready for real work?
+
+This playground is for trying things out. When you're ready to build a real test suite — with AI writing and running
+tests for you — create a full project:
+
+```bash
+mkdir my-api-tests && cd my-api-tests
+glubean init
+```
+
+Choose **Best Practice** to unlock:
+
+- **AI closed-loop** — your AI reads your API spec, writes tests, runs them via MCP, reads failures, fixes, and reruns
+  until green. You review the result, not the process.
+- **OpenAPI-driven** — drop your spec in `context/`, and the AI knows every endpoint, method, and schema. No guessing.
+- **Multi-environment** — same tests against dev, staging, and production. Switch with one flag.
+- **Data-driven tests** — generate dozens of cases from JSON, CSV, or YAML with `test.each`.
+- **CI + Cloud** — Git hooks, GitHub Actions, scheduled runs, Slack alerts when something breaks.
+
+The difference: here you write tests manually. There, the AI writes them and proves they work — before you even look.

package/templates/minimal-api.test.ts.tpl

@@ -0,0 +1,42 @@
+/**
+ * Quick API exploration — GET and POST examples ready to run.
+ *
+ * Edit the URLs, change the payload, hit play. Every request is
+ * auto-traced so you can inspect headers, timing, and response
+ * bodies in the trace viewer.
+ *
+ * Run: deno task explore
+ */
+import { test } from "@glubean/sdk";
+
+export const getProduct = test(
+  { id: "get-product", name: "GET Product", tags: ["explore"] },
+  async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const res = await ctx.http.get(`${baseUrl}/products/1`);
+    const data = await res.json();
+
+    ctx.expect(res.status).toBe(200);
+    ctx.expect(data.title).toBeDefined();
+
+    ctx.log("Product", data);
+  },
+);
+
+export const createProduct = test(
+  { id: "create-product", name: "POST Create Product", tags: ["explore"] },
+  async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const res = await ctx.http.post(`${baseUrl}/products/add`, {
+      json: { title: "Test Product", price: 9.99, category: "test" },
+    });
+    const data = await res.json();
+
+    ctx.expect(res.status).toBe(200);
+    ctx.expect(data.id).toBeDefined();
+
+    ctx.log("Created", data);
+  },
+);

package/templates/minimal-auth.test.ts.tpl

@@ -0,0 +1,45 @@
+/**
+ * Multi-step auth flow — login, use token, get profile.
+ *
+ * This demonstrates the builder API: each step passes state to the next.
+ * The trace viewer shows all three requests as a connected flow, not
+ * isolated calls. That's the difference between Glubean and a REST client.
+ *
+ * Run: deno task explore
+ */
+import { test } from "@glubean/sdk";
+
+export const authFlow = test("auth-flow")
+  .meta({ name: "Auth Flow", tags: ["explore", "auth"] })
+  .step("login", async (ctx) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+    const username = ctx.secrets.require("USERNAME");
+    const password = ctx.secrets.require("PASSWORD");
+
+    const data = await ctx.http
+      .post(`${baseUrl}/auth/login`, {
+        json: { username, password, expiresInMins: 1 },
+      })
+      .json<{ accessToken: string; refreshToken: string; username: string }>();
+
+    ctx.expect(data.accessToken).toBeDefined().orFail();
+    ctx.expect(data.username).toBe(username);
+
+    ctx.log(`Logged in as ${data.username}`);
+
+    return { token: data.accessToken };
+  })
+  .step("get profile", async (ctx, state) => {
+    const baseUrl = ctx.vars.require("BASE_URL");
+
+    const data = await ctx.http
+      .get(`${baseUrl}/auth/me`, {
+        headers: { Authorization: `Bearer ${state.token}` },
+      })
+      .json<{ email: string; firstName: string; lastName: string }>();
+
+    ctx.expect(data.email).toBeDefined();
+    ctx.expect(data.firstName).toBeDefined();
+
+    ctx.log(`Profile: ${data.firstName} ${data.lastName} (${data.email})`);
+  });

package/templates/minimal-search.test.ts.tpl

@@ -0,0 +1,34 @@
+/**
+ * Parameterized search — run different query variations with test.pick.
+ *
+ * Each example in search-examples.json defines a search term and expected
+ * outcome. In VS Code, CodeLens buttons appear above the test so you can
+ * click a specific example to run.
+ *
+ * Run all:      deno task explore
+ * Pick one:     glubean run explore/search.test.ts --pick by-name
+ * Pick another: glubean run explore/search.test.ts --pick no-results
+ */
+import { test } from "@glubean/sdk";
+import examples from "../data/search-examples.json" with { type: "json" };
+
+export const searchProducts = test.pick(examples)(
+  "search-$_pick",
+  async ({ http, vars, expect, log }, { q, expected }) => {
+    const baseUrl = vars.require("BASE_URL");
+
+    const res = await http
+      .get(`${baseUrl}/products/search`, { searchParams: { q } })
+      .json<{ products: { title: string }[]; total: number }>();
+
+    expect(res.total).toBeGreaterThan(expected.minResults - 1);
+
+    if (expected.titleContains && res.products.length > 0) {
+      expect(res.products[0].title.toLowerCase()).toContain(
+        expected.titleContains,
+      );
+    }
+
+    log(`"${q}" → ${res.total} results`);
+  },
+);

package/templates/openapi.sample.json

@@ -0,0 +1,97 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "Glubean Sample API (mock)",
+    "version": "0.0.0",
+    "description": "A mock OpenAPI spec shipped with `glubean init` for AI-assisted test generation. The real sample API service is not ready yet."
+  },
+  "servers": [
+    {
+      "url": "https://sample-api.glubean.com",
+      "description": "Mock URL"
+    }
+  ],
+  "components": {
+    "securitySchemes": {
+      "ApiKeyAuth": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "API key"
+      }
+    },
+    "schemas": {
+      "ErrorResponse": {
+        "type": "object",
+        "required": [
+          "error"
+        ],
+        "properties": {
+          "error": {
+            "type": "object",
+            "required": [
+              "code",
+              "message"
+            ],
+            "properties": {
+              "code": {
+                "type": "string",
+                "example": "VALIDATION_ERROR"
+              },
+              "message": {
+                "type": "string",
+                "example": "Invalid payload"
+              },
+              "fields": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "path",
+                    "reason"
+                  ],
+                  "properties": {
+                    "path": {
+                      "type": "string",
+                      "example": "email"
+                    },
+                    "reason": {
+                      "type": "string",
+                      "example": "must be a valid email"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "security": [
+    {
+      "ApiKeyAuth": []
+    }
+  ],
+  "paths": {
+    "/health": {
+      "get": {
+        "operationId": "healthCheck",
+        "tags": [
+          "System"
+        ],
+        "responses": {
+          "200": {
+            "description": "Service health",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}