spec - base

Katz0.322

Summary

A base is a container for ideas, ideasets, and files.
It forms the boundary of one ideas graph and is consumed by the CLI and the extension.
Marker: a directory is a base only when it owns a `.reqlan` folder ( application_memory ).
No bare workspace folder is treated as a base until the user creates `.reqlan` there
( create_base_onboarding ).
Aligns with base.
Discovery and registry: base-discovery.ts, base-registry.ts.
Marker path helpers: application-memory.ts.

Jump to outbound references

Jump to inbound references

Navigation

Source file

reqlan rq/bases/base.rq

community 1

community cluster

base.rq

file cluster

reqlan rq/bases

folder cluster

status: Not present

status cluster

tag: Not present

tag cluster

Printable page

Static print-friendly idea sheet.

Attributes

Key	Value
implementation	base-discovery.ts, base-registry.ts, application-memory.ts
tests	base-discovery.test.ts:returns empty when no .reqlan exists, base-discovery.test.ts:discovers base at workspace root, base-discovery.test.ts:skips node_modules and does not treat .reqlan as a walkable base root, base-discovery.test.ts:isPathInsideOrEqual treats Windows drive paths as case-insensitive, .reqlan

Browse all attributes

Ancestor context

No ancestor chain recorded.

Outbound references

