@tdk-landscape/tdk-cli-core 1.3.101 → 1.3.103

package/README.md

@@ -1,5 +1,16 @@
 # TDK CLI — start services on your laptop
 
+[![npm version](https://img.shields.io/npm/v/@tdk-landscape/tdk-cli-core.svg?style=flat&color=blue)](https://www.npmjs.com/package/@tdk-landscape/tdk-cli-core)
+[![unpacked size](https://img.shields.io/npm/unpacked-size/@tdk-landscape/tdk-cli-core)](https://packagephobia.com/result?p=@tdk-landscape/tdk-cli-core)
+[![install size](https://packagephobia.com/badge?p=@tdk-landscape/tdk-cli-core@1.3.81)](https://packagephobia.com/result?p=@tdk-landscape/tdk-cli-core@1.3.81)
+[![CI](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/ci.yml/badge.svg)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/ci.yml)
+[![Quickstart E2E](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/quickstart-e2e.yml/badge.svg)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/quickstart-e2e.yml)
+[![ERP fixture scale E2E](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/erp-scale-e2e.yml/badge.svg)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/erp-scale-e2e.yml)
+[![Example apps E2E](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/examples-e2e.yml/badge.svg?branch=main)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/examples-e2e.yml)
+[![Known Vulnerabilities](https://snyk.io/test/github/tdk-landscape/tdk-cli-core/badge.svg)](https://snyk.io/test/github/tdk-landscape/tdk-cli-core)
+[![Socket Badge](https://badge.socket.dev/npm/package/@tdk-landscape/tdk-cli-core/latest)](https://socket.dev/npm/package/@tdk-landscape/tdk-cli-core/overview)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
 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.
@@ -34,15 +45,6 @@ If Helm, Compose, or your existing Tilt setup already gives you a working local
 
 See [how TDK CLI works alongside Helm](https://tdk-landscape.github.io/tdk-website/docs/with-helm/), the [service schema](engine/schemas/service-schema.json), and the [project configuration schema](engine/schemas/project-schema.json).
 
-[![npm version](https://img.shields.io/npm/v/@tdk-landscape/tdk-cli-core.svg?style=flat&color=blue)](https://www.npmjs.com/package/@tdk-landscape/tdk-cli-core)
-[![CI](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/ci.yml/badge.svg)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/ci.yml)
-[![Quickstart E2E](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/quickstart-e2e.yml/badge.svg)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/quickstart-e2e.yml)
-[![ERP fixture scale E2E](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/erp-scale-e2e.yml/badge.svg)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/erp-scale-e2e.yml)
-[![Example apps E2E](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/examples-e2e.yml/badge.svg?branch=main)](https://github.com/tdk-landscape/tdk-cli-core/actions/workflows/examples-e2e.yml)
-[![Known Vulnerabilities](https://snyk.io/test/github/tdk-landscape/tdk-cli-core/badge.svg)](https://snyk.io/test/github/tdk-landscape/tdk-cli-core)
-[![Socket Badge](https://badge.socket.dev/npm/package/@tdk-landscape/tdk-cli-core/latest)](https://socket.dev/npm/package/@tdk-landscape/tdk-cli-core/overview)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-
 ## Installation
 
 Install the CLI from npm (requires Node.js 22.12+) or use the prebuilt binary (no Node.js or Bun required):

package/Tiltfile

@@ -35,6 +35,7 @@ load('./engine/topologies/tilt/resources/conditions.star', _Database='Database')
 load('./engine/topologies/tilt/resources/declaration.star', _Orchestrator='Orchestrator')
 load('./engine/topologies/tilt/resources/ordering.star', _Infra='Infra')
 load('./engine/topologies/tilt/resources/triggers.star', _Watchers='Watchers')
+load('./engine/topologies/tilt/resources/orchestrator/apply_compose_resource_registration.star', _resource_defers_start='resource_defers_start')
 
 # =============================================================================
 # SPECS (Tech stack and standards)
@@ -128,6 +129,10 @@ Orchestrator = _Orchestrator
 Infra = _Infra
 Watchers = _Watchers
 
+# True when a manifest's deferStart is actually active (licensed); decides whether a `<name>-image` prebuild resource exists.
+# The generated Tiltfile loads this from ext://tdk-cli, which resolves to this root Tiltfile.
+resource_defers_start = _resource_defers_start
+
 # Specs
 assert_tech_stack = _assert_tech_stack
 TECH_STACK = _TECH_STACK

package/cli/dist/cli.js

@@ -8,6 +8,7 @@ import { doctorCommand } from "./commands/doctor.js";
 import { downCommand } from "./commands/down.js";
 import { ejectCommand } from "./commands/eject.js";
 import { showHelp } from "./commands/help.js";
+import { importCommand } from "./commands/import.js";
 import { maintainersCommand } from "./commands/maintainers.js";
 import { networksCommand } from "./commands/networks.js";
 import { projectCommand } from "./commands/project.js";
@@ -46,6 +47,7 @@ program.addCommand(projectsCommand);
 program.addCommand(upCommand);
 program.addCommand(downCommand);
 program.addCommand(ejectCommand);
+program.addCommand(importCommand);
 program.addCommand(statusCommand);
 program.addCommand(stackCommand);
 program.addCommand(resourceCommand);

package/cli/dist/commands/import.js

@@ -0,0 +1,39 @@
+import { spawn } from "node:child_process";
+import { Command } from "commander";
+/**
+ * The importer lives in its own repo so detectors can ship without a CLI release. Until it is
+ * published to npm it is run from git; `TDK_IMPORT_PACKAGE` overrides the package spec.
+ */
+export const IMPORT_PACKAGE = "github:tdk-landscape/tdk-import";
+export function importInvocation(args, env = process.env, platform = process.platform) {
+    const pkg = env.TDK_IMPORT_PACKAGE || IMPORT_PACKAGE;
+    return {
+        command: platform === "win32" ? "npx.cmd" : "npx",
+        args: ["--yes", pkg, ...args],
+        shell: platform === "win32",
+    };
+}
+/** Runs tdk-import with the caller's terminal and resolves to its exit code. */
+export function runImport(args, spawnFn = spawn) {
+    const invocation = importInvocation(args);
+    return new Promise((resolve) => {
+        const child = spawnFn(invocation.command, invocation.args, {
+            stdio: "inherit",
+            shell: invocation.shell,
+        });
+        child.on("error", (err) => {
+            console.error(`tdk import: could not run npx (${err.message}). Install Node.js/npm and retry.`);
+            resolve(127);
+        });
+        child.on("close", (code) => resolve(code ?? 1));
+    });
+}
+export const importCommand = new Command("import")
+    .description("Import the services a directory describes (runs tdk-import)")
+    .argument("[args...]", "Passed to tdk-import: [dir] --dry-run --yes --force --only <ids>")
+    .allowUnknownOption()
+    .helpOption(false)
+    .action(async (args) => {
+    process.exitCode = await runImport(args);
+});
+//# sourceMappingURL=import.js.map

package/cli/package.json

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

package/cli/templates/Tiltfile.hbs

@@ -89,6 +89,7 @@ load('ext://tdk-cli',
 'APP_RESOURCES',
 'GLOBAL_CONFIG_EXPORT',
 'Registry',
+'resource_defers_start',
 )
 
 # =============================================================================
@@ -265,7 +266,9 @@ for _KNOWN_SVC in _app_resources_list:
                 _KNOWN_TILT_RESOURCES.add(_KNOWN_RES_NAME + '-config-gen')
                 _KNOWN_RES_MANIFEST = _KNOWN_RES.get('_manifest', {})
                 _KNOWN_RES_SABLIER = _KNOWN_RES_MANIFEST.get('sablier', {})
-                if _KNOWN_RES_SABLIER.get('enable', False) and _KNOWN_RES_SABLIER.get('deferStart', False):
+                # Mirrors _register_single_resource: the prebuild only exists for
+                # a resource that gets a docker_build (has syncs, not a library/sdk/BYO).
+                if resource_defers_start(_KNOWN_RES_MANIFEST) and _KNOWN_RES_MANIFEST.get('appType', 'backend') not in ['library', 'sdk', 'bring-your-own'] and _KNOWN_RES_MANIFEST.get('syncs'):
                     _DEFERRED_IMAGE_RESOURCES.add(_KNOWN_RES_NAME + '-image')
                 if _KNOWN_SVC_STACK:
                     _STACK_TO_RESOURCE_NAMES.setdefault(_KNOWN_SVC_STACK, [])
@@ -291,7 +294,11 @@ if FOCUS_MODE and FOCUS_ENABLED_RESOURCES:
                 # local_resource because their dc_resource is not auto-init.
                 # Keep that prebuild in focus mode so `tdk up <stack>` still
                 # prepares the image before the first request wakes the service.
-                _FILTERED_RESOURCES.append(_STACK_RES_NAME + '-image')
+                # Only when it exists: without a license deferStart is off and
+                # no `-image` resource is registered, and Tilt errors on an
+                # enabled name it cannot find.
+                if _STACK_RES_NAME + '-image' in _DEFERRED_IMAGE_RESOURCES:
+                    _FILTERED_RESOURCES.append(_STACK_RES_NAME + '-image')
         else:
             _MATCHED = [kr for kr in _KNOWN_TILT_RESOURCES if kr != 'service-discovery-daemon' and kr.startswith(_R + '-')]
             _FILTERED_RESOURCES.extend(_MATCHED)

package/engine/Tiltfile

@@ -39,6 +39,7 @@ load('./topologies/tilt/resources/conditions.star', _Database='Database')
 load('./topologies/tilt/resources/declaration.star', _Orchestrator='Orchestrator')
 load('./topologies/tilt/resources/ordering.star', _Infra='Infra')
 load('./topologies/tilt/resources/triggers.star', _Watchers='Watchers')
+load('./topologies/tilt/resources/orchestrator/apply_compose_resource_registration.star', _resource_defers_start='resource_defers_start')
 
 # =============================================================================
 # RE-EXPORTS
@@ -77,4 +78,7 @@ Orchestrator = _Orchestrator
 Infra = _Infra
 Watchers = _Watchers
 
+# True when a manifest's deferStart is actually active (licensed); decides whether a `<name>-image` prebuild resource exists.
+resource_defers_start = _resource_defers_start
+
 print("✅ TDK Engine loaded: orchestration, resources, and lifecycle")

package/engine/entrypoint.star

@@ -36,6 +36,7 @@ load("./topologies/tilt/resources/conditions.star", _Database = "Database")
 load("./topologies/tilt/resources/declaration.star", _Orchestrator = "Orchestrator")
 load("./topologies/tilt/resources/ordering.star", _Infra = "Infra")
 load("./topologies/tilt/resources/triggers.star", _Watchers = "Watchers")
+load("./topologies/tilt/resources/orchestrator/apply_compose_resource_registration.star", _resource_defers_start = "resource_defers_start")
 
 Utils = _Utils
 Manifest = _Manifest
@@ -65,6 +66,7 @@ Database = _Database
 Orchestrator = _Orchestrator
 Infra = _Infra
 Watchers = _Watchers
+resource_defers_start = _resource_defers_start
 
 # =============================================================================
 # 🔮 AUTO-DISCOVERY DAEMON

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

@@ -290,6 +290,11 @@ def _wake_compose_invocation(project_root, resource_path, res_name, resource_nam
     }
 
 
+def _image_target(config):
+    """The Dockerfile target Tilt builds and the deferStart prebuild must match: `development` for Go with `dev.liveReload`."""
+    return 'development' if Docker.go_live_reload(config.get('manifest', {})) else 'production'
+
+
 def _register_docker_build(config, live_update_rules):
     """Register docker_build with live_update for hot-reload support."""
     TypescriptBuilders.build_typescript_service(
@@ -298,7 +303,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',
+        target = _image_target(config),
     )
 
 
@@ -309,20 +314,23 @@ def _register_deferred_image_prebuild(config, auto_init_apps):
     live on tdk-erp-system, task 7.2), so a fresh project's first request would
     find no image and the wake gateway would fall back to `tilt trigger`, which
     queues behind every other build. This local_resource builds the same image
-    (same Dockerfile, `production` target, host network, and an allowlist
+    (same Dockerfile and target as docker_build: `production`, or `development` for Go with `dev.liveReload`; host network, and an allowlist
     .dockerignore equivalent to docker_build's only=/ignore=) under the tag the
     compose service declares, so the gateway can start it directly.
     """
     project_root = config.get('project_root', '')
     dockerfile = _resolve_dockerfile(config)
     prebuild_dockerfile = dockerfile + '.prebuild'
+    # The same target _register_docker_build picks: a Go service with `dev.liveReload` runs the development image (the watcher), so
+    # prebuilding `production` under the same tag would start the compiled binary with no reload.
+    target = _image_target(config)
     ignore_content = TypescriptBuilders.prebuild_dockerignore(dockerfile, project_root, config['res_path'])
     # BuildKit reads `<dockerfile>.dockerignore` for `-f <dockerfile>`; the
     # original Dockerfile already has a (denylist) one, hence the copy.
     cmd = (
         "cp '" + dockerfile + "' '" + prebuild_dockerfile + "'"
         + " && printf '%s' '" + ignore_content + "' > '" + prebuild_dockerfile + ".dockerignore'"
-        + " && docker build --network host --target production"
+        + " && docker build --network host --target " + target
         + " -f '" + prebuild_dockerfile + "'"
         + " -t '" + _app_image_name(config['resource_name'], config['res_name']) + "'"
         + " '" + (project_root or '.') + "'"

package/package.json

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