feat: wire file_edits/session_agent_policies/display_name to real surfaces

docs/cli-reference.md

@@ -298,9 +298,9 @@ Usage: polylogue read [OPTIONS] [REF]
 Projection:
   -v, --view VIEW[,VIEW...]       What to render (summary, transcript,
                                   dialogue, messages, raw, hooks, events,
-                                  context, context-image, neighbors,
-                                  correlation, temporal, chronicle).
-                                  [default: summary]
+                                  file-edits, agent-policies, context,
+                                  context-image, neighbors, correlation,
+                                  temporal, chronicle).  [default: summary]
   --render TEXT                   Render expression, e.g. layout:context-
                                   image,timestamps:include-
                                   available,format:markdown. Known keys:

polylogue/api/archive.py

@@ -1995,6 +1995,7 @@ def _archive_summary_to_domain(summary: ArchiveSessionSummary) -> SessionSummary
         git_branch=summary.git_branch,
         git_repository_url=summary.git_repository_url,
         provider_project_ref=summary.provider_project_ref,
+        display_name=summary.display_name,
         message_count=summary.message_count,
         tags_m2m=summary.tags,
     )
@@ -5447,6 +5448,76 @@ async def get_session_events(
             for event in events
         ]
 
+    async def get_file_edits(self, session_id: str) -> list[dict[str, object]] | None:
+        """Return file-edit tool-call evidence (structuredPatch/originalFile/...) for one session.
+
+        polylogue-nua7: the writer materializes ``ParsedFileEdit`` evidence
+        (Claude Code Edit/Write/MultiEdit tool calls -- structured unified
+        diffs, pre-edit file content, old/new string pairs) into the
+        dedicated ``file_edits`` index table on every ingest
+        (``storage/repository/archive/sessions.py::get_file_edits``), but
+        before this reader nothing above the storage layer could reach it.
+        This is the read surface: what a "what did this session change"
+        report needs instead of re-deriving edits from tool-call prose.
+
+        Returns ``None`` when the session does not exist (distinct from an
+        empty list, meaning the session exists but made no captured edits).
+        """
+        resolved = await self.repository.resolve_id(session_id)
+        resolved_id = str(resolved) if resolved is not None else session_id
+        session = await self.repository.get(resolved_id)
+        if session is None:
+            return None
+        edits = await self.repository.get_file_edits(resolved_id)
+        return [
+            {
+                "tool_use_block_id": edit.tool_use_block_id,
+                "message_id": str(edit.message_id),
+                "file_path": edit.file_path,
+                "structured_patch": edit.structured_patch,
+                "original_file": edit.original_file,
+                "old_string": edit.old_string,
+                "new_string": edit.new_string,
+                "replace_all": edit.replace_all,
+                "user_modified": edit.user_modified,
+                "observed_at_ms": edit.observed_at_ms,
+            }
+            for edit in edits
+        ]
+
+    async def get_agent_policies(self, session_id: str) -> list[dict[str, object]] | None:
+        """Return sandbox/approval/network policy facts recorded for one session.
+
+        polylogue-nua7: the writer diverts Codex ``agent_policy`` events out
+        of ``session_events`` into the dedicated ``session_agent_policies``
+        table (fully re-derivable, zero evidence loss -- see
+        ``archive_tiers/write.py:_SESSION_EVENTS_REDUNDANT_TYPES``), but
+        before this reader nothing above the storage layer could reach it
+        back. This is the read surface.
+
+        Returns ``None`` when the session does not exist (distinct from an
+        empty list, meaning the session exists but reported no agent-policy
+        facts -- expected for non-Codex origins).
+        """
+        resolved = await self.repository.resolve_id(session_id)
+        resolved_id = str(resolved) if resolved is not None else session_id
+        session = await self.repository.get(resolved_id)
+        if session is None:
+            return None
+        policies = await self.repository.get_agent_policies(resolved_id)
+        return [
+            {
+                "policy_id": policy.policy_id,
+                "position": policy.position,
+                "approval_policy": policy.approval_policy,
+                "sandbox_policy": policy.sandbox_policy,
+                "network_policy": policy.network_policy,
+                "observed_at_ms": policy.observed_at_ms,
+                "source_message_id": policy.source_message_id,
+            }
+            for policy in policies
+        ]
+
     async def query_sessions(
         self,
         *,

polylogue/archive/session/domain_models.py

@@ -49,6 +49,13 @@ class SessionSummary(SessionSummaryRuntimeMixin, BaseModel):
     git_branch: str | None = None
     git_repository_url: str | None = None
     provider_project_ref: str | None = None
+    # Provider-assigned human-readable session name distinct from the
+    # (possibly inferred) title -- e.g. Claude Code's "slug" wire field
+    # ("greedy-squishing-hamming"), captured but previously dropped before
+    # reaching any domain model (polylogue-cgfy: 1,500 sampled occurrences,
+    # the fix for subagent rows displaying "<uuid>:agent-<suffix>" instead
+    # of a human name).
+    display_name: str | None = None
     parent_id: SessionId | None = None
     branch_type: BranchType | None = None
     message_count: int | None = None
@@ -104,6 +111,8 @@ class Session(SessionRuntimeMixin, BaseModel):
     git_branch: str | None = None
     git_repository_url: str | None = None
     provider_project_ref: str | None = None
+    # See ``SessionSummary.display_name`` (polylogue-cgfy).
+    display_name: str | None = None
     session_events: tuple[SessionEvent, ...] = ()
     parent_id: SessionId | None = None
     branch_type: BranchType | None = None

polylogue/archive/session/domain_runtime.py

@@ -41,6 +41,7 @@ class SessionRuntimeMixin:
     metadata: dict[str, object]
     parent_id: SessionId | None
     branch_type: BranchType | None
+    display_name: str | None
 
     if TYPE_CHECKING:
 
@@ -73,6 +74,12 @@ def display_title(self) -> str:
             return user_title
         if self.title:
             return self.title
+        # polylogue-cgfy: provider-assigned display name (e.g. Claude Code's
+        # slug, "greedy-squishing-hamming") beats the raw id truncation --
+        # the fix for subagent rows showing "<uuid-prefix>" instead of a
+        # human-readable name when no title-worthy sidecar evidence exists.
+        if self.display_name:
+            return self.display_name
         return self.id[:8]
 
     @property

polylogue/archive/session/summary_runtime.py

@@ -28,6 +28,7 @@ class SessionSummaryRuntimeMixin:
     metadata: dict[str, object]
     parent_id: SessionId | None
     branch_type: BranchType | None
+    display_name: str | None
 
     @property
     def display_date(self) -> datetime | None:
@@ -40,6 +41,9 @@ def display_title(self) -> str:
             return user_title
         if self.title:
             return self.title
+        # polylogue-cgfy: see Session.display_title's twin fallback.
+        if self.display_name:
+            return self.display_name
         return self.id[:8]
 
     @property