Attribute detail
implementation
350 ideas · 316 distinct values
![["../../site/scripts/generate-images.mjs"], ["../../site/public/logo.svg"], ["../../site/public/og.png"]](/spec/attributes/implementation.html?value=%5B%22..%2F..%2Fsite%2Fscripts%2Fgenerate-images.mjs%22%5D%2C+%5B%22..%2F..%2Fsite%2Fpublic%2Flogo.svg%22%5D%2C+%5B%22..%2F..%2Fsite%2Fpublic%2Fog.png%22%5D){kind=link}
![["../../site/src/content/meta.ts"], ["../../site/src/lib/site-metadata.ts"], ["../../site/src/app/layout.tsx"], ["../../site/scripts/generate-images.mjs"], ["../../site/public/og.png"]](/spec/attributes/implementation.html?value=%5B%22..%2F..%2Fsite%2Fsrc%2Fcontent%2Fmeta.ts%22%5D%2C+%5B%22..%2F..%2Fsite%2Fsrc%2Flib%2Fsite-metadata.ts%22%5D%2C+%5B%22..%2F..%2Fsite%2Fsrc%2Fapp%2Flayout.tsx%22%5D%2C+%5B%22..%2F..%2Fsite%2Fscripts%2Fgenerate-images.mjs%22%5D%2C+%5B%22..%2F..%2Fsite%2Fpublic%2Fog.png%22%5D){kind=link}
| Idea | Value | Status | Tags | Summary | Katz |
|---|---|---|---|---|---|
| active_base_switch | [editor_index_adapter], [base_registry], [workspace_index], ["../../packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts"], ["../../packages/extension/src/ideas_summary_module/ideas-summary-panel.ts"], ["../extension/local-context/activitybar-panels/workspace.rq".workspace_base_picker], ["../extension/workspace-summary/ideas_summary/base-scope.rq".ideas_summary_base_scope], ["../extension/index-host/sqlite-artifact-lifecycle.rq".sqlite_artifact_lifecycle] | done | Changing the active base is a **pointer swap** onto a per-base `WorkspaceIndex` / store. - Do **not** await soft-sync, hard-rebuild, or a full `.rq` walk on the switch call itself. - Host surfaces rebind views to the newly active store ( status snapshot, tables, context panes ) immediately. - If the selected base is not yet ready, show its readiness / progress and **schedule** the normal activate catch-up ( open if needed, then one soft sync ) fire-and-forget — same path as ["../indexer/indexer.rq".triggers] / ["../extension/index-host/graph-analysers.rq".indexing_trigger_open], not a special switcher rebuild. - Idle staleness checks only touch bases that are already open; they must not reopen every discovered base ( ["../extension/index-host/sqlite-artifact-lifecycle.rq".release_when_idle] ). - Open failures stay isolated per base so one bad base cannot leave siblings stranded in `uninitialized`. - Editor-follow must not overwrite a user pin on the same refresh that applies the selection. - Inactive bases release SQLite artifacts when the active pointer moves away ( ["../extension/index-host/sqlite-artifact-lifecycle.rq".sqlite_artifact_lifecycle] ). Surfaces: activity bar ["../extension/local-context/activitybar-panels/workspace.rq".workspace_base_picker], Ideas Summary ["../extension/workspace-summary/ideas_summary/base-scope.rq".ideas_summary_base_scope]. Implemented by [editor_index_adapter] ( `setActiveBaseId` / `scheduleBaseCatchUp` ); engine: [base_registry] `ensureBaseReady` / `releaseArtifacts`, [workspace_index] `ensureReady` / `deactivate`. | 0.093 | |
| base | [base_discovery], [base_registry], [application_memory_impl] | 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 ( [app_memory_doc.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], [base_registry]. Marker path helpers: [application_memory_impl]. | 0.322 | ||
| base_configuration | [path_resolve] | Base configuration is distinct from, but related to, [extension_configuration]. Optional settings live at `<base>/.reqlan/config.json` ( one config per base ). For an `.rq` file, the applying base is the nearest ancestor that owns `.reqlan`; that base's config applies when present. See [extension_configuration.configuration_location]; resolved by [path_resolve]. | 0.087 | ||
| base_configuration_provider | [application_memory_impl], [path_resolve], ["../../packages/extension/schemas/config.schema.json"] | Base-level settings live at `<base>/.reqlan/config.json`. Extension-level settings remain VS Code configuration for the product host. | 0.040 | ||
| base_initialisation_ignore | [create_base_impl], ["../../packages/analytical/src/core/application-memory.ts"], ["../../crates/reqlan-index/src/ignore.rs"] | done | New bases seed `<base>/.reqlan/.gitignore` so Git does not track SQLite application-memory files. Patterns cover the ideas index ( [base_ownership] ), the diagnostics store ( [app_memory_doc.index_diagnostics_store] ), and SQLite sidecars ( `*.sqlite`, `*.sqlite-journal`, `*.sqlite-shm`, `*.sqlite-wal` ). This file is Git ignore for `.reqlan/`. Path filters for discovery stay in `.rqignore` ( [extension_configuration.configuration_rqignore] / [app_memory_doc.rqignore] ). Written by [create_base_impl] as part of [base_initialisation] / ["../extension/host/installation.rq".base_installation]. | 0.182 | |
| base_nesting | [base_discovery], [base_registry] | Bases may nest: any subdirectory that owns its own `.reqlan` is a child base. Parent-base indexing includes only `.rq` files under the parent root that are **not** under any child base root ( [base_discovery] ownership exclusion ). Nested bases appear as siblings in the multi-base registry; the longest-matching base root wins for a given file path ( [implied_context] ). | 0.060 | ||
| base_ownership | [application_memory_impl], [workspace_index], [base_registry] | Each base holds its own [ideas_index] store under `<base>/.reqlan/ideas-index.sqlite`. Path keys inside the index are relative to that base root, not the VS Code workspace root. Store path: [application_memory_impl]; per-base engine: [workspace_index] via [base_registry]. | 0.112 | ||
| create_base_onboarding | [create_base_impl], [editor_index_adapter], [base_registry], [register_commands], ["../../packages/extension/webviews/activity-bar/components/WorkspacePane.svelte"], ["../../packages/extension/webviews/ideas-summary/components/StatusBar.svelte"] | 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 ) via [create_base_impl], then calls [base_registry] `refresh` so the new marker is registered and the returned [base] descriptor matches discovery ( [refresh_rediscovers_bases] ). With multiple workspace folders and no bases, prompt against the first folder. Headless create-base helper: [create_base_impl] ( also used by CLI `init` ). | 0.172 | ||
| implied_context | [base_discovery], [editor_index_adapter] | The **active base** for editor-adjacent surfaces is the longest-matching base root that contains the focused file path. When no file is focused, the last selected base ( Ideas Summary switcher / activity bar ) or the first discovered base is used. Context, local graph, and analysers bind to the active base's index — not a merged global graph. User / explicit pin is a pointer swap only — [active_base_switch]. Core selection: [base_discovery] ( `baseForPath` / `selectDefaultBase` ); editor pin / switch: [editor_index_adapter]. | 0.075 | ||
| multi_base_environment | [base_registry], [base_discovery], [editor_index_adapter], [analysis_runtime] | Analytical features are multibase aware via [base_registry]: one [ideas_index] / `WorkspaceIndex` per base, isolated catalogs ( no cross-base idea-id collision ). Surfaces list all discovered bases; Ideas Summary and context panes scope to the active / selected base ( [active_base_switch] ). Cross-base reference resolution and merged graphs are out of scope for the first multi-base pass. Headless ( CLI / MCP ) selects one base via [analysis_runtime]; the editor hosts [editor_index_adapter]. | 0.134 | ||
| refresh_rediscovers_bases | [base_registry], [editor_index_adapter], [register_commands], ["../../packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts"], ["../../packages/extension/src/ideas_summary_module/ideas-summary-panel.ts"], ["../../packages/extension/webviews/activity-bar/components/WorkspacePane.svelte"], ["../../packages/extension/webviews/ideas-summary/components/IndexPanel.svelte"] | done | Manual Refresh ( command `reqlan.refreshIndex`, activity-bar / Ideas Summary Refresh buttons ) and Clear & rebuild must **always rediscover** `.reqlan` markers under workspace roots before soft-sync or rebuild. Do not skip discovery when bases are already registered — a new nested or sibling base created on disk must appear after Refresh. Discovery and registration live in [base_registry] ( `refresh` → `rediscover` → optional `ensureBaseReady` for the active base ). The extension adapter ( [editor_index_adapter] ) calls that analytical API; it must not invent a parallel discovery walk. Create Base follows the same refresh path after [create_base_impl] so the new marker is visible immediately ( [create_base_onboarding] ). Related: [multi_base_environment], ["../extension/index-host/graph-analysers.rq".indexing_trigger_manual], ["../extension/index-host/sqlite-artifact-lifecycle.rq".event_driven_base_access]. | 0.075 | |
| init | ["../../packages/analytical/src/core/create-base.ts"], ["../../packages/cli/src/commands/init.ts"], ["../../packages/extension/src/analytical_submodule/index-store/index-service.ts"] | done | The cli should be able to initialise a new [base]. Creates `<path>/.reqlan/` ( empty directory is a valid marker ), matching [create_base_onboarding]. Headless helper lives in `@reqlan/analytical` so CLI and extension share one create-base path. | 0.162 | |
| pnpm_extra_args | ["../../packages/cli/src/argv.ts"], ["../../packages/cli/src/main.ts"] | done | `pnpm run <script> -- <flags>` inserts a lone `--` between the script body and the extra flags. Clipanion treats `--` as end of options, so `reqlan check -- --skip-target glob` reads `--skip-target` as a command and fails. The CLI drops lone `--` tokens from argv before Clipanion runs, so package-manager extra args stay flags. Related: [commands] ["../core_analysis/check.rq".check_meta_implementation] | 0.142 | |
| windows_esm_entry | ["../../packages/cli/bin/cli.js"], ["../../packages/cli/src/esm-path.ts"], ["../../packages/mcp/bin/mcp.js"] | done | Node's ESM loader on Windows requires `file://` URLs for absolute dynamic `import()`. A native path such as `C:\...\out\main.js` is read as protocol `c:` and crashes every command, including `init`. `bin/cli.js` converts the compiled entry with `fsPathToEsmSpecifier` ( `pathToFileURL` ). The MCP stdio entry ["../../packages/mcp/bin/mcp.js"] uses the same `pathToFileURL` conversion. | 0.083 | |
| agent_advisory | [mcp_server], [click_cli], [native_analysis_api] | done | Agents must pass the [click_session] ID ( `sessionKey` ) to the next click action. This keeps one agent thread on the same session so a revisit can expand connected content and so ranking can use session distance. MCP tool text states this rule and the unique / ambiguous / search paths clearly ( [mcp_server] `click` ). | 0.101 | |
| click | [click_rust], [click_sessions_rust], [native_analysis_api], [click_cli], [mcp_server], ["../../crates/reqlan-napi/src/lib.rs"] | done | The [click_ontology] function returns compact local context for one target. Input: an idea name, a `path#idea` ref, a `.rq` file path, or an indexed code file ( [click_input], [click_code_file] ). Resolution uses [click_ambiguity]: no match uses search; more than one match is ranked; one match uses [click_output]. Optional [click_max_detail] flags cap how many names and bodies are listed. Optional `sessionKey` continues a [click_session]. A second click on a centre already clicked in that session returns the connected content ( [click_session] ). Surfaces: CLI `reqlan click` ( [click_cli] ), MCP `click` ( [mcp_server] ), and [native_analysis_api] `click`. MCP search and retrieval use this tool only ( ["../extension/agent/skills-and-mcp.rq".mcp_click_retrieval] ). Engine: [click_rust] on ["./cli_package.rq".architecture] / ["../core_analysis/rust_port.rq".analytical_rust_port]. Related: [function_parity], [commands], [agent_advisory], [click_session], [click_input], [click_max_detail], [click_output]. | 0.200 | |
| click_ambiguity | [click_rust], ["../../crates/reqlan-napi/src/lib.rs"], [native_analysis_api] | done | Engine function that classifies a name or target as none, unique, or ambiguous. A name is ambiguous when more than one indexed idea or indexed file shares that exact name. Names are unique inside one file ( [idea_name] ); ambiguity is across files. `path#idea` and a full indexed path are unique when that record exists. Click uses this function to choose the [click_input] path and to decide when [click_output] prints a file path next to a name. Outbound [wildcard_reference] targets are ambiguous: print their matching paths. Surfaces: AnalysisApi `checkNameAmbiguity` ( engine ). Click must call it. CLI / MCP exposure is not required. | 0.103 | |
| click_code_file | [click_rust], [index_code_files] | done | An indexed code file is a first-class click target ( [index_code_files], [referenced_files] ). Click accepts the same path forms as [file_search] ( relative path, basename when unique ). Unique output for a code file: - the file path ( no idea body ) - count and names of backlinks: ideas with a [file_reference] to this file; print the idea file when the name is ambiguous - count and names of [comment_reference] targets ( `comment_link` from this file ); print the idea file when the name is ambiguous - siblings do not apply Data is the same indexed edges as [file_related_requirements]. | 0.195 | |
| click_input | [click_rust], ["../../crates/reqlan-search/src/contextual.rs"], ["../../crates/reqlan-search/src/fuzzy.rs"] | done | Accept any of: - idea name ( trimmed optional surrounding brackets `[name]` ) - `path#idea` ( indexed file URI + idea name ) — this form is unique - `.rq` file path — the file is one centre, not every idea in the file - indexed code file path ( [click_code_file] ) Resolution uses [click_ambiguity] after the same ref normalisation as ( ["../core_analysis/search.rq".contextual_search] / `resolve_search_context_refs` ). When no centre matches, click uses [fuzzy_search] ( and [file_search] ) with the target as the query and returns those hits. Do not return an empty slice. When more than one centre matches, and the [click_session] already has ideas, rank the matches by undirected hop distance from those ideas ( [idea_graph_distance] / [contextual_search] ). Nearer ranks first. Put the hop count on each candidate. When there is no session key, or the session has no ideas yet, do not calculate hop distance. Do not print hops. Rank by name and file path. On the search path, rank by [fuzzy_search] score only. When exactly one centre matches, return [click_output]. Always return or create a [click_session] key. | 0.156 | |
| click_max_detail | [click_rust], [click_cli], [mcp_server], ["../../packages/analytical/src/core/defaults.json"], ["../../packages/extension/schemas/config.schema.json"], ["../../crates/reqlan-index/src/path_resolve.rs"], ["../../packages/language/src/reqlan-path-resolve.ts"] | done | Flags that cap how many names and bodies click lists. Invalid or missing values use the default. Values less than 1 use 1. Defaults live in `.reqlan/config.json` under `click` ( [configuration_location], [configuration_schema_file] ). CLI and MCP flags override config. - `maxBacklinks` / `--max-backlinks` / `click.maxBacklinks` — first n backlink names in [click_output], then " + m more ". - `maxSiblings` / `--max-siblings` / `click.maxSiblings` — first n sibling names, then " + m more ". - `maxOutbound` / `--max-outbound` / `click.maxOutbound` — first n outbound names or paths, then " + m more ". - `maxCandidates` / `--max-candidates` / `click.maxCandidates` — search hits and ranked ambiguous matches. The default for each list is `click.listLimit` in ["../../packages/analytical/src/core/defaults.json"]. `maxDetail` / `--max-detail` is the old hop-depth for a neighbourhood dump. Unique [click_output] does not use hop depth. The flag is still accepted and ignored on the unique path. | 0.122 | |
| click_output | [click_rust], ["../../crates/reqlan-analytical/src/types.rs"], [native_analysis_api] | done | The result always includes `sessionKey` ( [agent_advisory] ). The result does not include an `edges` list. Links are implied by the lists below. Shape depends on [click_input]: Unique ( one centre ): - the idea ( or file ) and its content ( indexed unmarked body / summary ) - count of outbound links from that content only: idea refs and [file_reference] that occur in the unmarked body. Do not list refs that occur only in `@tests`, `@implementation`, or `@todo`. Do not list [comment_reference] code files as outbound. List names. When [click_ambiguity] says the name is ambiguous, print the file path with the name. File names are unquoted basenames. - count of backlinks and the first n names ( [click_max_detail] ); print the file when the name is ambiguous or shared; then " + m more " for the remainder - count of siblings ( same [ideaset] / file ), not the ideas named in the content, and the first n names, with file when the name is ambiguous or shared - for a code-file centre, see [click_code_file] Ambiguous ( more than one match ): ranked candidate names with file paths. Include hop distance only when the session has prior ideas. No idea bodies. Cap with `maxCandidates`. Search ( no exact match ): [fuzzy_search] / [file_search] hits. Cap with `maxCandidates`. Revisit: see [click_session]. Show content of the connected nodes, not the centre body again. | 0.117 | |
| click_session | [click_sessions_rust], [click_rust], ["../../packages/analytical/src/core/application-memory.ts"], ["../../crates/reqlan-index/src/ignore.rs"] | done | Click sessions live in SQLite under [application_memory] as `click-sessions.sqlite` ( sibling of `ideas-index.sqlite`; not deleted by ideas-index rebuild ). Each session has a stable `sessionKey`. Sessions are keyed against ideas. Each surfaced idea stores a fingerprint of its name, summary, status, and tags. When that fingerprint changes, the idea may resurface on the next click. Record clicked centres ( unique or revisit targets ) separately from names that were only listed. When the target is a centre already clicked in this session, return the content of the connected nodes ( outbound, backlinks, and siblings that the first click listed ), capped by [click_max_detail]. Do not repeat the centre body. Do not return an empty suppressed slice. Skip a connected body that this session already showed as content, unless its fingerprint changed. Session cache size is [click_session_limit]. Eviction uses last-touched order: when the store exceeds the limit, drop the least recently touched sessions first. Touch the active session on every successful click. Path helper: ["../../packages/analytical/src/core/application-memory.ts"] / [click_sessions_rust]. Layout: ["../indexer/sidecars.rq".reqlan_directory_layout]. | 0.225 | |
| click_session_limit | ["../../packages/analytical/src/core/defaults.json"], ["../../packages/extension/schemas/config.schema.json"], ["../../crates/reqlan-index/src/path_resolve.rs"], ["../../packages/language/src/reqlan-path-resolve.ts"], [click_sessions_rust], [click_rust] | done | Maximum stored click sessions per base is `click.maxSessions` in ["../../packages/analytical/src/core/defaults.json"]. Configure with `click.maxSessions` in `.reqlan/config.json` ( [configuration_location], [configuration_schema_file] ). Invalid or missing values use that default. Values below `click.minimum` use `click.minimum`. Eviction is by session count and last-touched time ( [click_session] ). Count caps for one click result are [click_max_detail], not this limit. | 0.070 | |
| diff | ["../../crates/reqlan-analytical/src/diff.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../crates/reqlan-napi/src/lib.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"], ["../../packages/cli/src/commands/diff.ts"], ["../../packages/mcp/src/server.ts"] | done | Compare ideas in two git snapshots. The key is the file path plus the [idea_name]. The command reads `.rq` files from git and parses each snapshot. It does not read or write the ideas index. Line position does not count. The same body and attributes at a different line are unchanged. Content is the idea body plus its attributes. Change kinds: - created — the key exists only on the right snapshot - deleted — the key exists only on the left snapshot - modified — the key exists on both snapshots and the content differs - moved — the name exists in exactly one file on each side, the paths differ, and the content is the same The same name in more than one file on one side stays on the path-plus-name key. A renamed idea is deleted plus created. Unchanged ideas are omitted. A reference-only edit stays modified. No arguments: if any `.rq` path is staged, unstaged, or untracked and not gitignored, the left side is `HEAD` and the right side is that pending snapshot. Otherwise the left side is `HEAD~1` and the right side is `HEAD`. A non- `.rq` change does not select the pending snapshot. One argument: that revision against `HEAD`. Two arguments: the first revision against the second. A target is a branch, a commit, `HEAD`, `~N` ( `HEAD~N` ), or `<rev>~N`. The pending snapshot uses the working-tree file for an unstaged edit, the index blob when the working tree matches `HEAD`, and the working-tree file when a path is both staged and unstaged. An untracked `.rq` file that git does not ignore is included. If `HEAD` has no parent, the left snapshot is empty and every idea on `HEAD` is created. A missing revision or a directory that is not a git repository is an error. Exit status is 2. A successful diff exits 0, including an empty diff. When a side is filled by a default, the human CLI and [diff_webview] print a header `Comparing <from> -> <to>` before the rows. Explicit two-argument runs omit that header. `--json` and MCP stay a row array only. Surfaces: CLI `reqlan diff` ( [commands] ), MCP [skills_and_mcp.mcp_diff], and [diff_webview]. Engine: ["../../crates/reqlan-analytical/src/diff.rs"]. Git spawns stay hidden ( [consumption_silence] ). Related: [architecture] [function_parity] [idea] [idea_reference] [diff_verbosity] [diff_cli_color] | 0.163 | |
| diff_cli_color | ["../../packages/cli/src/format-diff.ts"], ["../../packages/cli/src/commands/diff.ts"] | done | Color the human text when stdout is a terminal and `NO_COLOR` is unset. `--color` forces color. `--no-color` forces plain text. `--json` is never colored. Created and added lines are green. Deleted and removed lines are red. Modified is yellow. Moved is cyan. | 0.061 | |
| diff_verbosity | ["../../crates/reqlan-analytical/src/diff.rs"], ["../../packages/cli/src/format-diff.ts"], ["../../packages/mcp/src/server.ts"], ["../../packages/extension/src/index_host_module/diff/diff-row-model.ts"] | done | Three levels. The default is summary. CLI: `--verbosity summary|references|text`, or `-v` / `-vv`. MCP and [diff_webview] use the same three values. - summary — change kind, idea name, and file. `fromFile` only for moved. - references — summary, plus [idea_reference] targets added on the right and removed from the left. Order each list by name. Omit a target that is on both sides. - text — summary, plus the body and attributes before and after. Created shows the right side. Deleted shows the left side. Modified shows both. Moved has no text change. Do not list reference names at this level. Attributes stay inside modified. The references level does not print attribute text. The text level prints body lines, then attribute lines as `@name` / `@name value`. `--json` omits `references` and `text` at summary. It adds `references` at references only. It adds `text` at text only. | 0.071 | |
| diff_webview | ["../../packages/extension/src/index_host_module/diff/diff-panel.ts"], ["../../packages/extension/src/index_host_module/diff/diff-row-model.ts"], ["../../packages/extension/src/index_host_module/diff/register-diff.ts"], ["../../packages/extension/package.json"] | done | Command palette title Diff Ideas, category reqlan, id `reqlan.diffIdeas` ( [features_commands.command_palette] ). The panel takes the same two targets and the same verbosity as [diff]. Controls sit in a sticky themed strip: From, To, Detail, Diff. Inputs and the primary button use editor input and button theme tokens. Enter in a control runs Diff. The panel runs once on open with empty targets. Each row uses the editor git decoration colors for created, deleted, and modified, and a distinct color for moved. A row shows kind, idea name, and path as separate fields. Moved shows both paths. The references level lists added and removed reference names. The text level shows monospaced before and after body blocks; modified uses a two-column layout when width allows. Empty results say there are no idea changes. Errors use validation theme colors. Diffing disables the Diff control and shows a loading status. The panel calls the shared engine. It does not parse git output. When a side uses a default, the panel shows the same `Comparing <from> -> <to>` header as the CLI under the strip. | 0.083 | |
| derived_host_bindings | ["../../packages/extension/webviews/ideas-summary/components/IdeasetsTable.svelte"], ["../../packages/extension/webviews/activity-bar/components/ReferenceListsPane.svelte"] | done | Components that display host-driven AppState fields must bind through Svelte 5 `$derived` / `$derived.by` ( not legacy `$:` ) so updates from the message listener re-render reliably. Keep ephemeral widget-only UI ( open menus, local filter drafts, selection ) as component-local `$state`. Do not mirror host payloads into a second parallel store inside the component. | 0.040 | |
| host_webview_ownership | ["../../packages/extension/src/activity_bar_module/activity-bar-messages.ts"], ["../../packages/extension/src/ideas_summary_module/shared/messages.ts"], ["../../packages/extension/src/activity_bar_module/context-session.ts"], ["../../packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts"], ["../../packages/extension/src/ideas_summary_module/ideas-summary-panel.ts"] | done | The extension host owns durable data, index / analysis queries, and VS Code APIs. The webview owns presentation state and posts intents ( search, navigate, persist UI prefs, export ). Host session objects ( e. g. activity-bar context session ) mutate on the host and push snapshots to the webview; the webview must not invent a second source of truth for the same domain fields. Typed message modules define the contract; keep request ids / error scopes on async host calls. | 0.050 | |
| imperative_view_controllers | ["../../packages/extension/webviews/shared/graph/graph-cy-controller.ts"], ["../../packages/extension/webviews/ideas-summary/state/app.svelte.ts"] | done | Heavy imperative widgets ( Cytoscape graph ) keep lifecycle state on a controller class ( `GraphCyController` ), not inside AppState `$state` fields. AppState holds query / slice / loading / error and persisted UI prefs; the component holds the controller instance. See ["../extension/presentation/graph.rq".webview_threading] and ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".graph_loading]. | 0.040 | |
| persistence_tiers | ["../../packages/extension/src/ideas_summary_module/shared/graph-ui-state.ts"], ["../../packages/extension/src/ideas_summary_module/shared/table-ui-state.ts"], ["../../packages/extension/src/extension/onboarding-state.ts"], ["../../packages/extension/webviews/activity-bar/lib/vscode.ts"], ["../../packages/extension/webviews/ideas-summary/lib/vscode.ts"] | done | Three persistence tiers — pick the shallowest that matches lifetime: 1. `acquireVsCodeApi().getState` / `setState` — ephemeral webview session ( pane expand / heights, active tab ). 2. `ExtensionContext.workspaceState` — durable UI prefs shared across reloads ( graph / table UI keys under `reqlan.ideasSummary.*`, optionally per-base ). Normalize + default on read ( `normalizeGraphUiState` / table defaults ); never trust raw JSON shape. 3. `ExtensionContext.globalState` — install / user-level flags ( e. g. onboarding ), not pane view-models. Debounce persist posts ( ~ 200 – 250 ms ) when UI controls churn. Related: [webview_app_state]. | 0.050 | |
| postmessage_clone_safety | ["../../packages/extension/webviews/activity-bar/lib/vscode.ts"], ["../../packages/extension/webviews/ideas-summary/lib/vscode.ts"] | done | Before `postMessage` from a Svelte webview, JSON-clone payloads ( `JSON.parse(JSON.stringify(...))` ) so `$state` proxies remain structured-clone safe. Shared helpers live in each webview's `lib/vscode.ts`. | 0.040 | |
| svelte_app_context | ["../../packages/extension/webviews/activity-bar/state/context.ts"], ["../../packages/extension/webviews/ideas-summary/state/context.ts"] | done | Webview components read AppState through Svelte context helpers ( `setAppContext` / `getApp` with a `Symbol` key ) in `state/context.ts` — not by importing the singleton from deep child leaves when a context is available. Root `App.svelte` sets context once after constructing / using `app`. | 0.049 | |
| ui_state_management | ["../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../packages/extension/webviews/ideas-summary/state/app.svelte.ts"], ["../../packages/extension/src/ideas_summary_module/shared/graph-ui-state.ts"], ["../../packages/extension/src/ideas_summary_module/shared/table-ui-state.ts"], ["../../packages/extension/src/activity_bar_module/context-session.ts"] | done | Extension UI state is explicit, typed, and layered — not a single global store shared across host and webview. Choose the layer by lifetime and owner: - Host session / durable prefs live in the extension process ( `ExtensionContext`, plain modules ). - Webview view-models live in Svelte 5 runes ( `$state` / `$derived` / `$effect` ). - Cross-boundary traffic uses typed `postMessage` contracts only. Prefer small state machines ( named phases, request ids, clear transitions ) over ad-hoc flags. Related: [webview_app_state], [persistence_tiers], [zustand_boundary], [host_webview_ownership]. | 0.080 | |
| webview_app_state | ["../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../packages/extension/webviews/ideas-summary/state/app.svelte.ts"], ["../../packages/extension/webviews/export-form/App.svelte"], ["../../packages/extension/webviews/onboarding/App.svelte"], ["../../packages/extension/webviews/index-diagnostics/App.svelte"] | done | Complex webviews ( activity bar, Ideas Summary ) own a single `AppState` class in `state/app.svelte.ts`. Fields that drive UI are Svelte 5 `$state` properties on that class; side effects and host I / O are methods. Export one module singleton ( `export const app = new AppState()` ) and inject it via [svelte_app_context]. Do not use `svelte/store` writable / readable stores for new UI, and do not put zustand inside webview code ( [zustand_boundary] ). Simple panels ( export form, onboarding, index diagnostics ) may keep `$state` on the root `App.svelte` instead of a separate AppState module when the surface is a single form / flow. Related: ["../extension/workspace-summary/ideas_summary/webview.rq".table_column_filters] `$derived` binding rule; ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".graph_ui_persistence]. | 0.070 | |
| zustand_boundary | ["../../crates/reqlan-analytical/src/workspace_index.rs"], ["../../packages/analytical/src/native/native-workspace-index.ts"], ["../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../packages/extension/src/activity_bar_module/context-session.ts"] | done | [extension_architecture.state_machine_mindset] still applies: design UI and host flows as state machines. Zustand is no longer used anywhere: the index lifecycle FSM ( `opening` / `syncing` / `ready` / `error` ), counts, file issues, and the document-update ring now live in Rust `WorkspaceIndexRuntime` and are read over napi via `statusSnapshot()` ( ["../core_analysis/rust_port.rq".native_bridge] ); durable diagnostics persist in `index-diagnostics.sqlite`. TypeScript keeps no parallel copy of that state. Do not reintroduce zustand ( or Redux-like globals ) in `packages/extension/webviews/**` or the analytical package. Extension-host TypeScript may keep plain mutable session modules when the surface is small and message-pushed; owned lifecycle / state machines belong in the Rust runtime. | 0.069 | |
| check | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-index/src/path_resolve.rs"], ["../../crates/reqlan-index/src/rq_ignore.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../packages/cli/src/commands/check.ts"], ["../../packages/cli/src/format-broken-refs.ts"], ["../../packages/mcp/src/server.ts"] | done | `reqlan check` should run perform the following checks: - ensure all rq [reference] point to real nodes, unless rq ignored with [comment_reference_ignore]. - this tests rqcomments point to real parts of the namespace, that code references exist, and that rq references exists. - report unresolved imports: [check_unresolved_imports]. - report a comment reference with invalid syntax: [code_comment_syntax_errors]. - report a qualified reference whose file is not on disk: [check_qualified_missing_file]. - report a qualified reference whose `.rq` file does not declare the idea: [check_qualified_missing_idea]. - it should really just be a wrapper of the [index] and return the issues ( as a pipe, terminal output, or json ). Issue order: [check_order_by_target]. Sparse wildcards: [check_wildcard_sparse] via flags [check_wildcard_zero] and [check_wildcard_one]. Path globs: [check_glob_patterns]. Skip missing targets: [check_skip_targets] [check_skip_gitignored_targets]. CLI: ["../cli/cli_package.rq".commands]. MCP: ["../extension/agent/skills-and-mcp.rq".mcp_check]. CI: [check_meta_implementation]. Site demo: ["../site/site.rq".broken_links_showcase]. | 1.000 | |
| check_glob_patterns | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-index/src/sync.rs"], ["../../crates/reqlan-index/src/extract.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../crates/reqlan-napi/src/lib.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"], ["../../packages/cli/src/commands/check.ts"], ["../../packages/mcp/src/server.ts"] | done | [check] accepts more than one `--glob` pattern. Repeat `--glob` for each pattern. A file is in the recursive scan when it matches any glob. One `--glob` selects the same files as one path glob. A reference target that matches no glob is still checked. That target must resolve. [check] does not walk a directory that matches no glob. A positional path can name a file outside the globs. [check] checks that file. A positional path that is a directory outside the globs is not walked. An empty `--glob` value is an error. API: `AnalysisApi.check({ pathGlobs, paths })`. CLI: ["../cli/cli_package.rq".commands]. MCP: ["../extension/agent/skills-and-mcp.rq".mcp_check]. Related: [check] | 0.308 | |
| check_meta_implementation | ["../../.github/workflows/ci.yml"], ["../../.github/workflows/release.yml"], ["../../azure-pipelines.yml"], ["../../package.json"], ["../../scripts/assert-workspace-reqlan.mjs"] | done | [check] is a step in the sequential GitHub CI job after one workspace build. Pull requests use ["../../.github/workflows/ci.yml"]. Main uses the same workflow through ["../../.github/workflows/release.yml"] ( ["../distribution/distribution.rq".ci_gate] ). The job installs workspace packages once ( `pnpm install --frozen-lockfile` ), asserts `@reqlan/*` resolve under `packages/` ( ["../../scripts/assert-workspace-reqlan.mjs"] ), compiles crates and TypeScript, then runs crate tests, `node packages/cli/bin/cli.js check`, and JS / TS tests against that build. Do not install `@reqlan/cli` or other `@reqlan/*` packages from npm. Platform natives in this workspace come from `packages/analytical-native/` via `packageExtensions` in ["../../pnpm-workspace.yaml"], not from the registry. Do not call a global `reqlan` binary. Do not run a second install before check. GitHub and Azure pass `--skip-gitignored-targets` because gitignored files are not in a CI checkout ( [check_skip_gitignored_targets] ). Azure uses the same workspace CLI after its package build on `ext/v*` tags. Related: [check] [check_skip_targets] [check_skip_gitignored_targets] ["../distribution/distribution.rq".ci_gate] | 0.355 | |
| check_order_by_target | ["../../crates/reqlan-index/src/broken.rs"], ["../../packages/cli/src/format-broken-refs.ts"], ["../../packages/cli/src/commands/check.ts"] | done | [check] returns issues ordered by the missing [reference] target, not by the source file. Rows that share the same missing idea, comment target, file path, or import target stay together so you can see every site that points at one missing thing. Inside a target group, order by kind, then source file, then line. JSON and pipe keep a flat list in that order. Terminal output uses one heading per missing target. Related: [check] ["../cli/cli_package.rq".commands] | 0.370 | |
| check_qualified_missing_file | ["../../crates/reqlan-index/src/broken.rs"] | done | A qualified [reference] names a file and an idea. Example: `["../../../../my/non-existentfile.ts".term]`. [check] reports an error when that file is not on disk. The issue kind is `file_reference`. The label is the resolved file path. A qualified reference to a file that exists is not this error. A same-file idea reference is not this error. The editor already underlines this target. Related: [check] [check_qualified_missing_idea] ["../language/syntax.rq".reference_file] ["../extension/language/syntax/features-syntax-highlighting.rq".unresolved_reference_diagnostics] | 0.211 | |
| check_qualified_missing_idea | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-parse/src/ast.rs"], ["../../crates/reqlan-lsp/src/analysis.rs"], ["../../crates/reqlan-lsp/src/session.rs"], ["../../packages/language/src/reqlan-neighbor-parse.ts"], ["../../packages/language/src/reqlan-outbound-presentation.ts"] | done | A qualified [reference] names a file and an idea. Example: `["../extension/index-host/graph-analysers.rq".not_an_idea]`. The same rule applies to a namespace alias: `[alias.idea]` ( [import_namespace] ). [check] reports an error when that file is an `.rq` file, the file does not declare the idea, and the file does not bind that name as an import alias. The issue kind is `references`. The label is the missing idea name. A path with no extension means `.rq` first ( [implicit_file_extension] ). A qualified reference to an idea that the `.rq` file declares is not this error. A qualified reference to an import alias bound in that file is not this error. A namespace import binds its `as` name. A from-import or qualified import binds its `as` name, or the idea name when `as` is absent. A from-import of an import alias stays [check_unresolved_imports]. The alias is not an idea. A qualified reference to a code file is not this error. That form uses [check_qualified_missing_file]. A missing file stays [check_qualified_missing_file]. [check] does not also report a missing idea for that file. [comment_reference_ignore] suppresses this error. Related: [check] [check_qualified_missing_file] ["../language/syntax.rq".reference_qualified] | 0.278 | |
| check_skip_gitignored_targets | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-index/src/ignore.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../crates/reqlan-napi/src/lib.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"], ["../../packages/cli/src/commands/check.ts"], ["../../.github/workflows/ci.yml"], ["../../azure-pipelines.yml"] | done | [check] omits a file [reference] issue when Git ignore rules ignore the missing target. The analyser function `check_references` takes `skip_gitignored_targets` ( default false ). Match uses the workspace ["../../.gitignore"] and nested `.gitignore` files on the target path. Match uses the resolved path from the workspace root, not the authored path in the source file. Idea references, comment references, and missing imported idea names stay in the issue list. Missing import paths follow the same skip as file references ( [check_unresolved_imports] ). Use this when a referenced file is build output or editor config that git does not store. Examples: `.cursor/` for ["../extension/agent/chat-participant.rq".mcp], and `packages/extension/media/webviews/` for ["../extension/host/onboarding/page-thanks-for-installing.rq".installation_event]. CLI: `--skip-gitignored-targets` ( ["../cli/cli_package.rq".commands] ). API: `AnalysisApi.check({ skipGitignoredTargets })`. CI: ["../../.github/workflows/ci.yml"] and ["../../azure-pipelines.yml"] pass `--skip-gitignored-targets` because a CI checkout does not contain gitignored files ( [check_meta_implementation] ). Related: [check] [check_skip_targets] [check_unresolved_imports] [check_meta_implementation] | 0.445 | |
| check_skip_targets | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../crates/reqlan-napi/src/lib.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"], ["../../packages/cli/src/commands/check.ts"] | done | [check] omits an issue when the missing [reference] target matches a skip glob. The analyser function `check_references` takes `skip_targets`: a list of globs. Match uses the same path glob rules as `--glob`. Match is against the issue `label` ( the missing target ), not the source file. An empty skip glob has no effect. Use this when a referenced file is not in git and you name the skip glob. For all Git ignore rules, use [check_skip_gitignored_targets]. CLI: repeatable `--skip-target <glob>` ( ["../cli/cli_package.rq".commands] ). API: `AnalysisApi.check({ skipTargets })`. Related: [check] [check_skip_gitignored_targets] [check_meta_implementation] | 0.445 | |
| check_unresolved_imports | ["../../crates/reqlan-index/src/broken.rs"], ["../../packages/cli/src/commands/check.ts"], ["../../packages/mcp/src/server.ts"], ["../../packages/extension/skills/rq-fix-stale-references/SKILL.md"] | done | [check] reports an error when an import does not resolve. A missing import path is an error. A named imported idea that is not in the target file is an error. Do not report imported idea names when the path is missing. An existing folder is a valid import path ( [import_folder_targets] ). A remote URL is not a missing path. Import paths with no extension mean `.rq` first ( [implicit_file_extension] ). Ignore a site with [comment_reference_ignore]. Issue kind is `import`. The `label` is the missing path or the missing idea name. Forms: [import_from], [import_namespace], [import_qualified]. Editor underline: [import_does_not_exist_error]. [check_skip_targets] matches that label. [check_skip_gitignored_targets] omits a missing import path that Git ignore rules ignore. Related: [check] [check_order_by_target] [import_does_not_exist_error] | 0.425 | |
| check_wildcard_one | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../packages/cli/src/commands/check.ts"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | done | `check_references` flag `wildcard_one` ( default `warn` ) controls a ["../reference_types.rq".wildcard_reference] that matches exactly 1 idea. 1 match means the pattern is too narrow — use a concrete [reference] instead. `warn` — emit the row with severity `warning` and match count 1. `error` — emit the row with severity `error` and match count 1. `off` — omit the row. CLI: `--wildcard-one <warn|error|off>` ( ["../cli/cli_package.rq".commands] ). API: `AnalysisApi.check({ wildcardOne })`. Related: [check] [check_wildcard_sparse] [check_wildcard_zero] ["../language/imports.rq".wildcard_references] | 0.507 | |
| check_wildcard_sparse | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-index/src/extract.rs"], ["../../packages/cli/src/format-broken-refs.ts"], ["../../packages/language/src/reqlan-validator.ts"] | done | A ["../reference_types.rq".wildcard_reference] is for many matches. [check] recounts each wildcard against the full idea catalog, not the stored edges, so files that the indexer visited first still get the true match count. How 0 - match and 1 - match rows are handled is controlled by [check_wildcard_zero] and [check_wildcard_one] ( both default `warn` ). Ignore a site with [comment_reference_ignore]. The language server already warns when a wildcard matches nothing ( ["../language/imports.rq".wildcard_references] ); it also warns when the match count is 1. Related: [check] ["../language/imports.rq".wildcard_references] | 0.417 | |
| check_wildcard_zero | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../packages/cli/src/commands/check.ts"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | done | `check_references` flag `wildcard_zero` ( default `warn` ) controls a ["../reference_types.rq".wildcard_reference] that matches 0 ideas. 0 matches means the pattern hits nothing. `warn` — emit the row with severity `warning` and match count 0. `error` — emit the row with severity `error` and match count 0. `off` — omit the row. CLI: `--wildcard-zero <warn|error|off>` ( ["../cli/cli_package.rq".commands] ). API: `AnalysisApi.check({ wildcardZero })`. Related: [check] [check_wildcard_sparse] [check_wildcard_one] | 0.507 | |
| code_comment_syntax_errors | ["../../crates/reqlan-index/src/comment.rs"], ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-index/src/sync.rs"], ["../../packages/cli/src/commands/check.ts"] | done | A comment reference uses `rq:[idea]` or `rq:["path".idea]`. A path string uses double quotes or single quotes. A qualified reference may use dotted idea names after the path. Line comments use `//` and `#`. The same forms apply in every comment span that the indexer reads. [check] reads each comment reference in a non- `.rq` source file. A comment reference with invalid syntax is a syntax error. [check] reports the syntax error. The issue kind is `comment_syntax`. The issue label is the error reason and the comment reference text. The issue severity is `error`. A valid comment reference stays a ["../language/syntax.rq".comment_reference] site. An unresolved valid target stays a `comment_link` issue. A source file that contains only a syntax error stays in the code index. [comment_reference_ignore] suppresses the syntax error on the next line. Related: [check] ["../extension/language/comment-references/functional-code-comment-references.rq".references_in_functional_code_comments] | 0.174 | |
| consumption_silence | ["../../crates/reqlan-index/src/git_dates.rs"], ["../../packages/extension/src/shared/hidden-exec-file.ts"], ["../../packages/extension/src/activity_bar_module/git-context.ts"], ["../../packages/extension/src/extension/language-server-runtime.ts"], ["../../packages/extension/src/index_host_module/register-git-dates-background.ts"] | done | Hosts that consume the native core ( and helper CLI tools such as `git` / `node` ) must not open a visible console window. On Windows, a GUI editor host that spawns a console-subsystem process without `CREATE_NO_WINDOW` / `windowsHide` flashes a CLI window. Git-dates fill in the core engine and Activity Bar git history were the repeating flashes after `.rq` change; the language-server Node probe can flash once at start on old hosts. Index parse itself stays in-process ( napi `.node` / `.dll` ) and does not spawn a console. Related: ["../indexer/indexer.rq".git_dates], ["../extension/index-host/git-codelens.rq".git_dates_background_indexing], ["../extension/index-host/git-codelens.rq".git_dates_rate_cap], ["../extension/local-context/context-scope.rq".git_context], ["../extension/index-host/index.rq".git_information_capture]. | 0.131 | |
| test_references | ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../packages/cli/src/commands/analyse.ts"] | done | The indexer lists broken references in a [index] base. A broken reference is an unresolved idea or wildcard reference. You can give an optional path glob so that the list covers only a subset of the base. You can optionally include unresolved [comment_reference] sites. The function is in the core analysis module. The CLI exposes it on [commands] ( `analyse --broken-refs` ). Related: [analysers] [runtime] [indexer.index_code_files] ["../language/syntax.rq".comment_reference_resolution_error] | 0.201 | |
| csv_export | ["../../packages/analytical/src/export/export-csv.ts"], ["../../packages/analytical/src/export/write-csv-export.ts"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | done | CSV export writes `ideas.csv` with tags and non-status / tag attributes flattened into columns ( `attr:<key>` ), plus `references.csv` for inbound / outbound / unresolved edges. Shared base / scope / output / name and file filters apply. Pipeline: `exportCsv` / `writeCsvExport` ( [export_pipeline] ). Extension UI host: ["../extension/export/export.rq".export_webview]. | 0.055 | |
| export_pipeline | ["../../packages/analytical/src/native/native-analysis-api.ts"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../packages/analytical/src/export/types.ts"] | done | `@reqlan/analytical` owns export execution for every format. Shared contract: `ExportRequest` / progress callbacks / snapshot build, then format writers. Hosts ( extension webview, CLI ) assemble an `ExportRequest` and call `NativeAnalysisApi.exportHtml` / `exportMarkdown` / `exportJson` / `exportCsv` — they do not reimplement writers. Formats: ["./html_export.rq".html_export], [markdown_export], [json_export], [csv_export], [pdf_export]. Progress phases ( snapshot, then write completed / total ) are reported to hosts for loading UI. Consumed under [analysis_scope]. Rust port of snapshot + writers: ["./rust_port.rq".export_rust]. | 0.114 | |
| json_export | ["../../packages/analytical/src/export/export-json.ts"], ["../../packages/analytical/src/export/write-json-export.ts"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | done | JSON export writes `export.json` for the selected base: ideas ( with attributes and reference lists ), files, clusters, attributes, and status / tag rollups — suitable for tooling and AI consumption. Shared base / scope / output / name and file filters apply. Pipeline: `exportJson` / `writeJsonExport` ( [export_pipeline] ). Extension UI host: ["../extension/export/export.rq".export_webview]. | 0.055 | |
| markdown_export | ["../../packages/analytical/src/export/export-markdown.ts"], ["../../packages/analytical/src/export/write-markdown-export.ts"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | done | Markdown export writes a `README.md` index for the selected base ( counts, status / tag rollups, idea list, file list ) and optional per-idea `.md` pages under `ideas/` with attributes and inbound / outbound references as relative markdown links. When per-idea pages are disabled, idea bodies are inlined in the README. Shared base / scope / output / name and file filters apply; HTML-only page families ( graph, clusters, attributes, print ) are omitted. Pipeline: `exportMarkdown` / `writeMarkdownExport` using the same snapshot builder as HTML ( [export_pipeline] ). Extension UI host: ["../extension/export/export.rq".export_webview]. | 0.055 | |
| pdf_export | ["../../crates/reqlan-export/src/html.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/types.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | partial | PDF export prepares a print-oriented HTML report from the selected base so the user can Print → Save as PDF in the browser. Direct PDF binary rendering is not required yet; preserve links in the printable HTML ( ["./html_export.rq".html_export_printable_pages] ). PDF-specific options include file filters and print entry filename; shared base / scope / output / name apply. Extension UI host: ["../extension/export/export.rq".export_webview] ( not a separate QuickPick chain ). | 0.073 | |
| html_export | ["../../crates/reqlan-export/src/html.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | done | `@reqlan/analytical` builds documentation as HTML from the requirement graph ( ["./export.rq".export_pipeline], [analysis_scope] ). Html export should render ideas, attributes, references, and navigable structure suitable for sharing. Pipeline: `NativeAnalysisApi.exportHtml` / `AnalysisRuntime.export` → `reqlan-export` snapshot ( `build_export_snapshot` ) → multi-file static site ( `write_html_export` ). Single-file mode remains optional via [html_export_runtime_modes]. Interactive graph / search JS stays bundled static assets ( [html_export_graph_layout] ), not a second writer ( ["./rust_port.rq".export_rust] ). Thin hosts: extension UI ( ["../extension/export/export.rq".export_webview], ["../extension/export/html-export.rq".html_export_form], ["../extension/export/export.rq".export_html] ) and CLI ( `reqlan export` / ["../cli/cli_package.rq".commands] ). Export is scoped to a selected ["../bases/base.rq".base] ( not a merged multi-base workspace graph ). [html_export_multi_file] [html_export_internal_links] [html_export_idea_tooltips] [html_export_layout_cards] [html_export_heading_tooltips] [html_export_table_columns] [html_export_search] [html_export_list_views] [html_export_overview_links] [html_export_idea_pages] [html_export_file_pages] [html_export_code_reference_pages] [html_export_cluster_pages] [html_export_graph_page] [html_export_attributes_index] [html_export_attribute_pages] [html_export_printable_pages] [html_export_print_idea_cards] [html_export_print_body_whitespace] [html_export_print_in_page_anchors] [html_export_print_all_attributes] [html_export_print_button] [html_export_print_order_by] [html_export_runtime_modes] [html_export_scrollable_lists] [html_export_header_link] [html_export_url_base] [html_export_katz_column] | 0.201 | |
| html_export_attribute_pages | ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html.rs"] | Html export should generate a dedicated page per attribute key used in the export scope. Attribute pages should show a distribution of distinct values ( counts and share of ideas ), and a searchable full list of ideas that declare the attribute with their values for that key. Emission defaults on and is controllable via includeAttributePages so this page family can be flagged in or out without changing the export pipeline shape. The attributes index, idea attribute tables, and search results should link to these pages when enabled. | 0.078 | ||
| html_export_attributes_index | ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html.rs"] | Html export should provide a searchable attributes index page listing every attribute key used in the export scope. Each attribute entry should summarize distinct values and idea counts, and link to the dedicated attribute page when [html_export_attribute_pages] is enabled. | 0.089 | ||
| html_export_code_reference_pages | ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/src/html.rs"] | Html export should generate dedicated pages for outbound file_reference targets and inbound comment_link code files that are not idea-hosting reqlan files already covered by [html_export_file_pages]. Code-file pages should list referencing ideas and reference labels, and participate in search and navigation. Emission defaults on and is controllable via includeCodeFilePages so this page family can be flagged in or out later. Outbound reference path cells and graph external file nodes should link to these pages when enabled. Comment-linked files: ["../indexer/indexer.rq".index_code_files]. | 0.151 | ||
| html_export_file_pages | ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html.rs"] | Html export should generate dedicated pages for reqlan source files that host ideas in the export scope. File pages should list hosted ideas, related clusters, and a local graph view when available. Emission defaults on and is controllable via includeFilePages so page families can be flagged in or out without changing the export pipeline shape. Graph nodes and idea source-file links for hosting files should resolve to these pages when enabled. | 0.119 | ||
| html_export_graph_animation | ["../../crates/reqlan-export/assets/app.js"], ["../../packages/extension/webviews/shared/graph/physics-core.js"], ["../../packages/extension/webviews/shared/graph/graph-physics.ts"] | Live physics in the HTML export should match Ideas Summary animatePhysics: continuous damped semi-implicit Euler using the defaults from ["../../packages/extension/webviews/shared/graph/physics-core.js"] ( same module as ["../../packages/extension/webviews/shared/graph/graph-physics.ts"] ), inlined in ["../../crates/reqlan-export/assets/app.js"]. A Live physics toggle pauses and resumes the same simulation state ( default off ); when off, the graph batch-settles then sleeps. Batch settle must remain responsive per [html_export_graph_background_load] — yield between chunks rather than freezing the page for large graphs. Simulation should converge and sleep when calm, waking on filter changes or when Live physics is turned back on, aligned with [layout_physics]. Large graphs use a spatial grid + repulsion cutoff in the shared core; all nodes and full labels remain visible. | 0.093 | ||
| html_export_graph_background_load | ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/src/html_template/mod.rs"] | done | Interactive HTML export graph boot and layout settle must not monopolise the main thread on large graphs. Page chrome ( nav, filters, search, other controls ) should stay responsive while the graph initialises. Graph wiring should start after the first paint / idle opportunity rather than synchronously blocking `DOMContentLoaded`. When Live physics is off, the initial batch settle should run in yielded chunks ( animation frames or idle callbacks ) so the browser can paint and handle input between steps; keep the boot spinner until the first usable canvas frame, then show progressive settle status. A new filter / refresh or remount must cancel any in-flight background settle before starting another. Cross-refs [html_export_graph_page], [html_export_graph_animation], [html_export_graph_interaction]. | 0.093 | |
| html_export_graph_interaction | ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/src/html_template/mod.rs"] | The interactive export graph should support dragging nodes and panning or zooming the viewport, aligned with [view_controls] and [manual_reframe]. Click-through to idea pages must remain available after drag via click-versus-drag discrimination. A Fit control should reframe the viewport to the current node set without restarting layout or clearing live physics state. Zoom and Fit must continuously drive [graph_label_auto] / [html_export_graph_label_auto] opacity when Labels is in auto mode. When ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".file_treatment_toggle] is compound: file bounding boxes are hittable — drag moves member nodes together; clicking the underlined title navigates to the hosting file page ( when `hostFilePageUrl` / `pageUrl` is present ). When linked: synthetic file ideaset nodes are dragged and clicked like other leaves. Related: ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".file_treatment_toggle], ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".webview_export_graph_parity]. | 0.085 | ||
| html_export_graph_label_auto | ["../../crates/reqlan-export/assets/app.js"] | done | Export-surface wiring for [graph_label_auto]: canvas paint applies continuous zoom opacity ( GRAPH_LABEL_FADE_START → GRAPH_LABEL_FADE_END ); hover / drag stays fully opaque. Labels stay fully invisible while the graph is initialising or batch-settling so text paint does not lag those phases; zoom fade applies only after settle completes. Zoom and Fit from [html_export_graph_interaction] / [manual_reframe] update opacity each paint. | 0.081 | |
| html_export_graph_label_modes | ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/src/html_template/mod.rs"] | done | Export-surface wiring for [graph_label_modes]: Labels control on every interactive export graph cycles auto / on / off; Reset restores auto. | 0.070 | |
| html_export_graph_labels | ["../../crates/reqlan-export/assets/app.js"] | HTML export canvas graphs implement shared [graph_labels] ( full names, no ellipsis truncation ). [html_export_graph_label_modes] [html_export_graph_label_auto] | 0.062 | ||
| html_export_graph_layout | ["../../crates/reqlan-export/assets/app.js"], ["../../packages/extension/webviews/shared/graph/physics-core.js"], ["../../packages/extension/webviews/shared/graph/graph-physics.ts"] | The interactive export graph should lay out nodes so labels and circles do not heavily overlap. Initial placement should settle with the same Obsidian-style force model as [layout_physics] ( central gravity, edge springs, inverse-square repulsion ). Rendering uses canvas 2 d ( not SVG DOM ) with shared physics from ["../../packages/extension/webviews/shared/graph/physics-core.js"], inlined into the export asset ["../../crates/reqlan-export/assets/app.js"]. | 0.121 | ||
| html_export_graph_links | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/assets/app.js"] | Graph node hrefs must resolve to idea pages from every export page depth, including nested idea, file, and cluster pages. Node urls should be export-root-relative so path segments such as ideas / are not dropped when resolving from nested pages. When [html_export_url_base] is set, runtime resolution of those urls must honour the mount prefix ( same contract as page and asset hrefs ). External file nodes should resolve to [html_export_file_pages] or [html_export_code_reference_pages] when those page families are enabled. Hosting-file linked nodes ( ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".file_treatment_toggle] linked mode ) prefer `hostFilePageUrl` stamped during graph URL enrichment ( file / code-file page for the idea's `fileUri` ), falling back to a member idea `pageUrl` when file pages are disabled. | 0.117 | ||
| html_export_graph_metadata | ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/snapshot.rs"] | Graph nodes in the HTML export should surface tags, status, and attribute keys on or beside the node, not only as filter inputs. Attribute values declared on the idea should be reachable from the graph via the idea page and on-node attribute key summary. | 0.062 | ||
| html_export_graph_page | ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-analytical/src/api.rs"] | Html export should provide an interactive graph page with search, filters, and links back into idea and cluster pages. The graph should support scoped views for workspace, file, cluster, and idea contexts. The workspace graph page must include every idea in the export scope — blocks, oneliners, and ideasets — and must not apply the interactive Ideas Summary GRAPH_MAX_NODES budget. Ideasets are visible by default with a Hide ideasets / Show ideasets toggle, matching the external-file visibility control ( explicit AST ideasets only — distinct from hosting-file treatment ). Hosting `.rq` files ( implicit ideasets ) use a Files `<select>` — hidden / compound / linked — with option tooltips, per ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".file_treatment_toggle] ( parity with Ideas Summary ). Compound mode draws hittable / draggable bounding boxes with clickable titles; linked mode adds synthetic ideaset nodes that navigate via `hostFilePageUrl` / `pageUrl`. Wildcard fan-out edges ( `wildcard_reference` ) are visible by default with a " Wildcard refs " chip ( same label / default as Ideas Summary ); turning it off client-filters those edges and draws them dotted when on — see ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".wildcard_refs_toggle] and ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".webview_export_graph_parity]. Status and tag filters are multi-select and distinguish [graph_status_tag_filters]. Per-idea, per-file, and per-cluster neighbourhood graphs may still use a capped budget for focused pages. [html_export_graph_links] [html_export_graph_layout] [html_export_graph_animation] [html_export_graph_background_load] [html_export_graph_subject] [html_export_graph_labels] [html_export_graph_label_modes] [html_export_graph_label_auto] [html_export_graph_interaction] [html_export_graph_metadata] | 0.165 | ||
| html_export_graph_subject | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/assets/styles.css"] | When a graph view has a subject or center idea, that node should be visually distinct from peers and externals. Subject styling should use the brand rust accent against cyan peer nodes. | 0.062 | ||
| html_export_header_link | ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/styles.css"], ["../../packages/cli/src/commands/export.ts"], ["../../site/scripts/export-spec.mts"] | done | Html export should accept an optional header link ( href + label ) rendered in the topbar ahead of section navigation. Hosts such as the marketing site build can set this so readers can return to the parent site from any exported page. When omitted, the topbar shows only the export section nav. Site embed consumption: ["../site/site.rq".spec_html_export]. Often paired with [html_export_url_base] when the export is mounted under a parent static site. | 0.222 | |
| html_export_heading_tooltips | ["../../crates/reqlan-export/src/html_template/layout.rs"], ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/assets/styles.css"] | done | Section headings on layout panels show a short descriptive tip via the styled tooltip panel when pointer or keyboard focus rests on the heading. Entity-card title headings tip with that card's short summary text. Idea title headings tip with the idea summary when present. Heading tips must not use the browser title text. Reuses the tooltip surface from [html_export_idea_tooltips]. Cross-refs [html_export_layout_cards]. | 0.092 | |
| html_export_idea_tooltips | ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/assets/styles.css"] | done | A link to an idea must show a tooltip when the pointer or keyboard focus rests on the link. The tooltip must show the idea name, the source file, and the idea body text. The tooltip must show the status when the idea has a status. The tooltip must be a styled panel. The tooltip must not use the browser title text. The tooltip must stay inside the viewport. An unresolved reference must not show an idea tooltip. Section and card heading tips follow [html_export_heading_tooltips]. | 0.099 | |
| html_export_ideas_ref_columns | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/styles.css"] | done | The ideas index table shows inbound reference counts and outbound reference counts in two columns. The first count column is In. The second count column is Out. Each cell shows one integer. Each column has its own header sort and column filter. Filter keys are `in` and `out`. | 0.056 | |
| html_export_katz_column | ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"] | done | HTML export shows the inbound Katz score ( ["../modelling/advanced_analysis.rq".katz_centrality] ) for each idea. The ideas index adds a Katz column after Out. File idea tables, code-file idea tables, cluster member tables, and attribute idea tables add a Katz column. The printable file sheet, code-file sheet, and cluster sheet add the same column. The idea page and the printable idea sheet show the same score as a metric. The cell text uses 3 decimal places. The sort value is the full score. The filter key is `katz`. File, cluster, and attribute index tables do not show this column. | 0.075 | |
| html_export_layout_cards | ["../../crates/reqlan-export/src/html_template/layout.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/assets/styles.css"] | done | In interactive runtime mode, detail-page panels ( panel, table-shell, graph-shell ) and entity-card tiles are drag-reorderable within their layout group and collapsible. In interactive mode, cards that are direct children of a page layout group and use panel, table-shell, or graph-shell chrome are width-resizable by column span. Entity-card tiles inside an entity-list layout group are drag-reorderable and collapsible, but they are not width-resizable. Column hide and column width on tables stay separate from card width. Width-resizable cards sit in a responsive multi-column grid and snap to column spans so a card can take one column, several columns, or the full row. Double-click on the card width handle fills the row. A second double-click restores the last non-full span. Collapsed cards ignore fill. Narrow viewports collapse spans so cards stack without horizontal overflow. The full card header is the drag handle. Links, buttons, and inputs in the header still activate on click. The collapse caret stays hidden until the card is hovered or has focus within. Collapse hides the card body and shrinks the card chrome so the layout does not keep empty body space. Card-width and header drag must not lose control to text selection: pointer capture, select lock, and preventDefault on resize pointerdown. Order, collapse, column-span, and fill-restore state persist in localStorage for that page path. Document and print runtime modes keep a static layout with no rearrange, resize, or collapse behaviour. Printable-report idea cards stay outside this idea ( [html_export_print_idea_cards], [html_export_print_order_by] ). Table column chrome follows [html_export_table_columns]. Cross-refs [html_export_runtime_modes], [html_export_heading_tooltips]. | 0.092 | |
| html_export_list_views | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/assets/app.js"] | Html export should provide searchable list views for ideas, files, code files, references, clusters, and attributes. List views should preserve the usability of the current ideas summary tables with counts, sorting, filters, and quick navigation. Every interactive table column should be sortable by header click and filterable with a per-column filter, in addition to any page-level search bar. Navigable facet cells in those tables ( status, tags, paths, attribute values, cluster labels / kinds ) should be links to the matching detail page or to a list page with the matching column filter applied via [html_export_overview_links]. Long lists that sit above other page content follow [html_export_scrollable_lists]. The ideas index count columns follow [html_export_ideas_ref_columns]. Column hide, resize, and selector chrome follow [html_export_table_columns]. [html_export_ideas_ref_columns] [html_export_table_columns] [html_export_attributes_index] [html_export_file_pages] [html_export_code_reference_pages] [html_export_scrollable_lists] [html_export_overview_links] | 0.121 | ||
| html_export_overview_links | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/assets/app.js"] | done | The interactive overview page status rollup, tags rollup, and highlighted clusters must be interactive navigation, not plain labels. Status and tag rollup entries should open the matching status / tag cluster page when [html_export_cluster_pages] is enabled; otherwise they should open the ideas list with the Status or Tags column filter seeded from the rollup key. Highlighted clusters should open the matching cluster page ( or the clusters index when cluster pages are disabled ). List pages must honour URL query parameters that seed per-column filters ( for example `ideas.html?status=todo` or `ideas.html?tags=export` ) so overview and in-table facet links land with the filter already applied. Query keys match stable `data-filter-key` values on table headers; filter values use the same display labels as the rollup ( including Not present / Empty ). Cross-refs [html_export_list_views], [html_export_cluster_pages], [html_export_internal_links]. | 0.103 | |
| html_export_print_all_attributes | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html_utils.rs"] | done | Printable report idea cards and per-idea printable sheets must show every declared attribute for the idea, not only status ( or status + tags ). Attribute values that contain idea refs follow the link rules of the hosting print surface ( [html_export_print_in_page_anchors] on the report page ). Cross-refs [html_export_printable_pages], [html_export_idea_pages]. | 0.110 | |
| html_export_print_body_whitespace | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/styles.css"] | done | The printable report must show the idea body text that the parser stores. Each per-idea printable sheet must show the stored idea body text. The parser removes the base indent. The base indent is the indent of the first body line. Extra indent on a later line is part of the body text. A later line with 4 more spaces than the first body line is stored with those 4 spaces. Print HTML must keep those leading spaces. Print HTML must not collapse those spaces. The body text must still wrap inside the card width. Cross-refs [html_export_printable_pages], [html_export_print_idea_cards]. | 0.110 | |
| html_export_print_button | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/styles.css"] | done | Printable report and printable idea sheets include a Print control that opens the browser print dialog ( `window.print` ). The control must work without the interactive javascript bundle ( inline handler is acceptable ) and should be hidden in the printed output. Cross-refs [html_export_printable_pages]. | 0.090 | |
| html_export_print_idea_cards | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/assets/styles.css"] | done | The printable report page lists ideas as cards in a single column that must remain within the page width on narrow viewports — no horizontal spill from long summaries, file paths, refs, or attribute values. Cards use a one-column grid ( `minmax(0, 1fr)` ) and wrapping / overflow rules so content reflows instead of overflowing the layout. Stored idea body spaces on these cards follow [html_export_print_body_whitespace]. Cross-refs [html_export_printable_pages], [html_export_print_in_page_anchors], [html_export_print_all_attributes]. | 0.153 | |
| html_export_print_in_page_anchors | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/assets/styles.css"] | done | On the printable report page, each idea card has a stable html `id` derived from the idea identity. Cross-idea links rendered on that page ( title links and inline idea refs in summaries / attributes ) must resolve to same-page `#` fragment urls targeting those ids, not separate idea detail pages. When browsed with the sticky site topbar, fragment navigation must leave the target card fully visible below the header ( scroll padding / scroll-margin ), not clipped behind it. Aligns with stable in-page anchors in [html_export_internal_links]. Cross-refs [html_export_printable_pages], [html_export_print_idea_cards]. | 0.145 | |
| html_export_printable_pages | ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/assets/styles.css"], ["../../crates/reqlan-export/src/html.rs"] | Html export should provide static printable pages alongside the interactive site. Print pages should not depend on the interactive javascript bundle. Status and tags are nullable: when absent, printable sheets must omit those fields rather than inventing placeholders such as unspecified or empty dashes. When print pages are browsed in interactive runtime mode, long lists with content below them follow [html_export_scrollable_lists]. Idea cards on the printable report follow [html_export_print_idea_cards], [html_export_print_in_page_anchors], [html_export_print_all_attributes], and [html_export_print_button]. Stored idea body spaces on print pages follow [html_export_print_body_whitespace]. Ordering of cards on the printable report is tracked by [html_export_print_order_by]. | 0.174 | ||
| html_export_scrollable_lists | ["../../crates/reqlan-export/assets/styles.css"], ["../../crates/reqlan-export/src/html_template/mod.rs"] | In interactive runtime mode, long list and table sections that have additional content below them should render inside a scrollable viewport with a max height so lower sections remain reachable without endless page scrolling. Toolbar titles and filters for those sections should stay outside the scroll viewport. In document and print runtime modes, those same lists should expand to their full natural height so the export remains readable as a continuous document and suitable for printing. Browser print of interactive pages should also expand constrained lists to full height. | 0.117 | ||
| html_export_table_columns | ["../../crates/reqlan-export/assets/app.js"], ["../../crates/reqlan-export/assets/styles.css"] | done | In interactive runtime mode, tables inside layout cards let the user hide and resize columns. An eye control on each column header toggles that column. The eye shows when the header cell is hovered or focused. A column-selector control in the table card header opens a multiselect panel with search, select all, clear, and shift-click range selection. Column resize must not lose control to text selection: pointer capture, select lock, and a resize handle above selectable header text. Hidden columns and column widths persist in localStorage for that page path and table. Document and print runtime modes keep all columns visible at default widths with no column chrome. Cross-refs [html_export_layout_cards], [html_export_list_views]. | 0.095 | |
| html_export_url_base | ["../../crates/reqlan-export/src/types.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/src/snapshot.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"], ["../../packages/cli/src/commands/export.ts"], ["../../site/scripts/export-spec.mts"] | done | Html export should accept an optional urlBase mount prefix ( for example `/spec` or `/reqlan/spec` ). When set, page and asset hrefs must be root-relative under that prefix so static hosts resolve correctly whether the directory URL includes a trailing slash. When omitted, exports keep document-relative hrefs suitable for local folder browsing. Applies across [html_export_internal_links] and [html_export_graph_links]; site embed consumption: ["../site/site.rq".spec_html_export]. Often paired with [html_export_header_link] when the export is mounted under a parent static site. | 0.259 | |
| comment_span_align | ["../../packages/language/src/reqlan-token-builder.ts"], ["../../packages/language/src/reqlan-comment-resolver.ts"], ["../../packages/language/src/reqlan-line-fences.ts"], ["../../packages/language/scripts/patch-textmate.mjs"], ["../../packages/language/syntaxes/reqlan.tmLanguage.json"], ["../../crates/reqlan-parse/src/lexer.rs"] | done | On every frozen [golden_corpus] `.rq` file, `//` and `/* … */` comment character ranges must be identical across: - the Langium lexer ( hidden `SL_COMMENT` / `ML_COMMENT` ) - `findCommentSpansInText` C-style spans ( host `#` / triple-quote spans are not `.rq` comments ) - TextMate `comment.line.reqlan` and `comment.block.reqlan` scopes Same-line fences, glob `/**/`, URL `://`, and fenced ` ` ` bodies must not open comments. Mid-line triple backticks are prose. They must not open a fence or hide later ideas. Example: `@reqlan/*` in inline code must not open a block comment. Related: [parser_align], ["../language/syntax.rq".code_snippets], ["../language/syntax.rq".comments], ["../language/syntax-edge-cases.rq".fencing_comments], ["../language/syntax.rq".inline_code]. | 0.141 | |
| parser_align | ["../../crates/reqlan-parse/src/align.rs"], ["../../packages/language/test/langium-rust-parse-align.test.ts"], ["../../crates/reqlan-napi/src/lib.rs"], ["../../packages/analytical/src/native/parse-source.ts"] | done | Langium and `reqlan-parse` stay two engines as a dual-parser **test oracle**. Grammar truth is [syntax] / ["../../packages/language/src/reqlan.langium"]. The same source must yield the same parse snapshot: top-level elements, live bracket and wiki refs, inline-code count, and fence count. One Node test runs Langium and native `parseReqlanSource` ( `parseAlignSnapshot` ) together. A committed name dump is not the only check. The default editor LSP already uses Rust ( [lsp_rust.language_server_rust] ); this idea does not gate that cutover. Related: [golden_corpus], [parser_rust], [comment_span_align]. | 0.150 | |
| rust_crate_layout | ["../../package.json"], ["../../crates/Cargo.toml"] | done | Cargo workspace at repo-root `crates/` ( not inside `packages/analytical` ), crates: - `reqlan-parse` — lexer, parser, AST, recovery, parse budget - `reqlan-index` — extract, rusqlite store, mtime sync, diagnostics - `reqlan-search` — fuzzy / contextual / semantic ranking - `reqlan-export` — snapshot + html / md / json / csv writers; embed existing HTML JS assets - `reqlan-analytical` — facade matching `AnalysisApi` + `WorkspaceIndex` operations - `reqlan-napi` — Node binding for the core engine ( [native_bridge] ) - `reqlan-lsp` — editor language server ( [lsp_rust.language_server_rust] ) Mature crates only ( rusqlite, napi ): no experimental parser generators for the lexer. Golden tests compare Rust extract against Langium on the frozen [golden_corpus], plus the language-test fixtures ported into `reqlan-parse` / `reqlan-index` tests. Format: ["../development/commit.rq".rust_fmt]. Root `pnpm test` runs `test:js` then `test:rust` from ["../../package.json"]. `test:rust` is `cargo test --workspace --exclude reqlan-napi`. GitHub CI compiles crates once, then runs `cargo test` as its own step so crate tests reuse that build ( ["../distribution/distribution.rq".ci_gate] ). | 0.138 | |
| ts_interface | ["../../crates/reqlan-analytical/src/bin/export_ts.rs"], ["../../crates/reqlan-analytical/src/lib.rs"] | done | The TS interface over the Rust functionality stays fully typed via specta ( `crates/reqlan-analytical` `export-ts` → `packages/analytical/src/native/generated.ts` ). Specta copies Rust doc comments. `export-ts` rewrites those `rq:` paths from crate-src depth to `packages/analytical/src/native` depth. | 0.040 | |
| file_search | ["../../crates/reqlan-search/src/fuzzy.rs"], ["../../crates/reqlan-index/src/store.rs"], ["../../packages/analytical/src/index-store/sqlite-store.ts"], ["../../packages/analytical/src/native/native-workspace-index.ts"], [fuzzy_search_impl] | done | Rank indexed `.rq` files and comment-bearing code files by basename, stem, and path using the same separator-insensitive matching as [fuzzy_search] / [fuzzy_search_whitespace]. Hits use kind `file`; id is the indexed file URI; name is the basename; line start is 0. Empty query does not dump the file catalog. Mixed into [fuzzy_search] so one list ranks ideas and files together. Code files are those persisted by ["../indexer/indexer.rq".index_code_files]. Surfaces: native `fuzzy_search` via [native_workspace_index], ["../extension/local-context/activitybar-panels/search.rq".search_pane_file_hits]. ["../cli/click.rq".click_input] uses this mix when click has no exact match. | 0.244 | |
| fuzzy_search_pages | ["../../crates/reqlan-search/src/fuzzy.rs"], ["../../packages/analytical/src/native/native-workspace-index.ts"], [fuzzy_search_impl] | done | [fuzzy_search] accepts `offset` + `limit` over the already-ranked mixed idea + file list. `truncated` is true when more hits exist after the returned page ( callers show `{n}+` rather than a full count ). Used by ["../extension/local-context/activitybar-panels/search.rq".search_pane_load_more]. | 0.097 | |
| katz_search | ["../../crates/reqlan-search/src/katz.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"], ["../../packages/cli/src/commands/search.ts"] | done | Search can bias matches by inbound Katz centrality ( [katz_centrality] ). The bias is off unless the caller sets it. CLI flag: `reqlan search <query> --katz`. API field: `SearchRequirementsOptions.katz`. When the bias is on, the score is `textScore * (1 + katzScore)`. The match reasons include `katz:<score>`. Context hop decay runs first. The Katz multiplier runs second. When the bias is off, match order and scores stay on the text ranking. | 0.082 | |
| typescript_compile | ["../../package.json"], ["../../pnpm-workspace.yaml"], ["../../packages/language/langium-config.json"], ["../../.github/workflows/ci.yml"], ["../../.github/workflows/deploy-npm.yml"], ["../../azure-pipelines.yml"], ["../../.gitignore"] | done | Langium writes `packages/language/src/generated` ( ast, grammar, module ). That directory is gitignored. `tsc -b tsconfig.build.json` fails on a clean checkout if those files are missing. Root script `build:tsc` is `langium:generate` then that `tsc -b`. Full `pnpm run build` starts with `build:tsc`. GitHub CI, Azure package build, and npm deploy use `build:tsc` so compile matches a clean local build ( [distribution.prerelease_tests], [distribution.ci_gate], [distribution.npm_distribution] ). GitHub CI compiles the TypeScript workspace once in the sequential job, then reuses that emit for [check.check] and package tests ( [check.check_meta_implementation] ). `langium generate` validates ["../../packages/language/langium-config.json"] against the langium-cli schema. langium-cli 4. 3. 0 does not set schema `$id`. jsonschema 1. 5. 0 then throws `ERR_INVALID_URL` for `#/$defs/languageItem` on Node 24. The workspace pins jsonschema 1. 4. 1 for langium-cli in ["../../pnpm-workspace.yaml"] until a langium-cli release includes that `$id`. | 0.045 | |
| rust_fmt | [ci], ["../../.github/workflows/release.yml"], [pre_commit_hook], [rust_fmt_hook], [install_git_hooks], [workspace_package], [rustfmt_toml] | done | CI runs `cargo fmt --all` in write mode on all crates ( [rust_port.rust_crate_layout], [rustfmt_toml] ). Format is a chore, not a gate: an unformatted tree does not fail the job. On same-repo pull requests, if fmt changes files, CI commits `chore: cargo fmt` and pushes to the PR branch. Fork PRs and `workflow_call` ( release ) only format the working tree; they do not push. Recursion stops because: ( 1 ) pushes with the default `GITHUB_TOKEN` do not start new workflow runs; ( 2 ) a second run finds no diff after fmt, so it does not commit again. Pull requests and the release workflow share the same sequential CI job ( ["../distribution/distribution.rq".ci_gate] ). Git pre-commit runs the same formatter in write mode so local commits stay formatted. Skip when no crate Rust is staged, format in place and restage, skip merge / rebase, `SKIP_RUST_FMT=1` escape hatch. [workspace_package] `prepare` sets `core.hooksPath` to `.githooks`. | 0.081 | |
| ci_gate | ["../../.github/workflows/release.yml"], ["../../.github/workflows/ci.yml"], ["../../scripts/assert-workspace-reqlan.mjs"] | done | Pull-request CI and the main release pipeline share one sequential workflow: ["../../.github/workflows/ci.yml"]. ["./distribution.rq".deployment_flow] must not apply changesets or create tags until that workflow succeeds. Order in one job: install workspace packages, compile crates and TypeScript once, then crate tests, ["../core_analysis/check.rq".check], then JS / TS tests ( ["./distribution.rq".prerelease_tests], ["../core_analysis/check.rq".check_meta_implementation], ["../development/commit.rq".rust_fmt] ). `@reqlan/*` packages come from this git checkout ( `workspace:*` ), not from the npm registry. Platform native packages are linked the same way in this workspace through `packageExtensions` in ["../../pnpm-workspace.yaml"]; they are not listed in git `@reqlan/analytical` `optionalDependencies`. A push to main does not start CI a second time as an independent workflow; ["../../.github/workflows/release.yml"] calls ["../../.github/workflows/ci.yml"] with `workflow_call`. Because ["../../.github/workflows/ci.yml"] declares `permissions.contents: write`, the caller job in ["../../.github/workflows/release.yml"] must grant `contents: write` when invoking it. The version-bump commit ( `chore(release):` ) skips the gate and the version job to prevent a recursive run. | 0.172 | |
| npm_distribution | ["../../.github/workflows/deploy-npm.yml"], ["../../scripts/skip-already-published.mjs"], ["../../scripts/require-natives-published.mjs"], ["../../scripts/prepare-native-packages.mjs"], ["../../scripts/collect-napi-binary.mjs"], ["../../package.json"] | in-progress | npm publishing runs only when a `language/v*`, `analytical/v*`, `cli/v*`, or `mcp/v*` tag is pushed. Tags are created by ["./distribution.rq".deployment_flow]; the npm workflow does not publish on ordinary commits. The workflow builds platform binaries when `@reqlan/analytical` was bumped ( `analytical/v*` tag, or `analytical_tag` from the release workflow ). It does not use `github.event_name == 'workflow_call'` for that gate: in a reusable workflow that name is the caller event ( `push` ), and `npm_ref` is the first language / analytical / cli / mcp tag, so a language bump would skip natives. It then publishes each package in sequence with `pnpm --filter <pkg> publish --access public --no-git-checks`. The sequence is language, then all platform packages for [native_targets], then `@reqlan/analytical`, then cli, then mcp. The workflow does not publish `@reqlan/analytical` until every platform package of that `@reqlan/analytical` version is on the npm registry or was published in the same job ( [rust_binary_distribution] ). ["../../scripts/require-natives-published.mjs"] enforces that gate from the analytical package. json version ( not Changesets ). Before each package publishes, ["../../scripts/skip-already-published.mjs"] with `--filter <pkg>` checks the public npm registry and skips that step when the version is already published ( sets `should_publish=false` ). That avoids re-attempting already-published versions under OIDC. Auth uses npm trusted publishing ( OIDC ) from GitHub Actions — no long-lived `NPM_TOKEN`. Workflow requirements: `permissions.id-token: write`, Node ≥ 22. 14 with npm ≥ 11. 5. 1, registry `https://registry.npmjs.org`. Each of `@reqlan/language`, `@reqlan/analytical`, `@reqlan/cli`, `@reqlan/mcp`, and every `@reqlan/analytical-<platform>-<arch>` platform package must have a Trusted Publisher on npmjs. com for GitHub Actions with org / user `littletuna4`, repository `reqlan`, workflow filename `deploy-npm.yml`, allowed action `npm publish`. Package `repository.url` must match `https://github.com/littletuna4/reqlan.git`. Provenance attestations are generated automatically for public packages from this public repo. Bootstrap: first publish of each scoped package can be done locally ( you must be logged in to npm as an `@reqlan` org member ) with `pnpm --filter @reqlan/language publish --access public --no-git-checks`, then platform packages, then analytical, then cli, then mcp — or wait for the trusted-publisher CI path after packages exist and Trusted Publisher is configured. Note: Packages must be `private: true` to skip local `changeset publish` ( `pnpm run release:npm` ), as with `reqlan-extension`. Platform packages are in the Changesets `ignore` list ( `@reqlan/analytical-*` ). Git `@reqlan/analytical` does not list them as `optionalDependencies`. ["../../scripts/prepare-native-packages.mjs"] `--publish-versions` writes pinned optionalDependencies for the npm checkout only. CI publishes platform packages per-package after binaries are built and does not use `changeset publish` for those tarballs. Published packages declare `publishConfig.access: public`. Trusted Publisher is configured on npmjs. com for each `@reqlan/analytical-<platform>-<arch>` package | 0.266 | |
| prerelease_tests | ["../../.github/workflows/ci.yml"], ["../../.github/workflows/release.yml"], ["../../package.json"] | done | JS / TS package tests ( `pnpm run test:js` ) run after the shared TypeScript compile ( `pnpm run build:tsc` ) from this git checkout. GitHub CI runs them in the same job as crate tests and ["../core_analysis/check.rq".check], after that compile ( ["./distribution.rq".ci_gate] ). This job runs on every pull request and on main before versioning. Host native addon is required because analytical and language tests load `reqlan-napi`. The host release build compiles `reqlan-napi` only. Crate tests compile `reqlan-lsp`. That binary ships in the VSIX, not in this host package. Azure runs `pnpm run test:js` before VSIX publish ( [extension_distribution] ). Local `pnpm run test` runs `test:js` then `test:rust` ( ["../core_analysis/rust_port.rq".rust_crate_layout] ). The implementation lives in ["../../.github/workflows/ci.yml"]; ["../../.github/workflows/release.yml"] calls it with `workflow_call` as part of ["./distribution.rq".ci_gate]. Related: ["../core_analysis/check.rq".check_meta_implementation] | 0.069 | |
| repo_license | ["../../LICENSE"], ["../../package.json"], ["../../packages/extension/LICENSE"], ["../../crates/Cargo.toml"] | done | The repository root must declare the same licence as the publishable packages and crates. SPDX id: `AGPL-3.0-only`. The root must hold a `LICENSE` file with the GNU Affero General Public License version 3 text. The extension package `LICENSE` must use the same text as the root `LICENSE`. Package metadata must set `"license": "AGPL-3.0-only"` for the workspace root and for every publishable package under `packages/`. The Rust workspace must set `license = "AGPL-3.0-only"` in ["../../crates/Cargo.toml"]. | 0.040 | |
| docs_image_generation | ["../../site/scripts/docs-images/capture.mts"], ["../../site/scripts/build-static.mts"] | done | Images of HTML components for docs, READMEs, and slide packs are generated at build time from production UI. Prefer live HTML imported from production code when embedding is practical; otherwise capture PNGs from the same bundles. Deck asset keys are owned by ["../marketing_and_media/tutorials.rq".presentation_assets]. Pipeline: [docs_webview_build] → [docs_playwright_capture] → [site_reqs.sync_presentations]. | 0.040 | |
| docs_playwright_capture | ["../../site/scripts/docs-images/capture.mts"], ["../../site/scripts/docs-images/shots/catalog.ts"], ["../../site/scripts/docs-images/lib/write-harnesses.ts"], ["../../site/src/components/PresentationPlayer.tsx"] | done | Playwright loads each built webview via a harness page with a mocked `acquireVsCodeApi` host, posts demo index / context payloads, and writes PNGs into ["../../presentations/assets/"]. Generated assets replace the former coloured SVG stubs ( activity-bar, montage-ide, chat-search, file-link ). Wait for document load, then the shot ready selector. The Ideas Summary montage shot waits longer because the bundle is large. On a ready-selector timeout, print page errors and `#app` HTML. Runs as a step in ["../../site/scripts/build-static.mts"] before presentation sync. CI installs Chromium via `pnpm exec playwright install --with-deps chromium`. | 0.045 | |
| docs_webview_build | ["../../site/scripts/docs-images/lib/build-webviews.ts"], ["../../packages/extension/webviews/activity-bar/vite.config.ts"], ["../../packages/extension/webviews/ideas-summary/vite.config.ts"], ["../../packages/extension/webviews/onboarding/vite.config.ts"] | done | The site static build builds the extension webviews needed for docs captures before Playwright runs. Builds only the webviews listed by the capture catalog ( activity-bar, ideas-summary, onboarding ) — not a full extension VSIX. Uses the same Vite configs as [build_reqs.webview_build]. | 0.045 | |
| add_to_chat | ["../../../packages/extension/src/agent_module/ai_commands/register-ai-commands.ts"], ["../../../packages/extension/src/agent_module/ai_commands/open-chat.ts"], ["../../../packages/extension/package.json"] | done | A set of ["../host/features-commands.rq".command_palette] functions that add the selected idea, ideaset, or file to the chat. Commands: Add Idea / Ideaset / File to **Current** Chat ( primary ) and to **New** Chat ( secondary ); category Reqlan. Uses the idea / ideaset under the cursor ( or ideas overlapping the editor selection ) when in a. rq file; otherwise QuickPick. Primary: inject `#requirement` / `#file` context into the **current** chat input without submitting. Secondary: open a **new** chat / agent session, then seed the same payload into its input. Discoverability: editor context uses a **Reqlan: Add to Chat** submenu ( current + new for idea / ideaset / file ). Palette titles name Current vs New explicitly. Host APIs ( Cursor vs VS Code ) — see open-chat helper: - Cursor: `workbench.action.chat.open` always creates a **new** tab ( `openInNewTab: true` ); do **not** use it for current-chat. Current = `composer.focusComposer` + paste; New = `composer.createNew({ openInNewTab: true, partialState: { text, richText } })`. - VS Code Copilot: current = `workbench.action.chat.open` + `isPartialQuery: true`; new = `workbench.action.chat.newChat` then open. Clipboard fallback when no chat command is available. Host open helper: ["../../../packages/extension/src/agent_module/ai_commands/open-chat.ts"] ( `target: 'current' | 'new'` ). Activity bar search hits: ["../local-context/activitybar-panels/search.rq".search_add_to_chat] — split button with ▾ menu. | 0.061 | |
| ai_fix_stale_references | ["../../../packages/extension/skills/rq-fix-stale-references/SKILL.md"], ["../../../packages/extension/src/agent_module/ai_commands/register-agent-contributions.ts"], ["../../../packages/extension/package.json"] | done | A chat skill `/rq-fix-stale-references` finds and repairs unresolved idea, comment, file, import, and wildcard references. The issue list comes from ["../../core_analysis/check.rq".check] ( `reqlan check --json` ). Repair choices follow ["../language/support/features-imports.rq".import_error] and ["../mutation/refactor_support.rq".comment_reference_refactor_support]. Slash-command name uses [skills_and_mcp.chat_skill_naming]. | 0.048 | |
| mcp_check | [mcp_server] | done | MCP `check` wraps [check] for AI clients ( [mcp_server] ). The tool returns JSON issue rows in [check_order_by_target] order. An empty list means that there are no issues. Optional arguments match the CLI [check] flags: glob, wildcard-zero, wildcard-one, skip-targets, and skip-gitignored-targets. `glob` is one path pattern or a list of path patterns ( [check_glob_patterns] ). A file that matches any pattern is in the scan. Related: [mcp_tools] [check] ["../../core_analysis/check.rq".check_unresolved_imports] | 0.243 | |
| mcp_click_retrieval | [mcp_server], [click] | done | MCP `click` is the canonical search and retrieval tool ( [click], [mcp_server] ). One tool returns compact unique context, ranked ambiguous matches, or search hits. A second click on the same centre in the session returns connected content ( [agent_advisory] ). This surface maximises the token-to-insight ratio: names, short bodies, and caps — not edge dumps or full-graph lists. Keyword search, file context, local graph, and subtree expansion are click paths, not extra MCP tools. Agents must pass `sessionKey` on the next click. Related: [mcp_keyword_search], [mcp_tree_interrogation], [mcp_tree_summarisation]. | 0.144 | |
| mcp_diff | [mcp_server] | done | MCP `diff` wraps [diff] for AI clients ( [mcp_server] ). Arguments are optional `from`, optional `to`, and optional `verbosity` ( [diff_verbosity] ). The tool returns the same JSON array as `reqlan diff --json`. An empty array means that no idea changed. A missing revision is a tool error. Related: [mcp_tools] [diff] | 0.074 | |
| mcp_interaction_discovery | [mcp_server] | done | MCP clients discover tools through the MCP protocol tool list. Do not expose a list_interactions MCP tool. | 0.040 | |
| mcp_keyword_search | [mcp_click_retrieval], [click] | done | Keyword search across idea names, bodies, and attributes is a [click] path when no centre matches. Do not expose a separate MCP search tool. | 0.059 | |
| mcp_tools | [mcp_server] | done | The MCP server ( `@reqlan/mcp`, [mcp_server] ) exposes a small tool set for AI clients. Search and retrieval use [mcp_click_retrieval] only. Reference checks use [mcp_check]. Idea diffs use [mcp_diff]. Do not expose parse, search, list, file context, local graph, summarise subtree, requirement_reference, file_reference, or list_interactions as MCP tools. Those operations stay on AnalysisApi and CLI when they exist. Headless index storage follows [application_memory] ( `<base>/.reqlan` ), shared with the extension and CLI. | 0.097 | |
| mcp_tools_prompt | [mcp_server] | done | An mcp tool may provide a prompt-oriented entry point for working with the requirement graph. That tool must call [mcp_click_retrieval] for search and retrieval. It must not call the removed tools. | 0.040 | |
| mcp_tree_interrogation | [mcp_click_retrieval], [click] | done | File and idea neighbourhoods are a [click] unique result ( outbound, backlinks, siblings ). Do not expose a separate MCP file-context or local-graph tool. | 0.059 | |
| mcp_tree_summarisation | [mcp_click_retrieval], [click] | done | Compact subtree context is a [click] revisit: connected content for a centre already clicked in the session. Do not expose a separate MCP summarise-subtree tool. | 0.059 | |
| configuration_import_roots | ["../../../packages/language/src/reqlan-path-resolve.ts"], ["../../../packages/language/src/file-path-rewrite.ts"], ["../../../packages/language/src/reqlan-completion-provider.ts"], ["../../../packages/language/src/reqlan-path-completion.ts"], ["../../../packages/language/src/reqlan-comment-diagnostics.ts"], ["../../../packages/extension/src/extension/comment-reference-path-context.ts"], ["../../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../../packages/extension/schemas/config.schema.json"], ["../../../crates/reqlan-parse/src/path.rs"], ["../../../crates/reqlan-index/src/path_resolve.rs"], ["../../../crates/reqlan-index/src/broken.rs"], ["../../../crates/reqlan-index/src/sync.rs"], ["../../../crates/reqlan-lsp/src/analysis.rs"], ["../../../crates/reqlan-lsp/src/session.rs"] | `importRoots` is an optional array of alias-to-directory mappings in `.reqlan/config.json`. Each mapping has: - `alias` ( required non-empty string ): prefix before `/` in aliased import paths. - `root` ( optional non-empty string ): directory for that alias. A relative `root` resolves against the base root ( the parent of `.reqlan` ), not against the `.reqlan` directory. An absolute path or `file://` URI is used as that alias' import-root directory directly. When `root` is omitted for a mapping, that alias uses the workspace folder that contains the `.rq` file. When `importRoots` is omitted, empty, or has no valid entries, the default is one mapping with alias `importRootAlias` from ["../../../packages/analytical/src/core/defaults.json"] and no explicit root. When several aliases could match a path, the longest alias wins. Invalid or unreadable JSON, and a non-array `importRoots` value, fall back to defaults ( or no loaded config for discovery, then defaults at resolve time ). Language path forms and `@/` shorthand: ["../../language/imports.rq".import_paths] and ["../../language/imports.rq".configuration_import_root_alias]. Comment references in source files use the same mappings: ["../language/comment-references/functional-code-comment-references.rq".comment_reference_import_root_alias]. Schema: [configuration_schema_file]. Applying file discovery: [configuration_location]. Editor completion of aliased import paths: ["../language/syntax/features-syntax.rq".code_completion]. | 0.167 | ||
| configuration_location | ["../../../packages/language/src/reqlan-path-resolve.ts"], ["../../../crates/reqlan-index/src/path_resolve.rs"] | 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. | 0.190 | ||
| configuration_rqignore | ["../../../packages/analytical/src/core/rqignore.ts"], ["../../../packages/analytical/src/core/application-memory.ts"], ["../../../packages/analytical/src/core/create-base.ts"], ["../../../packages/analytical/src/core/base-discovery.ts"], ["../../../packages/analytical/src/index-store/workspace-index.ts"] | done | Each base may define path ignore rules in `.reqlan/.rqignore` using **gitignore syntax**. Patterns are relative to the base root ( parent of `.reqlan` ), not the `.reqlan` directory. Owned by `@reqlan/analytical` so the CLI, MCP, and extension share one filter for discovery and indexing walks. Built-in defaults always apply ( dependencies, venvs, build output, VCS / editor stores, `*.db3` / sqlite DBs and SQLite sidecars, binary globs per ["../index-host/index.rq".binary_ignore], files that have no comments per ["../index-host/index.rq".commentless_file_ignore], `*.secret.rq`, hidden entries, and `.reqlan/` itself ); the on-disk file adds or overrides via the same syntax, including `!` negation. New bases seed `.reqlan/.rqignore` with those defaults ( ["../index-host/index.rq".rqignore] ). Missing or unreadable `.rqignore` still uses built-in defaults. Location convention: [configuration_location]. Application memory: ["../index-host/index.rq".application_memory]. | 0.223 | |
| configuration_schema_file | ["../../../packages/extension/schemas/config.schema.json"], ["../../../packages/extension/package.json"], ["../../../crates/reqlan-index/src/ignore.rs"], ["../../../site/scripts/sync-config-schema.mts"] | done | The machine-readable JSON Schema for `.reqlan/config.json` is ["../../../packages/extension/schemas/config.schema.json"]. That file is the single authoring source. Its `$id` is the public URL `https://reqlan.com/schemas/v1/config.schema.json`. Path segment `v1` is schema compatibility version: additive keys stay on `v1`; breaking shape changes introduce `v2` and a new seed URL. The site hosts a synced copy under `/schemas/v1/` ( ["../../site/site.rq".sync_config_schema] ). The extension contributes the local schema for `**/.reqlan/config.json` via `jsonValidation` in ["../../../packages/extension/package.json"] ( offline editor path ). New bases seed `$schema` to the public `$id` ( ["./installation.rq".base_config_seed] ). `.reqlan/config.json` is a JSON object. Unknown properties are not part of the schema and are ignored when loading. `$schema` is an allowed property. | 0.105 | |
| barrel_page | ["../../../packages/analytical/src/core/barrel-page.ts"], ["../../../packages/cli/src/commands/barrel.ts"], ["../../../packages/cli/src/main.ts"], ["../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../packages/extension/src/mutation_module/refactor/register-barrel-page-command.ts"], ["../../../packages/extension/src/mutation_module/refactor/barrel-page-apply.ts"], ["../../../packages/extension/package.json"] | done | When a `.rq` page grows large, barrel it into a container: create one sibling file per top-level idea, import those files into the current page, and replace the page body with a single container idea whose name the user chooses ( default: the sanitized file basename ). Same-file sibling refs are rewritten to qualified imports in the child files. Existing page imports are copied into each child. Top-level ideasets are preserved in the container file. Behaviour lives in ["../../core-architecture.rq".analytical_package] and is exposed via [cli] / ["../../cli/cli_package.rq".commands] ( `reqlan barrel` ). Extension: file-level source code action **Barrel page into container … ** and command palette **Barrel Page** ( `reqlan.barrelPage` ) prompt for the container name, confirm, then create child files and rewrite the active page via WorkspaceEdit. Related: [file_based_code_actions] [decompose] | 0.184 | |
| code_actions_ignore_error | ["../../../packages/language/src/reqlan-ignore-error-action.ts"], ["../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../packages/extension/src/extension/register-ignore-error-code-actions.ts"], ["../../../packages/extension/src/extension/ignore-error-comment-filter.ts"], ["../../../packages/extension/src/extension/main.ts"] | done | A Quick Fix [code_actions] on a line with diagnostics inserts [comment_reference_ignore] ( `//rq-ignore-error` ) on the line before the error. The inserted comment uses the same indent as the error line. One action is offered per line when that line has one or more diagnostics. The action is omitted when that line is already suppressed, and when the client asks only for non-quickfix kinds. Available in `.rq` files and in a comment context in a code file ( ["../language/comment-references/functional-code-comment-references.rq".references_in_functional_code_comments] ). In `#` comments the action inserts `# //rq-ignore-error` so the line stays a comment. | 0.074 | |
| create_idea_below_idea_containing_unresolved_reference_under_cursor | ["../../../packages/language/src/reqlan-create-idea-below.ts"], ["../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../crates/reqlan-lsp/src/code_actions.rs"] | done | If a local idea reference does not resolve, a Quick Fix [code_actions] creates a new idea below the idea that contains the reference. The action uses the unresolved local idea names in the idea that contains the caret: - one unresolved name: apply `Create '<name>' below` directly - several unresolved names: offer `Create all unresolved ideas below` and one action per name Qualified file / import references are omitted. The new idea is an empty block inserted after the containing idea. | 0.074 | |
| file_based_code_actions | ["../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../packages/extension/src/mutation_module/refactor/register-barrel-page-command.ts"] | Code actions should be available for the whole file. The should include: ( regardless of cursor positions ) - barrel page — done via [barrel_page] ( `source.barrelPage` / `reqlan.barrelPage` ) - barrel idea - decompose idea - search for references. - create idea [code_actions] | 0.064 | ||
| search_code_actions | ["../../../packages/language/src/reqlan-idea-reference-site.ts"], ["../../../packages/language/src/reqlan-reference-search-site.ts"], ["../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../packages/extension/src/extension/reference-search-panel.ts"], ["../../../packages/extension/src/extension/reference-search-import-path.ts"], ["../../../packages/extension/src/shared/fuzzy-search.ts"], ["../../../packages/analytical/src/native/native-workspace-index.ts"], ["../../../packages/extension/src/extension/register-import-error-commands.ts"], ["../../../packages/extension/src/extension/main.ts"], ["../../../packages/extension/src/language/main.ts"] | done | when cursor is in a `[reference]`, there shouls be a code action to search for references to that idea. it should also allow wrapping a selected string, or the word at the cursor when in idea-body prose, as a new `[reference]`. it should open up a webview modal that shows a search dialog that allows the user to search for potential references. the search menu should preserve / show the context of the would-be reference: the rest of the containing idea, with styling, and with the selected text pulsing / styled prominently. it should support fuzzy / partial searching via [search_analysis.fuzzy_search]. it should list the closest matches in a paginated view. selecting the idea should fill / replace the reference ( or wrap the selection as `[name]` ) and an import ( if required ) appropiately The lightbulb command ( `reqlan.searchReference` ) is arg-less because VS Code caches arg-bearing code-action commands and may dispose them on refresh ( error text like Actual command not found ). At invoke time the extension resolves the site via LSP `reqlan/referenceSearchSite`, or a local parse of the active editor when the language client is not yet running — it must not fail with a false " language server is not ready " when a local site can be resolved. | 0.116 | |
| base_config_seed | ["../../../crates/reqlan-index/src/ignore.rs"], ["../../../packages/analytical/src/core/create-base.ts"] | done | New bases write `.reqlan/config.json` with `$schema` pointing at the public v1 schema URL via [create_base_impl]. Seed shape: `{"$schema":"https://reqlan.com/schemas/v1/config.schema.json"}`. Semantics and discovery of applying config: [configuration.configuration_location], [configuration.configuration_import_roots], [bases.base_configuration]. Schema / editor validation: [configuration.configuration_schema_file]. A child base does not inherit a parent base's config file. Existing bases are not rewritten ( idempotent create leaves them alone ). | 0.076 | |
| git_dates_background_indexing | ["../../../packages/extension/src/index_host_module/git-dates-background.ts"], ["../../../packages/extension/src/index_host_module/register-git-dates-background.ts"], ["../../../packages/analytical/src/index-store/sqlite-store.ts"], ["../../../crates/reqlan-index/src/git_dates.rs"] | done | Host wiring for [git_idea_timeline_analysis] / [indexer.git_dates]: after the ideas index is ready ( and when the catalog updates ), missing idea git dates must be filled by a mostly silent background process: - small batches - yields between batches so the extension host stays interactive - no progress UI / no blocking of Activity Bar context load or Timeline tab open - session-scoped attempted set so failed lookups are not hammered repeatedly - queue priority: ideas in the active `.rq` editor file are attempted before the global backlog; switching the active editor re-prioritises ( in-flight wave may stop and reschedule ) - catalog / save scheduling follows [git_dates_rate_cap] - git / node helper processes stay hidden per ["../../core_analysis/core.rq".consumption_silence] Consumers only read indexed columns; they must not invoke `git_dates` on the UI path. [git_idea_timeline_analysis] [indexer.git_dates] [git_dates_rate_cap] [ideas_summary_webview.timeline_page] | 0.158 | |
| git_dates_rate_cap | ["../../../packages/extension/src/index_host_module/git-dates-background.ts"], ["../../../packages/extension/src/index_host_module/register-git-dates-background.ts"] | done | Git history analysis is expensive ( `git log -L` and follow logs per idea ). Do not start a git_dates wave on every `.rq` save or catalog notify. Catalog and index-status events must debounce ( quiet period after the last notify ) and must wait a minimum gap after a wave that actually filled dates. Editor-switch priority and draining a capped wave may use the short idle delay. Distinct from ["./graph-analysers.rq".indexing_trigger_filesave]: the ideas index still updates on save; only git analysis is rate-capped. Related: [git_dates_background_indexing], [indexer.git_dates], ["./index.rq".idea_index_triggers], ["./index.rq".git_information_capture], ["../../core_analysis/core.rq".consumption_silence]. | 0.123 | |
| indexing_trigger_manual | ["../../../packages/analytical/src/index-store/base-registry.ts"], ["../../../packages/extension/src/analytical_submodule/index-store/index-service.ts"], ["../../../packages/extension/src/analytical_submodule/commands/register-commands.ts"] | Indexing should be triggered by manual indexing commands ( Refresh / Clear & rebuild ). Refresh and Clear & rebuild always rediscover bases first via ["../../bases/base.rq".refresh_rediscovers_bases] / ["../../../packages/analytical/src/index-store/base-registry.ts"] `refresh`, then soft-sync or rebuild the active base. | 0.092 | ||
| index_diagnostics_metrics | [diagnostics_store], ["../../../packages/analytical/src/index-store/workspace-index-file.ts"], ["../../../packages/analytical/src/index-store/workspace-index-sync.ts"], [workspace_index] | done | For each sync / index run on a base, record: - wall-clock **sum / total duration** of the pass - **file count** ( visited ), skipped-by-mtime count, indexed ( parse / persist attempted ) count, error count - **average path depth** of visited files ( segments under the base root ) - per-file **duration** and outcome ( `mtime_skip` | `mtime_refresh` | `hash_skip` | `persisted` | `error` ) Runs are attributable to a trigger ( `soft_sync` | `rebuild` | `enqueue` | `stale` ). Instrumentation wraps [workspace_index] soft sync and [indexer.nonblocking_index] single-file paths via [diagnostics_store]. | 0.120 | |
| index_diagnostics_webview | [diagnostics_panel], ["../../../packages/extension/src/index_host_module/diagnostics/register-index-diagnostics.ts"], ["../../../packages/extension/webviews/index-diagnostics/"] | done | An editor webview panel displays index timing diagnostics for the active base. Capabilities: - Base / latest-run summary: total time, file counts, average depth - Drill into recent runs - Rank files by duration ( slowest first ); show outcome and path depth Opened by command `reqlan.openIndexDiagnostics` ( [open_index_diagnostics] ). Optional entry from workspace index health ( [workspace_pane.workspace_pane] ) may link later; command is the primary entry. Implementation: [diagnostics_panel], [DiagnosticsApp]. | 0.145 | |
| binary_ignore | [rqignore_impl], ["../../../packages/analytical/src/core/rqignore.ts"], ["../../../crates/reqlan-index/src/ignore.rs"], ["../../../crates/reqlan-index/src/sync.rs"] | done | Discovery, coverage, and index walks skip binary files by default. Built-in [rqignore] patterns include a broad set of binary globs ( images, archives, packages, native objects, fonts, media, and office files ). Opt in with a gitignore negation in `.reqlan/.rqignore`. Example: `!*.bin` includes files with a `.bin` extension. Opted-in files can receive ["../../indexer/indexer.rq".index_code_files] comment indexing. They are not parsed as `.rq` sources. The editor source watcher stays on allowlisted text extensions. A soft sync indexes opted-in binary paths from the scan list. Idle stats stored paths and does not walk. Same filter as [configuration.configuration_rqignore]. | 0.201 | |
| commentless_file_ignore | [rqignore_impl], ["../../../packages/analytical/src/core/rqignore.ts"], ["../../../crates/reqlan-index/src/ignore.rs"] | done | Discovery, coverage, and index walks skip common files that have no comment syntax. The set includes JSON ( `.json`, `.jsonl`, `.ndjson` ), tabular data ( `.csv`, `.tsv` ), lockfiles, checksums, minified scripts, source maps, notebooks, and certificates. These files cannot hold `rq:` comment references. SQLite WAL, SHM, and journal sidecars stay with the database patterns in [rqignore] ( `*.sqlite-wal`, `*.sqlite-shm`, `*.sqlite-journal`, and the same suffixes on `.sqlite3`, `.db`, and `.db3` ). Opt in with a gitignore negation in `.reqlan/.rqignore`. Example: `!*.json`. JSON with comments ( `.jsonc`, `.json5` ) stays eligible for ["../../indexer/indexer.rq".index_code_files]. The seeded file lists the same patterns ( [rqignore_initialisation] ). | 0.188 | |
| index_diagnostics_store | ["../../../packages/analytical/src/index-store/index-diagnostics-store.ts"], [application_memory_impl] | done | Per-base diagnostic timing index at `<base>/.reqlan/index-diagnostics.sqlite`. Sibling of `ideas-index.sqlite`; not deleted by Clear & rebuild. Records sync runs and per-file durations for ["./index-diagnostics.rq".index_diagnostics_metrics]. Webview: ["./index-diagnostics.rq".index_diagnostics_webview]. | 0.223 | |
| rqignore | [rqignore_impl], [application_memory_impl], ["../../../packages/analytical/src/core/rqignore.ts"], ["../../../crates/reqlan-index/src/ignore.rs"], ["../../../packages/analytical/src/core/create-base.ts"], ["../../../packages/analytical/src/core/base-discovery.ts"], ["../../../packages/analytical/src/index-store/workspace-index.ts"] | done | `.reqlan/.rqignore` filters which paths discovery and indexing crawl, using gitignore syntax relative to the base root. Owned by [rqignore_impl] in `@reqlan/analytical` so CLI and editor share behaviour. Defaults cover `node_modules/`, virtualenvs, build dirs ( `bin/`, `generated/`, `out/` ), VCS / editor stores, database files ( `*.db3`, sqlite ) and SQLite sidecars, binary globs ( [binary_ignore] ), `*.html`, secrets, and hidden entries. Walks also skip common files that have no comments ( [commentless_file_ignore] ). New bases seed the file via [rqignore_initialisation]. Product configuration statement: [configuration.configuration_rqignore]. | 0.296 | |
| rqignore_initialisation | [rqignore_impl], ["../../../packages/analytical/src/core/rqignore.ts"], ["../../../crates/reqlan-index/src/ignore.rs"], ["../../../packages/analytical/src/core/create-base.ts"] | done | New bases seed `.reqlan/.rqignore` with comments that explain every feature of [rqignore], [binary_ignore], and [commentless_file_ignore]. Written when a base is created: ["../host/installation.rq".base_rqignore_seed] / ["../../bases/base.rq".base_initialisation]. Comments cover purpose ( discovery and index walks ), base-root relative paths, gitignore syntax, last matching rule, `!` negation, built-in defaults that always apply, binary opt-in, hidden paths, `*.secret.rq`, SQLite sidecars, files that have no comments ( [commentless_file_ignore] ), and `.reqlan/` itself. The seeded file is the editable surface. Built-in rules still apply if a user deletes a line. Existing `.rqignore` files are not rewritten ( ["../host/installation.rq".base_installation] is idempotent ). | 0.125 | |
| text_prefix_skip | ["../../../crates/reqlan-index/src/text.rs"], ["../../../crates/reqlan-index/src/sync.rs"] | done | Before any index content read, inspect at most the first 8 KiB. Skip the file when that prefix has a NUL, a UTF-16 BOM ( `FF FE` or `FE FF` ), or invalid UTF-8. A trailing incomplete UTF-8 code unit is not a skip: the rest of the file may finish the character. Skip when the file is larger than 1 MiB. A rejected prefix is not followed by a read of the remainder. `.rq` files and allowlisted code files use the same check. This is in addition to [binary_ignore] extension globs. | 0.092 | |
| analysis_api_dispose | [analysis_runtime], [analysis_api], [editor_index_adapter] | done | [analysis_runtime] `openAnalysisApi` dispose must close the native analysis runtime and drop its SQLite connection ( ideas index and click-sessions ). A no-op dispose is a defect. Extension commands use a short-lived `withAnalysisApi` ( open → run → dispose ) mediated by [analysis_runtime]; they must not cache `NativeAnalysisApi` for the session. | 0.040 | |
| event_driven_base_access | [editor_index_adapter], [base_registry], [analysis_runtime] | done | Extension interaction with bases is event-driven and goes through the analytical package: - Discover / pin / focus / file watch / command / UI query → open or `ensureBaseReady` - Sync, stale check, or analysis work runs - Quiet idle → [release_when_idle] No always-on connection and no continuous reconnect loop. Headless CLI / MCP already open per command via [analysis_runtime] ( [headless_sync_on_ready] ). | 0.057 | |
| release_when_idle | [editor_index_adapter], [base_registry], [workspace_index] | done | After an index or analysis pass finishes, and after the idle quiet period ( [idle_stale_check] / indexing_trigger_auto ), [editor_index_adapter] must release every open base SQLite handle via [base_registry] `releaseArtifacts` → [workspace_index] `deactivate`. Descriptors stay registered so the next event can reopen the same base. Idle must not leave connections open after a heal / sync, and must not schedule another open unless a real host event arrives ( file change, pin / switch, focus reopen, command, UI query ). | 0.077 | |
| sqlite_artifact_lifecycle | [editor_index_adapter], [base_registry], [workspace_index], [analysis_runtime], [analysis_api] | done | Base SQLite artifacts under `<base>/.reqlan/` ( [base_ownership] ) must not stay locked for the whole extension session. The host opens them only while work runs, then releases file handles so users can delete or replace the files. Aligns with [event_driven]: open and close are reactions to index or analysis events, not a permanent connection or a reconnect loop. Mediation: only [workspace_index] / [analysis_runtime] own SQLite connections. The extension adapter ( [editor_index_adapter] ) must not keep a second long-lived analysis runtime beside the index, and must not call native open without a matching dispose / release. Related: [index_sequencing], [idle_stale_check], [headless_consumers], [multi_base_environment]. | 0.052 | |
| comment_reference_import_root_alias | ["../../../../packages/language/src/reqlan-path-resolve.ts"], ["../../../../packages/language/src/reqlan-comment-diagnostics.ts"], ["../../../../packages/language/src/reqlan-comment-resolver.ts"], ["../../../../packages/extension/src/extension/comment-reference-path-context.ts"], ["../../../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../../../crates/reqlan-index/src/comment.rs"], ["../../../../crates/reqlan-parse/src/path.rs"] | done | Qualified comment references use the same path forms as imports, including import-root aliases such as `@/`. `rq:["@/path/relative/to/import/root.rq".idea]` resolves against the alias's import-root directory ( workspace folder by default ), not the source file directory. `@reqs` without a following `/` is not an alias. Configured aliases and roots follow ["../../../language/imports.rq".configuration_import_root_alias] and ["../../host/configuration.rq".configuration_import_roots]. The language server applies this when resolving comment references in `.rq` files. The extension applies the same core resolver for `rq:[…]` links in non- `.rq` source. Related: ["../../../language/syntax.rq".comment_reference], [references_in_functional_code_comments], ["../../../language/imports.rq".import_paths]. | 0.235 | |
| comment_reference_language_blocklist | ["../../../../packages/extension/src/extension/comment-reference-languages.ts"], ["../../../../packages/extension/src/extension/main.ts"], ["../../../../packages/extension/src/extension/register-definition-navigation.ts"], ["../../../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../../../packages/extension/src/extension/register-ignore-error-code-actions.ts"], ["../../../../packages/extension/package.json"] | done | Comment rq editor features ( goto, diagnostics, ignore actions, navigate-back origin tracking ) apply to every language except a small blocklist. The blocklist is `reqlan` plus non-source editor buffers ( log, search-result, SCM input, git commit / rebase, github-issues ). The rust language client uses a file-scheme document selector and skips sync for blocklisted languages. TextMate resting underline injects into a wide `injectTo` scope list ( best-effort; goto still works without a matching grammar scope ). Related: [references_in_functional_code_comments], [comment_reference_resting_underline], ["../../../language/syntax.rq".comment_reference]. | 0.178 | |
| comment_reference_navigate_back | ["../../../../packages/extension/src/extension/definition-navigation.ts"], ["../../../../packages/extension/src/extension/definition-navigation-stack.ts"], ["../../../../packages/extension/src/extension/register-definition-navigation.ts"], ["../../../../packages/extension/package.json"] | done | A go-to-definition JUMP from a comment `rq:[…]` host must push the pre-jump caret onto the same navigate-back stack as `.rq` jumps. The stack tracks every non-blocklisted language ( ["../../../../packages/extension/src/extension/comment-reference-languages.ts"] ) as well as `.rq`. Only landings in `.rq` / `reqlan` are recorded, so other language servers do not fill the stack. Alt + Left ( `reqlan.navigateBack` ) restores that caret when `reqlan.canNavigateBack` is set, in any focused editor. Related: [references_in_functional_code_comments], [comment_reference_language_blocklist], ["../syntax/features-syntax-highlighting.rq".editor_reference_activation]. | 0.114 | |
| comment_reference_resolution_error_state | ["../../../../packages/language/src/reqlan-comment-diagnostics.ts"], ["../../../../packages/language/src/reqlan-neighbor-parse.ts"], ["../../../../packages/language/src/reqlan-document-builder.ts"], ["../../../../packages/language/src/reqlan-document-link-provider.ts"], ["../../../../packages/language/src/reqlan-validator.ts"], ["../../../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../../../crates/reqlan-lsp/src/session.rs"], ["../../../../crates/reqlan-index/src/comment.rs"] | done | [comment_reference_resolution_error] The language server must share one resolution result for clickable links and the error underline. Resolve comment references once against the loaded idea index, then reuse that result for both consumers. When you create an idea that matches a comment reference, the language server must clear the underline and the missing-idea message. Resolution and the index should be performed once and shared between consumers. | 0.053 | |
| comment_reference_resting_underline | ["../../../../packages/extension/grammars/reqlan-comment.injection.json"], ["../../../../packages/extension/package.json"] | done | In non- `.rq` source comments, every `rq:[…]` token must show a resting underline so it is clear the site is link-shaped. Use TextMate scope `meta.link.reqlan markup.underline` via the comment injection grammar. Do not rely on file document links for that cue — those stay stripped ( ["../syntax/features-syntax-highlighting.rq".editor_reference_activation] ). Navigation remains Ctrl + click go-to-definition for resolved sites ( [references_in_functional_code_comments] ). Related: [references_in_functional_code_comments], ["../syntax/features-syntax.rq".comment_support]. | 0.146 | |
| references_in_functional_code_comments | ["../../../../crates/reqlan-lsp/src/session.rs"], ["../../../../packages/extension/src/extension/main.ts"], ["../../../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../../../packages/extension/grammars/reqlan-comment.injection.json"] | done | Comments in functional code should be able to reference reqlan ideas using the an `rq:` prefixed to an idea: `rq:[idea]` as demonstrated in python, but actually applicable to any language's comment context: Editor hosts are every language except [comment_reference_language_blocklist]. With the rust language server, a resolved `rq:[…]` site is Ctrl + click navigable via go-to-definition. File document links stay out of the editor ( ["../syntax/features-syntax-highlighting.rq".editor_reference_activation] ). Comment `rq:[…]` sites use TextMate `meta.link.reqlan markup.underline` so the resting editor shows they are link-shaped ( [comment_reference_resting_underline] ). After that goto, Alt + Left restores the comment-host caret ( [comment_reference_navigate_back] ). Missing ideas keep the error underline and have no definition target. Relates to ["../../mutation/refactor_support.rq".comment_reference_refactor_support], [comment_reference_import_root_alias], ["../support/language-server-rust.rq".language_server_rust], ["../syntax/features-syntax-highlighting.rq".editor_reference_activation]. | 0.300 | |
| anonymous_reference_code_completion | ["../../../../packages/language/src/reqlan-path-completion.ts"], ["../../../../packages/language/src/reqlan-completion-provider.ts"], ["../../../../packages/language/src/reqlan-completion-context.ts"] | Anonymous imports should share the same code completion e. g. ["@/reqlan rq/extension/language/syntax/features-syntax.rq"] should complete the same as `import "@/reqlan rq/extension/language/syntax/features-syntax.rq" as code_completion`. they should share the same code and logic | 0.053 | ||
| implicit_file_extension | ["../../../../packages/language/src/reqlan-imports.ts"], ["../../../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../../../packages/language/src/reqlan-outbound-presentation.ts"], ["../../../../packages/language/src/reqlan-local-symbolic-links.ts"] | The import statements should not require an extension, i. e. it should assume ". rq " unless otherwise specified. An extensionless path resolves to the ". rq " file first, then to a literal extensionless file or folder. A path that already carries any extension is resolved exactly as written. Folder targets: [import_folder_targets]. | 0.195 | ||
| import_code_completion_auto_file_import | ["../../../../packages/language/src/reqlan-completion-provider.ts"], ["../../../../packages/language/src/reqlan-import-edits.ts"] | done | When a code completion for an idea in another file is selected, the import should be automatically added to the current file. This prevents the user from selecting a presented idea, and then having to add the import for the same thing. Uses the same from-import insertion as [import_error] quick fixes; skips the edit when the idea is already imported. [reference_code_completion] [import_code_completion] [import_code_completion_rendering] [import_error] | 0.066 | |
| import_code_completion_explicit_extension | ["../../../../packages/language/src/reqlan-path-completion.ts"], ["../../../../packages/language/src/reqlan-completion-provider.ts"] | Completions insert paths with an explicit `.rq` extension. [implicit_file_extension] Hand-written imports may still omit the extension; completion prefers the written form with `.rq`. | 0.047 | ||
| import_code_completion_path_segments | ["../../../../packages/language/src/reqlan-path-completion.ts"], ["../../../../packages/language/src/reqlan-completion-provider.ts"] | In a folder context, show next path segments ( directories with a trailing `/` ). After `../`, offer `../path/` before nested `../path/file.rq`. | 0.047 | ||
| import_code_completion_ranking | ["../../../../packages/language/src/reqlan-path-completion.ts"], ["../../../../packages/language/src/reqlan-completion-provider.ts"] | Rank import path completions by directory proximity ( hop count from the completing file's directory to the candidate's directory ), then directories before files, then path alphabetically. Example: typing `../` ranks `../close.rq` before `../../../path.rq`. Emit sortText for that order, and set filterText so the editor does not re-rank by label fuzzy score over proximity. | 0.053 | ||
| import_code_completion_rendering | ["../../../../packages/language/src/reqlan-completion-provider.ts"] | done | Reference code completion for ideas from other files shows the relative import path in the completion detail. Same-file ideas omit the path detail. [reference_code_completion] [import_code_completion] [import_code_completion_auto_file_import] | 0.066 | |
| import_code_completion_substring_match | ["../../../../packages/language/src/reqlan-path-completion.ts"], ["../../../../packages/language/src/reqlan-completion-provider.ts"] | Filter path candidates by search within the path, not only a starts-with prefix. Typing `path` should match `../../parent/path.rq`. Typing `hellopath` should match `../../hello/inbetween/path/file.rq` ( characters matched in order across path segments ). | 0.047 | ||
| import_does_not_exist_error | ["../../../../packages/language/src/reqlan-validator.ts"], ["../../../../packages/language/src/reqlan-imports.ts"], ["../../../../crates/reqlan-index/src/broken.rs"] | Imports show an underline error when the target file or folder does not exist. Imports also show an underline error when a named imported idea does not exist in the target file. An existing folder is not an error: [import_folder_targets]. CI: ["../../../core_analysis/check.rq".check_unresolved_imports]. [general_errors] | 0.151 | ||
| import_error | ["../../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../../packages/extension/src/extension/register-import-error-commands.ts"] | done | " Could not resolve reference " errors offer Quick Fix code actions ( lightbulb and editor right-click Quick Fix ). Fixes: - Add import from a matching idea found in loaded documents or the name catalog pushed from the index - Rewrite the reference to an anonymous qualified form `["path".name]` - Search the index for matching ideas, ideasets, or files ( same `reqlan.searchReference` path as [code_actions] / ["../../host/features-commands.rq".search_code_actions] ), then insert an import - Create the idea in a new. rq file and import it [general_errors] [code_actions] [quick_fixes] | 0.078 | |
| import_folder_targets | ["../../../../packages/language/src/reqlan-imports.ts"], ["../../../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../../../packages/language/src/reqlan-validator.ts"] | done | An import path may refer to a folder. A folder is a valid import target when that path exists as a directory. Namespace import of a folder binds the alias to that folder, the same as a file. Extensionless paths still prefer a `.rq` file: [implicit_file_extension]. Related: ["../../../language/imports.rq".import_paths], [import_does_not_exist_error], ["../syntax/features-syntax.rq".file_references]. | 0.164 | |
| index_file_search_coalesce | ["../../../../packages/extension/src/shared/share-in-flight.ts"], ["../../../../packages/extension/src/analytical_submodule/index-store/index-service.ts"] | done | Index startup does not call `findFiles` or ripgrep / `searchtext.exe`. The native workspace scan ( ["../../../indexer/cache-reuse.rq".single_sync_walk] ) is the one directory walk. Overlapping rediscover and sync callers share that in-flight scan. The scan applies `.rqignore` ( ["../../../indexer/indexer.rq".nonblocking_index] ). Related: [lsp_file_watch], ["../../index-host/index.rq".rqignore], ["../../../indexer/sequencing.rq".scan_limits]. | 0.051 | |
| lsp_file_watch | ["../../../../packages/language/src/reqlan-document-update-handler.ts"], ["../../../../packages/language/src/reqlan-module.ts"] | done | 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]. | 0.085 | |
| file_reference_errors | ["../../../../packages/language/src/reqlan-validator.ts"], ["../../../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../../../packages/language/src/reqlan-document-link-provider.ts"], ["../../../../packages/language/src/reqlan-ignore-error.ts"], ["../../../../packages/language/src/reqlan-embedded-file-references.ts"], ["../../../../crates/reqlan-lsp/src/analysis.rs"], ["../../../../crates/reqlan-index/src/path_resolve.rs"] | done | If a [file_reference] is not found, is broken, or cannot be resolved, the language server must show an underline. Do not show the underline when [comment_reference_ignore] ( `//rq-ignore-error` ) is on the line before. Missing files: error underline, no document link. Do not underline examples inside [inline_code] or ["../../../language/syntax.rq".code_snippets]. Empty files and files with parse errors: warning underline; the document link stays. Import-root aliases such as `@/` resolve the same way as ["../../../core_analysis/check.rq".check] and ["../../../language/imports.rq".configuration_import_root_alias]. Related: [general_errors], [comment_reference_resolution_error], [inline_code], ["./features-imports.rq".import_does_not_exist_error], ["../syntax/features-syntax.rq".file_references]. | 0.092 | |
| language_server_rust | ["../../../../crates/reqlan-lsp/src/lib.rs"], ["../../../../crates/reqlan-lsp/src/server.rs"], ["../../../../crates/reqlan-lsp/src/session.rs"], ["../../../../crates/reqlan-lsp/src/analysis.rs"], ["../../../../crates/reqlan-lsp/src/hover_content.rs"], ["../../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../../packages/extension/src/extension/language-server-launch.ts"], ["../../../../packages/extension/src/extension/main.ts"], ["../../../../scripts/collect-napi-binary.mjs"], ["../../../../scripts/stage-host-native.mjs"], ["../../../../scripts/package-extension-targets.mjs"], ["../../../../azure-pipelines.yml"] | in-progress | A Rust binary replaces the Langium language-server process. The extension launches `reqlan-lsp` over stdio. Open `.rq` buffers parse with [parser_rust]. The open sequence is ["open-file-sequencing.rq".open_file_algorithm]. Workspace names and rename targets come from the ideas index under [application_memory]. Inbound hints wait for the host snapshot of that index. The inbound inlay hover is markdown. It lists each referencer as a file link. An idea hover shows styled idea content when ["../syntax/features-syntax.rq".idea_content_tooltip] is on. A closed file has no retained syntax tree. Go-to-definition cost is ["../syntax/features-syntax-highlighting.rq".reference_goto_definition_speed]. When the engine is `rust`, the server also serves `rq:[…]` document links, go-to-definition, and missing-idea diagnostics in non- `.rq` comments. One resolution supplies the link, the definition target, and the underline. The host strips file document links; Ctrl + click uses definition ( ["../syntax/features-syntax-highlighting.rq".editor_reference_activation] ). The host serves those links when the engine is `node`. Host commands prefer LSP custom requests, napi extract, and the ideas index. Move / delete planners still use Langium until index-backed planners land. The setting `reqlan.languageServer.engine` selects the binary. The default is `rust`. `node` remains only when the setting says so, or when the binary is not on disk yet. A local extension build compiles this binary with the napi addon ( [extension_host_native_stage] ). The extension launches `bin/reqlan-lsp`, else that release build. It never launches a debug build, because a debug build is slow and the extension build does not refresh it. Code actions match ["../vsc-primitives.rq".code_actions]: ignore, create below, import fixes, search or wrap, idea move and delete, and barrel page. Attribute and name catalogs drive completion. Rename and find-references use open buffers plus the ideas index. Inlay hints honour `reqlan.referencesInlayHints.enabled` and the host inbound snapshot. An import link uses the parser token span ( [import_from] ). The path links to the file. An imported idea name and its alias each link to that declaration. A namespace reference links the alias and the idea as separate names. A missing leaf reports an unresolved idea on that name. Related: [language_server], [grammar_and_parser], [analytical_rust_port], [vsix_export]. | 0.580 | |
| ast_lifecycle | [lsp_session], [lsp_analysis], [lsp_server] | done | The open buffer has one model. That model is the Rust parse of this buffer. [local_symbolic_analysis] is a file-local extract. The hot path does not run it as a second parse. Related: [open_file_algorithm], [open_file_sequence_diagram], [outbound_one_hop], [token_colour_sequence], [parse_budget_timeout], ["./initialisation-and-sequencing.rq".lsp_file_watch], [language_server_rust]. Populate. Parse this buffer when the editor opens it. Semantic tokens, same-file links, and the import list come from that parse. Replace. When this buffer text changes, parse again and replace the model. Do not patch the old model. A watched `.rq` change uses the same replace path ( [document_update_handler] ). When the text is unchanged, keep the current model. Drop. When the editor closes the buffer, drop the model. A closed file keeps no syntax tree ( [language_server_rust] ). Import files. [outbound_one_hop] stores a name list for each imported file. That list is not an open-buffer model. A change to an imported file does not replace this buffer's model. Read the imported file again when its content hash changes. Incomplete parse. When the budget fails, store an empty model plus diagnostics ( [parse_budget_timeout] ). Idea names stay empty until a later successful parse. The node engine follows [node_engine_open_path]. | 0.249 | |
| comment_backlink_sequence | [lsp_session], [comment_diagnostics], [comment_links_host], ["../../../../packages/language/src/reqlan-comment-resolver.ts"] | in-progress | `rq:[idea]` and `rq:["path".idea]` in code comments use one resolution for the link and the underline. A qualified path reads that `.rq` file, parses idea names, then links or errors. That read belongs to the comment file. Opening a different `.rq` buffer must not re-resolve every comment buffer. An unqualified name searches open `.rq` buffers first. The index snapshot may add a match later ( [lazy_features_after_outbound] ). Do not call `list_all_ideas` for that search. Do not create a document link when the idea is not confirmed. Related: [comment_reference_resolution_error_state]. | 0.103 | |
| file_crawl_sequence | ["../../../../packages/analytical/src/index-store/workspace-index.ts"], ["../../../../crates/reqlan-index/src/sync.rs"], [inbound_sync], [lsp_server] | done | Workspace crawl is the indexer ( [index], [index_sequencing] ). It is not the open-file path. Native sync walks `.rq` files, then allowlisted code files, and writes SQLite. Open-file links must not wait for that walk ( [open_file_algorithm] ). The language server watches `.rq` files only ( ["./initialisation-and-sequencing.rq".lsp_file_watch] ). Related: [extension_startup_sequence], [background_startup]. | 0.040 | |
| lazy_features_after_outbound | [lsp_session], [lsp_server], [inbound_sync], ["../../../../packages/extension/src/extension/main.ts"] | done | After the hot path is on screen, show the rest when its data is ready. This pass must not delay [open_file_algorithm] steps 1 – 5. Related: [language_server], [unify_inbound_indexes], [background_startup], [inlay_hints], [codelens]. Work: - Confirm each qualified reference. Read that target file once, at depth 1. Then paint the idea line or the missing-idea error ( [missing_reference_colour_sequence] ). - Inbound backlinks: inlay hints and the file-top CodeLens, from the host snapshot ( [unify_inbound_indexes] ). - Attribute and name catalogs for completion and quick fixes. - Unqualified comment matches from that snapshot ( [comment_backlink_sequence] ). Until the first ready snapshot arrives, inlay hints and the file CodeLens stay empty. Those handlers do not open SQLite and do not call `list_all_ideas`. Later updates are incremental ready-state events ( ["../../../indexer/cache-reuse.rq".inbound_snapshot_events] ); last-good stays until replaced. When a ready snapshot arrives, refresh the visible editors. | 0.283 | |
| missing_reference_colour_sequence | [lsp_analysis], [lsp_session], [outbound_presentation], [document_links] | done | Paint links and errors in two steps. The hot path paints same-file names and import targets ( [outbound_one_hop] ). The background pass paints qualified-reference idea lines ( [lazy_features_after_outbound] ). Related: [unresolved_reference_diagnostics], [reference_rendering], [file_reference_errors], [import_does_not_exist_error]. Hot path: - URL references: document link, no error. - Wildcard references: document link, no error underline for zero matches. - Import path missing: error underline, no document link. - Imported idea present: document link to that idea line. - Imported idea missing: error underline, no document link. - Same-file idea missing: error underline, no document link. - Qualified reference: document link to the file from the path token. Do not underline a missing idea yet. Background pass: - Qualified idea present: document link to that idea line. - Qualified idea missing: error underline, and remove the document link. - Drop a false missing-idea error only for the range that this pass confirms. Keep a different missing name on the same line. | 0.153 | |
| native_cache_retention | [lsp_session], [editor_retention], [neighbor_parse], [document_update_handler] | done | The language server keeps the open-buffer model for each open editor. It keeps a depth-1 name list for each imported file, and for each qualified-reference file the background pass has confirmed, while an open editor still needs that list. A closed editor drops its model. It also drops name lists that no open editor still needs. A file-watcher delete drops that URI from both caches. A check of a closed file may parse it once. That result is not stored. Related: [open_file_hot_path], [outbound_one_hop], [ast_lifecycle]. | 0.072 | |
| node_engine_open_path | [document_factory], [document_builder], [async_parser], [parse_budget], [workspace_manager], [scope_provider], [local_symbolic_links], [neighbor_parse], [outbound_presentation], [document_links], [language_server_main], ["../../../../packages/language/src/reqlan-linker.ts"], ["../../../../packages/language/src/reqlan-reference-peek.ts"] | done | This idea applies when `reqlan.languageServer.engine` is `node`. The default engine is [language_server_rust]. The node server populates a Langium AST for the open buffer at `DocumentState.Parsed`. Later builder phases attach scopes, links, and diagnostics. They must not replace that AST. Parsed-time handlers must not read Langium `.ref`. Use `$refText`, the symbolic extract, or `peekResolvedRef` until `ComputedScopes`. The linker must not resolve a cross-reference while that document is below `ComputedScopes`. Do not log the Langium warning. Do not store a failed link. Scope lookup, code lens, completion, and idea summaries use `readResolvedRef` or `peekResolvedRef` until that phase. When another `.rq` file changes, relink this document when the index says it is affected, when comment references name that file, or when this document's outbound targets include the changed URI. Do not relink every document that still has a linker error. Workspace load parses at most 8 files at a time ( [workspace_parse_concurrency] ). `fileIdeasCache` and `importPathCache` drop a URI when that document is removed ( [scope_cache_release] ). Related: [open_file_algorithm], [ast_lifecycle]. | 0.133 | |
| open_file_algorithm | [lsp_session], [lsp_analysis], [lsp_server] | done | When the editor opens or changes a `.rq` buffer, `reqlan-lsp` runs this sequence. Do not wait for the ideas index. Do not wait for a workspace crawl. Detail: [open_file_sequence_diagram]. Related: [open_file_reference_sequencing], [language_server_rust], [ast_lifecycle], [outbound_one_hop], [open_file_hot_path], [token_colour_sequence], [missing_reference_colour_sequence], [lazy_features_after_outbound]. The hot path finishes before the first diagnostics publish. 1. Parse this buffer once ( [ast_lifecycle] ). 2. Colour tokens from that parse ( [token_colour_sequence] ). 3. Emit same-file links and same-file missing-idea errors from that parse. 4. Parse each imported file once, at depth 1, for idea names and lines ( [outbound_one_hop] ). Link an imported name that exists. Underline an imported name that does not ( [missing_reference_colour_sequence] ). 5. Return. A qualified reference may link to its file from the path token. Do not read that file on this path. After that publish, a background pass fills the rest ( [lazy_features_after_outbound] ). That pass must not delay steps 1 – 5. The server sends the hot publish before it starts that pass. It runs that pass only while no client message waits. A hover or a definition request goes first. A change reuses the import roots loaded at open. It does not read the config again. The node engine keeps [node_engine_open_path]. | 0.330 | |
| open_file_hot_path | [lsp_session], [lsp_analysis], [lsp_server] | in-progress | Open-file work stays on the one parse of this buffer plus one parse per imported file. Reuse that model for document links, go-to-definition, hover, and diagnostics until the text or the import-root mapping changes. Keep that model, and the import name lists, only for open editors ( [native_cache_retention] ). Look up an open import by URI. Do not match on file basename. Do not read SQLite. Do not call `list_all_ideas`. At parse time, publish lex and parse diagnostics with same-file and import errors. The editor must not wait for a workspace link phase to see a broken parse. Handlers on this path read the open model. They do not build a workspace link graph. Related: [open_file_algorithm], [outbound_one_hop], [ast_lifecycle], [comment_backlink_sequence]. | 0.186 | |
| outbound_one_hop | [lsp_session], [lsp_analysis], [native_parse] | done | The hot path parses imported files only. For each import in the open buffer, parse that file once, then stop. Read idea names, idea lines, and import aliases. Do not parse files that the import references. Do not read SQLite. Prefer the open buffer text when that import is already open and dirty. Cache each parse by path plus file stamp ( modified time and size ) ( [lsp_session] ). A current stamp is one `stat`. Read and parse the file only when the stamp changed. Cache the open buffer by URI plus text fingerprint ( [open_file_hot_path] ). [local_symbolic_analysis] stays file-local. This hop is outside that extract. An extensionless import path prefers `.rq`, then the path as written ( [implicit_file_extension] ). A qualified reference that is not an import waits for [lazy_features_after_outbound]. Related: [open_file_algorithm], [non_web_reference_navigation]. | 0.246 | |
| scope_cache_release | [scope_provider] | done | This idea applies when the engine is `node` ( [node_engine_open_path] ). `fileIdeasCache` and `importPathCache` drop a URI when that Langium document is removed. A version change still replaces the entry for a document that stays. The rust server drops the open model in [native_cache_retention]. Related: [open_file_hot_path], [native_cache_retention]. | 0.057 | |
| token_colour_sequence | ["../../../../packages/language/syntaxes/reqlan.tmLanguage.json"], [semantic_tokens], [lsp_analysis], [language_server_main] | done | Token colour has two layers. They must not wait for the ideas index. TextMate paints first from the buffer text. Semantic tokens paint from the one parse ( [ast_lifecycle] ). A second extract does not paint tokens. A missing reference keeps the same token colour. The error underline is a diagnostic ( [missing_reference_colour_sequence], [reference_rendering] ). Related: [syntax_highlighting]. | 0.117 | |
| workspace_parse_concurrency | [workspace_manager] | done | This idea applies when the engine is `node` ( [node_engine_open_path] ). Workspace load parses `.rq` files with a fixed limit of 8 in flight. One file that fails to parse does not cancel the other files. The steady-state set is still every workspace `.rq` file. The rust server does not parse the workspace. A closed file keeps no syntax tree ( [language_server_rust] ). Related: [ast_lifecycle], [workspace_manager]. | 0.057 | |
| aliased_from_import_ctrl_click | ["../../../../packages/language/src/reqlan-local-symbolic-links.ts"], ["../../../../packages/language/src/reqlan-imports.ts"], ["../../../../crates/reqlan-index/src/extract.rs"] | done | A from-import alias that contains the imported idea name as a suffix or substring must offer one Ctrl + click destination for the whole written alias. Example: `from "@/_charter/plant-ontology.rq" import simulation as ontology-simulation` then `[ontology-simulation]`. The document-link underline must cover `ontology-simulation`, not only `simulation`. Ctrl + click on any character of that alias must open the imported idea in the import-root target file. Do not resolve the import path a second time against the current file directory. Do not offer a second interactive link on the original idea-name suffix. Related: [reference_document_links], [reference_underline_syntax_align], [non_web_reference_navigation], ["../../../language/imports.rq".import_from], ["../../../language/imports.rq".configuration_import_root_alias]. | 0.086 | |
| editor_reference_activation | ["../../../../packages/language/scripts/patch-textmate.mjs"], ["../../../../packages/language/syntaxes/reqlan.tmLanguage.json"], ["../../../../packages/extension/grammars/reqlan-comment.injection.json"], ["../../../../packages/extension/language-configuration.json"], ["../../../../packages/extension/src/extension/editor-link-activation.ts"], ["../../../../packages/extension/src/extension/register-editor-link-activation.ts"], ["../../../../packages/extension/src/extension/definition-navigation.ts"], ["../../../../packages/extension/src/extension/definition-navigation-stack.ts"], ["../../../../packages/extension/src/extension/register-definition-navigation.ts"], ["../../../../packages/extension/src/extension/main.ts"], ["../../../../crates/reqlan-lsp/src/analysis.rs"], ["../../../../crates/reqlan-lsp/src/session.rs"] | done | A file reference and an idea reference have no underline in the resting editor. The editor shows an underline when the user holds Ctrl and the pointer is on that reference. Ctrl + click follows the reference in the active editor. A target in the open file moves the cursor in that editor. A target in another file opens in the active editor group. The editor does not open a second copy of the current file. The editor does not open a browser page for a file or idea reference. Alt + Left is navigate-back. It restores the caret from before go-to-definition. The extension keeps that JUMP on a reqlan stack because Cursor often skips the editor history entry for same-file definition. The stack also records jumps that start in comment-reference host languages ( ["../comment-references/functional-code-comment-references.rq".comment_reference_navigate_back] ). Definition targets prefer an open workspace tab URI so Cursor does not open a detached file copy. The definition target range must move the caret ( not an empty 0: 0 – 0: 0 range ). A click that is already on the declaration name is not a JUMP. The TextMate scope is `meta.link.reqlan`. A `markup.underline` scope forces an underline in the resting editor. `.rq` file and idea references omit `markup.underline` — no resting underline. Comment `rq:[…]` sites add `markup.underline` via the comment injection grammar ( ["../comment-references/functional-code-comment-references.rq".comment_reference_resting_underline] ). A file document link is always underlined, and its `#L` URI opens another editor. The extension does not give the editor a file document link. Ctrl + hover uses the definition request. That request is [reference_goto_definition_speed]. The interactive underline is the lexer token under the cursor: the path string or the idea id from the parser. Definition returns `LocationLink.originSelectionRange` for that token so the editor does not invent a word from brackets or quotes. Path segment names inside a quoted path are not reference tokens. The host does not register a DefinitionProvider for other languages, and does not rescan open source files for this activation. When the engine is rust, the language-server document selector includes all file-scheme documents except the comment-host blocklist, and definition navigates resolved `rq:[…]` sites ( ["../comment-references/functional-code-comment-references.rq".references_in_functional_code_comments], ["../comment-references/functional-code-comment-references.rq".comment_reference_language_blocklist] ). A web URL and a command link ( folder, wildcard ) stay document links. A click on a web URL opens that URL in the browser. Related: [reference_document_links], [non_web_reference_navigation], [reference_goto_definition_speed]. | 0.254 | |
| import_statement_highlighting | ["../../../../packages/language/scripts/patch-textmate.mjs"], ["../../../../packages/language/syntaxes/reqlan.tmLanguage.json"], ["../../../../packages/language/src/reqlan-semantic-token-provider.ts"] | done | TextMate highlighting for import lines must colour the whole statement, not only the leading `from` / `import` keyword. After `import` ( and after `from` … `import` ), the quoted path, the `import` / `as` keywords, and idea / alias names must receive scopes — they must not stay default-white while still looking interactive from a path document link alone. Root cause: a short `^\\b(from|import)\\b` match ran before the path patterns and consumed the keyword so the path never scoped. Fix: line-scoped `meta.import.reqlan` begin / end rules that paint path, keywords, and names. Semantic tokens still paint import AST nodes ( and must `return` after handling them ). | 0.064 | |
| non_web_reference_navigation | ["../../../../packages/language/src/reqlan-document-link-provider.ts"], ["../../../../packages/language/src/reqlan-local-symbolic-links.ts"], ["../../../../packages/language/src/reqlan-neighbor-parse.ts"], ["../../../../packages/language/src/reqlan-definition-provider.ts"], ["../../../../crates/reqlan-lsp/src/analysis.rs"] | done | Non-web references ( idea brackets / wikilinks, local file paths, import paths ) must be Ctrl + click navigable via document links and / or go-to-definition. Built-in http ( s ) link detection is not enough. The rust engine builds same-file links and import-target links on the open path ( ["../../../language/syntax.rq".open_file_reference_sequencing], ["../support/open-file-sequencing.rq".outbound_one_hop] ). When the engine is node, idea underlines use the path-local Rust extract ( ["../../../indexer/indexer.rq".local_symbolic_analysis] ), and go-to-definition uses Langium when the idea ref is already linked. Qualified-reference idea lines follow ["../support/open-file-sequencing.rq".lazy_features_after_outbound]. Related: [reference_document_links], [reference_goto_definition_speed], [reference_underline_syntax_align], ["../../../language/syntax.rq".open_file_reference_sequencing]. | 0.163 | |
| reference_code_completion_objects | ["../../../../packages/language/src/reqlan-completion-provider.ts"], ["../../../../packages/language/src/reqlan-completion-context.ts"], ["../../../../packages/language/src/reqlan-path-completion.ts"] | done | [reference_code_completion] must offer code completion for all valid reqlan references: - reqlan files ( `.rq` ) - ideas and ideasets in a reqlan file after a quoted path ( `["path".idea]` ) - ideasets and ideaset members ( `[ideaset.member]` ) - code files - folders, including folders that do not contain `.rq` files Import path completion stays limited to `.rq` files. Anonymous file-reference paths share ranking and alias logic with import paths, but they include every file and folder target. Scanning every workspace file on each keystroke is too expensive: [reference_code_completion_performance]. | 0.051 | |
| reference_code_completion_performance | ["../../../../packages/language/src/reqlan-path-completion.ts"], ["../../../../packages/language/src/reqlan-completion-provider.ts"], ["../../../../packages/language/src/reqlan-completion-context.ts"] | done | [reference_code_completion_objects] must stay interactive on large workspaces. Path completion must not re-walk the filesystem on every keystroke: cache directory listings and reuse them for import and anonymous file-reference completion. Ranking must precompute proximity keys rather than recomputing hop distance per comparator call. Idea-graph ranking must reuse per-document adjacency across completion requests while document versions are unchanged. Anonymous file-reference completion may omit distant candidates after proximity ranking so the list stays bounded. Implemented by ["../../../../packages/language/src/reqlan-path-completion.ts"] ( `clearPathCompletionCaches`, listing cache, `sortPathCompletionCandidates` ), ["../../../../packages/language/src/reqlan-completion-provider.ts"], and ["../../../../packages/language/src/reqlan-completion-context.ts"]. [reference_code_completion] [reference_code_completion_objects] | 0.046 | |
| reference_goto_definition_speed | ["../../../../crates/reqlan-lsp/src/session.rs"], ["../../../../crates/reqlan-lsp/src/analysis.rs"], ["../../../../crates/reqlan-lsp/src/server.rs"], ["../../../../packages/extension/src/extension/main.ts"], ["../../../../packages/extension/src/extension/register-folder-reference-handling.ts"], ["../../../../packages/extension/src/extension/register-wildcard-reference-handling.ts"], ["../../../../packages/language/src/reqlan-definition-provider.ts"], ["../../../../packages/language/src/reqlan-markdown-links.ts"] | done | Hover and go-to-definition are lookups on the open parse. The parse keeps its references sorted by start byte. A request finds the reference under the cursor by binary search. A request does not walk the syntax tree and does not convert each reference to a line and column. A request resolves each authored path once per parse. It does not `stat` that path again. A same-file idea uses that parse. An open neighbor uses that neighbor's buffer. A closed neighbor is parsed once. The server keeps its model, idea names, and name-token ranges. A later request does one `stat`. It reads and parses the file again only when the modified time or the size changed. A hover on a cross-file idea renders from that cached model. It does not read the file. The target is the name token of the idea, in the open editor when the target is open. An imported alias such as `[other]` reaches the imported idea. A folder reference has no definition. Its link is the folder-picker command. A hover renders idea content only when ["./features-syntax.rq".idea_content_tooltip] is on. A request does not wait behind the confirm pass of ["../support/open-file-sequencing.rq".lazy_features_after_outbound]. The editor calls this request on Ctrl + hover. The extension does not send the document text from that handler. The extension does not open a folder picker or a wildcard panel from that handler. A folder click and a wildcard click use the command document link. When the engine is node, the provider uses cached Langium ref objects for idea tokens. It does not scan the document text when the CST already covers the cursor. Related: [editor_reference_activation], ["../../../language/imports.rq".wildcard_references_webview]. | 0.179 | |
| reference_underline_syntax_align | ["../../../../packages/language/src/reqlan-utf8-lsp-offset.ts"], ["../../../../packages/language/src/reqlan-local-symbolic-links.ts"], ["../../../../packages/language/src/reqlan-outbound-presentation.ts"], ["../../../../crates/reqlan-index/src/types.rs"] | done | Idea document-link and error underlines must cover the same UTF-16 range as the syntax token ( Langium `$refNode` / semantic token ), including when non-ASCII text appears earlier in the file. Native extract spans are UTF-8 byte offsets ( ["../../../indexer/indexer.rq".local_symbolic_analysis] ); LSP `Position.character` is UTF-16. Convert before `positionAt` so the underline does not drift off the token. Related: [non_web_reference_navigation], [reference_document_links], [unresolved_reference_diagnostics], [aliased_from_import_ctrl_click]. | 0.125 | |
| same_line_named_block_highlighting | ["../../../../packages/language/scripts/patch-textmate.mjs"], ["../../../../packages/language/syntaxes/reqlan.tmLanguage.json"] | done | TextMate-only highlighting ( no semantic tokens ) must follow the canonical lexer for named `{` / `}`: a top-level `name {}` or `name {hello}` is a complete ["../../../language/syntax.rq".block_idea] on that line. The grammar must close on the same line. It must not leave a block open until a later own-line `}`. An open block swallows later one-liners such as a name-only idea. `name {` at end of line is a multiline block. Close it only on an own-line `}` so matching prose pairs at end of line ( `{{SITE_URL}}` ) stay in the body per ["../../../language/syntax-edge-cases.rq".nested_curly_braces]. `name text {braces}` is a ["../../../language/syntax.rq".simple_idea]. `{` after other body text must not start a block. TextMate idea-name scopes on a file must match the Langium parse of that file. | 0.052 | |
| traceable_inlay_hints | ["../../../../packages/language/src/reqlan-inbound-reference-inlay-label.ts"], ["../../../../packages/language/src/reqlan-inlay-hint-provider.ts"], ["../../../../packages/language/src/reqlan-inlay-hint-settings.ts"], ["../../../../packages/extension/src/extension/register-reference-inlay-hints.ts"], ["../../../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../../../packages/language/src/reqlan-path-resolve.ts"], ["../../../../crates/reqlan-lsp/src/analysis.rs"] | done | A click on one inbound referencer opens that idea via `reqlan.openInboundReferencer` → host openIndexFile ( same path as activity-bar / index opens ). The inlay label part must not use raw LSP Location for the click gesture — Cursor rejects detached file: / / opens that Location would trigger. A click on the remainder opens the inbound summary for that idea. The backlink tooltip uses the shared document-link file URI builder ( encoded path, `#L` fragment ). The Rust server emits the same markdown tooltip and open command ( ["../support/language-server-rust.rq".language_server_rust] ). A file path with a space opens that file from the inlay click and from the tooltip. A directory segment " reqlan rq " opens that file. Implemented by ["../../../../packages/language/src/reqlan-inbound-reference-inlay-label.ts"], ["../../../../packages/language/src/reqlan-inlay-hint-provider.ts"], ["../../../../packages/language/src/reqlan-inlay-hint-settings.ts"], ["../../../../packages/extension/src/extension/register-reference-inlay-hints.ts"], ["../../../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../../../packages/language/src/reqlan-path-resolve.ts"], and ["../../../../crates/reqlan-lsp/src/analysis.rs"]. | 0.052 | |
| unresolved_reference_diagnostics | ["../../../../packages/language/src/reqlan-local-symbolic-links.ts"], ["../../../../packages/language/src/reqlan-neighbor-parse.ts"], ["../../../../packages/language/src/reqlan-outbound-presentation.ts"], ["../../../../packages/language/src/reqlan-document-link-provider.ts"], ["../../../../crates/reqlan-lsp/src/analysis.rs"], ["../../../../packages/language/src/reqlan-validator.ts"] | in-progress | Unresolved idea references must report a linking error diagnostic. A same-file miss and an import-target miss have an error and no document link. A qualified reference may link to its file before the idea line is confirmed. After confirmation, a missing idea has an error and no document link ( ["../support/open-file-sequencing.rq".missing_reference_colour_sequence] ). A false idea link looked like a happy reference while Ctrl + click could not navigate. Missing file references stay on ["./features-syntax.rq".file_references] / ["../support/language-server-errors.rq".file_reference_errors] ( error, no document link ). Related: [reference_rendering], [non_web_reference_navigation]. | 0.117 | |
| view_references_as_inlay_hints | ["../../../../crates/reqlan-lsp/src/session.rs"], ["../../../../crates/reqlan-lsp/src/server.rs"], ["../../../../packages/extension/src/extension/idea-content-tooltip.ts"], ["../../../../packages/extension/src/extension/register-reference-inlay-hints.ts"] | done | References should be shown as inlay hints in the editor. This should be a toggleable setting, which should be available in the command palette. N-lines ( configurable setting ) of hints should be shown below the idea. Inbound lookup must stay interactive on large graphs via [inbound_inlay_index_performance]. The Rust server honours `reqlan.referencesInlayHints.enabled` and the host inbound snapshot ( `byIdeaName` + `fileReferencers` ). Implemented by ["../../../../packages/language/src/reqlan-inlay-hint-provider.ts"], ["../../../../packages/language/src/reqlan-inbound-reference-inlay-label.ts"], ["../../../../packages/language/src/reqlan-inlay-hint-settings.ts"], ["../../../../packages/extension/src/extension/register-reference-inlay-hints.ts"], and ["../../../../crates/reqlan-lsp/src/session.rs"]. | 0.093 | |
| wildcard_reference_highlighting | ["../../../../packages/language/scripts/patch-textmate.mjs"], ["../../../../packages/language/syntaxes/reqlan.tmLanguage.json"], ["../../../../packages/language/src/reqlan-semantic-token-provider.ts"] | done | Bracket and wikilink forms of ["../../../language/imports.rq".wildcard_references] ( `["path/**/*.rq".idea_*]`, `[["path/*.rq".*_pane|label]]` ) must TextMate-scope as `meta.link.reqlan` with the path as `string.other.link.reqlan` — never as `comment.block.reqlan`. The grey " comment " paint happened when `#bracket-references` only allowed ID suffixes, so `/*` inside an unmatched path opened a block comment. Fixes: TextMate `#bracket-references` / wiki path patterns accept `WILDCARD_NAME` suffixes; `#comments` block begin rejects empty slash-star-star-slash; body rules try references before comments. Semantic tokens paint `WildcardReference.pathPattern` as string and `ideaPattern` as variable ( ["./features-syntax.rq".syntax_highlighting] ). Related: ["../../../language/syntax.rq".comments], ["../../../language/imports.rq".wildcard_references_webview]. | 0.079 | |
| code_completion | ["../../../../packages/language/src/reqlan-completion-provider.ts"], ["../../../../packages/language/src/reqlan-path-completion.ts"] | The extension should complete ideas, imports, and paths from the current file path and resolved import config. - support for references - support for imports, including import-root alias paths such as `@/` from ["../../../language/imports.rq".configuration_import_root_alias] and ["../../host/configuration.rq".configuration_import_roots] - support for semantic search - support for graph-proximity based ranking String and namespace completion should follow the current file path and import roots. | 0.150 | ||
| comment_support | ["../../../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../../../packages/extension/src/extension/comment-reference-path-context.ts"], ["../../../../packages/language/src/reqlan-comment-diagnostics.ts"], ["../../../../packages/language/src/reqlan-path-resolve.ts"] | The extension should recognise reqlan references embedded in comments of arbitrary source files. Comment reference syntax should follow the form rq, then a quoted path, then a dotted idea name in line comments. Qualified comment paths must resolve import-root aliases such as `@/` the same way imports do — ["../../../language/imports.rq".configuration_import_root_alias], ["../comment-references/functional-code-comment-references.rq".comment_reference_import_root_alias]. Comment references in non-. rq files should support syntax highlighting ( resting underline: ["../comment-references/functional-code-comment-references.rq".comment_reference_resting_underline] ), hover, and go-to-definition. Arbitrary file references should be supported from both. rq files and comment references. | 0.059 | ||
| idea_content_tooltip | ["../../../../crates/reqlan-lsp/src/hover_content.rs"], ["../../../../crates/reqlan-lsp/src/analysis.rs"], ["../../../../crates/reqlan-lsp/src/session.rs"], ["../../../../crates/reqlan-lsp/src/server.rs"], ["../../../../packages/extension/src/extension/idea-content-tooltip.ts"], ["../../../../packages/extension/src/extension/main.ts"], ["../../../../packages/extension/package.json"] | done | A hover on an idea name or on a reference shows that idea's content. The tooltip is markdown. It uses a heading, body lines, attributes, lists, and code fences. A reference in another file shows that file's idea content. The setting `reqlan.ideaContentTooltip.enabled` controls this hover. The default is on. When the setting is off, the hover shows the idea name and the one-line summary. Related: [syntax_hovering] ["../support/language-server-rust.rq".language_server_rust] | 0.149 | |
| syntax_highlighting | ["../../../../packages/language/scripts/patch-textmate.mjs"], ["../../../../packages/language/syntaxes/reqlan.tmLanguage.json"], ["../../../../packages/language/src/reqlan-semantic-token-provider.ts"] | done | . rq files should receive full syntax highlighting coverage for all reqlan constructs. Semantic token highlighting should distinguish ideas, attributes, references, imports, and keywords. Path + wildcard idea refs ( `["…/*.rq".idea_*]` ) must highlight as links / strings — not comment-grey — see ["./features-syntax-highlighting.rq".wildcard_reference_highlighting]. Import lines must colour path and keywords after `import` / `from` — see ["./features-syntax-highlighting.rq".import_statement_highlighting]. Same-line named braces ( `name {}`, `name {hello}` ) must close in TextMate so later one-liners stay visible — see ["./features-syntax-highlighting.rq".same_line_named_block_highlighting]. | 0.093 | |
| code_actions | ["../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../crates/reqlan-lsp/src/server.rs"], ["../../../crates/reqlan-lsp/src/session.rs"], ["../../../packages/language/src/reqlan-document-builder.ts"], ["../../../packages/extension/src/extension/register-import-error-commands.ts"], ["../../../packages/extension/src/extension/main.ts"], ["../../../packages/extension/src/language/main.ts"], ["../../../packages/extension/src/mutation_module/refactor/register-idea-refactor-commands.ts"], ["../../../packages/extension/src/mutation_module/refactor/register-barrel-page-command.ts"], ["../../../packages/extension/src/extension/register-ignore-error-code-actions.ts"], ["../../../packages/language/src/reqlan-ignore-error-action.ts"], ["../../../packages/language/src/reqlan-create-idea-below.ts"] | done | Language-server code actions for `.rq` files, plus comment-file Quick Fixes for ignore-error: - Quick fixes for unresolved references ( add import, rewrite qualified ref, search, create file ) — ["./support/features-imports.rq".import_error] - Refactor: search / replace or wrap as idea reference — ["../host/features-commands.rq".search_code_actions] - Refactor: move or delete an idea declaration — ["../mutation/refactor_support.rq".refactor_symbol_move] ["../mutation/refactor_support.rq".refactor_symbol_delete] - File-level source action: barrel page — ["../host/features-commands.rq".barrel_page] - Quick Fix: insert `//rq-ignore-error` before a line with diagnostics — ["../host/features-commands.rq".code_actions_ignore_error] - Quick Fix: create a missing local idea below the idea that contains the unresolved reference — ["../host/features-commands.rq".create_idea_below_idea_containing_unresolved_reference_under_cursor] The Rust server returns the same set ( ["./support/language-server-rust.rq".language_server_rust] ). Command-backed search / replace and barrel actions omit LSP command arguments so VS Code does not cache disposable delegating ids; the extension resolves the active editor ( or document ) when the command runs. The same Quick Fix appears once in one request. Langium appends validation diagnostics when a document already has diagnostics. The diagnostic list stays when the document state is below Validated. The document builder removes previous built-in diagnostics before that append. One linking error gives one Quick Fix after repeated builds. | 0.169 | |
| search_add_to_chat | ["../../../../packages/extension/webviews/activity-bar/components/AddToChatButton.svelte"], ["../../../../packages/extension/webviews/activity-bar/components/SearchPane.svelte"], ["../../../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../../../packages/extension/src/activity_bar_module/activity-bar-messages.ts"], ["../../../../packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts"], ["../../../../packages/extension/src/agent_module/ai_commands/open-chat.ts"] | done | From each [search_pane] hit, a split **Add to chat** control: - Primary button: place compact `#requirement` context into the **current** chat input without submitting. - ▾ menu ( visible secondary affordance ): **Add to current chat** or **Add to new chat** ( new session, then seed the same payload ). Tooltips name both behaviours; secondary is not right-click-only. Same payload shape as ["../../agent/features-ai.rq".add_to_chat] ( idea name, path: line, summary ) via [open_chat]. Host: [open_chat] with `{ query, isPartialQuery: true, target: 'current' | 'new' }`. Cursor note: do not use `workbench.action.chat.open` for **current** ( it always opens a new tab ); see ["../../agent/features-ai.rq".add_to_chat] / [open_chat]. Clipboard fallback when no chat command is available ( same spirit as ["../../agent/features-ai.rq".add_to_chat] ). Wire: [AddToChatButton] / [SearchPane] → [app_state] `addToChat(hit, target)` → [activity_bar_messages] → [activity_bar_webview] → [open_chat]. | 0.071 | |
| search_pane_file_hits | ["../../../../packages/extension/webviews/activity-bar/components/SearchPane.svelte"], ["../../../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../../../packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts"], ["../../../../crates/reqlan-search/src/fuzzy.rs"], [native_workspace_index] | done | [search_pane] mixes [core_search.file_search] hits ( kind `file` ) into the ranked list with ideas. Click opens the file at line 0. File hits do not offer Insert ref or Pin ( those are idea actions ). Empty-state and placeholder copy mention files. | 0.115 | |
| search_pane_load_more | ["../../../../packages/extension/webviews/activity-bar/components/SearchPane.svelte"], ["../../../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../../../packages/extension/src/activity_bar_module/activity-bar-webview-provider.ts"], ["../../../../packages/extension/src/activity_bar_module/activity-bar-messages.ts"], ["../../../../packages/extension/src/activity_bar_module/search-results-meta.ts"], ["../../../../crates/reqlan-search/src/fuzzy.rs"] | done | When ranked hits exceed the visible page, [search_pane] shows an exceeded-count label ( `40+ matches`, or `{n}+ matches` after further pages ) instead of a full total, and a **Show more** control at the bottom of the list that fetches the next page and appends. A new query resets to the first page. Uses [core_search.fuzzy_search_pages] ( `offset` + `truncated` ). | 0.095 | |
| search_pane_match_highlighting | ["../../../../packages/extension/src/shared/fuzzy-search.ts"], ["../../../../packages/extension/webviews/activity-bar/components/SearchHighlight.svelte"], ["../../../../packages/extension/webviews/activity-bar/components/SearchPane.svelte"], ["../../../../packages/extension/webviews/activity-bar/state/app.svelte.ts"] | done | The [search_pane_results] list highlights the parts of name, path, and summary that matched the query via [SearchHighlight]. Resilient to [core_search.fuzzy_search] / [core_search.fuzzy_search_whitespace]: contiguous and separator-insensitive spans, token prefixes / part matches, reordered words, and character-subsequence ( fuzzy / acronym ) marks on short fields such as the idea name — not scattered letters in long summaries. | 0.063 | |
| search_pane_open_live_file | ["../../../../packages/extension/src/analytical_submodule/index-store/open-index-file.ts"], ["../../../../packages/extension/src/analytical_submodule/index-store/open-index-file-pick.ts"] | done | A click on a [search_pane] hit must show the live workspace file at that path. If that file is already open in a workspace tab, focus that tab and move the caret. Do not open a second read-only tab with stale content ( a detached `file://` copy that Cursor does not sync ). Keep the click path cheap: no extra index read, no base discovery. | 0.074 | |
| error_status_bar | ["../../../packages/extension/webviews/activity-bar/components/HeaderBar.svelte"], ["../../../packages/extension/webviews/activity-bar/components/BootstrapStatus.svelte"], ["../../../packages/extension/webviews/activity-bar/styles/global.css"], ["../../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../../packages/extension/webviews/ideas-summary/components/StatusBar.svelte"], ["../../../packages/extension/webviews/ideas-summary/styles/global.css"], ["../../../packages/extension/webviews/ideas-summary/lib/index-status-text.ts"] | done | When the activity bar status line ( ["../../../packages/extension/webviews/activity-bar/components/HeaderBar.svelte"] ) or Ideas Summary status chrome ( ["../../../packages/extension/webviews/ideas-summary/components/StatusBar.svelte"] ) is in an error state ( `statusError` ), surface the error **prominently** — do not mute it or bury it behind healthy index counts. - Lead the status text with the error summary or issue count; healthy idea / reference counts may follow as secondary context. - Use error foreground, error validation background, a distinct error label, and `role="alert"` so the message is visually and accessibly distinct from idle status. - Bootstrap error banner ( ["../../../packages/extension/webviews/activity-bar/components/BootstrapStatus.svelte"] in [loading_state] ) must not apply muted styling to the error detail. Soft-waits for an unready index stay non-error per [loading_state] / [workspace_panel.workspace_loading]; this idea covers true error states only. Shared copy helper: ["../../../packages/extension/webviews/ideas-summary/lib/index-status-text.ts"]. | 0.075 | |
| comment_reference_refactor_support | ["../../../packages/language/src/reqlan-path-references.ts"], ["../../../packages/language/src/file-path-rewrite.ts"], ["../../../packages/language/src/reqlan-idea-refactor.ts"], ["../../../packages/language/src/reqlan-comment-rename.ts"], ["../../../packages/extension/src/mutation_module/file-move-plan.ts"], ["../../../packages/extension/src/mutation_module/expand-renamed-paths.ts"], ["../../../packages/extension/src/mutation_module/collect-inbound-referencers.ts"], ["../../../packages/extension/src/mutation_module/collect-inbound-referencers-core.ts"], ["../../../packages/extension/src/mutation_module/refactor/register-idea-refactor-commands.ts"] | done | File and symbol refactors must update [comment_reference] tokens in code files and in `.rq` comments. When a file or folder moves or is renamed, rewrite `rq:["path".idea]` paths relative to the referencing file: outbound paths inside the moved file, and inbound paths in other files that pointed at it. Aliased paths such as `rq:["@/old/file.rq".idea]` keep the alias and update the remainder. When an idea is renamed, update matching comment idea tokens. When an idea moves to another `.rq` file, rewrite qualified comment paths that targeted the old file for that idea. Pathless `rq:[idea]` tokens stay as name-only links. When an idea is deleted, remove comment references that targeted it. Relates to [refactor_file_moves], [refactor_symbol_rename], [refactor_symbol_move], [refactor_symbol_delete], [refactor_changes], ["./mutation-hooks.rq".move_file], ["./mutation-hooks.rq".rename_file], ["../language/comment-references/functional-code-comment-references.rq".references_in_functional_code_comments]. | 0.215 | |
| refactor_symbol_move | ["../../../packages/language/src/reqlan-idea-refactor.ts"], ["../../../packages/language/src/reqlan-idea-move-imports.ts"], ["../../../packages/language/src/reqlan-code-action-provider.ts"], ["../../../crates/reqlan-lsp/src/code_actions.rs"], ["../../../packages/extension/src/mutation_module/refactor/idea-extract-flow.ts"], ["../../../packages/extension/src/mutation_module/refactor/register-idea-refactor-commands.ts"] | done | An idea can move to another existing `.rq` file from a code action or the [command_palette]. Palette commands use the idea under the cursor, or a pick list when the cursor is not on an idea. 1. Move idea ( `reqlan.refactor.moveIdea` ) - Cut the declaration from the source file. - Insert it into the destination file. - Remove source imports that the move makes unused. - Add the imports that the moved idea needs to the destination. - If the source file still refers to the idea, import it from the destination. - Rewrite comment references per [comment_reference_refactor_support]. - Reindex without duplicate idea rows for the old hosting file. 2. Move idea content ( `reqlan.refactor.moveIdeaContent` ) - Do the same as ( 1 ). - Always import the destination file in the source. - Leave a one-liner stub in the source: `idea_name [alias.idea_name]`. Do not overlap [decompose]: decompose writes a new file. Move and decompose share the resolve-plan-apply sequence in ["../../../packages/extension/src/mutation_module/refactor/idea-extract-flow.ts"]. [refactor_support] [refactor_changes] | 0.106 | |
| refactor_symbol_rename | ["../../../crates/reqlan-lsp/src/session.rs"], ["../../../crates/reqlan-lsp/src/analysis.rs"] | done | Syntactic symbols ( ideas, ideasets, import aliases, and import paths ) should be renamable via the editor rename action ( F2 / LSP rename ). Rename should update AST references across. rq files and matching `rq:["path".idea]` comment idea tokens in source files ( [comment_reference_refactor_support] ). The Rust server renames open buffers, open comment buffers, and closed files reached via the ideas index. Non- `.rq` comment rename stays on the host provider until Rust owns those buffers. [refactor_support] Implemented by ["../../../crates/reqlan-lsp/src/session.rs"], ["../../../packages/language/src/reqlan-rename-provider.ts"], ["../../../packages/language/src/reqlan-comment-rename.ts"], ["../../../packages/language/src/reqlan-name-provider.ts"], and ["../../../packages/extension/src/mutation_module/refactor/register-comment-rename-provider.ts"]. | 0.084 | |
| graph_label_auto | ["../../../packages/extension/webviews/shared/graph/graph-cy-controller.ts"], ["../../../packages/extension/webviews/shared/graph/graph-cytoscape.ts"], ["../../../crates/reqlan-export/assets/app.js"] | done | In Labels auto mode, visibility follows viewport zoom continuously rather than a hard cut. ( fade ) Below a low zoom threshold labels are fully hidden; above a slightly higher threshold they are fully opaque; between those thresholds opacity ramps briefly through a muted / semi-transparent phase ( GRAPH_LABEL_FADE_START → GRAPH_LABEL_FADE_END ). Labels start fully invisible during graph initialisation and layout settling so text paint does not lag those phases; zoom fade only applies once settle / reframe has finished. Hovered or dragged nodes remain fully opaque even when ambient auto opacity is low or zero. Zoom and Fit from [view_controls] / [reframe_view] must update this opacity on each paint or zoom event. Applies to Ideas Summary GraphCyController and HTML export canvas graph alike. | 0.184 | |
| graph_label_modes | ["../../../packages/extension/webviews/shared/graph/graph-cy-controller.ts"], ["../../../packages/extension/webviews/ideas-summary/components/GraphControls.svelte"], ["../../../packages/extension/src/ideas_summary_module/shared/graph-ui-state.ts"], ["../../../crates/reqlan-export/assets/app.js"], ["../../../crates/reqlan-export/src/html_template/mod.rs"] | done | Every interactive graph should provide a Labels control that cycles auto ( default ), on, and off without changing graph membership. On forces full opacity; off hides all labels; auto follows [graph_label_auto]. Reset / default restore auto. Ideas Summary: control in ["../../../packages/extension/webviews/ideas-summary/components/GraphControls.svelte"], mode persisted via ["../workspace-summary/ideas_summary/graphical_graph.rq".graph_ui_persistence]. HTML export: control in ["../../../crates/reqlan-export/src/html_template/mod.rs"] / ["../../../crates/reqlan-export/assets/app.js"]. Driven by the same viewport zoom as [view_controls]. | 0.148 | |
| graph_status_tag_filters | ["../../../packages/analytical/src/core/filter-specials.ts"], ["../../../crates/reqlan-export/src/snapshot.rs"], ["../../../crates/reqlan-export/src/html_template/mod.rs"], ["../../../crates/reqlan-export/assets/app.js"], ["../../../crates/reqlan-export/src/html_utils.rs"], ["../../../packages/analytical/src/index-store/webview-graph-queries.ts"], ["../../../packages/analytical/src/index-store/sqlite-store.ts"], ["../../../packages/extension/webviews/ideas-summary/components/SearchableCheckboxDropdown.svelte"], ["../../../packages/extension/webviews/ideas-summary/components/GraphControls.svelte"], ["../../../packages/extension/webviews/ideas-summary/components/GraphView.svelte"], ["../../../packages/extension/src/ideas_summary_module/shared/messages.ts"] | done | Status and tag graph filters are searchable checkbox dropdowns ( still a dropdown trigger; multi-select via checkboxes; OR within each field ). They must distinguish attribute absence from an empty declaration and from a literal unspecified value: - Not present — attribute key absent ( no `@status` / no `@tags` ) - Empty — attribute declared with no value ( `@status`, `@tags`, `@status ""`, bare flag ) - unspecified — literal authored value " unspecified " Do not invent unspecified for missing attributes in rollups, clusters, or filter options. Special options render differently from concrete values ( italic muted Not present; info-tint Empty; warning-tint unspecified ). Shared helpers live in ["../../../packages/analytical/src/core/filter-specials.ts"]. Surfaces: Ideas Summary SearchableCheckboxDropdown; HTML export SCD in ["../../../crates/reqlan-export/assets/app.js"]. | 0.134 | |
| ideas_summary_base_scope | [ideas_summary_panel] | done | bases, ideas-summary, multi-base | Ideas Summary is scoped to one [bases.base] at a time. - Active base defaults to the longest-matching base root for the focused editor ( [bases.implied_context] ). - Chrome includes an explicit base switcher; Overview, Bases, Ideas, Ideasets, Attributes, References, Graph, Timeline, and Index tabs bind to the selected base's index only ( Bases lists all discovered bases; Index is last ). - Switching base is a pointer swap ( [bases.active_base_switch] ): pin via `setActiveBaseId`, rebind status / tables / graph UI immediately — do not await sync on the switch call; not-ready bases get fire-and-forget open + soft-sync catch-up. - Graph UI persistence is per-base: workspaceState key `reqlan.ideasSummary.graphUi.<baseId>` via [graph_ui_state]. - Activity bar " Open in Ideas Summary " passes the current active base id into [ideas_summary_panel]. - No merged cross-base tables or graphs in this pass ( [bases.multi_base_environment] ). | 0.081 |
| file_treatment_toggle | ["../../../../packages/extension/webviews/shared/graph/file-treatment.ts"], ["../../../../packages/extension/webviews/shared/graph/graph-cytoscape.ts"], ["../../../../packages/extension/webviews/shared/graph/graph-cy-controller.ts"], ["../../../../packages/extension/webviews/shared/graph/graph-cy-interactions.ts"], ["../../../../packages/extension/webviews/shared/graph/graph-cy-highlight.ts"], ["../../../../packages/extension/webviews/ideas-summary/components/FileTreatmentSelect.svelte"], ["../../../../packages/extension/webviews/ideas-summary/components/GraphControls.svelte"], ["../../../../packages/extension/webviews/ideas-summary/components/GraphView.svelte"], ["../../../../packages/extension/src/ideas_summary_module/shared/graph-ui-state.ts"], ["../../../../crates/reqlan-export/src/html_template/mod.rs"], ["../../../../crates/reqlan-export/assets/app.js"] | done | Toolbar dropdown selects how hosting `.rq` files ( implicit ideasets ) appear in the graph — distinct from explicit AST `ideaset` declarations and from external `file:` reference nodes. Options ( with info tooltips / help text ): - invisible / Hidden — no file containers or file leaf nodes; ideas float free - compound — one compound parent per hosting file ( basename label ); nests under folder / tag compounds when Controls → Compound is also on. Containers are draggable ( members move with the box; live physics pins descendants while dragging ). Clicking the title opens the file; double-click also opens. - linked / Linked nodes ( default ) — synthetic ideaset-styled leaf per hosting file ( `rq-file:…` ) with `ideaset_member` edges to ideas in that file; click / dbl-click opens the hosting file like other nodes. Client reshape via `applyFileTreatment` in ["../../../../packages/extension/webviews/shared/graph/file-treatment.ts"]; no re-query on mode flip. Ideas Summary: `FileTreatmentSelect` on GraphControls; persisted as `fileTreatment` in [graph_ui_persistence]. HTML export: same three options via a select; compound boxes are hittable / draggable with clickable titles; linked nodes carry `pageUrl` / `hostFilePageUrl` for navigation. Related: [graphical_graph], [ui_controls], [webview_export_graph_parity], ["../../../ontology.rq".file], ["../../../ontology.rq".ideaset], [html_export_graph_page]. | 0.170 | |
| webview_export_graph_parity | ["../../../../packages/extension/webviews/ideas-summary/components/GraphControls.svelte"], ["../../../../packages/extension/webviews/ideas-summary/components/FileTreatmentSelect.svelte"], ["../../../../crates/reqlan-export/src/html_template/mod.rs"], ["../../../../crates/reqlan-export/assets/app.js"] | done | Interactive graph behaviour that authors rely on in Ideas Summary must have a matching affordance on the HTML export workspace graph ( [html_export_graph_page] ) unless a requirement explicitly scopes it to one host. Shared today: Labels auto / on / off, live physics, Fit, status / tag filters, path / search filters, hide external files, hide ideasets ( explicit AST ), [file_treatment_toggle] ( dropdown with the same three modes, compound drag / title-open, linked-node open ), and [wildcard_refs_toggle] ( default on; dotted wildcard edges ). Ideas Summary may still differ where the host model differs: Indirect refs rebuilds hop depth via `buildGraphViewSlice` ( export freezes neighbourhood at snapshot time — no Indirect chip ); Key / Controls panels and node-budget controls are webview-only; export uses client-side filters on the embedded graph JSON rather than re-querying the index; Ideas Summary uses cytoscape compound parents while export draws AABB compound boxes on canvas. When adding a new Ideas Summary graph chip or edge style, update [html_export_graph_page] ( or document an intentional exception here ) and keep labels / defaults aligned across surfaces. Related: [graphical_graph], [wildcard_refs_toggle], [file_treatment_toggle], [ui_controls], [graph_labels], [graph_label_modes], [graph_status_tag_filters]. | 0.165 | |
| wildcard_refs_toggle | ["../../../../packages/extension/webviews/ideas-summary/components/GraphControls.svelte"], ["../../../../packages/extension/webviews/ideas-summary/components/GraphView.svelte"], ["../../../../packages/extension/src/ideas_summary_module/shared/messages.ts"], ["../../../../packages/extension/src/ideas_summary_module/ideas-summary-panel.ts"], ["../../../../packages/extension/webviews/ideas-summary/lib/default-queries.ts"], ["../../../../packages/analytical/src/index-store/webview-graph-queries.ts"], ["../../../../crates/reqlan-index/src/extract.rs"], ["../../../../crates/reqlan-index/src/extract.rs"], ["../../../../packages/extension/webviews/shared/graph/graph-cytoscape.ts"], ["../../../../packages/extension/webviews/shared/graph/graph-theme.ts"], ["../../../../packages/extension/webviews/ideas-summary/styles/global.css"], ["../../../../crates/reqlan-export/src/html_template/mod.rs"], ["../../../../crates/reqlan-export/assets/app.js"] | done | Toolbar chip " Wildcard refs " ( next to Indirect refs ) on GraphControls toggles `GraphViewQuery.includeWildcardRefs`. Default true — edges of kind `wildcard_reference` from the indexer fan-out stay visible ( ["../../../indexer/indexer.rq".wildcard_reference_edges] ). When false, `buildGraphViewSlice` omits those edges and does not expand neighbourhood through them ( `includeWildcardRefs!== false` normalisation in Ideas Summary host + analytical query ). Distinct from plain `references` and from the Indirect refs depth toggle; Key legend shows a dotted " Wildcard reference " row; cytoscape marks `edge[?isWildcard]` with `line-style: dotted`. Query field flows Ideas Summary loadGraph → `buildGraphViewSlice` in ["../../../../packages/analytical/src/index-store/webview-graph-queries.ts"]. HTML export workspace graph has the same chip ( client filter on embedded edges; dotted stroke ) per [webview_export_graph_parity] and [html_export_graph_page]. Related: ["../../../language/imports.rq".wildcard_references], ["../../../indexer/indexer.rq".wildcard_reference_edges], ["../../../indexer/indexer.rq".index], [graphical_graph], [ui_controls], [webview_export_graph_parity]. | 0.308 | |
| attributes_tab | [AttributesTable], [webview_table_queries], [ideas_summary_panel] | Attributes index for the active base, aligned with [html_export.html_export_attributes_index]: attribute key, idea count, distinct value count, sample values. Searchable and filterable; clicking a key opens Ideas with that attribute column enabled. Aggregated in [webview_table_queries] / sqlite store. | 0.045 | ||
| bases_tab | [BasesTable], ["../../../../packages/extension/webviews/ideas-summary/lib/bases-filter.ts"] | done | Table of discovered [ontology.base] entries in the workspace ( label, path, ready, idea / edge / issue counts, state ). Selecting a row pins that base ( pointer swap ) per [ideas_summary_base.ideas_summary_base_scope]. Filterable / sortable / column options like other tables; data comes from index status, not a merged cross-base SQLite dump. Client-side search and column filters via [BasesTable] / bases-filter matcher. | 0.045 | |
| group_by_type | [IdeasTable], [ReferencesTable], [webview_table_queries] | Ideas table can group by idea kind ( block / oneliner ). References table can group by reference type ( file / comment / sub-idea ). Grouping is a toolbar toggle; rows are ordered by group then the active sort; UI shows collapsible group headers. | 0.061 | ||
| ideas_list | [IdeasTable], [webview_table_queries], ["../../../../packages/analytical/src/index-store/sqlite-store.ts"], ["../../../../crates/reqlan-index/src/git_dates.rs"] | done | ideas, git, table | - [IdeasTable] - filterable and sortable via [TableToolbar], [ColumnFilterRow], and [SortableTh] - column show / hide via [TableOptionsMenu] / [table_column_options] - wide tables scroll horizontally in a `.table-scroll` viewport ( columns keep min widths; no crush-to-fit ) - groupable by idea kind ( block / oneliner ) per [group_by_type] - other attributes shown as expandable chips per [ChipList] - clicking an attribute chip adds a column, filters to ideas with a non-null value for that attribute, and sorts by it ( combinable with other filters ) - references split into outbound and inbound chip columns with counts - clicking a reference chip filters ideas that share that edge ( combinable with other filters ) - block idea bodies shown in a scrollable cell per [IdeaBodyCell] - columns for [git_idea_timeline_analysis]: first committed, last modified, and change count - read from indexed `git_created_at` / `git_modified_at` / `git_change_count` only - empty cells until ["../../index-host/git-codelens.rq".git_dates_background_indexing] fills them; main table load never runs git [ideas_list_git_columns_performance] [ideas_list_git_date_format] | 0.079 |
| ontology_aligned_tabs | ["../../../../packages/extension/webviews/ideas-summary/lib/tabs.ts"], ["../../../../packages/extension/webviews/ideas-summary/components/TabPanels.svelte"] | Tab order: Overview, Bases, Ideas, Ideasets, Attributes, References, Graph, Timeline, Index. Index is last — workspace index health and maintenance, not the primary browsing surface. Covers [ontology.base], [ontology.idea], [ontology.ideaset], [ontology.attribute], [ontology.reference], the graph cartography tab, and [timeline_page]; Overview mirrors HTML export home metrics lightly. Files / clusters / print families stay export-only for now. | 0.086 | ||
| overview_coverage_scores | [OverviewPanel], [ideas_summary_panel], ["../../../../crates/reqlan-index/src/overview.rs"] | done | overview, coverage, metrics | Collapsible " Coverage " section on [overview_page] / [OverviewPanel]. Product-facing metrics for how thoroughly ideas map into the active base's project files ( respecting ["../../host/configuration.rq".configuration_rqignore] ): - Linked files: percent of project files ( non-requirement, non-ignored ) that ideas reference — exact path match after resolve, or under a referenced folder. Show " N of M project files ". - Requirement density: ideas per thousand lines of eligible project code; also show idea count and line count. - Linked paths: distinct files or folders referenced from ideas. - Requirement files: count of requirement documents in the base. Collapsed by default. Calculate only when the user expands the section ( not on Overview open / tab switch ). Non-blocking: host work must not stall Overview chrome or other tabs; show a loading state until the result arrives. When the index is not ready or calculation fails, show a clear message — never fake zero scores. Recalculate on expand when the active base changes or when the user refreshes; otherwise reuse the last result for the session. | 0.047 |
| overview_page | [OverviewPanel], [ideas_summary_panel] | First tab: a workspace overview for the active base — product-facing copy ( not index / debug jargon ). - At a glance: idea count, reference count, issues, bases, and a friendly readiness status. - Coverage: collapsible [overview_coverage_scores] ( lazy, non-blocking ). - Search: live cross-surface search over ideas, ideasets, attributes, and references for the active base; results group by surface with sample hits and actions to open the matching tab with the query applied ( [overview_search] ). - Export: buttons that open [features_export.export_webview] with HTML, Markdown, JSON, CSV, or PDF pre-selected ( or the form without a format override ). - Links: project site, support / email, GitHub. - Recent index / analyse activity preview ( idea names when available ) with a link to [timeline_page] for idea git history — this preview is not a git surface. | 0.057 | ||
| overview_search | [OverviewPanel], [ideas_summary_panel], [webview_table_queries] | Overview search fans out across Ideas, Ideasets, Attributes, and References using the same ui-sql filters as those tabs. Debounced; returns counts plus a short sample of hits per surface; clicking a hit opens the idea ( or the attribute → Ideas handoff ); " Open in … " applies the search string on that tab. | 0.047 | ||
| table_column_filters | [ColumnFilterRow], [TableToolbar], [webview_table_queries], [IdeasTable], [IdeasetsTable], [ReferencesTable], [AttributesTable], [BasesTable], [ideas_summary_panel], ["../../../../packages/extension/src/ideas_summary_module/shared/table-query-normalize.ts"] | done | Every data table supports a global search and a per-column filter row ( [ColumnFilterRow] ), matching the usability of [html_export.html_export_list_views]. Text / path / body columns use searchable inputs; closed sets ( idea kind, reference type, ideaset kind, base ready ) use select / multi-select from a fixed option list. Typed filter / search text must keep spaces through the host round-trip ( do not trim the echoed query — SQL matchers may trim only when building LIKE patterns ). Select filters must support deselect / clear back to " All " ( controlled select value + clear control for multi-select ). Column filters are applied in the ui-sql layer ( [webview_table_queries] ) together with existing chip filters. Table panels must bind AppState query / rows via Svelte 5 `$derived` ( not legacy `$:` ) so filtered results from the extension message listener re-render — same pattern as [graphical_graph_doc.graphical_graph] / GraphView. Bases table filters client-side in the webview; other tables round-trip search through [ideas_summary_panel]. | 0.072 | |
| table_column_options | [TableOptionsMenu], [table_ui_state], [ideas_summary_panel] | Each table has an Options control ( [TableOptionsMenu] ) to show or hide columns. Visibility persists per tab in workspaceState via [table_ui_state]. | 0.073 | ||
| timeline_page | [TimelinePanel], [ideas_summary_panel], ["../../../../packages/analytical/src/index-store/sqlite-store.ts"], ["../../../../crates/reqlan-index/src/git_dates.rs"], ["../../../../packages/extension/src/index_host_module/register-git-dates-background.ts"], ["../../../../packages/extension/src/index_host_module/git-dates-background.ts"] | done | timeline, ideas, git | Timeline tab shows the evolution of ideas for the active base — not raw file-index noise. Sources: - Git idea lifecycle from indexed `git_created_at` / `git_modified_at` ( created + last edited as separate events when they differ ) - Session idea reindex activity ( one event per idea persisted, with name / status / summary when available ) Missing git dates are filled by the silent background indexer ( ["../../../indexer/indexer.rq".git_dates] / ["../../index-host/git-codelens.rq".git_dates_background_indexing] ) — opening Timeline must not run git log on the UI path. Reindex must preserve existing git dates across upsert. Entries are reverse-chronological, filterable by source ( git / reindexed ), and clickable to open the idea. Each event surfaces idea-centric info: name, short summary, status, kind / tags, and path. Full live multi-commit git log browsing remains out of scope; this surfaces indexed idea history first. | 0.085 |
| inbound_snapshot_events | ["../../packages/extension/src/extension/inbound-snapshot-schedule.ts"], ["../../packages/extension/src/extension/inbound-snapshot-push.ts"], ["../../packages/extension/src/extension/register-inbound-sqlite-sync.ts"], ["../../packages/analytical/src/index-store/workspace-index.ts"], ["../../packages/language/src/reqlan-inbound-snapshot.ts"] | done | Host → LSP inbound snapshots are event-driven and incremental. Push only when the ideas index is ready ( catalog update, ready-edge, visible-editor change, or window focus ). While Syncing or not ready, do not push an empty batch that clears the language-server last-good map; set a deferred flag and flush on the next ready event. The language client often starts before the index — registration must ensure-open / defer, not skip forever. Each notification is a per-document merge for visible editors; URIs not in the batch stay as last-good until replaced or the document closes. After a single-file enqueue reaches ready, notify catalog so consumers get a ready-state event ( mid-sync catalog notifies alone are not enough ). Coalesce concurrent push work so catalog spam drains to one ready pass. Related: [unify_inbound_indexes], ["../extension/language/support/open-file-sequencing.rq".lazy_features_after_outbound], ["../extension/language/syntax/features-syntax-highlighting.rq".inbound_inlay_index_performance]. | 0.133 | |
| path_completion_listing_cache | [path_completion] | draft | Import and anonymous file-path completion ( [import_code_completion_ranking], [anonymous_reference_code_completion], [reference_code_completion_objects] ) walk directories via [path_completion]. Reuse directory listings across keystrokes ( TTL cache ) so each keystroke does not re-walk the filesystem; clear the cache in tests and on demand. [index_cache_reuse] | 0.040 | |
| single_sync_walk | ["../../crates/reqlan-index/src/scan.rs"], ["../../packages/analytical/src/native/scan-workspace.ts"], ["../../packages/extension/src/analytical_submodule/index-store/index-service.ts"], ["../../packages/analytical/src/index-store/workspace-index.ts"], ["../../crates/reqlan-lsp/src/session.rs"] | done | One native directory walk records base roots, `.rq` paths, and allowlisted code paths. The walk does not read file bodies. Startup, Refresh, and create-base each run that walk once. They do not call `findFiles` and they do not run a second native `syncWorkspace` walk. Soft sync indexes the path list and skips unchanged mtimes. Idle stale check stats paths already stored in SQLite. New files arrive from the file watcher. The language server does not walk. The extension sends the base roots after the scan. Overlapping callers share one in-flight scan. CLI and MCP `sync_workspace` uses the same walk ( one pass, stop at nested bases ). [index_cache_reuse] [sequencing.soft_sync] [sequencing.scan_limits] | 0.080 | |
| unify_inbound_indexes | ["../../packages/analytical/src/index-store/sqlite-store.ts"], ["../../packages/analytical/src/core/inbound-file-referencers.ts"], ["../../packages/language/src/reqlan-inlay-hint-provider.ts"], ["../../packages/language/src/reqlan-inbound-reference-inlay-label.ts"], ["../../packages/language/src/reqlan-inbound-snapshot.ts"], ["../../packages/language/src/reqlan-reference-code-lens.ts"], ["../../packages/language/src/reqlan-file-inbound-code-lens.ts"], ["../../packages/extension/src/extension/register-inbound-sqlite-sync.ts"], ["../../packages/extension/src/extension/inbound-snapshot-push.ts"], ["../../crates/reqlan-index/src/queries.rs"] | done | Inlay hints and code lens must read inbound edges from [ideas_schema.edges_table], not Langium IndexManager. Query: edges whose `target_id` is an idea in the open file, plus `comment_link` / `file_reference` rows whose `target_file` matches that file. File-top CodeLens uses the `file_reference` subset ( ["../extension/language/syntax/features-syntax-highlighting.rq".file_inbound_code_lens] ). The extension host runs the query and pushes a snapshot to the language server. The language server does not open SQLite ( [consumers.extension_ui_consumers] ). Updates follow index sync independently of open-file parse ( ["../language/syntax.rq".open_file_reference_sequencing], [inbound_snapshot_events] ). Mutation hooks already use the same store. Share one graph. Related: [index_cache_reuse], ["../indexer/indexer.rq".local_symbolic_analysis], ["../extension/language/syntax/features-syntax-highlighting.rq".inbound_inlay_index_performance]. | 0.213 | |
| index_consumers | [workspace_index], [editor_index_adapter], [analysis_runtime], [activity_bar_host], [ideas_summary_panel], [mcp_server] | done | Modules that read or write [ideas_schema.ideas_index_sqlite] / [index]: - Engine write / read: [workspace_index], Rust sync / store under [ownership] - Extension adapter: [editor_index_adapter] ( watchers, Uri conversion, multi-base ) - Headless: [analysis_runtime] for [cli_package] and [mcp_server] - Activity bar: [activity_bar_host] ( ideas-in-file, hop refs, search via fuzzy ) - Ideas Summary: [ideas_summary_panel] ( table SQL, graph slices, overview ) - Search: [fuzzy_search], [file_search] - Check / analyse / export: [check], analytical export APIs - Local graph: [local_graph_analysis] Product aliases: [index_ideas], [index_technology], [consumption]. Related: [cache_reuse.index_cache_reuse], ["./sequencing.rq".index_sequencing]. | 0.169 | |
| diagnostics_sqlite | [diagnostics_rust], [diagnostics_store_ts] | done | Per-base timing and index-issue store at `<base>/.reqlan/index-diagnostics.sqlite` ( [index_diagnostics_store] / [application_memory] ). Sibling of [ideas_schema.ideas_index_sqlite]; Clear & rebuild of the ideas index must not delete it. Authoritative schema lives in Rust ( [diagnostics_rust], `DIAGNOSTICS_SCHEMA_VERSION = 2` ). The TypeScript facade ( [diagnostics_store_ts] ) is thinner and focuses on timing rows. Related: [index_diagnostics_timing], [index_diagnostics], [index_diagnostics_metrics], [index_diagnostics_webview], [sidecars.sqlite_wal_sidecars], [consumers.diagnostics_consumers]. | 0.210 | |
| git_dates | ["../../crates/reqlan-index/src/git_dates.rs"], ["../../packages/analytical/src/index-store/sqlite-store.ts"] | done | Creation and last-modified dates, and change count, for ideas via git history where available. Values are written into the ideas index by the `git_dates` analyser as a silent background job after soft-sync / catalog updates ( batched, yielded ) — not triggered by Activity Bar focus, opening Timeline, or Ideas table load. Host queue and rate caps: ["../extension/index-host/git-codelens.rq".git_dates_background_indexing]. | 0.143 | |
| index_code_files | ["../../crates/reqlan-index/src/comment.rs"], ["../../crates/reqlan-index/src/sync.rs"], ["../../crates/reqlan-index/src/store.rs"], ["../../packages/extension/src/analytical_submodule/index-store/index-service.ts"] | done | Index non- `.rq` source files that contain [comment_reference] ( `rq:[idea]` / `rq:["path".idea]` ). The same directory scan records allowlisted text paths ( respecting `.rqignore`, [app_memory_doc.binary_ignore], [app_memory_doc.commentless_file_ignore], and nested child bases ). Content reads use that list. They are not a second directory walk. [app_memory_doc.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: [graph_analysers.file_related_requirements], ["../core_analysis/search.rq".file_search], ["../core_analysis/html_export.rq".html_export_code_reference_pages], Ideas Summary comment-reference rows, local graph ( idea → external file node ), ["../cli/click.rq".click_code_file]. See [index_comment_reference_inclusion], ["../ontology.rq".referenced_files]. | 0.394 | |
| local_symbolic_analysis | ["../../crates/reqlan-index/src/extract.rs"], ["../../crates/reqlan-index/src/types.rs"], ["../../crates/reqlan-napi/src/lib.rs"], ["../../packages/analytical/src/native/parse-source.ts"], ["../../packages/analytical/src/core/local-symbolic-references.ts"], ["../../packages/language/src/reqlan-document-link-provider.ts"], ["../../packages/language/src/reqlan-definition-provider.ts"], ["../../packages/language/src/reqlan-local-symbolic-links.ts"], ["../../packages/language/src/reqlan-utf8-lsp-offset.ts"], ["../../packages/cli/src/commands/analyse.ts"], ["../../packages/extension/src/activity_bar_module/local-symbolic-context.ts"], ["../../packages/extension/src/activity_bar_module/context-model.ts"] | done | Open-file symbolic analysis must run in Rust on one file only. Input: file URI plus source text ( and optional import-root mappings ). Output: ideas in that file, import binding names in that file, outbound edges with UTF-8 source byte spans, and same-file inbound backlinks ( edges whose target is an idea declared in this file ). Import binding names let a qualified reference name an import alias ( ["../core_analysis/check.rq".check_qualified_missing_idea] ). LSP document-link and error underlines must convert those spans to UTF-16 ( ["../extension/language/syntax/features-syntax-highlighting.rq".reference_underline_syntax_align] ). Cross-file inbound still comes from SQLite via ["./cache-reuse.rq".unify_inbound_indexes]. Do not read SQLite. Do not walk other workspace documents. Do not load an idea catalog. The open-buffer model is ["../extension/language/support/open-file-sequencing.rq".ast_lifecycle]. The hot path parses this buffer once. It does not run this extract as a second parse. Import-target confirmation is a separate depth-1 parse ( ["../extension/language/support/open-file-sequencing.rq".outbound_one_hop] ). That parse is not this extract. The language server caches the open buffer by URI plus text fingerprint ( ["../extension/language/support/open-file-sequencing.rq".open_file_hot_path] ). Wildcard forms stay one `wildcard_reference` pattern edge ( unresolved ); sync still expands them later via [wildcard_reference_edges]. Flag: `ExtractOptions.local_symbolic` forces an empty candidate list. CLI: ["../cli/cli_package.rq".commands] `analyse --local-symbolic <file>`. Sidebar: ["../extension/local-context/activitybar-panels/current_context_scope.rq".reference_lists_pane] merges live same-file inbound / outbound with indexed refs ( [local_symbolic_sidebar] ). Related: ["../language/syntax.rq".open_file_reference_sequencing], [index], ["./cache-reuse.rq".unify_inbound_indexes]. | 0.387 | |
| local_symbolic_sidebar | ["../../packages/extension/src/activity_bar_module/local-symbolic-context.ts"], ["../../packages/extension/src/activity_bar_module/context-model.ts"], ["../../packages/extension/src/activity_bar_module/context-helpers.ts"], ["../../packages/analytical/src/index-store/sqlite-store.ts"] | done | The activity bar reference lists and current-file scope must consume [local_symbolic_analysis] for the open buffer text so same-file inbound backlinks and outbound refs appear even when the SQLite index is stale or not ready. Merge live local rows with indexed `listReferencesForIdea` / hop-depth rows; dedupe by direction plus edge id ( and by idea id for scope idea chips ). Prefer the referencer name as the inbound label ( not the edge target label ). | 0.108 | |
| wildcard_reference_edges | ["../../crates/reqlan-index/src/extract.rs"], ["../../crates/reqlan-index/src/types.rs"], ["../../crates/reqlan-index/src/sync.rs"], ["../../crates/reqlan-index/src/extract.rs"], ["../../packages/analytical/src/core/types.ts"], ["../../packages/analytical/src/index-store/sqlite-store.ts"], ["../../packages/language/src/reqlan-wildcard-resolve.ts"] | done | Native extract ( `["../../crates/reqlan-index/src/extract.rs"]` ) expands each AST wildcard against the idea catalog ( `match_wildcard` / workspace candidate list ). Persist one edge of kind `wildcard_reference` per matching idea ( label = target idea name ); never emit plain `references` for wildcard forms. Zero matches → one unresolved edge of the same kind ( `isResolved: false`, label = pattern text ). Edge ids use `edgeId(source, 'wildcard_reference', targetOrUnresolvedKey)`. Sync walks sorted `.rq` files and grows the catalog as it goes, so a wildcard file is expanded against ideas already stored plus files earlier in that walk ( ["../../crates/reqlan-index/src/sync.rs"] ). Ancestor / reference-chain walks treat `wildcard_reference` like `references` ( ["../../packages/analytical/src/index-store/sqlite-store.ts"] ). Ideas Summary references table groups them under sub-idea with other idea-to-idea links; graph visibility is [ideas_summary_doc] / ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".wildcard_refs_toggle]. Soft mtime sync skips unchanged files — after introducing this edge kind, reindex ( or touch ) `.rq` files that contain wildcards so stored rows leave any legacy `references` fan-out. Langium `idea-extractor` keeps the same kind for remaining TS extract paths. Open-file local extract ( [local_symbolic_analysis] ) does not expand wildcards against a catalog. Related: ["../language/imports.rq".wildcard_references], [index], [indexer_rust], ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".wildcard_refs_toggle], [local_symbolic_analysis]. | 0.353 | |
| index_sequencing | [editor_index_adapter], [workspace_index], [analysis_runtime] | done | Describe when the ideas index starts, updates, and idles, and which trigger owns each pass. Capability aliases live in [triggers] and [idea_index_triggers]. Detail ideas below; keep [nonblocking_index] and [indexing_incrementality] as the UX rules. Related: [consumers.index_consumers], [cache_reuse.index_cache_reuse], [ideas_schema.documents_table], [diagnostics_schema.sync_runs_table]. | 0.179 | |
| scan_limits | ["../../packages/analytical/src/core/defaults.json"], ["../../crates/reqlan-index/build.rs"], ["../../crates/reqlan-index/src/scan.rs"], ["../../packages/analytical/src/core/scan-limits.ts"], ["../../packages/extension/package.json"], ["../../crates/reqlan-index/src/ignore.rs"], ["../../packages/analytical/src/core/rqignore.ts"] | done | The workspace scan has two caps. There is no unlimited setting. Defaults and clamp bounds are the `scan` object in ["../../packages/analytical/src/core/defaults.json"]. `reqlan.scan.maxDepth` uses `defaultMaxDepth`, `minDepth`, and `maxDepthLimit` from that file. The workspace folder is depth 0. A directory deeper than the cap is not entered. `reqlan.scan.maxEntries` uses `defaultMaxEntries`, `minEntries`, and `maxEntriesLimit` from that file. The count is directories plus files visited. When a cap hits, the walk stops, keeps the partial result, and the editor shows a warning. It does not start another scan to finish. Refresh uses the same caps. CLI and MCP use the same defaults. Built-in ignore also skips `target/` so a Cargo tree does not consume the entry budget. [extension_startup_sequence] [cache_reuse.single_sync_walk] | 0.064 | |
| reqlan_directory_layout | [application_memory_impl], [ignore_rust] | done | Each base owns `<base>/.reqlan/` ( [application_memory] ). Contents: - `ideas-index.sqlite` — [ideas_schema.ideas_index_sqlite] - `index-diagnostics.sqlite` — [diagnostics_schema.diagnostics_sqlite] / [index_diagnostics_store] - `click-sessions.sqlite` — ["../cli/click.rq".click_session] - SQLite WAL / SHM / journal sidecars — [sqlite_wal_sidecars] - `config.json` — [json_siblings] / [base_configuration] - `.rqignore` — [rqignore] - `.gitignore` — [base_initialisation_ignore] / [vcs_ignore_for_stores] - `export_settings.json` — [json_siblings] Path helpers: [application_memory_impl]. Override: `REQLAN_INDEX_PATH` for a single store. | 0.177 | |
| vcs_ignore_for_stores | [ignore_rust], [application_memory_impl] | New bases seed `.reqlan/.gitignore` so SQLite databases and their WAL / SHM / journal sidecars stay out of version control ( [base_initialisation_ignore] ). `.rqignore` is separate: it filters discovery / index walks, not VCS ( [rqignore] ). [sqlite_wal_sidecars] [reqlan_directory_layout] | 0.063 | ||
| ideas_index_sqlite | [schema_ts], [schema_rust], [store_rust], [sqlite_store] | done | The ideas graph for one [base_ownership] lives at `<base>/.reqlan/ideas-index.sqlite` under [application_memory]. Schema version is in ( `SCHEMA_VERSION` in [schema_ts] and [schema_rust] ). Runtime migrate runs in Rust ( [store_rust] ); TypeScript opens the store and calls native migrate ( [sqlite_store] ). Keep [schema_ts] aligned with [schema_rust]. Related: [index], [indexer_rust], [ownership], [sidecars.sqlite_wal_sidecars], [diagnostics_schema.diagnostics_sqlite], [consumers.index_consumers]. | 0.226 | |
| schema_migrations | [schema_ts], [schema_rust], [store_rust] | Base tables use `CREATE … IF NOT EXISTS` ( [schema_ts] `BASE_MIGRATIONS` / [schema_rust] ). Versioned upgrades run `(current+1)..=SCHEMA_VERSION`: - v2 — edge `source_line`, `snippet`, `is_resolved` - v3 — document `mtime_ms` - v4 — idea `git_change_count` Duplicate-column errors on ALTER are ignored so re-open is safe. Fresh databases create full v4 columns, then set `schema_version` to 4. Open pragmas: `foreign_keys=ON`, `journal_mode=WAL` ( [sidecars.sqlite_wal_sidecars] ). [ideas_index_sqlite] | 0.058 | ||
| attribute_namespaceing | true | an idea's attributes should be referenceable in links. an idea should be able to access `[attribute_namespacing.example]` Links should link appropriately the parser, lexer,... extension, html... | 0.040 | ||
| idea-leading-whitespace | true | Block ideas often have leading whitespace The base level should be decided by the first line, subsequent lines should not be fully trimmed THis line has 4 spaces ( same as first line ). It should parse with no leading whitespace This line has 8 spaces ( 4 more than first line ) it should parse with 4 spaces as part of the content. | 0.045 | ||
| anonymous_imports_allowed | ["../../packages/language/src/reqlan-scope.ts"], ["../../packages/language/src/reqlan-linker.ts"] | done | A quoted path plus idea — for example `["../ontology.rq".attribute]` — opens that file as an ideaset. Every idea in the target file is in scope for that reference. A from-import or qualified import of the same path only binds the listed names for bare `[name]` references. It must not hide other ideas from a quoted-path reference. | 0.073 | |
| configuration_import_root_alias | ["../../packages/language/src/reqlan-path-resolve.ts"], ["../../packages/language/src/file-path-rewrite.ts"], ["../../packages/language/src/reqlan-completion-provider.ts"], ["../../packages/language/src/reqlan-path-completion.ts"], ["../../packages/language/src/reqlan-comment-diagnostics.ts"], ["../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../crates/reqlan-parse/src/path.rs"], ["../../crates/reqlan-index/src/path_resolve.rs"], ["../../crates/reqlan-index/src/broken.rs"], ["../../crates/reqlan-index/src/sync.rs"], ["../../crates/reqlan-index/src/comment.rs"], ["../../crates/reqlan-lsp/src/analysis.rs"], ["../../crates/reqlan-lsp/src/session.rs"] | An import path may start with an alias string, then `/`, then a relative path under that alias's import-root directory. Default alias string: `@`, written as `@/` plus a path relative to the import root. Default import-root directory: the workspace folder that contains the `.rq` file ( not the document directory ). The path after `/` is joined to that alias's import-root directory; the alias itself must be followed by `/` ( e. g. `@reqs` is not aliased ). Alias strings and import-root directories are configured as [configuration.configuration_import_roots] in the applying `.reqlan/config.json` from [configuration.configuration_location]. A configured relative `root` resolves against the base root ( parent of `.reqlan` ); an omitted `root` keeps the workspace-folder default. When several configured aliases could match a path, the longest alias wins. Related path forms: [import_paths], ["../extension/language/comment-references/functional-code-comment-references.rq".comment_reference_import_root_alias]. Completion: ["../extension/language/syntax/features-syntax.rq".code_completion]. File references and the language server use the same locate rule as ["../core_analysis/check.rq".check]: load `importRoots` from the applying `.reqlan/config.json` for the source file ( [configuration.configuration_location] ), then `resolve_rq_path` and join the workspace when the result is relative — including paths with spaces such as `["@/my file.ts"]`. | 0.296 | ||
| idea_path_filter | ["../../packages/extension/src/activity_bar_module/idea-path-filter.ts"] | done | Shared path-filter helper for [wildcard_references_webview] search seeding. Glob or substring match against workspace-relative path and file URI; leading `./` / `../` segments are stripped for relative filters; `**/` is implied when the filter has glob meta but is not already rooted with `**/`. Used only as a hard AND after fuzzy ranking — it never replaces the idea-name query. | 0.078 | |
| import_error_recovery | ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-validator.ts"] | A malformed import must not invalidate the rest of the file. Recoverable invalid `from` shapes parse as local import nodes with a line-level diagnostic: - `from "path" as alias` ( mistaken namespace form ) — suggest `import "path" as alias` or `from "path" import <idea>` - bare `from "path"` — require the `import <idea>` clause - `from` without a quoted path — consume the remainder of the line as an invalid import Later imports and top-level ideas continue to parse and link normally. Same recovery posture for nameless top-level braces: ["./syntax.rq".no_name_idea_safe_warning]. If lex / parse never completes, see ["./parser_lexer.rq".parse_budget_timeout]. | 0.058 | ||
| import_from | ["../../crates/reqlan-parse/src/parser.rs"], ["../../crates/reqlan-parse/src/ast.rs"], ["../../crates/reqlan-lsp/src/analysis.rs"] | From-import syntax uses from, a quoted path, import, and an idea name. From-import may list more than one idea. Separate the names with commas. From-import may include an alias using as. The parser records a span for the path, each idea name, and each alias. Each of those tokens is its own document link. The path links to the file. An idea name links to that declaration. An alias links to the same declaration. When the alias contains the imported idea name, Ctrl + click on a bracket reference still treats the whole alias as one link. See ["../extension/language/syntax/features-syntax-highlighting.rq".aliased_from_import_ctrl_click]. The language server uses the parser spans: ["../extension/language/support/language-server-rust.rq".language_server_rust]. | 0.220 | ||
| import_tokenisation | ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-import-bindings.ts"], ["../../packages/language/src/reqlan-validator.ts"], ["../../packages/language/src/reqlan-scope.ts"] | if an import is given an alias, then the base name is still available as a variable name and should not cause a conflict. Only the alias binds in the importing file; the imported idea's base name may be reused for a local idea. e. g. The same rule applies to qualified imports with `as`. Unaliased imports still bind the idea name and conflict with a local idea of that name. Related: ["../extension/language/syntax/features-syntax.rq".sensible_alias_support]. | 0.053 | ||
| wildcard_references | ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-wildcard-resolve.ts"], ["../../packages/language/src/reqlan-token-builder.ts"], ["../../packages/language/src/reqlan-validator.ts"], ["../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../packages/language/src/reqlan-definition-provider.ts"], ["../../packages/language/src/reqlan-document-link-provider.ts"], ["../../crates/reqlan-index/src/extract.rs"], ["../../crates/reqlan-index/src/sync.rs"], ["../../crates/reqlan-index/src/extract.rs"], ["../../packages/analytical/src/index-store/workspace-index-file.ts"], ["../../packages/extension/src/language/main.ts"] | done | Qualified path + idea-pattern references match multiple ideas across files. Surface forms: bracket `[…]` and wikilink `[[…]]` ( same `WildcardReference` target ). Path is a quoted string that may include shell-style globs ( `*`, `**`, `?` ) and `@/` import-root aliases ( [configuration_import_root_alias] ). Relative globs resolve against the defining document directory; `.` / `..` segments are collapsed before matching. Idea pattern is an unquoted `WILDCARD_NAME` that must contain at least one `*` or `?` Exact quoted-path plus idea stays ["./syntax.rq".reference_qualified]. Matching uses anchored globs ( not full JS regex ): path `*` is one segment, `**` crosses segments; idea `*` / `?` match within the idea name. Zero matches produce a warning diagnostic. One match also produces a warning — a wildcard is for many ideas; use a concrete ["./syntax.rq".reference_qualified] when only one idea matches ( ["../core_analysis/check.rq".check_wildcard_one] ). Path segment `/**/` must not be lexed as an empty block comment — see ["./syntax.rq".comments]. Lexer note: `ID` is a prefix of many wildcard names ( `import_` vs `import_*` ); the token builder sets `ID.LONGER_ALT = WILDCARD_NAME` so `import_*` is one token. Body prose `*` tokens are accepted via `WILDCARD_NAME` in PlainText so ordinary `*` characters still parse. Without that longer-alt, a live wildcard inside a block body can fail Idea recovery and leave later top-level ideas unindexed ( soft mtime sync will not rebuild until the `.rq` file changes ). Navigation does not emit N LocationLinks. A document-link click opens `reqlan.openWildcardReference` with `{ pathPattern, ideaPattern, fromUri }` ( see [wildcard_references_webview] ). Go-to-definition does not open that panel. Indexing fans out per ["../indexer/indexer.rq".wildcard_reference_edges] ( owned under ["../indexer/indexer.rq".index] ): native extract writes one `wildcard_reference` edge per catalog match; empty catalog / zero matches → one unresolved edge of that kind labeled with the pattern text. ["../core_analysis/check.rq".check] handles 0 - match and 1 - match fan-out through ["../core_analysis/check.rq".check_wildcard_zero] and ["../core_analysis/check.rq".check_wildcard_one] ( ["../core_analysis/check.rq".check_wildcard_sparse] ). Ideas Summary graph toggles those edges via ["../extension/workspace-summary/ideas_summary/graphical_graph.rq".wildcard_refs_toggle]. The server can answer `reqlan/wildcardReferenceAt`. Go-to-definition does not call it. Related: ["./syntax.rq".reference_embedding], ["./syntax.rq".reference_brackets], ["./syntax.rq".reference_wikilink], ["../indexer/indexer.rq".wildcard_reference_edges], ["../core_analysis/check.rq".check_wildcard_sparse], ["../core_analysis/check.rq".check_wildcard_zero], ["../core_analysis/check.rq".check_wildcard_one]. Illustrative forms ( fenced so this file does not embed live wildcards ): | 0.486 | |
| wildcard_references_webview | ["../../packages/extension/src/extension/register-wildcard-reference-handling.ts"], ["../../packages/extension/src/extension/wildcard-matches-panel.ts"], ["../../packages/extension/src/extension/main.ts"], ["../../packages/extension/src/activity_bar_module/wildcard-matches-payload.ts"], ["../../packages/extension/src/activity_bar_module/idea-path-filter.ts"], ["../../packages/extension/src/activity_bar_module/activity-bar-messages.ts"], ["../../packages/extension/webviews/activity-bar/state/app.svelte.ts"], ["../../packages/extension/package.json"] | done | A click on the command document link for a [wildcard_references] target runs `reqlan.openWildcardReference` and opens a dedicated **wildcard matches** webview ( beside the editor ) that lists: - Stats: matching idea count, distinct file count, and @ status breakdown - Requirements: each matching idea with name, status, path, and summary ( click opens the idea ) - Files: each matching file with idea count ( click opens the file ) Secondary action **Open in Search** seeds the activity-bar ["../extension/local-context/activitybar-panels/search.rq".search_pane_seed] via `focusIdeaSearch` with: - `query`: idea pattern with glob meta softened for fuzzy search ( `import_*` → `import` ) - `pathFilter`: the path glob as a hard AND filter ( [idea_path_filter] ) Payload builder: `buildWildcardMatchesPayload` filters the index catalog by idea glob + path filter. Protocol for the matches panel is inline host ↔ webview ( `init` / `openIdea` / `openFile` / `openSearch` ). The document-link target is the command URI. Go-to-definition does not open the panel. Highlighting of the source reference must stay link-styled — see ["../extension/language/syntax/features-syntax.rq".syntax_highlighting] and ["../extension/language/syntax/features-syntax-highlighting.rq".wildcard_reference_highlighting]. | 0.199 | |
| parse_budget_timeout | ["../../packages/analytical/src/core/defaults.json"], ["../../packages/language/src/reqlan-parse-budget.ts"], ["../../packages/language/src/reqlan-async-parser.ts"], ["../../packages/language/src/reqlan-parse-worker.ts"], ["../../packages/language/src/reqlan-document-factory.ts"], ["../../packages/language/src/reqlan-module.ts"], ["../../packages/language/src/reqlan-workspace-manager.ts"] | done | Lexing, parsing, or a parse subprocess for a single `.rq` file must finish within `parseBudgetMs` from ["../../packages/analytical/src/core/defaults.json"]. If it cannot, do not hang the language server or block the rest of the workspace. Surface both a warning ( budget exceeded; semantic features may be incomplete ) and an error ( file left unloaded ) on that document, then continue with other files. Happy path stays in-process ( sync ) for typical file sizes so edits and workspace load stay fast. Killable worker enforcement is used when the input is large, a file previously hit the budget ( sticky escalate ), or a caller forces the worker path; sync throws still become the same incomplete result shape. The open buffer stores that result as an empty model plus diagnostics ( ["../extension/language/support/open-file-sequencing.rq".ast_lifecycle] ). | 0.197 | |
| context_sensitive_lexer_scaling | ["../../packages/language/src/reqlan-token-builder.ts"] | done | Context-sensitive token classification for structural / prose braces and top-level import keywords must remain linear in document size. The lexer records brace-depth changes sparsely ( not per-character tables ) and looks them up in log time while tokenising, so workspace language-server initialization and editor re-lexes stay bounded. Code fences are skipped during the brace scan so example braces cannot inflate work or desync depth. Bounded work still assumes the lexer / parser *returns*; unbounded hangs are cut by ["./parser_lexer.rq".parse_budget_timeout]. | 0.097 | |
| fencing_comments | ["../../packages/language/src/reqlan-line-fences.ts"], ["../../packages/language/src/reqlan-token-builder.ts"], ["../../packages/language/src/reqlan-comment-resolver.ts"], ["../../packages/language/scripts/patch-textmate.mjs"], ["../../packages/language/syntaxes/reqlan.tmLanguage.json"], ["../../crates/reqlan-parse/src/lexer.rs"], ["../../crates/reqlan-index/src/rq_ignore.rs"] | done | A complete same-line fence keeps `//` and `/*` as prose, not comments. Closed double quotes: " / / this line " contains no comment. Closed backticks: `//this line` contains no comment. Closed backticks with a glob: `@reqlan/*` does not open a block comment. An unclosed backtick is not a fence, so this line ` An unclosed quote is not a fence, so as does " The Langium lexer, the Rust lexer, comment scanners, and TextMate must use this rule. Related: ["./syntax.rq".comments], ["./syntax.rq".inline_code], ["./syntax.rq".naked_strings_in_body], ["../core_analysis/rust_port.rq".comment_span_align]. | 0.078 | |
| nested_curly_braces | ["../../packages/language/src/reqlan-token-builder.ts"] | if there is a prose block containing curly braces, { such as this one } they should be treated as part of the prose. Matching braces that end a line — including adjacent pairs like { { SITE_URL } } — stay in the body; they must not close the enclosing idea. A lone `}` on its own line still closes the structural block so an unbalanced prose `{` cannot swallow the idea closer. | 0.108 | ||
| attribute_namespacing | ["../../packages/language/src/reqlan.langium"], ["../../crates/reqlan-parse/src/lexer.rs"], ["../../crates/reqlan-parse/src/parser.rs"], ["../../packages/language/src/reqlan-scope.ts"], ["../../packages/language/src/reqlan-linker.ts"], ["../../packages/language/src/reqlan-attribute-links.ts"], ["../../packages/language/src/reqlan-references.ts"], ["../../packages/language/src/reqlan-reference-code-lens.ts"], ["../../packages/language/src/reqlan-document-link-provider.ts"], ["../../packages/language/src/reqlan-local-symbolic-links.ts"], ["../../packages/language/src/reqlan-outbound-presentation.ts"], ["../../packages/language/src/reqlan-semantic-token-provider.ts"], ["../../crates/reqlan-index/src/extract.rs"], ["../../crates/reqlan-export/src/html_utils.rs"], ["../../crates/reqlan-export/src/html_template/mod.rs"] | done | A bracket link `[idea.attribute]` targets one attribute of that idea. The first name is the idea name. The second name is the attribute name. The grammar types that name as an attribute or an idea declaration. `[attribute_namespacing.example]` targets the `example` attribute of this idea. The form `[ideaset.member]` still targets an ideaset member. See [references_to_subidea]. The editor opens the attribute when the first name is an idea. The editor reports an error when that idea has no attribute with the second name. The link target is only that attribute on that idea. HTML export uses the same link form. The export link opens that attribute on the idea page. See [attribute_namespacing.example]. Related: [reference_brackets], [attribute_marker], ["../core_analysis/html_export.rq".html_export_internal_links]. | 0.129 | |
| code_snippets | ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-token-builder.ts"], ["../../packages/language/src/reqlan-line-fences.ts"], ["../../packages/language/scripts/patch-textmate.mjs"], ["../../crates/reqlan-parse/src/lexer.rs"] | Idea bodies and block attribute values may embed fenced code blocks delimited by triple backticks. An opening fence is three backticks as the first non-whitespace characters on a line, optionally followed by a language tag such as python or rq. A closing fence is three backticks as the first non-whitespace characters on a line. Three backticks in the middle of a line are prose. They do not open a fence. Everything between the fences is literal opaque text — it is not parsed as reqlan syntax. Keywords, imports, attributes, braces, and quotes inside a fence are inert for the parser and may be shown as examples without parse errors. Fenced blocks may span multiple lines and preserve their inner content verbatim. Brace-depth tracking must skip fence interiors so example braces cannot desync surrounding structure ( [no_name_idea_safe_warning] ). Related: ["../core_analysis/rust_port.rq".comment_span_align]. | 0.113 | ||
| comment_reference | ["../../crates/reqlan-index/src/comment.rs"], ["../../packages/language/src/reqlan-comment-resolver.ts"], ["../../packages/language/src/reqlan-comment-diagnostics.ts"], ["../../packages/language/src/reqlan-path-resolve.ts"], ["../../packages/extension/src/extension/register-comment-reference-links.ts"], ["../../packages/extension/src/extension/comment-reference-path-context.ts"], ["../../packages/extension/src/extension/comment-reference-languages.ts"] | done | Reqlan references may appear in line comments of arbitrary source files. Comment reference syntax is `rq:[idea]` or `rq:["path".idea]` ( quoted path, optional extra qualification ). Qualified paths use the same path forms as imports, including import-root aliases such as `@/` — ["imports.rq".configuration_import_root_alias], ["../extension/language/comment-references/functional-code-comment-references.rq".comment_reference_import_root_alias]. Discovery skips quoted strings, including Rust raw strings ( `r#"…"#`, `r##"…"##`, `br#"…"#` ), so `rq:[…]` text in a string is not a live comment. Editor language coverage is a blocklist, not an allowlist: ["../extension/language/comment-references/functional-code-comment-references.rq".comment_reference_language_blocklist]. Indexed as `comment_link` by ["../indexer/indexer.rq".index_code_files]. Unresolved targets: [comment_reference_resolution_error]. Indexer listing: ["../core_analysis/core.rq".test_references]. Refactors: ["../extension/mutation/refactor_support.rq".comment_reference_refactor_support]. | 0.365 | |
| comment_reference_ignore | [rq_ignore], [reqlan_napi], [ignore_error_bridge], [langium_ignore_error], [comment_diagnostics], [language_server_main], [extension_main], [broken_refs], [check_command] | done | Comment reference ignore syntax uses `//rq-ignore-error`. Comment reference ignore suppresses diagnostics on the immediately following line. The language server and the CLI use the same core scanner [rq_ignore]. | 0.511 | |
| comment_reference_resolution_error | ["../../packages/language/src/reqlan-comment-diagnostics.ts"], ["../../packages/extension/src/extension/register-comment-reference-links.ts"] | done | If a comment reference cannot be resolved, show it as an error diagnostic. Do not create a document link to a missing file ( that underline then raises a generic cannot-find-file editor error ). Related: [comment_reference], [comment_reference_ignore], ["../reference_types.rq".comment_reference], ["../extension/language/comment-references/functional-code-comment-references.rq".references_in_functional_code_comments]. | 0.151 | |
| comments | ["../../packages/language/src/reqlan-token-builder.ts"], ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-comment-resolver.ts"], ["../../packages/language/src/reqlan-line-fences.ts"], ["../../packages/language/scripts/patch-textmate.mjs"], ["../../packages/language/syntaxes/reqlan.tmLanguage.json"] | done | Line comments use `//` through end of line ( hidden `SL_COMMENT` ). Block comments use `/* … */` and may span multiple lines ( hidden `ML_COMMENT` ). Meta comments on the same line after content are allowed ( `keep this // meta` ). Comments must not open inside a string / reference-string context: - Naked body quotes ( ["naked_strings_in_body"] ): a quoted slash-slash that is not a comment, quoted urls, `"../mod/**/*.rq"`. - Reference / import `STRING` paths ( `["…"]`, `from "…" import …` ) — the lexer consumes the whole quoted path as one `STRING`, so neither `//` nor `/*` inside the quotes starts a comment. Example: a file reference whose path text contains slash-slash, `["../extension/**/*.rq".*webview*]`. - URL / path-segment guard: `//` immediately after `:` or `/` is not a line comment. Same-line fences: ["./syntax-edge-cases.rq".fencing_comments] — complete `"…"`, `'…'`, and ` ` ` … ` ` ` spans keep ` Unclosed quote or backtick openers are not fences, so `//` after them is a comment. Comment-range identity across lexer, scanner, and TextMate: ["../core_analysis/rust_port.rq".comment_span_align]. Multiline / glob clash: the empty block form `/**/` is **not** a comment — it is the recursive glob segment used in paths such as `../mod/**/*.rq`. A real block comment needs a non-empty body ( `/* note */`, `/*\n note\n*/` ). The token builder rejects length-4 `/**/` matches; comment-span scanners skip the same sequence so embedded `rq:[…]` discovery stays aligned. Related: [comment_reference_ignore], [string_literals], ["./imports.rq".wildcard_references], ["../core_analysis/rust_port.rq".comment_span_align]. | 0.145 | |
| empty_attribute | ["../../packages/language/src/reqlan-token-builder.ts"], ["../../packages/language/src/reqlan.langium"], ["../../crates/reqlan-parse/src/lexer.rs"] | A line that contains only @ is insignificant whitespace. Spaces or tabs may precede that @. Spaces or tabs may follow that @. The lexer consumes that @ as hidden whitespace. The parser does not build an attribute for that line. That line does not cause a parser error. That line does not cause a lexer error. That line does not cause a tokenizer error. That line does not cause an extension error. A flag keeps the form @ name. A negated flag keeps the form @ name!. A valued attribute keeps its value after the name. A syntax error on a different line is still reported. | 0.040 | ||
| idea_name | ["../../packages/language/src/reqlan-validator.ts"] | Idea names are identifiers or double-quoted strings. Unquoted names follow identifier rules and may use letters, digits, underscores, and dashes, for example myidea, my_idea, or dash-or_underscore_delimited-idea. Quoted names allow spaces and other characters when wrapped in double quotes. Idea names must be unique within their ideaset or file. An idea, one-liner, and ideaset must not share a name in the same file. Idea names should not use reserved keywords. | 0.063 | ||
| inline_code | ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-embedded-file-references.ts"], ["../../packages/language/scripts/patch-textmate.mjs"], ["../../crates/reqlan-parse/src/lexer.rs"], ["../../crates/reqlan-index/src/extract.rs"] | done | Single-backtick spans ( `…` ) are opaque `INLINE_CODE`. They may show example syntax such as a quoted path plus idea. The grammar does not parse bracket or file references inside the span. Check and the language server must not report those examples as unresolved ["../reference_types.rq".file_reference] or idea refs. Related: [code_snippets], ["../core_analysis/rust_port.rq".comment_span_align]. | 0.165 | |
| no_name_idea_safe_warning | ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-token-builder.ts"], ["../../packages/language/src/reqlan-validator.ts"], ["../../packages/language/src/reqlan-workspace-manager.ts"] | done | A top-level nameless curly-brace block — `{... }` with no idea name — must not take down the parser or the language server workspace. Parse the block as a recoverable anonymous top-level element, emit a descriptive warning that a name is required before `{`, and continue so later ideas, imports, and links still work. Nameless blocks inside parenthesized lists remain valid list items per [lists]; only top-level nameless blocks warn. Related recovery posture: ["./imports.rq".import_error_recovery]. Block shape: [block_idea]. Fenced examples must stay opaque per [code_snippets] so braces inside snippets cannot desync structural depth. Non-termination ( lex / parse never finishes ) is a different failure mode: ["./parser_lexer.rq".parse_budget_timeout]. | 0.072 | |
| reference_file | ["../../packages/language/src/reqlan-file-references.ts"], ["../../packages/language/src/reqlan-path-resolve.ts"], ["../../packages/language/src/reqlan-imports.ts"], ["../../packages/language/src/reqlan-comment-resolver.ts"], ["../../crates/reqlan-parse/src/path.rs"], ["../../packages/language/src/reqlan-file-link-resolver.ts"], ["../../crates/reqlan-index/src/broken.rs"] | References may target arbitrary files, not only. rq files. File reference syntax uses a bracketed quoted path. A relative path resolves from the document directory. When that path climbs with `..` and the file is not there, the same path is tried from each ancestor directory up to the workspace folder. The document-directory file wins when it exists. Line or line-range references append `L#n` or `L#n-m` after the path inside the brackets. Test-name references append `:` and the test title after the path ( for example `./app.test.ts:lists items` ). The first `:` after the path starts the title; later `:` characters stay in the title ( `e2e: …` ). `://` and a Windows drive `C:` / `C:/` are part of the path, not a test suffix. Symbol references append a dot-separated symbol path after the quoted file path. Quoted body text is not a file reference: ["../reference_types.rq".reference_edgecase]. | 0.266 | ||
| reference_qualified | ["../../packages/language/src/reqlan-scope.ts"], ["../../packages/language/src/reqlan-linker.ts"] | Cross-file references may qualify an import path or alias with an idea name. Qualified wikilinks may combine a quoted import path with a dot and idea name. A quoted path opens the target file as an ideaset ( ["./imports.rq".anonymous_imports_allowed] ). Partial from-import of that path does not restrict which ideas the quoted path can name. | 0.247 | ||
| reference_resolution_order | ["../../packages/language/src/reqlan-scope.ts"], ["../../packages/language/src/reqlan.langium"], ["../../crates/reqlan-index/src/extract.rs"] | done | For each `.rq` file, identify the names in local scope, then resolve references. Sequence: 1. Collect all idea, one-liner, and ideaset declarations in the file. Declaration order does not change which names are in scope. 2. Collect reference candidates in the file. 3. Resolve each candidate against those local declarations. 4. Resolve imports only for candidates that have no local match. Stop import lookup for a candidate when a local match exists. The language server and the indexer must use this sequence. Open-file editor underlines follow [open_file_reference_sequencing]. Related: [same_file_reference], [ideaset], ["./imports.rq".import_tokenisation], ["../indexer/indexer.rq".local_symbolic_analysis]. | 0.053 | |
| reference_url | ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-token-builder.ts"], ["../../crates/reqlan-parse/src/lexer.rs"], ["../../crates/reqlan-parse/src/parser.rs"], ["../../packages/language/src/reqlan-file-link-resolver.ts"] | done | A bracket reference may target an unquoted absolute URL ( `scheme://…` ). Example: `[https://reqlan.com/]`. The URL is one token; `://` is not a line comment. Unbracketed URLs in body prose stay text. Quoted remote paths stay [reference_file] ( `["https://example.com/file.ts"]` ). Index and check: ["../reference_types.rq".url_reference]. | 0.137 | |
| references_to_subidea | ["../../crates/reqlan-index/src/extract.rs"], ["../../packages/language/src/reqlan.langium"], ["../../packages/language/src/reqlan-scope.ts"] | done | It is valid to reference a member of an [ideaset] as `[ideaset.member]`, for example [example_ideaset.subidea1]. The indexer must record that reference on the namespace leaf node. In this example the leaf is [subidea1], not [example_ideaset]. Related: [reference_brackets], [same_file_reference], ["../reference_types.rq".idea_reference], ["../indexer/indexer.rq".index]. | 0.167 | |
| same_file_reference | ["../../packages/language/src/reqlan-scope.ts"], ["../../packages/language/src/reqlan-linker.ts"], ["../../crates/reqlan-index/src/extract.rs"] | [reference_brackets] and [reference_wikilink] may target an idea, one-liner, or [ideaset] in the same file. The target may be declared before or after the reference. Forward references are valid. Circular references between declarations in the same file are valid. Resolution order: [reference_resolution_order]. | 0.100 | ||
| idea-leading-whitespace | ["../../crates/reqlan-parse/src/parser.rs"], ["../../crates/reqlan-parse/src/lexer.rs"], ["../../packages/language/src/reqlan-body-indent.ts"] | A block body can have spaces or tabs before the text. The lexer counts a space and a tab as whitespace. A tab is one whitespace character. The parser does not replace a tab with spaces. The base indent is the whitespace at the start of the first body line. The first body line is the first line of body text in the block. The first body line can start after column 0. The base indent is still the whitespace on that line. A body line with the same whitespace as the base indent has no leading whitespace in the parsed text. A body line keeps the whitespace that remains after the base indent. The parser removes the base indent only when the line starts with that same whitespace. An attribute on its own line stays an attribute. Example: the first body line has four spaces. A later line with four spaces has no leading whitespace. A later line with eight spaces has four spaces in the parsed text. This line has the same four spaces as the first body line. This line has eight spaces. | 0.040 | ||
| katz_centrality | ["../../crates/reqlan-search/src/katz.rs"], ["../../crates/reqlan-analytical/src/api.rs"], ["../../packages/analytical/src/native/native-analysis-api.ts"] | done | Score each idea by inbound Katz centrality on the citation graph. An idea scores higher when important ideas reference it. The score uses resolved reference edges and wildcard reference edges between ideas. The analysis package exposes the scores as `katzCentrality()`. The top score is 1. A graph with no citation edges gives every idea the score 1. Search can opt in through ["../core_analysis/search.rq".katz_search]. HTML export shows the score through ["../core_analysis/html_export.rq".html_export_katz_column]. | 0.061 | |
| attribute | [reqlan_grammar], [analytical_types], [idea_extractor], [rust_extract] | done | Attributes are classification, functional, or nonfunctional metadata. Syntax: ["./language/syntax.rq".attribute_marker], ["./language/syntax.rq".attribute_forms], ["./language/syntax.rq".attribute_values], ["./language/syntax.rq".attribute_location]. Policy: ["./language/attributes.rq".attribute_configuration]. Indexed on [analytical_types] `IdeaAttributeMap`; extract: [idea_extractor], [rust_extract]. Product surface: [ideas_summary_tabs] Attributes tab. | 0.070 | |
| attribute_body | [reqlan_grammar], [idea_extractor], [rust_extract] | done | The first attribute in an idea, if not marked otherwise, is the main body attribute. It is unstructured text. Syntax: ["./language/syntax.rq".block_idea]; extract summary from that body: [idea_extractor], [rust_extract]. | 0.054 | |
| base | [base_discovery], ["../packages/analytical/src/index-store/base-registry.ts"], ["../packages/analytical/src/core/application-memory.ts"] | done | A base is a container for ideas, ideasets, and files — the boundary of one ideas graph. Discovery: a directory is a base only when it owns a `.reqlan` application-memory folder. There is no implicit base from a bare workspace folder; the product prompts the user to create `.reqlan` at the workspace-folder root when none exist. Bases may be nested: a child directory with its own `.reqlan` is a separate base; the parent base's index stops at that child boundary. Each base holds its own ideas index under its `.reqlan`. Details: ["./bases/base.rq".base]. | 0.251 | |
| cartographic_map | [graph_view], ["../packages/analytical/src/index-store/webview-graph-queries.ts"], ["../packages/extension/src/ideas_summary_module/ideas-summary-panel.ts"] | done | A cartographic map is a visual representation of a graph, optimised / curated by the user for context. Product: ["./extension/workspace-summary/ideas_summary/graphical_graph.rq".graphical_graph] ( [graph_view] ). Distinct from a full-graph dump; [atlas] is a further curated overlay, not yet implemented. | 0.046 | |
| configuration | [path_resolve], ["../packages/extension/schemas/config.schema.json"] | done | There are multiple scopes for configuration: at the [base] level and at the [extension] level. Base config: ["./extension/host/configuration.rq".configuration_location] ( `<base>/.reqlan/config.json` ). Base vs extension split: ["./bases/base.rq".base_configuration]. | 0.040 | |
| extension | [extension_main], ["../packages/extension/src/language/main.ts"], ["../packages/extension/package.json"] | done | The extension contains the editor product features. Host: [extension_main]; scope: ["./extension/host/scope.rq".vscode_extension], ["./extension/host/scope.rq".lsp_support]. Architecture: ["./extension/host/architecture.rq".event_driven]; packages: ["./core-architecture.rq".extension_package]. Domain hierarchy: ["./extension/extension.rq".extension_product], ["./extension/extension.rq".extension_domains]. | 0.102 | |
| file | [reqlan_grammar], [analytical_types], [idea_extractor] | done | Files store ideas and form ideasets. Documents use the `.rq` suffix ( ["./language/syntax.rq".file_suffix] ) and ["./language/syntax.rq".file_layout]. Indexed as ideaset kind `file` in [analytical_types]. | 0.094 | |
| grammar_rule | [reqlan_grammar], [comment_grammar], [rust_ast], ["../packages/language/src/reqlan-token-builder.ts"] | done | Grammar rules describe the syntax features. Requirements: ["./language/syntax.rq"]; lexer bridge: ["./language/parser_lexer.rq".lexer_bridge_to_syntax]. Langium: [reqlan_grammar]; comment grammar: [comment_grammar]; index-path AST: [rust_ast]. | 0.040 | |
| idea | [reqlan_grammar], [analytical_types], [idea_extractor], [rust_ast], [rust_extract] | done | A reqlan core unit is an idea. Syntax: ["./language/syntax.rq".simple_idea], ["./language/syntax.rq".block_idea]. Grammar: [reqlan_grammar] `Idea` / `OneLinerIdea`; index records: [analytical_types] `IdeaRecord`. Extract: [idea_extractor], [rust_extract]; AST: [rust_ast]. Product surface: [ideas_summary_tabs] Ideas tab per ["./extension/workspace-summary/ideas_summary/webview.rq".ontology_aligned_tabs]. | 0.110 | |
| idea_name | [reqlan_grammar], [rust_ast] | done | The idea name is a string / handle / variable that uniquely identifies the idea ( within the ideaset / file ). It should not be a reserved [keyword]. Syntax: ["./language/syntax.rq".idea_name]; grammar: [reqlan_grammar] `IdeaName`. | 0.069 | |
| ideaset | [reqlan_grammar], [analytical_types], [idea_extractor], [rust_index_types] | done | Ideasets are namespace containers for ideas. Syntax: ["./language/syntax.rq".ideaset]. Grammar: [reqlan_grammar] `IdeaSet`. Index kind `ideaset` plus `ideaset_member` edges: [analytical_types], [idea_extractor], [rust_index_types]. A [file] is an implicit ideaset ( ["./language/syntax.rq".file_layout] ). Product surface: [ideas_summary_tabs] Ideasets tab. | 0.134 | |
| import_statement | [reqlan_grammar], [import_resolver], [path_resolve], [rust_ast] | done | Imports describe references. Some [keyword] s are reserved for imports. Forms: ["./language/imports.rq".import_from], ["./language/imports.rq".import_namespace], ["./language/imports.rq".import_qualified]. Grammar: [reqlan_grammar] `Import`; resolve: [import_resolver]. | 0.063 | |
| keyword | [reqlan_grammar], [import_resolver] | done | As a language, reqlan has keywords that are reserved in some contexts. Import statement keywords: ["./language/imports.rq".import_keywords] ( `import`, `from`, `as` ). Grammar: [reqlan_grammar] — those tokens are keywords only at statement start. Idea names should not use reserved keywords ( [idea_name] ). | 0.057 | |
| reference | [reqlan_grammar], [idea_extractor], [rust_extract], ["../packages/language/src/reqlan-file-link-resolver.ts"], ["../packages/language/src/reqlan-definition-provider.ts"] | done | References link ideas to other ideas, files, and symbols. Syntax: ["./language/syntax.rq".reference_brackets], ["./language/syntax.rq".reference_wikilink], ["./language/syntax.rq".reference_qualified], ["./language/syntax.rq".reference_file], ["./language/syntax.rq".reference_url], ["./language/syntax.rq".reference_embedding]. Kinds: [reference_types]. Grammar: [reqlan_grammar] `ReferenceTarget`; index edges: [idea_extractor], [rust_extract]. | 0.655 | |
| referenced_files | [file_reference_resolve], [comment_resolver], [comment_grammar], [idea_extractor], ["../crates/reqlan-index/src/comment.rs"], ["../packages/extension/src/extension/register-comment-reference-links.ts"] | done | Non- `.rq` files that ideas reference, or that reference ideas. These may be shared. They should be captured in the ["./indexer/indexer.rq".index]. Outbound file refs: ["./language/syntax.rq".reference_file], [file_reference_resolve], edge kind `file_reference` in [analytical_types]. Inbound comment refs: ["./extension/language/comment-references/functional-code-comment-references.rq".references_in_functional_code_comments] via [comment_resolver] / [comment_grammar]. Full non- `.rq` file indexing of comment-bearing sources: ["./indexer/indexer.rq".index_code_files]. Click treats those files as centres: ["./cli/click.rq".click_code_file]. | 0.169 | |
| github_funding | ["../.github/FUNDING.yml"] | done | The GitHub sponsor button is configured in ["../.github/FUNDING.yml"]. The GitHub Sponsors username is the account in phonebook link id `github-sponsors`. Discord is community, not a funding platform: do not list it in FUNDING. yml. | 0.046 | |
| show_in_footer | ["./phonebook.schema.json"], ["./phonebook.json"], ["../scripts/phonebook.ts"], ["../site/src/lib/phonebook.ts"], ["../site/src/components/Footer.tsx"], ["../site/src/content/contact.ts"] | done | Each entry under `links` in ["./phonebook.json"] may set `show-in-footer`. The property is optional. Omitted means true. Set `show-in-footer` to false to keep a link out of the site footer and the landing contact list. Packages do not have this property. Schema: ["./phonebook.schema.json"]. Typed helpers: `isShownInFooter`, `phonebookFooterLinks` in ["../scripts/phonebook.ts"] and ["../site/src/lib/phonebook.ts"]. per ["./site/site.rq".footer] per ["./site/site.rq".links] | 0.072 | |
| comment_reference | [comment_resolver], [analytical_types], ["../packages/extension/src/extension/register-comment-reference-links.ts"], ["../packages/extension/src/extension/comment-reference-path-context.ts"], ["../packages/language/src/reqlan-comment-diagnostics.ts"], ["../crates/reqlan-index/src/comment.rs"] | done | Inbound ["./ontology.rq".reference] from comments in non- `.rq` source: `rq:[idea]` / `rq:["path".idea]`. Qualified paths may use import-root aliases ( `rq:["@/path".idea]` ) per ["./language/imports.rq".configuration_import_root_alias] and ["./extension/language/comment-references/functional-code-comment-references.rq".comment_reference_import_root_alias]. Spec: ["./extension/language/comment-references/functional-code-comment-references.rq".references_in_functional_code_comments] Syntax note: ["./language/syntax.rq".comment_reference]. Resolve: [comment_resolver]. Unresolved: ["./language/syntax.rq".comment_reference_resolution_error]. Index edge kind `comment_link`. Related capture of those files: ["./ontology.rq".referenced_files]. Indexer: ["./indexer/indexer.rq".index_code_files]. | 0.119 | |
| file_reference | [file_reference_resolve], [idea_extractor], [analytical_types], [reqlan_grammar], ["../packages/language/src/reqlan-file-link-resolver.ts"] | done | Outbound ["./ontology.rq".reference] to a file, folder, or symbol — not only `.rq`. Syntax: ["./language/syntax.rq".reference_file] ( bracketed quoted path, optional `L#` / symbol path ). Index edge kind `file_reference`. Resolve: [file_reference_resolve]; extract: [idea_extractor]. Editor links: ["./extension/language/syntax/features-syntax.rq".file_references]. Inbound file-reference CodeLens at the top of the target file: ["./extension/language/syntax/features-syntax-highlighting.rq".file_inbound_code_lens]. Non- `.rq` targets and inbound comment traffic: ["./ontology.rq".referenced_files]. Markdown `[label](target)` also stores this edge kind — see [link_reference]. Quoted body text is not this kind: [reference_edgecase]. | 0.211 | |
| idea_reference | [reqlan_grammar], [analytical_types], [idea_extractor], [rust_extract] | done | Idea-to-idea ["./ontology.rq".reference]: bracket `[name]` / `[ideaset.name]` targets a local, imported, or same-file idea. Syntax: ["./language/syntax.rq".reference_brackets], ["./language/syntax.rq".same_file_reference], ["./language/syntax.rq".reference_qualified], ["./language/syntax.rq".reference_embedding], ["./language/syntax.rq".references_to_subidea]. Index edge kind `references` on [analytical_types] / [rust_index_types]. Extract: [idea_extractor], [rust_extract]. A `[ideaset.member]` form records the edge on the member leaf, not on the ideaset container. An attribute uses the same brackets. See ["./language/syntax.rq".attribute_namespacing]. Wikilink surface for the same edge kind: [link_reference]. Fan-out across files: [wildcard_reference]. | 0.125 | |
| ideaset_reference | [reqlan_grammar], [analytical_types], [idea_extractor], [rust_index_types] | done | References to an ["./ontology.rq".ideaset] or a namespace that behaves as one. Syntax: ["./language/syntax.rq".ideaset]; namespace import alias: ["./language/imports.rq".import_namespace] ( `[alias]` opens the imported file and links only the alias name ). Membership edges are `ideaset_member`; a bare namespace-alias bracket is stored as `file_reference` ( [idea_extractor] ), not `references`. | 0.057 | |
| link_reference | [reqlan_grammar], [idea_extractor] | done | Link-shaped ["./ontology.rq".reference] surfaces that are not a bare `[idea]` bracket. Wikilink `[[target]]` ( optional alias pipe ): ["./language/syntax.rq".reference_wikilink] — indexes as idea-to-idea `references`, same as [idea_reference]. Markdown `[label](target)`: ["./language/syntax.rq".markdown_links] — label is not an idea ref; the target indexes as `file_reference` ( [file_reference] ). | 0.112 | |
| reference_edgecase | ["../packages/language/src/reqlan-embedded-file-references.ts"], ["../packages/language/src/reqlan-file-link-resolver.ts"], ["../packages/language/src/reqlan-token-builder.ts"], [idea_extractor], [reqlan_grammar], ["../crates/reqlan-parse/src/lexer.rs"] | done | A quoted string is a [file_reference] only when it is inside brackets. Example of a file reference: ["./reference_types.rq"] Example of body text: " this is not a reference. rq " The file suffix does not change this rule. The parser must not make a file reference from quoted body text. The language server must not make a document link or a missing-file error from quoted body text. Related: [file_reference], ["./language/syntax.rq".naked_strings_in_body], ["./language/syntax.rq".reference_file]. | 0.112 | |
| url_reference | [reqlan_grammar], [analytical_types], [idea_extractor], [rust_extract], [rust_index_types], ["../packages/language/src/reqlan-token-builder.ts"], ["../packages/language/src/reqlan-file-link-resolver.ts"], ["../crates/reqlan-parse/src/lexer.rs"], ["../crates/reqlan-parse/src/parser.rs"] | done | A bracket reference whose target is an absolute URL with a scheme and `://`. Example: [https://reqlan.com/]. Syntax: ["./language/syntax.rq".reference_url]. Index edge kind `url_reference` on [analytical_types] / [rust_index_types]. Extract: [idea_extractor], [rust_extract]. [check] does not treat a URL reference as a missing idea or a missing file. Unbracketed URLs in body prose stay text, not this kind. Related: [file_reference], [link_reference]. | 0.075 | |
| wildcard_reference | [rust_extract], [rust_index_types], [idea_extractor], [analytical_types], [reqlan_grammar], ["../packages/language/src/reqlan-wildcard-resolve.ts"] | done | One ["./ontology.rq".reference] that matches many ideas: quoted path glob + idea pattern ( `*` / `?` ). Syntax and navigation: ["./language/imports.rq".wildcard_references], ["./language/imports.rq".wildcard_references_webview]. Index: one `wildcard_reference` edge per catalog match ( ["./indexer/indexer.rq".wildcard_reference_edges] ); never stored as plain `references`. Native extract: ["../crates/reqlan-index/src/extract.rs"]. Sparse match handling: ["./core_analysis/check.rq".check_wildcard_sparse] ( ["./core_analysis/check.rq".check_wildcard_zero], ["./core_analysis/check.rq".check_wildcard_one] ). | 0.279 | |
| assessment | ["../../site/src/content/assessment.ts"], ["../../site/src/lib/certificate-token.ts"], ["../../site/src/views/AssessmentPage.tsx"] | done | A named quiz with a stable id, a title, a blurb, and sections of questions. Questions live in ["../../site/src/content/assessment.ts"] per ["./site.rq".copy]. Current sole quiz id `core`. Sections: ontology, installation, syntax, graph, cli. Ontology covers [idea], [ideaset], [file], [base], [attribute], [attribute_body], [reference]. Advanced syntax covers imports, file refs, wildcards, and comment refs. CLI covers click and `reqlan check` for reference integrity in CI / CD. Pass at 80 %. Then collect a display name and mint a certificate token. The token claim `a` identifies this assessment. After mint, go to [certificate_page] with the token and the just-completed query param. | 0.065 | |
| assessment_page | ["../../site/src/app/certs/assessment/page.tsx"], ["../../site/src/app/certs/assessment/[id]/page.tsx"], ["../../site/src/app/assessment/page.tsx"], ["../../site/src/app/tutorials/assessment/page.tsx"], ["../../site/src/views/AssessmentPage.tsx"], ["../../site/src/views/AssessmentListPage.tsx"], ["../../site/src/content/assessment.ts"], ["../../site/src/lib/certs-paths.ts"] | done | `/certs/assessment/` shows the sole [assessment] quiz when there is one. When there is more than one [assessment], it lists them. `/certs/assessment/[id]/` is that assessment's quiz. Unknown ids are not found. Legacy `/assessment/` and `/tutorials/assessment/` redirect here and keep the query string. The home ["./site.rq".quiz_sticker_tab] links here. It does not run the quiz in the tab. | 0.075 | |
| certificate_page | ["../../site/src/app/certs/certificate/page.tsx"], ["../../site/src/app/tutorials/certificate/page.tsx"], ["../../site/src/views/CertificatePage.tsx"], ["../../site/src/lib/certs-paths.ts"], ["../../site/src/lib/certificate-token.ts"], ["../../site/src/content/assessment.ts"] | done | `/certs/certificate/` shows a minted certificate. Token query param `c` holds the packed claims, including [assessment] id `a`. Query param `just=1` marks the just-completed view: - show the certificate - show a shareable link that omits `just` - embed the sticker form per [sticker_form_embed] Without `just`, the page is the shareable certificate only. Do not embed the form. Invalid or missing tokens send the user back to [assessment_page]. The completion line on a valid certificate names the [assessment] and links to that quiz. Legacy `/tutorials/certificate/` redirects here and keeps the query string. | 0.062 | |
| certs | ["../../site/src/app/certs/assessment/page.tsx"], ["../../site/src/app/certs/assessment/[id]/page.tsx"], ["../../site/src/app/certs/certificate/page.tsx"], ["../../site/src/lib/certs-paths.ts"], ["../../site/src/lib/certificate-token.ts"], ["../../site/src/content/assessment.ts"] | done | Certification lives under `/certs/`. Pages: - [assessment_page] at `/certs/assessment/` ( sole quiz when one [assessment]; catalog when more ) - one quiz per [assessment] at `/certs/assessment/[id]/` - [certificate_page] at `/certs/certificate/` The tutorials catalog and ["./support-page.rq".support_page] advocacy link send the user to [assessment_page]. Tokens are honor-system claims in ["../../site/src/lib/certificate-token.ts"]. Claim `a` is the [assessment] id ( not a section id ). | 0.054 | |
| sticker_form_embed | ["../../site/src/views/CertificatePage.tsx"], ["../../site/src/lib/google-form-embed.ts"], ["../../site/src/lib/phonebook.ts"], ["../phonebook.json"] | done | The just-completed [certificate_page] embeds phonebook link id `sticker-form` as a Google Form iframe. Href comes from [phonebook], not a hardcoded URL in the view. Convert the href to an embed `src` ( `viewform` plus `embedded=true` ). Keep a direct link to the same phonebook href if the iframe does not load. Hide the form when the user prints the certificate. | 0.048 | |
| accurate_rq_snippets_must_parse | ["../../site/src/content/parse-rq-snippet.ts"], ["../../site/src/content/accurate-rq-snippets.ts"], ["../../site/src/content/example.ts"], ["../../site/src/content/syntax.ts"], ["../../site/src/content/hero.ts"], ["../../site/src/content/showcases"], ["../../site/scripts/validate-showcase-rq.mts"] | done | Every site snippet that demonstrates accurate reqlan must parse against the Langium grammar. In scope: language- " rq " blocks ( landing syntax pairs, the example slice, the hero snippet, showcase `.rq` blocks ). Out of scope: ts / md / py snippets that only show `rq:` comment links. Invalid-on-purpose samples must not be labelled language- " rq ". Enforced by tests plus the content parse gate in ["../../site/scripts/validate-showcase-rq.mts"]. Showcases are a subset per [every_rq_block_must_parse] / [phase_1_parse_gate]. | 0.090 | |
| agent_context_showcase | ["../../site/src/content/showcases/agent-context.ts"] | done | ai, mcp, planning | Flagship. Context for the agent, not the repo. An agent answers a question about session expiry. Show the repo-dump cost, then MCP click returning compact file context, then the plan the agent writes. Absorbs former agentic-planning and feature-tracking pages. | 0.050 |
| antipatterns_showcase | ["../../site/src/content/showcases/antipatterns.ts"] | done | antipattern, craft | Depth. Three ways to write. rq badly. Data instead of pointers, prose restating code, one monolithic file. Showing negative space is a taste signal. Absorbs former data-not-ideas page; expands it. | 0.045 |
| attribute_dialect_showcase | ["../../site/src/content/showcases/attribute-dialect.ts"] | done | attributes, extensibility | Depth. Attributes as a domain dialect. The full attribute grammar: flags, negated flags, block values, nested and named lists — forms nobody currently knows about. Absorbs former arbitrary-attributes page. | 0.045 |
| audit_trail_showcase | ["../../site/src/content/showcases/audit-trail.ts"] | done | compliance, audit, export | Depth. An audit trail you can export. Custom clause / evidence / verified_by attributes, then Completion Status showing the coverage gap, then HTML export as the auditor's deliverable. Domain: regulated software — IEC 62304 or SOC 2. Absorbs former compliance page. | 0.045 |
| broken_links_showcase | ["../../site/src/content/showcases/broken-links.ts"] | done | diagnostics, refactor, cli, ci | Flagship. Links that break loudly. Someone renames a file. Show the diagnostic, the quick-fix menu, and the rewritten refs. Then the same issue from ["../core_analysis/check.rq".check] ( `reqlan check`, exit 1 ) and that command as a CI step so a merge cannot land rot. This is the argument against a wiki. Domain: refactor safety, any stack. | 0.190 |
| claim_cycle | ["../../site/src/components/ElevatorPitch.tsx"], ["../../site/src/components/ElevatorPitch.module.css"] | done | Show one claim at a time and cycle in order. Pause on hover or focus. Tracks jump to a claim. The active claim sits in the vertical centre of a slot sized for the longest claim, so shorter lines do not jump to the top. | 0.056 | |
| claim_expand | ["../../site/src/components/ElevatorPitch.tsx"], ["../../site/src/components/ElevatorPitch.module.css"] | done | A toggle expands every [elevator_pitch_section] claim into one list. The rotating cycle stays the default. Expanding pauses the cycle. Collapsing returns to the cycle. Reduced motion still starts on the list per [claim_reduced_motion]. | 0.056 | |
| claim_progress | ["../../site/src/components/ElevatorPitch.tsx"], ["../../site/src/components/ElevatorPitch.module.css"] | done | A track per claim shows hold-time state: past tracks are full, the current track fills left to right, later tracks stay empty. Pause holds the fill. The fill and the cycle share one clock so they do not drift. | 0.056 | |
| claim_reduced_motion | ["../../site/src/components/ElevatorPitch.tsx"], ["../../site/src/components/ElevatorPitch.module.css"] | done | When the visitor prefers reduced motion, show the full claim list with no cycle and no progress animation. | 0.064 | |
| code_block_styling | ["../../site/src/content/types.ts"], ["../../site/src/lib/highlight.ts"], ["../../site/src/components/CodeBlock.tsx"], ["../../site/scripts/generate-highlights.mts"] | Code blocks should be styled per language as a function of a classname; or by using an appropriate lightweight external dependency. Language ids live in ["../../site/src/content/types.ts"]. CodeLanguage —. rq,. ts,. md,. py, plus st / c / json / yaml for showcases. If using a dependency, it should parse at build, not in the browser. | 0.052 | ||
| copy | ["../../site/src/content/types.ts"], ["../../site/src/content/site.ts"], ["../../site/src/content/meta.ts"], ["../../site/src/content/nav.ts"], ["../../site/src/content/hero.ts"], ["../../site/src/content/featured.ts"], ["../../site/src/content/motivation.ts"], ["../../site/src/content/syntax.ts"], ["../../site/src/content/example.ts"], ["../../site/src/content/roadmap.ts"], ["../../site/src/content/contact.ts"], ["../../site/src/content/faq.ts"], ["../../site/src/content/support.ts"], ["../../site/src/content/sticky-cta.ts"], ["../../site/src/content/quiz-sticker.ts"], ["../../site/src/content/assessment.ts"] | done | Marketing copy lives in typed TS modules under ["../../site/src/content"], composed by ["../../site/src/content/site.ts"]. Shared types: ["../../site/src/content/types.ts"]. Copy stays decoupled from layout / styling. Copy should be really super minimal and concise if at all. ( show don't tell ) Copy should be user facing; not simply a description of the feature requirements. Production code doesn't have latent dev notes in visible components. Landing modules: [hero_section], [elevator_pitch_section], [featured_in_section], [motivation_section], [syntax_section], [example_section], [roadmap_section], [nav_graph], [faq_page], [sidebar_nav], [links], [footer], [sticky_cta_node], [quiz_sticker_tab]. | 0.336 | |
| cta_icon | ["../../site/src/content/hero.ts"], ["../../site/src/content/install-actions.ts"], ["../../site/src/components/HeroActions.tsx"], ["../../site/src/components/InstallSplitButton.tsx"], ["../../site/src/lib/quickstart-icons.ts"] | done | The hero has a separate " Install extension " menu button. The menu lists Cursor, VS Code, and Download VSIX. It must not include Open VSX. Open VSX stays on [quickstart_page]. It must not assume the user's editor or pre-select one silently. The CLI control is a separate button per [install_cli_menu]. Get-started CTA copy lives in ["../../site/src/content/hero.ts"] per [hero_section]. Each menu row shows the target's icon beside its full label; icons resolve through [phonebook_icon_registry] via the quickstart icon set / name refs in ["../../site/src/content/install-actions.ts"]. per [components] per [development_core.iconify_stack] | 0.078 | |
| elevator_pitch_section | ["../../site/src/content/meta.ts"], ["../../site/src/content/nav.ts"], ["../../site/src/components/ElevatorPitch.tsx"], ["../../site/src/components/ElevatorPitch.module.css"], ["../../site/src/components/NavGraph.tsx"], ["../../site/src/views/HomePage.tsx"] | done | Landing `#elevator-pitch` after [hero_section] and before [featured_in_section]. This is the home " Why reqlan " destination: [sidebar_nav] child and [nav_graph] Why node use this id. One-line thesis plus rotating claims. Copy lives in ["../../site/src/content/meta.ts"] per [copy]. Thesis follows ["../constitution.rq".elevator_pitch]. Behaviours: [claim_cycle], [claim_progress], [claim_reduced_motion], [claim_expand]. Styling per [styling_architecture]. Must stay compatible with [simple_lightweight_and_static]. | 0.123 | |
| example_section | ["../../site/src/content/example.ts"], ["../../site/src/components/Example.tsx"] | done | Landing `#example`: one worked graph slice ( imports, file anchors, wildcards, status, tags, tests ). Copy lives in ["../../site/src/content/example.ts"] per [copy]. The slice must parse as accurate reqlan per [accurate_rq_snippets_must_parse]. | 0.091 | |
| faq_drift | ["../../site/src/content/faq.ts"], ["../../site/src/content/nav.ts"] | done | The FAQ includes this question: How do you keep `.rq` files from drifting once the code moves on? `.rq` files are code. They are the source of truth. They are not a document. Specify material work as an idea first. Implementation and tests point back with rq-comments per [development_core.code_comment_references] and [development_core.testing]. A check requires each test to serve a requirement. Agents see only the ideas that attach to the files they touch. Mark a replaced idea deprecated and point to the new idea. The indexer flags missing references like a compile check. Copy lives in ["../../site/src/content/faq.ts"] ( item id `drift` ) per [copy] and [faq_page]. The sidebar nests this question as a same-page child per [sidebar_nav]. | 0.057 | |
| faq_page | ["../../site/src/app/faq/page.tsx"], ["../../site/src/views/FaqPage.tsx"], ["../../site/src/views/faq.module.css"], ["../../site/src/content/faq.ts"], ["../../site/src/content/nav.ts"], ["../../site/src/components/Sidebar.tsx"], ["../../site/src/components/NavGraph.tsx"] | done | The site exposes `/faq/` as a statically generated page answering a short set of common questions. Copy lives in ["../../site/src/content/faq.ts"] and stays minimal per [copy]. Support answers point at [support_page_reqs.support_page] and at phonebook surfaces ( GitHub stars, marketplace stars, issues / contribution, GitHub Sponsors, Discord ) rather than inventing URLs. Required topics: - how reqlan supports token efficiency - whether reqlan is the de facto standard for efficient developer-centric context management and semantic mapping - when to use reqlan - how `.rq` files stay in sync with code per [faq_drift] - how to support reqlan ( GitHub stars, GitHub Sponsors, VS Marketplace stars, Discord, contribution, bug reporting ) Sidebar nests FAQ question anchors as same-page children per [sidebar_nav]. Landing nav graph includes FAQ as a page node. | 0.132 | |
| featured_in_section | ["../../site/src/content/featured.ts"], ["../../site/src/components/FeaturedIn.tsx"], ["../../site/src/components/FeaturedIn.module.css"], ["../../site/src/views/HomePage.tsx"], ["../../site/src/content/site.ts"] | done | Landing `#featured-in` after [elevator_pitch_section] and before [motivation_section]. Rolling social-proof banner: label " As featured in: " plus catalogue cards that scroll slowly in a continuous loop. Each card shows an icon and an outbound link label. Required listings ( labels match the catalogue names ): - agentlanguages. dev → https://agentlanguages.dev/languages/reqlan/ - awesome-spec-driven-development → https://github.com/Engineering4AI/awesome-spec-driven-development - awesome-docs → https://github.com/testthedocs/awesome-docs Copy and icons live in ["../../site/src/content/featured.ts"] per [copy]. Icons resolve through [phonebook_icon_component] / [icon_registry]. Links open in a new tab with `rel="noopener noreferrer"`. Pause the scroll on hover or focus. When the visitor prefers reduced motion, show a static row of the same cards with no scroll. Do not put these URLs in the phonebook footer / contact list. Styling per [styling_architecture]. Must stay compatible with [simple_lightweight_and_static]. | 0.122 | |
| firmware_cloud_contract_showcase | ["../../site/src/content/showcases/firmware-cloud.ts"] | done | integration, cross-stack, embedded | Flagship. The contract between firmware and cloud. A 10 Hz sample rate and a 50 ms ingest deadline: one invariant, two codebases, neither of which can express it alone. Absorbs half of former glue-semantics and static-connection. | 0.050 |
| footer | ["../../site/src/components/Footer.tsx"], ["../../site/src/components/Footer.module.css"], ["../../site/src/content/meta.ts"], ["../../site/src/lib/phonebook.ts"] | done | The site footer is on every page via ["../../site/src/components/SiteShell.tsx"]. Copyright copy lives in ["../../site/src/content/meta.ts"] per [copy]. The footer shows phonebook `links` where `show-in-footer` is not false per [phonebook_reqs.show_in_footer]. Icons render through [phonebook_icon_component]. | 0.109 | |
| get_started_cta_motion | ["../../site/src/components/ui/hover-border-gradient.tsx"], ["../../site/src/components/ui/hover-border-gradient.module.css"], ["../../site/src/components/HeroActions.tsx"] | done | The get-started control on [hero_section] shows a moving colour wash on the border and on the button fill. The wash uses the aqua and rust brand colours. The border wash and the fill wash share one spin period and one spin direction. When the visitor prefers reduced motion, show a static fill and a static border. per [styling_architecture] | 0.058 | |
| graph_view_showcase | ["../../site/src/content/showcases/graph-view.ts"] | done | extension, graph | Depth. See the whole graph. Needs real captured screenshots or a short loop from the actual Cytoscape view — not fake ASCII arrows dressed as. rq. Aligns with [diagrams_are_never_dressed_as_code]. | 0.050 |
| hero_github_star | ["../../site/src/content/hero.ts"], ["../../site/src/components/HeroActions.tsx"], ["../../site/src/components/HeroActions.module.css"] | done | The [hero_section] action row shows a Star on GitHub control next to get-started and the install controls. The control opens the GitHub repository from [phonebook_reqs.phonebook] in a new tab. The icon comes from [phonebook_icon_component]. Copy lives in ["../../site/src/content/hero.ts"] per [copy]. The hero control is in addition to [sticky_cta_node] and [support_page_reqs.support_page]. | 0.064 | |
| hero_section | ["../../site/src/content/hero.ts"], ["../../site/src/components/Hero.tsx"], ["../../site/src/components/HeroActions.tsx"] | done | Landing `#hero`: mascot plus a short `.rq` snippet. Copy lives in ["../../site/src/content/hero.ts"] per [copy]. The snippet must parse as accurate reqlan per [accurate_rq_snippets_must_parse]. Install controls are [cta_icon] and [install_cli_menu]; get-started CTA href is `/quickstart` per [quickstart_page]. Get-started motion follows [get_started_cta_motion]. A GitHub star control sits in the action row per [hero_github_star]. | 0.135 | |
| images | ["../../site/scripts/generate-images.mjs"], ["../../site/public/logo.svg"], ["../../site/public/og.png"] | The source logo is in the / public folder. A sharp dev script is used to generate pngs and favicons etc which should be executed if the svg source logo changes. The script also writes the Open Graph image `/og.png` ( 1200 × 630 ) per [meta_tags]. | 0.046 | ||
| install_cli_menu | ["../../site/src/content/install-actions.ts"], ["../../site/src/content/quickstart.ts"], ["../../site/src/components/HeroActions.tsx"], ["../../site/src/components/InstallSplitButton.tsx"], ["../../site/src/components/QuickstartClient.tsx"], ["../../site/src/lib/quickstart-icons.ts"], ["../../site/src/lib/package-manager.ts"], ["../../site/src/lib/use-package-manager.ts"] | done | The hero has a separate " Install CLI " control. It must not nest inside [cta_icon]. The primary action copies the selected package manager command for [cli_package.cli_package] per [package_manager_preference]. A chevron menu lists npm, pnpm, yarn, and bun. Each command uses the CLI package name from [phonebook_reqs.npm_packages]. A click copies the selected command to the clipboard and stores the preference. The [quickstart_page] CLI and MCP install rows use the same package manager options and the same preference. A copy must not change the last-used editor. | 0.099 | |
| interlock_showcase | ["../../site/src/content/showcases/interlock.ts"] | done | industrial, safety, sequencing | Flagship. The interlock that must not fail. `["./plc/interlock.stL#41-58"]` A safety requirement bound to that PLC symbol and line range, line range, to a vitest case by test name, with an rq-comment in the ST source pointing back. Domain: industrial control / IEC 61131. | 0.050 |
| legacy_archaeology_showcase | ["../../site/src/content/showcases/legacy-archaeology.ts"] | done | legacy, discovery, deprecation | Depth. Archaeology on inherited code. An undocumented function, an rq-comment seeded into it, @ deprecated on the old path, then Deprecation Impact listing everything that breaks. Absorbs former scattered-docs page. | 0.045 |
| links | ["../../site/src/content/contact.ts"], ["../../site/src/components/Contact.tsx"] | per [phonebook_reqs.phonebook] per [phonebook_reqs.npm_packages] per [phonebook_reqs.show_in_footer] Contact copy lives in ["../../site/src/content/contact.ts"] per [copy]. Contact shows phonebook `links` that are not opted out of the footer, then a Packages subsection for phonebook `packages`. per [link_icons] per [package_icons] | 0.131 | ||
| meta_tags | ["../../site/src/content/meta.ts"], ["../../site/src/lib/site-metadata.ts"], ["../../site/src/app/layout.tsx"], ["../../site/scripts/generate-images.mjs"], ["../../site/public/og.png"] | done | The site HTML head must include a document title, a description, a canonical URL, Open Graph tags, and Twitter card tags. Canonical origin is the phonebook `site` href per [phonebook_reqs.phonebook]. Default title and description live in ["../../site/src/content/meta.ts"] per [copy]. Root layout ["../../site/src/app/layout.tsx"] sets the shared metadata: title template `%s · reqlan`, description, icons, manifest, theme colour, Open Graph image, and Twitter `summary_large_image`. Each marketing page must set a title and a description. Showcase and tutorial detail pages use the item title and summary. Open Graph image is 1200 × 630 PNG at `/og.png`, generated with favicons per [images]. Compatible with [simple_lightweight_and_static]. Do not index the presentation player route per [presentation_player_route]. | 0.051 | |
| module_surface_showcase | ["../../site/src/content/showcases/module-surface.ts"] | done | modularity, imports, ideasets | Depth. A module's published surface. billing / interface. rq exports an ideaset; checkout. rq imports only that; reaching past the boundary is an unresolved-import error. Ideasets-as-public-API is undemonstrated today. Absorbs half of former glue-semantics and module-interface. | 0.045 |
| motivation_section | ["../../site/src/content/motivation.ts"], ["../../site/src/components/Motivation.tsx"], ["../../site/src/components/MotivationClient.tsx"] | done | Landing `#motivation` after [featured_in_section]: what / why slides for language, extension, CLI, and MCP. Copy lives in ["../../site/src/content/motivation.ts"] per [copy]. | 0.108 | |
| nav_graph | ["../../site/src/content/nav.ts"], ["../../site/src/components/NavGraph.tsx"] | done | Sticky landing page graph. Node / edge model and labels live in ["../../site/src/content/nav.ts"] per [copy] / [sidebar_nav]. Section nodes match home anchors; page nodes match top-level routes in [routes]. | 0.123 | |
| package_manager_preference | ["../../site/src/lib/package-manager.ts"], ["../../site/src/lib/use-package-manager.ts"], ["../../site/src/components/InstallSplitButton.tsx"], ["../../site/src/components/QuickstartClient.tsx"] | done | The site keeps one global JavaScript package manager value: npm, pnpm, yarn, or bun. The default is npm. All CLI and MCP install commands read and write this one value. Do not keep a separate choice on each control. The value persists in the browser across pages and reloads. Surfaces: [install_cli_menu], [quickstart_page]. Compatible with [simple_lightweight_and_static]. | 0.068 | |
| quickstart_page | ["../../site/src/app/quickstart/page.tsx"], ["../../site/src/views/QuickstartPage.tsx"], ["../../site/src/components/QuickstartClient.tsx"], ["../../site/src/components/QuickstartClient.module.css"], ["../../site/src/content/quickstart.ts"], ["../../site/src/content/nav.ts"] | done | The site exposes `/quickstart/` as the install / get-started page. Primary path: editor install chooser. Also explains headless [cli_package.cli_package] ( `@reqlan/cli` ) and ["../core-architecture.rq".mcp_package] ( `@reqlan/mcp` ) on the same `.reqlan` index. Package npm hrefs come from [phonebook_reqs.npm_packages], not hardcoded URLs. CLI and MCP install commands offer npm, pnpm, yarn, and bun per [install_cli_menu]. They share one stored preference per [package_manager_preference]. After install steps, it links onward to Tutorials, Showcases, and FAQ so visitors can continue without returning to the home nav. Related link copy lives in ["../../site/src/content/quickstart.ts"] per [copy]. Sidebar nests Extension / CLI / MCP as same-page children per [sidebar_nav]. | 0.113 | |
| quiz_sticker_tab | ["../../site/src/content/quiz-sticker.ts"], ["../../site/src/components/QuizStickerTab.tsx"], ["../../site/src/components/QuizStickerTab.module.css"], ["../../site/src/views/HomePage.tsx"] | done | Home only: a right-edge tab on the home page. It does not mount in root layout or on other routes. Collapsed: a vertical label and the [phonebook_reqs.phonebook] `sticker-form` icon. Open: a short panel. The CTA is a link to [certs_reqs.assessment_page] through ["../../site/src/lib/certs-paths.ts"]. It is not an in-place quiz. Copy lives in ["../../site/src/content/quiz-sticker.ts"] per [copy]. Style with CSS modules per [styling_architecture] and [brand]. Use theme colour tokens. Hide on narrow viewports so it does not cover content. Keep it compatible with [simple_lightweight_and_static] and [sticky_cta_node]. No looping decorative motion. Open and close may change width once. When the visitor prefers reduced motion, do not animate. | 0.101 | |
| roadmap_section | ["../../site/src/components/Roadmap.tsx"], ["../../site/src/content/roadmap.ts"], ["../../site/src/views/HomePage.tsx"], ["../../site/src/components/NavGraph.tsx"] | done | Landing page section `#roadmap` after example and before links. Compact vertical scaled-center carousel ( snap + distance-based scale / opacity peeks ). Flat Now / Next / Later items — one focused at a time; neighbours peek smaller. Copy lives in ["../../site/src/content/roadmap.ts"] ( per [copy] ); nav and sticky page graph include the section. Keep the list honest and thin — no fake dates, no wall of tickets. | 0.091 | |
| showcase | ["@/site/src/content/showcases"], ["@/site/src/app/showcase"], ["@/site/src/views/ShowcaseListPage.tsx"], ["@/site/src/views/ShowcaseDetailPage.tsx"] | done | site, showcase, content | Every showcase demonstrates a mechanism, not a metaphor. Domain problem, the. rq that binds it, the real artifact in another language it binds to, and the thing the tooling hands back. Content is authored in TS objects per [showcase_module], not generated from this file at runtime. This file is the source of truth for intent, ordering, and editorial rules. | 0.040 |
| showcase_module | ["../../site/src/content/showcases/types.ts"], ["../../site/src/content/showcases/index.ts"], ["../../site/src/content/showcases"] | done | Showcases are standardised and typed in TS content objects. Types live in ["../../site/src/content/showcases/types.ts"]. Each showcase is its own file under ["../../site/src/content/showcases"]. ["../../site/src/content/showcases/index.ts"] composes them in [showcase_set] order. Each showcase file carries rq: comment references to its showcase idea and to the product ideas it demonstrates. Short version ( list card ): id, title, summary, tags, mechanism badge. Long version ( detail page ): full blocks array including payoff. Exist as a list page and as a full page per slug. Routes: `/showcase/` and `/showcase/[slug]/` — static export. Block kinds needed beyond today's code | features union: callout — the one-sentence point of the page exchange — query + response, terminal-styled diagnostic — editor-style error with quick-fixes diagram — visually distinct from code; never language- " rq " caption / mechanism fields on the showcase object Copy stays minimal and show-don ' t-tell, aligned with site copy rules. | 0.057 | |
| sidebar_nav | ["../../site/src/components/Sidebar.tsx"], ["../../site/src/components/Sidebar.module.css"], ["../../site/src/content/nav.ts"], ["../../site/src/content/meta.ts"] | done | The site sidebar is a hierarchical page nav, not a flat list of mixed anchors and routes. Top-level entries are pages ( or the home hub ). Same-page section anchors nest as children under their parent page. Children render only while the visitor is on that parent page — off-page section lists stay collapsed so the sidebar reflects the current route. Until pathname is known after mount, children stay closed ( do not default to Home ) so static HTML / hydration does not flash a mismatched hierarchy. The active page uses `aria-current="page"`; the in-view same-page section uses `aria-current="location"` when known. Nav model and labels live in ["../../site/src/content/nav.ts"] per [copy]; the Sidebar client reads pathname ( and hash / section when on home ) to decide expansion and current markers. FAQ is a top-level page entry per [faq_page]. Support is a top-level page entry per [support_page_reqs.support_page]. Sidebar nests Support section anchors as same-page children. | 0.187 | |
| spec_html_export | ["../../site/scripts/export-spec.mts"], ["../../site/scripts/verify-static-export.mts"], ["../../site/scripts/build-static.mts"], ["../../.github/workflows/deploy-site.yml"], ["../../packages/analytical/src/native/load-native.ts"], ["../../packages/analytical/src/native/native-analysis-api.ts"], ["../../crates/reqlan-analytical/src/types.rs"], ["../../crates/reqlan-analytical/src/api.rs"] | done | The site static build exports the workspace requirement graph ( excluding `*.secret.rq` ) under `out/spec/` via `reqlan export`. It must pass [html_export.html_export_url_base] for `/spec` ( honouring `SITE_BASE_PATH`, e. g. `/reqlan/spec` in production ) so `/spec` loads with or without a trailing slash. It must pass [html_export.html_export_header_link] pointing at the marketing site home so readers can leave the embedded spec and return to the parent site. Embedded `/spec` graph pages inherit [html_export.html_export_graph_background_load] so large workspace graphs do not freeze the page while settling. Pipeline: ["../../site/scripts/build-static.mts"] → ["../../site/scripts/export-spec.mts"] → ["../../site/scripts/verify-static-export.mts"]. Host options come from [html_export.html_export] / CLI [cli_package.commands], including native CLI export via ["../core_analysis/rust_port.rq".native_bridge]. CI must build / stage host `reqlan-napi` before this pipeline ( [distribution_reqs.site_distribution] ); the loader probes repo-root `crates/target`, not `packages/crates`. | 0.142 | |
| sticky_cta_node | ["../../site/src/app/layout.tsx"], ["../../site/src/content/sticky-cta.ts"], ["../../site/src/components/StickyCtaNode.tsx"] | done | Root layout ["../../site/src/app/layout.tsx"] hosts a sticky, draggable button tray on marketing pages. The tray stays in the viewport. Drag starts from a dedicated handle only — action links must not capture pointer or begin a drag. The drag / hit box is the button tray only ( `width` / `height`: fit-content ). Labels and tooltips overlay outside that box; they must not enlarge it. Compact state is icon-only. Hover / focus expands the matching label as a tooltip beside ( web ) or above ( mobile ) the icon, flipped if the tray is near that viewport edge. Narrow ( mobile ) viewports show one action: star the GitHub repository. Wider ( web ) viewports also show " Try the extension ", which opens [quickstart_page]. GitHub href and icons come from [phonebook_reqs.phonebook] / [phonebook_icon_component], not hardcoded URLs or ad-hoc glyphs. Copy lives in ["../../site/src/content/sticky-cta.ts"] per [copy]. Do not show the tray on the presentation player route per [presentation_player_route]. | 0.114 | |
| story_codebase_showcase | ["../../site/src/content/showcases/story-codebase.ts"], ["../../site/src/content/showcases/index.ts"] | done | story, traceability, delivery | Flagship. A story that ships with the code. Write the feature as one idea. Bind source with @ implementation. Bind proof with @ tests. Point back with rq: comments. Click on that name returns the bound files — not a ticket outside the repo. Domain: product delivery. One worked name across every block per [one_worked_example_per_page]. Payoff is click output per [every_showcase_ends_in_a_payoff] and ["../cli/click.rq".click]. Uses [development_core.code_comment_references] and [development_core.testing]. Demonstrates [sub_file_binding] and [bidirectional_comment_links]. | 0.046 |
| sync_config_schema | ["../../site/scripts/sync-config-schema.mts"], ["../../site/scripts/build-static.mts"], ["../../packages/extension/schemas/config.schema.json"] | done | `scripts/sync-config-schema.mts` copies the canonical base config JSON Schema from ["../../packages/extension/schemas/config.schema.json"] into `public/schemas/v1/config.schema.json`. Public URL: `https://reqlan.com/schemas/v1/config.schema.json` ( path `v1` is schema compatibility; not site package semver ). Canonical authoring and `$id`: ["../extension/host/configuration.rq".configuration_schema_file]. Init seed `$schema`: ["../extension/host/installation.rq".base_config_seed]. Wired into site `predev` and `build-static` ( same pattern as [sync_presentations] ). Deployed with existing `site/v*` pipeline. Synced artifact is not a second authoring source; do not edit under `public/schemas/`. | 0.054 | |
| sync_presentations | ["../../site/scripts/sync-presentations.mts"], ["../../site/src/lib/parse-jsonc.ts"] | done | `scripts/sync-presentations.mts` reads authored `*.jsonc` decks and `manifest.jsonc`, emits comment-free `*.json` for the static player, and syncs assets / vendor into `public/presentations/`. | 0.067 | |
| syntax_section | ["../../site/src/content/syntax.ts"], ["../../site/src/components/Syntax.tsx"], ["../../site/src/components/SyntaxClient.tsx"], ["../../site/scripts/generate-highlights.mts"] | done | Landing `#syntax`: self-explanatory rule + practical snippet pairs ( show, don't tell ). Copy lives in ["../../site/src/content/syntax.ts"] per [copy]. Highlighting languages follow [code_block_styling]. language- " rq " pairs must parse per [accurate_rq_snippets_must_parse]. | 0.091 | |
| test_proves_showcase | ["../../site/src/content/showcases/test-proves.ts"] | done | testing, traceability | Depth. What this test actually proves. Keep the intent of the former test-explanation page; upgrade it with a real test-name anchor and the reverse direction from test file back to intent. | 0.045 |
| tutorial_location_crumb | ["../../site/src/components/TutorialPlayerShell.tsx"], ["../../site/src/components/TutorialPlayerShell.module.css"] | done | Tutorial detail chrome shows a compact location trail: catalog → course → lesson → slide. Hierarchy must be obvious without a wide single-line title dump. Layout: each tier is a stacked chip — role ( and optional completion control ) on the top row; title / index value muted underneath. Titles colour up on hover, focus-within, or when the peer menu is open. **Folder navigation: ** each tier acts like a path segment / folder. Hover or focus reveals a peer menu for that level of the tree so the user can jump without using the transport row: - catalog → courses ( enter first lesson of the chosen course, or the catalog index ) - course → peer courses - lesson → peer lessons in the active course - slide → peer slides in the active lesson ( updates the embedded player / `?slide=` ) Current peer is marked; menus stay keyboard-reachable via focus-within. **Sizing: ** the crumb container grows to fit text; wrap before truncating. Ellipsis only as a last resort on very narrow viewports — do not cap chip width so aggressively that titles ellipsize while space remains. Course deep-links also exist at `/tutorials/#course-<series>`; catalog at `/tutorials/`. Slide shows `n/total` and updates live with the embedded player. Completion toggles stay on the role row. The crumb lesson tier always shows the **current** lesson only — it must not share hover / preview state with the transport lesson step dots. Step-dot hover may preview a title near the dots, never in the crumb. | 0.046 | |
| tutorial_player_transport | ["../../site/src/lib/tutorial-transport.ts"], ["../../site/src/components/TutorialPlayerShell.tsx"], ["../../site/src/components/TutorialPlayerShell.module.css"] | done | The `<` control must show the previous slide when the player can go back. When the player cannot go back, `<` must open the previous lesson if that lesson exists. Open that lesson on the last slide. The `>` control must show the next slide when the player can go forward. When the player cannot go forward, `>` must open the next lesson if that lesson exists. Open that lesson on the first slide. The Left Arrow key and the Right Arrow key must do the same as `<` and `>`. Shift + Left Arrow and Shift + Right Arrow must open the adjacent lesson from any slide. The `<<` and `>>` controls must continue to open the adjacent lesson. After the current lesson player is ready, the shell must start to load the next lesson player in the background. The shell must prefetch the next lesson page. The shell must ignore state messages from the background player. | 0.046 | |
| tutorials_section | ["../../site/src/app/tutorials/page.tsx"], ["../../site/src/app/tutorials/[slug]/page.tsx"], ["../../site/src/app/presentations/player/page.tsx"], ["../../site/src/content/tutorials.ts"], ["../../site/src/components/TutorialPlayerShell.tsx"], ["../../site/src/components/PresentationPlayer.tsx"], ["../../site/scripts/sync-presentations.mts"], ["../../site/src/lib/parse-jsonc.ts"] | done | The site exposes `/tutorials` and `/tutorials/[slug]/` as statically generated pages. Catalog and deck ids come from authored ["../../presentations/manifest.jsonc"]. Each detail page embeds the Reveal player iframe at `/presentations/player/?deck=<id>` using [assets] / SITE_BASE_PATH-aware `sitePath`. Each detail page hosts a unified transport chrome ( `<<` `<` steps `>` `>>` ) that drives slide nav in the embedded player via postMessage, plus lesson jumps ( [tutorial_player_transport] ). Location hierarchy chrome: [tutorial_location_crumb]. Blurb and try-this live on the catalog and inside the slides, not as page chrome. The player is an App Router page ( [presentation_player_route] ) so it static-exports under `trailingSlash` without colliding with `public/` HTML. Sync ( [sync_presentations] ) converts authored deck / catalog JSONC under ["../../presentations/"] into runtime JSON under `public/presentations/`, and copies assets plus vendored Reveal. js ( player shell excluded ). The catalog links to [certs_reqs.assessment_page] for certification. | 0.046 | |
| support_page | ["@/site/src/app/support/page.tsx"], ["@/site/src/views/SupportPage.tsx"], ["@/site/src/views/SupportGraph.tsx"], ["@/site/src/views/SupportTable.tsx"], ["@/site/src/views/support.module.css"], ["@/site/src/content/support.ts"], ["@/site/src/lib/support-action.ts"], ["@/site/src/lib/support-graph-cola.ts"], ["@/site/src/content/nav.ts"] | done | Rank actions by ease and likelihood to nudge. Star on GitHub is first. Default view is a graph. Toggle Graph / Tiles / Table as icon buttons on the right of the header, with hover tooltips. Graph: cola layout, settled on first paint to the visible window; copy has no graph coordinates; each node moves with its label; nodes are draggable; a drop keeps the new position; a drag does not start the action; all nodes offset slightly toward the cursor; nodes repel so some canvas edges stay open; action radius is impact × ease and stays latent to users; action nodes are solid and flat; each action links to a smaller passive original-group node in secondary colour ( advocacy, community, cite, contribute, sponsor ); group labels grow on group hover; labels do not overlap. Hover on an action node shows a tooltip with the action blurb. Star and sponsor tags are featured in the orange brand colour: the Star action, sponsor actions, and the Sponsor group. Tiles: responsive flex layout. Table: action and group only. Ease, impact, and score stay latent. Action names use the aqua link colour in Graph, Tiles, and Table, including copy and share, except featured graph tags. Each table row runs the same action as the graph and tiles: open a link, copy, or share. Support via, in tile order: - one click - star on github - share - discord - a minute - cite - issues - post your certificate - say something nice on the Visual Studio Marketplace - say something nice on Open VSX - FREE stickers: show the world you are a reqling, via [phonebook] sticker-form - write - reach out and send an email - write a testimonial - sponsor - github sponsorship - direct sponsorship integrated with [phonebook]. Copy lives in ["../../site/src/content/support.ts"] per ["./site.rq".copy]. The site exposes `/support/` as a statically generated page. Sidebar nests Support section anchors as same-page children per ["./site.rq".sidebar_nav]. Landing nav graph includes Support as a page node per ["./site.rq".nav_graph]. | 0.112 |