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

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/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.99",
   "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.99",
   "description": "TDK CLI — start services on your laptop.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {