@tdk-landscape/tdk-cli-core 1.3.98 → 1.3.100

package/README.md

@@ -1,5 +1,7 @@
 # TDK CLI — start services on your laptop
 
+English | [简体中文](README-zh_cn.md) | [繁體中文](README-zh_tw.md) | [日本語](README-ja.md) | [한국어](README-ko.md)
+
 TDK CLI starts your services on your laptop. It is not a deploy and not a Compose file: define each service in `service.json`, then run `tdk up`. No Kubernetes is needed on the machine.
 
 Stability: 1.x local dev. Generated files are a contract; verify with `tdk config verify`. Core CLI is MIT and needs no key. Premium is optional.

package/cli/dist/commands/ui.js

@@ -8,11 +8,11 @@ import { findProjectRoot } from "../utils/paths.js";
 import { clearMetadataCache, discoverResources, discoverStacks, getResourceMetadata, getStackMetadata, } from "../utils/services.js";
 import { isTiltAvailable } from "../utils/tilt.js";
 // biome-ignore lint/correctness/noUnusedFunctionParameters: reserved callback prop kept in the component API
-const HelpPanel = ({ onClose }) => (_jsxs(Box, { borderStyle: "single", borderColor: "cyan", paddingX: 2, paddingY: 1, flexDirection: "column", width: 60, children: [_jsx(Text, { bold: true, color: "cyan", children: "Keyboard Shortcuts" }), _jsxs(Box, { marginY: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, underline: true, children: "Navigation" }), _jsx(Text, { children: " \u2191/\u2193 Navigate list items" }), _jsx(Text, { children: " Enter Select item / Open detail" }), _jsx(Text, { children: " Space Toggle expand (tree view)" }), _jsx(Text, { children: " Tab Next tab" }), _jsx(Text, { children: " 1-5 Direct tab access" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, underline: true, children: "Actions" }) }), _jsx(Text, { children: " m Toggle mouse support" }), _jsx(Text, { children: " t Toggle tooltips" }), _jsx(Text, { children: " e Toggle enabled/disabled services" }), _jsx(Text, { children: " r Refresh data" }), _jsx(Text, { children: " / Search/filter" }), _jsx(Text, { children: " ? Show this help" }), _jsx(Text, { children: " q/Esc Quit / Back" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: "Press any key to close..." }) })] }));
+const HelpPanel = ({ onClose }) => (_jsxs(Box, { borderStyle: "single", borderColor: "cyan", paddingX: 2, paddingY: 1, flexDirection: "column", width: 60, children: [_jsx(Text, { bold: true, color: "cyan", children: "Keyboard Shortcuts" }), _jsxs(Box, { marginY: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, underline: true, children: "Navigation" }), _jsx(Text, { children: " \u2191/\u2193 Navigate list items" }), _jsx(Text, { children: " Enter Select item / Open detail" }), _jsx(Text, { children: " Space Toggle expand (tree view)" }), _jsx(Text, { children: " Tab Next tab" }), _jsx(Text, { children: " 1-5 Direct tab access" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, underline: true, children: "Actions" }) }), _jsx(Text, { children: " m Toggle mouse support" }), _jsx(Text, { children: " t Toggle tooltips" }), _jsx(Text, { children: " e Toggle enabled/disabled services" }), _jsx(Text, { children: " r Refresh data" }), _jsx(Text, { children: " / Search/filter" }), _jsx(Text, { children: " ? Show this help" }), _jsx(Text, { children: " q Quit \u2502 Esc Back" })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: "Press any key to close..." }) })] }));
 const LoadingScreen = ({ progress, message }) => (_jsxs(Box, { flexDirection: "column", padding: 2, children: [_jsx(Text, { bold: true, color: "cyan", children: "\u2593\u2592\u2591 TDK NEON EDITION \u2591\u2592\u2593" }), _jsx(Box, { marginY: 1 }), _jsxs(Text, { children: ["Loading: ", message] }), _jsxs(Box, { marginY: 1, borderStyle: "single", borderColor: "gray", width: 50, children: [_jsx(Box, { width: progress / 2, backgroundColor: "cyan", children: _jsx(Text, { children: " ".repeat(progress / 2) }) }), _jsxs(Text, { children: [" ", progress, "%"] })] })] }));
 // biome-ignore lint/correctness/noUnusedFunctionParameters: reserved callback prop kept in the component API
 const ErrorScreen = ({ error, onRetry }) => (_jsxs(Box, { flexDirection: "column", padding: 2, alignItems: "center", children: [_jsx(Text, { bold: true, color: "red", children: "Could Not Load Services" }), _jsx(Box, { marginY: 1 }), _jsxs(Text, { color: "red", children: ["\u2717 ", error] }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: "gray", children: "Troubleshooting:" }), _jsx(Text, { color: "gray", children: " 1. Check that every service.json is valid JSON" }), _jsx(Text, { color: "gray", children: " 2. Run tdk from your project (the folder with the Tiltfile)" }), _jsx(Text, { color: "gray", children: " 3. Try: tdk status --verbose" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: "cyan", children: "Press [r] to retry or [q] to quit" })] }));
