modwire 11.0.3__tar.gz → 12.0.0__tar.gz

{modwire-11.0.3 → modwire-12.0.0}/.dev/modwire.egg-info/SOURCES.txt

@@ -13,6 +13,12 @@ uv.lock
 scripts/check_extractors.py
 scripts/generate_docs.py
 scripts/verify_consumer.py
+scripts/benchmarks/cache/__init__.py
+scripts/benchmarks/cache/benchmark_process_timeout.py
+scripts/benchmarks/cache/run.py
+scripts/benchmarks/report/__init__.py
+scripts/benchmarks/report/benchmark_process_timeout.py
+scripts/benchmarks/report/run.py
 src/modwire/__init__.py
 src/modwire/__main__.py
 src/modwire/application.py
@@ -24,10 +30,12 @@ src/modwire/architecture/boundaries/__init__.py
 src/modwire/architecture/boundaries/application.py
 src/modwire/architecture/boundaries/domain.py
 src/modwire/architecture/boundaries/models/__init__.py
+src/modwire/architecture/boundaries/models/architecture_error.py
 src/modwire/architecture/boundaries/models/edge_rule_violation.py
 src/modwire/architecture/boundaries/models/flow_report.py
 src/modwire/architecture/boundaries/models/flow_violation.py
 src/modwire/architecture/boundaries/models/types.py
+src/modwire/architecture/boundaries/models/unknown_flow_analyzer_error.py
 src/modwire/architecture/boundaries/services/__init__.py
 src/modwire/architecture/boundaries/services/backward_flow_analyzer.py
 src/modwire/architecture/boundaries/services/boundaries_flow_analyzer.py
@@ -115,11 +123,14 @@ src/modwire/cli/cache/__init__.py
 src/modwire/cli/cache/application.py
 src/modwire/cli/cache/domain.py
 src/modwire/cli/cache/models/__init__.py
+src/modwire/cli/cache/models/cache_access_error.py
 src/modwire/cli/cache/models/cache_entry.py
+src/modwire/cli/cache/models/cache_error.py
 src/modwire/cli/cache/models/cache_key.py
 src/modwire/cli/cache/models/cache_kind.py
 src/modwire/cli/cache/models/cache_options.py
 src/modwire/cli/cache/models/cache_outcome.py
+src/modwire/cli/cache/models/cache_ownership_error.py
 src/modwire/cli/cache/models/cache_plan.py
 src/modwire/cli/cache/models/cache_stage.py
 src/modwire/cli/cache/models/cache_storage_state.py
@@ -136,7 +147,9 @@ src/modwire/cli/documentation/services/documentation_generator.py
 src/modwire/cli/initialization/__init__.py
 src/modwire/cli/initialization/application.py
 src/modwire/cli/initialization/models/__init__.py
+src/modwire/cli/initialization/models/initialization_error.py
 src/modwire/cli/initialization/models/initialization_result.py
+src/modwire/cli/initialization/models/invalid_initialization_target_error.py
 src/modwire/cli/initialization/services/__init__.py
 src/modwire/cli/initialization/services/initialization_service.py
 src/modwire/cli/pipeline/__init__.py
@@ -151,10 +164,18 @@ src/modwire/cli/pipeline/models/command_name.py
 src/modwire/cli/pipeline/models/command_request.py
 src/modwire/cli/pipeline/models/extractor_batch_input.py
 src/modwire/cli/pipeline/models/extractor_command_input.py
+src/modwire/cli/pipeline/models/extractor_contract_error.py
+src/modwire/cli/pipeline/models/extractor_contract_violation.py
+src/modwire/cli/pipeline/models/extractor_execution_error.py
+src/modwire/cli/pipeline/models/extractor_resource_error.py
 src/modwire/cli/pipeline/models/extractor_source_input.py
+src/modwire/cli/pipeline/models/extractor_unavailable_error.py
+src/modwire/cli/pipeline/models/invalid_source_root_error.py
 src/modwire/cli/pipeline/models/report_pipeline_context.py
+src/modwire/cli/pipeline/models/source_access_error.py
 src/modwire/cli/pipeline/models/source_entry.py
