Idea detail
analytical_package
reqlan rq/core-architecture.rq:60
block
in-progress
Summary
`packages/analytical` ( `@reqlan/analytical` ) is the shared requirement graph index and analysis layer.
It owns the indexer.rq: extracts ideas and edges into a rusqlite store via the core native engine ( workspace-index.ts ), holds Zustand analytical state, and exposes analysers and an analysis API.
Headless CLI / MCP entry is `@reqlan/analytical/core` via `openAnalysisApi` ( native required; no Langium ).
Consumers: extension_package ( thin editor adapter ), mcp_package, cli_package.
Depends on language_package for the editor LSP only. Published to npm alongside cli_package; version graph role: package_versioning.
Rust engine port ( lexer / parser-for-index, indexer, search, export ): analytical_rust_port, shipped per rust_binary_distribution.
Navigation
Attributes
| Key | Value |
|---|---|
| plan | goal Replace the TypeScript analysis engine (parse-for-index, extract, SQLite index, search, export) with a Rust library behind the existing `createAnalysisRuntime` / `AnalysisApi` facade, shipped as per-architecture binaries and per-target VSIXes. constraints - Distribution: rust_binary_distribution + vsix_export — npm optional platform packages and host-targeted VSIX; website downloads and GitHub-release postinstall out of scope. - Shared on-disk ideas_index under `<base>/.reqlan` is schema v4 rusqlite (native required; no sql.js fallback). - The language server is language_server_rust. This analytical plan does not replace that process. Do not switch the language to tree-sitter (grammar_and_parser). - Port the context-sensitive lexer (lexer_rust) rather than a parser-generator that cannot honour syntax.rq brace/fence rules. - nonblocking_index and parse_budget_timeout still apply; rust_mindset and supply_chain (mature crates). - Extension host requires the host-matching napi `.node` from the per-target VSIX (extension_host_target). - Zustand host state, webviews, and HTML-export client JS stay TypeScript. steps 1. Scaffold `crates/` + golden tests vs Langium (rust_crate_layout). 2. Lexer, then parser with recovery and budget (lexer_rust, parser_rust). 3. Extractor + rusqlite + incremental sync (indexer_rust). 4. Search analysers (search_rust). 5. Export snapshot + writers; keep interactive HTML JS (export_rust). 6. napi-rs per-arch host packages; CLI then MCP then extension via platform VSIX (native_bridge, cutover). 7. Publish on `analytical/v*` and ship per-target VSIXes (rust_binary_distribution, vsix_export). open - Language-server process: language_server_rust. CLI `parse` uses the core Rust engine. |
| status | in-progress |
Ancestor context
No ancestor chain recorded.
Outbound references
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| file_reference | ./indexer/indexer.rq | reqlan rq/indexer/indexer.rq | indexer.rq |
| file_reference | ../packages/analytical/src/index-store/workspace-index.ts | packages/analytical/src/index-store/workspace-index.ts | workspace-index.ts |
| references | extension_package | reqlan rq/core-architecture.rq | extension_package |
| references | mcp_package | reqlan rq/core-architecture.rq | mcp_package |
| references | cli_package | reqlan rq/core-architecture.rq | cli_package |
| references | language_package | reqlan rq/core-architecture.rq | language_package |
| references | package_versioning | reqlan rq/core-architecture.rq | package_versioning |
| references | analytical_rust_port | reqlan rq/core_analysis/rust_port.rq | analytical_rust_port |
| references | rust_binary_distribution | reqlan rq/distribution/distribution.rq | rust_binary_distribution |
| references | vsix_export | reqlan rq/distribution/distribution.rq | vsix_export |
| references | ideas_index | reqlan rq/core-architecture.rq | ideas_index |
| references | language_server_rust | reqlan rq/extension/language/support/language-server-rust.rq | language_server_rust |
| references | grammar_and_parser | reqlan rq/core-architecture.rq | grammar_and_parser |
| references | lexer_rust | reqlan rq/core_analysis/rust_port.rq | lexer_rust |
| file_reference | ./language/syntax.rq | reqlan rq/language/syntax.rq | syntax.rq |
| references | nonblocking_index | reqlan rq/indexer/indexer.rq | nonblocking_index |
| references | parse_budget_timeout | reqlan rq/language/parser_lexer.rq | parse_budget_timeout |
| references | rust_mindset | reqlan rq/development/core.rq | rust_mindset |
| references | supply_chain | reqlan rq/constitution.rq | supply_chain |
| references | extension_host_target | reqlan rq/distribution/distribution.rq | extension_host_target |
| references | rust_crate_layout | reqlan rq/core_analysis/rust_port.rq | rust_crate_layout |
| references | parser_rust | reqlan rq/core_analysis/rust_port.rq | parser_rust |
| references | indexer_rust | reqlan rq/indexer/indexer.rq | indexer_rust |
| references | search_rust | reqlan rq/core_analysis/rust_port.rq | search_rust |
| references | export_rust | reqlan rq/core_analysis/rust_port.rq | export_rust |
| references | native_bridge | reqlan rq/core_analysis/rust_port.rq | native_bridge |
| references | cutover | reqlan rq/core_analysis/rust_port.rq | cutover |
Inbound references
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| ideaset_member | workspace_packages | reqlan rq/core-architecture.rq | — |
| references | language_package | reqlan rq/core-architecture.rq | analytical_package |
| references | extension_package | reqlan rq/core-architecture.rq | analytical_package |
| references | package_versioning | reqlan rq/core-architecture.rq | analytical_package |
| references | ideas_index | reqlan rq/core-architecture.rq | analytical_package |
| references | analytical_rust_port | reqlan rq/core_analysis/rust_port.rq | analytical_package |
| references | extension_product | reqlan rq/extension/extension.rq | analytical_package |
| references | barrel_page | reqlan rq/extension/host/features-commands.rq | analytical_package |
Unresolved references
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| None | |||
Local graph
Initialising graph…