spec - configuration_location

Katz0.190

Summary

An optional `.reqlan/config.json` may appear under a base's `.reqlan` directory.
For a given `.rq` file, the applying base is the nearest ancestor directory that owns a `.reqlan` folder.
The applying config is that base's `.reqlan/config.json` when present.
If the owning base has no `config.json`, or no owning base is found, defaults from configuration_import_roots apply.
A child base does not inherit a parent base's config.

Jump to outbound references

Jump to inbound references

Navigation

Source file

reqlan rq/extension/host/configuration.rq

community 1

community cluster

configuration.rq

file cluster

reqlan rq/extension/host

folder cluster

status: Not present

status cluster

tag: Not present

tag cluster

Printable page

Static print-friendly idea sheet.

Attributes

Key

Value

reqlan-path-resolve.ts, path_resolve.rs

config.test.ts:returns undefined when no config exists, config.test.ts:loads config from the owning base .reqlan, config.test.ts:loads config from an ancestor base, config.test.ts:nearest base config wins over farther ones, config.test.ts:owning base without config does not inherit parent, config.test.ts:resolveRqConfig uses defaults when no applying file exists, path-resolve.test.ts:loads importRoots list from nearest base config, path_resolve.rs:missing_import_roots_uses_default_alias, path_resolve.rs:relative_root_resolves_against_base

Browse all attributes

Ancestor context

No ancestor chain recorded.

Outbound references

