@flisk-sh/flisk 1.3.192 → 1.3.198

package/CHANGELOG.md

@@ -152,7 +152,7 @@ Notable changes to the `flisk` CLI. Versions match [npm](https://www.npmjs.com/p
 
 ## 1.3.111 (2026-10-05)
 
-- `flisk config regenerate` now restores a root `.tiltignore` that Flisk wrote (it carries the `SYSTEM-GENERATED BY Flisk CLI` header) and that was edited by hand, and prints `Restored: .tiltignore → project root (hand edits discarded)`. Before, it only copied the file when none existed, so `flisk config verify` kept failing with `Out of sync: .tiltignore (run 'flisk config regenerate')` after the advice was followed. A root `.tiltignore` without the header is still never overwritten, and plain `flisk project --yes` still does not overwrite an existing one. Docs: `docs/adopt-tdk.md` now quotes the current `flisk doctor` unknown-field wording. (#615)
+- `flisk config regenerate` now restores a root `.tiltignore` that Flisk wrote (it carries the `SYSTEM-GENERATED BY Flisk CLI` header) and that was edited by hand, and prints `Restored: .tiltignore → project root (hand edits discarded)`. Before, it only copied the file when none existed, so `flisk config verify` kept failing with `Out of sync: .tiltignore (run 'flisk config regenerate')` after the advice was followed. A root `.tiltignore` without the header is still never overwritten, and plain `flisk project --yes` still does not overwrite an existing one. Docs: `docs/adopt-flisk.md` now quotes the current `flisk doctor` unknown-field wording. (#615)
 - `flisk doctor` now checks the project's own resource configs for duplicates. Two resources with the same `appName` fail (`Duplicate resource names`, naming both `service.json` paths): the name becomes the Compose service and Traefik router, so they collide, and before nothing reported it. Two backend, mcp or routed bring-your-own resources on the same `port` give a warning, not a failure (`Duplicate resource ports`): service ports are not published on the host and each service has its own container, so the pair can run, but it is usually a copied `service.json`. Frontends, workers, libraries and a missing `port` are ignored. Fixes #76. (#609)
 - `flisk doctor` no longer fails with `N resources without a package.json` for a bring-your-own resource. A bring-your-own resource (`--image`, `--dockerfile` or `buildContext`) is a plain container: its image is pulled or built from its own Dockerfile, never from the generated Dockerfile that copies a `package.json`, so the check was a false positive that made `flisk doctor` (and CI recipes that gate on it) exit non-zero right after wrapping an existing service. Backend, frontend, worker, migrator, mcp, library and sdk resources without a `package.json` still fail; Python, Go and Rust backends were already exempt. The other doctor checks were run on a project with only bring-your-own resources and report nothing. Fixes #599. (#600)
 - A scaffolded frontend now says why `bun run build` / `bun run dev` cannot run on the host before `flisk up`: the `.autogenerated/vite.config.*.autogenerated.ts` files its scripts point at are written by the engine (Tilt) when `flisk up` loads the resource, and neither `flisk resource` nor `flisk config regenerate` creates them. Before, `vite` stopped with an esbuild `Could not resolve` stack trace. New `predev`/`prebuild` scripts print what is missing and how to get it; once the file exists (and inside the engine image build) they pass silently. Existing frontends need the two scripts added by hand. Backend, worker and mcp scaffolds are unchanged. Fixes #592. (#594)

package/README.md

@@ -196,7 +196,7 @@ Teams that run `flisk up` on their own code (listed with their consent in [ADOPT
 - [MakeOffer](https://www.linkedin.com/company/makeofferio), Flisk 1.3.180
 - [Red Moon Digital](https://redmoon.digital/), Flisk 1.3.81
 
-Using Flisk too? [Tell us](https://github.com/flisk-sh/flisk/issues/new?template=we-use-tdk.yml) or [add a row to ADOPTERS.md](ADOPTERS.md).
+Using Flisk too? [Tell us](https://github.com/flisk-sh/flisk/issues/new?template=we-use-flisk.yml) or [add a row to ADOPTERS.md](ADOPTERS.md).
 
 If Flisk saves you time, a ⭐ on [this repo](https://github.com/flisk-sh/flisk) helps other developers find it.
 
@@ -328,7 +328,7 @@ Runnable examples show Flisk on real stacks. Start with the smallest one:
 
 ## Use Flisk with your AI agent
 
-The repository ships agent skills for common Flisk work, including `tdk-doctor` (environment checks) and `tdk-troubleshoot` (fixing `flisk` and Tilt errors), under [`.agents/skills`](.agents/skills). Agents working in this repo also follow [AGENTS.md](AGENTS.md). Use these skills to let your agent check your setup and explain failures instead of guessing at Docker or Tilt configuration.
+The repository ships agent skills for common Flisk work, including `flisk-doctor` (environment checks) and `flisk-troubleshoot` (fixing `flisk` and Tilt errors), under [`.agents/skills`](.agents/skills). Agents working in this repo also follow [AGENTS.md](AGENTS.md). Use these skills to let your agent check your setup and explain failures instead of guessing at Docker or Tilt configuration.
 
 ## Installation
 
@@ -358,7 +358,7 @@ Set `TDK_DEBUG=1` before running `flisk up --verbose` to include Starlark debug
 - [CLI command cheat sheet](cli/README.md#cheat-sheet)
 - [Mega cheat sheet: every command and flag](docs/cheat-sheet.md)
 - [Documentation index](docs/README.md)
-- [Pilot Flisk on a real repository](docs/adopt-tdk.md)
+- [Pilot Flisk on a real repository](docs/adopt-flisk.md)
 - [Running AI agents in Flisk](docs/agents/ai-agents.md)
 - [FAQ for agencies and multi-client teams](docs/faq-teams.md)
 - [Working alongside Helm](docs/with-helm.md)
@@ -384,7 +384,7 @@ Set `TDK_DEBUG=1` before running `flisk up --verbose` to include Starlark debug
 - [Architecture and repository map](docs/project-overview.md)
 - [Scale fixture measurements and caveats](docs/benchmarks/scale-bench.md)
 - [Benchmark report: warm and cold start charts, history](https://flisk-sh.github.io/flisk/) (updated on every change to `main` that affects start-up)
-- [How to run the start-time benchmark](scripts/benchmark/README.md#tdk-up-warm-start-benchmark)
+- [How to run the start-time benchmark](scripts/benchmark/README.md#flisk-up-warm-start-benchmark)
 
 ## History
 

package/cli/dist/cli.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 // Copyright (c) 2026 Flisk Landscape contributors
 // SPDX-License-Identifier: MIT
-import { existsSync } from "node:fs";
+import { existsSync, readdirSync } from "node:fs";
 import { resolve } from "node:path";
 import { cwd } from "node:process";
+import chalk from "chalk";
 import { showHelp } from "./commands/help.js";
 import { createProgram } from "./program.js";
 import { ensureGlobalInstall } from "./utils/cli-command.js";
@@ -31,21 +32,44 @@ if (templateArg) {
     const { PROJECT_TEMPLATES } = await import("./utils/project-templates.js");
     await assertMachineReadyOrExit({ scope: "scaffold" });
     const runtimeNextSteps = formatRuntimeNextSteps(detectRuntimePrerequisites());
-    await cloneProjectTemplate(templateArg, projectArg, runtimeNextSteps);
+    // A second demo in the same folder gets its own directory instead of failing.
+    const { nextAvailableProjectDir } = await import("./utils/one-command.js");
+    const baseName = templateTargetDir(templateArg, projectArg);
+    const targetName = nextAvailableProjectDir(baseName, (candidate) => {
+        const path = resolve(cwd(), candidate);
+        return existsSync(path) && readdirSync(path).length > 0;
+    });
+    const destination = resolve(cwd(), targetName);
+    if (targetName !== baseName) {
+        console.log(chalk.gray(`The folder ${baseName} is taken, using ${targetName} instead.`));
+    }
+    await cloneProjectTemplate(templateArg, targetName, runtimeNextSteps);
     const install = ensureGlobalInstall();
     if (install === "installed") {
         console.log("\n\u2714 flisk is installed globally, so `flisk` works from any folder.");
     }
-    const destination = resolve(cwd(), templateTargetDir(templateArg, projectArg));
     const binPath = process.argv[1];
     if (binPath && existsSync(destination)) {
-        const { runStack } = await import("./utils/one-command.js");
-        const { openUrl } = await import("./utils/url-actions.js");
-        console.log(`\n\u{1F680} Starting the stack in ${destination}...\n`);
-        await runStack(binPath, destination, process.env, undefined, (url) => {
-            void openUrl(url);
-            console.log(`\n\u{1F310} Opening ${url}`);
+        const { runStackQuiet } = await import("./utils/one-command.js");
+        const { openFirstFrontend } = await import("./commands/open.js");
+        const { startSpinner } = await import("./utils/spinner.js");
+        const spinner = startSpinner("Starting the stack (the first build takes a minute)...");
+        const outcome = await runStackQuiet(binPath, destination);
+        if (!outcome.ok) {
+            spinner.fail("The stack did not come up.");
+            console.log(chalk.yellow(outcome.error ?? "The stack stopped before it was ready."));
+            console.log(chalk.gray("Run `flisk up` in that folder to see the full output."));
+            process.exit(1);
+        }
+        spinner.succeed("The stack is up.");
+        // The browser only opens when a frontend actually answers, the same way `flisk open` does.
+        const opened = await openFirstFrontend(destination).catch((error) => {
+            console.log(chalk.yellow(`Could not open a browser: ${error instanceof Error ? error.message : String(error)}`));
+            return null;
         });
+        if (!opened) {
+            console.log(chalk.gray(`The stack is running. Open it yourself: cd ${destination} && flisk open`));
+        }
     }
     process.exit(0);
 }

package/cli/dist/commands/help.js

@@ -57,6 +57,7 @@ const COMMAND_GROUPS = [
             { name: "down", desc: "Stop all tilt resources", alias: "" },
             { name: "restart", desc: "Restart a running resource in the stack", alias: "<resource>" },
             { name: "status", desc: "Show status of services and stacks", alias: "" },
+            { name: "open", desc: "Open the first ready frontend in your browser", alias: "" },
             { name: "logs", desc: "Print recent logs from the running stack", alias: "--json" },
         ],
     },

package/cli/dist/commands/mcp.js

@@ -8,7 +8,10 @@ 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: "flisk", version: getPackageVersion() });
+    const server = createMcpServer(createTdkTools(), {
+        name: "flisk",
+        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();

package/cli/dist/commands/open.js

@@ -0,0 +1,104 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+import chalk from "chalk";
+import { Command } from "commander";
+import { showDetail, showStep } from "../utils/formatting.js";
+import { getHostPortPlan } from "../utils/host-port-config.js";
+import { findProjectRoot } from "../utils/paths.js";
+import { resolveServicePath, resolveSubdomainBases } from "../utils/service-urls.js";
+import { discoverResourcesWithProblems } from "../utils/services.js";
+import { readProjectName } from "../utils/shared-infra.js";
+import { startSpinner } from "../utils/spinner.js";
+import { openUrl } from "../utils/url-actions.js";
+/** The frontends of the current project, with the URL each one is published under. */
+export async function listFrontendTargets(projectRoot) {
+    const { resources } = discoverResourcesWithProblems(projectRoot);
+    const plan = await getHostPortPlan(projectRoot, { inspectDocker: false });
+    const { appBase } = resolveSubdomainBases(plan?.ingressHttp, projectRoot);
+    return resources
+        .filter((resource) => resource.config?.appType === "frontend")
+        .map((resource) => ({
+        name: resource.name,
+        url: `${appBase}${resolveServicePath(resource)}`,
+    }));
+}
+/** True when the URL answers. A booting frontend needs a moment, so this is asked more than once. */
+export async function isFrontendReady(url, timeoutMs = 2000) {
+    try {
+        const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+        return response.status < 500;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The first frontend that answers. Returns undefined when none answers within the wait, so the
+ * caller can say so instead of opening a URL that refuses the connection.
+ */
+export async function pickReadyFrontend(targets, waitMs = 30000, onWait) {
+    if (targets.length === 0)
+        return undefined;
+    const started = Date.now();
+    const deadline = started + waitMs;
+    while (true) {
+        for (const target of targets) {
+            if (await isFrontendReady(target.url))
+                return target;
+        }
+        const elapsed = Date.now() - started;
+        if (elapsed >= waitMs)
+            return undefined;
+        onWait?.(elapsed);
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+}
+/**
+ * Opens the first ready frontend of the project in the browser. Returns the URL it opened, or
+ * null when the project has no frontend.
+ */
+export async function openFirstFrontend(projectRootOverride) {
+    const projectRoot = projectRootOverride ?? findProjectRoot();
+    if (!projectRoot) {
+        console.log(chalk.yellow("Not in a Flisk project, so there is no frontend to open."));
+        console.log(chalk.gray("Run `flisk project --yes` first, or `flisk open` inside a project."));
+        return null;
+    }
+    const targets = await listFrontendTargets(projectRoot);
+    if (targets.length === 0) {
+        console.log(chalk.yellow("This project has no frontend service to open."));
+        console.log(chalk.gray("Start the stack with `flisk up` and add a frontend with `flisk resource`."));
+        return null;
+    }
+    const projectName = readProjectName(projectRoot);
+    showStep(`Opening the first frontend of ${projectName ?? "this project"}`);
+    for (const target of targets) {
+        console.log(chalk.gray(`  - ${target.name}: ${target.url}`));
+    }
+    const spinner = startSpinner("Waiting for the frontend to answer...");
+    const first = await pickReadyFrontend(targets, 120000, (elapsed) => {
+        spinner.text = `Waiting for the frontend to answer... ${Math.round(elapsed / 1000)}s`;
+    });
+    if (!first) {
+        spinner.fail("No frontend answered yet.");
+        console.log(chalk.yellow("The stack is not serving the frontend yet."));
+        console.log(chalk.gray("  - Start the stack in another terminal: flisk up"));
+        console.log(chalk.gray("  - Then run this again: flisk open"));
+        for (const target of targets) {
+            console.log(chalk.gray(`  - ${target.name}: ${target.url}`));
+        }
+        return null;
+    }
+    spinner.succeed(`The frontend is up: ${first.name}`);
+    const opened = await openUrl(first.url);
+    console.log(opened
+        ? chalk.green(`\nOpened ${first.url}`)
+        : chalk.yellow(`\nCould not open a browser. Open ${first.url} yourself.`));
+    showDetail("Run `flisk open` again to open the next frontend.");
+    return first.url;
+}
+export const openCommand = new Command("open")
+    .description("Open the first frontend of the project in your browser")
+    .action(async () => {
+    await openFirstFrontend();
+});

package/cli/dist/commands/registry.js

@@ -9,6 +9,7 @@ import { logsCommand } from "./logs.js";
 import { maintainersCommand } from "./maintainers.js";
 import { mcpCommand } from "./mcp.js";
 import { networksCommand } from "./networks.js";
+import { openCommand } from "./open.js";
 import { projectCommand } from "./project.js";
 import { projectsCommand } from "./projects.js";
 import { resourceCommand } from "./resource.js";
@@ -34,6 +35,7 @@ export function getRegisteredCommands() {
         logsCommand,
         ejectCommand,
         importCommand,
+        openCommand,
         statusCommand,
         stackCommand,
         resourceCommand,

package/cli/dist/commands/ui.js

@@ -45,7 +45,7 @@ export const LoadingScreen = ({ message = "Discovering resources...", animated =
 // biome-ignore lint/correctness/noUnusedFunctionParameters: reserved callback prop kept in the component API
 const ErrorScreen = ({ error, onRetry }) => {
     const theme = useTUITheme();
-    return (_jsxs(Box, { flexDirection: "column", padding: 2, alignItems: "center", children: [_jsx(Text, { bold: true, color: theme.error, children: "Could Not Load Services" }), _jsx(Box, { marginY: 1 }), _jsxs(Text, { color: theme.error, children: [theme.ascii ? "[x]" : "\u2717", " ", error] }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: theme.muted, children: "Troubleshooting:" }), _jsx(Text, { color: theme.muted, children: " 1. Check that every service.json is valid JSON" }), _jsx(Text, { color: theme.muted, children: " 2. Run flisk from your project (the folder with the Tiltfile)" }), _jsx(Text, { color: theme.muted, children: " 3. Try: flisk status --verbose" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: theme.accent, children: "Press [r] to retry or [q] to quit" })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 2, alignItems: "center", children: [_jsx(Text, { bold: true, color: theme.error, children: "Could Not Load Services" }), _jsx(Box, { marginY: 1 }), _jsxs(Text, { color: theme.error, children: [theme.ascii ? "[x]" : "\u2717", " ", error] }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: theme.muted, children: "Troubleshooting:" }), _jsx(Text, { color: theme.muted, children: " 1. Check that every service.json is valid JSON" }), _jsxs(Text, { color: theme.muted, children: [" ", "2. Run flisk from your project (the folder with the Tiltfile)"] }), _jsx(Text, { color: theme.muted, children: " 3. Try: flisk status --verbose" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: theme.accent, children: "Press [r] to retry or [q] to quit" })] }));
 };
 const EmptyState = ({ message }) => {
     const theme = useTUITheme();

package/cli/dist/commands/upgrade.js

@@ -7,6 +7,7 @@ import { basename, dirname, join, resolve, win32 } from "node:path";
 import { fileURLToPath } from "node:url";
 import chalk from "chalk";
 import { Command } from "commander";
+import { LEGACY_PACKAGE } from "../utils/cli-command.js";
 import { addYesOption, handleDryRun } from "../utils/command-helpers.js";
 import { PACKAGE_JSON } from "../utils/constants.js";
 import { getErrorMessage, logVerbose, showErrorAndExit } from "../utils/errors.js";
@@ -363,9 +364,7 @@ export async function getLatestVersion() {
  * before it starts. The removal is best effort: the package is often not installed at all.
  */
 function removeLegacyInstallation(manager) {
-    const command = manager === "npm"
-        ? "npm uninstall -g @tdk-landscape/tdk-cli-core"
-        : "bun remove -g @tdk-landscape/tdk-cli-core";
+    const command = manager === "npm" ? `npm uninstall -g ${LEGACY_PACKAGE}` : `bun remove -g ${LEGACY_PACKAGE}`;
     try {
         execSync(command, { stdio: ["ignore", "ignore", "ignore"], timeout: 60000 });
     }

package/cli/dist/mcp/tools.js

@@ -79,7 +79,10 @@ export function toToolResult(run) {
         return {
             data: {
                 errors: [
-                    { code: "NO_JSON", message: run.stderr.trim() || `flisk exited with code ${run.exitCode}` },
+                    {
+                        code: "NO_JSON",
+                        message: run.stderr.trim() || `flisk exited with code ${run.exitCode}`,
+                    },
                 ],
             },
             isError: true,
@@ -120,7 +123,7 @@ export const defaultUpDeps = {
     },
     sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
     now: () => Date.now(),
-    logFile: () => join(tmpdir(), `tdk-mcp-up-${Date.now()}.log`),
+    logFile: () => join(tmpdir(), `flisk-mcp-up-${Date.now()}.log`),
 };
 export function buildUpArgs(args) {
     const stack = optionalName(args.stack, "stack");

package/cli/dist/utils/cli-command.js

@@ -7,7 +7,15 @@ import { delimiter, join } from "node:path";
 export const CLI_COMMAND = "flisk";
 /** The npm package that installs it. */
 export const CLI_PACKAGE = "@flisk-sh/flisk";
-/** The package the CLI was published under before the rename. It owns the old `flisk` command. */
+/** The repository the CLI is released from. */
+export const CLI_REPOSITORY = "https://github.com/flisk-sh/flisk";
+/**
+ * The package the CLI was published under before the rename. It owns the old `flisk` command.
+ *
+ * The old name stays on purpose: that package is still published, and it is the one a
+ * machine has to remove before the current package can own the command. Naming the
+ * current package here would uninstall the CLI instead of the leftover install.
+ */
 export const LEGACY_PACKAGE = "@tdk-landscape/tdk-cli-core";
 /** True when the command can be typed as-is, so `flisk ...` resolves. */
 export function isCommandOnPath(command = CLI_COMMAND, env = process.env) {
@@ -71,7 +79,8 @@ export function readyNextStep(env = process.env, cwd = process.cwd()) {
         return (`The \`${CLI_COMMAND}\` command is not on PATH (this run is not a global install). ` +
             `Install it with \`npm install -g ${CLI_PACKAGE}\`, then run \`${CLI_COMMAND} project --yes\`. ` +
             `If npm reports EEXIST for \`flisk\`, the old package still owns that command: ` +
-            `run \`npm uninstall -g ${LEGACY_PACKAGE}\` first.`);
+            `run \`npm uninstall -g ${LEGACY_PACKAGE}\` first. ` +
+            `The current release is published from ${CLI_REPOSITORY}.`);
     }
     if (isEmptyWorkspace(cwd)) {
         return `Next: ${CLI_COMMAND} project --yes`;

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

@@ -366,7 +366,7 @@ export async function checkDuplicateTdkInstalls(installs) {
         didPass: false,
         isWarning: true,
         message: `${found.length} flisk installs on PATH${versions.size > 1 ? " with different versions" : ""}: ${list}`,
-        fix: "Keep one: remove the others, or run flisk upgrade. The first on PATH is the one your shell runs; tools that launch /usr/local/bin/tdk directly may use another",
+        fix: "Keep one: remove the others, or run flisk upgrade. The first on PATH is the one your shell runs; tools that launch /usr/local/bin/flisk directly may use another",
     };
 }
 /**

package/cli/dist/utils/one-command.js

@@ -18,33 +18,80 @@ export function findFrontendUrl(output) {
     }
     return undefined;
 }
+/** Reads the `{schemaVersion, data, errors}` envelope `flisk up --json` prints when it is done. */
+export function parseStackEnvelope(output) {
+    for (const line of output.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{"))
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            const data = parsed.data ?? {};
+            const ok = data.ok === true;
+            return {
+                ok,
+                error: ok ? undefined : (parsed.errors?.[0]?.message ?? "the stack did not come up"),
+                raw: output,
+            };
+        }
+        catch {
+            // Not the envelope; keep looking.
+        }
+    }
+    return undefined;
+}
 /**
- * Runs `flisk up` in the project directory and streams its output to the terminal. The stack
- * keeps running in the foreground, so the caller is told about the frontend URL as soon as it
- * shows up instead of waiting for the process to exit.
+ * Starts the stack quietly and reports when it is ready.
+ *
+ * `flisk up --json` prints one JSON object when the stack is up (or has failed) and keeps
+ * Tilt's own build logs out of the way, so the caller can show a progress line instead of
+ * thousands of Docker and Traefik lines. The stack keeps running in the background.
  */
-export function runStack(binPath, cwd, env = process.env, spawnFn = spawn, onFrontendUrl) {
+export function runStackQuiet(binPath, cwd, env = process.env, spawnFn = spawn) {
     return new Promise((resolve) => {
-        const child = spawnFn(process.execPath, [binPath, "up"], {
+        const child = spawnFn(process.execPath, [binPath, "up", "--json"], {
             cwd,
             env,
-            stdio: ["inherit", "pipe", "inherit"],
+            stdio: ["inherit", "pipe", "pipe"],
         });
         let output = "";
-        let announced = false;
+        let settled = false;
+        const settle = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            // The stack outlives this command: let the child run on its own.
+            child.unref?.();
+            resolve(outcome);
+        };
         child.stdout?.on("data", (chunk) => {
-            const text = String(chunk);
-            output += text;
-            process.stdout.write(text);
-            if (!announced) {
-                const url = findFrontendUrl(output);
-                if (url) {
-                    announced = true;
-                    onFrontendUrl?.(url);
-                }
-            }
+            output += String(chunk);
+            const envelope = parseStackEnvelope(output);
+            if (envelope)
+                settle(envelope);
+        });
+        child.stderr?.on("data", (chunk) => {
+            output += String(chunk);
         });
-        child.on("error", (error) => resolve({ code: 1, output: `${output}\n${error.message}` }));
-        child.on("close", (code) => resolve({ code, output }));
+        child.on("error", (error) => settle({ ok: false, error: error.message, raw: output }));
+        child.on("close", (code) => settle({
+            ok: false,
+            error: `the stack stopped before it was ready (code ${code})`,
+            raw: output,
+        }));
     });
 }
+/**
+ * A free directory for the project. A second demo in the same folder gets its own directory
+ * (`name-2`, `name-3`, ...) instead of failing because the first one is still there.
+ */
+export function nextAvailableProjectDir(base, isTaken) {
+    if (!isTaken(base))
+        return base;
+    for (let suffix = 2; suffix < 1000; suffix += 1) {
+        const candidate = `${base}-${suffix}`;
+        if (!isTaken(candidate))
+            return candidate;
+    }
+    return base;
+}

package/cli/dist/utils/service-urls.js

@@ -6,7 +6,10 @@ import { PROJECT_JSON } from "./constants.js";
 import { findProjectRoot } from "./paths.js";
 import { isApiServiceType } from "./resource-kind.js";
 export function getProjectName() {
-    const root = findProjectRoot();
+    return getProjectNameFor(findProjectRoot());
+}
+/** The project name of a specific project root, for tools that work outside the current directory. */
+export function getProjectNameFor(root) {
     if (root) {
         try {
             const content = readFileSync(join(root, ".tdk", PROJECT_JSON), "utf-8");
@@ -19,8 +22,8 @@ export function getProjectName() {
     }
     return "tdk-project";
 }
-export function resolveSubdomainBases(ingressPort) {
-    const projectName = getProjectName();
+export function resolveSubdomainBases(ingressPort, projectRoot) {
+    const projectName = getProjectNameFor(projectRoot ?? findProjectRoot());
     const raw = process.env.TDK_SERVICE_BASE_URL ??
         `http://${projectName}.localhost${ingressPort ? `:${ingressPort}` : ""}`;
     try {

package/cli/dist-bundle/chunk-CF46CD6R.js

@@ -0,0 +1,6 @@
+import{createRequire as __tdkRequire}from'node:module';const require=__tdkRequire(import.meta.url);
+function x(r,e,t){let n=r.indexOf(e);if(n===-1)return r;let o=e.length,s=0,i="";do i+=r.slice(s,n)+e+t,s=n+o,n=r.indexOf(e,s);while(n!==-1);return i+=r.slice(s),i}function I(r,e,t,n){let o=0,s="";do{let i=r[n-1]==="\r";s+=r.slice(o,i?n-1:n)+e+(i?`\r
+`:`
+`)+t,o=n+1,n=r.indexOf(`
+`,o)}while(n!==-1);return s+=r.slice(o),s}var F=(r=0)=>e=>`\x1B[${e+r}m`,T=(r=0)=>e=>`\x1B[${38+r};5;${e}m`,R=(r=0)=>(e,t,n)=>`\x1B[${38+r};2;${e};${t};${n}m`,$=r=>`\x1B[58;5;${r<90?r-30:r-90+8}m`,l={modifier:{reset:[0,0],bold:[1,22],dim:[2,22],italic:[3,23],underline:[4,24],underlineDouble:["4:2",24],underlineCurly:["4:3",24],underlineDotted:["4:4",24],underlineDashed:["4:5",24],overline:[53,55],inverse:[7,27],hidden:[8,28],strikethrough:[9,29]},color:{black:[30,39],red:[31,39],green:[32,39],yellow:[33,39],blue:[34,39],magenta:[35,39],cyan:[36,39],white:[37,39],blackBright:[90,39],gray:[90,39],grey:[90,39],redBright:[91,39],greenBright:[92,39],yellowBright:[93,39],blueBright:[94,39],magentaBright:[95,39],cyanBright:[96,39],whiteBright:[97,39]},bgColor:{bgBlack:[40,49],bgRed:[41,49],bgGreen:[42,49],bgYellow:[43,49],bgBlue:[44,49],bgMagenta:[45,49],bgCyan:[46,49],bgWhite:[47,49],bgBlackBright:[100,49],bgGray:[100,49],bgGrey:[100,49],bgRedBright:[101,49],bgGreenBright:[102,49],bgYellowBright:[103,49],bgBlueBright:[104,49],bgMagentaBright:[105,49],bgCyanBright:[106,49],bgWhiteBright:[107,49]},underlineColor:{underlineBlack:["58;5;0",59],underlineRed:["58;5;1",59],underlineGreen:["58;5;2",59],underlineYellow:["58;5;3",59],underlineBlue:["58;5;4",59],underlineMagenta:["58;5;5",59],underlineCyan:["58;5;6",59],underlineWhite:["58;5;7",59],underlineBlackBright:["58;5;8",59],underlineGray:["58;5;8",59],underlineGrey:["58;5;8",59],underlineRedBright:["58;5;9",59],underlineGreenBright:["58;5;10",59],underlineYellowBright:["58;5;11",59],underlineBlueBright:["58;5;12",59],underlineMagentaBright:["58;5;13",59],underlineCyanBright:["58;5;14",59],underlineWhiteBright:["58;5;15",59]}},M=Object.keys(l.modifier),y=Object.keys(l.color),E=Object.keys(l.bgColor),U=Object.keys(l.underlineColor),S=[...y,...E];function V(){let r=new Map;for(let[e,t]of Object.entries(l)){for(let[n,o]of Object.entries(t))l[n]={open:`\x1B[${o[0]}m`,close:`\x1B[${o[1]}m`},t[n]=l[n],r.set(Number.parseInt(o[0],10),o[1]);Object.defineProperty(l,e,{value:t,enumerable:!1})}return Object.defineProperty(l,"codes",{value:r,enumerable:!1}),l.color.close="\x1B[39m",l.bgColor.close="\x1B[49m",l.underlineColor.close="\x1B[59m",l.color.ansi=F(),l.color.ansi256=T(),l.color.ansi16m=R(),l.bgColor.ansi=F(10),l.bgColor.ansi256=T(10),l.bgColor.ansi16m=R(10),l.underlineColor.ansi=$,l.underlineColor.ansi256=T(20),l.underlineColor.ansi16m=R(20),Object.defineProperties(l,{rgbToAnsi256:{value(e,t,n){return e===t&&t===n?e<8?16:e>248?231:Math.round((e-8)/247*24)+232:16+36*Math.round(e/255*5)+6*Math.round(t/255*5)+Math.round(n/255*5)},enumerable:!1},hexToRgb:{value(e){let t=/[\da-f]{6}|[\da-f]{3}/i.exec(e.toString(16));if(!t)return[0,0,0];let[n]=t;n.length===3&&(n=[...n].map(s=>s+s).join(""));let o=Number.parseInt(n,16);return[o>>16&255,o>>8&255,o&255]},enumerable:!1},hexToAnsi256:{value:e=>l.rgbToAnsi256(...l.hexToRgb(e)),enumerable:!1},ansi256ToAnsi:{value(e){if(e<8)return 30+e;if(e<16)return 90+(e-8);let t,n,o;if(e>=232)t=((e-232)*10+8)/255,n=t,o=t;else{e-=16;let f=e%36;t=Math.floor(e/36)/5,n=Math.floor(f/6)/5,o=f%6/5}let s=Math.max(t,n,o)*2;if(s===0)return 30;let i=30+(Math.round(o)<<2|Math.round(n)<<1|Math.round(t));return s===2&&(i+=60),i},enumerable:!1},rgbToAnsi:{value:(e,t,n)=>l.ansi256ToAnsi(l.rgbToAnsi256(e,t,n)),enumerable:!1},hexToAnsi:{value:e=>l.ansi256ToAnsi(l.hexToAnsi256(e)),enumerable:!1}}),l}var W=V(),c=W;import A from"node:process";import K from"node:os";import v from"node:tty";function a(r,e=globalThis.Deno?globalThis.Deno.args:A.argv){let t=r.startsWith("-")?"":r.length===1?"-":"--",n=e.indexOf(t+r),o=e.indexOf("--");return n!==-1&&(o===-1||n<o)}var{env:u}=A,g;a("no-color")||a("no-colors")||a("color=false")||a("color=never")?g=0:(a("color")||a("colors")||a("color=true")||a("color=always"))&&(g=1);function L(){return/^\d+$/.test(u.FORCE_COLOR)}function z(){if("FORCE_COLOR"in u){if(u.FORCE_COLOR==="false")return 0;if(u.FORCE_COLOR==="true"||u.FORCE_COLOR.length===0)return 1;if(L())return Math.min(Number.parseInt(u.FORCE_COLOR,10),3)}}function H(r){return r===0?!1:{level:r,hasBasic:!0,has256:r>=2,has16m:r>=3}}function q(r,{streamIsTTY:e,sniffFlags:t=!0}={}){let n=z();n!==void 0&&(g=n);let o=t?g:n;if(o===0)return 0;if(t){if(a("color=16m")||a("color=full")||a("color=truecolor"))return 3;if(a("color=256"))return 2}if(o!==void 0&&L())return o;if("TF_BUILD"in u&&"AGENT_NAME"in u)return 1;if(r&&!e&&o===void 0)return 0;let s=o||0;if(u.TERM==="dumb")return s;if(A.platform==="win32"){let i=K.release().split(".");return Number(i[0])>=10&&Number(i[2])>=10586?Number(i[2])>=14931?3:2:1}if("CI"in u)return["GITHUB_ACTIONS","GITEA_ACTIONS","CIRCLECI"].some(i=>i in u)?3:["TRAVIS","APPVEYOR","GITLAB_CI","BUILDKITE","DRONE"].some(i=>i in u)||u.CI_NAME==="codeship"?1:s;if("TEAMCITY_VERSION"in u)return/^(?:9\.0*[1-9]\d*\.|\d{2,}\.)/.test(u.TEAMCITY_VERSION)?1:0;if(u.COLORTERM==="truecolor"||u.TERM==="xterm-kitty"||u.TERM==="xterm-ghostty"||u.TERM==="wezterm")return 3;if("TERM_PROGRAM"in u){let i=Number.parseInt((u.TERM_PROGRAM_VERSION||"").split(".",1)[0],10);switch(u.TERM_PROGRAM){case"iTerm.app":return i>=3?3:2;case"Apple_Terminal":return 2}}return/-256(?:color)?$/i.test(u.TERM)?2:/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(u.TERM)||"COLORTERM"in u?1:s}function _(r,e={}){let t=q(r,{streamIsTTY:r&&r.isTTY,...e});return H(t)}var J={stdout:_({isTTY:v.isatty(1)}),stderr:_({isTTY:v.isatty(2)})},w=J;var{stdout:j,stderr:G}=w,h=Symbol("GENERATOR"),b=Symbol("STYLER"),O=Symbol("IS_EMPTY"),C=Symbol("LEVEL"),m=Object.create(null),k=r=>{if(!Number.isSafeInteger(r)||r<0||r>3)throw new Error("The `level` should be an integer from 0 to 3")},Q={enumerable:!0,get(){return this[C]},set(r){k(r),this[C]=r}},X=(r,e={})=>{e.level!==void 0&&k(e.level);let t=j?j.level:0;r[C]=e.level===void 0?t:e.level};var Z=r=>{let e=(...t)=>t.join(" ");return X(e,r),Object.setPrototypeOf(e,p.prototype),e};function p(r){return Z(r)}Object.setPrototypeOf(p.prototype,Function.prototype);for(let[r,e]of Object.entries(c))m[r]={get(){let t=B(this,P(e.open,e.close,this[b]),this[O]);return Object.defineProperty(this,r,{value:t}),t}};m.visible={get(){let r=B(this,this[b],!0);return Object.defineProperty(this,"visible",{value:r}),r}};var ee=(r,e)=>{let t=c[e];if(r==="rgb"){let o=(i,f,d)=>t.ansi(c.rgbToAnsi(i,f,d));return[o,o,(i,f,d)=>t.ansi256(c.rgbToAnsi256(i,f,d)),t.ansi16m]}if(r==="hex"){let o=i=>t.ansi(c.hexToAnsi(i));return[o,o,i=>t.ansi256(c.hexToAnsi256(i)),i=>t.ansi16m(...c.hexToRgb(i))]}let n=o=>t.ansi(c.ansi256ToAnsi(o));return[n,n,t.ansi256,t.ansi256]},re=["rgb","hex","ansi256"];for(let r of re){let e=r[0].toUpperCase()+r.slice(1);for(let[t,n]of[[r,"color"],["bg"+e,"bgColor"],["underline"+e,"underlineColor"]]){let{close:o}=c[n],s=ee(r,n);m[t]={get(){let i=function(f,d,D){let Y=s[this.level](f,d,D);return B(this,P(Y,o,this[b]),this[O])};return Object.defineProperty(this,t,{value:i}),i}}}}var te=Object.defineProperties(()=>{},{...m,level:{enumerable:!0,get(){return this[h].level},set(r){this[h].level=r}}}),P=(r,e,t)=>{let n,o;return t===void 0?(n=r,o=e):(n=t.openAll+r,o=e+t.closeAll),{open:r,close:e,openAll:n,closeAll:o,parent:t}},B=(r,e,t)=>{let n=(...o)=>o.length===1?N(n,""+o[0]):o.length===2?N(n,`${o[0]??""} ${o[1]??""}`):N(n,o.join(" "));return Object.setPrototypeOf(n,te),n[h]=r[h]??r,n[b]=e,n[O]=t,n},N=(r,e)=>{if(r[h][C]<=0||!e)return r[O]?"":e;let t=r[b];if(t===void 0)return e;let{openAll:n,closeAll:o}=t;if(e.includes("\x1B"))for(;t!==void 0;)e=x(e,t.close,t.open),t=t.parent;let s=e.indexOf(`
+`);return s!==-1&&(e=I(e,o,n,s)),n+e+o};Object.defineProperties(p.prototype,{...m,level:Q});var ne=p(),he=p({level:G?G.level:0});var be=ne;export{y as a,be as b};

package/cli/dist-bundle/chunk-DTIHDMED.js

@@ -0,0 +1,5 @@
+import{createRequire as __tdkRequire}from'node:module';const require=__tdkRequire(import.meta.url);
+import{b as n}from"./chunk-CF46CD6R.js";var o=["\u280B","\u2819","\u2839","\u2838","\u283C","\u2834","\u2826","\u2827","\u2807","\u280F"];function w(f){let r=process.stderr,i=r.isTTY===!0,s=0,t=f,a,l=()=>r.write(`\r\x1B[2K${n.cyan(o[s])} ${t}`);i?(l(),a=setInterval(()=>{s=(s+1)%o.length,l()},80)):r.write(`- ${t}
+`);let c=(e,$)=>{a&&clearInterval(a),r.write(`${i?"\r\x1B[2K":""}${e} ${$??t}
+`)};return{get text(){return t},set text(e){t=e,i||r.write(`- ${t}
+`)},succeed:e=>c(n.green("\u2714"),e),fail:e=>c(n.red("\u2716"),e),warn:e=>c(n.yellow("\u26A0"),e)}}export{w as a};