@flisk-sh/flisk 0.0.0-stage → 1.3.190

package/cli/dist/utils/platform.js

@@ -0,0 +1,58 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+import { delimiter, extname } from "node:path";
+export function isWindows() {
+    return process.platform === "win32";
+}
+export function tdkOsFor(platformName) {
+    if (platformName === "linux")
+        return "linux";
+    if (platformName === "darwin")
+        return "darwin";
+    if (platformName === "win32")
+        return "windows";
+    return null;
+}
+export function tdkOs() {
+    return tdkOsFor(process.platform);
+}
+export function tdkArchFor(architecture) {
+    if (architecture === "x64")
+        return "amd64";
+    if (architecture === "arm64")
+        return "arm64";
+    return null;
+}
+export function tdkArch() {
+    return tdkArchFor(process.arch);
+}
+export function binaryAssetNameFor(platformName, architecture) {
+    const osName = tdkOsFor(platformName);
+    const archName = tdkArchFor(architecture);
+    if (!osName || !archName)
+        return null;
+    if (osName === "windows" && archName !== "amd64")
+        return null;
+    const base = `flisk-${osName}-${archName}`;
+    return osName === "windows" ? `${base}.exe` : base;
+}
+export function binaryAssetName() {
+    return binaryAssetNameFor(process.platform, process.arch);
+}
+export function executableName() {
+    return isWindows() ? "flisk.exe" : "flisk";
+}
+/** Installs published before the Flisk rename shipped the binary as `tdk`. */
+export function legacyExecutableName() {
+    return isWindows() ? "tdk.exe" : "tdk";
+}
+export function pathLookups(binName, windows = isWindows()) {
+    if (!windows)
+        return [binName];
+    if (extname(binName))
+        return [binName];
+    return [binName, `${binName}.exe`, `${binName}.cmd`, `${binName}.bat`];
+}
+export function pathDelimiter(windows = isWindows()) {
+    return windows ? ";" : delimiter;
+}

package/cli/dist/utils/port-assignment.js

@@ -0,0 +1,75 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+import { createConnection, createServer } from "node:net";
+import { PORT_RANGES } from "./constants.js";
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = createConnection({ port, host: "127.0.0.1" }, () => {
+            server.destroy();
+            resolve(false);
+        });
+        server.on("error", () => {
+            resolve(true);
+        });
+        // A connect that neither accepts nor refuses means something is holding
+        // the port (e.g. a firewall drop) - treat it as taken rather than wait.
+        server.setTimeout(1000, () => {
+            server.destroy();
+            resolve(false);
+        });
+    });
+}
+export async function checkPortStatus(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        const timer = setTimeout(() => {
+            server.close();
+            resolve("unknown");
+        }, 3000);
+        server.once("error", (error) => {
+            clearTimeout(timer);
+            resolve(error.code === "EADDRINUSE" ? "running" : "unknown");
+        });
+        server.once("listening", () => {
+            clearTimeout(timer);
+            server.close(() => resolve("stopped"));
+        });
+        server.listen(port, "127.0.0.1");
+    });
+}
+export async function findAvailablePort(basePort, maxAttempts = 10) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = basePort + i;
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+    }
+    return null;
+}
+export function getUsedPorts(resources) {
+    const usedPorts = new Set();
+    for (const r of resources) {
+        if (r.port && r.port > 0) {
+            usedPorts.add(r.port);
+        }
+    }
+    return usedPorts;
+}
+function findNextAvailablePort(usedPorts, range) {
+    for (let port = range.base; port <= range.max; port++) {
+        if (!usedPorts.has(port)) {
+            return port;
+        }
+    }
+    return null;
+}
+export function assignPort(resourceType, existingResources) {
+    const usedPorts = getUsedPorts(existingResources);
+    const portRange = PORT_RANGES[resourceType];
+    const assignedPort = findNextAvailablePort(usedPorts, portRange);
+    if (assignedPort === null) {
+        throw new Error(`No available ports in range ${portRange.base}-${portRange.max}. ` +
+            "Check TILT_RESOURCE_DEFAULTS.star for port configuration.");
+    }
+    return assignedPort;
+}

package/cli/dist/utils/port-conflict-fix.js

@@ -0,0 +1,25 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+/** The env var that moves each host port Flisk publishes. Services publish no host ports, so only these conflict. */
+const PORT_ENV_VARS = {
+    "80": "TDK_HTTP_PORT",
+    "443": "TDK_HTTPS_PORT",
+    "5432": "TDK_POSTGRES_PORT",
+};
+/**
+ * The next step for a host port another process already holds. The occupant is not named: finding it needs the OS, so
+ * the command that finds it is given instead.
+ */
+export function portConflictFix(message) {
+    // The raw Docker error can reach the report when the readiness check fails before the summary runs.
+    const match = message.match(/^host port (\d+) is already allocated$/) ??
+        message.match(/Bind for [^ ]+:(\d+) failed: port is already allocated/i);
+    if (!match)
+        return null;
+    const port = match[1];
+    const find = `find it with: lsof -nP -iTCP:${port} -sTCP:LISTEN`;
+    const envVar = PORT_ENV_VARS[port];
+    if (!envVar)
+        return `Fix: stop the process using port ${port} (${find})`;
+    return `Fix: stop the process using port ${port} (${find}), or set ${envVar} to a free port and run flisk up`;
+}

package/cli/dist/utils/port-fallback-notice.js

@@ -0,0 +1,17 @@
+const PORT_KEYS = [
+    { key: "ingressHttp", label: "HTTP", env: "TDK_HTTP_PORT" },
+    { key: "ingressHttps", label: "HTTPS", env: "TDK_HTTPS_PORT" },
+    { key: "postgres", label: "Postgres", env: "TDK_POSTGRES_PORT" },
+];
+/** One line per port Flisk moved off the one it wanted. Ports the user set explicitly are never listed. */
+export function formatPortFallbackNotice(plan) {
+    const lines = [];
+    for (const { key, label, env } of PORT_KEYS) {
+        const requested = plan.requested[key];
+        const chosen = plan[key];
+        if (plan.explicit[key] || chosen === requested)
+            continue;
+        lines.push(`${label}: wanted ${requested}, using ${chosen} (${plan.reason[key]}). To force ${requested}: ${env}=${requested} flisk up`);
+    }
+    return lines;
+}

package/cli/dist/utils/port-listener-probe.js

@@ -0,0 +1,20 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+import { connect } from "node:net";
+/**
+ * True when something already accepts connections on 127.0.0.1:port. Binding a socket to find out is not enough:
+ * on macOS a bind on 127.0.0.1 succeeds even while another process listens on the same port, so a busy port such as
+ * 5432 looked free and `flisk doctor` passed before Docker failed to publish it.
+ */
+export function hasLocalListener(port, timeoutMs = 500) {
+    return new Promise((resolve) => {
+        const socket = connect({ port, host: "127.0.0.1" });
+        const finish = (result) => {
+            socket.destroy();
+            resolve(result);
+        };
+        socket.setTimeout(timeoutMs, () => finish(false));
+        socket.once("connect", () => finish(true));
+        socket.once("error", () => finish(false));
+    });
+}

package/cli/dist/utils/project-config-defaults.js

@@ -0,0 +1,17 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+import { DATABASE_MANAGEMENT_FEATURE } from "./constants.js";
+/**
+ * Defaults shared by project generation and CLI predicates.
+ *
+ * Source of truth for `always_enabled_infra` when `.tdk/project.json` omits
+ * the field. The generator bakes this into the Tiltfile
+ * (`Tiltfile.hbs` → `ALWAYS_ENABLED_INFRA`); `should_enable` then returns
+ * `RESOURCE_DEFAULTS.get(name, True)` for names in that list — so an omitted
+ * field means database-management is ON for `flisk up`.
+ *
+ * `flisk doctor` / `flisk config verify` must use the same default, otherwise
+ * they report Postgres-will-start while the engine does not start it (or
+ * the reverse). See shared-platform-postgres.ts.
+ */
+export const DEFAULT_ALWAYS_ENABLED_INFRA = [DATABASE_MANAGEMENT_FEATURE, "proxy"];

