form-tester 0.4.0 → 0.4.2

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

@@ -1,13 +1,24 @@
 # Form Tester Skill Instructions
 
-Setup (run once):
+Install (user runs once):
 ```
-npx form-tester install
+npm install -g form-tester
+```
+
+Install skill files:
+```
+form-tester install
 ```
 
 Run the CLI:
 ```
-npx form-tester
+form-tester
+```
+
+Non-interactive mode (best for AI agents):
+```
+form-tester test <url> --auto
+form-tester test <url> --auto --pnr 12345 --persona ung-mann
 ```
 
 Commands:
@@ -23,7 +34,7 @@ Commands:
 ```
 
 Notes:
-- New users: place this skill under .claude/skills/form-tester/ in your repo, then run /skills to scan/reload (or /restart).
+- New users: run `npm install -g form-tester` then `form-tester install` in your project.
 - 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.
@@ -56,4 +67,3 @@ Dokumenter verification (only when modal confirms storage):
 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

@@ -1,7 +1,7 @@
 ---
 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:*), Bash(npx form-tester:*)
+allowed-tools: Bash(powershell:*), Bash(playwright-cli:*), Bash(form-tester:*)
 ---
 
 # Form Tester CLI
@@ -9,12 +9,19 @@ allowed-tools: Bash(powershell:*), Bash(playwright-cli:*), Bash(npx form-tester:
 ## Quick start
 
 ```bash
-npx form-tester install   # one-time setup
-npx form-tester           # interactive CLI
+# One-time install (user runs this manually):
+npm install -g form-tester
+
+# Install skill files into project:
+form-tester install
+form-tester install --global   # or install to ~/.claude/skills/
 
 # Non-interactive mode (no prompts, best for AI agents):
-npx form-tester test <url> --auto
-npx form-tester test <url> --auto --pnr 12345 --persona ung-mann --scenario "test validation"
+form-tester test <url> --auto
+form-tester test <url> --auto --pnr 12345 --persona ung-mann --scenario "test validation"
+
+# Interactive CLI:
+form-tester
 ```
 
 Persona IDs: `ung-mann`, `gravid-kvinne`, `eldre-kvinne`, `kronisk-syk-mann`. Defaults to "noen" (neutral answers) if omitted.
@@ -43,4 +50,3 @@ Use `/people` to rescan the visible person list and get a numbered selection pro
 ## Playwright CLI
 
 You can also run `playwright-cli` commands directly when needed.
-

package/.github/copilot-instructions.md

@@ -1,23 +1,28 @@
 # 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.
+You have access to a form-testing CLI tool (`form-tester`) that automates testing of /skjemautfyller forms using Playwright CLI.
 
 ## Setup
 
+User must install globally first:
 ```bash
-npx form-tester install
+npm install -g form-tester
+form-tester install
 ```
 
 ## Running the CLI
 
 ```bash
-# macOS/Linux
-node form-tester.js
+# Interactive
+form-tester
 
-# Windows (PowerShell)
-node .\form-tester.js
+# Non-interactive (best for AI agents)
+form-tester test <url> --auto
+form-tester test <url> --auto --pnr 12345 --persona ung-mann --scenario "test validation"
 ```
 
+Persona IDs: `ung-mann`, `gravid-kvinne`, `eldre-kvinne`, `kronisk-syk-mann`. Defaults to "noen" if omitted.
+
 ## Commands
 
 | Command | Description |
@@ -58,10 +63,10 @@ When `/test` is triggered:
 - 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.
+- 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.
+- 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/README.md

@@ -2,23 +2,25 @@
 
 AI-powered testing skill for `/skjemautfyller` forms using [Playwright CLI](https://www.npmjs.com/package/@playwright/cli). Works with **Claude Code** and **GitHub Copilot**.
 
-## Quick Install
+## Install
 
 ```bash
-npx form-tester install
+npm install -g form-tester
 ```
 
-This installs skill files into your project:
+Then in your project:
+
+```bash
+form-tester install            # project-level (commits to repo)
+form-tester install --global   # personal (~/.claude/skills/)
+```
+
+This installs:
 - `.claude/skills/form-tester/` — Claude Code skill
 - `.claude/skills/playwright-cli/` — Playwright CLI skill
 - `.github/copilot-instructions.md` — GitHub Copilot instructions
 - `form-tester.config.example.json` — Config template
-
-## Prerequisites
-
-- Node.js 18+
-
-Playwright CLI is included as a dependency — no separate install needed.
+- `playwright-cli` globally (if not already installed)
 
 ## Configuration
 
@@ -30,27 +32,30 @@ Edit `form-tester.config.json` and set your `pnr`.
 
 ## Usage
 
-### Claude Code
-
-The skill is automatically detected when you open the project in Claude Code. Use the `/form-tester` skill or run:
+### Non-interactive (recommended for AI agents)
 
 ```bash
-npx form-tester
+form-tester test <url> --auto
+form-tester test <url> --auto --pnr 12345 --persona ung-mann --scenario "test validation"
 ```
 
-### GitHub Copilot
-
-Copilot reads instructions from `.github/copilot-instructions.md` automatically. Open the project in VS Code with Copilot enabled.
+Persona IDs: `ung-mann`, `gravid-kvinne`, `eldre-kvinne`, `kronisk-syk-mann`
 
-### Standalone CLI
+### Interactive CLI
 
 ```bash
-npx form-tester
+form-tester
 ```
 
 Commands: `/setup`, `/update`, `/version`, `/people`, `/test {url}`, `/save {label}`, `/clear`, `/quit`
 
-Use `--help` for the full command list.
+### Claude Code
+
+The skill is automatically detected when you open the project. Use the `/form-tester` skill.
+
+### GitHub Copilot
+
+Copilot reads instructions from `.github/copilot-instructions.md` automatically.
 
 ## Test Output
 
@@ -59,6 +64,12 @@ Test runs are saved to `output/{form-id}/{timestamp}/` with:
 - Screenshots (PNG, full-page)
 - `test_results.txt`
 
+## Update
+
+```bash
+npm update -g form-tester
+```
+
 ## Development
 
 ```bash

package/form-tester.js

@@ -4,9 +4,9 @@ const path = require("path");
 const readline = require("readline");
 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.4.0";
+const CONFIG_PATH = path.join(process.cwd(), "form-tester.config.json");
+const OUTPUT_BASE = path.resolve(process.cwd(), "output");
+const LOCAL_VERSION = "0.4.2";
 const RECOMMENDED_PERSON = "Uromantisk Direktør";
 
 const PERSONAS = [
@@ -1093,7 +1093,7 @@ function install(targetDir, isGlobal) {
   console.log("\nDone! Next steps:");
   console.log("  1. cp form-tester.config.example.json form-tester.config.json");
   console.log('  2. Edit form-tester.config.json and set your "pnr"');
-  console.log("  3. Run: npx form-tester");
+  console.log("  3. Run: form-tester");
 }
 
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "form-tester",
-  "version": "0.4.0",
+  "version": "0.4.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": {