@tdk-landscape/tdk-cli-core 1.3.120 → 1.3.122

package/cli/dist/commands/ui.js

@@ -1,17 +1,20 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Command } from "commander";
 import { Box, render, Text, useApp, useInput, useStdin, useStdout } from "ink";
-import { useCallback, useEffect, useMemo, useState } from "react";
-import { DetailPanel, FileTree, ResourceSelectInput, ResourceTable, TabBar, TUIHeader, } from "../components/index.js";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { DetailPanel, FileTree, ResourceSelectInput, ResourceTable, ServiceIssues, TabBar, TUIHeader, } from "../components/index.js";
 import { TABS } from "../components/TabBar.js";
 import { createTUITheme, TUIThemeContext, useTUITheme } from "../components/ui-theme.js";
 import { errorFactories, requireProjectRoot } from "../utils/errors.js";
 import { findProjectRoot, getPackageVersion } from "../utils/paths.js";
 import { describeSearch } from "../utils/search-status.js";
 import { clearMetadataCache, discoverResources, discoverStacks, getResourceMetadata, getStackMetadata, } from "../utils/services.js";
+import { singleFlight } from "../utils/single-flight.js";
 import { createStatusMessageController } from "../utils/status-message.js";
 import { getListRowFromMouseY, getTerminalRuleWidth } from "../utils/terminal-layout.js";
 import { isTiltAvailable } from "../utils/tilt.js";
+import { loadTiltEvents, stripTerminalControls, TiltEventsLoadError, } from "../utils/tilt-events.js";
+import { applyServiceStates, fetchServiceStates, } from "../utils/ui-service-state.js";
 // biome-ignore lint/correctness/noUnusedFunctionParameters: reserved callback prop kept in the component API
 const HelpPanel = ({ onClose }) => {
     const theme = useTUITheme();
@@ -42,6 +45,35 @@ const EmptyState = ({ message }) => {
     const theme = useTUITheme();
     return (_jsxs(Box, { flexDirection: "column", padding: 2, alignItems: "center", children: [_jsx(Text, { bold: true, color: theme.warning, children: "No Services Found" }), _jsx(Box, { marginY: 1 }), _jsxs(Text, { color: theme.muted, children: [theme.ascii ? "[*]" : "\u25c9", " No service.json files found"] }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: theme.foreground, children: "To get started:" }), _jsx(Text, { color: theme.foreground, children: " 1. Run: tdk project" }), _jsx(Text, { color: theme.foreground, children: " 2. Run: tdk resource api --type backend" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: theme.accent, children: "Press [r] to refresh or [q] to quit" }), message && (_jsx(Box, { paddingX: 1, height: 1, children: _jsxs(Text, { color: theme.accent, children: [theme.bannerStart, " ", message, " ", theme.bannerEnd] }) }))] }));
 };
