@tdk-landscape/tdk-cli-core 1.3.143 → 1.3.145

package/cli/dist/commands/doctor.js

@@ -10,6 +10,7 @@ import { DEVCONTAINER_DOCKER_FIX, detectHost, isContainerHost, WEBCONTAINER_DOCS
 import { projectNeedsBun } from "../utils/bun-requirement.js";
 import { AUTOGENERATED_DIR, CONTAINER_RUNTIME_CHECK, MASTER_CONFIG_FILES, PACKAGE_JSON, REQUIRED_PACKAGE_SCRIPTS, } from "../utils/constants.js";
 import { isPathDiscovered, readDiscoveryPaths } from "../utils/discovery-paths.js";
+import { checkDiskSpace, dockerDesktopStuck } from "../utils/doctor-host.js";
 import { collectDoctorChecks, createDoctorReport, getDoctorExitCode, } from "../utils/doctor-report.js";
 import { checkHealthRoutes, checkIngressPorts, checkPrivateNpmRegistry, checkTiltResourceHealth, projectConfigEnablesVerdaccio, summarizeServiceProbes, } from "../utils/doctor-runtime.js";
 import { checkStarlarkLoadExports } from "../utils/doctor-starlark.js";
@@ -202,6 +203,10 @@ export async function checkDockerRuntime() {
             };
         }
     }
+    // Docker Desktop open but its engine down or stuck: say so instead of "not running".
+    const stuck = dockerDesktopStuck(await succeeds("pgrep -f com.docker.backend"));
+    if (stuck)
+        return stuck;
     // Docker not running: check for Colima, then Podman
     if (await succeeds("colima status")) {
         return {
@@ -1026,6 +1031,7 @@ export const doctorCommand = new Command("doctor")
                 message: "Ingress port plan is unavailable",
             },
         checkDockerRuntime,
+        () => checkDiskSpace(),
         checkDockerOperatingSystem,
         checkTilt,
         checkDockerCompose,

package/cli/dist/commands/status.js

@@ -11,7 +11,8 @@ import { createMachineEnvelope, writeMachineError } from "../utils/machine-outpu
 import { findProjectRoot } from "../utils/paths.js";
 import { deriveServiceStates } from "../utils/service-runtime-state.js";
 import { buildServicePorts, buildStackPorts } from "../utils/status-ports.js";
-import { getTiltfilePath, isTiltAvailable, runTilt } from "../utils/tilt.js";
+import { isTiltAvailable, runTilt } from "../utils/tilt.js";
+import { getTiltPollingPort } from "../utils/tilt-startup.js";
 import { evaluateTiltReadiness, tiltGetUiResources } from "../utils/up-readiness.js";
 export const statusCommand = new Command("status")
     .description("Show status of resources and stacks")
@@ -42,30 +43,28 @@ export const statusCommand = new Command("status")
         }
         let tiltResources = null;
         let queryError = null;
