docs(review): correct reconcile docstring + clarify scanner rename comment

Round-2 review follow-ups (PR #857), both documentation-only:
- sharing_state.py: reconcile_document_path docstring no longer claims it
  returns False when no real points exist — it returns True and the set_payload
  is a Qdrant-side no-op (callers discard the return value).
- scanner.py: reword the rename-reconcile comment to state the precise reason
  (modified_at stable so not re-queued; path may be stale from a rename) rather
  than the loose "dedup miss / etag changed" phrasing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Chris Coutinho
2026-06-05 01:23:13 +02:00
co-authored by Claude Opus 4.8
parent a03bc0af66
commit b7479b0d07
2 changed files with 15 additions and 12 deletions
+10 -9
View File
@@ -590,15 +590,16 @@ async def scan_user_documents(
elif existing_metadata is not None and not existing_metadata.get(
"is_placeholder", False
):
# Unchanged content (not re-queued) but the file may have
# been renamed/moved: a rename keeps the fileid while
# changing the path, and the dedup miss here means the
# etag changed without a modified_at bump. Refresh the
# stale path/title metadata without re-embedding. No-op
# when the path is unchanged. Skip placeholders: reconcile
# only touches real chunks, so a not-yet-indexed file would
# just incur a 0-point set_payload (the real index writes
# the current path anyway).
# Reached only on the rename-with-stable-mtime path: a
# fresh modified_at would have set needs_indexing, and an
# etag dedup hit would have continued above -- so here the
# content wasn't re-queued (modified_at stable) yet the
# stored path may be stale from a rename/move (the fileid
# is unchanged). Refresh path/title without re-embedding;
# reconcile_document_path no-ops when the path matches.
# Skip placeholders: reconcile only touches real chunks, so
# a not-yet-indexed file would just incur a 0-point
# set_payload (the real index writes the current path).
try:
await reconcile_document_path(
file_id,