# yaml-language-server: $schema=https://raw.githubusercontent.com/xraph/forge/main/schema/forge.schema.json

{
  "yaml.schemas": {
    "https://raw.githubusercontent.com/xraph/forge/main/schema/forge.schema.json": ".forge.yaml"
  }
}

# =============================================================================
# .forge.yaml — Forge project configuration
# Schema: https://raw.githubusercontent.com/xraph/forge/main/schema/forge.schema.json
# =============================================================================

# -----------------------------------------------------------------------------
# Project metadata and structure
# -----------------------------------------------------------------------------
project:
  name: my-project                       # Required. Project name.
  version: "1.0.0"                       # Semver version string.
  description: "My Forge application"    # Human-readable description.
  type: monorepo                         # Project type (currently only "monorepo").
  layout: single-module                  # "single-module" or "multi-module".
  module: github.com/myorg/my-project    # Go module path (required for single-module).

  # Directory structure overrides (single-module layout).
  # Omit to use Go convention defaults.
  structure:
    cmd: ./cmd                           # App entry points (default: ./cmd)
    apps: ./apps                         # App config directories (default: ./apps)
    pkg: ./pkg                           # Shared packages (default: ./pkg)
    internal: ./internal                 # Internal packages (default: ./internal)
    extensions: ./extensions             # Extensions (default: ./extensions)
    database: ./database                 # Migrations & seeds (default: ./database)
    config: ./config                     # Config files (default: ./config)
    deployments: ./deployments           # Deployment artifacts (default: ./deployments)

  # Workspace configuration (multi-module layout only).
  workspace:
    enabled: true
    apps: "./apps/*"                     # Glob for app modules
    services: "./services/*"             # Glob for service modules
    extensions: "./extensions/*"         # Glob for extension modules
    pkg: "./pkg"                         # Shared package path

# -----------------------------------------------------------------------------
# Development server and tooling
# -----------------------------------------------------------------------------
dev:
  auto_discover: true                    # Auto-discover apps in cmd/ or apps/
  discover_pattern: "./cmd/*"            # Custom discovery glob pattern
  default_app: api-gateway               # App to run when none is specified

  # File watching
  watch:
    enabled: true
    paths:                               # Glob patterns to watch
      - "./apps/**/internal/**/*.go"
      - "./pkg/**/*.go"
      - "./internal/**/*.go"
    exclude:                             # Glob patterns to exclude
      - "**/*_test.go"
      - "**/testdata/**"
      - "**/vendor/**"

  # Hot reload
  hot_reload:
    enabled: true
    delay: 500ms                         # Debounce delay before restart

  # Docker dev mode (forge dev --docker)
  docker:
    enabled: false                       # Enable Docker mode by default
    image: golang:1.25-alpine            # Base image for dev container
    dockerfile: ""                       # Custom Dockerfile (empty = auto-generate)
    network: bridge                      # Docker network
    platform: linux/amd64                # Target platform (optional)
    volumes:                             # Extra host:container volume mounts
      /tmp/go-cache: /root/.cache/go-build
    env:                                 # Extra container environment variables
      DEBUG: "true"
      LOG_LEVEL: debug
    build_args:                          # Docker build arguments
      GO_VERSION: "1.25"

# -----------------------------------------------------------------------------
# Database
# -----------------------------------------------------------------------------
database:
  driver: postgres                       # postgres, mysql, or sqlite
  migrations_path: ./database/migrations # Path to migration files
  seeds_path: ./database/seeds           # Path to seed files
  models_output: ./database/models       # Output for generated models

  connections:                           # Named database connections
    default:
      url: postgres://user:password@localhost:5432/mydb
      max_connections: 25
      max_idle: 5
    read_replica:
      url: postgres://user:password@replica:5432/mydb
      max_connections: 10
      max_idle: 2

# -----------------------------------------------------------------------------
# Build
# -----------------------------------------------------------------------------
build:
  output_dir: ./bin                      # Binary output directory
  cmd_dir: ./cmd                         # Directory with app entry points
  auto_discover: true                    # Auto-discover buildable apps
  ldflags: "-s -w"                       # Linker flags
  tags:                                  # Build tags
    - production

  # Explicit app list (overrides auto-discovery when non-empty)
  apps:
    - name: api-gateway
      cmd: ./cmd/api-gateway
      output: api-gateway
      dockerfile: docker/Dockerfile.api
    - name: worker
      cmd: ./cmd/worker
      output: worker
      module: ./apps/worker              # Multi-module path

  # Cross-compilation targets
  platforms:
    - os: linux
      arch: amd64
    - os: linux
      arch: arm64
    - os: darwin
      arch: arm64

