modwire 9.2.4__tar.gz → 10.0.0__tar.gz

{modwire-9.2.4 → modwire-10.0.0}/.dev/modwire.egg-info/SOURCES.txt

@@ -118,6 +118,7 @@ src/modwire/cli/cache/domain.py
 src/modwire/cli/cache/models/__init__.py
 src/modwire/cli/cache/models/cache_entry.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_plan.py
@@ -148,7 +149,6 @@ 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/scan_policy.py
 src/modwire/cli/pipeline/models/source_entry.py
 src/modwire/cli/pipeline/models/source_inventory.py
 src/modwire/cli/pipeline/services/__init__.py
@@ -164,6 +164,7 @@ src/modwire/cli/pipeline/services/hotspots_insight.py
 src/modwire/cli/pipeline/services/map_tree.py
 src/modwire/cli/pipeline/services/output_console.py
 src/modwire/cli/pipeline/services/shape_violations.py
+src/modwire/cli/pipeline/services/source_manifest_builder.py
 src/modwire/cli/pipeline/services/success.py
 src/modwire/cli/pipeline/services/unknown_files_warning.py
 src/modwire/cli/pipeline/services/unused_exports_insight.py
@@ -196,6 +197,7 @@ src/modwire/extraction/extractors/models/__init__.py
 src/modwire/extraction/extractors/models/batch_config.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/python_call_context.py
 src/modwire/extraction/extractors/resources/__init__.py
@@ -220,25 +222,58 @@ src/modwire/extraction/extractors/services/python_call_reader.py
 src/modwire/extraction/extractors/services/python_extractor.py
 src/modwire/extraction/extractors/services/python_syntax_parser.py
 src/modwire/extraction/extractors/services/type_script_extractor.py
+src/modwire/implementation/__init__.py
+src/modwire/implementation/facade.py
+src/modwire/implementation/manifest/__init__.py
+src/modwire/implementation/manifest/application.py
+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_attribute.py
+src/modwire/implementation/manifest/models/manifest_callable.py
+src/modwire/implementation/manifest/models/manifest_dependency.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/services/__init__.py
+src/modwire/implementation/manifest/services/canonical_json_manifest_serializer.py
+src/modwire/implementation/manifest/services/code_map_manifest_compiler.py
 src/modwire/shared/__init__.py
 src/modwire/shared/code/__init__.py
 src/modwire/shared/code/application.py
 src/modwire/shared/code/domain.py
 src/modwire/shared/code/models/__init__.py
+src/modwire/shared/code/models/capability_coverage.py
+src/modwire/shared/code/models/capability_status.py
 src/modwire/shared/code/models/code_map.py
+src/modwire/shared/code/models/code_map_producer.py
 src/modwire/shared/code/models/code_package.py
+src/modwire/shared/code/models/declaration_family.py
+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/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/node.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
+src/modwire/shared/code/models/runtime_observation.py
+src/modwire/shared/code/models/scan_policy.py
 src/modwire/shared/code/models/source_abstract_class.py
+src/modwire/shared/code/models/source_artifact.py
 src/modwire/shared/code/models/source_call.py
 src/modwire/shared/code/models/source_callable.py
 src/modwire/shared/code/models/source_callable_symbol.py
@@ -252,9 +287,13 @@ src/modwire/shared/code/models/source_file_result.py
 src/modwire/shared/code/models/source_function.py
 src/modwire/shared/code/models/source_import.py
 src/modwire/shared/code/models/source_imported_symbol.py
+src/modwire/shared/code/models/source_inheritance.py
 src/modwire/shared/code/models/source_interface.py
 src/modwire/shared/code/models/source_item_result.py
+src/modwire/shared/code/models/source_manifest.py
+src/modwire/shared/code/models/source_member_kind.py
 src/modwire/shared/code/models/source_parameter.py
+src/modwire/shared/code/models/source_relation_kind.py
 src/modwire/shared/code/models/source_signature.py
 src/modwire/shared/code/models/source_symbol.py
 src/modwire/shared/code/models/source_type.py
@@ -264,6 +303,7 @@ src/modwire/shared/code/models/types.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
+src/modwire/shared/code/services/installed_package_version.py
 src/modwire/shared/values/__init__.py
 src/modwire/shared/values/models/__init__.py
 src/modwire/shared/values/models/value_model.py
@@ -274,6 +314,7 @@ tests/application/base_test.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/architecture/__init__.py
 tests/architecture/base_test.py
 tests/architecture/boundaries/__init__.py

modwire-10.0.0/PKG-INFO

@@ -0,0 +1,308 @@
+Metadata-Version: 2.4
+Name: modwire
+Version: 10.0.0
+Summary: Code extraction, architecture analysis and the Modwire CLI.
+Author: Tomasz Szpak
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/szpak-dev/modwire
+Project-URL: Repository, https://github.com/szpak-dev/modwire
+Project-URL: Issues, https://github.com/szpak-dev/modwire/issues
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.12
+Requires-Dist: pydantic-yaml>=1.7
+Requires-Dist: rich>=13
+Requires-Dist: wireup>=2.12.0
+Provides-Extra: dev
+Requires-Dist: build>=1.3; extra == "dev"
+Requires-Dist: pytest>=9; extra == "dev"
+Requires-Dist: ruff<0.16,>=0.14; extra == "dev"
+Requires-Dist: pyright>=1.1; extra == "dev"
+Requires-Dist: twine>=6; extra == "dev"
+Dynamic: license-file
+
+# Modwire
+
+## `ModwireApplication`
+
+Public entry point for extraction, implementation manifests, architecture analysis, and the Modwire CLI.
+
+### `create`
+
+Create an isolated application with all services resolved through Wireup.
+
+### `configure`
+
+Validate architecture configuration values.
+
+### `catalog`
+
+Return the available architecture reports.
+
+### `analyze`
+
+Analyze a code map with a validated architecture configuration.
+
+### `analyze_cached`
+
+Analyze a code map, reusing reports for an exact map and configuration identity.
+
+### `analyze_cached_with_diagnostics`
+
+Analyze a code map and report the public outcome of report-cache reuse.
+
+### `discover`
+
+Discover supported source languages beneath a root using the caller's scan policy.
+
+### `generate_map`
+
+Extract one language and return its code map with honest scan metrics.
+
+``files_excluded`` counts only source files encountered and excluded directly.
+``directories_pruned`` counts directories rejected before descent; their
+descendants are deliberately unobserved and are not included in file counts.
+
+### `generate_queryable_map`
+
+Extract source files and return a queryable code map.
+
+### `generate_map_cached`
+
+Return a code map with content-addressed source and complete-source-set reuse.
+
+### `generate_map_cached_with_diagnostics`
+
+Return a code map and public outcomes for extraction and complete-map reuse.
+
+### `generate_queryable_map_cached`
+
+Return a queryable code map with content-addressed persistent reuse.
+
+### `generate_queryable_map_cached_with_diagnostics`
+
+Return a queryable code map and public outcomes for every applicable cache stage.
+
+### `implementation_manifest`
+
+Publish a deterministic, provenance-bearing implementation manifest.
+
+### `implementation_manifest_formats`
+
+Return the implementation-manifest formats registered in this application.
+
+### `read_implementation_manifest`
+
+Read and canonically validate a serialized implementation manifest.
+
+### `clear_cache`
+
+Clear only the Modwire-owned directory for one cache namespace.
+
+### `load_configuration`
+
+Load and validate an architecture configuration from a directory.
+
+### `initialize`
+
+Create project-local Modwire configuration and agent guidance.
+
+### `generate_documentation`
+
+Generate this README from the published interface docstrings, or check that it is current.
+
+### `run_extractor`
+
+Run the native extractor transport for one supported language.
+
+### `run`
+
+Run the Modwire command line interface and return its process status.
+
+## `CacheStage`
+
+Public stages reported by cached Modwire operations.
+
+## `CacheOutcome`
+
+Content-safe lifecycle counts for one stage of a cached operation.
+
+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.
+
+## `CachedResult`
+
+A cached operation value together with one outcome per applicable stage.
+
+### `outcome`
+
+Return the outcome for one applicable cache stage.
+
+## `CacheOptions`
+
+Generic persistent-cache settings supplied by a caller.
+
+## `ScanPolicy`
+
+Caller-owned filesystem traversal policy with explicit exclusions and opt-in symlink following.
+
+## `SourceMemberKind`
+
+Ownership kind for a declared class or type member.
+
+## `SourceRelationKind`
+
+Canonical relation kinds published by code maps and implementation manifests.
+
+## `ImplementationManifest`
+
+A versioned, language-neutral statement of observed implementation facts and provenance.
+
+### `validate_facts`
+
+Validate canonical ordering, identity uniqueness, and fact references.
+
+## `ImplementationManifestDocument`
+
+!!! abstract "Usage Documentation"
+    [Models](../concepts/models.md)
+
+A base class for creating Pydantic models.
+
+Attributes:
+    __class_vars__: The names of the class variables defined on the model.
+    __private_attributes__: Metadata about the private attributes of the model.
+    __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+
+    __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+    __pydantic_core_schema__: The core schema of the model.
+    __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+    __pydantic_decorators__: Metadata containing the decorators defined on the model.
+        This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+    __pydantic_generic_metadata__: A dictionary containing metadata about generic Pydantic models.
+        The `origin` and `args` items map to the [`__origin__`][genericalias.__origin__]
+        and [`__args__`][genericalias.__args__] attributes of [generic aliases][types-genericalias],
+        and the `parameter` item maps to the `__parameter__` attribute of generic classes.
+    __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+    __pydantic_post_init__: The name of the post-init method for the model, if defined.
+    __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+    __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+    __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+
+    __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+    __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+
+    __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+        is set to `'allow'`.
+    __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+    __pydantic_private__: Values of private attributes set on the model instance.
+
+### `verify_digest`
+
+Return whether the payload matches the declared digest.
+
+### `validate_digest`
+
+Validate that the document digest covers its exact serialized payload.
+
+## `ManifestFormat`
+
+!!! abstract "Usage Documentation"
+    [Models](../concepts/models.md)
+
+A base class for creating Pydantic models.
+
+Attributes:
+    __class_vars__: The names of the class variables defined on the model.
+    __private_attributes__: Metadata about the private attributes of the model.
+    __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+
+    __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+    __pydantic_core_schema__: The core schema of the model.
+    __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+    __pydantic_decorators__: Metadata containing the decorators defined on the model.
+        This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+    __pydantic_generic_metadata__: A dictionary containing metadata about generic Pydantic models.
+        The `origin` and `args` items map to the [`__origin__`][genericalias.__origin__]
+        and [`__args__`][genericalias.__args__] attributes of [generic aliases][types-genericalias],
+        and the `parameter` item maps to the `__parameter__` attribute of generic classes.
+    __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+    __pydantic_post_init__: The name of the post-init method for the model, if defined.
+    __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+    __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+    __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+
+    __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+    __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+
+    __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+        is set to `'allow'`.
+    __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+    __pydantic_private__: Values of private attributes set on the model instance.
+
+## `DeclarationFamily`
+
+Enum where members are also (and must be) strings
+
+## `DeclarationIdentity`
+
+!!! abstract "Usage Documentation"
+    [Models](../concepts/models.md)
+
+A base class for creating Pydantic models.
+
+Attributes:
+    __class_vars__: The names of the class variables defined on the model.
+    __private_attributes__: Metadata about the private attributes of the model.
+    __signature__: The synthesized `__init__` [`Signature`][inspect.Signature] of the model.
+
+    __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+    __pydantic_core_schema__: The core schema of the model.
+    __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+    __pydantic_decorators__: Metadata containing the decorators defined on the model.
+        This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+    __pydantic_generic_metadata__: A dictionary containing metadata about generic Pydantic models.
+        The `origin` and `args` items map to the [`__origin__`][genericalias.__origin__]
+        and [`__args__`][genericalias.__args__] attributes of [generic aliases][types-genericalias],
+        and the `parameter` item maps to the `__parameter__` attribute of generic classes.
+    __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+    __pydantic_post_init__: The name of the post-init method for the model, if defined.
+    __pydantic_root_model__: Whether the model is a [`RootModel`][pydantic.root_model.RootModel].
+    __pydantic_serializer__: The `pydantic-core` `SchemaSerializer` used to dump instances of the model.
+    __pydantic_validator__: The `pydantic-core` `SchemaValidator` used to validate instances of the model.
+
+    __pydantic_fields__: A dictionary of field names and their corresponding [`FieldInfo`][pydantic.fields.FieldInfo] objects.
+    __pydantic_computed_fields__: A dictionary of computed field names and their corresponding [`ComputedFieldInfo`][pydantic.fields.ComputedFieldInfo] objects.
+
+    __pydantic_extra__: A dictionary containing extra values, if [`extra`][pydantic.config.ConfigDict.extra]
+        is set to `'allow'`.
+    __pydantic_fields_set__: The names of fields explicitly set during instantiation.
+    __pydantic_private__: Values of private attributes set on the model instance.
+
+### `canonical`
+
+Return the stable source-qualified declaration identity.
+
+## `DigestAlgorithm`
+
+Digest algorithms supported by implementation-manifest artifacts.
+
+## `FactCapability`
+
+Versioned implementation fact families that an extractor can publish.
+
+## `CapabilityStatus`
+
+Declared completeness of an extractor's support for a fact family.
+
+## `CapabilityCoverage`
+
+An extractor's explicit support status for one implementation fact family.