npm - @yasserkhanorg/impact-gate - Versions diffs - 2.1.5 → 2.1.7 - Mend

@yasserkhanorg/impact-gate 2.1.5 → 2.1.7

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 (13) hide show

package/README.md +77 -16
package/dist/agent/config.d.ts.map +1 -1
package/dist/agent/config.js +3 -0
package/dist/cli/parse_args.d.ts.map +1 -1
package/dist/cli/parse_args.js +3 -2
package/dist/cli/usage.js +2 -2
package/dist/esm/agent/config.js +3 -0
package/dist/esm/cli/parse_args.js +3 -2
package/dist/esm/cli/usage.js +2 -2
package/dist/esm/qa-agent/cli.js +4 -4
package/dist/qa-agent/cli.js +4 -4
package/package.json +6 -6
package/skills/qa/SKILL.md +14 -7

package/README.md CHANGED Viewed

@@ -1,14 +1,31 @@
-# @yasserkhanorg/impact-gate
+<p align="center">
+  <img src="./docs-site/public/impact-gate-readme-banner.png" alt="Impact Gate" width="720" />
+</p>
-Diff-aware E2E impact analysis and coverage gating for Playwright/Cypress teams. Optional AI features can suggest, generate, and heal tests once your project has a route-families.json manifest.
+# Impact Gate
+`@yasserkhanorg/impact-gate`
+Diff-aware E2E impact analysis, release-ready test planning, coverage gating, and hallucination-resistant AI generation for Playwright/Cypress teams. Optional AI features can suggest, generate, and heal tests once your project has a route-families.json manifest.
 [![npm](https://img.shields.io/npm/v/%40yasserkhanorg%2Fimpact-gate)](https://www.npmjs.com/package/@yasserkhanorg/impact-gate)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
 [![GitHub](https://img.shields.io/badge/github-repo-blue?logo=github)](https://github.com/yasserfaraazkhan/impact-gate)
+[Docs](https://yasserfaraazkhan.github.io/impact-gate/)
 ## What It Does
-`impact-gate` is built first for one painful CI job: given a git diff, tell us which E2E surface changed and whether the current suite already covers it.
+`impact-gate` is built first for one painful CI job: given a git diff, tell us which E2E surface changed, whether the current suite already covers it, and what still needs testing before we merge or ship.
+That same workflow works for:
+- pull requests against `main`
+- release branches against the previous release tag
+- hotfixes against the last shipped version
+- any "what changed between these refs?" release-readiness check
+Product priorities:
 - **Primary**: diff-aware E2E impact analysis and coverage gating
 - **Secondary**: optional AI features can suggest, generate, and heal tests once your project has a route-families.json manifest
@@ -16,6 +33,9 @@ Diff-aware E2E impact analysis and coverage gating for Playwright/Cypress teams.
 The clearest path today is a Playwright or Cypress repository with a maintained `route-families.json` manifest. That is the path this package is optimized to make unusually clear and useful.
+AI-specific note:
+- Generated tests are grounded against the discovered local API surface and verified before they are trusted. The package is designed to reduce hallucinated page-object methods, fabricated helpers, and low-evidence test generation.
 Transition note:
 - The package and primary CLI are being renamed to `impact-gate`.
 - Legacy CLI aliases (`e2e-ai-agents`, `e2e-qa-agent`, `e2e-agents-mcp`) still work during migration.
@@ -26,7 +46,7 @@ Transition note:
 | Level | Commands | What They Are For |
 |------|----------|-------------------|
-| Core CI Workflow | `impact`, `plan`, `gate` | Decide what changed, what is covered, and whether a PR should pass |
+| Core CI Workflow | `impact`, `plan`, `gate` | Decide what changed, what is covered, and whether a PR should pass or a release is ready |
 | Optional AI Workflow | `generate`, `heal`, `analyze`, `finalize-generated-tests` | Suggest, create, or repair tests after impact analysis |
 | Setup and Calibration | `train`, `bootstrap`, `traceability-*`, `feedback`, `cost-report`, `llm-health` | Build the manifest, feed execution data back in, and inspect cost/provider health |
 | Advanced / Experimental | `crew`, MCP mode, plugins, `impact-gate-qa` | Deeper orchestration and browser-driven workflows beyond the core CI loop |
@@ -36,7 +56,7 @@ Transition note:
 - The clearest, most stable workflow is still **Playwright/Cypress impact analysis and gating**.
 - AI generation and healing work best **after** the project has a good `route-families.json` manifest.
 - Advanced features are improving, but they are **not** the best entry point if you only want dependable CI coverage decisions.
-- The Mattermost profile is still the most opinionated path in the codebase. Generic flows are supported, but the package should be judged first on the core CI workflow above.
+- The strict profile is the most opinionated path in the codebase. Most teams should start with the core CI workflow above and only opt into stricter heuristics once their mappings are mature.
 ## Free Tier
@@ -77,7 +97,7 @@ npx impact-gate --help
 Then run the core CI workflow:
 ```bash
-# 1. See what changed
+# 1. See what changed in a PR or branch diff
 npx impact-gate impact --path /path/to/project --since origin/main
 # 2. Build a coverage plan and CI summary artifacts
@@ -87,13 +107,35 @@ npx impact-gate plan --path /path/to/project --since origin/main
 npx impact-gate gate --path /path/to/project --threshold 80
 ```
+Use the same `plan` command for release readiness:
+```bash
+# Compare the current branch or release candidate to the last shipped tag
+npx impact-gate plan --path /path/to/project --since v2.1.0
+```
+That gives you a release-focused test plan showing impacted flows, current coverage, and where you still need tests or validation before shipping.
 Notes:
 - `impact` prints a deterministic summary to stdout.
 - `plan` writes `.e2e-ai-agents/plan.json` and `.e2e-ai-agents/ci-summary.md`.
+- `plan --since <old-release-tag>` is the simplest way to turn a release diff into a prioritized test plan.
 - `gate` expects a threshold in the range `0-100` and exits `1` when the threshold is missed.
 - Add the Optional AI Workflow only after your `route-families.json` manifest is useful enough to trust.
+## Dogfood Proof
+The current repo includes a full dogfood run at [dogfood/2026-03-28/README.md](dogfood/2026-03-28/README.md).
+- [Playwright example](examples/playwright-react/README.md): synthetic auth change -> `impact`, `plan`, and `gate` all behaved as expected
+- [Cypress example](examples/cypress-nextjs/README.md): synthetic dashboard change -> parity proof for the same deterministic flow
+- [Self dogfood](dogfood/2026-03-28/README.md#phase-2-impact-gate-on-itself): heuristic fallback grouped changes truthfully, but still read too optimistically for a package-style repo
+Takeaway:
+- the strongest product path is still an app-shaped Playwright/Cypress repo with a maintained manifest
+- zero-config / heuristic fallback is useful for orientation, but it should not be treated as equally trustworthy for release decisions
 ## Setup and Calibration
 These commands help the core CI workflow become accurate and project-aware.
@@ -135,6 +177,20 @@ npx impact-gate finalize-generated-tests --path /path/to/project --create-pr
 `plan` and `suggest` are aliases. `analyze` is the convenience wrapper when you want the full path in one invocation.
+### How Hallucinations Are Tackled
+The AI path is intentionally constrained instead of trusting raw LLM output.
+- **Deterministic first**: impact analysis, coverage planning, and release-diff planning work without an LLM. The AI layer comes after the diff and coverage evidence are already established.
+- **Local API surface grounding**: generation prompts are built from discovered page objects, helpers, method signatures, and inherited methods from your own repository.
+- **Prompt-level constraints**: the generator is explicitly told to use only known methods and to fall back to raw Playwright selectors when a method is not available.
+- **Prompt sanitization**: flow names, evidence, and user-action strings are sanitized before being injected into prompts.
+- **Hallucination detection gate**: generated code is scanned for method calls that do not exist in the discovered API surface. Suspicious specs are blocked by default instead of being written into the main specs directory.
+- **Needs-review quarantine**: blocked specs are written to `generated-needs-review/` so teams can inspect them manually rather than accidentally trusting them in CI.
+- **Verification after generation**: written specs go through compile checks and smoke-run verification. Failing specs are moved out of the trusted path.
+This is why the strongest product story is still: deterministic diff -> test plan -> optional AI assistance with guardrails.
 ## Advanced / Experimental
 These features are real, but they are not the clearest place to start if your goal is simple CI coverage decisions.
@@ -310,7 +366,7 @@ Create `impact-gate.config.json` in your project (auto-discovered):
 ```json
 {
   "path": ".",
-  "profile": "mattermost",
+  "profile": "strict",
   "testsRoot": ".",
   "mode": "impact",
   "framework": "auto",
@@ -340,14 +396,14 @@ Profiles are not the same thing as frameworks. They control analysis strictness
 | Profile | Description |
 |---------|-------------|
 | `default` | Standard analysis behavior for most repositories |
-| `mattermost` | Mattermost-specific conventions and stricter handling of heuristic-only mappings |
+| `strict` | Stricter handling of heuristic-only mappings and more opinionated analysis defaults |
 Framework detection is separate. The CLI can auto-detect Playwright, Cypress, pytest, supertest, and Selenium usage from the project structure and dependencies.
 ### Key options
 - **`testsRoot`** — path to tests when they live outside the app root
-- **`profile`** — `default` or `mattermost`
+- **`profile`** — `default` or `strict`
 - **`impact.dependencyGraph`** — static reverse dependency graph for transitive impact
 - **`impact.traceability`** — file-to-test mapping from CI execution data
 - **`impact.aiFlow`** — LLM-powered flow mapping through the configured provider
@@ -473,22 +529,27 @@ All written under `<testsRoot>/.e2e-ai-agents/`.
 ## Advanced / Experimental: Autonomous QA Agent (`impact-gate-qa`)
-An autonomous QA engineer that opens a real browser, navigates to changed features, tries edge cases, and produces a findings report — all unsupervised. Built on top of `agent-browser` and the Anthropic tool-use API.
+An autonomous QA engineer that can take a diff or a feature prompt, open a real browser, navigate changed features, hunt edge cases, generate follow-up specs, heal failures, and produce a findings report. Built on top of `agent-browser` and the Anthropic tool-use API.
+If you want the full product story and the natural-language front door, start
+with the [Autonomous Browser QA guide](https://yasserfaraazkhan.github.io/impact-gate/guides/browser-qa/)
+and the [QA Skill Guide](https://yasserfaraazkhan.github.io/impact-gate/guides/qa-skill/)
+for Codex and Claude examples using `/qa`.
 ### Quick Start
 ```bash
 # PR mode — test features changed since origin/main
-npx impact-gate-qa pr --since origin/main --base-url http://localhost:8065
+npx impact-gate-qa pr --since origin/main --base-url http://localhost:3000
 # Hunt mode — deep-test a specific area
-npx impact-gate-qa hunt "channel settings" --base-url http://localhost:8065
+npx impact-gate-qa hunt "settings panel" --base-url http://localhost:3000
 # Release mode — systematic exploration of all critical flows
-npx impact-gate-qa release --base-url http://localhost:8065 --time 30
+npx impact-gate-qa release --base-url http://localhost:3000 --time 30
 # Fix mode — verify healed specs
-npx impact-gate-qa fix --base-url http://localhost:8065
+npx impact-gate-qa fix --base-url http://localhost:3000
 ```
 ### Architecture
@@ -501,7 +562,7 @@ npx impact-gate-qa fix --base-url http://localhost:8065
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--base-url` | `http://localhost:8065` | Application URL |
+| `--base-url` | Required | Application URL |
 | `--time` | `15` | Time limit in minutes |
 | `--budget` | `2.00` | Max LLM spend in USD |
 | `--phase` | `all` | Run only `1`, `2`, or `3` |
@@ -513,7 +574,7 @@ Requires `agent-browser` CLI (`npm install -g agent-browser`) and `ANTHROPIC_API
 ## Production Usage
-The strongest production story today is a repo that maintains a good `route-families.json` manifest and uses the deterministic `impact -> plan -> gate` loop in CI. [Mattermost](https://github.com/mattermost/mattermost) is the most battle-tested public example for coverage gating, generation, and healing. See the [Mattermost Playwright integration](https://github.com/mattermost/mattermost/tree/master/e2e-tests/playwright) for a real-world setup.
+The strongest production story today is a repo that maintains a good `route-families.json` manifest, feeds traceability data back into the plan, and uses the deterministic `impact -> plan -> gate` loop in CI. That evidence-first workflow is the path to trust before layering in optional generation, healing, or autonomous QA.
 ## License

package/dist/agent/config.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agent/config.ts"],"names":[],"mappings":"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~~AA8iBD~~,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,cAAc,CA2L3G"}
1	+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agent/config.ts"],"names":[],"mappings":"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"}

package/dist/agent/config.js CHANGED Viewed

@@ -335,6 +335,9 @@ function normalizeProfile(value) {
     if (value === 'default' || value === 'mattermost') {
         return value;
     }
+    if (value === 'strict') {
+        return 'mattermost';
+    }
     return undefined;
 }
 function normalizeFramework(value) {

package/dist/cli/parse_args.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../src/cli/parse_args.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAK7B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBtE;~~AA6JD~~,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyFpD"}
1	+ {"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../src/cli/parse_args.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAK7B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBtE;AA8JD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyFpD"}

package/dist/cli/parse_args.js CHANGED Viewed

@@ -82,6 +82,7 @@ const FLAGS = {
     '--verbose': { key: 'verbose', type: 'boolean', aliases: ['-v'] },
     '--json': { key: 'jsonOutput', type: 'boolean' },
     '--mattermost': { key: 'profile', type: 'boolean', transform: () => 'mattermost' },
+    '--strict': { key: 'profile', type: 'boolean', transform: () => 'mattermost' },
     // -- string flags --
     '--config': { key: 'configPath', type: 'string' },
     '--path': { key: 'path', type: 'string' },
@@ -131,7 +132,7 @@ const FLAGS = {
     '--pipeline-mcp-timeout-ms': { key: 'pipelineMcpTimeoutMs', type: 'number-raw' },
     '--pipeline-mcp-retries': { key: 'pipelineMcpRetries', type: 'number-raw' },
     // -- enum flags --
-    '--profile': { key: 'profile', type: 'enum', enumValues: ['default', 'mattermost'] },
+    '--profile': { key: 'profile', type: 'enum', enumValues: ['default', 'strict', 'mattermost'], transform: (v) => v === 'strict' ? 'mattermost' : v },
     '--pipeline-browser': { key: 'pipelineBrowser', type: 'enum', enumValues: ['chrome', 'chromium', 'firefox', 'webkit'] },
     '--policy-enforcement-mode': { key: 'policyEnforcementMode', type: 'enum', enumValues: ['advisory', 'warn', 'block'] },
     // -- csv flags --
@@ -244,7 +245,7 @@ function parseArgs(argv) {
             case 'enum':
                 if (next) {
                     if (def.enumValues.includes(next)) {
-                        setField(parsed, def.key, next);
+                        setField(parsed, def.key, def.transform ? def.transform(next) : next);
                     }
                     i += 1;
                 }

package/dist/cli/usage.js CHANGED Viewed

@@ -37,8 +37,8 @@ function printUsage() {
         'Options:',
         '  --config <path>       Path to impact-gate.config.json (auto-discovered if present)',
         '  --path <project-root> Path to the project root (scans both frontend and backend)',
-        '  --profile <name>     default | mattermost',
-        '  --mattermost         Shortcut for --profile mattermost',
+        '  --profile <name>     default | strict',
+        '  --strict             Shortcut for --profile strict',
         '  --tests-root <path>   Path to tests root (optional)',
         '  --framework <name>    auto | playwright | cypress | pytest | supertest | selenium',
         '  --patterns <globs>    Comma-separated test patterns',

package/dist/esm/agent/config.js CHANGED Viewed

@@ -332,6 +332,9 @@ function normalizeProfile(value) {
     if (value === 'default' || value === 'mattermost') {
         return value;
     }
+    if (value === 'strict') {
+        return 'mattermost';
+    }
     return undefined;
 }
 function normalizeFramework(value) {

package/dist/esm/cli/parse_args.js CHANGED Viewed

@@ -76,6 +76,7 @@ const FLAGS = {
     '--verbose': { key: 'verbose', type: 'boolean', aliases: ['-v'] },
     '--json': { key: 'jsonOutput', type: 'boolean' },
     '--mattermost': { key: 'profile', type: 'boolean', transform: () => 'mattermost' },
+    '--strict': { key: 'profile', type: 'boolean', transform: () => 'mattermost' },
     // -- string flags --
     '--config': { key: 'configPath', type: 'string' },
     '--path': { key: 'path', type: 'string' },
@@ -125,7 +126,7 @@ const FLAGS = {
     '--pipeline-mcp-timeout-ms': { key: 'pipelineMcpTimeoutMs', type: 'number-raw' },
     '--pipeline-mcp-retries': { key: 'pipelineMcpRetries', type: 'number-raw' },
     // -- enum flags --
-    '--profile': { key: 'profile', type: 'enum', enumValues: ['default', 'mattermost'] },
+    '--profile': { key: 'profile', type: 'enum', enumValues: ['default', 'strict', 'mattermost'], transform: (v) => v === 'strict' ? 'mattermost' : v },
     '--pipeline-browser': { key: 'pipelineBrowser', type: 'enum', enumValues: ['chrome', 'chromium', 'firefox', 'webkit'] },
     '--policy-enforcement-mode': { key: 'policyEnforcementMode', type: 'enum', enumValues: ['advisory', 'warn', 'block'] },
     // -- csv flags --
@@ -238,7 +239,7 @@ export function parseArgs(argv) {
             case 'enum':
                 if (next) {
                     if (def.enumValues.includes(next)) {
-                        setField(parsed, def.key, next);
+                        setField(parsed, def.key, def.transform ? def.transform(next) : next);
                     }
                     i += 1;
                 }

package/dist/esm/cli/usage.js CHANGED Viewed

@@ -34,8 +34,8 @@ export function printUsage() {
         'Options:',
         '  --config <path>       Path to impact-gate.config.json (auto-discovered if present)',
         '  --path <project-root> Path to the project root (scans both frontend and backend)',
-        '  --profile <name>     default | mattermost',
-        '  --mattermost         Shortcut for --profile mattermost',
+        '  --profile <name>     default | strict',
+        '  --strict             Shortcut for --profile strict',
         '  --tests-root <path>   Path to tests root (optional)',
         '  --framework <name>    auto | playwright | cypress | pytest | supertest | selenium',
         '  --patterns <globs>    Comma-separated test patterns',

package/dist/esm/qa-agent/cli.js CHANGED Viewed

@@ -35,10 +35,10 @@ Options:
   --help                Show this help
 Examples:
-  impact-gate-qa pr --since origin/main --base-url http://localhost:8065
-  impact-gate-qa hunt "channel settings" --base-url http://localhost:8065
-  impact-gate-qa release --base-url http://localhost:8065 --time 30
-  impact-gate-qa fix --base-url http://localhost:8065
+  impact-gate-qa pr --since origin/main --base-url http://localhost:3000
+  impact-gate-qa hunt "settings panel" --base-url http://localhost:3000
+  impact-gate-qa release --base-url http://localhost:3000 --time 30
+  impact-gate-qa fix --base-url http://localhost:3000
 `);
 }
 function parseCliArgs(argv) {

package/dist/qa-agent/cli.js CHANGED Viewed

@@ -37,10 +37,10 @@ Options:
   --help                Show this help
 Examples:
-  impact-gate-qa pr --since origin/main --base-url http://localhost:8065
-  impact-gate-qa hunt "channel settings" --base-url http://localhost:8065
-  impact-gate-qa release --base-url http://localhost:8065 --time 30
-  impact-gate-qa fix --base-url http://localhost:8065
+  impact-gate-qa pr --since origin/main --base-url http://localhost:3000
+  impact-gate-qa hunt "settings panel" --base-url http://localhost:3000
+  impact-gate-qa release --base-url http://localhost:3000 --time 30
+  impact-gate-qa fix --base-url http://localhost:3000
 `);
 }
 function parseCliArgs(argv) {

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@yasserkhanorg/impact-gate",
-  "version": "2.1.5",
-  "description": "Diff-aware E2E impact analysis and coverage gating for Playwright/Cypress teams. Optional AI features can suggest, generate, and heal tests once your project has a route-families.json manifest.",
+  "version": "2.1.7",
+  "description": "Diff-aware E2E impact analysis, release-ready test planning, coverage gating, and hallucination-resistant AI generation for Playwright/Cypress teams.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/index.d.ts",
@@ -62,7 +62,8 @@
     "glob": "^11.0.0",
     "marked": "^15.0.6",
     "minimatch": "^10.2.4",
-    "openai": "^4.73.0"
+    "openai": "^4.73.0",
+    "typescript": "^5.6.0"
   },
   "peerDependencies": {
     "agent-browser": ">=0.18.0"
@@ -73,8 +74,7 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.6.0"
+    "@types/node": "^22.0.0"
   },
   "repository": {
     "type": "git",
@@ -117,7 +117,7 @@
     "node": ">=20.0.0"
   },
   "author": "Yasser Khan",
-  "homepage": "https://github.com/yasserfaraazkhan/impact-gate",
+  "homepage": "https://yasserfaraazkhan.github.io/impact-gate/",
   "bugs": {
     "url": "https://github.com/yasserfaraazkhan/impact-gate/issues"
   },

package/skills/qa/SKILL.md CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 name: qa
 description: |
-  Systematically QA test the Mattermost web application and fix bugs found.
+  Systematically QA test a running web application and fix bugs found.
   Runs autonomous browser exploration, computes health scores, fixes bugs with
   atomic commits, and produces structured reports with before/after evidence.
   Use when asked to "qa", "QA", "test this", "find bugs", "test and fix",
@@ -23,16 +23,23 @@ to systematically test the application, find bugs, fix them, and produce a repor
 ## Step 1: Determine parameters
 Parse the user's request for:
-- **URL**: The base URL to test (default: `http://localhost:8065`)
+- **URL**: The base URL to test. Prefer the app URL the user provided or the
+  currently running local/staging app URL you can discover. If no app URL is
+  available, ask for it instead of assuming a hard-coded local port.
 - **Mode**: `pr` (feature branch, default), `hunt` (specific area), `release` (full regression), `fix` (verify healed tests)
 - **Fix tier**: `quick` (critical+high), `standard` (default, +medium), `exhaustive` (+low)
 - **Regression**: Whether to compare against a previous baseline
 Auto-detect mode:
-- On a feature branch with no URL → `pr` mode
+- On a feature branch with an app URL → `pr` mode
 - User mentions a specific area (e.g., "test channel settings") → `hunt` mode
 - User says "release", "regression", "full test" → `release` mode
+Accept any reachable application URL, for example:
+- `http://localhost:3000`
+- `http://127.0.0.1:5173`
+- `https://staging.example.com`
 ## Step 2: Check prerequisites
 ```bash
@@ -64,16 +71,16 @@ npx impact-gate-qa <mode> \
 Examples:
 ```bash
 # Default: test current branch changes
-npx impact-gate-qa pr --base-url http://localhost:8065
+npx impact-gate-qa pr --base-url <app-url>
 # Hunt mode for a specific area
-npx impact-gate-qa hunt "channel settings" --base-url http://localhost:8065
+npx impact-gate-qa hunt "account settings" --base-url <app-url>
 # Release readiness with regression comparison
-npx impact-gate-qa release --base-url http://localhost:8065 --regression --time 30
+npx impact-gate-qa release --base-url <app-url> --regression --time 30
 # Quick smoke test, no fixes
-npx impact-gate-qa pr --base-url http://localhost:8065 --fix-tier quick --no-fix
+npx impact-gate-qa pr --base-url <app-url> --fix-tier quick --no-fix
 ```
 ## Step 4: Read and display the report