@tdk-landscape/tdk-cli-core 1.3.70 → 1.3.72

package/CHANGELOG.md

@@ -4,6 +4,14 @@ Notable changes to the `tdk` CLI. Versions match [npm](https://www.npmjs.com/pac
 
 ## Unreleased
 
+- `tdk doctor` no longer fails with "Verdaccio is not reachable" when the project config enables Verdaccio but no Premium license grants it. TDK does not start Verdaccio in that case, so the check could never pass; it is now skipped with a note. A registry your own `.npmrc` points at (`:4873`) is still checked. Found by the ERP CI workflow.
+
+## 1.3.71 (2026-09-28)
+
+- `tdk project` in a freshly cloned repo (one that already has `.tdk/project.json`) now creates the missing `.env` with working defaults. Before, it regenerated the configs but left no `.env`, and `tdk doctor` then failed with "set VERDACCIO_URL_DOCKER=<value>". Doctor now says to run `tdk project` when there is no `.env` at all. Found by the ERP CI workflow.
+
+## 1.3.70 (2026-09-28)
+
 - **Fix for 1.3.69:** `tdk doctor` no longer reports "Environment not ready" for the ERP example. The new check for missing `@types/*` packages flagged its 7 frontends, but they build with `vite build`, which never type-checks, so `types: ["node"]` cannot fail their build. It now only flags a service whose `build` script runs `tsc` (following `bun|npm|pnpm|yarn run` hops). Found by the new ERP CI workflow on its first run.
 
 - New CI workflow that boots the public 100-service ERP example on a clean GitHub-hosted runner with the published CLI and waits for every backend to answer `/health` through Traefik, then writes the time to healthy and the resource use to the job summary. Manual (`full` or `one-stack`) and weekly.

package/cli/dist/commands/doctor.js

@@ -3,8 +3,9 @@ import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { dirname, join, normalize } from "node:path";
 import chalk from "chalk";
 import { Command } from "commander";
+import { hasVerdaccioLicense } from "../generator/extension-fetch.js";
 import { MASTER_CONFIG_FILES, QUICKSTART_DOCS_URL, REQUIRED_PACKAGE_SCRIPTS, } from "../utils/constants.js";
-import { checkHealthRoutes, checkHostPorts, checkIngressPorts, checkPrivateNpmRegistry, checkTiltResourceHealth, summarizeServiceProbes, } from "../utils/doctor-runtime.js";
+import { checkHealthRoutes, checkHostPorts, checkIngressPorts, checkPrivateNpmRegistry, checkTiltResourceHealth, projectConfigEnablesVerdaccio, summarizeServiceProbes, } from "../utils/doctor-runtime.js";
 import { validateEnvFile } from "../utils/env-validator.js";
 import { formatCount } from "../utils/formatting.js";
 import { findProjectRoot } from "../utils/paths.js";
@@ -177,7 +178,9 @@ function checkEnvironmentVariables() {
             name: "Environment Variables",
             didPass: false,
             message: `Missing required env variables: ${validation.missing.join(", ")}`,
-            fix: `Edit .env and set these values:\n    ${validation.missing.map((v) => `${v}=<value>`).join("\n    ")}`,
+            fix: existsSync(join(projectRoot, ".env"))
+                ? `Edit .env and set these values:\n    ${validation.missing.map((v) => `${v}=<value>`).join("\n    ")}`
+                : "No .env file yet. Run `tdk project` to create one with working defaults.",
         };
     }
     if (validation.invalid.length > 0) {
@@ -753,7 +756,13 @@ export const doctorCommand = new Command("doctor")
         // Preflight: a local Postgres or web server on 5432/80/443.
         () => checkHostPorts(),
         // Preflight: Verdaccio down causes ImageBuild bun install ConnectionRefused.
-        checkPrivateNpmRegistry,
+        async () => {
+            const root = findProjectRoot() ?? process.cwd();
+            const licensed = projectConfigEnablesVerdaccio(root)
+                ? await hasVerdaccioLicense(root)
+                : true;
+            return checkPrivateNpmRegistry(execSync, root, undefined, licensed);
+        },
         // Runtime checks: skip gracefully if the stack isn't started yet.
         checkContainerResourceHealth,
         // When Tilt is up, surface red resources (Traefik/apps never started).

package/cli/dist/commands/project.js

@@ -218,6 +218,9 @@ export const projectCommand = new Command("project")
             }
             showStep("\n📋 Regenerating master configuration files...\n");
             await generateMasterConfigs(projectRoot);
