brushline.integrations.femic

The pinned FEMIC extension boundary: versions, provider ids, node ids, CLI commands, data contracts, the compatibility report, and the boundary-pin validator.

The pinned FEMIC extension boundary.

Brushline may call only the FEMIC CLI and FreshForge provider surface recorded here. FEMIC is an alpha dependency, so the pin is exact: a new FEMIC or FreshForge version is a deliberate boundary review, not a silent upgrade. This module does not import FEMIC; it only records and checks the surface.

class brushline.integrations.femic.FemicCompatibility(femic_version: str, freshforge_version: str | None, errors: tuple[str, ...], warnings: tuple[str, ...])[source]

Bases: object

The result of checking one FEMIC/FreshForge version pair.

Parameters:
  • femic_version (str) – FEMIC version being checked.

  • freshforge_version (str or None) – FreshForge version being checked, or None when it was not supplied.

  • errors (tuple of str) – Named compatibility errors.

  • warnings (tuple of str) – Non-fatal findings.

property is_compatible: bool

Return whether the pair passes every compatibility check.

Returns:

bool – True when there are no errors.

to_dict() → dict[str, object][source]

Return a JSON-ready report.

Returns:

dict of str to object – Versions, compatibility, errors, and warnings.

brushline.integrations.femic.boundary_manifest() → dict[str, object][source]

Return the canonical FEMIC boundary manifest.

Returns:

dict of str to object – The schema version, exact pins, provider ids, node ids, CLI commands, and data contracts.

brushline.integrations.femic.check_femic_compatibility(femic_version: str, freshforge_version: str | None = None) → FemicCompatibility[source]

Check a FEMIC/FreshForge version pair against the exact pins.

Parameters:
  • femic_version (str) – FEMIC version.

  • freshforge_version (str or None, optional) – FreshForge version. When None, the FreshForge check is reported as not run.

Returns:

FemicCompatibility – The compatibility report.

brushline.integrations.femic.load_boundary_pin(path: Path) → dict[str, object][source]

Load a boundary pin from JSON.

Parameters:

path (Path) – JSON file.

Returns:

dict of str to object – The parsed pin.

Raises:

ValueError – When the file does not contain a JSON object.

brushline.integrations.femic.validate_boundary_pin(payload: dict[str, object]) → ContractValidation[source]

Validate a boundary pin against the canonical manifest.

Parameters:

payload (dict of str to object) – Parsed boundary pin.

Returns:

ContractValidation – Errors, warnings, and counts.

brushline.integrations.femic.write_boundary_pin(path: Path) → Path[source]

Write the canonical boundary pin.

Parameters:

path (Path) – Destination JSON file.

Returns:

Path – The written path.