@flisk-sh/flisk 1.3.207 → 1.4.0

package/cli/dist/generator/template-engine.js

@@ -8,8 +8,9 @@ import { PLATFORM_STANDARDS } from "../config/platform-standards.js";
 import { writeTextFileAtomic } from "../utils/atomic-write.js";
 import { AUTOGENERATED_DIR, DATABASE_MANAGEMENT_FEATURE, DOCKER_COMPOSE_FILE, PACKAGE_JSON, PROJECT_JSON, RESOURCE_DEFAULTS_FILE, TECH_STACK_FILE, TILTIGNORE_FILE, } from "../utils/constants.js";
 import { writeTextFile } from "../utils/file-helpers.js";
-import { assertTdkGeneratedPath } from "../utils/generated-paths.js";
+import { assertFliskGeneratedPath } from "../utils/generated-paths.js";
 import { DEFAULT_ALWAYS_ENABLED_INFRA } from "../utils/project-config-defaults.js";
+import { describeLayoutProblems, EXTENSION_DIRS, hasExtensionLayout, inspectExtensionLayout, resolveExtensionDir, resolveTiltfile, } from "../utils/runtime-layout.js";
 import { generatedFieldErrorsForFile, validateServiceManifestFile, } from "../utils/service-manifest.js";
 import { discoverResourcesFromRoot, discoverServiceManifestPaths } from "../utils/services.js";
 import { isStackFeatureEnabledInStacks } from "../utils/stack-features.js";
@@ -26,9 +27,9 @@ export function loadTemplate(filename) {
         path.join(process.cwd(), "node_modules", "@flisk-sh", "flisk", "templates"), // Monorepo root
         // Compiled single-file binary (bun build --compile): __dirname resolves inside the
         // virtual $bunfs filesystem, not a real path, so fall back to the directory the actual
-        // executable lives in. release-binaries.sh bundles cli/templates at tdk-cli/cli/templates
+        // executable lives in. release-binaries.sh bundles cli/templates at flisk-cli/cli/templates
         // next to the platform binaries.
-        path.join(path.dirname(process.execPath), "tdk-cli", "cli", "templates"),
+        path.join(path.dirname(process.execPath), "flisk-cli", "cli", "templates"),
     ];
     const triedPaths = [];
     for (const templateDir of templateDirs) {
@@ -225,11 +226,11 @@ function toComposeProjectName(projectName) {
     return projectName.replace(/-/g, "_");
 }
 export function generateDatabaseManagementCompose(projectConfig) {
-    const name = toComposeProjectName(projectConfig.project.name || "tdk_project");
+    const name = toComposeProjectName(projectConfig.project.name || "flisk_project");
     return `###############################################################################
 # SYSTEM-GENERATED - DO NOT EDIT
 # Stack feature: database-management
-# Source: .tdk/project.json phases.*.enabledStacks includes "database-management"
+# Source: .flisk/project.json phases.*.enabledStacks includes "database-management"
 # Regenerate with: flisk config regenerate
 ###############################################################################
 
@@ -243,7 +244,7 @@ services:
       POSTGRES_PASSWORD: \${DB_PASSWORD}
       POSTGRES_DB: postgres
     ports:
-      - "\${TDK_BIND_ADDRESS:-127.0.0.1}:\${TDK_POSTGRES_PORT:-15432}:5432"
+      - "\${FLISK_BIND_ADDRESS:-127.0.0.1}:\${FLISK_POSTGRES_PORT:-15432}:5432"
     volumes:
       - ${name}_postgres_data:/var/lib/postgresql/data
     networks:
@@ -361,11 +362,11 @@ function normalizeProjectConfig(value) {
         overrides: config.overrides,
     };
 }
-/** The project has no .tdk/project.json yet, as opposed to one that exists but is unreadable or invalid. */
+/** The project has no .flisk/project.json yet, as opposed to one that exists but is unreadable or invalid. */
 export class ProjectConfigNotFoundError extends Error {
 }
 /**
- * Reads, parses, and normalizes `.tdk/project.json` from the given project root.
+ * Reads, parses, and normalizes `.flisk/project.json` from the given project root.
  *
  * The file is read directly instead of being existence-checked first: `fs.existsSync` swallows
  * filesystem errors and reports an inaccessible config as missing, which hides the real reason.
@@ -375,7 +376,7 @@ export class ProjectConfigNotFoundError extends Error {
  * @returns The validated and normalized {@link ProjectConfig}.
  */
 export function readProjectConfig(projectRoot) {
-    const projectJsonPath = path.join(projectRoot, ".tdk", PROJECT_JSON);
+    const projectJsonPath = path.join(projectRoot, ".flisk", PROJECT_JSON);
     let jsonContent;
     try {
         jsonContent = fs.readFileSync(projectJsonPath, "utf-8");
@@ -409,8 +410,8 @@ export function readProjectConfig(projectRoot) {
 // Premium, but unlike Verdaccio below, this is NOT the enforcement - it's a
 // friendly heads-up. The real gate is that engine/.../sablier_container_cycle.star
 // in this (public) repo is a free-tier stub that always returns disabled; the
-// working implementation only exists in the private tdk-cli-extensions/premium/
-// bundle, applied by vendorTdkExtension()'s applyPremiumOverlay() below when a
+// working implementation only exists in the private flisk-cli-extensions/premium/
+// bundle, applied by vendorFliskExtension()'s applyPremiumOverlay() below when a
 // license grants it. Forking this repo and deleting a license check (as you
 // could with Verdaccio/DDD) gets you nothing here, because there's no check to
 // delete - the actual code simply isn't present without the overlay. This just
@@ -425,11 +426,11 @@ async function warnIfSablierUnlicensed(projectRoot) {
         return;
     console.warn(`⚠️  Sablier (on-demand scaling) is a Premium feature - no valid license key found. ` +
         `${resources.length} resource${resources.length === 1 ? " has" : "s have"} a \`sablier\` block, ` +
-        "but it will have no effect without a license. Set TDK_LICENSE_KEY to a key that grants it, " +
+        "but it will have no effect without a license. Set FLISK_LICENSE_KEY to a key that grants it, " +
         "or remove the `sablier` block from the affected service.json file(s) to silence this warning.");
 }
 function ensureRootWorkspaceManifest(projectRoot, projectConfig) {
-    const packageJsonPath = assertTdkGeneratedPath(projectRoot, PACKAGE_JSON);
+    const packageJsonPath = assertFliskGeneratedPath(projectRoot, PACKAGE_JSON);
     if (fs.existsSync(packageJsonPath)) {
         return false;
     }
@@ -459,8 +460,8 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
     // enforcement - it's a friendly heads-up. The real gate is that
     // engine/topologies/platform/registries/verdaccio_loader.star in this
     // (public) repo is a free-tier stub that always skips; the working loader
-    // only exists in the private tdk-cli-extensions/premium/ bundle, applied
-    // by vendorTdkExtension()'s applyPremiumOverlay() below when a license
+    // only exists in the private flisk-cli-extensions/premium/ bundle, applied
+    // by vendorFliskExtension()'s applyPremiumOverlay() below when a license
     // grants it. Forking this repo and deleting a license check gets you
     // nothing, because there's no check left to delete - the actual code
     // simply isn't present without the overlay. This just tells a confused
@@ -471,11 +472,11 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
         const granted = await hasVerdaccioLicense(projectRoot);
         if (!granted) {
             console.warn("⚠️  Verdaccio is a Premium feature - no valid license key found. It's enabled in " +
-                "this project's config, but will have no effect without a license. Set TDK_LICENSE_KEY " +
+                "this project's config, but will have no effect without a license. Set FLISK_LICENSE_KEY " +
                 "to a key that grants it, or run `flisk config disable-infra verdaccio` to silence this warning.");
         }
     }
-    const outputDir = path.join(projectRoot, ".tdk", ".tdk-out");
+    const outputDir = path.join(projectRoot, ".flisk", ".flisk-out");
     if (!fs.existsSync(outputDir)) {
         fs.mkdirSync(outputDir, { recursive: true });
     }
@@ -483,13 +484,13 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
     const files = engine.generateAll(projectConfig);
     for (const filename of ALL_GENERATED_FILES) {
         const content = files[filename];
-        const filePath = assertTdkGeneratedPath(projectRoot, path.join(".tdk", ".tdk-out", filename));
+        const filePath = assertFliskGeneratedPath(projectRoot, path.join(".flisk", ".flisk-out", filename));
         writeTextFileAtomic(filePath, content);
         if (!options.quiet)
-            console.log(`✓ Generated: .tdk/.tdk-out/${filename}`);
+            console.log(`✓ Generated: .flisk/.flisk-out/${filename}`);
     }
     if (isStackFeatureEnabledInStacks(projectConfig.phases, DATABASE_MANAGEMENT_FEATURE)) {
-        const composePath = assertTdkGeneratedPath(projectRoot, path.join("services", "platform", DATABASE_MANAGEMENT_FEATURE, DOCKER_COMPOSE_FILE));
+        const composePath = assertFliskGeneratedPath(projectRoot, path.join("services", "platform", DATABASE_MANAGEMENT_FEATURE, DOCKER_COMPOSE_FILE));
         const composeDir = path.dirname(composePath);
         fs.mkdirSync(composeDir, { recursive: true });
         writeTextFileAtomic(composePath, generateDatabaseManagementCompose(projectConfig));
@@ -499,7 +500,7 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
     }
     // Copy .tiltignore to project root so Tilt uses it
     const tiltignoreSource = path.join(outputDir, TILTIGNORE_FILE);
