Module agentforge4j.config.loader

module agentforge4j.config.loader
Loads workflow and agent bundles from the filesystem or classpath and maps them into core models.

Responsibilities include bundle discovery, index parsing, resource wiring, and mapping loaded resources into agentforge4j.core domain models. Shipped bundles are located on the classpath (the shipped-workflows / shipped-agents roots), which a separately shipped, independently-versioned workflow catalog provides; the framework owns only the locator and compatibility-gate mechanism.

Intended consumers: embedding applications, tests, and tooling that prepare bundles for execution.

Load-time invariant: across the reachable graph of every workflow (the workflow, the blueprints it references, and the sub-workflows its WORKFLOW steps reach) each step id must resolve to a single structural location — reachable step ids must be unique. Bundles that violate it are rejected at load so the runtime never has to resolve an ambiguous step at a gate.