form-tester 0.3.1 → 0.3.2

package/.claude/skills/form-tester/INSTRUCTIONS.md

@@ -0,0 +1,59 @@
+# Form Tester Skill Instructions
+
+Setup (run once):
+```
+npx form-tester install
+```
+
+Run the CLI:
+```
+npx form-tester
+```
+
+Commands:
+```
+/setup
+/update
+/version
+/people
+/test {url}
+/save {label}
+/clear
+/quit
+```
+
+Notes:
+- New users: place this skill under .claude/skills/form-tester/ in your repo, then run /skills to scan/reload (or /restart).
+- Provide a full /skjemautfyller URL. If `pnr` is missing, the CLI will prompt.
+- The CLI opens the form with Playwright CLI, saves an initial snapshot + screenshot, and prints next-step commands.
+- Use `/save {label}` to capture additional snapshots + screenshots into the same output folder.
+- Use `/update` after changing the skill to update Playwright CLI + skills, then reload the skill in Copilot CLI with `/skills` (reload) or `/restart`.
+- Use `/people` to rescan the visible person list and get a numbered selection prompt.
+- Use the next-step checklist printed by the CLI (cookies, person selection, validation fix, Dokumenter verification, save HTML/PDF).
+- If the error modal appears on save or submit ("Det skjedde en feil under innsending av skjema. Prøv igjen senere."), open DevTools -> Network before retrying. Then try resubmitting once. If it persists, find the failed request and capture the Correlation ID header in test_results.txt.
+- Use `--help` or `-h` to print the command list without starting the prompt.
+- Playwright CLI commands are available from this skill when needed.
+- IMPORTANT: All screenshots taken during a test run MUST use `--full-page` to capture the entire page, not just the viewport. This applies to every screenshot command: `playwright-cli screenshot --filename "..." --full-page`
+
+Test flow (when /test is triggered):
+IMPORTANT: Each prompt below MUST be asked as a separate message to the user. Wait for the user's response before proceeding to the next step. Do NOT combine multiple prompts into one message.
+
+1. Prompt for PNR (if not in URL). Wait for response.
+2. Prompt for persona (1-6 selection). Show the numbered list and wait for the user's response.
+3. Prompt for test scenario in a NEW separate message. Ask: "Any specific test scenario? (describe what to test, or Enter for standard clean test)". Wait for the user's response. If the user says nothing specific or "default" or just presses Enter, use standard test. The scenario is saved to scenario.json in the output directory.
+4. Only after receiving answers to all prompts: open browser, fill form, submit, verify.
+
+Post-submit verification:
+After a successful submission, read the modal text carefully:
+- If it says the form is stored in Dokumenter (e.g. "En kopi er også lagret i Dokumenter" or "Skjemaet er fullført og lagret i Dokumenter"), proceed with Dokumenter verification below.
+- If the modal does NOT mention Dokumenter, or says the form will not be stored/you will not get a response, skip Dokumenter verification entirely. Record this in test_results.txt.
+
+Dokumenter verification (only when modal confirms storage):
+1. Navigate to `/dokumenter?pnr={PNR}` and select the same person used during form fill.
+2. The document list loads sorted newest first. The first entry should match the form title.
+3. Click "Se detaljer" on the first document, then click "Åpne dokumentet".
+4. If the document opens in a new tab as HTML: switch to that tab, take a full-page screenshot (`--full-page`), save snapshot and raw HTML.
+5. If the document opens as a PDF viewer: download the PDF instead of screenshotting. Use `playwright-cli pdf --filename "$OUTPUT_DIR/document.pdf"` or save it via the download.
+6. If the document does NOT open (XML format, no new tab, or other): note the document type in test_results.txt and skip the screenshot/download.
+7. Include the document verification results in test_results.txt (document title, whether it matched the form h1, document type: HTML/PDF/XML).
+

