@tdk-landscape/tdk-cli-core 1.3.14

package/templates/.tiltignore.hbs

@@ -0,0 +1,73 @@
+# =============================================================================
+# 🚫 TDK CLI - TILT IGNORE FILE
+# =============================================================================
+# SYSTEM-GENERATED BY TDK CLI - DO NOT EDIT
+# Source: .tdk/project.json
+# Generated: {{timestamp}}
+# Run 'tdk project' to regenerate
+# =============================================================================
+#
+# This file tells Tilt which directories to ignore during file watching.
+# Prevents fsnotify buffer overflow and reduces unnecessary rebuilds.
+#
+# =============================================================================
+
+# Dependency directories
+**/node_modules
+
+# Build outputs
+**/dist
+**/build
+**/out
+**/.output
+
+# Version control
+**/.git
+
+# Generated files
+**/.prisma
+**/.turbo
+**/coverage
+**/tmp
+**/temp
+
+# IDE files
+**/.idea
+**/.vscode
+**/*.swp
+**/*.swo
+
+# OS files
+**/.DS_Store
+**/Thumbs.db
+
+# Docker volumes and data
+**/postgres-data
+**/redis-data
+**/verdaccio-storage
+**/verdaccio-conf
+**/verdaccio-plugins
+
+# TDK generated outputs (avoid watching generated files)
+**/.tdk/.tdk-out
+**/.autogenerated/**
+**/.autogenerated/*.autogenerated
+**/.autogenerated/*.autogenerated.json
+**/.autogenerated/*.autogenerated.yml
+**/.autogenerated/*.autogenerated.toml
+
+# Logs
+**/*.log
+**/logs
+
+# Test outputs
+**/test-results
+**/playwright-report
+**/.nyc_output
+
+# Cache directories
+**/.cache
+**/.npm
+**/.bun
+**/bun.lockb
+docker

package/templates/TILT_RESOURCE_DEFAULTS.star.hbs