+            if (ensureEnvFile(projectRoot)) {
+                showSuccess("Created: .env (the defaults work as-is)");
+            }
             const ignored = ensureGitignore(projectRoot);
             if (ignored.length > 0) {
                 showSuccess(`Added to .gitignore: ${ignored.join(", ")}`);

package/cli/dist/utils/doctor-runtime.js

@@ -175,23 +175,20 @@ export function summarizeTiltBuildError(error) {
 export function isRegistryRelatedBuildError(error) {
     return /ConnectionRefused downloading package manifest|Verdaccio|private registry|dependency install failed during ImageBuild|install-deps\.sh|bun install/i.test(error);
 }
-export function projectExpectsVerdaccio(projectRoot = findProjectRoot() ?? process.cwd()) {
+export function projectConfigEnablesVerdaccio(projectRoot = findProjectRoot() ?? process.cwd()) {
     const projectJsonPath = join(projectRoot, ".tdk", "project.json");
-    if (existsSync(projectJsonPath)) {
-        try {
-            const parsed = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
-            if (parsed.optional_infra?.verdaccio === true) {
-                return true;
-            }
-            if (Object.values(parsed.phases ?? {}).some((phase) => (phase.enabledStacks ?? []).includes("verdaccio"))) {
-                return true;
-            }
-        }
-        catch {
-            // Fall through to npmrc heuristics.
-        }
+    if (!existsSync(projectJsonPath))
+        return false;
+    try {
+        const parsed = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
+        return (parsed.optional_infra?.verdaccio === true ||
+            Object.values(parsed.phases ?? {}).some((phase) => (phase.enabledStacks ?? []).includes("verdaccio")));
     }
-    // Heuristic: scoped private registry pointed at :4873
+    catch {
+        return false;
+    }
+}
+function npmrcPointsAtVerdaccio(projectRoot) {
     for (const candidate of [join(projectRoot, ".npmrc"), join(projectRoot, "package.json")]) {
         if (!existsSync(candidate))
             continue;
@@ -207,13 +204,24 @@ export function projectExpectsVerdaccio(projectRoot = findProjectRoot() ?? proce
     }
     return false;
 }
+export function projectExpectsVerdaccio(projectRoot = findProjectRoot() ?? process.cwd()) {
+    return projectConfigEnablesVerdaccio(projectRoot) || npmrcPointsAtVerdaccio(projectRoot);
+}
 /**
  * When the project uses a local Verdaccio registry, fail early with a clear
  * fix instead of only showing truncated ImageBuild exit codes later.
  */
 export function checkPrivateNpmRegistry(exec = execSync, projectRoot = findProjectRoot() ?? process.cwd(), registryUrl = process.env.VERDACCIO_URL ??
     process.env.NPM_REGISTRY_URL ??
-    DEFAULT_VERDACCIO_URL) {
+    DEFAULT_VERDACCIO_URL, verdaccioLicensed = true) {
+    if (!verdaccioLicensed && !npmrcPointsAtVerdaccio(projectRoot)) {
+        return {
+            name: "Private npm registry",
+            didPass: true,
+            isSkipped: true,
+            message: "Verdaccio is enabled in the project config but needs a Premium license, so TDK will not start it - skipped",
+        };
+    }
     if (!projectExpectsVerdaccio(projectRoot)) {
         return {
             name: "Private npm registry",

package/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tdk-cli-internal",
   "private": true,
-  "version": "1.3.70",
+  "version": "1.3.72",
   "description": "TDK CLI - Tilt Development Kit command line interface",
   "keywords": [
     "tdk",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.70",
+  "version": "1.3.72",
   "description": "Run 100 microservices on a 16 GB laptop without Kubernetes. Scaffold services and run them locally with hot reload, built on Tilt.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {