@flisk-sh/flisk 0.0.0-stage → 1.3.189

package/engine/topologies/tilt/manifest/__init__.star

@@ -0,0 +1,220 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# 📋 MANIFEST MODULE - MAIN FACADE
+# =============================================================================
+# Path: .tilt/topologies/tilt/manifest/__init__.star
+# Purpose: Clean API surface for the manifest system
+# Status: Phase 4 Complete - All modules integrated
+# 
+# Usage:
+#   load("../manifest/__init__.star", "Manifest")
+#   result = Manifest.load_from_file("path/to/manifest.json")
+#   if result.error:
+#       print(result.error)
+#   else:
+#       manifest = result.manifest
+# =============================================================================
+
+# Import submodules
+load("./constants.star", "ManifestConstants")
+load("./errors.star", "ManifestErrors")
+load("./schema.star", "ManifestSchema")
+load("./loader.star", "ManifestLoader")
+load("./parser.star", "ManifestParser")
+load("./validator.star", "ManifestValidator")
+load("./integration.star", "ManifestIntegration")
+load("./mapper.star", "ManifestMapper")
+
+# =============================================================================
+# PUBLIC API - Manifest System
+# =============================================================================
+
+Manifest = struct(
+    # =========================================================================
+    # Constants and Configuration
+    # =========================================================================
+    
+    # Manifest filename
+    filename=ManifestConstants.MANIFEST_FILENAME,
+    
+    # Default values
+    defaults=ManifestConstants.MANIFEST_DEFAULTS,
+    
+    # Valid options
+    app_types=ManifestConstants.VALID_APP_TYPES,
+    stacks=ManifestConstants.VALID_STACKS,
+    features=ManifestConstants.VALID_FEATURES,
+    
+    # Port ranges
+    port_ranges=ManifestConstants.PORT_RANGES,
+    
+    # File paths
+    autogenerated_paths=ManifestConstants.AUTOGENERATED_CONFIG_PATHS,
+    
+    # =========================================================================
+    # Schema Access
+    # =========================================================================
+    
+    # Full schema definition
+    schema=ManifestSchema.MANIFEST_SCHEMA,
+    
+    # Schema utilities
+    get_field=ManifestSchema.get_field,
+    get_required_fields=ManifestSchema.get_required_fields,
+    get_default=ManifestSchema.get_default,
+    get_valid_values=ManifestSchema.get_valid_values,
+    is_required=ManifestSchema.is_required,
+    is_deprecated=ManifestSchema.is_deprecated,
+    get_all_fields=ManifestSchema.get_all_fields,
+    
+    # =========================================================================
+    # Error Handling
+    # =========================================================================
+    
+    # Error severity levels
+    severity=ManifestErrors.SEVERITY,
+    
+    # Error categories
+    category=ManifestErrors.CATEGORY,
+    
+    # Error messages
+    error_messages=ManifestErrors.ERROR_MESSAGES,
+    
+    # Error utilities
+    format_error=ManifestErrors.format,
+    group_errors=ManifestErrors.group,
+    has_critical_errors=ManifestErrors.has_critical,
+    get_error_summary=ManifestErrors.get_summary,
+    
+    # =========================================================================
+    # Data Loading
+    # =========================================================================
+    
+    # File loading functions
+    load_from_file=ManifestLoader.load_from_file,
+    load_from_path=ManifestLoader.load_from_path,
+    load_all=ManifestLoader.load_all,
+    
+    # Cache management
+    clear_cache=ManifestLoader.clear_cache,
+    get_cache_stats=ManifestLoader.get_cache_stats,
+    is_cached=ManifestLoader.is_cached,
+    
+    # Path utilities
+    get_manifest_path=ManifestLoader.get_manifest_path,
+    
+    # =========================================================================
+    # Parsing and Normalization
+    # =========================================================================
+    
+    # Parsing functions
+    parse=ManifestParser.parse,
+    normalize=ManifestParser.normalize,
+    get_normalized=ManifestParser.get_normalized,
+    
+    # Path extraction
+    extract_resource_path=ManifestParser.extract_resource_path,
+    extract_stack=ManifestParser.extract_stack,
+    
+    # Config parsing
+    parse_traefik=ManifestParser.parse_traefik,
+    
+    # Manifest utilities
+    merge_manifests=ManifestParser.merge,
+    get_description=ManifestParser.get_description,
+    
+    # =========================================================================
+    # Validation ⭐ NEW (Phase 3)
+    # =========================================================================
+    
+    # Main validation
+    validate=ManifestValidator.validate,
+    is_valid=ManifestValidator.is_valid,
+    get_validation_report=ManifestValidator.get_report,
+    
+    # Specific validation levels
+    validate_schema=ManifestValidator.validate_schema,
+    validate_values=ManifestValidator.validate_values,
+    validate_dependencies=ManifestValidator.validate_dependencies,
+    
+    # =========================================================================
+    # Discovery Integration ⭐ NEW (Phase 4)
+    # =========================================================================
+    
+    # Integration with discovery system
+    load_and_validate_integration=ManifestIntegration.load_and_validate,
+    load_all_integration=ManifestIntegration.load_all,
+    convert_to_resource=ManifestIntegration.convert_to_resource,
+    get_validation_summary=ManifestIntegration.get_validation_summary,
+    check_port_conflicts=ManifestIntegration.check_port_conflicts,
+    check_dependencies_valid=ManifestIntegration.check_dependencies_valid,
+    
+    # =========================================================================
+    # Field Mapper ⭐ NEW (Field Name Abstraction)
+    # =========================================================================
+    
+    # Field name mapping - THE MAGIC LAYER!
+    # Change field names in manifests without changing code
+    # Example: YAML has 'portNewNameOfAttr', code uses get('port')
+    map_field=ManifestMapper.get,
+    set_mapped_field=ManifestMapper.set,
+    get_all_mapped_fields=ManifestMapper.get_all,
+    map_manifest=ManifestMapper.map,
+    field_mappings=ManifestMapper.mappings,
+)
+
+# =============================================================================
+# Convenience Functions
+# =============================================================================
+
+def _is_valid_manifest(manifest):
+    """
+    Quick check if manifest has required fields.
+    
+    Args:
+        manifest: Dict to check
+    
+    Returns:
+        True if manifest appears valid
+    """
+    if not manifest:
+        return False
+    
+    required = ['appName', 'appType', 'stack']
+    for field in required:
+        if not manifest.get(field):
+            return False
+    
+    return True
+
+def _get_resource_type(manifest):
+    """
+    Get human-readable resource type description.
+    
+    Args:
+        manifest: Manifest dict
+    
+    Returns:
+        String description
+    """
+    app_type = manifest.get('appType', 'unknown')
+    stack = manifest.get('stack', 'unknown')
+    name = manifest.get('appName', 'unknown')
+    
+    return "{stack}/{app_type}/{name}".format(
+        stack=stack,
+        app_type=app_type,
+        name=name,
+    )
+
+# Add convenience functions to Manifest struct
+Manifest = struct(
+    **{k: getattr(Manifest, k) for k in dir(Manifest) if not k.startswith('_')},
+    is_valid_manifest=_is_valid_manifest,
+    get_resource_type=_get_resource_type,
+)
+
+
+# Inlined constant
+DEFAULTS = {}

