@glubean/cli 0.1.67 → 0.1.69

package/README.md

@@ -0,0 +1,175 @@
+# @glubean/cli
+
+The Glubean command-line tool. Run tests, sync results to Cloud, scaffold projects, manage environments.
+
+```bash
+npm install -g glubean
+```
+
+Or invoke once without installing:
+
+```bash
+npx glubean <command>
+```
+
+Both `glubean` and the short alias `gb` are installed.
+
+## Quick start
+
+```bash
+glubean init                    # interactive wizard
+glubean run                     # run all tests in testDir
+glubean run path/to/file.test.ts
+glubean run --filter checkout --tag smoke
+glubean run --ci --upload       # CI mode + push results to Cloud
+```
+
+See the full project README at the [repo root](../../README.md) for the broader Glubean story (SDK, MCP, agent workflow).
+
+## Commands
+
+### `init`
+
+Scaffold a new Glubean project. The interactive wizard asks what mode you want and writes the right config.
+
+```bash
+glubean init
+glubean init --contract-first         # contracts/ + tests/ layout
+glubean init --ai-tools               # also configure MCP server + AI skill
+glubean init --hooks --github-actions # git hooks + CI workflow
+glubean init --no-interactive --base-url https://api.example.com
+```
+
+### `run [target]`
+
+Run tests from a file, a directory, or a glob. Defaults to the project's `testDir`.
+
+```bash
+glubean run                                # everything in testDir
+glubean run tests/checkout.test.ts         # one file
+glubean run tests/checkout                 # one directory
+glubean run --explore                      # use exploreDir instead of testDir
+glubean run --filter login                 # name or id substring
+glubean run --tag smoke,critical           # by tag (comma or repeatable)
+glubean run --tag-mode and                 # all tags must match
+glubean run --pick happyPath               # specific test.pick example
+glubean run --fail-fast                    # stop on first failure
+glubean run --result-json                  # write .result.json
+glubean run --reporter junit               # JUnit XML
+glubean run --ci                           # shorthand: --fail-fast + JUnit
+glubean run --upload --project <id>        # push to Glubean Cloud
+glubean run --inspect-brk                  # attach a debugger
+```
+
+Useful flags:
+
+| Flag | Effect |
+|------|--------|
+| `--env-file <path>` | Load a specific `.env` file |
+| `--config <paths>` | One or more config files (comma-separated or repeatable) |
+| `--verbose` | Show traces and assertions inline |
+| `--log-file` | Write per-test logs to disk |
+| `--emit-full-trace` | Include full headers and bodies in HTTP traces |
+| `--infer-schema` | Infer JSON Schema from response bodies |
+| `--trace-limit <n>` | Cap trace files per test (default 20) |
+| `--meta key=value` | Attach custom metadata to the run (repeatable) |
+| `--no-session` | Skip session setup/teardown |
+| `--no-update-check` | Skip the npm update check |
+
+### `scan`
+
+Statically analyze a directory and emit `metadata.json` describing the test suite (used by IDE integrations and Cloud upload). Also extracts contract metadata when `.contract.ts` files are present.
+
+```bash
+glubean scan tests/
+glubean scan --upload --project <id>      # push contract metadata without running
+```
+
+### `validate-metadata`
+
+Verify that a previously generated `metadata.json` still matches the local files.
+
+```bash
+glubean validate-metadata metadata.json
+```
+
+### `login`
+
+Authenticate with Glubean Cloud. Stores a token under `~/.glubean/`.
+
+```bash
+glubean login
+```
+
+### `patch <spec>`
+
+Merge an OpenAPI spec with a sibling `.patch.yaml` and write the resolved spec.
+
+```bash
+glubean patch openapi.yaml
+```
+
+### `spec split <spec>`
+
+Dereference all `$ref`s and split a spec into per-endpoint files. Useful for feeding individual endpoints to an agent.
+
+```bash
+glubean spec split openapi.yaml
+```
+
+### `redact`
+
+Preview how the redaction policy would transform a `.result.json` before uploading.
+
+```bash
+glubean redact tests/checkout.result.json
+```
+
+### `config mcp`
+
+Install and configure the Glubean MCP server for your editor (Claude Code, Cursor, Windsurf, and others). Auto-detects installed tools.
+
+```bash
+glubean config mcp
+```
+
+### `env`
+
+Manage which `.env.<name>` file is active for `glubean run`.
+
+```bash
+glubean env list                # show available environments
+glubean env use staging         # activate .env.staging
+glubean env                     # print current active env
+glubean env reset               # clear active env (use default .env)
+```
+
+### `upgrade`
+
+Self-upgrade to the latest published version.
+
+```bash
+glubean upgrade
+```
+
+## Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `GLUBEAN_CWD` | Override the working directory (useful for shell aliases) |
+| `GLUBEAN_PROJECT_ID` | Default Cloud project for `--upload` |
+| `GLUBEAN_TOKEN` | Auth token for Cloud (alternative to `glubean login`) |
+| `GLUBEAN_API_URL` | Override the Cloud API URL |
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | Test failure or CLI error |
+
+## Links
+
+- [Glubean repo](https://github.com/glubean/glubean) — SDK, runner, scanner, plugins
+- [Docs](https://docs.glubean.com) — full documentation
+- [Cloud](https://app.glubean.com) — hosted run history and analytics

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glubean/cli",
-  "version": "0.1.67",
+  "version": "0.1.69",
   "type": "module",
   "bin": {
     "glubean": "./bin/gb.js"
@@ -27,9 +27,9 @@
     "dotenv": "^16.4.0",
     "yaml": "^2.7.0",
     "tsx": "^4.19.0",
-    "@glubean/sdk": "0.1.28",
-    "@glubean/runner": "0.1.40",
-    "@glubean/scanner": "0.1.28",
+    "@glubean/sdk": "0.1.30",
+    "@glubean/scanner": "0.1.29",
+    "@glubean/runner": "0.1.42",
     "@glubean/redaction": "0.1.27"
   },
   "devDependencies": {