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:
co-authored by
Claude Opus 4.8
parent
a03bc0af66
commit
b7479b0d07
@@ -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,
|
||||
|
||||
Reference in New Issue
Block a user