Changelog¶

This page mirrors the CHANGELOG.md in the repository.

All notable changes to this project will be documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.2.6] - 2026-03-29¶

Fixed¶

CLI¶

• Fix persistent heap OOM crash when running in slow terminals (e.g. VSCode integrated terminal) — stdout backpressure from Ink renders now skips frames when the write buffer exceeds the high-water mark instead of accumulating indefinitely
• Debounce event-driven refreshes in DockerState (500ms) — health_status, start, create, and other rapid Docker events no longer each trigger their own overlapping refresh() call
• Bound the compose log entries queue at 1000 — previously unbounded, the queue between the docker compose logs child process and the async generator could grow without limit

Shared¶

• Copy Buffer remainder instead of subarray view in DockerClient.streamLogs() — subarray() kept the entire parent buffer alive; now uses Buffer.from() to create an independent copy so the large combined buffer can be GC'd immediately

Changed¶

CLI¶

• SIDEKICK_DEBUG_STREAMS=1 diagnostics now include stdout buffer fill level (writableLength/writableHighWaterMark), external memory, and array buffer usage

[0.2.5] - 2026-03-28¶

Fixed¶

CLI¶

• Fix JavaScript heap out-of-memory crash after extended use (~2-3 hours) caused by multiple memory leaks
• Clean up inspectedEnv, containerChanges, and imageLayers caches on container destroy and periodic refresh — previously entries were never removed, leaking indefinitely
• Cap LogTemplateEngine at 500 template groups globally — previously unbounded, accumulating thousands of groups for containers with highly variable log patterns
• Prune StatsCollector history entries for non-running containers on periodic refresh
• Deterministic stream teardown using AbortSignal — switching containers or stopping streams now immediately destroys the underlying Docker HTTP connection instead of waiting for the next chunk
• Eliminate unnecessary shallow array copies in getMetrics() called every render cycle — return direct references since consumers never mutate
• Cache colorized log output with WeakMap — avoids re-tokenizing and re-colorizing all 1000 log lines every render, reducing per-render allocations from ~100K objects to near zero
• Eliminate join('\n') → split('\n') round-trip in log tab rendering — log tabs now return string[] directly

Shared¶

• Add signal?: AbortSignal parameter to DockerClient.streamLogs(), DockerClient.streamStats(), and ComposeClient.streamLogs() for immediate stream teardown
• Add StatsCollector.prune() method to remove history for non-active containers
• Add LogTemplateEngine.getDiagnostics() for group count, dropped groups, and total lines

Changed¶

CLI¶

• Render throttle increased from 100ms to 200ms (10fps → 5fps) — still smooth for a TUI and halves GC pressure
• DetailTab.render() return type widened to string | string[] to avoid wasteful string conversions
• BaseStreamManager now uses AbortController per stream with a generation counter to prevent stale reconnects

Added¶

CLI¶

• SIDEKICK_DEBUG_STREAMS=1 environment variable enables periodic memory and template diagnostics (every 60s) for debugging long-running sessions

[0.2.4] - 2026-03-26¶

Fixed¶

CLI¶

• Fix crash on startup: Cannot access 'renderTimer' before initialization — renderTimer declaration was after its first usage via React effect mount chain (onViewStateChange → flushLogsNow → scheduleRender); moved declaration before stream manager callbacks

[0.2.3] - 2026-03-26¶

Added¶

Dual-Log Compare Mode¶

• Side-by-side log comparison — pin a second container or service to view both log streams simultaneously in left/right columns
• m key pins/unpins a compare target on Containers and Services panels (CLI)
• Shift+J/Shift+K scrolls the secondary (right) compare pane when in detail focus (CLI)
• Pin button on side list items in VS Code extension (hover-visible) to toggle compare mode
• Per-panel pin memory — each panel remembers its compare target independently when switching panels
• Auto-clear compare when the selected item matches the pinned item
• Log filter applies to both compare panes independently
• Severity count badges shown per-pane in compare mode

CLI¶

• New CompareDetailPane component rendering two fixed-width log columns with ANSI-safe clipping
• clipAnsi() utility for truncating ANSI-colored strings to a visible character width
• Shared renderLogLines() helper extracted from panel log rendering, used by both primary and secondary panes
• m:Compare contextual hint in status bar when on Logs tab

VS Code Extension¶

• Side-by-side CSS layout (.log-compare-container) with independently scrollable panes
• toggleCompareItem webview→extension message with Zod schema validation
• Secondary log and compose log stream lifecycle in DockerService (demand-driven, stops when not viewing Logs tab)