-const EmptyState = () => (_jsxs(Box, { flexDirection: "column", padding: 2, alignItems: "center", children: [_jsx(Text, { bold: true, color: "yellow", children: "No Services Found" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: "gray", children: "\u25C9 No service.json files found" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { children: "To get started:" }), _jsx(Text, { children: " 1. Run: tdk init" }), _jsx(Text, { children: " 2. Or create services manually" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: "cyan", children: "Press [r] to refresh or [q] to quit" })] }));
+const EmptyState = ({ message }) => (_jsxs(Box, { flexDirection: "column", padding: 2, alignItems: "center", children: [_jsx(Text, { bold: true, color: "yellow", children: "No Services Found" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: "gray", children: "\u25C9 No service.json files found" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { children: "To get started:" }), _jsx(Text, { children: " 1. Run: tdk init" }), _jsx(Text, { children: " 2. Or create services manually" }), _jsx(Box, { marginY: 1 }), _jsx(Text, { color: "cyan", children: "Press [r] to refresh or [q] to quit" }), message && (_jsx(Box, { paddingX: 1, height: 1, children: _jsxs(Text, { color: "cyan", children: ["\u2593\u2592\u2591 ", message, " \u2591\u2592\u2593"] }) }))] }));
 const TUIApp = () => {
     const { exit } = useApp();
     const { stdout } = useStdout();
@@ -297,7 +297,8 @@ const TUIApp = () => {
                 setSelectedStack(null);
                 return;
             }
-            exit();
+            setMessage("Press q to quit");
+            setTimeout(() => setMessage(""), 2000);
             return;
         }
         if (input === "?") {
@@ -413,7 +414,7 @@ const TUIApp = () => {
         return _jsx(ErrorScreen, { error: error, onRetry: refresh });
     }
     if (services.length === 0) {
-        return _jsx(EmptyState, {});
+        return _jsx(EmptyState, { message: message });
     }
     return (_jsxs(Box, { flexDirection: "column", height: stdout.rows || 24, children: [_jsx(Box, { paddingX: 1, paddingY: 0, children: _jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: "\u2593\u2592\u2591 TDK NEON EDITION \u2591\u2592\u2593" }), _jsx(Text, { color: "gray", children: " \u2502 " }), _jsx(Text, { color: "white", children: projectRoot }), _jsx(Text, { color: "gray", children: " \u2502 " }), _jsxs(Text, { color: "green", children: [services.length, " services ready"] })] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { color: "gray", children: "─".repeat(compact ? 60 : Math.min(terminalWidth - 4, 100)) }) }), isSearching && (_jsx(Box, { paddingX: 1, height: 1, children: _jsxs(Text, { color: "yellow", children: ["Search: ", searchQuery, "_"] }) })), !isSearching && message && (_jsx(Box, { paddingX: 1, height: 1, children: _jsxs(Text, { color: "cyan", children: ["\u2593\u2592\u2591 ", message, " \u2591\u2592\u2593"] }) })), !isSearching && !message && showTooltips && !showHelp && (_jsx(Box, { paddingX: 1, height: 1, children: _jsx(Text, { color: "gray", dimColor: true, children: activeTab === "overview" && selectedStack
                         ? `Stack "${selectedStack}" selected. [Enter] view │ [Esc] back │ [e] ${showEnabledOnly ? "show all" : "enabled only"} │ [?] help`

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

@@ -66,6 +66,13 @@ export function validateServiceManifest(value, displayPath) {
     if ("schemaVersion" in manifest && manifest.schemaVersion !== SERVICE_MANIFEST_SCHEMA_VERSION) {
         errors.push(`${displayPath}.schemaVersion: unsupported version ${String(manifest.schemaVersion)} (supported: ${SERVICE_MANIFEST_SCHEMA_VERSION})`);
     }
+    const dev = manifest.dev;
+    const liveReload = dev && typeof dev === "object" && !Array.isArray(dev)
+        ? dev.liveReload
+        : undefined;
+    if (liveReload !== undefined && typeof liveReload !== "boolean") {
+        errors.push(`${displayPath}.dev.liveReload: expected true or false`);
+    }
     if ("smoke" in manifest) {
         for (const message of validateSmoke(manifest.smoke))
             errors.push(`${displayPath}.${message}`);
@@ -78,6 +85,9 @@ export function validateServiceManifest(value, displayPath) {
             return [`${displayPath}.${field}: unknown field is preserved`];
         return [];
     });
+    if (liveReload === true && manifest.language !== "go") {
+        warnings.push(`${displayPath}.dev.liveReload: only applies to Go services (language "go"); it is ignored here`);
+    }
     return { errors, warnings, manifest };
 }
 export function validateServiceManifestFile(filePath, displayPath) {

package/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tdk-cli-internal",
   "private": true,
-  "version": "1.3.98",
+  "version": "1.3.100",
   "description": "TDK CLI — start services on your laptop.",
   "keywords": [
     "tdk",

package/engine/topologies/platform/docker/dockerfile/language_dockerfile.star

@@ -62,7 +62,7 @@ RUN CGO_ENABLED=0 go build -o /out/app .
 
 FROM build AS test
 RUN go test ./...
-
+{go_development}
 FROM debian:bookworm-slim AS production
 
 {curl}
@@ -102,14 +102,35 @@ EXPOSE {port}
 CMD ["app"]
 """
 
-def generate_language_dockerfile(res_path, language, port = BASE_PORT_BACKEND):
+# Opt-in Go development target (`dev.liveReload`): the toolchain image with Air, which rebuilds and restarts the app when a `.go`
+# file changes. Dependencies are downloaded in their own layer and the module and build caches live in BuildKit cache mounts, so an
+# ordinary source edit recompiles incrementally. `go.mod`, `go.sum` and the Dockerfile still rebuild the image.
+_GO_DEVELOPMENT = """
+FROM golang:1.23-bookworm AS development
+RUN go install github.com/air-verse/air@v1.61.7
+WORKDIR /app/{res_path}
+COPY {res_path}/go.* ./
+RUN --mount=type=cache,target=/go/pkg/mod go mod download
+COPY {res_path}/ ./
+ENV GOFLAGS=-buildvcs=false
+# Prime the build cache inside the image (a cache mount would not be kept), so the first edit recompiles only what changed.
+RUN go build -o /tmp/app .
+EXPOSE {port}
+CMD ["sh", "-c", "exec air --build.cmd 'go build -o /tmp/app .' --build.bin /tmp/app --build.include_ext go"]
+"""
+
+def generate_language_dockerfile(res_path, language, port = BASE_PORT_BACKEND, dev = False):
     """Dockerfile text for a provider-owned backend language, or fail for an unknown one."""
     template = {"python": _PYTHON, "go": _GO, "rust": _RUST}.get(language)
     if template == None:
         fail("No Dockerfile generator for backend language '{}'".format(language))
+    go_development = ""
+    if dev and language == "go":
+        go_development = _GO_DEVELOPMENT.format(res_path = res_path, port = port)
     return template.format(
         res_path = res_path,
         port = port,
+        go_development = go_development,
         curl = _CURL,
         healthcheck = _HEALTHCHECK.format(port = port),
     )
@@ -120,3 +141,13 @@ def is_provider_owned_language(manifest):
     if not manifest:
         return False
     return manifest.get("appType", "backend") == "backend" and manifest.get("language", "bun") in PROVIDER_OWNED_LANGUAGES
+
+
+def go_live_reload_enabled(manifest):
+    """True for a Go service that opted in with `dev.liveReload: true` (see _GO_DEVELOPMENT); anything else stays off."""
+    if not manifest or manifest.get("language", "bun") != "go":
+        return False
+    dev = manifest.get("dev")
+    if type(dev) != "dict":
+        return False
+    return dev.get("liveReload") == True

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

@@ -8,6 +8,7 @@ load(
     "./dockerfile/language_dockerfile.star",
     "generate_language_dockerfile",
     "is_provider_owned_language",
+    "go_live_reload_enabled",
     "LANGUAGE_REQUIRED_FILES",
 )
 load("./config/dockerignore.star", "generate_dockerignore")
@@ -26,6 +27,7 @@ Docker = struct(
     migrator = generate_migrator_dockerfile,
     backend_language = generate_language_dockerfile,
     is_provider_owned_language = is_provider_owned_language,
+    go_live_reload = go_live_reload_enabled,
     language_required_files = LANGUAGE_REQUIRED_FILES,
     generate_dockerignore = generate_dockerignore,
     frontend_compose = generate_frontend_compose,

package/engine/topologies/tilt/resources/orchestrator/apply_compose_resource_registration.star

@@ -215,7 +215,7 @@ def _live_update_sync_source(project_root, full_res_path, sync_path):
     return relative_path
 
 
-def _build_live_update_rules(res_path, full_res_path, syncs, project_root='', language='bun'):
+def _build_live_update_rules(res_path, full_res_path, syncs, project_root='', language='bun', go_live_reload=False):
     """Build live update sync and run rules for a resource.
 
     Python backends reload their own process after a sync (uvicorn --reload), so they have
@@ -225,9 +225,22 @@ def _build_live_update_rules(res_path, full_res_path, syncs, project_root='', la
     # Go and Rust are compiled into the image and have no reload process, so syncing sources would leave the
     # old binary running. Return before any sync() step is built (Tilt rejects sync steps that are created
     # but never used): no live-update rules means Tilt rebuilds the image when a watched file changes.
-    if language in ['go', 'rust']:
+    if language == 'rust' or (language == 'go' and not go_live_reload):
         return []
 
+    if go_live_reload:
+        # Opted-in Go development loop: sync the sources into the development image, where Air rebuilds and restarts.
+        # Dependency and Dockerfile changes cannot be picked up by a restart, so they fall back to a full image rebuild.
+        source_dir = _live_update_sync_source(project_root, full_res_path, '')
+        return [
+            fall_back_on([
+                source_dir + 'go.mod',
+                source_dir + 'go.sum',
+                source_dir + OUTPUT.AUTOGENERATED_FOLDER,
+            ]),
+            sync(source_dir.rstrip('/'), '/app/' + full_res_path),
+        ]
+
     live_update_rules = []
     for sync_path in syncs:
         # Python images never read the npm/Bun registry config, and the engine does not
@@ -285,6 +298,7 @@ def _register_docker_build(config, live_update_rules):
         _resolve_dockerfile(config),
         live_update_rules,
         config['res_deps'],
+        target = 'development' if Docker.go_live_reload(config.get('manifest', {})) else 'production',
     )
 
 
@@ -408,6 +422,7 @@ def _register_single_resource(config, resource_path, compose_project_name, auto_
             config['syncs'],
             project_root=config.get('project_root', ''),
             language=config.get('manifest', {}).get('language', 'bun'),
+            go_live_reload=Docker.go_live_reload(config.get('manifest', {})),
         )
         _register_docker_build(config, live_update_rules)
         if defers_start:

package/engine/topologies/tilt/resources/orchestrator/builders/typescript.star

@@ -105,7 +105,7 @@ def _get_resource_only_paths(resource_path):
 
     return only_paths
 
-def _build_typescript_service(name, context, dockerfile, live_update_rules, deps, env=None):
+def _build_typescript_service(name, context, dockerfile, live_update_rules, deps, env=None, target='production'):
     """Build a TypeScript service with Docker.
     
     Args:
@@ -115,6 +115,7 @@ def _build_typescript_service(name, context, dockerfile, live_update_rules, deps
         live_update_rules: Live update configuration
         deps: Resource dependencies
         env: Dict of environment variables to pass to container (optional)
+        target: Dockerfile target to build (`development` for an opted-in Go service, otherwise `production`)
     """
     # Extract service path from dockerfile path (e.g., 'services/product/{domain}/{service-name}')
     # The dockerfile parameter looks like: 'services/product/{domain}/{service-name}/autogenerated/Dockerfile.autogenerated'
@@ -154,7 +155,7 @@ def _build_typescript_service(name, context, dockerfile, live_update_rules, deps
         name,
         context,
         dockerfile=dockerfile,
-        target='production',
+        target=target,
         live_update=live_update_rules,
         only=_get_resource_only_paths(resource_path),
         ignore=ignore_patterns,

package/engine/topologies/tilt/resources/orchestrator/generators/manifest_resource.star

@@ -382,6 +382,7 @@ def _generate_all_configs_for_resource(
             res_path=resource_path,
             language=manifest.get('language'),
             port=manifest.get('port', 4000),
+            dev=Docker.go_live_reload(manifest),
         )
     else:
         dockerfile_content = Docker.backend(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.98",
+  "version": "1.3.100",
   "description": "TDK CLI — start services on your laptop.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {