norn-cli 4.1.0 → 4.2.0

package/README.md

@@ -79,18 +79,20 @@ For a hosted agent workflow, select one sequence and supply its runtime inputs e
 ```bash
 norn run ./workflows/ticket.norn \
   --sequence HandleTicket \
-  --param jiraTicket=NORN-482 \
+  --param NORN-482 \
   --param-json context=./inputs/ticket-context.json \
   --recording ./artifacts/ticket-run.json \
   --json
 ```
 
-`--param name=value` is repeatable and preserves the value as a string.
-`--param-json name=file.json` is also repeatable; it parses the file and assigns its typed JSON
-value directly to the declared sequence parameter. CLI values override authored defaults. Both
-forms require one file plus `--sequence`, reject undeclared or missing required parameters before
-execution, and cannot be combined with `@data`/`@theory` cases. `--recording` writes the normal
-secret-masked agent recording to an exact artifact path instead of the rolling local cache.
+`--param [name=]value` is repeatable and preserves the value as a string.
+`--param-json [name=]file.json` is also repeatable; it parses the file and assigns its typed JSON
+value directly to the declared sequence parameter. Unnamed values follow declaration order and
+skip parameters supplied by name, so named and positional inputs can be mixed. CLI values override
+authored defaults. Both forms require one file plus `--sequence`, reject undeclared or missing
+required parameters before execution, and cannot be combined with `@data`/`@theory` cases.
+`--recording` writes the normal secret-masked agent recording to an exact artifact path instead of
+the rolling local cache.
 
 Ordinary sequence runs handle `SIGINT` and `SIGTERM` as graceful cancellation requests. A repeated
 signal forces exit; cancelled processes use status 130 (`SIGINT`) or 143 (`SIGTERM`).

package/dist/cli.js

