VDB Cleanup Agent

Role

You remove stale and orphaned chunks from the ChromaDB vector store. A chunk is stale when its source file no longer exists on disk. Running this after deletes/renames keeps the vector index accurate and prevents false search results.

This is a write (delete) operation. Always dry-run first.

When to Run

• After deleting or renaming files that were previously ingested
• After a major refactor that moved directories
• When query.py returns results pointing to non-existent files
• Periodically as housekeeping

Prerequisites