package/cli/dist/utils/project-features.js

@@ -0,0 +1,91 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+import { DATABASE_MANAGEMENT_FEATURE } from "./constants.js";
+export const PROJECT_FEATURES = {
+    // ============================================================================
+    // CORE INFRASTRUCTURE (always enabled in pre_alpha)
+    // ============================================================================
+    proxy: {
+        name: "proxy",
+        description: "Traefik reverse proxy and API gateway for routing all services",
+        category: "core",
+        phase: "pre_alpha",
+        enabled_by_default: true,
+        dependsOn: [],
+    },
+    // Key/name must be the literal Tilt resource name (PlatformDockerConstants.VERDACCIO_RESOURCE_NAME
+    // in tdk-cli-extensions), since project.json's services list is copied verbatim into
+    // PRE_ALPHA_RESOURCES and matched against that name by should_enable(). "registry" would
+    // silently fail to enable Verdaccio.
+    verdaccio: {
+        name: "verdaccio",
+        description: "Verdaccio npm registry for package management and local publishing (Premium - requires TDK_LICENSE_KEY)",
+        category: "premium",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: [],
+    },
+    [DATABASE_MANAGEMENT_FEATURE]: {
+        name: DATABASE_MANAGEMENT_FEATURE,
+        description: "PostgreSQL database for data persistence and SQL operations",
+        category: "core",
+        phase: "pre_alpha",
+        enabled_by_default: true,
+        dependsOn: [],
+    },
+    // ============================================================================
+    // OPTIONAL INFRASTRUCTURE (disabled by default, enable in optional_infra)
+    // ============================================================================
+    monitoring: {
+        name: "monitoring",
+        description: "SigNoz or SkyWalking observability platform for monitoring and tracing",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: [DATABASE_MANAGEMENT_FEATURE],
+    },
+    elk: {
+        name: "elk",
+        description: "Elasticsearch, Logstash, Kibana stack for log aggregation and analysis",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: [],
+    },
+    debezium: {
+        name: "debezium",
+        description: "Change Data Capture for real-time data streaming from databases",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: [DATABASE_MANAGEMENT_FEATURE],
+    },
+    "golden-image": {
+        name: "golden-image",
+        description: "Pre-built Docker image layer for faster builds and smaller deployments",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: true,
+        dependsOn: [],
+    },
+};
+/**
+ * Get all enabled project features
+ */
+export function getEnabledProjectFeatures(optional_infra) {
+    const enabled = [];
+    for (const [key, feature] of Object.entries(PROJECT_FEATURES)) {
+        if (feature.enabled_by_default) {
+            enabled.push(key);
+        }
+    }
+    // Add optional features if enabled
+    if (optional_infra) {
+        for (const [key, isEnabled] of Object.entries(optional_infra)) {
+            if (isEnabled && PROJECT_FEATURES[key]) {
+                enabled.push(key);
+            }
+        }
+    }
+    return enabled;
+}

package/cli/dist/utils/project-templates.js

@@ -0,0 +1,32 @@
+/** Public starter repositories plus the bundled default product example. */
+export const PROJECT_TEMPLATES = {
+    restaurant: {
+        repo: "https://github.com/tdk-landscape/tdk-restaurant-example.git",
+        description: "Restaurant ops: reservations, kitchen, floor control (Hono + Vite + Bun)",
+    },
+    saas: {
+        repo: "https://github.com/tdk-landscape/tdk-saas-starter.git",
+        description: "SaaS starter: account dashboard and a working checkout button (Hono + Vite + Bun)",
+    },
+    erp: {
+        repo: "https://github.com/tdk-landscape/tdk-erp-system.git",
+        description: "Enterprise ERP: 100 microservices across 7 business domains",
+    },
+    "user-management": {
+        repo: "https://github.com/tdk-landscape/tdk-user-management.git",
+        description: "User/auth management services",
+    },
+    ecommerce: {
+        repo: "https://github.com/tdk-landscape/tdk-ecommerce-example.git",
+        description: "Vue 3 storefront and Hono catalog API (needs Flisk 1.3.75+ for --framework vue)",
+    },
+    example: {
+        repo: "https://github.com/tdk-landscape/tdk-example.git",
+        bundledPath: "examples/tdk-example",
+        description: "Hono + Postgres + NATS worker + Vite example with a routed write path",
+    },
+    "agent-stack": {
+        repo: "https://github.com/tdk-landscape/tdk-agent-stack.git",
+        description: "AI agent stack: Bun agent + MCP tool server + Postgres + NATS",
+    },
+};