[0.2.2] - 2026-03-24¶

Fixed¶

• Copy logs (c key) now works on the Services panel — previously only worked on Containers panel (both CLI and VS Code)
• VS Code extension copy logs function now correctly reads compose logs when on the Services panel

[0.2.1] - 2026-03-24¶

Improved¶

• Debounced log rendering with 100ms flush window, reducing re-renders during high-throughput log output
• View-state-driven streaming — stats and log streams now activate based on which detail tab is visible and which sort field is active, instead of starting on every selection
• VS Code extension stops all background streams when the dashboard webview is hidden, restarting on focus
• Smart stream demand in VS Code: logs only stream on Containers panel, compose logs only on Services panel, stats only when the Stats tab is active or sorting by live metrics

Fixed¶

• Add missing zod dependency to VS Code extension package for CI build

[0.2.0] - 2026-03-14¶

Added¶

Container Filesystem Inspector¶

• New Files detail tab on the Containers panel showing all filesystem changes made inside a container
• Color-coded change markers: green A for added, yellow C for changed, red D for deleted files
• Uses Docker's container.changes() API — works on both running and stopped containers
• Available in both TUI and VS Code extension

Image Layer Explorer¶

• New Layers detail tab on the Images panel showing the full layer history of an image
• Displays layer number, size, and the Dockerfile instruction that created it
• Shows total image size and highlights the largest layer
• Uses Docker's image.history() API
• Available in both TUI and VS Code extension

Docker API Layer (sidekick-docker-shared)¶

• DockerClient.getContainerChanges(id) — returns typed FilesystemChange[]
• DockerClient.getImageHistory(nameOrId) — returns typed ImageLayer[]
• Zod schemas for container changes and image history API responses

VS Code Extension¶

• Network I/O rate sparklines (RX/TX bytes/sec) in Stats tab
• Block I/O rate sparklines (read/write bytes/sec) in Stats tab
• Log severity sparkline in Stats tab

Improved¶

• Comprehensive Zod runtime validation for all Docker API responses
• Modular shared package with enforced import DAG and integration tests
• Sub-path exports eliminating code forks in VSCode package
• BaseStreamManager extracted from three identical stream manager implementations
• Async action feedback, contextual hints, and tiered confirmation modals in TUI

[0.1.5] - 2026-03-08¶

Added¶

Docker API Layer (sidekick-docker-shared)¶

• DockerClient.pauseContainer(id) and DockerClient.unpauseContainer(id) methods
• Health status parsing from Docker Status string — extracts healthy, unhealthy, or starting from status text (e.g., "Up 5 minutes (healthy)")
• healthStatus field on ContainerInfo type
• Block I/O stats extraction — blockRead and blockWrite fields on ContainerStats, parsed from blkio_stats.io_service_bytes_recursive
• StatsCollector.getNetworkRxRateSeries() / getNetworkTxRateSeries() — compute bytes/sec from consecutive cumulative sample deltas
• StatsCollector.getBlockReadRateSeries() / getBlockWriteRateSeries() — compute block I/O bytes/sec rates
• 3 new unit tests for rate series computation (network and block I/O)

TUI Dashboard¶

• Pause (p) and Unpause (u) container actions in the Containers panel
• Show all / running-only toggle (a key) — filters container list to show only running/paused containers when toggled off
• Health status indicator in container list items — colored badge (green=healthy, red=unhealthy, yellow=starting) appended to container name
• Health status in Config detail tab
• Network I/O sparklines — RX/TX rate sparklines (bytes/sec) below the Net line in the Stats tab
• Block I/O stats line in Stats tab showing cumulative read/write bytes with rate sparklines
• Container sorting (o key opens sort overlay) — sort by state, name, CPU%, memory%, network I/O, block I/O, or PIDs
• Reverse sort toggle (R key) — reverses current sort direction
• Sort overlay with j/k navigation, Enter to apply, R to reverse within overlay
• New keybindings added to Help overlay: a, o, R

VS Code Extension¶

• Pause and Unpause container actions in context menu and action handler
• Health status display in Config detail tab (colored: green/red/yellow)
• Block I/O stats row in Stats detail tab (read/write bytes)

[0.1.4] - 2026-03-07¶

Added¶

TUI Dashboard¶

• 3-state layout cycle (z key): Normal → Wide → Expanded → Normal. Wide mode uses a 42-column side panel so full container/resource names are visible without truncation
• Copy logs to clipboard (c key on Containers panel) — copies buffered log text to system clipboard, respects active log filter. Uses platform-native clipboard (pbcopy, xclip, xsel, wl-copy)

