feat: Watch Mode with Auto-Sync

[gabrielmpetrescu]

Current State: Users must manually run aidocs rag-chunks and aidocs rag-vectors after editing documentation. Easy to forget, leading to stale embeddings.

Improvement: Add a aidocs watch docs/ command that monitors the docs directory for changes and automatically re-chunks modified files + regenerates their embeddings.

Implementation approach:

• Use watchdog library for file system monitoring
• Debounce changes (wait by default 10 seconds after last edit)
• Only process changed files (already supported via manifest hashing)
• Show real-time status in terminal with Rich

[binaryk]

@gabrielmpetrescu this is a quite expensive command if it generates vectors on the fly. vectors should be generated after the .md is reviewed.

[repothread]

Hi @binaryk — I run growth for RepoThread (https://www.repothread.com/), an AI documentation product for GitHub/GitLab/Bitbucket repos. I checked aidocs-cli and the overlap is strong, especially around repo-doc generation and keeping docs in sync. If useful, RepoThread recently added shareable AI-generated repo docs with stable URLs and 3 free public chapters. Happy to share a concise blurb/screenshots if you ever do a docs-tool comparison, roundup, or ecosystem page. No ask — just a relevant hello because the project looked adjacent.