norn-cli 1.5.3 → 1.6.0

package/CHANGELOG.md

@@ -4,6 +4,41 @@ All notable changes to the "Norn" extension will be documented in this file.
 
 ## [Unreleased]
 
+## [1.6.0] - 2026-03-04
+
+### Added
+- **Native VS Code Debugger for `.norn` Sequences (v1)**:
+  - Added Debug Adapter Protocol integration for debug type `norn`.
+  - Added line breakpoints in `.norn` files, including imported sequence sources.
+  - Added stepping controls: continue, pause, step over, step into sequence calls, step out, and stop.
+  - Added debugger variable scopes for runtime variables and response history (`$1`, `$2`, ...).
+  - Added launch support via `launch.json` with `file`, `sequence`, optional `env`, and `stopOnEntry`.
+
+- **Debugger Entry Points**:
+  - Added `Debug Sequence` command (`norn.debugSequence`).
+  - Added `▷ Debug Sequence` CodeLens on runnable sequences.
+  - Added Testing sidebar `Debug Tests` profile (single-target debug in v1).
+
+### Improved
+- **Debugger Runtime Behavior**:
+  - Added breakpoint line verification/auto-adjust to nearest executable step in the same sequence.
+  - Added failure-stop behavior for request/assertion failures before session termination.
+  - Added source/line mapping across root and imported sequence files for call stack and stepping.
+  - Added smart launch default for `stopOnEntry` in command/test-driven debug starts (disabled when breakpoints already exist).
+
+- **Documentation and Skills**:
+  - Added README debugger usage and `launch.json` example.
+  - Added debugger integration skill docs under `.github/skills/norn-debugger-integration`.
+  - Documented debugger as a VS Code-only v1 exception to CLI feature parity policy.
+
+## [1.5.4] - 2026-03-02
+
+### Improved
+- **Norn Cache Git Ignore Behavior**:
+  - Stopped modifying the repository root `.gitignore` when secret keys are cached.
+  - Added local cache-level ignore behavior by writing `.norn-cache/.gitignore` with `*`.
+  - Keeps `.norn-cache` contents out of Git without mutating user-managed root ignore files.
+
 ## [1.5.3] - 2026-03-02
 
 ### Added

package/README.md

@@ -870,6 +870,41 @@ Run tests directly from VS Code's Testing sidebar:
 - **Persistent Output**: Select a test to see its full output anytime
 - **Failure Details**: Expected vs actual diffs, request/response info
 
+### Debugging `.norn` Sequences (VS Code)
+
+Norn supports native VS Code debugging for `.norn` sequences:
+
+- Breakpoints in root and imported `.norn` files
+- Continue, pause, step over, step into sequence calls, and step out
+- Default `stopOnEntry: true`
+- Variables pane scopes:
+  - Runtime Variables
+  - Responses (`$1`, `$2`, ...)
+- Launch entry points:
+  - `🐞 Debug Sequence` CodeLens
+  - Testing sidebar `Debug Tests` profile (single target per debug session)
+
+You can also define explicit launch configs in `.vscode/launch.json`:
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "norn",
+      "request": "launch",
+      "name": "Debug LoginFlow",
+      "file": "${workspaceFolder}/tests/api-tests.norn",
+      "sequence": "LoginFlow",
+      "env": "prelive",
+      "stopOnEntry": true
+    }
+  ]
+}
+```
+
+Note: debugger support is currently VS Code-only by design. CLI behavior remains unchanged.
+
 ### Parameterized Tests
 
 Use `@data` for data-driven testing - each data row becomes a separate test: