feat(PLT-1660): hard cut — delete old semantic type system, wire extension type hashing

src/orcapod/contexts/core.py

@@ -21,7 +21,7 @@ class DataContext:
             registration. This is the single public API for all type operations.
         arrow_hasher: Arrow table hasher for this context
         semantic_hasher: General semantic hasher for this context. The
-            ``TypeHandlerRegistry`` used for hashing is accessible via
+            ``PythonTypeHandlerRegistry`` used for hashing is accessible via
             ``semantic_hasher.type_handler_registry``.
     """
 

src/orcapod/contexts/data/schemas/context_schema.json

@@ -41,10 +41,6 @@
                 "Enhanced version with timestamp support and improved hashing"
             ]
         },
-        "semantic_registry": {
-            "$ref": "#/$defs/objectspec",
-            "description": "ObjectSpec for the semantic registry"
-        },
         "type_converter": {
             "$ref": "#/$defs/objectspec",
             "description": "ObjectSpec for the python-arrow type converter"
@@ -57,17 +53,17 @@
             "$ref": "#/$defs/objectspec",
             "description": "ObjectSpec for the semantic hasher component"
         },
-        "type_handler_registry": {
+        "python_type_handler_registry": {
             "$ref": "#/$defs/objectspec",
-            "description": "ObjectSpec for the TypeHandlerRegistry used by the semantic hasher"
+            "description": "ObjectSpec for the PythonTypeHandlerRegistry used by the semantic hasher"
         },
         "file_hasher": {
             "$ref": "#/$defs/objectspec",
-            "description": "ObjectSpec for the file content hasher (used by PathContentHandler)"
+            "description": "ObjectSpec for the file content hasher (used by PathHandler)"
         },
-        "function_info_extractor": {
+        "function_semantic_hasher": {
             "$ref": "#/$defs/objectspec",
-            "description": "ObjectSpec for the function info extractor (used by FunctionHandler)"
+            "description": "ObjectSpec for the function semantic hasher (used by FunctionHandler)"
         },
         "metadata": {
             "type": "object",
@@ -167,51 +163,32 @@
         {
             "context_key": "std:v0.1:default",
             "version": "v0.1",
-            "description": "Initial stable release with basic Path semantic type support",
-            "semantic_type_registry": {
-                "_class": "orcapod.types.semantic_types.SemanticTypeRegistry",
-                "_config": {
-                    "converters": [
-                        {
-                            "_class": "orcapod.types.semantic_types.PythonPathStructConverter",
-                            "_config": {}
-                        }
-                    ]
-                }
+            "description": "Initial stable release with extension type hashing support",
+            "type_converter": {
+                "_class": "orcapod.semantic_types.universal_converter.UniversalTypeConverter",
+                "_config": {}
             },
             "arrow_hasher": {
-                "_class": "orcapod.hashing.arrow_hashers.SemanticArrowHasher",
+                "_class": "orcapod.hashing.arrow_hashers.StarfixArrowHasher",
                 "_config": {
                     "hasher_id": "arrow_v0.1",
-                    "hash_algorithm": "sha256",
-                    "serialization_method": "logical",
-                    "semantic_type_hashers": {
-                        "path": {
-                            "_class": "orcapod.hashing.semantic_type_hashers.PathHasher",
-                            "_config": {
-                                "file_hasher": {
-                                    "_class": "orcapod.hashing.file_hashers.BasicFileHasher",
-                                    "_config": {
-                                        "algorithm": "sha256"
-                                    }
-                                }
-                            }
-                        }
-                    }
+                    "type_converter": {"_ref": "type_converter"},
+                    "semantic_hasher": {"_ref": "semantic_hasher"}
                 }
             },
             "semantic_hasher": {
-                "_class": "orcapod.hashing.semantic_hashing.semantic_hasher.BaseSemanticHasher",
+                "_class": "orcapod.hashing.semantic_hashing.semantic_hasher.SemanticAwarePythonHasher",
                 "_config": {
-                    "hasher_id": "semantic_v0.1"
+                    "hasher_id": "semantic_v0.1",
+                    "type_handler_registry": {"_ref": "python_type_handler_registry"}
                 }
             },
             "metadata": {
-                "created_date": "2025-08-01",
+                "created_date": "2026-06-24",
                 "author": "OrcaPod Team",
                 "changelog": [
-                    "Initial release with semantic type registry",
-                    "Basic Arrow and object hashing capabilities"
+                    "Initial release with extension type hashing support",
+                    "StarfixArrowHasher for cross-language-compatible Arrow hashing"
                 ]
             }
         }

src/orcapod/contexts/data/v0.1.json

@@ -1,41 +1,13 @@
 {
     "context_key": "std:v0.1:default",
     "version": "v0.1",
-    "description": "Initial stable release with basic Path semantic type support",
+    "description": "Initial stable release with extension type hashing support",
     "file_hasher": {
         "_class": "orcapod.hashing.file_hashers.BasicFileHasher",
         "_config": {
             "algorithm": "sha256"
         }
     },
-    "semantic_registry": {
-        "_class": "orcapod.semantic_types.semantic_registry.SemanticTypeRegistry",
-        "_config": {
-            "converters": {
-                "upath": {
-                    "_class": "orcapod.semantic_types.semantic_struct_converters.UPathStructConverter",
-                    "_config": {
-                        "file_hasher": {"_ref": "file_hasher"}
-                    }
-                },
-                "path": {
-                    "_class": "orcapod.semantic_types.semantic_struct_converters.PythonPathStructConverter",
-                    "_config": {
-                        "file_hasher": {"_ref": "file_hasher"}
-                    }
-                }
-            }
-        }
-    },
-    "arrow_hasher": {
-        "_class": "orcapod.hashing.arrow_hashers.StarfixArrowHasher",
-        "_config": {
-            "hasher_id": "arrow_v0.1",
-            "semantic_registry": {
-                "_ref": "semantic_registry"
-            }
-        }
-    },
     "type_converter": {
         "_class": "orcapod.semantic_types.universal_converter.UniversalTypeConverter",
         "_config": {
@@ -78,52 +50,61 @@
             }
         }
     },
-    "function_info_extractor": {
+    "function_semantic_hasher": {
         "_class": "orcapod.hashing.semantic_hashing.function_info_extractors.FunctionSignatureExtractor",
         "_config": {
             "include_module": true,
             "include_defaults": true
         }
     },
-    "type_handler_registry": {
-        "_class": "orcapod.hashing.semantic_hashing.type_handler_registry.TypeHandlerRegistry",
+    "python_type_handler_registry": {
+        "_class": "orcapod.hashing.semantic_hashing.type_handler_registry.PythonTypeHandlerRegistry",
         "_config": {
             "handlers": [
-                [{"_type": "builtins.bytes"},    {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.BytesHandler",    "_config": {}}],
-                [{"_type": "builtins.bytearray"}, {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.BytesHandler",    "_config": {}}],
-                [{"_type": "pathlib.Path"},        {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.PathContentHandler", "_config": {"file_hasher": {"_ref": "file_hasher"}}}],
-                [{"_type": "upath.core.UPath"},    {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.UPathContentHandler", "_config": {"file_hasher": {"_ref": "file_hasher"}}}],
-                [{"_type": "uuid.UUID"},           {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.UUIDHandler",         "_config": {}}],
-                [{"_type": "types.FunctionType"},        {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.FunctionHandler", "_config": {"function_info_extractor": {"_ref": "function_info_extractor"}}}],
-                [{"_type": "types.BuiltinFunctionType"}, {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.FunctionHandler", "_config": {"function_info_extractor": {"_ref": "function_info_extractor"}}}],
-                [{"_type": "types.MethodType"},          {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.FunctionHandler", "_config": {"function_info_extractor": {"_ref": "function_info_extractor"}}}],
-                [{"_type": "builtins.type"},       {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.TypeObjectHandler",   "_config": {}}],
-                [{"_type": "types.GenericAlias"},   {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.GenericAliasHandler",  "_config": {}}],
-                [{"_type": "types.UnionType"},     {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.UnionTypeHandler",    "_config": {}}],
-                [{"_type": "typing._GenericAlias"}, {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.GenericAliasHandler",  "_config": {}}],
-                [{"_type": "typing._SpecialForm"},  {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.SpecialFormHandler",   "_config": {}}],
-                [{"_type": "pyarrow.Table"},        {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.ArrowTableHandler",  "_config": {"arrow_hasher": {"_ref": "arrow_hasher"}}}],
-                [{"_type": "pyarrow.RecordBatch"},  {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.ArrowTableHandler",  "_config": {"arrow_hasher": {"_ref": "arrow_hasher"}}}]
+                [{"_type": "builtins.bytes"},         {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.BytesHandler",        "_config": {}}],
+                [{"_type": "builtins.bytearray"},     {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.BytesHandler",        "_config": {}}],
+                [{"_type": "pathlib.Path"},            {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.PathHandler",         "_config": {"file_hasher": {"_ref": "file_hasher"}}}],
+                [{"_type": "upath.core.UPath"},        {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.UPathHandler",        "_config": {"file_hasher": {"_ref": "file_hasher"}}}],
+                [{"_type": "uuid.UUID"},               {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.UUIDHandler",         "_config": {}}],
+                [{"_type": "types.FunctionType"},      {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.FunctionHandler",     "_config": {"function_info_extractor": {"_ref": "function_semantic_hasher"}}}],
+                [{"_type": "types.BuiltinFunctionType"},{"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.FunctionHandler",    "_config": {"function_info_extractor": {"_ref": "function_semantic_hasher"}}}],
+                [{"_type": "types.MethodType"},        {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.FunctionHandler",     "_config": {"function_info_extractor": {"_ref": "function_semantic_hasher"}}}],
+                [{"_type": "builtins.type"},           {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.TypeObjectHandler",   "_config": {}}],
+                [{"_type": "types.GenericAlias"},      {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.GenericAliasHandler", "_config": {}}],
+                [{"_type": "types.UnionType"},         {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.UnionTypeHandler",    "_config": {}}],
+                [{"_type": "typing._GenericAlias"},    {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.GenericAliasHandler", "_config": {}}],
+                [{"_type": "typing._SpecialForm"},     {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.SpecialFormHandler",  "_config": {}}],
+                [{"_type": "pyarrow.Table"},            {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.ArrowTableHandler",   "_config": {}}],
+                [{"_type": "pyarrow.RecordBatch"},      {"_class": "orcapod.hashing.semantic_hashing.builtin_handlers.ArrowTableHandler",   "_config": {}}]
             ]
         }
     },
     "semantic_hasher": {
-        "_class": "orcapod.hashing.semantic_hashing.semantic_hasher.BaseSemanticHasher",
+        "_class": "orcapod.hashing.semantic_hashing.semantic_hasher.SemanticAwarePythonHasher",
         "_config": {
             "hasher_id": "semantic_v0.1",
             "type_handler_registry": {
-                "_ref": "type_handler_registry"
+                "_ref": "python_type_handler_registry"
             }
         }
     },
+    "arrow_hasher": {
+        "_class": "orcapod.hashing.arrow_hashers.StarfixArrowHasher",
+        "_config": {
+            "hasher_id": "arrow_v0.1",
+            "type_converter": {"_ref": "type_converter"},
+            "semantic_hasher": {"_ref": "semantic_hasher"}
+        }
+    },
     "metadata": {
-        "created_date": "2025-08-01",
+        "created_date": "2026-06-24",
         "author": "OrcaPod Core Team",
         "changelog": [
             "Initial release with Path semantic type support",
             "Basic SHA-256 hashing for files and objects",
             "Arrow logical serialization method",
-            "Introduced arrow_v0.1 StarfixArrowHasher using starfix ArrowDigester for cross-language-compatible Arrow hashing"
+            "Introduced arrow_v0.1 StarfixArrowHasher using starfix ArrowDigester for cross-language-compatible Arrow hashing",
+            "Hard cut: replaced shape-based SemanticTypeRegistry with extension-type hashing; renamed all hashing classes to cleaner names"
         ]
     }
 }

src/orcapod/core/function_pod.py

@@ -656,7 +656,7 @@ def as_table(
         return output_table
 
 
-class CallableWithPod(Protocol):
+class CallableWithPodProtocol(Protocol):
     @property
     def pod(self) -> _FunctionPodBase:
         """Return the associated function pod."""
@@ -676,7 +676,7 @@ def function_pod(
     pod_cache_database: ArrowDatabaseProtocol | None = None,
     executor: DataFunctionExecutorProtocol | None = None,
     **kwargs,
-) -> Callable[..., CallableWithPod]:
+) -> Callable[..., CallableWithPodProtocol]:
     """Decorator that attaches a ``FunctionPod`` as a ``pod`` attribute.
 
     Args:
@@ -696,7 +696,7 @@ def function_pod(
         A decorator that adds a ``pod`` attribute to the wrapped function.
     """
 
-    def decorator(func: Callable) -> CallableWithPod:
+    def decorator(func: Callable) -> CallableWithPodProtocol:
         if func.__name__ == "<lambda>":
             raise ValueError("Lambda functions cannot be used with function_pod")
 
@@ -736,7 +736,7 @@ def wrapper(*args, **kwargs):
             return func(*args, **kwargs)
 
         setattr(wrapper, "pod", pod)
-        return cast(CallableWithPod, wrapper)
+        return cast(CallableWithPodProtocol, wrapper)
 
     return decorator
 

src/orcapod/extension_types/registry.py

@@ -190,8 +190,8 @@ class LogicalTypeRegistry:
 
     An optional ``logical_types`` list can be passed at construction time to
     pre-register one or more ``LogicalTypeProtocol`` instances immediately, following
-    the same pattern as ``SemanticTypeRegistry``'s ``converters`` constructor
-    argument.
+    the same pattern as the ``logical_types`` constructor argument used by
+    other registries in this package.
 
     An optional ``factories`` list can also be passed to pre-register
     ``LogicalTypeFactoryProtocol`` instances at construction time. Each entry is a