Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

Release v0.49.0

Louis Choquel4c932d48e01c
diff --git a/.badges/tests.json b/.badges/tests.json
index c5a369a1b..dd1b2584e 100644
--- a/.badges/tests.json
+++ b/.badges/tests.json
@@ -1,7 +1,7 @@
{
"schemaVersion": 1,
"label": "tests",
- "message": "10672",
+ "message": "10725",
"color": "blue",
"cacheSeconds": 300
}
\ No newline at end of file
diff --git a/.test_durations b/.test_durations
index 2f6817d16..49a0e2bf1 100644
--- a/.test_durations
+++ b/.test_durations
@@ -672,6 +672,9 @@
"tests/integration/pipelex/pipeline/test_strip_namespace_enrichment.py::TestStripNamespaceEnrichment::test_unstrippable_syntax_errors_are_not_enriched[\\ndomain = \"nsfix_cross\"\\nmain_pipe = \"run_seq\"\\n\\n[pipe.\"otherpkg.hello\"]\\ntype = \"PipeLLM\"\\ndescription = \"From another package.\"\\noutput = \"Text\"\\nprompt = \"Hello\"\\n\\n[pipe.run_seq]\\ntype = \"PipeSequence\"\\ndescription = \"Run it.\"\\noutput = \"Text\"\\nsteps = [\\n { pipe = \"otherpkg.hello\", result = \"greeting\" },\\n]\\n]": 0.1118,
"tests/integration/pipelex/pipeline/test_validate_bundle_clean_summary.py::TestValidateBundleCleanSummary::test_validate_bundle_message_is_clean_summary": 1.6395,
"tests/integration/pipelex/pipeline/test_validate_bundle_clean_summary.py::TestValidateBundleCleanSummary::test_validate_bundles_from_directory_message_is_clean_summary": 8.2002,
+ "tests/integration/pipelex/pipeline/test_validate_bundle_entry_shape_parity.py::TestValidateBundleEntryShapeParity::test_both_entry_shapes_report_the_same_categorized_errors[missing_input_variable]": 0.335,
+ "tests/integration/pipelex/pipeline/test_validate_bundle_entry_shape_parity.py::TestValidateBundleEntryShapeParity::test_both_entry_shapes_report_the_same_categorized_errors[optional_input_unguarded]": 0.1166,
+ "tests/integration/pipelex/pipeline/test_validate_bundle_entry_shape_parity.py::TestValidateBundleEntryShapeParity::test_both_entry_shapes_report_the_same_categorized_errors[unresolved_concept]": 1.3476,
"tests/integration/pipelex/pipeline/test_validate_bundle_library_lifecycle.py::TestValidateBundleLibraryLifecycle::test_validate_bundle_tears_down_library_on_translated_error": 1.3264,
"tests/integration/pipelex/pipeline/test_validate_bundle_library_lifecycle.py::TestValidateBundleLibraryLifecycle::test_validate_bundle_tears_down_on_base_exception_in_pre_try_window": 0.0603,
"tests/integration/pipelex/pipeline/test_validate_bundle_library_lifecycle.py::TestValidateBundleLibraryLifecycle::test_validate_bundle_tears_down_on_resolve_library_dirs_failure": 0.1522,
@@ -1080,7 +1083,28 @@
"tests/integration/pipelex/system/test_load_config.py::TestLoadConfig::test_kit_config_matches_defaults": 0.0956,
"tests/integration/pipelex/system/test_load_config.py::TestLoadConfig::test_load_config": 0.985,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[NOTSET]": 0.0002,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_batch_item_name_collision]": 1.3363,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_dry_run_residual]": 0.3496,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_extraneous_input_variable]": 0.289,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_inadequate_output_concept]": 1.3292,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_inadequate_output_multiplicity]": 0.0757,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_stuff_spec_mismatch]": 0.2841,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_llm_output_cannot_be_image]": 1.3251,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_missing_input_variable]": 0.0666,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_missing_pipe_type]": 0.3552,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_native_concept_redeclaration]": 1.3402,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_optional_branch_required_field]": 0.0747,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_optional_input_unguarded]": 0.2986,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_optional_marker_invalid]": 1.3524,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_optional_not_handled]": 0.0736,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_optional_output_required]": 0.3135,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_pipe_code_syntax]": 1.3603,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_unknown_pipe_type]": 0.0833,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_unresolved_concept]": 0.2737,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_unresolved_concept_owned]": 1.3768,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_unresolved_pipe_dependency]": 0.0656,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_the_invalid_arm_bites_on_a_deliberately_broken_bundle": 1.4091,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_the_invalid_arm_bites_when_a_declared_error_stops_being_produced": 0.0887,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_valid_entry_validates[controller_batch_crate_labels]": 0.6784,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_valid_entry_validates[controller_condition_parcel_routing]": 0.7452,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_valid_entry_validates[controller_sequence_menu_card]": 0.6682,
@@ -5652,6 +5676,35 @@
"tests/unit/pipelex/errors/test_error_pages_generator.py::TestErrorPagesGenerator::test_report_total_sums_four_populations": 0.0007,
"tests/unit/pipelex/errors/test_error_pages_generator.py::TestErrorPagesGenerator::test_reserved_slug_collision_raises": 0.002,
"tests/unit/pipelex/errors/test_error_pages_generator.py::TestErrorPagesGenerator::test_run_is_idempotent": 0.1344,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_an_unregistered_error_type_is_refused": 1.3125,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[DryRunError]": 0.0145,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[batch_item_name_collision]": 0.0008,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[circular_dependency_error]": 0.0126,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[extraneous_input_variable]": 0.0013,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[inadequate_output_concept]": 0.0008,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[inadequate_output_multiplicity]": 1.3059,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[input_stuff_spec_mismatch]": 0.0007,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[invalid_pipe_code_syntax]": 0.0014,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[llm_output_cannot_be_image]": 0.0003,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[missing_input_variable]": 1.2881,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[missing_pipe_type]": 0.0146,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[native_concept_redeclaration]": 0.0163,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[optional_branch_required_field]": 0.0003,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[optional_force_redundant]": 1.3066,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[optional_input_unguarded]": 0.0007,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[optional_marker_invalid]": 0.0007,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[optional_not_handled]": 1.2372,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[optional_output_required]": 0.0009,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[unknown_concept]": 0.0203,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[unknown_factory_error]": 0.0146,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[unknown_pipe_type]": 1.3078,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[unknown_validation_error]": 1.33,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[unresolved_concept]": 0.0004,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[unresolved_pipe_dependency]": 0.0011,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_registry_has_no_duplicate_wire_values": 0.0003,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_registry_holds_every_member_of_every_contributing_enum": 1.305,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_registry_order_is_deterministic": 0.0169,
+ "tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_the_parse_level_residual_may_carry_no_error_type": 0.0123,
"tests/unit/pipelex/exceptions/test_class_level_metadata.py::TestClassLevelMetadata::test_caller_facing_message[cogt-exc8-False]": 0.0009,
"tests/unit/pipelex/exceptions/test_class_level_metadata.py::TestClassLevelMetadata::test_caller_facing_message[config-exc6-False]": 0.0014,
"tests/unit/pipelex/exceptions/test_class_level_metadata.py::TestClassLevelMetadata::test_caller_facing_message[csv-exc2-True]": 0.0005,
@@ -8986,8 +9039,10 @@
"tests/unit/pipelex/test_error_report_problem_document.py::TestErrorReportProblemDocument::test_strict_mode_passes_through_detail_for_caller_facing_report": 0.0009,
"tests/unit/pipelex/test_error_report_problem_document.py::TestErrorReportProblemDocument::test_strict_mode_redacts_detail_and_drops_disclosure_fields": 0.0009,
"tests/unit/pipelex/test_error_report_problem_document.py::TestErrorReportProblemDocument::test_strict_mode_redacts_detail_for_input_domain_without_caller_facing_flag": 0.0005,
+ "tests/unit/pipelex/test_extras/test_mthds_corpus_exhaustivity.py::TestMthdsCorpusExhaustivity::test_every_invalid_entry_covers_the_tag_its_expected_error_names": 0.1897,
"tests/unit/pipelex/test_extras/test_mthds_corpus_exhaustivity.py::TestMthdsCorpusExhaustivity::test_every_required_tag_has_a_focused_entry": 0.2063,
"tests/unit/pipelex/test_extras/test_mthds_corpus_exhaustivity.py::TestMthdsCorpusExhaustivity::test_every_tag_an_entry_covers_exists_in_the_vocabulary": 0.026,
+ "tests/unit/pipelex/test_extras/test_mthds_corpus_exhaustivity.py::TestMthdsCorpusExhaustivity::test_no_valid_entry_claims_an_error_tag": 0.2142,
"tests/unit/pipelex/test_extras/test_mthds_corpus_loader.py::TestMthdsCorpusLoader::test_entries_are_yielded_in_name_order": 0.0043,
"tests/unit/pipelex/test_extras/test_mthds_corpus_loader.py::TestMthdsCorpusLoader::test_entry_names_are_unique": 0.0031,
"tests/unit/pipelex/test_extras/test_mthds_corpus_loader.py::TestMthdsCorpusLoader::test_every_entry_loads_and_resolves_its_bundle": 0.0033,
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fb67478e5..6c0fc0206 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,21 +1,24 @@
# Changelog
-## [Unreleased]
+## [v0.49.0] - 2026-08-20
### Added
-- **The corpus's invalid axis: an `error.*` tag namespace and the entries that cover it.** The MTHDS Test Corpus covered the valid language surface; the faults it can report were untagged and unexercised. `vocabulary.toml` now carries an `error.*` namespace generated from `VALIDATION_ERROR_TYPES`, and the corpus carries a focused invalid entry for every tag in it that a `.mthds` bundle can actually produce — each one authored to trigger exactly one error, and gated on doing so. The namespace needed no rule of its own despite its registry mixing two spellings: the existing normalization leaves an already-snake_case stage code untouched and turns `DryRunError` into `error.dry_run_error` exactly as it turns `YesNo` into `native.yes_no`. Five codes are excluded, each with the measurement behind it rather than an argument from the call graph — `circular_dependency_error` and `unknown_concept` are unreachable through bundle validation (the first is raised only by the builder's spec-to-blueprint conversion, the second is shadowed by the concept-reference resolution that reports the same fault as `unresolved_concept`), `optional_force_redundant` is advisory-only and rides the `warnings` array, and the two `unknown_*` fallbacks name the absence of a diagnosis rather than a language fault.
-- **The exhaustivity gate now requires an invalid entry to agree with itself.** Such an entry states its fault twice — as `expected_error`, the wire string, and as an `error.*` tag in `covers`, the normalized form — and nothing checked that the two matched, so an entry could advertise coverage of a fault it does not produce. The check joins through the vocabulary's own `code` field rather than re-normalizing, so it carries no second copy of the normalization rule. The same claim is gated from the other side too: a valid entry may not carry an `error.*` tag, since its bundle produces no diagnostic and the exhaustivity arm would otherwise count a claim nothing honours.
-- **The `error_type` values a validation verdict can carry are now an enumerable, closed registry**: a `.mthds` bundle that fails validation reports each fault under an `error_type`, and until now there was no way to ask the runtime which faults exist. The values were reachable only by reading raise sites, and the only curated list of them lived outside this repo, in a hand-maintained conformance suite that could silently fall behind. `pipelex/validation_error_types.py` now holds the vocabulary in full and enumerates it as `VALIDATION_ERROR_TYPES`, so a consumer building coverage over the language surface — a test corpus, a client mapping faults onto its own UI — reads the registry instead of collecting strings from whichever diagnostics it happened to have seen. It is a **union of the enums the runtime already raises**, never a second list beside them: the two stage vocabularies plus a new `ValidationResidualErrorType` naming the one residual channel that had no enum of its own and rode an inline string. A member added to any of them is in the registry the moment it is declared. `ValidationErrorItem.error_type` is typed against their union, which is what makes the registry closed rather than merely documented — an unregistered string can no longer be constructed or parsed onto an item — and which publishes the vocabulary into the OpenAPI schema served for `/validate`, where the field was previously an open `string`. **No wire value changed**, including the dry-run residual's `DryRunError`: it keeps the exception-class spelling it has always had, because normalizing it would break every consumer that pins the string and would buy nothing an enumeration does not already give. Membership means a value is reachable on the wire, not that it is worth exercising — the advisory-only warning type and the two `unknown_*` fallbacks are in the registry and a coverage consumer excludes them on its own side, with a reason, rather than pruning the runtime's truth.
+- **Closed registry for validation error types**: `VALIDATION_ERROR_TYPES`, in the new `pipelex/validation_error_types.py`, is an enumerable, closed registry of every `error_type` a validation verdict can carry. It is a union of the enums the runtime already raises — `PipeValidationErrorType`, `PipeFactoryErrorType`, and a new `ValidationResidualErrorType` naming the one residual channel that had no enum of its own — so a member added to any of them is in the registry the moment it is declared. A consumer building coverage over the language surface now reads the registry instead of collecting strings from whichever diagnostics it happened to have seen. No wire value changed.
+- **The corpus's invalid axis**: the MTHDS Test Corpus now carries an `error.*` tag namespace generated from `VALIDATION_ERROR_TYPES`, plus a focused invalid entry for every tag in it that a `.mthds` bundle can actually produce — each authored to trigger exactly one error, and gated on doing so. Five codes are excluded, each with the measurement behind it: `circular_dependency_error` and `unknown_concept` are unreachable through bundle validation, `optional_force_redundant` is advisory-only and rides the `warnings` array, and the two `unknown_*` fallbacks name the absence of a diagnosis rather than a language fault.
+- **The exhaustivity gate now requires an invalid entry to agree with itself**: such an entry states its fault twice — as `expected_error`, the wire string, and as an `error.*` tag in `covers`, the normalized form — and nothing checked that the two matched. The check joins through the vocabulary's own `code` field rather than re-normalizing, so it carries no second copy of the normalization rule. A valid entry may no longer carry an `error.*` tag, since its bundle produces no diagnostic for the exhaustivity arm to count.
+- **Validation parity test**: `test_validate_bundle_entry_shape_parity.py` validates the same bundle through both entry shapes — in-memory contents and a library directory — and requires the two to produce identical structured diagnostics.
### Fixed
-- **The same bundle produced different diagnostics depending on how it reached the validator**, and the library-directory route — the one the CLI and every local tool take — was the lossy one. Validating in-memory contents (what the HTTP `/validate` layer does) reported a pipe or concept fault as a categorized item with its `error_type` and locators; validating the identical bundle from a file resolved against a library directory reported one untyped residual carrying only a message. Two arms in `LibraryManager._load_mthds_files_into_library` were destroying the structured data on the way out: a pydantic `ValidationError` was rewrapped as a bare `LibraryError`, which routes to the error cascade's structured-forwarding arm rather than its categorizing arm, so nothing ever categorized it; and a `ConceptLibraryError` was re-raised message-only, dropping the per-reference items it now carries. In practice `unresolved_concept`, `optional_input_unguarded` and `optional_output_required` were simply unreachable from a file on disk. Both arms now preserve what they were discarding, and a new parity test validates the same bundle through both entry shapes and requires the two to agree.
+- **The same bundle produced different diagnostics depending on how it reached the validator**, and the library-directory route — the one the CLI and every local tool take — was the lossy one. Two arms in `LibraryManager._load_mthds_files_into_library` destroyed the structured data on the way out: a pydantic `ValidationError` was rewrapped as a bare `LibraryError`, which routes to the error cascade's structured-forwarding arm rather than its categorizing arm; and a `ConceptLibraryError` was re-raised message-only, dropping the per-reference items it now carries. In practice `unresolved_concept`, `optional_input_unguarded` and `optional_output_required` were simply unreachable from a file on disk. Both arms now preserve what they were discarding.
### Changed
-- **Two test fixtures were naming faults that do not exist**, and typing `error_type` against the registry is what surfaced them: one item claimed `MISSING_CONCEPT` — a code no enum has ever defined — and others used member names (`INADEQUATE_OUTPUT_CONCEPT`) where the wire carries values (`inadequate_output_concept`). Every one of them was accepted silently while the field was an open string, so the tests asserted on renderings of a fault the runtime cannot produce. They now name registry members.
-- **The two stage error-type enums moved to `pipelex/validation_error_types.py`** from `pipelex/core/pipes/exceptions.py`, where the exceptions that raise them import them back. The vocabulary is a wire contract rather than pipe machinery, and it has to sit below `base_exceptions` for the wire item to be typed against it at all — the same low-level placement, for the same reason, as `pipelex/suggested_fix.py`.
+- **`ValidationErrorItem.error_type` is typed against the closed registry union** instead of an open string (breaking). This is what makes the registry closed rather than merely documented — an unregistered string can no longer be constructed or parsed onto an item — and it publishes the exact vocabulary into the OpenAPI schema served for `/validate`, where the field was previously an open `string`. As part of this, `PipeValidationErrorType` and `PipeFactoryErrorType` moved from `pipelex/core/pipes/exceptions.py` to `pipelex/validation_error_types.py`: the vocabulary is a wire contract rather than pipe machinery, and it has to sit below `base_exceptions` for the wire item to be typed against it at all.
+- **Two test fixtures were naming faults that do not exist**, and typing `error_type` against the registry is what surfaced them: one claimed `MISSING_CONCEPT`, a code no enum has ever defined, and others used member names (`INADEQUATE_OUTPUT_CONCEPT`) where the wire carries values (`inadequate_output_concept`). Each was accepted silently while the field was an open string. They now name registry members.
+- **The corpus's `invalid_*` entries are excluded from `plxt` linting and formatting** in `.pipelex/plxt.toml`: their structural faults are deliberate, and what guards them instead is strictly stronger — the corpus's entry-validation gate runs the real validation engine over every entry in CI, and is red both when an invalid entry fails differently and when it accidentally validates.
+- **Documentation**: `docs/under-the-hood/error-model.md` now describes the closed `error_type` registry, and `docs/contribute/mthds-test-corpus.md` explains the rules for authoring an invalid corpus entry.
## [v0.48.0] - 2026-08-20
diff --git a/pyproject.toml b/pyproject.toml
index 74e796d1f..1f078af0d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "pipelex"
-version = "0.48.0"
+version = "0.49.0"
description = "Execute composable AI methods declared in the MTHDS open standard"
authors = [{ name = "Evotis S.A.S.", email = "[email protected]" }]
maintainers = [{ name = "Pipelex staff", email = "[email protected]" }]
diff --git a/uv.lock b/uv.lock
index b8c03e37b..a2f12f3f8 100644
--- a/uv.lock
+++ b/uv.lock
@@ -3303,7 +3303,7 @@ wheels = [
[[package]]
name = "pipelex"
-version = "0.48.0"
+version = "0.49.0"
source = { editable = "." }
dependencies = [
{ name = "aiofiles" },