norn-cli 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to the "Norn" extension will be documented in this file.
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-05-09
+
+### Added
+- **Starter Catalogue (VS Code)**:
+  - Added a Project Setup starter catalogue in the sidebar with a Back button and readable stacked sample titles/descriptions.
+  - Added Explorer folder context-menu parity for opening the same starter catalogue.
+  - Added self-contained generated starter folders for simple requests, scripts plus JSON data, a runnable SQL demo, a real SQL connection starter, and an advanced end-to-end flow with `.nornenv`, `.nornapi`, helper sequences, tests, and schema contracts.
+
+### Fixed
+- **Environment Template Diagnostics (VS Code)**:
+  - Allowed `.nornenv` variables such as `{{primaryUserId}}` and `{{postTitle}}` in assertion and condition expression contexts when those values are intentionally resolved from the environment file.
+  - Kept the bare-variable diagnostic for local, file, and sequence variables so runtime values are still read directly in expressions.
+
+- **Sequence Argument Resolution (Extension + CLI)**:
+  - Resolved bare variable paths such as `user.id` and array-indexed paths such as `todosResponse.body[0]` before binding `run SomeSequence(...)` parameters.
+  - Fixed advanced schema-validation flows where unresolved literal argument text could produce empty responses and misleading `matchesSchema` object errors.
+
+### Changed
+- **Website Docs and Skills**:
+  - Updated website VS Code docs for the starter catalogue, self-contained samples, SQL starter split, advanced flow, and Explorer context-menu behavior.
+  - Added starter-catalog maintenance guidance and updated value-resolution guidance for sequence argument binding.
+
 ## [2.1.0] - 2026-05-08
 
 ### Improved

package/dist/cli.js

