@tdk-landscape/tdk-cli-core 1.3.15 → 1.3.22

package/specs/specs/TILT_SERVICE_DEFAULTS.star

@@ -0,0 +1,205 @@
+#!/usr/bin/env starlark
+# -*- coding: utf-8 -*-
+# =============================================================================
+# 🔧 TILT SERVICE DEFAULTS MASTER CONFIG
+# =============================================================================
+# 
+# Defines standard configurations for all services in the TDK Landscape platform.
+# This provides consistent port allocation, health checks, and build settings.
+#
+# See: docs/TILT_MASTER_CONFIGS.md
+# =============================================================================
+
+# Port Configuration
+BASE_PORT_FRONTEND = 3000
+BASE_PORT_BACKEND = 4000
+BASE_PORT_HEALTH = 5000
+
+# Port ranges
+PORT_RANGE_FRONTEND_START = 3000
+PORT_RANGE_FRONTEND_END = 3999
+PORT_RANGE_BACKEND_START = 4000
+PORT_RANGE_BACKEND_END = 4999
+PORT_RANGE_HEALTH_START = 5000
+PORT_RANGE_HEALTH_END = 5999
+
+# Health Check Configuration
+HEALTH_CHECK_PATH = "/health"
+HEALTH_CHECK_LIVE = "/health/live"
+HEALTH_CHECK_READY = "/health/ready"
+HEALTH_CHECK_TIMEOUT = 30
+
+# 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
+    """
+    # Common directories that cause fsnotify buffer overflow
+    ignores = [
+        resource_path + "/node_modules",
+        resource_path + "/dist",
+        resource_path + "/build",
+        resource_path + "/.git",
+        resource_path + "/.prisma",
+        resource_path + "/.turbo",
+        resource_path + "/coverage",
+        resource_path + "/tmp",
+        resource_path + "/temp",
+        resource_path + "/__tests__",
+        resource_path + "/test",
+        resource_path + "/tests",
+    ]
+    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, domain_index=0, resource_index=0):
+    """
+    Calculate service port based on type and indices.
+    
+    Args:
+        resource_type: "frontend" or "backend"
+        domain_index: Index of the domain (for port allocation)
+        resource_index: Index of the service within domain
+    
+    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 + (domain_index * 100) + resource_index
+    return base + (domain_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": "Dockerfile",
+        "context": ".",
+        # Auto-detect native arch (arm64 on Apple Silicon, amd64 elsewhere)
+        # "platform": "linux/amd64",
+        "cache_from": [],
+    }
+
+def get_runtime_config():
+    """Returns runtime command configuration."""
+    return {
+        "backend": {
+            "command": "bun",
+            "args": ["run", "dev"],
+            "env": {
+                "NODE_ENV": "development",
+            },
+        },
+        "frontend": {
+            "command": "bun",
+            "args": ["run", "dev"],
+            "env": {
+                "NODE_ENV": "development",
+            },
+        },
+    }
+
+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",
+]

package/specs/specs/TILT_TECH_STACK.star

@@ -0,0 +1,159 @@
+#!/usr/bin/env starlark
+# -*- coding: utf-8 -*-
+# =============================================================================
+# 🏗️ TILT TECH STACK MASTER CONFIG
+# =============================================================================
+# 
+# Defines the approved technology choices for the TDK Landscape platform.
+# This is the single source of truth for tech stack validation.
+#
+# See: docs/TILT_MASTER_CONFIGS.md
+# =============================================================================
+
+def get_tech_stack():
+    """Returns the complete tech stack definition."""
+    return {
+        # Core runtime and build tools
+        "bundler": "vite",
+        "runtime": "bun",
+        "language": "typescript",
+        
+        # Database and ORM
+        "orm": "prisma",
+        
+        # Messaging and events
+        "messaging": "nats",
+        
+        # Development tools
+        "linting": "biome",
+        "testing": "vitest",
+        
+        # Web framework
+        "web_framework": "hono",
+    }
+
+# Constants for direct import
+BUNDLER = "vite"
+RUNTIME = "bun"
+ORM = "prisma"
+MESSAGING = "nats"
+LINTING = "biome"
+TESTING = "vitest"
+WEB_FRAMEWORK = "hono"
+LANGUAGE = "typescript"
+
+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": "vite",
+        "runtime": "bun",
+        "orm": "prisma",
+        "messaging": "nats",
+    }
+    
+    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": "biome",
+        "testing": "vitest",
+    }
+    
+    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",
+]