@flisk-sh/flisk 0.0.0-stage → 1.3.190

package/engine/topologies/tilt/common/utils_docker_networks.star

@@ -0,0 +1,54 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# 🐳 TILT SDK - DOCKER NETWORK MANAGEMENT
+# =============================================================================
+
+
+def fix_docker_networks(platform_networks):
+    """
+    Generates a shell command that:
+    1. Removes networks with incorrect labels (if they exist and are not in use)
+    2. Creates all platform networks if they don't exist, and fails with Docker's own
+       error if one that does not exist cannot be created
+    """
+    commands = []
+    commands.append('echo "Initializing Docker networks..."')
+
+    for network in platform_networks:
+        check_and_remove = '(docker network inspect ' + network + ' >/dev/null 2>&1 && '
+        check_and_remove += 'docker network inspect ' + network + ' --format "{{.Labels}}" | grep -q "com.docker.compose" && '
+        check_and_remove += 'echo "Removing network ' + network + ' with incorrect labels..." && '
+        check_and_remove += 'docker network rm ' + network + ' 2>/dev/null) || true'
+        commands.append(check_and_remove)
+
+        # Create the network. A failed create is an error unless the network exists
+        # afterwards (already there, or another process created it first). Docker's own
+        # message is printed and the command exits non-zero, so Tilt marks init-networks failed.
+        create_cmd = 'if _out=$(docker network create ' + network + ' 2>&1); then echo "Created network ' + network + '"; '
+        create_cmd += 'elif docker network inspect ' + network + ' >/dev/null 2>&1; then :; '
+        create_cmd += 'else echo "Failed to create Docker network ' + network + ': $_out" >&2; exit 1; fi'
+        commands.append(create_cmd)
+
+    commands.append('echo "Docker networks initialized"')
+
+    return ' && '.join(commands)
+
+
+def cleanup_docker_networks(platform_networks):
+    """
+    Generates a shell command to forcefully remove all platform networks.
+    WARNING: This will disconnect all containers from these networks first!
+    """
+    commands = []
+    commands.append('echo "Cleaning up Docker networks..."')
+
+    for network in platform_networks:
+        disconnect_cmd = 'for c in $(docker network inspect ' + network + ' -f "{{range .Containers}}{{.Name}} {{end}}" 2>/dev/null); do '
+        disconnect_cmd += 'docker network disconnect -f ' + network + ' "$c" 2>/dev/null || true; done'
+        commands.append(disconnect_cmd)
+        commands.append('docker network rm ' + network + ' 2>/dev/null || true')
+
+    commands.append('echo "Docker networks cleaned up"')
+
+    return ' && '.join(commands)

package/engine/topologies/tilt/common/utils_env.star

@@ -0,0 +1,92 @@
+# Copyright (c) 2026 Flisk contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# 🌍 TILT SDK - ENVIRONMENT UTILITIES
+# =============================================================================
+
+
+_DOTENV_NAME_FIRST = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_'
+_DOTENV_NAME_REST = _DOTENV_NAME_FIRST + '0123456789'
+
+
+def _is_dotenv_name(name):
+    if not name or name[0] not in _DOTENV_NAME_FIRST:
+        return False
+    for i in range(len(name)):
+        if name[i] not in _DOTENV_NAME_REST:
+            return False
+    return True
+
+
+def _dotenv_value(raw):
+    """One layer of matching quotes is removed, like a dotenv parser would.
+
+    Single quotes are literal. Inside double quotes a backslash escapes a quote, a backslash or a dollar sign, and \\n, \\r and \\t
+    become a newline, a carriage return and a tab. An unquoted value is used as is (inline comments are not stripped).
+    This reads the project .env; it does not undo the `$$` that the generated env files use for Docker Compose.
+    """
+    value = raw.strip()
+    if len(value) < 2 or value[0] not in ('"', "'") or value[-1] != value[0]:
+        return value
+
+    inner = value[1:-1]
+    if value[0] == "'":
+        return inner
+
+    result = ''
+    i = 0
+    while i < len(inner):
+        char = inner[i]
+        if char == '\\' and i + 1 < len(inner):
+            following = inner[i + 1]
+            if following == 'n':
+                result += '\n'
+            elif following == 'r':
+                result += '\r'
+            elif following == 't':
+                result += '\t'
+            elif following in ('"', '\\', '$'):
+                result += following
+            else:
+                result += char + following
+            i += 2
+            continue
+        result += char
+        i += 1
+    return result
+
+
+def load_dotenv(project_root=''):
+    """Load the project .env file into os.environ.
+
+    The Tiltfile lives in `.tdk/.tdk-out/`, so a bare `.env` lookup misses the
+    project-root file. Prefer an explicit project_root, then TDK_PROJECT_ROOT.
+
+    The file is read with `read_file` and parsed here: nothing goes through a shell, so a path containing a quote is fine, and Tilt
+    re-evaluates the Tiltfile when the .env changes. Lines may be `NAME=value` or `export NAME=value`; comments, blank lines and
+    lines that are not an assignment to a valid name are ignored. A missing file does nothing.
+    """
+    if not project_root:
+        project_root = os.environ.get('TDK_PROJECT_ROOT', '')
+    env_path = (project_root + '/.env') if project_root else '.env'
+    content = str(read_file(env_path, default=''))
+    if not content:
+        return
+
+    for line in content.split('\n'):
+        line = line.strip()
+        if not line or line.startswith('#'):
+            continue
+        if line.startswith('export '):
+            line = line[len('export '):].strip()
+        equals = line.find('=')
+        if equals <= 0:
+            continue
+        name = line[:equals].strip()
+        if _is_dotenv_name(name):
+            os.environ[name] = _dotenv_value(line[equals + 1:])
+
+
+def should_enable(resource_name, cfg, defaults):
+    """Check if a service should be enabled based on config and defaults."""
+    return cfg.get(resource_name, defaults.get(resource_name, False))

