@appliqation/heal-selector 0.1.2 → 0.1.3

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.
Files changed (2) hide show
  1. package/README.md +23 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -43,6 +43,29 @@ appliqation-heal-selector heal \
43
43
 
44
44
  Add `--json`/`--ci` for a structured summary. The exit code is 0 only when a patch was written *and* independently verified by a real, post-patch test run. A decline, or an unverified attempt, both exit non-zero; the JSON summary's `declined` field tells them apart.
45
45
 
46
+ ## CLI reference
47
+
48
+ `appliqation-heal-selector heal [options]`
49
+
50
+ **Required:**
51
+
52
+ | Option | Description |
53
+ |---|---|
54
+ | `--test-case-uuid <uuid>` | Test case this failing selector belongs to. |
55
+ | `--script-path <path>` | The script file containing the broken selector, relative to `--repo-path`. |
56
+ | `--failure <text>` | Free-text description of what is failing and why: a step name, the selector, an error message. Whatever the caller already knows. |
57
+ | `--environment <name>` | Environment name — its URL (from `get_project_settings`) is what the browser navigates to. |
58
+
59
+ **Optional:**
60
+
61
+ | Option | Description |
62
+ |---|---|
63
+ | `--defect-id <id>` | A defect linked to this failure, if known — offered as extra diagnostic context. |
64
+ | `--repo-path <path>` | Target repo root every file/command tool call is scoped to. Defaults to the current working directory. |
65
+ | `--max-turns <n>` | Override `BUDGET_MAX_TURNS` for this run. |
66
+ | `--json` | Print a single structured JSON summary on stdout instead of a human-readable report. |
67
+ | `--ci` | Shorthand for `--json`; exit code already reflects the real, `execFile`-verified outcome either way. |
68
+
46
69
  ## Configuration
47
70
 
48
71
  Copy `.env.example` to `.env`. Requires `APPQ_API_KEY` (read-only access is sufficient; this agent never calls an appq write tool) and one of `ANTHROPIC_API_KEY`/`OPENAI_API_KEY`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@appliqation/heal-selector",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "Standalone agent that heals one broken Playwright selector in an existing script: narrow and token-efficient, never a full regenerate. Verifies a healed selector targets the same semantic element (accessibility role + name, the test case's own expected_result) before touching anything; declines rather than guesses.",
5
5
  "license": "MIT",
6
6
  "repository": {