saffron-ai 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -4,6 +4,70 @@ 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.9.1
+
+Released 2026-09-29.
+
+Runner
+
+- **Tag expressions in `--filter`.** `--filter "@e2e and not @wip"`,
+  `"(@smoke or @sanity) and not @flaky"`: `and`, `or`, `not` and
+  parentheses, in the shape Cucumber and pytest use, with `and` binding
+  tighter than `or`. The list forms keep their meaning: `@a,@b`, `@a @b`,
+  `@a|@b` and a repeated flag all mean `or`, and the `@` may be left off.
+  A malformed expression stops the run with exit 2 and names the problem.
+- **Replay fixes.** A network assertion checked without the run's
+  response log (the check after a heal) now checks the response body too:
+  a heal could pass while the API answered `{"ok":false}`. A file upload
+  armed for the next file chooser is set by the click that opens it,
+  which waits for a chooser that opens late up to the action timeout. If
+  no chooser opens, or the files cannot be set (a missing file), that
+  click fails, and so does each retry of it, instead of the runner ending
+  or the scenario passing with nothing uploaded. `{env:VAR}` in the
+  pattern of `expectMatches` and `expectAttribute` is resolved like
+  every other field.
+- **A click through a locator chain records the element it clicked.**
+  When the agent targets an element with a selector string, Playwright
+  MCP reports a chain such as `locator('article:has(...)')
+  .locator('role=button[name="Select room"]')`. The recorder kept only the
+  first link, so replay clicked the whole card instead of its button, and
+  a refine pass then re-clicked the room under the next step. Chains of
+  locators, getBy calls, `filter({ hasText })`, `nth`, `first` and `last`
+  are now kept whole as one selector; a chain part with no selector form
+  is not recorded rather than recorded as a different element. The agent
+  is also told to act through snapshot refs, which record as role and
+  name.
+- **Dates picked through a selector string move with the calendar.** A
+  date in a fallback selector or test id (`role=button[name="2026-10-11"]`)
+  is now templated to `{date+N}` like one in a name or label, and replay
+  resolves it there, so the recording does not expire the next day.
+- **Open Replay opens the run its row lists.** `saffron trace --run
+  <startedAt>` refuses a later run ("The last run changed since this was
+  listed"), and both editors pass it, so an older row no longer opens a
+  newer run's trace.
+- **A decision under way keeps its lock.** A proposal lock held by a live
+  process on this machine is never broken for its age, so a paused
+  decision cannot be overtaken.
+
+Editors (VS Code extension 0.3.2, JetBrains plugin 0.3.2)
+
+- **VS Code: a project nested inside a bigger workspace folder finds its
+  data folder.** `{data:...}` completion, hover and diagnostics resolve
+  against the nearest `saffron.config.json` above the file, not the
+  workspace root.
+- **JetBrains: the Run Tagged tooltip** says the CLI also takes tag
+  expressions.
+- **Open Replay opens the run its row lists**, with saffron-ai 0.9.1 or
+  later; with an older runner it opens the scenario as before.
+- **JetBrains: the tool window opens on IntelliJ 2026.2.** The Dashboard
+  tab crashed the whole Saffron tool window there (NoClassDefFoundError:
+  JBCefApp), because 2026.2 moved the embedded browser into its own
+  plugin. The plugin now depends on it where it exists, and without it
+  the Dashboard falls back to Open in Browser.
+- **VS Code: `.saffron` files show the Saffron mark** in the explorer and
+  tabs, under any file icon theme that has no icon of its own for them
+  (Seti, the default, included).
+
 ## 0.9.0
 
 Released 2026-09-27.

package/README.md

@@ -72,7 +72,7 @@ node dist/cli/index.js -p examples accept --all
 
 | Command | What it does |
 |---|---|
-| `saffron run [paths] [--headed] [--filter @tags] [--rerecord] [--no-agent] [--strict] [--browser b] [--no-hooks] [--workers n] [--heal-model m] [--no-verify] [--no-reuse] [--model m] [--storage-state f] [--trace mode]` | Run features. Cached replays are deterministic; misses/failures escalate to the agent (unless `--no-agent`). Replay cross-browser with `--browser firefox\|webkit`, parallelize with `--workers N`, heal on a cheaper model with `--heal-model`, keep an execution trace with `--trace retain-on-failure`. Exit 1 on red (and on yellow with `--strict`). |
+| `saffron run [paths] [--headed] [--filter expr] [--rerecord] [--no-agent] [--strict] [--browser b] [--no-hooks] [--workers n] [--heal-model m] [--no-verify] [--no-reuse] [--model m] [--storage-state f] [--trace mode]` | Run features. Cached replays are deterministic; misses/failures escalate to the agent (unless `--no-agent`). Replay cross-browser with `--browser firefox\|webkit`, parallelize with `--workers N`, heal on a cheaper model with `--heal-model`, keep an execution trace with `--trace retain-on-failure`. Exit 1 on red (and on yellow with `--strict`). |
 | `saffron accept [files... \| --all] [--include-unverified] [--with-feature-edit] [--propagate]` | Promote cache proposals to committed caches (`--all` skips UNVERIFIED ones unless `--include-unverified`); `--with-feature-edit` also rewrites the adapted steps in the `.feature` file (and keeps the cache in sync); `--propagate` applies the heal's locator fixes to every other cache using the same locator. One heal repairs N scenarios before they ever fail. No args: list pending proposals. |
 | `saffron reject [files... \| --all]` | Discard proposals; the agent will try again next run. |
 | `saffron status [--json]` | Project overview for people, IDE panels and dashboards: feature files and scenarios with cache state, tags, pending proposals, last run, history, vocabulary health (divergent steps, duplicate wordings proven by identical recordings), effective config. |