@flisk-sh/flisk 0.0.0-stage → 1.3.190

package/shared-platform-engineering/docker-templates/prisma-normalize-client.sh

@@ -0,0 +1,58 @@
+#!/bin/sh
+# Copyright (c) 2026 Flisk contributors
+# SPDX-License-Identifier: MIT
+set -e
+
+PRISMA_EXPORT_GENERATED_CLIENT="${PRISMA_EXPORT_GENERATED_CLIENT:-1}"
+PRISMA_DOT_DIR="node_modules/.prisma"
+PRISMA_DOT_CLIENT="node_modules/.prisma/client"
+
+# Normalize Prisma output for both import styles: ../generated-client and node_modules/.prisma/client
+if [ ! -d "$PRISMA_DOT_CLIENT" ] && [ -d /app/node_modules/.prisma/client ]; then
+  mkdir -p "$PRISMA_DOT_DIR"
+  cp -R /app/node_modules/.prisma/client "$PRISMA_DOT_CLIENT"
+fi
+
+if [ "$PRISMA_EXPORT_GENERATED_CLIENT" = "1" ] && [ -d "$PRISMA_DOT_CLIENT" ] && [ ! -d generated-client ] && [ ! -f generated-client.ts ]; then
+  printf "export * from './node_modules/.prisma/client/client';\n" > generated-client.ts
+fi
+
+mkdir -p "$PRISMA_DOT_CLIENT"
+if [ -d generated-client ] && [ -z "$(ls -A "$PRISMA_DOT_CLIENT" 2>/dev/null)" ]; then
+  cp -r generated-client/. "$PRISMA_DOT_CLIENT/"
+fi
+
+# Prisma v7 prisma-client may emit TS-only artifacts; add declaration/js entrypoints
+if [ -f "$PRISMA_DOT_CLIENT/client.ts" ] && [ ! -f "$PRISMA_DOT_CLIENT/index.d.ts" ]; then
+  printf "export * from './client';\n" > "$PRISMA_DOT_CLIENT/index.d.ts"
+fi
+if [ -f "$PRISMA_DOT_CLIENT/client.ts" ] && [ ! -f "$PRISMA_DOT_CLIENT/default.d.ts" ]; then
+  printf "export * from './client';\n" > "$PRISMA_DOT_CLIENT/default.d.ts"
+fi
+if [ -f "$PRISMA_DOT_CLIENT/client.ts" ] && [ ! -f "$PRISMA_DOT_CLIENT/index.js" ]; then
+  printf "export * from './client.js';\n" > "$PRISMA_DOT_CLIENT/index.js"
+fi
+
+# Prisma v7 may generate malformed package.json under Bun
+if [ -f "$PRISMA_DOT_CLIENT/client.ts" ]; then
+  echo '{"name":"prisma-client-generated","types":"index.d.ts","main":"index.js"}' > "$PRISMA_DOT_CLIENT/package.json"
+fi
+
+# Prisma v7: @prisma/client/default.js requires .prisma/client/default
+if [ -d "$PRISMA_DOT_CLIENT" ] && [ ! -f "$PRISMA_DOT_CLIENT/default.js" ]; then
+  printf "module.exports = require('./client.js');\n" > "$PRISMA_DOT_CLIENT/default.js"
+fi
+
+# Ensure @prisma/client package can resolve '.prisma/client/*' under Bun hoisting
+if [ -d "$PRISMA_DOT_DIR" ]; then
+  for pkg in node_modules/@prisma/client node_modules/.bun/@prisma+client*/node_modules/@prisma/client; do
+    [ -d "$pkg" ] && ln -sfn "$(pwd)/$PRISMA_DOT_DIR" "$pkg/.prisma" || true
+  done
+fi
+
+# Also fix corrupted package.json in .bun cache
+for pkg in node_modules/.bun/@prisma+client*/node_modules/@prisma/client/package.json; do
+  [ -f "$pkg" ] && echo '{"name":"@prisma/client","main":"index.js","types":"index.d.ts"}' > "$pkg" || true
+done
+
+test -f "$PRISMA_DOT_CLIENT/client.ts" -o -f "$PRISMA_DOT_CLIENT/index.d.ts" || true

package/specs/specs/TILT_SERVICE_DEFAULTS.star

@@ -0,0 +1,207 @@
+#!/usr/bin/env starlark
+# -*- coding: utf-8 -*-
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# 🔧 TILT SERVICE DEFAULTS MASTER CONFIG
+# =============================================================================
+# 
+# Defines standard configurations for all services in the Flisk 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,161 @@
+#!/usr/bin/env starlark
+# -*- coding: utf-8 -*-
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# 🏗️ TILT TECH STACK MASTER CONFIG
+# =============================================================================
+# 
+# Defines the approved technology choices for the Flisk 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",
+]