norn-cli 2.6.0 → 2.7.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "norn-cli",
-  "displayName": "Norn — API Tests in Your Repo",
-  "description": "Version-controlled API tests your team can keep. Author and debug HTTP sequences in VS Code, then run the same files in CI.",
-  "version": "2.6.0",
+  "displayName": "Norn — Tests and Runbooks in Your Repo",
+  "description": "Version-controlled API, database, and Kubernetes tests and runbooks. Author in VS Code, then run the same files from the CLI and CI.",
+  "version": "2.7.0",
   "publisher": "Norn-PeterKrustanov",
   "author": {
     "name": "Peter Krastanov"
@@ -29,7 +29,10 @@
     "api automation",
     "openapi",
     "http",
-    "test automation"
+    "test automation",
+    "kubernetes",
+    "kubectl",
+    "runbooks"
   ],
   "engines": {
     "vscode": "^1.108.1"
@@ -44,6 +47,7 @@
     "onLanguage:nornsql",
     "onLanguage:nornapi",
     "onLanguage:nornenv",
+    "onLanguage:nornk8s",
     "workspaceContains:**/norn.config.json",
     "onChatParticipant:norn.chat",
     "onView:norn.sidebarHome",
@@ -52,6 +56,7 @@
     "onCommand:norn.createStarterCatalog",
     "onCommand:norn.createSqlStarterFiles",
     "onCommand:norn.createMcpStarterConfig",
+    "onCommand:norn.openTerminal",
     "onCommand:norn.debugSequence",
     "onDebugResolve:norn"
   ],
@@ -88,6 +93,26 @@
         "title": "Select Environment",
         "category": "Norn"
       },
+      {
+        "command": "norn.k8s.runLine",
+        "title": "Run Kubernetes Command",
+        "category": "Norn"
+      },
+      {
+        "command": "norn.k8s.runSequence",
+        "title": "Run Kubernetes Sequence",
+        "category": "Norn"
+      },
+      {
+        "command": "norn.k8s.selectContext",
+        "title": "Select Kubernetes Context",
+        "category": "Norn"
+      },
+      {
+        "command": "norn.openTerminal",
+        "title": "Open Terminal",
+        "category": "Norn"
+      },
       {
         "command": "norn.nornenv.activate",
         "title": "Activate Norn Environment",
@@ -260,6 +285,21 @@
           "dark": "./images/nornapi-icon.svg"
         },
         "configuration": "./language-configuration.json"
