txn2/kubefwd

This is a major release introducing an interactive Terminal User Interface (TUI), supply chain security features, significant test coverage improvements, and numerous stability enhancements. This release represents a substantial step forward in both user experience and code quality.

Highlights

• Interactive TUI: Real-time service monitoring with traffic metrics, log streaming, and keyboard navigation
• Supply Chain Security: Cosign-signed checksums, SBOM generation, and signed Docker images
• Race Condition Fixes: Thread-safe access to shared resources across multiple packages
• Expanded Test Coverage: Comprehensive unit tests for TUI components, events, state management, and core packages
• Enhanced Documentation: Architecture guides, tool comparisons, and configuration references

New Features

Interactive Terminal User Interface (PR #303)

kubefwd now includes a full-featured TUI built with Bubble Tea, enabled with the --tui flag:

sudo -E kubefwd svc -n default --tui

TUI Features

• Real-time service monitoring: View all forwarded services with connection status at a glance
• Traffic metrics: Bytes in/out with sparkline graphs showing traffic patterns
• Pod log streaming: View container logs directly in the TUI with per-container selection
• HTTP activity detection: Monitor HTTP requests/responses flowing through forwards
• Detail view: Drill down into individual services to see all pod forwards, ports, and metrics
• Auto-reconnect: Enabled by default in TUI mode with exponential backoff (1s to 5min max)
• Manual reconnect: Press r to force reconnect errored services immediately

Keyboard Shortcuts

| Key | Action |
|-----|--------|
| j/k or arrows | Navigate services |
| Enter | Open detail view |
| Tab | Switch panels/tabs in detail view |
| / | Filter services |
| r | Reconnect errored services |
| b | Toggle bandwidth columns |
| ? | Show help overlay |
| q | Quit |

TUI Architecture

The TUI follows the Model-View-Update (MVU) pattern with decoupled components:

• Event Bus (pkg/fwdtui/events): Pub/sub communication with panic recovery
• State Store (pkg/fwdtui/state): Thread-safe centralized state management
• Metrics Registry (pkg/fwdtui/metrics): Traffic counters with atomic operations and rate calculation
• Components (pkg/fwdtui/components): Modular UI models for services, logs, detail view, help overlay

Supply Chain Security

This release introduces comprehensive supply chain security features:

Checksum Signing

All release checksums are now signed using Cosign with keyless signing (OIDC identity). Users can verify downloads:

cosign verify-blob --signature kubefwd_checksums.txt.sig \
  --certificate kubefwd_checksums.txt.pem \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp 'https://github.com/txn2/kubefwd/.*' \
  kubefwd_checksums.txt

SBOM Generation

Software Bill of Materials (SBOM) files are now generated for each archive using Syft. Enterprise users can inspect dependencies and scan for vulnerabilities:

# Inspect SBOM
cat kubefwd_Linux_x86_64.sbom.json | jq '.artifacts[].name'

# Scan for vulnerabilities
grype kubefwd_Linux_x86_64.sbom.json

Docker Image Signing

All Docker images are signed with Cosign:

cosign verify txn2/kubefwd:v1.24.0 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp 'https://github.com/txn2/kubefwd/.*'

ForceReconnect Command

Added ForceReconnect functionality that bypasses backoff timers and triggers immediate service reconnection. This is particularly useful after computer sleep/wake cycles where TCP connections may be stale.

• Resets reconnect backoff to zero
• Clears all existing port forwards (which may be stuck on dead connections)
• Closes idle HTTP connections
• Triggers immediate pod sync

Configurable Retry/Resync Intervals

Added support for configuring retry and resync intervals for pod discovery, addressing issues #254 and #277.

Improvements

Thread Safety and Race Condition Fixes

• InterfaceManager: Added mutex protection for thread-safe access to the global interface manager
• Event Bus Tests: Fixed race conditions using atomic operations for handler state tracking
• ScheduleReconnect Tests: Proper DoneChannel management to prevent goroutine leaks
• Port Forward Registration: Fixed locking in registration and removal functions
• State Store: Thread-safe state management with RWMutex protection

Metrics and Monitoring

• MetricsConnection: Stream-level metrics tracking for port forward connections
• MetricsDialer: Connection-level metrics tracking
• RateCalculator: Historical bandwidth rate calculation with counter wraparound handling
• Registry: Global bandwidth metrics management with immutable snapshots

Error Handling and Resilience

• Panic Recovery: Handler invocations in the event bus now recover from panics gracefully
• Buffer Overflow Handling: TUI silently drops events and logs on buffer overflow during shutdown
• Graceful Shutdown: Earlier shutdown signaling in RemoveServiceFwd prevents goroutine reconnection issues

Code Quality

• Pointer Receivers: Refactored models to use pointer receivers consistently
• Receiver Naming: Standardized receiver names across metrics and TUI components
• Deprecated API Cleanup: Replaced NewSimpleClientset with NewClientset in tests
• Unused Code Removal: Cleaned up unused functions, styles, and redundant code paths

Testing

New Unit Tests

Comprehensive test coverage added for:

• TUI Components: Sparkline rendering, help overlay, header, status bar, logs model, services model, detail model, and formatting helpers
• Event Bus: Event publishing, subscription, handler panic recovery, concurrent access
• State Store: Forward and service state management, snapshot creation
• Port Forward Wrapper: Metrics emission and event handling
• Utils Package: Root permission checking with mock implementations
• FwdCfg Package: Kubernetes configuration handling
• FwdPub Package: Publisher interface testing

Test Infrastructure

• Mock Implementations: Added RootChecker and InterfaceManager interfaces for unit testing
• Test Utilities: Improved test helpers with proper error handling
• Race Detection: All tests pass with -race flag enabled

Integration Testing

• Container-based integration testing framework for privileged tests
• Demo microservices manifest (test/manifests/demo-microservices.yaml) with 60 services across 2 namespaces

Build and Infrastructure

GitHub Actions Release Workflow

New automated release workflow (.github/workflows/release.yml) that:

• Triggers on version tags (v*)
• Builds multi-architecture binaries and Docker images
• Installs and runs Cosign for artifact signing
• Installs and runs Syft for SBOM generation
• Publishes to GitHub Releases and Docker Hub

GoReleaser Configuration

• Added signs section for Cosign keyless checksum signing
• Added sboms section for Syft SBOM generation
• Added docker_signs section for Docker image signing
• Maintained brews section for Homebrew compatibility (pending cask migration support)

CodeQL Analysis

Added CodeQL workflow for automated security analysis of the codebase.

Documentation

New Documentation

• Advanced User Guides: Detailed guides for complex usage scenarios
• Architecture Documentation: In-depth explanation of kubefwd internals
• Tool Comparisons: Comparison with similar tools (kubectl port-forward, telepresence, etc.)
• Configuration References: Complete reference for all configuration options
• CONTRIBUTING.md: Guidelines for contributors with public/internal development policies

Updated Documentation

• README.md: Selector usage examples with labels, fields, and combined patterns
• CLAUDE.md: AI-assisted development guidance
• CODE_OF_CONDUCT.md: Simplified and clarified
• SECURITY.md: Streamlined security policy

Removed Documentation

• Removed outdated README_CN.md to maintain single source of truth

Dependency Updates

• github.com/txn2/txeh - v1.7.0
• Kubernetes client libraries - v0.31.0
• Added Bubble Tea and related TUI dependencies
• Added Lip Gloss for terminal styling

Bug Fixes

• Fixed race conditions in event handler tests using atomic operations
• Fixed thread-unsafe access to InterfaceManager global variable
• Fixed goroutine leaks in scheduleReconnect tests with proper DoneChannel cleanup
• Fixed locking issues in port forward registration and removal
• Fixed counter wraparound handling in rate calculations
• Fixed viewport scroll method deprecation warnings
• Fixed typos and minor code issues across multiple packages

Housekeeping

• Removed unused test helper functions from components_test.go
• Removed unused Kubernetes manifest files (kf-a.yml, kf-b.yml)
• Removed unused assets (kubefwd_ani.gif, kubefwd_sn.png)
• Removed redundant types.UID conversions
• Removed redundant comments in EventType constants
• Suppressed IDE inspections for test files where appropriate

Breaking Changes

None. This release is fully backward compatible with v1.23.x.

Installation

Homebrew (macOS/Linux)

brew install txn2/tap/kubefwd

Docker

docker pull txn2/kubefwd:v1.24.0

Binary Downloads

Download pre-built binaries from the GitHub Releases page.

Available for:

• Linux (amd64, arm64, arm, 386)
• macOS (amd64, arm64)
• Windows (amd64, 386)

Package Managers

• APK (Alpine): kubefwd_arm64.apk, kubefwd_amd64.apk
• DEB (Debian/Ubuntu): kubefwd_arm64.deb, kubefwd_amd64.deb
• RPM (RHEL/CentOS/Fedora): kubefwd_arm64.rpm, kubefwd_amd64.rpm

Verifying Downloads

Verify Checksum Signature

# Download checksum file and signature
curl -LO https://github.com/txn2/kubefwd/releases/download/v1.24.0/kubefwd_checksums.txt
curl -LO https://github.com/txn2/kubefwd/releases/download/v1.24.0/kubefwd_checksums.txt.sig
curl -LO https://github.com/txn2/kubefwd/releases/download/v1.24.0/kubefwd_checksums.txt.pem

# Verify signature
cosign verify-blob --signature kubefwd_checksums.txt.sig \
  --certificate kubefwd_checksums.txt.pem \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp 'https://github.com/txn2/kubefwd/.*' \
  kubefwd_checksums.txt

Verify Docker Image

cosign verify txn2/kubefwd:v1.24.0 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp 'https://github.com/txn2/kubefwd/.*'

Upgrade Notes

Upgrading from v1.23.x should be seamless. To try the new TUI:

sudo -E kubefwd svc -n default --tui

Auto-reconnect is enabled by default in TUI mode. For non-TUI usage, enable it with -a:

sudo -E kubefwd svc -n default -a

Full Changelog

See the commit history for the complete list of changes.

Changelog

• 2224406ed0363e226c3cabfb52568c5e0fe8f7b6 Add CONTRIBUTING guidelines and update LICENSE file
• b0d69063f1467a05f0c6b30210073eedaa7cbea4 Add TUI mode for interactive service monitoring
• 1a8a4ce9a05327d66e374217c08d4446bdfa3332 Add TUI package for terminal-based user interface with event handling and metrics visualization
• 3020ae9c77229c71441b65672f7beabe8e39c74f Add Bus implementation for event handling in TUI updates
• 3ed4f4acddc92e653121ec38b1d6865657484ed6 Add Event and EventType definitions for TUI event handling
• cd49a39590537f2106ee5c50bb0d002e46881d2d Add ForceReconnect to bypass backoff timers and trigger immediate service reconnection
• 6bcb489c469b8fbd89d15170d243bb777f37b49e Add ForwardSnapshot, ServiceSnapshot, and related structs for TUI rendering
• 50d4c3f398ee4814cb5440e777525fb36323f94a Add HelpModal for displaying keyboard shortcuts in the TUI
• 8e2193e3ee2272a7a138850edc051fc6f1477c92 Add Layout for managing TUI layout and global input handling
• e533414487d74a46e2e78ebb8badd6e662bd334e Add LogsView for log visualization in the TUI
• 5f94469cbf3229ec8f3ba3389f26d7ba4f974995 Add MetricsConnection for stream-level metrics tracking in port forward connections
• b94497cea263dcf46dfa756cb66fdcf7b493d469 Add MetricsDialer for metrics tracking in port forward connections
• 6958c249260e89179d0b3fff73439b4730da1327 Add MetricsStream for tracking bytes sent and received in fwdmetrics
• 0e1da77800eb9d5e002ea69cb704324a986345a2 Add RateCalculator for tracking and calculating historical bandwidth rates
• 08c011baa11261655d97c90d19bf36310fc6f057 Add Registry for managing global bandwidth metrics in fwdmetrics
• 27675c6c1a2cade96dbdca4551c5e0d34098b69b Add ServicesView for displaying and filtering services in the TUI
• f371b4830929fe4cd0dd3feeca70a6b16998e31e Add StatusBar component for TUI status updates
• 953f78cf61fcb5bb9655512363cedf0ffea50ed6 Add StopAllPortForwards to clear stuck port forwards during service reconnection
• b56db2eb728f0c023238049e5629f317f0df99d1 Add TUILogHook for capturing and forwarding log entries to the TUI
• 8314a9f605b10d4c0b92b72a32aba913bd0762b0 Add demo-microservices.yaml manifest for kubefwd testing and documentation purposes
• b3660b8cf0086bd89b23f8ca2d19dccd8388f856 Add fwdmetrics API to provide immutable snapshot capabilities for port forward metrics
• e199a01991d71c7e4ed35536f18d2a511d209855 Add fwdmetrics package for port forward metrics tracking
• 29fa00c8b7dd64faef3cdd17a28c199e28955e1c Add state.Store implementation for managing forwards, services, logs, and TUI state
• c78cbe26150d01eb8e199d8055b2efe33092aa9e Add advanced user guides, architecture documentation, tool comparisons, and configuration references
• fa6a0751c038539fb3bd64554b863429c64eba57 Add dependencies for TUI and color/terminal support
• 72ae6b64d56d078ea4647e2cfd60d1af87a6ee09 Add interfaces for InterfaceManager and RootChecker to enable mocking and unit testing
• 70b9c7c4e3b413a26f2aa8960d46c43ccb9446e1 Add mock implementations for RootChecker and InterfaceManager to enable unit testing
• b4bd8325e05c268b55677a2ebf2ea3b59ee37f41 Add nil checks in store_test.go to ensure original forward and service exist before assertions
• 6ecaa34b5bc8e00c245e372b6da6cb5e5e10aea9 Add panic recovery to handler invocations in Bus
• 6435a640754306063bf0106d2da89e444ad7a761 Add pod log streaming to TUI detail view
• 503fd92cc654a6e19ede1f5e4ab8d55858a76408 Add support for StatusPending style, improve test utilities, fix typos, and enhance logging and test coverage.
• eeab677bb3cf7220d51670715bef768ceefefa7e Add toggle for bandwidth and compact view in TUI services model
• 2e237027594862cc5e28d37b28f62aa634da5997 Add unit tests for TUI components, including sparkline rendering, help, header, status bar, logs, services, detail models, and formatting helpers
• 310def407193e414c50ecdc914052753ec699cf2 Add unit tests for HTTPSniffer to cover edge cases and behavior validation
• 378de2c070acea44ecaa71dce375d33caca294d4 Add unit tests for events, portforward, and state packages to improve test coverage
• 7acb787053845ec6e749077fe19e6f7ae15e318b Add unit tests for utils, fwdcfg, and fwdpub packages
• dd72580f309339eb06eff9d7be18433be60ea085 Adjust TUI layout and emit status events for port forwarding
• d0b526df7136e6250a47726669f7ec13cddd53cb Automate releases: Add GitHub Actions workflow and configure GoReleaser with checksum signing, SBOM generation, and Docker signing.
• 191339d2c880ca5ecbfbe2ff10b85985449c18a2 Chore: update docs to include autoreconnect
• 9a07ec41c60b8d1967c1e03d26974c402b422a59 Clarify contribution policy to outline public and internal feature development guidelines.
• 7bb7e43060f9bc2552fa67821145e3e836b788f2 Disable startup banner in TUI mode
• 956e1881ae10290894cd64b5709f26cb64b130b0 Emit TUI events on pod add/remove in the port forward registry
• 7d3a29a6bf8d1a10f037d3f7fe47c96d34557015 Emit TUI events on service add/remove in the service registry
• b5f40223c642b70fa6fe0f76d8f1cf47bdf81b5e Enable auto-reconnect by default in TUI mode if not explicitly set.
• 00d245319d42983fa5ac75c09170455c35e9c4a5 Enhance LogsModel scrolling with Vim-style keys and refined auto-follow behavior
• bb6701271b0a3438181a914f641315638cdbad87 Ensure thread-safe access to InterfaceManager using a mutex
• c5b4f6f0623c948d6ca332903813981106525159 Ensure thread-safe test logic using atomic operations and improve DoneChannel management for scheduleReconnect tests
• 5ef1cbf485c1cf5fc06913aca4019b0c618d8635 Fix TUI metrics display and improve table layout
• 49ac08a7ab655b4bbca28938d0ace6f3c147ff62 Fix TUI table column width management with dynamic expansion
• 3e3e24b9492ab5b502b06c190e39eaee8754b00f Fix typo
• 5df5bdb90b72149a75c9f0dd3ba4d8b184dbe300 Fix: Always log unexpected klog messages at debug level
• d7bb31f904387d9f1b6a83d39edbd645cdb8f976 Fix: Correct fwdIp directory case to fwdip for Linux compatibility
• f2eaf4552dae0c323110ad335c8de825edb3f158 Fix: Force fresh TCP connections by closing idle HTTP connections during service reconnection
• 5974f1ad03e2b848c126e897466394beaed45514 Fix: Use Go 1.24 in release workflow
• b5c17f8f4761dc037c13d76ffc9adeaba071619d Fix: Use proper locking in port forward registration and removal functions
• 2b1fa3b90d23690fc10f7471ff00e708eb6bd6da FwdService: Document reconnection behavior with exponential backoff logic
• a1f7aef4cb4ff91a8a60cd1b87acb475c1e9affa Handle counter wraparound in rate calculations for metrics
• fe686d700e73650626a5c536deac39c4daa1766d Housekeeping: Add CodeQL workflow for automated code analysis.
• 9abd6dbbabb87f3ed3f268f5d0554b7637887cb3 Housekeeping: Refactor models to use pointer receivers
• ecce56dbadbeaad6a0f19dc62acfff1f7da23e25 Housekeeping: Refactor package naming, improve consistency in method naming, simplify test cleanup, and address minor code issues across multiple packages.
• c9d5825e1b7243d6133a9f09c2053acee7c8f651 Housekeeping: Refactor tests to handle Setenv errors, replace NewSimpleClientset with NewClientset, and suppress duplicated code inspections.
• 102c1c4c8b5e1c06001d72a90e22e8a7bddbe4b7 Housekeeping: Remove unused kf-a.yml and kf-b.yml Kubernetes manifest files.
• 92aea4feea2786933dd1556042e52a22f0a43ec9 Housekeeping: Remove unused kubefwd_ani.gif and kubefwd_sn.png assets.
• e2c03676029b83bca24e9fbbd6d4a604d3cdaded Housekeeping: Remove unused test helper functions from components_test.go.
• 84d3c4c2010667148b2f04273742ac01d143b364 Housekeeping: Suppress Goland inspections for HttpUrlsUsage across test files.
• f5eb1e112bd1587d77495c66981d61aed747f2f8 Housekeeping: Update utils_test to properly handle return values from CheckRoot calls.
• 88d3c1254a1ecaef2e494ddfcd8f1c9f4bc6e675 Improve TUI resilience by logging dropped events and logs when buffers are full
• 7b3f60a0e48a86c8ded1d4a73305f2e83085dc85 Improve DetailModel scrolling behavior and refine auto-follow logic
• 4825cb93fc9735f18a3f4245442e8891e7b9cf90 Include LocalPort in key construction for port forwards and enhance snapshot sorting stability
• 0efc519dde88c090b77d64813097c07f2193535c Integrate TUI-aware port forward metrics tracking
• 05c0a14bd26800cddd9bda0e038453d9b8d26fbe Introduce detail view for port forwards with enhanced HTTP and bandwidth metrics
• bc33f1b832fa0704989a6518e2dd83dca03f54af Refactor TUI from tview to bubbletea with improved layout
• 0064258492c6a1d4c1602fc85d7de2833feda7aa Refactor CheckRoot implementation to delegate logic to RootChecker interface for testability.
• 40745cdb09303116017dfe885956a53e088084a9 Refactor CheckRoot to delegate logic to defaultRootChecker for improved testability and maintainability. Update build tag syntax to go:build.
• 89f8448ec0055c9123b178f7ea22646cd7d447ea Refactor InterfaceManager implementation for alias management and IP readiness
• 297678687b99e236dc34b8cfabc591e763526059 Refactor setAllNamespace and checkConnection to use kubernetes.Interface for improved flexibility and testability.
• 0fcab2aed15bf4fee94ee842098d23822576724e Refactor port-forwarding logic to streamline error handling and improve reconnection behavior
• 2d67defe67fce3035fab98e3f3aa33273a112d02 Refactor: Add lock ordering comments and graceful shutdown to Registry
• cbabdb2a5b8189c3ff29d4965c6a486bf1895e3d Refactor: Handle unused results and errors in tests and TUI components
• 4703e5a8cf6c465ba317b25af117c2f09d0e9f86 Refactor: Improve HTTPSniffer efficiency with ring buffer and clarify request/response limitations
• 6149321735e13d897f53ed36c985068075613b6a Refactor: Remove redundant comments in EventType constants
• de1213b5f157ac59fee26b6378d1bbec22797548 Refactor: Rename variables for clarity and add default cases in switch statements
• c7328cf291fd5a70865da8105dd9b4f5cd6f9452 Refactor: Replace deprecated NewSimpleClientset with NewClientset and update int to int32 for TargetPorts in tests
• b4cfed4407ed721e8c1b451445d0cfe57b3fc1f4 Refactor: Standardize receiver names in metrics and TUI components
• d2e18ed69630e124f3d15f99f11461927b6ec6bf Refactor: Unexport BytesIn and BytesOut
• 89e6c16ca5a5565ea4f2642ef06ccdbdbebd30f1 Refactor: Use RegistryKey for accurate service identification and reconnection logic
• d1591ea383e10920a3a346c06d36461234a69c53 Remove stray text after closing HTML tag in README.md
• 0c7f71f1cb3bcc4a3848713fac93b9b5e666f746 Remove unused and redundant code from port forwarding logic
• 9b64a7f59c7c913c15f9adb39703f25258221ed6 Remove unused functions and styles across multiple packages for cleanup
• 3f5e91a369201981c9dcfa178e805cab62105c86 Removed outdated README_CN.md to streamline documentation and maintain a single source of truth.
• 34e0277feffbfb91cafb3332c174d58cce5e6131 Replace CloseIdleHTTPConnections with ForceReconnect to reset backoff and trigger immediate service reconnection
• 2b3694c64f416fc44ee94277976145e4801f5365 Signal shutdown earlier in RemoveServiceFwd to prevent goroutine reconnection issues.
• 0b7e125d8d52e046753b68d185ed1fe0636e4828 Silently drop TUI log messages on buffer overflow during shutdown.
• cef45871d478c28a2101fea31fd2c0bcd718f0e0 Simplify TUI event handling: silently drop events on buffer overflow during shutdown.
• ff47a7eced9015fc53e15379c2306a29412c3ba5 Simplify and clarify CODE_OF_CONDUCT.md and SECURITY.md:
• 0e1f8adfdd94d13803f1dd7da03ab38a5267be23 Support per-container log streaming in TUI and enhance logs viewport functionality
• 4a685d4c16c5413915716cf268c3cf8444b5ff1a TUI: Add auto-follow functionality for log streaming in detail view
• 1b9ff91066a22a1af0c46269926f69f10410988e TUI: Add click-to-select row functionality in services panel
• 7bf2b8073b87b09901a8a9ce52eb9e4d952ae56c TUI: Add reconnect functionality for services with errors
• 8ac968d22ebb6659dc935b9fd04f7f83a433a99b TUI: Add reconnect functionality for services with errors
• 0f114d36d5c3f22eab78ee48243c0735af04d406 TUI: Adjust fixed line count and update layout comments for clarity
• fa24602daa1dc386fc1ee40cc219d0719ce92f06 TUI: Change log order in detail view to chronological (oldest to newest)
• 99d91813a80bdebaa3fbb1d41395fd319cfdeb1d TUI: Fix column widths with SetMaxWidth, remove debug logs
• 602e6d606b1ee5f442a714df76e0cf2405e7b5f0 TUI: Refine logs auto-follow behavior and layout adjustments
• ffc9ee083df6bf5f98bfa1f1324be8459442eab5 TUI: Remove redundant blank line before footer in logs layout
• b4502cf70d556a695129bdd2bd09d326ac6e7399 TUI: Rename viewport scroll methods for consistency and clarity
• a651d39053409d77d3970b2be031c38a71815583 Update README.md
• 45a6b01a02de5c1f0d81bc869e06817ef680c5b3 Update README.md
• cd16538a8fb8929ead3ae3b4ed098c0d37ae1557 Update key generation to include LocalPort for port forwarding differentiation in TUI
• bd7a93fd86c35e88ad72505e3d45d271d42398b1 Update test README to reflect additional integration tests, new test files, and container-based testing option.
• 3b41cba3122f23d5e484611e58e6e2d0be4a1340 fix: replace deprecated viewport methods
• ec4c314d257a45e0aef820e2a6a3620f3f18d75c housekeeping
• d9e2c2a3ddbd074a86cd79dc575c65b9d458f73d remove redundant types.UID conversions