-src/modwire/cli/pipeline/models/source_inventory.py
+src/modwire/cli/pipeline/models/source_observation.py
+src/modwire/cli/pipeline/models/source_observation_invalidated_error.py
 src/modwire/cli/pipeline/services/__init__.py
 src/modwire/cli/pipeline/services/batch_source_reader.py
 src/modwire/cli/pipeline/services/callables_insight.py
@@ -205,11 +226,16 @@ src/modwire/extraction/extractors/domain.py
 src/modwire/extraction/extractors/models/__init__.py
 src/modwire/extraction/extractors/models/batch_config.py
 src/modwire/extraction/extractors/models/batch_output_format.py
+src/modwire/extraction/extractors/models/duplicate_identity_error.py
+src/modwire/extraction/extractors/models/extraction_error.py
 src/modwire/extraction/extractors/models/extraction_request.py
+src/modwire/extraction/extractors/models/extractor_error.py
 src/modwire/extraction/extractors/models/extractor_resource.py
 src/modwire/extraction/extractors/models/extractor_runtime.py
 src/modwire/extraction/extractors/models/parsed_source_batch.py
 src/modwire/extraction/extractors/models/parsed_source_file.py
+src/modwire/extraction/extractors/models/unsupported_language_error.py
+src/modwire/extraction/extractors/models/unsupported_parser_error.py
 src/modwire/extraction/extractors/php/__init__.py
 src/modwire/extraction/extractors/php/extractor.py
 src/modwire/extraction/extractors/python/__init__.py
@@ -321,6 +347,8 @@ src/modwire/implementation/manifest/contracts/manifest_serializer.py
 src/modwire/implementation/manifest/models/__init__.py
 src/modwire/implementation/manifest/models/implementation_manifest.py
 src/modwire/implementation/manifest/models/implementation_manifest_document.py
+src/modwire/implementation/manifest/models/implementation_manifest_error.py
+src/modwire/implementation/manifest/models/invalid_implementation_manifest_error.py
 src/modwire/implementation/manifest/models/manifest_annotation.py
 src/modwire/implementation/manifest/models/manifest_annotation_role.py
 src/modwire/implementation/manifest/models/manifest_attribute.py
@@ -333,6 +361,7 @@ src/modwire/implementation/manifest/models/manifest_parameter.py
 src/modwire/implementation/manifest/models/manifest_span.py
 src/modwire/implementation/manifest/models/manifest_symbol.py
 src/modwire/implementation/manifest/models/manifest_symbol_kind.py
+src/modwire/implementation/manifest/models/unsupported_manifest_format_error.py
 src/modwire/implementation/manifest/services/__init__.py
 src/modwire/implementation/manifest/services/canonical_json_manifest_serializer.py
 src/modwire/implementation/manifest/services/code_map_manifest_compiler.py
@@ -352,7 +381,6 @@ src/modwire/shared/code/models/dependency_edge_result.py
 src/modwire/shared/code/models/dependency_graph.py
 src/modwire/shared/code/models/dependency_node_result.py
 src/modwire/shared/code/models/digest_algorithm.py
-src/modwire/shared/code/models/duplicate_identity_error.py
 src/modwire/shared/code/models/edge.py
 src/modwire/shared/code/models/extractor_descriptor.py
 src/modwire/shared/code/models/fact_capability.py
@@ -409,6 +437,9 @@ src/modwire/shared/code/services/__init__.py
 src/modwire/shared/code/services/glob_path_matcher.py
 src/modwire/shared/code/services/identity_resolver.py
 src/modwire/shared/code/services/installed_package_version.py
+src/modwire/shared/failures/__init__.py
+src/modwire/shared/failures/models/__init__.py
+src/modwire/shared/failures/models/modwire_error.py
 src/modwire/shared/values/__init__.py
 src/modwire/shared/values/models/__init__.py
 src/modwire/shared/values/models/value_model.py
@@ -416,12 +447,14 @@ tests/__init__.py
 tests/conftest.py
 tests/application/__init__.py
 tests/application/base_test.py
+tests/application/failure_consumer.py
 tests/application/test_01_attacks.py
 tests/application/test_06_happy_path.py
 tests/application/test_07_cache.py
 tests/application/test_08_implementation_manifest.py
 tests/application/test_09_source_manifest_identity.py
 tests/application/test_10_assigned_value_evidence.py