VS Code Extension¶

• Tooltip on hover for side list items — shows full untruncated name for containers, images, volumes, networks, and services via HTML title attribute
• Copy logs to clipboard (c key or Copy button in log filter bar) — copies buffered log text to clipboard via vscode.env.clipboard, respects active log filter

Changed¶

• Side panel truncation limits increased across all CLI panels to accommodate Wide layout mode (SideList already clips to available width in Normal mode)

[0.1.3] - 2026-03-03¶

Improved¶

Code Quality & Reliability¶

• Extract ReconnectScheduler utility replacing three identical reconnect implementations across stream managers
• Add errorMessage() helper eliminating 10 repeated instanceof checks
• Consolidate MAX_LOG_LINES constant to shared package
• Extract withDockerClient helper in VSCode extension removing five identical command handler bodies
• Extract useKeyboardHandler and useMouseHandler hooks from Dashboard.tsx (887 → ~370 lines)
• Extract shared types to reduce duplication across dashboard panels
• Replace silent .catch(() => {}) with descriptive debug logging across all packages
• Wire AbortController signal through EventWatcher → DockerClient.streamEvents for proper stream teardown
• Add 24 new tests: DockerState (13), LogStreamManager (6), StatsStreamManager (5)

Security & Error Handling¶

• Replace Math.random() with crypto.randomBytes() for CSP nonce generation
• Fix redundant ternary that always evaluated to 'running' in DockerState
• Extract magic numbers to named constants (toast durations, log buffer limits, reserved UI rows, reconnect delays)
• Add error logging to all stream manager catch blocks (previously silent)
• Add bounded retries with exponential backoff to Log/StatsStreamManager
• Add auto-reconnect to ComposeLogStreamManager (previously missing)
• Eliminate non-null assertions in ServicesPanel via discriminated union type
• Fix DockerClient resource leaks in VSCode extension commands (try/finally)
• Fix DockerService leak on failed initialize in DockerDashboardProvider
• Fix ComposeLogStreamManager missing exponential backoff (was retrying forever at fixed 2s)
• Make EventWatcher sleep cancellable on stop()

TUI Dashboard UX¶

• SideList: preserve icon color in focused selection (no longer lost to uniform cyan inverse)
• StatusBar: color-code destructive actions red, add focus indicator, condense navigation hints, visual separators between sections
• ContextMenuOverlay: add j/k/Enter/Esc keyboard hints, destructive actions shown in red, brand color border
• ConfirmOverlay: warning icon header, "cannot be undone" hint, colored button badges, "or Esc to cancel" hint
• FilterOverlay: brand-blue background with search icon, Enter/Esc help text
• LogFilterOverlay: use brand color instead of generic blue
• DetailTabBar: show tab label for single-tab panels, clarify hint to "[/] cycle tabs"
• TabBar: color-code container count badges (green=all running, yellow=partial)
• TooSmallOverlay: show exactly how much wider/taller the terminal needs to be, added branding
• ToastNotification: severity-specific icons, colored background instead of text-only, readable warning contrast
• HelpOverlay: keyboard keys rendered as colored badges, horizontal rule dividers, danger indicators on destructive actions
• VersionOverlay: horizontal rule dividers, brand-blue version text
• SideList empty states: styled no-match indicator, command hints with brand-blue highlight

VS Code Extension¶

• Inject version from package.json at build time instead of hardcoded value

Fixed¶

• bump-version.sh now includes root package.json

[0.1.2] - 2026-03-01¶

Added¶

Log Analytics Engine (sidekick-docker-shared)¶

• Token-level log syntax highlighting — HTTP methods, status codes, URLs, IPs, timestamps, JSON keys, state keywords, and paths each get distinct colors (replaces whole-line severity coloring)
• Log content search and filtering with two modes: exact substring (case-insensitive) and fuzzy (AND-of-words), with match highlighting and match count display
• Severity counting — running tallies of ERROR, WARN, INFO, DEBUG, and OTHER per log stream, displayed as colored badges in the Logs tab header
• Structured log parsing — auto-detects JSON, logfmt, and plain text formats; extracts level, message, timestamp, and structured fields from JSON and logfmt logs
• Severity time-series — 60-bucket ring buffer tracking per-severity counts over time (1-minute buckets), rendered as a color-coded sparkline in the Stats tab
• Log pattern clustering — Drain-like algorithm groups similar log lines into templates with <*> wildcards, displayed in a new Patterns detail tab ranked by frequency