package/engine/topologies/tilt/common/utils_output.star

@@ -0,0 +1,99 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# 📊 TILT SDK - OUTPUT UTILITIES
+# =============================================================================
+
+
+def print_resource_summary(infra_services, app_resources, should_enable_fn):
+    """Print summary of enabled services and estimated memory usage."""
+    enabled_services = []
+    estimated_memory = 0
+
+    for s in infra_services:
+        if should_enable_fn(s['name']):
+            enabled_services.append(s['name'])
+            svc_memory = s.get('memory')
+            if svc_memory != None:
+                estimated_memory += svc_memory
+            else:
+                estimated_memory += 512  # Default 512MB
+
+    for s in app_resources:
+        if should_enable_fn(s['name']):
+            enabled_services.append(s['name'])
+            svc_memory = s.get('memory')
+            if svc_memory != None:
+                estimated_memory += svc_memory
+            else:
+                estimated_memory += 512  # Default 512MB
+
+    print("\n📊 Resource Summary:")
+    print("  🔧 Enabled services: " + str(len(enabled_services)))
+    print("  💾 Estimated memory: ~" + str(estimated_memory) + "MB")
+
+    if estimated_memory > 4096:
+        print("  ⚠️  WARNING: High memory usage (consider `tilt down && tilt up --focus <domain>`)")
+    elif estimated_memory > 2048:
+        print("  ⚡ MODERATE: Memory usage moderate (use `--focus` to reduce)")
+    else:
+        print("  ✅ OPTIMAL: Memory usage optimized")
+
+    return enabled_services
+
+
+def get_template_header(file_type, generator_name, resource_name='', extra_info=''):
+    """
+    Generate a standardized "DO NOT EDIT" header for auto-generated files.
+    """
+    is_ts_or_js = (
+        file_type.endswith('.ts') or
+        file_type.endswith('.tsx') or
+        file_type.endswith('.js') or
+        file_type.endswith('.jsx') or
+        file_type.endswith('.mjs') or
+        file_type.endswith('.mts')
+    )
+    is_css = file_type.endswith('.css') or file_type.endswith('.scss')
+    is_nginx = file_type.endswith('.conf') or file_type == 'nginx'
+
+    if is_ts_or_js or file_type in ['vite', 'tsconfig', 'typescript', 'javascript']:
+        border = '/' * 79
+        comment_start = '//'
+    elif is_css:
+        border = '/' + '*' * 77 + '/'
+        comment_start = ' *'
+    elif is_nginx or file_type in ['dockerfile', 'compose', 'env', 'shell', 'npmrc', 'bunfig']:
+        border = '#' * 79
+        comment_start = '#'
+    else:
+        border = '#' * 79
+        comment_start = '#'
+
+    resource_line = ''
+    if resource_name:
+        resource_line = '\n{c} Service: {s}'.format(c=comment_start, s=resource_name)
+
+    extra_line = ''
+    if extra_info:
+        extra_line = '\n{c} Type: {e}'.format(c=comment_start, e=extra_info)
+
+    header = """{border}
+{c} 🛑 CRITICAL: SYSTEM-GENERATED FILE - DO NOT MODIFY DIRECTLY
+{c}
+{c} ANY MANUAL CHANGES MADE TO THIS FILE WILL BE WIPED ON THE NEXT 'tilt up'.
+{c} TO MODIFY THIS CONFIGURATION:
+{c} 1. Edit the source generator in: .tilt/topologies/
+{c} 2. Or update service.json
+{c}
+{c} Generation Source: {generator}{resource_line}{extra_line}
+{border}
+""".format(
+        border=border,
+        c=comment_start,
+        generator=generator_name,
+        resource_line=resource_line,
+        extra_line=extra_line,
+    )
+
+    return header

package/engine/topologies/tilt/config/AGENTS.md