# -----------------------------------------------------------------------------
# Deployment
# -----------------------------------------------------------------------------
deploy:
  registry: ghcr.io/myorg                # Docker registry prefix

  # Environment definitions
  environments:
    - name: dev
      namespace: dev
      variables:
        LOG_LEVEL: debug
    - name: staging
      namespace: staging
      cluster: staging-cluster
      region: us-east-1
      variables:
        LOG_LEVEL: info
    - name: production
      namespace: prod
      cluster: prod-cluster
      region: us-east-1
      variables:
        LOG_LEVEL: warn

  # Docker deployment config (forge infra docker / forge deploy docker)
  docker:
    build_context: .
    dockerfile: Dockerfile
    compose_file: docker-compose.yml
    network: forge-network
    volumes:
      pg-data: /var/lib/postgresql/data
      redis-data: /data

  # Kubernetes config (forge infra k8s / forge deploy k8s)
  kubernetes:
    manifests: ./deployments/k8s
    namespace: default
    context: my-k8s-cluster
    registry: ghcr.io/myorg

  # DigitalOcean App Platform config (forge infra do)
  digitalocean:
    region: nyc1
    app_spec_file: ./deployments/do/app.yaml
    cluster_name: my-do-cluster
    git_repo: myorg/my-project
    git_branch: main
    deploy_on_push: true

  # Render.com config (forge infra render)
  render:
    blueprint_file: ./deployments/render/render.yaml
    region: oregon
    git_repo: myorg/my-project
    git_branch: main

# -----------------------------------------------------------------------------
# Code generation
# -----------------------------------------------------------------------------
generate:
  templates_path: ./templates            # Custom template directory

  generators:                            # Per-generator overrides
    app:
      output: "./cmd/{{.Name}}"
      cmd_path: "./cmd"
    service:
      output: "./internal/services/{{.Name}}"
      create_module: false
    controller:
      output: "./internal/handlers/{{.Name}}"
      cmd_path: "./cmd"
      internal_path: "./internal"

# -----------------------------------------------------------------------------
# Extensions (pass-through config for Forge extensions)
# -----------------------------------------------------------------------------
extensions:
  auth:
    enabled: true
    default_provider: bearer
  database:
    auto_migrate: true
  cache:
    driver: redis
    ttl: 10m

# -----------------------------------------------------------------------------
# Testing
# -----------------------------------------------------------------------------
test:
  coverage_threshold: 80                 # Minimum coverage percentage
  race_detector: true                    # Enable -race flag
  parallel: true                         # Run tests in parallel
  timeout: 30s                           # Test timeout

extensions:
  auth:
    enabled: true
    default_provider: bearer
  cache:
    driver: redis
    ttl: 10m

# yaml-language-server: $schema=https://raw.githubusercontent.com/xraph/forge/main/schema/forge-app.schema.json

# apps/api-gateway/.forge.yaml
app:
  name: api-gateway
  type: web
  version: "1.0.0"

dev:
  port: 8080
  host: localhost
  env_file: .env.api
  docker:
    image: golang:1.25-bookworm
    network: api-network
    env:
      SERVICE_NAME: api-gateway

build:
  output: api-gateway
  dockerfile: docker/Dockerfile.api
  tags:
    - jsoniter
  ldflags: "-X main.version=1.0.0"

project:
  name: my-api
  module: github.com/me/my-api

project:
  name: my-platform
  layout: multi-module
  workspace:
    enabled: true
    apps: "./apps/*"

project:
  name: my-api
  module: github.com/me/my-api

dev:
  docker:
    network: my-network
    env:
      DEBUG: "true"

project:
  name: my-platform
  module: github.com/me/my-platform

deploy:
  registry: ghcr.io/me

  environments:
    - name: dev
      namespace: dev
    - name: production
      namespace: prod
      region: us-east-1

  kubernetes:
    context: prod-cluster