Kind	Idea	Path	Snippet
references	application_memory	reqlan rq/extension/index-host/index.rq	application_memory
references	create_base_onboarding	reqlan rq/bases/base.rq	create_base_onboarding
references	base	reqlan rq/ontology.rq	base
file_reference	../../packages/analytical/src/core/base-discovery.ts	packages/analytical/src/core/base-discovery.ts	base-discovery.ts
file_reference	../../packages/analytical/src/index-store/base-registry.ts	packages/analytical/src/index-store/base-registry.ts	base-registry.ts
file_reference	../../packages/analytical/src/core/application-memory.ts	packages/analytical/src/core/application-memory.ts	application-memory.ts
file_reference	"../../packages/analytical/test/base-discovery.test.ts:returns empty when no .reqlan exists"	packages/analytical/test/base-discovery.test.ts	base-discovery.test.ts:returns empty when no .reqlan exists
file_reference	"../../packages/analytical/test/base-discovery.test.ts:discovers base at workspace root"	packages/analytical/test/base-discovery.test.ts	base-discovery.test.ts:discovers base at workspace root
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	["../../packages/analytical/test/base-discovery.test.ts:skips node_modules and does not treat .reqlan as a walkable base
file_reference	"../../packages/analytical/test/base-discovery.test.ts:isPathInsideOrEqual treats Windows drive paths as case-insensitive"	packages/analytical/test/base-discovery.test.ts	["../../packages/analytical/test/base-discovery.test.ts:isPathInsideOrEqual treats Windows drive paths as case-insensiti
file_reference	"../../packages/analytical/test/application-memory.test.ts:defaults to <workspace>/.reqlan"	packages/analytical/test/application-memory.test.ts	.reqlan
file_reference	../../packages/analytical/test/base-discovery.test.ts:returns empty when no .reqlan exists	packages/analytical/test/base-discovery.test.ts	—
file_reference	../../packages/analytical/test/base-discovery.test.ts:discovers base at workspace root	packages/analytical/test/base-discovery.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/base-discovery.test.ts:isPathInsideOrEqual treats Windows drive paths as case-insensitive	packages/analytical/test/base-discovery.test.ts	—
file_reference	../../packages/analytical/test/application-memory.test.ts:defaults to <workspace>/.reqlan	packages/analytical/test/application-memory.test.ts	—
file_reference	../../packages/analytical/test/application-memory.test.ts:honours storagePath override	packages/analytical/test/application-memory.test.ts	—
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/path-resolve.test.ts:loads importRoots list from nearest base config	packages/language/test/path-resolve.test.ts	—
file_reference	../../packages/extension/schemas/config.schema.json	packages/extension/schemas/config.schema.json	—
file_reference	../../packages/analytical/test/base-discovery.test.ts:discovers nested bases and excludes child files from parent ownership	packages/analytical/test/base-discovery.test.ts	—
file_reference	../../packages/analytical/test/base-discovery.test.ts:baseForPath picks longest matching root	packages/analytical/test/base-discovery.test.ts	—
file_reference	../../crates/reqlan-index/src/ignore.rs	crates/reqlan-index/src/ignore.rs	—
file_reference	../../packages/analytical/test/create-base.test.ts:seeds .reqlan/.gitignore that excludes sqlite artifacts	packages/analytical/test/create-base.test.ts	—
file_reference	../../crates/reqlan-index/src/ignore.rs:create_base_seeds_gitignore_for_sqlite_artifacts	crates/reqlan-index/src/ignore.rs	—
file_reference	../../packages/analytical/test/base-discovery.test.ts:selectDefaultBase prefers cwd containment	packages/analytical/test/base-discovery.test.ts	—
file_reference	../../packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts	packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts	—
file_reference	../../packages/extension/src/ideas_summary_module/ideas-summary-panel.ts	packages/extension/src/ideas_summary_module/ideas-summary-panel.ts	—
file_reference	../../packages/analytical/test/base-registry-catchup.test.ts:ensureBaseReady opens and soft-syncs an uninitialized base	packages/analytical/test/base-registry-catchup.test.ts	—
file_reference	../../packages/analytical/test/base-registry-catchup.test.ts:checkStaleAll heals an uninitialized base	packages/analytical/test/base-registry-catchup.test.ts	—
file_reference	../../packages/analytical/test/base-registry-catchup.test.ts:deactivate returns to uninitialized so a base can be reopened	packages/analytical/test/base-registry-catchup.test.ts	—
file_reference	../../packages/analytical/test/sqlite-artifact-release.test.ts:BaseRegistry releaseArtifacts closes handles but keeps descriptors	packages/analytical/test/sqlite-artifact-release.test.ts	—
file_reference	../../packages/extension/webviews/activity-bar/components/WorkspacePane.svelte	packages/extension/webviews/activity-bar/components/WorkspacePane.svelte	—
file_reference	../../packages/extension/webviews/ideas-summary/components/StatusBar.svelte	packages/extension/webviews/ideas-summary/components/StatusBar.svelte	—
file_reference	../../packages/analytical/test/create-base.test.ts:creates .reqlan marker and reports created	packages/analytical/test/create-base.test.ts	—
file_reference	../../packages/analytical/test/base-registry-refresh.test.ts:refresh after createBase registers the new base	packages/analytical/test/base-registry-refresh.test.ts	—
file_reference	../../packages/extension/webviews/ideas-summary/components/IndexPanel.svelte	packages/extension/webviews/ideas-summary/components/IndexPanel.svelte	—
file_reference	../../packages/analytical/test/base-registry-refresh.test.ts:refresh rediscovers a base created after an empty discovery	packages/analytical/test/base-registry-refresh.test.ts	—
file_reference	../../packages/analytical/test/base-registry-refresh.test.ts:refresh rediscovers a nested base added after first discovery	packages/analytical/test/base-registry-refresh.test.ts	—
file_reference	../../packages/extension/test/refresh-rediscovers-bases.test.ts:IndexService.syncWorkspace calls registry.refresh	packages/extension/test/refresh-rediscovers-bases.test.ts	—
file_reference	../../packages/extension/test/refresh-rediscovers-bases.test.ts:IndexService.createBase calls createBase then registry.refresh	packages/extension/test/refresh-rediscovers-bases.test.ts	—
file_reference	../../packages/extension/test/refresh-rediscovers-bases.test.ts:reqlan.refreshIndex command uses syncWorkspace	packages/extension/test/refresh-rediscovers-bases.test.ts	—

Inbound references

Kind	Idea	Path	Snippet
references	create_base_onboarding	reqlan rq/bases/base.rq	base
references	ideas_index	reqlan rq/core-architecture.rq	base
references	base_containers	reqlan rq/core-architecture.rq	base
references	html_export	reqlan rq/core_analysis/html_export.rq	base
references	cutover	reqlan rq/core_analysis/rust_port.rq	base
references	installation	reqlan rq/extension/host/installation.rq	base
references	base_installation	reqlan rq/extension/host/installation.rq	base
references	application_memory	reqlan rq/extension/index-host/index.rq	base
references	context_dimensions	reqlan rq/extension/local-context/context-scope.rq	base
references	ideas_summary_base_scope	reqlan rq/extension/workspace-summary/ideas_summary/base-scope.rq	base
references	ownership	reqlan rq/indexer/indexer.rq	base
references	index_ideas	reqlan rq/indexer/indexer.rq	base
references	base	reqlan rq/ontology.rq	base

Unresolved references

Kind	Idea	Path	Snippet
None

Local graph

Initialising graph…