saffron-ai 1.2.1 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,15 +1,16 @@
1
1
  {
2
2
  "name": "saffron-ai",
3
- "version": "1.2.1",
3
+ "version": "1.2.2",
4
4
  "description": "End-to-end tests written in plain language: an AI agent records each scenario once, replays run at zero tokens, and broken replays heal into proposals you review",
5
5
  "scripts": {
6
6
  "test": "vitest run",
7
7
  "build": "tsc",
8
8
  "dev": "tsc --watch",
9
9
  "e2e": "node scripts/e2e.mjs && node scripts/e2e-eject.mjs",
10
+ "benchmark": "node scripts/benchmark.mjs",
10
11
  "prepublishOnly": "npm run build && npm test",
11
12
  "prepack": "npm run bundle",
12
- "docs": "node scripts/build-docs.mjs && node scripts/build-site-docs.mjs && node scripts/build-claude-plugin.mjs && node scripts/build-vscode-keywords.mjs",
13
+ "docs": "node scripts/build-compat.mjs && node scripts/build-docs.mjs && node scripts/build-site-docs.mjs && node scripts/build-claude-plugin.mjs && node scripts/build-vscode-keywords.mjs",
13
14
  "bundle": "esbuild src/cli/index.ts --bundle --platform=node --format=esm --packages=external --minify --legal-comments=none --outfile=dist-pkg/cli.js",
14
15
  "plugin": "node scripts/build-claude-plugin.mjs"
15
16
  },
@@ -65,7 +66,7 @@
65
66
  "vscode-languageserver": "^10.1.0",
66
67
  "vscode-languageserver-textdocument": "^1.0.12",
67
68
  "yaml": "^2.9.1",
68
- "zod": "^4.4.3"
69
+ "zod": "^4.6.7"
69
70
  },
70
71
  "homepage": "https://saffron-ai.io",
71
72
  "repository": {
@@ -3,12 +3,15 @@ name: saffron
3
3
  description: Create, translate, or edit Saffron test scenarios in .saffron or .feature files, browser UI tests and HTTP API tests (@api) alike, including validating their recordings and replay. Use when asked to author or fix these test files in a Saffron project. Do not activate for ordinary application development, generic Cucumber projects, or requests only to run existing tests, inspect reports, review proposals, or configure Saffron.
4
4
  license: Saffron Free Use License v1.0 (see the saffron-ai package LICENSE)
5
5
  metadata:
6
+ saffron-ai: "1.2.2"
6
7
  author: saffron-ai
7
8
  homepage: https://saffron-ai.io
8
9
  ---
9
10
 
10
11
  # Saffron
11
12
 
13
+ This skill describes saffron-ai 1.2.2 (see the compatibility page: https://saffron-ai.io/docs/compatibility).
14
+
12
15
  Apply this workflow only when asked to create, translate, or edit Saffron
13
16
  scenarios in `.saffron` or `.feature` files. A Saffron mention or an
14
17
  existing test file in the project does not activate authoring work.
@@ -61,14 +64,18 @@ names the old value elsewhere (a `delete-bob` test id, a `#row-bob`
61
64
  selector) is not reused for the new one: that step records afresh. `saffron init` registers the
62
65
  `saffron` MCP server with Claude Code, Cursor and VS Code; its
63
66
  `search_steps` / `list_step_sets` / `project_status` tools give the same
64
- answers without a shell, and `api_contract` lists the operations of the
65
- pinned API contract for `@api` scenarios.
67
+ answers without a shell, `run_plan` says what a run would replay and
68
+ record (and which new steps to record and accept first) before it costs
69
+ anything, `api_contract` lists the operations of the pinned API
70
+ contract for `@api` scenarios, and `verify` replays what you changed at
71
+ zero AI and reports any check you weakened against the reviewed baseline.
66
72
 
67
73
  **Know the project before touching it:**
68
74
 
69
75
  ```bash
70
76
  npx saffron status # files and scenarios (● cached, ◐ proposal pending, ○ unrecorded), tags, proposals, last run, health
71
77
  npx saffron status --json # the same as data (what the IDE panels and the project_status MCP tool read)
78
+ npx saffron run --plan # what a run would replay, record or refuse, and the agent sessions it needs, without running
72
79
  ```
73
80
 
74
81
  Use it to pick tags that already exist, to see which scenarios are
@@ -86,7 +86,7 @@ your-project/
86
86
  | `saffron steps [search] [--json] [--snippets]` | The step vocabulary with recorded/divergent/unrecorded badges |
87
87
  | `saffron author <prose-file> [--provider p]` | Draft a `.saffron` file from plain-paragraph requirements using the project vocabulary |
88
88
  | `saffron login [provider]` | Check that a provider can record and heal here and list what is missing; `saffron login cursor` also runs Cursor's one-time sign-in, `saffron login antigravity` also allows Saffron's tools in agy |
89
- | `saffron mcp` / `saffron lsp` | MCP tools (`search_steps`, `list_step_sets`, `project_status`, `api_contract`) for AI assistants / language server for editors |
89
+ | `saffron mcp` / `saffron lsp` | MCP tools (`search_steps`, `list_step_sets`, `project_status`, `run_plan`, `api_contract`, `verify`) for AI assistants / language server for editors |
90
90
  | `saffron api pin <source> [--out file] [--service name]` | Pin the API contract: fetch an OpenAPI 3 document from a Swagger UI page, a document URL or a file, and write it as JSON (default `api/openapi.json`, or `api/<name>.json` with `--service`). Add it to the config as `api.contract`, or as `api.services.<name>.contract` |
91
91
  | `saffron init [--examples] [--agents list]` | Install this skill into the project's agent directories, register MCP, add an AGENTS.md block, scaffold config; `--examples` adds the Saucedemo example suite |
92
92
  | `saffron report [--merge [paths]] \| --run <id> [--provider p] [--allow-fork] [--max-download MB] [--json \| --panel]` | Open the latest HTML report; `--merge` combines a complete set of shard reports into `latest.json`, `latest.html` and one history line. `--run` views a CI run's results without importing: downloaded once into `.saffron/ci/` (newest 10 runs, 1 GB, fixed), checked like an import, proposals judged importable or not with the reason, nothing filed. No bundle exits 0 with `reasonKind` `running`, `expired` or `none`; over `--max-download` exits 2 with `kind: "too-large"` and `sizeBytes`. `saffron import --run` reuses the download. `--panel` prints the run's results as the one HTML page the editors' CI results panel shows |