+      },
+      {
+        "id": "nornk8s",
+        "aliases": [
+          "Norn Kubernetes",
+          "nornk8s"
+        ],
+        "extensions": [
+          ".nornk8s"
+        ],
+        "icon": {
+          "light": "./images/nornk8s-icon.svg",
+          "dark": "./images/nornk8s-icon.svg"
+        },
+        "configuration": "./language-configuration.json"
       }
     ],
     "grammars": [
@@ -285,6 +325,11 @@
         "language": "nornapi",
         "scopeName": "source.nornapi",
         "path": "./syntaxes/nornapi.tmLanguage.json"
+      },
+      {
+        "language": "nornk8s",
+        "scopeName": "source.nornk8s",
+        "path": "./syntaxes/nornk8s.tmLanguage.json"
       }
     ],
     "jsonValidation": [
@@ -363,8 +408,8 @@
     "keybindings": [
       {
         "command": "norn.sendRequest",
-        "key": "ctr+alt+r",
-        "mac": "ctr+alt+r",
+        "key": "ctrl+alt+r",
+        "mac": "ctrl+alt+r",
         "when": "editorLangId == norn"
       },
       {
@@ -372,14 +417,19 @@
         "key": "enter",
         "mac": "enter",
         "when": "editorTextFocus && editorLangId == nornenv && !suggestWidgetVisible"
+      },
+      {
+        "command": "norn.openTerminal",
+        "key": "ctrl+alt+n",
+        "mac": "cmd+alt+n"
       }
     ],
     "chatParticipants": [
       {
         "id": "norn.chat",
         "name": "norn",
-        "fullName": "Norn REST Client",
-        "description": "Ask questions about Norn syntax, generate requests, explain sequences, and convert cURL/HTTP to Norn",
+        "fullName": "Norn",
+        "description": "Ask questions about Norn syntax, generate requests and runbooks, explain sequences, and convert cURL/HTTP to Norn",
         "isSticky": true,
         "commands": [
           {
@@ -398,7 +448,7 @@
         "disambiguation": [
           {
             "category": "norn",
-            "description": "The user wants help writing, understanding, or debugging Norn REST client files (.norn, .nornapi, .nornenv).",
+            "description": "The user wants help writing, understanding, or debugging Norn files (.norn, .nornapi, .nornsql, .nornk8s, .nornenv).",
             "examples": [
               "How do I write an assertion in Norn?",
               "Generate a POST request with JSON body",
@@ -433,6 +483,16 @@
             "type": "string"
           },
           "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,
+          "description": "Select the first Norn terminal IntelliSense suggestion automatically. When disabled, Enter runs exactly what was typed until a suggestion is explicitly selected."
         }
       }
     },
@@ -470,7 +530,7 @@
     "lint": "eslint src",
     "validate:skills": "node ./scripts/validate-skills.mjs",
     "test": "vscode-test",
-    "test:regression": "node ./dist/cli.js ./tests/Regression/ -e prelive",
+    "test:regression": "node ./tests/test-scripts/run-regression.js",
     "test:prerelease": "npm test && npm run test:regression",
     "publish:npm": "node -e \"const fs=require('fs');const p=require('./package.json');p.name='norn-cli';fs.writeFileSync('package.json',JSON.stringify(p,null,2)+'\\n')\" && npm publish; exit_code=$?; node -e \"const fs=require('fs');const p=require('./package.json');p.name='norn';fs.writeFileSync('package.json',JSON.stringify(p,null,2)+'\\n')\"; exit $exit_code",
     "publish:vsce": "node -e \"const p=require('./package.json');p.name='norn';require('fs').writeFileSync('package.json',JSON.stringify(p,null,2))\" && npx vsce publish",

package/AGENTS.md

@@ -1,95 +0,0 @@
-# Norn Extension - Copilot Instructions
-
-These instructions apply to all conversations about the Norn VS Code extension.
-
-## Repo Boundary
-
-These instructions apply only inside `/Users/petercrest/Worktable/Projects/vsApi`.
-
-- Do **not** apply them to standalone work in sibling repos such as `/Users/petercrest/Worktable/Projects/norn_website`.
-- If a task is website-only, prefer the website repo's local instructions instead.
-- Only use these rules for cross-repo work when the task explicitly includes `vsApi`.
-
-## CLI Support is Mandatory
-
-Every feature implementation must work in both:
-1. **VS Code Extension** - Interactive UI with response panel
-2. **CLI** (`src/cli.ts`) - Command-line execution
-
-Before considering any feature complete, verify it works in the CLI. The CLI shares code with the extension (`parser.ts`, `sequenceRunner.ts`, `assertionRunner.ts`, `httpClient.ts`).
-
-### CRITICAL: Running the Local CLI
-
-**NEVER use `npx norn`** - this runs the globally installed npm package, NOT your local changes!
-
-**ALWAYS use the local compiled CLI:**
-```bash
-# Correct - runs your local development version
-node ./dist/cli.js tests/file.norn --env prelive
-
-# WRONG - runs the published npm package, ignores your changes
-npx norn tests/file.norn
-```
-
-Before testing CLI changes:
-1. Run `npm run compile` to build the latest code
-2. Use `node ./dist/cli.js` to execute
-
-## Skills Maintenance
-
-When implementing features, check the `.github/skills/` directory for relevant skills:
-
-- **If a skill is incorrect or outdated:** Update it with the correct information
-- **If a skill is missing:** Create a new one following the Agent Skills format
-- After creating or editing skills, run `npm run validate:skills`
-
-Skills should capture lessons learned and patterns discovered during implementation to help future development.
-
-## Code Style
-
-- TypeScript with strict typing
-- Simple IntelliSense completions (no complex snippets)
-- Keep parsing logic in dedicated functions
-- Test both extension and CLI after changes
-
-## Test Verification
-
-**MANDATORY:** When the user asks to publish, prepare a release, bump version, or create a patch:
-1. **FIRST** invoke the Test Verification subagent using `runSubagent`
-2. Wait for it to complete and report results
-3. Only if all tests pass, invoke the Website Documentation Review subagent using `runSubagent`
-4. Only proceed if tests pass and the docs review reports either:
-   - website docs were updated and the website build passed, or
-   - no docs changes were needed because the release is only bug fixes, refactors, or design/styling work
-
-The Test Verification agent runs:
-- `npm test` (must pass compile/lint, Extension Host editor diagnostics, Test Explorer support, and runtime-negative automation)
-- `npm run test:regression` (local CLI Regression suite; all tests must pass)
-
-The Website Documentation Review agent:
-- reviews release changes in `/Users/petercrest/Worktable/Projects/vsApi`
-- updates `/Users/petercrest/Worktable/Projects/norn_website` when user-facing features changed or new ones were added
-- skips docs work for bug fixes, refactors, internal cleanup, and design/styling-only changes
-
-**Trigger words:** publish, release, version, patch, bump, deploy
-
-## Publishing Ownership
-
-When release verification and version prep are complete, **do not run publishing commands** (`npm run publish:npm`, `npm run publish:vsce`, `npm run publish:all`).
-
-The **user runs publish commands manually**.
-
-## Key Files
-
-| Purpose | File |
-|---------|------|
-| Syntax highlighting | `syntaxes/norn.tmLanguage.json` |
-| IntelliSense | `src/completionProvider.ts` |
-| Sequence execution | `src/sequenceRunner.ts` |
-| Assertions | `src/assertionRunner.ts` |
-| HTTP requests | `src/httpClient.ts` |
-| CLI | `src/cli.ts` |
-| Parser | `src/parser.ts` |
-| Response panel | `src/responsePanel.ts` |
-| Diagnostics | `src/diagnosticProvider.ts` |
-| Test Explorer | `src/testProvider.ts` |

package/demos/tests-showcase/scripts/fake-sql-adapter.js

@@ -1,70 +0,0 @@
-const chunks = [];
-
-process.stdin.on('data', chunk => {
-  chunks.push(chunk);
-});
-
-process.stdin.on('end', () => {
-  try {
-    const request = JSON.parse(Buffer.concat(chunks).toString('utf8'));
-    const values = request.connection && request.connection.values ? request.connection.values : {};
-
-    if (!values.server || !values.database || !values.user || !values.password) {
-      process.stdout.write(JSON.stringify({
-        success: false,
-        error: 'Missing expected buyerDemoDb connection values'
-      }));
-      process.exit(0);
-      return;
-    }
-
-    switch (request.operation.name) {
-      case 'ListBuyerAccounts': {
-        const segment = request.params.segment;
-        process.stdout.write(JSON.stringify({
-          success: true,
-          result: {
-            kind: 'rows',
-            rowCount: 2,
-            rows: [
-              {
-                Id: 1,
-                Company: 'Northwind Retail',
-                Email: 'northwind@example.com',
-                Segment: segment
-              },
-              {
-                Id: 2,
-                Company: 'Contoso Services',
-                Email: 'contoso@example.com',
-                Segment: segment
-              }
-            ]
-          }
-        }));
-        return;
-      }
-
-      case 'RecordDemoRun':
-        process.stdout.write(JSON.stringify({
-          success: true,
-          result: {
-            kind: 'exec',
-            affectedRows: 1
-          }
-        }));
-        return;
-
-      default:
-        process.stdout.write(JSON.stringify({
-          success: false,
-          error: `Unknown buyer showcase SQL operation: ${request.operation.name}`
-        }));
-    }
-  } catch (error) {
-    process.stdout.write(JSON.stringify({
-      success: false,
-      error: error instanceof Error ? error.message : String(error)
-    }));
-  }
-});

package/scripts/generate-coding-bed.mjs

@@ -1,243 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'node:fs';
-import path from 'node:path';
-
-const args = process.argv.slice(2);
-
-function getArg(flag, fallback) {
-  const index = args.indexOf(flag);
-  if (index === -1 || index === args.length - 1) {
-    return fallback;
-  }
-  return args[index + 1];
-}
-
-const seconds = Number(getArg('--seconds', '10'));
-const outPath = path.resolve(getArg('--out', 'audio/norn-coding-bed-test.wav'));
-const sampleRate = 44100;
-const bpm = 122;
-const beatLength = 60 / bpm;
-const barLength = beatLength * 4;
-const totalSamples = Math.floor(seconds * sampleRate);
-const left = new Float32Array(totalSamples);
-const right = new Float32Array(totalSamples);
-
-const progression = [
-  { root: 45, chord: [57, 60, 64], accent: [69, 72, 76] }, // Am
-  { root: 41, chord: [53, 57, 60], accent: [65, 69, 72] }, // F
-  { root: 36, chord: [48, 52, 55], accent: [64, 67, 72] }, // C
-  { root: 43, chord: [55, 59, 62], accent: [67, 71, 74] }, // G
-  { root: 45, chord: [57, 60, 64], accent: [69, 72, 76] }, // Am
-];
-
-let noiseSeed = 0x12345678;
-
-function nextNoise() {
-  noiseSeed = (1664525 * noiseSeed + 1013904223) >>> 0;
-  return (noiseSeed / 0xffffffff) * 2 - 1;
-}
-
-function midiToHz(note) {
-  return 440 * Math.pow(2, (note - 69) / 12);
-}
-
-function clamp(value) {
-  return Math.max(-1, Math.min(1, value));
-}
-
-function softClip(value) {
-  return Math.tanh(value * 1.4);
-}
-
-function oscSine(freq, time) {
-  return Math.sin(2 * Math.PI * freq * time);
-}
-
-function oscTri(freq, time) {
-  return (2 / Math.PI) * Math.asin(Math.sin(2 * Math.PI * freq * time));
-}
-
-function oscSaw(freq, time) {
-  const phase = freq * time;
-  return 2 * (phase - Math.floor(phase + 0.5));
-}
-
-function expEnv(timeSince, decay) {
-  return timeSince < 0 ? 0 : Math.exp(-timeSince * decay);
-}
-
-function kickAt(timeSince) {
-  if (timeSince < 0 || timeSince > 0.24) {
-    return 0;
-  }
-
-  const pitch = 132 - 78 * Math.min(timeSince / 0.08, 1);
-  const body = oscSine(pitch, timeSince) * expEnv(timeSince, 17);
-  const click = oscTri(1900, timeSince) * expEnv(timeSince, 95) * 0.18;
-  return body * 0.95 + click;
-}
-
-function snareAt(timeSince) {
-  if (timeSince < 0 || timeSince > 0.22) {
-    return 0;
-  }
-
-  const noise = nextNoise() * expEnv(timeSince, 22);
-  const body = oscSine(198, timeSince) * expEnv(timeSince, 28) * 0.22;
-  return noise * 0.34 + body;
-}
-
-function hatAt(timeSince, open) {
-  const length = open ? 0.16 : 0.06;
-  if (timeSince < 0 || timeSince > length) {
-    return 0;
-  }
-
-  const decay = open ? 26 : 54;
-  const raw = nextNoise();
-  const brightness = oscSine(9200, timeSince) * 0.08 + oscSine(6800, timeSince) * 0.06;
-  return (raw * 0.17 + brightness) * expEnv(timeSince, decay);
-}
-
-function sidechainAmount(time) {
-  const phase = time % beatLength;
-  return 1 - 0.28 * Math.exp(-phase * 15);
-}
-
-function bassNoteForStep(barIndex, stepInBar) {
-  const current = progression[barIndex % progression.length];
-  const root = current.root;
-  const fifth = root + 7;
-  const octave = root + 12;
-  const pattern = [root, root, fifth, root, octave, root, fifth, root];
-  return midiToHz(pattern[stepInBar % pattern.length]);
-}
-
-function arpNoteForStep(barIndex, stepInBar) {
-  const current = progression[barIndex % progression.length];
-  const pattern = [0, 1, 2, 1, 2, 1, 0, 2];
-  return midiToHz(current.accent[pattern[stepInBar % pattern.length]]);
-}
-
-for (let sample = 0; sample < totalSamples; sample += 1) {
-  const time = sample / sampleRate;
-  const barIndex = Math.floor(time / barLength) % progression.length;
-  const barTime = time % barLength;
-  const current = progression[barIndex];
-
-  let mixL = 0;
-  let mixR = 0;
-
-  // Pad chord.
-  let pad = 0;
-  for (const note of current.chord) {
-    const freq = midiToHz(note);
-    pad += oscSine(freq, time) * 0.12;
-    pad += oscSine(freq * 0.5, time) * 0.035;
-  }
-  pad += oscSine(midiToHz(current.root), time) * 0.03;
-  pad *= sidechainAmount(time) * 0.7;
-  mixL += pad;
-  mixR += pad;
-
-  // Bass pulse on eighth notes.
-  const bassStepLength = beatLength / 2;
-  const bassStep = Math.floor(barTime / bassStepLength);
-  const bassStepStart = bassStep * bassStepLength;
-  const bassTimeSince = barTime - bassStepStart;
-  const bassGate = bassTimeSince < 0.21 ? 1 : 0;
-  const bassFreq = bassNoteForStep(barIndex, bassStep);
-  const bassEnv = expEnv(bassTimeSince, 9) * bassGate;
-  const bass =
-    (oscTri(bassFreq, time) * 0.22 + oscSine(bassFreq * 0.5, time) * 0.1) *
-    bassEnv *
-    sidechainAmount(time);
-  mixL += bass;
-  mixR += bass;
-
-  // Bright arpeggio.
-  const arpStepLength = beatLength / 2;
-  const arpStep = Math.floor(barTime / arpStepLength);
-  const arpStepStart = arpStep * arpStepLength;
-  const arpTimeSince = barTime - arpStepStart;
-  const arpFreq = arpNoteForStep(barIndex, arpStep);
-  const arpEnv = Math.min(1, arpTimeSince * 40) * expEnv(arpTimeSince, 10);
-  const arp =
-    (oscSaw(arpFreq, time) * 0.07 + oscSine(arpFreq * 2, time) * 0.05 + oscSine(arpFreq, time) * 0.04) *
-    arpEnv;
-  const arpPan = arpStep % 2 === 0 ? -0.22 : 0.22;
-  mixL += arp * (1 - arpPan);
-  mixR += arp * (1 + arpPan);
-
-  // Kick every beat with an extra pickup before the fourth beat.
-  const kickPattern = [0, 1, 2, 2.75, 3];
-  let kick = 0;
-  for (const beat of kickPattern) {
-    kick += kickAt(barTime - beat * beatLength);
-  }
-  mixL += kick * 0.92;
-  mixR += kick * 0.92;
-
-  // Snare on beats 2 and 4.
-  let snare = 0;
-  for (const beat of [1, 3]) {
-    snare += snareAt(barTime - beat * beatLength);
-  }
-  mixL += snare * 0.75;
-  mixR += snare * 0.75;
-
-  // Hats on offbeats with occasional longer accent.
-  let hat = 0;
-  for (let step = 0; step < 8; step += 1) {
-    const start = step * bassStepLength;
-    const open = step === 3 || step === 7;
-    hat += hatAt(barTime - start, open);
-  }
-  mixL += hat * 0.4;
-  mixR += hat * 0.38;
-
-  // Gentle master fade in/out.
-  const fadeIn = Math.min(1, time / 0.35);
-  const fadeOut = Math.min(1, (seconds - time) / 0.5);
-  const masterEnv = Math.max(0, Math.min(fadeIn, fadeOut));
-
-  left[sample] = softClip(mixL * masterEnv);
-  right[sample] = softClip(mixR * masterEnv);
-}
-
-let peak = 0;
-for (let i = 0; i < totalSamples; i += 1) {
-  peak = Math.max(peak, Math.abs(left[i]), Math.abs(right[i]));
-}
-
-const targetPeak = 0.92;
-const gain = peak > 0 ? targetPeak / peak : 1;
-
-const pcmData = Buffer.alloc(totalSamples * 4);
-for (let i = 0; i < totalSamples; i += 1) {
-  const l = Math.round(clamp(left[i] * gain) * 32767);
-  const r = Math.round(clamp(right[i] * gain) * 32767);
-  pcmData.writeInt16LE(l, i * 4);
-  pcmData.writeInt16LE(r, i * 4 + 2);
-}
-
-const header = Buffer.alloc(44);
-header.write('RIFF', 0);
-header.writeUInt32LE(36 + pcmData.length, 4);
-header.write('WAVE', 8);
-header.write('fmt ', 12);
-header.writeUInt32LE(16, 16);
-header.writeUInt16LE(1, 20);
-header.writeUInt16LE(2, 22);
-header.writeUInt32LE(sampleRate, 24);
-header.writeUInt32LE(sampleRate * 4, 28);
-header.writeUInt16LE(4, 32);
-header.writeUInt16LE(16, 34);
-header.write('data', 36);
-header.writeUInt32LE(pcmData.length, 40);
-
-fs.mkdirSync(path.dirname(outPath), { recursive: true });
-fs.writeFileSync(outPath, Buffer.concat([header, pcmData]));
-
-console.log(`Wrote ${outPath}`);