-        if (options.json && options.tilt && tiltAvailable) {
-            const result = await runTilt("get", ["-f", getTiltfilePath(), "resources", "--output=json"], {
-                inheritStdio: false,
-            });
-            if (result.exitCode === 0) {
-                try {
-                    tiltResources = JSON.parse(result.stdout);
-                }
-                catch (error) {
-                    queryError = `Tilt returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`;
-                }
-            }
-            else {
-                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;
         // The same look at Tilt feeds readiness and each service's state, so `tdk status` and `tdk ui` cannot disagree.
         let serviceStates = null;
+        const tiltPort = getTiltPollingPort(process.env.TILT_PORT);
         if (tiltAvailable) {
-            const port = Number.parseInt(process.env.TILT_PORT ?? "", 10);
-            const text = await tiltGetUiResources(Number.isInteger(port) ? port : 10350);
+            const text = await tiltGetUiResources(tiltPort);
+            // `tilt get` has no -f flag; resources come from the running Tilt's API on its port, the same source as readiness.
+            if (options.json && options.tilt) {
+                if (text) {
+                    try {
+                        tiltResources = JSON.parse(text);
+                    }
+                    catch (error) {
+                        queryError = `Tilt returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`;
+                    }
+                }
+                else {
+                    queryError = `No Tilt is answering on port ${tiltPort}. Start it with: tdk up`;
+                }
+            }
             if (text) {
                 const deferred = getDeferredResourceNames();
                 try {
@@ -115,7 +114,7 @@ export const statusCommand = new Command("status")
                         ? { blockedBy: serviceStates[resource.name]?.blockedBy }
                         : {}),
                 })),
-                ports: buildStackPorts(portPlan, process.env.TILT_PORT ? Number.parseInt(process.env.TILT_PORT, 10) : undefined),
+                ports: buildStackPorts(portPlan, tiltPort),
                 stacks: discovery.stacks.map((stack) => ({
                     name: stack.name,
                     resourceCount: stack.resourceCount,
@@ -170,15 +169,14 @@ export const statusCommand = new Command("status")
         if (options.tilt && tiltAvailable) {
             console.log();
             showStep("Tilt Resources:");
-            const tiltfilePath = getTiltfilePath();
-            const result = await runTilt("get", ["-f", tiltfilePath, "resources"], {
+            const result = await runTilt("get", ["uiresources", "--port", String(tiltPort)], {
                 inheritStdio: false,
             });
             if (result.exitCode === 0) {
                 console.log(result.stdout || chalk.gray("  No active tilt resources"));
             }
             else {
-                showDetail("Could not retrieve tilt resource status");
+                showDetail(`No Tilt is answering on port ${tiltPort}. Start it with: tdk up`);
             }
         }
         console.log();

package/cli/dist/commands/ui.js

@@ -16,6 +16,7 @@ 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 { getTiltPollingPort } from "../utils/tilt-startup.js";
 import { formatUiKeyHint, formatUiKeyNames, UI_KEYMAP } from "../utils/ui-keymap.js";
 import { applyServiceStates, fetchServiceStates, } from "../utils/ui-service-state.js";
 // biome-ignore lint/correctness/noUnusedFunctionParameters: reserved callback prop kept in the component API
@@ -116,14 +117,14 @@ export const TUIApp = ({ animated = true }) => {
     const [serviceStates, setServiceStates] = useState({});
     useEffect(() => {
         let cancelled = false;
-        const tiltPort = Number.parseInt(process.env.TILT_PORT ?? "", 10);
+        const tiltPort = getTiltPollingPort(process.env.TILT_PORT);
         // 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));
+        const poll = () => run(() => fetchServiceStates(services, tiltPort));
         void poll();
         const timer = setInterval(() => void poll(), 5000);
         return () => {

package/cli/dist/commands/up.js

@@ -1,10 +1,11 @@
 // Copyright (c) 2026 TDK Landscape contributors
 // SPDX-License-Identifier: MIT
+import { existsSync } from "node:fs";
 import { connect } from "node:net";
 import { join } from "node:path";
 import chalk from "chalk";
 import { Command } from "commander";
-import { ensureProjectRuntimeAssets, ProjectConfigNotFoundError, verifyMasterConfigs, } from "../generator/template-engine.js";
+import { ensureProjectRuntimeAssets, generateMasterConfigs, 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 { STANDARD_PORTS } from "../utils/constants.js";
@@ -256,6 +257,14 @@ export const upCommand = new Command("up")
                     console.log(chalk.gray(`Added ${addedEnvKeys.join(", ")} to .env (generated; existing values unchanged)`));
                 }
             }
+            // A project made by `tdk import` has .tdk/project.json but no generated files yet. Generate them rather than letting
+            // Tilt fail on a missing Tiltfile.
+            if (foundRoot && !existsSync(join(projectRoot, ".tdk", ".tdk-out", "Tiltfile"))) {
+                if (!options.quiet) {
+                    console.log(chalk.gray("No generated Tiltfile yet; generating .tdk/.tdk-out/ ..."));
+                }
+                await generateMasterConfigs(projectRoot, { quiet: options.quiet });
+            }
             const copiedAssets = ensureProjectRuntimeAssets(projectRoot);
             if (copiedAssets.length > 0 && options.verbose && !options.quiet) {
                 console.log(chalk.gray(`Refreshed runtime assets: ${copiedAssets.join(", ")}`));

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

@@ -428,7 +428,7 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
         throw new Error(`Refusing to generate config from unsafe service.json values:\n${unsafeFields.map((error) => `  ${error}`).join("\n")}`);
     }
     await warnIfSablierUnlicensed(projectRoot);
-    if (ensureRootWorkspaceManifest(projectRoot, projectConfig)) {
+    if (ensureRootWorkspaceManifest(projectRoot, projectConfig) && !options.quiet) {
         console.log("✓ Generated: package.json (workspace root)");
     }
     // Verdaccio is Premium, but unlike the old posture here, this is NOT the
@@ -461,14 +461,17 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
         const content = files[filename];
         const filePath = assertTdkGeneratedPath(projectRoot, path.join(".tdk", ".tdk-out", filename));
         writeTextFileAtomic(filePath, content);
-        console.log(`✓ Generated: .tdk/.tdk-out/${filename}`);
+        if (!options.quiet)
+            console.log(`✓ Generated: .tdk/.tdk-out/${filename}`);
     }
     if (isStackFeatureEnabledInStacks(projectConfig.phases, DATABASE_MANAGEMENT_FEATURE)) {
         const composePath = assertTdkGeneratedPath(projectRoot, path.join("services", "platform", DATABASE_MANAGEMENT_FEATURE, DOCKER_COMPOSE_FILE));
         const composeDir = path.dirname(composePath);
         fs.mkdirSync(composeDir, { recursive: true });
         writeTextFileAtomic(composePath, generateDatabaseManagementCompose(projectConfig));
-        console.log("✓ Generated: services/platform/database-management/docker-compose.yml");
+        if (!options.quiet) {
+            console.log("✓ Generated: services/platform/database-management/docker-compose.yml");
+        }
     }
     // Copy .tiltignore to project root so Tilt uses it
     const tiltignoreSource = path.join(outputDir, TILTIGNORE_FILE);

package/cli/dist/utils/doctor-host.js

@@ -0,0 +1,66 @@
+// Copyright (c) 2026 TDK Landscape contributors
+// SPDX-License-Identifier: MIT
+import { statfsSync } from "node:fs";
+import { homedir } from "node:os";
+export const DISK_SPACE_CHECK = "Disk Space";
+const GIB = 1024 ** 3;
+// Docker Desktop keeps images and containers in one large disk image. When the host disk fills up, the engine
+// stops answering while the Docker Desktop app keeps running, so `tdk up` waits with no visible error.
+export const DISK_FAIL_GIB = 2;
+export const DISK_WARN_GIB = 10;
+export const DISK_CLEANUP_FIX = [
+    "Free disk space, then retry: tdk doctor",
+    "  docker system prune -af        # unused images and build cache (needs Docker running)",
+    "  npm cache clean --force",
+    "  bun pm cache rm",
+    "  brew cleanup -s",
+].join("\n");
+export function checkDiskSpace(statfs = statfsSync, path = homedir()) {
+    let freeGib;
+    try {
+        const stats = statfs(path);
+        freeGib = (Number(stats.bavail) * Number(stats.bsize)) / GIB;
+    }
+    catch {
+        return {
+            name: DISK_SPACE_CHECK,
+            didPass: true,
+            isSkipped: true,
+            message: "Could not read free disk space",
+        };
+    }
+    const shown = `${freeGib.toFixed(1)} GB free`;
+    if (freeGib < DISK_FAIL_GIB) {
+        return {
+            name: DISK_SPACE_CHECK,
+            didPass: false,
+            message: `${shown}: Docker cannot build or start containers`,
+            fix: DISK_CLEANUP_FIX,
+        };
+    }
+    if (freeGib < DISK_WARN_GIB) {
+        return {
+            name: DISK_SPACE_CHECK,
+            didPass: false,
+            isWarning: true,
+            message: `${shown}: image builds may fail`,
+            fix: DISK_CLEANUP_FIX,
+        };
+    }
+    return { name: DISK_SPACE_CHECK, didPass: true, message: shown };
+}
+export const DOCKER_DESKTOP_STUCK_FIX = "Quit Docker Desktop completely (whale icon > Quit Docker Desktop), reopen it, and wait until it shows Running. If it keeps getting stuck, check free disk space. Then retry: tdk doctor";
+/**
+ * Docker Desktop's app process is up but `docker ps` fails: the engine is stopped or stuck, which needs a different fix
+ * than "start Docker". Returns the failing check, or null when that is not the situation.
+ */
+export function dockerDesktopStuck(desktopRunning, platform = process.platform) {
+    if (platform !== "darwin" || !desktopRunning)
+        return null;
+    return {
+        name: "Container Runtime",
+        didPass: false,
+        message: "Docker Desktop is open, but its engine is not responding",
+        fix: DOCKER_DESKTOP_STUCK_FIX,
+    };
+}

package/cli/dist/utils/smoke.js

@@ -116,7 +116,12 @@ function readPath(value, path) {
             return undefined;
         if (!Object.hasOwn(current, part))
             return undefined;
-        current = current[part];
+        // Resolve only own data properties. Besides avoiding inherited properties, this
+        // avoids invoking accessors on values supplied by smoke-test responses.
+        const descriptor = Object.getOwnPropertyDescriptor(current, part);
+        if (!descriptor || !("value" in descriptor))
+            return undefined;
+        current = descriptor.value;
     }
     return current;
 }

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

@@ -1,11 +1,12 @@
 // Copyright (c) 2026 TDK Landscape contributors
 // SPDX-License-Identifier: MIT
+import { STANDARD_PORTS } from "./constants.js";
 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)) {
+    if (/[^0-9]/.test(value) || !isValidPort(port)) {
         return {
             ok: false,
             message: `Invalid TILT_PORT "${value}": expected an integer from 1 to 65535.`,
@@ -13,6 +14,11 @@ export function parseTiltPort(value) {
     }
     return { ok: true, port };
 }
+/** Resolve the port for read-only polling, falling back when TILT_PORT is absent or invalid. */
+export function getTiltPollingPort(value) {
+    const result = parseTiltPort(value);
+    return result.ok ? (result.port ?? STANDARD_PORTS.tiltUi) : STANDARD_PORTS.tiltUi;
+}
 export function secondUpAction(input) {
     if (input.runningPorts.length === 0 || input.force)
         return { action: "start" };