recomposable 1.0.2 → 1.1.1

package/README.md

@@ -2,6 +2,8 @@
 
 A lightweight Docker Compose TUI manager with vim keybindings. Monitor service status, restart or rebuild containers, and tail logs — all from your terminal.
 
+Eliminate switching between countless terminal tabs or windows to rebuild you docker compose containers.
+
 Zero dependencies. Pure Node.js.
 
 ![recomposable list view](screenshots/list-view.png)
@@ -36,16 +38,36 @@ recomposable
 
 - **Multi-file support** — manage services across multiple compose files, grouped by file
 - **Live status** — polls container state, health, build and restart times
+- **CPU/Memory monitoring** — live CPU% and memory usage per container, with configurable color thresholds
+- **Port mappings** — shows published ports for each service
 - **Log pattern scanning** — counts WRN/ERR (configurable) occurrences across all services
-- **Inline log panel** — tail logs for the selected service without leaving the list view
-- **Full log view** — scrollable full-screen log viewer with live auto-scroll
-- **Rebuild & restart** — trigger `docker compose up -d --build` or `restart` per service
+- **Inline log panel** — tail logs for the selected service without leaving the list view, with search (`/`)
+- **Full log view** — scrollable full-screen log viewer with live auto-scroll and search (`/`, `n`/`N`)
+- **Start / Stop / Restart / Rebuild** — full container lifecycle management per service
+- **No cache mode** — toggle to force a full clean rebuild (`--no-cache` + `--force-recreate`), off by default
+- **Docker Compose Watch** — toggle `docker compose watch` per service, with live output in the log panel
+- **Dependency-aware rebuild** — rebuild a service then automatically restart all its transitive dependents in topological order
+- **Container exec** — run commands inside any container, inline in the bottom panel (`e`) or full-screen (`x`), with `cd` support and command history
 - **Vim keybindings** — navigate with `j`/`k`, `G`/`gg`, and more
 
 ## Full Log View
 
 ![recomposable full logs view](screenshots/logs-view.png)
 
+## Exec Mode
+
+Run commands inside any running container without leaving the TUI. Press `e` for inline exec in the bottom panel, or `x` for full-screen exec. `cd` works — the working directory is tracked across commands.
+
+![recomposable exec view](screenshots/exec-view.png)
+
+## Docker Compose Watch
+
+Press `w` to toggle `docker compose watch` for a service. A cyan `W` indicator appears next to watched services, and watch output streams to the inline log panel. Requires Docker Compose v2.22+.
+
+## Dependency-Aware Rebuild
+
+Press `d` to rebuild the selected service and then automatically restart all services that depend on it (transitively), in the correct topological order. Progress is shown step-by-step in the log panel. If the service has no dependents, falls back to a regular rebuild.
+
 ## Adding Compose Files
 
 Create a `recomposable.json` file in your project root:
@@ -54,9 +76,7 @@ Create a `recomposable.json` file in your project root:
 {
   "composeFiles": [
     "docker-compose.yml"
-  ],
-  "pollInterval": 3000,
-  "logTailLines": 100
+  ]
 }
 ```
 
@@ -87,34 +107,81 @@ recomposable -f docker-compose.yml -f docker-compose.prod.yml
 |---|---|---|
 | `composeFiles` | `[]` | Array of docker-compose file paths (relative to `recomposable.json`) |
 | `pollInterval` | `3000` | Status polling interval in milliseconds |
-| `logTailLines` | `100` | Number of log lines to show when entering log view |
+| `logTailLines` | `100` | Number of log lines to show when entering full log view |
 | `logScanPatterns` | `["WRN]", "ERR]"]` | Patterns to count in container logs |
 | `logScanLines` | `1000` | Number of log lines to scan for pattern counts |
 | `logScanInterval` | `10000` | Pattern scanning interval in milliseconds |
+| `bottomLogCount` | `10` | Number of log lines shown in the inline log panel |
+| `statsInterval` | `5000` | CPU/memory polling interval in milliseconds |
+| `statsBufferSize` | `6` | Number of samples for rolling average (e.g. 6 x 5s = 30s window) |
+| `cpuWarnThreshold` | `50` | CPU % above which the column turns yellow |
+| `cpuDangerThreshold` | `100` | CPU % above which the column turns red |
+| `memWarnThreshold` | `512` | Memory in MB above which the column turns yellow |
+| `memDangerThreshold` | `1024` | Memory in MB above which the column turns red |
 
 ## Keybindings
 
+### List view
+
 | Key | Action |
 |---|---|
 | `j` / `Down` | Move cursor down |
 | `k` / `Up` | Move cursor up |
-| `s` | Restart selected service |
-| `r` | Rebuild selected service (`up -d --build`) |
+| `s` | Start (if stopped) or restart (if running) |
+| `p` | Stop selected service |
+| `b` | Rebuild selected service (`up -d --build`) |
+| `d` | Dependency-aware rebuild (rebuild + restart all dependents) |
+| `w` | Toggle Docker Compose Watch for selected service |
+| `e` | Inline exec in bottom panel |
+| `x` | Full-screen exec mode |
+| `n` | Toggle no-cache mode (rebuild with `--no-cache` + `--force-recreate`) |
 | `f` / `Enter` | Full-screen log view for selected service |
 | `l` | Toggle inline log panel |
+| `/` | Search in inline log panel |
 | `G` | Jump to bottom |
 | `gg` | Jump to top |
-| `Esc` | Exit log view |
 | `q` | Quit |
 
+### Full log view
+
+| Key | Action |
+|---|---|
+| `j` / `Down` | Scroll down |
+| `k` / `Up` | Scroll up |
+| `Ctrl+D` | Page down |
+| `Ctrl+U` | Page up |
+| `G` | Jump to bottom (live mode) |
+| `gg` | Jump to top |
+| `/` | Search logs |
+| `n` | Next search match |
+| `N` | Previous search match |
+| `Esc` / `f` | Exit log view |
+| `q` | Quit |
+
+### Exec mode (inline & full-screen)
+
+| Key | Action |
+|---|---|
+| Type | Enter commands |
+| `Enter` | Execute command |
+| `Up` / `Down` | Navigate command history |
+| `x` | Expand inline exec to full screen |
+| `Ctrl+C` | Kill running command (double to quit) |
+| `Esc` | Exit exec mode |
+
 ## Status Icons
 
 | Icon | Meaning |
 |---|---|
 | Green circle | Running (healthy) |
 | Red circle | Running (unhealthy) |
-| Yellow circle | Rebuilding / Restarting |
+| Yellow circle | Rebuilding / Restarting / Starting / Stopping |
 | Gray circle | Stopped |
+| Cyan `W` | Docker Compose Watch active |
+
+## Todo
+
+- Log search should search all container logs, not only the lines currently tailed by the tool
 
 ## Requirements
 

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import type { Config, AppState, ServiceGroup } from './lib/types';
+export interface ModuleState {
+    logScanActive: boolean;
+    statsPollActive: boolean;
+    lastRenderTime: number;
+    pendingRender: ReturnType<typeof setTimeout> | null;
+    logFetchTimer: ReturnType<typeof setTimeout> | null;
+}
+export declare function createModuleState(): ModuleState;
+export declare function loadConfig(): Config;
+export declare function discoverServices(config: Config): ServiceGroup[];
+export declare function pollStatuses(state: AppState): void;
+export declare function pollLogCounts(state: AppState): void;
+export declare function pollContainerStats(state: AppState): void;
+export declare function render(state: AppState): void;
+export declare function stripAnsi(str: string): string;
+export declare function throttledRender(state: AppState): void;
+export declare function updateSelectedLogs(state: AppState): void;
+export declare function doRebuild(state: AppState): void;
+export declare function doRestart(state: AppState): void;
+export declare function doStop(state: AppState): void;
+export declare function doStart(state: AppState): void;
+export declare function doWatch(state: AppState): void;
+export declare function initDepGraphs(state: AppState): void;
+export declare function doCascadeRebuild(state: AppState): void;
+export declare function enterExecInline(state: AppState): void;
+export declare function enterExec(state: AppState): void;
+export declare function exitExec(state: AppState): void;
+export declare function runExecCommand(state: AppState): void;
+export declare function enterLogs(state: AppState): void;
+export declare function exitLogs(state: AppState): void;
+export declare function executeLogSearch(state: AppState): void;
+export declare function jumpToNextMatch(state: AppState): void;
+export declare function jumpToPrevMatch(state: AppState): void;
+export declare function handleKeypress(state: AppState, key: string): void;
+export declare function createInputHandler(state: AppState): (data: Buffer | string) => void;
+export declare function cleanup(state: AppState): void;
+export declare function _getModuleState(): ModuleState;
+export declare function _setModuleState(ms: ModuleState): void;