Kind	Idea	Path	Snippet
references	configuration_import_roots	reqlan rq/extension/host/configuration.rq	configuration_import_roots
file_reference	"../../../packages/language/src/reqlan-path-resolve.ts"	packages/language/src/reqlan-path-resolve.ts	reqlan-path-resolve.ts
file_reference	"../../../crates/reqlan-index/src/path_resolve.rs"	crates/reqlan-index/src/path_resolve.rs	path_resolve.rs
file_reference	"../../../packages/language/test/config.test.ts:returns undefined when no config exists"	packages/language/test/config.test.ts	config.test.ts:returns undefined when no config exists
file_reference	"../../../packages/language/test/config.test.ts:loads config from the owning base .reqlan"	packages/language/test/config.test.ts	config.test.ts:loads config from the owning base .reqlan
file_reference	"../../../packages/language/test/config.test.ts:loads config from an ancestor base"	packages/language/test/config.test.ts	config.test.ts:loads config from an ancestor base
file_reference	"../../../packages/language/test/config.test.ts:nearest base config wins over farther ones"	packages/language/test/config.test.ts	config.test.ts:nearest base config wins over farther ones
file_reference	"../../../packages/language/test/config.test.ts:owning base without config does not inherit parent"	packages/language/test/config.test.ts	config.test.ts:owning base without config does not inherit parent
file_reference	"../../../packages/language/test/config.test.ts:resolveRqConfig uses defaults when no applying file exists"	packages/language/test/config.test.ts	config.test.ts:resolveRqConfig uses defaults when no applying file exists
file_reference	"../../../packages/language/test/path-resolve.test.ts:loads importRoots list from nearest base config"	packages/language/test/path-resolve.test.ts	path-resolve.test.ts:loads importRoots list from nearest base config
file_reference	"../../../crates/reqlan-index/src/path_resolve.rs:missing_import_roots_uses_default_alias"	crates/reqlan-index/src/path_resolve.rs	path_resolve.rs:missing_import_roots_uses_default_alias
file_reference	"../../../crates/reqlan-index/src/path_resolve.rs:relative_root_resolves_against_base"	crates/reqlan-index/src/path_resolve.rs	path_resolve.rs:relative_root_resolves_against_base
file_reference	../../../packages/language/src/reqlan-path-resolve.ts	packages/language/src/reqlan-path-resolve.ts	—
file_reference	../../../crates/reqlan-index/src/path_resolve.rs	crates/reqlan-index/src/path_resolve.rs	—
file_reference	../../../packages/language/test/config.test.ts:returns undefined when no config exists	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:loads config from the owning base .reqlan	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:loads config from an ancestor base	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:nearest base config wins over farther ones	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:owning base without config does not inherit parent	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:resolveRqConfig uses defaults when no applying file exists	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/path-resolve.test.ts:loads importRoots list from nearest base config	packages/language/test/path-resolve.test.ts	—
file_reference	../../../crates/reqlan-index/src/path_resolve.rs:missing_import_roots_uses_default_alias	crates/reqlan-index/src/path_resolve.rs	—
file_reference	../../../crates/reqlan-index/src/path_resolve.rs:relative_root_resolves_against_base	crates/reqlan-index/src/path_resolve.rs	—
file_reference	../../../packages/extension/schemas/config.schema.json	packages/extension/schemas/config.schema.json	—
file_reference	../../../packages/extension/package.json	packages/extension/package.json	—
file_reference	../../../crates/reqlan-index/src/ignore.rs	crates/reqlan-index/src/ignore.rs	—
file_reference	../../../site/scripts/sync-config-schema.mts	site/scripts/sync-config-schema.mts	—
file_reference	../../../packages/language/test/config.test.ts:unknown properties are ignored while known keys still apply	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:schema file documents importRoots mappings	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:schema $id matches public v1 host path	packages/language/test/config.test.ts	—
file_reference	../../../packages/analytical/src/core/defaults.json	packages/analytical/src/core/defaults.json	—
file_reference	../../../packages/language/src/file-path-rewrite.ts	packages/language/src/file-path-rewrite.ts	—
file_reference	../../../packages/language/src/reqlan-completion-provider.ts	packages/language/src/reqlan-completion-provider.ts	—
file_reference	../../../packages/language/src/reqlan-path-completion.ts	packages/language/src/reqlan-path-completion.ts	—
file_reference	../../../packages/language/src/reqlan-comment-diagnostics.ts	packages/language/src/reqlan-comment-diagnostics.ts	—
file_reference	../../../packages/extension/src/extension/comment-reference-path-context.ts	packages/extension/src/extension/comment-reference-path-context.ts	—
file_reference	../../../packages/extension/src/extension/register-comment-reference-links.ts	packages/extension/src/extension/register-comment-reference-links.ts	—
file_reference	../../../crates/reqlan-parse/src/path.rs	crates/reqlan-parse/src/path.rs	—
file_reference	../../../crates/reqlan-index/src/broken.rs	crates/reqlan-index/src/broken.rs	—
file_reference	../../../crates/reqlan-index/src/sync.rs	crates/reqlan-index/src/sync.rs	—
file_reference	../../../crates/reqlan-lsp/src/analysis.rs	crates/reqlan-lsp/src/analysis.rs	—
file_reference	../../../crates/reqlan-lsp/src/session.rs	crates/reqlan-lsp/src/session.rs	—
file_reference	../../../packages/language/test/config.test.ts:empty object uses default alias mapping	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:importRoots alias only overrides the alias	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:relative root resolves against the base root	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:absolute filesystem root is used directly	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:Windows drive-letter root is used as a file URI not scheme c:	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:file URI root is used directly	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:multiple importRoots map aliases to different roots	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:longest alias wins when mappings overlap	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:empty string alias entries are skipped	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:empty string root is ignored on a mapping	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:invalid importRoots entries are skipped	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:invalid JSON falls back to undefined load	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:non-object JSON falls back to undefined load	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:non-array importRoots falls back to undefined load	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:empty importRoots array uses default alias mapping	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:resolveRqConfig falls back to defaults when applying JSON is invalid	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:aliased path uses relative root from applying config	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/config.test.ts:aliased path uses workspace folder when root is omitted	packages/language/test/config.test.ts	—
file_reference	../../../packages/language/test/path-resolve.test.ts:resolves using config importRoots mapping	packages/language/test/path-resolve.test.ts	—
file_reference	../../../packages/language/test/path-resolve.test.ts:rewrite leaves aliased paths unchanged	packages/language/test/path-resolve.test.ts	—
file_reference	../../../packages/language/test/path-resolve.test.ts:toDirectoryUri does not parse a drive letter as a URI scheme	packages/language/test/path-resolve.test.ts	—
file_reference	../../../packages/language/test/completion.test.ts:completes import-root alias paths	packages/language/test/completion.test.ts	—
file_reference	../../../packages/language/test/comment-reference-resolution.test.ts:creates a document link for an import-root aliased comment reference	packages/language/test/comment-reference-resolution.test.ts	—
file_reference	../../../crates/reqlan-index/src/path_resolve.rs:locate_uses_import_roots_from_applying_config	crates/reqlan-index/src/path_resolve.rs	—
file_reference	../../../crates/reqlan-index/tests/broken_references.rs:check_honours_import_roots_from_applying_config	crates/reqlan-index/tests/broken_references.rs	—
file_reference	../../../crates/reqlan-lsp/tests/parity.rs:import_root_config_file_refs_match_check	crates/reqlan-lsp/tests/parity.rs	—
file_reference	../../../crates/reqlan-parse/src/path.rs:resolves_default_alias_against_workspace_folder	crates/reqlan-parse/src/path.rs	—
file_reference	../../../packages/analytical/src/core/rqignore.ts	packages/analytical/src/core/rqignore.ts	—
file_reference	../../../packages/analytical/src/core/application-memory.ts	packages/analytical/src/core/application-memory.ts	—
file_reference	../../../packages/analytical/src/core/create-base.ts	packages/analytical/src/core/create-base.ts	—
file_reference	../../../packages/analytical/src/core/base-discovery.ts	packages/analytical/src/core/base-discovery.ts	—
file_reference	../../../packages/analytical/src/index-store/workspace-index.ts	packages/analytical/src/index-store/workspace-index.ts	—
file_reference	../../../packages/analytical/test/rqignore.test.ts	packages/analytical/test/rqignore.test.ts	—
file_reference	../../../packages/analytical/test/rqignore.test.ts:inverse rqignore patterns opt binary files back in	packages/analytical/test/rqignore.test.ts	—
file_reference	../../../packages/analytical/test/create-base.test.ts:seeds .reqlan/.rqignore when creating a new base	packages/analytical/test/create-base.test.ts	—
file_reference	../../../packages/analytical/test/base-discovery.test.ts:skips node_modules and does not treat .reqlan as a walkable base root	packages/analytical/test/base-discovery.test.ts	—
file_reference	../../../packages/analytical/test/workspace-index.test.ts:skips .rq files under rqignore patterns	packages/analytical/test/workspace-index.test.ts	—
comment_link	configuration_location	reqlan rq/extension/host/crates/reqlan-index/src/path_resolve.rs	//! rq:configuration_location
comment_link	configuration_location	reqlan rq/extension/host/packages/language/src/reqlan-path-resolve.ts	* rq:configuration_location
comment_link	configuration_location	reqlan rq/extension/host/packages/language/test/config.test.ts	// rq:configuration_location
comment_link	configuration_location	reqlan rq/extension/host/packages/language/test/path-resolve.test.ts	// rq:configuration_location

Inbound references

Kind	Idea	Path	Snippet
references	base_configuration	reqlan rq/bases/base.rq	configuration_location
references	click_max_detail	reqlan rq/cli/click.rq	configuration_location
references	click_session_limit	reqlan rq/cli/click.rq	configuration_location
references	host_lifecycle	reqlan rq/extension/extension.rq	configuration_location
references	configuration_import_roots	reqlan rq/extension/host/configuration.rq	configuration_location
references	configuration_rqignore	reqlan rq/extension/host/configuration.rq	configuration_location
references	base_config_seed	reqlan rq/extension/host/installation.rq	configuration_location
references	configuration_import_root_alias	reqlan rq/language/imports.rq	configuration_location
references	configuration	reqlan rq/ontology.rq	configuration_location

Unresolved references

Kind	Idea	Path	Snippet
None

Local graph

Initialising graph…