Configuration

Every ForgeConfig field, its default value, environment variable, and YAML key.

---

Configuration Loading Order

FORGE loads configuration through ForgeConfig, which resolves values in this priority order (highest to lowest):

1. Explicit constructor arguments — passed directly to ForgeConfig(...)
2. Environment variables — prefixed with FORGE_
3. YAML config file — forge_config.yaml in the working directory
4. Built-in defaults — sensible defaults for every field

Python — explicit config

from forge import normalize_content
from forge.config import ForgeConfig

config = ForgeConfig(
    hmac_secret="my-production-secret",
    max_iterations=15,
    telemetry_enabled=True
)

result = normalize_content(content, "TEXT", config=config)

---

Core Settings

---

Actor Settings

Actor information is embedded in every ForgeStamp for provenance tracking.

---

Telemetry Settings

---

Lane Configuration

Each lane can be individually configured under the forge.lanes YAML key or via environment variables with the pattern FORGE_LANE_{ID}_{SETTING}.

YAML — per-lane configuration

forge:
  lanes:
    L0:
      enabled: true
      strict: true
      timeout_ms: 3000
    T2:
      enabled: true
      strict: true
      config:
        block_injection: true
        max_prompt_length: 10000
    T3:
      enabled: true
      config:
        policy_file: "policies/compliance_v2.yaml"
        jurisdictions:
          - US
          - EU
    L4:
      config:
        stamp_algorithm: "hmac-sha256"
        include_content_hash: true

---

Content Type Configuration

Override lane chains or settings on a per-content-type basis.

YAML — per-type overrides

forge:
  types:
    DIFF:
      max_iterations: 20
      fail_closed: true
    JSON:
      max_iterations: 5
      skip_lanes: ["T2"]
    PROMPT:
      fail_closed: true
    COMPLIANCE:
      max_iterations: 15
    SPEECH:
      enabled: true
    VIDEO_META:
      enabled: true
      max_iterations: 8

---

Service Provider (SP) Settings

SP lanes are outbound-only — they apply additional normalization when FORGE emits content to external services.

---

Complete YAML Example

forge_config.yaml

forge:
  # Core
  hmac_secret: "${FORGE_HMAC_SECRET}"  # Can reference env vars
  max_iterations: 10
  convergence_threshold: 0.0
  fail_closed: true
  strict_mode: false
  timeout_ms: 30000
  log_level: INFO

  # Actor
  actor:
    service: "my-production-api"
    version: "3.1.0"
    environment: production

  # Telemetry
  telemetry:
    enabled: true
    upload: true
    endpoint: "https://telemetry.fixpointforge.report"
    batch_size: 100
    flush_interval_s: 60
    anonymize: true
    include_lane_timing: true

  # Lane overrides
  lanes:
    L0:
      enabled: true
      strict: true
    T2:
      strict: true
      config:
        block_injection: true
    T3:
      config:
        policy_file: "policies/compliance_v2.yaml"
    L4:
      config:
        include_content_hash: true

  # Content type overrides
  types:
    DIFF:
      max_iterations: 20
    COMPLIANCE:
      max_iterations: 15
      fail_closed: true
    SPEECH:
      enabled: true
    VIDEO_META:
      enabled: true

  # Service Provider (outbound)
  sp:
    enabled: false
    default_policy: strict

---

Programmatic Access

Access resolved config values programmatically:

Python

from forge.config import ForgeConfig

# Load from env + YAML
config = ForgeConfig()

# Inspect resolved values
print(config.hmac_secret)           # "my-production-secret"
print(config.max_iterations)        # 10
print(config.telemetry_enabled)     # True
print(config.telemetry_endpoint)    # "https://telemetry.fixpointforge.report"

# Check lane config
print(config.lane_enabled("T2"))    # True
print(config.lane_config("T2"))     # {"block_injection": True, ...}

# Check content type config
print(config.type_enabled("DIFF"))  # True
print(config.type_max_iterations("DIFF"))  # 20

# Override at runtime
config.set("max_iterations", 25)
config.set_lane("T2", "strict", True)

# Validate configuration
errors = config.validate()
if errors:
    for e in errors:
        print(f"Config error: {e}")