metaspn-entities 0.1.7__py3-none-any.whl → 0.1.8__py3-none-any.whl

metaspn_entities/__init__.py

@@ -1,6 +1,7 @@
 from .adapter import SignalResolutionResult, resolve_normalized_social_signal
 from .attribution import OutcomeAttribution
 from .context import RecommendationContext, EntityContext, build_confidence_summary, build_recommendation_context
+from .demo import resolve_demo_social_identity
 from .events import EmittedEvent
 from .models import EntityResolution
 from .resolver import EntityResolver
@@ -10,6 +11,7 @@ __all__ = [
     "resolve_normalized_social_signal",
     "SignalResolutionResult",
     "OutcomeAttribution",
+    "resolve_demo_social_identity",
     "EntityContext",
     "RecommendationContext",
     "build_confidence_summary",

metaspn_entities/demo.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+from typing import Any, Dict, Mapping
+
+from .models import EntityType
+from .resolver import EntityResolver
+
+
+def resolve_demo_social_identity(
+    resolver: EntityResolver,
+    social_payload: Mapping[str, Any],
+    *,
+    caused_by: str = "demo-pipeline",
+) -> Dict[str, Any]:
+    platform = str(social_payload.get("platform") or "").strip().lower()
+    source = str(social_payload.get("source") or social_payload.get("provenance") or "demo")
+
+    handle = social_payload.get("author_handle") or social_payload.get("handle")
+    if not isinstance(handle, str) or not handle.strip():
+        raise ValueError("demo payload requires author_handle or handle")
+    handle = handle.strip()
+
+    handle_type = f"{platform}_handle" if platform else "handle"
+    resolution = resolver.resolve(
+        handle_type,
+        handle,
+        context={
+            "entity_type": EntityType.PERSON,
+            "caused_by": caused_by,
+            "provenance": source,
+            "confidence": 0.93,
+        },
+    )
+
+    for key in ("profile_url", "author_url", "canonical_url"):
+        url = social_payload.get(key)
+        if isinstance(url, str) and url.strip():
+            resolver.add_alias(
+                resolution.entity_id,
+                "canonical_url",
+                url.strip(),
+                confidence=0.96,
+                caused_by=caused_by,
+                provenance=source,
+            )
+            break
+
+    email = social_payload.get("email")
+    if isinstance(email, str) and email.strip():
+        resolver.add_alias(
+            resolution.entity_id,
+            "email",
+            email.strip(),
+            confidence=0.98,
+            caused_by=caused_by,
+            provenance=source,
+        )
+
+    canonical_id = resolver.store.canonical_entity_id(resolution.entity_id)
+    context = resolver.entity_context(canonical_id)
+    digest_payload = {
+        "entity_id": canonical_id,
+        "confidence": context.confidence_summary["overall_confidence"],
+        "matched_identifiers": [
+            {
+                "identifier_type": item["identifier_type"],
+                "value": item["value"],
+                "confidence": item["confidence"],
+                "last_seen_at": item["last_seen_at"],
+            }
+            for item in context.identifiers
+        ],
+        "why": {
+            "matched_identifier_count": len(context.identifiers),
+            "alias_count": len(context.aliases),
+            "confidence_summary": context.confidence_summary,
+            "relationship_stage_hint": resolver.recommendation_context(canonical_id).relationship_stage_hint,
+        },
+        "events": [event.payload for event in resolver.drain_events()],
+    }
+    return digest_payload

metaspn_entities/normalize.py

@@ -7,7 +7,17 @@ def normalize_identifier(identifier_type: str, value: str) -> str:
     identifier_type = identifier_type.strip().lower()
     value = value.strip()
 
-    if identifier_type in {"twitter_handle", "github_handle", "handle"}:
+    if identifier_type in {
+        "twitter_handle",
+        "x_handle",
+        "linkedin_handle",
+        "github_handle",
+        "instagram_handle",
+        "tiktok_handle",
+        "bluesky_handle",
+        "youtube_handle",
+        "handle",
+    }:
         return value.lstrip("@").lower()
 
     if identifier_type == "email":

{metaspn_entities-0.1.7.dist-info → metaspn_entities-0.1.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metaspn-entities
-Version: 0.1.7
+Version: 0.1.8
 Summary: Canonical entity resolution, aliasing, and merges for MetaSPN systems
 Author: MetaSPN Contributors
 License-Expression: MIT
@@ -135,3 +135,16 @@ Attribution guarantees:
 - canonical merge redirects are resolved before returning `entity_id`
 - output includes explicit confidence for downstream learning logic
 - deterministic tie-breaks are applied by score, then hit count, then entity ID
+
+## Demo Pipeline Invocation
+
+For demo digest identity resolution (without direct DB queries in renderer), use:
+
+- `resolve_demo_social_identity(resolver, social_payload)`
+
+Returned payload includes:
+- `entity_id`
+- `confidence`
+- `matched_identifiers`
+- `why` metadata (confidence summary, counts, relationship hint)
+- emitted event payloads for auditability

{metaspn_entities-0.1.7.dist-info → metaspn_entities-0.1.8.dist-info}/RECORD

@@ -1,14 +1,15 @@
-metaspn_entities/__init__.py,sha256=LCrhnRQHweDRNX9BOj6FV34uzLRbT7whU6TleZlZiHU,709
+metaspn_entities/__init__.py,sha256=mkKm_bGmH4PogzvMUR_BJDuuOSFBkz-VvWzs1Bie06Y,792
 metaspn_entities/adapter.py,sha256=eNB5kr1tinav85WPA4YCldRDJBgb6uYe3ZWCRVjdOms,4654
 metaspn_entities/attribution.py,sha256=bCJGAW5XAzI9ZOWVTvw_bWfUVXbEAATFJ3N9W4_C2U8,3061
 metaspn_entities/context.py,sha256=sUpW50Z99R0iQ5ryVR9uk7WqUaiKCxMyTQlvuV3DvVk,6054
+metaspn_entities/demo.py,sha256=QJyIRuds0AoOwGBo0a93f62742848v4XogSV99LQjL0,2764
 metaspn_entities/events.py,sha256=Hkc3gy5_vRTSR0MKUvF24dTqNqOkG423_PTUe7csUfw,2066
 metaspn_entities/models.py,sha256=b2EFsc1EIT9Ao_bKA2I52-5W_0fTwhsyO6VFRG8gZg8,1377
-metaspn_entities/normalize.py,sha256=nPAHRfipgS6zHy2x70ZFd5HB1W4FKmeTF8Kd4TYz5tI,1125
+metaspn_entities/normalize.py,sha256=o05fEXXoDWAGH1RNEH_zcfhRxR6CpAEBralbTlsK5ng,1308
 metaspn_entities/resolver.py,sha256=bKnxInPNLefdgblrrl1oAtc2aiUlXqZz3bmSZWNX21E,9910
 metaspn_entities/sqlite_backend.py,sha256=h7_dMNmd9-k9hxvJwZp_TM9_yNWyFbJric6TvH_BseU,12087
-metaspn_entities-0.1.7.dist-info/licenses/LICENSE,sha256=tvVpto97dUnh1-KVYPs1rCr5dzyX8jUyNmT7F7ZPVAM,1077
-metaspn_entities-0.1.7.dist-info/METADATA,sha256=MRfkGTOysqJ99tSf5gdSgirOPhTXDtExezGWlPDQ3WQ,4635
-metaspn_entities-0.1.7.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-metaspn_entities-0.1.7.dist-info/top_level.txt,sha256=YP2V8Z1Statrs3YAI-tGvyC73vLjPHr9Vkal4yqXkhs,17
-metaspn_entities-0.1.7.dist-info/RECORD,,
+metaspn_entities-0.1.8.dist-info/licenses/LICENSE,sha256=tvVpto97dUnh1-KVYPs1rCr5dzyX8jUyNmT7F7ZPVAM,1077
+metaspn_entities-0.1.8.dist-info/METADATA,sha256=AD2i7hlPWzTu0DeoWO1zbaHS2zIknbc8x_qeolStghM,4995
+metaspn_entities-0.1.8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+metaspn_entities-0.1.8.dist-info/top_level.txt,sha256=YP2V8Z1Statrs3YAI-tGvyC73vLjPHr9Vkal4yqXkhs,17
+metaspn_entities-0.1.8.dist-info/RECORD,,