TUI Dashboard¶

• f key opens log filter overlay when viewing the Logs tab (exact/fuzzy mode toggle with Tab, Esc to clear)
• Severity counts header row in Logs tab (E:n W:n I:n D:n, each colored by severity)
• Log severity sparkline in Stats tab below CPU/Memory charts (colored by dominant severity per time bucket)
• New Patterns detail tab on Containers panel showing top log templates with frequency counts

VS Code Extension¶

• Log filter search bar with mode toggle and match count in Logs tab
• Severity count badges in Logs tab header
• New Patterns detail tab with template frequency ranking
• Token-level syntax highlighting CSS classes for all log token types

[0.1.1] - 2026-02-28¶

Added¶

VS Code Extension — Sidebar & Tree View¶

• Activity bar icon with dedicated "Sidekick Docker" view container
• Container tree view grouped by state (Running / Stopped / Other)
• Tree view badge showing running container count
• Inline Start/Stop buttons on container tree items (contextual per state)
• Refresh and Open Dashboard buttons in tree view title bar
• Welcome view with "Open Dashboard" button when no containers are present
• Status bar indicator (right-aligned) showing running/total container counts
• Status bar shows "Docker offline" warning when daemon is unreachable
• Click container in tree to open dashboard focused on that container

VS Code Extension — Quick Pick Commands¶

• Sidekick Docker: Start Container... — pick from stopped containers
• Sidekick Docker: Stop Container... — pick from running containers
• Sidekick Docker: Restart Container... — pick from running containers

VS Code Extension — Stats Sparklines¶

• CPU and memory sparkline charts (Unicode block characters) below progress bars
• History data from StatsCollector (60 samples) sent to webview

Compose Log Streaming¶

• ComposeClient.streamLogs() async generator for real-time compose log streaming
• CLI Services panel now shows live logs (replaces placeholder)
• VS Code Services panel Logs tab with real-time compose log streaming
• Selection-driven streaming: starts on select, stops on deselect

Fixed¶

• Panel tab clicks not working in VS Code webview (mousedown handler was destroying DOM before click fired)
• Double-spaced log lines in VS Code webview (whitespace: pre + display: flex + newline join)

[0.1.0] - 2026-02-28¶

Added¶

Terminal Dashboard (TUI)¶

• Five-panel layout: Containers, Compose Services, Images, Volumes, Networks
• Vi keybindings: j/k navigation, g/G jump, 1-5 panel switch, [/] detail tab cycling
• Context menus with per-resource actions (start, stop, restart, remove, exec, up, down, prune)
• Filter/search with / across all resource lists
• Confirmation modals for all destructive actions (remove, prune)
• Help overlay (?) with full keybinding reference
• Mouse support: click to select, scroll to navigate
• Toast notifications for action feedback
• Expanded layout toggle (z) for detail pane focus

Real-Time Streaming¶

• Live log streaming with stdout/stderr coloring (1000-line ring buffer)
• Stats sparklines for CPU and memory usage (60-sample ring buffer)
• Docker event watching with auto-reconnect on connection loss

Compose Support¶

• Automatic project detection from container labels (com.docker.compose.*)
• Fallback detection via docker compose config
• Merged view showing running containers and planned services
• Per-project actions: up, down, restart, stop

Interactive Exec¶

• Drop into a running container shell via node-pty
• Supports bash, sh, and ash

CLI Commands¶

• sidekick-docker ps — list containers (non-interactive)
• sidekick-docker logs <container> — stream container logs
• --socket <path> flag for custom Docker socket
• --version flag

Docker API Layer (sidekick-docker-shared)¶

• DockerClient facade wrapping dockerode with typed methods
• ComposeDetector for label-based and file-based project discovery
• ComposeClient wrapping docker compose CLI commands
• EventWatcher with auto-reconnect and typed callbacks
• StatsCollector per-container ring buffer with CPU/memory time series
• Full type system: ContainerInfo, ImageInfo, VolumeInfo, NetworkInfo, ComposeProject, DockerEvent, and more
• Utility formatters: formatBytes, formatCpu, stateIcon, stateColor, truncate

VS Code Extension¶

• Webview-based Docker dashboard with the same panel layout as the TUI
• Typed message protocol for extension-to-webview communication
• Command palette integration: Sidekick Docker: Open Dashboard

Build System¶

• tsc for shared library (CommonJS + declarations)
• esbuild for CLI (single ESM binary) and VS Code (dual CJS + IIFE output)
• bump-version.sh script for synchronized version updates across all 3 packages