feat(kb): edit + re-embed document summaries from the viewer (admin)

app/schemas.py

@@ -141,6 +141,40 @@ class DocContent(BaseModel):
     chunks: int
 
 
+class SummaryUpdate(BaseModel):
+    """``PATCH /api/documents/summary`` body (phase 57, task 01).
+
+    ``source`` / ``path`` name the indexed document (the same pair the
+    public ``GET /api/documents/content`` looks up); ``summary`` is the
+    raw new text. The API strips it before storing — an
+    empty/whitespace-only value is the *clear* operation (a first-class
+    action, phase 57 D4), not a 422. Unconstrained on purpose: unknown
+    pairs must 404 as "document not found" (row-lookup semantics),
+    exactly like the public content endpoint.
+    """
+
+    source: str
+    path: str
+    summary: str
+
+
+class SummaryResult(BaseModel):
+    """``PATCH /api/documents/summary`` response (phase 57, task 01).
+
+    ``summary`` is the stored text after the change (``null`` after a
+    clear — the viewer's summary box hides on null) and ``chunks`` the
+    document's post-change total chunk count: an update leaves the
+    content chunks untouched (the count is unchanged — only the single
+    ``is_summary`` chunk is replaced), a clear drops one (the
+    ``is_summary`` chunk is deleted).
+    """
+
+    source: str
+    path: str
+    summary: str | None
+    chunks: int
+
+
 class SteeringNoteIn(BaseModel):
     """``POST /api/steering`` body: one tuning instruction (phase 15).