-    const tiltignoreTarget = assertTdkGeneratedPath(projectRoot, TILTIGNORE_FILE);
+    const tiltignoreTarget = assertFliskGeneratedPath(projectRoot, TILTIGNORE_FILE);
     if (fs.existsSync(tiltignoreSource)) {
         if (!fs.existsSync(tiltignoreTarget)) {
             fs.copyFileSync(tiltignoreSource, tiltignoreTarget);
@@ -510,7 +511,7 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
             // Only a file Flisk wrote (it carries the header) may be restored; one without the
             // header is the team's own and `verifyMasterConfigs` reports it as a warning.
             const current = fs.readFileSync(tiltignoreTarget, "utf-8");
-            if (current.includes(TDK_GENERATED_MARKER) &&
+            if (current.includes(FLISK_GENERATED_MARKER) &&
                 current !== fs.readFileSync(tiltignoreSource, "utf-8")) {
                 fs.copyFileSync(tiltignoreSource, tiltignoreTarget);
                 if (!options.quiet) {
@@ -525,7 +526,7 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
             console.log(`✓ Copied: ${asset} → project root`);
         }
     }
-    await vendorTdkExtension(projectRoot, { quiet: options.quiet });
+    await vendorFliskExtension(projectRoot, { quiet: options.quiet });
     if (!options.quiet) {
         console.log("");
         console.log("💡 To start Tilt: flisk up");
@@ -533,11 +534,11 @@ export async function generateMasterConfigs(projectRoot, options = {}) {
 }
 // The generated Tiltfile loads the Flisk Tilt extension (engine, discovery,
 // specs, ext starlark modules). The extension repo may stay private, so we
-// vendor a working copy into .tdk/.tdk-out/tdk-cli-ext/ at generation time.
+// vendor a working copy into .flisk/.flisk-out/flisk-cli-ext/ at generation time.
 // This makes `flisk up` work offline and on any machine - no hardcoded paths,
 // no dependency on a private GitHub repo.
 // The engine's own unit tests (for example wake-gateway/decide.test.ts, which imports bun:test) are
-// not needed to run a stack. Vendoring them under .tdk/.tdk-out makes a Node project's test runner
+// not needed to run a stack. Vendoring them under .flisk/.flisk-out makes a Node project's test runner
 // (Vitest, Jest) discover them and fail, so they are left out of the vendored copy.
 const TEST_FILE_PATTERN = /\.(?:test|spec)\.[cm]?[jt]sx?$/;
 export function isTestFile(filePath) {
@@ -556,7 +557,7 @@ function removeVendoredTestFiles(dir) {
         }
     }
 }
-const TDK_EXTENSION_DIRS = ["engine", "discovery", "specs", "ext"];
+const FLISK_EXTENSION_DIRS = EXTENSION_DIRS;
 const PROJECT_RUNTIME_ASSET_DIRS = [["shared-platform-engineering", "docker-templates"]];
 const REQUIRED_DOCKER_TEMPLATE_FILES = [
     "install-deps.sh",
@@ -571,7 +572,7 @@ const REQUIRED_DOCKER_TEMPLATE_FILES = [
 function findSelfContainedEngineRoot() {
     let dir = import.meta.dirname || process.cwd();
     for (let i = 0; i < 6; i++) {
-        if (fs.existsSync(path.join(dir, "Tiltfile")) && fs.existsSync(path.join(dir, "engine"))) {
+        if (hasExtensionLayout(dir)) {
             return dir;
         }
         const parent = path.dirname(dir);
@@ -594,7 +595,7 @@ export function findCliAssetRoot() {
     }
     const exeDir = path.dirname(process.execPath);
     const candidates = [
-        path.join(exeDir, "tdk-cli"),
+        path.join(exeDir, "flisk-cli"),
         path.join(process.cwd(), "node_modules", "@flisk-sh", "flisk"),
     ];
     return (candidates.find((candidate) => fs.existsSync(path.join(candidate, "shared-platform-engineering", "docker-templates"))) ?? null);
@@ -609,7 +610,7 @@ export function ensureProjectRuntimeAssets(projectRoot) {
     }
     for (const parts of PROJECT_RUNTIME_ASSET_DIRS) {
         const source = path.join(sourceRoot, ...parts);
-        const target = assertTdkGeneratedPath(projectRoot, path.join(...parts));
+        const target = assertFliskGeneratedPath(projectRoot, path.join(...parts));
         if (!fs.existsSync(source)) {
             continue;
         }
@@ -625,16 +626,16 @@ export function ensureProjectRuntimeAssets(projectRoot) {
     }
     return copied;
 }
-async function vendorTdkExtension(projectRoot, options = {}) {
-    const vendoredDir = assertTdkGeneratedPath(projectRoot, path.join(".tdk", ".tdk-out", "tdk-cli-ext"));
+async function vendorFliskExtension(projectRoot, options = {}) {
+    const vendoredDir = assertFliskGeneratedPath(projectRoot, path.join(".flisk", ".flisk-out", "flisk-cli-ext"));
     // Source resolution order:
-    //   1. $TDK_EXTENSION_SOURCE (explicit override)
+    //   1. $FLISK_EXTENSION_SOURCE (explicit override)
     //   2. Self-contained repo (engine/ ships next to cli/ - public flisk)
     //   3. Executable-adjacent checkout (bundled installs)
-    //   4. Relative ../tdk-cli sibling (monorepo maintainer layout)
+    //   4. Relative ../flisk-cli sibling (monorepo maintainer layout)
     const sources = [];
-    if (process.env.TDK_EXTENSION_SOURCE) {
-        sources.push(process.env.TDK_EXTENSION_SOURCE);
+    if (process.env.FLISK_EXTENSION_SOURCE) {
+        sources.push(process.env.FLISK_EXTENSION_SOURCE);
     }
     const selfContainedRoot = findSelfContainedEngineRoot();
     if (selfContainedRoot) {
@@ -648,37 +649,49 @@ async function vendorTdkExtension(projectRoot, options = {}) {
     // Bun's process object - it was always undefined, silently falling
     // back to cwd() instead of the binary's real location.
     const exeDir = path.dirname(process.execPath);
-    sources.push(path.join(exeDir, "tdk-cli"));
-    sources.push(path.join(projectRoot, "..", "tdk-cli"));
+    sources.push(path.join(exeDir, "flisk-cli"));
+    sources.push(path.join(projectRoot, "..", "flisk-cli"));
+    // An explicit override that fails the layout check is skipped below; say why instead of silently falling
+    // back to a different copy of the extension.
+    const override = process.env.FLISK_EXTENSION_SOURCE;
+    if (override && fs.existsSync(override) && !hasExtensionLayout(override)) {
+        console.warn(`⚠️  FLISK_EXTENSION_SOURCE is not a usable Flisk extension and is ignored:\n   ${describeLayoutProblems(override)}`);
+    }
     let sourceRoot = "";
     for (const candidate of sources) {
-        if (candidate &&
-            fs.existsSync(path.join(candidate, "Tiltfile")) &&
-            fs.existsSync(path.join(candidate, "engine"))) {
+        if (candidate && hasExtensionLayout(candidate)) {
             sourceRoot = candidate;
             break;
         }
     }
     if (!sourceRoot) {
-        console.warn("⚠️  Flisk extension not found - set TDK_EXTENSION_SOURCE to its checkout path " +
-            "and re-run `flisk project` (or `flisk config regenerate`) to vendor it before `flisk up`.");
+        // A candidate that has some extension entries but fails the layout check is a stale or half-migrated tree.
+        const broken = sources
+            .filter((candidate) => candidate && fs.existsSync(candidate))
+            .map((candidate) => ({ candidate, report: inspectExtensionLayout(candidate) }))
+            .filter(({ report }) => report.kind === "mixed" || report.missing.length < 5);
+        console.warn("⚠️  Flisk extension not found - set FLISK_EXTENSION_SOURCE to its checkout path " +
+            "and re-run `flisk project` (or `flisk config regenerate`) to vendor it before `flisk up`." +
+            broken
+                .map(({ candidate, report }) => `\n   ${describeLayoutProblems(candidate, report)}`)
+                .join(""));
         return;
     }
     if (!fs.existsSync(vendoredDir)) {
         fs.mkdirSync(vendoredDir, { recursive: true });
     }
-    fs.copyFileSync(path.join(sourceRoot, "Tiltfile"), path.join(vendoredDir, "Tiltfile"));
-    for (const dir of TDK_EXTENSION_DIRS) {
+    fs.copyFileSync(resolveTiltfile(sourceRoot), path.join(vendoredDir, "Tiltfile"));
+    for (const dir of FLISK_EXTENSION_DIRS) {
         // A project vendored by an older Flisk already holds test files; cpSync only adds, so drop them.
         removeVendoredTestFiles(path.join(vendoredDir, dir));
-        fs.cpSync(path.join(sourceRoot, dir), path.join(vendoredDir, dir), {
+        fs.cpSync(resolveExtensionDir(sourceRoot, dir), path.join(vendoredDir, dir), {
             recursive: true,
             filter: (source) => !isTestFile(source),
         });
     }
     if (!options.quiet)
-        console.log(`✓ Vendored Flisk extension → .tdk/.tdk-out/tdk-cli-ext/`);
-    // Best-effort: if TDK_LICENSE_KEY is set and grants any paid resource,
+        console.log(`✓ Vendored Flisk extension → .flisk/.flisk-out/flisk-cli-ext/`);
+    // Best-effort: if FLISK_LICENSE_KEY is set and grants any paid resource,
     // overlay the premium bundle over the stub files just vendored above.
     // No-ops silently (beyond a warning) if there's no key, the fetch
     // fails, or nothing's granted - the free engine already works fine on
@@ -691,7 +704,7 @@ async function vendorTdkExtension(projectRoot, options = {}) {
         console.warn(`⚠️  Premium overlay skipped: ${err.message}`);
     }
 }
-const TDK_GENERATED_MARKER = "SYSTEM-GENERATED BY Flisk CLI";
+const FLISK_GENERATED_MARKER = "SYSTEM-GENERATED BY Flisk CLI";
 export function verifyMasterConfigs(projectRoot, options) {
     const errors = [];
     const warnings = [];
@@ -709,11 +722,11 @@ export function verifyMasterConfigs(projectRoot, options) {
     const projectConfig = readProjectConfig(projectRoot);
     const engine = new TemplateEngine();
     const expectedFiles = engine.generateAll(projectConfig);
-    const outputDir = path.join(projectRoot, ".tdk", ".tdk-out");
+    const outputDir = path.join(projectRoot, ".flisk", ".flisk-out");
     for (const filename of ALL_GENERATED_FILES) {
         const expectedContent = expectedFiles[filename];
         const filePath = path.join(outputDir, filename);
-        addDrift(`.tdk/.tdk-out/${filename}`, fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : undefined, expectedContent);
+        addDrift(`.flisk/.flisk-out/${filename}`, fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : undefined, expectedContent);
     }
     // `flisk project` never overwrites a root .tiltignore the repo already has, so one
     // without Flisk's header belongs to the team: it is not drift.
@@ -721,7 +734,7 @@ export function verifyMasterConfigs(projectRoot, options) {
     const rootTiltIgnoreText = fs.existsSync(rootTiltIgnore)
         ? fs.readFileSync(rootTiltIgnore, "utf-8")
         : undefined;
-    if (rootTiltIgnoreText !== undefined && !rootTiltIgnoreText.includes(TDK_GENERATED_MARKER)) {
+    if (rootTiltIgnoreText !== undefined && !rootTiltIgnoreText.includes(FLISK_GENERATED_MARKER)) {
         warnings.push(".tiltignore: not generated by Flisk, left as is");
     }
     else {
@@ -763,7 +776,7 @@ function verifyGeneratedResourceFiles(projectRoot, serviceJsonPath) {
     const generatedFiles = [];
     const collect = (directory, relativeDir = "") => {
         for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-            if (relativeDir === "" && entry.name === ".tdk-contract")
+            if (relativeDir === "" && entry.name === ".flisk-contract")
                 continue;
             const relativeFile = path.join(relativeDir, entry.name);
             const fullPath = path.join(directory, entry.name);
@@ -776,7 +789,7 @@ function verifyGeneratedResourceFiles(projectRoot, serviceJsonPath) {
     collect(generatedDir);
     if (generatedFiles.length === 0)
         return { errors: [], handEdited: [] };
-    const contractDir = path.join(generatedDir, ".tdk-contract");
+    const contractDir = path.join(generatedDir, ".flisk-contract");
     const sourceSnapshot = path.join(contractDir, "service.json.source");
     const errors = [];
     const handEdited = [];

package/cli/dist/mcp/tools.js

@@ -19,7 +19,7 @@ export function cliInvocation(execPath = process.execPath, script = process.argv
     return [execPath, script];
 }
 /** Runs this same CLI (`flisk <args>`) so every tool behaves exactly like its command. */
-export const runTdkCli = (args, options = {}) => new Promise((resolve, reject) => {
+export const runFliskCli = (args, options = {}) => new Promise((resolve, reject) => {
     const [command, ...prefix] = cliInvocation();
     const child = spawn(command, [...prefix, ...args], {
         cwd: options.cwd,
@@ -219,7 +219,7 @@ function projectPath(value) {
     }
     return value;
 }
-export function createTdkTools(run = runTdkCli, up = defaultUpDeps) {
+export function createFliskTools(run = runFliskCli, up = defaultUpDeps) {
     const viaCli = (build) => async (args) => toToolResult(await run(build(args), { cwd: projectPath(args.projectPath) }));
     return [
         {

package/cli/dist/utils/agent-host.js

@@ -25,7 +25,7 @@ export function detectHost(inputs = defaultInputs()) {
     }
     // Mirrors nativeWindowsUpRefusal in commands/up.ts: native Windows is inspect-only unless explicitly overridden.
     if (platform === "win32") {
-        return { kind: "native-windows", canUp: env.TDK_ALLOW_NATIVE_WINDOWS === "1" };
+        return { kind: "native-windows", canUp: env.FLISK_ALLOW_NATIVE_WINDOWS === "1" };
     }
     if (platform === "linux" && env.WSL_DISTRO_NAME)
         return { kind: "wsl2", canUp: true };

package/cli/dist/utils/cli-command.js

@@ -87,7 +87,7 @@ export function readyNextStep(env = process.env, cwd = process.cwd()) {
     }
     const workspace = suggestedWorkspace(env);
     return (`Next: mkdir -p ${workspace} && cd ${workspace} && ${CLI_COMMAND} project --yes\n` +
-        `(${CLI_COMMAND} project writes .tdk/ and the master configs into the current folder, ` +
+        `(${CLI_COMMAND} project writes .flisk/ and the master configs into the current folder, ` +
         `so it starts clean in a folder of its own. Or clone a starter: ${CLI_COMMAND} project example)`);
 }
 /**

package/cli/dist/utils/cold-preflight.js

@@ -155,7 +155,7 @@ export async function runColdPreflight(opts = {}) {
             id: "ports",
             ok: false,
             message: error instanceof Error ? error.message : String(error),
-            fix: "Set TDK_HTTP_PORT, TDK_HTTPS_PORT, or TDK_POSTGRES_PORT to available host ports.",
+            fix: "Set FLISK_HTTP_PORT, FLISK_HTTPS_PORT, or FLISK_POSTGRES_PORT to available host ports.",
         });
     }
     // Project wiring (NATS, Prisma database) describes a running stack, so it is
@@ -167,7 +167,7 @@ export async function runColdPreflight(opts = {}) {
         if (usesPrisma(projectRoot)) {
             let dbUp = false;
             try {
-                const config = JSON.parse(readFileSync(join(projectRoot, ".tdk", PROJECT_JSON), "utf-8"));
+                const config = JSON.parse(readFileSync(join(projectRoot, ".flisk", PROJECT_JSON), "utf-8"));
                 const projectName = String(config?.project?.name ?? "").replace(/-/g, "_");
                 if (projectName) {
                     const running = execFileSync(findOnPath("docker") ?? "docker", [

package/cli/dist/utils/constants.js

@@ -24,7 +24,7 @@ export const AUTOGENERATED_DIR = ".autogenerated";
 export const TECH_STACK_FILE = "TILT_TECH_STACK.star";
 export const RESOURCE_DEFAULTS_FILE = "TILT_RESOURCE_DEFAULTS.star";
 // Flisk project manifest file name. The canonical project config lives at
-// `<project-root>/.tdk/project.json` — discovery, doctor, generator, config
+// `<project-root>/.flisk/project.json` — discovery, doctor, generator, config
 // edits, and stack-features all read/write it. Referenced by value across
 // these modules, so a typo in one copy would compile and silently stop
 // matching (or worse, read a different file). Keep the literal here and
@@ -90,11 +90,11 @@ export const STANDARD_PORTS = {
     traefik: 8080,
 };
 export const QUICKSTART_DOCS_URL = "https://flisk.sh/docs/quickstart/";
-export const BASE_DOMAIN_DEFAULT = "tdk-project.localhost";
+export const BASE_DOMAIN_DEFAULT = "flisk-project.localhost";
 export const APP_SUBDOMAIN_PREFIX = "app";
 export const API_SUBDOMAIN_PREFIX = "api";
 export function getBaseDomain() {
-    const override = process.env.TDK_SERVICE_BASE_URL ?? process.env.TDK_PUBLIC_HOST;
+    const override = process.env.FLISK_SERVICE_BASE_URL ?? process.env.FLISK_PUBLIC_HOST;
     if (override) {
         try {
             const u = new URL(override.includes("://") ? override : `http://${override}`);

package/cli/dist/utils/discovery-paths.js

@@ -47,9 +47,9 @@ function globMatchesDir(patternSegments, dirSegments) {
     return (patternSegments.length === dirSegments.length &&
         patternSegments.every((segment, index) => segmentMatches(segment, dirSegments[index])));
 }
-/** `discovery.paths` from .tdk/project.json, or the generic default when unset/unreadable. */
+/** `discovery.paths` from .flisk/project.json, or the generic default when unset/unreadable. */
 export function readDiscoveryPaths(projectRoot) {
-    const configPath = join(projectRoot, ".tdk", PROJECT_JSON);
+    const configPath = join(projectRoot, ".flisk", PROJECT_JSON);
     if (!existsSync(configPath))
         return DEFAULT_DISCOVERY_PATHS;
     try {

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

@@ -7,13 +7,13 @@ import { join } from "node:path";
 import { promisify } from "node:util";
 import { checkColima, nativeLimaPath, planColimaRepair } from "./colima.js";
 import { DISK_WARN_GIB } from "./doctor-host.js";
-import { findProjectTiltUpPids, projectNetworkNames, tdkNetworkOwner, tdkNetworkPrefixes, } from "./down-cleanup.js";
+import { findProjectTiltUpPids, fliskNetworkOwner, fliskNetworkPrefixes, projectNetworkNames, } from "./down-cleanup.js";
 import { tiltGetUiResources } from "./up-readiness.js";
 import { findAllOnPath } from "./which.js";
 const execFilePromise = promisify(execFile);
 const DOCKER_TIMEOUT_MS = 15_000;
 /** The networks `flisk doctor` creates to test capacity; an interrupted run leaves one behind. */
-const PROBE_NETWORK = /^tdk_doctor_probe_(\d+)$/;
+const PROBE_NETWORK = /^flisk_doctor_probe_(\d+)$/;
 const runDocker = async (args) => {
     const { stdout } = await execFilePromise("docker", args, {
         encoding: "utf-8",
@@ -305,7 +305,7 @@ export async function planDoctorFixes(projectName, deps = dockerFixDeps, context
         }
     }
     const own = new Set(projectName ? projectNetworkNames(projectName) : []);
-    const prefixes = tdkNetworkPrefixes(networks.map((network) => network.name));
+    const prefixes = fliskNetworkPrefixes(networks.map((network) => network.name));
     for (const network of networks) {
         const probe = PROBE_NETWORK.exec(network.name);
         let scope;
@@ -319,10 +319,10 @@ export async function planDoctorFixes(projectName, deps = dockerFixDeps, context
             scope = "project";
             check = "Docker networks";
         }
-        else if (context.machine && tdkNetworkOwner(network.name, prefixes)) {
+        else if (context.machine && fliskNetworkOwner(network.name, prefixes)) {
             scope = "machine";
             check = "Docker networks";
-            reason = `unused network of project "${tdkNetworkOwner(network.name, prefixes)}"`;
+            reason = `unused network of project "${fliskNetworkOwner(network.name, prefixes)}"`;
         }
         else {
             continue;
@@ -424,7 +424,7 @@ export async function applyDoctorFixes(actions, options, deps = dockerFixDeps) {
 export function hasFailedActions(actions) {
     return actions.some((action) => action.status === "failed");
 }
-async function readTdkVersion(path) {
+async function readFliskVersion(path) {
     try {
         const { stdout } = await execFilePromise(path, ["--version"], {
             encoding: "utf-8",
@@ -438,7 +438,7 @@ async function readTdkVersion(path) {
     }
 }
 /** Every distinct `flisk` on PATH (symlinks to one binary count once), in PATH order. */
-export async function findTdkInstalls(paths = findAllOnPath("flisk"), readVersion = readTdkVersion) {
+export async function findFliskInstalls(paths = findAllOnPath("flisk"), readVersion = readFliskVersion) {
     const seen = new Set();
     const installs = [];
     for (const path of paths) {
@@ -457,8 +457,8 @@ export async function findTdkInstalls(paths = findAllOnPath("flisk"), readVersio
     return installs;
 }
 /** Two `flisk` binaries can disagree (a dashboard or MCP client may launch the older one), so say which is which. */
-export async function checkDuplicateTdkInstalls(installs) {
-    const found = installs ?? (await findTdkInstalls());
+export async function checkDuplicateFliskInstalls(installs) {
+    const found = installs ?? (await findFliskInstalls());
     if (found.length <= 1) {
         return { name: "Flisk installs", didPass: true, message: "One flisk install on PATH" };
     }
@@ -486,7 +486,7 @@ export function projectTiltPids(projectRoot, find = findProjectTiltUpPids) {
     }
     const pids = new Set();
     for (const root of roots) {
-        for (const pid of find(join(root, ".tdk", ".tdk-out", "Tiltfile")))
+        for (const pid of find(join(root, ".flisk", ".flisk-out", "Tiltfile")))
             pids.add(pid);
     }
     return [...pids];

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

@@ -50,19 +50,19 @@ export function createDoctorReport(checks, inProject, errors = [], portPlan, hos
                         http: {
                             requested: portPlan?.requested.ingressHttp ?? 80,
                             chosen: portPlan?.ingressHttp ?? null,
-                            explicit: portPlan?.explicit.ingressHttp ?? Boolean(process.env.TDK_HTTP_PORT),
+                            explicit: portPlan?.explicit.ingressHttp ?? Boolean(process.env.FLISK_HTTP_PORT),
                             reason: portPlan?.reason.ingressHttp ?? "port planning failed",
                         },
                         https: {
                             requested: portPlan?.requested.ingressHttps ?? 443,
                             chosen: portPlan?.ingressHttps ?? null,
-                            explicit: portPlan?.explicit.ingressHttps ?? Boolean(process.env.TDK_HTTPS_PORT),
+                            explicit: portPlan?.explicit.ingressHttps ?? Boolean(process.env.FLISK_HTTPS_PORT),
                             reason: portPlan?.reason.ingressHttps ?? "port planning failed",
                         },
                         postgres: {
                             requested: portPlan?.requested.postgres ?? 5432,
                             chosen: portPlan?.postgres ?? null,
-                            explicit: portPlan?.explicit.postgres ?? Boolean(process.env.TDK_POSTGRES_PORT),
+                            explicit: portPlan?.explicit.postgres ?? Boolean(process.env.FLISK_POSTGRES_PORT),
                             reason: portPlan?.reason.postgres ?? "port planning failed",
                         },
                     },

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

@@ -27,7 +27,8 @@ export function shellQuote(value) {
     return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function runHostCommand(exec, command, args, shellCommand, options) {
-    if (process.platform === "win32") {
+    // A supplied custom executor wins on every platform, including Windows.
+    if (process.platform === "win32" && exec === execSync) {
         return execFileSync(findOnPath(command) ?? command, args, {
             ...options,
             windowsHide: true,
@@ -74,7 +75,7 @@ export function parsePublishedPortHolders(dockerPsOutput, ports) {
 export function isOwnIngressContainer(containerName, projectPrefix) {
     const name = containerName.toLowerCase();
     const prefix = projectPrefix.toLowerCase();
-    // tdk_project_traefik, tdk_project-traefik-1, etc.
+    // flisk_project_traefik, flisk_project-traefik-1, etc.
     return name === `${prefix}_traefik` || name.startsWith(`${prefix}_traefik`);
 }
 export function findForeignIngressHolders(holders, projectPrefix) {
@@ -205,7 +206,7 @@ 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 projectConfigEnablesVerdaccio(projectRoot = findProjectRoot() ?? process.cwd()) {
-    const projectJsonPath = join(projectRoot, ".tdk", PROJECT_JSON);
+    const projectJsonPath = join(projectRoot, ".flisk", PROJECT_JSON);
     if (!existsSync(projectJsonPath))
         return false;
     try {

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

@@ -22,8 +22,8 @@ export function findPrivateStarlarkLoadExports(content) {
     return Array.from(privateExports).sort();
 }
 export function resolveStarlarkLoadTarget(file, modulePath, projectRoot) {
-    if (modulePath === "ext://tdk-cli") {
-        return join(projectRoot, ".tdk", ".tdk-out", "tdk-cli-ext", "Tiltfile");
+    if (modulePath === "ext://flisk-cli") {
+        return join(projectRoot, ".flisk", ".flisk-out", "flisk-cli-ext", "Tiltfile");
     }
     if (modulePath.startsWith(".") || (!modulePath.includes("://") && !modulePath.startsWith("@"))) {
         return normalize(join(dirname(file), modulePath));
@@ -86,7 +86,7 @@ export function collectReachableStarlarkFiles(entryFile, projectRoot) {
 }
 export function checkStarlarkLoadExports() {
     const projectRoot = findProjectRoot() ?? process.cwd();
-    const entryFile = join(projectRoot, ".tdk", ".tdk-out", "Tiltfile");
+    const entryFile = join(projectRoot, ".flisk", ".flisk-out", "Tiltfile");
     if (!existsSync(entryFile)) {
         return {
             name: "Starlark Load Exports",

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

@@ -24,7 +24,7 @@ const PRISMA_MAJOR = 7;
 const SKIPPED_DIRS = new Set(["node_modules", AUTOGENERATED_DIR, "dist", "tests", "__tests__"]);
 function projectName(projectRoot) {
     try {
-        const parsed = JSON.parse(readFileSync(join(projectRoot, ".tdk", PROJECT_JSON), "utf-8"));
+        const parsed = JSON.parse(readFileSync(join(projectRoot, ".flisk", PROJECT_JSON), "utf-8"));
         return typeof parsed?.project?.name === "string" ? parsed.project.name : undefined;
     }
     catch {
@@ -619,7 +619,7 @@ export function parseTiltProcesses(psOutput) {
         const match = line.match(/^\s*(\d+)\s+.*\btilt up\b.*?\s-f\s+(\S+)/i);
         if (!match)
             continue;
-        processes.push({ pid: Number(match[1]), root: match[2].split(/[\\/]\.tdk[\\/]/i)[0] });
+        processes.push({ pid: Number(match[1]), root: match[2].split(/[\\/]\.flisk[\\/]/i)[0] });
     }
     return processes;
 }
@@ -667,7 +667,7 @@ export function checkTiltInstances(projectRoot = findProjectRoot() ?? process.cw
     return { name: "Tilt processes", didPass: true, message: "No stray Tilt processes" };
 }
 export async function checkDockerNetworkCapacity(exec = execAsync) {
-    const probe = `tdk_doctor_probe_${process.pid}`;
+    const probe = `flisk_doctor_probe_${process.pid}`;
     try {
         await exec(`docker network create ${probe}`, EXEC_TIMEOUT_MS);
     }
@@ -692,7 +692,7 @@ export async function checkDockerNetworkCapacity(exec = execAsync) {
         await exec(`docker network rm ${probe}`, EXEC_TIMEOUT_MS);
     }
     catch {
-        // A leftover probe network is harmless and tdk_doctor_probe_* is easy to prune.
+        // A leftover probe network is harmless and flisk_doctor_probe_* is easy to prune.
     }
     return { name: "Docker networks", didPass: true, message: "Docker can create networks" };
 }