netbox-sdk v0.0.2

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: v0.0.1...v0.0.2