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:
objectThe 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
Nonewhen 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 –
Truewhen there are no errors.
- 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.