@exodus/xqa 5.0.0 → 5.1.0

package/README.md

@@ -113,6 +113,7 @@ Inspects the git diff between the current branch and its upstream, asks the plan
 ```bash
 xqa plan                                          # generate scenarios from current diff
 xqa plan --intent "login changes" --out .xqa/test-plan/my-slug
+xqa plan --base develop                           # diff against a branch other than origin/HEAD
 xqa plan edit .xqa/test-plan/my-slug/scenario-1.test.md --feedback "rename step 2"
 xqa plan extend                                   # append scenarios for fresh commits
 xqa plan report --findings .xqa/output/.../findings.json --specs .xqa/test-plan/my-slug
@@ -122,6 +123,8 @@ Flags:
 
 - `--intent <text>` — Optional focus hint passed to the planner.
 - `--out <dir>` — Output directory for the generated scenarios (default: `<xqa>/test-plan/default`).
+- `--base <ref>` — Base git ref to diff against. When omitted, xqa auto-detects the base from an open PR via `gh pr view` and falls back to `origin/HEAD`. Pass explicitly to override.
+- `--debug` — Log base/head refs, diff summary, existing specs count, classification, the full prompt sent to the model, and the raw AI response to stderr. Useful for investigating `model-abstained` empty results.
 
 Subcommands:
 

package/dist/skills/xqa-test-plan/SKILL.md

@@ -87,13 +87,27 @@ Count booted devices:
 
 Remember the chosen UDID for the Run step.
 
-### 3. Invoke planner
+### 3. Detect base ref
+
+MUST resolve `--base` before invoking planner; wrong diff causes model abstention (`emptyReason: model-abstained`).
+
+| Detection method                   | Command                                                                    | Use when                       |
+| ---------------------------------- | -------------------------------------------------------------------------- | ------------------------------ |
+| Open PR (authoritative)            | `gh pr view --json baseRefName --jq '.baseRefName'`                        | `gh` available + PR exists     |
+| Local upstream tracking (fallback) | `git rev-parse --abbrev-ref @{upstream}` — strip remote prefix (`origin/`) | No PR; upstream set            |
+| None                               | Omit `--base` entirely                                                     | Both methods fail or empty out |
+
+MUST NOT fabricate a base ref when detection fails — omit the flag and let the CLI default to `origin/HEAD`.
+
+### 4. Invoke planner
 
 ```bash
-xqa plan --intent "<one-sentence summary>" --out .xqa/test-plan/<slug>
+xqa plan --intent "<one-sentence summary>" --base <base-ref> --out .xqa/test-plan/<slug>
 ```
 
-### 4. Render approval checklist
+Omit `--base <base-ref>` when detection produced no result.
+
+### 5. Render approval checklist
 
 - Parse planner stdout as JSON; extract the `specs[]` array.
 - Read each `<path>.test.md` that the planner wrote.
@@ -203,6 +217,9 @@ IMPORTANT: Regenerate never deletes `runs/`. Run history is preserved across reg
 - [ ] Detect state auto-prunes stale sibling dirs but never current
 - [ ] Generate flow handles 0 booted simulators (error), 1 (auto), >1 (prompt)
 - [ ] Generate flow passes `--intent` correctly
+- [ ] Generate flow detects base ref from open PR (`gh pr view`)
+- [ ] Generate flow falls back to upstream tracking when no PR exists
+- [ ] Generate flow omits `--base` when both detection methods fail
 - [ ] Approval loop calls `xqa plan edit` per file
 - [ ] Run flow preflights simulator before dispatching
 - [ ] Report flow renders two-state status (has_findings / not_run) correctly