index_code_files

Katz 0.394

Index non- `.rq` source files that contain comment_reference ( `rq:idea` / `rq:idea` ).
The same directory scan records allowlisted text paths ( respecting `.rqignore`, binary_ignore, commentless_file_ignore, and nested child bases ).
Content reads use that list. They are not a second directory walk. text_prefix_skip skips non-text before a full read.
Binary files stay out unless a negation such as `!*.bin` opts them in.
The walk cheap-filters on `rq:`, and persists matching files as documents plus `comment_link` edges.
Edge shape: source = referenced idea, `target_file` = code file URI, kind `comment_link` ( no synthetic file ideas ).
Reindex of a `.rq` file updates kept ideas in place, so their comment links stay. Deletion of a removed idea cascades to its links.
Code documents are re-linked only when the set of idea names in that `.rq` file changes, because links resolve on names only.
A body edit must not read the code files again.
Watcher + idle stale check cover code documents as well as `.rq` files ( triggers, nonblocking_index ).
Consumers: file_related_requirements, file_search,
html_export_code_reference_pages, Ideas Summary comment-reference rows,
local graph ( idea → external file node ), click_code_file.
See index_comment_reference_inclusion, referenced_files.

implementation

comment.rs, sync.rs, store.rs, index-service.ts

status

done

tests

code_file_index.rs:indexes_comment_references_from_non_rq_files, code_file_index.rs:unqualified_comment_ref_matches_catalog_idea_name, code_file_index.rs:rq_reindex_restores_comment_links, code_file_index.rs:rq_reindex_relinks_code_files_only_when_idea_names_change, code_file_index.rs:index_one_file_drops_an_rqignored_rq_file, code_file_index.rs:skips_binary_comment_files_unless_rqignore_negation, file_context.rs:file_context_includes_indexed_comment_links, fuzzy_search.rs:workspace_index_fuzzy_search_includes_comment_code_files

Interactive page: index_code_files