spec - lsp_file_watch

Katz0.085

Summary

The language server must register workspace file watchers for `.rq` files only.
It must not register a recursive all-files watcher.
Watched-file events whose path contains a `node_modules`, `.git`, `.reqlan`, `out`, or `dist` segment must not start a document rebuild.
Directory URIs without a trailing slash, Windows paths, and percent-encoded URIs must use the same segment rules.
A kept `.rq` change replaces that buffer's model when the text changed ( ast_lifecycle ).
Related: language_server, index_file_search_coalesce, open_file_algorithm.

Jump to outbound references

Jump to inbound references

Navigation

Source file

reqlan rq/extension/language/support/initialisation-and-sequencing.rq

community 1

community cluster

initialisation-and-sequencing.rq

file cluster

reqlan rq/extension/language/support

folder cluster

status: done

status cluster

tag: Not present

tag cluster

Printable page

Static print-friendly idea sheet.

Attributes

Key	Value
implementation	reqlan-document-update-handler.ts, reqlan-module.ts
status	done
tests	document-update-watch.test.ts, document-update-watch.test.ts:registers .rq globs only, document-update-watch.test.ts:classifies Windows and directory URIs by path segment, document-update-watch.test.ts:drops noisy events and keeps .rq files, ast-lifecycle.test.ts:replaces the AST when this buffer text changes

Browse all attributes

Ancestor context

No ancestor chain recorded.

Outbound references

Kind	Idea	Path	Snippet
references	ast_lifecycle	reqlan rq/extension/language/support/open-file-sequencing.rq	ast_lifecycle
references	language_server	reqlan rq/core-architecture.rq	language_server
references	index_file_search_coalesce	reqlan rq/extension/language/support/initialisation-and-sequencing.rq	index_file_search_coalesce
references	open_file_algorithm	reqlan rq/extension/language/support/open-file-sequencing.rq	open_file_algorithm
file_reference	"../../../../packages/language/src/reqlan-document-update-handler.ts"	packages/language/src/reqlan-document-update-handler.ts	reqlan-document-update-handler.ts
file_reference	"../../../../packages/language/src/reqlan-module.ts"	packages/language/src/reqlan-module.ts	reqlan-module.ts
file_reference	"../../../../packages/language/test/document-update-watch.test.ts"	packages/language/test/document-update-watch.test.ts	document-update-watch.test.ts
file_reference	"../../../../packages/language/test/document-update-watch.test.ts:registers .rq globs only"	packages/language/test/document-update-watch.test.ts	document-update-watch.test.ts:registers .rq globs only
file_reference	"../../../../packages/language/test/document-update-watch.test.ts:classifies Windows and directory URIs by path segment"	packages/language/test/document-update-watch.test.ts	["../../../../packages/language/test/document-update-watch.test.ts:classifies Windows and directory URIs by path segment
file_reference	"../../../../packages/language/test/document-update-watch.test.ts:drops noisy events and keeps .rq files"	packages/language/test/document-update-watch.test.ts	document-update-watch.test.ts:drops noisy events and keeps .rq files
file_reference	"../../../../packages/language/test/ast-lifecycle.test.ts:replaces the AST when this buffer text changes"	packages/language/test/ast-lifecycle.test.ts	ast-lifecycle.test.ts:replaces the AST when this buffer text changes
file_reference	../../../../packages/language/src/reqlan-document-update-handler.ts	packages/language/src/reqlan-document-update-handler.ts	—
file_reference	../../../../packages/language/src/reqlan-module.ts	packages/language/src/reqlan-module.ts	—
file_reference	../../../../packages/language/test/document-update-watch.test.ts	packages/language/test/document-update-watch.test.ts	—
file_reference	../../../../packages/language/test/document-update-watch.test.ts:registers .rq globs only	packages/language/test/document-update-watch.test.ts	—
file_reference	../../../../packages/language/test/document-update-watch.test.ts:classifies Windows and directory URIs by path segment	packages/language/test/document-update-watch.test.ts	—
file_reference	../../../../packages/language/test/document-update-watch.test.ts:drops noisy events and keeps .rq files	packages/language/test/document-update-watch.test.ts	—
file_reference	../../../../packages/language/test/ast-lifecycle.test.ts:replaces the AST when this buffer text changes	packages/language/test/ast-lifecycle.test.ts	—
file_reference	../../../../packages/extension/src/shared/share-in-flight.ts	packages/extension/src/shared/share-in-flight.ts	—
file_reference	../../../../packages/extension/src/analytical_submodule/index-store/index-service.ts	packages/extension/src/analytical_submodule/index-store/index-service.ts	—
file_reference	../../../../packages/extension/test/share-in-flight.test.ts	packages/extension/test/share-in-flight.test.ts	—
comment_link	lsp_file_watch	reqlan rq/extension/language/support/packages/language/src/reqlan-document-update-handler.ts	* rq:lsp_file_watch
comment_link	lsp_file_watch	reqlan rq/extension/language/support/packages/language/test/document-update-watch.test.ts	* rq:lsp_file_watch

Inbound references

Kind	Idea	Path	Snippet
references	index_file_search_coalesce	reqlan rq/extension/language/support/initialisation-and-sequencing.rq	lsp_file_watch
references	ast_lifecycle	reqlan rq/extension/language/support/open-file-sequencing.rq	lsp_file_watch
references	file_crawl_sequence	reqlan rq/extension/language/support/open-file-sequencing.rq	lsp_file_watch

Unresolved references

Kind	Idea	Path	Snippet
None

Local graph

Initialising graph…