package/engine/topologies/tilt/manifest/constants.star

@@ -0,0 +1,262 @@
+#!/usr/bin/env starlark
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# 📋 MANIFEST MODULE - CONSTANTS (Self-Contained for Extension Loading)
+# =============================================================================
+# Path: topologies/tilt/manifest/constants.star
+# Purpose: Shared constants, defaults, and validation lists for manifest system
+# Status: MIGRATED - Self-contained for pure extension loading (ext://)
+#
+# NOTE: This file is now self-contained and does NOT import from external paths
+# All constants are inlined below to support pure extension loading from GitHub.
+# =============================================================================
+
+# =============================================================================
+# INLINED CONSTANTS (formerly loaded from external files)
+# =============================================================================
+
+# From TILT_RESOURCE_DEFAULTS.star
+BASE_PORT_FRONTEND = 3000
+BASE_PORT_BACKEND = 4000
+HEALTH_CHECK_PATH = "/health"
+
+NAMING_PATTERNS = {
+    "backend_suffix": "-backend",
+    "frontend_suffix": "-frontend",
+    "migrator_suffix": "-migrator",
+    "library_suffix": "-lib",
+    "sdk_suffix": "-sdk",
+    "worker_suffix": "-worker",
+    "valid_separators": ["-", "_"],
+    "max_length": 63,
+    "min_length": 3,
+}
+
+TRAEFIK_CONFIG = {
+    "entrypoint": "web",
+    "network": "traefik-public",
+    "default_host": "localhost",
+    "default_port": 8080,
+    "tls_enabled": False,
+    "entrypoints": ["web"],
+    "middlewares": [],
+    "tls": {"enabled": False},
+    "healthcheck_path": "/health",
+    "healthcheck_interval": "10s",
+    "healthcheck_timeout": "5s",
+    "frontend_priority_base": 100,
+}
+
+# From TILT_TECH_STACK.star
+RUNTIME = "bun"
+
+# From TILT_DISCOVERY.star
+# Stacks are project-specific and discovered dynamically from filesystem
+VALID_STACKS = []
+
+VALID_RESOURCE_TYPES = [
+    "frontend",
+    "backend",
+    "library",
+    "migrator",
+    "sdk",
+    "worker",
+    "infra",
+    "mcp",
+    "bring-your-own",
+]
+
+VALID_FEATURES = [
+    # Resource-level features (code generators)
+    "api-client",
+    "env-config",
+    "api-index",
+    "prisma",
+    "drizzle",
+    "ddd",
+    # Infrastructure features
+    "nats",
+    "redis",
+    "infisical",
+    "vitest",
+    "traefik",
+    "websocket",
+    "graphql",
+    "grpc",
+    "vite-node",
+    "maintenance",
+]
+
+PORT_RANGES = {
+    "frontend": {"min": 3000, "max": 5999},
+    "backend": {"min": 4000, "max": 5999},
+    "bring-your-own": {"min": 4000, "max": 5999},
+    "mcp": {"min": 4000, "max": 5999},
+    "worker": {"min": 6000, "max": 6999},
+    "migrator": {"min": 7000, "max": 7999},
+    "sdk": {"min": 3000, "max": 9999},
+    "library": {"min": 3000, "max": 9999},
+}
+
+MAX_DEPENDENCIES = 10
+
+# From spec.master (OUTPUT section)
+AUTOGENERATED_FOLDER = ".autogenerated"
+
+# =============================================================================
+# MANIFEST FILE NAMING
+# =============================================================================
+
+MANIFEST_FILENAME = 'service.json'
+MANIFEST_FILENAME_YAML = 'service.yaml'
+MANIFEST_PATTERN = 'service.json'
+
+# =============================================================================
+# PACKAGE & GENERATED CONFIGURATION
+# =============================================================================
+
+PACKAGE_CONFIG_FILENAMES = {
+    'npmrc': '.npmrc.autogenerated',
+    'npmrc_docker_autogenerated': '.npmrc.docker.autogenerated',
+    'bunfig': 'bunfig.autogenerated.toml',
+    'bunfig_docker_autogenerated': 'bunfig.docker.autogenerated.toml',
+}
+
+GENERATED_CONFIG_FILENAMES = {
+    'vite_frontend': 'vite.config.frontend.autogenerated.ts',
+    'vite_backend': 'vite.config.backend.autogenerated.ts',
+    'vite_library': 'vite.config.lib.autogenerated.ts',
+    'vite_sdk': 'vite.config.sdk.autogenerated.ts',
+    'vite_build': 'vite.config.build.autogenerated.ts',
+    'tsconfig_docker': 'tsconfig.docker.autogenerated.json',
+    'tsconfig_local': 'tsconfig.autogenerated.json',
+    'playwright': 'playwright.config.autogenerated.ts',
+    'prisma': 'prisma.config.autogenerated.ts',
+    'dockerfile_app': 'Dockerfile.app.autogenerated',
+    'dockerfile_migrator': 'Dockerfile.migrator.autogenerated',
+    'nginx': 'nginx.autogenerated.conf',
+    'env_frontend': '.env.frontend.autogenerated',
+    'env_backend': '.env.backend.autogenerated',
+    'npmrc': PACKAGE_CONFIG_FILENAMES['npmrc'],
+    'npmrc_docker': PACKAGE_CONFIG_FILENAMES['npmrc_docker_autogenerated'],
+    'bunfig': PACKAGE_CONFIG_FILENAMES['bunfig'],
+    'bunfig_docker': PACKAGE_CONFIG_FILENAMES['bunfig_docker_autogenerated'],
+    'agents_md': 'AGENTS.md',
+}
+
+AUTOGENERATED_CONFIG_PATHS = {
+    'npmrc': AUTOGENERATED_FOLDER + '/' + PACKAGE_CONFIG_FILENAMES['npmrc'],
+    'npmrc_docker': AUTOGENERATED_FOLDER + '/' + PACKAGE_CONFIG_FILENAMES['npmrc_docker_autogenerated'],
+    'bunfig': AUTOGENERATED_FOLDER + '/' + PACKAGE_CONFIG_FILENAMES['bunfig'],
+    'bunfig_docker': AUTOGENERATED_FOLDER + '/' + PACKAGE_CONFIG_FILENAMES['bunfig_docker_autogenerated'],
+    'prisma': AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['prisma'],
+    'vite_build': AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_build'],
+}
+
+# =============================================================================
+# MANIFEST DEFAULTS
+# =============================================================================
+
+MANIFEST_DEFAULTS = {
+    'port': BASE_PORT_BACKEND,
+    'appType': 'backend',
+    'healthCheckPath': HEALTH_CHECK_PATH,
+    'internalPort': BASE_PORT_FRONTEND,
+    'replicas': 1,
+    'featuresEnabled': [],
+    'envVars': {},
+    'syncs': None,
+    'dependsOn': [],
+    'runtime': RUNTIME,
+    'traefik': {
+        'pathPrefix': '',
+        'priority': 100,
+    },
+}
+
+VALID_APP_TYPES = VALID_RESOURCE_TYPES
+
+DEFAULT_SYNCS = {
+    'frontend': [
+        'src',
+        'public',
+        'index.html',
+        AUTOGENERATED_CONFIG_PATHS['npmrc_docker'],
+        AUTOGENERATED_CONFIG_PATHS['bunfig_docker']
+    ],
+    'backend': [
+        'src',
+        AUTOGENERATED_CONFIG_PATHS['npmrc_docker'],
+        AUTOGENERATED_CONFIG_PATHS['bunfig_docker']
+    ],
+    'migrator': ['prisma'],
+    'library': ['src', 'package.json'],
+    'sdk': ['src', 'package.json'],
+    'bring-your-own': [],
+}
+
+RUNTIME_CONFIGS = {
+    'bun': {
+        'image_base': 'oven/bun:1.3.11-alpine',
+        'package_manager': 'bun',
+        'lockfile': 'bun.lock',
+    },
+    'node': {
+        'image_base': 'node:22-alpine',
+        'package_manager': 'npm',
+        'lockfile': 'package-lock.json',
+    },
+}
+
+TRAEFIK_DEFAULTS = {
+    'entrypoints': TRAEFIK_CONFIG['entrypoints'],
+    'middlewares': TRAEFIK_CONFIG['middlewares'],
+    'tls': TRAEFIK_CONFIG['tls'],
+    'healthcheck': {
+        'path': TRAEFIK_CONFIG['healthcheck_path'],
+        'interval': TRAEFIK_CONFIG['healthcheck_interval'],
+        'timeout': TRAEFIK_CONFIG['healthcheck_timeout'],
+    },
+}
+
+RESOURCE_NAME_PATTERNS = NAMING_PATTERNS
+
+VALIDATION_THRESHOLDS = {
+    'max_replicas': 5,
+    'max_dependencies': MAX_DEPENDENCIES,
+    'max_features': 10,
+    'max_env_vars': 50,
+}
+
+# =============================================================================
+# STRUCT EXPORT (for easy importing)
+# =============================================================================
+
+ManifestConstants = struct(
+    MANIFEST_FILENAME=MANIFEST_FILENAME,
+    MANIFEST_FILENAME_YAML=MANIFEST_FILENAME_YAML,
+    MANIFEST_PATTERN=MANIFEST_PATTERN,
+    PACKAGE_CONFIG_FILENAMES=PACKAGE_CONFIG_FILENAMES,
+    GENERATED_CONFIG_FILENAMES=GENERATED_CONFIG_FILENAMES,
+    AUTOGENERATED_CONFIG_PATHS=AUTOGENERATED_CONFIG_PATHS,
+    MANIFEST_DEFAULTS=MANIFEST_DEFAULTS,
+    VALID_APP_TYPES=VALID_APP_TYPES,
+    VALID_STACKS=VALID_STACKS,
+    BASE_PORT_FRONTEND=BASE_PORT_FRONTEND,
+    BASE_PORT_BACKEND=BASE_PORT_BACKEND,
+    DEFAULT_SYNCS=DEFAULT_SYNCS,
+    RUNTIME_CONFIGS=RUNTIME_CONFIGS,
+    TRAEFIK_DEFAULTS=TRAEFIK_DEFAULTS,
+    RESOURCE_NAME_PATTERNS=RESOURCE_NAME_PATTERNS,
+    VALIDATION_THRESHOLDS=VALIDATION_THRESHOLDS,
+)
+
+
+
+CONSTANTS = {}
+
+VALIDATION = {}
+
+# Inlined OUTPUT constant
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")