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.53.0
Louis Choquelbb2b46f480b8
diff --git a/.badges/tests.json b/.badges/tests.jsonindex 90d18bcf9..a6be550d4 100644--- a/.badges/tests.json+++ b/.badges/tests.json@@ -1,7 +1,7 @@{"schemaVersion": 1,"label": "tests",- "message": "10895",+ "message": "10952","color": "blue","cacheSeconds": 300}diff --git a/.test_durations b/.test_durationsindex f0ccf54aa..f8cb25602 100644--- a/.test_durations+++ b/.test_durations@@ -197,6 +197,17 @@"tests/integration/pipelex/cli/commands/init/test_cache_priming.py::TestCachePriming::test_priming_reads_backends_toml_from_target_dir": 0.1575,"tests/integration/pipelex/cli/commands/init/test_cache_priming.py::TestCachePriming::test_priming_skips_when_target_dir_says_gateway_disabled": 1.1641,"tests/integration/pipelex/cli/commands/test_build_runner_flow.py::TestBuildRunnerFlow::test_runner_and_structures_projection_agree_on_names": 2.3521,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_agent_cli_bundle_envelope_carries_all_three_families": 0.6051,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_agent_cli_markdown_lists_all_three_families_in_the_same_order": 1.949,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_agent_cli_markdown_renders_the_warning_under_its_heading": 1.5342,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_agent_cli_validate_all_warns_on_the_main_pipe": 1.5466,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_agent_cli_validate_bundle_envelope": 0.2297,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_bare_cli_bundle_echo_carries_all_three_families": 0.4582,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_bare_cli_bundle_echo_survives_the_signature_gate": 1.5295,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_bare_cli_validate_all_echo_carries_the_entry_pipe_lint": 0.7017,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_bare_cli_validate_all_echo_survives_the_signature_gate": 0.1619,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_builder_bundle_file_envelope_carries_all_three_families": 0.8479,+ "tests/integration/pipelex/cli/test_advisory_warning_channels.py::TestAdvisoryWarningChannels::test_builder_validate_bundle_content_twin": 0.3415,"tests/integration/pipelex/cli/test_agent_fix_bundle.py::TestAgentFixBundle::test_fixable_bundle_exits_zero_and_mutates_file": 2.9376,"tests/integration/pipelex/cli/test_agent_fix_bundle.py::TestAgentFixBundle::test_select_filter_is_honored_end_to_end": 0.3287,"tests/integration/pipelex/cli/test_agent_fix_bundle.py::TestAgentFixBundle::test_signature_only_bundle_exits_one_after_success_payload": 0.381,@@ -610,6 +621,8 @@"tests/integration/pipelex/pipeline/test_input_form.py::TestBuildInputForm::test_object_fields_carry_authored_facts": 0.7764,"tests/integration/pipelex/pipeline/test_input_form.py::TestBuildInputForm::test_presence_required_and_gating_markers": 0.8272,"tests/integration/pipelex/pipeline/test_input_form.py::TestBuildInputForm::test_wire_dump_has_no_null_slots": 0.798,+ "tests/integration/pipelex/pipeline/test_input_form.py::TestKindAssignmentTable::test_a_field_less_class_is_an_object_with_no_fields": 1.6076,+ "tests/integration/pipelex/pipeline/test_input_form.py::TestKindAssignmentTable::test_an_authored_but_empty_structure_table_is_an_object_with_no_fields": 0.591,"tests/integration/pipelex/pipeline/test_input_form.py::TestKindAssignmentTable::test_custom_class_reflects_to_object_with_constraints": 0.2528,"tests/integration/pipelex/pipeline/test_input_form.py::TestKindAssignmentTable::test_fixed_count_of_one_is_a_single_node": 0.4863,"tests/integration/pipelex/pipeline/test_input_form.py::TestKindAssignmentTable::test_remaining_natives_complete_the_table": 0.2547,@@ -690,6 +703,15 @@"tests/integration/pipelex/pipeline/test_strip_namespace_enrichment.py::TestStripNamespaceEnrichment::test_unstrippable_syntax_errors_are_not_enriched[\\ndomain = \"nsfix_bad\"\\nmain_pipe = \"run_seq\"\\n\\n[pipe.\"nsfix_bad.Bad-Code\"]\\ntype = \"PipeLLM\"\\ndescription = \"Bad bare tail.\"\\noutput = \"Text\"\\nprompt = \"Hello\"\\n\\n[pipe.run_seq]\\ntype = \"PipeSequence\"\\ndescription = \"Run it.\"\\noutput = \"Text\"\\nsteps = [\\n { pipe = \"run_seq\", result = \"greeting\" },\\n]\\n]": 0.4023,"tests/integration/pipelex/pipeline/test_strip_namespace_enrichment.py::TestStripNamespaceEnrichment::test_unstrippable_syntax_errors_are_not_enriched[\\ndomain = \"nsfix_coll\"\\nmain_pipe = \"hello\"\\n\\n[pipe.hello]\\ntype = \"PipeLLM\"\\ndescription = \"Bare hello.\"\\noutput = \"Text\"\\nprompt = \"Bare\"\\n\\n[pipe.\"nsfix_coll.hello\"]\\ntype = \"PipeLLM\"\\ndescription = \"Dotted hello.\"\\noutput = \"Text\"\\nprompt = \"Dotted\"\\n]": 0.1189,"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_vacuous_presence_lint.py::TestVacuousPresenceLint::test_a_bundle_with_no_main_pipe_is_not_linted": 0.4701,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_a_class_backed_concept_with_all_defaulted_fields_warns": 0.3754,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_a_field_less_class_backed_concept_warns_with_the_field_less_wording": 0.4587,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_an_empty_structure_table_warns_with_the_field_less_wording": 1.5989,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_an_optional_slot_is_silent": 1.5547,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_entry_pipe_warns_and_the_report_stays_valid_and_runnable": 0.7313,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_one_required_field_silences_the_lint": 0.4393,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_the_hint_lint_still_rides_beside_it": 0.3806,+ "tests/integration/pipelex/pipeline/test_vacuous_presence_lint.py::TestVacuousPresenceLint::test_the_same_shape_on_a_non_entry_pipe_is_silent": 0.7286,"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,@@ -5756,6 +5778,7 @@"tests/unit/pipelex/errors/test_validation_error_types.py::TestValidationErrorTypeRegistry::test_every_registered_type_is_accepted_by_its_wire_value[hint_unknown_key]": 1.3897,"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_presence_vacuous]": 1.3328,"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,@@ -7887,19 +7910,26 @@"tests/unit/pipelex/pipeline/test_direct_bundle_validator.py::TestDirectBundleValidator::test_other_errors_propagate_as_no_verdict_faults": 0.0888,"tests/unit/pipelex/pipeline/test_direct_bundle_validator.py::TestDirectBundleValidator::test_valid_sweep_is_returned_as_the_valid_arm": 0.8776,"tests/unit/pipelex/pipeline/test_direct_bundle_validator.py::TestDirectBundleValidator::test_validate_bundle_error_becomes_the_invalid_arm": 0.0032,+ "tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_a_long_authored_intent_value_is_elided_in_the_message": 0.0205,+ "tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_a_long_authored_key_is_elided_in_the_message": 1.5594,+ "tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_a_token_at_the_length_limit_is_quoted_whole": 0.2018,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_choice_field_is_not_a_text_site": 0.0009,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_class_backed_native_number_concept_takes_number_intents": 0.001,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_class_backed_native_text_concept_takes_text_intents": 0.0007,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_class_backed_project_class_is_not_a_hint_site": 0.0168,+ "tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_exactly_the_cap_reports_every_key_with_no_tail": 0.1872,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_inapplicable_intent_warns_on_number_field_with_text_word": 0.0004,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_inapplicable_intent_warns_on_slot_with_attribution": 0.0023,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_inapplicable_intent_warns_on_structured_concept": 1.4078,+ "tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_the_cap_is_per_site_not_per_crate": 0.0137,+ "tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_undefined_keys_beyond_the_cap_collapse_into_one_tail": 0.1932,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_unknown_hint_key_warns_with_concept_attribution": 0.2259,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintFindings::test_unknown_intent_word_warns": 0.0008,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintOrdering::test_findings_are_deterministically_ordered": 0.0138,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintSilence::test_applicable_hints_produce_no_warning": 0.0006,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintSilence::test_hint_free_crate_produces_no_warning": 0.0004,"tests/unit/pipelex/pipeline/test_hint_warnings.py::TestHintLintSilence::test_warned_content_stays_in_the_crate": 0.0007,+ "tests/unit/pipelex/pipeline/test_input_form_deriver.py::TestInputFormDeriverEscapeHatches::test_chain_ending_at_a_base_absent_from_the_crate_is_unknown": 0.2013,"tests/unit/pipelex/pipeline/test_input_form_deriver.py::TestInputFormDeriverEscapeHatches::test_concept_absent_from_the_crate_is_unknown_without_a_class": 0.0187,"tests/unit/pipelex/pipeline/test_input_form_deriver.py::TestInputFormDeriverEscapeHatches::test_cycle_guard_emits_unknown_on_revisit": 0.1974,"tests/unit/pipelex/pipeline/test_input_form_deriver.py::TestInputFormDeriverEscapeHatches::test_indirect_cycle_is_cut_at_the_revisit": 0.0008,@@ -7931,6 +7961,8 @@"tests/unit/pipelex/pipeline/test_input_normalizer.py::TestInputNormalizerUrlGuards::test_directory_path_raises_input_error": 0.0049,"tests/unit/pipelex/pipeline/test_input_normalizer.py::TestInputNormalizerUrlGuards::test_missing_file_raises_input_error": 0.1386,"tests/unit/pipelex/pipeline/test_load_libraries_and_activate.py::TestLoadLibrariesAndActivate::test_rejects_bare_string": 0.8943,+ "tests/unit/pipelex/pipeline/test_optionality_warnings.py::TestOptionalityWarningLocator::test_a_hierarchical_domain_keeps_its_full_path_in_the_locator": 0.0153,+ "tests/unit/pipelex/pipeline/test_optionality_warnings.py::TestOptionalityWarningLocator::test_a_single_segment_domain_splits_at_its_only_dot": 1.3934,"tests/unit/pipelex/pipeline/test_pipeline_manager.py::TestPipelineManagerRemoval::test_concurrent_duplicate_still_raises": 0.1622,"tests/unit/pipelex/pipeline/test_pipeline_manager.py::TestPipelineManagerRemoval::test_remove_is_tolerant_of_absent_key": 0.0009,"tests/unit/pipelex/pipeline/test_pipeline_manager.py::TestPipelineManagerRemoval::test_remove_only_targets_the_given_run": 0.1118,@@ -7955,6 +7987,32 @@"tests/unit/pipelex/pipeline/test_select_primary_blueprint.py::TestSelectPrimaryBlueprint::test_first_declaring_wins_over_earlier_non_declaring": 0.001,"tests/unit/pipelex/pipeline/test_select_primary_blueprint.py::TestSelectPrimaryBlueprint::test_multiple_declaring_first_wins": 0.0034,"tests/unit/pipelex/pipeline/test_select_primary_blueprint.py::TestSelectPrimaryBlueprint::test_none_declaring_selects_first_with_no_ref": 0.8941,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_a_concept_less_object_node_is_silent": 0.0037,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_a_hierarchical_domain_keeps_its_full_path_in_the_locator": 0.0004,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_a_non_entry_pipe_with_the_warning_shape_is_silent": 0.0003,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_a_non_gating_object_slot_is_silent_even_when_required": 0.0002,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_a_repeated_entry_ref_warns_once": 0.0155,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_all_optional_object_warns": 0.0008,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_an_entry_ref_absent_from_the_input_form_is_silent": 1.3207,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_field_less_object_warns_with_the_variant_wording": 0.0003,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_fixed_count_list_is_silent": 1.3061,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_force_input_warns_and_names_the_marker": 0.0008,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_item_shape_carries_the_pipe_locator_and_no_concept_code": 0.0003,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_no_entry_pipes_means_no_lint": 0.0133,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[boolean]": 1.3987,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[date]": 0.0179,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[document]": 0.0223,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[enum]": 0.2768,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[image]": 1.3216,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[number]": 0.018,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[prose]": 0.0067,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[text]": 0.0037,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_non_object_kinds_are_silent[unknown]": 0.0034,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_one_required_field_is_silent": 1.3018,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_optional_presence_is_silent": 0.0003,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_output_is_by_entry_pipe_ref_then_authored_slot_order": 0.0003,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_plain_input_message_names_the_absent_marker_and_both_remedies": 1.3265,+ "tests/unit/pipelex/pipeline/test_vacuous_presence_warnings.py::TestVacuousPresenceWarnings::test_variable_multiplicity_list_is_silent": 0.0174,"tests/unit/pipelex/pipeline/test_validate_bundle_error_report.py::TestValidateBundleErrorReport::test_message_only_error_surfaces_a_residual_item": 0.0003,"tests/unit/pipelex/pipeline/test_validate_bundle_error_report.py::TestValidateBundleErrorReport::test_problem_document_carries_validation_errors_with_source": 0.0014,"tests/unit/pipelex/pipeline/test_validate_bundle_error_report.py::TestValidateBundleErrorReport::test_report_keeps_caller_facing_input_classification": 0.0004,diff --git a/CHANGELOG.md b/CHANGELOG.mdindex d86f348ce..6083b3eef 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,20 +1,25 @@# Changelog-## [Unreleased]+## [v0.53.0] - 2026-08-25### Added-- **The vacuous-presence lint (`input_presence_vacuous`)**: A method input declared without `?` says the caller must supply it, but when the concept behind it declares no required field the empty object already satisfies the declaration — nothing is actually demanded, and a form, an API client or a person filling it in has no way to tell what to put there. Validation now names that on the report's advisory `warnings` array, so the bundle stays valid and the verdict never moves. The message states both remedies: mark the input optional if the method can run without it, or give the concept a required field. It is scoped to **entry pipes** — the bundle's declared `main_pipe`, where a method meets its caller — because on an inner pipe the slot is fed by dataflow and an all-optional structure is a legitimate producer shape. The lint reads the input-form descriptor, so class-backed concepts whose pydantic fields all carry defaults are judged exactly as authored all-optional structures are. See [Understanding optionality](building-methods/pipes/understanding-optionality.md) and [Inline structures](building-methods/concepts/inline-structures.md).+- **Vacuous-presence lint (`input_presence_vacuous`)**: New advisory warning that fires when a required method input (declared without `?`) points to a concept with no required fields, since an empty object `{}` already satisfies it. Scoped strictly to entry pipes (the bundle's declared `main_pipe`), the message suggests either marking the input optional (`?`) or adding a required field to the concept. See [Understanding optionality](building-methods/pipes/understanding-optionality.md) and [Inline structures](building-methods/concepts/inline-structures.md).+- **Unified advisory-warnings module** (`pipelex/pipeline/advisory_warnings.py`): A single composition point that assembles all advisory warnings (optionality, vacuous-presence, and intent-hints) in a fixed, deterministic order.+- **Corpus vocabulary exclusion**: Added the `input_presence_vacuous` exclusion to the corpus vocabulary generator (`generate_corpus_vocabulary_cmd.py`).+- **Documentation**: Updated the user guides ([Inline structures](building-methods/concepts/inline-structures.md), [Understanding optionality](building-methods/pipes/understanding-optionality.md), [validate](tools/cli/validate.md)) to cover the new lint, its remedies, and the unified warning channels.### Changed-- **Every whole-bundle validate channel now carries the same advisory warnings**: The `warnings` array used to be assembled site by site, and the sites disagreed — the protocol validation report carried the optionality and intent-hint lints, while the agent CLI, the builder operations and the bare CLI each carried the optionality lint alone, so which advisories an author saw depended on which command they typed. One composition point now builds all three families in one fixed order and every whole-bundle channel calls it — the protocol report, the agent CLI, the builder's per-bundle operations, and the bare CLI's `validate bundle` and `validate --all` — which brings the intent-hint lints to the CLI and builder surfaces for the first time. Two surfaces stay out and say so: single-pipe `validate <PIPE_CODE>`, which makes no bundle-wide claim, and the builder's `validate_all`, which carries no `warnings` key at all. Riding along is the bound those lints needed before reaching a channel invoked casually: a site naming many undefined hint keys reports the first few and then how many more there were, and a long authored key or value is elided in the message rather than interpolated whole. Breaking: `LibraryManagerAbstract` gained an abstract `get_accumulated_blueprints`, which the collector reads to find the entry pipes, so an alternative manager injected through `Pipelex.setup(library_manager=...)` implements it or fails loudly at construction — the same rule the report's shared assembly follows, and for the same reason: a silent `[]` would report zero entry pipes and look clean.+- **Consistent warnings across all channels**: Every whole-bundle validate channel (protocol report, agent CLI, builder operations, and the bare CLI's `validate bundle` and `validate --all`) now carries the exact same set of advisory warnings. Previously, channels showed different subsets — intent-hints were missing from the CLI, for instance. To keep output manageable, intent-hint findings are capped per site (five before collapsing into an "...and N more" message) and long authored tokens are elided at sixty characters.+- **Library manager interface (Breaking)**: `LibraryManagerAbstract` gained a new abstract method `get_accumulated_blueprints()`, which the collector reads to find the entry pipes. Any custom library manager injected via `Pipelex.setup(library_manager=...)` must implement it or fail loudly at construction.### Fixed-- **An empty `[concept.X.structure]` table is no longer described as prose**: The input-form deriver decided a concept was structured by testing its merged structure table for *truthiness*, while the engine's own `ConceptFactory` branches on `structure is not None`. A concept authoring an empty structure table — legal MTHDS, backed at run time by a field-less structured model whose schema is `{"type": "object", "properties": {}}` — therefore fell through to the prose branch, and the descriptor claimed `kind: "prose"` with a `refines` link to `native.Text` that nobody authored, contradicting the schema sitting beside it. The deriver now makes the engine's distinction, so such a slot is an `object` with an empty `fields` list; a concept refining an empty-structure base is decided by the dict one link up the chain. This also makes the vacuous-presence lint's field-less wording reachable from a real bundle rather than only from a hand-built descriptor.-- **The bare CLI's `validate bundle` no longer swallows its advisory warnings behind the signature gate**: The strict pending-signature gate raised `typer.Exit(1)` before the advisory echo ran, so a bundle holding any unimplemented `PipeSignature` placeholder printed none of its warnings — and a half-implemented method is exactly the state an author is in while building. The echo now runs before the gate, the same ordering `validate --all` has always used and states in its own comment.-- **A field-less structure class is described as an empty object, not as `unknown`**: `reflect_structure_class` answers `None` for two different situations — a registered class declaring no field, and a field whose annotation it could not map — and the input-form deriver treated both as opaque, reporting `kind: "unknown"`. Zero fields is a faithful reading of that class rather than a failure to read it, so a class-backed concept whose class declares nothing is now an `object` with an empty `fields` list, exactly like the authored empty structure table it mirrors; a genuinely unmappable annotation still reports `unknown`. The shared reflection helper keeps its `None`, because its other consumer — the native consistency probe — reads that as "structureless by design".+- **Bare CLI warning visibility**: The bare CLI's `validate bundle` command now prints its advisory warnings before the strict pending-signature gate exits. Previously, a bundle with an unimplemented placeholder would exit non-zero and swallow the warnings — which is exactly the state an author is in while building a method.+- **Empty structure table parsing**: An authored but empty `[concept.X.structure]` table is now correctly parsed as an `object` with an empty `fields` list, instead of falling through a truthiness check and being described as `prose` refining `native.Text`.+- **Field-less structure class reflection**: A registered Python class declaring no fields is now reflected as an empty object rather than `unknown`. Genuinely unmappable annotations still correctly report as `unknown`.+- **Domain splitting in locators**: Hierarchical domains such as `legal.contracts` are now split at the last dot rather than the first when building advisory-warning locators.## [v0.52.0] - 2026-08-24diff --git a/pyproject.toml b/pyproject.tomlindex e85d30d53..9b222d925 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -1,6 +1,6 @@[project]name = "pipelex"-version = "0.52.0"+version = "0.53.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.lockindex c3daf522d..ff35ceb03 100644--- a/uv.lock+++ b/uv.lock@@ -3303,7 +3303,7 @@ wheels = [[[package]]name = "pipelex"-version = "0.52.0"+version = "0.53.0"source = { editable = "." }dependencies = [{ name = "aiofiles" },