@reconcrap/people-network-memory 0.1.0

package/src/people_network_memory/ports/interfaces.py

@@ -0,0 +1,103 @@
+"""Ports consumed by application services."""
+
+from __future__ import annotations
+
+from typing import Protocol
+
+from people_network_memory.domain.models import (
+    IdentityAdvice,
+    IdentityCandidate,
+    PersonCard,
+    PersonMemoryRecord,
+    PersonRef,
+    RecordInteractionResult,
+    RetrievalItem,
+    ReviewItem,
+    SocialInteraction,
+)
+
+
+class IdentityIndex(Protocol):
+    def find_identity_candidates(self, ref: PersonRef) -> list[IdentityCandidate]:
+        ...
+
+
+class IdentityAdvisor(Protocol):
+    def advise(
+        self,
+        *,
+        interaction: SocialInteraction,
+        ref: PersonRef,
+        candidates: list[IdentityCandidate],
+    ) -> IdentityAdvice:
+        ...
+
+
+class GraphMemoryStore(Protocol):
+    def save_interaction(
+        self, interaction: SocialInteraction, identity_map: dict[str, str | None]
+    ) -> RecordInteractionResult:
+        ...
+
+    def get_person_memory(self, person_id: str) -> PersonMemoryRecord | None:
+        ...
+
+    def find_person_memory_by_name(self, name: str) -> list[PersonMemoryRecord]:
+        ...
+
+    def merge_people(
+        self, *, source_person_id: str, target_person_id: str, note: str | None = None
+    ) -> PersonMemoryRecord:
+        ...
+
+    def export_data(self) -> dict[str, object]:
+        ...
+
+
+class GraphSearch(Protocol):
+    def search(
+        self,
+        query: str,
+        *,
+        limit: int = 10,
+        include_sensitive: bool = False,
+        mode: str = "recall",
+    ) -> list[RetrievalItem]:
+        ...
+
+
+class RetrievalJudge(Protocol):
+    def judge(
+        self,
+        query: str,
+        candidates: list[RetrievalItem],
+        *,
+        limit: int,
+    ) -> list[RetrievalItem]:
+        ...
+
+
+class InteractionExtractor(Protocol):
+    def extract(self, interaction: SocialInteraction) -> SocialInteraction:
+        ...
+
+
+class ReviewQueue(Protocol):
+    def add_review_item(self, item: ReviewItem) -> None:
+        ...
+
+    def list_review_items(self, *, status: str | None = None) -> list[ReviewItem]:
+        ...
+
+    def update_review_item(self, item: ReviewItem) -> ReviewItem:
+        ...
+
+
+class PersonProjector(Protocol):
+    def build_card(self, record: PersonMemoryRecord) -> PersonCard:
+        ...
+
+
+class IdGenerator(Protocol):
+    def new_id(self, prefix: str) -> str:
+        ...

package/src/people_network_memory/projection/__init__.py

@@ -0,0 +1,6 @@
+"""Projection builders for read models."""
+
+from people_network_memory.projection.builders import DefaultPersonProjector
+
+__all__ = ["DefaultPersonProjector"]
+

package/src/people_network_memory/projection/builders.py

@@ -0,0 +1,46 @@
+"""Read-model projection helpers."""
+
+from __future__ import annotations
+
+from people_network_memory.domain.models import PersonCard, PersonMemoryRecord
+
+
+class DefaultPersonProjector:
+    def build_card(self, record: PersonMemoryRecord) -> PersonCard:
+        current_work = next(
+            (work for work in record.work_history if work.is_current),
+            record.work_history[0] if record.work_history else None,
+        )
+        headline = None
+        if current_work:
+            headline = " at ".join(
+                part for part in [current_work.role, current_work.organization] if part
+            )
+        recent_interactions = [
+            interaction.source_text for interaction in record.interactions[-5:]
+        ]
+        summary_parts = []
+        if headline:
+            summary_parts.append(headline)
+        if record.interests:
+            summary_parts.append("Interests: " + ", ".join(record.interests[:5]))
+        return PersonCard(
+            person_id=record.person_id,
+            display_name=record.display_name,
+            aliases=record.aliases,
+            headline=headline,
+            summary="; ".join(summary_parts) if summary_parts else None,
+            work_history=record.work_history,
+            education=record.education,
+            interests=record.interests,
+            important_dates=record.important_dates,
+            contacts=record.contacts,
+            preferences=record.preferences,
+            recent_interactions=recent_interactions,
+            attributed_claims=record.attributed_claims,
+            relationships=record.relationships,
+            open_follow_ups=[
+                follow_up for follow_up in record.follow_ups if follow_up.status == "open"
+            ],
+            evidence=record.evidence,
+        )