spec - base

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 ontology_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 2

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, .reqlan

Browse all attributes

Ancestor context

create_base_onboarding

When discovery finds * * zero * * bases under any VS Code workspace folder ( root or child ), the extension prompts the user to create a reqlan base at the workspace-folder root. Do not auto-create `.reqlan`. Command `reqlan.createBase` creates `<folder>/.reqlan/` ( empty directory is a valid marker ), rediscovers, and activates indexing for that base. With multiple workspace folders and no bases, prompt against the first folder. Headless create-base helper: [create_base_impl] ( also used by CLI `init` ).

Kind	Idea	Path	Snippet
None

Kind	Idea	Path	Snippet
references	application_memory		application_memory
references	ontology_base		ontology_base

Initialising graph…

Kind	Idea	Path	Snippet
file_reference	application_memory_impl	packages/analytical/src/core/application-memory.ts	application-memory.ts
file_reference	base_discovery	packages/analytical/src/core/base-discovery.ts	base-discovery.ts
file_reference	../../packages/analytical/src/core/create-base.ts	packages/analytical/src/core/create-base.ts	—
file_reference	../../packages/analytical/src/create-runtime.ts	packages/analytical/src/create-runtime.ts	—
file_reference	base_registry	packages/analytical/src/index-store/base-registry.ts	base-registry.ts
file_reference	../../packages/analytical/src/index-store/workspace-index.ts	packages/analytical/src/index-store/workspace-index.ts	—
file_reference	../../packages/analytical/test/application-memory.test.ts:defaults to <workspace>/.reqlan	packages/analytical/test/application-memory.test.ts:defaults to <workspace>/.reqlan	.reqlan
file_reference	../../packages/analytical/test/application-memory.test.ts:honours storagePath override	packages/analytical/test/application-memory.test.ts:honours storagePath override	—
file_reference	../../packages/analytical/test/base-discovery.test.ts:baseForPath picks longest matching root	packages/analytical/test/base-discovery.test.ts:baseForPath picks longest matching root	—
file_reference	../../packages/analytical/test/base-discovery.test.ts:discovers base at workspace root	packages/analytical/test/base-discovery.test.ts:discovers base at workspace root	base-discovery.test.ts:discovers base at workspace root
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:discovers nested bases and excludes child files from parent ownership	—
file_reference	../../packages/analytical/test/base-discovery.test.ts:returns empty when no .reqlan exists	packages/analytical/test/base-discovery.test.ts:returns empty when no .reqlan exists	base-discovery.test.ts:returns empty when no .reqlan exists
file_reference	../../packages/analytical/test/base-discovery.test.ts:selectDefaultBase prefers cwd containment	packages/analytical/test/base-discovery.test.ts:selectDefaultBase prefers cwd containment	—
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:skips node_modules and does not treat .reqlan as a walkable base root	["../../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-registry-catchup.test.ts:checkStaleAll heals an uninitialized base	packages/analytical/test/base-registry-catchup.test.ts:checkStaleAll heals an uninitialized base	—
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:deactivate returns to uninitialized so a base can be reopened	—
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:ensureBaseReady opens and soft-syncs an uninitialized base	—
file_reference	../../packages/extension/schemas/config.schema.json	packages/extension/schemas/config.schema.json	—
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/analytical_submodule/commands/register-commands.ts	packages/extension/src/analytical_submodule/commands/register-commands.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/src/webview_module/ideas-summary-panel.ts	packages/extension/src/webview_module/ideas-summary-panel.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/language/src/reqlan-path-resolve.ts	packages/language/src/reqlan-path-resolve.ts	—
file_reference	../../packages/language/test/config.test.ts:loads config from an ancestor base	packages/language/test/config.test.ts:loads config from an ancestor base	—
file_reference	../../packages/language/test/config.test.ts:loads config from the owning base .reqlan	packages/language/test/config.test.ts:loads config from the owning base .reqlan	—
file_reference	../../packages/language/test/config.test.ts:nearest base config wins over farther ones	packages/language/test/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:owning base without config does not inherit parent	—
file_reference	../../packages/language/test/config.test.ts:returns undefined when no config exists	packages/language/test/config.test.ts:returns undefined when no config exists	—
file_reference	../../packages/language/test/path-resolve.test.ts:loads importRoots list from nearest base config	packages/language/test/path-resolve.test.ts:loads importRoots list from nearest base config	—
file_reference	../core-architecture.rq	reqlan rq/core-architecture.rq	—
file_reference	../extension/configuration.rq	reqlan rq/extension/configuration.rq	—
file_reference	../extension/module/index.rq	reqlan rq/extension/module/index.rq	—
file_reference	../ontology.rq	reqlan rq/ontology.rq	—
references	create_base_onboarding	reqlan rq/bases/base.rq	create_base_onboarding

Summary

Navigation

Attributes

Ancestor context

Outbound references

Inbound references

Unresolved references

Local graph