package/.claude/skills/form-tester/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: form-tester
+description: Runs the form-tester CLI to test /skjemautfyller forms via Playwright CLI and exposes playwright-cli commands.
+allowed-tools: Bash(powershell:*), Bash(playwright-cli:*)
+---
+
+# Form Tester CLI
+
+## Quick start
+
+```bash
+npx form-tester install   # one-time setup
+npx form-tester           # run the CLI
+```
+
+## Commands
+
+```bash
+/setup
+/update
+/version
+/people
+/test {url}
+/save {label}
+/clear
+/quit
+```
+
+The CLI expects a single form URL. If `pnr` is missing, it will prompt for it.
+
+Use `--help` or `-h` to print the command list without starting the prompt.
+
+Run `/update` when you change the skill to update Playwright CLI + skills, and then reload the skill in Copilot CLI with `/skills` (reload) or `/restart`.
+
+Use `/people` to rescan the visible person list and get a numbered selection prompt.
+
+## Playwright CLI
+
+You can also run `playwright-cli` commands directly when needed.
+

package/.github/copilot-instructions.md

@@ -0,0 +1,67 @@
+# Form Tester — Copilot Instructions
+
+You have access to a form-testing CLI tool (`form-tester.js`) that automates testing of /skjemautfyller forms using Playwright CLI.
+
+## Setup
+
+```bash
+npx form-tester install
+```
+
+## Running the CLI
+
+```bash
+# macOS/Linux
+node form-tester.js
+
+# Windows (PowerShell)
+node .\form-tester.js
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/setup` | Initial setup |
+| `/update` | Update Playwright CLI + skills |
+| `/version` | Show version |
+| `/people` | Rescan visible person list |
+| `/test {url}` | Test a form URL |
+| `/save {label}` | Save snapshot + screenshot |
+| `/clear` | Clear session |
+| `/quit` | Exit CLI |
+
+## Playwright CLI
+
+You can also use `playwright-cli` commands directly for browser automation:
+
+```bash
+playwright-cli open https://example.com
+playwright-cli snapshot
+playwright-cli fill e1 "value"
+playwright-cli click e3
+playwright-cli screenshot --filename=page.png --full-page
+playwright-cli close
+```
+
+## Test Flow
+
+When `/test` is triggered:
+
+1. Prompt for PNR if not in URL. Wait for response.
+2. Prompt for persona (numbered selection). Wait for response.
+3. Prompt for test scenario in a separate message. Wait for response.
+4. Only after all prompts answered: open browser, fill form, submit, verify.
+
+## Important Notes
+
+- Provide a full /skjemautfyller URL. If `pnr` is missing, the CLI will prompt.
+- All screenshots MUST use `--full-page` to capture the entire page.
+- Use `/save {label}` to capture additional snapshots into the output folder.
+- If an error modal appears on submit, open DevTools → Network, retry once, and capture the Correlation ID header.
+
+## Post-Submit Verification
+
+After submission, read the modal text:
+- If it mentions Dokumenter storage → navigate to `/dokumenter?pnr={PNR}`, verify the document appears, and capture it (screenshot for HTML, download for PDF).
+- If it does NOT mention Dokumenter → skip verification, note in test_results.txt.

package/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+  push:
+    branches: [master]
+    paths:
+      - 'package.json'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/form-tester.js

@@ -6,7 +6,7 @@ const { spawn, execSync } = require("child_process");
 
 const CONFIG_PATH = path.join(__dirname, "form-tester.config.json");
 const OUTPUT_BASE = path.resolve(__dirname, "output");
-const LOCAL_VERSION = "0.3.1";
+const LOCAL_VERSION = "0.3.2";
 const RECOMMENDED_PERSON = "Uromantisk Direktør";
 
 const PERSONAS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "form-tester",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "AI-powered form testing skill for /skjemautfyller forms using Playwright CLI. Works with Claude Code and GitHub Copilot.",
   "main": "form-tester.js",
   "bin": {