modwire 11.0.2__tar.gz → 11.1.0__tar.gz

{modwire-11.0.2 → modwire-11.1.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
@@ -147,13 +153,14 @@ src/modwire/cli/pipeline/batching/fixed_planner.py
 src/modwire/cli/pipeline/batching/plan.py
 src/modwire/cli/pipeline/batching/planner.py
 src/modwire/cli/pipeline/models/__init__.py
+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_source_input.py
 src/modwire/cli/pipeline/models/report_pipeline_context.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/services/__init__.py
 src/modwire/cli/pipeline/services/batch_source_reader.py
 src/modwire/cli/pipeline/services/callables_insight.py
@@ -180,6 +187,7 @@ src/modwire/cli/resources/application.py
 src/modwire/cli/resources/models/__init__.py
 src/modwire/cli/resources/models/defaults.py
 src/modwire/cli/resources/models/init_asset.py
+src/modwire/cli/resources/models/init_target_base.py
 src/modwire/cli/resources/templates/AGENTS.md
 src/modwire/cli/resources/templates/ARCHITECTURE.md
 src/modwire/cli/resources/templates/INDEX.md
@@ -202,9 +210,9 @@ src/modwire/extraction/extractors/application.py
 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/extraction_request.py
 src/modwire/extraction/extractors/models/extractor_resource.py
-src/modwire/extraction/extractors/models/extractor_resource_set.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
@@ -222,6 +230,7 @@ src/modwire/extraction/extractors/python/observations/function_candidate.py
 src/modwire/extraction/extractors/python/observations/import_candidate.py
 src/modwire/extraction/extractors/python/observations/inheritance_candidate.py
 src/modwire/extraction/extractors/python/observations/property_candidate.py
+src/modwire/extraction/extractors/python/observations/property_scope.py
 src/modwire/extraction/extractors/python/observations/source_context.py
 src/modwire/extraction/extractors/python/observations/source_observation.py
 src/modwire/extraction/extractors/python/observations/value_candidate.py
@@ -273,6 +282,7 @@ src/modwire/extraction/extractors/python/semantics/properties/annotated_instance
 src/modwire/extraction/extractors/python/semantics/properties/assigned_class_rule.py
 src/modwire/extraction/extractors/python/semantics/properties/assigned_instance_rule.py
 src/modwire/extraction/extractors/python/semantics/properties/classifier.py
+src/modwire/extraction/extractors/python/semantics/properties/decorated_method_rule.py
 src/modwire/extraction/extractors/python/source_facts/call_contributor.py
 src/modwire/extraction/extractors/python/source_facts/callable_contributor.py
 src/modwire/extraction/extractors/python/source_facts/class_contributor.py
@@ -288,6 +298,7 @@ src/modwire/extraction/extractors/python/source_facts/value_contributor.py
 src/modwire/extraction/extractors/python/traversal/context.py
 src/modwire/extraction/extractors/python/traversal/observation_reader.py
 src/modwire/extraction/extractors/python/traversal/ordered_observation_visitor.py
+src/modwire/extraction/extractors/python/traversal/traversal_role.py
 src/modwire/extraction/extractors/resources/__init__.py
 src/modwire/extraction/extractors/resources/php/build.php
 src/modwire/extraction/extractors/resources/php/build.py
@@ -314,18 +325,20 @@ src/modwire/implementation/manifest/contracts/__init__.py
 src/modwire/implementation/manifest/contracts/manifest_compiler.py
 src/modwire/implementation/manifest/contracts/manifest_serializer.py
 src/modwire/implementation/manifest/models/__init__.py
-src/modwire/implementation/manifest/models/digest_algorithm.py
 src/modwire/implementation/manifest/models/implementation_manifest.py
 src/modwire/implementation/manifest/models/implementation_manifest_document.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
 src/modwire/implementation/manifest/models/manifest_callable.py
 src/modwire/implementation/manifest/models/manifest_dependency.py
+src/modwire/implementation/manifest/models/manifest_dependency_target_kind.py
 src/modwire/implementation/manifest/models/manifest_format.py
 src/modwire/implementation/manifest/models/manifest_inheritance.py
 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/services/__init__.py
 src/modwire/implementation/manifest/services/canonical_json_manifest_serializer.py
 src/modwire/implementation/manifest/services/code_map_manifest_compiler.py
@@ -344,13 +357,16 @@ src/modwire/shared/code/models/declaration_identity.py
 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/edge_resolution.py
 src/modwire/shared/code/models/extractor_descriptor.py
 src/modwire/shared/code/models/fact_capability.py
 src/modwire/shared/code/models/identity.py
+src/modwire/shared/code/models/identity_kind.py
+src/modwire/shared/code/models/import_crossing_type.py
 src/modwire/shared/code/models/node.py
+src/modwire/shared/code/models/node_kind.py
 src/modwire/shared/code/models/query_builder.py
 src/modwire/shared/code/models/query_types.py
 src/modwire/shared/code/models/queryable_code_map.py
@@ -361,12 +377,16 @@ src/modwire/shared/code/models/source_artifact.py
 src/modwire/shared/code/models/source_assigned_value.py
 src/modwire/shared/code/models/source_assigned_value_kind.py
 src/modwire/shared/code/models/source_call.py
+src/modwire/shared/code/models/source_call_resolution.py
 src/modwire/shared/code/models/source_callable.py
+src/modwire/shared/code/models/source_callable_kind.py
 src/modwire/shared/code/models/source_callable_symbol.py
 src/modwire/shared/code/models/source_class.py
 src/modwire/shared/code/models/source_class_method.py
 src/modwire/shared/code/models/source_class_property.py
+src/modwire/shared/code/models/source_dependency_resolution.py
 src/modwire/shared/code/models/source_export.py
+src/modwire/shared/code/models/source_export_kind.py
 src/modwire/shared/code/models/source_extraction.py
 src/modwire/shared/code/models/source_file.py
 src/modwire/shared/code/models/source_file_result.py
@@ -380,13 +400,17 @@ src/modwire/shared/code/models/source_manifest.py
 src/modwire/shared/code/models/source_manifest_identity.py
 src/modwire/shared/code/models/source_member_kind.py
 src/modwire/shared/code/models/source_parameter.py
+src/modwire/shared/code/models/source_parameter_kind.py
 src/modwire/shared/code/models/source_relation_kind.py
 src/modwire/shared/code/models/source_signature.py
+src/modwire/shared/code/models/source_signature_kind.py
 src/modwire/shared/code/models/source_symbol.py
 src/modwire/shared/code/models/source_type.py
 src/modwire/shared/code/models/source_value.py
+src/modwire/shared/code/models/source_value_declaration_kind.py
+src/modwire/shared/code/models/source_value_kind.py
 src/modwire/shared/code/models/source_value_scope.py
-src/modwire/shared/code/models/types.py
+src/modwire/shared/code/models/source_visibility.py
 src/modwire/shared/code/services/__init__.py
 src/modwire/shared/code/services/glob_path_matcher.py
 src/modwire/shared/code/services/identity_resolver.py
@@ -404,6 +428,7 @@ 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
@@ -422,9 +447,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
@@ -447,6 +469,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
@@ -455,9 +478,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.2 → modwire-11.1.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.2 → modwire-11.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modwire
-Version: 11.0.2
+Version: 11.1.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.

{modwire-11.0.2 → modwire-11.1.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.

{modwire-11.0.2/tests/extraction/cache_benchmark → modwire-11.1.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.2/tests/architecture/report_benchmark → modwire-11.1.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,

{modwire-11.0.2 → modwire-11.1.0}/src/modwire/application.py

@@ -15,9 +15,9 @@ from .cli.cache.models.cache_outcome import CacheOutcome
 from .cli.cache.models.cache_stage import CacheStage
 from .cli.cache.models.cached_result import CachedResult
 from .cli.facade import CliFacade
+from .cli.pipeline.models.source_observation import SourceObservation
 from .extraction.facade import ExtractionFacade
 from .implementation.facade import ImplementationFacade
-from .implementation.manifest.models.digest_algorithm import DigestAlgorithm
 from .implementation.manifest.models.implementation_manifest import ImplementationManifest
 from .implementation.manifest.models.implementation_manifest_document import ImplementationManifestDocument
 from .implementation.manifest.models.manifest_format import ManifestFormat
@@ -26,6 +26,7 @@ from .shared.code.models.capability_status import CapabilityStatus
 from .shared.code.models.code_map import CodeMap
 from .shared.code.models.declaration_family import DeclarationFamily
 from .shared.code.models.declaration_identity import DeclarationIdentity
+from .shared.code.models.digest_algorithm import DigestAlgorithm
 from .shared.code.models.fact_capability import FactCapability
 from .shared.code.models.queryable_code_map import QueryableCodeMap
 from .shared.code.models.scan_policy import ScanPolicy
@@ -57,6 +58,7 @@ __all__ = [
     "SourceAssignedValueKind",
     "SourceMemberKind",
     "SourceManifestIdentity",
+    "SourceObservation",
     "SourceRelationKind",
 ]
 
@@ -157,8 +159,18 @@ class ModwireApplication:
     ) -> CachedResult[CodeMap]:
         """Return a code map and public outcomes for extraction and complete-map reuse."""
 
-        request = self.extraction.request(language, str(root))
-        plan = self.cli.prepare_cache(request, policy)
+        observation = self.observe_sources(language, root, policy)
+        cached = self.generate_map_cached_from_observation_with_diagnostics(observation, options)
+        outcomes = tuple(outcome.model_copy(update={"source_observation_reused": False}) for outcome in cached.outcomes)
+        return CachedResult(value=cached.value, outcomes=outcomes)
+
+    def generate_map_cached_from_observation_with_diagnostics(
+        self, observation: SourceObservation, options: CacheOptions
+    ) -> CachedResult[CodeMap]:
+        """Return a cached code map derived from the exact supplied source observation."""
+
+        request = observation.request
+        plan = self.cli.prepare_cache(observation)
         cached = self.cli.cached_code_map(plan, options)
         outcome = cached.outcome(CacheStage.CODE_MAP)
         if cached.value is not None:
@@ -171,14 +183,18 @@ class ModwireApplication:
                 ),
             )
         else:
-            sources = self.cli.cached_sources(request, plan, options)
+            sources = self.cli.cached_sources(plan, options)
             self.cli.maintain_source_set(plan, options)
             code_map = self.extraction.generate_map(request, sources.value)
             self.cli.store_code_map(plan, code_map, options)
             outcome = outcome.model_copy(update={"computed": 1, "stored": 1})
             extraction_outcomes = sources.outcomes
         self.cli.maintain_cache(options)
-        return CachedResult(value=code_map, outcomes=(*extraction_outcomes, outcome))
+        outcomes = tuple(
+            cache_outcome.model_copy(update={"source_observation_reused": True})
+            for cache_outcome in (*extraction_outcomes, outcome)
+        )
+        return CachedResult(value=code_map, outcomes=outcomes)
 
     def generate_queryable_map_cached(
         self, language: str, root: str, policy: ScanPolicy, options: CacheOptions
@@ -195,11 +211,24 @@ class ModwireApplication:
         cached = self.generate_map_cached_with_diagnostics(language, root, policy, options)
         return CachedResult(value=QueryableCodeMap(code_map=cached.value), outcomes=cached.outcomes)
 
+    def generate_queryable_map_cached_from_observation_with_diagnostics(
+        self, observation: SourceObservation, options: CacheOptions
+    ) -> CachedResult[QueryableCodeMap]:
+        """Return a queryable cached map derived from the exact supplied source observation."""
+
+        cached = self.generate_map_cached_from_observation_with_diagnostics(observation, options)
+        return CachedResult(value=QueryableCodeMap(code_map=cached.value), outcomes=cached.outcomes)
+
+    def observe_sources(self, language: str, root: str, policy: ScanPolicy) -> SourceObservation:
+        """Observe one complete immutable canonical source inventory without parsing source."""
+
+        request = self.extraction.request(language, str(root))
+        return self.cli.observe(request, policy)
+
     def source_manifest_identity(self, language: str, root: str, policy: ScanPolicy) -> SourceManifestIdentity:
         """Observe the current canonical source-manifest identity without parsing source."""
 
-        request = self.extraction.request(language, str(root))
-        return self.cli.source_manifest_identity(request, policy)
+        return self.observe_sources(language, root, policy).identity()
 
     def implementation_manifest(self, code_map: CodeMap, format: ManifestFormat) -> ImplementationManifestDocument:
         """Publish a deterministic, provenance-bearing implementation manifest."""
@@ -246,6 +275,7 @@ class ModwireApplication:
                 SourceAssignedValue,
                 SourceAssignedValueKind,
                 SourceManifestIdentity,
+                SourceObservation,
                 SourceMemberKind,
                 SourceRelationKind,
                 ImplementationManifest,

{modwire-11.0.2 → modwire-11.1.0}/src/modwire/architecture/boundaries/services/module_boundary_analyzer.py

@@ -2,6 +2,7 @@ from dataclasses import dataclass
 
 from wireup import injectable
 
+from ....shared.code.models.source_dependency_resolution import SourceDependencyResolution
 from ...config.models.boundaries_config import BoundariesConfig
 from ...config.models.boundary_rule import BoundaryRule
 from ...map.models.architecture_map import ArchitectureMap
@@ -32,7 +33,7 @@ class ModuleBoundaryAnalyzer(FlowAnalyzerInterface):
         ]
         for dependency in architecture_map.code_map.dependency_edges().all():
             edge = dependency.edge
-            if edge.resolution != "resolved" or edge.to_id is None:
+            if edge.resolution is not SourceDependencyResolution.RESOLVED or edge.to_id is None:
                 continue
             source_tags = architecture_map.tag_map.tags_for(edge.from_id)
             target_tags = architecture_map.tag_map.tags_for(edge.to_id)

{modwire-11.0.2 → modwire-11.1.0}/src/modwire/architecture/config/models/shape_rules.py

@@ -1,5 +1,6 @@
 from pydantic import Field
 
+from ....shared.code.models.import_crossing_type import ImportCrossingType
 from .configuration_value import ConfigurationValue
 
 
@@ -20,4 +21,7 @@ class ShapeRules(ConfigurationValue):
     allow_optional_class_properties: bool = False
     allow_import_aliases: bool = False
     require_joined_imports: bool = True
-    allowed_import_crossing_types: tuple[str, ...] = ("module", "symbol")
+    allowed_import_crossing_types: tuple[ImportCrossingType, ...] = (
+        ImportCrossingType.MODULE,
+        ImportCrossingType.SYMBOL,
+    )

modwire-11.1.0/src/modwire/architecture/insights/models/exports_report_item.py

@@ -0,0 +1,11 @@
+from ....shared.code.models.import_crossing_type import ImportCrossingType
+from ....shared.code.models.source_export_kind import SourceExportKind
+from ....shared.values.models.value_model import ValueModel
+
+
+class ExportsReportItem(ValueModel):
+    source_id: str
+    name: str
+    kind: SourceExportKind
+    crossing_type: ImportCrossingType
+    reason: str

{modwire-11.0.2 → modwire-11.1.0}/src/modwire/architecture/insights/services/coherence_reporter.py

@@ -3,6 +3,7 @@ from dataclasses import dataclass
 from wireup import injectable
 
 from ....shared.code.models.identity import FileId
+from ....shared.code.models.source_dependency_resolution import SourceDependencyResolution
 from ...map.models.architecture_map import ArchitectureMap
 from ..domain import InsightReporterInterface
 from ..models.coherence_report import CoherenceReport
@@ -35,7 +36,9 @@ class CoherenceReporter(InsightReporterInterface):
             if not has_incoming and (not has_outgoing):
                 isolated.append(source_id)
         external_dependencies = {
-            edge.specifier for edge in graph.external_edges(source_ids) if edge.resolution == "external"
+            edge.specifier
+            for edge in graph.external_edges(source_ids)
+            if edge.resolution is SourceDependencyResolution.EXTERNAL
         }
         return self.report_type(
             roots=tuple(roots),

{modwire-11.0.2 → modwire-11.1.0}/src/modwire/architecture/shape/services/file_resolver.py

@@ -3,6 +3,7 @@ from dataclasses import dataclass
 from wireup import injectable
 
 from ....shared.code.models.identity import FileId
+from ....shared.code.models.source_value_declaration_kind import SourceValueDeclarationKind
 from ....shared.code.models.source_value_scope import SourceValueScope
 from ...config.models.shape_rules import ShapeRules
 from ..domain import BaseShapeResolver, ShapeResolverInterface
@@ -75,7 +76,8 @@ class FileResolver(ShapeResolverInterface, BaseShapeResolver):
                         source_id=source_id,
                         rule_name="max_variables_per_file",
                         actual=sum(
-                            value.scope == SourceValueScope.MODULE and value.declaration_kind == "assignment"
+                            value.scope is SourceValueScope.MODULE
+                            and value.declaration_kind is SourceValueDeclarationKind.ASSIGNMENT
                             for value in source_file.values
                         ),
                         limit=config.max_variables_per_file,

{modwire-11.0.2 → modwire-11.1.0}/src/modwire/architecture/shape/services/import_resolver.py

@@ -2,6 +2,7 @@ from dataclasses import dataclass
 
 from wireup import injectable
 
+from ....shared.code.models.import_crossing_type import ImportCrossingType
 from ...config.models.shape_rules import ShapeRules
 from ..domain import BaseShapeResolver, ShapeResolverInterface
 from ..models.shape_realm_architecture_map import ShapeRealmArchitectureMap
@@ -49,7 +50,7 @@ class ImportResolver(ShapeResolverInterface, BaseShapeResolver):
                 )
             if (
                 config.require_joined_imports
-                and source_import.crossing_type != "module"
+                and source_import.crossing_type is not ImportCrossingType.MODULE
                 and (not source_import.uses_joined_import)
             ):
                 violations.append(