# netbox-sdk v0.0.2

netbox-sdk v0.0.2

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-sdk/releases/v0.0.2 |
| GitHub URL | https://github.com/emersonfelipesp/netbox-sdk/releases/tag/v0.0.2 |
| Tag | v0.0.2 |
| State | stable |
| Author | emersonfelipesp |
| Created | 2026-03-24 17:30 UTC |
| Published | 2026-03-23 02:21 UTC |
| Target | main |
| Synced | 2026-08-24 18:36 UTC |
| Assets | 0 |

## Release notes

## What's New in v0.0.2

This release significantly expands the TUI layer, theme system, developer tooling, documentation, and test coverage since the initial v0.0.1 release.

---

## New Features

### Dev TUI Workbench
- Added a full **Dev TUI workbench** (`nbx dev`) with theme-aware NetBox branding
- Added **view switcher** to toggle between the main TUI and the Dev TUI at runtime
- Added `nbx dev http` command tree with **Pydantic v2 validation** for request/response models

### TUI Enhancements
- **ContextBreadcrumb** navigation bar for contextual path display across TUI screens
- **SupportModal** for in-app help and support information
- **NetBox wordmark + CLI suffix** branding in the TUI top bar
- Adopted **prop-driven Textual composition** for cleaner widget architecture and theme styling

### Theme System
- Promoted `netbox-dark` as the **official default theme**
- Extended ANSI theming support for the Dev TUI workbench panels

### Demo & Auth
- **Automatic demo token self-heal**: the CLI now detects and recovers from stale demo tokens automatically
- **Live plugin discovery**: plugins available on the connected NetBox instance are detected at runtime

### Documentation Generation
- `docgen` now produces **multi-file command examples** with full command tree coverage
- `uv` integrated into the docgen background script and CI workflow
- Generated docs include a standardized header

### Developer Tooling
- Added **Ruff + pre-commit** lint standards with `.pre-commit-config.yaml`
- Added **PROMPTING-GUIDE.md** for AI-assisted development workflows
- Added **main post-merge validation** CI workflow (`.github/workflows/main-post-merge.yml`)
- Added **lint CI workflow** (`.github/workflows/lint.yml`)

---

## Improvements

### Architecture
- **Migrated all dataclasses to Pydantic v2 models** across the codebase
- **Unified TUI theme enforcement** and shared UI helpers into a single consistent layer
- **Refactored CLI package** structure for improved stability and separation of concerns
- Unified TUI visual patterns across main and dev shells

### Documentation
- New developer guide: **Textual composition patterns** (`docs/developer/textual-composition.md`)
- New TUI docs: **themes reference** (`docs/tui/themes.md`) and TUI index (`docs/tui/index.md`)
- New `docs/NETBOX_UI_TO_TEXTUAL_GUIDELINES.md` for UI parity guidance
- Simplified **README** focused on end-user experience
- Updated architecture and developer docs to match current code state

---

## Bug Fixes

- Fixed **Dracula theme surface rendering** (background/surface contrast)
- Corrected `dracula.json` colours to match the **official Dracula palette specification**
- Fixed theme background/surface enforcement on **Dev TUI workbench panels**
- Fixed **TUI theme and instance isolation regressions** introduced in prior refactor
- Fixed **CI OpenAPI test paths** after CLI package reorganization
- Fixed main-branch CI regressions following the CLI refactor merge

---

## Tests

New test modules added since v0.0.1:
- `tests/test_dev_tui.py` — Dev TUI workbench coverage (503 lines)
- `tests/test_tui_interaction.py` — Expanded TUI navigation and interaction tests
- `tests/test_logs_tui.py` — Logs TUI screen tests
- `tests/test_logo_render.py` — Theme-aware logo rendering tests
- `tests/test_plugin_discovery.py` — Live plugin discovery tests
- `tests/test_instance_isolation.py` — Multi-instance TUI isolation tests
- `tests/test_demo_runtime_refresh.py` — Demo token refresh/self-heal tests
- `tests/test_logging_runtime.py` — Runtime logging behaviour tests
- `tests/test_docgen_paths.py` — Docgen output path validation tests

Existing test suites hardened:
- Hardened CI-sensitive CLI and TUI tests for stability across environments
- Stabilized TUI navigation selection tests

---

## Stats

106 files changed, 13,466 insertions(+), 3,264 deletions(-)

**Full Changelog**: https://github.com/emersonfelipesp/netbox-cli/compare/v0.0.1...v0.0.2

## Assets

No binary assets attached.

Source archives:

| Format |URL |
| --- | --- |
| zip | https://api.github.com/repos/emersonfelipesp/netbox-sdk/zipball/v0.0.2 |
| tar.gz | https://api.github.com/repos/emersonfelipesp/netbox-sdk/tarball/v0.0.2 |