Module agentforge4j.config.loader

Package com.agentforge4j.config.loader.catalog

Class CatalogCompatibilityGate

java.lang.Object

com.agentforge4j.config.loader.catalog.CatalogCompatibilityGate

public final class CatalogCompatibilityGate
extends Object

Enforces compatibility between a shipped workflow catalog and the running framework, before the catalog's workflows are loaded.

Content-present predicate: a catalog is considered present when shipped-workflows/index resolves on the classpath and contains at least one non-blank entry. When it is absent or empty the gate is a no-op — a pure framework with no catalog jar loads zero shipped workflows, which is valid, not an error. When a catalog is present its shipped-workflows/agentforge4j-catalog.json manifest is required: a missing, unparseable, or out-of-range manifest fails fast with CatalogCompatibilityException. Test fixtures loaded from other roots (e.g. /test-workflows/) never trip this gate.

Resources are resolved through the same loader the locators use (WorkflowBundleLocator.class.getClassLoader()); version bounds are compared numerically by NumericVersion so a 0.0.1-SNAPSHOT framework satisfies a 0.0.1 minimum.

Constructor Summary

Constructors

Constructor	Description
CatalogCompatibilityGate(ClassLoader loader, String frameworkVersion, int supportedSchemaVersion, com.fasterxml.jackson.databind.ObjectMapper mapper)	Creates a gate.

Method Summary

Modifier and Type	Method	Description
static CatalogCompatibilityGate	defaults()	The production gate: resolves catalog resources on the locator's classloader, against the running FrameworkVersion and the supported WorkflowSchemaVersion.SUPPORTED_WORKFLOW_SCHEMA_VERSION.
void	enforce()	Verifies catalog/framework compatibility, throwing when a present catalog is incompatible.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CatalogCompatibilityGate

public CatalogCompatibilityGate(ClassLoader loader,
 String frameworkVersion,
 int supportedSchemaVersion,
 com.fasterxml.jackson.databind.ObjectMapper mapper)

Creates a gate. Prefer defaults() for production wiring; this constructor lets tests supply a classloader over a controlled catalog layout and a fixed framework version.

Parameters:

loader - classloader over which catalog resources are resolved

frameworkVersion - the running framework version

supportedSchemaVersion - the workflow schema version this framework supports

mapper - JSON mapper for the manifest

Method Details

defaults

public static CatalogCompatibilityGate defaults()

The production gate: resolves catalog resources on the locator's classloader, against the running FrameworkVersion and the supported WorkflowSchemaVersion.SUPPORTED_WORKFLOW_SCHEMA_VERSION.

Returns:

a gate wired for the running framework

enforce

public void enforce()

Verifies catalog/framework compatibility, throwing when a present catalog is incompatible.

Throws:

CatalogCompatibilityException - when a catalog is present but its manifest is missing, unparseable, version-incompatible, or declares an unsupported workflow schema version