Directory deletion not cascading to child file records in index

[huicheng-sys]

Summary

When a subdirectory containing source files is deleted from the project, CodeGraph fails to detect the change and does not update the SQLite index. The deleted files remain in the database, and index counts (files, nodes, edges) stay unchanged.

This appears to be a cascade deletion bug: removing a parent directory does not trigger removal of its child file records from the index.

Reproduction Steps

1. codegraph init — initialize index
2. Create nested source file: docs/1/2/新建文件夹/_0204_.py
3. Wait for CodeGraph to sync (check Last Sync timestamp)
4. Delete the subdirectory docs/1 (which contains _0204_.py)
5. Observe: index counts unchanged, deleted file still appears in queries

Attachment: Diagnostic Tool

I built a lightweight real-time monitor (codegraph_state.js) to visualize this bug. It displays live index counts alongside filesystem events, making the mismatch immediately obvious.

Author: feel free to use or adapt this tool for debugging.

codegraph_state.js

[colbymchenry]

Fixed in #1313 (merged to main, ships in the next release) — and thanks for the live-monitor tool, it made the failure mode easy to see.

One clarification on the mechanics: the database side was already cascading correctly — a manual codegraph sync removes a deleted directory's file records fine. The gap was the watcher: a directory deletion arrives from the OS as a single event on the directory's own path (often with no per-file events for the contents), and since that path has no source extension, the watcher discarded it before ever scheduling a sync. Your index then kept the child records until some unrelated edit happened to trigger one.

The watcher now treats a filtered path that has vanished from disk as a potential subtree removal and schedules the debounced sync; the sync's scan-diff removes whatever is gone. Events for non-source files that still exist stay fully ignored, so build churn doesn't schedule extra work.

Pinned by an end-to-end regression test (index → delete nested directory → watch event → child records gone).