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

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/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) {

package/cli/dist/commands/up.js

@@ -20,6 +20,7 @@ import { discoverResources, discoverResourcesStrict, discoverStacks, stackExists
 import { buildSmokePlans, formatSmokeFailure, runSmokePlans } from "../utils/smoke.js";
 import { buildTiltUpArgs, runTilt } from "../utils/tilt.js";
 import { stopTiltOnPort } from "../utils/tilt-process.js";
+import { parseTiltPort, resolveTiltPort, stopTiltForUp } from "../utils/tilt-startup.js";
 import { findUnknownServices, resolveOnlySelection } from "../utils/up-only.js";
 import { tiltGetUiResources, waitForTiltResourcesReady } from "../utils/up-readiness.js";
 import { enableDiscoveredStacks } from "./project.js";
@@ -89,6 +90,12 @@ export const upCommand = new Command("up")
     const emit = options.json ? createJsonEmitter("UP_FAILED", "tdk up") : undefined;
     if (options.json)
         options.quiet = true;
+    const portSetting = parseTiltPort(process.env.TILT_PORT);
+    if (!portSetting.ok) {
+        emit?.({ ok: false }, [{ code: "INVALID_TILT_PORT", message: portSetting.message }]);
+        showErrorAndExit(portSetting.message);
+    }
+    const configuredTiltPort = portSetting.port;
     const hostRefusal = options.dryRun ? null : await hostUpRefusal();
     if (hostRefusal) {
         emit?.({ ok: false }, [{ code: "HOST_UNSUPPORTED", message: hostRefusal }]);
@@ -229,14 +236,12 @@ export const upCommand = new Command("up")
         exportHostPortPlan(hostPortPlan);
         writeSavedHostPortPlan(projectRoot, hostPortPlan);
         const basePort = 10350;
-        let port = basePort;
         // A second Tilt would apply a different selection to the same containers, whatever port it listens on, so `--only`
         // looks for a Tilt that answers on the default port and on TILT_PORT before it chooses one. A listener that is not
         // Tilt does not count: the port is then picked below as usual.
         if (options.only) {
-            const envPort = process.env.TILT_PORT ? Number.parseInt(process.env.TILT_PORT, 10) : NaN;
             const candidatePorts = [
-                ...new Set([basePort, ...(Number.isInteger(envPort) ? [envPort] : [])]),
+                ...new Set([basePort, ...(configuredTiltPort === undefined ? [] : [configuredTiltPort])]),
             ];
             const running = [];
             for (const candidate of candidatePorts) {
@@ -251,27 +256,23 @@ export const upCommand = new Command("up")
             for (const runningPort of running)
                 stopTiltOnPort(runningPort);
         }
-        if (process.env.TILT_PORT) {
-            port = parseInt(process.env.TILT_PORT, 10);
-        }
-        else if (!options.force) {
-            const availablePort = await findAvailablePort(basePort, 10);
-            if (availablePort && availablePort !== basePort) {
-                port = availablePort;
-                if (!options.quiet) {
-                    console.log(chalk.yellow(`⚠️  Port ${basePort} is already in use`));
-                    console.log(chalk.blue(`🔄 Auto-switching to port ${port}\n`));
-                }
-            }
+        const resolution = await resolveTiltPort({
+            configuredPort: configuredTiltPort,
+            force: options.force,
+            basePort,
+            findAvailablePort,
+        });
+        const port = resolution.port;
+        if (resolution.autoSwitched && !options.quiet) {
+            console.log(chalk.yellow(`⚠️  Port ${basePort} is already in use`));
+            console.log(chalk.blue(`🔄 Auto-switching to port ${port}\n`));
         }
         process.env.TILT_PORT = port.toString();
-        if (options.force) {
-            if (!options.quiet) {
-                console.log(chalk.yellow(`Force flag set - stopping Tilt on port ${port} if running...`));
-            }
-            stopTiltOnPort(port);
-            await new Promise((resolve) => setTimeout(resolve, 2000));
-        }
+        await stopTiltForUp({ force: options.force, quiet: options.quiet, port }, {
+            stop: stopTiltOnPort,
+            log: (message) => console.log(chalk.yellow(message)),
+            wait: (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)),
+        });
         if (!options.quiet) {
             console.log(chalk.gray("\nRunning tilt up..."));
             console.log(chalk.gray(`Using Tiltfile: .tdk/.tdk-out/Tiltfile`));

package/cli/dist/utils/status-message.js

@@ -0,0 +1,22 @@
+export function createStatusMessageController(setMessage) {
+    let timer;
+    return {
+        show(message, durationMs = 1500) {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            setMessage(message);
+            timer = setTimeout(() => {
+                timer = undefined;
+                setMessage("");
+            }, durationMs);
+        },
+        dispose() {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+        },
+    };
+}
+//# sourceMappingURL=status-message.js.map

package/cli/dist/utils/tilt-startup.js

@@ -0,0 +1,35 @@
+import { isValidPort } from "./validation.js";
+export function parseTiltPort(value) {
+    if (value === undefined || value === "")
+        return { ok: true, port: undefined };
+    const port = Number(value);
+    if (!/^[0-9]+$/.test(value) || !isValidPort(port)) {
+        return {
+            ok: false,
+            message: `Invalid TILT_PORT "${value}": expected an integer from 1 to 65535.`,
+        };
+    }
+    return { ok: true, port };
+}
+export async function resolveTiltPort(options) {
+    if (options.configuredPort !== undefined) {
+        return { port: options.configuredPort, autoSwitched: false };
+    }
+    if (options.force)
+        return { port: options.basePort, autoSwitched: false };
+    const availablePort = await options.findAvailablePort(options.basePort, 10);
+    if (availablePort && availablePort !== options.basePort) {
+        return { port: availablePort, autoSwitched: true };
+    }
+    return { port: options.basePort, autoSwitched: false };
+}
+export async function stopTiltForUp(options, dependencies) {
+    if (!options.force)
+        return;
+    if (!options.quiet) {
+        dependencies.log(`Force flag set - stopping Tilt on port ${options.port} if running...`);
+    }
+    dependencies.stop(options.port);
+    await dependencies.wait(2000);
+}
+//# sourceMappingURL=tilt-startup.js.map

package/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tdk-cli-internal",
   "private": true,
-  "version": "1.3.106",
+  "version": "1.3.107",
   "description": "TDK CLI — start services on your laptop.",
   "keywords": [
     "tdk",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.106",
+  "version": "1.3.107",
   "description": "TDK CLI — start services on your laptop.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {