openspec-playwright 0.1.49 → 0.1.51

package/.claude/skills/openspec-e2e/SKILL.md

@@ -78,11 +78,19 @@ This validates: app server reachable, auth fixtures initialized, Playwright work
 
 **Before writing test plan, explore the app to collect real DOM data.** This is the most critical step — it eliminates blind selector guessing.
 
-**Prerequisites**: seed test pass. If auth is required, ensure `auth.setup.ts` has been run (Step 7).
+**Prerequisites**: seed test pass. If auth is required, ensure `auth.setup.ts` has been run (Step 7). BASE_URL must be verified reachable (see 4.1).
 
-#### 4.1. Read app-knowledge.md + Extract routes from specs
+#### 4.1. Verify BASE_URL + Read app-knowledge.md + Extract routes from specs
 
-**First**, read `tests/playwright/app-knowledge.md` to understand:
+**First, verify BASE_URL is reachable**:
+```javascript
+await browser_navigate(`${BASE_URL}/`)
+// Confirm page loaded → proceed
+// If error → check BASE_URL in seed.spec.ts or vite.config.ts
+```
+A correct BASE_URL prevents wasted exploration time on unreachable routes.
+
+**Then**, read `tests/playwright/app-knowledge.md` to understand:
 - **Known risks**: SPA behavior, dynamic content patterns, auth method
 - **Project conventions**: preferred selector strategy, credential format, BASE_URL
 
@@ -119,6 +127,18 @@ await browser_navigate(`${BASE_URL}/<route>`)
 // Option C: use browser_run_code to set auth cookies directly
 ```
 
+**If credentials are not yet available**:
+1. **Skip protected routes** — mark them as "⚠️ auth needed — explore after auth.setup.ts"
+2. **Explore the login page itself** (it's a guest route) — extract form selectors for later auth.setup.ts
+3. Document login page structure: input names, button text, form action, error patterns
+
+**Auth setup flow**:
+1. Run exploration → discover login page selectors (Step 4)
+2. Customize auth.setup.ts with discovered selectors
+3. Set E2E_USERNAME/E2E_PASSWORD
+4. Run `npx playwright test --project=setup`
+5. Re-run exploration for protected routes
+
 Wait for page stability after navigation:
 - Prefer waiting for a specific element: `browser_wait_for` with text or selector
 - Avoid `networkidle` / `load` — they are too slow or unreliable
@@ -195,7 +215,7 @@ BASE_URL: <from env or seed.spec.ts>
 |-----------|-----------|
 | Route 404 | Mark as "⚠️ route not found — verify URL in specs" |
 | Network error | Mark as "⚠️ unreachable — check if server is running" |
-| Auth required, no storageState | Skip protected routes → note which routes need auth |
+| Auth required, no credentials | Skip routes + explore login page → document selectors → set up auth first | See 4.2 "If credentials are not yet available" |
 | SPA routing (URL changes but page doesn't reload) | Explore via navigation clicks from known routes, not direct URLs |
 | Page loads but no interactive elements | Try waiting longer for SPA hydration |
 | Dynamic content (user-specific) | Record structure, not content — use `toContainText`, not `toHaveText` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspec-playwright",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "description": "OpenSpec + Playwright E2E verification setup tool for Claude Code",
   "type": "module",
   "bin": {

package/release-notes.md

@@ -1,5 +1,5 @@
 ## What's Changed
 
-- docs: update README and Chinese README with app-knowledge and new pipeline
+- fix(SKILL): add BASE_URL smoke check before exploration (Step 4.1)
 
-**Full Changelog**: https://github.com/wxhou/openspec-playwright/releases/tag/v0.1.49
+**Full Changelog**: https://github.com/wxhou/openspec-playwright/releases/tag/v0.1.51