+tests/application/test_11_source_observation.py
 tests/architecture/__init__.py
 tests/architecture/base_test.py
 tests/architecture/boundaries/__init__.py
@@ -440,9 +473,6 @@ tests/architecture/map/__init__.py
 tests/architecture/map/test_02_patterns.py
 tests/architecture/report/__init__.py
 tests/architecture/report/test_02_invariants.py
-tests/architecture/report_benchmark/__init__.py
-tests/architecture/report_benchmark/benchmark_process_timeout.py
-tests/architecture/report_benchmark/run.py
 tests/architecture/shape/__init__.py
 tests/architecture/shape/base_test.py
 tests/architecture/shape/test_01_limits.py
@@ -465,6 +495,7 @@ tests/cli/pipeline/test_03_interruption.py
 tests/cli/pipeline/test_04_command_transport.py
 tests/cli/pipeline/test_05_recovery.py
 tests/cli/pipeline/test_06_happy_path.py
+tests/cli/pipeline/test_07_report_commands.py
 tests/extraction/__init__.py
 tests/extraction/base_test.py
 tests/extraction/big_projects/__init__.py
@@ -473,9 +504,6 @@ tests/extraction/big_projects/projects.json
 tests/extraction/big_projects/resolution_results.json
 tests/extraction/big_projects/results.json
 tests/extraction/big_projects/run.py
-tests/extraction/cache_benchmark/__init__.py
-tests/extraction/cache_benchmark/benchmark_process_timeout.py
-tests/extraction/cache_benchmark/run.py
 tests/extraction/dependency/__init__.py
 tests/extraction/dependency/test_02_invariants.py
 tests/extraction/extractors/__init__.py

{modwire-11.0.3 → modwire-12.0.0}/Makefile

@@ -36,10 +36,10 @@ scan-benchmark:
 	uv run python -m tests.extraction.scan_benchmark.run --root .dev/benchmarks/scan-project --language "$(SCAN_BENCHMARK_LANGUAGE)" --excluded-pattern 'example_excluded/**'
 
 cache-benchmark:
-	uv run python -m tests.extraction.cache_benchmark.run --root "$(CACHE_BENCHMARK_ROOT)" --language "$(CACHE_BENCHMARK_LANGUAGE)" --cache-directory .dev/benchmarks/cache --incremental-source "$(CACHE_BENCHMARK_SOURCE)" --replacement-source "$(CACHE_BENCHMARK_REPLACEMENT)"
+	uv run python -m scripts.benchmarks.cache.run --root "$(CACHE_BENCHMARK_ROOT)" --language "$(CACHE_BENCHMARK_LANGUAGE)" --cache-directory .dev/benchmarks/cache --incremental-source "$(CACHE_BENCHMARK_SOURCE)" --replacement-source "$(CACHE_BENCHMARK_REPLACEMENT)"
 
 report-benchmark:
-	uv run python -m tests.architecture.report_benchmark.run --root "$(REPORT_BENCHMARK_ROOT)" --language "$(REPORT_BENCHMARK_LANGUAGE)" --cache-directory "$(REPORT_BENCHMARK_CACHE)" --cache-namespace "$(REPORT_BENCHMARK_NAMESPACE)"
+	uv run python -m scripts.benchmarks.report.run --root "$(REPORT_BENCHMARK_ROOT)" --language "$(REPORT_BENCHMARK_LANGUAGE)" --cache-directory "$(REPORT_BENCHMARK_CACHE)" --cache-namespace "$(REPORT_BENCHMARK_NAMESPACE)"
 
 docs-check:
 	uv run python scripts/generate_docs.py --check

