form-tester 0.10.3 → 0.11.1

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

@@ -5,9 +5,10 @@ Install (user runs once):
 npm install -g form-tester
 ```
 
-Install skill files:
+Install skill files and configure:
 ```
 form-tester install
+form-tester init          # set baseUrl, pnr, person, etc.
 ```
 
 Test modes:
@@ -71,10 +72,13 @@ IMPORTANT: Each prompt below MUST be asked as a separate message to the user. Wa
 4. Only after receiving answers to all prompts, proceed with the steps below.
 
 Step 1 — Open and setup:
-If the user gives a partial URL (e.g. `skjemautfyller/SLV-PasRapp-2020`), read `form-tester.config.json` to get `baseUrl` and `pnr`. Construct the full URL as `{baseUrl}/{path}?pnr={pnr}`. Do NOT guess the domain.
+You can pass a full URL, a path, or just the form name. The CLI resolves it using `baseUrl` and `skjemaUrl` from config:
 ```
-form-tester test <full-url> --auto --pnr <pnr> --persona <id> --scenario "<text>"
+form-tester test SLV-PasRapp-2020 --auto                    # just form name
+form-tester test skjemautfyller/SLV-PasRapp-2020 --auto     # path
+form-tester test https://example.com/skjemautfyller/X --auto # full URL
 ```
+To check resolution: `form-tester url SLV-PasRapp-2020`
 
 Step 2 — Dismiss cookies:
 ```

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

@@ -16,13 +16,17 @@ npm install -g form-tester
 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"
+# Non-interactive mode — accepts form name, path, or full URL:
+form-tester test SLV-PasRapp-2020 --auto
+form-tester test SLV-PasRapp-2020 --auto --pnr 12345 --persona ung-mann
+form-tester test https://example.com/skjemautfyller/FORM --auto
 
 # Human mode (user picks persona and scenario):
-form-tester test <url> --human                                          # lists personas, ask user
-form-tester test <url> --human --persona ung-mann --scenario "test X"   # run with user's choices
+form-tester test SLV-PasRapp-2020 --human                                  # lists personas
+form-tester test SLV-PasRapp-2020 --human --persona ung-mann --scenario "X" # with choices
+
+# Check URL resolution:
+form-tester url SLV-PasRapp-2020
 
 # Full interactive CLI:
 form-tester

package/.github/copilot-instructions.md

@@ -8,6 +8,7 @@ User must install globally first:
 ```bash
 npm install -g form-tester
 form-tester install
+form-tester init          # set baseUrl, pnr, person, etc.
 ```
 
 ## Running a test
@@ -16,16 +17,15 @@ When the user gives you a form URL to test, execute ALL steps below in sequence
 
 ### Step 1 — Start the test
 
-If the user gives a partial URL (e.g. `skjemautfyller/SLV-PasRapp-2020`), read `form-tester.config.json` first to get `baseUrl` and `pnr`. Construct the full URL as `{baseUrl}/{partial-path}?pnr={pnr}`. Do NOT guess the domain — always use `baseUrl` from config.
-
-```bash
-form-tester test <full-url> --auto
-```
-Or with options:
+You can pass a full URL, a path, or just the form name. The CLI resolves it using `baseUrl` and `skjemaUrl` from config:
 ```bash
-form-tester test <full-url> --auto --pnr 12345 --persona ung-mann --scenario "test validation"
+form-tester test SLV-PasRapp-2020 --auto                    # just form name
+form-tester test skjemautfyller/SLV-PasRapp-2020 --auto     # path
+form-tester test https://example.com/skjemautfyller/X --auto # full URL
 ```
 
+To check how a form name resolves: `form-tester url SLV-PasRapp-2020`
+
 ### Step 2 — Dismiss cookies
 ```bash
 form-tester cookies

package/form-tester.config.example.json

@@ -1,5 +1,7 @@
 {
   "pnr": "YOUR_PNR_HERE",
   "person": "",
-  "baseUrl": ""
+  "baseUrl": "",
+  "skjemaUrl": "/skjemautfyller",
+  "dokumenterUrlTemplate": "/dokumenter?pnr={PNR}"
 }

package/form-tester.js

@@ -7,7 +7,7 @@ const { spawn, execSync } = require("child_process");
 const CONFIG_PATH = path.join(process.cwd(), "form-tester.config.json");
 const OUTPUT_BASE = path.resolve(process.cwd(), "output");
 const ISSUES_PATH = path.join(OUTPUT_BASE, "issues.jsonl");
-const LOCAL_VERSION = "0.10.3";
+const LOCAL_VERSION = "0.11.1";
 const RECOMMENDED_PERSON = "Uromantisk Direktør";
 
 // Recording — persisted to disk so `form-tester exec` can append across processes
@@ -659,6 +659,7 @@ const DEFAULT_CONFIG = {
   pnr: "",
   person: "",
   baseUrl: "",
+  skjemaUrl: "/skjemautfyller",
   dokumenterUrlTemplate: "/dokumenter?pnr={PNR}",
   lastTestUrl: "",
   lastRunDir: "",
@@ -694,6 +695,20 @@ function resolveDokumenterUrl(config) {
   return url;
 }
 
+function resolveFormUrl(input, config) {
+  // If it's already a full URL, return as-is
+  if (input.startsWith("http://") || input.startsWith("https://")) return input;
+  const base = config.baseUrl || "";
+  // If it's a path like /skjemautfyller/FORM-ID or skjemautfyller/FORM-ID
+  if (input.includes("/")) {
+    const path = input.startsWith("/") ? input : `/${input}`;
+    return `${base}${path}`;
+  }
+  // It's just a form name like SLV-PasRapp-2020
+  const skjema = config.skjemaUrl || "/skjemautfyller";
+  return `${base}${skjema}/${input}`;
+}
+
 function extractPnrFromUrl(url) {
   try {
     const parsed = new URL(url);
@@ -921,9 +936,11 @@ function printHelp() {
     [
       "",
       "Subcommands (run directly):",
+      "  form-tester init                         Set up config (baseUrl, pnr, person, etc.)",
       "  form-tester install [--global]          Install skill files into project or ~/.claude/skills/",
-      "  form-tester test <url> --auto           Non-interactive test (for AI agents)",
-      "  form-tester test <url> --human          Interactive test with prompts",
+      "  form-tester test <name-or-url> --auto    Non-interactive test (for AI agents)",
+      "  form-tester test <name-or-url> --human  Interactive test with prompts",
+      "  form-tester url <name-or-path>           Resolve form name/path to full URL",
       "  form-tester exec <command> [args]       Run playwright-cli command (recorded)",
       "  form-tester replay <recording.json>     Replay a recorded test run",
       "  form-tester cookies                      Dismiss cookie banner",
@@ -1720,6 +1737,51 @@ function install(targetDir, isGlobal) {
 async function main() {
   const args = process.argv.slice(2);
 
+  if (args[0] === "init") {
+    const config = loadConfig();
+    console.log("Form Tester Setup\n");
+    console.log("Current config:");
+    console.log(`  baseUrl:       ${config.baseUrl || "(not set)"}`);
+    console.log(`  pnr:           ${config.pnr || "(not set)"}`);
+    console.log(`  person:        ${config.person || "(not set)"}`);
+    console.log(`  skjemaUrl:     ${config.skjemaUrl || "/skjemautfyller"}`);
+    console.log(`  dokumenterUrl: ${config.dokumenterUrlTemplate || "/dokumenter?pnr={PNR}"}`);
+    console.log("");
+
+    const currentRl = ensureReadline();
+
+    const prompt = (question, current) => new Promise((resolve) => {
+      const suffix = current ? ` [${current}]` : "";
+      currentRl.question(`${question}${suffix}: `, (answer) => {
+        resolve(answer.trim() || current || "");
+      });
+    });
+
+    config.baseUrl = await prompt("Base URL (e.g. https://tjenester-a-vak-sprak.int-hn.nhn.no)", config.baseUrl);
+    config.pnr = await prompt("PNR (fødselsnummer for test)", config.pnr);
+    config.person = await prompt("Default person name (e.g. Uromantisk Direktør)", config.person);
+    config.skjemaUrl = await prompt("Skjema path prefix", config.skjemaUrl || "/skjemautfyller");
+    config.dokumenterUrlTemplate = await prompt("Dokumenter URL template", config.dokumenterUrlTemplate || "/dokumenter?pnr={PNR}");
+
+    saveConfig(config);
+    currentRl.close();
+
+    console.log("\nConfig saved to form-tester.config.json:");
+    console.log(`  baseUrl:       ${config.baseUrl}`);
+    console.log(`  pnr:           ${config.pnr}`);
+    console.log(`  person:        ${config.person}`);
+    console.log(`  skjemaUrl:     ${config.skjemaUrl}`);
+    console.log(`  dokumenterUrl: ${config.dokumenterUrlTemplate}`);
+
+    // Test URL resolution
+    console.log(`\nTest: form-tester test SLV-PasRapp-2020 --auto`);
+    const testUrl = resolveFormUrl("SLV-PasRapp-2020", config);
+    const withPnr = config.pnr && !extractPnrFromUrl(testUrl) ? setPnrOnUrl(testUrl, config.pnr) : testUrl;
+    console.log(`  → ${withPnr}`);
+
+    process.exit(0);
+  }
+
   if (args[0] === "install") {
     const isGlobal = args.includes("--global") || args.includes("-g");
     const remaining = args.slice(1).filter((a) => a !== "--global" && a !== "-g");
@@ -1824,6 +1886,34 @@ async function main() {
     process.exit(code);
   }
 
+  if (args[0] === "url") {
+    const config = loadConfig();
+    const input = args.slice(1).join(" ");
+    if (!input) {
+      console.error("Usage: form-tester url <form-name-or-path>");
+      console.error("\nExamples:");
+      console.error("  form-tester url SLV-PasRapp-2020");
+      console.error("  form-tester url skjemautfyller/SLV-PasRapp-2020");
+      console.error("  form-tester url https://example.com/skjemautfyller/FORM");
+      console.error(`\nConfig: baseUrl=${config.baseUrl || "(not set)"}, skjemaUrl=${config.skjemaUrl || "/skjemautfyller"}, pnr=${config.pnr || "(not set)"}`);
+      console.error("\nRun 'form-tester init' to configure.");
+      process.exit(1);
+    }
+    let formUrl = resolveFormUrl(input, config);
+    if (config.pnr && !extractPnrFromUrl(formUrl)) {
+      formUrl = setPnrOnUrl(formUrl, config.pnr);
+    }
+    // Also resolve dokumenter URL
+    const tmpConfig = { ...config, lastTestUrl: formUrl };
+    const dokUrl = resolveDokumenterUrl(tmpConfig);
+
+    console.log(`Form URL:       ${formUrl}`);
+    console.log(`Dokumenter URL: ${dokUrl || "(not available — set pnr)"}`);
+    console.log(`Person:         ${config.person || "(not set)"}`);
+    console.log(`\nRun: form-tester test ${input} --auto`);
+    process.exit(0);
+  }
+
   if (args[0] === "cookies") {
     const code = await handleCookies();
     process.exit(code);
@@ -1844,12 +1934,13 @@ async function main() {
 
   if (args[0] === "test" && args.includes("--human")) {
     const config = loadConfig();
-    const url = args.find((a) => a.startsWith("http"));
+    const flagVal = (flag) => args.includes(flag) ? args[args.indexOf(flag) + 1] : undefined;
+    const rawUrl = args.find((a) => a !== "test" && !a.startsWith("--") && a !== flagVal("--persona") && a !== flagVal("--scenario") && a !== flagVal("--pnr"));
+    const url = rawUrl ? resolveFormUrl(rawUrl, config) : null;
     if (!url) {
-      console.error("Usage: form-tester test <url> --human --persona <id> --scenario \"<text>\"");
+      console.error("Usage: form-tester test <form-name-or-url> --human --persona <id> --scenario \"<text>\"");
       process.exit(1);
     }
-    const flagVal = (flag) => args.includes(flag) ? args[args.indexOf(flag) + 1] : undefined;
     const personaFlag = flagVal("--persona");
     const scenarioFlag = flagVal("--scenario");
 
@@ -1876,12 +1967,13 @@ async function main() {
 
   if (args[0] === "test" && args.includes("--auto")) {
     const config = loadConfig();
-    const url = args.find((a) => a.startsWith("http"));
+    const flagVal = (flag) => args.includes(flag) ? args[args.indexOf(flag) + 1] : undefined;
+    const rawUrl = args.find((a) => a !== "test" && !a.startsWith("--") && a !== flagVal("--persona") && a !== flagVal("--scenario") && a !== flagVal("--pnr"));
+    const url = rawUrl ? resolveFormUrl(rawUrl, config) : null;
     if (!url) {
-      console.error("Usage: form-tester test <url> --auto [--pnr <pnr>] [--persona <id>] [--scenario <text>] [--silent|--verbose]");
+      console.error("Usage: form-tester test <form-name-or-url> --auto [--pnr <pnr>] [--persona <id>] [--scenario <text>] [--silent|--verbose]");
       process.exit(1);
     }
-    const flagVal = (flag) => args.includes(flag) ? args[args.indexOf(flag) + 1] : undefined;
     const verbosity = args.includes("--silent") ? "silent" : args.includes("--verbose") ? "verbose" : "normal";
     await handleTestAuto(url, config, {
       pnr: flagVal("--pnr"),
@@ -1941,6 +2033,7 @@ module.exports = {
   finalizeRecording,
   logIssue,
   listIssues,
+  resolveFormUrl,
   ISSUE_CATEGORIES,
 };
 

package/package.json

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