saffron-ai 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -4,6 +4,52 @@ All notable changes to Saffron, in one place: the `saffron-ai` runner (npm),
 the VS Code extension (`ChathurangaJayasinghe.saffron-vscode`) and the
 JetBrains plugin (`ai.saffron.jetbrains`). Dates are publish dates.
 
+## 0.5.2
+
+Released 2026-09-15.
+
+Runner
+
+- Scenario Outlines record correctly: an assertion recorded from the page's
+  longer sentence now becomes the `<placeholder>` outright when it contains
+  the row's value (substring replacement used to leave a residue that no
+  other row could satisfy), and rows after the first replay the pending
+  proposal at zero AI instead of recording again and overwriting it. When
+  the proposal does not fit a row, the run is red with a clear message
+  rather than silently replacing another row's recording.
+- The agent is told to record a Then step's quoted text exactly as
+  expected text, never the page's longer sentence.
+- A Given step or StepSet guard that describes a state the page is already
+  in is no longer reported as an adaptation. The saucedemo example's
+  checkout set used to show a warning on its first recording for this.
+- Yellow scenarios are labelled "pending review" in the run summary and the
+  HTML report instead of "adapted", since a proposal is not necessarily an
+  adaptation.
+
+Editors
+
+- `{env:VAR}` tokens are navigable: Ctrl/Cmd+click (go to definition)
+  opens the variable in `.env`, or `.env.example` when no `.env` exists;
+  hover says where it is defined and never shows the value. In the VS
+  Code extension and in `saffron lsp` for JetBrains and other editors.
+
+## 0.5.1
+
+Released 2026-09-14.
+
+Runner
+
+- Example suite: `.saffron` files only, with StepSets invoked both at the
+  start of scenarios and in the middle ("Recover from a locked-out
+  login", and a checkout set that carries a data table).
+
+Editors
+
+- Grammar: quoted arguments, `<placeholders>` and `{env:…}` / `{date…}`
+  tokens get their own scopes, so editors colour them like Cucumber
+  parameters instead of the whole step line. Ships in the VS Code
+  extension, the JetBrains plugin and the package's TextMate bundle.
+
 ## 0.5.0
 
 Released 2026-09-14.

package/README.md

@@ -37,10 +37,11 @@ npx saffron init        # config + agent skill; offers the Saucedemo example sui
 npx saffron run
 ```
 
-No app of your own yet? `npx saffron init --examples` installs five short
-scenarios against the public demo shop at saucedemo.com (login, cart,
-checkout, a Scenario Outline, a StepSet) so the first run records and
-replays something real.
+No app of your own yet? `npx saffron init --examples` installs a handful
+of short `.saffron` scenarios against the public demo shop at saucedemo.com
+(login, a Scenario Outline, cart, checkout, StepSets at the start and in
+the middle of scenarios) so the first run records and replays something
+real.
 
 **Built for the AI era:** the package ships an [Agent Skill](https://agentskills.io) that teaches Claude Code, Codex, Cursor, Copilot and any skill-aware agent to write Saffron tests efficiently. Reuse recorded wordings, keep assertions sacred, secrets as `{env:VAR}`, so the tests your agents write replay at zero tokens instead of paying for near-duplicate recordings.