Cluster detail
reqlan rq/extension/module
Ideas located under folder reqlan rq/extension/module.
folder
113 ideas
7 files
| Idea | File | Status | Summary |
|---|---|---|---|
| activity_bar | reqlan rq/extension/module/activitybar.rq | The extension should provide an activity bar sidebar for editor-adjacent requirement context per [consumption.local_graph_view]. UI is implemented as Svelte webview panes per [development_core], not as a long-lived tree of static rows. The host loads slices from the index via [graph_analysers.local_graph_analysis] and forwards editor focus through [activity_bar_webview] and [activity_bar_data]. Panes should be performance conscious: capped neighbourhoods, lazy cytoscape mount, debounced cursor updates — same discipline as [webview_doc.webview]. Workspace-wide tables, full layout controls, and unconstrained graph dumps belong in Ideas Summary per [ideas_summary_doc.ideas_summary]; panes link out with prefilled state instead of duplicating those views. | |
| component_list | reqlan rq/extension/module/activitybar.rq | Priority release ( shipped ): - Shell: [ActivityBarApp], HeaderBar ( includes [info_site_link] ), CollapsiblePane in ["../../../packages/extension/webviews/activity-bar/"] - Panes: WorkspacePane, ScopePane, SelectionPane, ReferenceListsPane, MiniatureGraphPane, ParentNodesPane, ContextTray - Graph: [MiniGraphCanvas] consuming shared graph lib per [graph_lib] - Host: [activity_bar_webview], [activity_bar_data], wire types in [activity_bar_messages] - HTML: [get_activity_bar_html] - Build: ["../../../packages/extension/webviews/activity-bar/vite.config.ts"] → media / webviews / activity-bar / Deferred ( not in priority release ): - IdeasetPane, FileReferencesPane, RecentPane - [graph_path_doc.graph_path_walk] UI pane - ExportSliceButton - Full workspace export via [commands.export_json] / [commands.export_csv] | |
| context_tray | reqlan rq/extension/module/activitybar.rq | Pinned ideas for AI context — details in [current_context_scope.context_tray]. | |
| current_file_pane | reqlan rq/extension/module/activitybar.rq | Primary contextual stack when a. rq file is active — details in [current_context_scope.current_file_pane]. Sub-panes: [scope_pane], [miniature_graph_pane], [reference_lists_pane], [parent_nodes_pane]. | |
| file_references_pane | reqlan rq/extension/module/activitybar.rq | File-scoped edges only — inbound and outbound file references for the focused idea. Useful for tracing which source files implement or mention a requirement. - Group shared file targets per [graphical_graph_doc.referenced_files_grouping] when multiple ideas reference the same path. - Line-qualified references should navigate to the specific line when present. | |
| git_history_lens | reqlan rq/extension/module/activitybar.rq | Focus-centric git history in the git lens — details in [current_context_scope.git_history_lens]. | |
| header_buttons | reqlan rq/extension/module/activitybar.rq | Cross-pane controls live in a compact header above the pane stack. - " Sync with editor " toggle: panes follow the active editor and cursor by default; when off, stay pinned on the last focused idea. - [hop_depth_control]: global graph hop depth for context search, graph slice, references, and ancestors — not a boolean toggle. - " Open in Ideas Summary ": reveal [ideas_summary_panel] with the ideas table filtered to the current file, or the graph tab centred on the current idea. - " Export slice ": JSON or CSV of the current neighbourhood only ( lighter than workspace [commands.export_json] / [commands.export_csv] ). - " Copy as markdown ": copy the focused idea plus parents and reference lists for pasting into chat or PRs. - Refresh control tied to index readiness. - [info_site_link] | |
| hop_depth_control | reqlan rq/extension/module/activitybar.rq | A * * − / value / + * * button pair ( not a 1 - hop / 2 - hop toggle ) sets [context_scope_doc.global_hop_depth]. - Minimum hop depth is 1 ( direct neighbours only ); * * − * * is disabled at minimum. - Maximum hop depth is capped ( default 4 for the activity bar ); * * + * * is disabled at maximum. - Changing global depth rebuilds [context_scope_doc.reqlan_context_model], refreshes graph / refs / ancestors panes, and updates [context_scope_doc.context_footprint]. - When no [context_scope_doc.effective_center_id] exists, depth still updates session state; panes refresh when a centre appears. - Legacy `setIncludeIndirect` maps to depth 2 / 1 for backward compatibility during migration. | |
| icon | reqlan rq/extension/module/activitybar.rq | the activity bar icon should use the reqlan logo. [brand] | |
| ideaset_pane | reqlan rq/extension/module/activitybar.rq | When the focused idea belongs to one or more ideasets. - List ideaset names with a dropdown of member chips ( same interaction model as [ideas_summary_doc.idea_sets_tab] ). - Path column links to the ideaset source file. - Hidden when the focus idea is not a member of any ideaset. | |
| implementation_priority | reqlan rq/extension/module/activitybar.rq | Suggested build order: 1. [scope_pane] and [reference_lists_pane] ( index data only, no cytoscape ). 2. [miniature_graph_pane] with expand / collapse and handoff to Ideas Summary. 3. [parent_nodes_pane] with status rollup. 4. [context_tray] and create-stub integration with [commands.pallete_function_create_todo]. 5. [selection_pane], [ideaset_pane], [file_references_pane], [recent_pane]. | |
| info_site_link | reqlan rq/extension/module/activitybar.rq | The header shows an info control that opens the project site in the system browser. Link id `site` from [phonebook_reqs.phonebook] per [phonebook_reqs.activity_bar_site_link]. Resolved in the extension host via ["../../../packages/extension/src/shared/phonebook.ts"] ( canonical data in ["../../phonebook.json"] ), not hardcoded in the webview. The webview receives the resolved label and href from [activity_bar_webview] and posts `openPhonebookLink` when the user activates the control. | |
| loading_state | reqlan rq/extension/module/activitybar.rq | done | After the activity bar shell mounts, the header may appear before pane data. Cover every sequencing beat with an explicit loading or error affordance — never a blank content area: 1. HTML shell ( before Svelte boots ): inline waiting markup in [get_activity_bar_html]. 2. Connecting: header visible; a post-first-frame `ready` handshake starts the index and requests the first host state. 3. Waiting for index: [workspace_panel.workspace_loading]. 4. Ready panes: [current_context_scope.context_panes_loading] and [minigraph.minigraph_loading]. Index sync progress belongs in [workspace_pane]; graph slice waits stay in [miniature_graph_pane], not a second global overlay. Host posts index health on `ready` and on subsequent status changes; soft-waits when the index is not ready instead of erroring the whole bar. |
| miniature_graph_pane | reqlan rq/extension/module/activitybar.rq | Small interactive neighbourhood graph — details in [minigraph.miniature_graph_pane]. | |
| minigraph_file_reference_links | reqlan rq/extension/module/activitybar.rq | done | File-ref click open behaviour — details in [minigraph.minigraph_file_reference_links]. |
| panel_content_styling | reqlan rq/extension/module/activitybar.rq | done | Pane bodies must not grow unbounded. Nested lists use [NestedSection] ( collapse + scroll ) under [CollapsiblePane]. Details: [workspace_panel.workspace_content_styling], [current_context_scope.context_content_styling]. [WorkspacePane] [ScopePane] [ReferenceListsPane] |
| panes | reqlan rq/extension/module/activitybar.rq | - [header_buttons] - [current_file_pane] - [selection_pane] - [ideaset_pane] - [file_references_pane] - [recent_pane] - [workspace_pane] | |
| parent_nodes_pane | reqlan rq/extension/module/activitybar.rq | Upstream ancestor chain — details in [current_context_scope.parent_nodes_pane]. | |
| performance | reqlan rq/extension/module/activitybar.rq | done | Sidebar webviews share the same constraints as [graph_lib.webview_threading]. - The HTML / Svelte shell paints before index discovery begins; the post-paint `ready` handshake starts indexing. - Keep sql. js outside the activation-critical host bundle and load it only when a database opens. - Default neighbourhood slices; never load the full workspace graph into a pane. - Debounce editor selection and cursor events before rebuilding slices. - Lazy-mount cytoscape only for visible sub-panes; destroy when collapsed or hidden. - Reuse [graph_analysers.local_graph_analysis] and graph query builders rather than ad-hoc index walks in the webview. |
| recent_pane | reqlan rq/extension/module/activitybar.rq | Recently touched ideas in the session ( configurable count and truncation basis per [graphical_graph_doc.node_truncation] ). - Click opens the idea; optional pin to [context_tray]. | |
| reference_lists_pane | reqlan rq/extension/module/activitybar.rq | Inbound / outbound reference lists — details in [current_context_scope.reference_lists_pane]. Shared editor / panel resolution: [current_context_scope.reference_resolution_parity]. Unresolved idea create affordance: [current_context_scope.unresolved_reference_create]. | |
| refernce_lists_pane_reference_tiering | reqlan rq/extension/module/activitybar.rq | Inbound refernces may be direct, or via ideaset references. The [reference_lists_pane] should tier the references based on the reference type. Design must keep in mind that that the ideaset refernces are likely more numerous and lower signal. | |
| scope_pane | reqlan rq/extension/module/activitybar.rq | Composed context inspector — details in [current_context_scope.scope_pane]. | |
| selection_pane | reqlan rq/extension/module/activitybar.rq | Multi-idea selection list — details in [current_context_scope.selection_pane]. | |
| workspace_pane | reqlan rq/extension/module/activitybar.rq | Workspace / multi-base index health and activity — details in [workspace_panel.workspace_pane]. Active [bases] chosen via searchable dropdown ( [workspace_panel.workspace_base_picker] ); pane shows health for the selected base. Empty discovery: create-base CTA per [base_docs.create_base_onboarding]. | |
| chat_participant | reqlan rq/extension/module/chat-participant.rq | the chat participant module should expose @ reqlan in vscode chat. it should consume analysis functions from the analytical submodule rather than duplicating graph logic. slash commands should use the rq- prefix only in chat, e. g. rq-search, rq-context, rq-graph, and rq-related for the active file. | |
| chat_participant_completion | reqlan rq/extension/module/chat-participant.rq | file and requirement references should be code completed in the chat window via # file and # requirement language model tools. | |
| chat_participant_skills | reqlan rq/extension/module/chat-participant.rq | the chat participant must not have duplicate skills. | |
| mcp | reqlan rq/extension/module/chat-participant.rq | to support cursor / non-ms tools, this surface should be replicated / wrapped as an mcp server too. the mcp package exposes the same analysis api as @ reqlan chat via stdio tools. cursor project config lives in [".cursor/mcp.json"] and skills sync to [".cursor/skills"] via scripts / sync-cursor-ai. mjs. | |
| activity_constellation | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Spatial glow of nodes by activity ( GitHub-contribution feel, but layout- aware ). Shows hotspots without a separate legend dump. Complements [hotspot_overlay]; prefer one encoding per surface to avoid competing visual channels. |
| activity_river | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Workspace-top ribbon of recent activity density ( yesterday / today bursts ). Shows momentum, not a file list. Consumes [project_activity_signals] and [user_signals]. |
| ai_readiness_gauge | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Ready-to-assist gauge: requirements ✓, implementation ✓, history ✓, tests ✕, risk low — plus readiness %. Tells the user whether AI has enough synthesized context before [features_ai.ai_add_to_context] / export. Pairs with [context_fingerprint] ( what is in context ) vs readiness ( is it enough / safe ). |
| architectural_map | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Tiny layered minimap ( UI / Services / Core / Infra … ) with current focus highlighted and bar width for effort concentration. Consumes [architecture_signals] and [project_activity_signals]. Links out to Ideas Summary graph rather than duplicating full layout. |
| architecture_signals | reqlan rq/extension/module/context-scope-v2.rq | ||
| base_signals | reqlan rq/extension/module/context-scope-v2.rq | in-progress | Multi-base facts for [context_signals] / [synthesized_context]: active_base_id, active_base_root, active_base_ready, idea / edge counts for the active base, sibling_bases ( id, path, ready, counts ), discovery_empty ( prompt create-base ). Consumed by [activitybar.workspace_pane], Ideas Summary base switcher, and [project_weather]. |
| change_velocity | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Slow ↔ Fast bar from edits / week ( or equivalent ). Complements [churn_heat_bar] ( shape over time ) with a single magnitude readout. |
| churn_heat_bar | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Compact sparkline of edit intensity over time for a requirement, file, folder, or subsystem ( e. g. ▁ ▁ ▂ ▁ ▁ ▇ █ ▆ ▂ ▁ ▁ ). Hover reveals synthesized story ( stable / large rewrite / quiet since ). Consumes [development_history_signals] and [project_activity_signals]. |
| concept_density | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Per-folder or per-subsystem bars of conceptual richness ( Authentication █ █ █ █ █ █ █ █ █ █ vs Payments █ █ █ ). Consumes [semantic_signals]; useful in Ideas Summary folders / index panel. |
| confidence_card | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Pre-edit checklist card: High / Medium / Low confidence with check / warn rows ( stable, reviewed, tested, high fanout, … ) and a confidence %. Shown before AI modify workflows ( [features_ai.ai_integration] ) and on focus when synthesis is available. |
| context_consumers | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Shared semantic representation for: UI widgets, graph traversal, AI agents, search, diagnostics, navigation-by-intent. New analyses register as signal producers; consumers bind to signals / synthesis, not to ad-hoc dimension lists. |
| context_fingerprint | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Compact bars of what the current AI / composed context actually contains: Files, Requirements, History, Architecture, Git, Diagnostics, Coverage. Lets the user see expansion when LLM reports " context expanded " ( [context_scope_v1.ai_context_export], [features_ai.ai_integration] ). Hover / info / drill-down affordances: ["./activitybar-panels/current_context_scope.rq".tooltip_detail], ["./activitybar-panels/current_context_scope.rq".fingerprint_axis_drilldown]. |
| context_model_layers | reqlan rq/extension/module/context-scope-v2.rq | done | Canonical v2 layers. Implementation builds on [context_scope_v1.reqlan_context_model]; consumers must not reconstruct project understanding independently. |
| context_radar | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Polar / radar chart of context richness axes ( Tests, Docs, Dependencies, History, AI, … ). Filled polygon shows what the current [context_scope_v1.context_footprint] actually covers. |
| context_scope_v2 | reqlan rq/extension/module/context-scope-v2.rq | in-progress | Evolves [context_scope_v1.context_scope] from a * * source-oriented * * model ( " where did this context come from? " ) to a * * decision-oriented * * model ( " what information helps a human or AI make the next decision? " ). v1 [context_scope_v1.context_dimensions] remain valid * producers * ( workspace, current file, open files, file history, edit history, manual, git ). v2 separates those producers from extracted signals, synthesized knowledge, presentation views, and consumers — so new analyses can be added without inventing new dimensions each time. Primary UI principle: [ui.show_dont_tell] — make project health, momentum, relationships, and intent legible at a glance. Host fact chips ( " 17 modified files " ) remain useful; widgets below are the preferred default for conveying meaning. Surfaces: extend [activitybar.scope_pane] / [context_scope_v1.scope_pane_design], Ideas Summary ( [ideas_summary_doc.ideas_summary] ), and graph overlays ( [graphical_graph_doc.graphical_graph] ) — same signals, different projections. |
| context_signals | reqlan rq/extension/module/context-scope-v2.rq | done | Extracted facts. Answer: " What useful information exists? " One source may emit many signals ( e. g. git → development history, not only staged / unstaged ). Families: - [requirement_signals] - [file_signals] - [development_history_signals] - [project_activity_signals] - [semantic_signals] - [quality_signals] - [user_signals] - [relationship_signals] - [temporal_signals] - [risk_signals] - [architecture_signals] - [requirement_lifecycle_signals] - [base_signals] Signals are evidence; [synthesized_context] merges them into actionable knowledge. |
| context_sources | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Stable raw producers. Answer: " Where are we collecting information from? " Map from v1: [context_scope_v1.workspace_context], [context_scope_v1.current_file_context], [context_scope_v1.open_files_context], [context_scope_v1.file_history_context], [context_scope_v1.edit_history_context], [context_scope_v1.manual_context], [context_scope_v1.git_context] become sources ( and contributions ), not the whole model. `workspace` = VS Code workspace chrome / ambient multi-base glance ( folder roots, discovery empty state ). `base` = the active ontology [ontology_base] ( `.reqlan` - marked container ): its index, readiness, and path ( [bases.implied_context] ). Requirements graph and project index bind to the active base's store, not a merged workspace graph. |
| context_views | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Projections over the same signals — not separate data models. Timeline · Graph · File · Requirement · Subsystem · Concept · Implementation · History · Risk · AI Summary. |
| dependency_pulse | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Spatial dependency summary instead of " Parents: 4 / Children: 12 ". Compact compass ( ↑ parents, → children, ← siblings, ↓ dependents ) and / or a filled * * Dependency Load * * bar showing centrality growth. Consumes [requirement_signals] and [relationship_signals]. Surfaced on focus hero and graph node details. Click any arm or the centre toggles a reference table below the compass ( Dir / Role / Idea / Status ) per ["../activitybar-panels/current_context_scope.rq".dependency_pulse_table]. |
| development_history_signals | reqlan rq/extension/module/context-scope-v2.rq | Prefer actionable history over staged / unstaged alone. development_context ( git reimagined ): current branch, active issue, release version, commits, authors, change frequency / velocity, historical and semantic hotspots, last meaningful modification, first introduction, ownership concentration, refactor / merge likelihood, stability score. First UI consumer beyond create / modify dates: [context_scope_v1.git_context] / ["activitybar-panels/current_context_scope.rq".git_history_lens] — focus commit trail and authors; working-tree staging demoted to secondary. | |
| file_signals | reqlan rq/extension/module/context-scope-v2.rq | active file, related files, recently viewed, recently edited, high churn, frequently opened, ownership, generated / test / implementation / specification / documentation classification. | |
| historical_replay_slider | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Time slider across the graph ( e. g. 2023 → Now ). Nodes and edges appear / disappear; dependencies animate. Extremely powerful for architectural storytelling; performance-capped neighbourhoods only in the activity bar; fuller replay in Ideas Summary. Consumes [temporal_signals], [requirement_lifecycle_signals], [relationship_signals]. |
| hotspot_overlay | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Graph-node encoding of churn / risk / discussion / instability ( size rings ○ ◎ ⬤ or green → red ). Same signal set as [activity_constellation]. Applies to [activitybar.miniature_graph_pane] and [graphical_graph_doc.graphical_graph]. |
| impact_radius | reqlan rq/extension/module/context-scope-v2.rq | incomplete | On select / focus, fade in affected neighbours; opacity ∝ downstream impact. Consumes [relationship_signals] and [risk_signals]. Works in miniature graph and Ideas Summary graph. |
| implementation_priority_v2 | reqlan rq/extension/module/context-scope-v2.rq | in-progress | After v1 [context_scope_v1.implementation_priority] is solid: 1. [context_model_layers] types: sources → signals → synthesis contracts ( extend analytical context model; keep v1 dimensions as sources ). ✓ 2. Seed signal producers: [development_history_signals], [requirement_lifecycle_signals], [relationship_signals], [risk_signals] from index + git ( reimagined, not staged / unstaged-only ). ✓ ( thin ) 3. [synthesized_context] rollups for focus entity ( stability, confidence, AI risk, coverage ). ✓ 4. First widgets on focus hero: [stability_meter], [dependency_pulse], [timeline_ribbon], [churn_heat_bar]. ✓ 5. [requirement_card] in search / Ideas Summary lists; [context_fingerprint] + [ai_readiness_gauge] on AI context export. ✓ 6. Graph overlays: [hotspot_overlay], [impact_radius]. ✓ 7. Workspace glance: [project_weather], [activity_river], [architectural_map]. deferred 8. Deeper storytelling: [historical_replay_slider], [semantic_diff_viewer], [relationship_cloud], [traceability_matrix]. deferred |
| knowledge_coverage | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Stacked coverage bars: Requirements / Implementation / Tests / Docs — prefer filled bars over bare percentages. Consumes [quality_signals] and [requirement_signals]. Pair with [traceability_matrix]. |
| ownership_distribution | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Horizontal author share bars ( bus-factor at a glance ). Consumes [development_history_signals] ownership and [risk_signals] ( e. g. single_contributor ). |
| project_activity_signals | reqlan rq/extension/module/context-scope-v2.rq | currently changing subsystem, hot / cold modules, high activity area, merge conflicts nearby, active branch, recent issue cluster, recent requirement churn, release / milestone affected. | |
| project_weather | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Synthesized workspace health widget — the engineering " dashboard " glance: Stable / Risk / Momentum / Knowledge / Recent Change, or compact meters for Project Health, Momentum, Risk, Confidence. Consumes [synthesized_context] across [risk_signals], [project_activity_signals], [quality_signals], and [base_signals] ( per-base readiness when multiple bases exist ). Belongs in activity bar workspace lens / Ideas Summary index panel — not as competing hero noise on every focus. |
| quality_signals | reqlan rq/extension/module/context-scope-v2.rq | missing documentation, large files / requirements, broken references, failing diagnostics, lint / parse / test / build failures, coverage gaps. | |
| relationship_cloud | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Compact spatial alternative to a full graph: related concepts laid out by semantic closeness ( distance encodes similarity ). Click focuses; " Open in Graph " hands off to [graphical_graph_doc.graphical_graph]. Consumes [semantic_signals] and [relationship_signals]. |
| relationship_signals | reqlan rq/extension/module/context-scope-v2.rq | ||
| requirement_card | reqlan rq/extension/module/context-scope-v2.rq | incomplete | GitHub-issue-style compact card for search results and lists: name, stability chip, meter %, last edited, ref / impl / test counts, urgency flag ( e. g. recently changing ). Composes [stability_meter], [churn_heat_bar], [dependency_pulse] as optional rows — not all at once by default ( token / UI density ). |
| requirement_lifecycle_signals | reqlan rq/extension/module/context-scope-v2.rq | ||
| requirement_lifecycle_wheel | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Four-quadrant wheel: Specify · Implement · Test · Review. Segments fill as evidence accumulates from [requirement_lifecycle_signals] and [quality_signals]. Compact lifecycle for engineering projects. |
| requirement_signals | reqlan rq/extension/module/context-scope-v2.rq | related_requirements, parents, children, incoming / outgoing references, linked implementation files, coverage status, requirement age, stability, priority, verification state, orphaned, cycles, missing references. | |
| risk_signals | reqlan rq/extension/module/context-scope-v2.rq | ||
| semantic_diff_viewer | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Conceptual change summary instead of ( or above ) line diffs: Added / Changed / Removed ideas or policies, plus impact count ( e. g. 17 requirements ). Higher signal for AI and review than textual diffs alone. Consumes [semantic_signals], [relationship_signals], [development_history_signals]. |
| semantic_signals | reqlan rq/extension/module/context-scope-v2.rq | concept clusters, shared vocabulary, duplicate / near-duplicate / similar requirements, contradictions, implicit dependencies, missing abstraction, large / isolated concepts. | |
| show_dont_tell | reqlan rq/extension/module/context-scope-v2.rq | in-progress | Make project state * * legible at a glance * *. Prefer visual evidence of health, momentum, relationships, and intent over numeric fact lists. Widgets below are show-don ' t-tell components for [context_scope_v2]; each consumes [context_signals] / [synthesized_context] and may appear in activity bar, Ideas Summary, focus heroes, search results, or graph overlays. Placement guidance: - Focus / card density: [timeline_ribbon], [churn_heat_bar], [dependency_pulse], [stability_meter], [change_velocity], [requirement_lifecycle_wheel], [requirement_card], [confidence_card], [ai_readiness_gauge] - Workspace chrome / dashboard denser: [activity_river], [project_weather], [context_fingerprint], [architectural_map] - Graph / Ideas Summary: [hotspot_overlay], [impact_radius], [activity_constellation], [historical_replay_slider], [relationship_cloud] - Coverage / ownership / density: [knowledge_coverage], [traceability_matrix], [ownership_distribution], [concept_density], [context_radar], [semantic_diff_viewer] |
| stability_meter | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Segmented meter + percent ( e. g. Stable █ █ █ █ █ █ █ █ █ ░ 91 % ) derived from edit frequency, age, dependency churn, and issue count — not raw git status. AI and humans use it as a confidence cue for change. Pair with [confidence_card] and [risk_signals]. |
| synthesized_context | reqlan rq/extension/module/context-scope-v2.rq | done | Signals merged into decision-oriented knowledge not tied to a single source. Example projection on a requirement: - Importance, Confidence, Stability, Recent Activity - Dependencies, Implementations, Tests, Documentation - AI Risk Synthesis powers [show_dont_tell] widgets and [features_ai.ai_integration] exports — preference for compact synthesized facts over raw dimension dumps ( [context_scope_v1.ai_context_export] ). |
| temporal_signals | reqlan rq/extension/module/context-scope-v2.rq | Enables queries: what changed this week, why this requirement changed, newly introduced risks, recent architectural evolution. | |
| timeline_ribbon | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Horizontal lifecycle ribbon for a requirement ( or focused entity ), not a single " last modified " label. Show milestones along a line toward Now — e. g. created, first implementation, last reviewed, current edit, last test — so maturity and recent activity are visible in one glance. Consumes [requirement_lifecycle_signals] and [temporal_signals]. Fits [context_scope_v1.scope_pane_design]. focus_hero and [requirement_card]. |
| traceability_matrix | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Compact Req × Impl × Test ( and optional Docs ) check matrix for a local neighbourhood or subsystem. Exposes gaps immediately. Neighbourhood-scoped only — full-workspace matrices stay in Ideas Summary with pagination / filters per [ideas_summary_doc.ideas_summary]. |
| user_signals | reqlan rq/extension/module/context-scope-v2.rq | manual pins, recent focus, navigation history, editing intent, copied context, AI conversation history, last searched, last graph traversal, frequently revisited. | |
| widget_composition_rules | reqlan rq/extension/module/context-scope-v2.rq | incomplete | Show-don ' t-tell without dashboard clutter. |
| ai_context_export | reqlan rq/extension/module/context-scope.rq | [activitybar.header_buttons] * * Context * * copies the composed [reqlan_context_model] as markdown: effective-centre requirement, non-. rq link sections, selection, pinned tray, and footprint summary. [features_ai.ai_add_to_context] should prefer the same composed context when the activity bar index is ready. | |
| any_file_scope | reqlan rq/extension/module/context-scope.rq | The active editor may be a requirement file or implementation file ( Python, TypeScript, etc. ). [current_file_context] must surface requirement links even when the file contains no block ideas. Signals for non-. rq files ( and. rq files without a caret idea ): - [file_reference_links]: `.rq` ideas whose outbound `file_reference` edges target this file path ( e. g. `["./apythonfile.py"]` ). - [folder_reference_links]: `.rq` ideas whose `file_reference` targets a parent folder of this file. - [comment_reference_links]: ideas resolved from `rq:[…]` tokens in this file's comments per [code_comment_refs.references_in_functional_code_comments]. - [git_context]: focus-centric git history ( recent commits, authors, branch ); working-tree dirty badge secondary. Focus behaviour: - `.rq` file with caret in a block → idea focus ( unchanged ). - Any file with linked requirements → file focus; [effective_center_id] defaults to the first linked requirement. - No links → file focus with empty related lists; graph / refs panes stay idle until a requirement is focused. Implementation: [context_model] uses [file_path_match] and `file_related_requirements` analyser; comment links are also resolved from live buffer text when indexed edges are absent. | |
| comment_reference_links | reqlan rq/extension/module/context-scope.rq | Matched from `comment_link` index edges and / or `rq:[target]` spans parsed from the active buffer. | |
| context_contribution | reqlan rq/extension/module/context-scope.rq | Per dimension: id, label, enabled, pinned, weight, ideaCount, fileCount, summary, hopDepth, supportsHopControl. Disabled dimensions do not add to [context_footprint] but may still show a muted chip with zero count. Pinned dimensions stay expanded in [scope_pane_design] until collapsed by the user. Graph-searchable dimensions expose per-lens hop overrides via [dimension_hop_control]. | |
| context_dimensions | reqlan rq/extension/module/context-scope.rq | Seven dimensions contribute ideas and files to the effective context footprint. Each dimension has a stable id, human label, default weight, and a one-line summary for collapsed UI. - workspace [workspace_context] Ambient VS Code workspace chrome and multi-base index glance: discovered bases, active base readiness / idea / edge counts — not a full graph dump. Distinct from the active [base] source in v2. - current_file [current_file_context] Active editor file. For `.rq`: caret idea, in-file outline, unresolved refs. For any file: [any_file_scope] links and git badge. - open_files [open_files_context] Other workspace editor tabs currently open ( any language ). - file_history [file_history_context] Session recency of visited workspace files ( navigation history ), distinct from edit history. - edit_history [edit_history_context] Session recency of edited workspace files and caret positions ( typing history ). - manual [manual_context] User-pinned ideas from [activitybar.context_tray] and explicit " add to context " actions. - git [git_context] Focus-centric development history ( branch, recent commits, authors ) per [index_reqs.git_information_capture]; working-tree changes demoted. | |
| context_focus | reqlan rq/extension/module/context-scope.rq | kind: idea | file | selection | none. When sync-with-editor is on, focus follows the caret idea in an active `.rq` editor, or file / selection context otherwise. When pinned, focus stays on the pinned idea until cleared. Selection focus applies when the user highlights text spanning one or more ideas ( [activitybar.selection_pane] ). | |
| context_footprint | reqlan rq/extension/module/context-scope.rq | Merged view across enabled dimensions. - deduped idea ids and file uris with [context_provenance] ( which dimensions contributed each entry ). - `summaryLine`: compact human text, e. g. " this file · 3 open · 2 git · 1 pinned ". - `effectiveCenterId`: graph / refs / ancestors panes use this; defaults to focus idea, selection's first idea, first linked requirement for non-. rq files, else first idea in current file. | |
| context_scope | reqlan rq/extension/module/context-scope.rq | Reqlan sidebar and AI workflows reason about a composed [reqlan_context_model], not a single " current file " blob. Context applies to * * any workspace file * *, not only `.rq` sources — see [any_file_scope]. Context is built from orthogonal [context_dimensions] that the user can enable, pin, or collapse. The activity bar [activitybar.scope_pane] is the primary surface for inspecting and steering context; [activitybar.context_tray] holds the [manual_context] dimension. Token discipline per [features_ai.ai_integration]: show summaries and counts by default; expand a dimension only on intent. Parses per ["../../../reqlan rq/language/syntax.rq".reference_wikilink]. Decision-oriented v2 ( sources → signals → synthesis → views → consumers ) and show-don ' t-tell widgets: [context_scope_v2.context_scope_v2]. | |
| context_selection | reqlan rq/extension/module/context-scope.rq | Union of ideas whose line ranges overlap the editor selection in a `.rq` file. Drives [activitybar.selection_pane] and contributes idea ids to [context_footprint]. | |
| current_file_context | reqlan rq/extension/module/context-scope.rq | weight: 1. 0 Default enabled and expanded lens when a workspace file is active. | |
| dimension_hop_control | reqlan rq/extension/module/context-scope.rq | When a graph-searchable dimension lens is expanded in [scope_pane_design], show a local * * − / value / + * * pair. Applies to [current_file_context], [open_files_context], [file_history_context], [edit_history_context], and [manual_context] — not [workspace_context] or [git_context]. Per-dimension override inherits [global_hop_depth] until the user adjusts it; stored in dimensionHopDepth on the session and model. Edge cases match [activitybar.hop_depth_control]: disable − at min, + at max, clamp on apply. | |
| edit_history_context | reqlan rq/extension/module/context-scope.rq | weight: 0. 5 Default enabled; capped list ( default 12 ); entries include last line touched. | |
| file_history_context | reqlan rq/extension/module/context-scope.rq | weight: 0. 4 Default enabled; capped list ( configurable, default 12 ). | |
| file_reference_links | reqlan rq/extension/module/context-scope.rq | Matched when an indexed `file_reference` edge target resolves to the active file path ( exact or suffix match ). | |
| folder_reference_links | reqlan rq/extension/module/context-scope.rq | Matched when an indexed `file_reference` edge target is a folder prefix of the active file per [file_path_match.match_file_reference_target]. | |
| git_context | reqlan rq/extension/module/context-scope.rq | weight: 0. 7 Should detect symbol lifecycle using symbol identity rather than line history for creation: who introduced the symbol, when it was introduced, who last meaningfully changed it, the total number of changes, and the relative change rate versus peer symbols. Default enabled when repository detected. Primary: focus-centric git history — branch, HEAD short hash, recent commits touching the focus file / idea, top authors. Summary prefers history richness ( e. g. " main · 3 commits · 2 authors " ), not staged / unstaged counts. Working-tree dirty files remain available as a demoted nested section and optional footprint contributors. Focus hero shows a history cue ( last commit age / branch ) instead of a staged / unstaged chip. Consumes [index_reqs.git_information_capture] and ["context-scope-v2.rq".development_history_signals]. UI: [activitybar.git_history_lens]. | |
| global_hop_depth | reqlan rq/extension/module/context-scope.rq | Session default hop depth ( 1 - 4 ) stored in [context_session]. Drives graph slice expansion, reference list breadth, ancestor chain depth, and composed context export. Surfaced in [activitybar.hop_depth_control] and echoed on [reqlan_context_model]. globalHopDepth. | |
| implementation_priority | reqlan rq/extension/module/context-scope.rq | 1. [any_file_scope] types and [context_model] builder. 2. Host refresh for any workspace file; git / all-tab collection. 3. [scope_pane_design] non-. rq focus hero and grouped link panels. 4. [context_selection] + [activitybar.selection_pane]. 5. Lazy `loadFileLens` for file-list dimensions. 6. [ai_context_export]. 7. [graph_path_doc.graph_path_walk] ( future pane / Ideas Summary handoff ). | |
| manual_context | reqlan rq/extension/module/context-scope.rq | weight: 0. 9 Enabled when tray non-empty; pins override sync focus for [effective_center_id] when user chooses " focus pinned ". | |
| open_files_context | reqlan rq/extension/module/context-scope.rq | weight: 0. 6 Default enabled; summary lists tab count. | |
| reqlan_context_model | reqlan rq/extension/module/context-scope.rq | Canonical composed context per [analytical_context_model]. Implementation: [context_model]. - [context_focus] is the single anchor ( idea, file, selection, or none ). - [context_dimensions] each contribute [context_contribution] records with counts and summary lines. - [context_footprint] merges enabled dimensions into deduped idea / file sets and an [effective_center_id] for graph / refs panes. - [current_file_slice] is the projection used when the current-file lens is expanded. Includes `isRqFile`, `referencingIdeas`, `commentLinkedIdeas`, `folderReferencingIdeas`, and optional `gitChange`. - [context_selection] when the user highlights a non-empty range spanning one or more `.rq` ideas ( [activitybar.selection_pane] ). - [global_hop_depth] and [dimension_hop_control] overrides on the model. Host increments `revision` when any dimension or hop depth changes; webview ignores stale posts by revision. | |
| scope_pane_design | reqlan rq/extension/module/context-scope.rq | The scope pane uses a * * focus + lens * * layout — not seven stacked lists. The experience should feel more like a wiki than a table: surfaced ideas, files, folders, commits, authors, and related context should prefer rich cross-links and drill-in navigation over flat tabular presentation. Grouping should adapt to available context rather than staying fixed: file-heavy views may group by folder / path, development-history views may group by git recency / authorship / churn, and mixed views should choose the most explanatory structure for the current focus. | |
| workspace_context | reqlan rq/extension/module/context-scope.rq | weight: 0. 1 Always on; contributes multi-base readiness and counts ( active base + sibling summary ) unless user opens workspace pane. " Workspace " here means the VS Code workspace surface and ambient index health — not a single ontology base. Active-base routing for focus / graph / refs follows ["../../bases/base.rq".implied_context]; see [context_scope_v2.context_sources] `base`. | |
| graph_path | reqlan rq/extension/module/graph-path.rq | Ordered nodes and edges from source to target. Each step records idea id, name, status, edge kind, and optional snippet / line for the traversed edge. Paths with unresolved hops are marked broken; UI offers jump-to-source like [activitybar.reference_lists_pane]. | |
| graph_path_walk | reqlan rq/extension/module/graph-path.rq | Future capability: walk the requirement graph * * point-to-point * * between two chosen ideas. Complements the activity bar's single-centre neighbourhood ( [activitybar.miniature_graph_pane] ) and Ideas Summary's unconstrained graph tab ( [graphical_graph.graphical_graph] ). | |
| implementation_notes | reqlan rq/extension/module/graph-path.rq | Analytical: add `findPathsBetween(store, fromId, toId, options)` returning [path_result]. Wire: new `loadGraphPath` message alongside existing `loadGraph` / `loadAncestors`. UI: defer dedicated pane until [activitybar.selection_pane] and composed context are stable; prototype in Ideas Summary graph tab first. | |
| path_query | reqlan rq/extension/module/graph-path.rq | Inputs: - `fromIdeaId` ( source node ) - `toIdeaId` ( target node ) - optional `maxDepth` ( default 8 ) - optional `edgeKinds` filter ( references, file_reference, incompatible, … ) - optional `direction` ( undirected default, or outbound-only / inbound-only for directed traces ) Output: [path_result] — zero or more shortest paths through the indexed graph, capped for token and UI limits. | |
| path_result | reqlan rq/extension/module/graph-path.rq | - `found`: boolean - `paths`: ordered list of [graph_path] ( typically top 1 – 3 shortest ) - `truncated`: true when search hit depth or branch limits - `summaryLine`: e. g. " A → implements → B → depends on → C " for collapsed UI | |
| path_ui_design | reqlan rq/extension/module/graph-path.rq | Entry points: - Activity bar: " Path to … " on focus hero when a second idea is pinned or selected ( [context_scope.manual_context] + [activitybar.selection_pane] ). - Ideas Summary graph tab: shift-click two nodes to set endpoints. - Command palette: `Reqlan: Find path between requirements`. Presentation ( sidebar-first ): - Collapsed: [path_result.summaryLine] under the scope footprint line. - Expanded: vertical stepper ( breadcrumb ) with edge kind labels; optional overlay on [graph_lib.graph_library] highlighting only path edges / nodes. - When no path: show closest partial path or " no connection within N hops " with expand-in-Summary action. Performance: - BFS / bidirectional BFS on sqlite edge tables via [graph_analysers.local_graph_analysis] — never materialise full workspace graph. - Debounce endpoint changes; cache last path per `(from,to,depth)` revision tied to index catalog generation. | |
| problem | reqlan rq/extension/module/graph-path.rq | Users often need to answer: " How does requirement A relate to requirement B? " — not the full ego-graph around A, and not an unbounded workspace dump. Today they manually expand hops or search references. A dedicated path walk would make dependency chains, impact routes, and gap analysis inspectable in the sidebar or graph tab. | |
| relationship_to_context | reqlan rq/extension/module/graph-path.rq | Path endpoints should default from [context_scope.context_focus] and [context_scope.effective_center_id]. A successful walk contributes traversed idea ids to a transient " path context " slice suitable for [context_scope.ai_context_export] without pinning every intermediate node. | |
| application_memory | reqlan rq/extension/module/index.rq | done | Base-local application memory for reqlan tools lives under `<base>/.reqlan/`. The presence of `.reqlan` * * marks * * a directory as a ["../../bases/base.rq".base]; each base owns its own store. Shared by the VS Code extension, ["../../cli/cli_package.rq".cli_package], and MCP ( [mcp_server] ) — not VS Code `globalStorageUri` / extension-private storage. The ideas graph index ( ["../features-graph-analysers.rq".index_ideas] / ["../features-graph-analysers.rq".index_technology] ) persists as `ideas-index.sqlite` inside that directory. Index timing diagnostics persist separately as `index-diagnostics.sqlite` ( [index_diagnostics_store] / ["../features-index-diagnostics.rq".index_diagnostics] ) so rebuilds of the ideas index do not wipe history. Export form defaults ( all formats via ["../features-export.rq".export_webview], including HTML options in ["../features-html-export.rq".html_export_form] ) persist as `export_settings.json` in the same directory ( active base ). Path ignore rules live as `.rqignore` in the same directory ( [rqignore] / [configuration.configuration_rqignore] ). Path resolution is owned by [application_memory_impl] ( `resolveApplicationMemoryPath` ); consumers must use it ( or `REQLAN_INDEX_PATH` override for a single store ) so tools read and write the same store for a given base. Multi-base discovery / registry: ["../../bases/base.rq".multi_base_environment]. Index engine ownership: ["../../indexer/indexer.rq".ownership]. Extension wiring: [analytical_submodule]. Aligns with ["../../cli/cli_package.rq".function_parity]: shared analytical memory, not host-only state. |
| git_information_capture | reqlan rq/extension/module/index.rq | Capture and surface git development history for requirements and files — not only working-tree staging status. On-demand / index-accessible: - ownership and top authors ( name; email when available ) - creator ( first introduction ) and last meaningful modification - edit frequency / commit count for the focus path or idea line range - recent commit trail ( subject, author, authoredAt, short hash ) for the ["context-scope.rq".git_context] lens Future: adjacency score from edit state and frequency of neighbours. Feeds ["context-scope-v2.rq".development_history_signals] and ["activitybar-panels/current_context_scope.rq".git_history_lens]. | |
| idea_index_triggers | reqlan rq/extension/module/index.rq | Refresh automatically on `.rq` file change via watchers ( [graph_analysers.indexing_trigger_filesave] ). Idle: cheap background staleness check — [graph_analysers.indexing_trigger_auto]. | |
| index_diagnostics_store | reqlan rq/extension/module/index.rq | 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 ["../features-index-diagnostics.rq".index_diagnostics_metrics]. Webview: ["../features-index-diagnostics.rq".index_diagnostics_webview]. |
| rqignore | reqlan rq/extension/module/index.rq | 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, VCS / editor stores, database files ( `*.db3`, sqlite ), secrets, and hidden entries; new bases seed the file via create-base. Product configuration statement: [configuration.configuration_rqignore]. |
| webview | reqlan rq/extension/module/webview.rq | Extension webviews are Svelte UIs hosted by the VS Code extension per [development_core]. They should be performance conscious: prefer capped, paginated, or scoped slices and avoid full-graph dumps unless the user explicitly requests one. The extension host loads compiled assets from `packages/extension/media/webviews/`. Webview modules in the extension: - Ideas Summary — overview, ontology tables ( bases / ideas / ideasets / attributes / references ), graph, and index ( last ): [ideas_summary] / ["./ideas_summary/webview.rq".ideas_summary] / ["./ideas_summary/webview.rq".ontology_aligned_tabs] - Activity bar — editor-adjacent sidebar panes: ["./activitybar.rq".activity_bar] - Export form — multi-format graph export: ["../features-export.rq".export_webview] - Onboarding — first-install / welcome webview: ["../onboarding/page-thanks-for-installing.rq".installation_event] |
Initialising graph…