+function formatResourceStatus(resource) {
+    const statuses = [];
+    if (resource.runtimeStatus)
+        statuses.push(`Runtime ${resource.runtimeStatus}`);
+    if (resource.updateStatus)
+        statuses.push(`Update ${resource.updateStatus}`);
+    if (resource.hasPendingChanges)
+        statuses.push("Changes pending");
+    return statuses.join("; ") || "No status reported";
+}
+function formatEventTime(value) {
+    if (!value)
+        return "Current";
+    const date = new Date(value);
+    return Number.isNaN(date.getTime())
+        ? value.slice(0, 20)
+        : date
+            .toISOString()
+            .replace("T", " ")
+            .replace(/\.\d{3}Z$/, "Z");
+}
+function formatEventDetails(value, width) {
+    const normalized = stripTerminalControls(value).replace(/\s+/g, " ").trim();
+    const suffix = "...";
+    const maxLength = Math.max(suffix.length + 8, Math.floor(width) - 2);
+    return normalized.length > maxLength
+        ? normalized.slice(0, maxLength - suffix.length).trimEnd() + suffix
+        : normalized;
+}
 export const TUIApp = ({ animated = true }) => {
     const theme = useTUITheme();
     const { exit } = useApp();
@@ -71,10 +103,33 @@ export const TUIApp = ({ animated = true }) => {
     const [error, setError] = useState(null);
     const [showTooltips, setShowTooltips] = useState(true);
     const [showEnabledOnly, setShowEnabledOnly] = useState(true);
+    const [eventSnapshot, setEventSnapshot] = useState(null);
+    const [eventLoadState, setEventLoadState] = useState("idle");
+    const [eventLoadError, setEventLoadError] = useState(null);
+    const eventRequestRef = useRef(0);
     const statusMessage = useMemo(() => createStatusMessageController(setMessage), []);
     useEffect(() => () => statusMessage.dispose(), [statusMessage]);
     const projectRoot = findProjectRoot() || "unknown";
     const [{ stacks, services }, setDiscovered] = useState({ stacks: [], services: [] });
+    // What the running Tilt says about each service: the same answer `tdk status` gives. Empty while no Tilt answers.
+    const [serviceStates, setServiceStates] = useState({});
+    useEffect(() => {
+        let cancelled = false;
+        const tiltPort = Number.parseInt(process.env.TILT_PORT ?? "", 10);
+        // A Tilt call can outlast the 5 s interval; never start a poll while the last one is still running.
+        const run = singleFlight((next) => {
+            if (cancelled)
+                return;
+            setServiceStates((previous) => JSON.stringify(previous) === JSON.stringify(next) ? previous : next);
+        });
+        const poll = () => run(() => fetchServiceStates(services, Number.isInteger(tiltPort) ? tiltPort : 10350));
+        void poll();
+        const timer = setInterval(() => void poll(), 5000);
+        return () => {
+            cancelled = true;
+            clearInterval(timer);
+        };
+    }, [services]);
     // Re-read service.json files from disk. An empty project is not an error:
     // it renders EmptyState. Only a failed discovery shows ErrorScreen.
     const refresh = useCallback(() => {
@@ -92,9 +147,40 @@ export const TUIApp = ({ animated = true }) => {
             setLoading(false);
         }
     }, []);
+    const refreshEvents = useCallback(async () => {
+        const requestId = ++eventRequestRef.current;
+        setEventLoadState("loading");
+        setEventLoadError(null);
+        try {
+            const snapshot = await loadTiltEvents();
+            if (requestId !== eventRequestRef.current)
+                return;
+            setEventSnapshot(snapshot);
+            setEventLoadState("ready");
+        }
+        catch (error) {
+            if (requestId !== eventRequestRef.current)
+                return;
+            setEventSnapshot(null);
+            if (error instanceof TiltEventsLoadError && error.kind === "unavailable") {
+                setEventLoadState("unavailable");
+                return;
+            }
+            setEventLoadError(error instanceof Error ? error.message : String(error));
+            setEventLoadState("error");
+        }
+    }, []);
     useEffect(() => {
         refresh();
     }, [refresh]);
+    useEffect(() => {
+        if (activeTab !== "events")
+            return;
+        void refreshEvents();
+        return () => {
+            eventRequestRef.current += 1;
+        };
+    }, [activeTab, refreshEvents]);
     const selectedStackData = useMemo(() => {
         if (!selectedStack)
             return null;
@@ -103,9 +189,9 @@ export const TUIApp = ({ animated = true }) => {
             return null;
         return {
             stack,
-            metadata: getStackMetadata(stack),
+            metadata: applyServiceStates(getStackMetadata(stack), serviceStates),
         };
-    }, [selectedStack, stacks]);
+    }, [selectedStack, stacks, serviceStates]);
     const selectedServiceData = useMemo(() => {
         if (!selectedService)
             return null;
@@ -367,7 +453,10 @@ export const TUIApp = ({ animated = true }) => {
             return;
         }
         if (input === "r") {
-            if (refresh()) {
+            if (activeTab === "events") {
+                void refreshEvents();
+            }
+            else if (refresh()) {
                 statusMessage.show("Data refreshed", 1500);
             }
             return;
@@ -473,10 +562,14 @@ export const TUIApp = ({ animated = true }) => {
         return _jsx(ErrorScreen, { error: error, onRetry: refresh });
     }
     const header = (_jsxs(_Fragment, { children: [_jsx(TUIHeader, { projectRoot: projectRoot, resourceCount: services.length, terminalWidth: terminalWidth, version: getPackageVersion() }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { color: theme.muted, children: (theme.ascii ? "-" : "\u2500").repeat(getTerminalRuleWidth(terminalWidth)) }) })] }));
-    if (services.length === 0) {
-        return (_jsxs(Box, { flexDirection: "column", height: stdout.rows || 24, children: [header, _jsx(EmptyState, { message: message })] }));
-    }
-    return (_jsxs(Box, { flexDirection: "column", height: stdout.rows || 24, children: [header, isSearching && (_jsxs(Box, { paddingX: 1, height: 1, children: [_jsxs(Text, { color: theme.warning, children: ["Search: ", searchQuery, "_"] }), searchStatus && (_jsx(Text, { color: theme.muted, dimColor: theme.dimMuted, children: `   ${searchStatus.summary}` }))] })), searchStatus?.emptyMessage && (_jsx(Box, { paddingX: 1, height: 1, children: _jsx(Text, { color: theme.muted, children: searchStatus.emptyMessage }) })), !isSearching && message && (_jsx(Box, { paddingX: 1, height: 1, children: _jsxs(Text, { color: theme.accent, children: [theme.bannerStart, " ", message, " ", theme.bannerEnd] }) })), !isSearching && !message && showTooltips && !showHelp && (_jsx(Box, { paddingX: 1, height: 1, children: _jsx(Text, { color: theme.muted, dimColor: theme.dimMuted, children: createHelpHint(activeTab, selectedStack, selectedService, showEnabledOnly, theme.ascii) }) })), showHelp && (_jsx(Box, { paddingX: 1, flexGrow: 1, children: _jsx(HelpPanel, { onClose: () => setShowHelp(false) }) })), !showHelp && (_jsxs(_Fragment, { children: [_jsx(Box, { marginTop: 1, children: _jsx(TabBar, { activeTab: activeTab, onTabChange: setActiveTab, terminalWidth: terminalWidth }) }), _jsxs(Box, { flexDirection: "row", paddingX: 1, flexGrow: 1, children: [_jsxs(Box, { flexDirection: "column", flexGrow: 1, width: mainPanelWidth, children: [activeTab === "overview" && (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Stacks ]" : "┌─ Stacks ─" }) }), _jsx(Box, { marginTop: 1, flexGrow: 1, children: _jsx(ResourceSelectInput, { items: items, onSelect: handleSelect, highlightedIndex: highlightedIndex, isActive: !isSearching, maxVisibleItems: pageSize, width: mainPanelWidth, onLayout: handleListLayout }) })] })), activeTab === "resources" && (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Resources ]" : "┌─ Resources ─" }) }), selectedStackData ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: theme.muted, children: ["Stack: ", selectedStackData.stack.name] }), _jsx(Box, { marginTop: 1, children: _jsx(ResourceTable, { resources: selectedStackData.metadata.resources, maxWidth: terminalWidth - (showSidebar ? 50 : 10) }) })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.muted, children: "Select a stack to view resources" }), _jsx(Box, { marginTop: 1, children: _jsx(ResourceSelectInput, { items: items, onSelect: handleSelect, highlightedIndex: highlightedIndex, isActive: !isSearching, maxVisibleItems: pageSize, width: mainPanelWidth, onLayout: handleListLayout }) })] }))] })), activeTab === "files" && (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Autogenerated Files ]" : "┌─ Autogenerated Files ─" }) }), selectedServiceData ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: theme.muted, children: ["Service: ", selectedServiceData.service.name] }), _jsx(Box, { marginTop: 1, children: _jsx(FileTree, { nodes: fileTreeNodes, selectedPath: selectedFile || undefined }) })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.muted, children: "Select a service to view files" }), _jsx(Box, { marginTop: 1, children: _jsx(ResourceSelectInput, { items: items, onSelect: handleSelect, highlightedIndex: highlightedIndex, isActive: !isSearching, maxVisibleItems: pageSize, width: mainPanelWidth, onLayout: handleListLayout }) })] }))] })), activeTab === "config" && (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Configuration ]" : "┌─ Configuration ─" }) }), selectedServiceData ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.accent, children: selectedServiceData.service.configPath }), _jsx(Box, { marginTop: 1, ...(theme.ascii
+    return (_jsxs(Box, { flexDirection: "column", height: stdout.rows || 24, children: [header, isSearching && (_jsxs(Box, { paddingX: 1, height: 1, children: [_jsxs(Text, { color: theme.warning, children: ["Search: ", searchQuery, "_"] }), searchStatus && (_jsx(Text, { color: theme.muted, dimColor: theme.dimMuted, children: `   ${searchStatus.summary}` }))] })), searchStatus?.emptyMessage && (_jsx(Box, { paddingX: 1, height: 1, children: _jsx(Text, { color: theme.muted, children: searchStatus.emptyMessage }) })), !isSearching && message && (_jsx(Box, { paddingX: 1, height: 1, children: _jsxs(Text, { color: theme.accent, children: [theme.bannerStart, " ", message, " ", theme.bannerEnd] }) })), !isSearching && !message && showTooltips && !showHelp && (_jsx(Box, { paddingX: 1, height: 1, children: _jsx(Text, { color: theme.muted, dimColor: theme.dimMuted, children: createHelpHint(activeTab, selectedStack, selectedService, showEnabledOnly, theme.ascii) }) })), showHelp && (_jsx(Box, { paddingX: 1, flexGrow: 1, children: _jsx(HelpPanel, { onClose: () => setShowHelp(false) }) })), !showHelp && (_jsxs(_Fragment, { children: [_jsx(Box, { marginTop: 1, children: _jsx(TabBar, { activeTab: activeTab, onTabChange: setActiveTab, terminalWidth: terminalWidth }) }), _jsxs(Box, { flexDirection: "row", paddingX: 1, flexGrow: 1, children: [_jsxs(Box, { flexDirection: "column", flexGrow: 1, width: mainPanelWidth, children: [activeTab === "overview" &&
+                                        (services.length === 0 ? (_jsx(EmptyState, { message: message })) : (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: "Stacks" }) }), _jsx(Box, { marginTop: 1, flexGrow: 1, children: _jsx(ResourceSelectInput, { items: items, onSelect: handleSelect, highlightedIndex: highlightedIndex, isActive: !isSearching, maxVisibleItems: pageSize, width: mainPanelWidth, onLayout: handleListLayout }) })] }))), activeTab === "resources" && (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Resources ]" : "┌─ Resources ─" }) }), selectedStackData ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: theme.muted, children: ["Stack: ", selectedStackData.stack.name] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(ResourceTable, { resources: selectedStackData.metadata.resources, maxWidth: terminalWidth - (showSidebar ? 50 : 10) }), _jsx(ServiceIssues, { resources: selectedStackData.metadata.resources })] })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.muted, children: "Select a stack to view resources" }), _jsx(Box, { marginTop: 1, children: _jsx(ResourceSelectInput, { items: items, onSelect: handleSelect, highlightedIndex: highlightedIndex, isActive: !isSearching, maxVisibleItems: pageSize, width: mainPanelWidth, onLayout: handleListLayout }) })] }))] })), activeTab === "files" && (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Autogenerated Files ]" : "┌─ Autogenerated Files ─" }) }), selectedServiceData ? (_jsxs(_Fragment, { children: [_jsxs(Text, { color: theme.muted, children: ["Service: ", selectedServiceData.service.name] }), _jsx(Box, { marginTop: 1, children: _jsx(FileTree, { nodes: fileTreeNodes, selectedPath: selectedFile || undefined }) })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.muted, children: "Select a service to view files" }), _jsx(Box, { marginTop: 1, children: _jsx(ResourceSelectInput, { items: items, onSelect: handleSelect, highlightedIndex: highlightedIndex, isActive: !isSearching, maxVisibleItems: pageSize, width: mainPanelWidth, onLayout: handleListLayout }) })] }))] })), activeTab === "events" && (_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Event Timeline ]" : "┌─ Event Timeline ─" }) }), (eventLoadState === "idle" || eventLoadState === "loading") && (_jsx(Text, { color: theme.muted, children: "Loading Tilt events..." })), eventLoadState === "unavailable" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.warning, children: "Tilt is not running or its UI is unreachable." }), _jsx(Text, { color: theme.muted, children: "Start the stack with tdk up, then press [r] to retry." })] })), eventLoadState === "error" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.error, children: "Could not load Tilt events." }), _jsx(Text, { color: theme.muted, children: formatEventDetails(eventLoadError ?? "Unknown Tilt error", mainPanelWidth) }), _jsx(Text, { color: theme.muted, children: "Press [r] to retry." })] })), eventLoadState === "ready" && (_jsxs(_Fragment, { children: [eventSnapshot && eventSnapshot.resources.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: theme.muted, children: "Current resources" }), eventSnapshot.resources.slice(0, 12).map((resource) => (_jsxs(Text, { color: theme.accent, children: [resource.name, ": ", formatResourceStatus(resource)] }, resource.name))), eventSnapshot.resources.length > 12 && (_jsx(Text, { color: theme.muted, children: "Showing first 12 resources" }))] })), _jsx(Text, { bold: true, color: theme.muted, children: "Recent events" }), eventSnapshot && eventSnapshot.events.length > 20 && (_jsx(Text, { color: theme.muted, children: "Showing first 20 events" })), eventSnapshot?.events.length ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: eventSnapshot.events.slice(0, 20).map((event) => (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Text, { color: event.kind === "failed"
+                                                                        ? theme.error
+                                                                        : event.kind === "warning"
+                                                                            ? theme.warning
+                                                                            : event.kind === "running"
+                                                                                ? theme.info
+                                                                                : theme.success, children: [formatEventTime(event.occurredAt), " ", event.resourceName, " ", event.title] }), event.details && (_jsx(Text, { color: theme.muted, children: formatEventDetails(event.details, mainPanelWidth) }))] }, event.id))) })) : (_jsx(Text, { color: theme.muted, children: "No recent build events are available from Tilt yet." }))] }))] })), activeTab === "config" && (_jsxs(_Fragment, { children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.muted, children: theme.ascii ? "[ Configuration ]" : "┌─ Configuration ─" }) }), selectedServiceData ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.accent, children: selectedServiceData.service.configPath }), _jsx(Box, { marginTop: 1, ...(theme.ascii
                                                             ? {}
                                                             : { borderStyle: "single", borderColor: theme.border }), paddingX: 1, children: _jsx(Text, { color: theme.muted, wrap: "wrap", children: JSON.stringify(selectedServiceData.service.config, null, 2).slice(0, 1000) }) })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.muted, children: "Select a service to view configuration" }), _jsx(Box, { marginTop: 1, children: _jsx(ResourceSelectInput, { items: items, onSelect: handleSelect, highlightedIndex: highlightedIndex, isActive: !isSearching, maxVisibleItems: pageSize, width: mainPanelWidth, onLayout: handleListLayout }) })] }))] }))] }), showSidebar && (_jsx(Box, { marginLeft: 2, children: _jsx(DetailPanel, { stack: selectedStackData?.stack || null, service: selectedServiceData?.service || null, stackMetadata: selectedStackData?.metadata || null, visible: !!selectedStack || !!selectedService }) }))] }), _jsxs(Box, { ...(theme.ascii ? {} : { borderStyle: "single", borderColor: theme.border }), paddingX: 1, height: 3, flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { color: theme.accent, bold: true, children: [theme.bannerStart, " ", activeTab] }), _jsxs(Text, { color: theme.success, children: [theme.ascii ? "[+]" : "\u25cf", " ", services.filter((s) => s.stack).length, " in stack"] }), _jsxs(Text, { color: theme.warning, children: [theme.ascii ? "-" : "\u25cb", " ", services.filter((s) => !s.stack).length, " no stack"] })] }), _jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { color: theme.muted, children: ["Stacks: ", stacks.length] }), _jsxs(Text, { color: theme.muted, children: ["Services: ", services.length] }), _jsxs(Text, { color: theme.muted, children: [theme.ascii ? "Mouse" : "🖱️", " ", mouseEnabled ? "ON" : "OFF", theme.ascii ? " | " : " \u2502 ", theme.ascii ? "Info" : "ℹ️", " ", showTooltips ? "ON" : "OFF", theme.ascii ? " | " : " \u2502 ", _jsx(Text, { color: showEnabledOnly ? theme.success : theme.warning, children: showEnabledOnly
                                                     ? theme.ascii
@@ -508,6 +601,9 @@ function createHelpHint(activeTab, selectedStack, selectedService, showEnabledOn
     if (activeTab === "files") {
         return ["Select service to view files", ...common].join(separator);
     }
+    if (activeTab === "events") {
+        return ["[r] Refresh events", "[Tab] Next", "[?] help", "[q] Quit"].join(separator);
+    }
     if (activeTab === "config") {
         return ["View configurations", ...common].join(separator);
     }

package/cli/dist/commands/up.js

@@ -5,23 +5,28 @@ import { Command } from "commander";
 import { ensureProjectRuntimeAssets, ProjectConfigNotFoundError, verifyMasterConfigs, } from "../generator/template-engine.js";
 import { DEVCONTAINER_DOCKER_FIX, detectHost, isContainerHost, WEBCONTAINER_UP_MESSAGE, } from "../utils/agent-host.js";
 import { handleDryRun } from "../utils/command-helpers.js";
-import { getDeferredResourceNames } from "../utils/doctor-runtime.js";
+import { STANDARD_PORTS } from "../utils/constants.js";
+import { getDeferredResourceNames, summarizeTiltBuildError } from "../utils/doctor-runtime.js";
 import { completeEnvFile } from "../utils/env-validator.js";
 import { errorFactories, handleTiltFailure, requireProjectRoot, runCommand, showErrorAndExit, withTiltCheck, } from "../utils/errors.js";
 import { formatCount } from "../utils/formatting.js";
 import { exportHostPortPlan, getHostPortPlan, writeSavedHostPortPlan, } from "../utils/host-port-config.js";
 import { formatHostPortPlan } from "../utils/host-port-plan.js";
 import { createJsonEmitter } from "../utils/json-output.js";
+import { toMachineError } from "../utils/machine-output.js";
 import { findProjectRoot, getPackageVersion } from "../utils/paths.js";
 import { findAvailablePort } from "../utils/port-assignment.js";
+import { formatPortFallbackNotice } from "../utils/port-fallback-notice.js";
 import { isApiServiceType } from "../utils/resource-kind.js";
+import { enforceServiceConfigGate, warnSchemaVersions } from "../utils/service-config-checks.js";
 import { appendHealthPath, resolveSubdomainBases } from "../utils/service-urls.js";
 import { discoverResources, discoverResourcesStrict, discoverStacks, stackExists, } from "../utils/services.js";
 import { buildSmokePlans, formatSmokeFailure, runSmokePlans } from "../utils/smoke.js";
+import { buildStartupReport, formatStartupReport, isStartupStalled, } from "../utils/startup-report.js";
 import { evaluateTdkVersionFloor } from "../utils/tdk-version.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 { parseTiltPort, resolveTiltPort, secondUpAction, 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";
@@ -183,18 +188,34 @@ export const upCommand = new Command("up")
         const foundRoot = options.dryRun ? requireProjectRoot() : findProjectRoot();
         const projectRoot = foundRoot ?? process.cwd();
         const discoveredResources = discoverResourcesStrict();
+        let discoveredStacks;
+        let discoveredStackNames = [];
+        if (!options.only || stackName) {
+            discoveredStacks = discoverStacks(discoveredResources);
+            discoveredStackNames = discoveredStacks.map((stack) => stack.name);
+        }
         // Reject a bad request before anything below can write to the project (.env, runtime assets, .tdk/project.json).
         if (options.only) {
-            if (stackName && !stackExists(stackName))
-                errorFactories.stackNotFound(stackName).exit();
+            if (stackName && !stackExists(stackName)) {
+                const error = errorFactories.stackNotFound(stackName, discoveredStackNames);
+                emit?.({ ok: false }, [toMachineError(error).error]);
+                error.exit();
+            }
             const candidates = stackName
                 ? discoveredResources.filter((resource) => resource.stack === stackName)
                 : discoveredResources;
             const unknown = findUnknownServices(options.only, candidates);
             if (unknown.length > 0) {
-                const message = `Unknown service ${unknown.join(", ")}. Valid names: ${candidates.map((s) => s.name).join(", ")}`;
-                emit?.({ ok: false }, [{ code: "UNKNOWN_SERVICE", message }]);
-                showErrorAndExit(message, 2);
+                const validNames = candidates.map((service) => service.name);
+                const error = errorFactories.unknownServices(unknown, validNames);
+                emit?.({ ok: false }, [
+                    {
+                        code: "UNKNOWN_SERVICE",
+                        message: error.message,
+                        ...(error.suggestions.length > 0 ? { suggestions: error.suggestions } : {}),
+                    },
+                ]);
+                error.exit();
             }
         }
         // Also under --dry-run: the check only reads, and a dry run should show what a real run would refuse.
@@ -204,6 +225,15 @@ export const upCommand = new Command("up")
                 onDrift: (message) => emit?.({ ok: false }, [{ code: "DRIFT_DETECTED", message }]),
             });
         }
+        // Duplicate names, circular dependsOn and invalid ports are refused before anything starts, dry run included.
+        if (foundRoot) {
+            enforceServiceConfigGate(foundRoot, {
+                onInvalid: (message) => emit?.({ ok: false }, [{ code: "INVALID_SERVICE_CONFIG", message }]),
+            });
+        }
+        // A project without schemaVersion keeps working; say how to add it, but only where a person is reading.
+        if (foundRoot && !emit && !options.quiet)
+            warnSchemaVersions(foundRoot);
         const hostPortPlan = await getHostPortPlan(projectRoot, {
             inspectDocker: !options.dryRun,
         });
@@ -231,14 +261,16 @@ export const upCommand = new Command("up")
         if (stackName) {
             servicesToStart = discoveredResources.filter((resource) => resource.stack === stackName);
             if (servicesToStart.length === 0) {
-                errorFactories.stackNotFound(stackName).exit();
+                const error = errorFactories.stackNotFound(stackName, discoveredStackNames);
+                emit?.({ ok: false }, [toMachineError(error).error]);
+                error.exit();
             }
             focusServiceNames = servicesToStart.map((s) => s.name);
             stackDescription = `stack "${stackName}"`;
         }
         else {
             servicesToStart = discoveredResources;
-            const allStacks = discoverStacks(discoveredResources);
+            const allStacks = discoveredStacks ?? discoverStacks(discoveredResources);
             stackDescription = `all stacks (${formatCount(allStacks.length, "stack")}, ${formatCount(servicesToStart.length, "service")})`;
         }
         let dependencyNames = [];
@@ -292,6 +324,8 @@ export const upCommand = new Command("up")
         const dryRunCommand = focusTargets ? `tilt up ${tiltArgs.join(" ")}` : "tilt up";
         if (!options.quiet) {
             console.log(chalk.blue(formatHostPortPlan(hostPortPlan)));
+            for (const line of formatPortFallbackNotice(hostPortPlan))
+                console.log(chalk.yellow(line));
             console.log(chalk.gray("Override with TDK_HTTP_PORT, TDK_HTTPS_PORT, or TDK_POSTGRES_PORT."));
         }
         if (emit && options.dryRun) {
@@ -312,24 +346,36 @@ export const upCommand = new Command("up")
         }
         exportHostPortPlan(hostPortPlan);
         writeSavedHostPortPlan(projectRoot, hostPortPlan);
-        const basePort = 10350;
-        // 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.
+        const basePort = STANDARD_PORTS.tiltUi;
+        const watchedPort = configuredTiltPort ?? basePort;
+        const candidatePorts = options.only ? [...new Set([basePort, watchedPort])] : [watchedPort];
+        const running = [];
+        for (const candidate of candidatePorts) {
+            if ((await tiltGetUiResources(candidate)) !== null)
+                running.push(candidate);
+        }
+        const decision = secondUpAction({
+            runningPorts: running,
+            force: options.force,
+            only: Boolean(options.only),
+        });
+        if (decision.action === "already-running") {
+            const message = `Environment is already running on port ${decision.ports.join(", ")}.`;
+            emit?.({
+                ok: true,
+                alreadyRunning: true,
+                tiltUrl: `http://localhost:${decision.ports[0]}`,
+            });
+            if (!options.quiet)
+                console.log(chalk.green(message));
+            return;
+        }
+        if (decision.action === "only-blocked") {
+            const message = `A Tilt is already running on port ${decision.ports.join(", ")}. --only cannot change a running stack's services: run \`tdk down\` first, or pass --force to replace it.`;
+            emit?.({ ok: false }, [{ code: "TILT_ALREADY_RUNNING", message }]);
+            showErrorAndExit(message);
+        }
         if (options.only) {
-            const candidatePorts = [
-                ...new Set([basePort, ...(configuredTiltPort === undefined ? [] : [configuredTiltPort])]),
-            ];
-            const running = [];
-            for (const candidate of candidatePorts) {
-                if ((await tiltGetUiResources(candidate)) !== null)
-                    running.push(candidate);
-            }
-            if (running.length > 0 && !options.force) {
-                const message = `A Tilt is already running on port ${running.join(", ")}. --only cannot change a running stack's services: run \`tdk down\` first, or pass --force to replace it.`;
-                emit?.({ ok: false }, [{ code: "TILT_ALREADY_RUNNING", message }]);
-                showErrorAndExit(message);
-            }
             for (const runningPort of running)
                 stopTiltOnPort(runningPort);
         }
@@ -364,6 +410,7 @@ export const upCommand = new Command("up")
         const smokePlans = buildSmokePlans(servicesToStart, hostPortPlan.ingressHttp);
         let smokeFailed = false;
         let printedSuccess = false;
+        let startupFailed = false;
         const successOutput = (async () => {
             const uiReady = await waitForTiltUi(port);
             // JSON consumers get success only after every non-deferred resource is built and running, not when the UI port opens.
@@ -399,12 +446,39 @@ export const upCommand = new Command("up")
                     ]);
                 }
             }
-            if (uiReady && !options.quiet) {
+            // The UI port opening only means Tilt started. Say "up" once every resource is built and running, and otherwise name
+            // what failed and what it blocks.
+            if (uiReady && !emit) {
+                const deferred = getDeferredResourceNames();
+                const dependsOn = Object.fromEntries(discoverResources().map((r) => [r.name, r.config?.dependsOn ?? []]));
+                const readiness = await waitForTiltResourcesReady(port, {
+                    deferred,
+                    isStalled: (text) => isStartupStalled(text, dependsOn, deferred),
+                });
+                if (!readiness.ready) {
+                    startupFailed = true;
+                    const resourcesJson = await tiltGetUiResources(port);
+                    const report = resourcesJson
+                        ? buildStartupReport(resourcesJson, dependsOn, deferred)
+                        : {
+                            failed: readiness.failures.map((failure) => ({
+                                name: failure.name,
+                                message: summarizeTiltBuildError(failure.message),
+                            })),
+                            blocked: [],
+                            starting: [],
+                        };
+                    for (const line of formatStartupReport(report, readiness.timedOut)) {
+                        console.error(chalk.red(line));
+                    }
+                }
+            }
+            if (uiReady && !options.quiet && !startupFailed) {
                 for (const line of formatUpSuccess(port))
                     console.log(chalk.blue(line));
                 printedSuccess = true;
             }
-            if (uiReady && smokePlans.length > 0 && (!emit || jsonReady)) {
+            if (uiReady && smokePlans.length > 0 && (emit ? jsonReady : !startupFailed)) {
                 if (!options.quiet) {
                     console.log(chalk.gray(`Smoke check: ${smokePlans.map((p) => p.name).join(", ")}`));
                 }
@@ -446,6 +520,9 @@ export const upCommand = new Command("up")
         if (result.exitCode !== 0) {
             handleTiltFailure("up", result.exitCode);
         }
+        if (startupFailed && result.exitCode === 0) {
+            process.exit(1);
+        }
         if (!options.quiet && result.exitCode === 0 && !printedSuccess) {
             for (const line of formatUpSuccess(port))
                 console.log(chalk.blue(line));

package/cli/dist/components/ServiceIssues.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { useTUITheme } from "./ui-theme.js";
+/** One line per service that is not ready and has a reason, so a failed dependency is named on screen. */
+export function ServiceIssues({ resources }) {
+    const theme = useTUITheme();
+    const issues = resources.filter((r) => r.status !== "ready" && r.statusReason);
+    if (issues.length === 0)
+        return null;
+    return (_jsx(Box, { flexDirection: "column", marginTop: 1, children: issues.map((resource) => (_jsxs(Text, { color: theme.muted, children: [resource.name, ": ", resource.statusReason] }, resource.name))) }));
+}
+//# sourceMappingURL=ServiceIssues.js.map

package/cli/dist/components/TabBar.js

@@ -5,8 +5,9 @@ import { useTUITheme } from "./ui-theme.js";
 export const TABS = [
     { id: "overview", label: "OVERVIEW", shortcut: "1" },
     { id: "resources", label: "RESOURCES", shortcut: "2" },
-    { id: "files", label: "FILES", shortcut: "3" },
-    { id: "config", label: "CONFIG", shortcut: "4" },
+    { id: "events", label: "EVENTS", shortcut: "3" },
+    { id: "files", label: "FILES", shortcut: "4" },
+    { id: "config", label: "CONFIG", shortcut: "5" },
 ];
 export const TabBar = ({ activeTab, compact = false, terminalWidth }) => {
     const theme = useTUITheme();

package/cli/dist/components/index.js

@@ -3,6 +3,7 @@ export { DetailPanel } from "./DetailPanel.js";
 export { FileTree } from "./FileTree.js";
 export { ResourceSelectInput } from "./ResourceSelectInput.js";
 export { ResourceTable } from "./ResourceTable.js";
+export { ServiceIssues } from "./ServiceIssues.js";
 export { TabBar } from "./TabBar.js";
 export { TOOLTIPS } from "./Tooltip.js";
 export { TUIHeader } from "./TUIHeader.js";

package/cli/dist/generator/__tests__/golden-helpers.js

@@ -0,0 +1,42 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const normalize = (text) => text.replace(/\r\n/g, "\n");
+export const UPDATE_COMMAND = "UPDATE_GOLDEN=1 bun run test -- golden-generated-output";
+/**
+ * Compares generated files with the committed golden copies in `goldenDir`. Returns one problem per file that
+ * changed, is missing a golden, or has a golden nothing generates any more. With `update` it rewrites the goldens
+ * instead and returns nothing, which is how an intentional change is accepted.
+ */
+export function compareWithGolden(actual, goldenDir, update = false) {
+    if (update) {
+        for (const [name, content] of Object.entries(actual)) {
+            const target = join(goldenDir, name);
+            mkdirSync(dirname(target), { recursive: true });
+            writeFileSync(target, normalize(content));
+        }
+        for (const stale of staleGoldens(actual, goldenDir)) {
+            rmSync(join(goldenDir, stale), { force: true });
+        }
+        return [];
+    }
+    const problems = [];
+    for (const [name, content] of Object.entries(actual)) {
+        const path = join(goldenDir, name);
+        if (!existsSync(path)) {
+            problems.push(`${name}: no golden file yet`);
+        }
+        else if (normalize(readFileSync(path, "utf-8")) !== normalize(content)) {
+            problems.push(`${name}: generated output differs from its golden file`);
+        }
+    }
+    for (const stale of staleGoldens(actual, goldenDir)) {
+        problems.push(`${stale}: golden file that nothing generates any more`);
+    }
+    return problems;
+}
+function staleGoldens(actual, goldenDir) {
+    if (!existsSync(goldenDir))
+        return [];
+    return readdirSync(goldenDir).filter((name) => !(name in actual));
+}
+//# sourceMappingURL=golden-helpers.js.map

package/cli/dist/generator/template-engine.js

@@ -3,6 +3,7 @@ import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import Handlebars from "handlebars";
 import { PLATFORM_STANDARDS } from "../config/platform-standards.js";
+import { writeTextFileAtomic } from "../utils/atomic-write.js";
 import { writeTextFile } from "../utils/file-helpers.js";
 import { assertTdkGeneratedPath } from "../utils/generated-paths.js";
 import { DEFAULT_ALWAYS_ENABLED_INFRA } from "../utils/project-config-defaults.js";
@@ -220,6 +221,7 @@ export function generateDatabaseManagementCompose(projectConfig) {
 # SYSTEM-GENERATED - DO NOT EDIT
 # Stack feature: database-management
 # Source: .tdk/project.json phases.*.enabledStacks includes "database-management"
+# Regenerate with: tdk config regenerate
 ###############################################################################
 
 services:
@@ -232,7 +234,7 @@ services:
       POSTGRES_PASSWORD: \${DB_PASSWORD}
       POSTGRES_DB: postgres
     ports:
-      - "\${TDK_POSTGRES_PORT:-15432}:5432"
+      - "\${TDK_BIND_ADDRESS:-127.0.0.1}:\${TDK_POSTGRES_PORT:-15432}:5432"
     volumes:
       - ${name}_postgres_data:/var/lib/postgresql/data
     networks:
@@ -443,14 +445,14 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
     for (const filename of ALL_GENERATED_FILES) {
         const content = files[filename];
         const filePath = assertTdkGeneratedPath(projectRoot, path.join(".tdk", ".tdk-out", filename));
-        writeTextFile(filePath, content);
+        writeTextFileAtomic(filePath, content);
         console.log(`✓ Generated: .tdk/.tdk-out/${filename}`);
     }
     if (isStackFeatureEnabledInStacks(projectConfig.phases, "database-management")) {
         const composePath = assertTdkGeneratedPath(projectRoot, path.join("services", "platform", "database-management", "docker-compose.yml"));
         const composeDir = path.dirname(composePath);
         fs.mkdirSync(composeDir, { recursive: true });
-        writeTextFile(composePath, generateDatabaseManagementCompose(projectConfig));
+        writeTextFileAtomic(composePath, generateDatabaseManagementCompose(projectConfig));
         console.log("✓ Generated: services/platform/database-management/docker-compose.yml");
     }
     // Copy .tiltignore to project root so Tilt uses it

package/cli/dist/utils/atomic-write.js

@@ -0,0 +1,35 @@
+import { randomBytes } from "node:crypto";
+import { closeSync, fchmodSync, fsyncSync, openSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { basename, dirname, join } from "node:path";
+/**
+ * Replaces `filePath` in one step. A plain writeFileSync truncates first, so an interrupt mid-write leaves a
+ * half-written file that looks current; here readers see the old content or the new content, never a mix.
+ */
+export function writeTextFileAtomic(filePath, content) {
+    const tempPath = join(dirname(filePath), `.${basename(filePath)}.${process.pid}.${randomBytes(4).toString("hex")}.tmp`);
+    let mode;
+    try {
+        mode = statSync(filePath).mode & 0o777;
+    }
+    catch {
+        mode = undefined;
+    }
+    try {
+        const fd = openSync(tempPath, "wx");
+        try {
+            if (mode !== undefined)
+                fchmodSync(fd, mode);
+            writeFileSync(fd, content, "utf-8");
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+        renameSync(tempPath, filePath);
+    }
+    catch (error) {
+        rmSync(tempPath, { force: true });
+        throw error;
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/cli/dist/utils/bun-floor.js

@@ -0,0 +1,8 @@
+import { MIN_BUN_VERSION, versionMeetsMinimum } from "../commands/doctor.js";
+/** The Bun floor `tdk doctor` enforces, so `tdk up` cannot drift from it. */
+export function bunMeetsFloor(version) {
+    return versionMeetsMinimum(version, MIN_BUN_VERSION);
+}
+/** "1.2+" for a floor of 1.2.0, the wording the preflight already printed. */
+export const BUN_FLOOR_LABEL = `${MIN_BUN_VERSION[0]}.${MIN_BUN_VERSION[1]}+`;
+//# sourceMappingURL=bun-floor.js.map

package/cli/dist/utils/cold-preflight.js

@@ -2,6 +2,7 @@ import { execFileSync } from "node:child_process";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { checkDockerCompose, checkDockerRuntime, checkDockerVersions, checkTilt, } from "../commands/doctor.js";
+import { BUN_FLOOR_LABEL, bunMeetsFloor } from "./bun-floor.js";
 import { checkNatsBroker } from "./doctor-wiring.js";
 import { getHostPortPlan } from "./host-port-config.js";
 import { findProjectRoot } from "./paths.js";
@@ -86,8 +87,7 @@ export async function runColdPreflight(opts = {}) {
                 encoding: "utf-8",
                 timeout: 3000,
             }).trim();
-            const [major = 0, minor = 0] = version.split(".").map((part) => Number.parseInt(part, 10));
-            bun = major > 1 || (major === 1 && minor >= 2);
+            bun = bunMeetsFloor(version);
         }
         catch {
             /* reported as a failed runtime check */
@@ -96,7 +96,9 @@ export async function runColdPreflight(opts = {}) {
     items.push({
         id: "bun",
         ok: bun,
-        message: bun ? "Bun 1.2+ is available on PATH" : "Bun 1.2+ not found on PATH",
+        message: bun
+            ? `Bun ${BUN_FLOOR_LABEL} is available on PATH`
+            : `Bun ${BUN_FLOOR_LABEL} not found on PATH`,
         fix: bun ? undefined : "curl -fsSL https://bun.sh/install | bash",
     });
     try {
@@ -157,7 +159,7 @@ export async function runColdPreflight(opts = {}) {
     const header = failures.length
         ? machineFailed
             ? bunFailed
-                ? "Cold start blocked. Bun 1.2+ must be installed on PATH.\nPrisma/NATS configuration is project-specific and generated after `tdk project`. Fix the machine checks below."
+                ? `Cold start blocked. Bun ${BUN_FLOOR_LABEL} must be installed on PATH.\nPrisma/NATS configuration is project-specific and generated after \`tdk project\`. Fix the machine checks below.`
                 : "Cold start blocked. Bun/Prisma/NATS are not the first failure.\nThey are generated after `tdk project`. Fix the machine checks below."
             : "Machine is ready. Project wiring is not."
         : "";