form-tester 0.3.5 → 0.4.1

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,10 +9,23 @@ allowed-tools: Bash(powershell:*), Bash(playwright-cli:*), Bash(npx form-tester:
 ## Quick start
 
 ```bash
-npx form-tester install   # one-time setup
-npx form-tester           # run the 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):
+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.
+
 ## Commands
 
 ```bash
@@ -37,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

@@ -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.5";
+const LOCAL_VERSION = "0.4.1";
 const RECOMMENDED_PERSON = "Uromantisk Direktør";
 
 const PERSONAS = [
@@ -878,6 +878,91 @@ async function handleTest(url, config) {
   );
 }
 
+async function handleTestAuto(url, config, flags) {
+  // Resolve PNR
+  const pnr = flags.pnr || config.pnr;
+  if (!pnr) {
+    console.error("No PNR available. Pass --pnr <value> or set it in form-tester.config.json");
+    process.exit(1);
+  }
+  const fullUrl = extractPnrFromUrl(url) ? url : setPnrOnUrl(url, pnr);
+  config.pnr = pnr;
+  saveConfig(config);
+
+  // Resolve persona
+  let personaChoice;
+  const personaId = flags.persona;
+  if (personaId) {
+    const found = getPersonaById(personaId);
+    if (found) {
+      console.log(`Persona: ${found.name} — ${found.description}`);
+      personaChoice = { type: "preset", persona: found };
+    } else {
+      console.log(`Unknown persona "${personaId}", using Noen.`);
+      personaChoice = { type: "noen", persona: null };
+    }
+  } else {
+    console.log("Persona: Noen — nøytrale svar (auto)");
+    personaChoice = { type: "noen", persona: null };
+  }
+
+  // Resolve scenario
+  const scenarioChoice = flags.scenario
+    ? { type: "custom", description: flags.scenario }
+    : { type: "default", description: "Standard test" };
+  console.log(`Scenario: ${scenarioChoice.description}`);
+
+  // Create output directory
+  const formId = sanitizeSegment(extractFormId(fullUrl));
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const outputDir = path.join(OUTPUT_BASE, formId, timestamp);
+  fs.mkdirSync(outputDir, { recursive: true });
+
+  config.lastTestUrl = fullUrl;
+  config.lastRunDir = outputDir;
+  saveConfig(config);
+
+  // Save persona and scenario
+  if (personaChoice.type === "preset") {
+    fs.writeFileSync(path.join(outputDir, "persona.json"), JSON.stringify(personaChoice.persona, null, 2));
+  } else {
+    fs.writeFileSync(path.join(outputDir, "persona.json"), JSON.stringify(
+      { id: "noen", name: "Noen", description: "Nøytrale svar", traits: {} }, null, 2,
+    ));
+  }
+  fs.writeFileSync(path.join(outputDir, "scenario.json"), JSON.stringify(scenarioChoice, null, 2));
+
+  // Open and snapshot
+  console.log("Opening form with Playwright CLI...");
+  await runPlaywrightCli(["open", fullUrl]);
+  await runPlaywrightCli(["snapshot", "--filename", path.join(outputDir, "page_open.yml")]);
+  await runPlaywrightCli(["screenshot", "--filename", path.join(outputDir, "page_open.png")]);
+
+  // Auto-select person (try recommended, then first available)
+  let options = extractPersonsFromSnapshotFile(path.join(outputDir, "page_open.yml"));
+  if (!options.length) {
+    for (let attempt = 0; attempt < 3; attempt++) {
+      await sleep(1500);
+      options = await fetchPersonOptions();
+      if (options.length) break;
+    }
+  }
+  if (options.length) {
+    options = prioritizeRecommended(options, RECOMMENDED_PERSON);
+    const chosen = options[0];
+    console.log(`Auto-selected person: ${chosen}`);
+    config.lastPerson = chosen;
+    saveConfig(config);
+  }
+
+  const dokumenterUrl = resolveDokumenterUrl(config);
+  console.log(`Output folder: ${outputDir}`);
+  if (dokumenterUrl) {
+    console.log(`Dokumenter URL: ${dokumenterUrl}`);
+  }
+  printNextSteps(outputDir, dokumenterUrl || "/dokumenter?pnr={PNR}");
+}
+
 async function handleCommand(line, config) {
   const trimmed = line.trim();
   if (!trimmed) return;
@@ -1008,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() {
@@ -1031,6 +1116,20 @@ async function main() {
     process.exit(0);
   }
 
+  if (args[0] === "test" && args.includes("--auto")) {
+    const config = loadConfig();
+    const url = args.find((a) => a.startsWith("http"));
+    if (!url) {
+      console.error("Usage: form-tester test <url> --auto [--pnr <pnr>] [--persona <id>] [--scenario <text>]");
+      process.exit(1);
+    }
+    const pnrFlag = args[args.indexOf("--pnr") + 1];
+    const personaFlag = args[args.indexOf("--persona") + 1];
+    const scenarioFlag = args[args.indexOf("--scenario") + 1];
+    await handleTestAuto(url, config, { pnr: pnrFlag, persona: personaFlag, scenario: scenarioFlag });
+    process.exit(0);
+  }
+
   const config = loadConfig();
   await handleVersionMismatch(config);
 

package/package.json

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