loomweave-plugin-python 1.0.0

Loomweave Python language plugin — v1.0 release

loomweave-plugin-python

The Python language plugin for Loomweave. Extracts Python entities from source files and serves them to the Loomweave core over the JSON-RPC protocol defined in WP2 L4.

Status: Python structural extractor. It emits modules, classes, functions, contains, calls, references, imports, and versioned entity signatures for Stable Entity Identity (SEI) matching. It also reads Wardline's NG-25 trust-vocabulary descriptor without importing Wardline and emits source-observed Wardline decorator metadata/tags on decorated entities when a descriptor is available.

Install (development)

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

This places loomweave-plugin-python on your $PATH and installs the dev-time toolchain (ruff, mypy, pytest, pytest-cov, pre-commit).

ADR-023 tooling gates

Every commit must pass all four:

ruff check plugins/python
ruff format --check plugins/python
mypy --strict plugins/python
pytest plugins/python

CI runs the same four gates in the python-plugin job.

Design references

• WP3 plan — task ledger, lock-ins, and UQ resolutions.
• ADR-003 — 3-segment EntityId format this plugin produces.
• ADR-018 — cross-product identity join with Wardline.
• ADR-022 — manifest schema and ontology-boundary enforcement.
• ADR-023 — the four Python gates and the pre-commit setup.