norn-cli 2.6.1 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,43 @@
2
2
 
3
3
  All notable changes to the "Norn" extension will be documented in this file.
4
4
 
5
+ ## [2.8.0] - 2026-06-20
6
+
7
+ ### Changed
8
+ - **PTY-backed Norn Terminal** — promoted the PTY-backed terminal to the only registered `Norn: Open Terminal` route, removed the experimental PTY command and setting, and kept interactive commands inside Norn's raw PTY surface instead of handing them off to a separate VS Code terminal.
9
+ - **Native terminal agents** — refined Codex and Claude terminal sessions with earlier thinking indicators, persisted session replay, native agent launch/focus behavior, and bounded command/file/tool transcript cards that stay readable in the terminal rail.
10
+ - **Terminal documentation** — updated the project terminal skills, rollout plan, and website docs for the promoted PTY route and removed experimental toggle.
11
+
12
+ ### Fixed
13
+ - **Agent transcript replay** — restored saved shell/tool activity as command and file-edit cards instead of generic tool blobs, including large edit diffs that previously lost their diff rendering after truncation.
14
+ - **Terminal layout polish** — contained long assistant text, command output, code, and diffs so focused agent panes do not paint under the rail or collapse during long restored sessions.
15
+
16
+ ### Testing
17
+ - **Release verification** — `npm test` passed with 69 Extension Host tests. `npm run test:regression` ran 195 CLI regression sequences with 193 passing; Peter explicitly accepted the two known local SQL Server fixture connection failures (`SmokeLiveSqlServerSql`, `SeedLiveSqlServerDummyData`) at `127.0.0.1:14333`.
18
+ - **Website docs review** — updated `src/pages/docs/kubernetes.astro` and `src/pages/docs/vscode.astro` in the website repo; `npm run build` passed there.
19
+
20
+ ## [2.7.0] - 2026-06-14
21
+
22
+ ### Added
23
+ - **Kubernetes runbooks (VS Code + CLI)** — added the `.nornk8s` file type with syntax highlighting, a Kubernetes-inspired file icon, standalone commands, reusable `sequence` helpers, automatic `runbook sequence` CLI entry points, context selection, `.nornenv` variables, label-selector pod capture, and confirmed deployment restarts.
24
+ - **Live Kubernetes views** — standalone `get pods`, `describe pod`, and `logs` commands now open styled VS Code views with unhealthy-first pod sorting, pod details and events, live pod watches, live log following, level filters, folded stack traces, pause/resume, and snapshot refresh while paused.
25
+ - **Norn Terminal** — added an editor-area terminal that upgrades supported pod, log, event, restart, and rollout commands into structured blooms and live tiles while preserving normal shell fallback. Compact terminal tabs retain independent transcripts, working directories, environments, Kubernetes scopes, running tasks, and live views, with rename and close controls.
26
+ - **Kubernetes IntelliSense** — added cached namespace, pod, and deployment suggestions scoped by context and file namespace, `get pods` and `logs` flag suggestions, common `--tail` values, chained suggestions, and complete sequence-block insertion.
27
+
28
+ ### Changed
29
+ - **CLI regression reliability** — replaced external httpbin.org and Docker MCP dependencies with deterministic local HTTP and MCP fixtures.
30
+ - **Environment selection UI** — removed the global Norn environment selector from the VS Code status bar; environments remain selectable through CodeLens, `.nornenv` actions, and `Norn: Select Environment`.
31
+ - **Product metadata and docs** — updated Norn descriptions and documentation to cover API tests, database checks, and Kubernetes runbooks.
32
+
33
+ ### Fixed
34
+ - **Kubernetes completion replacement** — multiword completions replace the full typed command prefix instead of producing duplicated text such as `get get pods`.
35
+ - **Kubernetes live scope** — selector-filtered pod dashboards preserve selectors across watch updates and panel navigation.
36
+ - **Kubernetes CLI output safety** — complete kubectl output is redacted before printing, and empty `.nornk8s --json` runs now emit valid JSON.
37
+ - **Release packaging** — excluded caches, environment files, internal Docs, agent instructions, and development scripts from published artifacts.
38
+
39
+ ### Testing
40
+ - **Kubernetes runtime coverage** — added Extension Host coverage for parsing, execution, safety, live views, caches, permission fallbacks, CLI behavior, and IntelliSense.
41
+
5
42
  ## [2.6.1] - 2026-05-30
6
43
 
7
44
  ### Changed
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Norn
2
2
 
3
- Norn turns API requests into version-controlled tests your whole team can keep — authored and debugged in VS Code, run on every PR in CI. Write a request once, turn it into a tested sequence, debug it with breakpoints in the editor, and run the exact same `.norn` files from the CLI in your pipeline.
3
+ Norn keeps API tests, database checks, and Kubernetes runbooks in repeatable, version-controlled files your whole team can trust. Author, inspect, and debug them in VS Code, then run the same files from the CLI and CI.
4
4
 
5
5
  ### Simple API Requests
6
6
 
@@ -26,6 +26,8 @@ That means you can:
26
26
  - `.norn` files for requests, sequences, and tests
27
27
  - `.nornenv` files for environments and secrets
28
28
  - `.nornapi` files for reusable endpoint definitions
29
+ - `.nornsql` files for database queries and commands
30
+ - `.nornk8s` files for Kubernetes commands and runbooks
29
31
  - syntax highlighting, IntelliSense, and diagnostics
30
32
  - response inspection, JSON diffing, and click-to-generate assertions
31
33
  - tagged and parameterized test execution in VS Code and the CLI
@@ -62,6 +64,7 @@ Use Norn to:
62
64
  - run a whole sequence from the editor
63
65
  - debug a sequence with breakpoints
64
66
  - run test sequences from the Testing view
67
+ - inspect live Kubernetes pods and logs from `.nornk8s` files
65
68
 
66
69
  ## In The CLI
67
70
 
@@ -70,11 +73,38 @@ The CLI uses the same execution model as the extension, so local runs and CI run
70
73
  ```bash
71
74
  npm install -g norn-cli
72
75
  norn ./tests/smoke.norn -e dev
76
+ norn ./runbooks/triage.nornk8s --context prelive
73
77
  ```
74
78
 
79
+ ## Kubernetes Runbooks
80
+
81
+ `.nornk8s` files turn common kubectl triage commands into reusable runbooks. Standalone
82
+ `get pods`, `describe pod`, and `logs` commands open styled VS Code views with live pod
83
+ and log updates. Helper sequences run explicitly, while `runbook sequence` blocks are
84
+ automatic CLI entry points.
85
+
86
+ ```nornk8s
87
+ namespace {{ordersNs}}
88
+
89
+ get pods
90
+ logs orders-api-7d9f --tail 500
91
+
92
+ sequence RestartOrders
93
+ restart deployment/orders-api
94
+ end sequence
95
+
96
+ runbook sequence ClusterCheck
97
+ get pods
98
+ get pods -n kube-system
99
+ end sequence
100
+ ```
101
+
102
+ Select a Kubernetes context from the VS Code context lens or pass `--context` to the
103
+ CLI. Restart commands require a VS Code confirmation or CLI `--yes`.
104
+
75
105
  ## `.nornenv` Templates And Extends
76
106
 
77
- Use `[template:name]` sections for reusable environment building blocks, then compose selectable `[env:name]` sections with `extends`. Only templates can be extended. Templates are not selectable from the status bar or CLI; only `[env:...]` names can be used with `-e`.
107
+ Use `[template:name]` sections for reusable environment building blocks, then compose selectable `[env:name]` sections with `extends`. Only templates can be extended. Templates are not selectable from the VS Code environment picker or CLI; only `[env:...]` names can be used with `-e`.
78
108
 
79
109
  ```nornenv
80
110
  var timeout = 30000
@@ -156,3 +186,8 @@ Behavior:
156
186
  - QA and automation work that needs readable test flows
157
187
  - regression and smoke suites that should run the same way locally and in CI
158
188
  - projects that want API requests and API tests to live next to the code
189
+ - teams that want repeatable Kubernetes triage runbooks beside their services
190
+
191
+ Diff preview test line.
192
+
193
+ ping