@@ -212996,11 +212996,19 @@ var PARAMETER_NAME = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
 function parseCliSequenceParameterAssignment(authored2, source) {
   const flag = source === "json" ? "--param-json" : "--param";
   if (authored2 === void 0) {
-    throw new Error(`${flag} requires <name>=${source === "json" ? "<file.json>" : "<value>"}.`);
+    throw new Error(
+      `${flag} requires ${source === "json" ? "<file.json>" : "<value>"} or <name>=${source === "json" ? "<file.json>" : "<value>"}.`
+    );
   }
   const separator = authored2.indexOf("=");
-  if (separator < 1) {
-    throw new Error(`${flag} requires <name>=${source === "json" ? "<file.json>" : "<value>"}.`);
+  if (separator < 0) {
+    if (source === "json" && authored2.trim().length === 0) {
+      throw new Error("--param-json requires a non-empty .json file path.");
+    }
+    return { source, value: authored2 };
+  }
+  if (separator === 0) {
+    throw new Error(`${flag} requires a parameter name before '='.`);
   }
   const name = authored2.slice(0, separator).trim();
   const value = authored2.slice(separator + 1);
@@ -213014,9 +213022,10 @@ function parseCliSequenceParameterAssignment(authored2, source) {
 }
 function loadJsonParameter(assignment, cwd) {
   const filePath = path41.resolve(cwd, assignment.value);
+  const parameterLabel = assignment.name ? ` '${assignment.name}'` : "";
   if (path41.extname(filePath).toLowerCase() !== ".json") {
     throw new Error(
-      `JSON parameter '${assignment.name}' must reference a .json file: ${assignment.value}`
+      `JSON parameter${parameterLabel} must reference a .json file: ${assignment.value}`
     );
   }
   let content;
@@ -213024,14 +213033,14 @@ function loadJsonParameter(assignment, cwd) {
     content = fs35.readFileSync(filePath, "utf8");
   } catch (error2) {
     throw new Error(
-      `Could not read JSON parameter '${assignment.name}' from '${filePath}': ${error2 instanceof Error ? error2.message : String(error2)}`
+      `Could not read JSON parameter${parameterLabel} from '${filePath}': ${error2 instanceof Error ? error2.message : String(error2)}`
     );
   }
   try {
     return JSON.parse(content.replace(/^\uFEFF/, ""));
   } catch (error2) {
     throw new Error(
-      `Could not parse JSON parameter '${assignment.name}' from '${filePath}': ${error2 instanceof Error ? error2.message : String(error2)}`
+      `Could not parse JSON parameter${parameterLabel} from '${filePath}': ${error2 instanceof Error ? error2.message : String(error2)}`
     );
   }
 }
@@ -213044,7 +213053,10 @@ function resolveCliSequenceParameters(declarations, assignments, cwd = process.c
     }
   }
   const supplied = /* @__PURE__ */ new Set();
-  for (const assignment of assignments) {
+  const namedAssignments = assignments.filter(
+    (assignment) => assignment.name !== void 0
+  );
+  for (const assignment of namedAssignments) {
     if (!declaredByName.has(assignment.name)) {
       const available = declarations.map((parameter) => parameter.name).join(", ") || "none";
       throw new Error(
@@ -213057,6 +213069,19 @@ function resolveCliSequenceParameters(declarations, assignments, cwd = process.c
     supplied.add(assignment.name);
     resolved[assignment.name] = assignment.source === "json" ? loadJsonParameter(assignment, cwd) : assignment.value;
   }
+  const positionalAssignments = assignments.filter((assignment) => assignment.name === void 0);
+  const availableDeclarations = declarations.filter((parameter) => !supplied.has(parameter.name));
+  if (positionalAssignments.length > availableDeclarations.length) {
+    throw new Error(
+      `Too many positional sequence parameters: received ${positionalAssignments.length}, but only ${availableDeclarations.length} parameter${availableDeclarations.length === 1 ? "" : "s"} remain.`
+    );
+  }
+  for (let index = 0; index < positionalAssignments.length; index++) {
+    const assignment = positionalAssignments[index];
+    const parameter = availableDeclarations[index];
+    supplied.add(parameter.name);
+    resolved[parameter.name] = assignment.source === "json" ? loadJsonParameter({ ...assignment, name: parameter.name }, cwd) : assignment.value;
+  }
   const missing = declarations.filter((parameter) => parameter.defaultValue === void 0 && !supplied.has(parameter.name)).map((parameter) => parameter.name);
   if (missing.length > 0) {
     throw new Error(
@@ -213505,7 +213530,8 @@ function parseArgs(args) {
     refactorRegionPattern: false,
     writeRefactor: false,
     yes: false,
-    sequenceParameters: []
+    sequenceParameters: [],
+    unexpectedPositionals: []
   };
   for (let i2 = 0; i2 < args.length; i2++) {
     const arg = args[i2];
@@ -213587,7 +213613,11 @@ function parseArgs(args) {
       printHelp();
       process.exit(0);
     } else if (!arg.startsWith("-")) {
-      options.file = arg;
+      if (options.file) {
+        options.unexpectedPositionals.push(arg);
+      } else {
+        options.file = arg;
+      }
     }
   }
   return options;
@@ -213609,9 +213639,11 @@ Options:
   -s, --sequence <name>  Run a specific sequence by name (single file only)
   -r, --request <name>   Run a specific named request (single file only)
   -e, --env <name>       Use environment from .nornenv (e.g., dev, prod)
-  --param <name>=<value> Supply a string parameter to --sequence (repeatable)
-  --param-json <name>=<file.json>
+  --param [<name>=]<value>
+                          Supply a string parameter to --sequence (repeatable)
+  --param-json [<name>=]<file.json>
                           Parse a JSON file into a --sequence parameter (repeatable)
+                          Unnamed parameters follow sequence declaration order
   --recording <file.json>
                           Write the agent recording to an exact artifact path
   -t, --timeout <time>   Request timeout override (e.g. 180s, 3m, 300000ms; default: norn.config.json or 30s)
@@ -213631,6 +213663,7 @@ Options:
   --refactor-region-pattern
                           Refactor a flat .nornenv STAGE_REGION matrix to templates
   --write                 Apply --refactor-region-pattern instead of printing result
+  -V, --version          Show the installed Norn CLI version
   -h, --help             Show this help message
 
 Report Generation:
@@ -213665,7 +213698,7 @@ Examples:
   norn tests/                               # Run all tests in directory (recursive)
   norn tests/Regression/ -e prelive         # Run regression suite with environment
   norn api-tests.norn -s auth               # Run 'auth' sequence by name
-  norn agent-flow.norn -s HandleTicket --param jiraTicket=NORN-482
+  norn agent-flow.norn -s HandleTicket --param NORN-482
   norn agent-flow.norn -s HandleTicket --param-json context=./ticket.json
   norn agent-flow.norn -s HandleTicket --recording ./artifacts/run.json
   norn api-tests.norn -r LoginRequest       # Run 'LoginRequest' named request
@@ -214016,11 +214049,22 @@ async function main() {
     process.exit(exitCode);
   }
   const args = rawArgs[0] === "run" ? rawArgs.slice(1) : rawArgs;
+  if (args.length === 1 && (args[0] === "--version" || args[0] === "-V")) {
+    console.log(`Norn CLI ${"4.2.0"}`);
+    return;
+  }
   if (args.length === 0) {
     printHelp();
     process.exit(1);
   }
   const options = parseArgs(args);
+  if (options.unexpectedPositionals.length > 0) {
+    const unexpected = options.unexpectedPositionals[0];
+    console.error(
+      `Error: Unexpected positional argument '${unexpected}'. To pass a sequence value, use --param ${unexpected} or --param name=${unexpected}.`
+    );
+    process.exit(1);
+  }
   if (options.contracts) {
     setContractModeOverride(true);
   }

package/package.json

@@ -2,7 +2,7 @@
   "name": "norn-cli",
   "displayName": "Norn",
   "description": "Version-controlled API and database tests. Author in VS Code, then run the same files from the CLI and CI.",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "publisher": "Norn-PeterKrustanov",
   "author": {
     "name": "Peter Krastanov"
@@ -578,11 +578,6 @@
           },
           "description": "Workspace-relative glob patterns for .norn files or folders to hide from the Norn Test Explorer. Useful for negative fixtures, live-only tests, or documentation demos."
         },
-        "norn.terminal.focusMode": {
-          "type": "boolean",
-          "default": true,
-          "description": "Close the primary Side Bar and bottom Panel when opening the Norn terminal."
-        },
         "norn.terminal.intelliSense.selectFirstSuggestion": {
           "type": "boolean",
           "default": false,