@@ -0,0 +1,68 @@
+# AGENTS.md - Global Configuration
+
+## Purpose
+
+Global Tilt configuration, feature flags, environment profiles, and defaults.
+
+## Key Files
+
+### Core Config
+- **`global.star`** - Global configuration loading
+- **`profiles.star`** - Environment profiles (dev, staging, prod)
+- **`features.star`** - Feature flags
+
+### Defaults
+- **`defaults.star`** - Default values for all settings
+- **`overrides.star`** - Local overrides (gitignored)
+
+## Key Concepts
+
+### Configuration Hierarchy
+```
+1. defaults.star        (base values)
+2. profiles.star        (environment-specific)
+3. global.star          (project-wide)
+4. overrides.star       (local user settings)
+5. Environment vars     (runtime)
+```
+
+## Common Tasks
+
+### Get global config
+```starlark
+load("../discovery/config.star", "get_global_config")
+config = get_global_config()
+```
+
+### Check feature flag
+```starlark
+load("./features.star", "is_feature_enabled")
+if is_feature_enabled("nats_streaming"):
+    # Enable NATS
+```
+
+### Get profile
+```starlark
+load("./profiles.star", "get_profile")
+profile = get_profile()  # "pre-alpha", "alpha", "beta", "production"
+```
+
+## Integration
+
+- Loaded by main `Tiltfile`
+- Used by `discovery/config.star`
+- Referenced by `spec.master`
+
+## Important Files
+
+- `spec.master` (project root) - Service-specific defaults
+- `.env` - Local environment variables
+- `tilt_options.json` - Tilt-specific options
+
+## Configuration Values
+
+Common config includes:
+- `MOCK_TIKKIE` - Use mock payment API
+- `FOCUS_*` - Which service groups to load
+- `DB_*` - Database settings
+- `VERDACCIO_*` - NPM registry settings

package/engine/topologies/tilt/config/defaults.star

@@ -0,0 +1,5 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+load("../../../../discovery/registry.star", _DEFAULTS_EXPORT = "DEFAULTS_EXPORT")
+
+DEFAULTS = _DEFAULTS_EXPORT

package/engine/topologies/tilt/config/feature_flags.star

@@ -0,0 +1,12 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+load("../../../../discovery/registry.star", _DEFAULTS_EXPORT = "DEFAULTS_EXPORT")
+
+def is_enabled(flag_name, cfg, fallback = True):
+    if cfg.get(flag_name) != None:
+        return cfg.get(flag_name)
+    return _DEFAULTS_EXPORT.get(flag_name, fallback)
+
+
+# Inlined constant
+DEFAULTS = {}

package/engine/topologies/tilt/config/global.star

@@ -0,0 +1,57 @@
+# Copyright (c) 2026 Flisk Landscape contributors
+# SPDX-License-Identifier: MIT
+# =============================================================================
+# ⚙️ TOPOLOGIES - GLOBAL CONFIG
+# =============================================================================
+
+load("./profiles.star", "Focus")
+load(
+    "../../../../discovery/registry.star",
+    "APP_RESOURCES",
+    "GLOBAL_CONFIG_EXPORT",
+    "INFRA_RESOURCES_EXPORT",
+    "DDD_LIBS_EXPORT",
+    "DEFAULTS_EXPORT",
+    "CORE_INFRA_EXPORT",
+    "INFRA_STACK_MAP_EXPORT",
+    "OPTIONAL_INFRA_EXPORT",
+    "RESOURCE_DEPENDENCIES",
+    "RESOURCE_ALIASES",
+    "RESOURCE_PATH_MAP",
+    "get_platform_libs_export",
+    "get_product_libs_export",
+)
+
+
+def build_config_context():
+    return {
+        "internal_scope": GLOBAL_CONFIG_EXPORT["internal_scope"],
+        "library_roots": GLOBAL_CONFIG_EXPORT["library_roots"],
+        "verdaccio_url_local": GLOBAL_CONFIG_EXPORT["verdaccio_url_local"],
+        "verdaccio_url_docker": GLOBAL_CONFIG_EXPORT["verdaccio_url_docker"],
+        "resource_path_map": RESOURCE_PATH_MAP,
+        "database": GLOBAL_CONFIG_EXPORT["database"],
+    }
+
+
+Config = struct(
+    get_needed_services = Focus.get_needed_services,
+    apply_focus = Focus.apply_focus,
+    create_enabler = Focus.create_enabler,
+    build_context = build_config_context,
+    GLOBAL = GLOBAL_CONFIG_EXPORT,
+    DEFAULTS = DEFAULTS_EXPORT,
+    APP_RESOURCES = APP_RESOURCES,
+    INFRA_RESOURCES = INFRA_RESOURCES_EXPORT,
+    DDD_LIBS = DDD_LIBS_EXPORT,
+    CORE_INFRA = CORE_INFRA_EXPORT,
+    INFRA_STACK_MAP = INFRA_STACK_MAP_EXPORT,
+    OPTIONAL_INFRA = OPTIONAL_INFRA_EXPORT,
+    RESOURCE_DEPENDENCIES = RESOURCE_DEPENDENCIES,
+    RESOURCE_ALIASES = RESOURCE_ALIASES,
+    RESOURCE_PATH_MAP = RESOURCE_PATH_MAP,
+    get_platform_libs = get_platform_libs_export,
+    get_product_libs = get_product_libs_export,
+)
+
+GLOBAL_CONFIG = {}