@@ -109772,6 +109772,10 @@ function findUnquotedPipe(str) {
 }
 function resolveValue(expr, responses, variables, getValueByPath2, responseIndexToVariable) {
   const trimmed = expr.trim();
+  const wrappedResponseRefMatch = trimmed.match(/^\{\{(\$\d+(?:\..+)?)\}\}$/);
+  if (wrappedResponseRefMatch) {
+    return resolveValue(wrappedResponseRefMatch[1], responses, variables, getValueByPath2, responseIndexToVariable);
+  }
   const refMatch = trimmed.match(/^\$(\d+)\.(.+)$/);
   if (refMatch) {
     const responseIdx = parseInt(refMatch[1], 10);
@@ -109872,7 +109876,7 @@ function resolveValue(expr, responses, variables, getValueByPath2, responseIndex
     return { value: void 0, error: `Variable {{${varName}}} is not defined` };
   }
   if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
-    return { value: decodeQuotedStringLiteral(trimmed) };
+    return { value: substituteVariables(decodeQuotedStringLiteral(trimmed), variables) };
   }
   if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
     return { value: parseFloat(trimmed) };
@@ -109945,6 +109949,8 @@ function areValuesEqual(leftValue, rightValue) {
 }
 function evaluateAssertion(assertion, responses, variables, getValueByPath2, responseIndexToVariable, basePath) {
   const leftResult = resolveValue(assertion.leftExpr, responses, variables, getValueByPath2, responseIndexToVariable);
+  const message = assertion.message === void 0 ? void 0 : substituteVariables(assertion.message, variables);
+  const expression = formatExpression(assertion, variables);
   const buildFailureContext = () => ({
     responseIndex: leftResult.responseIndex,
     friendlyName: leftResult.variableName,
@@ -109954,8 +109960,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
   if (leftResult.error) {
     return {
       passed: false,
-      expression: formatExpression(assertion),
-      message: assertion.message,
+      expression,
+      message,
       operator: assertion.operator,
       leftValue: void 0,
       leftExpression: assertion.leftExpr,
@@ -109969,8 +109975,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
     const passed2 = leftValue !== void 0 && leftValue !== null;
     return {
       passed: passed2,
-      expression: formatExpression(assertion),
-      message: assertion.message,
+      expression,
+      message,
       operator: assertion.operator,
       leftValue,
       leftExpression: assertion.leftExpr,
@@ -109981,8 +109987,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
     const passed2 = leftValue === void 0 || leftValue === null;
     return {
       passed: passed2,
-      expression: formatExpression(assertion),
-      message: assertion.message,
+      expression,
+      message,
       operator: assertion.operator,
       leftValue,
       leftExpression: assertion.leftExpr,
@@ -109992,8 +109998,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
   if (!assertion.rightExpr) {
     return {
       passed: false,
-      expression: formatExpression(assertion),
-      message: assertion.message,
+      expression,
+      message,
       operator: assertion.operator,
       leftValue,
       leftExpression: assertion.leftExpr,
@@ -110014,8 +110020,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
     const passed2 = actualType === expectedType;
     return {
       passed: passed2,
-      expression: formatExpression(assertion),
-      message: assertion.message,
+      expression,
+      message,
       operator: assertion.operator,
       leftValue,
       rightValue: expectedType,
@@ -110029,12 +110035,13 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
     if (schemaPath.startsWith('"') && schemaPath.endsWith('"') || schemaPath.startsWith("'") && schemaPath.endsWith("'")) {
       schemaPath = schemaPath.slice(1, -1);
     }
+    schemaPath = substituteVariables(schemaPath, variables);
     const validationResult = validateAgainstSchemaDetailed(leftValue, schemaPath, basePath);
     const passed2 = validationResult.valid;
     return {
       passed: passed2,
-      expression: formatExpression(assertion),
-      message: assertion.message,
+      expression,
+      message,
       operator: assertion.operator,
       leftValue,
       rightValue: schemaPath,
@@ -110052,8 +110059,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
   if (rightResult.error) {
     return {
       passed: false,
-      expression: formatExpression(assertion),
-      message: assertion.message,
+      expression,
+      message,
       operator: assertion.operator,
       leftValue,
       rightValue: void 0,
@@ -110107,8 +110114,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
       } catch (e) {
         return {
           passed: false,
-          expression: formatExpression(assertion),
-          message: assertion.message,
+          expression,
+          message,
           operator: assertion.operator,
           leftValue,
           rightValue,
@@ -110122,8 +110129,8 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
   }
   return {
     passed,
-    expression: formatExpression(assertion),
-    message: assertion.message,
+    expression,
+    message,
     operator: assertion.operator,
     leftValue,
     rightValue,
@@ -110132,11 +110139,14 @@ function evaluateAssertion(assertion, responses, variables, getValueByPath2, res
     ...!passed ? buildFailureContext() : {}
   };
 }
-function formatExpression(assertion) {
+function formatExpression(assertion, variables) {
   if (assertion.rightExpr) {
-    return `${assertion.leftExpr} ${assertion.operator} ${assertion.rightExpr}`;
+    return substituteAssertionDisplayTemplates(`${assertion.leftExpr} ${assertion.operator} ${assertion.rightExpr}`, variables);
   }
-  return `${assertion.leftExpr} ${assertion.operator}`;
+  return substituteAssertionDisplayTemplates(`${assertion.leftExpr} ${assertion.operator}`, variables);
+}
+function substituteAssertionDisplayTemplates(expression, variables) {
+  return variables ? substituteVariables(expression, variables) : expression;
 }
 
 // src/jsonFileReader.ts
@@ -128371,13 +128381,7 @@ function bindSequenceArguments(params, args, runtimeVariables) {
       if (boundParams.has(arg.name)) {
         return { error: `Parameter "${arg.name}" provided multiple times` };
       }
-      let value = arg.value;
-      if (value.startsWith("{{") && value.endsWith("}}")) {
-        const varName = value.slice(2, -2);
-        value = getVariableValueByPath(varName, runtimeVariables);
-      } else if (runtimeVariables[value] !== void 0) {
-        value = runtimeVariables[value];
-      }
+      const value = resolveSequenceArgumentValue(arg.value, runtimeVariables);
       result[arg.name] = value;
       boundParams.add(arg.name);
     } else {
@@ -128388,13 +128392,7 @@ function bindSequenceArguments(params, args, runtimeVariables) {
         return { error: `Too many arguments: expected ${params.length}, got more` };
       }
       const param = params[positionalIndex];
-      let value = arg.value;
-      if (value.startsWith("{{") && value.endsWith("}}")) {
-        const varName = value.slice(2, -2);
-        value = getVariableValueByPath(varName, runtimeVariables);
-      } else if (runtimeVariables[value] !== void 0) {
-        value = runtimeVariables[value];
-      }
+      const value = resolveSequenceArgumentValue(arg.value, runtimeVariables);
       result[param.name] = value;
       boundParams.add(param.name);
       positionalIndex++;
@@ -128441,6 +128439,20 @@ function getVariableValueByPath(path20, variables) {
   }
   return current;
 }
+function resolveSequenceArgumentValue(value, runtimeVariables) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith("{{") && trimmed.endsWith("}}")) {
+    return getVariableValueByPath(trimmed.slice(2, -2).trim(), runtimeVariables);
+  }
+  if (trimmed in runtimeVariables) {
+    return runtimeVariables[trimmed];
+  }
+  const pathMatch2 = trimmed.match(/^([a-zA-Z_][a-zA-Z0-9_]*)((?:\.[a-zA-Z_][a-zA-Z0-9_]*|\[\d+\])+)$/);
+  if (pathMatch2 && pathMatch2[1] in runtimeVariables) {
+    return getVariableValueByPath(trimmed, runtimeVariables);
+  }
+  return value;
+}
 function createPrintStepResult(stepIndex, stepStartTime, sequenceStartTime, title, body) {
   const now = Date.now();
   return {
@@ -129590,7 +129602,7 @@ async function runSequenceWithJar(sequenceContent, fileVariables, cookieJar, wor
           continue;
         }
         if (step.type === "assertion") {
-          const parsed = parseAssertCommand(substituteVariables(step.content, runtimeVariables));
+          const parsed = parseAssertCommand(step.content);
           if (!parsed) {
             const invalidAssertMessage = `Step ${stepIdx + 1}: Invalid assert command: ${step.content}`;
             errors.push(invalidAssertMessage);

package/package.json

@@ -2,7 +2,7 @@
   "name": "norn-cli",
   "displayName": "Norn - REST Client",
   "description": "A powerful REST client for making HTTP requests with sequences, variables, scripts, and cookie support",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "publisher": "Norn-PeterKrustanov",
   "author": {
     "name": "Peter Krastanov"
@@ -48,6 +48,7 @@
     "onView:norn.sidebarHome",
     "onCommand:norn.importPostmanCollection",
     "onCommand:norn.importPostmanEnvironment",
+    "onCommand:norn.createStarterCatalog",
     "onCommand:norn.createSqlStarterFiles",
     "onCommand:norn.createMcpStarterConfig",
     "onCommand:norn.debugSequence",
@@ -107,8 +108,8 @@
         "category": "Norn"
       },
       {
-        "command": "norn.createSqlStarterFiles",
-        "title": "Create SQL Starter Files",
+        "command": "norn.createStarterCatalog",
+        "title": "Open Norn Starter Catalogue",
         "category": "Norn"
       },
       {
@@ -168,7 +169,7 @@
     "menus": {
       "explorer/context": [
         {
-          "command": "norn.createSqlStarterFiles",
+          "command": "norn.createStarterCatalog",
           "when": "explorerResourceIsFolder",
           "group": "norn@1"
         },