@tdk-landscape/tdk-cli-core 1.3.105 → 1.3.107

package/CHANGELOG.md

@@ -4,6 +4,7 @@ Notable changes to the `tdk` CLI. Versions match [npm](https://www.npmjs.com/pac
 
 ## Unreleased
 
+- `tdk doctor` warns when a backend or worker applies database migrations from its own start-up (a `start`/`dev` script, a Dockerfile `CMD`/`ENTRYPOINT`, a shell entrypoint or its source: Prisma, Drizzle, Knex, TypeORM, MikroORM, Sequelize, dbmate, Atlas, Alembic). It is a warning, not a failure: such services work, but migrations belong in a `migrator` resource that runs once before the services that depend on it. `migrator` and bring-your-own resources are not checked.
 - Go services can opt in to a live development loop with `"dev": { "liveReload": true }` in `service.json`: edits are copied into the running container and recompiled without an image rebuild, while `go.mod`, `go.sum` and the generated Dockerfile still rebuild the image. The watcher compiles into a staging binary while the old build keeps serving and swaps only on success, so a compile error shows in the Tilt log and the last good build keeps answering (Air, tried first, stopped the app before compiling and left it down for the whole compile; in 2 of 6 edits a Traefik health check then returned 503 for 10 s). Measured on one loaded Mac: median edit-to-ready 1.63 s for the scaffold. The default Go image (`golang:1.23`) now sets `GOTOOLCHAIN=auto`, so a `go.mod` that needs a newer Go, such as Gin 1.12 (`go 1.25`), downloads that toolchain instead of stopping with `requires go >= 1.25`. Offline or air-gapped builds of a go.mod newer than 1.23 still fail, but now at the toolchain download rather than at the version check. `scripts/e2e/go-dev-loop.sh` checks all of this through a real `tdk up`. Refs #369.
 - `tdk up` keeps each smoke step's status and response body under `.tdk/smoke/<service>/<step>/` (`latest.json` and `body.txt`, body capped at 64 KiB), plus `last-success.json` and `last-success-body.txt` that a later failure never overwrites, so a regression can be diffed against the last good response. The failure line ends with the record path, and `tdk project` gitignores `.tdk/smoke/`. A new `smoke-e2e` workflow runs `scripts/verify-smoke.sh` and uploads the records. Before its first step a smoke check now waits for the service's health path (`healthCheckPath`, default `/health` for backends) with GETs until it answers something other than a connection error, 404 or 5xx, so a write is no longer the first request to hit a service that is still building; write retry rules are unchanged.
 - Add an opt-in Python backend: `tdk resource <name> --type backend --language python` scaffolds a FastAPI service (`pyproject.toml`, `src/main.py`, a pytest smoke test) and TDK generates its Docker image (`python:3.12-slim`, with `test` and `production` stages). The choice is saved as `language` in `service.json` only when you pass the flag; omitting it keeps the existing Bun + Hono output byte for byte. Unknown ids and `--language` on non-backend types fail before any file is written. A runnable example is in `examples/one-backend-python`, and the provider contract is in `docs/backend-language-providers.md`. Node.js is not included.

package/cli/dist/cli.js

@@ -9,7 +9,9 @@ import { downCommand } from "./commands/down.js";
 import { ejectCommand } from "./commands/eject.js";
 import { showHelp } from "./commands/help.js";
 import { importCommand } from "./commands/import.js";
+import { logsCommand } from "./commands/logs.js";
 import { maintainersCommand } from "./commands/maintainers.js";
+import { mcpCommand } from "./commands/mcp.js";
 import { networksCommand } from "./commands/networks.js";
 import { projectCommand } from "./commands/project.js";
 import { projectsCommand } from "./commands/projects.js";
@@ -46,6 +48,8 @@ program.addCommand(resourcesCommand);
 program.addCommand(projectsCommand);
 program.addCommand(upCommand);
 program.addCommand(downCommand);
+program.addCommand(mcpCommand);
+program.addCommand(logsCommand);
 program.addCommand(ejectCommand);
 program.addCommand(importCommand);
 program.addCommand(statusCommand);

package/cli/dist/commands/completion.js

@@ -11,7 +11,7 @@ _tdk_completions() {
     prev="\${COMP_WORDS[COMP_CWORD-1]}"
     
     # Main commands
-    local commands="project projects stack stacks resource resources up down status ui doctor runtime version completion help upgrade"
+    local commands="project projects stack stacks resource resources up down status ui doctor runtime version completion help upgrade mcp logs eject import config maintainers networks traefik"
     
     # Options for specific commands
     case "\${prev}" in
@@ -142,6 +142,14 @@ _tdk_commands() {
         'version:Show version'
         'upgrade:Upgrade TDK CLI'
         'completion:Generate shell completions'
+        'mcp:Run a Model Context Protocol server over stdio for coding agents'
+        'logs:Print a bounded snapshot of recent logs from the running stack'
+        'eject:Take ownership of the generated Tilt and Docker files'
+        'import:Import the services a directory describes (runs tdk-import)'
+        'config:Manage project configuration and regenerate master files'
+        'maintainers:Maintainer file checks'
+        'networks:Show Traefik-routed URLs for all services'
+        'traefik:Show Traefik-routed URLs for all services'
         'help:Show help'
     )
     _describe -t commands 'tdk command' commands
@@ -187,6 +195,14 @@ complete -c tdk -n '__fish_use_subcommand' -a 'runtime' -d 'Inspect packaged run
 complete -c tdk -n '__fish_use_subcommand' -a 'version' -d 'Show version'
 complete -c tdk -n '__fish_use_subcommand' -a 'upgrade' -d 'Upgrade TDK CLI'
 complete -c tdk -n '__fish_use_subcommand' -a 'completion' -d 'Generate shell completions'
+complete -c tdk -n '__fish_use_subcommand' -a 'mcp' -d 'Run a Model Context Protocol server over stdio for coding agents'
+complete -c tdk -n '__fish_use_subcommand' -a 'logs' -d 'Print a bounded snapshot of recent logs from the running stack'
+complete -c tdk -n '__fish_use_subcommand' -a 'eject' -d 'Take ownership of the generated Tilt and Docker files'
+complete -c tdk -n '__fish_use_subcommand' -a 'import' -d 'Import the services a directory describes (runs tdk-import)'
+complete -c tdk -n '__fish_use_subcommand' -a 'config' -d 'Manage project configuration and regenerate master files'
+complete -c tdk -n '__fish_use_subcommand' -a 'maintainers' -d 'Maintainer file checks'
+complete -c tdk -n '__fish_use_subcommand' -a 'networks' -d 'Show Traefik-routed URLs for all services'
+complete -c tdk -n '__fish_use_subcommand' -a 'traefik' -d 'Show Traefik-routed URLs for all services'
 complete -c tdk -n '__fish_use_subcommand' -a 'help' -d 'Show help'
 
 # Global options

package/cli/dist/commands/doctor.js

@@ -9,7 +9,7 @@ import { MASTER_CONFIG_FILES, REQUIRED_PACKAGE_SCRIPTS } from "../utils/constant
 import { isPathDiscovered, readDiscoveryPaths } from "../utils/discovery-paths.js";
 import { collectDoctorChecks, createDoctorReport, getDoctorExitCode, } from "../utils/doctor-report.js";
 import { checkHealthRoutes, checkIngressPorts, checkPrivateNpmRegistry, checkTiltResourceHealth, projectConfigEnablesVerdaccio, summarizeServiceProbes, } from "../utils/doctor-runtime.js";
-import { checkDockerNetworkCapacity, checkFrontendBackendUrls, checkNatsBroker, checkResourcePackageJson, checkServiceUrlPorts, checkTiltInstances, } from "../utils/doctor-wiring.js";
+import { checkDockerNetworkCapacity, checkFrontendBackendUrls, checkMigrationsInApi, checkNatsBroker, checkResourcePackageJson, checkServiceUrlPorts, checkTiltInstances, } from "../utils/doctor-wiring.js";
 import { validateEnvFile } from "../utils/env-validator.js";
 import { execAsync, isExecTimeout } from "../utils/exec-async.js";
 import { formatCount } from "../utils/formatting.js";
@@ -1106,6 +1106,7 @@ export const doctorCommand = new Command("doctor")
         () => checkServiceUrlPorts(),
         () => checkFrontendBackendUrls(),
         () => checkNatsBroker(),
+        () => checkMigrationsInApi(),
         () => checkTiltInstances(),
         checkEnvironmentVariables,
         // Preflight: Verdaccio down causes ImageBuild bun install ConnectionRefused.

package/cli/dist/commands/logs.js

@@ -0,0 +1,85 @@
+import { Command } from "commander";
+import { STANDARD_PORTS } from "../utils/constants.js";
+import { runCommand, showErrorAndExit } from "../utils/errors.js";
+import { createMachineEnvelope } from "../utils/machine-output.js";
+import { isTiltAvailable, runTilt } from "../utils/tilt.js";
+import { DEFAULT_LOG_TAIL, isTiltConnectionFailure, isValidPort, isValidSince, isValidTail, MAX_LOG_TAIL, parseTiltLogLines, } from "../utils/tilt-logs.js";
+/** Resource names Tilt knows about, or null when they cannot be listed (the logs call then reports the real error). */
+async function tiltResourceNames(port) {
+    try {
+        const result = await runTilt("get", ["uiresources", "-o", "json", "--port", port], {
+            inheritStdio: false,
+        });
+        if (result.exitCode !== 0)
+            return null;
+        const items = JSON.parse(result.stdout)
+            .items;
+        return (items ?? []).flatMap((item) => (item.metadata?.name ? [item.metadata.name] : []));
+    }
+    catch {
+        return null;
+    }
+}
+export const logsCommand = new Command("logs")
+    .description("Print a bounded snapshot of recent logs from the running stack")
+    .option("-s, --service <names...>", "Only these services (Tilt resource names)")
+    .option("--tail <n>", "Number of most recent lines to return", String(DEFAULT_LOG_TAIL))
+    .option("--since <duration>", "Only logs newer than this duration, for example 30s, 5m, 1h")
+    .option("--port <n>", "Tilt UI port (default: TILT_PORT or 10350)")
+    .option("--json", "Output one JSON object and exit", false)
+    .action(async (options) => {
+    const fail = (code, message, exitCode = 1) => {
+        if (options.json) {
+            console.log(JSON.stringify(createMachineEnvelope(null, [{ code, message }])));
+            console.error(message);
+            process.exit(exitCode);
+        }
+        return showErrorAndExit(message, exitCode);
+    };
+    if (!isValidTail(options.tail))
+        fail("USAGE", `--tail must be an integer from 1 to ${MAX_LOG_TAIL}`, 2);
+    if (options.since !== undefined && !isValidSince(options.since)) {
+        fail("USAGE", "--since must be a duration such as 30s, 5m or 1h", 2);
+    }
+    const portText = options.port ?? process.env.TILT_PORT ?? String(STANDARD_PORTS.tiltUi);
+    if (!isValidPort(portText))
+        fail("USAGE", "--port must be a valid port number", 2);
+    const tail = Number(options.tail);
+    const services = options.service ?? [];
+    const action = async () => {
+        if (!(await isTiltAvailable())) {
+            fail("TILT_MISSING", "Tilt is not installed. Run: tdk doctor");
+        }
+        if (services.length > 0) {
+            const known = await tiltResourceNames(portText);
+            const unknown = services.filter((name) => known && !known.includes(name));
+            if (unknown.length > 0) {
+                fail("UNKNOWN_SERVICE", `Unknown service ${unknown.join(", ")}. Valid names: ${(known ?? []).join(", ")}`, 2);
+            }
+        }
+        const args = ["--port", portText, "--tail", String(tail)];
+        if (options.since !== undefined)
+            args.push("--since", options.since);
+        if (options.json)
+            args.push("--json");
+        // `--` so a service name that starts with "-" is never read as a Tilt flag.
+        if (services.length > 0)
+            args.push("--", ...services);
+        const result = await runTilt("logs", args, { inheritStdio: false });
+        if (result.exitCode !== 0) {
+            const detail = result.stderr.trim();
+            if (!detail || isTiltConnectionFailure(detail)) {
+                fail("TILT_NOT_RUNNING", `Could not reach Tilt on port ${portText}: ${detail || "is the stack running? Start it with: tdk up"}`);
+            }
+            fail("TILT_LOGS_FAILED", `tilt logs failed: ${detail}`);
+        }
+        if (!options.json) {
+            process.stdout.write(result.stdout);
+            return;
+        }
+        const lines = parseTiltLogLines(result.stdout, tail);
+        console.log(JSON.stringify(createMachineEnvelope({ services, tail, since: options.since ?? null, lines })));
+    };
+    await runCommand(action);
+});
+//# sourceMappingURL=logs.js.map

package/cli/dist/commands/mcp.js

@@ -0,0 +1,24 @@
+import { createInterface } from "node:readline";
+import { Command } from "commander";
+import { createMcpServer } from "../mcp/server.js";
+import { createTdkTools } from "../mcp/tools.js";
+import { getPackageVersion } from "../utils/paths.js";
+export const mcpCommand = new Command("mcp")
+    .description("Run a Model Context Protocol server over stdio for coding agents")
+    .action(async () => {
+    const server = createMcpServer(createTdkTools(), { name: "tdk", version: getPackageVersion() });
+    // Stdout is the protocol channel. Nothing else may write to it; diagnostics go to stderr.
+    const lines = createInterface({ input: process.stdin });
+    const pending = new Set();
+    lines.on("line", (line) => {
+        const task = server.handleLine(line).then((response) => {
+            if (response)
+                process.stdout.write(`${response}\n`);
+        });
+        pending.add(task);
+        void task.finally(() => pending.delete(task));
+    });
+    await new Promise((resolve) => lines.once("close", resolve));
+    await Promise.allSettled(pending);
+});
+//# sourceMappingURL=mcp.js.map

package/cli/dist/commands/projects.js

@@ -4,21 +4,42 @@ import chalk from "chalk";
 import { Command } from "commander";
 import { MASTER_CONFIG_FILES } from "../utils/constants.js";
 import { createDiscoveryContext } from "../utils/discovery-context.js";
-import { requireProjectRoot, runCommand } from "../utils/errors.js";
+import { errorFactories, requireProjectRoot, runCommand } from "../utils/errors.js";
 import { formatCount } from "../utils/formatting.js";
+import { createMachineEnvelope, writeMachineError } from "../utils/machine-output.js";
+import { findProjectRoot } from "../utils/paths.js";
 export const projectsCommand = new Command("projects")
     .description("Show project information and configuration status")
     .alias("info")
     .option("--check", "Check if project is properly configured", false)
+    .option("--json", "Output a versioned JSON response")
     .action(async (options) => {
-    await runCommand(async () => {
-        const projectRoot = requireProjectRoot();
+    const action = async () => {
+        const projectRoot = options.json ? findProjectRoot() : requireProjectRoot();
+        if (!projectRoot) {
+            throw errorFactories.notInProject();
+        }
+        const outDir = join(projectRoot, ".tdk", ".tdk-out");
+        const missing = MASTER_CONFIG_FILES.filter((file) => !existsSync(join(outDir, file)));
+        if (options.json) {
+            const discovery = createDiscoveryContext();
+            console.log(JSON.stringify(createMachineEnvelope({
+                projectRoot,
+                configured: missing.length === 0,
+                missingFiles: missing,
+                resources: discovery.resources.length,
+                stacks: discovery.stackNames,
+                unassignedResources: discovery.unassignedResources.length,
+            }), null, 2));
+            if (options.check) {
+                process.exitCode = missing.length === 0 ? 0 : 1;
+            }
+            return;
+        }
         console.log(chalk.blue("Project Information\n"));
         console.log(chalk.bold("Project Root:"));
         console.log(chalk.gray(`  ${projectRoot}`));
         console.log();
-        const outDir = join(projectRoot, ".tdk", ".tdk-out");
-        const missing = MASTER_CONFIG_FILES.filter((file) => !existsSync(join(outDir, file)));
         console.log(chalk.bold("Master Configuration:"));
         if (missing.length === 0) {
             for (const file of MASTER_CONFIG_FILES) {
@@ -66,6 +87,16 @@ export const projectsCommand = new Command("projects")
         if (options.check) {
             process.exit(missing.length === 0 ? 0 : 1);
         }
-    });
+    };
+    if (options.json) {
+        try {
+            await action();
+        }
+        catch (error) {
+            writeMachineError(error);
+        }
+        return;
+    }
+    await runCommand(action);
 });
 //# sourceMappingURL=projects.js.map

package/cli/dist/commands/resources.js

@@ -23,6 +23,7 @@ export const resourcesCommand = new Command("resources")
             requireProjectRoot();
         }
         const discovery = createDiscoveryContext();
+        const withoutStackFilter = options.noStack || options.stack === false;
         let resources = discovery.resources;
         if (options.stack) {
             resources = discovery.resourcesByStack.get(options.stack) || [];
@@ -31,7 +32,7 @@ export const resourcesCommand = new Command("resources")
                 return;
             }
         }
-        if (options.noStack) {
+        if (withoutStackFilter) {
             resources = discovery.unassignedResources;
             if (resources.length === 0 && !options.json) {
                 showAllSatisfyCondition("resources", "assigned to a stack");
@@ -85,7 +86,7 @@ export const resourcesCommand = new Command("resources")
         const withoutStackCount = options.stack
             ? resources.filter((r) => !r.stack).length
             : discovery.unassignedResources.length;
-        if (withoutStackCount > 0 && !options.noStack && !options.stack) {
+        if (withoutStackCount > 0 && !withoutStackFilter && !options.stack) {
             console.log(chalk.yellow(`\n${formatCount(withoutStackCount, "resource")} not assigned to any stack.`));
             showDetail('Run "tdk resources --no-stack" to see them, or "tdk stack" to assign them.');
         }

package/cli/dist/commands/stacks.js

@@ -3,19 +3,36 @@ import { Command } from "commander";
 import { createDiscoveryContext } from "../utils/discovery-context.js";
 import { runCommand } from "../utils/errors.js";
 import { formatCount, showDetail, showEmptyState, showStep } from "../utils/formatting.js";
+import { createMachineEnvelope, writeMachineError } from "../utils/machine-output.js";
+import { findProjectRoot } from "../utils/paths.js";
 export const stacksCommand = new Command("stacks")
     .description("List all stacks and their resources")
     .alias("ls") // Keep 'tdk ls' as shorthand
     .option("-v, --verbose", "Show detailed information about each stack", false)
     .option("--services", "Include list of services in each stack", false)
+    .option("--json", "Output a versioned JSON stack report", false)
     .action(async (options) => {
-    await runCommand(async () => {
+    const action = async () => {
+        if (options.json && !findProjectRoot()) {
+            writeMachineError(new Error("Could not find project root (no .tdk/project.json found)"));
+        }
         const discovery = createDiscoveryContext();
+        const verbose = options.verbose || stacksCommand.parent?.opts().verbose === true;
+        if (options.json) {
+            const stacks = discovery.stacks.map((stack) => ({
+                name: stack.name,
+                resourceCount: stack.resourceCount,
+                ...(verbose ? { description: stack.description } : {}),
+                ...(options.services ? { services: stack.resources.map((service) => service.name) } : {}),
+            }));
+            console.log(JSON.stringify(createMachineEnvelope({ stacks })));
+            return;
+        }
         if (discovery.stackNames.length === 0) {
             showEmptyState("stacks");
             return;
         }
-        if (options.verbose || options.services) {
+        if (verbose || options.services) {
             showStep(`Found ${formatCount(discovery.stacks.length, "stack")}:\n`);
             for (const stack of discovery.stacks) {
                 console.log(chalk.bold(`${stack.name}`));
@@ -38,6 +55,16 @@ export const stacksCommand = new Command("stacks")
             }
             showDetail("\nRun with --verbose for more details, or --services to see all services in each stack.", 0);
         }
-    });
+    };
+    if (options.json) {
+        try {
+            await action();
+        }
+        catch (error) {
+            writeMachineError(error);
+        }
+        return;
+    }
+    await runCommand(action);
 });
 //# sourceMappingURL=stacks.js.map

package/cli/dist/commands/status.js

@@ -1,6 +1,7 @@
 import chalk from "chalk";
 import { Command } from "commander";
 import { createDiscoveryContext } from "../utils/discovery-context.js";
+import { getDeferredResourceNames } from "../utils/doctor-runtime.js";
 import { runCommand } from "../utils/errors.js";
 import { formatCount, showDetail, showStep } from "../utils/formatting.js";
 import { getHostPortPlan } from "../utils/host-port-config.js";
@@ -8,6 +9,7 @@ import { createMachineEnvelope, writeMachineError } from "../utils/machine-outpu
 import { findProjectRoot } from "../utils/paths.js";
 import { buildServicePorts, buildStackPorts } from "../utils/status-ports.js";
 import { getTiltfilePath, isTiltAvailable, runTilt } from "../utils/tilt.js";
+import { evaluateTiltReadiness, tiltGetUiResources } from "../utils/up-readiness.js";
 export const statusCommand = new Command("status")
     .description("Show status of resources and stacks")
     .option("--json", "Output a versioned JSON status report", false)
@@ -53,6 +55,21 @@ export const statusCommand = new Command("status")
                 queryError = result.stderr || "Could not retrieve Tilt resource status";
             }
         }
+        // A single look at the running Tilt, so a caller that started `tdk up` detached can poll for readiness. Null when no
+        // Tilt answers or its output cannot be read.
+        let readiness = null;
+        if (options.json && tiltAvailable) {
+            const port = Number.parseInt(process.env.TILT_PORT ?? "", 10);
+            const text = await tiltGetUiResources(Number.isInteger(port) ? port : 10350);
+            if (text) {
+                try {
+                    readiness = evaluateTiltReadiness(text, getDeferredResourceNames()).result;
+                }
+                catch {
+                    readiness = null;
+                }
+            }
+        }
         if (options.json) {
             let portPlan = null;
             try {
@@ -68,6 +85,7 @@ export const statusCommand = new Command("status")
                     available: tiltAvailable,
                     resourcesQueried: options.tilt && tiltAvailable,
                     resources: tiltResources,
+                    readiness,
                 },
                 resources: discovery.resources.map((resource) => ({
                     name: resource.name,

package/cli/dist/commands/ui.js

@@ -6,6 +6,7 @@ import { DetailPanel, FileTree, ResourceSelectInput, ResourceTable, TabBar, } fr
 import { errorFactories, requireProjectRoot } from "../utils/errors.js";
 import { findProjectRoot } from "../utils/paths.js";
 import { clearMetadataCache, discoverResources, discoverStacks, getResourceMetadata, getStackMetadata, } from "../utils/services.js";
+import { createStatusMessageController } from "../utils/status-message.js";
 import { isTiltAvailable } from "../utils/tilt.js";
 // biome-ignore lint/correctness/noUnusedFunctionParameters: reserved callback prop kept in the component API
 const HelpPanel = ({ onClose }) => (_jsxs(Box, { borderStyle: "single", borderColor: "cyan", paddingX: 2, paddingY: 1, flexDirection: "column", width: 60, children: [_jsx(Text, { bold: true, color: "cyan", children: "Keyboard Shortcuts" }), _jsxs(Box, { marginY: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, underline: true, children: "Navigation" }), _jsx(Text, { children: " \u2191/\u2193 Navigate list items" }), _jsx(Text, { children: " Enter Select item / Open detail" }), _jsx(Text, { children: " Space Toggle expand (tree view)" }), _jsx(Text, { children: " Tab Next tab" }), _jsx(Text, { children: " 1-5 Direct tab access" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, underline: true, children: "Actions" }) }), _jsx(Text, { children: " m Toggle mouse support" }), _jsx(Text, { children: " t Toggle tooltips" }), _jsx(Text, { children: " e Toggle enabled/disabled services" }), _jsx(Text, { children: " r Refresh data" }), _jsx(Text, { children: " / Search/filter" }), _jsx(Text, { children: " ? Show this help" }), _jsx(Text, { children: " q Quit \u2502 Esc Back" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: "Press any key to close..." }) })] }));
@@ -32,6 +33,8 @@ const TUIApp = () => {
     const [error, setError] = useState(null);
     const [showTooltips, setShowTooltips] = useState(true);
     const [showEnabledOnly, setShowEnabledOnly] = useState(true);
+    const statusMessage = useMemo(() => createStatusMessageController(setMessage), []);
+    useEffect(() => () => statusMessage.dispose(), [statusMessage]);
     const projectRoot = findProjectRoot() || "unknown";
     const [{ stacks, services }, setDiscovered] = useState({ stacks: [], services: [] });
     // Re-read service.json files from disk. An empty project is not an error:
@@ -158,14 +161,12 @@ const TUIApp = () => {
         if (activeTab === "overview") {
             setSelectedStack(item.value);
             setSelectedService(null);
-            setMessage(`Selected stack: ${item.value}`);
-            setTimeout(() => setMessage(""), 2000);
+            statusMessage.show(`Selected stack: ${item.value}`, 2000);
         }
         else if (activeTab === "resources") {
             if (selectedStack && !selectedService) {
                 setSelectedService(item.value);
-                setMessage(`Selected service: ${item.value}`);
-                setTimeout(() => setMessage(""), 2000);
+                statusMessage.show(`Selected service: ${item.value}`, 2000);
             }
             else {
                 setSelectedStack(item.value);
@@ -175,21 +176,18 @@ const TUIApp = () => {
         else if (activeTab === "files") {
             if (selectedService) {
                 setSelectedFile(item.value);
-                setMessage(`Selected file: ${item.label}`);
-                setTimeout(() => setMessage(""), 2000);
+                statusMessage.show(`Selected file: ${item.label}`, 2000);
             }
             else {
                 setSelectedService(item.value);
-                setMessage(`Selected service: ${item.value}`);
-                setTimeout(() => setMessage(""), 2000);
+                statusMessage.show(`Selected service: ${item.value}`, 2000);
             }
         }
         else if (activeTab === "config") {
             setSelectedService(item.value);
-            setMessage(`Viewing config for: ${item.value}`);
-            setTimeout(() => setMessage(""), 2000);
+            statusMessage.show(`Viewing config for: ${item.value}`, 2000);
         }
-    }, [activeTab, selectedStack, selectedService]);
+    }, [activeTab, selectedStack, selectedService, statusMessage]);
     useEffect(() => {
         setRawMode(true);
         stdout.write("\x1b[?1000h");
@@ -297,8 +295,7 @@ const TUIApp = () => {
                 setSelectedStack(null);
                 return;
             }
-            setMessage("Press q to quit");
-            setTimeout(() => setMessage(""), 2000);
+            statusMessage.show("Press q to quit", 2000);
             return;
         }
         if (input === "?") {
@@ -307,8 +304,7 @@ const TUIApp = () => {
         }
         if (input === "r") {
             if (refresh()) {
-                setMessage("Data refreshed");
-                setTimeout(() => setMessage(""), 1500);
+                statusMessage.show("Data refreshed", 1500);
             }
             return;
         }
@@ -321,28 +317,25 @@ const TUIApp = () => {
         if (input === "m") {
             setMouseEnabled((prev) => {
                 const newState = !prev;
-                setMessage(newState ? "Mouse support enabled" : "Mouse support disabled");
+                statusMessage.show(newState ? "Mouse support enabled" : "Mouse support disabled");
                 return newState;
             });
-            setTimeout(() => setMessage(""), 1500);
             return;
         }
         if (input === "t") {
             setShowTooltips((prev) => {
                 const newState = !prev;
-                setMessage(newState ? "Tooltips enabled" : "Tooltips disabled");
+                statusMessage.show(newState ? "Tooltips enabled" : "Tooltips disabled");
                 return newState;
             });
-            setTimeout(() => setMessage(""), 1500);
             return;
         }
         if (input === "e") {
             setShowEnabledOnly((prev) => {
                 const newState = !prev;
-                setMessage(newState ? "Showing enabled services only" : "Showing all services (including disabled)");
+                statusMessage.show(newState ? "Showing enabled services only" : "Showing all services (including disabled)", 1500);
                 return newState;
             });
-            setTimeout(() => setMessage(""), 1500);
             return;
         }
         if (key.tab) {