@@ -0,0 +1,221 @@
+#!/usr/bin/env starlark
+# -*- coding: utf-8 -*-
+# =============================================================================
+# 🔧 TILT SERVICE DEFAULTS MASTER CONFIG
+# =============================================================================
+# SYSTEM-GENERATED BY TDK CLI - DO NOT EDIT
+# Source: TDK Platform Standards v{{version}}
+# Output: .tdk/.tdk-out/
+# Generated: {{timestamp}}
+# Run 'tdk project' to update
+# =============================================================================
+
+# Port Configuration
+BASE_PORT_FRONTEND = {{ports.frontend.base}}
+BASE_PORT_BACKEND = {{ports.backend.base}}
+BASE_PORT_HEALTH = {{ports.health.base}}
+
+# Port ranges
+PORT_RANGE_FRONTEND_START = {{ports.frontend.start}}
+PORT_RANGE_FRONTEND_END = {{ports.frontend.end}}
+PORT_RANGE_BACKEND_START = {{ports.backend.start}}
+PORT_RANGE_BACKEND_END = {{ports.backend.end}}
+PORT_RANGE_HEALTH_START = {{ports.health.start}}
+PORT_RANGE_HEALTH_END = {{ports.health.end}}
+
+# Service Naming Patterns (required by TDK engine)
+NAMING_PATTERNS = {
+"backend_suffix": "{{naming.backend}}",
+"frontend_suffix": "{{naming.frontend}}",
+"migrator_suffix": "{{naming.migrator}}",
+"library_suffix": "{{naming.library}}",
+"sdk_suffix": "{{naming.sdk}}",
+"worker_suffix": "{{naming.worker}}",
+"valid_separators": {{starlarkArray naming.validSeparators}},
+"max_length": {{naming.maxLength}},
+"min_length": {{naming.minLength}},
+}
+
+# Traefik Configuration (required by TDK engine)
+TRAEFIK_CONFIG = {
+"entrypoint": "{{traefik.entrypoint}}",
+"network": "{{traefik.network}}",
+"default_host": "{{traefik.defaultHost}}",
+"default_port": {{traefik.defaultPort}},
+"tls_enabled": {{starlark traefik.tlsEnabled}},
+"entrypoints": {{starlarkArray traefik.entrypoints}},
+"middlewares": {{starlarkArray traefik.middlewares}},
+"tls": {"enabled": {{starlark traefik.tlsEnabled}} },
+"healthcheck_path": "{{traefik.healthcheckPath}}",
+"healthcheck_interval": "{{traefik.healthcheckInterval}}",
+"healthcheck_timeout": "{{traefik.healthcheckTimeout}}",
+"frontend_priority_base": {{traefik.frontendPriorityBase}},
+}
+
+# Health Check Configuration
+HEALTH_CHECK_PATH = "{{health.path}}"
+HEALTH_CHECK_LIVE = "{{health.live}}"
+HEALTH_CHECK_READY = "{{health.ready}}"
+HEALTH_CHECK_TIMEOUT = {{health.timeout}}
+
+# File watch ignore patterns (to prevent fsnotify buffer overflow)
+def get_filewatch_ignore_patterns(resource_path="."):
+    """
+    Returns list of file patterns to ignore for Tilt filewatch.
+
+    Args:
+    resource_path: Base path of the service
+
+    Returns:
+    List of patterns to ignore
+    """
+    ignores = [
+    {{#each filewatchIgnores}}
+        resource_path + "/{{this}}",
+    {{/each}}
+    ]
+    return ignores
+
+def get_port_config():
+    """Returns the complete port allocation strategy."""
+    return {
+        "frontend": {
+            "base": BASE_PORT_FRONTEND,
+            "range_start": PORT_RANGE_FRONTEND_START,
+            "range_end": PORT_RANGE_FRONTEND_END,
+        },
+        "backend": {
+            "base": BASE_PORT_BACKEND,
+            "range_start": PORT_RANGE_BACKEND_START,
+            "range_end": PORT_RANGE_BACKEND_END,
+        },
+        "health": {
+            "base": BASE_PORT_HEALTH,
+            "range_start": PORT_RANGE_HEALTH_START,
+            "range_end": PORT_RANGE_HEALTH_END,
+        },
+    }
+
+def get_resource_port(resource_type, stack_index=0, resource_index=0):
+    """
+    Calculate service port based on type and indices.
+
+    Args:
+    resource_type: "frontend" or "backend"
+    stack_index: Index of the stack (for port allocation)
+    resource_index: Index of the service within stack
+
+    Returns:
+    Port number
+    """
+    if resource_type == "frontend":
+        base = BASE_PORT_FRONTEND
+    elif resource_type == "backend":
+        base = BASE_PORT_BACKEND
+    else:
+        fail("Unknown service type: {}".format(resource_type))
+
+    # Allocate ports: base + (stack_index * 100) + resource_index
+    return base + (stack_index * 100) + resource_index
+
+def get_health_check_config():
+    """Returns health check endpoint configuration."""
+    return {
+        "path": HEALTH_CHECK_PATH,
+        "live": HEALTH_CHECK_LIVE,
+        "ready": HEALTH_CHECK_READY,
+        "timeout": HEALTH_CHECK_TIMEOUT,
+    }
+
+def get_build_config():
+    """Returns Docker build configuration."""
+    return {
+        "dockerfile": "{{docker.dockerfile}}",
+        "context": "{{docker.context}}",
+        {{#if docker.platform}}"platform": "{{docker.platform}}",{{/if}}
+        "cache_from": [],
+    }
+
+def get_runtime_config():
+    """Returns runtime command configuration."""
+    return {
+        "backend": {
+            "command": "{{runtime.backend.command}}",
+            "args": {{starlarkArray runtime.backend.args}},
+            "env": {{starlark runtime.backend.env}},
+        },
+        "frontend": {
+            "command": "{{runtime.frontend.command}}",
+            "args": {{starlarkArray runtime.frontend.args}},
+            "env": {{starlark runtime.frontend.env}},
+        },
+    }
+
+def get_resource_defaults():
+    """Returns complete service defaults."""
+    return {
+        "port": get_port_config(),
+        "health": get_health_check_config(),
+        "build": get_build_config(),
+        "runtime": get_runtime_config(),
+    }
+
+def validate_resource_defaults(config):
+    """
+    Validates service configuration against defaults.
+
+    Args:
+    config: Service configuration dict
+
+    Returns:
+    Dict with validation results
+    """
+    warnings = []
+    errors = []
+
+    # Validate port allocation
+    if "port" in config:
+        port = config["port"]
+        if port < 1024:
+            errors.append("Port {} is in reserved range (< 1024)".format(port))
+        elif port > 65535:
+            errors.append("Port {} exceeds maximum (65535)".format(port))
+
+    # Validate health check path
+    if "healthCheckPath" in config:
+        path = config["healthCheckPath"]
+        if not path.startswith("/"):
+            errors.append("Health check path must start with /: {}".format(path))
+
+    return {
+        "valid": len(errors) == 0,
+        "errors": errors,
+        "warnings": warnings,
+    }
+
+# Export public API
+__all__ = [
+    "get_port_config",
+    "get_resource_port",
+    "get_health_check_config",
+    "get_filewatch_ignore_patterns",
+    "get_build_config",
+    "get_runtime_config",
+    "get_resource_defaults",
+    "validate_resource_defaults",
+    "BASE_PORT_FRONTEND",
+    "BASE_PORT_BACKEND",
+    "BASE_PORT_HEALTH",
+    "PORT_RANGE_FRONTEND_START",
+    "PORT_RANGE_FRONTEND_END",
+    "PORT_RANGE_BACKEND_START",
+    "PORT_RANGE_BACKEND_END",
+    "PORT_RANGE_HEALTH_START",
+    "PORT_RANGE_HEALTH_END",
+    "HEALTH_CHECK_PATH",
+    "HEALTH_CHECK_LIVE",
+    "HEALTH_CHECK_READY",
+    "HEALTH_CHECK_TIMEOUT",
+    "NAMING_PATTERNS",
+    "TRAEFIK_CONFIG",
+]

package/templates/TILT_TECH_STACK.star.hbs

@@ -0,0 +1,150 @@
+#!/usr/bin/env starlark
+# -*- coding: utf-8 -*-
+# =============================================================================
+# 🏗️ TILT TECH STACK MASTER CONFIG
+# =============================================================================
+# SYSTEM-GENERATED BY TDK CLI - DO NOT EDIT
+# Source: TDK Platform Standards v{{version}}
+# Output: .tdk/.tdk-out/
+# Generated: {{timestamp}}
+# Run 'tdk project' to update
+# =============================================================================
+
+def get_tech_stack():
+    """Returns the complete tech stack definition."""
+    return {
+        "bundler": "{{tech.bundler}}",
+        "runtime": "{{tech.runtime}}",
+        "language": "{{tech.language}}",
+        "orm": "{{tech.orm}}",
+        "messaging": "{{tech.messaging}}",
+        "linting": "{{tech.linting}}",
+        "testing": "{{tech.testing}}",
+        "web_framework": "{{tech.framework}}",
+    }
+
+# Constants for direct import
+BUNDLER = "{{tech.bundler}}"
+RUNTIME = "{{tech.runtime}}"
+ORM = "{{tech.orm}}"
+MESSAGING = "{{tech.messaging}}"
+LINTING = "{{tech.linting}}"
+TESTING = "{{tech.testing}}"
+WEB_FRAMEWORK = "{{tech.framework}}"
+LANGUAGE = "{{tech.language}}"
+
+TECH_STACK = get_tech_stack()
+
+def validate_tech_stack(config, strict=False):
+    """
+    Validates a configuration against the platform tech stack.
+    
+    Args:
+        config: Dict with tech stack choices to validate
+        strict: If True, fails on any non-compliance. If False, warns.
+    
+    Returns:
+        Dict with validation results: {"valid": bool, "errors": [], "warnings": []}
+    """
+    errors = []
+    warnings = []
+    
+    # Check for override reason
+    has_override = "_override_reason" in config and config["_override_reason"]
+    
+    # Strict validations (must match platform standard)
+    strict_validations = {
+        "bundler": "{{tech.bundler}}",
+        "runtime": "{{tech.runtime}}",
+        "orm": "{{tech.orm}}",
+        "messaging": "{{tech.messaging}}",
+    }
+    
+    for key, standard in strict_validations.items():
+        if key in config:
+            value = config[key]
+            if value.lower() != standard.lower():
+                if has_override:
+                    warnings.append("Override active: {}='{}' (Reason: {})".format(
+                        key, value, config["_override_reason"]
+                    ))
+                elif strict:
+                    errors.append(
+                        "❌ Tech Stack Error: {}: '{}' is not supported. " +
+                        "Platform standard is '{}'. Use _override_reason to document exceptions.".format(
+                            key, value, standard
+                        )
+                    )
+                else:
+                    warnings.append(
+                        "⚠️ Tech Stack Warning: {}: '{}' is not standard. " +
+                        "Platform standard is '{}'.".format(key, value, standard)
+                    )
+    
+    # Optional validations (warnings if missing or different)
+    optional_validations = {
+        "linting": "{{tech.linting}}",
+        "testing": "{{tech.testing}}",
+    }
+    
+    for key, standard in optional_validations.items():
+        if key in config:
+            value = config[key]
+            if value.lower() != standard.lower():
+                if has_override:
+                    warnings.append("Override active: {}='{}' (Reason: {})".format(
+                        key, value, config["_override_reason"]
+                    ))
+                else:
+                    warnings.append(
+                        "⚠️ Tech Stack Warning: {}: '{}' differs from standard '{}'.".format(
+                            key, value, standard
+                        )
+                    )
+    
+    return {
+        "valid": len(errors) == 0,
+        "errors": errors,
+        "warnings": warnings,
+    }
+
+def assert_tech_stack(config, strict=False):
+    """
+    Validates tech stack and fails fast on errors.
+    
+    Args:
+        config: Dict with tech stack choices to validate
+        strict: If True, fails on any non-compliance
+    
+    Raises:
+        Exception: If validation fails with errors
+    """
+    result = validate_tech_stack(config, strict)
+    
+    # Print warnings
+    for warning in result["warnings"]:
+        print(warning)
+    
+    # Fail on errors
+    if not result["valid"]:
+        for error in result["errors"]:
+            print(error)
+        fail("Tech stack validation failed. See errors above.")
+    
+    return result
+
+# Export public API
+__all__ = [
+    "get_tech_stack",
+    "validate_tech_stack",
+    "assert_tech_stack",
+    "BUNDLER",
+    "RUNTIME",
+    "ORM",
+    "MESSAGING",
+    "LINTING",
+    "TESTING",
+    "WEB_FRAMEWORK",
+    "LANGUAGE",
+    "TECH_STACK",
+]