package/cli/dist/utils/prompt.js

@@ -0,0 +1,97 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+import { stdin as input, stdout as output } from "node:process";
+import { createInterface } from "node:readline/promises";
+async function question(prompt) {
+    const rl = createInterface({ input, output });
+    try {
+        // Without this, a closed stdin (CI, `< /dev/null`, a pipe) leaves the
+        // question pending forever and Node exits 0 having done nothing.
+        return await new Promise((resolve, reject) => {
+            rl.once("close", () => reject(new Error("No input available to answer the prompt. Run this in a terminal.")));
+            rl.question(prompt).then((answer) => resolve(answer.trim()), reject);
+        });
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function promptText(options) {
+    const suffix = options.initial ? ` (${options.initial})` : "";
+    while (true) {
+        const answer = await question(`${options.message}${suffix} `);
+        const value = answer || options.initial || "";
+        const validation = options.validate?.(value) ?? true;
+        if (validation === true) {
+            return value;
+        }
+        console.log(validation);
+    }
+}
+export async function promptConfirm(options) {
+    const defaultValue = options.initial ?? true;
+    const suffix = defaultValue ? "Y/n" : "y/N";
+    while (true) {
+        const answer = (await question(`${options.message} (${suffix}) `)).toLowerCase();
+        if (!answer)
+            return defaultValue;
+        if (["y", "yes"].includes(answer))
+            return true;
+        if (["n", "no"].includes(answer))
+            return false;
+        console.log("Please answer yes or no.");
+    }
+}
+export async function promptSelect(options) {
+    console.log(options.message);
+    options.choices.forEach((choice, index) => {
+        console.log(`  ${index + 1}. ${choice.title}`);
+    });
+    while (true) {
+        const answer = await question("Choose one: ");
+        const selectedIndex = Number.parseInt(answer, 10) - 1;
+        const selected = options.choices[selectedIndex];
+        if (selected) {
+            return selected.value;
+        }
+        console.log(`Enter a number from 1 to ${options.choices.length}.`);
+    }
+}
+export async function promptMultiSelect(options) {
+    const defaults = options.choices
+        .map((choice, index) => (choice.selected ? index + 1 : null))
+        .filter((index) => index !== null);
+    const defaultHint = defaults.length > 0 ? ` [${defaults.join(",")}]` : "";
+    console.log(options.message);
+    options.choices.forEach((choice, index) => {
+        const marker = choice.selected ? "*" : " ";
+        console.log(` ${marker} ${index + 1}. ${choice.title}`);
+    });
+    while (true) {
+        const answer = await question(`Choose one or more numbers, comma-separated${defaultHint}: `);
+        let rawIndexes = defaults;
+        if (answer) {
+            const tokens = answer.split(",").map((value) => value.trim());
+            const invalidToken = tokens.find((token) => {
+                if (!/^\d+$/.test(token))
+                    return true;
+                const index = Number.parseInt(token, 10);
+                return !options.choices[index - 1];
+            });
+            if (invalidToken !== undefined) {
+                console.log(`"${invalidToken}" is not a valid choice (1-${options.choices.length})`);
+                continue;
+            }
+            rawIndexes = tokens.map((token) => Number.parseInt(token, 10));
+        }
+        const selected = Array.from(new Set(rawIndexes))
+            .map((index) => options.choices[index - 1])
+            .filter((choice) => Boolean(choice))
+            .map((choice) => choice.value);
+        const validation = options.validate?.(selected) ?? true;
+        if (validation === true) {
+            return selected;
+        }
+        console.log(validation);
+    }
+}

package/cli/dist/utils/resource-features.js

@@ -0,0 +1,184 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+/**
+ * Resource-Level Features
+ *
+ * These are code generators and configurations that run per-service/resource.
+ * They are controlled via the featuresEnabled: [] array in each service.json file.
+ *
+ * Frontend services: api-client, env-config, api-index (enabled by default)
+ * Backend services: prisma (enabled by default)
+ */
+import { BRING_YOUR_OWN_TYPE } from "./constants.js";
+export const RESOURCE_FEATURES = {
+    // ============================================================================
+    // FRONTEND GENERATORS
+    // ============================================================================
+    "api-client": {
+        name: "api-client",
+        description: "Pre-configured API client for backend communication (createApiClient wrapper)",
+        applies_to: ["frontend"],
+        enabled_by_default: true,
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/frontend.star",
+        output_file: ".autogenerated/api-client.ts",
+    },
+    "env-config": {
+        name: "env-config",
+        description: "Environment constants and configuration (Vite env vars)",
+        applies_to: ["frontend"],
+        enabled_by_default: true,
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/frontend.star",
+        output_file: ".autogenerated/env.ts",
+    },
+    "api-index": {
+        name: "api-index",
+        description: "Barrel export for clean API client imports",
+        applies_to: ["frontend"],
+        enabled_by_default: true,
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/frontend.star",
+        output_file: ".autogenerated/api-index.ts",
+    },
+    // ============================================================================
+    // BACKEND GENERATORS
+    // ============================================================================
+    prisma: {
+        name: "prisma",
+        description: "Prisma CLI configuration for migrations and database client generation",
+        applies_to: ["backend", "worker", "migrator"],
+        // Opt-in: it needs a prisma/schema.prisma and the prisma dependency, which
+        // `flisk resource` does not create. Enabled by default it made every new
+        // backend's image build fail on `COPY .../prisma` and `test -f prisma/schema.prisma`.
+        enabled_by_default: false,
+        generator_file: "engine/topologies/tilt/generators/typescript/prisma_config.star",
+        output_file: ".autogenerated/prisma.config.autogenerated.ts",
+    },
+    // ============================================================================
+    // BUILD CONFIGURATION GENERATORS (always enabled, not listed in features)
+    // ============================================================================
+    // Note: These always run regardless of features array. They are core to the build.
+    // Listed here for reference only.
+    vite: {
+        name: "vite",
+        description: "Vite configuration for frontend/backend/SDK builds",
+        applies_to: ["frontend", "backend", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/vite_config.star",
+        output_file: ".autogenerated/vite.config.*.ts",
+    },
+    tsconfig: {
+        name: "tsconfig",
+        description: "TypeScript configuration (local and Docker variants)",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/typescript/",
+        output_file: ".autogenerated/tsconfig.*.json",
+    },
+    dockerfile: {
+        name: "dockerfile",
+        description: "Docker container configuration for production builds",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/manifest_resource.star",
+        output_file: ".autogenerated/Dockerfile.app",
+    },
+    npmrc: {
+        name: "npmrc",
+        description: "NPM registry configuration for package installation",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/npmrc.star",
+        output_file: ".autogenerated/.npmrc*",
+    },
+    bunfig: {
+        name: "bunfig",
+        description: "Bun runtime configuration for package management",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/npmrc.star",
+        output_file: ".autogenerated/bunfig.toml*",
+    },
+    nginx: {
+        name: "nginx",
+        description: "Nginx configuration for static file serving (frontend only)",
+        applies_to: ["frontend"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/nginx_conf.star",
+        output_file: ".autogenerated/nginx.conf",
+    },
+    env: {
+        name: "env",
+        description: "Backend environment file configuration",
+        applies_to: ["backend", "worker", "migrator"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/env.star",
+        output_file: ".autogenerated/.env*",
+    },
+    playwright: {
+        name: "playwright",
+        description: "Playwright test configuration (if playwright: true in manifest)",
+        applies_to: ["frontend", "backend"],
+        enabled_by_default: false, // Only if explicitly enabled in manifest
+        generator_file: "engine/topologies/tilt/generators/typescript/playwright_config.star",
+        output_file: ".autogenerated/playwright.config.ts",
+    },
+    "agents-md": {
+        name: "agents-md",
+        description: "AI agent guard rails for .autogenerated/ folder (paid Flisk feature - free tier writes a stub notice; see extension-fetch.ts KNOWN_RESOURCES)",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always attempted; real content is license-gated
+        generator_file: "engine/topologies/tilt/generators/agents_md.star",
+        output_file: ".autogenerated/AGENTS.md",
+    },
+    ddd: {
+        name: "ddd",
+        description: "Domain-driven design folder structure (domain/application/infrastructure/presentation) " +
+            "and matching @domain/@application/@infrastructure/@presentation/@test path aliases " +
+            "(Premium - requires TDK_LICENSE_KEY; see hasDddLicense() in extension-fetch.ts)",
+        applies_to: ["backend", "worker", "migrator"],
+        enabled_by_default: false,
+        category: "premium",
+        generator_file: "engine/topologies/tilt/generators/vite/helpers.star, engine/topologies/tilt/generators/typescript/backend_tsconfig.star",
+        output_file: ".autogenerated/vite.config.*.ts, .autogenerated/tsconfig.*.json",
+    },
+    sablier: {
+        name: "sablier",
+        description: "On-demand scaling: stop this resource when idle, wake it on the next request via a " +
+            "`sablier: {enable: true}` manifest block (not the featuresEnabled array). Add " +
+            "`deferStart: true` to also skip this resource during `flisk up` entirely — no container " +
+            "is created or started, and a Traefik static route wakes it on the first request instead " +
+            "(backends only for now), so it doesn't wait behind the rest of a large landscape's " +
+            "bring-up. Requires `enable: true`. " +
+            "(Premium - requires TDK_LICENSE_KEY; free tier writes a disabled stub; see " +
+            "hasSablierLicense() in extension-fetch.ts KNOWN_RESOURCES/PREMIUM_PATH_MAP)",
+        applies_to: ["backend", "frontend"],
+        enabled_by_default: false,
+        category: "premium",
+        generator_file: "engine/topologies/platform/docker/networking/sablier_container_cycle.star (stub; real generator in tdk-cli-extensions/premium/networking/), engine/topologies/platform/docker/networking/traefik.star, engine/topologies/platform/docker/compose/traefik_standalone.star (deferStart wake gateway + static route), engine/topologies/tilt/resources/orchestrator/apply_compose_resource_registration.star (deferred image prebuild + wake route wiring)",
+        output_file: "(Traefik + Sablier Docker labels on the resource's own compose service; with deferStart, also a generated Traefik file-provider dynamic-config entry, wake gateway, and image prebuild resource)",
+    },
+};
+/**
+ * Get default features for a resource type
+ */
+export function getDefaultFeaturesForResourceType(appType) {
+    // bring-your-own doesn't generate application code, so no features
+    if (appType === BRING_YOUR_OWN_TYPE) {
+        return [];
+    }
+    const defaults = [];
+    for (const [key, feature] of Object.entries(RESOURCE_FEATURES)) {
+        if (feature.enabled_by_default &&
+            feature.applies_to.includes(appType) &&
+            // Only include if it's something users control via features array
+            ["api-client", "env-config", "api-index", "prisma"].includes(key)) {
+            defaults.push(key);
+        }
+    }
+    return defaults;
+}
+/**
+ * Get all generators for a resource type (for documentation)
+ */
+export function getGeneratorsForResourceType(appType) {
+    return Object.values(RESOURCE_FEATURES).filter((f) => f.applies_to.includes(appType));
+}

package/cli/dist/utils/resource-kind.js

@@ -0,0 +1,9 @@
+// Copyright (c) 2026 Flisk Landscape contributors
+// SPDX-License-Identifier: MIT
+/**
+ * True for a resource that runs as an HTTP API service behind the Traefik API host: a backend, or an `mcp` server (a Model Context
+ * Protocol endpoint, which the engine builds, routes and health-checks exactly like a backend).
+ */
+export function isApiServiceType(appType) {
+    return appType === "backend" || appType === "mcp" || appType === "agent";
+}