{modwire-11.0.3 → modwire-12.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modwire
-Version: 11.0.3
+Version: 12.0.0
 Summary: Code extraction, architecture analysis and the Modwire CLI.
 Author: Tomasz Szpak
 License-Expression: MIT
@@ -80,6 +80,10 @@ Return a code map with content-addressed source and complete-source-set reuse.
 
 Return a code map and public outcomes for extraction and complete-map reuse.
 
+### `generate_map_cached_from_observation_with_diagnostics`
+
+Return a cached code map derived from the exact supplied source observation.
+
 ### `generate_queryable_map_cached`
 
 Return a queryable code map with content-addressed persistent reuse.
@@ -88,6 +92,14 @@ Return a queryable code map with content-addressed persistent reuse.
 
 Return a queryable code map and public outcomes for every applicable cache stage.
 
+### `generate_queryable_map_cached_from_observation_with_diagnostics`
+
+Return a queryable cached map derived from the exact supplied source observation.
+
+### `observe_sources`
+
+Observe one complete immutable canonical source inventory without parsing source.
+
 ### `source_manifest_identity`
 
 Observe the current canonical source-manifest identity without parsing source.
@@ -140,7 +152,8 @@ Extraction counts describe current source records. An exact code-map hit
 reports its digest-backed source-set entries as extraction hits without loading
 individual source payloads. Code-map and report counts describe one entry.
 Invalidated entries are also misses. Diagnostics include the configured
-namespace but never cache keys, source identities, or content.
+namespace but never cache keys, source identities, or content. The reuse flag
+states whether the exact supplied source observation drove the cache operation.
 
 ## `CachedResult`
 
@@ -174,6 +187,14 @@ Kinds of class-property assignment evidence published by extractors.
 
 Canonical identity of one observed source manifest.
 
+## `SourceObservation`
+
+Immutable canonical source inventory reusable by identity and cached map operations.
+
+### `identity`
+
+Return the canonical public identity of this observed source manifest.
+
 ## `SourceMemberKind`
 
 Ownership kind for a declared class or type member.
@@ -326,3 +347,103 @@ Declared completeness of an extractor's support for a fact family.
 ## `CapabilityCoverage`
 
 An extractor's explicit support status for one implementation fact family.
+
+## `ModwireError`
+
+Base class for every expected failure exposed by Modwire.
+
+## `ArchitectureError`
+
+Base class for architecture configuration and analysis failures.
+
+## `UnknownFlowAnalyzerError`
+
+Report a configured flow analyzer that is not registered.
+
+## `CacheError`
+
+Base class for persistent-cache ownership and access failures.
+
+## `CacheOwnershipError`
+
+Report a cache path that cannot be safely used by Modwire.
+
+## `CacheAccessError`
+
+Report an operating-system failure while accessing persistent cache state.
+
+## `ExtractionError`
+
+Base class for failures while discovering, extracting, or parsing source code.
+
+## `UnsupportedLanguageError`
+
+Report a language for which no source extractor is registered.
+
+## `UnsupportedParserError`
+
+Report a language for which no in-process source parser is registered.
+
+## `InvalidSourceRootError`
+
+Report a requested source root that is not a directory.
+
+## `SourceAccessError`
+
+Report an operating-system failure while reading a source tree.
+
+## `SourceObservationInvalidatedError`
+
+Report exact source identities that changed after their observation.
+
+## `DuplicateIdentityError`
+
+Report two source files that claim the same extracted identity.
+
+### `as_dict`
+
+Return stable machine-readable evidence for the duplicate identity.
+
+## `ExtractorError`
+
+Base class for failures at a native extractor boundary.
+
+## `ExtractorUnavailableError`
+
+Report a required extractor executable that is unavailable on PATH.
+
+## `ExtractorResourceError`
+
+Report a missing or unreadable packaged extractor resource.
+
+## `ExtractorExecutionError`
+
+Report a native extractor process that exited unsuccessfully.
+
+## `ExtractorContractError`
+
+Report extractor output that violates the registered runtime contract.
+
+## `ExtractorContractViolation`
+
+Identify the extractor contract clause violated by runtime output.
+
+## `ImplementationManifestError`
+
+Base class for implementation-manifest contract failures.
+
+## `UnsupportedManifestFormatError`
+
+Report an implementation-manifest format with no matching serializer.
+
+## `InvalidImplementationManifestError`
+
+Report a manifest document or serializer that violates its declared format contract.
+
+## `InitializationError`
+
+Base class for project initialization failures.
+
+## `InvalidInitializationTargetError`
+
+Report an initialization target outside the accepted project boundary.

{modwire-11.0.3 → modwire-12.0.0}/README.md

@@ -52,6 +52,10 @@ Return a code map with content-addressed source and complete-source-set reuse.
 
 Return a code map and public outcomes for extraction and complete-map reuse.
 
+### `generate_map_cached_from_observation_with_diagnostics`
+
+Return a cached code map derived from the exact supplied source observation.
+
 ### `generate_queryable_map_cached`
 
 Return a queryable code map with content-addressed persistent reuse.
@@ -60,6 +64,14 @@ Return a queryable code map with content-addressed persistent reuse.
 
 Return a queryable code map and public outcomes for every applicable cache stage.
 
+### `generate_queryable_map_cached_from_observation_with_diagnostics`
+
+Return a queryable cached map derived from the exact supplied source observation.
+
+### `observe_sources`
+
+Observe one complete immutable canonical source inventory without parsing source.
+
 ### `source_manifest_identity`
 
 Observe the current canonical source-manifest identity without parsing source.
@@ -112,7 +124,8 @@ Extraction counts describe current source records. An exact code-map hit
 reports its digest-backed source-set entries as extraction hits without loading
 individual source payloads. Code-map and report counts describe one entry.
 Invalidated entries are also misses. Diagnostics include the configured
-namespace but never cache keys, source identities, or content.
+namespace but never cache keys, source identities, or content. The reuse flag
+states whether the exact supplied source observation drove the cache operation.
 
 ## `CachedResult`
 
@@ -146,6 +159,14 @@ Kinds of class-property assignment evidence published by extractors.
 
 Canonical identity of one observed source manifest.
 
+## `SourceObservation`
+
+Immutable canonical source inventory reusable by identity and cached map operations.
+
+### `identity`
+
+Return the canonical public identity of this observed source manifest.
+
 ## `SourceMemberKind`
 
 Ownership kind for a declared class or type member.
@@ -298,3 +319,103 @@ Declared completeness of an extractor's support for a fact family.
 ## `CapabilityCoverage`
 
 An extractor's explicit support status for one implementation fact family.
+
+## `ModwireError`
+
+Base class for every expected failure exposed by Modwire.
+
+## `ArchitectureError`
+
+Base class for architecture configuration and analysis failures.
+
+## `UnknownFlowAnalyzerError`
+
+Report a configured flow analyzer that is not registered.
+
+## `CacheError`
+
+Base class for persistent-cache ownership and access failures.
+
+## `CacheOwnershipError`
+
+Report a cache path that cannot be safely used by Modwire.
+
+## `CacheAccessError`
+
+Report an operating-system failure while accessing persistent cache state.
+
+## `ExtractionError`
+
+Base class for failures while discovering, extracting, or parsing source code.
+
+## `UnsupportedLanguageError`
+
+Report a language for which no source extractor is registered.
+
+## `UnsupportedParserError`
+
+Report a language for which no in-process source parser is registered.
+
+## `InvalidSourceRootError`
+
+Report a requested source root that is not a directory.
+
+## `SourceAccessError`
+
+Report an operating-system failure while reading a source tree.
+
+## `SourceObservationInvalidatedError`
+
+Report exact source identities that changed after their observation.
+
+## `DuplicateIdentityError`
+
+Report two source files that claim the same extracted identity.
+
+### `as_dict`
+
+Return stable machine-readable evidence for the duplicate identity.
+
+## `ExtractorError`
+
+Base class for failures at a native extractor boundary.
+
+## `ExtractorUnavailableError`
+
+Report a required extractor executable that is unavailable on PATH.
+
+## `ExtractorResourceError`
+
+Report a missing or unreadable packaged extractor resource.
+
+## `ExtractorExecutionError`
+
+Report a native extractor process that exited unsuccessfully.
+
+## `ExtractorContractError`
+
+Report extractor output that violates the registered runtime contract.
+
+## `ExtractorContractViolation`
+
+Identify the extractor contract clause violated by runtime output.
+
+## `ImplementationManifestError`
+
+Base class for implementation-manifest contract failures.
+
+## `UnsupportedManifestFormatError`
+
+Report an implementation-manifest format with no matching serializer.
+
+## `InvalidImplementationManifestError`
+
+Report a manifest document or serializer that violates its declared format contract.
+
+## `InitializationError`
+
+Base class for project initialization failures.
+
+## `InvalidInitializationTargetError`
+
+Report an initialization target outside the accepted project boundary.

{modwire-11.0.3/tests/extraction/cache_benchmark → modwire-12.0.0/scripts/benchmarks/cache}/run.py

@@ -132,7 +132,10 @@ class CacheBenchmark:
 
                 total_started = time.perf_counter()
                 cold_plan, measurement["cold_inventory"] = self._phase(
-                    repetition, "cold", "inventory", lambda: application.cli.prepare_cache(request, policy)
+                    repetition,
+                    "cold",
+                    "inventory",
+                    lambda: application.cli.prepare_cache(application.cli.observe(request, policy)),
                 )
                 cold_cached_map, measurement["cold_code_map_loading"] = self._phase(
                     repetition,
@@ -146,7 +149,7 @@ class CacheBenchmark:
                     repetition,
                     "cold",
                     "source_loading",
-                    lambda: application.cli.cached_sources(request, cold_plan, options),
+                    lambda: application.cli.cached_sources(cold_plan, options),
                 )
                 _, measurement["cold_source_set_maintenance"] = self._phase(
                     repetition,
@@ -177,7 +180,10 @@ class CacheBenchmark:
 
                 total_started = time.perf_counter()
                 warm_plan, measurement["warm_inventory"] = self._phase(
-                    repetition, "warm", "inventory", lambda: application.cli.prepare_cache(request, policy)
+                    repetition,
+                    "warm",
+                    "inventory",
+                    lambda: application.cli.prepare_cache(application.cli.observe(request, policy)),
                 )
                 warm_cached_map, measurement["warm_code_map_loading"] = self._phase(
                     repetition,
@@ -206,7 +212,7 @@ class CacheBenchmark:
                     repetition,
                     "incremental",
                     "inventory",
-                    lambda: application.cli.prepare_cache(request, policy),
+                    lambda: application.cli.prepare_cache(application.cli.observe(request, policy)),
                 )
                 incremental_cached_map, measurement["incremental_code_map_loading"] = self._phase(
                     repetition,
@@ -220,7 +226,7 @@ class CacheBenchmark:
                     repetition,
                     "incremental",
                     "source_loading",
-                    lambda: application.cli.cached_sources(request, incremental_plan, options),
+                    lambda: application.cli.cached_sources(incremental_plan, options),
                 )
                 _, measurement["incremental_source_set_maintenance"] = self._phase(
                     repetition,

{modwire-11.0.3/tests/architecture/report_benchmark → modwire-12.0.0/scripts/benchmarks/report}/run.py

@@ -107,7 +107,7 @@ class ReportBenchmark:
         cleanup_reserve = min(1.0, max_process_seconds * 0.1)
         supervisor_seconds = max_process_seconds - cleanup_reserve
         if Path(sys.argv[0]).resolve() == Path(__file__).resolve():
-            entrypoint = [sys.executable, "-m", "tests.architecture.report_benchmark.run"]
+            entrypoint = [sys.executable, "-m", "scripts.benchmarks.report.run"]
         else:
             entrypoint = [sys.executable, sys.argv[0]]
         command = [*entrypoint, *sys.argv[1:], "--worker"]
@@ -228,7 +228,10 @@ class ReportBenchmark:
             cache_file = self.code_map_cache_file
             if cache_file is None:
                 plan, measurement["inventory"] = self._phase(
-                    repetition, "map", "inventory", lambda: application.cli.prepare_cache(request, policy)
+                    repetition,
+                    "map",
+                    "inventory",
+                    lambda: application.cli.prepare_cache(application.cli.observe(request, policy)),
                 )
                 cached_map, measurement["code_map_loading"] = self._phase(
                     repetition, "map", "code_map_loading", lambda: application.cli.cached_code_map(plan, options)
@@ -240,7 +243,7 @@ class ReportBenchmark:
                         repetition,
                         "map",
                         "extraction_loading",
-                        lambda: application.cli.cached_sources(request, plan, options),
+                        lambda: application.cli.cached_sources(plan, options),
                     )
                     _, measurement["source_set_maintenance"] = self._phase(
                         repetition,