@xera-ai/skills 0.4.3 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xera-ai/skills",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "files": [
     "*.md",
     "version.json"

package/version.json

@@ -1,6 +1,6 @@
 {
-  "skills": "0.4.3",
-  "compatible_prompts": "^2.3.0",
+  "skills": "0.5.0",
+  "compatible_prompts": "^2.4.0",
   "skill_files": [
     "xera-run.md",
     "xera-fetch.md",

package/xera-exec.md

@@ -8,6 +8,7 @@ The user invoked `/xera-exec <TICKET>`. If no key, ask.
 1. Verify `.xera/{{TICKET}}/spec.ts` exists. If not: "Generate the spec first with `/xera-script {{TICKET}}`." STOP.
 
 2. Run: `bun run xera:exec {{TICKET}}`
+   `bun run xera:exec` automatically picks the runner based on `meta.json.adapter` (web or http).
    - Exit 0 → all scenarios passed.
    - Exit 1 → user/config error (lock held, missing env var). Show the error verbatim and STOP.
    - Exit 3 → test failure. This is expected; continue.

package/xera-impact.md

@@ -60,11 +60,19 @@ Ask the user: `Re-run impacted scenarios?  [Y]es / [p] P0 only / [s]elect / [n]o
 
 - **[n]:** STOP. The user can inspect `.xera/impact/{{TICKET}}.md` separately.
 
-- **[Y]:** Group impacted scenarios by their owner ticket (`scenario.ticketId`). For each owner ticket, invoke `bun run xera:exec <owner-ticket>` (the existing exec subcommand). Collect the `RUN_ID` from each. Note: this re-runs the ENTIRE spec for each impacted owner, not just the impacted scenarios — Playwright doesn't natively support per-test selection from a json list without test-name regex. Acceptable for v0.6.2; precise per-scenario selection is a v0.6.x patch.
+- **[Y]:** Group impacted scenarios by their owner ticket (`scenario.ticketId`). For each owner ticket, build a regex from the impacted scenario names — e.g. `"user signs in|user resets password"` — and invoke:
 
-- **[p]:** Filter `scenarios` array to `priority === 'p0'` only, then proceed as [Y].
+  ```bash
+  bun run xera:exec <owner-ticket> --grep "<NAME_REGEX>"
+  ```
 
-- **[s]:** Show numbered list with checkboxes; let the user pick. Then proceed as [Y] with the selected subset.
+  The `--grep` flag (added in v0.6.4) makes Playwright run **only the named scenarios**, not the entire spec. Build the regex by joining `impacted[].name` with `|` and escaping any regex special characters in the names. If a scenario name contains characters like `(`, `)`, or `|`, escape them with `\\`.
+
+  Collect each invocation's `RUN_ID` and surface them in the final summary.
+
+- **[p]:** Filter to `priority === 'p0'` scenarios, then proceed as [Y] above (use `--grep` per owner ticket).
+
+- **[s]:** Show numbered list with checkboxes; let the user pick a subset. Proceed as [Y] using the selected subset for the `--grep` regex.
 
 ## Step 5 — Recommend follow-up
 

package/xera-run.md

@@ -22,7 +22,7 @@ If meta is missing or story_hash is older, refresh.
 
 After `/xera-fetch` completes, check whether this ticket modifies areas that other tests depend on.
 
-Read `xera.config.run.autoImpact` (defaults: `{ enabled: true, threshold: 6.0 }`). If `enabled === false`, SKIP this step.
+Read `xera.config.run.autoImpact` (defaults: `{ enabled: true, threshold: 8.0 }`). If `enabled === false`, SKIP this step.
 
 Run:
 
@@ -32,14 +32,12 @@ bun run xera:impact-prepare {{TICKET}} --quiet
 
 This writes `.xera/impact/{{TICKET}}.json` (no markdown). Exit code 2 means the ticket is not yet in graph — surface a warning and proceed (graph data only accumulates over time).
 
-Read the JSON. Count scenarios with `riskScore >= autoImpact.threshold`. If 0, no prompt — continue silently to Step 2.
+Read the JSON. Count scenarios with `riskScore >= autoImpact.threshold` (default **8.0** per v0.6.4).
 
-If ≥1 high-risk scenario, prompt the user:
+- If **0** scenarios above threshold → continue **silently** to Step 2. Do not show any prompt; do not log the result. The impact analysis ran but found nothing actionable.
+- If **≥1** above threshold → prompt the user as before: `[Y]es / [n]o / [details]`.
 
-```
-{{N}} high-risk impacted scenarios detected for {{TICKET}}.
-Re-run them before generating the new script? [Y/n/details]
-```
+This means the auto-trigger is effectively a "high-risk alarm" rather than a per-run interruption. With the default threshold raised to 8.0, prompts only fire for tickets that genuinely affect P0 scenarios in heavily-shared SUT areas. Teams that want the older, chatty behavior can lower the threshold via `xera.config.run.autoImpact.threshold`.
 
 - **[Y]:** Iterate `bun run xera:exec <owner-ticket>` for each unique owner ticket. After each, check status; if all pass, continue to Step 2. If any fail, surface the failure and STOP — the user should diagnose existing-test breakage before introducing more changes.
 - **[n]:** Continue to Step 2.

package/xera-script.md

@@ -12,7 +12,19 @@ The user invoked `/xera-script <TICKET>`. If no key, ask.
 
 3. List existing shared POMs by reading `shared/page-objects/` (every `.ts` file, parse exported class names). Pass this list to yourself as context for reuse decisions.
 
-4. Read `node_modules/@xera-ai/prompts/script-from-feature.md`. Follow its hard rules.
+4. Read `.xera/{{TICKET}}/meta.json` to get the adapter (`adapter` field). Then read the appropriate prompt template:
+
+   - If `adapter === "web"` (or missing): use `node_modules/@xera-ai/prompts/script-from-feature-web.md`.
+   - If `adapter === "http"`: use `node_modules/@xera-ai/prompts/script-from-feature-http.md`.
+
+   Follow that prompt's hard rules.
+
+   When `adapter === "http"` AND `xera.config.ts` has `http.spec` configured, additionally:
+   - Load the OpenAPI spec at `http.spec` (path or URL).
+   - Find the operation referenced by the failing Gherkin step (matching method + path).
+   - Pass the dereferenced operation schema to your generation context as the `openapi` input.
+
+   When `adapter === "http"` and no `http.spec`: pass `openapi: null` to your generation context.
 
 5. Before reading the test.feature + story.md content into your generation context, mint a fresh per-invocation nonce by running: