norn-cli 2.6.1 → 2.7.0

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to the "Norn" extension will be documented in this file.
 
+## [2.7.0] - 2026-06-14
+
+### Added
+- **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.
+- **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.
+- **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.
+- **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.
+
+### Changed
+- **CLI regression reliability** — replaced external httpbin.org and Docker MCP dependencies with deterministic local HTTP and MCP fixtures.
+- **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`.
+- **Product metadata and docs** — updated Norn descriptions and documentation to cover API tests, database checks, and Kubernetes runbooks.
+
+### Fixed
+- **Kubernetes completion replacement** — multiword completions replace the full typed command prefix instead of producing duplicated text such as `get get pods`.
+- **Kubernetes live scope** — selector-filtered pod dashboards preserve selectors across watch updates and panel navigation.
+- **Kubernetes CLI output safety** — complete kubectl output is redacted before printing, and empty `.nornk8s --json` runs now emit valid JSON.
+- **Release packaging** — excluded caches, environment files, internal Docs, agent instructions, and development scripts from published artifacts.
+
+### Testing
+- **Kubernetes runtime coverage** — added Extension Host coverage for parsing, execution, safety, live views, caches, permission fallbacks, CLI behavior, and IntelliSense.
+
 ## [2.6.1] - 2026-05-30
 
 ### Changed

package/README.md

@@ -1,6 +1,6 @@
 # Norn
 
-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.
+Norn keeps API tests, database checks, and Kubernetes runbooks in version-controlled files your whole team can keep. Author and inspect them in VS Code, then run the same files from the CLI and CI.
 
 ### Simple API Requests
 
@@ -26,6 +26,8 @@ That means you can:
 - `.norn` files for requests, sequences, and tests
 - `.nornenv` files for environments and secrets
 - `.nornapi` files for reusable endpoint definitions
+- `.nornsql` files for database queries and commands
+- `.nornk8s` files for Kubernetes commands and runbooks
 - syntax highlighting, IntelliSense, and diagnostics
 - response inspection, JSON diffing, and click-to-generate assertions
 - tagged and parameterized test execution in VS Code and the CLI
@@ -62,6 +64,7 @@ Use Norn to:
 - run a whole sequence from the editor
 - debug a sequence with breakpoints
 - run test sequences from the Testing view
+- inspect live Kubernetes pods and logs from `.nornk8s` files
 
 ## In The CLI
 
@@ -70,11 +73,38 @@ The CLI uses the same execution model as the extension, so local runs and CI run
 ```bash
 npm install -g norn-cli
 norn ./tests/smoke.norn -e dev
+norn ./runbooks/triage.nornk8s --context prelive
 ```
 
+## Kubernetes Runbooks
+
+`.nornk8s` files turn common kubectl triage commands into reusable runbooks. Standalone
+`get pods`, `describe pod`, and `logs` commands open styled VS Code views with live pod
+and log updates. Helper sequences run explicitly, while `runbook sequence` blocks are
+automatic CLI entry points.
+
+```nornk8s
+namespace {{ordersNs}}
+
+get pods
+logs orders-api-7d9f --tail 500
+
+sequence RestartOrders
+    restart deployment/orders-api
+end sequence
+
+runbook sequence ClusterCheck
+    get pods
+    get pods -n kube-system
+end sequence
+```
+
+Select a Kubernetes context from the VS Code context lens or pass `--context` to the
+CLI. Restart commands require a VS Code confirmation or CLI `--yes`.
+
 ## `.nornenv` Templates And Extends
 
-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`.
+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`.
 
 ```nornenv
 var timeout = 30000
@@ -156,3 +186,4 @@ Behavior:
 - QA and automation work that needs readable test flows
 - regression and smoke suites that should run the same way locally and in CI
 - projects that want API requests and API tests to live next to the code
+- teams that want repeatable Kubernetes triage runbooks beside their services