@tdk-landscape/tdk-cli-core 1.3.87 → 1.3.88

package/README.md

@@ -18,11 +18,11 @@ tdk up shop
 curl http://api.shop.localhost/api/orders-api/health
 ```
 
-![TDK scaffolding a backend and a frontend, then listing the stack](docs/demo.svg)
+![TDK scaffolding a backend and a frontend, then listing the stack](docs/assets/demo.svg)
 
 *Scaffolding a backend and frontend, then listing the stack.*
 
-![Top 9 places to use TDK CLI: scaffold a service, start a stack, hot reload, port management, auto-discovery, boot order, proxy routing, include infra, and config verify](docs/tdk-cli-top-9-uses.jpg)
+![Top 9 places to use TDK CLI: scaffold a service, start a stack, hot reload, port management, auto-discovery, boot order, proxy routing, include infra, and config verify](docs/assets/tdk-cli-top-9-uses.jpg)
 
 If Helm, Compose, or your existing Tilt setup already gives you a working local environment, keep using it. TDK CLI is for engineers managing several services who want a clear local service contract and one command to start the stack.
 
@@ -66,9 +66,9 @@ curl -fsSL https://tdk-landscape.github.io/install.sh | sh
 - [Features and license limits](docs/FEATURES.md)
 - [Honest comparison and known limits](docs/compare-honest.md)
 - [Public claims registry](docs/claims.md)
-- [Show HN draft](docs/show-hn.md)
+- [Show HN draft](docs/drafts/show-hn.md)
 - [Architecture and repository map](docs/project-overview.md)
-- [Scale fixture measurements and caveats](docs/scale-bench.md)
+- [Scale fixture measurements and caveats](docs/benchmarks/scale-bench.md)
 
 ## Requirements and support
 

package/cli/dist/backend-frameworks/express.js

@@ -0,0 +1,50 @@
+export function getExpressIndexTemplate(name) {
+    return `import express from 'express';
+
+const app = express();
+
+// Health check endpoint (required by TILT_RESOURCE_DEFAULTS.star)
+app.get('/health', (_req, res) => {
+  res.json({ status: 'ok', service: '${name}' });
+});
+
+app.get('/health/live', (_req, res) => {
+  res.json({ status: 'alive', timestamp: Date.now() });
+});
+
+app.get('/health/ready', async (_req, res) => {
+  const dependencies: Record<string, string> = {};
+  let allReady = true;
+
+  // Add dependency checks here (database, cache, etc.)
+  // Mark allReady = false if any dependency is unhealthy
+
+  const status = allReady ? 'ready' : 'not_ready';
+  res.status(allReady ? 200 : 503).json({ status, dependencies });
+});
+
+app.get('/', (_req, res) => {
+  res.json({
+    service: '${name}',
+    version: '1.0.0',
+    endpoints: ['/health', '/health/live', '/health/ready']
+  });
+});
+
+const port = Number(process.env.PORT || 3000);
+
+// Bind beyond loopback: Traefik reaches the container over the Docker network.
+app.listen(port, '0.0.0.0', () => {
+  console.log('\\n🚀 ${name} running on http://localhost:' + port);
+  console.log('📊 Health check: http://localhost:' + port + '/health\\n');
+});
+`;
+}
+export const expressBackendProvider = {
+    id: "express",
+    label: "Bun + Express",
+    dependencies: { express: "^5.1.0" },
+    devDependencies: { "@types/express": "^5.0.0" },
+    createIndex: getExpressIndexTemplate,
+};
+//# sourceMappingURL=express.js.map

package/cli/dist/backend-frameworks/registry.js

@@ -0,0 +1,41 @@
+import { getBackendIndexTemplate } from "../backend-languages/bun.js";
+import { TdkError } from "../utils/errors.js";
+import { expressBackendProvider } from "./express.js";
+/** Hono is the historical default; omitting --framework keeps the exact historical output. */
+export const DEFAULT_BACKEND_FRAMEWORK = "hono";
+export const honoBackendProvider = {
+    id: "hono",
+    label: "Bun + Hono",
+    dependencies: { hono: "^4.0.0" },
+    devDependencies: {},
+    createIndex: getBackendIndexTemplate,
+};
+export const BACKEND_FRAMEWORKS = {
+    hono: honoBackendProvider,
+    express: expressBackendProvider,
+};
+export function getBackendFramework(frameworkId) {
+    const id = (frameworkId ?? DEFAULT_BACKEND_FRAMEWORK).trim().toLowerCase();
+    const provider = Object.hasOwn(BACKEND_FRAMEWORKS, id) ? BACKEND_FRAMEWORKS[id] : undefined;
+    if (!provider) {
+        const supportedIds = Object.keys(BACKEND_FRAMEWORKS).join(", ");
+        throw new TdkError(`Unknown backend framework "${frameworkId}". Supported frameworks: ${supportedIds}.`, [`Use one of: ${supportedIds}`, `Omit --framework to use ${DEFAULT_BACKEND_FRAMEWORK}`]);
+    }
+    return provider;
+}
+/**
+ * Returns the provider for an explicit `--framework` on a backend, or undefined when none was given
+ * (the historical Hono scaffold). Python owns its runtime, so a framework cannot be combined with it.
+ */
+export function resolveBackendFramework(resourceType, frameworkId, language) {
+    if (resourceType !== "backend" || frameworkId === undefined)
+        return undefined;
+    if (language?.createFiles) {
+        throw new TdkError(`--framework cannot be combined with --language ${language.id}.`, [
+            `The ${language.id} provider owns its runtime and framework`,
+            "Drop --framework, or use --language bun",
+        ]);
+    }
+    return getBackendFramework(frameworkId);
+}
+//# sourceMappingURL=registry.js.map

package/cli/dist/backend-frameworks/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/cli/dist/commands/resource.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync } from "node:fs";
 import { isAbsolute, relative, resolve } from "node:path";
 import chalk from "chalk";
 import { Command } from "commander";
+import { resolveBackendFramework } from "../backend-frameworks/registry.js";
 import { getBackendIndexTemplate } from "../backend-languages/bun.js";
 import { resolveBackendLanguage } from "../backend-languages/registry.js";
 import { resolveFrontendFramework } from "../frontend-frameworks/registry.js";
@@ -50,6 +51,7 @@ export const TYPE_SPECIFIC = {
         healthCheck: "/health",
     },
 };
+const BYO_RESTART_POLICIES = ["no", "on-failure", "unless-stopped", "always"];
 export function resolveByoPort(value, assignedPort, resources) {
     if (!value)
         return assignedPort;
@@ -69,6 +71,8 @@ export function createServiceJson(name, type, stack, port, extraFeatures = [], f
     const framework = resolveFrontendFramework(type, frameworkId);
     // Only an explicit selection is persisted: a missing `language` has always meant Bun.
     const language = languageId === undefined ? undefined : resolveBackendLanguage(type, languageId);
+    // Likewise a missing backend `framework` has always meant Hono.
+    const backendFramework = resolveBackendFramework(type, frameworkId, language);
     const typeSpecific = TYPE_SPECIFIC[type];
     const base = JSON.parse(JSON.stringify(BASE_TEMPLATE));
     for (const [key, value] of Object.entries(typeSpecific)) {
@@ -105,12 +109,14 @@ export function createServiceJson(name, type, stack, port, extraFeatures = [], f
         stack,
         port,
         ...(framework ? { framework: framework.id } : {}),
+        ...(backendFramework ? { framework: backendFramework.id } : {}),
         ...(language ? { language: language.id } : {}),
     };
 }
 export function createPackageJson(name, type, frameworkId) {
     const isFrontend = type === "frontend";
     const framework = resolveFrontendFramework(type, frameworkId);
+    const backendFramework = resolveBackendFramework(type, frameworkId);
     return {
         name: `@project/${name}`,
         version: "0.0.1",
@@ -129,7 +135,7 @@ export function createPackageJson(name, type, frameworkId) {
             "lint:fix": "biome check . --write",
         },
         dependencies: {
-            ...(isFrontend ? {} : { hono: "^4.0.0" }),
+            ...(isFrontend ? {} : (backendFramework?.dependencies ?? { hono: "^4.0.0" })),
             ...(framework?.dependencies ?? {}),
         },
         devDependencies: {
@@ -142,6 +148,7 @@ export function createPackageJson(name, type, frameworkId) {
             "@biomejs/biome": "^2.5.13",
             ...(isFrontend ? { vite: "^5.0.0" } : {}),
             ...(framework?.devDependencies ?? {}),
+            ...(backendFramework?.devDependencies ?? {}),
         },
     };
 }
@@ -288,7 +295,7 @@ export const resourceCommand = new Command("resource")
     .description("Create a new resource (service) from scratch, or register an existing one")
     .argument("[name]", "Resource name (kebab-case)")
     .option("-t, --type <type>", "Resource type: backend, frontend, worker, bring-your-own, sdk", "backend")
-    .option("--framework <id>", "Frontend framework: react (default), vue")
+    .option("--framework <id>", "Framework: frontend react (default), vue, svelte, preact, lit, solid, qwik; backend hono (default), express")
     .option("--language <id>", "Backend language: bun (default), python")
     .option("-s, --stack <stack>", "Stack to assign resource to", "default")
     .option("-p, --path <path>", "Custom path for resource directory")
@@ -299,6 +306,7 @@ export const resourceCommand = new Command("resource")
     .option("--dockerfile <path>", "Path to Dockerfile relative to resource dir (for bring-your-own)")
     .option("--health-path <path>", "HTTP health check path (for bring-your-own)", "/health")
     .option("--no-proxy", "Disable the Traefik route (bring-your-own only)")
+    .option("--restart <policy>", "Compose restart policy: no, on-failure, unless-stopped, always (bring-your-own only; use no for one-shot jobs)")
     .option("--image <name>", "Docker image name instead of building from Dockerfile (for bring-your-own)")
     .option("--port <port>", "Port number (default: next free in 4000-5999)")
     .action(async (name, options) => {
@@ -350,6 +358,7 @@ export const resourceCommand = new Command("resource")
         }
         const frontendFramework = resolveFrontendFramework(resourceType, options.framework);
         const backendLanguage = resolveBackendLanguage(resourceType, options.language);
+        const backendFramework = resolveBackendFramework(resourceType, options.framework, backendLanguage);
         let dddEnabled = false;
         if (options.ddd) {
             if (resourceType !== "backend" && resourceType !== "worker") {
@@ -446,6 +455,18 @@ export const resourceCommand = new Command("resource")
         const nextPort = resourceType === "sdk"
             ? 0
             : assignPort(resourceType, allResources);
+        if (options.restart !== undefined) {
+            if (resourceType !== "bring-your-own") {
+                throw new TdkError("--restart can only be used with --type bring-your-own.", [
+                    "Add --type bring-your-own, or drop --restart",
+                ]);
+            }
+            if (!BYO_RESTART_POLICIES.includes(options.restart)) {
+                throw new TdkError(`Unknown --restart policy "${options.restart}".`, [
+                    `Use one of: ${BYO_RESTART_POLICIES.join(", ")}`,
+                ]);
+            }
+        }
         const assignedPort = resourceType === "bring-your-own"
             ? resolveByoPort(options.port, nextPort, allResources)
             : nextPort;
@@ -515,6 +536,7 @@ export const resourceCommand = new Command("resource")
                 healthCheckPath: options.healthPath || "/health",
                 ...(options.image ? { image: options.image } : { dockerfile }),
                 ...(options.proxy === false ? { exposeViaProxy: false } : {}),
+                ...(options.restart ? { restart: options.restart } : {}),
             };
             const { writeFileSync } = await import("node:fs");
             writeFileSync(resolve(fullPath, "service.json"), JSON.stringify(byoServiceJson, null, 2));
@@ -573,8 +595,8 @@ This file contains the resource configuration for TDK.
             }
         }
         // Prepare file generation tasks
-        const serviceJson = createServiceJson(resourceName, resourceType, stackName, assignedPort, dddEnabled ? ["ddd"] : [], frontendFramework?.id, options.language === undefined ? undefined : backendLanguage?.id);
-        const packageJson = createPackageJson(resourceName, resourceType, frontendFramework?.id);
+        const serviceJson = createServiceJson(resourceName, resourceType, stackName, assignedPort, dddEnabled ? ["ddd"] : [], frontendFramework?.id ?? backendFramework?.id, options.language === undefined ? undefined : backendLanguage?.id);
+        const packageJson = createPackageJson(resourceName, resourceType, frontendFramework?.id ?? backendFramework?.id);
         const tasks = [
             {
                 type: "json",
@@ -610,7 +632,7 @@ This file contains the resource configuration for TDK.
             tasks.push({
                 type: "text",
                 filename: "src/index.ts",
-                content: getBackendIndexTemplate(resourceName),
+                content: (backendFramework?.createIndex ?? getBackendIndexTemplate)(resourceName),
                 description: "Generating backend source",
                 emoji: "💻",
             });

package/cli/dist/frontend-frameworks/lit.js

@@ -0,0 +1,65 @@
+export const litFrontendProvider = {
+    id: "lit",
+    label: "Lit + Vite",
+    dependencies: {
+        lit: "^3.2.0",
+    },
+    devDependencies: {},
+    compilerOptions: {},
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <app-root></app-root>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.ts",
+                content: `import './app-root';
+`,
+                description: "Generating Lit entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/app-root.ts",
+                content: `import { LitElement, css, html } from 'lit';
+
+export class AppRoot extends LitElement {
+  static styles = css\`
+    :host {
+      display: block;
+      padding: 2rem;
+      font-family: system-ui;
+    }
+  \`;
+
+  render() {
+    return html\`
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    \`;
+  }
+}
+
+customElements.define('app-root', AppRoot);
+`,
+                description: "Generating Lit app",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=lit.js.map

package/cli/dist/frontend-frameworks/preact.js

@@ -0,0 +1,63 @@
+export const preactFrontendProvider = {
+    id: "preact",
+    label: "Preact + Vite",
+    dependencies: {
+        preact: "^10.26.0",
+    },
+    devDependencies: {
+        "@preact/preset-vite": "^2.10.0",
+    },
+    compilerOptions: {
+        jsx: "react-jsx",
+        jsxImportSource: "preact",
+    },
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.tsx",
+                content: `import { render } from 'preact';
+import App from './App';
+
+render(<App />, document.getElementById('app')!);
+`,
+                description: "Generating Preact entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.tsx",
+                content: `function App() {
+  return (
+    <div style={{ padding: '2rem', fontFamily: 'system-ui' }}>
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    </div>
+  );
+}
+
+export default App;
+`,
+                description: "Generating Preact app",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=preact.js.map

package/cli/dist/frontend-frameworks/qwik.js

@@ -0,0 +1,62 @@
+export const qwikFrontendProvider = {
+    id: "qwik",
+    label: "Qwik + Vite",
+    dependencies: {
+        "@builder.io/qwik": "^1.12.0",
+    },
+    devDependencies: {},
+    compilerOptions: {
+        jsx: "react-jsx",
+        jsxImportSource: "@builder.io/qwik",
+    },
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.tsx",
+                content: `import '@builder.io/qwik/qwikloader.js';
+import { render } from '@builder.io/qwik';
+import { App } from './App';
+
+render(document.getElementById('app') as HTMLElement, <App />);
+`,
+                description: "Generating Qwik entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.tsx",
+                content: `import { component$ } from '@builder.io/qwik';
+
+export const App = component$(() => {
+  return (
+    <div style={{ padding: '2rem', fontFamily: 'system-ui' }}>
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    </div>
+  );
+});
+`,
+                description: "Generating Qwik app",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=qwik.js.map

package/cli/dist/frontend-frameworks/registry.js

@@ -1,10 +1,20 @@
 import { TdkError } from "../utils/errors.js";
+import { litFrontendProvider } from "./lit.js";
+import { preactFrontendProvider } from "./preact.js";
+import { qwikFrontendProvider } from "./qwik.js";
 import { reactFrontendProvider } from "./react.js";
+import { solidFrontendProvider } from "./solid.js";
+import { svelteFrontendProvider } from "./svelte.js";
 import { vueFrontendProvider } from "./vue.js";
 export const DEFAULT_FRONTEND_FRAMEWORK = "react";
 export const FRONTEND_FRAMEWORKS = {
     react: reactFrontendProvider,
     vue: vueFrontendProvider,
+    svelte: svelteFrontendProvider,
+    preact: preactFrontendProvider,
+    lit: litFrontendProvider,
+    solid: solidFrontendProvider,
+    qwik: qwikFrontendProvider,
 };
 export function getFrontendFramework(frameworkId) {
     const id = (frameworkId ?? DEFAULT_FRONTEND_FRAMEWORK).trim().toLowerCase();
@@ -17,9 +27,10 @@ export function getFrontendFramework(frameworkId) {
 }
 export function resolveFrontendFramework(resourceType, frameworkId) {
     if (resourceType !== "frontend") {
-        if (frameworkId !== undefined) {
-            throw new TdkError("--framework can only be used with --type frontend.", [
-                "Add --type frontend, or drop --framework for this resource type",
+        // Backends take their own framework ids (see backend-frameworks/registry.ts).
+        if (frameworkId !== undefined && resourceType !== "backend") {
+            throw new TdkError("--framework can only be used with --type frontend or --type backend.", [
+                "Add --type frontend or --type backend, or drop --framework for this resource type",
             ]);
         }
         return undefined;

package/cli/dist/frontend-frameworks/solid.js

@@ -0,0 +1,63 @@
+export const solidFrontendProvider = {
+    id: "solid",
+    label: "Solid + Vite",
+    dependencies: {
+        "solid-js": "^1.9.0",
+    },
+    devDependencies: {
+        "vite-plugin-solid": "^2.11.0",
+    },
+    compilerOptions: {
+        jsx: "preserve",
+        jsxImportSource: "solid-js",
+    },
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.tsx",
+                content: `import { render } from 'solid-js/web';
+import App from './App';
+
+render(() => <App />, document.getElementById('app')!);
+`,
+                description: "Generating Solid entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.tsx",
+                content: `function App() {
+  return (
+    <div style={{ padding: '2rem', 'font-family': 'system-ui' }}>
+      <h1>${name}</h1>
+      <p>Frontend resource created with TDK</p>
+    </div>
+  );
+}
+
+export default App;
+`,
+                description: "Generating Solid app",
+                emoji: "💻",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=solid.js.map

package/cli/dist/frontend-frameworks/svelte.js

@@ -0,0 +1,68 @@
+export const svelteFrontendProvider = {
+    id: "svelte",
+    label: "Svelte + Vite",
+    dependencies: {
+        svelte: "^5.0.0",
+    },
+    devDependencies: {
+        "@sveltejs/vite-plugin-svelte": "^4.0.4",
+    },
+    compilerOptions: {},
+    createFiles(name) {
+        return [
+            {
+                filename: "index.html",
+                content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+`,
+                description: "Generating HTML template",
+                emoji: "💻",
+            },
+            {
+                filename: "src/main.ts",
+                content: `import { mount } from 'svelte';
+import App from './App.svelte';
+
+const app = mount(App, { target: document.getElementById('app')! });
+
+export default app;
+`,
+                description: "Generating Svelte entry",
+                emoji: "💻",
+            },
+            {
+                filename: "src/App.svelte",
+                content: `<script lang="ts">
+  const message: string = 'Frontend resource created with TDK';
+</script>
+
+<main style="padding: 2rem; font-family: system-ui">
+  <h1>${name}</h1>
+  <p>{message}</p>
+</main>
+`,
+                description: "Generating Svelte app",
+                emoji: "💻",
+            },
+            {
+                filename: "src/vite-env.d.ts",
+                content: `/// <reference types="svelte" />
+/// <reference types="vite/client" />
+`,
+                description: "Generating Svelte module types",
+                emoji: "⚙️",
+            },
+        ];
+    },
+};
+//# sourceMappingURL=svelte.js.map

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

@@ -27,6 +27,7 @@ const KNOWN_SERVICE_FIELDS = new Set([
     "playwright",
     "port",
     "replicas",
+    "restart",
     "runtime",
     "sablier",
     "schemaVersion",

package/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tdk-cli-internal",
   "private": true,
-  "version": "1.3.87",
+  "version": "1.3.88",
   "description": "TDK CLI — start services on your laptop.",
   "keywords": [
     "tdk",
@@ -53,7 +53,7 @@
     "prepack": "../scripts/stage-npm-engine.sh && npm run build"
   },
   "dependencies": {
-    "chalk": "^5.3.0",
+    "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "handlebars": "^4.7.8",
     "ink": "^7.1.1",

package/engine/schemas/service-schema.json

@@ -107,7 +107,7 @@
       "type": "string"
     },
     "appType": {
-      "description": "Resource type determining build strategy:\n• backend - Hono/Express API server\n• frontend - Vite single-page application (React or Vue, see framework)\n• sdk - Shared library package\n• worker - Background job processor\n• migrator - Database migration runner\n• library - Shared code library\n• bring-your-own - Wrap an existing service. No app scaffold. Needs Dockerfile or --image.",
+      "description": "Resource type determining build strategy:\n• backend - Hono/Express API server\n• frontend - Vite single-page application (React, Vue, Svelte, Preact, Lit, Solid or Qwik, see framework)\n• sdk - Shared library package\n• worker - Background job processor\n• migrator - Database migration runner\n• library - Shared code library\n• bring-your-own - Wrap an existing service. No app scaffold. Needs Dockerfile or --image.",
       "enum": [
         "backend",
         "frontend",
@@ -153,6 +153,16 @@
       "description": "Whether this bring-your-own resource receives a Traefik route. Defaults to true.",
       "type": "boolean"
     },
+    "restart": {
+      "description": "Docker Compose restart policy for this bring-your-own resource. Use \"no\" or \"on-failure\" for one-shot jobs such as database migrations, so a finished job is not restarted. Defaults to unless-stopped.",
+      "enum": [
+        "no",
+        "on-failure",
+        "unless-stopped",
+        "always"
+      ],
+      "type": "string"
+    },
     "image": {
       "description": "Docker image name instead of building from Dockerfile. Optional for bring-your-own type.",
       "type": "string"
@@ -215,19 +225,28 @@
       "uniqueItems": true
     },
     "framework": {
-      "description": "Frontend SPA provider used to generate Vite and TypeScript config. Only meaningful for frontend resources; omitted means react (legacy manifests).",
-      "enum": [
+      "description": "Framework provider id. For frontend resources it selects the Vite and TypeScript config (omitted means react, legacy manifests). For backend resources it selects the HTTP framework on the Bun runtime (omitted means hono; not used with a language that owns its runtime, such as python). Valid ids come from the CLI provider registries, which reject unknown ids before writing a resource.",
+      "examples": [
         "react",
-        "vue"
+        "vue",
+        "svelte",
+        "preact",
+        "lit",
+        "solid",
+        "qwik",
+        "hono",
+        "express"
       ],
+      "pattern": "^[a-z][a-z0-9-]*$",
       "type": "string"
     },
     "language": {
-      "description": "Backend language provider used to scaffold and run the service. Only meaningful for backend resources; omitted means bun (legacy manifests).",
-      "enum": [
+      "description": "Backend language provider id used to scaffold and run the service. Only meaningful for backend resources; omitted means bun (legacy manifests). Valid ids come from the CLI provider registry.",
+      "examples": [
         "bun",
         "python"
       ],
+      "pattern": "^[a-z][a-z0-9-]*$",
       "type": "string"
     },
     "healthCheckPath": {

package/engine/topologies/platform/docker/compose/compose.star

@@ -267,6 +267,13 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
         is_byo and not manifest.get('exposeViaProxy', True)
     ) if manifest else False
 
+    # One-shot jobs (migrations, seeders) must not be restarted after they exit 0, so a
+    # bring-your-own resource can choose its Compose restart policy. Default is unchanged.
+    restart_policy = 'unless-stopped'
+    if is_byo and manifest.get('restart') in ['no', 'on-failure', 'unless-stopped', 'always']:
+        restart_policy = manifest.get('restart')
+    restart_policy = '"no"' if restart_policy == 'no' else restart_policy
+
     if is_worker or is_proxy_disabled_byo:
         traefik_labels = '      - "traefik.enable=false"'
         healthcheck_section = "" if is_worker or is_byo else """    healthcheck:
@@ -299,7 +306,7 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
   {resource_entry_name}:
     image: {image_name}
     init: true
-    restart: unless-stopped
+    restart: {restart_policy}
 {build_config}
 {ports_section}
     env_file:
@@ -350,6 +357,7 @@ def _generate_single_backend_entry(resource_path, resource_name, res, manifest,
         stack=stack,
         internal_port=internal_port,
         port_anchor=internal_port,
+        restart_policy=restart_policy,
         dev_port=dev_port,
         db_name=db_name,
         db_url_for_tilt=db_url_for_tilt,

package/engine/topologies/tilt/generators/typescript/frontend_tsconfig.star

@@ -77,7 +77,7 @@ def generate_frontend_tsconfig(resource_path, write_fn, internal_deps=None, is_d
                 resource_path
             ))
             print("   Docker build will resolve @{npm_scope}/* from node_modules")
-    if framework not in ['react', 'vue']:
+    if framework not in ['react', 'vue', 'svelte', 'preact', 'lit', 'solid', 'qwik']:
         fail("Unknown frontend framework for TypeScript generation: " + str(framework))
 
     compiler_options = {
@@ -99,6 +99,15 @@ def generate_frontend_tsconfig(resource_path, write_fn, internal_deps=None, is_d
     }
     if framework == 'react':
         compiler_options['jsx'] = 'react-jsx'
+    elif framework == 'preact':
+        compiler_options['jsx'] = 'react-jsx'
+        compiler_options['jsxImportSource'] = 'preact'
+    elif framework == 'qwik':
+        compiler_options['jsx'] = 'react-jsx'
+        compiler_options['jsxImportSource'] = '@builder.io/qwik'
+    elif framework == 'solid':
+        compiler_options['jsx'] = 'preserve'
+        compiler_options['jsxImportSource'] = 'solid-js'
 
     content = {
         "compilerOptions": compiler_options,

package/engine/topologies/tilt/generators/validators.star

@@ -555,7 +555,7 @@ def generate_resource_health_check(resource_name, resource_path, manifest, check
     health_checks = []
     
     # Check 1: Required files exist
-    frontend_entry = "src/main.ts" if manifest.get("framework", "react") == "vue" else "src/main.tsx"
+    frontend_entry = "src/main.ts" if manifest.get("framework", "react") in ["vue", "svelte", "lit"] else "src/main.tsx"
     backend_files = {
         "python": ["pyproject.toml", "src/main.py"],
     }.get(manifest.get("language", "bun"), ["package.json", "prisma/schema.prisma"])

package/engine/topologies/tilt/generators/vite/frameworks/lit.star

@@ -0,0 +1,90 @@
+# Lit-specific Vite templates for frontend resources.
+
+LIT_VITE_FRONTEND = """{header}
+import {{ resolve }} from 'node:path';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: false,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [],
+  preview: {{
+    host: '0.0.0.0',
+    port: {port},
+  }},
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+{internal_aliases}
+    }},
+  }},
+  server: {{
+    host: '0.0.0.0',
+    port: {port},
+    hmr: {{
+      port: {hmr_port},
+    }},
+{proxy_config}
+  }},
+}});
+"""
+
+LIT_VITE_FRONTEND_BUILD = """{header}
+import {{ resolve }} from 'node:path';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  mode: 'production',
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: true,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+        manualChunks: undefined,
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [],
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+    }},
+    conditions: ['browser', 'import', 'module', 'es2020', 'default'],
+    mainFields: ['browser', 'module', 'jsnext:main', 'jsnext', 'main'],
+  }},
+}});
+"""

package/engine/topologies/tilt/generators/vite/frameworks/preact.star

@@ -0,0 +1,92 @@
+# Preact-specific Vite templates for frontend resources.
+
+PREACT_VITE_FRONTEND = """{header}
+import {{ resolve }} from 'node:path';
+import preact from '@preact/preset-vite';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: false,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [preact()],
+  preview: {{
+    host: '0.0.0.0',
+    port: {port},
+  }},
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+{internal_aliases}
+    }},
+  }},
+  server: {{
+    host: '0.0.0.0',
+    port: {port},
+    hmr: {{
+      port: {hmr_port},
+    }},
+{proxy_config}
+  }},
+}});
+"""
+
+PREACT_VITE_FRONTEND_BUILD = """{header}
+import {{ resolve }} from 'node:path';
+import preact from '@preact/preset-vite';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  mode: 'production',
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: true,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+        manualChunks: undefined,
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [preact()],
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+    }},
+    conditions: ['browser', 'import', 'module', 'es2020', 'default'],
+    mainFields: ['browser', 'module', 'jsnext:main', 'jsnext', 'main'],
+  }},
+}});
+"""

package/engine/topologies/tilt/generators/vite/frameworks/qwik.star

@@ -0,0 +1,92 @@
+# Qwik-specific Vite templates for frontend resources.
+
+QWIK_VITE_FRONTEND = """{header}
+import {{ resolve }} from 'node:path';
+import {{ qwikVite }} from '@builder.io/qwik/optimizer';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: false,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [qwikVite({{ csr: true }})],
+  preview: {{
+    host: '0.0.0.0',
+    port: {port},
+  }},
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+{internal_aliases}
+    }},
+  }},
+  server: {{
+    host: '0.0.0.0',
+    port: {port},
+    hmr: {{
+      port: {hmr_port},
+    }},
+{proxy_config}
+  }},
+}});
+"""
+
+QWIK_VITE_FRONTEND_BUILD = """{header}
+import {{ resolve }} from 'node:path';
+import {{ qwikVite }} from '@builder.io/qwik/optimizer';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  mode: 'production',
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: true,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+        manualChunks: undefined,
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [qwikVite({{ csr: true }})],
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+    }},
+    conditions: ['browser', 'import', 'module', 'es2020', 'default'],
+    mainFields: ['browser', 'module', 'jsnext:main', 'jsnext', 'main'],
+  }},
+}});
+"""

package/engine/topologies/tilt/generators/vite/frameworks/solid.star

@@ -0,0 +1,92 @@
+# Solid-specific Vite templates for frontend resources.
+
+SOLID_VITE_FRONTEND = """{header}
+import {{ resolve }} from 'node:path';
+import solid from 'vite-plugin-solid';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: false,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [solid()],
+  preview: {{
+    host: '0.0.0.0',
+    port: {port},
+  }},
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+{internal_aliases}
+    }},
+  }},
+  server: {{
+    host: '0.0.0.0',
+    port: {port},
+    hmr: {{
+      port: {hmr_port},
+    }},
+{proxy_config}
+  }},
+}});
+"""
+
+SOLID_VITE_FRONTEND_BUILD = """{header}
+import {{ resolve }} from 'node:path';
+import solid from 'vite-plugin-solid';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  mode: 'production',
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: true,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+        manualChunks: undefined,
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [solid()],
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+    }},
+    conditions: ['browser', 'import', 'module', 'es2020', 'default'],
+    mainFields: ['browser', 'module', 'jsnext:main', 'jsnext', 'main'],
+  }},
+}});
+"""

package/engine/topologies/tilt/generators/vite/frameworks/svelte.star

@@ -0,0 +1,92 @@
+# Svelte-specific Vite templates for frontend resources.
+
+SVELTE_VITE_FRONTEND = """{header}
+import {{ resolve }} from 'node:path';
+import {{ svelte }} from '@sveltejs/vite-plugin-svelte';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: false,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [svelte()],
+  preview: {{
+    host: '0.0.0.0',
+    port: {port},
+  }},
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+{internal_aliases}
+    }},
+  }},
+  server: {{
+    host: '0.0.0.0',
+    port: {port},
+    hmr: {{
+      port: {hmr_port},
+    }},
+{proxy_config}
+  }},
+}});
+"""
+
+SVELTE_VITE_FRONTEND_BUILD = """{header}
+import {{ resolve }} from 'node:path';
+import {{ svelte }} from '@sveltejs/vite-plugin-svelte';
+import {{ defineConfig }} from 'vite';
+
+export default defineConfig({{
+  mode: 'production',
+  base: '{base_path}',
+  build: {{
+    cssCodeSplit: false,
+    minify: true,
+    modulePreload: false,
+    rollupOptions: {{
+      output: {{
+        entryFileNames: '[name].js',
+        format: 'esm',
+        manualChunks: undefined,
+      }},
+    }},
+    target: 'esnext',
+  }},
+  define: {{
+    global: 'globalThis',
+    __DEV__: 'false',
+    'process.env.NODE_ENV': '"production"',
+  }},
+  optimizeDeps: {{
+    include: [{optimize_deps_include}],
+  }},
+  plugins: [svelte()],
+  resolve: {{
+    alias: {{
+      '@/autogenerated': resolve(__dirname),
+      '@': resolve(__dirname, '../src'),
+      'set-cookie-parser': resolve(__dirname, '../src/utils/empty-module.js'),
+    }},
+    conditions: ['browser', 'import', 'module', 'es2020', 'default'],
+    mainFields: ['browser', 'module', 'jsnext:main', 'jsnext', 'main'],
+  }},
+}});
+"""

package/engine/topologies/tilt/generators/vite/frontend.star

@@ -17,6 +17,11 @@ load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FI
 
 load('./frameworks/react.star', 'REACT_VITE_FRONTEND', 'REACT_VITE_FRONTEND_BUILD')
 load('./frameworks/vue.star', 'VUE_VITE_FRONTEND', 'VUE_VITE_FRONTEND_BUILD')
+load('./frameworks/svelte.star', 'SVELTE_VITE_FRONTEND', 'SVELTE_VITE_FRONTEND_BUILD')
+load('./frameworks/preact.star', 'PREACT_VITE_FRONTEND', 'PREACT_VITE_FRONTEND_BUILD')
+load('./frameworks/lit.star', 'LIT_VITE_FRONTEND', 'LIT_VITE_FRONTEND_BUILD')
+load('./frameworks/solid.star', 'SOLID_VITE_FRONTEND', 'SOLID_VITE_FRONTEND_BUILD')
+load('./frameworks/qwik.star', 'QWIK_VITE_FRONTEND', 'QWIK_VITE_FRONTEND_BUILD')
 load('../../../platform/docker/networking/api_path_constants.star', 'get_frontend_base_path')
 load('./helpers.star', 
     'build_header', 
@@ -38,6 +43,26 @@ _FRAMEWORK_TEMPLATES = {
         'dev': VUE_VITE_FRONTEND,
         'build': VUE_VITE_FRONTEND_BUILD,
     },
+    'svelte': {
+        'dev': SVELTE_VITE_FRONTEND,
+        'build': SVELTE_VITE_FRONTEND_BUILD,
+    },
+    'preact': {
+        'dev': PREACT_VITE_FRONTEND,
+        'build': PREACT_VITE_FRONTEND_BUILD,
+    },
+    'lit': {
+        'dev': LIT_VITE_FRONTEND,
+        'build': LIT_VITE_FRONTEND_BUILD,
+    },
+    'solid': {
+        'dev': SOLID_VITE_FRONTEND,
+        'build': SOLID_VITE_FRONTEND_BUILD,
+    },
+    'qwik': {
+        'dev': QWIK_VITE_FRONTEND,
+        'build': QWIK_VITE_FRONTEND_BUILD,
+    },
 }
 
 def _normalize_vite_base_path(base_path):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.87",
+  "version": "1.3.88",
   "description": "TDK CLI — start services on your laptop.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {
@@ -67,7 +67,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "chalk": "^5.3.0",
+    "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "handlebars": "^4.7.8",
     "ink": "^7.1.1",